Struct CompiledComponentCache 

pub struct CompiledComponentCache { /* private fields */ }

Cache for compiled WebAssembly components.

Provides both in-memory and optional disk caching. Components are keyed by ComponentTypeId (SHA-256 of the binary).

Thread-safe: uses RwLock for concurrent read access.

COLD PATH — all operations are during pipeline setup.

Examples

use torvyn_engine::CompiledComponentCache;

let cache = CompiledComponentCache::new(None);
assert_eq!(cache.len(), 0);

Implementations

impl CompiledComponentCache

pub fn new(disk_dir: Option<PathBuf>) -> Self

Create a new cache with an optional disk cache directory.

COLD PATH

pub fn compute_type_id(bytes: &[u8]) -> ComponentTypeId

Compute the ComponentTypeId for a component binary.

Uses SHA-256 to produce a deterministic content hash.

COLD PATH

Examples

use torvyn_engine::CompiledComponentCache;

let id = CompiledComponentCache::compute_type_id(b"hello");
assert_eq!(id.as_bytes().len(), 32);

pub fn get<E: WasmEngine>( &self, type_id: &ComponentTypeId, engine: &E, ) -> Result<Option<CompiledComponent>, EngineError>

Look up a compiled component in the cache (memory first, then disk).

COLD PATH

Returns

• Ok(Some(compiled)) if found in cache.
• Ok(None) if not in cache.
• Err if disk cache read failed fatally.

pub fn insert<E: WasmEngine>( &self, type_id: ComponentTypeId, compiled: CompiledComponent, engine: &E, )

Insert a compiled component into the cache.

COLD PATH

Stores in memory. If disk caching is enabled, also writes to disk (failures are non-fatal).

pub fn len(&self) -> usize

Returns the number of components in the memory cache.

pub fn is_empty(&self) -> bool

Returns true if the memory cache is empty.

pub fn clear(&self)

Clear the in-memory cache.

pub fn compile_or_get<E: WasmEngine>( &self, bytes: &[u8], engine: &E, ) -> Result<(ComponentTypeId, CompiledComponent), EngineError>

Compile a component with caching.

Checks the cache first. If not found, compiles the component and inserts it into the cache.

COLD PATH