Struct PluginInstance 

pub struct PluginInstance { /* private fields */ }

A running WebAssembly plugin instance.

Holds the Wasmtime Store and Instance for a single plugin. All calls happen in the context of this instance and consume its fuel budget.

Implementations

impl PluginInstance

pub fn invoke(&mut self, name: &str) -> Result<(), PluginError>

Invokes an exported function that takes no parameters and returns nothing.

Errors

Returns PluginError::MissingExport if the export does not exist or has the wrong signature, or any other plugin error if execution fails.

Examples

use martensite_plugin::{CapabilitySet, PluginRuntime};

let runtime = PluginRuntime::new().unwrap();
let mut plugin = runtime.load(wasm_bytes, CapabilitySet::empty()).unwrap();
plugin.invoke("run").unwrap();

pub fn invoke_typed<Args, Rets>( &mut self, name: &str, args: Args, ) -> Result<Rets, PluginError>

where Args: WasmParams, Rets: WasmResults,

Invokes an exported function with a statically checked WebAssembly signature.

Errors

Returns PluginError::MissingExport if the export does not exist or has a signature different from Args -> Rets, or any execution error produced by the plugin.

pub fn drain_paint_commands(&mut self, f: impl FnMut(&PluginPaintCmd, &[u8]))

Drains paint commands from this instance’s host-side ring buffer.

The current ABI reports offset zero to the guest and keeps the backing allocation in host state. Mapping it directly into guest linear memory is reserved as a future shared-memory optimization.

pub fn capabilities(&self) -> &CapabilitySet

Returns a reference to the capability set active for this instance.