@pisell/pisellos 2.2.283 → 2.2.284

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

@@ -1,53 +1,30 @@
-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);
+"use strict";
 
-// src/solution/BookingTicket/utils/addTimeAvailability.ts
-var addTimeAvailability_exports = {};
-__export(addTimeAvailability_exports, {
-  buildAddTimeCurrentItem: () => buildAddTimeCurrentItem,
-  isUsableAddTimeProduct: () => isUsableAddTimeProduct,
-  resolveBookingCanAddTime: () => resolveBookingCanAddTime
+Object.defineProperty(exports, "__esModule", {
+  value: true
 });
-module.exports = __toCommonJS(addTimeAvailability_exports);
-var import_dayjs = __toESM(require("dayjs"));
-var import_lodash_es = require("lodash-es");
-var import_serviceTimes = require("../../../modules/BookingContext/utils/serviceTimes");
-var import_timeSlices = require("../../../modules/BookingContext/utils/timeSlices");
+exports.buildAddTimeCurrentItem = buildAddTimeCurrentItem;
+exports.isUsableAddTimeProduct = isUsableAddTimeProduct;
+exports.resolveBookingCanAddTime = resolveBookingCanAddTime;
+var _dayjs = _interopRequireDefault(require("dayjs"));
+var _lodashEs = require("lodash-es");
+var _serviceTimes = require("../../../modules/BookingContext/utils/serviceTimes");
+var _timeSlices = require("../../../modules/BookingContext/utils/timeSlices");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+/**
+ * 从 booking 与其关联商品行构建旧 `isUsableProduct` 所需的当前商品快照。
+ *
+ * @example
+ * const currentItem = buildAddTimeCurrentItem({ booking, product, productsByUid });
+ */
 function buildAddTimeCurrentItem({
   booking,
   product,
   productsByUid
 }) {
-  var _a, _b, _c;
-  if (!booking || !product)
-    return null;
-  const uid = (_a = product.metadata) == null ? void 0 : _a.unique_identification_number;
-  const origin = uid ? (_b = productsByUid == null ? void 0 : productsByUid[String(uid)]) == null ? void 0 : _b.origin : void 0;
+  if (!booking || !product) return null;
+  const uid = product.metadata?.unique_identification_number;
+  const origin = uid ? productsByUid?.[String(uid)]?.origin : undefined;
   const sourceProduct = origin || booking.product || {};
   const startAt = booking.start_date && booking.start_time ? `${booking.start_date} ${booking.start_time}` : booking.start_date;
   const endAt = booking.end_date && booking.end_time ? `${booking.end_date} ${booking.end_time}` : booking.end_date;
@@ -56,12 +33,12 @@ function buildAddTimeCurrentItem({
     ...booking.product,
     product_id: product.product_id ?? sourceProduct.product_id ?? sourceProduct.id,
     id: sourceProduct.id ?? product.product_id,
-    collection: sourceProduct.collection || ((_c = booking.product) == null ? void 0 : _c.collection) || [],
+    collection: sourceProduct.collection || booking.product?.collection || [],
     duration: sourceProduct.duration || booking.duration,
     _extend: {
-      ...sourceProduct._extend || {},
-      startDate: startAt ? (0, import_dayjs.default)(startAt) : void 0,
-      endDate: endAt ? (0, import_dayjs.default)(endAt) : void 0,
+      ...(sourceProduct._extend || {}),
+      startDate: startAt ? (0, _dayjs.default)(startAt) : undefined,
+      endDate: endAt ? (0, _dayjs.default)(endAt) : undefined,
       start_date: booking.start_date,
       end_date: booking.end_date,
       start_time: booking.start_time,
@@ -70,56 +47,48 @@ function buildAddTimeCurrentItem({
     }
   };
 }
+
+/**
+ * 判断当前 booking 是否允许打开加时入口，保持与旧 ticketBooking 的商品适用规则一致。
+ *
+ * @example
+ * const canAddTime = resolveBookingCanAddTime({ booking, product, addTimeProducts, bookingConfig });
+ */
 function resolveBookingCanAddTime(params) {
-  var _a, _b, _c, _d;
-  const quickTime = (_d = (_c = (_b = (_a = params.bookingConfig) == null ? void 0 : _a.config) == null ? void 0 : _b.information_tab) == null ? void 0 : _c.appointment_card) == null ? void 0 : _d.quick_time;
-  if (quickTime !== void 0 && quickTime !== 1)
-    return false;
+  const quickTime = params.bookingConfig?.config?.information_tab?.appointment_card?.quick_time;
+  if (quickTime !== undefined && quickTime !== 1) return false;
   const currentItem = buildAddTimeCurrentItem(params);
-  if (!currentItem || (0, import_serviceTimes.isMultiDayProduct)(currentItem))
-    return false;
-  return (params.addTimeProducts || []).some(
-    (item) => isUsableAddTimeProduct(item == null ? void 0 : item.add_time, currentItem, params.shopOpeningHours)
-  );
+  if (!currentItem || (0, _serviceTimes.isMultiDayProduct)(currentItem)) return false;
+  return (params.addTimeProducts || []).some(item => isUsableAddTimeProduct(item?.add_time, currentItem, params.shopOpeningHours));
 }
+
+/**
+ * 判断一个加时商品是否适用于当前预约商品。
+ *
+ * @example
+ * const usable = isUsableAddTimeProduct(addTime.add_time, currentItem, '23:59');
+ */
 function isUsableAddTimeProduct(addTime, currentItem, shopOpeningHours) {
-  var _a, _b;
-  if (!addTime || !currentItem)
-    return false;
-  if (addTime.additional_time_options === "unlimited") {
-    const startDate = (0, import_dayjs.default)((_a = currentItem._extend) == null ? void 0 : _a.startDate);
-    const endDate = (0, import_dayjs.default)((_b = currentItem._extend) == null ? void 0 : _b.endDate);
-    if (!startDate.isValid() || !endDate.isValid())
-      return false;
-    const maxEndDate = (0, import_timeSlices.getEndDate)(startDate, "flexible", "", shopOpeningHours);
-    if (endDate.isAfter(maxEndDate))
-      return false;
+  if (!addTime || !currentItem) return false;
+  if (addTime.additional_time_options === 'unlimited') {
+    const startDate = (0, _dayjs.default)(currentItem._extend?.startDate);
+    const endDate = (0, _dayjs.default)(currentItem._extend?.endDate);
+    if (!startDate.isValid() || !endDate.isValid()) return false;
+    const maxEndDate = (0, _timeSlices.getEndDate)(startDate, 'flexible', '', shopOpeningHours);
+    if (endDate.isAfter(maxEndDate)) return false;
   }
   const relationProduct = addTime.relation_product || {};
   const type = relationProduct.type;
   const products = Array.isArray(relationProduct.products) ? relationProduct.products : [];
-  if (type === "product_all")
-    return true;
-  if (type === "product_collection") {
-    return Boolean(
-      (0, import_lodash_es.intersectionBy)(
-        products.map((item) => ({
-          ...item,
-          id: item.product_collection_id
-        })),
-        currentItem.collection || [],
-        "id"
-      ).length
-    );
+  if (type === 'product_all') return true;
+  if (type === 'product_collection') {
+    return Boolean((0, _lodashEs.intersectionBy)(products.map(item => ({
+      ...item,
+      id: item.product_collection_id
+    })), currentItem.collection || [], 'id').length);
   }
-  if (type === "products") {
-    return products.some((item) => item.product_id == currentItem.product_id);
+  if (type === 'products') {
+    return products.some(item => item.product_id == currentItem.product_id);
   }
   return false;
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  buildAddTimeCurrentItem,
-  isUsableAddTimeProduct,
-  resolveBookingCanAddTime
-});
+}

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

@@ -1,107 +1,136 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+"use strict";
 
-// src/solution/BookingTicket/utils/bookingStatus.ts
-var bookingStatus_exports = {};
-__export(bookingStatus_exports, {
-  applyBookingsStatus: () => applyBookingsStatus,
-  applyChildBookingStatus: () => applyChildBookingStatus,
-  resolveScheduleId: () => resolveScheduleId,
-  resolveStatusAfterTransition: () => resolveStatusAfterTransition,
-  restoreBookingsStatus: () => restoreBookingsStatus,
-  restoreChildBookingStatus: () => restoreChildBookingStatus
+Object.defineProperty(exports, "__esModule", {
+  value: true
 });
-module.exports = __toCommonJS(bookingStatus_exports);
+exports.applyBookingsStatus = applyBookingsStatus;
+exports.applyChildBookingStatus = applyChildBookingStatus;
+exports.resolveScheduleId = resolveScheduleId;
+exports.resolveStatusAfterTransition = resolveStatusAfterTransition;
+exports.restoreBookingsStatus = restoreBookingsStatus;
+exports.restoreChildBookingStatus = restoreChildBookingStatus;
+/**
+ * BookingTicket - 预约状态相关纯函数。
+ *
+ * 该文件不持有任何运行时引用（无 request / store / effects），
+ * 只做字段解析与本地数组的原地写入/回滚，便于独立单测与未来其他
+ * booking 写操作（editBooking / cancelBooking 等）复用。
+ *
+ * 设计依据：参考 .cursor/rules/data-field-semantics.mdc，
+ * 字段含义严格对齐既有协议（OrderTempOrder / parseSalesResponse），
+ * 不发明等价关系。
+ */
+
+/**
+ * 子预约状态机转移动作（POST /schedule/booking-transition/{schedule_event_id}）。
+ *
+ * @example
+ * await bookingTicket.transitionChildBooking({
+ *   schedule_event_id: 301,
+ *   action: 'confirm',
+ * });
+ */
+
+/** 子预约状态转移入参 */
+
+/**
+ * 从 tempOrder 解析用于调用 appointment-status 接口的 schedule id。
+ *
+ * 优先级：
+ *   1. `tempOrder.metadata.appointment_booking_parent_schedule_id`
+ *   2. `tempOrder.bookings` 中 `parent_id === 0` 的 `schedule_event_id`
+ *
+ * 都缺失时返回 null，由调用方决定如何抛错。
+ */
 function resolveScheduleId(tempOrder) {
-  var _a;
-  if (!tempOrder)
-    return null;
-  const metaScheduleId = (_a = tempOrder.metadata) == null ? void 0 : _a.appointment_booking_parent_schedule_id;
-  if (metaScheduleId !== void 0 && metaScheduleId !== null) {
+  if (!tempOrder) return null;
+  const metaScheduleId = tempOrder.metadata?.appointment_booking_parent_schedule_id;
+  if (metaScheduleId !== undefined && metaScheduleId !== null) {
     return metaScheduleId;
   }
   const bookings = Array.isArray(tempOrder.bookings) ? tempOrder.bookings : [];
-  const rootBooking = bookings.find((b) => (b == null ? void 0 : b.parent_id) === 0);
-  const fallback = rootBooking == null ? void 0 : rootBooking.schedule_event_id;
-  return fallback !== void 0 && fallback !== null ? fallback : null;
+  const rootBooking = bookings.find(b => b?.parent_id === 0);
+  const fallback = rootBooking?.schedule_event_id;
+  return fallback !== undefined && fallback !== null ? fallback : null;
 }
+
+/**
+ * 原地把所有 bookings 的 `appointment_status` 覆盖为新值，
+ * 返回原 status 数组用于回滚（顺序与 bookings 一一对应）。
+ *
+ * - 元素为 null/undefined 时跳过写入（但占位仍保留以保证回滚下标对齐）
+ * - 不会克隆 booking 对象，保持与 OrderModule.tempOrder 引用一致
+ */
 function applyBookingsStatus(bookings, status) {
-  if (!Array.isArray(bookings))
-    return [];
-  const previous = bookings.map((b) => b == null ? void 0 : b.appointment_status);
-  bookings.forEach((b) => {
-    if (b)
-      b.appointment_status = status;
+  if (!Array.isArray(bookings)) return [];
+  const previous = bookings.map(b => b?.appointment_status);
+  bookings.forEach(b => {
+    if (b) b.appointment_status = status;
   });
   return previous;
 }
+
+/**
+ * 把 applyBookingsStatus 的返回值原地写回，撤销乐观更新。
+ * 长度不一致时按较短一方对齐（防御式编程，正常路径不会发生）。
+ */
 function restoreBookingsStatus(bookings, previous) {
-  if (!Array.isArray(bookings))
-    return;
+  if (!Array.isArray(bookings)) return;
   const len = Math.min(bookings.length, previous.length);
   for (let i = 0; i < len; i += 1) {
     const b = bookings[i];
-    if (b)
-      b.appointment_status = previous[i];
+    if (b) b.appointment_status = previous[i];
   }
 }
+
+/**
+ * 将状态机 action 解析为转移后的 `appointment_status`。
+ *
+ * `reschedule` 暂未在状态矩阵启用，返回 null 表示跳过乐观更新。
+ *
+ * @example
+ * resolveStatusAfterTransition('confirm'); // 'confirmed'
+ */
 function resolveStatusAfterTransition(action) {
   const map = {
-    confirm: "confirmed",
-    reject: "rejected",
-    arrive: "arrived",
-    start: "started",
-    complete: "completed",
-    cancel: "cancelled",
-    no_show: "no_show",
+    confirm: 'confirmed',
+    reject: 'rejected',
+    arrive: 'arrived',
+    start: 'started',
+    complete: 'completed',
+    cancel: 'cancelled',
+    no_show: 'no_show',
     reschedule: null
   };
   return map[action] ?? null;
 }
+
+/**
+ * 在 bookings 中按 `schedule_event_id` 定位子预约并乐观写入 `appointment_status`。
+ *
+ * @returns 写入前的 status；未命中时返回 undefined（调用方跳过回滚）
+ *
+ * @example
+ * const prev = applyChildBookingStatus(tempOrder.bookings, 301, 'confirmed');
+ */
 function applyChildBookingStatus(bookings, scheduleEventId, status) {
-  var _a;
-  if (!Array.isArray(bookings))
-    return void 0;
-  const idx = bookings.findIndex(
-    (b) => b && String(b.schedule_event_id) === String(scheduleEventId)
-  );
-  if (idx === -1)
-    return void 0;
-  const previous = (_a = bookings[idx]) == null ? void 0 : _a.appointment_status;
+  if (!Array.isArray(bookings)) return undefined;
+  const idx = bookings.findIndex(b => b && String(b.schedule_event_id) === String(scheduleEventId));
+  if (idx === -1) return undefined;
+  const previous = bookings[idx]?.appointment_status;
   bookings[idx].appointment_status = status;
   return previous;
 }
+
+/**
+ * 撤销 applyChildBookingStatus 对单条子预约的乐观写入。
+ *
+ * @example
+ * restoreChildBookingStatus(tempOrder.bookings, 301, prev);
+ */
 function restoreChildBookingStatus(bookings, scheduleEventId, previous) {
-  if (!Array.isArray(bookings) || previous === void 0)
-    return;
-  const idx = bookings.findIndex(
-    (b) => b && String(b.schedule_event_id) === String(scheduleEventId)
-  );
-  if (idx === -1)
-    return;
+  if (!Array.isArray(bookings) || previous === undefined) return;
+  const idx = bookings.findIndex(b => b && String(b.schedule_event_id) === String(scheduleEventId));
+  if (idx === -1) return;
   bookings[idx].appointment_status = previous;
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  applyBookingsStatus,
-  applyChildBookingStatus,
-  resolveScheduleId,
-  resolveStatusAfterTransition,
-  restoreBookingsStatus,
-  restoreChildBookingStatus
-});
+}