@sfmc-bds/db-server 0.1.0

package/dist/domain/transaction.js

@@ -0,0 +1,85 @@
+/**
+ * domain/transaction.ts — SQLite 事务执行器 + 共享业务结果类型
+ *
+ * 事务描述:
+ *   - withTransaction(db, fn)   IMMEDIATE 事务包裹器
+ *                                自动 BEGIN IMMEDIATE / COMMIT / ROLLBACK,
+ *                                异常时 ROLLBACK 并重新抛错;支持同步 + async 回调
+ *   - withResult(db, fn)        withTransaction 的语义别名(供"业务失败但不抛错"
+ *                                的场景,函数返回 TxResult 自己判 ok)
+ *
+ * 共享类型:
+ *   - Transactional   事务执行器所需的最小接口(Pick<DatabaseSync, "exec">),
+ *                     让领域函数能接受 node:sqlite DatabaseSync 或 routes 注入的
+ *                     窄化包装
+ *   - TxResult<T>     领域事务统一结果类型:{ ok:true, data } | { ok:false, error, status, extra? }
+ *                     所有领域模块(land / coop / economy / redpacket)都从此处引用,
+ *                     避免跨域循环依赖
+ *
+ * 用法:
+ *   const result = withTransaction(db, () => {
+ *     const rows = query(SQL`SELECT 1`);
+ *     return rows[0];
+ *   });
+ *
+ * 行为约定:
+ *   - return value       → COMMIT 后透传给调用方
+ *   - throw              → ROLLBACK 后重新抛错
+ *   - return Promise     → await 后再 COMMIT / ROLLBACK
+ */
+/**
+ * 在 IMMEDIATE 事务包裹下运行回调。回调内任何抛出都会触发 ROLLBACK 并重新抛错。
+ *
+ * 行为约定：
+ *   - return value       → COMMIT 后透传给调用方
+ *   - throw              → ROLLBACK 后重新抛错
+ *   - return Promise     → await 后再 COMMIT / ROLLBACK
+ */
+export function withTransaction(db, fn) {
+    db.exec("BEGIN IMMEDIATE");
+    try {
+        const out = fn();
+        if (out instanceof Promise) {
+            // 同步/异步混合：等待 Promise 后决定提交
+            return Promise.resolve(out).then((v) => {
+                db.exec("COMMIT");
+                return v;
+            }, (err) => {
+                try {
+                    db.exec("ROLLBACK");
+                }
+                catch {
+                    /* ignore secondary failures */
+                }
+                throw err;
+            });
+        }
+        db.exec("COMMIT");
+        return out;
+    }
+    catch (error) {
+        try {
+            db.exec("ROLLBACK");
+        }
+        catch {
+            /* ignore rollback failures */
+        }
+        throw error;
+    }
+}
+/**
+ * withTransaction 的结果封装版 —— 适合领域函数想表达“业务失败但不抛错”的场景。
+ *
+ * 用法:
+ *   const r = withResult(db, () => {
+ *     if (bad) return { ok: false, error: "x" };
+ *     return { ok: true, ... };
+ *   });
+ *   if (!r.ok) ...
+ *
+ * - 注意：仍由回调决定成功/失败；只在抛错时回滚。
+ */
+export function withResult(db, fn) {
+    return withTransaction(db, fn);
+}
+//# sourceMappingURL=transaction.js.map

package/dist/domain/transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.js","sourceRoot":"","sources":["../../src/domain/transaction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAcH;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,EAAiB,EACjB,EAAwB;IAExB,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,EAAE,CAAC;QACjB,IAAI,GAAG,YAAY,OAAO,EAAE,CAAC;YAC3B,2BAA2B;YAC3B,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAC9B,CAAC,CAAC,EAAE,EAAE;gBACJ,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAClB,OAAO,CAAC,CAAC;YACX,CAAC,EACD,CAAC,GAAG,EAAE,EAAE;gBACN,IAAI,CAAC;oBACH,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACtB,CAAC;gBAAC,MAAM,CAAC;oBACP,+BAA+B;gBACjC,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC,CACG,CAAC;QACT,CAAC;QACD,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClB,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC;YACH,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,8BAA8B;QAChC,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CACxB,EAAiB,EACjB,EAAwB;IAExB,OAAO,eAAe,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;AACjC,CAAC"}

package/dist/env.d.ts

@@ -0,0 +1,22 @@
+/**
+ * env.ts — 环境配置加载
+ */
+export interface EnvConfig {
+    PROJECT_ROOT: string;
+    PORT: number;
+    HOST: string;
+    DB_PATH: string;
+    AUTH_TOKEN: string;
+    LLBOT_HOST: string;
+    LLBOT_PORT: number;
+    LLBOT_TOKEN: string;
+    QQ_GROUP_ID: string;
+    QQ_BRIDGE_CHANNEL_ID: string;
+    MODULES_DIR: string;
+    MODULE_CATALOG_PATH: string;
+    MODULE_LOCK_PATH: string;
+    dbconfig: Record<string, unknown>;
+    qqconfig: Record<string, unknown>;
+}
+export declare function loadEnv(): EnvConfig;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA;;GAEG;AAyBH,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IAEnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IAEpB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,wBAAgB,OAAO,IAAI,SAAS,CA2FnC"}

package/dist/env.js

@@ -0,0 +1,94 @@
+/**
+ * env.ts — 环境配置加载
+ */
+import { ensureJsonConfig, modulePath, resolveRuntimeRoot } from "@sfmc-bds/sdk/node/config";
+import { isAbsolute, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { log } from "./lib/log.js";
+import { dirname } from "node:path";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const DEFAULT_DB_CONFIG = {
+    db_port: 3001,
+    dbDir: "data/sfmc_data.db",
+    modulesDir: "modules",
+};
+const DEFAULT_QQ_CONFIG = {
+    llbot_host: "127.0.0.1",
+    llbot_port: 3004,
+    llbot_token: "",
+};
+export function loadEnv() {
+    const PROJECT_ROOT = resolveRuntimeRoot(resolve(__dirname, "..", ".."));
+    /* 启动时确认 db/qq config 存在;不存在就写带默认值的骨架。
+     * 不依赖 wizard:wizard 只填字段,骨架由服务自己 ensure。 */
+    const dbconfig = ensureJsonConfig(PROJECT_ROOT, "db_config.json", DEFAULT_DB_CONFIG);
+    const qqconfig = ensureJsonConfig(PROJECT_ROOT, "qq_config.json", DEFAULT_QQ_CONFIG);
+    // ── 优先级:JSON > 系统环境变量 > 默认值 ───────────────────────
+    const envBaseline = { ...process.env };
+    // 元数据前缀:`_` 开头视为注释/说明(如 _comment / _comment_group),不写 env、不打日志
+    const isMeta = (k) => String(k).startsWith("_");
+    for (const [k, v] of Object.entries(dbconfig)) {
+        if (isMeta(k))
+            continue;
+        const envKey = k.replace(/([A-Z])/g, "_$1").toUpperCase();
+        process.env[envKey] = String(v);
+        log.info(`db_config::${k} -> process.env.${envKey} = ${String(v)}`);
+    }
+    for (const [k, v] of Object.entries(qqconfig)) {
+        if (isMeta(k))
+            continue;
+        const envKey = k.replace(/([A-Z])/g, "_$1").toUpperCase();
+        if (process.env[envKey] === undefined) {
+            process.env[envKey] = String(v);
+            log.info(`qq_config::${k} -> process.env.${envKey} = ${String(v)}`);
+        }
+    }
+    // 工具:JSON > envBaseline(原 process.env) > default
+    // 语义:JSON 里有这个键(非 undefined / null)就用 JSON;空串、0、false 都算"显式配置"
+    // 只有 JSON 完全没这个键(或者显式 null)才 fall through 到 env
+    function pick(jsonVal, envKey, fallback, source) {
+        if (jsonVal !== undefined && jsonVal !== null) {
+            return jsonVal;
+        }
+        const fromEnv = envBaseline[envKey];
+        if (fromEnv !== undefined && fromEnv !== "") {
+            log.info(`${source} 未在 JSON 中配置,使用系统环境变量 ${envKey} = ${fromEnv}`);
+            return fromEnv;
+        }
+        return fallback;
+    }
+    const PORT = parseInt(String(pick(dbconfig["db_port"], "DB_PORT", 3001, "db_port")), 10);
+    const HOST = "127.0.0.1";
+    const DB_PATH_RAW = String(pick(dbconfig["dbDir"], "DB_DIR", "data/sfmc_data.db", "dbDir"));
+    const DB_PATH = isAbsolute(DB_PATH_RAW) ? DB_PATH_RAW : resolve(PROJECT_ROOT, DB_PATH_RAW);
+    const LLBOT_HOST = String(pick(qqconfig["llbot_host"], "LLBOT_HOST", "127.0.0.1", "llbot_host"));
+    const LLBOT_PORT = parseInt(String(pick(qqconfig["llbot_port"], "LLBOT_PORT", 3004, "llbot_port")), 10);
+    const LLBOT_TOKEN = String(pick(qqconfig["llbot_token"], "LLBOT_TOKEN", "", "llbot_token"));
+    const QQ_GROUP_ID = String(pick(qqconfig["qq_group_id"], "QQ_GROUP_ID", "", "qq_group_id"));
+    const QQ_BRIDGE_CHANNEL_ID = String(pick(qqconfig["bridge_channel_id"], "BRIDGE_CHANNEL_ID", "", "bridge_channel_id"));
+    const AUTH_TOKEN = String(pick(dbconfig["http_auth"], "HTTP_AUTH", "", "http_auth"));
+    const MODULES_DIR = dbconfig["modulesDir"]
+        ? resolve(PROJECT_ROOT, String(dbconfig["modulesDir"]))
+        : join(PROJECT_ROOT, "modules");
+    const MODULE_CATALOG_PATH = modulePath(MODULES_DIR, "catalog.json");
+    const MODULE_LOCK_PATH = modulePath(MODULES_DIR, "module-lock.json");
+    return {
+        PROJECT_ROOT,
+        PORT,
+        HOST,
+        DB_PATH,
+        AUTH_TOKEN,
+        LLBOT_HOST,
+        LLBOT_PORT,
+        LLBOT_TOKEN,
+        QQ_GROUP_ID,
+        QQ_BRIDGE_CHANNEL_ID,
+        MODULES_DIR,
+        MODULE_CATALOG_PATH,
+        MODULE_LOCK_PATH,
+        dbconfig,
+        qqconfig,
+    };
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * index.ts — 入口(v2 启动顺序)
+ *
+ * 工作流:
+ *   1. 加载 env
+ *   2. 校验 Node 版本
+ *   3. openDatabase + createPlatformTables(sfmc__audit / sfmc__idempotent)
+ *   4. loadManifestV2() — 失败 = 启动失败
+ *   5. filterEnabled(loaded, lockFileEnabled)
+ *   6. buildModuleAuth({auth_token, enabled_modules})  ← data/module-tokens.json
+ *   7. 实例化:SchemaRegistry / ServiceRegistry / IdempotencyStore / TxRunner
+ *   8. 装配 v2 路由 (/api/sfmc/db/* + /api/sfmc/services* + /api/sfmc/configs/:key/*)
+ *      另保留 messages(qq-bridge) + config/modules/health 平台路由
+ *   9. createServer + listen
+ *
+ * 鉴权(handle 层):
+ *   - /api/sfmc/db/*, /api/sfmc/services*, /api/sfmc/configs/:key(/set|notify)*
+ *     → module token (Authorization: Bearer ...) + ?moduleId=...
+ *   - 其他:env.AUTH_TOKEN 旧 auth(NEEDS_AUTH)
+ */
+import { SchemaRegistry } from "./schema-registry.js";
+import { ServiceRegistry } from "./service-registry.js";
+import { TxRunner } from "./tx-runner.js";
+declare const env: import("./env.js").EnvConfig;
+declare const db: import("node:sqlite").DatabaseSync;
+declare const query: import("./lib/sqlite.js").QueryFn;
+declare const enabledManifests: Map<string, import("./manifest-loader.js").ModuleManifestV2>;
+declare const moduleAuth: import("./module-auth.js").ModuleAuthMap;
+declare const schemaRegistry: SchemaRegistry;
+declare const serviceRegistry: ServiceRegistry;
+declare const txRunner: TxRunner;
+export { db, env, query, schemaRegistry, serviceRegistry, txRunner, enabledManifests, moduleAuth };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAcH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAuB1C,QAAA,MAAM,GAAG,8BAAY,CAAC;AACtB,QAAA,MAAM,EAAE,oCAA4B,CAAC;AAGrC,QAAA,MAAM,KAAK,mCAAkB,CAAC;AA4B9B,QAAA,MAAM,gBAAgB,8DAAwE,CAAC;AAU/F,QAAA,MAAM,UAAU,0CAId,CAAC;AAGH,QAAA,MAAM,cAAc,gBAAyB,CAAC;AAC9C,QAAA,MAAM,eAAe,iBAAwB,CAAC;AAE9C,QAAA,MAAM,QAAQ,UAMZ,CAAC;AAyOH,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,313 @@
+/**
+ * index.ts — 入口(v2 启动顺序)
+ *
+ * 工作流:
+ *   1. 加载 env
+ *   2. 校验 Node 版本
+ *   3. openDatabase + createPlatformTables(sfmc__audit / sfmc__idempotent)
+ *   4. loadManifestV2() — 失败 = 启动失败
+ *   5. filterEnabled(loaded, lockFileEnabled)
+ *   6. buildModuleAuth({auth_token, enabled_modules})  ← data/module-tokens.json
+ *   7. 实例化:SchemaRegistry / ServiceRegistry / IdempotencyStore / TxRunner
+ *   8. 装配 v2 路由 (/api/sfmc/db/* + /api/sfmc/services* + /api/sfmc/configs/:key/*)
+ *      另保留 messages(qq-bridge) + config/modules/health 平台路由
+ *   9. createServer + listen
+ *
+ * 鉴权(handle 层):
+ *   - /api/sfmc/db/*, /api/sfmc/services*, /api/sfmc/configs/:key(/set|notify)*
+ *     → module token (Authorization: Bearer ...) + ?moduleId=...
+ *   - 其他:env.AUTH_TOKEN 旧 auth(NEEDS_AUTH)
+ */
+import http from "node:http";
+import { createIdempotencyStore } from "./lib/idempotency-store.js";
+import { loadEnv } from "./env.js";
+import { buildModuleAuth, verifyModuleAuth } from "./module-auth.js";
+import { loadManifestV2 } from "./manifest-loader.js";
+import { log } from "./lib/log.js";
+import { assertNodeVersion } from "./lib/runtime.js";
+import { createQuery, openDatabase } from "./lib/sqlite.js";
+import { createServer, startConsole } from "./server.js";
+import { createPlatformTables } from "./db-tables.js";
+import { initSchema } from "./domain/schema.js";
+import { SchemaRegistry } from "./schema-registry.js";
+import { ServiceRegistry } from "./service-registry.js";
+import { TxRunner } from "./tx-runner.js";
+import { registerEnabledBuiltinServices } from "./services/builtin-handlers.js";
+import { readJson, writeJson } from "@sfmc-bds/sdk/node/config";
+import { createModuleConfigRoutes } from "./routes/module-config-routes.js";
+import { createDbRoutes } from "./routes/db-routes.js";
+import { createServiceRoutes } from "./routes/service-routes.js";
+import { jsonV2Fail } from "./routes/_shared.js";
+import { createConfigRoutes } from "./routes/config.js";
+import { createHealthRoutes } from "./routes/health.js";
+import { createMessagesRoutes } from "./routes/messages.js";
+import { createModuleRoutes } from "./routes/modules.js";
+import { forwardToQQBridge, makeLLBotConfig } from "./domain/bridge.js";
+import { isEnabled, loadModuleLock, updateModuleState } from "./lib/module-state.js";
+import { body as sharedBody, json as sharedJson } from "./lib/http.js";
+if (!assertNodeVersion(22, 13)) {
+    process.exit(2);
+}
+const env = loadEnv();
+const db = openDatabase(env.DB_PATH);
+createPlatformTables(db); // sfmc__audit / sfmc__idempotent
+initSchema(db); // 平台业务 bootstrap 表(players/world/chat/...)——qq-bridge 在 SAPI defineTable 之前就需要
+const query = createQuery(db);
+// ── v2 manifest 加载(失败 = 启动失败)─────────────────────────
+const loadedManifest = loadManifestV2(); // throws on violation
+log.success(`[manifest v2] loaded ${Object.keys(loadedManifest.modules).length} modules; provides ${loadedManifest.providesMap.size} services`);
+// ── enabled 集合(从 lock file)─────────────────────────────
+const lockFile = loadModuleLock(env.MODULE_LOCK_PATH);
+const moduleCatalog = readJson(env.MODULE_CATALOG_PATH) ?? { modules: [] };
+const catalogIds = new Set(Array.isArray(moduleCatalog.modules)
+    ? moduleCatalog.modules
+        .map((m) => String(m.id || ""))
+        .filter((id) => id.length > 0)
+    : []);
+const enabledSet = new Set();
+for (const id of Object.keys(loadedManifest.modules)) {
+    if (!catalogIds.has(id))
+        continue;
+    const catalogEntry = moduleCatalog.modules.find((m) => String(m.id) === id);
+    if (!catalogEntry)
+        continue;
+    const defaultEnabled = catalogEntry.enabledByDefault !== false;
+    if (isEnabled(lockFile, id, defaultEnabled))
+        enabledSet.add(id);
+}
+const enabledManifests = new Map();
+for (const id of enabledSet) {
+    const m = loadedManifest.modules[id];
+    if (m)
+        enabledManifests.set(id, m);
+}
+log.info(`[manifest v2] enabled: ${[...enabledSet].sort().join(", ") || "(none)"}`);
+// ── 模块 HMAC token map(写到 data/module-tokens.json)────────
+const moduleAuth = buildModuleAuth({
+    projectRoot: env.PROJECT_ROOT,
+    envAuthToken: env.AUTH_TOKEN,
+    enabledModuleIds: [...enabledSet],
+});
+// ── 三件套 + 路由工厂 ─────────────────────────────────────
+const schemaRegistry = new SchemaRegistry(db);
+const serviceRegistry = new ServiceRegistry();
+const idempotent = createIdempotencyStore(db);
+const txRunner = new TxRunner({
+    db,
+    query,
+    schema: schemaRegistry,
+    serviceRegistry,
+    enabled: enabledManifests,
+});
+// ── 进程内置 service handler(扩展点:BUILTIN_SERVICE_PLUGINS) ──
+{
+    const plugins = registerEnabledBuiltinServices(serviceRegistry, { query, db }, enabledSet);
+    if (plugins > 0) {
+        log.success(`[service] registered ${serviceRegistry.list().length} handlers from ${plugins} builtin plugin(s)`);
+    }
+}
+const json = sharedJson;
+const body = sharedBody;
+// ── 工具函数 ──────────────────────────────────────────────
+function loadModuleCatalog() {
+    return Array.isArray(moduleCatalog.modules) ? moduleCatalog.modules : [];
+}
+function buildModuleList() {
+    const catalog = loadModuleCatalog();
+    return catalog
+        .map((raw) => {
+        const entry = raw.entry && typeof raw.entry === "object"
+            ? raw.entry
+            : {};
+        const id = String(raw.id || "").trim();
+        const configKey = String(raw.configKey || raw.config_key || "").trim();
+        if (!id || !configKey)
+            return null;
+        const state = lockFile.modules[id];
+        const enabled = isEnabled(lockFile, id, raw.enabledByDefault !== false);
+        return {
+            id,
+            module_id: id,
+            name: configKey,
+            config_key: configKey,
+            display_name: String(raw.name || configKey),
+            type: String(raw.type || "feature"),
+            description: String(raw.description || ""),
+            default_enabled: raw.enabledByDefault !== false,
+            can_disable: raw.canDisable !== false,
+            requires: Array.isArray(raw.requires)
+                ? raw.requires.filter(Boolean).map(String)
+                : [],
+            optional: Array.isArray(raw.optional)
+                ? raw.optional.filter(Boolean).map(String)
+                : [],
+            commands: Array.isArray(raw.commands)
+                ? raw.commands.filter(Boolean).map(String)
+                : [],
+            entry: {
+                kind: String(entry.kind || ""),
+                path: String(entry.path || ""),
+                init: String(entry.init || ""),
+            },
+            updated_at: state?.updatedAt ?? null,
+            enabled: !!enabled,
+        };
+    })
+        .filter(Boolean);
+}
+function resolveModuleByKey(key) {
+    const k = String(key || "").trim();
+    const catalog = loadModuleCatalog();
+    return catalog.find((m) => String(m.id || "") === k ||
+        String(m.configKey || m.config_key || "") === k);
+}
+function setModuleEnabled(mod, enabled) {
+    // 直接更新启动时缓存的 lockFile(而非另读一份新副本),
+    // 否则 buildModuleList() 读的仍是旧缓存,导致启停后 enabled 状态不翻转。
+    updateModuleState(lockFile, mod.id, { enabled: !!enabled });
+    writeJson(env.MODULE_LOCK_PATH, lockFile);
+}
+// ── 平台路由(非模块业务) ───────────────────────────────────
+const healthRoutes = createHealthRoutes();
+const messagesRoutes = createMessagesRoutes({
+    query,
+    body,
+    json,
+    forwardToQQBridge: (channelId, fromName, content, fromId) => forwardToQQBridge(makeLLBotConfig({
+        LLBOT_HOST: env.LLBOT_HOST,
+        LLBOT_PORT: env.LLBOT_PORT,
+        LLBOT_TOKEN: env.LLBOT_TOKEN,
+        QQ_GROUP_ID: env.QQ_GROUP_ID,
+    }), channelId, fromName, content, fromId),
+});
+const configRoutes = createConfigRoutes({ json, projectRoot: env.PROJECT_ROOT });
+const moduleRoutesInstance = createModuleRoutes({
+    loadModuleCatalog,
+    buildModuleList: buildModuleList,
+    resolveModuleByKey,
+    setModuleEnabled,
+    body,
+    json,
+});
+// ── v2 路由工厂 ───────────────────────────────────────────────
+// 类型断言成 unknown 函数 — v2 routes 的 ctx 类型与 RouteCtx 不兼容,
+// 但调用契约({path, method, params, req, res, body?})是稳定的。
+const dbRoutes = createDbRoutes({ schemaRegistry, txRunner, idempotent, json });
+const serviceRoutes = createServiceRoutes({
+    serviceRegistry,
+    enabled: enabledManifests,
+    json,
+});
+const moduleConfigRoutes = createModuleConfigRoutes({
+    projectRoot: env.PROJECT_ROOT,
+    enabled: enabledManifests,
+    json,
+});
+// ── 主请求处理器 ────────────────────────────────────────────
+async function handle(req, res) {
+    const url = new URL(req.url || "/", `http://${req.headers.host || "localhost"}`);
+    const path = url.pathname;
+    const method = req.method || "GET";
+    const params = url.searchParams;
+    // loopback 绑定
+    const remote = req.socket.remoteAddress || "";
+    if (remote && !remote.startsWith("127.") && remote !== "::1" && remote !== "::ffff:127.") {
+        json(res, { success: false, error: "forbidden" }, 403);
+        return;
+    }
+    // ── 预读 body(所有路由共享) ───────────────────────────────
+    await body(req);
+    // ── v2 模块身份校验 → 写入路由 ctx.moduleAuth(LoD:不挂 req 私有字段) ──
+    // 注意:`/api/sfmc/configs/all` 是旧的一次性配置快照端点(SAPI ConfigManager.init
+    // 启动必用),不属于 v2 模块配置命名空间(configs/<模块 configKey>),必须豁免,
+    // 否则会被模块鉴权网关拦成 401,导致插件端起不来。
+    const isLegacyConfigAll = path === "/api/sfmc/configs/all";
+    const needsModuleAuth = path.startsWith("/api/sfmc/db/") ||
+        path.startsWith("/api/sfmc/services") ||
+        (/^\/api\/sfmc\/configs\/[A-Za-z0-9_-]+(?:\/(?:set|notify))?$/.test(path) && !isLegacyConfigAll);
+    let moduleAuthCtx = null;
+    if (needsModuleAuth) {
+        const id = verifyModuleAuth({
+            headers: req.headers,
+            params,
+            auth: moduleAuth,
+            enabledModuleIds: enabledSet,
+        });
+        if (!id) {
+            // LSP: v2 模块门与 service-routes 同用 ok 方言
+            jsonV2Fail(res, "unauthorized: module identity invalid", 401, "unauthorized");
+            return;
+        }
+        const manifest = enabledManifests.get(id);
+        moduleAuthCtx = {
+            id,
+            permissions: manifest?.permissions ?? [],
+        };
+    }
+    else {
+        // ── 旧 env token 鉴权(只对 POST/PUT 生效) ─────────────
+        const PUBLIC_GET = path === "/api/health" ||
+            (method === "GET" &&
+                (path === "/api/sfmc/modules" || path === "/api/sfmc/modules/catalog" || path.startsWith("/api/sfmc/modules/")));
+        const NEEDS_AUTH = !PUBLIC_GET && method !== "GET";
+        if (env.AUTH_TOKEN && NEEDS_AUTH) {
+            const auth = req.headers["authorization"] || "";
+            const provided = auth.startsWith("Bearer ") ? auth.slice(7) : req.headers["x-db-token"] || "";
+            if (provided !== env.AUTH_TOKEN) {
+                json(res, { success: false, error: "unauthorized" }, 401);
+                return;
+            }
+        }
+    }
+    try {
+        // ── v2 路由(优先匹配) ─────────────────────────────
+        if (moduleAuthCtx && (path.startsWith("/api/sfmc/db/") || path.startsWith("/api/sfmc/services") || (/^\/api\/sfmc\/configs\/[A-Za-z0-9_-]+/.test(path) && !isLegacyConfigAll))) {
+            const ctx = {
+                path,
+                method,
+                params,
+                req,
+                res,
+                moduleAuth: moduleAuthCtx,
+            };
+            // body 已在上面 `await body(req)` 预读并缓存到 req._bodyPromise;
+            // 这里复用缓存(原实现读的 req._body 从未被赋值,导致所有 v2 路由 body 恒为空)。
+            ctx["body"] = await body(req);
+            if (path.startsWith("/api/sfmc/db/")) {
+                if (await dbRoutes(ctx))
+                    return;
+            }
+            else if (path.startsWith("/api/sfmc/services")) {
+                if (await serviceRoutes(ctx))
+                    return;
+            }
+            else {
+                if (await moduleConfigRoutes(ctx))
+                    return;
+            }
+        }
+        // ── 平台路由 ────────────────────────────────────
+        const ctxBase = { path, method, params, req, res };
+        if (await moduleRoutesInstance(ctxBase))
+            return;
+        if (await healthRoutes(ctxBase))
+            return;
+        if (await messagesRoutes(ctxBase))
+            return;
+        if (await configRoutes(ctxBase))
+            return;
+        json(res, { success: false, error: "not_found" }, 404);
+    }
+    catch (err) {
+        log.err(err, "DogeDB");
+        json(res, { success: false, error: err.message }, 500);
+    }
+}
+// ── 启动 ────────────────────────────────────────────────────
+const server = createServer({
+    env: { PORT: env.PORT, HOST: env.HOST, AUTH_TOKEN: env.AUTH_TOKEN },
+    handle,
+});
+startConsole(server, db);
+export { db, env, query, schemaRegistry, serviceRegistry, txRunner, enabledManifests, moduleAuth };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lib/http.d.ts

@@ -0,0 +1,18 @@
+/**
+ * lib/http.ts — HTTP 工具（JSON 响应 + body 解析）
+ *
+ * 所有 db-server 路由统一走这里的 json / body / parseBody。
+ * 路由上下文 ({ path, method, params, req, res }) 在 routes/_shared.ts 定义。
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+export type Method = "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+/** 写 JSON 响应并结束。 */
+export declare function json(res: ServerResponse, data: Record<string, unknown>, status?: number): void;
+/** 解析请求 body 字符串为对象（解析失败返回空对象）。 */
+export declare function parseBody(raw: string): Record<string, unknown>;
+/**
+ * 异步读取请求 body，结果会缓存到 req._bodyPromise 上以避免重复读取。
+ * Buffer 累积 + 异步拼接，正确处理 binary 字节流。
+ */
+export declare function body(req: IncomingMessage): Promise<Record<string, unknown>>;
+//# sourceMappingURL=http.d.ts.map

package/dist/lib/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/lib/http.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,MAAM,MAAM,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEjE,oBAAoB;AACpB,wBAAgB,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAE,MAAY,GAAG,IAAI,CAGnG;AAED,mCAAmC;AACnC,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAM9D;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAgB3E"}