@mldong/jeeflow 1.8.20 → 1.8.21

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/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.21",
   "description": "jeeflow workflow engine — Node.js / TypeScript implementation",
   "type": "module",
   "main": "./dist/index.js",