@pisell/pisellos 2.2.181 → 2.2.183

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

@@ -1,10 +1,16 @@
 import { Module, ModuleOptions, PisellCore } from '../../types';
 import { BookingTicketCartView, BookingTicketProductCatalogView, BookingTicketState, IGetCustomerListParams, ICustomer, ILoadProductsParams, ILoadProductDetailParams, IScanResult } from './types';
 import type { ProductData } from '../../modules';
+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 { AddProductDecideContext, AddProductRequiresDetailPayload } from './utils/addProductDecision';
+import { type BuildCacheItemFromOrderLineInput } from '../../modules/BookingContext/utils/buildCacheItemFromOrderLine';
+import { type BuildNormalProductCacheItemFromOrderLineInput } from '../../modules/BookingContext/utils/buildNormalProductCacheItemFromOrderLine';
+import type { AddProductBookingInput, OrderProduct, OrderProductIdentity, UpdateOrderProductParams } from '../../modules/Order/types';
 export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
     protected defaultName: string;
     protected defaultVersion: string;
@@ -16,10 +22,14 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
     private platform;
     private scan;
     private productCatalog;
+    private orderCustomerDiscountRefreshInFlight;
+    private orderCustomerDiscountRefreshCustomerId;
     /**
-     * 在 BaseSales 默认模块清单（products/order/salesSummary/schedule）基础上追加 customer。
+     * 在 BaseSales 默认模块清单（products/order/salesSummary/schedule）基础上追加 customer + bookingContext。
+     * bookingContext 是 SalesSdk 加车下沉所需的「预约 UI 上下文」（bookingConfig / resourcesOrigin / date）。
      */
     protected getRegisteredModuleNames(): readonly string[];
+    protected getSubmitOrderSalesChannel(): string;
     /**
      * 业务侧子模块工厂：BookingTicket 自带的 createBookingTicketModule 优先匹配；
      * 未识别的模块名（如 BookingByStep 公共类型）回退到父类工厂。
@@ -34,6 +44,14 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
      * 让现有 setActiveCustomer / getActiveCustomer 调用方零成本拿到详情态客户。
      */
     loadSalesDetail(orderIdOrParams: number | string | LoadSalesDetailParams): Promise<ISalesDetail>;
+    scanPromotionCode(code: string, customerId?: number): Promise<BaseSalesScanCodeResult>;
+    private hydrateOrderCustomerFromScanDiscounts;
+    private getDiscountCustomerId;
+    private resolveCustomerByDiscountCustomerId;
+    private findCustomerById;
+    private normalizeCustomer;
+    private getRawCustomerId;
+    private hasUsableCustomerDetails;
     /**
      * 更新当前预约的 appointment_status。
      *
@@ -69,6 +87,24 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
         callback?: (result: any) => void;
         subscriberId?: string;
     }): Promise<any>;
+    /**
+     * 只读查询单商品详情：走 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',
+     * });
+     */
+    queryProductDetail(params: ILoadProductDetailParams, options?: {
+        callback?: (result: any) => void;
+        subscriberId?: string;
+    }): Promise<ProductData | undefined>;
     /**
      * 按预约时间加载单个商品详情。
      * 价格仍由 server products 的报价单桥接统一计算，避免 solution 实例重复请求报价单。
@@ -186,8 +222,19 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
      * 清空下单客户（协议字段 + snapshot）。
      */
     clearOrderCustomer(): void;
+    /**
+     * 重置 tempOrder，并同步清空下单客户运行态。
+     *
+     * OrderModule.restoreOrder 会重建空单（customer_id 已为 null），但不会：
+     *  - emit BookingTicket `onOrderCustomerChange`
+     *  - 重置 CustomerModule.selectedCustomer（老路 getActiveCustomer）
+     *
+     * 因此在 super.restoreOrder 之后显式清客户，保证 SalesSdk / ticketBooking 订阅方与 tempOrder 一致。
+     */
+    restoreOrder(): Promise<import("../../modules/Order/types").OrderTempOrder>;
     /** 内部：基于 OrderModule 当前状态构造一份 OrderCustomerChangePayload。 */
     private buildOrderCustomerPayload;
+    private refreshDiscountConfigAfterOrderCustomerChange;
     /**
      * 获取客户分页信息
      * @returns 分页信息
@@ -291,6 +338,109 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
      * @returns 其他参数
      */
     getOtherParams(): Promise<Record<string, any>>;
+    /** 拉取 board config 并写入 BookingContext。 */
+    loadBookingConfig(params?: LoadBookingConfigParams): Promise<BookingContextConfig | null>;
+    /** 拉取资源全集并写入 BookingContext。 */
+    loadBookingResources(params?: LoadBookingResourcesParams): Promise<BookingContextResource[]>;
+    /** 初始化 BookingContext（date + config + resources）。 */
+    initBookingContext(params?: InitBookingContextParams): Promise<BookingContextState>;
+    /** 当前 store 是否已具备与入参等价的 config / resources（无需再请求接口）。 */
+    isBookingContextReady(params?: InitBookingContextParams): boolean;
+    /** 写入 booking config（来源：`/core/board/management/config`）。 */
+    setBookingConfig(config: BookingContextConfig | null): void;
+    /** 读取当前 booking config。 */
+    getBookingConfig(): BookingContextConfig | null;
+    /** 写入资源全集（来源：`/form/schedule`），同步派生 resourcesOriginMap。 */
+    setResources(resources: BookingContextResource[] | null | undefined): void;
+    /** 读取资源全集（浅克隆）。 */
+    getResourcesOrigin(): BookingContextResource[];
+    /** 读取资源全集 map（id → resource）。 */
+    getResourcesOriginMap(): BookingContextResourceMap;
+    /** 写入当前选择的日期；支持 dayjs / Date / string。 */
+    setBookingDate(date: BookingContextDateInput): void;
+    /** 读取当前选择的日期（统一 string）。 */
+    getBookingDate(): string | null;
+    /** 读取 BookingContext 完整 store（调试 / 测试 / 透传给 SDK 使用）。 */
+    getBookingContextState(): BookingContextState;
+    /** 清空 BookingContext（切租户 / destroy 场景）。 */
+    clearBookingContext(): void;
+    /**
+     * 构造 BookingContext 计算上下文（供 getProductExtend / getResourceByIds 等读 API 复用）。
+     */
+    private buildBookingCalcContext;
+    /**
+     * 取商品当前可选资源列表（透传 OS BookingContext utils#getResourceByIds）。
+     * `extraResources` 用于把拖入未绑定的资源也展示出来。
+     */
+    getResourcesForProduct(product: any, options?: {
+        extraResources?: Array<{
+            form_id: number | string;
+            id: number;
+        }>;
+    }): any[];
+    /**
+     * 拼装 cacheItem 的 _extend / _data（资源 / 容量 / timeObj），与 info2 `getProductExtend` 等价。
+     */
+    getProductExtend(cacheItem: any, extra?: Partial<BookingCalcContext>): any;
+    /**
+     * 取资源不可用原因列表（结构化 enum + params，i18n 文案由 UI 渲染）。
+     */
+    getResourceErrors(resource: any, cacheItem: any): ResourceError[];
+    /**
+     * 拼装 addProductDecision 通用上下文（从 store 自取）。
+     */
+    private buildAddProductCtx;
+    /**
+     * 加车两阶段主决策（规格弹窗 / 资源编辑 / 直接加车）。
+     * 与 ticketBooking `handleSelectProduct` + `handleBooking4Service` 等价。
+     */
+    decideAddProduct(item: any, options?: Partial<AddProductDecideContext>): import("./utils/addProductDecision").AddProductDecision;
+    /** 规格弹窗 callback 后的第二段决策。 */
+    decideAfterDetail(cacheItem: any, options?: Partial<AddProductDecideContext>): import("./utils/addProductDecision").AddProductDecision;
+    /**
+     * @deprecated 请用 `decideAddProduct`；`autoClose=true` 仅当 action=add。
+     */
+    decideAutoClose(item: any, options?: Partial<AddProductDecideContext>): {
+        autoClose: boolean;
+        cacheItem?: any;
+    };
+    /** 替代 info2 `getIsEject`：商品是否需要弹窗（0/1）。 */
+    getIsEject(item: any, type?: 'select' | 'detail'): 0 | 1;
+    /** 仅 session 商品（无 variant/option/package）→ true。 */
+    getIsOnlySession(item: any): boolean;
+    /**
+     * 拼装 requiresDetail payload（给 SDK 直接 return 给 UI 用）。
+     */
+    buildRequiresDetailPayload(item: any, options?: Partial<AddProductDecideContext>): AddProductRequiresDetailPayload;
+    /**
+     * 把 detail 弹窗回调结果（e, extension_type, detail）转换为 `(product, booking)` 入参。
+     * 内部会先拼 cacheItem，再走 cacheItemToBookingInput 严格协议对齐。
+     */
+    transformDetailToProductAndBooking(input: {
+        item: any;
+        cacheItem?: any;
+        detailResult?: {
+            e: any;
+            extension_type?: any;
+            detail?: any;
+        };
+        options?: Partial<AddProductDecideContext>;
+    }): {
+        product: Partial<OrderProduct> & OrderProductIdentity;
+        booking?: AddProductBookingInput;
+        cacheItem: any;
+    };
+    /**
+     * 从已加车的 order line + booking 反查资源编辑抽屉所需的 cacheItem。
+     * 供 SalesSdk「编辑资源」等场景使用；字段语义与 buildCacheItemFromDetail 产出对齐。
+     */
+    buildCacheItemFromOrderLine(input: BuildCacheItemFromOrderLineInput): Record<string, any>;
+    /**
+     * 从已加车的普通商品 order line 反查 SkuDetailModal edit 所需的 cacheItem。
+     */
+    buildNormalProductCacheItemFromOrderLine(input: BuildNormalProductCacheItemFromOrderLineInput): Record<string, any>;
+    /** 文档别名：与 OrderModule.updateOrderProduct 一致。 */
+    updateProductInOrder(params: UpdateOrderProductParams): Promise<OrderProduct[]>;
     /**
      * 销毁模块：先调用父类（销毁所有 store 内子模块 + emit destroy + super.destroy()），
      * 再清理 BookingTicket 自有资源（scan 监听 + scan 内存缓存）。