@taicode/common-server 4.0.0-beta.1 → 4.0.0-beta.10

package/output/app/resources.test.js

@@ -1,197 +0,0 @@
-import { describe, expect, expectTypeOf, it } from 'vitest';
-import { defineServer, generateOpenApi, startServer } from './entries.js';
-import { createTestConfigEnv } from './test-support.js';
-/** 资源包实现（显式标注返回类型：否则资源实现的回调参数会吃隐式 `any`） */
-function createResources() {
-    return {
-        database: { query: (sql) => `rows:${sql}` },
-        cache: { read: (key) => `${key}:cached` },
-        telemetry: false,
-        queue: undefined,
-    };
-}
-// ── 类型自证：`false` 键在 `Live<TestResources>` 中被剔除 ─────────
-const assertLiveKeysRemovesFalse = () => {
-    expectTypeOf().toEqualTypeOf();
-};
-void assertLiveKeysRemovesFalse;
-describe('resources 槽位（N1 §2 / N2 §2.3）', () => {
-    it('① 入参只有 env + log，且资源嵌套在 ctx.resources 下（config / services 都能用）', async () => {
-        let captured;
-        const observed = {};
-        const server = defineServer({
-            app: { service: 'resources-basic', title: 'Resources Basic', version: '1.0.0' },
-            resources: (ctx) => {
-                captured = ctx;
-                return createResources();
-            },
-            config: (ctx) => {
-                // 类型自证：精确到资源包里的声明类型（不是 unknown / any）
-                expectTypeOf(ctx.resources.database.query).toEqualTypeOf();
-                observed.inConfig = ctx.resources.database.query('select 1');
-                return { domain: 'example.com' };
-            },
-            services: (ctx) => {
-                expectTypeOf(ctx.resources.cache.read).toEqualTypeOf();
-                observed.inServices = ctx.resources.cache.read('domain');
-                return {};
-            },
-            middlewares: () => [],
-            routers: (ctx) => {
-                ctx.app.get('/resource', () => ({ ok: true }));
-            },
-        });
-        const app = await startServer(server, { listen: false });
-        try {
-            expect(Object.keys(captured ?? {}).sort()).toEqual(['env', 'log']);
-            expect(captured?.env.ENV).toBeTypeOf('string');
-            expect(typeof captured?.log.info).toBe('function');
-            expect(observed.inConfig).toBe('rows:select 1');
-            expect(observed.inServices).toBe('domain:cached');
-            const response = await app.inject({ method: 'GET', url: '/resource' });
-            expect(response.statusCode).toBe(200);
-        }
-        finally {
-            await app.close();
-        }
-    });
-    it('② `false` 关闭资源：装配正常，键在类型与运行时都不存在', async () => {
-        let ctxInServices;
-        const server = defineServer({
-            app: { service: 'resources-disabled', title: 'Resources Disabled', version: '1.0.0' },
-            resources: createResources,
-            config: () => ({}),
-            services: (ctx) => {
-                // 编译期：`telemetry` 被 `Live<>` 剔除 → 访问必须编译失败
-                // @ts-expect-error `telemetry: false` 已从资源视图中剔除
-                void ctx.resources.telemetry;
-                ctxInServices = ctx;
-                return {};
-            },
-            middlewares: () => [],
-            routers: (ctx) => {
-                ctx.app.get('/alive', () => ({ ok: true }));
-            },
-        });
-        const app = await startServer(server, { listen: false });
-        try {
-            // 运行时也不存在该键（与类型一致）
-            const resources = ctxInServices.resources;
-            expect('telemetry' in resources).toBe(false);
-            const response = await app.inject({ method: 'GET', url: '/alive' });
-            expect(response.statusCode).toBe(200);
-        }
-        finally {
-            await app.close();
-        }
-    });
-    it('③ 缺省可选资源：类型为 `T | undefined`，运行时为 undefined（键仍在）', async () => {
-        const observed = {};
-        const server = defineServer({
-            app: { service: 'resources-optional', title: 'Resources Optional', version: '1.0.0' },
-            resources: createResources,
-            config: (ctx) => {
-                expectTypeOf(ctx.resources.queue).toEqualTypeOf();
-                observed.inConfig = ctx.resources.queue;
-                return {};
-            },
-            services: (ctx) => {
-                observed.inServices = ctx.resources.queue;
-                observed.keys = Object.keys(ctx.resources);
-                return {};
-            },
-            middlewares: () => [],
-            routers: () => undefined,
-        });
-        const app = await startServer(server, { listen: false });
-        try {
-            expect(observed.inConfig).toBeUndefined();
-            expect(observed.inServices).toBeUndefined();
-            expect(observed.keys).toContain('queue');
-        }
-        finally {
-            await app.close();
-        }
-    });
-    it('④ resources 允许异步：返回 Promise<资源包> 时同样是精确类型', async () => {
-        let domain;
-        const server = defineServer({
-            app: { service: 'resources-async', title: 'Resources Async', version: '1.0.0' },
-            resources: async () => ({
-                database: { query: (sql) => `async:${sql}` },
-            }),
-            config: (ctx) => {
-                expectTypeOf(ctx.resources.database.query).toEqualTypeOf();
-                return { domain: ctx.resources.database.query('domain') };
-            },
-            services: (ctx) => {
-                domain = ctx.config.domain;
-                return {};
-            },
-            middlewares: () => [],
-            routers: (ctx) => {
-                ctx.app.get('/ping', () => ({ ok: true }));
-            },
-        });
-        const app = await startServer(server, { listen: false });
-        try {
-            expect(domain).toBe('async:domain');
-        }
-        finally {
-            await app.close();
-        }
-    });
-    it('⑤ 框架不管资源生命周期：资源上的 dispose 不被调用（释放要放 services）', async () => {
-        const calls = [];
-        const server = defineServer({
-            app: { service: 'resources-lifecycle', title: 'Resources Lifecycle', version: '1.0.0' },
-            resources: () => ({
-                database: {
-                    dispose: () => {
-                        calls.push('dispose:resource');
-                    },
-                },
-            }),
-            config: () => ({}),
-            services: () => ({
-                databaseClient: {
-                    dispose: () => {
-                        calls.push('dispose:service');
-                    },
-                },
-            }),
-            middlewares: () => [],
-            routers: () => undefined,
-        });
-        const app = await startServer(server, { listen: false });
-        await app.close();
-        expect(calls).toEqual(['dispose:service']);
-    });
-    it('⑥ 出 spec 路径同样跑 resources（只构造，不建连）', async () => {
-        let calls = 0;
-        const server = defineServer({
-            app: { service: 'resources-openapi', title: 'Resources OpenApi', version: '1.0.0' },
-            resources: () => {
-                calls += 1;
-                return {};
-            },
-            config: () => ({}),
-            services: () => ({}),
-            middlewares: () => [],
-            routers: () => undefined,
-        });
-        await generateOpenApi(server);
-        expect(calls).toBe(1);
-    });
-});
-/** `ResourcesView` 自证：`Awaited<>` 归一（同步 / 异步两写法等价） */
-const assertResourcesViewNormalizes = () => {
-    expectTypeOf().toEqualTypeOf();
-    expectTypeOf().toEqualTypeOf();
-};
-void assertResourcesViewNormalizes;
-/** 测试用 env 自证：固定读取约定里的五项 */
-const assertTestConfigEnv = () => {
-    expectTypeOf(createTestConfigEnv().ENV).toEqualTypeOf();
-};
-void assertTestConfigEnv;

package/output/app/shutdown.d.ts

@@ -1,22 +0,0 @@
-/**
- * 固定关闭步（N1 §5）——**顺序写死在数组里**。
- *
- * 新口径下框架不再持有 Redis / 数据库 / 外链客户端（这些都在 `resources` 里，由各仓自行构造，
- * 需要释放时放 `services` 单元）；配置失效通道已删除，故没有 `unsubscribeConfig` 步。
- *
- * 固定两步：`stopProducers`（`ctx.disposer` 注册的清理）→ `disposeServices`（services 逆序）。
- *
- * 每步失败记日志、不阻断后续，最后聚合上报。
- */
-export declare const SHUTDOWN_ORDER: readonly ["stopProducers", "disposeServices"];
-export type ShutdownStepName = (typeof SHUTDOWN_ORDER)[number];
-export type ShutdownHandles = Record<ShutdownStepName, () => void | Promise<void>>;
-export interface ShutdownLogger {
-    error: (obj: unknown, msg?: string) => void;
-}
-/**
- * 顺序执行关闭步骤；单步抛错记录后**继续**后续步骤，最后聚合上报
- * （避免「一步报错导致后面资源没关」）。
- */
-export declare function runShutdown(handles: ShutdownHandles, log: ShutdownLogger): Promise<void>;
-//# sourceMappingURL=shutdown.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../../source/app/shutdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,+CAAgD,CAAA;AAE3E,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AAE9D,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,gBAAgB,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;AAElF,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAC5C;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAe9F"}

package/output/app/shutdown.js

@@ -1,30 +0,0 @@
-/**
- * 固定关闭步（N1 §5）——**顺序写死在数组里**。
- *
- * 新口径下框架不再持有 Redis / 数据库 / 外链客户端（这些都在 `resources` 里，由各仓自行构造，
- * 需要释放时放 `services` 单元）；配置失效通道已删除，故没有 `unsubscribeConfig` 步。
- *
- * 固定两步：`stopProducers`（`ctx.disposer` 注册的清理）→ `disposeServices`（services 逆序）。
- *
- * 每步失败记日志、不阻断后续，最后聚合上报。
- */
-export const SHUTDOWN_ORDER = ['stopProducers', 'disposeServices'];
-/**
- * 顺序执行关闭步骤；单步抛错记录后**继续**后续步骤，最后聚合上报
- * （避免「一步报错导致后面资源没关」）。
- */
-export async function runShutdown(handles, log) {
-    const errors = [];
-    for (const step of SHUTDOWN_ORDER) {
-        try {
-            await handles[step]();
-        }
-        catch (error) {
-            errors.push(error);
-            log.error({ error, step }, '[shutdown] step failed');
-        }
-    }
-    if (errors.length > 0) {
-        log.error({ errors, count: errors.length }, '[shutdown] completed with errors');
-    }
-}

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

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

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

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

package/output/app/shutdown.test.js

@@ -1,103 +0,0 @@
-import { describe, expect, it } from 'vitest';
-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 createRecordingHandles(record, throwOn) {
-    const step = (name) => () => {
-        record.push(name);
-        if (name === throwOn) {
-            throw new Error(`boom:${name}`);
-        }
-    };
-    return {
-        stopProducers: step('stopProducers'),
-        disposeServices: step('disposeServices'),
-    };
-}
-describe('SHUTDOWN_ORDER', () => {
-    it('固定两步且顺序不可变', () => {
-        expect(SHUTDOWN_ORDER).toEqual(['stopProducers', 'disposeServices']);
-    });
-});
-describe('runShutdown', () => {
-    it('按固定序执行全部步骤', async () => {
-        const record = [];
-        const { log } = createShutdownLog();
-        await runShutdown(createRecordingHandles(record), log);
-        expect(record).toEqual([...SHUTDOWN_ORDER]);
-    });
-    it('单步抛错不阻断后续，并聚合上报', async () => {
-        const record = [];
-        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);
-    });
-});
-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.addDisposer(() => {
-                    calls.push('stopProducers');
-                });
-                return {
-                    a: {
-                        dispose: () => {
-                            calls.push('disposeServiceA');
-                        },
-                    },
-                    b: {
-                        dispose: () => {
-                            calls.push('disposeServiceB');
-                        },
-                    },
-                };
-            },
-            middlewares: () => [],
-            routers: () => undefined,
-        });
-        const app = await startServer(server, { listen: false });
-        await app.close();
-        // 资源不在生命周期内（框架只管 services）
-        expect(calls).toEqual(['stopProducers', 'disposeServiceB', 'disposeServiceA']);
-    });
-    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: () => {
-                        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(calls).toEqual(['custom']);
-    });
-});

package/output/app/signal.d.ts

@@ -1,12 +0,0 @@
-import type { LoggerLike } from './types.js';
-import type { FastifyInstance } from 'fastify';
-/**
- * 内置信号处理（设计 §7.1 `activate` 尾部 / §7.2）。
- *
- * `SIGTERM` / `SIGINT` / `uncaughtException` / `unhandledRejection` ⇒ `app.close()`（触发 `onClose`
- * 的关闭 6 步）⇒ `process.exit(0/1)`。**仅 `listen: true` 时装信号处理**。
- *
- * @returns detach 函数（移除本次注册的监听器）
- */
-export declare function attachSignalHandlers(app: FastifyInstance, log: LoggerLike): () => void;
-//# sourceMappingURL=signal.d.ts.map

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

@@ -1 +0,0 @@
-{"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/smoke.test.d.ts

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

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

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

package/output/app/smoke.test.js

@@ -1,210 +0,0 @@
-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

@@ -1,21 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,24 +0,0 @@
-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.map

@@ -1 +0,0 @@
-{"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"}