@pisell/pisellos 3.0.90 → 3.0.91

package/lib/model/strategy/strategy-example.js

@@ -0,0 +1,318 @@
+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/strategy-example.ts
+var strategy_example_exports = {};
+__export(strategy_example_exports, {
+  runExamples: () => runExamples
+});
+module.exports = __toCommonJS(strategy_example_exports);
+var import_index = require("./index");
+var voucherConfig = {
+  metadata: {
+    id: "VOUCHER_10",
+    name: "10元代金券",
+    type: "wallet_pass",
+    calculationType: "single"
+  },
+  conditions: {
+    operator: "and",
+    rules: [
+      {
+        type: "operator",
+        dimension: "scope_product",
+        field: "productId",
+        operator: "in",
+        value: [60734, 60735]
+      },
+      {
+        type: "operator",
+        dimension: "scope_channel",
+        field: "channel",
+        operator: "in",
+        value: ["pos", "mini_program"]
+      },
+      {
+        type: "operator",
+        dimension: "transaction",
+        field: "applicableProductTotal",
+        operator: ">=",
+        value: 100
+      },
+      {
+        type: "operator",
+        dimension: "limit_usage",
+        field: "perUserUsedCount",
+        operator: "<",
+        value: 1
+      }
+    ],
+    actionIds: ["deduct_10"]
+  },
+  actions: [
+    {
+      id: "deduct_10",
+      type: "DEDUCT_AMOUNT",
+      value: 10,
+      valueType: "number",
+      valueUnit: "元",
+      target: "applicable_products",
+      priority: 1,
+      config: {
+        allowCrossProduct: true,
+        deductTaxAndFee: true
+      }
+    }
+  ]
+};
+var voucherContext = {
+  entities: {
+    order: {
+      id: "ORDER_001",
+      total: 150,
+      items: [
+        { productId: 60734, quantity: 2, price: 75 }
+      ]
+    },
+    customer: {
+      id: "USER_001",
+      level: "vip"
+    }
+  },
+  attributes: {
+    productId: 60734,
+    channel: "pos",
+    applicableProductTotal: 150,
+    perUserUsedCount: 0
+  },
+  metadata: {
+    timestamp: Date.now(),
+    locale: "zh-CN"
+  }
+};
+var tieredDiscountConfig = {
+  metadata: {
+    id: "TIERED_DISCOUNT",
+    name: "阶梯满减",
+    type: "promotion",
+    calculationType: "single"
+  },
+  conditions: {
+    operator: "or",
+    rules: [
+      // 档位1：100-199 减10
+      {
+        operator: "and",
+        rules: [
+          {
+            type: "operator",
+            dimension: "transaction",
+            field: "orderTotal",
+            operator: ">=",
+            value: 100
+          },
+          {
+            type: "operator",
+            dimension: "transaction",
+            field: "orderTotal",
+            operator: "<",
+            value: 200
+          }
+        ],
+        actionIds: ["deduct_10"]
+      },
+      // 档位2：200-299 减25
+      {
+        operator: "and",
+        rules: [
+          {
+            type: "operator",
+            dimension: "transaction",
+            field: "orderTotal",
+            operator: ">=",
+            value: 200
+          },
+          {
+            type: "operator",
+            dimension: "transaction",
+            field: "orderTotal",
+            operator: "<",
+            value: 300
+          }
+        ],
+        actionIds: ["deduct_25"]
+      },
+      // 档位3：>= 300 减40
+      {
+        operator: "and",
+        rules: [
+          {
+            type: "operator",
+            dimension: "transaction",
+            field: "orderTotal",
+            operator: ">=",
+            value: 300
+          }
+        ],
+        actionIds: ["deduct_40"]
+      }
+    ],
+    actionIds: []
+  },
+  actions: [
+    {
+      id: "deduct_10",
+      type: "DEDUCT_AMOUNT",
+      value: 10,
+      target: "order",
+      priority: 1
+    },
+    {
+      id: "deduct_25",
+      type: "DEDUCT_AMOUNT",
+      value: 25,
+      target: "order",
+      priority: 2
+    },
+    {
+      id: "deduct_40",
+      type: "DEDUCT_AMOUNT",
+      value: 40,
+      target: "order",
+      priority: 3
+    }
+  ]
+};
+var tieredContext = {
+  entities: {
+    order: { id: "ORDER_002", total: 250 }
+  },
+  attributes: {
+    orderTotal: 250
+  },
+  metadata: {
+    timestamp: Date.now()
+  }
+};
+var codeConditionConfig = {
+  metadata: {
+    id: "CODE_CONDITION_EXAMPLE",
+    name: "代码条件示例",
+    type: "custom"
+  },
+  conditions: {
+    operator: "and",
+    rules: [
+      // 使用 code 模式
+      {
+        type: "code",
+        code: 'attributes.orderTotal >= 100 && entities.customer.level === "vip"'
+      },
+      // 混合使用 operator 模式
+      {
+        type: "operator",
+        field: "productCount",
+        operator: ">=",
+        value: 2
+      }
+    ],
+    actionIds: ["vip_discount"]
+  },
+  actions: [
+    {
+      id: "vip_discount",
+      type: "DISCOUNT_RATE",
+      value: 0.85,
+      target: "order",
+      priority: 1
+    }
+  ]
+};
+var codeContext = {
+  entities: {
+    customer: { id: "USER_002", level: "vip" },
+    order: { id: "ORDER_003", total: 150 }
+  },
+  attributes: {
+    orderTotal: 150,
+    productCount: 3
+  },
+  metadata: {
+    timestamp: Date.now()
+  }
+};
+function runExamples() {
+  console.log("====== 策略模型使用示例 ======\n");
+  const engine = (0, import_index.createStrategyEngine)({
+    debug: true,
+    enableTrace: true
+  });
+  console.log("示例1: 10元代金券");
+  const result1 = engine.evaluate(voucherConfig, voucherContext);
+  console.log("结果:", JSON.stringify(result1, null, 2));
+  console.log("\n");
+  console.log("示例2: 阶梯满减（订单金额250）");
+  const result2 = engine.evaluate(tieredDiscountConfig, tieredContext);
+  console.log("结果:", JSON.stringify(result2, null, 2));
+  console.log("\n");
+  console.log("示例3: Code 模式条件");
+  const result3 = engine.evaluate(codeConditionConfig, codeContext);
+  console.log("结果:", JSON.stringify(result3, null, 2));
+  console.log("\n");
+  console.log("示例4: 快速评估");
+  const result4 = (0, import_index.evaluate)(voucherConfig, voucherContext);
+  console.log("适用:", result4.applicable);
+  console.log("匹配动作数:", result4.matchedActions.length);
+  console.log("\n");
+  console.log("示例5: 自定义运算符");
+  engine.registerOperator("divisible_by", (fieldValue, compareValue) => {
+    return Number(fieldValue) % Number(compareValue) === 0;
+  });
+  const customOperatorConfig = {
+    metadata: { id: "CUSTOM_OP", name: "自定义运算符", type: "test" },
+    conditions: {
+      operator: "and",
+      rules: [
+        {
+          type: "operator",
+          field: "amount",
+          operator: "divisible_by",
+          value: 10
+        }
+      ],
+      actionIds: ["bonus"]
+    },
+    actions: [{ id: "bonus", type: "ADD_POINTS", value: 100, target: "customer" }]
+  };
+  const customContext = {
+    entities: {},
+    attributes: { amount: 50 },
+    metadata: { timestamp: Date.now() }
+  };
+  const result5 = engine.evaluate(customOperatorConfig, customContext);
+  console.log("结果:", result5.applicable ? "适用" : "不适用");
+  console.log("匹配动作:", result5.matchedActions);
+  console.log("\n引擎调试信息:", engine.getDebugInfo());
+}
+if (require.main === module) {
+  runExamples();
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  runExamples
+});

package/lib/model/strategy/type.d.ts

@@ -0,0 +1,228 @@
+/**
+ * 策略配置主结构
+ */
+export interface StrategyConfig<T = Record<string, any>> {
+    /** 元信息 */
+    metadata: StrategyMetadata<T>;
+    /** 条件组（可嵌套，每层可绑定动作） */
+    conditions: ConditionGroup;
+    /** 动作列表（带唯一ID） */
+    actions: ActionEffect[];
+    /** 展示配置（可选） */
+    display?: DisplayConfig;
+}
+/**
+ * 策略元信息
+ */
+export interface StrategyMetadata<T = Record<string, any>> {
+    /** 策略ID */
+    id: string;
+    /** 策略名称 */
+    name: string | Record<string, string>;
+    /** 策略类型（完全可扩展） */
+    type: string;
+    /** 计算类型 */
+    calculationType?: 'single' | 'cumulative';
+    /** 版本 */
+    version?: string;
+    /** 描述 */
+    description?: string | Record<string, string>;
+    /** 自定义元数据 */
+    custom?: T;
+}
+/**
+ * 条件组（支持嵌套）
+ */
+export interface ConditionGroup {
+    /** 逻辑运算符 */
+    operator: 'and' | 'or' | 'not';
+    /** 条件规则列表（可以是单条件或嵌套的条件组） */
+    rules: Array<ConditionRule | ConditionGroup>;
+    /** 关联的动作ID列表（必填，可以为空数组） */
+    actionIds: string[];
+}
+/**
+ * 条件规则（原子条件）
+ * 支持 code 模式使用 eval 执行
+ */
+export interface ConditionRule {
+    /** 类型 */
+    type: 'code' | 'operator';
+    /** 代码（code模式使用，使用eval执行） */
+    code?: string;
+    /** 维度（完全可扩展） */
+    dimension?: string;
+    /** 字段名 */
+    field?: string;
+    /** 运算符 */
+    operator?: string;
+    /** 比较值 */
+    value?: any;
+    /** 值类型 */
+    valueType?: 'number' | 'string' | 'boolean' | 'array' | 'object' | 'date';
+    /** 值单位 */
+    valueUnit?: string;
+    /** 额外配置 */
+    config?: Record<string, any>;
+}
+/**
+ * 动作效果
+ */
+export interface ActionEffect {
+    /** 动作的唯一标识 */
+    id: string;
+    /** 效果类型（完全可扩展） */
+    type: string;
+    /** 运算符（可选） */
+    operator?: string;
+    /** 值 */
+    value: any;
+    /** 值类型 */
+    valueType?: 'number' | 'string' | 'boolean' | 'array' | 'object';
+    /** 值单位 */
+    valueUnit?: string;
+    /** 作用目标 */
+    target: string;
+    /** 优先级（数字越大优先级越高） */
+    priority?: number;
+    /** 配置（完全可扩展） */
+    config?: Record<string, any>;
+}
+/**
+ * 展示配置
+ */
+export interface DisplayConfig {
+    /** 商品卡片展示 */
+    productCard?: {
+        text: string | Record<string, string>;
+        type: 'tag' | 'badge' | 'label';
+        image?: string;
+        style?: Record<string, any>;
+    };
+    /** 详情页展示 */
+    detail?: {
+        title: string | Record<string, string>;
+        description: string | Record<string, string>;
+        image?: string;
+    };
+    /** 自定义展示配置 */
+    custom?: Record<string, any>;
+}
+/**
+ * 运行时上下文结构
+ */
+export interface RuntimeContext {
+    /** 实体数据（完全开放，由业务层定义） */
+    entities: Record<string, any>;
+    /** 属性数据（扁平化的计算值，用于条件判断） */
+    attributes: Record<string, any>;
+    /** 上下文元数据 */
+    metadata: ContextMetadata;
+}
+/**
+ * 上下文元数据
+ */
+export interface ContextMetadata {
+    /** 请求ID（用于追踪） */
+    requestId?: string;
+    /** 时间戳 */
+    timestamp: number;
+    /** 语言 */
+    locale?: string;
+    /** 自定义元数据 */
+    custom?: Record<string, any>;
+}
+/**
+ * 评估结果结构
+ */
+export interface EvaluationResult {
+    /** 是否成功执行（引擎层面） */
+    success: boolean;
+    /** 策略是否适用（业务层面） */
+    applicable: boolean;
+    /** 结果码 */
+    code: string;
+    /** 消息（多语言key或直接文本） */
+    message?: string;
+    /** 匹配信息 */
+    matched: MatchedInfo;
+    /** 匹配的动作列表（按priority排序） */
+    matchedActions: ActionEffect[];
+    /** 输出结果（完全开放，由适配器定义） */
+    outputs: Record<string, any>;
+    /** 执行轨迹（可选，用于调试） */
+    trace?: ExecutionTrace;
+    /** 策略配置 */
+    config: StrategyConfig;
+}
+/**
+ * 匹配信息
+ */
+export interface MatchedInfo {
+    /** 条件是否满足 */
+    conditions: boolean;
+    /** 收集到的 actionIds */
+    actionIds: string[];
+    /** 详细匹配信息 */
+    details: Record<string, any>;
+}
+/**
+ * 执行轨迹
+ */
+export interface ExecutionTrace {
+    /** 执行步骤 */
+    steps: TraceStep[];
+    /** 总耗时（毫秒） */
+    duration: number;
+    /** 错误信息 */
+    errors?: Array<{
+        step: string;
+        error: string;
+        timestamp: number;
+    }>;
+}
+/**
+ * 追踪步骤
+ */
+export interface TraceStep {
+    /** 步骤名称 */
+    step: string;
+    /** 步骤状态 */
+    status: 'success' | 'failed' | 'skipped';
+    /** 耗时（毫秒） */
+    duration: number;
+    /** 详细信息 */
+    details?: Record<string, any>;
+}
+/** 成功码 */
+export declare const SUCCESS_CODES: {
+    readonly SUCCESS: "SUCCESS";
+};
+/** 不适用码 */
+export declare const NOT_APPLICABLE_CODES: {
+    readonly CONDITION_NOT_MET: "CONDITION_NOT_MET";
+};
+/** 错误码 */
+export declare const ERROR_CODES: {
+    readonly INVALID_CONFIG: "INVALID_CONFIG";
+    readonly INVALID_CONTEXT: "INVALID_CONTEXT";
+    readonly EVALUATION_ERROR: "EVALUATION_ERROR";
+    readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
+};
+/**
+ * 引擎配置选项
+ */
+export interface EngineOptions {
+    /** 是否启用调试模式 */
+    debug?: boolean;
+    /** 是否启用追踪 */
+    enableTrace?: boolean;
+    /** 运算符处理器映射 */
+    operatorHandlers?: Record<string, OperatorHandler>;
+    /** 自定义错误处理器 */
+    errorHandler?: (error: Error, context: RuntimeContext) => void;
+}
+/**
+ * 运算符处理器
+ */
+export type OperatorHandler = (fieldValue: any, compareValue: any, rule: ConditionRule) => boolean;

package/lib/model/strategy/type.js

@@ -0,0 +1,44 @@
+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/type.ts
+var type_exports = {};
+__export(type_exports, {
+  ERROR_CODES: () => ERROR_CODES,
+  NOT_APPLICABLE_CODES: () => NOT_APPLICABLE_CODES,
+  SUCCESS_CODES: () => SUCCESS_CODES
+});
+module.exports = __toCommonJS(type_exports);
+var SUCCESS_CODES = {
+  SUCCESS: "SUCCESS"
+};
+var NOT_APPLICABLE_CODES = {
+  CONDITION_NOT_MET: "CONDITION_NOT_MET"
+};
+var ERROR_CODES = {
+  INVALID_CONFIG: "INVALID_CONFIG",
+  INVALID_CONTEXT: "INVALID_CONTEXT",
+  EVALUATION_ERROR: "EVALUATION_ERROR",
+  UNKNOWN_ERROR: "UNKNOWN_ERROR"
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ERROR_CODES,
+  NOT_APPLICABLE_CODES,
+  SUCCESS_CODES
+});

package/lib/modules/Cart/utils/cartProduct.js

@@ -313,6 +313,7 @@ var formatBundleToOrigin = (bundle) => {
       option: formatOptionsToOrigin(getBundleValueByKey("option")),
       discount_list: d.discount_list,
       "bundle_selling_price": d == null ? void 0 : d.price,
+      // "custom_price": d?.price,
       metadata: {
         custom_product_bundle_map_id: d._id,
         product_discount_difference

package/lib/modules/Discount/index.d.ts

@@ -1,6 +1,6 @@
 import { Module, PisellCore, ModuleOptions } from '../../types';
 import { BaseModule } from '../BaseModule';
-import { Discount, DiscountModuleAPI } from './types';
+import { Discount, DiscountModuleAPI, DiscountWithReason } from './types';
 export declare class DiscountModule extends BaseModule implements Module, DiscountModuleAPI {
     protected defaultName: string;
     protected defaultVersion: string;
@@ -24,9 +24,11 @@ export declare class DiscountModule extends BaseModule implements Module, Discou
         with_wallet_pass_holder: 0 | 1;
         request_timezone: string;
     }): Promise<Discount[]>;
-    batchSearch(code: string, customerId?: number): Promise<Discount[]>;
+    batchSearch(code: string, customerId?: number): Promise<DiscountWithReason>;
     filterEnabledDiscountList(discountList: Discount[]): Discount[];
     private checkUsageCreditsLimit;
+    filterEnabledDiscountListWithReason(discountList: Discount[]): DiscountWithReason;
+    private checkUsageCreditsLimitWithFailKey;
     uniqueByProductId(discountList: Discount[]): Discount[];
     filterDiscountListByProductIds(discountList: Discount[], productIds: number[]): Discount[];
     calcDiscountApplicableProductTotalPrice(discount: Discount): number | undefined;

package/lib/modules/Discount/index.js

@@ -114,8 +114,8 @@ var DiscountModule = class extends import_BaseModule.BaseModule {
       order_behavior_count_customer_id: customerId || 1,
       request_timezone: Intl.DateTimeFormat().resolvedOptions().timeZone
     });
-    const resultDiscountList = this.filterEnabledDiscountList((result == null ? void 0 : result.data) || []) || [];
-    return resultDiscountList;
+    const resultDiscountWithReason = this.filterEnabledDiscountListWithReason((result == null ? void 0 : result.data) || []) || [];
+    return resultDiscountWithReason;
   }
   filterEnabledDiscountList(discountList) {
     return discountList.filter(
@@ -161,6 +161,64 @@ var DiscountModule = class extends import_BaseModule.BaseModule {
     }
     return true;
   }
+  // 过滤启用且可用的优惠券，并返回校验失败原因
+  filterEnabledDiscountListWithReason(discountList) {
+    let lists = discountList.filter((discount) => discount.limit_status === "enable").filter((discount) => {
+      const remaining = new import_decimal.default((discount == null ? void 0 : discount.par_value) || 0).minus(new import_decimal.default((discount == null ? void 0 : discount.used_par_value) || 0)).greaterThan(0);
+      return remaining;
+    }).map((discount) => {
+      const limitFailKey = this.checkUsageCreditsLimitWithFailKey(discount);
+      return {
+        ...discount,
+        usageLimitFailKey: limitFailKey
+      };
+    });
+    const availableLists = lists.filter((item) => !item.usageLimitFailKey);
+    const currentFailDiscount = lists.find((item) => item.usageLimitFailKey);
+    return {
+      discountList: availableLists,
+      unavailableReasonKey: currentFailDiscount == null ? void 0 : currentFailDiscount.usageLimitFailKey
+    };
+  }
+  // 检查使用次数限制，并返回校验失败原因
+  checkUsageCreditsLimitWithFailKey(discount) {
+    if (!discount.extension_data || discount.extension_data.length === 0) {
+      return null;
+    }
+    const usageCreditsData = discount.extension_data.find(
+      (data) => data.field_key === "usage_credits"
+    );
+    if (!usageCreditsData) {
+      return null;
+    }
+    const value = usageCreditsData.value;
+    if (value.total_credits && value.total_credits > 0) {
+      if ((discount.total_order_behavior_count || 0) >= value.total_credits) {
+        return "total_credits";
+      }
+    }
+    if (value.per_user_limit && value.per_user_limit > 0) {
+      if ((discount.customer_order_behavior_count || 0) >= value.per_user_limit) {
+        return "per_user_limit";
+      }
+    }
+    if (value.max_per_day && value.max_per_day > 0) {
+      if ((discount.today_order_behavior_count || 0) >= value.max_per_day) {
+        return "max_per_day";
+      }
+    }
+    if (value.max_per_week && value.max_per_week > 0) {
+      if ((discount.week_order_behavior_count || 0) >= value.max_per_week) {
+        return "max_per_week";
+      }
+    }
+    if (value.max_per_month && value.max_per_month > 0) {
+      if ((discount.month_order_behavior_count || 0) >= value.max_per_month) {
+        return "max_per_month";
+      }
+    }
+    return null;
+  }
   // 根据productIds去重
   uniqueByProductId(discountList) {
     return (0, import_utils.uniqueById)(discountList, "product_id");