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

package/output/app/config.test.js

@@ -1,132 +0,0 @@
-import { describe, expect, expectTypeOf, it } from 'vitest';
-import { defineServer, generateOpenApi, startServer } from './entries.js';
-import { SystemError, UserError } from './errors.js';
-const rows = { 'server.domain': 'example.com' };
-const fakeDatabase = {
-    get: (key) => Promise.resolve(rows[key]),
-};
-describe('config 槽位（N1 §2 / N2 §2.4）', () => {
-    it('① 入参含 env/log/resources，且不含 config/services/app', async () => {
-        const captured = [];
-        const server = defineServer({
-            app: { service: 'config-test', title: 'Config Test', version: '1.0.0' },
-            resources: () => ({ database: fakeDatabase }),
-            config: (ctx) => {
-                captured.push(ctx);
-                return { domain: 'example.com' };
-            },
-            services: () => ({}),
-            middlewares: () => [],
-            routers: () => undefined,
-        });
-        const app = await startServer(server, { listen: false });
-        try {
-            expect(captured).toHaveLength(1);
-            const ctx = captured[0];
-            expect('config' in ctx).toBe(false);
-            expect('services' in ctx).toBe(false);
-            expect('app' in ctx).toBe(false);
-            expect(ctx.resources.database).toBe(fakeDatabase);
-            expect(typeof ctx.log.info).toBe('function');
-            expect(Object.keys(ctx.env).sort()).toEqual([
-                'API_PORT',
-                'DATABASE_URL',
-                'ENV',
-                'LOG_LEVEL',
-                'REDIS_URL',
-            ]);
-        }
-        finally {
-            await app.close();
-        }
-    });
-    it('② 可从「库」读配置：`services` / `middlewares` 经 `ctx.config` 拿到值', async () => {
-        let domainInServices;
-        let domainInMiddlewares;
-        const server = defineServer({
-            app: { service: 'config-from-database', title: 'Config From Database', version: '1.0.0' },
-            resources: () => ({ database: fakeDatabase }),
-            config: async (ctx) => ({ domain: (await ctx.resources.database.get('server.domain')) ?? '' }),
-            services: (ctx) => {
-                domainInServices = ctx.config.domain;
-                return {};
-            },
-            middlewares: (ctx) => {
-                domainInMiddlewares = ctx.config.domain;
-                return [];
-            },
-            routers: (ctx) => {
-                ctx.app.get('/domain', () => ({ domain: ctx.services === null ? '' : 'ok' }));
-            },
-        });
-        const app = await startServer(server, { listen: false });
-        try {
-            expect(domainInServices).toBe('example.com');
-            expect(domainInMiddlewares).toBe('example.com');
-        }
-        finally {
-            await app.close();
-        }
-    });
-    it('③ 同一份定义：startServer 跑 config，generateOpenApi 不跑（红线）', async () => {
-        let calls = 0;
-        const server = defineServer({
-            app: { service: 'config-redline', title: 'Config Red Line', version: '1.0.0' },
-            resources: () => ({ database: fakeDatabase }),
-            config: () => {
-                calls += 1;
-                return {};
-            },
-            services: () => ({}),
-            middlewares: () => [],
-            routers: () => undefined,
-        });
-        await generateOpenApi(server);
-        expect(calls).toBe(0);
-        const app = await startServer(server, { listen: false });
-        expect(calls).toBe(1);
-        await app.close();
-    });
-    it('④ 出 spec 路径：services 读 ctx.config 抛 CONFIG_UNAVAILABLE（构造期不得读配置）', async () => {
-        const server = defineServer({
-            app: { service: 'config-openapi', title: 'Config OpenApi', version: '1.0.0' },
-            resources: () => ({}),
-            config: () => ({ domain: 'spec' }),
-            services: (ctx) => {
-                // 构造期不得读配置；出 spec 路径上读到即抛
-                void ctx.config;
-                return {};
-            },
-            middlewares: () => [],
-            routers: () => undefined,
-        });
-        let caught;
-        try {
-            await generateOpenApi(server);
-        }
-        catch (error) {
-            caught = error;
-        }
-        expect(SystemError.is(caught)).toBe(true);
-        expect(caught.type).toBe('CONFIG_UNAVAILABLE');
-    });
-    it('⑤ `UserError` / `SystemError` 的 `status` 是字面量、`is()` 走品牌（N2 §2.12）', () => {
-        const user = new UserError('INVALID_TOKEN', undefined, 'boom');
-        const system = new SystemError('DATABASE_ERROR', undefined, 'boom');
-        // `status` 是字面量类型（改错直接编译失败）
-        expectTypeOf(user.status).toEqualTypeOf();
-        expectTypeOf(system.status).toEqualTypeOf();
-        expect(user.type).toBe('INVALID_TOKEN');
-        expect(user.status).toBe(400);
-        expect(system.status).toBe(500);
-        // `is()` 走 `Symbol.for` 品牌：**不用 `instanceof`**，原型链丢失也能识别
-        const plainUserError = Object.assign(Object.create(null), {
-            type: 'INVALID_TOKEN',
-            message: 'boom',
-        });
-        Object.defineProperty(plainUserError, Symbol.for('@taicode/common/UserError'), { value: true });
-        expect(UserError.is(plainUserError)).toBe(true);
-        expect(SystemError.is(plainUserError)).toBe(false);
-        expect(UserError.is(new Error('boom'))).toBe(false);
-    });
-});

package/output/app/context.d.ts

@@ -1,70 +0,0 @@
-import type { Disposer } from '@taicode/common-base';
-import type { ConfigEnv } from './env.js';
-import type { AppInstance, ConfigContext, ErrorClassifier, LoggerLike, MiddlewareContext, ResourcesContext, ResourcesView, RouterContext, ServiceContext, ShutdownContext } from './types.js';
-/**
- * 分阶段 ctx 的运行时构造（N1 §2）。
- *
- * 每个槽位拿到的是**字段最小集合**的普通对象；`config` 用 getter 暴露，出 spec 路径
- * （`generateOpenApi` 不跑 `config` 槽位）读到它时抛 `SystemError('CONFIG_UNAVAILABLE')`
- * —— 让「构造期不得读配置」有运行期护栏，而不仅是文档规则。
- */
-/** 运行时镜像 `Live<T>`：剔除值为 `false` 的键（编译期静态关闭） */
-export declare function liveResources(resources: object): Record<string, unknown>;
-/** `config` 槽位产物持有者（`startServer` 路径写入；出 spec 路径留空） */
-export interface ConfigHolder<C> {
-    current: Awaited<C> | undefined;
-}
-export declare function createConfigHolder<C>(): ConfigHolder<C>;
-/** 读配置：react 未就绪时抛 `SystemError('CONFIG_UNAVAILABLE')` */
-export declare function requireConfig<C>(holder: ConfigHolder<C>): Awaited<C>;
-/** 按**已知键**从配置值里取字段（框架内置单元消费配置的单一入口；不做形状校验） */
-export declare function readConfigKey(config: unknown, key: string): unknown;
-/** `resources(ctx)` 入参 */
-export interface ResourcesContextParams {
-    env: ConfigEnv;
-    log: LoggerLike;
-    /** 收集器：`bootServer` 注入，把各资源注册的分类器按注册顺序收起来 */
-    registerClassifyError: (classifier: ErrorClassifier) => void;
-}
-export declare function createResourcesContext(params: ResourcesContextParams): ResourcesContext;
-/** `config(ctx)` 入参 */
-export interface ConfigContextParams<R> {
-    env: ConfigEnv;
-    log: LoggerLike;
-    resources: ResourcesView<R>;
-}
-export declare function createConfigContext<R>(params: ConfigContextParams<R>): ConfigContext<R>;
-/** `services(ctx)` 入参 */
-export interface ServiceContextParams<R, C> {
-    log: LoggerLike;
-    disposer: Disposer;
-    resources: ResourcesView<R>;
-    holder: ConfigHolder<C>;
-}
-export declare function createServiceContext<R, C>(params: ServiceContextParams<R, C>): ServiceContext<R, C>;
-/** `middlewares(ctx)` 入参 */
-export interface MiddlewareContextParams<C, S> {
-    app: AppInstance;
-    log: LoggerLike;
-    services: Awaited<S>;
-    holder: ConfigHolder<C>;
-}
-export declare function createMiddlewareContext<C, S>(params: MiddlewareContextParams<C, S>): MiddlewareContext<C, S>;
-/** `routers(ctx)` 入参 */
-export interface RouterContextParams<S> {
-    app: AppInstance;
-    log: LoggerLike;
-    services: Awaited<S>;
-}
-export declare function createRouterContext<S>(params: RouterContextParams<S>): RouterContext<S>;
-/** 关闭阶段视图入参 */
-export interface ShutdownContextParams<R, C, S> {
-    app: AppInstance;
-    log: LoggerLike;
-    disposer: Disposer;
-    resources: ResourcesView<R>;
-    holder: ConfigHolder<C>;
-    services: Awaited<S>;
-}
-export declare function createShutdownContext<R, C, S>(params: ShutdownContextParams<R, C, S>): ShutdownContext<R, C, S>;
-//# sourceMappingURL=context.d.ts.map

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

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

package/output/app/context.js

@@ -1,73 +0,0 @@
-import { SystemError } from './errors.js';
-/**
- * 分阶段 ctx 的运行时构造（N1 §2）。
- *
- * 每个槽位拿到的是**字段最小集合**的普通对象；`config` 用 getter 暴露，出 spec 路径
- * （`generateOpenApi` 不跑 `config` 槽位）读到它时抛 `SystemError('CONFIG_UNAVAILABLE')`
- * —— 让「构造期不得读配置」有运行期护栏，而不仅是文档规则。
- */
-/** 运行时镜像 `Live<T>`：剔除值为 `false` 的键（编译期静态关闭） */
-export function liveResources(resources) {
-    const result = {};
-    for (const [key, value] of Object.entries(resources)) {
-        if (value !== false) {
-            result[key] = value;
-        }
-    }
-    return result;
-}
-export function createConfigHolder() {
-    return { current: undefined };
-}
-/** 读配置：react 未就绪时抛 `SystemError('CONFIG_UNAVAILABLE')` */
-export function requireConfig(holder) {
-    if (holder.current === undefined) {
-        throw new SystemError('CONFIG_UNAVAILABLE', undefined, '配置尚未就绪（generateOpenApi 路径不跑 config 槽位）：任何单元不得在构造期读配置');
-    }
-    return holder.current;
-}
-/** 按**已知键**从配置值里取字段（框架内置单元消费配置的单一入口；不做形状校验） */
-export function readConfigKey(config, key) {
-    return config?.[key];
-}
-export function createResourcesContext(params) {
-    return { env: params.env, log: params.log, registerClassifyError: params.registerClassifyError };
-}
-export function createConfigContext(params) {
-    return { env: params.env, log: params.log, resources: params.resources };
-}
-export function createServiceContext(params) {
-    return {
-        log: params.log,
-        disposer: params.disposer,
-        resources: params.resources,
-        get config() {
-            return requireConfig(params.holder);
-        },
-    };
-}
-export function createMiddlewareContext(params) {
-    return {
-        app: params.app,
-        log: params.log,
-        services: params.services,
-        get config() {
-            return requireConfig(params.holder);
-        },
-    };
-}
-export function createRouterContext(params) {
-    return { app: params.app, log: params.log, services: params.services };
-}
-export function createShutdownContext(params) {
-    return {
-        app: params.app,
-        log: params.log,
-        disposer: params.disposer,
-        resources: params.resources,
-        get config() {
-            return requireConfig(params.holder);
-        },
-        services: params.services,
-    };
-}

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

@@ -1,25 +0,0 @@
-import type { ConfigEnv } from '../env.js';
-import type { FastifyInstance } from 'fastify';
-/**
- * core `cookie`（设计 §5.1）——**框架内置、锁定、不可替换/修改**。
- *
- * `@fastify/cookie`；cookie 名 / domain 从 `ctx.readConfig('server')` 取（**请求期惰性现读**，刷新后即生效）；
- * 显式设 `sameSite`（默认 `lax`）与 `secure`（默认 `ENV === 'production'`）；注册在 `auth` 之前
- * （框架内置序），故 `auth` 读 cookie 无需用户保证。
- */
-export interface AuthCookieOptions {
-    maxAge?: number;
-    path?: string;
-    domain?: string;
-}
-export interface CookieCoreOptions {
-    env: ConfigEnv;
-    /** 取最新配置中某个键的访问器（**每次调用现读**，不得缓存返回值） */
-    readConfig: (key: string) => unknown;
-}
-/** 从 `readConfig('server')` 的返回值读取 cookie 名列表（缺省 `['token']`，对齐四家现状） */
-export declare function resolveCookieNames(server: unknown): string[];
-/** 从 `readConfig('server')` 的返回值读取 cookie domain */
-export declare function resolveCookieDomain(server: unknown): string | undefined;
-export declare function registerCookie(app: FastifyInstance, options: CookieCoreOptions): void;
-//# sourceMappingURL=cookie.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"cookie.d.ts","sourceRoot":"","sources":["../../../source/app/core/cookie.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAgB,MAAM,SAAS,CAAA;AAE5D;;;;;;GAMG;AAEH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAOD,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,SAAS,CAAA;IACd,wCAAwC;IACxC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;CACrC;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,CAG5D;AAED,oDAAoD;AACpD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAEvE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAerF"}

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

@@ -1,12 +0,0 @@
-import type { AppIdentity } from '../types.js';
-/**
- * 身份块在 `app` 上的存放键（Symbol，**不进公共契约**）。
- *
- * `defineServer({ app })` 的身份块只属于定义产物；`middlewares` / `routers` 的 ctx 里没有它
- * （可见性按需收窄），框架内置单元（`auth` 权限自注册 / `rateLimit` 前缀）需要 `service` /
- * `version` 时从这里读。
- */
-export declare const SERVER_IDENTITY: unique symbol;
-export declare function attachServerIdentity(app: unknown, identity: AppIdentity): void;
-export declare function readServerIdentity(app: unknown): AppIdentity | undefined;
-//# sourceMappingURL=identity.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../../source/app/core/identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,eAAwC,CAAA;AAEpE,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,CAE9E;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAExE"}

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

@@ -1,44 +0,0 @@
-import type { ErrorClassifier } from './response.js';
-import type { ConfigEnv } from '../env.js';
-import type { AppIdentity } from '../types.js';
-import type { FastifyInstance } from 'fastify';
-export { registerCookie, resolveCookieNames, resolveCookieDomain } from './cookie.js';
-export { registerResponse, createSuccessResponse, createErrorResponse } from './response.js';
-export { registerOpenApi, DOC_ROUTE_PREFIX, DOC_SPEC_ROUTE } from './openapi.js';
-export { registerRequestId, REQUEST_ID_HEADER, REQUEST_ID_LOG_LABEL } from './request-id.js';
-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, ErrorClassifier } from './response.js';
-export type { OpenApiCoreOptions } from './openapi.js';
-/**
- * core `schema`（设计 §5.1）——**框架内置、锁定、不可替换/修改**。
- *
- * 装配 `fastify-type-provider-zod` 的 validator / serializer compiler；响应 schema 由框架统一
- * 生成（业务侧用 `../schema/index.js` 的 `responseSchema`）。
- */
-export declare function registerSchema(app: FastifyInstance): void;
-/**
- * core 步骤 `createFastify`（`prepare`）。
- *
- * **总是**建 pino logger（level = `LOG_LEVEL`，默认 `info`） + 内置 `requestId`（入站 `x-request-id`
- * 复用 / `randomUUID`，日志字段 `requestId`）。`trustProxy: true` 与四家现状一致。
- */
-export declare function createFastify(env: ConfigEnv): FastifyInstance;
-/** core 装配入参 */
-export interface CoreRegistrationOptions {
-    /** 身份块（`service` / `title` / `version`）：openapi + 内置单元从这里读 */
-    identity: AppIdentity;
-    env: ConfigEnv;
-    /** 资源错误分类（各资源经 `ctx.registerClassifyError` 注册；缺省 = 落 `UNKNOWN_ERROR`） */
-    classifyResourceError?: ErrorClassifier;
-    /** 取**已加载**配置中某个键的访问器（cookie domain 等**惰性**取值；不得在构造期调用） */
-    readConfig: (key: string) => unknown;
-}
-/**
- * core 装配：`schema` → `cookie` → `response` → `openapi` → 路由注册表。
- * `requestId` 的响应回吐 hook 一并注册。**构造期不读配置**（`cookie` 的 domain 在请求期惰性读取），
- * 故出 spec 路径（`readConfig` 不可用）不会触发。
- */
-export declare function registerCore(app: FastifyInstance, options: CoreRegistrationOptions): Promise<void>;
-//# sourceMappingURL=index.d.ts.map

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

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

@@ -1,57 +0,0 @@
-import Fastify from 'fastify';
-import { serializerCompiler, validatorCompiler } from 'fastify-type-provider-zod';
-import { installRegisteredOperations } from '../permission-operations.js';
-import { registerCookie } from './cookie.js';
-import { attachServerIdentity } from './identity.js';
-import { createLoggerOptions } from './logging.js';
-import { registerOpenApi } from './openapi.js';
-import { createRequestIdOptions, registerRequestId } from './request-id.js';
-import { registerResponse } from './response.js';
-export { registerCookie, resolveCookieNames, resolveCookieDomain } from './cookie.js';
-export { registerResponse, createSuccessResponse, createErrorResponse } from './response.js';
-export { registerOpenApi, DOC_ROUTE_PREFIX, DOC_SPEC_ROUTE } from './openapi.js';
-export { registerRequestId, REQUEST_ID_HEADER, REQUEST_ID_LOG_LABEL } from './request-id.js';
-export { createLoggerOptions, LOG_REDACT_PATHS } from './logging.js';
-export { SERVER_IDENTITY, attachServerIdentity, readServerIdentity } from './identity.js';
-/**
- * core `schema`（设计 §5.1）——**框架内置、锁定、不可替换/修改**。
- *
- * 装配 `fastify-type-provider-zod` 的 validator / serializer compiler；响应 schema 由框架统一
- * 生成（业务侧用 `../schema/index.js` 的 `responseSchema`）。
- */
-export function registerSchema(app) {
-    app.setValidatorCompiler(validatorCompiler);
-    app.setSerializerCompiler(serializerCompiler);
-}
-/**
- * core 步骤 `createFastify`（`prepare`）。
- *
- * **总是**建 pino logger（level = `LOG_LEVEL`，默认 `info`） + 内置 `requestId`（入站 `x-request-id`
- * 复用 / `randomUUID`，日志字段 `requestId`）。`trustProxy: true` 与四家现状一致。
- */
-export function createFastify(env) {
-    return Fastify({
-        trustProxy: true,
-        logger: createLoggerOptions(env),
-        ...createRequestIdOptions(),
-    });
-}
-/**
- * core 装配：`schema` → `cookie` → `response` → `openapi` → 路由注册表。
- * `requestId` 的响应回吐 hook 一并注册。**构造期不读配置**（`cookie` 的 domain 在请求期惰性读取），
- * 故出 spec 路径（`readConfig` 不可用）不会触发。
- */
-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, { classifyResourceError: options.classifyResourceError });
-    // await：确定性冲刷插件队列，保证 swagger 的 root `onRoute` 钩子在路由注册之前就位
-    await registerOpenApi(app, {
-        title: options.identity.title,
-        version: options.identity.version,
-    });
-    // 路由注册表：在 routers 阶段之前挂 root `onRoute`，供 `auth` 权限自注册读取（与 swagger 解耦）
-    installRegisteredOperations(app);
-    registerRequestId(app); // 响应回吐 x-request-id
-}

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

@@ -1,13 +0,0 @@
-import type { ConfigEnv } from '../env.js';
-import type { FastifyServerOptions } from 'fastify';
-/**
- * core `logging`（设计 §5.1）——**框架内置、锁定、不可替换/修改**。
- *
- * `createFastify` **总是**建 pino logger（级别取 `LOG_LEVEL`，默认 `info`）；原 `logging: false`
- * 开关随 `CoreOptions` 一并删除，日志始终开启，不再由 `debug` 控制。
- */
-/** 默认 `redact` 路径（设计 §5.1） */
-export declare const LOG_REDACT_PATHS: readonly ["authorization", "cookie", "set-cookie", "req.headers.authorization", "req.headers.cookie", "*.token", "*.password", "*.secretKey", "*.secretValue"];
-/** 构造 Fastify 的 logger 选项 */
-export declare function createLoggerOptions(env: ConfigEnv): FastifyServerOptions['logger'];
-//# sourceMappingURL=logging.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../../source/app/core/logging.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAC1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAEnD;;;;;GAKG;AAEH,8BAA8B;AAC9B,eAAO,MAAM,gBAAgB,gKAUnB,CAAA;AAEV,6BAA6B;AAC7B,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,SAAS,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAQlF"}

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

@@ -1,17 +0,0 @@
-import type { FastifyInstance } from 'fastify';
-/**
- * core `openapi`（设计 §5.1）——**框架内置、锁定、不可替换/修改**。
- *
- * `@fastify/swagger` + `@scalar/fastify-api-reference`；`/reference` 与 `/reference/openapi.json`；
- * `servers: [{ url: '/' }]`（构建期不依赖 env / DB）；`version` 取 `app.version`（必填，无默认）；
- * `securitySchemes.bearerAuth`；`onListen` 打印实际地址。
- */
-export declare const DOC_ROUTE_PREFIX = "/reference";
-export declare const DOC_SPEC_ROUTE = "/reference/openapi.json";
-export declare const OPENAPI_SPEC_VERSION = "3.0.3";
-export interface OpenApiCoreOptions {
-    title: string;
-    version: string;
-}
-export declare function registerOpenApi(app: FastifyInstance, options: OpenApiCoreOptions): Promise<void>;
-//# sourceMappingURL=openapi.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../../source/app/core/openapi.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C;;;;;;GAMG;AAEH,eAAO,MAAM,gBAAgB,eAAe,CAAA;AAC5C,eAAO,MAAM,cAAc,4BAA4B,CAAA;AACvD,eAAO,MAAM,oBAAoB,UAAU,CAAA;AAE3C,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BtG"}

package/output/app/core/request-id.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"request-id.d.ts","sourceRoot":"","sources":["../../../source/app/core/request-id.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,iBAAiB,iBAAiB,CAAA;AAC/C,eAAO,MAAM,oBAAoB,cAAc,CAAA;AAE/C,qEAAqE;AACrE,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAOpG;AAED,sCAAsC;AACtC,wBAAgB,sBAAsB,IAAI;IACxC,eAAe,EAAE,MAAM,CAAA;IACvB,iBAAiB,EAAE,MAAM,CAAA;IACzB,QAAQ,EAAE,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAA;KAAE,KAAK,MAAM,CAAA;CAC1F,CAOA;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,CAwB5D"}

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

@@ -1,41 +0,0 @@
-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 / 资源（各资源 `ctx.registerClassifyError` 注册的分类器）→500 / 未知→500；**禁止按 `error.type` 细分**。
- * - `setNotFoundHandler` → 404 + `NOT_IMPLEMENTED`（落 `warn`，文案对齐 expense/notice）。
- * - 错误日志分级：`UserError` / zod → `warn`，其余 → `error`（带 stack）。
- * - **错误只给稳定码**（`status` 放错误码字符串），文案不归框架（由前端 / i18n 决定，§10-6）。
- */
-export declare const SUCCESS_STATUS = "SUCCESS";
-export declare const NOT_IMPLEMENTED_STATUS = "NOT_IMPLEMENTED";
-export declare const INVALID_INPUT_STATUS = "INVALID_INPUT";
-export declare const SERIALIZATION_ERROR_STATUS = "RESPONSE_SERIALIZATION_ERROR";
-export declare const UNKNOWN_ERROR_STATUS = "UNKNOWN_ERROR";
-/** 通用兜底文案（仅在 `error.message` 为空时使用） */
-export declare const DEFAULT_USER_MESSAGE = "\u8BF7\u6C42\u5931\u8D25";
-export declare const DEFAULT_SYSTEM_MESSAGE = "\u7CFB\u7EDF\u9519\u8BEF";
-export interface ResponseEnvelope<T> {
-    status: string;
-    message: string;
-    data: T;
-}
-export declare function createSuccessResponse<T>(data: T): ResponseEnvelope<T>;
-export declare function createErrorResponse(status: string, message: string): ResponseEnvelope<null>;
-/**
- * 资源错误分类器（单一来源：`types.ts`）。
- *
- * **每个资源注册自己的分类器**（一个资源一个，各管各的错误域）；由服务仓在 `resources(ctx)` 里
- * 通过 `ctx.registerClassifyError` 注册；未注册时错误落 `UNKNOWN_ERROR` 兜底。
- */
-export type { ErrorClassifier };
-export interface ResponseCoreOptions {
-    /** 资源错误分类（各资源经 `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 +0,0 @@
-{"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/define-server.negative-cases.d.ts

@@ -1,40 +0,0 @@
-import type { ServerConfig } from './types.js';
-/** #1 `resources` 看不到 `config` */
-export declare function resourcesCannotSeeConfig(): void;
-/** #2 `resources` 看不到 `services` */
-export declare function resourcesCannotSeeServices(): void;
-/** #3 `config` 看不到 `services` */
-export declare function configCannotSeeServices(): void;
-/** #4 `services` 看不到 `services`（禁 service 互依） */
-export declare function servicesCannotSeeServices(): void;
-/** #5 `routers` 看不到 `resources`（禁绕层直连数据层） */
-export declare function routersCannotSeeResources(): void;
-/** #6 `routers` 看不到 `config` */
-export declare function routersCannotSeeConfig(): void;
-/** #7 service 值声明 `dependsOn` → 该值塌成 `never` */
-export declare function serviceValueCannotDeclareDependsOn(): void;
-/** #8 service 值是原始类型 → 被拒（防把配置塞进 services） */
-export declare function serviceValueCannotBePrimitive(): void;
-/** #9 `startServer` 只接受品牌产物，裸 `ServerConfig` 编译失败 */
-export declare function startServerRejectsBareConfig(bare: ServerConfig<unknown, unknown, unknown>): void;
-/** #10 `app.version` 必填 */
-export declare function appVersionIsRequired(): void;
-/** #11 `cache: false` 静态关闭：键被 `Live<>` 从资源视图剔除 */
-export declare function staticallyDisabledResourceIsRemoved(): void;
-/** #12 `config` 看不到 `app` */
-export declare function configCannotSeeApp(): void;
-/** #13 `middlewares` 看不到 `resources`（中间件禁直连数据层） */
-export declare function middlewaresCannotSeeResources(): void;
-/** #14 `middlewares` 看不到 `env` */
-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 +0,0 @@
-{"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"}