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

package/output/app/database.js

@@ -1,40 +0,0 @@
-import { SystemError } from '@taicode/common-base';
-/** common 默认的统一 operation 标签（design §2.3：抽进 common 时统一口径） */
-const DEFAULT_OPERATION_LABELS = {
-    known: '已知请求错误',
-    unknown: '未知请求错误',
-    validation: '参数校验错误',
-    initialization: '初始化错误',
-    rustPanic: '引擎崩溃',
-};
-/**
- * `database` 模块的默认实现：Prisma（design §3.3 / 调研 D）。
- *
- * 返回类型即 `defineServer<Db>` 的 `Db`，调用方据此**推断**类型、无需强转（决策 10-2）。
- */
-export function createPrismaDatabaseModule(params) {
-    const labels = { ...DEFAULT_OPERATION_LABELS, ...params.operationLabels };
-    return {
-        name: 'database',
-        createClient: (clientParams) => {
-            const args = params.createClientArgs ? params.createClientArgs(clientParams) : [];
-            return Reflect.construct(params.PrismaClient, args);
-        },
-        classifyError: (error) => {
-            const hit = (Ctor, label) => (error instanceof Ctor ? label : null);
-            const namespace = params.PrismaNamespace;
-            const label = hit(namespace.PrismaClientKnownRequestError, labels.known) ??
-                hit(namespace.PrismaClientUnknownRequestError, labels.unknown) ??
-                hit(namespace.PrismaClientValidationError, labels.validation) ??
-                hit(namespace.PrismaClientInitializationError, labels.initialization) ??
-                hit(namespace.PrismaClientRustPanicError, labels.rustPanic);
-            return label ? new SystemError('DATABASE_ERROR', { operation: label }, label) : null;
-        },
-        dispose: async (db) => {
-            const target = db;
-            if (typeof target.$disconnect === 'function') {
-                await target.$disconnect();
-            }
-        },
-    };
-}

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

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

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

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

package/output/app/database.test.js

@@ -1,66 +0,0 @@
-import { SystemError } from '@taicode/common-base';
-import { describe, expect, it } from 'vitest';
-import { createPrismaDatabaseModule } from './database.js';
-const TEST_CONFIG = { loadConfig: () => ({ debug: false, port: 0 }) };
-const NAMESPACE = {
-    PrismaClientKnownRequestError: class extends Error {
-    },
-    PrismaClientUnknownRequestError: class extends Error {
-    },
-    PrismaClientValidationError: class extends Error {
-    },
-    PrismaClientInitializationError: class extends Error {
-    },
-    PrismaClientRustPanicError: class extends Error {
-    },
-};
-class Client {
-    static lastArgs = [];
-    disconnected = false;
-    constructor(...args) {
-        Client.lastArgs = args;
-    }
-    async $disconnect() {
-        this.disconnected = true;
-    }
-}
-describe('createPrismaDatabaseModule', () => {
-    it('createClient 使用注入的构造函数与参数工厂（common 不依赖 @prisma/client）', async () => {
-        const database = createPrismaDatabaseModule({
-            PrismaClient: Client,
-            PrismaNamespace: NAMESPACE,
-            createClientArgs: (params) => [{ adapter: params.postgresConfig }],
-        });
-        const client = await database.createClient({ config: TEST_CONFIG, postgresConfig: { schema: 'test' } });
-        expect(client).toBeInstanceOf(Client);
-        expect(Client.lastArgs).toEqual([{ adapter: { schema: 'test' } }]);
-    });
-    it('省略 createClientArgs 时等价于 new PrismaClient()', async () => {
-        const database = createPrismaDatabaseModule({ PrismaClient: Client, PrismaNamespace: NAMESPACE });
-        await database.createClient({ config: TEST_CONFIG, postgresConfig: undefined });
-        expect(Client.lastArgs).toEqual([]);
-    });
-    it('classifyError 命中 5 类错误时返回 SystemError(DATABASE_ERROR)，未命中返回 null', () => {
-        const database = createPrismaDatabaseModule({ PrismaClient: Client, PrismaNamespace: NAMESPACE });
-        const known = database.classifyError(new NAMESPACE.PrismaClientKnownRequestError());
-        expect(SystemError.is(known)).toBe(true);
-        expect(known?.type).toBe('DATABASE_ERROR');
-        expect(known?.context?.operation).toBe('已知请求错误');
-        expect(database.classifyError(new NAMESPACE.PrismaClientRustPanicError())?.context?.operation).toBe('引擎崩溃');
-        expect(database.classifyError(new Error('plain'))).toBeNull();
-    });
-    it('operationLabels 可覆盖默认标签', () => {
-        const database = createPrismaDatabaseModule({
-            PrismaClient: Client,
-            PrismaNamespace: NAMESPACE,
-            operationLabels: { known: 'ClientKnown' },
-        });
-        expect(database.classifyError(new NAMESPACE.PrismaClientKnownRequestError())?.context?.operation).toBe('ClientKnown');
-    });
-    it('dispose 调用 db.$disconnect()', async () => {
-        const database = createPrismaDatabaseModule({ PrismaClient: Client, PrismaNamespace: NAMESPACE });
-        const client = await database.createClient({ config: TEST_CONFIG, postgresConfig: undefined });
-        await database.dispose?.(client);
-        expect(client.disconnected).toBe(true);
-    });
-});

package/output/app/default-modules.d.ts

@@ -1,23 +0,0 @@
-import type { ModuleName, ServerModule } from './module.js';
-/**
- * 默认 `env` 模块（P1 空实现）。
- *
- * `loadEnvFiles()` 是独立导出、在骨架之前调用（决策 #5），因此这里只作为「封闭集合内的合法名字」存在。
- */
-export declare function createEnvModule(): ServerModule;
-/**
- * P1 默认 `redis` 模块（透传）。
- *
- * 骨架只持有 `createRedis()` 返回的 `{ client, dispose }`；未传 `createRedis` 时第 4 步空转
- * （notice 即是此形态）。
- */
-export declare function createRedisModule(): ServerModule;
-/**
- * P1 有默认实现的模块（`env` / `redis`）。
- *
- * ⚠️ 故意不含 `database`：common 无法引用各仓生成的 Prisma client（决策 #8），给个「不建连」的
- * 空实现会埋下静默无 DB 的雷，因此 `database` 必须由调用方**显式**给出
- * `createPrismaDatabaseModule({ ... })` 或 `false`（装配期强制，见 `assemble.ts`）。
- */
-export declare function createDefaultModules(): Partial<Record<ModuleName, ServerModule>>;
-//# sourceMappingURL=default-modules.d.ts.map

package/output/app/default-modules.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"default-modules.d.ts","sourceRoot":"","sources":["../../source/app/default-modules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE3D;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,YAAY,CAYhD;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAKhF"}

package/output/app/default-modules.js

@@ -1,40 +0,0 @@
-/**
- * 默认 `env` 模块（P1 空实现）。
- *
- * `loadEnvFiles()` 是独立导出、在骨架之前调用（决策 #5），因此这里只作为「封闭集合内的合法名字」存在。
- */
-export function createEnvModule() {
-    return { name: 'env' };
-}
-/**
- * P1 默认 `redis` 模块（透传）。
- *
- * 骨架只持有 `createRedis()` 返回的 `{ client, dispose }`；未传 `createRedis` 时第 4 步空转
- * （notice 即是此形态）。
- */
-export function createRedisModule() {
-    return {
-        name: 'redis',
-        steps: {
-            createRedis: (ctx) => {
-                const handle = ctx.options.createRedis?.(ctx.options.config);
-                if (handle) {
-                    ctx.state.redis = handle;
-                }
-            },
-        },
-    };
-}
-/**
- * P1 有默认实现的模块（`env` / `redis`）。
- *
- * ⚠️ 故意不含 `database`：common 无法引用各仓生成的 Prisma client（决策 #8），给个「不建连」的
- * 空实现会埋下静默无 DB 的雷，因此 `database` 必须由调用方**显式**给出
- * `createPrismaDatabaseModule({ ... })` 或 `false`（装配期强制，见 `assemble.ts`）。
- */
-export function createDefaultModules() {
-    return {
-        env: createEnvModule(),
-        redis: createRedisModule(),
-    };
-}

package/output/app/define-server.d.ts

@@ -1,12 +0,0 @@
-import type { DefineServerOptions, ServerInstance } from './types.js';
-/**
- * 模块化装配 + 15 步固定编排（design §3 / §4 / §5；提案 §11）。
- *
- * 返回**原生 `FastifyInstance`**（不包 `fastify-plugin`、不返回包装对象）——调用方可直接
- * `app.swagger()` / `app.inject()` / `app.decorate()`。`mode: 'openapi-build'` 时不 listen，
- * 由调用方读 `app.swagger()`。
- *
- * `Db` 由 `modules.database`（`database` 模块的 `createClient` 返回类型）推断（决策 10-2）。
- */
-export declare function defineServer<Db = unknown, S = unknown>(options: DefineServerOptions<Db, S>): Promise<ServerInstance>;
-//# sourceMappingURL=define-server.d.ts.map

package/output/app/define-server.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"define-server.d.ts","sourceRoot":"","sources":["../../source/app/define-server.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,mBAAmB,EAInB,cAAc,EAIf,MAAM,YAAY,CAAA;AA4QnB;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAC1D,OAAO,EAAE,mBAAmB,CAAC,EAAE,EAAE,CAAC,CAAC,GAClC,OAAO,CAAC,cAAc,CAAC,CAsBzB"}

package/output/app/define-server.js

@@ -1,289 +0,0 @@
-import { Disposer } from '@taicode/common-base';
-import Fastify, {} from 'fastify';
-import { assembleModules } from './assemble.js';
-import { attachSignalHandlers } from './signal.js';
-import { SHUTDOWN_ORDER } from './shutdown.js';
-import { SKIP_BY_MODE, STEP_ORDER } from './steps.js';
-const NOOP_LOGGER = {
-    debug: () => undefined,
-    info: () => undefined,
-    warn: () => undefined,
-    error: () => undefined,
-};
-function requireApp(state) {
-    if (!state.app) {
-        throw new Error('Fastify instance has not been created yet');
-    }
-    return state.app;
-}
-function resolveLog(options, state) {
-    if (options.log) {
-        return options.log;
-    }
-    if (state.app) {
-        return state.app.log;
-    }
-    return NOOP_LOGGER;
-}
-function collectHooks(resolved) {
-    const hooks = {};
-    for (const name of resolved.order) {
-        const module = resolved.byName[name];
-        if (module?.hooks) {
-            Object.assign(hooks, module.hooks);
-        }
-    }
-    return hooks;
-}
-function collectPlugins(resolved, options) {
-    const plugins = [];
-    for (const name of resolved.order) {
-        const module = resolved.byName[name];
-        if (module?.plugins) {
-            plugins.push(...module.plugins);
-        }
-    }
-    if (options.extraPlugins) {
-        plugins.push(...options.extraPlugins);
-    }
-    return plugins;
-}
-function buildStepImplementations(resolved, options, moduleHooks) {
-    const implementations = {};
-    // 1) 固定骨架步骤的内置实现（模块可覆盖既定槽位，但无法新增 / 重排步骤）
-    implementations.createFastify = (ctx) => {
-        ctx.state.app = Fastify({ logger: ctx.options.config.loadConfig().debug, trustProxy: true });
-    };
-    implementations.registerCorePlugins = async (ctx) => {
-        const app = requireApp(ctx.state);
-        for (const plugin of collectPlugins(resolved, ctx.options)) {
-            await app.register(plugin);
-        }
-    };
-    implementations.onClose = (ctx) => {
-        const shutdownImplementations = buildShutdownImplementations(resolved, moduleHooks);
-        requireApp(ctx.state).addHook('onClose', () => runShutdown(ctx, shutdownImplementations, moduleHooks));
-    };
-    implementations.ready = async (ctx) => {
-        await requireApp(ctx.state).ready();
-    };
-    implementations.listen = async (ctx) => {
-        const app = requireApp(ctx.state);
-        const host = ctx.options.serverOptions?.host ?? '0.0.0.0';
-        const port = ctx.options.serverOptions?.port ?? ctx.options.config.loadConfig().port;
-        await app.listen({ port, host });
-        if (ctx.options.signal !== false) {
-            attachSignalHandlers(app, ctx.log);
-        }
-    };
-    // 2) 数据层端口 → 第 3 步（database 模块的整体覆盖也在此生效）
-    const database = resolved.database;
-    if (database) {
-        implementations['database.createClient'] = async (ctx) => {
-            const loadPostgresConfig = ctx.options.config.loadPostgresConfig;
-            const postgresConfig = loadPostgresConfig ? await loadPostgresConfig() : undefined;
-            ctx.state.db = await database.createClient({ config: ctx.options.config, postgresConfig });
-        };
-    }
-    // 3) 模块贡献的步骤实现（注册顺序 = MODULE_NAMES 顺序）
-    for (const name of resolved.order) {
-        const module = resolved.byName[name];
-        if (module?.steps) {
-            Object.assign(implementations, module.steps);
-        }
-    }
-    // 4) 调用方槽位（调用方优先级最高）
-    if (options.setupCompilers) {
-        implementations.setupCompilers = (ctx) => {
-            ctx.options.setupCompilers?.(requireApp(ctx.state));
-        };
-    }
-    if (options.initGlobalConfig) {
-        implementations.initGlobalConfig = (ctx) => {
-            const globalConfigOptions = {
-                redisUrl: ctx.options.config.resolveRedisUrl?.(),
-                channelPrefix: ctx.options.config.resolveCachePrefix?.(),
-            };
-            const dispose = ctx.options.initGlobalConfig?.(ctx.state.db, globalConfigOptions);
-            if (typeof dispose === 'function') {
-                ctx.state.disposeConfig = dispose;
-            }
-        };
-    }
-    if (options.initClients) {
-        implementations.initClients = async (ctx) => {
-            const unsubscribe = await ctx.options.initClients?.({
-                db: ctx.state.db,
-                redis: ctx.state.redis?.client,
-                globalConfig: ctx.state.globalConfig,
-            });
-            if (typeof unsubscribe === 'function') {
-                ctx.state.unsubscribe = unsubscribe;
-            }
-        };
-    }
-    implementations.createServices = (ctx) => {
-        ctx.state.services = ctx.options.createServices({
-            db: ctx.state.db,
-            redis: ctx.state.redis?.client,
-            globalConfig: ctx.state.globalConfig,
-        });
-    };
-    if (options.initServices || options.afterInit) {
-        implementations.initServices = async (ctx) => {
-            if (ctx.options.initServices) {
-                await ctx.options.initServices({ services: ctx.state.services });
-            }
-            if (ctx.options.afterInit) {
-                const disposer = await ctx.options.afterInit({
-                    db: ctx.state.db,
-                    redis: ctx.state.redis?.client,
-                    globalConfig: ctx.state.globalConfig,
-                    services: ctx.state.services,
-                });
-                if (typeof disposer === 'function') {
-                    ctx.state.disposer.addDisposer(disposer);
-                }
-            }
-        };
-    }
-    if (options.backgroundWorkers) {
-        implementations.backgroundWorkers = async (ctx) => {
-            await ctx.options.backgroundWorkers?.({
-                db: ctx.state.db,
-                redis: ctx.state.redis?.client,
-                globalConfig: ctx.state.globalConfig,
-                services: ctx.state.services,
-                disposer: ctx.state.disposer,
-            });
-        };
-    }
-    implementations.registerRouters = async (ctx) => {
-        await ctx.options.registerRouters(requireApp(ctx.state), { services: ctx.state.services });
-    };
-    if (options.afterReady) {
-        implementations.afterReady = async (ctx) => {
-            await ctx.options.afterReady?.({ app: requireApp(ctx.state), services: ctx.state.services });
-        };
-    }
-    return implementations;
-}
-async function disposeServiceMap(services) {
-    if (typeof services !== 'object' || services === null) {
-        return;
-    }
-    const record = services;
-    const pending = Object.values(record).map((service) => {
-        const candidate = service;
-        return typeof candidate.dispose === 'function' ? candidate.dispose() : undefined;
-    });
-    await Promise.allSettled(pending);
-}
-function buildShutdownImplementations(resolved, moduleHooks) {
-    const implementations = {
-        stopProducers: async (ctx) => {
-            await ctx.state.disposer.dispose();
-        },
-        unsubscribeConfig: async (ctx) => {
-            await ctx.state.unsubscribe?.();
-        },
-        disposeConfig: async (ctx) => {
-            await ctx.state.disposeConfig?.();
-        },
-        disposeServices: async (ctx) => {
-            const disposeServices = ctx.options.disposeServices ?? moduleHooks.disposeServices;
-            if (disposeServices) {
-                await disposeServices({ services: ctx.state.services });
-            }
-            else {
-                await disposeServiceMap(ctx.state.services);
-            }
-        },
-        disposeClients: async (ctx) => {
-            const disposeClients = ctx.options.disposeClients ?? moduleHooks.disposeClients;
-            await disposeClients?.();
-        },
-        disposeRedis: async (ctx) => {
-            await ctx.state.redis?.dispose();
-        },
-        disposeDb: async (ctx) => {
-            await resolved.database?.dispose?.(ctx.state.db);
-        },
-    };
-    for (const name of resolved.order) {
-        const module = resolved.byName[name];
-        if (module?.shutdown) {
-            Object.assign(implementations, module.shutdown);
-        }
-    }
-    return implementations;
-}
-async function runShutdown(ctx, implementations, moduleHooks) {
-    const errors = [];
-    const options = ctx.options;
-    const shutdown = options.shutdown ?? moduleHooks.shutdown;
-    const beforeShutdown = options.beforeShutdown ?? moduleHooks.beforeShutdown;
-    if (shutdown) {
-        try {
-            await shutdown('onClose');
-        }
-        catch (error) {
-            errors.push(error);
-        }
-    }
-    else {
-        if (beforeShutdown) {
-            try {
-                await beforeShutdown();
-            }
-            catch (error) {
-                errors.push(error);
-            }
-        }
-        for (const step of SHUTDOWN_ORDER) {
-            const implementation = implementations[step];
-            if (!implementation) {
-                continue;
-            }
-            try {
-                await implementation(ctx);
-            }
-            catch (error) {
-                errors.push(error);
-            }
-        }
-    }
-    if (errors.length > 0) {
-        ctx.log.error({ errors, count: errors.length }, '[shutdown] completed with errors');
-    }
-}
-/**
- * 模块化装配 + 15 步固定编排（design §3 / §4 / §5；提案 §11）。
- *
- * 返回**原生 `FastifyInstance`**（不包 `fastify-plugin`、不返回包装对象）——调用方可直接
- * `app.swagger()` / `app.inject()` / `app.decorate()`。`mode: 'openapi-build'` 时不 listen，
- * 由调用方读 `app.swagger()`。
- *
- * `Db` 由 `modules.database`（`database` 模块的 `createClient` 返回类型）推断（决策 10-2）。
- */
-export async function defineServer(options) {
-    const internal = options;
-    const mode = internal.mode ?? 'production';
-    const resolved = assembleModules(internal.modules);
-    const state = { disposer: new Disposer() };
-    const moduleHooks = collectHooks(resolved);
-    const implementations = buildStepImplementations(resolved, internal, moduleHooks);
-    const skipped = new Set(SKIP_BY_MODE[mode]);
-    for (const step of STEP_ORDER) {
-        if (skipped.has(step)) {
-            continue;
-        }
-        const ctx = { options: internal, state, log: resolveLog(internal, state) };
-        ctx.log.debug({ step }, '[boot]');
-        const implementation = implementations[step];
-        if (implementation) {
-            await implementation(ctx);
-        }
-    }
-    return requireApp(state);
-}

package/output/app/module.d.ts

@@ -1,88 +0,0 @@
-import type { SystemError } from '@taicode/common-base';
-import type { FastifyPluginAsync } from 'fastify';
-import type { ConfigModule, ServerHooks, ShutdownImplementations, StepImplementations } from './types.js';
-/**
- * 封闭模块名集合（design §3.1 十项）。
- *
- * 数组顺序即「注册顺序」，也是装配期报错文案里 `Allowed: ...` 的顺序，**不得重排**。
- */
-export declare const MODULE_NAMES: readonly ["env", "database", "redis", "context", "response", "cors", "schema", "rate-limit", "auth", "openapi"];
-export type ModuleName = (typeof MODULE_NAMES)[number];
-/**
- * P1 尚未提供默认实现的模块 → 各自的落地阶段（design §3.1 十项里除 `env` / `database` / `redis`
- * 之外的七个）。阶段号取自 `proposals/P1-boot-shutdown.md`：`openapi` 在 P2、`auth` 在 P4、其余在 P3。
- *
- * P1 过渡规则（design §3.2 + 提案 §3.3）：这些名字**必须由调用方显式写 `false`**（或直接提供
- * 一个同名的整体覆盖实现），否则装配期按**真实阶段号**报错 —— 静默 no-op 会让调用方少注册插件
- * 却启动成功。
- */
-export declare const PENDING_MODULES: {
-    readonly context: "P3";
-    readonly response: "P3";
-    readonly cors: "P3";
-    readonly schema: "P3";
-    readonly 'rate-limit': "P3";
-    readonly auth: "P4";
-    readonly openapi: "P2";
-};
-export type PendingModuleName = keyof typeof PENDING_MODULES;
-export type PendingModuleStage = (typeof PENDING_MODULES)[PendingModuleName];
-/** 模块契约：可贡献「初始化步骤实现 / Fastify 插件 / 生命周期 hook / 关闭逻辑」四类东西（design §3.1） */
-export interface ServerModule {
-    /** 具名单元；装配期校验「键 == name」「不重复」「在封闭集合内」 */
-    name: ModuleName;
-    /** ① 初始化步骤实现：key 只能是 §4.1 的既定槽位，不得新增 / 重排步骤 */
-    steps?: Partial<StepImplementations>;
-    /** ② Fastify 插件：注册进第 7 步 `registerCorePlugins` */
-    plugins?: FastifyPluginAsync[];
-    /** ③ 生命周期 hook（见 design §4.2）；模块提供的 hook 不再是顶层选项 */
-    hooks?: ServerHooks;
-    /** ④ 关闭逻辑：只能命中 §5 的 7 个既定槽位 */
-    shutdown?: Partial<ShutdownImplementations>;
-    /** 依赖的其它模块名；装配期做拓扑校验（指向被跳过的模块即报错） */
-    dependsOn?: ModuleName[];
-}
-/** 模块装配入参（design §3.2）：未出现 = 默认实现；`false` = 跳过；对象 = 整体覆盖 */
-export interface ModuleAssembly<Db = unknown> {
-    env?: false | ServerModule;
-    database?: false | DatabaseModule<Db>;
-    redis?: false | ServerModule;
-    context?: false | ServerModule;
-    response?: false | ServerModule;
-    cors?: false | ServerModule;
-    schema?: false | ServerModule;
-    'rate-limit'?: false | ServerModule;
-    auth?: false | ServerModule;
-    openapi?: false | ServerModule;
-}
-/** `database` 模块步骤 3 的入参（design §3.3） */
-export interface DatabaseClientParams {
-    config: ConfigModule;
-    postgresConfig: unknown;
-}
-/** 各仓生成的 Prisma 命名空间里、错误分类用到的 5 个错误类构造器（跨包 instanceof 不可靠，决策 #9） */
-export interface PrismaErrorConstructors {
-    PrismaClientKnownRequestError: new (...args: never[]) => unknown;
-    PrismaClientUnknownRequestError: new (...args: never[]) => unknown;
-    PrismaClientValidationError: new (...args: never[]) => unknown;
-    PrismaClientInitializationError: new (...args: never[]) => unknown;
-    PrismaClientRustPanicError: new (...args: never[]) => unknown;
-}
-export type PrismaOperationKey = 'known' | 'unknown' | 'validation' | 'initialization' | 'rustPanic';
-/** 可选覆盖的 operation 标签（默认对齐 design §2.3 的统一口径） */
-export type PrismaOperationLabels = Partial<Record<PrismaOperationKey, string>>;
-/**
- * 数据层端口（design §3.3）：任何实现只要满足它即可整体替换。
- *
- * 契约相同（同名、同贡献面）即可换实现——「支持非 Prisma 数据库」靠模块替换达成。
- */
-export interface DatabaseModule<Db = unknown> extends ServerModule {
-    name: 'database';
-    /** 步骤 3：建立连接。默认 Prisma 实现 = `new PrismaClient(...)` */
-    createClient(params: DatabaseClientParams): Db | Promise<Db>;
-    /** 错误分类：命中 → `SystemError('DATABASE_ERROR', …)`；未命中 → `null`（落回 UNKNOWN_ERROR 兜底） */
-    classifyError(error: unknown): SystemError | null;
-    /** §5-7：释放连接。默认 = `db.$disconnect()` */
-    dispose?(db: Db): Promise<void>;
-}
-//# sourceMappingURL=module.d.ts.map

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

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

package/output/app/module.js

@@ -1,34 +0,0 @@
-/**
- * 封闭模块名集合（design §3.1 十项）。
- *
- * 数组顺序即「注册顺序」，也是装配期报错文案里 `Allowed: ...` 的顺序，**不得重排**。
- */
-export const MODULE_NAMES = [
-    'env',
-    'database',
-    'redis',
-    'context',
-    'response',
-    'cors',
-    'schema',
-    'rate-limit',
-    'auth',
-    'openapi',
-];
-/**
- * P1 尚未提供默认实现的模块 → 各自的落地阶段（design §3.1 十项里除 `env` / `database` / `redis`
- * 之外的七个）。阶段号取自 `proposals/P1-boot-shutdown.md`：`openapi` 在 P2、`auth` 在 P4、其余在 P3。
- *
- * P1 过渡规则（design §3.2 + 提案 §3.3）：这些名字**必须由调用方显式写 `false`**（或直接提供
- * 一个同名的整体覆盖实现），否则装配期按**真实阶段号**报错 —— 静默 no-op 会让调用方少注册插件
- * 却启动成功。
- */
-export const PENDING_MODULES = {
-    context: 'P3',
-    response: 'P3',
-    cors: 'P3',
-    schema: 'P3',
-    'rate-limit': 'P3',
-    auth: 'P4',
-    openapi: 'P2',
-};

package/output/app/steps.d.ts

@@ -1,17 +0,0 @@
-import type { ServerMode } from './types.js';
-/**
- * 固定 15 步（design §4.1）——**顺序写死在数组里**。
- *
- * 模块只能往这些「既定槽位」里填实现，不得新增步骤、不得重排、不得改变 §4.1 的依赖偏序。
- */
-export declare const STEP_ORDER: readonly ["createFastify", "setupCompilers", "database.createClient", "createRedis", "initGlobalConfig", "initClients", "registerCorePlugins", "createServices", "initServices", "backgroundWorkers", "registerRouters", "onClose", "ready", "afterReady", "listen"];
-export type StepName = (typeof STEP_ORDER)[number];
-/**
- * 各模式跳过的步骤（design §4.1 / §4.3）。
- *
- * - `test`：关后台 worker 与 ready 后动作（第 10 / 14 步）。
- * - `openapi-build`：跳过 [5,6,9,10,14,15] 与一切连库/连 Redis 的动作，但仍保留 [3,4]（10-3：
- *   P1 沿用四家现状「不跳过第 3/4 步」，跳过错步留 P2），并保留 [7,8,11] 以保证 `app.swagger()` 完整。
- */
-export declare const SKIP_BY_MODE: Record<ServerMode, readonly StepName[]>;
-//# sourceMappingURL=steps.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../../source/app/steps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C;;;;GAIG;AACH,eAAO,MAAM,UAAU,sQAgBb,CAAA;AAEV,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAA;AAElD;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,UAAU,EAAE,SAAS,QAAQ,EAAE,CAWhE,CAAA"}