@explorins/pers-sdk-react-native 1.5.18 → 1.5.21

package/dist/providers/PersSDKProvider.d.ts

@@ -1,6 +1,5 @@
 import React, { ReactNode } from 'react';
-import { PersSDK, PersConfig } from '@explorins/pers-sdk/core';
-import { ReactNativeAuthProvider } from './react-native-auth-provider';
+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';
@@ -18,7 +17,7 @@ export interface PersSDKContext {
     analytics: AnalyticsManager | null;
     donations: DonationManager | null;
     business: BusinessManager | null;
-    authProvider: ReactNativeSDKAuthProvider | null;
+    authProvider: DefaultAuthProvider | null;
     isInitialized: boolean;
     isAuthenticated: boolean;
     user: UserDTO | AdminDTO | null;
@@ -27,11 +26,6 @@ export interface PersSDKContext {
     setAuthenticationState: (user: UserDTO | AdminDTO | null, accountAddress: string | null, isAuthenticated: boolean) => void;
     refreshUserData: () => Promise<void>;
 }
-declare class ReactNativeSDKAuthProvider extends ReactNativeAuthProvider {
-    constructor(projectKey: string);
-    setToken(token: string | null): Promise<void>;
-    getToken(): Promise<string | 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,EAAuB,MAAM,OAAO,CAAC;AACnG,OAAO,EAAE,OAAO,EAAE,UAAU,EAAsB,MAAM,0BAA0B,CAAC;AAEnF,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,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,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IAGjC,YAAY,EAAE,0BAA0B,GAAG,IAAI,CAAC;IAGhD,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAG9B,UAAU,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,sBAAsB,EAAE,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,EAAE,eAAe,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3H,eAAe,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAMD,cAAM,0BAA2B,SAAQ,uBAAuB;gBAClD,UAAU,EAAE,MAAM;IAKxB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7C,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAGzC;AAGD,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC;IACrC,QAAQ,EAAE,SAAS,CAAC;CACrB,CAgHA,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,EAAuB,MAAM,OAAO,CAAC;AACnG,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAGpF,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,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IAGjC,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;IAChC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAG9B,UAAU,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,sBAAsB,EAAE,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,EAAE,eAAe,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3H,eAAe,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAMD,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC;IACrC,QAAQ,EAAE,SAAS,CAAC;CACrB,CAkHA,CAAC;AAGF,eAAO,MAAM,UAAU,QAAO,cAQ7B,CAAC"}

package/dist/providers/PersSDKProvider.js

@@ -2,28 +2,9 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { createContext, useContext, useState, useCallback, useRef } from 'react';
 import { PersSDK } from '@explorins/pers-sdk/core';
 import { ReactNativeHttpClient } from './react-native-http-client';
-import { ReactNativeAuthProvider } from './react-native-auth-provider';
+import { createReactNativeAuthProvider } from './react-native-auth-provider';
 // Create the context
 const SDKContext = createContext(null);
-// Simple wrapper for SDK integration
-class ReactNativeSDKAuthProvider extends ReactNativeAuthProvider {
-    constructor(projectKey) {
-        super(projectKey, { debug: true });
-    }
-    // Override setAccessToken to provide backward compatibility
-    async setToken(token) {
-        if (token) {
-            await this.setAccessToken(token);
-        }
-        else {
-            await this.clearTokens();
-        }
-    }
-    // Override getToken for backward compatibility
-    async getToken() {
-        return await super.getToken();
-    }
-}
 // Provider component
 export const PersSDKProvider = ({ children }) => {
     const initializingRef = useRef(false);
@@ -36,27 +17,33 @@ export const PersSDKProvider = ({ children }) => {
     const initialize = useCallback(async (config) => {
         // Prevent multiple initializations
         if (isInitialized || initializingRef.current) {
-            console.log('SDK already initialized or initializing, skipping...');
             return;
         }
         initializingRef.current = true;
         try {
-            console.log('Initializing PERS SDK with config:', config);
-            // Create React Native auth provider
-            const auth = new ReactNativeSDKAuthProvider(config.apiProjectKey || 'default-project');
-            setAuthProvider(auth);
             // Create HTTP client
             const httpClient = new ReactNativeHttpClient();
-            // Create config with auth provider - use the ReactNative auth provider directly
+            // Create platform-aware auth provider if not provided
+            let authProvider;
+            if (config.authProvider) {
+                authProvider = config.authProvider;
+            }
+            else {
+                // Use our platform-aware auth provider that automatically selects LocalStorage (web) or AsyncStorage (mobile)
+                authProvider = createReactNativeAuthProvider(config.apiProjectKey || 'default-project', {
+                    debug: false
+                });
+            }
+            // Enhanced config with platform-appropriate auth provider
             const sdkConfig = {
                 ...config,
-                authProvider: auth
+                authProvider
             };
-            // Initialize PersSDK with manager pattern
+            // Initialize PersSDK with platform-aware auth provider
             const sdkInstance = new PersSDK(httpClient, sdkConfig);
+            setAuthProvider(authProvider);
             setSdk(sdkInstance);
             setIsInitialized(true);
-            console.log('PERS SDK initialized successfully');
         }
         catch (error) {
             console.error('Failed to initialize PERS SDK:', error);
@@ -77,10 +64,8 @@ export const PersSDKProvider = ({ children }) => {
             throw new Error('SDK not initialized or not authenticated. Cannot refresh user data.');
         }
         try {
-            console.log('Refreshing user data from remote server...');
             const freshUserData = await sdk.users.getCurrentUser();
             setUser(freshUserData);
-            console.log('User data refreshed successfully:', freshUserData);
         }
         catch (error) {
             console.error('Failed to refresh user data:', error);

package/dist/providers/react-native-auth-provider.d.ts

@@ -1,47 +1,35 @@
-import type { PersAuthProvider } from '@explorins/pers-sdk/core';
 /**
- * Configuration options for React Native Auth Provider
+ * React Native Unified Auth Provider
+ *
+ * Creates a platform-specific auth provider that automatically selects the appropriate storage:
+ * - Web: Uses LocalStorageTokenStorage from core SDK
+ * - Mobile: Uses AsyncStorage-based storage
+ */
+import { DefaultAuthProvider, AuthType } from '@explorins/pers-sdk/core';
+import type { TokenStorage } from '@explorins/pers-sdk/core';
+/**
+ * Configuration for React Native Auth Provider
  */
 export interface ReactNativeAuthConfig {
-    /** Use secure storage (Keychain) for tokens when available */
-    useSecureStorage?: boolean;
-    /** Custom key prefix for storage */
+    /** Custom storage key prefix */
     keyPrefix?: string;
     /** Enable debug logging */
     debug?: boolean;
+    /** Custom token storage implementation */
+    customStorage?: TokenStorage;
+    /** Authentication type (default: 'user') */
+    authType?: AuthType;
 }
 /**
- * React Native Authentication Provider
+ * Create a React Native auth provider with platform-appropriate storage
  *
- * Simple, unified implementation for React Native apps with:
- * - AsyncStorage for basic token storage
- * - Keychain integration for secure storage (when available)
- * - Automatic fallback to AsyncStorage if Keychain is unavailable
- * - Cross-platform compatibility (iOS/Android/Expo)
+ * Automatically selects storage implementation:
+ * - Web: Uses LocalStorageTokenStorage (from core SDK)
+ * - Mobile: Uses AsyncStorageTokenStorage (React Native specific)
+ *
+ * @param projectKey - PERS project key
+ * @param config - Configuration options
+ * @returns DefaultAuthProvider configured for the current platform
  */
-export declare class ReactNativeAuthProvider implements PersAuthProvider {
-    readonly authType: 'user';
-    private readonly config;
-    private readonly ACCESS_TOKEN_KEY;
-    private readonly REFRESH_TOKEN_KEY;
-    private readonly projectKey;
-    private memoryStorage;
-    constructor(projectKey: string, config?: ReactNativeAuthConfig);
-    getProjectKey(): Promise<string | null>;
-    getToken(): Promise<string | null>;
-    setAccessToken(token: string): Promise<void>;
-    setRefreshToken(token: string): Promise<void>;
-    getRefreshToken(): Promise<string | null>;
-    clearTokens(): Promise<void>;
-    onTokenExpired(): Promise<void>;
-    hasValidToken(): boolean;
-    hasRefreshToken(): boolean;
-    private storeValue;
-    private getStoredValue;
-    private removeStoredValue;
-    private isKeychainAvailable;
-    private storeInKeychain;
-    private getFromKeychain;
-    private removeFromKeychain;
-}
+export declare function createReactNativeAuthProvider(projectKey: string, config?: ReactNativeAuthConfig): DefaultAuthProvider;
 //# sourceMappingURL=react-native-auth-provider.d.ts.map

package/dist/providers/react-native-auth-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react-native-auth-provider.d.ts","sourceRoot":"","sources":["../../src/providers/react-native-auth-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAGjE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,qBAAa,uBAAwB,YAAW,gBAAgB;IAC9D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAU;IAEnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IACzD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAGpC,OAAO,CAAC,aAAa,CAAkC;gBAGrD,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,qBAA0B;IA4B9B,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIvC,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIlC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5C,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7C,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIzC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IASrC,aAAa,IAAI,OAAO;IAIxB,eAAe,IAAI,OAAO;YAKZ,UAAU;YAcV,cAAc;YAcd,iBAAiB;YAgBjB,mBAAmB;YASnB,eAAe;YAKf,eAAe;YAMf,kBAAkB;CAIjC"}
+{"version":3,"file":"react-native-auth-provider.d.ts","sourceRoot":"","sources":["../../src/providers/react-native-auth-provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,mBAAmB,EAAW,QAAQ,EAA4B,MAAM,0BAA0B,CAAC;AAE5G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAK7D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,qBAA0B,GACjC,mBAAmB,CAyBrB"}

package/dist/providers/react-native-auth-provider.js

@@ -1,150 +1,39 @@
-import AsyncStorage from '@react-native-async-storage/async-storage';
 /**
- * React Native Authentication Provider
+ * React Native Unified Auth Provider
  *
- * Simple, unified implementation for React Native apps with:
- * - AsyncStorage for basic token storage
- * - Keychain integration for secure storage (when available)
- * - Automatic fallback to AsyncStorage if Keychain is unavailable
- * - Cross-platform compatibility (iOS/Android/Expo)
+ * Creates a platform-specific auth provider that automatically selects the appropriate storage:
+ * - Web: Uses LocalStorageTokenStorage from core SDK
+ * - Mobile: Uses AsyncStorage-based storage
  */
-export class ReactNativeAuthProvider {
-    constructor(projectKey, config = {}) {
-        this.authType = 'user';
-        // In-memory fallback storage
-        this.memoryStorage = new Map();
-        if (!projectKey || typeof projectKey !== 'string') {
-            throw new Error('ReactNativeAuthProvider: projectKey is required and must be a string');
-        }
-        this.projectKey = projectKey;
-        // Set default configuration
-        this.config = {
-            useSecureStorage: true, // Default to secure storage when available
-            keyPrefix: `pers_${projectKey.slice(0, 8)}`,
-            debug: false,
-            ...config
-        };
-        // Create storage keys
-        this.ACCESS_TOKEN_KEY = `${this.config.keyPrefix}_access_token`;
-        this.REFRESH_TOKEN_KEY = `${this.config.keyPrefix}_refresh_token`;
-        if (this.config.debug) {
-            console.log('ReactNativeAuthProvider initialized:', {
-                projectKey: projectKey.slice(0, 8) + '...',
-                useSecureStorage: this.config.useSecureStorage
-            });
-        }
-    }
-    async getProjectKey() {
-        return this.projectKey;
-    }
-    async getToken() {
-        return this.getStoredValue(this.ACCESS_TOKEN_KEY);
-    }
-    async setAccessToken(token) {
-        await this.storeValue(this.ACCESS_TOKEN_KEY, token);
-        if (this.config.debug) {
-            console.log('Access token stored securely');
-        }
-    }
-    async setRefreshToken(token) {
-        await this.storeValue(this.REFRESH_TOKEN_KEY, token);
-        if (this.config.debug) {
-            console.log('Refresh token stored securely');
-        }
-    }
-    async getRefreshToken() {
-        return this.getStoredValue(this.REFRESH_TOKEN_KEY);
-    }
-    async clearTokens() {
-        await Promise.all([
-            this.removeStoredValue(this.ACCESS_TOKEN_KEY),
-            this.removeStoredValue(this.REFRESH_TOKEN_KEY)
-        ]);
-        if (this.config.debug) {
-            console.log('All tokens cleared from storage');
-        }
-    }
-    async onTokenExpired() {
-        if (this.config.debug) {
-            console.warn('ReactNativeAuthProvider: Token expired - implement refresh logic in your app');
-        }
-        // Clear expired tokens
-        await this.clearTokens();
-    }
-    // Token validation methods
-    hasValidToken() {
-        return true; // Actual validation happens in getToken()
-    }
-    hasRefreshToken() {
-        return true; // Actual validation happens in getRefreshToken()
-    }
-    // Storage implementation methods
-    async storeValue(key, value) {
-        try {
-            if (this.config.useSecureStorage && await this.isKeychainAvailable()) {
-                await this.storeInKeychain(key, value);
-            }
-            else {
-                await AsyncStorage.setItem(key, value);
-            }
-        }
-        catch (error) {
-            console.error(`Failed to store value for key ${key}:`, error);
-            // Fallback to memory storage
-            this.memoryStorage.set(key, value);
-        }
-    }
-    async getStoredValue(key) {
-        try {
-            if (this.config.useSecureStorage && await this.isKeychainAvailable()) {
-                return await this.getFromKeychain(key);
-            }
-            else {
-                return await AsyncStorage.getItem(key);
-            }
-        }
-        catch (error) {
-            console.warn(`Failed to get value for key ${key}:`, error);
-            // Fallback to memory storage
-            return this.memoryStorage.get(key) || null;
-        }
-    }
-    async removeStoredValue(key) {
-        try {
-            if (this.config.useSecureStorage && await this.isKeychainAvailable()) {
-                await this.removeFromKeychain(key);
-            }
-            else {
-                await AsyncStorage.removeItem(key);
-            }
-        }
-        catch (error) {
-            console.error(`Failed to remove value for key ${key}:`, error);
-        }
-        // Ensure memory fallback is also cleared
-        this.memoryStorage.delete(key);
-    }
-    // Keychain helper methods
-    async isKeychainAvailable() {
-        try {
-            const Keychain = require('react-native-keychain');
-            return !!Keychain && typeof Keychain.setInternetCredentials === 'function';
-        }
-        catch {
-            return false;
-        }
-    }
-    async storeInKeychain(key, value) {
-        const Keychain = require('react-native-keychain');
-        await Keychain.setInternetCredentials(key, 'pers-token', value);
-    }
-    async getFromKeychain(key) {
-        const Keychain = require('react-native-keychain');
-        const credentials = await Keychain.getInternetCredentials(key);
-        return credentials ? credentials.password : null;
-    }
-    async removeFromKeychain(key) {
-        const Keychain = require('react-native-keychain');
-        await Keychain.resetInternetCredentials(key);
-    }
+import { Platform } from 'react-native';
+import { DefaultAuthProvider, LocalStorageTokenStorage } from '@explorins/pers-sdk/core';
+import { AsyncStorageTokenStorage } from '../storage/async-storage-token-storage';
+// Use React Native's built-in platform detection
+const isWebPlatform = Platform.OS === 'web';
+/**
+ * Create a React Native auth provider with platform-appropriate storage
+ *
+ * Automatically selects storage implementation:
+ * - Web: Uses LocalStorageTokenStorage (from core SDK)
+ * - Mobile: Uses AsyncStorageTokenStorage (React Native specific)
+ *
+ * @param projectKey - PERS project key
+ * @param config - Configuration options
+ * @returns DefaultAuthProvider configured for the current platform
+ */
+export function createReactNativeAuthProvider(projectKey, config = {}) {
+    if (!projectKey || typeof projectKey !== 'string') {
+        throw new Error('createReactNativeAuthProvider: projectKey is required and must be a string');
+    }
+    const { keyPrefix = `pers_${projectKey.slice(0, 8)}_`, debug = false, customStorage, authType = 'user' } = config;
+    // Platform-specific storage selection
+    const tokenStorage = customStorage || (isWebPlatform
+        ? new LocalStorageTokenStorage()
+        : new AsyncStorageTokenStorage(keyPrefix));
+    // Return DefaultAuthProvider configured with platform-appropriate storage
+    return new DefaultAuthProvider({
+        authType,
+        projectKey,
+        storage: tokenStorage
+    });
 }

package/dist/providers/react-native-http-client.d.ts

@@ -4,12 +4,27 @@
  * This implementation properly implements the core SDK's HttpClient interface
  * and uses fetch API which is available in React Native.
  */
+/**
+ * Request options for HTTP client operations
+ *
+ * @interface RequestOptions
+ * @property {Record<string, string>} [headers] - HTTP headers to include
+ * @property {Record<string, string>} [params] - URL parameters
+ * @property {number} [timeout] - Request timeout in milliseconds
+ * @property {'json' | 'blob' | 'text' | 'arraybuffer'} [responseType] - Expected response type
+ */
 export interface RequestOptions {
     headers?: Record<string, string>;
     params?: Record<string, string>;
     timeout?: number;
     responseType?: 'json' | 'blob' | 'text' | 'arraybuffer';
 }
+/**
+ * HTTP Client interface for React Native
+ *
+ * @interface HttpClient
+ * @template T - Response type
+ */
 export interface HttpClient {
     get<T>(url: string, options?: RequestOptions): Promise<T>;
     post<T>(url: string, body: any, options?: RequestOptions): Promise<T>;

package/dist/providers/react-native-http-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react-native-http-client.d.ts","sourceRoot":"","sources":["../../src/providers/react-native-http-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC;CACzD;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1D,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACtE,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACrE,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC9D;AAED,qBAAa,qBAAsB,YAAW,UAAU;IACtD,OAAO,CAAC,OAAO,CAAC,CAAS;gBAEb,OAAO,CAAC,EAAE,MAAM;IAItB,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAI/D,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAI5E,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAI3E,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;YAI1D,OAAO;IAsErB,OAAO,CAAC,QAAQ;CAcjB"}
+{"version":3,"file":"react-native-http-client.d.ts","sourceRoot":"","sources":["../../src/providers/react-native-http-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC;CACzD;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1D,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACtE,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACrE,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC9D;AAED,qBAAa,qBAAsB,YAAW,UAAU;IACtD,OAAO,CAAC,OAAO,CAAC,CAAS;gBAEb,OAAO,CAAC,EAAE,MAAM;IAItB,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAI/D,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAI5E,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAI3E,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;YAI1D,OAAO;IAsErB,OAAO,CAAC,QAAQ;CAcjB"}

package/dist/storage/async-storage-token-storage.d.ts

@@ -0,0 +1,22 @@
+/**
+ * AsyncStorage Token Storage for React Native Mobile Platforms
+ *
+ * Bundler-agnostic AsyncStorage implementation for mobile platforms
+ */
+import type { TokenStorage } from '@explorins/pers-sdk/core';
+/**
+ * AsyncStorage implementation for mobile platforms
+ *
+ * This class is only used on mobile platforms (iOS/Android).
+ * Web platforms use LocalStorageTokenStorage from core SDK.
+ */
+export declare class AsyncStorageTokenStorage implements TokenStorage {
+    private keyPrefix;
+    private asyncStorage;
+    constructor(keyPrefix?: string);
+    set(key: string, value: string): Promise<void>;
+    get(key: string): Promise<string | null>;
+    remove(key: string): Promise<void>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=async-storage-token-storage.d.ts.map

package/dist/storage/async-storage-token-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-storage-token-storage.d.ts","sourceRoot":"","sources":["../../src/storage/async-storage-token-storage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AA8D7D;;;;;GAKG;AACH,qBAAa,wBAAyB,YAAW,YAAY;IAC3D,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAA8B;gBAEtC,SAAS,GAAE,MAAuB;IAexC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASxC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAY7B"}

package/dist/storage/async-storage-token-storage.js

@@ -0,0 +1,113 @@
+/**
+ * AsyncStorage Token Storage for React Native Mobile Platforms
+ *
+ * Bundler-agnostic AsyncStorage implementation for mobile platforms
+ */
+import AsyncStorage from '@react-native-async-storage/async-storage';
+/**
+ * Bundler-agnostic AsyncStorage wrapper
+ * Handles different module resolution patterns across bundlers (Metro, Webpack, Rollup, etc.)
+ */
+class BundlerAgnosticAsyncStorage {
+    constructor(asyncStorageModule) {
+        // Try different import patterns to handle various bundlers
+        if (asyncStorageModule?.default?.getItem) {
+            // Metro/Webpack pattern: { default: { getItem, setItem, ... } }
+            this.storage = asyncStorageModule.default;
+        }
+        else if (asyncStorageModule?.getItem) {
+            // Direct export pattern: { getItem, setItem, ... }
+            this.storage = asyncStorageModule;
+        }
+        else if (typeof asyncStorageModule === 'function') {
+            // Function export pattern (some bundlers)
+            this.storage = asyncStorageModule();
+        }
+        else {
+            // Log the structure for debugging
+            console.error('[BundlerAgnosticAsyncStorage] Unknown AsyncStorage structure:', asyncStorageModule);
+            throw new Error('AsyncStorage methods not found. Expected structure with getItem/setItem methods. ' +
+                'Make sure @react-native-async-storage/async-storage is properly installed.');
+        }
+        // Validate that we have the required methods
+        const requiredMethods = ['getItem', 'setItem', 'removeItem', 'getAllKeys', 'multiRemove'];
+        const missingMethods = requiredMethods.filter(method => typeof this.storage[method] !== 'function');
+        if (missingMethods.length > 0) {
+            throw new Error(`AsyncStorage missing required methods: ${missingMethods.join(', ')}. ` +
+                'Ensure @react-native-async-storage/async-storage is properly installed and compatible.');
+        }
+    }
+    async getItem(key) {
+        return this.storage.getItem(key);
+    }
+    async setItem(key, value) {
+        return this.storage.setItem(key, value);
+    }
+    async removeItem(key) {
+        return this.storage.removeItem(key);
+    }
+    async getAllKeys() {
+        return this.storage.getAllKeys();
+    }
+    async multiRemove(keys) {
+        return this.storage.multiRemove(keys);
+    }
+}
+/**
+ * AsyncStorage implementation for mobile platforms
+ *
+ * This class is only used on mobile platforms (iOS/Android).
+ * Web platforms use LocalStorageTokenStorage from core SDK.
+ */
+export class AsyncStorageTokenStorage {
+    constructor(keyPrefix = 'pers_tokens_') {
+        this.keyPrefix = keyPrefix;
+        try {
+            // Initialize bundler-agnostic AsyncStorage wrapper
+            this.asyncStorage = new BundlerAgnosticAsyncStorage(AsyncStorage);
+        }
+        catch (error) {
+            console.error('[AsyncStorageTokenStorage] Failed to initialize:', error);
+            throw new Error('Failed to initialize AsyncStorage. Make sure @react-native-async-storage/async-storage is installed and ' +
+                'this code is running on a React Native mobile platform (not web).');
+        }
+    }
+    async set(key, value) {
+        try {
+            await this.asyncStorage.setItem(`${this.keyPrefix}${key}`, value);
+        }
+        catch (error) {
+            console.error(`Failed to store token ${key}:`, error);
+            throw new Error(`Token storage failed: ${error}`);
+        }
+    }
+    async get(key) {
+        try {
+            return await this.asyncStorage.getItem(`${this.keyPrefix}${key}`);
+        }
+        catch (error) {
+            console.error(`Failed to retrieve token ${key}:`, error);
+            return null;
+        }
+    }
+    async remove(key) {
+        try {
+            await this.asyncStorage.removeItem(`${this.keyPrefix}${key}`);
+        }
+        catch (error) {
+            console.error(`Failed to remove token ${key}:`, error);
+        }
+    }
+    async clear() {
+        try {
+            const allKeys = await this.asyncStorage.getAllKeys();
+            const ourKeys = allKeys.filter(key => key.startsWith(this.keyPrefix));
+            if (ourKeys.length > 0) {
+                await this.asyncStorage.multiRemove(ourKeys);
+            }
+        }
+        catch (error) {
+            console.error('Failed to clear token storage:', error);
+        }
+    }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@explorins/pers-sdk-react-native",
-  "version": "1.5.18",
-  "description": "React Native SDK for PERS Platform - Tourism Loyalty System with Manager Pattern Architecture",
+  "version": "1.5.21",
+  "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",
   "scripts": {
@@ -26,24 +26,27 @@
     "tourism",
     "loyalty",
     "blockchain",
-    "web3"
+    "web3",
+    "webauthn",
+    "transaction-signing",
+    "rewards",
+    "authentication",
+    "biometrics",
+    "secure-storage"
   ],
   "author": "eXplorins",
   "license": "MIT",
   "dependencies": {
     "@dfns/sdk": "^0.8.1",
     "@dfns/sdk-react-native": "^0.8.1",
-    "@explorins/pers-sdk": "^1.6.3",
-    "@explorins/pers-shared": "^2.1.40",
-    "@explorins/pers-signer": "^1.0.12",
+    "@explorins/pers-sdk": "^1.6.26",
+    "@explorins/pers-shared": "^2.1.44",
+    "@explorins/pers-signer": "^1.0.18",
     "@explorins/web3-ts": "^0.3.75",
-    "@react-native-async-storage/async-storage": "^2.2.0",
     "buffer": "^6.0.3",
     "ethers": "^6.15.0",
     "react-native-get-random-values": "^2.0.0",
-    "react-native-keychain": "^10.0.0",
-    "typedoc": "^0.25.13",
-    "typedoc-plugin-markdown": "^3.17.1"
+    "react-native-keychain": "^10.0.0"
   },
   "browser": {
     "crypto": false,
@@ -93,6 +96,7 @@
     "@ethersproject/scrypt": false
   },
   "peerDependencies": {
+    "@react-native-async-storage/async-storage": ">=1.15.0",
     "react": ">=16.8.0",
     "react-native": ">=0.60.0"
   },
@@ -153,7 +157,6 @@
     "@ethersproject/scrypt": false
   },
   "devDependencies": {
-    "@react-native-async-storage/async-storage": "^1.19.0",
     "@rollup/plugin-commonjs": "^25.0.7",
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^15.2.3",
@@ -162,6 +165,8 @@
     "rimraf": "^5.0.0",
     "rollup": "^4.0.0",
     "rollup-plugin-typescript2": "^0.36.0",
+    "typedoc": "^0.25.13",
+    "typedoc-plugin-markdown": "^3.17.1",
     "typescript": "^5.2.0"
   },
   "files": [

package/src/hooks/index.ts

@@ -17,4 +17,4 @@ export { useDonations } from './useDonations';
 
 // Re-export auth-related types for convenience
 export type { RawUserData } from './useAuth';
-export type { TransactionSignerHook, TransactionSigningResult } from './useTransactionSigner';
+export type { TransactionSignerHook, SubmissionResult, AuthenticatedUser, TransactionSigningResult } from './useTransactionSigner';