@pisell/pisellos 2.3.61 → 2.3.62

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

@@ -42,6 +42,7 @@ import { getOrderPaymentIdentityKeys, isIdentifiedPendingOrderPayment, isPending
  */
 var INDEXDB_STORE_NAME = 'orders';
 var ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY = 'server_order_last_full_fetch_at';
+var ORDER_LAST_FULL_FETCH_SHOP_ID_STORAGE_KEY = 'server_order_last_full_fetch_shop_id';
 var ORDER_SYNC_THROTTLE_MS_STORAGE_KEY = 'order_sync_throttle_ms';
 var DEFAULT_ORDER_SYNC_THROTTLE_MS = 2000;
 /** pubsub 回声写入去重窗口：业务 API 刚写入后，跳过同单 SQLite patch */
@@ -700,26 +701,78 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     key: "preload",
     value: function () {
       var _preload = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee4() {
-        var orders;
+        var preloadStartedAt, cachedOrders, memoryOrders, orders;
         return _regeneratorRuntime().wrap(function _callee4$(_context4) {
           while (1) switch (_context4.prev = _context4.next) {
             case 0:
-              _context4.next = 2;
-              return this.loadOrdersByServer();
-            case 2:
+              preloadStartedAt = Date.now();
+              cachedOrders = null;
+              if (!this.dbManager) {
+                _context4.next = 12;
+                break;
+              }
+              _context4.prev = 3;
+              _context4.next = 6;
+              return this.loadOrdersFromSQLite({
+                throwOnError: true
+              });
+            case 6:
+              cachedOrders = _context4.sent;
+              _context4.next = 12;
+              break;
+            case 9:
+              _context4.prev = 9;
+              _context4.t0 = _context4["catch"](3);
+              this.logWarning('preload-SQLite读取失败，回退远端全量拉取', {
+                error: _context4.t0 instanceof Error ? _context4.t0.message : String(_context4.t0)
+              });
+            case 12:
+              if (!(cachedOrders !== null && this.hasPulledOrdersToday())) {
+                _context4.next = 22;
+                break;
+              }
+              memoryOrders = this.normalizeOrdersForMemoryList(cachedOrders, 'preload.sqliteMemory');
+              this.store.list = cloneDeep(memoryOrders);
+              this.syncOrdersMap();
+              _context4.next = 18;
+              return this.core.effects.emit(OrderHooks.onOrdersLoaded, this.store.list);
+            case 18:
+              _context4.next = 20;
+              return this.emitOrdersChanged([], 'preload.sqlite');
+            case 20:
+              this.logInfo('预加载完成', {
+                trigger: 'preload',
+                source: 'SQLite',
+                orderCount: this.store.list.length,
+                duration: "".concat(Date.now() - preloadStartedAt, "ms")
+              });
+              return _context4.abrupt("return");
+            case 22:
+              _context4.next = 24;
+              return this.loadOrdersByServer({
+                trigger: 'preload'
+              });
+            case 24:
               orders = _context4.sent;
               this.store.list = cloneDeep(orders);
               this.syncOrdersMap();
-              _context4.next = 7;
+              _context4.next = 29;
               return this.emitOrdersChanged([], 'preload');
-            case 7:
-              _context4.next = 9;
+            case 29:
+              _context4.next = 31;
               return this.core.effects.emit(OrderHooks.onOrdersSyncCompleted, null);
-            case 9:
+            case 31:
+              this.logInfo('预加载完成', {
+                trigger: 'preload',
+                source: 'Server',
+                orderCount: this.store.list.length,
+                duration: "".concat(Date.now() - preloadStartedAt, "ms")
+              });
+            case 32:
             case "end":
               return _context4.stop();
           }
-        }, _callee4, this);
+        }, _callee4, this, [[3, 9]]);
       }));
       function preload() {
         return _preload.apply(this, arguments);
@@ -1052,18 +1105,32 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       var _loadOrdersByServer = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee8() {
         var _this5 = this,
           _this$store;
-        var orderList, protectedOrdersBeforeRemoteFetch, data, mergedOrders, memoryOrders;
+        var options,
+          orderList,
+          hasFetchedRemoteSnapshot,
+          trigger,
+          protectedOrdersBeforeRemoteFetch,
+          data,
+          _yield$this$replaceOr,
+          mergedOrders,
+          isRemoteSnapshotPersisted,
+          memoryOrders,
+          _args8 = arguments;
         return _regeneratorRuntime().wrap(function _callee8$(_context8) {
           while (1) switch (_context8.prev = _context8.next) {
             case 0:
+              options = _args8.length > 0 && _args8[0] !== undefined ? _args8[0] : {};
               orderList = [];
-              _context8.next = 3;
+              hasFetchedRemoteSnapshot = false;
+              trigger = options.trigger || 'unknown';
+              _context8.next = 6;
               return this.loadOrdersFromSQLite();
-            case 3:
+            case 6:
               protectedOrdersBeforeRemoteFetch = _context8.sent.filter(function (order) {
                 return _this5.shouldProtectLocalOrderFromRemoteSnapshot(order);
               });
               this.logInfo('loadOrdersByServer-开始', {
+                trigger: trigger,
                 hasOrderDataSource: !!this.orderDataSource,
                 query: ((_this$store = this.store) === null || _this$store === void 0 ? void 0 : _this$store.createdAtQuery) || null,
                 protectedLocalOrderCount: protectedOrdersBeforeRemoteFetch.length,
@@ -1072,51 +1139,61 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 }, 0)
               });
               if (!this.orderDataSource) {
-                _context8.next = 20;
+                _context8.next = 23;
                 break;
               }
-              _context8.prev = 6;
-              _context8.next = 9;
+              _context8.prev = 9;
+              _context8.next = 12;
               return this.orderDataSource.run({
                 sse: {
                   query: this.store.createdAtQuery
                 }
               });
-            case 9:
+            case 12:
               data = _context8.sent;
               orderList = data || [];
               this.logInfo('loadOrdersByServer-SSE拉取成功', {
+                trigger: trigger,
                 count: orderList.length
               });
-              this.markOrderPulledAtNow();
+              hasFetchedRemoteSnapshot = true;
               this.lastServerFullFetchAtMs = Date.now();
-              _context8.next = 20;
+              _context8.next = 23;
               break;
-            case 16:
-              _context8.prev = 16;
-              _context8.t0 = _context8["catch"](6);
+            case 19:
+              _context8.prev = 19;
+              _context8.t0 = _context8["catch"](9);
               this.logInfo('loadOrdersByServer-SSE拉取失败，保持当前内存订单');
               return _context8.abrupt("return", this.store.list);
-            case 20:
-              _context8.next = 22;
+            case 23:
+              if (hasFetchedRemoteSnapshot) {
+                this.clearOrderSnapshotMarker();
+              }
+              _context8.next = 26;
               return this.replaceOrdersSnapshotInSQLite(orderList, 'loadOrdersByServer', protectedOrdersBeforeRemoteFetch);
-            case 22:
-              mergedOrders = _context8.sent;
+            case 26:
+              _yield$this$replaceOr = _context8.sent;
+              mergedOrders = _yield$this$replaceOr.orders;
+              isRemoteSnapshotPersisted = _yield$this$replaceOr.persisted;
+              if (hasFetchedRemoteSnapshot && isRemoteSnapshotPersisted) {
+                this.markOrderPulledAtNow();
+              }
               memoryOrders = this.normalizeOrdersForMemoryList(mergedOrders, 'loadOrdersByServer.memory');
               this.logInfo('loadOrdersByServer-结束', {
+                trigger: trigger,
                 count: memoryOrders.length,
                 persistedCount: mergedOrders.length,
                 sqliteOnlyDraftCount: mergedOrders.length - memoryOrders.length
               });
-              _context8.next = 27;
+              _context8.next = 34;
               return this.core.effects.emit(OrderHooks.onOrdersLoaded, memoryOrders);
-            case 27:
+            case 34:
               return _context8.abrupt("return", memoryOrders);
-            case 28:
+            case 35:
             case "end":
               return _context8.stop();
           }
-        }, _callee8, this, [[6, 16]]);
+        }, _callee8, this, [[9, 19]]);
       }));
       function loadOrdersByServer() {
         return _loadOrdersByServer.apply(this, arguments);
@@ -1132,53 +1209,76 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     key: "silentRefresh",
     value: (function () {
       var _silentRefresh = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee9() {
-        var startTime, elapsedSinceFullFetch, orders, errorMessage;
+        var options,
+          startTime,
+          trigger,
+          elapsedSinceFullFetch,
+          orders,
+          errorMessage,
+          _args9 = arguments;
         return _regeneratorRuntime().wrap(function _callee9$(_context9) {
           while (1) switch (_context9.prev = _context9.next) {
             case 0:
+              options = _args9.length > 0 && _args9[0] !== undefined ? _args9[0] : {};
               startTime = Date.now();
+              trigger = options.trigger || 'background';
               elapsedSinceFullFetch = Date.now() - this.lastServerFullFetchAtMs;
               if (!(this.lastServerFullFetchAtMs > 0 && elapsedSinceFullFetch < ORDER_SILENT_REFRESH_MIN_INTERVAL_MS)) {
-                _context9.next = 4;
+                _context9.next = 7;
                 break;
               }
+              this.logInfo('silentRefresh 跳过全量 SSE', {
+                trigger: trigger,
+                reason: 'within_min_interval',
+                minIntervalMs: ORDER_SILENT_REFRESH_MIN_INTERVAL_MS,
+                elapsedSinceFullFetchMs: elapsedSinceFullFetch,
+                orderCount: this.store.list.length
+              });
               return _context9.abrupt("return", this.store.list);
-            case 4:
-              this.logInfo('silentRefresh 开始');
-              _context9.prev = 5;
+            case 7:
+              this.logInfo('silentRefresh 开始', {
+                trigger: trigger,
+                elapsedSinceFullFetchMs: elapsedSinceFullFetch,
+                orderCount: this.store.list.length
+              });
+              _context9.prev = 8;
               // 刷新前，需要更新当前营业日边界（store.createdAtQuery）
               this.updateCreateStore();
-              _context9.next = 9;
-              return this.loadOrdersByServer();
-            case 9:
+              _context9.next = 12;
+              return this.loadOrdersByServer({
+                trigger: trigger
+              });
+            case 12:
               orders = _context9.sent;
               this.store.list = cloneDeep(orders);
               this.syncOrdersMap();
-              _context9.next = 14;
+              _context9.next = 17;
               return this.emitOrdersChanged([], 'silentRefresh');
-            case 14:
-              _context9.next = 16;
+            case 17:
+              _context9.next = 19;
               return this.core.effects.emit(OrderHooks.onOrdersSyncCompleted, null);
-            case 16:
+            case 19:
               this.logInfo('silentRefresh 完成', {
+                trigger: trigger,
                 orderCount: orders.length,
                 duration: "".concat(Date.now() - startTime, "ms")
               });
               return _context9.abrupt("return", this.store.list);
-            case 20:
-              _context9.prev = 20;
-              _context9.t0 = _context9["catch"](5);
+            case 23:
+              _context9.prev = 23;
+              _context9.t0 = _context9["catch"](8);
               errorMessage = _context9.t0 instanceof Error ? _context9.t0.message : String(_context9.t0);
               this.logError('silentRefresh 失败', {
+                trigger: trigger,
                 duration: "".concat(Date.now() - startTime, "ms"),
                 error: errorMessage
               });
               return _context9.abrupt("return", this.store.list);
-            case 25:
+            case 28:
             case "end":
               return _context9.stop();
           }
-        }, _callee9, this, [[5, 20]]);
+        }, _callee9, this, [[8, 23]]);
       }));
       function silentRefresh() {
         return _silentRefresh.apply(this, arguments);
@@ -3193,25 +3293,32 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     }
 
     /**
-     * 当前订单拉取窗口：
-     * - 优先使用 createdAtQuery.sales_time_between（已按营业日边界初始化）
-     * - 无法解析时退化为自然日窗口
+     * 当前订单缓存可复用窗口。
+     * start_time 模式使用精确的营业日起止时间；配置缺失或异常时退化为自然日。
      */
   }, {
-    key: "getCurrentPullWindow",
-    value: function getCurrentPullWindow() {
-      var _this$store2;
+    key: "getCurrentOrderCacheWindow",
+    value: function getCurrentOrderCacheWindow() {
       var now = dayjs();
-      var range = (_this$store2 = this.store) === null || _this$store2 === void 0 || (_this$store2 = _this$store2.createdAtQuery) === null || _this$store2 === void 0 ? void 0 : _this$store2.sales_time_between;
-      if (Array.isArray(range) && range.length >= 2) {
-        var _startAt = dayjs(range[0]);
-        var endExclusiveAt = dayjs(range[1]);
-        if (_startAt.isValid() && endExclusiveAt.isValid() && endExclusiveAt.isAfter(_startAt)) {
-          return {
-            startAt: _startAt,
-            endExclusiveAt: endExclusiveAt
-          };
+      try {
+        var _coreData$core;
+        var appPlugin = this.core.getPlugin('app');
+        var app = appPlugin === null || appPlugin === void 0 ? void 0 : appPlugin.getApp();
+        var coreData = app === null || app === void 0 ? void 0 : app.data.store.getStore().getDataByModel('core');
+        var boundary = coreData === null || coreData === void 0 || (_coreData$core = coreData.core) === null || _coreData$core === void 0 ? void 0 : _coreData$core.operating_day_boundary;
+        if ((boundary === null || boundary === void 0 ? void 0 : boundary.type) === 'start_time') {
+          var boundaryTime = String(boundary.time || '').trim();
+          var todayBoundary = dayjs("".concat(now.format('YYYY-MM-DD'), " ").concat(boundaryTime));
+          if (todayBoundary.isValid()) {
+            var _startAt = now.isBefore(todayBoundary) ? todayBoundary.subtract(1, 'day') : todayBoundary;
+            return {
+              startAt: _startAt,
+              endExclusiveAt: _startAt.add(1, 'day')
+            };
+          }
         }
+      } catch (_unused6) {
+        // 读取营业日配置失败时按自然日兜底，不影响启动。
       }
       var startAt = now.startOf('day');
       return {
@@ -3224,20 +3331,47 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     value: function hasPulledOrdersToday() {
       var lastFullFetchAt = this.getStorageItem(ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY);
       if (!lastFullFetchAt) return false;
+      var currentShopId = this.getCurrentShopId();
+      var lastFullFetchShopId = this.getStorageItem(ORDER_LAST_FULL_FETCH_SHOP_ID_STORAGE_KEY);
+      if (!currentShopId || !lastFullFetchShopId || currentShopId !== lastFullFetchShopId) {
+        return false;
+      }
       var parsed = dayjs(lastFullFetchAt);
       if (!parsed.isValid()) return false;
-
-      // 按当前拉取窗口判断，而不是自然日判断。
-      // 这样在营业日跨日边界（start_time）场景下也能正确判定是否需要重新拉取。
-      var _this$getCurrentPullW = this.getCurrentPullWindow(),
-        startAt = _this$getCurrentPullW.startAt,
-        endExclusiveAt = _this$getCurrentPullW.endExclusiveAt;
+      var _this$getCurrentOrder = this.getCurrentOrderCacheWindow(),
+        startAt = _this$getCurrentOrder.startAt,
+        endExclusiveAt = _this$getCurrentOrder.endExclusiveAt;
       return (parsed.isAfter(startAt) || parsed.isSame(startAt)) && parsed.isBefore(endExclusiveAt);
     }
   }, {
     key: "markOrderPulledAtNow",
     value: function markOrderPulledAtNow() {
+      var currentShopId = this.getCurrentShopId();
+      if (!currentShopId) return;
       this.setStorageItem(ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY, dayjs().format('YYYY-MM-DD HH:mm:ss'));
+      this.setStorageItem(ORDER_LAST_FULL_FETCH_SHOP_ID_STORAGE_KEY, currentShopId);
+    }
+  }, {
+    key: "clearOrderSnapshotMarker",
+    value: function clearOrderSnapshotMarker() {
+      this.setStorageItem(ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY, '');
+      this.setStorageItem(ORDER_LAST_FULL_FETCH_SHOP_ID_STORAGE_KEY, '');
+    }
+  }, {
+    key: "getCurrentShopId",
+    value: function getCurrentShopId() {
+      try {
+        var _coreData$core2;
+        var appPlugin = this.core.getPlugin('app');
+        var app = appPlugin === null || appPlugin === void 0 ? void 0 : appPlugin.getApp();
+        if (!app) return null;
+        var coreData = app.data.store.getStore().getDataByModel('core');
+        var shopId = coreData === null || coreData === void 0 || (_coreData$core2 = coreData.core) === null || _coreData$core2 === void 0 ? void 0 : _coreData$core2.id;
+        if (shopId === undefined || shopId === null || shopId === '') return null;
+        return String(shopId);
+      } catch (_unused7) {
+        return null;
+      }
     }
   }, {
     key: "getStorageItem",
@@ -3248,7 +3382,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
         if (typeof globalThis !== 'undefined' && globalThis !== null && globalThis !== void 0 && globalThis.localStorage) {
           return globalThis.localStorage.getItem(key);
         }
-      } catch (_unused6) {
+      } catch (_unused8) {
         // 忽略存储异常，避免影响主流程
       }
       return null;
@@ -3265,7 +3399,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
         if (typeof globalThis !== 'undefined' && globalThis !== null && globalThis !== void 0 && globalThis.localStorage) {
           globalThis.localStorage.setItem(key, value);
         }
-      } catch (_unused7) {
+      } catch (_unused9) {
         // 忽略存储异常，避免影响主流程
       }
     }
@@ -3274,33 +3408,42 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     value: function () {
       var _loadOrdersFromSQLite = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee20() {
         var _this20 = this;
-        var orders;
+        var options,
+          orders,
+          _args20 = arguments;
         return _regeneratorRuntime().wrap(function _callee20$(_context20) {
           while (1) switch (_context20.prev = _context20.next) {
             case 0:
+              options = _args20.length > 0 && _args20[0] !== undefined ? _args20[0] : {};
               if (this.dbManager) {
-                _context20.next = 2;
+                _context20.next = 3;
                 break;
               }
               return _context20.abrupt("return", []);
-            case 2:
-              _context20.prev = 2;
-              _context20.next = 5;
+            case 3:
+              _context20.prev = 3;
+              _context20.next = 6;
               return this.dbManager.getAll(INDEXDB_STORE_NAME);
-            case 5:
+            case 6:
               orders = _context20.sent;
               return _context20.abrupt("return", (orders || []).map(function (order) {
                 return _this20.normalizeOrderCollectionsForIngress(order, 'loadOrdersFromSQLite');
               }));
-            case 9:
-              _context20.prev = 9;
-              _context20.t0 = _context20["catch"](2);
+            case 10:
+              _context20.prev = 10;
+              _context20.t0 = _context20["catch"](3);
+              if (!options.throwOnError) {
+                _context20.next = 14;
+                break;
+              }
+              throw _context20.t0;
+            case 14:
               return _context20.abrupt("return", []);
-            case 12:
+            case 15:
             case "end":
               return _context20.stop();
           }
-        }, _callee20, this, [[2, 9]]);
+        }, _callee20, this, [[3, 10]]);
       }));
       function loadOrdersFromSQLite() {
         return _loadOrdersFromSQLite.apply(this, arguments);
@@ -3740,7 +3883,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
      * 用于 SSE 全量拉取与营业日窗口裁剪。
      *
      * @example
-     * await this.replaceOrdersSnapshotInSQLite(orderList)
+     * const { orders, persisted } = await this.replaceOrdersSnapshotInSQLite(orderList, 'refresh')
      */
     )
   }, {
@@ -3751,6 +3894,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
         var protectedOrdersBeforeRemoteFetch,
           remoteSnapshot,
           mergedSnapshot,
+          persisted,
           _args27 = arguments;
         return _regeneratorRuntime().wrap(function _callee27$(_context27) {
           while (1) switch (_context27.prev = _context27.next) {
@@ -3760,9 +3904,12 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 _context27.next = 3;
                 break;
               }
-              return _context27.abrupt("return", this.compactOrderListByIdentity(orderList.map(function (order) {
-                return _this24.normalizeRemoteSyncedOrder(order);
-              }), "".concat(source, ".snapshotNoDb")).list);
+              return _context27.abrupt("return", {
+                orders: this.compactOrderListByIdentity(orderList.map(function (order) {
+                  return _this24.normalizeRemoteSyncedOrder(order);
+                }), "".concat(source, ".snapshotNoDb")).list,
+                persisted: false
+              });
             case 3:
               remoteSnapshot = cloneDeep(orderList).map(function (order) {
                 return _this24.normalizeOrderCollectionsForIngress(order, "".concat(source, ".remoteIngress"));
@@ -3770,8 +3917,9 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               mergedSnapshot = this.compactOrderListByIdentity(remoteSnapshot.map(function (order) {
                 return _this24.normalizeRemoteSyncedOrder(order);
               }), "".concat(source, ".remoteSnapshot")).list;
-              _context27.prev = 5;
-              _context27.next = 8;
+              persisted = false;
+              _context27.prev = 6;
+              _context27.next = 9;
               return this.runInOrderSQLiteSaveQueue( /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee26() {
                 var existingOrders, protectedLocalOrders, _iterator33, _step33, rawCurrentOrder, currentOrder, protectedIndex, currentNeedsProtection, orderListSnapshot;
                 return _regeneratorRuntime().wrap(function _callee26$(_context26) {
@@ -3884,23 +4032,27 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                   }
                 }, _callee26, null, [[10, 25, 28, 31]]);
               })));
-            case 8:
-              _context27.next = 13;
+            case 9:
+              persisted = true;
+              _context27.next = 15;
               break;
-            case 10:
-              _context27.prev = 10;
-              _context27.t0 = _context27["catch"](5);
+            case 12:
+              _context27.prev = 12;
+              _context27.t0 = _context27["catch"](6);
               this.logError('全量保存订单到 SQLite 失败', {
                 error: _context27.t0 instanceof Error ? _context27.t0.message : String(_context27.t0),
                 orderList: remoteSnapshot.length
               });
-            case 13:
-              return _context27.abrupt("return", mergedSnapshot);
-            case 14:
+            case 15:
+              return _context27.abrupt("return", {
+                orders: mergedSnapshot,
+                persisted: persisted
+              });
+            case 16:
             case "end":
               return _context27.stop();
           }
-        }, _callee27, this, [[5, 10]]);
+        }, _callee27, this, [[6, 12]]);
       }));
       function replaceOrdersSnapshotInSQLite(_x20, _x21) {
         return _replaceOrdersSnapshotInSQLite.apply(this, arguments);
@@ -3942,7 +4094,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 }, _callee28);
               })));
             case 5:
-              this.setStorageItem(ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY, '');
+              this.clearOrderSnapshotMarker();
               this.emitOrdersChanged([], 'clear');
             case 7:
             case "end":

package/dist/server/modules/products/index.d.ts

@@ -25,6 +25,7 @@ export declare class ProductsModule extends BaseModule implements Module {
     private quotationBridgeLoadedKey?;
     private quotationBridgeRefreshPromise?;
     private quotationBridgeRefreshKey?;
+    private quotationBridgeUpdatedCallback?;
     private quotationScheduleCache;
     private quotationScheduleCacheSource;
     private quotationScheduleCacheLoaded;
@@ -72,6 +73,7 @@ export declare class ProductsModule extends BaseModule implements Module {
         scheduleModule?: any;
         channel?: string;
         customer_id?: number | string;
+        onQuotationUpdated?: () => void;
     }): Promise<void>;
     /**
      * 刷新桥接器内的报价单列表。
@@ -181,7 +183,9 @@ export declare class ProductsModule extends BaseModule implements Module {
     /**
      * 通过 ProductDataSource SSE 加载完整商品列表
      */
-    loadProductsByServer(): Promise<any>;
+    loadProductsByServer(options?: {
+        trigger?: string;
+    }): Promise<any>;
     /**
      * 纯请求方法：通过 HTTP 接口获取商品列表（无副作用，不触发事件、不写 IndexDB）
      * @param params 查询参数
@@ -331,7 +335,9 @@ export declare class ProductsModule extends BaseModule implements Module {
      * 拿到完整数据后一次性替换 store，清除价格缓存，触发 onProductsSyncCompleted
      * @returns 刷新后的商品列表
      */
-    silentRefresh(): Promise<ProductData[]>;
+    silentRefresh(options?: {
+        trigger?: string;
+    }): Promise<ProductData[]>;
     /**
      * 销毁同步资源（取消 pubsub 订阅、清除定时器）
      */