@pisell/pisellos 0.10.16 → 0.10.17

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

@@ -1,9 +1,9 @@
 import { Module, PisellCore, ModuleOptions } from '../../types';
 import { BaseModule } from '../BaseModule';
 import type { ScheduleModule } from '../Schedule';
-import type { OpenDataConfig, OpenDataFetchParams, OpenDataAvailabilityResult } from './types';
+import type { OpenDataConfig, OpenDataFetchParams, OpenDataAvailabilityResult, InvoiceLayoutConfig, InvoiceTemplateSettings } from './types';
 export * from './types';
-export { computeAvailability } from './utils';
+export { computeAvailability, getDefaultInvoiceLayoutConfig, getDefaultInvoiceTemplateSettings, normalizeInvoiceLayoutConfig, normalizeInvoiceTemplateSettings, normalizeRawInvoiceTemplateSettings, } from './utils';
 export declare class OpenDataModule extends BaseModule implements Module {
     protected defaultName: string;
     protected defaultVersion: string;
@@ -15,6 +15,7 @@ export declare class OpenDataModule extends BaseModule implements Module {
     private openCache;
     private fatherModule;
     private otherParams;
+    private fetchRevision;
     constructor(name?: string, version?: string);
     initialize(core: PisellCore, options: ModuleOptions): Promise<void>;
     /**
@@ -26,6 +27,8 @@ export declare class OpenDataModule extends BaseModule implements Module {
     updateOtherParams(params: Record<string, any>): void;
     fetchOpenData(params: OpenDataFetchParams): Promise<OpenDataConfig>;
     getOpenData(): OpenDataConfig | null;
+    getInvoiceLayoutConfig(): InvoiceLayoutConfig;
+    getInvoiceTemplateSettings(): InvoiceTemplateSettings;
     getLastFetchedAt(): number | null;
     /** 清除内存与 sessionStorage 镜像中的 OpenData，供宿主切店时调用。 */
     clearCache(): void;

package/dist/modules/OpenData/index.js

@@ -16,9 +16,9 @@ function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key i
 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 { BaseModule } from "../BaseModule";
-import { computeAvailability } from "./utils";
+import { computeAvailability, normalizeInvoiceLayoutConfig, normalizeInvoiceTemplateSettings } from "./utils";
 export * from "./types";
-export { computeAvailability } from "./utils";
+export { computeAvailability, getDefaultInvoiceLayoutConfig, getDefaultInvoiceTemplateSettings, normalizeInvoiceLayoutConfig, normalizeInvoiceTemplateSettings, normalizeRawInvoiceTemplateSettings } from "./utils";
 export var OpenDataModule = /*#__PURE__*/function (_BaseModule) {
   _inherits(OpenDataModule, _BaseModule);
   var _super = _createSuper(OpenDataModule);
@@ -36,6 +36,7 @@ export var OpenDataModule = /*#__PURE__*/function (_BaseModule) {
     _defineProperty(_assertThisInitialized(_this), "openCache", false);
     _defineProperty(_assertThisInitialized(_this), "fatherModule", void 0);
     _defineProperty(_assertThisInitialized(_this), "otherParams", {});
+    _defineProperty(_assertThisInitialized(_this), "fetchRevision", 0);
     return _this;
   }
   _createClass(OpenDataModule, [{
@@ -104,22 +105,23 @@ export var OpenDataModule = /*#__PURE__*/function (_BaseModule) {
     value: function () {
       var _fetchOpenData = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2(params) {
         var _this$appPlugin, _this$appPlugin$getDa;
-        var getData, shopId, tenantId, headers, response, data;
+        var fetchRevision, getData, shopId, tenantId, headers, response, data;
         return _regeneratorRuntime().wrap(function _callee2$(_context2) {
           while (1) switch (_context2.prev = _context2.next) {
             case 0:
+              fetchRevision = ++this.fetchRevision;
               getData = (_this$appPlugin = this.appPlugin) === null || _this$appPlugin === void 0 || (_this$appPlugin$getDa = _this$appPlugin.getData) === null || _this$appPlugin$getDa === void 0 ? void 0 : _this$appPlugin$getDa.call(_this$appPlugin);
               shopId = getData === null || getData === void 0 ? void 0 : getData('shop_id');
               if (shopId) {
-                _context2.next = 4;
+                _context2.next = 5;
                 break;
               }
               throw new Error('[OpenDataModule] 无法获取 shop_id');
-            case 4:
+            case 5:
               tenantId = getData === null || getData === void 0 ? void 0 : getData('tenant_id');
               headers = {};
               if (tenantId) headers['Tenant-Id'] = String(tenantId);
-              _context2.next = 9;
+              _context2.next = 10;
               return this.request.post("/open/my-pisell/".concat(shopId, "/setting"), {
                 scope: params.scope,
                 target: params.target,
@@ -130,17 +132,19 @@ export var OpenDataModule = /*#__PURE__*/function (_BaseModule) {
                 prefix: false,
                 headers: headers
               });
-            case 9:
+            case 10:
               response = _context2.sent;
               if (!((response === null || response === void 0 ? void 0 : response.status) === false)) {
-                _context2.next = 12;
+                _context2.next = 13;
                 break;
               }
               throw new Error((response === null || response === void 0 ? void 0 : response.message) || '获取 OpenData 配置失败');
-            case 12:
-              data = (response === null || response === void 0 ? void 0 : response.data) || {};
-              this.store.data = data;
-              this.store.lastFetchedAt = Date.now();
+            case 13:
+              data = (response === null || response === void 0 ? void 0 : response.data) || {}; // clearCache() 或后续请求发生后，旧响应不得复活已失效的 target 配置。
+              if (fetchRevision === this.fetchRevision) {
+                this.store.data = data;
+                this.store.lastFetchedAt = Date.now();
+              }
               return _context2.abrupt("return", data);
             case 16:
             case "end":
@@ -158,6 +162,16 @@ export var OpenDataModule = /*#__PURE__*/function (_BaseModule) {
     value: function getOpenData() {
       return this.store.data;
     }
+  }, {
+    key: "getInvoiceLayoutConfig",
+    value: function getInvoiceLayoutConfig() {
+      return normalizeInvoiceLayoutConfig(this.store.data);
+    }
+  }, {
+    key: "getInvoiceTemplateSettings",
+    value: function getInvoiceTemplateSettings() {
+      return normalizeInvoiceTemplateSettings(this.store.data);
+    }
   }, {
     key: "getLastFetchedAt",
     value: function getLastFetchedAt() {
@@ -169,6 +183,7 @@ export var OpenDataModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "clearCache",
     value: function clearCache() {
+      this.fetchRevision += 1;
       this.store.data = null;
       this.store.lastFetchedAt = null;
     }

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

@@ -8,6 +8,40 @@ export interface MultiLangObject {
     original?: string;
     [key: string]: string | undefined;
 }
+export declare const INVOICE_MODULE_KEYS: readonly ["reference", "brand", "custom_1", "order", "handover", "customer", "line_groups", "settlement", "custom_2", "payment", "card", "total_savings", "custom_3", "barcode"];
+export type InvoiceModuleKey = (typeof INVOICE_MODULE_KEYS)[number];
+/**
+ * Documents Registry 中的 Invoice 模块配置。
+ *
+ * 模块 key、显隐值及模块私有字段均由 Registry/Native 约定，OS 不做枚举收窄或改写。
+ */
+export interface InvoiceTemplateModuleConfig {
+    key: string;
+    is_show?: unknown;
+    [key: string]: unknown;
+}
+export interface InvoiceModuleConfig extends InvoiceTemplateModuleConfig {
+}
+export interface InvoiceLayoutConfig {
+    locale?: string;
+    module: InvoiceModuleConfig[];
+}
+export interface InvoiceTemplateSettings {
+    template: string;
+    language: Record<string, number>;
+    modules: InvoiceTemplateModuleConfig[];
+    [key: string]: unknown;
+}
+export type RawInvoiceEditConfig = string | {
+    language?: unknown;
+    modules?: unknown;
+    [key: string]: unknown;
+};
+export type RawInvoiceLayoutConfig = string | {
+    locale?: unknown;
+    module?: unknown[];
+    [key: string]: unknown;
+};
 export interface OpenDataConfig {
     'basic.enable'?: boolean;
     'basic.code'?: string | null;
@@ -45,6 +79,14 @@ export interface OpenDataConfig {
         label: string;
         value: number;
     }>;
+    'documents.invoice_template'?: string;
+    'documents.invoice_edit'?: RawInvoiceEditConfig;
+    /** @deprecated 仅保留旧调用方的类型兼容，Invoice 读取逻辑不再消费该字段。 */
+    'documents.invoice'?: RawInvoiceLayoutConfig;
+    /** @deprecated Invoice 读取逻辑只消费扁平的 documents.invoice_* 字段。 */
+    documents?: {
+        invoice?: RawInvoiceLayoutConfig;
+    };
     [key: string]: any;
 }
 export interface OpenDataState {

package/dist/modules/OpenData/types.js

@@ -1 +1,7 @@
-export {};
+export var INVOICE_MODULE_KEYS = ['reference', 'brand', 'custom_1', 'order', 'handover', 'customer', 'line_groups', 'settlement', 'custom_2', 'payment', 'card', 'total_savings', 'custom_3', 'barcode'];
+
+/**
+ * Documents Registry 中的 Invoice 模块配置。
+ *
+ * 模块 key、显隐值及模块私有字段均由 Registry/Native 约定，OS 不做枚举收窄或改写。
+ */

package/dist/modules/OpenData/utils.d.ts

@@ -1,2 +1,16 @@
-import type { OpenDataAvailabilityResult, ComputeAvailabilityParams } from './types';
+import type { OpenDataConfig, OpenDataAvailabilityResult, ComputeAvailabilityParams, InvoiceLayoutConfig, InvoiceTemplateSettings } from './types';
+export declare function getDefaultInvoiceLayoutConfig(): InvoiceLayoutConfig;
+export declare function getDefaultInvoiceTemplateSettings(): InvoiceTemplateSettings;
+/**
+ * 规范化已经提取出的公开 template_settings 值，供打印入口复用。
+ */
+export declare function normalizeRawInvoiceTemplateSettings(value: unknown): InvoiceTemplateSettings;
+/**
+ * 从 OpenData Documents section 的两个扁平字段中构造 Native Invoice 配置。
+ */
+export declare function normalizeInvoiceTemplateSettings(config: OpenDataConfig | null | undefined): InvoiceTemplateSettings;
+/**
+ * 将 invoice_edit.modules 原样投影为 Web Invoice 使用的 module 字段。
+ */
+export declare function normalizeInvoiceLayoutConfig(config: OpenDataConfig | null | undefined): InvoiceLayoutConfig;
 export declare function computeAvailability(params: ComputeAvailabilityParams): OpenDataAvailabilityResult;

package/dist/modules/OpenData/utils.js

@@ -1,6 +1,91 @@
+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); }
 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 dayjs from 'dayjs';
 import { getDateIsInSchedule } from "../Schedule/getDateIsInSchedule";
+function isRecord(value) {
+  return !!value && _typeof(value) === 'object' && !Array.isArray(value);
+}
+function parseInvoiceRecord(value) {
+  var parsed = value;
+  if (typeof parsed === 'string') {
+    try {
+      parsed = JSON.parse(parsed);
+    } catch (_unused) {
+      return null;
+    }
+  }
+  return isRecord(parsed) ? parsed : null;
+}
+export function getDefaultInvoiceLayoutConfig() {
+  return {
+    module: []
+  };
+}
+export function getDefaultInvoiceTemplateSettings() {
+  return {
+    template: 'DEFAULT',
+    language: {},
+    modules: []
+  };
+}
+function normalizeInvoiceTemplate(value) {
+  if (typeof value !== 'string' || value.trim().length === 0) return 'DEFAULT';
+  return value.trim().toUpperCase() === 'DEFAULT' ? 'DEFAULT' : value;
+}
+function normalizeInvoiceLanguage(value) {
+  if (!isRecord(value)) return {};
+  if (Object.values(value).some(function (item) {
+    return typeof item !== 'number';
+  })) return {};
+  return _objectSpread({}, value);
+}
+function normalizeInvoiceModules(value) {
+  if (!Array.isArray(value)) return [];
+  if (value.some(function (item) {
+    return !isRecord(item) || typeof item.key !== 'string';
+  })) {
+    return [];
+  }
+  return value.map(function (item) {
+    return _objectSpread({}, item);
+  });
+}
+
+/**
+ * 规范化已经提取出的公开 template_settings 值，供打印入口复用。
+ */
+export function normalizeRawInvoiceTemplateSettings(value) {
+  var parsed = parseInvoiceRecord(value);
+  if (!parsed) return getDefaultInvoiceTemplateSettings();
+  return _objectSpread(_objectSpread({}, parsed), {}, {
+    template: normalizeInvoiceTemplate(parsed.template),
+    language: normalizeInvoiceLanguage(parsed.language),
+    modules: normalizeInvoiceModules(parsed.modules)
+  });
+}
+
+/**
+ * 从 OpenData Documents section 的两个扁平字段中构造 Native Invoice 配置。
+ */
+export function normalizeInvoiceTemplateSettings(config) {
+  var parsedEdit = parseInvoiceRecord(config === null || config === void 0 ? void 0 : config['documents.invoice_edit']);
+  return normalizeRawInvoiceTemplateSettings(_objectSpread(_objectSpread({}, parsedEdit !== null && parsedEdit !== void 0 ? parsedEdit : {}), {}, {
+    template: normalizeInvoiceTemplate(config === null || config === void 0 ? void 0 : config['documents.invoice_template'])
+  }));
+}
+
+/**
+ * 将 invoice_edit.modules 原样投影为 Web Invoice 使用的 module 字段。
+ */
+export function normalizeInvoiceLayoutConfig(config) {
+  return {
+    module: normalizeInvoiceTemplateSettings(config).modules
+  };
+}
 function toBoolean(value) {
   if (typeof value === 'boolean') return value;
   if (typeof value === 'string') return value === 'true' || value === '1';

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

@@ -182,6 +182,8 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     private calculateOrderPaidPaymentTotal;
     private getDepositAmount;
     private normalizeDepositAmount;
+    private normalizeDepositFlag;
+    private getHistoricalDepositSnapshot;
     private getLastOrderDepositSnapshot;
     private getLastOrderSubmitSnapshot;
     private applyDepositAmountToSummary;
@@ -526,7 +528,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     generateIdempotencyToken(): string;
     syncPaymentsToOrder<T = any>(params: SyncPaymentsToOrderParams): Promise<SyncPaymentsToOrderResult<T>>;
     createOrder(params: CommitOrderParams['query']): {
-        type: "appointment_booking" | "virtual";
+        type: "virtual" | "appointment_booking";
         platform: string;
         sales_channel: string;
         order_sales_channel: string;

package/dist/modules/Order/index.js

@@ -1584,21 +1584,32 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       return Decimal.max(new Decimal(Number(amount) || 0), 0).toDecimalPlaces(2).toFixed(2);
     }
   }, {
-    key: "getLastOrderDepositSnapshot",
-    value: function getLastOrderDepositSnapshot() {
-      var _lastOrderInfo$deposi, _lastOrderInfo$summar;
-      var lastOrderInfo = this.store.lastOrderInfo;
-      if (!lastOrderInfo || _typeof(lastOrderInfo) !== 'object') return null;
-      var rawDepositAmount = (_lastOrderInfo$deposi = lastOrderInfo.deposit_amount) !== null && _lastOrderInfo$deposi !== void 0 ? _lastOrderInfo$deposi : (_lastOrderInfo$summar = lastOrderInfo.summary) === null || _lastOrderInfo$summar === void 0 ? void 0 : _lastOrderInfo$summar.deposit_amount;
+    key: "normalizeDepositFlag",
+    value: function normalizeDepositFlag(value) {
+      if (value === 0 || value === '0') return 0;
+      if (value === 1 || value === '1') return 1;
+      return null;
+    }
+  }, {
+    key: "getHistoricalDepositSnapshot",
+    value: function getHistoricalDepositSnapshot(source) {
+      var _record$deposit_amoun, _record$summary, _this$normalizeDeposi;
+      if (!source || _typeof(source) !== 'object') return null;
+      var record = source;
+      var rawDepositAmount = (_record$deposit_amoun = record.deposit_amount) !== null && _record$deposit_amoun !== void 0 ? _record$deposit_amoun : (_record$summary = record.summary) === null || _record$summary === void 0 ? void 0 : _record$summary.deposit_amount;
       var depositAmount = this.normalizeDepositAmount(rawDepositAmount !== null && rawDepositAmount !== void 0 ? rawDepositAmount : 0);
-      var hasDepositAmount = new Decimal(depositAmount).gt(0);
-      var isDeposit = Number(lastOrderInfo.is_deposit) === 1 || hasDepositAmount;
-      if (!isDeposit || !hasDepositAmount) return null;
+      if (!new Decimal(depositAmount).gt(0)) return null;
       return {
-        isDeposit: 1,
+        // 兼容历史数据：旧快照缺少 is_deposit 时，沿用正定金金额的推导规则。
+        isDeposit: (_this$normalizeDeposi = this.normalizeDepositFlag(record.is_deposit)) !== null && _this$normalizeDeposi !== void 0 ? _this$normalizeDeposi : 1,
         depositAmount: depositAmount
       };
     }
+  }, {
+    key: "getLastOrderDepositSnapshot",
+    value: function getLastOrderDepositSnapshot() {
+      return this.getHistoricalDepositSnapshot(this.store.lastOrderInfo);
+    }
   }, {
     key: "getLastOrderSubmitSnapshot",
     value: function getLastOrderSubmitSnapshot() {
@@ -1645,7 +1656,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
         })
       });
       tempOrder.deposit_amount = snapshot.depositAmount;
-      tempOrder.is_deposit = tempOrder.is_deposit === 0 && new Decimal(tempOrder.deposit_amount || 0).gt(0) ? 0 : snapshot.isDeposit;
+      tempOrder.is_deposit = snapshot.isDeposit;
       return nextSummary;
     }
   }, {
@@ -2355,6 +2366,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "restoreOriginalSnapshotIfProductsUnchanged",
     value: function restoreOriginalSnapshotIfProductsUnchanged(tempOrder, snapshot) {
+      var _historicalDepositSna;
       // merge hydrate 的商品集合包含本地未提交行，但 summary 仍来自远端旧订单，不能复用。
       if (snapshot.requiresFullSummaryRecalculation === true) return null;
       var currentFingerprint = this.buildOrderProductsFingerprint(tempOrder.products);
@@ -2366,10 +2378,17 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       }
       var summary = _objectSpread(_objectSpread({}, createEmptySummary()), cloneDeep(snapshot.summary || {}));
       var shouldUseManualDepositOverride = Boolean(manualDepositOverride && manualDepositOverride.productStructuralFingerprint === this.buildOrderProductsStructuralFingerprint(tempOrder.products));
+      var historicalDepositSnapshot = this.getHistoricalDepositSnapshot(snapshot);
       if (shouldUseManualDepositOverride) {
         summary = this.applyDepositAmountToSummary(tempOrder, summary, manualDepositOverride.amount);
-      } else if (manualDepositOverride) {
-        this.clearManualDepositOverride(tempOrder);
+      } else {
+        if (manualDepositOverride) {
+          this.clearManualDepositOverride(tempOrder);
+        }
+        if (historicalDepositSnapshot) {
+          summary = this.applyDepositAmountToSummary(tempOrder, summary, historicalDepositSnapshot.depositAmount);
+          tempOrder.is_deposit = historicalDepositSnapshot.isDeposit;
+        }
       }
       var isPayableAmountUnchanged = this.isSnapshotPayableAmountUnchanged(tempOrder, snapshot, summary);
       if (!isPayableAmountUnchanged) return null;
@@ -2386,8 +2405,8 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
         tempOrder.surcharges = cloneDeep(snapshot.surcharges);
       }
       tempOrder.surcharge_fee = summary.surcharge_fee || tempOrder.surcharge_fee;
-      tempOrder.deposit_amount = summary.deposit_amount || '0.00';
-      tempOrder.is_deposit = summary.deposit_amount !== '0.00' ? 1 : 0;
+      tempOrder.deposit_amount = this.normalizeDepositAmount(summary.deposit_amount || 0);
+      tempOrder.is_deposit = shouldUseManualDepositOverride ? new Decimal(tempOrder.deposit_amount).gt(0) ? 1 : 0 : (_historicalDepositSna = historicalDepositSnapshot === null || historicalDepositSnapshot === void 0 ? void 0 : historicalDepositSnapshot.isDeposit) !== null && _historicalDepositSna !== void 0 ? _historicalDepositSna : new Decimal(tempOrder.deposit_amount).gt(0) ? 1 : 0;
       var previousSummary = this.store.summary;
       this.store.summary = summary;
       this.updateTempOrderPaymentStatus(tempOrder, {
@@ -3049,7 +3068,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       var isExistingDepositDisabled = tempOrder.is_deposit === 0 && new Decimal(tempOrder.deposit_amount || 0).gt(0);
       tempOrder.deposit_amount = depositAmount;
       tempOrder.is_deposit = hasDepositAmount && !isExistingDepositDisabled ? 1 : 0;
-      return this.applyLastOrderDepositSnapshot(tempOrder, nextSummary);
+      return shouldUseManualDepositOverride ? nextSummary : this.applyLastOrderDepositSnapshot(tempOrder, nextSummary);
     }
   }, {
     key: "recalculateSummary",
@@ -5714,7 +5733,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       var _syncPaymentsToOrder = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee35(params) {
         var _this32 = this,
           _params$confirmPendin;
-        var tempOrder, needsPaymentNumber, devicePrefix, mappedPayments, shouldConfirmPendingVoucherPayments, effectivePayments, completion, orderPaidPaymentTotal, paymentStatus, paymentSyncIdempotencyToken, submitParams, submitResult;
+        var tempOrder, needsPaymentNumber, devicePrefix, mappedPayments, shouldConfirmPendingVoucherPayments, effectivePayments, completion, orderPaidPaymentTotal, paymentStatus, paymentSyncIdempotencyToken, enhancePayload, submitParams, submitResult;
         return _regeneratorRuntime().wrap(function _callee35$(_context38) {
           while (1) switch (_context38.prev = _context38.next) {
             case 0:
@@ -5767,6 +5786,12 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
             case 25:
               this.store.syncState = 'submitting';
               paymentSyncIdempotencyToken = this.buildPaymentSyncIdempotencyToken(tempOrder, effectivePayments);
+              enhancePayload = function enhancePayload(payload, ctx) {
+                var enhancedPayload = params.enhancePayload ? params.enhancePayload(payload, ctx) : payload;
+                return _objectSpread(_objectSpread({}, enhancedPayload), {}, {
+                  request_unique_idempotency_token: paymentSyncIdempotencyToken
+                });
+              };
               submitParams = {
                 payments: effectivePayments,
                 paymentStatus: paymentStatus,
@@ -5774,34 +5799,29 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 businessCode: params.businessCode,
                 channel: params.channel,
                 confirmPendingVoucherPayments: true,
-                enhancePayload: function enhancePayload(payload) {
-                  var nextPayload = _objectSpread(_objectSpread({}, payload), {}, {
-                    request_unique_idempotency_token: paymentSyncIdempotencyToken
-                  });
-                  return nextPayload;
-                }
+                enhancePayload: enhancePayload
               };
               if (!(params.checkoutSyncTaskEnabled === false)) {
-                _context38.next = 34;
+                _context38.next = 35;
                 break;
               }
-              _context38.next = 31;
+              _context38.next = 32;
               return this.submitTempOrderAsync(submitParams);
-            case 31:
+            case 32:
               _context38.t1 = _context38.sent;
-              _context38.next = 37;
+              _context38.next = 38;
               break;
-            case 34:
-              _context38.next = 36;
+            case 35:
+              _context38.next = 37;
               return this.submitTempOrder(submitParams);
-            case 36:
-              _context38.t1 = _context38.sent;
             case 37:
+              _context38.t1 = _context38.sent;
+            case 38:
               submitResult = _context38.t1;
               return _context38.abrupt("return", _objectSpread(_objectSpread({}, completion), {}, {
                 submitResult: submitResult
               }));
-            case 39:
+            case 40:
             case "end":
               return _context38.stop();
           }
@@ -6267,7 +6287,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     value: (function () {
       var _hydrateTempOrderFromRecord = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee43(record, options) {
         var _sourceRaw$_extend, _this$store$discount26;
-        var sourceRaw, duplicateProductIdentityRepair, duplicateIdentityReadySource, identityReadySource, normalizedCollections, raw, hasIdentityChanges, identityLogMetadata, hasIdentityWarnings, isSessionStorageHydrate, isMergedSalesDetailHydrate, nextTempOrder, _this$store$discount24, _this$store$discount25, restoredSessionDiscounts, nextExtend, sourceLastOrderInfo, isDraftOrder, syntheticIdentityOptions, rawSummary, summarySurcharges, hadSyntheticDraftOrderId, hydratedEditDiscounts, currentDiscounts, currentScanDiscounts, hydratedDiscountIds, retainedScanDiscounts, nextDiscounts, shouldSkipEmptyDiscountSync, _this$store$discount27, _this$store$discount28;
+        var sourceRaw, duplicateProductIdentityRepair, duplicateIdentityReadySource, identityReadySource, normalizedCollections, raw, hasIdentityChanges, identityLogMetadata, hasIdentityWarnings, isSessionStorageHydrate, isMergedSalesDetailHydrate, nextTempOrder, _this$store$discount24, _this$store$discount25, restoredSessionDiscounts, nextExtend, sourceLastOrderInfo, isDraftOrder, syntheticIdentityOptions, rawSummary, historicalDepositSnapshot, summarySurcharges, hadSyntheticDraftOrderId, hydratedEditDiscounts, currentDiscounts, currentScanDiscounts, hydratedDiscountIds, retainedScanDiscounts, nextDiscounts, shouldSkipEmptyDiscountSync, _this$store$discount27, _this$store$discount28;
         return _regeneratorRuntime().wrap(function _callee43$(_context46) {
           while (1) switch (_context46.prev = _context46.next) {
             case 0:
@@ -6351,6 +6371,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 externalSaleNumber: nextTempOrder.external_sale_number
               };
               rawSummary = raw.summary && _typeof(raw.summary) === 'object' ? raw.summary : {};
+              historicalDepositSnapshot = this.getHistoricalDepositSnapshot(sourceLastOrderInfo);
               summarySurcharges = Array.isArray(rawSummary.surcharges) ? rawSummary.surcharges.map(function (s) {
                 return _objectSpread({}, s || {});
               }) : cloneDeep(nextTempOrder.surcharges || []);
@@ -6358,7 +6379,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 surcharges: summarySurcharges
               });
               nextTempOrder._extend = _objectSpread(_objectSpread({}, nextTempOrder._extend || {}), {}, {
-                originalSalesSnapshot: _objectSpread({
+                originalSalesSnapshot: _objectSpread(_objectSpread({
                   summary: cloneDeep(this.store.summary),
                   products: cloneDeep(nextTempOrder.products || []),
                   bookings: cloneDeep(nextTempOrder.bookings || []),
@@ -6366,7 +6387,10 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                   surcharges: cloneDeep(nextTempOrder.surcharges || []),
                   shop_discount: nextTempOrder.shop_discount || '0.00',
                   productFingerprint: this.buildOrderProductsFingerprint(nextTempOrder.products || [])
-                }, isMergedSalesDetailHydrate ? {
+                }, historicalDepositSnapshot ? {
+                  is_deposit: historicalDepositSnapshot.isDeposit,
+                  deposit_amount: historicalDepositSnapshot.depositAmount
+                } : {}), isMergedSalesDetailHydrate ? {
                   requiresFullSummaryRecalculation: true
                 } : {})
               });
@@ -6389,28 +6413,28 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               nextDiscounts = [].concat(_toConsumableArray(hydratedEditDiscounts), _toConsumableArray(retainedScanDiscounts));
               shouldSkipEmptyDiscountSync = nextDiscounts.length === 0 && currentDiscounts.length === 0;
               if (shouldSkipEmptyDiscountSync) {
-                _context46.next = 53;
+                _context46.next = 54;
                 break;
               }
               OrderModule.populateSavedAmounts(nextTempOrder.products, nextDiscounts);
-              _context46.next = 51;
+              _context46.next = 52;
               return (_this$store$discount27 = this.store.discount) === null || _this$store$discount27 === void 0 ? void 0 : _this$store$discount27.setOriginalDiscountList(nextDiscounts);
-            case 51:
-              _context46.next = 53;
+            case 52:
+              _context46.next = 54;
               return (_this$store$discount28 = this.store.discount) === null || _this$store$discount28 === void 0 ? void 0 : _this$store$discount28.setDiscountList(nextDiscounts);
-            case 53:
+            case 54:
               if (!(options !== null && options !== void 0 && options.recalcOnHydrate)) {
-                _context46.next = 56;
+                _context46.next = 57;
                 break;
               }
-              _context46.next = 56;
+              _context46.next = 57;
               return this.recalculateSummary({
                 createIfMissing: false
               });
-            case 56:
+            case 57:
               this.persistTempOrder();
               return _context46.abrupt("return", nextTempOrder);
-            case 58:
+            case 59:
             case "end":
               return _context46.stop();
           }

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

@@ -157,11 +157,13 @@ export interface OrderCustomerPatch {
  * 下单客户变更事件 payload。
  * - `patch`：tempOrder 上的协议字段视图（会随订单提交）
  * - `snapshot`：UI 富字段快照（仅本地，不随订单提交）
+ * - `source`：缺省表示真实业务变更；`detailHydrate` 仅表示打开详情时快照已就绪
  * 清空时整个 payload 为 null。
  */
 export interface OrderCustomerChangePayload {
     patch: OrderCustomerView;
     snapshot: ICustomer | null;
+    source?: 'detailHydrate';
 }
 export interface OrderScanCodeResult {
     isAvailable: boolean;
@@ -612,6 +614,7 @@ export interface SyncPaymentsToOrderParams {
     businessCode?: string;
     channel?: string;
     confirmPendingVoucherPayments?: boolean;
+    enhancePayload?: SubmitPayloadEnhancer;
 }
 export interface SyncPaymentsToOrderResult<T = any> {
     isFullyPaid: boolean;

package/dist/modules/Order/types.js

@@ -60,6 +60,7 @@ export var OrderHooks = /*#__PURE__*/function (OrderHooks) {
  * 下单客户变更事件 payload。
  * - `patch`：tempOrder 上的协议字段视图（会随订单提交）
  * - `snapshot`：UI 富字段快照（仅本地，不随订单提交）
+ * - `source`：缺省表示真实业务变更；`detailHydrate` 仅表示打开详情时快照已就绪
  * 清空时整个 payload 为 null。
  */