@explorins/pers-sdk-react-native 2.1.19 → 2.1.21

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,CAuDrB"}
+{"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,10 +63,6 @@ export function createReactNativeAuthProvider(projectKey, config = {}) {
         enabled: dpop.enabled ?? true,
         cryptoProvider: dpop.cryptoProvider
     } : undefined;
-    // DEBUG LOGGING
-    if (debug) {
-        console.log('[ReactNativeAuthProvider] Creating provider with DPoP config:', JSON.stringify(dpopConfig));
-    }
     // 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.19",
+  "version": "2.1.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",
@@ -37,7 +37,7 @@
   "author": "eXplorins",
   "license": "MIT",
   "dependencies": {
-    "@explorins/pers-sdk": "^2.1.27",
+    "@explorins/pers-sdk": "^2.1.31",
     "@explorins/pers-signer": "^1.0.33",
     "buffer": "^6.0.3",
     "ethers": "^6.15.0",

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 } from './useIPFSUrl';
 export { usePurchases } from './usePurchases';
 export { useTenants } from './useTenants';
 export { useUsers } from './useUsers';

package/src/hooks/useIPFSUrl.ts

@@ -0,0 +1,139 @@
+import { useState, useEffect } from 'react';
+import { useWeb3 } from './useWeb3';
+import type { TokenMetadata } from '@explorins/pers-sdk/web3';
+
+/**
+ * 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.
+ * 
+ * @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 { resolveIPFSUrl, isAvailable } = useWeb3();
+  const [resolvedUrl, setResolvedUrl] = useState<string | null>(null);
+  const [isLoading, setIsLoading] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    if (!url || !isAvailable) {
+      setResolvedUrl(null);
+      return;
+    }
+
+    // Non-IPFS URLs don't need resolution
+    if (!url.startsWith('ipfs://')) {
+      setResolvedUrl(url);
+      return;
+    }
+
+    setIsLoading(true);
+    setError(null);
+
+    resolveIPFSUrl(url)
+      .then((resolved) => {
+        setResolvedUrl(resolved);
+      })
+      .catch((err) => {
+        setError(err instanceof Error ? err.message : 'Failed to resolve URL');
+        setResolvedUrl(null);
+      })
+      .finally(() => {
+        setIsLoading(false);
+      });
+  }, [url, isAvailable, resolveIPFSUrl]);
+
+  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.
+ * 
+ * @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 { fetchAndProcessMetadata, isAvailable } = useWeb3();
+  const [metadata, setMetadata] = useState<TokenMetadata | null>(null);
+  const [isLoading, setIsLoading] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+
+  const fetchMetadata = async () => {
+    if (!metadataUri || !isAvailable) {
+      setMetadata(null);
+      return;
+    }
+
+    setIsLoading(true);
+    setError(null);
+
+    try {
+      const result = await fetchAndProcessMetadata(metadataUri);
+      setMetadata(result);
+    } catch (err) {
+      setError(err instanceof Error ? err.message : 'Failed to fetch metadata');
+      setMetadata(null);
+    } finally {
+      setIsLoading(false);
+    }
+  };
+
+  useEffect(() => {
+    fetchMetadata();
+  }, [metadataUri, isAvailable]);
+
+  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 };

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,23 +166,32 @@ 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.
+   * 
    * @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) {
+    if (!isInitialized || !web3) {
       throw new Error('SDK not initialized. Call initialize() first.');
     }
     
     try {
-      const result = await sdk.tenants.resolveIPFSUrl(url);
+      const result = await web3.resolveIPFSUrl(url);
       return result;
     } catch (error) {
       console.error('Failed to resolve IPFS URL:', error);
       throw error;
     }
-  }, [sdk, isInitialized]);
+  }, [web3, isInitialized]);
 
   /**
    * Fetch and process token metadata from a URI

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

@@ -98,11 +98,6 @@ export function createReactNativeAuthProvider(
     enabled: dpop.enabled ?? true,
     cryptoProvider: dpop.cryptoProvider
   } : undefined;
-  
-  // DEBUG LOGGING
-  if (debug) {
-    console.log('[ReactNativeAuthProvider] Creating provider with DPoP config:', JSON.stringify(dpopConfig));
-  }
 
   // Return DefaultAuthProvider configured with platform-appropriate storage
   return new DefaultAuthProvider({