@pisell/pisellos 0.0.567 → 0.0.568

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

@@ -1,192 +1,172 @@
-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/promotion/examples.ts
-var examples_exports = {};
-__export(examples_exports, {
-  BUY_X_GET_Y_FREE_STRATEGY: () => BUY_X_GET_Y_FREE_STRATEGY,
-  X_ITEMS_FOR_Y_PRICE_STRATEGY: () => X_ITEMS_FOR_Y_PRICE_STRATEGY
+Object.defineProperty(exports, "__esModule", {
+  value: true
 });
-module.exports = __toCommonJS(examples_exports);
-var X_ITEMS_FOR_Y_PRICE_STRATEGY = {
+exports.X_ITEMS_FOR_Y_PRICE_STRATEGY = exports.BUY_X_GET_Y_FREE_STRATEGY = void 0;
+/**
+ * X件Y元策略配置示例
+ *
+ * 业务规则：
+ * - 每X件商品固定价格Y元（可累计）
+ * - 支持跨商品组合（A+B可以凑成一组）
+ * - 买5件 = 2组优惠 + 1件原价
+ *
+ * 商品匹配规则：
+ * - product_variant_id = 0 表示匹配任意变体
+ * - product_variant_id != 0 表示精确匹配该变体
+ */
+const X_ITEMS_FOR_Y_PRICE_STRATEGY = exports.X_ITEMS_FOR_Y_PRICE_STRATEGY = {
   metadata: {
-    id: "STRATEGY_001",
+    id: 'STRATEGY_001',
     name: {
-      en: "2 items for $10",
-      "zh-CN": "2杯10元",
-      "zh-HK": "2杯10元"
+      en: '2 items for $10',
+      'zh-CN': '2杯10元',
+      'zh-HK': '2杯10元'
     },
-    type: "promotion",
+    type: 'promotion',
     custom: {
       display: {
         product_card: {
           text: {
-            en: "2 for $10",
-            "zh-CN": "2杯10元",
-            "zh-HK": "2杯10元"
+            en: '2 for $10',
+            'zh-CN': '2杯10元',
+            'zh-HK': '2杯10元'
           },
-          type: "tag"
+          type: 'tag'
         }
       }
     }
   },
   conditions: {
-    operator: "and",
-    rules: [
-      {
-        type: "operator",
-        field: "currentDateTime",
-        value: "2023-01-01 00:00:00",
-        operator: ">="
-      },
-      {
-        type: "operator",
-        field: "currentDateTime",
-        value: "2027-01-01 00:00:00",
-        operator: "<="
-      },
-      {
-        type: "operator",
-        field: "productIdAndVariantId",
-        value: [
-          {
-            product_id: 60736,
-            product_variant_id: 0
-            // 0 = 匹配任意变体
-          },
-          {
-            product_id: 60737,
-            product_variant_id: 0
-            // 0 = 匹配任意变体
-          }
-        ],
-        operator: "product_match"
-      }
-    ],
-    actionIds: ["1"]
+    operator: 'and',
+    rules: [{
+      type: 'operator',
+      field: 'currentDateTime',
+      value: '2023-01-01 00:00:00',
+      operator: '>='
+    }, {
+      type: 'operator',
+      field: 'currentDateTime',
+      value: '2027-01-01 00:00:00',
+      operator: '<='
+    }, {
+      type: 'operator',
+      field: 'productIdAndVariantId',
+      value: [{
+        product_id: 60736,
+        product_variant_id: 0 // 0 = 匹配任意变体
+      }, {
+        product_id: 60737,
+        product_variant_id: 0 // 0 = 匹配任意变体
+      }],
+      operator: 'product_match'
+    }],
+    actionIds: ['1']
   },
-  actions: [
-    {
-      id: "1",
-      type: "X_ITEMS_FOR_Y_PRICE",
-      value: {
-        x: 2,
-        // 每X件
-        price: 10
-        // 固定价格Y元
-      },
-      valueType: "object",
-      target: "product",
-      priority: 1,
-      config: {
-        allowCrossProduct: true,
-        // 允许跨商品组合（A+B可以凑成一组）
-        cumulative: true
-        // 可累计（买5件 = 2组优惠 + 1件原价）
-      }
+  actions: [{
+    id: '1',
+    type: 'X_ITEMS_FOR_Y_PRICE',
+    value: {
+      x: 2,
+      // 每X件
+      price: 10 // 固定价格Y元
+    },
+    valueType: 'object',
+    target: 'product',
+    priority: 1,
+    config: {
+      allowCrossProduct: true,
+      // 允许跨商品组合（A+B可以凑成一组）
+      cumulative: true // 可累计（买5件 = 2组优惠 + 1件原价）
     }
-  ]
+  }]
 };
-var BUY_X_GET_Y_FREE_STRATEGY = {
+
+/**
+ * 买X送Y策略配置示例
+ *
+ * 业务规则：
+ * - 买X件送Y件（可累计：买2送2、买3送3...）
+ * - 赠品由用户从列表中选择
+ *
+ * 商品匹配规则：
+ * - product_variant_id = 0 表示匹配任意变体
+ * - product_variant_id != 0 表示精确匹配该变体
+ */
+const BUY_X_GET_Y_FREE_STRATEGY = exports.BUY_X_GET_Y_FREE_STRATEGY = {
   metadata: {
-    id: "STRATEGY_002",
+    id: 'STRATEGY_002',
     name: {
-      en: "Buy 1 Get 1 Free",
-      "zh-CN": "买1送1",
-      "zh-HK": "買1送1"
+      en: 'Buy 1 Get 1 Free',
+      'zh-CN': '买1送1',
+      'zh-HK': '買1送1'
     },
-    type: "promotion",
+    type: 'promotion',
     custom: {
       display: {
         product_card: {
           text: {
-            en: "Buy 1 Get 1",
-            "zh-CN": "买1送1",
-            "zh-HK": "買1送1"
+            en: 'Buy 1 Get 1',
+            'zh-CN': '买1送1',
+            'zh-HK': '買1送1'
           },
-          type: "tag"
+          type: 'tag'
         }
       }
     }
   },
   conditions: {
-    operator: "and",
-    rules: [
-      {
-        type: "operator",
-        field: "currentDateTime",
-        value: "2023-01-01 00:00:00",
-        operator: ">="
-      },
-      {
-        type: "operator",
-        field: "currentDateTime",
-        value: "2027-01-01 00:00:00",
-        operator: "<="
-      },
-      {
-        type: "operator",
-        field: "productIdAndVariantId",
-        value: [
-          {
-            product_id: 60736,
-            product_variant_id: 0
-            // 0 = 匹配任意变体
-          },
-          {
-            product_id: 60737,
-            product_variant_id: 0
-            // 0 = 匹配任意变体
-          }
-        ],
-        operator: "product_match"
-      }
-    ],
-    actionIds: ["1"]
+    operator: 'and',
+    rules: [{
+      type: 'operator',
+      field: 'currentDateTime',
+      value: '2023-01-01 00:00:00',
+      operator: '>='
+    }, {
+      type: 'operator',
+      field: 'currentDateTime',
+      value: '2027-01-01 00:00:00',
+      operator: '<='
+    }, {
+      type: 'operator',
+      field: 'productIdAndVariantId',
+      value: [{
+        product_id: 60736,
+        product_variant_id: 0 // 0 = 匹配任意变体
+      }, {
+        product_id: 60737,
+        product_variant_id: 0 // 0 = 匹配任意变体
+      }],
+      operator: 'product_match'
+    }],
+    actionIds: ['1']
   },
-  actions: [
-    {
-      id: "1",
-      type: "BUY_X_GET_Y_FREE",
-      value: {
-        buyQuantity: 1,
-        // 买X件
-        freeQuantity: 1
-        // 送Y件
-      },
-      valueType: "object",
-      target: "product",
-      priority: 1,
-      config: {
-        // 可累计（买2送2、买3送3...）
-        cumulative: true,
-        // 可选的赠品列表
-        giftProducts: [
-          { product_id: 60757, product_variant_id: 0 },
-          { product_id: 38782, product_variant_id: 0 },
-          { product_id: 60749, product_variant_id: 27267 }
-        ]
-      }
+  actions: [{
+    id: '1',
+    type: 'BUY_X_GET_Y_FREE',
+    value: {
+      buyQuantity: 1,
+      // 买X件
+      freeQuantity: 1 // 送Y件
+    },
+    valueType: 'object',
+    target: 'product',
+    priority: 1,
+    config: {
+      // 可累计（买2送2、买3送3...）
+      cumulative: true,
+      // 可选的赠品列表
+      giftProducts: [{
+        product_id: 60757,
+        product_variant_id: 0
+      }, {
+        product_id: 38782,
+        product_variant_id: 0
+      }, {
+        product_id: 60749,
+        product_variant_id: 27267
+      }]
     }
-  ]
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  BUY_X_GET_Y_FREE_STRATEGY,
-  X_ITEMS_FOR_Y_PRICE_STRATEGY
-});
+  }]
+};

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

@@ -1,49 +1 @@
-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);
-
-// src/model/strategy/adapter/promotion/index.ts
-var promotion_exports = {};
-__export(promotion_exports, {
-  BUY_X_GET_Y_FREE_STRATEGY: () => import_examples.BUY_X_GET_Y_FREE_STRATEGY,
-  PromotionAdapter: () => import_adapter.PromotionAdapter,
-  PromotionEvaluator: () => import_evaluator.PromotionEvaluator,
-  X_ITEMS_FOR_Y_PRICE_STRATEGY: () => import_examples.X_ITEMS_FOR_Y_PRICE_STRATEGY,
-  default: () => import_adapter2.default
-});
-module.exports = __toCommonJS(promotion_exports);
-var import_evaluator = require("./evaluator");
-var import_adapter = require("./adapter");
-var import_adapter2 = __toESM(require("./adapter"));
-var import_examples = require("./examples");
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  BUY_X_GET_Y_FREE_STRATEGY,
-  PromotionAdapter,
-  PromotionEvaluator,
-  X_ITEMS_FOR_Y_PRICE_STRATEGY
-});
+"use strict";

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

@@ -1,39 +1,101 @@
-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/promotion/type.ts
-var type_exports = {};
-__export(type_exports, {
-  PROMOTION_ACTION_TYPES: () => PROMOTION_ACTION_TYPES,
-  PROMOTION_OPERATORS: () => PROMOTION_OPERATORS
+Object.defineProperty(exports, "__esModule", {
+  value: true
 });
-module.exports = __toCommonJS(type_exports);
-var PROMOTION_ACTION_TYPES = {
+exports.PROMOTION_OPERATORS = exports.PROMOTION_ACTION_TYPES = void 0;
+/**
+ * Promotion 策略类型定义
+ *
+ * 定义促销活动相关的 Action 类型、值结构和配置
+ */
+
+// ============================================
+// Action Type 常量
+// ============================================
+
+/**
+ * 促销活动 Action 类型
+ */
+const PROMOTION_ACTION_TYPES = exports.PROMOTION_ACTION_TYPES = {
   /** X件Y元（每X件固定价格Y元，可累计） */
-  X_ITEMS_FOR_Y_PRICE: "X_ITEMS_FOR_Y_PRICE",
+  X_ITEMS_FOR_Y_PRICE: 'X_ITEMS_FOR_Y_PRICE',
   /** 买X送Y（买X件送Y件，可累计） */
-  BUY_X_GET_Y_FREE: "BUY_X_GET_Y_FREE",
+  BUY_X_GET_Y_FREE: 'BUY_X_GET_Y_FREE',
   /** 固定折扣 */
-  DISCOUNT_RATE: "DISCOUNT_RATE",
+  DISCOUNT_RATE: 'DISCOUNT_RATE',
   /** 固定减价 */
-  DEDUCT_AMOUNT: "DEDUCT_AMOUNT"
+  DEDUCT_AMOUNT: 'DEDUCT_AMOUNT'
 };
-var PROMOTION_OPERATORS = {
+
+// ============================================
+// Action Value 类型定义
+// ============================================
+
+/**
+ * X件Y元 - Action Value
+ *
+ * @example
+ * value: { x: 2, price: 10 }  // 每2件10元
+ */
+
+/**
+ * X件Y元 - Action Config
+ */
+
+/**
+ * 买X送Y - Action Value
+ *
+ * @example
+ * value: { buyQuantity: 1, freeQuantity: 1 }  // 买1送1
+ */
+
+/**
+ * 赠品选择模式
+ */
+
+// 自动选最便宜的
+
+/**
+ * 买X送Y - Action Config
+ */
+
+// ============================================
+// 商品标识
+// ============================================
+
+/**
+ * 商品标识
+ *
+ * 匹配规则：
+ * - product_variant_id = 0 表示匹配任意变体
+ * - product_variant_id != 0 表示精确匹配该变体
+ */
+
+// ============================================
+// 完整的 Promotion Action 类型
+// ============================================
+
+/**
+ * X件Y元 Action
+ */
+
+/**
+ * 买X送Y Action
+ */
+
+/**
+ * 促销活动 Action 联合类型
+ */
+
+// ============================================
+// 运算符常量
+// ============================================
+
+/**
+ * 促销相关运算符
+ */
+const PROMOTION_OPERATORS = exports.PROMOTION_OPERATORS = {
   /**
    * 商品匹配运算符
    *
@@ -42,10 +104,112 @@ var PROMOTION_OPERATORS = {
    * - 如果配置的 product_variant_id = 0，只需要 product_id 匹配
    * - 如果配置的 product_variant_id != 0，还需要 product_variant_id 匹配
    */
-  PRODUCT_MATCH: "product_match"
+  PRODUCT_MATCH: 'product_match'
 };
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  PROMOTION_ACTION_TYPES,
-  PROMOTION_OPERATORS
-});
+
+// ============================================
+// 业务数据类型（输入）
+// ============================================
+
+/**
+ * 促销活动业务数据
+ *
+ * 由业务层传入，用于策略评估
+ */
+
+const obj = {
+  product_id: 1,
+  product_variant_id: 0,
+  quantity: 1,
+  price: 100,
+  original_price: 100,
+  id: 1
+};
+
+/**
+ * 促销商品信息
+ */
+
+// ============================================
+// 适配器输出类型
+// ============================================
+
+/**
+ * 促销活动适配器转换结果
+ *
+ * 返回给业务层，包含策略匹配信息
+ */
+
+/**
+ * Action 详情联合类型
+ */
+
+/**
+ * X件Y元 Action 详情
+ */
+
+/**
+ * 买X送Y Action 详情
+ */
+
+// ============================================
+// 业务层输出类型（供参考）
+// ============================================
+
+/**
+ * X件Y元 - 业务层计算结果
+ *
+ * 由业务层根据 matchedAction 计算后返回
+ */
+
+/**
+ * 买X送Y - 业务层计算结果
+ *
+ * 由业务层根据 matchedAction 计算后返回
+ */
+
+/**
+ * 评估器输入
+ */
+
+/**
+ * 单商品评估结果
+ */
+
+/**
+ * 适用的促销信息
+ */
+
+/**
+ * 购物车评估结果
+ */
+
+/**
+ * 购物车适用的促销
+ */
+
+/**
+ * 促销分组
+ */
+
+// ============================================
+// 带定价的购物车评估结果类型
+// ============================================
+
+/**
+ * 带定价的商品
+ *
+ * 在 PromotionProduct 基础上增加了均摊后的最终价格和促销信息
+ */
+
+/**
+ * 赠品信息
+ *
+ * 记录某个促销产生的赠品数量和可选赠品列表
+ */
+
+/**
+ * 带定价的购物车评估结果
+ *
+ * evaluateCartWithPricing 方法的返回结果
+ */

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

@@ -1,17 +1,5 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-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/type.ts
-var type_exports = {};
-module.exports = __toCommonJS(type_exports);
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});