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

package/output/app/types.d.ts

@@ -1,33 +1,37 @@
 import type { Disposer } from '@taicode/common-base';
-import type { FastifyInstance, FastifyPluginAsync } from 'fastify';
-import type { ModuleAssembly } from './module.js';
-import type { ShutdownStepName } from './shutdown.js';
-import type { StepName } from './steps.js';
-/** 原生 Fastify 实例，原样返回（不包 `fastify-plugin`、不返回包装对象） */
-export type ServerInstance = FastifyInstance;
-export type ServerMode = 'production' | 'test' | 'openapi-build';
-/** 错误工厂：由各服务 `errors.ts` 的 `define()` 产出（`class extends Error`） */
-export type ErrorFactory = new (...args: never[]) => Error;
-export interface ErrorFactories {
-    UserError: ErrorFactory;
-    SystemError: ErrorFactory;
-}
-/** 运行时配置快照（对应各仓导出的 `config` 常量） */
-export interface RuntimeConfig {
-    debug: boolean;
-    port: number;
-}
+import type { FastifyBaseLogger, FastifyInstance, RawServerDefault } from 'fastify';
+import type { ZodTypeProvider } from 'fastify-type-provider-zod';
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { ConfigEnv } from './env.js';
 /**
- * 配置模块端口（design §4.2）。`loadConfig` 必填；依赖数据层的服务才需要 `loadPostgresConfig`。
+ * `defineServer` 槽位口径与接口类型（N1 / N2，**唯一规格来源**）。
+ *
+ * 顶层是「一个身份块 + 五个工厂槽位」，**键顺序即分层**：
+ *
+ * ```
+ * app            （身份块，无依赖）
+ * resources      ← env                     引导期：唯一读 env 的地方
+ * config         ← env + resources         引导期：❗不给 services（结构性解耦）
+ * services       ← resources + config      运行期开始：❗不给 env、不给 services
+ * middlewares    ← app + services + config （不给 resources / env）
+ * routers        ← app + services          （不给 resources / env / config）
+ * ```
+ *
+ * 槽位只能引用**排在它前面**的产物（向下引用是编译错误）；`env` 只属引导期
+ * （`resources` / `config` 可见，运行期三层一律看不到）。
+ *
+ * 类型安全机制（N2 §1）：
+ * - **M1 分阶段 ctx**：每个工厂只拿到「该阶段该看的字段」；
+ * - **M2 `Awaited<>` 归一**：工厂签名写 `(ctx) => R`（不是 `R | Promise<R>`），下游一律
+ *   `Awaited<R>` / `Awaited<C>` / `Awaited<S>`；
+ * - **M3 资源嵌套**：资源包挂在 `ctx.resources` 上（不再摊平到 ctx，键冲突从根上消失）；
+ * - **M4 `Live<T>` 静态开关**：资源包里值为 `false` 的键在类型上剔除；
+ * - **M5 强类型 `services`**：`middlewares` / `routers` 的 `ctx.services` 是 `S` 实体；
+ * - **M6 品牌 + 类型守卫**：`Server` 带品牌，`isServer()` 收窄；
+ * - **M7 负向类型测试**：`define-server.negative-cases.ts`，由 `tsc --noEmit` 覆盖。
  *
- * 骨架不替调用方加载 env —— 请先自行调用 `loadEnvFiles()`（详见 `./env.js`）。
+ * 命名全拼：`requestId` / `database` / `configuration` / `service`（不用 `db` / `cfg`）。
  */
-export interface ConfigModule {
-    loadConfig: () => RuntimeConfig;
-    loadPostgresConfig?: () => unknown | Promise<unknown>;
-    resolveRedisUrl?: () => string | undefined;
-    resolveCachePrefix?: () => string | undefined;
-}
 /** 骨架只按 `(obj, msg)` 形态打日志；`app.log` 与 `@taicode/common-base` 的 `Logger` 都满足 */
 export interface LoggerLike {
     debug: (obj: unknown, msg?: string) => void;
@@ -35,115 +39,173 @@ export interface LoggerLike {
     warn: (obj: unknown, msg?: string) => void;
     error: (obj: unknown, msg?: string) => void;
 }
+/** 同步或异步（`Awaited<>` 归一的原料） */
+export type MaybePromise<T> = T | Promise<T>;
 /**
- * 骨架**不操作** Redis 命令，只持有并在关闭时透传 dispose；
- * 因此保持开放类型，各仓注入自己的客户端（如 node-redis）不受约束。
+ * 路由级类型安全的载体：带 `ZodTypeProvider` 的 `FastifyInstance`。
+ *
+ * 裸 `FastifyInstance` 会让路由的 `params` / `body` / `query` 全是 `unknown`；带上 provider 后
+ * `request.params.id` 有类型。
  */
-export type RedisLike = unknown;
-export interface RedisHandle {
-    client: RedisLike;
-    dispose: () => Promise<void>;
-}
-export type DisposeFunction = () => unknown;
-export type UnsubscribeFunction = () => unknown;
-export interface GlobalConfigOptions {
-    redisUrl?: string;
-    channelPrefix?: string;
-}
-/** 贯穿步骤 5/6/8 的依赖上下文 */
-export interface DbContext<Db = unknown> {
-    db: Db;
-    redis?: RedisLike;
-    globalConfig: unknown;
-}
-export interface ServicesContext<S = unknown> {
-    services: S;
+export type AppInstance = FastifyInstance<RawServerDefault, IncomingMessage, ServerResponse, FastifyBaseLogger, ZodTypeProvider>;
+/**
+ * 身份块：非 env 派生，出 spec 路径也要用。
+ *
+ * `version` **必填、无默认值**（缺它就是编译错误，杜绝「悄悄兜底成 1.0.0」）。
+ */
+export interface AppIdentity {
+    /** 权限注册键 / cache 前缀 / 失效通道前缀 / 日志标签 */
+    readonly service: string;
+    readonly title: string;
+    /** openapi `info.version` + 权限操作自注册；建议从 package.json 读入 */
+    readonly version: string;
 }
-export interface InitContext<Db = unknown, S = unknown> extends DbContext<Db> {
-    services: S;
+/**
+ * Redis 句柄（惰性包装）。
+ *
+ * 框架**不操作** Redis 命令，只持有并在关闭时透传 dispose；构造时不建连、不 ping。
+ * 因此保持开放类型，各仓注入自己的客户端实现不受约束。
+ */
+export interface RedisHandle {
+    client: unknown;
+    dispose: () => void | Promise<void>;
 }
-export interface WorkersContext<Db = unknown, S = unknown> extends DbContext<Db> {
-    services: S;
-    disposer: Disposer;
+/**
+ * 剔掉值为 `false` 的键（编译期静态开关）。
+ *
+ * 资源包里写 `cache: false` 表示**静态关闭**：`Live<T>` 里该键**不存在**，访问直接编译失败；
+ * 而 `cache: Cache | undefined`（显式可选）表示**运行时缺省**：键存在，类型为 `Cache | undefined`。
+ */
+export type Live<T> = {
+    [K in keyof T as T[K] extends false ? never : K]: T[K];
+};
+/** 框架在 ctx 上暴露的资源视图（`Awaited<>` 归一 + `false` 键剔除） */
+export type ResourcesView<R> = Live<Awaited<R>>;
+/**
+ * `resources(ctx)` 的入参：**只有 `env` + `log`**。
+ *
+ * 结构上排除 `config` / `services` / `app` → 「资源依赖配置」这类循环**编译期写不出来**。
+ */
+export interface ResourcesContext {
+    readonly env: ConfigEnv;
+    readonly log: LoggerLike;
 }
-export interface ReadyContext<S = unknown> {
-    app: FastifyInstance;
-    services: S;
+export type ResourcesFactory<R> = (ctx: ResourcesContext) => R;
+/**
+ * `config(ctx)` 的入参：`env` + `log` + 资源视图。
+ *
+ * **没有** `services`（此时尚未构造）/ `app`（此时尚未装配）。
+ */
+export interface ConfigContext<R> {
+    readonly env: ConfigEnv;
+    readonly log: LoggerLike;
+    readonly resources: ResourcesView<R>;
 }
-export interface ServerOptions {
-    port: number;
-    host?: string;
+export type ConfigFactory<R, C> = (ctx: ConfigContext<R>) => C;
+/**
+ * 一个 service 值：可选实现 `init` / `dispose`。
+ *
+ * **没有 `name` / `dependsOn`**：名字用对象键，依赖不存在（`services` ctx 没有 `services` 字段，
+ * 编译期禁止互依）。顺序语义只有一条：按**对象声明序** `init` / **逆序** `dispose`。
+ */
+export interface ServiceUnit {
+    init?(): void | Promise<void>;
+    dispose?(): void | Promise<void>;
 }
-export type ResolveMessage = (type: string, context: unknown, explicit?: string) => string | undefined;
-export type MapStatus = (type: string) => number | null;
-/** 骨架内部持有的运行时句柄（配置 / 关闭流程用） */
-export interface RuntimeState {
-    app?: FastifyInstance;
-    db?: unknown;
-    redis?: RedisHandle;
-    globalConfig?: unknown;
-    services?: unknown;
-    disposer: Disposer;
-    unsubscribe?: UnsubscribeFunction;
-    disposeConfig?: DisposeFunction;
+/**
+ * `services(ctx)` 的入参：`log` + `disposer` + `resources` + `config`。
+ *
+ * ❗**故意没有 `env`**（服务层属运行期，不得读 env）；❗**故意没有 `services`**（禁 service 互依）。
+ */
+export interface ServiceContext<R, C> {
+    readonly log: LoggerLike;
+    readonly disposer: Disposer;
+    readonly resources: ResourcesView<R>;
+    readonly config: Awaited<C>;
 }
-/** 每个步骤执行时拿到的上下文（`log` 在 `createFastify` 之后默认降级/升级为 `app.log`） */
-export interface StepContext {
-    options: DefineServerOptions;
-    state: RuntimeState;
-    log: LoggerLike;
+export type ServicesFactory<R, C, S> = (ctx: ServiceContext<R, C>) => S;
+/**
+ * 中间件单元：一个注册函数（`register(app)`），按**数组序**注册。
+ *
+ * `name` 仅用于报错定位 / 日志跟踪；**不参与生命周期**（要常驻资源就放 `services`）。
+ */
+export interface MiddlewareUnit {
+    readonly name?: string;
+    register(app: AppInstance): void | Promise<void>;
 }
-export type StepRunner = (ctx: StepContext) => unknown | Promise<unknown>;
-export type StepImplementations = Record<StepName, StepRunner>;
-export type ShutdownRunner = (ctx: StepContext) => unknown | Promise<unknown>;
-export type ShutdownImplementations = Record<ShutdownStepName, ShutdownRunner>;
-/** 模块可贡献的生命周期 hook（design §4.2） */
-export interface ServerHooks {
-    beforeShutdown?: () => unknown | Promise<unknown>;
-    shutdown?: (signal: string) => unknown | Promise<unknown>;
-    disposeServices?: (ctx: ServicesContext) => unknown | Promise<unknown>;
-    disposeClients?: () => unknown | Promise<unknown>;
+/**
+ * `middlewares(ctx)` 的入参：`app` + `log` + `services` + `config`。
+ *
+ * ❗**故意没有 `resources` / `env`** —— 中间件要访问数据层必须穿过 service。
+ */
+export interface MiddlewareContext<C, S> {
+    readonly app: AppInstance;
+    readonly log: LoggerLike;
+    readonly services: Awaited<S>;
+    readonly config: Awaited<C>;
 }
+export type MiddlewaresFactory<C, S> = (ctx: MiddlewareContext<C, S>) => MiddlewareUnit[];
 /**
- * `defineServer()` 入参（design §3.4）。
+ * `routers(ctx)` 的入参：`app` + `log` + `services`。
  *
- * `Db` 由 `modules.database`（`database` 模块的 `createClient` 返回类型）**推断**（决策 10-2），
- * 因此调用方**不需要**在 `createServices` 里写 `as PrismaClient` 强转。
+ * ❗**故意没有 `resources` / `env` / `config`** —— 路由**只能穿过 service**，绕不过层直连数据层。
  */
-export interface DefineServerOptions<Db = unknown, S = unknown> {
-    serviceName: string;
-    title: string;
-    description: string;
-    version?: string;
-    mode?: ServerMode;
-    serverOptions?: ServerOptions;
-    serverUrl?: string | (() => string | null);
-    openapiVersion?: string;
-    docPath?: string;
-    log?: LoggerLike;
-    signal?: boolean;
-    errors: ErrorFactories;
-    messages?: Record<string, string>;
-    resolveMessage?: ResolveMessage;
-    mapStatus?: MapStatus;
-    modules?: ModuleAssembly<Db>;
-    config: ConfigModule;
-    setupCompilers?: (app: FastifyInstance) => void;
-    createRedis?: (config: ConfigModule) => RedisHandle | undefined;
-    initGlobalConfig?: (db: Db, opts: GlobalConfigOptions) => void | DisposeFunction;
-    onGlobalConfigChange?: (globalConfig: unknown) => void;
-    initClients?: (ctx: DbContext<Db>) => Promise<void | UnsubscribeFunction>;
-    extraPlugins?: FastifyPluginAsync[];
-    createServices: (ctx: DbContext<Db>) => S;
-    initServices?: (ctx: ServicesContext<S>) => Promise<void>;
-    backgroundWorkers?: (ctx: WorkersContext<Db, S>) => Promise<void>;
-    registerRouters: (app: FastifyInstance, ctx: ServicesContext<S>) => Promise<void> | void;
-    afterInit?: (ctx: InitContext<Db, S>) => Promise<DisposeFunction | void>;
-    afterReady?: (ctx: ReadyContext<S>) => Promise<void>;
-    beforeShutdown?: () => Promise<void> | void;
-    disposeServices?: (ctx: ServicesContext<S>) => Promise<void> | void;
-    disposeClients?: () => Promise<void> | void;
-    /** 覆盖默认关闭流程（design §3.4 / §5） */
-    shutdown?: (signal: string) => Promise<void> | void;
+export interface RouterContext<S> {
+    readonly app: AppInstance;
+    readonly log: LoggerLike;
+    readonly services: Awaited<S>;
 }
+export type RoutersFactory<S> = (ctx: RouterContext<S>) => void | Promise<void>;
+/**
+ * 若某个 service 值声明了 `dependsOn`，该值类型塌成 `never` → 赋值报错。
+ */
+export type AssertNoDependencies<S> = {
+    [K in keyof S]: S[K] extends {
+        dependsOn: unknown;
+    } ? never : S[K];
+};
+/**
+ * `services` 返回值形状闸门：
+ * - 原始类型值（`string` / `number` / `boolean`）**拒绝**（防把配置塞进 services）；
+ * - 声明了 `dependsOn` 的值**拒绝**（禁 service 互依）。
+ */
+export type ServicesShape<S> = {
+    [K in keyof S]: S[K] extends string | number | boolean ? never : S[K] extends {
+        dependsOn: unknown;
+    } ? never : S[K];
+};
+/**
+ * `defineServer()` 入参：一个身份块 + 五个工厂槽位（键顺序=分层）。
+ *
+ * `S` 上的两道闸门（`ServicesShape<S>`，N2 §2.5）写在 `services` 的返回类型上：
+ * `S & ServicesShape<S>` —— 形状合法时恒等，非法时该值塌成 `never` → 编译失败。
+ */
+export interface ServerConfig<R, C, S> {
+    app: AppIdentity;
+    resources: ResourcesFactory<R>;
+    config: ConfigFactory<NoInfer<R>, C>;
+    services: (ctx: ServiceContext<NoInfer<R>, NoInfer<C>>) => S & ServicesShape<S>;
+    middlewares: MiddlewaresFactory<NoInfer<C>, NoInfer<S>>;
+    routers: RoutersFactory<NoInfer<S>>;
+}
+/** 品牌字段值（`Server` 的 `__brand`） */
+export declare const SERVER_BRAND = "taicode.server";
+/** 纯定义产物：同一份定义可同时喂给「启动」与「出 spec」 */
+export type Server<R, C, S> = ServerConfig<R, C, S> & {
+    readonly __brand: typeof SERVER_BRAND;
+};
+/** `startServer()` 的逃生选项 */
+export interface StartServerOptions<R = unknown, C = unknown, S = unknown> {
+    /** 是否 listen + 装信号；默认 `NODE_ENV !== 'test'` */
+    listen?: boolean;
+    /** 整体覆盖关闭流程 */
+    shutdown?: (ctx: ShutdownContext<R, C, S>) => Promise<void>;
+}
+/** 关闭阶段视图：`services` ctx + `app` + `services` 实体 */
+export interface ShutdownContext<R, C, S> extends ServiceContext<R, C> {
+    readonly app: AppInstance;
+    readonly services: Awaited<S>;
+}
+/** `generateOpenApi()` 的返回（OpenAPI 文档对象） */
+export type OpenApiDocument = Record<string, unknown>;
 //# sourceMappingURL=types.d.ts.map

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

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

package/output/app/types.js

@@ -1 +1,2 @@
-export {};
+/** 品牌字段值（`Server` 的 `__brand`） */
+export const SERVER_BRAND = 'taicode.server';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taicode/common-server",
-  "version": "3.8.0",
+  "version": "4.0.0-beta.1",
   "author": "Alain",
   "license": "ISC",
   "description": "",
@@ -24,13 +24,18 @@
     "output"
   ],
   "dependencies": {
-    "dotenv": "^17.3.1"
+    "@fastify/cookie": "^11",
+    "@fastify/cors": "^11",
+    "@fastify/swagger": "^9",
+    "@scalar/fastify-api-reference": "^1",
+    "dotenv": "^17.3.1",
+    "fastify-type-provider-zod": "^6",
+    "zod": "^4.3.6"
   },
   "peerDependencies": {
     "fastify": "^5.5.0",
     "redis": "^5.11.0",
-    "zod": "^4.1.0",
-    "@taicode/common-base": "^3.8.0"
+    "@taicode/common-base": "^4.0.0-beta.1"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.3",
@@ -44,8 +49,7 @@
     "redis": "^5.11.0",
     "typescript-eslint": "^8.56.1",
     "vitest": "^3.2.4",
-    "zod": "^4.3.6",
-    "@taicode/common-base": "^3.8.0"
+    "@taicode/common-base": "^4.0.0-beta.1"
   },
   "scripts": {
     "test": "vitest run",

package/output/app/assemble.d.ts

@@ -1,16 +0,0 @@
-import type { DatabaseModule, ModuleAssembly, ModuleName, ServerModule } from './module.js';
-/** 装配结果：注册顺序、按名索引、被 `false` 跳过的名字、以及数据层模块句柄 */
-export interface ResolvedModules {
-    order: ModuleName[];
-    byName: Partial<Record<ModuleName, ServerModule>>;
-    disabled: ModuleName[];
-    database?: DatabaseModule;
-}
-/**
- * 装配期校验 + 槽位解析（design §3.2）。
- *
- * 报错**发生在 `defineServer()` 装配阶段**（返回 promise resolve 之前），不拖到 `listen` 才炸。
- * 校验顺序：未知名 → 重复 / 键名不符 → 依赖被跳过 / 依赖环 → 未实现模块未显式 false → database 未提供。
- */
-export declare function assembleModules(assembly?: ModuleAssembly): ResolvedModules;
-//# sourceMappingURL=assemble.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"assemble.d.ts","sourceRoot":"","sources":["../../source/app/assemble.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE3F,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAA;IACjD,QAAQ,EAAE,UAAU,EAAE,CAAA;IACtB,QAAQ,CAAC,EAAE,cAAc,CAAA;CAC1B;AA2HD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,cAAc,GAAG,eAAe,CAQ1E"}

package/output/app/assemble.js

@@ -1,124 +0,0 @@
-import { createDefaultModules } from './default-modules.js';
-import { MODULE_NAMES, PENDING_MODULES } from './module.js';
-function isModuleName(value) {
-    return MODULE_NAMES.includes(value);
-}
-function assertKnownNames(provided) {
-    for (const key of Object.keys(provided)) {
-        if (!isModuleName(key)) {
-            throw new Error(`Unknown module "${key}". Allowed: ${MODULE_NAMES.join(', ')}`);
-        }
-    }
-}
-function assertNamesMatch(provided) {
-    const seen = new Set();
-    for (const key of Object.keys(provided)) {
-        const value = provided[key];
-        if (value === undefined || value === false) {
-            continue;
-        }
-        if (seen.has(value.name)) {
-            throw new Error(`Module "${value.name}" registered twice`);
-        }
-        if (value.name !== key) {
-            throw new Error(`Module key "${key}" != module.name "${value.name}"`);
-        }
-        seen.add(value.name);
-    }
-}
-function assertNoCycles(provided) {
-    const visiting = new Set();
-    const visited = new Set();
-    function visit(name, path) {
-        if (visited.has(name)) {
-            return;
-        }
-        if (visiting.has(name)) {
-            throw new Error(`Module dependency cycle detected: ${[...path, name].join(' -> ')}`);
-        }
-        visiting.add(name);
-        const value = provided[name];
-        const deps = value === undefined || value === false ? [] : value.dependsOn ?? [];
-        for (const dep of deps) {
-            if (isModuleName(dep)) {
-                visit(dep, [...path, name]);
-            }
-        }
-        visiting.delete(name);
-        visited.add(name);
-    }
-    for (const key of Object.keys(provided)) {
-        if (isModuleName(key)) {
-            visit(key, []);
-        }
-    }
-}
-function assertDependencies(provided) {
-    for (const key of Object.keys(provided)) {
-        const value = provided[key];
-        if (value === undefined || value === false) {
-            continue;
-        }
-        for (const dep of value.dependsOn ?? []) {
-            if (!isModuleName(dep)) {
-                throw new Error(`Module "${value.name}" depends on unknown module "${dep}"`);
-            }
-            if (provided[dep] === false) {
-                throw new Error(`Module "${value.name}" depends on "${dep}" which is disabled`);
-            }
-        }
-    }
-    assertNoCycles(provided);
-}
-function assertPendingProvided(provided) {
-    for (const [name, stage] of Object.entries(PENDING_MODULES)) {
-        if (provided[name] === undefined) {
-            throw new Error(`Module "${name}" is not implemented until ${stage}; pass false to opt out`);
-        }
-    }
-}
-function assertDatabaseProvided(provided) {
-    if (provided.database === undefined) {
-        throw new Error('Module "database" requires createPrismaDatabaseModule({...}) or false');
-    }
-}
-function resolveModules(provided) {
-    const defaults = createDefaultModules();
-    const byName = {};
-    const disabled = [];
-    for (const name of MODULE_NAMES) {
-        const value = provided[name];
-        if (value === false) {
-            disabled.push(name);
-            continue;
-        }
-        if (value) {
-            byName[name] = value;
-            continue;
-        }
-        const fallback = defaults[name];
-        if (fallback) {
-            byName[name] = fallback;
-        }
-    }
-    const order = MODULE_NAMES.filter((name) => byName[name] !== undefined);
-    const candidate = byName.database;
-    // `database` 已由 `assertDatabaseProvided` 强制显式：走到这里要么是 `DatabaseModule`，要么是 `false`
-    const database = typeof candidate?.createClient === 'function' ? candidate : undefined;
-    return { order, byName, disabled, database };
-}
-/**
- * 装配期校验 + 槽位解析（design §3.2）。
- *
- * 报错**发生在 `defineServer()` 装配阶段**（返回 promise resolve 之前），不拖到 `listen` 才炸。
- * 校验顺序：未知名 → 重复 / 键名不符 → 依赖被跳过 / 依赖环 → 未实现模块未显式 false → database 未提供。
- */
-export function assembleModules(assembly) {
-    const provided = (assembly ?? {});
-    assertKnownNames(provided);
-    assertNamesMatch(provided);
-    assertDependencies(provided);
-    assertPendingProvided(provided);
-    assertDatabaseProvided(provided);
-    return resolveModules(provided);
-}

package/output/app/database.d.ts

@@ -1,36 +0,0 @@
-import type { DatabaseClientParams, DatabaseModule, PrismaErrorConstructors, PrismaOperationLabels } from './module.js';
-export interface PrismaDatabaseModuleParams<Ctor extends new (...args: never[]) => unknown> {
-    /**
-     * 各仓生成的 client 构造函数（`@prisma/generated/*`）——**只能由各仓经参数注入**，
-     * common 不引用任何具体生成产物（决策 #8）。
-     */
-    PrismaClient: Ctor;
-    /**
-     * 各仓生成的命名空间（`instanceof` 判定用；跨包 `instanceof` 不可靠，决策 #9）。
-     */
-    PrismaNamespace: PrismaErrorConstructors;
-    /** 可选：覆盖 operation 标签；不传则用 common 默认集 */
-    operationLabels?: PrismaOperationLabels;
-    /**
-     * 可选：构造 Prisma client 的参数工厂。
-     *
-     * common **不依赖** `@prisma/client` 与其驱动适配器（如 `@prisma/adapter-pg`），
-     * 由调用方注入构造参数，例如：
-     *
-     * ```ts
-     * createClientArgs: (params) => [
-     *   { adapter: new PrismaPg(params.postgresConfig, { schema: (params.postgresConfig as { schema: string }).schema }) },
-     * ]
-     * ```
-     *
-     * 省略时等价于 `new PrismaClient()`（要求传入的 `PrismaClient` 自身可完成连接）。
-     */
-    createClientArgs?: (params: DatabaseClientParams) => unknown[];
-}
-/**
- * `database` 模块的默认实现：Prisma（design §3.3 / 调研 D）。
- *
- * 返回类型即 `defineServer<Db>` 的 `Db`，调用方据此**推断**类型、无需强转（决策 10-2）。
- */
-export declare function createPrismaDatabaseModule<Ctor extends new (...args: never[]) => unknown>(params: PrismaDatabaseModuleParams<Ctor>): DatabaseModule<InstanceType<Ctor>>;
-//# sourceMappingURL=database.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../source/app/database.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAevH,MAAM,WAAW,0BAA0B,CAAC,IAAI,SAAS,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO;IACxF;;;OAGG;IACH,YAAY,EAAE,IAAI,CAAA;IAClB;;OAEG;IACH,eAAe,EAAE,uBAAuB,CAAA;IACxC,yCAAyC;IACzC,eAAe,CAAC,EAAE,qBAAqB,CAAA;IACvC;;;;;;;;;;;;;OAaG;IACH,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,OAAO,EAAE,CAAA;CAC/D;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,SAAS,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,EACvF,MAAM,EAAE,0BAA0B,CAAC,IAAI,CAAC,GACvC,cAAc,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CA2BpC"}

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();
-            }
-        },
-    };
-}