@pisell/pisellos 0.0.571 → 0.0.572

package/dist/effects/index.d.ts

@@ -1,8 +1,8 @@
-declare type EffectCallback = (payload: any) => void | Promise<void | {
+type EffectCallback = (payload: any) => void | Promise<void | {
     status: boolean;
     message?: string;
 }>;
-declare type UnsubscribeFunction = () => void;
+type UnsubscribeFunction = () => void;
 declare class EffectsManager {
     private listeners;
     on(event: string, callback: EffectCallback): UnsubscribeFunction;

package/dist/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/dist/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/dist/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/dist/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/dist/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/dist/model/strategy/adapter/walletPass/evaluator.js

@@ -283,7 +283,7 @@ export var WalletPassEvaluator = /*#__PURE__*/function () {
   }, {
     key: "checkVoucherAvailability",
     value: function checkVoucherAvailability(input) {
-      var _results$, _results$2;
+      var _results$, _results$2, _results$3, _results$4;
       var orderTotalAmount = input.orderTotalAmount,
         products = input.products,
         vouchers = input.vouchers;
@@ -291,7 +291,9 @@ export var WalletPassEvaluator = /*#__PURE__*/function () {
       var isAvailable = ((_results$ = results[0]) === null || _results$ === void 0 ? void 0 : _results$.isApplicable) || false;
       return {
         isAvailable: isAvailable,
-        config: _objectSpread({}, (_results$2 = results[0]) === null || _results$2 === void 0 || (_results$2 = _results$2.strategyResult) === null || _results$2 === void 0 || (_results$2 = _results$2.config) === null || _results$2 === void 0 || (_results$2 = _results$2.metadata) === null || _results$2 === void 0 ? void 0 : _results$2.custom)
+        reason: (_results$2 = results[0]) === null || _results$2 === void 0 ? void 0 : _results$2.reason,
+        reasonCode: (_results$3 = results[0]) === null || _results$3 === void 0 ? void 0 : _results$3.reasonCode,
+        config: _objectSpread({}, (_results$4 = results[0]) === null || _results$4 === void 0 || (_results$4 = _results$4.strategyResult) === null || _results$4 === void 0 || (_results$4 = _results$4.config) === null || _results$4 === void 0 || (_results$4 = _results$4.metadata) === null || _results$4 === void 0 ? void 0 : _results$4.custom)
       };
     }
 

package/dist/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/dist/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/dist/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/dist/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/dist/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/dist/modules/Discount/availability.js

@@ -0,0 +1,52 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+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; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import dayjs from 'dayjs';
+import Decimal from 'decimal.js';
+import { hasAvailableEntitlementUses, isEntitlementPass } from "./entitlementPass";
+
+/** 周期限制只影响当前使用；total_credits 才代表整张卡的次数耗尽。 */
+export function getDiscountUsageLimitFailKey(discount) {
+  var _discount$extension_d, _limits$find;
+  var value = (_discount$extension_d = discount.extension_data) === null || _discount$extension_d === void 0 || (_discount$extension_d = _discount$extension_d.find(function (field) {
+    return field.field_key === 'usage_credits';
+  })) === null || _discount$extension_d === void 0 ? void 0 : _discount$extension_d.value;
+  if (!value) return null;
+  var 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 = limits.find(function (_ref) {
+    var _ref2 = _slicedToArray(_ref, 2),
+      key = _ref2[0],
+      count = _ref2[1];
+    return Number(value[key]) > 0 && Number(count || 0) >= Number(value[key]);
+  })) === null || _limits$find === void 0 ? void 0 : _limits$find[0]) || null;
+}
+export function hasAvailableDiscountBalance(discount) {
+  if (isEntitlementPass(discount)) return hasAvailableEntitlementUses(discount);
+  return new Decimal(discount.par_value || 0).minus(discount.used_par_value || 0).greaterThan(0);
+}
+
+/** 按卡本身当前生命周期判断；预约时间或一次日程不匹配不代表已失效。 */
+export function getDiscountLifecycleReason(discount) {
+  var _discount$franchisee_, _discount$metadata;
+  if (discount.is_franchisor_pass === 1 && ((_discount$franchisee_ = discount.franchisee_wallet_pass) === null || _discount$franchisee_ === void 0 ? void 0 : _discount$franchisee_.use) !== 'enabled') {
+    return 'not_shared_at_store';
+  }
+  if (discount.limit_status && discount.limit_status !== 'enable') {
+    return 'disabled';
+  }
+  if ((isEntitlementPass(discount) || discount.par_value != null) && !hasAvailableDiscountBalance(discount) || getDiscountUsageLimitFailKey(discount) === 'total_credits') {
+    return 'exhausted';
+  }
+  // 自定义日程沿用快照语义，不使用遗留固定有效期字段推断过期。
+  if (((_discount$metadata = discount.metadata) === null || _discount$metadata === void 0 ? void 0 : _discount$metadata.validity_type) !== 'custom_schedule_validity' && discount.expire_time) {
+    var expiry = dayjs(discount.expire_time);
+    if (expiry.isValid() && !dayjs().isBefore(expiry)) return 'expired';
+  }
+  return undefined;
+}
+export 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/dist/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/dist/modules/Discount/entitlementPass.js

@@ -0,0 +1,147 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+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; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+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); }
+import dayjs from 'dayjs';
+export var ENTITLEMENT_PASS_TYPE = 'entitlement_pass';
+export var GOOD_PASS_TYPE = 'good_pass';
+function getDiscountType(discount) {
+  var nestedDiscount = discount === null || discount === void 0 ? void 0 : discount.discount;
+  return String((discount === null || discount === void 0 ? void 0 : discount.tag) || (discount === null || discount === void 0 ? void 0 : discount.type) || (nestedDiscount === null || nestedDiscount === void 0 ? void 0 : nestedDiscount.tag) || (nestedDiscount === null || nestedDiscount === void 0 ? void 0 : nestedDiscount.type) || '');
+}
+export function isEntitlementPass(discount) {
+  return getDiscountType(discount) === ENTITLEMENT_PASS_TYPE;
+}
+export function isFullCoveragePass(discount) {
+  var type = getDiscountType(discount);
+  return type === GOOD_PASS_TYPE || type === ENTITLEMENT_PASS_TYPE;
+}
+function resolveIncludedUses(discount) {
+  var _discount$extension_d;
+  var metadata = discount.metadata;
+  var hasMetadataIncludedUses = !!metadata && _typeof(metadata) === 'object' && Object.prototype.hasOwnProperty.call(metadata, 'included_uses');
+  var rawValue = hasMetadataIncludedUses ? metadata === null || metadata === void 0 ? void 0 : metadata.included_uses : Array.isArray(discount.extension_data) ? (_discount$extension_d = discount.extension_data.find(function (item) {
+    return (item === null || item === void 0 ? void 0 : item.field_key) === 'included_uses';
+  })) === null || _discount$extension_d === void 0 ? void 0 : _discount$extension_d.value : undefined;
+  if (!rawValue || _typeof(rawValue) !== 'object' || Array.isArray(rawValue)) {
+    return null;
+  }
+  var 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;
+  }
+  var 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.
+ */
+export function resolveEntitlementQuota(discount) {
+  if (!isEntitlementPass(discount)) return null;
+  var includedUses = resolveIncludedUses(discount);
+  if (!includedUses) return null;
+  if (includedUses.type === 'unlimited') {
+    return {
+      type: 'unlimited',
+      value: null,
+      balance: null
+    };
+  }
+  var balance = resolveNonNegativeInteger(discount === null || discount === void 0 ? void 0 : discount.balance);
+  if (balance === null) return null;
+  return {
+    type: 'limited',
+    value: includedUses.value,
+    balance: balance
+  };
+}
+export function getRemainingEntitlementUses(discount, usedCount, requestedCount) {
+  var quota = resolveEntitlementQuota(discount);
+  var normalizedRequestedCount = Math.max(Math.floor(Number(requestedCount) || 0), 0);
+  if (!quota || normalizedRequestedCount <= 0) return 0;
+  if (quota.type === 'unlimited') return normalizedRequestedCount;
+  var normalizedUsedCount = Math.max(Math.floor(Number(usedCount) || 0), 0);
+  return Math.min(Math.max(quota.balance - normalizedUsedCount, 0), normalizedRequestedCount);
+}
+export function hasAvailableEntitlementUses(discount) {
+  var quota = resolveEntitlementQuota(discount);
+  return !!quota && (quota.type === 'unlimited' || quota.balance > 0);
+}
+function resolveExpireTimestamp(value) {
+  if (typeof value !== 'string' || !value.trim()) return Number.POSITIVE_INFINITY;
+  var normalizedValue = value.trim();
+  var calendarParts = normalizedValue.match(/^(\d{4})-(\d{2})-(\d{2})(?:[T ](\d{2}):(\d{2})(?::(\d{2}))?)?/);
+  if (calendarParts) {
+    var _calendarParts = _slicedToArray(calendarParts, 7),
+      year = _calendarParts[1],
+      month = _calendarParts[2],
+      day = _calendarParts[3],
+      _calendarParts$ = _calendarParts[4],
+      hour = _calendarParts$ === void 0 ? '0' : _calendarParts$,
+      _calendarParts$2 = _calendarParts[5],
+      minute = _calendarParts$2 === void 0 ? '0' : _calendarParts$2,
+      _calendarParts$3 = _calendarParts[6],
+      second = _calendarParts$3 === void 0 ? '0' : _calendarParts$3;
+    var yearNumber = Number(year);
+    var monthNumber = Number(month);
+    var dayNumber = Number(day);
+    var hourNumber = Number(hour);
+    var minuteNumber = Number(minute);
+    var secondNumber = Number(second);
+    var 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;
+    }
+  }
+  var date = dayjs(normalizedValue);
+  return date.isValid() ? date.valueOf() : Number.POSITIVE_INFINITY;
+}
+function compareIds(left, right) {
+  var leftNumber = Number(left);
+  var rightNumber = Number(right);
+  if (Number.isFinite(leftNumber) && Number.isFinite(rightNumber)) {
+    return leftNumber - rightNumber;
+  }
+  return String(left !== null && left !== void 0 ? left : '').localeCompare(String(right !== null && right !== void 0 ? right : ''), undefined, {
+    numeric: true
+  });
+}
+
+/** Sort Entitlement Passes by expiry, finite balance, then card instance id. */
+export function compareEntitlementPassPriority(left, right) {
+  var expireDifference = resolveExpireTimestamp(left.expire_time) - resolveExpireTimestamp(right.expire_time);
+  if (!Number.isNaN(expireDifference) && expireDifference !== 0) {
+    return expireDifference;
+  }
+  var leftQuota = resolveEntitlementQuota(left);
+  var rightQuota = resolveEntitlementQuota(right);
+  var leftBalance = (leftQuota === null || leftQuota === void 0 ? void 0 : leftQuota.type) === 'limited' ? leftQuota.balance : Number.POSITIVE_INFINITY;
+  var rightBalance = (rightQuota === null || rightQuota === void 0 ? void 0 : rightQuota.type) === 'limited' ? rightQuota.balance : Number.POSITIVE_INFINITY;
+  var balanceDifference = leftBalance - rightBalance;
+  if (!Number.isNaN(balanceDifference) && balanceDifference !== 0) {
+    return balanceDifference;
+  }
+  return compareIds(left.id, right.id);
+}

package/dist/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[];