@pisell/pisellos 2.2.188 → 2.2.189

package/dist/model/strategy/adapter/promotion/index.js

@@ -0,0 +1,9 @@
+// 导出评估器
+export { PromotionEvaluator } from "./evaluator";
+
+// 导出适配器
+export { PromotionAdapter } from "./adapter";
+export { default } from "./adapter";
+
+// 导出策略配置示例常量
+export { X_ITEMS_FOR_Y_PRICE_STRATEGY, BUY_X_GET_Y_FREE_STRATEGY } from "./examples";

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

@@ -143,6 +143,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     private saveDraftInBackground;
     private hydrateTempOrderFromLocalRecord;
     private extractOrderIdFromSubmitResult;
+    private calculatePaymentEffectiveAmount;
     private calculatePaymentTotal;
     private normalizePaymentSource;
     private updateTempOrderPaymentStatus;

package/dist/modules/Order/index.js

@@ -1121,15 +1121,21 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       var _ref3, _ref4, _ref5, _result$data$order_id, _result$data, _result$data2;
       return (_ref3 = (_ref4 = (_ref5 = (_result$data$order_id = result === null || result === void 0 || (_result$data = result.data) === null || _result$data === void 0 ? void 0 : _result$data.order_id) !== null && _result$data$order_id !== void 0 ? _result$data$order_id : result === null || result === void 0 ? void 0 : result.order_id) !== null && _ref5 !== void 0 ? _ref5 : result === null || result === void 0 || (_result$data2 = result.data) === null || _result$data2 === void 0 ? void 0 : _result$data2.id) !== null && _ref4 !== void 0 ? _ref4 : result === null || result === void 0 ? void 0 : result.id) !== null && _ref3 !== void 0 ? _ref3 : null;
     }
+  }, {
+    key: "calculatePaymentEffectiveAmount",
+    value: function calculatePaymentEffectiveAmount(payment) {
+      var amount = new Decimal(payment.amount || 0).minus(new Decimal(payment.service_fee || 0));
+      var rounding = new Decimal(payment.rounding_amount || 0);
+      return amount.minus(rounding);
+    }
   }, {
     key: "calculatePaymentTotal",
     value: function calculatePaymentTotal(payments) {
+      var _this3 = this;
       return mapPaymentItemsToOrderPayments(payments, {
         includeVoided: false
       }).reduce(function (sum, payment) {
-        var amount = new Decimal(payment.amount || 0).minus(new Decimal(payment.service_fee || 0));
-        var rounding = new Decimal(payment.rounding_amount || 0);
-        return sum.plus(amount.minus(rounding));
+        return sum.plus(_this3.calculatePaymentEffectiveAmount(payment));
       }, new Decimal(0));
     }
   }, {
@@ -1170,18 +1176,20 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "calculatePaidPaymentSummary",
     value: function calculatePaidPaymentSummary(payments) {
-      var _this3 = this;
+      var _this4 = this;
       return (payments || []).reduce(function (summary, payment) {
         var paymentRecord = payment;
         if ((paymentRecord === null || paymentRecord === void 0 ? void 0 : paymentRecord.status) !== 'paid') return summary;
         return {
           customerPaidAmount: summary.customerPaidAmount.plus(paymentRecord.amount || 0),
           orderPaidAmount: summary.orderPaidAmount.plus(paymentRecord.origin_amount || 0),
-          payServiceChargeAmount: summary.payServiceChargeAmount.plus(_this3.calculatePaymentServiceFee(paymentRecord))
+          gapPaidAmount: summary.gapPaidAmount.plus(_this4.calculatePaymentEffectiveAmount(paymentRecord)),
+          payServiceChargeAmount: summary.payServiceChargeAmount.plus(_this4.calculatePaymentServiceFee(paymentRecord))
         };
       }, {
         customerPaidAmount: new Decimal(0),
         orderPaidAmount: new Decimal(0),
+        gapPaidAmount: new Decimal(0),
         payServiceChargeAmount: new Decimal(0)
       });
     }
@@ -1565,9 +1573,9 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "findBookingIndexByUniqueIdentificationNumber",
     value: function findBookingIndexByUniqueIdentificationNumber(tempOrder, uniqueIdentificationNumber) {
-      var _this4 = this;
+      var _this5 = this;
       return (tempOrder.bookings || []).findIndex(function (booking) {
-        return _this4.getBookingUniqueIdentificationNumber(booking) === uniqueIdentificationNumber;
+        return _this5.getBookingUniqueIdentificationNumber(booking) === uniqueIdentificationNumber;
       });
     }
   }, {
@@ -1575,12 +1583,12 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     value: function removeLinkedBookingsForProduct(tempOrder, product) {
       var _product$metadata4,
         _product$metadata5,
-        _this5 = this;
+        _this6 = this;
       var productUid = (product === null || product === void 0 || (_product$metadata4 = product.metadata) === null || _product$metadata4 === void 0 ? void 0 : _product$metadata4.unique_identification_number) || (product === null || product === void 0 ? void 0 : product.unique_identification_number);
       var bookingUid = (product === null || product === void 0 ? void 0 : product.booking_uid) || (product === null || product === void 0 || (_product$metadata5 = product.metadata) === null || _product$metadata5 === void 0 ? void 0 : _product$metadata5.booking_uid);
       if (!productUid && !bookingUid) return;
       tempOrder.bookings = (tempOrder.bookings || []).filter(function (booking) {
-        var currentBookingUid = _this5.getBookingUniqueIdentificationNumber(booking);
+        var currentBookingUid = _this6.getBookingUniqueIdentificationNumber(booking);
         if (bookingUid && currentBookingUid === String(bookingUid)) return false;
         if (productUid && String((booking === null || booking === void 0 ? void 0 : booking.product_uid) || '') === String(productUid)) return false;
         return true;
@@ -1623,7 +1631,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 amount_gap: this.calculateSummaryAmountGap({
                   tempOrder: tempOrder,
                   summary: createEmptySummary(),
-                  orderPaidAmount: paidPaymentSummary.orderPaidAmount
+                  orderPaidAmount: paidPaymentSummary.gapPaidAmount
                 }),
                 pay_service_charge_amount: paidPaymentSummary.payServiceChargeAmount.toFixed(2)
               });
@@ -1647,7 +1655,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 amount_gap: this.calculateSummaryAmountGap({
                   tempOrder: tempOrder,
                   summary: salesSummaryResult,
-                  orderPaidAmount: paidPaymentSummary.orderPaidAmount
+                  orderPaidAmount: paidPaymentSummary.gapPaidAmount
                 }),
                 pay_service_charge_amount: paidPaymentSummary.payServiceChargeAmount.toFixed(2)
               });
@@ -1952,7 +1960,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "addOrderPayment",
     value: function addOrderPayment(payment) {
-      var _this6 = this;
+      var _this7 = this;
       this.logInfo('addOrderPayment', {
         payment: payment
       });
@@ -1965,7 +1973,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       void this.recalculateSummary({
         createIfMissing: true
       }).catch(function (error) {
-        _this6.logError('recalculate summary after addOrderPayment failed', {
+        _this7.logError('recalculate summary after addOrderPayment failed', {
           error: error instanceof Error ? error.message : String(error)
         });
       });
@@ -2030,10 +2038,10 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "updateVoucherOrderPayments",
     value: function updateVoucherOrderPayments(payments) {
-      var _this7 = this;
+      var _this8 = this;
       var tempOrder = this.ensureTempOrder();
       var mappedVouchers = mapPaymentItemsToOrderPayments(payments.map(function (payment) {
-        return _this7.normalizePaymentSource(payment, {
+        return _this8.normalizePaymentSource(payment, {
           defaultPaid: false
         });
       })).filter(function (payment) {
@@ -2048,7 +2056,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       void this.recalculateSummary({
         createIfMissing: true
       }).catch(function (error) {
-        _this7.logError('recalculate summary after updateVoucherOrderPayments failed', {
+        _this8.logError('recalculate summary after updateVoucherOrderPayments failed', {
           error: error instanceof Error ? error.message : String(error)
         });
       });
@@ -2104,7 +2112,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     key: "addProductToOrder",
     value: function () {
       var _addProductToOrder = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee16(product, booking) {
-        var _this8 = this;
+        var _this9 = this;
         var tempOrder, linked, productToAdd, incomingFingerprint, normalizedIncoming, hasIncomingGoodPass, shouldForceNewLine, matchedIndex, matchedProduct, existedFingerprint, shouldMerge, _targetProduct$metada, targetProduct, targetUid, normalizedProduct;
         return _regeneratorRuntime().wrap(function _callee16$(_context18) {
           while (1) switch (_context18.prev = _context18.next) {
@@ -2122,7 +2130,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               hasIncomingGoodPass = this.hasGoodPassDiscount(normalizedIncoming);
               shouldForceNewLine = !!booking;
               matchedIndex = hasIncomingGoodPass || shouldForceNewLine ? -1 : tempOrder.products.findIndex(function (item) {
-                if (_this8.hasGoodPassDiscount(item)) return false;
+                if (_this9.hasGoodPassDiscount(item)) return false;
                 if (item.product_id !== productToAdd.product_id) return false;
                 if (item.product_variant_id !== productToAdd.product_variant_id) return false;
                 var existedFingerprint = buildProductLineFingerprint(item.product_option_item, item.product_bundle);
@@ -2699,10 +2707,10 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     value: function extractSubmitErrorResponse(error) {
       var _error$response,
         _error$response2,
-        _this9 = this;
+        _this10 = this;
       var candidates = [error === null || error === void 0 || (_error$response = error.response) === null || _error$response === void 0 ? void 0 : _error$response.data, error === null || error === void 0 ? void 0 : error.data, error === null || error === void 0 || (_error$response2 = error.response) === null || _error$response2 === void 0 ? void 0 : _error$response2.body, error === null || error === void 0 ? void 0 : error.body];
       return candidates.find(function (candidate) {
-        return _this9.isSubmitErrorResponse(candidate);
+        return _this10.isSubmitErrorResponse(candidate);
       }) || null;
     }
   }, {
@@ -3280,7 +3288,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "normalizeTempOrderForRuntime",
     value: function normalizeTempOrderForRuntime(raw, options) {
-      var _this10 = this;
+      var _this11 = this;
       var nextTempOrder = _objectSpread(_objectSpread({}, this.createDefaultTempOrderInstance()), raw || {});
       delete nextTempOrder.summary;
       delete nextTempOrder.lastOrderInfo;
@@ -3299,7 +3307,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       nextTempOrder.holder = raw.holder && _typeof(raw.holder) === 'object' ? _objectSpread({}, raw.holder) : null;
       var rawProducts = Array.isArray(raw.products) ? raw.products : [];
       nextTempOrder.products = rawProducts.length > 0 ? rawProducts.map(function (p) {
-        return _this10.normalizeHydratedOrderProduct(p);
+        return _this11.normalizeHydratedOrderProduct(p);
       }) : [];
       nextTempOrder.bookings = Array.isArray(raw.bookings) ? raw.bookings.map(function (b) {
         return _objectSpread(_objectSpread({}, b || {}), {}, {
@@ -3459,14 +3467,14 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     key: "resolveHydratedProductOptions",
     value: function resolveHydratedProductOptions(row) {
       var _row$product_sku,
-        _this11 = this;
+        _this12 = this;
       var skuOptions = (_row$product_sku = row.product_sku) === null || _row$product_sku === void 0 ? void 0 : _row$product_sku.option;
       if (Array.isArray(row.product_option_item) && row.product_option_item.length > 0) {
         return this.mergeHydratedProductOptionDisplayFields(row.product_option_item, skuOptions);
       }
       if (!Array.isArray(skuOptions)) return [];
       return skuOptions.map(function (optionItem) {
-        return _this11.normalizeHydratedProductOptionItem(optionItem || {});
+        return _this12.normalizeHydratedProductOptionItem(optionItem || {});
       });
     }
   }, {

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

@@ -439,6 +439,7 @@ export interface OrderPaymentMetadata {
     [key: string]: any;
 }
 export interface OrderPaymentData {
+    order_payment_id?: number | string;
     amount: string;
     code: string;
     custom_payment_id: number;

package/dist/modules/Order/utils.js

@@ -825,7 +825,9 @@ export function mapPaymentItemToOrderPayment(paymentItem) {
       metadata[key] = item[key];
     }
   }
-  return _objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({
+  return _objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({}, item.order_payment_id !== undefined ? {
+    order_payment_id: item.order_payment_id
+  } : {}), {}, {
     amount: String((_item$amount = item.amount) !== null && _item$amount !== void 0 ? _item$amount : '0.00'),
     code: String(item.code || ''),
     custom_payment_id: Number(customPaymentId !== null && customPaymentId !== void 0 ? customPaymentId : 0),

package/dist/solution/BaseSales/index.js

@@ -607,7 +607,7 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
               };
               externalSaleNumber = params.externalSaleNumber || params.external_sale_number;
               if (params.forceRemote) {
-                _context5.next = 36;
+                _context5.next = 35;
                 break;
               }
               if (!(params.orderId !== undefined)) {
@@ -650,59 +650,58 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
               _context5.t0 = _context5.t1;
             case 26:
               localRecord = _context5.t0;
-              debugger;
               if (!localRecord) {
-                _context5.next = 36;
+                _context5.next = 35;
                 break;
               }
-              _context5.next = 31;
+              _context5.next = 30;
               return this.store.order.hydrateTempOrderFromRecord(localRecord, {
                 recalcOnHydrate: false
               });
-            case 31:
+            case 30:
               _sales = _context5.sent;
               this.currentSalesDetail = _sales;
-              _context5.next = 35;
+              _context5.next = 34;
               return this.core.effects.emit("".concat(this.name, ":onSalesOrderLoaded"), {
                 sales: _sales
               });
-            case 35:
+            case 34:
               return _context5.abrupt("return", _sales);
-            case 36:
+            case 35:
               if (!(params.orderId === undefined || params.orderId === null)) {
-                _context5.next = 38;
+                _context5.next = 37;
                 break;
               }
               throw new Error('加载销售详情需要 orderId，或本地库中存在对应 externalSaleNumber/orderNumber');
-            case 38:
-              _context5.next = 40;
+            case 37:
+              _context5.next = 39;
               return this.store.order.getOrderInfoByRemote(Number(params.orderId));
-            case 40:
+            case 39:
               res = _context5.sent;
               if (!(!res || res.code !== 200)) {
-                _context5.next = 44;
+                _context5.next = 43;
                 break;
               }
               message = res && (res.message || res.msg) || "\u52A0\u8F7D\u9500\u552E\u8BE6\u60C5\u5931\u8D25: ".concat(params.orderId);
               throw new Error(message);
-            case 44:
-              _context5.next = 46;
+            case 43:
+              _context5.next = 45;
               return this.store.order.hydrateTempOrderFromRecord(res.data, {
                 recalcOnHydrate: false
               });
-            case 46:
+            case 45:
               sales = _context5.sent;
-              _context5.next = 49;
+              _context5.next = 48;
               return this.store.order.saveDraft();
-            case 49:
+            case 48:
               this.currentSalesDetail = sales;
-              _context5.next = 52;
+              _context5.next = 51;
               return this.core.effects.emit("".concat(this.name, ":onSalesOrderLoaded"), {
                 sales: sales
               });
-            case 52:
+            case 51:
               return _context5.abrupt("return", sales);
-            case 53:
+            case 52:
             case "end":
               return _context5.stop();
           }

package/dist/solution/BookingByStep/index.d.ts

@@ -311,7 +311,7 @@ export declare class BookingByStepImpl extends BaseModule implements Module {
         date: string;
         status: string;
         week: string;
-        weekNum: 0 | 1 | 2 | 3 | 5 | 4 | 6;
+        weekNum: 0 | 1 | 2 | 6 | 3 | 5 | 4;
     }[]>;
     submitTimeSlot(timeSlots: TimeSliceItem): void;
     private getScheduleDataByIds;

package/dist/solution/BookingTicket/index.d.ts

@@ -7,6 +7,7 @@ import { BaseSalesImpl } from '../BaseSales';
 import type { BaseSalesScanCodeResult } from '../BaseSales/types';
 import type { ISalesDetail } from '../BaseSales/utils/parseSalesResponse';
 import type { LoadSalesDetailParams } from '../../modules/Order/types';
+import type { GlobalScanHandleResult, GlobalScanHostBridge } from './types';
 import { AddProductDecideContext, AddProductRequiresDetailPayload } from './utils/addProductDecision';
 import { type BuildCacheItemFromOrderLineInput } from '../../modules/BookingContext/utils/buildCacheItemFromOrderLine';
 import { type BuildNormalProductCacheItemFromOrderLineInput } from '../../modules/BookingContext/utils/buildNormalProductCacheItemFromOrderLine';
@@ -441,6 +442,20 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
     buildNormalProductCacheItemFromOrderLine(input: BuildNormalProductCacheItemFromOrderLineInput): Record<string, any>;
     /** 文档别名：与 OrderModule.updateOrderProduct 一致。 */
     updateProductInOrder(params: UpdateOrderProductParams): Promise<OrderProduct[]>;
+    /**
+     * 全局扫码 pubsub 入口：解析码值 → 搜索 → 业务分发（客户 / 加车 / 开单）。
+     * UI 层在 pubsub 订阅回调里注入 `bridge`（uiHosts / action / cart.confirm*）。
+     *
+     * @example
+     * ```ts
+     * await bookingTicket.handleGlobalScanCode(payload.data, {
+     *   openProductDetail: uiHosts.openProductDetail,
+     *   confirmDetail: cart.confirmDetail,
+     *   openOrder: ({ order_id }) => action({ type: 'pisell1.handleOpenCachedBigSale', data: { order_id } }),
+     * });
+     * ```
+     */
+    handleGlobalScanCode(code: string, bridge?: GlobalScanHostBridge): Promise<GlobalScanHandleResult>;
     /**
      * 销毁模块：先调用父类（销毁所有 store 内子模块 + emit destroy + super.destroy()），
      * 再清理 BookingTicket 自有资源（scan 监听 + scan 内存缓存）。

package/dist/solution/BookingTicket/index.js

@@ -37,6 +37,8 @@ import Scan from "./utils/scan";
 import { formatOrderCustomerPatch } from "./utils/orderCustomer";
 import { handleGlobalScan, handleCustomerScan, handleUniversalScan } from "./utils/scan/handleScan";
 import scanCache from "./utils/scan/scanCache";
+import { formatGlobalScanResult } from "./utils/scan/formatGlobalScan";
+import { applyGlobalScan } from "./utils/scan/applyGlobalScan";
 import { buildCartView } from "./utils/cartView";
 import { buildCacheItemFromCartDetail, buildCacheItemFromDetail, buildRequiresDetailPayload as _buildRequiresDetailPayload, decideAddProduct as decideAddProductUtil, decideAfterDetail as decideAfterDetailUtil, decideAutoClose as decideAutoCloseUtil, getIsEject as getIsEjectUtil, getIsOnlySession as getIsOnlySessionUtil, transformDetailToProductAndBooking as transformDetailToProductAndBookingUtil } from "./utils/addProductDecision";
 import { buildCacheItemFromOrderLine as buildCacheItemFromOrderLineUtil } from "../../modules/BookingContext/utils/buildCacheItemFromOrderLine";
@@ -1738,6 +1740,115 @@ export var BookingTicketImpl = /*#__PURE__*/function (_BaseSalesImpl) {
       }
       return updateProductInOrder;
     }()
+    /**
+     * 全局扫码 pubsub 入口：解析码值 → 搜索 → 业务分发（客户 / 加车 / 开单）。
+     * UI 层在 pubsub 订阅回调里注入 `bridge`（uiHosts / action / cart.confirm*）。
+     *
+     * @example
+     * ```ts
+     * await bookingTicket.handleGlobalScanCode(payload.data, {
+     *   openProductDetail: uiHosts.openProductDetail,
+     *   confirmDetail: cart.confirmDetail,
+     *   openOrder: ({ order_id }) => action({ type: 'pisell1.handleOpenCachedBigSale', data: { order_id } }),
+     * });
+     * ```
+     */
+    )
+  }, {
+    key: "handleGlobalScanCode",
+    value: (function () {
+      var _handleGlobalScanCode = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee23(code, bridge) {
+        var _this6 = this;
+        var trimmed, _bridge$onNotify, _bridge$refresh, localSearch, scanCallback, raw, formatted, _bridge$onNotify2, _result7, _bridge$onNotify3;
+        return _regeneratorRuntime().wrap(function _callee23$(_context23) {
+          while (1) switch (_context23.prev = _context23.next) {
+            case 0:
+              trimmed = typeof code === 'string' ? code.trim() : '';
+              if (trimmed) {
+                _context23.next = 4;
+                break;
+              }
+              bridge === null || bridge === void 0 || (_bridge$onNotify = bridge.onNotify) === null || _bridge$onNotify === void 0 || _bridge$onNotify.call(bridge, 'fail', 'pisell2.text.scan-global-failed');
+              return _context23.abrupt("return", {
+                status: 'failed',
+                reason: 'empty_code'
+              });
+            case 4:
+              _context23.prev = 4;
+              localSearch = function localSearch(v) {
+                return _this6.store.products.findProductsByCodeOrBarcode(v);
+              };
+              scanCallback = handleGlobalScan(this.request, localSearch);
+              _context23.next = 9;
+              return scanCallback({
+                type: 'nativeScanner',
+                value: trimmed
+              });
+            case 9:
+              raw = _context23.sent;
+              formatted = formatGlobalScanResult(raw, trimmed);
+              if (formatted) {
+                _context23.next = 14;
+                break;
+              }
+              bridge === null || bridge === void 0 || (_bridge$onNotify2 = bridge.onNotify) === null || _bridge$onNotify2 === void 0 || _bridge$onNotify2.call(bridge, 'fail', 'pisell2.text.scan-global-failed');
+              return _context23.abrupt("return", {
+                status: 'failed',
+                reason: 'not_found'
+              });
+            case 14:
+              _context23.next = 16;
+              return applyGlobalScan({
+                setOrderCustomer: function setOrderCustomer(customer) {
+                  return _this6.setOrderCustomer(customer);
+                },
+                getOrderCustomerSnapshot: function getOrderCustomerSnapshot() {
+                  return _this6.getOrderCustomerSnapshot();
+                },
+                getBusinessCode: function getBusinessCode() {
+                  var _this6$otherParams;
+                  return (_this6$otherParams = _this6.otherParams) === null || _this6$otherParams === void 0 ? void 0 : _this6$otherParams.businessCode;
+                },
+                buildAddProductCtx: function buildAddProductCtx(extra) {
+                  return _this6.buildAddProductCtx(extra);
+                },
+                decideAddProduct: function decideAddProduct(item, options) {
+                  return _this6.decideAddProduct(item, options);
+                },
+                decideAfterDetail: function decideAfterDetail(cacheItem, options) {
+                  return _this6.decideAfterDetail(cacheItem, options);
+                },
+                transformDetailToProductAndBooking: function transformDetailToProductAndBooking(input) {
+                  return _this6.transformDetailToProductAndBooking(input);
+                },
+                addProductToOrder: function addProductToOrder(product, booking) {
+                  return _this6.addProductToOrder(product, booking);
+                }
+              }, formatted, bridge);
+            case 16:
+              _result7 = _context23.sent;
+              bridge === null || bridge === void 0 || (_bridge$refresh = bridge.refresh) === null || _bridge$refresh === void 0 || _bridge$refresh.call(bridge);
+              return _context23.abrupt("return", _result7);
+            case 21:
+              _context23.prev = 21;
+              _context23.t0 = _context23["catch"](4);
+              console.error('[BookingTicket] handleGlobalScanCode failed', _context23.t0);
+              bridge === null || bridge === void 0 || (_bridge$onNotify3 = bridge.onNotify) === null || _bridge$onNotify3 === void 0 || _bridge$onNotify3.call(bridge, 'fail', 'pisell2.text.scan-global-failed');
+              return _context23.abrupt("return", {
+                status: 'failed',
+                reason: 'not_found'
+              });
+            case 26:
+            case "end":
+              return _context23.stop();
+          }
+        }, _callee23, this, [[4, 21]]);
+      }));
+      function handleGlobalScanCode(_x18, _x19) {
+        return _handleGlobalScanCode.apply(this, arguments);
+      }
+      return handleGlobalScanCode;
+    }()
     /**
      * 销毁模块：先调用父类（销毁所有 store 内子模块 + emit destroy + super.destroy()），
      * 再清理 BookingTicket 自有资源（scan 监听 + scan 内存缓存）。
@@ -1746,12 +1857,12 @@ export var BookingTicketImpl = /*#__PURE__*/function (_BaseSalesImpl) {
   }, {
     key: "destroy",
     value: (function () {
-      var _destroy = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee23() {
+      var _destroy = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee24() {
         var _this$scan;
-        return _regeneratorRuntime().wrap(function _callee23$(_context23) {
-          while (1) switch (_context23.prev = _context23.next) {
+        return _regeneratorRuntime().wrap(function _callee24$(_context24) {
+          while (1) switch (_context24.prev = _context24.next) {
             case 0:
-              _context23.next = 2;
+              _context24.next = 2;
               return _get(_getPrototypeOf(BookingTicketImpl.prototype), "destroy", this).call(this);
             case 2:
               try {
@@ -1762,9 +1873,9 @@ export var BookingTicketImpl = /*#__PURE__*/function (_BaseSalesImpl) {
               scanCache.clear();
             case 4:
             case "end":
-              return _context23.stop();
+              return _context24.stop();
           }
-        }, _callee23, this);
+        }, _callee24, this);
       }));
       function destroy() {
         return _destroy.apply(this, arguments);

package/dist/solution/BookingTicket/types.d.ts

@@ -134,3 +134,51 @@ export interface BookingTicketCustomerView {
 export interface BookingTicketProductCatalogView {
     products: ProductData[];
 }
+/** 扫码宿主桥接：SalesSdk 在 pubsub 订阅回调里注入，OS 需要 UI 时直接调用 */
+export interface GlobalScanHostBridge {
+    openProductDetail?: (payload: Record<string, any>) => Promise<any | null>;
+    openBookingEdit?: (payload: Record<string, any>) => Promise<any | null>;
+    confirmDetail?: (input: {
+        item: any;
+        detailResult: {
+            e: any;
+            extension_type?: any;
+            detail?: any;
+        };
+        options?: Record<string, any>;
+    }) => Promise<any>;
+    confirmBookingEdit?: (input: {
+        cacheItem: any;
+        options?: Record<string, any>;
+    }) => Promise<any>;
+    openOrder?: (data: {
+        order_id: number;
+        business_code?: string;
+    }) => void;
+    /**
+     * walk-in 扫 walletPass：直接核销优惠码（对齐 SaleDetail Voucher.handleApplyCode / cart.scanCode）。
+     */
+    applyPromotionCode?: (code: string, customerId?: number) => Promise<{
+        isAvailable?: boolean;
+        type?: string;
+        unavailableReason?: string;
+    }>;
+    onNotify?: (type: 'success' | 'fail' | 'info', messageKey?: string) => void;
+    refresh?: () => void;
+}
+/** handleGlobalScanCode 结构化返回 */
+export type GlobalScanHandleResult = {
+    status: 'success';
+    kind: 'customer' | 'products' | 'promotion';
+    meta?: {
+        count?: number;
+    };
+} | {
+    status: 'pending';
+    kind: 'openOrder' | 'requiresDetail' | 'requiresBookingEdit';
+} | {
+    status: 'cancelled';
+} | {
+    status: 'failed';
+    reason: 'empty_code' | 'not_found' | 'invalid_data' | 'no_bridge';
+};

package/dist/solution/BookingTicket/types.js

@@ -77,4 +77,8 @@ export var BookingTicketHooks = /*#__PURE__*/function (BookingTicketHooks) {
 
 /**
  * BookingTicket 当前已加载的商品池视图。
- */
+ */
+
+/** 扫码宿主桥接：SalesSdk 在 pubsub 订阅回调里注入，OS 需要 UI 时直接调用 */
+
+/** handleGlobalScanCode 结构化返回 */

package/dist/solution/BookingTicket/utils/scan/applyGlobalScan.d.ts

@@ -0,0 +1,36 @@
+import type { GlobalScanHandleResult, GlobalScanHostBridge, ICustomer } from '../../types';
+import type { AddProductDecision } from '../addProductDecision';
+import { GlobalScanFormattedResult } from './formatGlobalScan';
+/** applyGlobalScan 所需的 BookingTicket 运行时能力 */
+export interface GlobalScanApplyHost {
+    setOrderCustomer(customer: ICustomer | null): void;
+    getOrderCustomerSnapshot(): ICustomer | null;
+    getBusinessCode(): string | undefined;
+    buildAddProductCtx(extra?: Record<string, any>): Record<string, any>;
+    decideAddProduct(item: any, options?: Record<string, any>): AddProductDecision;
+    decideAfterDetail(cacheItem: any, options?: Record<string, any>): AddProductDecision;
+    transformDetailToProductAndBooking(input: {
+        item: any;
+        cacheItem?: any;
+        detailResult?: {
+            e: any;
+            extension_type?: any;
+            detail?: any;
+        };
+        options?: Record<string, any>;
+    }): {
+        product: any;
+        booking?: any;
+        cacheItem: any;
+    };
+    addProductToOrder(product: any, booking?: any): Promise<any>;
+}
+/**
+ * 应用全局扫码格式化结果：设客户 / 加车 / 开单 / 弹窗链。
+ *
+ * @example
+ * ```ts
+ * const result = await applyGlobalScan(bookingTicket, formatted, bridge);
+ * ```
+ */
+export declare function applyGlobalScan(host: GlobalScanApplyHost, formatted: GlobalScanFormattedResult, bridge?: GlobalScanHostBridge): Promise<GlobalScanHandleResult>;