@explorins/pers-sdk-react-native 2.1.20 → 2.1.22

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,EAA2C,MAAM,OAAO,CAAC;AAEvH,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAIpF,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAkB3D,YAAY,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAE7B,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IAGpB,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;IAGhC,UAAU,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,sBAAsB,EAAE,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,EAAE,eAAe,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5F,eAAe,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,cAAc,EAAE,MAAM,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;CAC/C;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC;IACrC,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB,CAqOA,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,EAA2C,MAAM,OAAO,CAAC;AAEvH,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAIpF,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAkB3D,YAAY,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAE7B,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IAGpB,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;IAGhC,UAAU,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,sBAAsB,EAAE,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,EAAE,eAAe,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5F,eAAe,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,cAAc,EAAE,MAAM,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;CAC/C;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC;IACrC,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB,CA6NA,CAAC;AAGF,eAAO,MAAM,UAAU,QAAO,cAQ7B,CAAC"}

package/dist/providers/PersSDKProvider.js

@@ -72,13 +72,6 @@ export const PersSDKProvider = ({ children, config }) => {
             if (Platform.OS !== 'web' && isDpopEnabled && !dpopSettings.cryptoProvider) {
                 dpopSettings.cryptoProvider = new ReactNativeDPoPProvider();
             }
-            // Log DPoP settings before creating auth provider
-            console.log('[PersSDKProvider] DPoP settings:', {
-                platform: Platform.OS,
-                isDpopEnabled,
-                hasCryptoProvider: !!dpopSettings.cryptoProvider,
-                cryptoProviderType: dpopSettings.cryptoProvider?.constructor?.name || 'none'
-            });
             // Create platform-aware auth provider if not provided
             let authProvider;
             if (config.authProvider) {

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;;;;;;GAMG;AAGH,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAmD,MAAM,0BAA0B,CAAC;AAElI,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAc7D;;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,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,oCAAoC;IACpC,IAAI,CAAC,EAAE;QACL,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,cAAc,CAAC,EAAE,OAAO,0BAA0B,EAAE,kBAAkB,CAAC;KACxE,CAAC;CACH;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,qBAA0B,GACjC,mBAAmB,CA4DrB"}
+{"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,EAAE,gBAAgB,EAAmD,MAAM,0BAA0B,CAAC;AAElI,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAc7D;;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,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,oCAAoC;IACpC,IAAI,CAAC,EAAE;QACL,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,cAAc,CAAC,EAAE,OAAO,0BAA0B,EAAE,kBAAkB,CAAC;KACxE,CAAC;CACH;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,qBAA0B,GACjC,mBAAmB,CAkDrB"}

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

@@ -63,15 +63,6 @@ export function createReactNativeAuthProvider(projectKey, config = {}) {
         enabled: dpop.enabled ?? true,
         cryptoProvider: dpop.cryptoProvider
     } : undefined;
-    // Always log DPoP config for debugging (critical for mobile auth)
-    console.log('[ReactNativeAuthProvider] Config:', {
-        platform: Platform.OS,
-        isWebPlatform,
-        dpopEnabled: dpopConfig?.enabled ?? false,
-        hasCryptoProvider: !!dpopConfig?.cryptoProvider,
-        cryptoProviderType: dpopConfig?.cryptoProvider?.constructor?.name || 'none',
-        storageType: tokenStorage.constructor.name
-    });
     // Return DefaultAuthProvider configured with platform-appropriate storage
     return new DefaultAuthProvider({
         authType,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@explorins/pers-sdk-react-native",
-  "version": "2.1.20",
+  "version": "2.1.22",
   "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",

package/src/hooks/index.ts

@@ -8,6 +8,7 @@ export { useBusiness } from './useBusiness';
 export { useCampaigns } from './useCampaigns';
 export { useRedemptions } from './useRedemptions';
 export { useWeb3 } from './useWeb3';
+export { useResolvedUrl, useMetadata, useIPFSUrl, useTransactionMetadata } from './useIPFSUrl';
 export { usePurchases } from './usePurchases';
 export { useTenants } from './useTenants';
 export { useUsers } from './useUsers';

package/src/hooks/useIPFSUrl.ts

@@ -0,0 +1,192 @@
+import { useState, useEffect, useCallback } from 'react';
+import { usePersSDK } from '../providers/PersSDKProvider';
+import type { TokenMetadata } from '@explorins/pers-sdk';
+
+/**
+ * React hook for resolving media URLs (IPFS or HTTPS).
+ * 
+ * Automatically handles IPFS URLs by resolving them to HTTPS via tenant's gateway.
+ * Non-IPFS URLs are returned as-is. Handles loading and error states.
+ * 
+ * Uses sdk.tenants for IPFS resolution (lightweight, no Web3 deps).
+ * 
+ * @param url - The URL to resolve (can be ipfs://, https://, or undefined)
+ * @returns Object with resolved URL, loading state, and error
+ * 
+ * @example
+ * ```tsx
+ * function NFTImage({ metadataUri }: { metadataUri?: string }) {
+ *   const { url, isLoading } = useResolvedUrl(metadataUri);
+ *   
+ *   if (isLoading) return <ActivityIndicator />;
+ *   return <Image source={{ uri: url }} />;
+ * }
+ * ```
+ */
+export function useResolvedUrl(url: string | undefined | null) {
+  const { sdk, isInitialized } = usePersSDK();
+  const [resolvedUrl, setResolvedUrl] = useState<string | null>(null);
+  const [isLoading, setIsLoading] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    if (!url || !isInitialized || !sdk) {
+      setResolvedUrl(null);
+      return;
+    }
+
+    // Non-IPFS URLs don't need resolution
+    if (!url.startsWith('ipfs://')) {
+      setResolvedUrl(url);
+      return;
+    }
+
+    setIsLoading(true);
+    setError(null);
+
+    sdk.tenants.resolveIpfsUrl(url)
+      .then((resolved) => {
+        setResolvedUrl(resolved);
+      })
+      .catch((err) => {
+        setError(err instanceof Error ? err.message : 'Failed to resolve URL');
+        setResolvedUrl(null);
+      })
+      .finally(() => {
+        setIsLoading(false);
+      });
+  }, [url, isInitialized, sdk]);
+
+  return {
+    /** Resolved HTTPS URL (or original if not IPFS) */
+    url: resolvedUrl,
+    /** Whether resolution is in progress */
+    isLoading,
+    /** Error message if resolution failed */
+    error,
+  };
+}
+
+/**
+ * React hook for fetching NFT/token metadata from a URI.
+ * 
+ * Handles IPFS resolution automatically and returns parsed metadata
+ * with all nested IPFS URLs already resolved to HTTPS.
+ * 
+ * Uses sdk.tenants for metadata fetching (lightweight, no Web3 deps).
+ * 
+ * @param metadataUri - The metadata URI to fetch (can be ipfs:// or https://)
+ * @returns Object with metadata, loading state, error, and refresh function
+ * 
+ * @example
+ * ```tsx
+ * function NFTDetails({ metadataUri }: { metadataUri?: string }) {
+ *   const { metadata, isLoading, error } = useMetadata(metadataUri);
+ *   
+ *   if (isLoading) return <ActivityIndicator />;
+ *   if (error) return <Text>Error: {error}</Text>;
+ *   if (!metadata) return null;
+ *   
+ *   return (
+ *     <View>
+ *       <Image source={{ uri: metadata.imageUrl }} />
+ *       <Text>{metadata.name}</Text>
+ *       <Text>{metadata.description}</Text>
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+export function useMetadata(metadataUri: string | undefined | null) {
+  const { sdk, isInitialized } = usePersSDK();
+  const [metadata, setMetadata] = useState<TokenMetadata | null>(null);
+  const [isLoading, setIsLoading] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+
+  const fetchMetadata = useCallback(async () => {
+    if (!metadataUri || !isInitialized || !sdk) {
+      setMetadata(null);
+      return;
+    }
+
+    setIsLoading(true);
+    setError(null);
+
+    try {
+      const result = await sdk.tenants.fetchAndProcessMetadata(metadataUri);
+      setMetadata(result);
+    } catch (err) {
+      setError(err instanceof Error ? err.message : 'Failed to fetch metadata');
+      setMetadata(null);
+    } finally {
+      setIsLoading(false);
+    }
+  }, [metadataUri, isInitialized, sdk]);
+
+  useEffect(() => {
+    fetchMetadata();
+  }, [fetchMetadata]);
+
+  return {
+    /** Parsed metadata with resolved IPFS URLs (imageUrl, animationUrl, etc.) */
+    metadata,
+    /** Whether fetch is in progress */
+    isLoading,
+    /** Error message if fetch failed */
+    error,
+    /** Manually refresh metadata */
+    refresh: fetchMetadata,
+  };
+}
+
+// Re-export with descriptive aliases
+export { useResolvedUrl as useIPFSUrl };
+
+/**
+ * React hook for loading transaction/token metadata.
+ * 
+ * Convenience wrapper around useMetadata specifically for transaction items.
+ * Pass a transaction's metadataUri to get the NFT image, name, description, etc.
+ * 
+ * @param transaction - Transaction object with optional metadataUri field
+ * @returns Object with metadata, loading state, and image URL
+ * 
+ * @example
+ * ```tsx
+ * import { useTransactionMetadata } from '@explorins/pers-sdk-react-native';
+ * 
+ * function TransactionItem({ tx }: { tx: TransactionDTO }) {
+ *   const { metadata, isLoading, imageUrl } = useTransactionMetadata(tx);
+ *   
+ *   if (isLoading) return <ActivityIndicator />;
+ *   
+ *   return (
+ *     <View>
+ *       {imageUrl && <Image source={{ uri: imageUrl }} style={{ width: 60, height: 60 }} />}
+ *       <Text>{metadata?.name || tx.type}</Text>
+ *       <Text>{tx.amount} tokens</Text>
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+export function useTransactionMetadata(transaction: { metadataUri?: string | null } | null | undefined) {
+  const { metadata, isLoading, error, refresh } = useMetadata(transaction?.metadataUri);
+  
+  return {
+    /** Parsed metadata with resolved URLs */
+    metadata,
+    /** Whether metadata is loading */
+    isLoading,
+    /** Error message if fetch failed */
+    error,
+    /** Convenience: resolved image URL (or undefined) */
+    imageUrl: metadata?.imageUrl,
+    /** Convenience: token/NFT name (or undefined) */
+    name: metadata?.name,
+    /** Convenience: token/NFT description (or undefined) */
+    description: metadata?.description,
+    /** Manually refresh metadata */
+    refresh,
+  };
+}

package/src/hooks/useTransactions.ts

@@ -157,8 +157,7 @@ export const useTransactions = () => {
     }
     
     try {
-      const result = await sdk.transactions.getTransactionById(transactionId, include);
-      return result;
+      return await sdk.transactions.getTransactionById(transactionId, include);
     } catch (error) {
       console.error('Failed to fetch transaction:', error);
       throw error;
@@ -205,14 +204,12 @@ export const useTransactions = () => {
   const getUserTransactionHistory = useCallback(async (
     options?: TransactionQueryOptions
   ): Promise<PaginatedResponseDTO<TransactionDTO>> => {
-    
     if (!isInitialized || !sdk) {
       throw new Error('SDK not initialized. Call initialize() first.');
     }
     
     try {
-      const result = await sdk.transactions.getUserTransactionHistory(options);
-      return result;
+      return await sdk.transactions.getUserTransactionHistory(options);
     } catch (error) {
       console.error('Failed to fetch transaction history:', error);
       throw error;

package/src/hooks/useWeb3.ts

@@ -166,9 +166,20 @@ export const useWeb3 = () => {
   /**
    * Resolve IPFS URL to HTTP gateway URL
    * 
-   * @deprecated Use `sdk.tenant.resolveIPFSUrl()` directly - IPFS is chain-agnostic
+   * Converts an ipfs:// URL to an HTTPS URL using the tenant's configured IPFS gateway.
+   * Non-IPFS URLs are returned unchanged.
+   * 
+   * Note: Uses sdk.tenants for IPFS resolution (chain-agnostic).
+   * 
    * @param url - IPFS URL to resolve (ipfs://...)
    * @returns Promise resolving to HTTP gateway URL
+   * 
+   * @example
+   * ```typescript
+   * const { resolveIPFSUrl } = useWeb3();
+   * const httpsUrl = await resolveIPFSUrl('ipfs://QmHash...');
+   * // Returns: 'https://gateway.pinata.cloud/ipfs/QmHash...'
+   * ```
    */
   const resolveIPFSUrl = useCallback(async (url: string): Promise<string> => {
     if (!isInitialized || !sdk) {
@@ -176,7 +187,7 @@ export const useWeb3 = () => {
     }
     
     try {
-      const result = await sdk.tenants.resolveIPFSUrl(url);
+      const result = await sdk.tenants.resolveIpfsUrl(url);
       return result;
     } catch (error) {
       console.error('Failed to resolve IPFS URL:', error);
@@ -187,22 +198,24 @@ export const useWeb3 = () => {
   /**
    * Fetch and process token metadata from a URI
    * 
+   * Note: Uses sdk.tenants for metadata fetching (chain-agnostic IPFS).
+   * 
    * @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) {
+    if (!isInitialized || !sdk) {
       throw new Error('SDK not initialized. Call initialize() first.');
     }
     
     try {
-      const result = await web3.fetchAndProcessMetadata(tokenUri);
+      const result = await sdk.tenants.fetchAndProcessMetadata(tokenUri);
       return result;
     } catch (error) {
       console.error('Failed to fetch and process metadata:', error);
       throw error;
     }
-  }, [web3, isInitialized]);
+  }, [sdk, isInitialized]);
 
   const getChainDataById = useCallback(async (chainId: number): Promise<ChainData> => {
     if (!isInitialized || !web3) {

package/src/index.ts

@@ -263,7 +263,12 @@ export {
   useAnalytics,
   useDonations,
   useEvents,
-  useTriggerSources
+  useTriggerSources,
+  // IPFS hooks - for resolving ipfs:// URLs and loading metadata
+  useResolvedUrl,
+  useMetadata,
+  useIPFSUrl, // alias for useResolvedUrl
+  useTransactionMetadata // convenience for transaction items
 } from './hooks';
 
 // Re-export signing status types for convenience

package/src/providers/PersSDKProvider.tsx

@@ -135,14 +135,6 @@ export const PersSDKProvider: React.FC<{
         dpopSettings.cryptoProvider = new ReactNativeDPoPProvider();
       }
 
-      // Log DPoP settings before creating auth provider
-      console.log('[PersSDKProvider] DPoP settings:', {
-        platform: Platform.OS,
-        isDpopEnabled,
-        hasCryptoProvider: !!dpopSettings.cryptoProvider,
-        cryptoProviderType: dpopSettings.cryptoProvider?.constructor?.name || 'none'
-      });
-
       // Create platform-aware auth provider if not provided
       let authProvider: DefaultAuthProvider;
       if (config.authProvider) {

package/src/providers/react-native-auth-provider.ts

@@ -98,16 +98,6 @@ export function createReactNativeAuthProvider(
     enabled: dpop.enabled ?? true,
     cryptoProvider: dpop.cryptoProvider
   } : undefined;
-  
-  // Always log DPoP config for debugging (critical for mobile auth)
-  console.log('[ReactNativeAuthProvider] Config:', {
-    platform: Platform.OS,
-    isWebPlatform,
-    dpopEnabled: dpopConfig?.enabled ?? false,
-    hasCryptoProvider: !!dpopConfig?.cryptoProvider,
-    cryptoProviderType: dpopConfig?.cryptoProvider?.constructor?.name || 'none',
-    storageType: tokenStorage.constructor.name
-  });
 
   // Return DefaultAuthProvider configured with platform-appropriate storage
   return new DefaultAuthProvider({