@mldong/jeeflow 1.0.0 → 1.2.0

package/dist/facade.js

@@ -0,0 +1,582 @@
+// 统一门面（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;
+    userSearch;
+    constructor(engine, repo, extRepo) {
+        this.engine = engine;
+        this.repo = repo;
+        this.extRepo = extRepo;
+    }
+    // 注入用户搜索钩子（candidatePage 无模型候选时的用户分页搜索）
+    setUserSearch(fn) {
+        this.userSearch = fn;
+        return this;
+    }
+    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));
+            case 'processDefine/getLastByName':
+                return this.getLastByName(args);
+            case 'processInstance/highLight':
+                return this.highLight(args);
+            case 'processInstance/approvalRecord':
+                return this.approvalRecord(args);
+            case 'processInstance/getAssigneeTextData':
+                return this.getAssigneeTextData(args);
+            case 'processInstance/createCCInstance':
+                return this.createCCInstance(args);
+            case 'processInstance/updateCCStatus':
+                return this.updateCCStatus(args);
+            case 'processInstance/ccList':
+                throw new Error('ccList 需要核心分页 SPI（pageCcInstances），当前语言 1.3.0 补齐');
+            case 'processTask/detail':
+                return this.taskDetail(args);
+            case 'processTask/jumpAbleTaskNameList':
+                return this.jumpAbleTaskNameList(args);
+            case 'processTask/candidatePage':
+                return this.candidatePage(args);
+            case 'processTask/surrogate':
+            case 'processTask/addCandidate':
+                return this.taskAddActor(args);
+            case 'processTask/latest':
+                return this.taskLatest(args);
+            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 };
+    }
+    // ── 视图端点（v1.2.0） ──────────────────────────────────────────────────
+    async getLastByName(args) {
+        const def = await this.repo.findDefineByName(String(args.processDefineName ?? ''));
+        if (!def)
+            throw new Error(`流程定义不存在: ${args.processDefineName}`);
+        return { id: def.id, name: def.name, displayName: def.displayName, type: def.type, state: def.state, version: def.version };
+    }
+    async highLight(args) {
+        const instanceId = toId(args.id);
+        const inst = await this.repo.findInstanceById(instanceId);
+        if (!inst)
+            throw new Error('流程实例不存在');
+        const active = [];
+        const history = [];
+        const edges = [];
+        const doing = await this.repo.findDoingTasks(instanceId);
+        for (const t of doing)
+            if (!active.includes(t.taskName))
+                active.push(t.taskName);
+        const his = await this.repo.findHistoryTasks(instanceId);
+        for (const t of his)
+            if (!active.includes(t.taskName) && !history.includes(t.taskName))
+                history.push(t.taskName);
+        // 路径补全：start 沿边递归（遇活跃节点停止）
+        const def = await this.repo.findDefineById(inst.defineId);
+        if (def) {
+            try {
+                const flow = JSON.parse(toStr(def.content));
+                this.collectPath(flow, 'start', '', active, history, edges, new Set());
+            }
+            catch { /* ignore */ }
+        }
+        return { activeNodeNames: active, historyNodeNames: history, historyEdgeNames: edges };
+    }
+    collectPath(flow, nodeId, edgeName, active, history, edges, visited) {
+        if (visited.has(nodeId))
+            return;
+        visited.add(nodeId);
+        if (edgeName && !edges.includes(edgeName))
+            edges.push(edgeName);
+        for (const e of flow.edges ?? []) {
+            if (e.sourceNodeId !== nodeId)
+                continue;
+            const target = (flow.nodes ?? []).find((n) => n.id === e.targetNodeId);
+            if (!target)
+                continue;
+            const tid = target.id;
+            if (!active.includes(tid) && !history.includes(tid))
+                history.push(tid);
+            if (active.includes(tid))
+                continue;
+            this.collectPath(flow, tid, e.id, active, history, edges, visited);
+        }
+    }
+    async approvalRecord(args) {
+        const instanceId = toId(args.id);
+        const his = await this.repo.findHistoryTasks(instanceId);
+        return his.map(t => ({
+            taskName: t.taskName, displayName: t.displayName, taskType: t.taskType ?? null,
+            performType: t.performType ?? null, taskState: t.taskState, operator: t.actorId ?? '',
+            finishTime: t.finishTime ?? null, variable: t.variables ?? {},
+        }));
+    }
+    async getAssigneeTextData(args) {
+        const instanceId = toId(args.id);
+        const includeNodeName = args.includeNodeName !== false;
+        const rows = [];
+        const doing = await this.repo.findDoingTasks(instanceId);
+        for (const t of doing) {
+            const actors = await this.repo.findTaskActors(t.id);
+            for (const actor of actors) {
+                rows.push({ label: includeNodeName ? `${t.displayName}:${actor}` : actor, value: actor });
+            }
+        }
+        return rows;
+    }
+    async createCCInstance(args) {
+        const instanceId = toId(args.processInstanceId);
+        const operator = String(args.operator ?? 'user1');
+        const actors = toStringList2(args.actorIds);
+        if (actors.length === 0)
+            throw new Error('actorIds 缺失');
+        await this.repo.createCcInstance(instanceId, operator, ...actors);
+    }
+    async updateCCStatus(args) {
+        const instanceId = toId(args.processInstanceId);
+        const operator = String(args.operator ?? 'user1');
+        await this.repo.updateCcStatus(instanceId, operator);
+    }
+    async taskDetail(args) {
+        const taskId = toId(args.id);
+        const operator = String(args.operator ?? 'user1');
+        const task = await this.repo.findTaskById(taskId);
+        if (!task)
+            throw new Error('任务不存在');
+        const actors = await this.repo.findTaskActors(taskId);
+        const vo = {
+            id: task.id, processInstanceId: task.processInstanceId, taskName: task.taskName,
+            displayName: task.displayName, taskType: task.taskType ?? null,
+            performType: task.performType ?? null, taskState: task.taskState,
+            operator: task.actorId ?? '', formKey: task.formKey ?? '',
+            taskActorIdList: actors, executable: task.isAllowed(operator),
+        };
+        // taskModel：流程定义中对应节点
+        const inst = await this.repo.findInstanceById(task.processInstanceId);
+        if (inst) {
+            const def = await this.repo.findDefineById(inst.defineId);
+            if (def) {
+                try {
+                    const flow = JSON.parse(toStr(def.content));
+                    for (const n of flow.nodes ?? []) {
+                        if (n.id === task.taskName) {
+                            vo.taskModel = { name: n.id, displayName: n.text?.value ?? '', type: n.type };
+                            break;
+                        }
+                    }
+                }
+                catch { /* ignore */ }
+            }
+        }
+        return vo;
+    }
+    async jumpAbleTaskNameList(args) {
+        const instanceId = toId(args.processInstanceId);
+        const done = await this.repo.findDoneTasks(instanceId);
+        const rows = [];
+        const seen = new Set();
+        for (const t of done) {
+            if ((t.performType ?? 0) === 1)
+                continue; // COUNTERSIGN
+            if (!seen.has(t.taskName)) {
+                seen.add(t.taskName);
+                rows.push({ label: t.displayName, value: t.taskName });
+            }
+        }
+        return rows;
+    }
+    async candidatePage(args) {
+        const taskId = toId(args.processTaskId ?? args.id);
+        const task = await this.repo.findTaskById(taskId);
+        if (!task)
+            throw new Error('任务不存在');
+        const inst = await this.repo.findInstanceById(task.processInstanceId);
+        if (!inst)
+            throw new Error('流程实例不存在');
+        // 模型候选解析：后继任务节点的 candidateUsers 配置
+        let candidates = [];
+        const def = await this.repo.findDefineById(inst.defineId);
+        if (def) {
+            try {
+                const flow = JSON.parse(toStr(def.content));
+                candidates = this.nextTaskCandidates(flow, task.taskName);
+            }
+            catch { /* ignore */ }
+        }
+        if (candidates.length > 0) {
+            const rows = candidates.map(c => ({ userId: c, realName: c }));
+            return { rows, recordCount: rows.length };
+        }
+        // 无模型候选 → 用户分页搜索（依赖 userSearch 钩子）
+        if (!this.userSearch)
+            throw new Error('未配置 userSearch（用户搜索钩子）');
+        const [rows, total] = await this.userSearch(args);
+        return { rows, recordCount: total };
+    }
+    nextTaskCandidates(flow, taskName) {
+        const result = [];
+        const visited = new Set();
+        const collect = (node) => {
+            const v = node.properties?.candidateUsers;
+            if (v) {
+                for (const s of String(v).split(',')) {
+                    const t = s.trim();
+                    if (t && !result.includes(t))
+                        result.push(t);
+                }
+            }
+        };
+        const walk = (nodeId) => {
+            if (visited.has(nodeId))
+                return;
+            visited.add(nodeId);
+            for (const e of flow.edges ?? []) {
+                if (e.sourceNodeId !== nodeId)
+                    continue;
+                const target = (flow.nodes ?? []).find((n) => n.id === e.targetNodeId);
+                if (!target)
+                    continue;
+                if (target.type === 'snaker:task' || target.type === 'snaker:custom') {
+                    collect(target);
+                    continue;
+                }
+                if (['snaker:fork', 'snaker:join', 'snaker:decision'].includes(target.type)) {
+                    walk(target.id);
+                }
+            }
+        };
+        walk(taskName);
+        return result;
+    }
+    async taskAddActor(args) {
+        const taskId = toId(args.processTaskId);
+        const actors = toStringList2(args.actorIds);
+        if (actors.length === 0)
+            throw new Error('actorIds 缺失');
+        await this.repo.addTaskActor(taskId, actors);
+    }
+    async taskLatest(args) {
+        const instanceId = toId(args.processInstanceId);
+        const doing = await this.repo.findDoingTasks(instanceId);
+        if (doing.length === 0)
+            return null;
+        const t = doing[0];
+        return { id: t.id, taskName: t.taskName, displayName: t.displayName, taskState: t.taskState, operator: t.actorId ?? '' };
+    }
+    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 toStringList2(v) {
+    if (Array.isArray(v))
+        return v.map(String);
+    if (typeof v === 'string')
+        return v.split(',').map(s => s.trim()).filter(Boolean);
+    return [];
+}
+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;
+}