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

package/dist/hooks/useCampaigns.d.ts

@@ -1,8 +1,27 @@
-import type { CampaignClaimRequestDTO, CampaignDTO, CampaignClaimDTO, CampaignTriggerDTO, PaginatedResponseDTO, CampaignClaimIncludeRelation, CampaignIncludeRelation } from '@explorins/pers-shared';
+import type { CampaignClaimRequestDTO, CampaignDTO, CampaignClaimDTO, CampaignTriggerDTO, PaginatedResponseDTO, CampaignClaimIncludeRelation, CampaignIncludeRelation, SortOrder } from '@explorins/pers-shared';
 import type { CampaignClaimFilters } from '@explorins/pers-sdk/campaign';
 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 declare const useCampaigns: () => {
-    getActiveCampaigns: () => Promise<PaginatedResponseDTO<CampaignDTO>>;
+    getActiveCampaigns: (options?: GetCampaignsOptions) => Promise<PaginatedResponseDTO<CampaignDTO>>;
     getCampaignById: (campaignId: string, include?: CampaignIncludeRelation[]) => Promise<CampaignDTO | null>;
     claimCampaign: (request: CampaignClaimRequestDTO) => Promise<CampaignClaimDTO | null>;
     getUserClaims: (options?: {
@@ -11,7 +30,9 @@ export declare const useCampaigns: () => {
         include?: CampaignClaimIncludeRelation[];
     }) => Promise<PaginatedResponseDTO<CampaignClaimDTO>>;
     getCampaignTriggers: () => Promise<PaginatedResponseDTO<CampaignTriggerDTO>>;
-    getAllCampaigns: (active?: boolean) => Promise<PaginatedResponseDTO<CampaignDTO>>;
+    getAllCampaigns: (options?: GetCampaignsOptions & {
+        active?: boolean;
+    }) => Promise<PaginatedResponseDTO<CampaignDTO>>;
     getCampaignClaims: (filters?: CampaignClaimFilters, include?: CampaignClaimIncludeRelation[]) => Promise<PaginatedResponseDTO<CampaignClaimDTO>>;
     getCampaignClaimsByUserId: (userId: string, include?: CampaignClaimIncludeRelation[]) => Promise<PaginatedResponseDTO<CampaignClaimDTO>>;
     getCampaignClaimsByBusinessId: (businessId: string, include?: CampaignClaimIncludeRelation[]) => Promise<PaginatedResponseDTO<CampaignClaimDTO>>;

package/dist/hooks/useCampaigns.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCampaigns.d.ts","sourceRoot":"","sources":["../../src/hooks/useCampaigns.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,uBAAuB,EACvB,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAGzE,YAAY,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEzE,eAAO,MAAM,YAAY;8BAG0B,QAAQ,qBAAqB,WAAW,CAAC,CAAC;kCA6B7E,MAAM,YACR,uBAAuB,EAAE,KAClC,QAAQ,WAAW,GAAG,IAAI,CAAC;6BAcoB,uBAAuB,KAAG,QAAQ,gBAAgB,GAAG,IAAI,CAAC;8BAmCzD;QACjD,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,4BAA4B,EAAE,CAAC;KAC1C,KAAG,QAAQ,qBAAqB,gBAAgB,CAAC,CAAC;+BAkBD,QAAQ,qBAAqB,kBAAkB,CAAC,CAAC;+BAe/C,OAAO,KAAG,QAAQ,qBAAqB,WAAW,CAAC,CAAC;kCA+B5F,oBAAoB,YACpB,4BAA4B,EAAE,KACvC,QAAQ,qBAAqB,gBAAgB,CAAC,CAAC;wCAsBxC,MAAM,YACJ,4BAA4B,EAAE,KACvC,QAAQ,qBAAqB,gBAAgB,CAAC,CAAC;gDAsBpC,MAAM,YACR,4BAA4B,EAAE,KACvC,QAAQ,qBAAqB,gBAAgB,CAAC,CAAC;sCA4CpC,MAAM,mBACD,MAAM,KACtB,QAAQ,WAAW,CAAC;sCA4BT,MAAM,mBACD,MAAM,KACtB,QAAQ,WAAW,CAAC;;CA+BxB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC"}
+{"version":3,"file":"useCampaigns.d.ts","sourceRoot":"","sources":["../../src/hooks/useCampaigns.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,uBAAuB,EACvB,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,SAAS,EACV,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAGzE,YAAY,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,oBAAoB;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,CAAC;IAC5C,iBAAiB;IACjB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,uBAAuB,EAAE,CAAC;CACrC;AAED,eAAO,MAAM,YAAY;mCA6BX,mBAAmB,KAC5B,QAAQ,qBAAqB,WAAW,CAAC,CAAC;kCAgC/B,MAAM,YACR,uBAAuB,EAAE,KAClC,QAAQ,WAAW,GAAG,IAAI,CAAC;6BAcoB,uBAAuB,KAAG,QAAQ,gBAAgB,GAAG,IAAI,CAAC;8BAmCzD;QACjD,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,4BAA4B,EAAE,CAAC;KAC1C,KAAG,QAAQ,qBAAqB,gBAAgB,CAAC,CAAC;+BAkBD,QAAQ,qBAAqB,kBAAkB,CAAC,CAAC;gCA0CvF,mBAAmB,GAAG;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KACnD,QAAQ,qBAAqB,WAAW,CAAC,CAAC;kCA+BjC,oBAAoB,YACpB,4BAA4B,EAAE,KACvC,QAAQ,qBAAqB,gBAAgB,CAAC,CAAC;wCAsBxC,MAAM,YACJ,4BAA4B,EAAE,KACvC,QAAQ,qBAAqB,gBAAgB,CAAC,CAAC;gDAsBpC,MAAM,YACR,4BAA4B,EAAE,KACvC,QAAQ,qBAAqB,gBAAgB,CAAC,CAAC;sCA4CpC,MAAM,mBACD,MAAM,KACtB,QAAQ,WAAW,CAAC;sCA4BT,MAAM,mBACD,MAAM,KACtB,QAAQ,WAAW,CAAC;;CA+BxB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/hooks/useCampaigns.js

@@ -2,12 +2,40 @@ import { useCallback } from 'react';
 import { usePersSDK } from '../providers/PersSDKProvider';
 export const useCampaigns = () => {
     const { sdk, isInitialized, isAuthenticated } = usePersSDK();
-    const getActiveCampaigns = useCallback(async () => {
+    /**
+     * 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) => {
         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) {
@@ -107,12 +135,38 @@ export const useCampaigns = () => {
         }
     }, [sdk, isInitialized]);
     // Admin methods
-    const getAllCampaigns = useCallback(async (active) => {
+    /**
+     * 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) => {
         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) {

package/dist/hooks/useTokenBalances.d.ts

@@ -29,7 +29,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.)
@@ -120,18 +124,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({

package/dist/hooks/useTokenBalances.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useTokenBalances.d.ts","sourceRoot":"","sources":["../../src/hooks/useTokenBalances.ts"],"names":[],"mappings":"AAGA,OAAO,EAAoB,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAuB,MAAM,0BAA0B,CAAC;AAElF;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,uCAAuC;IACvC,YAAY,EAAE,YAAY,CAAC;IAC3B,8DAA8D;IAC9D,KAAK,EAAE,QAAQ,CAAC;IAChB,8EAA8E;IAC9E,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,eAAe,CAAC,EAAE,QAAQ,EAAE,CAAC;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+DAA+D;IAC/D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,0DAA0D;IAC1D,aAAa,EAAE,qBAAqB,EAAE,CAAC;IACvC,6CAA6C;IAC7C,SAAS,EAAE,OAAO,CAAC;IACnB,sCAAsC;IACtC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,uCAAuC;IACvC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,sFAAsF;IACtF,WAAW,EAAE,OAAO,CAAC;IACrB,0CAA0C;IAC1C,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CAgMzF"}
+{"version":3,"file":"useTokenBalances.d.ts","sourceRoot":"","sources":["../../src/hooks/useTokenBalances.ts"],"names":[],"mappings":"AAGA,OAAO,EAAoB,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAuB,MAAM,0BAA0B,CAAC;AAElF;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,uCAAuC;IACvC,YAAY,EAAE,YAAY,CAAC;IAC3B,8DAA8D;IAC9D,KAAK,EAAE,QAAQ,CAAC;IAChB,8EAA8E;IAC9E,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,eAAe,CAAC,EAAE,QAAQ,EAAE,CAAC;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,0DAA0D;IAC1D,aAAa,EAAE,qBAAqB,EAAE,CAAC;IACvC,6CAA6C;IAC7C,SAAS,EAAE,OAAO,CAAC;IACnB,sCAAsC;IACtC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,uCAAuC;IACvC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,sFAAsF;IACtF,WAAW,EAAE,OAAO,CAAC;IACrB,0CAA0C;IAC1C,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuFG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CAqLzF"}

package/dist/hooks/useTokenBalances.js

@@ -61,18 +61,7 @@ import { NativeTokenTypes } from '@explorins/pers-shared';
  * ```
  *
  * @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({
@@ -207,28 +196,18 @@ export function useTokenBalances(options) {
             loadBalances();
         }
     }, [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)
+        if (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'] });
-        // 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.)
     // Debouncing prevents excessive API calls during rapid events