@pisell/pisellos 2.2.273 → 2.2.275

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");
@@ -348,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;
@@ -619,6 +702,36 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       return null;
     return productId;
   }
+  /**
+  * Change Time / customer reprice 必须沿用商品列表的渠道口径。
+  * SalesSdk Provider 通常将渠道存为 platform，因此不能只读取 otherParams.channel。
+  */
+  getPriceQueryChannel(channel) {
+    var _a, _b, _c;
+    const strategyContext = ((_a = this.otherParams) == null ? void 0 : _a.strategy_context) && typeof this.otherParams.strategy_context === "object" ? this.otherParams.strategy_context : {};
+    const value = channel ?? strategyContext.channel ?? ((_b = this.otherParams) == null ? void 0 : _b.channel) ?? ((_c = this.otherParams) == null ? void 0 : _c.platform);
+    if (value === void 0 || value === null || String(value).trim() === "") {
+      return void 0;
+    }
+    return String(value).trim();
+  }
+  /**
+   * /product/query 的智能定价评估只读取 strategy_context；
+   * application_code 仅作为接口兼容字段，不能替代 channel / business_code。
+   */
+  getPriceQueryStrategyContext(channel) {
+    var _a, _b, _c;
+    const inherited = ((_a = this.otherParams) == null ? void 0 : _a.strategy_context) && typeof this.otherParams.strategy_context === "object" ? this.otherParams.strategy_context : {};
+    const strategyContext = { ...inherited };
+    const resolvedChannel = this.getPriceQueryChannel(channel);
+    const businessCode = strategyContext.business_code ?? ((_b = this.otherParams) == null ? void 0 : _b.businessCode) ?? ((_c = this.otherParams) == null ? void 0 : _c.business_code);
+    if (resolvedChannel)
+      strategyContext.channel = resolvedChannel;
+    if (businessCode !== void 0 && businessCode !== null && String(businessCode).trim() !== "") {
+      strategyContext.business_code = String(businessCode).trim();
+    }
+    return strategyContext;
+  }
   getPriceQuerySchedule(params) {
     const booking = params.booking || {};
     if (typeof booking.start_date === "string" && booking.start_date.trim()) {
@@ -646,13 +759,15 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     };
   }
   async loadProductsForPriceQuery(params) {
-    var _a, _b;
+    var _a;
     const ids = Array.from(new Set(
       params.ids.filter((id) => Number.isFinite(id))
     ));
     const productsById = /* @__PURE__ */ new Map();
     if (!ids.length || !this.request)
       return productsById;
+    const channel = this.getPriceQueryChannel(params.channel);
+    const strategyContext = this.getPriceQueryStrategyContext(channel);
     try {
       const response = await this.request.post("/product/query", {
         ids,
@@ -664,13 +779,14 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
         customer_id: params.customerId,
         schedule_date: params.schedule.schedule_date,
         schedule_datetime: params.schedule.schedule_datetime,
-        application_code: params.channel || ((_a = this.otherParams) == null ? void 0 : _a.channel)
+        application_code: channel,
+        ...Object.keys(strategyContext).length ? { strategy_context: strategyContext } : {}
       }, {
         osServer: true,
         customToast: () => {
         }
       });
-      const list = ((_b = response == null ? void 0 : response.data) == null ? void 0 : _b.list) || (response == null ? void 0 : response.list) || [];
+      const list = ((_a = response == null ? void 0 : response.data) == null ? void 0 : _a.list) || (response == null ? void 0 : response.list) || [];
       if (!Array.isArray(list))
         return productsById;
       list.forEach((item) => {
@@ -993,6 +1109,7 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     this.paymentNumberDevicePrefix = null;
     this.queuedServerOrderChanges = [];
     this.salesDetailLoadSequence += 1;
+    this.walletAssetsRefreshSequence += 1;
     await this.core.effects.emit(`${this.name}:onDestroy`, {});
     super.destroy();
   }
@@ -1107,10 +1224,10 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     const result = ((_a = this.store.order) == null ? void 0 : _a.getTempOrder()) || null;
     return result;
   }
-  async replaceTempOrder(tempOrder) {
+  async replaceTempOrder(tempOrder, options) {
     if (!this.store.order)
       throw new Error("order 模块未初始化");
-    const nextTempOrder = await this.store.order.replaceTempOrder(tempOrder);
+    const nextTempOrder = await this.store.order.replaceTempOrder(tempOrder, options);
     await this.effectsEmit("onTempOrderReplaced", { tempOrder: nextTempOrder });
     return nextTempOrder;
   }
@@ -1209,6 +1326,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 模块支持");
@@ -1217,6 +1335,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();
@@ -1629,6 +1753,7 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       }
       return {
         isAvailable: raw.isAvailable,
+        ...raw.isAccepted !== void 0 ? { isAccepted: raw.isAccepted } : {},
         type: raw.type,
         unavailableReason: raw.unavailableReason,
         scannedDiscountList: raw.scannedDiscountList
@@ -2206,7 +2331,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)
@@ -2267,24 +2401,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: {
@@ -2298,11 +2422,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,
@@ -2313,6 +2455,208 @@ 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();
+  }
+  /** 配置仅影响 Wallet Assets，不改变 Promotion/Voucher 选择流程。 */
+  configureWalletAssetsBehavior(options) {
+    if (!this.store.payment)
+      throw new Error("payment 模块未初始化");
+    this.store.payment.wallet.configureWalletAssetsBehavior(options);
+  }
+  /**
+   * 恢复 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);
+  }
   /**
    * 更新当前订单客户字段。
    *
@@ -2349,29 +2693,349 @@ 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 roundedAmount = roundedQuotient.times(interval).toDecimalPlaces(2);
+    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 {
-      originalAmount: amount.toFixed(2),
-      roundedAmount: roundedAmount.toFixed(2),
-      roundingDifference: roundedAmount.minus(amount).toFixed(2)
+      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;
+    }
+    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 {
+      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, _f;
+    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);
+    const shopWalletPassId = (_b = this.otherParams) == null ? void 0 : _b.shop_wallet_pass_id;
+    if (!Number.isFinite(actualPaidAmount) || actualPaidAmount + 0.01 < amount) {
+      throw new Error("顾客实收现金不能小于支付金额");
+    }
+    (_f = (_e = (_d = (_c = this.window) == null ? void 0 : _c.interaction) == null ? void 0 : _d.utils) == null ? void 0 : _e.postMessageToApp) == null ? void 0 : _f.call(_e, {
+      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,
+        ...shopWalletPassId !== void 0 && shopWalletPassId !== null ? { shop_wallet_pass_id: shopWalletPassId } : {},
+        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
+    );
+  }
   /**
    * 发送支付链接。
    *
@@ -2540,11 +3204,11 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       });
     });
   }
-  async addProductToOrder(product, booking) {
+  async addProductToOrder(product, booking, options) {
     try {
       if (!this.store.order)
         throw new Error("order 模块未初始化");
-      const products = await this.store.order.addProductToOrder(product, booking);
+      const products = await this.store.order.addProductToOrder(product, booking, options);
       return products;
     } catch (error) {
       throw error;
@@ -2620,17 +3284,17 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
    * @example
    * await baseSales.removeProductsFromOrder([identityA, identityB]);
    */
-  async removeProductsFromOrder(identities) {
+  async removeProductsFromOrder(identities, options) {
     try {
       if (!this.store.order)
         throw new Error("order 模块未初始化");
-      return await this.store.order.removeProductsFromOrder(identities);
+      return await this.store.order.removeProductsFromOrder(identities, options);
     } catch (error) {
       throw error;
     }
   }
-  async removeProductFromOrder(identity) {
-    return this.removeProductsFromOrder([identity]);
+  async removeProductFromOrder(identity, options) {
+    return this.removeProductsFromOrder([identity], options);
   }
   // ─── 促销/赠品 透传（迁移自 booking usePromotion） ────────────────
   /**