@mldong/jeeflow 1.0.0 → 1.1.0

package/README.md

@@ -1,55 +1,58 @@
-# jeeflow · Node.js / TypeScript
-
-[jeeflow](https://jeeflow-doc.mldong.com) 引擎规范的 **TypeScript 实现**。仅依赖 `node:*` 标准库，零外部依赖（引擎核心）。
-
-```bash
-npm install jeeflow   # 等发布到 npm 后
-```
-
-## 快速开始
-
-```ts
-import { EngineImpl, MemoryRepository } from 'jeeflow'
-
-const repo = new MemoryRepository()
-const engine = new EngineImpl(repo)
-
-const def = {
-  id: 1, name: 'leave', displayName: '请假审批',
-  content: JSON.stringify({ nodes: [...], edges: [...] })
-}
-repo.addDefine(def)
-
-const inst = await engine.startProcessInstanceById(def.id, '张三')
-const tasks = await repo.findDoingTasks(inst.id)
-await engine.executeProcessTask(tasks[0].id, 'leader')
-```
-
-## 运行演示
-
-```bash
-git clone https://github.com/mldong/jeeflow-node
-cd jeeflow-node
-npm install
-npm run demo     # http://localhost:8082
-```
-
-## 目录
-
-| 路径 | 说明 |
-|------|------|
-| `src/engine.ts` | 引擎核心 |
-| `src/model.ts` | 域类型 |
-| `src/spi.ts` | SPI 接口 |
-| `src/memory.ts` | 内存仓储 |
-| `src/jdbc/` | JDBC 多库实现（shared 核心 + mysql/postgres 适配器） |
-| `demo/main.ts` | Express 演示 |
-| `__tests__/` | 9 项合规测试 |
-
-## 节点支持
-
-对齐 [SPEC.md](https://jeeflow-doc.mldong.com) v1.0——与 Java/Go 版一致。
-
-## License
-
-Apache-2.0
+# jeeflow · Node.js / TypeScript
+
+[jeeflow](https://jeeflow-doc.mldong.com) 引擎规范的 **TypeScript 实现**。仅依赖 `node:*` 标准库，零外部依赖（引擎核心）。
+
+> **v1.1.0**：新增管理扩展（流程设计/历史/委托 + `ProcessExtRepository`）与统一门面
+> `JeeflowFacade.flow(action, args)`；assignee 变量解析与 `flow.auto`/`flow.admin` 系统代执行对齐 boot2/boot3。
+
+```bash
+npm install @mldong/jeeflow   # 等发布到 npm 后
+```
+
+## 快速开始
+
+```ts
+import { EngineImpl, MemoryRepository } from '@mldong/jeeflow'
+
+const repo = new MemoryRepository()
+const engine = new EngineImpl(repo)
+
+const def = {
+  id: 1, name: 'leave', displayName: '请假审批',
+  content: JSON.stringify({ nodes: [...], edges: [...] })
+}
+repo.addDefine(def)
+
+const inst = await engine.startProcessInstanceById(def.id, '张三')
+const tasks = await repo.findDoingTasks(inst.id)
+await engine.executeProcessTask(tasks[0].id, 'leader')
+```
+
+## 运行演示
+
+```bash
+git clone https://github.com/mldong/jeeflow-node
+cd jeeflow-node
+npm install
+npm run demo     # http://localhost:8082
+```
+
+## 目录
+
+| 路径 | 说明 |
+|------|------|
+| `src/engine.ts` | 引擎核心 |
+| `src/model.ts` | 域类型 |
+| `src/spi.ts` | SPI 接口 |
+| `src/memory.ts` | 内存仓储 |
+| `src/jdbc/` | JDBC 多库实现（shared 核心 + mysql/postgres 适配器） |
+| `demo/main.ts` | Express 演示 |
+| `__tests__/` | 9 项合规测试 |
+
+## 节点支持
+
+对齐 [SPEC.md](https://jeeflow-doc.mldong.com) v1.0——与 Java/Go 版一致。
+
+## License
+
+Apache-2.0

package/dist/engine.d.ts

@@ -10,6 +10,9 @@ export declare const KeyDeptID = "u_deptId";
 export declare const KeyDeptName = "u_deptName";
 export declare const KeyPostID = "u_postId";
 export declare const KeyPostName = "u_postName";
+export declare const KeyNextNodeOperator = "tf_nextNodeOperator";
+export declare const KeyAutoExecute = "flow.auto";
+export declare const KeyAdminID = "flow.admin";
 export interface Engine {
     startProcessInstanceById(defineId: number, operator: string, args?: Record<string, any>): Promise<ProcessInstance>;
     executeProcessTask(taskId: number, operator: string, args?: Record<string, any>): Promise<ProcessInstance>;

package/dist/engine.js

@@ -8,6 +8,11 @@ export const KeyDeptID = 'u_deptId';
 export const KeyDeptName = 'u_deptName';
 export const KeyPostID = 'u_postId';
 export const KeyPostName = 'u_postName';
+// v1.0.1：下一节点处理人（对齐 boot3 tf_nextNodeOperator）
+export const KeyNextNodeOperator = 'tf_nextNodeOperator';
+// v1.0.1：系统代执行 / 超级管理员（对齐 boot3 FlowConst）
+export const KeyAutoExecute = 'flow.auto';
+export const KeyAdminID = 'flow.admin';
 export class EngineImpl {
     repo;
     userProv;
@@ -74,6 +79,9 @@ export class EngineImpl {
         // 聚合根：完成任务（子实体状态转换 + 实例变量合并）
         inst.completeTask(task, operator, vars, now);
         await this.repo.updateTask(task);
+        // v1.0.1：updateInstance 级联持久化依赖聚合内任务副本为最新状态，
+        // completeTask 改的是外部任务对象，需同步回聚合根
+        syncTaskToAggregate(inst, task);
         await this.fireEvent({ type: EventType.TaskComplete, instanceId: inst.id, taskId: task.id, nodeId: task.taskName, operator });
         const def = await this.repo.findDefineById(inst.defineId);
         const flow = JSON.parse(typeof def.content === 'string' ? def.content : new TextDecoder().decode(def.content));
@@ -132,6 +140,8 @@ export class EngineImpl {
         // 子实体：完成任务
         task.finish(operator, task.variables, now);
         await this.repo.updateTask(task);
+        // v1.0.1：同步回聚合根，避免 updateInstance 级联把任务写回旧状态
+        syncTaskToAggregate(inst, task);
         // 聚合根：驳回
         inst.reject(now);
         await this.repo.updateInstance(inst);
@@ -286,8 +296,8 @@ export class EngineImpl {
             }
         }
     }
-    async createTask(node, inst, operator, _vars) {
-        const actors = await this.resolveActors(node, inst);
+    async createTask(node, inst, operator, vars) {
+        const actors = await this.resolveActors(node, inst, vars);
         if (!actors.length)
             return;
         const performType = parseInt(String(node.properties?.performType ?? '0'));
@@ -316,9 +326,13 @@ export class EngineImpl {
                     return;
             }
         }
-        await this.repo.saveTask(inst.createTask(this.nextId(), node.id, node.text.value, actors[0], operator, form, now));
+        // 普通任务：一个任务承载全部参与者（对齐 boot3 createTask + addTaskActor，多参与者任一可办）
+        const nt = inst.createTask(this.nextId(), node.id, node.text.value, actors[0], operator, form, now);
+        if (actors.length > 1)
+            nt.actorIds = actors;
+        await this.repo.saveTask(nt);
     }
-    async resolveActors(node, inst) {
+    async resolveActors(node, inst, vars) {
         // 1a. Registry 按名称解析（推荐）
         if (this.registry) {
             const handlerName = node.properties?.assignmentHandler ?? '';
@@ -335,21 +349,56 @@ export class EngineImpl {
             if (Array.isArray(result) && result.length > 0)
                 return result;
         }
-        // 2. 固定指派 assignee（boot2 约定："applicant" → 解析为流程发起人）
+        // 2. 动态指定下一节点处理人优先（v1.0.1：对齐 boot3 tf_nextNodeOperator）
+        const nextOp = vars[KeyNextNodeOperator];
+        if (nextOp != null) {
+            if (typeof nextOp === 'string')
+                return nextOp.split(',').map(s => s.trim()).filter(Boolean);
+            if (Array.isArray(nextOp))
+                return nextOp.map(String);
+            return [String(nextOp)];
+        }
+        // 3. 固定指派 assignee——token 即变量 key，能替换就换，换不了就是字面量（v1.0.1 对齐 boot3 args.get(token, token)）
         const assignee = node.properties?.assignee;
         if (assignee) {
-            const actors = assignee.split(',').map(s => s.trim()).filter(Boolean);
-            return actors.map(a => (a === 'applicant' ? inst.operator : a));
+            const actors = [];
+            for (const raw of assignee.split(',')) {
+                let token = raw.trim();
+                if (!token)
+                    continue;
+                // mldong 契约特殊值：applicant → 流程发起人
+                if (token.includes('applicant'))
+                    token = token.replace('applicant', inst.operator);
+                if (token in vars) {
+                    const val = vars[token];
+                    if (Array.isArray(val))
+                        actors.push(...val.map(String));
+                    else
+                        actors.push(String(val));
+                }
+                else {
+                    actors.push(token);
+                }
+            }
+            return actors;
         }
         return [];
     }
     isAllowed(task, operator) {
+        // v1.0.1：系统代执行（flow.auto）/超级管理员（flow.admin）放行（对齐 boot3 isAllowed）
+        if (operator && (operator.toLowerCase() === KeyAutoExecute || operator.toLowerCase() === KeyAdminID)) {
+            return true;
+        }
         // 子实体：actorIds 权限判断
         return task.isAllowed(operator);
     }
     async addUserInfo(operator, vars) {
         if (!this.userProv)
             return;
+        // v1.0.1：系统代执行（flow.auto）/超级管理员（flow.admin）非真实用户，跳过注入（对齐 boot3）
+        if (operator && (operator.toLowerCase() === KeyAutoExecute || operator.toLowerCase() === KeyAdminID)) {
+            return;
+        }
         const u = await this.userProv.getUser(operator);
         if (!u)
             return;
@@ -389,6 +438,16 @@ function getCsState(vars, nodeId) {
     const lc = parseInt(String(vars[`loopCounter_${nodeId}`] ?? '0'));
     return [actors, lc];
 }
+// syncTaskToAggregate 把外部任务对象的最新状态同步回聚合根任务副本
+// （v1.0.1：updateInstance 级联持久化依赖聚合内任务副本为最新状态）
+function syncTaskToAggregate(inst, task) {
+    for (let i = 0; i < inst.tasks.length; i++) {
+        if (inst.tasks[i].id === task.id) {
+            inst.tasks[i] = task;
+            return;
+        }
+    }
+}
 function isTruthy(v) {
     if (typeof v === 'boolean')
         return v;

package/dist/facade.d.ts

@@ -0,0 +1,22 @@
+import type { ProcessExtRepository, ProcessRepository } from './spi.js';
+import type { EngineImpl } from './engine.js';
+export declare class JeeflowFacade {
+    private readonly engine;
+    private readonly repo;
+    private readonly extRepo?;
+    constructor(engine: EngineImpl, repo: ProcessRepository, extRepo?: ProcessExtRepository | undefined);
+    flow(action: string, args?: Record<string, any>): Promise<Record<string, any>>;
+    private dispatch;
+    private startAndExecute;
+    private deploy;
+    private saveDeployedDefine;
+    private redeploy;
+    private withdraw;
+    private execute;
+    private designPage;
+    private designDetail;
+    private designSave;
+    private surrogatePage;
+    private surrogateSave;
+    private ext;
+}

package/dist/facade.js

@@ -0,0 +1,329 @@
+// 统一门面（v1.1.0）——"接口即 POST + JSON body"风格的单入口
+//
+// 集成方只实现一个转发端点：把 body JSON 转成对象传入 flow()，所有流程能力按
+// action（boot2/boot3 端点短名）路由。返回统一结构 {code, msg, data}
+// （code=0 成功 / 99999999 失败）。操作人约定：args.operator 显式传入。
+// submitType 枚举（对齐 boot3）
+const SUBMIT_APPLY = 0;
+const SUBMIT_AGREE = 1;
+const SUBMIT_REJECT = 2;
+const SUBMIT_ROLLBACK = 3;
+const SUBMIT_JUMP = 4;
+const SUBMIT_ROLLBACK_TO_OPERATOR = 6;
+const SUBMIT_COUNTERSIGN_DISAGREE = 20;
+export class JeeflowFacade {
+    engine;
+    repo;
+    extRepo;
+    constructor(engine, repo, extRepo) {
+        this.engine = engine;
+        this.repo = repo;
+        this.extRepo = extRepo;
+    }
+    async flow(action, args = {}) {
+        try {
+            const data = await this.dispatch(action, args);
+            return { code: 0, msg: '成功', data: data ?? null };
+        }
+        catch (e) {
+            return { code: 99999999, msg: e?.message ?? String(e) };
+        }
+    }
+    async dispatch(action, args) {
+        switch (action) {
+            case 'processDefine/startAndExecute':
+            case 'processInstance/startAndExecute':
+                return this.startAndExecute(args);
+            case 'processDefine/deploy':
+            case 'processDesign/deploy':
+                return this.deploy(args, action === 'processDesign/deploy');
+            case 'processDefine/redeploy':
+                return this.redeploy(args);
+            case 'processDefine/remove':
+                return this.repo.removeDefine(toId(args.id));
+            case 'processDefine/upAndDown':
+                return this.repo.updateDefineState(toId(args.id), toInt(args.state));
+            case 'processInstance/withdraw':
+                return this.withdraw(args);
+            case 'processTask/execute':
+                return this.execute(args);
+            case 'processDesign/page':
+                return this.designPage(args);
+            case 'processDesign/detail':
+                return this.designDetail(args);
+            case 'processDesign/save':
+                return this.designSave(args);
+            case 'processDesign/remove':
+                return this.ext().removeDesign(toId(args.id));
+            case 'processSurrogate/page':
+                return this.surrogatePage(args);
+            case 'processSurrogate/save':
+                return this.surrogateSave(args);
+            case 'processSurrogate/remove':
+                return this.ext().removeSurrogate(toId(args.id));
+            default:
+                throw new Error(`未知 action: ${action}`);
+        }
+    }
+    // ── 流程定义 / 实例 ──────────────────────────────────────────────────────
+    async startAndExecute(args) {
+        const defineId = toId(args.processDefineId);
+        const operator = String(args.operator ?? 'user1');
+        const flowArgs = {};
+        for (const [k, v] of Object.entries(args)) {
+            if (k === 'processDefineId' || k === 'operator')
+                continue;
+            flowArgs[k] = v;
+        }
+        const inst = await this.engine.startProcessInstanceById(defineId, operator, flowArgs);
+        // startAndExecute：自动完成申请节点（assignee="applicant" → 发起人）
+        const doing = await this.repo.findDoingTasks(inst.id);
+        for (const task of doing) {
+            await this.repo.addTaskActor(task.id, [operator]);
+            flowArgs.submitType = SUBMIT_APPLY;
+            await this.engine.executeProcessTask(task.id, operator, flowArgs);
+        }
+        return { processInstanceId: inst.id };
+    }
+    // deploy 版本管理（对齐 boot3）：按 name 查最新定义，存在 version+1 插新记录，否则从 0 起
+    async deploy(args, fromDesign) {
+        let content;
+        if (fromDesign) {
+            const designId = toId(args.id);
+            const ext = this.ext();
+            const design = await ext.findDesignById(designId);
+            if (!design)
+                throw new Error('流程设计不存在');
+            const hisList = await ext.listDesignHis(designId);
+            if (hisList.length === 0)
+                throw new Error('流程设计没有内容，无法发布');
+            content = toStr(hisList[0].content);
+            const defineId = await this.saveDeployedDefine(content, args);
+            design.isDeployed = 1;
+            design.updateUser = String(args.operator ?? 'system');
+            await ext.updateDesign(design);
+            return { processDefineId: defineId };
+        }
+        content = toStr(args.content);
+        const defineId = await this.saveDeployedDefine(content, args);
+        return { processDefineId: defineId };
+    }
+    async saveDeployedDefine(content, args) {
+        let flow;
+        try {
+            flow = JSON.parse(content);
+        }
+        catch {
+            throw new Error('流程定义 JSON 解析失败');
+        }
+        const name = flow?.name;
+        if (!name)
+            throw new Error('流程定义缺少 name');
+        let version = 0;
+        const latest = await this.repo.findDefineByName(name);
+        if (latest)
+            version = (latest.version ?? 0) + 1;
+        const operator = String(args.operator ?? 'system');
+        const def = {
+            id: 0, name, displayName: flow.displayName ?? '', type: flow.type ?? 'approval',
+            state: 1, content, version, createTime: new Date(), createUser: operator,
+            updateTime: new Date(), updateUser: operator,
+        };
+        await this.repo.saveDefine(def);
+        return def.id;
+    }
+    async redeploy(args) {
+        const defineId = toId(args.processDefineId);
+        const content = toStr(args.content);
+        let flow;
+        try {
+            flow = JSON.parse(content);
+        }
+        catch {
+            throw new Error('流程定义 JSON 解析失败');
+        }
+        await this.repo.updateDefine({
+            id: defineId, name: flow?.name ?? '', displayName: flow?.displayName ?? '',
+            type: flow?.type ?? 'approval', state: 1, content, version: 0,
+            createTime: new Date(), createUser: '', updateTime: new Date(),
+            updateUser: String(args.operator ?? 'system'),
+        });
+    }
+    async withdraw(args) {
+        const instanceId = toId(args.id);
+        const inst = await this.repo.findInstanceById(instanceId);
+        if (!inst)
+            throw new Error('流程实例不存在');
+        // 撤回：废弃全部 doing 任务 + 实例状态（v1.0.1：updateInstance 级联落库）
+        const operator = String(args.operator ?? 'user1');
+        const now = new Date();
+        const abandoned = inst.abandonAllDoing(now);
+        inst.reject(now);
+        inst.updateUser = operator;
+        for (const t of abandoned)
+            await this.repo.updateTask(t);
+        await this.repo.updateInstance(inst);
+    }
+    // ── 流程任务 ─────────────────────────────────────────────────────────────
+    async execute(args) {
+        const taskId = toId(args.processTaskId);
+        const operator = String(args.operator ?? 'user1');
+        const submitType = toInt(args.submitType ?? SUBMIT_AGREE);
+        const flowArgs = {};
+        for (const [k, v] of Object.entries(args)) {
+            if (k === 'processTaskId' || k === 'operator')
+                continue;
+            flowArgs[k] = v;
+        }
+        flowArgs.submitType = submitType;
+        // boot3 execute 分发（spec §11.2）
+        switch (submitType) {
+            case SUBMIT_REJECT:
+                await this.engine.executeAndJumpToEnd(taskId, operator, flowArgs);
+                break;
+            case SUBMIT_ROLLBACK:
+                await this.engine.executeAndJumpTask(taskId, operator, flowArgs, '');
+                break;
+            case SUBMIT_JUMP:
+                await this.engine.executeAndJumpTask(taskId, operator, flowArgs, String(args.taskName ?? ''));
+                break;
+            case SUBMIT_ROLLBACK_TO_OPERATOR:
+                await this.engine.executeAndJumpToFirstTaskNode(taskId, operator, flowArgs);
+                break;
+            case SUBMIT_COUNTERSIGN_DISAGREE:
+                flowArgs.countersignDisagreeFlag = 1;
+                await this.engine.executeProcessTask(taskId, operator, flowArgs);
+                break;
+            default: // 0 APPLY / 1 AGREE / 5 重新提交
+                await this.engine.executeProcessTask(taskId, operator, flowArgs);
+        }
+    }
+    // ── 流程设计（需扩展仓储） ───────────────────────────────────────────────
+    async designPage(args) {
+        const [rows, total] = await this.ext().pageDesigns(toInt(args.pageNum ?? 1), toInt(args.pageSize ?? 10));
+        return { rows, recordCount: total };
+    }
+    async designDetail(args) {
+        const ext = this.ext();
+        const design = await ext.findDesignById(toId(args.id));
+        if (!design)
+            throw new Error('流程设计不存在');
+        const data = {
+            id: design.id, name: design.name, displayName: design.displayName,
+            type: design.type, icon: design.icon, isDeployed: design.isDeployed, remark: design.remark,
+        };
+        const hisList = await ext.listDesignHis(design.id);
+        if (hisList.length > 0) {
+            try {
+                data.jsonObject = JSON.parse(toStr(hisList[0].content));
+            }
+            catch { /* ignore */ }
+        }
+        data.his = hisList;
+        return data;
+    }
+    async designSave(args) {
+        const ext = this.ext();
+        const operator = String(args.operator ?? 'user1');
+        const designId = args.id != null ? toId(args.id) : 0;
+        let design;
+        if (!designId) {
+            design = {
+                id: 0, name: String(args.name ?? ''), displayName: String(args.displayName ?? ''),
+                type: String(args.type ?? 'approval'), icon: String(args.icon ?? ''),
+                isDeployed: 0, remark: String(args.remark ?? ''),
+                createTime: new Date(), createUser: operator,
+                updateTime: new Date(), updateUser: operator,
+            };
+            await ext.saveDesign(design);
+        }
+        else {
+            const found = await ext.findDesignById(designId);
+            if (!found)
+                throw new Error('流程设计不存在');
+            if (args.displayName != null)
+                found.displayName = String(args.displayName);
+            if (args.type != null)
+                found.type = String(args.type);
+            if (args.icon != null)
+                found.icon = String(args.icon);
+            if (args.remark != null)
+                found.remark = String(args.remark);
+            found.updateUser = operator;
+            await ext.updateDesign(found);
+            design = found;
+        }
+        // 内容快照（设计稿内容存历史表）
+        if (args.content != null) {
+            await ext.saveDesignHis({
+                id: 0, processDesignId: design.id, content: String(args.content),
+                createTime: new Date(), createUser: operator,
+            });
+        }
+        return { id: design.id };
+    }
+    // ── 委托代理（需扩展仓储） ───────────────────────────────────────────────
+    async surrogatePage(args) {
+        const filters = args.operator != null ? { operator: String(args.operator) } : undefined;
+        const [rows, total] = await this.ext().pageSurrogates(toInt(args.pageNum ?? 1), toInt(args.pageSize ?? 10), filters);
+        return { rows, recordCount: total };
+    }
+    async surrogateSave(args) {
+        const ext = this.ext();
+        const operator = String(args.operator ?? 'user1');
+        const surrogateId = args.id != null ? toId(args.id) : 0;
+        let surrogate;
+        if (!surrogateId) {
+            surrogate = {
+                id: 0, operator, // 授权人 = 操作人
+                surrogate: String(args.surrogate ?? ''), processName: String(args.processName ?? ''),
+                enabled: toInt(args.enabled ?? 1),
+                createTime: new Date(), createUser: operator,
+                updateTime: new Date(), updateUser: operator,
+            };
+            await ext.saveSurrogate(surrogate);
+        }
+        else {
+            const found = await ext.findSurrogateById(surrogateId);
+            if (!found)
+                throw new Error('委托记录不存在');
+            if (args.surrogate != null)
+                found.surrogate = String(args.surrogate);
+            if (args.processName != null)
+                found.processName = String(args.processName);
+            if (args.enabled != null)
+                found.enabled = toInt(args.enabled);
+            found.updateUser = operator;
+            await ext.updateSurrogate(found);
+            surrogate = found;
+        }
+        return { id: surrogate.id };
+    }
+    ext() {
+        if (!this.extRepo)
+            throw new Error('未配置 ProcessExtRepository（扩展仓储）');
+        return this.extRepo;
+    }
+}
+// ── 工具 ──────────────────────────────────────────────────────────────────────
+function toStr(v) {
+    if (v == null)
+        return '';
+    if (typeof v === 'string')
+        return v;
+    if (v instanceof Uint8Array || Buffer.isBuffer(v))
+        return Buffer.from(v).toString('utf8');
+    return String(v);
+}
+function toId(v) {
+    const n = Number(v);
+    if (!Number.isFinite(n) || n <= 0)
+        throw new Error('id 缺失或非法');
+    return n;
+}
+function toInt(v) {
+    const n = Number(v);
+    if (!Number.isFinite(n))
+        throw new Error('数值缺失或非法');
+    return n;
+}

package/dist/jdbc/ext.d.ts

@@ -0,0 +1,29 @@
+import { ProcessDesign, ProcessDesignHis, ProcessSurrogate } from '../model.js';
+import type { IDGenerator, ProcessExtRepository } from '../spi.js';
+import { type SqlAdapter } from './shared.js';
+export declare class JdbcProcessExtRepository implements ProcessExtRepository {
+    private readonly adapter;
+    private readonly idGen;
+    constructor(adapter: SqlAdapter, idGen?: IDGenerator);
+    private sql;
+    private c;
+    private done;
+    private static DESIGN_COLS;
+    findDesignById(id: number): Promise<ProcessDesign | null>;
+    saveDesign(d: ProcessDesign): Promise<void>;
+    updateDesign(d: ProcessDesign): Promise<void>;
+    removeDesign(id: number): Promise<void>;
+    pageDesigns(pageNum?: number, pageSize?: number, filters?: Record<string, any>): Promise<[ProcessDesign[], number]>;
+    saveDesignHis(his: ProcessDesignHis): Promise<void>;
+    listDesignHis(designId: number): Promise<ProcessDesignHis[]>;
+    private static SURROGATE_COLS;
+    findSurrogateById(id: number): Promise<ProcessSurrogate | null>;
+    saveSurrogate(s: ProcessSurrogate): Promise<void>;
+    updateSurrogate(s: ProcessSurrogate): Promise<void>;
+    removeSurrogate(id: number): Promise<void>;
+    pageSurrogates(pageNum?: number, pageSize?: number, filters?: Record<string, any>): Promise<[ProcessSurrogate[], number]>;
+    getSurrogate(operator: string, processName: string, at?: Date): Promise<ProcessSurrogate | null>;
+    private querySurrogate;
+    private mapDesign;
+    private mapSurrogate;
+}