@pisell/pisellos 0.0.568 → 0.0.569

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

@@ -0,0 +1,353 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.buildCacheItemFromCartDetail = buildCacheItemFromCartDetail;
+exports.buildCacheItemFromDetail = buildCacheItemFromDetail;
+exports.buildRequiresDetailPayload = buildRequiresDetailPayload;
+exports.decideAddProduct = decideAddProduct;
+exports.decideAfterDetail = decideAfterDetail;
+exports.decideAutoClose = decideAutoClose;
+exports.getIsEject = getIsEject;
+exports.getIsOnlySession = getIsOnlySession;
+exports.prepareBookingCacheItem = prepareBookingCacheItem;
+exports.transformDetailToProductAndBooking = transformDetailToProductAndBooking;
+var _dayjs = _interopRequireDefault(require("dayjs"));
+var _BookingContext = require("../../../modules/BookingContext");
+var _transformBaseProductToOrderProduct = require("../../BaseSales/utils/transformBaseProductToOrderProduct");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+/**
+ * cart.addProduct 两阶段决策（与 ticketBooking `handleSelectProduct` 对齐）：
+ *
+ * 1. `requiresDetail`：规格 / SKU / 套餐 / Session / 称重弹窗（门禁：`isOpenDetailModal` / `cartDetailValue` / `open_sold_weight`）
+ * 2. `requiresBookingEdit`：资源 / 时间编辑抽屉（门禁：`getIsAutoClose` on prepared cacheItem）
+ * 3. `add`：两关均通过，直接 transform + 加车
+ */
+
+/** 资源 / 时间编辑抽屉所需的最小 payload。 */
+
+/**
+ * 第一段：是否需要打开规格 / SKU 详情弹窗（与 addService `handleSelectProduct` 一致，不用 `getIsEject` 做门禁）。
+ */
+function needsSpecDetailModal(item) {
+  if (item?.open_sold_weight) return true;
+  if (item?.isOpenDetailModal) return true;
+  if (!item?.cartDetailValue) return true;
+  return false;
+}
+
+/**
+ * 第二段：预约商品是否仍需打开资源 / 时间编辑（与 info2 `cacheItem.autoClose` 等价）。
+ */
+function needsBookingEdit(cacheItem, ctx) {
+  if (isNormalBookingProduct(cacheItem)) return false;
+  const isAutoAllocationOn = ctx?.isAutoAllocationOn || (() => true);
+  return !(0, _BookingContext.getIsAutoClose)(cacheItem, isAutoAllocationOn);
+}
+function buildRequiresBookingEditPayload(cacheItem, ctx) {
+  return {
+    cacheItem,
+    customerId: ctx?.customerId,
+    date: typeof ctx?.date === 'string' ? ctx.date : null
+  };
+}
+
+/**
+ * 加车主决策：对齐 `handleSelectProduct` 两段分支。
+ */
+function decideAddProduct(item, ctx) {
+  const derivedCtx = withDerivedBookingCtx(ctx);
+  if (needsSpecDetailModal(item)) {
+    return {
+      action: 'requiresDetail',
+      payload: buildRequiresDetailPayload(item, derivedCtx)
+    };
+  }
+  const cacheItem = prepareBookingCacheItem(buildCacheItemFromCartDetail(item, derivedCtx), derivedCtx);
+  if (needsBookingEdit(cacheItem, derivedCtx)) {
+    return {
+      action: 'requiresBookingEdit',
+      cacheItem,
+      payload: buildRequiresBookingEditPayload(cacheItem, derivedCtx)
+    };
+  }
+  return {
+    action: 'add',
+    cacheItem
+  };
+}
+
+/**
+ * 规格弹窗 callback 后的第二段决策（对齐 `handleBooking4Service` 内 `cacheItem.autoClose` 分支）。
+ */
+function decideAfterDetail(cacheItem, ctx) {
+  const derivedCtx = withDerivedBookingCtx(ctx);
+  const extended = prepareBookingCacheItem(cacheItem, derivedCtx);
+  if (needsBookingEdit(extended, derivedCtx)) {
+    return {
+      action: 'requiresBookingEdit',
+      cacheItem: extended,
+      payload: buildRequiresBookingEditPayload(extended, derivedCtx)
+    };
+  }
+  return {
+    action: 'add',
+    cacheItem: extended
+  };
+}
+
+/**
+ * @deprecated 请用 `decideAddProduct`；保留兼容：autoClose=true 仅表示可直接加车（action=add）。
+ */
+
+function isNormalBookingProduct(item) {
+  return !(0, _BookingContext.isBookingProduct)(item);
+}
+function hasPreparedBookingExtend(cacheItem) {
+  // 场次/时间已写入但资源仍未选中时，须继续走 getProductExtend（对齐 info2 必定调用 getProductExtend）。
+  if ((0, _BookingContext.productNeedsResourceExtend)(cacheItem) && !(0, _BookingContext.hasActualResourceSelection)(cacheItem)) {
+    return false;
+  }
+  const ext = cacheItem?._extend || {};
+  const hasResourceState = Boolean((0, _BookingContext.hasActualResourceSelection)(cacheItem) && ext.capacity && (ext.endDate || ext.end_date));
+  const hasSessionState = Boolean((0, _BookingContext.isSessionProduct)(cacheItem) && ext.other?.session && ext.start_time && (ext.end_time || ext.endDate));
+  const hasMultiDayState = Boolean(isNormalBookingProduct(cacheItem) === false && isMultiDayLike(cacheItem));
+  const hasExplicitTimeState = Boolean(ext.duration && (ext.start_date || ext.startDate) && ext.start_time && (ext.end_date && ext.end_time || ext.endDate));
+  return hasResourceState || hasSessionState || hasMultiDayState || hasExplicitTimeState;
+}
+
+/** 弹窗 / Host 使用的日历日，与 ticketBooking `state.date.format('YYYY-MM-DD')` 对齐。 */
+function formatBookingDateForUI(date) {
+  if (date == null || date === '') return null;
+  const parsed = (0, _dayjs.default)(date);
+  return parsed.isValid() ? parsed.format('YYYY-MM-DD') : null;
+}
+
+/** 补齐 presetStartTime（decideAutoClose / transform 与 BookingTicket.buildAddProductCtx 共用）。 */
+function withDerivedBookingCtx(ctx) {
+  if (!ctx) return {};
+  return {
+    ...ctx,
+    presetStartTime: ctx.presetStartTime ?? (0, _BookingContext.derivePresetStartTimeFromDate)(ctx.date)
+  };
+}
+function isMultiDayLike(cacheItem) {
+  const ext = cacheItem?._extend || {};
+  return Boolean(cacheItem?.duration?.type === 'days' && ext.duration && ext.start_date && ext.end_date);
+}
+
+/**
+ * 统一补齐预约商品的运行态字段。
+ *
+ * 新链路不再让决策和提交各自重建 cacheItem；这里作为唯一入口补齐
+ * `_extend.resource / capacity / startDate / endDate` 等后续 booking mapper 需要的字段。
+ */
+function prepareBookingCacheItem(cacheItem, ctx) {
+  if (isNormalBookingProduct(cacheItem) || hasPreparedBookingExtend(cacheItem)) {
+    return cacheItem;
+  }
+  return (0, _BookingContext.getProductExtend)({
+    cacheItem,
+    ctx: withDerivedBookingCtx(ctx),
+    isDisabledTime: true
+  });
+}
+function decideAutoClose(item, ctx) {
+  const decision = decideAddProduct(item, ctx);
+  if (decision.action === 'add') {
+    return {
+      autoClose: true,
+      cacheItem: decision.cacheItem
+    };
+  }
+  if (decision.action === 'requiresBookingEdit') {
+    return {
+      autoClose: false,
+      cacheItem: decision.cacheItem
+    };
+  }
+  return {
+    autoClose: false
+  };
+}
+
+/**
+ * 替代 info2 `getIsEject`：商品是否需要弹窗（含 type='detail' / option_group / bundle_group / variant / session / sold_by_weight）。
+ */
+function getIsEject(item, type = 'select') {
+  const isSession = (0, _BookingContext.isSessionProduct)(item);
+  const isSoldByWeight = Boolean(item?.open_sold_weight);
+  const need = type === 'detail' || (item?.bundle_group_count || 0) > 0 || (item?.option_group_count || 0) > 0 || (item?.is_variant || 0) > 0 || isSession || isSoldByWeight;
+  return need ? 1 : 0;
+}
+
+/** 仅 session 商品（且没有 variant/option/package）。 */
+function getIsOnlySession(item) {
+  const isSession = (0, _BookingContext.isSessionProduct)(item);
+  return !((item?.bundle_group_count || 0) > 0 || (item?.option_group_count || 0) > 0 || (item?.is_variant || 0) > 0) && isSession;
+}
+
+/**
+ * 拼装 requiresDetail payload；showConfig 与 info2 弹窗内部判断一致。
+ */
+function buildRequiresDetailPayload(item, ctx) {
+  const isOnlySession = getIsOnlySession(item);
+  const isEject = getIsEject(item, ctx?.type || 'select');
+  return {
+    item,
+    showConfig: {
+      option: (item?.option_group_count || 0) > 0,
+      session: (0, _BookingContext.isSessionProduct)(item),
+      variant: (item?.is_variant || 0) > 0,
+      package: (item?.bundle_group_count || 0) > 0,
+      number: Boolean(item?.open_sold_weight)
+    },
+    isOnlySession,
+    isEject: isEject ? 1 : 0,
+    customerId: ctx?.customerId,
+    date: formatBookingDateForUI(ctx?.date),
+    productData: item
+  };
+}
+
+/**
+ * 用 item.cartDetailValue 拼装一个 cacheItem 雏形（与 info2 `handleDirectAddService` 等价路径）。
+ * 这里只补 `_extend.start_date / quantity / other` 等运行态字段；后续走 getProductExtend 才会补齐资源 / 时间。
+ */
+function buildCacheItemFromCartDetail(item, ctx) {
+  const cartDetailValue = item.cartDetailValue || {};
+  const other = JSON.parse(JSON.stringify(cartDetailValue || {}));
+  other.session = cartDetailValue.session;
+  /** 列表/接口可能只带 product_id 不带 id，勿用 item.id 覆盖掉已有 product_id */
+  const resolvedId = item.id ?? item.product_id;
+  let extend = (0, _BookingContext.applySessionTimesToExtend)(item, {
+    start_date: ctx?.date || undefined,
+    /** 列表连点 / 防抖合并时以 ctx.quantity 为准，避免 cartDetailValue 默认 1 盖掉合并数量 */
+    quantity: ctx?.quantity ?? cartDetailValue?.quantity ?? 1,
+    product_name: item.title,
+    other,
+    isNormalProduct: !(0, _BookingContext.isBookingProduct)(item),
+    price: item?._extend?.price ?? item?.price
+  }, {
+    date: ctx?.date
+  });
+  return {
+    ...item,
+    id: resolvedId,
+    product_id: resolvedId,
+    _key: cartDetailValue.key,
+    _extend: extend,
+    new: 1
+  };
+}
+
+/**
+ * 用 Info2 callback 的 (e, extension_type, detail) 拼装 cacheItem。
+ *
+ * 保留 detail._extend 中的 pricing / note（规格弹窗改价、备注等），
+ * 再叠加 session 时间、ctx.quantity 等运行态字段；other 以 callback `e` 为准。
+ */
+function buildCacheItemFromDetail(item, detailResult, ctx) {
+  const _currentItem = detailResult.detail || item;
+  const _detail = _currentItem;
+  const detailExtend = _detail?._extend || {};
+  const other = JSON.parse(JSON.stringify(detailResult.e || {}));
+  other.session = detailResult.e?.session;
+  const resolvedId = _currentItem.id ?? _currentItem.product_id;
+  const mergedItem = {
+    ...item,
+    ..._detail,
+    extension_type: _detail.extension_type ?? item.extension_type
+  };
+  const runtimeExtend = (0, _BookingContext.applySessionTimesToExtend)(mergedItem, {
+    start_date: ctx?.date || detailExtend.start_date || undefined,
+    quantity: ctx?.quantity ?? detailResult.e?.quantity ?? detailExtend.quantity ?? 1,
+    price: detailExtend.price ?? _detail?.price ?? item?.price,
+    product_name: _currentItem.title ?? detailExtend.product_name,
+    other,
+    isNormalProduct: !(0, _BookingContext.isBookingProduct)(mergedItem)
+  }, {
+    date: ctx?.date
+  });
+  const extend = {
+    ...detailExtend,
+    ...runtimeExtend,
+    other
+  };
+  const note = detailExtend.note ?? _detail?.note;
+  return {
+    ..._detail,
+    id: resolvedId,
+    product_id: resolvedId,
+    extension_type: mergedItem.extension_type,
+    _key: detailResult.e?.key,
+    ...(note != null && note !== '' ? {
+      note: String(note)
+    } : {}),
+    _extend: extend,
+    new: 1
+  };
+}
+
+/**
+ * `transformDetailToProductAndBooking`：把 cacheItem 拆成 OS `addProductToOrder` 所需的 `(product, booking)`。
+ *
+ * - `product` 走 `transformBaseProductToOrderProduct`（沿用 BaseSales 现有 mapper）。
+ * - `booking` 走 `cacheItemToBookingInput`（严格按 TEMP_ORDER_FIELDS_SUMMARY.md 协议）。
+ * - 普通商品（无 duration / 无 schedules）不产 booking，与 info2 一致。
+ */
+function transformDetailToProductAndBooking(cacheItem, ctx) {
+  const preparedCacheItem = prepareBookingCacheItem(cacheItem, withDerivedBookingCtx(ctx));
+  const payload = buildBasePayloadFromCacheItem(preparedCacheItem, ctx);
+  const productInput = (0, _transformBaseProductToOrderProduct.transformBaseProductToOrderProduct)({
+    payload,
+    sourceProduct: preparedCacheItem
+  });
+  if (!productInput) {
+    throw new Error('[BookingTicket] transformDetailToProductAndBooking: product transform failed (missing numeric item.id / item.product_id)');
+  }
+  const isNormalProduct = isNormalBookingProduct(preparedCacheItem);
+  let booking;
+  if (!isNormalProduct) {
+    booking = (0, _BookingContext.cacheItemToBookingInput)(preparedCacheItem, {
+      bookingConfig: ctx?.bookingConfig
+    });
+  }
+  return {
+    product: productInput,
+    booking,
+    cacheItem: preparedCacheItem
+  };
+}
+
+/**
+ * 把 cacheItem._extend.other 中的字段 + 顶层运行态拼成 `BaseProductDetailPayload`。
+ */
+function buildBasePayloadFromCacheItem(cacheItem, ctx) {
+  const other = cacheItem?._extend?.other || {};
+  const quantity = ctx?.quantity != null && ctx.quantity > 0 ? ctx.quantity : cacheItem?._extend?.quantity ?? 1;
+  const resolvedPid = cacheItem?.product_id ?? cacheItem?.id;
+  const extend = cacheItem?._extend || {};
+  return {
+    id: cacheItem?.id ?? cacheItem?.product_id,
+    product_id: resolvedPid,
+    variant_id: other?.product_variant_id ?? other?.variant_id ?? 0,
+    quantity,
+    option: other?.option || [],
+    bundle: other?.bundle || extend?.skuValue?.bundle || extend?._skuValue?.bundle || [],
+    unique: other?.unique,
+    session: other?.session,
+    note: extend?.note,
+    price: extend?.price ?? cacheItem?.price,
+    selling_price: extend?.price ?? cacheItem?.price,
+    line_total: extend?.total,
+    total: extend?.total,
+    origin_total: extend?.origin_total,
+    price_override: extend?.priceOverride,
+    bundle_edit: extend?.bundle_edit,
+    discount_reason: extend?.discount_reason,
+    discount_list: cacheItem?.discount_list,
+    _extend: extend
+  };
+}

package/lib/solution/BookingTicket/utils/addTimeAvailability.d.ts

@@ -0,0 +1,35 @@
+import type { BaseSalesOrderProduct } from '../../BaseSales';
+import type { ISalesBooking } from '../../BaseSales/utils/parseSalesResponse';
+export interface BuildAddTimeCurrentItemParams {
+    booking: ISalesBooking;
+    product: BaseSalesOrderProduct | null;
+    productsByUid?: Record<string, {
+        origin?: Record<string, any>;
+    }>;
+}
+export interface ResolveBookingCanAddTimeParams extends BuildAddTimeCurrentItemParams {
+    addTimeProducts?: any[];
+    bookingConfig?: Record<string, any> | null;
+    shopOpeningHours?: string;
+}
+/**
+ * 从 booking 与其关联商品行构建旧 `isUsableProduct` 所需的当前商品快照。
+ *
+ * @example
+ * const currentItem = buildAddTimeCurrentItem({ booking, product, productsByUid });
+ */
+export declare function buildAddTimeCurrentItem({ booking, product, productsByUid, }: BuildAddTimeCurrentItemParams): Record<string, any> | null;
+/**
+ * 判断当前 booking 是否允许打开加时入口，保持与旧 ticketBooking 的商品适用规则一致。
+ *
+ * @example
+ * const canAddTime = resolveBookingCanAddTime({ booking, product, addTimeProducts, bookingConfig });
+ */
+export declare function resolveBookingCanAddTime(params: ResolveBookingCanAddTimeParams): boolean;
+/**
+ * 判断一个加时商品是否适用于当前预约商品。
+ *
+ * @example
+ * const usable = isUsableAddTimeProduct(addTime.add_time, currentItem, '23:59');
+ */
+export declare function isUsableAddTimeProduct(addTime: any, currentItem: Record<string, any> | null | undefined, shopOpeningHours?: string): boolean;

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

@@ -0,0 +1,94 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+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
+}) {
+  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;
+  return {
+    ...sourceProduct,
+    ...booking.product,
+    product_id: product.product_id ?? sourceProduct.product_id ?? sourceProduct.id,
+    id: sourceProduct.id ?? product.product_id,
+    collection: sourceProduct.collection || booking.product?.collection || [],
+    duration: sourceProduct.duration || booking.duration,
+    _extend: {
+      ...(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,
+      end_time: booking.end_time,
+      sub_type: booking.sub_type
+    }
+  };
+}
+
+/**
+ * 判断当前 booking 是否允许打开加时入口，保持与旧 ticketBooking 的商品适用规则一致。
+ *
+ * @example
+ * const canAddTime = resolveBookingCanAddTime({ booking, product, addTimeProducts, bookingConfig });
+ */
+function resolveBookingCanAddTime(params) {
+  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, _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) {
+  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, _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);
+  }
+  return false;
+}

package/lib/solution/BookingTicket/utils/bookingStatus.d.ts

@@ -0,0 +1,77 @@
+/**
+ * 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',
+ * });
+ */
+export type BookingTransitionAction = 'confirm' | 'reject' | 'arrive' | 'start' | 'complete' | 'cancel' | 'no_show' | 'reschedule';
+/** 子预约状态转移入参 */
+export interface TransitionChildBookingParams {
+    schedule_event_id: number | string;
+    action: BookingTransitionAction;
+}
+/**
+ * 从 tempOrder 解析用于调用 appointment-status 接口的 schedule id。
+ *
+ * 优先级：
+ *   1. `tempOrder.metadata.appointment_booking_parent_schedule_id`
+ *   2. `tempOrder.bookings` 中 `parent_id === 0` 的 `schedule_event_id`
+ *
+ * 都缺失时返回 null，由调用方决定如何抛错。
+ */
+export declare function resolveScheduleId(tempOrder: {
+    bookings?: any[];
+    metadata?: Record<string, any> | null;
+} | null | undefined): number | string | null;
+/**
+ * 原地把所有 bookings 的 `appointment_status` 覆盖为新值，
+ * 返回原 status 数组用于回滚（顺序与 bookings 一一对应）。
+ *
+ * - 元素为 null/undefined 时跳过写入（但占位仍保留以保证回滚下标对齐）
+ * - 不会克隆 booking 对象，保持与 OrderModule.tempOrder 引用一致
+ */
+export declare function applyBookingsStatus(bookings: any[] | null | undefined, status: string): Array<string | undefined>;
+/**
+ * 把 applyBookingsStatus 的返回值原地写回，撤销乐观更新。
+ * 长度不一致时按较短一方对齐（防御式编程，正常路径不会发生）。
+ */
+export declare function restoreBookingsStatus(bookings: any[] | null | undefined, previous: Array<string | undefined>): void;
+/**
+ * 将状态机 action 解析为转移后的 `appointment_status`。
+ *
+ * `reschedule` 暂未在状态矩阵启用，返回 null 表示跳过乐观更新。
+ *
+ * @example
+ * resolveStatusAfterTransition('confirm'); // 'confirmed'
+ */
+export declare function resolveStatusAfterTransition(action: BookingTransitionAction): string | null;
+/**
+ * 在 bookings 中按 `schedule_event_id` 定位子预约并乐观写入 `appointment_status`。
+ *
+ * @returns 写入前的 status；未命中时返回 undefined（调用方跳过回滚）
+ *
+ * @example
+ * const prev = applyChildBookingStatus(tempOrder.bookings, 301, 'confirmed');
+ */
+export declare function applyChildBookingStatus(bookings: any[] | null | undefined, scheduleEventId: number | string, status: string): string | undefined;
+/**
+ * 撤销 applyChildBookingStatus 对单条子预约的乐观写入。
+ *
+ * @example
+ * restoreChildBookingStatus(tempOrder.bookings, 301, prev);
+ */
+export declare function restoreChildBookingStatus(bookings: any[] | null | undefined, scheduleEventId: number | string, previous: string | undefined): void;

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

@@ -0,0 +1,136 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+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) {
+  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?.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?.appointment_status);
+  bookings.forEach(b => {
+    if (b) b.appointment_status = status;
+  });
+  return previous;
+}
+
+/**
+ * 把 applyBookingsStatus 的返回值原地写回，撤销乐观更新。
+ * 长度不一致时按较短一方对齐（防御式编程，正常路径不会发生）。
+ */
+function restoreBookingsStatus(bookings, previous) {
+  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];
+  }
+}
+
+/**
+ * 将状态机 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',
+    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) {
+  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 === undefined) return;
+  const idx = bookings.findIndex(b => b && String(b.schedule_event_id) === String(scheduleEventId));
+  if (idx === -1) return;
+  bookings[idx].appointment_status = previous;
+}