@sfmc-bds/db-server 0.1.0

package/dist/server.js

@@ -0,0 +1,82 @@
+/**
+ * server.ts — HTTP 服务 + 控制台
+ */
+import http from "node:http";
+import net from "node:net";
+import readline from "node:readline";
+import { log } from "./lib/log.js";
+export function checkPortConflict(port) {
+    return new Promise((resolve) => {
+        const server = net.createServer();
+        server.once("error", (err) => {
+            const result = { ok: false, port };
+            if (err.code) {
+                result.error = err.code;
+            }
+            resolve(result);
+        });
+        server.once("listening", () => {
+            server.close();
+            resolve({ ok: true, port });
+        });
+        server.listen(port, "127.0.0.1");
+    });
+}
+export function createServer({ handle, env, onListening }) {
+    const server = http.createServer((req, res) => {
+        const startedAt = Date.now();
+        let bodyStr = "";
+        const chunks = [];
+        req.on("data", (c) => chunks.push(c));
+        req.on("end", () => {
+            bodyStr = Buffer.concat(chunks).toString("utf-8").slice(0, 300);
+            req.bodyBuffer = bodyStr;
+        });
+        res.once("finish", () => {
+            const quietPoll = (req.url ?? "").startsWith("/api/sfmc/messages?") && res.statusCode < 400;
+            const bodySnippet = req.method === "GET" ? "" : ` ${bodyStr.slice(0, 200)}`;
+            if (!quietPoll)
+                log.info(`[HTTP] ${req.method} ${req.url} ${res.statusCode} ${Date.now() - startedAt}ms${bodySnippet}`);
+        });
+        void handle(req, res);
+    });
+    server.listen(env.PORT, env.HOST, () => {
+        log.success(`HTTP 服务已启动，端口 ${env.PORT} (loopback only)`);
+        log.info(`API 健康检查: http://${env.HOST}:${env.PORT}/api/health`);
+        log.info(`鉴权: ${env.AUTH_TOKEN ? "已启用 token" : "未启用"}`);
+        if (onListening)
+            onListening(server);
+    });
+    return server;
+}
+export function startConsole(server, db) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    rl.on("line", (line) => {
+        const cmd = line.trim().toLowerCase();
+        if (cmd === "help") {
+            console.log("DB Server 可用命令:");
+            console.log("  help    — 显示帮助");
+            console.log("  status  — 显示服务状态");
+            console.log("  stop    — 停止服务");
+        }
+        else if (cmd === "status") {
+            console.log(`状态: 运行中`);
+            console.log(`  HTTP 端口: ${server.address().port}`);
+            console.log(`  数据库: ${db ? "(已连接)" : "(未连接)"}`);
+        }
+        else if (cmd === "stop") {
+            log.info("正在停止服务...");
+            rl.close();
+            server.close();
+            if (db)
+                db.close();
+            process.exit(0);
+        }
+        else {
+            log.warn(`未知命令: ${cmd}，输入 help 查看帮助`);
+        }
+    });
+    rl.on("SIGINT", () => process.exit());
+    return rl;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/service-registry.d.ts

@@ -0,0 +1,46 @@
+/**
+ * service-registry.ts — 跨模块 service.get 后端
+ *
+ * 协议:
+ *   HTTP GET /api/sfmc/services/<name>?input=<urlencoded-json>
+ *   鉴权:Bearer module_token + ?moduleId=<callerId>
+ *
+ * 派发:
+ *   handler 注册在 db-server 进程内存。外层 db.tx 内的 tx.call 会注入
+ *   ctx.tx = { query, db },handler 不得再 BEGIN(方案 A)。
+ */
+import type { DatabaseSync } from "node:sqlite";
+import type { ModuleManifestV2 } from "./manifest-loader.js";
+import type { QueryFn } from "./lib/sqlite.js";
+export interface ServiceCallResult {
+    ok: true;
+    result: unknown;
+}
+export interface ServiceTxContext {
+    query: QueryFn;
+    db: DatabaseSync;
+}
+export interface ServiceDispatchContext {
+    callerModuleId: string;
+    payload: unknown;
+    /** 外层 db.tx 已打开时注入;handler 复用连接,禁止嵌套 BEGIN */
+    tx?: ServiceTxContext;
+}
+export type ServiceHandler = (ctx: ServiceDispatchContext) => Promise<unknown>;
+export declare class ServiceRegistry {
+    private readonly handlers;
+    /** 提供方在 db-server 启动期注册 handler */
+    registerHandler(moduleId: string, name: string, handle: ServiceHandler): void;
+    unregisterHandler(name: string): void;
+    list(): Array<{
+        name: string;
+        moduleId: string;
+    }>;
+    dispatch(enabled: Map<string, ModuleManifestV2>, callerModuleId: string, name: string, payload: unknown, tx?: ServiceTxContext): Promise<ServiceCallResult>;
+}
+export declare class DispatchError extends Error {
+    code: "no_such_service" | "not_in_requires" | "forbidden" | "internal" | "domain_error";
+    status: number;
+    constructor(message: string, code: "no_such_service" | "not_in_requires" | "forbidden" | "internal" | "domain_error", status: number);
+}
+//# sourceMappingURL=service-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service-registry.d.ts","sourceRoot":"","sources":["../src/service-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,EAAE,EAAE,YAAY,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,EAAE,CAAC,EAAE,gBAAgB,CAAC;CACvB;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,sBAAsB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAO/E,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IAEjE,mCAAmC;IACnC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI;IAO7E,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIrC,IAAI,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAI3C,QAAQ,CACZ,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,EACtC,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,EAAE,CAAC,EAAE,gBAAgB,GACpB,OAAO,CAAC,iBAAiB,CAAC;CAuC9B;AAED,qBAAa,aAAc,SAAQ,KAAK;IACtC,IAAI,EAAE,iBAAiB,GAAG,iBAAiB,GAAG,WAAW,GAAG,UAAU,GAAG,cAAc,CAAC;IACxF,MAAM,EAAE,MAAM,CAAC;gBAEb,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,iBAAiB,GAAG,iBAAiB,GAAG,WAAW,GAAG,UAAU,GAAG,cAAc,EACvF,MAAM,EAAE,MAAM;CAMjB"}

package/dist/service-registry.js

@@ -0,0 +1,73 @@
+/**
+ * service-registry.ts — 跨模块 service.get 后端
+ *
+ * 协议:
+ *   HTTP GET /api/sfmc/services/<name>?input=<urlencoded-json>
+ *   鉴权:Bearer module_token + ?moduleId=<callerId>
+ *
+ * 派发:
+ *   handler 注册在 db-server 进程内存。外层 db.tx 内的 tx.call 会注入
+ *   ctx.tx = { query, db },handler 不得再 BEGIN(方案 A)。
+ */
+export class ServiceRegistry {
+    handlers = new Map();
+    /** 提供方在 db-server 启动期注册 handler */
+    registerHandler(moduleId, name, handle) {
+        if (this.handlers.has(name)) {
+            throw new Error(`[service] "${name}" 已被 ${this.handlers.get(name)?.moduleId} 注册,${moduleId} 抢注`);
+        }
+        this.handlers.set(name, { moduleId, handle });
+    }
+    unregisterHandler(name) {
+        this.handlers.delete(name);
+    }
+    list() {
+        return [...this.handlers.entries()].map(([name, h]) => ({ name, moduleId: h.moduleId }));
+    }
+    async dispatch(enabled, callerModuleId, name, payload, tx) {
+        const handler = this.handlers.get(name);
+        if (!handler) {
+            throw new DispatchError(`service "${name}" 未注册`, "no_such_service", 404);
+        }
+        if (!enabled.has(handler.moduleId)) {
+            throw new DispatchError(`service "${name}" 提供方 ${handler.moduleId} 未 enabled`, "forbidden", 403);
+        }
+        const caller = enabled.get(callerModuleId);
+        if (!caller) {
+            throw new DispatchError(`调用方 ${callerModuleId} 未 enabled`, "forbidden", 403);
+        }
+        const declared = caller.services.requires.find((r) => r.name === name);
+        // 提供方调自己的 service 免 requires(例如 economy 白皮书调 stats.monthly)
+        if (!declared && callerModuleId !== handler.moduleId) {
+            throw new DispatchError(`${callerModuleId} 的 manifest.services.requires 未声明 "${name}"`, "not_in_requires", 403);
+        }
+        try {
+            const result = await handler.handle({
+                callerModuleId,
+                payload,
+                ...(tx ? { tx } : {}),
+            });
+            return { ok: true, result };
+        }
+        catch (e) {
+            // 保留 handler 抛出的领域/鉴权错误契约,勿压成 500 internal(LSP)
+            if (e instanceof DispatchError)
+                throw e;
+            const err = e;
+            if (typeof err.status === "number" && err.code) {
+                throw new DispatchError(err.message, err.code, err.status);
+            }
+            throw new DispatchError(`handler 抛错: ${err.message}`, "internal", 500);
+        }
+    }
+}
+export class DispatchError extends Error {
+    code;
+    status;
+    constructor(message, code, status) {
+        super(message);
+        this.code = code;
+        this.status = status;
+    }
+}
+//# sourceMappingURL=service-registry.js.map

package/dist/service-registry.js.map

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

package/dist/services/builtin-handlers.d.ts

@@ -0,0 +1,22 @@
+/**
+ * services/builtin-handlers.ts — 进程内置 service 插件注册表
+ *
+ * 新增内置 handler 只追加 BUILTIN_SERVICE_PLUGINS(OCP),
+ * 勿在 index.ts 再写 if (enabledSet.has(...)) registerXxx 链。
+ */
+import type { DatabaseSync } from "node:sqlite";
+import type { QueryFn } from "../lib/sqlite.js";
+import type { ServiceRegistry } from "../service-registry.js";
+export type BuiltinServiceDeps = {
+    query: QueryFn;
+    db: DatabaseSync;
+};
+export type BuiltinServicePlugin = {
+    moduleId: string;
+    register: (registry: ServiceRegistry, deps: BuiltinServiceDeps) => void;
+};
+/** 内置 service 插件清单 — 唯一扩展点 */
+export declare const BUILTIN_SERVICE_PLUGINS: BuiltinServicePlugin[];
+/** 按 enabledSet 注册内置插件,返回已注册插件数 */
+export declare function registerEnabledBuiltinServices(registry: ServiceRegistry, deps: BuiltinServiceDeps, enabledSet: Set<string>): number;
+//# sourceMappingURL=builtin-handlers.d.ts.map

package/dist/services/builtin-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-handlers.d.ts","sourceRoot":"","sources":["../../src/services/builtin-handlers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D,MAAM,MAAM,kBAAkB,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,YAAY,CAAA;CAAE,CAAC;AAEtE,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAC;CACzE,CAAC;AAEF,8BAA8B;AAC9B,eAAO,MAAM,uBAAuB,EAAE,oBAAoB,EAEzD,CAAC;AAEF,mCAAmC;AACnC,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,eAAe,EACzB,IAAI,EAAE,kBAAkB,EACxB,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GACtB,MAAM,CAQR"}

package/dist/services/builtin-handlers.js

@@ -0,0 +1,23 @@
+/**
+ * services/builtin-handlers.ts — 进程内置 service 插件注册表
+ *
+ * 新增内置 handler 只追加 BUILTIN_SERVICE_PLUGINS(OCP),
+ * 勿在 index.ts 再写 if (enabledSet.has(...)) registerXxx 链。
+ */
+import { registerEconomyHandlers } from "./economy-handlers.js";
+/** 内置 service 插件清单 — 唯一扩展点 */
+export const BUILTIN_SERVICE_PLUGINS = [
+    { moduleId: "feature-economy", register: registerEconomyHandlers },
+];
+/** 按 enabledSet 注册内置插件,返回已注册插件数 */
+export function registerEnabledBuiltinServices(registry, deps, enabledSet) {
+    let n = 0;
+    for (const plugin of BUILTIN_SERVICE_PLUGINS) {
+        if (!enabledSet.has(plugin.moduleId))
+            continue;
+        plugin.register(registry, deps);
+        n += 1;
+    }
+    return n;
+}
+//# sourceMappingURL=builtin-handlers.js.map

package/dist/services/builtin-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-handlers.js","sourceRoot":"","sources":["../../src/services/builtin-handlers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAShE,8BAA8B;AAC9B,MAAM,CAAC,MAAM,uBAAuB,GAA2B;IAC7D,EAAE,QAAQ,EAAE,iBAAiB,EAAE,QAAQ,EAAE,uBAAuB,EAAE;CACnE,CAAC;AAEF,mCAAmC;AACnC,MAAM,UAAU,8BAA8B,CAC5C,QAAyB,EACzB,IAAwB,EACxB,UAAuB;IAEvB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,MAAM,MAAM,IAAI,uBAAuB,EAAE,CAAC;QAC7C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;YAAE,SAAS;QAC/C,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAChC,CAAC,IAAI,CAAC,CAAC;IACT,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/services/economy-handlers.d.ts

@@ -0,0 +1,14 @@
+/**
+ * services/economy-handlers.ts — feature-economy 的 7 个 service handler
+ *
+ * 全部跑在 db-server 进程内,复用 domain/economy.ts。
+ * ctx.tx 存在时 alreadyInTx=true,与外层 db.tx 共享同一 SQLite 事务。
+ */
+import type { DatabaseSync } from "node:sqlite";
+import type { QueryFn } from "../lib/sqlite.js";
+import { type ServiceRegistry } from "../service-registry.js";
+export declare function registerEconomyHandlers(registry: ServiceRegistry, deps: {
+    query: QueryFn;
+    db: DatabaseSync;
+}): void;
+//# sourceMappingURL=economy-handlers.d.ts.map

package/dist/services/economy-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"economy-handlers.d.ts","sourceRoot":"","sources":["../../src/services/economy-handlers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAyC7E,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,eAAe,EACzB,IAAI,EAAE;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,YAAY,CAAA;CAAE,GACzC,IAAI,CAgIN"}

package/dist/services/economy-handlers.js

@@ -0,0 +1,144 @@
+/**
+ * services/economy-handlers.ts — feature-economy 的 7 个 service handler
+ *
+ * 全部跑在 db-server 进程内,复用 domain/economy.ts。
+ * ctx.tx 存在时 alreadyInTx=true,与外层 db.tx 共享同一 SQLite 事务。
+ */
+import { DispatchError } from "../service-registry.js";
+import { applyEconomyTransaction, getEconomyAccount, listDailyTasks, monthlyEconomyStats, submitDailyTaskTx, } from "../domain/economy.js";
+const MODULE_ID = "feature-economy";
+function asObj(payload) {
+    return payload && typeof payload === "object" ? payload : {};
+}
+function str(v, fallback = "") {
+    return v === undefined || v === null ? fallback : String(v);
+}
+function num(v) {
+    return Number(v);
+}
+/** 领域失败保留 status/code,避免被 registry 压成 500 internal(LSP) */
+function unwrapOk(result) {
+    if (!result.ok) {
+        throw new DispatchError(result.error, "domain_error", result.status);
+    }
+    return {
+        transactionId: result.transactionId,
+        replayed: result.replayed ?? false,
+        source: result.source,
+        target: result.target,
+        // 方便调用方读单边余额
+        balance: result.target?.balanceAfter ?? result.source?.balanceAfter,
+        version: result.target?.version ?? result.source?.version,
+    };
+}
+export function registerEconomyHandlers(registry, deps) {
+    const standaloneQuery = deps.query;
+    registry.registerHandler(MODULE_ID, "economy.account.get", async (ctx) => {
+        const p = asObj(ctx.payload);
+        const playerId = str(p.playerId ?? p.player_id);
+        if (!playerId)
+            throw new DispatchError("missing_playerId", "domain_error", 400);
+        const q = ctx.tx?.query ?? standaloneQuery;
+        return getEconomyAccount(q, playerId, str(p.playerName ?? p.player_name));
+    });
+    registry.registerHandler(MODULE_ID, "economy.account.debit", async (ctx) => {
+        const p = asObj(ctx.payload);
+        const playerId = str(p.playerId ?? p.player_id ?? p.actorId);
+        const amount = num(p.amount);
+        if (!playerId)
+            throw new DispatchError("missing_playerId", "domain_error", 400);
+        const q = ctx.tx?.query ?? standaloneQuery;
+        const db = ctx.tx?.db ?? deps.db;
+        const idem = str(p.idempotencyKey ?? p.idempotency_key);
+        const result = applyEconomyTransaction(q, db, {
+            actorId: playerId,
+            sourcePlayerId: playerId,
+            sourcePlayerName: str(p.playerName ?? p.player_name),
+            amount,
+            type: "debit",
+            reason: str(p.reason),
+            referenceType: str(p.referenceType ?? p.meta?.type),
+            referenceId: str(p.referenceId ?? p.meta?.redpacketId),
+            ...(idem ? { idempotencyKey: idem } : {}),
+        }, { alreadyInTx: !!ctx.tx });
+        return unwrapOk(result);
+    });
+    registry.registerHandler(MODULE_ID, "economy.account.credit", async (ctx) => {
+        const p = asObj(ctx.payload);
+        const playerId = str(p.playerId ?? p.player_id ?? p.actorId);
+        const amount = num(p.amount);
+        if (!playerId)
+            throw new DispatchError("missing_playerId", "domain_error", 400);
+        const q = ctx.tx?.query ?? standaloneQuery;
+        const db = ctx.tx?.db ?? deps.db;
+        const idem = str(p.idempotencyKey ?? p.idempotency_key);
+        const result = applyEconomyTransaction(q, db, {
+            actorId: playerId,
+            targetPlayerId: playerId,
+            targetPlayerName: str(p.playerName ?? p.player_name),
+            amount,
+            type: "credit",
+            reason: str(p.reason),
+            referenceType: str(p.referenceType ?? p.meta?.type),
+            referenceId: str(p.referenceId ?? p.meta?.redpacketId),
+            ...(idem ? { idempotencyKey: idem } : {}),
+        }, { alreadyInTx: !!ctx.tx });
+        return unwrapOk(result);
+    });
+    registry.registerHandler(MODULE_ID, "economy.account.transfer", async (ctx) => {
+        const p = asObj(ctx.payload);
+        const from = str(p.fromPlayerId ?? p.sourcePlayerId ?? p.source_player_id ?? p.actorId ?? p.actor_id) || "";
+        const to = str(p.toPlayerId ?? p.targetPlayerId ?? p.target_player_id) || "";
+        const amount = num(p.amount);
+        if (!from || !to)
+            throw new DispatchError("missing_from_or_to", "domain_error", 400);
+        const q = ctx.tx?.query ?? standaloneQuery;
+        const db = ctx.tx?.db ?? deps.db;
+        const idem = str(p.idempotencyKey ?? p.idempotency_key);
+        const result = applyEconomyTransaction(q, db, {
+            actorId: from,
+            sourcePlayerId: from,
+            sourcePlayerName: str(p.fromPlayerName ?? p.sourcePlayerName),
+            targetPlayerId: to,
+            targetPlayerName: str(p.toPlayerName ?? p.targetPlayerName),
+            amount,
+            type: "transfer",
+            reason: str(p.reason),
+            ...(idem ? { idempotencyKey: idem } : {}),
+        }, { alreadyInTx: !!ctx.tx });
+        return unwrapOk(result);
+    });
+    // 信封与 daily-task 消费方对齐:{ tasks: [...] }
+    registry.registerHandler(MODULE_ID, "economy.dailyTasks.list", async (ctx) => {
+        const p = asObj(ctx.payload);
+        const q = ctx.tx?.query ?? standaloneQuery;
+        return {
+            tasks: listDailyTasks(q, {
+                status: str(p.status) || "active",
+                includeExpired: Boolean(p.includeExpired),
+            }),
+        };
+    });
+    // 信封与 daily-task 消费方对齐:成功/失败都带 ok,业务失败不抛(避免物品已扣却无法走 !ok 退还分支)
+    registry.registerHandler(MODULE_ID, "economy.dailyTasks.submit", async (ctx) => {
+        const p = asObj(ctx.payload);
+        const actorId = str(p.actorId ?? p.playerId ?? p.player_id);
+        const taskId = str(p.taskId ?? p.task_id);
+        const quantity = num(p.quantity ?? 1);
+        if (!actorId || !taskId) {
+            return { ok: false, error: "missing_actor_or_task", status: 400 };
+        }
+        const q = ctx.tx?.query ?? standaloneQuery;
+        const db = ctx.tx?.db ?? deps.db;
+        const result = submitDailyTaskTx(q, db, { actorId, taskId, quantity }, { alreadyInTx: !!ctx.tx });
+        if (!result.ok) {
+            return { ok: false, error: result.error, status: result.status };
+        }
+        return { ok: true, ...result.data };
+    });
+    registry.registerHandler(MODULE_ID, "economy.stats.monthly", async (ctx) => {
+        const q = ctx.tx?.query ?? standaloneQuery;
+        return monthlyEconomyStats(q);
+    });
+}
+//# sourceMappingURL=economy-handlers.js.map

package/dist/services/economy-handlers.js.map

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

package/dist/tx-runner.d.ts

@@ -0,0 +1,144 @@
+/**
+ * tx-runner.ts — 事务 RPC 处理器
+ *
+ * 协议:
+ *   POST /api/sfmc/db/tx
+ *   body = { moduleId, steps: TxStep[] }
+ *   reply: { ok: true } | { ok: false, step: <index>, error, code }
+ *
+ * 流程:
+ *   1. 校验 moduleId in enabled + permission "db:write:*"
+ *   2. BEGIN IMMEDIATE
+ *   3. 顺序跑 steps — 任一抛错 → ROLLBACK + reply { ok:false, step:<i>, ... }
+ *   4. 全过 → COMMIT + reply { ok:true }
+ *
+ * step.op:
+ *   - query      { table, opts? }
+ *   - get        { table, id }
+ *   - insert     { table, row }
+ *   - update     { table, id, patch }
+ *   - delete     { table, id, hard }
+ *   - audit      { table, rowId, action, data? }  → 平台 sfmc__audit 表
+ *   - service    { name, input }                  → 派发;失败抛错回退整事务
+ *
+ * 事务内 service call:不持有 db handle 给 handler(避免并发写) —
+ *   实现:handler 是"同步纯函数",返回 result 写回 step 的输出。
+ *   若 handler 自己也想写 db,应通过其它接口在事务外做(避免嵌套)。
+ */
+import type { DatabaseSync } from "node:sqlite";
+import type { SchemaRegistry } from "./schema-registry.js";
+import type { WhereExpr } from "./where.js";
+import { type ServiceRegistry } from "./service-registry.js";
+import type { ModuleManifestV2 } from "./manifest-loader.js";
+export interface TxStepQuery {
+    op: "query";
+    table: string;
+    opts?: {
+        where?: WhereExpr;
+        orderBy?: {
+            col: string;
+            dir?: "asc" | "desc";
+        };
+        limit?: number;
+        offset?: number;
+    };
+}
+export interface TxStepGet {
+    op: "get";
+    table: string;
+    id: string;
+}
+export interface TxStepInsert {
+    op: "insert";
+    table: string;
+    row: Record<string, unknown>;
+}
+export interface TxStepUpdate {
+    op: "update";
+    table: string;
+    id: string;
+    patch: Record<string, unknown>;
+}
+export interface TxStepDelete {
+    op: "delete";
+    table: string;
+    id: string;
+    hard: boolean;
+}
+export interface TxStepAudit {
+    op: "audit";
+    table: string;
+    rowId: string;
+    action: string;
+    data?: Record<string, unknown>;
+}
+export interface TxStepService {
+    op: "service";
+    name: string;
+    input: Record<string, unknown>;
+}
+export type TxStep = TxStepQuery | TxStepGet | TxStepInsert | TxStepUpdate | TxStepDelete | TxStepAudit | TxStepService;
+export type TxStepResult = {
+    op: "query";
+    rows: Record<string, unknown>[];
+} | {
+    op: "get";
+    row: Record<string, unknown> | null;
+} | {
+    op: "insert";
+    row: Record<string, unknown>;
+} | {
+    op: "update";
+    row: Record<string, unknown>;
+} | {
+    op: "delete";
+    changes: number;
+} | {
+    op: "audit";
+    changes: number;
+} | {
+    op: "service";
+    result: unknown;
+};
+export interface TxResponse {
+    ok: true;
+    results: TxStepResult[];
+}
+export type TxError = {
+    ok: false;
+    step: number;
+    error: string;
+    code: "permission_denied" | "forbidden" | "no_such_service" | "not_in_requires" | "domain_error" | "internal" | "no_such_table";
+};
+export interface TxRequest {
+    moduleId: string;
+    steps: TxStep[];
+}
+export interface TxRunnerDeps {
+    db: DatabaseSync;
+    query: import("./lib/sqlite.js").QueryFn;
+    schema: SchemaRegistry;
+    serviceRegistry: ServiceRegistry;
+    enabled: Map<string, ModuleManifestV2>;
+}
+export declare class TxRunner {
+    private readonly deps;
+    constructor(deps: TxRunnerDeps);
+    run(req: TxRequest): Promise<TxResponse | TxError>;
+    private rollback;
+    /** 单 step 由对应权限检查 + SQL 路径执行 */
+    private runOne;
+    private requireTableRead;
+    private requireTableWrite;
+    private assertTableRegistered;
+    private doQuery;
+    /** 解析主键 WHERE。单列直接等值;联合主键支持 `a|b|c`(与 data-backup 约定一致)。 */
+    private pkWhere;
+    private doGet;
+    private doInsert;
+    private doUpdate;
+    private doDelete;
+    private doAudit;
+    private doService;
+}
+//# sourceMappingURL=tx-runner.d.ts.map

package/dist/tx-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tx-runner.d.ts","sourceRoot":"","sources":["../src/tx-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAa7D,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE;QACL,KAAK,CAAC,EAAE,SAAS,CAAC;QAClB,OAAO,CAAC,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;SAAE,CAAC;QAChD,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,QAAQ,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,QAAQ,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,QAAQ,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,SAAS,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,MAAM,MAAM,GACd,WAAW,GACX,SAAS,GACT,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,WAAW,GACX,aAAa,CAAC;AAElB,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;CAAE,GAChD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CAAE,GAClD;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC9C;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC9C;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,EAAE,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAEvC,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,MAAM,MAAM,OAAO,GAAG;IACpB,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EACA,mBAAmB,GACnB,WAAW,GACX,iBAAiB,GACjB,iBAAiB,GACjB,cAAc,GACd,UAAU,GACV,eAAe,CAAC;CACrB,CAAC;AAEF,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,YAAY,CAAC;IACjB,KAAK,EAAE,OAAO,iBAAiB,EAAE,OAAO,CAAC;IACzC,MAAM,EAAE,cAAc,CAAC;IACvB,eAAe,EAAE,eAAe,CAAC;IACjC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CACxC;AAED,qBAAa,QAAQ;IACP,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,YAAY;IAEzC,GAAG,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC;IAyDxD,OAAO,CAAC,QAAQ;IAQhB,gCAAgC;YAClB,MAAM;IAuBpB,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,qBAAqB;IAS7B,OAAO,CAAC,OAAO;IA2Bf,4DAA4D;IAC5D,OAAO,CAAC,OAAO;IA0Bf,OAAO,CAAC,KAAK;IASb,OAAO,CAAC,QAAQ;IAmBhB,OAAO,CAAC,QAAQ;IAkBhB,OAAO,CAAC,QAAQ;IAsBhB,OAAO,CAAC,OAAO;YAYD,SAAS;CAiBxB"}