@pisell/pisellos 0.10.14 → 0.10.16

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

@@ -1,41 +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);
+"use strict";
 
-// src/model/strategy/adapter/promotion/type.ts
-var type_exports = {};
-__export(type_exports, {
-  PROMOTION_ACTION_TYPES: () => PROMOTION_ACTION_TYPES,
-  PROMOTION_OPERATORS: () => PROMOTION_OPERATORS
+Object.defineProperty(exports, "__esModule", {
+  value: true
 });
-module.exports = __toCommonJS(type_exports);
-var PROMOTION_ACTION_TYPES = {
+exports.PROMOTION_OPERATORS = exports.PROMOTION_ACTION_TYPES = void 0;
+/**
+ * Promotion 策略类型定义
+ *
+ * 定义促销活动相关的 Action 类型、值结构和配置
+ */
+
+// ============================================
+// Action Type 常量
+// ============================================
+
+/**
+ * 促销活动 Action 类型
+ */
+const PROMOTION_ACTION_TYPES = exports.PROMOTION_ACTION_TYPES = {
   /** X件Y元（每X件固定价格Y元，可累计） */
-  X_ITEMS_FOR_Y_PRICE: "X_ITEMS_FOR_Y_PRICE",
+  X_ITEMS_FOR_Y_PRICE: 'X_ITEMS_FOR_Y_PRICE',
   /** 买X送Y（买X件送Y件，可累计） */
-  BUY_X_GET_Y_FREE: "BUY_X_GET_Y_FREE",
+  BUY_X_GET_Y_FREE: 'BUY_X_GET_Y_FREE',
   /** 商品奖励（满足条件后，订单内指定目标商品享优惠） */
-  ITEM_REWARD: "ITEM_REWARD",
+  ITEM_REWARD: 'ITEM_REWARD',
   /** 固定折扣 */
-  DISCOUNT_RATE: "DISCOUNT_RATE",
+  DISCOUNT_RATE: 'DISCOUNT_RATE',
   /** 固定减价 */
-  DEDUCT_AMOUNT: "DEDUCT_AMOUNT"
+  DEDUCT_AMOUNT: 'DEDUCT_AMOUNT'
 };
-var PROMOTION_OPERATORS = {
+
+// ============================================
+// 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
+ */
+
+/**
+ * 商品奖励优惠方式
+ *
+ * - free: 目标商品最终价为 0
+ * - percent_off: 目标商品按百分比折扣，rewardValue 为 0-100
+ * - amount_off: 每个目标商品固定减免 rewardValue
+ * - fixed_price: 目标商品改为固定价 rewardValue
+ */
+
+/**
+ * 商品奖励数量规则
+ *
+ * - per_condition_quantity: 每满足 N 个条件商品，奖励 Y 个目标商品
+ * - all_targets: 满足条件后奖励全部目标商品
+ * - max_per_order: 满足条件后每单最多奖励固定数量目标商品
+ */
+
+/** 商品奖励目标选择规则 */
+
+/**
+ * 商品奖励 - Action Value
+ *
+ * @example
+ * value: {
+ *   rewardMethod: 'free',
+ *   quantityRule: 'per_condition_quantity',
+ *   triggerQuantity: 1,
+ *   rewardQuantity: 1,
+ * }
+ */
+
+/**
+ * 商品奖励 - Action Config
+ */
+
+// ============================================
+// 商品标识
+// ============================================
+
+/**
+ * 商品标识
+ *
+ * 匹配规则：
+ * - product_variant_id = 0 表示匹配任意变体
+ * - product_variant_id != 0 表示精确匹配该变体
+ */
+
+// ============================================
+// 完整的 Promotion Action 类型
+// ============================================
+
+/**
+ * X件Y元 Action
+ */
+
+/**
+ * 买X送Y Action
+ */
+
+/**
+ * 商品奖励 Action
+ */
+
+/**
+ * 促销活动 Action 联合类型
+ */
+
+// ============================================
+// 运算符常量
+// ============================================
+
+/**
+ * 促销相关运算符
+ */
+const PROMOTION_OPERATORS = exports.PROMOTION_OPERATORS = {
   /**
    * 商品匹配运算符
    *
@@ -44,10 +145,116 @@ var PROMOTION_OPERATORS = {
    * - 如果配置的 product_variant_id = 0，只需要 product_id 匹配
    * - 如果配置的 product_variant_id != 0，还需要 product_variant_id 匹配
    */
-  PRODUCT_MATCH: "product_match"
+  PRODUCT_MATCH: 'product_match'
 };
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  PROMOTION_ACTION_TYPES,
-  PROMOTION_OPERATORS
-});
+
+// ============================================
+// 业务数据类型（输入）
+// ============================================
+
+/**
+ * 促销活动业务数据
+ *
+ * 由业务层传入，用于策略评估
+ */
+
+const obj = {
+  product_id: 1,
+  product_variant_id: 0,
+  quantity: 1,
+  price: 100,
+  original_price: 100,
+  id: 1
+};
+
+/**
+ * 促销商品信息
+ */
+
+// ============================================
+// 适配器输出类型
+// ============================================
+
+/**
+ * 促销活动适配器转换结果
+ *
+ * 返回给业务层，包含策略匹配信息
+ */
+
+/**
+ * Action 详情联合类型
+ */
+
+/**
+ * X件Y元 Action 详情
+ */
+
+/**
+ * 买X送Y Action 详情
+ */
+
+/**
+ * 商品奖励 Action 详情
+ */
+
+// ============================================
+// 业务层输出类型（供参考）
+// ============================================
+
+/**
+ * X件Y元 - 业务层计算结果
+ *
+ * 由业务层根据 matchedAction 计算后返回
+ */
+
+/**
+ * 买X送Y - 业务层计算结果
+ *
+ * 由业务层根据 matchedAction 计算后返回
+ */
+
+/**
+ * 评估器输入
+ */
+
+/**
+ * 单商品评估结果
+ */
+
+/**
+ * 适用的促销信息
+ */
+
+/**
+ * 购物车评估结果
+ */
+
+/**
+ * 购物车适用的促销
+ */
+
+/**
+ * 促销分组
+ */
+
+// ============================================
+// 带定价的购物车评估结果类型
+// ============================================
+
+/**
+ * 带定价的商品
+ *
+ * 在 PromotionProduct 基础上增加了均摊后的最终价格和促销信息
+ */
+
+/**
+ * 赠品信息
+ *
+ * 记录某个促销产生的赠品数量和可选赠品列表
+ */
+
+/**
+ * 带定价的购物车评估结果
+ *
+ * evaluateCartWithPricing 方法的返回结果
+ */

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

@@ -1,17 +1,5 @@
-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);
+"use strict";
 
-// src/model/strategy/adapter/type.ts
-var type_exports = {};
-module.exports = __toCommonJS(type_exports);
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});