forge-host 0.1.9

WASM plugin runtime for OpenAPI Forge
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

//! WASM plugin runtime.
//!
//! Loads sandboxed WASM components, enforces fuel / memory / epoch limits,
//! provides the `host-api` imports declared in `wit/host.wit`, and invokes
//! plugin exports.
//!
//! # Sandbox
//!
//! Plugins receive **no** filesystem, network, clock, RNG, environment, or
//! process state. The only host imports are `log` and `case-convert`. WASI
//! imports are not linked. See ADR-0001 and ADR-0008.
//!
//! # Resource limits
//!
//! Every plugin invocation has its own `Store` / `StoreLimits` / `wasmtime`
//! resource budget:
//!
//! * **Fuel** — instructions executed. `consume_fuel = true` on the engine.
//! * **Memory** — bytes allocated by guest linear memory. Enforced via
//!   `wasmtime::ResourceLimiter`.
//! * **Wall-clock time** — enforced via epoch interruption. The engine has a
//!   shared epoch counter ticked by a background thread on a fixed cadence;
//!   each store sets `epoch_deadline_trap()` at the appropriate count.

#![forbid(unsafe_code)]

pub mod filesystem;
mod runtime;

pub use runtime::{
    Engine, EngineError, FileMode, GenerationOutput, HostState, Limits, LoadError, OutputFile,
    Plugin, PluginKind, ResourceKind, StageError, TransformOutput,
};