@pisell/pisellos 2.2.76 → 2.2.78

package/dist/model/strategy/adapter/promotion/evaluator.js

@@ -908,11 +908,74 @@ export var PromotionEvaluator = /*#__PURE__*/function () {
           // 更新已处理数量
           processedQuantityMap.set(_key, _processedQty + _availableQty);
         }
+
+        // 8. 尾差调整：确保促销商品的 finalPrice × quantity 之和精确等于 groupPrice × groupCount
       } catch (err) {
         _iterator13.e(err);
       } finally {
         _iterator13.f();
       }
+      if (groupCount > 0) {
+        var expectedPromoTotal = new Decimal(groupPrice).mul(groupCount);
+        var promoItems = result.filter(function (p) {
+          return p.inPromotion;
+        });
+        var actualPromoTotal = new Decimal(0);
+        var _iterator14 = _createForOfIteratorHelper(promoItems),
+          _step14;
+        try {
+          for (_iterator14.s(); !(_step14 = _iterator14.n()).done;) {
+            var _p = _step14.value;
+            actualPromoTotal = actualPromoTotal.plus(new Decimal(_p.finalPrice).mul(_p.quantity));
+          }
+        } catch (err) {
+          _iterator14.e(err);
+        } finally {
+          _iterator14.f();
+        }
+        var roundingDiff = actualPromoTotal.minus(expectedPromoTotal);
+        if (!roundingDiff.eq(0)) {
+          // 优先找 quantity=1 的促销商品调整（差额直接加减到单价上）
+          var adjustTarget = promoItems.find(function (p) {
+            return p.quantity === 1;
+          });
+          if (adjustTarget) {
+            adjustTarget.finalPrice = this.formatPrice(new Decimal(adjustTarget.finalPrice).minus(roundingDiff));
+          } else if (promoItems.length > 0) {
+            // 没有 quantity=1 的促销商品，从最后一个促销商品中拆出1件做尾差调整
+            var lastPromo = promoItems[promoItems.length - 1];
+            var adjustedUnitPrice = this.formatPrice(new Decimal(lastPromo.finalPrice).minus(roundingDiff));
+
+            // 原商品减少1件
+            lastPromo.quantity -= 1;
+            lastPromo.isSplit = true;
+
+            // 拆出1件用调整后的价格
+            result.push(_objectSpread(_objectSpread({}, lastPromo), {}, {
+              id: this.generateRandomId(),
+              originalId: lastPromo.originalId || lastPromo.id,
+              quantity: 1,
+              finalPrice: adjustedUnitPrice,
+              isSplit: true
+            }));
+          }
+
+          // 重新计算 finalAmount
+          finalAmount = new Decimal(0);
+          var _iterator15 = _createForOfIteratorHelper(result),
+            _step15;
+          try {
+            for (_iterator15.s(); !(_step15 = _iterator15.n()).done;) {
+              var p = _step15.value;
+              finalAmount = finalAmount.plus(new Decimal(p.finalPrice).mul(p.quantity));
+            }
+          } catch (err) {
+            _iterator15.e(err);
+          } finally {
+            _iterator15.f();
+          }
+        }
+      }
       return {
         products: result,
         originalAmount: originalAmount.toNumber(),
@@ -947,11 +1010,11 @@ export var PromotionEvaluator = /*#__PURE__*/function () {
       // 对于 bundle 子商品匹配，促销数量 = 主商品数量 × bundle子商品数量
       var totalPromoQty = 0;
       var productInfoMap = new Map();
-      var _iterator14 = _createForOfIteratorHelper(groupProducts),
-        _step14;
+      var _iterator16 = _createForOfIteratorHelper(groupProducts),
+        _step16;
       try {
-        for (_iterator14.s(); !(_step14 = _iterator14.n()).done;) {
-          var product = _step14.value;
+        for (_iterator16.s(); !(_step16 = _iterator16.n()).done;) {
+          var product = _step16.value;
           var key = this.getProductKey(product);
           var processedQty = processedQuantityMap.get(key) || 0;
           var availableQty = product.quantity - processedQty;
@@ -977,18 +1040,18 @@ export var PromotionEvaluator = /*#__PURE__*/function () {
 
         // 2. 判断是否满足促销条件
       } catch (err) {
-        _iterator14.e(err);
+        _iterator16.e(err);
       } finally {
-        _iterator14.f();
+        _iterator16.f();
       }
       var isFulfilled = totalPromoQty >= buyQuantity;
 
       // 3. 生成商品结果（第二次遍历）
-      var _iterator15 = _createForOfIteratorHelper(groupProducts),
-        _step15;
+      var _iterator17 = _createForOfIteratorHelper(groupProducts),
+        _step17;
       try {
-        for (_iterator15.s(); !(_step15 = _iterator15.n()).done;) {
-          var _product2 = _step15.value;
+        for (_iterator17.s(); !(_step17 = _iterator17.n()).done;) {
+          var _product2 = _step17.value;
           var _key2 = this.getProductKey(_product2);
           var info = productInfoMap.get(_key2);
           if (!info || info.availableQty <= 0) continue;
@@ -1016,9 +1079,9 @@ export var PromotionEvaluator = /*#__PURE__*/function () {
 
         // 4. 计算赠品数量（使用促销数量）
       } catch (err) {
-        _iterator15.e(err);
+        _iterator17.e(err);
       } finally {
-        _iterator15.f();
+        _iterator17.f();
       }
       var giftCount = 0;
       if (isFulfilled) {
@@ -1047,11 +1110,11 @@ export var PromotionEvaluator = /*#__PURE__*/function () {
     key: "getRemainingProducts",
     value: function getRemainingProducts(allProducts, processedQuantityMap) {
       var result = [];
-      var _iterator16 = _createForOfIteratorHelper(allProducts),
-        _step16;
+      var _iterator18 = _createForOfIteratorHelper(allProducts),
+        _step18;
       try {
-        for (_iterator16.s(); !(_step16 = _iterator16.n()).done;) {
-          var product = _step16.value;
+        for (_iterator18.s(); !(_step18 = _iterator18.n()).done;) {
+          var product = _step18.value;
           var key = this.getProductKey(product);
           var processedQty = processedQuantityMap.get(key) || 0;
           var remainingQty = product.quantity - processedQty;
@@ -1066,9 +1129,9 @@ export var PromotionEvaluator = /*#__PURE__*/function () {
           }
         }
       } catch (err) {
-        _iterator16.e(err);
+        _iterator18.e(err);
       } finally {
-        _iterator16.f();
+        _iterator18.f();
       }
       return result;
     }

package/dist/model/strategy/adapter/walletPass/evaluator.js

@@ -19,7 +19,8 @@ var defaultStrategyMetadataCustom = {
   maxUsagePerOrder: 0,
   allowCrossProduct: true,
   applicableProductLimit: 0,
-  deductTaxAndFee: true
+  deductTaxAndFee: true,
+  maxPassesPerItem: 0
 };
 
 /**

package/dist/model/strategy/adapter/walletPass/locales.js

@@ -3,6 +3,7 @@ export var locales = {
     'not_meet_the_required_conditions': '未达到使用条件',
     'exceeds_the_maximum_deduction_limit': '超出最大抵扣金额限制',
     'usage_limit_reached': '已达到使用次数上限',
+    'max_passes_per_item_reached': '该商品已达到卡券使用上限',
     'not_available_for_this_channel': '当前渠道不可使用',
     'not_valid_for_this_order_type': '当前订单类型不适用'
   },
@@ -10,6 +11,7 @@ export var locales = {
     'not_meet_the_required_conditions': 'Not meet the required conditions.',
     'exceeds_the_maximum_deduction_limit': 'Exceeds the maximum deduction limit.',
     'usage_limit_reached': 'Usage limit reached.',
+    'max_passes_per_item_reached': 'Max passes per item reached.',
     'not_available_for_this_channel': 'Not available for this channel.',
     'not_valid_for_this_order_type': 'Not valid for this order type.'
   },
@@ -17,6 +19,7 @@ export var locales = {
     'not_meet_the_required_conditions': '未達使用條件',
     'exceeds_the_maximum_deduction_limit': '超出最大抵扣金額限制',
     'usage_limit_reached': '已達使用次數上限',
+    'max_passes_per_item_reached': '該商品已達卡券使用上限',
     'not_available_for_this_channel': '當前渠道不可使用',
     'not_valid_for_this_order_type': '當前訂單類型不適用'
   }

package/dist/model/strategy/adapter/walletPass/type.d.ts

@@ -41,6 +41,8 @@ export interface Voucher {
         allowCrossProduct: boolean;
         /** 可用商品数量上限 （仅多商品） 默认为0，表示不限制商品数量。 */
         applicableProductLimit: number;
+        /** 单商品可用卡券上限（同一 Wallet Pass 商品生成的卡券对同一商品行最多抵扣次数）。默认为 0，表示不限制。 */
+        maxPassesPerItem: number;
     };
 }
 /**
@@ -127,6 +129,8 @@ export interface EvaluatorInput {
         allowCrossProduct: boolean;
         /** 可用商品数量上限 （仅多商品） 默认为0，表示不限制商品数量。 */
         applicableProductLimit: number;
+        /** 单商品可用卡券上限（同一 Wallet Pass 商品生成的卡券对同一商品行最多抵扣次数）。默认为 0，表示不限制。 */
+        maxPassesPerItem: number;
     }>[];
 }
 /**

package/dist/model/strategy/adapter/walletPass/utils.js

@@ -118,8 +118,33 @@ export function processVouchers(applicableVouchers, orderTotalAmount, products)
   var productsCopy = expandProductsWithBundleItems(products, true);
   var remainingOrderAmount = new Decimal(orderTotalAmount); // 订单剩余应付金额
 
+  // ========== 辅助工具：maxPassesPerItem（单商品可用卡券上限）追踪 ==========
+  // 获取指定 Wallet Pass 商品对指定订单商品行的已用卡券次数
+  var getItemPassUsage = function getItemPassUsage(usageMap, walletPassProductId, orderItemProductId) {
+    var _usageMap$get;
+    return ((_usageMap$get = usageMap.get(walletPassProductId)) === null || _usageMap$get === void 0 ? void 0 : _usageMap$get.get(orderItemProductId)) || 0;
+  };
+
+  // 更新指定 Wallet Pass 商品对指定订单商品行的已用卡券次数 +1
+  var incrementItemPassUsage = function incrementItemPassUsage(usageMap, walletPassProductId, orderItemProductId) {
+    if (!usageMap.has(walletPassProductId)) {
+      usageMap.set(walletPassProductId, new Map());
+    }
+    var innerMap = usageMap.get(walletPassProductId);
+    innerMap.set(orderItemProductId, (innerMap.get(orderItemProductId) || 0) + 1);
+  };
+
+  // 按 maxPassesPerItem 过滤商品：排除已达到单商品可用卡券上限的商品
+  var filterByMaxPassesPerItem = function filterByMaxPassesPerItem(products, usageMap, walletPassProductId, maxPassesPerItem) {
+    if (maxPassesPerItem <= 0) return products; // 0 = 不限制
+    return products.filter(function (p) {
+      return getItemPassUsage(usageMap, walletPassProductId, p.product_id) < maxPassesPerItem;
+    });
+  };
+  // ================================================================
+
   // 辅助函数：计算单张券的 _available_max_amount
-  var calculateAvailableMaxAmount = function calculateAvailableMaxAmount(voucher, productsData) {
+  var calculateAvailableMaxAmount = function calculateAvailableMaxAmount(voucher, productsData, itemPassUsage) {
     var config = voucher.config;
     var _ref2 = config !== null && config !== void 0 ? config : {},
       _ref2$maxDeductionAmo = _ref2.maxDeductionAmount,
@@ -129,7 +154,9 @@ export function processVouchers(applicableVouchers, orderTotalAmount, products)
       _ref2$applicableProdu = _ref2.applicableProductLimit,
       applicableProductLimit = _ref2$applicableProdu === void 0 ? 0 : _ref2$applicableProdu,
       _ref2$deductTaxAndFee = _ref2.deductTaxAndFee,
-      deductTaxAndFee = _ref2$deductTaxAndFee === void 0 ? true : _ref2$deductTaxAndFee;
+      deductTaxAndFee = _ref2$deductTaxAndFee === void 0 ? true : _ref2$deductTaxAndFee,
+      _ref2$maxPassesPerIte = _ref2.maxPassesPerItem,
+      maxPassesPerItem = _ref2$maxPassesPerIte === void 0 ? 0 : _ref2$maxPassesPerIte;
 
     // 根据 deductTaxAndFee 配置获取推荐金额
     var recommendedAmount = getRecommendedAmount(voucher);
@@ -145,6 +172,11 @@ export function processVouchers(applicableVouchers, orderTotalAmount, products)
     var applicableProducts = getApplicableProducts(voucher, productsData).filter(function (p) {
       return p[amountField].greaterThan(0);
     });
+
+    // 按 maxPassesPerItem 过滤：排除已达到单商品可用卡券上限的商品
+    if (itemPassUsage) {
+      applicableProducts = filterByMaxPassesPerItem(applicableProducts, itemPassUsage, voucher.product_id, maxPassesPerItem);
+    }
     if (applicableProducts.length === 0) {
       return new Decimal(0);
     }
@@ -202,7 +234,7 @@ export function processVouchers(applicableVouchers, orderTotalAmount, products)
   };
 
   // 辅助函数：判断券是否可用，返回可用性和原因代码
-  var isVoucherAvailable = function isVoucherAvailable(voucher, productsData, usedVoucherCounts) {
+  var isVoucherAvailable = function isVoucherAvailable(voucher, productsData, usedVoucherCounts, itemPassUsage) {
     var config = voucher.config,
       id = voucher.id,
       product_id = voucher.product_id;
@@ -245,6 +277,25 @@ export function processVouchers(applicableVouchers, orderTotalAmount, products)
         };
       }
     }
+
+    // 检查 maxPassesPerItem：如果所有适用商品都已达到单商品可用卡券上限，则不可用
+    var maxPassesPerItem = (config === null || config === void 0 ? void 0 : config.maxPassesPerItem) || 0;
+    if (maxPassesPerItem > 0 && itemPassUsage) {
+      var _config$deductTaxAndF3;
+      var deductTaxAndFee = (_config$deductTaxAndF3 = config === null || config === void 0 ? void 0 : config.deductTaxAndFee) !== null && _config$deductTaxAndF3 !== void 0 ? _config$deductTaxAndF3 : true;
+      var amountField = deductTaxAndFee ? 'remainingAmountWithTax' : 'remainingAmountPure';
+      var availableAfterPassLimit = getApplicableProducts(voucher, productsData).filter(function (p) {
+        return p[amountField].greaterThan(0);
+      }).filter(function (p) {
+        return getItemPassUsage(itemPassUsage, product_id, p.product_id) < maxPassesPerItem;
+      });
+      if (availableAfterPassLimit.length === 0) {
+        return {
+          isAvailable: false,
+          reasonCode: 'max_passes_per_item_reached'
+        };
+      }
+    }
     return {
       isAvailable: true
     };
@@ -272,6 +323,8 @@ export function processVouchers(applicableVouchers, orderTotalAmount, products)
   // 重置商品余额追踪（同时维护含税和不含税两个金额池）
   var productsForRecommendation = expandProductsWithBundleItems(products, true);
   remainingOrderAmount = new Decimal(orderTotalAmount);
+  // 追踪推荐阶段每个 Wallet Pass 商品对每个订单商品行的已使用卡券次数
+  var itemPassUsageMap = new Map();
 
   /**
   // 分类券：未跨商品券 vs 跨商品券
@@ -302,7 +355,7 @@ export function processVouchers(applicableVouchers, orderTotalAmount, products)
   // 处理单张券的抵扣
   var applyVoucher = function applyVoucher(voucher) {
     // 检查是否可用
-    var availabilityCheck = isVoucherAvailable(voucher, productsForRecommendation, usedVoucherCounts);
+    var availabilityCheck = isVoucherAvailable(voucher, productsForRecommendation, usedVoucherCounts, itemPassUsageMap);
     if (!availabilityCheck.isAvailable) {
       return false;
     }
@@ -317,7 +370,9 @@ export function processVouchers(applicableVouchers, orderTotalAmount, products)
       _ref3$applicableProdu = _ref3.applicableProductLimit,
       applicableProductLimit = _ref3$applicableProdu === void 0 ? 0 : _ref3$applicableProdu,
       _ref3$deductTaxAndFee = _ref3.deductTaxAndFee,
-      deductTaxAndFee = _ref3$deductTaxAndFee === void 0 ? true : _ref3$deductTaxAndFee;
+      deductTaxAndFee = _ref3$deductTaxAndFee === void 0 ? true : _ref3$deductTaxAndFee,
+      _ref3$maxPassesPerIte = _ref3.maxPassesPerItem,
+      maxPassesPerItem = _ref3$maxPassesPerIte === void 0 ? 0 : _ref3$maxPassesPerIte;
 
     // 根据券的配置选择使用哪个单价字段和金额字段
     var unitPriceField = deductTaxAndFee ? 'unitPriceWithTax' : 'unitPricePure';
@@ -327,6 +382,9 @@ export function processVouchers(applicableVouchers, orderTotalAmount, products)
     var applicableProducts = getApplicableProducts(voucher, productsForRecommendation).filter(function (p) {
       return p[amountField].greaterThan(0);
     });
+
+    // 按 maxPassesPerItem 过滤：排除已达到单商品可用卡券上限的商品
+    applicableProducts = filterByMaxPassesPerItem(applicableProducts, itemPassUsageMap, product_id, maxPassesPerItem);
     if (applicableProducts.length === 0) return false;
 
     // ========== 关键修改：在应用券之前，基于当前剩余金额计算 _available_max_amount ==========
@@ -466,6 +524,11 @@ export function processVouchers(applicableVouchers, orderTotalAmount, products)
       // 更新券使用次数（按 product_id 统计）
       usedVoucherCounts.set(product_id, (usedVoucherCounts.get(product_id) || 0) + 1);
 
+      // 更新 maxPassesPerItem 追踪：记录每个被抵扣的商品行
+      deductionDetails.forEach(function (detail) {
+        incrementItemPassUsage(itemPassUsageMap, product_id, detail.product_id);
+      });
+
       // 添加到推荐列表（包含基于当前剩余金额计算的 available_max_amount）
       recommendedVouchers.push(_objectSpread(_objectSpread({}, voucher), {}, {
         actualDeduction: totalDeducted.toNumber(),
@@ -547,6 +610,27 @@ export function recalculateVouchers(allVouchers, selectedVouchers, orderTotalAmo
   var remainingOrderAmount = new Decimal(orderTotalAmount);
   var selectedWithDetails = [];
 
+  // 追踪每个 Wallet Pass 商品对每个订单商品行的已使用卡券次数
+  // Map<walletPassProductId, Map<orderItemProductId, usedCount>>
+  var itemPassUsageMap = new Map();
+  var getItemPassUsage = function getItemPassUsage(walletPassProductId, orderItemProductId) {
+    var _itemPassUsageMap$get;
+    return ((_itemPassUsageMap$get = itemPassUsageMap.get(walletPassProductId)) === null || _itemPassUsageMap$get === void 0 ? void 0 : _itemPassUsageMap$get.get(orderItemProductId)) || 0;
+  };
+  var incrementItemPassUsage = function incrementItemPassUsage(walletPassProductId, orderItemProductId) {
+    if (!itemPassUsageMap.has(walletPassProductId)) {
+      itemPassUsageMap.set(walletPassProductId, new Map());
+    }
+    var innerMap = itemPassUsageMap.get(walletPassProductId);
+    innerMap.set(orderItemProductId, (innerMap.get(orderItemProductId) || 0) + 1);
+  };
+  var filterByMaxPassesPerItem = function filterByMaxPassesPerItem(products, walletPassProductId, maxPassesPerItem) {
+    if (maxPassesPerItem <= 0) return products; // 0 = 不限制
+    return products.filter(function (p) {
+      return getItemPassUsage(walletPassProductId, p.product_id) < maxPassesPerItem;
+    });
+  };
+
   // 第一步：按顺序应用已选中的券，计算实际抵扣
   selectedVouchers.forEach(function (selectedVoucher) {
     var config = selectedVoucher.config,
@@ -554,8 +638,10 @@ export function recalculateVouchers(allVouchers, selectedVouchers, orderTotalAmo
     var maxDeductionAmount = config.maxDeductionAmount,
       allowCrossProduct = config.allowCrossProduct,
       applicableProductLimit = config.applicableProductLimit,
-      _config$deductTaxAndF3 = config.deductTaxAndFee,
-      deductTaxAndFee = _config$deductTaxAndF3 === void 0 ? true : _config$deductTaxAndF3;
+      _config$deductTaxAndF4 = config.deductTaxAndFee,
+      deductTaxAndFee = _config$deductTaxAndF4 === void 0 ? true : _config$deductTaxAndF4,
+      _config$maxPassesPerI = config.maxPassesPerItem,
+      maxPassesPerItem = _config$maxPassesPerI === void 0 ? 0 : _config$maxPassesPerI;
 
     // 根据券的配置选择使用哪个单价字段和金额字段
     var unitPriceField = deductTaxAndFee ? 'unitPriceWithTax' : 'unitPricePure';
@@ -565,6 +651,9 @@ export function recalculateVouchers(allVouchers, selectedVouchers, orderTotalAmo
     var applicableProducts = getApplicableProducts(selectedVoucher, productsForCalc).filter(function (p) {
       return p[amountField].greaterThan(0);
     });
+
+    // 按 maxPassesPerItem 过滤：排除已达到单商品可用卡券上限的商品
+    applicableProducts = filterByMaxPassesPerItem(applicableProducts, selectedVoucher.product_id, maxPassesPerItem);
     if (applicableProducts.length === 0) {
       // 无适用商品，跳过
       selectedWithDetails.push(_objectSpread(_objectSpread({}, selectedVoucher), {}, {
@@ -658,6 +747,11 @@ export function recalculateVouchers(allVouchers, selectedVouchers, orderTotalAmo
 
     // 更新订单剩余金额
     remainingOrderAmount = remainingOrderAmount.minus(totalDeducted);
+
+    // 更新 maxPassesPerItem 追踪：记录每个被抵扣的商品行
+    deductionDetails.forEach(function (detail) {
+      incrementItemPassUsage(selectedVoucher.product_id, detail.product_id);
+    });
     selectedWithDetails.push(_objectSpread(_objectSpread({}, selectedVoucher), {}, {
       actualDeduction: totalDeducted.toNumber(),
       // 转换为数字
@@ -692,8 +786,10 @@ export function recalculateVouchers(allVouchers, selectedVouchers, orderTotalAmo
     var maxDeductionAmount = config.maxDeductionAmount,
       allowCrossProduct = config.allowCrossProduct,
       applicableProductLimit = config.applicableProductLimit,
-      _config$deductTaxAndF4 = config.deductTaxAndFee,
-      deductTaxAndFee = _config$deductTaxAndF4 === void 0 ? true : _config$deductTaxAndF4;
+      _config$deductTaxAndF5 = config.deductTaxAndFee,
+      deductTaxAndFee = _config$deductTaxAndF5 === void 0 ? true : _config$deductTaxAndF5,
+      _config$maxPassesPerI2 = config.maxPassesPerItem,
+      maxPassesPerItem = _config$maxPassesPerI2 === void 0 ? 0 : _config$maxPassesPerI2;
 
     // 根据券的配置选择使用哪个单价字段和金额字段
     var unitPriceField = deductTaxAndFee ? 'unitPriceWithTax' : 'unitPricePure';
@@ -726,6 +822,9 @@ export function recalculateVouchers(allVouchers, selectedVouchers, orderTotalAmo
         var applicableProducts = getApplicableProducts(voucher, productsForCalc).filter(function (p) {
           return p[amountField].greaterThan(0);
         });
+
+        // 按 maxPassesPerItem 过滤：排除已达到单商品可用卡券上限的商品
+        applicableProducts = filterByMaxPassesPerItem(applicableProducts, product_id, maxPassesPerItem);
         if (applicableProducts.length === 0) {
           isAvailable = false;
           reasonCode = 'not_meet_the_required_conditions';

package/lib/model/strategy/adapter/promotion/evaluator.js

@@ -645,6 +645,46 @@ var PromotionEvaluator = class {
       }
       processedQuantityMap.set(key, processedQty + availableQty);
     }
+    if (groupCount > 0) {
+      const expectedPromoTotal = new import_decimal.default(groupPrice).mul(groupCount);
+      const promoItems = result.filter((p) => p.inPromotion);
+      let actualPromoTotal = new import_decimal.default(0);
+      for (const p of promoItems) {
+        actualPromoTotal = actualPromoTotal.plus(
+          new import_decimal.default(p.finalPrice).mul(p.quantity)
+        );
+      }
+      const roundingDiff = actualPromoTotal.minus(expectedPromoTotal);
+      if (!roundingDiff.eq(0)) {
+        const adjustTarget = promoItems.find((p) => p.quantity === 1);
+        if (adjustTarget) {
+          adjustTarget.finalPrice = this.formatPrice(
+            new import_decimal.default(adjustTarget.finalPrice).minus(roundingDiff)
+          );
+        } else if (promoItems.length > 0) {
+          const lastPromo = promoItems[promoItems.length - 1];
+          const adjustedUnitPrice = this.formatPrice(
+            new import_decimal.default(lastPromo.finalPrice).minus(roundingDiff)
+          );
+          lastPromo.quantity -= 1;
+          lastPromo.isSplit = true;
+          result.push({
+            ...lastPromo,
+            id: this.generateRandomId(),
+            originalId: lastPromo.originalId || lastPromo.id,
+            quantity: 1,
+            finalPrice: adjustedUnitPrice,
+            isSplit: true
+          });
+        }
+        finalAmount = new import_decimal.default(0);
+        for (const p of result) {
+          finalAmount = finalAmount.plus(
+            new import_decimal.default(p.finalPrice).mul(p.quantity)
+          );
+        }
+      }
+    }
     return {
       products: result,
       originalAmount: originalAmount.toNumber(),

package/lib/model/strategy/adapter/walletPass/evaluator.js

@@ -41,7 +41,8 @@ var defaultStrategyMetadataCustom = {
   maxUsagePerOrder: 0,
   allowCrossProduct: true,
   applicableProductLimit: 0,
-  deductTaxAndFee: true
+  deductTaxAndFee: true,
+  maxPassesPerItem: 0
 };
 var WalletPassEvaluator = class {
   constructor() {

package/lib/model/strategy/adapter/walletPass/locales.js

@@ -27,6 +27,7 @@ var locales = {
     "not_meet_the_required_conditions": "未达到使用条件",
     "exceeds_the_maximum_deduction_limit": "超出最大抵扣金额限制",
     "usage_limit_reached": "已达到使用次数上限",
+    "max_passes_per_item_reached": "该商品已达到卡券使用上限",
     "not_available_for_this_channel": "当前渠道不可使用",
     "not_valid_for_this_order_type": "当前订单类型不适用"
   },
@@ -34,6 +35,7 @@ var locales = {
     "not_meet_the_required_conditions": "Not meet the required conditions.",
     "exceeds_the_maximum_deduction_limit": "Exceeds the maximum deduction limit.",
     "usage_limit_reached": "Usage limit reached.",
+    "max_passes_per_item_reached": "Max passes per item reached.",
     "not_available_for_this_channel": "Not available for this channel.",
     "not_valid_for_this_order_type": "Not valid for this order type."
   },
@@ -41,6 +43,7 @@ var locales = {
     "not_meet_the_required_conditions": "未達使用條件",
     "exceeds_the_maximum_deduction_limit": "超出最大抵扣金額限制",
     "usage_limit_reached": "已達使用次數上限",
+    "max_passes_per_item_reached": "該商品已達卡券使用上限",
     "not_available_for_this_channel": "當前渠道不可使用",
     "not_valid_for_this_order_type": "當前訂單類型不適用"
   }

package/lib/model/strategy/adapter/walletPass/type.d.ts

@@ -41,6 +41,8 @@ export interface Voucher {
         allowCrossProduct: boolean;
         /** 可用商品数量上限 （仅多商品） 默认为0，表示不限制商品数量。 */
         applicableProductLimit: number;
+        /** 单商品可用卡券上限（同一 Wallet Pass 商品生成的卡券对同一商品行最多抵扣次数）。默认为 0，表示不限制。 */
+        maxPassesPerItem: number;
     };
 }
 /**
@@ -127,6 +129,8 @@ export interface EvaluatorInput {
         allowCrossProduct: boolean;
         /** 可用商品数量上限 （仅多商品） 默认为0，表示不限制商品数量。 */
         applicableProductLimit: number;
+        /** 单商品可用卡券上限（同一 Wallet Pass 商品生成的卡券对同一商品行最多抵扣次数）。默认为 0，表示不限制。 */
+        maxPassesPerItem: number;
     }>[];
 }
 /**

package/lib/model/strategy/adapter/walletPass/utils.js

@@ -86,9 +86,27 @@ function processVouchers(applicableVouchers, orderTotalAmount, products) {
   console.log(products, "products123");
   const productsCopy = expandProductsWithBundleItems(products, true);
   let remainingOrderAmount = new import_decimal.default(orderTotalAmount);
-  const calculateAvailableMaxAmount = (voucher, productsData) => {
+  const getItemPassUsage = (usageMap, walletPassProductId, orderItemProductId) => {
+    var _a;
+    return ((_a = usageMap.get(walletPassProductId)) == null ? void 0 : _a.get(orderItemProductId)) || 0;
+  };
+  const incrementItemPassUsage = (usageMap, walletPassProductId, orderItemProductId) => {
+    if (!usageMap.has(walletPassProductId)) {
+      usageMap.set(walletPassProductId, /* @__PURE__ */ new Map());
+    }
+    const innerMap = usageMap.get(walletPassProductId);
+    innerMap.set(orderItemProductId, (innerMap.get(orderItemProductId) || 0) + 1);
+  };
+  const filterByMaxPassesPerItem = (products2, usageMap, walletPassProductId, maxPassesPerItem) => {
+    if (maxPassesPerItem <= 0)
+      return products2;
+    return products2.filter(
+      (p) => getItemPassUsage(usageMap, walletPassProductId, p.product_id) < maxPassesPerItem
+    );
+  };
+  const calculateAvailableMaxAmount = (voucher, productsData, itemPassUsage) => {
     const { config } = voucher;
-    const { maxDeductionAmount = 0, allowCrossProduct = true, applicableProductLimit = 0, deductTaxAndFee = true } = config ?? {};
+    const { maxDeductionAmount = 0, allowCrossProduct = true, applicableProductLimit = 0, deductTaxAndFee = true, maxPassesPerItem = 0 } = config ?? {};
     const recommendedAmount = getRecommendedAmount(voucher);
     const baseAmount = import_decimal.default.min(
       new import_decimal.default(recommendedAmount),
@@ -96,7 +114,10 @@ function processVouchers(applicableVouchers, orderTotalAmount, products) {
     );
     const unitPriceField = deductTaxAndFee ? "unitPriceWithTax" : "unitPricePure";
     const amountField = deductTaxAndFee ? "remainingAmountWithTax" : "remainingAmountPure";
-    const applicableProducts = getApplicableProducts(voucher, productsData).filter((p) => p[amountField].greaterThan(0));
+    let applicableProducts = getApplicableProducts(voucher, productsData).filter((p) => p[amountField].greaterThan(0));
+    if (itemPassUsage) {
+      applicableProducts = filterByMaxPassesPerItem(applicableProducts, itemPassUsage, voucher.product_id, maxPassesPerItem);
+    }
     if (applicableProducts.length === 0) {
       return new import_decimal.default(0);
     }
@@ -136,7 +157,7 @@ function processVouchers(applicableVouchers, orderTotalAmount, products) {
     }
     return import_decimal.default.min(baseAmount, finalApplicableAmount, remainingOrderAmount);
   };
-  const isVoucherAvailable = (voucher, productsData, usedVoucherCounts2) => {
+  const isVoucherAvailable = (voucher, productsData, usedVoucherCounts2, itemPassUsage) => {
     const { config, id, product_id } = voucher;
     const recommendedAmount = getRecommendedAmount(voucher);
     if (recommendedAmount <= 0) {
@@ -155,6 +176,15 @@ function processVouchers(applicableVouchers, orderTotalAmount, products) {
         return { isAvailable: false, reasonCode: "usage_limit_reached" };
       }
     }
+    const maxPassesPerItem = (config == null ? void 0 : config.maxPassesPerItem) || 0;
+    if (maxPassesPerItem > 0 && itemPassUsage) {
+      const deductTaxAndFee = (config == null ? void 0 : config.deductTaxAndFee) ?? true;
+      const amountField = deductTaxAndFee ? "remainingAmountWithTax" : "remainingAmountPure";
+      const availableAfterPassLimit = getApplicableProducts(voucher, productsData).filter((p) => p[amountField].greaterThan(0)).filter((p) => getItemPassUsage(itemPassUsage, product_id, p.product_id) < maxPassesPerItem);
+      if (availableAfterPassLimit.length === 0) {
+        return { isAvailable: false, reasonCode: "max_passes_per_item_reached" };
+      }
+    }
     return { isAvailable: true };
   };
   const usedVoucherCountsForAll = /* @__PURE__ */ new Map();
@@ -181,23 +211,26 @@ function processVouchers(applicableVouchers, orderTotalAmount, products) {
   const usedVoucherCounts = /* @__PURE__ */ new Map();
   const productsForRecommendation = expandProductsWithBundleItems(products, true);
   remainingOrderAmount = new import_decimal.default(orderTotalAmount);
+  const itemPassUsageMap = /* @__PURE__ */ new Map();
   const applyVoucher = (voucher) => {
     const availabilityCheck = isVoucherAvailable(
       voucher,
       productsForRecommendation,
-      usedVoucherCounts
+      usedVoucherCounts,
+      itemPassUsageMap
     );
     if (!availabilityCheck.isAvailable) {
       return false;
     }
     const { config, id, product_id } = voucher;
-    const { maxDeductionAmount = 0, allowCrossProduct = true, applicableProductLimit = 0, deductTaxAndFee = true } = config ?? {};
+    const { maxDeductionAmount = 0, allowCrossProduct = true, applicableProductLimit = 0, deductTaxAndFee = true, maxPassesPerItem = 0 } = config ?? {};
     const unitPriceField = deductTaxAndFee ? "unitPriceWithTax" : "unitPricePure";
     const amountField = deductTaxAndFee ? "remainingAmountWithTax" : "remainingAmountPure";
     let applicableProducts = getApplicableProducts(
       voucher,
       productsForRecommendation
     ).filter((p) => p[amountField].greaterThan(0));
+    applicableProducts = filterByMaxPassesPerItem(applicableProducts, itemPassUsageMap, product_id, maxPassesPerItem);
     if (applicableProducts.length === 0)
       return false;
     const usageAmount = typeof voucher.edit_current_amount === "number" ? voucher.edit_current_amount : getRecommendedAmount(voucher);
@@ -307,6 +340,9 @@ function processVouchers(applicableVouchers, orderTotalAmount, products) {
     if (totalDeducted.greaterThan(0)) {
       remainingOrderAmount = remainingOrderAmount.minus(totalDeducted);
       usedVoucherCounts.set(product_id, (usedVoucherCounts.get(product_id) || 0) + 1);
+      deductionDetails.forEach((detail) => {
+        incrementItemPassUsage(itemPassUsageMap, product_id, detail.product_id);
+      });
       recommendedVouchers.push({
         ...voucher,
         actualDeduction: totalDeducted.toNumber(),
@@ -348,15 +384,35 @@ function recalculateVouchers(allVouchers, selectedVouchers, orderTotalAmount, pr
   const productsForCalc = expandProductsWithBundleItems(products, true);
   let remainingOrderAmount = new import_decimal.default(orderTotalAmount);
   const selectedWithDetails = [];
+  const itemPassUsageMap = /* @__PURE__ */ new Map();
+  const getItemPassUsage = (walletPassProductId, orderItemProductId) => {
+    var _a;
+    return ((_a = itemPassUsageMap.get(walletPassProductId)) == null ? void 0 : _a.get(orderItemProductId)) || 0;
+  };
+  const incrementItemPassUsage = (walletPassProductId, orderItemProductId) => {
+    if (!itemPassUsageMap.has(walletPassProductId)) {
+      itemPassUsageMap.set(walletPassProductId, /* @__PURE__ */ new Map());
+    }
+    const innerMap = itemPassUsageMap.get(walletPassProductId);
+    innerMap.set(orderItemProductId, (innerMap.get(orderItemProductId) || 0) + 1);
+  };
+  const filterByMaxPassesPerItem = (products2, walletPassProductId, maxPassesPerItem) => {
+    if (maxPassesPerItem <= 0)
+      return products2;
+    return products2.filter(
+      (p) => getItemPassUsage(walletPassProductId, p.product_id) < maxPassesPerItem
+    );
+  };
   selectedVouchers.forEach((selectedVoucher) => {
     const { config, id } = selectedVoucher;
-    const { maxDeductionAmount, allowCrossProduct, applicableProductLimit, deductTaxAndFee = true } = config;
+    const { maxDeductionAmount, allowCrossProduct, applicableProductLimit, deductTaxAndFee = true, maxPassesPerItem = 0 } = config;
     const unitPriceField = deductTaxAndFee ? "unitPriceWithTax" : "unitPricePure";
     const amountField = deductTaxAndFee ? "remainingAmountWithTax" : "remainingAmountPure";
     let applicableProducts = getApplicableProducts(
       selectedVoucher,
       productsForCalc
     ).filter((p) => p[amountField].greaterThan(0));
+    applicableProducts = filterByMaxPassesPerItem(applicableProducts, selectedVoucher.product_id, maxPassesPerItem);
     if (applicableProducts.length === 0) {
       selectedWithDetails.push({
         ...selectedVoucher,
@@ -431,6 +487,9 @@ function recalculateVouchers(allVouchers, selectedVouchers, orderTotalAmount, pr
     }
     const totalDeducted = maxDeduction.minus(deductionLeft);
     remainingOrderAmount = remainingOrderAmount.minus(totalDeducted);
+    deductionDetails.forEach((detail) => {
+      incrementItemPassUsage(selectedVoucher.product_id, detail.product_id);
+    });
     selectedWithDetails.push({
       ...selectedVoucher,
       actualDeduction: totalDeducted.toNumber(),
@@ -454,7 +513,7 @@ function recalculateVouchers(allVouchers, selectedVouchers, orderTotalAmount, pr
       return selectedDetail || voucher;
     }
     const { config, id, product_id } = voucher;
-    const { maxDeductionAmount, allowCrossProduct, applicableProductLimit, deductTaxAndFee = true } = config;
+    const { maxDeductionAmount, allowCrossProduct, applicableProductLimit, deductTaxAndFee = true, maxPassesPerItem = 0 } = config;
     const unitPriceField = deductTaxAndFee ? "unitPriceWithTax" : "unitPricePure";
     const amountField = deductTaxAndFee ? "remainingAmountWithTax" : "remainingAmountPure";
     const recommendedAmount = getRecommendedAmount(voucher);
@@ -480,6 +539,7 @@ function recalculateVouchers(allVouchers, selectedVouchers, orderTotalAmount, pr
           voucher,
           productsForCalc
         ).filter((p) => p[amountField].greaterThan(0));
+        applicableProducts = filterByMaxPassesPerItem(applicableProducts, product_id, maxPassesPerItem);
         if (applicableProducts.length === 0) {
           isAvailable = false;
           reasonCode = "not_meet_the_required_conditions";

package/package.json

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