@sfmc-bds/db-server 0.1.0 → 0.2.0-beta.1

package/README.md

@@ -9,7 +9,7 @@ npm install @sfmc-bds/db-server
 node node_modules/@sfmc-bds/db-server/dist/index.js
 ```
 
-通常由 `@sfmc-bds/cli` 或 SEA 包统一拉起，无需单独安装。
+通常由 `@sfmc-bds/sfmc` / `@sfmc-bds/cli` 统一拉起，无需单独安装。
 
 ## 依赖
 

package/dist/db-tables.js

@@ -1,15 +1,7 @@
-/**
- * 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 */ `
+function createPlatformTables(db) {
+  db.exec(
+    /* sql */
+    `
     CREATE TABLE IF NOT EXISTS sfmc__audit (
       id INTEGER PRIMARY KEY AUTOINCREMENT,
       module_id TEXT NOT NULL,
@@ -19,9 +11,12 @@ export function createPlatformTables(db) {
       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 */ `
+  `
+  );
+  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,
@@ -30,6 +25,10 @@ export function createPlatformTables(db) {
       created_at TEXT NOT NULL,
       PRIMARY KEY (module_id, action, key)
     )
-  `);
+  `
+  );
 }
-//# sourceMappingURL=db-tables.js.map
+export {
+  createPlatformTables
+};
+//# sourceMappingURL=db-tables.js.map

package/dist/db-tables.js.map

@@ -1 +1,7 @@
-{"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"}
+{
+  "version": 3,
+  "sources": ["../src/db-tables.ts"],
+  "sourcesContent": ["/**\n * db-tables.ts \u2014 \u5E73\u53F0\u81EA\u5E26\u6570\u636E\u5E93\u8868 bootstrap\n *\n * \u5E73\u53F0\u8868(\u4E0D\u662F\u6A21\u5757\u58F0\u660E\u7684):\n *   - sfmc__audit        \u2014 db.audit() \u81EA\u52A8\u5199\u5165\n *   - sfmc__idempotent   \u2014 db.idempotent() probe/commit \u7528\n *\n * \u4E1A\u52A1\u8868(land / economy / coops / redpacket / ...)\u7684 DDL \u4E0D\u5728\u8FD9\u91CC;\n * \u5B83\u4EEC\u7531\u5404\u81EA\u6A21\u5757\u5728 init() \u8C03 db.defineTable() \u58F0\u660E,schema-registry \u7EDF\u4E00\u5EFA\u8868\u3002\n */\n\nimport type { DatabaseSync } from \"node:sqlite\";\n\nexport function createPlatformTables(db: DatabaseSync): void {\n  db.exec(/* sql */ `\n    CREATE TABLE IF NOT EXISTS sfmc__audit (\n      id INTEGER PRIMARY KEY AUTOINCREMENT,\n      module_id TEXT NOT NULL,\n      table_name TEXT NOT NULL,\n      row_id TEXT NOT NULL,\n      action TEXT NOT NULL,\n      data TEXT,\n      created_at TEXT NOT NULL\n    )\n  `);\n  db.exec(`CREATE INDEX IF NOT EXISTS idx_sfmc__audit_module_table ON sfmc__audit(module_id, table_name)`);\n\n  db.exec(/* sql */ `\n    CREATE TABLE IF NOT EXISTS sfmc__idempotent (\n      module_id TEXT NOT NULL,\n      action TEXT NOT NULL,\n      key TEXT NOT NULL,\n      value TEXT,\n      created_at TEXT NOT NULL,\n      PRIMARY KEY (module_id, action, key)\n    )\n  `);\n}\n"],
+  "mappings": "AAaO,SAAS,qBAAqB,IAAwB;AAC3D,KAAG;AAAA;AAAA,IAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUjB;AACD,KAAG,KAAK,+FAA+F;AAEvG,KAAG;AAAA;AAAA,IAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASjB;AACH;",
+  "names": []
+}

package/dist/domain/bridge.js

@@ -1,82 +1,59 @@
-/**
- * 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]",
-    };
+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;
+function forwardToQQBridge(config, channelId, fromName, content, fromId) {
+  if (!config.groupId || config.groupId === "0") {
+    log.warn(`QQ \u7FA4\u672A\u914D\u7F6E (qq_group_id),\u8DF3\u8FC7 MC\u2192QQ \u8F6C\u53D1 (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 \u2192 ${res.statusCode}: ${String(body).slice(0, 200)} (from=${fromId}, channel=${channelId})`
+          );
+        }
+      });
     }
-    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();
+  );
+  req.on("error", (err) => {
+    log.warn(`LLBot \u4E0D\u53EF\u8FBE (${config.host}:${config.port}): ${err.message}`);
+  });
+  req.write(payload);
+  req.end();
 }
-//# sourceMappingURL=bridge.js.map
+export {
+  forwardToQQBridge,
+  makeLLBotConfig
+};
+//# sourceMappingURL=bridge.js.map

package/dist/domain/bridge.js.map

@@ -1 +1,7 @@
-{"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"}
+{
+  "version": 3,
+  "sources": ["../../src/domain/bridge.ts"],
+  "sourcesContent": ["/**\n * domain/bridge.ts \u2014 MC \u2192 QQ \u6865\u63A5\n *\n * db-server \u6536\u5230 SAPI \u4E0A\u62A5\u7684\u6D88\u606F\u540E,\u76F4\u63A5\u8C03 LLBot HTTP `/send_group_msg`\n * \u628A\u6D88\u606F\u8F6C\u53D1\u5230 QQ \u7FA4\u3002\u4E0D\u518D\u8D70\u4E2D\u95F4 qq-bridge \u8FDB\u7A0B\u3002\n *\n * \u6570\u636E\u6D41:\n *   SAPI \u2500\u2500POST\u2500\u2500\u2192 db-server:3001/api/sfmc/messages\n *                   \u2514\u2500 \u5199\u5E93 + forwardToQQBridge() \u2500\u2500HTTP\u2500\u2500\u2192 LLBot:3004/send_group_msg\n *\n * \u4E8B\u52A1\u63CF\u8FF0:\n *   - \u65E0 DB \u4E8B\u52A1(\u672C\u6587\u4EF6\u4E0D\u64CD\u4F5C SQLite,\u53EA\u505A HTTP \u51FA\u7AD9\u8F6C\u53D1)\n *\n * \u9886\u57DF\u51FD\u6570:\n *   - makeLLBotConfig(env)  \u5DE5\u5382:\u4ECE env \u6784\u9020 LLBotConfig\n *   - forwardToQQBridge()   \u8F6C\u53D1\u5355\u6761 MC \u6D88\u606F\u5230 LLBot;\u5931\u8D25\u4EC5 warn,\u4E0D\u629B\u9519\n */\n\nimport { request } from \"node:http\";\n\nimport { log } from \"../lib/log.js\";\n\ntype LLBotConfig = {\n  host: string;\n  port: number;\n  token: string;\n  groupId: string;\n  prefix: string;\n};\n\n/**\n * \u6784\u9020 LLBotConfig\u3002\u5141\u8BB8\u663E\u5F0F\u4F20\u5165(\u6D4B\u8BD5),\u9ED8\u8BA4\u4ECE env \u63A8\u4E0D\u51FA,\n * \u6240\u4EE5\u8C03\u7528\u65B9\u9700\u81EA\u5DF1\u628A env \u91CC\u8BFB\u5230\u7684\u503C\u4F20\u8FDB\u6765\u3002\n */\nexport function makeLLBotConfig(env: {\n  LLBOT_HOST: string;\n  LLBOT_PORT: number;\n  LLBOT_TOKEN: string;\n  QQ_GROUP_ID: string;\n}): LLBotConfig {\n  return {\n    host: env.LLBOT_HOST,\n    port: env.LLBOT_PORT,\n    token: env.LLBOT_TOKEN,\n    groupId: env.QQ_GROUP_ID,\n    prefix: \"[MC]\",\n  };\n}\n\n/**\n * @description\n * @author Shiroha7z\n * @date 17/07/2026\n * @export\n * @param {LLBotConfig} config LLBot \u8FDE\u63A5\u4FE1\u606F(host/port/token/groupId/prefix)\n * @param {string} channelId   MC \u9891\u9053 ID(\u7528\u4E8E\u8FC7\u6EE4 / \u6807\u8BB0,\u76EE\u524D\u4EC5\u505A\u65E5\u5FD7)\n * @param {string} fromName    MC \u73A9\u5BB6\u540D\n * @param {string} content     \u6D88\u606F\u6B63\u6587\n * @param {string} fromId      MC \u73A9\u5BB6 ID\n */\nexport function forwardToQQBridge(\n  config: LLBotConfig,\n  channelId: string,\n  fromName: string,\n  content: string,\n  fromId: string\n): void {\n  if (!config.groupId || config.groupId === \"0\") {\n    log.warn(`QQ \u7FA4\u672A\u914D\u7F6E (qq_group_id),\u8DF3\u8FC7 MC\u2192QQ \u8F6C\u53D1 (channel=${channelId})`);\n    return;\n  }\n\n  const text = `${config.prefix} ${fromName}: ${content}`;\n  const payload = JSON.stringify({\n    group_id: parseInt(config.groupId, 10),\n    message: [{ type: \"text\", data: { text } }],\n  });\n\n  const headers: Record<string, string | number> = {\n    \"Content-Type\": \"application/json\",\n    \"Content-Length\": Buffer.byteLength(payload),\n  };\n  if (config.token) {\n    headers[\"Authorization\"] = `Bearer ${config.token}`;\n  }\n\n  const req = request(\n    {\n      hostname: config.host,\n      port: config.port,\n      path: \"/send_group_msg\",\n      method: \"POST\",\n      headers,\n    },\n    (res) => {\n      let body = \"\";\n      res.on(\"data\", (c) => (body += c));\n      res.on(\"end\", () => {\n        if (res.statusCode !== 200) {\n          log.warn(\n            `LLBot send_group_msg \u2192 ${res.statusCode}: ${String(body).slice(0, 200)} (from=${fromId}, channel=${channelId})`\n          );\n        }\n      });\n    }\n  );\n  req.on(\"error\", (err) => {\n    log.warn(`LLBot \u4E0D\u53EF\u8FBE (${config.host}:${config.port}): ${err.message}`);\n  });\n  req.write(payload);\n  req.end();\n}\n"],
+  "mappings": "AAkBA,SAAS,eAAe;AAExB,SAAS,WAAW;AAcb,SAAS,gBAAgB,KAKhB;AACd,SAAO;AAAA,IACL,MAAM,IAAI;AAAA,IACV,MAAM,IAAI;AAAA,IACV,OAAO,IAAI;AAAA,IACX,SAAS,IAAI;AAAA,IACb,QAAQ;AAAA,EACV;AACF;AAaO,SAAS,kBACd,QACA,WACA,UACA,SACA,QACM;AACN,MAAI,CAAC,OAAO,WAAW,OAAO,YAAY,KAAK;AAC7C,QAAI,KAAK,2FAA8C,SAAS,GAAG;AACnE;AAAA,EACF;AAEA,QAAM,OAAO,GAAG,OAAO,MAAM,IAAI,QAAQ,KAAK,OAAO;AACrD,QAAM,UAAU,KAAK,UAAU;AAAA,IAC7B,UAAU,SAAS,OAAO,SAAS,EAAE;AAAA,IACrC,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,EAAE,KAAK,EAAE,CAAC;AAAA,EAC5C,CAAC;AAED,QAAM,UAA2C;AAAA,IAC/C,gBAAgB;AAAA,IAChB,kBAAkB,OAAO,WAAW,OAAO;AAAA,EAC7C;AACA,MAAI,OAAO,OAAO;AAChB,YAAQ,eAAe,IAAI,UAAU,OAAO,KAAK;AAAA,EACnD;AAEA,QAAM,MAAM;AAAA,IACV;AAAA,MACE,UAAU,OAAO;AAAA,MACjB,MAAM,OAAO;AAAA,MACb,MAAM;AAAA,MACN,QAAQ;AAAA,MACR;AAAA,IACF;AAAA,IACA,CAAC,QAAQ;AACP,UAAI,OAAO;AACX,UAAI,GAAG,QAAQ,CAAC,MAAO,QAAQ,CAAE;AACjC,UAAI,GAAG,OAAO,MAAM;AAClB,YAAI,IAAI,eAAe,KAAK;AAC1B,cAAI;AAAA,YACF,+BAA0B,IAAI,UAAU,KAAK,OAAO,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,UAAU,MAAM,aAAa,SAAS;AAAA,UAC/G;AAAA,QACF;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AACA,MAAI,GAAG,SAAS,CAAC,QAAQ;AACvB,QAAI,KAAK,6BAAc,OAAO,IAAI,IAAI,OAAO,IAAI,MAAM,IAAI,OAAO,EAAE;AAAA,EACtE,CAAC;AACD,MAAI,MAAM,OAAO;AACjB,MAAI,IAAI;AACV;",
+  "names": []
+}

package/dist/domain/economy.d.ts

@@ -8,12 +8,56 @@
  *   - applyEconomySteps / submitDailyTaskSteps — 无 BEGIN/COMMIT,可嵌进外层 db.tx
  *   - applyEconomyTransaction / submitDailyTaskTx — 独立调用时自己开事务;
  *     alreadyInTx=true 时只跑 steps
+ *
+ * 行类型在此本地定义（平台不依赖业务模块包；权威副本在 sfmc-modules/packages/economy）。
  */
-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 };
+/**
+ * 经济域行模型（原 SDK contracts/economy；契约内聚到表所有者 db-server）。
+ * 业务模块应通过 service(economy.*) 消费视图，不依赖这些内部行类型。
+ */
+export interface EconomyAccountRow {
+    player_id: string;
+    player_name_snapshot: string;
+    balance: number;
+    version: number;
+    created_at: number;
+    updated_at: number;
+}
+/** 幂等键表行 */
+export interface EconomyIdempotencyRow {
+    actor_id: string;
+    idempotency_key: string;
+    transaction_id: string;
+    response_json: string;
+    created_at: number;
+}
+/** 流水表行 */
+export interface EconomyTransactionRow {
+    id: string;
+    transaction_type: string;
+    actor_id: string;
+    source_player_id?: string;
+    target_player_id?: string;
+    amount: number;
+    balance_before?: number;
+    balance_after?: number;
+    reference_type: string;
+    reference_id: string;
+    reason: string;
+    created_at: number;
+    idempotency_key: string;
+    /** JS-side alias fields used by domain/economy.ts */
+    actorId?: string;
+    type?: string;
+    referenceType?: string;
+    referenceId?: string;
+    sourcePlayerName?: string;
+    targetPlayerName?: string;
+}
 /** query 兼容格式：string / SQLStatement / { sql, values } */
 export type AnyQuery = (sql: string | SQLStatement | {
     sql: string;
@@ -21,6 +65,44 @@ export type AnyQuery = (sql: string | SQLStatement | {
 }, values?: unknown[]) => unknown[] | {
     changes: number | bigint;
 };
+/**
+ * 经济账户 DB 行（snake_case，对应 sfmc_economy_accounts）。
+ * 业务域类型由本模块维护，不再依赖 sdk/contracts。
+ */
+export interface EconomyAccountRow {
+    player_id: string;
+    player_name_snapshot: string;
+    balance: number;
+    version: number;
+    created_at: number;
+    updated_at: number;
+}
+/**
+ * 经济交易流水 DB 行（snake_case，对应 sfmc_economy_transactions）。
+ * 含历史 JS 侧别名字段，供调用方兼容读取。
+ */
+export interface EconomyTransactionRow {
+    id: string;
+    transaction_type: string;
+    actor_id: string;
+    source_player_id?: string;
+    target_player_id?: string;
+    amount: number;
+    balance_before?: number;
+    balance_after?: number;
+    reference_type: string;
+    reference_id: string;
+    reason: string;
+    created_at: number;
+    idempotency_key: string;
+    /** JS-side alias fields used by domain/economy.ts */
+    actorId?: string;
+    type?: string;
+    referenceType?: string;
+    referenceId?: string;
+    sourcePlayerName?: string;
+    targetPlayerName?: string;
+}
 export interface EconomyAccountView {
     playerId: string;
     playerName: string;
@@ -82,7 +164,6 @@ export declare function applyEconomySteps(query: AnyQuery, data: ApplyEconomyInp
 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;

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

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