@wooksjs/event-wf 0.3.7

package/README.md

@@ -0,0 +1,81 @@
+# @wooksjs/event-wf
+
+**!!! This is work-in-progress library, breaking changes are expected !!!**
+
+<p align="center">
+<img src="../../wooks-logo.png" width="450px"><br>
+<a  href="https://github.com/wooksjs/wooksjs/blob/main/LICENSE">
+    <img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge" />
+</a>
+</p>
+
+The `@wooksjs/event-wf` is a component of the `wooks` event processing framework built on top of [@prostojs/wf](https://github.com/prostojs/wf). It provides a way to manage complex workflows and processes using the underlying workflow engine.
+
+The primary features of `@wooksjs/event-wf` include:
+
+- Support for conditional workflow branching based on dynamic conditions.
+- Support for parametric steps and workflows.
+- Support for user input requirements and interaction during the workflows.
+
+## Installation
+
+To install `@wooksjs/event-wf`, you can use npm:
+
+```sh
+npm install wooks @wooksjs/event-wf
+```
+
+## Quick Start
+
+```js
+import { useRouteParams } from '@wooksjs/event-core'
+import { createWfApp } from '@wooksjs/event-wf'
+
+const app = createWfApp<{ result: number }>()
+
+app.step('add', {
+    input: 'number',
+    handler: 'ctx.result += input',
+})
+
+app.step('add/:n', {
+    handler: (ctx) => {
+        ctx.result += Number(useRouteParams().get('n'))
+    },
+})
+
+app.flow('adding', [
+    { id: 'add', input: 5 },
+    { id: 'add', input: 2 },
+    {
+        condition: 'result < 10',
+        steps: [{ id: 'add', input: 3 }, { id: 'add', input: 4 }],
+    },
+])
+
+app.flow('adding-parametric', [
+    'add/5',
+    'add/2',
+    {
+        condition: 'result < 10',
+        steps: ['add/3', 'add/4'],
+    },
+])
+
+app.run()
+
+// Run the 'adding' workflow
+app.start('adding', { result: 0 })
+```
+
+## Documentation
+
+For more detailed documentation, please visit [wooks.moost.org](https://wooks.moost.org/wfapp/).
+
+## Contributing
+
+Contributions to the `@wooksjs/event-wf` project are welcome. If you find any bugs or have a feature request, please open an issue on [the GitHub repository](https://github.com/wooksjs/wooksjs).
+
+## License
+
+`@wooksjs/event-wf` is licensed under the [MIT license](https://github.com/wooksjs/wooksjs/blob/main/LICENSE).

package/dist/index.cjs

@@ -0,0 +1,188 @@
+'use strict';
+
+var eventCore = require('@wooksjs/event-core');
+var wooks = require('wooks');
+var wf = require('@prostojs/wf');
+
+function createWfContext(data, options) {
+    return eventCore.createEventContext({
+        event: Object.assign(Object.assign({}, data), { type: 'WF' }),
+        resume: false,
+        options,
+    });
+}
+function resumeWfContext(data, options) {
+    return eventCore.createEventContext({
+        event: Object.assign(Object.assign({}, data), { type: 'WF' }),
+        resume: true,
+        options,
+    });
+}
+/**
+ * Wrapper on top of useEventContext that provides
+ * proper context types for WF event
+ * @returns set of hooks { getCtx, restoreCtx, clearCtx, hookStore, getStore, setStore }
+ */
+function useWFContext() {
+    return eventCore.useEventContext('CLI');
+}
+
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+/* global Reflect, Promise */
+
+
+function __awaiter(thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+}
+
+class WooksWorkflow extends wf.Workflow {
+    constructor(wooks) {
+        super([]);
+        this.wooks = wooks;
+    }
+    resolveStep(stepId) {
+        var _a, _b, _c;
+        try {
+            useWFContext();
+            const found = this.wooks.lookup('WF_STEP', '/' + stepId);
+            if ((_a = found === null || found === void 0 ? void 0 : found.handlers) === null || _a === void 0 ? void 0 : _a.length) {
+                return found.handlers[0]();
+            }
+        }
+        catch (e) {
+            const router = this.wooks.getRouter();
+            const found = router.lookup('WF_STEP', '/' + stepId);
+            if ((_c = (_b = found === null || found === void 0 ? void 0 : found.route) === null || _b === void 0 ? void 0 : _b.handlers) === null || _c === void 0 ? void 0 : _c.length) {
+                return found.route.handlers[0]();
+            }
+        }
+        throw new Error(`Step "${stepId}" not found.`);
+    }
+}
+
+const wfShortcuts = {
+    flow: 'WF_FLOW',
+    step: 'WF_STEP',
+};
+class WooksWf extends wooks.WooksAdapterBase {
+    constructor(opts, wooks) {
+        super(wooks, opts === null || opts === void 0 ? void 0 : opts.logger, opts === null || opts === void 0 ? void 0 : opts.router);
+        this.opts = opts;
+        this.logger = (opts === null || opts === void 0 ? void 0 : opts.logger) || this.getLogger('wooks-wf');
+        this.wf = new WooksWorkflow(this.wooks);
+    }
+    step(id, opts) {
+        const step = wf.createStep(id, opts);
+        return this.on('WF_STEP', id, () => step);
+    }
+    flow(id, schema) {
+        this.wf.register(id, schema);
+        return this.on('WF_FLOW', id, () => id);
+    }
+    start(schemaId, inputContext, input) {
+        return this._start(schemaId, inputContext, undefined, input);
+    }
+    resume(schemaId, inputContext, indexes, input) {
+        return this._start(schemaId, inputContext, indexes, input);
+    }
+    _start(schemaId, inputContext, indexes, input) {
+        var _a, _b;
+        return __awaiter(this, void 0, void 0, function* () {
+            const resume = !!(indexes === null || indexes === void 0 ? void 0 : indexes.length);
+            const { restoreCtx, clearCtx } = (resume ? resumeWfContext : createWfContext)({
+                inputContext,
+                schemaId,
+                indexes,
+                input,
+            }, this.mergeEventOptions((_a = this.opts) === null || _a === void 0 ? void 0 : _a.eventOptions));
+            const { handlers: foundHandlers } = this.wooks.lookup('WF_FLOW', '/' + schemaId);
+            const handlers = foundHandlers ||
+                (((_b = this.opts) === null || _b === void 0 ? void 0 : _b.onNotFound) && [this.opts.onNotFound]) ||
+                null;
+            if (handlers && handlers.length) {
+                let result = {};
+                for (const handler of handlers) {
+                    restoreCtx();
+                    const schemaId = (yield handler());
+                    if (resume) {
+                        result = yield this.wf.resume(schemaId, { context: inputContext, indexes }, input);
+                        break;
+                    }
+                    else {
+                        result = yield this.wf.start(schemaId, inputContext, input);
+                        break;
+                    }
+                }
+                clearCtx();
+                return result;
+            }
+            clearCtx();
+            throw new Error('Unknown schemaId: ' + schemaId);
+        });
+    }
+    onError(e) {
+        var _a;
+        if ((_a = this.opts) === null || _a === void 0 ? void 0 : _a.onError) {
+            this.opts.onError(e);
+        }
+        else {
+            this.error(e.message);
+            process.exit(1);
+        }
+    }
+    error(e) {
+        if (typeof e === 'string') {
+            console.error('' + 'ERROR: ' + '' + e);
+        }
+        else {
+            console.error('' + 'ERROR: ' + '' + e.message);
+        }
+    }
+}
+/**
+ * Factory for WooksWf App
+ * @param opts TWooksWfOptions
+ * @param wooks Wooks | WooksAdapterBase
+ * @returns WooksWf
+ */
+function createWfApp(opts, wooks) {
+    return new WooksWf(opts, wooks);
+}
+
+function useWfState() {
+    const { store } = useWFContext();
+    const event = store('event');
+    return {
+        ctx: () => event.get('inputContext'),
+        input: () => event.get('input'),
+        schemaId: event.get('schemaId'),
+        indexes: () => event.get('indexes'),
+    };
+}
+
+exports.WooksWf = WooksWf;
+exports.createWfApp = createWfApp;
+exports.createWfContext = createWfContext;
+exports.resumeWfContext = resumeWfContext;
+exports.useWFContext = useWFContext;
+exports.useWfState = useWfState;
+exports.wfShortcuts = wfShortcuts;

package/dist/index.d.ts

@@ -0,0 +1,151 @@
+import { Step } from '@prostojs/wf';
+import { TConsoleBase } from '@prostojs/logger';
+import { TEmpty } from '@wooksjs/event-core';
+import { TEventOptions } from '@wooksjs/event-core';
+import { TFlowOutput } from '@prostojs/wf';
+import { TGenericContextStore } from '@wooksjs/event-core';
+import { TProstoRouterPathHandle } from '@prostojs/router';
+import { TStepHandler } from '@prostojs/wf';
+import { TWooksHandler } from 'wooks';
+import { TWooksOptions } from 'wooks';
+import { TWorkflowSchema } from '@prostojs/wf';
+import { Wooks } from 'wooks';
+import { WooksAdapterBase } from 'wooks';
+import { Workflow } from '@prostojs/wf';
+
+/**
+ * Factory for WooksWf App
+ * @param opts TWooksWfOptions
+ * @param wooks Wooks | WooksAdapterBase
+ * @returns WooksWf
+ */
+export declare function createWfApp<T>(opts?: TWooksWfOptions, wooks?: Wooks | WooksAdapterBase): WooksWf<T>;
+
+export declare function createWfContext(data: Omit<TWFEventData, 'type'>, options: TEventOptions): {
+    getCtx: () => TWFContextStore & TGenericContextStore<TWFEventData>;
+    restoreCtx: () => TGenericContextStore<TEmpty>;
+    clearCtx: () => null;
+    store: <K extends "resume" | keyof TGenericContextStore<TWFEventData>>(key: K) => {
+        value: (TWFContextStore & TGenericContextStore<TWFEventData>)[K];
+        hook: <K2 extends keyof Required<TWFContextStore & TGenericContextStore<TWFEventData>>[K]>(key2: K2) => {
+            value: Required<TWFContextStore & TGenericContextStore<TWFEventData>>[K][K2];
+            isDefined: boolean;
+        };
+        init: <K2_1 extends keyof Required<TWFContextStore & TGenericContextStore<TWFEventData>>[K]>(key2: K2_1, getter: () => Required<Required<TWFContextStore & TGenericContextStore<TWFEventData>>[K]>[K2_1]) => Required<Required<TWFContextStore & TGenericContextStore<TWFEventData>>[K]>[K2_1];
+        set: <K2_2 extends keyof Required<TWFContextStore & TGenericContextStore<TWFEventData>>[K]>(key2: K2_2, v: Required<(TWFContextStore & TGenericContextStore<TWFEventData>)[K]>[K2_2]) => Required<(TWFContextStore & TGenericContextStore<TWFEventData>)[K]>[K2_2];
+        get: <K2_3 extends keyof Required<TWFContextStore & TGenericContextStore<TWFEventData>>[K]>(key2: K2_3) => Required<TWFContextStore & TGenericContextStore<TWFEventData>>[K][K2_3];
+        has: <K2_4 extends keyof Required<TWFContextStore & TGenericContextStore<TWFEventData>>[K]>(key2: K2_4) => boolean;
+        del: <K2_5 extends keyof Required<TWFContextStore & TGenericContextStore<TWFEventData>>[K]>(key2: K2_5) => void;
+        entries: () => [string, unknown][];
+        clear: () => void;
+    };
+    getStore: <K_1 extends "resume" | keyof TGenericContextStore<TWFEventData>>(key: K_1) => (TWFContextStore & TGenericContextStore<TWFEventData>)[K_1];
+    setStore: <K_2 extends "resume" | keyof TGenericContextStore<TWFEventData>>(key: K_2, v: (TWFContextStore & TGenericContextStore<TWFEventData>)[K_2]) => void;
+};
+
+export declare function resumeWfContext(data: Omit<TWFEventData, 'type'>, options: TEventOptions): {
+    getCtx: () => TWFContextStore & TGenericContextStore<TWFEventData>;
+    restoreCtx: () => TGenericContextStore<TEmpty>;
+    clearCtx: () => null;
+    store: <K extends "resume" | keyof TGenericContextStore<TWFEventData>>(key: K) => {
+        value: (TWFContextStore & TGenericContextStore<TWFEventData>)[K];
+        hook: <K2 extends keyof Required<TWFContextStore & TGenericContextStore<TWFEventData>>[K]>(key2: K2) => {
+            value: Required<TWFContextStore & TGenericContextStore<TWFEventData>>[K][K2];
+            isDefined: boolean;
+        };
+        init: <K2_1 extends keyof Required<TWFContextStore & TGenericContextStore<TWFEventData>>[K]>(key2: K2_1, getter: () => Required<Required<TWFContextStore & TGenericContextStore<TWFEventData>>[K]>[K2_1]) => Required<Required<TWFContextStore & TGenericContextStore<TWFEventData>>[K]>[K2_1];
+        set: <K2_2 extends keyof Required<TWFContextStore & TGenericContextStore<TWFEventData>>[K]>(key2: K2_2, v: Required<(TWFContextStore & TGenericContextStore<TWFEventData>)[K]>[K2_2]) => Required<(TWFContextStore & TGenericContextStore<TWFEventData>)[K]>[K2_2];
+        get: <K2_3 extends keyof Required<TWFContextStore & TGenericContextStore<TWFEventData>>[K]>(key2: K2_3) => Required<TWFContextStore & TGenericContextStore<TWFEventData>>[K][K2_3];
+        has: <K2_4 extends keyof Required<TWFContextStore & TGenericContextStore<TWFEventData>>[K]>(key2: K2_4) => boolean;
+        del: <K2_5 extends keyof Required<TWFContextStore & TGenericContextStore<TWFEventData>>[K]>(key2: K2_5) => void;
+        entries: () => [string, unknown][];
+        clear: () => void;
+    };
+    getStore: <K_1 extends "resume" | keyof TGenericContextStore<TWFEventData>>(key: K_1) => (TWFContextStore & TGenericContextStore<TWFEventData>)[K_1];
+    setStore: <K_2 extends "resume" | keyof TGenericContextStore<TWFEventData>>(key: K_2, v: (TWFContextStore & TGenericContextStore<TWFEventData>)[K_2]) => void;
+};
+
+export declare interface TWFContextStore {
+    resume: boolean;
+}
+
+export declare interface TWFEventData {
+    schemaId: string;
+    inputContext: unknown;
+    indexes?: number[];
+    input?: unknown;
+    type: 'WF';
+}
+
+export declare interface TWooksWfOptions {
+    onError?(e: Error): void;
+    onNotFound?: TWooksHandler<unknown>;
+    onUnknownFlow?: (schemaId: string, raiseError: () => void) => unknown;
+    logger?: TConsoleBase;
+    eventOptions?: TEventOptions;
+    router?: TWooksOptions['router'];
+}
+
+/**
+ * Wrapper on top of useEventContext that provides
+ * proper context types for WF event
+ * @returns set of hooks { getCtx, restoreCtx, clearCtx, hookStore, getStore, setStore }
+ */
+export declare function useWFContext<T extends TEmpty>(): {
+    getCtx: () => TWFContextStore & T & TGenericContextStore<TWFEventData>;
+    restoreCtx: () => TGenericContextStore<TEmpty>;
+    clearCtx: () => null;
+    store: <K extends "resume" | keyof TGenericContextStore<TWFEventData> | keyof T>(key: K) => {
+        value: (TWFContextStore & T & TGenericContextStore<TWFEventData>)[K];
+        hook: <K2 extends keyof Required<TWFContextStore & T & TGenericContextStore<TWFEventData>>[K]>(key2: K2) => {
+            value: Required<TWFContextStore & T & TGenericContextStore<TWFEventData>>[K][K2];
+            isDefined: boolean;
+        };
+        init: <K2_1 extends keyof Required<TWFContextStore & T & TGenericContextStore<TWFEventData>>[K]>(key2: K2_1, getter: () => Required<Required<TWFContextStore & T & TGenericContextStore<TWFEventData>>[K]>[K2_1]) => Required<Required<TWFContextStore & T & TGenericContextStore<TWFEventData>>[K]>[K2_1];
+        set: <K2_2 extends keyof Required<TWFContextStore & T & TGenericContextStore<TWFEventData>>[K]>(key2: K2_2, v: Required<(TWFContextStore & T & TGenericContextStore<TWFEventData>)[K]>[K2_2]) => Required<(TWFContextStore & T & TGenericContextStore<TWFEventData>)[K]>[K2_2];
+        get: <K2_3 extends keyof Required<TWFContextStore & T & TGenericContextStore<TWFEventData>>[K]>(key2: K2_3) => Required<TWFContextStore & T & TGenericContextStore<TWFEventData>>[K][K2_3];
+        has: <K2_4 extends keyof Required<TWFContextStore & T & TGenericContextStore<TWFEventData>>[K]>(key2: K2_4) => boolean;
+        del: <K2_5 extends keyof Required<TWFContextStore & T & TGenericContextStore<TWFEventData>>[K]>(key2: K2_5) => void;
+        entries: () => [string, unknown][];
+        clear: () => void;
+    };
+    getStore: <K_1 extends "resume" | keyof TGenericContextStore<TWFEventData> | keyof T>(key: K_1) => (TWFContextStore & T & TGenericContextStore<TWFEventData>)[K_1];
+    setStore: <K_2 extends "resume" | keyof TGenericContextStore<TWFEventData> | keyof T>(key: K_2, v: (TWFContextStore & T & TGenericContextStore<TWFEventData>)[K_2]) => void;
+};
+
+export declare function useWfState(): {
+    ctx: <T>() => T;
+    input: <I>() => I | undefined;
+    schemaId: string;
+    indexes: () => number[] | undefined;
+};
+
+export declare const wfShortcuts: {
+    flow: string;
+    step: string;
+};
+
+export declare class WooksWf<T> extends WooksAdapterBase {
+    protected opts?: TWooksWfOptions | undefined;
+    protected logger: TConsoleBase;
+    protected wf: WooksWorkflow<T>;
+    constructor(opts?: TWooksWfOptions | undefined, wooks?: Wooks | WooksAdapterBase);
+    step<I = any, D = any>(id: string, opts: {
+        input?: D;
+        handler: string | TStepHandler<T, I, D>;
+    }): TProstoRouterPathHandle<Record<string, string | string[]>>;
+    flow(id: string, schema: TWorkflowSchema<T>): TProstoRouterPathHandle<Record<string, string | string[]>>;
+    start<I>(schemaId: string, inputContext: T, input?: I): Promise<TFlowOutput<T, I>>;
+    resume<I>(schemaId: string, inputContext: T, indexes: number[], input?: I): Promise<TFlowOutput<T, I>>;
+    protected _start<I>(schemaId: string, inputContext: T, indexes?: number[], input?: I): Promise<TFlowOutput<T, I>>;
+    protected onError(e: Error): void;
+    protected error(e: string | Error): void;
+}
+
+declare class WooksWorkflow<T> extends Workflow<T> {
+    protected wooks: Wooks;
+    constructor(wooks: Wooks);
+    protected resolveStep<I, D>(stepId: string): Step<T, I, D>;
+}
+
+export { }

package/dist/index.mjs

@@ -0,0 +1,180 @@
+import { createEventContext, useEventContext } from '@wooksjs/event-core';
+import { WooksAdapterBase } from 'wooks';
+import { Workflow, createStep } from '@prostojs/wf';
+
+function createWfContext(data, options) {
+    return createEventContext({
+        event: Object.assign(Object.assign({}, data), { type: 'WF' }),
+        resume: false,
+        options,
+    });
+}
+function resumeWfContext(data, options) {
+    return createEventContext({
+        event: Object.assign(Object.assign({}, data), { type: 'WF' }),
+        resume: true,
+        options,
+    });
+}
+/**
+ * Wrapper on top of useEventContext that provides
+ * proper context types for WF event
+ * @returns set of hooks { getCtx, restoreCtx, clearCtx, hookStore, getStore, setStore }
+ */
+function useWFContext() {
+    return useEventContext('CLI');
+}
+
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+/* global Reflect, Promise */
+
+
+function __awaiter(thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+}
+
+class WooksWorkflow extends Workflow {
+    constructor(wooks) {
+        super([]);
+        this.wooks = wooks;
+    }
+    resolveStep(stepId) {
+        var _a, _b, _c;
+        try {
+            useWFContext();
+            const found = this.wooks.lookup('WF_STEP', '/' + stepId);
+            if ((_a = found === null || found === void 0 ? void 0 : found.handlers) === null || _a === void 0 ? void 0 : _a.length) {
+                return found.handlers[0]();
+            }
+        }
+        catch (e) {
+            const router = this.wooks.getRouter();
+            const found = router.lookup('WF_STEP', '/' + stepId);
+            if ((_c = (_b = found === null || found === void 0 ? void 0 : found.route) === null || _b === void 0 ? void 0 : _b.handlers) === null || _c === void 0 ? void 0 : _c.length) {
+                return found.route.handlers[0]();
+            }
+        }
+        throw new Error(`Step "${stepId}" not found.`);
+    }
+}
+
+const wfShortcuts = {
+    flow: 'WF_FLOW',
+    step: 'WF_STEP',
+};
+class WooksWf extends WooksAdapterBase {
+    constructor(opts, wooks) {
+        super(wooks, opts === null || opts === void 0 ? void 0 : opts.logger, opts === null || opts === void 0 ? void 0 : opts.router);
+        this.opts = opts;
+        this.logger = (opts === null || opts === void 0 ? void 0 : opts.logger) || this.getLogger('wooks-wf');
+        this.wf = new WooksWorkflow(this.wooks);
+    }
+    step(id, opts) {
+        const step = createStep(id, opts);
+        return this.on('WF_STEP', id, () => step);
+    }
+    flow(id, schema) {
+        this.wf.register(id, schema);
+        return this.on('WF_FLOW', id, () => id);
+    }
+    start(schemaId, inputContext, input) {
+        return this._start(schemaId, inputContext, undefined, input);
+    }
+    resume(schemaId, inputContext, indexes, input) {
+        return this._start(schemaId, inputContext, indexes, input);
+    }
+    _start(schemaId, inputContext, indexes, input) {
+        var _a, _b;
+        return __awaiter(this, void 0, void 0, function* () {
+            const resume = !!(indexes === null || indexes === void 0 ? void 0 : indexes.length);
+            const { restoreCtx, clearCtx } = (resume ? resumeWfContext : createWfContext)({
+                inputContext,
+                schemaId,
+                indexes,
+                input,
+            }, this.mergeEventOptions((_a = this.opts) === null || _a === void 0 ? void 0 : _a.eventOptions));
+            const { handlers: foundHandlers } = this.wooks.lookup('WF_FLOW', '/' + schemaId);
+            const handlers = foundHandlers ||
+                (((_b = this.opts) === null || _b === void 0 ? void 0 : _b.onNotFound) && [this.opts.onNotFound]) ||
+                null;
+            if (handlers && handlers.length) {
+                let result = {};
+                for (const handler of handlers) {
+                    restoreCtx();
+                    const schemaId = (yield handler());
+                    if (resume) {
+                        result = yield this.wf.resume(schemaId, { context: inputContext, indexes }, input);
+                        break;
+                    }
+                    else {
+                        result = yield this.wf.start(schemaId, inputContext, input);
+                        break;
+                    }
+                }
+                clearCtx();
+                return result;
+            }
+            clearCtx();
+            throw new Error('Unknown schemaId: ' + schemaId);
+        });
+    }
+    onError(e) {
+        var _a;
+        if ((_a = this.opts) === null || _a === void 0 ? void 0 : _a.onError) {
+            this.opts.onError(e);
+        }
+        else {
+            this.error(e.message);
+            process.exit(1);
+        }
+    }
+    error(e) {
+        if (typeof e === 'string') {
+            console.error('' + 'ERROR: ' + '' + e);
+        }
+        else {
+            console.error('' + 'ERROR: ' + '' + e.message);
+        }
+    }
+}
+/**
+ * Factory for WooksWf App
+ * @param opts TWooksWfOptions
+ * @param wooks Wooks | WooksAdapterBase
+ * @returns WooksWf
+ */
+function createWfApp(opts, wooks) {
+    return new WooksWf(opts, wooks);
+}
+
+function useWfState() {
+    const { store } = useWFContext();
+    const event = store('event');
+    return {
+        ctx: () => event.get('inputContext'),
+        input: () => event.get('input'),
+        schemaId: event.get('schemaId'),
+        indexes: () => event.get('indexes'),
+    };
+}
+
+export { WooksWf, createWfApp, createWfContext, resumeWfContext, useWFContext, useWfState, wfShortcuts };

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@wooksjs/event-wf",
+  "version": "0.3.7",
+  "description": "@wooksjs/event-wf",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wooksjs/wooksjs.git",
+    "directory": "packages/event-wf"
+  },
+  "keywords": [
+    "http",
+    "wooks",
+    "composables",
+    "framework",
+    "app",
+    "workflow",
+    "prostojs"
+  ],
+  "author": "Artem Maltsev",
+  "license": "MIT",
+  "peerDependencies": {
+    "wooks": "0.3.7",
+    "@wooksjs/event-core": "0.3.7"
+  },
+  "dependencies": {
+    "@prostojs/logger": "^0.3.6",
+    "@prostojs/wf": "^0.0.2"
+  },
+  "bugs": {
+    "url": "https://github.com/wooksjs/wooksjs/issues"
+  },
+  "homepage": "https://github.com/wooksjs/wooksjs/tree/main/packages/event-wf#readme"
+}