@pisell/pisellos 2.2.188 → 2.2.190

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();
           }
@@ -1790,7 +1789,7 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
     key: "submitSalesOrder",
     value: (function () {
       var _submitSalesOrder = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee18(params) {
-        var _this$otherParams6, _this$otherParams7, _this$otherParams8;
+        var _this$otherParams6, _this$otherParams7, _this$otherParams8, _this$otherParams9;
         var inferredPaymentStatus, submitParams;
         return _regeneratorRuntime().wrap(function _callee18$(_context18) {
           while (1) switch (_context18.prev = _context18.next) {
@@ -1806,9 +1805,9 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
               submitParams = _objectSpread(_objectSpread(_objectSpread(_objectSpread({
                 cacheId: this.cacheId,
                 platform: (_this$otherParams6 = this.otherParams) === null || _this$otherParams6 === void 0 ? void 0 : _this$otherParams6.platform,
-                businessCode: (_this$otherParams7 = this.otherParams) === null || _this$otherParams7 === void 0 ? void 0 : _this$otherParams7.businessCode,
+                businessCode: ((_this$otherParams7 = this.otherParams) === null || _this$otherParams7 === void 0 ? void 0 : _this$otherParams7.businessCode) || ((_this$otherParams8 = this.otherParams) === null || _this$otherParams8 === void 0 ? void 0 : _this$otherParams8.business_code),
                 channel: this.getSubmitOrderSalesChannel(),
-                type: (_this$otherParams8 = this.otherParams) === null || _this$otherParams8 === void 0 ? void 0 : _this$otherParams8.type
+                type: (_this$otherParams9 = this.otherParams) === null || _this$otherParams9 === void 0 ? void 0 : _this$otherParams9.type
               }, (params === null || params === void 0 ? void 0 : params.payments) !== undefined ? {
                 payments: params.payments
               } : {}), inferredPaymentStatus !== undefined ? {
@@ -1848,8 +1847,8 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
     key: "syncPaymentsToOrder",
     value: function () {
       var _syncPaymentsToOrder = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee19(params) {
-        var _params$channel;
-        var channel, syncParams, syncState, payments, syncResult;
+        var _ref9, _params$businessCode, _this$otherParams10, _this$otherParams11, _params$channel;
+        var businessCode, channel, syncParams, syncState, payments, syncResult;
         return _regeneratorRuntime().wrap(function _callee19$(_context19) {
           while (1) switch (_context19.prev = _context19.next) {
             case 0:
@@ -1859,32 +1858,35 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
               }
               throw new Error('order 模块未初始化');
             case 2:
+              businessCode = (_ref9 = (_params$businessCode = params.businessCode) !== null && _params$businessCode !== void 0 ? _params$businessCode : (_this$otherParams10 = this.otherParams) === null || _this$otherParams10 === void 0 ? void 0 : _this$otherParams10.businessCode) !== null && _ref9 !== void 0 ? _ref9 : (_this$otherParams11 = this.otherParams) === null || _this$otherParams11 === void 0 ? void 0 : _this$otherParams11.business_code;
               channel = (_params$channel = params.channel) !== null && _params$channel !== void 0 ? _params$channel : this.getSubmitOrderSalesChannel();
-              syncParams = _objectSpread(_objectSpread({}, params), channel !== undefined ? {
+              syncParams = _objectSpread(_objectSpread(_objectSpread({}, params), businessCode !== undefined ? {
+                businessCode: businessCode
+              } : {}), channel !== undefined ? {
                 channel: channel
               } : {});
               syncState = this.store.order.getOrderSyncState();
               if (!(params.submitWhenPaid && syncState === 'submitting')) {
-                _context19.next = 7;
+                _context19.next = 8;
                 break;
               }
               return _context19.abrupt("return", this.store.order.syncPaymentsToOrder(syncParams));
-            case 7:
+            case 8:
               payments = params.payments || [];
-              _context19.next = 10;
+              _context19.next = 11;
               return this.effectsEmit(BaseSalesHookNames.onPaymentSyncStart, {
                 payments: payments,
                 params: syncParams,
                 amountSnapshot: this.store.order.getOrderAmountSnapshot(),
                 orderSnapshot: this.store.order.getOrderSnapshot()
               });
-            case 10:
-              _context19.prev = 10;
-              _context19.next = 13;
+            case 11:
+              _context19.prev = 11;
+              _context19.next = 14;
               return this.store.order.syncPaymentsToOrder(syncParams);
-            case 13:
+            case 14:
               syncResult = _context19.sent;
-              _context19.next = 16;
+              _context19.next = 17;
               return this.effectsEmit(BaseSalesHookNames.onPaymentSyncEnd, {
                 ok: true,
                 syncResult: syncResult,
@@ -1893,12 +1895,12 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
                 amountSnapshot: this.store.order.getOrderAmountSnapshot(),
                 orderSnapshot: this.store.order.getOrderSnapshot()
               });
-            case 16:
+            case 17:
               return _context19.abrupt("return", syncResult);
-            case 19:
-              _context19.prev = 19;
-              _context19.t0 = _context19["catch"](10);
-              _context19.next = 23;
+            case 20:
+              _context19.prev = 20;
+              _context19.t0 = _context19["catch"](11);
+              _context19.next = 24;
               return this.effectsEmit(BaseSalesHookNames.onPaymentSyncEnd, {
                 ok: false,
                 error: _context19.t0,
@@ -1907,13 +1909,13 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
                 amountSnapshot: this.store.order.getOrderAmountSnapshot(),
                 orderSnapshot: this.store.order.getOrderSnapshot()
               });
-            case 23:
-              throw _context19.t0;
             case 24:
+              throw _context19.t0;
+            case 25:
             case "end":
               return _context19.stop();
           }
-        }, _callee19, this, [[10, 19]]);
+        }, _callee19, this, [[11, 20]]);
       }));
       function syncPaymentsToOrder(_x15) {
         return _syncPaymentsToOrder.apply(this, arguments);
@@ -1939,10 +1941,16 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "addOrderPayment",
     value: function addOrderPayment(payment) {
-      var _this6 = this;
+      var _this$otherParams12,
+        _this6 = this;
       if (!this.store.order) throw new Error('order 模块未初始化');
       var paymentRecord = payment;
       var metadata = paymentRecord.metadata && _typeof(paymentRecord.metadata) === 'object' ? _objectSpread({}, paymentRecord.metadata) : {};
+      debugger;
+      var shopWalletPassId = (_this$otherParams12 = this.otherParams) === null || _this$otherParams12 === void 0 ? void 0 : _this$otherParams12.shop_wallet_pass_id;
+      if (shopWalletPassId !== undefined && shopWalletPassId !== null) {
+        metadata.shop_wallet_pass_id = shopWalletPassId;
+      }
       if (!metadata.unique_identification_number) {
         metadata.unique_identification_number = createUuidV4();
       }
@@ -2051,7 +2059,7 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
     key: "initWalletData",
     value: function () {
       var _initWalletData = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee20(params) {
-        var _params$order_wait_pa, _ref9, _tempOrder$is_price_i;
+        var _params$order_wait_pa, _ref10, _tempOrder$is_price_i;
         var snapshot, tempOrder, amount, walletBusinessData, result;
         return _regeneratorRuntime().wrap(function _callee20$(_context20) {
           while (1) switch (_context20.prev = _context20.next) {
@@ -2094,7 +2102,7 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
                 },
                 products: this.getWalletProductList(),
                 order_wait_pay_amount: (_params$order_wait_pa = params === null || params === void 0 ? void 0 : params.order_wait_pay_amount) !== null && _params$order_wait_pa !== void 0 ? _params$order_wait_pa : Number(amount.amountGap || 0),
-                is_price_include_tax: (_ref9 = (_tempOrder$is_price_i = tempOrder.is_price_include_tax) !== null && _tempOrder$is_price_i !== void 0 ? _tempOrder$is_price_i : this.otherParams.is_price_include_tax) !== null && _ref9 !== void 0 ? _ref9 : 1
+                is_price_include_tax: (_ref10 = (_tempOrder$is_price_i = tempOrder.is_price_include_tax) !== null && _tempOrder$is_price_i !== void 0 ? _tempOrder$is_price_i : this.otherParams.is_price_include_tax) !== null && _ref10 !== void 0 ? _ref10 : 1
               }, snapshot.identity.orderId ? {
                 payment_order_id: String(snapshot.identity.orderId)
               } : {});
@@ -2210,7 +2218,7 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
     key: "sendCustomerPayLink",
     value: (function () {
       var _sendCustomerPayLink = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee22(params) {
-        var orderIds, _ref10, _ref11, _submitResult$data$or, _submitResult$data, _submitResult$data2, submitResult, orderId;
+        var orderIds, _ref11, _ref12, _submitResult$data$or, _submitResult$data, _submitResult$data2, submitResult, orderId;
         return _regeneratorRuntime().wrap(function _callee22$(_context22) {
           while (1) switch (_context22.prev = _context22.next) {
             case 0:
@@ -2231,7 +2239,7 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
               });
             case 6:
               submitResult = _context22.sent;
-              orderId = (_ref10 = (_ref11 = (_submitResult$data$or = submitResult === null || submitResult === void 0 || (_submitResult$data = submitResult.data) === null || _submitResult$data === void 0 ? void 0 : _submitResult$data.order_id) !== null && _submitResult$data$or !== void 0 ? _submitResult$data$or : submitResult === null || submitResult === void 0 ? void 0 : submitResult.order_id) !== null && _ref11 !== void 0 ? _ref11 : submitResult === null || submitResult === void 0 || (_submitResult$data2 = submitResult.data) === null || _submitResult$data2 === void 0 ? void 0 : _submitResult$data2.id) !== null && _ref10 !== void 0 ? _ref10 : submitResult === null || submitResult === void 0 ? void 0 : submitResult.id;
+              orderId = (_ref11 = (_ref12 = (_submitResult$data$or = submitResult === null || submitResult === void 0 || (_submitResult$data = submitResult.data) === null || _submitResult$data === void 0 ? void 0 : _submitResult$data.order_id) !== null && _submitResult$data$or !== void 0 ? _submitResult$data$or : submitResult === null || submitResult === void 0 ? void 0 : submitResult.order_id) !== null && _ref12 !== void 0 ? _ref12 : submitResult === null || submitResult === void 0 || (_submitResult$data2 = submitResult.data) === null || _submitResult$data2 === void 0 ? void 0 : _submitResult$data2.id) !== null && _ref11 !== void 0 ? _ref11 : submitResult === null || submitResult === void 0 ? void 0 : submitResult.id;
               if (orderId) {
                 _context22.next = 10;
                 break;
@@ -2588,13 +2596,13 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
     key: "getProductList",
     value: function () {
       var _getProductList = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee30() {
-        var _this$otherParams9;
+        var _this$otherParams13;
         var menu_list_ids, _this$store$products, res;
         return _regeneratorRuntime().wrap(function _callee30$(_context30) {
           while (1) switch (_context30.prev = _context30.next) {
             case 0:
               // 可以直接通过配置里的 menu 读取
-              menu_list_ids = ((_this$otherParams9 = this.otherParams) === null || _this$otherParams9 === void 0 || (_this$otherParams9 = _this$otherParams9.dineInConfig) === null || _this$otherParams9 === void 0 ? void 0 : _this$otherParams9['menu.associated_menus'].map(function (n) {
+              menu_list_ids = ((_this$otherParams13 = this.otherParams) === null || _this$otherParams13 === void 0 || (_this$otherParams13 = _this$otherParams13.dineInConfig) === null || _this$otherParams13 === void 0 ? void 0 : _this$otherParams13['menu.associated_menus'].map(function (n) {
                 return Number(n.value);
               })) || [];
               _context30.prev = 1;
@@ -2632,14 +2640,14 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
     key: "setOtherParams",
     value: function () {
       var _setOtherParams = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee31(params) {
-        var _ref12,
-          _ref12$cover,
+        var _ref13,
+          _ref13$cover,
           cover,
           _args31 = arguments;
         return _regeneratorRuntime().wrap(function _callee31$(_context31) {
           while (1) switch (_context31.prev = _context31.next) {
             case 0:
-              _ref12 = _args31.length > 1 && _args31[1] !== undefined ? _args31[1] : {}, _ref12$cover = _ref12.cover, cover = _ref12$cover === void 0 ? false : _ref12$cover;
+              _ref13 = _args31.length > 1 && _args31[1] !== undefined ? _args31[1] : {}, _ref13$cover = _ref13.cover, cover = _ref13$cover === void 0 ? false : _ref13$cover;
               if (cover) {
                 this.otherParams = params;
               } else {

package/dist/solution/BaseSales/utils/transformBaseProductToOrderProduct.js

@@ -4,6 +4,7 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import { composeLinePrice, sumOptionUnitPrice } from "../../../modules/Order/utils";
 import { buildManualProductDiscountItem, mergeManualProductDiscountIntoList, resolveManualDiscountOriginTotal, resolveManualDiscountReasonFromSources, shouldBuildManualProductDiscount } from "../../../modules/Order/utils/manualProductDiscount";
 function toNumber(value) {
   var fallback = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
@@ -123,6 +124,16 @@ export function transformBaseProductToOrderProduct(params) {
     discountway: (_payload$_extend5 = payload._extend) === null || _payload$_extend5 === void 0 ? void 0 : _payload$_extend5.discountway,
     discount_per: (_payload$_extend6 = payload._extend) === null || _payload$_extend6 === void 0 ? void 0 : _payload$_extend6.discount_per
   })) : payload.discount_list || [];
+
+  // v2：source 不含 option；main_product_* 含 option（与 normalizeOrderProduct 一致）
+  var optionSum = sumOptionUnitPrice(productOptionItem).toNumber();
+  var mainProductOriginalPrice = toPriceString(Number(sourceProductPrice) + optionSum);
+  var bundleOnlyComposite = composeLinePrice({
+    mainPrice: 0,
+    bundle: productBundle
+  });
+  var derivedMainSelling = Number(lineCompositeTotal) - Number(bundleOnlyComposite);
+  var mainProductSellingPrice = toPriceString(Number.isFinite(derivedMainSelling) && derivedMainSelling >= 0 ? derivedMainSelling : Number(mainProductOriginalPrice));
   var metadata = _objectSpread(_objectSpread({
     unique: payload.unique,
     session: payload.session,
@@ -135,8 +146,9 @@ export function transformBaseProductToOrderProduct(params) {
     source_shop_id: payload.source_shop_id,
     origin: origin,
     source_product_price: sourceProductPrice,
-    main_product_selling_price: sourceProductPrice,
-    main_product_original_price: sourceProductPrice
+    main_product_selling_price: mainProductSellingPrice,
+    main_product_original_price: mainProductOriginalPrice,
+    price_schema_version: 2
   }, hasPriceOverride ? {
     price_override: String(payload.price_override),
     is_manual_discount: 1

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 | 5 | 1 | 4 | 2 | 3 | 6;
     }[]>;
     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';
@@ -278,7 +279,7 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
      * 获取当前的客户搜索条件
      * @returns 当前搜索条件
      */
-    getCurrentCustomerSearchParams(): Omit<import("../../modules").ShopGetCustomerListParams, "num" | "skip">;
+    getCurrentCustomerSearchParams(): Omit<import("../../modules").ShopGetCustomerListParams, "skip" | "num">;
     /**
      * 获取客户列表状态（包含滚动加载相关状态）
      * @returns 客户状态
@@ -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>;