harvester_sdk 1.0.28 → 1.0.30

package/dist/sdk.js

@@ -127,7 +127,7 @@ class HarvesterSDK {
         const response = await this.client.get('/data', {
             params: queryParams,
         });
-        return response.data;
+        return response.data.data;
     }
     /**
      * Get data by region ID
@@ -208,7 +208,7 @@ class HarvesterSDK {
         const response = await this.client.get('/data/count', {
             params: queryParams,
         });
-        return response.data.data.count;
+        return response.data.data;
     }
     /**
      * Get data aggregated by a field

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harvester_sdk",
-  "version": "1.0.28",
+  "version": "1.0.30",
   "description": "SDK for interacting with the Harvester API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/sdk.ts

@@ -1,10 +1,5 @@
 import axios, { AxiosInstance, AxiosRequestConfig } from 'axios';
-import {
-  RegionType,
-  GeoType,
-  DataType,
-  platformsList,
-} from './types';
+import { RegionType, GeoType, DataType, platformsList } from './types';
 
 // SDK Configuration
 export interface HarvesterSDKConfig {
@@ -50,35 +45,35 @@ export interface GetDataParams extends PaginationParams {
   // Region filters
   region_id?: string;
   region_ids?: string[];
-  
+
   // Time filters
   time_range?: TimeRange;
   relative_time?: RelativeTimeRange;
-  
+
   // Platform filters
   platform?: Platform;
   platforms?: Platform[];
-  
+
   // Source filters
   source_id?: string;
   source_ids?: string[];
   source_group_id?: string;
-  
+
   // Geo filters
   data_geo?: string[];
   source_dominant_geos?: string[];
-  
+
   // Content filters
   data_original_type?: string;
   data_language?: string;
   data_sentiment?: 'positive' | 'negative' | 'neutral' | 'mixed';
-  
+
   // Text search
   search?: string;
-  
+
   // Processing status
   processing_status?: 'raw' | 'processed' | 'analyzed' | 'error';
-  
+
   // Include/exclude fields
   fields?: string[];
   exclude_fields?: string[];
@@ -106,20 +101,20 @@ export interface SDKResponse<T> {
 
 /**
  * Harvester SDK - Client for interacting with the Harvester API
- * 
+ *
  * @example
  * ```typescript
  * const harvester = new HarvesterSDK({
  *   baseUrl: 'https://api.harvester.io',
  *   apiKey: 'your-api-key'
  * });
- * 
+ *
  * // Get all regions
  * const regions = await harvester.getRegions();
- * 
+ *
  * // Get geos by region
  * const geos = await harvester.getGeosByRegion('region-id');
- * 
+ *
  * // Get data with filters
  * const data = await harvester.getData({
  *   region_id: 'region-id',
@@ -149,7 +144,11 @@ export class HarvesterSDK {
       (response) => response,
       (error) => {
         const message = error.response?.data?.message || error.message;
-        throw new HarvesterSDKError(message, error.response?.status, error.response?.data);
+        throw new HarvesterSDKError(
+          message,
+          error.response?.status,
+          error.response?.data
+        );
       }
     );
   }
@@ -176,19 +175,24 @@ export class HarvesterSDK {
 
   /**
    * Get all regions
-   * 
+   *
    * @param params - Optional filter and pagination parameters
    * @returns Paginated list of regions
-   * 
+   *
    * @example
    * ```typescript
    * const regions = await harvester.getRegions({ status: 'active' });
    * ```
    */
-  async getRegions(params?: GetRegionsParams): Promise<PaginatedResponse<RegionType>> {
-    const response = await this.client.get<PaginatedResponse<RegionType>>('/regions', {
-      params: this.buildQueryParams(params),
-    });
+  async getRegions(
+    params?: GetRegionsParams
+  ): Promise<PaginatedResponse<RegionType>> {
+    const response = await this.client.get<PaginatedResponse<RegionType>>(
+      '/regions',
+      {
+        params: this.buildQueryParams(params),
+      }
+    );
     return response.data;
   }
 
@@ -198,34 +202,39 @@ export class HarvesterSDK {
 
   /**
    * Get geographies by region ID
-   * 
+   *
    * @param regionId - The region ID
    * @param params - Optional pagination parameters
    * @returns Paginated list of geographies in the region
-   * 
+   *
    * @example
    * ```typescript
    * const geos = await harvester.getGeosByRegion('region-id', { limit: 50 });
    * ```
    */
-  async getGeosByRegion(regionId: string, params?: PaginationParams): Promise<PaginatedResponse<GeoType>> {
-    const response = await this.client.get<PaginatedResponse<GeoType>>(`/geo-selections/${regionId}`, {
-      params: this.buildQueryParams(params),
-    });
+  async getGeosByRegion(
+    regionId: string,
+    params?: PaginationParams
+  ): Promise<PaginatedResponse<GeoType>> {
+    const response = await this.client.get<PaginatedResponse<GeoType>>(
+      `/geo-selections/${regionId}`,
+      {
+        params: this.buildQueryParams(params),
+      }
+    );
     return response.data;
   }
 
-
   // ============================================
   // DATA
   // ============================================
 
   /**
    * Get data with filters
-   * 
+   *
    * @param params - Filter and pagination parameters
    * @returns Paginated list of data items
-   * 
+   *
    * @example
    * ```typescript
    * // Get telegram data from a specific region in the last 24 hours
@@ -238,52 +247,64 @@ export class HarvesterSDK {
    */
   async getData(params?: GetDataParams): Promise<PaginatedResponse<DataType>> {
     const queryParams = this.buildDataQueryParams(params);
-    const response = await this.client.get<PaginatedResponse<DataType>>('/data', {
-      params: queryParams,
-    });
-    return response.data;
+    const response = await this.client.get<{data: PaginatedResponse<DataType>}>(
+      '/data',
+      {
+        params: queryParams,
+      }
+    );
+    return response.data.data;
   }
 
   /**
    * Get data by region ID
-   * 
+   *
    * @param regionId - The region ID
    * @param params - Optional filter parameters
    * @returns Paginated list of data items from the region
    */
-  async getDataByRegion(regionId: string, params?: Omit<GetDataParams, 'region_id'>): Promise<PaginatedResponse<DataType>> {
+  async getDataByRegion(
+    regionId: string,
+    params?: Omit<GetDataParams, 'region_id'>
+  ): Promise<PaginatedResponse<DataType>> {
     return this.getData({ ...params, region_id: regionId });
   }
 
   /**
    * Get data by platform
-   * 
+   *
    * @param platform - The platform to filter by
    * @param params - Optional filter parameters
    * @returns Paginated list of data items from the platform
    */
-  async getDataByPlatform(platform: Platform, params?: Omit<GetDataParams, 'platform'>): Promise<PaginatedResponse<DataType>> {
+  async getDataByPlatform(
+    platform: Platform,
+    params?: Omit<GetDataParams, 'platform'>
+  ): Promise<PaginatedResponse<DataType>> {
     return this.getData({ ...params, platform });
   }
 
   /**
    * Get data within a time range
-   * 
+   *
    * @param timeRange - The time range (start and end timestamps)
    * @param params - Optional filter parameters
    * @returns Paginated list of data items within the time range
    */
-  async getDataByTimeRange(timeRange: TimeRange, params?: Omit<GetDataParams, 'time_range'>): Promise<PaginatedResponse<DataType>> {
+  async getDataByTimeRange(
+    timeRange: TimeRange,
+    params?: Omit<GetDataParams, 'time_range'>
+  ): Promise<PaginatedResponse<DataType>> {
     return this.getData({ ...params, time_range: timeRange });
   }
 
   /**
    * Get data from relative time (e.g., last 24 hours)
-   * 
+   *
    * @param relativeTime - Relative time specification
    * @param params - Optional filter parameters
    * @returns Paginated list of data items
-   * 
+   *
    * @example
    * ```typescript
    * const data = await harvester.getDataFromRelativeTime(
@@ -292,49 +313,57 @@ export class HarvesterSDK {
    * );
    * ```
    */
-  async getDataFromRelativeTime(relativeTime: RelativeTimeRange, params?: Omit<GetDataParams, 'relative_time'>): Promise<PaginatedResponse<DataType>> {
+  async getDataFromRelativeTime(
+    relativeTime: RelativeTimeRange,
+    params?: Omit<GetDataParams, 'relative_time'>
+  ): Promise<PaginatedResponse<DataType>> {
     return this.getData({ ...params, relative_time: relativeTime });
   }
 
   /**
    * Get a single data item by ID
-   * 
+   *
    * @param dataId - The data item ID
    * @returns The data object
    */
   async getDataById(dataId: string): Promise<DataType> {
-    const response = await this.client.get<SDKResponse<DataType>>(`/data/${dataId}`);
+    const response = await this.client.get<SDKResponse<DataType>>(
+      `/data/${dataId}`
+    );
     return response.data.data;
   }
 
   /**
    * Search data by text content
-   * 
+   *
    * @param query - Search query
    * @param params - Optional filter parameters
    * @returns Paginated list of matching data items
    */
-  async searchData(query: string, params?: GetDataParams): Promise<PaginatedResponse<DataType>> {
+  async searchData(
+    query: string,
+    params?: GetDataParams
+  ): Promise<PaginatedResponse<DataType>> {
     return this.getData({ ...params, search: query });
   }
 
   /**
    * Get data count by filters (without fetching all data)
-   * 
+   *
    * @param params - Filter parameters
    * @returns Count of matching data items
    */
   async getDataCount(params?: GetDataParams): Promise<number> {
     const queryParams = this.buildDataQueryParams(params);
-    const response = await this.client.get<SDKResponse<{ count: number }>>('/data/count', {
+    const response = await this.client.get<{ data: number }>('/data/count', {
       params: queryParams,
     });
-    return response.data.data.count;
+    return response.data.data;
   }
 
   /**
    * Get data aggregated by a field
-   * 
+   *
    * @param field - Field to aggregate by (e.g., 'platform', 'source_region_id')
    * @param params - Optional filter parameters
    * @returns Aggregation results
@@ -344,10 +373,9 @@ export class HarvesterSDK {
     params?: GetDataParams
   ): Promise<{ _id: string; count: number }[]> {
     const queryParams = this.buildDataQueryParams(params);
-    const response = await this.client.get<{ data: { _id: string; count: number }[] }>(
-      `/data/aggregate/${field}`,
-      { params: queryParams }
-    );
+    const response = await this.client.get<{
+      data: { _id: string; count: number }[];
+    }>(`/data/aggregate/${field}`, { params: queryParams });
     return response.data.data;
   }
 
@@ -379,7 +407,7 @@ export class HarvesterSDK {
    */
   private buildQueryParams(params?: Record<string, any>): Record<string, any> {
     if (!params) return {};
-    
+
     const cleaned: Record<string, any> = {};
     for (const [key, value] of Object.entries(params)) {
       if (value !== undefined && value !== null) {
@@ -480,10 +508,10 @@ export class HarvesterSDKError extends Error {
 
 /**
  * Create a new Harvester SDK instance
- * 
+ *
  * @param config - SDK configuration
  * @returns HarvesterSDK instance
- * 
+ *
  * @example
  * ```typescript
  * const harvester = createHarvesterSDK({