@explorins/pers-sdk-react-native 2.2.0-beta.1 → 2.2.1

package/dist/hooks/useTokens.js

@@ -191,6 +191,99 @@ export const useTokens = () => {
             throw error;
         }
     }, [sdk, isInitialized]);
+    /**
+     * Get all token metadata with filtering and pagination
+     *
+     * Retrieves token metadata (rewards/stamps) with server-side filtering.
+     * Use tokenType: 'ERC1155' for rewards, 'ERC721' for stamps.
+     *
+     * @param options - Filter and pagination options
+     * @returns Promise resolving to paginated token metadata
+     * @throws Error if SDK is not initialized
+     *
+     * @example
+     * ```typescript
+     * const { getTokenMetadata } = useTokens();
+     * const rewards = await getTokenMetadata({
+     *   tokenType: 'ERC1155',
+     *   active: true,
+     *   limit: 10
+     * });
+     * ```
+     */
+    const getTokenMetadata = useCallback(async (options) => {
+        if (!isInitialized || !sdk) {
+            throw new Error('SDK not initialized. Call initialize() first.');
+        }
+        try {
+            const result = await sdk.tokens.getTokenMetadata(options);
+            return result;
+        }
+        catch (error) {
+            console.error('Failed to fetch token metadata:', error);
+            throw error;
+        }
+    }, [sdk, isInitialized]);
+    /**
+     * Get rewards (ERC1155 token metadata) with filtering and pagination
+     *
+     * Convenience method for fetching reward metadata. Rewards are ERC1155 tokens
+     * that represent collectible items, vouchers, or other redeemable rewards.
+     *
+     * @param options - Filter and pagination options
+     * @returns Promise resolving to paginated reward metadata
+     * @throws Error if SDK is not initialized
+     *
+     * @example
+     * ```typescript
+     * const { getRewards } = useTokens();
+     * const rewards = await getRewards({ active: true, limit: 10 });
+     * console.log(`Found ${rewards.pagination.total} rewards`);
+     * ```
+     */
+    const getRewards = useCallback(async (options) => {
+        if (!isInitialized || !sdk) {
+            throw new Error('SDK not initialized. Call initialize() first.');
+        }
+        try {
+            const result = await sdk.tokens.getRewards(options);
+            return result;
+        }
+        catch (error) {
+            console.error('Failed to fetch rewards:', error);
+            throw error;
+        }
+    }, [sdk, isInitialized]);
+    /**
+     * Get stamps (ERC721 token metadata) with filtering and pagination
+     *
+     * Convenience method for fetching stamp metadata. Stamps are ERC721 tokens
+     * that represent achievements, badges, or collectible status markers.
+     *
+     * @param options - Filter and pagination options
+     * @returns Promise resolving to paginated stamp metadata
+     * @throws Error if SDK is not initialized
+     *
+     * @example
+     * ```typescript
+     * const { getStamps } = useTokens();
+     * const stamps = await getStamps({ active: true, limit: 10 });
+     * console.log(`Found ${stamps.pagination.total} stamps`);
+     * ```
+     */
+    const getStamps = useCallback(async (options) => {
+        if (!isInitialized || !sdk) {
+            throw new Error('SDK not initialized. Call initialize() first.');
+        }
+        try {
+            const result = await sdk.tokens.getStamps(options);
+            return result;
+        }
+        catch (error) {
+            console.error('Failed to fetch stamps:', error);
+            throw error;
+        }
+    }, [sdk, isInitialized]);
     return {
         getTokens,
         getActiveCreditToken,
@@ -198,6 +291,9 @@ export const useTokens = () => {
         getTokenTypes,
         getStatusTokens,
         getTokenByContract,
+        getTokenMetadata,
+        getRewards,
+        getStamps,
         isAvailable: isInitialized && !!sdk?.tokens,
     };
 };