@explorins/pers-sdk-react-native 2.1.8 → 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/index.js

@@ -41248,12 +41248,40 @@ const useBusiness = () => {
 
 const useCampaigns = () => {
     const { sdk, isInitialized, isAuthenticated } = usePersSDK();
-    const getActiveCampaigns = react.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 = react.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) {
@@ -41353,12 +41381,38 @@ const useCampaigns = () => {
         }
     }, [sdk, isInitialized]);
     // Admin methods
-    const getAllCampaigns = react.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 = react.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) {