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

package/dist/index.d.ts

@@ -207,7 +207,7 @@ export { PersSDKProvider, usePersSDK, type PersConfig, type PersSDKContext } fro
  * ```
  */
 export { useAuth, useTokens, useTokenBalances, useTransactions, useTransactionSigner, SigningStatus, useBusiness, useCampaigns, useRedemptions, useWeb3, usePurchases, useTenants, useUsers, useUserStatus, useFiles, useAnalytics, useDonations, useEvents } from './hooks';
-export type { OnStatusUpdateFn, StatusUpdateData, SigningStatusType } from './hooks';
+export type { OnStatusUpdateFn, StatusUpdateData, SigningStatusType, TransactionSigningResult, SubmissionResult, AuthenticatedUser } from './hooks';
 export type { EventsHook, PersEvent, EventHandler, EventFilter, Unsubscribe } from './hooks';
 export type { TokenBalanceWithToken, UseTokenBalancesOptions, UseTokenBalancesResult } from './hooks';
 /**

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAGH,OAAO,aAAa,CAAC;AAMrB;;;;;;;;GAQG;AACH,OAAO,EACL,6BAA6B,EAC7B,KAAK,qBAAqB,EAC3B,MAAM,wCAAwC,CAAC;AAMhD;;;;;;;;;;GAUG;AACH,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAEvE;;;;;;;;GAQG;AACH,OAAO,EACL,wBAAwB,GACzB,MAAM,uCAAuC,CAAC;AAM/C;;;GAGG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAMvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,EACL,eAAe,EACf,UAAU,EACV,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,6BAA6B,CAAC;AAMrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0FG;AACH,OAAO,EACL,OAAO,EACP,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,YAAY,EACZ,cAAc,EACd,OAAO,EACP,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,SAAS,EACV,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAGrF,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAG7F,YAAY,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAMtG;;;;;;GAMG;AACH,OAAO,EACL,qBAAqB,EACtB,MAAM,sCAAsC,CAAC;AAM9C;;;;;;;;GAQG;AACH,OAAO,EACL,8BAA8B,EAC/B,MAAM,aAAa,CAAC;AAMrB;;;;;;;;;;;;;;;;GAgBG;AACH,cAAc,wBAAwB,CAAC;AAEvC;;;;GAIG;AACH,OAAO,EAAE,gCAAgC,EAAE,MAAM,2BAA2B,CAAC;AAE7E;;;;;GAKG;AACH,OAAO,EAEL,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;GAWG;AACH,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAMlC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,8BAA8B,EAC9B,2BAA2B,EAC5B,MAAM,iCAAiC,CAAC;AAEzC,YAAY,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAMzG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuFG;AACH,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,UAAU,EACX,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAGH,OAAO,aAAa,CAAC;AAMrB;;;;;;;;GAQG;AACH,OAAO,EACL,6BAA6B,EAC7B,KAAK,qBAAqB,EAC3B,MAAM,wCAAwC,CAAC;AAMhD;;;;;;;;;;GAUG;AACH,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAEvE;;;;;;;;GAQG;AACH,OAAO,EACL,wBAAwB,GACzB,MAAM,uCAAuC,CAAC;AAM/C;;;GAGG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAMvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,EACL,eAAe,EACf,UAAU,EACV,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,6BAA6B,CAAC;AAMrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0FG;AACH,OAAO,EACL,OAAO,EACP,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,YAAY,EACZ,cAAc,EACd,OAAO,EACP,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,SAAS,EACV,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAGpJ,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAG7F,YAAY,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAMtG;;;;;;GAMG;AACH,OAAO,EACL,qBAAqB,EACtB,MAAM,sCAAsC,CAAC;AAM9C;;;;;;;;GAQG;AACH,OAAO,EACL,8BAA8B,EAC/B,MAAM,aAAa,CAAC;AAMrB;;;;;;;;;;;;;;;;GAgBG;AACH,cAAc,wBAAwB,CAAC;AAEvC;;;;GAIG;AACH,OAAO,EAAE,gCAAgC,EAAE,MAAM,2BAA2B,CAAC;AAE7E;;;;;GAKG;AACH,OAAO,EAEL,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;GAWG;AACH,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAMlC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,8BAA8B,EAC9B,2BAA2B,EAC5B,MAAM,iCAAiC,CAAC;AAEzC,YAAY,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAMzG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuFG;AACH,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,UAAU,EACX,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -6828,7 +6828,8 @@ const DEFAULT_PERS_CONFIG = {
     timeout: 30000,
     retries: 3,
     tokenRefreshMargin: 60, // Refresh tokens 60 seconds before expiry
-    backgroundRefreshThreshold: 30 // Use background refresh if >30s remaining
+    backgroundRefreshThreshold: 30, // Use background refresh if >30s remaining
+    autoRestoreSession: true // Automatically restore session on initialization
 };
 /**
  * Internal function to construct API root from environment
@@ -6955,6 +6956,10 @@ var AuthStatus;
     AuthStatus["REFRESHING"] = "refreshing";
     /** No authentication present */
     AuthStatus["UNAUTHENTICATED"] = "unauthenticated";
+    /** Session restoration completed (fired once on SDK initialization) */
+    AuthStatus["SESSION_RESTORED"] = "session_restored";
+    /** Session restoration determined no valid session exists */
+    AuthStatus["SESSION_RESTORATION_FAILED"] = "session_restoration_failed";
 })(AuthStatus || (AuthStatus = {}));
 
 /**
@@ -7618,7 +7623,7 @@ class DefaultAuthProvider {
 /** SDK package name */
 const SDK_NAME = '@explorins/pers-sdk';
 /** SDK version - TODO: Load dynamically from package.json */
-const SDK_VERSION = '2.1.0';
+const SDK_VERSION = '2.1.1';
 /** Full SDK identifier for headers */
 const SDK_USER_AGENT = `${SDK_NAME}/${SDK_VERSION}`;
 
@@ -13361,6 +13366,64 @@ class PersSDK {
         this._apiKeys = new ApiKeyManager(this.apiClient);
         this._analytics = new AnalyticsManager(this.apiClient);
         this._donations = new DonationManager(this.apiClient);
+        // Automatically restore session if enabled and tokens exist
+        if (config.autoRestoreSession !== false) {
+            this.restoreSessionIfTokensExist().catch(err => {
+                console.warn('[PersSDK] Failed to restore session on initialization:', err);
+            });
+        }
+    }
+    /**
+     * Restore user session if valid tokens exist in storage
+     *
+     * This method is called automatically during SDK initialization when
+     * `autoRestoreSession` is enabled (default). It checks for stored tokens
+     * and fetches user data to restore the authentication state.
+     *
+     * Emits auth domain success event when session is restored.
+     *
+     * @internal
+     * @returns Promise that resolves when session is restored or determined to be invalid
+     */
+    async restoreSessionIfTokensExist() {
+        try {
+            const hasToken = await this._auth.hasValidAuth();
+            if (hasToken) {
+                console.log('[PersSDK] Valid tokens found, restoring session...');
+                try {
+                    // Fetch user data to validate tokens and restore session
+                    const userData = await this._auth.getCurrentUser();
+                    console.log('[PersSDK] Session restored successfully');
+                    // Emit event through proper event emitter
+                    // Send minimal data (just userId) - consumers can fetch full user if needed
+                    this._events.emitSuccess({
+                        type: 'session_restored',
+                        domain: 'authentication',
+                        userMessage: 'Session restored successfully',
+                        details: { userId: userData.id }
+                    });
+                }
+                catch (error) {
+                    // Tokens exist but are invalid (expired, revoked, etc.)
+                    console.warn('[PersSDK] Failed to restore session, tokens may be invalid:', error);
+                    await this._auth.clearAuth();
+                    // Emit restoration failed event
+                    this._events.emitError({
+                        type: 'session_restoration_failed',
+                        domain: 'authentication',
+                        userMessage: 'Session restoration failed',
+                        code: 'SESSION_INVALID',
+                        details: { error }
+                    });
+                }
+            }
+            else {
+                console.log('[PersSDK] No valid tokens found');
+            }
+        }
+        catch (error) {
+            console.warn('[PersSDK] Error during session restoration:', error);
+        }
     }
     /**
      * Event emitter - Subscribe to SDK-wide events
@@ -14583,30 +14646,11 @@ const PersSDKProvider = ({ children, config }) => {
     // Auto-initialize if config is provided
     react.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 = react.useCallback(async () => {
         if (!sdk || !isAuthenticated || !isInitialized) {
             throw new Error('SDK not initialized or not authenticated. Cannot refresh user data.');
@@ -14620,52 +14664,36 @@ const PersSDKProvider = ({ children, config }) => {
             throw error;
         }
     }, [sdk, isAuthenticated, isInitialized]);
-    // Listen for authentication status changes and refresh user data when tokens are renewed
+    // 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
     react.useEffect(() => {
-        if (!authProvider || !isInitialized)
-            return;
-        // Access the config object with proper type safety
-        const providerConfig = authProvider.config;
-        if (!providerConfig)
+        if (!sdk)
             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...');
+                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
     react.useEffect(() => {
         if (!sdk || reactNative.Platform.OS === 'web') {