@pisell/pisellos 0.10.3 → 0.10.5

package/dist/modules/BaseModule.d.ts

@@ -8,6 +8,7 @@ export declare class BaseModule {
     protected core: PisellCore;
     constructor(name?: string, version?: string);
     destroy(): void;
+    private isRecord;
     checkSaveCache({ cacheId, fatherModule, store, cacheKey, }: {
         cacheId: string | undefined;
         fatherModule: string | undefined;

package/dist/modules/BaseModule.js

@@ -23,45 +23,41 @@ export var BaseModule = /*#__PURE__*/function () {
       this.core.effects.offByModuleDestroy(this.name);
       this.core.unregisterModule(this);
     }
+  }, {
+    key: "isRecord",
+    value: function isRecord(value) {
+      return !!value && _typeof(value) === 'object' && !Array.isArray(value);
+    }
 
     // 提供统一的缓存 module 里的数据的方法
   }, {
     key: "checkSaveCache",
     value: function checkSaveCache(_ref) {
-      var _this = this;
       var cacheId = _ref.cacheId,
         fatherModule = _ref.fatherModule,
         store = _ref.store,
         cacheKey = _ref.cacheKey;
-      var window = this.core.getPlugin('window');
-      if (cacheId) {
+      if (!cacheId) return;
+      try {
+        var window = this.core.getPlugin('window');
+        var sessionStorage = window === null || window === void 0 ? void 0 : window.sessionStorage;
+        if (!sessionStorage) return;
+        var storageKey = fatherModule || cacheId;
+        var rawCacheData = sessionStorage.getItem(storageKey);
+        var parsedCacheData = rawCacheData ? JSON.parse(rawCacheData) : {};
+        if (!this.isRecord(parsedCacheData)) return;
+        var cacheBucket = fatherModule ? this.isRecord(parsedCacheData[cacheId]) ? parsedCacheData[cacheId] : {} : parsedCacheData;
+        var moduleBucket = this.isRecord(cacheBucket[this.name]) ? cacheBucket[this.name] : {};
+        cacheKey.forEach(function (key) {
+          moduleBucket[key] = store === null || store === void 0 ? void 0 : store[key];
+        });
+        cacheBucket[this.name] = moduleBucket;
         if (fatherModule) {
-          var currentCacheData = window.sessionStorage.getItem(fatherModule);
-          var currentCacheDataObj = JSON.parse(currentCacheData || '{}');
-          if (!currentCacheData || !currentCacheDataObj[cacheId]) {
-            currentCacheDataObj = _defineProperty({}, cacheId, _defineProperty({}, this.name, {}));
-          }
-          if (!currentCacheDataObj[cacheId][this.name]) {
-            currentCacheDataObj[cacheId][this.name] = {};
-          }
-          cacheKey.forEach(function (key) {
-            currentCacheDataObj[cacheId][_this.name][key] = store === null || store === void 0 ? void 0 : store[key];
-          });
-          window.sessionStorage.setItem(fatherModule, JSON.stringify(currentCacheDataObj));
-        } else {
-          var _currentCacheData = window.sessionStorage.getItem(cacheId);
-          var _currentCacheDataObj2 = JSON.parse(_currentCacheData || '{}');
-          if (!_currentCacheDataObj2) {
-            _currentCacheDataObj2 = {};
-          }
-          if (!_currentCacheDataObj2[this.name]) {
-            _currentCacheDataObj2[this.name] = {};
-          }
-          cacheKey.forEach(function (key) {
-            _currentCacheDataObj2[_this.name][key] = store[key];
-          });
-          window.sessionStorage.setItem(cacheId, JSON.stringify(_currentCacheDataObj2));
+          parsedCacheData[cacheId] = cacheBucket;
         }
+        sessionStorage.setItem(storageKey, JSON.stringify(parsedCacheData));
+      } catch (_unused) {
+        // sessionStorage persistence is best-effort and must not block checkout.
       }
     }
   }, {

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

@@ -16,6 +16,10 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     private window;
     private appPlugin;
     private cacheId;
+    private fatherModule;
+    private openCache;
+    private sessionStoragePersistEnabled;
+    private sessionStorageRestoreRecord;
     private salesSummaryModuleName;
     private rulesHooksOverride?;
     private moduleHooksOverride?;
@@ -46,6 +50,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     static populateSavedAmounts(productList: Array<Record<string, any>>, discountList: Array<Record<string, any>>): void;
     private applyProductDiscountPrices;
     constructor(name?: string, version?: string);
+    private syncSessionStorageOptions;
     initialize(core: PisellCore, options: ModuleOptions): Promise<void>;
     destroy(): Promise<void>;
     /**
@@ -137,7 +142,8 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     }): void;
     /**
      * 控制 IndexedDB 草稿（saveDraft）是否写入。
-     * localStorage 版 tempOrder 持久化已废弃，此方法仅影响 saveDraft。
+     * 此开关仅影响 saveDraft；可选 sessionStorage 会话恢复由
+     * enableSessionStoragePersist 独立控制。
      *
      * @example
      * order.setEnableTempOrderPersist(false); // BigSale 弹窗：跳过 ~1s 的 dbUpdate
@@ -145,8 +151,12 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     setEnableTempOrderPersist(enabled: boolean): void;
     /** 是否允许 saveDraft 写入 IndexedDB 草稿。 */
     isTempOrderPersistEnabled(): boolean;
-    /** @deprecated OrderModule 不再负责 tempOrder localStorage 持久化；草稿保存请使用 IndexedDB saveDraft。 */
+    /**
+     * 在 UnifiedBookingSales 显式开启会话恢复时，将完整 tempOrder 写入
+     * sessionStorage 的 cacheId 分桶。写入失败由 BaseModule 静默降级。
+     */
     persistTempOrder(): void;
+    consumeSessionStorageRestore(): Record<string, any> | null;
     notifyTempOrderChanged(): void;
     private createDefaultTempOrderInstance;
     private createExternalSaleNumber;
@@ -537,6 +547,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
      */
     hydrateTempOrderFromRecord(record: Record<string, any>, options?: {
         recalcOnHydrate?: boolean;
+        source?: 'salesDetail' | 'sessionStorage';
     }): Promise<OrderTempOrder>;
     /**
      * 兼容后端详情将 holder 放在 metadata.holder 的历史形态，统一补到运行时展示路径。

package/dist/modules/Order/index.js

@@ -121,6 +121,10 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     _defineProperty(_assertThisInitialized(_this), "window", void 0);
     _defineProperty(_assertThisInitialized(_this), "appPlugin", void 0);
     _defineProperty(_assertThisInitialized(_this), "cacheId", void 0);
+    _defineProperty(_assertThisInitialized(_this), "fatherModule", void 0);
+    _defineProperty(_assertThisInitialized(_this), "openCache", false);
+    _defineProperty(_assertThisInitialized(_this), "sessionStoragePersistEnabled", false);
+    _defineProperty(_assertThisInitialized(_this), "sessionStorageRestoreRecord", null);
     _defineProperty(_assertThisInitialized(_this), "salesSummaryModuleName", void 0);
     _defineProperty(_assertThisInitialized(_this), "rulesHooksOverride", void 0);
     _defineProperty(_assertThisInitialized(_this), "moduleHooksOverride", void 0);
@@ -305,18 +309,38 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
         return product;
       });
     }
+  }, {
+    key: "syncSessionStorageOptions",
+    value: function syncSessionStorageOptions(otherParams) {
+      this.cacheId = otherParams.cacheId;
+      this.fatherModule = otherParams.fatherModule;
+      this.openCache = Boolean(this.cacheId && otherParams.openCache !== false);
+      this.sessionStoragePersistEnabled = Boolean(this.openCache && otherParams.enableSessionStoragePersist === true);
+    }
   }, {
     key: "initialize",
     value: function () {
       var _initialize = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(core, options) {
         var _appPlugin$getApp, _otherParams$rules, _otherParams$order, _otherParams$hooks;
-        var appPlugin, app, otherParams;
+        var otherParams, cachedTempOrder, appPlugin, app;
         return _regeneratorRuntime().wrap(function _callee$(_context) {
           while (1) switch (_context.prev = _context.next) {
             case 0:
               this.core = core;
               this.store = options.store;
-              if (!this.store.tempOrder) {
+              otherParams = options.otherParams || {};
+              this.syncSessionStorageOptions(otherParams);
+              if (this.sessionStoragePersistEnabled) {
+                cachedTempOrder = this.store.tempOrder;
+                this.sessionStorageRestoreRecord = isTempOrder(cachedTempOrder) ? cloneDeep(cachedTempOrder) : null;
+                // 统一由 loadSalesDetail hydrate，初始化阶段不直接把缓存态暴露给业务。
+                this.store.tempOrder = null;
+                this.store.summary = createEmptySummary();
+                this.store.availableWalletIds = [];
+                this.store.lastOrderInfo = undefined;
+                this.store.syncState = undefined;
+                this.store.discountList = [];
+              } else if (!this.store.tempOrder) {
                 this.store.tempOrder = null;
               }
               if (!this.store.summary) {
@@ -333,8 +357,6 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               app = appPlugin === null || appPlugin === void 0 || (_appPlugin$getApp = appPlugin.getApp) === null || _appPlugin$getApp === void 0 ? void 0 : _appPlugin$getApp.call(appPlugin);
               this.logger = app === null || app === void 0 ? void 0 : app.logger;
               this.window = this.core.getPlugin('window');
-              otherParams = options.otherParams || {};
-              this.cacheId = otherParams.cacheId;
               this.salesSummaryModuleName = otherParams.salesSummaryModuleName;
               this.rulesHooksOverride = (_otherParams$rules = otherParams.rules) === null || _otherParams$rules === void 0 ? void 0 : _otherParams$rules.hooks;
               this.moduleHooksOverride = options.hooks;
@@ -362,49 +384,50 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
         return _regeneratorRuntime().wrap(function _callee2$(_context2) {
           while (1) switch (_context2.prev = _context2.next) {
             case 0:
+              this.sessionStorageRestoreRecord = null;
               childModules = [(_this$store = this.store) === null || _this$store === void 0 ? void 0 : _this$store.discount, (_this$store2 = this.store) === null || _this$store2 === void 0 ? void 0 : _this$store2.rules];
               _i = 0, _childModules = childModules;
-            case 2:
+            case 3:
               if (!(_i < _childModules.length)) {
-                _context2.next = 18;
+                _context2.next = 19;
                 break;
               }
               childModule = _childModules[_i];
               if (!(!childModule || typeof childModule.destroy !== 'function')) {
-                _context2.next = 6;
+                _context2.next = 7;
                 break;
               }
-              return _context2.abrupt("continue", 15);
-            case 6:
-              _context2.prev = 6;
-              _context2.next = 9;
+              return _context2.abrupt("continue", 16);
+            case 7:
+              _context2.prev = 7;
+              _context2.next = 10;
               return childModule.destroy();
-            case 9:
-              _context2.next = 15;
+            case 10:
+              _context2.next = 16;
               break;
-            case 11:
-              _context2.prev = 11;
-              _context2.t0 = _context2["catch"](6);
+            case 12:
+              _context2.prev = 12;
+              _context2.t0 = _context2["catch"](7);
               errorMessage = _context2.t0 instanceof Error ? _context2.t0.message : String(_context2.t0);
               this.logWarning('Destroy child module failed', {
                 module: childModule.name,
                 error: errorMessage
               });
-            case 15:
+            case 16:
               _i++;
-              _context2.next = 2;
+              _context2.next = 3;
               break;
-            case 18:
+            case 19:
               if (this.store) {
                 this.store.discount = null;
                 this.store.rules = null;
               }
               _get(_getPrototypeOf(OrderModule.prototype), "destroy", this).call(this);
-            case 20:
+            case 21:
             case "end":
               return _context2.stop();
           }
-        }, _callee2, this, [[6, 11]]);
+        }, _callee2, this, [[7, 12]]);
       }));
       function destroy() {
         return _destroy.apply(this, arguments);
@@ -422,7 +445,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     value: function updateOtherParams(params) {
       var _otherParams$rules2, _otherParams$order2, _otherParams$hooks2;
       var otherParams = params || {};
-      this.cacheId = otherParams.cacheId;
+      this.syncSessionStorageOptions(otherParams);
       this.salesSummaryModuleName = otherParams.salesSummaryModuleName;
       this.rulesHooksOverride = (_otherParams$rules2 = otherParams.rules) === null || _otherParams$rules2 === void 0 ? void 0 : _otherParams$rules2.hooks;
       this.orderHooks = this.moduleHooksOverride || ((_otherParams$order2 = otherParams.order) === null || _otherParams$order2 === void 0 ? void 0 : _otherParams$order2.hooks) || ((_otherParams$hooks2 = otherParams.hooks) === null || _otherParams$hooks2 === void 0 ? void 0 : _otherParams$hooks2.order);
@@ -480,15 +503,15 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     value: function registerDiscountModules(options) {
       var _targetCacheData;
       var targetCacheData = {};
-      if (this.cacheId && this.window) {
-        var sessionData = this.window.sessionStorage.getItem(this.name);
-        if (sessionData) {
-          try {
+      if (!this.sessionStoragePersistEnabled && this.openCache && this.cacheId && this.window) {
+        try {
+          var sessionData = this.window.sessionStorage.getItem(this.name);
+          if (sessionData) {
             var data = JSON.parse(sessionData);
             targetCacheData = (data === null || data === void 0 ? void 0 : data[this.cacheId]) || {};
-          } catch (_unused) {
-            // sessionStorage 损坏则忽略，按空 initialState 走
           }
+        } catch (_unused) {
+          // sessionStorage 损坏或不可用时忽略，按空 initialState 走
         }
       }
       var discount = new DiscountModule("".concat(this.name, "_discount"));
@@ -496,7 +519,8 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
         initialState: (_targetCacheData = targetCacheData) === null || _targetCacheData === void 0 ? void 0 : _targetCacheData[discount.name],
         otherParams: {
           fatherModule: this.name,
-          openCache: !!this.cacheId,
+          // Unified 的单快照由 Order 管理；其他 Solution 保持原有 Discount 缓存语义。
+          openCache: this.openCache && !this.sessionStoragePersistEnabled,
           cacheId: this.cacheId
         }
       });
@@ -1249,7 +1273,8 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
 
     /**
      * 控制 IndexedDB 草稿（saveDraft）是否写入。
-     * localStorage 版 tempOrder 持久化已废弃，此方法仅影响 saveDraft。
+     * 此开关仅影响 saveDraft；可选 sessionStorage 会话恢复由
+     * enableSessionStoragePersist 独立控制。
      *
      * @example
      * order.setEnableTempOrderPersist(false); // BigSale 弹窗：跳过 ~1s 的 dbUpdate
@@ -1267,11 +1292,29 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       return this.draftPersistEnabled;
     }
 
-    /** @deprecated OrderModule 不再负责 tempOrder localStorage 持久化；草稿保存请使用 IndexedDB saveDraft。 */
+    /**
+     * 在 UnifiedBookingSales 显式开启会话恢复时，将完整 tempOrder 写入
+     * sessionStorage 的 cacheId 分桶。写入失败由 BaseModule 静默降级。
+     */
   }, {
     key: "persistTempOrder",
     value: function persistTempOrder() {
-      // no-op: OrderModule 的刷新恢复不再依赖 localStorage。
+      if (!this.sessionStoragePersistEnabled || !this.store.tempOrder) return;
+      this.checkSaveCache({
+        cacheId: this.cacheId,
+        fatherModule: this.fatherModule,
+        store: {
+          tempOrder: this.store.tempOrder
+        },
+        cacheKey: ['tempOrder']
+      });
+    }
+  }, {
+    key: "consumeSessionStorageRestore",
+    value: function consumeSessionStorageRestore() {
+      var record = this.sessionStorageRestoreRecord;
+      this.sessionStorageRestoreRecord = null;
+      return record ? cloneDeep(record) : null;
     }
   }, {
     key: "notifyTempOrderChanged",
@@ -2336,6 +2379,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     value: function restoreOrder() {
       var _this$store$discount16, _this$store$discount17;
       this.logInfo('restoreOrder start', {});
+      this.sessionStorageRestoreRecord = null;
       var freshTempOrder = this.createDefaultTempOrderInstance();
       this.ensureExternalSaleNumber(freshTempOrder);
       this.store.tempOrder = freshTempOrder;
@@ -2366,36 +2410,37 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               }
               throw new Error('无效的 tempOrder 数据');
             case 2:
+              this.sessionStorageRestoreRecord = null;
               nextTempOrder = this.normalizeTempOrderForRuntime(cloneDeep(tempOrder), {
                 ensureIdentity: false
               });
               this.store.tempOrder = nextTempOrder;
               if (!((options === null || options === void 0 ? void 0 : options.recalculateSummary) !== false)) {
-                _context12.next = 9;
+                _context12.next = 10;
                 break;
               }
-              _context12.next = 7;
+              _context12.next = 8;
               return this.recalculateSummary({
                 createIfMissing: false
               });
-            case 7:
-              _context12.next = 10;
+            case 8:
+              _context12.next = 11;
               break;
-            case 9:
-              this.store.summary = createEmptySummary();
             case 10:
+              this.store.summary = createEmptySummary();
+            case 11:
               if ((options === null || options === void 0 ? void 0 : options.persist) !== false) {
                 this.persistTempOrder();
               }
               if (!(options !== null && options !== void 0 && options.saveDraft)) {
-                _context12.next = 14;
+                _context12.next = 15;
                 break;
               }
-              _context12.next = 14;
+              _context12.next = 15;
               return this.saveDraft();
-            case 14:
-              return _context12.abrupt("return", nextTempOrder);
             case 15:
+              return _context12.abrupt("return", nextTempOrder);
+            case 16:
             case "end":
               return _context12.stop();
           }
@@ -5866,8 +5911,8 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     key: "hydrateTempOrderFromRecord",
     value: (function () {
       var _hydrateTempOrderFromRecord = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee44(record, options) {
-        var _this$store$discount20;
-        var sourceRaw, identityReadySource, normalizedCollections, raw, hasIdentityChanges, identityLogMetadata, hasIdentityWarnings, nextTempOrder, sourceLastOrderInfo, isDraftOrder, syntheticIdentityOptions, rawSummary, summarySurcharges, hadSyntheticDraftOrderId, hydratedEditDiscounts, currentDiscounts, currentScanDiscounts, hydratedDiscountIds, retainedScanDiscounts, nextDiscounts, shouldSkipEmptyDiscountSync, _this$store$discount21, _this$store$discount22;
+        var _this$store$discount22;
+        var sourceRaw, identityReadySource, normalizedCollections, raw, hasIdentityChanges, identityLogMetadata, hasIdentityWarnings, isSessionStorageHydrate, nextTempOrder, _this$store$discount20, _this$store$discount21, restoredSessionDiscounts, nextExtend, sourceLastOrderInfo, isDraftOrder, syntheticIdentityOptions, rawSummary, summarySurcharges, hadSyntheticDraftOrderId, hydratedEditDiscounts, currentDiscounts, currentScanDiscounts, hydratedDiscountIds, retainedScanDiscounts, nextDiscounts, shouldSkipEmptyDiscountSync, _this$store$discount23, _this$store$discount24;
         return _regeneratorRuntime().wrap(function _callee44$(_context47) {
           while (1) switch (_context47.prev = _context47.next) {
             case 0:
@@ -5892,10 +5937,48 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                   this.logInfo('Normalized hydrated order collection identities', identityLogMetadata);
                 }
               }
+              isSessionStorageHydrate = (options === null || options === void 0 ? void 0 : options.source) === 'sessionStorage';
               nextTempOrder = this.normalizeTempOrderForRuntime(raw, {
-                makeEditMark: true
-              }); // Server list compatibility may synthesize order_id from external_sale_number; tempOrder must not.
-              sourceLastOrderInfo = raw.lastOrderInfo || raw;
+                makeEditMark: !isSessionStorageHydrate
+              });
+              this.store.tempOrder = nextTempOrder;
+              if (!isSessionStorageHydrate) {
+                _context47.next = 27;
+                break;
+              }
+              // 会话快照是未提交购物车，不应获得编辑订单的 saved/edit 标记与服务端基线。
+              restoredSessionDiscounts = Array.isArray(raw.discount_list) ? cloneDeep(raw.discount_list) : [];
+              nextExtend = _objectSpread({}, nextTempOrder._extend || {});
+              delete nextExtend.originalSalesSnapshot;
+              nextTempOrder._extend = nextExtend;
+              nextTempOrder.products.forEach(function (product) {
+                if (product.metadata) {
+                  delete product.metadata.is_edit_for_runtime;
+                }
+              });
+              nextTempOrder.discount_list = restoredSessionDiscounts;
+              this.store.summary = createEmptySummary();
+              this.store.lastOrderInfo = undefined;
+              _context47.next = 20;
+              return (_this$store$discount20 = this.store.discount) === null || _this$store$discount20 === void 0 ? void 0 : _this$store$discount20.setOriginalDiscountList(cloneDeep(restoredSessionDiscounts));
+            case 20:
+              _context47.next = 22;
+              return (_this$store$discount21 = this.store.discount) === null || _this$store$discount21 === void 0 ? void 0 : _this$store$discount21.setDiscountList(cloneDeep(restoredSessionDiscounts));
+            case 22:
+              if (!(options !== null && options !== void 0 && options.recalcOnHydrate)) {
+                _context47.next = 25;
+                break;
+              }
+              _context47.next = 25;
+              return this.recalculateSummary({
+                createIfMissing: false
+              });
+            case 25:
+              this.persistTempOrder();
+              return _context47.abrupt("return", nextTempOrder);
+            case 27:
+              // Server list compatibility may synthesize order_id from external_sale_number; tempOrder must not.
+              sourceLastOrderInfo = sourceRaw.lastOrderInfo || sourceRaw;
               isDraftOrder = Number(nextTempOrder.is_draft_order || 0) === 1;
               syntheticIdentityOptions = {
                 isDraftOrder: isDraftOrder,
@@ -5905,7 +5988,6 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               summarySurcharges = Array.isArray(rawSummary.surcharges) ? rawSummary.surcharges.map(function (s) {
                 return _objectSpread({}, s || {});
               }) : cloneDeep(nextTempOrder.surcharges || []);
-              this.store.tempOrder = nextTempOrder;
               this.store.summary = _objectSpread(_objectSpread(_objectSpread({}, createEmptySummary()), rawSummary), {}, {
                 surcharges: summarySurcharges
               });
@@ -5926,7 +6008,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 this.store.syncState = 'local';
               }
               hydratedEditDiscounts = this.collectHydratedEditDiscounts(nextTempOrder.products);
-              currentDiscounts = typeof ((_this$store$discount20 = this.store.discount) === null || _this$store$discount20 === void 0 ? void 0 : _this$store$discount20.getDiscountList) === 'function' ? this.store.discount.getDiscountList() || [] : [];
+              currentDiscounts = typeof ((_this$store$discount22 = this.store.discount) === null || _this$store$discount22 === void 0 ? void 0 : _this$store$discount22.getDiscountList) === 'function' ? this.store.discount.getDiscountList() || [] : [];
               currentScanDiscounts = currentDiscounts.filter(function (discount) {
                 return discount === null || discount === void 0 ? void 0 : discount.isScan;
               });
@@ -5939,28 +6021,28 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               nextDiscounts = [].concat(_toConsumableArray(hydratedEditDiscounts), _toConsumableArray(retainedScanDiscounts));
               shouldSkipEmptyDiscountSync = nextDiscounts.length === 0 && currentDiscounts.length === 0;
               if (shouldSkipEmptyDiscountSync) {
-                _context47.next = 31;
+                _context47.next = 50;
                 break;
               }
               OrderModule.populateSavedAmounts(nextTempOrder.products, nextDiscounts);
-              _context47.next = 29;
-              return (_this$store$discount21 = this.store.discount) === null || _this$store$discount21 === void 0 ? void 0 : _this$store$discount21.setOriginalDiscountList(nextDiscounts);
-            case 29:
-              _context47.next = 31;
-              return (_this$store$discount22 = this.store.discount) === null || _this$store$discount22 === void 0 ? void 0 : _this$store$discount22.setDiscountList(nextDiscounts);
-            case 31:
+              _context47.next = 48;
+              return (_this$store$discount23 = this.store.discount) === null || _this$store$discount23 === void 0 ? void 0 : _this$store$discount23.setOriginalDiscountList(nextDiscounts);
+            case 48:
+              _context47.next = 50;
+              return (_this$store$discount24 = this.store.discount) === null || _this$store$discount24 === void 0 ? void 0 : _this$store$discount24.setDiscountList(nextDiscounts);
+            case 50:
               if (!(options !== null && options !== void 0 && options.recalcOnHydrate)) {
-                _context47.next = 34;
+                _context47.next = 53;
                 break;
               }
-              _context47.next = 34;
+              _context47.next = 53;
               return this.recalculateSummary({
                 createIfMissing: false
               });
-            case 34:
+            case 53:
               this.persistTempOrder();
               return _context47.abrupt("return", nextTempOrder);
-            case 36:
+            case 55:
             case "end":
               return _context47.stop();
           }

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

@@ -561,6 +561,10 @@ export interface LoadSalesDetailParams {
      * 存在时 loadSalesDetail 会跳过远端 lookup，直接复用 hydrate 后半段逻辑。
      */
     preloadedSalesDetail?: Record<string, any>;
+    /**
+     * sessionStorage 快照复用详情 hydrate 时使用；不带该值时保持既有编辑订单语义。
+     */
+    hydrateSource?: 'sessionStorage';
     forceRemote?: boolean;
     merge?: boolean;
 }
@@ -731,8 +735,10 @@ export interface OrderModuleAPI {
     removeProductFromOrder: (identity: OrderProductIdentity) => Promise<OrderProduct[]>;
     /** 批量删除购物车行，末尾仅触发一次促销重算与 summary 刷新 */
     removeProductsFromOrder: (identities: OrderProductIdentity[]) => Promise<OrderProduct[]>;
-    /** @deprecated no-op；OrderModule 不再负责 tempOrder localStorage 持久化。 */
+    /** 在显式开启时保存当前 tempOrder 的 sessionStorage 会话快照。 */
     persistTempOrder: () => void;
+    /** 取出一次待恢复的 sessionStorage tempOrder 快照。 */
+    consumeSessionStorageRestore: () => Record<string, any> | null;
     /**
      * 控制 IndexedDB 草稿（saveDraft）开关；localStorage tempOrder 持久化已废弃。
      * BigSale 弹窗等场景传 false 可跳过 saveDraft。
@@ -790,6 +796,7 @@ export interface OrderModuleAPI {
     saveDraft: () => Promise<void>;
     hydrateTempOrderFromRecord: (record: Record<string, any>, options?: {
         recalcOnHydrate?: boolean;
+        source?: 'salesDetail' | 'sessionStorage';
     }) => Promise<OrderTempOrder>;
     syncPaymentsToOrder: <T = any>(params: SyncPaymentsToOrderParams) => Promise<SyncPaymentsToOrderResult<T>>;
     getSalesOrderByLookup: (params: SalesOrderLookupParams) => Promise<any>;

package/dist/modules/Order/utils.js

@@ -1395,7 +1395,6 @@ export function productRequiresFormSubject(tempOrder, product) {
 }
 export function resolveIsFormSubject(tempOrder, product) {
   var _tempOrder$holder;
-  debugger;
   // 旧版预约维度的 holder 类型仍然生效；新版则从当前商品 holder_config 判断。
   if ((tempOrder === null || tempOrder === void 0 || (_tempOrder$holder = tempOrder.holder) === null || _tempOrder$holder === void 0 ? void 0 : _tempOrder$holder.type) === 'form') return true;
   if (product) return productRequiresFormSubject(tempOrder, product);

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

@@ -131,7 +131,9 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
      * const params = this.buildSubModuleOtherParams();
      * this.core.registerModule(orderModule, { otherParams: params });
      */
-    protected buildSubModuleOtherParams(): Record<string, any>;
+    protected isSessionStoragePersistEnabled(): boolean;
+    protected shouldUseSessionStorageForSubModule(_moduleName?: string): boolean;
+    protected buildSubModuleOtherParams(moduleName?: string): Record<string, any>;
     /**
      * 将父级 otherParams 的变更显式同步给已注册的子模块。
      *