@pisell/pisellos 2.2.244 → 2.2.246

package/lib/server/modules/order/index.js

@@ -40,6 +40,14 @@ var INDEXDB_STORE_NAME = "orders";
 var ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY = "server_order_last_full_fetch_at";
 var ORDER_SYNC_THROTTLE_MS_STORAGE_KEY = "order_sync_throttle_ms";
 var DEFAULT_ORDER_SYNC_THROTTLE_MS = 2e3;
+var ORDER_SQLITE_DEDUPE_MS = 15e3;
+var ORDER_SILENT_REFRESH_MIN_INTERVAL_MS = 3e4;
+var ORDER_BUSINESS_WRITE_SOURCES = /* @__PURE__ */ new Set([
+  "upsertOrdersFromRemote",
+  "upsertPendingSyncOrders",
+  "overwriteExistingOrder",
+  "markOrderSyncedByExternalSaleNumber"
+]);
 var OrderModule = class extends import_BaseModule.BaseModule {
   constructor(name, version) {
     super(name, version);
@@ -50,6 +58,26 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     this.isIdlePhase = true;
     // Map<resource_id, OrderId[]> 资源到订单的倒排索引
     this.resourceIdIndex = /* @__PURE__ */ new Map();
+    this.orderSQLiteSaveQueue = Promise.resolve();
+    /** 按 storageKey 记录最近一次 SQLite 写入来源与时间，用于去重 */
+    this.recentSqliteWriteByStorageKey = /* @__PURE__ */ new Map();
+    /** 最近一次 SSE 全量拉取完成时间 */
+    this.lastServerFullFetchAtMs = 0;
+  }
+  /**
+   * 广播订单变更事件，兼容全量列表订阅并额外携带本次变更订单。
+   *
+   * @example
+   * await this.emitOrdersChanged([freshOrder], 'pubsub.bodyUpsert')
+   */
+  async emitOrdersChanged(changedOrders = [], source) {
+    console.log("触发emitOrdersChanged");
+    const payload = {
+      list: this.store.list,
+      changedOrders: changedOrders.map((order) => this.normalizeOrderForMemoryList(order)),
+      source
+    };
+    await this.core.effects.emit(import_types.OrderHooks.onOrdersChanged, payload);
   }
   async initialize(core, options) {
     var _a;
@@ -66,9 +94,9 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       this.updateCreateStore();
     }
     if (Array.isArray((_a = options == null ? void 0 : options.initialState) == null ? void 0 : _a.list)) {
-      this.store.list = options.initialState.list;
+      this.store.list = options.initialState.list.map((order) => this.normalizeOrderForMemoryList(order));
       this.syncOrdersMap();
-      this.core.effects.emit(import_types.OrderHooks.onOrdersChanged, this.store.list);
+      this.emitOrdersChanged([], "initialState");
     } else {
       this.store.list = [];
       this.store.map = /* @__PURE__ */ new Map();
@@ -115,6 +143,171 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     } catch {
     }
   }
+  logWarning(title, metadata) {
+    try {
+      if (this.logger) {
+        this.logger.addLog({
+          type: "warning",
+          title: `[OrderServerModule] ${title}`,
+          metadata: metadata || {}
+        });
+      }
+    } catch {
+    }
+  }
+  /**
+   * 记录订单最近一次 SQLite 写入，供 pubsub 回声去重使用。
+   *
+   * @example
+   * this.recordRecentSqliteWrite('upsertOrdersFromRemote', orders)
+   */
+  recordRecentSqliteWrite(source, orders) {
+    const now = Date.now();
+    for (const order of orders) {
+      const storageKey = this.getOrderStorageKey(order);
+      if (!storageKey)
+        continue;
+      this.recentSqliteWriteByStorageKey.set(storageKey, { source, ts: now });
+    }
+  }
+  /**
+   * 过滤 pubsub 触发的冗余 SQLite patch（业务 API 刚写入过的 update 回声）。
+   *
+   * @example
+   * const { toWrite, skipped } = this.filterRedundantPatchOrders('pubsub.bodyUpsert', orders, mergeActions)
+   */
+  filterRedundantPatchOrders(source, orders, mergeActions) {
+    const eligibleSkipSources = /* @__PURE__ */ new Set(["pubsub.bodyUpsert", "pubsub.httpRefresh"]);
+    if (!eligibleSkipSources.has(source)) {
+      return { toWrite: orders, skipped: [] };
+    }
+    const now = Date.now();
+    const toWrite = [];
+    const skipped = [];
+    for (const order of orders) {
+      const storageKey = this.getOrderStorageKey(order);
+      if (!storageKey) {
+        toWrite.push(order);
+        continue;
+      }
+      const orderKey = order.order_id !== void 0 && order.order_id !== null ? this.getIdKey(order.order_id) : "";
+      const mergeAction = orderKey ? mergeActions[orderKey] : void 0;
+      if (mergeAction === "insert") {
+        toWrite.push(order);
+        continue;
+      }
+      const recent = this.recentSqliteWriteByStorageKey.get(storageKey);
+      if (recent && ORDER_BUSINESS_WRITE_SOURCES.has(recent.source) && now - recent.ts < ORDER_SQLITE_DEDUPE_MS) {
+        skipped.push({
+          orderId: order.order_id ?? null,
+          storageKey,
+          reason: "skip_pubsub_echo_after_business_write",
+          lastSource: recent.source,
+          elapsedMs: now - recent.ts
+        });
+        continue;
+      }
+      toWrite.push(order);
+    }
+    return { toWrite, skipped };
+  }
+  /**
+   * 过滤 pubsub HTTP 增量拉取 ids：本地刚由业务 API 写入的单可跳过 HTTP。
+   *
+   * @example
+   * const ids = this.filterRedundantHttpRefreshIds([99331, 99332])
+   */
+  filterRedundantHttpRefreshIds(ids) {
+    const now = Date.now();
+    const toFetch = [];
+    const skipped = [];
+    for (const id of ids) {
+      const existing = this.getOrderByOrderId(id);
+      if (!existing) {
+        toFetch.push(id);
+        continue;
+      }
+      const storageKey = this.getOrderStorageKey(existing);
+      const recent = storageKey ? this.recentSqliteWriteByStorageKey.get(storageKey) : void 0;
+      if (recent && recent.source === "upsertOrdersFromRemote" && now - recent.ts < ORDER_SQLITE_DEDUPE_MS) {
+        skipped.push({
+          orderId: id,
+          lastSource: recent.source,
+          elapsedMs: now - recent.ts
+        });
+        continue;
+      }
+      toFetch.push(id);
+    }
+    return { toFetch, skipped };
+  }
+  /**
+   * 解析 pubsub 消息会走哪条同步分支，便于对照为何触发 HTTP 重拉或 body 直写。
+   *
+   * @example
+   * this.resolveSyncMessageRoute(msg)
+   * // => { route: 'httpRefresh.batchIds', ... }
+   */
+  resolveSyncMessageRoute(msg) {
+    var _a;
+    const hasBatchIds = Array.isArray(msg.ids) && msg.ids.length > 0;
+    const singleIdRaw = msg.id ?? msg.order_id;
+    const hasSingleId = !hasBatchIds && singleIdRaw !== void 0 && singleIdRaw !== null;
+    const normalizedBody = this.normalizeOrderSyncPayload(msg.body || msg.data);
+    if (hasBatchIds) {
+      return {
+        route: "httpRefresh.batchIds",
+        hasBatchIds: true,
+        hasSingleId: false,
+        hasNormalizedBody: !!normalizedBody,
+        singleId: null,
+        batchIds: msg.ids || [],
+        bodyOrderId: (normalizedBody == null ? void 0 : normalizedBody.order_id) ?? null
+      };
+    }
+    if (hasSingleId && normalizedBody) {
+      return {
+        route: "bodyUpsert",
+        hasBatchIds: false,
+        hasSingleId: true,
+        hasNormalizedBody: true,
+        singleId: singleIdRaw,
+        batchIds: [],
+        bodyOrderId: normalizedBody.order_id ?? null
+      };
+    }
+    if (hasSingleId) {
+      return {
+        route: "httpRefresh.singleId",
+        hasBatchIds: false,
+        hasSingleId: true,
+        hasNormalizedBody: !!normalizedBody,
+        singleId: singleIdRaw,
+        batchIds: [],
+        bodyOrderId: (normalizedBody == null ? void 0 : normalizedBody.order_id) ?? null
+      };
+    }
+    if ((_a = msg.relation_order_ids) == null ? void 0 : _a.length) {
+      return {
+        route: "httpRefresh.relationIds",
+        hasBatchIds: false,
+        hasSingleId: false,
+        hasNormalizedBody: !!normalizedBody,
+        singleId: null,
+        batchIds: msg.relation_order_ids,
+        bodyOrderId: (normalizedBody == null ? void 0 : normalizedBody.order_id) ?? null
+      };
+    }
+    return {
+      route: "noop",
+      hasBatchIds: false,
+      hasSingleId: false,
+      hasNormalizedBody: !!normalizedBody,
+      singleId: null,
+      batchIds: [],
+      bodyOrderId: (normalizedBody == null ? void 0 : normalizedBody.order_id) ?? null
+    };
+  }
   updateCreateStore() {
     var _a;
     const appPlugin = this.core.getPlugin("app");
@@ -174,11 +367,12 @@ var OrderModule = class extends import_BaseModule.BaseModule {
   async preload() {
     const getData = async () => {
       const orders = await this.loadOrdersByServer();
-      if (orders.length === 0)
+      if (orders.length === 0) {
         return;
+      }
       this.store.list = (0, import_lodash_es.cloneDeep)(orders);
       this.syncOrdersMap();
-      this.core.effects.emit(import_types.OrderHooks.onOrdersChanged, this.store.list);
+      this.emitOrdersChanged([], "preload");
       this.core.effects.emit(import_types.OrderHooks.onOrdersSyncCompleted, null);
     };
     getData();
@@ -189,30 +383,33 @@ var OrderModule = class extends import_BaseModule.BaseModule {
   getOrderById(id) {
     return this.store.map.get(this.getIdKey(id));
   }
-  /** 按 order_id 查询（推荐） */
+  /** 按 order_id 查询内存订单。 */
   getOrderByOrderId(orderId) {
     return this.store.map.get(this.getIdKey(orderId));
   }
-  async getLocalOrderByOrderId(orderId) {
-    const key = this.getIdKey(orderId);
-    const memoryOrder = this.store.map.get(key);
+  getLocalOrderFromMemoryByLookup(lookup) {
+    const key = this.getIdKey(lookup);
+    const memoryOrderById = this.store.map.get(key);
+    if (memoryOrderById)
+      return memoryOrderById;
+    const memoryOrder = this.store.list.find((order) => this.isOrderLookupMatch(order, key));
+    return memoryOrder || null;
+  }
+  async getLocalOrderByLookup(lookup) {
+    const key = this.getIdKey(lookup);
+    const memoryOrderById = this.store.map.get(key);
+    if (memoryOrderById)
+      return memoryOrderById;
+    const memoryOrder = this.store.list.find((order) => this.isOrderLookupMatch(order, key));
     if (memoryOrder)
       return memoryOrder;
     const orders = await this.loadOrdersFromSQLite();
-    const localOrder = orders.find((order) => {
-      const shopOrderNumber = order == null ? void 0 : order.shop_order_number;
-      if (shopOrderNumber && this.getIdKey(shopOrderNumber) === key)
-        return true;
-      const id = order == null ? void 0 : order.order_id;
-      if (id === void 0 || id === null)
-        return false;
-      return this.getIdKey(id) === key;
-    });
+    const localOrder = orders.find((order) => this.isOrderLookupMatch(order, key));
     if (!localOrder)
       return null;
-    this.store.list = orders;
+    this.store.list = orders.map((order) => this.normalizeOrderForMemoryList(order));
     this.syncOrdersMap();
-    return localOrder;
+    return this.normalizeOrderForMemoryList(localOrder);
   }
   async loadOrdersByServer() {
     var _a;
@@ -233,17 +430,19 @@ var OrderModule = class extends import_BaseModule.BaseModule {
           count: orderList.length
         });
         this.markOrderPulledAtNow();
+        this.lastServerFullFetchAtMs = Date.now();
       } catch {
-        orderList = [];
-        this.logInfo("loadOrdersByServer-SSE拉取失败，回退为空数组");
+        this.logInfo("loadOrdersByServer-SSE拉取失败，保持当前内存订单");
+        return this.store.list;
       }
     }
-    await this.saveOrdersToSQLite(orderList);
+    const mergedOrders = await this.replaceOrdersSnapshotInSQLite(orderList, "loadOrdersByServer");
+    const memoryOrders = mergedOrders.map((order) => this.normalizeOrderForMemoryList(order));
     this.logInfo("loadOrdersByServer-结束", {
-      count: orderList.length
+      count: memoryOrders.length
     });
-    await this.core.effects.emit(import_types.OrderHooks.onOrdersLoaded, orderList);
-    return orderList;
+    await this.core.effects.emit(import_types.OrderHooks.onOrdersLoaded, memoryOrders);
+    return memoryOrders;
   }
   /**
    * 静默全量刷新：后台重新拉取全量 SSE 订单数据并更新本地
@@ -252,6 +451,10 @@ var OrderModule = class extends import_BaseModule.BaseModule {
    */
   async silentRefresh() {
     const startTime = Date.now();
+    const elapsedSinceFullFetch = Date.now() - this.lastServerFullFetchAtMs;
+    if (this.lastServerFullFetchAtMs > 0 && elapsedSinceFullFetch < ORDER_SILENT_REFRESH_MIN_INTERVAL_MS) {
+      return this.store.list;
+    }
     this.logInfo("silentRefresh 开始");
     try {
       this.updateCreateStore();
@@ -259,7 +462,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       if (orders.length > 0) {
         this.store.list = (0, import_lodash_es.cloneDeep)(orders);
         this.syncOrdersMap();
-        this.core.effects.emit(import_types.OrderHooks.onOrdersChanged, this.store.list);
+        this.emitOrdersChanged([], "silentRefresh");
         await this.core.effects.emit(import_types.OrderHooks.onOrdersSyncCompleted, null);
         this.logInfo("silentRefresh 完成", {
           orderCount: orders.length,
@@ -282,6 +485,19 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     const ids = this.resourceIdIndex.get(String(resourceId)) || [];
     return ids.map((id) => this.store.map.get(id)).filter((order) => !!order);
   }
+  normalizeOrderForMemoryList(order) {
+    const externalSaleNumber = order == null ? void 0 : order.external_sale_number;
+    if ((order == null ? void 0 : order.order_id) !== void 0 && (order == null ? void 0 : order.order_id) !== null && (order == null ? void 0 : order.order_id) !== "") {
+      return order;
+    }
+    if (externalSaleNumber === void 0 || externalSaleNumber === null || externalSaleNumber === "") {
+      return order;
+    }
+    return {
+      ...order,
+      order_id: externalSaleNumber
+    };
+  }
   /**
    * 仅覆盖本地已存在的订单；不存在则直接跳过，不落库、不 emit。
    * 适用于"按 order_id 主动刷新本地订单详情"的代理场景。
@@ -308,12 +524,12 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       return this.getIdKey(id) === key ? fresh : order;
     });
     this.syncOrdersMap();
-    await this.saveOrdersToSQLite(this.store.list);
+    await this.updateOrderInSQLite(fresh, "overwriteExistingOrder");
     this.logInfo("overwriteExistingOrder-结束", {
       orderId,
       storeOrderCountAfter: this.store.list.length
     });
-    await this.core.effects.emit(import_types.OrderHooks.onOrdersChanged, this.store.list);
+    await this.emitOrdersChanged([fresh], "overwriteExistingOrder");
     return { overwritten: true };
   }
   /**
@@ -326,7 +542,104 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       return;
     }
     this.logInfo("upsertOrdersFromRemote-开始", { count: freshOrders.length });
-    await this.mergeOrdersToStore(freshOrders);
+    await this.mergeOrdersToStore(freshOrders, "upsertOrdersFromRemote");
+  }
+  async markOrderSyncedByExternalSaleNumber(params) {
+    const externalSaleNumber = params.externalSaleNumber;
+    if (externalSaleNumber === void 0 || externalSaleNumber === null || externalSaleNumber === "") {
+      this.logError("markOrderSyncedByExternalSaleNumber-缺少 external_sale_number");
+      return { updated: false };
+    }
+    const key = this.getIdKey(externalSaleNumber);
+    const targetIndex = this.store.list.findIndex((order) => {
+      const value = order == null ? void 0 : order.external_sale_number;
+      if (value === void 0 || value === null || value === "")
+        return false;
+      return this.getIdKey(value) === key;
+    });
+    if (targetIndex < 0) {
+      this.logInfo("markOrderSyncedByExternalSaleNumber-本地订单不存在，跳过", {
+        external_sale_number: externalSaleNumber
+      });
+      return { updated: false };
+    }
+    const existing = this.store.list[targetIndex];
+    const nextOrder = this.normalizeRemoteSyncedOrder({
+      ...existing,
+      ...params.patch || {},
+      external_sale_number: existing.external_sale_number ?? externalSaleNumber,
+      need_sync: 0
+    });
+    const storageKey = this.getOrderStorageKey(nextOrder) || key;
+    this.store.list = this.store.list.map((order, index) => {
+      if (index !== targetIndex)
+        return order;
+      return nextOrder;
+    });
+    this.syncOrdersMap();
+    await this.patchOrdersInSQLite(
+      [nextOrder],
+      "markOrderSyncedByExternalSaleNumber",
+      { [storageKey]: "update" }
+    );
+    this.logInfo("markOrderSyncedByExternalSaleNumber-完成", {
+      external_sale_number: externalSaleNumber,
+      order_id: nextOrder.order_id ?? null
+    });
+    await this.emitOrdersChanged([nextOrder], "markOrderSyncedByExternalSaleNumber");
+    return { updated: true, order: nextOrder };
+  }
+  /**
+   * 将本地待同步订单按 SQLite storage key 合并进 store 并落库。
+   * checkout 离线兜底可能没有 order_id，但通常会有 external_sale_number。
+   */
+  async upsertPendingSyncOrders(pendingOrders) {
+    if (!(pendingOrders == null ? void 0 : pendingOrders.length)) {
+      this.logInfo("upsertPendingSyncOrders-订单列表为空", {});
+      return;
+    }
+    const pendingMap = /* @__PURE__ */ new Map();
+    const memoryPendingMap = /* @__PURE__ */ new Map();
+    for (const order of pendingOrders) {
+      const storageKey = this.getOrderStorageKey(order);
+      if (!storageKey)
+        continue;
+      pendingMap.set(storageKey, order);
+      memoryPendingMap.set(storageKey, this.normalizeOrderForMemoryList(order));
+    }
+    if (pendingMap.size === 0) {
+      this.logError("upsertPendingSyncOrders-订单缺少可落库标识", {
+        count: pendingOrders.length
+      });
+      return;
+    }
+    this.logInfo("upsertPendingSyncOrders-开始", { count: pendingMap.size });
+    const patchedOrders = [...pendingMap.values()];
+    const mergeActions = {};
+    const updatedList = [...this.store.list];
+    for (const [storageKey, pendingOrder] of memoryPendingMap.entries()) {
+      const matchIndex = this.findOrderIndexByIdentity(updatedList, pendingOrder);
+      if (matchIndex < 0)
+        continue;
+      updatedList[matchIndex] = this.mergeOrderRecords(updatedList[matchIndex], pendingOrder, {
+        preferIncomingProducts: true
+      });
+      pendingMap.delete(storageKey);
+      memoryPendingMap.delete(storageKey);
+      mergeActions[storageKey] = "update";
+    }
+    for (const [storageKey, order] of memoryPendingMap.entries()) {
+      mergeActions[storageKey] = "insert";
+      updatedList.push(order);
+    }
+    this.store.list = this.compactOrderListByIdentity(updatedList, "upsertPendingSyncOrders.store").list;
+    this.syncOrdersMap();
+    await this.patchOrdersInSQLite(patchedOrders, "upsertPendingSyncOrders", mergeActions);
+    this.logInfo("upsertPendingSyncOrders-结束", {
+      count: patchedOrders.length,
+      storeOrderCountAfter: this.store.list.length
+    });
+    await this.emitOrdersChanged(patchedOrders, "upsertPendingSyncOrders");
   }
   /**
    * 通过 SSE 按自定义 query 拉取订单（支持 select/with 精简字段）
@@ -363,21 +676,65 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     this.store.map.clear();
     this.resourceIdIndex.clear();
     for (const order of this.store.list) {
-      const id = order.order_id;
-      if (id === void 0 || id === null)
+      const primaryIdentity = this.getOrderMapKey(order);
+      if (!primaryIdentity)
         continue;
-      this.store.map.set(this.getIdKey(id), order);
+      this.store.map.set(primaryIdentity, order);
       const resourceIds = this.extractResourceIds(order);
       for (const resourceId of resourceIds) {
         const key = String(resourceId);
         const existing = this.resourceIdIndex.get(key) || [];
-        if (existing.some((eid) => this.getIdKey(eid) === this.getIdKey(id)))
+        if (existing.some((eid) => this.getIdKey(eid) === primaryIdentity))
           continue;
-        existing.push(id);
+        existing.push(primaryIdentity);
         this.resourceIdIndex.set(key, existing);
       }
     }
   }
+  getOrderMapKey(order) {
+    if (!order)
+      return "";
+    if (!this.isBlankIdentityValue(order.order_id)) {
+      return this.getIdKey(order.order_id);
+    }
+    const externalSaleNumber = order.external_sale_number;
+    if (!this.isBlankIdentityValue(externalSaleNumber)) {
+      return this.getIdKey(externalSaleNumber);
+    }
+    return "";
+  }
+  isBlankIdentityValue(value) {
+    return value === void 0 || value === null || value === "";
+  }
+  getOrderIdentityEntries(order) {
+    if (!order)
+      return [];
+    const record = order;
+    const candidates = [
+      { field: "order_id", value: order.order_id },
+      { field: "external_sale_number", value: record.external_sale_number },
+      { field: "order_number", value: record.order_number },
+      { field: "shop_order_number", value: record.shop_order_number }
+    ];
+    const entries = [];
+    for (const candidate of candidates) {
+      if (this.isBlankIdentityValue(candidate.value))
+        continue;
+      const key = this.getIdKey(candidate.value);
+      if (entries.some((entry) => entry.field === candidate.field && entry.key === key))
+        continue;
+      entries.push({ field: candidate.field, key });
+    }
+    return entries;
+  }
+  getOrderIdentityKeys(order) {
+    const keys = [];
+    for (const entry of this.getOrderIdentityEntries(order)) {
+      if (!keys.includes(entry.key))
+        keys.push(entry.key);
+    }
+    return keys;
+  }
   extractResourceIds(order) {
     const ids = /* @__PURE__ */ new Set();
     const visitResources = (resources) => {
@@ -434,7 +791,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     this.orderDataSource.run({
       pubsub: {
         callback: (res) => {
-          console.log("orderDataSource");
+          console.log("orderDataSource", res);
           const pubsubReceivedAt = Date.now();
           const message = this.normalizeOrderSyncMessage(res);
           if (!message)
@@ -442,13 +799,15 @@ var OrderModule = class extends import_BaseModule.BaseModule {
           message._pubsubReceivedAt = pubsubReceivedAt;
           this.pendingSyncMessages.push(message);
           const throttleMs = this.getOrderSyncThrottleMs();
+          const routeInfo = this.resolveSyncMessageRoute(message);
           this.logInfo("orderSync-收到消息并入队", {
             id: message.id ?? null,
             order_id: message.order_id ?? null,
             type: message.type ?? null,
             pendingCount: this.pendingSyncMessages.length,
             throttleMs,
-            pubsubReceivedAt: new Date(pubsubReceivedAt).toISOString()
+            pubsubReceivedAt: new Date(pubsubReceivedAt).toISOString(),
+            fullMessage: JSON.stringify(message)
           });
           this.scheduleOrderSyncThrottle();
         }
@@ -514,7 +873,6 @@ var OrderModule = class extends import_BaseModule.BaseModule {
    * await this.processOrderSyncMessages()
    */
   async processOrderSyncMessages() {
-    var _a;
     const messages = [...this.pendingSyncMessages];
     this.pendingSyncMessages = [];
     if (messages.length === 0)
@@ -531,38 +889,47 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     });
     const upsertOrders = /* @__PURE__ */ new Map();
     const refreshIds = [];
-    for (const msg of messages) {
-      const hasBatchIds = Array.isArray(msg.ids) && msg.ids.length > 0;
-      const singleId = msg.id ?? msg.order_id;
-      const hasSingleId = !hasBatchIds && singleId !== void 0 && singleId !== null;
-      const rawBody = msg.body || msg.data;
-      const normalizedBody = this.normalizeOrderSyncPayload(rawBody);
-      if (hasSingleId && normalizedBody) {
+    messages.forEach((msg, msgIndex) => {
+      const routeInfo = this.resolveSyncMessageRoute(msg);
+      const hasBatchIds = routeInfo.hasBatchIds;
+      const singleId = routeInfo.singleId;
+      const hasSingleId = routeInfo.hasSingleId;
+      const normalizedBody = this.normalizeOrderSyncPayload(msg.body || msg.data);
+      if (routeInfo.route === "bodyUpsert" && normalizedBody) {
         upsertOrders.set(this.getIdKey(normalizedBody.order_id), normalizedBody);
-        continue;
+        return;
       }
       if (hasBatchIds)
-        refreshIds.push(...msg.ids);
-      else if (hasSingleId)
+        refreshIds.push(...routeInfo.batchIds);
+      else if (routeInfo.route === "httpRefresh.singleId" && singleId !== null)
         refreshIds.push(singleId);
-      else if ((_a = msg.relation_order_ids) == null ? void 0 : _a.length)
-        refreshIds.push(...msg.relation_order_ids);
-    }
+      else if (routeInfo.route === "httpRefresh.relationIds")
+        refreshIds.push(...routeInfo.batchIds);
+    });
     const uniqueRefreshIds = this.uniqueOrderIds(refreshIds);
     const upsertList = [...upsertOrders.values()];
     this.logInfo("processOrderSyncMessages-去重完成", {
       upsertCount: upsertList.length,
       refreshIdCount: uniqueRefreshIds.length
     });
-    if (upsertList.length > 0)
-      await this.mergeOrdersToStore(upsertList);
+    if (upsertList.length > 0) {
+      await this.mergeOrdersToStore(upsertList, "pubsub.bodyUpsert");
+    }
     if (uniqueRefreshIds.length > 0) {
-      const freshOrders = await this.fetchOrdersByHttp(uniqueRefreshIds);
-      if (freshOrders.length > 0)
-        await this.mergeOrdersToStore(freshOrders);
+      const { toFetch, skipped } = this.filterRedundantHttpRefreshIds(uniqueRefreshIds);
+      if (skipped.length > 0) {
+      }
+      if (toFetch.length > 0) {
+        const freshOrders = await this.fetchOrdersByHttp(toFetch);
+        if (freshOrders.length > 0) {
+          await this.mergeOrdersToStore(freshOrders, "pubsub.httpRefresh");
+        } else {
+        }
+      }
     }
-    if (upsertList.length === 0 && uniqueRefreshIds.length === 0)
+    if (upsertList.length === 0 && uniqueRefreshIds.length === 0) {
       return;
+    }
     const batchProcessEndAt = Date.now();
     this.logInfo("processOrderSyncMessages-结束", {
       upsertCount: upsertList.length,
@@ -603,41 +970,62 @@ var OrderModule = class extends import_BaseModule.BaseModule {
   /**
    * 将增量订单合并到 store
    */
-  async mergeOrdersToStore(freshOrders) {
+  async mergeOrdersToStore(freshOrders, source) {
     this.logInfo("mergeOrdersToStore-开始", {
       freshOrderCount: freshOrders.length,
-      storeOrderCountBefore: this.store.list.length
+      storeOrderCountBefore: this.store.list.length,
+      source
     });
-    const freshMap = /* @__PURE__ */ new Map();
+    this.logDuplicateOrders(`${source}.beforeMerge`, this.store.list);
+    const normalizedFreshOrders = [];
     for (const order of freshOrders) {
       const id = order == null ? void 0 : order.order_id;
       if (id === void 0 || id === null)
         continue;
-      freshMap.set(this.getIdKey(id), order);
+      normalizedFreshOrders.push(this.normalizeRemoteSyncedOrder(order));
     }
-    const uniqueFreshCount = freshMap.size;
-    const updatedList = this.store.list.map((order) => {
-      const id = order.order_id;
-      if (id === void 0 || id === null)
-        return order;
-      const key = this.getIdKey(id);
-      if (!freshMap.has(key))
-        return order;
-      const fresh = freshMap.get(key);
-      freshMap.delete(key);
-      return fresh;
-    });
-    for (const order of freshMap.values()) {
-      updatedList.push(order);
+    const uniqueFreshOrders = this.compactOrderListByIdentity(
+      normalizedFreshOrders,
+      `${source}.incoming`
+    ).list;
+    const uniqueFreshCount = uniqueFreshOrders.length;
+    const patchedOrders = [];
+    const mergeActions = {};
+    const updatedList = [...this.store.list];
+    for (const fresh of uniqueFreshOrders) {
+      const matchIndex = this.findOrderIndexByIdentity(updatedList, fresh);
+      const storageKey = this.getOrderStorageKey(fresh);
+      const mergeKey = storageKey || (fresh.order_id !== void 0 && fresh.order_id !== null ? this.getIdKey(fresh.order_id) : "");
+      if (matchIndex >= 0) {
+        const mergedOrder = this.mergeOrderRecords(updatedList[matchIndex], fresh);
+        updatedList[matchIndex] = mergedOrder;
+        patchedOrders.push(mergedOrder);
+        if (mergeKey)
+          mergeActions[mergeKey] = "update";
+        continue;
+      }
+      updatedList.push(fresh);
+      patchedOrders.push(fresh);
+      if (mergeKey)
+        mergeActions[mergeKey] = "insert";
     }
-    this.store.list = updatedList;
+    const insertCount = Object.values(mergeActions).filter((v) => v === "insert").length;
+    const updateCount = Object.values(mergeActions).filter((v) => v === "update").length;
+    this.logInfo("mergeOrdersToStore-合并完成", {
+      insertCount,
+      updateCount,
+      storeOrderCountAfter: this.store.list.length
+    });
+    this.store.list = this.compactOrderListByIdentity(updatedList, `${source}.store`).list;
     this.syncOrdersMap();
-    await this.saveOrdersToSQLite(this.store.list);
+    await this.patchOrdersInSQLite(patchedOrders, source, mergeActions);
     this.logInfo("mergeOrdersToStore-结束", {
       uniqueFreshCount,
-      storeOrderCountAfter: this.store.list.length
+      storeOrderCountAfter: this.store.list.length,
+      insertCount,
+      updateCount
     });
-    this.core.effects.emit(import_types.OrderHooks.onOrdersChanged, this.store.list);
+    await this.emitOrdersChanged(patchedOrders, source);
   }
   normalizeOrderSyncMessage(res) {
     const data = (res == null ? void 0 : res.data) || res;
@@ -682,6 +1070,229 @@ var OrderModule = class extends import_BaseModule.BaseModule {
   getIdKey(id) {
     return String(id);
   }
+  isOrderLookupMatch(order, lookupKey) {
+    if (!order || !lookupKey)
+      return false;
+    const candidates = [
+      order.order_id,
+      order.external_sale_number,
+      order.order_number,
+      order.shop_order_number,
+      order.shop_full_order_number
+    ];
+    return candidates.some((value) => {
+      if (value === void 0 || value === null || value === "")
+        return false;
+      return this.getIdKey(value) === lookupKey;
+    });
+  }
+  /**
+   * 解析订单 SQLite 主键，规则与宿主 OrderDataSource.getOrderStorageKey 一致。
+   *
+   * @example
+   * const key = this.getOrderStorageKey({ order_id: 1001, external_sale_number: 'S-1001' })
+   * // => 'S-1001'
+   */
+  getOrderStorageKey(order) {
+    const externalSaleNumber = order == null ? void 0 : order.external_sale_number;
+    if (externalSaleNumber !== void 0 && externalSaleNumber !== null && externalSaleNumber !== "") {
+      return String(externalSaleNumber);
+    }
+    const orderId = order == null ? void 0 : order.order_id;
+    if (orderId !== void 0 && orderId !== null && orderId !== "") {
+      return String(orderId);
+    }
+    return "";
+  }
+  getOrderIdentityMatchKeys(order) {
+    return this.getOrderIdentityEntries(order).map((entry) => `${entry.field}:${entry.key}`);
+  }
+  doOrdersShareIdentity(left, right) {
+    const leftKeys = new Set(this.getOrderIdentityMatchKeys(left));
+    if (leftKeys.size === 0)
+      return false;
+    return this.getOrderIdentityMatchKeys(right).some((key) => leftKeys.has(key));
+  }
+  findOrderIndexByIdentity(orders, target) {
+    if (this.getOrderIdentityMatchKeys(target).length === 0)
+      return -1;
+    return orders.findIndex((order) => this.doOrdersShareIdentity(order, target));
+  }
+  getOrderCompletenessScore(order) {
+    const record = order;
+    let score = this.isPendingSyncOrder(order) ? 0 : 100;
+    if (!this.isBlankIdentityValue(order.order_id) && order.order_id !== record.external_sale_number)
+      score += 30;
+    score += this.getOrderIdentityMatchKeys(order).length * 5;
+    if (Array.isArray(order.products))
+      score += Math.min(order.products.length, 10);
+    if (Array.isArray(order.bookings))
+      score += Math.min(order.bookings.length, 10);
+    if (Array.isArray(order.payments))
+      score += Math.min(order.payments.length, 10);
+    if (record.updated_at)
+      score += 1;
+    return score;
+  }
+  pickPreferredOrder(left, right) {
+    const leftScore = this.getOrderCompletenessScore(left);
+    const rightScore = this.getOrderCompletenessScore(right);
+    if (rightScore >= leftScore)
+      return right;
+    return left;
+  }
+  getProductMergeKey(product) {
+    var _a;
+    const record = product;
+    if (!record)
+      return "";
+    const metadataUid = (_a = record.metadata) == null ? void 0 : _a.unique_identification_number;
+    if (!this.isBlankIdentityValue(metadataUid))
+      return `uid:${String(metadataUid)}`;
+    const topLevelUid = record.unique_identification_number;
+    if (!this.isBlankIdentityValue(topLevelUid))
+      return `uid:${String(topLevelUid)}`;
+    const orderDetailId = record.order_detail_id;
+    if (!this.isBlankIdentityValue(orderDetailId))
+      return `detail:${String(orderDetailId)}`;
+    const bookingUid = record.booking_uid;
+    if (!this.isBlankIdentityValue(bookingUid))
+      return `booking:${String(bookingUid)}`;
+    return "";
+  }
+  mergeOrderProductLists(preferred, secondary) {
+    const preferredList = Array.isArray(preferred) ? preferred : [];
+    const secondaryList = Array.isArray(secondary) ? secondary : [];
+    if (secondaryList.length === 0)
+      return preferredList;
+    if (preferredList.length === 0)
+      return secondaryList;
+    const seenKeys = /* @__PURE__ */ new Set();
+    for (const item of preferredList) {
+      const key = this.getProductMergeKey(item);
+      if (key)
+        seenKeys.add(key);
+    }
+    const result = [...preferredList];
+    for (const item of secondaryList) {
+      const key = this.getProductMergeKey(item);
+      if (!key || seenKeys.has(key))
+        continue;
+      seenKeys.add(key);
+      result.push((0, import_lodash_es.cloneDeep)(item));
+    }
+    return result;
+  }
+  mergeOrderRecords(existing, incoming, options) {
+    const preferred = this.pickPreferredOrder(existing, incoming);
+    const secondary = preferred === existing ? incoming : existing;
+    const merged = {
+      ...secondary,
+      ...preferred
+    };
+    const fieldsToPreserve = [
+      "order_id",
+      "external_sale_number",
+      "order_number",
+      "shop_order_number",
+      "shop_full_order_number"
+    ];
+    const incomingPatchFields = [
+      "payment_status",
+      "status",
+      "shipping_status",
+      "updated_at",
+      "shop_discount",
+      "summary",
+      "payments",
+      "products",
+      "bookings"
+    ];
+    const mergedRecord = merged;
+    const preferredRecord = preferred;
+    const secondaryRecord = secondary;
+    const incomingRecord = incoming;
+    for (const field of fieldsToPreserve) {
+      if (!this.isBlankIdentityValue(preferredRecord[field])) {
+        mergedRecord[field] = preferredRecord[field];
+        continue;
+      }
+      if (!this.isBlankIdentityValue(secondaryRecord[field])) {
+        mergedRecord[field] = secondaryRecord[field];
+      }
+    }
+    const hasIncomingProducts = Object.prototype.hasOwnProperty.call(incomingRecord, "products");
+    const shouldUseIncomingProductsSnapshot = (options == null ? void 0 : options.preferIncomingProducts) === true && hasIncomingProducts && incomingRecord.products !== void 0 && incomingRecord.products !== null;
+    for (const field of incomingPatchFields) {
+      if (!Object.prototype.hasOwnProperty.call(incomingRecord, field))
+        continue;
+      if (incomingRecord[field] === void 0 || incomingRecord[field] === null)
+        continue;
+      if (typeof incomingRecord[field] === "string" && incomingRecord[field] === "")
+        continue;
+      mergedRecord[field] = (0, import_lodash_es.cloneDeep)(incomingRecord[field]);
+    }
+    mergedRecord.products = shouldUseIncomingProductsSnapshot ? (0, import_lodash_es.cloneDeep)(incomingRecord.products) : this.mergeOrderProductLists(preferredRecord.products, secondaryRecord.products);
+    if (!this.isPendingSyncOrder(preferred) || !this.isPendingSyncOrder(secondary)) {
+      merged.need_sync = 0;
+    }
+    return merged;
+  }
+  summarizeDuplicateOrders(orders) {
+    const groups = /* @__PURE__ */ new Map();
+    for (const order of orders) {
+      for (const key of this.getOrderIdentityMatchKeys(order)) {
+        const group = groups.get(key) || [];
+        group.push(order);
+        groups.set(key, group);
+      }
+    }
+    return [...groups.entries()].filter(([, group]) => group.length > 1).slice(0, 20).map(([key, group]) => ({
+      key,
+      count: group.length,
+      orders: group.map((order) => ({
+        order_id: order.order_id ?? null,
+        external_sale_number: order.external_sale_number ?? null,
+        shop_order_number: order.shop_order_number ?? null,
+        shop_full_order_number: order.shop_full_order_number ?? null,
+        need_sync: order.need_sync ?? null
+      }))
+    }));
+  }
+  logDuplicateOrders(source, orders) {
+    const duplicateGroups = this.summarizeDuplicateOrders(orders);
+    if (duplicateGroups.length === 0)
+      return;
+    this.logWarning("检测到重复订单身份键", {
+      source,
+      duplicateGroupCount: duplicateGroups.length,
+      duplicateGroups
+    });
+  }
+  compactOrderListByIdentity(orders, source) {
+    const list = [];
+    let removedCount = 0;
+    for (const order of orders) {
+      const matchIndex = this.findOrderIndexByIdentity(list, order);
+      if (matchIndex < 0) {
+        list.push(order);
+        continue;
+      }
+      list[matchIndex] = this.mergeOrderRecords(list[matchIndex], order);
+      removedCount += 1;
+    }
+    if (removedCount > 0) {
+      this.logWarning("订单列表重复项已压缩", {
+        source,
+        beforeCount: orders.length,
+        afterCount: list.length,
+        removedCount
+      });
+    } else {
+      this.logDuplicateOrders(source, orders);
+    }
+    return { list, removedCount };
+  }
   /**
    * 当前订单拉取窗口：
    * - 优先使用 createdAtQuery.sales_time_between（已按营业日边界初始化）
@@ -752,39 +1363,221 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       return [];
     }
   }
-  async saveOrdersToSQLite(orderList) {
-    if (!this.dbManager)
+  isPendingSyncOrder(order) {
+    return Number(order == null ? void 0 : order.need_sync) === 1;
+  }
+  normalizeRemoteSyncedOrder(order) {
+    if (this.isPendingSyncOrder(order))
+      return order;
+    return {
+      ...order,
+      need_sync: 0
+    };
+  }
+  mergeRemoteSnapshotWithPendingOrders(remoteOrders, existingOrders) {
+    const merged = remoteOrders.map((order) => this.normalizeRemoteSyncedOrder(order));
+    for (const order of existingOrders) {
+      if (!this.isPendingSyncOrder(order))
+        continue;
+      const matchIndex = this.findOrderIndexByIdentity(merged, order);
+      if (matchIndex >= 0) {
+        merged[matchIndex] = this.mergeOrderRecords(order, merged[matchIndex]);
+        continue;
+      }
+      if (!this.getOrderStorageKey(order))
+        continue;
+      merged.push(order);
+    }
+    return this.compactOrderListByIdentity(merged, "mergeRemoteSnapshotWithPendingOrders").list;
+  }
+  /**
+   * 串行执行订单 SQLite 写入任务，避免快照替换与增量 upsert 并发交错。
+   *
+   * @example
+   * await this.runInOrderSQLiteSaveQueue(async () => {
+   *   await this.dbManager.bulkUpdate(INDEXDB_STORE_NAME, orders)
+   * })
+   */
+  async runInOrderSQLiteSaveQueue(task) {
+    const queuedTask = this.orderSQLiteSaveQueue.then(task, task);
+    this.orderSQLiteSaveQueue = queuedTask.then(() => void 0, () => void 0);
+    return queuedTask;
+  }
+  /**
+   * 批量增量 upsert 订单到 SQLite，不清空表；用于 pubsub / HTTP 增量合并。
+   *
+   * @example
+   * await this.patchOrdersInSQLite(freshOrders)
+   */
+  async patchOrdersInSQLite(orders, source, mergeActions = {}) {
+    if (!this.dbManager || orders.length === 0) {
       return;
+    }
+    const ordersSnapshot = (0, import_lodash_es.cloneDeep)(orders).filter((order) => this.getOrderStorageKey(order));
+    if (ordersSnapshot.length === 0) {
+      return;
+    }
+    const { toWrite, skipped } = this.filterRedundantPatchOrders(
+      source,
+      ordersSnapshot,
+      mergeActions
+    );
+    if (toWrite.length === 0) {
+      return;
+    }
+    const compactedToWrite = this.compactOrderListByIdentity(toWrite, `${source}.sqlitePatch`).list;
+    if (compactedToWrite.length === 0) {
+      return;
+    }
     try {
-      this.logInfo("saveOrdersToSQLite-开始", {
-        count: orderList.length
+      await this.runInOrderSQLiteSaveQueue(async () => {
+        let writeMethod = "none";
+        this.logInfo("patchOrdersInSQLite-开始", {
+          source,
+          count: compactedToWrite.length,
+          dedupedCount: skipped.length
+        });
+        if (typeof this.dbManager.bulkUpdate === "function") {
+          writeMethod = "bulkUpdate";
+          await this.dbManager.bulkUpdate(INDEXDB_STORE_NAME, compactedToWrite);
+        } else if (typeof this.dbManager.bulkAdd === "function") {
+          writeMethod = "bulkAdd";
+          await this.dbManager.bulkAdd(INDEXDB_STORE_NAME, compactedToWrite);
+        } else if (typeof this.dbManager.update === "function") {
+          writeMethod = "update";
+          for (const order of compactedToWrite) {
+            await this.dbManager.update(INDEXDB_STORE_NAME, order);
+          }
+        }
+        this.recordRecentSqliteWrite(source, compactedToWrite);
+        this.logInfo("patchOrdersInSQLite-完成", {
+          source,
+          count: compactedToWrite.length,
+          writeMethod,
+          dedupedCount: skipped.length
+        });
       });
-      await this.dbManager.clear(INDEXDB_STORE_NAME);
-      this.logInfo("saveOrdersToSQLite-clear完成", {
-        count: orderList.length
+    } catch (error) {
+      this.logError("增量保存订单到 SQLite 失败", {
+        error: error instanceof Error ? error.message : String(error),
+        orderCount: ordersSnapshot.length
       });
-      if (orderList.length === 0)
-        return;
-      await this.dbManager.bulkAdd(INDEXDB_STORE_NAME, orderList);
-      this.logInfo("saveOrdersToSQLite-bulkAdd完成", {
-        count: orderList.length
+    }
+  }
+  /**
+   * 单条 upsert 订单到 SQLite；用于 overwriteExistingOrder 等单条覆盖场景。
+   *
+   * @example
+   * await this.updateOrderInSQLite(freshOrder)
+   */
+  async updateOrderInSQLite(order, source) {
+    if (!this.dbManager || !this.getOrderStorageKey(order)) {
+      return;
+    }
+    const orderSnapshot = (0, import_lodash_es.cloneDeep)(order);
+    try {
+      await this.runInOrderSQLiteSaveQueue(async () => {
+        let writeMethod = "none";
+        this.logInfo("updateOrderInSQLite-开始", {
+          source,
+          orderId: orderSnapshot.order_id ?? null,
+          storageKey: this.getOrderStorageKey(orderSnapshot)
+        });
+        if (typeof this.dbManager.update === "function") {
+          writeMethod = "update";
+          await this.dbManager.update(INDEXDB_STORE_NAME, orderSnapshot);
+        } else if (typeof this.dbManager.bulkUpdate === "function") {
+          writeMethod = "bulkUpdate";
+          await this.dbManager.bulkUpdate(INDEXDB_STORE_NAME, [orderSnapshot]);
+        } else if (typeof this.dbManager.bulkAdd === "function") {
+          writeMethod = "bulkAdd";
+          await this.dbManager.bulkAdd(INDEXDB_STORE_NAME, [orderSnapshot]);
+        }
+        this.recordRecentSqliteWrite(source, [orderSnapshot]);
+        this.logInfo("updateOrderInSQLite-完成", {
+          source,
+          orderId: orderSnapshot.order_id ?? null,
+          writeMethod
+        });
+      });
+    } catch (error) {
+      this.logError("单条保存订单到 SQLite 失败", {
+        error: error instanceof Error ? error.message : String(error),
+        orderId: orderSnapshot.order_id ?? null
+      });
+    }
+  }
+  /**
+   * 全量快照替换 orders 表（clear + bulkAdd），用于 SSE 全量拉取与营业日窗口裁剪。
+   *
+   * @example
+   * await this.replaceOrdersSnapshotInSQLite(orderList)
+   */
+  async replaceOrdersSnapshotInSQLite(orderList, source) {
+    if (!this.dbManager) {
+      return this.compactOrderListByIdentity(
+        orderList.map((order) => this.normalizeRemoteSyncedOrder(order)),
+        `${source}.snapshotNoDb`
+      ).list;
+    }
+    const remoteSnapshot = (0, import_lodash_es.cloneDeep)(orderList);
+    let mergedSnapshot = this.compactOrderListByIdentity(
+      remoteSnapshot.map((order) => this.normalizeRemoteSyncedOrder(order)),
+      `${source}.remoteSnapshot`
+    ).list;
+    try {
+      await this.runInOrderSQLiteSaveQueue(async () => {
+        const existingOrders = typeof this.dbManager.getAll === "function" ? await this.dbManager.getAll(INDEXDB_STORE_NAME) : [];
+        const orderListSnapshot = this.mergeRemoteSnapshotWithPendingOrders(
+          remoteSnapshot,
+          existingOrders || []
+        );
+        mergedSnapshot = this.compactOrderListByIdentity(orderListSnapshot, `${source}.sqliteSnapshot`).list;
+        this.logInfo("replaceOrdersSnapshotInSQLite-开始", {
+          source,
+          count: mergedSnapshot.length,
+          remoteCount: remoteSnapshot.length,
+          preservedPendingCount: mergedSnapshot.length - remoteSnapshot.length
+        });
+        await this.dbManager.clear(INDEXDB_STORE_NAME);
+        this.logInfo("replaceOrdersSnapshotInSQLite-clear完成", {
+          count: mergedSnapshot.length
+        });
+        if (mergedSnapshot.length === 0) {
+          return;
+        }
+        await this.dbManager.bulkAdd(INDEXDB_STORE_NAME, mergedSnapshot);
+        this.recordRecentSqliteWrite(source, mergedSnapshot);
+        this.logInfo("replaceOrdersSnapshotInSQLite-bulkAdd完成", {
+          source,
+          count: mergedSnapshot.length
+        });
       });
     } catch (error) {
-      this.logError("保存订单到 SQLite 失败", {
+      this.logError("全量保存订单到 SQLite 失败", {
         error: error instanceof Error ? error.message : String(error),
-        orderList: orderList.length
+        orderList: remoteSnapshot.length
       });
     }
+    return mergedSnapshot;
   }
+  /**
+   * 清空订单模块的内存数据和本地 SQLite 订单表。
+   *
+   * @example
+   * await orderModule.clear()
+   */
   async clear() {
     this.store.list = [];
     this.store.map = /* @__PURE__ */ new Map();
     this.resourceIdIndex.clear();
     if (this.dbManager) {
-      await this.dbManager.clear(INDEXDB_STORE_NAME);
+      await this.runInOrderSQLiteSaveQueue(async () => {
+        await this.dbManager.clear(INDEXDB_STORE_NAME);
+      });
     }
     this.setStorageItem(ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY, "");
-    this.core.effects.emit(import_types.OrderHooks.onOrdersChanged, this.store.list);
+    this.emitOrdersChanged([], "clear");
   }
 };
 // Annotate the CommonJS export names for ESM import in node: