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

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, useTransactionSigner, 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,oBAAoB,EACpB,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"}