@pisell/pisellos 0.10.49 → 0.10.51

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

@@ -1 +1,46 @@
-"use strict";
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "BUY_X_GET_Y_FREE_STRATEGY", {
+  enumerable: true,
+  get: function () {
+    return _examples.BUY_X_GET_Y_FREE_STRATEGY;
+  }
+});
+Object.defineProperty(exports, "ITEM_REWARD_STRATEGY", {
+  enumerable: true,
+  get: function () {
+    return _examples.ITEM_REWARD_STRATEGY;
+  }
+});
+Object.defineProperty(exports, "PromotionAdapter", {
+  enumerable: true,
+  get: function () {
+    return _adapter.PromotionAdapter;
+  }
+});
+Object.defineProperty(exports, "PromotionEvaluator", {
+  enumerable: true,
+  get: function () {
+    return _evaluator.PromotionEvaluator;
+  }
+});
+Object.defineProperty(exports, "X_ITEMS_FOR_Y_PRICE_STRATEGY", {
+  enumerable: true,
+  get: function () {
+    return _examples.X_ITEMS_FOR_Y_PRICE_STRATEGY;
+  }
+});
+Object.defineProperty(exports, "default", {
+  enumerable: true,
+  get: function () {
+    return _adapter.default;
+  }
+});
+var _evaluator = require("./evaluator");
+var _adapter = _interopRequireWildcard(require("./adapter"));
+var _examples = require("./examples");
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }

package/lib/modules/Discount/types.d.ts

@@ -44,6 +44,7 @@ interface ApplicableProductDetails {
     original_amount: string;
     num: number;
     metadata?: {
+        encoded?: string;
         product_discount_difference?: number;
         /** 月卡扣除本单新增使用后的剩余次数；不限次数时为 null。 */
         balance?: number | null;
@@ -135,6 +136,7 @@ export interface Discount {
     available_products_info?: any[];
     format_title: Formattitle;
     metadata?: {
+        encoded?: string;
         discount_card_type?: 'fixed_amount' | 'percent';
         custom_product_bundle_map_id?: string;
         validity_type?: 'custom_schedule_validity' | 'fixed_validity';

package/lib/modules/FulfillmentTiming/index.d.ts

@@ -0,0 +1,11 @@
+import type { PickupTimingAvailability, PickupTimingBookingTimes, PickupTimingClockInput, PickupTimingComputeInput, PickupTimingConfig, PickupTimingSelection, PickupTimingSlot, PickupTimingValidationResult } from './types';
+export * from './types';
+/** Consume effective OpenData values only; legacy switches never enable Pickup. */
+export declare function normalizePickupTimingConfig(openData: Record<string, unknown>): PickupTimingConfig;
+export declare function resolvePickupTimingDateTime(date: string, time: string, timezone: string, instant?: string): PickupTimingSlot | undefined;
+export declare function getAsapPickupTiming({ config, timezone, now }: PickupTimingClockInput): PickupTimingSlot;
+export declare function pickupTimingSlotToBookingTimes(slot: PickupTimingSlot): PickupTimingBookingTimes;
+export declare function computePickupTimingAvailability(input: PickupTimingComputeInput): PickupTimingAvailability;
+export declare function validatePickupTimingSelection(selection: PickupTimingSelection, input: PickupTimingComputeInput & {
+    allowManualOverride?: boolean;
+}): PickupTimingValidationResult;

package/lib/modules/FulfillmentTiming/index.js

@@ -0,0 +1,359 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _exportNames = {
+  normalizePickupTimingConfig: true,
+  resolvePickupTimingDateTime: true,
+  getAsapPickupTiming: true,
+  pickupTimingSlotToBookingTimes: true,
+  computePickupTimingAvailability: true,
+  validatePickupTimingSelection: true
+};
+exports.computePickupTimingAvailability = computePickupTimingAvailability;
+exports.getAsapPickupTiming = getAsapPickupTiming;
+exports.normalizePickupTimingConfig = normalizePickupTimingConfig;
+exports.pickupTimingSlotToBookingTimes = pickupTimingSlotToBookingTimes;
+exports.resolvePickupTimingDateTime = resolvePickupTimingDateTime;
+exports.validatePickupTimingSelection = validatePickupTimingSelection;
+var _dayjs = _interopRequireDefault(require("dayjs"));
+var _isSameOrAfter = _interopRequireDefault(require("dayjs/plugin/isSameOrAfter"));
+var _isSameOrBefore = _interopRequireDefault(require("dayjs/plugin/isSameOrBefore"));
+var _getDateIsInSchedule = require("../Schedule/getDateIsInSchedule");
+var _types = require("./types");
+Object.keys(_types).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _types[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _types[key];
+    }
+  });
+});
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+// The shared Schedule resolver uses these comparisons without registering them.
+_dayjs.default.extend(_isSameOrAfter.default);
+_dayjs.default.extend(_isSameOrBefore.default);
+const MINUTE = 60_000;
+const DAY = 24 * 60 * MINUTE;
+const integerSetting = (value, min, max, fallback) => typeof value === 'number' && Number.isInteger(value) && value >= min && value <= max ? value : fallback;
+
+/** Consume effective OpenData values only; legacy switches never enable Pickup. */
+function normalizePickupTimingConfig(openData) {
+  const handovers = openData['fulfillment.handover_mode'];
+  const scheduleIds = openData['fulfillment.pickup.schedule'];
+  const operatingHoursScheduleIds = openData['availability.operating_hours'];
+  const mode = openData['fulfillment.pickup.timing_mode'];
+  return {
+    handoverModes: Array.isArray(handovers) ? [...new Set(handovers.filter(value => typeof value === 'string' && value.length > 0))] : [],
+    timingMode: mode === 'scheduled_only' || mode === 'asap_and_scheduled' ? mode : 'asap_only',
+    scheduleIds: Array.isArray(scheduleIds) ? [...new Set(scheduleIds.filter(value => typeof value === 'number' && Number.isInteger(value) && value > 0))] : [],
+    operatingHoursScheduleIds: Array.isArray(operatingHoursScheduleIds) ? [...new Set(operatingHoursScheduleIds.map(value => typeof value === 'number' || typeof value === 'string' ? Number(value) : NaN).filter(value => Number.isInteger(value) && value > 0))] : [],
+    slotIntervalMinutes: integerSetting(openData['fulfillment.pickup.slot_interval_minutes'], 1, 1440, 15),
+    preparationTimeMinutes: integerSetting(openData['fulfillment.pickup.preparation_time_minutes'], 0, 1440, 0),
+    advanceDays: integerSetting(openData['fulfillment.pickup.advance_days'], 0, 365, 7),
+    fulfillmentRefMode: typeof openData['fulfillment.fulfillment_ref_mode'] === 'string' ? openData['fulfillment.fulfillment_ref_mode'] : undefined,
+    manualInputType: typeof openData['fulfillment.manual_input_type'] === 'string' ? openData['fulfillment.manual_input_type'] : undefined
+  };
+}
+function dateStamp(date) {
+  if (!/^\d{4}-\d{2}-\d{2}$/.test(date)) return NaN;
+  const value = Date.parse(`${date}T00:00:00Z`);
+  return Number.isFinite(value) && new Date(value).toISOString().slice(0, 10) === date ? value : NaN;
+}
+function addDays(date, days) {
+  return new Date(dateStamp(date) + days * DAY).toISOString().slice(0, 10);
+}
+function timeMinutes(time, allowDayEnd = false) {
+  if (!/^\d{2}:\d{2}(?::00)?$/.test(time)) return NaN;
+  const [hours, minutes] = time.split(':').map(Number);
+  if (allowDayEnd && hours === 24 && minutes === 0) return 1440;
+  return hours < 24 && minutes < 60 ? hours * 60 + minutes : NaN;
+}
+function instantStamp(value) {
+  // A local string would silently use the device timezone instead of the store.
+  if (typeof value === 'string' && !/(Z|[+-]\d{2}:?\d{2})$/i.test(value)) return NaN;
+  return value instanceof Date ? value.getTime() : new Date(value).getTime();
+}
+
+/** Per-query timezone adapter; no device-offset arithmetic or global time cache. */
+function createClock(timezone) {
+  if (!timezone || typeof timezone !== 'string') throw new Error('Store timezone is unavailable.');
+  let formatter;
+  try {
+    formatter = new Intl.DateTimeFormat('en-GB', {
+      timeZone: timezone,
+      year: 'numeric',
+      month: '2-digit',
+      day: '2-digit',
+      hour: '2-digit',
+      minute: '2-digit',
+      second: '2-digit',
+      hourCycle: 'h23'
+    });
+  } catch {
+    throw new Error('Store timezone is invalid.');
+  }
+  const offsetsByDate = new Map();
+  const local = timestamp => {
+    const parts = {};
+    formatter.formatToParts(timestamp).forEach(part => {
+      parts[part.type] = part.value;
+    });
+    return {
+      date: `${parts.year}-${parts.month}-${parts.day}`,
+      time: `${parts.hour}:${parts.minute}`,
+      second: parts.second
+    };
+  };
+  const offsets = date => {
+    const cached = offsetsByDate.get(date);
+    if (cached) return cached;
+    const result = new Set();
+    const nominal = dateStamp(date);
+    // Sampling both sides of the target day discovers pre/post-transition offsets.
+    for (let hours = -36; hours <= 36; hours += 6) {
+      const sample = nominal + hours * 60 * MINUTE;
+      const wall = local(sample);
+      result.add(Date.parse(`${wall.date}T${wall.time}:${wall.second}Z`) - sample);
+    }
+    const values = [...result];
+    offsetsByDate.set(date, values);
+    return values;
+  };
+  const resolve = (date, time) => {
+    const day = dateStamp(date);
+    const minutes = timeMinutes(time);
+    if (!Number.isFinite(day) || !Number.isFinite(minutes)) return [];
+    const label = time.slice(0, 5);
+    const nominal = day + minutes * MINUTE;
+    return offsets(date).map(offset => nominal - offset).filter(timestamp => {
+      const wall = local(timestamp);
+      return wall.date === date && wall.time === label;
+    }).sort((a, b) => a - b);
+  };
+  const slot = timestamp => {
+    const {
+      date,
+      time
+    } = local(timestamp);
+    const instant = new Date(timestamp).toISOString();
+    return {
+      id: instant,
+      date,
+      time,
+      instant
+    };
+  };
+  return {
+    local,
+    resolve,
+    slot,
+    hasOffsetTransition: date => offsets(date).length > 1
+  };
+}
+function resolvePickupTimingDateTime(date, time, timezone, instant) {
+  const clock = createClock(timezone);
+  const matches = clock.resolve(date, time);
+  const selected = instant ? instantStamp(instant) : matches.length === 1 ? matches[0] : NaN;
+  return matches.includes(selected) ? clock.slot(selected) : undefined;
+}
+function getAsapPickupTiming({
+  config,
+  timezone,
+  now
+}) {
+  const timestamp = instantStamp(now);
+  if (!Number.isFinite(timestamp)) throw new Error('Current time is invalid.');
+  return createClock(timezone).slot(timestamp + config.preparationTimeMinutes * MINUTE);
+}
+function pickupTimingSlotToBookingTimes(slot) {
+  return {
+    start_date: slot.date,
+    start_time: slot.time,
+    end_date: slot.date,
+    end_time: slot.time
+  };
+}
+function createEvaluation(input) {
+  const {
+    config,
+    timezone
+  } = input;
+  const clock = createClock(timezone);
+  const now = instantStamp(input.now);
+  if (!Number.isFinite(now)) throw new Error('Current time is invalid.');
+  const today = clock.local(now).date;
+  const maxDate = addDays(today, config.advanceDays);
+  const earliest = now + config.preparationTimeMinutes * MINUTE;
+  const schedules = input.schedules.filter(schedule => config.scheduleIds.includes(schedule.id));
+  const windowCache = new Map();
+  const windows = date => {
+    if (!windowCache.has(date)) {
+      windowCache.set(date, (0, _getDateIsInSchedule.getScheduleStartEndTimePoints)(date, schedules));
+    }
+    return windowCache.get(date);
+  };
+  const operatingIds = config.operatingHoursScheduleIds || [];
+  const operatingSchedules = input.schedules.filter(schedule => operatingIds.includes(schedule.id));
+  const operatingWindowCache = new Map();
+  const operatingWindows = date => {
+    if (!operatingWindowCache.has(date)) {
+      const ranges = [];
+      for (const offset of [-1, 0]) {
+        for (const window of (0, _getDateIsInSchedule.getScheduleStartEndTimePoints)(addDays(date, offset), operatingSchedules)) {
+          const start = timeMinutes(window.start_time);
+          let end = timeMinutes(window.end_time, true);
+          if (!Number.isFinite(start) || !Number.isFinite(end)) continue;
+          // Store hours use equal endpoints for a full operating day, while
+          // the Pickup Schedule may deliberately contain a single time point.
+          if (end <= start) end += 1440;
+          ranges.push({
+            start: start + offset * 1440,
+            end: end + offset * 1440
+          });
+        }
+      }
+      operatingWindowCache.set(date, ranges);
+    }
+    return operatingWindowCache.get(date);
+  };
+  const slotsForDate = (date, firstOnly = false) => {
+    if (!Number.isFinite(dateStamp(date)) || date < today || date > maxDate || !config.handoverModes.includes('pick_up') || config.timingMode === 'asap_only') return [];
+    const found = new Map();
+    // Missing hours configuration preserves the existing all-day convention.
+    // Referenced but missing schedules yield no windows, never an all-day fallback.
+    const businessWindows = operatingIds.length ? operatingWindows(date) : undefined;
+    // Include the prior day's windows so overnight tails belong to their actual date.
+    for (const windowDate of [addDays(date, -1), date]) {
+      for (const window of windows(windowDate)) {
+        const start = timeMinutes(window.start_time);
+        let end = timeMinutes(window.end_time, true);
+        if (!Number.isFinite(start) || !Number.isFinite(end)) continue;
+        if (end < start) end += 1440;
+        let firstFoundInWindow = false;
+        for (let minute = start; minute <= end; minute += config.slotIntervalMinutes) {
+          const targetDate = minute >= 1440 ? addDays(windowDate, 1) : windowDate;
+          if (targetDate !== date) continue;
+          const localMinute = minute % 1440;
+          // Filter the original Pickup grid rather than moving its anchor to
+          // the store opening time. A zero-duration pickup may be at closing.
+          if (businessWindows && !businessWindows.some(({
+            start,
+            end
+          }) => localMinute >= start && localMinute <= end)) continue;
+          const time = `${String(Math.floor(localMinute / 60)).padStart(2, '0')}:${String(localMinute % 60).padStart(2, '0')}`;
+          for (const timestamp of clock.resolve(date, time)) {
+            if (timestamp < earliest) continue;
+            found.set(timestamp, clock.slot(timestamp));
+            firstFoundInWindow = true;
+          }
+          // Summary needs only an available candidate, not a full year's slots.
+          // During a repeated hour, an earlier wall label's second occurrence can
+          // be later than a subsequent label's first occurrence. Sort them all.
+          if (firstOnly && firstFoundInWindow && !clock.hasOffsetTransition(date)) break;
+        }
+      }
+    }
+    const result = [...found.entries()].sort(([a], [b]) => a - b).map(([, slot]) => slot);
+    return firstOnly ? result.slice(0, 1) : result;
+  };
+  return {
+    clock,
+    now,
+    today,
+    maxDate,
+    slotsForDate
+  };
+}
+function computePickupTimingAvailability(input) {
+  if (!input.config.handoverModes.includes('pick_up')) {
+    const now = instantStamp(input.now);
+    if (!Number.isFinite(now)) throw new Error('Current time is invalid.');
+    return {
+      config: input.config,
+      timezone: input.timezone,
+      now: new Date(now).toISOString(),
+      today: '',
+      maxDate: '',
+      date: input.date || '',
+      dates: [],
+      slots: []
+    };
+  }
+  const evaluation = createEvaluation(input);
+  const {
+    today,
+    maxDate,
+    slotsForDate
+  } = evaluation;
+  const date = input.date || today;
+  if (!Number.isFinite(dateStamp(date))) throw new Error('Pickup date is invalid.');
+  const slots = slotsForDate(date);
+  const dates = [];
+  let firstSlot;
+  for (let day = today; day <= maxDate; day = addDays(day, 1)) {
+    const first = day === date ? slots[0] : slotsForDate(day, true)[0];
+    dates.push({
+      date: day,
+      status: first ? 'available' : 'unavailable'
+    });
+    if (!firstSlot && first) firstSlot = first;
+  }
+  return {
+    config: input.config,
+    timezone: input.timezone,
+    now: new Date(evaluation.now).toISOString(),
+    today,
+    maxDate,
+    date,
+    dates,
+    slots,
+    firstSlot
+  };
+}
+function validatePickupTimingSelection(selection, input) {
+  const fail = (code, message) => ({
+    valid: false,
+    code,
+    message
+  });
+  const {
+    config
+  } = input;
+  if (config.handoverModes.length === 0) return {
+    valid: true
+  };
+  if (!config.handoverModes.includes(selection.serviceType)) {
+    return fail('handover_unavailable', 'Choose an available handover method.');
+  }
+  if (selection.serviceType !== 'pick_up') return {
+    valid: true
+  };
+  if (selection.mode === 'asap') {
+    return config.timingMode === 'scheduled_only' ? fail('scheduled_required', 'Choose a pickup date and time.') : {
+      valid: true,
+      slot: getAsapPickupTiming(input)
+    };
+  }
+  if (selection.mode !== 'scheduled' || config.timingMode === 'asap_only') {
+    return fail('mode_unavailable', 'The selected pickup timing mode is unavailable.');
+  }
+  const slot = resolvePickupTimingDateTime(selection.date || '', selection.time || '', input.timezone, selection.instant);
+  if (!slot) return fail('invalid_time', 'Choose a valid pickup date and time.');
+  const now = instantStamp(input.now);
+  if (!Number.isFinite(now)) throw new Error('Current time is invalid.');
+  if (instantStamp(slot.instant) < now) return fail('time_in_past', 'Pickup time cannot be in the past.');
+  if (selection.source === 'pos_manual' && input.allowManualOverride) return {
+    valid: true,
+    slot
+  };
+  const legal = createEvaluation(input).slotsForDate(slot.date).some(candidate => candidate.instant === slot.instant);
+  return legal ? {
+    valid: true,
+    slot
+  } : fail('time_unavailable', 'This pickup time is no longer available. Choose another time.');
+}

package/lib/modules/FulfillmentTiming/types.d.ts

@@ -0,0 +1,67 @@
+import type { ScheduleItem } from '../Schedule/types';
+export type PickupTimingMode = 'asap_only' | 'scheduled_only' | 'asap_and_scheduled';
+export interface PickupTimingConfig {
+    handoverModes: string[];
+    timingMode: PickupTimingMode;
+    scheduleIds: number[];
+    /** Empty or absent means no additional store-hours restriction. */
+    operatingHoursScheduleIds?: number[];
+    slotIntervalMinutes: number;
+    preparationTimeMinutes: number;
+    advanceDays: number;
+    fulfillmentRefMode?: string;
+    manualInputType?: string;
+}
+export interface PickupTimingSelection {
+    serviceType: string;
+    mode: 'asap' | 'scheduled';
+    date?: string;
+    time?: string;
+    /** The absolute instant disambiguates a repeated local minute during DST. */
+    instant?: string;
+    source?: 'schedule' | 'pos_manual' | 'asap';
+}
+export interface PickupTimingSlot {
+    id: string;
+    date: string;
+    time: string;
+    instant: string;
+}
+export interface PickupTimingAvailability {
+    /** Config remains available when Schedule or store timezone cannot be loaded. */
+    error?: string;
+    config: PickupTimingConfig;
+    timezone: string;
+    now: string;
+    today: string;
+    maxDate: string;
+    date: string;
+    dates: Array<{
+        date: string;
+        status: 'available' | 'unavailable';
+    }>;
+    slots: PickupTimingSlot[];
+    /** Earliest legal candidate across all permitted dates, for POS prefill. */
+    firstSlot?: PickupTimingSlot;
+}
+export interface PickupTimingClockInput {
+    config: PickupTimingConfig;
+    timezone: string;
+    now: Date | string | number;
+}
+export interface PickupTimingComputeInput extends PickupTimingClockInput {
+    schedules: ScheduleItem[];
+    date?: string;
+}
+export interface PickupTimingValidationResult {
+    valid: boolean;
+    code?: string;
+    message?: string;
+    slot?: PickupTimingSlot;
+}
+export interface PickupTimingBookingTimes {
+    start_date: string;
+    start_time: string;
+    end_date: string;
+    end_time: string;
+}

package/lib/modules/FulfillmentTiming/types.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

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

@@ -77,6 +77,12 @@ export interface OpenDataConfig {
     'sale.sale_number_prefix'?: string | null;
     'sale.enabled_item_rules'?: number[];
     'fulfillment.enable_pickup'?: boolean;
+    'fulfillment.handover_mode'?: string[];
+    'fulfillment.pickup.timing_mode'?: 'asap_only' | 'scheduled_only' | 'asap_and_scheduled';
+    'fulfillment.pickup.schedule'?: number[];
+    'fulfillment.pickup.advance_days'?: number;
+    'fulfillment.pickup.slot_interval_minutes'?: number;
+    'fulfillment.pickup.preparation_time_minutes'?: number;
     'fulfillment.overdue_reminder'?: boolean;
     'fulfillment.manual_input_type'?: string;
     'fulfillment.enable_auto_complete'?: boolean;

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

@@ -3,7 +3,8 @@ import { BaseModule } from '../BaseModule';
 import { OrderModuleAPI, CommitOrderParams, UpdateOrderBookingParams, UpdateOrderProductParams, UpdateOrderProductQuantityParams, CancelOrderParams, ChangeBookingStatusParams, CheckoutOrderParams } from './types';
 import { CartItem } from '../Cart/types';
 import { type SubmitPayloadEnhancer } from './utils';
-import type { OrderAmountSnapshot, AddProductBookingInput, AddProductToOrderOptions, OrderIdentitySnapshot, OrderPaymentSource, OrderSnapshot, OrderSyncState, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, SubmitSalesOrderParams, OrderProduct, OrderProductIdentity, OrderSummary, OrderTempOrder, OrderPaymentData, OrderPaymentUpdateOptions, OrderPaymentUpdateResult, SendCustomerPayLinkParams, UpdateTempOrderCustomerInput, OrderCustomerPatch, OrderCustomerView, ReplaceTempOrderOptions, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions, RemoveProductsFromOrderOptions, SalesNote, SalesNotesMutationSnapshot, SetSalesNoteInput, PickupReferenceMode, ShopServiceData, ShopServiceType } from './types';
+import { type PickupTimingBooking, type PickupTimingBookingInput } from './pickupTiming';
+import type { OrderAmountSnapshot, AddProductBookingInput, AddProductToOrderOptions, OrderIdentitySnapshot, OrderPaymentSource, OrderSnapshot, OrderSyncState, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, SubmitSalesOrderParams, OrderProduct, OrderProductIdentity, OrderSummary, OrderTempOrder, OrderPaymentData, OrderPaymentUpdateOptions, OrderPaymentUpdateResult, SendCustomerPayLinkParams, UpdateTempOrderCustomerInput, OrderCustomerPatch, OrderCustomerView, ReplaceTempOrderOptions, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions, RemoveProductsFromOrderOptions, SalesNote, SalesNotesMutationSnapshot, SetSalesNoteInput, PickupReferenceMode, PointCardSnapshotMergeContext, PointCardSnapshotItem, ShopServiceData, ShopServiceType } from './types';
 import type { ICustomer } from '../AccountList/types';
 import type { Discount } from '../Discount/types';
 import { UnavailableReason } from '../Rules/types';
@@ -22,6 +23,8 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     private sessionStorageRestoreRecord;
     /** 只允许当前订单最新的 prepare/config 请求回写客户资产态。 */
     private customerWalletPrepareConfigEpoch;
+    /** Payment 可能早于 prepare/config 返回；先按实例 ID 暂存卡号等待 Snapshot。 */
+    private pointCardSnapshotCodeCandidates;
     private salesSummaryModuleName;
     private rulesHooksOverride?;
     private moduleHooksOverride?;
@@ -108,6 +111,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     }>;
     applyDiscount(options?: {
         reapplyBookingDiscountProductUids?: string[];
+        preferredEntitlementPassIds?: number[];
     }): void;
     /**
      * 注入促销评估器。
@@ -187,7 +191,16 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     private clearTempOrderCustomerWalletSnapshots;
     private clearCustomerWalletState;
     private clearCustomerWalletRuntimeState;
+    private rememberPointCardSnapshotCodeCandidates;
+    private getRememberedPointCardSnapshotCodeCandidates;
+    private getPointCardSnapshotOrderIdentityKey;
+    private isPointCardSnapshotMergeContextCurrent;
     private writeCustomerWalletSnapshotsFromPrepareConfig;
+    /**
+     * 将 Payment WalletPass 返回的实例 code 回填到当前订单 Snapshot。
+     * 这里只按资产 ID 补空值，不新增卡、不覆盖 prepare/config 冻结的余额。
+     */
+    mergePointCardSnapshotCodes(walletPassList: unknown, context?: PointCardSnapshotMergeContext): PointCardSnapshotItem[];
     private createExternalSaleNumber;
     private ensureExternalSaleNumber;
     private ensureRequestUniqueIdempotencyToken;
@@ -341,6 +354,9 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     private updateTempOrderShopServiceData;
     updateTempOrderPickupReferenceMode(mode: PickupReferenceMode): ShopServiceData;
     updateTempOrderServiceType(serviceType: ShopServiceType): ShopServiceData;
+    getPickupTimingBooking(): PickupTimingBooking | null;
+    setPickupTimingBooking(input: PickupTimingBookingInput): PickupTimingBooking;
+    clearPickupTimingBooking(): void;
     updateTempOrderContactsInfo(contactsInfo: Record<string, any> | null): Record<string, any> | null;
     private buildTempOrderCustomer;
     private isCustomerBoundDiscount;
@@ -651,3 +667,5 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     getVouchers(): any[];
 }
 export type { AddProductToOrderOptions, OrderMetaList, PointCardSnapshotItem, VirtualCurrencySnapshotItem, RemoveProductsFromOrderOptions, SalesNote, SalesNoteDraftInput, SalesNoteLocalizedSelection, SalesNoteLocalizedText, SalesNoteRelation, SalesNoteTextInput, SetSalesNoteInput, UpdateOrderBookingParams, UpdateOrderProductParams, UpdateOrderProductQuantityParams, } from './types';
+export { isFulfillmentTimingBooking } from './pickupTiming';
+export type { PickupTimingBooking, PickupTimingBookingInput, PickupTimingBookingMetadata, PickupTimingSelectionMode, PickupTimingSource, } from './pickupTiming';