@mldong/jeeflow 1.0.0

package/dist/model.js

@@ -0,0 +1,170 @@
+// ─── LogicFlow JSON Types ─────────────────────────────────────────────────────
+// ─── Node Type Constants ──────────────────────────────────────────────────────
+export const TypeStart = 'snaker:start';
+export const TypeEnd = 'snaker:end';
+export const TypeTask = 'snaker:task';
+export const TypeDecision = 'snaker:decision';
+export const TypeFork = 'snaker:fork';
+export const TypeJoin = 'snaker:join';
+export const TypeCustom = 'snaker:custom';
+export var InstanceState;
+(function (InstanceState) {
+    InstanceState[InstanceState["Doing"] = 10] = "Doing";
+    InstanceState[InstanceState["Done"] = 20] = "Done";
+    InstanceState[InstanceState["Reject"] = 45] = "Reject";
+})(InstanceState || (InstanceState = {}));
+export var TaskState;
+(function (TaskState) {
+    TaskState[TaskState["Doing"] = 10] = "Doing";
+    TaskState[TaskState["Done"] = 20] = "Done";
+    TaskState[TaskState["Abandoned"] = 99] = "Abandoned";
+})(TaskState || (TaskState = {}));
+export const BusinessNoKey = 'BUSINESS_NO';
+// ─── 聚合根：ProcessInstance ───────────────────────────────────────────────────
+export class ProcessInstance {
+    id;
+    parentId;
+    defineId;
+    state;
+    parentNodeName;
+    businessNo;
+    operator;
+    expireTime;
+    variables;
+    tasks;
+    createTime;
+    createUser;
+    updateTime;
+    updateUser;
+    constructor(data) {
+        Object.assign(this, data);
+    }
+    /** 工厂——创建流程实例 */
+    static create(id, defineId, operator, vars, now) {
+        return new ProcessInstance({
+            id, defineId, state: InstanceState.Doing,
+            operator, variables: vars,
+            parentNodeName: '', businessNo: vars[BusinessNoKey] ?? '',
+            createTime: now, updateTime: now, createUser: operator, updateUser: operator,
+            tasks: [],
+        });
+    }
+    /** 完成任务（子实体状态转换 + 实例变量合并） */
+    completeTask(task, operator, vars, now) {
+        task.finish(operator, vars, now);
+        this.variables = vars;
+        this.updateTime = now;
+        this.updateUser = operator;
+    }
+    /** 废弃单个任务 */
+    abandonTask(task, now) {
+        task.abandon(now);
+        this.updateTime = now;
+    }
+    /** 废弃所有进行中任务，返回被废弃列表（供调用方持久化） */
+    abandonAllDoing(now) {
+        const abandoned = [];
+        for (const t of this.tasks) {
+            if (t.isDoing()) {
+                t.abandon(now);
+                abandoned.push(t);
+            }
+        }
+        this.updateTime = now;
+        return abandoned;
+    }
+    /** 流程完成 */
+    finish(now) {
+        this.state = InstanceState.Done;
+        this.updateTime = now;
+    }
+    /** 驳回流程 */
+    reject(now) {
+        this.state = InstanceState.Reject;
+        this.updateTime = now;
+    }
+    /** 追加变量 */
+    addVariable(vars) {
+        Object.assign(this.variables, vars);
+    }
+    /** 获取进行中任务 */
+    getDoingTasks() {
+        return this.tasks.filter(t => t.isDoing());
+    }
+    /** 获取已完成任务 */
+    getDoneTasks() {
+        return this.tasks.filter(t => t.isFinished());
+    }
+    /** 所有任务是否都已完成（join 合并判断） */
+    isAllTasksFinished() {
+        return !this.tasks.some(t => t.isDoing());
+    }
+    /** 创建任务（子实体工厂） */
+    createTask(id, taskName, displayName, actor, operator, formKey, now) {
+        const task = new ProcessTask({
+            id, processInstanceId: this.id,
+            taskName, displayName, taskState: TaskState.Doing,
+            actorId: '', actorIds: [actor],
+            taskType: 0, performType: 0, formKey,
+            variables: {},
+            createTime: now, updateTime: now, createUser: operator, updateUser: operator,
+        });
+        this.tasks.push(task);
+        return task;
+    }
+}
+// ─── 子实体：ProcessTask ────────────────────────────────────────────────────────
+export class ProcessTask {
+    id;
+    processInstanceId;
+    taskName;
+    displayName;
+    taskType;
+    performType;
+    taskState;
+    actorId;
+    actorIds;
+    finishTime;
+    expireTime;
+    formKey;
+    parentTaskId;
+    variables;
+    createTime;
+    createUser;
+    updateTime;
+    updateUser;
+    constructor(data) {
+        Object.assign(this, data);
+    }
+    /** 完成任务 */
+    finish(operator, vars, now) {
+        this.taskState = TaskState.Done;
+        this.actorId = operator;
+        this.finishTime = now;
+        this.updateTime = now;
+        this.updateUser = operator;
+        this.variables = vars;
+    }
+    /** 废弃任务 */
+    abandon(now) {
+        this.taskState = TaskState.Abandoned;
+        this.updateTime = now;
+    }
+    /** 是否进行中 */
+    isDoing() { return this.taskState === TaskState.Doing; }
+    /** 是否已完成 */
+    isFinished() { return this.taskState === TaskState.Done; }
+    /** 操作人是否有权限处理 */
+    isAllowed(operator) {
+        return this.actorIds.includes(operator);
+    }
+}
+// ─── Clone Helpers（保留 class 原型）────────────────────────────────────────────
+export function cloneInstance(inst) {
+    return Object.assign(Object.create(ProcessInstance.prototype), inst, {
+        tasks: inst.tasks.map(cloneTask),
+    });
+}
+export function cloneTask(task) {
+    return Object.assign(Object.create(ProcessTask.prototype), task);
+}

package/dist/registry.d.ts

@@ -0,0 +1,18 @@
+import type { FlowNode, ProcessInstance } from './model.js';
+/** 参与者指派处理器接口——对标 Java AssignmentHandler */
+export interface IAssignmentHandler {
+    assign(node: FlowNode, inst: ProcessInstance): string[] | Promise<string[]>;
+}
+/** 决策处理器接口——对标 Java DecisionHandler */
+export interface IDecisionHandler {
+    decide(node: FlowNode, inst: ProcessInstance, vars: Record<string, any>): string | Promise<string>;
+}
+/** 处理器注册表——按名称注册/解析（对标 Spring IoC） */
+export declare class HandlerRegistry {
+    private assignments;
+    private decisions;
+    registerAssignment(name: string, handler: IAssignmentHandler): void;
+    registerDecision(name: string, handler: IDecisionHandler): void;
+    resolveAssignment(name: string): IAssignmentHandler | undefined;
+    resolveDecision(name: string): IDecisionHandler | undefined;
+}

package/dist/registry.js

@@ -0,0 +1,17 @@
+/** 处理器注册表——按名称注册/解析（对标 Spring IoC） */
+export class HandlerRegistry {
+    assignments = new Map();
+    decisions = new Map();
+    registerAssignment(name, handler) {
+        this.assignments.set(name, handler);
+    }
+    registerDecision(name, handler) {
+        this.decisions.set(name, handler);
+    }
+    resolveAssignment(name) {
+        return this.assignments.get(name);
+    }
+    resolveDecision(name) {
+        return this.decisions.get(name);
+    }
+}

package/dist/spi.d.ts

@@ -0,0 +1,27 @@
+import type { ProcessDefine, ProcessInstance, ProcessTask, UserInfo } from './model.js';
+export interface ProcessRepository {
+    findDefineById(id: number): Promise<ProcessDefine | null>;
+    findInstanceById(id: number): Promise<ProcessInstance | null>;
+    saveInstance(inst: ProcessInstance): Promise<void>;
+    updateInstance(inst: ProcessInstance): Promise<void>;
+    findTaskById(taskId: number): Promise<ProcessTask | null>;
+    saveTask(task: ProcessTask): Promise<void>;
+    updateTask(task: ProcessTask): Promise<void>;
+    findDoingTasks(instanceId: number, taskNames?: string[]): Promise<ProcessTask[]>;
+    findDoneTasks(instanceId: number, taskNames?: string[]): Promise<ProcessTask[]>;
+    findHistoryTasks(instanceId: number): Promise<ProcessTask[]>;
+    findTaskActors(taskId: number): Promise<string[]>;
+    addTaskActor(taskId: number, actors: string[]): Promise<void>;
+    removeTaskActor(taskId: number, actors: string[]): Promise<void>;
+    createCcInstance(instanceId: number, creator: string, ...actorIds: string[]): Promise<void>;
+    updateCcStatus(instanceId: number, actorId: string): Promise<void>;
+}
+export interface UserProvider {
+    getUser(userId: string): Promise<UserInfo | null>;
+}
+export interface IDGenerator {
+    nextId(): number;
+}
+export interface ExpressionEvaluator {
+    eval(expr: string, vars: Record<string, any>): Promise<any>;
+}

package/dist/spi.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@mldong/jeeflow",
+  "version": "1.0.0",
+  "description": "jeeflow workflow engine — Node.js / TypeScript implementation",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./engine": "./dist/engine.js",
+    "./model": "./dist/model.js",
+    "./spi": "./dist/spi.js",
+    "./memory": "./dist/memory.js",
+    "./jdbc": "./dist/jdbc/index.js",
+    "./mysql": "./dist/jdbc/mysql.js",
+    "./postgres": "./dist/jdbc/postgres.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "node --import tsx __tests__/spec.test.ts",
+    "demo": "node --import tsx demo/main.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "workflow",
+    "engine",
+    "jeeflow",
+    "typescript"
+  ],
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "@types/pg": "^8.20.3",
+    "tsx": "^4.19.0",
+    "typescript": "^5.5.0"
+  },
+  "optionalDependencies": {
+    "mysql2": "^3.11.0",
+    "pg": "^8.13.0"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ]
+}