Crate torvyn_engine 

torvyn-engine

Wasm engine abstraction and component invocation layer for the Torvyn reactive streaming runtime.

This crate provides:

• WasmEngine — abstract interface for Wasm runtime operations (compile, instantiate, fuel/memory management).
• ComponentInvoker — the hot-path typed invocation interface between the reactor and Wasm execution (Gap G-01 fix).
• WasmtimeEngine — Wasmtime-based WasmEngine implementation (feature: wasmtime-backend).
• WasmtimeInvoker — Wasmtime-based ComponentInvoker implementation (feature: wasmtime-backend).
• CompiledComponentCache — compiled component cache with disk support.
• Mock implementations for testing downstream crates (feature: mock).

Feature Flags

• wasmtime-backend (default) — enables the Wasmtime backend.
• mock — enables mock implementations for testing.
• tracing-support — enables structured logging via the tracing crate.

Architecture

Per Doc 02, Section 3: all Wasm engine interactions go through the WasmEngine trait to insulate Torvyn from Wasmtime-specific APIs. The ComponentInvoker trait (Doc 10, Gap G-01) provides typed hot-path invocation between the reactor and Wasm execution.

Re-exports

pub use cache::CompiledComponentCache;

pub use config::CompilationStrategy;

pub use config::WasmtimeEngineConfig;

pub use error::EngineError;

pub use traits::ComponentInvoker;

pub use traits::WasmEngine;

pub use types::CompiledComponent;

pub use types::ComponentInstance;

pub use types::ImportBindings;

pub use types::InvocationResult;

pub use types::OutputElement;

pub use types::ProcessResult;

pub use types::StreamElement;

pub use wasmtime_engine::WasmtimeEngine;

pub use wasmtime_invoker::WasmtimeInvoker;

Modules

cache

Compiled component cache for fast instantiation.

config

Configuration types for the Torvyn Wasm engine.

error

Engine error types for the Torvyn runtime.

traits

Core traits for the Torvyn Wasm engine abstraction.

types

Engine-specific types for the Torvyn runtime.

wasmtime_engine

Wasmtime-based implementation of the WasmEngine trait.

wasmtime_invoker

Wasmtime-based implementation of the ComponentInvoker trait.