@pisell/pisellos 2.2.181 → 2.2.183

package/lib/solution/BookingTicket/index.js

@@ -35,12 +35,16 @@ __export(BookingTicket_exports, {
 });
 module.exports = __toCommonJS(BookingTicket_exports);
 var import_types = require("./types");
+var import_BookingContext = require("../../modules/BookingContext");
 var import_BaseSales = require("../BaseSales");
 var import_scan = __toESM(require("./utils/scan"));
 var import_orderCustomer = require("./utils/orderCustomer");
 var import_handleScan = require("./utils/scan/handleScan");
 var import_scanCache = __toESM(require("./utils/scan/scanCache"));
 var import_cartView = require("./utils/cartView");
+var import_addProductDecision = require("./utils/addProductDecision");
+var import_buildCacheItemFromOrderLine = require("../../modules/BookingContext/utils/buildCacheItemFromOrderLine");
+var import_buildNormalProductCacheItemFromOrderLine = require("../../modules/BookingContext/utils/buildNormalProductCacheItemFromOrderLine");
 var import_bookingStatus = require("./utils/bookingStatus");
 __reExport(BookingTicket_exports, require("./types"), module.exports);
 var BookingTicketImpl = class extends import_BaseSales.BaseSalesImpl {
@@ -54,12 +58,18 @@ var BookingTicketImpl = class extends import_BaseSales.BaseSalesImpl {
      */
     this.store = {};
     this.productCatalog = [];
+    this.orderCustomerDiscountRefreshInFlight = null;
+    this.orderCustomerDiscountRefreshCustomerId = null;
   }
   /**
-   * 在 BaseSales 默认模块清单（products/order/salesSummary/schedule）基础上追加 customer。
+   * 在 BaseSales 默认模块清单（products/order/salesSummary/schedule）基础上追加 customer + bookingContext。
+   * bookingContext 是 SalesSdk 加车下沉所需的「预约 UI 上下文」（bookingConfig / resourcesOrigin / date）。
    */
   getRegisteredModuleNames() {
-    return [...super.getRegisteredModuleNames(), "customer"];
+    return [...super.getRegisteredModuleNames(), "customer", "bookingContext"];
+  }
+  getSubmitOrderSalesChannel() {
+    return "pos";
   }
   /**
    * 业务侧子模块工厂：BookingTicket 自带的 createBookingTicketModule 优先匹配；
@@ -93,25 +103,112 @@ var BookingTicketImpl = class extends import_BaseSales.BaseSalesImpl {
    */
   async loadSalesDetail(orderIdOrParams) {
     const sales = await super.loadSalesDetail(orderIdOrParams);
-    console.log(sales, "1234sales");
     const customerModule = this.store.customer;
     const detailCustomer = sales == null ? void 0 : sales.customer;
-    if (customerModule && detailCustomer) {
-      const { id: detailCustomerId, ...detailCustomerRest } = detailCustomer ?? {};
+    const orderCustomerSnapshot = this.store.order.getOrderCustomerSnapshot();
+    const protocolCustomerId = sales == null ? void 0 : sales.customer_id;
+    const protocolCustomer = protocolCustomerId !== void 0 && protocolCustomerId !== null ? {
+      id: protocolCustomerId,
+      name: String((sales == null ? void 0 : sales.customer_name) || ""),
+      phone: sales == null ? void 0 : sales.phone,
+      email: sales == null ? void 0 : sales.email,
+      country_calling_code: sales == null ? void 0 : sales.country_calling_code
+    } : null;
+    const selectedCustomer = detailCustomer ?? orderCustomerSnapshot ?? protocolCustomer;
+    if (customerModule && selectedCustomer) {
+      const { id: detailCustomerId, ...detailCustomerRest } = selectedCustomer ?? {};
       const rawId = detailCustomerId ?? "";
       const customer = {
         ...detailCustomerRest,
         id: rawId == null ? "" : rawId,
-        name: (detailCustomer == null ? void 0 : detailCustomer.name) ?? "",
-        phone: detailCustomer == null ? void 0 : detailCustomer.phone,
-        email: detailCustomer == null ? void 0 : detailCustomer.email,
-        country_calling_code: detailCustomer == null ? void 0 : detailCustomer.country_calling_code
+        name: (selectedCustomer == null ? void 0 : selectedCustomer.name) ?? "",
+        phone: selectedCustomer == null ? void 0 : selectedCustomer.phone,
+        email: selectedCustomer == null ? void 0 : selectedCustomer.email,
+        country_calling_code: selectedCustomer == null ? void 0 : selectedCustomer.country_calling_code
       };
       customerModule.setSelectedCustomer(customer);
       this.setOrderCustomer(customer);
+      await this.store.order.saveDraft();
     }
     return sales;
   }
+  async scanPromotionCode(code, customerId) {
+    if (!this.store.order)
+      throw new Error("order 模块未初始化");
+    const raw = await this.store.order.scanCode(code, customerId);
+    if (raw.isAvailable) {
+      await this.hydrateOrderCustomerFromScanDiscounts(raw.scannedDiscountList || []);
+      await this.store.order.recalculateSummary({ createIfMissing: true });
+      this.store.order.persistTempOrder();
+    }
+    return {
+      isAvailable: raw.isAvailable,
+      type: raw.type,
+      unavailableReason: raw.unavailableReason
+    };
+  }
+  async hydrateOrderCustomerFromScanDiscounts(discounts) {
+    const currentOrderCustomer = this.store.order.getOrderCustomer();
+    if (currentOrderCustomer)
+      return;
+    const customerId = this.getDiscountCustomerId(discounts);
+    if (!customerId)
+      return;
+    const customer = await this.resolveCustomerByDiscountCustomerId(customerId);
+    if (!customer)
+      return;
+    this.store.customer.setSelectedCustomer(customer);
+    this.setOrderCustomer(customer);
+  }
+  getDiscountCustomerId(discounts) {
+    const discount = discounts.find((item) => item.customer_id != null);
+    const customerId = Number(discount == null ? void 0 : discount.customer_id);
+    if (!Number.isFinite(customerId) || customerId <= 0)
+      return null;
+    return customerId;
+  }
+  async resolveCustomerByDiscountCustomerId(customerId) {
+    var _a;
+    const localCustomers = this.store.customer.getCustomers();
+    const localCustomer = this.findCustomerById(localCustomers, customerId);
+    const normalizedLocalCustomer = localCustomer ? this.normalizeCustomer(localCustomer) : null;
+    if (normalizedLocalCustomer && this.hasUsableCustomerDetails(normalizedLocalCustomer)) {
+      return normalizedLocalCustomer;
+    }
+    const result = await this.store.customer.queryCustomerList({
+      ids: [customerId],
+      skip: 1,
+      num: 1
+    });
+    const remoteCustomer = this.findCustomerById((result == null ? void 0 : result.list) || [], customerId) || ((_a = result == null ? void 0 : result.list) == null ? void 0 : _a[0]) || null;
+    return remoteCustomer ? this.normalizeCustomer(remoteCustomer) : null;
+  }
+  findCustomerById(customers = [], customerId) {
+    return customers.find((customer) => {
+      const rawId = this.getRawCustomerId(customer);
+      return rawId !== null && String(rawId) === String(customerId);
+    }) || null;
+  }
+  normalizeCustomer(customer) {
+    const raw = customer;
+    const rawId = this.getRawCustomerId(customer);
+    const name = customer.name || raw.display_name || raw.nickname || raw.customer_name || [raw.first_name, raw.last_name].filter(Boolean).join(" ") || "";
+    return {
+      ...customer,
+      id: rawId ?? customer.id,
+      name,
+      phone: customer.phone ?? raw.phone ?? raw.mobile ?? "",
+      email: customer.email ?? raw.email ?? "",
+      country_calling_code: customer.country_calling_code ?? raw.country_calling_code ?? ""
+    };
+  }
+  getRawCustomerId(customer) {
+    const raw = customer;
+    return customer.id ?? raw.customer_id ?? raw.customerId ?? null;
+  }
+  hasUsableCustomerDetails(customer) {
+    return !!(customer.name || customer.phone || customer.email || customer.display_name || customer.customer_name);
+  }
   /**
    * 更新当前预约的 appointment_status。
    *
@@ -192,6 +289,10 @@ var BookingTicketImpl = class extends import_BaseSales.BaseSalesImpl {
    */
   async loadProducts(params = {}, options) {
     const { schedule_date, customer_id, menu_list_ids, schedule_datetime } = params;
+    const bookingDate = schedule_datetime || schedule_date || "";
+    if (bookingDate) {
+      this.setBookingDate(bookingDate);
+    }
     try {
       const result = await this.store.products.loadProducts({
         with_count: ["bundleGroup", "optionGroup"],
@@ -207,6 +308,39 @@ var BookingTicketImpl = class extends import_BaseSales.BaseSalesImpl {
       throw error;
     }
   }
+  /**
+   * 只读查询单商品详情：走 ProductList 报价查询，但不写 productCatalog、
+   * 不 emit onProductsLoaded、不修改 BookingDate。
+   *
+   * 供「列表已 loadProducts、仅需补 product_resource / capacity」等场景使用，
+   * 避免 loadProductDetail 覆盖左侧商品列表。
+   *
+   * @example
+   * const detail = await bookingTicket.queryProductDetail({
+   *   product_id: 2,
+   *   schedule_date: '2030-01-15',
+   *   schedule_datetime: '2030-01-15 10:00:00',
+   * });
+   */
+  async queryProductDetail(params, options) {
+    const { product_id, ...queryParams } = params;
+    try {
+      const result = await this.store.products.loadProducts({
+        with_count: ["bundleGroup", "optionGroup"],
+        with_schedule: 1,
+        ...queryParams,
+        product_ids: [product_id],
+        cacheId: this.cacheId
+      }, options);
+      const list = Array.isArray(result) ? result : [];
+      return list.find(
+        (product) => Number(product.id) === Number(product_id)
+      );
+    } catch (error) {
+      console.error("Failed to query product detail:", error);
+      throw error;
+    }
+  }
   /**
    * 按预约时间加载单个商品详情。
    * 价格仍由 server products 的报价单桥接统一计算，避免 solution 实例重复请求报价单。
@@ -380,14 +514,28 @@ var BookingTicketImpl = class extends import_BaseSales.BaseSalesImpl {
    * 在 BookingTicket 命名空间也 emit 一次，方便上层统一从 Solution 订阅。
    */
   setOrderCustomer(customer) {
+    var _a;
     if (!customer) {
       this.clearOrderCustomer();
       return;
     }
+    const previousCustomerId = (_a = this.store.order.getOrderCustomer()) == null ? void 0 : _a.customer_id;
     const patch = (0, import_orderCustomer.formatOrderCustomerPatch)(customer);
+    const customerUnchanged = Number(previousCustomerId || 0) === Number(patch.customer_id || 0);
+    if (!customerUnchanged) {
+      this.discountConfigCacheKey = null;
+      this.hasManualDiscountSelection = false;
+    }
     this.store.order.setOrderCustomer(patch, customer);
+    if (customerUnchanged) {
+      return;
+    }
     const next = this.buildOrderCustomerPayload();
     this.core.effects.emit(`${this.name}:onOrderCustomerChange`, next);
+    this.refreshDiscountConfigAfterOrderCustomerChange(patch.customer_id);
+    void this.store.order.applyPromotion().catch((error) => {
+      console.error("[BookingTicket] applyPromotion after customer change failed", error);
+    });
   }
   /**
    * 读取 tempOrder 上的下单客户协议字段；customer_id 缺失时返回 null。
@@ -405,9 +553,36 @@ var BookingTicketImpl = class extends import_BaseSales.BaseSalesImpl {
    * 清空下单客户（协议字段 + snapshot）。
    */
   clearOrderCustomer() {
+    var _a, _b;
     this.store.order.clearOrderCustomer();
+    this.discountConfigCacheKey = null;
+    this.hasManualDiscountSelection = false;
+    const orderStore = this.store.order.store || {};
+    const discountModule = orderStore.discount;
+    void ((_a = discountModule == null ? void 0 : discountModule.setOriginalDiscountList) == null ? void 0 : _a.call(discountModule, []));
+    void ((_b = discountModule == null ? void 0 : discountModule.setDiscountList) == null ? void 0 : _b.call(discountModule, []));
+    this.store.order.applyDiscount();
+    void this.store.order.recalculateSummary({ createIfMissing: true }).then(() => this.store.order.persistTempOrder()).catch((error) => {
+      console.error("Failed to recalculate summary after clearing customer:", error);
+    });
     this.core.effects.emit(`${this.name}:onOrderCustomerChange`, null);
   }
+  /**
+   * 重置 tempOrder，并同步清空下单客户运行态。
+   *
+   * OrderModule.restoreOrder 会重建空单（customer_id 已为 null），但不会：
+   *  - emit BookingTicket `onOrderCustomerChange`
+   *  - 重置 CustomerModule.selectedCustomer（老路 getActiveCustomer）
+   *
+   * 因此在 super.restoreOrder 之后显式清客户，保证 SalesSdk / ticketBooking 订阅方与 tempOrder 一致。
+   */
+  async restoreOrder() {
+    var _a;
+    const tempOrder = await super.restoreOrder();
+    this.clearOrderCustomer();
+    (_a = this.store.customer) == null ? void 0 : _a.setSelectedCustomer(null);
+    return tempOrder;
+  }
   /** 内部：基于 OrderModule 当前状态构造一份 OrderCustomerChangePayload。 */
   buildOrderCustomerPayload() {
     const patch = this.store.order.getOrderCustomer();
@@ -418,6 +593,34 @@ var BookingTicketImpl = class extends import_BaseSales.BaseSalesImpl {
       snapshot: this.store.order.getOrderCustomerSnapshot()
     };
   }
+  refreshDiscountConfigAfterOrderCustomerChange(customerId) {
+    if (!customerId || customerId === 1)
+      return;
+    if (this.orderCustomerDiscountRefreshInFlight && this.orderCustomerDiscountRefreshCustomerId === customerId) {
+      return;
+    }
+    const previousRefresh = this.orderCustomerDiscountRefreshInFlight;
+    const refreshTask = (async () => {
+      if (previousRefresh) {
+        await previousRefresh.catch(() => void 0);
+      }
+      const currentCustomer = this.store.order.getOrderCustomer();
+      if (!currentCustomer || Number(currentCustomer.customer_id) !== customerId) {
+        return;
+      }
+      await this.loadDiscountConfig({ customerId });
+    })();
+    this.orderCustomerDiscountRefreshInFlight = refreshTask;
+    this.orderCustomerDiscountRefreshCustomerId = customerId;
+    refreshTask.catch((error) => {
+      console.error("Failed to load discount config after customer change:", error);
+    }).finally(() => {
+      if (this.orderCustomerDiscountRefreshInFlight !== refreshTask)
+        return;
+      this.orderCustomerDiscountRefreshInFlight = null;
+      this.orderCustomerDiscountRefreshCustomerId = null;
+    });
+  }
   /**
    * 获取客户分页信息
    * @returns 分页信息
@@ -613,6 +816,183 @@ var BookingTicketImpl = class extends import_BaseSales.BaseSalesImpl {
   async getOtherParams() {
     return this.otherParams;
   }
+  // ─── BookingContext API（透传给 BookingContextModule） ──────────────────────
+  // SalesSdkProvider 挂载时默认调 initBookingContext；也可由 UI 显式 set* 灌入已有数据。
+  /** 拉取 board config 并写入 BookingContext。 */
+  loadBookingConfig(params) {
+    return this.store.bookingContext.loadBookingConfig(params);
+  }
+  /** 拉取资源全集并写入 BookingContext。 */
+  loadBookingResources(params) {
+    return this.store.bookingContext.loadResources(params);
+  }
+  /** 初始化 BookingContext（date + config + resources）。 */
+  initBookingContext(params) {
+    return this.store.bookingContext.initBookingContext(params);
+  }
+  /** 当前 store 是否已具备与入参等价的 config / resources（无需再请求接口）。 */
+  isBookingContextReady(params) {
+    return this.store.bookingContext.isBookingContextReady(params);
+  }
+  /** 写入 booking config（来源：`/core/board/management/config`）。 */
+  setBookingConfig(config) {
+    this.store.bookingContext.setBookingConfig(config);
+  }
+  /** 读取当前 booking config。 */
+  getBookingConfig() {
+    return this.store.bookingContext.getBookingConfig();
+  }
+  /** 写入资源全集（来源：`/form/schedule`），同步派生 resourcesOriginMap。 */
+  setResources(resources) {
+    this.store.bookingContext.setResources(resources);
+  }
+  /** 读取资源全集（浅克隆）。 */
+  getResourcesOrigin() {
+    return this.store.bookingContext.getResourcesOrigin();
+  }
+  /** 读取资源全集 map（id → resource）。 */
+  getResourcesOriginMap() {
+    return this.store.bookingContext.getResourcesOriginMap();
+  }
+  /** 写入当前选择的日期；支持 dayjs / Date / string。 */
+  setBookingDate(date) {
+    this.store.bookingContext.setDate(date);
+  }
+  /** 读取当前选择的日期（统一 string）。 */
+  getBookingDate() {
+    return this.store.bookingContext.getDate();
+  }
+  /** 读取 BookingContext 完整 store（调试 / 测试 / 透传给 SDK 使用）。 */
+  getBookingContextState() {
+    return this.store.bookingContext.getState();
+  }
+  /** 清空 BookingContext（切租户 / destroy 场景）。 */
+  clearBookingContext() {
+    this.store.bookingContext.clear();
+  }
+  /**
+   * 构造 BookingContext 计算上下文（供 getProductExtend / getResourceByIds 等读 API 复用）。
+   */
+  buildBookingCalcContext(extra) {
+    const state = this.store.bookingContext.getState();
+    const date = (extra == null ? void 0 : extra.date) ?? state.date;
+    return {
+      bookingConfig: state.bookingConfig,
+      resourcesOrigin: state.resourcesOrigin,
+      resourcesOriginMap: state.resourcesOriginMap,
+      date,
+      presetStartTime: (extra == null ? void 0 : extra.presetStartTime) ?? (0, import_BookingContext.derivePresetStartTimeFromDate)(date),
+      ...extra || {}
+    };
+  }
+  /**
+   * 取商品当前可选资源列表（透传 OS BookingContext utils#getResourceByIds）。
+   * `extraResources` 用于把拖入未绑定的资源也展示出来。
+   */
+  getResourcesForProduct(product, options) {
+    var _a, _b;
+    const ctx = this.buildBookingCalcContext();
+    return (0, import_BookingContext.getResourceByIds)(ctx.resourcesOriginMap || {}, product, {
+      resourceTab: (_b = (_a = ctx.bookingConfig) == null ? void 0 : _a.config) == null ? void 0 : _b.resource_tab,
+      resourcesOrigin: ctx.resourcesOrigin,
+      extraResources: (options == null ? void 0 : options.extraResources) || []
+    });
+  }
+  /**
+   * 拼装 cacheItem 的 _extend / _data（资源 / 容量 / timeObj），与 info2 `getProductExtend` 等价。
+   */
+  getProductExtend(cacheItem, extra) {
+    return (0, import_BookingContext.getProductExtend)({
+      cacheItem,
+      ctx: this.buildBookingCalcContext(extra)
+    });
+  }
+  /**
+   * 取资源不可用原因列表（结构化 enum + params，i18n 文案由 UI 渲染）。
+   */
+  getResourceErrors(resource, cacheItem) {
+    return (0, import_BookingContext.getResourceErrors)(resource, cacheItem);
+  }
+  // ─── addProduct 决策 / 转换 API（SDK 加车下沉所需） ─────────────────────────
+  // 这一组方法是 SalesSdkCartContext.addProduct / confirmDetail 的 OS 后端。
+  // 调用方传入 ProductData，OS 自取 bookingContext / customer / date 等上下文，
+  // 输出 (a) autoClose 决策结果或 (b) `{ product, booking }` 协议入参。
+  /**
+   * 拼装 addProductDecision 通用上下文（从 store 自取）。
+   */
+  buildAddProductCtx(extra) {
+    var _a, _b;
+    const bookingContextState = this.store.bookingContext.getState();
+    const date = (extra == null ? void 0 : extra.date) ?? bookingContextState.date;
+    const orderCustomerId = ((_a = this.getOrderCustomerSnapshot()) == null ? void 0 : _a.id) ?? ((_b = this.store.order.getTempOrder()) == null ? void 0 : _b.customer_id) ?? void 0;
+    return {
+      bookingConfig: bookingContextState.bookingConfig,
+      resourcesOrigin: bookingContextState.resourcesOrigin,
+      resourcesOriginMap: bookingContextState.resourcesOriginMap,
+      date,
+      presetStartTime: (extra == null ? void 0 : extra.presetStartTime) ?? (0, import_BookingContext.derivePresetStartTimeFromDate)(date),
+      customerId: orderCustomerId,
+      ...extra || {}
+    };
+  }
+  /**
+   * 加车两阶段主决策（规格弹窗 / 资源编辑 / 直接加车）。
+   * 与 ticketBooking `handleSelectProduct` + `handleBooking4Service` 等价。
+   */
+  decideAddProduct(item, options) {
+    return (0, import_addProductDecision.decideAddProduct)(item, this.buildAddProductCtx(options));
+  }
+  /** 规格弹窗 callback 后的第二段决策。 */
+  decideAfterDetail(cacheItem, options) {
+    return (0, import_addProductDecision.decideAfterDetail)(cacheItem, this.buildAddProductCtx(options));
+  }
+  /**
+   * @deprecated 请用 `decideAddProduct`；`autoClose=true` 仅当 action=add。
+   */
+  decideAutoClose(item, options) {
+    return (0, import_addProductDecision.decideAutoClose)(item, this.buildAddProductCtx(options));
+  }
+  /** 替代 info2 `getIsEject`：商品是否需要弹窗（0/1）。 */
+  getIsEject(item, type = "select") {
+    return (0, import_addProductDecision.getIsEject)(item, type);
+  }
+  /** 仅 session 商品（无 variant/option/package）→ true。 */
+  getIsOnlySession(item) {
+    return (0, import_addProductDecision.getIsOnlySession)(item);
+  }
+  /**
+   * 拼装 requiresDetail payload（给 SDK 直接 return 给 UI 用）。
+   */
+  buildRequiresDetailPayload(item, options) {
+    return (0, import_addProductDecision.buildRequiresDetailPayload)(item, this.buildAddProductCtx(options));
+  }
+  /**
+   * 把 detail 弹窗回调结果（e, extension_type, detail）转换为 `(product, booking)` 入参。
+   * 内部会先拼 cacheItem，再走 cacheItemToBookingInput 严格协议对齐。
+   */
+  transformDetailToProductAndBooking(input) {
+    const { item, cacheItem: preparedCacheItem, detailResult, options } = input;
+    const ctx = this.buildAddProductCtx(options);
+    const cacheItem = preparedCacheItem || (detailResult ? (0, import_addProductDecision.buildCacheItemFromDetail)(item, detailResult, ctx) : (0, import_addProductDecision.buildCacheItemFromCartDetail)(item, ctx));
+    return (0, import_addProductDecision.transformDetailToProductAndBooking)(cacheItem, ctx);
+  }
+  /**
+   * 从已加车的 order line + booking 反查资源编辑抽屉所需的 cacheItem。
+   * 供 SalesSdk「编辑资源」等场景使用；字段语义与 buildCacheItemFromDetail 产出对齐。
+   */
+  buildCacheItemFromOrderLine(input) {
+    return (0, import_buildCacheItemFromOrderLine.buildCacheItemFromOrderLine)(input);
+  }
+  /**
+   * 从已加车的普通商品 order line 反查 SkuDetailModal edit 所需的 cacheItem。
+   */
+  buildNormalProductCacheItemFromOrderLine(input) {
+    return (0, import_buildNormalProductCacheItemFromOrderLine.buildNormalProductCacheItemFromOrderLine)(input);
+  }
+  /** 文档别名：与 OrderModule.updateOrderProduct 一致。 */
+  async updateProductInOrder(params) {
+    return this.updateOrderProduct(params);
+  }
   /**
    * 销毁模块：先调用父类（销毁所有 store 内子模块 + emit destroy + super.destroy()），
    * 再清理 BookingTicket 自有资源（scan 监听 + scan 内存缓存）。

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

@@ -1,4 +1,5 @@
 import { ProductList, OrderModule } from '../../modules';
+import { BookingContextModule } from '../../modules/BookingContext';
 import { CustomerModule } from '../../modules/Customer';
 import { SalesSummaryModule } from '../../modules/SalesSummary';
 import { ScheduleModule } from '../../modules/Schedule';
@@ -16,6 +17,7 @@ export interface BookingTicketState extends BaseSalesState {
     salesSummary: SalesSummaryModule;
     schedule: ScheduleModule;
     customer: CustomerModule;
+    bookingContext: BookingContextModule;
 }
 export declare function createBookingTicketModule<T extends keyof BookingTicketState>(moduleName: T, solutionName: string, name?: string, version?: string): BookingTicketState[T] | null;
 export declare enum BookingTicketHooks {

package/lib/solution/BookingTicket/types.js

@@ -24,6 +24,7 @@ __export(types_exports, {
 });
 module.exports = __toCommonJS(types_exports);
 var import_modules = require("../../modules");
+var import_BookingContext = require("../../modules/BookingContext");
 var import_Customer = require("../../modules/Customer");
 var import_SalesSummary = require("../../modules/SalesSummary");
 var import_Schedule = require("../../modules/Schedule");
@@ -54,6 +55,11 @@ function createBookingTicketModule(moduleName, solutionName, name, version) {
         `${solutionName}_${name || moduleName}`,
         version
       );
+    case "bookingContext":
+      return new import_BookingContext.BookingContextModule(
+        `${solutionName}_${name || moduleName}`,
+        version
+      );
     default:
       return null;
   }

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

@@ -0,0 +1,113 @@
+import { BookingCalcContext } from '../../../modules/BookingContext';
+import type { ProductData } from '../../../modules/Product/types';
+import type { OrderProduct, OrderProductIdentity, AddProductBookingInput } from '../../../modules/Order/types';
+/**
+ * cart.addProduct 两阶段决策（与 ticketBooking `handleSelectProduct` 对齐）：
+ *
+ * 1. `requiresDetail`：规格 / SKU / 套餐 / Session / 称重弹窗（门禁：`isOpenDetailModal` / `cartDetailValue` / `open_sold_weight`）
+ * 2. `requiresBookingEdit`：资源 / 时间编辑抽屉（门禁：`getIsAutoClose` on prepared cacheItem）
+ * 3. `add`：两关均通过，直接 transform + 加车
+ */
+export type AddProductDecision = {
+    action: 'add';
+    cacheItem: any;
+} | {
+    action: 'requiresDetail';
+    payload: AddProductRequiresDetailPayload;
+} | {
+    action: 'requiresBookingEdit';
+    cacheItem: any;
+    payload: AddProductRequiresBookingEditPayload;
+};
+/** 资源 / 时间编辑抽屉所需的最小 payload。 */
+export interface AddProductRequiresBookingEditPayload {
+    cacheItem: any;
+    customerId?: number | string;
+    date: string | null;
+}
+/**
+ * 加车主决策：对齐 `handleSelectProduct` 两段分支。
+ */
+export declare function decideAddProduct(item: any, ctx?: AddProductDecideContext): AddProductDecision;
+/**
+ * 规格弹窗 callback 后的第二段决策（对齐 `handleBooking4Service` 内 `cacheItem.autoClose` 分支）。
+ */
+export declare function decideAfterDetail(cacheItem: any, ctx?: AddProductDecideContext): AddProductDecision;
+/**
+ * @deprecated 请用 `decideAddProduct`；保留兼容：autoClose=true 仅表示可直接加车（action=add）。
+ */
+export interface AddProductRequiresDetailPayload {
+    item: ProductData | Record<string, any>;
+    /** UI 需展示的子弹窗开关。 */
+    showConfig: {
+        option: boolean;
+        session: boolean;
+        variant: boolean;
+        package: boolean;
+        number: boolean;
+    };
+    /** 仅 session 商品（且无 variant/option/package）→ true，UI 可只渲染 session 选择。 */
+    isOnlySession: boolean;
+    /** 0/1，与 info2 `getIsEject` 等价含义。 */
+    isEject: 0 | 1;
+    /** 当前选中客户 id（透传给 detail 弹窗用）。 */
+    customerId?: number | string;
+    /** 当前选择的日期。 */
+    date: string | null;
+    /** 透传完整商品数据，UI 渲染时直接用。 */
+    productData: ProductData | Record<string, any>;
+}
+export interface AddProductDecideContext extends BookingCalcContext {
+    type?: 'select' | 'detail';
+    quantity?: number;
+    customerId?: number | string;
+}
+/**
+ * 统一补齐预约商品的运行态字段。
+ *
+ * 新链路不再让决策和提交各自重建 cacheItem；这里作为唯一入口补齐
+ * `_extend.resource / capacity / startDate / endDate` 等后续 booking mapper 需要的字段。
+ */
+export declare function prepareBookingCacheItem(cacheItem: any, ctx?: AddProductDecideContext): any;
+export declare function decideAutoClose(item: any, ctx?: AddProductDecideContext): {
+    autoClose: boolean;
+    cacheItem?: any;
+};
+/**
+ * 替代 info2 `getIsEject`：商品是否需要弹窗（含 type='detail' / option_group / bundle_group / variant / session / sold_by_weight）。
+ */
+export declare function getIsEject(item: any, type?: 'select' | 'detail'): 0 | 1;
+/** 仅 session 商品（且没有 variant/option/package）。 */
+export declare function getIsOnlySession(item: any): boolean;
+/**
+ * 拼装 requiresDetail payload；showConfig 与 info2 弹窗内部判断一致。
+ */
+export declare function buildRequiresDetailPayload(item: any, ctx?: AddProductDecideContext): AddProductRequiresDetailPayload;
+/**
+ * 用 item.cartDetailValue 拼装一个 cacheItem 雏形（与 info2 `handleDirectAddService` 等价路径）。
+ * 这里只补 `_extend.start_date / quantity / other` 等运行态字段；后续走 getProductExtend 才会补齐资源 / 时间。
+ */
+export declare function buildCacheItemFromCartDetail(item: any, ctx?: AddProductDecideContext): any;
+/**
+ * 用 Info2 callback 的 (e, extension_type, detail) 拼装 cacheItem。
+ *
+ * 保留 detail._extend 中的 pricing / note（规格弹窗改价、备注等），
+ * 再叠加 session 时间、ctx.quantity 等运行态字段；other 以 callback `e` 为准。
+ */
+export declare function buildCacheItemFromDetail(item: any, detailResult: {
+    e: any;
+    extension_type?: any;
+    detail?: any;
+}, ctx?: AddProductDecideContext): any;
+/**
+ * `transformDetailToProductAndBooking`：把 cacheItem 拆成 OS `addProductToOrder` 所需的 `(product, booking)`。
+ *
+ * - `product` 走 `transformBaseProductToOrderProduct`（沿用 BaseSales 现有 mapper）。
+ * - `booking` 走 `cacheItemToBookingInput`（严格按 TEMP_ORDER_FIELDS_SUMMARY.md 协议）。
+ * - 普通商品（无 duration / 无 schedules）不产 booking，与 info2 一致。
+ */
+export declare function transformDetailToProductAndBooking(cacheItem: any, ctx?: AddProductDecideContext): {
+    product: Partial<OrderProduct> & OrderProductIdentity;
+    booking?: AddProductBookingInput;
+    cacheItem: any;
+};