@pisell/pisellos 2.2.285 → 2.2.286

package/dist/modules/Order/index.js

@@ -5468,7 +5468,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       var _syncPaymentsToOrder = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee34(params) {
         var _this32 = this,
           _params$confirmPendin;
-        var tempOrder, needsPaymentNumber, devicePrefix, mappedPayments, shouldConfirmPendingVoucherPayments, effectivePayments, completion, orderPaidPaymentTotal, paymentStatus, paymentSyncIdempotencyToken, submitParams, submitResult;
+        var tempOrder, needsPaymentNumber, devicePrefix, mappedPayments, shouldConfirmPendingVoucherPayments, effectivePayments, completion, orderPaidPaymentTotal, paymentStatus, paymentSyncIdempotencyToken, enhancePayload, submitParams, submitResult;
         return _regeneratorRuntime().wrap(function _callee34$(_context37) {
           while (1) switch (_context37.prev = _context37.next) {
             case 0:
@@ -5521,6 +5521,12 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
             case 25:
               this.store.syncState = 'submitting';
               paymentSyncIdempotencyToken = this.buildPaymentSyncIdempotencyToken(tempOrder, effectivePayments);
+              enhancePayload = function enhancePayload(payload, ctx) {
+                var enhancedPayload = params.enhancePayload ? params.enhancePayload(payload, ctx) : payload;
+                return _objectSpread(_objectSpread({}, enhancedPayload), {}, {
+                  request_unique_idempotency_token: paymentSyncIdempotencyToken
+                });
+              };
               submitParams = {
                 payments: effectivePayments,
                 paymentStatus: paymentStatus,
@@ -5528,34 +5534,29 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 businessCode: params.businessCode,
                 channel: params.channel,
                 confirmPendingVoucherPayments: true,
-                enhancePayload: function enhancePayload(payload) {
-                  var nextPayload = _objectSpread(_objectSpread({}, payload), {}, {
-                    request_unique_idempotency_token: paymentSyncIdempotencyToken
-                  });
-                  return nextPayload;
-                }
+                enhancePayload: enhancePayload
               };
               if (!(params.checkoutSyncTaskEnabled === false)) {
-                _context37.next = 34;
+                _context37.next = 35;
                 break;
               }
-              _context37.next = 31;
+              _context37.next = 32;
               return this.submitTempOrderAsync(submitParams);
-            case 31:
+            case 32:
               _context37.t1 = _context37.sent;
-              _context37.next = 37;
+              _context37.next = 38;
               break;
-            case 34:
-              _context37.next = 36;
+            case 35:
+              _context37.next = 37;
               return this.submitTempOrder(submitParams);
-            case 36:
-              _context37.t1 = _context37.sent;
             case 37:
+              _context37.t1 = _context37.sent;
+            case 38:
               submitResult = _context37.t1;
               return _context37.abrupt("return", _objectSpread(_objectSpread({}, completion), {}, {
                 submitResult: submitResult
               }));
-            case 39:
+            case 40:
             case "end":
               return _context37.stop();
           }

package/dist/modules/Order/types.d.ts

@@ -608,6 +608,7 @@ export interface SyncPaymentsToOrderParams {
     businessCode?: string;
     channel?: string;
     confirmPendingVoucherPayments?: boolean;
+    enhancePayload?: SubmitPayloadEnhancer;
 }
 export interface SyncPaymentsToOrderResult<T = any> {
     isFullyPaid: boolean;

package/dist/server/index.d.ts

@@ -505,6 +505,10 @@ declare class Server {
     private buildCheckoutTaskIdempotencyKey;
     private isBlankCheckoutValue;
     private isLocalCheckoutOrderId;
+    private applyCheckoutFulfillmentBuzzer;
+    private buildCheckoutResourceIdentifierBuzzer;
+    private getCheckoutResourceIdentifier;
+    private stringifyCheckoutResourceIdentifier;
     private normalizeCheckoutSubmitData;
     private ensureCheckoutOrderNumbers;
     private dispatchCheckoutSyncTask;

package/dist/server/index.js

@@ -43,6 +43,7 @@ import { filterBookingsFromOrders, sortBookings } from "./modules/order/utils/fi
 import { buildSmallTicketData, hasSmallTicketData } from "./utils/small-ticket";
 import { BaseSalesImpl } from "../solution/BaseSales";
 import { getOrderPaymentIdentityKeys, isIdentifiedPendingOrderPayment, isPendingOrderPayment, mergeOrderPaymentListsByIdentity } from "../modules/Order/payment-utils";
+var OS_FULFILLMENT_REF_MODE_FIELD = '_os_fulfillment_ref_mode';
 
 // 重新导出类型供外部使用
 
@@ -2445,7 +2446,7 @@ var Server = /*#__PURE__*/function () {
     value: function () {
       var _runCheckoutSync = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee31(params) {
         var _this$app6;
-        var backendPath, title, normalizedData, checkoutData, remoteCheckoutData, response, fresh, externalSaleNumber, syncedOrder, printableSyncedOrder;
+        var backendPath, title, normalizedData, numberedData, checkoutData, remoteCheckoutData, response, fresh, externalSaleNumber, syncedOrder, printableSyncedOrder;
         return _regeneratorRuntime().wrap(function _callee31$(_context31) {
           while (1) switch (_context31.prev = _context31.next) {
             case 0:
@@ -2457,23 +2458,24 @@ var Server = /*#__PURE__*/function () {
               _context31.next = 6;
               return this.ensureCheckoutOrderNumbers(normalizedData, title);
             case 6:
-              checkoutData = _context31.sent;
+              numberedData = _context31.sent;
+              checkoutData = this.applyCheckoutFulfillmentBuzzer(numberedData, title);
               remoteCheckoutData = this.buildRemoteCheckoutData(checkoutData, title);
               if ((_this$app6 = this.app) !== null && _this$app6 !== void 0 && (_this$app6 = _this$app6.request) !== null && _this$app6 !== void 0 && _this$app6.post) {
-                _context31.next = 10;
+                _context31.next = 11;
                 break;
               }
               throw new Error('app.request 不可用');
-            case 10:
-              _context31.next = 12;
+            case 11:
+              _context31.next = 13;
               return this.app.request.post(backendPath, remoteCheckoutData, {
                 isShopApi: true,
                 customToast: function customToast() {}
               });
-            case 12:
+            case 13:
               response = _context31.sent;
               if (!this.isCheckoutResponseRejected(response)) {
-                _context31.next = 15;
+                _context31.next = 16;
                 break;
               }
               return _context31.abrupt("return", {
@@ -2484,13 +2486,13 @@ var Server = /*#__PURE__*/function () {
                 normalizedResponse: this.normalizeCheckoutResponse(response),
                 checkoutData: checkoutData
               });
-            case 15:
+            case 16:
               fresh = this.extractOrderDataFromCheckoutResponse(response);
               externalSaleNumber = this.getCheckoutExternalSaleNumber(checkoutData, {
                 external_sale_number: params.externalSaleNumber,
                 data: checkoutData
               });
-              _context31.next = 19;
+              _context31.next = 20;
               return this.persistSyncedCheckoutOrder({
                 backendPath: backendPath,
                 checkoutData: checkoutData,
@@ -2499,7 +2501,7 @@ var Server = /*#__PURE__*/function () {
                 title: title,
                 persistCheckoutDataWithResponse: params.persistCheckoutDataWithResponse === true
               });
-            case 19:
+            case 20:
               syncedOrder = _context31.sent;
               printableSyncedOrder = syncedOrder ? this.buildSyncedOrderForPrint({
                 syncedOrder: syncedOrder,
@@ -2509,17 +2511,17 @@ var Server = /*#__PURE__*/function () {
                 checkoutData: checkoutData,
                 syncedOrder: printableSyncedOrder
               }))) {
-                _context31.next = 24;
+                _context31.next = 25;
                 break;
               }
-              _context31.next = 24;
+              _context31.next = 25;
               return this.dispatchPrintOtherReceiptTask({
                 checkoutData: checkoutData,
                 syncedOrder: printableSyncedOrder,
                 response: response,
                 deviceId: params.deviceId
               });
-            case 24:
+            case 25:
               return _context31.abrupt("return", {
                 rejected: false,
                 response: response,
@@ -2528,7 +2530,7 @@ var Server = /*#__PURE__*/function () {
                 syncedOrder: syncedOrder,
                 fresh: fresh
               });
-            case 25:
+            case 26:
             case "end":
               return _context31.stop();
           }
@@ -2554,6 +2556,7 @@ var Server = /*#__PURE__*/function () {
       var next = cloneDeep(this.omitCheckoutSyncMode(data));
       if (!next || _typeof(next) !== 'object') return next;
       var record = next;
+      delete record[OS_FULFILLMENT_REF_MODE_FIELD];
       if (!Array.isArray(record.payments)) return next;
       var originalPayments = record.payments;
       var filteredPayments = originalPayments.filter(function (payment) {
@@ -5315,6 +5318,92 @@ var Server = /*#__PURE__*/function () {
     value: function isLocalCheckoutOrderId(orderId) {
       return typeof orderId === 'string' && orderId.startsWith('LOCAL_');
     }
+  }, {
+    key: "applyCheckoutFulfillmentBuzzer",
+    value: function applyCheckoutFulfillmentBuzzer(data, title) {
+      if (!data || _typeof(data) !== 'object') return data;
+      var next = _objectSpread({}, data);
+      var refMode = String(next[OS_FULFILLMENT_REF_MODE_FIELD] || '').trim();
+      delete next[OS_FULFILLMENT_REF_MODE_FIELD];
+      if (!refMode) return next;
+      if (refMode === 'manual_input') {
+        this.logInfo("".concat(title, ": fulfillment ref mode \u4FDD\u7559\u624B\u52A8 buzzer"), {
+          fulfillment_ref_mode: refMode,
+          has_buzzer: !this.isBlankCheckoutValue(next.buzzer)
+        });
+        return next;
+      }
+      if (refMode === 'resource_identifier') {
+        next.buzzer = this.buildCheckoutResourceIdentifierBuzzer(next.bookings);
+      } else if (refMode === 'sale_number') {
+        next.buzzer = this.isBlankCheckoutValue(next.shop_order_number) ? '' : String(next.shop_order_number);
+      } else if (refMode === 'short_number') {
+        next.buzzer = this.isBlankCheckoutValue(next.shop_full_order_number) ? '' : String(next.shop_full_order_number);
+      } else {
+        this.logWarning("".concat(title, ": \u672A\u8BC6\u522B\u7684 fulfillment ref mode\uFF0C\u8DF3\u8FC7 buzzer \u81EA\u52A8\u586B\u5145"), {
+          fulfillment_ref_mode: refMode
+        });
+        return next;
+      }
+      this.logInfo("".concat(title, ": fulfillment ref mode \u5DF2\u586B\u5145 buzzer"), {
+        fulfillment_ref_mode: refMode,
+        buzzer: next.buzzer
+      });
+      return next;
+    }
+  }, {
+    key: "buildCheckoutResourceIdentifierBuzzer",
+    value: function buildCheckoutResourceIdentifierBuzzer(bookings) {
+      var _this13 = this;
+      if (!Array.isArray(bookings)) return '';
+      var values = [];
+      var seen = new Set();
+      var visitResource = function visitResource(resource) {
+        var identifier = _this13.getCheckoutResourceIdentifier(resource);
+        if (identifier && !seen.has(identifier)) {
+          seen.add(identifier);
+          values.push(identifier);
+        }
+        if (Array.isArray(resource === null || resource === void 0 ? void 0 : resource.children)) {
+          resource.children.forEach(visitResource);
+        }
+      };
+      bookings.forEach(function (booking) {
+        if (Array.isArray(booking === null || booking === void 0 ? void 0 : booking.resources)) {
+          booking.resources.forEach(visitResource);
+        }
+      });
+      return values.join(',');
+    }
+  }, {
+    key: "getCheckoutResourceIdentifier",
+    value: function getCheckoutResourceIdentifier(resource) {
+      var _resource$metadata, _resource$metadata2;
+      if (!resource || _typeof(resource) !== 'object') return '';
+      var candidates = [resource.main_field, resource.name, resource.title, (_resource$metadata = resource.metadata) === null || _resource$metadata === void 0 ? void 0 : _resource$metadata.resource_name, (_resource$metadata2 = resource.metadata) === null || _resource$metadata2 === void 0 ? void 0 : _resource$metadata2.name, resource.relation_id, resource.id];
+      for (var _i2 = 0, _candidates = candidates; _i2 < _candidates.length; _i2++) {
+        var candidate = _candidates[_i2];
+        var value = this.stringifyCheckoutResourceIdentifier(candidate);
+        if (value) return value;
+      }
+      return '';
+    }
+  }, {
+    key: "stringifyCheckoutResourceIdentifier",
+    value: function stringifyCheckoutResourceIdentifier(value) {
+      if (value === undefined || value === null) return '';
+      if (typeof value === 'string' || typeof value === 'number') {
+        return String(value).trim();
+      }
+      if (_typeof(value) !== 'object' || Array.isArray(value)) return '';
+      var localeCandidates = [value.original, value.auto, value.en, value['zh-CN'], value.zh_CN, value['zh-HK'], value.zh_HK];
+      for (var _i3 = 0, _localeCandidates = localeCandidates; _i3 < _localeCandidates.length; _i3++) {
+        var candidate = _localeCandidates[_i3];
+        var normalized = this.stringifyCheckoutResourceIdentifier(candidate);
+        if (normalized) return normalized;
+      }
+      return '';
+    }
   }, {
     key: "normalizeCheckoutSubmitData",
     value: function () {
@@ -5877,7 +5966,7 @@ var Server = /*#__PURE__*/function () {
     key: "handleOrderCheckoutSubmit",
     value: function () {
       var _handleOrderCheckoutSubmit = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee60(params) {
-        var backendPath, data, title, normalizedData, checkoutData, pendingResult, pendingOrder;
+        var backendPath, data, title, normalizedData, numberedData, checkoutData, pendingResult, pendingOrder;
         return _regeneratorRuntime().wrap(function _callee60$(_context60) {
           while (1) switch (_context60.prev = _context60.next) {
             case 0:
@@ -5905,42 +5994,43 @@ var Server = /*#__PURE__*/function () {
               _context60.next = 9;
               return this.ensureCheckoutOrderNumbers(normalizedData, title);
             case 9:
-              checkoutData = _context60.sent;
-              _context60.next = 12;
+              numberedData = _context60.sent;
+              checkoutData = this.applyCheckoutFulfillmentBuzzer(numberedData, title);
+              _context60.next = 13;
               return this.handlePendingSyncCheckoutOrder({
                 backendPath: backendPath,
                 data: checkoutData,
                 title: title,
                 reason: 'checkout 已转入设备任务同步'
               });
-            case 12:
+            case 13:
               pendingResult = _context60.sent;
               if (!((pendingResult === null || pendingResult === void 0 ? void 0 : pendingResult.status) === true)) {
-                _context60.next = 20;
+                _context60.next = 21;
                 break;
               }
               pendingOrder = pendingResult.data;
               if (!(pendingOrder && this.shouldBuildSmallTicketData(checkoutData) && this.isSalesOrderFullyPaid(pendingOrder) && this.shouldAutoPrintCheckoutReceipt())) {
-                _context60.next = 18;
+                _context60.next = 19;
                 break;
               }
-              _context60.next = 18;
+              _context60.next = 19;
               return this.dispatchLocalReceiptPrint({
                 checkoutData: checkoutData,
                 order: pendingOrder,
                 response: pendingResult,
                 requireFullyPaid: true
               });
-            case 18:
-              _context60.next = 20;
+            case 19:
+              _context60.next = 21;
               return this.dispatchCheckoutSyncTask({
                 backendPath: backendPath,
                 data: checkoutData,
                 title: title
               });
-            case 20:
+            case 21:
               if (pendingResult.data.order_id) {
-                _context60.next = 22;
+                _context60.next = 23;
                 break;
               }
               return _context60.abrupt("return", _objectSpread(_objectSpread({}, pendingResult), {}, {
@@ -5948,9 +6038,9 @@ var Server = /*#__PURE__*/function () {
                   order_id: pendingResult.data.external_sale_number
                 })
               }));
-            case 22:
-              return _context60.abrupt("return", pendingResult);
             case 23:
+              return _context60.abrupt("return", pendingResult);
+            case 24:
             case "end":
               return _context60.stop();
           }
@@ -6143,7 +6233,7 @@ var Server = /*#__PURE__*/function () {
     key: "handlePendingSyncCheckoutOrder",
     value: function () {
       var _handlePendingSyncCheckoutOrder = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee63(params) {
-        var _this13 = this;
+        var _this14 = this;
         var backendPath, data, title, reason, pendingOrder, _pendingOrder$payment, _pendingOrder$summary, _pendingOrder$summary2, _pendingOrder$summary3, changeGivenAmount, errorMessage;
         return _regeneratorRuntime().wrap(function _callee63$(_context63) {
           while (1) switch (_context63.prev = _context63.next) {
@@ -6196,7 +6286,7 @@ var Server = /*#__PURE__*/function () {
               });
               changeGivenAmount = pendingOrder === null || pendingOrder === void 0 || (_pendingOrder$payment = pendingOrder.payments) === null || _pendingOrder$payment === void 0 ? void 0 : _pendingOrder$payment.reduce(function (sum, payment) {
                 var _payment$metadata;
-                return sum + _this13.toAmountNumber(payment === null || payment === void 0 || (_payment$metadata = payment.metadata) === null || _payment$metadata === void 0 ? void 0 : _payment$metadata.change_given_amount);
+                return sum + _this14.toAmountNumber(payment === null || payment === void 0 || (_payment$metadata = payment.metadata) === null || _payment$metadata === void 0 ? void 0 : _payment$metadata.change_given_amount);
               }, 0);
               return _context63.abrupt("return", {
                 code: 200,
@@ -6336,13 +6426,13 @@ var Server = /*#__PURE__*/function () {
   }, {
     key: "sumPaidOrderPayments",
     value: function sumPaidOrderPayments(payments) {
-      var _this14 = this;
+      var _this15 = this;
       if (!Array.isArray(payments)) return 0;
       return payments.reduce(function (sum, payment) {
         var _payment$amount;
         var status = String((payment === null || payment === void 0 ? void 0 : payment.status) || '').toLowerCase();
         if (status !== 'paid') return sum;
-        return sum + _this14.toAmountNumber((_payment$amount = payment === null || payment === void 0 ? void 0 : payment.amount) !== null && _payment$amount !== void 0 ? _payment$amount : payment === null || payment === void 0 ? void 0 : payment.origin_amount);
+        return sum + _this15.toAmountNumber((_payment$amount = payment === null || payment === void 0 ? void 0 : payment.amount) !== null && _payment$amount !== void 0 ? _payment$amount : payment === null || payment === void 0 ? void 0 : payment.origin_amount);
       }, 0);
     }
   }, {
@@ -6358,7 +6448,7 @@ var Server = /*#__PURE__*/function () {
     value: function () {
       var _buildSmallTicketProductMap = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee66(order) {
         var _this$products3,
-          _this15 = this;
+          _this16 = this;
         var products, productIdSet, productIds, entries;
         return _regeneratorRuntime().wrap(function _callee66$(_context66) {
           while (1) switch (_context66.prev = _context66.next) {
@@ -6391,20 +6481,20 @@ var Server = /*#__PURE__*/function () {
               _context66.next = 8;
               return Promise.all(productIds.map( /*#__PURE__*/function () {
                 var _ref68 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee65(id) {
-                  var _this15$products, _this15$products$getP, product;
+                  var _this16$products, _this16$products$getP, product;
                   return _regeneratorRuntime().wrap(function _callee65$(_context65) {
                     while (1) switch (_context65.prev = _context65.next) {
                       case 0:
                         _context65.prev = 0;
                         _context65.next = 3;
-                        return (_this15$products = _this15.products) === null || _this15$products === void 0 || (_this15$products$getP = _this15$products.getProductById) === null || _this15$products$getP === void 0 ? void 0 : _this15$products$getP.call(_this15$products, Number(id));
+                        return (_this16$products = _this16.products) === null || _this16$products === void 0 || (_this16$products$getP = _this16$products.getProductById) === null || _this16$products$getP === void 0 ? void 0 : _this16$products$getP.call(_this16$products, Number(id));
                       case 3:
                         product = _context65.sent;
                         return _context65.abrupt("return", product ? [String(id), product] : null);
                       case 7:
                         _context65.prev = 7;
                         _context65.t0 = _context65["catch"](0);
-                        _this15.logWarning('buildSmallTicketProductMap: 查询本地商品失败', {
+                        _this16.logWarning('buildSmallTicketProductMap: 查询本地商品失败', {
                           product_id: id,
                           error: _context65.t0 instanceof Error ? _context65.t0.message : String(_context65.t0)
                         });
@@ -6555,7 +6645,7 @@ var Server = /*#__PURE__*/function () {
     key: "withSalesDetailProductSnapshots",
     value: function () {
       var _withSalesDetailProductSnapshots = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee68(order) {
-        var _this16 = this;
+        var _this17 = this;
         var products, snapshotMap, hasChanged, enrichedProducts, enrichedOrder;
         return _regeneratorRuntime().wrap(function _callee68$(_context68) {
           while (1) switch (_context68.prev = _context68.next) {
@@ -6579,8 +6669,8 @@ var Server = /*#__PURE__*/function () {
             case 8:
               hasChanged = false;
               enrichedProducts = products.map(function (product) {
-                var productWithBundleSnapshots = _this16.withBundleCatalogSnapshots(product, snapshotMap);
-                var nextProduct = _this16.withProductCatalogSnapshots(productWithBundleSnapshots, snapshotMap);
+                var productWithBundleSnapshots = _this17.withBundleCatalogSnapshots(product, snapshotMap);
+                var nextProduct = _this17.withProductCatalogSnapshots(productWithBundleSnapshots, snapshotMap);
                 if (nextProduct !== product) hasChanged = true;
                 return nextProduct;
               });
@@ -6608,13 +6698,13 @@ var Server = /*#__PURE__*/function () {
   }, {
     key: "withPendingSyncProductTitles",
     value: function withPendingSyncProductTitles(order, productMap) {
-      var _this17 = this;
+      var _this18 = this;
       var products = Array.isArray(order.products) ? order.products : null;
       if (!(products !== null && products !== void 0 && products.length)) return order;
       return _objectSpread(_objectSpread({}, order), {}, {
         products: products.map(function (product) {
           return _objectSpread(_objectSpread({}, product), {}, {
-            product_title: _this17.buildProductTitleSnapshot(product, productMap)
+            product_title: _this18.buildProductTitleSnapshot(product, productMap)
           });
         })
       });
@@ -6625,7 +6715,7 @@ var Server = /*#__PURE__*/function () {
       var _product$product_id4,
         _product$product,
         _fallbackProduct$prod,
-        _this18 = this;
+        _this19 = this;
       var productId = (_product$product_id4 = product.product_id) !== null && _product$product_id4 !== void 0 ? _product$product_id4 : product.id;
       var fallbackProduct = productId !== undefined && productId !== null ? productMap[productId] || productMap[String(productId)] : null;
       var ownTitle = product.product_title || product.title || product.name || ((_product$product = product.product) === null || _product$product === void 0 ? void 0 : _product$product.title);
@@ -6633,7 +6723,7 @@ var Server = /*#__PURE__*/function () {
       var currentLocale = this.getProductTitleSnapshotCurrentLocale();
       var autoTitle = this.resolveFirstProductTitleValue(ownTitle) || this.resolveFirstProductTitleValue(fallbackTitle);
       return PRODUCT_TITLE_SNAPSHOT_KEYS.reduce(function (snapshot, key) {
-        snapshot[key] = _this18.resolveProductTitleValue(ownTitle, key, currentLocale) || _this18.resolveProductTitleValue(fallbackTitle, key, currentLocale) || (key === 'auto' || key === 'original' ? autoTitle : null);
+        snapshot[key] = _this19.resolveProductTitleValue(ownTitle, key, currentLocale) || _this19.resolveProductTitleValue(fallbackTitle, key, currentLocale) || (key === 'auto' || key === 'original' ? autoTitle : null);
         return snapshot;
       }, {});
     }
@@ -6695,8 +6785,8 @@ var Server = /*#__PURE__*/function () {
       if (value === undefined || value === null || value === '') return null;
       if (_typeof(value) !== 'object') return String(value);
       var preferredKeys = ['auto', 'en', 'original', 'zh-CN', 'zh_CN', 'zh-HK', 'zh_HK', 'kitchen', 'ja', 'pt', 'default'];
-      for (var _i2 = 0, _preferredKeys = preferredKeys; _i2 < _preferredKeys.length; _i2++) {
-        var _key6 = _preferredKeys[_i2];
+      for (var _i4 = 0, _preferredKeys = preferredKeys; _i4 < _preferredKeys.length; _i4++) {
+        var _key6 = _preferredKeys[_i4];
         var rawValue = value[_key6];
         if (rawValue !== undefined && rawValue !== null && rawValue !== '') return String(rawValue);
       }
@@ -6732,14 +6822,14 @@ var Server = /*#__PURE__*/function () {
     key: "enrichPaymentNamesByCode",
     value: function () {
       var _enrichPaymentNamesByCode = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee69(order) {
-        var _this19 = this;
+        var _this20 = this;
         var payments, hasMissingName, paymentModule, payMethods, nameByCode, _iterator12, _step12, method, codeKey, name, hasResolvedName, enrichedPayments;
         return _regeneratorRuntime().wrap(function _callee69$(_context69) {
           while (1) switch (_context69.prev = _context69.next) {
             case 0:
               payments = Array.isArray(order === null || order === void 0 ? void 0 : order.payments) ? order.payments : [];
               hasMissingName = payments.some(function (payment) {
-                return _this19.isBlankPaymentName(payment === null || payment === void 0 ? void 0 : payment.name) && _this19.shouldLookupPaymentMethodNameByCode(payment === null || payment === void 0 ? void 0 : payment.code);
+                return _this20.isBlankPaymentName(payment === null || payment === void 0 ? void 0 : payment.name) && _this20.shouldLookupPaymentMethodNameByCode(payment === null || payment === void 0 ? void 0 : payment.code);
               });
               if (hasMissingName) {
                 _context69.next = 4;
@@ -6772,9 +6862,9 @@ var Server = /*#__PURE__*/function () {
               }
               hasResolvedName = false;
               enrichedPayments = payments.map(function (payment) {
-                if (!_this19.isBlankPaymentName(payment === null || payment === void 0 ? void 0 : payment.name)) return payment;
-                if (!_this19.shouldLookupPaymentMethodNameByCode(payment === null || payment === void 0 ? void 0 : payment.code)) return payment;
-                var name = nameByCode.get(_this19.getPaymentCodeKey(payment === null || payment === void 0 ? void 0 : payment.code));
+                if (!_this20.isBlankPaymentName(payment === null || payment === void 0 ? void 0 : payment.name)) return payment;
+                if (!_this20.shouldLookupPaymentMethodNameByCode(payment === null || payment === void 0 ? void 0 : payment.code)) return payment;
+                var name = nameByCode.get(_this20.getPaymentCodeKey(payment === null || payment === void 0 ? void 0 : payment.code));
                 if (!name) return payment;
                 hasResolvedName = true;
                 return _objectSpread(_objectSpread({}, payment), {}, {
@@ -6912,8 +7002,8 @@ var Server = /*#__PURE__*/function () {
       pushRaw(this.extractQueryParam(url, 'order_ids'));
       var seen = new Set();
       var result = [];
-      for (var _i3 = 0, _collected = collected; _i3 < _collected.length; _i3++) {
-        var id = _collected[_i3];
+      for (var _i5 = 0, _collected = collected; _i5 < _collected.length; _i5++) {
+        var id = _collected[_i5];
         if (seen.has(id)) continue;
         seen.add(id);
         result.push(id);
@@ -7191,8 +7281,8 @@ var Server = /*#__PURE__*/function () {
     value: function extractOrderDataFromCheckoutResponse(response) {
       var _response$data6, _response$data7;
       var candidates = [response === null || response === void 0 || (_response$data6 = response.data) === null || _response$data6 === void 0 ? void 0 : _response$data6.order, response === null || response === void 0 || (_response$data7 = response.data) === null || _response$data7 === void 0 ? void 0 : _response$data7.sales, response === null || response === void 0 ? void 0 : response.data, response === null || response === void 0 ? void 0 : response.order, response === null || response === void 0 ? void 0 : response.sales, response];
-      for (var _i4 = 0, _candidates = candidates; _i4 < _candidates.length; _i4++) {
-        var candidate = _candidates[_i4];
+      for (var _i6 = 0, _candidates2 = candidates; _i6 < _candidates2.length; _i6++) {
+        var candidate = _candidates2[_i6];
         if (!candidate || _typeof(candidate) !== 'object') continue;
         if (candidate.order_id !== undefined && candidate.order_id !== null) {
           return candidate;
@@ -7356,10 +7446,10 @@ var Server = /*#__PURE__*/function () {
     value: function extractBackendErrorResponse(error) {
       var _error$response3,
         _error$response4,
-        _this20 = this;
+        _this21 = this;
       var candidates = [error === null || error === void 0 || (_error$response3 = error.response) === null || _error$response3 === void 0 ? void 0 : _error$response3.data, error === null || error === void 0 ? void 0 : error.data, error === null || error === void 0 || (_error$response4 = error.response) === null || _error$response4 === void 0 ? void 0 : _error$response4.body, error === null || error === void 0 ? void 0 : error.body];
       return candidates.find(function (candidate) {
-        return _this20.isExplicitBackendErrorResponse(candidate);
+        return _this21.isExplicitBackendErrorResponse(candidate);
       }) || null;
     }
   }, {
@@ -7719,7 +7809,7 @@ var Server = /*#__PURE__*/function () {
     value: (function () {
       var _computeProductQueryResult = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee75(context, options) {
         var _menu_list_ids$length3,
-          _this21 = this;
+          _this22 = this;
         var tTotal, menu_list_ids, ids, schedule_date, schedule_datetime, customer_id, extension_type, product_id, strategy_context, queryIds, formatterContext, uniqueIds, _tPrice, productsWithPrice, _filteredProducts, extensionFilteredProducts, _published$find, pid, _tPrice2, allProductsWithPrice, published, item, _tPrice3, _filteredProducts2, _tStatus, _beforeStatusCount, _tExtensionType, _beforeExtensionTypeCount, _tSort, activeMenuList, tMenu, getActiveMenus, tFilter, productScope, scopedProductIds, tPrice, filteredProducts, tStatus, beforeStatusCount, tExtensionType, beforeExtensionTypeCount, tSort;
         return _regeneratorRuntime().wrap(function _callee75$(_context75) {
           while (1) switch (_context75.prev = _context75.next) {
@@ -7918,9 +8008,9 @@ var Server = /*#__PURE__*/function () {
               }
               tMenu = performance.now();
               getActiveMenus = function getActiveMenus() {
-                return _this21.menu.getMenuByIds(menu_list_ids).filter(function (menu) {
-                  var _this21$schedule;
-                  return ((_this21$schedule = _this21.schedule) === null || _this21$schedule === void 0 ? void 0 : _this21$schedule.getDateIsInSchedule(schedule_datetime, menu.schedule)) || false;
+                return _this22.menu.getMenuByIds(menu_list_ids).filter(function (menu) {
+                  var _this22$schedule;
+                  return ((_this22$schedule = _this22.schedule) === null || _this22$schedule === void 0 ? void 0 : _this22$schedule.getDateIsInSchedule(schedule_datetime, menu.schedule)) || false;
                 });
               };
               activeMenuList = getActiveMenus();
@@ -8229,7 +8319,7 @@ var Server = /*#__PURE__*/function () {
   }, {
     key: "notifySalesSearchSubscribers",
     value: function notifySalesSearchSubscribers(payload) {
-      var _this22 = this;
+      var _this23 = this;
       if (this.salesSearchSubscribers.size === 0) return;
       var changedOrders = this.extractChangedOrdersFromPayload(payload);
       if (changedOrders.length === 0) {
@@ -8247,21 +8337,21 @@ var Server = /*#__PURE__*/function () {
             subscriber = _step20$value[1];
           try {
             var changedVisibleOrders = changedOrders.filter(function (order) {
-              var orderId = _this22.getSalesSearchOrderId(order);
+              var orderId = _this23.getSalesSearchOrderId(order);
               return !!orderId && subscriber.visibleOrderIds.has(orderId);
             });
             if (changedVisibleOrders.length === 0) {
               return 1; // continue
             }
-            subscriber.callback(_this22.buildSalesSearchDeltaResponse(subscriber, changedVisibleOrders));
-            _this22.logInfo('notifySalesSearchSubscribers: 已推送 delta', {
+            subscriber.callback(_this23.buildSalesSearchDeltaResponse(subscriber, changedVisibleOrders));
+            _this23.logInfo('notifySalesSearchSubscribers: 已推送 delta', {
               subscriberId: subscriberId,
               kind: subscriber.kind,
               count: changedVisibleOrders.length
             });
           } catch (error) {
             var errorMessage = error instanceof Error ? error.message : String(error);
-            _this22.logError('notifySalesSearchSubscribers: 推送失败', {
+            _this23.logError('notifySalesSearchSubscribers: 推送失败', {
               subscriberId: subscriberId,
               error: errorMessage
             });

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

@@ -20,6 +20,8 @@ export declare class OrderModule extends BaseModule implements Module {
     private storage;
     private orderSQLiteSaveQueue; /** 按 storageKey 记录最近一次 SQLite 写入来源与时间，用于去重 */
     private recentSqliteWriteByStorageKey;
+    /** 最近一次清理过期 SQLite 去重记录的时间，避免每次写入都遍历 Map */
+    private lastRecentSqliteWriteCleanupAtMs;
     /** 最近一次 SSE 全量拉取完成时间 */
     private lastServerFullFetchAtMs;
     constructor(name?: string, version?: string);
@@ -58,6 +60,12 @@ export declare class OrderModule extends BaseModule implements Module {
      */
     private mergeAuthoritativeOrderCollection;
     private reconcileOverwriteOrderCollections;
+    /**
+     * 惰性清理已经超过去重窗口的 SQLite 写入记录。
+     *
+     * 清理频率与去重窗口一致，既限制 Map 长期增长，也不会移除仍参与去重的记录。
+     */
+    private cleanupExpiredRecentSqliteWrites;
     /**
      * 记录订单最近一次 SQLite 写入，供 pubsub 回声去重使用。
      *