@pisell/pisellos 0.10.50 → 0.10.52

package/lib/solution/BaseSales/pickupTiming.js

@@ -0,0 +1,269 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.PickupTimingController = void 0;
+var _lodashEs = require("lodash-es");
+var _FulfillmentTiming = require("../../modules/FulfillmentTiming");
+async function withTimeout(request) {
+  let timer;
+  try {
+    return await Promise.race([request, new Promise((_, reject) => {
+      timer = setTimeout(() => reject(new Error('Unable to load pickup times. Please try again.')), 30000);
+    })]);
+  } finally {
+    if (timer !== undefined) clearTimeout(timer);
+  }
+}
+
+/** Reuses runtime configuration and schedules; every calculation still uses the live clock. */
+class PickupTimingController {
+  latest;
+  runtime;
+  writeSequence = 0;
+  constructor(host) {
+    this.host = host;
+  }
+  now() {
+    return this.host.now?.() ?? new Date();
+  }
+
+  /** A new solution context or an explicit settings refresh invalidates pending work too. */
+  invalidate() {
+    this.runtime = undefined;
+    this.latest = undefined;
+    this.writeSequence += 1;
+  }
+  assertCurrentRuntime(runtime) {
+    if (this.runtime !== runtime || runtime.scope !== this.host.getScope()) {
+      throw new Error('Store settings changed. Please try again.');
+    }
+  }
+  getRuntime() {
+    const scope = this.host.getScope();
+    if (this.runtime?.scope !== scope) {
+      this.latest = undefined;
+      this.runtime = {
+        scope
+      };
+    }
+    return this.runtime;
+  }
+  async loadConfig(runtime) {
+    if (runtime.config) return runtime.config;
+    if (!runtime.configRequest) {
+      const request = (async () => {
+        const config = (0, _FulfillmentTiming.normalizePickupTimingConfig)(await withTimeout(this.host.loadOpenData(false)));
+        this.assertCurrentRuntime(runtime);
+        runtime.config = config;
+        return config;
+      })();
+      runtime.configRequest = request;
+    }
+    const request = runtime.configRequest;
+    try {
+      return await request;
+    } finally {
+      if (runtime.configRequest === request) runtime.configRequest = undefined;
+    }
+  }
+  async loadSchedules(runtime, config) {
+    if (runtime.schedules) return runtime.schedules;
+    if (!runtime.scheduleRequest) {
+      const request = (async () => {
+        const schedule = this.host.getSchedule();
+        if (!schedule) throw new Error('Pickup schedule is unavailable. Please try again.');
+        // Reuse the catalog loaded by solution initialization, including its in-flight request.
+        await withTimeout(schedule.loadAllSchedule({
+          useCache: true
+        }));
+        this.assertCurrentRuntime(runtime);
+        const ids = [...new Set([...config.scheduleIds, ...(config.operatingHoursScheduleIds || [])])];
+        const schedules = (0, _lodashEs.cloneDeep)(schedule.getScheduleListByIds(ids) || []);
+        runtime.schedules = schedules;
+        return schedules;
+      })();
+      runtime.scheduleRequest = request;
+    }
+    const request = runtime.scheduleRequest;
+    try {
+      return await request;
+    } finally {
+      if (runtime.scheduleRequest === request) runtime.scheduleRequest = undefined;
+    }
+  }
+  async snapshot(includeSchedule, tolerateScheduleError = false) {
+    const runtime = this.getRuntime();
+    const config = await this.loadConfig(runtime);
+    this.assertCurrentRuntime(runtime);
+    let schedules = [];
+    let error;
+    if (includeSchedule && config.handoverModes.includes('pick_up') && config.timingMode !== 'asap_only' && config.scheduleIds.length) {
+      try {
+        schedules = await this.loadSchedules(runtime, config);
+      } catch (reason) {
+        if (!tolerateScheduleError) throw reason;
+        error = reason instanceof Error ? reason.message : 'Pickup schedule is unavailable. Please try again.';
+      }
+    }
+    this.assertCurrentRuntime(runtime);
+    const result = {
+      config,
+      timezone: this.host.getTimezone(),
+      schedules,
+      scope: runtime.scope,
+      error
+    };
+    this.latest = result;
+    return result;
+  }
+  async getAvailability(params = {}) {
+    // `force` remains accepted for older callers; refresh recomputes time using the runtime catalog.
+    const snapshot = await this.snapshot(true, true);
+    const now = this.now();
+    try {
+      return {
+        ...(0, _FulfillmentTiming.computePickupTimingAvailability)({
+          ...snapshot,
+          date: params.date,
+          now
+        }),
+        error: snapshot.error
+      };
+    } catch (reason) {
+      // Keep the handover selector usable when only Pickup's timezone is unavailable.
+      return {
+        config: snapshot.config,
+        timezone: snapshot.timezone,
+        now: now.toISOString(),
+        today: '',
+        maxDate: '',
+        date: params.date || '',
+        dates: [],
+        slots: [],
+        error: reason instanceof Error ? reason.message : 'Pickup times are unavailable. Please try again.'
+      };
+    }
+  }
+  getSelection() {
+    const order = this.host.getOrder();
+    const tempOrder = order.getTempOrder();
+    const booking = order.getPickupTimingBooking();
+    const config = this.latest?.scope === this.host.getScope() ? this.latest.config : undefined;
+    const storedServiceType = String(tempOrder?.metadata?.shop_service_data?.service_type || '');
+    const serviceType = config?.handoverModes.length ? config.handoverModes.includes(storedServiceType) ? storedServiceType : config.handoverModes[0] : storedServiceType;
+    const details = serviceType === 'pick_up' ? booking?.metadata.fulfillment_timing : undefined;
+    const mode = config?.timingMode === 'asap_only' ? 'asap' : config?.timingMode === 'scheduled_only' ? 'scheduled' : details?.mode ?? 'asap';
+    const sameMode = details?.mode === mode;
+    return {
+      serviceType,
+      mode,
+      source: mode === 'asap' ? 'asap' : sameMode && details?.source || 'schedule',
+      ...(sameMode && booking ? {
+        date: booking.start_date,
+        time: booking.start_time,
+        instant: details?.instant
+      } : {})
+    };
+  }
+  async validateSnapshot(selection) {
+    const snapshot = await this.snapshot(selection.serviceType === 'pick_up' && selection.mode === 'scheduled' && selection.source !== 'pos_manual');
+    const now = this.now();
+    const result = (0, _FulfillmentTiming.validatePickupTimingSelection)(selection, {
+      ...snapshot,
+      now,
+      allowManualOverride: this.host.isPos()
+    });
+    return {
+      snapshot,
+      now,
+      result
+    };
+  }
+  async validate(selection) {
+    return (await this.validateSnapshot(selection)).result;
+  }
+  async setSelection(selection, options = {}) {
+    const order = this.host.getOrder();
+    const tempOrder = order.ensureTempOrder();
+    const sequence = ++this.writeSequence;
+    const {
+      snapshot,
+      now,
+      result
+    } = await this.validateSnapshot(selection);
+    if (sequence !== this.writeSequence || order.getTempOrder() !== tempOrder || snapshot.scope !== this.host.getScope()) {
+      throw new Error('The order changed. Please choose the pickup time again.');
+    }
+    if (!result.valid) throw new Error(result.message || 'Please choose a valid pickup time.');
+    if (!snapshot.config.handoverModes.length) {
+      order.clearPickupTimingBooking();
+      return this.getSelection();
+    }
+    if (selection.serviceType !== 'pick_up') {
+      order.updateTempOrderServiceType(selection.serviceType);
+      return this.getSelection();
+    }
+    const slot = selection.mode === 'asap' ? (0, _FulfillmentTiming.getAsapPickupTiming)({
+      ...snapshot,
+      now
+    }) : result.slot;
+    if (!slot) throw new Error('Please choose a pickup time.');
+    // Validate everything before either field is changed; notify once after the combined update.
+    tempOrder.metadata = {
+      ...(tempOrder.metadata || {}),
+      shop_service_data: {
+        ...(tempOrder.metadata?.shop_service_data || {}),
+        service_type: 'pick_up'
+      }
+    };
+    order.setPickupTimingBooking({
+      mode: selection.mode,
+      source: selection.mode === 'asap' ? 'asap' : selection.source === 'pos_manual' ? 'pos_manual' : 'schedule',
+      date: slot.date,
+      time: slot.time,
+      instant: slot.instant,
+      timezone: snapshot.timezone,
+      frozen: options.frozen ?? false
+    });
+    return this.getSelection();
+  }
+
+  /** Called before a new checkout/payment; payment callbacks keep their already prepared appointment. */
+  async prepare(options = {}) {
+    const order = this.host.getOrder();
+    const tempOrder = order.getTempOrder();
+    const sequence = this.writeSequence;
+    if (order.getOrderIdentity()?.isSubmitted) return this.getSelection();
+    const booking = order.getPickupTimingBooking();
+    if (booking?.metadata.fulfillment_timing?.frozen) return this.getSelection();
+    // An actual payment callback must never revalidate or move the time after funds have been taken.
+    const paymentStatus = order.getTempOrder()?.payment_status;
+    if (paymentStatus === 'paid' || paymentStatus === 'partially_paid') {
+      if (booking?.metadata.fulfillment_timing) {
+        const detail = booking.metadata.fulfillment_timing;
+        order.setPickupTimingBooking({
+          ...detail,
+          date: booking.start_date,
+          time: booking.start_time,
+          frozen: true
+        });
+      }
+      return this.getSelection();
+    }
+    const snapshot = await this.snapshot(false);
+    if (order !== this.host.getOrder() || order.getTempOrder() !== tempOrder || sequence !== this.writeSequence) {
+      throw new Error('The order changed. Please choose the pickup time again.');
+    }
+    const selection = this.getSelection();
+    if (!snapshot.config.handoverModes.length) {
+      order.clearPickupTimingBooking();
+      return selection;
+    }
+    return this.setSelection(selection, {
+      frozen: options.freeze ?? false
+    });
+  }
+}
+exports.PickupTimingController = PickupTimingController;

package/lib/solution/BaseSales/utils/parseSalesResponse.js

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.parseSalesResponse = parseSalesResponse;
 var _orderCollectionIdentity = require("../../../modules/Order/utils/orderCollectionIdentity");
+var _pickupTiming = require("../../../modules/Order/pickupTiming");
 /**
  * 把 `/order/sales/{id}` 响应（OrderData）解析为 ISalesDetail。
  *
@@ -64,6 +65,7 @@ function pickCustomer(raw) {
  */
 function isRootBooking(booking) {
   if (!booking || typeof booking !== 'object') return false;
+  if ((0, _pickupTiming.isFulfillmentTimingBooking)(booking)) return false;
   const parentId = booking.parent_id;
   if (parentId === 0 || parentId === null || parentId === undefined) return true;
   return false;
@@ -71,6 +73,7 @@ function isRootBooking(booking) {
 function indexBookingsByProductUid(bookings) {
   const result = {};
   for (const b of bookings) {
+    if ((0, _pickupTiming.isFulfillmentTimingBooking)(b)) continue;
     const uid = b && (b.product_uid || b.metadata?.product_uid) || '';
     if (!uid) continue;
     const key = String(uid);

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 | 3 | 4 | 5 | 6;
+        weekNum: 0 | 2 | 1 | 5 | 4 | 3 | 6;
     }[]>;
     submitTimeSlot(timeSlots: TimeSliceItem): void;
     private getScheduleDataByIds;

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

@@ -52,10 +52,10 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
      * 在解决方案对外 ready 前准备 Invoice Document；失败只降级模板，不阻断销售。
      * 已由页面取得的 OpenData 直接交给模块接管，没有注入数据时再走 target-scoped 加载。
      */
-    private prepareInvoiceTemplateAtSolutionReady;
+    protected prepareInvoiceTemplateAtSolutionReady(injectedOpenData?: OpenDataConfig): Promise<void>;
     protected getBookingTicketBusinessCode(): string | null;
     private getIdGeneratorPlugin;
-    private loadOpenDataConfig;
+    protected loadOpenDataConfig(): Promise<OpenDataConfig | null>;
     getOpenData(): Promise<OpenDataConfig | null>;
     getInvoiceLayoutConfig(): Promise<InvoiceLayoutConfig>;
     getInvoiceTemplateSettings(): Promise<InvoiceTemplateSettings>;

package/lib/solution/BookingTicket/utils/cartView.js

@@ -8,12 +8,14 @@ exports.buildCustomerView = buildCustomerView;
 exports.indexBookingsByProductUid = indexBookingsByProductUid;
 exports.isWalkInCustomer = isWalkInCustomer;
 var _addTimeAvailability = require("./addTimeAvailability");
+var _pickupTiming = require("../../../modules/Order/pickupTiming");
 /**
  * 仅按 booking.product_uid 建索引，避免发明 booking 与商品行之间的其它等价关系。
  */
 function indexBookingsByProductUid(bookings) {
   if (!Array.isArray(bookings) || bookings.length === 0) return {};
   return bookings.reduce((acc, booking) => {
+    if ((0, _pickupTiming.isFulfillmentTimingBooking)(booking)) return acc;
     const uid = booking?.product_uid;
     if (uid === undefined || uid === null || uid === '') return acc;
     const key = String(uid);
@@ -105,7 +107,7 @@ function isGiftProductLine(line) {
 function buildCartView(lines, bookings, options = {}) {
   const productLines = Array.isArray(lines) ? lines : [];
   const bookingList = Array.isArray(bookings) ? bookings : [];
-  const childBookings = bookingList.filter(booking => booking.parent_id !== 0);
+  const childBookings = bookingList.filter(booking => booking.parent_id !== 0 && !(0, _pickupTiming.isFulfillmentTimingBooking)(booking));
   const bookingsByProductUid = indexBookingsByProductUid(childBookings);
   const linesByUid = indexProductsByUid(productLines);
   const addTimeLinesByBookingUid = indexAddTimeProductsByBookingUid(productLines);

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

@@ -59,6 +59,13 @@ export declare class UnifiedBookingSalesImpl extends BookingTicket {
     protected defaultName: string;
     protected defaultVersion: string;
     protected store: UnifiedBookingSalesState;
+    protected pickupTimingEnabled: boolean;
+    private runtimeOpenDataScope;
+    private runtimeOpenDataSnapshot;
+    private runtimeOpenDataModule;
+    private runtimeOpenDataCore;
+    private runtimeOpenDataGeneration;
+    private runtimeOpenDataDestroyed;
     private unifiedProductCatalog;
     private availabilityRuntimeOffsetMinutes;
     private availabilityScheduleCatalog;
@@ -142,12 +149,14 @@ export declare class UnifiedBookingSalesImpl extends BookingTicket {
     private resolveDiscountAction;
     private resetCachedCustomerDiscountState;
     private refreshLegacySessionCustomerDiscounts;
-    /**
-     * 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.
-     */
+    private getRuntimeOpenDataScope;
+    private resetRuntimeOpenData;
+    protected prepareInvoiceTemplateAtSolutionReady(injectedOpenData?: OpenDataConfig): Promise<void>;
+    protected loadOpenDataConfig(): Promise<OpenDataConfig | null>;
+    /** A successful configuration belongs to this business runtime until an explicit refresh. */
     loadOpenData(params: UnifiedBookingSalesLoadOpenDataParams): Promise<OpenDataConfig>;
     getOpenData(): Promise<OpenDataConfig | null>;
+    protected loadPickupTimingOpenData(_force: boolean): Promise<Record<string, unknown>>;
     private resetAllergyItemRuleState;
     private fetchAllergyItemRuleConfigs;
     private ensureAllergyItemRuleConfigsLoaded;

package/lib/solution/UnifiedBookingSales/index.js

@@ -55,7 +55,6 @@ var _platform = require("../../utils/platform");
 var _itemRule = require("../../model/strategy/adapter/itemRule");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 const OPEN_DATA_SECTION_CODES = ['sale', 'reservation', 'fulfillment', 'menu', 'workflow', 'basic', 'checkout', 'availability', 'documents'];
-const OPEN_DATA_CACHE_TTL = 5 * 60 * 1000;
 function normalizePositiveInteger(value) {
   const normalized = Number(value);
   if (!Number.isInteger(normalized) || normalized <= 0) return undefined;
@@ -1199,6 +1198,13 @@ class UnifiedBookingSalesImpl extends _BookingTicket.BookingTicket {
   defaultName = 'unifiedBookingSales';
   defaultVersion = '1.0.0';
   store = {};
+  pickupTimingEnabled = true;
+  runtimeOpenDataScope = null;
+  runtimeOpenDataSnapshot = null;
+  runtimeOpenDataModule = null;
+  runtimeOpenDataCore;
+  runtimeOpenDataGeneration = 0;
+  runtimeOpenDataDestroyed = false;
   unifiedProductCatalog = [];
   availabilityRuntimeOffsetMinutes = null;
   availabilityScheduleCatalog = null;
@@ -1218,16 +1224,16 @@ class UnifiedBookingSalesImpl extends _BookingTicket.BookingTicket {
   allergyItemRuleConfigs = [];
   allergyItemRuleConfigsPromise = null;
   async initialize(core, options = {}) {
+    this.resetRuntimeOpenData();
+    this.runtimeOpenDataDestroyed = false;
+    const openDataGeneration = this.runtimeOpenDataGeneration;
     this.availabilityScheduleCatalog = null;
-    this.openDataTarget = null;
     this.availabilityRuntimeOffsetMinutes = (0, _localClock.captureRuntimeOffsetMinutes)();
     this.clearAvailabilityRemoteResourceState();
     this.resetAllergyItemRuleState();
     await super.initialize(core, options);
-    const openDataBusinessCode = String(this.otherParams?.businessCode ?? this.otherParams?.business_code ?? '').trim();
-    const openDataChannel = String(this.otherParams?.channel ?? '').trim();
-    if (this.otherParams?.openData && openDataBusinessCode && openDataChannel) {
-      this.openDataTarget = `${openDataBusinessCode}+${openDataChannel}`;
+    if (this.runtimeOpenDataDestroyed || openDataGeneration !== this.runtimeOpenDataGeneration) {
+      throw new Error('Store settings changed. Please try again.');
     }
     this.captureAvailabilityScheduleCatalog();
   }
@@ -1305,7 +1311,7 @@ class UnifiedBookingSalesImpl extends _BookingTicket.BookingTicket {
     const businessCode = String(this.otherParams?.businessCode ?? this.otherParams?.business_code ?? '').trim();
     const channel = String(this.otherParams?.channel ?? '').trim();
     const currentTarget = businessCode && channel ? `${businessCode}+${channel}` : null;
-    let openData = !currentTarget || this.openDataTarget === currentTarget ? this.otherParams?.openData : null;
+    let openData = (!currentTarget || this.openDataTarget === currentTarget) && (this.runtimeOpenDataScope === null || this.runtimeOpenDataScope === this.getRuntimeOpenDataScope()) ? this.otherParams?.openData : null;
     if (!openData && this.store.openData) {
       try {
         openData = await this.getOpenData();
@@ -1369,6 +1375,13 @@ class UnifiedBookingSalesImpl extends _BookingTicket.BookingTicket {
     const previousScope = this.getAvailabilityScopeDescriptor(this.otherParams || {});
     const previousItemRuleConfig = this.otherParams?.itemRule;
     const explicitlySetsOpenData = Object.prototype.hasOwnProperty.call(params, 'openData');
+    const nextParams = cover ? params : {
+      ...this.otherParams,
+      ...params
+    };
+    if (explicitlySetsOpenData || this.getRuntimeOpenDataScope() !== this.getRuntimeOpenDataScope(nextParams)) {
+      this.clearOpenDataCache();
+    }
     await super.setOtherParams(params, {
       cover
     });
@@ -1385,6 +1398,8 @@ class UnifiedBookingSalesImpl extends _BookingTicket.BookingTicket {
     }
   }
   async destroy() {
+    this.runtimeOpenDataDestroyed = true;
+    this.clearOpenDataCache();
     this.availabilityScheduleCatalog = null;
     this.availabilityRuntimeOffsetMinutes = null;
     await this.resetAvailabilityProjectionState('destroy');
@@ -1685,52 +1700,117 @@ class UnifiedBookingSalesImpl extends _BookingTicket.BookingTicket {
       action: this.resolveDiscountAction(this.resolveDiscountOrderIdentity(tempOrder))
     });
   }
+  getRuntimeOpenDataScope(otherParams = this.otherParams) {
+    return JSON.stringify({
+      shop: this.getPickupTimingContextData('shop_id'),
+      appShop: this.appPlugin ? this.getAppData('shop_id') : undefined,
+      tenant: this.appPlugin ? this.getAppData('tenant_id') : undefined,
+      businessCode: String(otherParams?.businessCode ?? otherParams?.business_code ?? '').trim(),
+      channel: String(otherParams?.channel || super.getSubmitOrderSalesChannel()).trim(),
+      platform: (0, _platform.normalizeRuntimePlatform)(otherParams?.platform),
+      timezone: this.getPickupTimingContextData('timezone'),
+      businessTimezone: otherParams?.businessTimezone,
+      cacheId: otherParams === this.otherParams ? this.cacheId : otherParams?.cacheId
+    });
+  }
+  resetRuntimeOpenData() {
+    this.runtimeOpenDataGeneration += 1;
+    this.runtimeOpenDataScope = null;
+    this.runtimeOpenDataSnapshot = null;
+    this.runtimeOpenDataModule = null;
+    this.runtimeOpenDataCore = undefined;
+    this.openDataTarget = null;
+    this.loadOpenDataInFlight = null;
+    this.loadOpenDataInFlightTarget = null;
+    this.otherParams = {
+      ...this.otherParams,
+      openData: null
+    };
+    this.store.openData?.clearCache?.();
+  }
+  async prepareInvoiceTemplateAtSolutionReady(injectedOpenData) {
+    const businessCode = this.getBookingTicketBusinessCode();
+    if (!businessCode || !this.store.openData) return;
+    if (injectedOpenData) {
+      this.otherParams.openData = injectedOpenData;
+      this.openDataTarget = `${businessCode}+${this.getSubmitOrderSalesChannel()}`;
+    }
+    try {
+      await this.loadOpenDataConfig();
+    } catch (error) {
+      console.warn('[UnifiedBookingSales] Invoice 模板预加载失败，使用默认配置', error);
+    }
+  }
+  async loadOpenDataConfig() {
+    const businessCode = this.getBookingTicketBusinessCode();
+    if (!businessCode) return null;
+    return this.loadOpenData({
+      businessCode,
+      channel: this.getSubmitOrderSalesChannel()
+    });
+  }
 
-  /**
-   * 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.
-   */
+  /** A successful configuration belongs to this business runtime until an explicit refresh. */
   async loadOpenData(params) {
-    if (!this.store.openData) {
+    const module = this.store.openData;
+    if (!module) {
       throw new Error('[UnifiedBookingSales] openData 模块未初始化');
     }
+    if (this.runtimeOpenDataDestroyed) {
+      throw new Error('Store settings changed. Please try again.');
+    }
     const businessCode = String(params.businessCode || '').trim();
     const channel = String(params.channel || '').trim();
     if (!businessCode || !channel) {
       throw new Error('[UnifiedBookingSales] OpenData 需要 businessCode 与 channel');
     }
     const target = `${businessCode}+${channel}`;
-    const cachedData = this.store.openData.getOpenData();
-    const lastFetchedAt = this.store.openData.getLastFetchedAt();
-    if (!params.force && this.openDataTarget === target && cachedData && lastFetchedAt && Date.now() - lastFetchedAt < OPEN_DATA_CACHE_TTL) {
-      if (typeof this.store.openData.ensureInvoiceTemplateSettings === 'function') {
-        await this.store.openData.ensureInvoiceTemplateSettings(target);
+    this.otherParams.businessCode = businessCode;
+    this.otherParams.channel = channel;
+    const scope = this.getRuntimeOpenDataScope();
+    if (params.force) {
+      this.clearOpenDataCache();
+    }
+    if (this.runtimeOpenDataScope !== scope || this.runtimeOpenDataModule !== module || this.runtimeOpenDataCore !== this.core) {
+      // Only the first, explicitly injected target may seed a new runtime snapshot.
+      const injectedOpenData = this.runtimeOpenDataScope === null && (!this.openDataTarget || this.openDataTarget === target) && isRecord(this.otherParams.openData) ? this.otherParams.openData : null;
+      if (this.runtimeOpenDataScope !== null) {
+        // The caller's Pickup Timing scope already changes with this runtime scope.
+        this.resetRuntimeOpenData();
       }
-      return cachedData;
+      this.runtimeOpenDataScope = scope;
+      this.runtimeOpenDataModule = module;
+      this.runtimeOpenDataCore = this.core;
+      this.runtimeOpenDataSnapshot = injectedOpenData;
     }
     if (this.loadOpenDataInFlight) {
-      if (this.loadOpenDataInFlightTarget === target) {
-        return await this.loadOpenDataInFlight;
+      return this.loadOpenDataInFlight;
+    }
+    const generation = this.runtimeOpenDataGeneration;
+    const core = this.core;
+    const request = (async () => {
+      let openData = this.runtimeOpenDataSnapshot;
+      if (openData) {
+        await module.ensureInvoiceTemplateSettings?.(target, openData);
+      } else {
+        openData = await module.fetchOpenData({
+          scope: 'board',
+          target,
+          section_code: [...OPEN_DATA_SECTION_CODES]
+        });
       }
-      await this.loadOpenDataInFlight;
-      return this.loadOpenData(params);
-    }
+      if (this.runtimeOpenDataDestroyed || generation !== this.runtimeOpenDataGeneration || scope !== this.getRuntimeOpenDataScope() || module !== this.store.openData || core !== this.core) {
+        throw new Error('Store settings changed. Please try again.');
+      }
+      this.runtimeOpenDataSnapshot = openData;
+      this.openDataTarget = target;
+      this.otherParams.openData = openData;
+      return openData;
+    })();
     this.loadOpenDataInFlightTarget = target;
-    const request = this.store.openData.fetchOpenData({
-      scope: 'board',
-      target,
-      section_code: [...OPEN_DATA_SECTION_CODES]
-    });
     this.loadOpenDataInFlight = request;
     try {
-      const openData = await request;
-      if (this.loadOpenDataInFlight === request) {
-        this.openDataTarget = target;
-        this.otherParams.openData = openData;
-        this.otherParams.businessCode = businessCode;
-        this.otherParams.channel = channel;
-      }
-      return openData;
+      return await request;
     } finally {
       if (this.loadOpenDataInFlight === request) {
         this.loadOpenDataInFlight = null;
@@ -1739,13 +1819,19 @@ class UnifiedBookingSalesImpl extends _BookingTicket.BookingTicket {
     }
   }
   async getOpenData() {
-    const businessCode = String(this.otherParams?.businessCode || '').trim();
-    const channel = String(this.otherParams?.channel || '').trim();
-    if (!businessCode || !channel) return null;
-    return this.loadOpenData({
+    return this.loadOpenDataConfig();
+  }
+  async loadPickupTimingOpenData(_force) {
+    const scope = this.getPickupTimingScope();
+    const businessCode = String(this.otherParams?.businessCode ?? this.otherParams?.business_code ?? '').trim();
+    const config = await this.loadOpenData({
       businessCode,
-      channel
+      channel: this.getSubmitOrderSalesChannel()
     });
+    if (scope !== this.getPickupTimingScope()) {
+      throw new Error('Store settings changed. Please try again.');
+    }
+    return config;
   }
   resetAllergyItemRuleState() {
     this.allergyItemRuleConfigs = [];
@@ -1840,10 +1926,8 @@ class UnifiedBookingSalesImpl extends _BookingTicket.BookingTicket {
     });
   }
   clearOpenDataCache() {
-    this.openDataTarget = null;
-    this.loadOpenDataInFlight = null;
-    this.loadOpenDataInFlightTarget = null;
-    super.clearOpenDataCache();
+    this.resetRuntimeOpenData();
+    this.resetPickupTimingCache();
   }
   async getInvoiceLayoutConfig() {
     const openData = await this.getOpenData();
@@ -1863,7 +1947,7 @@ class UnifiedBookingSalesImpl extends _BookingTicket.BookingTicket {
     const businessCode = String(this.otherParams?.businessCode || '').trim();
     const channel = String(this.otherParams?.channel || '').trim();
     if (!businessCode || !channel) return false;
-    return this.openDataTarget === `${businessCode}+${channel}`;
+    return this.openDataTarget === `${businessCode}+${channel}` && this.runtimeOpenDataScope === this.getRuntimeOpenDataScope();
   }
 
   /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "private": false,
   "name": "@pisell/pisellos",
-  "version": "0.10.50",
+  "version": "0.10.52",
   "description": "一个可扩展的前端模块化SDK框架，支持插件系统",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",