@pisell/pisellos 0.10.14 → 0.10.16

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

@@ -1,60 +1,86 @@
-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 });
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _exportNames = {
+  ItemRuleEvaluator: true,
+  ItemRuleAdapter: true,
+  MIN_CONDIMENT_PER_PERSON_STRATEGY: true,
+  MAX_BUNS_PER_TABLE_STRATEGY: true,
+  HOTPOT_BASE_REQUIRED_STRATEGY: true,
+  HOTPOT_BASE_PICK_ONE_STRATEGY: true,
+  quickUseItemRuleEvaluator: true,
+  runItemRuleEvaluatorDemo: 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 });
+Object.defineProperty(exports, "HOTPOT_BASE_PICK_ONE_STRATEGY", {
+  enumerable: true,
+  get: function () {
+    return _examples.HOTPOT_BASE_PICK_ONE_STRATEGY;
   }
-  return to;
-};
-var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
-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);
-
-// src/model/strategy/adapter/itemRule/index.ts
-var itemRule_exports = {};
-__export(itemRule_exports, {
-  HOTPOT_BASE_PICK_ONE_STRATEGY: () => import_examples.HOTPOT_BASE_PICK_ONE_STRATEGY,
-  HOTPOT_BASE_REQUIRED_STRATEGY: () => import_examples.HOTPOT_BASE_REQUIRED_STRATEGY,
-  ItemRuleAdapter: () => import_adapter.ItemRuleAdapter,
-  ItemRuleEvaluator: () => import_evaluator.ItemRuleEvaluator,
-  MAX_BUNS_PER_TABLE_STRATEGY: () => import_examples.MAX_BUNS_PER_TABLE_STRATEGY,
-  MIN_CONDIMENT_PER_PERSON_STRATEGY: () => import_examples.MIN_CONDIMENT_PER_PERSON_STRATEGY,
-  default: () => import_adapter2.default,
-  quickUseItemRuleEvaluator: () => import_examples.quickUseItemRuleEvaluator,
-  runItemRuleEvaluatorDemo: () => import_examples.runItemRuleEvaluatorDemo
-});
-module.exports = __toCommonJS(itemRule_exports);
-var import_evaluator = require("./evaluator");
-var import_adapter = require("./adapter");
-var import_adapter2 = __toESM(require("./adapter"));
-var import_examples = require("./examples");
-__reExport(itemRule_exports, require("./type"), module.exports);
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  HOTPOT_BASE_PICK_ONE_STRATEGY,
-  HOTPOT_BASE_REQUIRED_STRATEGY,
-  ItemRuleAdapter,
-  ItemRuleEvaluator,
-  MAX_BUNS_PER_TABLE_STRATEGY,
-  MIN_CONDIMENT_PER_PERSON_STRATEGY,
-  quickUseItemRuleEvaluator,
-  runItemRuleEvaluatorDemo,
-  ...require("./type")
 });
+Object.defineProperty(exports, "HOTPOT_BASE_REQUIRED_STRATEGY", {
+  enumerable: true,
+  get: function () {
+    return _examples.HOTPOT_BASE_REQUIRED_STRATEGY;
+  }
+});
+Object.defineProperty(exports, "ItemRuleAdapter", {
+  enumerable: true,
+  get: function () {
+    return _adapter.ItemRuleAdapter;
+  }
+});
+Object.defineProperty(exports, "ItemRuleEvaluator", {
+  enumerable: true,
+  get: function () {
+    return _evaluator.ItemRuleEvaluator;
+  }
+});
+Object.defineProperty(exports, "MAX_BUNS_PER_TABLE_STRATEGY", {
+  enumerable: true,
+  get: function () {
+    return _examples.MAX_BUNS_PER_TABLE_STRATEGY;
+  }
+});
+Object.defineProperty(exports, "MIN_CONDIMENT_PER_PERSON_STRATEGY", {
+  enumerable: true,
+  get: function () {
+    return _examples.MIN_CONDIMENT_PER_PERSON_STRATEGY;
+  }
+});
+Object.defineProperty(exports, "default", {
+  enumerable: true,
+  get: function () {
+    return _adapter.default;
+  }
+});
+Object.defineProperty(exports, "quickUseItemRuleEvaluator", {
+  enumerable: true,
+  get: function () {
+    return _examples.quickUseItemRuleEvaluator;
+  }
+});
+Object.defineProperty(exports, "runItemRuleEvaluatorDemo", {
+  enumerable: true,
+  get: function () {
+    return _examples.runItemRuleEvaluatorDemo;
+  }
+});
+var _evaluator = require("./evaluator");
+var _adapter = _interopRequireWildcard(require("./adapter"));
+var _examples = require("./examples");
+var _type = require("./type");
+Object.keys(_type).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _type[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _type[key];
+    }
+  });
+});
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }

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

@@ -1,46 +1,107 @@
-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/type.ts
-var type_exports = {};
-__export(type_exports, {
-  ITEM_RULE_ACTION_TYPES: () => ITEM_RULE_ACTION_TYPES,
-  ITEM_RULE_TEMPLATES: () => ITEM_RULE_TEMPLATES
+Object.defineProperty(exports, "__esModule", {
+  value: true
 });
-module.exports = __toCommonJS(type_exports);
-var ITEM_RULE_ACTION_TYPES = {
+exports.ITEM_RULE_TEMPLATES = exports.ITEM_RULE_ACTION_TYPES = void 0;
+// ============================================
+// Action Type 常量
+// ============================================
+
+const ITEM_RULE_ACTION_TYPES = exports.ITEM_RULE_ACTION_TYPES = {
   /** 数量校验 */
-  QUANTITY_CHECK: "QUANTITY_CHECK",
+  QUANTITY_CHECK: 'QUANTITY_CHECK',
   /** 预填购物车 */
-  PREFILL_CART: "PREFILL_CART"
+  PREFILL_CART: 'PREFILL_CART'
 };
-var ITEM_RULE_TEMPLATES = {
+// ============================================
+// Rule Template 类型（创建规则时的起始模板）
+// ============================================
+
+const ITEM_RULE_TEMPLATES = exports.ITEM_RULE_TEMPLATES = {
   /** 空白规则 */
-  BLANK: "blank",
+  BLANK: 'blank',
   /** 人数关联最少量（每人至少N份） */
-  MINIMUM_PER_PERSON: "minimum_per_person",
+  MINIMUM_PER_PERSON: 'minimum_per_person',
   /** 每桌限量 */
-  MAXIMUM_PER_TABLE: "maximum_per_table",
+  MAXIMUM_PER_TABLE: 'maximum_per_table',
   /** 必选商品 */
-  MUST_INCLUDE: "must_include"
+  MUST_INCLUDE: 'must_include'
 };
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  ITEM_RULE_ACTION_TYPES,
-  ITEM_RULE_TEMPLATES
-});
+
+// ============================================
+// Quantity Check 相关类型
+// ============================================
+
+/** 数量比较类型 */
+
+/** 数量来源 */
+
+/** 目标类型（当前仅支持按商品） */
+
+/** 作用范围 */
+
+/**
+ * 单条数量规则
+ *
+ * 例如：Minimum + Total Pax 表示"最少数量 = 总人数"
+ * 例如：Maximum + Fixed + 10 表示"最多10份"
+ */
+
+/**
+ * Quantity Check Action 的详细配置
+ *
+ * 存储在 ActionEffect.config 中
+ */
+
+/** 目标项 */
+
+// ============================================
+// Prefill Cart 相关类型
+// ============================================
+
+/**
+ * 预填商品项
+ */
+
+/**
+ * Prefill Cart Action 的详细配置
+ *
+ * 存储在 ActionEffect.config 中
+ */
+
+// ============================================
+// 业务数据类型（Evaluator 输入）
+// ============================================
+
+/**
+ * 购物车商品摘要
+ */
+
+/**
+ * 就餐人数信息
+ */
+
+/**
+ * ItemRule 评估器的输入业务数据
+ */
+
+// ============================================
+// 评估结果类型
+// ============================================
+
+/**
+ * 单个 Quantity Check 的校验结果
+ */
+
+/**
+ * 单个 Prefill Cart 的预填结果
+ */
+
+/**
+ * 单条规则的数量限制（不含校验结果，仅描述配置中的约束）
+ */
+
+/**
+ * ItemRule 评估器的完整输出结果
+ */

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

@@ -1,43 +1,42 @@
-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);
-
-// src/model/strategy/adapter/promotion/adapter.ts
-var adapter_exports = {};
-__export(adapter_exports, {
-  PromotionAdapter: () => PromotionAdapter,
-  default: () => adapter_default
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
 });
-module.exports = __toCommonJS(adapter_exports);
-var import_type = require("./type");
-var PromotionAdapter = class {
-  constructor() {
-    this.name = "PromotionAdapter";
-    this.version = "1.0.0";
-  }
+exports.default = exports.PromotionAdapter = void 0;
+var _type = require("./type");
+// ============================================
+// Promotion 适配器实现
+// ============================================
+
+/**
+ * Promotion 适配器
+ *
+ * 用于将促销活动业务数据转换为策略引擎可识别的格式
+ * 策略引擎只负责匹配，具体的优惠计算由业务层完成
+ */
+class PromotionAdapter {
+  name = 'PromotionAdapter';
+  version = '1.0.0';
+
   /**
    * 准备运行时上下文
    *
    * 将业务数据转换为策略引擎可识别的 RuntimeContext
    */
   prepareContext(businessData) {
-    const { products, currentProduct, channel, custom } = businessData;
-    const now = /* @__PURE__ */ new Date();
+    const {
+      products,
+      currentProduct,
+      channel,
+      custom
+    } = businessData;
+
+    // 当前时间（用于时间条件判断）
+    const now = new Date();
     const currentDateTime = this.formatDateTime(now);
+
+    // 如果有 currentProduct，用于单商品场景（商品卡片展示）
     const evaluatingProduct = currentProduct || (products.length > 0 ? products[0] : null);
     return {
       entities: {
@@ -53,7 +52,7 @@ var PromotionAdapter = class {
           product_variant_id: evaluatingProduct.product_variant_id
         } : null,
         // 渠道
-        channel: channel || "",
+        channel: channel || '',
         // 商品总数量
         totalQuantity: products.reduce((sum, p) => sum + p.quantity, 0),
         // 商品总金额
@@ -66,6 +65,7 @@ var PromotionAdapter = class {
       }
     };
   }
+
   /**
    * 转换执行结果
    *
@@ -73,6 +73,7 @@ var PromotionAdapter = class {
    * 主要是整理 matchedActions，让业务层更容易使用
    */
   transformResult(result, businessData) {
+    // 获取适用的商品列表
     const applicableProducts = businessData ? this.getApplicableProducts(result, businessData) : [];
     if (!result.applicable) {
       return {
@@ -83,16 +84,20 @@ var PromotionAdapter = class {
         strategyResult: result
       };
     }
+
+    // 获取第一个匹配的 action（按 priority 排序后的）
     const matchedAction = result.matchedActions[0];
     if (!matchedAction) {
       return {
         isApplicable: false,
         applicableProducts: [],
-        reason: "No matched action",
-        reasonCode: "NO_ACTION",
+        reason: 'No matched action',
+        reasonCode: 'NO_ACTION',
         strategyResult: result
       };
     }
+
+    // 解析 action 详情
     const actionDetail = this.parseActionDetail(matchedAction);
     return {
       isApplicable: true,
@@ -102,27 +107,34 @@ var PromotionAdapter = class {
       strategyResult: result
     };
   }
+
   /**
    * 格式化配置
    */
   formatConfig(result, businessData) {
-    return { result, businessData };
+    return {
+      result,
+      businessData
+    };
   }
+
   // ============================================
   // 私有辅助方法
   // ============================================
+
   /**
    * 格式化日期时间
    */
   formatDateTime(date) {
     const year = date.getFullYear();
-    const month = String(date.getMonth() + 1).padStart(2, "0");
-    const day = String(date.getDate()).padStart(2, "0");
-    const hours = String(date.getHours()).padStart(2, "0");
-    const minutes = String(date.getMinutes()).padStart(2, "0");
-    const seconds = String(date.getSeconds()).padStart(2, "0");
+    const month = String(date.getMonth() + 1).padStart(2, '0');
+    const day = String(date.getDate()).padStart(2, '0');
+    const hours = String(date.getHours()).padStart(2, '0');
+    const minutes = String(date.getMinutes()).padStart(2, '0');
+    const seconds = String(date.getSeconds()).padStart(2, '0');
     return `${year}-${month}-${day} ${hours}:${minutes}:${seconds}`;
   }
+
   /**
    * 解析 Action 详情
    *
@@ -130,16 +142,17 @@ var PromotionAdapter = class {
    */
   parseActionDetail(action) {
     switch (action.type) {
-      case import_type.PROMOTION_ACTION_TYPES.X_ITEMS_FOR_Y_PRICE:
+      case _type.PROMOTION_ACTION_TYPES.X_ITEMS_FOR_Y_PRICE:
         return this.parseXItemsForYPriceAction(action);
-      case import_type.PROMOTION_ACTION_TYPES.BUY_X_GET_Y_FREE:
+      case _type.PROMOTION_ACTION_TYPES.BUY_X_GET_Y_FREE:
         return this.parseBuyXGetYFreeAction(action);
-      case import_type.PROMOTION_ACTION_TYPES.ITEM_REWARD:
+      case _type.PROMOTION_ACTION_TYPES.ITEM_REWARD:
         return this.parseItemRewardAction(action);
       default:
-        return void 0;
+        return undefined;
     }
   }
+
   /**
    * 解析 X件Y元 Action
    */
@@ -147,13 +160,14 @@ var PromotionAdapter = class {
     const value = action.value || {};
     const config = action.config || {};
     return {
-      type: import_type.PROMOTION_ACTION_TYPES.X_ITEMS_FOR_Y_PRICE,
+      type: _type.PROMOTION_ACTION_TYPES.X_ITEMS_FOR_Y_PRICE,
       x: value.x || 2,
       price: value.price || 0,
       allowCrossProduct: config.allowCrossProduct ?? true,
       cumulative: config.cumulative ?? true
     };
   }
+
   /**
    * 解析 买X送Y Action
    */
@@ -161,14 +175,15 @@ var PromotionAdapter = class {
     const value = action.value || {};
     const config = action.config || {};
     return {
-      type: import_type.PROMOTION_ACTION_TYPES.BUY_X_GET_Y_FREE,
+      type: _type.PROMOTION_ACTION_TYPES.BUY_X_GET_Y_FREE,
       buyQuantity: value.buyQuantity || 1,
       freeQuantity: value.freeQuantity || 1,
-      giftSelectionMode: config.giftSelectionMode || "user_select",
+      giftSelectionMode: config.giftSelectionMode || 'user_select',
       cumulative: config.cumulative ?? true,
       giftProducts: config.giftProducts || []
     };
   }
+
   /**
    * 解析 商品奖励 Action
    */
@@ -176,62 +191,69 @@ var PromotionAdapter = class {
     const value = action.value || {};
     const config = action.config || {};
     return {
-      type: import_type.PROMOTION_ACTION_TYPES.ITEM_REWARD,
-      rewardMethod: value.rewardMethod || "free",
+      type: _type.PROMOTION_ACTION_TYPES.ITEM_REWARD,
+      rewardMethod: value.rewardMethod || 'free',
       rewardValue: Number(value.rewardValue || 0),
-      quantityRule: value.quantityRule || "per_condition_quantity",
+      quantityRule: value.quantityRule || 'per_condition_quantity',
       triggerQuantity: Number(value.triggerQuantity || 1),
       rewardQuantity: Number(value.rewardQuantity || 1),
-      maxRewardQuantity: value.maxRewardQuantity === void 0 || value.maxRewardQuantity === null ? void 0 : Number(value.maxRewardQuantity),
+      maxRewardQuantity: value.maxRewardQuantity === undefined || value.maxRewardQuantity === null ? undefined : Number(value.maxRewardQuantity),
       rewardTargets: Array.isArray(config.rewardTargets) ? config.rewardTargets : [],
-      targetSelection: config.targetSelection || "consumer_best"
+      targetSelection: config.targetSelection || 'consumer_best'
     };
   }
+
   /**
    * 获取适用的商品列表
    *
    * 从购物车商品中筛选出符合策略条件的商品
    */
   getApplicableProducts(result, businessData) {
-    const { products } = businessData;
+    const {
+      products
+    } = businessData;
+
+    // 从策略配置中获取商品范围条件
     const productMatchRule = this.findProductMatchRule(result.config);
     if (!productMatchRule) {
+      // 如果没有商品范围条件，所有商品都适用
       return products;
     }
     const configProducts = productMatchRule.value;
-    return products.filter(
-      (product) => this.isProductMatch(product, configProducts)
-    );
+
+    // 筛选适用的商品
+    return products.filter(product => this.isProductMatch(product, configProducts));
   }
+
   /**
    * 查找商品匹配规则
    */
   findProductMatchRule(config) {
-    var _a;
-    if (!((_a = config == null ? void 0 : config.conditions) == null ? void 0 : _a.rules)) {
+    if (!config?.conditions?.rules) {
       return null;
     }
-    return config.conditions.rules.find(
-      (rule) => rule.field === "productIdAndVariantId" && (rule.operator === "product_match" || rule.operator === "object_in")
-    );
+    return config.conditions.rules.find(rule => rule.field === 'productIdAndVariantId' && (rule.operator === 'product_match' || rule.operator === 'object_in'));
   }
+
   /**
    * 检查商品是否匹配
    */
   isProductMatch(product, configProducts) {
-    return configProducts.some((config) => {
+    return configProducts.some(config => {
+      // 首先检查 product_id
       if (config.product_id !== product.product_id) {
         return false;
       }
+
+      // 如果配置的 product_variant_id = 0，只需要 product_id 匹配
       if (config.product_variant_id === 0) {
         return true;
       }
+
+      // 否则需要 product_variant_id 精确匹配
       return config.product_variant_id === product.product_variant_id;
     });
   }
-};
-var adapter_default = PromotionAdapter;
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  PromotionAdapter
-});
+}
+exports.PromotionAdapter = PromotionAdapter;
+var _default = exports.default = PromotionAdapter;