@pisell/pisellos 0.0.242 → 0.0.244

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

@@ -168,6 +168,8 @@ export interface LocalOrderData {
     created_at?: string;
     /** 附加费用 */
     surcharge_fee?: number;
+    /** 附加费列表 */
+    surcharges?: any[];
     /** 商店折扣金额 */
     shop_discount?: number;
 }
@@ -382,10 +384,14 @@ export declare enum CheckoutHooks {
     OnError = "checkout:onError",
     /** 自定义支付金额变更 */
     OnStateAmountChanged = "checkout:onStateAmountChanged",
+    /** 系统计算的待付金额变更 */
+    OnBalanceDueAmountChanged = "checkout:onBalanceDueAmountChanged",
     /** 订单支付完成（待付款金额 ≤ 0） */
     OnOrderPaymentCompleted = "checkout:onOrderPaymentCompleted",
     /** 订单同步到后端完成 */
     OnOrderSynced = "checkout:onOrderSynced",
+    /** 订单同步到后端失败 */
+    OnOrderSyncFailed = "checkout:onOrderSyncFailed",
     /** 订单备注变更 */
     OnOrderNoteChanged = "checkout:onOrderNoteChanged",
     /** 商店折扣变更 */
@@ -421,6 +427,8 @@ export interface CheckoutState {
     lastError?: CheckoutError;
     /** UI 自定义支付金额 */
     stateAmount: string;
+    /** 系统计算的待付金额（只读，由系统内部计算） */
+    balanceDueAmount: string;
     /** 订单是否已同步到后端 */
     isOrderSynced: boolean;
     /** 当前客户信息 */
@@ -560,6 +568,12 @@ export interface CheckoutModuleAPI extends Module {
      * 获取当前自定义支付金额
      */
     getStateAmount(): string;
+    /**
+     * 获取系统计算的待付金额（只读）
+     *
+     * @returns 当前系统计算的待付金额
+     */
+    getBalanceDueAmount(): string;
     /**
      * 刷新 stateAmount 为当前剩余未支付金额
      */
@@ -780,6 +794,12 @@ export interface CheckoutEventData {
         newAmount: string;
         timestamp: number;
     };
+    /** 系统计算的待付金额变更事件 */
+    balanceDueAmountChanged: {
+        oldAmount: string;
+        newAmount: string;
+        timestamp: number;
+    };
     /** 订单支付完成事件 */
     orderPaymentCompleted: {
         orderUuid: string;
@@ -797,6 +817,25 @@ export interface CheckoutEventData {
         timestamp: number;
         /** 是否为手动同步 */
         isManual?: boolean;
+        /** 后端响应数据 */
+        response?: any;
+    };
+    /** 订单同步到后端失败事件 */
+    orderSyncFailed: {
+        orderUuid: string;
+        /** 操作类型 */
+        operation: 'create' | 'update';
+        /** 是否为手动同步 */
+        isManual: boolean;
+        /** 错误信息 */
+        error: string;
+        /** 错误类型 */
+        errorType: 'network_error' | 'api_error' | 'response_invalid' | 'unknown';
+        /** 后端响应数据（如果有） */
+        response?: any;
+        /** 耗时（毫秒） */
+        duration?: number;
+        timestamp: number;
     };
     /** 订单备注变更事件 */
     orderNoteChanged: {

package/dist/solution/Checkout/types.js

@@ -113,8 +113,10 @@ export var CheckoutHooks = /*#__PURE__*/function (CheckoutHooks) {
   CheckoutHooks["OnCheckoutCancelled"] = "checkout:onCancelled";
   CheckoutHooks["OnError"] = "checkout:onError";
   CheckoutHooks["OnStateAmountChanged"] = "checkout:onStateAmountChanged";
+  CheckoutHooks["OnBalanceDueAmountChanged"] = "checkout:onBalanceDueAmountChanged";
   CheckoutHooks["OnOrderPaymentCompleted"] = "checkout:onOrderPaymentCompleted";
   CheckoutHooks["OnOrderSynced"] = "checkout:onOrderSynced";
+  CheckoutHooks["OnOrderSyncFailed"] = "checkout:onOrderSyncFailed";
   CheckoutHooks["OnOrderNoteChanged"] = "checkout:onOrderNoteChanged";
   CheckoutHooks["OnShopDiscountChanged"] = "checkout:onShopDiscountChanged";
   CheckoutHooks["OnOrderCancelled"] = "checkout:onOrderCancelled";

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

@@ -160,6 +160,14 @@ export declare class CheckoutImpl extends BaseModule implements Module, Checkout
      * @returns 当前设置的自定义支付金额
      */
     getStateAmount(): string;
+    /**
+     * 获取系统计算的待付金额（只读）
+     *
+     * 此方法返回系统内部计算的实际待付金额，不允许外部修改
+     *
+     * @returns 当前系统计算的待付金额
+     */
+    getBalanceDueAmount(): string;
     /**
      * 刷新 stateAmount 为当前剩余未支付金额
      *
@@ -391,6 +399,10 @@ export declare class CheckoutImpl extends BaseModule implements Module, Checkout
      * 计算剩余未支付金额（从 Payment 模块获取最新数据）
      */
     private calculateRemainingAmountAsync;
+    /**
+     * 更新 balanceDueAmount 为当前剩余未支付金额（系统内部计算）
+     */
+    private updateBalanceDueAmount;
     /**
      * 更新 stateAmount 为当前剩余未支付金额
      */

package/lib/solution/Checkout/index.js

@@ -53,6 +53,7 @@ var CheckoutImpl = class extends import_BaseModule.BaseModule {
       cartItems: [],
       paymentMethods: [],
       stateAmount: "0.00",
+      balanceDueAmount: "0.00",
       cartSummary: void 0,
       isOrderSynced: false,
       currentCustomer: void 0
@@ -189,7 +190,7 @@ var CheckoutImpl = class extends import_BaseModule.BaseModule {
    * 方法会记录参数并创建本地虚拟订单，然后用 Payment 模块管理支付流程。
    */
   async createLocalOrderAsync(params) {
-    var _a, _b, _c, _d;
+    var _a, _b, _c, _d, _e, _f;
     try {
       await this.resetStoreStateAsync();
       await this.setStatus(import_types.CheckoutStatus.CreatingOrder);
@@ -204,8 +205,9 @@ var CheckoutImpl = class extends import_BaseModule.BaseModule {
       const amountInfo = this.extractAmountFromCartSummary(params.cartSummary);
       params.orderData.platform = "pos";
       params.orderData.created_at = this.formatDateTime(/* @__PURE__ */ new Date());
-      params.orderData.surcharge_fee = (_b = (_a = params.totalInfo) == null ? void 0 : _a.total) == null ? void 0 : _b.paySurchargeFee;
-      params.orderData.shop_discount = (_d = (_c = params.totalInfo) == null ? void 0 : _c.total) == null ? void 0 : _d.shopDiscount;
+      params.orderData.surcharge_fee = (_b = (_a = params.totalInfo) == null ? void 0 : _a.total) == null ? void 0 : _b.otherAmount;
+      params.orderData.surcharges = (_d = (_c = params.totalInfo) == null ? void 0 : _c.total) == null ? void 0 : _d.surcharge;
+      params.orderData.shop_discount = (_f = (_e = params.totalInfo) == null ? void 0 : _e.total) == null ? void 0 : _f.shopDiscount;
       this.store.localOrderData = params.orderData;
       this.store.cartSummary = params.cartSummary;
       const customerInfo = {
@@ -514,6 +516,7 @@ var CheckoutImpl = class extends import_BaseModule.BaseModule {
       this.payment.wallet.clearAllCache();
       this.store.cartItems = [];
       this.store.stateAmount = "0.00";
+      this.store.balanceDueAmount = "0.00";
       this.store.isOrderSynced = false;
       this.store.currentCustomer = void 0;
       await this.setStatus(import_types.CheckoutStatus.Cancelled);
@@ -823,6 +826,16 @@ var CheckoutImpl = class extends import_BaseModule.BaseModule {
   getStateAmount() {
     return this.store.stateAmount;
   }
+  /**
+   * 获取系统计算的待付金额（只读）
+   *
+   * 此方法返回系统内部计算的实际待付金额，不允许外部修改
+   *
+   * @returns 当前系统计算的待付金额
+   */
+  getBalanceDueAmount() {
+    return this.store.balanceDueAmount;
+  }
   /**
    * 刷新 stateAmount 为当前剩余未支付金额
    *
@@ -1455,6 +1468,7 @@ var CheckoutImpl = class extends import_BaseModule.BaseModule {
       this.store.currentOrder = void 0;
       this.store.localOrderData = void 0;
       this.store.stateAmount = "0.00";
+      this.store.balanceDueAmount = "0.00";
       this.store.isOrderSynced = false;
       this.store.currentCustomer = void 0;
       this.payment.wallet.clearAllCache();
@@ -1979,6 +1993,41 @@ var CheckoutImpl = class extends import_BaseModule.BaseModule {
     });
     return result;
   }
+  /**
+   * 更新 balanceDueAmount 为当前剩余未支付金额（系统内部计算）
+   */
+  async updateBalanceDueAmount() {
+    var _a;
+    try {
+      const remainingAmount = await this.calculateRemainingAmountAsync();
+      const currentBalanceDueAmount = this.store.balanceDueAmount;
+      console.log("[Checkout] updateBalanceDueAmount: 状态检查:", {
+        calculatedRemainingAmount: remainingAmount,
+        currentBalanceDueAmount,
+        needsUpdate: remainingAmount !== currentBalanceDueAmount,
+        orderUuid: (_a = this.store.currentOrder) == null ? void 0 : _a.uuid
+      });
+      if (remainingAmount !== currentBalanceDueAmount) {
+        this.store.balanceDueAmount = remainingAmount;
+        await this.core.effects.emit(import_types.CheckoutHooks.OnBalanceDueAmountChanged, {
+          oldAmount: currentBalanceDueAmount,
+          newAmount: remainingAmount,
+          timestamp: Date.now()
+        });
+        console.log("[Checkout] balanceDueAmount 已自动更新:", {
+          oldAmount: currentBalanceDueAmount,
+          newAmount: remainingAmount
+        });
+      } else {
+        console.log("[Checkout] balanceDueAmount 无需更新，当前值已是最新:", {
+          balanceDueAmount: currentBalanceDueAmount,
+          remainingAmount
+        });
+      }
+    } catch (error) {
+      console.error("[Checkout] 更新 balanceDueAmount 失败:", error);
+    }
+  }
   /**
    * 更新 stateAmount 为当前剩余未支付金额
    */
@@ -2010,6 +2059,7 @@ var CheckoutImpl = class extends import_BaseModule.BaseModule {
           remainingAmount
         });
       }
+      await this.updateBalanceDueAmount();
       await this.checkOrderPaymentCompletion();
     } catch (error) {
       console.error("[Checkout] 更新 stateAmount 为剩余金额失败:", error);
@@ -2252,7 +2302,15 @@ var CheckoutImpl = class extends import_BaseModule.BaseModule {
     } catch (error) {
       submitSuccess = false;
       submitError = error instanceof Error ? error.message : String(error);
-      console.error("[Checkout] 下单接口调用失败:", submitError);
+      await this.core.effects.emit(import_types.CheckoutHooks.OnOrderSyncFailed, {
+        orderUuid: this.store.currentOrder.uuid,
+        operation: isUpdateOperation ? "update" : "create",
+        isManual,
+        error: submitError,
+        errorType: "network_error",
+        duration: Date.now() - startTime,
+        timestamp: Date.now()
+      });
       throw error;
     } finally {
       await this.core.effects.emit(import_types.CheckoutHooks.OnOrderSubmitEnd, {
@@ -2272,6 +2330,30 @@ var CheckoutImpl = class extends import_BaseModule.BaseModule {
       message: checkoutResponse == null ? void 0 : checkoutResponse.message,
       data: checkoutResponse == null ? void 0 : checkoutResponse.data
     });
+    const responseStatus = checkoutResponse == null ? void 0 : checkoutResponse.status;
+    const isSuccessResponse = responseStatus === true || responseStatus === 200 || responseStatus === "success" || responseStatus === 1 && (checkoutResponse == null ? void 0 : checkoutResponse.code) === 200;
+    if (!isSuccessResponse) {
+      const errorMessage = (checkoutResponse == null ? void 0 : checkoutResponse.message) || "订单同步失败，后端返回非成功状态";
+      console.error("[Checkout] 订单同步失败，响应状态检查未通过:", {
+        expectedSuccess: true,
+        actualStatus: responseStatus,
+        code: checkoutResponse == null ? void 0 : checkoutResponse.code,
+        message: checkoutResponse == null ? void 0 : checkoutResponse.message,
+        errorMessage
+      });
+      await this.core.effects.emit(import_types.CheckoutHooks.OnOrderSyncFailed, {
+        orderUuid: this.store.currentOrder.uuid,
+        operation: isUpdateOperation ? "update" : "create",
+        isManual,
+        error: errorMessage,
+        errorType: "api_error",
+        response: checkoutResponse,
+        duration: Date.now() - startTime,
+        timestamp: Date.now()
+      });
+      throw new Error(errorMessage);
+    }
+    console.log("[Checkout] 响应状态检查通过，开始处理订单数据");
     let realOrderId;
     if (isUpdateOperation) {
       realOrderId = currentOrderId;
@@ -2598,6 +2680,7 @@ var CheckoutImpl = class extends import_BaseModule.BaseModule {
       this.store.localOrderData = void 0;
       this.store.cartSummary = void 0;
       this.store.stateAmount = "0.00";
+      this.store.balanceDueAmount = "0.00";
       this.store.isOrderSynced = false;
       this.store.currentCustomer = void 0;
       this.store.lastError = void 0;

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

@@ -168,6 +168,8 @@ export interface LocalOrderData {
     created_at?: string;
     /** 附加费用 */
     surcharge_fee?: number;
+    /** 附加费列表 */
+    surcharges?: any[];
     /** 商店折扣金额 */
     shop_discount?: number;
 }
@@ -382,10 +384,14 @@ export declare enum CheckoutHooks {
     OnError = "checkout:onError",
     /** 自定义支付金额变更 */
     OnStateAmountChanged = "checkout:onStateAmountChanged",
+    /** 系统计算的待付金额变更 */
+    OnBalanceDueAmountChanged = "checkout:onBalanceDueAmountChanged",
     /** 订单支付完成（待付款金额 ≤ 0） */
     OnOrderPaymentCompleted = "checkout:onOrderPaymentCompleted",
     /** 订单同步到后端完成 */
     OnOrderSynced = "checkout:onOrderSynced",
+    /** 订单同步到后端失败 */
+    OnOrderSyncFailed = "checkout:onOrderSyncFailed",
     /** 订单备注变更 */
     OnOrderNoteChanged = "checkout:onOrderNoteChanged",
     /** 商店折扣变更 */
@@ -421,6 +427,8 @@ export interface CheckoutState {
     lastError?: CheckoutError;
     /** UI 自定义支付金额 */
     stateAmount: string;
+    /** 系统计算的待付金额（只读，由系统内部计算） */
+    balanceDueAmount: string;
     /** 订单是否已同步到后端 */
     isOrderSynced: boolean;
     /** 当前客户信息 */
@@ -560,6 +568,12 @@ export interface CheckoutModuleAPI extends Module {
      * 获取当前自定义支付金额
      */
     getStateAmount(): string;
+    /**
+     * 获取系统计算的待付金额（只读）
+     *
+     * @returns 当前系统计算的待付金额
+     */
+    getBalanceDueAmount(): string;
     /**
      * 刷新 stateAmount 为当前剩余未支付金额
      */
@@ -780,6 +794,12 @@ export interface CheckoutEventData {
         newAmount: string;
         timestamp: number;
     };
+    /** 系统计算的待付金额变更事件 */
+    balanceDueAmountChanged: {
+        oldAmount: string;
+        newAmount: string;
+        timestamp: number;
+    };
     /** 订单支付完成事件 */
     orderPaymentCompleted: {
         orderUuid: string;
@@ -797,6 +817,25 @@ export interface CheckoutEventData {
         timestamp: number;
         /** 是否为手动同步 */
         isManual?: boolean;
+        /** 后端响应数据 */
+        response?: any;
+    };
+    /** 订单同步到后端失败事件 */
+    orderSyncFailed: {
+        orderUuid: string;
+        /** 操作类型 */
+        operation: 'create' | 'update';
+        /** 是否为手动同步 */
+        isManual: boolean;
+        /** 错误信息 */
+        error: string;
+        /** 错误类型 */
+        errorType: 'network_error' | 'api_error' | 'response_invalid' | 'unknown';
+        /** 后端响应数据（如果有） */
+        response?: any;
+        /** 耗时（毫秒） */
+        duration?: number;
+        timestamp: number;
     };
     /** 订单备注变更事件 */
     orderNoteChanged: {

package/lib/solution/Checkout/types.js

@@ -65,8 +65,10 @@ var CheckoutHooks = /* @__PURE__ */ ((CheckoutHooks2) => {
   CheckoutHooks2["OnCheckoutCancelled"] = "checkout:onCancelled";
   CheckoutHooks2["OnError"] = "checkout:onError";
   CheckoutHooks2["OnStateAmountChanged"] = "checkout:onStateAmountChanged";
+  CheckoutHooks2["OnBalanceDueAmountChanged"] = "checkout:onBalanceDueAmountChanged";
   CheckoutHooks2["OnOrderPaymentCompleted"] = "checkout:onOrderPaymentCompleted";
   CheckoutHooks2["OnOrderSynced"] = "checkout:onOrderSynced";
+  CheckoutHooks2["OnOrderSyncFailed"] = "checkout:onOrderSyncFailed";
   CheckoutHooks2["OnOrderNoteChanged"] = "checkout:onOrderNoteChanged";
   CheckoutHooks2["OnShopDiscountChanged"] = "checkout:onShopDiscountChanged";
   CheckoutHooks2["OnOrderCancelled"] = "checkout:onOrderCancelled";

package/package.json

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