@pisell/pisellos 0.0.234 → 0.0.235

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';
 /**
@@ -251,11 +251,12 @@ export declare class CheckoutImpl extends BaseModule implements Module, Checkout
         customer_name?: string;
     } | null;
     /**
-     * 检查订单是否需要手动同步
+     * 检查订单是否需要手动同步（异步版本）
      *
      * 返回订单是否为纯代金券支付且待付金额<=0但未同步的状态
+     * 从 Payment 模块获取最新的支付项数据
      */
-    needsManualSync(): boolean;
+    needsManualSyncAsync(): Promise<boolean>;
     /**
      * 手动同步订单到后端
      *
@@ -279,6 +280,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 +383,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 +452,28 @@ 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>;
 }