@pisell/pisellos 2.2.233 → 2.2.234

package/lib/solution/BaseSales/index.js

@@ -1279,13 +1279,13 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       throw new Error("BaseSales 解决方案需要 order 模块支持");
     }
     const inferredPaymentStatus = this.getSubmitPaymentStatus(params == null ? void 0 : params.paymentStatus);
-    debugger;
     const submitParams = {
       cacheId: this.cacheId,
       platform: (_a = this.otherParams) == null ? void 0 : _a.platform,
       businessCode: ((_b = this.otherParams) == null ? void 0 : _b.businessCode) || ((_c = this.otherParams) == null ? void 0 : _c.business_code),
       channel: this.getSubmitOrderSalesChannel(),
       type: (_d = this.otherParams) == null ? void 0 : _d.type,
+      request_unique_idempotency_token: this.store.order.generateIdempotencyToken(),
       ...(params == null ? void 0 : params.payments) !== void 0 ? { payments: params.payments } : {},
       ...inferredPaymentStatus !== void 0 ? { paymentStatus: inferredPaymentStatus } : {},
       ...(params == null ? void 0 : params.smallTicketDataFlag) !== void 0 ? { smallTicketDataFlag: params.smallTicketDataFlag } : {},
@@ -1293,6 +1293,25 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     };
     return this.store.order.submitTempOrder(submitParams);
   }
+  async submitTempOrderAsync(params) {
+    var _a, _b, _c, _d;
+    if (!this.store.order) {
+      throw new Error("BaseSales 解决方案需要 order 模块支持");
+    }
+    const inferredPaymentStatus = this.getSubmitPaymentStatus(params == null ? void 0 : params.paymentStatus);
+    const submitParams = {
+      cacheId: this.cacheId,
+      platform: (_a = this.otherParams) == null ? void 0 : _a.platform,
+      businessCode: ((_b = this.otherParams) == null ? void 0 : _b.businessCode) || ((_c = this.otherParams) == null ? void 0 : _c.business_code),
+      channel: this.getSubmitOrderSalesChannel(),
+      type: (_d = this.otherParams) == null ? void 0 : _d.type,
+      ...(params == null ? void 0 : params.payments) !== void 0 ? { payments: params.payments } : {},
+      ...inferredPaymentStatus !== void 0 ? { paymentStatus: inferredPaymentStatus } : {},
+      ...(params == null ? void 0 : params.smallTicketDataFlag) !== void 0 ? { smallTicketDataFlag: params.smallTicketDataFlag } : {},
+      ...(params == null ? void 0 : params.enhancePayload) !== void 0 ? { enhancePayload: params.enhancePayload } : {}
+    };
+    return this.store.order.submitTempOrderAsync(submitParams);
+  }
   async printLocalOrderReceipt(lookup) {
     var _a, _b, _c, _d, _e, _f, _g;
     if (!this.store.order) {

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

@@ -311,7 +311,7 @@ export declare class BookingByStepImpl extends BaseModule implements Module {
         date: string;
         status: string;
         week: string;
-        weekNum: 0 | 1 | 5 | 4 | 2 | 3 | 6;
+        weekNum: 0 | 2 | 1 | 5 | 3 | 4 | 6;
     }[]>;
     submitTimeSlot(timeSlots: TimeSliceItem): void;
     private getScheduleDataByIds;

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

@@ -1,13 +1,14 @@
 import { Module, ModuleOptions, PisellCore } from '../../types';
 import { BookingTicketCartView, BookingTicketProductCatalogView, BookingTicketState, IGetCustomerListParams, ICustomer, ILoadProductsParams, ILoadProductDetailParams, IScanResult } from './types';
 import type { ProductData } from '../../modules';
+import type { OpenDataConfig } from '../../modules/OpenData';
 import { type BookingContextConfig, type BookingContextDateInput, type BookingContextResource, type BookingContextResourceMap, type BookingContextState, type InitBookingContextParams, type LoadBookingConfigParams, type LoadBookingResourcesParams, type ResourceError, type BookingCalcContext } from '../../modules/BookingContext';
 import type { OrderCustomerView } from '../../modules/Order/types';
 import { BaseSalesImpl } from '../BaseSales';
 import type { BaseSalesScanCodeResult } from '../BaseSales/types';
 import type { ISalesDetail } from '../BaseSales/utils/parseSalesResponse';
 import type { LoadSalesDetailParams } from '../../modules/Order/types';
-import type { GlobalScanHandleResult, GlobalScanHostBridge } from './types';
+import type { AddAddTimeProductToBookingInput, AddAddTimeProductsToBookingInput, GlobalScanHandleResult, GlobalScanHostBridge } from './types';
 import { AddProductDecideContext, AddProductRequiresDetailPayload } from './utils/addProductDecision';
 import { type BuildCacheItemFromOrderLineInput } from '../../modules/BookingContext/utils/buildCacheItemFromOrderLine';
 import { type BuildNormalProductCacheItemFromOrderLineInput } from '../../modules/BookingContext/utils/buildNormalProductCacheItemFromOrderLine';
@@ -25,6 +26,7 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
     private platform;
     private scan;
     private productCatalog;
+    private addTimeProductsCatalog;
     private orderCustomerDiscountRefreshInFlight;
     private orderCustomerDiscountRefreshCustomerId;
     private loadOpenDataConfigInFlight;
@@ -43,6 +45,7 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
     private getBookingTicketBusinessCode;
     private getIdGeneratorPlugin;
     private loadOpenDataConfig;
+    getOpenData(): Promise<OpenDataConfig | null>;
     private getShortNumberOrDeviceId;
     private configureIdGeneratorFromOpenData;
     private normalizePositiveInteger;
@@ -319,7 +322,7 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
      * 获取当前的客户搜索条件
      * @returns 当前搜索条件
      */
-    getCurrentCustomerSearchParams(): Omit<import("../../modules").ShopGetCustomerListParams, "skip" | "num">;
+    getCurrentCustomerSearchParams(): Omit<import("../../modules").ShopGetCustomerListParams, "num" | "skip">;
     /**
      * 获取客户列表状态（包含滚动加载相关状态）
      * @returns 客户状态
@@ -512,6 +515,39 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
      */
     handleGlobalScanCode(code: string, bridge?: GlobalScanHostBridge): Promise<GlobalScanHandleResult>;
     resolveBestAddTimePlan(addTimeProducts: any[], targetMinutes: number): any;
+    /**
+     * 构造一条绑定到已有 booking 的加时商品行。
+     *
+     * @example
+     * const line = this.buildAddTimeOrderLine({ product, product_add_schedule_time: 30 }, 'booking-1');
+     */
+    private buildAddTimeOrderLine;
+    /**
+     * 将加时商品作为独立商品行绑定到已有 booking。
+     *
+     * 与预约商品加车不同，本方法不会把当前 booking 作为 `addProductToOrder` 第二参数传入，
+     * 避免 OrderModule 新建 booking 或重写已有 booking.product_uid。
+     *
+     * @example
+     * await bookingTicket.addAddTimeProductToBooking({
+     *   booking,
+     *   product,
+     *   num: 1,
+     *   price: '10.00',
+     *   product_add_schedule_time: 30,
+     * });
+     */
+    addAddTimeProductToBooking(input: AddAddTimeProductToBookingInput): Promise<OrderProduct[]>;
+    /**
+     * 批量将加时商品作为独立商品行绑定到已有 booking，并只触发一次购物车重算。
+     *
+     * @example
+     * await bookingTicket.addAddTimeProductsToBooking({
+     *   booking,
+     *   products: [{ product, product_add_schedule_time: 30 }],
+     * });
+     */
+    addAddTimeProductsToBooking(input: AddAddTimeProductsToBookingInput): Promise<OrderProduct[]>;
     /**
      * 销毁模块：先调用父类（销毁所有 store 内子模块 + emit destroy + super.destroy()），
      * 再清理 BookingTicket 自有资源（scan 监听 + scan 内存缓存）。

package/lib/solution/BookingTicket/index.js

@@ -34,6 +34,7 @@ __export(BookingTicket_exports, {
   BookingTicketImpl: () => BookingTicketImpl
 });
 module.exports = __toCommonJS(BookingTicket_exports);
+var import_dayjs = __toESM(require("dayjs"));
 var import_types = require("./types");
 var import_BookingContext = require("../../modules/BookingContext");
 var import_BaseSales = require("../BaseSales");
@@ -54,6 +55,57 @@ var import_resolveBestAddTimePlan = require("./utils/resolveBestAddTimePlan");
 __reExport(BookingTicket_exports, require("./types"), module.exports);
 var OPEN_DATA_SECTION_CODES = ["sale", "reservation", "fulfillment", "menu", "workflow"];
 var OPEN_DATA_CACHE_TTL = 5 * 60 * 1e3;
+function resolveBookingUidForAddTime(booking) {
+  var _a;
+  const uid = (_a = booking == null ? void 0 : booking.metadata) == null ? void 0 : _a.unique_identification_number;
+  return uid === void 0 || uid === null ? "" : String(uid);
+}
+function normalizeAddTimeQuantity(value) {
+  const parsed = Math.floor(Number(value));
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : 1;
+}
+function resolveAddTimeScheduleMinutes(explicitValue, product) {
+  const raw = explicitValue ?? (product == null ? void 0 : product.product_add_schedule_time);
+  if (raw === void 0 || raw === null || raw === "")
+    return void 0;
+  const parsed = Number(raw);
+  return Number.isFinite(parsed) ? parsed : void 0;
+}
+function resolveAddTimeProductPrice(explicitValue, product) {
+  return explicitValue ?? (product == null ? void 0 : product.price) ?? (product == null ? void 0 : product.selling_price) ?? (product == null ? void 0 : product.base_price);
+}
+function normalizeCoveredMinutes(value) {
+  const parsed = Math.ceil(Number(value));
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : 0;
+}
+function buildAddTimeBookingTimePatch(booking, coveredMinutes) {
+  if (coveredMinutes <= 0)
+    return null;
+  const endDate = booking == null ? void 0 : booking.end_date;
+  const endTime = booking == null ? void 0 : booking.end_time;
+  if (!endDate || !endTime) {
+    throw new Error("[BookingTicket] addAddTimeProductsToBooking: booking.end_date/end_time 缺失");
+  }
+  const currentEnd = (0, import_dayjs.default)(`${endDate} ${endTime}`);
+  if (!currentEnd.isValid()) {
+    throw new Error("[BookingTicket] addAddTimeProductsToBooking: booking.end_date/end_time 无效");
+  }
+  const nextEnd = currentEnd.add(coveredMinutes, "minute");
+  const currentDuration = Number(booking == null ? void 0 : booking.duration);
+  let duration = Number.isFinite(currentDuration) ? currentDuration + coveredMinutes : coveredMinutes;
+  if ((booking == null ? void 0 : booking.start_date) && (booking == null ? void 0 : booking.start_time)) {
+    const start = (0, import_dayjs.default)(`${booking.start_date} ${booking.start_time}`);
+    if (start.isValid()) {
+      const diffMinutes = nextEnd.diff(start, "minute");
+      duration = diffMinutes > 0 ? diffMinutes : duration;
+    }
+  }
+  return {
+    end_date: nextEnd.format("YYYY-MM-DD"),
+    end_time: nextEnd.format("HH:mm"),
+    duration
+  };
+}
 function withProductOptionString(cacheItem) {
   var _a;
   const productOptionString = (0, import_orderLineDisplay.buildProductOptionStringFromOrderLine)(cacheItem);
@@ -79,6 +131,7 @@ var BookingTicketImpl = class extends import_BaseSales.BaseSalesImpl {
      */
     this.store = {};
     this.productCatalog = [];
+    this.addTimeProductsCatalog = [];
     this.orderCustomerDiscountRefreshInFlight = null;
     this.orderCustomerDiscountRefreshCustomerId = null;
     this.loadOpenDataConfigInFlight = null;
@@ -164,6 +217,10 @@ var BookingTicketImpl = class extends import_BaseSales.BaseSalesImpl {
       this.loadOpenDataConfigInFlight = null;
     }
   }
+  async getOpenData() {
+    var _a;
+    return (_a = this.store.openData) == null ? void 0 : _a.getOpenData();
+  }
   async getShortNumberOrDeviceId() {
     const getAsyncIotDeviceInfo = this.getAppData("async_iot_device_info");
     if (getAsyncIotDeviceInfo) {
@@ -520,10 +577,12 @@ var BookingTicketImpl = class extends import_BaseSales.BaseSalesImpl {
    * const products = await bookingTicket.getAddTimeProducts({ schedule_date: '2026-06-16' });
    */
   async getAddTimeProducts(params = {}) {
-    return this.store.products.getAddTimeProducts({
+    const result = await this.store.products.getAddTimeProducts({
       ...params,
       cacheId: this.cacheId
     });
+    this.addTimeProductsCatalog = Array.isArray(result) ? [...result] : [];
+    return result;
   }
   /**
    * 只读查询单商品详情：走 ProductList 报价查询，但不写 productCatalog、
@@ -610,11 +669,23 @@ var BookingTicketImpl = class extends import_BaseSales.BaseSalesImpl {
    * tempOrder 仍是 checkout 协议对象；商品行直接透传 products，bookings 附带关联商品。
    */
   getCart() {
-    var _a;
+    var _a, _b;
     const tempOrder = ((_a = this.store.order) == null ? void 0 : _a.getTempOrder()) ?? null;
     const salesDetail = this.getSalesOrder();
     const bookings = (salesDetail == null ? void 0 : salesDetail.bookings) ?? ((tempOrder == null ? void 0 : tempOrder.bookings) || []);
-    return (0, import_cartView.buildCartView)((tempOrder == null ? void 0 : tempOrder.products) || [], bookings);
+    let operatingDayBoundary;
+    try {
+      operatingDayBoundary = this.getAppData("operating_day_boundary");
+    } catch {
+      operatingDayBoundary = void 0;
+    }
+    const shopOpeningHours = (operatingDayBoundary == null ? void 0 : operatingDayBoundary.type) === "start_time" ? "23:59" : operatingDayBoundary == null ? void 0 : operatingDayBoundary.time;
+    return (0, import_cartView.buildCartView)((tempOrder == null ? void 0 : tempOrder.products) || [], bookings, {
+      addTimeProducts: this.addTimeProductsCatalog,
+      bookingConfig: this.getBookingConfig(),
+      productsByUid: (_b = tempOrder == null ? void 0 : tempOrder._extend) == null ? void 0 : _b.productsByUid,
+      shopOpeningHours
+    });
   }
   /**
    * 获取当前下单客户（与 OrderModule.tempOrder snapshot 一致）。
@@ -1304,6 +1375,126 @@ var BookingTicketImpl = class extends import_BaseSales.BaseSalesImpl {
   resolveBestAddTimePlan(addTimeProducts, targetMinutes) {
     return (0, import_resolveBestAddTimePlan.resolveBestAddTimePlan)(addTimeProducts, targetMinutes);
   }
+  /**
+   * 构造一条绑定到已有 booking 的加时商品行。
+   *
+   * @example
+   * const line = this.buildAddTimeOrderLine({ product, product_add_schedule_time: 30 }, 'booking-1');
+   */
+  buildAddTimeOrderLine(input, bookingUid) {
+    var _a;
+    const product = input == null ? void 0 : input.product;
+    if (!product || typeof product !== "object") {
+      throw new Error("[BookingTicket] addAddTimeProductToBooking: product 不能为空");
+    }
+    const quantity = normalizeAddTimeQuantity(input.num ?? product.num);
+    const price = resolveAddTimeProductPrice(input.price, product);
+    const addScheduleTime = resolveAddTimeScheduleMinutes(
+      input.product_add_schedule_time,
+      product
+    );
+    const payload = {
+      id: product.id ?? product.product_id,
+      product_id: product.product_id ?? product.id,
+      product_variant_id: product.product_variant_id ?? product.variant_id ?? 0,
+      variant_id: product.variant_id ?? product.product_variant_id ?? 0,
+      quantity,
+      num: quantity,
+      price,
+      selling_price: price,
+      original_price: product.original_price ?? price,
+      line_total: price,
+      total: price,
+      product_sku: product.product_sku,
+      option: product.option ?? product.options ?? ((_a = product.product_sku) == null ? void 0 : _a.option) ?? [],
+      bundle: product.bundle ?? product.bundles ?? product.product_bundle ?? []
+    };
+    const orderLine = this.transformBaseProductToOrderProduct({
+      payload,
+      fallbackProductId: product.id ?? product.product_id,
+      sourceProduct: product,
+      sourceItem: product
+    });
+    if (!orderLine) {
+      throw new Error(
+        "[BookingTicket] addAddTimeProductToBooking: product transform failed"
+      );
+    }
+    const metadata = {
+      ...orderLine.metadata || {},
+      ...addScheduleTime !== void 0 ? { product_add_schedule_time: addScheduleTime } : {},
+      booking_uid: bookingUid
+    };
+    return {
+      ...orderLine,
+      booking_uid: bookingUid,
+      metadata
+    };
+  }
+  /**
+   * 将加时商品作为独立商品行绑定到已有 booking。
+   *
+   * 与预约商品加车不同，本方法不会把当前 booking 作为 `addProductToOrder` 第二参数传入，
+   * 避免 OrderModule 新建 booking 或重写已有 booking.product_uid。
+   *
+   * @example
+   * await bookingTicket.addAddTimeProductToBooking({
+   *   booking,
+   *   product,
+   *   num: 1,
+   *   price: '10.00',
+   *   product_add_schedule_time: 30,
+   * });
+   */
+  async addAddTimeProductToBooking(input) {
+    return this.addAddTimeProductsToBooking({
+      booking: input.booking,
+      products: [input],
+      coveredMinutes: input.coveredMinutes,
+      bookingPatch: input.bookingPatch
+    });
+  }
+  /**
+   * 批量将加时商品作为独立商品行绑定到已有 booking，并只触发一次购物车重算。
+   *
+   * @example
+   * await bookingTicket.addAddTimeProductsToBooking({
+   *   booking,
+   *   products: [{ product, product_add_schedule_time: 30 }],
+   * });
+   */
+  async addAddTimeProductsToBooking(input) {
+    const bookingUid = resolveBookingUidForAddTime(input == null ? void 0 : input.booking);
+    if (!bookingUid) {
+      throw new Error(
+        "[BookingTicket] addAddTimeProductToBooking: booking.metadata.unique_identification_number 缺失"
+      );
+    }
+    const orderLines = (input.products || []).map((line) => ({
+      product: this.buildAddTimeOrderLine(line, bookingUid)
+    }));
+    if (!this.store.order)
+      throw new Error("order 模块未初始化");
+    const coveredMinutes = normalizeCoveredMinutes(input.coveredMinutes);
+    const bookingTimePatch = input.bookingPatch ?? buildAddTimeBookingTimePatch(input.booking, coveredMinutes);
+    if (bookingTimePatch) {
+      this.store.order.updateOrderBooking({
+        unique_identification_number: bookingUid,
+        updates: bookingTimePatch
+      });
+    }
+    if (typeof this.store.order.addProductsToOrder === "function") {
+      return this.store.order.addProductsToOrder(orderLines, {
+        skipEditDiscountConfigRefresh: true,
+        skipDiscountRecalculation: true
+      });
+    }
+    const result = [];
+    for (const line of orderLines) {
+      result.splice(0, result.length, ...await this.addProductToOrder(line.product));
+    }
+    return result;
+  }
   /**
    * 销毁模块：先调用父类（销毁所有 store 内子模块 + emit destroy + super.destroy()），
    * 再清理 BookingTicket 自有资源（scan 监听 + scan 内存缓存）。

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

@@ -112,6 +112,8 @@ export type BookingTicketCartItemView = BaseSalesOrderProduct;
 export interface BookingTicketCartBookingView extends ISalesBooking {
     _extend: {
         product: BookingTicketCartItemView | null;
+        addTimeProduct: BookingTicketCartItemView[];
+        canAddTime: boolean;
     };
 }
 /**
@@ -139,6 +141,66 @@ export interface BookingTicketCustomerView {
 export interface BookingTicketProductCatalogView {
     products: ProductData[];
 }
+/**
+ * 添加加时商品到已有 booking 的输入。
+ *
+ * @example
+ * await bookingTicket.addAddTimeProductToBooking({
+ *   booking,
+ *   product,
+ *   num: 1,
+ *   price: '10.00',
+ *   product_add_schedule_time: 30,
+ * });
+ */
+export interface AddAddTimeProductToBookingInput {
+    /** 当前购物车中已存在的 booking，必须带 metadata.unique_identification_number。 */
+    booking: Record<string, any>;
+    /** 加时商品原始数据，保留完整商品信息供 OrderModule 缓存原始快照。 */
+    product: ProductData & Record<string, any>;
+    /** 本次添加数量，缺省为 1。 */
+    num?: number;
+    /** 本次加时商品价格，缺省回退 product.price。 */
+    price?: number | string;
+    /** 加时时长，单位分钟；最终写入 product.metadata.product_add_schedule_time。 */
+    product_add_schedule_time?: number;
+    /** 本次加时方案实际覆盖分钟数，用于同步更新 booking 结束时间与 duration。 */
+    coveredMinutes?: number;
+    /** 直接写入 booking 的时间补丁，restart 场景使用。 */
+    bookingPatch?: {
+        start_date?: string;
+        start_time?: string;
+        end_date?: string;
+        end_time?: string;
+        duration?: number;
+    };
+}
+/**
+ * 批量添加加时商品到已有 booking 的单行输入。
+ *
+ * @example
+ * const line: AddAddTimeProductLineInput = { product, product_add_schedule_time: 30 };
+ */
+export type AddAddTimeProductLineInput = Omit<AddAddTimeProductToBookingInput, 'booking' | 'coveredMinutes'>;
+/**
+ * 批量添加加时商品到已有 booking 的输入。
+ *
+ * @example
+ * await bookingTicket.addAddTimeProductsToBooking({
+ *   booking,
+ *   products: [{ product, product_add_schedule_time: 30 }],
+ * });
+ */
+export interface AddAddTimeProductsToBookingInput {
+    /** 当前购物车中已存在的 booking，必须带 metadata.unique_identification_number。 */
+    booking: Record<string, any>;
+    /** 需要一次性写入购物车的加时商品行。 */
+    products: AddAddTimeProductLineInput[];
+    /** 本次加时方案实际覆盖分钟数，用于同步更新 booking 结束时间与 duration。 */
+    coveredMinutes?: number;
+    /** 直接写入 booking 的时间补丁，restart 场景使用。 */
+    bookingPatch?: AddAddTimeProductToBookingInput['bookingPatch'];
+}
 /** 扫码宿主桥接：SalesSdk 在 pubsub 订阅回调里注入，OS 需要 UI 时直接调用 */
 export interface GlobalScanHostBridge {
     openProductDetail?: (payload: Record<string, any>) => Promise<any | null>;

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,125 @@
+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);
+
+// src/solution/BookingTicket/utils/addTimeAvailability.ts
+var addTimeAvailability_exports = {};
+__export(addTimeAvailability_exports, {
+  buildAddTimeCurrentItem: () => buildAddTimeCurrentItem,
+  isUsableAddTimeProduct: () => isUsableAddTimeProduct,
+  resolveBookingCanAddTime: () => resolveBookingCanAddTime
+});
+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");
+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;
+  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 || ((_c = booking.product) == null ? void 0 : _c.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,
+      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
+    }
+  };
+}
+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 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)
+  );
+}
+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;
+  }
+  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 === "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/cartView.d.ts

@@ -2,6 +2,14 @@ import type { BaseSalesOrderProduct } from '../../BaseSales';
 import type { ISalesBooking } from '../../BaseSales/utils/parseSalesResponse';
 import type { BookingTicketCartView, BookingTicketCustomerView, ICustomer } from '../types';
 import type { ScanOrderTempOrder } from '../../ScanOrder/types';
+export interface BuildCartViewOptions {
+    addTimeProducts?: any[];
+    bookingConfig?: Record<string, any> | null;
+    productsByUid?: Record<string, {
+        origin?: Record<string, any>;
+    }>;
+    shopOpeningHours?: string;
+}
 /**
  * 仅按 booking.product_uid 建索引，避免发明 booking 与商品行之间的其它等价关系。
  */
@@ -13,7 +21,7 @@ export declare function indexBookingsByProductUid(bookings: ISalesBooking[] | un
  * 关联规则（1:1）：booking.product_uid ↔ line.metadata.unique_identification_number；
  * 同一 uid 已被更早的 booking 占用时，后续 booking 的 product 为 null。
  */
-export declare function buildCartView(lines: BaseSalesOrderProduct[] | undefined | null, bookings: ISalesBooking[] | undefined | null): BookingTicketCartView;
+export declare function buildCartView(lines: BaseSalesOrderProduct[] | undefined | null, bookings: ISalesBooking[] | undefined | null, options?: BuildCartViewOptions): BookingTicketCartView;
 export declare function isWalkInCustomer(customer: Pick<ICustomer, 'id'> | null | undefined): boolean;
 /**
  * selected 优先，缺失时回退 tempOrder.customer_*，统一输出 UI 客户视图。