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

package/src/hooks/useWeb3.ts

@@ -9,8 +9,10 @@ import type {
   TokenMetadata,
   AccountOwnedTokensResult
 } from '@explorins/pers-sdk/web3';
-import type { ChainData } from '@explorins/pers-sdk/web3-chain';
-import type { TokenDTO } from '@explorins/pers-shared';
+import type { TokenDTO } from '@explorins/pers-sdk/token';
+
+// ChainData type - matches what Web3Manager.getChainDataById returns
+type ChainData = Awaited<ReturnType<Web3Manager['getChainDataById']>>;
 
 // Re-export for convenience
 export type { AccountOwnedTokensResult } from '@explorins/pers-sdk/web3';
@@ -161,27 +163,40 @@ export const useWeb3 = () => {
     }
   }, [web3, isInitialized]);
 
-  const resolveIPFSUrl = useCallback(async (url: string, chainId: number): Promise<string> => {
-    if (!isInitialized || !web3) {
+  /**
+   * Resolve IPFS URL to HTTP gateway URL
+   * 
+   * @deprecated Use `sdk.tenant.resolveIPFSUrl()` directly - IPFS is chain-agnostic
+   * @param url - IPFS URL to resolve (ipfs://...)
+   * @returns Promise resolving to HTTP gateway URL
+   */
+  const resolveIPFSUrl = useCallback(async (url: string): Promise<string> => {
+    if (!isInitialized || !sdk) {
       throw new Error('SDK not initialized. Call initialize() first.');
     }
     
     try {
-      const result = await web3.resolveIPFSUrl(url, chainId);
+      const result = await sdk.tenants.resolveIPFSUrl(url);
       return result;
     } catch (error) {
       console.error('Failed to resolve IPFS URL:', error);
       throw error;
     }
-  }, [web3, isInitialized]);
+  }, [sdk, isInitialized]);
 
-  const fetchAndProcessMetadata = useCallback(async (tokenUri: string, chainId: number): Promise<TokenMetadata | null> => {
+  /**
+   * Fetch and process token metadata from a URI
+   * 
+   * @param tokenUri - Token URI to fetch metadata from
+   * @returns Promise resolving to processed metadata or null
+   */
+  const fetchAndProcessMetadata = useCallback(async (tokenUri: string): Promise<TokenMetadata | null> => {
     if (!isInitialized || !web3) {
       throw new Error('SDK not initialized. Call initialize() first.');
     }
     
     try {
-      const result = await web3.fetchAndProcessMetadata(tokenUri, chainId);
+      const result = await web3.fetchAndProcessMetadata(tokenUri);
       return result;
     } catch (error) {
       console.error('Failed to fetch and process metadata:', error);
@@ -189,7 +204,7 @@ export const useWeb3 = () => {
     }
   }, [web3, isInitialized]);
 
-  const getChainDataById = useCallback(async (chainId: number): Promise<ChainData | null> => {
+  const getChainDataById = useCallback(async (chainId: number): Promise<ChainData> => {
     if (!isInitialized || !web3) {
       throw new Error('SDK not initialized. Call initialize() first.');
     }
@@ -255,7 +270,7 @@ export const useWeb3 = () => {
    * 
    * @param accountAddress - Any valid blockchain address (wallet, contract, etc.)
    * @param token - Token definition (from getRewardTokens, getStatusTokens, etc.)
-   * @param maxTokens - Maximum tokens to retrieve (default: 50)
+   * @param maxTokens - Maximum tokens to retrieve (default: 100, max: 100)
    * @returns Promise resolving to result with owned tokens
    * @throws Error if SDK is not initialized
    * 
@@ -277,7 +292,7 @@ export const useWeb3 = () => {
   const getAccountOwnedTokensFromContract = useCallback(async (
     accountAddress: string,
     token: TokenDTO,
-    maxTokens: number = 50
+    maxTokens: number = 100
   ): Promise<AccountOwnedTokensResult> => {
     if (!isInitialized || !web3) {
       throw new Error('SDK not initialized. Call initialize() first.');
@@ -295,13 +310,13 @@ export const useWeb3 = () => {
    * 
    * @param accountAddress - Any valid blockchain address (wallet, contract, etc.)
    * @param token - Token definition
-   * @param maxTokens - Maximum tokens to retrieve (default: 50)
+   * @param maxTokens - Maximum tokens to retrieve (default: 100, max: 100)
    * @returns TokenCollectionRequest ready for getTokenCollection()
    */
   const buildCollectionRequest = useCallback((
     accountAddress: string,
     token: TokenDTO,
-    maxTokens: number = 50
+    maxTokens: number = 100
   ): TokenCollectionRequest => {
     if (!web3) {
       throw new Error('SDK not initialized. Call initialize() first.');

package/src/index.ts

@@ -262,11 +262,20 @@ export {
   useFiles,
   useAnalytics,
   useDonations,
-  useEvents
+  useEvents,
+  useTriggerSources
 } from './hooks';
 
 // Re-export signing status types for convenience
-export type { OnStatusUpdateFn, StatusUpdateData, SigningStatusType, TransactionSigningResult, SubmissionResult, AuthenticatedUser } from './hooks';
+export type { 
+  TransactionSignerHook,
+  OnStatusUpdateFn, 
+  StatusUpdateData, 
+  SigningStatusType, 
+  TransactionSigningResult, 
+  SubmissionResult, 
+  AuthenticatedUser 
+} from './hooks';
 
 // Re-export event types for convenience
 export type { EventsHook, PersEvent, EventHandler, EventFilter, Unsubscribe } from './hooks';
@@ -274,6 +283,21 @@ export type { EventsHook, PersEvent, EventHandler, EventFilter, Unsubscribe } fr
 // Re-export token balance types for convenience
 export type { TokenBalanceWithToken, UseTokenBalancesOptions, UseTokenBalancesResult } from './hooks';
 
+// Re-export campaign types for convenience
+export type { CampaignClaimFilters, CampaignHook } from './hooks';
+
+// Re-export redemption types for convenience
+export type { RedemptionRedeemFilters, RedemptionHook } from './hooks';
+
+// Re-export transaction types for convenience
+export type { TransactionQueryOptions, TransactionHook } from './hooks';
+
+// Re-export trigger source types for convenience
+export type { TriggerSourceQueryOptions, TriggerSourceHook } from './hooks';
+
+// Re-export analytics types for convenience
+export type { AnalyticsHook } from './hooks';
+
 // ==============================================================================
 // PLATFORM ADAPTERS
 // ==============================================================================
@@ -284,9 +308,15 @@ export type { TokenBalanceWithToken, UseTokenBalancesOptions, UseTokenBalancesRe
  * Provides platform-specific networking with proper error handling, timeout management,
  * and React Native compatibility. Automatically handles headers, authentication tokens,
  * and response parsing.
+ * 
+ * @see {@link ReactNativeHttpClient} - The HTTP client implementation
+ * @see {@link HttpClient} - The HTTP client interface
+ * @see {@link RequestOptions} - Request configuration options
  */
 export {
-  ReactNativeHttpClient
+  ReactNativeHttpClient,
+  type HttpClient,
+  type RequestOptions
 } from './providers/react-native-http-client';
 
 // ==============================================================================

package/src/providers/PersSDKProvider.tsx

@@ -24,6 +24,15 @@ import type {
 // Re-export PersConfig for external use
 export type { PersConfig } from '@explorins/pers-sdk/core';
 
+/**
+ * Context interface for PERS SDK React Native integration
+ * 
+ * @property sdk - Main SDK instance (null until initialized)
+ * @property authProvider - Platform-specific auth provider
+ * @property isInitialized - Whether SDK has been initialized
+ * @property isAuthenticated - Whether user is currently authenticated
+ * @property user - Current user data (null if not authenticated)
+ */
 export interface PersSDKContext {
   // Main SDK instance
   sdk: PersSDK | null;
@@ -46,7 +55,35 @@ export interface PersSDKContext {
 // Create the context
 const SDKContext = createContext<PersSDKContext | null>(null);
 
-// Provider component
+/**
+ * PERS SDK Provider for React Native
+ * 
+ * Wraps your app to provide SDK context to all child components.
+ * Handles platform-specific initialization (DPoP, storage, etc.).
+ * 
+ * @param config - SDK configuration (see PersConfig)
+ * @param config.apiProjectKey - Your PERS project key (required)
+ * @param config.environment - 'staging' | 'production' (default: 'staging')
+ * @param config.captureWalletEvents - Enable real-time blockchain events (default: true)
+ * @param config.dpop - DPoP configuration for enhanced security
+ * 
+ * @example Basic usage
+ * ```tsx
+ * <PersSDKProvider config={{ apiProjectKey: 'my-project' }}>
+ *   <App />
+ * </PersSDKProvider>
+ * ```
+ * 
+ * @example Disable wallet events
+ * ```tsx
+ * <PersSDKProvider config={{ 
+ *   apiProjectKey: 'my-project',
+ *   captureWalletEvents: false  // Disable auto-connect to blockchain events
+ * }}>
+ *   <App />
+ * </PersSDKProvider>
+ * ```
+ */
 export const PersSDKProvider: React.FC<{
   children: ReactNode;
   config?: PersConfig;