Skip to main content

WasmEngine

Struct WasmEngine 

Source
pub struct WasmEngine { /* private fields */ }
Expand description

A WebAssembly-compatible workflow engine.

Wraps the dataflow-rs Engine to provide async message processing that returns JavaScript Promises.

Implementations§

Source§

impl WasmEngine

Source

pub fn new(workflows_json: &str) -> Result<WasmEngine, String>

Create a new WasmEngine from a JSON array of workflow definitions.

§Arguments
  • workflows_json - JSON string containing an array of workflow definitions
§Example
const workflows = JSON.stringify([{
    id: "workflow1",
    name: "My Workflow",
    priority: 1,
    tasks: [...]
}]);
const engine = new WasmEngine(workflows);
Source

pub fn process(&self, payload: &str) -> Promise

Process a payload through the engine’s workflows.

This is an async operation that returns a Promise. The payload is stored as a raw string and should be parsed by a parse plugin in the workflow if JSON parsing is needed.

§Arguments
  • payload - Raw string payload to process (not parsed by the engine)
§Returns

A Promise that resolves to the processed message as a JSON string

§Example
const payload = '{"name": "John", "email": "john@example.com"}';
const result = await engine.process(payload);
const processed = JSON.parse(result);
console.log(processed.context.data);
Source

pub fn process_with_trace(&self, payload: &str) -> Promise

Process a payload with step-by-step execution tracing.

This is an async operation that returns a Promise with the execution trace. The trace contains message snapshots after each step, including which workflows/tasks were executed or skipped. The payload is stored as a raw string and should be parsed by a parse plugin.

§Arguments
  • payload - Raw string payload to process (not parsed by the engine)
§Returns

A Promise that resolves to the execution trace as a JSON string

§Example
const payload = '{"name": "John", "email": "john@example.com"}';
const trace = await engine.process_with_trace(payload);
const traceData = JSON.parse(trace);
console.log(traceData.steps); // Array of execution steps
Source

pub fn workflow_count(&self) -> usize

Get the number of workflows registered in the engine.

Source

pub fn workflow_ids(&self) -> String

Get the list of workflow IDs.

§Returns

JSON array of workflow IDs as a string

Trait Implementations§

Source§

impl From<WasmEngine> for JsValue

Source§

fn from(value: WasmEngine) -> Self

Converts to this type from the input type.
Source§

impl FromWasmAbi for WasmEngine

Source§

type Abi = u32

The Wasm ABI type that this converts from when coming back out from the ABI boundary.
Source§

unsafe fn from_abi(js: u32) -> Self

Recover a Self from Self::Abi. Read more
Source§

impl IntoWasmAbi for WasmEngine

Source§

type Abi = u32

The Wasm ABI type that this converts into when crossing the ABI boundary.
Source§

fn into_abi(self) -> u32

Convert self into Self::Abi so that it can be sent across the wasm ABI boundary.
Source§

impl LongRefFromWasmAbi for WasmEngine

Source§

type Abi = u32

Same as RefFromWasmAbi::Abi
Source§

type Anchor = RcRef<WasmEngine>

Same as RefFromWasmAbi::Anchor
Source§

unsafe fn long_ref_from_abi(js: Self::Abi) -> Self::Anchor

Same as RefFromWasmAbi::ref_from_abi
Source§

impl OptionFromWasmAbi for WasmEngine

Source§

fn is_none(abi: &Self::Abi) -> bool

Tests whether the argument is a “none” instance. If so it will be deserialized as None, and otherwise it will be passed to FromWasmAbi.
Source§

impl OptionIntoWasmAbi for WasmEngine

Source§

fn none() -> Self::Abi

Returns an ABI instance indicating “none”, which JS will interpret as the None branch of this option. Read more
Source§

impl RefFromWasmAbi for WasmEngine

Source§

type Abi = u32

The Wasm ABI type references to Self are recovered from.
Source§

type Anchor = RcRef<WasmEngine>

The type that holds the reference to Self for the duration of the invocation of the function that has an &Self parameter. This is required to ensure that the lifetimes don’t persist beyond one function call, and so that they remain anonymous.
Source§

unsafe fn ref_from_abi(js: Self::Abi) -> Self::Anchor

Recover a Self::Anchor from Self::Abi. Read more
Source§

impl RefMutFromWasmAbi for WasmEngine

Source§

type Abi = u32

Same as RefFromWasmAbi::Abi
Source§

type Anchor = RcRefMut<WasmEngine>

Same as RefFromWasmAbi::Anchor
Source§

unsafe fn ref_mut_from_abi(js: Self::Abi) -> Self::Anchor

Same as RefFromWasmAbi::ref_from_abi
Source§

impl TryFromJsValue for WasmEngine

Source§

fn try_from_js_value(value: JsValue) -> Result<Self, JsValue>

Performs the conversion.
Source§

fn try_from_js_value_ref(value: &JsValue) -> Option<Self>

Performs the conversion.
Source§

impl VectorFromWasmAbi for WasmEngine

Source§

type Abi = <Box<[JsValue]> as FromWasmAbi>::Abi

Source§

unsafe fn vector_from_abi(js: Self::Abi) -> Box<[WasmEngine]>

Source§

impl VectorIntoWasmAbi for WasmEngine

Source§

impl WasmDescribe for WasmEngine

Source§

impl WasmDescribeVector for WasmEngine

Source§

impl SupportsConstructor for WasmEngine

Source§

impl SupportsInstanceProperty for WasmEngine

Source§

impl SupportsStaticProperty for WasmEngine

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ReturnWasmAbi for T
where T: IntoWasmAbi,

Source§

type Abi = <T as IntoWasmAbi>::Abi

Same as IntoWasmAbi::Abi
Source§

fn return_abi(self) -> <T as ReturnWasmAbi>::Abi

Same as IntoWasmAbi::into_abi, except that it may throw and never return in the case of Err.
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.