@explorins/pers-sdk-react-native 2.1.1 → 2.1.3

package/dist/providers/PersSDKProvider.d.ts

@@ -1,21 +1,9 @@
 import React, { ReactNode } from 'react';
 import { PersSDK, PersConfig, DefaultAuthProvider } from '@explorins/pers-sdk/core';
 import { UserDTO, AdminDTO } from '@explorins/pers-shared';
-import type { AuthManager, UserManager, TokenManager, BusinessManager, CampaignManager, RedemptionManager, TransactionManager, PurchaseManager, TenantManager, AnalyticsManager, DonationManager } from '@explorins/pers-sdk/core';
 export type { PersConfig } from '@explorins/pers-sdk/core';
 export interface PersSDKContext {
     sdk: PersSDK | null;
-    auth: AuthManager | null;
-    users: UserManager | null;
-    tokens: TokenManager | null;
-    businesses: BusinessManager | null;
-    campaigns: CampaignManager | null;
-    redemptions: RedemptionManager | null;
-    transactions: TransactionManager | null;
-    purchases: PurchaseManager | null;
-    tenants: TenantManager | null;
-    analytics: AnalyticsManager | null;
-    donations: DonationManager | null;
     authProvider: DefaultAuthProvider | null;
     isInitialized: boolean;
     isAuthenticated: boolean;
@@ -23,6 +11,7 @@ export interface PersSDKContext {
     initialize: (config: PersConfig) => Promise<void>;
     setAuthenticationState: (user: UserDTO | AdminDTO | null, isAuthenticated: boolean) => void;
     refreshUserData: () => Promise<void>;
+    restoreSession: () => Promise<UserDTO | null>;
 }
 export declare const PersSDKProvider: React.FC<{
     children: ReactNode;

package/dist/providers/PersSDKProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PersSDKProvider.d.ts","sourceRoot":"","sources":["../../src/providers/PersSDKProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAuC,SAAS,EAA2C,MAAM,OAAO,CAAC;AAEvH,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAIpF,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAG3D,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,YAAY,EACZ,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,MAAM,WAAW,cAAc;IAE7B,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IAGpB,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,eAAe,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;IAClC,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACtC,YAAY,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACxC,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;IAClC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;IAGlC,YAAY,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAGzC,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,CAAC;IAGhC,UAAU,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,sBAAsB,EAAE,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,EAAE,eAAe,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5F,eAAe,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAMD,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC;IACrC,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB,CAiPA,CAAC;AAGF,eAAO,MAAM,UAAU,QAAO,cAQ7B,CAAC"}
+{"version":3,"file":"PersSDKProvider.d.ts","sourceRoot":"","sources":["../../src/providers/PersSDKProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAuC,SAAS,EAA2C,MAAM,OAAO,CAAC;AAEvH,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAIpF,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAkB3D,YAAY,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,MAAM,WAAW,cAAc;IAE7B,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IAGpB,YAAY,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAGzC,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,CAAC;IAGhC,UAAU,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,sBAAsB,EAAE,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,EAAE,eAAe,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5F,eAAe,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,cAAc,EAAE,MAAM,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;CAC/C;AAMD,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC;IACrC,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB,CAwOA,CAAC;AAGF,eAAO,MAAM,UAAU,QAAO,cAQ7B,CAAC"}

package/dist/providers/PersSDKProvider.js

@@ -10,11 +10,19 @@ const SDKContext = createContext(null);
 // Provider component
 export const PersSDKProvider = ({ children, config }) => {
     const initializingRef = useRef(false);
+    // State refs for stable functions to read current values
+    const sdkRef = useRef(null);
+    const isInitializedRef = useRef(false);
+    const isAuthenticatedRef = useRef(false);
     const [sdk, setSdk] = useState(null);
     const [authProvider, setAuthProvider] = useState(null);
     const [isInitialized, setIsInitialized] = useState(false);
     const [isAuthenticated, setIsAuthenticated] = useState(false);
     const [user, setUser] = useState(null);
+    // Keep state refs in sync immediately (not in useEffect to avoid race conditions)
+    sdkRef.current = sdk;
+    isInitializedRef.current = isInitialized;
+    isAuthenticatedRef.current = isAuthenticated;
     const initialize = useCallback(async (config) => {
         // Prevent multiple initializations
         if (isInitialized || initializingRef.current) {
@@ -75,89 +83,81 @@ export const PersSDKProvider = ({ children, config }) => {
     // Auto-initialize if config is provided
     useEffect(() => {
         if (config && !isInitialized && !initializingRef.current) {
-            initialize(config).then(async () => {
-                // Validate stored tokens on startup
-                // SDK's initialize() already calls ensureValidToken() which handles expired tokens
-                // This provides an additional safety layer for missing/corrupted tokens
-                if (authProvider && sdk) {
-                    try {
-                        const hasToken = await sdk.auth.hasValidAuth();
-                        if (!hasToken) {
-                            console.log('[PersSDK] No tokens found on startup, ensuring clean state');
-                            await authProvider.clearTokens();
-                            setAuthenticationState(null, false);
-                        }
-                        // Note: Token expiration validation happens automatically in SDK's initialize()
-                        // which calls ensureValidToken() → checks expiration → triggers AUTH_FAILED if needed
-                    }
-                    catch (error) {
-                        console.warn('[PersSDK] Token validation on startup failed:', error);
-                    }
-                }
-            }).catch(err => {
+            initialize(config).catch(err => {
                 console.error('Auto-initialization failed:', err);
             });
         }
-    }, [config, isInitialized, initialize, authProvider, sdk, setAuthenticationState]);
+    }, [config, isInitialized, initialize]);
     const refreshUserData = useCallback(async () => {
-        if (!sdk || !isAuthenticated || !isInitialized) {
-            throw new Error('SDK not initialized or not authenticated. Cannot refresh user data.');
+        // Read from refs to get current values
+        const currentSdk = sdkRef.current;
+        const currentIsInitialized = isInitializedRef.current;
+        if (!currentSdk || !currentIsInitialized) {
+            throw new Error('SDK not initialized. Cannot refresh user data.');
         }
         try {
-            const freshUserData = await sdk.users.getCurrentUser();
+            const freshUserData = await currentSdk.users.getCurrentUser();
             setUser(freshUserData);
         }
         catch (error) {
             console.error('Failed to refresh user data:', error);
             throw error;
         }
-    }, [sdk, isAuthenticated, isInitialized]);
-    // Listen for authentication status changes and refresh user data when tokens are renewed
+    }, []); // No dependencies - reads from refs
+    const restoreSession = useCallback(async () => {
+        // Read from refs to get current values
+        const currentSdk = sdkRef.current;
+        const currentIsInitialized = isInitializedRef.current;
+        if (!currentSdk || !currentIsInitialized) {
+            throw new Error('SDK not initialized. Call initialize() first.');
+        }
+        try {
+            const userData = await currentSdk.restoreSession();
+            if (userData) {
+                setAuthenticationState(userData, true);
+            }
+            return userData;
+        }
+        catch (error) {
+            console.error('[PersSDK] Failed to restore session:', error);
+            throw error;
+        }
+    }, [setAuthenticationState]); // Depends on setAuthenticationState
+    // Listen for authentication events from core SDK
+    // Set up immediately when SDK is created (don't wait for isInitialized)
+    // to catch session_restored events that fire during SDK initialization
     useEffect(() => {
-        if (!authProvider || !isInitialized)
+        if (!sdk)
             return;
-        // Access the config object with proper type safety
-        const providerConfig = authProvider.config;
-        if (!providerConfig)
-            return;
-        // Set up auth status change handler
-        const originalHandler = providerConfig.onAuthStatusChange;
-        const authStatusHandler = async (status) => {
-            console.log('[PersSDK] Auth status changed:', status);
-            // Call original handler first if it exists
-            if (originalHandler) {
-                await originalHandler(status);
-            }
-            // If token was refreshed successfully and user is authenticated, reload user data
-            if (status === 'authenticated' && isAuthenticated && sdk) {
-                try {
-                    console.log('[PersSDK] Token refreshed, reloading user data...');
-                    await refreshUserData();
-                }
-                catch (error) {
-                    console.error('[PersSDK] Failed to refresh user data after token renewal:', error);
+        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);
+                    });
                 }
             }
-            // If authentication failed, clear state
-            // Frontend app can observe isAuthenticated state change to show custom UI
-            if (status === 'auth_failed') {
-                console.log('[PersSDK] Authentication failed - session expired');
-                // Note: Token clearing already handled by SDK's handleAuthFailure()
-                // which calls authProvider.clearTokens() with robust retry logic
-                // Clear React state to sync with SDK
-                // This triggers re-render, allowing app to show login screen
+            // Session restoration failed or auth error - clear React state
+            if (event.type === 'session_restoration_failed' || event.code === 'AUTH_FAILED') {
+                console.log('[PersSDK] Authentication failed - clearing session');
                 setAuthenticationState(null, false);
             }
-        };
-        // Inject our handler into the auth provider config
-        providerConfig.onAuthStatusChange = authStatusHandler;
-        // Cleanup
+        }, { domains: ['authentication'] });
         return () => {
-            if (originalHandler) {
-                providerConfig.onAuthStatusChange = originalHandler;
-            }
+            unsubscribe();
         };
-    }, [authProvider, isInitialized, isAuthenticated, sdk, refreshUserData, setAuthenticationState]);
+    }, [sdk, setAuthenticationState]);
     // iOS/Android: Monitor app state and validate tokens when app becomes active
     useEffect(() => {
         if (!sdk || Platform.OS === 'web') {
@@ -184,28 +184,17 @@ export const PersSDKProvider = ({ children, config }) => {
     const contextValue = useMemo(() => ({
         // Main SDK instance
         sdk,
-        // Manager shortcuts for convenience
-        auth: sdk?.auth || null,
-        users: sdk?.users || null,
-        tokens: sdk?.tokens || null,
-        businesses: sdk?.businesses || null,
-        campaigns: sdk?.campaigns || null,
-        redemptions: sdk?.redemptions || null,
-        transactions: sdk?.transactions || null,
-        purchases: sdk?.purchases || null,
-        tenants: sdk?.tenants || null,
-        analytics: sdk?.analytics || null,
-        donations: sdk?.donations || null,
         // Platform-specific providers
         authProvider,
         // State
         isInitialized,
         isAuthenticated,
         user,
-        // Methods
+        // Methods - expose functions directly, not through refs
         initialize,
         setAuthenticationState,
         refreshUserData,
+        restoreSession,
     }), [
         sdk,
         authProvider,
@@ -214,7 +203,8 @@ export const PersSDKProvider = ({ children, config }) => {
         user,
         initialize,
         setAuthenticationState,
-        refreshUserData
+        refreshUserData,
+        restoreSession
     ]);
     return (_jsx(SDKContext.Provider, { value: contextValue, children: children }));
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@explorins/pers-sdk-react-native",
-  "version": "2.1.1",
+  "version": "2.1.3",
   "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.1",
+    "@explorins/pers-sdk": "^2.1.3",
     "@explorins/pers-signer": "^1.0.33",
     "buffer": "^6.0.3",
     "ethers": "^6.15.0",

package/src/hooks/useTokenBalances.ts

@@ -151,7 +151,7 @@ export function useTokenBalances(options: UseTokenBalancesOptions): UseTokenBala
     refreshInterval = 0
   } = options;
 
-  const { isAuthenticated } = usePersSDK();
+  const { isAuthenticated, sdk } = usePersSDK();
   const web3 = useWeb3();
   
   const [tokenBalances, setTokenBalances] = useState<TokenBalanceWithToken[]>([]);
@@ -268,16 +268,30 @@ export function useTokenBalances(options: UseTokenBalancesOptions): UseTokenBala
     }
   }, [autoLoad, isAvailable, availableTokens.length, loadBalances]);
 
-  // Optional auto-refresh interval
+  // Event-driven refresh: listen for transaction events instead of polling
   useEffect(() => {
-    if (refreshInterval > 0 && isAvailable && availableTokens.length > 0) {
-      const intervalId = setInterval(() => {
+    if (!sdk || refreshInterval <= 0 || !isAvailable) return;
+
+    // Subscribe to transaction domain events
+    const unsubscribe = sdk.events.subscribe((event) => {
+      if (event.domain === 'transaction' && event.type === 'transaction_completed') {
+        console.log('[useTokenBalances] Transaction completed, refreshing balances...');
         loadBalances();
-      }, refreshInterval);
-      
-      return () => clearInterval(intervalId);
-    }
-  }, [refreshInterval, isAvailable, availableTokens.length, loadBalances]);
+      }
+    }, { domains: ['transaction'] });
+
+    // Also set up a fallback polling interval (much longer than before)
+    // This handles cases where events might be missed
+    const fallbackInterval = Math.max(refreshInterval, 60000); // Minimum 1 minute
+    const intervalId = setInterval(() => {
+      loadBalances();
+    }, fallbackInterval);
+
+    return () => {
+      unsubscribe();
+      clearInterval(intervalId);
+    };
+  }, [sdk, refreshInterval, isAvailable, loadBalances]);
 
   return {
     tokenBalances,

package/src/index.ts

@@ -266,7 +266,7 @@ export {
 } from './hooks';
 
 // Re-export signing status types for convenience
-export type { OnStatusUpdateFn, StatusUpdateData, SigningStatusType } from './hooks';
+export type { OnStatusUpdateFn, StatusUpdateData, SigningStatusType, TransactionSigningResult, SubmissionResult, AuthenticatedUser } from './hooks';
 
 // Re-export event types for convenience
 export type { EventsHook, PersEvent, EventHandler, EventFilter, Unsubscribe } from './hooks';

package/src/providers/PersSDKProvider.tsx

@@ -28,19 +28,6 @@ export interface PersSDKContext {
   // Main SDK instance
   sdk: PersSDK | null;
   
-  // Manager shortcuts for convenience
-  auth: AuthManager | null;
-  users: UserManager | null;
-  tokens: TokenManager | null;
-  businesses: BusinessManager | null;
-  campaigns: CampaignManager | null;
-  redemptions: RedemptionManager | null;
-  transactions: TransactionManager | null;
-  purchases: PurchaseManager | null;
-  tenants: TenantManager | null;
-  analytics: AnalyticsManager | null;
-  donations: DonationManager | null;
-  
   // Platform-specific providers
   authProvider: DefaultAuthProvider | null;
   
@@ -53,6 +40,7 @@ export interface PersSDKContext {
   initialize: (config: PersConfig) => Promise<void>;
   setAuthenticationState: (user: UserDTO | AdminDTO | null, isAuthenticated: boolean) => void;
   refreshUserData: () => Promise<void>;
+  restoreSession: () => Promise<UserDTO | null>;
 }
 
 // Create the context
@@ -64,6 +52,12 @@ export const PersSDKProvider: React.FC<{
   config?: PersConfig;
 }> = ({ children, config }) => {
   const initializingRef = useRef(false);
+  
+  // State refs for stable functions to read current values
+  const sdkRef = useRef<PersSDK | null>(null);
+  const isInitializedRef = useRef(false);
+  const isAuthenticatedRef = useRef(false);
+  
   const [sdk, setSdk] = useState<PersSDK | null>(null);
   const [authProvider, setAuthProvider] = useState<DefaultAuthProvider | null>(null);
   
@@ -71,6 +65,11 @@ export const PersSDKProvider: React.FC<{
   const [isAuthenticated, setIsAuthenticated] = useState(false);
   const [user, setUser] = useState<UserDTO | AdminDTO | null>(null);
 
+  // Keep state refs in sync immediately (not in useEffect to avoid race conditions)
+  sdkRef.current = sdk;
+  isInitializedRef.current = isInitialized;
+  isAuthenticatedRef.current = isAuthenticated;
+
   const initialize = useCallback(async (config: PersConfig) => {
     // Prevent multiple initializations
     if (isInitialized || initializingRef.current) {
@@ -140,97 +139,88 @@ export const PersSDKProvider: React.FC<{
   // Auto-initialize if config is provided
   useEffect(() => {
     if (config && !isInitialized && !initializingRef.current) {
-      initialize(config).then(async () => {
-        // Validate stored tokens on startup
-        // SDK's initialize() already calls ensureValidToken() which handles expired tokens
-        // This provides an additional safety layer for missing/corrupted tokens
-        if (authProvider && sdk) {
-          try {
-            const hasToken = await sdk.auth.hasValidAuth();
-            if (!hasToken) {
-              console.log('[PersSDK] No tokens found on startup, ensuring clean state');
-              await authProvider.clearTokens();
-              setAuthenticationState(null, false);
-            }
-            // Note: Token expiration validation happens automatically in SDK's initialize()
-            // which calls ensureValidToken() → checks expiration → triggers AUTH_FAILED if needed
-          } catch (error) {
-            console.warn('[PersSDK] Token validation on startup failed:', error);
-          }
-        }
-      }).catch(err => {
+      initialize(config).catch(err => {
         console.error('Auto-initialization failed:', err);
       });
     }
-  }, [config, isInitialized, initialize, authProvider, sdk, setAuthenticationState]);
+  }, [config, isInitialized, initialize]);
 
   const refreshUserData = useCallback(async (): Promise<void> => {
-    if (!sdk || !isAuthenticated || !isInitialized) {
-      throw new Error('SDK not initialized or not authenticated. Cannot refresh user data.');
+    // Read from refs to get current values
+    const currentSdk = sdkRef.current;
+    const currentIsInitialized = isInitializedRef.current;
+
+    if (!currentSdk || !currentIsInitialized) {
+      throw new Error('SDK not initialized. Cannot refresh user data.');
     }
     
     try {
-      const freshUserData = await sdk.users.getCurrentUser();
+      const freshUserData = await currentSdk.users.getCurrentUser();
       setUser(freshUserData);
     } catch (error) {
       console.error('Failed to refresh user data:', error);
       throw error;
     }
-  }, [sdk, isAuthenticated, isInitialized]);
-
-  // Listen for authentication status changes and refresh user data when tokens are renewed
-  useEffect(() => {
-    if (!authProvider || !isInitialized) return;
+  }, []); // No dependencies - reads from refs
 
-    // Access the config object with proper type safety
-    const providerConfig = (authProvider as any).config;
-    if (!providerConfig) return;
+  const restoreSession = useCallback(async (): Promise<UserDTO | null> => {
+    // Read from refs to get current values
+    const currentSdk = sdkRef.current;
+    const currentIsInitialized = isInitializedRef.current;
 
-    // Set up auth status change handler
-    const originalHandler = providerConfig.onAuthStatusChange;
+    if (!currentSdk || !currentIsInitialized) {
+      throw new Error('SDK not initialized. Call initialize() first.');
+    }
     
-    const authStatusHandler = async (status: string) => {
-      console.log('[PersSDK] Auth status changed:', status);
-      
-      // Call original handler first if it exists
-      if (originalHandler) {
-        await originalHandler(status);
+    try {
+      const userData = await currentSdk.restoreSession();
+      if (userData) {
+        setAuthenticationState(userData, true);
       }
-      
-      // If token was refreshed successfully and user is authenticated, reload user data
-      if (status === 'authenticated' && isAuthenticated && sdk) {
-        try {
-          console.log('[PersSDK] Token refreshed, reloading user data...');
-          await refreshUserData();
-        } catch (error) {
-          console.error('[PersSDK] Failed to refresh user data after token renewal:', error);
+      return userData;
+    } catch (error) {
+      console.error('[PersSDK] Failed to restore session:', error);
+      throw error;
+    }
+  }, [setAuthenticationState]); // Depends on setAuthenticationState
+  
+  // Listen for authentication events from core SDK
+  // Set up immediately when SDK is created (don't wait for isInitialized)
+  // to catch session_restored events that fire during SDK initialization
+  useEffect(() => {
+    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);
+            });
         }
       }
-      
-      // If authentication failed, clear state
-      // Frontend app can observe isAuthenticated state change to show custom UI
-      if (status === 'auth_failed') {
-        console.log('[PersSDK] Authentication failed - session expired');
-        
-        // Note: Token clearing already handled by SDK's handleAuthFailure()
-        // which calls authProvider.clearTokens() with robust retry logic
-        
-        // Clear React state to sync with SDK
-        // This triggers re-render, allowing app to show login screen
+
+      // Session restoration failed or auth error - clear React state
+      if (event.type === 'session_restoration_failed' || event.code === 'AUTH_FAILED') {
+        console.log('[PersSDK] Authentication failed - clearing session');
         setAuthenticationState(null, false);
       }
-    };
-    
-    // Inject our handler into the auth provider config
-    providerConfig.onAuthStatusChange = authStatusHandler;
-    
-    // Cleanup
+    }, { domains: ['authentication'] });
+
     return () => {
-      if (originalHandler) {
-        providerConfig.onAuthStatusChange = originalHandler;
-      }
+      unsubscribe();
     };
-  }, [authProvider, isInitialized, isAuthenticated, sdk, refreshUserData, setAuthenticationState]);
+  }, [sdk, setAuthenticationState]);
 
   // iOS/Android: Monitor app state and validate tokens when app becomes active
   useEffect(() => {
@@ -262,19 +252,6 @@ export const PersSDKProvider: React.FC<{
     // Main SDK instance
     sdk,
     
-    // Manager shortcuts for convenience
-    auth: sdk?.auth || null,
-    users: sdk?.users || null,
-    tokens: sdk?.tokens || null,
-    businesses: sdk?.businesses || null,
-    campaigns: sdk?.campaigns || null,
-    redemptions: sdk?.redemptions || null,
-    transactions: sdk?.transactions || null,
-    purchases: sdk?.purchases || null,
-    tenants: sdk?.tenants || null,
-    analytics: sdk?.analytics || null,
-    donations: sdk?.donations || null,
-    
     // Platform-specific providers
     authProvider,
     
@@ -283,10 +260,11 @@ export const PersSDKProvider: React.FC<{
     isAuthenticated,
     user,
     
-    // Methods
+    // Methods - expose functions directly, not through refs
     initialize,
     setAuthenticationState,
     refreshUserData,
+    restoreSession,
   }), [
     sdk,
     authProvider,
@@ -295,7 +273,8 @@ export const PersSDKProvider: React.FC<{
     user,
     initialize,
     setAuthenticationState,
-    refreshUserData
+    refreshUserData,
+    restoreSession
   ]);
 
   return (