@pisell/pisellos 0.0.567 → 0.0.569

package/lib/model/strategy/adapter/itemRule/adapter.js

@@ -1,36 +1,27 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+"use strict";
 
-// src/model/strategy/adapter/itemRule/adapter.ts
-var adapter_exports = {};
-__export(adapter_exports, {
-  ItemRuleAdapter: () => ItemRuleAdapter,
-  default: () => adapter_default
+Object.defineProperty(exports, "__esModule", {
+  value: true
 });
-module.exports = __toCommonJS(adapter_exports);
-var import_type = require("./type");
-var ItemRuleAdapter = class {
-  constructor() {
-    this.name = "ItemRuleAdapter";
-    this.version = "1.0.0";
-  }
+exports.default = exports.ItemRuleAdapter = void 0;
+var _type = require("./type");
+/**
+ * ItemRule 适配器
+ *
+ * 将堂食扫码点餐的商品规则业务数据转换为策略引擎格式，
+ * 并将引擎结果转换为数量校验和预填购物车的业务结果。
+ */
+class ItemRuleAdapter {
+  name = 'ItemRuleAdapter';
+  version = '1.0.0';
   prepareContext(businessData) {
-    const { pax, cartItems, serviceType, submissionIndex, custom } = businessData;
+    const {
+      pax,
+      cartItems,
+      serviceType,
+      submissionIndex,
+      custom
+    } = businessData;
     return {
       entities: {
         cartItems,
@@ -38,7 +29,7 @@ var ItemRuleAdapter = class {
         pax
       },
       attributes: {
-        serviceType: serviceType || "",
+        serviceType: serviceType || '',
         totalPax: pax.total,
         adultPax: pax.adult,
         childPax: pax.child,
@@ -56,47 +47,61 @@ var ItemRuleAdapter = class {
     const quantityChecks = [];
     const prefillItems = [];
     if (!result.applicable || !businessData) {
-      return { quantityChecks, prefillItems };
+      return {
+        quantityChecks,
+        prefillItems
+      };
     }
     for (const action of result.matchedActions) {
-      if (action.type === import_type.ITEM_RULE_ACTION_TYPES.QUANTITY_CHECK) {
+      if (action.type === _type.ITEM_RULE_ACTION_TYPES.QUANTITY_CHECK) {
         const checkResult = this.processQuantityCheck(action, businessData);
         if (checkResult) {
           quantityChecks.push(checkResult);
         }
-      } else if (action.type === import_type.ITEM_RULE_ACTION_TYPES.PREFILL_CART) {
+      } else if (action.type === _type.ITEM_RULE_ACTION_TYPES.PREFILL_CART) {
         const items = this.processPrefillCart(action, businessData);
         prefillItems.push(...items);
       }
     }
-    return { quantityChecks, prefillItems };
+    return {
+      quantityChecks,
+      prefillItems
+    };
   }
   formatConfig(result, businessData) {
-    return { result, businessData };
+    return {
+      result,
+      businessData
+    };
   }
+
   // ============================================
   // Quantity Check 处理
   // ============================================
+
   processQuantityCheck(action, businessData) {
     const config = action.config;
-    if (!config)
-      return null;
-    const { scope, quantityRules, targetType, targets, validationMessage } = config;
+    if (!config) return null;
+    const {
+      scope,
+      quantityRules,
+      targetType,
+      targets,
+      validationMessage
+    } = config;
     if (!this.shouldEvaluateForScope(scope, businessData.submissionIndex ?? 0)) {
       return null;
     }
-    const actualQuantity = this.calculateActualQuantity(
-      targets,
-      scope,
-      businessData
-    );
-    const { passed, failedRules, requiredMin, requiredMax, requiredExact, mustInclude } = this.evaluateQuantityRules(quantityRules, actualQuantity, businessData);
-    const message = this.formatValidationMessage(
-      validationMessage,
+    const actualQuantity = this.calculateActualQuantity(targets, scope, businessData);
+    const {
+      passed,
+      failedRules,
       requiredMin,
       requiredMax,
-      requiredExact
-    );
+      requiredExact,
+      mustInclude
+    } = this.evaluateQuantityRules(quantityRules, actualQuantity, businessData);
+    const message = this.formatValidationMessage(validationMessage, requiredMin, requiredMax, requiredExact);
     return {
       ruleId: action.id,
       passed,
@@ -109,42 +114,44 @@ var ItemRuleAdapter = class {
       mustInclude,
       validationMessage: message,
       scope,
-      failedRules: passed ? void 0 : failedRules
+      failedRules: passed ? undefined : failedRules
     };
   }
+
   /**
    * 根据 scope 判断当前提交是否需要评估此规则
    */
   shouldEvaluateForScope(scope, submissionIndex) {
     switch (scope) {
-      case "each_submission":
+      case 'each_submission':
         return true;
-      case "first_submission_only":
+      case 'first_submission_only':
         return submissionIndex === 0;
-      case "subsequent_only":
+      case 'subsequent_only':
         return submissionIndex > 0;
-      case "cumulative":
+      case 'cumulative':
         return true;
       default:
         return true;
     }
   }
+
   /**
    * 计算目标商品在购物车中的实际数量
    *
    * cumulative scope 时还会加上历史订单数量。
    */
   calculateActualQuantity(targets, scope, businessData) {
-    const targetIds = new Set(targets.map((t) => t.product_id));
+    const targetIds = new Set(targets.map(t => t.product_id));
     let quantity = 0;
-    const countFromItems = (items) => {
+    const countFromItems = items => {
       for (const item of items) {
         if (targetIds.has(item.product_id)) {
           quantity += item.quantity;
         }
       }
     };
-    if (scope === "cumulative") {
+    if (scope === 'cumulative') {
       if (businessData.historicalItems) {
         countFromItems(businessData.historicalItems);
       }
@@ -166,38 +173,42 @@ var ItemRuleAdapter = class {
     for (const rule of rules) {
       const resolvedValue = this.resolveQuantityValue(rule, businessData);
       switch (rule.comparison) {
-        case "minimum": {
-          if (requiredMin === void 0 || resolvedValue > requiredMin) {
-            requiredMin = resolvedValue;
-          }
-          if (actualQuantity < resolvedValue) {
-            failedRules.push(rule);
-          }
-          break;
-        }
-        case "maximum": {
-          if (requiredMax === void 0 || resolvedValue < requiredMax) {
-            requiredMax = resolvedValue;
+        case 'minimum':
+          {
+            if (requiredMin === undefined || resolvedValue > requiredMin) {
+              requiredMin = resolvedValue;
+            }
+            if (actualQuantity < resolvedValue) {
+              failedRules.push(rule);
+            }
+            break;
           }
-          if (actualQuantity > resolvedValue) {
-            failedRules.push(rule);
+        case 'maximum':
+          {
+            if (requiredMax === undefined || resolvedValue < requiredMax) {
+              requiredMax = resolvedValue;
+            }
+            if (actualQuantity > resolvedValue) {
+              failedRules.push(rule);
+            }
+            break;
           }
-          break;
-        }
-        case "exact": {
-          requiredExact = resolvedValue;
-          if (actualQuantity !== resolvedValue) {
-            failedRules.push(rule);
+        case 'exact':
+          {
+            requiredExact = resolvedValue;
+            if (actualQuantity !== resolvedValue) {
+              failedRules.push(rule);
+            }
+            break;
           }
-          break;
-        }
-        case "must_include": {
-          mustInclude = true;
-          if (actualQuantity < 1) {
-            failedRules.push(rule);
+        case 'must_include':
+          {
+            mustInclude = true;
+            if (actualQuantity < 1) {
+              failedRules.push(rule);
+            }
+            break;
           }
-          break;
-        }
       }
     }
     return {
@@ -209,36 +220,39 @@ var ItemRuleAdapter = class {
       mustInclude
     };
   }
+
   /**
    * 根据 source 解析出数量规则的实际数值
    */
   resolveQuantityValue(rule, businessData) {
     switch (rule.source) {
-      case "total_pax":
+      case 'total_pax':
         return businessData.pax.total;
-      case "adult_pax":
+      case 'adult_pax':
         return businessData.pax.adult;
-      case "fixed":
+      case 'fixed':
         return rule.value ?? 0;
       default:
         return rule.value ?? 0;
     }
   }
+
   /**
    * 格式化校验提示语，替换 {min} {max} 占位符
    */
   formatValidationMessage(template, min, max, exact, locale) {
-    if (!template)
-      return void 0;
-    let text = typeof template === "string" ? template : template[locale || "en"] || Object.values(template)[0] || "";
-    text = text.replace(/\{min\}/g, String(min ?? ""));
-    text = text.replace(/\{max\}/g, String(max ?? ""));
-    text = text.replace(/\{exact\}/g, String(exact ?? ""));
+    if (!template) return undefined;
+    let text = typeof template === 'string' ? template : template[locale || 'en'] || Object.values(template)[0] || '';
+    text = text.replace(/\{min\}/g, String(min ?? ''));
+    text = text.replace(/\{max\}/g, String(max ?? ''));
+    text = text.replace(/\{exact\}/g, String(exact ?? ''));
     return text;
   }
+
   // ============================================
   // Quantity Limit 提取（仅读取配置，不做校验）
   // ============================================
+
   /**
    * 从单个 QUANTITY_CHECK action 中提取数量限制配置。
    *
@@ -248,9 +262,14 @@ var ItemRuleAdapter = class {
    */
   extractQuantityLimits(action, businessData) {
     const config = action.config;
-    if (!config)
-      return null;
-    const { scope, quantityRules, targetType, targets, validationMessage } = config;
+    if (!config) return null;
+    const {
+      scope,
+      quantityRules,
+      targetType,
+      targets,
+      validationMessage
+    } = config;
     if (!this.shouldEvaluateForScope(scope, businessData.submissionIndex ?? 0)) {
       return null;
     }
@@ -261,40 +280,34 @@ var ItemRuleAdapter = class {
     for (const rule of quantityRules) {
       const resolvedValue = this.resolveQuantityValue(rule, businessData);
       switch (rule.comparison) {
-        case "minimum": {
-          if (requiredMin === void 0 || resolvedValue > requiredMin) {
-            requiredMin = resolvedValue;
+        case 'minimum':
+          {
+            if (requiredMin === undefined || resolvedValue > requiredMin) {
+              requiredMin = resolvedValue;
+            }
+            break;
           }
-          break;
-        }
-        case "maximum": {
-          if (requiredMax === void 0 || resolvedValue < requiredMax) {
-            requiredMax = resolvedValue;
+        case 'maximum':
+          {
+            if (requiredMax === undefined || resolvedValue < requiredMax) {
+              requiredMax = resolvedValue;
+            }
+            break;
+          }
+        case 'exact':
+          {
+            requiredExact = resolvedValue;
+            break;
+          }
+        case 'must_include':
+          {
+            mustInclude = true;
+            break;
           }
-          break;
-        }
-        case "exact": {
-          requiredExact = resolvedValue;
-          break;
-        }
-        case "must_include": {
-          mustInclude = true;
-          break;
-        }
       }
     }
-    const remainingMax = this.calculateRemainingMax(
-      scope,
-      requiredMax,
-      targets,
-      businessData
-    );
-    const formattedValidationMessage = this.formatValidationMessage(
-      validationMessage,
-      requiredMin,
-      requiredMax,
-      requiredExact
-    );
+    const remainingMax = this.calculateRemainingMax(scope, requiredMax, targets, businessData);
+    const formattedValidationMessage = this.formatValidationMessage(validationMessage, requiredMin, requiredMax, requiredExact);
     return {
       ruleId: action.id,
       targetType,
@@ -309,6 +322,7 @@ var ItemRuleAdapter = class {
       rawValidationMessage: validationMessage
     };
   }
+
   /**
    * 计算当前提交剩余可选的最大数量。
    *
@@ -317,14 +331,14 @@ var ItemRuleAdapter = class {
    * 其余场景返回 undefined，保持向后兼容。
    */
   calculateRemainingMax(scope, requiredMax, targets, businessData) {
-    if (scope !== "cumulative" || typeof requiredMax !== "number") {
-      return void 0;
+    if (scope !== 'cumulative' || typeof requiredMax !== 'number') {
+      return undefined;
     }
     const historicalItems = businessData.historicalItems;
-    if (!(historicalItems == null ? void 0 : historicalItems.length)) {
+    if (!historicalItems?.length) {
       return Math.max(0, requiredMax);
     }
-    const targetIds = new Set(targets.map((t) => t.product_id));
+    const targetIds = new Set(targets.map(t => t.product_id));
     let historicalQty = 0;
     for (const item of historicalItems) {
       if (targetIds.has(item.product_id)) {
@@ -333,18 +347,18 @@ var ItemRuleAdapter = class {
     }
     return Math.max(0, requiredMax - historicalQty);
   }
+
   // ============================================
   // Prefill Cart 处理
   // ============================================
+
   processPrefillCart(action, businessData) {
     const config = action.config;
-    if (!(config == null ? void 0 : config.products))
-      return [];
+    if (!config?.products) return [];
     const results = [];
     for (const prefillProduct of config.products) {
       const quantity = this.resolvePrefillQuantity(prefillProduct.quantityFrom, prefillProduct.quantity, businessData);
-      if (quantity <= 0)
-        continue;
+      if (quantity <= 0) continue;
       results.push({
         ruleId: action.id,
         product_id: prefillProduct.product_id,
@@ -354,24 +368,22 @@ var ItemRuleAdapter = class {
     }
     return results;
   }
+
   /**
    * 根据 quantityFrom 计算预填数量
    */
   resolvePrefillQuantity(quantityFrom, fixedValue, businessData) {
     switch (quantityFrom) {
-      case "total_pax":
+      case 'total_pax':
         return businessData.pax.total;
-      case "adult_pax":
+      case 'adult_pax':
         return businessData.pax.adult;
-      case "fixed":
+      case 'fixed':
         return fixedValue ?? 0;
       default:
         return fixedValue ?? 0;
     }
   }
-};
-var adapter_default = ItemRuleAdapter;
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  ItemRuleAdapter
-});
+}
+exports.ItemRuleAdapter = ItemRuleAdapter;
+var _default = exports.default = ItemRuleAdapter;

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

@@ -1,56 +1,46 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+"use strict";
 
-// src/model/strategy/adapter/itemRule/evaluator.ts
-var evaluator_exports = {};
-__export(evaluator_exports, {
-  ItemRuleEvaluator: () => ItemRuleEvaluator
+Object.defineProperty(exports, "__esModule", {
+  value: true
 });
-module.exports = __toCommonJS(evaluator_exports);
-var import_engine = require("../../engine");
-var import_adapter = require("./adapter");
-var import_type = require("./type");
-var ItemRuleEvaluator = class {
+exports.ItemRuleEvaluator = void 0;
+var _engine = require("../../engine");
+var _adapter = require("./adapter");
+var _type = require("./type");
+/**
+ * ItemRule 评估器
+ *
+ * 组合 StrategyEngine + ItemRuleAdapter，提供面向业务的高层 API。
+ * 支持批量评估多条 item_rule 策略配置，聚合数量校验和预填购物车结果。
+ */
+class ItemRuleEvaluator {
+  engine;
+  adapter;
+  strategyConfigs = [];
   constructor() {
-    this.strategyConfigs = [];
-    this.engine = new import_engine.StrategyEngine({
+    this.engine = new _engine.StrategyEngine({
       debug: false,
       enableTrace: false
     });
-    this.adapter = new import_adapter.ItemRuleAdapter();
+    this.adapter = new _adapter.ItemRuleAdapter();
   }
+
   /**
    * 设置策略配置列表
    * 自动过滤 metadata.type === 'item_rule' 的配置
    */
   setStrategyConfigs(configs) {
-    this.strategyConfigs = configs.filter(
-      (c) => c.metadata.type === "item_rule"
-    );
+    this.strategyConfigs = configs.filter(c => c.metadata.type === 'item_rule');
   }
   getStrategyConfigs() {
     return this.strategyConfigs;
   }
+
   /**
    * 完整评估：数量校验 + 预填购物车
    */
   evaluate(businessData) {
-    const configs = businessData.strategyConfigs ? businessData.strategyConfigs.filter((c) => c.metadata.type === "item_rule") : this.strategyConfigs;
+    const configs = businessData.strategyConfigs ? businessData.strategyConfigs.filter(c => c.metadata.type === 'item_rule') : this.strategyConfigs;
     const allQuantityChecks = [];
     const allPrefillItems = [];
     const rawResults = [];
@@ -58,14 +48,14 @@ var ItemRuleEvaluator = class {
     for (const config of configs) {
       const evalResult = this.engine.evaluate(config, context);
       rawResults.push(evalResult);
-      const { quantityChecks, prefillItems } = this.adapter.transformResult(
-        evalResult,
-        businessData
-      );
+      const {
+        quantityChecks,
+        prefillItems
+      } = this.adapter.transformResult(evalResult, businessData);
       allQuantityChecks.push(...quantityChecks);
       allPrefillItems.push(...prefillItems);
     }
-    const failedChecks = allQuantityChecks.filter((c) => !c.passed);
+    const failedChecks = allQuantityChecks.filter(c => !c.passed);
     return {
       quantityChecks: allQuantityChecks,
       prefillItems: allPrefillItems,
@@ -74,6 +64,7 @@ var ItemRuleEvaluator = class {
       rawResults
     };
   }
+
   /**
    * 获取当前配置中各商品的数量限制
    *
@@ -82,16 +73,14 @@ var ItemRuleEvaluator = class {
    * 会评估条件是否满足、根据 scope + submissionIndex 过滤。
    */
   getQuantityLimits(businessData) {
-    const configs = businessData.strategyConfigs ? businessData.strategyConfigs.filter((c) => c.metadata.type === "item_rule") : this.strategyConfigs;
+    const configs = businessData.strategyConfigs ? businessData.strategyConfigs.filter(c => c.metadata.type === 'item_rule') : this.strategyConfigs;
     const results = [];
     const context = this.adapter.prepareContext(businessData);
     for (const config of configs) {
       const evalResult = this.engine.evaluate(config, context);
-      if (!evalResult.applicable)
-        continue;
+      if (!evalResult.applicable) continue;
       for (const action of evalResult.matchedActions) {
-        if (action.type !== import_type.ITEM_RULE_ACTION_TYPES.QUANTITY_CHECK)
-          continue;
+        if (action.type !== _type.ITEM_RULE_ACTION_TYPES.QUANTITY_CHECK) continue;
         const limit = this.adapter.extractQuantityLimits(action, businessData);
         if (limit) {
           results.push(limit);
@@ -100,6 +89,7 @@ var ItemRuleEvaluator = class {
     }
     return results;
   }
+
   /**
    * 便捷方法：仅做数量校验，返回是否全部通过及失败详情
    */
@@ -110,6 +100,7 @@ var ItemRuleEvaluator = class {
       failures: result.failedChecks
     };
   }
+
   /**
    * 便捷方法：仅获取需要预填到购物车的商品
    */
@@ -117,8 +108,5 @@ var ItemRuleEvaluator = class {
     const result = this.evaluate(businessData);
     return result.prefillItems;
   }
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  ItemRuleEvaluator
-});
+}
+exports.ItemRuleEvaluator = ItemRuleEvaluator;