@pisell/pisellos 2.3.74 → 2.3.75

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

@@ -1,283 +1,271 @@
-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,
-  ITEM_REWARD_STRATEGY: () => ITEM_REWARD_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.ITEM_REWARD_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
+      }]
     }
-  ]
+  }]
 };
-var ITEM_REWARD_STRATEGY = {
+
+/**
+ * ITEM_REWARD 策略配置示例：儿童票触发婴儿票免费
+ *
+ * 业务规则：
+ * - 条件商品：儿童票（conditions.rules.productIdAndVariantId）
+ * - 奖励商品：购物车/订单内已经存在的婴儿票（actions[0].config.rewardTargets）
+ * - 本 action 不自动新增婴儿票；每次购物车变更后由统一促销链路重算
+ *
+ * 字段说明：
+ * - type: "ITEM_REWARD" 表示商品奖励 action
+ * - target: "product" 表示本期只奖励商品行
+ * - config.rewardTargets: 奖励对象数组，支持 { product_id, product_variant_id }
+ * - config.targetSelection: "consumer_best" 表示目标商品超额时选择节省金额最高的商品
+ * - value.rewardMethod:
+ *   - "free": 目标商品最终价为 0
+ *   - "percent_off": 百分比折扣，rewardValue 为 0-100
+ *   - "amount_off": 每个目标商品固定减免 rewardValue
+ *   - "fixed_price": 目标商品最终单价为 rewardValue
+ * - value.quantityRule:
+ *   - "per_condition_quantity": 每满足 triggerQuantity 个条件商品，奖励 rewardQuantity 个目标商品
+ *   - "all_targets": 满足条件后奖励全部目标商品
+ *   - "max_per_order": 满足条件后每单最多奖励 maxRewardQuantity 个目标商品
+ */
+const ITEM_REWARD_STRATEGY = exports.ITEM_REWARD_STRATEGY = {
   metadata: {
-    id: "STRATEGY_003",
+    id: 'STRATEGY_003',
     name: {
-      en: "Infant ticket free with child ticket",
-      "zh-CN": "儿童票触发婴儿票免费",
-      "zh-HK": "兒童票觸發嬰兒票免費"
+      en: 'Infant ticket free with child ticket',
+      'zh-CN': '儿童票触发婴儿票免费',
+      'zh-HK': '兒童票觸發嬰兒票免費'
     },
-    type: "promotion",
+    type: 'promotion',
     custom: {
       display: {
         product_card: {
           text: {
-            en: "Infant ticket free",
-            "zh-CN": "婴儿票免费",
-            "zh-HK": "嬰兒票免費"
+            en: 'Infant ticket free',
+            'zh-CN': '婴儿票免费',
+            'zh-HK': '嬰兒票免費'
           },
-          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: "2030-01-01 00:00:00",
-        operator: "<="
-      },
-      {
-        type: "operator",
-        field: "productIdAndVariantId",
-        value: [
-          {
-            product_id: 1001,
-            // 条件商品：儿童票
-            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: '2030-01-01 00:00:00',
+      operator: '<='
+    }, {
+      type: 'operator',
+      field: 'productIdAndVariantId',
+      value: [{
+        product_id: 1001,
+        // 条件商品：儿童票
+        product_variant_id: 0 // 0 = 匹配任意变体
+      }],
+      operator: 'product_match'
+    }],
+    actionIds: ['1']
   },
-  actions: [
-    {
-      id: "1",
-      type: "ITEM_REWARD",
-      value: {
-        rewardMethod: "free",
-        // free | percent_off | amount_off | fixed_price
-        rewardValue: 0,
-        // free 可省略；其他 rewardMethod 使用
-        quantityRule: "per_condition_quantity",
-        // per_condition_quantity | all_targets | max_per_order
-        triggerQuantity: 1,
-        // N：每满足 N 个条件商品
-        rewardQuantity: 1,
-        // Y：奖励 Y 个目标商品
-        maxRewardQuantity: 1
-        // max_per_order 使用；本例保留为配置示意
-      },
-      valueType: "object",
-      target: "product",
-      priority: 1,
-      config: {
-        rewardTargets: [
-          {
-            product_id: 2001,
-            // 奖励对象：婴儿票
-            product_variant_id: 0
-            // 0 = 匹配任意变体
-          }
-        ],
-        targetSelection: "consumer_best"
-        // consumer_best = 按可节省金额从高到低选择
-      }
+  actions: [{
+    id: '1',
+    type: 'ITEM_REWARD',
+    value: {
+      rewardMethod: 'free',
+      // free | percent_off | amount_off | fixed_price
+      rewardValue: 0,
+      // free 可省略；其他 rewardMethod 使用
+      quantityRule: 'per_condition_quantity',
+      // per_condition_quantity | all_targets | max_per_order
+      triggerQuantity: 1,
+      // N：每满足 N 个条件商品
+      rewardQuantity: 1,
+      // Y：奖励 Y 个目标商品
+      maxRewardQuantity: 1 // max_per_order 使用；本例保留为配置示意
+    },
+    valueType: 'object',
+    target: 'product',
+    priority: 1,
+    config: {
+      rewardTargets: [{
+        product_id: 2001,
+        // 奖励对象：婴儿票
+        product_variant_id: 0 // 0 = 匹配任意变体
+      }],
+      targetSelection: 'consumer_best' // consumer_best = 按可节省金额从高到低选择
     }
-  ]
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  BUY_X_GET_Y_FREE_STRATEGY,
-  ITEM_REWARD_STRATEGY,
-  X_ITEMS_FOR_Y_PRICE_STRATEGY
-});
+  }]
+};

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

@@ -0,0 +1 @@
+"use strict";