@pisell/pisellos 2.2.59 → 2.2.60

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

@@ -0,0 +1,209 @@
+/**
+ * Promotion 策略类型定义
+ *
+ * 定义促销活动相关的 Action 类型、值结构和配置
+ */
+
+// ============================================
+// Action Type 常量
+// ============================================
+
+/**
+ * 促销活动 Action 类型
+ */
+export var PROMOTION_ACTION_TYPES = {
+  /** X件Y元（每X件固定价格Y元，可累计） */
+  X_ITEMS_FOR_Y_PRICE: 'X_ITEMS_FOR_Y_PRICE',
+  /** 买X送Y（买X件送Y件，可累计） */
+  BUY_X_GET_Y_FREE: 'BUY_X_GET_Y_FREE',
+  /** 固定折扣 */
+  DISCOUNT_RATE: 'DISCOUNT_RATE',
+  /** 固定减价 */
+  DEDUCT_AMOUNT: 'DEDUCT_AMOUNT'
+};
+
+// ============================================
+// 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 联合类型
+ */
+
+// ============================================
+// 运算符常量
+// ============================================
+
+/**
+ * 促销相关运算符
+ */
+export var PROMOTION_OPERATORS = {
+  /**
+   * 商品匹配运算符
+   *
+   * 匹配规则：
+   * - 首先匹配 product_id
+   * - 如果配置的 product_variant_id = 0，只需要 product_id 匹配
+   * - 如果配置的 product_variant_id != 0，还需要 product_variant_id 匹配
+   */
+  PRODUCT_MATCH: 'product_match'
+};
+
+// ============================================
+// 业务数据类型（输入）
+// ============================================
+
+/**
+ * 促销活动业务数据
+ *
+ * 由业务层传入，用于策略评估
+ */
+
+var 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/dist/model/strategy/adapter/walletPass/evaluator.js

@@ -40,7 +40,10 @@ export var WalletPassEvaluator = /*#__PURE__*/function () {
   _createClass(WalletPassEvaluator, [{
     key: "setStrategyConfigs",
     value: function setStrategyConfigs(strategyConfigs) {
-      this.strategyConfigs = strategyConfigs;
+      var newStrategyConfigs = strategyConfigs.filter(function (item) {
+        return item.metadata.type === 'wallet_pass';
+      });
+      this.strategyConfigs = newStrategyConfigs;
     }
   }, {
     key: "getStrategyConfigs",

package/dist/model/strategy/engine.d.ts

@@ -0,0 +1,106 @@
+import { StrategyConfig, RuntimeContext, EvaluationResult, EngineOptions, OperatorHandler } from './type';
+/**
+ * 策略模型 - 核心实现
+ *
+ * 完全业务无关的通用策略引擎
+ * 支持条件评估、动作匹配、结果返回
+ */
+/**
+ * 策略引擎
+ *
+ * 核心职责：
+ * 1. 递归评估条件组
+ * 2. 收集满足条件的 actionIds
+ * 3. 根据 actionIds 获取 ActionEffect 对象
+ * 4. 按 priority 排序返回
+ */
+export declare class StrategyEngine {
+    private options;
+    private operatorHandlers;
+    constructor(options?: EngineOptions);
+    /**
+     * 评估策略
+     */
+    evaluate(config: StrategyConfig, context: RuntimeContext): EvaluationResult;
+    /**
+     * 递归评估条件组
+     *
+     * @param group 条件组
+     * @param context 运行时上下文
+     * @returns 评估结果对象，包含条件是否满足和收集到的 actionIds
+     */
+    private evaluateConditionGroup;
+    /**
+     * 评估条件组的逻辑运算
+     */
+    private evaluateGroupLogic;
+    /**
+     * 评估单个规则
+     */
+    private evaluateRule;
+    /**
+     * 评估代码模式条件
+     */
+    private evaluateCodeCondition;
+    /**
+     * 评估运算符模式条件
+     */
+    private evaluateOperatorCondition;
+    /**
+     * 获取字段值
+     */
+    private getFieldValue;
+    /**
+     * 评估内置运算符
+     */
+    private evaluateBuiltInOperator;
+    /**
+     * 根据 actionIds 获取 ActionEffect 对象
+     */
+    private getActionsByIds;
+    /**
+     * 按 priority 排序（降序）
+     */
+    private sortActionsByPriority;
+    /**
+     * 判断是否为条件组
+     */
+    private isConditionGroup;
+    /**
+     * 验证配置
+     */
+    private validateConfig;
+    /**
+     * 初始化内置运算符处理器
+     */
+    private initializeBuiltInOperators;
+    /**
+     * 评估商品匹配运算符
+     *
+     * 匹配规则：
+     * - 首先匹配 product_id
+     * - 如果配置的 product_variant_id = 0，只需要 product_id 匹配（表示任意变体）
+     * - 如果配置的 product_variant_id != 0，还需要 product_variant_id 精确匹配
+     *
+     * @param fieldValue 实际商品 { product_id: number, product_variant_id: number }
+     * @param configValue 配置的商品列表 Array<{ product_id: number, product_variant_id: number }>
+     * @returns 是否匹配
+     */
+    private evaluateProductMatch;
+    /**
+     * 注册自定义运算符
+     */
+    registerOperator(operator: string, handler: OperatorHandler): void;
+    /**
+     * 获取调试信息
+     */
+    getDebugInfo(): Record<string, any>;
+}
+/**
+ * 创建策略引擎实例
+ */
+export declare function createStrategyEngine(options?: EngineOptions): StrategyEngine;
+/**
+ * 快速评估（使用默认引擎配置）
+ */
+export declare function evaluate(config: StrategyConfig, context: RuntimeContext): EvaluationResult;