@pisell/pisellos 2.3.101 → 2.3.103

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

@@ -29,8 +29,10 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     private promotionEvaluator;
     /** 赠品选择 resolver；由 SDK host bridge 注入 */
     private giftSelectResolver;
-    /** applyPromotion 递归保护 flag（写路径同步调 applyPromotion，禁止重入） */
+    /** 促销评估递归保护 flag（写路径同步评估促销，禁止重入） */
     private isApplyingPromotion;
+    /** 保持旧事件语义：同步事件监听器内触发的订单写入不得递归评估促销。 */
+    private isEmittingPromotionApplied;
     /** 商品曾应用过客户券卡，客户变更剥离后需强制跑一次 calcDiscount 复位价格 */
     private hasActiveCustomerBoundDiscount;
     /** 最近一次 applyPromotion 的未满足促销提示 */
@@ -60,6 +62,8 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
      * orderModule.updateOtherParams({ cacheId: 'cache-2', channel: 'pos' });
      */
     updateOtherParams(params: Record<string, any>): void;
+    /** PC/H5 属于在线店铺；其它或缺失平台统一沿用 POS 行为。 */
+    isOnlineStorePlatform(): boolean;
     /**
      * 记录信息日志
      */
@@ -82,6 +86,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     }): Promise<Discount[]>;
     getDiscountList(): Discount[];
     getAvailableWalletIds(): number[];
+    getVirtualCurrencyList(): import("../Discount/types").VirtualCurrencyAsset[];
     private syncScannedDiscountsToOriginalDiscountList;
     private ensureEditDiscountConfigForProductChange;
     scanCode(code: string, customerId?: number): Promise<{
@@ -121,7 +126,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
      */
     appendPromotionTags<T extends Record<string, any>>(products: T[]): T[];
     /**
-     * 应用购物车促销：计算 → 差异化赠品 → 写回 tempOrder.products → emit onPromotionApplied。
+     * 只执行购物车促销评估与赠品写回，不发布稳定态事件。
      *
      * 调用时机：写路径（add/update/remove/clear/setCustomer）末尾自动触发；外部一般无需手动调。
      *
@@ -129,8 +134,13 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
      * - 不调用任何公开 CRUD API（如 removeProductFromOrder），全部内部 mutate tempOrder.products，避免事件风暴；
      * - 用 `isApplyingPromotion` 防递归；
      * - 多选项赠品依赖 giftSelectResolver，未注入则跳过且 console.warn；
-     * - 不主动调用 applyDiscount / recalculateSummary，调用方负责跟进。
+     * - 不主动调用 applyDiscount / recalculateSummary，调用方负责跟进；
+     * - 返回的 payload 只能在 applyDiscount（商品写路径还需 summary/persist）完成后发布。
      */
+    private evaluatePromotion;
+    /** 发布促销稳定态；products 必须读取折扣计算后的当前数组。 */
+    private emitPromotionApplied;
+    /** 公开入口：促销、折扣、summary 与持久化完成后发布稳定态事件。 */
     applyPromotion(): Promise<void>;
     /** 最近一次 applyPromotion 输出的未满足促销列表 */
     getUnfulfilledPromotions(): OrderUnfulfilledPromotion[];
@@ -400,6 +410,13 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
      * this.hasLinkedBookingUid({ metadata: { booking_uid: 'booking-1' } });
      */
     private hasLinkedBookingUid;
+    private isMultiCurrencySettlementEnabled;
+    private isActiveVirtualSettlementOrder;
+    private shouldUseVirtualSettlementSummary;
+    private normalizeVirtualSettlementProductIfEnabled;
+    private assertAndLockProductSettlement;
+    private syncTempOrderSettlementState;
+    private prepareVirtualSettlementTempOrder;
     /**
      * 预约商品加车后的统一收尾：促销、折扣、summary 重算与持久化（批量拆行时只调用一次）。
      *
@@ -420,6 +437,11 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
      * if (pending) await pending;
      */
     private appendProductLineToTempOrder;
+    /**
+     * booking 数量拆行时，若 Holder 数量与拆行数严格一致，则按下标分配。
+     * 数量不一致时保持旧数据，避免猜测 Holder 与商品份数的对应关系。
+     */
+    private createSplitBookingLine;
     /**
      * 添加商品行。带 booking 时强制独立行；num>1 时拆成多条 num=1 的 product+booking（对齐 BookingByStep / ticketBooking addService）。
      *
@@ -472,6 +494,10 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
      * 普通整单 note 保持不变；以商品行为主体的 Sales Notes 同步删除。
      */
     clearOrderCartLines(): Promise<OrderTempOrder>;
+    /**
+     * 切换购物车结算单位时清理所有会影响新币种的订单状态，但保留当前客户。
+     */
+    clearOrderForSettlementSwitch(): Promise<OrderTempOrder>;
     buildCurrentSubmitPayloadForLocalPrint(params?: {
         cacheId?: string;
         platform?: string;