@pisell/pisellos 0.10.54 → 0.10.56

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

@@ -517,7 +517,15 @@ export type OrderProductMergeDecisionResult = boolean | {
     reason?: string;
     [key: string]: any;
 };
+export interface OrderCartIntentCommitContext {
+    action: 'add_product' | 'update_product' | 'increase_quantity' | 'scan_promotion';
+    tempOrder: OrderTempOrder | null;
+}
 export interface OrderHooksConfig {
+    /** Optional customer-order guard; called synchronously before the first cart write. */
+    beforeCartIntentCommit?: (context: OrderCartIntentCommitContext) => void;
+    /** Captures tenant/business runtime identity for asynchronous cart intents. */
+    getCartIntentScope?: () => unknown;
     onBeforeMergeProductToOrder?: (context: OrderProductMergeDecisionContext) => OrderProductMergeDecisionResult | Promise<OrderProductMergeDecisionResult>;
 }
 /**

package/dist/plugins/request.d.ts

@@ -56,6 +56,10 @@ export interface CacheProps {
  * 请求配置
  */
 export interface RequestOptions {
+    /** Customer-only, credential-free GET /open/document/{id} on picoding. */
+    publicInvoiceDocument?: boolean;
+    /** Route through the host's configured picoding environment. */
+    pisell2?: boolean;
     /** Let the caller handle read-only preview failures without host navigation/toasts. */
     manualErrorHandling?: boolean;
     skipErrorHandler?: boolean;

package/dist/shared/receipt/loadCustomerInvoiceLayout.d.ts

@@ -0,0 +1,22 @@
+import type { RequestPlugin } from '../../plugins/request';
+import { type InvoiceLayoutConfig } from '../../modules/OpenData';
+export interface PublicInvoiceDocumentResponse {
+    status: boolean;
+    code: number;
+    message?: string;
+    data: {
+        id: number;
+        data?: {
+            template_settings?: unknown;
+        } | null;
+    } | null;
+}
+interface TemplateScope {
+    tenantId: string | number;
+    shopId: string | number;
+    identity: string;
+    businessCode: string;
+    channel: string;
+}
+export declare function loadCustomerInvoiceLayout(request: RequestPlugin, scope: TemplateScope): Promise<InvoiceLayoutConfig>;
+export {};

package/dist/shared/receipt/loadCustomerInvoiceLayout.js

@@ -0,0 +1,142 @@
+function _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */ _regeneratorRuntime = function _regeneratorRuntime() { return e; }; var t, e = {}, r = Object.prototype, n = r.hasOwnProperty, o = Object.defineProperty || function (t, e, r) { t[e] = r.value; }, i = "function" == typeof Symbol ? Symbol : {}, a = i.iterator || "@@iterator", c = i.asyncIterator || "@@asyncIterator", u = i.toStringTag || "@@toStringTag"; function define(t, e, r) { return Object.defineProperty(t, e, { value: r, enumerable: !0, configurable: !0, writable: !0 }), t[e]; } try { define({}, ""); } catch (t) { define = function define(t, e, r) { return t[e] = r; }; } function wrap(t, e, r, n) { var i = e && e.prototype instanceof Generator ? e : Generator, a = Object.create(i.prototype), c = new Context(n || []); return o(a, "_invoke", { value: makeInvokeMethod(t, r, c) }), a; } function tryCatch(t, e, r) { try { return { type: "normal", arg: t.call(e, r) }; } catch (t) { return { type: "throw", arg: t }; } } e.wrap = wrap; var h = "suspendedStart", l = "suspendedYield", f = "executing", s = "completed", y = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var p = {}; define(p, a, function () { return this; }); var d = Object.getPrototypeOf, v = d && d(d(values([]))); v && v !== r && n.call(v, a) && (p = v); var g = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(p); function defineIteratorMethods(t) { ["next", "throw", "return"].forEach(function (e) { define(t, e, function (t) { return this._invoke(e, t); }); }); } function AsyncIterator(t, e) { function invoke(r, o, i, a) { var c = tryCatch(t[r], t, o); if ("throw" !== c.type) { var u = c.arg, h = u.value; return h && "object" == _typeof(h) && n.call(h, "__await") ? e.resolve(h.__await).then(function (t) { invoke("next", t, i, a); }, function (t) { invoke("throw", t, i, a); }) : e.resolve(h).then(function (t) { u.value = t, i(u); }, function (t) { return invoke("throw", t, i, a); }); } a(c.arg); } var r; o(this, "_invoke", { value: function value(t, n) { function callInvokeWithMethodAndArg() { return new e(function (e, r) { invoke(t, n, e, r); }); } return r = r ? r.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(e, r, n) { var o = h; return function (i, a) { if (o === f) throw new Error("Generator is already running"); if (o === s) { if ("throw" === i) throw a; return { value: t, done: !0 }; } for (n.method = i, n.arg = a;;) { var c = n.delegate; if (c) { var u = maybeInvokeDelegate(c, n); if (u) { if (u === y) continue; return u; } } if ("next" === n.method) n.sent = n._sent = n.arg;else if ("throw" === n.method) { if (o === h) throw o = s, n.arg; n.dispatchException(n.arg); } else "return" === n.method && n.abrupt("return", n.arg); o = f; var p = tryCatch(e, r, n); if ("normal" === p.type) { if (o = n.done ? s : l, p.arg === y) continue; return { value: p.arg, done: n.done }; } "throw" === p.type && (o = s, n.method = "throw", n.arg = p.arg); } }; } function maybeInvokeDelegate(e, r) { var n = r.method, o = e.iterator[n]; if (o === t) return r.delegate = null, "throw" === n && e.iterator.return && (r.method = "return", r.arg = t, maybeInvokeDelegate(e, r), "throw" === r.method) || "return" !== n && (r.method = "throw", r.arg = new TypeError("The iterator does not provide a '" + n + "' method")), y; var i = tryCatch(o, e.iterator, r.arg); if ("throw" === i.type) return r.method = "throw", r.arg = i.arg, r.delegate = null, y; var a = i.arg; return a ? a.done ? (r[e.resultName] = a.value, r.next = e.nextLoc, "return" !== r.method && (r.method = "next", r.arg = t), r.delegate = null, y) : a : (r.method = "throw", r.arg = new TypeError("iterator result is not an object"), r.delegate = null, y); } function pushTryEntry(t) { var e = { tryLoc: t[0] }; 1 in t && (e.catchLoc = t[1]), 2 in t && (e.finallyLoc = t[2], e.afterLoc = t[3]), this.tryEntries.push(e); } function resetTryEntry(t) { var e = t.completion || {}; e.type = "normal", delete e.arg, t.completion = e; } function Context(t) { this.tryEntries = [{ tryLoc: "root" }], t.forEach(pushTryEntry, this), this.reset(!0); } function values(e) { if (e || "" === e) { var r = e[a]; if (r) return r.call(e); if ("function" == typeof e.next) return e; if (!isNaN(e.length)) { var o = -1, i = function next() { for (; ++o < e.length;) if (n.call(e, o)) return next.value = e[o], next.done = !1, next; return next.value = t, next.done = !0, next; }; return i.next = i; } } throw new TypeError(_typeof(e) + " is not iterable"); } return GeneratorFunction.prototype = GeneratorFunctionPrototype, o(g, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), o(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, u, "GeneratorFunction"), e.isGeneratorFunction = function (t) { var e = "function" == typeof t && t.constructor; return !!e && (e === GeneratorFunction || "GeneratorFunction" === (e.displayName || e.name)); }, e.mark = function (t) { return Object.setPrototypeOf ? Object.setPrototypeOf(t, GeneratorFunctionPrototype) : (t.__proto__ = GeneratorFunctionPrototype, define(t, u, "GeneratorFunction")), t.prototype = Object.create(g), t; }, e.awrap = function (t) { return { __await: t }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, c, function () { return this; }), e.AsyncIterator = AsyncIterator, e.async = function (t, r, n, o, i) { void 0 === i && (i = Promise); var a = new AsyncIterator(wrap(t, r, n, o), i); return e.isGeneratorFunction(r) ? a : a.next().then(function (t) { return t.done ? t.value : a.next(); }); }, defineIteratorMethods(g), define(g, u, "Generator"), define(g, a, function () { return this; }), define(g, "toString", function () { return "[object Generator]"; }), e.keys = function (t) { var e = Object(t), r = []; for (var n in e) r.push(n); return r.reverse(), function next() { for (; r.length;) { var t = r.pop(); if (t in e) return next.value = t, next.done = !1, next; } return next.done = !0, next; }; }, e.values = values, Context.prototype = { constructor: Context, reset: function reset(e) { if (this.prev = 0, this.next = 0, this.sent = this._sent = t, this.done = !1, this.delegate = null, this.method = "next", this.arg = t, this.tryEntries.forEach(resetTryEntry), !e) for (var r in this) "t" === r.charAt(0) && n.call(this, r) && !isNaN(+r.slice(1)) && (this[r] = t); }, stop: function stop() { this.done = !0; var t = this.tryEntries[0].completion; if ("throw" === t.type) throw t.arg; return this.rval; }, dispatchException: function dispatchException(e) { if (this.done) throw e; var r = this; function handle(n, o) { return a.type = "throw", a.arg = e, r.next = n, o && (r.method = "next", r.arg = t), !!o; } for (var o = this.tryEntries.length - 1; o >= 0; --o) { var i = this.tryEntries[o], a = i.completion; if ("root" === i.tryLoc) return handle("end"); if (i.tryLoc <= this.prev) { var c = n.call(i, "catchLoc"), u = n.call(i, "finallyLoc"); if (c && u) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } else if (c) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); } else { if (!u) throw new Error("try statement without catch or finally"); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } } } }, abrupt: function abrupt(t, e) { for (var r = this.tryEntries.length - 1; r >= 0; --r) { var o = this.tryEntries[r]; if (o.tryLoc <= this.prev && n.call(o, "finallyLoc") && this.prev < o.finallyLoc) { var i = o; break; } } i && ("break" === t || "continue" === t) && i.tryLoc <= e && e <= i.finallyLoc && (i = null); var a = i ? i.completion : {}; return a.type = t, a.arg = e, i ? (this.method = "next", this.next = i.finallyLoc, y) : this.complete(a); }, complete: function complete(t, e) { if ("throw" === t.type) throw t.arg; return "break" === t.type || "continue" === t.type ? this.next = t.arg : "return" === t.type ? (this.rval = this.arg = t.arg, this.method = "return", this.next = "end") : "normal" === t.type && e && (this.next = e), y; }, finish: function finish(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.finallyLoc === t) return this.complete(r.completion, r.afterLoc), resetTryEntry(r), y; } }, catch: function _catch(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.tryLoc === t) { var n = r.completion; if ("throw" === n.type) { var o = n.arg; resetTryEntry(r); } return o; } } throw new Error("illegal catch attempt"); }, delegateYield: function delegateYield(e, r, n) { return this.delegate = { iterator: values(e), resultName: r, nextLoc: n }, "next" === this.method && (this.arg = t), y; } }, e; }
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
+function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
+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); }
+import { getDefaultInvoiceLayoutConfig, normalizeInvoiceLayoutFromTemplateSettings, normalizeInvoiceTemplateSettings, normalizeRawInvoiceTemplateSettings } from "../../modules/OpenData";
+// Page-runtime caches: also retain DEFAULT on failure, without automatic retries.
+var caches = new WeakMap();
+var isRecord = function isRecord(value) {
+  return !!value && _typeof(value) === 'object' && !Array.isArray(value);
+};
+function documentId(value) {
+  if (typeof value !== 'string' && typeof value !== 'number') return null;
+  var text = String(value).trim();
+  if (!/^\d+$/.test(text)) return null;
+  var id = Number(text);
+  return Number.isSafeInteger(id) && id > 0 ? String(id) : null;
+}
+export function loadCustomerInvoiceLayout(request, scope) {
+  var cache = caches.get(request);
+  if (!cache) {
+    cache = {
+      scopes: new Map(),
+      documents: new Map()
+    };
+    caches.set(request, cache);
+  }
+  var target = "".concat(scope.businessCode, "+").concat(scope.channel);
+  var key = JSON.stringify([scope.tenantId, scope.shopId, scope.identity, scope.businessCode, scope.channel]);
+  var cached = cache.scopes.get(key);
+  if (cached) return cached;
+  var id = null;
+  var task = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2() {
+    var response, config, raw, numericLike, docKey, pending, expectedId;
+    return _regeneratorRuntime().wrap(function _callee2$(_context2) {
+      while (1) switch (_context2.prev = _context2.next) {
+        case 0:
+          _context2.next = 2;
+          return request.post("/open/my-pisell/".concat(encodeURIComponent(String(scope.shopId)), "/setting"), {
+            scope: 'board',
+            target: target,
+            section_code: ['documents']
+          }, {
+            pisell2: true,
+            prefix: false,
+            headers: scope.tenantId ? {
+              'Tenant-Id': String(scope.tenantId)
+            } : {},
+            manualErrorHandling: true,
+            skipErrorHandler: true,
+            timeout: 15000
+          });
+        case 2:
+          response = _context2.sent;
+          if (!((response === null || response === void 0 ? void 0 : response.status) !== true || response.code !== 200 || !isRecord(response.data))) {
+            _context2.next = 5;
+            break;
+          }
+          throw new Error((response === null || response === void 0 ? void 0 : response.message) || 'Invoice OpenData is unavailable');
+        case 5:
+          config = response.data;
+          raw = config['documents.invoice_template'];
+          id = documentId(raw);
+          if (id) {
+            _context2.next = 11;
+            break;
+          }
+          // Preserve the existing non-numeric legacy template / invoice_edit contract.
+          numericLike = /^[+-]?(?:\d+\.?\d*|\.\d+)(?:e[+-]?\d+)?$/i;
+          return _context2.abrupt("return", typeof raw === 'string' && raw.trim() && !numericLike.test(raw.trim()) ? normalizeInvoiceLayoutFromTemplateSettings(normalizeInvoiceTemplateSettings(config)) : getDefaultInvoiceLayoutConfig());
+        case 11:
+          docKey = JSON.stringify([key, id]);
+          pending = cache.documents.get(docKey);
+          if (!pending) {
+            expectedId = id;
+            pending = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee() {
+              var result, doc, settings;
+              return _regeneratorRuntime().wrap(function _callee$(_context) {
+                while (1) switch (_context.prev = _context.next) {
+                  case 0:
+                    _context.next = 2;
+                    return request.get("/open/document/".concat(expectedId), {}, {
+                      publicInvoiceDocument: true
+                    });
+                  case 2:
+                    result = _context.sent;
+                    if (!((result === null || result === void 0 ? void 0 : result.status) !== true || result.code !== 200)) {
+                      _context.next = 5;
+                      break;
+                    }
+                    throw new Error((result === null || result === void 0 ? void 0 : result.message) || 'Invoice Document request failed');
+                  case 5:
+                    doc = result.data;
+                    if (!(!doc || documentId(doc.id) !== expectedId)) {
+                      _context.next = 8;
+                      break;
+                    }
+                    throw new Error('Invoice Document is unavailable or its ID does not match');
+                  case 8:
+                    if (!(!isRecord(doc.data) || !isRecord(doc.data.template_settings))) {
+                      _context.next = 10;
+                      break;
+                    }
+                    throw new Error('Invoice Document has no template_settings');
+                  case 10:
+                    settings = normalizeRawInvoiceTemplateSettings(doc.data.template_settings);
+                    if (!(settings.modules.length === 0)) {
+                      _context.next = 13;
+                      break;
+                    }
+                    throw new Error('Invoice Document has no usable template modules');
+                  case 13:
+                    return _context.abrupt("return", normalizeInvoiceLayoutFromTemplateSettings(settings));
+                  case 14:
+                  case "end":
+                    return _context.stop();
+                }
+              }, _callee);
+            }))().catch(function (error) {
+              return fallback(error, target, expectedId);
+            });
+            cache.documents.set(docKey, pending);
+          }
+          return _context2.abrupt("return", pending);
+        case 15:
+        case "end":
+          return _context2.stop();
+      }
+    }, _callee2);
+  }))().catch(function (error) {
+    return fallback(error, target, id);
+  });
+  cache.scopes.set(key, task);
+  return task;
+}
+function fallback(error, target, id) {
+  console.warn('[OrderInvoicePreview] Template unavailable; using DEFAULT', {
+    target: target,
+    documentId: id,
+    message: error instanceof Error ? error.message : 'Template request failed'
+  });
+  return getDefaultInvoiceLayoutConfig();
+}

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;