@explorins/pers-sdk-react-native 2.3.0-alpha.3 → 2.3.3

package/dist/index.js

@@ -2916,6 +2916,18 @@ exports.BalanceMigrationType = void 0;
     BalanceMigrationType["MERGE"] = "merge";
 })(exports.BalanceMigrationType || (exports.BalanceMigrationType = {}));
 
+/**
+ * Entity types that support tags for aggregation
+ */
+exports.TaggableEntityType = void 0;
+(function (TaggableEntityType) {
+    TaggableEntityType["CAMPAIGN"] = "campaign";
+    TaggableEntityType["REDEMPTION"] = "redemption";
+    TaggableEntityType["BUSINESS"] = "business";
+    TaggableEntityType["TOKEN_METADATA"] = "token_metadata";
+    TaggableEntityType["USER_STATUS_TYPE"] = "user_status_type";
+})(exports.TaggableEntityType || (exports.TaggableEntityType = {}));
+
 exports.PurchaseStatus = void 0;
 (function (PurchaseStatus) {
     // after creation of payment and before payment is done by user
@@ -3764,6 +3776,24 @@ const customFieldEntityTypes = [...customFieldEntityTypesArray];
 const selectOptionsSourceEntityArray = [...customFieldEntityTypesArray, 'country'];
 /** All supported select options source entities for iteration/validation */
 const selectOptionsSourceEntities = [...selectOptionsSourceEntityArray];
+/**
+ * Default label fields for each entity type.
+ * Used when labelField is not explicitly specified.
+ */
+const SELECT_OPTIONS_LABEL_DEFAULTS = {
+    business: 'displayName',
+    campaign: 'name',
+    redemption: 'name',
+    user: 'email', // User has no single 'name' field
+    country: 'label', // Static source - uses 'label' from { value, label }
+};
+/**
+ * Get the default label field for a select options entity.
+ * Falls back to 'name' for unknown entities.
+ */
+function getSelectOptionsLabelDefault(entity) {
+    return SELECT_OPTIONS_LABEL_DEFAULTS[entity] ?? 'name';
+}
 
 /**
  * Core Entity Types
@@ -3794,6 +3824,8 @@ const EntityTypes = {
     // Redemption entities
     REDEMPTION: 'redemption',
     REDEMPTION_TYPE: 'redemption_type',
+    // Booking entities
+    BOOKING: 'booking',
     // Infrastructure entities
     CONTRACT: 'contract',
     SIGNING_ACCOUNT: 'signing_account',
@@ -4189,6 +4221,34 @@ const LOCATION_TYPES = [
     'experience', // Experience package (multi-activity, bundle)
     'destination', // Destination/location-based (city pass, area access)
 ];
+/**
+ * Check if a booking status satisfies a requirement type.
+ *
+ * @param status - Current booking status ('past', 'active', 'future')
+ * @param requirement - Required booking status for eligibility
+ * @returns true if the status satisfies the requirement
+ *
+ * @example
+ * isBookingStatusValid('active', 'active_future'); // true
+ * isBookingStatusValid('past', 'active_future');   // false
+ * isBookingStatusValid('future', 'any');           // true
+ */
+function isBookingStatusValid(status, requirement) {
+    switch (requirement) {
+        case 'active':
+            return status === 'active';
+        case 'future':
+            return status === 'future';
+        case 'past':
+            return status === 'past';
+        case 'active_future':
+            return status === 'active' || status === 'future';
+        case 'any':
+            return true;
+        default:
+            return false;
+    }
+}
 
 /**
  * Unified data source tracking for analytics across all entities.
@@ -4246,6 +4306,7 @@ const DATA_SOURCE_CHANNELS = [
     'webhook', // External webhook callback
     'sync', // Synchronization from external system
     'migration', // Data migration
+    'unknown', // Source couldn't be determined (fallback)
 ];
 /**
  * Type guard to check if a value is a valid DataSourceChannel.
@@ -4254,11 +4315,189 @@ function isDataSourceChannel(value) {
     return typeof value === 'string' && DATA_SOURCE_CHANNELS.includes(value);
 }
 /**
- * Default data source for manual/admin operations.
+ * Default data source when source cannot be determined.
+ * Used as fallback when CLS context is unavailable.
+ *
+ * NOTE: 'unknown' indicates a gap in tracking - should be rare.
+ * If you see many 'unknown' sources, check that DataSourceInterceptor is active.
  */
 const DEFAULT_DATA_SOURCE = {
-    channel: 'admin',
+    channel: 'unknown',
+};
+/**
+ * Known domain mappings for auto-detecting source from referrer.
+ * Maps hostnames to normalized source names.
+ */
+const KNOWN_SOURCE_DOMAINS = {
+    // Google
+    'google.com': 'google',
+    'google.co.uk': 'google',
+    'google.de': 'google',
+    'google.fr': 'google',
+    'google.es': 'google',
+    'google.it': 'google',
+    'google.nl': 'google',
+    'google.pt': 'google',
+    'google.pl': 'google',
+    'google.ru': 'google',
+    'google.com.br': 'google',
+    'google.ca': 'google',
+    'google.com.au': 'google',
+    'google.co.jp': 'google',
+    'google.co.in': 'google',
+    // Facebook
+    'facebook.com': 'facebook',
+    'fb.com': 'facebook',
+    'm.facebook.com': 'facebook',
+    'l.facebook.com': 'facebook',
+    'lm.facebook.com': 'facebook',
+    // Instagram
+    'instagram.com': 'instagram',
+    'l.instagram.com': 'instagram',
+    // Twitter/X
+    'twitter.com': 'twitter',
+    'x.com': 'twitter',
+    't.co': 'twitter',
+    'mobile.twitter.com': 'twitter',
+    // LinkedIn
+    'linkedin.com': 'linkedin',
+    'lnkd.in': 'linkedin',
+    // YouTube
+    'youtube.com': 'youtube',
+    'youtu.be': 'youtube',
+    'm.youtube.com': 'youtube',
+    // TikTok
+    'tiktok.com': 'tiktok',
+    'vm.tiktok.com': 'tiktok',
+    // Other social
+    'pinterest.com': 'pinterest',
+    'reddit.com': 'reddit',
+    'tumblr.com': 'tumblr',
+    'snapchat.com': 'snapchat',
+    // Search engines
+    'bing.com': 'bing',
+    'yahoo.com': 'yahoo',
+    'duckduckgo.com': 'duckduckgo',
+    'baidu.com': 'baidu',
+    'yandex.com': 'yandex',
+    'yandex.ru': 'yandex',
+    // Email providers (for tracking email clicks)
+    'mail.google.com': 'gmail',
+    'outlook.live.com': 'outlook',
+    'outlook.office.com': 'outlook',
 };
+/**
+ * Auto-detect source from referrer URL domain.
+ * Maps common domains to friendly source names.
+ *
+ * @param referrer - Full referrer URL
+ * @returns Normalized source name or undefined
+ *
+ * @example
+ * detectSourceFromReferrer('https://www.google.com/search?q=test') // 'google'
+ * detectSourceFromReferrer('https://l.facebook.com/...') // 'facebook'
+ * detectSourceFromReferrer('https://partner.example.com') // 'example'
+ */
+function detectSourceFromReferrer(referrer) {
+    if (!referrer)
+        return undefined;
+    try {
+        const url = new URL(referrer);
+        const hostname = url.hostname.toLowerCase().replace(/^www\./, '');
+        // Check exact match first
+        if (KNOWN_SOURCE_DOMAINS[hostname]) {
+            return KNOWN_SOURCE_DOMAINS[hostname];
+        }
+        // Check if hostname ends with known domain (for subdomains)
+        for (const [domain, source] of Object.entries(KNOWN_SOURCE_DOMAINS)) {
+            if (hostname.endsWith('.' + domain)) {
+                return source;
+            }
+        }
+        // Fallback: extract main domain name (e.g., 'example' from 'mail.example.com')
+        const parts = hostname.split('.');
+        if (parts.length >= 2) {
+            return parts[parts.length - 2]; // Returns 'example' from 'sub.example.com'
+        }
+        return hostname;
+    }
+    catch {
+        // Invalid URL, return undefined
+        return undefined;
+    }
+}
+/**
+ * Auto-detect channel from User-Agent string.
+ *
+ * @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('', '/webhook/stripe') // 'webhook'
+ */
+function detectChannelFromUserAgent(userAgent, path) {
+    // Check for webhook paths
+    if (path?.includes('/webhook')) {
+        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';
+}
+/**
+ * Parse UTM parameters from a URL (deep link, referrer, etc.).
+ * Supports standard Google Analytics UTM parameters.
+ *
+ * @param url - Full URL containing UTM query parameters
+ * @returns Parsed UTM parameters object
+ *
+ * @example
+ * // Deep link from email campaign
+ * parseUtmParams('myapp://screen?utm_source=mailchimp&utm_medium=email&utm_campaign=summer_2026')
+ * // Returns: { source: 'mailchimp', medium: 'email', campaign: 'summer_2026' }
+ *
+ * @example
+ * // Web URL with full UTM tracking
+ * parseUtmParams('https://app.example.com?utm_source=google&utm_medium=cpc&utm_campaign=brand&utm_term=loyalty+app')
+ * // Returns: { source: 'google', medium: 'cpc', campaign: 'brand', term: 'loyalty+app' }
+ */
+function parseUtmParams(url) {
+    const params = {};
+    try {
+        const urlObj = new URL(url);
+        const searchParams = urlObj.searchParams;
+        const source = searchParams.get('utm_source');
+        const medium = searchParams.get('utm_medium');
+        const campaign = searchParams.get('utm_campaign');
+        const term = searchParams.get('utm_term');
+        const content = searchParams.get('utm_content');
+        if (source)
+            params.source = source;
+        if (medium)
+            params.medium = medium;
+        if (campaign)
+            params.campaign = campaign;
+        if (term)
+            params.term = term;
+        if (content)
+            params.content = content;
+    }
+    catch {
+        // Invalid URL, return empty params
+    }
+    return params;
+}
 
 /**
  * Analytics Constants
@@ -4513,6 +4752,8 @@ const CommonErrorCodes = {
     REDEMPTION_ALREADY_PROCESSING: 'REDEMPTION_ALREADY_PROCESSING',
     MAX_REDEMPTION: 'MAX_REDEMPTION',
     USER_LIMIT: 'USER_LIMIT',
+    REQUIRED_FIELDS_MISSING: 'REQUIRED_FIELDS_MISSING',
+    BOOKING_REQUIREMENT_NOT_MET: 'BOOKING_REQUIREMENT_NOT_MET',
     // Authentication errors
     INVALID_TOKEN: 'INVALID_TOKEN',
     TOKEN_EXPIRED: 'TOKEN_EXPIRED',
@@ -5488,6 +5729,40 @@ class UserApi {
     async restoreUser(identifier) {
         return this.apiClient.post(`${this.basePath}/${identifier}/restore`);
     }
+    // ==========================================
+    // CSV EXPORT
+    // ==========================================
+    /**
+     * ADMIN: Export users to CSV
+     *
+     * Returns a CSV file with user data for the tenant.
+     * Supports date range filtering.
+     *
+     * @param options - Export options (dateFrom, dateTo in ISO format)
+     * @returns CSV blob
+     *
+     * @example
+     * ```typescript
+     * // Export all users
+     * const blob = await sdk.users.exportCSV();
+     *
+     * // Export users created in date range
+     * const blob = await sdk.users.exportCSV({
+     *   dateFrom: '2026-01-01',
+     *   dateTo: '2026-05-31'
+     * });
+     * ```
+     */
+    async exportCSV(options) {
+        const params = new URLSearchParams();
+        if (options?.dateFrom)
+            params.append('dateFrom', options.dateFrom);
+        if (options?.dateTo)
+            params.append('dateTo', options.dateTo);
+        const queryString = params.toString();
+        const url = `${this.basePath}/export/csv${queryString ? `?${queryString}` : ''}`;
+        return this.apiClient.get(url, 'blob');
+    }
 }
 
 /**
@@ -7395,6 +7670,47 @@ class CampaignApi {
     async removeTriggerSourceFromCampaign(campaignId, triggerSourceId) {
         return this.apiClient.delete(`/campaigns/${campaignId}/trigger-sources/${triggerSourceId}`);
     }
+    // ==========================================
+    // CSV EXPORT
+    // ==========================================
+    /**
+     * ADMIN: Export campaigns to CSV
+     *
+     * Returns a CSV file with campaign data for the tenant.
+     * Supports date range filtering.
+     *
+     * @param options - Export options (dateFrom, dateTo)
+     * @returns CSV blob
+     */
+    async exportCSV(options) {
+        const params = new URLSearchParams();
+        if (options?.dateFrom)
+            params.append('dateFrom', options.dateFrom);
+        if (options?.dateTo)
+            params.append('dateTo', options.dateTo);
+        const queryString = params.toString();
+        const url = `/campaigns/export/csv${queryString ? `?${queryString}` : ''}`;
+        return this.apiClient.get(url, 'blob');
+    }
+    /**
+     * ADMIN: Export campaign claims to CSV
+     *
+     * Returns a CSV file with all campaign claim data.
+     * Supports date range filtering.
+     *
+     * @param options - Export options (dateFrom, dateTo)
+     * @returns CSV blob
+     */
+    async exportClaimsCSV(options) {
+        const params = new URLSearchParams();
+        if (options?.dateFrom)
+            params.append('dateFrom', options.dateFrom);
+        if (options?.dateTo)
+            params.append('dateTo', options.dateTo);
+        const queryString = params.toString();
+        const url = `/campaigns/claims/export/csv${queryString ? `?${queryString}` : ''}`;
+        return this.apiClient.get(url, 'blob');
+    }
 }
 
 /**
@@ -7902,6 +8218,47 @@ class RedemptionApi {
         const result = await this.getRedemptions({ active: true });
         return [...result.data];
     }
+    // ==========================================
+    // CSV EXPORT
+    // ==========================================
+    /**
+     * ADMIN: Export redemptions to CSV
+     *
+     * Returns a CSV file with redemption data for the tenant.
+     * Supports date range filtering.
+     *
+     * @param options - Export options (dateFrom, dateTo)
+     * @returns CSV blob
+     */
+    async exportCSV(options) {
+        const params = new URLSearchParams();
+        if (options?.dateFrom)
+            params.append('dateFrom', options.dateFrom);
+        if (options?.dateTo)
+            params.append('dateTo', options.dateTo);
+        const queryString = params.toString();
+        const url = `${this.basePath}/export/csv${queryString ? `?${queryString}` : ''}`;
+        return this.apiClient.get(url, 'blob');
+    }
+    /**
+     * ADMIN: Export redemption redeems to CSV
+     *
+     * Returns a CSV file with all redemption redeem data.
+     * Supports date range filtering.
+     *
+     * @param options - Export options (dateFrom, dateTo)
+     * @returns CSV blob
+     */
+    async exportRedeemsCSV(options) {
+        const params = new URLSearchParams();
+        if (options?.dateFrom)
+            params.append('dateFrom', options.dateFrom);
+        if (options?.dateTo)
+            params.append('dateTo', options.dateTo);
+        const queryString = params.toString();
+        const url = `${this.basePath}/redeems/export/csv${queryString ? `?${queryString}` : ''}`;
+        return this.apiClient.get(url, 'blob');
+    }
 }
 
 /**
@@ -8106,7 +8463,7 @@ class TransactionApi {
     // AUTHENTICATED USER OPERATIONS
     // ==========================================
     /**
-     * Helper to build query params from TransactionQueryOptions
+     * Helper to build query params from TransactionQueryParams
      * Handles all filter options and include parameter
      */
     buildTransactionQueryParams(options) {
@@ -8163,6 +8520,11 @@ class TransactionApi {
                 params.append('type', options.type);
             }
         }
+        // Date range filters
+        if (options.dateFrom)
+            params.append('dateFrom', options.dateFrom);
+        if (options.dateTo)
+            params.append('dateTo', options.dateTo);
         // Include relations for entity enrichment
         if (options.include && options.include.length > 0) {
             options.include.forEach(relation => params.append('include', relation));
@@ -8272,10 +8634,27 @@ class TransactionApi {
     /**
      * ADMIN: Export transactions to CSV
      *
-     * UPDATED: /transaction/admin/export/csv → /transactions/export/csv
+     * Returns a CSV file with transaction data for the tenant.
+     * Supports date range filtering.
+     *
+     * @param options - Export options (dateFrom, dateTo)
+     * @returns CSV blob
+     */
+    async exportCSV(options) {
+        const params = new URLSearchParams();
+        if (options?.dateFrom)
+            params.append('dateFrom', options.dateFrom);
+        if (options?.dateTo)
+            params.append('dateTo', options.dateTo);
+        const queryString = params.toString();
+        const url = `${this.basePath}/export/csv${queryString ? `?${queryString}` : ''}`;
+        return this.apiClient.get(url, 'blob');
+    }
+    /**
+     * @deprecated Use exportCSV() instead
      */
     async exportTransactionsCSV() {
-        return this.apiClient.get(`${this.basePath}/export/csv`, 'blob');
+        return this.exportCSV();
     }
     // ==========================================
     // NEW ADMIN QUERY METHODS
@@ -8446,8 +8825,8 @@ class TransactionService {
     /**
      * ADMIN: Export transactions to CSV
      */
-    async exportTransactionsCSV() {
-        return this.transactionApi.exportTransactionsCSV();
+    async exportTransactionsCSV(options) {
+        return this.transactionApi.exportCSV(options);
     }
     // ==========================================
     // QUERY & ANALYTICS OPERATIONS
@@ -11696,10 +12075,139 @@ class DefaultAuthProvider {
 /** SDK package name */
 const SDK_NAME = "@explorins/pers-sdk";
 /** SDK version - injected from package.json at build time */
-const SDK_VERSION = "2.2.0-alpha.2";
+const SDK_VERSION = "2.3.3";
 /** Full SDK identifier for headers */
 const SDK_USER_AGENT = `${SDK_NAME}/${SDK_VERSION}`;
 
+/**
+ * Tracking Manager - Handles data source and platform tracking
+ *
+ * Manages attribution data for analytics across all user actions.
+ *
+ * @module @explorins/pers-sdk/core/tracking
+ */
+/**
+ * Manages data source and platform tracking state
+ */
+class TrackingManager {
+    constructor(options) {
+        this.configDataSource = options?.dataSource;
+        this.configPlatform = options?.platform;
+    }
+    /**
+     * Set data source tracking info (replaces existing)
+     *
+     * @example
+     * ```typescript
+     * tracking.setDataSource({
+     *   channel: 'mobile',
+     *   medium: 'push',
+     *   campaign: 'summer_2026',
+     * });
+     * ```
+     */
+    setDataSource(dataSource) {
+        this._dataSource = dataSource;
+    }
+    /**
+     * Update data source tracking info (merges with existing)
+     *
+     * @example
+     * ```typescript
+     * tracking.updateDataSource({
+     *   campaign: 'new_campaign',
+     * });
+     * ```
+     */
+    updateDataSource(dataSource) {
+        const existing = this._dataSource ?? this.configDataSource;
+        this._dataSource = { ...existing, ...dataSource };
+    }
+    /**
+     * Set platform info for analytics
+     *
+     * @example
+     * ```typescript
+     * tracking.setPlatform({
+     *   os: 'iOS',
+     *   osVersion: '17.4',
+     *   app: 'MyApp',
+     *   appVersion: '2.3.1',
+     *   deviceType: 'phone',
+     * });
+     * ```
+     */
+    setPlatform(platform) {
+        this._platform = platform;
+    }
+    /**
+     * Get current data source config
+     */
+    getDataSource() {
+        return this._dataSource ?? this.configDataSource;
+    }
+    /**
+     * Get current platform info
+     */
+    getPlatform() {
+        return this._platform ?? this.configPlatform;
+    }
+    /**
+     * Check if tracking is properly configured
+     *
+     * Returns warnings for missing recommended tracking data.
+     * Useful for development/debugging to ensure proper attribution.
+     */
+    validate() {
+        const warnings = [];
+        const dataSource = this.getDataSource();
+        const platform = this.getPlatform();
+        // Check channel for non-web contexts
+        if (!dataSource?.channel) {
+            warnings.push('No channel set. Native apps should set channel: "mobile"');
+        }
+        // Check platform info
+        if (!platform || Object.keys(platform).length === 0) {
+            warnings.push('No platform info set. Consider calling setPlatform() for better analytics');
+        }
+        return {
+            isValid: warnings.length === 0,
+            warnings,
+        };
+    }
+    /**
+     * Build HTTP headers for data source tracking
+     *
+     * @internal - Used by PersApiClient
+     */
+    buildHeaders() {
+        const headers = {};
+        const dataSource = this.getDataSource();
+        const platform = this.getPlatform();
+        if (dataSource) {
+            if (dataSource.channel) {
+                headers['x-source-channel'] = dataSource.channel;
+            }
+            if (dataSource.medium) {
+                headers['x-source-medium'] = dataSource.medium;
+            }
+            if (dataSource.campaign) {
+                headers['x-source-campaign'] = dataSource.campaign;
+            }
+            if (dataSource.source) {
+                headers['x-source'] = dataSource.source;
+            }
+            if (dataSource.referrer) {
+                headers['Referer'] = dataSource.referrer;
+            }
+        }
+        if (platform && Object.keys(platform).length > 0) {
+            headers['x-platform'] = JSON.stringify(platform);
+        }
+        return headers;
+    }
+}
+
 // packages/pers-sdk/src/core/pers-api-client.ts
 /**
  * PERS API Client - Platform-agnostic HTTP client with authentication
@@ -11748,6 +12256,11 @@ class PersApiClient {
         }
         this.authService = new AuthService(this.authApi, this.mergedConfig.authProvider);
         this.refreshManager = new TokenRefreshManager(this.authService, this.mergedConfig.authProvider);
+        // Initialize tracking manager
+        this.tracking = new TrackingManager({
+            dataSource: this.mergedConfig.dataSource,
+            platform: this.mergedConfig.platform,
+        });
         if (this.mergedConfig.authProvider) {
             this.initializationPromise = this.initialize();
         }
@@ -12032,24 +12545,8 @@ class PersApiClient {
         else if (this.mergedConfig.apiProjectKey) {
             headers['x-project-key'] = this.mergedConfig.apiProjectKey;
         }
-        // Add data source tracking headers
-        const dataSource = this.mergedConfig.dataSource;
-        if (dataSource) {
-            headers['x-source-channel'] = dataSource.channel;
-            if (dataSource.medium) {
-                headers['x-source-medium'] = dataSource.medium;
-            }
-            if (dataSource.campaign) {
-                headers['x-source-campaign'] = dataSource.campaign;
-            }
-            if (dataSource.source) {
-                headers['x-source'] = dataSource.source;
-            }
-            // Note: referrer is typically set by browser, but can be overridden
-            if (dataSource.referrer) {
-                headers['Referer'] = dataSource.referrer;
-            }
-        }
+        // Add tracking headers (data source + platform)
+        Object.assign(headers, this.tracking.buildHeaders());
         return headers;
     }
     // ==========================================
@@ -12073,6 +12570,33 @@ class PersApiClient {
     getOriginalConfig() {
         return this.config;
     }
+    // ==========================================
+    // DATA SOURCE TRACKING
+    // ==========================================
+    /** Set data source tracking info (replaces existing) */
+    setDataSource(dataSource) {
+        this.tracking.setDataSource(dataSource);
+    }
+    /** Update data source tracking info (merges with existing) */
+    updateDataSource(dataSource) {
+        this.tracking.updateDataSource(dataSource);
+    }
+    /** Set platform info for analytics */
+    setPlatform(platform) {
+        this.tracking.setPlatform(platform);
+    }
+    /** Get current data source config */
+    getDataSource() {
+        return this.tracking.getDataSource();
+    }
+    /** Get current platform info */
+    getPlatform() {
+        return this.tracking.getPlatform();
+    }
+    /** Validate tracking configuration (for debugging) */
+    validateTracking() {
+        return this.tracking.validate();
+    }
 }
 
 /**
@@ -13291,6 +13815,37 @@ class UserManager {
         });
         return result;
     }
+    /**
+     * Admin: Export users as CSV
+     *
+     * Generates a comprehensive CSV export of all tenant users for
+     * external analysis, reporting, or compliance purposes. This operation
+     * requires administrator privileges and creates a downloadable file.
+     *
+     * @param options - Optional date range filters
+     * @param options.dateFrom - Start date filter (ISO date string)
+     * @param options.dateTo - End date filter (ISO date string)
+     * @returns Promise resolving to CSV blob for download
+     * @throws {PersApiError} When not authenticated as administrator or export fails
+     *
+     * @example Export All Users
+     * ```typescript
+     * const csvBlob = await sdk.users.exportCSV();
+     * const downloadUrl = URL.createObjectURL(csvBlob);
+     * ```
+     *
+     * @example Export Users Within Date Range
+     * ```typescript
+     * const csvBlob = await sdk.users.exportCSV({
+     *   dateFrom: '2024-01-01',
+     *   dateTo: '2024-12-31'
+     * });
+     * ```
+     */
+    async exportCSV(options) {
+        const userApi = new UserApi(this.apiClient);
+        return userApi.exportCSV(options);
+    }
     /**
      * Get the user service for advanced operations
      *
@@ -14753,7 +15308,13 @@ class CampaignManager {
      * ```
      */
     async getCampaigns(options) {
-        return this.campaignService.getCampaigns(options);
+        // Convert Date objects to ISO strings for API compatibility
+        const normalizedOptions = options ? {
+            ...options,
+            startDate: options.startDate instanceof Date ? options.startDate.toISOString() : options.startDate,
+            endDate: options.endDate instanceof Date ? options.endDate.toISOString() : options.endDate,
+        } : undefined;
+        return this.campaignService.getCampaigns(normalizedOptions);
     }
     /**
      * Admin: Create new campaign
@@ -15402,6 +15963,60 @@ class CampaignManager {
     async removeTriggerSource(campaignId, triggerSourceId) {
         return this.campaignService.removeTriggerSourceFromCampaign(campaignId, triggerSourceId);
     }
+    /**
+     * Admin: Export campaigns as CSV
+     *
+     * Generates a comprehensive CSV export of all tenant campaigns for
+     * external analysis, reporting, or compliance purposes. This operation
+     * requires administrator privileges and creates a downloadable file.
+     *
+     * @param options - Optional date range filters
+     * @param options.dateFrom - Start date filter (ISO date string)
+     * @param options.dateTo - End date filter (ISO date string)
+     * @returns Promise resolving to CSV blob for download
+     * @throws {PersApiError} When not authenticated as administrator or export fails
+     *
+     * @example Export All Campaigns
+     * ```typescript
+     * const csvBlob = await sdk.campaigns.exportCSV();
+     * const downloadUrl = URL.createObjectURL(csvBlob);
+     * ```
+     *
+     * @example Export Campaigns Within Date Range
+     * ```typescript
+     * const csvBlob = await sdk.campaigns.exportCSV({
+     *   dateFrom: '2024-01-01',
+     *   dateTo: '2024-12-31'
+     * });
+     * ```
+     */
+    async exportCSV(options) {
+        const campaignApi = new CampaignApi(this.apiClient);
+        return campaignApi.exportCSV(options);
+    }
+    /**
+     * Admin: Export campaign claims as CSV
+     *
+     * Generates a comprehensive CSV export of all campaign claim records for
+     * external analysis, reporting, or compliance purposes. This operation
+     * requires administrator privileges and creates a downloadable file.
+     *
+     * @param options - Optional date range filters
+     * @param options.dateFrom - Start date filter (ISO date string)
+     * @param options.dateTo - End date filter (ISO date string)
+     * @returns Promise resolving to CSV blob for download
+     * @throws {PersApiError} When not authenticated as administrator or export fails
+     *
+     * @example Export All Claims
+     * ```typescript
+     * const csvBlob = await sdk.campaigns.exportClaimsCSV();
+     * const downloadUrl = URL.createObjectURL(csvBlob);
+     * ```
+     */
+    async exportClaimsCSV(options) {
+        const campaignApi = new CampaignApi(this.apiClient);
+        return campaignApi.exportClaimsCSV(options);
+    }
     /**
      * Get the full campaign service for advanced operations
      *
@@ -16208,6 +16823,60 @@ class RedemptionManager {
     async deleteRedemption(id) {
         return this.redemptionService.deleteRedemption(id);
     }
+    /**
+     * Admin: Export redemptions as CSV
+     *
+     * Generates a comprehensive CSV export of all tenant redemptions for
+     * external analysis, reporting, or compliance purposes. This operation
+     * requires administrator privileges and creates a downloadable file.
+     *
+     * @param options - Optional date range filters
+     * @param options.dateFrom - Start date filter (ISO date string)
+     * @param options.dateTo - End date filter (ISO date string)
+     * @returns Promise resolving to CSV blob for download
+     * @throws {PersApiError} When not authenticated as administrator or export fails
+     *
+     * @example Export All Redemptions
+     * ```typescript
+     * const csvBlob = await sdk.redemptions.exportCSV();
+     * const downloadUrl = URL.createObjectURL(csvBlob);
+     * ```
+     *
+     * @example Export Redemptions Within Date Range
+     * ```typescript
+     * const csvBlob = await sdk.redemptions.exportCSV({
+     *   dateFrom: '2024-01-01',
+     *   dateTo: '2024-12-31'
+     * });
+     * ```
+     */
+    async exportCSV(options) {
+        const redemptionApi = new RedemptionApi(this.apiClient);
+        return redemptionApi.exportCSV(options);
+    }
+    /**
+     * Admin: Export redemption redeems as CSV
+     *
+     * Generates a comprehensive CSV export of all redemption redeem records for
+     * external analysis, reporting, or compliance purposes. This operation
+     * requires administrator privileges and creates a downloadable file.
+     *
+     * @param options - Optional date range filters
+     * @param options.dateFrom - Start date filter (ISO date string)
+     * @param options.dateTo - End date filter (ISO date string)
+     * @returns Promise resolving to CSV blob for download
+     * @throws {PersApiError} When not authenticated as administrator or export fails
+     *
+     * @example Export All Redeems
+     * ```typescript
+     * const csvBlob = await sdk.redemptions.exportRedeemsCSV();
+     * const downloadUrl = URL.createObjectURL(csvBlob);
+     * ```
+     */
+    async exportRedeemsCSV(options) {
+        const redemptionApi = new RedemptionApi(this.apiClient);
+        return redemptionApi.exportRedeemsCSV(options);
+    }
     /**
      * Get the full redemption service for advanced operations
      *
@@ -16601,54 +17270,36 @@ class TransactionManager {
      * external analysis, reporting, or compliance purposes. This operation
      * requires administrator privileges and creates a downloadable file.
      *
+     * @param options - Optional date range filters
+     * @param options.dateFrom - Start date filter (ISO date string)
+     * @param options.dateTo - End date filter (ISO date string)
      * @returns Promise resolving to CSV blob for download
      * @throws {PersApiError} When not authenticated as administrator or export fails
      *
-     * @example
+     * @example Export All Transactions
      * ```typescript
-     * // Admin operation - export transaction data
-     * try {
-     *   const csvBlob = await sdk.transactions.exportTransactionsCSV();
-     *
-     *   // Create download link
-     *   const downloadUrl = URL.createObjectURL(csvBlob);
-     *   const link = document.createElement('a');
-     *   link.href = downloadUrl;
-     *   link.download = `transactions-${new Date().toISOString().split('T')[0]}.csv`;
-     *
-     *   // Trigger download
-     *   document.body.appendChild(link);
-     *   link.click();
-     *   document.body.removeChild(link);
-     *
-     *   // Clean up object URL
-     *   URL.revokeObjectURL(downloadUrl);
-     *
-     *   console.log('Transaction export downloaded successfully');
-     *
-     * } catch (error) {
-     *   console.log('Export failed:', error.message);
-     * }
+     * const csvBlob = await sdk.transactions.exportCSV();
+     * const downloadUrl = URL.createObjectURL(csvBlob);
      * ```
      *
-     * @example Server-side Export (Node.js)
+     * @example Export Transactions Within Date Range
      * ```typescript
-     * // Admin operation - server-side CSV export
-     * const csvBlob = await sdk.transactions.exportTransactionsCSV();
-     *
-     * // Convert blob to buffer for Node.js
-     * const buffer = Buffer.from(await csvBlob.arrayBuffer());
-     *
-     * // Save to file system
-     * const fs = require('fs');
-     * const filename = `transactions-export-${Date.now()}.csv`;
-     * fs.writeFileSync(filename, buffer);
-     *
-     * console.log(`Transaction data exported to ${filename}`);
+     * const csvBlob = await sdk.transactions.exportCSV({
+     *   dateFrom: '2024-01-01',
+     *   dateTo: '2024-12-31'
+     * });
      * ```
      */
-    async exportTransactionsCSV() {
-        return this.transactionService.exportTransactionsCSV();
+    async exportCSV(options) {
+        return this.transactionService.exportTransactionsCSV(options);
+    }
+    /**
+     * Admin: Export transactions as CSV
+     *
+     * @deprecated Use `exportCSV()` instead for consistent naming across all managers
+     */
+    async exportTransactionsCSV(options) {
+        return this.exportCSV(options);
     }
     /**
      * Prepare existing transaction for client-side signing
@@ -18854,10 +19505,10 @@ class WebhookApi {
             params.append('hookId', options.webhookId);
         if (options?.status)
             params.append('status', options.status);
-        if (options?.fromDate)
-            params.append('dateFrom', options.fromDate);
-        if (options?.toDate)
-            params.append('dateTo', options.toDate);
+        if (options?.dateFrom)
+            params.append('dateFrom', options.dateFrom);
+        if (options?.dateTo)
+            params.append('dateTo', options.dateTo);
         if (options?.page)
             params.append('page', String(options.page));
         if (options?.limit)
@@ -19346,7 +19997,7 @@ class WebhookManager {
      * // Get executions for specific webhook
      * const executions = await sdk.webhooks.getExecutions({
      *   webhookId: 'webhook-123',
-     *   fromDate: '2024-01-01'
+     *   dateFrom: '2024-01-01'
      * });
      * ```
      */
@@ -20729,6 +21380,28 @@ class BookingApi {
     async delete(id) {
         return this.apiClient.delete(`${this.basePath}/${id}`);
     }
+    // ==========================================
+    // CSV EXPORT
+    // ==========================================
+    /**
+     * ADMIN: Export bookings to CSV
+     *
+     * Returns a CSV file with booking data for the tenant.
+     * Supports date range filtering.
+     *
+     * @param options - Export options (dateFrom, dateTo in ISO format)
+     * @returns CSV blob
+     */
+    async exportCSV(options) {
+        const params = new URLSearchParams();
+        if (options?.dateFrom)
+            params.append('dateFrom', options.dateFrom);
+        if (options?.dateTo)
+            params.append('dateTo', options.dateTo);
+        const queryString = params.toString();
+        const url = `${this.basePath}/export/csv${queryString ? `?${queryString}` : ''}`;
+        return this.apiClient.get(url, 'blob');
+    }
 }
 
 /**
@@ -21181,6 +21854,28 @@ class PersSDK {
         this.setupWalletEventsAutoConnect();
         // Auto-restore session from stored tokens (if enabled, default: true)
         this.setupAutoRestoreSession();
+        // Dev-mode tracking validation (helps developers ensure proper attribution)
+        this.validateTrackingInDev();
+    }
+    /**
+     * Validate tracking configuration in development mode
+     * @internal
+     */
+    validateTrackingInDev() {
+        // Only run in development (check common env vars)
+        const isDev = (typeof process !== 'undefined' && process.env?.['NODE_ENV'] === 'development') ||
+            (typeof window !== 'undefined' && window.__DEV__);
+        if (!isDev)
+            return;
+        // Delay check to allow time for setDataSource/setPlatform calls
+        setTimeout(() => {
+            const result = this.apiClient.validateTracking();
+            if (!result.isValid) {
+                console.warn('[PERS SDK] Tracking configuration warnings:');
+                result.warnings.forEach(w => console.warn(`  ⚠️ ${w}`));
+                console.warn('[PERS SDK] Call sdk.setDataSource() and sdk.setPlatform() for better analytics.');
+            }
+        }, 2000);
     }
     /**
      * Setup automatic session restoration from stored tokens
@@ -21881,6 +22576,74 @@ class PersSDK {
         // Reset manager so it picks up new config
         this._walletEvents = undefined;
     }
+    // ==========================================
+    // DATA SOURCE TRACKING
+    // ==========================================
+    /**
+     * Set data source tracking for analytics attribution
+     *
+     * Use this to track where users and actions originate from.
+     * Web apps typically only need medium/campaign/source (channel is auto-detected).
+     * Native apps must set channel: 'mobile'.
+     *
+     * @param dataSource - Data source configuration
+     *
+     * @example Web app with UTM params
+     * ```typescript
+     * sdk.setDataSource({
+     *   medium: 'email',
+     *   campaign: 'summer_2026',
+     *   source: 'mailchimp',
+     * });
+     * ```
+     *
+     * @example Native app
+     * ```typescript
+     * sdk.setDataSource({
+     *   channel: 'mobile',
+     *   medium: 'push',
+     *   campaign: 'retention_30d',
+     * });
+     * ```
+     */
+    setDataSource(dataSource) {
+        this.apiClient.setDataSource(dataSource);
+    }
+    /**
+     * Update data source (merges with existing values)
+     *
+     * @param dataSource - Partial data source to merge
+     *
+     * @example Update campaign after deep link
+     * ```typescript
+     * sdk.updateDataSource({ campaign: 'new_campaign' });
+     * ```
+     */
+    updateDataSource(dataSource) {
+        this.apiClient.updateDataSource(dataSource);
+    }
+    /**
+     * Set platform info for device analytics
+     *
+     * Native apps should call this on initialization with device info.
+     * Web apps can optionally send browser/OS info.
+     *
+     * @param platform - Platform information
+     *
+     * @example Native app
+     * ```typescript
+     * sdk.setPlatform({
+     *   os: 'iOS',
+     *   osVersion: '17.4',
+     *   app: 'MyApp',
+     *   appVersion: '2.3.1',
+     *   deviceType: 'phone',
+     * });
+     * ```
+     */
+    setPlatform(platform) {
+        this.apiClient.setPlatform(platform);
+    }
     /**
      * Gets the API client for direct PERS API requests
      *
@@ -21970,6 +22733,108 @@ function warnIfProblematicEnvironment(feature) {
     }
 }
 
+/**
+ * DataSource Tracking - SDK Extensions
+ *
+ * Re-exports from @explorins/pers-shared with SDK-specific utilities.
+ *
+ * Most types and utilities come from pers-shared:
+ * - DataSource, DataSourceChannel
+ * - Platform, UtmParams, WebDataSourceConfig, NativeDataSourceConfig
+ * - parseUtmParams(), detectSourceFromReferrer(), KNOWN_SOURCE_DOMAINS
+ *
+ * SDK adds:
+ * - detectWebPlatform() - Browser User-Agent detection (requires DOM)
+ *
+ * @module @explorins/pers-sdk/data-source
+ */
+/**
+ * Detect web platform from User-Agent (browser environments only)
+ *
+ * This uses `navigator.userAgent` which is only available in browsers.
+ * For Node.js or React Native, use platform-specific detection.
+ *
+ * @example
+ * ```typescript
+ * const platform = detectWebPlatform();
+ * sdk.setPlatform(platform);
+ * // { os: 'macOS', browser: 'Chrome', browserVersion: '125.0', deviceType: 'desktop' }
+ * ```
+ */
+function detectWebPlatform() {
+    if (typeof navigator === 'undefined') {
+        return {};
+    }
+    const ua = navigator.userAgent;
+    const platform = {};
+    if (!ua)
+        return platform;
+    // Device type detection
+    if (/mobile|android|iphone|ipod/i.test(ua)) {
+        platform.deviceType = 'phone';
+    }
+    else if (/ipad|tablet/i.test(ua)) {
+        platform.deviceType = 'tablet';
+    }
+    else {
+        platform.deviceType = 'desktop';
+    }
+    // OS detection
+    if (/windows/i.test(ua)) {
+        platform.os = 'Windows';
+        const match = ua.match(/Windows NT ([\d.]+)/);
+        if (match)
+            platform.osVersion = match[1];
+    }
+    else if (/macintosh|mac os/i.test(ua) && !/iphone|ipad|ipod/i.test(ua)) {
+        platform.os = 'macOS';
+        const match = ua.match(/Mac OS X ([\d_.]+)/);
+        if (match)
+            platform.osVersion = match[1].replace(/_/g, '.');
+    }
+    else if (/linux/i.test(ua) && !/android/i.test(ua)) {
+        platform.os = 'Linux';
+    }
+    else if (/iphone|ipad|ipod/i.test(ua)) {
+        platform.os = 'iOS';
+        const match = ua.match(/OS ([\d_]+)/);
+        if (match)
+            platform.osVersion = match[1].replace(/_/g, '.');
+    }
+    else if (/android/i.test(ua)) {
+        platform.os = 'Android';
+        const match = ua.match(/Android ([\d.]+)/);
+        if (match)
+            platform.osVersion = match[1];
+    }
+    // Browser detection
+    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];
+    }
+    return platform;
+}
+
 /**
  * AsyncStorage Token Storage for React Native Mobile Platforms
  *
@@ -22607,6 +23472,62 @@ class ReactNativeHttpClient {
     }
 }
 
+/**
+ * React Native Platform Detection Utilities
+ *
+ * Provides automatic platform info detection for React Native apps.
+ *
+ * @module @explorins/pers-sdk-react-native/utils
+ */
+// DeviceInfo is optional - dynamically loaded if available
+let DeviceInfo = null;
+try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    DeviceInfo = require('react-native-device-info').default;
+}
+catch {
+    // react-native-device-info not installed - will use basic detection
+}
+/**
+ * Detect platform info for React Native apps
+ *
+ * Automatically gathers OS, version, app info, and device type.
+ * Uses react-native-device-info for enhanced detection if installed.
+ *
+ * @example
+ * ```typescript
+ * import { detectReactNativePlatform } from '@explorins/pers-sdk-react-native';
+ *
+ * // Get platform info
+ * const platform = await detectReactNativePlatform();
+ * // { os: 'iOS', osVersion: '17.4', app: 'MyApp', appVersion: '2.3.1', deviceType: 'phone' }
+ *
+ * // Set in SDK
+ * sdk.setPlatform(platform);
+ * ```
+ */
+async function detectReactNativePlatform() {
+    const platform = {
+        os: reactNative.Platform.OS === 'ios' ? 'iOS' : reactNative.Platform.OS === 'android' ? 'Android' : reactNative.Platform.OS,
+        osVersion: reactNative.Platform.Version?.toString(),
+        deviceType: 'phone', // Default fallback
+    };
+    if (DeviceInfo) {
+        try {
+            // App info
+            platform.app = await DeviceInfo.getApplicationName();
+            platform.appVersion = DeviceInfo.getVersion();
+            // Device type detection
+            const isTablet = await DeviceInfo.isTablet();
+            platform.deviceType = isTablet ? 'tablet' : 'phone';
+        }
+        catch (error) {
+            console.debug('[Platform] DeviceInfo error, using basic detection');
+        }
+    }
+    return platform;
+}
+
 // Create the context
 const SDKContext = react.createContext(null);
 /**
@@ -22694,6 +23615,22 @@ const PersSDKProvider = ({ children, config }) => {
             };
             // Initialize PersSDK with platform-aware auth provider
             const sdkInstance = new PersSDK(httpClient, sdkConfig);
+            // Auto-configure data source and platform for React Native
+            // Native apps MUST set channel as backend cannot auto-detect without browser User-Agent
+            if (reactNative.Platform.OS !== 'web') {
+                sdkInstance.setDataSource({
+                    channel: 'mobile',
+                    source: config.dataSource?.source || 'app',
+                    medium: config.dataSource?.medium,
+                    campaign: config.dataSource?.campaign,
+                });
+                // Auto-detect platform info asynchronously
+                detectReactNativePlatform().then(platformInfo => {
+                    sdkInstance.setPlatform(platformInfo);
+                }).catch(error => {
+                    console.debug('[PersSDK] Platform detection failed:', error);
+                });
+            }
             // Subscribe to auth events BEFORE exposing SDK to consumers
             // This ensures no events are missed due to React timing
             eventUnsubscribeRef.current = sdkInstance.events.subscribe((event) => {
@@ -47477,7 +48414,13 @@ const useRedemptions = () => {
             throw new Error('SDK not initialized. Call initialize() first.');
         }
         try {
-            const result = await sdk.redemptions.getRedemptions(options);
+            // Convert Date to ISO string for API compatibility
+            const apiOptions = options ? {
+                ...options,
+                startDate: options.startDate instanceof Date ? options.startDate.toISOString() : options.startDate,
+                endDate: options.endDate instanceof Date ? options.endDate.toISOString() : options.endDate,
+            } : undefined;
+            const result = await sdk.redemptions.getRedemptions(apiOptions);
             return result;
         }
         catch (error) {
@@ -49379,6 +50322,158 @@ const useTriggerSources = () => {
     };
 };
 
+/**
+ * React hook for booking management operations
+ *
+ * Provides methods to create, read, update, and delete bookings,
+ * as well as checking if a user has a valid booking for redemption eligibility.
+ *
+ * @example
+ * ```typescript
+ * import { useBookings } from '@explorins/pers-sdk-react-native';
+ *
+ * function BookingScreen() {
+ *   const { getBookings, createBooking, hasValidBooking } = useBookings();
+ *
+ *   // List all bookings for a user
+ *   const userBookings = await getBookings({ userId: 'user-123' });
+ *
+ *   // Create a booking
+ *   const newBooking = await createBooking({
+ *     userId: 'user-123',
+ *     locationName: 'Resort Hotel',
+ *     checkInDate: '2026-06-01',
+ *     checkOutDate: '2026-06-05'
+ *   });
+ *
+ *   // Check if user has valid booking for redemption
+ *   const isEligible = await hasValidBooking('user-123', { status: 'active' });
+ * }
+ * ```
+ */
+const useBookings = () => {
+    const { sdk, isInitialized, isAuthenticated } = usePersSDK();
+    /**
+     * Get all bookings with optional filters
+     *
+     * @param options - Query options including userId, businessId, status filters
+     * @returns Array of booking DTOs
+     */
+    const getBookings = react.useCallback(async (options) => {
+        if (!isInitialized || !sdk) {
+            throw new Error('SDK not initialized. Call initialize() first.');
+        }
+        try {
+            return await sdk.bookings.getAll(options);
+        }
+        catch (error) {
+            console.error('Failed to fetch bookings:', error);
+            throw error;
+        }
+    }, [sdk, isInitialized]);
+    /**
+     * Get a single booking by ID
+     *
+     * @param id - Booking UUID
+     * @returns Booking DTO
+     */
+    const getBookingById = react.useCallback(async (id) => {
+        if (!isInitialized || !sdk) {
+            throw new Error('SDK not initialized. Call initialize() first.');
+        }
+        try {
+            return await sdk.bookings.getById(id);
+        }
+        catch (error) {
+            console.error('Failed to fetch booking:', error);
+            throw error;
+        }
+    }, [sdk, isInitialized]);
+    /**
+     * Create a new booking
+     *
+     * @param data - Booking data including userId, locationName, dates
+     * @returns Created booking DTO
+     */
+    const createBooking = react.useCallback(async (data) => {
+        if (!isInitialized || !sdk) {
+            throw new Error('SDK not initialized. Call initialize() first.');
+        }
+        try {
+            return await sdk.bookings.create(data);
+        }
+        catch (error) {
+            console.error('Failed to create booking:', error);
+            throw error;
+        }
+    }, [sdk, isInitialized]);
+    /**
+     * Update an existing booking
+     *
+     * @param id - Booking UUID
+     * @param data - Partial booking data to update
+     * @returns Updated booking DTO
+     */
+    const updateBooking = react.useCallback(async (id, data) => {
+        if (!isInitialized || !sdk) {
+            throw new Error('SDK not initialized. Call initialize() first.');
+        }
+        try {
+            return await sdk.bookings.update(id, data);
+        }
+        catch (error) {
+            console.error('Failed to update booking:', error);
+            throw error;
+        }
+    }, [sdk, isInitialized]);
+    /**
+     * Delete a booking
+     *
+     * @param id - Booking UUID
+     */
+    const deleteBooking = react.useCallback(async (id) => {
+        if (!isInitialized || !sdk) {
+            throw new Error('SDK not initialized. Call initialize() first.');
+        }
+        try {
+            await sdk.bookings.delete(id);
+        }
+        catch (error) {
+            console.error('Failed to delete booking:', error);
+            throw error;
+        }
+    }, [sdk, isInitialized]);
+    /**
+     * Check if a user has a valid booking
+     *
+     * @param userId - User ID to check
+     * @param options - Validation options including status filter
+     * @returns true if user has valid booking matching criteria
+     */
+    const hasValidBooking = react.useCallback(async (userId, options) => {
+        if (!isInitialized || !sdk) {
+            throw new Error('SDK not initialized. Call initialize() first.');
+        }
+        try {
+            return await sdk.bookings.hasValidBooking(userId, options);
+        }
+        catch (error) {
+            console.error('Failed to check booking validity:', error);
+            throw error;
+        }
+    }, [sdk, isInitialized]);
+    return {
+        getBookings,
+        getBookingById,
+        createBooking,
+        updateBooking,
+        deleteBooking,
+        hasValidBooking,
+        isInitialized,
+        isAuthenticated,
+    };
+};
+
 exports.ACTIVE_USER_DEFINITION = ACTIVE_USER_DEFINITION;
 exports.ANALYTICS_GROUP_BY_TYPES = ANALYTICS_GROUP_BY_TYPES;
 exports.ANALYTICS_METRIC_TYPES = ANALYTICS_METRIC_TYPES;
@@ -49447,6 +50542,7 @@ exports.IMAGE_CDN_MAX_INPUT_SIZE = IMAGE_CDN_MAX_INPUT_SIZE;
 exports.IMAGE_CDN_PRESETS = IMAGE_CDN_PRESETS;
 exports.IMAGE_CDN_SUPPORTED_FORMATS = IMAGE_CDN_SUPPORTED_FORMATS;
 exports.IndexedDBTokenStorage = IndexedDBTokenStorage;
+exports.KNOWN_SOURCE_DOMAINS = KNOWN_SOURCE_DOMAINS;
 exports.LOCATION_TYPES = LOCATION_TYPES;
 exports.LocalStorageTokenStorage = LocalStorageTokenStorage;
 exports.LogoutRequired = LogoutRequired;
@@ -49476,6 +50572,7 @@ exports.RedemptionService = RedemptionService;
 exports.SDK_NAME = SDK_NAME;
 exports.SDK_USER_AGENT = SDK_USER_AGENT;
 exports.SDK_VERSION = SDK_VERSION;
+exports.SELECT_OPTIONS_LABEL_DEFAULTS = SELECT_OPTIONS_LABEL_DEFAULTS;
 exports.SOURCE_LOGIC_TYPES = SOURCE_LOGIC_TYPES;
 exports.SOURCE_LOGIC_TYPE_VALUES = SOURCE_LOGIC_TYPE_VALUES;
 exports.SdkErrorCodes = SdkErrorCodes;
@@ -49494,6 +50591,7 @@ exports.TokenRefreshNeeded = TokenRefreshNeeded;
 exports.TokenSDK = TokenSDK;
 exports.TokenService = TokenService;
 exports.TokenValidityTypes = TokenValidityTypes;
+exports.TrackingManager = TrackingManager;
 exports.TransactionApi = TransactionApi;
 exports.TransactionManager = TransactionManager;
 exports.TransactionService = TransactionService;
@@ -49545,8 +50643,12 @@ exports.createReactNativeAuthProvider = createReactNativeAuthProvider;
 exports.createUserIdentifierObject = createUserIdentifierObject;
 exports.createUserStatusSDK = createUserStatusSDK;
 exports.customFieldEntityTypes = customFieldEntityTypes;
+exports.detectChannelFromUserAgent = detectChannelFromUserAgent;
 exports.detectEnvironment = detectEnvironment;
 exports.detectIdentifierType = detectIdentifierType;
+exports.detectReactNativePlatform = detectReactNativePlatform;
+exports.detectSourceFromReferrer = detectSourceFromReferrer;
+exports.detectWebPlatform = detectWebPlatform;
 exports.environment = environment;
 exports.extractData = extractData;
 exports.extractDeadlineFromSigningData = extractDeadlineFromSigningData;
@@ -49558,10 +50660,12 @@ exports.getBuiltInFieldDefinition = getBuiltInFieldDefinition;
 exports.getMetadataFromTokenUnitResponse = getMetadataFromTokenUnitResponse;
 exports.getOperatorText = getOperatorText;
 exports.getPresetDimensions = getPresetDimensions;
+exports.getSelectOptionsLabelDefault = getSelectOptionsLabelDefault;
 exports.getSigningUrl = getSigningUrl;
 exports.globalCacheService = globalCacheService;
 exports.hasMinimumRole = hasMinimumRole;
 exports.initializeReactNativePolyfills = initializeReactNativePolyfills;
+exports.isBookingStatusValid = isBookingStatusValid;
 exports.isBuiltInUserField = isBuiltInUserField;
 exports.isConnectedMessage = isConnectedMessage;
 exports.isDataSourceChannel = isDataSourceChannel;
@@ -49598,6 +50702,7 @@ exports.needsSubmission = needsSubmission;
 exports.normalizeFilters = normalizeFilters;
 exports.normalizeToPaginated = normalizeToPaginated;
 exports.operatorText = operatorText;
+exports.parseUtmParams = parseUtmParams;
 exports.registerIdentifierType = registerIdentifierType;
 exports.selectOptionsSourceEntities = selectOptionsSourceEntities;
 exports.testnetPrefix = testnetPrefix;
@@ -49605,6 +50710,7 @@ exports.testnetShortPrefix = testnetShortPrefix;
 exports.uniqueUserIdentifierKeys = uniqueUserIdentifierKeys;
 exports.useAnalytics = useAnalytics;
 exports.useAuth = useAuth;
+exports.useBookings = useBookings;
 exports.useBusiness = useBusiness;
 exports.useCampaigns = useCampaigns;
 exports.useDonations = useDonations;