@sfmc-bds/db-server 0.1.0

package/README.md

@@ -0,0 +1,21 @@
+# @sfmc-bds/db-server
+
+SFMC SQLite HTTP REST 后端：配置快照、模块启停、游戏数据路由、QQ 消息中继。
+
+## 安装
+
+```bash
+npm install @sfmc-bds/db-server
+node node_modules/@sfmc-bds/db-server/dist/index.js
+```
+
+通常由 `@sfmc-bds/cli` 或 SEA 包统一拉起，无需单独安装。
+
+## 依赖
+
+- `@sfmc-bds/sdk` ^0.1.0
+- Node.js >= 22.13（`node:sqlite`）
+
+## 仓库
+
+<https://github.com/DogeLakeDev/ScriptsForMinecraftServer/tree/main/db-server>

package/dist/db-tables.d.ts

@@ -0,0 +1,13 @@
+/**
+ * db-tables.ts — 平台自带数据库表 bootstrap
+ *
+ * 平台表(不是模块声明的):
+ *   - sfmc__audit        — db.audit() 自动写入
+ *   - sfmc__idempotent   — db.idempotent() probe/commit 用
+ *
+ * 业务表(land / economy / coops / redpacket / ...)的 DDL 不在这里;
+ * 它们由各自模块在 init() 调 db.defineTable() 声明,schema-registry 统一建表。
+ */
+import type { DatabaseSync } from "node:sqlite";
+export declare function createPlatformTables(db: DatabaseSync): void;
+//# sourceMappingURL=db-tables.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"db-tables.d.ts","sourceRoot":"","sources":["../src/db-tables.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAwB3D"}

package/dist/db-tables.js

@@ -0,0 +1,35 @@
+/**
+ * db-tables.ts — 平台自带数据库表 bootstrap
+ *
+ * 平台表(不是模块声明的):
+ *   - sfmc__audit        — db.audit() 自动写入
+ *   - sfmc__idempotent   — db.idempotent() probe/commit 用
+ *
+ * 业务表(land / economy / coops / redpacket / ...)的 DDL 不在这里;
+ * 它们由各自模块在 init() 调 db.defineTable() 声明,schema-registry 统一建表。
+ */
+export function createPlatformTables(db) {
+    db.exec(/* sql */ `
+    CREATE TABLE IF NOT EXISTS sfmc__audit (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      module_id TEXT NOT NULL,
+      table_name TEXT NOT NULL,
+      row_id TEXT NOT NULL,
+      action TEXT NOT NULL,
+      data TEXT,
+      created_at TEXT NOT NULL
+    )
+  `);
+    db.exec(`CREATE INDEX IF NOT EXISTS idx_sfmc__audit_module_table ON sfmc__audit(module_id, table_name)`);
+    db.exec(/* sql */ `
+    CREATE TABLE IF NOT EXISTS sfmc__idempotent (
+      module_id TEXT NOT NULL,
+      action TEXT NOT NULL,
+      key TEXT NOT NULL,
+      value TEXT,
+      created_at TEXT NOT NULL,
+      PRIMARY KEY (module_id, action, key)
+    )
+  `);
+}
+//# sourceMappingURL=db-tables.js.map

package/dist/db-tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-tables.js","sourceRoot":"","sources":["../src/db-tables.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,UAAU,oBAAoB,CAAC,EAAgB;IACnD,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC;;;;;;;;;;GAUjB,CAAC,CAAC;IACH,EAAE,CAAC,IAAI,CAAC,+FAA+F,CAAC,CAAC;IAEzG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC;;;;;;;;;GASjB,CAAC,CAAC;AACL,CAAC"}

package/dist/domain/bridge.d.ts

@@ -0,0 +1,48 @@
+/**
+ * domain/bridge.ts — MC → QQ 桥接
+ *
+ * db-server 收到 SAPI 上报的消息后,直接调 LLBot HTTP `/send_group_msg`
+ * 把消息转发到 QQ 群。不再走中间 qq-bridge 进程。
+ *
+ * 数据流:
+ *   SAPI ──POST──→ db-server:3001/api/sfmc/messages
+ *                   └─ 写库 + forwardToQQBridge() ──HTTP──→ LLBot:3004/send_group_msg
+ *
+ * 事务描述:
+ *   - 无 DB 事务(本文件不操作 SQLite,只做 HTTP 出站转发)
+ *
+ * 领域函数:
+ *   - makeLLBotConfig(env)  工厂:从 env 构造 LLBotConfig
+ *   - forwardToQQBridge()   转发单条 MC 消息到 LLBot;失败仅 warn,不抛错
+ */
+type LLBotConfig = {
+    host: string;
+    port: number;
+    token: string;
+    groupId: string;
+    prefix: string;
+};
+/**
+ * 构造 LLBotConfig。允许显式传入(测试),默认从 env 推不出,
+ * 所以调用方需自己把 env 里读到的值传进来。
+ */
+export declare function makeLLBotConfig(env: {
+    LLBOT_HOST: string;
+    LLBOT_PORT: number;
+    LLBOT_TOKEN: string;
+    QQ_GROUP_ID: string;
+}): LLBotConfig;
+/**
+ * @description
+ * @author Shiroha7z
+ * @date 17/07/2026
+ * @export
+ * @param {LLBotConfig} config LLBot 连接信息(host/port/token/groupId/prefix)
+ * @param {string} channelId   MC 频道 ID(用于过滤 / 标记,目前仅做日志)
+ * @param {string} fromName    MC 玩家名
+ * @param {string} content     消息正文
+ * @param {string} fromId      MC 玩家 ID
+ */
+export declare function forwardToQQBridge(config: LLBotConfig, channelId: string, fromName: string, content: string, fromId: string): void;
+export {};
+//# sourceMappingURL=bridge.d.ts.map

package/dist/domain/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/domain/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,KAAK,WAAW,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,WAAW,CAQd;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,IAAI,CA6CN"}

package/dist/domain/bridge.js

@@ -0,0 +1,82 @@
+/**
+ * domain/bridge.ts — MC → QQ 桥接
+ *
+ * db-server 收到 SAPI 上报的消息后,直接调 LLBot HTTP `/send_group_msg`
+ * 把消息转发到 QQ 群。不再走中间 qq-bridge 进程。
+ *
+ * 数据流:
+ *   SAPI ──POST──→ db-server:3001/api/sfmc/messages
+ *                   └─ 写库 + forwardToQQBridge() ──HTTP──→ LLBot:3004/send_group_msg
+ *
+ * 事务描述:
+ *   - 无 DB 事务(本文件不操作 SQLite,只做 HTTP 出站转发)
+ *
+ * 领域函数:
+ *   - makeLLBotConfig(env)  工厂:从 env 构造 LLBotConfig
+ *   - forwardToQQBridge()   转发单条 MC 消息到 LLBot;失败仅 warn,不抛错
+ */
+import { request } from "node:http";
+import { log } from "../lib/log.js";
+/**
+ * 构造 LLBotConfig。允许显式传入(测试),默认从 env 推不出,
+ * 所以调用方需自己把 env 里读到的值传进来。
+ */
+export function makeLLBotConfig(env) {
+    return {
+        host: env.LLBOT_HOST,
+        port: env.LLBOT_PORT,
+        token: env.LLBOT_TOKEN,
+        groupId: env.QQ_GROUP_ID,
+        prefix: "[MC]",
+    };
+}
+/**
+ * @description
+ * @author Shiroha7z
+ * @date 17/07/2026
+ * @export
+ * @param {LLBotConfig} config LLBot 连接信息(host/port/token/groupId/prefix)
+ * @param {string} channelId   MC 频道 ID(用于过滤 / 标记,目前仅做日志)
+ * @param {string} fromName    MC 玩家名
+ * @param {string} content     消息正文
+ * @param {string} fromId      MC 玩家 ID
+ */
+export function forwardToQQBridge(config, channelId, fromName, content, fromId) {
+    if (!config.groupId || config.groupId === "0") {
+        log.warn(`QQ 群未配置 (qq_group_id),跳过 MC→QQ 转发 (channel=${channelId})`);
+        return;
+    }
+    const text = `${config.prefix} ${fromName}: ${content}`;
+    const payload = JSON.stringify({
+        group_id: parseInt(config.groupId, 10),
+        message: [{ type: "text", data: { text } }],
+    });
+    const headers = {
+        "Content-Type": "application/json",
+        "Content-Length": Buffer.byteLength(payload),
+    };
+    if (config.token) {
+        headers["Authorization"] = `Bearer ${config.token}`;
+    }
+    const req = request({
+        hostname: config.host,
+        port: config.port,
+        path: "/send_group_msg",
+        method: "POST",
+        headers,
+    }, (res) => {
+        let body = "";
+        res.on("data", (c) => (body += c));
+        res.on("end", () => {
+            if (res.statusCode !== 200) {
+                log.warn(`LLBot send_group_msg → ${res.statusCode}: ${String(body).slice(0, 200)} (from=${fromId}, channel=${channelId})`);
+            }
+        });
+    });
+    req.on("error", (err) => {
+        log.warn(`LLBot 不可达 (${config.host}:${config.port}): ${err.message}`);
+    });
+    req.write(payload);
+    req.end();
+}
+//# sourceMappingURL=bridge.js.map

package/dist/domain/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../src/domain/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAUpC;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,GAK/B;IACC,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,UAAU;QACpB,IAAI,EAAE,GAAG,CAAC,UAAU;QACpB,KAAK,EAAE,GAAG,CAAC,WAAW;QACtB,OAAO,EAAE,GAAG,CAAC,WAAW;QACxB,MAAM,EAAE,MAAM;KACf,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAmB,EACnB,SAAiB,EACjB,QAAgB,EAChB,OAAe,EACf,MAAc;IAEd,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,KAAK,GAAG,EAAE,CAAC;QAC9C,GAAG,CAAC,IAAI,CAAC,8CAA8C,SAAS,GAAG,CAAC,CAAC;QACrE,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,MAAM,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;IACxD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;QAC7B,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QACtC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;KAC5C,CAAC,CAAC;IAEH,MAAM,OAAO,GAAoC;QAC/C,cAAc,EAAE,kBAAkB;QAClC,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC;KAC7C,CAAC;IACF,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,MAAM,CAAC,KAAK,EAAE,CAAC;IACtD,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CACjB;QACE,QAAQ,EAAE,MAAM,CAAC,IAAI;QACrB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,MAAM;QACd,OAAO;KACR,EACD,CAAC,GAAG,EAAE,EAAE;QACN,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;QACnC,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;YACjB,IAAI,GAAG,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;gBAC3B,GAAG,CAAC,IAAI,CACN,0BAA0B,GAAG,CAAC,UAAU,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,UAAU,MAAM,aAAa,SAAS,GAAG,CACjH,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;IACF,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QACtB,GAAG,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IACH,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnB,GAAG,CAAC,GAAG,EAAE,CAAC;AACZ,CAAC"}

package/dist/domain/economy.d.ts

@@ -0,0 +1,120 @@
+/**
+ * domain/economy.ts — 经济系统业务核心
+ *
+ * 提供账户 upsert、通用转账、日常任务奖励与月度统计。
+ * land / chat / gui 等通过 service(economy.account.*) 调用本文件。
+ *
+ * 事务约定(方案 A):
+ *   - applyEconomySteps / submitDailyTaskSteps — 无 BEGIN/COMMIT,可嵌进外层 db.tx
+ *   - applyEconomyTransaction / submitDailyTaskTx — 独立调用时自己开事务;
+ *     alreadyInTx=true 时只跑 steps
+ */
+import type { EconomyAccountRow, EconomyTransactionRow } from "@sfmc-bds/sdk/contracts";
+import type { DatabaseSync } from "node:sqlite";
+import type { SQLStatement } from "sql-template-strings";
+import type { TxResult } from "./transaction.js";
+export type { TxResult };
+/** query 兼容格式：string / SQLStatement / { sql, values } */
+export type AnyQuery = (sql: string | SQLStatement | {
+    sql: string;
+    values?: unknown[];
+}, values?: unknown[]) => unknown[] | {
+    changes: number | bigint;
+};
+export interface EconomyAccountView {
+    playerId: string;
+    playerName: string;
+    balance: number;
+    version: number;
+}
+export declare function economyResult(row: EconomyAccountRow | undefined): EconomyAccountView | undefined;
+/** 确保账户存在并返回最新行 */
+export declare function ensureEconomyAccount(query: AnyQuery, playerId: string, playerName: string): EconomyAccountRow | undefined;
+/** 读取(必要时创建)账户业务视图 */
+export declare function getEconomyAccount(query: AnyQuery, playerId: string, playerName?: string): EconomyAccountView | null;
+export interface ApplyEconomyInput {
+    actor_id?: string;
+    amount: number;
+    transaction_type?: string;
+    source_player_id?: string;
+    target_player_id?: string;
+    reference_type?: string;
+    reference_id?: string;
+    reason?: string;
+    idempotency_key?: string;
+    actorId?: string;
+    type?: string;
+    sourcePlayerId?: string;
+    targetPlayerId?: string;
+    sourcePlayerName?: string;
+    targetPlayerName?: string;
+    referenceType?: string;
+    referenceId?: string;
+    reasonAlias?: string;
+    idempotencyKey?: string;
+}
+export type ApplyEconomyResult = {
+    ok: true;
+    transactionId: string;
+    replayed?: boolean;
+    source: (EconomyAccountView & {
+        balanceBefore: number;
+        balanceAfter: number;
+    }) | null;
+    target: (EconomyAccountView & {
+        balanceBefore: number;
+        balanceAfter: number;
+    }) | null;
+} | {
+    ok: false;
+    error: string;
+    status: number;
+    balance?: number;
+};
+/**
+ * 经济变更核心(无 BEGIN/COMMIT)。
+ * 纯 debit(仅 source)或纯 credit(仅 target)均可成功。
+ */
+export declare function applyEconomySteps(query: AnyQuery, data: ApplyEconomyInput): ApplyEconomyResult;
+/**
+ * 独立经济事务包装。alreadyInTx=true 时复用外层事务(不再 BEGIN)。
+ */
+export declare function applyEconomyTransaction(query: AnyQuery, db: DatabaseSync, data: ApplyEconomyInput, opts?: {
+    alreadyInTx?: boolean;
+}): ApplyEconomyResult;
+export type { EconomyAccountRow, EconomyTransactionRow };
+/** 列出日常任务(默认仅 active 且未过期) */
+export declare function listDailyTasks(query: AnyQuery, filter?: {
+    status?: string;
+    includeExpired?: boolean;
+}): Array<Record<string, unknown>>;
+export interface SubmitDailyTaskInput {
+    actorId: string;
+    taskId: string;
+    quantity: number;
+}
+/** 日常任务提交核心(无 BEGIN) */
+export declare function submitDailyTaskSteps(query: AnyQuery, data: SubmitDailyTaskInput): TxResult<{
+    transactionId: string;
+    reward: number;
+    balance: number;
+    balanceVersion: number;
+}>;
+/** 日常任务提交包装(可独立事务或嵌入外层 tx) */
+export declare function submitDailyTaskTx(query: AnyQuery, db: DatabaseSync, data: SubmitDailyTaskInput, opts?: {
+    alreadyInTx?: boolean;
+}): TxResult<{
+    transactionId: string;
+    reward: number;
+    balance: number;
+    balanceVersion: number;
+}>;
+/** 月度/全局经济白皮书(优先读 sfmc_economy_stats,否则现场聚合) */
+export declare function monthlyEconomyStats(query: AnyQuery): {
+    id: string;
+    total_issued: number;
+    total_destroyed: number;
+    total_supply: number;
+    active_accounts: number;
+};
+//# sourceMappingURL=economy.d.ts.map

package/dist/domain/economy.d.ts.map

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

package/dist/domain/economy.js

@@ -0,0 +1,321 @@
+/**
+ * domain/economy.ts — 经济系统业务核心
+ *
+ * 提供账户 upsert、通用转账、日常任务奖励与月度统计。
+ * land / chat / gui 等通过 service(economy.account.*) 调用本文件。
+ *
+ * 事务约定(方案 A):
+ *   - applyEconomySteps / submitDailyTaskSteps — 无 BEGIN/COMMIT,可嵌进外层 db.tx
+ *   - applyEconomyTransaction / submitDailyTaskTx — 独立调用时自己开事务;
+ *     alreadyInTx=true 时只跑 steps
+ */
+import { isValidIdempotencyKey } from "../lib/idempotency.js";
+import { sql } from "../lib/sql-helpers.js";
+const TABLE_ACCOUNTS = "sfmc_economy_accounts";
+const TABLE_TRANSACTIONS = "sfmc_economy_transactions";
+const TABLE_IDEMPOTENCY = "sfmc_economy_idempotency";
+const TABLE_DAILY = "sfmc_economy_daily_tasks";
+const TABLE_STATS = "sfmc_economy_stats";
+function newTransactionId(now) {
+    return `E${now.toString(36)}${Math.random().toString(36).slice(2, 8)}`;
+}
+export function economyResult(row) {
+    if (!row)
+        return undefined;
+    return {
+        playerId: row.player_id,
+        playerName: row.player_name_snapshot,
+        balance: row.balance,
+        version: row.version,
+    };
+}
+/** 确保账户存在并返回最新行 */
+export function ensureEconomyAccount(query, playerId, playerName) {
+    const now = Date.now();
+    query(sql(`INSERT INTO ${TABLE_ACCOUNTS} (player_id, player_name_snapshot, balance, version, created_at, updated_at)
+       VALUES (?, ?, 0, 1, ?, ?)
+       ON CONFLICT(player_id) DO UPDATE SET
+         player_name_snapshot = excluded.player_name_snapshot,
+         updated_at = excluded.updated_at`, [String(playerId), String(playerName), now, now]));
+    const rows = query(sql(`SELECT * FROM ${TABLE_ACCOUNTS} WHERE player_id = ?`, [String(playerId)]));
+    if (Array.isArray(rows)) {
+        return rows[0];
+    }
+    return undefined;
+}
+/** 读取(必要时创建)账户业务视图 */
+export function getEconomyAccount(query, playerId, playerName = "") {
+    const row = ensureEconomyAccount(query, playerId, playerName);
+    return economyResult(row) ?? null;
+}
+/**
+ * 经济变更核心(无 BEGIN/COMMIT)。
+ * 纯 debit(仅 source)或纯 credit(仅 target)均可成功。
+ */
+export function applyEconomySteps(query, data) {
+    const amount = Number(data.amount);
+    const actorId = String(data.actor_id ?? data.actorId ?? "").trim();
+    if (!actorId || !Number.isSafeInteger(amount) || amount <= 0) {
+        return { ok: false, error: "invalid_amount", status: 400 };
+    }
+    const sourceId = data.source_player_id
+        ? String(data.source_player_id)
+        : data.sourcePlayerId
+            ? String(data.sourcePlayerId)
+            : null;
+    const targetId = data.target_player_id
+        ? String(data.target_player_id)
+        : data.targetPlayerId
+            ? String(data.targetPlayerId)
+            : null;
+    const idempotencyKey = String(data.idempotency_key ?? data.idempotencyKey ?? "").trim();
+    if (idempotencyKey && !isValidIdempotencyKey(idempotencyKey)) {
+        return { ok: false, error: "invalid_idempotency_key", status: 400 };
+    }
+    if (!sourceId && !targetId) {
+        return { ok: false, error: "missing_account", status: 400 };
+    }
+    if (sourceId && sourceId !== actorId) {
+        return { ok: false, error: "forbidden_source", status: 403 };
+    }
+    if (sourceId && targetId && sourceId === targetId) {
+        return { ok: false, error: "same_account", status: 400 };
+    }
+    // 幂等回放
+    if (idempotencyKey) {
+        const rows = query(sql(`SELECT response_json FROM ${TABLE_IDEMPOTENCY}
+         WHERE actor_id = ? AND idempotency_key = ?`, [actorId, idempotencyKey]));
+        const previous = Array.isArray(rows) ? rows[0] : undefined;
+        if (previous) {
+            return { ...JSON.parse(previous.response_json), replayed: true };
+        }
+    }
+    const source = sourceId ? ensureEconomyAccount(query, sourceId, String(data.sourcePlayerName ?? "")) : null;
+    const target = targetId ? ensureEconomyAccount(query, targetId, String(data.targetPlayerName ?? "")) : null;
+    if (sourceId && !source) {
+        return { ok: false, error: "source_not_found", status: 404 };
+    }
+    if (targetId && !target) {
+        return { ok: false, error: "target_not_found", status: 404 };
+    }
+    if (source && source.balance < amount) {
+        return { ok: false, error: "insufficient_funds", balance: source.balance, status: 409 };
+    }
+    const now = Date.now();
+    if (source) {
+        query(sql(`UPDATE ${TABLE_ACCOUNTS}
+         SET balance = balance - ?, version = version + 1, updated_at = ?
+         WHERE player_id = ? AND balance >= ?`, [amount, now, source.player_id, amount]));
+    }
+    if (target) {
+        query(sql(`UPDATE ${TABLE_ACCOUNTS}
+         SET balance = balance + ?, version = version + 1, updated_at = ?
+         WHERE player_id = ?`, [amount, now, target.player_id]));
+    }
+    const transactionType = String(data.transaction_type ?? data.type ?? "adjustment");
+    const referenceType = String(data.reference_type ?? data.referenceType ?? "");
+    const referenceId = String(data.reference_id ?? data.referenceId ?? "");
+    const reason = String(data.reason ?? data.reasonAlias ?? "");
+    const id = newTransactionId(now);
+    if (source) {
+        query(sql(`INSERT INTO ${TABLE_TRANSACTIONS}
+          (id, transaction_type, actor_id, source_player_id, target_player_id,
+           amount, balance_before, balance_after,
+           reference_type, reference_id, reason, created_at)
+         VALUES (?, ?, ?, ?, NULL, ?, ?, ?, ?, ?, ?, ?)`, [
+            id + "-dr",
+            transactionType + ".dr",
+            actorId,
+            sourceId,
+            amount,
+            source.balance,
+            source.balance - amount,
+            referenceType,
+            referenceId,
+            reason,
+            now,
+        ]));
+    }
+    if (target) {
+        query(sql(`INSERT INTO ${TABLE_TRANSACTIONS}
+          (id, transaction_type, actor_id, source_player_id, target_player_id,
+           amount, balance_before, balance_after,
+           reference_type, reference_id, reason, created_at)
+         VALUES (?, ?, ?, NULL, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+            id + "-cr",
+            transactionType + ".cr",
+            actorId,
+            targetId,
+            amount,
+            target.balance,
+            target.balance + amount,
+            referenceType,
+            referenceId,
+            reason,
+            now,
+        ]));
+    }
+    const sourceView = source ? economyResult(ensureEconomyAccount(query, source.player_id, "")) : undefined;
+    const targetView = target ? economyResult(ensureEconomyAccount(query, target.player_id, "")) : undefined;
+    const response = {
+        ok: true,
+        transactionId: id,
+        source: sourceView
+            ? { ...sourceView, balanceBefore: source.balance, balanceAfter: source.balance - amount }
+            : null,
+        target: targetView
+            ? { ...targetView, balanceBefore: target.balance, balanceAfter: target.balance + amount }
+            : null,
+    };
+    if (idempotencyKey) {
+        query(sql(`INSERT INTO ${TABLE_IDEMPOTENCY}
+          (actor_id, idempotency_key, transaction_id, response_json, created_at)
+         VALUES (?, ?, ?, ?, ?)`, [actorId, idempotencyKey, id, JSON.stringify(response), now]));
+    }
+    return response;
+}
+/**
+ * 独立经济事务包装。alreadyInTx=true 时复用外层事务(不再 BEGIN)。
+ */
+export function applyEconomyTransaction(query, db, data, opts) {
+    if (opts?.alreadyInTx) {
+        return applyEconomySteps(query, data);
+    }
+    db.exec("BEGIN IMMEDIATE");
+    try {
+        const result = applyEconomySteps(query, data);
+        if (!result.ok) {
+            db.exec("ROLLBACK");
+            return result;
+        }
+        db.exec("COMMIT");
+        return result;
+    }
+    catch (error) {
+        try {
+            db.exec("ROLLBACK");
+        }
+        catch {
+            /* ignore */
+        }
+        return {
+            ok: false,
+            error: error.message || "economy_transaction_failed",
+            status: 500,
+        };
+    }
+}
+/** 列出日常任务(默认仅 active 且未过期) */
+export function listDailyTasks(query, filter) {
+    const status = filter?.status ?? "active";
+    const now = Date.now();
+    if (filter?.includeExpired) {
+        const rows = query(sql(`SELECT * FROM ${TABLE_DAILY} WHERE status = ?`, [status]));
+        return Array.isArray(rows) ? rows : [];
+    }
+    const rows = query(sql(`SELECT * FROM ${TABLE_DAILY} WHERE status = ? AND expires_at > ?`, [status, now]));
+    return Array.isArray(rows) ? rows : [];
+}
+/** 日常任务提交核心(无 BEGIN) */
+export function submitDailyTaskSteps(query, data) {
+    const actorId = data.actorId;
+    const taskId = data.taskId;
+    const quantity = data.quantity;
+    const rows = query(sql(`SELECT * FROM ${TABLE_DAILY}
+       WHERE id = ? AND status = 'active' AND expires_at > ?`, [taskId, Date.now()]));
+    const task = rows[0];
+    if (!task) {
+        return { ok: false, error: "task_not_found_or_expired", status: 404 };
+    }
+    const targetQty = Number(task.target_qty ?? 0);
+    const filledQty = Number(task.filled_qty ?? 0);
+    const remaining = targetQty - filledQty;
+    if (remaining < quantity) {
+        return { ok: false, error: "task_quota_exceeded", status: 409, extra: { remaining } };
+    }
+    const reward = Number(task.unit_reward) * quantity;
+    query(sql(`UPDATE ${TABLE_DAILY} SET filled_qty = filled_qty + ? WHERE id = ?`, [quantity, taskId]));
+    const result = applyEconomySteps(query, {
+        actor_id: actorId,
+        transaction_type: "daily_task.reward",
+        target_player_id: actorId,
+        amount: reward,
+        reference_type: "daily_task",
+        reference_id: taskId,
+        reason: `提交任务 ${task.item_type}*${quantity}`,
+    });
+    if (!result.ok) {
+        return { ok: false, error: result.error, status: result.status };
+    }
+    const tgtFinal = economyResult(ensureEconomyAccount(query, actorId, ""));
+    return {
+        ok: true,
+        data: {
+            transactionId: result.transactionId,
+            reward,
+            balance: tgtFinal?.balance ?? 0,
+            balanceVersion: tgtFinal?.version ?? 0,
+        },
+    };
+}
+/** 日常任务提交包装(可独立事务或嵌入外层 tx) */
+export function submitDailyTaskTx(query, db, data, opts) {
+    if (opts?.alreadyInTx) {
+        return submitDailyTaskSteps(query, data);
+    }
+    db.exec("BEGIN IMMEDIATE");
+    try {
+        const result = submitDailyTaskSteps(query, data);
+        if (!result.ok) {
+            db.exec("ROLLBACK");
+            return result;
+        }
+        db.exec("COMMIT");
+        return result;
+    }
+    catch (error) {
+        try {
+            db.exec("ROLLBACK");
+        }
+        catch {
+            /* ignore */
+        }
+        return {
+            ok: false,
+            error: error.message || "task_submit_failed",
+            status: 500,
+        };
+    }
+}
+/** 月度/全局经济白皮书(优先读 sfmc_economy_stats,否则现场聚合) */
+export function monthlyEconomyStats(query) {
+    const now = new Date();
+    const id = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}`;
+    const cached = query(sql(`SELECT * FROM ${TABLE_STATS} WHERE id = ? OR id = ?`, ["global", id]));
+    if (Array.isArray(cached) && cached.length > 0) {
+        const row = cached[0];
+        return {
+            id: String(row.id ?? id),
+            total_issued: Number(row.total_issued ?? 0),
+            total_destroyed: Number(row.total_destroyed ?? 0),
+            total_supply: Number(row.total_supply ?? 0),
+            active_accounts: Number(row.active_accounts ?? 0),
+        };
+    }
+    const supplyRows = query(sql(`SELECT COALESCE(SUM(balance),0) AS total_supply, COUNT(*) AS active_accounts FROM ${TABLE_ACCOUNTS}`));
+    const supply = Array.isArray(supplyRows) ? supplyRows[0] : {};
+    const issuedRows = query(sql(`SELECT COALESCE(SUM(amount),0) AS total FROM ${TABLE_TRANSACTIONS} WHERE target_player_id IS NOT NULL`));
+    const destroyedRows = query(sql(`SELECT COALESCE(SUM(amount),0) AS total FROM ${TABLE_TRANSACTIONS} WHERE source_player_id IS NOT NULL`));
+    const issued = Array.isArray(issuedRows) ? Number(issuedRows[0].total ?? 0) : 0;
+    const destroyed = Array.isArray(destroyedRows)
+        ? Number(destroyedRows[0].total ?? 0)
+        : 0;
+    return {
+        id,
+        total_issued: issued,
+        total_destroyed: destroyed,
+        total_supply: Number(supply.total_supply ?? 0),
+        active_accounts: Number(supply.active_accounts ?? 0),
+    };
+}
+//# sourceMappingURL=economy.js.map