@sfmc-bds/db-server 0.1.0

package/dist/permission-gate.d.ts

@@ -0,0 +1,53 @@
+/**
+ * permission-gate.ts — 模块权限校验
+ *
+ * 启动期:manifest.permissions 全在白名单(PERMISSION_KEYS),否则抛错启动失败。
+ *          (白名单 = db:read:*, db:write:*, config:read:*, config:write:*,
+ *           service:* + 通配 ** / <table>)
+ *
+ * 运行时:发起 db / config / service 调用时,gatesdb.<op>.requirePermission =
+ *   "db:read:<table>" / "db:write:<table>" / "config:read:<key>" /
+ *   "config:write:<key>" / "service:<name>"
+ *
+ * 设计:gate 不替路由拦截,是业务逻辑自己检查(避免每条路由都验)。
+ *      路由层 fail-closed:不通过 manifest.permissions 表的调用 = 直接 403。
+ */
+export type PermissionKey = string;
+export type PermissionLevel = "Any" | "Member" | "OP" | "Admin";
+export interface ManifestPermissionRule {
+    /** 模块声明的权限全集 */
+    permissions: PermissionKey[];
+    /** 跨模块调用对应是否需要显式声明 */
+    serviceRequires: string[];
+}
+/**
+ * 启动期一次性校验:manifest.permissions 是否都合规。
+ * 失败 = 抛错(启动失败)。
+ */
+export declare function validateManifestPermissions(moduleId: string, permissions: readonly string[]): void;
+/**
+ * 运行时:模块 id 是否拥有所需 permission。
+ * 当前实现:必须精确等于才放行,不解释通配。
+ * (PoC 简化;生产可加 db:read:* → 通配)
+ */
+export declare function moduleHasPermission(modulePermissions: readonly string[] | undefined, required: string): boolean;
+export declare function assertModulePermission(moduleId: string, modulePermissions: readonly string[] | undefined, required: string): void;
+export declare class PermissionDeniedError extends Error {
+    moduleId: string;
+    permission: string;
+    code: string;
+    status: number;
+    constructor(moduleId: string, permission: string);
+}
+/**
+ * 所有 platform 派发的 required permission key 计算助手。
+ */
+export declare const Perm: {
+    readonly dbRead: (table: string) => string;
+    readonly dbWrite: (table: string) => string;
+    readonly configRead: (key: string) => string;
+    readonly configWrite: (key: string) => string;
+    readonly service: (name: string) => string;
+};
+export declare const PlatformTablePermissions: Set<string>;
+//# sourceMappingURL=permission-gate.d.ts.map

package/dist/permission-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission-gate.d.ts","sourceRoot":"","sources":["../src/permission-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;AACnC,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC;AAEhE,MAAM,WAAW,sBAAsB;IACrC,gBAAgB;IAChB,WAAW,EAAE,aAAa,EAAE,CAAC;IAC7B,sBAAsB;IACtB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAoBD;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,IAAI,CAQN;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,iBAAiB,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAChD,QAAQ,EAAE,MAAM,GACf,OAAO,CAUT;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAChD,QAAQ,EAAE,MAAM,GACf,IAAI,CAIN;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAG3B,QAAQ,EAAE,MAAM;IAAS,UAAU,EAAE,MAAM;IAF9D,IAAI,SAAuB;IAC3B,MAAM,SAAO;gBACM,QAAQ,EAAE,MAAM,EAAS,UAAU,EAAE,MAAM;CAG/D;AAED;;GAEG;AACH,eAAO,MAAM,IAAI;6BACC,MAAM;8BACL,MAAM;+BACL,MAAM;gCACL,MAAM;6BACT,MAAM;CACd,CAAC;AAEX,eAAO,MAAM,wBAAwB,aAAkB,CAAC"}

package/dist/permission-gate.js

@@ -0,0 +1,94 @@
+/**
+ * permission-gate.ts — 模块权限校验
+ *
+ * 启动期:manifest.permissions 全在白名单(PERMISSION_KEYS),否则抛错启动失败。
+ *          (白名单 = db:read:*, db:write:*, config:read:*, config:write:*,
+ *           service:* + 通配 ** / <table>)
+ *
+ * 运行时:发起 db / config / service 调用时,gatesdb.<op>.requirePermission =
+ *   "db:read:<table>" / "db:write:<table>" / "config:read:<key>" /
+ *   "config:write:<key>" / "service:<name>"
+ *
+ * 设计:gate 不替路由拦截,是业务逻辑自己检查(避免每条路由都验)。
+ *      路由层 fail-closed:不通过 manifest.permissions 表的调用 = 直接 403。
+ */
+const PERMISSION_KEYS = new Set([
+    // db:* 走模式匹配 db:read:* / db:write:*
+    // 配置权限
+    "config:read:*",
+    "config:write:*",
+    // service 在调用时按 service 名字匹配 service:* 通配
+]);
+function validPermissionKey(k) {
+    // 三类合法格式:
+    //   db:<op>:<table>      (例 db:read:lands / db:write:land_members)
+    //   config:<op>:<key>    (例 config:read:land / config:write:afk)
+    //   service:<name>       (例 service:economy.debit / service:land.byId — 名字可含 .)
+    // 不允许 raw "*"(要求明确对象) — 调试时一律 Resource-level
+    if (/^service:[A-Za-z0-9_.]+$/.test(k))
+        return true;
+    return /^[a-z]+:[a-z]+:[A-Za-z0-9_.]+$/.test(k);
+}
+/**
+ * 启动期一次性校验:manifest.permissions 是否都合规。
+ * 失败 = 抛错(启动失败)。
+ */
+export function validateManifestPermissions(moduleId, permissions) {
+    const seen = new Set();
+    for (const k of permissions) {
+        if (!k || typeof k !== "string")
+            throw new Error(`[perm] ${moduleId}: permission 不是字符串 "${k}"`);
+        if (!validPermissionKey(k))
+            throw new Error(`[perm] ${moduleId}: permission 格式不合法 "${k}"`);
+        if (seen.has(k))
+            throw new Error(`[perm] ${moduleId}: permission 重复 "${k}"`);
+        seen.add(k);
+    }
+}
+/**
+ * 运行时:模块 id 是否拥有所需 permission。
+ * 当前实现:必须精确等于才放行,不解释通配。
+ * (PoC 简化;生产可加 db:read:* → 通配)
+ */
+export function moduleHasPermission(modulePermissions, required) {
+    if (!modulePermissions)
+        return false;
+    if (modulePermissions.includes(required))
+        return true;
+    // db:read:* / db:write:* / config:read:* / config:write:* 通配
+    const parts = required.split(":");
+    if (parts.length === 3) {
+        const wildcard = `${parts[0]}:${parts[1]}:*`;
+        if (modulePermissions.includes(wildcard))
+            return true;
+    }
+    return false;
+}
+export function assertModulePermission(moduleId, modulePermissions, required) {
+    if (!moduleHasPermission(modulePermissions, required)) {
+        throw new PermissionDeniedError(moduleId, required);
+    }
+}
+export class PermissionDeniedError extends Error {
+    moduleId;
+    permission;
+    code = "permission_denied";
+    status = 403;
+    constructor(moduleId, permission) {
+        super(`[perm] 模块 ${moduleId} 缺少权限 "${permission}"`);
+        this.moduleId = moduleId;
+        this.permission = permission;
+    }
+}
+/**
+ * 所有 platform 派发的 required permission key 计算助手。
+ */
+export const Perm = {
+    dbRead: (table) => `db:read:${table}`,
+    dbWrite: (table) => `db:write:${table}`,
+    configRead: (key) => `config:read:${key}`,
+    configWrite: (key) => `config:write:${key}`,
+    service: (name) => `service:${name}`,
+};
+export const PlatformTablePermissions = PERMISSION_KEYS;
+//# sourceMappingURL=permission-gate.js.map

package/dist/permission-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission-gate.js","sourceRoot":"","sources":["../src/permission-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAYH,MAAM,eAAe,GAAG,IAAI,GAAG,CAAS;IACtC,oCAAoC;IACpC,OAAO;IACP,eAAe;IACf,gBAAgB;IAChB,0CAA0C;CAC3C,CAAC,CAAC;AAEH,SAAS,kBAAkB,CAAC,CAAS;IACnC,UAAU;IACV,mEAAmE;IACnE,iEAAiE;IACjE,gFAAgF;IAChF,6CAA6C;IAC7C,IAAI,0BAA0B,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpD,OAAO,gCAAgC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,QAAgB,EAChB,WAA8B;IAE9B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,UAAU,QAAQ,uBAAuB,CAAC,GAAG,CAAC,CAAC;QAChG,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,UAAU,QAAQ,uBAAuB,CAAC,GAAG,CAAC,CAAC;QAC3F,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,UAAU,QAAQ,oBAAoB,CAAC,GAAG,CAAC,CAAC;QAC7E,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,iBAAgD,EAChD,QAAgB;IAEhB,IAAI,CAAC,iBAAiB;QAAE,OAAO,KAAK,CAAC;IACrC,IAAI,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,6DAA6D;IAC7D,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7C,IAAI,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;IACxD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,QAAgB,EAChB,iBAAgD,EAChD,QAAgB;IAEhB,IAAI,CAAC,mBAAmB,CAAC,iBAAiB,EAAE,QAAQ,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAG3B;IAAyB;IAF5C,IAAI,GAAG,mBAAmB,CAAC;IAC3B,MAAM,GAAG,GAAG,CAAC;IACb,YAAmB,QAAgB,EAAS,UAAkB;QAC5D,KAAK,CAAC,aAAa,QAAQ,UAAU,UAAU,GAAG,CAAC,CAAC;QADnC,aAAQ,GAAR,QAAQ,CAAQ;QAAS,eAAU,GAAV,UAAU,CAAQ;IAE9D,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,WAAW,KAAK,EAAE;IAC7C,OAAO,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,YAAY,KAAK,EAAE;IAC/C,UAAU,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,eAAe,GAAG,EAAE;IACjD,WAAW,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,gBAAgB,GAAG,EAAE;IACnD,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,WAAW,IAAI,EAAE;CACpC,CAAC;AAEX,MAAM,CAAC,MAAM,wBAAwB,GAAG,eAAe,CAAC"}

package/dist/routes/_shared.d.ts

@@ -0,0 +1,68 @@
+/**
+ * routes/_shared.ts — 路由模块共享类型 + 工厂
+ *
+ * 所有 db-server 路由统一:
+ *   - deps:  { query, db, body, json, ... }      ← 共享注入
+ *   - ctx:   { path, method, params, req, res } ← 共享请求上下文
+ *   - return: boolean                            ← true 表示已处理
+ *
+ * http 工具 (json / body) 来自 lib/http.ts
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { DatabaseSync } from "node:sqlite";
+import type { Method } from "../lib/http.js";
+import { body as sharedBody, json as sharedJson } from "../lib/http.js";
+import type { QueryFn } from "../lib/sqlite.js";
+export type { Method } from "../lib/http.js";
+export type { QueryFn };
+/** shared deps factory — 路由可声明最小化 deps 子集 */
+export type RouteDeps = {
+    query: QueryFn;
+    db: DatabaseSync;
+    json: (res: ServerResponse, data: Record<string, unknown>, status?: number) => void;
+    body: (req: IncomingMessage) => Promise<Record<string, unknown>>;
+    params: URLSearchParams;
+    projectRoot: string;
+    monitorState?: {
+        metrics: object | null;
+        players: object[];
+    };
+    ensureEconomyAccount?: (playerId: string, playerName: string) => {
+        balance: number;
+        player_id: string;
+        version: number;
+    };
+    economyResult?: (account: object | undefined) => {
+        balance: number;
+        version: number;
+    } | null;
+    forwardToQQBridge?: (channelId: string, fromName: string, content: string, fromId: string) => void;
+    land?: Record<string, (...args: unknown[]) => unknown>;
+};
+/** v2 模块身份 — 由 handle 校验后写入路由 ctx(勿挂 req 私有字段,LoD)。 */
+export type ModuleAuth = {
+    id: string;
+    permissions: string[];
+};
+export type RouteCtx = {
+    path: string;
+    method: Method | string;
+    params: URLSearchParams;
+    req: IncomingMessage;
+    res: ServerResponse;
+    /** v2 路由专用:模块鉴权结果 */
+    moduleAuth?: ModuleAuth;
+};
+export type RouteHandler = (ctx: RouteCtx) => Promise<boolean> | boolean;
+export type RouteFactory = (deps: Partial<RouteDeps>) => RouteHandler;
+/** 便捷 re-export：路由默认从这里取 json/body */
+export declare const json: typeof sharedJson;
+export declare const body: typeof sharedBody;
+/**
+ * v2 失败信封权威形态(DRY + LSP):
+ * 一律 `{ ok:false, error, code? }`,勿再混用 `{ success:false }`。
+ * service-routes / db / module-config / index 模块鉴权门应走此助手。
+ */
+export declare function jsonV2Fail(res: ServerResponse, error: string, status: number, code?: string): void;
+export {};
+//# sourceMappingURL=_shared.d.ts.map

package/dist/routes/_shared.d.ts.map

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

package/dist/routes/_shared.js

@@ -0,0 +1,27 @@
+/**
+ * routes/_shared.ts — 路由模块共享类型 + 工厂
+ *
+ * 所有 db-server 路由统一:
+ *   - deps:  { query, db, body, json, ... }      ← 共享注入
+ *   - ctx:   { path, method, params, req, res } ← 共享请求上下文
+ *   - return: boolean                            ← true 表示已处理
+ *
+ * http 工具 (json / body) 来自 lib/http.ts
+ */
+import { body as sharedBody, json as sharedJson } from "../lib/http.js";
+/** 便捷 re-export：路由默认从这里取 json/body */
+export const json = sharedJson;
+export const body = sharedBody;
+/**
+ * v2 失败信封权威形态(DRY + LSP):
+ * 一律 `{ ok:false, error, code? }`,勿再混用 `{ success:false }`。
+ * service-routes / db / module-config / index 模块鉴权门应走此助手。
+ */
+export function jsonV2Fail(res, error, status, code) {
+    const payload = { ok: false, error };
+    if (code)
+        payload.code = code;
+    sharedJson(res, payload, status);
+}
+export {};
+//# sourceMappingURL=_shared.js.map

package/dist/routes/_shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.js","sourceRoot":"","sources":["../../src/routes/_shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,IAAI,IAAI,UAAU,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAyCxE,sCAAsC;AACtC,MAAM,CAAC,MAAM,IAAI,GAAG,UAAU,CAAC;AAC/B,MAAM,CAAC,MAAM,IAAI,GAAG,UAAU,CAAC;AAE/B;;;;GAIG;AACH,MAAM,UAAU,UAAU,CACxB,GAAmB,EACnB,KAAa,EACb,MAAc,EACd,IAAa;IAEb,MAAM,OAAO,GAA4B,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC9D,IAAI,IAAI;QAAE,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAC9B,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AACnC,CAAC;AAED,OAAO,EAAE,CAAC"}

package/dist/routes/config.d.ts

@@ -0,0 +1,27 @@
+/**
+ * routes/config.ts — 配置路由（直接读取 configs/*.json）
+ *
+ * 路由列表：
+ *   GET /api/sfmc/configs/all          — SAPI 启动时一次性拉取所有配置
+ *   GET /api/sfmc/settings             — 平铺 settings.json
+ *   GET /api/sfmc/settings/:key        — 含 land:* / bridge_channel_id 等 fallback 查询
+ *   GET /api/sfmc/areas                — areas.json
+ *   GET /api/sfmc/permissions          — permissions.json
+ *   GET /api/sfmc/banned_items         — banned_items.json
+ *   GET /api/sfmc/clean                — clean.json
+ *   GET /api/sfmc/grids                — grids.json
+ *   GET /api/sfmc/peace_filters        — peace_filters.json
+ *   GET /api/sfmc/qa                   — questions.json
+ */
+interface Deps {
+    json: (res: import("http").ServerResponse, data: Record<string, unknown>, status?: number) => void;
+    projectRoot: string;
+}
+declare function createConfigRoutes({ json, projectRoot }: Deps): ({ path: requestPath, method, params, res, }: {
+    path: string;
+    method: string;
+    params: URLSearchParams;
+    res: import("http").ServerResponse;
+}) => Promise<boolean>;
+export { createConfigRoutes };
+//# sourceMappingURL=config.d.ts.map

package/dist/routes/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/routes/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,UAAU,IAAI;IACZ,IAAI,EAAE,CAAC,GAAG,EAAE,OAAO,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACnG,WAAW,EAAE,MAAM,CAAC;CACrB;AAmCD,iBAAS,kBAAkB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,IAAI,IAgIb,6CAKrC;IACD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,eAAe,CAAC;IACxB,GAAG,EAAE,OAAO,MAAM,EAAE,cAAc,CAAC;CACpC,KAAG,OAAO,CAAC,OAAO,CAAC,CAuErB;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/routes/config.js

@@ -0,0 +1,236 @@
+/**
+ * routes/config.ts — 配置路由（直接读取 configs/*.json）
+ *
+ * 路由列表：
+ *   GET /api/sfmc/configs/all          — SAPI 启动时一次性拉取所有配置
+ *   GET /api/sfmc/settings             — 平铺 settings.json
+ *   GET /api/sfmc/settings/:key        — 含 land:* / bridge_channel_id 等 fallback 查询
+ *   GET /api/sfmc/areas                — areas.json
+ *   GET /api/sfmc/permissions          — permissions.json
+ *   GET /api/sfmc/banned_items         — banned_items.json
+ *   GET /api/sfmc/clean                — clean.json
+ *   GET /api/sfmc/grids                — grids.json
+ *   GET /api/sfmc/peace_filters        — peace_filters.json
+ *   GET /api/sfmc/qa                   — questions.json
+ */
+import { configPath, readJson } from "@sfmc-bds/sdk/node/config";
+function isMetaKey(k) {
+    return String(k).startsWith("_comment") || k === "_comment";
+}
+function stripMetaDeep(v) {
+    if (Array.isArray(v))
+        return v.map(stripMetaDeep);
+    if (v && typeof v === "object") {
+        const out = {};
+        for (const [k, val] of Object.entries(v)) {
+            if (!isMetaKey(k))
+                out[k] = stripMetaDeep(val);
+        }
+        return out;
+    }
+    return v;
+}
+function stripMeta(obj) {
+    if (!obj || typeof obj !== "object" || Array.isArray(obj))
+        return {};
+    const out = {};
+    for (const [k, v] of Object.entries(obj)) {
+        if (!isMetaKey(k))
+            out[k] = v;
+    }
+    return out;
+}
+function jsonValue(v) {
+    return v !== null && typeof v === "object" ? JSON.stringify(v) : String(v ?? "");
+}
+function arrayOrEmpty(v) {
+    return Array.isArray(v) ? v : [];
+}
+function createConfigRoutes({ json, projectRoot }) {
+    /** 仓顶服务 config 读取统一走 SDK;闭包捕获 projectRoot。 */
+    const readCfg = (name) => readJson(configPath(projectRoot, name));
+    function getAllConfigs() {
+        return {
+            modules: [],
+            settings: stripMeta(readJson(configPath(projectRoot, "settings.json"))),
+            areas: arrayOrEmpty(readJson(configPath(projectRoot, "areas.json")))
+                .filter((r) => r && r.module && r.dimension != null)
+                .map((r) => stripMetaDeep(r)),
+            permissions: arrayOrEmpty(readJson(configPath(projectRoot, "permissions.json")))
+                .filter((r) => r && r.player_name)
+                .map((r) => stripMetaDeep(r)),
+            banned_items: arrayOrEmpty(readJson(configPath(projectRoot, "banned_items.json")))
+                .filter((i) => typeof i === "string" && i && !i.startsWith("_"))
+                .map((id) => ({ item_id: id })),
+            clean: stripMetaDeep(readJson(configPath(projectRoot, "clean.json")) ?? {}),
+            grids: arrayOrEmpty(readJson(configPath(projectRoot, "grids.json")))
+                .filter((r) => r && r.name)
+                .map((r) => stripMetaDeep(r)),
+            peace_filters: arrayOrEmpty(readJson(configPath(projectRoot, "peace_filters.json")))
+                .filter((r) => r && r.family)
+                .map((r) => stripMetaDeep(r)),
+            questions: arrayOrEmpty(readJson(configPath(projectRoot, "questions.json")))
+                .filter((r) => r && r.question)
+                .map((r, idx) => {
+                const clean = stripMetaDeep(r);
+                return {
+                    id: idx + 1,
+                    weight: clean.weight ?? 1,
+                    question: clean.question,
+                    answers: clean.answers ?? [],
+                    msg_right: clean.msg_right ?? "",
+                    msg_wrong: clean.msg_wrong ?? "",
+                    explanation: clean.explanation ?? "",
+                    min_rank: clean.min_rank ?? null,
+                    max_rank: clean.max_rank ?? null,
+                    rewards: clean.rewards ?? [],
+                    punishments: clean.punishments ?? [],
+                };
+            }),
+        };
+    }
+    function getSettingsFlat() {
+        const obj = stripMeta(readJson(configPath(projectRoot, "settings.json")));
+        return Object.entries(obj).map(([key, value]) => ({ key, value: jsonValue(value) }));
+    }
+    function getSettingByKey(key) {
+        const settings = readJson(configPath(projectRoot, "settings.json")) ?? {};
+        if (Object.prototype.hasOwnProperty.call(settings, key) && !isMetaKey(key)) {
+            return { value: settings[key], source: "settings.json" };
+        }
+        if (key === "bridge_channel_id") {
+            const qq = readCfg("qq_config.json") ?? {};
+            if (qq.bridge_channel_id)
+                return { value: qq.bridge_channel_id, source: "qq_config.json" };
+        }
+        if (key.startsWith("land:")) {
+            const land = readCfg("land.json") ?? {};
+            if (Object.prototype.hasOwnProperty.call(land, key) && !isMetaKey(key)) {
+                return { value: land[key], source: "land.json" };
+            }
+        }
+        return { value: null };
+    }
+    function getAreas() {
+        return arrayOrEmpty(readCfg("areas.json"))
+            .filter((r) => r && r.module && r.dimension != null)
+            .map((r) => stripMetaDeep(r));
+    }
+    function getPermissions() {
+        return arrayOrEmpty(readCfg("permissions.json"))
+            .filter((r) => r && r.player_name)
+            .map((r) => stripMetaDeep(r));
+    }
+    function getBannedItems() {
+        return arrayOrEmpty(readCfg("banned_items.json"))
+            .filter((i) => typeof i === "string" && i && !i.startsWith("_"))
+            .map((id) => ({ item_id: id }));
+    }
+    function getClean() {
+        const c = stripMetaDeep(readCfg("clean.json") ?? {});
+        return { item_max: c.item_max ?? 192, poll_interval: c.poll_interval ?? 60 };
+    }
+    function getGrids() {
+        return arrayOrEmpty(readCfg("grids.json"))
+            .filter((r) => r && r.name)
+            .map((r) => stripMetaDeep(r));
+    }
+    function getPeaceFilters() {
+        return arrayOrEmpty(readCfg("peace_filters.json"))
+            .filter((r) => r && r.family)
+            .map((r) => stripMetaDeep(r));
+    }
+    function getQA() {
+        return arrayOrEmpty(readCfg("questions.json"))
+            .filter((r) => r && r.question)
+            .map((r, idx) => {
+            const clean = stripMetaDeep(r);
+            return {
+                id: idx + 1,
+                weight: clean.weight ?? 1,
+                question: clean.question,
+                answers: clean.answers ?? [],
+                msg_right: clean.msg_right ?? "",
+                msg_wrong: clean.msg_wrong ?? "",
+                explanation: clean.explanation ?? "",
+                min_rank: clean.min_rank ?? null,
+                max_rank: clean.max_rank ?? null,
+                rewards: clean.rewards ?? [],
+                punishments: clean.punishments ?? [],
+            };
+        });
+    }
+    return async function handleConfigRoute({ path: requestPath, method, params, res, }) {
+        void params;
+        if (requestPath === "/api/sfmc/configs/all") {
+            if (method !== "GET") {
+                json(res, { success: false, error: "not_found" }, 404);
+                return true;
+            }
+            json(res, getAllConfigs());
+            return true;
+        }
+        if (requestPath === "/api/sfmc/settings") {
+            if (method === "GET") {
+                json(res, { settings: getSettingsFlat() });
+                return true;
+            }
+            json(res, { success: false, error: "not_found" }, 404);
+            return true;
+        }
+        if (requestPath.startsWith("/api/sfmc/settings/")) {
+            const key = decodeURIComponent(requestPath.slice("/api/sfmc/settings/".length));
+            if (method === "GET") {
+                json(res, getSettingByKey(key));
+                return true;
+            }
+            json(res, { success: false, error: "method_not_allowed" }, 405);
+            return true;
+        }
+        if (requestPath === "/api/sfmc/areas") {
+            if (method === "GET") {
+                json(res, { areas: getAreas() });
+                return true;
+            }
+        }
+        if (requestPath === "/api/sfmc/permissions") {
+            if (method === "GET") {
+                json(res, { permissions: getPermissions() });
+                return true;
+            }
+        }
+        if (requestPath === "/api/sfmc/banned_items") {
+            if (method === "GET") {
+                json(res, { items: getBannedItems().map((x) => x.item_id) });
+                return true;
+            }
+        }
+        if (requestPath === "/api/sfmc/clean") {
+            if (method === "GET") {
+                json(res, { clean: getClean() });
+                return true;
+            }
+        }
+        if (requestPath === "/api/sfmc/grids") {
+            if (method === "GET") {
+                json(res, { grids: getGrids() });
+                return true;
+            }
+        }
+        if (requestPath === "/api/sfmc/peace_filters") {
+            if (method === "GET") {
+                json(res, { filters: getPeaceFilters() });
+                return true;
+            }
+        }
+        if (requestPath === "/api/sfmc/qa") {
+            if (method === "GET") {
+                json(res, { questions: getQA() });
+                return true;
+            }
+        }
+        return false;
+    };
+}
+export { createConfigRoutes };
+//# sourceMappingURL=config.js.map

package/dist/routes/config.js.map

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

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

@@ -0,0 +1,38 @@
+/**
+ * routes/db-routes.ts — /api/sfmc/db/* 处理器
+ *
+ * 端点:
+ *   POST /api/sfmc/db/define-table      body {name, columns, softDelete?} → {table, created}
+ *   POST /api/sfmc/db/tx                body {steps[]}                   → TxResponse | TxError
+ *   POST /api/sfmc/db/query             body {table, opts?}              → {rows}
+ *   POST /api/sfmc/db/get               body {table, id}                 → {row}
+ *   POST /api/sfmc/db/insert            body {table, row}                → {row}
+ *   POST /api/sfmc/db/update            body {table, id, patch}          → {row}
+ *   POST /api/sfmc/db/delete            body {table, id, hard?}          → {changes}
+ *   POST /api/sfmc/db/audit             body {table, rowId, action, data?} → {ok}
+ *   POST /api/sfmc/db/idempotent/probe  body {action, key}               → {replayed, cached?}
+ *   POST /api/sfmc/db/idempotent/commit body {action, key, value?}       → {ok}
+ *
+ * 鉴权:handle() 校验后把 {id, permissions} 写到 ctx.moduleAuth(不挂 req)。
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+import { json as defaultJson, type Method } from "../lib/http.js";
+import { type ModuleAuth } from "./_shared.js";
+import type { SchemaRegistry } from "../schema-registry.js";
+import type { TxRunner } from "../tx-runner.js";
+import type { IdempotencyStore } from "../lib/idempotency-store.js";
+export interface DbRoutesDeps {
+    schemaRegistry: SchemaRegistry;
+    txRunner: TxRunner;
+    idempotent: IdempotencyStore;
+    json?: typeof defaultJson;
+}
+export declare function createDbRoutes(depsIn: Partial<DbRoutesDeps>): (ctx: {
+    path: string;
+    method: Method | string;
+    req: IncomingMessage;
+    res: ServerResponse;
+    body?: Promise<Record<string, unknown>> | Record<string, unknown>;
+    moduleAuth?: ModuleAuth;
+}) => Promise<boolean>;
+//# sourceMappingURL=db-routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"db-routes.d.ts","sourceRoot":"","sources":["../../src/routes/db-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,IAAI,IAAI,WAAW,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAEV,cAAc,EACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAEV,QAAQ,EAET,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,IAAI,CAAC,EAAE,OAAO,WAAW,CAAC;CAC3B;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,IAO5C,KAAK;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,GAAG,EAAE,eAAe,CAAC;IACrB,GAAG,EAAE,cAAc,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClE,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,KAAG,OAAO,CAAC,OAAO,CAAC,CAyHrB"}