@pisell/pisellos 0.0.234 → 0.0.236

package/lib/solution/Checkout/types.d.ts

@@ -389,7 +389,11 @@ export declare enum CheckoutHooks {
     /** 订单备注变更 */
     OnOrderNoteChanged = "checkout:onOrderNoteChanged",
     /** 商店折扣变更 */
-    OnShopDiscountChanged = "checkout:onShopDiscountChanged"
+    OnShopDiscountChanged = "checkout:onShopDiscountChanged",
+    /** 订单取消 */
+    OnOrderCancelled = "checkout:onOrderCancelled",
+    /** 订单状态已清理 */
+    OnOrderCleared = "checkout:onOrderCleared"
 }
 /**
  * 结账状态数据
@@ -610,11 +614,12 @@ export interface CheckoutModuleAPI extends Module {
         orderUuid?: string;
     }>;
     /**
-     * 检查订单是否需要手动同步
+     * 检查订单是否需要手动同步（异步版本）
      *
      * 返回订单是否为纯代金券支付且待付金额<=0但未同步的状态
+     * 从 Payment 模块获取最新的支付项数据
      */
-    needsManualSync(): boolean;
+    needsManualSyncAsync(): Promise<boolean>;
     /**
      * 更新订单备注
      *
@@ -633,6 +638,25 @@ export interface CheckoutModuleAPI extends Module {
      * @returns 当前订单的ID，如果没有订单则返回null
      */
     getCurrentOrderId(): string | null;
+    /**
+     * 获取当前订单是否已同步到后端
+     *
+     * @returns 当前订单是否已同步状态，如果没有订单则返回false
+     */
+    isCurrentOrderSynced(): boolean;
+    /**
+     * 取消当前本地订单
+     *
+     * 只能取消未同步到后端的本地订单，如果订单已同步则不能取消
+     *
+     * @param cancelReason 取消原因（可选）
+     * @returns 取消结果
+     */
+    cancelCurrentOrderAsync(cancelReason?: string): Promise<{
+        success: boolean;
+        message?: string;
+        orderId?: string;
+    }>;
     /**
      * 更新订单商店折扣
      *
@@ -675,6 +699,42 @@ export interface CheckoutModuleAPI extends Module {
         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;
+    }>;
+}
+/**
+ * 发送客户支付链接参数
+ */
+export interface SendCustomerPayLinkParams {
+    /** 订单ID列表 */
+    order_ids: string[];
+    /** 通知动作，固定为订单支付提醒 */
+    notify_action?: string;
+    /** 邮箱地址列表 */
+    emails: string[];
 }
 /**
  * 结账事件数据类型
@@ -748,4 +808,20 @@ export interface CheckoutEventData {
         newDiscount: number;
         timestamp: number;
     };
+    /** 订单取消事件 */
+    orderCancelled: {
+        orderUuid?: string;
+        orderId?: string;
+        cancelReason?: string;
+        wasSynced: boolean;
+        timestamp: number;
+    };
+    /** 订单状态清理事件 */
+    orderCleared: {
+        previousOrder?: {
+            uuid: string;
+            orderId: string;
+        } | null;
+        timestamp: number;
+    };
 }

package/lib/solution/Checkout/types.js

@@ -69,6 +69,8 @@ var CheckoutHooks = /* @__PURE__ */ ((CheckoutHooks2) => {
   CheckoutHooks2["OnOrderSynced"] = "checkout:onOrderSynced";
   CheckoutHooks2["OnOrderNoteChanged"] = "checkout:onOrderNoteChanged";
   CheckoutHooks2["OnShopDiscountChanged"] = "checkout:onShopDiscountChanged";
+  CheckoutHooks2["OnOrderCancelled"] = "checkout:onOrderCancelled";
+  CheckoutHooks2["OnOrderCleared"] = "checkout:onOrderCleared";
   return CheckoutHooks2;
 })(CheckoutHooks || {});
 // Annotate the CommonJS export names for ESM import in node:

package/package.json

@@ -1,7 +1,7 @@
 {
   "private": false,
   "name": "@pisell/pisellos",
-  "version": "0.0.234",
+  "version": "0.0.236",
   "description": "一个可扩展的前端模块化SDK框架，支持插件系统",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",