@pisell/pisellos 0.10.43 → 0.10.45

package/dist/solution/UnifiedBookingSales/types.d.ts

@@ -1,8 +1,12 @@
 import type { InvoiceLayoutConfig, InvoiceTemplateSettings, OpenDataConfig } from '../../modules/OpenData';
-import type { ProductListLoadProductsParams } from '../../modules/ProductList';
+import type { ProductListLoadProductsParams, ProductListStoreQueryParams } from '../../modules/ProductList';
+import type { ProductData } from '../../modules/Product/types';
 import type { LoadScheduleAvailableDateParams } from '../../modules/Schedule/types';
 import type { AvailabilityDateRange, AvailabilityErrorCode, AvailabilityId, AvailabilityOccupancy, AvailabilityProduct, AvailabilityProjection, AvailabilityQuery, AvailabilityRequirementSelection, AvailabilityResource, AvailabilitySelectionValidationResult, DateAvailabilityQueryResult, GetProductTimeRangesRequest, ProductAvailabilityQueryResult, ProductTimeRange, ProductTimeRangeGroup, ResourceAvailabilityGroup, ResourceAvailabilityRangeGroup, TimeAvailabilityGroup, TimeAvailabilityItem } from '../../modules/ResourcePlanner';
 import type { BookingTicketState } from '../BookingTicket/types';
+import type { AllergyRequirement } from '../../model/strategy/adapter/itemRule';
+import type { SalesNoteDraftInput } from '../../modules/Order/types';
+export type { ProductListStoreQueryParams } from '../../modules/ProductList';
 export type { AvailabilityAbsoluteRange, AvailabilityAssignment, AvailabilityCell, AvailabilityDateRange, AvailabilityDisplayRange, AvailabilityErrorCode, AvailabilityId, AvailabilityMode, AvailabilityOccupancy, AvailabilityProduct, AvailabilityProductKind, AvailabilityProjection, AvailabilityProjectionInput, AvailabilityProjectionMeta, AvailabilityQuery, AvailabilityQueryResult, AvailabilityRequirementGroup, AvailabilityRequirementGroupResult, AvailabilityRequirementSelection, AvailabilityResource, AvailabilityResourceOption, AvailabilityResourceType, AvailabilityResourceWindow, AvailabilityScheduleMode, AvailabilityScheduleRef, AvailabilityScheduleRule, AvailabilitySelectionValidationParams, AvailabilitySelectionValidationResult, AvailabilitySessionRange, AvailabilityStatus, DateAvailabilityGroup, DateAvailabilityItem, DateAvailabilityQuery, DateAvailabilityQueryResult, GetProductTimeRangesRequest, ProductAvailabilityGroup, ProductAvailabilityItem, ProductAvailabilityQuery, ProductAvailabilityQueryResult, ProductTimeRange, ProductTimeRangeGroup, QueryAvailabilityBaseRequest, ResourceAvailabilityGroup, ResourceAvailabilityQuery, ResourceAvailabilityQueryResult, ResourceAvailabilityRangeGroup, TimeAvailabilityGroup, TimeAvailabilityItem, TimeAvailabilityQuery, TimeAvailabilityQueryResult, } from '../../modules/ResourcePlanner';
 export interface UnifiedBookingSalesState extends BookingTicketState {
 }
@@ -24,6 +28,12 @@ export declare enum UnifiedBookingSalesHooks {
 export interface UnifiedBookingSalesOtherParams extends Record<string, any> {
     enableSessionStoragePersist?: boolean;
 }
+export type UnifiedBookingSalesAllergyRequirement = AllergyRequirement;
+export interface UnifiedBookingSalesResolveProductAllergyRequirementParams {
+    productId: number | string;
+    productVariantId?: number | string;
+    channel?: string;
+}
 export interface UnifiedBookingSalesLoadOpenDataParams {
     businessCode: string;
     channel: string;
@@ -151,6 +161,8 @@ export interface ContextualCommitAvailabilitySelectionParams {
     requirementSelections: AvailabilityRequirementSelection[];
     partySize: number;
     bookingCount?: number;
+    /** 新增商品行时与商品、预约在同一次 Order mutation 内写入的 Sales Notes。 */
+    salesNotes?: SalesNoteDraftInput[];
     /** 编辑预约时，允许本次显式报价覆盖已落库订单行的历史价格。 */
     allowBookingReprice?: boolean;
     /** 编辑预约重报价后，允许订单模块重新应用已选编辑态折扣。 */
@@ -214,6 +226,7 @@ export interface UnifiedBookingSalesApi {
     /** Date-first calendar availability backed by ScheduleModule. */
     loadScheduleAvailableDate: (params: LoadScheduleAvailableDateParams) => Promise<unknown>;
     loadProductsByScheduleDate: (params: UnifiedBookingSalesLoadProductsByScheduleDateParams) => Promise<unknown[]>;
+    queryProducts: (params?: ProductListStoreQueryParams) => Promise<ProductData[]>;
     stageRetailProducts: (params: UnifiedBookingSalesStageRetailProductsParams) => Promise<Record<string, any> | null>;
     addRetailProduct: (params: UnifiedBookingSalesAddRetailProductParams) => Promise<Record<string, any>[]>;
     prepareAvailabilityProjection: (params: UnifiedBookingSalesPrepareAvailabilityProjectionParams) => Promise<AvailabilityContextRef>;

package/dist/solution/VenueBooking/index.d.ts

@@ -15,6 +15,7 @@ interface VenueBookingItemRuleRuntimeConfig {
     pax?: Partial<PaxInfo>;
     historicalItems?: CartItemSummary[];
     serviceType?: string;
+    channel?: string;
     submissionIndex?: number;
     custom?: Record<string, any>;
 }

package/dist/solution/VenueBooking/index.js

@@ -3140,7 +3140,11 @@ export var VenueBookingImpl = /*#__PURE__*/function (_BaseSalesImpl) {
   }, {
     key: "getItemRuleRuntimeConfig",
     value: function getItemRuleRuntimeConfig() {
-      return this.itemRuleRuntimeConfig || {};
+      var _ref6, _runtimeConfig$channe, _runtimeConfig$custom, _this$otherParams21;
+      var runtimeConfig = this.itemRuleRuntimeConfig || {};
+      return _objectSpread(_objectSpread({}, runtimeConfig), {}, {
+        channel: (_ref6 = (_runtimeConfig$channe = runtimeConfig.channel) !== null && _runtimeConfig$channe !== void 0 ? _runtimeConfig$channe : (_runtimeConfig$custom = runtimeConfig.custom) === null || _runtimeConfig$custom === void 0 ? void 0 : _runtimeConfig$custom.channel) !== null && _ref6 !== void 0 ? _ref6 : (_this$otherParams21 = this.otherParams) === null || _this$otherParams21 === void 0 ? void 0 : _this$otherParams21.channel
+      });
     }
   }, {
     key: "ensureItemRuleConfigsLoaded",
@@ -3806,14 +3810,14 @@ export var VenueBookingImpl = /*#__PURE__*/function (_BaseSalesImpl) {
     key: "setOtherParams",
     value: function () {
       var _setOtherParams = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee46(params) {
-        var _ref7,
-          _ref7$cover,
+        var _ref8,
+          _ref8$cover,
           cover,
           _args46 = arguments;
         return _regeneratorRuntime().wrap(function _callee46$(_context46) {
           while (1) switch (_context46.prev = _context46.next) {
             case 0:
-              _ref7 = _args46.length > 1 && _args46[1] !== undefined ? _args46[1] : {}, _ref7$cover = _ref7.cover, cover = _ref7$cover === void 0 ? false : _ref7$cover;
+              _ref8 = _args46.length > 1 && _args46[1] !== undefined ? _args46[1] : {}, _ref8$cover = _ref8.cover, cover = _ref8$cover === void 0 ? false : _ref8$cover;
               if (cover) {
                 this.otherParams = params;
               } else {

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

@@ -1,6 +1,6 @@
 import type { EvaluationResult, RuntimeContext, ActionEffect } from '../../type';
 import type { BusinessAdapter } from '../type';
-import { type ItemRuleBusinessData, type QuantityCheckResult, type PrefillItemResult, type QuantityLimitResult } from './type';
+import { type ItemRuleBusinessData, type QuantityCheckResult, type PrefillItemResult, type QuantityLimitResult, type AllergyRequirement } from './type';
 /**
  * ItemRule 适配器
  *
@@ -14,7 +14,10 @@ export declare class ItemRuleAdapter implements BusinessAdapter {
     transformResult(result: EvaluationResult, businessData?: ItemRuleBusinessData): {
         quantityChecks: QuantityCheckResult[];
         prefillItems: PrefillItemResult[];
+        allergyRequirements: AllergyRequirement[];
     };
+    private processAllergyCheck;
+    private normalizeAllergyDataSourceItems;
     formatConfig(result: EvaluationResult, businessData?: ItemRuleBusinessData): {
         result: EvaluationResult;
         businessData?: ItemRuleBusinessData;

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

@@ -19,14 +19,17 @@ class ItemRuleAdapter {
       pax,
       cartItems,
       serviceType,
+      channel,
       submissionIndex,
       custom
     } = businessData;
+    const resolvedChannel = String(channel ?? custom?.channel ?? '').trim();
     return {
       entities: {
         cartItems,
         historicalItems: businessData.historicalItems || [],
-        pax
+        pax,
+        currentProduct: businessData.currentProduct
       },
       attributes: {
         serviceType: serviceType || '',
@@ -36,7 +39,8 @@ class ItemRuleAdapter {
         submissionIndex: submissionIndex ?? 0,
         cartItemCount: cartItems.length,
         cartTotalQuantity: cartItems.reduce((sum, item) => sum + item.quantity, 0),
-        ...custom
+        ...custom,
+        channel: resolvedChannel
       },
       metadata: {
         timestamp: Date.now()
@@ -46,10 +50,12 @@ class ItemRuleAdapter {
   transformResult(result, businessData) {
     const quantityChecks = [];
     const prefillItems = [];
+    const allergyRequirements = [];
     if (!result.applicable || !businessData) {
       return {
         quantityChecks,
-        prefillItems
+        prefillItems,
+        allergyRequirements
       };
     }
     for (const action of result.matchedActions) {
@@ -61,13 +67,76 @@ class ItemRuleAdapter {
       } else if (action.type === _type.ITEM_RULE_ACTION_TYPES.PREFILL_CART) {
         const items = this.processPrefillCart(action, businessData);
         prefillItems.push(...items);
+      } else if (action.type === _type.ITEM_RULE_ACTION_TYPES.ALLERGY_CHECK) {
+        const requirement = this.processAllergyCheck(action, result, businessData);
+        if (requirement) allergyRequirements.push(requirement);
       }
     }
     return {
       quantityChecks,
-      prefillItems
+      prefillItems,
+      allergyRequirements
     };
   }
+
+  // ============================================
+  // Allergy Check 处理
+  // ============================================
+
+  processAllergyCheck(action, result, businessData) {
+    const config = action.config;
+    const currentProduct = businessData.currentProduct;
+    if (!config || config.targetType !== 'product' || config.promptScope !== 'once_per_order_product' || !Array.isArray(config.targets) || !currentProduct) {
+      return null;
+    }
+    const currentProductId = Number(currentProduct.product_id);
+    const currentVariantId = Number(currentProduct.product_variant_id ?? 0);
+    if (!Number.isFinite(currentProductId) || currentProductId <= 0) return null;
+    const productTargets = config.targets.filter(item => Number(item.product_id) === currentProductId);
+    const target = productTargets.find(item => currentVariantId > 0 && Number(item.product_variant_id ?? 0) === currentVariantId) ?? productTargets.find(item => Number(item.product_variant_id ?? 0) <= 0);
+    if (!target || target.dataSource?.type !== 'inline') return null;
+    const items = this.normalizeAllergyDataSourceItems(target.dataSource.items);
+    if (!items.length) return null;
+    return {
+      strategyId: result.config.metadata.id,
+      ruleId: action.id,
+      priority: action.priority ?? 0,
+      targetType: 'product',
+      product_id: currentProductId,
+      ...(Number(target.product_variant_id ?? 0) > 0 ? {
+        product_variant_id: Number(target.product_variant_id)
+      } : {}),
+      dataSource: {
+        type: 'inline',
+        items
+      },
+      promptScope: config.promptScope,
+      allowNote: config.allowNote === true
+    };
+  }
+  normalizeAllergyDataSourceItems(items) {
+    if (!Array.isArray(items)) return [];
+    const uniqueIds = new Set();
+    const normalized = [];
+    for (const item of items) {
+      const id = String(item?.id ?? '').trim();
+      const rawLabel = item?.label;
+      const label = typeof rawLabel === 'string' ? rawLabel.trim() : Object.entries(rawLabel || {}).reduce((labels, [locale, value]) => {
+        if (typeof value === 'string' && value.trim().length > 0) {
+          labels[locale] = value.trim();
+        }
+        return labels;
+      }, {});
+      const hasLabel = typeof label === 'string' ? label.length > 0 : Object.keys(label).length > 0;
+      if (!id || !hasLabel || uniqueIds.has(id)) continue;
+      uniqueIds.add(id);
+      normalized.push({
+        id,
+        label
+      });
+    }
+    return normalized;
+  }
   formatConfig(result, businessData) {
     return {
       result,

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

@@ -1,5 +1,5 @@
 import type { StrategyConfig } from '../../type';
-import { type ItemRuleBusinessData, type ItemRuleEvaluationResult, type QuantityCheckResult, type QuantityLimitResult, type PrefillItemResult } from './type';
+import { type ItemRuleBusinessData, type ItemRuleEvaluationResult, type QuantityCheckResult, type QuantityLimitResult, type PrefillItemResult, type AllergyRequirement } from './type';
 /**
  * ItemRule 评估器
  *
@@ -21,6 +21,13 @@ export declare class ItemRuleEvaluator {
      * 完整评估：数量校验 + 预填购物车
      */
     evaluate(businessData: ItemRuleBusinessData): ItemRuleEvaluationResult;
+    /**
+     * 获取当前商品优先级最高的过敏门禁要求。
+     *
+     * 不同商品或不同 Action 的数据源不会合并；相同优先级按
+     * strategyId + ruleId 稳定排序，保证多次评估结果一致。
+     */
+    getAllergyRequirement(businessData: ItemRuleBusinessData): AllergyRequirement | null;
     /**
      * 获取当前配置中各商品的数量限制
      *

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

@@ -43,6 +43,7 @@ class ItemRuleEvaluator {
     const configs = businessData.strategyConfigs ? businessData.strategyConfigs.filter(c => c.metadata.type === 'item_rule') : this.strategyConfigs;
     const allQuantityChecks = [];
     const allPrefillItems = [];
+    const allAllergyRequirements = [];
     const rawResults = [];
     const context = this.adapter.prepareContext(businessData);
     for (const config of configs) {
@@ -50,21 +51,42 @@ class ItemRuleEvaluator {
       rawResults.push(evalResult);
       const {
         quantityChecks,
-        prefillItems
+        prefillItems,
+        allergyRequirements
       } = this.adapter.transformResult(evalResult, businessData);
       allQuantityChecks.push(...quantityChecks);
       allPrefillItems.push(...prefillItems);
+      allAllergyRequirements.push(...allergyRequirements);
     }
     const failedChecks = allQuantityChecks.filter(c => !c.passed);
     return {
       quantityChecks: allQuantityChecks,
       prefillItems: allPrefillItems,
+      allergyRequirements: allAllergyRequirements,
       allPassed: failedChecks.length === 0,
       failedChecks,
       rawResults
     };
   }
 
+  /**
+   * 获取当前商品优先级最高的过敏门禁要求。
+   *
+   * 不同商品或不同 Action 的数据源不会合并；相同优先级按
+   * strategyId + ruleId 稳定排序，保证多次评估结果一致。
+   */
+  getAllergyRequirement(businessData) {
+    const requirements = this.evaluate(businessData).allergyRequirements;
+    if (!requirements.length) return null;
+    return [...requirements].sort((left, right) => {
+      const priorityDiff = right.priority - left.priority;
+      if (priorityDiff !== 0) return priorityDiff;
+      const strategyDiff = left.strategyId.localeCompare(right.strategyId);
+      if (strategyDiff !== 0) return strategyDiff;
+      return left.ruleId.localeCompare(right.ruleId);
+    })[0];
+  }
+
   /**
    * 获取当前配置中各商品的数量限制
    *

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

@@ -4,6 +4,8 @@ export declare const ITEM_RULE_ACTION_TYPES: {
     readonly QUANTITY_CHECK: "QUANTITY_CHECK";
     /** 预填购物车 */
     readonly PREFILL_CART: "PREFILL_CART";
+    /** 加购前过敏信息确认 */
+    readonly ALLERGY_CHECK: "ALLERGY_CHECK";
 };
 export type ItemRuleActionType = (typeof ITEM_RULE_ACTION_TYPES)[keyof typeof ITEM_RULE_ACTION_TYPES];
 export declare const ITEM_RULE_TEMPLATES: {
@@ -63,6 +65,42 @@ export interface TargetItem {
     /** 变体 ID */
     product_variant_id?: number;
 }
+/** 策略展示文案，可由调用方按当前 locale 解析。 */
+export type ItemRuleLocalizedText = string | Record<string, string>;
+/** 内联过敏源选项。稳定 id 用于保存选择，label 只负责展示。 */
+export interface AllergyDataSourceItem {
+    id: string;
+    label: ItemRuleLocalizedText;
+}
+/** 当前仅支持随策略下发的内联过敏源。 */
+export interface AllergyDataSource {
+    type: 'inline';
+    items: AllergyDataSourceItem[];
+}
+/** 每个目标商品独立持有自己的过敏源，禁止跨商品合并。 */
+export interface AllergyTargetItem extends TargetItem {
+    dataSource: AllergyDataSource;
+}
+export type AllergyPromptScope = 'once_per_order_product';
+/** ALLERGY_CHECK Action 的商品级配置。 */
+export interface AllergyCheckConfig {
+    targetType: 'product';
+    targets: AllergyTargetItem[];
+    promptScope: AllergyPromptScope;
+    allowNote?: boolean;
+}
+/** 当前商品命中的单条过敏门禁要求。 */
+export interface AllergyRequirement {
+    strategyId: string;
+    ruleId: string;
+    priority: number;
+    targetType: 'product';
+    product_id: number;
+    product_variant_id?: number;
+    dataSource: AllergyDataSource;
+    promptScope: AllergyPromptScope;
+    allowNote: boolean;
+}
 /**
  * 预填商品项
  */
@@ -119,6 +157,10 @@ export interface ItemRuleBusinessData {
     historicalItems?: CartItemSummary[];
     /** 服务类型（如 'dine-in', 'takeaway'） */
     serviceType?: string;
+    /** 当前业务渠道（如 'kiosk', 'pos', 'online_store'） */
+    channel?: string;
+    /** 当前正在加入购物车的商品；ALLERGY_CHECK 只读取该商品的 Target。 */
+    currentProduct?: Pick<TargetItem, 'product_id' | 'product_variant_id'>;
     /** 当前提交次数（0=首次提交, >0=追加提交） */
     submissionIndex?: number;
     /** 策略配置列表（可选，如果不传则使用 setStrategyConfigs 设置的） */
@@ -216,6 +258,8 @@ export interface ItemRuleEvaluationResult {
     quantityChecks: QuantityCheckResult[];
     /** 需要预填的商品列表 */
     prefillItems: PrefillItemResult[];
+    /** 当前商品命中的过敏门禁要求；不同 Action/商品不会合并。 */
+    allergyRequirements: AllergyRequirement[];
     /** 所有校验是否全部通过 */
     allPassed: boolean;
     /** 未通过的校验列表 */

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

@@ -12,7 +12,9 @@ const ITEM_RULE_ACTION_TYPES = exports.ITEM_RULE_ACTION_TYPES = {
   /** 数量校验 */
   QUANTITY_CHECK: 'QUANTITY_CHECK',
   /** 预填购物车 */
-  PREFILL_CART: 'PREFILL_CART'
+  PREFILL_CART: 'PREFILL_CART',
+  /** 加购前过敏信息确认 */
+  ALLERGY_CHECK: 'ALLERGY_CHECK'
 };
 // ============================================
 // Rule Template 类型（创建规则时的起始模板）
@@ -56,6 +58,22 @@ const ITEM_RULE_TEMPLATES = exports.ITEM_RULE_TEMPLATES = {
 
 /** 目标项 */
 
+// ============================================
+// Allergy Check 相关类型
+// ============================================
+
+/** 策略展示文案，可由调用方按当前 locale 解析。 */
+
+/** 内联过敏源选项。稳定 id 用于保存选择，label 只负责展示。 */
+
+/** 当前仅支持随策略下发的内联过敏源。 */
+
+/** 每个目标商品独立持有自己的过敏源，禁止跨商品合并。 */
+
+/** ALLERGY_CHECK Action 的商品级配置。 */
+
+/** 当前商品命中的单条过敏门禁要求。 */
+
 // ============================================
 // Prefill Cart 相关类型
 // ============================================

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/modules/Customer/index.js

@@ -150,6 +150,7 @@ class CustomerModule extends _BaseModule.BaseModule {
       with: ['latestWalletDetail.wallet', 'contactsInfo', 'formRecord'],
       search_wallet_flag: 1,
       search_wallet_pass_flag: 1,
+      filter_franchisor_permissions: ['use'],
       ...(search && {
         search
       }),

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' | undefined;
+export declare function getDiscountUsageBlockReason(discount: Discount): string | undefined;

package/lib/modules/Discount/availability.js

@@ -0,0 +1,43 @@
+"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.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/index.d.ts

@@ -27,6 +27,7 @@ export declare class DiscountModule extends BaseModule implements Module, Discou
         with_available_wallet_pass_flag?: 0 | 1;
         with_virtual_currency?: 0 | 1;
         with_entitlement_pass?: 0 | 1;
+        filter_order_wallet_pass_usage?: 0 | 1;
         request_timezone: string;
         order_id?: number | string;
     }): Promise<DiscountPrepareConfigResult>;
@@ -37,10 +38,7 @@ export declare class DiscountModule extends BaseModule implements Module, Discou
     }): Promise<DiscountWithReason>;
     batchSearchByProductIds(productIds: number[]): Promise<any>;
     filterEnabledDiscountList(discountList: Discount[]): Discount[];
-    private hasAvailableBalance;
-    private checkUsageCreditsLimit;
     filterEnabledDiscountListWithReason(discountList: Discount[]): DiscountWithReason;
-    private checkUsageCreditsLimitWithFailKey;
     uniqueByProductId(discountList: Discount[]): Discount[];
     filterDiscountListByProductIds(discountList: Discount[], productIds: number[]): Discount[];
     calcDiscountApplicableProductTotalPrice(discount: Discount): number | undefined;