@explorins/pers-sdk-react-native 2.3.4 → 2.3.6

package/dist/index.js

@@ -4261,6 +4261,7 @@ function isBookingStatusValid(status, requirement) {
  * @param checkOutDate - Booking end date
  * @param referenceDate - Date to compare against (defaults to current date)
  * @returns Computed booking status
+ * @throws Error if checkOutDate is not after checkInDate
  *
  * @example
  * // Today is June 5
@@ -4277,6 +4278,11 @@ function computeBookingStatus(checkInDate, checkOutDate, referenceDate = new Dat
     now.setHours(0, 0, 0, 0);
     checkIn.setHours(0, 0, 0, 0);
     checkOut.setHours(0, 0, 0, 0);
+    // Defensive validation: checkOut must be after checkIn
+    // This catches invalid data from frontend or data integrity issues
+    if (checkOut <= checkIn) {
+        throw new Error(`Invalid booking dates: checkOut (${checkOut.toISOString()}) must be after checkIn (${checkIn.toISOString()})`);
+    }
     // Checkout day itself counts as still active (guest there until end of day)
     if (checkOut < now) {
         return 'past';
@@ -4311,14 +4317,15 @@ function computeBookingStatus(checkInDate, checkOutDate, referenceDate = new Dat
  *
  * ## 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
@@ -4335,10 +4342,14 @@ function computeBookingStatus(checkInDate, checkOutDate, referenceDate = new Dat
  */
 /**
  * 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
  */
 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)
@@ -4466,17 +4477,114 @@ 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' }
+ */
+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)
  */
 function detectChannelFromUserAgent(userAgent, path) {
     // Check for webhook paths
@@ -4484,16 +4592,18 @@ 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.).
@@ -6341,6 +6451,43 @@ class TokenApi {
     async deleteTokenMetadata(metadataId) {
         return this.apiClient.delete(`${this.basePath}/metadata/${metadataId}`);
     }
+    // ==========================================
+    // 📊 CSV EXPORT
+    // ==========================================
+    /**
+     * ADMIN: Export token metadata to CSV
+     *
+     * Returns a CSV file with all token metadata for the tenant.
+     * Supports date range filtering.
+     *
+     * Endpoint: GET /tokens/metadata/export/csv
+     * Auth: @TenantAdmin()
+     *
+     * @param options - Export options (dateFrom, dateTo)
+     * @returns CSV blob
+     *
+     * @example
+     * ```typescript
+     * // Export all token metadata
+     * const csvBlob = await tokenApi.exportMetadataCSV();
+     *
+     * // Export metadata created in date range
+     * const csvBlob = await tokenApi.exportMetadataCSV({
+     *   dateFrom: '2026-01-01',
+     *   dateTo: '2026-06-30'
+     * });
+     * ```
+     */
+    async exportMetadataCSV(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}/metadata/export/csv${queryString ? `?${queryString}` : ''}`;
+        return this.apiClient.get(url, 'blob');
+    }
 }
 
 /**
@@ -6513,6 +6660,22 @@ class TokenService {
     async deleteTokenMetadata(metadataId) {
         return this.tokenApi.deleteTokenMetadata(metadataId);
     }
+    // ==========================================
+    // 📊 CSV EXPORT
+    // ==========================================
+    /**
+     * ADMIN: Export token metadata to CSV
+     *
+     * Returns a CSV file containing all token metadata for the tenant.
+     * Supports date range filtering.
+     *
+     * @param options - Export options (dateFrom, dateTo)
+     * @returns Promise resolving to CSV blob
+     * @throws {PersApiError} When not authenticated as tenant admin
+     */
+    async exportMetadataCSV(options) {
+        return this.tokenApi.exportMetadataCSV(options);
+    }
 }
 
 /**
@@ -6728,6 +6891,55 @@ class BusinessApi {
     async toggleBusinessStatus(id, dto) {
         return this.apiClient.put(`${this.basePath}/${id}/status`, dto);
     }
+    /**
+     * ADMIN: Generate new business API key (CURRENTLY DISABLED)
+     *
+     * NOTE: This endpoint is commented out in the backend controller.
+     * Uncomment the controller method first before using this.
+     *
+     * Endpoint: PUT /businesses/{id}/api-key
+     * Auth: @TenantAdmin()
+     */
+    // async generateNewBusinessApiKey(id: string): Promise<string> {
+    //   return this.apiClient.put<string>(`${this.basePath}/${id}/api-key`, {});
+    // }
+    // ==========================================
+    // 📊 CSV EXPORT
+    // ==========================================
+    /**
+     * ADMIN: Export businesses to CSV
+     *
+     * Returns a CSV file with all business data for the tenant.
+     * Supports date range filtering.
+     *
+     * Endpoint: GET /businesses/export/csv
+     * Auth: @TenantAdmin()
+     *
+     * @param options - Export options (dateFrom, dateTo)
+     * @returns CSV blob
+     *
+     * @example
+     * ```typescript
+     * // Export all businesses
+     * const csvBlob = await businessApi.exportCSV();
+     *
+     * // Export businesses created in date range
+     * const csvBlob = await businessApi.exportCSV({
+     *   dateFrom: '2026-01-01',
+     *   dateTo: '2026-06-30'
+     * });
+     * ```
+     */
+    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');
+    }
 }
 
 /**
@@ -12115,7 +12327,7 @@ class DefaultAuthProvider {
 /** SDK package name */
 const SDK_NAME = "@explorins/pers-sdk";
 /** SDK version - injected from package.json at build time */
-const SDK_VERSION = "2.3.9";
+const SDK_VERSION = "2.3.12";
 /** Full SDK identifier for headers */
 const SDK_USER_AGENT = `${SDK_NAME}/${SDK_VERSION}`;
 
@@ -14421,6 +14633,41 @@ class TokenManager {
     getTokenService() {
         return this.tokenService;
     }
+    // ==========================================
+    // 📊 CSV EXPORT
+    // ==========================================
+    /**
+     * Admin: Export token metadata to CSV
+     *
+     * Returns a CSV file with all token metadata (rewards/stamps) for the tenant.
+     * Supports date range filtering.
+     *
+     * @param options - Export options (dateFrom, dateTo)
+     * @returns Promise resolving to CSV blob
+     * @throws {PersApiError} When not authenticated as tenant admin
+     *
+     * @example
+     * ```typescript
+     * // Export all token metadata
+     * const csvBlob = await sdk.tokens.exportMetadataCSV();
+     *
+     * // Export metadata created in date range
+     * const csvBlob = await sdk.tokens.exportMetadataCSV({
+     *   dateFrom: '2026-01-01',
+     *   dateTo: '2026-06-30'
+     * });
+     *
+     * // Download the CSV
+     * const url = URL.createObjectURL(csvBlob);
+     * const a = document.createElement('a');
+     * a.href = url;
+     * a.download = 'token-metadata.csv';
+     * a.click();
+     * ```
+     */
+    async exportMetadataCSV(options) {
+        return this.tokenService.exportMetadataCSV(options);
+    }
 }
 
 /**
@@ -15062,6 +15309,41 @@ class BusinessManager {
     getMembershipService() {
         return this.membershipService;
     }
+    // ==========================================
+    // 📊 CSV EXPORT
+    // ==========================================
+    /**
+     * Admin: Export businesses to CSV
+     *
+     * Returns a CSV file with all business data for the tenant.
+     * Supports date range filtering.
+     *
+     * @param options - Export options (dateFrom, dateTo)
+     * @returns Promise resolving to CSV blob
+     * @throws {PersApiError} When not authenticated as tenant admin
+     *
+     * @example
+     * ```typescript
+     * // Export all businesses
+     * const csvBlob = await sdk.business.exportCSV();
+     *
+     * // Export businesses created in date range
+     * const csvBlob = await sdk.business.exportCSV({
+     *   dateFrom: '2026-01-01',
+     *   dateTo: '2026-06-30'
+     * });
+     *
+     * // Download the CSV
+     * const url = URL.createObjectURL(csvBlob);
+     * const a = document.createElement('a');
+     * a.href = url;
+     * a.download = 'businesses.csv';
+     * a.click();
+     * ```
+     */
+    async exportCSV(options) {
+        return this.businessApi.exportCSV(options);
+    }
 }
 
 /**
@@ -50743,6 +51025,7 @@ exports.needsSubmission = needsSubmission;
 exports.normalizeFilters = normalizeFilters;
 exports.normalizeToPaginated = normalizeToPaginated;
 exports.operatorText = operatorText;
+exports.parseUserAgentForPlatform = parseUserAgentForPlatform;
 exports.parseUtmParams = parseUtmParams;
 exports.registerIdentifierType = registerIdentifierType;
 exports.selectOptionsSourceEntities = selectOptionsSourceEntities;