@yss123/cage-http 0.0.0-stage → 0.2.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-http
 
-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.
+笼子 HTTP 层：Fastify 插件、路由生成、认证、安全基线
+
+Cage 是通过 TypeScript 声明业务、由框架统一执行权限和数据规则的中后台框架。此包是框架的一部分。
+
+## 使用
+
+```powershell
+pnpm add @yss123/cage-http
+```
+
+首次使用建议通过脚手架创建完整项目，所需依赖由模板统一配置。需要 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/auth.d.ts

@@ -0,0 +1,58 @@
+import { type Ctx, type Kernel } from '@yss123/cage-kernel';
+import type { FastifyInstance, FastifyReply, FastifyRequest } from 'fastify';
+import type { CtxCache } from './ctx.js';
+declare module 'fastify' {
+    interface FastifyRequest {
+        cageCtx: Ctx;
+        cageSession: {
+            id: string;
+            userId: string;
+            tenantId: string;
+            stepUpAt: number | null;
+        } | null;
+        rawBody?: string;
+    }
+}
+export declare const SESSION_COOKIE = "cage_sid";
+export interface AuthOptions {
+    /** 会话时长（小时），默认 8 */
+    sessionHours?: number;
+    /** cookie 只走 HTTPS；默认生产环境开启 */
+    cookieSecure?: boolean;
+    /** 是否开放账号密码登录，默认开启 */
+    password?: boolean;
+    oidc?: {
+        issuer: string;
+        clientId: string;
+        clientSecret: string;
+        redirectUri: string;
+        scope?: string;
+        deptClaim?: string;
+    };
+}
+export declare function verifyPassword(pw: string, stored: string | null | undefined): boolean;
+export declare class Sessions {
+    private readonly k;
+    private readonly hours;
+    constructor(k: Kernel, hours: number);
+    create(userId: string, tenantId: string, req: FastifyRequest): Promise<string>;
+    verify(sid: string): Promise<{
+        id: string;
+        userId: string;
+        tenantId: string;
+        stepUpAt: number | null;
+    } | null>;
+    destroy(sid: string): Promise<void>;
+    stepUp(sessionId: string): Promise<void>;
+}
+export declare function setSessionCookie(reply: FastifyReply, sid: string, opts: AuthOptions): void;
+/** 认证钩子：每个请求最先执行，把会话变成上下文 */
+export declare function registerAuthHook(app: FastifyInstance, k: Kernel, sessions: Sessions, cache: CtxCache): void;
+export declare function findLoginUser(k: Kernel, username: string, tenantId?: string): Promise<{
+    tenant_id: any;
+    id: any;
+    password_hash: any;
+    status: any;
+} | undefined>;
+export declare function csrfRoute(app: FastifyInstance): void;
+export declare function authRoutes(app: FastifyInstance, k: Kernel, sessions: Sessions, opts: AuthOptions): void;

package/dist/auth.js

@@ -0,0 +1,145 @@
+// 认证：服务端会话 + 会话 cookie。优先对接公司 SSO（OIDC，见 oidc.ts），没有 SSO 时用账号密码加二次认证。
+// 之后每个请求都由认证钩子把会话变成上下文 ctx。
+import { createHash, randomBytes, scryptSync, timingSafeEqual } from 'node:crypto';
+import { anonymousCtx, cageError, DEFAULT_TENANT } from '@yss123/cage-kernel';
+import { sql } from 'kysely';
+export const SESSION_COOKIE = 'cage_sid';
+const hashSid = (sid) => createHash('sha256').update(sid).digest('hex');
+export function verifyPassword(pw, stored) {
+    if (!stored) {
+        scryptSync(pw, 'timing-equalizer', 32); // 用户不存在时也做一次哈希，避免按耗时探测用户名
+        return false;
+    }
+    const [alg, salt, hash] = stored.split('$');
+    if (alg !== 'scrypt' || !salt || !hash)
+        return false;
+    const got = scryptSync(pw, salt, 32);
+    const want = Buffer.from(hash, 'hex');
+    return want.length === got.length && timingSafeEqual(got, want);
+}
+export class Sessions {
+    k;
+    hours;
+    constructor(k, hours) {
+        this.k = k;
+        this.hours = hours;
+    }
+    async create(userId, tenantId, req) {
+        const sid = randomBytes(32).toString('base64url');
+        await this.k.app
+            .insertInto('sys.session')
+            .values({
+            id: hashSid(sid), user_id: userId, tenant_id: tenantId, expires_at: new Date(Date.now() + this.hours * 3600_000),
+            ip: req.ip, user_agent: String(req.headers['user-agent'] ?? '').slice(0, 300),
+        })
+            .execute();
+        return sid;
+    }
+    async verify(sid) {
+        const row = await this.k.app.selectFrom('sys.session').selectAll().where('id', '=', hashSid(sid)).where('expires_at', '>', new Date()).executeTakeFirst();
+        return row ? { id: row.id, userId: row.user_id, tenantId: row.tenant_id, stepUpAt: row.step_up_at ? new Date(row.step_up_at).getTime() : null } : null;
+    }
+    async destroy(sid) {
+        await this.k.app.deleteFrom('sys.session').where('id', '=', hashSid(sid)).execute();
+    }
+    async stepUp(sessionId) {
+        await this.k.app.updateTable('sys.session').set({ step_up_at: sql `now()` }).where('id', '=', sessionId).execute();
+    }
+}
+export function setSessionCookie(reply, sid, opts) {
+    reply.setCookie(SESSION_COOKIE, sid, {
+        httpOnly: true, // 前端脚本读不到，防 XSS 窃取
+        secure: opts.cookieSecure ?? process.env.NODE_ENV === 'production',
+        sameSite: 'lax', // 防跨站请求伪造
+        path: '/',
+        maxAge: (opts.sessionHours ?? 8) * 3600,
+    });
+}
+/** 认证钩子：每个请求最先执行，把会话变成上下文 */
+export function registerAuthHook(app, k, sessions, cache) {
+    app.decorateRequest('cageCtx', null);
+    app.decorateRequest('cageSession', null);
+    app.addHook('onRequest', async (req) => {
+        const base = {
+            requestId: String(req.id),
+            client: { ip: req.ip, userAgent: String(req.headers['user-agent'] ?? '').slice(0, 300) },
+        };
+        req.cageCtx = anonymousCtx(DEFAULT_TENANT, base);
+        if (req.url.startsWith('/hooks/'))
+            return; // 第三方回调走签名验证，不走用户登录
+        const sid = req.cookies?.[SESSION_COOKIE];
+        if (!sid)
+            return;
+        const s = await sessions.verify(sid);
+        if (!s)
+            return;
+        const ctx = await cache.resolve(s.userId, s.tenantId);
+        if (!ctx)
+            return;
+        req.cageSession = s;
+        req.cageCtx = { ...ctx, ...base, stepUpAt: s.stepUpAt, source: 'api' };
+    });
+}
+export async function findLoginUser(k, username, tenantId = DEFAULT_TENANT) {
+    return k.app
+        .selectFrom('sys.user')
+        .select(['id', 'tenant_id', 'password_hash', 'status'])
+        .where('username', '=', username)
+        .where('tenant_id', '=', tenantId)
+        .executeTakeFirst();
+}
+export function csrfRoute(app) {
+    app.get('/auth/csrf', async (_req, reply) => ({ token: reply.generateCsrf() }));
+}
+export function authRoutes(app, k, sessions, opts) {
+    if (opts.password !== false) {
+        app.post('/auth/login', async (req, reply) => {
+            const body = (req.body ?? {});
+            if (typeof body.username !== 'string' || typeof body.password !== 'string')
+                throw cageError('INVALID_INPUT');
+            const u = await findLoginUser(k, body.username);
+            const ok = verifyPassword(body.password, u?.password_hash) && u?.status === 'active';
+            if (!u || !ok) {
+                await k.writeAudit(k.app, {
+                    tenantId: DEFAULT_TENANT, actor: u?.id ?? `anonymous:${body.username.slice(0, 64)}`, actorKind: 'anonymous', source: 'api',
+                    kind: 'denied', command: 'auth.login', result: 'UNAUTHENTICATED', requestId: String(req.id), client: { ip: req.ip },
+                }).catch(() => { });
+                throw cageError('UNAUTHENTICATED');
+            }
+            const sid = await sessions.create(u.id, u.tenant_id, req);
+            setSessionCookie(reply, sid, opts);
+            return { ok: true };
+        });
+        app.post('/auth/step-up', async (req) => {
+            if (!req.cageSession)
+                throw cageError('UNAUTHENTICATED');
+            const pw = req.body?.password;
+            const row = await k.app.selectFrom('sys.user').select('password_hash').where('id', '=', req.cageSession.userId).executeTakeFirst();
+            if (typeof pw !== 'string' || !verifyPassword(pw, row?.password_hash))
+                throw cageError('UNAUTHENTICATED');
+            await sessions.stepUp(req.cageSession.id);
+            return { ok: true };
+        });
+    }
+    app.post('/auth/logout', async (req, reply) => {
+        const sid = req.cookies?.[SESSION_COOKIE];
+        if (sid)
+            await sessions.destroy(sid);
+        reply.clearCookie(SESSION_COOKIE, { path: '/' });
+        return { ok: true };
+    });
+    app.get('/api/me', async (req) => {
+        const ctx = req.cageCtx;
+        if (!ctx.userId)
+            throw cageError('UNAUTHENTICATED');
+        const u = await k.app.selectFrom('sys.user').select(['id', 'username', 'name', 'dept_id']).where('id', '=', ctx.userId).executeTakeFirst();
+        return {
+            user: u ? { id: u.id, username: u.username, name: u.name, deptId: u.dept_id } : null,
+            tenantId: ctx.tenantId,
+            capabilities: [...ctx.capabilities.keys()].sort(),
+            scopes: ctx.scopes,
+            stepUpAt: ctx.stepUpAt ?? null,
+        };
+    });
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

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

package/dist/ctx.d.ts

@@ -0,0 +1,13 @@
+import type { Ctx, Kernel } from '@yss123/cage-kernel';
+export declare class CtxCache {
+    private readonly kernel;
+    private readonly cache;
+    private listener;
+    private stopped;
+    constructor(kernel: Kernel);
+    resolve(userId: string, tenantId: string): Promise<Ctx | null>;
+    invalidate(payload: string): void;
+    /** 进程启动时调用一次；连接断开后自动重连 */
+    listen(appUrl: string): Promise<void>;
+    close(): Promise<void>;
+}

package/dist/ctx.js

@@ -0,0 +1,57 @@
+import { LRUCache } from 'lru-cache';
+import pg from 'pg';
+export class CtxCache {
+    kernel;
+    cache = new LRUCache({ max: 5000, ttl: 5 * 60_000 });
+    listener = null;
+    stopped = false;
+    constructor(kernel) {
+        this.kernel = kernel;
+    }
+    async resolve(userId, tenantId) {
+        const key = `${tenantId}:${userId}`;
+        const hit = this.cache.get(key);
+        if (hit)
+            return hit;
+        const ctx = await this.kernel.contextFor(userId, tenantId);
+        if (ctx)
+            this.cache.set(key, ctx);
+        return ctx;
+    }
+    invalidate(payload) {
+        if (payload === '*')
+            this.cache.clear();
+        else
+            for (const k of [...this.cache.keys()])
+                if (k.endsWith(`:${payload}`))
+                    this.cache.delete(k);
+    }
+    /** 进程启动时调用一次；连接断开后自动重连 */
+    async listen(appUrl) {
+        const connect = async () => {
+            if (this.stopped)
+                return;
+            try {
+                const c = new pg.Client({ connectionString: appUrl, application_name: 'cage-grants-listen' });
+                await c.connect();
+                await c.query('LISTEN cage_grants');
+                c.on('notification', (n) => this.invalidate(n.payload ?? '*'));
+                c.on('error', () => {
+                    this.cache.clear();
+                    setTimeout(() => void connect(), 5000);
+                });
+                this.listener = c;
+            }
+            catch (e) {
+                this.kernel.log.warn({ err: String(e) }, '授权变更监听连接失败，5 秒后重试');
+                setTimeout(() => void connect(), 5000);
+            }
+        };
+        await connect();
+    }
+    async close() {
+        this.stopped = true;
+        await this.listener?.end().catch(() => { });
+    }
+}
+//# sourceMappingURL=ctx.js.map

package/dist/ctx.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { createServer, type ServerOptions, type CageServer } from './server.js';
+export { registerRoutes, routeTable, commandUrl, type RouteInfo } from './routes.js';
+export { buildOpenApi } from './openapi.js';
+export { buildLogger, sensitiveFieldPaths } from './logger.js';
+export { CtxCache } from './ctx.js';
+export { Sessions, verifyPassword, SESSION_COOKIE, type AuthOptions } from './auth.js';
+export { upsertUserFromSso } from './oidc.js';

package/dist/index.js

@@ -0,0 +1,9 @@
+// @yss123/cage-http：Fastify 插件、路由生成、认证、安全基线。
+export { createServer } from './server.js';
+export { registerRoutes, routeTable, commandUrl } from './routes.js';
+export { buildOpenApi } from './openapi.js';
+export { buildLogger, sensitiveFieldPaths } from './logger.js';
+export { CtxCache } from './ctx.js';
+export { Sessions, verifyPassword, SESSION_COOKIE } from './auth.js';
+export { upsertUserFromSso } from './oidc.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,6CAA6C;AAC7C,OAAO,EAAE,YAAY,EAAuC,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,EAAkB,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,cAAc,EAAoB,MAAM,WAAW,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,3 @@
+import type { Registry } from '@yss123/cage-kernel';
+export declare function sensitiveFieldPaths(reg: Registry): string[];
+export declare function buildLogger(reg: Registry): object;

package/dist/logger.js

@@ -0,0 +1,27 @@
+export function sensitiveFieldPaths(reg) {
+    const names = new Set();
+    for (const a of reg.aggregates) {
+        for (const [k, f] of Object.entries(a.fields))
+            if (f.sensitiveKind || f.isHidden)
+                names.add(k);
+    }
+    for (const e of reg.events) {
+        for (const [k, f] of Object.entries(e.fields))
+            if (f.sensitiveKind)
+                names.add(k);
+    }
+    return [...names].flatMap((n) => [`*.${n}`, `req.body.${n}`]);
+}
+export function buildLogger(reg) {
+    return {
+        level: process.env.LOG_LEVEL ?? 'info',
+        redact: {
+            paths: [
+                'req.headers.cookie', 'req.headers.authorization', 'req.headers["x-csrf-token"]', 'res.headers["set-cookie"]',
+                'req.body.password', '*.password', ...sensitiveFieldPaths(reg),
+            ],
+            censor: '***',
+        },
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,mBAAmB,CAAC,GAAa;IAC/C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;QAC/B,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAgB,CAAC;YAAE,IAAI,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,QAAQ;gBAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC3G,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QAC3B,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAgB,CAAC;YAAE,IAAI,CAAC,CAAC,aAAa;gBAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAa;IACvC,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;QACtC,MAAM,EAAE;YACN,KAAK,EAAE;gBACL,oBAAoB,EAAE,2BAA2B,EAAE,6BAA6B,EAAE,2BAA2B;gBAC7G,mBAAmB,EAAE,YAAY,EAAE,GAAG,mBAAmB,CAAC,GAAG,CAAC;aAC/D;YACD,MAAM,EAAE,KAAK;SACd;KACF,CAAC;AACJ,CAAC"}

package/dist/oidc.d.ts

@@ -0,0 +1,7 @@
+import { type Kernel } from '@yss123/cage-kernel';
+import type { FastifyInstance } from 'fastify';
+import { type AuthOptions, type Sessions } from './auth.js';
+export declare function oidcRoutes(app: FastifyInstance, k: Kernel, sessions: Sessions, opts: AuthOptions): void;
+export declare function upsertUserFromSso(k: Kernel, claims: Record<string, any>, deptClaim?: string): Promise<{
+    id: string;
+}>;

package/dist/oidc.js

@@ -0,0 +1,83 @@
+// SSO 登录（OIDC 授权码 + PKCE）。首次登录创建用户（默认没有任何角色），之后更新姓名和部门。
+// 创建和更新用户都是命令，以 external 身份调用，同样被鉴权、写审计。
+import { createHash, randomBytes } from 'node:crypto';
+import { cageError, DEFAULT_TENANT, systemCtx } from '@yss123/cage-kernel';
+import { setSessionCookie } from './auth.js';
+export function oidcRoutes(app, k, sessions, opts) {
+    const o = opts.oidc;
+    if (!o)
+        return;
+    let disco = null;
+    const discover = () => (disco ??= fetch(new URL('.well-known/openid-configuration', o.issuer.endsWith('/') ? o.issuer : `${o.issuer}/`)).then(async (r) => {
+        if (!r.ok)
+            throw new Error(`[CAGE-AUTH-001] OIDC 发现文档获取失败：${r.status}`);
+        return (await r.json());
+    }));
+    const secure = opts.cookieSecure ?? process.env.NODE_ENV === 'production';
+    app.get('/auth/sso', async (_req, reply) => {
+        const d = await discover();
+        const state = randomBytes(16).toString('base64url');
+        const verifier = randomBytes(32).toString('base64url');
+        const challenge = createHash('sha256').update(verifier).digest('base64url');
+        reply.setCookie('cage_oidc', JSON.stringify({ state, verifier }), { httpOnly: true, secure, sameSite: 'lax', path: '/auth', maxAge: 600, signed: true });
+        const u = new URL(d.authorization_endpoint);
+        u.searchParams.set('response_type', 'code');
+        u.searchParams.set('client_id', o.clientId);
+        u.searchParams.set('redirect_uri', o.redirectUri);
+        u.searchParams.set('scope', o.scope ?? 'openid profile email');
+        u.searchParams.set('state', state);
+        u.searchParams.set('code_challenge', challenge);
+        u.searchParams.set('code_challenge_method', 'S256');
+        return reply.redirect(u.toString());
+    });
+    app.get('/auth/callback', async (req, reply) => {
+        const q = req.query;
+        const raw = req.cookies['cage_oidc'];
+        const unsigned = raw ? req.unsignCookie(raw) : null;
+        const saved = unsigned?.valid && unsigned.value ? JSON.parse(unsigned.value) : null;
+        if (!q.code || !saved || saved.state !== q.state)
+            throw cageError('UNAUTHENTICATED');
+        reply.clearCookie('cage_oidc', { path: '/auth' });
+        const d = await discover();
+        const tok = await fetch(d.token_endpoint, {
+            method: 'POST',
+            headers: { 'content-type': 'application/x-www-form-urlencoded' },
+            body: new URLSearchParams({
+                grant_type: 'authorization_code', code: q.code, redirect_uri: o.redirectUri,
+                client_id: o.clientId, client_secret: o.clientSecret, code_verifier: saved.verifier,
+            }),
+        });
+        if (!tok.ok)
+            throw cageError('UNAUTHENTICATED');
+        const { access_token } = (await tok.json());
+        const info = await fetch(d.userinfo_endpoint, { headers: { authorization: `Bearer ${access_token}` } });
+        if (!info.ok)
+            throw cageError('UNAUTHENTICATED');
+        const claims = (await info.json());
+        const user = await upsertUserFromSso(k, claims, o.deptClaim);
+        const sid = await sessions.create(user.id, DEFAULT_TENANT, req);
+        setSessionCookie(reply, sid, opts);
+        return reply.redirect('/');
+    });
+}
+export async function upsertUserFromSso(k, claims, deptClaim = 'department') {
+    const tenantId = DEFAULT_TENANT;
+    const ctx = systemCtx({ kind: 'external', name: 'sso', tenantId, capabilities: ['User.create', 'User.update'] });
+    const subject = String(claims.sub);
+    const username = String(claims.preferred_username ?? claims.email ?? subject).slice(0, 64);
+    const name = String(claims.name ?? username).slice(0, 100);
+    const deptCode = claims[deptClaim];
+    const dept = (deptCode && (await k.app.selectFrom('sys.dept').select('id').where('code', '=', String(deptCode)).where('tenant_id', '=', tenantId).executeTakeFirst())) ||
+        (await k.app.selectFrom('sys.dept').select('id').where('code', '=', 'root').where('tenant_id', '=', tenantId).executeTakeFirstOrThrow());
+    const existing = await k.app.selectFrom('sys.user').select(['id', 'status']).where('tenant_id', '=', tenantId)
+        .where((eb) => eb.or([eb('sso_subject', '=', subject), eb('username', '=', username)])).executeTakeFirst();
+    if (existing) {
+        if (existing.status !== 'active')
+            throw cageError('UNAUTHENTICATED');
+        await k.execute('User.update', { id: existing.id, name, deptId: dept.id }, ctx);
+        return { id: existing.id };
+    }
+    const u = await k.execute('User.create', { username, name, deptId: dept.id, ssoSubject: subject, email: claims.email ?? null }, ctx);
+    return { id: u.id };
+}
+//# sourceMappingURL=oidc.js.map

package/dist/oidc.js.map

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

package/dist/openapi.d.ts

@@ -0,0 +1,16 @@
+import { type Kernel } from '@yss123/cage-kernel';
+import type { RouteInfo } from './routes.js';
+export declare function buildOpenApi(k: Kernel, routes: RouteInfo[], info?: {
+    title?: string;
+    version?: string;
+}): {
+    openapi: string;
+    info: {
+        title: string;
+        version: string;
+    };
+    paths: Record<string, Record<string, unknown>>;
+    components: {
+        schemas: Record<string, unknown>;
+    };
+};

package/dist/openapi.js

@@ -0,0 +1,90 @@
+// 启动时根据注册表输出一份 OpenAPI 文档；前端 SDK 由 cage gen 从声明里的 Zod schema 生成。
+import { hiddenFields, isRelation } from '@yss123/cage-kernel';
+import { z } from 'zod';
+const ERR = { $ref: '#/components/schemas/CageError' };
+function schemaOf(s) {
+    try {
+        return z.toJSONSchema(s, { unrepresentable: 'any', io: 'input' });
+    }
+    catch {
+        return {};
+    }
+}
+export function buildOpenApi(k, routes, info = {}) {
+    const schemas = {
+        CageError: {
+            type: 'object',
+            properties: { code: { type: 'string' }, domainCode: { type: 'string' }, detail: {} },
+            required: ['code'],
+        },
+        TransferTask: {
+            type: 'object', required: ['id', 'kind', 'target', 'status', 'createdAt', 'expiresAt'],
+            properties: {
+                id: { type: 'string', format: 'uuid' }, kind: { type: 'string', enum: ['export', 'import'] }, target: { type: 'string' },
+                status: { type: 'string', enum: ['queued', 'processing', 'retrying', 'completed', 'failed', 'expired'] },
+                createdAt: { type: 'string', format: 'date-time' }, expiresAt: { type: 'string', format: 'date-time' },
+                finishedAt: { type: ['string', 'null'] }, errorCode: { type: ['string', 'null'] }, result: { type: ['object', 'null'] },
+            },
+        },
+    };
+    for (const a of k.registry.aggregates) {
+        const props = { id: { type: 'string', format: 'uuid' }, status: { type: 'string', enum: [...a.states.values] }, version: { type: 'integer' }, createdAt: { type: 'string' }, updatedAt: { type: 'string' } };
+        const hidden = new Set(hiddenFields(a));
+        const js = schemaOf(a.schema);
+        for (const [f, p] of Object.entries(js.properties ?? {}))
+            if (!hidden.has(f) && !isRelation(a.fields[f]))
+                props[f] = a.fields[f]?.sensitiveKind ? { type: ['string', 'null'], description: '敏感字段：按权限返回掩码值' } : p;
+        schemas[a.name] = { type: 'object', properties: props };
+    }
+    const paths = {};
+    for (const r of routes) {
+        const url = r.url.replace(/:([a-zA-Z]+)/g, '{$1}');
+        const op = {
+            operationId: `${r.kind}_${url.replace(/[^a-zA-Z0-9]+/g, '_')}`,
+            summary: r.command?.cmd.description ?? r.capability,
+            'x-capability': r.capability,
+            responses: { 200: { description: 'OK', content: { 'application/json': { schema: r.aggregate && r.kind !== 'list' && r.kind !== 'export' ? { $ref: `#/components/schemas/${r.aggregate}` } : {} } } }, default: { description: '错误', content: { 'application/json': { schema: ERR } } } },
+        };
+        if (url.includes('{id}'))
+            op.parameters = [{ name: 'id', in: 'path', required: true, schema: { type: 'string', format: 'uuid' } }];
+        if (r.kind === 'list' || r.kind === 'related') {
+            const target = k.registry.aggregate(r.targetAggregate ?? r.aggregate);
+            op.responses[200].content['application/json'].schema = {
+                type: 'object', required: ['items', 'total', 'page', 'pageSize'], properties: {
+                    items: { type: 'array', items: { $ref: `#/components/schemas/${target.name}` } },
+                    total: { type: 'integer' }, page: { type: 'integer' }, pageSize: { type: 'integer' },
+                },
+            };
+            const parameters = [
+                { name: 'page', in: 'query', schema: { type: 'integer', minimum: 1 } },
+                { name: 'pageSize', in: 'query', schema: { type: 'integer', minimum: 1, maximum: 200 } },
+                { name: 'sort', in: 'query', schema: { type: 'string' }, description: '目标对象字段；前缀 - 表示降序' },
+                ...Object.entries(target.fields).filter(([, f]) => !f.isHidden && !isRelation(f) && f.sql !== 'jsonb' && !f.sensitiveKind)
+                    .map(([name, f]) => ({ name, in: 'query', schema: schemaOf(f.base) })),
+            ];
+            op.parameters = [...(op.parameters ?? []), ...parameters];
+            if (r.kind === 'related')
+                op.description = '分页读取关联对象，同时检查所属对象和目标对象的 read 能力与数据范围；目标敏感字段按权限掩码。';
+        }
+        if (r.method === 'POST' && r.input)
+            op.requestBody = { content: { 'application/json': { schema: schemaOf(r.input) } } };
+        const taskSchema = { $ref: '#/components/schemas/TransferTask' };
+        if (r.kind === 'export' || r.kind === 'import') {
+            op.responses = { 202: { description: '已入队，使用任务接口查询进度并下载文件', content: { 'application/json': { schema: taskSchema } } }, default: { description: '错误', content: { 'application/json': { schema: ERR } } } };
+            if (r.kind === 'export')
+                op.requestBody = { content: { 'application/json': { schema: { type: 'object', description: '与列表相同的筛选参数；忽略 page/pageSize，导出所有匹配行' } } } };
+        }
+        if (r.kind === 'transfer-get' || r.kind === 'transfer-list') {
+            op.responses[200].content['application/json'].schema = r.kind === 'transfer-list' ? { type: 'array', items: taskSchema } : taskSchema;
+        }
+        if (r.kind === 'transfer-list')
+            op.parameters = [{ name: 'aggregate', in: 'query', required: false, schema: { type: 'string' }, description: '只查询当前业务对象的导入和导出任务' }];
+        if (r.kind === 'transfer-download')
+            op.responses[200] = { description: '本人已完成且未过期的文件；重新检查权限', content: { 'text/csv': { schema: { type: 'string' } }, 'application/json': { schema: { type: 'object' } } } };
+        if (['command', 'export', 'import'].includes(r.kind))
+            op.parameters = [...(op.parameters ?? []), { name: 'Idempotency-Key', in: 'header', required: r.kind !== 'command', schema: { type: 'string', minLength: 1, maxLength: 200 } }];
+        (paths[url] ??= {})[r.method.toLowerCase()] = op;
+    }
+    return { openapi: '3.1.0', info: { title: info.title ?? 'cage api', version: info.version ?? '0.0.0' }, paths, components: { schemas } };
+}
+//# sourceMappingURL=openapi.js.map

package/dist/openapi.js.map

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

package/dist/routes.d.ts

@@ -0,0 +1,19 @@
+import { type Kernel, type RegisteredCommand } from '@yss123/cage-kernel';
+import type { FastifyInstance } from 'fastify';
+import { z } from 'zod';
+export interface RouteInfo {
+    method: 'GET' | 'POST';
+    url: string;
+    kind: 'command' | 'list' | 'get' | 'related' | 'export' | 'query' | 'hook' | 'import' | 'transfer-list' | 'transfer-get' | 'transfer-download' | 'transfer-options';
+    capability?: string;
+    aggregate?: string;
+    /** related 的响应类型来自目标聚合，所属对象仍在 aggregate 中。 */
+    targetAggregate?: string;
+    relation?: string;
+    command?: RegisteredCommand;
+    input?: z.ZodType;
+}
+export declare function commandUrl(c: RegisteredCommand): string;
+/** 注册表 → 路由清单（cage gen 也用它生成路由清单和前端 SDK） */
+export declare function routeTable(k: Kernel): RouteInfo[];
+export declare function registerRoutes(app: FastifyInstance, k: Kernel): RouteInfo[];

package/dist/routes.js

@@ -0,0 +1,118 @@
+// 路由生成：启动时遍历注册表，为每个命令、聚合、查询、入站回调挂路由。路由本身不做任何判断，全部交给内核。
+// 业务项目里禁止调用 app.get / app.post（lint 拦截），所以没有声明就没有路由。
+import { cageError, isRelation, kebab, systemCtx } from '@yss123/cage-kernel';
+import { z } from 'zod';
+import { registerTransfers, transferKey, transferRoutes } from './transfers.js';
+export function commandUrl(c) {
+    const base = `/api/${kebab(c.cmd.agg.name)}`;
+    return c.cmd.from === 'new' ? `${base}/${kebab(c.name)}` : `${base}/:id/${kebab(c.name)}`;
+}
+/** 注册表 → 路由清单（cage gen 也用它生成路由清单和前端 SDK） */
+export function routeTable(k) {
+    const out = [...transferRoutes];
+    for (const c of k.registry.commands) {
+        if (!c.cmd.invokedBy.includes('user'))
+            continue; // 流程、任务、外部专用命令不对浏览器开放
+        out.push({ method: 'POST', url: commandUrl(c), kind: 'command', capability: c.capability, aggregate: c.cmd.agg.name, command: c, input: c.cmd.input });
+    }
+    for (const a of k.registry.aggregates) {
+        const base = `/api/${kebab(a.name)}`;
+        out.push({ method: 'GET', url: base, kind: 'list', capability: `${a.name}.read`, aggregate: a.name });
+        out.push({ method: 'POST', url: `${base}/export`, kind: 'export', capability: `${a.name}.export`, aggregate: a.name });
+        out.push({ method: 'GET', url: `${base}/:id`, kind: 'get', capability: `${a.name}.read`, aggregate: a.name });
+        for (const [key, field] of Object.entries(a.fields))
+            if (isRelation(field))
+                out.push({ method: 'GET', url: `${base}/:id/relations/${kebab(key)}`, kind: 'related',
+                    capability: [...new Set([`${a.name}.read`, `${field.ref}.read`])].join(','), aggregate: a.name, targetAggregate: field.ref, relation: key });
+    }
+    for (const q of k.registry.queries) {
+        out.push({ method: 'GET', url: `/api/queries/${kebab(q.name)}`, kind: 'query', capability: q.reads.map((r) => `${r.name}.read`).join(','), input: q.input });
+    }
+    for (const e of k.registry.extensions) {
+        if (e.kind === 'INBOUND')
+            out.push({ method: 'POST', url: `/hooks/${e.value.connector.name}/${kebab(e.value.event)}`, kind: 'hook' });
+    }
+    return out;
+}
+export function registerRoutes(app, k) {
+    const table = routeTable(k);
+    registerTransfers(app, k);
+    for (const c of k.registry.commands) {
+        if (!c.cmd.invokedBy.includes('user'))
+            continue;
+        app.post(commandUrl(c), async (req) => {
+            const body = req.body && typeof req.body === 'object' ? req.body : {};
+            const params = req.params;
+            const input = params.id ? { ...body, id: params.id } : body;
+            const key = req.headers['idempotency-key'];
+            return k.execute(c.cmd, input, { ...req.cageCtx, idempotencyKey: typeof key === 'string' ? key.slice(0, 200) : undefined });
+        });
+    }
+    for (const a of k.registry.aggregates)
+        registerAggregate(app, k, a);
+    for (const q of k.registry.queries) {
+        app.get(`/api/queries/${kebab(q.name)}`, async (req) => k.read.run(q, coerceQuery(q.input, req.query), req.cageCtx));
+    }
+    for (const e of k.registry.extensions) {
+        if (e.kind !== 'INBOUND')
+            continue;
+        const inb = e.value;
+        app.post(`/hooks/${inb.connector.name}/${kebab(inb.event)}`, async (req) => {
+            // 先验签，再映射到命令；以 external 身份调用
+            const secret = process.env[inb.verify.secret];
+            if (!secret)
+                throw new Error(`[CAGE-SECRET-001] 缺少密钥 ${inb.verify.secret}`);
+            if (!inb.verify.verify(req.rawBody ?? '', req.headers, secret))
+                throw cageError('UNAUTHENTICATED');
+            const parsed = inb.payload.safeParse(req.body);
+            if (!parsed.success)
+                throw cageError('INVALID_INPUT', parsed.error.issues.map((i) => ({ path: i.path.join('.'), message: i.message })));
+            const ctx = systemCtx({
+                kind: 'external', name: inb.connector.name, tenantId: req.cageCtx.tenantId,
+                capabilities: [k.registry.capabilityOf(inb.command)], requestId: String(req.id),
+            });
+            const key = req.headers['idempotency-key'];
+            return k.execute(inb.command, inb.map(parsed.data), { ...ctx, idempotencyKey: typeof key === 'string' ? key : undefined });
+        });
+    }
+    return table;
+}
+function registerAggregate(app, k, a) {
+    const base = `/api/${kebab(a.name)}`;
+    app.get(base, async (req) => k.read.list(a, req.query, req.cageCtx));
+    app.get(`${base}/:id`, async (req) => k.read.get(a, req.params.id, req.cageCtx));
+    for (const [key, field] of Object.entries(a.fields))
+        if (isRelation(field))
+            app.get(`${base}/:id/relations/${kebab(key)}`, async (req) => k.read.related(a, req.params.id, key, req.query, req.cageCtx));
+    app.post(`${base}/export`, async (req, reply) => {
+        const parsed = z.record(z.string(), z.unknown()).safeParse(req.body ?? {});
+        if (!parsed.success)
+            throw cageError('INVALID_INPUT', '导出筛选参数必须是对象');
+        const task = await k.transfers.export(a.name, parsed.data, req.cageCtx, transferKey(req));
+        return reply.code(202).send(task);
+    });
+}
+/** 查询字符串都是字符串：按输入 schema 把数字和布尔转换过来 */
+function coerceQuery(schema, q) {
+    if (!(schema instanceof z.ZodObject))
+        return q;
+    const out = { ...q };
+    for (const [k, s] of Object.entries(schema.shape)) {
+        const v = q[k];
+        if (typeof v !== 'string')
+            continue;
+        const inner = unwrap(s);
+        if (inner instanceof z.ZodNumber)
+            out[k] = Number(v);
+        else if (inner instanceof z.ZodBoolean)
+            out[k] = v === 'true';
+    }
+    return out;
+}
+function unwrap(s) {
+    let cur = s;
+    while (cur && (cur instanceof z.ZodOptional || cur instanceof z.ZodNullable || cur instanceof z.ZodDefault))
+        cur = cur.unwrap();
+    return cur;
+}
+//# sourceMappingURL=routes.js.map

package/dist/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,qDAAqD;AACrD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAuE,MAAM,qBAAqB,CAAC;AAEnJ,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAehF,MAAM,UAAU,UAAU,CAAC,CAAoB;IAC7C,MAAM,IAAI,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;IAC7C,OAAO,CAAC,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,QAAQ,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;AAC5F,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,MAAM,GAAG,GAAgB,CAAC,GAAG,cAAc,CAAC,CAAC;IAC7C,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACpC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,SAAS,CAAC,sBAAsB;QACvE,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;IACzJ,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,IAAI,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACtG,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,IAAI,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACvH,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,IAAI,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9G,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAgB,CAAC;YAAE,IAAI,UAAU,CAAC,KAAK,CAAC;gBAClF,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,kBAAkB,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS;oBACnF,UAAU,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,OAAO,EAAE,GAAG,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;IACnJ,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACnC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,gBAAgB,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAC/J,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QACtC,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACxI,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAoB,EAAE,CAAS;IAC5D,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAC5B,iBAAiB,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC1B,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACpC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,SAAS;QAChD,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACpC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAE,GAAG,CAAC,IAAgC,CAAC,CAAC,CAAC,EAAE,CAAC;YACnG,MAAM,MAAM,GAAG,GAAG,CAAC,MAAyB,CAAC;YAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAC5D,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;YAC3C,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;QAC9H,CAAC,CAAC,CAAC;IACL,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU;QAAE,iBAAiB,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACpE,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACnC,GAAG,CAAC,GAAG,CAAC,gBAAgB,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,KAAgC,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAClJ,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QACtC,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;YAAE,SAAS;QACnC,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC;QACpB,GAAG,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACzE,6BAA6B;YAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC9C,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YAC5E,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,GAAG,CAAC,OAAc,EAAE,MAAM,CAAC;gBAAE,MAAM,SAAS,CAAC,iBAAiB,CAAC,CAAC;YAC1G,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC/C,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,MAAM,SAAS,CAAC,eAAe,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YAC7I,MAAM,GAAG,GAAG,SAAS,CAAC;gBACpB,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ;gBAC1E,YAAY,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;aAChF,CAAC,CAAC;YACH,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;YAC3C,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,GAAG,EAAE,cAAc,EAAE,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;QAC7H,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAoB,EAAE,CAAS,EAAE,CAAe;IACzE,MAAM,IAAI,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;IACrC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,KAAgC,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAChG,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAG,GAAG,CAAC,MAAyB,CAAC,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IACrG,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAgB,CAAC;QAAE,IAAI,UAAU,CAAC,KAAK,CAAC;YAClF,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,kBAAkB,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAC3D,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAG,GAAG,CAAC,MAAyB,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,KAAgC,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAClH,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QAC9C,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAC3E,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,MAAM,SAAS,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;QACrE,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1F,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,uCAAuC;AACvC,SAAS,WAAW,CAAC,MAAiB,EAAE,CAA0B;IAChE,IAAI,CAAC,CAAC,MAAM,YAAY,CAAC,CAAC,SAAS,CAAC;QAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,GAAG,GAA4B,EAAE,GAAG,CAAC,EAAE,CAAC;IAC9C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAkC,CAAC,EAAE,CAAC;QAC/E,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACf,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,SAAS;QACpC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,KAAK,YAAY,CAAC,CAAC,SAAS;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;aAChD,IAAI,KAAK,YAAY,CAAC,CAAC,UAAU;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC;IAChE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,MAAM,CAAC,CAAY;IAC1B,IAAI,GAAG,GAAQ,CAAC,CAAC;IACjB,OAAO,GAAG,IAAI,CAAC,GAAG,YAAY,CAAC,CAAC,WAAW,IAAI,GAAG,YAAY,CAAC,CAAC,WAAW,IAAI,GAAG,YAAY,CAAC,CAAC,UAAU,CAAC;QAAE,GAAG,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;IAChI,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,40 @@
+import { type DatabaseUrls, type Kernel } from '@yss123/cage-kernel';
+import { type FastifyInstance } from 'fastify';
+import { type AuthOptions } from './auth.js';
+export interface ServerOptions {
+    /** domain 包的导出：import * as domain from '@app/domain' */
+    domain: object;
+    urls?: DatabaseUrls;
+    auth?: AuthOptions & {
+        oidcIssuer?: string;
+    };
+    /** 业务前端构建产物目录（单页应用），不传时不托管 */
+    webDir?: string;
+    /** /admin 系统管理，默认开启 */
+    admin?: boolean;
+    /** 系统管理显示名，使用 aggregate:/command:/capability: 等图谱键；覆盖本地配置。 */
+    adminLabels?: Record<string, string>;
+    /** 首次启动时初始化组织并打印初始管理员账号，默认开启 */
+    bootstrap?: boolean;
+    port?: number;
+    host?: string;
+    /** 默认每个客户端每分钟 300 次 */
+    rateLimitPerMinute?: number;
+    /** 登录类接口每个客户端每分钟次数，默认 10 */
+    authRateLimitPerMinute?: number;
+    /** 关闭 CSRF（只用于测试） */
+    csrf?: boolean;
+    logger?: boolean;
+    title?: string;
+}
+export interface CageServer {
+    app: FastifyInstance;
+    kernel: Kernel;
+    ready(): Promise<FastifyInstance>;
+    listen(opts?: {
+        port?: number;
+        host?: string;
+    }): Promise<string>;
+    close(): Promise<void>;
+}
+export declare function createServer(opts: ServerOptions): CageServer;

package/dist/server.js

@@ -0,0 +1,161 @@
+// createServer：安全基线默认开启（安全响应头、CSRF、限流、请求体大小、日志打码），业务项目不需要记得加。
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { createRequire } from 'node:module';
+import cookie from '@fastify/cookie';
+import csrf from '@fastify/csrf-protection';
+import helmet from '@fastify/helmet';
+import rateLimit from '@fastify/rate-limit';
+import fastifyStatic from '@fastify/static';
+import * as adminDomain from '@yss123/cage-admin/domain';
+import { adminRoutes, bootstrapOrg } from '@yss123/cage-admin';
+import { approvalRoutes } from '@yss123/cage-approval';
+import { createKernel, toCageError, urlsFromEnv } from '@yss123/cage-kernel';
+import Fastify from 'fastify';
+import { authRoutes, csrfRoute, registerAuthHook, Sessions } from './auth.js';
+import { CtxCache } from './ctx.js';
+import { buildLogger } from './logger.js';
+import { oidcRoutes } from './oidc.js';
+import { buildOpenApi } from './openapi.js';
+import { registerRoutes } from './routes.js';
+function adminUiDir() {
+    // 通过包公开入口定位资源；package.json 未被 exports 公开，且安装后的 pnpm
+    // 目录与 monorepo 不同，不能依赖 ../../admin 的工作区相对路径。
+    const entry = createRequire(import.meta.url).resolve('@yss123/cage-admin');
+    const dir = resolve(dirname(entry), '../ui');
+    return existsSync(dir) ? dir : null;
+}
+export function createServer(opts) {
+    const urls = opts.urls ?? urlsFromEnv();
+    const app = Fastify({
+        bodyLimit: 1_048_576, // 请求体最大 1 MB
+        trustProxy: true, // 在负载均衡后面取真实客户端 IP
+        logger: false,
+        genReqId: () => crypto.randomUUID(),
+    });
+    // 组织模型永远在注册表里（同一对象重复导出会自动去重）
+    const kernel = createKernel({ domain: [adminDomain, opts.domain], urls, logger: undefined });
+    if (opts.logger !== false) {
+        const pino = Fastify({ logger: buildLogger(kernel.registry) }).log;
+        kernel.log = pino;
+        app.log = pino;
+    }
+    const cache = new CtxCache(kernel);
+    const authOpts = {
+        ...opts.auth,
+        oidc: opts.auth?.oidc ?? (opts.auth?.oidcIssuer && process.env.OIDC_CLIENT_ID
+            ? {
+                issuer: opts.auth.oidcIssuer,
+                clientId: process.env.OIDC_CLIENT_ID,
+                clientSecret: process.env.OIDC_CLIENT_SECRET ?? '',
+                redirectUri: process.env.OIDC_REDIRECT_URI ?? 'http://localhost:3000/auth/callback',
+            }
+            : undefined),
+    };
+    const sessions = new Sessions(kernel, authOpts.sessionHours ?? 8);
+    const build = async () => {
+        // 原始请求体：入站回调验签要用
+        app.addContentTypeParser('application/json', { parseAs: 'string' }, (req, body, done) => {
+            req.rawBody = body;
+            if (!body)
+                return done(null, {});
+            try {
+                done(null, JSON.parse(body));
+            }
+            catch {
+                done(Object.assign(new Error('请求体不是合法的 JSON'), { statusCode: 400 }), undefined);
+            }
+        });
+        await app.register(helmet, {
+            contentSecurityPolicy: { directives: { defaultSrc: ["'self'"], scriptSrc: ["'self'"], styleSrc: ["'self'", "'unsafe-inline'"], imgSrc: ["'self'", 'data:'] } },
+        });
+        await app.register(rateLimit, { max: opts.rateLimitPerMinute ?? 300, timeWindow: '1 minute' });
+        await app.register(cookie, { secret: process.env.CAGE_COOKIE_SECRET ?? 'cage-dev-cookie-secret-change-me' });
+        await app.register(csrf, { sessionPlugin: '@fastify/cookie', cookieOpts: { signed: true, httpOnly: true, sameSite: 'lax', path: '/' } });
+        registerAuthHook(app, kernel, sessions, cache);
+        if (opts.csrf !== false) {
+            app.addHook('preHandler', (req, reply, done) => {
+                // 基于 cookie 会话：所有写请求都要带 CSRF 令牌；第三方回调走签名验证
+                if (req.method === 'GET' || req.method === 'HEAD' || req.method === 'OPTIONS' || req.url.startsWith('/hooks/'))
+                    return done();
+                app.csrfProtection(req, reply, done);
+            });
+        }
+        app.setErrorHandler((err, req, reply) => {
+            const e = toCageError(err);
+            if (e.code === 'INTERNAL')
+                kernel.log.error({ err, requestId: req.id, url: req.url }, '请求异常');
+            reply.status(e.http).send({ code: e.code, ...(e.domainCode ? { domainCode: e.domainCode } : {}), detail: e.code === 'INTERNAL' ? undefined : e.detail, requestId: req.id });
+        });
+        app.setNotFoundHandler((req, reply) => {
+            if (req.url.startsWith('/api/') || req.url.startsWith('/hooks/') || req.url.startsWith('/auth/')) {
+                return reply.status(404).send({ code: 'NOT_FOUND' });
+            }
+            if (opts.webDir && existsSync(join(opts.webDir, 'index.html')))
+                return reply.sendFile('index.html', opts.webDir);
+            return reply.status(404).send({ code: 'NOT_FOUND' });
+        });
+        // 登录相关接口单独一组，限流更严（防暴力破解）
+        await app.register(async (auth) => {
+            await auth.register(rateLimit, { max: opts.authRateLimitPerMinute ?? 10, timeWindow: '1 minute' });
+            authRoutes(auth, kernel, sessions, authOpts);
+            oidcRoutes(auth, kernel, sessions, authOpts);
+        });
+        csrfRoute(app);
+        app.get('/healthz', async () => ({ ok: true }));
+        const routes = registerRoutes(app, kernel);
+        app.get('/api/openapi.json', async () => buildOpenApi(kernel, routes, { title: opts.title }));
+        if (opts.admin !== false) {
+            // CLI dev 和部署均以项目根为工作目录。展示文案复用已有图谱配置，业务无需维护两份翻译。
+            // 直接调用 createServer 的应用也可通过 adminLabels 提供文案，不依赖文件。
+            const configFile = resolve('cage.config.json');
+            const labels = existsSync(configFile) ? JSON.parse(readFileSync(configFile, 'utf8')).graph?.labels : {};
+            adminRoutes(app, kernel, { ...labels, ...opts.adminLabels });
+        }
+        const engines = kernel.registry.extensions.filter((e) => e.kind === 'ROUTE').map((e) => e.value.engine(kernel));
+        if (engines.length)
+            approvalRoutes(app, { kernel, engines, ctxOf: (req) => req.cageCtx });
+        const ui = opts.admin !== false ? adminUiDir() : null;
+        if (ui) {
+            await app.register(fastifyStatic, { root: ui, prefix: '/admin/', decorateReply: !opts.webDir });
+            app.get('/admin', (_req, reply) => reply.redirect('/admin/'));
+        }
+        if (opts.webDir && existsSync(opts.webDir)) {
+            await app.register(fastifyStatic, { root: opts.webDir, prefix: '/', decorateReply: true, wildcard: false });
+        }
+        await cache.listen(urls.app);
+        if (opts.bootstrap !== false) {
+            const b = await bootstrapOrg(kernel).catch((e) => {
+                kernel.log.warn({ err: String(e) }, '组织初始化失败（是否已执行 cage migrate？）');
+                return { created: false };
+            });
+            if (b.created) {
+                // 初始管理员账号只在终端里打印一次
+                console.log(`\n  初始管理员  用户名 ${b.username}  密码 ${b.password}\n  请登录 /admin 后立即修改密码\n`);
+            }
+        }
+        await app.ready();
+        return app;
+    };
+    let readyP = null;
+    const ready = () => (readyP ??= build());
+    return {
+        app,
+        kernel,
+        ready,
+        async listen(l = {}) {
+            await ready();
+            const port = l.port ?? opts.port ?? Number(process.env.PORT ?? 3000);
+            const host = l.host ?? opts.host ?? process.env.HOST ?? '0.0.0.0';
+            const addr = await app.listen({ port, host });
+            kernel.log.info({ addr }, 'api 已启动');
+            return addr;
+        },
+        async close() {
+            await app.close();
+            await cache.close();
+            await kernel.close();
+        },
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/transfers.d.ts

@@ -0,0 +1,7 @@
+import { type Kernel } from '@yss123/cage-kernel';
+import type { FastifyInstance, FastifyRequest } from 'fastify';
+import type { RouteInfo } from './routes.js';
+export declare const transferRoutes: RouteInfo[];
+/** 不截断幂等键，避免两个不同请求因前缀相同而被当作同一次提交。 */
+export declare function transferKey(req: FastifyRequest): string;
+export declare function registerTransfers(app: FastifyInstance, k: Kernel): void;

package/dist/transfers.js

@@ -0,0 +1,49 @@
+// 通用任务接口始终挂载（不依赖 /admin 是否开启），因此业务前端也能使用生成的 SDK。
+import { cageError, importRequestSchema, kebab } from '@yss123/cage-kernel';
+import { z } from 'zod';
+export const transferRoutes = [
+    { method: 'GET', url: '/api/sys/transfers', kind: 'transfer-list' },
+    { method: 'GET', url: '/api/sys/transfers/options', kind: 'transfer-options' },
+    { method: 'POST', url: '/api/sys/transfers/import', kind: 'import', input: importRequestSchema },
+    { method: 'GET', url: '/api/sys/transfers/:id', kind: 'transfer-get' },
+    { method: 'GET', url: '/api/sys/transfers/:id/download', kind: 'transfer-download' },
+];
+/** 不截断幂等键，避免两个不同请求因前缀相同而被当作同一次提交。 */
+export function transferKey(req) {
+    const key = req.headers['idempotency-key'];
+    if (typeof key !== 'string' || !key || key.length > 200)
+        throw cageError('INVALID_INPUT', '任务提交需要 Idempotency-Key（1–200 字符）');
+    return key;
+}
+export function registerTransfers(app, k) {
+    app.get('/api/sys/transfers', (req) => k.transfers.list(req.cageCtx, req.query.aggregate));
+    app.get('/api/sys/transfers/options', async (req) => {
+        if (!req.cageCtx.userId)
+            throw cageError('UNAUTHENTICATED');
+        const can = (cap) => req.cageCtx.capabilities.has(cap);
+        return {
+            exports: k.registry.aggregates.filter((a) => can(`${a.name}.export`)).map((a) => ({
+                name: a.name, title: a.description ?? a.name, url: `/api/${kebab(a.name)}/export`,
+            })),
+            imports: k.registry.commands.filter((c) => c.cmd.invokedBy.includes('user') && c.cmd.input instanceof z.ZodObject && can(c.capability)).map((c) => ({
+                command: c.capability, title: c.cmd.description ?? c.capability,
+                // 这是输入表头，不能使用读侧导出表头：读侧包含系统列、掩码值，不能直接回写。
+                fields: Object.entries(c.cmd.input.shape).map(([name, schema]) => ({ name, required: !schema.isOptional() })),
+            })),
+            limits: { importBytes: 1_048_576, importRows: 1000, exportRows: 100000, exportBytes: 20 * 1024 * 1024, retentionHours: 24 },
+        };
+    });
+    // 文件由浏览器读取为 UTF-8 CSV，通过 JSON 上传；6 MiB 覆盖 JSON 转义膨胀，
+    // 服务仍按解码后 1 MiB 限制原文件。其他接口继续保持原来的 1 MiB 上限。
+    app.post('/api/sys/transfers/import', { bodyLimit: 6 * 1024 * 1024 }, async (req, reply) => {
+        const task = await k.transfers.import(req.body, req.cageCtx, transferKey(req));
+        return reply.code(202).send(task);
+    });
+    app.get('/api/sys/transfers/:id', (req) => k.transfers.get(req.params.id, req.cageCtx));
+    app.get('/api/sys/transfers/:id/download', async (req, reply) => {
+        const file = await k.transfers.download(req.params.id, req.cageCtx);
+        return reply.header('cache-control', 'no-store').header('content-type', file.contentType)
+            .header('content-disposition', `attachment; filename="${file.filename}"`).send(file.body);
+    });
+}
+//# sourceMappingURL=transfers.js.map

package/dist/transfers.js.map

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

package/dist/worker.d.ts

@@ -0,0 +1,4 @@
+import { type WorkerOptions } from '@yss123/cage-kernel/worker';
+export declare function startWorker(opts: WorkerOptions & {
+    domain: object;
+}): Promise<import("@yss123/cage-kernel/worker").WorkerHandle>;

package/dist/worker.js

@@ -0,0 +1,7 @@
+// worker 入口的便捷封装：自动并入组织模型。也可以直接用 @yss123/cage-kernel/worker 的 startWorker。
+import * as adminDomain from '@yss123/cage-admin/domain';
+import { startWorker as start } from '@yss123/cage-kernel/worker';
+export function startWorker(opts) {
+    return start({ ...opts, domain: [adminDomain, opts.domain] });
+}
+//# sourceMappingURL=worker.js.map

package/dist/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,OAAO,KAAK,WAAW,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,WAAW,IAAI,KAAK,EAAsB,MAAM,4BAA4B,CAAC;AAEtF,MAAM,UAAU,WAAW,CAAC,IAAwC;IAClE,OAAO,KAAK,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAChE,CAAC"}

package/package.json

@@ -1,6 +1,61 @@
 {
   "name": "@yss123/cage-http",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "笼子 HTTP 层：Fastify 插件、路由生成、认证、安全基线",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./worker": {
+      "types": "./dist/worker.d.ts",
+      "default": "./dist/worker.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@fastify/cookie": "^11.0.2",
+    "@fastify/csrf-protection": "^7.1.0",
+    "@fastify/helmet": "^13.0.1",
+    "@fastify/rate-limit": "^10.3.0",
+    "@fastify/static": "^10.1.8",
+    "fastify": "^5.6.0",
+    "fastify-plugin": "^5.0.1",
+    "lru-cache": "^11.2.1",
+    "pg": "^8.16.3",
+    "zod": "^4.1.5",
+    "kysely": "^0.28.5",
+    "@yss123/cage-admin": "0.2.0",
+    "@yss123/cage-approval": "0.2.0",
+    "@yss123/cage-kernel": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/pg": "^8.15.5"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shunshunyue/cage.git",
+    "directory": "packages/http"
+  },
+  "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"
+  }
 }