Struct Controller 

pub struct Controller { /* private fields */ }

Per-execution controller. Not thread-safe — use one at a time. Can be reused across invocations by swapping the host context. WASM linear memory persists between calls, so Rust statics survive.

Implementations

impl Controller

pub fn set_context(&mut self, context: Box<dyn InvocationContext>)

Replace the invocation context. Used when reusing a pooled controller for a new request with different permissions. Also updates the WASI stdio callbacks so guest println! output routes through the same structured logging path as the WIT stdout/stderr imports.

pub fn clear_context(&mut self)

Clear the invocation context, replacing it with a NullContext. Called before returning a controller to the pool so no per-request state (auth, permissions, KV) is retained. Resets WASI stdio to host defaults.

pub fn reset_epoch_deadline(&mut self)

Reset the epoch deadline to the maximum safe value. Wasmtime internally computes current_epoch + delta with wrapping arithmetic, so passing u64::MAX overflows once the epoch advances past 0. We subtract the shadow counter (always >= engine epoch thanks to the ticker thread increment ordering) plus a small margin so that a concurrent tick between the load and the set_epoch_deadline call cannot overflow.

pub async fn init(&mut self) -> SurrealismResult<()>

pub async fn invoke<A: Args>( &mut self, name: Option<String>, args: A, ) -> SurrealismResult<Value>

pub async fn invoke_with_timeout<A: Args>( &mut self, name: Option<String>, args: A, context_timeout: Option<Duration>, ) -> SurrealismResult<Value>

Invoke with an optional context-level timeout. The effective deadline is min(context_remaining, module_config, server_cap).

pub async fn args( &mut self, name: Option<String>, ) -> SurrealismResult<Vec<(String, Kind)>>

Query named argument types for a function via the WASM export. Only available when the module has the function-args export (build tool).

pub async fn returns(&mut self, name: Option<String>) -> SurrealismResult<Kind>

Query return type for a function via the WASM export. Only available when the module has the function-returns export (build tool).

pub async fn writeable( &mut self, name: Option<String>, ) -> SurrealismResult<bool>

Query whether a function is marked as writeable via the WASM export. Only available when the module has the function-writeable export (build tool).

pub async fn comment( &mut self, name: Option<String>, ) -> SurrealismResult<Option<String>>

Query the comment for a function via the WASM export. Only available when the module has the function-comment export (build tool).

pub async fn list(&mut self) -> SurrealismResult<Vec<Option<String>>>

List all exported function names via the WASM export. Only available when the module has the list-functions export (build tool).

Trait Implementations

impl Debug for Controller

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

Formats the value using the given formatter.