@pisell/pisellos 0.10.3 → 0.10.4

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

@@ -11,6 +11,13 @@ export declare enum UnifiedBookingSalesHooks {
 export interface UnifiedBookingSalesState extends BookingTicketState {
     resourcePlanner: ResourcePlannerModule;
 }
+export interface UnifiedBookingSalesOtherParams extends Record<string, any> {
+    /**
+     * Persist the active order workspace in sessionStorage, partitioned by cacheId.
+     * Disabled by default and ignored when cacheId is missing.
+     */
+    enableSessionStoragePersist?: boolean;
+}
 /** Explicit OpenData target used by page-level UnifiedBookingSales skins. */
 export interface UnifiedBookingSalesLoadOpenDataParams {
     businessCode: string;

package/lib/model/strategy/adapter/promotion/index.js

@@ -0,0 +1,51 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/model/strategy/adapter/promotion/index.ts
+var promotion_exports = {};
+__export(promotion_exports, {
+  BUY_X_GET_Y_FREE_STRATEGY: () => import_examples.BUY_X_GET_Y_FREE_STRATEGY,
+  ITEM_REWARD_STRATEGY: () => import_examples.ITEM_REWARD_STRATEGY,
+  PromotionAdapter: () => import_adapter.PromotionAdapter,
+  PromotionEvaluator: () => import_evaluator.PromotionEvaluator,
+  X_ITEMS_FOR_Y_PRICE_STRATEGY: () => import_examples.X_ITEMS_FOR_Y_PRICE_STRATEGY,
+  default: () => import_adapter2.default
+});
+module.exports = __toCommonJS(promotion_exports);
+var import_evaluator = require("./evaluator");
+var import_adapter = require("./adapter");
+var import_adapter2 = __toESM(require("./adapter"));
+var import_examples = require("./examples");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BUY_X_GET_Y_FREE_STRATEGY,
+  ITEM_REWARD_STRATEGY,
+  PromotionAdapter,
+  PromotionEvaluator,
+  X_ITEMS_FOR_Y_PRICE_STRATEGY
+});

package/lib/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/lib/modules/BaseModule.js

@@ -34,6 +34,9 @@ var BaseModule = class {
     this.core.effects.offByModuleDestroy(this.name);
     this.core.unregisterModule(this);
   }
+  isRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+  }
   // 提供统一的缓存 module 里的数据的方法
   checkSaveCache({
     cacheId,
@@ -41,45 +44,29 @@ var BaseModule = class {
     store,
     cacheKey
   }) {
-    const window = this.core.getPlugin("window");
-    if (cacheId) {
+    if (!cacheId)
+      return;
+    try {
+      const window = this.core.getPlugin("window");
+      const sessionStorage = window == null ? void 0 : window.sessionStorage;
+      if (!sessionStorage)
+        return;
+      const storageKey = fatherModule || cacheId;
+      const rawCacheData = sessionStorage.getItem(storageKey);
+      const parsedCacheData = rawCacheData ? JSON.parse(rawCacheData) : {};
+      if (!this.isRecord(parsedCacheData))
+        return;
+      const cacheBucket = fatherModule ? this.isRecord(parsedCacheData[cacheId]) ? parsedCacheData[cacheId] : {} : parsedCacheData;
+      const moduleBucket = this.isRecord(cacheBucket[this.name]) ? cacheBucket[this.name] : {};
+      cacheKey.forEach((key) => {
+        moduleBucket[key] = store == null ? void 0 : store[key];
+      });
+      cacheBucket[this.name] = moduleBucket;
       if (fatherModule) {
-        const currentCacheData = window.sessionStorage.getItem(fatherModule);
-        let currentCacheDataObj = JSON.parse(currentCacheData || "{}");
-        if (!currentCacheData || !currentCacheDataObj[cacheId]) {
-          currentCacheDataObj = {
-            [cacheId]: {
-              [this.name]: {}
-            }
-          };
-        }
-        if (!currentCacheDataObj[cacheId][this.name]) {
-          currentCacheDataObj[cacheId][this.name] = {};
-        }
-        cacheKey.forEach((key) => {
-          currentCacheDataObj[cacheId][this.name][key] = store == null ? void 0 : store[key];
-        });
-        window.sessionStorage.setItem(
-          fatherModule,
-          JSON.stringify(currentCacheDataObj)
-        );
-      } else {
-        let currentCacheData = window.sessionStorage.getItem(cacheId);
-        let currentCacheDataObj = JSON.parse(currentCacheData || "{}");
-        if (!currentCacheDataObj) {
-          currentCacheDataObj = {};
-        }
-        if (!currentCacheDataObj[this.name]) {
-          currentCacheDataObj[this.name] = {};
-        }
-        cacheKey.forEach((key) => {
-          currentCacheDataObj[this.name][key] = store[key];
-        });
-        window.sessionStorage.setItem(
-          cacheId,
-          JSON.stringify(currentCacheDataObj)
-        );
+        parsedCacheData[cacheId] = cacheBucket;
       }
+      sessionStorage.setItem(storageKey, JSON.stringify(parsedCacheData));
+    } catch {
     }
   }
   effectsOn(eventType, callback) {

package/lib/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/lib/modules/Order/index.js

@@ -113,6 +113,9 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     super(name || "order", version);
     this.defaultName = "order";
     this.defaultVersion = "1.0.0";
+    this.openCache = false;
+    this.sessionStoragePersistEnabled = false;
+    this.sessionStorageRestoreRecord = null;
     // ─── 促销/赠品 ────────────────────────────────────
     /** 评估器引用；由 SalesSdkProvider 注入，未注入时 applyPromotion 静默跳过 */
     this.promotionEvaluator = null;
@@ -327,11 +330,32 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       return product;
     });
   }
+  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
+    );
+  }
   async initialize(core, options) {
     var _a, _b, _c, _d;
     this.core = core;
     this.store = options.store;
-    if (!this.store.tempOrder) {
+    const otherParams = options.otherParams || {};
+    this.syncSessionStorageOptions(otherParams);
+    if (this.sessionStoragePersistEnabled) {
+      const cachedTempOrder = this.store.tempOrder;
+      this.sessionStorageRestoreRecord = (0, import_utils.isTempOrder)(cachedTempOrder) ? (0, import_lodash_es.cloneDeep)(cachedTempOrder) : null;
+      this.store.tempOrder = null;
+      this.store.summary = (0, import_utils.createEmptySummary)();
+      this.store.availableWalletIds = [];
+      this.store.lastOrderInfo = void 0;
+      this.store.syncState = void 0;
+      this.store.discountList = [];
+    } else if (!this.store.tempOrder) {
       this.store.tempOrder = null;
     }
     if (!this.store.summary) {
@@ -348,8 +372,6 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     const app = (_a = appPlugin == null ? void 0 : appPlugin.getApp) == null ? void 0 : _a.call(appPlugin);
     this.logger = app == null ? void 0 : app.logger;
     this.window = this.core.getPlugin("window");
-    const otherParams = options.otherParams || {};
-    this.cacheId = otherParams.cacheId;
     this.salesSummaryModuleName = otherParams.salesSummaryModuleName;
     this.rulesHooksOverride = (_b = otherParams.rules) == null ? void 0 : _b.hooks;
     this.moduleHooksOverride = options.hooks;
@@ -360,6 +382,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
   }
   async destroy() {
     var _a, _b;
+    this.sessionStorageRestoreRecord = null;
     const childModules = [(_a = this.store) == null ? void 0 : _a.discount, (_b = this.store) == null ? void 0 : _b.rules];
     for (const childModule of childModules) {
       if (!childModule || typeof childModule.destroy !== "function")
@@ -389,7 +412,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
   updateOtherParams(params) {
     var _a, _b, _c;
     const otherParams = params || {};
-    this.cacheId = otherParams.cacheId;
+    this.syncSessionStorageOptions(otherParams);
     this.salesSummaryModuleName = otherParams.salesSummaryModuleName;
     this.rulesHooksOverride = (_a = otherParams.rules) == null ? void 0 : _a.hooks;
     this.orderHooks = this.moduleHooksOverride || ((_b = otherParams.order) == null ? void 0 : _b.hooks) || ((_c = otherParams.hooks) == null ? void 0 : _c.order);
@@ -434,14 +457,14 @@ var OrderModule = class extends import_BaseModule.BaseModule {
   // ─── Discount: 子模块注册 ───
   registerDiscountModules(options) {
     let targetCacheData = {};
-    if (this.cacheId && this.window) {
-      const sessionData = this.window.sessionStorage.getItem(this.name);
-      if (sessionData) {
-        try {
+    if (!this.sessionStoragePersistEnabled && this.openCache && this.cacheId && this.window) {
+      try {
+        const sessionData = this.window.sessionStorage.getItem(this.name);
+        if (sessionData) {
           const data = JSON.parse(sessionData);
           targetCacheData = (data == null ? void 0 : data[this.cacheId]) || {};
-        } catch {
         }
+      } catch {
       }
     }
     const discount = new import_Discount.DiscountModule(`${this.name}_discount`);
@@ -449,7 +472,8 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       initialState: targetCacheData == null ? void 0 : targetCacheData[discount.name],
       otherParams: {
         fatherModule: this.name,
-        openCache: !!this.cacheId,
+        // Unified 的单快照由 Order 管理；其他 Solution 保持原有 Discount 缓存语义。
+        openCache: this.openCache && !this.sessionStoragePersistEnabled,
         cacheId: this.cacheId
       }
     });
@@ -865,7 +889,8 @@ var OrderModule = class extends import_BaseModule.BaseModule {
   }
   /**
    * 控制 IndexedDB 草稿（saveDraft）是否写入。
-   * localStorage 版 tempOrder 持久化已废弃，此方法仅影响 saveDraft。
+   * 此开关仅影响 saveDraft；可选 sessionStorage 会话恢复由
+   * enableSessionStoragePersist 独立控制。
    *
    * @example
    * order.setEnableTempOrderPersist(false); // BigSale 弹窗：跳过 ~1s 的 dbUpdate
@@ -877,8 +902,24 @@ var OrderModule = class extends import_BaseModule.BaseModule {
   isTempOrderPersistEnabled() {
     return this.draftPersistEnabled;
   }
-  /** @deprecated OrderModule 不再负责 tempOrder localStorage 持久化；草稿保存请使用 IndexedDB saveDraft。 */
+  /**
+   * 在 UnifiedBookingSales 显式开启会话恢复时，将完整 tempOrder 写入
+   * sessionStorage 的 cacheId 分桶。写入失败由 BaseModule 静默降级。
+   */
   persistTempOrder() {
+    if (!this.sessionStoragePersistEnabled || !this.store.tempOrder)
+      return;
+    this.checkSaveCache({
+      cacheId: this.cacheId,
+      fatherModule: this.fatherModule,
+      store: { tempOrder: this.store.tempOrder },
+      cacheKey: ["tempOrder"]
+    });
+  }
+  consumeSessionStorageRestore() {
+    const record = this.sessionStorageRestoreRecord;
+    this.sessionStorageRestoreRecord = null;
+    return record ? (0, import_lodash_es.cloneDeep)(record) : null;
   }
   notifyTempOrderChanged() {
     if (!this.store.tempOrder)
@@ -1733,6 +1774,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
   restoreOrder() {
     var _a, _b;
     this.logInfo("restoreOrder start", {});
+    this.sessionStorageRestoreRecord = null;
     const freshTempOrder = this.createDefaultTempOrderInstance();
     this.ensureExternalSaleNumber(freshTempOrder);
     this.store.tempOrder = freshTempOrder;
@@ -1751,6 +1793,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     if (!(0, import_utils.isTempOrder)(tempOrder)) {
       throw new Error("无效的 tempOrder 数据");
     }
+    this.sessionStorageRestoreRecord = null;
     const nextTempOrder = this.normalizeTempOrderForRuntime(
       (0, import_lodash_es.cloneDeep)(tempOrder),
       { ensureIdentity: false }
@@ -4257,7 +4300,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
    * 例如数组字段、商品行唯一值、价格 metadata、summary 派生状态和 _extend。
    */
   async hydrateTempOrderFromRecord(record, options) {
-    var _a, _b, _c;
+    var _a, _b, _c, _d, _e;
     const sourceRaw = record && typeof record === "object" && record.data && record.order_id == null ? record.data : record || {};
     const identityReadySource = this.seedAnonymousBookingUidsFromProducts(
       sourceRaw
@@ -4287,8 +4330,37 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         );
       }
     }
-    const nextTempOrder = this.normalizeTempOrderForRuntime(raw, { makeEditMark: true });
-    const sourceLastOrderInfo = raw.lastOrderInfo || raw;
+    const isSessionStorageHydrate = (options == null ? void 0 : options.source) === "sessionStorage";
+    const nextTempOrder = this.normalizeTempOrderForRuntime(raw, {
+      makeEditMark: !isSessionStorageHydrate
+    });
+    this.store.tempOrder = nextTempOrder;
+    if (isSessionStorageHydrate) {
+      const restoredSessionDiscounts = Array.isArray(raw.discount_list) ? (0, import_lodash_es.cloneDeep)(raw.discount_list) : [];
+      const nextExtend = { ...nextTempOrder._extend || {} };
+      delete nextExtend.originalSalesSnapshot;
+      nextTempOrder._extend = nextExtend;
+      nextTempOrder.products.forEach((product) => {
+        if (product.metadata) {
+          delete product.metadata.is_edit_for_runtime;
+        }
+      });
+      nextTempOrder.discount_list = restoredSessionDiscounts;
+      this.store.summary = (0, import_utils.createEmptySummary)();
+      this.store.lastOrderInfo = void 0;
+      await ((_a = this.store.discount) == null ? void 0 : _a.setOriginalDiscountList(
+        (0, import_lodash_es.cloneDeep)(restoredSessionDiscounts)
+      ));
+      await ((_b = this.store.discount) == null ? void 0 : _b.setDiscountList(
+        (0, import_lodash_es.cloneDeep)(restoredSessionDiscounts)
+      ));
+      if (options == null ? void 0 : options.recalcOnHydrate) {
+        await this.recalculateSummary({ createIfMissing: false });
+      }
+      this.persistTempOrder();
+      return nextTempOrder;
+    }
+    const sourceLastOrderInfo = sourceRaw.lastOrderInfo || sourceRaw;
     const isDraftOrder = Number(nextTempOrder.is_draft_order || 0) === 1;
     const syntheticIdentityOptions = {
       isDraftOrder,
@@ -4296,7 +4368,6 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     };
     const rawSummary = raw.summary && typeof raw.summary === "object" ? raw.summary : {};
     const summarySurcharges = Array.isArray(rawSummary.surcharges) ? rawSummary.surcharges.map((s) => ({ ...s || {} })) : (0, import_lodash_es.cloneDeep)(nextTempOrder.surcharges || []);
-    this.store.tempOrder = nextTempOrder;
     this.store.summary = {
       ...(0, import_utils.createEmptySummary)(),
       ...rawSummary,
@@ -4323,7 +4394,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       this.store.syncState = "local";
     }
     const hydratedEditDiscounts = this.collectHydratedEditDiscounts(nextTempOrder.products);
-    const currentDiscounts = typeof ((_a = this.store.discount) == null ? void 0 : _a.getDiscountList) === "function" ? this.store.discount.getDiscountList() || [] : [];
+    const currentDiscounts = typeof ((_c = this.store.discount) == null ? void 0 : _c.getDiscountList) === "function" ? this.store.discount.getDiscountList() || [] : [];
     const currentScanDiscounts = currentDiscounts.filter((discount) => discount == null ? void 0 : discount.isScan);
     const hydratedDiscountIds = new Set(
       hydratedEditDiscounts.map((discount) => discount == null ? void 0 : discount.id)
@@ -4341,8 +4412,8 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         nextTempOrder.products,
         nextDiscounts
       );
-      await ((_b = this.store.discount) == null ? void 0 : _b.setOriginalDiscountList(nextDiscounts));
-      await ((_c = this.store.discount) == null ? void 0 : _c.setDiscountList(nextDiscounts));
+      await ((_d = this.store.discount) == null ? void 0 : _d.setOriginalDiscountList(nextDiscounts));
+      await ((_e = this.store.discount) == null ? void 0 : _e.setDiscountList(nextDiscounts));
     }
     if (options == null ? void 0 : options.recalcOnHydrate) {
       await this.recalculateSummary({ createIfMissing: false });

package/lib/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/lib/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 的变更显式同步给已注册的子模块。
      *

package/lib/solution/BaseSales/index.js

@@ -588,7 +588,7 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       });
     });
   }
-  async hydrateLatestLoadedSalesDetail(record, loadSequence) {
+  async hydrateLatestLoadedSalesDetail(record, loadSequence, hydrateSource) {
     let hydratedSales = null;
     let skippedBeforeHydrate = false;
     const hydrateTask = async () => {
@@ -598,9 +598,10 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       }
       if (!this.store.order)
         throw new Error("order 模块未初始化");
-      const sales = await this.store.order.hydrateTempOrderFromRecord(record, {
-        recalcOnHydrate: false
-      });
+      const sales = await this.store.order.hydrateTempOrderFromRecord(
+        record,
+        hydrateSource === "sessionStorage" ? { recalcOnHydrate: true, source: "sessionStorage" } : { recalcOnHydrate: false }
+      );
       hydratedSales = sales;
       if (loadSequence !== this.salesDetailLoadSequence)
         return;
@@ -891,12 +892,18 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
    * const params = this.buildSubModuleOtherParams();
    * this.core.registerModule(orderModule, { otherParams: params });
    */
-  buildSubModuleOtherParams() {
+  isSessionStoragePersistEnabled() {
+    return Boolean(this.cacheId);
+  }
+  shouldUseSessionStorageForSubModule(_moduleName) {
+    return this.isSessionStoragePersistEnabled();
+  }
+  buildSubModuleOtherParams(moduleName) {
     return {
       ...this.otherParams,
       salesSummaryModuleName: `${this.name}_salesSummary`,
       fatherModule: this.name,
-      openCache: this.cacheId ? true : false,
+      openCache: this.shouldUseSessionStorageForSubModule(moduleName),
       cacheId: this.cacheId
     };
   }
@@ -907,7 +914,6 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
    * await this.syncOtherParamsToSubModules({ channel: 'pos' });
    */
   async syncOtherParamsToSubModules(changedParams, { cover = false } = {}) {
-    const nextSubModuleOtherParams = this.buildSubModuleOtherParams();
     await Promise.all(
       Object.entries(this.store).map(async ([moduleName, subModule]) => {
         if (this.reusedSharedSubModuleNames.has(moduleName)) {
@@ -917,6 +923,7 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
         if (!targetModule || typeof targetModule.updateOtherParams !== "function") {
           return;
         }
+        const nextSubModuleOtherParams = this.buildSubModuleOtherParams(moduleName);
         await targetModule.updateOtherParams(nextSubModuleOtherParams, {
           changedParams,
           cover
@@ -929,14 +936,16 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
    * sessionStorage 损坏时静默忽略，按空状态注册。
    */
   readSessionCacheData() {
-    if (!this.cacheId || !this.window)
+    const cacheId = this.cacheId;
+    if (!cacheId || !this.isSessionStoragePersistEnabled() || !this.window) {
       return {};
+    }
     try {
       const sessionData = this.window.sessionStorage.getItem(this.name);
       if (!sessionData)
         return {};
       const data = JSON.parse(sessionData);
-      return data && data[this.cacheId] || {};
+      return data && data[cacheId] || {};
     } catch {
       return {};
     }
@@ -1038,9 +1047,9 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       const hooks = this.getSubModuleHooks(step);
       this.store[step] = targetModule;
       this.core.registerModule(targetModule, {
-        initialState: (targetCacheData == null ? void 0 : targetCacheData[targetModule.name]) || {},
+        initialState: this.shouldUseSessionStorageForSubModule(step) ? (targetCacheData == null ? void 0 : targetCacheData[targetModule.name]) || {} : {},
         ...hooks ? { hooks } : {},
-        otherParams: this.buildSubModuleOtherParams()
+        otherParams: this.buildSubModuleOtherParams(step)
       });
     });
     if (this.store.schedule && !this.isScheduleListLoaded(this.store.schedule)) {
@@ -1107,17 +1116,21 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
         const message = loadedRecord && (loadedRecord.message || loadedRecord.msg) || `加载销售详情失败: ${lookup}`;
         throw new Error(message);
       }
-      const remoteRecord = filterPendingPaymentsFromLoadedSalesDetail(
-        preloadedSalesDetail ?? loadedRecord.data
-      );
+      const loadedSalesDetail = preloadedSalesDetail ?? loadedRecord.data;
+      const shouldFilterPendingPayments = params.hydrateSource !== "sessionStorage";
+      const remoteRecord = shouldFilterPendingPayments ? filterPendingPaymentsFromLoadedSalesDetail(loadedSalesDetail) : loadedSalesDetail;
       const currentTempOrder = params.merge ? this.store.order.getTempOrder() : null;
       const mergedRecord = params.merge ? mergeSalesDetailRecordWithTempOrder(
         currentTempOrder,
         remoteRecord,
         "preserve-local"
       ) : remoteRecord;
-      const record = filterPendingPaymentsFromLoadedSalesDetail(mergedRecord);
-      return await this.hydrateLatestLoadedSalesDetail(record, loadSequence);
+      const record = shouldFilterPendingPayments ? filterPendingPaymentsFromLoadedSalesDetail(mergedRecord) : mergedRecord;
+      return await this.hydrateLatestLoadedSalesDetail(
+        record,
+        loadSequence,
+        params.hydrateSource
+      );
     } finally {
       this.salesDetailLoadInFlightCount = Math.max(
         0,

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

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

package/lib/solution/BookingTicket/index.d.ts

@@ -445,19 +445,7 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
      * 加车两阶段主决策（规格弹窗 / 资源编辑 / 直接加车）。
      * 与 ticketBooking `handleSelectProduct` + `handleBooking4Service` 等价。
      */
-    decideAddProduct(item: any, options?: Partial<AddProductDecideContext>): {
-        action: "reloadCatalog";
-    } | {
-        action: "add";
-        cacheItem: any;
-    } | {
-        action: "requiresDetail";
-        payload: AddProductRequiresDetailPayload;
-    } | {
-        action: "requiresBookingEdit";
-        cacheItem: any;
-        payload: import("./utils/addProductDecision").AddProductRequiresBookingEditPayload;
-    };
+    decideAddProduct(item: any, options?: Partial<AddProductDecideContext>): import("./utils/addProductDecision").AddProductDecision;
     /** 规格弹窗 callback 后的第二段决策。 */
     decideAfterDetail(cacheItem: any, options?: Partial<AddProductDecideContext>): import("./utils/addProductDecision").AddProductDecision;
     /**

package/lib/solution/UnifiedBookingSales/index.d.ts

@@ -63,6 +63,8 @@ export declare class UnifiedBookingSalesImpl extends BookingTicket {
     private openDataTarget;
     private loadOpenDataInFlight;
     private loadOpenDataInFlightTarget;
+    protected isSessionStoragePersistEnabled(): boolean;
+    protected shouldUseSessionStorageForSubModule(moduleName?: string): boolean;
     /**
      * Kiosk 不能把已收款订单留在本地等待重试：默认直接等待云端 checkout。
      * 兼容仍需要 WebPOS 待同步模式的入口可显式传 checkoutSyncTaskEnabled: true。
@@ -72,6 +74,7 @@ export declare class UnifiedBookingSalesImpl extends BookingTicket {
     protected getDefaultCheckoutSmallTicketDataFlag(): number;
     protected getRegisteredModuleNames(): readonly string[];
     protected createSubModule(moduleName: string): Module | null;
+    addNewOrder(): Promise<import("../../modules/Order/types").OrderTempOrder>;
     /**
      * Loads OpenData without borrowing BookingTicket. Cache ownership is tied to the exact
      * business/channel target so a reused solution instance cannot leak another entry's menus.