@explorins/pers-sdk 1.0.0-alpha.1 → 1.1.2

package/src/campaign/api/campaign-api.ts

@@ -0,0 +1,376 @@
+import { PersApiClient } from '../../core/pers-api-client';
+import { 
+  CampaignDTO,
+  CampaignCreateRequestDTO,
+  CampaignUserClaimDTO,
+  CampaignClaimRequestDTO,
+  CampaignTriggerDTO,
+  CampaignBusinessEngagementCreateRequestDTO,
+  TokenUnitCreateRequestDTO,
+} from '../../shared/interfaces/pers-shared-lib.interfaces';
+
+/**
+ * Platform-Agnostic Campaign API Client (NEW - RESTful Design)
+ * 
+ * Updated to use the new microservice-ready campaign controllers:
+ * - CampaignsController: Core campaign operations
+ * - CampaignTagsController: Tag management
+ * - CampaignTokensController: Token unit operations
+ * - CampaignTriggersController: Trigger system
+ * - CampaignEngagementsController: Business relationships
+ * - CampaignClaimsController: Claims processing
+ * 
+ * Uses @explorins/pers-shared DTOs for consistency with backend.
+ * All endpoints updated to new RESTful patterns without role revelation.
+ */
+export class CampaignApi {
+  constructor(private apiClient: PersApiClient) {}
+
+  // ==========================================
+  // CORE CAMPAIGN OPERATIONS (/campaigns)
+  // ==========================================
+
+  /**
+   * PUBLIC: Get all active campaigns
+   * NEW: /campaigns (intelligent access detection)
+   */
+  async getActiveCampaigns(): Promise<CampaignDTO[]> {
+    return this.apiClient.get<CampaignDTO[]>('/campaigns');
+  }
+
+  /**
+   * ADMIN: Get campaigns with filtering options
+   * NEW: /campaigns with query parameters (admin access detected automatically)
+   */
+  async getCampaigns(options?: {
+    active?: boolean;
+    tag?: string;
+    limit?: number;
+    offset?: number;
+    sort?: 'name' | 'createdAt' | 'startDate';
+    order?: 'ASC' | 'DESC';
+  }): Promise<CampaignDTO[]> {
+    let url = '/campaigns';
+    const params: string[] = [];
+    
+    if (options) {
+      if (options.active !== undefined) params.push(`active=${options.active}`);
+      if (options.tag) params.push(`tag=${encodeURIComponent(options.tag)}`);
+      if (options.limit) params.push(`limit=${options.limit}`);
+      if (options.offset) params.push(`offset=${options.offset}`);
+      if (options.sort) params.push(`sort=${options.sort}`);
+      if (options.order) params.push(`order=${options.order}`);
+    }
+    
+    if (params.length > 0) {
+      url += `?${params.join('&')}`;
+    }
+    
+    return this.apiClient.get<CampaignDTO[]>(url);
+  }
+
+  /**
+   * PUBLIC: Get campaign by ID
+   * NEW: /campaigns/{id}
+   */
+  async getCampaignById(id: string): Promise<CampaignDTO> {
+    return this.apiClient.get<CampaignDTO>(`/campaigns/${id}`);
+  }
+
+  /**
+   * ADMIN: Create campaign
+   * NEW: POST /campaigns
+   */
+  async createCampaign(campaign: CampaignCreateRequestDTO): Promise<CampaignDTO> {
+    return this.apiClient.post<CampaignDTO>('/campaigns', campaign);
+  }
+
+  /**
+   * ADMIN: Update campaign
+   * NEW: PUT /campaigns/{id}
+   */
+  async updateCampaign(campaignId: string, campaign: CampaignCreateRequestDTO): Promise<CampaignDTO> {
+    return this.apiClient.put<CampaignDTO>(`/campaigns/${campaignId}`, campaign);
+  }
+
+  /**
+   * ADMIN: Toggle campaign active status
+   * NEW: PUT /campaigns/{id}/status
+   */
+  async toggleCampaignActive(campaignId: string): Promise<CampaignDTO> {
+    return this.apiClient.put<CampaignDTO>(`/campaigns/${campaignId}/status`, {});
+  }
+
+  /**
+   * ADMIN: Toggle campaign testnet environment
+   * NEW: PUT /campaigns/{id}/environment
+   */
+  async toggleCampaignTestnet(campaignId: string): Promise<CampaignDTO> {
+    return this.apiClient.put<CampaignDTO>(`/campaigns/${campaignId}/environment`, {});
+  }
+
+  /**
+   * ADMIN: Delete campaign
+   * NEW: DELETE /campaigns/{id}
+   */
+  async deleteCampaign(campaignId: string): Promise<boolean> {
+    return this.apiClient.delete<boolean>(`/campaigns/${campaignId}`);
+  }
+
+  // ==========================================
+  // TAG MANAGEMENT (/campaign-tags)
+  // ==========================================
+
+  /**
+   * ADMIN: Get all unique campaign tags
+   * NEW: GET /campaign-tags
+   */
+  async getAllUniqueTags(): Promise<string[]> {
+    return this.apiClient.get<string[]>('/campaign-tags');
+  }
+
+  /**
+   * ADMIN: Update campaign tags (replace all)
+   * NEW: PUT /campaign-tags/{id}
+   */
+  async updateCampaignTags(campaignId: string, tags: string[]): Promise<CampaignDTO> {
+    return this.apiClient.put<CampaignDTO>(`/campaign-tags/${campaignId}`, { tags });
+  }
+
+  /**
+   * ADMIN: Add tags to campaign
+   * NEW: POST /campaign-tags/{id}
+   */
+  async addTagsToCampaign(campaignId: string, tags: string[]): Promise<CampaignDTO> {
+    return this.apiClient.post<CampaignDTO>(`/campaign-tags/${campaignId}`, { tags });
+  }
+
+  /**
+   * ADMIN: Remove tag from campaign
+   * NEW: DELETE /campaign-tags/{id}/{tag}
+   */
+  async removeTagFromCampaign(campaignId: string, tag: string): Promise<CampaignDTO> {
+    return this.apiClient.delete<CampaignDTO>(`/campaign-tags/${campaignId}/${encodeURIComponent(tag)}`);
+  }
+
+  // ==========================================
+  // TOKEN MANAGEMENT (/campaign-tokens)
+  // ==========================================
+
+  /**
+   * ADMIN: Create campaign token unit
+   * NEW: POST /campaign-tokens/{id}
+   */
+  async createCampaignTokenUnit(campaignId: string, campaignTokenUnit: TokenUnitCreateRequestDTO): Promise<CampaignDTO> {
+    return this.apiClient.post<CampaignDTO>(`/campaign-tokens/${campaignId}`, campaignTokenUnit);
+  }
+
+  /**
+   * ADMIN: Update campaign token unit
+   * NEW: PUT /campaign-tokens/{id}/{tokenUnitId}
+   */
+  async updateCampaignTokenUnit(campaignId: string, tokenUnitId: string, campaignTokenUnit: TokenUnitCreateRequestDTO): Promise<CampaignDTO> {
+    return this.apiClient.put<CampaignDTO>(`/campaign-tokens/${campaignId}/${tokenUnitId}`, campaignTokenUnit);
+  }
+
+  /**
+   * ADMIN: Delete campaign token unit
+   * NEW: DELETE /campaign-tokens/{id}/{tokenUnitId}
+   */
+  async deleteCampaignTokenUnit(campaignId: string, campaignTokenUnitId: string): Promise<CampaignDTO> {
+    return this.apiClient.delete<CampaignDTO>(`/campaign-tokens/${campaignId}/${campaignTokenUnitId}`);
+  }
+
+  // ==========================================
+  // TRIGGER SYSTEM (/campaign-triggers)
+  // ==========================================
+
+  /**
+   * PUBLIC: Get campaign triggers catalog
+   * NEW: GET /campaign-triggers
+   */
+  async getCampaignTriggers(): Promise<CampaignTriggerDTO[]> {
+    return this.apiClient.get<CampaignTriggerDTO[]>('/campaign-triggers');
+  }
+
+  /**
+   * ADMIN: Create campaign trigger
+   * NEW: POST /campaign-triggers
+   */
+  async createCampaignTrigger(trigger: any): Promise<CampaignTriggerDTO> {
+    return this.apiClient.post<CampaignTriggerDTO>('/campaign-triggers', trigger);
+  }
+
+  /**
+   * ADMIN: Update campaign trigger
+   * NEW: PUT /campaign-triggers/{id}
+   */
+  async updateCampaignTrigger(triggerId: string, trigger: any): Promise<CampaignTriggerDTO> {
+    return this.apiClient.put<CampaignTriggerDTO>(`/campaign-triggers/${triggerId}`, trigger);
+  }
+
+  /**
+   * ADMIN: Delete campaign trigger
+   * NEW: DELETE /campaign-triggers/{id}
+   */
+  async deleteCampaignTrigger(triggerId: string): Promise<boolean> {
+    return this.apiClient.delete<boolean>(`/campaign-triggers/${triggerId}`);
+  }
+
+  /**
+   * ADMIN: Set campaign trigger
+   * NEW: PUT /campaign-triggers/campaigns/{id}/trigger/{triggerId}
+   */
+  async setCampaignTrigger(campaignId: string, triggerId: string): Promise<CampaignDTO> {
+    return this.apiClient.put<CampaignDTO>(`/campaign-triggers/campaigns/${campaignId}/trigger/${triggerId}`, {});
+  }
+
+  /**
+   * ADMIN: Create trigger condition
+   * NEW: POST /campaign-triggers/conditions
+   */
+  async createTriggerCondition(condition: any): Promise<any> {
+    return this.apiClient.post<any>('/campaign-triggers/conditions', condition);
+  }
+
+  /**
+   * ADMIN: Update trigger condition
+   * NEW: PUT /campaign-triggers/conditions/{id}
+   */
+  async updateTriggerCondition(conditionId: string, condition: any): Promise<any> {
+    return this.apiClient.put<any>(`/campaign-triggers/conditions/${conditionId}`, condition);
+  }
+
+  /**
+   * ADMIN: Add/Remove condition to trigger
+   * NEW: PUT /campaign-triggers/{triggerId}/condition/{conditionId}
+   */
+  async addOrRemoveConditionToTrigger(triggerId: string, conditionId: string): Promise<CampaignTriggerDTO> {
+    return this.apiClient.put<CampaignTriggerDTO>(`/campaign-triggers/${triggerId}/condition/${conditionId}`, {});
+  }
+
+  // ==========================================
+  // BUSINESS ENGAGEMENTS (/campaign-engagements)
+  // ==========================================
+
+  /**
+   * ADMIN: Add business engagement to campaign
+   * NEW: POST /campaign-engagements/{id}
+   */
+  async addBusinessEngagementToCampaign(campaignId: string, campaignBusinessEngagement: CampaignBusinessEngagementCreateRequestDTO): Promise<CampaignDTO> {
+    return this.apiClient.post<CampaignDTO>(`/campaign-engagements/${campaignId}`, campaignBusinessEngagement);
+  }
+
+  /**
+   * ADMIN: Update campaign business engagement
+   * NEW: PUT /campaign-engagements/{id}/{businessEngagementId}
+   */
+  async updateCampaignBusinessEngagement(campaignId: string, businessEngagementId: string, campaignBusinessEngagement: CampaignBusinessEngagementCreateRequestDTO): Promise<CampaignDTO> {
+    return this.apiClient.put<CampaignDTO>(`/campaign-engagements/${campaignId}/${businessEngagementId}`, campaignBusinessEngagement);
+  }
+
+  /**
+   * ADMIN: Delete campaign business engagement
+   * NEW: DELETE /campaign-engagements/{id}/{businessEngagementId}
+   */
+  async deleteCampaignBusinessEngagement(campaignId: string, businessEngagementId: string): Promise<CampaignDTO> {
+    return this.apiClient.delete<CampaignDTO>(`/campaign-engagements/${campaignId}/${businessEngagementId}`);
+  }
+
+  // ==========================================
+  // CLAIMS PROCESSING (/campaign-claims)
+  // ==========================================
+
+  /**
+   * USER: Claim campaign reward
+   * NEW: POST /campaign-claims/user
+   */
+  async claimCampaign(request: CampaignClaimRequestDTO): Promise<CampaignUserClaimDTO> {
+    return this.apiClient.post<CampaignUserClaimDTO>('/campaign-claims/user', request);
+  }
+
+  /**
+   * USER: Get claims for logged user
+   * NEW: GET /campaign-claims/users/me
+   */
+  async getClaimsForLoggedUser(): Promise<CampaignUserClaimDTO[]> {
+    return this.apiClient.get<CampaignUserClaimDTO[]>('/campaign-claims/users/me');
+  }
+
+  /**
+   * BUSINESS: Claim campaign reward for customer
+   * NEW: POST /campaign-claims/business
+   */
+  async businessClaimCampaign(request: any): Promise<CampaignUserClaimDTO> {
+    return this.apiClient.post<CampaignUserClaimDTO>('/campaign-claims/business', request);
+  }
+
+  /**
+   * SYSTEM: Process automated claim
+   * NEW: POST /campaign-claims/system
+   */
+  async systemClaimCampaign(request: any): Promise<CampaignUserClaimDTO> {
+    return this.apiClient.post<CampaignUserClaimDTO>('/campaign-claims/system', request);
+  }
+
+  /**
+   * ADMIN: Manual claim processing
+   * NEW: POST /campaign-claims/admin
+   */
+  async adminClaimCampaign(request: any): Promise<CampaignUserClaimDTO> {
+    return this.apiClient.post<CampaignUserClaimDTO>('/campaign-claims/admin', request);
+  }
+
+  /**
+   * ADMIN: Get all campaign claims
+   * NEW: GET /campaign-claims/admin
+   */
+  async getCampaignClaims(): Promise<CampaignUserClaimDTO[]> {
+    return this.apiClient.get<CampaignUserClaimDTO[]>('/campaign-claims/admin');
+  }
+
+  /**
+   * ADMIN: Get campaign claims by campaign ID
+   * NEW: GET /campaign-claims/admin/{campaignId}
+   */
+  async getCampaignClaimsByCampaignId(campaignId: string): Promise<CampaignUserClaimDTO[]> {
+    return this.apiClient.get<CampaignUserClaimDTO[]>(`/campaign-claims/admin/${campaignId}`);
+  }
+
+  /**
+   * ADMIN: Get campaign claims by user ID
+   * NEW: GET /campaign-claims/admin/users/{userId}
+   */
+  async getCampaignClaimsByUserId(userId: string): Promise<CampaignUserClaimDTO[]> {
+    return this.apiClient.get<CampaignUserClaimDTO[]>(`/campaign-claims/admin/users/${userId}`);
+  }
+
+  /**
+   * ADMIN: Get campaign claims by business ID
+   * NEW: GET /campaign-claims/admin/businesses/{businessId}
+   */
+  async getCampaignClaimsByBusinessId(businessId: string): Promise<CampaignUserClaimDTO[]> {
+    return this.apiClient.get<CampaignUserClaimDTO[]>(`/campaign-claims/admin/businesses/${businessId}`);
+  }
+
+  /**
+   * USER: Get user's claims for specific campaign
+   * NEW: GET /campaign-claims/campaigns/{campaignId}/users/me
+   */
+  async getUserClaimsForCampaign(campaignId: string): Promise<CampaignUserClaimDTO[]> {
+    return this.apiClient.get<CampaignUserClaimDTO[]>(`/campaign-claims/campaigns/${campaignId}/users/me`);
+  }
+
+  // ==========================================
+  // BACKWARD COMPATIBILITY (DEPRECATED)
+  // ==========================================
+
+  /**
+   * @deprecated Use getCampaigns() instead
+   * LEGACY: Get campaigns with active filter
+   */
+  async getCampaignsLegacy(active?: boolean): Promise<CampaignDTO[]> {
+    console.warn('CampaignApi.getCampaignsLegacy() is deprecated. Use getCampaigns() instead.');
+    return this.getCampaigns(active !== undefined ? { active } : undefined);
+  }
+}

package/src/campaign/index.ts

@@ -0,0 +1,67 @@
+/**
+ * @explorins/pers-sdk-campaign
+ * 
+ * Platform-agnostic Campaign Domain SDK for PERS ecosystem
+ * Handles campaign operations across different authorization levels
+ */
+
+// API Layer
+export { CampaignApi } from './api/campaign-api';
+
+// Service Layer  
+export { CampaignService } from './services/campaign-service';
+
+// Models & Types - re-export all centralized interfaces
+export * from '../shared/interfaces/pers-shared-lib.interfaces';
+
+// Factory function for creating campaign SDK instance
+import { PersApiClient } from '../core/pers-api-client';
+import { CampaignApi } from './api/campaign-api';
+import { CampaignService } from './services/campaign-service';
+import { CampaignClaimRequestDTO, CampaignCreateRequestDTO, TokenUnitCreateRequestDTO, CampaignBusinessEngagementCreateRequestDTO } from '../shared/interfaces/pers-shared-lib.interfaces';
+
+/**
+ * Create a complete Campaign SDK instance
+ * 
+ * @param apiClient - Configured PERS API client
+ * @returns Campaign SDK with flattened structure for better DX
+ */
+export function createCampaignSDK(apiClient: PersApiClient) {
+  const campaignApi = new CampaignApi(apiClient);
+  const campaignService = new CampaignService(campaignApi);
+  
+  return {
+    // Direct access to service methods (primary interface)
+    
+    // Public methods
+    getActiveCampaigns: () => campaignService.getActiveCampaigns(),
+    getCampaignById: (id: string) => campaignService.getCampaignById(id),
+    
+    // Auth methods
+    claimCampaign: (request: CampaignClaimRequestDTO) => campaignService.claimCampaign(request),
+    getClaimsForLoggedUser: () => campaignService.getClaimsForLoggedUser(),
+    
+    // Admin methods
+    getCampaigns: (active?: boolean) => campaignService.getCampaigns(active),
+    getCampaignTriggers: () => campaignService.getCampaignTriggers(),
+    toggleCampaignActive: (campaignId: string) => campaignService.toggleCampaignActive(campaignId),
+    toggleCampaignTestnet: (campaignId: string) => campaignService.toggleCampaignTestnet(campaignId),
+    createCampaign: (campaign: CampaignCreateRequestDTO) => campaignService.createCampaign(campaign),
+    setCampaignTrigger: (campaignId: string, triggerId: string) => campaignService.setCampaignTrigger(campaignId, triggerId),
+    updateCampaign: (campaignId: string, campaign: CampaignCreateRequestDTO) => campaignService.updateCampaign(campaignId, campaign),
+    createCampaignTokenUnit: (campaignId: string, campaignTokenUnit: TokenUnitCreateRequestDTO) => campaignService.createCampaignTokenUnit(campaignId, campaignTokenUnit),
+    deleteCampaignTokenUnit: (campaignId: string, campaignTokenUnitId: string) => campaignService.deleteCampaignTokenUnit(campaignId, campaignTokenUnitId),
+    addBusinessEngagementToCampaign: (campaignId: string, campaignBusinessEngagement: CampaignBusinessEngagementCreateRequestDTO) => campaignService.addBusinessEngagementToCampaign(campaignId, campaignBusinessEngagement),
+    updateCampaignBusinessEngagement: (campaignId: string, businessEngagementId: string, campaignBusinessEngagement: CampaignBusinessEngagementCreateRequestDTO) => campaignService.updateCampaignBusinessEngagement(campaignId, businessEngagementId, campaignBusinessEngagement),
+    deleteCampaignBusinessEngagement: (campaignId: string, businessEngagementId: string) => campaignService.deleteCampaignBusinessEngagement(campaignId, businessEngagementId),
+    getCampaignClaims: () => campaignService.getCampaignClaims(),
+    getCampaignClaimsByUserId: (userId: string) => campaignService.getCampaignClaimsByUserId(userId),
+    getCampaignClaimsByBusinessId: (businessId: string) => campaignService.getCampaignClaimsByBusinessId(businessId),
+    
+    // Advanced access for edge cases
+    api: campaignApi,
+    service: campaignService
+  };
+}
+
+export type CampaignSDK = ReturnType<typeof createCampaignSDK>;

package/src/campaign/services/campaign-service.ts

@@ -0,0 +1,164 @@
+import { CampaignApi } from '../api/campaign-api';
+import { 
+  CampaignDTO,
+  CampaignCreateRequestDTO,
+  CampaignUserClaimDTO,
+  CampaignClaimRequestDTO,
+  CampaignTriggerDTO,
+  TokenUnitCreateRequestDTO,
+  CampaignBusinessEngagementCreateRequestDTO
+} from '../../shared/interfaces/pers-shared-lib.interfaces';
+
+/**
+ * Platform-Agnostic Campaign Service
+ * 
+ * Contains campaign business logic and operations that work across platforms.
+ * No framework dependencies - pure TypeScript business logic.
+ * 
+ * Focuses only on actual backend capabilities.
+ */
+export class CampaignService {
+  constructor(private campaignApi: CampaignApi) {}
+
+  // ==========================================
+  // PUBLIC OPERATIONS
+  // ==========================================
+
+  /**
+   * PUBLIC: Get all active campaigns
+   */
+  async getActiveCampaigns(): Promise<CampaignDTO[]> {
+    return this.campaignApi.getActiveCampaigns();
+  }
+
+  /**
+   * PUBLIC: Get campaign by ID
+   */
+  async getCampaignById(id: string): Promise<CampaignDTO> {
+    return this.campaignApi.getCampaignById(id);
+  }
+
+  // ==========================================
+  // AUTHENTICATED OPERATIONS
+  // ==========================================
+
+  /**
+   * AUTH: Claim campaign
+   */
+  async claimCampaign(request: CampaignClaimRequestDTO): Promise<CampaignUserClaimDTO> {
+    return this.campaignApi.claimCampaign(request);
+  }
+
+  /**
+   * AUTH: Get claims for logged user
+   */
+  async getClaimsForLoggedUser(): Promise<CampaignUserClaimDTO[]> {
+    return this.campaignApi.getClaimsForLoggedUser();
+  }
+
+  // ==========================================
+  // ADMIN OPERATIONS
+  // ==========================================
+
+  /**
+   * ADMIN: Get campaigns with optional active filter
+   */
+  async getCampaigns(active?: boolean): Promise<CampaignDTO[]> {
+    return this.campaignApi.getCampaigns(active !== undefined ? { active } : undefined);
+  }
+
+  /**
+   * ADMIN: Get campaign triggers
+   */
+  async getCampaignTriggers(): Promise<CampaignTriggerDTO[]> {
+    return this.campaignApi.getCampaignTriggers();
+  }
+
+  /**
+   * ADMIN: Toggle campaign active status
+   */
+  async toggleCampaignActive(campaignId: string): Promise<CampaignDTO> {
+    return this.campaignApi.toggleCampaignActive(campaignId);
+  }
+
+  /**
+   * ADMIN: Toggle campaign testnet environment
+   */
+  async toggleCampaignTestnet(campaignId: string): Promise<CampaignDTO> {
+    return this.campaignApi.toggleCampaignTestnet(campaignId);
+  }
+
+  /**
+   * ADMIN: Create campaign
+   */
+  async createCampaign(campaign: CampaignCreateRequestDTO): Promise<CampaignDTO> {
+    return this.campaignApi.createCampaign(campaign);
+  }
+
+  /**
+   * ADMIN: Set campaign trigger
+   */
+  async setCampaignTrigger(campaignId: string, triggerId: string): Promise<CampaignDTO> {
+    return this.campaignApi.setCampaignTrigger(campaignId, triggerId);
+  }
+
+  /**
+   * ADMIN: Update campaign
+   */
+  async updateCampaign(campaignId: string, campaign: CampaignCreateRequestDTO): Promise<CampaignDTO> {
+    return this.campaignApi.updateCampaign(campaignId, campaign);
+  }
+
+  /**
+   * ADMIN: Create campaign token unit
+   */
+  async createCampaignTokenUnit(campaignId: string, campaignTokenUnit: TokenUnitCreateRequestDTO): Promise<CampaignDTO> {
+    return this.campaignApi.createCampaignTokenUnit(campaignId, campaignTokenUnit);
+  }
+
+  /**
+   * ADMIN: Delete campaign token unit
+   */
+  async deleteCampaignTokenUnit(campaignId: string, campaignTokenUnitId: string): Promise<CampaignDTO> {
+    return this.campaignApi.deleteCampaignTokenUnit(campaignId, campaignTokenUnitId);
+  }
+
+  /**
+   * ADMIN: Add business engagement to campaign
+   */
+  async addBusinessEngagementToCampaign(campaignId: string, campaignBusinessEngagement: CampaignBusinessEngagementCreateRequestDTO): Promise<CampaignDTO> {
+    return this.campaignApi.addBusinessEngagementToCampaign(campaignId, campaignBusinessEngagement);
+  }
+
+  /**
+   * ADMIN: Update campaign business engagement
+   */
+  async updateCampaignBusinessEngagement(campaignId: string, businessEngagementId: string, campaignBusinessEngagement: CampaignBusinessEngagementCreateRequestDTO): Promise<CampaignDTO> {
+    return this.campaignApi.updateCampaignBusinessEngagement(campaignId, businessEngagementId, campaignBusinessEngagement);
+  }
+
+  async deleteCampaignBusinessEngagement(campaignId: string, businessEngagementId: string): Promise<CampaignDTO> {
+    return this.campaignApi.deleteCampaignBusinessEngagement(campaignId, businessEngagementId);
+  }
+
+  /**
+   * ADMIN: Get all campaign claims
+   */
+  async getCampaignClaims(): Promise<CampaignUserClaimDTO[]> {
+    return this.campaignApi.getCampaignClaims();
+  }
+
+  /**
+   * ADMIN: Get campaign claims by user ID
+   */
+  async getCampaignClaimsByUserId(userId: string): Promise<CampaignUserClaimDTO[]> {
+    return this.campaignApi.getCampaignClaimsByUserId(userId);
+  }
+
+  /**
+   * ADMIN: Get campaign claims by business ID
+   */
+  async getCampaignClaimsByBusinessId(businessId: string): Promise<CampaignUserClaimDTO[]> {
+    return this.campaignApi.getCampaignClaimsByBusinessId(businessId);
+  }
+}

package/src/core/abstractions/http-client.ts

@@ -14,6 +14,7 @@ export interface RequestOptions {
   headers?: Record<string, string>;
   params?: Record<string, string>;
   timeout?: number;
+  responseType?: 'json' | 'blob' | 'text' | 'arraybuffer'; 
 }
 
 export interface HttpResponse<T> {

package/src/core/auth/auth-provider.interface.ts

@@ -1,11 +1,11 @@
-export interface AuthProvider {
+export interface PersAuthProvider {
   getToken(): Promise<string | null>;
   getProjectKey(): Promise<string | null>;
   authType: 'admin' | 'user' | 'firebase';
   onTokenExpired?: () => Promise<void>;
 }
 
-export interface RequestOptions {
+export interface PersRequestOptions {
   headers?: Record<string, string>;
 }
 

package/src/core/auth/create-auth-provider.ts

@@ -1,4 +1,4 @@
-import { AuthProvider } from './auth-provider.interface';
+import { PersAuthProvider } from './auth-provider.interface';
 import { SimpleAuthConfig } from './simple-auth-config.interface';
 
 /**
@@ -16,7 +16,7 @@ import { SimpleAuthConfig } from './simple-auth-config.interface';
  * @param config - Simple auth configuration
  * @returns AuthProvider implementation
  */
-export function createAuthProvider(config: SimpleAuthConfig): AuthProvider {
+export function createAuthProvider(config: SimpleAuthConfig): PersAuthProvider {
   // Store current token for refresh scenarios and caching
   let currentToken: string | null = config.token || null;
   let isRefreshing = false; // Prevent concurrent refresh attempts
@@ -113,24 +113,24 @@ export function createAuthProvider(config: SimpleAuthConfig): AuthProvider {
  * Platform-specific localStorage token provider for browsers
  * This is a convenience function for browser environments
  */
-export function createBrowserTokenProvider(tokenKey: string = 'userJwt'): () => Promise<string | null> {
+/* export function createBrowserTokenProvider(tokenKey: string = 'userJwt'): () => Promise<string | null> {
   return async () => {
     if (typeof localStorage !== 'undefined') {
       return localStorage.getItem(tokenKey);
     }
     return null;
   };
-}
+} */
 
 /**
  * Platform-specific environment variable token provider for Node.js
  * This is a convenience function for Node.js environments
  */
-export function createNodeTokenProvider(envVar: string = 'JWT_TOKEN'): () => Promise<string | null> {
+/* export function createNodeTokenProvider(envVar: string = 'JWT_TOKEN'): () => Promise<string | null> {
   return async () => {
     if (typeof process !== 'undefined' && process.env) {
       return process.env[envVar] || null;
     }
     return null;
   };
-}
+} */