Struct WasmLoader 

pub struct WasmLoader { /* private fields */ }

Top-level WASM Component Model plugin loader.

Implementations

impl WasmLoader

pub fn new() -> Self

Construct a fresh loader.

pub fn with_http(self, http: Arc<dyn HttpEgress>) -> Self

Attach an HTTP egress backing the host-net interface (builder style).

pub fn prepare( &self, manifest_json: &[u8], grants: &CapabilitySet, ) -> Result<PreparedComponent, WasmError>

Parse a CM-plugin manifest and intersect declared/granted capabilities. Deterministic — no wasmtime instantiation.

Errors

• WasmError::InvalidWasm if the JSON doesn’t parse.

pub fn prepare_parsed( &self, manifest: ComponentManifest, grants: &CapabilitySet, ) -> PreparedComponent

Intersect declared/granted capabilities for an already-parsed manifest, skipping the JSON round-trip.

Self::load reads the manifest export off a bootstrap instance (parsed ComponentManifest), then needs the cap-intersection result. The previous implementation re-serialized the parsed struct to JSON and called Self::prepare which deserialized it straight back — a wasteful round-trip whose only purpose was reusing the cap-intersection loop. This entry point preserves the loop and skips the (de)serialization.

pub fn instantiate( &self, bytes: &[u8], prepared: &PreparedComponent, ) -> Result<ScalarPluginInstance, WasmError>

Instantiate a CM plugin into a fresh ScalarPluginInstance.

Used directly only by tests; production code goes through Self::load which two-passes the manifest negotiation.

Errors

• WasmError::InvalidWasm on Component compilation failure.
• WasmError::Instantiate on linker / instantiation failure.

pub fn load( &self, bytes: &[u8], host_grants: &CapabilitySet, registrar: &mut PluginRegistrar<'_>, ) -> Result<LoadOutcome, WasmError>

End-to-end load: read manifest, intersect with host grants, rebuild with effective caps, read register export, register scalar adapters with the supplied registrar.

Errors

See Self::instantiate + manifest / register parse failures.

pub fn load_as_plugin( &self, bytes: &[u8], host_grants: &CapabilitySet, ) -> Result<Box<dyn Plugin + Send + Sync>, WasmError>

Load a component and present it as a uni_plugin::Plugin.

Unlike Self::load — which registers adapters directly into a caller-supplied registrar — this returns a self-contained Plugin whose uni_plugin::Plugin::manifest is synthesized from the component’s manifest and whose uni_plugin::Plugin::register replays the component’s register entries. It is the bridge the conformance harness (uni_plugin_conformance::WasmConformanceLoader) needs to run the same probe suite against a real component as against a live-Rust plugin.

The returned plugin owns the warm scalar pool plus the component bytes and negotiated capabilities, so register can rebuild aggregate/procedure pools and is safely re-runnable (the conformance idempotency probe registers twice).

Errors

See Self::load — manifest / register parse + instantiation failures, plus WasmError::InvalidWasm if the manifest version is not semver.

Trait Implementations

impl Debug for WasmLoader

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

Formats the value using the given formatter.

impl Default for WasmLoader

fn default() -> WasmLoader

Returns the “default value” for a type.