torvyn-engine 0.1.1

Wasm engine abstraction and ComponentInvoker for Torvyn
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

//! # 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.

#![deny(missing_docs)]

pub mod config;
pub mod error;
pub mod traits;
pub mod types;

#[cfg(feature = "wasmtime-backend")]
pub mod wasmtime_engine;

#[cfg(feature = "wasmtime-backend")]
pub mod wasmtime_invoker;

pub mod cache;

#[cfg(feature = "mock")]
pub mod mock;

// ---------------------------------------------------------------------------
// Re-exports
// ---------------------------------------------------------------------------

pub use cache::CompiledComponentCache;
pub use config::{CompilationStrategy, WasmtimeEngineConfig};
pub use error::EngineError;
pub use traits::{ComponentInvoker, WasmEngine};
pub use types::{
    CompiledComponent, ComponentInstance, ImportBindings, InvocationResult, OutputElement,
    ProcessResult, StreamElement,
};

#[cfg(feature = "wasmtime-backend")]
pub use wasmtime_engine::WasmtimeEngine;

#[cfg(feature = "wasmtime-backend")]
pub use wasmtime_invoker::WasmtimeInvoker;