@pisell/pisellos 2.2.178 → 2.2.179

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

@@ -1,11 +1,12 @@
 import { Module, PisellCore, ModuleOptions } from '../../types';
 import { BaseModule } from '../BaseModule';
-import { OrderModuleAPI, CommitOrderParams, UpdateOrderBookingParams, UpdateOrderProductParams, UpdateOrderProductQuantityParams, CheckoutOrderParams, CancelOrderParams, ChangeBookingStatusParams } from './types';
+import { OrderModuleAPI, CommitOrderParams, UpdateProductInOrderParams, CheckoutOrderParams, CancelOrderParams, ChangeBookingStatusParams } from './types';
 import { CartItem } from '../Cart/types';
 import { type SubmitPayloadEnhancer } from './utils';
-import type { OrderAmountSnapshot, AddProductBookingInput, OrderIdentitySnapshot, OrderPaymentSource, OrderSnapshot, OrderSyncState, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, SubmitSalesOrderParams, OrderProduct, OrderProductIdentity, OrderSummary, OrderTempOrder, OrderPaymentData, SendCustomerPayLinkParams, UpdateTempOrderCustomerInput, OrderCustomerPatch, OrderCustomerView, OrderScanCodeResult, ReplaceTempOrderOptions, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions } from './types';
+import type { OrderAmountSnapshot, AddProductBookingInput, OrderIdentitySnapshot, OrderPaymentSource, OrderSnapshot, OrderSyncState, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, SubmitSalesOrderParams, OrderProduct, OrderProductIdentity, OrderSummary, OrderTempOrder, OrderPaymentData, SendCustomerPayLinkParams, UpdateTempOrderCustomerInput, OrderCustomerPatch, OrderCustomerView } from './types';
 import type { ICustomer } from '../AccountList/types';
 import type { Discount } from '../Discount/types';
+import { UnavailableReason } from '../Rules/types';
 export declare class OrderModule extends BaseModule implements Module, OrderModuleAPI {
     protected defaultName: string;
     protected defaultVersion: string;
@@ -19,22 +20,11 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     private rulesHooksOverride?;
     private orderHooks?;
     private otherParams?;
-    /** 评估器引用；由 SalesSdkProvider 注入，未注入时 applyPromotion 静默跳过 */
-    private promotionEvaluator;
-    /** 赠品选择 resolver；由 SDK host bridge 注入 */
-    private giftSelectResolver;
-    /** applyPromotion 递归保护 flag（写路径同步调 applyPromotion，禁止重入） */
-    private isApplyingPromotion;
-    /** 最近一次 applyPromotion 的未满足促销提示 */
-    private lastUnfulfilledPromotions;
-    /** 最近一次 applyPromotion 的赠品操作 diff（debug / SDK 读取使用） */
-    private lastGiftActions;
     /**
      * Populate `savedAmount` on each discount based on product-level discount details.
      * Only selected discounts get a non-zero value.
      */
     static populateSavedAmounts(productList: Array<Record<string, any>>, discountList: Array<Record<string, any>>): void;
-    private applyProductDiscountPrices;
     constructor(name?: string, version?: string);
     initialize(core: PisellCore, options: ModuleOptions): Promise<void>;
     /**
@@ -53,88 +43,43 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     private createDefaultRulesHooks;
     loadDiscountConfig(params: {
         customerId: number;
-        action?: 'create' | 'edit';
-        orderId?: number;
-        apply?: boolean;
-    }): Promise<Discount[]>;
+        action?: 'create';
+    }): Promise<void>;
     getDiscountList(): Discount[];
-    scanCode(code: string, customerId?: number): Promise<OrderScanCodeResult>;
+    scanCode(code: string, customerId?: number): Promise<{
+        isAvailable: boolean;
+        discountList: Discount[];
+        type: 'server' | 'clientCalc';
+        unavailableReason?: UnavailableReason;
+        unavailableReasonKey?: string | null;
+    }>;
     applyDiscount(): void;
-    /**
-     * 注入促销评估器。
-     *
-     * @example
-     * order.setPromotionEvaluator(appHelper.utils.promotionEvaluator);
-     */
-    setPromotionEvaluator(evaluator: OrderPromotionEvaluator | null): void;
-    /**
-     * 注入赠品选择 resolver。OS 需要补赠品时会 await 调用 resolver；缺省时跳过新增并 console.warn。
-     *
-     * @example
-     * order.setGiftSelectResolver(async (ctx) => {
-     *   // SDK 内部决定弹窗 or 自动选第一项，返回完整 OrderProduct[]
-     *   return giftSelectBridge.request(ctx);
-     * });
-     */
-    setGiftSelectResolver(resolver: OrderGiftSelectResolver | null): void;
-    /**
-     * 为商品目录追加促销标签，供上层 Sales 门面复用。
-     *
-     * @example
-     * const products = order.appendPromotionTags(catalogProducts);
-     */
-    appendPromotionTags<T extends Record<string, any>>(products: T[]): T[];
-    /**
-     * 应用购物车促销：计算 → 差异化赠品 → 写回 tempOrder.products → emit onPromotionApplied。
-     *
-     * 调用时机：写路径（add/update/remove/clear/setCustomer）末尾自动触发；外部一般无需手动调。
-     *
-     * 关键约束：
-     * - 不调用任何公开 CRUD API（如 removeProductFromOrder），全部内部 mutate tempOrder.products，避免事件风暴；
-     * - 用 `isApplyingPromotion` 防递归；
-     * - 多选项赠品依赖 giftSelectResolver，未注入则跳过且 console.warn；
-     * - 不主动调用 applyDiscount / recalculateSummary，调用方负责跟进。
-     */
-    applyPromotion(): Promise<void>;
-    /** 最近一次 applyPromotion 输出的未满足促销列表 */
-    getUnfulfilledPromotions(): OrderUnfulfilledPromotion[];
-    /** 最近一次 applyPromotion 输出的赠品操作 diff */
-    getLastGiftActions(): OrderLastGiftActions | null;
     initTempOrder(params: {
         cacheId?: string;
         salesSummaryModuleName?: string;
     }): void;
-    /** @deprecated OrderModule 不再负责 tempOrder localStorage 持久化。 */
-    setEnableTempOrderPersist(_enabled: boolean): void;
-    /** @deprecated OrderModule 不再负责 tempOrder localStorage 持久化。 */
-    isTempOrderPersistEnabled(): boolean;
-    /** @deprecated OrderModule 不再负责 tempOrder localStorage 持久化；草稿保存请使用 IndexedDB saveDraft。 */
+    private getTempOrderStorageKey;
+    private restoreTempOrderFromStorage;
     persistTempOrder(): void;
     private createDefaultTempOrderInstance;
     private createExternalSaleNumber;
     private ensureExternalSaleNumber;
     private ensureRequestUniqueIdempotencyToken;
-    private buildPaymentSyncIdempotencyToken;
     hasLocalDatabase(): boolean;
     private buildLocalOrderRecord;
     getLocalOrderByOrderId(orderId: number | string): Promise<Record<string, any> | null>;
     getLocalOrderByOrderNumber(orderNumber: string): Promise<Record<string, any> | null>;
     getLocalOrderByExternalSaleNumber(externalSaleNumber: string): Promise<Record<string, any> | null>;
     saveDraft(): Promise<void>;
-    private saveDraftInBackground;
     private hydrateTempOrderFromLocalRecord;
     private extractOrderIdFromSubmitResult;
     private calculatePaymentTotal;
     private calculatePaidPaymentSummary;
     private calculatePaymentServiceFee;
-    private formatSummaryMetadataMoney;
-    private syncSummaryProductMetadata;
-    private calculateSummaryPaymentBalance;
     private getPaymentTargetAmount;
     ensureTempOrder(): OrderTempOrder;
     restoreOrder(): OrderTempOrder;
     getTempOrder(): OrderTempOrder | null;
-    replaceTempOrder(tempOrder: OrderTempOrder, options?: ReplaceTempOrderOptions): Promise<OrderTempOrder>;
     getOrderIdentity(): OrderIdentitySnapshot | null;
     getOrderSyncState(): OrderSyncState;
     getOrderAmountSnapshot(): OrderAmountSnapshot | null;
@@ -145,27 +90,20 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     private ensureExtend;
     private captureProductRuntime;
     private createLinkedProductAndBooking;
-    private getBookingUniqueIdentificationNumber;
-    private findBookingIndexByUniqueIdentificationNumber;
-    private removeLinkedBookingsForProduct;
     private getSalesSummary;
     recalculateSummary(options?: {
         createIfMissing?: boolean;
     }): Promise<OrderSummary | null>;
     getOrderSummary(): Promise<OrderSummary>;
     updateTempOrderNote(note: string): string;
-    updateTempOrderNote(note: string, sync: true): Promise<string>;
-    updateTempOrderNote(note: string, sync: boolean): string | Promise<string>;
-    syncTempOrderNoteToRemote(orderId: number | string, note: string): Promise<string>;
     getTempOrderNote(): string;
     updateTempOrderShopDiscount(amount: string | number): string;
     updateTempOrderBuzzer(buzzer: string): string;
     updateTempOrderContactsInfo(contactsInfo: Record<string, any> | null): Record<string, any> | null;
-    private buildTempOrderCustomer;
     /**
      * 更新当前 tempOrder 的客户协议字段。
      *
-     * PaymentModal 只需要修改订单里的客户事实；如果外部还有客户模块需要同步，
+     * PaymentModal 只需要修改订单里的客户字段；如果外部还有客户模块需要同步，
      * 应由调用方通过回调处理，不能把外部 UI 状态写进 tempOrder。
      */
     updateTempOrderCustomer(customer: UpdateTempOrderCustomerInput): OrderSnapshot['customer'];
@@ -210,15 +148,8 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     private shouldMergeProductToOrder;
     addProductToOrder(product: Partial<OrderProduct> & OrderProductIdentity, booking?: AddProductBookingInput): Promise<OrderProduct[]>;
     private hasGoodPassDiscount;
-    updateOrderProduct(params: UpdateOrderProductParams): Promise<OrderProduct[]>;
-    updateOrderProductQuantity(params: UpdateOrderProductQuantityParams): Promise<OrderProduct[]>;
-    updateOrderBooking(params: UpdateOrderBookingParams): any[];
+    updateProductInOrder(params: UpdateProductInOrderParams): Promise<OrderProduct[]>;
     removeProductFromOrder(identity: OrderProductIdentity): Promise<OrderProduct[]>;
-    /**
-     * 仅清空购物车行（products / bookings），不重置整单。
-     * 用于「仅清空商品」；客户、备注、支付等协议字段保持不变。
-     */
-    clearOrderCartLines(): Promise<OrderTempOrder>;
     /**
      * 提交当前 Sales tempOrder。
      *
@@ -243,7 +174,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     private logSubmitBackendRejected;
     syncPaymentsToOrder<T = any>(params: SyncPaymentsToOrderParams): Promise<SyncPaymentsToOrderResult<T>>;
     createOrder(params: CommitOrderParams['query']): {
-        type: "virtual" | "appointment_booking";
+        type: "appointment_booking" | "virtual";
         platform: string;
         sales_channel: string;
         order_sales_channel: string;
@@ -290,9 +221,8 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     hydrateTempOrderFromRecord(record: Record<string, any>, options?: {
         recalcOnHydrate?: boolean;
     }): Promise<OrderTempOrder>;
-    private normalizeTempOrderForRuntime;
     private normalizeHydratedOrderProduct;
     getLastOrderInfo(): Record<string, any> | undefined;
     getOrderInfo(order_id: number): Promise<any>;
 }
-export type { UpdateOrderBookingParams, UpdateOrderProductParams, UpdateOrderProductQuantityParams, } from './types';
+export type { UpdateProductInOrderParams } from './types';