@explorins/pers-sdk-react-native 2.1.13 → 2.1.17

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/hooks/useTransactions.ts

@@ -8,7 +8,7 @@ import type {
   TransactionPaginationRequestDTO,
   PaginatedResponseDTO,
   TransactionIncludeRelation
-} from '@explorins/pers-shared';
+} from '@explorins/pers-sdk';
 import type { TransactionQueryOptions } from '@explorins/pers-sdk/transaction';
 
 // Re-export for consumers

package/src/hooks/useTriggerSources.ts

@@ -4,7 +4,7 @@ import type {
   TriggerSourceDTO,
   TriggerSourceCreateRequestDTO,
   PaginatedResponseDTO
-} from '@explorins/pers-shared';
+} from '@explorins/pers-sdk';
 import type { TriggerSourceQueryOptions } from '@explorins/pers-sdk/trigger-source';
 
 // Re-export for consumers

package/src/hooks/useUserStatus.ts

@@ -1,6 +1,6 @@
 import { useCallback } from 'react';
 import { usePersSDK } from '../providers/PersSDKProvider';
-import type { UserStatusTypeDTO, PaginatedResponseDTO } from '@explorins/pers-shared';
+import type { UserStatusTypeDTO, PaginatedResponseDTO } from '@explorins/pers-sdk';
 
 export const useUserStatus = () => {
   const { sdk, isInitialized, isAuthenticated } = usePersSDK();

package/src/hooks/useUsers.ts

@@ -1,6 +1,6 @@
 import { useCallback } from 'react';
 import { usePersSDK } from '../providers/PersSDKProvider';
-import type { UserDTO, UserCreateRequestDTO, PaginatedResponseDTO } from '@explorins/pers-shared';
+import type { UserDTO, UserCreateRequestDTO, PaginatedResponseDTO } from '@explorins/pers-sdk';
 import type { UserPublicProfileDTO, UserQueryOptions } from '@explorins/pers-sdk/user';
 
 // Re-export for consumers

package/src/index.ts

@@ -284,10 +284,13 @@ export type { EventsHook, PersEvent, EventHandler, EventFilter, Unsubscribe } fr
 export type { TokenBalanceWithToken, UseTokenBalancesOptions, UseTokenBalancesResult } from './hooks';
 
 // Re-export campaign types for convenience
-export type { CampaignClaimFilters, CampaignHook, GetCampaignsOptions } from './hooks';
+export type { CampaignClaimFilters, CampaignFilterOptions, CampaignHook, GetCampaignsOptions } from './hooks';
 
 // Re-export redemption types for convenience
-export type { RedemptionRedeemFilters, RedemptionHook } from './hooks';
+export type { RedemptionRedeemFilters, RedemptionFilterOptions, RedemptionHook, GetRedemptionsOptions } from './hooks';
+
+// Re-export business types for convenience
+export type { BusinessFilterOptions, BusinessHook } from './hooks';
 
 // Re-export transaction types for convenience
 export type { TransactionQueryOptions, TransactionHook } from './hooks';
@@ -357,7 +360,7 @@ export {
  * 
  * @see {@link https://github.com/eXplorins/pers-shared} - Shared library documentation
  */
-export * from '@explorins/pers-shared';
+export * from '@explorins/pers-sdk';
 
 /**
  * Token utilities re-exported from token module

package/src/providers/PersSDKProvider.tsx

@@ -228,22 +228,13 @@ export const PersSDKProvider: React.FC<{
     if (!sdk) return;
 
     const unsubscribe = sdk.events.subscribe((event) => {
-      if (event.domain !== 'authentication') return;
-
-      // Session restored successfully - sync React state
-      if (event.type === 'session_restored') {
-        console.log('[PersSDK] Session restoration event received, syncing state...');
-        // Read user from event details if available, otherwise fetch
-        const userId = event.details?.userId;
-        if (userId) {
-          // User ID available, fetch user data
-          sdk.users.getCurrentUser()
-            .then(userData => {
-              setAuthenticationState(userData, true);
-            })
-            .catch(error => {
-              console.error('[PersSDK] Failed to sync restored session:', error);
-            });
+      // Handle both session restoration and fresh login
+      if (event.type === 'session_restored' || event.type === 'login_success') {
+        const details = event.details as { user?: UserDTO | AdminDTO };
+        
+        if (details?.user) {
+          console.log(`[PersSDK] ${event.type}: syncing user state`);
+          setAuthenticationState(details.user, true);
         }
       }
 
@@ -252,7 +243,7 @@ export const PersSDKProvider: React.FC<{
         console.log('[PersSDK] Authentication failed - clearing session');
         setAuthenticationState(null, false);
       }
-    }, { domains: ['authentication'] });
+    }, { domains: ['authentication'], replay: true });
 
     return () => {
       unsubscribe();

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 {