@pisell/pisellos 2.3.140 → 2.3.142

package/dist/server/index.js

@@ -41,6 +41,7 @@ import { OrderHooks } from "./modules/order/types";
 import { filterOrders } from "./modules/order/utils/filterOrders";
 import { filterBookingsFromOrders, sortBookings } from "./modules/order/utils/filterBookings";
 import { buildSmallTicketData, hasSmallTicketData } from "./utils/small-ticket";
+import { requiresInvoiceDataFiltering } from "../shared/receipt/templateVisibility";
 import { BaseSalesImpl } from "../solution/BaseSales";
 import { getOrderPaymentIdentityKeys, isIdentifiedPendingOrderPayment, isPendingOrderPayment, mergeOrderPaymentListsByIdentity } from "../modules/Order/payment-utils";
 import { finalizeSalesNotesForCheckout } from "../modules/Order/salesNotes";
@@ -1386,7 +1387,10 @@ var Server = /*#__PURE__*/function () {
                 small_ticket_data_flag: 1,
                 payment_info: paymentInfo
               }), {
-                locales: _this.normalizeRequestedReceiptLocales(input.locales)
+                locales: _this.normalizeRequestedReceiptLocales(input.locales),
+                invoiceTemplateSettings: input.template_settings === undefined ? undefined : _this.normalizePrintInvoiceTemplateSettings(input.template_settings),
+                applyTemplateVisibility: true,
+                includeReceiptKeys: input.template_settings !== undefined
               });
             case 22:
               rebuiltOrder = _context20.sent;
@@ -1409,7 +1413,15 @@ var Server = /*#__PURE__*/function () {
                 status: true,
                 message: '',
                 data: {
-                  small_ticket_data: smallTicketData
+                  small_ticket_data: smallTicketData,
+                  template_visibility_applied: true,
+                  // These products and currency settings are the exact source used for
+                  // this receipt, not the potentially newer active tempOrder.
+                  source: _objectSpread(_objectSpread({}, rebuiltOrder), {}, {
+                    payment_info: _objectSpread(_objectSpread({}, rebuiltOrder.payment_info || {}), {}, {
+                      small_ticket_data: undefined
+                    })
+                  })
                 }
               });
             case 29:
@@ -6146,7 +6158,8 @@ var Server = /*#__PURE__*/function () {
               _context60.next = 4;
               return this.withLocalSmallTicketData(params.order, {
                 requireFullyPaid: params.requireFullyPaid,
-                invoiceTemplateSettings: params.invoiceTemplateSettings
+                invoiceTemplateSettings: params.invoiceTemplateSettings,
+                applyTemplateVisibility: true
               });
             case 4:
               printableOrder = _context60.sent;
@@ -6177,7 +6190,7 @@ var Server = /*#__PURE__*/function () {
             case 10:
               return _context60.abrupt("return", {
                 printed: true,
-                order: printableOrder
+                order: requiresInvoiceDataFiltering(params.invoiceTemplateSettings) ? params.order : printableOrder
               });
             case 11:
             case "end":
@@ -6429,15 +6442,16 @@ var Server = /*#__PURE__*/function () {
             case 18:
               pendingResult = _context62.sent;
               if (!((pendingResult === null || pendingResult === void 0 ? void 0 : pendingResult.status) === true)) {
-                _context62.next = 26;
+                _context62.next = 33;
                 break;
               }
               pendingOrder = pendingResult.data;
-              if (!(pendingOrder && this.shouldBuildSmallTicketData(checkoutData) && this.isSalesOrderFullyPaid(pendingOrder) && this.shouldAutoPrintCheckoutReceipt())) {
-                _context62.next = 24;
+              if (!(pendingOrder && this.shouldBuildSmallTicketData(checkoutData, invoiceTemplateSettings) && this.isSalesOrderFullyPaid(pendingOrder) && this.shouldAutoPrintCheckoutReceipt())) {
+                _context62.next = 31;
                 break;
               }
-              _context62.next = 24;
+              _context62.prev = 22;
+              _context62.next = 25;
               return this.dispatchLocalReceiptPrint({
                 checkoutData: checkoutData,
                 order: pendingOrder,
@@ -6446,8 +6460,20 @@ var Server = /*#__PURE__*/function () {
                 invoiceLayoutConfig: invoiceLayoutConfig,
                 invoiceTemplateSettings: invoiceTemplateSettings
               });
-            case 24:
-              _context62.next = 26;
+            case 25:
+              _context62.next = 31;
+              break;
+            case 27:
+              _context62.prev = 27;
+              _context62.t0 = _context62["catch"](22);
+              // The sale is already persisted. A failed receipt must not cancel its
+              // sync task or send an unfiltered fallback to the printer.
+              pendingResult.receipt_print_error = this.getUnknownErrorMessage(_context62.t0);
+              this.logError("".concat(title, ": \u5C0F\u7968\u751F\u6210\u5931\u8D25\uFF0C\u8BA2\u5355\u4ECD\u7EE7\u7EED\u540C\u6B65"), {
+                error: pendingResult.receipt_print_error
+              });
+            case 31:
+              _context62.next = 33;
               return this.dispatchCheckoutSyncTask({
                 backendPath: backendPath,
                 data: checkoutData,
@@ -6455,9 +6481,9 @@ var Server = /*#__PURE__*/function () {
                 invoiceLayoutConfig: invoiceLayoutConfig,
                 invoiceTemplateSettings: invoiceTemplateSettings
               });
-            case 26:
+            case 33:
               if (pendingResult.data.order_id) {
-                _context62.next = 28;
+                _context62.next = 35;
                 break;
               }
               return _context62.abrupt("return", _objectSpread(_objectSpread({}, pendingResult), {}, {
@@ -6465,13 +6491,13 @@ var Server = /*#__PURE__*/function () {
                   order_id: pendingResult.data.external_sale_number
                 })
               }));
-            case 28:
+            case 35:
               return _context62.abrupt("return", pendingResult);
-            case 29:
+            case 36:
             case "end":
               return _context62.stop();
           }
-        }, _callee62, this);
+        }, _callee62, this, [[22, 27]]);
       }));
       function handleOrderCheckoutSubmit(_x69) {
         return _handleOrderCheckoutSubmit.apply(this, arguments);
@@ -6525,11 +6551,12 @@ var Server = /*#__PURE__*/function () {
             case 11:
               response = this.withSyncedOrderIdInCheckoutResponse(syncResult.normalizedResponse, syncResult.syncedOrder);
               syncedOrder = syncResult.syncedOrder;
-              if (!(syncedOrder && this.shouldBuildSmallTicketData(syncResult.checkoutData) && this.isSalesOrderFullyPaid(syncedOrder))) {
-                _context63.next = 16;
+              if (!(syncedOrder && this.shouldBuildSmallTicketData(syncResult.checkoutData, invoiceTemplateSettings) && this.isSalesOrderFullyPaid(syncedOrder))) {
+                _context63.next = 23;
                 break;
               }
-              _context63.next = 16;
+              _context63.prev = 14;
+              _context63.next = 17;
               return this.dispatchLocalReceiptPrint({
                 checkoutData: syncResult.checkoutData,
                 order: syncedOrder,
@@ -6537,16 +6564,27 @@ var Server = /*#__PURE__*/function () {
                 requireFullyPaid: true,
                 invoiceLayoutConfig: invoiceLayoutConfig,
                 invoiceTemplateSettings: invoiceTemplateSettings
-                // print_all 的 type=0 是收据打印；不要沿用同步成功后的券/手环打印 type=99。
               });
-            case 16:
-              return _context63.abrupt("return", response);
+            case 17:
+              _context63.next = 23;
+              break;
             case 19:
               _context63.prev = 19;
-              _context63.t0 = _context63["catch"](4);
-              backendError = this.extractBackendErrorResponse(_context63.t0);
+              _context63.t0 = _context63["catch"](14);
+              // Checkout already succeeded remotely; report the receipt failure
+              // separately instead of implying that payment/order creation failed.
+              response.receipt_print_error = this.getUnknownErrorMessage(_context63.t0);
+              this.logError("".concat(title, ": \u5C0F\u7968\u751F\u6210\u5931\u8D25\uFF0C\u8BA2\u5355\u5DF2\u540C\u6B65"), {
+                error: response.receipt_print_error
+              });
+            case 23:
+              return _context63.abrupt("return", response);
+            case 26:
+              _context63.prev = 26;
+              _context63.t1 = _context63["catch"](4);
+              backendError = this.extractBackendErrorResponse(_context63.t1);
               if (!backendError) {
-                _context63.next = 25;
+                _context63.next = 32;
                 break;
               }
               _normalized = this.normalizeCheckoutResponse(backendError);
@@ -6555,12 +6593,12 @@ var Server = /*#__PURE__*/function () {
                 message: (backendError === null || backendError === void 0 ? void 0 : backendError.message) || (_normalized === null || _normalized === void 0 ? void 0 : _normalized.message) || '后端明确拒绝 checkout',
                 data: (_normalized$data2 = _normalized === null || _normalized === void 0 ? void 0 : _normalized.data) !== null && _normalized$data2 !== void 0 ? _normalized$data2 : null
               }));
-            case 25:
-              message = this.getUnknownErrorMessage(_context63.t0);
+            case 32:
+              message = this.getUnknownErrorMessage(_context63.t1);
               this.logError("".concat(title, ": sync checkout \u8BF7\u6C42\u672A\u660E\u786E\u6210\u529F"), {
                 backendPath: backendPath,
                 error: message,
-                error_detail: this.normalizeUnknownError(_context63.t0)
+                error_detail: this.normalizeUnknownError(_context63.t1)
               });
               return _context63.abrupt("return", {
                 code: 500,
@@ -6568,11 +6606,11 @@ var Server = /*#__PURE__*/function () {
                 message: message,
                 data: null
               });
-            case 28:
+            case 35:
             case "end":
               return _context63.stop();
           }
-        }, _callee63, this, [[4, 19]]);
+        }, _callee63, this, [[4, 26], [14, 19]]);
       }));
       function handleSyncCheckoutSubmit(_x70) {
         return _handleSyncCheckoutSubmit.apply(this, arguments);
@@ -6840,11 +6878,13 @@ var Server = /*#__PURE__*/function () {
     }
   }, {
     key: "shouldBuildSmallTicketData",
-    value: function shouldBuildSmallTicketData(order) {
-      var _ref68, _order$small_ticket_d;
+    value: function shouldBuildSmallTicketData(order, invoiceTemplateSettings) {
+      var _order$small_ticket_d;
       if (!order || _typeof(order) !== 'object') return false;
-      // if (hasSmallTicketData(order.payment_info?.small_ticket_data)) return false;
-      return Number((_ref68 = (_order$small_ticket_d = order.small_ticket_data_flag) !== null && _order$small_ticket_d !== void 0 ? _order$small_ticket_d : order.smallTicketDataFlag) !== null && _ref68 !== void 0 ? _ref68 : 0) === 1;
+      var flag = (_order$small_ticket_d = order.small_ticket_data_flag) !== null && _order$small_ticket_d !== void 0 ? _order$small_ticket_d : order.smallTicketDataFlag;
+      // A synced order can omit the generation flag; required display filtering
+      // still rebuilds its output. An explicit 0 retains the no-auto-print intent.
+      return Number(flag !== null && flag !== void 0 ? flag : 0) === 1 || flag == null && requiresInvoiceDataFiltering(invoiceTemplateSettings);
     }
   }, {
     key: "shouldPrintSyncedOrder",
@@ -6862,7 +6902,7 @@ var Server = /*#__PURE__*/function () {
   }, {
     key: "isSalesOrderFullyPaid",
     value: function isSalesOrderFullyPaid(order) {
-      var _order$summary$amount, _order$summary, _ref69, _ref70, _order$summary$expect, _order$summary2, _order$summary3;
+      var _order$summary$amount, _order$summary, _ref68, _ref69, _order$summary$expect, _order$summary2, _order$summary3;
       if (!order || _typeof(order) !== 'object') return false;
       var paymentStatus = String(order.payment_status || '').toLowerCase();
       if (paymentStatus === 'paid' || paymentStatus === 'finished') return true;
@@ -6874,7 +6914,7 @@ var Server = /*#__PURE__*/function () {
         return this.toAmountNumber(amountGap) <= 0;
       }
       var paidAmount = this.sumPaidOrderPayments(order.payments);
-      var targetAmount = this.toAmountNumber((_ref69 = (_ref70 = (_order$summary$expect = (_order$summary2 = order.summary) === null || _order$summary2 === void 0 ? void 0 : _order$summary2.expect_amount) !== null && _order$summary$expect !== void 0 ? _order$summary$expect : (_order$summary3 = order.summary) === null || _order$summary3 === void 0 ? void 0 : _order$summary3.total_amount) !== null && _ref70 !== void 0 ? _ref70 : order.expect_amount) !== null && _ref69 !== void 0 ? _ref69 : order.total_amount);
+      var targetAmount = this.toAmountNumber((_ref68 = (_ref69 = (_order$summary$expect = (_order$summary2 = order.summary) === null || _order$summary2 === void 0 ? void 0 : _order$summary2.expect_amount) !== null && _order$summary$expect !== void 0 ? _order$summary$expect : (_order$summary3 = order.summary) === null || _order$summary3 === void 0 ? void 0 : _order$summary3.total_amount) !== null && _ref69 !== void 0 ? _ref69 : order.expect_amount) !== null && _ref68 !== void 0 ? _ref68 : order.total_amount);
       if (targetAmount <= 0) return paidAmount > 0;
       return paidAmount >= targetAmount;
     }
@@ -6918,8 +6958,8 @@ var Server = /*#__PURE__*/function () {
                 }
                 if (Array.isArray(product === null || product === void 0 ? void 0 : product.product_bundle)) {
                   product.product_bundle.forEach(function (bundle) {
-                    var _ref71, _bundle$bundle_produc;
-                    var bundleProductId = (_ref71 = (_bundle$bundle_produc = bundle === null || bundle === void 0 ? void 0 : bundle.bundle_product_id) !== null && _bundle$bundle_produc !== void 0 ? _bundle$bundle_produc : bundle === null || bundle === void 0 ? void 0 : bundle._bundle_product_id) !== null && _ref71 !== void 0 ? _ref71 : bundle === null || bundle === void 0 ? void 0 : bundle.product_id;
+                    var _ref70, _bundle$bundle_produc;
+                    var bundleProductId = (_ref70 = (_bundle$bundle_produc = bundle === null || bundle === void 0 ? void 0 : bundle.bundle_product_id) !== null && _bundle$bundle_produc !== void 0 ? _bundle$bundle_produc : bundle === null || bundle === void 0 ? void 0 : bundle._bundle_product_id) !== null && _ref70 !== void 0 ? _ref70 : bundle === null || bundle === void 0 ? void 0 : bundle.product_id;
                     if (bundleProductId !== undefined && bundleProductId !== null && bundleProductId !== '') {
                       productIdSet.add(bundleProductId);
                     }
@@ -6935,7 +6975,7 @@ var Server = /*#__PURE__*/function () {
             case 6:
               _context68.next = 8;
               return Promise.all(productIds.map( /*#__PURE__*/function () {
-                var _ref72 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee67(id) {
+                var _ref71 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee67(id) {
                   var _this18$products, _this18$products$getP, product;
                   return _regeneratorRuntime().wrap(function _callee67$(_context67) {
                     while (1) switch (_context67.prev = _context67.next) {
@@ -6961,7 +7001,7 @@ var Server = /*#__PURE__*/function () {
                   }, _callee67, null, [[0, 7]]);
                 }));
                 return function (_x76) {
-                  return _ref72.apply(this, arguments);
+                  return _ref71.apply(this, arguments);
                 };
               }()));
             case 8:
@@ -7000,8 +7040,8 @@ var Server = /*#__PURE__*/function () {
         addProductId((_product$product_id2 = product === null || product === void 0 ? void 0 : product.product_id) !== null && _product$product_id2 !== void 0 ? _product$product_id2 : product === null || product === void 0 ? void 0 : product.id);
         if (Array.isArray(product === null || product === void 0 ? void 0 : product.product_bundle)) {
           product.product_bundle.forEach(function (bundle) {
-            var _ref73, _bundle$bundle_produc2;
-            addProductId((_ref73 = (_bundle$bundle_produc2 = bundle === null || bundle === void 0 ? void 0 : bundle.bundle_product_id) !== null && _bundle$bundle_produc2 !== void 0 ? _bundle$bundle_produc2 : bundle === null || bundle === void 0 ? void 0 : bundle._bundle_product_id) !== null && _ref73 !== void 0 ? _ref73 : bundle === null || bundle === void 0 ? void 0 : bundle.product_id);
+            var _ref72, _bundle$bundle_produc2;
+            addProductId((_ref72 = (_bundle$bundle_produc2 = bundle === null || bundle === void 0 ? void 0 : bundle.bundle_product_id) !== null && _bundle$bundle_produc2 !== void 0 ? _bundle$bundle_produc2 : bundle === null || bundle === void 0 ? void 0 : bundle._bundle_product_id) !== null && _ref72 !== void 0 ? _ref72 : bundle === null || bundle === void 0 ? void 0 : bundle.product_id);
           });
         }
       });
@@ -7077,9 +7117,9 @@ var Server = /*#__PURE__*/function () {
       if (!Array.isArray(product === null || product === void 0 ? void 0 : product.product_bundle)) return product;
       var hasChanged = false;
       var productBundle = product.product_bundle.map(function (bundle) {
-        var _ref74, _bundle$bundle_produc3;
+        var _ref73, _bundle$bundle_produc3;
         if (!bundle || _typeof(bundle) !== 'object') return bundle;
-        var rawProductId = (_ref74 = (_bundle$bundle_produc3 = bundle === null || bundle === void 0 ? void 0 : bundle.bundle_product_id) !== null && _bundle$bundle_produc3 !== void 0 ? _bundle$bundle_produc3 : bundle === null || bundle === void 0 ? void 0 : bundle._bundle_product_id) !== null && _ref74 !== void 0 ? _ref74 : bundle === null || bundle === void 0 ? void 0 : bundle.product_id;
+        var rawProductId = (_ref73 = (_bundle$bundle_produc3 = bundle === null || bundle === void 0 ? void 0 : bundle.bundle_product_id) !== null && _bundle$bundle_produc3 !== void 0 ? _bundle$bundle_produc3 : bundle === null || bundle === void 0 ? void 0 : bundle._bundle_product_id) !== null && _ref73 !== void 0 ? _ref73 : bundle === null || bundle === void 0 ? void 0 : bundle.product_id;
         if (rawProductId === undefined || rawProductId === null || rawProductId === '') return bundle;
         var productId = Number(rawProductId);
         if (!Number.isFinite(productId)) return bundle;
@@ -7203,7 +7243,7 @@ var Server = /*#__PURE__*/function () {
   }, {
     key: "resolveProductTitleValue",
     value: function resolveProductTitleValue(value, key, currentLocale) {
-      var _ref75, _ref76, _value$key;
+      var _ref74, _ref75, _value$key;
       if (value === undefined || value === null || value === '') return null;
       if (_typeof(value) !== 'object') {
         var title = String(value);
@@ -7213,7 +7253,7 @@ var Server = /*#__PURE__*/function () {
       }
       var normalizedKey = key.replace('-', '_');
       var dashedKey = key.replace('_', '-');
-      var rawValue = (_ref75 = (_ref76 = (_value$key = value[key]) !== null && _value$key !== void 0 ? _value$key : value[normalizedKey]) !== null && _ref76 !== void 0 ? _ref76 : value[dashedKey]) !== null && _ref75 !== void 0 ? _ref75 : key === 'auto' ? value.default : undefined;
+      var rawValue = (_ref74 = (_ref75 = (_value$key = value[key]) !== null && _value$key !== void 0 ? _value$key : value[normalizedKey]) !== null && _ref75 !== void 0 ? _ref75 : value[dashedKey]) !== null && _ref74 !== void 0 ? _ref74 : key === 'auto' ? value.default : undefined;
       if (rawValue === undefined || rawValue === null || rawValue === '') return null;
       if (_typeof(rawValue) === 'object') return this.resolveFirstProductTitleValue(rawValue);
       return String(rawValue);
@@ -7357,23 +7397,24 @@ var Server = /*#__PURE__*/function () {
     key: "withLocalSmallTicketData",
     value: function () {
       var _withLocalSmallTicketData = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee72(order, options) {
-        var _options$productMap, normalizedCollections, normalizedOrder, collapsedDuplicateCounts, _ref77, _ref78, _order_id, enrichedOrder, productMap, smallTicketData;
+        var mustApplyVisibility, _options$productMap, normalizedCollections, normalizedOrder, collapsedDuplicateCounts, _ref76, _ref77, _order_id, enrichedOrder, productMap, smallTicketData;
         return _regeneratorRuntime().wrap(function _callee72$(_context72) {
           while (1) switch (_context72.prev = _context72.next) {
             case 0:
-              if (this.shouldBuildSmallTicketData(order)) {
-                _context72.next = 2;
+              mustApplyVisibility = (options === null || options === void 0 ? void 0 : options.applyTemplateVisibility) === true && requiresInvoiceDataFiltering(options.invoiceTemplateSettings);
+              if (!(!this.shouldBuildSmallTicketData(order) && !mustApplyVisibility)) {
+                _context72.next = 3;
                 break;
               }
               return _context72.abrupt("return", order);
-            case 2:
+            case 3:
               if (!(options !== null && options !== void 0 && options.requireFullyPaid && !this.isSalesOrderFullyPaid(order))) {
-                _context72.next = 4;
+                _context72.next = 5;
                 break;
               }
               return _context72.abrupt("return", order);
-            case 4:
-              _context72.prev = 4;
+            case 5:
+              _context72.prev = 5;
               normalizedCollections = normalizeOrderCollections(order, {
                 ensureUid: false
               });
@@ -7387,51 +7428,59 @@ var Server = /*#__PURE__*/function () {
                 return count > 0;
               })) {
                 this.logWarning('withLocalSmallTicketData: 折叠重复订单子项', {
-                  order_identifier: (_ref77 = (_ref78 = (_order_id = normalizedOrder.order_id) !== null && _order_id !== void 0 ? _order_id : normalizedOrder.external_sale_number) !== null && _ref78 !== void 0 ? _ref78 : normalizedOrder.shop_order_number) !== null && _ref77 !== void 0 ? _ref77 : null,
+                  order_identifier: (_ref76 = (_ref77 = (_order_id = normalizedOrder.order_id) !== null && _order_id !== void 0 ? _order_id : normalizedOrder.external_sale_number) !== null && _ref77 !== void 0 ? _ref77 : normalizedOrder.shop_order_number) !== null && _ref76 !== void 0 ? _ref76 : null,
                   collapsed_duplicate_counts: collapsedDuplicateCounts
                 });
               }
-              _context72.next = 11;
+              _context72.next = 12;
               return this.enrichPaymentNamesByCode(normalizedOrder);
-            case 11:
+            case 12:
               enrichedOrder = _context72.sent;
               if (!((_options$productMap = options === null || options === void 0 ? void 0 : options.productMap) !== null && _options$productMap !== void 0)) {
-                _context72.next = 16;
+                _context72.next = 17;
                 break;
               }
               _context72.t0 = _options$productMap;
-              _context72.next = 19;
+              _context72.next = 20;
               break;
-            case 16:
-              _context72.next = 18;
+            case 17:
+              _context72.next = 19;
               return this.buildSmallTicketProductMap(enrichedOrder);
-            case 18:
-              _context72.t0 = _context72.sent;
             case 19:
+              _context72.t0 = _context72.sent;
+            case 20:
               productMap = _context72.t0;
               smallTicketData = buildSmallTicketData({
                 order: enrichedOrder,
                 shopInfo: this.getSmallTicketShopInfo(),
                 locales: [].concat(_toConsumableArray(resolveInvoiceReceiptLocales(options === null || options === void 0 ? void 0 : options.invoiceTemplateSettings)), _toConsumableArray((options === null || options === void 0 ? void 0 : options.locales) || [])),
-                productMap: productMap
+                productMap: productMap,
+                includeReceiptKeys: options === null || options === void 0 ? void 0 : options.includeReceiptKeys,
+                templateSettings: options !== null && options !== void 0 && options.applyTemplateVisibility ? options.invoiceTemplateSettings : undefined
               });
               return _context72.abrupt("return", _objectSpread(_objectSpread({}, enrichedOrder), {}, {
                 payment_info: _objectSpread(_objectSpread({}, enrichedOrder.payment_info || {}), {}, {
                   small_ticket_data: smallTicketData
                 })
               }));
-            case 24:
-              _context72.prev = 24;
-              _context72.t1 = _context72["catch"](4);
+            case 25:
+              _context72.prev = 25;
+              _context72.t1 = _context72["catch"](5);
               this.logError('withLocalSmallTicketData: 生成本地小票数据失败', {
                 error: _context72.t1 instanceof Error ? _context72.t1.message : String(_context72.t1)
               });
+              if (!mustApplyVisibility) {
+                _context72.next = 30;
+                break;
+              }
+              throw _context72.t1;
+            case 30:
               return _context72.abrupt("return", order);
-            case 28:
+            case 31:
             case "end":
               return _context72.stop();
           }
-        }, _callee72, this, [[4, 24]]);
+        }, _callee72, this, [[5, 25]]);
       }));
       function withLocalSmallTicketData(_x80, _x81) {
         return _withLocalSmallTicketData.apply(this, arguments);
@@ -7450,7 +7499,7 @@ var Server = /*#__PURE__*/function () {
     value: function () {
       var _fetchAndPersistSalesOrderByLookup = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee73(lookup, data, title) {
         var _this$order5, _this$order6, _this$app17;
-        var backendPath, response, _response$code3, responseStatusCode, code, message, fresh, savedOrder, _errorRecord$response, backendError, errorRecord, _responseStatusCode, _ref79, _backendError$code2, backendStatusCode, _code, _message2, _message3;
+        var backendPath, response, _response$code3, responseStatusCode, code, message, fresh, savedOrder, _errorRecord$response, backendError, errorRecord, _responseStatusCode, _ref78, _backendError$code2, backendStatusCode, _code, _message2, _message3;
         return _regeneratorRuntime().wrap(function _callee73$(_context73) {
           while (1) switch (_context73.prev = _context73.next) {
             case 0:
@@ -7571,7 +7620,7 @@ var Server = /*#__PURE__*/function () {
                 break;
               }
               backendStatusCode = typeof (backendError === null || backendError === void 0 ? void 0 : backendError.status) === 'number' ? backendError.status : undefined;
-              _code = this.normalizeRemoteSalesOrderErrorCode((_ref79 = (_backendError$code2 = backendError === null || backendError === void 0 ? void 0 : backendError.code) !== null && _backendError$code2 !== void 0 ? _backendError$code2 : backendStatusCode) !== null && _ref79 !== void 0 ? _ref79 : _responseStatusCode);
+              _code = this.normalizeRemoteSalesOrderErrorCode((_ref78 = (_backendError$code2 = backendError === null || backendError === void 0 ? void 0 : backendError.code) !== null && _backendError$code2 !== void 0 ? _backendError$code2 : backendStatusCode) !== null && _ref78 !== void 0 ? _ref78 : _responseStatusCode);
               _message2 = (backendError === null || backendError === void 0 ? void 0 : backendError.message) || this.getUnknownErrorMessage(_context73.t0);
               this.logInfo("".concat(title, ": \u540E\u7AEF\u8BA2\u5355\u67E5\u8BE2\u5931\u8D25"), {
                 lookup: lookup,

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

@@ -463,6 +463,7 @@ export interface OrderData {
             id: number | string;
             tag: 'virtual_currency';
             product_id?: number | string;
+            code?: string;
             product_name: string;
             par_value: string;
             used_par_value: string;

package/dist/shared/receipt/small-ticket.d.ts

@@ -22,6 +22,8 @@ export interface BuildSmallTicketDataParams {
     shopInfo?: SmallTicketShopInfo | null;
     locales?: string[];
     productMap?: Record<string | number, Record<string, any>>;
+    /** Resolved template settings or layout; omitted settings preserve native compatibility. */
+    templateSettings?: unknown;
     /** Customer preview only: stable source identities for bilingual rows. */
     includeReceiptKeys?: boolean;
 }