@mldong/jeeflow 1.8.20 → 1.8.22

package/README.md

@@ -2,11 +2,11 @@
 
 [jeeflow](https://jeeflow-doc.mldong.com) 引擎规范的 **TypeScript 实现**。仅依赖 `node:*` 标准库，零外部依赖（引擎核心）。
 
-> **v1.1.0**：新增管理扩展（流程设计/历史/委托 + `ProcessExtRepository`）与统一门面
-> `JeeflowFacade.flow(action, args)`；assignee 变量解析与 `flow.auto`/`flow.admin` 系统代执行对齐 boot2/boot3。
+统一门面 `JeeflowFacade.flow(action, args)`；支持管理扩展（流程设计/历史/委托）、
+assignee 变量解析与 `flow.auto`/`flow.admin` 系统代执行。
 
 ```bash
-npm install @mldong/jeeflow   # 等发布到 npm 后
+npm install @mldong/jeeflow
 ```
 
 ## 快速开始
@@ -29,7 +29,7 @@ await engine.executeProcessTask(tasks[0].id, 'leader')
 ```
 
 > ⚠️ **id 全程 string（issue 38 E9）**：引擎内部与 API 契约的 id（流程定义/实例/任务/设计）一律为**字符串**。
-> Java 雪花 id（>2^53）超出 JS 安全整数，`Number()` 转换必丢精度；字符串可无损承载，保证四语言同库共享流程。
+> Java 雪花 id（>2^53）超出 JS 安全整数，`Number()` 转换必丢精度；字符串可无损承载，保证多语言同库共享流程。
 
 ## JDBC（MySQL/PostgreSQL）
 
@@ -74,8 +74,11 @@ npm run demo     # http://localhost:8082
 
 ## 节点支持
 
-对齐 [SPEC.md](https://jeeflow-doc.mldong.com) v1.0——与 Java/Go 版一致。
+对齐 [jeeflow-doc](https://jeeflow-doc.mldong.com)——与其他语言实现行为一致。
 
 ## License
 
-Apache-2.0
+Copyright © 2025-2026 mldong
+
+Licensed under the Apache License, Version 2.0.
+See [LICENSE](./LICENSE) and [NOTICE](./NOTICE).

package/dist/engine.js

@@ -253,7 +253,10 @@ export class EngineImpl {
         const def = await this.repo.findDefineById(inst.defineId);
         const flow = JSON.parse(typeof def.content === 'string' ? def.content : new TextDecoder().decode(def.content));
         args = filterFieldByPerm(args, findNode(flow, task.taskName));
-        const vars = { ...inst.variables, ...task.variables, ...args };
+        // issues/97：捕获原始实例变量（start 注入的发起人 u_*）——操作人 u_* 只进执行上下文
+        // 与任务行，不得整体写回实例（对齐 Java completeTask=putAll(args)，args 不含 u_*）。
+        const baseVars = inst.variables;
+        const vars = { ...baseVars, ...task.variables, ...args };
         await this.addUserInfo(operator, vars);
         const now = new Date();
         // 聚合根：完成任务（子实体状态转换 + 实例变量合并）
@@ -263,7 +266,8 @@ export class EngineImpl {
         // completeTask 改的是外部任务对象，需同步回聚合根
         syncTaskToAggregate(inst, task);
         await this.fireEvent({ type: EventType.TaskComplete, instanceId: inst.id, taskId: task.id, nodeId: task.taskName, operator });
-        inst.variables = vars;
+        // issues/97：实例变量写回排除操作人 u_*，保留 start 注入的发起人 u_*（u_realName 恒为发起人）
+        inst.variables = mergeExecIntoInstance(baseVars, vars);
         await this.repo.updateInstance(inst);
         return { task, inst, flow, vars };
     }
@@ -407,7 +411,8 @@ export class EngineImpl {
                     else {
                         inst.finish(new Date());
                     }
-                    inst.variables = vars;
+                    // issues/97：结束节点写回同样排除操作人 u_*（保留发起人 u_*，与 prepareExecuteTask 一致）
+                    inst.variables = mergeExecIntoInstance(inst.variables, vars);
                     await this.repo.updateInstance(inst);
                     await this.fireEvent({ type: EventType.ProcessFinish, instanceId: inst.id, operator });
                     return;
@@ -638,6 +643,19 @@ function syncTaskToAggregate(inst, task) {
         }
     }
 }
+/** 实例变量写回合并（issues/97 对齐 Java）：以 base（start 注入的发起人 u_*）为底，
+ *  并入执行上下文中**非 u_*** 键（f_ 表单字段 / submitType 等流转数据）。
+ *  addUserInfo 生成的操作人 u_* 只属于当次执行上下文与任务行 ext，不整体写回实例——
+ *  实例 u_realName 语义是「发起人」（与 autoGenTitle 一致），不随审批节点漂移。 */
+function mergeExecIntoInstance(base, execVars) {
+    const out = { ...base };
+    for (const [k, v] of Object.entries(execVars)) {
+        if (k.startsWith('u_'))
+            continue;
+        out[k] = v;
+    }
+    return out;
+}
 function isTruthy(v) {
     if (typeof v === 'boolean')
         return v;

package/dist/facade.d.ts

@@ -48,6 +48,8 @@ export declare class JeeflowFacade {
     private surrogateUpdate;
     /** 委托详情（issues/77）：按 id 查单条，返回行结构（时间格式化） */
     private surrogateDetail;
+    /** 删除委托（issues/95：前端「我的委托」行内/批量删除统一发 {ids}，与 define/design remove 同惯例） */
+    private surrogateRemove;
     /** 委托写入公共字段。授权人（operator）仅在显式传入时覆盖，避免 update
      *  时清空原授权人（前端编辑表单不带 operator；集成层注入时 operator=授权人，覆盖无害） */
     private applySurrogateFields;

package/dist/facade.js

@@ -106,7 +106,7 @@ export class JeeflowFacade {
             case 'processSurrogate/detail': // issues/77
                 return this.surrogateDetail(args);
             case 'processSurrogate/remove':
-                return this.ext().removeSurrogate(toId(args.id));
+                return this.surrogateRemove(args);
             case 'processDefine/getLastByName':
                 return this.getLastByName(args);
             case 'processInstance/highLight':
@@ -364,36 +364,21 @@ export class JeeflowFacade {
     /** 删除设计稿（issues/28：兼容 {ids} 批量与单 {id}） */
     async designRemove(args) {
         const ext = this.ext();
-        if (Array.isArray(args.ids)) {
-            for (const id of args.ids)
-                await ext.removeDesign(toId(id));
-        }
-        else {
-            await ext.removeDesign(toId(args.id));
-        }
+        for (const id of idListArgs(args))
+            await ext.removeDesign(id);
         return {};
     }
     /** 删除定义（issues/28：兼容 {ids} 批量与单 {id}） */
     async defineRemove(args) {
-        if (Array.isArray(args.ids)) {
-            for (const id of args.ids)
-                await this.repo.removeDefine(toId(id));
-        }
-        else {
-            await this.repo.removeDefine(toId(args.id));
-        }
+        for (const id of idListArgs(args))
+            await this.repo.removeDefine(id);
         return {};
     }
     /** 启用/停用（issues/28：兼容 {ids, opType} 批量；opType/state 二选一） */
     async defineUpAndDown(args) {
         const state = toInt(args.opType ?? args.state);
-        if (Array.isArray(args.ids)) {
-            for (const id of args.ids)
-                await this.repo.updateDefineState(toId(id), state);
-        }
-        else {
-            await this.repo.updateDefineState(toId(args.id), state);
-        }
+        for (const id of idListArgs(args))
+            await this.repo.updateDefineState(id, state);
         return {};
     }
     /** 按类型分组列出流程设计（issue 30，对齐 Java issues/28）：不依赖框架字典 */
@@ -628,6 +613,13 @@ export class JeeflowFacade {
             throw new Error('委托记录不存在');
         return surrogateRowToMap(surrogate);
     }
+    /** 删除委托（issues/95：前端「我的委托」行内/批量删除统一发 {ids}，与 define/design remove 同惯例） */
+    async surrogateRemove(args) {
+        const ext = this.ext();
+        for (const id of idListArgs(args))
+            await ext.removeSurrogate(id);
+        return {};
+    }
     /** 委托写入公共字段。授权人（operator）仅在显式传入时覆盖，避免 update
      *  时清空原授权人（前端编辑表单不带 operator；集成层注入时 operator=授权人，覆盖无害） */
     applySurrogateFields(s, args, operator) {
@@ -1280,6 +1272,16 @@ function toId(v) {
         throw new Error('id 缺失或非法');
     return s;
 }
+/** 删除/启停类 action 的批量主键：mldong IdsParam 惯例下 {ids} 数组优先，兼容单 {id}；
+ *  两者皆缺失、空数组或含非法值一律报错（issues/95，对齐 Java idListArgs） */
+function idListArgs(args) {
+    if (Array.isArray(args.ids)) {
+        if (args.ids.length === 0)
+            throw new Error('id 缺失或非法');
+        return args.ids.map(toId);
+    }
+    return [toId(args.id)];
+}
 function toStringList2(v) {
     if (Array.isArray(v))
         return v.map(String);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mldong/jeeflow",
-  "version": "1.8.20",
+  "version": "1.8.22",
   "description": "jeeflow workflow engine — Node.js / TypeScript implementation",
   "type": "module",
   "main": "./dist/index.js",