@pisell/pisellos 2.1.173 → 2.1.174

package/dist/modules/Holder/types.d.ts

@@ -0,0 +1,123 @@
+import { ProductData } from '../Product/types';
+/**
+ * 商品 holder 配置
+ */
+export interface IHolderConfig {
+    required?: number;
+    resource_id: number;
+    status?: string;
+    [key: string]: any;
+}
+/**
+ * 表单记录
+ */
+export interface IFormRecord {
+    form_id: number;
+    form_record_id: number;
+    main_field: string;
+    customer_cover?: string;
+    created_at?: string;
+    customer_id?: number;
+    [key: string]: any;
+}
+/**
+ * 表单配置/定义
+ */
+export interface IFormInfo {
+    form_id: number;
+    name: string;
+    fields?: Record<string, any>[];
+    [key: string]: any;
+}
+/**
+ * 单个 form_id 下的数据结构
+ */
+export interface IFormItemData {
+    records: IFormRecord[];
+    form: IFormInfo | Record<string, any>;
+}
+/**
+ * form_id 为 key 的 map 结构，如 948: { records: [], form: {} }
+ */
+export type HolderFormMap = Record<string, IFormItemData>;
+/**
+ * Holder 模块 reactive store，仅 holderMap 会触发 changed 事件
+ */
+export interface HolderState {
+    holderMap: HolderFormMap;
+}
+export interface IFetchFormInfoParams {
+    url?: string;
+    query: {
+        form_id: string | number;
+    };
+    useCache?: boolean;
+}
+export interface IFetchFormRecordsParams {
+    url?: string;
+    query: {
+        customer_id?: number;
+        form_id: string | number;
+        shop_id: string | number;
+        num?: number;
+        skip?: number;
+        [key: string]: any;
+    };
+    useCache?: boolean;
+}
+export interface IAddFormRecordParams {
+    url?: string;
+    body: {
+        form_id: number;
+        shop_id: number | string;
+        customer_id?: number;
+        [key: string]: any;
+    };
+}
+/**
+ * UI 层自行调用添加接口后，将返回记录写入 holderMap
+ */
+export interface IAppendFormRecordParams {
+    /** 接口返回的 data，或完整响应 { data: {...} } */
+    record: IFormRecord | Record<string, any>;
+    /** 可选，未传则从 record.form_id 读取 */
+    form_id?: number | string;
+}
+export interface IEnsureFormDataParams {
+    form_id: number | string;
+    shop_id: number | string;
+    customer_id?: number;
+    useCache?: boolean;
+    forceRefresh?: boolean;
+    formInfoUrl?: string;
+    recordsUrl?: string;
+    skip?: number;
+    num?: number;
+}
+export interface IEnsureFormByProductParams {
+    product: ProductData | Record<string, any>;
+    customer_id?: number;
+    shop_id?: number | string;
+    useCache?: boolean;
+}
+export interface IRefreshAllFormRecordsParams {
+    customer_id?: number;
+    useCache?: boolean;
+    recordsUrl?: string;
+    num?: number;
+    skip?: number;
+}
+export interface HolderModuleAPI {
+    getHolderFormMap: () => HolderFormMap;
+    getHolderFormData: (formId: number | string) => IFormItemData | undefined;
+    setFormData: (formId: number | string, data: Partial<IFormItemData>) => void;
+    fetchFormInfo: (params: IFetchFormInfoParams) => Promise<IFormInfo | IFormInfo[]>;
+    fetchRecords: (params: IFetchFormRecordsParams) => Promise<IFormRecord[]>;
+    ensureFormData: (params: IEnsureFormDataParams) => Promise<IFormItemData>;
+    ensureFormByProduct: (params: IEnsureFormByProductParams) => Promise<IFormItemData | null>;
+    addFormRecord: (params: IAddFormRecordParams) => Promise<IFormRecord>;
+    appendFormRecord: (params: IAppendFormRecordParams) => IFormRecord;
+    removeFormRecord: (formId: number | string, formRecordId: number) => void;
+    clearFormData: (formId?: number | string) => void;
+    refreshAllFormRecords: (params?: IRefreshAllFormRecordsParams) => Promise<HolderFormMap>;
+}

package/dist/modules/Holder/types.js

@@ -0,0 +1 @@
+export {};

package/dist/modules/Holder/utils.d.ts

@@ -0,0 +1,13 @@
+import { ProductData } from '../Product/types';
+import { IFormItemData, IHolderConfig } from './types';
+export declare function getProductHolderConfig(product?: ProductData | Record<string, any> | null): IHolderConfig | null;
+export declare function getFormIdFromHolderConfig(config: IHolderConfig): number;
+export declare function normalizeFormId(formId: number | string): number;
+export declare function createEmptyFormItemData(): {
+    records: any[];
+    form: Record<string, any>;
+};
+export declare function resolveFormMetaFromHolderItem(mapKey: string, item: IFormItemData): {
+    form_id: number | string;
+    shop_id: number | string;
+} | null;

package/dist/modules/Holder/utils.js

@@ -0,0 +1,34 @@
+export function getProductHolderConfig(product) {
+  var _product$holder_confi, _product$origin;
+  if (!product) return null;
+  var config = (_product$holder_confi = product === null || product === void 0 ? void 0 : product.holder_config) !== null && _product$holder_confi !== void 0 ? _product$holder_confi : product === null || product === void 0 || (_product$origin = product.origin) === null || _product$origin === void 0 ? void 0 : _product$origin.holder_config;
+  if (config !== null && config !== void 0 && config.status && (config === null || config === void 0 ? void 0 : config.status) !== 'enable') return null;
+  if (!(config !== null && config !== void 0 && config.resource_id)) return null;
+  return config;
+}
+export function getFormIdFromHolderConfig(config) {
+  return Number(config === null || config === void 0 ? void 0 : config.resource_id);
+}
+export function normalizeFormId(formId) {
+  return Number(formId);
+}
+export function createEmptyFormItemData() {
+  return {
+    records: [],
+    form: {}
+  };
+}
+export function resolveFormMetaFromHolderItem(mapKey, item) {
+  var _ref, _ref2, _nestedForm$id, _nestedForm$shop_id;
+  var formInfo = item.form || {};
+  var nestedForm = formInfo.form || {};
+  var form_id = normalizeFormId((_ref = (_ref2 = (_nestedForm$id = nestedForm.id) !== null && _nestedForm$id !== void 0 ? _nestedForm$id : formInfo.form_id) !== null && _ref2 !== void 0 ? _ref2 : formInfo.id) !== null && _ref !== void 0 ? _ref : mapKey);
+  var shop_id = (_nestedForm$shop_id = nestedForm.shop_id) !== null && _nestedForm$shop_id !== void 0 ? _nestedForm$shop_id : formInfo.shop_id;
+  if (shop_id === undefined || shop_id === null || shop_id === '') {
+    return null;
+  }
+  return {
+    form_id: form_id,
+    shop_id: shop_id
+  };
+}

package/dist/modules/Order/index.d.ts

@@ -57,6 +57,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     private getTempOrderStorageKey;
     private restoreTempOrderFromStorage;
     persistTempOrder(): void;
+    notifyTempOrderChanged(): void;
     private createDefaultTempOrderInstance;
     ensureTempOrder(): ScanOrderTempOrder;
     restoreOrder(): ScanOrderTempOrder;

package/dist/modules/Order/index.js

@@ -25,7 +25,7 @@ function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key i
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 import { BaseModule } from "../BaseModule";
-import { generateDuration, getAllDiscountList, mergeRelationForms, buildSubmitPayload, createDefaultTempOrder, createDefaultOrderRulesHooks, createEmptySummary, createUuidV4, formatDateTime, filterProductsForScanOrderMore, isTempOrder } from "./utils";
+import { generateDuration, getAllDiscountList, mergeRelationForms, ensureCartItemOriginHolder, buildSubmitPayload, createDefaultTempOrder, createDefaultOrderRulesHooks, createEmptySummary, createUuidV4, formatDateTime, filterProductsForScanOrderMore, isTempOrder } from "./utils";
 import { isNormalProduct } from "../Product/utils";
 import dayjs from 'dayjs';
 import { buildProductLineFingerprint, getProductIdentityIndex, getSafeProductNum, isIdentityMatch, normalizeOrderProduct } from "../../solution/ScanOrder/utils";
@@ -439,6 +439,16 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       if (!this.window) return;
       this.window.localStorage.setItem(key, JSON.stringify(this.store.tempOrder));
     }
+  }, {
+    key: "notifyTempOrderChanged",
+    value: function notifyTempOrderChanged() {
+      if (!this.store.tempOrder) return;
+      this.store.tempOrder = _objectSpread(_objectSpread({}, this.store.tempOrder), {}, {
+        products: _toConsumableArray(this.store.tempOrder.products),
+        bookings: this.store.tempOrder.bookings ? _toConsumableArray(this.store.tempOrder.bookings) : []
+      });
+      this.persistTempOrder();
+    }
 
     // ─── TempOrder: 创建 & 获取 ───
   }, {
@@ -860,6 +870,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "createOrder",
     value: function createOrder(params) {
+      var _this2 = this;
       var order = _objectSpread({
         type: (params === null || params === void 0 ? void 0 : params.type) || 'appointment_booking',
         // 要从外面拿，virtual
@@ -877,6 +888,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       var is_deposit = 0; // 是否存在定金，0 不存在，1 存在
       if (params.cartItems.length > 0) {
         params.cartItems.forEach(function (item) {
+          var _params$extraData;
           if (!item._origin.duration) {
             var _generateDuration = generateDuration(item),
               duration = _generateDuration.duration,
@@ -887,6 +899,11 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
           var discountList = getAllDiscountList(item);
           item._origin.product.discount_list = discountList;
 
+          // 为预约补齐 holder 信息
+          if (params !== null && params !== void 0 && (_params$extraData = params.extraData) !== null && _params$extraData !== void 0 && _params$extraData.is_add_holder_info) {
+            ensureCartItemOriginHolder(item, _this2.window);
+          }
+
           // 购物车是否为普通商品
           if (isNormalProduct(item._origin)) {
             var _order$relation_forms;

package/dist/modules/Order/types.d.ts

@@ -235,6 +235,8 @@ export interface OrderModuleAPI {
     updateProductInOrder: (params: UpdateProductInOrderParams) => Promise<ScanOrderOrderProduct[]>;
     removeProductFromOrder: (identity: ScanOrderOrderProductIdentity) => Promise<ScanOrderOrderProduct[]>;
     persistTempOrder: () => void;
+    /** 提交 tempOrder 变更并触发 `{moduleName}:changed` 事件 */
+    notifyTempOrderChanged: () => void;
     submitTempOrder: <T = any>(params?: {
         cacheId?: string;
         platform?: string;

package/dist/modules/Order/utils.d.ts

@@ -2,6 +2,7 @@ import Decimal from 'decimal.js';
 import { CartItem } from "../Cart";
 import type { ScanOrderSubmitPayload, ScanOrderSubmitProduct, ScanOrderSummary, ScanOrderTempOrder } from '../../solution/ScanOrder/types';
 import type { RulesParamsHooks } from '../Rules/types';
+import type { WindowPlugin } from '../../plugins';
 /**
  * 把"含 option 的主商品单价"与 bundle 合成"单行 composite 单价"。
  *
@@ -86,6 +87,15 @@ export declare const mergeRelationForms: (relationForms: {
     form_id: number;
     form_record_ids: number[];
 }[];
+export interface CartOrderHolder {
+    customer_id?: number;
+    form_id: number | string;
+    form_record: (number | string)[] | null;
+}
+/**
+ * 为购物车行补齐订单所需的 holder 信息（与 cartAccount 结构保持一致）
+ */
+export declare function ensureCartItemOriginHolder(cartItem: CartItem, window?: WindowPlugin): void;
 export declare const getAllDiscountList: (cartItem: CartItem) => any;
 export declare function createUuidV4(): string;
 export declare function isTempOrder(data: any): data is ScanOrderTempOrder;

package/dist/modules/Order/utils.js

@@ -18,6 +18,7 @@ function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o =
 function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
 import dayjs from "dayjs";
 import Decimal from 'decimal.js';
+import { getProductHolderConfig } from "../Holder/utils";
 import { buildProductLineFingerprint, createEmptySummary } from "../../solution/ScanOrder/utils";
 /**
  * 把"含 option 的主商品单价"与 bundle 合成"单行 composite 单价"。
@@ -259,10 +260,41 @@ export var mergeRelationForms = function mergeRelationForms(relationForms) {
     return item.form_record_ids.length > 0;
   }); // 过滤掉没有有效记录的表单
 };
+function getCustomerIdFromStorage(window) {
+  try {
+    var _window$getLocalStora;
+    var customer = JSON.parse((window === null || window === void 0 || (_window$getLocalStora = window.getLocalStorage) === null || _window$getLocalStora === void 0 ? void 0 : _window$getLocalStora.call(window, 'customer')) || '{}');
+    var customerId = Number(customer === null || customer === void 0 ? void 0 : customer.id);
+    return Number.isFinite(customerId) && customerId > 0 ? customerId : undefined;
+  } catch (_unused) {
+    return undefined;
+  }
+}
+
+/**
+ * 为购物车行补齐订单所需的 holder 信息（与 cartAccount 结构保持一致）
+ */
+export function ensureCartItemOriginHolder(cartItem, window) {
+  var _cartItem$_origin, _cartItem$_productIni;
+  if (cartItem !== null && cartItem !== void 0 && (_cartItem$_origin = cartItem._origin) !== null && _cartItem$_origin !== void 0 && _cartItem$_origin.holder) {
+    return;
+  }
+  var holderConfig = getProductHolderConfig((_cartItem$_productIni = cartItem === null || cartItem === void 0 ? void 0 : cartItem._productInit) !== null && _cartItem$_productIni !== void 0 ? _cartItem$_productIni : cartItem === null || cartItem === void 0 ? void 0 : cartItem._productOrigin);
+  var formRecordId = cartItem === null || cartItem === void 0 ? void 0 : cartItem.holder_id;
+  if (!(holderConfig !== null && holderConfig !== void 0 && holderConfig.resource_id) || formRecordId == null) {
+    return;
+  }
+  cartItem._origin.holder = {
+    customer_id: getCustomerIdFromStorage(window),
+    form_id: holderConfig.resource_id,
+    form_record: [formRecordId]
+  };
+}
+;
 export var getAllDiscountList = function getAllDiscountList(cartItem) {
-  var _cartItem$_origin, _cartItem$_origin2;
-  var discountList = (cartItem === null || cartItem === void 0 || (_cartItem$_origin = cartItem._origin) === null || _cartItem$_origin === void 0 || (_cartItem$_origin = _cartItem$_origin.product) === null || _cartItem$_origin === void 0 ? void 0 : _cartItem$_origin.discount_list) || [];
-  ((cartItem === null || cartItem === void 0 || (_cartItem$_origin2 = cartItem._origin) === null || _cartItem$_origin2 === void 0 || (_cartItem$_origin2 = _cartItem$_origin2.product) === null || _cartItem$_origin2 === void 0 ? void 0 : _cartItem$_origin2.product_bundle) || []).forEach(function (item) {
+  var _cartItem$_origin2, _cartItem$_origin3;
+  var discountList = (cartItem === null || cartItem === void 0 || (_cartItem$_origin2 = cartItem._origin) === null || _cartItem$_origin2 === void 0 || (_cartItem$_origin2 = _cartItem$_origin2.product) === null || _cartItem$_origin2 === void 0 ? void 0 : _cartItem$_origin2.discount_list) || [];
+  ((cartItem === null || cartItem === void 0 || (_cartItem$_origin3 = cartItem._origin) === null || _cartItem$_origin3 === void 0 || (_cartItem$_origin3 = _cartItem$_origin3.product) === null || _cartItem$_origin3 === void 0 ? void 0 : _cartItem$_origin3.product_bundle) || []).forEach(function (item) {
     discountList = [].concat(_toConsumableArray(discountList), _toConsumableArray((item === null || item === void 0 ? void 0 : item.discount_list) || []));
     item.discount_list = undefined;
   });

package/dist/modules/Product/types.d.ts

@@ -189,6 +189,13 @@ export interface ProductData {
     };
     /** 购物车行键，用于唯一标识购物车中的商品，用于相同 SKU商品合并 */
     rowKey?: string;
+    /** holder 表单配置 */
+    holder_config?: {
+        required?: number;
+        resource_id?: number;
+        status?: string;
+        [key: string]: any;
+    };
 }
 /**
  * 商品媒体信息接口

package/dist/modules/Rules/entitlementLines.d.ts

@@ -0,0 +1,8 @@
+import type { RulesParamsHooks } from './types';
+export declare function isEntitlementRuntimeLine(product: any, mappedProduct?: any): boolean;
+/** 仅同步本次多次卡行的数量与价格，沿用 Rules 的主商品、套餐计算结果。 */
+export declare function rebuildEntitlementLine(origin: any, bundle: any[], hooks: RulesParamsHooks, count?: number): any;
+/** 重算只还原本次多次卡；套餐和多 Holder 按父商品份数计算，不再合并商品行。 */
+export declare function prepareEntitlementLines(products: any[], hooks: RulesParamsHooks, canUseEntitlement: (product: any) => boolean): any[];
+/** 客户端钩子可能保留原 _id，只给新增的重复行补标识，保留拆分结果。 */
+export declare function finalizeEntitlementLines(products: any[], hooks: RulesParamsHooks): any[];

package/dist/modules/Rules/entitlementLines.js

@@ -0,0 +1,157 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import { cloneDeep } from 'lodash-es';
+import Decimal from 'decimal.js';
+import { isEntitlementPass } from "../Discount/entitlementPass";
+import { hasEntitlementDiscount, isPersistedEntitlementLine } from "../Discount/entitlementState";
+var SOURCE = 'entitlement_source_identity';
+function isManualDiscount(data) {
+  var _data$isManualDiscoun, _data$discount_list;
+  return (_data$isManualDiscoun = data.isManualDiscount) !== null && _data$isManualDiscoun !== void 0 ? _data$isManualDiscoun : data.total != data.origin_total && (data.bundle || []).every(function (item) {
+    var _item$discount_list;
+    return !((_item$discount_list = item.discount_list) !== null && _item$discount_list !== void 0 && _item$discount_list.length);
+  }) && (!((_data$discount_list = data.discount_list) !== null && _data$discount_list !== void 0 && _data$discount_list.length) || data.discount_list.every(function (item) {
+    return item.type === 'product';
+  }));
+}
+export function isEntitlementRuntimeLine(product, mappedProduct) {
+  var _product$metadata;
+  return ((_product$metadata = product.metadata) === null || _product$metadata === void 0 ? void 0 : _product$metadata[SOURCE]) != null && !isPersistedEntitlementLine(product, mappedProduct) && !isManualDiscount(mappedProduct !== null && mappedProduct !== void 0 ? mappedProduct : product);
+}
+
+/** 仅同步本次多次卡行的数量与价格，沿用 Rules 的主商品、套餐计算结果。 */
+export function rebuildEntitlementLine(origin, bundle, hooks, count) {
+  var _ref, _ref2, _ref3, _data$original_price;
+  var data = hooks.getProduct(origin);
+  var quantity = (_ref = (_ref2 = count !== null && count !== void 0 ? count : data.quantity) !== null && _ref2 !== void 0 ? _ref2 : data.num) !== null && _ref !== void 0 ? _ref : 1;
+  var discounts = (data.discount_list || []).map(function (item) {
+    var _item$metadata;
+    return isEntitlementPass(item) && !((_item$metadata = item.metadata) !== null && _item$metadata !== void 0 && _item$metadata.custom_product_bundle_map_id) ? _objectSpread(_objectSpread({}, item), {}, {
+      _num: quantity,
+      metadata: _objectSpread(_objectSpread({}, item.metadata), {}, {
+        num: quantity
+      })
+    }) : item;
+  });
+  var mainDiscount = discounts.filter(function (item) {
+    var _item$metadata2;
+    return !((_item$metadata2 = item.metadata) !== null && _item$metadata2 !== void 0 && _item$metadata2.custom_product_bundle_map_id);
+  }).reduce(function (sum, item) {
+    return sum.plus(item.amount || 0);
+  }, new Decimal(0));
+  var originalPrice = new Decimal((_ref3 = (_data$original_price = data.original_price) !== null && _data$original_price !== void 0 ? _data$original_price : data.price) !== null && _ref3 !== void 0 ? _ref3 : 0);
+  var sourceSellingPrice = originalPrice.minus(mainDiscount).toNumber();
+  var optionPrice = (data.options || []).reduce(function (sum, item) {
+    return sum.plus(new Decimal(item.price || 0).times(item.num || 0));
+  }, new Decimal(0));
+  var bundleTotal = bundle.reduce(function (sum, item) {
+    return sum.plus(new Decimal(item.price || 0).times(item.num || 1));
+  }, new Decimal(0));
+  var bundleOriginalTotal = bundle.reduce(function (sum, item) {
+    var _ref4, _item$original_price;
+    return sum.plus(new Decimal((_ref4 = (_item$original_price = item.original_price) !== null && _item$original_price !== void 0 ? _item$original_price : item.price) !== null && _ref4 !== void 0 ? _ref4 : 0).times(item.num || 1));
+  }, new Decimal(0));
+  return hooks.setProduct(origin, {
+    quantity: quantity,
+    discount_list: discounts,
+    bundle: bundle,
+    price: sourceSellingPrice,
+    main_product_selling_price: sourceSellingPrice,
+    total: new Decimal(sourceSellingPrice).plus(optionPrice).plus(bundleTotal).toNumber(),
+    origin_total: originalPrice.plus(optionPrice).plus(bundleOriginalTotal).toNumber()
+  });
+}
+function setLineIdentity(row, id) {
+  row._id = id;
+  row.metadata = _objectSpread(_objectSpread({}, row.metadata), {}, {
+    unique_identification_number: id
+  });
+  if (row._extend) row._extend.unique_identification_number = id;
+  return row;
+}
+
+/** 重算只还原本次多次卡；套餐和多 Holder 按父商品份数计算，不再合并商品行。 */
+export function prepareEntitlementLines(products, hooks, canUseEntitlement) {
+  return products.flatMap(function (original) {
+    var _original$metadata, _origin$metadata$SOUR, _origin$metadata, _data$discount_list2, _ref8, _data$original_price2, _mainEntitlement$disc;
+    var data = hooks.getProduct(original);
+    if (isPersistedEntitlementLine(original, data) || isManualDiscount(data)) return [original];
+    var applicable = canUseEntitlement(original);
+    if (!((_original$metadata = original.metadata) !== null && _original$metadata !== void 0 && _original$metadata[SOURCE]) && !hasEntitlementDiscount(data) && !applicable) return [original];
+    var origin = cloneDeep(original);
+    origin.metadata = _objectSpread(_objectSpread({}, origin.metadata), {}, _defineProperty({}, SOURCE, (_origin$metadata$SOUR = (_origin$metadata = origin.metadata) === null || _origin$metadata === void 0 ? void 0 : _origin$metadata[SOURCE]) !== null && _origin$metadata$SOUR !== void 0 ? _origin$metadata$SOUR : data._id));
+    var bundle = (data.bundle || []).map(function (item) {
+      var _ref5, _ref6, _ref7, _item$original_price2, _entitlement$discount;
+      var entitlement = (item.discount_list || []).find(isEntitlementPass);
+      if (!entitlement) return item;
+      var discounts = (item.discount_list || []).filter(function (discount) {
+        return !isEntitlementPass(discount);
+      });
+      var originalPrice = (_ref5 = (_ref6 = (_ref7 = (_item$original_price2 = item.original_price) !== null && _item$original_price2 !== void 0 ? _item$original_price2 : (_entitlement$discount = entitlement.discount) === null || _entitlement$discount === void 0 ? void 0 : _entitlement$discount.original_amount) !== null && _ref7 !== void 0 ? _ref7 : item.product_price) !== null && _ref6 !== void 0 ? _ref6 : item.price) !== null && _ref5 !== void 0 ? _ref5 : 0;
+      var amount = discounts.reduce(function (sum, discount) {
+        return sum.plus(discount.amount || 0);
+      }, new Decimal(0));
+      var price = new Decimal(originalPrice).minus(amount.div(item.num || 1)).toNumber();
+      return _objectSpread(_objectSpread({}, item), {}, {
+        original_price: originalPrice,
+        price: price,
+        bundle_selling_price: price,
+        discount_list: discounts
+      });
+    });
+    var mainEntitlement = (_data$discount_list2 = data.discount_list) === null || _data$discount_list2 === void 0 ? void 0 : _data$discount_list2.find(isEntitlementPass);
+    var restored = hooks.setProduct(origin, {
+      original_price: (_ref8 = (_data$original_price2 = data.original_price) !== null && _data$original_price2 !== void 0 ? _data$original_price2 : mainEntitlement === null || mainEntitlement === void 0 || (_mainEntitlement$disc = mainEntitlement.discount) === null || _mainEntitlement$disc === void 0 ? void 0 : _mainEntitlement$disc.original_amount) !== null && _ref8 !== void 0 ? _ref8 : data.price,
+      discount_list: (data.discount_list || []).filter(function (item) {
+        return !isEntitlementPass(item);
+      }),
+      bundle: bundle
+    });
+    var row = rebuildEntitlementLine(restored, bundle, hooks);
+    var count = Math.max(1, Math.floor(Number(data.quantity || data.num || 1)));
+    if (!applicable || count <= 1 || !bundle.length && !Array.isArray(data.holder_id)) return [row];
+    return Array.from({
+      length: count
+    }, function (_, index) {
+      var _unit$_origin;
+      var unit = cloneDeep(row);
+      // booking 使用 _extend.holder_id，appointmentBooking 使用购物车 Holder。
+      for (var _i = 0, _arr = [unit, unit._extend]; _i < _arr.length; _i++) {
+        var source = _arr[_i];
+        if (Array.isArray(source === null || source === void 0 ? void 0 : source.holder_id)) source.holder_id = source.holder_id.slice(index, index + 1);
+      }
+      if (Array.isArray((_unit$_origin = unit._origin) === null || _unit$_origin === void 0 || (_unit$_origin = _unit$_origin.holder) === null || _unit$_origin === void 0 ? void 0 : _unit$_origin.form_record)) {
+        var records = unit._origin.holder.form_record;
+        // 单 Holder 的多份商品仍归属同一人；多个 Holder 才按份对应。
+        if (records.length > 1) unit._origin.holder.form_record = records.slice(index, index + 1);
+      }
+      return setLineIdentity(rebuildEntitlementLine(unit, hooks.getProduct(unit).bundle || [], hooks, 1), "".concat(data._id, ":entitlement-unit:").concat(index));
+    });
+  });
+}
+
+/** 客户端钩子可能保留原 _id，只给新增的重复行补标识，保留拆分结果。 */
+export function finalizeEntitlementLines(products, hooks) {
+  var runtime = function runtime(item) {
+    return isEntitlementRuntimeLine(item, hooks.getProduct(item));
+  };
+  var seen = new Set(products.filter(function (item) {
+    return !runtime(item);
+  }).map(function (item) {
+    return String(item._id);
+  }));
+  return products.map(function (origin, index) {
+    var _origin$_id;
+    if (!runtime(origin)) return origin;
+    var base = String((_origin$_id = origin._id) !== null && _origin$_id !== void 0 ? _origin$_id : hooks.getProduct(origin)._id);
+    var id = base;
+    var ordinal = index;
+    while (seen.has(id)) id = "".concat(base, ":entitlement-split:").concat(ordinal++);
+    seen.add(id);
+    return id === String(origin._id) ? origin : setLineIdentity(cloneDeep(origin), id);
+  });
+}

package/dist/modules/Rules/index.d.ts

@@ -8,17 +8,26 @@ export declare class RulesModule extends BaseModule implements Module, RulesModu
     protected defaultVersion: string;
     private store;
     private hooks;
+    private entitlementPassEnabled;
+    private defaultWalletPassEvaluator?;
+    setEntitlementPassEnabled(enabled: boolean): void;
+    private getWalletPassEvaluator;
     constructor(name?: string, version?: string);
     initialize(core: PisellCore, options?: ModuleOptions): Promise<void>;
     setRulesList(rulesList: Rules[]): Promise<void>;
     getRulesList(): Rules[];
+    private normalizeHolderRecordIds;
+    /**
+     * 商品未开启 Holder 选择时跳过匹配；已开启时，特定 form Holder 卡
+     * 只适用于同一 Holder Record，是否必填不影响匹配规则。
+     */
     private checkHolderMatch;
     isDiscountListAvailable({ oldDiscountList, newDiscountList, productList, holders, isFormSubject, }: {
         oldDiscountList: Discount[];
         newDiscountList: Discount[];
         productList: any[];
         holders: {
-            form_record_id: number;
+            form_record_id: number | string;
         }[];
         isFormSubject: boolean;
     }): {
@@ -26,6 +35,7 @@ export declare class RulesModule extends BaseModule implements Module, RulesModu
         discountList: Discount[];
         productList: any[];
         unavailableReason?: UnavailableReason;
+        evaluatedDiscountList?: Discount[];
     };
     filterDiscountListByType(discountList: Discount[], type: string): Discount[];
     private getUnavailableReason;
@@ -33,7 +43,7 @@ export declare class RulesModule extends BaseModule implements Module, RulesModu
         discountList: Discount[];
         productList: any[];
         holders: {
-            form_record_id: number;
+            form_record_id: number | string;
         }[];
         isFormSubject: boolean;
     }, options?: {