@logicflow/engine 0.0.9 → 0.0.10-beta.0

package/{cjs/constant/constant.js → lib/constant/index.js}

@@ -3,11 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ActionStatus = exports.FlowStatus = exports.EVENT_INSTANCE_ERROR = exports.EVENT_INSTANCE_INTERRUPTED = exports.EVENT_INSTANCE_COMPLETE = exports.BASE_START_NODE = void 0;
 // baseType
 exports.BASE_START_NODE = 'start';
-// event name
+// eventType
 exports.EVENT_INSTANCE_COMPLETE = 'instance:complete';
 exports.EVENT_INSTANCE_INTERRUPTED = 'instance:interrupted';
 exports.EVENT_INSTANCE_ERROR = 'instance:error';
-// flow status
+// flowStatus
 var FlowStatus;
 (function (FlowStatus) {
     FlowStatus["COMPLETED"] = "completed";
@@ -16,10 +16,11 @@ var FlowStatus;
     FlowStatus["PENDING"] = "pending";
     FlowStatus["ERROR"] = "error";
 })(FlowStatus = exports.FlowStatus || (exports.FlowStatus = {}));
-// action status
+// actionStatus
 var ActionStatus;
 (function (ActionStatus) {
     ActionStatus["SUCCESS"] = "success";
     ActionStatus["ERROR"] = "error";
     ActionStatus["INTERRUPTED"] = "interrupted";
 })(ActionStatus = exports.ActionStatus || (exports.ActionStatus = {}));
+//# sourceMappingURL=index.js.map

package/lib/constant/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/constant/index.ts"],"names":[],"mappings":";;;AAAA,WAAW;AACE,QAAA,eAAe,GAAG,OAAO,CAAA;AAEtC,YAAY;AACC,QAAA,uBAAuB,GAAG,mBAAmB,CAAA;AAC7C,QAAA,0BAA0B,GAAG,sBAAsB,CAAA;AACnD,QAAA,oBAAoB,GAAG,gBAAgB,CAAA;AAEpD,aAAa;AACb,IAAY,UAMX;AAND,WAAY,UAAU;IACpB,qCAAuB,CAAA;IACvB,yCAA2B,CAAA;IAC3B,iCAAmB,CAAA;IACnB,iCAAmB,CAAA;IACnB,6BAAe,CAAA;AACjB,CAAC,EANW,UAAU,GAAV,kBAAU,KAAV,kBAAU,QAMrB;AAED,eAAe;AACf,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,mCAAmB,CAAA;IACnB,+BAAe,CAAA;IACf,2CAA2B,CAAA;AAC7B,CAAC,EAJW,YAAY,GAAZ,oBAAY,KAAZ,oBAAY,QAIvB"}

package/lib/constant/logCode.d.ts

@@ -0,0 +1,12 @@
+export declare enum ErrorCode {
+    NONE_START_NODE = 1000,
+    NONE_NODE_ID = 1001,
+    NO_DOCUMENT_BODY = 2001
+}
+export declare enum WarningCode {
+    NONE_START_NODE_IN_DATA = 2000,
+    START_NODE_INCOMING = 2001,
+    EXPRESSION_EXEC_ERROR = 3000
+}
+export declare const getErrorMsg: (code: ErrorCode) => string;
+export declare const getWarningMsg: (code: WarningCode) => string;

package/{cjs/constant/LogCode.js → lib/constant/logCode.js}

@@ -1,5 +1,4 @@
 "use strict";
-var _a, _b;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getWarningMsg = exports.getErrorMsg = exports.WarningCode = exports.ErrorCode = void 0;
 var ErrorCode;
@@ -17,15 +16,19 @@ var WarningCode;
     // 表达式判断异常
     WarningCode[WarningCode["EXPRESSION_EXEC_ERROR"] = 3000] = "EXPRESSION_EXEC_ERROR";
 })(WarningCode = exports.WarningCode || (exports.WarningCode = {}));
-var errorMsgMapCn = (_a = {},
-    _a[ErrorCode.NONE_START_NODE] = '未找到入度为0的节点',
-    _a[ErrorCode.NONE_NODE_ID] = '流程数据中存在没有此节点',
-    _a[ErrorCode.NO_DOCUMENT_BODY] = '找不到document.body, 请在DOM加载完成后再执行',
-    _a);
-var warningMsgMapCn = (_b = {},
-    _b[WarningCode.NONE_START_NODE_IN_DATA] = '初始化数据中未找到入度为0的节点',
-    _b[WarningCode.START_NODE_INCOMING] = '开始节点不允许被连入',
-    _b[WarningCode.EXPRESSION_EXEC_ERROR] = '表达式执行异常',
-    _b);
-exports.getErrorMsg = function (code) { return "error[" + code + "]: " + errorMsgMapCn[code]; };
-exports.getWarningMsg = function (code) { return "warning[" + code + "]: " + warningMsgMapCn[code]; };
+// TODO: 感觉这块可以用个国际化插件，这样配置不同语言加文件就可以了。
+const errorMsgMapCn = {
+    [ErrorCode.NONE_START_NODE]: '未找到入度为0的节点',
+    [ErrorCode.NONE_NODE_ID]: '流程数据中存在没有此节点',
+    [ErrorCode.NO_DOCUMENT_BODY]: '找不到document.body, 请在DOM加载完成后再执行',
+};
+const warningMsgMapCn = {
+    [WarningCode.NONE_START_NODE_IN_DATA]: '初始化数据中未找到入度为0的节点',
+    [WarningCode.START_NODE_INCOMING]: '开始节点不允许被连入',
+    [WarningCode.EXPRESSION_EXEC_ERROR]: '表达式执行异常',
+};
+const getErrorMsg = (code) => `error[${code}]: ${errorMsgMapCn[code]}`;
+exports.getErrorMsg = getErrorMsg;
+const getWarningMsg = (code) => `warning[${code}]: ${warningMsgMapCn[code]}`;
+exports.getWarningMsg = getWarningMsg;
+//# sourceMappingURL=logCode.js.map

package/lib/constant/logCode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logCode.js","sourceRoot":"","sources":["../../src/constant/logCode.ts"],"names":[],"mappings":";;;AAAA,IAAY,SAOX;AAPD,WAAY,SAAS;IACnB,SAAS;IACT,kEAAsB,CAAA;IACtB,4DAAmB,CAAA;IAEnB,QAAQ;IACR,oEAAuB,CAAA;AACzB,CAAC,EAPW,SAAS,GAAT,iBAAS,KAAT,iBAAS,QAOpB;AAED,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,sFAA8B,CAAA;IAC9B,8EAA0B,CAAA;IAE1B,UAAU;IACV,kFAA4B,CAAA;AAC9B,CAAC,EANW,WAAW,GAAX,mBAAW,KAAX,mBAAW,QAMtB;AAED,uCAAuC;AACvC,MAAM,aAAa,GAAG;IACpB,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,YAAY;IACzC,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,cAAc;IACxC,CAAC,SAAS,CAAC,gBAAgB,CAAC,EAAE,iCAAiC;CAChE,CAAA;AAED,MAAM,eAAe,GAAG;IACtB,CAAC,WAAW,CAAC,uBAAuB,CAAC,EAAE,kBAAkB;IACzD,CAAC,WAAW,CAAC,mBAAmB,CAAC,EAAE,YAAY;IAC/C,CAAC,WAAW,CAAC,qBAAqB,CAAC,EAAE,SAAS;CAC/C,CAAA;AAEM,MAAM,WAAW,GAAG,CAAC,IAAe,EAAE,EAAE,CAC7C,SAAS,IAAI,MAAM,aAAa,CAAC,IAAI,CAAC,EAAE,CAAA;AAD7B,QAAA,WAAW,eACkB;AACnC,MAAM,aAAa,GAAG,CAAC,IAAiB,EAAE,EAAE,CACjD,WAAW,IAAI,MAAM,eAAe,CAAC,IAAI,CAAC,EAAE,CAAA;AADjC,QAAA,aAAa,iBACoB"}

package/lib/expression/brewserVm.d.ts

@@ -0,0 +1,2 @@
+declare const runInBrowserContext: (code: string, globalData?: {}) => Promise<null>;
+export { runInBrowserContext };

package/lib/expression/brewserVm.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInBrowserContext = void 0;
+const tslib_1 = require("tslib");
+const logCode_1 = require("../constant/logCode");
+const runInBrowserContext = (code, globalData = {}) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    const iframe = document.createElement('iframe');
+    iframe.style.display = 'none';
+    if (!document || !document.body) {
+        console.error((0, logCode_1.getErrorMsg)(logCode_1.ErrorCode.NO_DOCUMENT_BODY));
+    }
+    document.body.appendChild(iframe);
+    const iframeWindow = iframe.contentWindow;
+    const iframeEval = iframeWindow.eval;
+    Object.keys(globalData).forEach((key) => {
+        iframeWindow[key] = globalData[key];
+    });
+    let res = null;
+    try {
+        res = iframeEval.call(iframeWindow, code);
+    }
+    catch (e) {
+        console.warn((0, logCode_1.getWarningMsg)(logCode_1.WarningCode.EXPRESSION_EXEC_ERROR), {
+            code,
+            globalData,
+            e,
+        });
+    }
+    document.body.removeChild(iframe);
+    return res;
+});
+exports.runInBrowserContext = runInBrowserContext;
+//# sourceMappingURL=brewserVm.js.map

package/lib/expression/brewserVm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brewserVm.js","sourceRoot":"","sources":["../../src/expression/brewserVm.ts"],"names":[],"mappings":";;;;AAAA,iDAK4B;AAE5B,MAAM,mBAAmB,GAAG,CAAO,IAAY,EAAE,UAAU,GAAG,EAAE,EAAE,EAAE;IAClE,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;IAC/C,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAA;IAC7B,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;QAC/B,OAAO,CAAC,KAAK,CAAC,IAAA,qBAAW,EAAC,mBAAS,CAAC,gBAAgB,CAAC,CAAC,CAAA;KACvD;IACD,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;IAEjC,MAAM,YAAY,GAAG,MAAM,CAAC,aAAoB,CAAA;IAChD,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,CAAA;IACpC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,GAAW,EAAE,EAAE;QAC9C,YAAY,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAA;IACrC,CAAC,CAAC,CAAA;IAEF,IAAI,GAAG,GAAG,IAAI,CAAA;IACd,IAAI;QACF,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAA;KAC1C;IAAC,OAAO,CAAC,EAAE;QACV,OAAO,CAAC,IAAI,CAAC,IAAA,uBAAa,EAAC,qBAAW,CAAC,qBAAqB,CAAC,EAAE;YAC7D,IAAI;YACJ,UAAU;YACV,CAAC;SACF,CAAC,CAAA;KACH;IACD,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;IACjC,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA,CAAA;AAEQ,kDAAmB"}

package/lib/expression/index.d.ts

@@ -0,0 +1,2 @@
+declare const getExpressionResult: (code: string, context: any) => Promise<any>;
+export { getExpressionResult };

package/lib/expression/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getExpressionResult = void 0;
+const tslib_1 = require("tslib");
+const nodeVm_1 = require("./nodeVm");
+const brewserVm_1 = require("./brewserVm");
+const utils_1 = require("../utils");
+const getExpressionResult = (code, context) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    if (utils_1.isInNodeJS) {
+        const r = yield (0, nodeVm_1.runInNodeContext)(code, context);
+        return r;
+    }
+    if (utils_1.isInBrowser) {
+        const r = yield (0, brewserVm_1.runInBrowserContext)(code, context);
+        return r;
+    }
+    return utils_1.globalScope.eval(code);
+});
+exports.getExpressionResult = getExpressionResult;
+//# sourceMappingURL=index.js.map

package/lib/expression/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/expression/index.ts"],"names":[],"mappings":";;;;AAAA,qCAA2C;AAC3C,2CAAiD;AACjD,oCAA+D;AAE/D,MAAM,mBAAmB,GAAG,CAAO,IAAY,EAAE,OAAY,EAAE,EAAE;IAC/D,IAAI,kBAAU,EAAE;QACd,MAAM,CAAC,GAAG,MAAM,IAAA,yBAAgB,EAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QAC/C,OAAO,CAAC,CAAA;KACT;IACD,IAAI,mBAAW,EAAE;QACf,MAAM,CAAC,GAAG,MAAM,IAAA,+BAAmB,EAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QAClD,OAAO,CAAC,CAAA;KACT;IACD,OAAO,mBAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC/B,CAAC,CAAA,CAAA;AAEQ,kDAAmB"}

package/lib/expression/nodeVm.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="node" />
+import vm from 'node:vm';
+declare const runInNodeContext: (code: string, globalData?: Record<string, unknown>) => Promise<vm.Context>;
+export { runInNodeContext };

package/lib/expression/nodeVm.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInNodeContext = void 0;
+const tslib_1 = require("tslib");
+const node_vm_1 = tslib_1.__importDefault(require("node:vm"));
+// const vm = require('node:vm');
+const runInNodeContext = (code, globalData = {}) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    const context = node_vm_1.default.createContext(globalData);
+    node_vm_1.default.runInContext(code, context);
+    return context;
+});
+exports.runInNodeContext = runInNodeContext;
+//# sourceMappingURL=nodeVm.js.map

package/lib/expression/nodeVm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeVm.js","sourceRoot":"","sources":["../../src/expression/nodeVm.ts"],"names":[],"mappings":";;;;AAAA,8DAAwB;AACxB,iCAAiC;AAEjC,MAAM,gBAAgB,GAAG,CACvB,IAAY,EACZ,aAAsC,EAAE,EACxC,EAAE;IACF,MAAM,OAAO,GAAG,iBAAE,CAAC,aAAa,CAAC,UAAU,CAAC,CAAA;IAC5C,iBAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAE9B,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA,CAAA;AAEQ,4CAAgB"}

package/lib/index.d.ts

@@ -0,0 +1,157 @@
+import { BaseNode, StartNode, TaskNode } from './nodes';
+import { FlowModel } from './FlowModel';
+import { Recorder } from './recorder';
+export declare class Engine {
+    readonly instanceId: string;
+    graphData?: Engine.GraphConfigData;
+    flowModel?: FlowModel;
+    recorder?: Recorder;
+    context?: Record<string, unknown>;
+    nodeModelMap: Map<string, BaseNode.NodeConstructor>;
+    constructor(options?: Engine.Options);
+    /**
+     * 注册节点
+     * @param nodeConfig { type: 'custom-node', model: NodeClass }
+     */
+    register(nodeConfig: Engine.NodeConfig): void;
+    /**
+     * 自定义执行记录的存储，默认浏览器使用 sessionStorage, nodejs 使用内存存储
+     * 注意：由于执行记录不全会主动删除，所以需要自行清理。
+     * nodejs 环境建议自定义为持久化存储。
+     * engine.setCustomRecorder({{
+     *   async addActionRecord(task) {}
+     *   async getTask(actionId) {}
+     *   async getExecutionTasks(executionId) {}
+     *   clear(instanceId) {}
+     * }}
+     * @param recorder
+     */
+    setCustomRecorder(recorder: Recorder): void;
+    /**
+     * 加载流程图数据
+     */
+    load({ graphData, startNodeType, globalData, }: Engine.LoadGraphParam): FlowModel;
+    /**
+     * 执行流程，允许多次调用
+     */
+    execute(param?: Partial<Engine.ActionParam>): Promise<Engine.NextActionParam>;
+    /**
+     * 中断流程恢复
+     * @param resumeParam
+     * @returns
+     */
+    resume(resumeParam: Engine.ResumeParam): Promise<Engine.NextActionParam | undefined>;
+    getExecutionList(): Promise<any>;
+    /**
+     * 获取执行任务记录
+     * @param executionId
+     * @returns
+     */
+    getExecutionRecord(executionId: Engine.Key): Promise<Recorder.Info[] | null>;
+    destroy(): void;
+    getGlobalData(): Record<string, unknown> | undefined;
+    setGlobalData(data: Record<string, unknown>): void;
+    updateGlobalData(data: Record<string, unknown>): void;
+}
+export declare namespace Engine {
+    type Point = {
+        id?: string;
+        x: number;
+        y: number;
+        [key: string]: unknown;
+    };
+    type TextConfig = {
+        value: string;
+    } & Point;
+    type NodeData = {
+        id: string;
+        type: string;
+        x?: number;
+        y?: number;
+        text?: TextConfig | string;
+        zIndex?: number;
+        properties?: Record<string, unknown>;
+    };
+    type EdgeData = {
+        id: string;
+        /**
+         * 边的类型，不传默认为lf.setDefaultEdgeType(type)传入的类型。
+         * LogicFlow内部默认为polyline
+         */
+        type?: string;
+        sourceNodeId: string;
+        sourceAnchorId?: string;
+        targetNodeId: string;
+        targetAnchorId?: string;
+        startPoint?: {
+            x: number;
+            y: number;
+        };
+        endPoint?: {
+            x: number;
+            y: number;
+        };
+        text?: {
+            x: number;
+            y: number;
+            value: string;
+        } | string;
+        pointsList?: Point[];
+        zIndex?: number;
+        properties?: Record<string, unknown>;
+    };
+    type GraphConfigData = {
+        nodes: NodeData[];
+        edges: EdgeData[];
+    };
+    type LoadGraphParam = {
+        graphData: GraphConfigData;
+        startNodeType?: string;
+        globalData?: Record<string, unknown>;
+    };
+    type Options = {
+        context?: Record<string, unknown>;
+        debug?: boolean;
+    };
+    type Key = string | number;
+    type NodeConfig = {
+        type: string;
+        model: any;
+    };
+    type NodeParam = {
+        executionId: Key;
+        nodeId: Key;
+    };
+    type CommonActionInfo = {
+        actionId: Key;
+    } & NodeParam;
+    type ActionParam = CommonActionInfo;
+    type ResumeParam = {
+        data?: Record<string, unknown>;
+    } & CommonActionInfo;
+    type ExecParam = {
+        next: (data: NextActionParam) => void;
+    } & ActionParam;
+    type ExecResumeParam = {
+        next: (data: NextActionParam) => void;
+    } & ResumeParam;
+    type ActionStatus = 'success' | 'error' | 'interrupted' | '';
+    type NextActionParam = {
+        executionId: Key;
+        nodeId: Key;
+        actionId: Key;
+        nodeType: string;
+        outgoing: BaseNode.OutgoingConfig[];
+        properties?: Record<string, unknown>;
+        detail?: Record<string, unknown>;
+        status?: ActionStatus;
+    };
+    type ActionResult = NextActionParam;
+    type NodeExecResult = {
+        nodeType: string;
+        properties?: Record<string, unknown>;
+    } & CommonActionInfo & ActionResult;
+}
+export * from './constant';
+export { BaseNode, StartNode, TaskNode, Recorder };
+export default Engine;

package/lib/index.js

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Recorder = exports.TaskNode = exports.StartNode = exports.BaseNode = exports.Engine = void 0;
+const tslib_1 = require("tslib");
+// import { LogicFlow } from '@logicflow/core';
+const nodes_1 = require("./nodes");
+Object.defineProperty(exports, "BaseNode", { enumerable: true, get: function () { return nodes_1.BaseNode; } });
+Object.defineProperty(exports, "StartNode", { enumerable: true, get: function () { return nodes_1.StartNode; } });
+Object.defineProperty(exports, "TaskNode", { enumerable: true, get: function () { return nodes_1.TaskNode; } });
+const FlowModel_1 = require("./FlowModel");
+const recorder_1 = require("./recorder");
+Object.defineProperty(exports, "Recorder", { enumerable: true, get: function () { return recorder_1.Recorder; } });
+const utils_1 = require("./utils");
+class Engine {
+    constructor(options) {
+        this.nodeModelMap = new Map();
+        this.instanceId = (0, utils_1.createEngineId)();
+        if (options === null || options === void 0 ? void 0 : options.debug) {
+            this.recorder = new recorder_1.Recorder({
+                instanceId: this.instanceId,
+            });
+        }
+        // 默认注册节点 register default nodes
+        this.register({
+            type: nodes_1.StartNode.nodeTypeName,
+            model: nodes_1.StartNode,
+        });
+        this.register({
+            type: nodes_1.TaskNode.nodeTypeName,
+            model: nodes_1.TaskNode,
+        });
+        this.context = (options === null || options === void 0 ? void 0 : options.context) || {};
+    }
+    /**
+     * 注册节点
+     * @param nodeConfig { type: 'custom-node', model: NodeClass }
+     */
+    register(nodeConfig) {
+        this.nodeModelMap.set(nodeConfig.type, nodeConfig.model);
+    }
+    /**
+     * 自定义执行记录的存储，默认浏览器使用 sessionStorage, nodejs 使用内存存储
+     * 注意：由于执行记录不全会主动删除，所以需要自行清理。
+     * nodejs 环境建议自定义为持久化存储。
+     * engine.setCustomRecorder({{
+     *   async addActionRecord(task) {}
+     *   async getTask(actionId) {}
+     *   async getExecutionTasks(executionId) {}
+     *   clear(instanceId) {}
+     * }}
+     * @param recorder
+     */
+    setCustomRecorder(recorder) {
+        this.recorder = recorder;
+    }
+    /**
+     * 加载流程图数据
+     */
+    load({ graphData, startNodeType = 'StartNode', globalData = {}, }) {
+        this.graphData = graphData;
+        const flowModel = new FlowModel_1.FlowModel({
+            nodeModelMap: this.nodeModelMap,
+            recorder: this.recorder,
+            context: this.context,
+            globalData,
+            startNodeType,
+        });
+        flowModel.load(graphData);
+        this.flowModel = flowModel;
+        return flowModel;
+    }
+    /**
+     * 执行流程，允许多次调用
+     */
+    execute(param) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => {
+                var _a;
+                let execParam = param;
+                if (!param) {
+                    execParam = {};
+                }
+                (_a = this.flowModel) === null || _a === void 0 ? void 0 : _a.execute(Object.assign(Object.assign({}, execParam), { callback: (result) => {
+                        resolve(result);
+                    }, onError: (error) => {
+                        reject(error);
+                    } }));
+            });
+        });
+    }
+    /**
+     * 中断流程恢复
+     * @param resumeParam
+     * @returns
+     */
+    resume(resumeParam) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => {
+                var _a;
+                (_a = this.flowModel) === null || _a === void 0 ? void 0 : _a.resume(Object.assign(Object.assign({}, resumeParam), { callback: (result) => {
+                        resolve(result);
+                    }, onError: (error) => {
+                        reject(error);
+                    } }));
+            });
+        });
+    }
+    getExecutionList() {
+        var _a;
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return yield ((_a = this.recorder) === null || _a === void 0 ? void 0 : _a.getExecutionList());
+        });
+    }
+    /**
+     * 获取执行任务记录
+     * @param executionId
+     * @returns
+     */
+    getExecutionRecord(executionId) {
+        var _a, _b;
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const actions = yield ((_a = this.recorder) === null || _a === void 0 ? void 0 : _a.getExecutionActions(executionId));
+            if (!actions) {
+                return null;
+            }
+            // DONE: 确认 records 的类型
+            const records = [];
+            for (let i = 0; i < (actions === null || actions === void 0 ? void 0 : actions.length); i++) {
+                const action = actions[i];
+                if (this.recorder) {
+                    records.push((_b = this.recorder) === null || _b === void 0 ? void 0 : _b.getActionRecord(action));
+                }
+            }
+            return Promise.all(records);
+        });
+    }
+    destroy() {
+        var _a;
+        (_a = this.recorder) === null || _a === void 0 ? void 0 : _a.clear();
+    }
+    getGlobalData() {
+        var _a;
+        return (_a = this.flowModel) === null || _a === void 0 ? void 0 : _a.globalData;
+    }
+    setGlobalData(data) {
+        if (this.flowModel) {
+            this.flowModel.globalData = data;
+        }
+    }
+    updateGlobalData(data) {
+        if (this.flowModel) {
+            Object.assign(this.flowModel.globalData, data);
+        }
+    }
+}
+exports.Engine = Engine;
+tslib_1.__exportStar(require("./constant"), exports);
+exports.default = Engine;
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;AAAA,+CAA+C;AAC/C,mCAAuD;AAwS9C,yFAxSA,gBAAQ,OAwSA;AAAE,0FAxSA,iBAAS,OAwSA;AAAE,yFAxSA,gBAAQ,OAwSA;AAvStC,2CAAuC;AACvC,yCAAqC;AAsSG,yFAtS/B,mBAAQ,OAsS+B;AArShD,mCAAwC;AAExC,MAAa,MAAM;IASjB,YAAY,OAAwB;QAClC,IAAI,CAAC,YAAY,GAAG,IAAI,GAAG,EAAE,CAAA;QAC7B,IAAI,CAAC,UAAU,GAAG,IAAA,sBAAc,GAAE,CAAA;QAClC,IAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,KAAK,EAAE;YAClB,IAAI,CAAC,QAAQ,GAAG,IAAI,mBAAQ,CAAC;gBAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;aAC5B,CAAC,CAAA;SACH;QACD,gCAAgC;QAChC,IAAI,CAAC,QAAQ,CAAC;YACZ,IAAI,EAAE,iBAAS,CAAC,YAAY;YAC5B,KAAK,EAAE,iBAAS;SACjB,CAAC,CAAA;QACF,IAAI,CAAC,QAAQ,CAAC;YACZ,IAAI,EAAE,gBAAQ,CAAC,YAAY;YAC3B,KAAK,EAAE,gBAAQ;SAChB,CAAC,CAAA;QACF,IAAI,CAAC,OAAO,GAAG,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,KAAI,EAAE,CAAA;IACvC,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,UAA6B;QACpC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,CAAA;IAC1D,CAAC;IAED;;;;;;;;;;;OAWG;IACH,iBAAiB,CAAC,QAAkB;QAClC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAC1B,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,EACH,SAAS,EACT,aAAa,GAAG,WAAW,EAC3B,UAAU,GAAG,EAAE,GACO;QACtB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,MAAM,SAAS,GAAG,IAAI,qBAAS,CAAC;YAC9B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU;YACV,aAAa;SACd,CAAC,CAAA;QAEF,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,OAAO,SAAS,CAAA;IAClB,CAAC;IAED;;OAEG;IACG,OAAO,CACX,KAAmC;;YAEnC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;;gBACrC,IAAI,SAAS,GAAG,KAAK,CAAA;gBACrB,IAAI,CAAC,KAAK,EAAE;oBACV,SAAS,GAAG,EAAE,CAAA;iBACf;gBAED,MAAA,IAAI,CAAC,SAAS,0CAAE,OAAO,iCAClB,SAAS,KACZ,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;wBACnB,OAAO,CAAC,MAAM,CAAC,CAAA;oBACjB,CAAC,EACD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;wBACjB,MAAM,CAAC,KAAK,CAAC,CAAA;oBACf,CAAC,IACD,CAAA;YACJ,CAAC,CAAC,CAAA;QACJ,CAAC;KAAA;IAED;;;;OAIG;IACG,MAAM,CACV,WAA+B;;YAE/B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;;gBACrC,MAAA,IAAI,CAAC,SAAS,0CAAE,MAAM,iCACjB,WAAW,KACd,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;wBACnB,OAAO,CAAC,MAAM,CAAC,CAAA;oBACjB,CAAC,EACD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;wBACjB,MAAM,CAAC,KAAK,CAAC,CAAA;oBACf,CAAC,IACD,CAAA;YACJ,CAAC,CAAC,CAAA;QACJ,CAAC;KAAA;IAEK,gBAAgB;;;YACpB,OAAO,MAAM,CAAA,MAAA,IAAI,CAAC,QAAQ,0CAAE,gBAAgB,EAAE,CAAA,CAAA;;KAC/C;IAED;;;;OAIG;IACG,kBAAkB,CACtB,WAAuB;;;YAEvB,MAAM,OAAO,GAAG,MAAM,CAAA,MAAA,IAAI,CAAC,QAAQ,0CAAE,mBAAmB,CAAC,WAAW,CAAC,CAAA,CAAA;YAErE,IAAI,CAAC,OAAO,EAAE;gBACZ,OAAO,IAAI,CAAA;aACZ;YAED,uBAAuB;YACvB,MAAM,OAAO,GAA6B,EAAE,CAAA;YAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAG,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM,CAAA,EAAE,CAAC,EAAE,EAAE;gBACxC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;gBACzB,IAAI,IAAI,CAAC,QAAQ,EAAE;oBACjB,OAAO,CAAC,IAAI,CAAC,MAAA,IAAI,CAAC,QAAQ,0CAAE,eAAe,CAAC,MAAM,CAAC,CAAC,CAAA;iBACrD;aACF;YAED,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;;KAC5B;IAED,OAAO;;QACL,MAAA,IAAI,CAAC,QAAQ,0CAAE,KAAK,EAAE,CAAA;IACxB,CAAC;IAED,aAAa;;QACX,OAAO,MAAA,IAAI,CAAC,SAAS,0CAAE,UAAU,CAAA;IACnC,CAAC;IAED,aAAa,CAAC,IAA6B;QACzC,IAAI,IAAI,CAAC,SAAS,EAAE;YAClB,IAAI,CAAC,SAAS,CAAC,UAAU,GAAG,IAAI,CAAA;SACjC;IACH,CAAC;IAED,gBAAgB,CAAC,IAA6B;QAC5C,IAAI,IAAI,CAAC,SAAS,EAAE;YAClB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;SAC/C;IACH,CAAC;CACF;AAzKD,wBAyKC;AAyHD,qDAA0B;AAG1B,kBAAe,MAAM,CAAA"}

package/lib/nodes/base.d.ts

@@ -0,0 +1,108 @@
+import { Engine } from '..';
+import { ActionStatus } from '../constant';
+export interface IBaseNodeProps {
+    nodeConfig: BaseNode.NodeConfig;
+    context: Record<string, any>;
+    globalData: Record<string, unknown>;
+}
+export declare class BaseNode implements BaseNode.Base {
+    readonly baseType: string;
+    static nodeTypeName: string;
+    /**
+     * 节点的入边
+     */
+    incoming: BaseNode.IncomingConfig[];
+    /**
+     * 节点的出边
+     */
+    outgoing: BaseNode.OutgoingConfig[];
+    /**
+     * 节点的属性
+     */
+    properties?: Record<string, unknown>;
+    nodeId: Engine.Key;
+    type: string;
+    /**
+     * 节点的上下文，是调用流程时传入的上下文
+     */
+    context: Record<string, any>;
+    /**
+     * 节点的全局数据，是调用流程时传入的全局数据
+     * 在计算表达式时，即基于全局数据进行计算
+     */
+    globalData: Record<string, unknown>;
+    constructor({ nodeConfig, context, globalData }: IBaseNodeProps);
+    /**
+     * 节点的执行逻辑
+     * @overridable 可以自定义节点重写此方法
+     * @param param.executionId 流程执行记录 ID
+     * @param param.actionId 此节点执行记录 ID
+     * @param param.nodeId 节点 ID
+     * @return 返回下一步的执行参数
+     * 当不返回时，表示此节点执行成功，流程会继续执行下一步。
+     * 当返回时，返回格式为
+     */
+    action(param?: Engine.ActionParam): Promise<BaseNode.ActionResult | undefined>;
+    /**
+     * 节点重新恢复执行的逻辑
+     * @overridable 可以自定义节点重写此方法
+     * @param params.executionId 流程执行记录 ID
+     * @param params.actionId 此节点执行记录 ID
+     * @param params.nodeId 节点 ID
+     */
+    onResume(params: Engine.ResumeParam): Promise<void>;
+    /**
+     * 判断该节点是否满足条件
+     */
+    private isPass;
+    /**
+     * 获取当前节点执行的下一个节点
+     */
+    private getOutgoing;
+    /**
+     * 节点的每一次执行都会生成一个唯一的 actionId
+     */
+    execute(params: Engine.ExecParam): Promise<Engine.NextActionParam>;
+    resume(params: Engine.ExecResumeParam): Promise<undefined>;
+}
+export declare namespace BaseNode {
+    interface Base {
+        incoming: IncomingConfig[];
+        outgoing: OutgoingConfig[];
+        properties?: Record<string, unknown>;
+        nodeId: Engine.Key;
+        type: string;
+        readonly baseType: string;
+        execute(actionParam: Engine.ActionParam): Promise<Engine.NextActionParam>;
+    }
+    type IncomingConfig = {
+        id: Engine.Key;
+        source: string;
+        properties?: Record<string, unknown>;
+    };
+    type OutgoingConfig = {
+        id: Engine.Key;
+        target: string;
+        properties?: Record<string, unknown>;
+        result?: string | boolean;
+    };
+    type NodeConfig = {
+        id: Engine.Key;
+        type: string;
+        properties?: Record<string, unknown>;
+        incoming: IncomingConfig[];
+        outgoing: OutgoingConfig[];
+    };
+    type NodeConstructor = {
+        new (config: {
+            nodeConfig: NodeConfig;
+            context: Record<string, any>;
+            globalData: Record<string, unknown>;
+        }): BaseNode;
+    };
+    type ActionResult = {
+        status: ActionStatus;
+        detail?: Record<string, unknown>;
+    };
+}
+export default BaseNode;