@mldong/jeeflow 1.8.12 → 1.8.13

package/dist/engine.d.ts

@@ -34,7 +34,9 @@ export declare class EngineImpl implements Engine {
     private interceptorCache;
     /** 定义级拦截器解析（issue 34，对齐 Java 模型级 postInterceptors）：
      *  流程定义顶层 postInterceptors 声明 → 按名从 interceptorRegistry 取（未声明该流程不触发）；
-     *  未声明 → 回落引擎级列表（向后兼容）。结果按 defineId 缓存。 */
+     *  未声明 → 回落引擎级列表（向后兼容）。结果按 defineId 缓存。
+     *  issues/60：解析与校验分离——定义读取/JSON 解析失败回落引擎级（现状语义），
+     *  声明中存在未注册名时抛错（不静默跳过），且错误不写缓存保证持续报错。 */
     private resolveInterceptors;
     private firePre;
     /** 表达式求值（v1.5.0，门面 highLight 决策分支过滤用） */

package/dist/engine.js

@@ -36,7 +36,9 @@ export class EngineImpl {
     interceptorCache = new Map();
     /** 定义级拦截器解析（issue 34，对齐 Java 模型级 postInterceptors）：
      *  流程定义顶层 postInterceptors 声明 → 按名从 interceptorRegistry 取（未声明该流程不触发）；
-     *  未声明 → 回落引擎级列表（向后兼容）。结果按 defineId 缓存。 */
+     *  未声明 → 回落引擎级列表（向后兼容）。结果按 defineId 缓存。
+     *  issues/60：解析与校验分离——定义读取/JSON 解析失败回落引擎级（现状语义），
+     *  声明中存在未注册名时抛错（不静默跳过），且错误不写缓存保证持续报错。 */
     async resolveInterceptors(inst) {
         if (!this.ext)
             return [];
@@ -47,23 +49,27 @@ export class EngineImpl {
         if (cached)
             return cached;
         let list = this.ext.interceptors ?? [];
+        let declared = '';
         try {
             const def = await this.repo.findDefineById(defineId);
             if (def) {
                 const content = typeof def.content === 'string' ? def.content : new TextDecoder().decode(def.content);
                 const meta = JSON.parse(content);
-                const declared = String(meta.postInterceptors ?? '').trim();
-                if (declared) {
-                    list = [];
-                    for (const name of declared.split(',').map(n => n.trim())) {
-                        const ic = this.ext.interceptorRegistry?.[name];
-                        if (name && ic)
-                            list.push(ic);
-                    }
-                }
+                declared = String(meta.postInterceptors ?? '').trim();
+            }
+        }
+        catch { /* 定义读取/JSON 解析失败回落引擎级 */ }
+        if (declared) {
+            list = [];
+            for (const name of declared.split(',').map(n => n.trim())) {
+                if (!name)
+                    continue;
+                const ic = this.ext.interceptorRegistry?.[name];
+                if (!ic)
+                    throw new Error(`postInterceptors 声明的拦截器未注册: ${name}`);
+                list.push(ic);
             }
         }
-        catch { /* 解析失败回落引擎级 */ }
         this.interceptorCache.set(defineId, list);
         return list;
     }

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 export { EngineImpl, type Engine } from './engine.js';
 export { MemoryRepository } from './memory.js';
-export { HandlerRegistry, type IAssignmentHandler, type IDecisionHandler, type HandlerMeta } from './registry.js';
+export { HandlerRegistry, type IAssignmentHandler, type IDecisionHandler, type HandlerMeta, type HandlerType } from './registry.js';
 export { enumDict, enumDictKeys, type DictItem } from './metadata.js';
 export * from './model.js';
 export type { ProcessRepository, UserProvider, OrgUserProvider, IDGenerator, ExpressionEvaluator } from './spi.js';
-export { SqliteDynamicTableWriter, PersistPostInterceptor, type DynamicTableWriter, type DefineLoader, } from './persist.js';
+export { SqliteDynamicTableWriter, PersistPostInterceptor, registerPersistMeta, type DynamicTableWriter, type DefineLoader, } from './persist.js';
 export { registerBuiltinAssignments, OperatorAssignmentHandler, FormFieldAssigneeHandler, DeptLeaderAssignmentHandler, DeptMainLeaderAssignmentHandler, ApplicantDeptLeaderAssignmentHandler, ApplicantDeptMainLeaderAssignmentHandler, TaskRoleAssigneeHandler, HANDLER_OPERATOR_ASSIGNMENT, HANDLER_FORM_FIELD_ASSIGNEE, HANDLER_DEPT_LEADER, HANDLER_DEPT_MAIN_LEADER, HANDLER_APPLICANT_DEPT_LEADER, HANDLER_APPLICANT_DEPT_MAIN_LEADER, HANDLER_TASK_ROLE_ASSIGNEE, } from './builtin.js';
 export { JeeflowFacade } from './facade.js';
 export type { EngineExtensions, FlowInterceptor, ProcessEventListener, ProcessEvent, AssignmentHandler, DecisionHandler } from './extensions.js';

package/dist/index.js

@@ -3,7 +3,7 @@ export { MemoryRepository } from './memory.js';
 export { HandlerRegistry } from './registry.js';
 export { enumDict, enumDictKeys } from './metadata.js';
 export * from './model.js';
-export { SqliteDynamicTableWriter, PersistPostInterceptor, } from './persist.js';
+export { SqliteDynamicTableWriter, PersistPostInterceptor, registerPersistMeta, } from './persist.js';
 export { registerBuiltinAssignments, OperatorAssignmentHandler, FormFieldAssigneeHandler, DeptLeaderAssignmentHandler, DeptMainLeaderAssignmentHandler, ApplicantDeptLeaderAssignmentHandler, ApplicantDeptMainLeaderAssignmentHandler, TaskRoleAssigneeHandler, HANDLER_OPERATOR_ASSIGNMENT, HANDLER_FORM_FIELD_ASSIGNEE, HANDLER_DEPT_LEADER, HANDLER_DEPT_MAIN_LEADER, HANDLER_APPLICANT_DEPT_LEADER, HANDLER_APPLICANT_DEPT_MAIN_LEADER, HANDLER_TASK_ROLE_ASSIGNEE, } from './builtin.js';
 // issues/35：包导出面补齐——门面/扩展类型/扩展仓储（集成方组装完整引擎链）
 export { JeeflowFacade } from './facade.js';

package/dist/persist.d.ts

@@ -1,6 +1,7 @@
 import { DatabaseSync } from 'node:sqlite';
 import { type ProcessInstance, type ProcessDefine, type FlowNode } from './model.js';
 import type { FlowInterceptor } from './extensions.js';
+import type { HandlerRegistry } from './registry.js';
 /**
  * 动态表写入组件接口——引擎无关，四语言契约一致（Java/Go/Python/Node）
  *
@@ -111,3 +112,6 @@ export declare class PersistPostInterceptor implements FlowInterceptor {
     /** 流程上下文字段（蛇形列名约定，与 writer 系统字段一致） */
     private fillContext;
 }
+/** 将 PersistPostInterceptor 元数据注册进处理器注册中心（SPI 字典源），
+ *  集成方在实例组装处调用一次即可，保证"字典项 ⟺ 实例"同步（避免各端写死注册遗漏/名不一致）。 */
+export declare function registerPersistMeta(registry: HandlerRegistry): void;

package/dist/persist.js

@@ -362,3 +362,14 @@ export class PersistPostInterceptor {
         data['apply_dept_id'] ??= inst.variables[KeyDeptID] ?? null;
     }
 }
+// ─── 注册助手（issues/60）──────────────────────────────────────────────────────
+/** 将 PersistPostInterceptor 元数据注册进处理器注册中心（SPI 字典源），
+ *  集成方在实例组装处调用一次即可，保证"字典项 ⟺ 实例"同步（避免各端写死注册遗漏/名不一致）。 */
+export function registerPersistMeta(registry) {
+    registry.registerMeta('FlowInterceptor', {
+        name: 'com.mldong.jeeflow.persist.interceptor.PersistPostInterceptor',
+        displayName: '业务数据自动入库',
+        order: 0,
+        group: 'post',
+    });
+}

package/dist/registry.d.ts

@@ -8,8 +8,12 @@ export interface IAssignmentHandler {
 export interface IDecisionHandler {
     decide(node: FlowNode, inst: ProcessInstance, vars: Record<string, any>): string | Promise<string>;
 }
+/** 处理器类型名（对齐 Java/go/python HandlerMeta.type，四语言通用） */
+export type HandlerType = 'AssignmentHandler' | 'CandidateHandler' | 'FlowInterceptor' | 'DecisionHandler';
 /** 处理器元数据（v1.4.0，SPI 实现清单字典源） */
 export interface HandlerMeta {
+    /** 处理器类型（内置 AssignmentHandler 元数据自动携带；老数据缺省按 AssignmentHandler 归类） */
+    type?: HandlerType;
     /** 处理器标识：节点配置的 handlerName（与字典 value 一致） */
     name: string;
     /** 显示名（字典 label） */
@@ -28,14 +32,18 @@ export declare class HandlerRegistry {
     private metas;
     /** 构造即内置 7 个通用 AssignmentHandler 元数据（v1.6.0 issues/16，注册名与 Java 类全限定名一致） */
     constructor();
-    registerAssignment(name: string, handler: IAssignmentHandler, meta?: Omit<HandlerMeta, 'name'>): void;
-    registerDecision(name: string, handler: IDecisionHandler, meta?: Omit<HandlerMeta, 'name'>): void;
+    registerAssignment(name: string, handler: IAssignmentHandler, meta?: Omit<HandlerMeta, 'name' | 'type'>): void;
+    registerDecision(name: string, handler: IDecisionHandler, meta?: Omit<HandlerMeta, 'name' | 'type'>): void;
+    /** 注册处理器元数据（不绑定运行时实现，对齐 Java HandlerRegistry.register；
+     *  拦截器/候选类清单等无运行时注册表的类型用） */
+    registerMeta(type: HandlerType, meta: Omit<HandlerMeta, 'type'>): void;
     resolveAssignment(name: string): IAssignmentHandler | undefined;
     resolveDecision(name: string): IDecisionHandler | undefined;
-    /** 按处理器类型列出可用实现的元数据（typeName: AssignmentHandler / DecisionHandler，按 order 升序） */
-    listHandlers(typeName: 'AssignmentHandler' | 'DecisionHandler'): HandlerMeta[];
+    /** 按处理器类型列出可用实现的元数据（按 order 升序；
+     *  AssignmentHandler/DecisionHandler 并集运行时注册名，其余类型只列显式元数据） */
+    listHandlers(typeName: HandlerType): HandlerMeta[];
     /** 按处理器类型 + 分组列出（拦截器 pre/post） */
-    listHandlersGroup(typeName: 'AssignmentHandler' | 'DecisionHandler', group: string): HandlerMeta[];
+    listHandlersGroup(typeName: HandlerType, group: string): HandlerMeta[];
     /** 已注册的处理器名称清单（含未带元数据的） */
     listHandlerNames(): string[];
 }

package/dist/registry.js

@@ -1,12 +1,12 @@
 /** 内置通用 AssignmentHandler 元数据（v1.6.0 issues/16，注册名与 Java 类全限定名一致，四语言通用） */
 export const BUILTIN_ASSIGNMENT_METAS = [
-    { name: 'com.mldong.jeeflow.interceptor.impl.OperatorAssignmentHandler', displayName: '流程发起人', order: -9999 },
-    { name: 'com.mldong.jeeflow.interceptor.impl.OrgUserAssignmentHandlers$ApplicantDeptLeaderAssignmentHandler', displayName: '发起人所属部门经理', order: 10 },
-    { name: 'com.mldong.jeeflow.interceptor.impl.OrgUserAssignmentHandlers$ApplicantDeptMainLeaderAssignmentHandler', displayName: '发起人所属部门分管领导', order: 20 },
-    { name: 'com.mldong.jeeflow.interceptor.impl.OrgUserAssignmentHandlers$DeptLeaderAssignmentHandler', displayName: '当前用户所属部门经理', order: 30 },
-    { name: 'com.mldong.jeeflow.interceptor.impl.OrgUserAssignmentHandlers$DeptMainLeaderAssignmentHandler', displayName: '当前用户所属部门分管领导', order: 40 },
-    { name: 'com.mldong.jeeflow.interceptor.impl.FormFieldAssigneeHandler', displayName: '根据表单字段值分配参与者', order: 50 },
-    { name: 'com.mldong.jeeflow.interceptor.impl.OrgUserAssignmentHandlers$TaskRoleAssigneeHandler', displayName: '根据任务节点唯一编码关联角色分配参与者', order: 60 },
+    { type: 'AssignmentHandler', name: 'com.mldong.jeeflow.interceptor.impl.OperatorAssignmentHandler', displayName: '流程发起人', order: -9999 },
+    { type: 'AssignmentHandler', name: 'com.mldong.jeeflow.interceptor.impl.OrgUserAssignmentHandlers$ApplicantDeptLeaderAssignmentHandler', displayName: '发起人所属部门经理', order: 10 },
+    { type: 'AssignmentHandler', name: 'com.mldong.jeeflow.interceptor.impl.OrgUserAssignmentHandlers$ApplicantDeptMainLeaderAssignmentHandler', displayName: '发起人所属部门分管领导', order: 20 },
+    { type: 'AssignmentHandler', name: 'com.mldong.jeeflow.interceptor.impl.OrgUserAssignmentHandlers$DeptLeaderAssignmentHandler', displayName: '当前用户所属部门经理', order: 30 },
+    { type: 'AssignmentHandler', name: 'com.mldong.jeeflow.interceptor.impl.OrgUserAssignmentHandlers$DeptMainLeaderAssignmentHandler', displayName: '当前用户所属部门分管领导', order: 40 },
+    { type: 'AssignmentHandler', name: 'com.mldong.jeeflow.interceptor.impl.FormFieldAssigneeHandler', displayName: '根据表单字段值分配参与者', order: 50 },
+    { type: 'AssignmentHandler', name: 'com.mldong.jeeflow.interceptor.impl.OrgUserAssignmentHandlers$TaskRoleAssigneeHandler', displayName: '根据任务节点唯一编码关联角色分配参与者', order: 60 },
 ];
 /** 处理器注册表——按名称注册/解析 + 元数据清单（对标 Spring IoC / Java HandlerRegistry） */
 export class HandlerRegistry {
@@ -22,12 +22,17 @@ export class HandlerRegistry {
     registerAssignment(name, handler, meta) {
         this.assignments.set(name, handler);
         if (meta)
-            this.metas.set(name, { name, ...meta });
+            this.metas.set(name, { type: 'AssignmentHandler', name, ...meta });
     }
     registerDecision(name, handler, meta) {
         this.decisions.set(name, handler);
         if (meta)
-            this.metas.set(name, { name, ...meta });
+            this.metas.set(name, { type: 'DecisionHandler', name, ...meta });
+    }
+    /** 注册处理器元数据（不绑定运行时实现，对齐 Java HandlerRegistry.register；
+     *  拦截器/候选类清单等无运行时注册表的类型用） */
+    registerMeta(type, meta) {
+        this.metas.set(meta.name, { type, ...meta });
     }
     resolveAssignment(name) {
         return this.assignments.get(name);
@@ -36,14 +41,24 @@ export class HandlerRegistry {
         return this.decisions.get(name);
     }
     // ── SPI 实现清单（v1.4.0）──
-    /** 按处理器类型列出可用实现的元数据（typeName: AssignmentHandler / DecisionHandler，按 order 升序） */
+    /** 按处理器类型列出可用实现的元数据（按 order 升序；
+     *  AssignmentHandler/DecisionHandler 并集运行时注册名，其余类型只列显式元数据） */
     listHandlers(typeName) {
-        const names = typeName === 'AssignmentHandler'
-            ? [...this.assignments.keys(), ...this.metas.keys()]
-            : [...this.decisions.keys(), ...this.metas.keys()];
-        // 内置 meta 属于 AssignmentHandler 类型——DecisionHandler 只列注册过的
-        const unique = typeName === 'AssignmentHandler' ? names : this.decisions.keys();
-        return [...new Set(unique)]
+        const names = new Set();
+        if (typeName === 'AssignmentHandler') {
+            for (const n of this.assignments.keys())
+                names.add(n);
+        }
+        else if (typeName === 'DecisionHandler') {
+            for (const n of this.decisions.keys())
+                names.add(n);
+        }
+        for (const [n, m] of this.metas) {
+            // 老数据无 type 时按 AssignmentHandler 归类（与历史 listHandlers 行为一致）
+            if ((m.type ?? 'AssignmentHandler') === typeName)
+                names.add(n);
+        }
+        return [...names]
             .map(n => this.metas.get(n) ?? { name: n })
             .sort((a, b) => (a.order ?? 0) - (b.order ?? 0));
     }

package/package.json

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