@pisell/pisellos 2.2.244 → 2.2.246

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/bookingStatus.d.ts

@@ -9,6 +9,21 @@
  * 字段含义严格对齐既有协议（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。
  *
@@ -35,3 +50,28 @@ export declare function applyBookingsStatus(bookings: any[] | null | undefined,
  * 长度不一致时按较短一方对齐（防御式编程，正常路径不会发生）。
  */
 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

@@ -20,8 +20,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var bookingStatus_exports = {};
 __export(bookingStatus_exports, {
   applyBookingsStatus: () => applyBookingsStatus,
+  applyChildBookingStatus: () => applyChildBookingStatus,
   resolveScheduleId: () => resolveScheduleId,
-  restoreBookingsStatus: () => restoreBookingsStatus
+  resolveStatusAfterTransition: () => resolveStatusAfterTransition,
+  restoreBookingsStatus: () => restoreBookingsStatus,
+  restoreChildBookingStatus: () => restoreChildBookingStatus
 });
 module.exports = __toCommonJS(bookingStatus_exports);
 function resolveScheduleId(tempOrder) {
@@ -57,9 +60,48 @@ function restoreBookingsStatus(bookings, previous) {
       b.appointment_status = previous[i];
   }
 }
+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;
+}
+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;
+  bookings[idx].appointment_status = status;
+  return previous;
+}
+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;
+  bookings[idx].appointment_status = previous;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   applyBookingsStatus,
+  applyChildBookingStatus,
   resolveScheduleId,
-  restoreBookingsStatus
+  resolveStatusAfterTransition,
+  restoreBookingsStatus,
+  restoreChildBookingStatus
 });

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 客户视图。

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

@@ -25,6 +25,7 @@ __export(cartView_exports, {
   isWalkInCustomer: () => isWalkInCustomer
 });
 module.exports = __toCommonJS(cartView_exports);
+var import_addTimeAvailability = require("./addTimeAvailability");
 function indexBookingsByProductUid(bookings) {
   if (!Array.isArray(bookings) || bookings.length === 0)
     return {};
@@ -51,31 +52,85 @@ function indexProductsByUid(lines) {
     return acc;
   }, {});
 }
-function buildCartView(lines, bookings) {
+function getBookingUid(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 getProductBookingUid(line) {
+  var _a;
+  const uid = (line == null ? void 0 : line.booking_uid) ?? ((_a = line == null ? void 0 : line.metadata) == null ? void 0 : _a.booking_uid);
+  return uid === void 0 || uid === null ? "" : String(uid);
+}
+function isAddTimeProductLine(line) {
+  var _a, _b;
+  return ((_a = line == null ? void 0 : line.metadata) == null ? void 0 : _a.product_add_schedule_time) !== void 0 && ((_b = line == null ? void 0 : line.metadata) == null ? void 0 : _b.product_add_schedule_time) !== null;
+}
+function indexAddTimeProductsByBookingUid(lines) {
+  return lines.reduce((acc, line) => {
+    if (!isAddTimeProductLine(line))
+      return acc;
+    const bookingUid = getProductBookingUid(line);
+    if (!bookingUid)
+      return acc;
+    if (!acc[bookingUid])
+      acc[bookingUid] = [];
+    acc[bookingUid].push(line);
+    return acc;
+  }, {});
+}
+function isGiftProductLine(line) {
+  var _a;
+  return Boolean((_a = line == null ? void 0 : line.metadata) == null ? void 0 : _a._giftInfo);
+}
+function buildCartView(lines, bookings, options = {}) {
   const productLines = Array.isArray(lines) ? lines : [];
   const bookingList = Array.isArray(bookings) ? bookings : [];
   const linesByUid = indexProductsByUid(productLines);
+  const addTimeLinesByBookingUid = indexAddTimeProductsByBookingUid(productLines);
   const claimedUids = /* @__PURE__ */ new Set();
-  const cartBookings = bookingList.filter((booking) => booking.parent_id !== 0).map((booking) => {
+  const claimedAddTimeLines = /* @__PURE__ */ new Set();
+  const cartBookings = bookingList.filter((booking) => booking.parent_id !== 0).reduce((acc, booking) => {
     const uid = booking == null ? void 0 : booking.product_uid;
+    const bookingUid = getBookingUid(booking);
     let product = null;
     if (uid !== void 0 && uid !== null && uid !== "") {
       const key = String(uid);
       if (!claimedUids.has(key)) {
         const line = linesByUid[key];
+        if (isGiftProductLine(line))
+          return acc;
         if (line) {
           claimedUids.add(key);
           product = line;
         }
       }
     }
-    return {
+    const addTimeProduct = bookingUid ? addTimeLinesByBookingUid[bookingUid] || [] : [];
+    addTimeProduct.forEach((line) => claimedAddTimeLines.add(line));
+    acc.push({
       ...booking,
-      _extend: { product }
-    };
-  });
+      _extend: {
+        product,
+        addTimeProduct,
+        canAddTime: (0, import_addTimeAvailability.resolveBookingCanAddTime)({
+          booking,
+          product,
+          addTimeProducts: options.addTimeProducts,
+          bookingConfig: options.bookingConfig,
+          productsByUid: options.productsByUid,
+          shopOpeningHours: options.shopOpeningHours
+        })
+      }
+    });
+    return acc;
+  }, []);
   const items = productLines.filter((line) => {
     var _a;
+    if (isGiftProductLine(line))
+      return false;
+    if (claimedAddTimeLines.has(line))
+      return false;
     const uid = (_a = line.metadata) == null ? void 0 : _a.unique_identification_number;
     if (uid === void 0 || uid === null || uid === "")
       return true;

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

@@ -0,0 +1,123 @@
+declare let data: ({
+    id: number;
+    title: string;
+    price: number;
+    minMinutes: number;
+    maxMinutes: number;
+    unitMinutes: number;
+    unlimited: boolean;
+    _originalProduct: {
+        id: number;
+        extension_id: number;
+        extension_type: string;
+        shop_id: number;
+        title: string;
+        slug: string;
+        status: string;
+        stock_quantity: number;
+        sales_quantity: number;
+        sum_stock: number;
+        price: string;
+        original_price: string;
+        cost_price: string;
+        cover: string;
+        channel_application: string[];
+        is_track: number;
+        over_sold: number;
+        is_gst: number;
+        code: string;
+        barcode: string;
+        is_delivery: number;
+        weight_unit: string;
+        weight_value: string;
+        type: string;
+        unit: string;
+        sort: number;
+        subtitle: string;
+        minimum_markup_price: string;
+        is_bundle: number;
+        description: string;
+        open_sold_weight: number;
+        unit_value: number;
+        is_variant: number;
+        variant_count: number;
+        add_time: {
+            unit_duration: number;
+            min_add_time: number;
+            max_add_time: number;
+            calculate_type: string;
+            relation_product: {
+                type: string;
+                products: never[];
+            };
+            additional_time_options?: undefined;
+        };
+        shelf_product_datas: never[];
+        step_value: number;
+        min_num_unit: number;
+        is_charge_tax: number;
+        base_price: string;
+        variant: never[];
+    };
+} | {
+    id: number;
+    title: string;
+    price: number;
+    minMinutes: number;
+    maxMinutes: number;
+    unitMinutes: number;
+    unlimited: boolean;
+    _originalProduct: {
+        id: number;
+        extension_id: number;
+        extension_type: string;
+        shop_id: number;
+        title: string;
+        slug: string;
+        status: string;
+        stock_quantity: number;
+        sales_quantity: number;
+        sum_stock: number;
+        price: string;
+        original_price: string;
+        cost_price: string;
+        cover: string;
+        channel_application: string[];
+        is_track: number;
+        over_sold: number;
+        is_gst: number;
+        code: string;
+        barcode: string;
+        is_delivery: number;
+        weight_unit: string;
+        weight_value: string;
+        type: string;
+        unit: string;
+        sort: number;
+        subtitle: string;
+        minimum_markup_price: string;
+        is_bundle: number;
+        description: string;
+        open_sold_weight: number;
+        unit_value: number;
+        is_variant: number;
+        variant_count: number;
+        add_time: {
+            additional_time_options: string;
+            unit_duration: number;
+            min_add_time: number;
+            max_add_time: number;
+            calculate_type: string;
+            relation_product: {
+                type: string;
+                products: never[];
+            };
+        };
+        shelf_product_datas: never[];
+        step_value: number;
+        min_num_unit: number;
+        is_charge_tax: number;
+        base_price: string;
+        variant: never[];
+    };
+})[];

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

@@ -0,0 +1,185 @@
+/**
+ * 计算指定加时时长下的最优购买方案。
+ *
+ * 输入的商品结构来自旧版 booking addTimeModal 的加时商品配置映射：
+ * - `minMinutes`：该商品第一次可选择的最小时长。
+ * - `maxMinutes`：单次购买该商品可覆盖的最大时长。
+ * - `unitMinutes`：超过最小时长后，每次递增的时长切片。
+ * - `price`：每个 `unitMinutes` 切片的价格。
+ * - `unlimited`：固定价格商品，可覆盖任意目标时长。
+ *
+ * 算法流程：
+ *
+ * ```
+ * products
+ *   |
+ *   v
+ * 将每个普通商品展开成有限候选档位
+ *   商品 A: min=30, max=60, unit=10, price=10
+ *   => 30m/$30, 40m/$40, 50m/$50, 60m/$60
+ *   |
+ *   v
+ * 单独加入 unlimited 候选
+ *   unlimited 商品 => targetMinutes / 固定商品价格
+ *   |
+ *   v
+ * 按 covered minutes 做动态规划
+ *   dp[minutes] = 正好覆盖 `minutes` 时的最低价候选组合
+ *   |
+ *   v
+ * 从所有 dp[minutes >= targetMinutes] 中挑选最优方案
+ * ```
+ *
+ * 候选档位生成刻意对齐旧版 addTimeModal：
+ * `totalPrice = minutes / unitMinutes * price`.
+ * 例如 `minMinutes=30`、`unitMinutes=10`、`price=10` 时：
+ * - 30 分钟 => 30 / 10 * 10 = 30
+ * - 60 分钟 => 60 / 10 * 10 = 60
+ *
+ * 目标时长不要求精确命中某个档位，只需要覆盖即可。例如目标是 51 分钟时，
+ * 60 分钟档位可以作为候选。动态规划也允许跨商品组合，例如商品 A 的 30m
+ * 加上商品 B 的 30m。最终方案按以下优先级比较：
+ * 1. 总价更低；
+ * 2. 超出时长更少，即 `coveredMinutes - targetMinutes` 更小；
+ * 3. 结果行数更少，让购买方案尽量简单。
+ *
+ * 典型匹配示例：
+ *
+ * 示例 1：精确命中，直接选择更便宜的商品。
+ * ```
+ * target = 30
+ * 商品 A: min=30, max=30, unit=30, price=10 => 30m/$10
+ * 商品 B: min=30, max=30, unit=30, price=8  => 30m/$8
+ * 结果：选择商品 B，coveredMinutes=30，totalPrice=8
+ * ```
+ *
+ * 示例 2：目标时长落在两个档位之间，向上选择可覆盖的档位。
+ * ```
+ * target = 51
+ * 商品 A: min=30, max=120, unit=10, price=10
+ * 候选：30m/$30, 40m/$40, 50m/$50, 60m/$60 ...
+ * 结果：50m 不足以覆盖 51m，因此选择 60m/$60
+ * ```
+ *
+ * 示例 3：不同商品都能覆盖同一目标时长，比较最终价格。
+ * ```
+ * target = 51
+ * 商品 A: min=30, max=120, unit=10, price=10 => 60m/$60
+ * 商品 B: min=30, max=120, unit=30, price=25 => 60m/$50
+ * 结果：两个方案都覆盖 60m，但商品 B 更便宜，所以选择商品 B
+ * ```
+ *
+ * 示例 4：允许跨商品组合，组合价更低时会选择组合。
+ * ```
+ * target = 90
+ * 商品 A: min=30, max=30, unit=30, price=5  => 30m/$5
+ * 商品 B: min=60, max=60, unit=60, price=8  => 60m/$8
+ * 商品 C: min=90, max=90, unit=90, price=20 => 90m/$20
+ * 结果：商品 A + 商品 B = 90m/$13，比商品 C 更便宜
+ * ```
+ *
+ * 示例 5：允许重复购买同一个候选档位。
+ * ```
+ * target = 90
+ * 商品 A: min=30, max=30, unit=30, price=5 => 30m/$5
+ * 结果：购买 3 份商品 A，coveredMinutes=90，totalPrice=15，
+ * lines 中会合并为一行：product_add_schedule_time=30，num=3
+ * ```
+ *
+ * 示例 6：unlimited 可以覆盖任意目标时长，并参与价格比较。
+ * ```
+ * target = 180
+ * 商品 A: min=30, max=120, unit=30, price=10
+ * 商品 B: unlimited=true, price=35
+ * 普通商品可以组合成 180m，例如 120m + 60m，总价 $60
+ * unlimited 商品固定 $35
+ * 结果：选择 unlimited 商品，coveredMinutes=180，totalPrice=35
+ * ```
+ *
+ * 示例 7：unlimited 不一定优先，普通商品更便宜时选择普通商品。
+ * ```
+ * target = 60
+ * 商品 A: min=30, max=60, unit=30, price=10 => 60m/$20
+ * 商品 B: unlimited=true, price=50
+ * 结果：选择商品 A 的 60m 档位
+ * ```
+ *
+ * 示例 8：价格相同，优先选择超出时长更少的方案。
+ * ```
+ * target = 51
+ * 商品 A: 60m/$20
+ * 商品 B: 90m/$20
+ * 结果：选择 60m，因为 overage=9，小于 90m 的 overage=39
+ * ```
+ *
+ * 示例 9：价格和覆盖时长都相同，优先选择结果行数更少的方案。
+ * ```
+ * target = 60
+ * 商品 A: 60m/$20
+ * 商品 B: 30m/$10
+ * 商品 C: 30m/$10
+ * 结果：商品 A 单行方案和 B+C 两行方案价格、时长相同，选择商品 A
+ * ```
+ *
+ * 示例 10：没有任何有效商品时返回 `NO_PRODUCTS`。
+ * ```
+ * target = 30
+ * products = []
+ * 结果：available=false，unavailableReason='NO_PRODUCTS'
+ * ```
+ *
+ * 示例 11：有商品但没有可用候选时返回 `NO_COVERAGE`。
+ * ```
+ * target = 30
+ * 商品 A: price=0，或 minMinutes 缺失/无效
+ * 结果：available=false，unavailableReason='NO_COVERAGE'
+ * ```
+ *
+ * 示例 12：目标时长小于等于 0 时无需购买。
+ * ```
+ * target = 0
+ * 结果：available=true，coveredMinutes=0，totalPrice=0，lines=[]
+ * ```
+ *
+ * 搜索边界：
+ * 有限档位只需要搜索到 `targetMinutes + maxFiniteCandidateMinutes`。
+ * 这里的 `maxFiniteCandidateMinutes` 是所有普通候选档位里的最大时长。
+ * 例如目标是 51 分钟，最大普通档位是 120 分钟，则只搜索到 171 分钟。
+ * 如果某个组合覆盖了 180 分钟，那么移除其中任意一个普通档位后，剩余时长
+ * 仍然有机会覆盖 51 分钟，而且价格一定不会更高，所以 180 分钟这个组合不
+ * 可能是最优解。
+ */
+export interface AddTimeProduct {
+    id: string | number;
+    title?: string;
+    price: number;
+    minMinutes?: number;
+    maxMinutes?: number;
+    unitMinutes?: number;
+    unlimited?: boolean;
+    _originalProduct?: unknown;
+}
+export interface AddTimePlanLine {
+    product_id: string | number;
+    product_title?: string;
+    product_add_schedule_time: number;
+    num: number;
+    price: number;
+    _originalProduct?: unknown;
+}
+export interface AddTimePlan {
+    available: boolean;
+    unavailableReason?: 'NO_PRODUCTS' | 'NO_COVERAGE';
+    targetMinutes: number;
+    coveredMinutes: number;
+    totalPrice: number;
+    lines: AddTimePlanLine[];
+}
+interface AddTimeCandidate extends AddTimePlanLine {
+    totalPrice: number;
+    unlimited?: boolean;
+}
+export declare const ADD_TIME_UNIT_MINUTES: readonly [10, 15, 20, 30, 45, 60];
+export declare function buildAddTimeCandidates(products: AddTimeProduct[]): AddTimeCandidate[];
+export declare function resolveBestAddTimePlan(products: AddTimeProduct[], targetMinutes: number): AddTimePlan;
+export {};