@pisell/pisellos 0.10.15 → 0.10.17

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

@@ -1,42 +1,15 @@
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+"use strict";
 
-// src/model/strategy/adapter/walletPass/evaluator.ts
-var evaluator_exports = {};
-__export(evaluator_exports, {
-  WalletPassEvaluator: () => WalletPassEvaluator
+Object.defineProperty(exports, "__esModule", {
+  value: true
 });
-module.exports = __toCommonJS(evaluator_exports);
-var import__ = require("../../index");
-var import_utils = require("./utils");
-var import_locales = require("./locales");
-var import_decimal = __toESM(require("decimal.js"));
-var defaultStrategyMetadataCustom = {
+exports.WalletPassEvaluator = void 0;
+var _index = require("../../index");
+var _utils = require("./utils");
+var _locales = require("./locales");
+var _decimal = _interopRequireDefault(require("decimal.js"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+const defaultStrategyMetadataCustom = {
   maxDeductionAmount: 99999,
   maxUsagePerOrder: 0,
   allowCrossProduct: true,
@@ -45,34 +18,54 @@ var defaultStrategyMetadataCustom = {
   maxPassesPerItem: 0,
   deductOptionPrice: false
 };
-var FIELD_REASON_CODE_MAP = {
-  orderTotalAmount: "order_total_amount_not_enough",
-  applicableProductTotalAmount: "applicable_product_total_amount_not_enough",
-  applicableProductCount: "applicable_product_count_not_enough"
+
+/**
+ * 条件 field → reasonCode 映射
+ * 用于将策略引擎返回的 failedField 转换为本地化文案 key
+ */
+const FIELD_REASON_CODE_MAP = {
+  orderTotalAmount: 'order_total_amount_not_enough',
+  applicableProductTotalAmount: 'applicable_product_total_amount_not_enough',
+  applicableProductCount: 'applicable_product_count_not_enough'
 };
-var AMOUNT_FIELDS = /* @__PURE__ */ new Set([
-  "orderTotalAmount",
-  "applicableProductTotalAmount"
-]);
-function formatReason(template, value, currency = "") {
-  if (!template)
-    return template;
-  const v = value === void 0 || value === null ? "" : String(value);
-  const c = currency === void 0 || currency === null ? "" : String(currency);
+
+/**
+ * 金额类型 field 集合（需要在文案前拼货币符号）
+ */
+const AMOUNT_FIELDS = new Set(['orderTotalAmount', 'applicableProductTotalAmount']);
+
+/**
+ * 用阈值与货币符号替换文案中的占位符
+ * 支持占位符：{value} / ${value} / {currency}
+ */
+function formatReason(template, value, currency = '') {
+  if (!template) return template;
+  const v = value === undefined || value === null ? '' : String(value);
+  const c = currency === undefined || currency === null ? '' : String(currency);
+  // 注意：必须先替换 value，再替换 currency
+  // 否则 currency 注入的 "$" 会被后续的 /\$\{value\}/ 正则误吞
+  // 使用函数作为替换参数，避免替换串中的 "$" 被 String.prototype.replace
+  // 当作特殊序列（如 $$ -> $、$& 等）处理
   return template.replace(/\$\{value\}/g, () => v).replace(/\{value\}/g, () => v).replace(/\{currency\}/g, () => c);
 }
-var WalletPassEvaluator = class {
+
+/**
+ * Wallet Pass 评估器
+ * 用于评估哪些 voucher 可以在当前订单中使用
+ */
+class WalletPassEvaluator {
+  engine;
+  strategyConfigs = [];
+  locale = 'en';
+  otherParams = {};
   constructor() {
-    this.strategyConfigs = [];
-    this.locale = "en";
-    this.otherParams = {};
-    this.engine = new import__.StrategyEngine({
+    this.engine = new _index.StrategyEngine({
       debug: false,
       enableTrace: false
     });
   }
   setStrategyConfigs(strategyConfigs) {
-    const newStrategyConfigs = strategyConfigs.filter((item) => item.metadata.type === "wallet_pass");
+    const newStrategyConfigs = strategyConfigs.filter(item => item.metadata.type === 'wallet_pass');
     this.strategyConfigs = newStrategyConfigs;
   }
   getStrategyConfigs() {
@@ -85,9 +78,9 @@ var WalletPassEvaluator = class {
     this.otherParams = otherParams;
   }
   getText(key) {
-    var _a, _b;
-    return (_b = (_a = import_locales.locales) == null ? void 0 : _a[this.locale]) == null ? void 0 : _b[key];
+    return _locales.locales?.[this.locale]?.[key];
   }
+
   /**
    * 搜索券的格式
    * @param input 输入
@@ -95,20 +88,19 @@ var WalletPassEvaluator = class {
    */
   searchVoucherFormat(input) {
     const results = this.evaluate(input);
-    return results.map((item) => {
-      var _a, _b;
+    return results.map(item => {
       if (item.isApplicable) {
         return {
           ...item.voucher,
           config: {
-            ...(_a = item == null ? void 0 : item.strategyResult) == null ? void 0 : _a.config.metadata.custom
+            ...item?.strategyResult?.config.metadata.custom
           }
         };
       } else {
         return {
           ...item.voucher,
           config: {
-            ...(_b = item == null ? void 0 : item.strategyResult) == null ? void 0 : _b.config.metadata.custom
+            ...item?.strategyResult?.config.metadata.custom
           },
           _unified_available_status: 0,
           reason: item.reason,
@@ -117,20 +109,28 @@ var WalletPassEvaluator = class {
       }
     });
   }
+
   /**
    * 评估可用的 vouchers
    */
   evaluate(input) {
-    var _a, _b, _c, _d, _e, _f, _g;
-    const { orderTotalAmount, products, vouchers, strategyConfigs } = input;
-    const productIds = products.map((p) => p.product_id);
+    const {
+      orderTotalAmount,
+      products,
+      vouchers,
+      strategyConfigs
+    } = input;
+
+    // 提取订单中的商品ID
+    const productIds = products.map(p => p.product_id);
     const results = [];
+
+    // 遍历每个 voucher 进行评估
     for (const voucher of vouchers) {
-      const applicableStrategies = this.findApplicableStrategies(
-        voucher,
-        strategyConfigs || this.strategyConfigs
-      );
+      // 查找适用此 voucher 的策略配置
+      const applicableStrategies = this.findApplicableStrategies(voucher, strategyConfigs || this.strategyConfigs);
       if (applicableStrategies.length === 0) {
+        // 没有匹配的策略 默认可用
         results.push({
           voucher,
           isApplicable: true,
@@ -138,8 +138,8 @@ var WalletPassEvaluator = class {
           maxDeduction: 0,
           deductTaxAndFee: true,
           applicableProductIds: [],
-          reason: "",
-          reasonCode: "",
+          reason: '',
+          reasonCode: '',
           strategyResult: {
             config: {
               metadata: {
@@ -152,13 +152,20 @@ var WalletPassEvaluator = class {
         });
         continue;
       }
+
+      // 对每个策略进行评估（取第一个匹配的策略）
       const strategy = applicableStrategies[0];
-      const applicableProductIds = (0, import_utils.getApplicableProductIds)(voucher);
-      const { applicableTotal, applicableCount } = this.calculateApplicableProducts(
-        products,
-        applicableProductIds,
-        ((_b = (_a = strategy == null ? void 0 : strategy.metadata) == null ? void 0 : _a.custom) == null ? void 0 : _b.deductTaxAndFee) ?? true
-      );
+
+      // 从 voucher 中获取适用商品ID
+      const applicableProductIds = (0, _utils.getApplicableProductIds)(voucher);
+
+      // 计算适用商品的总金额和数量
+      const {
+        applicableTotal,
+        applicableCount
+      } = this.calculateApplicableProducts(products, applicableProductIds, strategy?.metadata?.custom?.deductTaxAndFee ?? true);
+
+      // 准备运行时上下文
       const context = {
         entities: {
           voucher,
@@ -169,7 +176,7 @@ var WalletPassEvaluator = class {
           }
         },
         attributes: {
-          orderTotalAmount,
+          orderTotalAmount: orderTotalAmount,
           applicableProductTotalAmount: applicableTotal,
           applicableProductCount: applicableCount,
           voucherProductId: voucher.product_id,
@@ -179,7 +186,11 @@ var WalletPassEvaluator = class {
           timestamp: Date.now()
         }
       };
+
+      // 执行策略评估
       const evaluationResult = this.engine.evaluate(strategy, context);
+
+      // 从策略配置中获取业务配置
       const businessConfig = strategy.metadata.custom || {};
       const maxDeduction = businessConfig.maxDeductionAmount || 0;
       const canUseCount = businessConfig.maxUsagePerOrder || 0;
@@ -195,26 +206,29 @@ var WalletPassEvaluator = class {
           strategyResult: evaluationResult
         });
       } else {
-        let reasonCode = "not_meet_the_required_conditions";
-        let thresholdValue = void 0;
-        const failedField = (_c = evaluationResult.matched) == null ? void 0 : _c.failedField;
-        const failedRule = (_e = (_d = evaluationResult.matched) == null ? void 0 : _d.failedRules) == null ? void 0 : _e[0];
+        // 优先根据失败的 field 映射到具体的 reasonCode（更精确的失败原因）
+        let reasonCode = 'not_meet_the_required_conditions';
+        let thresholdValue = undefined;
+        const failedField = evaluationResult.matched?.failedField;
+        const failedRule = evaluationResult.matched?.failedRules?.[0];
         if (failedField && FIELD_REASON_CODE_MAP[failedField]) {
           reasonCode = FIELD_REASON_CODE_MAP[failedField];
-          thresholdValue = failedRule == null ? void 0 : failedRule.value;
+          thresholdValue = failedRule?.value;
         } else if (evaluationResult.code) {
+          // 兜底：保留原有 code → reasonCode 映射
           const codeMapping = {
-            INSUFFICIENT_AMOUNT: "not_meet_the_required_conditions",
-            USAGE_LIMIT_EXCEEDED: "usage_limit_reached",
-            CHANNEL_NOT_ALLOWED: "not_available_for_this_channel",
-            ORDER_TYPE_NOT_ALLOWED: "not_valid_for_this_order_type",
-            DEDUCTION_LIMIT_EXCEEDED: "exceeds_the_maximum_deduction_limit"
+            INSUFFICIENT_AMOUNT: 'not_meet_the_required_conditions',
+            USAGE_LIMIT_EXCEEDED: 'usage_limit_reached',
+            CHANNEL_NOT_ALLOWED: 'not_available_for_this_channel',
+            ORDER_TYPE_NOT_ALLOWED: 'not_valid_for_this_order_type',
+            DEDUCTION_LIMIT_EXCEEDED: 'exceeds_the_maximum_deduction_limit'
           };
-          reasonCode = codeMapping[evaluationResult.code] || "not_meet_the_required_conditions";
+          reasonCode = codeMapping[evaluationResult.code] || 'not_meet_the_required_conditions';
         }
         const rawText = this.getText(reasonCode);
-        const currency = failedField && AMOUNT_FIELDS.has(failedField) ? ((_g = (_f = this.otherParams) == null ? void 0 : _f.getData) == null ? void 0 : _g.call(_f, "shop_symbol")) || "" : "";
-        const reason = thresholdValue !== void 0 ? formatReason(rawText, thresholdValue, currency) : rawText;
+        // 金额类型字段：从 otherParams.getData 取货币符号；非金额或取不到则留空
+        const currency = failedField && AMOUNT_FIELDS.has(failedField) ? this.otherParams?.getData?.('shop_symbol') || '' : '';
+        const reason = thresholdValue !== undefined ? formatReason(rawText, thresholdValue, currency) : rawText;
         results.push({
           voucher,
           isApplicable: false,
@@ -223,36 +237,47 @@ var WalletPassEvaluator = class {
           deductTaxAndFee: false,
           applicableProductIds: [],
           reason,
-          reasonCode,
+          reasonCode: reasonCode,
           strategyResult: evaluationResult
         });
       }
     }
     return results;
   }
+
   /** 检查代金券/折扣卡是否可用 并返回config */
   checkVoucherAvailability(input) {
-    var _a, _b, _c, _d, _e;
-    const { orderTotalAmount, products, vouchers } = input;
+    const {
+      orderTotalAmount,
+      products,
+      vouchers
+    } = input;
     const results = this.evaluate(input);
-    const isAvailable = ((_a = results[0]) == null ? void 0 : _a.isApplicable) || false;
+    const isAvailable = results[0]?.isApplicable || false;
     return {
       isAvailable,
       config: {
-        ...(_e = (_d = (_c = (_b = results[0]) == null ? void 0 : _b.strategyResult) == null ? void 0 : _c.config) == null ? void 0 : _d.metadata) == null ? void 0 : _e.custom
+        ...results[0]?.strategyResult?.config?.metadata?.custom
       }
     };
   }
+
   /**
    * 获取推荐券
    * @param input 输入
    * @returns 返回推荐券列表
    */
   getRecommendedVouchers(input) {
-    const { orderTotalAmount, products, vouchers } = input;
+    const {
+      orderTotalAmount,
+      products,
+      vouchers
+    } = input;
+    // 基于后端返回的状态不可用券
     const noApplicableVoucher = [];
+    // 基于后端返回的状态可用券
     const applicableVoucher = [];
-    vouchers.forEach((voucher) => {
+    vouchers.forEach(voucher => {
       if (voucher.unified_available_status === 1) {
         applicableVoucher.push(voucher);
       } else {
@@ -264,17 +289,17 @@ var WalletPassEvaluator = class {
       vouchers: applicableVoucher
     });
     const newVouchers = [];
-    results.forEach((item) => {
-      var _a, _b, _c;
+    results.forEach(item => {
       if (item.isApplicable) {
         newVouchers.push({
           ...item.voucher,
           config: {
             ...defaultStrategyMetadataCustom,
-            ...((_c = (_b = (_a = item == null ? void 0 : item.strategyResult) == null ? void 0 : _a.config) == null ? void 0 : _b.metadata) == null ? void 0 : _c.custom) || {}
+            ...(item?.strategyResult?.config?.metadata?.custom || {})
           }
         });
       } else {
+        // 不可用的券，添加原因信息
         noApplicableVoucher.push({
           ...item.voucher,
           _unified_available_status: 0,
@@ -283,13 +308,12 @@ var WalletPassEvaluator = class {
         });
       }
     });
-    const { recommended, transformList } = this.processVouchers(
-      newVouchers,
-      orderTotalAmount,
-      products
-    );
+    const {
+      recommended,
+      transformList
+    } = this.processVouchers(newVouchers, orderTotalAmount, products);
     const recommendedAmount = recommended.reduce((sum, item) => {
-      return new import_decimal.default(sum).add(item._available_max_amount || 0).toNumber();
+      return new _decimal.default(sum).add(item._available_max_amount || 0).toNumber();
     }, 0);
     return {
       // 推荐券总金额
@@ -311,6 +335,7 @@ var WalletPassEvaluator = class {
     }
     return voucher;
   }
+
   /**
    * 优惠券处理函数
    * @param applicableVouchers 可用的券列表
@@ -319,16 +344,13 @@ var WalletPassEvaluator = class {
    * @returns 返回推荐券列表和全部列表，每个券包含 _available_max_amount 和 _unified_available_status
    */
   processVouchers(vouchers, orderTotalAmount, products) {
-    const result = (0, import_utils.processVouchers)(vouchers, orderTotalAmount, products);
+    const result = (0, _utils.processVouchers)(vouchers, orderTotalAmount, products);
     return {
-      recommended: result.recommended.map(
-        (item) => this.enhanceWithReason(item)
-      ),
-      transformList: result.transformList.map(
-        (item) => this.enhanceWithReason(item)
-      )
+      recommended: result.recommended.map(item => this.enhanceWithReason(item)),
+      transformList: result.transformList.map(item => this.enhanceWithReason(item))
     };
   }
+
   /**
    * 重新计算优惠券状态（基于已选券的增量计算）
    * @param allVouchers 所有原始券列表
@@ -338,47 +360,44 @@ var WalletPassEvaluator = class {
    * @returns 返回更新后的所有券列表和已选券的详细抵扣信息
    */
   recalculateVouchers(allVouchers, selectedVouchers, orderTotalAmount, products) {
-    const result = (0, import_utils.recalculateVouchers)(
-      allVouchers,
-      selectedVouchers,
-      orderTotalAmount,
-      products
-    );
+    const result = (0, _utils.recalculateVouchers)(allVouchers, selectedVouchers, orderTotalAmount, products);
     return {
-      allWithUpdatedStatus: result.allWithUpdatedStatus.map(
-        (item) => this.enhanceWithReason(item)
-      ),
-      selectedWithDetails: result.selectedWithDetails.map(
-        (item) => this.enhanceWithReason(item)
-      )
+      allWithUpdatedStatus: result.allWithUpdatedStatus.map(item => this.enhanceWithReason(item)),
+      selectedWithDetails: result.selectedWithDetails.map(item => this.enhanceWithReason(item))
     };
   }
+
   /**
    * 查找适用于指定 voucher 的策略配置
    */
   findApplicableStrategies(voucher, strategyConfigs) {
-    return strategyConfigs.filter((config) => {
+    return strategyConfigs.filter(config => {
+      // 检查策略的 conditions 中是否包含匹配此 voucher 的规则
       return this.checkVoucherInStrategy(voucher.product_id, config);
     });
   }
+
   /**
    * 检查策略中是否包含指定的 voucher ID
    */
   checkVoucherInStrategy(voucherProductId, config) {
     const rules = config.conditions.rules;
     for (const rule of rules) {
-      if ("operator" in rule && "rules" in rule) {
+      // 如果是条件组，递归检查
+      if ('operator' in rule && 'rules' in rule) {
         if (this.checkVoucherInConditionGroup(voucherProductId, rule)) {
           return true;
         }
       } else {
+        // 检查是否是 voucherProductId 字段的规则
         const conditionRule = rule;
-        if (conditionRule.field === "voucherProductId" && conditionRule.operator === "in" && Array.isArray(conditionRule.value)) {
+        if (conditionRule.field === 'voucherProductId' && conditionRule.operator === 'in' && Array.isArray(conditionRule.value)) {
           if (conditionRule.value.includes(voucherProductId)) {
             return true;
           }
         }
-        if (conditionRule.field === "voucherProductId" && (conditionRule.operator === "=" || conditionRule.operator === "==")) {
+        // 支持等于判断
+        if (conditionRule.field === 'voucherProductId' && (conditionRule.operator === '=' || conditionRule.operator === '==')) {
           if (conditionRule.value === voucherProductId) {
             return true;
           }
@@ -387,22 +406,23 @@ var WalletPassEvaluator = class {
     }
     return false;
   }
+
   /**
    * 递归检查条件组中是否包含 voucher ID
    */
   checkVoucherInConditionGroup(voucherProductId, group) {
     for (const rule of group.rules) {
-      if ("operator" in rule && "rules" in rule) {
+      if ('operator' in rule && 'rules' in rule) {
         if (this.checkVoucherInConditionGroup(voucherProductId, rule)) {
           return true;
         }
       } else {
-        if (rule.field === "voucherProductId" && rule.operator === "in" && Array.isArray(rule.value)) {
+        if (rule.field === 'voucherProductId' && rule.operator === 'in' && Array.isArray(rule.value)) {
           if (rule.value.includes(voucherProductId)) {
             return true;
           }
         }
-        if (rule.field === "voucherProductId" && (rule.operator === "=" || rule.operator === "==")) {
+        if (rule.field === 'voucherProductId' && (rule.operator === '=' || rule.operator === '==')) {
           if (rule.value === voucherProductId) {
             return true;
           }
@@ -411,43 +431,53 @@ var WalletPassEvaluator = class {
     }
     return false;
   }
+
   /**
    * 计算适用商品的总金额和数量
    */
   calculateApplicableProducts(products, applicableProductIds, deductTaxAndFee) {
     let total = 0;
     let count = 0;
+
+    // 如果为空数组，不适用任何商品
     if (applicableProductIds !== null && applicableProductIds.length === 0) {
-      return { applicableTotal: 0, applicableCount: 0 };
+      return {
+        applicableTotal: 0,
+        applicableCount: 0
+      };
     }
-    products.forEach((product) => {
-      const productQuantity = (0, import_utils.getProductQuantity)(product);
+    products.forEach(product => {
+      const productQuantity = (0, _utils.getProductQuantity)(product);
+
+      // 检查主商品是否适用
       const isMainProductApplicable = applicableProductIds === null || applicableProductIds.includes(product.product_id);
       if (isMainProductApplicable) {
-        total += (0, import_utils.getMainProductPrice)(product, deductTaxAndFee) * productQuantity;
+        // 计算主商品价格（包含加减价子商品）
+        total += (0, _utils.getMainProductPrice)(product, deductTaxAndFee) * productQuantity;
         count += productQuantity;
       }
+
+      // 检查原价子商品（需要单独判断适用性）
       if (product.product_bundle && product.product_bundle.length > 0) {
-        product.product_bundle.forEach((bundleItem) => {
-          if ((0, import_utils.getBundleItemIsOriginalPrice)(bundleItem)) {
+        product.product_bundle.forEach(bundleItem => {
+          // 只处理原价子商品，加减价子商品已包含在主商品价格中
+          if ((0, _utils.getBundleItemIsOriginalPrice)(bundleItem)) {
+            // 检查子商品是否适用
             const isBundleItemApplicable = applicableProductIds === null || applicableProductIds.includes(bundleItem.bundle_product_id);
             if (isBundleItemApplicable) {
+              // 计算原价子商品价格
               const bundleItemQuantity = bundleItem.num * productQuantity;
-              total += (0, import_utils.getBundleItemPrice)(
-                bundleItem,
-                productQuantity,
-                deductTaxAndFee
-              );
+              total += (0, _utils.getBundleItemPrice)(bundleItem, productQuantity, deductTaxAndFee);
               count += bundleItemQuantity;
             }
           }
         });
       }
     });
-    return { applicableTotal: total, applicableCount: count };
+    return {
+      applicableTotal: total,
+      applicableCount: count
+    };
   }
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  WalletPassEvaluator
-});
+}
+exports.WalletPassEvaluator = WalletPassEvaluator;