@pisell/pisellos 0.10.49 → 0.10.51

package/dist/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/dist/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/dist/modules/FulfillmentTiming/index.js

@@ -0,0 +1,407 @@
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+import dayjs from 'dayjs';
+import isSameOrAfter from 'dayjs/plugin/isSameOrAfter';
+import isSameOrBefore from 'dayjs/plugin/isSameOrBefore';
+import { getScheduleStartEndTimePoints } from "../Schedule/getDateIsInSchedule";
+export * from "./types";
+
+// The shared Schedule resolver uses these comparisons without registering them.
+dayjs.extend(isSameOrAfter);
+dayjs.extend(isSameOrBefore);
+var MINUTE = 60000;
+var DAY = 24 * 60 * MINUTE;
+var integerSetting = function integerSetting(value, min, max, fallback) {
+  return typeof value === 'number' && Number.isInteger(value) && value >= min && value <= max ? value : fallback;
+};
+
+/** Consume effective OpenData values only; legacy switches never enable Pickup. */
+export function normalizePickupTimingConfig(openData) {
+  var handovers = openData['fulfillment.handover_mode'];
+  var scheduleIds = openData['fulfillment.pickup.schedule'];
+  var operatingHoursScheduleIds = openData['availability.operating_hours'];
+  var mode = openData['fulfillment.pickup.timing_mode'];
+  return {
+    handoverModes: Array.isArray(handovers) ? _toConsumableArray(new Set(handovers.filter(function (value) {
+      return typeof value === 'string' && value.length > 0;
+    }))) : [],
+    timingMode: mode === 'scheduled_only' || mode === 'asap_and_scheduled' ? mode : 'asap_only',
+    scheduleIds: Array.isArray(scheduleIds) ? _toConsumableArray(new Set(scheduleIds.filter(function (value) {
+      return typeof value === 'number' && Number.isInteger(value) && value > 0;
+    }))) : [],
+    operatingHoursScheduleIds: Array.isArray(operatingHoursScheduleIds) ? _toConsumableArray(new Set(operatingHoursScheduleIds.map(function (value) {
+      return typeof value === 'number' || typeof value === 'string' ? Number(value) : NaN;
+    }).filter(function (value) {
+      return 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;
+  var value = Date.parse("".concat(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) {
+  var allowDayEnd = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
+  if (!/^\d{2}:\d{2}(?::00)?$/.test(time)) return NaN;
+  var _time$split$map = time.split(':').map(Number),
+    _time$split$map2 = _slicedToArray(_time$split$map, 2),
+    hours = _time$split$map2[0],
+    minutes = _time$split$map2[1];
+  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.');
+  var 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 (_unused) {
+    throw new Error('Store timezone is invalid.');
+  }
+  var offsetsByDate = new Map();
+  var local = function local(timestamp) {
+    var parts = {};
+    formatter.formatToParts(timestamp).forEach(function (part) {
+      parts[part.type] = part.value;
+    });
+    return {
+      date: "".concat(parts.year, "-").concat(parts.month, "-").concat(parts.day),
+      time: "".concat(parts.hour, ":").concat(parts.minute),
+      second: parts.second
+    };
+  };
+  var offsets = function offsets(date) {
+    var cached = offsetsByDate.get(date);
+    if (cached) return cached;
+    var result = new Set();
+    var nominal = dateStamp(date);
+    // Sampling both sides of the target day discovers pre/post-transition offsets.
+    for (var hours = -36; hours <= 36; hours += 6) {
+      var sample = nominal + hours * 60 * MINUTE;
+      var wall = local(sample);
+      result.add(Date.parse("".concat(wall.date, "T").concat(wall.time, ":").concat(wall.second, "Z")) - sample);
+    }
+    var values = _toConsumableArray(result);
+    offsetsByDate.set(date, values);
+    return values;
+  };
+  var resolve = function resolve(date, time) {
+    var day = dateStamp(date);
+    var minutes = timeMinutes(time);
+    if (!Number.isFinite(day) || !Number.isFinite(minutes)) return [];
+    var label = time.slice(0, 5);
+    var nominal = day + minutes * MINUTE;
+    return offsets(date).map(function (offset) {
+      return nominal - offset;
+    }).filter(function (timestamp) {
+      var wall = local(timestamp);
+      return wall.date === date && wall.time === label;
+    }).sort(function (a, b) {
+      return a - b;
+    });
+  };
+  var slot = function slot(timestamp) {
+    var _local = local(timestamp),
+      date = _local.date,
+      time = _local.time;
+    var instant = new Date(timestamp).toISOString();
+    return {
+      id: instant,
+      date: date,
+      time: time,
+      instant: instant
+    };
+  };
+  return {
+    local: local,
+    resolve: resolve,
+    slot: slot,
+    hasOffsetTransition: function hasOffsetTransition(date) {
+      return offsets(date).length > 1;
+    }
+  };
+}
+export function resolvePickupTimingDateTime(date, time, timezone, instant) {
+  var clock = createClock(timezone);
+  var matches = clock.resolve(date, time);
+  var selected = instant ? instantStamp(instant) : matches.length === 1 ? matches[0] : NaN;
+  return matches.includes(selected) ? clock.slot(selected) : undefined;
+}
+export function getAsapPickupTiming(_ref) {
+  var config = _ref.config,
+    timezone = _ref.timezone,
+    now = _ref.now;
+  var timestamp = instantStamp(now);
+  if (!Number.isFinite(timestamp)) throw new Error('Current time is invalid.');
+  return createClock(timezone).slot(timestamp + config.preparationTimeMinutes * MINUTE);
+}
+export function pickupTimingSlotToBookingTimes(slot) {
+  return {
+    start_date: slot.date,
+    start_time: slot.time,
+    end_date: slot.date,
+    end_time: slot.time
+  };
+}
+function createEvaluation(input) {
+  var config = input.config,
+    timezone = input.timezone;
+  var clock = createClock(timezone);
+  var now = instantStamp(input.now);
+  if (!Number.isFinite(now)) throw new Error('Current time is invalid.');
+  var today = clock.local(now).date;
+  var maxDate = addDays(today, config.advanceDays);
+  var earliest = now + config.preparationTimeMinutes * MINUTE;
+  var schedules = input.schedules.filter(function (schedule) {
+    return config.scheduleIds.includes(schedule.id);
+  });
+  var windowCache = new Map();
+  var windows = function windows(date) {
+    if (!windowCache.has(date)) {
+      windowCache.set(date, getScheduleStartEndTimePoints(date, schedules));
+    }
+    return windowCache.get(date);
+  };
+  var operatingIds = config.operatingHoursScheduleIds || [];
+  var operatingSchedules = input.schedules.filter(function (schedule) {
+    return operatingIds.includes(schedule.id);
+  });
+  var operatingWindowCache = new Map();
+  var operatingWindows = function operatingWindows(date) {
+    if (!operatingWindowCache.has(date)) {
+      var ranges = [];
+      for (var _i = 0, _arr = [-1, 0]; _i < _arr.length; _i++) {
+        var offset = _arr[_i];
+        var _iterator = _createForOfIteratorHelper(getScheduleStartEndTimePoints(addDays(date, offset), operatingSchedules)),
+          _step;
+        try {
+          for (_iterator.s(); !(_step = _iterator.n()).done;) {
+            var window = _step.value;
+            var start = timeMinutes(window.start_time);
+            var 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
+            });
+          }
+        } catch (err) {
+          _iterator.e(err);
+        } finally {
+          _iterator.f();
+        }
+      }
+      operatingWindowCache.set(date, ranges);
+    }
+    return operatingWindowCache.get(date);
+  };
+  var slotsForDate = function slotsForDate(date) {
+    var firstOnly = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
+    if (!Number.isFinite(dateStamp(date)) || date < today || date > maxDate || !config.handoverModes.includes('pick_up') || config.timingMode === 'asap_only') return [];
+    var found = new Map();
+    // Missing hours configuration preserves the existing all-day convention.
+    // Referenced but missing schedules yield no windows, never an all-day fallback.
+    var businessWindows = operatingIds.length ? operatingWindows(date) : undefined;
+    // Include the prior day's windows so overnight tails belong to their actual date.
+    for (var _i2 = 0, _arr2 = [addDays(date, -1), date]; _i2 < _arr2.length; _i2++) {
+      var windowDate = _arr2[_i2];
+      var _iterator2 = _createForOfIteratorHelper(windows(windowDate)),
+        _step2;
+      try {
+        for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+          var window = _step2.value;
+          var start = timeMinutes(window.start_time);
+          var end = timeMinutes(window.end_time, true);
+          if (!Number.isFinite(start) || !Number.isFinite(end)) continue;
+          if (end < start) end += 1440;
+          var firstFoundInWindow = false;
+          var _loop = function _loop() {
+              var targetDate = minute >= 1440 ? addDays(windowDate, 1) : windowDate;
+              if (targetDate !== date) return 0; // continue
+              var 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(function (_ref2) {
+                var start = _ref2.start,
+                  end = _ref2.end;
+                return localMinute >= start && localMinute <= end;
+              })) return 0; // continue
+              var time = "".concat(String(Math.floor(localMinute / 60)).padStart(2, '0'), ":").concat(String(localMinute % 60).padStart(2, '0'));
+              var _iterator3 = _createForOfIteratorHelper(clock.resolve(date, time)),
+                _step3;
+              try {
+                for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+                  var timestamp = _step3.value;
+                  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.
+              } catch (err) {
+                _iterator3.e(err);
+              } finally {
+                _iterator3.f();
+              }
+              if (firstOnly && firstFoundInWindow && !clock.hasOffsetTransition(date)) return 1; // break
+            },
+            _ret;
+          for (var minute = start; minute <= end; minute += config.slotIntervalMinutes) {
+            _ret = _loop();
+            if (_ret === 0) continue;
+            if (_ret === 1) break;
+          }
+        }
+      } catch (err) {
+        _iterator2.e(err);
+      } finally {
+        _iterator2.f();
+      }
+    }
+    var result = _toConsumableArray(found.entries()).sort(function (_ref3, _ref4) {
+      var _ref5 = _slicedToArray(_ref3, 1),
+        a = _ref5[0];
+      var _ref6 = _slicedToArray(_ref4, 1),
+        b = _ref6[0];
+      return a - b;
+    }).map(function (_ref7) {
+      var _ref8 = _slicedToArray(_ref7, 2),
+        slot = _ref8[1];
+      return slot;
+    });
+    return firstOnly ? result.slice(0, 1) : result;
+  };
+  return {
+    clock: clock,
+    now: now,
+    today: today,
+    maxDate: maxDate,
+    slotsForDate: slotsForDate
+  };
+}
+export function computePickupTimingAvailability(input) {
+  if (!input.config.handoverModes.includes('pick_up')) {
+    var 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: []
+    };
+  }
+  var evaluation = createEvaluation(input);
+  var today = evaluation.today,
+    maxDate = evaluation.maxDate,
+    slotsForDate = evaluation.slotsForDate;
+  var date = input.date || today;
+  if (!Number.isFinite(dateStamp(date))) throw new Error('Pickup date is invalid.');
+  var slots = slotsForDate(date);
+  var dates = [];
+  var firstSlot;
+  for (var day = today; day <= maxDate; day = addDays(day, 1)) {
+    var 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: today,
+    maxDate: maxDate,
+    date: date,
+    dates: dates,
+    slots: slots,
+    firstSlot: firstSlot
+  };
+}
+export function validatePickupTimingSelection(selection, input) {
+  var fail = function fail(code, message) {
+    return {
+      valid: false,
+      code: code,
+      message: message
+    };
+  };
+  var config = input.config;
+  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.');
+  }
+  var slot = resolvePickupTimingDateTime(selection.date || '', selection.time || '', input.timezone, selection.instant);
+  if (!slot) return fail('invalid_time', 'Choose a valid pickup date and time.');
+  var 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: slot
+  };
+  var legal = createEvaluation(input).slotsForDate(slot.date).some(function (candidate) {
+    return candidate.instant === slot.instant;
+  });
+  return legal ? {
+    valid: true,
+    slot: slot
+  } : fail('time_unavailable', 'This pickup time is no longer available. Choose another time.');
+}

package/dist/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/dist/modules/FulfillmentTiming/types.js

@@ -0,0 +1 @@
+export {};

package/dist/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/dist/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';