@pisell/pisellos 2.3.37 → 2.3.38

package/lib/solution/BaseSales/index.js

@@ -49,6 +49,88 @@ var import_Quotation = require("../../modules/Quotation");
 var import_transformBaseProductToOrderProduct = require("./utils/transformBaseProductToOrderProduct");
 var import_quotationPrice = require("./utils/quotationPrice");
 var SERVER_ORDER_CHANGED_EVENT = "order:onOrdersChanged";
+var WALLET_PAYMENT_CODE_BY_TAG = {
+  product_voucher: "PRODUCTVOUCHER",
+  gift_card: "GIFTCARD",
+  point_card: "POINTCARD"
+};
+function getSharedWalletAssetId(asset) {
+  return (asset == null ? void 0 : asset.id) ?? (asset == null ? void 0 : asset.voucher_id) ?? (asset == null ? void 0 : asset.code);
+}
+function getSharedWalletAssetAmount(asset) {
+  const value = (asset == null ? void 0 : asset.edit_current_amount) ?? (asset == null ? void 0 : asset._available_max_amount) ?? ((asset == null ? void 0 : asset.tag) === "point_card" ? asset == null ? void 0 : asset.recommended_usage_amount : asset == null ? void 0 : asset.available_max_amount) ?? (asset == null ? void 0 : asset.actualDeduction) ?? (asset == null ? void 0 : asset.amount) ?? 0;
+  const amount = Number(value);
+  return Number.isFinite(amount) && amount > 0 ? amount : 0;
+}
+function isRejectedSalesSubmitResult(result) {
+  var _a, _b;
+  const candidates = [
+    result,
+    result == null ? void 0 : result.data,
+    (_a = result == null ? void 0 : result.response) == null ? void 0 : _a.data,
+    (_b = result == null ? void 0 : result.response) == null ? void 0 : _b.body
+  ];
+  return candidates.some((candidate) => {
+    if (!candidate || typeof candidate !== "object")
+      return false;
+    const responseCode = Number(candidate.code ?? candidate.statusCode);
+    if (Number.isFinite(responseCode) && responseCode >= 400)
+      return true;
+    if (candidate.status === false || candidate.success === false || candidate.result === false) {
+      return true;
+    }
+    return ["failed", "error"].includes(
+      String(candidate.status || "").toLowerCase()
+    );
+  });
+}
+function getSalesSubmitErrorMessage(result) {
+  var _a, _b;
+  return (result == null ? void 0 : result.message) || (result == null ? void 0 : result.msg) || ((_a = result == null ? void 0 : result.data) == null ? void 0 : _a.message) || ((_b = result == null ? void 0 : result.data) == null ? void 0 : _b.msg) || "Wallet 支付确认失败";
+}
+function toWalletFundValue(value) {
+  try {
+    return new import_decimal.default(value || 0).toDecimalPlaces(2).toFixed(2);
+  } catch {
+    return "0.00";
+  }
+}
+function subtractWalletFundValue(left, right) {
+  try {
+    return new import_decimal.default(left || 0).minus(right || 0).toDecimalPlaces(2).toFixed(2);
+  } catch {
+    return "0.00";
+  }
+}
+function getSharedWalletPassUseValue(params) {
+  const { asset, amount, paymentMethod } = params;
+  const configuredValue = Number(asset == null ? void 0 : asset.wallet_pass_use_value);
+  if (Number.isFinite(configuredValue) && configuredValue > 0) {
+    return configuredValue;
+  }
+  const isPointCard = (asset == null ? void 0 : asset.tag) === "point_card" || paymentMethod.code === "POINTCARD";
+  const usageUnit = asset == null ? void 0 : asset.wallet_pass_usage_unit;
+  if (isPointCard && (usageUnit == null ? void 0 : usageUnit.points) && (usageUnit == null ? void 0 : usageUnit.price)) {
+    return new import_decimal.default(amount).div(usageUnit.price).mul(usageUnit.points).toDecimalPlaces(2, import_decimal.default.ROUND_DOWN).toNumber();
+  }
+  return amount;
+}
+function buildSharedWalletFundRecord(params) {
+  const { asset, amount, paymentMethod } = params;
+  const isPointCard = (asset == null ? void 0 : asset.tag) === "point_card" || paymentMethod.code === "POINTCARD";
+  const usingBeforeValue = (asset == null ? void 0 : asset.balance_par_value) ?? (asset == null ? void 0 : asset.balance) ?? (asset == null ? void 0 : asset.using_before_value) ?? 0;
+  const walletPassUseValue = getSharedWalletPassUseValue(params);
+  const usingValue = isPointCard ? walletPassUseValue : amount;
+  const walletPassName = (asset == null ? void 0 : asset.wallet_pass_name) || (asset == null ? void 0 : asset.format_title) || (asset == null ? void 0 : asset.product_name) || (asset == null ? void 0 : asset.name) || paymentMethod.name;
+  return {
+    voucher_id: (asset == null ? void 0 : asset.voucher_id) ?? (asset == null ? void 0 : asset.id),
+    wallet_pass_name: walletPassName && typeof walletPassName === "object" ? walletPassName : { default: walletPassName || "" },
+    code: (asset == null ? void 0 : asset.code) || (asset == null ? void 0 : asset.tag),
+    encoded: asset == null ? void 0 : asset.encoded,
+    using_before_value: toWalletFundValue(usingBeforeValue),
+    using_after_value: subtractWalletFundValue(usingBeforeValue, usingValue)
+  };
+}
 function isBaseSalesManualProductDiscountProduct(product) {
   var _a, _b;
   return ((_a = product == null ? void 0 : product.metadata) == null ? void 0 : _a.is_manual_discount) === true || ((_b = product == null ? void 0 : product.metadata) == null ? void 0 : _b.is_manual_discount) === 1 || ((product == null ? void 0 : product.discount_list) || []).some((item) => (item == null ? void 0 : item.type) === "product");
@@ -332,6 +414,11 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       order: void 0
     };
     this.otherParams = {};
+    /**
+     * 由已在初始化阶段解析过设备短号的业务解决方案写入。
+     * 未设置时，支付编号仍按原逻辑实时读取设备信息。
+     */
+    this.paymentNumberDevicePrefix = null;
     // 当前缓存中已加载的最新 SalesDetail；只读 getter 走它对外暴露详情数据。
     this.currentSalesDetail = null;
     this.discountConfigCacheKey = null;
@@ -343,6 +430,7 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     this.autoPaymentSyncTimer = null;
     this.salesDetailLoadInFlightCount = 0;
     this.salesDetailLoadSequence = 0;
+    this.walletAssetsRefreshSequence = 0;
     this.salesDetailHydrateQueue = Promise.resolve();
     this.serverOrderChangeUnsubscribe = null;
     this.serverOrderChangeHydrateInFlight = null;
@@ -862,6 +950,14 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     const coreData = (_f = (_d = (_c = app == null ? void 0 : app.models) == null ? void 0 : _c.getStore) == null ? void 0 : (_e = _d.call(_c)).getDataByModel) == null ? void 0 : _f.call(_e, "core", "core");
     return coreData == null ? void 0 : coreData[key];
   }
+  /**
+   * 复用业务解决方案初始化时已解析的支付设备短号。
+   * 空值会清除缓存，使后续支付恢复实时读取设备信息的兼容路径。
+   */
+  setPaymentNumberDevicePrefix(prefix) {
+    const normalized = String(prefix ?? "").trim();
+    this.paymentNumberDevicePrefix = normalized || null;
+  }
   getPaymentNumberDevicePrefixSync() {
     if (!this.appPlugin)
       return "LOCAL";
@@ -870,6 +966,9 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
   getPaymentNumberDevicePrefixAsync() {
     if (!this.appPlugin)
       return Promise.resolve("LOCAL");
+    if (this.paymentNumberDevicePrefix) {
+      return Promise.resolve(this.paymentNumberDevicePrefix);
+    }
     return (0, import_payment_number.resolvePaymentNumberDevicePrefix)((key) => this.getAppData(key));
   }
   syncAppDataToTempOrder(tempOrder) {
@@ -912,6 +1011,7 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     var _a, _b;
     this.core = core;
     this.initializeOptions = options || {};
+    this.paymentNumberDevicePrefix = null;
     this.otherParams = options.otherParams || {};
     this.cacheId = (_a = this.otherParams) == null ? void 0 : _a.cacheId;
     this.reusedSharedSubModuleNames.clear();
@@ -973,8 +1073,10 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       }
     });
     this.currentSalesDetail = null;
+    this.paymentNumberDevicePrefix = null;
     this.queuedServerOrderChanges = [];
     this.salesDetailLoadSequence += 1;
+    this.walletAssetsRefreshSequence += 1;
     await this.core.effects.emit(`${this.name}:onDestroy`, {});
     super.destroy();
   }
@@ -1191,6 +1293,7 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
   // 重置 tempOrder 与与上一单强相关的运行态（resource/entryPaxNumber/enabledReservationRuleProducts），
   // 适用于从支付页通过 react-router 跳回继续下单时清理残留数据
   async restoreOrder() {
+    var _a;
     try {
       if (!this.store.order) {
         throw new Error("scanOrder 解决方案需要 order 模块支持");
@@ -1199,6 +1302,12 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       this.currentSalesDetail = null;
       this.discountConfigCacheKey = null;
       this.hasManualDiscountSelection = false;
+      const wallet = (_a = this.store.payment) == null ? void 0 : _a.wallet;
+      if (wallet) {
+        this.walletAssetsRefreshSequence += 1;
+        wallet.clearAllCache();
+        await this.publishWalletAssetsState(wallet.getWalletAssetsState());
+      }
       await this.effectsEmit("onTempOrderReplaced", { tempOrder });
       if (this.syncAppDataToTempOrder(tempOrder) && this.isTempOrderPersistEnabled()) {
         this.store.order.persistTempOrder();
@@ -1814,7 +1923,7 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     return this.store.order.saveTempOrderAsDraft({
       cacheId: this.cacheId,
       platform: (params == null ? void 0 : params.platform) ?? ((_a = this.otherParams) == null ? void 0 : _a.platform),
-      businessCode: (params == null ? void 0 : params.businessCode) ?? ((_b = this.otherParams) == null ? void 0 : _b.businessCode) ?? ((_c = this.otherParams) == null ? void 0 : _c.business_code),
+      businessCode: (params == null ? void 0 : params.businessCode) || ((_b = this.otherParams) == null ? void 0 : _b.businessCode) || ((_c = this.otherParams) == null ? void 0 : _c.business_code),
       channel: (params == null ? void 0 : params.channel) ?? this.getSubmitOrderSalesChannel(),
       type: (params == null ? void 0 : params.type) ?? ((_d = this.otherParams) == null ? void 0 : _d.type),
       ...(params == null ? void 0 : params.enhancePayload) !== void 0 ? { enhancePayload: params.enhancePayload } : {}
@@ -2032,7 +2141,10 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       hasPaymentNumber ? "LOCAL" : this.getPaymentNumberDevicePrefixSync()
     );
   }
-  /** 创建新支付项时读取最新设备短号，不缓存运行时设备信息。 */
+  /**
+   * 创建新支付项时优先使用业务解决方案初始化阶段缓存的设备短号；
+   * 未缓存的通用 BaseSales 保持实时读取设备信息的兼容语义。
+   */
   async addOrderPaymentAsync(payment) {
     const paymentRecord = payment;
     const hasPaymentNumber = String(paymentRecord.payment_number || "").trim() !== "";
@@ -2185,7 +2297,16 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
   confirmPendingVoucherPayments() {
     if (!this.store.order)
       throw new Error("order 模块未初始化");
-    return this.store.order.confirmPendingVoucherPayments();
+    const payments = this.store.order.confirmPendingVoucherPayments();
+    if (this.store.payment) {
+      const committed = this.getCommittedWalletAssets();
+      const state = this.store.payment.wallet.setCommittedWalletAssets(
+        committed.ids,
+        committed.assets
+      );
+      void this.publishWalletAssetsState(state);
+    }
+    return payments;
   }
   discardPendingVoucherPayments() {
     if (!this.store.order)
@@ -2246,24 +2367,14 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     });
     return walletProducts;
   }
-  async initWalletData(params) {
-    if (!this.store.order)
-      throw new Error("order 模块未初始化");
-    if (!this.store.payment)
-      throw new Error("payment 模块未初始化");
-    const snapshot = this.store.order.getOrderSnapshot();
+  buildWalletInitBusinessData(params) {
+    var _a;
+    const snapshot = (_a = this.store.order) == null ? void 0 : _a.getOrderSnapshot();
     const tempOrder = snapshot == null ? void 0 : snapshot.tempOrder;
     const amount = snapshot == null ? void 0 : snapshot.amount;
-    if (!tempOrder || !amount) {
-      return {
-        walletRecommendList: [],
-        userIdentificationCodes: [],
-        transformList: [],
-        noApplicableVoucher: [],
-        products: []
-      };
-    }
-    const walletBusinessData = {
+    if (!tempOrder || !amount)
+      return null;
+    return {
       customer_id: tempOrder.customer_id ? Number(tempOrder.customer_id) : void 0,
       holder: tempOrder.holder,
       amountInfo: {
@@ -2277,11 +2388,29 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       is_price_include_tax: tempOrder.is_price_include_tax ?? this.otherParams.is_price_include_tax ?? 1,
       ...snapshot.identity.orderId ? { payment_order_id: String(snapshot.identity.orderId) } : {}
     };
+  }
+  async initWalletData(params) {
+    var _a;
+    if (!this.store.order)
+      throw new Error("order 模块未初始化");
+    if (!this.store.payment)
+      throw new Error("payment 模块未初始化");
+    const snapshot = this.store.order.getOrderSnapshot();
+    const walletBusinessData = this.buildWalletInitBusinessData(params);
+    if (!walletBusinessData) {
+      return {
+        walletRecommendList: [],
+        userIdentificationCodes: [],
+        transformList: [],
+        noApplicableVoucher: [],
+        products: []
+      };
+    }
     const result = await this.store.payment.wallet.initializeWalletDataFromBusinessAsync(
       walletBusinessData
     );
     await this.core.effects.emit(`${this.name}:onWalletDataInitialized`, {
-      orderId: snapshot.identity.orderId,
+      orderId: (_a = snapshot == null ? void 0 : snapshot.identity) == null ? void 0 : _a.orderId,
       customerId: walletBusinessData.customer_id,
       walletBusinessData: {
         customer_id: walletBusinessData.customer_id,
@@ -2292,6 +2421,202 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     });
     return result;
   }
+  getCommittedWalletAssets() {
+    var _a, _b;
+    const payments = ((_b = (_a = this.store.order) == null ? void 0 : _a.getOrderPayments) == null ? void 0 : _b.call(_a)) || [];
+    const committed = payments.filter((payment) => {
+      const voucherId = payment == null ? void 0 : payment.voucher_id;
+      if (voucherId === void 0 || voucherId === null || voucherId === 0) {
+        return false;
+      }
+      return (payment == null ? void 0 : payment.status) === "paid" || (payment == null ? void 0 : payment.isSynced) === true || (payment == null ? void 0 : payment.order_payment_id) !== void 0 && (payment == null ? void 0 : payment.order_payment_id) !== null && (payment == null ? void 0 : payment.order_payment_id) !== "";
+    });
+    return {
+      ids: committed.map((payment) => payment.voucher_id),
+      assets: committed.map((payment) => {
+        var _a2;
+        const fundRecord = (payment == null ? void 0 : payment.fund_record) || {};
+        const walletPassName = fundRecord.wallet_pass_name;
+        const title = walletPassName && typeof walletPassName === "object" ? walletPassName.default || Object.values(walletPassName)[0] : walletPassName;
+        const code = String((payment == null ? void 0 : payment.code) || "").toUpperCase();
+        const tag = ((_a2 = Object.entries(WALLET_PAYMENT_CODE_BY_TAG).find(
+          ([, paymentCode]) => paymentCode === code
+        )) == null ? void 0 : _a2[0]) || fundRecord.tag;
+        return {
+          id: payment.voucher_id,
+          voucher_id: payment.voucher_id,
+          code: fundRecord.code,
+          tag,
+          product_name: title || payment.name,
+          name: title || payment.name,
+          amount: Number(payment.amount || 0),
+          _available_max_amount: Number(payment.amount || 0),
+          unified_available_status: 1,
+          _unified_available_status: 1,
+          _committed_payment: payment
+        };
+      })
+    };
+  }
+  async publishWalletAssetsState(state) {
+    await this.effectsEmit(import_types.BaseSalesHookNames.onWalletAssetsStateChanged, {
+      state
+    });
+    return state;
+  }
+  async syncSelectedWalletAssets(state) {
+    if (!this.store.order || !this.store.payment) {
+      throw new Error("订单或支付模块未初始化");
+    }
+    let paymentMethods = this.getPaymentMethods();
+    if (!paymentMethods.length && state.selectedItems.length) {
+      paymentMethods = await this.getPaymentMethodsAsync();
+    }
+    const methodByCode = new Map(
+      paymentMethods.map((method) => [String(method.code || "").toUpperCase(), method])
+    );
+    const preparePayments = this.store.payment.wallet.formatWalletPassList2PreparePayments(
+      state.selectedItems
+    );
+    const selectedAssetById = new Map(
+      state.selectedItems.map((asset) => [
+        String(getSharedWalletAssetId(asset)),
+        asset
+      ])
+    );
+    const voucherPayments = preparePayments.flatMap((item) => {
+      const asset = selectedAssetById.get(String(item.voucher_id));
+      const paymentCode = WALLET_PAYMENT_CODE_BY_TAG[String(item.tag || (asset == null ? void 0 : asset.tag) || "")] || String(item.tag || (asset == null ? void 0 : asset.tag) || "").toUpperCase();
+      const paymentMethod = methodByCode.get(paymentCode);
+      const formattedAmount = Number(item.amount);
+      const amount = Number.isFinite(formattedAmount) && formattedAmount > 0 ? formattedAmount : getSharedWalletAssetAmount(asset);
+      if (!asset || !paymentMethod || !Number.isFinite(amount) || amount <= 0) {
+        return [];
+      }
+      const walletPassUseValue = getSharedWalletPassUseValue({
+        asset,
+        amount,
+        paymentMethod
+      });
+      return [
+        {
+          amount: amount.toFixed(2),
+          code: paymentMethod.code,
+          custom_payment_id: paymentMethod.id,
+          name: paymentMethod.name,
+          type: paymentMethod.type,
+          voucher_id: item.voucher_id,
+          wallet_pass_usage_unit: item.wallet_pass_usage_unit,
+          wallet_pass_use_value: walletPassUseValue,
+          fund_record: buildSharedWalletFundRecord({
+            asset,
+            amount,
+            paymentMethod
+          })
+        }
+      ];
+    });
+    const payments = this.updateVoucherOrderPayments(voucherPayments, {
+      status: "payment_pending"
+    });
+    await this.store.order.recalculateSummary({ createIfMissing: true });
+    return payments;
+  }
+  /** 读取购物车与 Shared Checkout 共用的钱包资产状态。 */
+  getWalletAssetsState() {
+    if (!this.store.payment)
+      throw new Error("payment 模块未初始化");
+    return this.store.payment.wallet.getWalletAssetsState();
+  }
+  /** 导出 Shared Checkout 跨运行时恢复所需的钱包状态与搜索缓存。 */
+  exportWalletAssetsSnapshot() {
+    if (!this.store.payment)
+      throw new Error("payment 模块未初始化");
+    return this.store.payment.wallet.exportWalletAssetsSnapshot();
+  }
+  /**
+   * 恢复 Shared Checkout 钱包快照，并把选择重新同步为订单 pending payment。
+   */
+  async importWalletAssetsSnapshot(snapshot) {
+    if (!this.store.payment)
+      throw new Error("payment 模块未初始化");
+    const state = this.store.payment.wallet.importWalletAssetsSnapshot(snapshot);
+    await this.syncSelectedWalletAssets(state);
+    return this.publishWalletAssetsState(state);
+  }
+  /**
+   * 基于当前订单快照刷新钱包资产。商品变化保留并重验选择；客户变化强制清空。
+   */
+  async refreshWalletAssets(params) {
+    if (!this.store.order)
+      throw new Error("order 模块未初始化");
+    if (!this.store.payment)
+      throw new Error("payment 模块未初始化");
+    const refreshSequence = ++this.walletAssetsRefreshSequence;
+    const wallet = this.store.payment.wallet;
+    const businessData = this.buildWalletInitBusinessData(params);
+    if (!businessData) {
+      wallet.clearAllCache();
+      const emptyState = wallet.getWalletAssetsState();
+      this.updateVoucherOrderPayments([], { status: "payment_pending" });
+      return this.publishWalletAssetsState(emptyState);
+    }
+    const previousState = wallet.getWalletAssetsState();
+    const hasPreviousWalletContext = previousState.status !== "idle" || previousState.items.length > 0 || previousState.selectedIds.length > 0 || previousState.customerId !== void 0;
+    const customerChanged = hasPreviousWalletContext && String(previousState.customerId ?? "") !== String(businessData.customer_id ?? "");
+    if (customerChanged) {
+      const clearedState = wallet.clearWalletAssetSelection();
+      this.updateVoucherOrderPayments([], { status: "payment_pending" });
+      await this.publishWalletAssetsState(clearedState);
+    }
+    const refreshTask = wallet.refreshWalletAssetsFromBusinessAsync(
+      businessData,
+      {
+        preserveSelection: (params == null ? void 0 : params.preserveSelection) !== false && !customerChanged
+      }
+    );
+    await this.publishWalletAssetsState(wallet.getWalletAssetsState());
+    let state = await refreshTask;
+    if (refreshSequence !== this.walletAssetsRefreshSequence) {
+      return wallet.getWalletAssetsState();
+    }
+    if (state.status !== "error") {
+      const committed = this.getCommittedWalletAssets();
+      state = wallet.setCommittedWalletAssets(committed.ids, committed.assets);
+    }
+    await this.syncSelectedWalletAssets(state);
+    return this.publishWalletAssetsState(state);
+  }
+  /** 选择或取消单张钱包资产，并立即同步 pending wallet payments。 */
+  async selectWalletAsset(params) {
+    if (!this.store.payment)
+      throw new Error("payment 模块未初始化");
+    const state = this.store.payment.wallet.selectWalletAsset(params.assetId, {
+      selected: params.selected,
+      source: params.source
+    });
+    await this.syncSelectedWalletAssets(state);
+    return this.publishWalletAssetsState(state);
+  }
+  /** 扫码精确查券；仅可用资产会被自动选中。 */
+  async scanWalletAsset(code) {
+    if (!this.store.payment)
+      throw new Error("payment 模块未初始化");
+    const result = await this.store.payment.wallet.scanWalletAssetAsync(code);
+    if (result.type === "normalCode") {
+      await this.syncSelectedWalletAssets(result.state);
+      await this.publishWalletAssetsState(result.state);
+    }
+    return result;
+  }
+  /** 清空全部未确认钱包选择，已支付钱包项由 Order 模块继续保留。 */
+  async clearWalletAssetSelection() {
+    if (!this.store.payment)
+      throw new Error("payment 模块未初始化");
+    const state = this.store.payment.wallet.clearWalletAssetSelection();
+    await this.syncSelectedWalletAssets(state);
+    return this.publishWalletAssetsState(state);
+  }
   /**
    * 更新当前订单客户字段。
    *
@@ -2328,28 +2653,346 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
   getPaymentMethods() {
     return [...this.paymentMethodsCache];
   }
-  /** 轻量舍入能力，供现金支付 UI 计算 rounding_amount。 */
-  roundAmount(params) {
-    const amount = new import_decimal.default(params.amount || 0);
-    const interval = new import_decimal.default(params.interval || 0.05);
-    const rule = params.rule || "standard_rounding";
-    const quotient = amount.div(interval);
-    let roundedQuotient;
-    if (rule === "always_up") {
-      roundedQuotient = quotient.ceil();
-    } else if (rule === "always_down") {
-      roundedQuotient = quotient.floor();
-    } else if (rule === "standard_down") {
-      roundedQuotient = quotient.toDecimalPlaces(0, import_decimal.default.ROUND_HALF_DOWN);
-    } else {
-      roundedQuotient = quotient.toDecimalPlaces(0, import_decimal.default.ROUND_HALF_UP);
+  findCashPaymentMethod(paymentMethods) {
+    return paymentMethods.find((method) => {
+      const identifiers = [method == null ? void 0 : method.code, method == null ? void 0 : method.type, method == null ? void 0 : method.tag].map(
+        (value) => String(value || "").toUpperCase()
+      );
+      return identifiers.includes("CASHMANUAL") && (method == null ? void 0 : method.enabled) !== false && (method == null ? void 0 : method.enable) !== false;
+    });
+  }
+  getPendingWalletPaymentAmount(payments = ((_b) => (_b = ((_a) => (_a = this.store.order) == null ? void 0 : _a.getOrderPayments)()) == null ? void 0 : _b.call(_a))() || []) {
+    return payments.reduce((total, payment) => {
+      if ((payment == null ? void 0 : payment.status) !== "payment_pending" || (payment == null ? void 0 : payment.voucher_id) === void 0 || Number(payment.voucher_id) === 0) {
+        return total;
+      }
+      try {
+        return total.plus(payment.amount || 0).plus(payment.rounding_amount || 0);
+      } catch {
+        return total;
+      }
+    }, new import_decimal.default(0));
+  }
+  /** 读取现金 action 所需的支付方式、待付金额和快捷金额。 */
+  async getCashPaymentConfig() {
+    var _a, _b, _c, _d, _e, _f;
+    if (!this.store.payment)
+      throw new Error("payment 模块未初始化");
+    let paymentMethods = this.getPaymentMethods();
+    let paymentMethod = this.findCashPaymentMethod(paymentMethods);
+    if (!paymentMethod) {
+      paymentMethods = await this.getPaymentMethodsAsync();
+      paymentMethod = this.findCashPaymentMethod(paymentMethods);
+    }
+    const amountSnapshot = (_b = (_a = this.store.order) == null ? void 0 : _a.getOrderAmountSnapshot) == null ? void 0 : _b.call(_a);
+    const pendingWalletAmount = this.getPendingWalletPaymentAmount();
+    const amountDue = import_decimal.default.max(
+      new import_decimal.default((amountSnapshot == null ? void 0 : amountSnapshot.amountGap) || 0).minus(pendingWalletAmount),
+      0
+    ).toDecimalPlaces(2).toNumber();
+    const currency = ((_e = (_d = (_c = this.store.order) == null ? void 0 : _c.getTempOrder) == null ? void 0 : _d.call(_c)) == null ? void 0 : _e.currency_code) || ((_f = this.otherParams) == null ? void 0 : _f.currency) || "USD";
+    const recommendedAmounts = amountDue > 0 ? this.store.payment.cash.getRecommendedAmount(amountDue, currency) : [];
+    return {
+      available: Boolean(paymentMethod && amountDue > 0),
+      paymentMethod,
+      amountDue,
+      recommendedAmounts
+    };
+  }
+  /**
+   * 确认足额覆盖订单的 pending Wallet 支付并提交订单。
+   *
+   * Order 模块在构造提交参数时将 pending voucher 转为 paid；只有提交成功后
+   * 才同步 Wallet committed 状态。失败时恢复调用前 payments，允许用户重试。
+   */
+  async confirmWalletPayment() {
+    var _a, _b, _c, _d, _e;
+    if (!this.store.order)
+      throw new Error("order 模块未初始化");
+    const beforePayments = (0, import_lodash_es.cloneDeep)(this.store.order.getOrderPayments());
+    const pendingWalletAmount = this.getPendingWalletPaymentAmount(beforePayments);
+    if (pendingWalletAmount.lte(0)) {
+      throw new Error("当前订单没有待确认的 Wallet 支付");
+    }
+    const amountSnapshot = (_b = (_a = this.store.order).getOrderAmountSnapshot) == null ? void 0 : _b.call(_a);
+    const effectiveAmountDue = import_decimal.default.max(
+      new import_decimal.default((amountSnapshot == null ? void 0 : amountSnapshot.amountGap) || 0).minus(pendingWalletAmount),
+      0
+    );
+    if (effectiveAmountDue.gt(0.01)) {
+      throw new Error("Wallet 支付尚未覆盖全部待支付金额");
+    }
+    const beforePaymentStatus = (_c = this.store.order.getTempOrder()) == null ? void 0 : _c.payment_status;
+    let submitResult;
+    try {
+      submitResult = await this.submitSalesOrder({
+        smallTicketDataFlag: 1,
+        confirmPendingVoucherPayments: true
+      });
+      if (isRejectedSalesSubmitResult(submitResult)) {
+        throw new Error(getSalesSubmitErrorMessage(submitResult));
+      }
+    } catch (error) {
+      this.store.order.setOrderPayments(beforePayments);
+      const restoredTempOrder = this.store.order.getTempOrder();
+      if (restoredTempOrder && beforePaymentStatus !== void 0) {
+        restoredTempOrder.payment_status = beforePaymentStatus;
+        this.store.order.persistTempOrder();
+      }
+      await this.store.order.recalculateSummary({ createIfMissing: true });
+      throw error;
     }
-    const roundedAmount = roundedQuotient.times(interval).toDecimalPlaces(2);
+    if (this.store.payment) {
+      try {
+        const committed = this.getCommittedWalletAssets();
+        const walletState = this.store.payment.wallet.setCommittedWalletAssets(
+          committed.ids,
+          committed.assets
+        );
+        await this.publishWalletAssetsState(walletState);
+      } catch (error) {
+        this.logWarning("confirmWalletPayment: Wallet committed 状态同步失败", {
+          error: error instanceof Error ? error.message : String(error)
+        });
+      }
+    }
+    const latestAmountSnapshot = (_e = (_d = this.store.order).getOrderAmountSnapshot) == null ? void 0 : _e.call(_d);
     return {
-      originalAmount: amount.toFixed(2),
-      roundedAmount: roundedAmount.toFixed(2),
-      roundingDifference: roundedAmount.minus(amount).toFixed(2)
+      submitResult,
+      payments: this.store.order.getOrderPayments(),
+      isOrderFullyPaid: new import_decimal.default(
+        (latestAmountSnapshot == null ? void 0 : latestAmountSnapshot.amountGap) || 0
+      ).lte(0)
+    };
+  }
+  /**
+   * 购物车现金直付：写入现金记录并等待支付同步完成。
+   * 同步失败会恢复调用前 payments（包含 Wallet pending 状态）。
+   */
+  async payCash(params) {
+    var _a, _b, _c, _d, _e;
+    if (!this.store.order)
+      throw new Error("order 模块未初始化");
+    const amount = Number(params.amount || 0);
+    if (!Number.isFinite(amount) || amount <= 0) {
+      throw new Error("现金支付金额必须大于 0");
+    }
+    const config = await this.getCashPaymentConfig();
+    const paymentMethod = config.paymentMethod;
+    if (!paymentMethod)
+      throw new Error("未找到可用的 CASHMANUAL 支付方式");
+    if (config.amountDue <= 0)
+      throw new Error("当前订单没有待支付金额");
+    const roundingAmount = Number(params.roundingAmount || 0);
+    const effectivePaymentAmount = new import_decimal.default(amount).minus(roundingAmount);
+    if (effectivePaymentAmount.gt(new import_decimal.default(config.amountDue).plus(0.01))) {
+      throw new Error("现金支付金额超过当前待支付金额");
+    }
+    const beforePayments = (0, import_lodash_es.cloneDeep)(this.store.order.getOrderPayments());
+    const beforePaymentStatus = (_a = this.store.order.getTempOrder()) == null ? void 0 : _a.payment_status;
+    const uniquePaymentNumber = (0, import_utils.createUuidV4)();
+    const paymentTimestamp = (0, import_dayjs.default)().format("YYYY-MM-DD HH:mm:ss");
+    const actualPaidAmount = Number(params.actualPaidAmount ?? amount);
+    const changeAmount = Number(params.changeAmount || 0);
+    if (!Number.isFinite(actualPaidAmount) || actualPaidAmount + 0.01 < amount) {
+      throw new Error("顾客实收现金不能小于支付金额");
+    }
+    (_e = (_d = (_c = (_b = this.window) == null ? void 0 : _b.interaction) == null ? void 0 : _c.utils) == null ? void 0 : _d.postMessageToApp) == null ? void 0 : _e.call(_d, {
+      module: "till",
+      key: "open_till",
+      data: { type: "cash" }
+    });
+    const payments = this.store.order.addOrderPayment({
+      amount: amount.toFixed(2),
+      code: paymentMethod.code,
+      custom_payment_id: paymentMethod.id,
+      name: paymentMethod.name,
+      custom_payment_type: paymentMethod.type,
+      voucher_id: 0,
+      rounding_amount: roundingAmount.toFixed(2),
+      metadata: {
+        unique_payment_number: uniquePaymentNumber,
+        actual_paid_amount: Number.isFinite(actualPaidAmount) ? actualPaidAmount : amount,
+        change_given_amount: Number.isFinite(changeAmount) ? changeAmount : 0
+      },
+      payment_time: paymentTimestamp,
+      created_at: paymentTimestamp
+    });
+    const payment = payments.find(
+      (item) => {
+        var _a2;
+        return ((_a2 = item == null ? void 0 : item.metadata) == null ? void 0 : _a2.unique_payment_number) === uniquePaymentNumber;
+      }
+    );
+    try {
+      const syncResult = await this.syncPaymentsToOrder({
+        payments,
+        submitWhenPaid: true,
+        smallTicketDataFlag: 1,
+        confirmPendingVoucherPayments: true
+      });
+      if (this.store.payment) {
+        const committed = this.getCommittedWalletAssets();
+        const walletState = this.store.payment.wallet.setCommittedWalletAssets(
+          committed.ids,
+          committed.assets
+        );
+        await this.publishWalletAssetsState(walletState);
+      }
+      return {
+        payment: payment || {},
+        payments: this.store.order.getOrderPayments(),
+        syncResult,
+        isOrderFullyPaid: syncResult.isOrderFullyPaid
+      };
+    } catch (error) {
+      this.store.order.setOrderPayments(beforePayments);
+      const restoredTempOrder = this.store.order.getTempOrder();
+      if (restoredTempOrder && beforePaymentStatus !== void 0) {
+        restoredTempOrder.payment_status = beforePaymentStatus;
+        this.store.order.persistTempOrder();
+      }
+      await this.store.order.recalculateSummary({ createIfMissing: true });
+      throw error;
+    }
+  }
+  /**
+   * 提交一次已由支付设备确认成功的非 Wallet 支付。
+   *
+   * 与 addOrderPayment 不同，本入口不会启动后台 fire-and-forget 同步；调用方会等待
+   * 本次 payment、当前 pending Wallet 以及订单提交共同完成。任何同步失败都会恢复
+   * 调用前的 payments 与 payment_status，便于 UI 安全解锁并重试。
+   */
+  async commitPaymentMethodPayment(params) {
+    var _a, _b, _c, _d;
+    if (!this.store.order)
+      throw new Error("order 模块未初始化");
+    const amount = Number(params.amount || 0);
+    if (!Number.isFinite(amount) || amount <= 0) {
+      throw new Error("支付金额必须大于 0");
+    }
+    let paymentMethods = this.getPaymentMethods();
+    const findPaymentMethod = () => {
+      const methodCode = String(params.paymentMethodCode || "").toUpperCase();
+      return paymentMethods.find((method) => {
+        const idMatched = params.paymentMethodId !== void 0 && String(method.id) === String(params.paymentMethodId);
+        const codeMatched = Boolean(methodCode) && String(method.code || "").toUpperCase() === methodCode;
+        return (idMatched || codeMatched) && method.enabled !== false && method.enable !== false;
+      });
     };
+    let paymentMethod = findPaymentMethod();
+    if (!paymentMethod) {
+      paymentMethods = await this.getPaymentMethodsAsync();
+      paymentMethod = findPaymentMethod();
+    }
+    if (!paymentMethod) {
+      throw new Error(
+        `未找到可用的支付方式：${params.paymentMethodCode || params.paymentMethodId || ""}`
+      );
+    }
+    const amountSnapshot = (_b = (_a = this.store.order).getOrderAmountSnapshot) == null ? void 0 : _b.call(_a);
+    const pendingWalletAmount = this.getPendingWalletPaymentAmount();
+    const amountDue = import_decimal.default.max(
+      new import_decimal.default((amountSnapshot == null ? void 0 : amountSnapshot.amountGap) || 0).minus(pendingWalletAmount),
+      0
+    );
+    if (amountDue.lte(0))
+      throw new Error("当前订单没有待支付金额");
+    if (new import_decimal.default(amount).gt(amountDue.plus(0.01))) {
+      throw new Error("支付金额超过当前待支付金额");
+    }
+    const beforePayments = (0, import_lodash_es.cloneDeep)(this.store.order.getOrderPayments());
+    const beforePaymentStatus = (_c = this.store.order.getTempOrder()) == null ? void 0 : _c.payment_status;
+    const paymentTimestamp = (0, import_dayjs.default)().format("YYYY-MM-DD HH:mm:ss");
+    const metadata = {
+      ...params.metadata || {},
+      unique_payment_number: ((_d = params.metadata) == null ? void 0 : _d.unique_payment_number) || (0, import_utils.createUuidV4)()
+    };
+    const serviceCharge = params.serviceCharge ? {
+      amount: String(params.serviceCharge.amount || 0),
+      percentage: String(params.serviceCharge.percentage || 0)
+    } : void 0;
+    const serviceFee = serviceCharge ? new import_decimal.default(params.originAmount ?? amount).times(serviceCharge.percentage || 0).plus(serviceCharge.amount || 0).toDecimalPlaces(2).toFixed(2) : void 0;
+    const payments = this.store.order.addOrderPayment({
+      ...params.paymentData || {},
+      amount: amount.toFixed(2),
+      ...params.originAmount !== void 0 ? { origin_amount: Number(params.originAmount).toFixed(2) } : {},
+      code: paymentMethod.code,
+      custom_payment_id: paymentMethod.id,
+      name: paymentMethod.name,
+      custom_payment_type: paymentMethod.type,
+      voucher_id: 0,
+      ...serviceCharge ? { service_charge: serviceCharge } : {},
+      ...serviceFee !== void 0 ? { service_fee: serviceFee } : {},
+      metadata,
+      payment_time: paymentTimestamp,
+      created_at: paymentTimestamp
+    });
+    const payment = payments.find(
+      (item) => {
+        var _a2;
+        return ((_a2 = item == null ? void 0 : item.metadata) == null ? void 0 : _a2.unique_payment_number) === metadata.unique_payment_number;
+      }
+    );
+    try {
+      const syncResult = await this.syncPaymentsToOrder({
+        payments,
+        submitWhenPaid: true,
+        smallTicketDataFlag: 1,
+        confirmPendingVoucherPayments: true
+      });
+      if (this.store.payment) {
+        const committed = this.getCommittedWalletAssets();
+        const walletState = this.store.payment.wallet.setCommittedWalletAssets(
+          committed.ids,
+          committed.assets
+        );
+        await this.publishWalletAssetsState(walletState);
+      }
+      return {
+        payment: payment || {},
+        payments: this.store.order.getOrderPayments(),
+        syncResult,
+        isOrderFullyPaid: syncResult.isOrderFullyPaid
+      };
+    } catch (error) {
+      this.store.order.setOrderPayments(beforePayments);
+      const restoredTempOrder = this.store.order.getTempOrder();
+      if (restoredTempOrder && beforePaymentStatus !== void 0) {
+        restoredTempOrder.payment_status = beforePaymentStatus;
+        this.store.order.persistTempOrder();
+      }
+      await this.store.order.recalculateSummary({ createIfMissing: true });
+      throw error;
+    }
+  }
+  /**
+   * 按当前店铺的现金舍入配置计算金额，供现金支付 UI 使用。
+   *
+   * 舍入开关取自 CASHMANUAL 支付方式；舍入规则取自
+   * otherParams.order_rounding_setting，金额算法统一由 PaymentModule 维护。
+   */
+  async roundAmount(params) {
+    var _a, _b, _c;
+    const amount = params.amount;
+    const cashManualPayment = this.paymentMethodsCache.find(
+      (paymentMethod) => paymentMethod.code === "CASHMANUAL"
+    );
+    if (!((_a = cashManualPayment == null ? void 0 : cashManualPayment.metadata) == null ? void 0 : _a.order_rounding_switch)) {
+      return {
+        originalAmount: amount.toString(),
+        roundedAmount: amount.toString(),
+        roundingDifference: "0.00"
+      };
+    }
+    if (!this.payment) {
+      throw new Error("payment 模块未初始化");
+    }
+    return this.payment.roundAmountAsync(
+      amount,
+      (_b = this.otherParams.order_rounding_setting) == null ? void 0 : _b.interval,
+      (_c = this.otherParams.order_rounding_setting) == null ? void 0 : _c.type
+    );
   }
   /**
    * 发送支付链接。