@yss123/cage-approval 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 shunshunyue and Cage contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,19 @@
-# Temporary Holding Version
+# @yss123/cage-approval
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+审批适配接口、桥接与代码内封闭路由（可选）
+
+Cage 是通过 TypeScript 声明业务、由框架统一执行权限和数据规则的中后台框架。此包是框架的一部分。
+
+## 使用
+
+```powershell
+pnpm add @yss123/cage-approval
+```
+
+首次使用建议通过脚手架创建完整项目，所需依赖由模板统一配置。需要 Node.js 24 或更新版本。
+
+- [完整使用说明](https://github.com/shunshunyue/cage/blob/main/docs/使用说明.md)
+- [框架源码与范例](https://github.com/shunshunyue/cage)
+- [问题反馈](https://github.com/shunshunyue/cage/issues)
+
+许可证：[MIT](https://github.com/shunshunyue/cage/blob/main/LICENSE)。

package/dist/bridge.d.ts

@@ -0,0 +1,6 @@
+import type { Kernel } from '@yss123/cage-kernel';
+import type { Transaction } from 'kysely';
+import type { ApprovalAdapter, ApprovalOutcome } from './types.js';
+export declare function applyOutcome(k: Kernel, r: ApprovalOutcome, tx?: Transaction<any>): Promise<Record<string, any>>;
+/** 外部引擎（例如独立部署的 Warm-Flow、Flowable 服务）：它的结论通过回调进入这里 */
+export declare function bindApproval(adapter: ApprovalAdapter, k: Kernel): void;

package/dist/bridge.js

@@ -0,0 +1,20 @@
+export async function applyOutcome(k, r, tx) {
+    const binding = k.registry.approvalByProcess(r.process);
+    if (!binding)
+        throw new Error(`[CAGE-APPR-004] 没有流程 ${r.process} 的审批绑定`);
+    const cmd = r.outcome === 'approved' ? binding.a.onApproved : binding.a.onRejected;
+    const ctx = k.processCtx({
+        process: r.process,
+        tenantId: r.tenantId,
+        onBehalfOf: r.lastApprover,
+        capabilities: [k.registry.capabilityOf(binding.a.onApproved), k.registry.capabilityOf(binding.a.onRejected)],
+    });
+    return tx ? k.executeIn(tx, cmd, { id: r.businessKey }, ctx, 0) : k.execute(cmd, { id: r.businessKey }, ctx);
+}
+/** 外部引擎（例如独立部署的 Warm-Flow、Flowable 服务）：它的结论通过回调进入这里 */
+export function bindApproval(adapter, k) {
+    adapter.onCompleted(async (r) => {
+        await applyOutcome(k, r);
+    });
+}
+//# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,CAAS,EAAE,CAAkB,EAAE,EAAqB;IACrF,MAAM,OAAO,GAAG,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACxD,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC,OAAO,QAAQ,CAAC,CAAC;IACzE,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;IACnF,MAAM,GAAG,GAAG,CAAC,CAAC,UAAU,CAAC;QACvB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,UAAU,EAAE,CAAC,CAAC,YAAY;QAC1B,YAAY,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;KAC7G,CAAC,CAAC;IACH,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,GAAG,CAAC,CAAC;AAC/G,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,YAAY,CAAC,OAAwB,EAAE,CAAS;IAC9D,OAAO,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAC9B,MAAM,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/engine.d.ts

@@ -0,0 +1,45 @@
+import { type Kernel } from '@yss123/cage-kernel';
+import { type ApprovalEngine } from '@yss123/cage-kernel/worker';
+import { type Transaction } from 'kysely';
+import { type Route } from './route.js';
+export interface TaskView {
+    id: string;
+    instanceId: string;
+    process: string;
+    aggregate: string;
+    businessKey: string;
+    step: number;
+    title: string;
+    status: string;
+    vars: Record<string, unknown>;
+    createdAt: string;
+}
+export declare class InCodeEngine implements ApprovalEngine {
+    private readonly k;
+    readonly route: Route;
+    constructor(k: Kernel, route: Route);
+    private approversOf;
+    private openStep;
+    start(input: {
+        process: string;
+        businessKey: string;
+        tenantId: string;
+        vars: Record<string, unknown>;
+        tx: Transaction<any>;
+    }): Promise<{
+        instanceId: string;
+    }>;
+    cancel(input: {
+        process: string;
+        businessKey: string;
+        tenantId: string;
+        tx: Transaction<any>;
+    }): Promise<void>;
+    /** 我的待办 */
+    tasksOf(userId: string, tenantId: string, status?: string): Promise<TaskView[]>;
+    /** 审批人做出决定；流程结束时在同一事务里执行结论命令 */
+    decide(taskId: string, userId: string, tenantId: string, outcome: 'approved' | 'rejected', comment?: string): Promise<{
+        finished: boolean;
+        outcome?: string;
+    }>;
+}

package/dist/engine.js

@@ -0,0 +1,150 @@
+// 代码内封闭路由的引擎：流程实例和待办存在 flow 模式；结论通过桥接以流程身份调用命令。
+// 审批人做出最后一个决定时，决定和结论命令在同一个事务里提交：命令被拒（例如超出额度）时决定也不生效。
+import { cageError } from '@yss123/cage-kernel';
+import { sql } from 'kysely';
+import { applyOutcome } from './bridge.js';
+import { resolveSteps } from './route.js';
+export class InCodeEngine {
+    k;
+    route;
+    constructor(k, route) {
+        this.k = k;
+        this.route = route;
+    }
+    async approversOf(tx, a, vars, tenantId) {
+        switch (a.kind) {
+            case 'user':
+                return [a.userId];
+            case 'deptLeader': {
+                const deptId = vars[a.field];
+                if (typeof deptId !== 'string')
+                    return [];
+                // 本部门没有负责人时沿祖先路径向上找
+                const d = await tx.selectFrom('sys.dept').select(['leader_id', 'ancestors']).where('id', '=', deptId).where('tenant_id', '=', tenantId).executeTakeFirst();
+                if (!d)
+                    return [];
+                if (d.leader_id)
+                    return [d.leader_id];
+                const ids = String(d.ancestors).split('/').filter(Boolean).reverse();
+                for (const id of ids) {
+                    const p = await tx.selectFrom('sys.dept').select('leader_id').where('id', '=', id).executeTakeFirst();
+                    if (p?.leader_id)
+                        return [p.leader_id];
+                }
+                return [];
+            }
+            case 'role': {
+                const role = await tx.selectFrom('sys.role').select('id').where('code', '=', a.code).where('tenant_id', '=', tenantId).where('status', '=', 'active').executeTakeFirst();
+                if (!role)
+                    return [];
+                const users = await tx
+                    .selectFrom('sys.user')
+                    .select('id')
+                    .where('tenant_id', '=', tenantId)
+                    .where('status', '=', 'active')
+                    .where(sql `role_ids @> ${JSON.stringify([role.id])}::jsonb`)
+                    .execute();
+                return users.map((u) => u.id);
+            }
+            default:
+                return [];
+        }
+    }
+    async openStep(tx, instanceId, tenantId, steps, index, vars) {
+        const s = steps[index];
+        const who = await this.approversOf(tx, s.approver, vars, tenantId);
+        if (who.length === 0) {
+            throw new Error(`[CAGE-APPR-007] 流程 ${this.route.process} 第 ${index + 1} 步「${s.title}」找不到审批人，请在 /admin 配置部门负责人或角色`);
+        }
+        for (const assignee of new Set(who)) {
+            await tx.insertInto('flow.approval_task').values({ instance_id: instanceId, tenant_id: tenantId, step: index, title: s.title, assignee }).execute();
+        }
+    }
+    async start(input) {
+        const { tx } = input;
+        const binding = this.k.registry.approvalByProcess(input.process);
+        const steps = resolveSteps(this.route.nodes, input.vars);
+        // 同一张单重新提交时，关闭旧的流程实例
+        await tx.updateTable('flow.approval_instance').set({ status: 'superseded', updated_at: sql `now()` })
+            .where('tenant_id', '=', input.tenantId).where('business_key', '=', input.businessKey).where('status', '=', 'running').execute();
+        const inst = await tx
+            .insertInto('flow.approval_instance')
+            .values({
+            tenant_id: input.tenantId, process: input.process, aggregate: binding?.a.agg.name ?? '', business_key: input.businessKey,
+            vars: JSON.stringify(input.vars), steps: JSON.stringify(steps),
+        })
+            .returning('id')
+            .executeTakeFirstOrThrow();
+        await this.openStep(tx, inst.id, input.tenantId, steps, 0, input.vars);
+        return { instanceId: inst.id };
+    }
+    async cancel(input) {
+        const insts = await input.tx.selectFrom('flow.approval_instance').select('id')
+            .where('tenant_id', '=', input.tenantId).where('business_key', '=', input.businessKey).where('status', '=', 'running').execute();
+        for (const i of insts) {
+            await input.tx.updateTable('flow.approval_instance').set({ status: 'cancelled', updated_at: sql `now()` }).where('id', '=', i.id).execute();
+            await input.tx.updateTable('flow.approval_task').set({ status: 'cancelled' }).where('instance_id', '=', i.id).where('status', '=', 'pending').execute();
+        }
+    }
+    /** 我的待办 */
+    async tasksOf(userId, tenantId, status = 'pending') {
+        const rows = await this.k.app
+            .selectFrom('flow.approval_task as t')
+            .innerJoin('flow.approval_instance as i', 'i.id', 't.instance_id')
+            .select(['t.id', 't.instance_id', 'i.process', 'i.aggregate', 'i.business_key', 't.step', 't.title', 't.status', 'i.vars', 't.created_at'])
+            .where('t.assignee', '=', userId)
+            .where('t.tenant_id', '=', tenantId)
+            .where('t.status', '=', status)
+            .where('i.process', '=', this.route.process)
+            .orderBy('t.created_at', 'desc')
+            .limit(200)
+            .execute();
+        return rows.map((r) => ({
+            id: r.id, instanceId: r.instance_id, process: r.process, aggregate: r.aggregate, businessKey: r.business_key,
+            step: r.step, title: r.title, status: r.status, vars: r.vars, createdAt: new Date(r.created_at).toISOString(),
+        }));
+    }
+    /** 审批人做出决定；流程结束时在同一事务里执行结论命令 */
+    async decide(taskId, userId, tenantId, outcome, comment) {
+        return this.k.app.transaction().execute(async (tx) => {
+            const task = await tx.selectFrom('flow.approval_task').selectAll()
+                .where('id', '=', taskId).where('tenant_id', '=', tenantId).forUpdate().executeTakeFirst();
+            // 不是自己的待办一律 404，不泄露存在性
+            if (!task || task.assignee !== userId)
+                throw cageError('NOT_FOUND');
+            if (task.status !== 'pending')
+                throw cageError('INVALID_TRANSITION', { status: task.status });
+            const inst = await tx.selectFrom('flow.approval_instance').selectAll().where('id', '=', task.instance_id).forUpdate().executeTakeFirstOrThrow();
+            if (inst.status !== 'running')
+                throw cageError('INVALID_TRANSITION', { status: inst.status });
+            await tx.updateTable('flow.approval_task').set({ status: outcome, comment: comment ?? null, decided_at: sql `now()` }).where('id', '=', taskId).execute();
+            const steps = inst.steps;
+            const finish = async (result) => {
+                await tx.updateTable('flow.approval_task').set({ status: 'skipped' }).where('instance_id', '=', inst.id).where('status', '=', 'pending').execute();
+                await tx.updateTable('flow.approval_instance').set({ status: result, last_approver: userId, updated_at: sql `now()` }).where('id', '=', inst.id).execute();
+                await applyOutcome(this.k, { process: inst.process, tenantId, businessKey: inst.business_key, outcome: result, lastApprover: userId }, tx);
+                return { finished: true, outcome: result };
+            };
+            if (outcome === 'rejected')
+                return finish('rejected');
+            const s = steps[task.step];
+            if (s.mode === 'all') {
+                const left = await tx.selectFrom('flow.approval_task').select('id')
+                    .where('instance_id', '=', inst.id).where('step', '=', task.step).where('status', '=', 'pending').execute();
+                if (left.length > 0)
+                    return { finished: false };
+            }
+            else {
+                await tx.updateTable('flow.approval_task').set({ status: 'skipped' })
+                    .where('instance_id', '=', inst.id).where('step', '=', task.step).where('status', '=', 'pending').execute();
+            }
+            const nextIndex = task.step + 1;
+            if (nextIndex >= steps.length)
+                return finish('approved');
+            await tx.updateTable('flow.approval_instance').set({ current_step: nextIndex, last_approver: userId, updated_at: sql `now()` }).where('id', '=', inst.id).execute();
+            await this.openStep(tx, inst.id, tenantId, steps, nextIndex, inst.vars);
+            return { finished: false };
+        });
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"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"}

package/dist/http.d.ts

@@ -0,0 +1,8 @@
+import { type Ctx, type Kernel } from '@yss123/cage-kernel';
+import type { FastifyInstance } from 'fastify';
+import type { InCodeEngine } from './engine.js';
+export declare function approvalRoutes(app: FastifyInstance, opts: {
+    kernel: Kernel;
+    engines: InCodeEngine[];
+    ctxOf: (req: any) => Ctx;
+}): void;

package/dist/http.js

@@ -0,0 +1,33 @@
+// 待办接口：GET /api/approval/tasks、POST /api/approval/tasks/:id/approve|reject
+import { cageError } from '@yss123/cage-kernel';
+export function approvalRoutes(app, opts) {
+    const user = (req) => {
+        const ctx = opts.ctxOf(req);
+        if (!ctx.actor || ctx.actor.kind !== 'user' || !ctx.userId)
+            throw cageError('UNAUTHENTICATED');
+        return ctx;
+    };
+    app.get('/api/approval/tasks', async (req) => {
+        const ctx = user(req);
+        const status = req.query?.status ?? 'pending';
+        const lists = await Promise.all(opts.engines.map((e) => e.tasksOf(ctx.userId, ctx.tenantId, status)));
+        return lists.flat().sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+    });
+    for (const outcome of ['approve', 'reject']) {
+        app.post(`/api/approval/tasks/:id/${outcome}`, async (req) => {
+            const ctx = user(req);
+            const id = req.params.id;
+            if (!/^[0-9a-f-]{36}$/i.test(id))
+                throw cageError('NOT_FOUND');
+            const comment = typeof req.body?.comment === 'string' ? String(req.body.comment).slice(0, 1000) : undefined;
+            for (const e of opts.engines) {
+                const owns = await opts.kernel.app.selectFrom('flow.approval_task as t').innerJoin('flow.approval_instance as i', 'i.id', 't.instance_id')
+                    .select('t.id').where('t.id', '=', id).where('i.process', '=', e.route.process).executeTakeFirst();
+                if (owns)
+                    return e.decide(id, ctx.userId, ctx.tenantId, outcome === 'approve' ? 'approved' : 'rejected', comment);
+            }
+            throw cageError('NOT_FOUND');
+        });
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,OAAO,EAAE,SAAS,EAAyB,MAAM,qBAAqB,CAAC;AAIvE,MAAM,UAAU,cAAc,CAAC,GAAoB,EAAE,IAA2E;IAC9H,MAAM,IAAI,GAAG,CAAC,GAAQ,EAAE,EAAE;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM;YAAE,MAAM,SAAS,CAAC,iBAAiB,CAAC,CAAC;QAC/F,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IACF,GAAG,CAAC,GAAG,CAAC,qBAAqB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QACtB,MAAM,MAAM,GAAI,GAAG,CAAC,KAAa,EAAE,MAAM,IAAI,SAAS,CAAC;QACvD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAO,EAAE,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QACvG,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IACH,KAAK,MAAM,OAAO,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAU,EAAE,CAAC;QACrD,GAAG,CAAC,IAAI,CAAC,2BAA2B,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;YACtB,MAAM,EAAE,GAAI,GAAG,CAAC,MAAc,CAAC,EAAY,CAAC;YAC5C,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAAE,MAAM,SAAS,CAAC,WAAW,CAAC,CAAC;YAC/D,MAAM,OAAO,GAAG,OAAQ,GAAG,CAAC,IAAY,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAE,GAAG,CAAC,IAAY,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC9H,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBAC7B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,yBAAyB,CAAC,CAAC,SAAS,CAAC,6BAA6B,EAAE,MAAM,EAAE,eAAe,CAAC;qBACvI,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,gBAAgB,EAAE,CAAC;gBACrG,IAAI,IAAI;oBAAE,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,MAAO,EAAE,GAAG,CAAC,QAAQ,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACrH,CAAC;YACD,MAAM,SAAS,CAAC,WAAW,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './types.js';
+export { applyOutcome, bindApproval } from './bridge.js';
+export { route, step, when, approver, gt, gte, lt, lte, eq, ne, isIn, evalCondition, resolveSteps, FLOW_DDL, type Route, type RouteNode, type Step, type When, type Approver, type Condition, } from './route.js';
+export { InCodeEngine, type TaskView } from './engine.js';
+export { approvalRoutes } from './http.js';

package/dist/index.js

@@ -0,0 +1,7 @@
+// @yss123/cage-approval（可选）：审批适配接口、桥接与代码内封闭路由。
+export * from './types.js';
+export { applyOutcome, bindApproval } from './bridge.js';
+export { route, step, when, approver, gt, gte, lt, lte, eq, ne, isIn, evalCondition, resolveSteps, FLOW_DDL, } from './route.js';
+export { InCodeEngine } from './engine.js';
+export { approvalRoutes } from './http.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EACL,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,YAAY,EAAE,QAAQ,GAEnG,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAiB,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/route.d.ts

@@ -0,0 +1,74 @@
+import { ROUTE, SYSTEM_DDL, type Kernel } from '@yss123/cage-kernel';
+import { InCodeEngine } from './engine.js';
+export type Approver = {
+    kind: 'deptLeader';
+    field: string;
+} | {
+    kind: 'role';
+    code: string;
+} | {
+    kind: 'user';
+    userId: string;
+};
+/** 审批人组合子 */
+export declare const approver: {
+    /** 单据某个部门字段对应部门的负责人 */
+    deptLeader: (field: string) => Approver;
+    /** 拥有某角色的所有用户 */
+    role: (code: string) => Approver;
+    /** 指定用户 */
+    user: (userId: string) => Approver;
+};
+export type Condition = {
+    op: 'gt' | 'gte' | 'lt' | 'lte';
+    field: string;
+    value: number;
+} | {
+    op: 'eq' | 'ne';
+    field: string;
+    value: string | number | boolean;
+} | {
+    op: 'in';
+    field: string;
+    value: (string | number)[];
+};
+export declare const gt: (field: string, value: number) => Condition;
+export declare const gte: (field: string, value: number) => Condition;
+export declare const lt: (field: string, value: number) => Condition;
+export declare const lte: (field: string, value: number) => Condition;
+export declare const eq: (field: string, value: string | number | boolean) => Condition;
+export declare const ne: (field: string, value: string | number | boolean) => Condition;
+export declare const isIn: (field: string, value: (string | number)[]) => Condition;
+export interface Step {
+    kind: 'step';
+    title: string;
+    approver: Approver;
+    /** any：任意一人通过即可（或签）；all：全部通过（会签） */
+    mode: 'any' | 'all';
+}
+export interface When {
+    kind: 'when';
+    cond: Condition;
+    steps: Step[];
+}
+export type RouteNode = Step | When;
+export declare function step(title: string, who: Approver, opts?: {
+    mode?: 'any' | 'all';
+}): Step;
+export declare function when(cond: Condition, ...steps: Step[]): When;
+export declare function evalCondition(c: Condition, vars: Record<string, unknown>): boolean;
+/** 按流程变量展开出实际要走的步骤 */
+export declare function resolveSteps(nodes: readonly RouteNode[], vars: Record<string, unknown>): Step[];
+export interface Route {
+    readonly [ROUTE]: true;
+    readonly process: string;
+    readonly nodes: readonly RouteNode[];
+    /** 路由条件和审批人用到的字段（进入本体图的 uses 边） */
+    readonly fieldsUsed: readonly string[];
+    /** 代码内引擎（worker 与 HTTP 层使用） */
+    readonly engine: (k: Kernel) => InCodeEngine;
+    readonly [SYSTEM_DDL]: () => string;
+}
+export declare function route(process: string, nodes: RouteNode[]): Route;
+/** 代码内引擎自己的表，放在 flow 模式；引擎没有业务表的写权限 */
+export declare const FLOW_DDL = "\nCREATE TABLE IF NOT EXISTS flow.approval_instance (\n  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),\n  tenant_id uuid NOT NULL,\n  process text NOT NULL,\n  aggregate text NOT NULL,\n  business_key uuid NOT NULL,\n  vars jsonb NOT NULL,\n  steps jsonb NOT NULL,\n  current_step int NOT NULL DEFAULT 0,\n  status text NOT NULL DEFAULT 'running',\n  last_approver uuid,\n  created_at timestamptz NOT NULL DEFAULT now(),\n  updated_at timestamptz NOT NULL DEFAULT now()\n);\nCREATE INDEX IF NOT EXISTS approval_instance_key_idx ON flow.approval_instance (tenant_id, business_key, status);\nCREATE TABLE IF NOT EXISTS flow.approval_task (\n  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),\n  instance_id uuid NOT NULL REFERENCES flow.approval_instance(id),\n  tenant_id uuid NOT NULL,\n  step int NOT NULL,\n  title text NOT NULL,\n  assignee uuid NOT NULL,\n  status text NOT NULL DEFAULT 'pending',\n  comment text,\n  decided_at timestamptz,\n  created_at timestamptz NOT NULL DEFAULT now()\n);\nCREATE INDEX IF NOT EXISTS approval_task_assignee_idx ON flow.approval_task (tenant_id, assignee, status);\nGRANT SELECT, INSERT, UPDATE ON flow.approval_instance, flow.approval_task TO cage_app;\n";

package/dist/route.js

@@ -0,0 +1,116 @@
+// 代码内封闭路由：一小组固定的组合子（step、when、gt、approver.*），和范围组合子一样只能从里面选，
+// 所以抽取器能读懂：改 amount 的口径时，影响分析会把这条路由列出来。
+import { ROUTE, SYSTEM_DDL, declError } from '@yss123/cage-kernel';
+import { InCodeEngine } from './engine.js';
+/** 审批人组合子 */
+export const approver = {
+    /** 单据某个部门字段对应部门的负责人 */
+    deptLeader: (field) => ({ kind: 'deptLeader', field }),
+    /** 拥有某角色的所有用户 */
+    role: (code) => ({ kind: 'role', code }),
+    /** 指定用户 */
+    user: (userId) => ({ kind: 'user', userId }),
+};
+export const gt = (field, value) => ({ op: 'gt', field, value });
+export const gte = (field, value) => ({ op: 'gte', field, value });
+export const lt = (field, value) => ({ op: 'lt', field, value });
+export const lte = (field, value) => ({ op: 'lte', field, value });
+export const eq = (field, value) => ({ op: 'eq', field, value });
+export const ne = (field, value) => ({ op: 'ne', field, value });
+export const isIn = (field, value) => ({ op: 'in', field, value });
+export function step(title, who, opts = {}) {
+    return { kind: 'step', title, approver: who, mode: opts.mode ?? 'any' };
+}
+export function when(cond, ...steps) {
+    return { kind: 'when', cond, steps };
+}
+export function evalCondition(c, vars) {
+    const v = vars[c.field];
+    switch (c.op) {
+        case 'gt': return Number(v) > c.value;
+        case 'gte': return Number(v) >= c.value;
+        case 'lt': return Number(v) < c.value;
+        case 'lte': return Number(v) <= c.value;
+        case 'eq': return String(v) === String(c.value);
+        case 'ne': return String(v) !== String(c.value);
+        case 'in': return c.value.map(String).includes(String(v));
+        default: return false;
+    }
+}
+/** 按流程变量展开出实际要走的步骤 */
+export function resolveSteps(nodes, vars) {
+    const out = [];
+    for (const n of nodes) {
+        if (n.kind === 'step')
+            out.push(n);
+        else if (evalCondition(n.cond, vars))
+            out.push(...n.steps);
+    }
+    return out;
+}
+const engines = new WeakMap();
+export function route(process, nodes) {
+    if (!/^[a-z][a-z0-9-]*$/.test(process))
+        throw declError('CAGE-APPR-005', `流程名 ${process} 必须是小写短横线`);
+    if (nodes.length === 0)
+        throw declError('CAGE-APPR-006', `流程 ${process} 至少需要一个步骤`);
+    const fields = new Set();
+    for (const n of nodes) {
+        const steps = n.kind === 'step' ? [n] : n.steps;
+        if (n.kind === 'when')
+            fields.add(n.cond.field);
+        for (const s of steps)
+            if (s.approver.kind === 'deptLeader')
+                fields.add(s.approver.field);
+    }
+    const r = Object.freeze({
+        [ROUTE]: true,
+        process,
+        nodes: Object.freeze([...nodes]),
+        fieldsUsed: Object.freeze([...fields]),
+        engine: (k) => {
+            let m = engines.get(k);
+            if (!m)
+                engines.set(k, (m = new Map()));
+            let e = m.get(process);
+            if (!e)
+                m.set(process, (e = new InCodeEngine(k, r)));
+            return e;
+        },
+        [SYSTEM_DDL]: () => FLOW_DDL,
+    });
+    return r;
+}
+/** 代码内引擎自己的表，放在 flow 模式；引擎没有业务表的写权限 */
+export const FLOW_DDL = `
+CREATE TABLE IF NOT EXISTS flow.approval_instance (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  tenant_id uuid NOT NULL,
+  process text NOT NULL,
+  aggregate text NOT NULL,
+  business_key uuid NOT NULL,
+  vars jsonb NOT NULL,
+  steps jsonb NOT NULL,
+  current_step int NOT NULL DEFAULT 0,
+  status text NOT NULL DEFAULT 'running',
+  last_approver uuid,
+  created_at timestamptz NOT NULL DEFAULT now(),
+  updated_at timestamptz NOT NULL DEFAULT now()
+);
+CREATE INDEX IF NOT EXISTS approval_instance_key_idx ON flow.approval_instance (tenant_id, business_key, status);
+CREATE TABLE IF NOT EXISTS flow.approval_task (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  instance_id uuid NOT NULL REFERENCES flow.approval_instance(id),
+  tenant_id uuid NOT NULL,
+  step int NOT NULL,
+  title text NOT NULL,
+  assignee uuid NOT NULL,
+  status text NOT NULL DEFAULT 'pending',
+  comment text,
+  decided_at timestamptz,
+  created_at timestamptz NOT NULL DEFAULT now()
+);
+CREATE INDEX IF NOT EXISTS approval_task_assignee_idx ON flow.approval_task (tenant_id, assignee, status);
+GRANT SELECT, INSERT, UPDATE ON flow.approval_instance, flow.approval_task TO cage_app;
+`;
+//# sourceMappingURL=route.js.map

package/dist/route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.js","sourceRoot":"","sources":["../src/route.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,15 @@
+import type { ApprovalEngine } from '@yss123/cage-kernel/worker';
+export interface ApprovalOutcome {
+    process: string;
+    tenantId: string;
+    /** 单据 id */
+    businessKey: string;
+    outcome: 'approved' | 'rejected';
+    /** 最后一位审批人：结论命令以流程身份执行，代表这个人（职责分离、额度按他判断） */
+    lastApprover: string;
+}
+export interface ApprovalAdapter extends ApprovalEngine {
+    /** 注册流程结束回调 */
+    onCompleted(cb: (r: ApprovalOutcome) => Promise<void>): void;
+}
+export type { ApprovalEngine };

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,44 @@
 {
   "name": "@yss123/cage-approval",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "审批适配接口、桥接与代码内封闭路由（可选）",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "fastify": "^5.6.0",
+    "kysely": "^0.28.5",
+    "zod": "^4.1.5",
+    "@yss123/cage-kernel": "0.1.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shunshunyue/cage.git",
+    "directory": "packages/approval"
+  },
+  "homepage": "https://github.com/shunshunyue/cage#readme",
+  "bugs": {
+    "url": "https://github.com/shunshunyue/cage/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }