@pisell/pisellos 0.10.53 → 0.10.55

package/dist/shared/sales/loadSalesOrderSnapshot.d.ts

@@ -0,0 +1,9 @@
+import type { RequestPlugin } from '../../plugins/request';
+export declare const SALES_ORDER_RELATIONS: string[];
+/** Shared transport contract; remote callers use their host's /h5 prefix. */
+export declare function loadSalesOrderSnapshot(request: RequestPlugin, params: {
+    lookup: string | number;
+    transport: 'remote' | 'os-server';
+    forceRemote?: boolean;
+    with?: string[];
+}): Promise<any>;

package/dist/shared/sales/loadSalesOrderSnapshot.js

@@ -0,0 +1,21 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+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); }
+export var SALES_ORDER_RELATIONS = ['products', 'bookings', 'payments', 'customer', 'summary', 'contacts_info', 'order_meta_list', 'refunds', 'notes'];
+
+/** Shared transport contract; remote callers use their host's /h5 prefix. */
+export function loadSalesOrderSnapshot(request, params) {
+  var _params$lookup, _params$with;
+  var lookup = String((_params$lookup = params.lookup) !== null && _params$lookup !== void 0 ? _params$lookup : '').trim();
+  if (!lookup) throw new Error('加载销售详情需要 lookup');
+  return request.get("/order/sales/".concat(encodeURIComponent(lookup)), _objectSpread({
+    with: (_params$with = params.with) !== null && _params$with !== void 0 ? _params$with : SALES_ORDER_RELATIONS
+  }, params.forceRemote && !lookup.startsWith('LOCAL_') ? {
+    forceRemote: true
+  } : {}), params.transport === 'os-server' ? {
+    osServer: true
+  } : undefined);
+}

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

@@ -1,6 +1,6 @@
 import { Module, ModuleOptions, PisellCore } from '../../types';
 import { BaseModule } from '../../modules/BaseModule';
-import { BaseSalesOrderProduct, BaseSalesOrderProductIdentity, BaseSalesPaymentStatus, BaseSalesUpdateOrderProductQuantityParams, BaseSalesCalculateProductBookingPriceParams, BaseSalesPriceRecalculationContextChange, BaseSalesProductBookingPriceResult, BaseSalesQuotationCustomerScopeInfo, BaseSalesScanCodeResult, BaseSalesCashPaymentConfig, BaseSalesPayCashParams, BaseSalesPayCashResult, BaseSalesCommitPaymentMethodParams, BaseSalesCommitPaymentMethodResult, BaseSalesConfirmWalletPaymentResult } from './types';
+import { BaseSalesOrderProduct, BaseSalesOrderProductIdentity, BaseSalesPaymentStatus, BaseSalesSubmitSalesOrderParams, BaseSalesUpdateOrderProductQuantityParams, BaseSalesCalculateProductBookingPriceParams, BaseSalesPriceRecalculationContextChange, BaseSalesProductBookingPriceResult, BaseSalesQuotationCustomerScopeInfo, BaseSalesScanCodeResult, BaseSalesCashPaymentConfig, BaseSalesPayCashParams, BaseSalesPayCashResult, BaseSalesCommitPaymentMethodParams, BaseSalesCommitPaymentMethodResult, BaseSalesConfirmWalletPaymentResult } from './types';
 import { OrderModule } from '../../modules/Order';
 import { type PickupTimingBookingInput } from '../../modules/Order/pickupTiming';
 import type { PickupTimingAvailability, PickupTimingSelection, PickupTimingValidationResult } from '../../modules/FulfillmentTiming';
@@ -337,13 +337,8 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
         productList?: Record<string, any>[];
         discountList?: Discount[];
     }): Promise<void>;
-    submitScanOrder<T = any>(params?: {
-        payments?: OrderPaymentSource[];
-        paymentStatus?: BaseSalesPaymentStatus;
-        smallTicketDataFlag?: number;
-        confirmPendingVoucherPayments?: boolean;
-        enhancePayload?: SubmitPayloadEnhancer;
-    }): Promise<T>;
+    submitScanOrder<T = any>(params?: BaseSalesSubmitSalesOrderParams): Promise<T>;
+    private buildVirtualSettlementOrderData;
     private buildVirtualSettlementSubmitData;
     /**
      * 提交当前 Sales 订单。
@@ -351,13 +346,7 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
      * PaymentModal 场景通过 smallTicketDataFlag=1 请求 B 端小票数据；
      * payments 会交给 OrderModule 统一映射为 Sales 协议支付项。
      */
-    submitSalesOrder<T = any>(params?: {
-        payments?: OrderPaymentSource[];
-        paymentStatus?: BaseSalesPaymentStatus;
-        smallTicketDataFlag?: number;
-        confirmPendingVoucherPayments?: boolean;
-        enhancePayload?: SubmitPayloadEnhancer;
-    }): Promise<T>;
+    submitSalesOrder<T = any>(params?: BaseSalesSubmitSalesOrderParams): Promise<T>;
     saveSalesOrderDraft<T = any>(params?: {
         platform?: string;
         businessCode?: string;

package/dist/solution/BaseSales/index.js

@@ -1,3 +1,6 @@
+var _excluded = ["payment_status"];
+function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
 function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
 function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
 function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
@@ -3918,92 +3921,91 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
       }
       return submitScanOrder;
     }()
+  }, {
+    key: "buildVirtualSettlementOrderData",
+    value: function buildVirtualSettlementOrderData() {
+      var _tempOrder$metadata$c, _tempOrder$metadata2;
+      if (!this.store.order) return null;
+      var tempOrder = this.store.order.getTempOrder();
+      if (!this.isActiveVirtualSettlementOrder(tempOrder)) return null;
+      var snapshot = getTempOrderSettlementSnapshot(tempOrder);
+      var currencyProductId = Number((_tempOrder$metadata$c = tempOrder === null || tempOrder === void 0 || (_tempOrder$metadata2 = tempOrder.metadata) === null || _tempOrder$metadata2 === void 0 || (_tempOrder$metadata2 = _tempOrder$metadata2.currency_settlement_config) === null || _tempOrder$metadata2 === void 0 || (_tempOrder$metadata2 = _tempOrder$metadata2.settlement_ids) === null || _tempOrder$metadata2 === void 0 ? void 0 : _tempOrder$metadata2[0]) !== null && _tempOrder$metadata$c !== void 0 ? _tempOrder$metadata$c : snapshot === null || snapshot === void 0 ? void 0 : snapshot.currency_product_id);
+      if (!snapshot || !Number.isFinite(currencyProductId) || currencyProductId <= 0) {
+        throw new Error('Virtual currency settlement configuration is invalid.');
+      }
+      return {
+        snapshot: snapshot,
+        currencyProductId: currencyProductId,
+        currencyCode: String((tempOrder === null || tempOrder === void 0 ? void 0 : tempOrder.currency_code) || ''),
+        currencySymbol: String((tempOrder === null || tempOrder === void 0 ? void 0 : tempOrder.currency_symbol) || ''),
+        currencyFormat: String((tempOrder === null || tempOrder === void 0 ? void 0 : tempOrder.currency_format) || 'symbol_first')
+      };
+    }
   }, {
     key: "buildVirtualSettlementSubmitData",
     value: function () {
       var _buildVirtualSettlementSubmitData = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee33() {
-        var _tempOrder$metadata$c, _tempOrder$metadata2;
-        var tempOrder, snapshot, currencyProductId, summary, amount, customerId, asset, currencyCode, currencySymbol, currencyFormat, balance, amountText, paymentNumber, payment, _paymentMethod$custom, paymentMethods, paymentMethod;
+        var settlement, tempOrder, currencyProductId, summary, amount, customerId, asset, balance, amountText, paymentNumber, payment, _paymentMethod$custom, paymentMethods, paymentMethod;
         return _regeneratorRuntime().wrap(function _callee33$(_context33) {
           while (1) switch (_context33.prev = _context33.next) {
             case 0:
-              if (this.store.order) {
-                _context33.next = 2;
+              settlement = this.buildVirtualSettlementOrderData();
+              if (!(!settlement || !this.store.order)) {
+                _context33.next = 3;
                 break;
               }
               return _context33.abrupt("return", null);
-            case 2:
+            case 3:
               tempOrder = this.store.order.getTempOrder();
-              if (this.isActiveVirtualSettlementOrder(tempOrder)) {
-                _context33.next = 5;
-                break;
-              }
-              return _context33.abrupt("return", null);
-            case 5:
-              snapshot = getTempOrderSettlementSnapshot(tempOrder);
-              currencyProductId = Number((_tempOrder$metadata$c = tempOrder === null || tempOrder === void 0 || (_tempOrder$metadata2 = tempOrder.metadata) === null || _tempOrder$metadata2 === void 0 || (_tempOrder$metadata2 = _tempOrder$metadata2.currency_settlement_config) === null || _tempOrder$metadata2 === void 0 || (_tempOrder$metadata2 = _tempOrder$metadata2.settlement_ids) === null || _tempOrder$metadata2 === void 0 ? void 0 : _tempOrder$metadata2[0]) !== null && _tempOrder$metadata$c !== void 0 ? _tempOrder$metadata$c : snapshot === null || snapshot === void 0 ? void 0 : snapshot.currency_product_id);
-              if (!(!snapshot || !Number.isFinite(currencyProductId) || currencyProductId <= 0)) {
-                _context33.next = 9;
-                break;
-              }
-              throw new Error('Virtual currency settlement configuration is invalid.');
-            case 9:
-              _context33.next = 11;
+              currencyProductId = settlement.currencyProductId;
+              _context33.next = 7;
               return this.store.order.recalculateSummary({
                 createIfMissing: true
               });
-            case 11:
+            case 7:
               summary = _context33.sent;
               amount = new Decimal((summary === null || summary === void 0 ? void 0 : summary.total_amount) || 0).toDecimalPlaces(2);
               customerId = Number((tempOrder === null || tempOrder === void 0 ? void 0 : tempOrder.customer_id) || 0);
               if (!(amount.gt(0) && customerId > 0 && customerId !== 1)) {
-                _context33.next = 17;
+                _context33.next = 13;
                 break;
               }
-              _context33.next = 17;
+              _context33.next = 13;
               return this.store.order.loadDiscountConfig({
                 customerId: customerId,
                 action: tempOrder !== null && tempOrder !== void 0 && tempOrder.order_id ? 'edit' : 'create',
                 orderId: Number(tempOrder === null || tempOrder === void 0 ? void 0 : tempOrder.order_id) || undefined,
                 apply: false
               });
-            case 17:
+            case 13:
               asset = this.store.order.getVirtualCurrencyList().find(function (item) {
                 return Number(item === null || item === void 0 ? void 0 : item.product_id) === currencyProductId;
               });
-              currencyCode = String((tempOrder === null || tempOrder === void 0 ? void 0 : tempOrder.currency_code) || '');
-              currencySymbol = String((tempOrder === null || tempOrder === void 0 ? void 0 : tempOrder.currency_symbol) || '');
-              currencyFormat = String((tempOrder === null || tempOrder === void 0 ? void 0 : tempOrder.currency_format) || 'symbol_first');
               if (!amount.lte(0)) {
-                _context33.next = 23;
+                _context33.next = 16;
                 break;
               }
-              return _context33.abrupt("return", {
-                payments: [],
-                snapshot: snapshot,
-                currencyProductId: currencyProductId,
-                currencyCode: currencyCode,
-                currencySymbol: currencySymbol,
-                currencyFormat: currencyFormat
-              });
-            case 23:
+              return _context33.abrupt("return", _objectSpread(_objectSpread({}, settlement), {}, {
+                payments: []
+              }));
+            case 16:
               if (asset) {
-                _context33.next = 25;
+                _context33.next = 18;
                 break;
               }
               throw new Error('No matching virtual currency card is available.');
-            case 25:
+            case 18:
               balance = new Decimal(asset.balance || 0);
               if (!balance.lt(amount)) {
-                _context33.next = 28;
+                _context33.next = 21;
                 break;
               }
               throw new Error('Insufficient virtual currency balance.');
-            case 28:
+            case 21:
               amountText = amount.toFixed(2);
               paymentNumber = "LOCAL_".concat(createUuidV4());
               if (!this.store.order.isOnlineStorePlatform()) {
-                _context33.next = 34;
+                _context33.next = 27;
                 break;
               }
               payment = {
@@ -4020,22 +4022,22 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
                 },
                 wallet_pass_use_value: amountText
               };
-              _context33.next = 41;
+              _context33.next = 34;
               break;
-            case 34:
-              _context33.next = 36;
+            case 27:
+              _context33.next = 29;
               return this.getPaymentMethodsAsync();
-            case 36:
+            case 29:
               paymentMethods = _context33.sent;
               paymentMethod = paymentMethods.find(function (method) {
                 return String(method.code || '').toUpperCase() === 'PRODUCTVOUCHER';
               });
               if (paymentMethod) {
-                _context33.next = 40;
+                _context33.next = 33;
                 break;
               }
               throw new Error('PRODUCTVOUCHER payment method is unavailable.');
-            case 40:
+            case 33:
               payment = {
                 payment_number: paymentNumber,
                 amount: amountText,
@@ -4054,16 +4056,11 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
                 wallet_pass_use_value: amountText,
                 metadata: {}
               };
-            case 41:
-              return _context33.abrupt("return", {
-                payments: [payment],
-                snapshot: snapshot,
-                currencyProductId: currencyProductId,
-                currencyCode: currencyCode,
-                currencySymbol: currencySymbol,
-                currencyFormat: currencyFormat
-              });
-            case 42:
+            case 34:
+              return _context33.abrupt("return", _objectSpread(_objectSpread({}, settlement), {}, {
+                payments: [payment]
+              }));
+            case 35:
             case "end":
               return _context33.stop();
           }
@@ -4085,7 +4082,7 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
     value: (function () {
       var _submitSalesOrder = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee34(params) {
         var _params$smallTicketDa, _this$otherParams18, _this$otherParams19, _this$otherParams20, _this$otherParams21;
-        var virtualSettlement, inferredPaymentStatus, smallTicketDataFlag, virtualSettlementEnhancePayload, enhancePayload, submitParams;
+        var isDeferredPayment, virtualPaymentSettlement, virtualSettlement, inferredPaymentStatus, smallTicketDataFlag, virtualSettlementEnhancePayload, configuredEnhancePayload, enhancePayload, submitParams;
         return _regeneratorRuntime().wrap(function _callee34$(_context34) {
           while (1) switch (_context34.prev = _context34.next) {
             case 0:
@@ -4104,12 +4101,23 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
                 freeze: true
               });
             case 5:
-              _context34.next = 7;
+              isDeferredPayment = (params === null || params === void 0 ? void 0 : params.paymentExecution) === 'deferred';
+              if (!isDeferredPayment) {
+                _context34.next = 10;
+                break;
+              }
+              _context34.t0 = null;
+              _context34.next = 13;
+              break;
+            case 10:
+              _context34.next = 12;
               return this.buildVirtualSettlementSubmitData();
-            case 7:
-              virtualSettlement = _context34.sent;
-              // this.store.order.persistTempOrder();
-              inferredPaymentStatus = this.getSubmitPaymentStatus(params === null || params === void 0 ? void 0 : params.paymentStatus);
+            case 12:
+              _context34.t0 = _context34.sent;
+            case 13:
+              virtualPaymentSettlement = _context34.t0;
+              virtualSettlement = isDeferredPayment ? this.buildVirtualSettlementOrderData() : virtualPaymentSettlement; // this.store.order.persistTempOrder();
+              inferredPaymentStatus = isDeferredPayment ? undefined : this.getSubmitPaymentStatus(params === null || params === void 0 ? void 0 : params.paymentStatus);
               smallTicketDataFlag = (_params$smallTicketDa = params === null || params === void 0 ? void 0 : params.smallTicketDataFlag) !== null && _params$smallTicketDa !== void 0 ? _params$smallTicketDa : this.getDefaultCheckoutSmallTicketDataFlag();
               virtualSettlementEnhancePayload = virtualSettlement ? function (payload, ctx) {
                 var _callerPayload$metada, _currencySettlementCo;
@@ -4128,7 +4136,16 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
                   currency_format: virtualSettlement.currencyFormat
                 });
               } : params === null || params === void 0 ? void 0 : params.enhancePayload;
-              enhancePayload = this.buildSubmitPayloadEnhancerWithOpenDataConfig(virtualSettlementEnhancePayload);
+              configuredEnhancePayload = this.buildSubmitPayloadEnhancerWithOpenDataConfig(virtualSettlementEnhancePayload); // Apply this last so neither a stale draft status nor a caller enhancer can
+              // turn deferred submission into payment. The live wallet selection is untouched.
+              enhancePayload = isDeferredPayment ? function (payload, ctx) {
+                var enhancedPayload = configuredEnhancePayload ? configuredEnhancePayload(payload, ctx) : payload;
+                var _paymentStatus = enhancedPayload.payment_status,
+                  orderPayload = _objectWithoutProperties(enhancedPayload, _excluded);
+                return _objectSpread(_objectSpread({}, orderPayload), {}, {
+                  payments: []
+                });
+              } : configuredEnhancePayload;
               submitParams = _objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({
                 cacheId: this.cacheId,
                 platform: (_this$otherParams18 = this.otherParams) === null || _this$otherParams18 === void 0 ? void 0 : _this$otherParams18.platform,
@@ -4136,15 +4153,17 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
                 channel: this.getSubmitOrderSalesChannel(),
                 type: (_this$otherParams21 = this.otherParams) === null || _this$otherParams21 === void 0 ? void 0 : _this$otherParams21.type,
                 request_unique_idempotency_token: this.store.order.generateIdempotencyToken()
-              }, virtualSettlement ? {
-                payments: virtualSettlement.payments
+              }, isDeferredPayment ? {
+                payments: []
+              } : virtualPaymentSettlement ? {
+                payments: virtualPaymentSettlement.payments
               } : (params === null || params === void 0 ? void 0 : params.payments) !== undefined ? {
                 payments: params.payments
               } : {}), inferredPaymentStatus !== undefined ? {
                 paymentStatus: inferredPaymentStatus
               } : {}), smallTicketDataFlag !== undefined ? {
                 smallTicketDataFlag: smallTicketDataFlag
-              } : {}), virtualSettlement ? {
+              } : {}), isDeferredPayment || virtualSettlement ? {
                 confirmPendingVoucherPayments: false
               } : (params === null || params === void 0 ? void 0 : params.confirmPendingVoucherPayments) !== undefined ? {
                 confirmPendingVoucherPayments: params.confirmPendingVoucherPayments
@@ -4152,7 +4171,7 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
                 enhancePayload: enhancePayload
               } : {});
               return _context34.abrupt("return", this.shouldUseCheckoutSyncTask() ? this.store.order.submitTempOrder(submitParams) : this.store.order.submitTempOrderAsync(submitParams));
-            case 14:
+            case 22:
             case "end":
               return _context34.stop();
           }
@@ -6460,20 +6479,33 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
               }
               throw new Error('order 模块未初始化');
             case 3:
-              _context62.next = 5;
-              return this.store.order.addProductToOrder(product, booking, options);
-            case 5:
-              products = _context62.sent;
-              return _context62.abrupt("return", products);
+              if (!(options === undefined)) {
+                _context62.next = 9;
+                break;
+              }
+              _context62.next = 6;
+              return this.store.order.addProductToOrder(product, booking);
+            case 6:
+              _context62.t0 = _context62.sent;
+              _context62.next = 12;
+              break;
             case 9:
-              _context62.prev = 9;
-              _context62.t0 = _context62["catch"](0);
-              throw _context62.t0;
+              _context62.next = 11;
+              return this.store.order.addProductToOrder(product, booking, options);
+            case 11:
+              _context62.t0 = _context62.sent;
             case 12:
+              products = _context62.t0;
+              return _context62.abrupt("return", products);
+            case 16:
+              _context62.prev = 16;
+              _context62.t1 = _context62["catch"](0);
+              throw _context62.t1;
+            case 19:
             case "end":
               return _context62.stop();
           }
-        }, _callee62, this, [[0, 9]]);
+        }, _callee62, this, [[0, 16]]);
       }));
       function addProductToOrder(_x51, _x52, _x53) {
         return _addProductToOrder.apply(this, arguments);
@@ -6664,19 +6696,32 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
               }
               throw new Error('order 模块未初始化');
             case 3:
-              _context67.next = 5;
+              if (!(options === undefined)) {
+                _context67.next = 9;
+                break;
+              }
+              _context67.next = 6;
+              return this.store.order.removeProductsFromOrder(identities);
+            case 6:
+              _context67.t0 = _context67.sent;
+              _context67.next = 12;
+              break;
+            case 9:
+              _context67.next = 11;
               return this.store.order.removeProductsFromOrder(identities, options);
-            case 5:
-              return _context67.abrupt("return", _context67.sent);
-            case 8:
-              _context67.prev = 8;
-              _context67.t0 = _context67["catch"](0);
-              throw _context67.t0;
             case 11:
+              _context67.t0 = _context67.sent;
+            case 12:
+              return _context67.abrupt("return", _context67.t0);
+            case 15:
+              _context67.prev = 15;
+              _context67.t1 = _context67["catch"](0);
+              throw _context67.t1;
+            case 18:
             case "end":
               return _context67.stop();
           }
-        }, _callee67, this, [[0, 8]]);
+        }, _callee67, this, [[0, 15]]);
       }));
       function removeProductsFromOrder(_x59, _x60) {
         return _removeProductsFromOrder.apply(this, arguments);

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

@@ -4,6 +4,8 @@ import type { ScanOrderLogInput as BaseSalesLogInput, ScanOrderLoggerProviderCon
 import type { QuantityCheckResult, QuantityLimitResult } from '../../model/strategy/adapter/itemRule';
 import type { QuotationCustomerScopeInfo } from '../../modules/Quotation/types';
 import type { PaymentMethod } from '../../modules/Payment/types';
+import type { OrderPaymentSource } from '../../modules/Order/types';
+import type { SubmitPayloadEnhancer } from '../../modules/Order/utils';
 /**
  * BaseSales 流程 hook 后缀。
  * 完整事件名应由当前模块名动态拼接，避免多个实例共享固定事件 key。
@@ -23,6 +25,15 @@ export type BaseSalesHookName = typeof BaseSalesHookNames[keyof typeof BaseSales
 export declare function createBaseSalesHook(moduleName: string, hookName: BaseSalesHookName): string;
 export type BaseSalesStatus = 'idle' | 'initializing' | 'ready' | 'error';
 export type BaseSalesPaymentStatus = 'paid' | 'partially_paid' | 'unpaid' | 'payment_processing' | string;
+export interface BaseSalesSubmitSalesOrderParams {
+    payments?: OrderPaymentSource[];
+    paymentStatus?: BaseSalesPaymentStatus;
+    smallTicketDataFlag?: number;
+    confirmPendingVoucherPayments?: boolean;
+    enhancePayload?: SubmitPayloadEnhancer;
+    /** Create the order without executing payment; payment status comes from the server. */
+    paymentExecution?: 'deferred';
+}
 export interface BaseSalesCashPaymentConfig {
     available: boolean;
     paymentMethod?: PaymentMethod;

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

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

package/dist/solution/BookingTicket/index.js

@@ -2664,7 +2664,7 @@ export var BookingTicketImpl = /*#__PURE__*/function (_BaseSalesImpl) {
     value: (function () {
       var _handleGlobalScanCode = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee32(code, bridge) {
         var _this7 = this;
-        var trimmed, _bridge$onNotify, _bridge$refresh, localSearch, scanCallback, raw, formatted, _bridge$onNotify2, _result7, _bridge$onNotify3;
+        var trimmed, _bridge$onNotify, _bridge$refresh, beforeScanCommit, beforeScanDialog, guardCallback, guardedBridge, localSearch, scanCallback, raw, formatted, _bridge$onNotify2, _result7, _bridge$onNotify3;
         return _regeneratorRuntime().wrap(function _callee32$(_context32) {
           while (1) switch (_context32.prev = _context32.next) {
             case 0:
@@ -2680,20 +2680,45 @@ export var BookingTicketImpl = /*#__PURE__*/function (_BaseSalesImpl) {
               });
             case 4:
               _context32.prev = 4;
+              // Capture before lookup/UI awaits, so a result cannot land in a new cart.
+              // Unscoped POS Order modules return a no-op guard.
+              beforeScanCommit = this.store.order.createCartIntentCommitGuard('add_product');
+              beforeScanDialog = this.store.order.createCartIntentCommitGuard('add_product');
+              guardCallback = function guardCallback(callback) {
+                return callback ? function () {
+                  beforeScanCommit();
+                  return callback.apply(void 0, arguments);
+                } : undefined;
+              };
+              guardedBridge = bridge ? _objectSpread(_objectSpread({}, bridge), {}, {
+                confirmDetail: guardCallback(bridge.confirmDetail),
+                confirmBookingEdit: guardCallback(bridge.confirmBookingEdit),
+                applyPromotionCode: guardCallback(bridge.applyPromotionCode),
+                requestCustomerSwitch: guardCallback(bridge.requestCustomerSwitch),
+                openOrder: guardCallback(bridge.openOrder),
+                openProductDetail: bridge.openProductDetail ? function (payload) {
+                  beforeScanDialog();
+                  return bridge.openProductDetail(payload);
+                } : undefined,
+                openBookingEdit: bridge.openBookingEdit ? function (payload) {
+                  beforeScanDialog();
+                  return bridge.openBookingEdit(payload);
+                } : undefined
+              }) : undefined;
               localSearch = function localSearch(v) {
                 return _this7.store.products.findProductsByCodeOrBarcode(v);
               };
               scanCallback = handleGlobalScan(this.request, localSearch, this.getSubmitOrderSalesChannel());
-              _context32.next = 9;
+              _context32.next = 13;
               return scanCallback({
                 type: 'nativeScanner',
                 value: trimmed
               });
-            case 9:
+            case 13:
               raw = _context32.sent;
               formatted = formatGlobalScanResult(raw, trimmed);
               if (formatted) {
-                _context32.next = 14;
+                _context32.next = 18;
                 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');
@@ -2701,11 +2726,12 @@ export var BookingTicketImpl = /*#__PURE__*/function (_BaseSalesImpl) {
                 status: 'failed',
                 reason: 'not_found'
               });
-            case 14:
-              _context32.next = 16;
+            case 18:
+              _context32.next = 20;
               return applyGlobalScan({
                 setOrderCustomer: function setOrderCustomer(customer) {
-                  return _this7.setOrderCustomer(customer);
+                  beforeScanCommit();
+                  _this7.setOrderCustomer(customer);
                 },
                 getOrderCustomerSnapshot: function getOrderCustomerSnapshot() {
                   return _this7.getOrderCustomerSnapshot();
@@ -2730,21 +2756,23 @@ export var BookingTicketImpl = /*#__PURE__*/function (_BaseSalesImpl) {
                   return _this7.transformDetailToProductAndBooking(input);
                 },
                 addProductToOrder: function addProductToOrder(product, booking) {
+                  beforeScanCommit();
                   return _this7.addProductToOrder(product, booking);
                 },
                 refreshWalletAssets: function refreshWalletAssets(params) {
                   return _this7.refreshWalletAssets(params);
                 },
                 scanWalletAsset: function scanWalletAsset(scanCode) {
+                  beforeScanCommit();
                   return _this7.scanWalletAsset(scanCode);
                 }
-              }, formatted, bridge);
-            case 16:
+              }, formatted, guardedBridge);
+            case 20:
               _result7 = _context32.sent;
               bridge === null || bridge === void 0 || (_bridge$refresh = bridge.refresh) === null || _bridge$refresh === void 0 || _bridge$refresh.call(bridge);
               return _context32.abrupt("return", _result7);
-            case 21:
-              _context32.prev = 21;
+            case 25:
+              _context32.prev = 25;
               _context32.t0 = _context32["catch"](4);
               console.error('[BookingTicket] handleGlobalScanCode failed', _context32.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');
@@ -2752,11 +2780,11 @@ export var BookingTicketImpl = /*#__PURE__*/function (_BaseSalesImpl) {
                 status: 'failed',
                 reason: 'not_found'
               });
-            case 26:
+            case 30:
             case "end":
               return _context32.stop();
           }
-        }, _callee32, this, [[4, 21]]);
+        }, _callee32, this, [[4, 25]]);
       }));
       function handleGlobalScanCode(_x21, _x22) {
         return _handleGlobalScanCode.apply(this, arguments);

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

@@ -0,0 +1,56 @@
+import type { Module, ModuleOptions, PisellCore } from '../../types';
+import { BaseModule } from '../../modules/BaseModule';
+import type { InvoiceLayoutConfig } from '../../modules/OpenData';
+import { type SmallTicketData } from '../../shared/receipt/small-ticket';
+export interface OrderInvoicePreviewInput {
+    orderId: string | number;
+    tenantId: string | number;
+    shopId: string | number;
+    /** Changes on login/logout, without exposing credentials in state or cache keys. */
+    identity: string;
+    businessCode: string;
+    channel: string;
+    locale: string;
+    sourceRevision: string;
+    shop?: Record<string, any>;
+}
+export interface OrderInvoicePreviewResult {
+    identity: string;
+    sourceRevision: string;
+    generatedAt: string;
+    locale: string;
+    orderId: string | number;
+    source: Record<string, any>;
+    shop: Record<string, any>;
+    layout: InvoiceLayoutConfig;
+    smallTicketData: SmallTicketData;
+}
+export interface OrderInvoicePreviewState {
+    status: 'idle' | 'loading' | 'ready' | 'error';
+    result: OrderInvoicePreviewResult | null;
+    error: string | null;
+}
+/** Read-only, page-owned solution. No Order, Schedule, quotation or payment modules. */
+export declare class OrderInvoicePreviewImpl extends BaseModule implements Module {
+    isSolution: boolean;
+    private request;
+    private state;
+    private listeners;
+    private generation;
+    private disposed;
+    private input?;
+    private activeKey;
+    private pending?;
+    private snapshotCache;
+    constructor(name?: string);
+    initialize(core: PisellCore, _options: ModuleOptions): void;
+    getState: () => OrderInvoicePreviewState;
+    subscribe: (listener: () => void) => (() => void);
+    private publish;
+    private getScope;
+    private loadContext;
+    private loadSource;
+    prepare(input: OrderInvoicePreviewInput): Promise<OrderInvoicePreviewResult>;
+    retry(): Promise<OrderInvoicePreviewResult>;
+    destroy(): void;
+}