@pisell/pisellos 1.0.135 → 1.0.136

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

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

@@ -90,9 +90,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),
@@ -100,7 +118,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);
     }
@@ -140,7 +161,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) {
@@ -159,6 +180,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();
@@ -185,23 +215,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);
@@ -311,6 +344,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(),
@@ -352,15 +388,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,
@@ -435,6 +491,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(),
@@ -458,7 +517,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);
@@ -484,6 +543,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": "1.0.135",
+  "version": "1.0.136",
   "description": "一个可扩展的前端模块化SDK框架，支持插件系统",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",