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

package/output/app/boot.d.ts

@@ -1,4 +1,3 @@
-import type { ErrorClassifier } from './core/response.js';
 import type { ConfigEnv } from './env.js';
 import type { ResourcesView, Server, ShutdownContext } from './types.js';
 import type { FastifyInstance } from 'fastify';
@@ -22,27 +21,24 @@ export interface BootedServer<R, S> {
     services: Awaited<S>;
     dispose: () => Promise<void>;
 }
-/**
- * 资源包里的数据层错误分类器。
- *
- * 约定：`resources(ctx)` 返回的资源包里**任一**提供 `classifyError` 函数的值都会被用上
- * （框架不提供数据层 helper；由服务仓在资源包里自行提供一个带 `classifyError` 的值）。
- * 都没有 → 返回 `undefined`，响应层落 `UNKNOWN_ERROR` 兜底。
- */
-export declare function resolveErrorClassifier(resources: Record<string, unknown>): ErrorClassifier | undefined;
 /**
  * 装配一个服务（`startServer` / `generateOpenApi` 共用）。
  *
  * 步序（N1 §5）：
  * ```
  * 1. 加载 env（框架固定，调用方已做）        → env
- * 2. resources(ctx={env,log})                → R（只构造，不建连）
- * 3. config(ctx={env,log,resources})         → C（仅 start 路径；出 spec 路径不跑）
+ * 2. resources(ctx={env,log,disposer})        → R（只构造，不建连）
+ * 3. config(ctx={env,log,disposer,resources}) → C（仅 start 路径；出 spec 路径不跑）
  * 4. services(ctx={log,disposer,resources,config}) → S，随后按声明序 init()（仅 start 路径）
- * 5. middlewares(ctx={app,log,services,config})    → 按数组序 register(app)
- * 6. routers(ctx={app,log,services})               → 注册路由
+ * 5. middlewares(ctx={app,log,disposer,services,config}) → 按数组序 register(app)
+ * 6. routers(ctx={app,log,disposer,services})           → 注册路由
  * 7. ready / listen
  * ```
+ *
+ * **每个阶段一个独立 `Disposer`**（构造处注册释放）；关闭时按阶段**逆序 flush**
+ * `routers → middlewares → services → config → resources`（services 阶段内部先 flush 自己的
+ * `disposer`，再逐单元逆序 `dispose`）。资源因此**最后**才断：service 关闭时若还要落库不会
+ * 撞死连接。出 spec 路径不关闭，也不执行任何 flush。
  */
 export declare function bootServer<R, C, S>(input: BootInput<R, C, S>): Promise<BootedServer<R, S>>;
 //# sourceMappingURL=boot.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"boot.d.ts","sourceRoot":"","sources":["../../source/app/boot.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,KAAK,EAAe,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACrF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,qFAAqF;AACrF,eAAO,MAAM,gBAAgB,UAAU,CAAA;AACvC,eAAO,MAAM,kBAAkB,YAAY,CAAA;AAC3C,mBAAmB;AACnB,MAAM,MAAM,SAAS,GAAG,OAAO,gBAAgB,GAAG,OAAO,kBAAkB,CAAA;AAC3E,aAAa;AACb,eAAO,MAAM,YAAY,YAAY,CAAA;AAErC,MAAM,WAAW,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IACvB,GAAG,EAAE,SAAS,CAAA;IACd,KAAK,EAAE,SAAS,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5D;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,EAAE,CAAC;IAChC,GAAG,EAAE,eAAe,CAAA;IACpB,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;IAC3B,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAcD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,GAAG,SAAS,CAOtG;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAkGhG"}
+{"version":3,"file":"boot.d.ts","sourceRoot":"","sources":["../../source/app/boot.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,KAAK,EAAgC,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACtG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,qFAAqF;AACrF,eAAO,MAAM,gBAAgB,UAAU,CAAA;AACvC,eAAO,MAAM,kBAAkB,YAAY,CAAA;AAC3C,mBAAmB;AACnB,MAAM,MAAM,SAAS,GAAG,OAAO,gBAAgB,GAAG,OAAO,kBAAkB,CAAA;AAC3E,aAAa;AACb,eAAO,MAAM,YAAY,YAAY,CAAA;AAErC,MAAM,WAAW,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IACvB,GAAG,EAAE,SAAS,CAAA;IACd,KAAK,EAAE,SAAS,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5D;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,EAAE,CAAC;IAChC,GAAG,EAAE,eAAe,CAAA;IACpB,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;IAC3B,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAqCD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CA6HhG"}

package/output/app/boot.js

@@ -1,7 +1,7 @@
 import { Disposer } from '@taicode/common-base';
 import { createConfigContext, createConfigHolder, createMiddlewareContext, createResourcesContext, createRouterContext, createServiceContext, createShutdownContext, liveResources, readConfigKey, requireConfig, } from './context.js';
 import { createFastify, registerCore } from './core/index.js';
-import { disposeServices, initServiceUnits, MIDDLEWARES_LOG_STAGE, middlewareUnitName } from './lifecycle.js';
+import { CONFIG_STAGE, disposeServices, disposeStage, initServiceUnits, MIDDLEWARES_LOG_STAGE, MIDDLEWARES_STAGE, middlewareUnitName, RESOURCES_STAGE, ROUTERS_STAGE, SERVICES_STAGE, } from './lifecycle.js';
 import { runShutdown } from './shutdown.js';
 import { attachSignalHandlers } from './signal.js';
 /** 内部步序（`prepare` → `compose` → `activate`）：`startServer` / `generateOpenApi` 共用。 */
@@ -16,23 +16,31 @@ function resolvePort(env) {
     }
     return parsed;
 }
-function isRecord(value) {
-    return typeof value === 'object' && value !== null;
-}
 /**
- * 资源包里的数据层错误分类器。
+ * 把各资源通过 `ctx.registerClassifyError` 注册的错误分类器合成单个分类器。
+ *
+ * 范式：**一个资源一个分类器，各管各的错误域**（认领不了就返回 `null` 交给下一个）。
  *
- * 约定：`resources(ctx)` 返回的资源包里**任一**提供 `classifyError` 函数的值都会被用上
- * （框架不提供数据层 helper；由服务仓在资源包里自行提供一个带 `classifyError` 的值）。
- * 都没有 → 返回 `undefined`，响应层落 `UNKNOWN_ERROR` 兜底。
+ * - 零个 → `undefined`（响应层落 `UNKNOWN_ERROR` 兜底）；
+ * - 一个 → 原样返回（少一层包装）；
+ * - 多个 → 按**注册顺序**串成链，返回第一个非 `null` 的结果（短路）。
  */
-export function resolveErrorClassifier(resources) {
-    for (const value of Object.values(resources)) {
-        if (isRecord(value) && typeof value.classifyError === 'function') {
-            return (error) => value.classifyError(error);
-        }
+function combineClassifiers(classifiers) {
+    if (classifiers.length === 0) {
+        return undefined;
     }
-    return undefined;
+    if (classifiers.length === 1) {
+        return classifiers[0];
+    }
+    return (error) => {
+        for (const classifier of classifiers) {
+            const result = classifier(error);
+            if (result !== null) {
+                return result;
+            }
+        }
+        return null;
+    };
 }
 /**
  * 装配一个服务（`startServer` / `generateOpenApi` 共用）。
@@ -40,13 +48,18 @@ export function resolveErrorClassifier(resources) {
  * 步序（N1 §5）：
  * ```
  * 1. 加载 env（框架固定，调用方已做）        → env
- * 2. resources(ctx={env,log})                → R（只构造，不建连）
- * 3. config(ctx={env,log,resources})         → C（仅 start 路径；出 spec 路径不跑）
+ * 2. resources(ctx={env,log,disposer})        → R（只构造，不建连）
+ * 3. config(ctx={env,log,disposer,resources}) → C（仅 start 路径；出 spec 路径不跑）
  * 4. services(ctx={log,disposer,resources,config}) → S，随后按声明序 init()（仅 start 路径）
- * 5. middlewares(ctx={app,log,services,config})    → 按数组序 register(app)
- * 6. routers(ctx={app,log,services})               → 注册路由
+ * 5. middlewares(ctx={app,log,disposer,services,config}) → 按数组序 register(app)
+ * 6. routers(ctx={app,log,disposer,services})           → 注册路由
  * 7. ready / listen
  * ```
+ *
+ * **每个阶段一个独立 `Disposer`**（构造处注册释放）；关闭时按阶段**逆序 flush**
+ * `routers → middlewares → services → config → resources`（services 阶段内部先 flush 自己的
+ * `disposer`，再逐单元逆序 `dispose`）。资源因此**最后**才断：service 关闭时若还要落库不会
+ * 撞死连接。出 spec 路径不关闭，也不执行任何 flush。
  */
 export async function bootServer(input) {
     const { server, env, phase } = input;
@@ -57,27 +70,44 @@ export async function bootServer(input) {
     const app = createFastify(env);
     const instance = app;
     const log = app.log;
-    const disposer = new Disposer();
+    // 每个阶段一个 Disposer：创建与释放同处一地，关闭时按阶段逆序 flush
+    const disposers = {
+        resources: new Disposer(),
+        config: new Disposer(),
+        services: new Disposer(),
+        middlewares: new Disposer(),
+        routers: new Disposer(),
+    };
     const holder = createConfigHolder();
     // ② resources：只构造，不建连（出 spec 路径同样执行）
-    const resources = (await server.resources(createResourcesContext({ env, log })));
+    //    资源错误分类器由各资源通过 `ctx.registerClassifyError` 各自注册：在调 `resources(ctx)` 前建局部收集器，
+    //    返回后把注册结果按注册顺序合成单个分类器喂给 core。
+    const classifiers = [];
+    const resources = (await server.resources(createResourcesContext({
+        env,
+        log,
+        disposer: disposers.resources,
+        registerClassifyError: (classifier) => {
+            classifiers.push(classifier);
+        },
+    })));
     const resourcesView = liveResources(resources);
     // ③ core 装配（schema → cookie → response → openapi → 路由注册表）
     await registerCore(app, {
         identity: server.app,
         env,
-        classifyError: resolveErrorClassifier(resourcesView),
+        classifyResourceError: combineClassifiers(classifiers),
         readConfig: (key) => readConfigKey(requireConfig(holder), key),
     });
     // ── compose ──────────────────────────────────────────────────────────────
     // ① config（仅 start 路径；出 spec 路径不跑 → `ctx.config` 读到即抛 CONFIG_UNAVAILABLE）
     if (isStart) {
-        holder.current = (await server.config(createConfigContext({ env, log, resources: resourcesView })));
+        holder.current = (await server.config(createConfigContext({ env, log, disposer: disposers.config, resources: resourcesView })));
     }
     // ② services（两个入口都执行；ctx 无 env、无 services）
     const services = server.services(createServiceContext({
         log,
-        disposer,
+        disposer: disposers.services,
         resources: resourcesView,
         holder,
     }));
@@ -86,20 +116,21 @@ export async function bootServer(input) {
         await initServiceUnits({ service, log, services: services });
     }
     // ④ middlewares（两个入口都执行：出 spec 也照注册，保证 schema 一致）
-    const middlewares = server.middlewares(createMiddlewareContext({ app: instance, log, services, holder }));
+    const middlewares = server.middlewares(createMiddlewareContext({ app: instance, log, disposer: disposers.middlewares, services, holder }));
     for (const [index, unit] of middlewares.entries()) {
         await unit.register(instance);
         log.debug({ service, unit: middlewareUnitName(service, unit, index), stage: MIDDLEWARES_LOG_STAGE }, '[middleware] registered');
     }
     // ⑤ routers（两个入口都执行）
-    await server.routers(createRouterContext({ app: instance, log, services }));
+    await server.routers(createRouterContext({ app: instance, log, disposer: disposers.routers, services }));
     // ── activate ─────────────────────────────────────────────────────────────
     const runShutdownFlow = async () => {
         if (input.shutdown) {
+            // 整体覆盖：自定义 shutdown 自行负责各阶段 flush（框架不再代劳）
             await input.shutdown(createShutdownContext({
                 app: instance,
                 log,
-                disposer,
+                disposer: disposers.services,
                 resources: resourcesView,
                 holder,
                 services,
@@ -107,8 +138,12 @@ export async function bootServer(input) {
             return;
         }
         await runShutdown({
-            stopProducers: () => disposer.dispose(),
+            flushRouters: () => disposeStage({ service, log, stage: ROUTERS_STAGE, disposer: disposers.routers }),
+            flushMiddlewares: () => disposeStage({ service, log, stage: MIDDLEWARES_STAGE, disposer: disposers.middlewares }),
+            flushServices: () => disposeStage({ service, log, stage: SERVICES_STAGE, disposer: disposers.services }),
             disposeServices: () => disposeServices({ service, log, services: services }),
+            flushConfig: () => disposeStage({ service, log, stage: CONFIG_STAGE, disposer: disposers.config }),
+            flushResources: () => disposeStage({ service, log, stage: RESOURCES_STAGE, disposer: disposers.resources }),
         }, log);
     };
     app.addHook('onClose', () => runShutdownFlow());

package/output/app/context.d.ts

@@ -1,6 +1,6 @@
 import type { Disposer } from '@taicode/common-base';
 import type { ConfigEnv } from './env.js';
-import type { AppInstance, ConfigContext, LoggerLike, MiddlewareContext, ResourcesContext, ResourcesView, RouterContext, ServiceContext, ShutdownContext } from './types.js';
+import type { AppInstance, ConfigContext, ErrorClassifier, LoggerLike, MiddlewareContext, ResourcesContext, ResourcesView, RouterContext, ServiceContext, ShutdownContext } from './types.js';
 /**
  * 分阶段 ctx 的运行时构造（N1 §2）。
  *
@@ -23,12 +23,16 @@ export declare function readConfigKey(config: unknown, key: string): unknown;
 export interface ResourcesContextParams {
     env: ConfigEnv;
     log: LoggerLike;
+    disposer: Disposer;
+    /** 收集器：`bootServer` 注入，把各资源注册的分类器按注册顺序收起来 */
+    registerClassifyError: (classifier: ErrorClassifier) => void;
 }
 export declare function createResourcesContext(params: ResourcesContextParams): ResourcesContext;
 /** `config(ctx)` 入参 */
 export interface ConfigContextParams<R> {
     env: ConfigEnv;
     log: LoggerLike;
+    disposer: Disposer;
     resources: ResourcesView<R>;
 }
 export declare function createConfigContext<R>(params: ConfigContextParams<R>): ConfigContext<R>;
@@ -44,6 +48,7 @@ export declare function createServiceContext<R, C>(params: ServiceContextParams<
 export interface MiddlewareContextParams<C, S> {
     app: AppInstance;
     log: LoggerLike;
+    disposer: Disposer;
     services: Awaited<S>;
     holder: ConfigHolder<C>;
 }
@@ -52,6 +57,7 @@ export declare function createMiddlewareContext<C, S>(params: MiddlewareContextP
 export interface RouterContextParams<S> {
     app: AppInstance;
     log: LoggerLike;
+    disposer: Disposer;
     services: Awaited<S>;
 }
 export declare function createRouterContext<S>(params: RouterContextParams<S>): RouterContext<S>;

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

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

package/output/app/context.js

@@ -31,10 +31,15 @@ export function readConfigKey(config, key) {
     return config?.[key];
 }
 export function createResourcesContext(params) {
-    return { env: params.env, log: params.log };
+    return {
+        env: params.env,
+        log: params.log,
+        disposer: params.disposer,
+        registerClassifyError: params.registerClassifyError,
+    };
 }
 export function createConfigContext(params) {
-    return { env: params.env, log: params.log, resources: params.resources };
+    return { env: params.env, log: params.log, disposer: params.disposer, resources: params.resources };
 }
 export function createServiceContext(params) {
     return {
@@ -50,6 +55,7 @@ export function createMiddlewareContext(params) {
     return {
         app: params.app,
         log: params.log,
+        disposer: params.disposer,
         services: params.services,
         get config() {
             return requireConfig(params.holder);
@@ -57,7 +63,7 @@ export function createMiddlewareContext(params) {
     };
 }
 export function createRouterContext(params) {
-    return { app: params.app, log: params.log, services: params.services };
+    return { app: params.app, log: params.log, disposer: params.disposer, services: params.services };
 }
 export function createShutdownContext(params) {
     return {

package/output/app/core/index.d.ts

@@ -9,7 +9,7 @@ export { registerRequestId, REQUEST_ID_HEADER, REQUEST_ID_LOG_LABEL } from './re
 export { createLoggerOptions, LOG_REDACT_PATHS } from './logging.js';
 export { SERVER_IDENTITY, attachServerIdentity, readServerIdentity } from './identity.js';
 export type { AuthCookieOptions, CookieCoreOptions } from './cookie.js';
-export type { ResponseCoreOptions, ResponseEnvelope } from './response.js';
+export type { ResponseCoreOptions, ResponseEnvelope, ErrorClassifier } from './response.js';
 export type { OpenApiCoreOptions } from './openapi.js';
 /**
  * core `schema`（设计 §5.1）——**框架内置、锁定、不可替换/修改**。
@@ -30,8 +30,8 @@ export interface CoreRegistrationOptions {
     /** 身份块（`service` / `title` / `version`）：openapi + 内置单元从这里读 */
     identity: AppIdentity;
     env: ConfigEnv;
-    /** 数据层错误分类（资源包提供；缺省 = 落 `UNKNOWN_ERROR`） */
-    classifyError?: ErrorClassifier;
+    /** 资源错误分类（各资源经 `ctx.registerClassifyError` 注册；缺省 = 落 `UNKNOWN_ERROR`） */
+    classifyResourceError?: ErrorClassifier;
     /** 取**已加载**配置中某个键的访问器（cookie domain 等**惰性**取值；不得在构造期调用） */
     readConfig: (key: string) => unknown;
 }

package/output/app/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../source/app/core/index.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACrF,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAC5F,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAChF,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAC5F,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACpE,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAEzF,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AACvE,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAC1E,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAEtD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,CAMzD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,SAAS,GAAG,eAAe,CAM7D;AAED,gBAAgB;AAChB,MAAM,WAAW,uBAAuB;IACtC,8DAA8D;IAC9D,QAAQ,EAAE,WAAW,CAAA;IACrB,GAAG,EAAE,SAAS,CAAA;IACd,4CAA4C;IAC5C,aAAa,CAAC,EAAE,eAAe,CAAA;IAC/B,2DAA2D;IAC3D,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;CACrC;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAaxG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../source/app/core/index.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACrF,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAC5F,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAChF,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAC5F,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACpE,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAEzF,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AACvE,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC3F,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAEtD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,CAMzD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,SAAS,GAAG,eAAe,CAM7D;AAED,gBAAgB;AAChB,MAAM,WAAW,uBAAuB;IACtC,8DAA8D;IAC9D,QAAQ,EAAE,WAAW,CAAA;IACrB,GAAG,EAAE,SAAS,CAAA;IACd,yEAAyE;IACzE,qBAAqB,CAAC,EAAE,eAAe,CAAA;IACvC,2DAA2D;IAC3D,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;CACrC;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAaxG"}

package/output/app/core/index.js

@@ -45,7 +45,7 @@ export async function registerCore(app, options) {
     attachServerIdentity(app, options.identity);
     registerSchema(app); // schema → zod compiler
     registerCookie(app, { env: options.env, readConfig: options.readConfig });
-    registerResponse(app, { classifyError: options.classifyError });
+    registerResponse(app, { classifyResourceError: options.classifyResourceError });
     // await：确定性冲刷插件队列，保证 swagger 的 root `onRoute` 钩子在路由注册之前就位
     await registerOpenApi(app, {
         title: options.identity.title,

package/output/app/core/response.d.ts

@@ -1,12 +1,12 @@
-import { SystemError } from '../errors.js';
 import type { FastifyInstance } from 'fastify';
+import type { ErrorClassifier } from '../types.js';
 /**
  * core `response`（设计 §5.1 / §8，错误契约 D7）——**框架内置、锁定、不可替换/修改**。
  *
  * - 成功信封 `{ status: 'SUCCESS', message: 'ok', data }`（由 `preSerialization` 统一包裹）。
  * - 错误信封 `{ status: <错误码字符串>, message, data: null }`。
  * - `setErrorHandler` 固定分支：`UserError`→400（`error.status` 字面量）/ `SystemError`→500 /
- *   zod→400 / serde→500 / 数据层（资源包的 `classifyError`）→500 / 未知→500；**禁止按 `error.type` 细分**。
+ *   zod→400 / serde→500 / 资源（各资源 `ctx.registerClassifyError` 注册的分类器）→500 / 未知→500；**禁止按 `error.type` 细分**。
  * - `setNotFoundHandler` → 404 + `NOT_IMPLEMENTED`（落 `warn`，文案对齐 expense/notice）。
  * - 错误日志分级：`UserError` / zod → `warn`，其余 → `error`（带 stack）。
  * - **错误只给稳定码**（`status` 放错误码字符串），文案不归框架（由前端 / i18n 决定，§10-6）。
@@ -27,15 +27,15 @@ export interface ResponseEnvelope<T> {
 export declare function createSuccessResponse<T>(data: T): ResponseEnvelope<T>;
 export declare function createErrorResponse(status: string, message: string): ResponseEnvelope<null>;
 /**
- * 数据层错误分类器（资源包里带 `classifyError` 的值的裸函数形态）。
+ * 资源错误分类器（单一来源：`types.ts`）。
  *
- * 资源包（`resources` 槽位返回值）里任何提供 `classifyError` 的值都会被用作响应错误分类；
- * 都没有时错误落 `UNKNOWN_ERROR` 兜底。
+ * **每个资源注册自己的分类器**（一个资源一个，各管各的错误域）；由服务仓在 `resources(ctx)` 里
+ * 通过 `ctx.registerClassifyError` 注册；未注册时错误落 `UNKNOWN_ERROR` 兜底。
  */
-export type ErrorClassifier = (error: unknown) => SystemError | null;
+export type { ErrorClassifier };
 export interface ResponseCoreOptions {
-    /** Prisma / 数据层错误分类（缺省 = 不做数据层分类） */
-    classifyError?: ErrorClassifier;
+    /** 资源错误分类（各资源经 `ctx.registerClassifyError` 注册；缺省 = 不做资源错误分类） */
+    classifyResourceError?: ErrorClassifier;
 }
 export declare function registerResponse(app: FastifyInstance, options?: ResponseCoreOptions): void;
 //# sourceMappingURL=response.d.ts.map

package/output/app/core/response.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../../source/app/core/response.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAa,MAAM,cAAc,CAAA;AAErD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,cAAc,YAAY,CAAA;AACvC,eAAO,MAAM,sBAAsB,oBAAoB,CAAA;AACvD,eAAO,MAAM,oBAAoB,kBAAkB,CAAA;AACnD,eAAO,MAAM,0BAA0B,iCAAiC,CAAA;AACxE,eAAO,MAAM,oBAAoB,kBAAkB,CAAA;AAEnD,uCAAuC;AACvC,eAAO,MAAM,oBAAoB,6BAAS,CAAA;AAC1C,eAAO,MAAM,sBAAsB,6BAAS,CAAA;AAE5C,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,CAAC,CAAA;CACR;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAErE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAE3F;AAsBD;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,WAAW,GAAG,IAAI,CAAA;AAEpE,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,aAAa,CAAC,EAAE,eAAe,CAAA;CAChC;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,GAAE,mBAAwB,GAAG,IAAI,CAyD9F"}
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../../source/app/core/response.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,cAAc,YAAY,CAAA;AACvC,eAAO,MAAM,sBAAsB,oBAAoB,CAAA;AACvD,eAAO,MAAM,oBAAoB,kBAAkB,CAAA;AACnD,eAAO,MAAM,0BAA0B,iCAAiC,CAAA;AACxE,eAAO,MAAM,oBAAoB,kBAAkB,CAAA;AAEnD,uCAAuC;AACvC,eAAO,MAAM,oBAAoB,6BAAS,CAAA;AAC1C,eAAO,MAAM,sBAAsB,6BAAS,CAAA;AAE5C,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,CAAC,CAAA;CACR;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAErE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAE3F;AAsBD;;;;;GAKG;AACH,YAAY,EAAE,eAAe,EAAE,CAAA;AAE/B,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,qBAAqB,CAAC,EAAE,eAAe,CAAA;CACxC;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,GAAE,mBAAwB,GAAG,IAAI,CAyD9F"}

package/output/app/core/response.js

@@ -6,7 +6,7 @@ import { SystemError, UserError } from '../errors.js';
  * - 成功信封 `{ status: 'SUCCESS', message: 'ok', data }`（由 `preSerialization` 统一包裹）。
  * - 错误信封 `{ status: <错误码字符串>, message, data: null }`。
  * - `setErrorHandler` 固定分支：`UserError`→400（`error.status` 字面量）/ `SystemError`→500 /
- *   zod→400 / serde→500 / 数据层（资源包的 `classifyError`）→500 / 未知→500；**禁止按 `error.type` 细分**。
+ *   zod→400 / serde→500 / 资源（各资源 `ctx.registerClassifyError` 注册的分类器）→500 / 未知→500；**禁止按 `error.type` 细分**。
  * - `setNotFoundHandler` → 404 + `NOT_IMPLEMENTED`（落 `warn`，文案对齐 expense/notice）。
  * - 错误日志分级：`UserError` / zod → `warn`，其余 → `error`（带 stack）。
  * - **错误只给稳定码**（`status` 放错误码字符串），文案不归框架（由前端 / i18n 决定，§10-6）。
@@ -72,13 +72,13 @@ export function registerResponse(app, options = {}) {
             request.log.error({ err: error }, '[response] response serialization error');
             return reply.code(500).send(createErrorResponse(SERIALIZATION_ERROR_STATUS, error.message));
         }
-        // ⑤ 数据层（Prisma 等）分类 → 500
-        const databaseError = options.classifyError?.(error);
-        if (databaseError) {
-            request.log.error({ err: error }, '[response] database error');
+        // ⑤ 资源错误（各资源注册的分类器依次认领）→ 500
+        const resourceError = options.classifyResourceError?.(error);
+        if (resourceError) {
+            request.log.error({ err: error }, '[response] resource error');
             return reply
                 .code(500)
-                .send(createErrorResponse(databaseError.type, resolveMessage(databaseError)));
+                .send(createErrorResponse(resourceError.type, resolveMessage(resourceError)));
         }
         // ⑥ 未知 → 500
         request.log.error({ err: error }, '[response] unknown error');

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

@@ -29,4 +29,12 @@ export declare function middlewaresCannotSeeResources(): void;
 export declare function middlewaresCannotSeeEnv(): void;
 /** #15 `services` 看不到 `env`（服务层禁读 env） */
 export declare function servicesCannotSeeEnv(): void;
+/** #16 `config` 看不到 `registerClassifyError`（resources 槽位专属能力） */
+export declare function configCannotRegisterClassifyError(): void;
+/** #17 `services` 看不到 `registerClassifyError`（resources 槽位专属能力） */
+export declare function servicesCannotRegisterClassifyError(): void;
+/** #18 `middlewares` 看不到 `registerClassifyError`（resources 槽位专属能力） */
+export declare function middlewaresCannotRegisterClassifyError(): void;
+/** #19 `routers` 看不到 `registerClassifyError`（resources 槽位专属能力） */
+export declare function routersCannotRegisterClassifyError(): void;
 //# sourceMappingURL=define-server.negative-cases.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"define-server.negative-cases.d.ts","sourceRoot":"","sources":["../../source/app/define-server.negative-cases.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAgB9C,kCAAkC;AAClC,wBAAgB,wBAAwB,IAAI,IAAI,CAU/C;AAED,oCAAoC;AACpC,wBAAgB,0BAA0B,IAAI,IAAI,CAUjD;AAED,iCAAiC;AACjC,wBAAgB,uBAAuB,IAAI,IAAI,CAa9C;AAED,iDAAiD;AACjD,wBAAgB,yBAAyB,IAAI,IAAI,CAahD;AAED,6CAA6C;AAC7C,wBAAgB,yBAAyB,IAAI,IAAI,CAYhD;AAED,gCAAgC;AAChC,wBAAgB,sBAAsB,IAAI,IAAI,CAY7C;AAED,gDAAgD;AAChD,wBAAgB,kCAAkC,IAAI,IAAI,CAUzD;AAED,8CAA8C;AAC9C,wBAAgB,6BAA6B,IAAI,IAAI,CAUpD;AAED,qDAAqD;AACrD,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,IAAI,CAGhG;AAED,2BAA2B;AAC3B,wBAAgB,oBAAoB,IAAI,IAAI,CAU3C;AAED,kDAAkD;AAClD,wBAAgB,mCAAmC,IAAI,IAAI,CAa1D;AAED,6BAA6B;AAC7B,wBAAgB,kBAAkB,IAAI,IAAI,CAazC;AAED,mDAAmD;AACnD,wBAAgB,6BAA6B,IAAI,IAAI,CAapD;AAED,kCAAkC;AAClC,wBAAgB,uBAAuB,IAAI,IAAI,CAa9C;AAED,0CAA0C;AAC1C,wBAAgB,oBAAoB,IAAI,IAAI,CAa3C"}
+{"version":3,"file":"define-server.negative-cases.d.ts","sourceRoot":"","sources":["../../source/app/define-server.negative-cases.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAgB9C,kCAAkC;AAClC,wBAAgB,wBAAwB,IAAI,IAAI,CAU/C;AAED,oCAAoC;AACpC,wBAAgB,0BAA0B,IAAI,IAAI,CAUjD;AAED,iCAAiC;AACjC,wBAAgB,uBAAuB,IAAI,IAAI,CAa9C;AAED,iDAAiD;AACjD,wBAAgB,yBAAyB,IAAI,IAAI,CAahD;AAED,6CAA6C;AAC7C,wBAAgB,yBAAyB,IAAI,IAAI,CAYhD;AAED,gCAAgC;AAChC,wBAAgB,sBAAsB,IAAI,IAAI,CAY7C;AAED,gDAAgD;AAChD,wBAAgB,kCAAkC,IAAI,IAAI,CAUzD;AAED,8CAA8C;AAC9C,wBAAgB,6BAA6B,IAAI,IAAI,CAUpD;AAED,qDAAqD;AACrD,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,IAAI,CAGhG;AAED,2BAA2B;AAC3B,wBAAgB,oBAAoB,IAAI,IAAI,CAU3C;AAED,kDAAkD;AAClD,wBAAgB,mCAAmC,IAAI,IAAI,CAa1D;AAED,6BAA6B;AAC7B,wBAAgB,kBAAkB,IAAI,IAAI,CAazC;AAED,mDAAmD;AACnD,wBAAgB,6BAA6B,IAAI,IAAI,CAapD;AAED,kCAAkC;AAClC,wBAAgB,uBAAuB,IAAI,IAAI,CAa9C;AAED,0CAA0C;AAC1C,wBAAgB,oBAAoB,IAAI,IAAI,CAa3C;AAED,iEAAiE;AACjE,wBAAgB,iCAAiC,IAAI,IAAI,CAaxD;AAED,mEAAmE;AACnE,wBAAgB,mCAAmC,IAAI,IAAI,CAa1D;AAED,sEAAsE;AACtE,wBAAgB,sCAAsC,IAAI,IAAI,CAa7D;AAED,kEAAkE;AAClE,wBAAgB,kCAAkC,IAAI,IAAI,CAYzD"}

package/output/app/define-server.negative-cases.js

@@ -1,6 +1,6 @@
 import { defineServer, startServer } from './entries.js';
 /**
- * N2 §4 的 **15 条负向用例**：这些写法**必须编译失败**，全部由 `tsc --noEmit` 覆盖
+ * N2 §4 的 **19 条负向用例**：这些写法**必须编译失败**，全部由 `tsc --noEmit` 覆盖
  * （**不进**运行期 vitest 断言）。
  *
  * 文件名刻意**不带** `.test.ts`：它由 `tsc --noEmit` 校验，不被 vitest 当作测试文件执行。
@@ -207,3 +207,62 @@ export function servicesCannotSeeEnv() {
         routers: () => undefined,
     });
 }
+/** #16 `config` 看不到 `registerClassifyError`（resources 槽位专属能力） */
+export function configCannotRegisterClassifyError() {
+    defineServer({
+        app: identity,
+        resources: () => ({}),
+        config: (ctx) => {
+            // @ts-expect-error `registerClassifyError` 是 resources 槽位专属能力
+            void ctx.registerClassifyError;
+            return {};
+        },
+        services: () => ({}),
+        middlewares: () => [],
+        routers: () => undefined,
+    });
+}
+/** #17 `services` 看不到 `registerClassifyError`（resources 槽位专属能力） */
+export function servicesCannotRegisterClassifyError() {
+    defineServer({
+        app: identity,
+        resources: () => ({}),
+        config: () => ({}),
+        services: (ctx) => {
+            // @ts-expect-error `registerClassifyError` 是 resources 槽位专属能力
+            void ctx.registerClassifyError;
+            return {};
+        },
+        middlewares: () => [],
+        routers: () => undefined,
+    });
+}
+/** #18 `middlewares` 看不到 `registerClassifyError`（resources 槽位专属能力） */
+export function middlewaresCannotRegisterClassifyError() {
+    defineServer({
+        app: identity,
+        resources: () => ({}),
+        config: () => ({}),
+        services: () => ({}),
+        middlewares: (ctx) => {
+            // @ts-expect-error `registerClassifyError` 是 resources 槽位专属能力
+            void ctx.registerClassifyError;
+            return [];
+        },
+        routers: () => undefined,
+    });
+}
+/** #19 `routers` 看不到 `registerClassifyError`（resources 槽位专属能力） */
+export function routersCannotRegisterClassifyError() {
+    defineServer({
+        app: identity,
+        resources: () => ({}),
+        config: () => ({}),
+        services: () => ({}),
+        middlewares: () => [],
+        routers: (ctx) => {
+            // @ts-expect-error `registerClassifyError` 是 resources 槽位专属能力
+            void ctx.registerClassifyError;
+        },
+    });
+}

package/output/app/entries.d.ts

@@ -24,6 +24,8 @@ export declare function startServer<R, C, S>(server: Server<R, C, S>, options?:
  *
  * **红线**：全程**不得要求配置有效** —— 不跑 `config` 槽位、不要求 `DATABASE_URL` / `REDIS_URL`
  * 有效；`resources`（只构造不建连）/ `services` / 中间件注册 / 路由注册照常执行。
+ *
+ * 出 spec 路径**不关闭服务**，因此也不会 flush 任何阶段的 `disposer`。
  */
 export declare function generateOpenApi<R, C, S>(server: Server<R, C, S>): Promise<OpenApiDocument>;
 //# sourceMappingURL=entries.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"entries.d.ts","sourceRoot":"","sources":["../../source/app/entries.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAC3F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEzC;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAMpF;AAED,yCAAyC;AACzC,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAMnF;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,GAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAavI;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAiBhG"}
+{"version":3,"file":"entries.d.ts","sourceRoot":"","sources":["../../source/app/entries.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAC3F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEzC;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAMpF;AAED,yCAAyC;AACzC,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAMnF;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,GAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAavI;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAiBhG"}

package/output/app/entries.js

@@ -46,6 +46,8 @@ export async function startServer(server, options = {}) {
  *
  * **红线**：全程**不得要求配置有效** —— 不跑 `config` 槽位、不要求 `DATABASE_URL` / `REDIS_URL`
  * 有效；`resources`（只构造不建连）/ `services` / 中间件注册 / 路由注册照常执行。
+ *
+ * 出 spec 路径**不关闭服务**，因此也不会 flush 任何阶段的 `disposer`。
  */
 export async function generateOpenApi(server) {
     // 不加载 .env 文件、不读配置