@pisell/pisellos 1.0.142 → 1.0.143

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

@@ -0,0 +1,447 @@
+import { StrategyConfig } from '../../type';
+/**
+ * Promotion 策略类型定义
+ *
+ * 定义促销活动相关的 Action 类型、值结构和配置
+ */
+/**
+ * 促销活动 Action 类型
+ */
+export declare const PROMOTION_ACTION_TYPES: {
+    /** X件Y元（每X件固定价格Y元，可累计） */
+    readonly X_ITEMS_FOR_Y_PRICE: "X_ITEMS_FOR_Y_PRICE";
+    /** 买X送Y（买X件送Y件，可累计） */
+    readonly BUY_X_GET_Y_FREE: "BUY_X_GET_Y_FREE";
+    /** 固定折扣 */
+    readonly DISCOUNT_RATE: "DISCOUNT_RATE";
+    /** 固定减价 */
+    readonly DEDUCT_AMOUNT: "DEDUCT_AMOUNT";
+};
+export type PromotionActionType = (typeof PROMOTION_ACTION_TYPES)[keyof typeof PROMOTION_ACTION_TYPES];
+/**
+ * X件Y元 - Action Value
+ *
+ * @example
+ * value: { x: 2, price: 10 }  // 每2件10元
+ */
+export interface XItemsForYPriceValue {
+    /** 每X件（需要凑满的数量） */
+    x: number;
+    /** 固定价格Y元 */
+    price: number;
+}
+/**
+ * X件Y元 - Action Config
+ */
+export interface XItemsForYPriceConfig {
+    /** 允许跨商品组合（A+B可以凑成一组） */
+    allowCrossProduct?: boolean;
+    /** 可累计（买5件 = 2组优惠 + 1件原价） */
+    cumulative?: boolean;
+}
+/**
+ * 买X送Y - Action Value
+ *
+ * @example
+ * value: { buyQuantity: 1, freeQuantity: 1 }  // 买1送1
+ */
+export interface BuyXGetYFreeValue {
+    /** 买X件 */
+    buyQuantity: number;
+    /** 送Y件 */
+    freeQuantity: number;
+}
+/**
+ * 赠品选择模式
+ */
+export type GiftSelectionMode = 'user_select' | 'auto' | 'cheapest';
+/**
+ * 买X送Y - Action Config
+ */
+export interface BuyXGetYFreeConfig {
+    /** 赠品选择模式 */
+    giftSelectionMode?: GiftSelectionMode;
+    /** 可累计（买2送2、买3送3...） */
+    cumulative?: boolean;
+    /** 可选的赠品列表 */
+    giftProducts?: ProductIdentifier[];
+}
+/**
+ * 商品标识
+ *
+ * 匹配规则：
+ * - product_variant_id = 0 表示匹配任意变体
+ * - product_variant_id != 0 表示精确匹配该变体
+ */
+export interface ProductIdentifier {
+    /** 商品ID */
+    product_id: number;
+    /**
+     * 变体ID
+     * - 0 表示匹配任意变体
+     * - 非0 表示精确匹配该变体
+     */
+    product_variant_id: number;
+}
+import { ActionEffect } from '../../type';
+/**
+ * X件Y元 Action
+ */
+export interface XItemsForYPriceAction extends Omit<ActionEffect, 'type' | 'value' | 'config'> {
+    type: typeof PROMOTION_ACTION_TYPES.X_ITEMS_FOR_Y_PRICE;
+    value: XItemsForYPriceValue;
+    valueType: 'object';
+    config?: XItemsForYPriceConfig;
+}
+/**
+ * 买X送Y Action
+ */
+export interface BuyXGetYFreeAction extends Omit<ActionEffect, 'type' | 'value' | 'config'> {
+    type: typeof PROMOTION_ACTION_TYPES.BUY_X_GET_Y_FREE;
+    value: BuyXGetYFreeValue;
+    valueType: 'object';
+    config?: BuyXGetYFreeConfig;
+}
+/**
+ * 促销活动 Action 联合类型
+ */
+export type PromotionAction = XItemsForYPriceAction | BuyXGetYFreeAction;
+/**
+ * 促销相关运算符
+ */
+export declare const PROMOTION_OPERATORS: {
+    /**
+     * 商品匹配运算符
+     *
+     * 匹配规则：
+     * - 首先匹配 product_id
+     * - 如果配置的 product_variant_id = 0，只需要 product_id 匹配
+     * - 如果配置的 product_variant_id != 0，还需要 product_variant_id 匹配
+     */
+    readonly PRODUCT_MATCH: "product_match";
+};
+/**
+ * 促销活动业务数据
+ *
+ * 由业务层传入，用于策略评估
+ */
+export interface PromotionBusinessData {
+    /** 商品列表 */
+    products: PromotionProduct[];
+    /** 当前评估的商品（用于单商品场景，如商品卡片展示） */
+    currentProduct?: PromotionProduct;
+    /** 渠道 */
+    channel?: string;
+    /** 自定义属性 */
+    custom?: Record<string, any>;
+}
+type ProductBundleItem = {
+    /** 主商品ID */
+    product_id: number;
+    /** 变体ID（0 表示无变体） */
+    product_variant_id: number;
+    /** 数量 */
+    quantity: number;
+    /** 单价 */
+    price: number;
+    /** 原价 */
+    original_price?: number;
+    /** 套餐明细id */
+    id: number;
+    /** 套餐商品id */
+    _bundle_product_id: number;
+};
+/**
+ * 促销商品信息
+ */
+export interface PromotionProduct {
+    id: number;
+    /** 商品ID */
+    product_id: number;
+    /** 变体ID（0 表示无变体） */
+    product_variant_id: number;
+    /** 商品名称 */
+    name?: string;
+    /** 单价 */
+    price: number;
+    /** 商品套餐 */
+    bundle: ProductBundleItem[];
+    /** 数量 */
+    quantity: number;
+    /** 原价 */
+    original_price?: number;
+}
+/**
+ * 促销活动适配器转换结果
+ *
+ * 返回给业务层，包含策略匹配信息
+ */
+export interface PromotionTransformResult {
+    /** 策略是否适用 */
+    isApplicable: boolean;
+    /** 匹配的 Action 类型 */
+    actionType?: PromotionActionType;
+    /** 匹配的 Action 详情 */
+    actionDetail?: PromotionActionDetail;
+    /** 适用的商品列表（从购物车商品中筛选出的适用商品） */
+    applicableProducts: PromotionProduct[];
+    /** 不适用的原因 */
+    reason?: string;
+    /** 不适用的原因码 */
+    reasonCode?: string;
+    /** 原始策略引擎结果 */
+    strategyResult: import('../../type').EvaluationResult;
+}
+/**
+ * Action 详情联合类型
+ */
+export type PromotionActionDetail = XItemsForYPriceActionDetail | BuyXGetYFreeActionDetail;
+/**
+ * X件Y元 Action 详情
+ */
+export interface XItemsForYPriceActionDetail {
+    type: typeof PROMOTION_ACTION_TYPES.X_ITEMS_FOR_Y_PRICE;
+    /** 每X件 */
+    x: number;
+    /** 固定价格Y元 */
+    price: number;
+    /** 允许跨商品组合 */
+    allowCrossProduct: boolean;
+    /** 可累计 */
+    cumulative: boolean;
+}
+/**
+ * 买X送Y Action 详情
+ */
+export interface BuyXGetYFreeActionDetail {
+    type: typeof PROMOTION_ACTION_TYPES.BUY_X_GET_Y_FREE;
+    /** 买X件 */
+    buyQuantity: number;
+    /** 送Y件 */
+    freeQuantity: number;
+    /** 赠品选择模式 */
+    giftSelectionMode: GiftSelectionMode;
+    /** 可累计 */
+    cumulative: boolean;
+    /** 可选的赠品列表 */
+    giftProducts: ProductIdentifier[];
+}
+/**
+ * X件Y元 - 业务层计算结果
+ *
+ * 由业务层根据 matchedAction 计算后返回
+ */
+export interface XItemsForYPriceResult {
+    /** 满足条件的组数 */
+    groupCount: number;
+    /** 剩余件数（原价） */
+    remainingCount: number;
+    /** 优惠金额 */
+    discountAmount: number;
+    /** 分组详情 */
+    groups: Array<{
+        products: Array<{
+            product_id: number;
+            product_variant_id: number;
+            originalPrice: number;
+        }>;
+        originalTotal: number;
+        discountedPrice: number;
+    }>;
+}
+/**
+ * 买X送Y - 业务层计算结果
+ *
+ * 由业务层根据 matchedAction 计算后返回
+ */
+export interface BuyXGetYFreeResult {
+    /** 可送的赠品数量 */
+    freeCount: number;
+    /** 需要用户选择的赠品数量 */
+    pendingSelectCount: number;
+    /** 已选择的赠品 */
+    selectedGifts: ProductIdentifier[];
+    /** 可选的赠品列表 */
+    availableGifts: ProductIdentifier[];
+}
+/**
+ * 评估器输入
+ */
+export interface PromotionEvaluatorInput {
+    /** 商品列表 */
+    products: PromotionProduct[];
+    /** 策略配置列表（可选，如果不传则使用 setStrategyConfigs 设置的） */
+    strategyConfigs?: StrategyConfig[];
+    /** 渠道 */
+    channel?: string;
+}
+/**
+ * 单商品评估结果
+ */
+export interface ProductPromotionResult {
+    /** 商品信息 */
+    product: PromotionProduct;
+    /** 适用的促销列表 */
+    applicablePromotions: ApplicablePromotion[];
+    /** 是否有适用的促销 */
+    hasPromotion: boolean;
+}
+/**
+ * 适用的促销信息
+ */
+export interface ApplicablePromotion {
+    /** 策略ID */
+    strategyId: string;
+    /** 策略名称 */
+    strategyName: string | Record<string, string>;
+    /** Action 类型 */
+    actionType: string;
+    /** Action 详情 */
+    actionDetail: PromotionActionDetail;
+    /** 展示配置 */
+    display?: {
+        text: string | Record<string, string>;
+        type: string;
+    };
+    /** 原始策略配置 */
+    strategyConfig: StrategyConfig;
+    /** 匹配的 bundle 子商品索引（如果是 bundle 子商品匹配） */
+    matchedBundleIndex?: number;
+    /** 满足促销所需的商品数量 */
+    requiredQuantity?: number;
+    /** 参与促销的商品列表 */
+    eligibleProducts?: ProductIdentifier[];
+}
+/**
+ * 购物车评估结果
+ */
+export interface CartEvaluationResult {
+    /** 每个商品的促销结果 */
+    productResults: ProductPromotionResult[];
+    /** 购物车中所有适用的促销（去重） */
+    applicablePromotions: CartApplicablePromotion[];
+    /** 按促销分组的商品 */
+    promotionGroups: PromotionGroup[];
+}
+/**
+ * 购物车适用的促销
+ */
+export interface CartApplicablePromotion extends ApplicablePromotion {
+    /** 适用此促销的商品列表 */
+    applicableProducts: PromotionProduct[];
+    /** 适用商品的总数量 */
+    totalQuantity: number;
+    /** 适用商品的总金额 */
+    totalAmount: number;
+    /** 商品ID -> 匹配的 bundle 子商品索引映射 */
+    productMatchedBundleIndexMap?: Map<number, number | undefined>;
+}
+/**
+ * 促销分组
+ */
+export interface PromotionGroup {
+    /** 策略ID */
+    strategyId: string;
+    /** 策略名称 */
+    strategyName: string | Record<string, string>;
+    /** 策略元数据 */
+    strategyMetadata?: StrategyConfig['metadata'];
+    /** 原始策略配置 */
+    strategyConfig?: StrategyConfig;
+    /** Action 类型 */
+    actionType: string;
+    /** Action 详情 */
+    actionDetail: PromotionActionDetail;
+    /** 分组内的商品 */
+    products: PromotionProduct[];
+    /** 商品总数量 */
+    totalQuantity: number;
+    /** 商品总金额 */
+    totalAmount: number;
+    /** 商品ID -> 匹配的 bundle 子商品索引映射 */
+    productMatchedBundleIndexMap?: Map<number, number | undefined>;
+}
+/**
+ * 带定价的商品
+ *
+ * 在 PromotionProduct 基础上增加了均摊后的最终价格和促销信息
+ */
+export interface PricedProduct extends PromotionProduct {
+    /**
+     * 原始商品ID
+     * 当商品被拆分时，此字段记录拆分前的原始商品id
+     * 例如 A*5 拆成 A*4（参与促销）+ A*1（原价），A*4 的 originalId 指向原始 A 的 id
+     */
+    originalId?: number;
+    /**
+     * 最终单价（均摊后）
+     * - 参与促销的商品：按原价比例均摊后的价格
+     * - 未参与促销的商品：等于 price
+     */
+    finalPrice: number;
+    /**
+     * 应用的策略ID
+     * 如果商品参与了促销，记录对应的策略ID
+     */
+    strategyId?: string;
+    /**
+     * 应用的策略元数据
+     * 如果商品参与了促销，记录对应策略的 metadata
+     */
+    strategyMetadata?: StrategyConfig['metadata'];
+    /**
+     * 是否参与了促销
+     */
+    inPromotion: boolean;
+    /**
+     * 是否为拆分出来的商品
+     * true 表示这是从原商品拆分出来的新记录
+     */
+    isSplit?: boolean;
+    /**
+     * 匹配的 bundle 子商品索引
+     * 如果促销匹配的是 bundle 子商品而非主商品，记录对应的 bundle 索引
+     * undefined 表示匹配的是主商品
+     */
+    matchedBundleIndex?: number;
+}
+/**
+ * 赠品信息
+ *
+ * 记录某个促销产生的赠品数量和可选赠品列表
+ */
+export interface GiftInfo {
+    /** 策略ID */
+    strategyId: string;
+    /** 策略名称 */
+    strategyName: string | Record<string, string>;
+    /** 可送赠品数量 */
+    giftCount: number;
+    /** 可选赠品列表 */
+    giftOptions: ProductIdentifier[];
+}
+/**
+ * 带定价的购物车评估结果
+ *
+ * evaluateCartWithPricing 方法的返回结果
+ */
+export interface CartWithPricingResult {
+    /**
+     * 处理后的商品数组
+     * - 包含所有商品（参与促销和未参与促销的）
+     * - 参与促销的商品可能被拆分（如 A*5 拆成 A*4 + A*1）
+     * - 每个商品都有 finalPrice 字段
+     */
+    products: PricedProduct[];
+    /**
+     * 赠品信息列表
+     * 按促销分组，每个促销对应一个 GiftInfo
+     */
+    gifts: GiftInfo[];
+    /**
+     * 总优惠金额
+     * 所有商品的原价总和 - 所有商品的 finalPrice 总和
+     */
+    totalDiscount: number;
+}
+export {};

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

@@ -0,0 +1,51 @@
+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/adapter/promotion/type.ts
+var type_exports = {};
+__export(type_exports, {
+  PROMOTION_ACTION_TYPES: () => PROMOTION_ACTION_TYPES,
+  PROMOTION_OPERATORS: () => PROMOTION_OPERATORS
+});
+module.exports = __toCommonJS(type_exports);
+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"
+};
+var PROMOTION_OPERATORS = {
+  /**
+   * 商品匹配运算符
+   *
+   * 匹配规则：
+   * - 首先匹配 product_id
+   * - 如果配置的 product_variant_id = 0，只需要 product_id 匹配
+   * - 如果配置的 product_variant_id != 0，还需要 product_variant_id 匹配
+   */
+  PRODUCT_MATCH: "product_match"
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PROMOTION_ACTION_TYPES,
+  PROMOTION_OPERATORS
+});

package/lib/model/strategy/adapter/walletPass/evaluator.d.ts

@@ -8,10 +8,12 @@ export declare class WalletPassEvaluator {
     private engine;
     private strategyConfigs;
     private locale;
+    private otherParams;
     constructor();
     setStrategyConfigs(strategyConfigs: StrategyConfig[]): void;
     getStrategyConfigs(): StrategyConfig[];
     setLocale(locale: string): void;
+    setOtherParams(otherParams: any): void;
     getText(key: string): string;
     /**
      * 搜索券的格式

package/lib/model/strategy/adapter/walletPass/evaluator.js

@@ -42,19 +42,38 @@ var defaultStrategyMetadataCustom = {
   allowCrossProduct: true,
   applicableProductLimit: 0,
   deductTaxAndFee: true,
-  maxPassesPerItem: 0
+  maxPassesPerItem: 0,
+  deductOptionPrice: false
 };
+var FIELD_REASON_CODE_MAP = {
+  orderTotalAmount: "order_total_amount_not_enough",
+  applicableProductTotalAmount: "applicable_product_total_amount_not_enough",
+  applicableProductCount: "applicable_product_count_not_enough"
+};
+var AMOUNT_FIELDS = /* @__PURE__ */ new Set([
+  "orderTotalAmount",
+  "applicableProductTotalAmount"
+]);
+function formatReason(template, value, currency = "") {
+  if (!template)
+    return template;
+  const v = value === void 0 || value === null ? "" : String(value);
+  const c = currency === void 0 || currency === null ? "" : String(currency);
+  return template.replace(/\$\{value\}/g, () => v).replace(/\{value\}/g, () => v).replace(/\{currency\}/g, () => c);
+}
 var WalletPassEvaluator = class {
   constructor() {
     this.strategyConfigs = [];
     this.locale = "en";
+    this.otherParams = {};
     this.engine = new import__.StrategyEngine({
       debug: false,
       enableTrace: false
     });
   }
   setStrategyConfigs(strategyConfigs) {
-    this.strategyConfigs = strategyConfigs;
+    const newStrategyConfigs = strategyConfigs.filter((item) => item.metadata.type === "wallet_pass");
+    this.strategyConfigs = newStrategyConfigs;
   }
   getStrategyConfigs() {
     return this.strategyConfigs;
@@ -62,6 +81,9 @@ var WalletPassEvaluator = class {
   setLocale(locale) {
     this.locale = locale;
   }
+  setOtherParams(otherParams) {
+    this.otherParams = otherParams;
+  }
   getText(key) {
     var _a, _b;
     return (_b = (_a = import_locales.locales) == null ? void 0 : _a[this.locale]) == null ? void 0 : _b[key];
@@ -99,7 +121,7 @@ var WalletPassEvaluator = class {
    * 评估可用的 vouchers
    */
   evaluate(input) {
-    var _a, _b;
+    var _a, _b, _c, _d, _e, _f, _g;
     const { orderTotalAmount, products, vouchers, strategyConfigs } = input;
     const productIds = products.map((p) => p.product_id);
     const results = [];
@@ -174,7 +196,13 @@ var WalletPassEvaluator = class {
         });
       } else {
         let reasonCode = "not_meet_the_required_conditions";
-        if (evaluationResult.code) {
+        let thresholdValue = void 0;
+        const failedField = (_c = evaluationResult.matched) == null ? void 0 : _c.failedField;
+        const failedRule = (_e = (_d = evaluationResult.matched) == null ? void 0 : _d.failedRules) == null ? void 0 : _e[0];
+        if (failedField && FIELD_REASON_CODE_MAP[failedField]) {
+          reasonCode = FIELD_REASON_CODE_MAP[failedField];
+          thresholdValue = failedRule == null ? void 0 : failedRule.value;
+        } else if (evaluationResult.code) {
           const codeMapping = {
             INSUFFICIENT_AMOUNT: "not_meet_the_required_conditions",
             USAGE_LIMIT_EXCEEDED: "usage_limit_reached",
@@ -184,6 +212,10 @@ var WalletPassEvaluator = class {
           };
           reasonCode = codeMapping[evaluationResult.code] || "not_meet_the_required_conditions";
         }
+        const rawText = this.getText(reasonCode);
+        const currency = failedField && AMOUNT_FIELDS.has(failedField) ? ((_g = (_f = this.otherParams) == null ? void 0 : _f.getData) == null ? void 0 : _g.call(_f, "shop_symbol")) || "" : "";
+        console.log(currency, "currency12345");
+        const reason = thresholdValue !== void 0 ? formatReason(rawText, thresholdValue, currency) : rawText;
         results.push({
           voucher,
           isApplicable: false,
@@ -191,7 +223,7 @@ var WalletPassEvaluator = class {
           maxDeduction: 0,
           deductTaxAndFee: false,
           applicableProductIds: [],
-          reason: this.getText(reasonCode),
+          reason,
           reasonCode,
           strategyResult: evaluationResult
         });
@@ -384,6 +416,7 @@ var WalletPassEvaluator = class {
    * 计算适用商品的总金额和数量
    */
   calculateApplicableProducts(products, applicableProductIds, deductTaxAndFee) {
+    console.log(products, "products1234");
     let total = 0;
     let count = 0;
     if (applicableProductIds !== null && applicableProductIds.length === 0) {

package/lib/model/strategy/adapter/walletPass/locales.js

@@ -29,7 +29,10 @@ var locales = {
     "usage_limit_reached": "已达到使用次数上限",
     "max_passes_per_item_reached": "该商品已达到卡券使用上限",
     "not_available_for_this_channel": "当前渠道不可使用",
-    "not_valid_for_this_order_type": "当前订单类型不适用"
+    "not_valid_for_this_order_type": "当前订单类型不适用",
+    "order_total_amount_not_enough": "满 {currency}{value} 可用",
+    "applicable_product_total_amount_not_enough": "满 {currency}{value} 可用",
+    "applicable_product_count_not_enough": "至少 {value} 件"
   },
   "en": {
     "not_meet_the_required_conditions": "Not meet the required conditions.",
@@ -37,7 +40,10 @@ var locales = {
     "usage_limit_reached": "Usage limit reached.",
     "max_passes_per_item_reached": "Max passes per item reached.",
     "not_available_for_this_channel": "Not available for this channel.",
-    "not_valid_for_this_order_type": "Not valid for this order type."
+    "not_valid_for_this_order_type": "Not valid for this order type.",
+    "order_total_amount_not_enough": "Spend {currency}{value} to use",
+    "applicable_product_total_amount_not_enough": "Spend {currency}{value} to use",
+    "applicable_product_count_not_enough": "Min. Qty {value}"
   },
   "zh-HK": {
     "not_meet_the_required_conditions": "未達使用條件",
@@ -45,7 +51,10 @@ var locales = {
     "usage_limit_reached": "已達使用次數上限",
     "max_passes_per_item_reached": "該商品已達卡券使用上限",
     "not_available_for_this_channel": "當前渠道不可使用",
-    "not_valid_for_this_order_type": "當前訂單類型不適用"
+    "not_valid_for_this_order_type": "當前訂單類型不適用",
+    "order_total_amount_not_enough": "滿 {currency}{value} 可用",
+    "applicable_product_total_amount_not_enough": "滿 {currency}{value} 可用",
+    "applicable_product_count_not_enough": "至少 {value} 件"
   }
 };
 // Annotate the CommonJS export names for ESM import in node:

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

@@ -41,8 +41,10 @@ export interface Voucher {
         allowCrossProduct: boolean;
         /** 可用商品数量上限 （仅多商品） 默认为0，表示不限制商品数量。 */
         applicableProductLimit: number;
-        /** 单商品可用卡券上限（同一 Wallet Pass 商品生成的卡券对同一商品行最多抵扣次数）。默认为 0，表示不限制。 */
+        /** 单订单行每单位可用同一 Wallet Pass 券次数；该行总券次上限 = maxPassesPerItem × 该行 quantity（按行唯一键区分）。0 表示不限制。 */
         maxPassesPerItem: number;
+        /** 是否抵扣单规格价格 (Option Price)，默认 false。开启后折扣范围包含 option 的 add_price */
+        deductOptionPrice: boolean;
     };
 }
 /**
@@ -50,6 +52,10 @@ export interface Voucher {
  */
 export interface Product {
     product_id: number;
+    /** 订单明细 id，参与行唯一键兜底解析 */
+    id?: number;
+    /** 行级唯一串，参与行唯一键解析 */
+    product_unique_string?: string;
     price: number;
     quantity: number;
     name?: string;
@@ -58,9 +64,19 @@ export interface Product {
     main_product_original_price?: number;
     /** 主商品折扣后金额，不包含套餐子商品 */
     main_product_selling_price?: number;
+    /** 单规格（Option）列表 */
+    product_options?: {
+        id: number;
+        add_price: number | string;
+        num: number;
+        [key: string]: any;
+    }[];
     /** 主商品税费 */
     tax_fee: number;
     metadata: {
+        /** 行唯一标识，优先用于 Wallet Pass 按行配额 */
+        product_unique?: string;
+        unique_identification_number?: string;
         main_product_attached_bundle_tax_fee?: number;
         main_product_attached_bundle_surcharge_fee?: number;
         surcharge_rounding_remainder?: number;
@@ -132,8 +148,10 @@ export interface EvaluatorInput {
         allowCrossProduct: boolean;
         /** 可用商品数量上限 （仅多商品） 默认为0，表示不限制商品数量。 */
         applicableProductLimit: number;
-        /** 单商品可用卡券上限（同一 Wallet Pass 商品生成的卡券对同一商品行最多抵扣次数）。默认为 0，表示不限制。 */
+        /** 单订单行每单位可用同一 Wallet Pass 券次数；行总上限 = maxPassesPerItem × 该行 quantity（按行唯一键计）。0 表示不限制。 */
         maxPassesPerItem: number;
+        /** 是否抵扣单规格价格 (Option Price)，默认 false */
+        deductOptionPrice: boolean;
     }>[];
 }
 /**