@explorins/pers-shared 2.1.190 → 2.1.192

package/dist/esm/shared-lib/types/data-source.type.d.ts

@@ -19,14 +19,15 @@
  *
  * ## Example Scenarios
  *
- * | Scenario                    | channel   | medium     | campaign     | source       |
- * |-----------------------------|-----------|------------|--------------|--------------|
- * | User clicks email link      | `web`     | `email`    | `summer_promo`| `mailchimp` |
- * | Mobile app registration     | `mobile`  | `app`      | -            | -            |
- * | Partner API integration     | `api`     | `affiliate`| -            | `partner_xyz`|
- * | QR code scan in hotel       | `mobile`  | `referral` | `lobby_qr`   | `qr_code`    |
- * | Admin creates user          | `admin`   | -          | -            | -            |
- * | Webhook from Stripe         | `webhook` | -          | -            | `stripe`     |
+ * | Scenario                    | channel   | platform.deviceType | platform.app/browser | Notes |
+ * |-----------------------------|-----------|---------------------|----------------------|-------|
+ * | Desktop browser             | `web`     | `desktop`           | `browser: Chrome`    | -     |
+ * | Mobile browser (Safari)     | `web`     | `phone`             | `browser: Safari`    | NOT 'mobile' channel |
+ * | Native iOS app              | `mobile`  | `phone`             | `app: MyApp`         | Requires x-source-channel |
+ * | Native Android app          | `mobile`  | `phone`             | `app: MyApp`         | Requires x-source-channel |
+ * | Partner API integration     | `api`     | -                   | -                    | -     |
+ * | Admin creates user          | `admin`   | -                   | -                    | -     |
+ * | Webhook from Stripe         | `webhook` | -                   | -                    | -     |
  *
  * @example
  * // Simple usage - just channel
@@ -43,6 +44,10 @@
  */
 /**
  * Primary ingestion channels for data source tracking.
+ *
+ * IMPORTANT:
+ * - 'web' = ANY browser (desktop OR mobile) - use platform.deviceType to distinguish
+ * - 'mobile' = Native apps ONLY (iOS/Android) - must include platform.app
  */
 export declare const DATA_SOURCE_CHANNELS: readonly ["web", "mobile", "api", "admin", "system", "import", "webhook", "sync", "migration", "unknown"];
 export type DataSourceChannel = typeof DATA_SOURCE_CHANNELS[number];
@@ -51,11 +56,19 @@ export type DataSourceChannel = typeof DATA_SOURCE_CHANNELS[number];
  *
  * Provides both simple channel categorization and optional
  * detailed attribution fields for analytics.
+ *
+ * CHANNEL USAGE:
+ * - 'web': ANY browser (desktop/mobile) - check platform.deviceType and platform.browser
+ * - 'mobile': Native apps ONLY - check platform.app and platform.appVersion
+ * - Use platform field to get detailed device/environment information
  */
 export interface DataSource {
     /**
      * Primary ingestion channel.
      * Required field for basic source categorization.
+     *
+     * - 'web' = Browser (desktop or mobile) - use platform.deviceType to distinguish
+     * - 'mobile' = Native mobile app - requires platform.app to be set
      */
     channel: DataSourceChannel;
     /**
@@ -83,6 +96,19 @@ export interface DataSource {
      * SDK provides this - backend stores as-is.
      */
     platform?: Platform;
+    /**
+     * Source of platform data.
+     * Indicates whether platform info came from SDK headers or auto-detection.
+     *
+     * - 'sdk': Explicitly sent via x-platform header (authoritative, trusted)
+     * - 'auto': Parsed from User-Agent header (best-effort, may be inaccurate)
+     *
+     * Use this to:
+     * - Identify incomplete SDK integrations (platformSource='auto' or missing)
+     * - Filter for high-quality data (platformSource='sdk')
+     * - Track SDK adoption progress
+     */
+    platformSource?: 'sdk' | 'auto';
 }
 /**
  * Platform/device information for analytics.
@@ -135,17 +161,37 @@ export declare const KNOWN_SOURCE_DOMAINS: Record<string, string>;
  * detectSourceFromReferrer('https://partner.example.com') // 'example'
  */
 export declare function detectSourceFromReferrer(referrer?: string): string | undefined;
+/**
+ * Parse User-Agent string for platform information (fallback when SDK doesn't provide).
+ *
+ * Extracts OS, browser, device type from standard User-Agent patterns.
+ * This is best-effort - SDK headers are authoritative.
+ *
+ * @param userAgent - User-Agent header value
+ * @returns Platform object with detected fields, or undefined if unparseable
+ *
+ * @example
+ * parseUserAgentForPlatform('Mozilla/5.0 (iPhone; CPU iPhone OS 17_4...')
+ * // { os: 'iOS', osVersion: '17.4', browser: 'Safari', deviceType: 'phone' }
+ */
+export declare function parseUserAgentForPlatform(userAgent?: string): Platform | undefined;
 /**
  * Auto-detect channel from User-Agent string.
  *
+ * IMPORTANT DESIGN:
+ * - Mobile browsers (Safari on iPhone, Chrome on Android) → 'web' (NOT 'mobile')
+ * - Native apps MUST send explicit x-source-channel: mobile header
+ * - Use platform.deviceType to distinguish mobile web from desktop web
+ *
  * @param userAgent - User-Agent header value
  * @param path - Optional request path for webhook detection
  * @returns Detected channel
  *
  * @example
- * detectChannelFromUserAgent('Mozilla/5.0 (iPhone; ...)') // 'mobile'
- * detectChannelFromUserAgent('Mozilla/5.0 (Windows NT...)') // 'web'
+ * detectChannelFromUserAgent('Mozilla/5.0 (iPhone; ...) Safari') // 'web' (mobile browser)
+ * detectChannelFromUserAgent('Mozilla/5.0 (Windows NT...)') // 'web' (desktop browser)
  * detectChannelFromUserAgent('', '/webhook/stripe') // 'webhook'
+ * detectChannelFromUserAgent('MyApp/1.0') // 'unknown' (native app without header)
  */
 export declare function detectChannelFromUserAgent(userAgent?: string, path?: string): DataSourceChannel;
 /**

package/dist/esm/shared-lib/types/data-source.type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-source.type.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/types/data-source.type.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB,2GAWvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,OAAO,EAAE,iBAAiB,CAAC;IAE3B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,sEAAsE;IACtE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,UAAU,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;CACjE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAE9E;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,UAEjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAyDvD,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA8B9E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAoB/F;AAMD;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAuBrD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,OAAO,EAAE,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAC;IAEpC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,GAAG,sBAAsB,CAAC"}
+{"version":3,"file":"data-source.type.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/types/data-source.type.ts"],"names":[],"mappings":"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"}

package/dist/esm/shared-lib/types/data-source.type.js

@@ -19,14 +19,15 @@
  *
  * ## Example Scenarios
  *
- * | Scenario                    | channel   | medium     | campaign     | source       |
- * |-----------------------------|-----------|------------|--------------|--------------|
- * | User clicks email link      | `web`     | `email`    | `summer_promo`| `mailchimp` |
- * | Mobile app registration     | `mobile`  | `app`      | -            | -            |
- * | Partner API integration     | `api`     | `affiliate`| -            | `partner_xyz`|
- * | QR code scan in hotel       | `mobile`  | `referral` | `lobby_qr`   | `qr_code`    |
- * | Admin creates user          | `admin`   | -          | -            | -            |
- * | Webhook from Stripe         | `webhook` | -          | -            | `stripe`     |
+ * | Scenario                    | channel   | platform.deviceType | platform.app/browser | Notes |
+ * |-----------------------------|-----------|---------------------|----------------------|-------|
+ * | Desktop browser             | `web`     | `desktop`           | `browser: Chrome`    | -     |
+ * | Mobile browser (Safari)     | `web`     | `phone`             | `browser: Safari`    | NOT 'mobile' channel |
+ * | Native iOS app              | `mobile`  | `phone`             | `app: MyApp`         | Requires x-source-channel |
+ * | Native Android app          | `mobile`  | `phone`             | `app: MyApp`         | Requires x-source-channel |
+ * | Partner API integration     | `api`     | -                   | -                    | -     |
+ * | Admin creates user          | `admin`   | -                   | -                    | -     |
+ * | Webhook from Stripe         | `webhook` | -                   | -                    | -     |
  *
  * @example
  * // Simple usage - just channel
@@ -43,10 +44,14 @@
  */
 /**
  * Primary ingestion channels for data source tracking.
+ *
+ * IMPORTANT:
+ * - 'web' = ANY browser (desktop OR mobile) - use platform.deviceType to distinguish
+ * - 'mobile' = Native apps ONLY (iOS/Android) - must include platform.app
  */
 export const DATA_SOURCE_CHANNELS = [
-    'web', // Web application/browser
-    'mobile', // Mobile app (iOS/Android)
+    'web', // Web browser (desktop or mobile) - check platform.deviceType
+    'mobile', // Native mobile app ONLY (iOS/Android) - requires platform.app
     'api', // Direct API integration
     'admin', // Admin panel/back-office
     'system', // System-generated (automated)
@@ -174,17 +179,114 @@ export function detectSourceFromReferrer(referrer) {
         return undefined;
     }
 }
+/**
+ * Parse User-Agent string for platform information (fallback when SDK doesn't provide).
+ *
+ * Extracts OS, browser, device type from standard User-Agent patterns.
+ * This is best-effort - SDK headers are authoritative.
+ *
+ * @param userAgent - User-Agent header value
+ * @returns Platform object with detected fields, or undefined if unparseable
+ *
+ * @example
+ * parseUserAgentForPlatform('Mozilla/5.0 (iPhone; CPU iPhone OS 17_4...')
+ * // { os: 'iOS', osVersion: '17.4', browser: 'Safari', deviceType: 'phone' }
+ */
+export function parseUserAgentForPlatform(userAgent) {
+    if (!userAgent)
+        return undefined;
+    const ua = userAgent;
+    const platform = {};
+    // Detect OS and device type
+    if (/iPhone|iPod/i.test(ua)) {
+        platform.os = 'iOS';
+        const match = ua.match(/OS (\d+)[_\.](\d+)/);
+        if (match)
+            platform.osVersion = `${match[1]}.${match[2]}`;
+        platform.deviceType = 'phone';
+    }
+    else if (/iPad/i.test(ua)) {
+        platform.os = 'iOS';
+        const match = ua.match(/OS (\d+)[_\.](\d+)/);
+        if (match)
+            platform.osVersion = `${match[1]}.${match[2]}`;
+        platform.deviceType = 'tablet';
+    }
+    else if (/Android/i.test(ua)) {
+        platform.os = 'Android';
+        const match = ua.match(/Android ([\d\.]+)/);
+        if (match)
+            platform.osVersion = match[1];
+        platform.deviceType = /Mobile/i.test(ua) ? 'phone' : 'tablet';
+    }
+    else if (/Windows NT/i.test(ua)) {
+        platform.os = 'Windows';
+        const match = ua.match(/Windows NT ([\d\.]+)/);
+        if (match)
+            platform.osVersion = match[1];
+        platform.deviceType = 'desktop';
+    }
+    else if (/Macintosh|Mac OS X/i.test(ua)) {
+        platform.os = 'macOS';
+        const match = ua.match(/Mac OS X ([\d_]+)/);
+        if (match)
+            platform.osVersion = match[1].replace(/_/g, '.');
+        platform.deviceType = 'desktop';
+    }
+    else if (/Linux/i.test(ua) && !/Android/i.test(ua)) {
+        platform.os = 'Linux';
+        platform.deviceType = 'desktop';
+    }
+    // Detect browser (web channel)
+    if (/Edg\//i.test(ua)) {
+        platform.browser = 'Edge';
+        const match = ua.match(/Edg\/([\d\.]+)/);
+        if (match)
+            platform.browserVersion = match[1];
+    }
+    else if (/Chrome\//i.test(ua) && !/Edg/i.test(ua)) {
+        platform.browser = 'Chrome';
+        const match = ua.match(/Chrome\/([\d\.]+)/);
+        if (match)
+            platform.browserVersion = match[1];
+    }
+    else if (/Safari\//i.test(ua) && !/Chrome/i.test(ua)) {
+        platform.browser = 'Safari';
+        const match = ua.match(/Version\/([\d\.]+)/);
+        if (match)
+            platform.browserVersion = match[1];
+    }
+    else if (/Firefox\//i.test(ua)) {
+        platform.browser = 'Firefox';
+        const match = ua.match(/Firefox\/([\d\.]+)/);
+        if (match)
+            platform.browserVersion = match[1];
+    }
+    else if (/Opera|OPR\//i.test(ua)) {
+        platform.browser = 'Opera';
+        const match = ua.match(/(?:Opera|OPR)\/([\d\.]+)/);
+        if (match)
+            platform.browserVersion = match[1];
+    }
+    return Object.keys(platform).length > 0 ? platform : undefined;
+}
 /**
  * Auto-detect channel from User-Agent string.
  *
+ * IMPORTANT DESIGN:
+ * - Mobile browsers (Safari on iPhone, Chrome on Android) → 'web' (NOT 'mobile')
+ * - Native apps MUST send explicit x-source-channel: mobile header
+ * - Use platform.deviceType to distinguish mobile web from desktop web
+ *
  * @param userAgent - User-Agent header value
  * @param path - Optional request path for webhook detection
  * @returns Detected channel
  *
  * @example
- * detectChannelFromUserAgent('Mozilla/5.0 (iPhone; ...)') // 'mobile'
- * detectChannelFromUserAgent('Mozilla/5.0 (Windows NT...)') // 'web'
+ * detectChannelFromUserAgent('Mozilla/5.0 (iPhone; ...) Safari') // 'web' (mobile browser)
+ * detectChannelFromUserAgent('Mozilla/5.0 (Windows NT...)') // 'web' (desktop browser)
  * detectChannelFromUserAgent('', '/webhook/stripe') // 'webhook'
+ * detectChannelFromUserAgent('MyApp/1.0') // 'unknown' (native app without header)
  */
 export function detectChannelFromUserAgent(userAgent, path) {
     // Check for webhook paths
@@ -192,16 +294,18 @@ export function detectChannelFromUserAgent(userAgent, path) {
         return 'webhook';
     }
     const ua = (userAgent || '').toLowerCase();
-    // Check for mobile user-agents
-    if (/mobile|android|iphone|ipad|ipod|blackberry|windows phone/i.test(ua)) {
-        return 'mobile';
-    }
     // Check for bot/crawler patterns (system)
     if (/bot|crawler|spider|scraper|curl|wget|python|node-fetch|axios/i.test(ua)) {
         return 'api';
     }
-    // Default to web for browser-like user agents
-    return 'web';
+    // Check for ANY browser pattern (desktop OR mobile)
+    // Mobile browsers are 'web' channel - use platform.deviceType to distinguish
+    if (ua && /mozilla|chrome|safari|firefox|edge|opera|msie|trident/i.test(ua)) {
+        return 'web';
+    }
+    // Unknown: Native apps MUST send x-source-channel: mobile header
+    // If we see 'unknown', it means SDK integration is incomplete
+    return 'unknown';
 }
 /**
  * Parse UTM parameters from a URL (deep link, referrer, etc.).

package/dist/esm/shared-lib/types/data-source.type.js.map

@@ -1 +1 @@
-{"version":3,"file":"data-source.type.js","sourceRoot":"","sources":["../../../../src/shared-lib/types/data-source.type.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"data-source.type.js","sourceRoot":"","sources":["../../../../src/shared-lib/types/data-source.type.ts"],"names":[],"mappings":"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"}

package/dist/esm/shared-lib/validation/index.d.ts

@@ -1,4 +1,6 @@
 export * from './validation.types';
 export * from './validators';
 export * from './field-validation';
+export * from './status-hierarchy';
+export * from './redemption-eligibility';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/shared-lib/validation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/validation/index.ts"],"names":[],"mappings":"AACA,cAAc,oBAAoB,CAAC;AAGnC,cAAc,cAAc,CAAC;AAG7B,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/validation/index.ts"],"names":[],"mappings":"AACA,cAAc,oBAAoB,CAAC;AAGnC,cAAc,cAAc,CAAC;AAG7B,cAAc,oBAAoB,CAAC;AAGnC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,0BAA0B,CAAC"}

package/dist/esm/shared-lib/validation/index.js

@@ -4,4 +4,8 @@ export * from './validation.types.js';
 export * from './validators.js';
 // Field validation functions (also re-exports types and validators)
 export * from './field-validation.js';
+// Status hierarchy resolution (pure)
+export * from './status-hierarchy.js';
+// Redemption eligibility types + pure aggregator
+export * from './redemption-eligibility.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/shared-lib/validation/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/validation/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,cAAc,oBAAoB,CAAC;AAEnC,wBAAwB;AACxB,cAAc,cAAc,CAAC;AAE7B,oEAAoE;AACpE,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/validation/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,cAAc,oBAAoB,CAAC;AAEnC,wBAAwB;AACxB,cAAc,cAAc,CAAC;AAE7B,oEAAoE;AACpE,cAAc,oBAAoB,CAAC;AAEnC,qCAAqC;AACrC,cAAc,oBAAoB,CAAC;AAEnC,iDAAiD;AACjD,cAAc,0BAA0B,CAAC"}

package/dist/esm/shared-lib/validation/redemption-eligibility.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Redemption eligibility (pure, framework-agnostic).
+ *
+ * Specializes the generic {@link Eligibility} primitive for the redeem-time gates
+ * enforced by the backend redemption workflow, and provides a pure aggregator so
+ * backend and frontend can derive the same verdict from already-known signals.
+ *
+ * NOTE: the live credit-token balance gate is intentionally excluded — it is
+ * volatile and validated at redeem time, not as a pre-flight check.
+ */
+import type { Eligibility, EligibilityCheck } from "../interfaces/eligibility.interface";
+import { type StatusHierarchyNode } from "./status-hierarchy";
+import type { UserStatusTypeDTO } from "../dto/user-status-type.dto";
+/** Minimal user shape needed to evaluate eligibility. */
+type EligibilityUser = {
+    isActive?: boolean;
+    included?: {
+        statusTypes?: UserStatusTypeDTO[];
+    };
+};
+/** Minimal redemption shape needed to evaluate eligibility. */
+type EligibilityRedemption = {
+    maxPerUser?: number | null;
+    minUserStatusType?: UserStatusTypeDTO | null;
+    included?: {
+        requiredUserInfo?: {
+            isValid: boolean;
+            fieldDefinitions?: Array<{
+                isMissing?: boolean;
+                key?: string;
+                id?: string;
+            }>;
+        } | null;
+        booking?: {
+            isValid: boolean;
+        } | null;
+    };
+};
+/**
+ * Canonical list of redemption eligibility gates.
+ *
+ * ⚠️  SYNC CONTRACT: These gates must mirror the validation steps in
+ * `RedemptionRedeemWorkflow` (backend). If you add or remove a gate here,
+ * update the workflow too — and vice versa.
+ *
+ * Use this constant in tests to assert that `evaluateRedemptionEligibility`
+ * returns exactly these keys (no more, no less):
+ *
+ *   expect(Object.keys(result.checks)).toEqual([...REDEMPTION_ELIGIBILITY_GATES]);
+ */
+export declare const REDEMPTION_ELIGIBILITY_GATES: readonly ["userActive", "requiredFields", "booking", "userStatus", "maxPerUser"];
+export type RedemptionEligibilityGate = typeof REDEMPTION_ELIGIBILITY_GATES[number];
+/**
+ * Stable machine-readable codes for a failed redemption eligibility check.
+ */
+export type RedemptionEligibilityReasonCode = 'USER_INACTIVE' | 'MISSING_REQUIRED_FIELDS' | 'BOOKING_REQUIRED' | 'INSUFFICIENT_USER_STATUS' | 'MAX_PER_USER_REACHED';
+/** Structured detail emitted by redemption eligibility gates on failure. */
+export type RedemptionEligibilityDetail = {
+    missingFieldKeys: string[];
+} | {
+    minRequiredStatusTypeId: number;
+    userStatusTypeIds: number[];
+} | {
+    maxPerUser: number;
+    userRedeemCount: number;
+};
+/**
+ * Result of a single redemption eligibility gate.
+ * Specializes the generic {@link EligibilityCheck} with redemption-specific codes/detail.
+ */
+export type RedemptionEligibilityCheck = EligibilityCheck<RedemptionEligibilityReasonCode, RedemptionEligibilityDetail>;
+/**
+ * Aggregate pre-flight eligibility verdict for a user redeeming a redemption.
+ * Specializes the generic {@link Eligibility} with the redeem-time gates.
+ * Excludes the live credit-token balance check (validated at redeem time).
+ */
+export type RedemptionEligibility = Eligibility<{
+    userActive: RedemptionEligibilityCheck;
+    requiredFields: RedemptionEligibilityCheck;
+    booking: RedemptionEligibilityCheck;
+    userStatus: RedemptionEligibilityCheck;
+    maxPerUser: RedemptionEligibilityCheck;
+}>;
+/** Signals required to derive a redemption eligibility verdict. */
+export interface RedemptionEligibilityInput {
+    user: EligibilityUser;
+    redemption: EligibilityRedemption;
+    /** All status types — needed for hierarchical status comparison. */
+    allStatusTypes: StatusHierarchyNode[];
+    /**
+     * How many times this user has already redeemed this redemption.
+     * Required for the maxPerUser gate. Fetch from GET /redemptions/redeems?userId=&redemptionId=
+     */
+    userRedeemCount: number;
+}
+/**
+ * Derives an aggregate redemption eligibility verdict from the user, redemption and status list.
+ *
+ * Pure and side-effect free: pass the DTOs directly from your API responses; the function
+ * computes all per-gate verdicts (including status hierarchy and maxPerUser math) internally.
+ *
+ * Requires `?include=requiredUserInfo,booking` on the redemption fetch and
+ * `?include=status` on the user fetch for full accuracy.
+ */
+export declare function evaluateRedemptionEligibility(input: RedemptionEligibilityInput): RedemptionEligibility;
+export {};
+//# sourceMappingURL=redemption-eligibility.d.ts.map

package/dist/esm/shared-lib/validation/redemption-eligibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redemption-eligibility.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/validation/redemption-eligibility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACzF,OAAO,EAAiC,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC7F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE,yDAAyD;AACzD,KAAK,eAAe,GAAG;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAA;KAAE,CAAC;CACpD,CAAC;AAEF,+DAA+D;AAC/D,KAAK,qBAAqB,GAAG;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,EAAE;QACP,gBAAgB,CAAC,EAAE;YAAE,OAAO,EAAE,OAAO,CAAC;YAAC,gBAAgB,CAAC,EAAE,KAAK,CAAC;gBAAE,SAAS,CAAC,EAAE,OAAO,CAAC;gBAAC,GAAG,CAAC,EAAE,MAAM,CAAC;gBAAC,EAAE,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,GAAG,IAAI,CAAC;QAC7H,OAAO,CAAC,EAAE;YAAE,OAAO,EAAE,OAAO,CAAA;SAAE,GAAG,IAAI,CAAC;KACzC,CAAC;CACL,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,4BAA4B,kFAM/B,CAAC;AAEX,MAAM,MAAM,yBAAyB,GAAG,OAAO,4BAA4B,CAAC,MAAM,CAAC,CAAC;AAEpF;;GAEG;AACH,MAAM,MAAM,+BAA+B,GACrC,eAAe,GACf,yBAAyB,GACzB,kBAAkB,GAClB,0BAA0B,GAC1B,sBAAsB,CAAC;AAE7B,4EAA4E;AAC5E,MAAM,MAAM,2BAA2B,GACjC;IAAE,gBAAgB,EAAE,MAAM,EAAE,CAAA;CAAE,GAC9B;IAAE,uBAAuB,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,EAAE,CAAA;CAAE,GAChE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG,gBAAgB,CAAC,+BAA+B,EAAE,2BAA2B,CAAC,CAAC;AAExH;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,WAAW,CAAC;IAC5C,UAAU,EAAE,0BAA0B,CAAC;IACvC,cAAc,EAAE,0BAA0B,CAAC;IAC3C,OAAO,EAAE,0BAA0B,CAAC;IACpC,UAAU,EAAE,0BAA0B,CAAC;IACvC,UAAU,EAAE,0BAA0B,CAAC;CAC1C,CAAC,CAAC;AAEH,mEAAmE;AACnE,MAAM,WAAW,0BAA0B;IACvC,IAAI,EAAE,eAAe,CAAC;IACtB,UAAU,EAAE,qBAAqB,CAAC;IAClC,oEAAoE;IACpE,cAAc,EAAE,mBAAmB,EAAE,CAAC;IACtC;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;CAC3B;AAaD;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,0BAA0B,GAAG,qBAAqB,CA2DtG"}

package/dist/esm/shared-lib/validation/redemption-eligibility.js

@@ -0,0 +1,70 @@
+import { meetsMinimumStatusRequirement } from "./status-hierarchy.js";
+/**
+ * Canonical list of redemption eligibility gates.
+ *
+ * ⚠️  SYNC CONTRACT: These gates must mirror the validation steps in
+ * `RedemptionRedeemWorkflow` (backend). If you add or remove a gate here,
+ * update the workflow too — and vice versa.
+ *
+ * Use this constant in tests to assert that `evaluateRedemptionEligibility`
+ * returns exactly these keys (no more, no less):
+ *
+ *   expect(Object.keys(result.checks)).toEqual([...REDEMPTION_ELIGIBILITY_GATES]);
+ */
+export const REDEMPTION_ELIGIBILITY_GATES = [
+    'userActive',
+    'requiredFields',
+    'booking',
+    'userStatus',
+    'maxPerUser',
+];
+function makeCheck(passed, code, message, detail) {
+    return passed
+        ? { passed: true, reason: null }
+        : { passed: false, reason: { code, message }, ...(detail ? { detail } : {}) };
+}
+/**
+ * Derives an aggregate redemption eligibility verdict from the user, redemption and status list.
+ *
+ * Pure and side-effect free: pass the DTOs directly from your API responses; the function
+ * computes all per-gate verdicts (including status hierarchy and maxPerUser math) internally.
+ *
+ * Requires `?include=requiredUserInfo,booking` on the redemption fetch and
+ * `?include=status` on the user fetch for full accuracy.
+ */
+export function evaluateRedemptionEligibility(input) {
+    const { user, redemption, allStatusTypes, userRedeemCount } = input;
+    const userStatusTypeIds = (user.included?.statusTypes ?? []).map(s => s.id).filter((id) => id !== undefined);
+    const minUserStatusTypeId = redemption.minUserStatusType?.id ?? null;
+    const requiredUserInfo = redemption.included?.requiredUserInfo;
+    const booking = redemption.included?.booking;
+    // userStatus — delegate to shared pure hierarchy check
+    const userStatusPassed = !minUserStatusTypeId ||
+        meetsMinimumStatusRequirement(minUserStatusTypeId, userStatusTypeIds, allStatusTypes);
+    // maxPerUser — pure numeric comparison
+    const maxPerUserPassed = !redemption.maxPerUser || userRedeemCount < redemption.maxPerUser;
+    // requiredFields — use isValid from the include; derive missing keys from field definitions
+    const requiredFieldsPassed = !requiredUserInfo || requiredUserInfo.isValid;
+    const missingFieldKeys = requiredUserInfo?.fieldDefinitions
+        ?.filter(f => f.isMissing)
+        .map(f => f.key ?? f.id ?? '')
+        .filter(Boolean) ?? [];
+    const checks = {
+        userActive: makeCheck(user.isActive !== false, 'USER_INACTIVE', 'User account is inactive'),
+        requiredFields: makeCheck(requiredFieldsPassed, 'MISSING_REQUIRED_FIELDS', 'User is missing one or more required fields', requiredFieldsPassed ? undefined : { missingFieldKeys }),
+        booking: makeCheck(!booking || booking.isValid, 'BOOKING_REQUIRED', 'User does not have a valid booking meeting the requirements'),
+        userStatus: makeCheck(userStatusPassed, 'INSUFFICIENT_USER_STATUS', 'User does not meet the minimum status requirement', userStatusPassed || !minUserStatusTypeId ? undefined : {
+            minRequiredStatusTypeId: minUserStatusTypeId,
+            userStatusTypeIds,
+        }),
+        maxPerUser: makeCheck(maxPerUserPassed, 'MAX_PER_USER_REACHED', 'User has reached the maximum number of redeems allowed', maxPerUserPassed || !redemption.maxPerUser ? undefined : {
+            maxPerUser: redemption.maxPerUser,
+            userRedeemCount,
+        }),
+    };
+    return {
+        isEligible: Object.values(checks).every(c => c.passed),
+        checks,
+    };
+}
+//# sourceMappingURL=redemption-eligibility.js.map

package/dist/esm/shared-lib/validation/redemption-eligibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redemption-eligibility.js","sourceRoot":"","sources":["../../../../src/shared-lib/validation/redemption-eligibility.ts"],"names":[],"mappings":"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"}

package/dist/esm/shared-lib/validation/status-hierarchy.d.ts

@@ -0,0 +1,33 @@
+/**
+ * User status hierarchy resolution (pure, framework-agnostic).
+ *
+ * Centralizes the rule for "does a user's earned status satisfy a minimum
+ * requirement?" so backend and frontend evaluate it identically.
+ *
+ * Hierarchy semantics:
+ * - Exact match always qualifies.
+ * - Otherwise a user qualifies if they hold a status in the SAME hierarchy with
+ *   an `order` greater than or equal to the required status `order`.
+ * - Hierarchies (tracks) are separated by tags: statuses with no tags share the
+ *   global hierarchy; tagged statuses share a track only when their tags overlap.
+ * - A required status without an `order` requires an exact match (backward compatible).
+ */
+/** Minimal status-type shape needed to resolve hierarchy. */
+export interface StatusHierarchyNode {
+    id: number;
+    /** Higher = more prestigious. Null/undefined = no hierarchy ranking. */
+    order?: number | null;
+    /** Track tags. Empty/undefined = global hierarchy. */
+    tags?: string[] | null;
+}
+/**
+ * Determines whether a user meets a minimum status requirement, honoring the
+ * tag-scoped status hierarchy.
+ *
+ * @param requiredStatusId - The minimum status type ID required.
+ * @param userStatusIds - Status type IDs the user has earned.
+ * @param allStatusTypes - All status types (must include the required and user statuses).
+ * @returns True if the user satisfies the requirement (exact match or higher in same track).
+ */
+export declare function meetsMinimumStatusRequirement(requiredStatusId: number, userStatusIds: number[], allStatusTypes: StatusHierarchyNode[]): boolean;
+//# sourceMappingURL=status-hierarchy.d.ts.map

package/dist/esm/shared-lib/validation/status-hierarchy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-hierarchy.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/validation/status-hierarchy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,6DAA6D;AAC7D,MAAM,WAAW,mBAAmB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CAC1B;AAYD;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CACzC,gBAAgB,EAAE,MAAM,EACxB,aAAa,EAAE,MAAM,EAAE,EACvB,cAAc,EAAE,mBAAmB,EAAE,GACtC,OAAO,CA4CT"}