@pisell/pisellos 0.0.571 → 0.0.572

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

@@ -8,7 +8,7 @@ import type { ScheduleItem } from '../../../../modules/Schedule/types';
 export declare const DATA_VARIANT_ACTION_TYPES: {
     readonly APPLY: "DATA_VARIANT_APPLY";
 };
-export declare type DataVariantActionType = (typeof DATA_VARIANT_ACTION_TYPES)[keyof typeof DATA_VARIANT_ACTION_TYPES];
+export type DataVariantActionType = (typeof DATA_VARIANT_ACTION_TYPES)[keyof typeof DATA_VARIANT_ACTION_TYPES];
 /**
  * Data Variant 规则元数据。
  *
@@ -116,7 +116,7 @@ export interface EffectiveRuleInfo {
     productRules: ConditionRule[];
     globalResult: EvaluationResult;
 }
-export declare type GlobalEffectiveRuleMap = Map<string, EffectiveRuleInfo>;
+export type GlobalEffectiveRuleMap = Map<string, EffectiveRuleInfo>;
 /**
  * 单条商品命中的变体覆盖信息。
  */
@@ -145,4 +145,4 @@ export interface ResolvedDataVariantResult {
     scheduleTimePoints: string[];
     rawResults: EvaluationResult[];
 }
-export declare type ConditionScope = 'global' | 'product';
+export type ConditionScope = 'global' | 'product';

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

@@ -5,7 +5,7 @@ export declare const ITEM_RULE_ACTION_TYPES: {
     /** 预填购物车 */
     readonly PREFILL_CART: "PREFILL_CART";
 };
-export declare type ItemRuleActionType = (typeof ITEM_RULE_ACTION_TYPES)[keyof typeof ITEM_RULE_ACTION_TYPES];
+export type ItemRuleActionType = (typeof ITEM_RULE_ACTION_TYPES)[keyof typeof ITEM_RULE_ACTION_TYPES];
 export declare const ITEM_RULE_TEMPLATES: {
     /** 空白规则 */
     readonly BLANK: "blank";
@@ -16,15 +16,15 @@ export declare const ITEM_RULE_TEMPLATES: {
     /** 必选商品 */
     readonly MUST_INCLUDE: "must_include";
 };
-export declare type ItemRuleTemplate = (typeof ITEM_RULE_TEMPLATES)[keyof typeof ITEM_RULE_TEMPLATES];
+export type ItemRuleTemplate = (typeof ITEM_RULE_TEMPLATES)[keyof typeof ITEM_RULE_TEMPLATES];
 /** 数量比较类型 */
-export declare type QuantityComparison = 'minimum' | 'maximum' | 'exact' | 'must_include';
+export type QuantityComparison = 'minimum' | 'maximum' | 'exact' | 'must_include';
 /** 数量来源 */
-export declare type QuantitySource = 'total_pax' | 'adult_pax' | 'fixed';
+export type QuantitySource = 'total_pax' | 'adult_pax' | 'fixed';
 /** 目标类型（当前仅支持按商品） */
-export declare type TargetType = 'product';
+export type TargetType = 'product';
 /** 作用范围 */
-export declare type RuleScope = 'each_submission' | 'first_submission_only' | 'subsequent_only' | 'cumulative';
+export type RuleScope = 'each_submission' | 'first_submission_only' | 'subsequent_only' | 'cumulative';
 /**
  * 单条数量规则
  *

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

@@ -0,0 +1,4 @@
+export { PromotionEvaluator } from './evaluator';
+export { PromotionAdapter } from './adapter';
+export { default } from './adapter';
+export { X_ITEMS_FOR_Y_PRICE_STRATEGY, BUY_X_GET_Y_FREE_STRATEGY, } from './examples';

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

@@ -17,7 +17,7 @@ export declare const PROMOTION_ACTION_TYPES: {
     /** 固定减价 */
     readonly DEDUCT_AMOUNT: "DEDUCT_AMOUNT";
 };
-export declare type PromotionActionType = (typeof PROMOTION_ACTION_TYPES)[keyof typeof PROMOTION_ACTION_TYPES];
+export type PromotionActionType = (typeof PROMOTION_ACTION_TYPES)[keyof typeof PROMOTION_ACTION_TYPES];
 /**
  * X件Y元 - Action Value
  *
@@ -54,7 +54,7 @@ export interface BuyXGetYFreeValue {
 /**
  * 赠品选择模式
  */
-export declare type GiftSelectionMode = 'user_select' | 'auto' | 'cheapest';
+export type GiftSelectionMode = 'user_select' | 'auto' | 'cheapest';
 /**
  * 买X送Y - Action Config
  */
@@ -105,7 +105,7 @@ export interface BuyXGetYFreeAction extends Omit<ActionEffect, 'type' | 'value'
 /**
  * 促销活动 Action 联合类型
  */
-export declare type PromotionAction = XItemsForYPriceAction | BuyXGetYFreeAction;
+export type PromotionAction = XItemsForYPriceAction | BuyXGetYFreeAction;
 /**
  * 促销相关运算符
  */
@@ -135,7 +135,7 @@ export interface PromotionBusinessData {
     /** 自定义属性 */
     custom?: Record<string, any>;
 }
-declare type ProductBundleItem = {
+type ProductBundleItem = {
     /** 主商品ID */
     product_id: number;
     /** 变体ID（0 表示无变体） */
@@ -195,7 +195,7 @@ export interface PromotionTransformResult {
 /**
  * Action 详情联合类型
  */
-export declare type PromotionActionDetail = XItemsForYPriceActionDetail | BuyXGetYFreeActionDetail;
+export type PromotionActionDetail = XItemsForYPriceActionDetail | BuyXGetYFreeActionDetail;
 /**
  * X件Y元 Action 详情
  */

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

@@ -28,6 +28,8 @@ export declare class WalletPassEvaluator {
     /** 检查代金券/折扣卡是否可用 并返回config */
     checkVoucherAvailability(input: EvaluatorInput): {
         isAvailable: boolean;
+        reason: string | undefined;
+        reasonCode: string | undefined;
         config: {
             [x: string]: any;
         };

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

@@ -256,6 +256,8 @@ class WalletPassEvaluator {
     const isAvailable = results[0]?.isApplicable || false;
     return {
       isAvailable,
+      reason: results[0]?.reason,
+      reasonCode: results[0]?.reasonCode,
       config: {
         ...results[0]?.strategyResult?.config?.metadata?.custom
       }

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

@@ -242,4 +242,4 @@ export interface EngineOptions {
 /**
  * 运算符处理器
  */
-export declare type OperatorHandler = (fieldValue: any, compareValue: any, rule: ConditionRule) => boolean;
+export type OperatorHandler = (fieldValue: any, compareValue: any, rule: ConditionRule) => boolean;

package/lib/modules/BookingContext/types.d.ts

@@ -39,17 +39,17 @@ export interface InitBookingContextParams {
  * 资源全集 map：key 为资源 id（数字），value 为资源原始对象，含 times / event_list 等运行态。
  * 这里只声明 Record 形态；具体字段保留 `any`，与 ticketBooking 现网传入的数据形状兼容。
  */
-export declare type BookingContextResource = Record<string, any>;
-export declare type BookingContextResourceMap = Record<string, BookingContextResource>;
+export type BookingContextResource = Record<string, any>;
+export type BookingContextResourceMap = Record<string, BookingContextResource>;
 /**
  * 形参 booking_config（结构来自 `/core/board/management/config` 接口）。
  * OS 不强制 schema，保留 `Record<string, any>` 兼容现网；常用路径文档化在 SDK docs。
  */
-export declare type BookingContextConfig = Record<string, any>;
+export type BookingContextConfig = Record<string, any>;
 /**
  * 日期入参：接受 dayjs 实例、ISO 字符串、Date 实例；内部统一 normalize 为 ISO 字符串保存。
  */
-export declare type BookingContextDateInput = string | Date | {
+export type BookingContextDateInput = string | Date | {
     format?: (fmt?: string) => string;
 } | null | undefined;
 /**

package/lib/modules/BookingContext/utils/resourceErrors.d.ts

@@ -9,7 +9,7 @@
  *
  * OS 这边不耦合 i18n 文案，UI 拿到 reason + params 后自行渲染（参考 docs/SDK 中给出的 i18n key 对照表）。
  */
-export declare type ResourceUnavailableReason = 'no_product' | 'time_out_of_range' | 'count_out_of_range' | 'resource_unbound';
+export type ResourceUnavailableReason = 'no_product' | 'time_out_of_range' | 'count_out_of_range' | 'resource_unbound';
 export interface ResourceError {
     reason: ResourceUnavailableReason;
     params: {

package/lib/modules/Customer/types.d.ts

@@ -33,7 +33,7 @@ export interface ShopCustomer extends ICustomer {
  * walletDetails.wallet: 用户所有wallet
  * latestWalletDetail.wallet: 用户最新wallet
  */
-declare type CustomerWith = 'formRecord' | 'walletDetails.wallet' | 'latestWalletDetail.wallet';
+type CustomerWith = 'formRecord' | 'walletDetails.wallet' | 'latestWalletDetail.wallet';
 /**
  * 获取客户列表参数
  */

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

@@ -0,0 +1,7 @@
+import type { Discount, DiscountFilterRejectKey } from './types';
+/** 周期限制只影响当前使用；total_credits 才代表整张卡的次数耗尽。 */
+export declare function getDiscountUsageLimitFailKey(discount: Discount): DiscountFilterRejectKey | null;
+export declare function hasAvailableDiscountBalance(discount: Discount): boolean;
+/** 按卡本身当前生命周期判断；预约时间或一次日程不匹配不代表已失效。 */
+export declare function getDiscountLifecycleReason(discount: Discount): 'disabled' | 'exhausted' | 'expired' | 'not_shared_at_store' | undefined;
+export declare function getDiscountUsageBlockReason(discount: Discount): string | undefined;

package/lib/modules/Discount/availability.js

@@ -0,0 +1,46 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getDiscountLifecycleReason = getDiscountLifecycleReason;
+exports.getDiscountUsageBlockReason = getDiscountUsageBlockReason;
+exports.getDiscountUsageLimitFailKey = getDiscountUsageLimitFailKey;
+exports.hasAvailableDiscountBalance = hasAvailableDiscountBalance;
+var _dayjs = _interopRequireDefault(require("dayjs"));
+var _decimal = _interopRequireDefault(require("decimal.js"));
+var _entitlementPass = require("./entitlementPass");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+/** 周期限制只影响当前使用；total_credits 才代表整张卡的次数耗尽。 */
+function getDiscountUsageLimitFailKey(discount) {
+  const value = discount.extension_data?.find(field => field.field_key === 'usage_credits')?.value;
+  if (!value) return null;
+  const limits = [['total_credits', discount.total_order_behavior_count], ['per_user_limit', discount.customer_order_behavior_count], ['max_per_day', discount.today_order_behavior_count], ['max_per_week', discount.week_order_behavior_count], ['max_per_month', discount.month_order_behavior_count]];
+  return limits.find(([key, count]) => Number(value[key]) > 0 && Number(count || 0) >= Number(value[key]))?.[0] || null;
+}
+function hasAvailableDiscountBalance(discount) {
+  if ((0, _entitlementPass.isEntitlementPass)(discount)) return (0, _entitlementPass.hasAvailableEntitlementUses)(discount);
+  return new _decimal.default(discount.par_value || 0).minus(discount.used_par_value || 0).greaterThan(0);
+}
+
+/** 按卡本身当前生命周期判断；预约时间或一次日程不匹配不代表已失效。 */
+function getDiscountLifecycleReason(discount) {
+  if (discount.is_franchisor_pass === 1 && discount.franchisee_wallet_pass?.use !== 'enabled') {
+    return 'not_shared_at_store';
+  }
+  if (discount.limit_status && discount.limit_status !== 'enable') {
+    return 'disabled';
+  }
+  if (((0, _entitlementPass.isEntitlementPass)(discount) || discount.par_value != null) && !hasAvailableDiscountBalance(discount) || getDiscountUsageLimitFailKey(discount) === 'total_credits') {
+    return 'exhausted';
+  }
+  // 自定义日程沿用快照语义，不使用遗留固定有效期字段推断过期。
+  if (discount.metadata?.validity_type !== 'custom_schedule_validity' && discount.expire_time) {
+    const expiry = (0, _dayjs.default)(discount.expire_time);
+    if (expiry.isValid() && !(0, _dayjs.default)().isBefore(expiry)) return 'expired';
+  }
+  return undefined;
+}
+function getDiscountUsageBlockReason(discount) {
+  return getDiscountLifecycleReason(discount) || getDiscountUsageLimitFailKey(discount) || (discount.unified_available_status != null && String(discount.unified_available_status) !== '' && Number(discount.unified_available_status) === 0 ? 'server_unavailable' : undefined);
+}

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

@@ -0,0 +1,34 @@
+export declare const ENTITLEMENT_PASS_TYPE = "entitlement_pass";
+export declare const GOOD_PASS_TYPE = "good_pass";
+type DiscountLike = {
+    id?: number | string | null;
+    tag?: unknown;
+    type?: unknown;
+    discount?: object | null;
+    metadata?: object | null;
+    extension_data?: unknown;
+    balance?: unknown;
+    expire_time?: unknown;
+};
+export type EntitlementQuota = {
+    type: 'limited';
+    value: number;
+    balance: number;
+} | {
+    type: 'unlimited';
+    value: null;
+    balance: null;
+};
+export declare function isEntitlementPass(discount: DiscountLike | null | undefined): boolean;
+export declare function isFullCoveragePass(discount: DiscountLike | null | undefined): boolean;
+/**
+ * Resolve the authoritative total-use contract for an Entitlement Pass.
+ * Invalid or missing configuration fails closed. Legacy mode/total_uses fields
+ * are intentionally unsupported.
+ */
+export declare function resolveEntitlementQuota(discount: DiscountLike | null | undefined): EntitlementQuota | null;
+export declare function getRemainingEntitlementUses(discount: DiscountLike | null | undefined, usedCount: number, requestedCount: number): number;
+export declare function hasAvailableEntitlementUses(discount: DiscountLike | null | undefined): boolean;
+/** Sort Entitlement Passes by expiry, finite balance, then card instance id. */
+export declare function compareEntitlementPassPriority(left: DiscountLike, right: DiscountLike): number;
+export {};

package/lib/modules/Discount/entitlementPass.js

@@ -0,0 +1,141 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.GOOD_PASS_TYPE = exports.ENTITLEMENT_PASS_TYPE = void 0;
+exports.compareEntitlementPassPriority = compareEntitlementPassPriority;
+exports.getRemainingEntitlementUses = getRemainingEntitlementUses;
+exports.hasAvailableEntitlementUses = hasAvailableEntitlementUses;
+exports.isEntitlementPass = isEntitlementPass;
+exports.isFullCoveragePass = isFullCoveragePass;
+exports.resolveEntitlementQuota = resolveEntitlementQuota;
+var _dayjs = _interopRequireDefault(require("dayjs"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+const ENTITLEMENT_PASS_TYPE = exports.ENTITLEMENT_PASS_TYPE = 'entitlement_pass';
+const GOOD_PASS_TYPE = exports.GOOD_PASS_TYPE = 'good_pass';
+function getDiscountType(discount) {
+  const nestedDiscount = discount?.discount;
+  return String(discount?.tag || discount?.type || nestedDiscount?.tag || nestedDiscount?.type || '');
+}
+function isEntitlementPass(discount) {
+  return getDiscountType(discount) === ENTITLEMENT_PASS_TYPE;
+}
+function isFullCoveragePass(discount) {
+  const type = getDiscountType(discount);
+  return type === GOOD_PASS_TYPE || type === ENTITLEMENT_PASS_TYPE;
+}
+function resolveIncludedUses(discount) {
+  const metadata = discount.metadata;
+  const hasMetadataIncludedUses = !!metadata && typeof metadata === 'object' && Object.prototype.hasOwnProperty.call(metadata, 'included_uses');
+  const rawValue = hasMetadataIncludedUses ? metadata?.included_uses : Array.isArray(discount.extension_data) ? discount.extension_data.find(item => item?.field_key === 'included_uses')?.value : undefined;
+  if (!rawValue || typeof rawValue !== 'object' || Array.isArray(rawValue)) {
+    return null;
+  }
+  const includedUses = rawValue;
+  if (includedUses.type === 'unlimited' && includedUses.value === null) {
+    return {
+      type: 'unlimited',
+      value: null
+    };
+  }
+  if (includedUses.type === 'limited' && typeof includedUses.value === 'number' && Number.isInteger(includedUses.value) && includedUses.value >= 1 && includedUses.value <= 9999) {
+    return {
+      type: 'limited',
+      value: includedUses.value
+    };
+  }
+  return null;
+}
+function resolveNonNegativeInteger(value) {
+  if (typeof value !== 'number' && typeof value !== 'string' || typeof value === 'string' && value.trim() === '') {
+    return null;
+  }
+  const normalizedValue = Number(value);
+  if (!Number.isInteger(normalizedValue) || normalizedValue < 0) return null;
+  return normalizedValue;
+}
+
+/**
+ * Resolve the authoritative total-use contract for an Entitlement Pass.
+ * Invalid or missing configuration fails closed. Legacy mode/total_uses fields
+ * are intentionally unsupported.
+ */
+function resolveEntitlementQuota(discount) {
+  if (!isEntitlementPass(discount)) return null;
+  const includedUses = resolveIncludedUses(discount);
+  if (!includedUses) return null;
+  if (includedUses.type === 'unlimited') {
+    return {
+      type: 'unlimited',
+      value: null,
+      balance: null
+    };
+  }
+  const balance = resolveNonNegativeInteger(discount?.balance);
+  if (balance === null) return null;
+  return {
+    type: 'limited',
+    value: includedUses.value,
+    balance
+  };
+}
+function getRemainingEntitlementUses(discount, usedCount, requestedCount) {
+  const quota = resolveEntitlementQuota(discount);
+  const normalizedRequestedCount = Math.max(Math.floor(Number(requestedCount) || 0), 0);
+  if (!quota || normalizedRequestedCount <= 0) return 0;
+  if (quota.type === 'unlimited') return normalizedRequestedCount;
+  const normalizedUsedCount = Math.max(Math.floor(Number(usedCount) || 0), 0);
+  return Math.min(Math.max(quota.balance - normalizedUsedCount, 0), normalizedRequestedCount);
+}
+function hasAvailableEntitlementUses(discount) {
+  const quota = resolveEntitlementQuota(discount);
+  return !!quota && (quota.type === 'unlimited' || quota.balance > 0);
+}
+function resolveExpireTimestamp(value) {
+  if (typeof value !== 'string' || !value.trim()) return Number.POSITIVE_INFINITY;
+  const normalizedValue = value.trim();
+  const calendarParts = normalizedValue.match(/^(\d{4})-(\d{2})-(\d{2})(?:[T ](\d{2}):(\d{2})(?::(\d{2}))?)?/);
+  if (calendarParts) {
+    const [, year, month, day, hour = '0', minute = '0', second = '0'] = calendarParts;
+    const yearNumber = Number(year);
+    const monthNumber = Number(month);
+    const dayNumber = Number(day);
+    const hourNumber = Number(hour);
+    const minuteNumber = Number(minute);
+    const secondNumber = Number(second);
+    const daysInMonth = new Date(Date.UTC(yearNumber, monthNumber, 0)).getUTCDate();
+    if (yearNumber <= 0 || monthNumber < 1 || monthNumber > 12 || dayNumber < 1 || dayNumber > daysInMonth || hourNumber < 0 || hourNumber > 23 || minuteNumber < 0 || minuteNumber > 59 || secondNumber < 0 || secondNumber > 59) {
+      return Number.POSITIVE_INFINITY;
+    }
+  }
+  const date = (0, _dayjs.default)(normalizedValue);
+  return date.isValid() ? date.valueOf() : Number.POSITIVE_INFINITY;
+}
+function compareIds(left, right) {
+  const leftNumber = Number(left);
+  const rightNumber = Number(right);
+  if (Number.isFinite(leftNumber) && Number.isFinite(rightNumber)) {
+    return leftNumber - rightNumber;
+  }
+  return String(left ?? '').localeCompare(String(right ?? ''), undefined, {
+    numeric: true
+  });
+}
+
+/** Sort Entitlement Passes by expiry, finite balance, then card instance id. */
+function compareEntitlementPassPriority(left, right) {
+  const expireDifference = resolveExpireTimestamp(left.expire_time) - resolveExpireTimestamp(right.expire_time);
+  if (!Number.isNaN(expireDifference) && expireDifference !== 0) {
+    return expireDifference;
+  }
+  const leftQuota = resolveEntitlementQuota(left);
+  const rightQuota = resolveEntitlementQuota(right);
+  const leftBalance = leftQuota?.type === 'limited' ? leftQuota.balance : Number.POSITIVE_INFINITY;
+  const rightBalance = rightQuota?.type === 'limited' ? rightQuota.balance : Number.POSITIVE_INFINITY;
+  const balanceDifference = leftBalance - rightBalance;
+  if (!Number.isNaN(balanceDifference) && balanceDifference !== 0) {
+    return balanceDifference;
+  }
+  return compareIds(left.id, right.id);
+}

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

@@ -0,0 +1,8 @@
+import type { Discount } from './types';
+export declare function hasEntitlementDiscount(product: any): boolean;
+export declare function isPersistedEntitlementLine(product: any, mappedProduct?: any): boolean;
+/** Refresh authoritative balances while retaining the user's scan/selection state. */
+export declare function mergeEntitlementDiscountLists(current: Discount[], incoming: Discount[], observed?: Discount[]): Discount[];
+export declare function retainScannedEntitlements(current: Discount[], scanned: Discount[]): Discount[];
+/** Historical uses are display records; backend balance already excludes them. */
+export declare function withCommittedEntitlementDetails(discounts: Discount[], products: any[], getProduct: (item: any) => any): Discount[];

package/lib/modules/Discount/entitlementState.js

@@ -0,0 +1,150 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.hasEntitlementDiscount = hasEntitlementDiscount;
+exports.isPersistedEntitlementLine = isPersistedEntitlementLine;
+exports.mergeEntitlementDiscountLists = mergeEntitlementDiscountLists;
+exports.retainScannedEntitlements = retainScannedEntitlements;
+exports.withCommittedEntitlementDetails = withCommittedEntitlementDetails;
+var _lodashEs = require("lodash-es");
+var _decimal = _interopRequireDefault(require("decimal.js"));
+var _availability = require("./availability");
+var _entitlementPass = require("./entitlementPass");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function getEntitlementDiscountLines(product) {
+  const nested = product?._origin?.product ?? product?._originData?.product;
+  return [{
+    discount_list: product?.discount_list ?? nested?.discount_list ?? []
+  }, ...(product?.product_bundle ?? product?.bundle ?? product?._extend?.other?.bundle ?? nested?.product_bundle ?? [])];
+}
+function hasEntitlementDiscount(product) {
+  return getEntitlementDiscountLines(product).some(line => (line.discount_list || []).some(_entitlementPass.isEntitlementPass));
+}
+function isPersistedEntitlementLine(product, mappedProduct) {
+  const nested = product?._origin?.product ?? product?._originData?.product;
+  const persisted = [product?.order_detail_id, product?.booking_id, product?._origin?.booking_id, product?._originData?.booking_id, product?._extend?.order_detail_id, nested?.order_detail_id, nested?.booking_id, mappedProduct?.order_detail_id, mappedProduct?.booking_id].some(value => value !== undefined && value !== null && value !== '' && value !== 0 && value !== '0');
+  const lines = getEntitlementDiscountLines(mappedProduct ?? product);
+  // 已有预约上刚选的卡仍属本次使用，只有接口回传的明细才计入历史。
+  return lines.some(line => (line.discount_list || []).some(_entitlementPass.isEntitlementPass)) && (persisted && product?.metadata?.entitlement_source_identity == null || lines.some(line => (line.discount_list || []).some(item => (0, _entitlementPass.isEntitlementPass)(item) && item.id)));
+}
+
+/** Refresh authoritative balances while retaining the user's scan/selection state. */
+function mergeEntitlementDiscountLists(current, incoming, observed = incoming) {
+  const previous = new Map(current.map(item => [String(item.id), item]));
+  const observedById = new Map(observed.map(item => [String(item.id), item]));
+  const next = new Map();
+  current.filter(item => item.isScan).forEach(item => {
+    const fresh = observedById.get(String(item.id));
+    if ((0, _entitlementPass.isEntitlementPass)(item) && (0, _availability.getDiscountLifecycleReason)(fresh || item)) return;
+    next.set(String(item.id), item);
+  });
+  incoming.forEach(item => {
+    const old = previous.get(String(item.id));
+    if (old?.isScan && !(0, _entitlementPass.isEntitlementPass)(item)) return;
+    next.set(String(item.id), old && (0, _entitlementPass.isEntitlementPass)(item) ? {
+      ...item,
+      isScan: old.isScan,
+      isSelected: old.isSelected,
+      isManualSelect: old.isManualSelect
+    } : item);
+  });
+  return [...next.values()];
+}
+function retainScannedEntitlements(current, scanned) {
+  const result = new Map(current.map(item => [String(item.id), item]));
+  scanned.filter(item => (0, _entitlementPass.isEntitlementPass)(item) && !(0, _availability.getDiscountLifecycleReason)(item)).forEach(item => {
+    const previous = result.get(String(item.id));
+    const committed = item.committedAppliedProductDetails || previous?.committedAppliedProductDetails || [];
+    const isAvailable = !!item.isAvailable;
+    result.set(String(item.id), {
+      ...item,
+      isScan: true,
+      isAvailable,
+      isSelected: committed.length > 0,
+      reasonCode: isAvailable ? undefined : item.reasonCode || 'product_not_applicable',
+      committedAppliedProductDetails: committed,
+      appliedProductDetails: committed,
+      savedAmount: committed.length ? previous?.savedAmount : 0
+    });
+  });
+  return [...result.values()];
+}
+
+/** Historical uses are display records; backend balance already excludes them. */
+function withCommittedEntitlementDetails(discounts, products, getProduct) {
+  const savedAmount = details => details.reduce((sum, detail) => sum.plus(new _decimal.default(detail.discount?.fixed_amount || 0).times(detail._num)), new _decimal.default(0)).toNumber();
+  const committed = new Map();
+  for (const origin of products) {
+    const product = getProduct(origin);
+    const persisted = isPersistedEntitlementLine(origin, product);
+    const lines = [product, ...(product.bundle || [])];
+    const bundleKeys = new Set((product.bundle || []).flatMap(line => (line.discount_list || []).map(detail => `${detail.discount?.resource_id ?? detail.id}:${detail.metadata?.custom_product_bundle_map_id}`)));
+    for (const line of lines) {
+      for (const detail of line.discount_list || []) {
+        const bundleId = detail.metadata?.custom_product_bundle_map_id;
+        if (!(0, _entitlementPass.isEntitlementPass)(detail) || !persisted && !detail.id || line === product && bundleId && bundleKeys.has(`${detail.discount?.resource_id ?? detail.id}:${bundleId}`)) continue;
+        const id = detail.discount?.resource_id ?? detail.resource_id ?? detail.id;
+        if (id == null) continue;
+        const lineUses = Number(detail.metadata?.num ?? line.num ?? line.quantity ?? 1);
+        if (!Number.isFinite(lineUses) || lineUses <= 0) continue;
+        const count = lineUses * (line === product && !bundleId ? 1 : Number(product.quantity ?? product.num ?? 1));
+        const list = committed.get(String(id)) || [];
+        list.push({
+          ...(0, _lodashEs.cloneDeep)(detail),
+          _num: count,
+          metadata: {
+            ...detail.metadata,
+            num: count
+          },
+          discount: {
+            ...detail.discount,
+            fixed_amount: detail.discount?.fixed_amount ?? new _decimal.default(detail.amount || 0).div(bundleId ? lineUses : 1).toNumber()
+          }
+        });
+        committed.set(String(id), list);
+      }
+    }
+  }
+  const next = discounts.map(item => {
+    if (!(0, _entitlementPass.isEntitlementPass)(item)) return item;
+    const details = committed.get(String(item.id)) || [];
+    committed.delete(String(item.id));
+    return {
+      ...item,
+      committedAppliedProductDetails: details,
+      isEditMode: details.length > 0 && !(0, _entitlementPass.resolveEntitlementQuota)(item),
+      ...(item.isEditMode && (0, _entitlementPass.resolveEntitlementQuota)(item) ? {
+        isDisabled: false
+      } : {}),
+      ...(details.length && !(0, _entitlementPass.resolveEntitlementQuota)(item) ? {
+        isSelected: true,
+        isDisabled: true,
+        isUsed: true,
+        appliedProductDetails: details,
+        savedAmount: savedAmount(details)
+      } : {})
+    };
+  });
+  committed.forEach((details, id) => {
+    const first = details[0];
+    next.push({
+      ...first,
+      id: Number(id),
+      tag: 'entitlement_pass',
+      type: 'entitlement_pass',
+      format_title: first.discount?.title,
+      isEditMode: true,
+      isSelected: true,
+      isDisabled: true,
+      isUsed: true,
+      isAvailable: true,
+      committedAppliedProductDetails: details,
+      appliedProductDetails: details,
+      applicableProductDetails: [],
+      savedAmount: savedAmount(details)
+    });
+  });
+  return next;
+}

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

@@ -27,11 +27,14 @@ export declare class DiscountModule extends BaseModule implements Module, Discou
         with_available_wallet_pass_flag?: 0 | 1;
         request_timezone: string;
         order_id?: number | string;
+        with_entitlement_pass?: 0 | 1;
+        filter_order_wallet_pass_usage?: 0 | 1;
     }): Promise<DiscountPrepareConfigResult>;
     private extractAvailableWalletIds;
-    batchSearch(code: string, options?: {
+    batchSearch(code: string, customerIdOrOptions?: number | {
         customerId?: number;
-        orderId?: number;
+        orderId?: number | string;
+        withEntitlementPass?: boolean;
     }): Promise<DiscountWithReason>;
     batchSearchByProductIds(productIds: number[]): Promise<any>;
     filterEnabledDiscountList(discountList: Discount[]): Discount[];