@explorins/pers-sdk-react-native 2.1.7 → 2.1.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@explorins/pers-sdk-react-native",
-  "version": "2.1.7",
+  "version": "2.1.10",
   "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.15",
+    "@explorins/pers-sdk": "^2.1.16",
     "@explorins/pers-signer": "^1.0.33",
     "buffer": "^6.0.3",
     "ethers": "^6.15.0",

package/src/hooks/useCampaigns.ts

@@ -7,23 +7,74 @@ import type {
   CampaignTriggerDTO,
   PaginatedResponseDTO,
   CampaignClaimIncludeRelation,
-  CampaignIncludeRelation
+  CampaignIncludeRelation,
+  SortOrder
 } from '@explorins/pers-shared';
 import type { CampaignClaimFilters } from '@explorins/pers-sdk/campaign';
 
 // Re-export for consumers
 export type { CampaignClaimFilters } from '@explorins/pers-sdk/campaign';
 
+/**
+ * Options for fetching campaigns
+ */
+export interface GetCampaignsOptions {
+  /** Filter by tag */
+  tag?: string;
+  /** Filter by business ID */
+  businessId?: string;
+  /** Page number (1-indexed) */
+  page?: number;
+  /** Items per page */
+  limit?: number;
+  /** Sort field */
+  sortBy?: 'name' | 'createdAt' | 'startDate';
+  /** Sort order */
+  sortOrder?: SortOrder;
+  /** Relations to include: 'triggerSources', 'businesses' */
+  include?: CampaignIncludeRelation[];
+}
+
 export const useCampaigns = () => {
   const { sdk, isInitialized, isAuthenticated } = usePersSDK();
 
-  const getActiveCampaigns = useCallback(async (): Promise<PaginatedResponseDTO<CampaignDTO>> => {
+  /**
+   * Get active campaigns with optional filters and include relations
+   * 
+   * @param options - Filter, pagination, and include options
+   * @returns Promise resolving to paginated active campaigns
+   * 
+   * @example
+   * ```typescript
+   * // Simple: get active campaigns with trigger sources
+   * const { data: campaigns } = await getActiveCampaigns({ include: ['triggerSources'] });
+   * 
+   * // With pagination
+   * const { data, pagination } = await getActiveCampaigns({ 
+   *   page: 1, 
+   *   limit: 10,
+   *   include: ['triggerSources', 'businesses'] 
+   * });
+   * 
+   * // Filter by tag
+   * const { data } = await getActiveCampaigns({ tag: 'summer-promo' });
+   * 
+   * // Filter by business
+   * const { data } = await getActiveCampaigns({ businessId: 'business-123' });
+   * ```
+   */
+  const getActiveCampaigns = useCallback(async (
+    options?: GetCampaignsOptions
+  ): Promise<PaginatedResponseDTO<CampaignDTO>> => {
     if (!isInitialized || !sdk) {
       throw new Error('SDK not initialized. Call initialize() first.');
     }
     
     try {
-      const result = await sdk.campaigns.getCampaigns({ active: true });
+      const result = await sdk.campaigns.getCampaigns({ 
+        active: true,
+        ...options 
+      });
       return result;
     } catch (error) {
       console.error('Failed to fetch active campaigns:', error);
@@ -134,13 +185,41 @@ export const useCampaigns = () => {
   }, [sdk, isInitialized]);
 
   // Admin methods
-  const getAllCampaigns = useCallback(async (active?: boolean): Promise<PaginatedResponseDTO<CampaignDTO>> => {
+  /**
+   * Admin: Get all campaigns with optional filters and include relations
+   * 
+   * @param options - Filter, pagination, and include options (same as getActiveCampaigns but active is optional)
+   * @returns Promise resolving to paginated campaigns
+   * 
+   * @example
+   * ```typescript
+   * // Get all campaigns
+   * const { data } = await getAllCampaigns();
+   * 
+   * // Get only active campaigns with trigger sources
+   * const { data } = await getAllCampaigns({ active: true, include: ['triggerSources'] });
+   * 
+   * // Get inactive campaigns
+   * const { data } = await getAllCampaigns({ active: false });
+   * 
+   * // With pagination and sorting
+   * const { data } = await getAllCampaigns({ 
+   *   page: 1, 
+   *   limit: 20, 
+   *   sortBy: 'createdAt', 
+   *   sortOrder: 'DESC' 
+   * });
+   * ```
+   */
+  const getAllCampaigns = useCallback(async (
+    options?: GetCampaignsOptions & { active?: boolean }
+  ): Promise<PaginatedResponseDTO<CampaignDTO>> => {
     if (!isInitialized || !sdk) {
       throw new Error('SDK not initialized. Call initialize() first.');
     }
     
     try {
-      const result = await sdk.campaigns.getCampaigns({ active });
+      const result = await sdk.campaigns.getCampaigns(options);
       return result;
     } catch (error) {
       console.error('Failed to fetch all campaigns:', error);

package/src/hooks/useTokenBalances.ts

@@ -34,7 +34,11 @@ export interface UseTokenBalancesOptions {
   availableTokens?: TokenDTO[];
   /** Whether to automatically load balances on mount/auth/token changes */
   autoLoad?: boolean;
-  /** Optional refresh interval in milliseconds (0 = disabled) */
+  /** 
+   * Fallback polling interval in milliseconds (0 = disabled)
+   * @deprecated Use wallet events instead (refreshOnWalletEvents). Polling kept as fallback only.
+   * @default 0
+   */
   refreshInterval?: number;
   /** 
    * Auto-refresh balances when wallet events are received (Transfer, Approval, etc.)
@@ -127,18 +131,7 @@ export interface UseTokenBalancesResult {
  * ```
  * 
  * @example
- * **With Auto-Refresh:**
- * ```typescript
- * const { tokenBalances, isLoading } = useTokenBalances({
- *   accountAddress: walletAddress!,
- *   availableTokens,
- *   autoLoad: true,
- *   refreshInterval: 30000 // Refresh every 30 seconds
- * });
- * ```
- * 
- * @example
- * **With Wallet Events (Real-time):**
+ * **With Wallet Events (Real-time):
  * ```typescript
  * // Auto-refresh on Transfer, Approval, and other blockchain events
  * const { tokenBalances } = useTokenBalances({
@@ -297,30 +290,19 @@ export function useTokenBalances(options: UseTokenBalancesOptions): UseTokenBala
     }
   }, [autoLoad, isAvailable, availableTokens.length, loadBalances]);
 
-  // Event-driven refresh: listen for transaction events instead of polling
+  // Deprecated: Fallback polling interval (prefer wallet events)
+  // Kept for backward compatibility and edge cases where events might not work
   useEffect(() => {
-    if (!sdk || refreshInterval <= 0 || !isAvailable) return;
-
-    // Subscribe to transaction domain events
-    const unsubscribe = sdk.events.subscribe((event) => {
-      if (event.domain === 'transaction' && event.type === 'transaction_completed') {
-        console.log('[useTokenBalances] Transaction completed, refreshing balances...');
-        loadBalances();
-      }
-    }, { domains: ['transaction'] });
+    if (refreshInterval <= 0 || !isAvailable) return;
 
-    // Also set up a fallback polling interval (much longer than before)
-    // This handles cases where events might be missed
-    const fallbackInterval = Math.max(refreshInterval, 60000); // Minimum 1 minute
     const intervalId = setInterval(() => {
       loadBalances();
-    }, fallbackInterval);
+    }, refreshInterval);
 
     return () => {
-      unsubscribe();
       clearInterval(intervalId);
     };
-  }, [sdk, refreshInterval, isAvailable, loadBalances]);
+  }, [refreshInterval, isAvailable, loadBalances]);
 
   // Wallet events refresh: listen for real-time blockchain events
   // Refreshes on ANY wallet domain event (Transfer, TransferSingle, etc.)