@pisell/pisellos 2.1.119 → 2.1.121

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

@@ -0,0 +1,142 @@
+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/walletPass/index.ts
+var walletPass_exports = {};
+__export(walletPass_exports, {
+  default: () => WalletPassAdapter
+});
+module.exports = __toCommonJS(walletPass_exports);
+var import_utils = require("./utils");
+var WalletPassAdapter = class {
+  constructor() {
+    this.name = "WalletPassAdapter";
+    this.version = "1.0.0";
+  }
+  /**
+   * 准备运行时上下文
+   * 将业务数据转换为策略引擎可识别的 RuntimeContext
+   */
+  prepareContext(businessData) {
+    var _a, _b;
+    const { orderTotalAmount, products, voucher, strategyConfig } = businessData;
+    const productIds = products.map((p) => p.product_id);
+    const applicableProductIds = (0, import_utils.getApplicableProductIds)(voucher);
+    const deductTaxAndFee = ((_b = (_a = strategyConfig == null ? void 0 : strategyConfig.metadata) == null ? void 0 : _a.custom) == null ? void 0 : _b.deductTaxAndFee) ?? true;
+    const { applicableTotal, applicableCount } = this.calculateApplicableProducts(
+      products,
+      applicableProductIds,
+      deductTaxAndFee
+    );
+    return {
+      entities: {
+        voucher,
+        products,
+        order: {
+          orderTotalAmount,
+          products
+        }
+      },
+      attributes: {
+        // 订单消费金额
+        orderTotalAmount,
+        // 适用商品金额
+        applicableProductTotalAmount: applicableTotal,
+        // 适用商品购买数量
+        applicableProductCount: applicableCount,
+        // 当前评估的 voucher ID
+        voucherProductId: voucher.product_id,
+        // 订单中的商品ID
+        productIds
+      },
+      metadata: {
+        timestamp: Date.now()
+      }
+    };
+  }
+  /**
+   * 转换执行结果
+   * 将策略引擎的通用结果转换为业务层需要的格式
+   */
+  transformResult(result, businessData) {
+    const strategyConfig = businessData == null ? void 0 : businessData.strategyConfig;
+    const businessConfig = (strategyConfig == null ? void 0 : strategyConfig.metadata.custom) || {};
+    const voucher = businessData == null ? void 0 : businessData.voucher;
+    const applicableProductIds = voucher ? (0, import_utils.getApplicableProductIds)(voucher) : null;
+    if (!result.applicable) {
+      return {
+        isApplicable: false,
+        canUseCount: 0,
+        maxDeduction: 0,
+        deductTaxAndFee: false,
+        applicableProductIds: [],
+        reason: result.message,
+        reasonCode: result.code,
+        strategyResult: result
+      };
+    }
+    const maxDeduction = businessConfig.maxDeductionAmount || 0;
+    const canUseCount = businessConfig.maxUsagePerOrder || 0;
+    const deductTaxAndFee = businessConfig.deductTaxAndFee || false;
+    return {
+      isApplicable: true,
+      canUseCount,
+      maxDeduction,
+      deductTaxAndFee,
+      applicableProductIds: applicableProductIds || [],
+      strategyResult: result
+    };
+  }
+  /**
+   * 格式化配置
+   */
+  formatConfig(result, businessData) {
+    return { result, businessData };
+  }
+  /**
+   * 计算适用商品的总金额和数量
+   */
+  calculateApplicableProducts(products, applicableProductIds, deductTaxAndFee = true) {
+    let total = 0;
+    let count = 0;
+    if (applicableProductIds !== null && applicableProductIds.length === 0) {
+      return { applicableTotal: 0, applicableCount: 0 };
+    }
+    products.forEach((product) => {
+      const productQuantity = (0, import_utils.getProductQuantity)(product);
+      const isMainProductApplicable = applicableProductIds === null || applicableProductIds.includes(product.product_id);
+      if (isMainProductApplicable) {
+        total += (0, import_utils.getMainProductPrice)(product, deductTaxAndFee) * productQuantity;
+        count += productQuantity;
+      }
+      if (product.product_bundle && product.product_bundle.length > 0) {
+        product.product_bundle.forEach((bundleItem) => {
+          if ((0, import_utils.getBundleItemIsOriginalPrice)(bundleItem)) {
+            const isBundleItemApplicable = applicableProductIds === null || applicableProductIds.includes(bundleItem.bundle_product_id);
+            if (isBundleItemApplicable) {
+              const bundleItemQuantity = bundleItem.num * productQuantity;
+              total += (0, import_utils.getBundleItemPrice)(bundleItem, productQuantity, deductTaxAndFee);
+              count += bundleItemQuantity;
+            }
+          }
+        });
+      }
+    });
+    return { applicableTotal: total, applicableCount: count };
+  }
+};

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

@@ -0,0 +1 @@
+export declare const locales: Record<string, Record<string, string>>;

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

@@ -0,0 +1,54 @@
+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/walletPass/locales.ts
+var locales_exports = {};
+__export(locales_exports, {
+  locales: () => locales
+});
+module.exports = __toCommonJS(locales_exports);
+var locales = {
+  "zh-CN": {
+    "not_meet_the_required_conditions": "未达到使用条件",
+    "exceeds_the_maximum_deduction_limit": "超出最大抵扣金额限制",
+    "usage_limit_reached": "已达到使用次数上限",
+    "max_passes_per_item_reached": "该商品已达到卡券使用上限",
+    "not_available_for_this_channel": "当前渠道不可使用",
+    "not_valid_for_this_order_type": "当前订单类型不适用"
+  },
+  "en": {
+    "not_meet_the_required_conditions": "Not meet the required conditions.",
+    "exceeds_the_maximum_deduction_limit": "Exceeds the maximum deduction limit.",
+    "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."
+  },
+  "zh-HK": {
+    "not_meet_the_required_conditions": "未達使用條件",
+    "exceeds_the_maximum_deduction_limit": "超出最大抵扣金額限制",
+    "usage_limit_reached": "已達使用次數上限",
+    "max_passes_per_item_reached": "該商品已達卡券使用上限",
+    "not_available_for_this_channel": "當前渠道不可使用",
+    "not_valid_for_this_order_type": "當前訂單類型不適用"
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  locales
+});

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

@@ -0,0 +1,187 @@
+import { EvaluationResult, StrategyConfig } from '../../type';
+/**
+ * Voucher 数据结构
+ */
+export interface Voucher {
+    id: number;
+    amount: number;
+    balance: number;
+    type?: string;
+    usedCount?: number;
+    available_product_type?: 'product_all' | 'product_collection' | 'products';
+    available_product_ids?: number[];
+    product_id: number;
+    unified_available_status: number;
+    /** 用户手动编辑的金额，优先于 recommended_usage_amount 使用 */
+    edit_current_amount?: number;
+    /** 前端基于策略返回的 不可用状态 */
+    _unified_available_status?: number;
+    /** 前端基于策略返回的 可用最大金额 */
+    _available_max_amount?: number;
+    /** 前端基于策略返回的 不可用原因 */
+    reason?: string;
+    /** 前端基于策略返回的 不可用原因码 */
+    reasonCode?: string;
+    /** 后端计算推荐使用金额 */
+    recommended_usage_amount: number;
+    /** 后端计算推荐使用金额（仅商品） 不包含税费附加费 */
+    recommended_pure_product_usage_amount: number;
+    /** 实际抵扣金额 */
+    actualDeduction: number;
+    /** 抵扣详情 */
+    deductionDetails: any[];
+    config?: {
+        /** 最大抵扣金额 */
+        maxDeductionAmount: number;
+        /** 每单最多使用张数（同一 product_id 的券）。默认为 0，表示不限制数量。 */
+        maxUsagePerOrder: number;
+        /** 是否抵扣税费与附加费 */
+        deductTaxAndFee: boolean;
+        /** 适用粒度（多商品共用） 默认开启勾选项 */
+        allowCrossProduct: boolean;
+        /** 可用商品数量上限 （仅多商品） 默认为0，表示不限制商品数量。 */
+        applicableProductLimit: number;
+        /** 单订单行每单位可用同一 Wallet Pass 券次数；该行总券次上限 = maxPassesPerItem × 该行 quantity（按行唯一键区分）。0 表示不限制。 */
+        maxPassesPerItem: number;
+        /** 是否抵扣单规格价格 (Option Price)，默认 false。开启后折扣范围包含 option 的 add_price */
+        deductOptionPrice: boolean;
+    };
+}
+/**
+ * 商品数据结构
+ */
+export interface Product {
+    product_id: number;
+    /** 订单明细 id，参与行唯一键兜底解析 */
+    id?: number;
+    /** 行级唯一串，参与行唯一键解析 */
+    product_unique_string?: string;
+    price: number;
+    quantity: number;
+    name?: string;
+    selling_price?: number;
+    /** 主商品折扣前金额，不包含套餐子商品 */
+    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;
+        tax_fee_rounding_remainder?: number;
+        main_product_selling_price: number;
+    };
+    is_price_include_tax: 0 | 1;
+    product_bundle: {
+        is_price_include_tax: 0 | 1;
+        bundle_id: number;
+        bundle_product_id: number;
+        bundle_variant_id: number;
+        price_type: string;
+        price_type_ext: string;
+        bundle_selling_price: number;
+        num: number;
+        is_charge_tax: number;
+        tax_fee: number;
+        metadata: {
+            surcharge_fee: number;
+            surcharge_rounding_remainder?: number;
+            tax_fee_rounding_remainder?: number;
+        };
+    }[];
+}
+/**
+ * Voucher 评估结果
+ */
+export interface VoucherEvaluationResult {
+    voucher: Voucher;
+    /** 是否可用 */
+    isApplicable: boolean;
+    /** 每单可使用张数 */
+    canUseCount: number;
+    /** 最大抵扣金额 */
+    maxDeduction: number;
+    /** 是否抵扣税费与附加费 */
+    deductTaxAndFee: boolean;
+    /** 适用商品ID列表 */
+    applicableProductIds: number[];
+    /** 不可用原因 */
+    reason?: string;
+    /** 不可用原因码 */
+    reasonCode?: string;
+    strategyResult?: EvaluationResult;
+}
+/**
+ * 评估器输入参数
+ */
+export interface EvaluatorInput {
+    /** 订单总金额 */
+    orderTotalAmount: number;
+    /** 商品列表 */
+    products: Product[];
+    /** 代金券列表 */
+    vouchers: Voucher[];
+    /** 策略配置列表 */
+    strategyConfigs?: StrategyConfig<{
+        /** 最大抵扣金额 */
+        maxDeductionAmount: number;
+        /** 每单最多使用张数（同一 product_id 的券）。默认为 0，表示不限制数量。 */
+        maxUsagePerOrder: number;
+        /** 是否抵扣税费与附加费 */
+        deductTaxAndFee: boolean;
+        /** 适用粒度（多商品共用） 默认开启勾选项 */
+        allowCrossProduct: boolean;
+        /** 可用商品数量上限 （仅多商品） 默认为0，表示不限制商品数量。 */
+        applicableProductLimit: number;
+        /** 单订单行每单位可用同一 Wallet Pass 券次数；行总上限 = maxPassesPerItem × 该行 quantity（按行唯一键计）。0 表示不限制。 */
+        maxPassesPerItem: number;
+        /** 是否抵扣单规格价格 (Option Price)，默认 false */
+        deductOptionPrice: boolean;
+    }>[];
+}
+/**
+ * WalletPassAdapter 业务数据输入
+ */
+export interface WalletPassBusinessData {
+    /** 订单总金额 */
+    orderTotalAmount: number;
+    /** 商品列表 */
+    products: Product[];
+    /** 当前评估的 voucher */
+    voucher: Voucher;
+    /** 策略配置 */
+    strategyConfig: StrategyConfig;
+}
+/**
+ * WalletPassAdapter 转换结果
+ */
+export interface WalletPassTransformResult {
+    /** 是否可用 */
+    isApplicable: boolean;
+    /** 每单可使用张数 */
+    canUseCount: number;
+    /** 最大抵扣金额 */
+    maxDeduction: number;
+    /** 是否抵扣税费与附加费 */
+    deductTaxAndFee: boolean;
+    /** 适用商品ID列表 */
+    applicableProductIds: number[];
+    /** 不可用原因 */
+    reason?: string;
+    /** 不可用原因码 */
+    reasonCode?: string;
+    /** 原始策略评估结果 */
+    strategyResult?: EvaluationResult;
+}

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

@@ -0,0 +1,17 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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/walletPass/type.ts
+var type_exports = {};
+module.exports = __toCommonJS(type_exports);

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

@@ -0,0 +1,50 @@
+import { Product, Voucher } from './type';
+/** 订单商品数量 */
+export declare const getProductQuantity: (product: any) => any;
+/**
+ * 订单商品行唯一键，用于 maxPassesPerItem 按行、按件配额（同 SPU 不同规格视为不同行）。
+ */
+export declare function resolveWalletPassLineKey(product: any, indexInOrder: number): string;
+export declare const getApplicableProductIds: (voucher: Voucher) => number[] | null;
+/**
+ * 优惠券处理函数
+ * @param applicableVouchers 可用的券列表
+ * @param orderTotalAmount 订单总金额
+ * @param products 订单商品列表
+ * @returns 返回推荐券列表和全部列表，每个券包含 _available_max_amount 和 _unified_available_status
+ */
+export declare function processVouchers(applicableVouchers: Voucher[], orderTotalAmount: number, products: Product[]): {
+    recommended: any[];
+    transformList: any[];
+};
+/**
+ * 重新计算优惠券状态（基于已选券的增量计算）
+ * @param allVouchers 所有原始券列表
+ * @param selectedVouchers 已选中的券列表（按选中顺序）
+ * @param orderTotalAmount 订单总金额
+ * @param products 订单商品列表
+ * @returns 返回更新后的所有券列表和已选券的详细抵扣信息
+ */
+export declare function recalculateVouchers(allVouchers: any[], selectedVouchers: any[], orderTotalAmount: number, products: any[]): {
+    allWithUpdatedStatus: any[];
+    selectedWithDetails: any[];
+};
+/**
+ * 获取主商品价格（单价，不含舍入余数）
+ * @param product 商品
+ * @param isDeductTaxAndFee 是否抵扣税费与附加费
+ * @returns 商品单价
+ */
+export declare const getMainProductPrice: (product: Product, isDeductTaxAndFee: boolean) => number;
+/**
+ * 获取套餐子商品价格（不含舍入余数）
+ * @param bundleItem 套餐子商品
+ * @param parentQuantity 父商品数量
+ * @param isDeductTaxAndFee 是否抵扣税费与附加费
+ * @returns 子商品总价格（不含舍入余数）
+ */
+export declare const getBundleItemPrice: (bundleItem: any, parentQuantity: number, isDeductTaxAndFee: boolean) => number;
+export declare const getBundleItemIsOriginalPrice: (item: any) => boolean;
+export declare const getBundleItemIsMarkupPrice: (item: any) => boolean;
+export declare const getBundleItemIsDiscountPrice: (item: any) => boolean;
+export declare const getBundleItemIsMarkupOrDiscountPrice: (item: any) => boolean;