@pisell/pisellos 1.0.142 → 1.0.143

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

@@ -1,4 +1,10 @@
 import { Product, Voucher } from './type';
+/** 订单商品数量 */
+export declare const getProductQuantity: (product: any) => any;
+/**
+ * 订单商品行唯一键，用于 maxPassesPerItem 按行、按件配额（同 SPU 不同规格视为不同行）。
+ */
+export declare function resolveWalletPassLineKey(product: any, indexInOrder: number): string;
 export declare const getApplicableProductIds: (voucher: Voucher) => number[] | null;
 /**
  * 优惠券处理函数
@@ -64,12 +70,6 @@ export declare const getBundleItemDiscountDifference: (bundleItem: any) => numbe
  * @returns 子商品总价格（不含舍入余数）
  */
 export declare const getBundleItemPrice: (bundleItem: any, parentQuantity: number, isDeductTaxAndFee: boolean) => number;
-/**
- * 获取商品数量
- * @param product 商品
- * @returns 商品数量
- */
-export declare const getProductQuantity: (product: any) => any;
 export declare const getBundleItemIsOriginalPrice: (item: any) => boolean;
 export declare const getBundleItemIsMarkupPrice: (item: any) => boolean;
 export declare const getBundleItemIsDiscountPrice: (item: any) => boolean;

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

@@ -42,10 +42,72 @@ __export(utils_exports, {
   getProductQuantity: () => getProductQuantity,
   getTaxAndFeeRoundingRemainder: () => getTaxAndFeeRoundingRemainder,
   processVouchers: () => processVouchers,
-  recalculateVouchers: () => recalculateVouchers
+  recalculateVouchers: () => recalculateVouchers,
+  resolveWalletPassLineKey: () => resolveWalletPassLineKey
 });
 module.exports = __toCommonJS(utils_exports);
 var import_decimal = __toESM(require("decimal.js"));
+var getProductQuantity = (product) => {
+  return product.quantity || product.product_quantity || 1;
+};
+function resolveWalletPassLineKey(product, indexInOrder) {
+  const m = (product == null ? void 0 : product.metadata) || {};
+  const u1 = m.product_unique;
+  if (u1 != null && String(u1).length > 0)
+    return String(u1);
+  const u2 = m.unique_identification_number;
+  if (u2 != null && String(u2).length > 0)
+    return String(u2);
+  if ((product == null ? void 0 : product.id) != null && String(product.id).length > 0)
+    return `order_item:${product.id}`;
+  if ((product == null ? void 0 : product.product_unique_string) != null && String(product.product_unique_string).length > 0) {
+    return String(product.product_unique_string);
+  }
+  return `order_line_${indexInOrder}`;
+}
+function getExpandedOrderLineQuantity(p) {
+  if ((p == null ? void 0 : p._orderLineQuantity) != null && p._orderLineQuantity > 0)
+    return p._orderLineQuantity;
+  return getProductQuantity(p);
+}
+function getMaxPassSlotsForExpandedLine(maxPassesPerItem, p) {
+  if (maxPassesPerItem <= 0)
+    return Infinity;
+  return maxPassesPerItem * getExpandedOrderLineQuantity(p);
+}
+function computePassSlotsIncrement(deductAmount, deductQty, maxPassesPerItem, orderLineQuantity, currentUsage) {
+  if (maxPassesPerItem <= 0 || !deductAmount.greaterThan(0))
+    return 0;
+  const cap = maxPassesPerItem * orderLineQuantity;
+  const room = Math.max(0, cap - currentUsage);
+  if (room <= 0)
+    return 0;
+  const raw = Math.max(1, Math.ceil(Number(deductQty)) || 1);
+  return Math.min(raw, room);
+}
+function applyMaxPassUsageIncrements(usageMap, walletPassProductId, maxPassesPerItem, deductionDetails) {
+  deductionDetails.forEach((detail) => {
+    var _a;
+    const lineKey = detail.lineKey;
+    if (!lineKey || maxPassesPerItem <= 0)
+      return;
+    const orderLineQty = detail.orderLineQuantity != null && detail.orderLineQuantity > 0 ? detail.orderLineQuantity : 1;
+    const cur = ((_a = usageMap.get(walletPassProductId)) == null ? void 0 : _a.get(lineKey)) || 0;
+    const inc = computePassSlotsIncrement(
+      new import_decimal.default(detail.deductAmount),
+      detail.deductQuantity,
+      maxPassesPerItem,
+      orderLineQty,
+      cur
+    );
+    if (inc <= 0)
+      return;
+    if (!usageMap.has(walletPassProductId))
+      usageMap.set(walletPassProductId, /* @__PURE__ */ new Map());
+    const inner = usageMap.get(walletPassProductId);
+    inner.set(lineKey, cur + inc);
+  });
+}
 var getRecommendedAmount = (voucher) => {
   console.log("voucher312", voucher);
   const { config, recommended_usage_amount, recommended_pure_product_usage_amount } = voucher;
@@ -90,23 +152,19 @@ function processVouchers(applicableVouchers, orderTotalAmount, products) {
   console.log(products, "products123");
   const productsCopy = expandProductsWithBundleItems(products, true);
   let remainingOrderAmount = new import_decimal.default(orderTotalAmount);
-  const getItemPassUsage = (usageMap, walletPassProductId, orderItemProductId) => {
+  const getItemPassUsage = (usageMap, walletPassProductId, lineKey) => {
     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);
+    return ((_a = usageMap.get(walletPassProductId)) == null ? void 0 : _a.get(lineKey)) || 0;
   };
   const filterByMaxPassesPerItem = (products2, usageMap, walletPassProductId, maxPassesPerItem) => {
     if (maxPassesPerItem <= 0)
       return products2;
-    return products2.filter(
-      (p) => getItemPassUsage(usageMap, walletPassProductId, p.product_id) < maxPassesPerItem
-    );
+    return products2.filter((p) => {
+      const lineKey = p._walletPassLineKey;
+      if (!lineKey)
+        return true;
+      return getItemPassUsage(usageMap, walletPassProductId, lineKey) < getMaxPassSlotsForExpandedLine(maxPassesPerItem, p);
+    });
   };
   const calculateAvailableMaxAmount = (voucher, productsData, itemPassUsage) => {
     const { config } = voucher;
@@ -150,14 +208,16 @@ function processVouchers(applicableVouchers, orderTotalAmount, products) {
       }
     } else {
       const maxProduct = applicableProducts.reduce(
-        (max, p) => p[amountField].greaterThan(max[amountField]) ? p : max
-      );
-      const currentAvailableQty = Math.ceil(maxProduct[amountField].dividedBy(maxProduct[unitPriceField]).toNumber());
-      const deductQty = applicableProductLimit > 0 ? Math.min(currentAvailableQty, applicableProductLimit) : currentAvailableQty;
-      finalApplicableAmount = import_decimal.default.min(
-        maxProduct[unitPriceField].times(deductQty),
-        maxProduct[amountField]
+        (max, p) => p[unitPriceField].greaterThan(max[unitPriceField]) ? p : max
       );
+      if (maxPassesPerItem > 0) {
+        finalApplicableAmount = import_decimal.default.min(
+          maxProduct[unitPriceField].times(maxPassesPerItem),
+          maxProduct[amountField]
+        );
+      } else {
+        finalApplicableAmount = maxProduct[amountField];
+      }
     }
     return import_decimal.default.min(baseAmount, finalApplicableAmount, remainingOrderAmount);
   };
@@ -184,7 +244,12 @@ function processVouchers(applicableVouchers, orderTotalAmount, products) {
     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);
+      const availableAfterPassLimit = getApplicableProducts(voucher, productsData).filter((p) => p[amountField].greaterThan(0)).filter((p) => {
+        const lineKey = p._walletPassLineKey;
+        if (!lineKey)
+          return true;
+        return getItemPassUsage(itemPassUsage, product_id, lineKey) < getMaxPassSlotsForExpandedLine(maxPassesPerItem, p);
+      });
       if (availableAfterPassLimit.length === 0) {
         return { isAvailable: false, reasonCode: "max_passes_per_item_reached" };
       }
@@ -267,14 +332,16 @@ function processVouchers(applicableVouchers, orderTotalAmount, products) {
       }
     } else {
       const maxProduct = applicableProducts.reduce(
-        (max, p) => p[amountField].greaterThan(max[amountField]) ? p : max
-      );
-      const currentAvailableQty = Math.ceil(maxProduct[amountField].dividedBy(maxProduct[unitPriceField]).toNumber());
-      const deductQty = applicableProductLimit > 0 ? Math.min(currentAvailableQty, applicableProductLimit) : currentAvailableQty;
-      calculatedAvailableMaxAmount = import_decimal.default.min(
-        maxProduct[unitPriceField].times(deductQty),
-        maxProduct[amountField]
+        (max, p) => p[unitPriceField].greaterThan(max[unitPriceField]) ? p : max
       );
+      if (maxPassesPerItem > 0) {
+        calculatedAvailableMaxAmount = import_decimal.default.min(
+          maxProduct[unitPriceField].times(maxPassesPerItem),
+          maxProduct[amountField]
+        );
+      } else {
+        calculatedAvailableMaxAmount = maxProduct[amountField];
+      }
     }
     const availableMaxAmount = import_decimal.default.min(
       baseAmount,
@@ -310,6 +377,8 @@ function processVouchers(applicableVouchers, orderTotalAmount, products) {
           product_id: product.product_id,
           parent_product_id: product.parent_product_id || null,
           is_bundle_item: product.is_bundle_item || false,
+          lineKey: product._walletPassLineKey,
+          orderLineQuantity: getExpandedOrderLineQuantity(product),
           deductAmount: actualDeductAmount.toNumber(),
           // 转换为数字
           deductQuantity: actualDeductQty
@@ -318,14 +387,15 @@ function processVouchers(applicableVouchers, orderTotalAmount, products) {
       }
     } else {
       const targetProduct = applicableProducts.reduce(
-        (max, p) => p[amountField].greaterThan(max[amountField]) ? p : max
-      );
-      const currentAvailableQty = Math.ceil(targetProduct[amountField].dividedBy(targetProduct[unitPriceField]).toNumber());
-      const availableQty = applicableProductLimit > 0 ? Math.min(currentAvailableQty, applicableProductLimit) : currentAvailableQty;
-      const maxDeductForProduct = import_decimal.default.min(
-        targetProduct[unitPriceField].times(availableQty),
-        targetProduct[amountField]
+        (max, p) => p[unitPriceField].greaterThan(max[unitPriceField]) ? p : max
       );
+      let maxDeductForProduct = targetProduct[amountField];
+      if (maxPassesPerItem > 0) {
+        maxDeductForProduct = import_decimal.default.min(
+          targetProduct[unitPriceField].times(maxPassesPerItem),
+          targetProduct[amountField]
+        );
+      }
       const actualDeductAmount = import_decimal.default.min(deductionLeft, maxDeductForProduct);
       const actualDeductQty = Math.ceil(actualDeductAmount.dividedBy(targetProduct[unitPriceField]).toNumber());
       targetProduct[amountField] = targetProduct[amountField].minus(actualDeductAmount);
@@ -334,19 +404,17 @@ function processVouchers(applicableVouchers, orderTotalAmount, products) {
         product_id: targetProduct.product_id,
         parent_product_id: targetProduct.parent_product_id || null,
         is_bundle_item: targetProduct.is_bundle_item || false,
+        lineKey: targetProduct._walletPassLineKey,
+        orderLineQuantity: getExpandedOrderLineQuantity(targetProduct),
         deductAmount: actualDeductAmount.toNumber(),
-        // 转换为数字
         deductQuantity: actualDeductQty
-        // 抵扣涉及的数量（用于记录）
       });
     }
     const totalDeducted = maxDeduction.minus(deductionLeft);
     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);
-      });
+      applyMaxPassUsageIncrements(itemPassUsageMap, product_id, maxPassesPerItem, deductionDetails);
       recommendedVouchers.push({
         ...voucher,
         actualDeduction: totalDeducted.toNumber(),
@@ -389,23 +457,19 @@ function recalculateVouchers(allVouchers, selectedVouchers, orderTotalAmount, pr
   let remainingOrderAmount = new import_decimal.default(orderTotalAmount);
   const selectedWithDetails = [];
   const itemPassUsageMap = /* @__PURE__ */ new Map();
-  const getItemPassUsage = (walletPassProductId, orderItemProductId) => {
+  const getItemPassUsageRecalc = (walletPassProductId, lineKey) => {
     var _a;
-    return ((_a = itemPassUsageMap.get(walletPassProductId)) == null ? void 0 : _a.get(orderItemProductId)) || 0;
+    return ((_a = itemPassUsageMap.get(walletPassProductId)) == null ? void 0 : _a.get(lineKey)) || 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) => {
+  const filterByMaxPassesPerItemRecalc = (products2, walletPassProductId, maxPassesPerItem) => {
     if (maxPassesPerItem <= 0)
       return products2;
-    return products2.filter(
-      (p) => getItemPassUsage(walletPassProductId, p.product_id) < maxPassesPerItem
-    );
+    return products2.filter((p) => {
+      const lineKey = p._walletPassLineKey;
+      if (!lineKey)
+        return true;
+      return getItemPassUsageRecalc(walletPassProductId, lineKey) < getMaxPassSlotsForExpandedLine(maxPassesPerItem, p);
+    });
   };
   selectedVouchers.forEach((selectedVoucher) => {
     const { config, id } = selectedVoucher;
@@ -416,7 +480,7 @@ function recalculateVouchers(allVouchers, selectedVouchers, orderTotalAmount, pr
       selectedVoucher,
       productsForCalc
     ).filter((p) => p[amountField].greaterThan(0));
-    applicableProducts = filterByMaxPassesPerItem(applicableProducts, selectedVoucher.product_id, maxPassesPerItem);
+    applicableProducts = filterByMaxPassesPerItemRecalc(applicableProducts, selectedVoucher.product_id, maxPassesPerItem);
     if (applicableProducts.length === 0) {
       selectedWithDetails.push({
         ...selectedVoucher,
@@ -459,6 +523,8 @@ function recalculateVouchers(allVouchers, selectedVouchers, orderTotalAmount, pr
           product_id: product.product_id,
           parent_product_id: product.parent_product_id || null,
           is_bundle_item: product.is_bundle_item || false,
+          lineKey: product._walletPassLineKey,
+          orderLineQuantity: getExpandedOrderLineQuantity(product),
           deductAmount: actualDeductAmount.toNumber(),
           // 转换为数字
           deductQuantity: actualDeductQty
@@ -467,14 +533,15 @@ function recalculateVouchers(allVouchers, selectedVouchers, orderTotalAmount, pr
       }
     } else {
       const targetProduct = applicableProducts.reduce(
-        (max, p) => p[amountField].greaterThan(max[amountField]) ? p : max
-      );
-      const currentAvailableQty = Math.ceil(targetProduct[amountField].dividedBy(targetProduct[unitPriceField]).toNumber());
-      const availableQty = applicableProductLimit > 0 ? Math.min(currentAvailableQty, applicableProductLimit) : currentAvailableQty;
-      const maxDeductForProduct = import_decimal.default.min(
-        targetProduct[unitPriceField].times(availableQty),
-        targetProduct[amountField]
+        (max, p) => p[unitPriceField].greaterThan(max[unitPriceField]) ? p : max
       );
+      let maxDeductForProduct = targetProduct[amountField];
+      if (maxPassesPerItem > 0) {
+        maxDeductForProduct = import_decimal.default.min(
+          targetProduct[unitPriceField].times(maxPassesPerItem),
+          targetProduct[amountField]
+        );
+      }
       const actualDeductAmount = import_decimal.default.min(deductionLeft, maxDeductForProduct);
       const actualDeductQty = Math.ceil(actualDeductAmount.dividedBy(targetProduct[unitPriceField]).toNumber());
       targetProduct[amountField] = targetProduct[amountField].minus(actualDeductAmount);
@@ -483,17 +550,15 @@ function recalculateVouchers(allVouchers, selectedVouchers, orderTotalAmount, pr
         product_id: targetProduct.product_id,
         parent_product_id: targetProduct.parent_product_id || null,
         is_bundle_item: targetProduct.is_bundle_item || false,
+        lineKey: targetProduct._walletPassLineKey,
+        orderLineQuantity: getExpandedOrderLineQuantity(targetProduct),
         deductAmount: actualDeductAmount.toNumber(),
-        // 转换为数字
         deductQuantity: actualDeductQty
-        // 抵扣涉及的数量（用于记录）
       });
     }
     const totalDeducted = maxDeduction.minus(deductionLeft);
     remainingOrderAmount = remainingOrderAmount.minus(totalDeducted);
-    deductionDetails.forEach((detail) => {
-      incrementItemPassUsage(selectedVoucher.product_id, detail.product_id);
-    });
+    applyMaxPassUsageIncrements(itemPassUsageMap, selectedVoucher.product_id, maxPassesPerItem, deductionDetails);
     selectedWithDetails.push({
       ...selectedVoucher,
       actualDeduction: totalDeducted.toNumber(),
@@ -543,7 +608,7 @@ function recalculateVouchers(allVouchers, selectedVouchers, orderTotalAmount, pr
           voucher,
           productsForCalc
         ).filter((p) => p[amountField].greaterThan(0));
-        applicableProducts = filterByMaxPassesPerItem(applicableProducts, product_id, maxPassesPerItem);
+        applicableProducts = filterByMaxPassesPerItemRecalc(applicableProducts, product_id, maxPassesPerItem);
         if (applicableProducts.length === 0) {
           isAvailable = false;
           reasonCode = "not_meet_the_required_conditions";
@@ -576,14 +641,16 @@ function recalculateVouchers(allVouchers, selectedVouchers, orderTotalAmount, pr
             }
           } else {
             const maxProduct = applicableProducts.reduce(
-              (max, p) => p[amountField].greaterThan(max[amountField]) ? p : max
-            );
-            const currentAvailableQty = Math.ceil(maxProduct[amountField].dividedBy(maxProduct[unitPriceField]).toNumber());
-            const deductQty = applicableProductLimit > 0 ? Math.min(currentAvailableQty, applicableProductLimit) : currentAvailableQty;
-            calculatedMaxAmount = import_decimal.default.min(
-              maxProduct[unitPriceField].times(deductQty),
-              maxProduct[amountField]
+              (max, p) => p[unitPriceField].greaterThan(max[unitPriceField]) ? p : max
             );
+            if (maxPassesPerItem > 0) {
+              calculatedMaxAmount = import_decimal.default.min(
+                maxProduct[unitPriceField].times(maxPassesPerItem),
+                maxProduct[amountField]
+              );
+            } else {
+              calculatedMaxAmount = maxProduct[amountField];
+            }
           }
           calculatedMaxAmount = import_decimal.default.min(
             baseAmount,
@@ -627,7 +694,7 @@ var getProductDiscountDifference = (product) => {
   return new import_decimal.default(((_a = product == null ? void 0 : product.metadata) == null ? void 0 : _a.product_discount_difference) || 0).toNumber();
 };
 var getMainProductPrice = (product, isDeductTaxAndFee) => {
-  var _a, _b, _c;
+  var _a, _b, _c, _d, _e;
   let mainProductPrice = new import_decimal.default((product == null ? void 0 : product.main_product_selling_price) || ((_a = product.metadata) == null ? void 0 : _a.main_product_selling_price) || 0);
   for (let bundleItem of (product == null ? void 0 : product.product_bundle) || []) {
     if (getBundleItemIsMarkupOrDiscountPrice(bundleItem)) {
@@ -635,11 +702,11 @@ var getMainProductPrice = (product, isDeductTaxAndFee) => {
       mainProductPrice = mainProductPrice.add(bundleItemPrice.times(bundleItem.num));
     }
   }
-  let taxFee = new import_decimal.default((product == null ? void 0 : product.tax_fee) || ((_b = product == null ? void 0 : product.metadata) == null ? void 0 : _b.main_product_attached_bundle_tax_fee) || 0);
+  let taxFee = new import_decimal.default((product == null ? void 0 : product.tax_fee) || ((_b = product == null ? void 0 : product.metadata) == null ? void 0 : _b.main_product_attached_bundle_tax_fee) || 0).add(((_c = product == null ? void 0 : product.metadata) == null ? void 0 : _c.tax_fee_rounding_remainder) || 0);
   if (product.is_price_include_tax === 1) {
     taxFee = new import_decimal.default(0);
   }
-  const surchargeFee = new import_decimal.default(((_c = product == null ? void 0 : product.metadata) == null ? void 0 : _c.main_product_attached_bundle_surcharge_fee) || 0);
+  const surchargeFee = new import_decimal.default(((_d = product == null ? void 0 : product.metadata) == null ? void 0 : _d.main_product_attached_bundle_surcharge_fee) || 0).add(((_e = product == null ? void 0 : product.metadata) == null ? void 0 : _e.surcharge_rounding_remainder) || 0);
   const taxAndFeeTotal = taxFee.add(surchargeFee);
   if (isDeductTaxAndFee) {
     mainProductPrice = mainProductPrice.add(taxAndFeeTotal);
@@ -678,8 +745,9 @@ var getBundleItemPrice = (bundleItem, parentQuantity, isDeductTaxAndFee) => {
 };
 var expandProductsWithBundleItems = (products, deductTaxAndFee) => {
   const expandedProducts = [];
-  products.forEach((product) => {
+  products.forEach((product, indexInOrder) => {
     const productQuantity = getProductQuantity(product);
+    const parentLineKey = resolveWalletPassLineKey(product, indexInOrder);
     const unitPriceWithTax = getMainProductPrice(product, true);
     const unitPricePure = getMainProductPrice(product, false);
     const roundingRemainderWithTax = getTaxAndFeeRoundingRemainder(product, true);
@@ -688,6 +756,8 @@ var expandProductsWithBundleItems = (products, deductTaxAndFee) => {
       ...product,
       is_bundle_item: false,
       parent_product_id: null,
+      _walletPassLineKey: parentLineKey,
+      _orderLineQuantity: productQuantity,
       // 单价（用于按 quantity 计算抵扣）
       unitPriceWithTax: new import_decimal.default(unitPriceWithTax),
       unitPricePure: new import_decimal.default(unitPricePure),
@@ -702,6 +772,7 @@ var expandProductsWithBundleItems = (products, deductTaxAndFee) => {
       product.product_bundle.forEach((bundleItem) => {
         if (getBundleItemIsOriginalPrice(bundleItem)) {
           const bundleQuantity = bundleItem.num * productQuantity;
+          const bundleLineKey = `${parentLineKey}#bundle:${bundleItem.bundle_id}:${bundleItem.bundle_product_id}`;
           const bundleUnitPriceWithTax = new import_decimal.default(getBundleItemPrice(bundleItem, 1, true)).dividedBy(bundleItem.num);
           const bundleUnitPricePure = new import_decimal.default(getBundleItemPrice(bundleItem, 1, false)).dividedBy(bundleItem.num);
           const bundleRoundingRemainder = getBundleItemTaxAndFeeRoundingRemainder(bundleItem, true);
@@ -714,6 +785,8 @@ var expandProductsWithBundleItems = (products, deductTaxAndFee) => {
             parent_product_id: product.product_id,
             quantity: bundleQuantity,
             // 子商品数量 * 主商品数量
+            _walletPassLineKey: bundleLineKey,
+            _orderLineQuantity: bundleQuantity,
             // 单价（用于按 quantity 计算抵扣）
             unitPriceWithTax: bundleUnitPriceWithTax,
             unitPricePure: bundleUnitPricePure,
@@ -730,9 +803,6 @@ var expandProductsWithBundleItems = (products, deductTaxAndFee) => {
   });
   return expandedProducts;
 };
-var getProductQuantity = (product) => {
-  return product.quantity || product.product_quantity || 1;
-};
 var getBundleItemIsOriginalPrice = (item) => {
   return (item == null ? void 0 : item.price_type) === "markup" && (item == null ? void 0 : item.price_type_ext) === "product_price";
 };
@@ -760,5 +830,6 @@ var getBundleItemIsMarkupOrDiscountPrice = (item) => {
   getProductQuantity,
   getTaxAndFeeRoundingRemainder,
   processVouchers,
-  recalculateVouchers
+  recalculateVouchers,
+  resolveWalletPassLineKey
 });

package/lib/model/strategy/engine.d.ts

@@ -0,0 +1,119 @@
+import { StrategyConfig, RuntimeContext, EvaluationResult, EngineOptions, OperatorHandler } from './type';
+/**
+ * 策略模型 - 核心实现
+ *
+ * 完全业务无关的通用策略引擎
+ * 支持条件评估、动作匹配、结果返回
+ */
+/**
+ * 策略引擎
+ *
+ * 核心职责：
+ * 1. 递归评估条件组
+ * 2. 收集满足条件的 actionIds
+ * 3. 根据 actionIds 获取 ActionEffect 对象
+ * 4. 按 priority 排序返回
+ */
+export declare class StrategyEngine {
+    private options;
+    private operatorHandlers;
+    constructor(options?: EngineOptions);
+    /**
+     * 评估策略
+     */
+    evaluate(config: StrategyConfig, context: RuntimeContext): EvaluationResult;
+    /**
+     * 递归评估条件组
+     *
+     * @param group 条件组
+     * @param context 运行时上下文
+     * @returns 评估结果对象，包含条件是否满足、收集到的 actionIds、以及失败的原子规则信息
+     */
+    private evaluateConditionGroup;
+    /**
+     * 评估条件组的逻辑运算（带失败规则收集）
+     *
+     * 失败规则收集策略：
+     * - `and`：返回第一个失败的原子规则（嵌套 group 递归取其首个失败原子规则）
+     * - `or`：所有分支失败时，聚合每个分支的失败规则
+     * - `not`：被取反规则实际通过时，记录该规则
+     */
+    private evaluateGroupLogicDetailed;
+    /**
+     * 评估单个规则（带失败规则收集）
+     */
+    private evaluateRuleDetailed;
+    /**
+     * 评估原子规则（不收集失败信息，仅返回布尔结果）
+     */
+    private evaluateAtomicRule;
+    /**
+     * 构建失败规则信息
+     */
+    private buildFailedRuleInfo;
+    /**
+     * 评估代码模式条件
+     */
+    private evaluateCodeCondition;
+    /**
+     * 评估运算符模式条件
+     */
+    private evaluateOperatorCondition;
+    /**
+     * 获取字段值
+     */
+    private getFieldValue;
+    /**
+     * 评估内置运算符
+     */
+    private evaluateBuiltInOperator;
+    /**
+     * 根据 actionIds 获取 ActionEffect 对象
+     */
+    private getActionsByIds;
+    /**
+     * 按 priority 排序（降序）
+     */
+    private sortActionsByPriority;
+    /**
+     * 判断是否为条件组
+     */
+    private isConditionGroup;
+    /**
+     * 验证配置
+     */
+    private validateConfig;
+    /**
+     * 初始化内置运算符处理器
+     */
+    private initializeBuiltInOperators;
+    /**
+     * 评估商品匹配运算符
+     *
+     * 匹配规则：
+     * - 首先匹配 product_id
+     * - 如果配置的 product_variant_id = 0，只需要 product_id 匹配（表示任意变体）
+     * - 如果配置的 product_variant_id != 0，还需要 product_variant_id 精确匹配
+     *
+     * @param fieldValue 实际商品 { product_id: number, product_variant_id: number }
+     * @param configValue 配置的商品列表 Array<{ product_id: number, product_variant_id: number }>
+     * @returns 是否匹配
+     */
+    private evaluateProductMatch;
+    /**
+     * 注册自定义运算符
+     */
+    registerOperator(operator: string, handler: OperatorHandler): void;
+    /**
+     * 获取调试信息
+     */
+    getDebugInfo(): Record<string, any>;
+}
+/**
+ * 创建策略引擎实例
+ */
+export declare function createStrategyEngine(options?: EngineOptions): StrategyEngine;
+/**
+ * 快速评估（使用默认引擎配置）
+ */
+export declare function evaluate(config: StrategyConfig, context: RuntimeContext): EvaluationResult;