@explorins/pers-sdk-react-native 1.3.2 → 1.5.1

package/dist/hooks/useUsers.js

@@ -0,0 +1,120 @@
+import { useCallback } from 'react';
+import { usePersSDK } from '../providers/PersSDKProvider';
+export const useUsers = () => {
+    const { sdk, isInitialized, isAuthenticated } = usePersSDK();
+    const getCurrentUser = useCallback(async () => {
+        if (!isInitialized || !sdk) {
+            throw new Error('SDK not initialized. Call initialize() first.');
+        }
+        if (!isAuthenticated) {
+            throw new Error('SDK not authenticated. getCurrentUser requires authentication.');
+        }
+        try {
+            const result = await sdk.users.getCurrentUser();
+            console.log('Current user fetched successfully:', result);
+            return result;
+        }
+        catch (error) {
+            console.error('Failed to fetch current user:', error);
+            throw error;
+        }
+    }, [sdk, isInitialized, isAuthenticated]);
+    const updateCurrentUser = useCallback(async (userData) => {
+        if (!isInitialized || !sdk) {
+            throw new Error('SDK not initialized. Call initialize() first.');
+        }
+        if (!isAuthenticated) {
+            throw new Error('SDK not authenticated. updateCurrentUser requires authentication.');
+        }
+        try {
+            const result = await sdk.users.updateCurrentUser(userData);
+            console.log('Current user updated successfully:', result);
+            return result;
+        }
+        catch (error) {
+            console.error('Failed to update current user:', error);
+            throw error;
+        }
+    }, [sdk, isInitialized, isAuthenticated]);
+    const getUserById = useCallback(async (userId) => {
+        if (!isInitialized || !sdk) {
+            throw new Error('SDK not initialized. Call initialize() first.');
+        }
+        try {
+            const result = await sdk.users.getUserById(userId);
+            console.log('User fetched successfully:', result);
+            return result;
+        }
+        catch (error) {
+            console.error('Failed to fetch user:', error);
+            throw error;
+        }
+    }, [sdk, isInitialized]);
+    const getAllUsersPublic = useCallback(async (filter) => {
+        if (!isInitialized || !sdk) {
+            throw new Error('SDK not initialized. Call initialize() first.');
+        }
+        try {
+            const result = await sdk.users.getAllUsersPublic(filter);
+            console.log('Public users fetched successfully:', result);
+            return result;
+        }
+        catch (error) {
+            console.error('Failed to fetch public users:', error);
+            throw error;
+        }
+    }, [sdk, isInitialized]);
+    // Admin methods
+    const getAllUsers = useCallback(async () => {
+        if (!isInitialized || !sdk) {
+            throw new Error('SDK not initialized. Call initialize() first.');
+        }
+        try {
+            const result = await sdk.users.getAllUsers();
+            console.log('All users fetched successfully:', result);
+            return result;
+        }
+        catch (error) {
+            console.error('Failed to fetch all users:', error);
+            throw error;
+        }
+    }, [sdk, isInitialized]);
+    const updateUser = useCallback(async (userId, userData) => {
+        if (!isInitialized || !sdk) {
+            throw new Error('SDK not initialized. Call initialize() first.');
+        }
+        try {
+            const result = await sdk.users.updateUser(userId, userData);
+            console.log('User updated successfully:', result);
+            return result;
+        }
+        catch (error) {
+            console.error('Failed to update user:', error);
+            throw error;
+        }
+    }, [sdk, isInitialized]);
+    const toggleUserStatus = useCallback(async (user) => {
+        if (!isInitialized || !sdk) {
+            throw new Error('SDK not initialized. Call initialize() first.');
+        }
+        try {
+            const result = await sdk.users.toggleUserStatus(user);
+            console.log('User status toggled successfully:', result);
+            return result;
+        }
+        catch (error) {
+            console.error('Failed to toggle user status:', error);
+            throw error;
+        }
+    }, [sdk, isInitialized]);
+    return {
+        getCurrentUser,
+        updateCurrentUser,
+        getUserById,
+        getAllUsersPublic,
+        getAllUsers,
+        updateUser,
+        toggleUserStatus,
+        isAvailable: isInitialized && !!sdk?.users,
+    };
+};

package/dist/hooks/useWeb3.d.ts

@@ -1,11 +1,74 @@
+import type { TokenBalance, TokenBalanceRequest, TokenCollectionRequest, TokenCollection, TokenMetadata } from '@explorins/pers-sdk/web3';
+import type { ChainData } from '@explorins/pers-sdk/web3-chain';
+interface WalletInfo {
+    address: string | null;
+    isConnected: boolean;
+}
+/**
+ * React hook for Web3 operations in the PERS SDK
+ *
+ * Provides comprehensive Web3 functionality including token balance queries,
+ * metadata retrieval, collection management, IPFS resolution, and blockchain
+ * explorer integration. Supports multi-chain operations and wallet management.
+ *
+ * @returns Web3 hook with methods for blockchain operations
+ *
+ * @example
+ * ```typescript
+ * function Web3Component() {
+ *   const {
+ *     getTokenBalance,
+ *     getTokenMetadata,
+ *     getWalletInfo,
+ *     accountAddress
+ *   } = useWeb3();
+ *
+ *   const loadTokenData = async () => {
+ *     try {
+ *       if (!accountAddress) {
+ *         console.log('No wallet connected');
+ *         return;
+ *       }
+ *
+ *       const balance = await getTokenBalance({
+ *         walletAddress: accountAddress,
+ *         contractAddress: '0x123...',
+ *         chainId: 1
+ *       });
+ *
+ *       console.log('Token balance:', balance);
+ *     } catch (error) {
+ *       console.error('Failed to load token data:', error);
+ *     }
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       {accountAddress ? (
+ *         <div>
+ *           <p>Wallet: {accountAddress}</p>
+ *           <button onClick={loadTokenData}>Load Tokens</button>
+ *         </div>
+ *       ) : (
+ *         <p>No wallet connected</p>
+ *       )}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
 export declare const useWeb3: () => {
-    getTokenBalance: (request: any) => Promise<any>;
-    getTokenCollection: (request: any) => Promise<any>;
-    getWalletInfo: () => Promise<{
-        address: string;
-        isConnected: boolean;
-    } | null>;
+    getTokenBalance: (request: TokenBalanceRequest) => Promise<TokenBalance>;
+    getTokenMetadata: (request: TokenBalanceRequest) => Promise<TokenMetadata | null>;
+    getTokenCollection: (request: TokenCollectionRequest) => Promise<TokenCollection>;
+    resolveIPFSUrl: (url: string, chainId: number) => Promise<string>;
+    fetchAndProcessMetadata: (tokenUri: string, chainId: number) => Promise<TokenMetadata | null>;
+    getChainDataById: (chainId: number) => Promise<ChainData | null>;
+    getExplorerUrl: (chainId: number, address: string, type: 'address' | 'tx') => Promise<string>;
+    getWalletInfo: () => Promise<WalletInfo | null>;
     accountAddress: string | null;
     isAvailable: boolean;
 };
+export type Web3Hook = ReturnType<typeof useWeb3>;
+export {};
 //# sourceMappingURL=useWeb3.d.ts.map

package/dist/hooks/useWeb3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useWeb3.d.ts","sourceRoot":"","sources":["../../src/hooks/useWeb3.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO;+BAOkC,GAAG;kCAkBA,GAAG;;;;;;;CAyC3D,CAAC"}
+{"version":3,"file":"useWeb3.d.ts","sourceRoot":"","sources":["../../src/hooks/useWeb3.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EACf,aAAa,EACd,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAEhE,UAAU,UAAU;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,eAAO,MAAM,OAAO;+BA0BkC,mBAAmB,KAAG,QAAQ,YAAY,CAAC;gCAmC1C,mBAAmB,KAAG,QAAQ,aAAa,GAAG,IAAI,CAAC;kCAejD,sBAAsB,KAAG,QAAQ,eAAe,CAAC;0BAezD,MAAM,WAAW,MAAM,KAAG,QAAQ,MAAM,CAAC;wCAe3B,MAAM,WAAW,MAAM,KAAG,QAAQ,aAAa,GAAG,IAAI,CAAC;gCAe/D,MAAM,KAAG,QAAQ,SAAS,GAAG,IAAI,CAAC;8BAepC,MAAM,WAAW,MAAM,QAAQ,SAAS,GAAG,IAAI,KAAG,QAAQ,MAAM,CAAC;yBAexE,QAAQ,UAAU,GAAG,IAAI,CAAC;;;CA2BvE,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC"}

package/dist/hooks/useWeb3.js

@@ -1,45 +1,200 @@
 import { useCallback } from 'react';
 import { usePersSDK } from '../providers/PersSDKProvider';
+/**
+ * React hook for Web3 operations in the PERS SDK
+ *
+ * Provides comprehensive Web3 functionality including token balance queries,
+ * metadata retrieval, collection management, IPFS resolution, and blockchain
+ * explorer integration. Supports multi-chain operations and wallet management.
+ *
+ * @returns Web3 hook with methods for blockchain operations
+ *
+ * @example
+ * ```typescript
+ * function Web3Component() {
+ *   const {
+ *     getTokenBalance,
+ *     getTokenMetadata,
+ *     getWalletInfo,
+ *     accountAddress
+ *   } = useWeb3();
+ *
+ *   const loadTokenData = async () => {
+ *     try {
+ *       if (!accountAddress) {
+ *         console.log('No wallet connected');
+ *         return;
+ *       }
+ *
+ *       const balance = await getTokenBalance({
+ *         walletAddress: accountAddress,
+ *         contractAddress: '0x123...',
+ *         chainId: 1
+ *       });
+ *
+ *       console.log('Token balance:', balance);
+ *     } catch (error) {
+ *       console.error('Failed to load token data:', error);
+ *     }
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       {accountAddress ? (
+ *         <div>
+ *           <p>Wallet: {accountAddress}</p>
+ *           <button onClick={loadTokenData}>Load Tokens</button>
+ *         </div>
+ *       ) : (
+ *         <p>No wallet connected</p>
+ *       )}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
 export const useWeb3 = () => {
-    const { web3, isInitialized, isAuthenticated, accountAddress } = usePersSDK();
+    const { sdk, isInitialized, isAuthenticated, accountAddress } = usePersSDK();
     if (!isAuthenticated && isInitialized) {
         console.warn('SDK not authenticated. Some web3 operations may fail.');
     }
+    /**
+     * Retrieves token balance for a specific wallet and contract
+     *
+     * @param request - Token balance request containing wallet address, contract, and chain info
+     * @returns Promise resolving to token balance data
+     * @throws Error if SDK is not initialized
+     *
+     * @example
+     * ```typescript
+     * const { getTokenBalance } = useWeb3();
+     * const balance = await getTokenBalance({
+     *   walletAddress: '0x123...',
+     *   contractAddress: '0x456...',
+     *   chainId: 1,
+     *   tokenId: '1' // For NFTs
+     * });
+     * console.log('Balance:', balance.balance);
+     * ```
+     */
     const getTokenBalance = useCallback(async (request) => {
-        if (!isInitialized) {
+        console.log('[useWeb3] getTokenBalance called with request:', request);
+        if (!isInitialized || !sdk) {
             throw new Error('SDK not initialized. Call initialize() first.');
         }
-        if (!web3?.getTokenBalance) {
-            throw new Error('getTokenBalance method not available');
+        try {
+            const result = await sdk.web3.getTokenBalance(request);
+            console.log('Token balance fetched successfully:', result);
+            return result;
+        }
+        catch (error) {
+            console.error('Failed to fetch token balance:', error);
+            throw error;
+        }
+    }, [sdk, isInitialized]);
+    /**
+     * Retrieves metadata for a specific token (useful for NFTs)
+     *
+     * @param request - Token balance request containing contract and token info
+     * @returns Promise resolving to token metadata or null if not available
+     * @throws Error if SDK is not initialized
+     *
+     * @example
+     * ```typescript
+     * const { getTokenMetadata } = useWeb3();
+     * const metadata = await getTokenMetadata({
+     *   contractAddress: '0x123...',
+     *   tokenId: '1',
+     *   chainId: 1
+     * });
+     * console.log('NFT name:', metadata?.name);
+     * console.log('NFT image:', metadata?.image);
+     * ```
+     */
+    const getTokenMetadata = useCallback(async (request) => {
+        if (!isInitialized || !sdk) {
+            throw new Error('SDK not initialized. Call initialize() first.');
         }
         try {
-            const result = await web3.getTokenBalance(request);
-            console.log('✅ Token balance fetched successfully:', result);
+            const result = await sdk.web3.getTokenMetadata(request);
+            console.log('Token metadata fetched successfully:', result);
             return result;
         }
         catch (error) {
-            console.error('❌ Failed to fetch token balance:', error);
+            console.error('Failed to fetch token metadata:', error);
             throw error;
         }
-    }, [web3]);
+    }, [sdk, isInitialized]);
     const getTokenCollection = useCallback(async (request) => {
-        if (!isInitialized) {
+        if (!isInitialized || !sdk) {
+            throw new Error('SDK not initialized. Call initialize() first.');
+        }
+        try {
+            const result = await sdk.web3.getTokenCollection(request);
+            console.log('Token collection fetched successfully:', result);
+            return result;
+        }
+        catch (error) {
+            console.error('Failed to fetch token collection:', error);
+            throw error;
+        }
+    }, [sdk, isInitialized]);
+    const resolveIPFSUrl = useCallback(async (url, chainId) => {
+        if (!isInitialized || !sdk) {
+            throw new Error('SDK not initialized. Call initialize() first.');
+        }
+        try {
+            const result = await sdk.web3.resolveIPFSUrl(url, chainId);
+            console.log('IPFS URL resolved successfully:', result);
+            return result;
+        }
+        catch (error) {
+            console.error('Failed to resolve IPFS URL:', error);
+            throw error;
+        }
+    }, [sdk, isInitialized]);
+    const fetchAndProcessMetadata = useCallback(async (tokenUri, chainId) => {
+        if (!isInitialized || !sdk) {
+            throw new Error('SDK not initialized. Call initialize() first.');
+        }
+        try {
+            const result = await sdk.web3.fetchAndProcessMetadata(tokenUri, chainId);
+            console.log('Metadata fetched and processed successfully:', result);
+            return result;
+        }
+        catch (error) {
+            console.error('Failed to fetch and process metadata:', error);
+            throw error;
+        }
+    }, [sdk, isInitialized]);
+    const getChainDataById = useCallback(async (chainId) => {
+        if (!isInitialized || !sdk) {
             throw new Error('SDK not initialized. Call initialize() first.');
         }
-        if (!web3?.getTokenCollection) {
-            console.warn('getTokenCollection method not available');
-            return [];
+        try {
+            const result = await sdk.web3.getChainDataById(chainId);
+            console.log('Chain data fetched successfully:', result);
+            return result;
+        }
+        catch (error) {
+            console.error('Failed to fetch chain data:', error);
+            throw error;
+        }
+    }, [sdk, isInitialized]);
+    const getExplorerUrl = useCallback(async (chainId, address, type) => {
+        if (!isInitialized || !sdk) {
+            throw new Error('SDK not initialized. Call initialize() first.');
         }
         try {
-            const result = await web3.getTokenCollection(request);
-            console.log('✅ Token collection fetched successfully:', result);
+            const result = await sdk.web3.getExplorerUrl(chainId, address, type);
+            console.log('Explorer URL generated successfully:', result);
             return result;
         }
         catch (error) {
-            console.error('❌ Failed to fetch token collection:', error);
+            console.error('Failed to generate explorer URL:', error);
             throw error;
         }
-    }, [web3]);
+    }, [sdk, isInitialized]);
     const getWalletInfo = useCallback(async () => {
         if (!isInitialized) {
             throw new Error('SDK not initialized. Call initialize() first.');
@@ -55,9 +210,14 @@ export const useWeb3 = () => {
     }, [isInitialized, accountAddress]);
     return {
         getTokenBalance,
+        getTokenMetadata,
         getTokenCollection,
+        resolveIPFSUrl,
+        fetchAndProcessMetadata,
+        getChainDataById,
+        getExplorerUrl,
         getWalletInfo,
         accountAddress: isInitialized ? accountAddress : null,
-        isAvailable: isInitialized && !!web3,
+        isAvailable: isInitialized && !!sdk?.web3,
     };
 };

package/dist/index.d.ts

@@ -1,7 +1,9 @@
 import './polyfills';
-export { BaseReactNativeAuthProvider, ReactNativeAuthProvider, SecureReactNativeAuthProvider, StorageStrategy, type ReactNativeAuthConfig } from './providers/react-native-auth-provider';
-export { PersSDKProvider, usePersSDK, type PersSDKConfig, type PersSDKContext } from './providers/PersSDKProvider';
-export { useAuth, useTokens, useTransactions, useBusiness, useCampaigns, useRedemptions, useWeb3 } from './hooks';
+export { ReactNativeAuthProvider, type ReactNativeAuthConfig } from './providers/react-native-auth-provider';
+export { PersSDKProvider, usePersSDK, type PersConfig, type PersSDKContext } from './providers/PersSDKProvider';
+export { useAuth, useTokens, useTransactions, useBusiness, useCampaigns, useRedemptions, useWeb3, usePurchases, useTenants, useUsers, useUserStatus, useFiles, useAnalytics, useDonations } from './hooks';
 export { ReactNativeHttpClient } from './providers/react-native-http-client';
-export { initializeReactNativePolyfills, isReactNative } from './polyfills';
+export { initializeReactNativePolyfills } from './polyfills';
+export * from '@explorins/pers-shared';
+export type { TokenBalanceRequest, TokenBalance, TokenMetadata, TokenCollection, TokenCollectionRequest } from '@explorins/pers-sdk/web3';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,aAAa,CAAC;AAMrB,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,EACvB,6BAA6B,EAC7B,eAAe,EACf,KAAK,qBAAqB,EAC3B,MAAM,wCAAwC,CAAC;AAKhD,OAAO,EACL,eAAe,EACf,UAAU,EACV,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACL,OAAO,EACP,SAAS,EACT,eAAe,EACf,WAAW,EACX,YAAY,EACZ,cAAc,EACd,OAAO,EACR,MAAM,SAAS,CAAC;AAIjB,OAAO,EACL,qBAAqB,EACtB,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EACL,8BAA8B,EAC9B,aAAa,EACd,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,aAAa,CAAC;AAGrB,OAAO,EACL,uBAAuB,EACvB,KAAK,qBAAqB,EAC3B,MAAM,wCAAwC,CAAC;AAGhD,OAAO,EACL,eAAe,EACf,UAAU,EACV,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACL,OAAO,EACP,SAAS,EACT,eAAe,EACf,WAAW,EACX,YAAY,EACZ,cAAc,EACd,OAAO,EACP,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,YAAY,EACb,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,qBAAqB,EACtB,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EACL,8BAA8B,EAC/B,MAAM,aAAa,CAAC;AAGrB,cAAc,wBAAwB,CAAC;AAGvC,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,sBAAsB,EACvB,MAAM,0BAA0B,CAAC"}