Struct LazyCypherSink 

pub struct LazyCypherSink { /* private fields */ }

Lazy bridge from a Persistence backend to the host’s write-mode Cypher executor.

Backends constructed at register_builtin_plugins time hold one of these. The host’s Uni::build flow calls Self::set_host_executor after the host is fully constructed, at which point Self::try_write_cypher runs the supplied body via the host.

Holds the executor as a strong Arc<dyn HostCypherExecutor>; the executor itself only weakly references the host, so the persistence ↔ host cycle doesn’t leak. Pre-wire try_write_cypher returns Err(...) — callers should treat that as “best-effort failed; record state via the durable sidecar instead.”

Implementations

impl LazyCypherSink

pub fn new() -> Self

Construct an unwired sink.

pub fn set_host_executor(&self, exec: Arc<dyn HostCypherExecutor>)

Wire the host-side Cypher executor. Idempotent.

pub fn try_write_cypher(&self, cypher: &str) -> Result<(), String>

Best-effort write-mode Cypher execution. Returns an error string when the sink isn’t yet wired or the statement fails; the caller decides whether to retry or fall back to a durable sidecar write.

Errors

Returns a free-form error string when the sink isn’t yet wired, the host has been dropped, or the Cypher statement fails to parse / commit. (The current-thread-runtime guard and block_in_place handling live in the host’s implementation.)

Trait Implementations

impl Debug for LazyCypherSink

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for LazyCypherSink

fn default() -> LazyCypherSink

Returns the “default value” for a type.