@pisell/pisellos 2.2.273 → 2.2.275

package/dist/server/modules/order/types.d.ts

@@ -568,6 +568,19 @@ export interface OrderChangedPayload {
     /** 触发来源，便于订阅者区分 pubsub / 远端覆盖 / 清空等场景 */
     source?: string;
 }
+export type RemoteProductMembershipChangeSource = 'pubsub.bodyUpsert' | 'pubsub.httpRefresh';
+/**
+ * 远端订单快照相对本地订单产生商品成员增删时的广播载荷。
+ * 只表达商品行成员关系变化，不包含数量、价格、备注等字段级修改。
+ */
+export interface RemoteProductMembershipChangedPayload {
+    order_id: OrderId;
+    source: RemoteProductMembershipChangeSource;
+    added_product_keys: string[];
+    removed_product_keys: string[];
+    previous_product_count: number;
+    current_product_count: number;
+}
 /**
  * OrderSyncMessage - pubsub 同步消息结构
  */
@@ -605,5 +618,6 @@ export interface OrderState {
 export declare enum OrderHooks {
     onOrdersLoaded = "order:onOrdersLoaded",
     onOrdersChanged = "order:onOrdersChanged",
+    onRemoteProductMembershipChanged = "order:onRemoteProductMembershipChanged",
     onOrdersSyncCompleted = "order:onOrdersSyncCompleted"
 }

package/dist/server/modules/order/types.js

@@ -135,6 +135,11 @@
  * const changedOrders = payload.changedOrders
  */
 
+/**
+ * 远端订单快照相对本地订单产生商品成员增删时的广播载荷。
+ * 只表达商品行成员关系变化，不包含数量、价格、备注等字段级修改。
+ */
+
 /**
  * OrderSyncMessage - pubsub 同步消息结构
  */
@@ -149,6 +154,7 @@
 export var OrderHooks = /*#__PURE__*/function (OrderHooks) {
   OrderHooks["onOrdersLoaded"] = "order:onOrdersLoaded";
   OrderHooks["onOrdersChanged"] = "order:onOrdersChanged";
+  OrderHooks["onRemoteProductMembershipChanged"] = "order:onRemoteProductMembershipChanged";
   OrderHooks["onOrdersSyncCompleted"] = "order:onOrdersSyncCompleted";
   return OrderHooks;
 }({});

package/dist/solution/BaseSales/index.d.ts

@@ -1,15 +1,15 @@
 import { Module, ModuleOptions, PisellCore } from '../../types';
 import { BaseModule } from '../../modules/BaseModule';
-import { BaseSalesOrderProduct, BaseSalesOrderProductIdentity, BaseSalesPaymentStatus, BaseSalesUpdateOrderProductQuantityParams, BaseSalesCalculateProductBookingPriceParams, BaseSalesPriceRecalculationContextChange, BaseSalesProductBookingPriceResult, BaseSalesQuotationCustomerScopeInfo, BaseSalesScanCodeResult } from './types';
+import { BaseSalesOrderProduct, BaseSalesOrderProductIdentity, BaseSalesPaymentStatus, BaseSalesUpdateOrderProductQuantityParams, BaseSalesCalculateProductBookingPriceParams, BaseSalesPriceRecalculationContextChange, BaseSalesProductBookingPriceResult, BaseSalesQuotationCustomerScopeInfo, BaseSalesScanCodeResult, BaseSalesCashPaymentConfig, BaseSalesPayCashParams, BaseSalesPayCashResult, BaseSalesCommitPaymentMethodParams, BaseSalesCommitPaymentMethodResult, BaseSalesConfirmWalletPaymentResult } from './types';
 import { OrderModule } from '../../modules/Order';
-import type { AddProductBookingInput, LoadSalesDetailParams, OrderPaymentData, OrderPaymentUpdateOptions, OrderPaymentUpdateResult, OrderPaymentSource, SendCustomerPayLinkParams, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, UpdateTempOrderCustomerInput, UpdateOrderBookingParams, UpdateOrderProductParams, OrderTempOrder, OrderSummary, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions } from '../../modules/Order/types';
+import type { AddProductBookingInput, AddProductToOrderOptions, LoadSalesDetailParams, OrderPaymentData, OrderPaymentUpdateOptions, OrderPaymentUpdateResult, OrderPaymentSource, SendCustomerPayLinkParams, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, UpdateTempOrderCustomerInput, UpdateOrderBookingParams, UpdateOrderProductParams, OrderTempOrder, OrderSummary, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions, RemoveProductsFromOrderOptions, ReplaceTempOrderOptions } from '../../modules/Order/types';
 import type { SubmitPayloadEnhancer } from '../../modules/Order/utils';
 import type { Discount } from '../../modules/Discount/types';
 import { RequestPlugin, WindowPlugin } from '../../plugins';
 export * from './types';
 import { ProductList } from '../../modules/ProductList';
 import { PaymentModule } from '../../modules/Payment';
-import type { PaymentMethod } from '../../modules/Payment/types';
+import type { PaymentMethod, RoundingResult, WalletAssetId, WalletAssetsBehaviorOptions, WalletAssetsSnapshot, WalletAssetsState, WalletAssetSelectionSource, ScanWalletAssetResult } from '../../modules/Payment/types';
 import type { SalesSummaryModule } from '../../modules/SalesSummary';
 import type { ScheduleModule } from '../../modules/Schedule';
 import { QuotationModule } from '../../modules/Quotation';
@@ -69,6 +69,7 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     private autoPaymentSyncTimer;
     private salesDetailLoadInFlightCount;
     private salesDetailLoadSequence;
+    private walletAssetsRefreshSequence;
     private salesDetailHydrateQueue;
     private serverOrderChangeUnsubscribe;
     private serverOrderChangeHydrateInFlight;
@@ -108,6 +109,16 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     private applyQuotationScheduleResolver;
     private loadQuotationForPriceQuery;
     private getPriceQueryProductId;
+    /**
+   * Change Time / customer reprice 必须沿用商品列表的渠道口径。
+   * SalesSdk Provider 通常将渠道存为 platform，因此不能只读取 otherParams.channel。
+   */
+    private getPriceQueryChannel;
+    /**
+     * /product/query 的智能定价评估只读取 strategy_context；
+     * application_code 仅作为接口兼容字段，不能替代 channel / business_code。
+     */
+    private getPriceQueryStrategyContext;
     private getPriceQuerySchedule;
     private loadProductsForPriceQuery;
     private loadProductForPriceQuery;
@@ -179,7 +190,7 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     /** 获取附加费用（运费/服务费/税费等）。 */
     getSurcharges(): ISalesSurcharge[];
     getTempOrder(): OrderTempOrder | null;
-    replaceTempOrder(tempOrder: OrderTempOrder): Promise<OrderTempOrder>;
+    replaceTempOrder(tempOrder: OrderTempOrder, options?: ReplaceTempOrderOptions): Promise<OrderTempOrder>;
     getOrderIdentity(): import("../../modules/Order/types").OrderIdentitySnapshot | null;
     getOrderSnapshot(): import("../../modules/Order/types").OrderSnapshot | null;
     getOrderSyncState(): import("../../modules/Order/types").OrderSyncState;
@@ -314,9 +325,40 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     confirmPendingVoucherPayments(): OrderPaymentData[];
     discardPendingVoucherPayments(): OrderPaymentData[];
     private getWalletProductList;
+    private buildWalletInitBusinessData;
     initWalletData(params?: {
         order_wait_pay_amount?: number;
     }): Promise<import("../../modules/Payment").WalletInitializationResult>;
+    private getCommittedWalletAssets;
+    private publishWalletAssetsState;
+    private syncSelectedWalletAssets;
+    /** 读取购物车与 Shared Checkout 共用的钱包资产状态。 */
+    getWalletAssetsState(): WalletAssetsState;
+    /** 导出 Shared Checkout 跨运行时恢复所需的钱包状态与搜索缓存。 */
+    exportWalletAssetsSnapshot(): WalletAssetsSnapshot;
+    /** 配置仅影响 Wallet Assets，不改变 Promotion/Voucher 选择流程。 */
+    configureWalletAssetsBehavior(options: WalletAssetsBehaviorOptions): void;
+    /**
+     * 恢复 Shared Checkout 钱包快照，并把选择重新同步为订单 pending payment。
+     */
+    importWalletAssetsSnapshot(snapshot: WalletAssetsSnapshot): Promise<WalletAssetsState>;
+    /**
+     * 基于当前订单快照刷新钱包资产。商品变化保留并重验选择；客户变化强制清空。
+     */
+    refreshWalletAssets(params?: {
+        order_wait_pay_amount?: number;
+        preserveSelection?: boolean;
+    }): Promise<WalletAssetsState>;
+    /** 选择或取消单张钱包资产，并立即同步 pending wallet payments。 */
+    selectWalletAsset(params: {
+        assetId: WalletAssetId;
+        selected: boolean;
+        source?: WalletAssetSelectionSource;
+    }): Promise<WalletAssetsState>;
+    /** 扫码精确查券；仅可用资产会被自动选中。 */
+    scanWalletAsset(code: string): Promise<ScanWalletAssetResult>;
+    /** 清空全部未确认钱包选择，已支付钱包项由 Order 模块继续保留。 */
+    clearWalletAssetSelection(): Promise<WalletAssetsState>;
     /**
      * 更新当前订单客户字段。
      *
@@ -333,16 +375,39 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     getPaymentMethodsAsync(): Promise<PaymentMethod[]>;
     /** 同步读取初始化时缓存的支付方式列表。 */
     getPaymentMethods(): PaymentMethod[];
-    /** 轻量舍入能力，供现金支付 UI 计算 rounding_amount。 */
+    private findCashPaymentMethod;
+    private getPendingWalletPaymentAmount;
+    /** 读取现金 action 所需的支付方式、待付金额和快捷金额。 */
+    getCashPaymentConfig(): Promise<BaseSalesCashPaymentConfig>;
+    /**
+     * 确认足额覆盖订单的 pending Wallet 支付并提交订单。
+     *
+     * Order 模块在构造提交参数时将 pending voucher 转为 paid；只有提交成功后
+     * 才同步 Wallet committed 状态。失败时恢复调用前 payments，允许用户重试。
+     */
+    confirmWalletPayment<T = Record<string, any>>(): Promise<BaseSalesConfirmWalletPaymentResult<T>>;
+    /**
+     * 购物车现金直付：写入现金记录并等待支付同步完成。
+     * 同步失败会恢复调用前 payments（包含 Wallet pending 状态）。
+     */
+    payCash(params: BaseSalesPayCashParams): Promise<BaseSalesPayCashResult>;
+    /**
+     * 提交一次已由支付设备确认成功的非 Wallet 支付。
+     *
+     * 与 addOrderPayment 不同，本入口不会启动后台 fire-and-forget 同步；调用方会等待
+     * 本次 payment、当前 pending Wallet 以及订单提交共同完成。任何同步失败都会恢复
+     * 调用前的 payments 与 payment_status，便于 UI 安全解锁并重试。
+     */
+    commitPaymentMethodPayment(params: BaseSalesCommitPaymentMethodParams): Promise<BaseSalesCommitPaymentMethodResult>;
+    /**
+     * 按当前店铺的现金舍入配置计算金额，供现金支付 UI 使用。
+     *
+     * 舍入开关取自 CASHMANUAL 支付方式；舍入规则取自
+     * otherParams.order_rounding_setting，金额算法统一由 PaymentModule 维护。
+     */
     roundAmount(params: {
         amount: string | number;
-        interval?: string | number;
-        rule?: 'standard_rounding' | 'standard_down' | 'always_up' | 'always_down' | string;
-    }): {
-        originalAmount: string;
-        roundedAmount: string;
-        roundingDifference: string;
-    };
+    }): Promise<RoundingResult>;
     /**
      * 发送支付链接。
      *
@@ -359,7 +424,7 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     getQuotationCustomerScopeInfo(): BaseSalesQuotationCustomerScopeInfo;
     shouldRecalculateProductBookingPricesForContextChange(params: BaseSalesPriceRecalculationContextChange): boolean;
     calculateProductBookingPrices(paramsList: BaseSalesCalculateProductBookingPriceParams[]): Promise<BaseSalesProductBookingPriceResult[]>;
-    addProductToOrder(product: Partial<BaseSalesOrderProduct> & BaseSalesOrderProductIdentity, booking?: AddProductBookingInput): Promise<import("../../modules/Order/types").OrderProduct[]>;
+    addProductToOrder(product: Partial<BaseSalesOrderProduct> & BaseSalesOrderProductIdentity, booking?: AddProductBookingInput, options?: AddProductToOrderOptions): Promise<import("../../modules/Order/types").OrderProduct[]>;
     updateOrderProduct(params: UpdateOrderProductParams): Promise<import("../../modules/Order/types").OrderProduct[]>;
     updateOrderProducts(paramsList: UpdateOrderProductParams[]): Promise<import("../../modules/Order/types").OrderProduct[]>;
     updateOrderProductQuantity(params: BaseSalesUpdateOrderProductQuantityParams): Promise<import("../../modules/Order/types").OrderProduct[]>;
@@ -375,8 +440,8 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
      * @example
      * await baseSales.removeProductsFromOrder([identityA, identityB]);
      */
-    removeProductsFromOrder(identities: BaseSalesOrderProductIdentity[]): Promise<import("../../modules/Order/types").OrderProduct[]>;
-    removeProductFromOrder(identity: BaseSalesOrderProductIdentity): Promise<import("../../modules/Order/types").OrderProduct[]>;
+    removeProductsFromOrder(identities: BaseSalesOrderProductIdentity[], options?: RemoveProductsFromOrderOptions): Promise<import("../../modules/Order/types").OrderProduct[]>;
+    removeProductFromOrder(identity: BaseSalesOrderProductIdentity, options?: RemoveProductsFromOrderOptions): Promise<import("../../modules/Order/types").OrderProduct[]>;
     /**
      * 注入促销评估器到底层 OrderModule。
      *