@pisell/pisellos 2.1.119 → 2.1.120

package/dist/model/strategy/adapter/promotion/examples.d.ts

@@ -0,0 +1,138 @@
+/**
+ * X件Y元策略配置示例
+ *
+ * 业务规则：
+ * - 每X件商品固定价格Y元（可累计）
+ * - 支持跨商品组合（A+B可以凑成一组）
+ * - 买5件 = 2组优惠 + 1件原价
+ *
+ * 商品匹配规则：
+ * - product_variant_id = 0 表示匹配任意变体
+ * - product_variant_id != 0 表示精确匹配该变体
+ */
+export declare const X_ITEMS_FOR_Y_PRICE_STRATEGY: {
+    metadata: {
+        id: string;
+        name: {
+            en: string;
+            'zh-CN': string;
+            'zh-HK': string;
+        };
+        type: string;
+        custom: {
+            display: {
+                product_card: {
+                    text: {
+                        en: string;
+                        'zh-CN': string;
+                        'zh-HK': string;
+                    };
+                    type: string;
+                };
+            };
+        };
+    };
+    conditions: {
+        operator: string;
+        rules: ({
+            type: string;
+            field: string;
+            value: string;
+            operator: string;
+        } | {
+            type: string;
+            field: string;
+            value: {
+                product_id: number;
+                product_variant_id: number;
+            }[];
+            operator: string;
+        })[];
+        actionIds: string[];
+    };
+    actions: {
+        id: string;
+        type: string;
+        value: {
+            x: number;
+            price: number;
+        };
+        valueType: string;
+        target: string;
+        priority: number;
+        config: {
+            allowCrossProduct: boolean;
+            cumulative: boolean;
+        };
+    }[];
+};
+/**
+ * 买X送Y策略配置示例
+ *
+ * 业务规则：
+ * - 买X件送Y件（可累计：买2送2、买3送3...）
+ * - 赠品由用户从列表中选择
+ *
+ * 商品匹配规则：
+ * - product_variant_id = 0 表示匹配任意变体
+ * - product_variant_id != 0 表示精确匹配该变体
+ */
+export declare const BUY_X_GET_Y_FREE_STRATEGY: {
+    metadata: {
+        id: string;
+        name: {
+            en: string;
+            'zh-CN': string;
+            'zh-HK': string;
+        };
+        type: string;
+        custom: {
+            display: {
+                product_card: {
+                    text: {
+                        en: string;
+                        'zh-CN': string;
+                        'zh-HK': string;
+                    };
+                    type: string;
+                };
+            };
+        };
+    };
+    conditions: {
+        operator: string;
+        rules: ({
+            type: string;
+            field: string;
+            value: string;
+            operator: string;
+        } | {
+            type: string;
+            field: string;
+            value: {
+                product_id: number;
+                product_variant_id: number;
+            }[];
+            operator: string;
+        })[];
+        actionIds: string[];
+    };
+    actions: {
+        id: string;
+        type: string;
+        value: {
+            buyQuantity: number;
+            freeQuantity: number;
+        };
+        valueType: string;
+        target: string;
+        priority: number;
+        config: {
+            cumulative: boolean;
+            giftProducts: {
+                product_id: number;
+                product_variant_id: number;
+            }[];
+        };
+    }[];
+};

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

@@ -0,0 +1,166 @@
+/**
+ * X件Y元策略配置示例
+ *
+ * 业务规则：
+ * - 每X件商品固定价格Y元（可累计）
+ * - 支持跨商品组合（A+B可以凑成一组）
+ * - 买5件 = 2组优惠 + 1件原价
+ *
+ * 商品匹配规则：
+ * - product_variant_id = 0 表示匹配任意变体
+ * - product_variant_id != 0 表示精确匹配该变体
+ */
+export var X_ITEMS_FOR_Y_PRICE_STRATEGY = {
+  metadata: {
+    id: 'STRATEGY_001',
+    name: {
+      en: '2 items for $10',
+      'zh-CN': '2杯10元',
+      'zh-HK': '2杯10元'
+    },
+    type: 'promotion',
+    custom: {
+      display: {
+        product_card: {
+          text: {
+            en: '2 for $10',
+            'zh-CN': '2杯10元',
+            'zh-HK': '2杯10元'
+          },
+          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']
+  },
+  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件原价）
+    }
+  }]
+};
+
+/**
+ * 买X送Y策略配置示例
+ *
+ * 业务规则：
+ * - 买X件送Y件（可累计：买2送2、买3送3...）
+ * - 赠品由用户从列表中选择
+ *
+ * 商品匹配规则：
+ * - product_variant_id = 0 表示匹配任意变体
+ * - product_variant_id != 0 表示精确匹配该变体
+ */
+export var BUY_X_GET_Y_FREE_STRATEGY = {
+  metadata: {
+    id: 'STRATEGY_002',
+    name: {
+      en: 'Buy 1 Get 1 Free',
+      'zh-CN': '买1送1',
+      'zh-HK': '買1送1'
+    },
+    type: 'promotion',
+    custom: {
+      display: {
+        product_card: {
+          text: {
+            en: 'Buy 1 Get 1',
+            'zh-CN': '买1送1',
+            'zh-HK': '買1送1'
+          },
+          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']
+  },
+  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
+      }]
+    }
+  }]
+};

package/dist/model/strategy/adapter/promotion/index.d.ts

@@ -0,0 +1,4 @@
+export { PromotionEvaluator } from './evaluator';
+export { PromotionAdapter } from './adapter';
+export { default } from './adapter';
+export { X_ITEMS_FOR_Y_PRICE_STRATEGY, BUY_X_GET_Y_FREE_STRATEGY, } from './examples';