trustbase-seller-backend 0.1.5

package/db/store-migrate.js

@@ -0,0 +1,149 @@
+"use strict";
+/**
+ * TrustChain Store API — Migration runner (baobei 8/23 20:25 SGT lane 实战锁版)
+ *
+ * 设计要点:
+ * - 读 src/db/store-migrations.sql (exec 整个文件, sqlite 多语句 OK)
+ * - 幂等 (可重跑): CREATE IF NOT EXISTS / CREATE UNIQUE INDEX IF NOT EXISTS
+ * - Lesson #266a fail loud: 启动失败抛错, 不静默
+ *
+ * @see src/db/store-migrations.sql
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runStoreMigrations = runStoreMigrations;
+exports.isStoreSchemaReady = isStoreSchemaReady;
+exports.getStoreSchemaVersion = getStoreSchemaVersion;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const MIGRATIONS_FILE = path.join(__dirname, 'store-migrations.sql');
+/**
+ * 跑 store migrations (8 表 + schema_version)
+ *
+ * @param db better-sqlite3 Database 实例
+ * @returns StoreMigrationResult
+ * @throws Error if migration 失败 (Lesson #266a fail loud)
+ */
+function runStoreMigrations(db) {
+    if (!db) {
+        throw new Error('[StoreMigrate] db required');
+    }
+    if (!fs.existsSync(MIGRATIONS_FILE)) {
+        throw new Error(`[StoreMigrate] migrations file not found: ${MIGRATIONS_FILE}`);
+    }
+    const sql = fs.readFileSync(MIGRATIONS_FILE, 'utf8');
+    // 判断 fresh install (store_products 不存在 = fresh)
+    const productsExists = db
+        .prepare(`SELECT name FROM sqlite_master WHERE type='table' AND name='store_products'`)
+        .get();
+    const freshInstall = !productsExists;
+    try {
+        db.exec(sql);
+    }
+    catch (e) {
+        const msg = e?.message || String(e);
+        throw new Error(`[StoreMigrate] exec failed: ${msg}`);
+    }
+    // 2026-09-08 kimi v0.4: store_products ↔ 链上状态关联 6 列 (Lesson #NEW84:
+    // ALTER 走 start() 流程, 不进 CREATE TABLE; store_products 由本函数建在
+    // run-unified start 流程里, 所以 ALTER 也放这里 — sqlite.ts start() 跑时
+    // store_products 可能还不存在, 放那边会静默跳过永远不补列)。
+    // 每列独立 try/catch: 已存在则跳过, 幂等可重跑。
+    const alterStatements = [
+        `ALTER TABLE store_products ADD COLUMN chain_sku_id TEXT`,
+        `ALTER TABLE store_products ADD COLUMN chain_slot_index INTEGER`,
+        `ALTER TABLE store_products ADD COLUMN chain_listed INTEGER NOT NULL DEFAULT 0`,
+        `ALTER TABLE store_products ADD COLUMN chain_listed_at INTEGER`,
+        `ALTER TABLE store_products ADD COLUMN chain_tx_hash TEXT`,
+        `ALTER TABLE store_products ADD COLUMN chain_stake_per_unit INTEGER`,
+    ];
+    for (const stmt of alterStatements) {
+        try {
+            db.exec(stmt);
+        }
+        catch (_) { /* exists */ }
+    }
+    return {
+        appliedAt: Date.now(),
+        freshInstall,
+        error: null,
+    };
+}
+/**
+ * 检查 store schema 是否就绪 (用于健康检查)
+ */
+function isStoreSchemaReady(db) {
+    try {
+        const tables = [
+            'store_products',
+            'store_orders',
+            'store_earnings',
+            'store_reputation',
+            'store_reviews',
+            'store_cart',
+            'store_settings',
+            'store_payouts',
+            'storefront_users',
+            'oauth_bridge_sessions',
+            'store_schema_version',
+        ];
+        for (const t of tables) {
+            const row = db
+                .prepare(`SELECT name FROM sqlite_master WHERE type='table' AND name=?`)
+                .get(t);
+            if (!row)
+                return false;
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 获取当前 store schema version
+ */
+function getStoreSchemaVersion(db) {
+    try {
+        const row = db
+            .prepare(`SELECT MAX(version) AS v FROM store_schema_version`)
+            .get();
+        return row?.v ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=store-migrate.js.map

package/db/store-migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-migrate.js","sourceRoot":"","sources":["../../src/db/store-migrate.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqBH,gDAgDC;AAKD,gDAyBC;AAKD,sDASC;AA9GD,uCAAyB;AACzB,2CAA6B;AAE7B,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAAC;AAQrE;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAAC,EAAqB;IACtD,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,6CAA6C,eAAe,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IAErD,gDAAgD;IAChD,MAAM,cAAc,GAAG,EAAE;SACtB,OAAO,CAAC,6EAA6E,CAAC;SACtF,GAAG,EAAE,CAAC;IACT,MAAM,YAAY,GAAG,CAAC,cAAc,CAAC;IAErC,IAAI,CAAC;QACH,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,+BAA+B,GAAG,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,oEAAoE;IACpE,6DAA6D;IAC7D,8DAA8D;IAC9D,yCAAyC;IACzC,iCAAiC;IACjC,MAAM,eAAe,GAAG;QACtB,yDAAyD;QACzD,gEAAgE;QAChE,+EAA+E;QAC/E,+DAA+D;QAC/D,0DAA0D;QAC1D,oEAAoE;KACrE,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,YAAY;QACZ,KAAK,EAAE,IAAI;KACZ,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,EAAqB;IACtD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG;YACb,gBAAgB;YAChB,cAAc;YACd,gBAAgB;YAChB,kBAAkB;YAClB,eAAe;YACf,YAAY;YACZ,gBAAgB;YAChB,eAAe;YACf,kBAAkB;YAClB,uBAAuB;YACvB,sBAAsB;SACvB,CAAC;QACF,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,EAAE;iBACX,OAAO,CAAC,8DAA8D,CAAC;iBACvE,GAAG,CAAC,CAAC,CAAC,CAAC;YACV,IAAI,CAAC,GAAG;gBAAE,OAAO,KAAK,CAAC;QACzB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,EAAqB;IACzD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE;aACX,OAAO,CAAC,oDAAoD,CAAC;aAC7D,GAAG,EAAsC,CAAC;QAC7C,OAAO,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/db/store-migrations.sql

@@ -0,0 +1,242 @@
+-- TrustChain Store API DB Schema (baobei 8/23 20:25 SGT lane 实战锁版)
+-- Lesson #335 三处一致: 链上 emit + indexer DB + API response 共用字段
+-- Lesson #266a fail loud: 启动失败抛错, 不 || true 吞掉
+-- Lesson #308 5 头鉴权: 所有 seller endpoint 走 wallet signature
+-- Lesson #266b cosmos-sdk GetSigners 实战: 关键操作 chain-side verify
+
+-- ============================================================
+-- 1. products (商家商品主表, 15 字段)
+-- ============================================================
+CREATE TABLE IF NOT EXISTS store_products (
+  id              TEXT PRIMARY KEY,                  -- uuid v4
+  seller_address  TEXT NOT NULL,                      -- 商家链上地址 (tct1...)
+  title           TEXT NOT NULL,                      -- 商品标题
+  description     TEXT NOT NULL DEFAULT '',           -- 商品描述
+  price_utct      INTEGER NOT NULL,                   -- 1 TCT = 1_000_000 utct, 整数 (Lesson #335 链上原生)
+  stock           INTEGER NOT NULL DEFAULT 0,         -- 库存
+  status          TEXT NOT NULL DEFAULT 'draft'       -- draft | active | out_of_stock | archived
+                  CHECK (status IN ('draft','active','out_of_stock','archived')),
+  category        TEXT NOT NULL DEFAULT 'general',   -- 分类
+  image_url       TEXT,                                -- 主图 URL (optional)
+  tags            TEXT NOT NULL DEFAULT '[]',         -- JSON array string
+  featured        INTEGER NOT NULL DEFAULT 0,         -- 0/1 是否推荐 (前台 featured 接口用)
+  sales_count     INTEGER NOT NULL DEFAULT 0,         -- 累计销量
+  created_at      INTEGER NOT NULL,                   -- ms
+  updated_at      INTEGER NOT NULL                    -- ms
+);
+
+CREATE INDEX IF NOT EXISTS idx_store_products_seller
+  ON store_products (seller_address, status, created_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_store_products_status_featured
+  ON store_products (status, featured, sales_count DESC)
+  WHERE status = 'active';
+
+CREATE INDEX IF NOT EXISTS idx_store_products_category
+  ON store_products (category, status, created_at DESC)
+  WHERE status = 'active';
+
+-- ============================================================
+-- 2. orders (订单主表, 18 字段)
+-- ============================================================
+CREATE TABLE IF NOT EXISTS store_orders (
+  id                TEXT PRIMARY KEY,                -- uuid v4
+  buyer_address     TEXT NOT NULL,                    -- 买家链上地址
+  seller_address    TEXT NOT NULL,                    -- 商家链上地址
+  items_json        TEXT NOT NULL,                    -- JSON 快照 OrderItem[]
+  total_utct        INTEGER NOT NULL,                 -- 订单总额 utct
+  status            TEXT NOT NULL DEFAULT 'created'   -- created|paid|shipped|completed|cancelled|disputed|refunded
+                    CHECK (status IN ('created','paid','shipped','completed','cancelled','disputed','refunded')),
+  shipping_address  TEXT,                              -- 收货地址
+  tracking_number   TEXT,                              -- 物流单号
+  paid_at           INTEGER,                           -- 支付时间
+  shipped_at        INTEGER,                           -- 发货时间
+  completed_at      INTEGER,                           -- 完成时间
+  cancelled_at      INTEGER,                           -- 取消时间
+  dispute_reason    TEXT,                              -- 申诉原因
+  paid_tx_hash      TEXT,                              -- 链上 tx_hash (Lesson #266b 实战)
+  created_at        INTEGER NOT NULL,
+  updated_at        INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_store_orders_buyer
+  ON store_orders (buyer_address, status, created_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_store_orders_seller
+  ON store_orders (seller_address, status, created_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_store_orders_status
+  ON store_orders (status, created_at DESC);
+
+-- ============================================================
+-- 3. earnings (收益表, 10 字段)
+-- ============================================================
+CREATE TABLE IF NOT EXISTS store_earnings (
+  id              TEXT PRIMARY KEY,
+  seller_address  TEXT NOT NULL,
+  order_id        TEXT NOT NULL,
+  amount_utct     INTEGER NOT NULL,                   -- 订单总金额
+  fee_utct        INTEGER NOT NULL DEFAULT 0,         -- 平台手续费
+  net_utct        INTEGER NOT NULL,                   -- 商家净额 (amount - fee)
+  payout_id       TEXT,                                -- 关联 payout (提现后)
+  payout_status   TEXT NOT NULL DEFAULT 'pending'     -- pending|paid_out
+                  CHECK (payout_status IN ('pending','paid_out')),
+  created_at      INTEGER NOT NULL,
+  updated_at      INTEGER NOT NULL,
+  FOREIGN KEY (order_id) REFERENCES store_orders(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_store_earnings_seller
+  ON store_earnings (seller_address, payout_status, created_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_store_earnings_order
+  ON store_earnings (order_id);
+
+-- ============================================================
+-- 4. reputation (商家信誉表, 8 字段)
+-- ============================================================
+CREATE TABLE IF NOT EXISTS store_reputation (
+  seller_address    TEXT PRIMARY KEY,                -- 一商家一行
+  rating_avg        REAL NOT NULL DEFAULT 0,         -- 1.0-5.0
+  review_count      INTEGER NOT NULL DEFAULT 0,
+  positive_count    INTEGER NOT NULL DEFAULT 0,      -- rating >= 4
+  dispute_count     INTEGER NOT NULL DEFAULT 0,
+  completed_orders  INTEGER NOT NULL DEFAULT 0,
+  badge             TEXT NOT NULL DEFAULT 'new'      -- new|bronze|silver|gold|platinum
+                    CHECK (badge IN ('new','bronze','silver','gold','platinum')),
+  updated_at        INTEGER NOT NULL
+);
+
+-- ============================================================
+-- 5. reviews (评价表, 12 字段)
+-- ============================================================
+CREATE TABLE IF NOT EXISTS store_reviews (
+  id              TEXT PRIMARY KEY,
+  order_id        TEXT NOT NULL,
+  seller_address  TEXT NOT NULL,
+  buyer_address   TEXT NOT NULL,
+  rating          INTEGER NOT NULL                   -- 1|2|3|4|5
+                  CHECK (rating IN (1,2,3,4,5)),
+  content         TEXT NOT NULL DEFAULT '',
+  reply           TEXT,                              -- 商家回复 (可空)
+  reply_at        INTEGER,                           -- 回复时间
+  hidden          INTEGER NOT NULL DEFAULT 0,        -- 0/1 隐藏 (违规等)
+  created_at      INTEGER NOT NULL,
+  updated_at      INTEGER NOT NULL,
+  UNIQUE (order_id, buyer_address),                  -- 一单一评
+  FOREIGN KEY (order_id) REFERENCES store_orders(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_store_reviews_seller
+  ON store_reviews (seller_address, created_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_store_reviews_buyer
+  ON store_reviews (buyer_address, created_at DESC);
+
+-- ============================================================
+-- 6. cart (购物车表, 6 字段)
+-- ============================================================
+CREATE TABLE IF NOT EXISTS store_cart (
+  id                    TEXT PRIMARY KEY,
+  user_id               TEXT NOT NULL,               -- 前台用户 id
+  product_id            TEXT NOT NULL,
+  quantity              INTEGER NOT NULL DEFAULT 1,
+  snapshot_title        TEXT NOT NULL,               -- 加入时快照 (商品改名不影响 cart)
+  snapshot_price_utct   INTEGER NOT NULL,
+  snapshot_image_url    TEXT,
+  created_at            INTEGER NOT NULL,
+  updated_at            INTEGER NOT NULL,
+  UNIQUE (user_id, product_id),                       -- 同 product 自动 upsert
+  FOREIGN KEY (product_id) REFERENCES store_products(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_store_cart_user
+  ON store_cart (user_id, created_at DESC);
+
+-- ============================================================
+-- 7. settings (商家设置表, 10 字段)
+-- ============================================================
+CREATE TABLE IF NOT EXISTS store_settings (
+  seller_address    TEXT PRIMARY KEY,
+  shop_name         TEXT NOT NULL DEFAULT '',
+  shop_description  TEXT NOT NULL DEFAULT '',
+  shop_logo_url     TEXT,
+  contact_email     TEXT,
+  contact_phone     TEXT,
+  shipping_policy   TEXT,
+  return_policy     TEXT,
+  auto_accept_orders INTEGER NOT NULL DEFAULT 0,     -- 0/1
+  status            TEXT NOT NULL DEFAULT 'active'    -- pending|active|suspended|closed
+                    CHECK (status IN ('pending','active','suspended','closed')),
+  registered_at     INTEGER,
+  updated_at        INTEGER NOT NULL
+);
+
+-- ============================================================
+-- 8. payouts (提现记录表, 9 字段)
+-- ============================================================
+CREATE TABLE IF NOT EXISTS store_payouts (
+  id              TEXT PRIMARY KEY,
+  seller_address  TEXT NOT NULL,
+  amount_utct     INTEGER NOT NULL,
+  to_address      TEXT NOT NULL,
+  status          TEXT NOT NULL DEFAULT 'pending'    -- pending|processing|completed|failed
+                  CHECK (status IN ('pending','processing','completed','failed')),
+  tx_hash         TEXT,                              -- 链上提现 tx (Lesson #266b)
+  failure_reason  TEXT,
+  requested_at    INTEGER NOT NULL,
+  completed_at    INTEGER
+);
+
+CREATE INDEX IF NOT EXISTS idx_store_payouts_seller
+  ON store_payouts (seller_address, status, requested_at DESC);
+
+-- ============================================================
+-- 9. storefront_users (前台用户表, 8 字段)
+-- ============================================================
+CREATE TABLE IF NOT EXISTS storefront_users (
+  id                  TEXT PRIMARY KEY,
+  chain_address       TEXT UNIQUE NOT NULL,
+  display_name        TEXT NOT NULL DEFAULT '',
+  email               TEXT,
+  avatar_url          TEXT,
+  oauth_platforms     TEXT NOT NULL DEFAULT '[]',   -- JSON array
+  last_login_at       INTEGER,
+  created_at          INTEGER NOT NULL,
+  updated_at          INTEGER NOT NULL
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_storefront_users_chain
+  ON storefront_users (chain_address);
+
+-- ============================================================
+-- 10. oauth_bridge_sessions (OAuth 桥接会话表, 6 字段)
+-- ============================================================
+CREATE TABLE IF NOT EXISTS oauth_bridge_sessions (
+  id                TEXT PRIMARY KEY,
+  user_id           TEXT NOT NULL,
+  chain_address     TEXT NOT NULL,
+  platform          TEXT NOT NULL CHECK (platform IN ('wechat','alipay','douyin')),
+  platform_openid   TEXT NOT NULL,
+  access_token      TEXT NOT NULL,
+  refresh_token     TEXT NOT NULL UNIQUE,
+  expires_at        INTEGER NOT NULL,
+  created_at        INTEGER NOT NULL,
+  revoked           INTEGER NOT NULL DEFAULT 0
+);
+
+CREATE INDEX IF NOT EXISTS idx_oauth_bridge_sessions_user
+  ON oauth_bridge_sessions (user_id, revoked);
+
+-- ============================================================
+-- 11. schema version (migration 追踪)
+-- ============================================================
+CREATE TABLE IF NOT EXISTS store_schema_version (
+  version       INTEGER PRIMARY KEY,
+  description   TEXT NOT NULL,
+  applied_at    INTEGER NOT NULL
+);
+
+INSERT OR IGNORE INTO store_schema_version (version, description, applied_at)
+VALUES (1, 'Initial store API: products + orders + earnings + reputation + reviews + cart + settings + payouts + storefront_users + oauth_bridge_sessions',
+        CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER));

package/debug.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=debug.d.ts.map

package/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../src/debug.ts"],"names":[],"mappings":""}

package/debug.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// Check what events block 91 actually has
+fetch('http://localhost:26657/block_results?height=91')
+    .then(r => r.json())
+    .then((d) => {
+    const txs = d.result?.txs_results || [];
+    console.log(`Block 91: ${txs.length} txs`);
+    for (const tx of txs) {
+        for (const e of (tx.events || [])) {
+            console.log(`\nEvent type: "${e.type}"`);
+            for (const a of (e.attributes || [])) {
+                console.log(`  key="${a.key}" value="${a.value}"`);
+            }
+        }
+    }
+});
+//# sourceMappingURL=debug.js.map

package/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../src/debug.ts"],"names":[],"mappings":";;AAEA,0CAA0C;AAC1C,KAAK,CAAC,gDAAgD,CAAC;KACpD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;KACnB,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE;IACf,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,WAAW,IAAI,EAAE,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IAC3C,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,KAAK,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;YACzC,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC;gBACrC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC,CAAC,CAAC"}

package/event-listener.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Indexer Event Listener v0.2 — 事件白名单过滤 + 路由 (baobei #16143 实战)
+ *
+ * 原则 (Lesson #335):
+ * 1. 链上 emit → listener 收到事件
+ * 2. listener 查白名单 (event-whitelist.ts)
+ * 3. 不在白名单 = 丢弃 (Lesson #335 强制)
+ * 4. 在白名单 → 路由到对应 sqlite handler
+ *
+ * 三处一致铁律: 链上 emit + 索引器白名单 + sqlite handler
+ * 缺一不可 (任何 v0.4+ 新模块启用必走)
+ */
+import type { ChainEvent } from './core/types';
+export interface ListenerStats {
+    totalReceived: number;
+    totalWhitelisted: number;
+    totalDropped: number;
+    bySource: Record<string, {
+        whitelisted: number;
+        dropped: number;
+    }>;
+    byPriority: Record<string, number>;
+}
+export interface HandleEventOptions {
+    /** handler 回调 — 默认无, 由 index.ts 注入 */
+    orderHandler?: (event: ChainEvent) => Promise<void>;
+    riskcontrolHandler?: (event: ChainEvent) => Promise<void>;
+    relationshipHandler?: (event: ChainEvent) => Promise<void>;
+    insuranceHandler?: (event: ChainEvent) => Promise<void>;
+    governanceHandler?: (event: ChainEvent) => Promise<void>;
+    crosschainHandler?: (event: ChainEvent) => Promise<void>;
+    subchainHandler?: (event: ChainEvent) => Promise<void>;
+    marketplaceHandler?: (event: ChainEvent) => Promise<void>;
+    /** Webhook 推送配置 — baobei #16315 W3 实战锁版 */
+    webhookUrls?: Record<string, string>;
+    /** 调试日志开关 */
+    debug?: boolean;
+}
+export declare class EventListener {
+    private stats;
+    private options;
+    constructor(options?: HandleEventOptions);
+    /**
+     * 主入口: 收到 ChainEvent → 查白名单 → 路由
+     */
+    handleEvent(event: ChainEvent): Promise<void>;
+    /**
+     * 提取事件类型 — 兼容两种格式
+     */
+    private extractEventType;
+    /**
+     * 路由到对应 handler
+     */
+    private routeToHandler;
+    private getHandler;
+    private recordDropped;
+    /**
+     * 暴露统计 — 索引器监控用
+     */
+    getStats(): Readonly<ListenerStats>;
+    /**
+     * 重置统计
+     */
+    resetStats(): void;
+    /**
+     * baobei #16315 W3 实战锁版: webhook 推送 (Lesson #335 三处一致实战风格)
+     *
+     * 触发场景: 事件发出后, 推到 webhook URL (店小秘 / 第三方 ERP / Shopify / 自建)
+     * 5 订单事件实战锁版:
+     *   - payment_confirmed (链上 PENDING → PAID, 库存占用)
+     *   - ship_order (链上 PAID → SHIPPED, 物流推送)
+     *   - confirm_order (链上 SHIPPED → CONFIRMED, 释放 escrow)
+     *   - order_settled (链上 CONFIRMED → SETTLED, dispute_window 过后 crank)
+     *   - cancel_order (链上 PENDING/PAID → CANCELLED, 退款)
+     *
+     * 设计原则:
+     *   - Webhook URL 从 options.webhookUrls 读 (事件类型 → URL)
+     *   - POST body = WooCommerce 兼容 (跟 baobei 9ccbf60 wc-v3.ts spec 一致)
+     *   - HMAC-SHA256 签名 (跟 WooCommerce REST API 同款)
+     *   - 失败重试 3 次 (指数 backoff)
+     */
+    private pushWebhook;
+    /**
+     * WooCommerce 兼容 webhook payload 构造器
+     * 跟 baobei 9ccbf60 wc-v3.ts spec 一致 (订单事件格式)
+     */
+    private buildWebhookPayload;
+}
+/**
+ * 默认白名单 (从 event-whitelist.ts re-export)
+ */
+export { EVENT_WHITELIST_V3_1 } from './event-whitelist';
+//# sourceMappingURL=event-listener.d.ts.map

package/event-listener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-listener.d.ts","sourceRoot":"","sources":["../src/event-listener.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/C,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,aAAa;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAMX;IAEF,OAAO,CAAC,OAAO,CAA0B;gBAE7B,OAAO,GAAE,kBAAuB;IAI5C;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCnD;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;OAEG;YACW,cAAc;IAe5B,OAAO,CAAC,UAAU;IAuBlB,OAAO,CAAC,aAAa;IAQrB;;OAEG;IACH,QAAQ,IAAI,QAAQ,CAAC,aAAa,CAAC;IAInC;;OAEG;IACH,UAAU,IAAI,IAAI;IAUlB;;;;;;;;;;;;;;;;OAgBG;YACW,WAAW;IAwDzB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;CA8D5B;AAED;;GAEG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}