@pisell/pisellos 0.0.234 → 0.0.236

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

@@ -2,7 +2,7 @@ import { Module, PisellCore, ModuleOptions } from '../../types';
 import { BaseModule } from '../../modules/BaseModule';
 import { OrderModule } from '../../modules/Order';
 import { PaymentModule } from '../../modules/Payment';
-import { CheckoutModuleAPI, CheckoutStep, CheckoutInitParams, CreateLocalOrderParams, PlaceOrderParams, CreateOrderParams, ProcessPaymentParams, CheckoutStatusInfo, CheckoutSummary, CurrentOrderInfo, CartSummaryItem, ExtractedAmountInfo } from './types';
+import { CheckoutModuleAPI, CheckoutStep, CheckoutInitParams, CreateLocalOrderParams, PlaceOrderParams, CreateOrderParams, ProcessPaymentParams, CheckoutStatusInfo, CheckoutSummary, CurrentOrderInfo, CartSummaryItem, ExtractedAmountInfo, SendCustomerPayLinkParams } from './types';
 import { PaymentOrder, PaymentMethod, PaymentItem, PaymentItemInput } from '../../modules/Payment/types';
 export * from './types';
 /**
@@ -185,7 +185,8 @@ export declare class CheckoutImpl extends BaseModule implements Module, Checkout
     /**
      * 获取支付方式列表
      *
-     * 直接调用 Payment 模块的 getPayMethodListAsync 方法
+     * 优先使用 store 中的缓存数据，避免重复接口调用。
+     * 如果 store 中没有数据，则调用 Payment 模块的方法获取。
      *
      * @returns 支付方式列表
      */
@@ -251,11 +252,12 @@ export declare class CheckoutImpl extends BaseModule implements Module, Checkout
         customer_name?: string;
     } | null;
     /**
-     * 检查订单是否需要手动同步
+     * 检查订单是否需要手动同步（异步版本）
      *
      * 返回订单是否为纯代金券支付且待付金额<=0但未同步的状态
+     * 从 Payment 模块获取最新的支付项数据
      */
-    needsManualSync(): boolean;
+    needsManualSyncAsync(): Promise<boolean>;
     /**
      * 手动同步订单到后端
      *
@@ -279,6 +281,25 @@ export declare class CheckoutImpl extends BaseModule implements Module, Checkout
      * @returns 当前订单的ID，如果没有订单则返回null
      */
     getCurrentOrderId(): string | null;
+    /**
+     * 获取当前订单是否已同步到后端
+     *
+     * @returns 当前订单是否已同步状态，如果没有订单则返回false
+     */
+    isCurrentOrderSynced(): boolean;
+    /**
+     * 取消当前本地订单
+     *
+     * 只能取消未同步到后端的本地订单，如果订单已同步则不能取消
+     *
+     * @param cancelReason 取消原因（可选）
+     * @returns 取消结果
+     */
+    cancelCurrentOrderAsync(cancelReason?: string): Promise<{
+        success: boolean;
+        message?: string;
+        orderId?: string;
+    }>;
     /**
      * 保存订单并稍后支付
      *
@@ -363,13 +384,13 @@ export declare class CheckoutImpl extends BaseModule implements Module, Checkout
      */
     private calculateTotalAmount;
     /**
-     * 计算已支付金额
+     * 计算已支付金额（从 Payment 模块获取最新数据）
      */
-    private calculatePaidAmount;
+    private calculatePaidAmountAsync;
     /**
-     * 计算剩余未支付金额
+     * 计算剩余未支付金额（从 Payment 模块获取最新数据）
      */
-    private calculateRemainingAmount;
+    private calculateRemainingAmountAsync;
     /**
      * 更新 stateAmount 为当前剩余未支付金额
      */
@@ -432,5 +453,49 @@ export declare class CheckoutImpl extends BaseModule implements Module, Checkout
         message?: string;
         orderId?: string | number;
     }>;
+    /**
+     * 发送客户支付链接邮件
+     *
+     * 向指定邮箱发送订单支付提醒邮件
+     *
+     * @param params 发送参数
+     * @returns 发送结果
+     */
+    sendCustomerPayLinkAsync(params: SendCustomerPayLinkParams): Promise<{
+        success: boolean;
+        message?: string;
+    }>;
+    /**
+     * 金额舍入
+     *
+     * @param amount 原始金额
+     * @returns 舍入结果详情，包含原始金额、舍入后金额和舍入差额
+     */
+    roundAmountAsync(amount: number): Promise<{
+        originalAmount: string;
+        roundedAmount: string;
+        roundingDifference: string;
+    }>;
     destroy(): Promise<void>;
+    /**
+     * 重置 store 状态
+     *
+     * 在创建新订单前调用，确保状态完全干净
+     */
+    private resetStoreStateAsync;
+    /**
+     * 手动清理已完成的订单状态（公开方法）
+     *
+     * 供UI层调用的公开方法，用于手动清理订单状态
+     *
+     * @returns 清理结果
+     */
+    clearCompletedOrderAsync(): Promise<{
+        success: boolean;
+        message?: string;
+        clearedOrder?: {
+            uuid: string;
+            orderId: string;
+        } | null;
+    }>;
 }