@sfmc-bds/db-server 0.1.0

package/dist/routes/modules.js

@@ -0,0 +1,92 @@
+/**
+ * routes/modules.ts — 模块目录与启停（基于 modules/catalog.json + module-lock.json）
+ *
+ * 路由列表：
+ *   GET  /api/sfmc/modules                       — 模块列表（含 enable 状态）
+ *   GET  /api/sfmc/modules/catalog               — 原始 catalog 列表
+ *   GET  /api/sfmc/modules/:key                  — 单个模块详情
+ *   PATCH/PUT /api/sfmc/modules/:key             — 设置 enabled
+ *   POST /api/sfmc/modules/:key/enable           — 启用模块
+ *   POST /api/sfmc/modules/:key/disable          — 禁用模块
+ */
+function createModuleRoutes({ loadModuleCatalog, buildModuleList, resolveModuleByKey, setModuleEnabled, body, json, }) {
+    return async function handleModuleRoute({ path, method, params, req, res, }) {
+        void params; // unused
+        if (path === "/api/sfmc/modules/catalog") {
+            if (method === "GET") {
+                json(res, { modules: loadModuleCatalog() });
+            }
+            else {
+                json(res, { success: false, error: "not_found" }, 404);
+            }
+            return true;
+        }
+        if (path === "/api/sfmc/modules") {
+            if (method === "GET")
+                json(res, { modules: buildModuleList() });
+            else
+                json(res, { success: false, error: "not_found" }, 404);
+            return true;
+        }
+        if (!path.startsWith("/api/sfmc/modules/"))
+            return false;
+        const rest = path.slice("/api/sfmc/modules/".length);
+        const [rawKey, action] = rest.split("/");
+        const module = resolveModuleByKey(decodeURIComponent(rawKey ?? ""));
+        if (!module) {
+            json(res, { success: false, error: "module_not_found" }, 404);
+            return true;
+        }
+        const current = () => buildModuleList().find((entry) => entry.id === module.id);
+        if (!action && method === "GET") {
+            json(res, { module: current() ?? null });
+        }
+        else if (!action && (method === "PATCH" || method === "PUT")) {
+            const { enabled } = await body(req);
+            if (!enabled && !module.canDisable) {
+                json(res, { success: false, error: "module_cannot_disable" }, 400);
+                return true;
+            }
+            try {
+                setModuleEnabled(module, !!enabled);
+            }
+            catch (error) {
+                const e = error;
+                if (e.code === "dependency_unmet") {
+                    json(res, { success: false, error: "dependency_unmet", unmet: e.unmet }, 409);
+                    return true;
+                }
+                throw error;
+            }
+            json(res, { success: true, module: current() });
+        }
+        else if (action === "enable" && method === "POST") {
+            try {
+                setModuleEnabled(module, true);
+            }
+            catch (error) {
+                const e = error;
+                if (e.code === "dependency_unmet") {
+                    json(res, { success: false, error: "dependency_unmet", unmet: e.unmet }, 409);
+                    return true;
+                }
+                throw error;
+            }
+            json(res, { success: true, module: current() });
+        }
+        else if (action === "disable" && method === "POST") {
+            if (!module.canDisable) {
+                json(res, { success: false, error: "module_cannot_disable" }, 400);
+                return true;
+            }
+            setModuleEnabled(module, false);
+            json(res, { success: true, module: current() });
+        }
+        else {
+            json(res, { success: false, error: "not_found" }, 404);
+        }
+        return true;
+    };
+}
+export { createModuleRoutes };
+//# sourceMappingURL=modules.js.map

package/dist/routes/modules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules.js","sourceRoot":"","sources":["../../src/routes/modules.ts"],"names":[],"mappings":"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"}

package/dist/routes/service-routes.d.ts

@@ -0,0 +1,26 @@
+/**
+ * routes/service-routes.ts — /api/sfmc/services/* 处理器
+ *
+ * 端点:
+ *   GET  /api/sfmc/services               → { services: [{name, moduleId}] }
+ *   GET  /api/sfmc/services/:name?input=<urlencoded json>
+ *        → { ok: true, result } | { ok: false, error, code } (+ HTTP status)
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+import { json as defaultJson, type Method } from "../lib/http.js";
+import type { ServiceRegistry } from "../service-registry.js";
+import { type ModuleAuth } from "./_shared.js";
+export interface ServiceRoutesDeps {
+    serviceRegistry: ServiceRegistry;
+    enabled: Map<string, import("../manifest-loader.js").ModuleManifestV2>;
+    json?: typeof defaultJson;
+}
+export declare function createServiceRoutes(depsIn: Partial<ServiceRoutesDeps>): (ctx: {
+    path: string;
+    method: Method | string;
+    params: URLSearchParams;
+    req: IncomingMessage;
+    res: ServerResponse;
+    moduleAuth?: ModuleAuth;
+}) => Promise<boolean>;
+//# sourceMappingURL=service-routes.d.ts.map

package/dist/routes/service-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-routes.d.ts","sourceRoot":"","sources":["../../src/routes/service-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,IAAI,IAAI,WAAW,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAElE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,eAAe,CAAC;IACjC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,uBAAuB,EAAE,gBAAgB,CAAC,CAAC;IACvE,IAAI,CAAC,EAAE,OAAO,WAAW,CAAC;CAC3B;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,iBAAiB,CAAC,IAOtD,KAAK;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,MAAM,EAAE,eAAe,CAAC;IACxB,GAAG,EAAE,eAAe,CAAC;IACrB,GAAG,EAAE,cAAc,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,KAAG,OAAO,CAAC,OAAO,CAAC,CA8DrB"}

package/dist/routes/service-routes.js

@@ -0,0 +1,68 @@
+/**
+ * routes/service-routes.ts — /api/sfmc/services/* 处理器
+ *
+ * 端点:
+ *   GET  /api/sfmc/services               → { services: [{name, moduleId}] }
+ *   GET  /api/sfmc/services/:name?input=<urlencoded json>
+ *        → { ok: true, result } | { ok: false, error, code } (+ HTTP status)
+ */
+import { json as defaultJson } from "../lib/http.js";
+import { assertModulePermission, Perm, PermissionDeniedError } from "../permission-gate.js";
+import { jsonV2Fail } from "./_shared.js";
+export function createServiceRoutes(depsIn) {
+    const deps = depsIn;
+    if (!deps.serviceRegistry || !deps.enabled) {
+        throw new Error("createServiceRoutes: 缺少 serviceRegistry / enabled map");
+    }
+    const json = deps.json || defaultJson;
+    return async (ctx) => {
+        const { path, method, params, res } = ctx;
+        if (!path.startsWith("/api/sfmc/services"))
+            return false;
+        if (method !== "GET")
+            return false;
+        const auth = ctx.moduleAuth ?? null;
+        if (!auth) {
+            // LSP: 与成功路径同一 ok 方言(文档约定 { ok:false, error, code })
+            jsonV2Fail(res, "unauthorized: module identity missing", 401, "unauthorized");
+            return true;
+        }
+        if (path === "/api/sfmc/services") {
+            json(res, { services: deps.serviceRegistry.list() });
+            return true;
+        }
+        const m = path.match(/^\/api\/sfmc\/services\/([A-Za-z0-9_.]+)$/);
+        if (m && m[1]) {
+            const name = m[1];
+            const rawInput = params.get("input");
+            let payload = {};
+            if (rawInput) {
+                try {
+                    payload = JSON.parse(rawInput);
+                }
+                catch (e) {
+                    json(res, { ok: false, error: `invalid input json: ${e.message}`, code: "bad_request" }, 400);
+                    return true;
+                }
+            }
+            try {
+                // 与 tx-runner.doService 对齐(LSP):HTTP service.get 与 tx.call 必须同契约 —
+                // 既要在 services.requires 里(由 dispatch 校验),也要有 service:<name> 权限。
+                assertModulePermission(auth.id, auth.permissions, Perm.service(name));
+                const out = await deps.serviceRegistry.dispatch(deps.enabled, auth.id, name, payload);
+                json(res, { ok: true, result: out.result });
+            }
+            catch (e) {
+                if (e instanceof PermissionDeniedError) {
+                    json(res, { ok: false, error: e.message, code: "permission_denied" }, 403);
+                    return true;
+                }
+                const err = e;
+                json(res, { ok: false, error: err.message, code: err.code ?? "internal" }, err.status ?? 500);
+            }
+            return true;
+        }
+        return false;
+    };
+}
+//# sourceMappingURL=service-routes.js.map

package/dist/routes/service-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-routes.js","sourceRoot":"","sources":["../../src/routes/service-routes.ts"],"names":[],"mappings":"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"}

package/dist/runtime.test.d.ts

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

package/dist/runtime.test.d.ts.map

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

package/dist/runtime.test.js

@@ -0,0 +1,66 @@
+import { deepEqual, equal, rejects, throws } from "node:assert/strict";
+import test from "node:test";
+import { SQL } from "sql-template-strings";
+import { assertIdentifier, quoteIdentifier } from "./lib/identifiers.js";
+import { parseNodeVersion } from "./lib/runtime.js";
+import { raw, sql } from "./lib/sql-helpers.js";
+import { DispatchError, ServiceRegistry } from "./service-registry.js";
+test("parses Node versions", () => {
+    deepEqual(parseNodeVersion("22.5.1"), { major: 22, minor: 5, patch: 1 });
+    deepEqual(parseNodeVersion("v22.5.1"), { major: 22, minor: 5, patch: 1 });
+});
+test("accepts only safe SQL identifiers", () => {
+    equal(quoteIdentifier("sfmc_players", "table"), '"sfmc_players"');
+    throws(() => assertIdentifier("users; DROP TABLE x"), /Invalid SQL/);
+});
+test("sql() embeds trusted identifiers and binds values", () => {
+    const TABLE = "sfmc_economy_accounts";
+    const q = sql(`SELECT * FROM ${TABLE} WHERE player_id = ?`, ["p1"]);
+    equal(q.sql, "SELECT * FROM sfmc_economy_accounts WHERE player_id = ?");
+    deepEqual(q.values, ["p1"]);
+});
+test("raw() only works via append — template interpolation still becomes ?", () => {
+    const TABLE = "sfmc_economy_accounts";
+    const broken = SQL `SELECT * FROM ${raw(TABLE)} WHERE id = ${"p1"}`;
+    equal(broken.sql, "SELECT * FROM ? WHERE id = ?");
+    const ok = SQL `SELECT * FROM `.append(raw(TABLE)).append(SQL ` WHERE id = ${"p1"}`);
+    equal(ok.sql, "SELECT * FROM sfmc_economy_accounts WHERE id = ?");
+    deepEqual(ok.values, ["p1"]);
+});
+test("ServiceRegistry: provider self-call skips requires (LSP with tx.call path)", async () => {
+    const reg = new ServiceRegistry();
+    reg.registerHandler("feature-economy", "economy.stats.monthly", async () => ({ ok: true }));
+    const enabled = new Map([
+        [
+            "feature-economy",
+            {
+                id: "feature-economy",
+                version: "1.0.0",
+                permissions: [],
+                services: { provides: [{ name: "economy.stats.monthly" }], requires: [] },
+                db: { tables: [] },
+                config: { key: "economy" },
+            },
+        ],
+    ]);
+    const out = await reg.dispatch(enabled, "feature-economy", "economy.stats.monthly", {});
+    deepEqual(out, { ok: true, result: { ok: true } });
+});
+test("ServiceRegistry: missing service → no_such_service (not not_in_requires)", async () => {
+    const reg = new ServiceRegistry();
+    const enabled = new Map([
+        [
+            "feature-chat",
+            {
+                id: "feature-chat",
+                version: "1.0.0",
+                permissions: [],
+                services: { provides: [], requires: [] },
+                db: { tables: [] },
+                config: { key: "chat" },
+            },
+        ],
+    ]);
+    await rejects(() => reg.dispatch(enabled, "feature-chat", "economy.account.get", {}), (e) => e instanceof DispatchError && e.code === "no_such_service");
+});
+//# sourceMappingURL=runtime.test.js.map

package/dist/runtime.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.test.js","sourceRoot":"","sources":["../src/runtime.test.ts"],"names":[],"mappings":"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"}

package/dist/schema-registry.d.ts

@@ -0,0 +1,63 @@
+/**
+ * schema-registry.ts — 收集模块 defineTable,统一建表
+ *
+ * 协议:
+ *   - 模块 SAPI 启动时调 db.defineTable(name, columns, {softDelete})
+ *     → POST /api/sfmc/db/define-table {moduleId, name, columns, softDelete}
+ *   - schema-registry 收集所有调用,CAS 锁
+ *   - 等所有"已注册模块"都调过(超时 fallback 或 explicit `finalize()`),
+ *     一次性 CREATE TABLE IF NOT EXISTS + CREATE INDEX IF NOT EXISTS
+ *   - 同一 module 重复 define 同名表 = 幂等(同名 columns 允许)
+ *   - 不同 module 抢同名表 = 启动失败
+ *   - 平台表(moduleId = "__platform__")由 db-tables.ts 在 initSchema 直接 bootstrap
+ *
+ * 列类型白名单:
+ *   text / integer / real / blob
+ *   修饰: primary / notNull / unique / default / index
+ *   softDelete = 自动加 _deleted_at INTEGER(列名带下划线) 和 _version INTEGER
+ */
+import type { DatabaseSync } from "node:sqlite";
+export type ColumnType = "text" | "integer" | "real" | "blob";
+export interface ColumnDef {
+    type: ColumnType;
+    primary?: boolean;
+    notNull?: boolean;
+    unique?: boolean;
+    default?: Primitive;
+    index?: boolean;
+    ref?: string;
+}
+export type Primitive = string | number | boolean | null;
+export interface DefineTableRequest {
+    name: string;
+    columns: Record<string, ColumnDef>;
+    softDelete?: boolean;
+}
+export interface DefineTableResult {
+    table: string;
+    created: boolean;
+    indices: string[];
+}
+export declare const PLATFORM_MODULE_ID = "__platform__";
+export declare class SchemaRegistry {
+    private readonly db;
+    private readonly tables;
+    private finalized;
+    constructor(db: DatabaseSync);
+    /** 模块 SAPI 启动时调。 */
+    define(moduleId: string, req: DefineTableRequest): DefineTableResult;
+    /** 幂等地物理建表 + 建索引(供 define / finalize 共用)。 */
+    private createPhysical;
+    /**
+     * 真正建表的时刻。所有 enabled 模块 init 完成(或明确调)后再 finalize。
+     * CREATE TABLE IF NOT EXISTS + CREATE INDEX IF NOT EXISTS,幂等。
+     */
+    finalize(): {
+        tableNames: string[];
+        created: string[];
+    };
+    listTables(): string[];
+    isRegistered(name: string): boolean;
+    getOwner(name: string): string | undefined;
+}
+//# sourceMappingURL=schema-registry.d.ts.map

package/dist/schema-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-registry.d.ts","sourceRoot":"","sources":["../src/schema-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AASD,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AA6DjD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAe;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAC1D,OAAO,CAAC,SAAS,CAAS;gBAEd,EAAE,EAAE,YAAY;IAI5B,oBAAoB;IACpB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,kBAAkB,GAAG,iBAAiB;IAwCpE,6CAA6C;IAC7C,OAAO,CAAC,cAAc;IAWtB;;;OAGG;IACH,QAAQ,IAAI;QAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE;IA4BvD,UAAU,IAAI,MAAM,EAAE;IAItB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAInC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAG3C"}

package/dist/schema-registry.js

@@ -0,0 +1,178 @@
+/**
+ * schema-registry.ts — 收集模块 defineTable,统一建表
+ *
+ * 协议:
+ *   - 模块 SAPI 启动时调 db.defineTable(name, columns, {softDelete})
+ *     → POST /api/sfmc/db/define-table {moduleId, name, columns, softDelete}
+ *   - schema-registry 收集所有调用,CAS 锁
+ *   - 等所有"已注册模块"都调过(超时 fallback 或 explicit `finalize()`),
+ *     一次性 CREATE TABLE IF NOT EXISTS + CREATE INDEX IF NOT EXISTS
+ *   - 同一 module 重复 define 同名表 = 幂等(同名 columns 允许)
+ *   - 不同 module 抢同名表 = 启动失败
+ *   - 平台表(moduleId = "__platform__")由 db-tables.ts 在 initSchema 直接 bootstrap
+ *
+ * 列类型白名单:
+ *   text / integer / real / blob
+ *   修饰: primary / notNull / unique / default / index
+ *   softDelete = 自动加 _deleted_at INTEGER(列名带下划线) 和 _version INTEGER
+ */
+import { log } from "./lib/log.js";
+export const PLATFORM_MODULE_ID = "__platform__";
+const IDENT = /^[A-Za-z_][A-Za-z0-9_]*$/;
+const VALID_TYPES = new Set(["text", "integer", "real", "blob"]);
+function assertValid(req, moduleId) {
+    if (!IDENT.test(req.name))
+        throw new Error(`[schema] ${moduleId}: invalid table name "${req.name}"`);
+    if (!req.columns || Object.keys(req.columns).length === 0) {
+        throw new Error(`[schema] ${moduleId}: ${req.name} has no columns`);
+    }
+    let pks = 0;
+    for (const [colName, def] of Object.entries(req.columns)) {
+        if (!IDENT.test(colName))
+            throw new Error(`[schema] ${moduleId}: invalid column name "${colName}" in ${req.name}`);
+        if (!VALID_TYPES.has(def.type)) {
+            throw new Error(`[schema] ${moduleId}: ${req.name}.${colName} bad type "${def.type}"`);
+        }
+        if (def.primary)
+            pks++;
+        if (def.ref) {
+            const [t, c] = def.ref.split(".");
+            if (!t || !c || !IDENT.test(t) || !IDENT.test(c)) {
+                throw new Error(`[schema] ${moduleId}: ${req.name}.${colName} invalid ref "${def.ref}"`);
+            }
+        }
+    }
+    if (pks > 1)
+        throw new Error(`[schema] ${moduleId}: ${req.name} has ${pks} primary keys (max 1)`);
+}
+/**
+ * 一次性把 columns 翻译成 CREATE TABLE。
+ * 例如 {id:{type:"text",primary:true},name:{type:"text",notNull:true}}
+ * → "id" TEXT PRIMARY KEY, "name" TEXT NOT NULL
+ */
+function buildColumnClause(name, def) {
+    const parts = [`"${name}"`, def.type.toUpperCase()];
+    if (def.primary)
+        parts.push("PRIMARY KEY");
+    if (def.notNull && !def.primary)
+        parts.push("NOT NULL");
+    if (def.unique)
+        parts.push("UNIQUE");
+    if (def.default !== undefined && def.default !== null) {
+        if (typeof def.default === "string")
+            parts.push(`DEFAULT '${def.default.replace(/'/g, "''")}'`);
+        else
+            parts.push(`DEFAULT ${def.default}`);
+    }
+    if (def.ref)
+        parts.push(`REFERENCES ${def.ref}`);
+    return parts.join(" ");
+}
+/**
+ * 把一张表的所有列(含 softDelete 隐式列)拼成 CREATE TABLE 的列定义数组。
+ * 隐式 _deleted_at / _version 作为独立列在末尾追加「一次」(此前误在每个列
+ * 子句里各追加一次,且无逗号分隔,导致 softDelete 表建表 SQL 语法错误)。
+ */
+function buildColumnList(columns, softDelete) {
+    const cols = [];
+    for (const [n, def] of Object.entries(columns)) {
+        cols.push(buildColumnClause(n, def));
+    }
+    if (softDelete) {
+        cols.push('"_deleted_at" INTEGER', '"_version" INTEGER DEFAULT 0');
+    }
+    return cols;
+}
+export class SchemaRegistry {
+    db;
+    tables = new Map();
+    finalized = false;
+    constructor(db) {
+        this.db = db;
+    }
+    /** 模块 SAPI 启动时调。 */
+    define(moduleId, req) {
+        if (this.finalized) {
+            throw new Error(`[schema] registry 已 finalize,模块 ${moduleId} 不能再 defineTable`);
+        }
+        assertValid(req, moduleId);
+        const existing = this.tables.get(req.name);
+        if (existing) {
+            if (existing.moduleId === moduleId) {
+                // 同模块重复定义:校验 columns 一致
+                if (JSON.stringify(existing.columns) !== JSON.stringify(req.columns)) {
+                    throw new Error(`[schema] ${moduleId} 重复 defineTable "${req.name}",columns 不一致`);
+                }
+                if (existing.softDelete !== (req.softDelete ?? true)) {
+                    throw new Error(`[schema] ${moduleId} 重复 defineTable "${req.name}",softDelete 不一致`);
+                }
+                log.info(`[schema] ${moduleId} 重复 define "${req.name}" 跳过`);
+                return { table: req.name, created: false, indices: [] };
+            }
+            throw new Error(`[schema] 表 "${req.name}" 已被模块 ${existing.moduleId} 定义,${moduleId} 不能抢同名表`);
+        }
+        const softDelete = req.softDelete ?? true;
+        const defined = {
+            moduleId,
+            name: req.name,
+            columns: req.columns,
+            softDelete,
+        };
+        this.tables.set(req.name, defined);
+        // 立即物理建表(幂等 CREATE TABLE IF NOT EXISTS)。
+        // 原设计是「define 收集 → finalize 统一建表」,但 finalize() 从未被调用,
+        // 导致模块表永远不会落地、后续 insert/query 全部 no such table。
+        // 采用 define 即建表:碰撞检测已在上方按内存表完成,不影响单一 owner 保证。
+        this.createPhysical(defined);
+        return { table: req.name, created: true, indices: [] };
+    }
+    /** 幂等地物理建表 + 建索引(供 define / finalize 共用)。 */
+    createPhysical(t) {
+        const cols = buildColumnList(t.columns, t.softDelete);
+        this.db.exec(`CREATE TABLE IF NOT EXISTS "${t.name}" (${cols.join(", ")})`);
+        for (const [n, def] of Object.entries(t.columns)) {
+            if (def.index) {
+                const idxName = `idx_${t.name}_${n}`.slice(0, 60);
+                this.db.exec(`CREATE INDEX IF NOT EXISTS "${idxName}" ON "${t.name}"("${n}")`);
+            }
+        }
+    }
+    /**
+     * 真正建表的时刻。所有 enabled 模块 init 完成(或明确调)后再 finalize。
+     * CREATE TABLE IF NOT EXISTS + CREATE INDEX IF NOT EXISTS,幂等。
+     */
+    finalize() {
+        if (this.finalized)
+            return { tableNames: [...this.tables.keys()], created: [] };
+        this.finalized = true;
+        const created = [];
+        for (const t of this.tables.values()) {
+            const cols = buildColumnList(t.columns, t.softDelete);
+            const ddl = `CREATE TABLE IF NOT EXISTS "${t.name}" (${cols.join(", ")})`;
+            this.db.exec(ddl);
+            for (const [n, def] of Object.entries(t.columns)) {
+                if (def.index) {
+                    const idxName = `idx_${t.name}_${n}`.slice(0, 60);
+                    this.db.exec(`CREATE INDEX IF NOT EXISTS "${idxName}" ON "${t.name}"("${n}")`);
+                }
+            }
+            const exists = this.db
+                .prepare("SELECT name FROM sqlite_master WHERE type='table' AND name=?")
+                .get(t.name)?.name === t.name;
+            if (exists)
+                created.push(t.name);
+            log.success(`[schema] ${t.moduleId} → ${t.name} (softDelete=${t.softDelete})`);
+        }
+        return { tableNames: [...this.tables.keys()], created };
+    }
+    listTables() {
+        return [...this.tables.keys()];
+    }
+    isRegistered(name) {
+        return this.tables.has(name);
+    }
+    getOwner(name) {
+        return this.tables.get(name)?.moduleId;
+    }
+}
+//# sourceMappingURL=schema-registry.js.map

package/dist/schema-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-registry.js","sourceRoot":"","sources":["../src/schema-registry.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,27 @@
+/**
+ * server.ts — HTTP 服务 + 控制台
+ */
+import http from "node:http";
+import readline from "node:readline";
+import type { DatabaseSync } from "node:sqlite";
+interface CheckResult {
+    ok: boolean;
+    port: number;
+    error?: string;
+}
+export declare function checkPortConflict(port: number): Promise<CheckResult>;
+export type ServerEnv = {
+    PORT: number;
+    HOST: string;
+    AUTH_TOKEN?: string;
+};
+export type Handler = (req: http.IncomingMessage, res: http.ServerResponse) => void | Promise<void>;
+export interface ServerOptions {
+    env: ServerEnv;
+    handle: Handler;
+    onListening?: (server: http.Server) => void;
+}
+export declare function createServer({ handle, env, onListening }: ServerOptions): http.Server;
+export declare function startConsole(server: http.Server, db: DatabaseSync | null): readline.Interface;
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,UAAU,WAAW;IACnB,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAgBpE;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,IAAI,CAAC,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEpG,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,SAAS,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC;CAC7C;AAED,wBAAgB,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE,aAAa,GAAG,IAAI,CAAC,MAAM,CA2BrF;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,YAAY,GAAG,IAAI,GAAG,QAAQ,CAAC,SAAS,CAyB7F"}