@taicode/common-server 3.8.0 → 4.0.0-beta.2

package/output/app/shutdown.test.js

@@ -1,149 +1,103 @@
 import { describe, expect, it } from 'vitest';
-import { defineServer } from './define-server.js';
-import { SHUTDOWN_ORDER } from './shutdown.js';
-const P1_OPT_OUT = {
-    context: false,
-    response: false,
-    cors: false,
-    schema: false,
-    'rate-limit': false,
-    auth: false,
-    openapi: false,
-    database: false,
-};
-const DUMMY_ERRORS = {
-    UserError: class extends Error {
-    },
-    SystemError: class extends Error {
-    },
-};
-function createTestLog() {
-    const errors = [];
-    const log = {
-        debug: () => undefined,
-        info: () => undefined,
-        warn: () => undefined,
-        error: (obj) => {
-            errors.push(obj);
-        },
-    };
-    return { log, errors };
-}
-function createBaseOptions(overrides = {}) {
-    return {
-        serviceName: 'test',
-        title: 'Test',
-        description: 'Test service',
-        errors: DUMMY_ERRORS,
-        config: { loadConfig: () => ({ debug: false, port: 0 }) },
-        modules: { ...P1_OPT_OUT },
-        serverOptions: { port: 0, host: '127.0.0.1' },
-        signal: false,
-        createServices: () => ({}),
-        registerRouters: () => undefined,
-        ...overrides,
-    };
+import { defineServer, startServer } from './entries.js';
+import { runShutdown, SHUTDOWN_ORDER } from './shutdown.js';
+function createShutdownLog() {
+    const entries = [];
+    return { entries, log: { error: (obj, msg) => void entries.push({ obj, msg }) } };
 }
-function createRecordingShutdownModule(record, throwOn) {
-    const createStep = (name) => () => {
+function createRecordingHandles(record, throwOn) {
+    const step = (name) => () => {
         record.push(name);
         if (name === throwOn) {
             throw new Error(`boom:${name}`);
         }
     };
-    const shutdown = {
-        stopProducers: createStep('stopProducers'),
-        unsubscribeConfig: createStep('unsubscribeConfig'),
-        disposeConfig: createStep('disposeConfig'),
-        disposeServices: createStep('disposeServices'),
-        disposeClients: createStep('disposeClients'),
-        disposeRedis: createStep('disposeRedis'),
-        disposeDb: createStep('disposeDb'),
+    return {
+        stopProducers: step('stopProducers'),
+        disposeServices: step('disposeServices'),
     };
-    return { name: 'env', shutdown };
 }
-describe('关闭 7 步', () => {
-    it('顺序写死、beforeShutdown 在最前', async () => {
-        const record = [];
-        const app = await defineServer(createBaseOptions({
-            modules: { ...P1_OPT_OUT, env: createRecordingShutdownModule(record) },
-            beforeShutdown: () => {
-                record.push('beforeShutdown');
-            },
-        }));
-        await app.close();
-        expect(record).toEqual(['beforeShutdown', ...SHUTDOWN_ORDER]);
+describe('SHUTDOWN_ORDER', () => {
+    it('固定两步且顺序不可变', () => {
+        expect(SHUTDOWN_ORDER).toEqual(['stopProducers', 'disposeServices']);
     });
-    it('单步抛错不阻断后续，且聚合上报（不吞第一个错误）', async () => {
+});
+describe('runShutdown', () => {
+    it('按固定序执行全部步骤', async () => {
         const record = [];
-        const { log, errors } = createTestLog();
-        const app = await defineServer(createBaseOptions({
-            log,
-            modules: { ...P1_OPT_OUT, env: createRecordingShutdownModule(record, 'disposeConfig') },
-            beforeShutdown: () => {
-                record.push('beforeShutdown');
-                throw new Error('boom:beforeShutdown');
-            },
-        }));
-        await app.close();
-        // disposeConfig 抛错后，4~7 步仍然执行
-        expect(record).toEqual(['beforeShutdown', ...SHUTDOWN_ORDER]);
-        expect(errors).toHaveLength(1);
-        const aggregated = errors[0];
-        expect(aggregated.count).toBe(2);
-        expect(aggregated.errors).toHaveLength(2);
+        const { log } = createShutdownLog();
+        await runShutdown(createRecordingHandles(record), log);
+        expect(record).toEqual([...SHUTDOWN_ORDER]);
     });
-    it('shutdown 选项整体覆盖默认关闭流程', async () => {
+    it('单步抛错不阻断后续，并聚合上报', async () => {
         const record = [];
-        const app = await defineServer(createBaseOptions({
-            modules: { ...P1_OPT_OUT, env: createRecordingShutdownModule(record) },
-            beforeShutdown: () => {
-                record.push('beforeShutdown');
-            },
-            shutdown: () => {
-                record.push('custom');
-            },
-        }));
-        await app.close();
-        expect(record).toEqual(['custom']);
+        const { entries, log } = createShutdownLog();
+        await runShutdown(createRecordingHandles(record, 'stopProducers'), log);
+        expect(record).toEqual([...SHUTDOWN_ORDER]);
+        const aggregate = entries.find((entry) => entry.msg === '[shutdown] completed with errors');
+        expect(aggregate).toBeDefined();
+        const payload = aggregate?.obj;
+        expect(payload.count).toBe(1);
+        expect(payload.errors).toHaveLength(1);
     });
-    it('模块 hooks.beforeShutdown 生效（调用方选项优先）', async () => {
-        const record = [];
-        const module = {
-            name: 'env',
-            hooks: {
-                beforeShutdown: () => {
-                    record.push('module-before');
-                },
-            },
-            shutdown: {
-                stopProducers: () => {
-                    record.push('stopProducers');
-                },
+});
+describe('关闭流程集成', () => {
+    it('默认两步按序执行：disposer → services 逆序', async () => {
+        const calls = [];
+        const server = defineServer({
+            app: { service: 'shutdown-integration', title: 'Shutdown Integration', version: '1.0.0' },
+            resources: () => ({ database: { dispose: () => calls.push('disposeResource') } }),
+            config: () => ({}),
+            services: (ctx) => {
+                ctx.disposer.add(() => {
+                    calls.push('stopProducers');
+                });
+                return {
+                    a: {
+                        dispose: () => {
+                            calls.push('disposeServiceA');
+                        },
+                    },
+                    b: {
+                        dispose: () => {
+                            calls.push('disposeServiceB');
+                        },
+                    },
+                };
             },
-        };
-        const app = await defineServer(createBaseOptions({ modules: { ...P1_OPT_OUT, env: module } }));
+            middlewares: () => [],
+            routers: () => undefined,
+        });
+        const app = await startServer(server, { listen: false });
         await app.close();
-        expect(record).toEqual(['module-before', 'stopProducers']);
+        // 资源不在生命周期内（框架只管 services）
+        expect(calls).toEqual(['stopProducers', 'disposeServiceB', 'disposeServiceA']);
     });
-    it('默认 disposeServices 用 Promise.allSettled 释放 services（单服务抛错不影响其它）', async () => {
-        let disposed = 0;
-        const app = await defineServer(createBaseOptions({
-            createServices: () => ({
+    it('StartServerOptions.shutdown 整体覆盖默认关闭流程', async () => {
+        const calls = [];
+        const server = defineServer({
+            app: { service: 'shutdown-override', title: 'Shutdown Override', version: '1.0.0' },
+            resources: () => ({}),
+            config: () => ({}),
+            services: () => ({
                 a: {
                     dispose: () => {
-                        disposed += 1;
-                    },
-                },
-                b: {
-                    dispose: () => {
-                        disposed += 1;
-                        throw new Error('service dispose failed');
+                        calls.push('default-dispose');
                     },
                 },
             }),
-        }));
+            middlewares: () => [],
+            routers: () => undefined,
+        });
+        const app = await startServer(server, {
+            listen: false,
+            shutdown: async (ctx) => {
+                expect(ctx.app).toBeDefined();
+                expect(ctx.services).toBeDefined();
+                calls.push('custom');
+            },
+        });
         await app.close();
-        expect(disposed).toBe(2);
+        expect(calls).toEqual(['custom']);
     });
 });

package/output/app/signal.d.ts

@@ -1,10 +1,10 @@
-import type { FastifyInstance } from 'fastify';
 import type { LoggerLike } from './types.js';
+import type { FastifyInstance } from 'fastify';
 /**
- * 内置信号处理（design §4.1 第 15 步尾部）。
+ * 内置信号处理（设计 §7.1 `activate` 尾部 / §7.2）。
  *
- * `SIGTERM` / `SIGINT` / `uncaughtException` / `unhandledRejection` ⇒ `app.close()`（触发 onClose
- * 的关闭 7 步）⇒ `process.exit(0/1)`。可通过 `signal: false` 整体关掉（测试 / 嵌入场景）。
+ * `SIGTERM` / `SIGINT` / `uncaughtException` / `unhandledRejection` ⇒ `app.close()`（触发 `onClose`
+ * 的关闭 6 步）⇒ `process.exit(0/1)`。**仅 `listen: true` 时装信号处理**。
  *
  * @returns detach 函数（移除本次注册的监听器）
  */

package/output/app/signal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../../source/app/signal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,UAAU,GAAG,MAAM,IAAI,CA2CtF"}
+{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../../source/app/signal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,UAAU,GAAG,MAAM,IAAI,CA2CtF"}

package/output/app/signal.js

@@ -1,8 +1,8 @@
 /**
- * 内置信号处理（design §4.1 第 15 步尾部）。
+ * 内置信号处理（设计 §7.1 `activate` 尾部 / §7.2）。
  *
- * `SIGTERM` / `SIGINT` / `uncaughtException` / `unhandledRejection` ⇒ `app.close()`（触发 onClose
- * 的关闭 7 步）⇒ `process.exit(0/1)`。可通过 `signal: false` 整体关掉（测试 / 嵌入场景）。
+ * `SIGTERM` / `SIGINT` / `uncaughtException` / `unhandledRejection` ⇒ `app.close()`（触发 `onClose`
+ * 的关闭 6 步）⇒ `process.exit(0/1)`。**仅 `listen: true` 时装信号处理**。
  *
  * @returns detach 函数（移除本次注册的监听器）
  */

package/output/app/smoke.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=smoke.test.d.ts.map

package/output/app/smoke.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke.test.d.ts","sourceRoot":"","sources":["../../source/app/smoke.test.ts"],"names":[],"mappings":""}

package/output/app/smoke.test.js

@@ -0,0 +1,210 @@
+import { describe, expect, it } from 'vitest';
+import { z } from 'zod';
+import { defineServer, generateOpenApi, startServer } from './entries.js';
+import { SystemError, UserError } from './errors.js';
+import { defaultMiddlewares } from './middleware/index.js';
+import { createCache, createRedis } from './redis.js';
+const summarySchema = {
+    querystring: z.object({ currency: z.string().optional() }),
+    response: {
+        200: z.object({
+            status: z.string(),
+            message: z.string(),
+            data: z.object({ siteName: z.string(), currency: z.string() }),
+        }),
+    },
+};
+describe('端到端冒烟：defineServer → startServer → inject → generateOpenApi', () => {
+    it('真实装配路径跑通最小服务器（无 Postgres / 无 Redis / 无网络）', async () => {
+        const previousDatabaseUrl = process.env.DATABASE_URL;
+        const previousRedisUrl = process.env.REDIS_URL;
+        delete process.env.DATABASE_URL;
+        delete process.env.REDIS_URL;
+        const lifecycleEvents = [];
+        const counters = { readConfiguration: 0, disposeDatabase: 0 };
+        const database = {
+            readSystemConfiguration: async () => {
+                counters.readConfiguration += 1;
+                return { siteName: 'taicode-smoke', currency: 'CNY' };
+            },
+        };
+        try {
+            const server = defineServer({
+                app: { service: 'smoke', title: 'Smoke Service', version: '1.4.0' },
+                resources: (ctx) => {
+                    const redis = createRedis(ctx.env, ctx.log);
+                    return {
+                        // 构造但不建连；出 spec 路径也会构造
+                        database,
+                        redis,
+                        cache: createCache({ env: ctx.env, prefix: 'smoke', redis, log: ctx.log }),
+                    };
+                },
+                config: async ({ resources }) => {
+                    const configuration = await resources.database.readSystemConfiguration();
+                    return { siteName: configuration.siteName, currency: configuration.currency };
+                },
+                // 声明序即启动序（services 之间不得相互依赖）
+                services: (ctx) => {
+                    return {
+                        // routers 拿不到 resources / config，只能穿过 service
+                        // 配置一律在**调用期**现读：构造期不得读配置（出 spec 路径不跑 config 槽位）
+                        configuration: {
+                            readSiteName: () => ctx.config.siteName,
+                            readCurrency: () => ctx.config.currency,
+                        },
+                        ledger: {
+                            init: () => {
+                                lifecycleEvents.push('init:ledger');
+                            },
+                            dispose: () => {
+                                lifecycleEvents.push('dispose:ledger');
+                            },
+                        },
+                        repository: {
+                            init: () => {
+                                lifecycleEvents.push('init:repository');
+                            },
+                            dispose: () => {
+                                lifecycleEvents.push('dispose:repository');
+                            },
+                        },
+                        mailer: {
+                            init: () => {
+                                lifecycleEvents.push('init:mailer');
+                            },
+                            dispose: () => {
+                                lifecycleEvents.push('dispose:mailer');
+                            },
+                        },
+                        databaseLifecycle: {
+                            dispose: () => {
+                                counters.disposeDatabase += 1;
+                            },
+                        },
+                    };
+                },
+                // 默认预设 [cors, context, auth]
+                middlewares: (ctx) => defaultMiddlewares(ctx),
+                routers: (ctx) => {
+                    ctx.app.get('/ledger/summary', { schema: summarySchema }, () => ({
+                        siteName: ctx.services.configuration.readSiteName(),
+                        currency: ctx.services.configuration.readCurrency(),
+                    }));
+                    ctx.app.get('/ledger/invalid-token', () => {
+                        throw new UserError('INVALID_TOKEN', undefined, '令牌无效或已过期');
+                    });
+                    ctx.app.get('/ledger/database-down', () => {
+                        throw new SystemError('DATABASE_UNAVAILABLE', undefined, '数据库暂不可用');
+                    });
+                },
+            });
+            const app = await startServer(server, { listen: false });
+            // ── 装配期：声明序 init ────────────────────────────────────────────
+            expect(lifecycleEvents).toEqual(['init:ledger', 'init:repository', 'init:mailer']);
+            expect(counters.readConfiguration).toBe(1);
+            try {
+                // ── 业务路由：成功信封 ────────────────────────────────────────────
+                const summaryResponse = await app.inject({
+                    method: 'GET',
+                    url: '/ledger/summary?currency=CNY',
+                    headers: { 'x-request-id': 'smoke-summary-1' },
+                });
+                expect(summaryResponse.statusCode).toBe(200);
+                expect(summaryResponse.json()).toEqual({
+                    status: 'SUCCESS',
+                    message: 'ok',
+                    data: { siteName: 'taicode-smoke', currency: 'CNY' },
+                });
+                expect(summaryResponse.headers['x-request-id']).toBe('smoke-summary-1');
+                // ── UserError → 400 ───────────────────────────────────────────────
+                const userErrorResponse = await app.inject({ method: 'GET', url: '/ledger/invalid-token' });
+                expect(userErrorResponse.statusCode).toBe(400);
+                expect(userErrorResponse.json()).toEqual({
+                    status: 'INVALID_TOKEN',
+                    message: '令牌无效或已过期',
+                    data: null,
+                });
+                // ── SystemError → 500 ─────────────────────────────────────────────
+                const systemErrorResponse = await app.inject({ method: 'GET', url: '/ledger/database-down' });
+                expect(systemErrorResponse.statusCode).toBe(500);
+                expect(systemErrorResponse.json()).toEqual({
+                    status: 'DATABASE_UNAVAILABLE',
+                    message: '数据库暂不可用',
+                    data: null,
+                });
+                // ── 未匹配路由 → 404 ──────────────────────────────────────────────
+                const notFoundResponse = await app.inject({ method: 'GET', url: '/no-such-route' });
+                expect(notFoundResponse.statusCode).toBe(404);
+                expect(notFoundResponse.json()).toMatchObject({ status: 'NOT_IMPLEMENTED', data: null });
+                expect(notFoundResponse.headers['x-request-id']).toMatch(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/);
+                expect(notFoundResponse.json()).not.toHaveProperty('requestId');
+            }
+            finally {
+                await app.close();
+            }
+            // ── 关闭：services 逆序 dispose ─────────────────────────────────────
+            expect(lifecycleEvents).toEqual([
+                'init:ledger',
+                'init:repository',
+                'init:mailer',
+                'dispose:mailer',
+                'dispose:repository',
+                'dispose:ledger',
+            ]);
+            expect(counters.disposeDatabase).toBe(1);
+            // ── 同一份定义 → generateOpenApi：不跑 config、不重跑 init ──────────
+            const spec = (await generateOpenApi(server));
+            expect(counters.readConfiguration).toBe(1);
+            expect(lifecycleEvents).toHaveLength(6);
+            expect(spec.openapi).toBe('3.0.3');
+            expect(spec.info).toMatchObject({ title: 'Smoke Service', version: '1.4.0' });
+            expect(Object.keys(spec.paths ?? {})).toEqual(expect.arrayContaining(['/ledger/summary', '/ledger/invalid-token', '/ledger/database-down']));
+        }
+        finally {
+            if (previousDatabaseUrl === undefined) {
+                delete process.env.DATABASE_URL;
+            }
+            else {
+                process.env.DATABASE_URL = previousDatabaseUrl;
+            }
+            if (previousRedisUrl === undefined) {
+                delete process.env.REDIS_URL;
+            }
+            else {
+                process.env.REDIS_URL = previousRedisUrl;
+            }
+        }
+    });
+    it('非预置原生插件可在 routers(ctx) 里经 ctx.app.register() 注册并生效', async () => {
+        const smokeDecoratorPlugin = async (app) => {
+            app.decorate('smokeDecorator', () => 'smoke-decorated');
+            app.get('/plugin/decorated', () => ({
+                value: app.smokeDecorator(),
+            }));
+        };
+        const server = defineServer({
+            app: { service: 'smoke-plugin', title: 'Smoke Plugin', version: '1.0.0' },
+            resources: () => ({}),
+            config: () => ({}),
+            services: () => ({}),
+            middlewares: () => [],
+            routers: (ctx) => {
+                void ctx.app.register(smokeDecoratorPlugin);
+            },
+        });
+        const app = await startServer(server, { listen: false });
+        try {
+            const response = await app.inject({ method: 'GET', url: '/plugin/decorated' });
+            expect(response.statusCode).toBe(200);
+            expect(response.json()).toEqual({
+                status: 'SUCCESS',
+                message: 'ok',
+                data: { value: 'smoke-decorated' },
+            });
+        }
+        finally {
+            await app.close();
+        }
+    });
+});

package/output/app/test-support.d.ts

@@ -0,0 +1,21 @@
+import type { ConfigEnv } from './env.js';
+import type { LoggerLike } from './types.js';
+/**
+ * 测试公共助手（仅测试使用）。
+ *
+ * 只放「多个测试文件都要用」的小工具：记录型 logger、测试用 env。
+ * 断言与业务语义一律写在各自 `*.test.ts` 内，避免助手文件成为第二真相源。
+ */
+export interface LogEntry {
+    level: 'debug' | 'info' | 'warn' | 'error';
+    obj: unknown;
+    msg?: string;
+}
+/** 记录型 logger：满足 `LoggerLike`，便于断言「被调用了 / 在什么级别」 */
+export interface RecordingLogger extends LoggerLike {
+    readonly entries: LogEntry[];
+}
+export declare function createRecordingLogger(): RecordingLogger;
+/** 测试用 `ConfigEnv`（固定读取约定：`ENV` / `API_PORT` / `LOG_LEVEL` / `DATABASE_URL` / `REDIS_URL`） */
+export declare function createTestConfigEnv(overrides?: Partial<ConfigEnv>): ConfigEnv;
+//# sourceMappingURL=test-support.d.ts.map

package/output/app/test-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-support.d.ts","sourceRoot":"","sources":["../../source/app/test-support.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C;;;;;GAKG;AAEH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;IAC1C,GAAG,EAAE,OAAO,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,oDAAoD;AACpD,MAAM,WAAW,eAAgB,SAAQ,UAAU;IACjD,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAA;CAC7B;AAED,wBAAgB,qBAAqB,IAAI,eAAe,CAcvD;AAED,8FAA8F;AAC9F,wBAAgB,mBAAmB,CAAC,SAAS,GAAE,OAAO,CAAC,SAAS,CAAM,GAAG,SAAS,CASjF"}

package/output/app/test-support.js

@@ -0,0 +1,24 @@
+export function createRecordingLogger() {
+    const entries = [];
+    const record = (level) => (obj, msg) => {
+        entries.push({ level, obj, msg });
+    };
+    return {
+        entries,
+        debug: record('debug'),
+        info: record('info'),
+        warn: record('warn'),
+        error: record('error'),
+    };
+}
+/** 测试用 `ConfigEnv`（固定读取约定：`ENV` / `API_PORT` / `LOG_LEVEL` / `DATABASE_URL` / `REDIS_URL`） */
+export function createTestConfigEnv(overrides = {}) {
+    return {
+        ENV: 'test',
+        API_PORT: '',
+        LOG_LEVEL: 'info',
+        DATABASE_URL: '',
+        REDIS_URL: undefined,
+        ...overrides,
+    };
+}

package/output/app/type-augment.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 框架统一提供的类型增强（设计 §8「类型增强」红线）。
+ *
+ * `request.user` / `request.token` / `request.id` 与 `routeOptions.config.accessControls`（以及
+ * 限流规则 `rateLimit`）的 `declare module 'fastify'` 由 common 统一提供，各仓删除自建声明。
+ */
+import type { RequestContext } from '../context/index.js';
+/** 路由级访问控制声明（各服务在 `routeOptions.config.accessControls` 里写） */
+export type AccessControl = 'NoLoginRequired' | 'IgnorePermission' | 'RequiredSecurityCode';
+/** 路由级限流规则（`createRateLimitMiddleware` 消费，另有路由级 `config.rateLimit`） */
+export interface RateLimitRule {
+    limit: number;
+    /** 窗口大小（秒） */
+    window: number;
+    /** 限流键维度，默认 `['ip']` */
+    keys?: string[];
+}
+declare module 'fastify' {
+    interface FastifyRequest {
+        /** 认证后由 `auth` 中间件填充 */
+        user?: unknown;
+        /** 认证后由 `auth` 中间件填充 */
+        token?: unknown;
+        /** `createContextMiddleware()` 注入的请求级上下文 */
+        ctx?: RequestContext;
+    }
+    interface FastifyContextConfig {
+        /** 路由级访问控制（`NoLoginRequired` / `IgnorePermission` / `RequiredSecurityCode`） */
+        accessControls?: AccessControl[];
+        /** 路由级限流规则 */
+        rateLimit?: RateLimitRule;
+    }
+}
+//# sourceMappingURL=type-augment.d.ts.map

package/output/app/type-augment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-augment.d.ts","sourceRoot":"","sources":["../../source/app/type-augment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEzD,8DAA8D;AAC9D,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,sBAAsB,CAAA;AAE3F,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,cAAc;IACd,MAAM,EAAE,MAAM,CAAA;IACd,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAChB;AAED,OAAO,QAAQ,SAAS,CAAC;IACvB,UAAU,cAAc;QACtB,wBAAwB;QACxB,IAAI,CAAC,EAAE,OAAO,CAAA;QACd,wBAAwB;QACxB,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,4CAA4C;QAC5C,GAAG,CAAC,EAAE,cAAc,CAAA;KACrB;IAED,UAAU,oBAAoB;QAC5B,+EAA+E;QAC/E,cAAc,CAAC,EAAE,aAAa,EAAE,CAAA;QAChC,cAAc;QACd,SAAS,CAAC,EAAE,aAAa,CAAA;KAC1B;CACF"}

package/output/app/type-augment.js

@@ -0,0 +1,7 @@
+/**
+ * 框架统一提供的类型增强（设计 §8「类型增强」红线）。
+ *
+ * `request.user` / `request.token` / `request.id` 与 `routeOptions.config.accessControls`（以及
+ * 限流规则 `rateLimit`）的 `declare module 'fastify'` 由 common 统一提供，各仓删除自建声明。
+ */
+export {};