Struct TriggerContext 

#[non_exhaustive]
pub struct TriggerContext<'a> {
    pub session_id: &'a str,
    pub tx_id: u64,
    /* private fields */
}

Per-fire context.

ABI note (3.0 breaking change)

Carries an owned optional ProcedureHost handle so a declared (synthesized) trigger can reach the host’s write-enabled inner-query primitive from inside fire. The handle is owned (not borrowed) because the after-commit async dispatch path moves the context into a 'static spawned task and rebuilds it there — a borrow could not outlive the commit stack frame. Native trigger plugins that never touch host() are unaffected (the field defaults to None).

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

session_id: &'a str

Session identifier.

tx_id: u64

Transaction identifier.

Implementations

impl<'a> TriggerContext<'a>

pub fn new(session_id: &'a str, tx_id: u64) -> Self

Construct a fresh context with no host handle. The struct is #[non_exhaustive] so external callers can’t use struct-literal syntax; this constructor is the supported path. Future fields ship via with_* builder methods to preserve API compatibility.

pub fn with_host(self, host: Arc<dyn ProcedureHost>) -> Self

Attach an owned host handle to this context.

The commit-path dispatcher threads a write-enabled host through so a declared trigger’s fire can downcast it (via ProcedureHost::as_any) and run its stored Cypher action body.

pub fn host(&self) -> Option<&Arc<dyn ProcedureHost>>

Borrow the attached host handle, when one was threaded in.

Trait Implementations

impl Debug for TriggerContext<'_>

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

Formats the value using the given formatter.