@pisell/pisellos 2.2.242 → 2.2.244

package/dist/modules/Order/types.d.ts

@@ -2,129 +2,15 @@ import { CartItem } from '../Cart/types';
 import type { DiscountModule } from '../Discount';
 import type { RulesModule } from '../Rules';
 import type { Discount } from '../Discount/types';
-import type { UnavailableReason } from '../Rules/types';
 import type { SubmitPayloadEnhancer } from './utils';
 import type { PaymentItem } from '../Payment/types';
 import type { ICustomer } from '../AccountList/types';
-import type { OrderProductDiscountItem } from '../../server/modules/order/types';
-export type { OrderProductDiscountItem } from '../../server/modules/order/types';
 export declare enum OrderHooks {
     OnOrderCreate = "order:onOrderCreate",
     OnOrderUpdate = "order:onOrderUpdate",
     OnOrderCancel = "order:onOrderCancel",
     OnOrderStatusChange = "order:onOrderStatusChange",
-    OnOrderCustomerChange = "order:onOrderCustomerChange",
-    OnPromotionApplied = "order:onPromotionApplied"
-}
-/**
- * 促销评估器协议（OS 与 PromotionEvaluator 之间的桥接接口）。
- *
- * 与 `pisell_os/src/model/strategy/adapter/promotion/evaluator.ts` 中的
- * `PromotionEvaluator` 实例结构保持兼容。SalesSdkProvider 会从 `appHelper.utils.promotionEvaluator`
- * 读取实例并通过 `setPromotionEvaluator` 注入到 OrderModule。
- *
- * 这里只声明 OrderModule 需要调用的子集，避免反向依赖具体 evaluator 实现。
- */
-export interface OrderPromotionEvaluator {
-    evaluateCartWithPricing(input: {
-        products: any[];
-        channel?: string;
-    }): any;
-    getProductsApplicableStrategies(input: {
-        products: any[];
-        channel?: string;
-    }, matchVariant?: boolean): any[];
-}
-/** 赠品解析回调 context（OS → SDK 的请求体） */
-export interface OrderGiftSelectContext {
-    strategyId: string;
-    strategyName: string | Record<string, string>;
-    giftCount: number;
-    giftOptions: Array<{
-        product_id: number;
-        product_variant_id: number;
-    }>;
-    /** 触发此赠品的主商品 metadata.unique_identification_number 列表 */
-    sourceProductIds: string[];
-}
-/**
- * 赠品 resolver 返回值。
- *
- * @example
- * return { products: [giftProduct], bookings: [giftBooking] };
- */
-export interface OrderGiftSelectResult {
-    /** 完整赠品购物车行，必须带 metadata._giftInfo。 */
-    products: Partial<OrderProduct>[];
-    /** 预约赠品对应的 booking，按 products 下标一一关联。 */
-    bookings?: AddProductBookingInput[];
-}
-/**
- * 赠品解析回调签名（SDK → OS 的返回值）。
- *
- * - 单选项：SDK 内部自动构造商品，不弹窗
- * - 多选项：SDK 弹窗等用户确认后构造
- * - 用户取消：抛错或返回空数组（OS 视为放弃本次添加）
- *
- * 返回数组时沿用旧协议，只写 tempOrder.products；返回对象时可同时写入预约 bookings。
- */
-export type OrderGiftSelectResolver = (ctx: OrderGiftSelectContext) => Promise<Partial<OrderProduct>[] | OrderGiftSelectResult | null>;
-/** 未满足的促销策略（购物车底部 alert 渲染源） */
-export interface OrderUnfulfilledPromotion {
-    strategyId: string;
-    strategyName: string | Record<string, string>;
-    actionType: string;
-    needQuantity: number;
-    currentQuantity: number;
-    requiredQuantity: number;
-    eligibleProducts: Array<{
-        product_id: number;
-        product_variant_id: number;
-    }>;
-    strategyMetadata?: any;
-    display?: {
-        text: string | Record<string, string>;
-        type: string;
-    };
-}
-/** 上一次 applyPromotion 计算出的赠品操作（仅供调试/读取使用） */
-export interface OrderLastGiftActions {
-    toAdd: Array<{
-        strategyId: string;
-        strategyName: string | Record<string, string>;
-        giftCount: number;
-        giftOptions: Array<{
-            product_id: number;
-            product_variant_id: number;
-        }>;
-        sourceProductIds: string[];
-    }>;
-    toReduce: Array<{
-        strategyId: string;
-        items: Array<{
-            uid: string;
-            currentQuantity: number;
-            newQuantity: number;
-        }>;
-    }>;
-    toRemove: string[];
-}
-/** onPromotionApplied 事件 payload */
-export interface OrderPromotionAppliedPayload {
-    unfulfilledPromotions: OrderUnfulfilledPromotion[];
-    giftActions: OrderLastGiftActions;
-    /** evaluator 返回的赠品摘要 */
-    gifts: Array<{
-        strategyId: string;
-        strategyName: string | Record<string, string>;
-        giftCount: number;
-        giftOptions: Array<{
-            product_id: number;
-            product_variant_id: number;
-        }>;
-    }>;
-    /** 处理后的商品列表 */
-    products: OrderProduct[];
+    OnOrderCustomerChange = "order:onOrderCustomerChange"
 }
 /**
  * tempOrder 上的下单客户协议字段视图。
@@ -162,35 +48,25 @@ export interface OrderCustomerChangePayload {
     patch: OrderCustomerView;
     snapshot: ICustomer | null;
 }
-export interface OrderScanCodeResult {
-    isAvailable: boolean;
-    discountList: Discount[];
-    scannedDiscountList: Discount[];
-    type: 'server' | 'clientCalc';
-    unavailableReason?: UnavailableReason;
-}
 export interface OrderProductIdentity {
     product_id: number | null;
     product_variant_id: number;
     unique_identification_number?: string;
-    product_sku?: OrderProductSku;
+    product_option_item?: any[];
     product_bundle?: any[];
 }
-export interface OrderProductSku {
-    option: any[];
-    [key: string]: any;
-}
 export interface OrderProduct extends OrderProductIdentity {
     order_detail_id: number | null;
     num: number;
     bundle_edit?: number;
-    product_sku: OrderProductSku;
+    product_option_item: any[];
+    product_sku?: Record<string, any>;
     gift_card?: number;
     selling_price: string;
     original_price: string;
     tax_fee: string;
     is_charge_tax: number;
-    discount_list: OrderProductDiscountItem[];
+    discount_list: any[];
     product_bundle: any[];
     booking_uid?: string;
     metadata: Record<string, any>;
@@ -206,7 +82,6 @@ export interface OrderSummary {
     shipping_tax_fee: string;
     tax_fee: string;
     surcharge_fee: string;
-    surcharges: any[];
     discount_amount: string;
     deposit_amount: string;
     deposit?: {
@@ -228,11 +103,11 @@ export interface OrderSummary {
 export interface OrderTempOrder {
     order_id: number | null;
     external_sale_number: string;
-    order_number: string | null;
-    shop_order_number: string | null;
-    shop_full_order_number: string | null;
+    order_number: string;
+    shop_order_number: string;
+    shop_full_order_number: string;
     type: string;
-    business_code?: string;
+    business_code: string;
     platform: string;
     sales_channel: string;
     order_sales_channel: string;
@@ -261,39 +136,36 @@ export interface OrderTempOrder {
     delivery_type?: string;
     table_number?: Record<string, any>;
     schedule_date: string;
-    created_at: string | undefined;
+    created_at: string;
     request_unique_idempotency_token?: string;
     products: OrderProduct[];
     bookings: any[];
     payments: any[];
     surcharges: any[];
-    discount_list?: any[];
+    discount_list: any[];
     relation_forms: any[];
     contacts: any[];
     contacts_info: Record<string, any> | null;
     holder: Record<string, any> | null;
     metadata: Record<string, any>;
-    summary?: OrderSummary;
     _extend?: {
         productsByUid?: Record<string, Record<string, any>>;
         [key: string]: any;
     };
 }
-export interface OrderSubmitProduct extends Omit<OrderProduct, 'unique_identification_number' | 'num'> {
+export interface OrderSubmitProduct extends Omit<OrderProduct, 'unique_identification_number' | 'num' | 'product_option_item'> {
     product_quantity: number;
     payment_price: string;
-    product_sku: OrderProductSku;
+    product_sku: Record<string, any>;
 }
-export interface OrderSubmitPayload extends Omit<OrderTempOrder, 'platform' | 'products' | '_extend' | 'customer' | 'discount_list' | 'created_at'> {
+export interface OrderSubmitPayload extends Omit<OrderTempOrder, 'platform' | 'products' | '_extend' | 'customer' | 'shop_full_order_number'> {
     platform: string;
-    created_at?: string | undefined;
     request_unique_idempotency_token?: string;
     form_record_ids?: Array<{
         form_id: number | string;
         form_record_id: number | string;
     }>;
     products: OrderSubmitProduct[];
-    summary?: OrderSummary;
     small_ticket_data_flag?: number;
 }
 export interface OrderState {
@@ -305,45 +177,16 @@ export interface OrderState {
     discount: DiscountModule | null;
     rules: RulesModule | null;
 }
-export interface ReplaceTempOrderOptions {
-    recalculateSummary?: boolean;
-    persist?: boolean;
-    saveDraft?: boolean;
-}
-export type AddProductBookingInput = Record<string, any>;
 /** 更新购物车行：仅传 SKU 时命中同 SKU 第一行；多行同 SKU 须传 unique_identification_number / 选项指纹等 */
-export interface UpdateOrderProductParams {
+export interface UpdateProductInOrderParams {
     product_id: number | null;
     product_variant_id: number;
     updates: Partial<OrderProduct>;
     unique_identification_number?: string;
-    identity_key?: string;
-    product_sku?: OrderProductSku;
+    product_option_item?: any[];
     product_bundle?: any[];
-    booking?: AddProductBookingInput;
-    /**
-     * 预约时间 / 时长变更后允许使用本次报价覆盖已落库订单行历史价。
-     *
-     * @example
-     * await order.updateOrderProduct({
-     *   product_id: 1,
-     *   product_variant_id: 0,
-     *   updates: { selling_price: '6.00', metadata: { source_product_price: '6.00' } },
-     *   booking: { duration: 2 },
-     *   allow_booking_reprice: true,
-     * });
-     */
-    allow_booking_reprice?: boolean;
-}
-/** 仅更新购物车行数量；行定位语义与 updateOrderProduct / removeProductFromOrder 保持一致 */
-export interface UpdateOrderProductQuantityParams extends OrderProductIdentity {
-    num: number;
-    identity_key?: string;
-}
-export interface UpdateOrderBookingParams {
-    unique_identification_number: string;
-    updates: AddProductBookingInput;
 }
+export type AddProductBookingInput = Record<string, any>;
 export interface OrderProductMergeDecisionContext {
     incomingProduct: Partial<OrderProduct> & OrderProductIdentity;
     normalizedIncoming: OrderProduct;
@@ -394,11 +237,10 @@ export interface SubmitSalesOrderParams {
     query: {
         order_id: number | null;
         external_sale_number: string;
-        order_number: string | null;
-        shop_order_number: string | null;
-        shop_full_order_number: string | null;
+        order_number: string;
+        shop_order_number: string;
         type: string;
-        business_code?: string;
+        business_code: string;
         platform: string;
         request_unique_idempotency_token?: string;
         sales_channel: string;
@@ -425,19 +267,18 @@ export interface SubmitSalesOrderParams {
         delivery_type?: string;
         table_number?: Record<string, any>;
         schedule_date: string;
-        created_at?: string | undefined;
+        created_at: string;
         products: OrderSubmitProduct[];
         bookings: OrderSubmitBooking[];
         payments: any[];
-        vouchers: any[];
         surcharges?: any[];
+        discount_list: any[];
         relation_forms: any[];
         form_record_ids?: OrderSubmitFormRecord[];
         contacts: any[];
         contacts_info: Record<string, any> | null;
         holder: Record<string, any> | null;
         metadata: Record<string, any>;
-        summary?: OrderSummary;
         small_ticket_data_flag?: number;
     };
 }
@@ -459,10 +300,6 @@ export interface PaymentItemData {
     name: string;
     /** 支付类型 */
     type: string;
-    /** 支付时间 (格式: YYYY-MM-DD HH:mm:ss) */
-    payment_time?: string;
-    /** 支付项创建时间 (格式: YYYY-MM-DD HH:mm:ss) */
-    created_at?: string;
     /** @deprecated BaseSales/Sales 协议不提交该字段；旧 Checkout/Payment 内部仍可能使用 */
     isSynced?: boolean;
 }
@@ -475,7 +312,6 @@ export interface OrderPaymentMetadata {
     [key: string]: any;
 }
 export interface OrderPaymentData {
-    order_payment_id?: number | string;
     amount: string;
     code: string;
     custom_payment_id: number;
@@ -485,11 +321,9 @@ export interface OrderPaymentData {
     origin_amount?: string;
     service_fee?: string;
     status?: 'active' | 'voided' | string;
-    /** 支付时间 (格式: YYYY-MM-DD HH:mm:ss) */
     payment_time?: string;
     wallet_pass_usage_unit?: unknown;
     wallet_pass_use_value?: string | number | null;
-    fund_record?: Record<string, any>;
     metadata: OrderPaymentMetadata;
     rounding_amount?: string;
     service_charge?: {
@@ -497,7 +331,6 @@ export interface OrderPaymentData {
         amount?: string;
     };
     order_payment_type?: 'normal' | 'deposit';
-    /** 支付项创建时间 (格式: YYYY-MM-DD HH:mm:ss) */
     created_at?: string;
     updated_at?: string;
 }
@@ -512,19 +345,12 @@ export interface LoadSalesDetailParams {
     externalSaleNumber?: string;
     external_sale_number?: string;
     forceRemote?: boolean;
-    merge?: boolean;
-}
-export interface SalesOrderLookupParams {
-    lookup: number | string;
-    forceRemote?: boolean;
 }
 export interface SyncPaymentsToOrderParams {
     payments: OrderPaymentSource[];
     paymentStatus?: SubmitSalesOrderParams['query']['payment_status'];
     submitWhenPaid?: boolean;
     smallTicketDataFlag?: number;
-    businessCode?: string;
-    channel?: string;
 }
 export interface SyncPaymentsToOrderResult<T = any> {
     isFullyPaid: boolean;
@@ -621,7 +447,6 @@ export interface OrderModuleAPI {
     }) => void;
     getTempOrder: () => OrderTempOrder | null;
     ensureTempOrder: () => OrderTempOrder;
-    replaceTempOrder: (tempOrder: OrderTempOrder, options?: ReplaceTempOrderOptions) => Promise<OrderTempOrder>;
     addNewOrder: () => Promise<OrderTempOrder>;
     restoreOrder: () => OrderTempOrder;
     getOrderProducts: () => OrderProduct[];
@@ -633,40 +458,16 @@ export interface OrderModuleAPI {
     getOrderSnapshot: () => OrderSnapshot | null;
     getOrderSyncState: () => OrderSyncState;
     getOrderAmountSnapshot: () => OrderAmountSnapshot | null;
-    buildCurrentSubmitPayloadForLocalPrint: (params?: {
-        cacheId?: string;
-        platform?: string;
-        businessCode?: string;
-        channel?: string;
-        type?: string;
-    }) => OrderSubmitPayload;
-    applyLocalPrintOrderNumbers: (order?: Record<string, any> | null) => Promise<OrderTempOrder>;
     getTempOrderNote: () => string;
-    updateTempOrderNote: {
-        (note: string): string;
-        (note: string, sync: true): Promise<string>;
-        (note: string, sync: boolean): string | Promise<string>;
-    };
+    updateTempOrderNote: (note: string) => string;
     updateTempOrderShopDiscount: (amount: string | number) => string;
     updateTempOrderCustomer: (customer: UpdateTempOrderCustomerInput) => OrderSnapshot['customer'];
     updateTempOrderBuzzer: (buzzer: string) => string;
     updateTempOrderContactsInfo: (contactsInfo: Record<string, any> | null) => Record<string, any> | null;
     addProductToOrder: (product: Partial<OrderProduct> & OrderProductIdentity, booking?: AddProductBookingInput) => Promise<OrderProduct[]>;
-    updateOrderProduct: (params: UpdateOrderProductParams) => Promise<OrderProduct[]>;
-    updateOrderProductQuantity: (params: UpdateOrderProductQuantityParams) => Promise<OrderProduct[]>;
-    updateOrderBooking: (params: UpdateOrderBookingParams) => any[];
+    updateProductInOrder: (params: UpdateProductInOrderParams) => Promise<OrderProduct[]>;
     removeProductFromOrder: (identity: OrderProductIdentity) => Promise<OrderProduct[]>;
-    /** 批量删除购物车行，末尾仅触发一次促销重算与 summary 刷新 */
-    removeProductsFromOrder: (identities: OrderProductIdentity[]) => Promise<OrderProduct[]>;
-    /** @deprecated no-op；OrderModule 不再负责 tempOrder localStorage 持久化。 */
     persistTempOrder: () => void;
-    /**
-     * 控制 IndexedDB 草稿（saveDraft）开关；localStorage tempOrder 持久化已废弃。
-     * BigSale 弹窗等场景传 false 可跳过 saveDraft。
-     */
-    setEnableTempOrderPersist: (enabled: boolean) => void;
-    /** 是否允许 saveDraft 写入 IndexedDB 草稿。 */
-    isTempOrderPersistEnabled: () => boolean;
     submitTempOrder: <T = any>(params?: {
         cacheId?: string;
         platform?: string;
@@ -678,17 +479,6 @@ export interface OrderModuleAPI {
         smallTicketDataFlag?: number;
         enhancePayload?: SubmitPayloadEnhancer;
     }) => Promise<T>;
-    submitTempOrderAsync: <T = any>(params?: {
-        cacheId?: string;
-        platform?: string;
-        businessCode?: string;
-        channel?: string;
-        type?: string;
-        payments?: OrderPaymentSource[];
-        paymentStatus?: SubmitSalesOrderParams['query']['payment_status'];
-        smallTicketDataFlag?: number;
-        enhancePayload?: SubmitPayloadEnhancer;
-    }) => Promise<T>;
     getOrderPayments: () => OrderPaymentData[];
     setOrderPayments: (payments: OrderPaymentSource[]) => OrderPaymentData[];
     addOrderPayment: (payment: OrderPaymentSource) => OrderPaymentData[];
@@ -697,11 +487,15 @@ export interface OrderModuleAPI {
     updateVoucherOrderPayments: (payments: OrderPaymentSource[]) => OrderPaymentData[];
     sendCustomerPayLink: <T = any>(params: SendCustomerPayLinkParams) => Promise<T>;
     saveDraft: () => Promise<void>;
+    hasLocalDatabase: () => boolean;
+    getLocalOrderByOrderId: (orderId: number | string) => Promise<Record<string, any> | null>;
+    getLocalOrderByExternalSaleNumber: (externalSaleNumber: string) => Promise<Record<string, any> | null>;
+    getLocalOrderByOrderNumber: (orderNumber: string) => Promise<Record<string, any> | null>;
     hydrateTempOrderFromRecord: (record: Record<string, any>, options?: {
         recalcOnHydrate?: boolean;
     }) => Promise<OrderTempOrder>;
     syncPaymentsToOrder: <T = any>(params: SyncPaymentsToOrderParams) => Promise<SyncPaymentsToOrderResult<T>>;
-    getSalesOrderByLookup: (params: SalesOrderLookupParams) => Promise<any>;
+    getOrderInfoByRemote: (order_id: number) => Promise<any>;
     getLastOrderInfo: () => Record<string, any> | undefined;
     getOrderInfo: (order_id: number) => Promise<any>;
     /**
@@ -723,52 +517,10 @@ export interface OrderModuleAPI {
     clearOrderCustomer: () => void;
     loadDiscountConfig: (params: {
         customerId: number;
-        action?: 'create' | 'edit';
-        orderId?: number;
-        apply?: boolean;
-    }) => Promise<Discount[]>;
+        action?: 'create';
+    }) => Promise<void>;
     getDiscountList: () => Discount[];
     applyDiscount: () => void;
-    /**
-     * 注入促销评估器。
-     *
-     * SalesSdkProvider 在初始化 bookingTicket 后会自动从 `appHelper.utils.promotionEvaluator`
-     * 读取实例并调用本方法注入。host 透明，业务 UI 不感知。
-     *
-     * @example
-     * order.setPromotionEvaluator(appHelper.utils.promotionEvaluator);
-     */
-    setPromotionEvaluator: (evaluator: OrderPromotionEvaluator | null) => void;
-    /**
-     * 注入赠品选择 resolver。OS 在 applyPromotion 内部当需要新增赠品时会 await 调用 resolver。
-     *
-     * 缺省时 OS 会 `console.warn` 并跳过新增（既有赠品的 reduce/remove 仍会执行）。
-     *
-     * @example
-     * order.setGiftSelectResolver((ctx) => giftSelectBridge.request(ctx));
-     */
-    setGiftSelectResolver: (resolver: OrderGiftSelectResolver | null) => void;
-    /**
-     * 为商品目录追加促销标签。
-     *
-     * @example
-     * const taggedProducts = order.appendPromotionTags(products);
-     */
-    appendPromotionTags: <T extends Record<string, any>>(products: T[]) => T[];
-    /**
-     * 应用购物车促销（评估 → 差异化赠品 → 写回 tempOrder.products → emit onPromotionApplied）。
-     *
-     * 自动在 addProductToOrder / updateOrderProductQuantity / removeProductFromOrder /
-     * clearOrderCartLines / setOrderCustomer 等写路径末尾触发，业务一般无需手动调用。
-     *
-     * 多选项赠品依赖 giftSelectResolver；如未注入则跳过且 console.warn。
-     * 内部以 `_isApplyingPromotion` flag 防递归。
-     */
-    applyPromotion: () => Promise<void>;
-    /** 读取上次 applyPromotion 产出的未满足促销提示 */
-    getUnfulfilledPromotions: () => OrderUnfulfilledPromotion[];
-    /** 读取上次 applyPromotion 产出的赠品操作 diff（toAdd / toReduce / toRemove） */
-    getLastGiftActions: () => OrderLastGiftActions | null;
     /**
    * 取消订单
    * @param params 取消订单参数

package/dist/modules/Order/types.js

@@ -4,45 +4,9 @@ export var OrderHooks = /*#__PURE__*/function (OrderHooks) {
   OrderHooks["OnOrderCancel"] = "order:onOrderCancel";
   OrderHooks["OnOrderStatusChange"] = "order:onOrderStatusChange";
   OrderHooks["OnOrderCustomerChange"] = "order:onOrderCustomerChange";
-  OrderHooks["OnPromotionApplied"] = "order:onPromotionApplied";
   return OrderHooks;
 }({});
 
-/**
- * 促销评估器协议（OS 与 PromotionEvaluator 之间的桥接接口）。
- *
- * 与 `pisell_os/src/model/strategy/adapter/promotion/evaluator.ts` 中的
- * `PromotionEvaluator` 实例结构保持兼容。SalesSdkProvider 会从 `appHelper.utils.promotionEvaluator`
- * 读取实例并通过 `setPromotionEvaluator` 注入到 OrderModule。
- *
- * 这里只声明 OrderModule 需要调用的子集，避免反向依赖具体 evaluator 实现。
- */
-
-/** 赠品解析回调 context（OS → SDK 的请求体） */
-
-/**
- * 赠品 resolver 返回值。
- *
- * @example
- * return { products: [giftProduct], bookings: [giftBooking] };
- */
-
-/**
- * 赠品解析回调签名（SDK → OS 的返回值）。
- *
- * - 单选项：SDK 内部自动构造商品，不弹窗
- * - 多选项：SDK 弹窗等用户确认后构造
- * - 用户取消：抛错或返回空数组（OS 视为放弃本次添加）
- *
- * 返回数组时沿用旧协议，只写 tempOrder.products；返回对象时可同时写入预约 bookings。
- */
-
-/** 未满足的促销策略（购物车底部 alert 渲染源） */
-
-/** 上一次 applyPromotion 计算出的赠品操作（仅供调试/读取使用） */
-
-/** onPromotionApplied 事件 payload */
-
 /**
  * tempOrder 上的下单客户协议字段视图。
  * 这些字段会随订单提交到后端。
@@ -65,8 +29,6 @@ export var OrderHooks = /*#__PURE__*/function (OrderHooks) {
 
 /** 更新购物车行：仅传 SKU 时命中同 SKU 第一行；多行同 SKU 须传 unique_identification_number / 选项指纹等 */
 
-/** 仅更新购物车行数量；行定位语义与 updateOrderProduct / removeProductFromOrder 保持一致 */
-
 /**
  * 订单信息
  */