@explorins/pers-sdk-react-native 2.1.13 → 2.1.14-beta.0

package/dist/providers/rn-dpop-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rn-dpop-provider.d.ts","sourceRoot":"","sources":["../../src/providers/rn-dpop-provider.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAiB3E,qBAAa,uBAAwB,YAAW,kBAAkB;IAChE;;;;;OAKG;IACG,eAAe,CAAC,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAqC1E,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAqD9E,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgB3D,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,eAAe;CAOxB"}
+{"version":3,"file":"rn-dpop-provider.d.ts","sourceRoot":"","sources":["../../src/providers/rn-dpop-provider.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAgD3E,qBAAa,uBAAwB,YAAW,kBAAkB;IAChE;;;;;OAKG;IACG,eAAe,CAAC,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IA0C1E,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IA0D9E,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqB3D,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,eAAe;CAOxB"}

package/dist/providers/rn-dpop-provider.js

@@ -1,20 +1,44 @@
 import { Platform } from 'react-native';
 import { Buffer } from 'buffer';
-// Conditionally require quick-crypto for Native platforms only
-let crypto;
-if (Platform.OS !== 'web') {
+// Lazy-loaded crypto module - initialized on first use to avoid native module timing issues
+let _crypto = null;
+let _cryptoInitialized = false;
+/**
+ * Lazily load the crypto module.
+ *
+ * Supports customer pre-initialization via global.__QuickCrypto for environments
+ * where native module timing is unpredictable (e.g., certain React Native setups).
+ *
+ * @returns The crypto module or null if unavailable
+ */
+function getCrypto() {
+    if (_cryptoInitialized) {
+        return _crypto;
+    }
+    _cryptoInitialized = true;
+    if (Platform.OS === 'web') {
+        // On Web, we shouldn't be using this provider (Core SDK has WebDPoPProvider)
+        _crypto = {
+            generateKeyPair: () => { throw new Error('ReactNativeDPoPProvider not supported on Web'); },
+            randomUUID: () => globalThis.crypto?.randomUUID?.() || `${Date.now()}-${Math.random()}`
+        };
+        return _crypto;
+    }
+    // Check for customer pre-initialized global (for native module timing issues)
+    if (typeof global !== 'undefined' && global.__QuickCrypto) {
+        _crypto = global.__QuickCrypto;
+        return _crypto;
+    }
+    // Standard lazy load
     try {
-        crypto = require('react-native-quick-crypto').default || require('react-native-quick-crypto');
+        _crypto = require('react-native-quick-crypto').default || require('react-native-quick-crypto');
     }
     catch (e) {
-        console.warn('ReactNativeDPoPProvider: Failed to load react-native-quick-crypto', e);
+        console.warn('ReactNativeDPoPProvider: Failed to load react-native-quick-crypto.', e);
+        console.warn('Tip: If you encounter timing issues, pre-initialize in index.js: global.__QuickCrypto = require("react-native-quick-crypto")');
+        _crypto = null;
     }
-}
-else {
-    // on Web, we shouldn't be using this provider anyway (Core SDK has WebDPoPProvider)
-    crypto = {
-        generateKeyPair: () => { throw new Error('ReactNativeDPoPProvider not supported on Web'); }
-    };
+    return _crypto;
 }
 export class ReactNativeDPoPProvider {
     /**
@@ -24,6 +48,10 @@ export class ReactNativeDPoPProvider {
      * Falls back to Node.js crypto API on iOS if needed.
      */
     async generateKeyPair(options) {
+        const crypto = getCrypto();
+        if (!crypto) {
+            throw new Error('Crypto module not available. Install react-native-quick-crypto or pre-initialize global.__QuickCrypto');
+        }
         // Try WebCrypto API first (works on both iOS and Android)
         if (crypto.subtle) {
             try {
@@ -57,6 +85,10 @@ export class ReactNativeDPoPProvider {
         });
     }
     async signProof(payload, keyPair) {
+        const crypto = getCrypto();
+        if (!crypto) {
+            throw new Error('Crypto module not available for signing');
+        }
         // 1. Construct Header
         const header = {
             typ: 'dpop+jwt',
@@ -67,7 +99,7 @@ export class ReactNativeDPoPProvider {
         const finalPayload = {
             ...payload,
             iat: payload.iat || Math.floor(Date.now() / 1000),
-            jti: payload.jti || crypto.randomUUID()
+            jti: payload.jti || (crypto.randomUUID?.() || `${Date.now()}-${Math.random()}`)
         };
         // 3. Encode
         const b64Header = this.base64Url(JSON.stringify(header));
@@ -93,6 +125,10 @@ export class ReactNativeDPoPProvider {
         return `${signingInput}.${this.base64UrlBuffer(signature)}`;
     }
     async hashAccessToken(accessToken) {
+        const crypto = getCrypto();
+        if (!crypto) {
+            throw new Error('Crypto module not available for hashing');
+        }
         // Try WebCrypto first
         if (crypto.subtle) {
             try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@explorins/pers-sdk-react-native",
-  "version": "2.1.13",
+  "version": "2.1.14-beta.0",
   "description": "React Native SDK for PERS Platform - Tourism Loyalty System with Blockchain Transaction Signing and WebAuthn Authentication",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -37,7 +37,7 @@
   "author": "eXplorins",
   "license": "MIT",
   "dependencies": {
-    "@explorins/pers-sdk": "^2.1.20",
+    "@explorins/pers-sdk": "^2.1.21",
     "@explorins/pers-signer": "^1.0.33",
     "buffer": "^6.0.3",
     "ethers": "^6.15.0",

package/src/hooks/useCampaigns.ts

@@ -22,6 +22,8 @@ export type { CampaignClaimFilters } from '@explorins/pers-sdk/campaign';
 export interface GetCampaignsOptions {
   /** Filter by tag */
   tag?: string;
+  /** Free text search across name and description (case-insensitive) */
+  search?: string;
   /** Filter by business ID */
   businessId?: string;
   /** Page number (1-indexed) */

package/src/hooks/useRedemptions.ts

@@ -10,13 +10,32 @@ import type {
   PaginatedResponseDTO,
   RedemptionRedeemIncludeRelation,
   ProcessRecordStatus,
-  DynamicContext
+  DynamicContext,
+  SortOrder
 } from '@explorins/pers-shared';
-import type { RedemptionRedeemFilters } from '@explorins/pers-sdk/redemption';
+import type { RedemptionRedeemFilters, RedemptionFilterOptions } from '@explorins/pers-sdk/redemption';
 import type { PaginationOptions } from '@explorins/pers-sdk';
 
 // Re-export for consumers
-export type { RedemptionRedeemFilters } from '@explorins/pers-sdk/redemption';
+export type { RedemptionRedeemFilters, RedemptionFilterOptions } from '@explorins/pers-sdk/redemption';
+
+/**
+ * Options for fetching redemptions with filtering and pagination
+ */
+export interface GetRedemptionsOptions {
+  /** Filter by active status (Admin only - regular users always see active offers) */
+  active?: boolean;
+  /** Free text search across name, description, tags (case-insensitive) */
+  search?: string;
+  /** Page number (1-indexed) */
+  page?: number;
+  /** Results per page */
+  limit?: number;
+  /** Field to sort by */
+  sortBy?: 'name' | 'createdAt';
+  /** Sort direction */
+  sortOrder?: SortOrder;
+}
 
 export const useRedemptions = () => {
   const { sdk, isInitialized, isAuthenticated } = usePersSDK();
@@ -29,8 +48,37 @@ export const useRedemptions = () => {
    * **Administrators:** Can see all redemptions and filter by active/inactive status
    * 
    * The backend enforces permission-based filtering automatically.
+   * 
+   * @param options - Filter and pagination options
+   * @param options.active - Filter by active status (Admin only)
+   * @param options.search - Free text search across name, description, tags
+   * @param options.page - Page number (1-indexed)
+   * @param options.limit - Results per page
+   * @param options.sortBy - Field to sort by ('name' | 'createdAt')
+   * @param options.sortOrder - Sort direction ('ASC' | 'DESC')
+   * 
+   * @example Basic usage
+   * ```typescript
+   * const { data: offers } = await getRedemptions();
+   * ```
+   * 
+   * @example Search redemptions
+   * ```typescript
+   * const { data: coffeeOffers } = await getRedemptions({ search: 'coffee' });
+   * ```
+   * 
+   * @example With pagination and sorting
+   * ```typescript
+   * const { data, pagination } = await getRedemptions({ 
+   *   search: 'discount',
+   *   page: 1, 
+   *   limit: 10,
+   *   sortBy: 'name',
+   *   sortOrder: 'ASC'
+   * });
+   * ```
    */
-  const getRedemptions = useCallback(async (options?: { active?: boolean }): Promise<PaginatedResponseDTO<RedemptionDTO>> => {
+  const getRedemptions = useCallback(async (options?: GetRedemptionsOptions): Promise<PaginatedResponseDTO<RedemptionDTO>> => {
     if (!isInitialized || !sdk) {
       throw new Error('SDK not initialized. Call initialize() first.');
     }

package/src/hooks/useTransactionSigner.ts

@@ -19,14 +19,44 @@ export type { StatusUpdateData };
 export type OnStatusUpdateFn = (status: SigningStatus, message: string, data?: StatusUpdateData) => void;
 
 
-// Dynamic import the signer SDK to avoid build issues with static dependencies
-let createPersSignerSDK: ((config: PersSignerConfig) => Promise<PersSignerSDK>) | null = null;
-try {
-  const signerModule = require('@explorins/pers-signer/react-native');
-  createPersSignerSDK = signerModule.createPersSignerSDK;
-} catch (error: unknown) {
-  console.warn('[useTransactionSigner] PERS Signer SDK not available:', (error as Error).message);
-  console.warn('[useTransactionSigner] Real blockchain signing will not be available');
+// Lazy-loaded signer SDK factory - initialized on first use to avoid native module timing issues
+let _createPersSignerSDK: ((config: PersSignerConfig) => Promise<PersSignerSDK>) | null = null;
+let _signerInitAttempted = false;
+
+/**
+ * Lazily load the PERS Signer SDK.
+ * 
+ * Supports customer pre-initialization via global.__PersSigner for environments
+ * where native module timing is unpredictable (e.g., certain React Native setups).
+ * 
+ * @returns The createPersSignerSDK function or null if unavailable
+ */
+function getSignerSDKFactory(): ((config: PersSignerConfig) => Promise<PersSignerSDK>) | null {
+  if (_signerInitAttempted) {
+    // Already tried - return cached result (could be null if failed)
+    return _createPersSignerSDK;
+  }
+  
+  _signerInitAttempted = true;
+  
+  // Check for customer pre-initialized global (for native module timing issues)
+  if (typeof global !== 'undefined' && (global as any).__PersSigner?.createPersSignerSDK) {
+    _createPersSignerSDK = (global as any).__PersSigner.createPersSignerSDK;
+    return _createPersSignerSDK;
+  }
+  
+  // Standard lazy load
+  try {
+    const signerModule = require('@explorins/pers-signer/react-native');
+    _createPersSignerSDK = signerModule.createPersSignerSDK;
+    return _createPersSignerSDK;
+  } catch (error: unknown) {
+    console.warn('[useTransactionSigner] PERS Signer SDK not available:', (error as Error).message);
+    console.warn('[useTransactionSigner] Real blockchain signing will not be available');
+    console.warn('[useTransactionSigner] Tip: If timing issues, pre-initialize in index.js: global.__PersSigner = require("@explorins/pers-signer/react-native")');
+    _createPersSignerSDK = null; // Mark as unavailable
+    return null;
+  }
 }
 
 
@@ -243,6 +273,7 @@ export const useTransactionSigner = (): TransactionSignerHook => {
   // Auto-initialize signer SDK when PERS SDK is ready
   useEffect(() => {
     const initializeSignerSDK = async () => {
+      const createPersSignerSDK = getSignerSDKFactory();
       if (!createPersSignerSDK) {
         console.warn('[useTransactionSigner] Signer SDK not available');
         return;
@@ -361,7 +392,7 @@ export const useTransactionSigner = (): TransactionSignerHook => {
     if (!isSignerInitialized || !signerSDKRef.current) {
       throw new Error('Transaction signer not initialized');
     }
-    if (!createPersSignerSDK) {
+    if (!getSignerSDKFactory()) {
       throw new Error('PERS Signer SDK not available. Blockchain signing is not supported.');
     }
 
@@ -514,7 +545,7 @@ export const useTransactionSigner = (): TransactionSignerHook => {
      * );
      * ```
      */
-    isSignerAvailable: isSignerInitialized && !!createPersSignerSDK,
+    isSignerAvailable: isSignerInitialized && !!getSignerSDKFactory(),
     
     /**
      * Current signing status for UI feedback

package/src/providers/rn-dpop-provider.ts

@@ -2,19 +2,50 @@ import { Platform } from 'react-native';
 import { Buffer } from 'buffer';
 import { DPoPCryptoProvider, DPoPKeyPair } from '@explorins/pers-sdk/core';
 
-// Conditionally require quick-crypto for Native platforms only
-let crypto: any;
-if (Platform.OS !== 'web') {
+// Lazy-loaded crypto module - initialized on first use to avoid native module timing issues
+let _crypto: any = null;
+let _cryptoInitialized = false;
+
+/**
+ * Lazily load the crypto module.
+ * 
+ * Supports customer pre-initialization via global.__QuickCrypto for environments
+ * where native module timing is unpredictable (e.g., certain React Native setups).
+ * 
+ * @returns The crypto module or null if unavailable
+ */
+function getCrypto(): any {
+  if (_cryptoInitialized) {
+    return _crypto;
+  }
+  
+  _cryptoInitialized = true;
+  
+  if (Platform.OS === 'web') {
+    // On Web, we shouldn't be using this provider (Core SDK has WebDPoPProvider)
+    _crypto = {
+      generateKeyPair: () => { throw new Error('ReactNativeDPoPProvider not supported on Web'); },
+      randomUUID: () => globalThis.crypto?.randomUUID?.() || `${Date.now()}-${Math.random()}`
+    };
+    return _crypto;
+  }
+  
+  // Check for customer pre-initialized global (for native module timing issues)
+  if (typeof global !== 'undefined' && (global as any).__QuickCrypto) {
+    _crypto = (global as any).__QuickCrypto;
+    return _crypto;
+  }
+  
+  // Standard lazy load
   try {
-    crypto = require('react-native-quick-crypto').default || require('react-native-quick-crypto');
+    _crypto = require('react-native-quick-crypto').default || require('react-native-quick-crypto');
   } catch (e) {
-    console.warn('ReactNativeDPoPProvider: Failed to load react-native-quick-crypto', e);
+    console.warn('ReactNativeDPoPProvider: Failed to load react-native-quick-crypto.', e);
+    console.warn('Tip: If you encounter timing issues, pre-initialize in index.js: global.__QuickCrypto = require("react-native-quick-crypto")');
+    _crypto = null;
   }
-} else {
-  // on Web, we shouldn't be using this provider anyway (Core SDK has WebDPoPProvider)
-  crypto = {
-    generateKeyPair: () => { throw new Error('ReactNativeDPoPProvider not supported on Web'); }
-  };
+  
+  return _crypto;
 }
 
 export class ReactNativeDPoPProvider implements DPoPCryptoProvider {
@@ -25,6 +56,11 @@ export class ReactNativeDPoPProvider implements DPoPCryptoProvider {
    * Falls back to Node.js crypto API on iOS if needed.
    */
   async generateKeyPair(options?: { extractable?: boolean }): Promise<DPoPKeyPair> {
+    const crypto = getCrypto();
+    if (!crypto) {
+      throw new Error('Crypto module not available. Install react-native-quick-crypto or pre-initialize global.__QuickCrypto');
+    }
+    
     // Try WebCrypto API first (works on both iOS and Android)
     if (crypto.subtle) {
       try {
@@ -62,6 +98,11 @@ export class ReactNativeDPoPProvider implements DPoPCryptoProvider {
   }
 
   async signProof(payload: Record<string, any>, keyPair: DPoPKeyPair): Promise<string> {
+    const crypto = getCrypto();
+    if (!crypto) {
+      throw new Error('Crypto module not available for signing');
+    }
+    
     // 1. Construct Header
     const header = {
       typ: 'dpop+jwt',
@@ -73,7 +114,7 @@ export class ReactNativeDPoPProvider implements DPoPCryptoProvider {
     const finalPayload = {
       ...payload,
       iat: payload.iat || Math.floor(Date.now() / 1000),
-      jti: payload.jti || crypto.randomUUID()
+      jti: payload.jti || (crypto.randomUUID?.() || `${Date.now()}-${Math.random()}`)
     };
 
     // 3. Encode
@@ -115,6 +156,11 @@ export class ReactNativeDPoPProvider implements DPoPCryptoProvider {
   }
 
   async hashAccessToken(accessToken: string): Promise<string> {
+    const crypto = getCrypto();
+    if (!crypto) {
+      throw new Error('Crypto module not available for hashing');
+    }
+    
     // Try WebCrypto first
     if (crypto.subtle) {
       try {