@pisell/pisellos 2.2.148 → 2.2.149

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

@@ -277,14 +277,60 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     value: function getOrderByOrderId(orderId) {
       return this.store.map.get(this.getIdKey(orderId));
     }
+  }, {
+    key: "getLocalOrderByOrderId",
+    value: function () {
+      var _getLocalOrderByOrderId = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee4(orderId) {
+        var _this3 = this;
+        var key, memoryOrder, orders, localOrder;
+        return _regeneratorRuntime().wrap(function _callee4$(_context4) {
+          while (1) switch (_context4.prev = _context4.next) {
+            case 0:
+              key = this.getIdKey(orderId);
+              memoryOrder = this.store.map.get(key);
+              if (!memoryOrder) {
+                _context4.next = 4;
+                break;
+              }
+              return _context4.abrupt("return", memoryOrder);
+            case 4:
+              _context4.next = 6;
+              return this.loadOrdersFromSQLite();
+            case 6:
+              orders = _context4.sent;
+              localOrder = orders.find(function (order) {
+                var id = order === null || order === void 0 ? void 0 : order.order_id;
+                if (id === undefined || id === null) return false;
+                return _this3.getIdKey(id) === key;
+              });
+              if (localOrder) {
+                _context4.next = 10;
+                break;
+              }
+              return _context4.abrupt("return", null);
+            case 10:
+              this.store.list = orders;
+              this.syncOrdersMap();
+              return _context4.abrupt("return", localOrder);
+            case 13:
+            case "end":
+              return _context4.stop();
+          }
+        }, _callee4, this);
+      }));
+      function getLocalOrderByOrderId(_x3) {
+        return _getLocalOrderByOrderId.apply(this, arguments);
+      }
+      return getLocalOrderByOrderId;
+    }()
   }, {
     key: "loadOrdersByServer",
     value: function () {
-      var _loadOrdersByServer = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee4() {
+      var _loadOrdersByServer = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee5() {
         var _this$store;
         var orderList, data;
-        return _regeneratorRuntime().wrap(function _callee4$(_context4) {
-          while (1) switch (_context4.prev = _context4.next) {
+        return _regeneratorRuntime().wrap(function _callee5$(_context5) {
+          while (1) switch (_context5.prev = _context5.next) {
             case 0:
               orderList = [];
               this.logInfo('loadOrdersByServer-开始', {
@@ -292,46 +338,46 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 query: ((_this$store = this.store) === null || _this$store === void 0 ? void 0 : _this$store.createdAtQuery) || null
               });
               if (!this.orderDataSource) {
-                _context4.next = 16;
+                _context5.next = 16;
                 break;
               }
-              _context4.prev = 3;
-              _context4.next = 6;
+              _context5.prev = 3;
+              _context5.next = 6;
               return this.orderDataSource.run({
                 sse: {
                   query: this.store.createdAtQuery
                 }
               });
             case 6:
-              data = _context4.sent;
+              data = _context5.sent;
               orderList = data || [];
               this.logInfo('loadOrdersByServer-SSE拉取成功', {
                 count: orderList.length
               });
               this.markOrderPulledAtNow();
-              _context4.next = 16;
+              _context5.next = 16;
               break;
             case 12:
-              _context4.prev = 12;
-              _context4.t0 = _context4["catch"](3);
+              _context5.prev = 12;
+              _context5.t0 = _context5["catch"](3);
               orderList = [];
               this.logInfo('loadOrdersByServer-SSE拉取失败，回退为空数组');
             case 16:
-              _context4.next = 18;
+              _context5.next = 18;
               return this.saveOrdersToSQLite(orderList);
             case 18:
               this.logInfo('loadOrdersByServer-结束', {
                 count: orderList.length
               });
-              _context4.next = 21;
+              _context5.next = 21;
               return this.core.effects.emit(OrderHooks.onOrdersLoaded, orderList);
             case 21:
-              return _context4.abrupt("return", orderList);
+              return _context5.abrupt("return", orderList);
             case 22:
             case "end":
-              return _context4.stop();
+              return _context5.stop();
           }
-        }, _callee4, this, [[3, 12]]);
+        }, _callee5, this, [[3, 12]]);
       }));
       function loadOrdersByServer() {
         return _loadOrdersByServer.apply(this, arguments);
@@ -341,10 +387,10 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "getOrdersByResourceId",
     value: function getOrdersByResourceId(resourceId) {
-      var _this3 = this;
+      var _this4 = this;
       var ids = this.resourceIdIndex.get(String(resourceId)) || [];
       return ids.map(function (id) {
-        return _this3.store.map.get(id);
+        return _this4.store.map.get(id);
       }).filter(function (order) {
         return !!order;
       });
@@ -357,31 +403,31 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "overwriteExistingOrder",
     value: (function () {
-      var _overwriteExistingOrder = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee5(fresh) {
-        var _this4 = this;
+      var _overwriteExistingOrder = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee6(fresh) {
+        var _this5 = this;
         var orderId, key;
-        return _regeneratorRuntime().wrap(function _callee5$(_context5) {
-          while (1) switch (_context5.prev = _context5.next) {
+        return _regeneratorRuntime().wrap(function _callee6$(_context6) {
+          while (1) switch (_context6.prev = _context6.next) {
             case 0:
               orderId = fresh === null || fresh === void 0 ? void 0 : fresh.order_id;
               if (!(orderId === undefined || orderId === null)) {
-                _context5.next = 4;
+                _context6.next = 4;
                 break;
               }
               this.logError('overwriteExistingOrder-入参缺少 order_id');
-              return _context5.abrupt("return", {
+              return _context6.abrupt("return", {
                 overwritten: false
               });
             case 4:
               key = this.getIdKey(orderId);
               if (this.store.map.has(key)) {
-                _context5.next = 8;
+                _context6.next = 8;
                 break;
               }
               this.logInfo('overwriteExistingOrder-本地不存在该订单，跳过', {
                 orderId: orderId
               });
-              return _context5.abrupt("return", {
+              return _context6.abrupt("return", {
                 overwritten: false
               });
             case 8:
@@ -392,29 +438,29 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               this.store.list = this.store.list.map(function (order) {
                 var id = order === null || order === void 0 ? void 0 : order.order_id;
                 if (id === undefined || id === null) return order;
-                return _this4.getIdKey(id) === key ? fresh : order;
+                return _this5.getIdKey(id) === key ? fresh : order;
               });
               this.syncOrdersMap();
-              _context5.next = 13;
+              _context6.next = 13;
               return this.saveOrdersToSQLite(this.store.list);
             case 13:
               this.logInfo('overwriteExistingOrder-结束', {
                 orderId: orderId,
                 storeOrderCountAfter: this.store.list.length
               });
-              _context5.next = 16;
+              _context6.next = 16;
               return this.core.effects.emit(OrderHooks.onOrdersChanged, this.store.list);
             case 16:
-              return _context5.abrupt("return", {
+              return _context6.abrupt("return", {
                 overwritten: true
               });
             case 17:
             case "end":
-              return _context5.stop();
+              return _context6.stop();
           }
-        }, _callee5, this);
+        }, _callee6, this);
       }));
-      function overwriteExistingOrder(_x3) {
+      function overwriteExistingOrder(_x4) {
         return _overwriteExistingOrder.apply(this, arguments);
       }
       return overwriteExistingOrder;
@@ -427,29 +473,29 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "upsertOrdersFromRemote",
     value: (function () {
-      var _upsertOrdersFromRemote = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee6(freshOrders) {
-        return _regeneratorRuntime().wrap(function _callee6$(_context6) {
-          while (1) switch (_context6.prev = _context6.next) {
+      var _upsertOrdersFromRemote = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee7(freshOrders) {
+        return _regeneratorRuntime().wrap(function _callee7$(_context7) {
+          while (1) switch (_context7.prev = _context7.next) {
             case 0:
               if (freshOrders !== null && freshOrders !== void 0 && freshOrders.length) {
-                _context6.next = 3;
+                _context7.next = 3;
                 break;
               }
               this.logInfo('upsertOrdersFromRemote-订单列表为空', {});
-              return _context6.abrupt("return");
+              return _context7.abrupt("return");
             case 3:
               this.logInfo('upsertOrdersFromRemote-开始', {
                 count: freshOrders.length
               });
-              _context6.next = 6;
+              _context7.next = 6;
               return this.mergeOrdersToStore(freshOrders);
             case 6:
             case "end":
-              return _context6.stop();
+              return _context7.stop();
           }
-        }, _callee6, this);
+        }, _callee7, this);
       }));
-      function upsertOrdersFromRemote(_x4) {
+      function upsertOrdersFromRemote(_x5) {
         return _upsertOrdersFromRemote.apply(this, arguments);
       }
       return upsertOrdersFromRemote;
@@ -461,42 +507,42 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "fetchOrdersBySSE",
     value: (function () {
-      var _fetchOrdersBySSE = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee7() {
+      var _fetchOrdersBySSE = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee8() {
         var query,
           data,
-          _args7 = arguments;
-        return _regeneratorRuntime().wrap(function _callee7$(_context7) {
-          while (1) switch (_context7.prev = _context7.next) {
+          _args8 = arguments;
+        return _regeneratorRuntime().wrap(function _callee8$(_context8) {
+          while (1) switch (_context8.prev = _context8.next) {
             case 0:
-              query = _args7.length > 0 && _args7[0] !== undefined ? _args7[0] : {};
+              query = _args8.length > 0 && _args8[0] !== undefined ? _args8[0] : {};
               if (this.orderDataSource) {
-                _context7.next = 3;
+                _context8.next = 3;
                 break;
               }
-              return _context7.abrupt("return", []);
+              return _context8.abrupt("return", []);
             case 3:
-              _context7.prev = 3;
-              _context7.next = 6;
+              _context8.prev = 3;
+              _context8.next = 6;
               return this.orderDataSource.run({
                 sse: {
                   query: query
                 }
               });
             case 6:
-              data = _context7.sent;
-              return _context7.abrupt("return", data || []);
+              data = _context8.sent;
+              return _context8.abrupt("return", data || []);
             case 10:
-              _context7.prev = 10;
-              _context7.t0 = _context7["catch"](3);
+              _context8.prev = 10;
+              _context8.t0 = _context8["catch"](3);
               this.logError('fetchOrdersBySSE-失败', {
-                error: _context7.t0 instanceof Error ? _context7.t0.message : String(_context7.t0)
+                error: _context8.t0 instanceof Error ? _context8.t0.message : String(_context8.t0)
               });
-              return _context7.abrupt("return", []);
+              return _context8.abrupt("return", []);
             case 14:
             case "end":
-              return _context7.stop();
+              return _context8.stop();
           }
-        }, _callee7, this, [[3, 10]]);
+        }, _callee8, this, [[3, 10]]);
       }));
       function fetchOrdersBySSE() {
         return _fetchOrdersBySSE.apply(this, arguments);
@@ -524,7 +570,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "syncOrdersMap",
     value: function syncOrdersMap() {
-      var _this5 = this;
+      var _this6 = this;
       this.store.map.clear();
       this.resourceIdIndex.clear();
       var _iterator = _createForOfIteratorHelper(this.store.list),
@@ -534,20 +580,20 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
           var order = _step.value;
           var id = order.order_id;
           if (id === undefined || id === null) return 1; // continue
-          _this5.store.map.set(_this5.getIdKey(id), order);
-          var resourceIds = _this5.extractResourceIds(order);
+          _this6.store.map.set(_this6.getIdKey(id), order);
+          var resourceIds = _this6.extractResourceIds(order);
           var _iterator2 = _createForOfIteratorHelper(resourceIds),
             _step2;
           try {
             for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
               var resourceId = _step2.value;
               var key = String(resourceId);
-              var existing = _this5.resourceIdIndex.get(key) || [];
+              var existing = _this6.resourceIdIndex.get(key) || [];
               if (existing.some(function (eid) {
-                return _this5.getIdKey(eid) === _this5.getIdKey(id);
+                return _this6.getIdKey(eid) === _this6.getIdKey(id);
               })) continue;
               existing.push(id);
-              _this5.resourceIdIndex.set(key, existing);
+              _this6.resourceIdIndex.set(key, existing);
             }
           } catch (err) {
             _iterator2.e(err);
@@ -616,7 +662,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "setupOrderSync",
     value: function setupOrderSync() {
-      var _this6 = this;
+      var _this7 = this;
       if (!this.orderDataSource) return;
       this.orderDataSource.run({
         pubsub: {
@@ -624,20 +670,20 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
             var _message$id, _message$order_id, _message$type;
             console.log('orderDataSource');
             var pubsubReceivedAt = Date.now();
-            var message = _this6.normalizeOrderSyncMessage(res);
+            var message = _this7.normalizeOrderSyncMessage(res);
             if (!message) return;
             message._pubsubReceivedAt = pubsubReceivedAt;
-            _this6.pendingSyncMessages.push(message);
-            var throttleMs = _this6.getOrderSyncThrottleMs();
-            _this6.logInfo('orderSync-收到消息并入队', {
+            _this7.pendingSyncMessages.push(message);
+            var throttleMs = _this7.getOrderSyncThrottleMs();
+            _this7.logInfo('orderSync-收到消息并入队', {
               id: (_message$id = message.id) !== null && _message$id !== void 0 ? _message$id : null,
               order_id: (_message$order_id = message.order_id) !== null && _message$order_id !== void 0 ? _message$order_id : null,
               type: (_message$type = message.type) !== null && _message$type !== void 0 ? _message$type : null,
-              pendingCount: _this6.pendingSyncMessages.length,
+              pendingCount: _this7.pendingSyncMessages.length,
               throttleMs: throttleMs,
               pubsubReceivedAt: new Date(pubsubReceivedAt).toISOString()
             });
-            _this6.scheduleOrderSyncThrottle();
+            _this7.scheduleOrderSyncThrottle();
           }
         }
       }).catch(function () {
@@ -654,7 +700,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "scheduleOrderSyncThrottle",
     value: function scheduleOrderSyncThrottle() {
-      var _this7 = this;
+      var _this8 = this;
       if (this.isProcessingSyncBatch) return;
       if (this.isIdlePhase) {
         this.isIdlePhase = false;
@@ -665,8 +711,8 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       if (this.syncTimer) return;
       var throttleMs = this.getOrderSyncThrottleMs();
       this.syncTimer = setTimeout(function () {
-        _this7.syncTimer = undefined;
-        void _this7.flushOrderSyncMessagesByThrottle();
+        _this8.syncTimer = undefined;
+        void _this8.flushOrderSyncMessagesByThrottle();
       }, throttleMs);
     }
 
@@ -677,41 +723,41 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "flushOrderSyncMessagesByThrottle",
     value: (function () {
-      var _flushOrderSyncMessagesByThrottle = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee8() {
-        return _regeneratorRuntime().wrap(function _callee8$(_context8) {
-          while (1) switch (_context8.prev = _context8.next) {
+      var _flushOrderSyncMessagesByThrottle = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee9() {
+        return _regeneratorRuntime().wrap(function _callee9$(_context9) {
+          while (1) switch (_context9.prev = _context9.next) {
             case 0:
               if (!this.isProcessingSyncBatch) {
-                _context8.next = 2;
+                _context9.next = 2;
                 break;
               }
-              return _context8.abrupt("return");
+              return _context9.abrupt("return");
             case 2:
               if (!(this.pendingSyncMessages.length === 0)) {
-                _context8.next = 5;
+                _context9.next = 5;
                 break;
               }
               this.isIdlePhase = true;
-              return _context8.abrupt("return");
+              return _context9.abrupt("return");
             case 5:
               this.isProcessingSyncBatch = true;
-              _context8.prev = 6;
-              _context8.next = 9;
+              _context9.prev = 6;
+              _context9.next = 9;
               return this.processOrderSyncMessages();
             case 9:
-              _context8.prev = 9;
+              _context9.prev = 9;
               this.isProcessingSyncBatch = false;
               if (this.pendingSyncMessages.length > 0) {
                 this.scheduleOrderSyncThrottle();
               } else {
                 this.isIdlePhase = true;
               }
-              return _context8.finish(9);
+              return _context9.finish(9);
             case 13:
             case "end":
-              return _context8.stop();
+              return _context9.stop();
           }
-        }, _callee8, this, [[6,, 9, 13]]);
+        }, _callee9, this, [[6,, 9, 13]]);
       }));
       function flushOrderSyncMessagesByThrottle() {
         return _flushOrderSyncMessagesByThrottle.apply(this, arguments);
@@ -733,18 +779,18 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "processOrderSyncMessages",
     value: (function () {
-      var _processOrderSyncMessages = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee9() {
+      var _processOrderSyncMessages = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee10() {
         var messages, batchProcessStartAt, earliestReceivedAt, upsertOrders, refreshIds, _iterator3, _step3, _msg$id, _msg$relation_order_i, msg, hasBatchIds, singleId, hasSingleId, rawBody, normalizedBody, uniqueRefreshIds, upsertList, freshOrders, batchProcessEndAt;
-        return _regeneratorRuntime().wrap(function _callee9$(_context9) {
-          while (1) switch (_context9.prev = _context9.next) {
+        return _regeneratorRuntime().wrap(function _callee10$(_context10) {
+          while (1) switch (_context10.prev = _context10.next) {
             case 0:
               messages = _toConsumableArray(this.pendingSyncMessages);
               this.pendingSyncMessages = [];
               if (!(messages.length === 0)) {
-                _context9.next = 4;
+                _context10.next = 4;
                 break;
               }
-              return _context9.abrupt("return");
+              return _context10.abrupt("return");
             case 4:
               batchProcessStartAt = Date.now();
               earliestReceivedAt = Math.min.apply(Math, _toConsumableArray(messages.map(function (m) {
@@ -760,11 +806,11 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               upsertOrders = new Map();
               refreshIds = [];
               _iterator3 = _createForOfIteratorHelper(messages);
-              _context9.prev = 10;
+              _context10.prev = 10;
               _iterator3.s();
             case 12:
               if ((_step3 = _iterator3.n()).done) {
-                _context9.next = 25;
+                _context10.next = 25;
                 break;
               }
               msg = _step3.value;
@@ -774,27 +820,27 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               rawBody = msg.body || msg.data;
               normalizedBody = this.normalizeOrderSyncPayload(rawBody);
               if (!(hasSingleId && normalizedBody)) {
-                _context9.next = 22;
+                _context10.next = 22;
                 break;
               }
               upsertOrders.set(this.getIdKey(normalizedBody.order_id), normalizedBody);
-              return _context9.abrupt("continue", 23);
+              return _context10.abrupt("continue", 23);
             case 22:
               if (hasBatchIds) refreshIds.push.apply(refreshIds, _toConsumableArray(msg.ids));else if (hasSingleId) refreshIds.push(singleId);else if ((_msg$relation_order_i = msg.relation_order_ids) !== null && _msg$relation_order_i !== void 0 && _msg$relation_order_i.length) refreshIds.push.apply(refreshIds, _toConsumableArray(msg.relation_order_ids));
             case 23:
-              _context9.next = 12;
+              _context10.next = 12;
               break;
             case 25:
-              _context9.next = 30;
+              _context10.next = 30;
               break;
             case 27:
-              _context9.prev = 27;
-              _context9.t0 = _context9["catch"](10);
-              _iterator3.e(_context9.t0);
+              _context10.prev = 27;
+              _context10.t0 = _context10["catch"](10);
+              _iterator3.e(_context10.t0);
             case 30:
-              _context9.prev = 30;
+              _context10.prev = 30;
               _iterator3.f();
-              return _context9.finish(30);
+              return _context10.finish(30);
             case 33:
               uniqueRefreshIds = this.uniqueOrderIds(refreshIds);
               upsertList = _toConsumableArray(upsertOrders.values());
@@ -803,32 +849,32 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 refreshIdCount: uniqueRefreshIds.length
               });
               if (!(upsertList.length > 0)) {
-                _context9.next = 39;
+                _context10.next = 39;
                 break;
               }
-              _context9.next = 39;
+              _context10.next = 39;
               return this.mergeOrdersToStore(upsertList);
             case 39:
               if (!(uniqueRefreshIds.length > 0)) {
-                _context9.next = 46;
+                _context10.next = 46;
                 break;
               }
-              _context9.next = 42;
+              _context10.next = 42;
               return this.fetchOrdersByHttp(uniqueRefreshIds);
             case 42:
-              freshOrders = _context9.sent;
+              freshOrders = _context10.sent;
               if (!(freshOrders.length > 0)) {
-                _context9.next = 46;
+                _context10.next = 46;
                 break;
               }
-              _context9.next = 46;
+              _context10.next = 46;
               return this.mergeOrdersToStore(freshOrders);
             case 46:
               if (!(upsertList.length === 0 && uniqueRefreshIds.length === 0)) {
-                _context9.next = 48;
+                _context10.next = 48;
                 break;
               }
-              return _context9.abrupt("return");
+              return _context10.abrupt("return");
             case 48:
               batchProcessEndAt = Date.now();
               this.logInfo('processOrderSyncMessages-结束', {
@@ -837,13 +883,13 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 batchProcessDurationMs: batchProcessEndAt - batchProcessStartAt,
                 totalFromPubsubToProcessedMs: batchProcessEndAt - earliestReceivedAt
               });
-              _context9.next = 52;
+              _context10.next = 52;
               return this.core.effects.emit(OrderHooks.onOrdersSyncCompleted, null);
             case 52:
             case "end":
-              return _context9.stop();
+              return _context10.stop();
           }
-        }, _callee9, this, [[10, 27, 30, 33]]);
+        }, _callee10, this, [[10, 27, 30, 33]]);
       }));
       function processOrderSyncMessages() {
         return _processOrderSyncMessages.apply(this, arguments);
@@ -851,35 +897,42 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       return processOrderSyncMessages;
     }()
     /**
-     * 通过 HTTP 按 ids 增量拉取订单
+     * 通过 HTTP 按 ids 批量拉取订单详情（走 orderDataSource）。
+     *
+     * - 优先使用 `orderDataSource.fetchOrdersByIds`（如适配器实现了该方法）
+     * - 否则回退到 `orderDataSource.run({ http: { query: { ids } } })`
+     * - 失败统一返回空数组（由调用方按"返回缺失的 id" 判断单笔失败）
+     *
+     * @example
+     * const fresh = await orderModule.fetchOrdersByHttp(['96971', '96972'])
      */
     )
   }, {
     key: "fetchOrdersByHttp",
     value: (function () {
-      var _fetchOrdersByHttp = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee10(ids) {
+      var _fetchOrdersByHttp = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee11(ids) {
         var _orderList, orderList;
-        return _regeneratorRuntime().wrap(function _callee10$(_context10) {
-          while (1) switch (_context10.prev = _context10.next) {
+        return _regeneratorRuntime().wrap(function _callee11$(_context11) {
+          while (1) switch (_context11.prev = _context11.next) {
             case 0:
               if (!(!this.orderDataSource || ids.length === 0)) {
-                _context10.next = 2;
+                _context11.next = 2;
                 break;
               }
-              return _context10.abrupt("return", []);
+              return _context11.abrupt("return", []);
             case 2:
-              _context10.prev = 2;
+              _context11.prev = 2;
               if (!(typeof this.orderDataSource.fetchOrdersByIds === 'function')) {
-                _context10.next = 8;
+                _context11.next = 8;
                 break;
               }
-              _context10.next = 6;
+              _context11.next = 6;
               return this.orderDataSource.fetchOrdersByIds(ids);
             case 6:
-              _orderList = _context10.sent;
-              return _context10.abrupt("return", _orderList || []);
+              _orderList = _context11.sent;
+              return _context11.abrupt("return", _orderList || []);
             case 8:
-              _context10.next = 10;
+              _context11.next = 10;
               return this.orderDataSource.run({
                 http: {
                   query: {
@@ -888,19 +941,19 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 }
               });
             case 10:
-              orderList = _context10.sent;
-              return _context10.abrupt("return", orderList || []);
+              orderList = _context11.sent;
+              return _context11.abrupt("return", orderList || []);
             case 14:
-              _context10.prev = 14;
-              _context10.t0 = _context10["catch"](2);
-              return _context10.abrupt("return", []);
+              _context11.prev = 14;
+              _context11.t0 = _context11["catch"](2);
+              return _context11.abrupt("return", []);
             case 17:
             case "end":
-              return _context10.stop();
+              return _context11.stop();
           }
-        }, _callee10, this, [[2, 14]]);
+        }, _callee11, this, [[2, 14]]);
       }));
-      function fetchOrdersByHttp(_x5) {
+      function fetchOrdersByHttp(_x6) {
         return _fetchOrdersByHttp.apply(this, arguments);
       }
       return fetchOrdersByHttp;
@@ -912,11 +965,11 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "mergeOrdersToStore",
     value: (function () {
-      var _mergeOrdersToStore = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee11(freshOrders) {
-        var _this8 = this;
+      var _mergeOrdersToStore = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee12(freshOrders) {
+        var _this9 = this;
         var freshMap, _iterator4, _step4, order, id, uniqueFreshCount, updatedList, _iterator5, _step5, _order;
-        return _regeneratorRuntime().wrap(function _callee11$(_context11) {
-          while (1) switch (_context11.prev = _context11.next) {
+        return _regeneratorRuntime().wrap(function _callee12$(_context12) {
+          while (1) switch (_context12.prev = _context12.next) {
             case 0:
               this.logInfo('mergeOrdersToStore-开始', {
                 freshOrderCount: freshOrders.length,
@@ -924,42 +977,42 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               });
               freshMap = new Map();
               _iterator4 = _createForOfIteratorHelper(freshOrders);
-              _context11.prev = 3;
+              _context12.prev = 3;
               _iterator4.s();
             case 5:
               if ((_step4 = _iterator4.n()).done) {
-                _context11.next = 13;
+                _context12.next = 13;
                 break;
               }
               order = _step4.value;
               id = order === null || order === void 0 ? void 0 : order.order_id;
               if (!(id === undefined || id === null)) {
-                _context11.next = 10;
+                _context12.next = 10;
                 break;
               }
-              return _context11.abrupt("continue", 11);
+              return _context12.abrupt("continue", 11);
             case 10:
               freshMap.set(this.getIdKey(id), order);
             case 11:
-              _context11.next = 5;
+              _context12.next = 5;
               break;
             case 13:
-              _context11.next = 18;
+              _context12.next = 18;
               break;
             case 15:
-              _context11.prev = 15;
-              _context11.t0 = _context11["catch"](3);
-              _iterator4.e(_context11.t0);
+              _context12.prev = 15;
+              _context12.t0 = _context12["catch"](3);
+              _iterator4.e(_context12.t0);
             case 18:
-              _context11.prev = 18;
+              _context12.prev = 18;
               _iterator4.f();
-              return _context11.finish(18);
+              return _context12.finish(18);
             case 21:
               uniqueFreshCount = freshMap.size;
               updatedList = this.store.list.map(function (order) {
                 var id = order.order_id;
                 if (id === undefined || id === null) return order;
-                var key = _this8.getIdKey(id);
+                var key = _this9.getIdKey(id);
                 if (!freshMap.has(key)) return order;
                 var fresh = freshMap.get(key);
                 freshMap.delete(key);
@@ -978,7 +1031,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               }
               this.store.list = updatedList;
               this.syncOrdersMap();
-              _context11.next = 29;
+              _context12.next = 29;
               return this.saveOrdersToSQLite(this.store.list);
             case 29:
               this.logInfo('mergeOrdersToStore-结束', {
@@ -988,11 +1041,11 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               this.core.effects.emit(OrderHooks.onOrdersChanged, this.store.list);
             case 31:
             case "end":
-              return _context11.stop();
+              return _context12.stop();
           }
-        }, _callee11, this, [[3, 15, 18, 21]]);
+        }, _callee12, this, [[3, 15, 18, 21]]);
       }));
-      function mergeOrdersToStore(_x6) {
+      function mergeOrdersToStore(_x7) {
         return _mergeOrdersToStore.apply(this, arguments);
       }
       return mergeOrdersToStore;
@@ -1129,32 +1182,32 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "loadOrdersFromSQLite",
     value: function () {
-      var _loadOrdersFromSQLite = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee12() {
+      var _loadOrdersFromSQLite = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee13() {
         var orders;
-        return _regeneratorRuntime().wrap(function _callee12$(_context12) {
-          while (1) switch (_context12.prev = _context12.next) {
+        return _regeneratorRuntime().wrap(function _callee13$(_context13) {
+          while (1) switch (_context13.prev = _context13.next) {
             case 0:
               if (this.dbManager) {
-                _context12.next = 2;
+                _context13.next = 2;
                 break;
               }
-              return _context12.abrupt("return", []);
+              return _context13.abrupt("return", []);
             case 2:
-              _context12.prev = 2;
-              _context12.next = 5;
+              _context13.prev = 2;
+              _context13.next = 5;
               return this.dbManager.getAll(INDEXDB_STORE_NAME);
             case 5:
-              orders = _context12.sent;
-              return _context12.abrupt("return", orders || []);
+              orders = _context13.sent;
+              return _context13.abrupt("return", orders || []);
             case 9:
-              _context12.prev = 9;
-              _context12.t0 = _context12["catch"](2);
-              return _context12.abrupt("return", []);
+              _context13.prev = 9;
+              _context13.t0 = _context13["catch"](2);
+              return _context13.abrupt("return", []);
             case 12:
             case "end":
-              return _context12.stop();
+              return _context13.stop();
           }
-        }, _callee12, this, [[2, 9]]);
+        }, _callee13, this, [[2, 9]]);
       }));
       function loadOrdersFromSQLite() {
         return _loadOrdersFromSQLite.apply(this, arguments);
@@ -1164,55 +1217,55 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "saveOrdersToSQLite",
     value: function () {
-      var _saveOrdersToSQLite = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee13(orderList) {
-        return _regeneratorRuntime().wrap(function _callee13$(_context13) {
-          while (1) switch (_context13.prev = _context13.next) {
+      var _saveOrdersToSQLite = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee14(orderList) {
+        return _regeneratorRuntime().wrap(function _callee14$(_context14) {
+          while (1) switch (_context14.prev = _context14.next) {
             case 0:
               if (this.dbManager) {
-                _context13.next = 2;
+                _context14.next = 2;
                 break;
               }
-              return _context13.abrupt("return");
+              return _context14.abrupt("return");
             case 2:
-              _context13.prev = 2;
+              _context14.prev = 2;
               this.logInfo('saveOrdersToSQLite-开始', {
                 count: orderList.length
               });
-              _context13.next = 6;
+              _context14.next = 6;
               return this.dbManager.clear(INDEXDB_STORE_NAME);
             case 6:
               this.logInfo('saveOrdersToSQLite-clear完成', {
                 count: orderList.length
               });
               if (!(orderList.length === 0)) {
-                _context13.next = 9;
+                _context14.next = 9;
                 break;
               }
-              return _context13.abrupt("return");
+              return _context14.abrupt("return");
             case 9:
-              _context13.next = 11;
+              _context14.next = 11;
               return this.dbManager.bulkAdd(INDEXDB_STORE_NAME, orderList);
             case 11:
               this.logInfo('saveOrdersToSQLite-bulkAdd完成', {
                 count: orderList.length
               });
-              _context13.next = 17;
+              _context14.next = 17;
               break;
             case 14:
-              _context13.prev = 14;
-              _context13.t0 = _context13["catch"](2);
+              _context14.prev = 14;
+              _context14.t0 = _context14["catch"](2);
               // SQLite 异常，避免影响主流程
               this.logError('保存订单到 SQLite 失败', {
-                error: _context13.t0 instanceof Error ? _context13.t0.message : String(_context13.t0),
+                error: _context14.t0 instanceof Error ? _context14.t0.message : String(_context14.t0),
                 orderList: orderList.length
               });
             case 17:
             case "end":
-              return _context13.stop();
+              return _context14.stop();
           }
-        }, _callee13, this, [[2, 14]]);
+        }, _callee14, this, [[2, 14]]);
       }));
-      function saveOrdersToSQLite(_x7) {
+      function saveOrdersToSQLite(_x8) {
         return _saveOrdersToSQLite.apply(this, arguments);
       }
       return saveOrdersToSQLite;
@@ -1220,27 +1273,27 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "clear",
     value: function () {
-      var _clear = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee14() {
-        return _regeneratorRuntime().wrap(function _callee14$(_context14) {
-          while (1) switch (_context14.prev = _context14.next) {
+      var _clear = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee15() {
+        return _regeneratorRuntime().wrap(function _callee15$(_context15) {
+          while (1) switch (_context15.prev = _context15.next) {
             case 0:
               this.store.list = [];
               this.store.map = new Map();
               this.resourceIdIndex.clear();
               if (!this.dbManager) {
-                _context14.next = 6;
+                _context15.next = 6;
                 break;
               }
-              _context14.next = 6;
+              _context15.next = 6;
               return this.dbManager.clear(INDEXDB_STORE_NAME);
             case 6:
               this.setStorageItem(ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY, '');
               this.core.effects.emit(OrderHooks.onOrdersChanged, this.store.list);
             case 8:
             case "end":
-              return _context14.stop();
+              return _context15.stop();
           }
-        }, _callee14, this);
+        }, _callee15, this);
       }));
       function clear() {
         return _clear.apply(this, arguments);