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

package/package.json

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

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);