Struct Runtime 

pub struct Runtime { /* private fields */ }

Compiled WASM runtime. Thread-safe, can be shared across threads via Arc. Compiles WASM once, then each controller gets its own isolated Store/Instance. Holds a pool of initialized controllers for reuse across invocations.

Implementations

impl Runtime

pub fn new( _: SurrealismPackage, server_pool_size: usize, server_max_memory: Option<usize>, server_max_execution_time: Option<Duration>, server_max_kv_entries: Option<usize>, server_max_kv_value_bytes: Option<usize>, ) -> SurrealismResult<Self>

Compile the WASM and prepare the runtime. This is expensive — do it once and share via Arc<Runtime>.

server_pool_size, server_max_memory, server_max_execution_time, server_max_kv_entries, and server_max_kv_value_bytes are the server-level ceilings from environment variables.

pub fn wasm_size(&self) -> usize

Returns the size of the original WASM binary in bytes.

pub fn kv_store(&self) -> &Arc<BTreeMapStore>

Returns the per-module KV store. This store is shared across all invocations and persists for the lifetime of the Runtime.

pub fn config(&self) -> &SurrealismConfig

Returns the module configuration.

pub fn resolved_allow_net(&self) -> Arc<Vec<ResolvedNetAllow>>

Resolved allow_net from module load (same snapshot used for WASI socket filtering).

pub async fn acquire_controller( &self, context: Box<dyn InvocationContext>, ) -> SurrealismResult<Controller>

Acquire a controller ready for invocation. Reuses a pooled controller if available (preserving WASM memory / statics from prior runs), otherwise creates and initializes a fresh one — waiting on Semaphore if max_pool_size controllers are already checked out. The supplied context is installed before returning.

The semaphore permit is acquired before checking the pool so that a popped controller is never outstanding without a matching permit.

pub fn release_controller(&self, controller: Controller)

Return a controller to the pool for reuse. The invocation context is cleared (replaced with a NullContext) so no per-request state is retained on the host side. WASM linear memory (statics, heap) is preserved for the next invocation.

Do NOT release a controller after a WASM trap — drop it instead to discard potentially inconsistent instance state.

pub fn get_signature( &self, sub: Option<&str>, ) -> SurrealismResult<&FunctionExport>

Look up a function signature from the exports manifest.

pub fn exports(&self) -> &ExportsManifest

Access the full exports manifest.

pub async fn new_controller( &self, context: Box<dyn InvocationContext>, ) -> SurrealismResult<Controller>

Create a new Controller with its own isolated Store and Instance. Import resolution is already done (in InstancePre); this only allocates memory, initializes state, and runs any start functions.

Prefer acquire_controller for the reuse path. This is the low-level constructor.

Trait Implementations

impl Debug for Runtime

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

Formats the value using the given formatter.