@yss123/cage-testkit 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-testkit
 
-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.
+派生测试运行器、fake 仓储、测试数据库
+
+Cage 是通过 TypeScript 声明业务、由框架统一执行权限和数据规则的中后台框架。此包是框架的一部分。
+
+## 使用
+
+```powershell
+pnpm add -D @yss123/cage-testkit
+```
+
+首次使用建议通过脚手架创建完整项目，所需依赖由模板统一配置。需要 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/derived.d.ts

@@ -0,0 +1,34 @@
+import { type CallResult, type TestEnv } from './env.js';
+export type Skip = 'skip';
+export declare const SKIP: Skip;
+export interface Derived {
+    env(): TestEnv;
+    setup(): Promise<void>;
+    teardown(): Promise<void>;
+    capabilityDenied(cap: string): Promise<CallResult | Skip>;
+    invalidTransition(cap: string, state: string): Promise<CallResult | Skip>;
+    auditOnce(cap: string): Promise<{
+        rows: number;
+    } | Skip>;
+    idempotent(cap: string): Promise<{
+        same: boolean;
+        rows: number;
+    } | Skip>;
+    scopeHidden(agg: string, combinator: 'self' | 'dept'): Promise<{
+        get: string;
+        listed: boolean;
+        rawVisible: boolean;
+        baseDenied: boolean;
+    } | Skip>;
+    outOfScopeWrite(cap: string): Promise<CallResult | Skip>;
+    masked(agg: string): Promise<{
+        field: string;
+        plain: unknown;
+        seen: unknown;
+    }[] | Skip>;
+    invariantsHold(agg: string, runs?: number): Promise<{
+        steps: number;
+        violations: string[];
+    } | Skip>;
+}
+export declare function derived(domain: object): Derived;

package/dist/derived.js

@@ -0,0 +1,259 @@
+// 派生测试运行时：cage test 生成的测试文件调用这里。它们不是测 handler，而是持续证明「笼子没有洞」：
+// 如果有人把内核的能力判定改坏了，或者某个路由绕过了内核，这一批测试会同时失败。
+import { randomUUID } from 'node:crypto';
+import { rowToSnapshot } from '@yss123/cage-kernel/db';
+import { systemCtx } from '@yss123/cage-kernel';
+import { sql } from 'kysely';
+import { z } from 'zod';
+import { createTestEnv } from './env.js';
+import { sampleValue } from './fakes.js';
+export const SKIP = 'skip';
+function sampleJson(s) {
+    if (!s || typeof s !== 'object')
+        return null;
+    if (s.const !== undefined)
+        return s.const;
+    if (s.enum)
+        return s.enum[0];
+    if (s.anyOf)
+        return sampleJson(s.anyOf.find((x) => x.type !== 'null') ?? s.anyOf[0]);
+    switch (Array.isArray(s.type) ? s.type.find((t) => t !== 'null') : s.type) {
+        case 'string':
+            if (s.format === 'uuid')
+                return randomUUID();
+            if (s.format === 'email')
+                return 'someone@example.com';
+            if (s.format === 'date-time')
+                return new Date().toISOString();
+            if (s.pattern)
+                return s.pattern.includes('\\d') ? '100.00' : 'a';
+            return 'x'.repeat(Math.max(1, s.minLength ?? 1));
+        case 'integer':
+        case 'number':
+            return Math.max(1, s.minimum ?? 1);
+        case 'boolean':
+            return false;
+        case 'array':
+            return Array.from({ length: Math.max(1, s.minItems ?? 1) }, () => sampleJson(s.items));
+        case 'object':
+            return Object.fromEntries(Object.entries(s.properties ?? {}).filter(([k]) => (s.required ?? []).includes(k)).map(([k, v]) => [k, sampleJson(v)]));
+        default:
+            return null;
+    }
+}
+export function derived(domain) {
+    let env;
+    const rc = (cap) => {
+        const c = env.kernel.registry.command(cap);
+        if (!c)
+            throw new Error(`没有命令 ${cap}`);
+        return c;
+    };
+    const agg = (name) => env.kernel.registry.aggregate(name);
+    async function refValue(target) {
+        if (target === 'Dept')
+            return env.rootDeptId;
+        if (target === 'User')
+            return (await env.user({ caps: [] })).id;
+        return (await env.insert(target)).id;
+    }
+    /** 构造一份合法输入：id 取种子数据；聚合同名字段取种子值或示例值；其他按 schema 造 */
+    async function sampleInput(c, seeded) {
+        const schema = c.cmd.input;
+        if (!(schema instanceof z.ZodObject))
+            return null;
+        let js = {};
+        try {
+            js = z.toJSONSchema(schema, { io: 'input', unrepresentable: 'any' });
+        }
+        catch {
+            js = {};
+        }
+        const fields = c.cmd.agg.fields;
+        const out = {};
+        for (const key of Object.keys(schema.shape)) {
+            const required = (js.required ?? []).includes(key);
+            if (key === 'id' && seeded)
+                out.id = seeded.id;
+            else if (seeded && key in seeded && seeded[key] !== null && seeded[key] !== undefined)
+                out[key] = seeded[key];
+            else if (key in fields) {
+                const f = fields[key];
+                if (f.isOptional && !required)
+                    continue;
+                out[key] = f.ref ? await refValue(f.ref) : sampleValue(f, key);
+            }
+            else if (required)
+                out[key] = sampleJson(js.properties?.[key]);
+        }
+        return schema.safeParse(out).success ? out : null;
+    }
+    /** 拥有全部能力、范围为全部的执行者；流程或外部专用命令用对应的系统身份 */
+    async function powerActor(c) {
+        if (c.cmd.invokedBy.includes('user'))
+            return (await env.user({ caps: 'all', scopes: { '*': 'all' } })).ctx();
+        const kind = c.cmd.invokedBy[0];
+        return systemCtx({ kind, name: 'derived-test', tenantId: env.tenantId, capabilities: [c.capability], onBehalfOf: (await env.user({ caps: [] })).id });
+    }
+    return {
+        env: () => env,
+        async setup() {
+            env = await createTestEnv({ domain });
+        },
+        async teardown() {
+            await env?.close();
+        },
+        async capabilityDenied(cap) {
+            const c = rc(cap);
+            if (!c.cmd.invokedBy.includes('user'))
+                return SKIP;
+            const seeded = c.cmd.from === 'new' ? null : await env.seedFor(cap);
+            const input = await sampleInput(c, seeded);
+            if (input === null)
+                return SKIP;
+            return env.callAs(await env.actorWithout(cap), cap, input);
+        },
+        async invalidTransition(cap, state) {
+            const c = rc(cap);
+            const seeded = await env.insert(c.cmd.agg, { status: state });
+            const input = await sampleInput(c, seeded);
+            if (input === null)
+                return SKIP;
+            return env.callAs(await powerActor(c), cap, input);
+        },
+        async auditOnce(cap) {
+            const c = rc(cap);
+            const seeded = c.cmd.from === 'new' ? null : await env.seedFor(cap);
+            const input = await sampleInput(c, seeded);
+            if (input === null)
+                return SKIP;
+            const r = await env.callAs(await powerActor(c), cap, input);
+            if (!r.ok)
+                return SKIP; // 业务规则拒绝了示例数据：没法走到成功路径
+            const rows = await env.audit({ aggregateId: r.data.id, command: cap, kind: 'write' });
+            return { rows: rows.length };
+        },
+        async idempotent(cap) {
+            const c = rc(cap);
+            if (!c.cmd.invokedBy.includes('user'))
+                return SKIP;
+            const seeded = c.cmd.from === 'new' ? null : await env.seedFor(cap);
+            const input = await sampleInput(c, seeded);
+            if (input === null)
+                return SKIP;
+            const ctx = { ...(await powerActor(c)), idempotencyKey: randomUUID() };
+            const [a, b] = await Promise.all([env.callAs(ctx, cap, input), env.callAs(ctx, cap, input)]);
+            if (!a.ok || !b.ok)
+                return SKIP;
+            const rows = await env.audit({ aggregateId: a.data.id, command: cap, kind: 'write' });
+            return { same: a.data.id === b.data.id && a.data.version === b.data.version, rows: rows.length };
+        },
+        async scopeHidden(aggName, combinator) {
+            const a = agg(aggName);
+            if (combinator === 'self' && !a.scope.ownerField)
+                return SKIP;
+            if (combinator === 'dept' && (!a.scope.deptField || a.scope.deptField === 'id'))
+                return SKIP;
+            const deptA = await env.dept(`derived-a-${randomUUID().slice(0, 6)}`);
+            const deptB = await env.dept(`derived-b-${randomUUID().slice(0, 6)}`);
+            const owner = await env.user({ caps: [], deptId: deptA });
+            const rec = await env.insert(a, { ownerId: owner.id, ...(a.scope.deptField && a.scope.deptField !== 'id' ? { [a.scope.deptField]: deptA } : {}) });
+            const other = await env.user({ caps: [`${aggName}.read`], scopes: { [aggName]: combinator }, deptId: deptB });
+            const ctx = await other.ctx();
+            let get = 'ok';
+            try {
+                await env.kernel.read.get(a, rec.id, ctx);
+            }
+            catch (e) {
+                get = e.code ?? 'ERROR';
+            }
+            const list = await env.kernel.read.list(a, { pageSize: 200 }, ctx);
+            const db = await env.readConnectionAs(ctx);
+            const raw = await sql `select id from ${sql.table(`safe.${a.table.name}`)}`.execute(db);
+            let baseDenied = false;
+            try {
+                await sql `select 1 from ${sql.table(`${a.table.schema}.${a.table.name}`)}`.execute(db);
+            }
+            catch (e) {
+                baseDenied = /permission denied/.test(String(e));
+            }
+            await db.release();
+            return { get, listed: list.items.some((x) => x.id === rec.id), rawVisible: raw.rows.some((r) => r.id === rec.id), baseDenied };
+        },
+        async outOfScopeWrite(cap) {
+            const c = rc(cap);
+            if (c.cmd.from === 'new' || !c.cmd.invokedBy.includes('user') || !c.cmd.agg.scope.ownerField)
+                return SKIP;
+            const owner = await env.user({ caps: [] });
+            const seeded = await env.seedFor(cap, { ownerId: owner.id });
+            const input = await sampleInput(c, seeded);
+            if (input === null)
+                return SKIP;
+            const other = await env.user({ caps: 'all', scopes: { [c.cmd.agg.name]: 'self' } });
+            return env.callAs(await other.ctx(), cap, input);
+        },
+        async masked(aggName) {
+            const a = agg(aggName);
+            const sens = Object.entries(a.fields).filter(([, f]) => f.sensitiveKind);
+            if (sens.length === 0)
+                return SKIP;
+            const values = Object.fromEntries(sens.map(([k, f]) => [k, sampleValue(f, k, true)]));
+            const rec = await env.insert(a, values);
+            const reader = await env.user({ caps: [`${aggName}.read`], scopes: { [aggName]: 'all' } });
+            const got = await env.kernel.read.get(a, rec.id, await reader.ctx());
+            return sens.map(([k]) => ({ field: k, plain: values[k], seen: got[k] }));
+        },
+        async invariantsHold(aggName, runs = 8) {
+            const a = agg(aggName);
+            const names = Object.keys(a.invariants);
+            if (names.length === 0)
+                return SKIP;
+            const cmds = env.kernel.registry.commands.filter((c) => c.cmd.agg === a);
+            const violations = [];
+            let steps = 0;
+            for (let run = 0; run < runs; run++) {
+                // 随机命令序列：每一步之后，库里的数据都必须满足所有不变量
+                let rec = null;
+                const creators = cmds.filter((c) => c.cmd.from === 'new');
+                if (creators.length) {
+                    const c = creators[run % creators.length];
+                    const input = await sampleInput(c, null);
+                    if (input) {
+                        const r = await env.callAs(await powerActor(c), c.capability, input);
+                        if (r.ok)
+                            rec = r.data;
+                    }
+                }
+                rec ??= await env.insert(a);
+                for (let i = 0; i < 4; i++) {
+                    const options = cmds.filter((c) => c.cmd.from !== 'new' && c.cmd.from.includes(rec.status));
+                    if (options.length === 0)
+                        break;
+                    const c = options[Math.floor(Math.random() * options.length)];
+                    const input = await sampleInput(c, rec);
+                    if (!input)
+                        continue;
+                    const r = await env.callAs(await powerActor(c), c.capability, input);
+                    steps++;
+                    const [row] = await env.query(`select * from "${a.table.schema}"."${a.table.name}" where id = $1`, [rec.id]);
+                    const snap = rowToSnapshot(a, row);
+                    for (const n of names) {
+                        let ok = false;
+                        try {
+                            ok = !!a.invariants[n](snap);
+                        }
+                        catch {
+                            ok = false;
+                        }
+                        if (!ok)
+                            violations.push(`${c.capability} 之后 ${aggName}.${n} 不成立`);
+                    }
+                    if (r.ok)
+                        rec = { ...rec, ...snap };
+                }
+            }
+            return { steps, violations };
+        },
+    };
+}
+//# sourceMappingURL=derived.js.map

package/dist/derived.js.map

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

package/dist/env.d.ts

@@ -0,0 +1,81 @@
+import { type AnyAggregate, type Ctx, type Kernel, type Logger } from '@yss123/cage-kernel';
+import { type MigrationFile } from '@yss123/cage-kernel/db';
+import { Kysely } from 'kysely';
+export type CallResult = {
+    ok: true;
+    data: Record<string, any>;
+    code?: undefined;
+} | {
+    ok: false;
+    code: string;
+    domainCode?: string;
+    detail?: unknown;
+    data?: undefined;
+};
+export interface TestUser {
+    id: string;
+    username: string;
+    roleId: string;
+    ctx(): Promise<Ctx>;
+}
+export interface TestEnv {
+    kernel: Kernel;
+    tenantId: string;
+    rootDeptId: string;
+    urls: {
+        super: string;
+        app: string;
+        read: string;
+        migrate: string;
+    };
+    /** 拥有全部能力的系统身份 */
+    system(): Ctx;
+    /** 以某个身份调用命令；永远不抛异常，返回 { ok, code } */
+    callAs(ctx: Ctx, capability: string, input: unknown): Promise<CallResult>;
+    /** 建一个部门 */
+    dept(name: string, parentId?: string): Promise<string>;
+    /** 建一个带角色的用户：caps 为能力点列表（或 'all'），scopes 为各聚合的组合子 */
+    user(opts: {
+        caps: string[] | 'all';
+        scopes?: Record<string, string | {
+            combinator: string;
+            deptIds?: string[];
+        }>;
+        deptId?: string;
+        params?: Record<string, Record<string, unknown>>;
+        username?: string;
+    }): Promise<TestUser>;
+    /** 有其他所有能力、唯独缺某个能力点的用户（范围为全部） */
+    actorWithout(capability: string): Promise<Ctx>;
+    /** 直接写入一条处在某状态的数据（测试捷径，绕过命令；只能在测试里用） */
+    insert(agg: AnyAggregate | string, values?: Record<string, unknown> & {
+        id?: string;
+        status?: string;
+        ownerId?: string;
+        deptId?: string;
+    }): Promise<Record<string, any>>;
+    /** 造一条处在某命令合法起始状态的数据 */
+    seedFor(capability: string, values?: Record<string, unknown> & {
+        ownerId?: string;
+    }): Promise<Record<string, any>>;
+    /** 以某人身份拿读侧连接（会话变量已设置），可以直接写裸 SQL */
+    readConnectionAs(ctx: Ctx): Promise<Kysely<any> & {
+        release(): Promise<void>;
+    }>;
+    /** 处理 outbox 直到为空 */
+    drain(): Promise<number>;
+    /** 审计记录（超级用户读取） */
+    audit(where?: {
+        aggregateId?: string;
+        command?: string;
+        kind?: string;
+    }): Promise<any[]>;
+    query(text: string, params?: unknown[]): Promise<any[]>;
+    close(): Promise<void>;
+}
+export declare function createTestEnv(opts: {
+    domain: object | object[];
+    /** 不传时直接按声明建表（不经过迁移文件） */
+    migrations?: MigrationFile[];
+    logger?: Logger;
+}): Promise<TestEnv>;

package/dist/env.js

@@ -0,0 +1,185 @@
+// 集成测试环境：每个测试文件一个临时库，执行初始化脚本、建表、重建安全层，返回内核和一组测试工具。
+import { randomBytes, randomUUID } from 'node:crypto';
+import { DEFAULT_TENANT, createKernel, isCageError, silentLogger, systemCtx, toCageError, } from '@yss123/cage-kernel';
+import { bootstrapSql, createTableSql, fieldsToColumns, runMigrations, schemaModel } from '@yss123/cage-kernel/db';
+import { createWorker } from '@yss123/cage-kernel/worker';
+import { Kysely, PostgresDialect, sql } from 'kysely';
+import pg from 'pg';
+import { sampleRecord } from './fakes.js';
+import { startEmbeddedPostgres, withDb } from './pg.js';
+import { setSessionVarsSql } from './session.js';
+let ownPg = null;
+async function superUrl() {
+    if (process.env.CAGE_TEST_SUPER_URL)
+        return process.env.CAGE_TEST_SUPER_URL;
+    if (process.env.CAGE_TEST_DATABASE_URL)
+        return process.env.CAGE_TEST_DATABASE_URL;
+    ownPg ??= await startEmbeddedPostgres();
+    process.env.CAGE_TEST_SUPER_URL = ownPg.superUrl;
+    return ownPg.superUrl;
+}
+export async function createTestEnv(opts) {
+    const su = await superUrl();
+    const dbName = `cage_t_${randomBytes(5).toString('hex')}`;
+    const pw = { app: 'cage_app_pw', read: 'cage_read_pw', migrate: 'cage_migrate_pw' };
+    const superDb = withDb(su, dbName);
+    const admin = new pg.Client({ connectionString: su });
+    await admin.connect();
+    try {
+        await admin.query(`CREATE DATABASE ${dbName}`);
+        // 角色属于集群；多个测试文件即使使用不同临时库，也会同时修改同一批角色。
+        // 咨询锁必须在共同的管理库上取得，在各自临时库上加锁无法互斥。
+        // 只串行化初始化阶段，后续业务测试仍并行；关闭 admin 连接自动释放会话锁。
+        await admin.query("select pg_advisory_lock(hashtext('cage:testkit:cluster-roles'))");
+        const boot = new pg.Client({ connectionString: superDb });
+        await boot.connect();
+        try {
+            await boot.query(bootstrapSql(pw, dbName));
+        }
+        finally {
+            await boot.end();
+        }
+    }
+    finally {
+        await admin.end();
+    }
+    const urls = {
+        super: superDb,
+        app: withDb(su, dbName, { name: 'cage_app', password: pw.app }),
+        read: withDb(su, dbName, { name: 'cage_read', password: pw.read }),
+        migrate: withDb(su, dbName, { name: 'cage_migrate', password: pw.migrate }),
+    };
+    const kernel = createKernel({ domain: opts.domain, urls: { app: urls.app, read: urls.read }, logger: opts.logger ?? silentLogger, poolSize: 5 });
+    if (!kernel.registry.command('Dept.create')) {
+        throw new Error("[CAGE-ORG-001] domain 没有包含组织模型：在 domain 的 index.ts 里加上 export * from '@yss123/cage-admin/domain'");
+    }
+    const model = schemaModel(kernel.registry);
+    const migrations = opts.migrations ?? [{ name: '0001_test_schema', sql: model.tables.map(createTableSql).join('\n\n') }];
+    await runMigrations({ migrateUrl: urls.migrate, registry: kernel.registry, migrations });
+    const tenantId = DEFAULT_TENANT;
+    const sys = () => systemCtx({ kind: 'system', name: 'test', tenantId, capabilities: kernel.catalogCaps() });
+    const root = await kernel.execute('Dept.create', { name: '总部', code: 'root' }, sys());
+    const superPool = new pg.Pool({ connectionString: superDb, max: 2 });
+    const worker = createWorker(kernel, { jobs: false });
+    const readers = [];
+    const callAs = async (ctx, capability, input) => {
+        try {
+            return { ok: true, data: await kernel.execute(capability, input, ctx) };
+        }
+        catch (e) {
+            const ce = toCageError(e);
+            if (!isCageError(e) && ce.code === 'INTERNAL')
+                throw e;
+            return { ok: false, code: ce.code, domainCode: ce.domainCode, detail: ce.detail };
+        }
+    };
+    const env = {
+        kernel,
+        tenantId,
+        rootDeptId: root.id,
+        urls,
+        system: sys,
+        callAs,
+        async dept(name, parentId) {
+            const d = await kernel.execute('Dept.create', { name, parentId: parentId ?? root.id }, sys());
+            return d.id;
+        },
+        async user(o) {
+            const s = sys();
+            const role = await kernel.execute('Role.create', { code: `r_${randomBytes(4).toString('hex')}`, name: 'test role' }, s);
+            const caps = o.caps === 'all' ? kernel.catalogCaps() : o.caps;
+            for (const c of caps)
+                await kernel.execute('Role.grantCapability', { id: role.id, capability: c, params: o.params?.[c] }, s);
+            for (const [agg, sc] of Object.entries(o.scopes ?? {})) {
+                const g = typeof sc === 'string' ? { combinator: sc } : sc;
+                await kernel.execute('Role.setScope', { id: role.id, aggregate: agg, ...g }, s);
+            }
+            const username = o.username ?? `u_${randomBytes(4).toString('hex')}`;
+            const u = await kernel.execute('User.create', { username, name: username, deptId: o.deptId ?? root.id }, s);
+            await kernel.execute('User.assignRoles', { id: u.id, roleIds: [role.id] }, s);
+            return {
+                id: u.id,
+                username,
+                roleId: role.id,
+                ctx: async () => (await kernel.contextFor(u.id, tenantId, { requestId: randomUUID() })),
+            };
+        },
+        async actorWithout(capability) {
+            const u = await env.user({ caps: kernel.catalogCaps().filter((c) => c !== capability), scopes: { '*': 'all' } });
+            return u.ctx();
+        },
+        async insert(aggRef, values = {}) {
+            const agg = typeof aggRef === 'string' ? kernel.registry.aggregate(aggRef) : aggRef;
+            const { status, ownerId, id: givenId, ...fields } = values;
+            const rec = sampleRecord(agg, fields);
+            if (agg.scope.ownerField)
+                rec[agg.scope.ownerField] = ownerId ?? fields[agg.scope.ownerField] ?? (await env.user({ caps: [] })).id;
+            if (agg.scope.deptField && agg.scope.deptField !== 'id' && fields[agg.scope.deptField] === undefined)
+                rec[agg.scope.deptField] = root.id;
+            // 引用字段：指向真实存在的记录（外键）
+            for (const [k, f] of Object.entries(agg.fields)) {
+                if (!f.ref || fields[k] !== undefined || k === agg.scope.ownerField || (k === agg.scope.deptField && rec[k]))
+                    continue;
+                if (f.isOptional) {
+                    rec[k] = null;
+                    continue;
+                }
+                rec[k] = f.ref === 'Dept' ? root.id : f.ref === 'User' ? (await env.user({ caps: [] })).id : (await env.insert(f.ref)).id;
+            }
+            const row = {
+                id: givenId ?? randomUUID(), tenant_id: tenantId, ...fieldsToColumns(agg, rec), status: status ?? agg.states.initial, version: 1,
+            };
+            await kernel.app.insertInto(`${agg.table.schema}.${agg.table.name}`).values(row).execute();
+            return { ...rec, id: row.id, status: row.status, version: 1 };
+        },
+        async seedFor(capability, values = {}) {
+            const rc = kernel.registry.command(capability);
+            if (!rc)
+                throw new Error(`没有命令 ${capability}`);
+            if (rc.cmd.from === 'new')
+                throw new Error(`${capability} 是新建命令，不需要种子数据`);
+            return env.insert(rc.cmd.agg, { status: rc.cmd.from[0], ...values });
+        },
+        async readConnectionAs(ctx) {
+            const pool = new pg.Pool({ connectionString: urls.read, max: 1, idleTimeoutMillis: 0 });
+            readers.push(pool);
+            const c = await pool.connect();
+            await c.query(setSessionVarsSql(ctx));
+            c.release();
+            const db = new Kysely({ dialect: new PostgresDialect({ pool }) });
+            db.release = async () => {
+                await db.destroy();
+            };
+            return db;
+        },
+        drain: () => worker.drain(),
+        async audit(where = {}) {
+            const cond = [];
+            const params = [];
+            if (where.aggregateId)
+                cond.push(`aggregate_id = $${params.push(where.aggregateId)}`);
+            if (where.command)
+                cond.push(`command = $${params.push(where.command)}`);
+            if (where.kind)
+                cond.push(`kind = $${params.push(where.kind)}`);
+            const r = await superPool.query(`select * from sys.audit_log ${cond.length ? 'where ' + cond.join(' and ') : ''} order by id`, params);
+            return r.rows;
+        },
+        async query(text, params = []) {
+            return (await superPool.query(text, params)).rows;
+        },
+        async close() {
+            await kernel.close();
+            for (const p of readers)
+                await p.end().catch(() => { });
+            await superPool.end();
+            const c = new pg.Client({ connectionString: su });
+            await c.connect();
+            await c.query(`DROP DATABASE IF EXISTS ${dbName} WITH (FORCE)`).catch(() => { });
+            await c.end();
+        },
+    };
+    void sql;
+    return env;
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

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

package/dist/fakes.d.ts

@@ -0,0 +1,21 @@
+import fc from 'fast-check';
+import type { AnyAggregate, AnyCommand, AnyField, Draft, ReadRepo } from '@yss123/cage-kernel';
+/** 字段的示例值：满足字段校验，便于构造草稿和种子数据 */
+export declare function sampleValue(f: AnyField, name?: string, force?: boolean): unknown;
+/** 字段的 fast-check 生成器：用于不变量的性质测试 */
+export declare function arbitraryOf(f: AnyField): fc.Arbitrary<unknown>;
+export declare function arbitrarySnapshot(agg: AnyAggregate): fc.Arbitrary<Record<string, unknown>>;
+/** 一条合法的示例记录（所有字段都有值） */
+export declare function sampleRecord(agg: AnyAggregate, overrides?: Record<string, unknown>): Record<string, any>;
+/**
+ * 构造命令 handler 的草稿：状态取命令的第一个起始状态（新建命令取目标状态）
+ *   const order = draftOf(approve, { items: [{ sku: 'A-01', qty: 10 }] })
+ */
+export declare function draftOf<C extends AnyCommand>(cmd: C, overrides?: Partial<Draft<C['agg']>>): Draft<C['agg']>;
+/** 内存只读仓储：等值条件查询，与内核的 ReadRepo 接口一致 */
+export declare function fakeRepo<A extends AnyAggregate = AnyAggregate>(rows: Record<string, any>[]): ReadRepo<A>;
+/** 直接调用 handler 时的第四个参数 */
+export declare function handlerCtx(actorUserId?: string | null): Readonly<{
+    now: Date;
+    actorUserId: string | null;
+}>;

package/dist/fakes.js

@@ -0,0 +1,129 @@
+// handler 单测工具：handler 不碰数据库，把读依赖换成内存假对象，直接调用函数。毫秒级。
+import { randomUUID } from 'node:crypto';
+import fc from 'fast-check';
+/** 字段的示例值：满足字段校验，便于构造草稿和种子数据 */
+export function sampleValue(f, name = '', force = false) {
+    if (f.isOptional && !force)
+        return null;
+    switch (f.kind) {
+        case 'text':
+            if (f.sensitiveKind === 'phone')
+                return '13800001234';
+            if (f.sensitiveKind === 'email')
+                return 'someone@example.com';
+            if (f.sensitiveKind === 'idCard')
+                return '110101199001011234';
+            if (f.sensitiveKind === 'bankCard')
+                return '6222020200001234567';
+            if (f.sensitiveKind === 'name')
+                return '张三';
+            return `${name || 'text'}-${randomUUID().slice(0, 8)}`.slice(0, f.max ?? 500);
+        case 'int':
+            return 1;
+        case 'number':
+            return 1;
+        case 'money':
+            return '100.00';
+        case 'id':
+        case 'ref':
+            return randomUUID();
+        case 'date':
+            return '2026-01-01';
+        case 'datetime':
+            return new Date('2026-01-01T00:00:00Z').toISOString();
+        case 'bool':
+            return false;
+        case 'enum':
+            return f.values?.[0];
+        case 'list':
+            if (!f.shape)
+                return {};
+            if ('item' in f.shape && Object.keys(f.shape).length === 1)
+                return [sampleValue(f.shape.item, 'item')];
+            return [Object.fromEntries(Object.entries(f.shape).map(([k, sf]) => [k, sampleValue(sf, k)]))];
+        default:
+            return null;
+    }
+}
+/** 字段的 fast-check 生成器：用于不变量的性质测试 */
+export function arbitraryOf(f) {
+    let a;
+    switch (f.kind) {
+        case 'text':
+            a = fc.string({ maxLength: Math.min(f.max ?? 500, 40) });
+            break;
+        case 'int':
+            a = fc.integer({ min: -1000, max: 100000 });
+            break;
+        case 'number':
+            a = fc.double({ min: -1e6, max: 1e6, noNaN: true });
+            break;
+        case 'money':
+            a = fc.integer({ min: -100000, max: 10_000_000 }).map((n) => (n / 100).toFixed(2));
+            break;
+        case 'id':
+        case 'ref':
+            a = fc.uuid();
+            break;
+        case 'bool':
+            a = fc.boolean();
+            break;
+        case 'enum':
+            a = fc.constantFrom(...(f.values ?? ['']));
+            break;
+        case 'list': {
+            const shape = f.shape ?? {};
+            if ('item' in shape && Object.keys(shape).length === 1)
+                a = fc.array(arbitraryOf(shape.item), { maxLength: 5 });
+            else
+                a = fc.array(fc.record(Object.fromEntries(Object.entries(shape).map(([k, sf]) => [k, arbitraryOf(sf)]))), { maxLength: 5 });
+            break;
+        }
+        default:
+            a = fc.constant(sampleValue(f));
+    }
+    return f.isOptional ? fc.option(a, { nil: null }) : a;
+}
+export function arbitrarySnapshot(agg) {
+    return fc.record(Object.fromEntries(Object.entries(agg.fields).map(([k, f]) => [k, arbitraryOf(f)])));
+}
+/** 一条合法的示例记录（所有字段都有值） */
+export function sampleRecord(agg, overrides = {}) {
+    const out = {};
+    for (const [k, f] of Object.entries(agg.fields))
+        out[k] = sampleValue(f, k);
+    return { ...out, ...overrides };
+}
+/**
+ * 构造命令 handler 的草稿：状态取命令的第一个起始状态（新建命令取目标状态）
+ *   const order = draftOf(approve, { items: [{ sku: 'A-01', qty: 10 }] })
+ */
+export function draftOf(cmd, overrides = {}) {
+    const now = new Date().toISOString();
+    const status = cmd.from === 'new' ? cmd.to : cmd.from[0];
+    return {
+        id: randomUUID(),
+        status,
+        version: 1,
+        createdAt: now,
+        updatedAt: now,
+        ...sampleRecord(cmd.agg),
+        ...overrides,
+    };
+}
+/** 内存只读仓储：等值条件查询，与内核的 ReadRepo 接口一致 */
+export function fakeRepo(rows) {
+    const match = (r, where) => Object.entries(where ?? {}).every(([k, v]) => v === undefined || JSON.stringify(r[k] ?? null) === JSON.stringify(v));
+    const clone = (r) => structuredClone(r);
+    return {
+        get: async (id) => clone(rows.find((r) => r.id === id) ?? null),
+        find: async (where, opts) => rows.filter((r) => match(r, where)).slice(0, opts?.limit ?? Infinity).map(clone),
+        findOne: async (where) => clone(rows.find((r) => match(r, where)) ?? null),
+        count: async (where) => rows.filter((r) => match(r, where)).length,
+    };
+}
+/** 直接调用 handler 时的第四个参数 */
+export function handlerCtx(actorUserId = randomUUID()) {
+    return Object.freeze({ now: new Date(), actorUserId });
+}
+//# sourceMappingURL=fakes.js.map

package/dist/fakes.js.map

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

package/dist/global-setup.d.ts

@@ -0,0 +1 @@
+export default function setup(): Promise<() => Promise<void>>;

package/dist/global-setup.js

@@ -0,0 +1,18 @@
+// Vitest globalSetup：整个测试运行只启动一个 PostgreSQL，每个测试文件各建一个临时库。
+//   // vitest.config.ts
+//   export default { test: { globalSetup: ['@yss123/cage-testkit/global-setup'] } }
+import { startEmbeddedPostgres } from './pg.js';
+let instance = null;
+export default async function setup() {
+    if (process.env.CAGE_TEST_DATABASE_URL) {
+        process.env.CAGE_TEST_SUPER_URL = process.env.CAGE_TEST_DATABASE_URL;
+        return async () => { };
+    }
+    instance = await startEmbeddedPostgres();
+    process.env.CAGE_TEST_SUPER_URL = instance.superUrl;
+    return async () => {
+        await instance?.stop();
+        instance = null;
+    };
+}
+//# sourceMappingURL=global-setup.js.map

package/dist/global-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-setup.js","sourceRoot":"","sources":["../src/global-setup.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,wBAAwB;AACxB,oFAAoF;AACpF,OAAO,EAAE,qBAAqB,EAAmB,MAAM,SAAS,CAAC;AAEjE,IAAI,QAAQ,GAAsB,IAAI,CAAC;AAEvC,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,KAAK;IACjC,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;QACrE,OAAO,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC;IACxB,CAAC;IACD,QAAQ,GAAG,MAAM,qBAAqB,EAAE,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,QAAQ,CAAC,QAAQ,CAAC;IACpD,OAAO,KAAK,IAAI,EAAE;QAChB,MAAM,QAAQ,EAAE,IAAI,EAAE,CAAC;QACvB,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { fakeRepo, draftOf, sampleValue, sampleRecord, arbitraryOf, arbitrarySnapshot, handlerCtx } from './fakes.js';
+export { createTestEnv, type TestEnv, type TestUser, type CallResult } from './env.js';
+export { startEmbeddedPostgres, withDb, freePort, type PgInstance } from './pg.js';
+export { setSessionVarsSql } from './session.js';
+export { derived, SKIP, type Derived, type Skip } from './derived.js';

package/dist/index.js

@@ -0,0 +1,7 @@
+// @yss123/cage-testkit：handler 单测工具、集成测试环境、派生测试运行时。
+export { fakeRepo, draftOf, sampleValue, sampleRecord, arbitraryOf, arbitrarySnapshot, handlerCtx } from './fakes.js';
+export { createTestEnv } from './env.js';
+export { startEmbeddedPostgres, withDb, freePort } from './pg.js';
+export { setSessionVarsSql } from './session.js';
+export { derived, SKIP } from './derived.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,oDAAoD;AACpD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtH,OAAO,EAAE,aAAa,EAAgD,MAAM,UAAU,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,EAAE,QAAQ,EAAmB,MAAM,SAAS,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,IAAI,EAA2B,MAAM,cAAc,CAAC"}

package/dist/pg.d.ts

@@ -0,0 +1,19 @@
+export interface PgInstance {
+    /** 超级用户连接串（指向 postgres 库） */
+    superUrl: string;
+    host: string;
+    port: number;
+    stop(): Promise<void>;
+}
+export declare function freePort(): Promise<number>;
+export declare function startEmbeddedPostgres(opts?: {
+    dir?: string;
+    port?: number;
+    persistent?: boolean;
+    log?: boolean;
+}): Promise<PgInstance>;
+/** 把超级用户连接串换成另一个库、另一个账号 */
+export declare function withDb(url: string, db: string, user?: {
+    name: string;
+    password: string;
+}): string;

package/dist/pg.js

@@ -0,0 +1,59 @@
+// 测试与本地开发用的 PostgreSQL：优先使用 CAGE_TEST_DATABASE_URL（超级用户连接串，例如 CI 里的服务容器），
+// 否则启动 embedded-postgres（npm 包自带真实的 PostgreSQL 二进制，不需要 Docker）。
+import { mkdtempSync, rmSync, existsSync, mkdirSync } from 'node:fs';
+import { createServer } from 'node:net';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+export async function freePort() {
+    return new Promise((resolve, reject) => {
+        const s = createServer();
+        s.unref();
+        s.on('error', reject);
+        s.listen(0, '127.0.0.1', () => {
+            const port = s.address().port;
+            s.close(() => resolve(port));
+        });
+    });
+}
+export async function startEmbeddedPostgres(opts = {}) {
+    const { default: EmbeddedPostgres } = await import('embedded-postgres');
+    const port = opts.port ?? (await freePort());
+    const persistent = opts.persistent ?? false;
+    const dir = opts.dir ?? mkdtempSync(join(tmpdir(), 'cage-pg-'));
+    const fresh = !existsSync(join(dir, 'PG_VERSION'));
+    if (persistent)
+        mkdirSync(dir, { recursive: true });
+    const pg = new EmbeddedPostgres({
+        databaseDir: dir,
+        user: 'postgres',
+        password: 'postgres',
+        port,
+        persistent,
+        onLog: opts.log ? (m) => process.stdout.write(m) : () => { },
+        onError: opts.log ? (m) => process.stderr.write(String(m)) : () => { },
+    });
+    if (fresh)
+        await pg.initialise();
+    await pg.start();
+    return {
+        superUrl: `postgres://postgres:postgres@127.0.0.1:${port}/postgres`,
+        host: '127.0.0.1',
+        port,
+        async stop() {
+            await pg.stop();
+            if (!persistent)
+                rmSync(dir, { recursive: true, force: true });
+        },
+    };
+}
+/** 把超级用户连接串换成另一个库、另一个账号 */
+export function withDb(url, db, user) {
+    const u = new URL(url);
+    u.pathname = `/${db}`;
+    if (user) {
+        u.username = user.name;
+        u.password = user.password;
+    }
+    return u.toString();
+}
+//# sourceMappingURL=pg.js.map

package/dist/pg.js.map

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

package/dist/session.d.ts

@@ -0,0 +1,2 @@
+import type { Ctx } from '@yss123/cage-kernel';
+export declare function setSessionVarsSql(ctx: Ctx): string;

package/dist/session.js

@@ -0,0 +1,14 @@
+import { scopesJson } from '@yss123/cage-kernel/db';
+const lit = (s) => `'${s.replace(/'/g, "''")}'`;
+export function setSessionVarsSql(ctx) {
+    const vars = [
+        ['app.user_id', ctx.userId ?? ctx.onBehalfOf ?? ''],
+        ['app.tenant_id', ctx.tenantId],
+        ['app.dept_id', ctx.deptId ?? ''],
+        ['app.dept_path', ctx.deptPath ?? ''],
+        ['app.scopes', scopesJson(ctx)],
+        ['app.unmask', ctx.unmask.join(',')],
+    ];
+    return `select ${vars.map(([k, v]) => `set_config(${lit(k)}, ${lit(v)}, false)`).join(', ')}`;
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;AAExD,MAAM,UAAU,iBAAiB,CAAC,GAAQ;IACxC,MAAM,IAAI,GAAuB;QAC/B,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC;QACnD,CAAC,eAAe,EAAE,GAAG,CAAC,QAAQ,CAAC;QAC/B,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;QACjC,CAAC,eAAe,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC;QACrC,CAAC,YAAY,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC;QAC/B,CAAC,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;KACrC,CAAC;IACF,OAAO,UAAU,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAChG,CAAC"}

package/package.json

@@ -1,6 +1,66 @@
 {
   "name": "@yss123/cage-testkit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "派生测试运行器、fake 仓储、测试数据库",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./global-setup": {
+      "types": "./dist/global-setup.d.ts",
+      "default": "./dist/global-setup.js"
+    },
+    "./pg": {
+      "types": "./dist/pg.d.ts",
+      "default": "./dist/pg.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "embedded-postgres": "18.3.0-beta.16",
+    "fast-check": "^4.3.0",
+    "kysely": "^0.28.5",
+    "pg": "^8.16.3",
+    "zod": "^4.1.5"
+  },
+  "peerDependencies": {
+    "@yss123/cage-kernel": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/pg": "^8.15.5",
+    "vitest": "^4.1.12",
+    "@yss123/cage-http": "0.1.0",
+    "@yss123/cage-kernel": "0.1.0",
+    "@yss123/cage-approval": "0.1.0",
+    "@yss123/cage-connectors": "0.1.0",
+    "@yss123/cage-admin": "0.1.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shunshunyue/cage.git",
+    "directory": "packages/testkit"
+  },
+  "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",
+    "test": "vitest run"
+  }
 }