@explorins/pers-sdk-react-native 2.3.5 → 2.3.7

package/dist/hooks/useTransactions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useTransactions.d.ts","sourceRoot":"","sources":["../../src/hooks/useTransactions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,KAAK,EACV,qBAAqB,EACrB,6BAA6B,EAC7B,cAAc,EACd,+BAA+B,EAC/B,oBAAoB,EACpB,0BAA0B,EAC3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAG/E,YAAY,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,eAAe;iCAgC4B,qBAAqB,mBAAmB,gBAAgB,KAAG,QAAQ,6BAA6B,CAAC;wCAmEtI,MAAM,YACX,0BAA0B,EAAE,KACrC,QAAQ,cAAc,GAAG,IAAI,CAAC;0CAmDrB,uBAAuB,KAChC,QAAQ,qBAAqB,cAAc,CAAC,CAAC;wCAyCrC,+BAA+B,GAAG;QACzC,OAAO,CAAC,EAAE,0BAA0B,EAAE,CAAC;KACxC,KACA,QAAQ,qBAAqB,cAAc,CAAC,CAAC;iCAcI,QAAQ,IAAI,CAAC;;;;CAyBlE,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC"}
+{"version":3,"file":"useTransactions.d.ts","sourceRoot":"","sources":["../../src/hooks/useTransactions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,KAAK,EACV,qBAAqB,EACrB,6BAA6B,EAC7B,cAAc,EACd,+BAA+B,EAC/B,oBAAoB,EACpB,0BAA0B,EAC3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAI/E,YAAY,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,eAAe;iCAgC4B,qBAAqB,mBAAmB,gBAAgB,KAAG,QAAQ,6BAA6B,CAAC;wCA2EtI,MAAM,YACX,0BAA0B,EAAE,KACrC,QAAQ,cAAc,GAAG,IAAI,CAAC;0CAmDrB,uBAAuB,KAChC,QAAQ,qBAAqB,cAAc,CAAC,CAAC;wCAyCrC,+BAA+B,GAAG;QACzC,OAAO,CAAC,EAAE,0BAA0B,EAAE,CAAC;KACxC,KACA,QAAQ,qBAAqB,cAAc,CAAC,CAAC;iCAcI,QAAQ,IAAI,CAAC;;;;CAyBlE,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/hooks/useTransactions.js

@@ -1,6 +1,7 @@
 import { useCallback } from 'react';
 import { usePersSDK } from '../providers/PersSDKProvider';
 import { useTransactionSigner } from './useTransactionSigner';
+import { needsSubmission } from '@explorins/pers-sdk/transaction';
 /**
  * React hook for transaction operations in the PERS SDK
  *
@@ -73,15 +74,22 @@ export const useTransactions = () => {
         }
         try {
             const result = await sdk.transactions.createTransaction(request);
-            // Check if transaction requires signing (contains actionable authToken)
+            // If backend already signed custodially, return as-is so caller can build QR
+            // from result.signatureData directly (no client signing needed)
+            if (needsSubmission(result)) {
+                return result;
+            }
+            // If client signer is unavailable, return as-is so caller can fall back to
+            // result.actionable.actionUrl (external signing URL) if present
+            if (!isSignerAvailable) {
+                console.warn('[useTransactions] Transaction signer not available, returning result for caller to handle');
+                return result;
+            }
+            // Check if transaction requires client signing (contains actionable authToken)
             // Type assertion needed as TransactionRequestResponseDTO type may not include all dynamic properties
             const txToken = result?.actionable?.authToken;
             if (txToken) {
                 try {
-                    if (!isSignerAvailable) {
-                        console.warn('[useTransactions] Transaction signer not available, skipping automatic signing');
-                        return result;
-                    }
                     // Automatically sign the transaction using the authToken
                     const signingResult = await signAndSubmitTransactionWithJWT(txToken, onStatusUpdate);
                     if (signingResult.success) {

package/dist/index.d.ts

@@ -325,7 +325,7 @@ export type { TokenBalanceRequest, TokenBalance, TokenMetadata, TokenCollection,
  * @see {@link buildPOSBurnRequest} - Create POS burn requests (business submits burn on behalf of user)
  * @see {@link buildSubmissionRequest} - Create submission requests from QR/signature data
  */
-export { buildMintRequest, buildBurnRequest, buildTransferRequest, buildPOSTransferRequest, buildPOSBurnRequest, buildSubmissionRequest, ClientTransactionType, extractDeadlineFromSigningData, buildPendingTransactionData } from '@explorins/pers-sdk/transaction';
+export { buildMintRequest, buildBurnRequest, buildTransferRequest, buildPOSTransferRequest, buildPOSBurnRequest, buildSubmissionRequest, ClientTransactionType, extractDeadlineFromSigningData, buildPendingTransactionData, needsSubmission, needsExternalSigning, getSigningUrl } from '@explorins/pers-sdk/transaction';
 export type { POSAuthorizationOptions, PendingTransactionParams } from '@explorins/pers-sdk/transaction';
 /**
  * Structured error handling for PERS SDK

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -4317,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
@@ -4341,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)
@@ -4472,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
@@ -4490,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.).
@@ -6347,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');
+    }
 }
 
 /**
@@ -6519,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);
+    }
 }
 
 /**
@@ -6734,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');
+    }
 }
 
 /**
@@ -12121,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.10";
+const SDK_VERSION = "2.3.12";
 /** Full SDK identifier for headers */
 const SDK_USER_AGENT = `${SDK_NAME}/${SDK_VERSION}`;
 
@@ -14427,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);
+    }
 }
 
 /**
@@ -15068,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);
+    }
 }
 
 /**
@@ -47572,15 +47848,22 @@ const useTransactions = () => {
         }
         try {
             const result = await sdk.transactions.createTransaction(request);
-            // Check if transaction requires signing (contains actionable authToken)
+            // If backend already signed custodially, return as-is so caller can build QR
+            // from result.signatureData directly (no client signing needed)
+            if (needsSubmission(result)) {
+                return result;
+            }
+            // If client signer is unavailable, return as-is so caller can fall back to
+            // result.actionable.actionUrl (external signing URL) if present
+            if (!isSignerAvailable) {
+                console.warn('[useTransactions] Transaction signer not available, returning result for caller to handle');
+                return result;
+            }
+            // Check if transaction requires client signing (contains actionable authToken)
             // Type assertion needed as TransactionRequestResponseDTO type may not include all dynamic properties
             const txToken = result?.actionable?.authToken;
             if (txToken) {
                 try {
-                    if (!isSignerAvailable) {
-                        console.warn('[useTransactions] Transaction signer not available, skipping automatic signing');
-                        return result;
-                    }
                     // Automatically sign the transaction using the authToken
                     const signingResult = await signAndSubmitTransactionWithJWT(txToken, onStatusUpdate);
                     if (signingResult.success) {
@@ -50749,6 +51032,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;