📰 Aevum News SDK

import { NewsClient, NewsCategory } from '@aevum/news-sdk';

// Initialize with your API key
const client = new NewsClient({
  apiKey: process.env.AEVUM_API_KEY,
  region: 'global',
  language: 'en',
  cache: true,  // Enable response caching
});

// Fetch top headlines
const headlines = await client.fetchArticles({
  category: NewsCategory.WORLD,
  pageSize: 10,
});

console.log(`Found ${headlines.total} articles`);
console.log(headlines.data[0].title);

// Search for specific topics
const results = await client.search({
  query: 'climate summit',
  dateFrom: '2025-01-01',
  sources: ['reuters', 'ap', 'aevum'],
});

interface ClientConfig {
  apiKey: string;              /* Required: Your Aevum API key */
  region: 'global' | 'us' | 'eu' | 'apac'; /* Default: 'global' */
  language: string;             /* ISO 639-1 code, default: 'en' */
  timeout: number;              /* Request timeout in ms, default: 10000 */
  retries: number;              /* Auto-retry count, default: 3 */
  cache: boolean;               /* Enable in-memory cache, default: false */
  cacheTTL: number;             /* Cache duration in ms, default: 300000 */
  baseUrl: string;              /* Override API base URL */
}

// Option 1: Environment variable (recommended)
const client = new NewsClient({
  apiKey: process.env.AEVUM_API_KEY
});

// Option 2: Bearer token (OAuth 2.0 flow)
const client = new NewsClient({
  token: 'bearer_token_here'
});

// Option 3: API key as header override
const client = new NewsClient({
  apiKey: 'your_key',
  customHeaders: {
    'X-Aevum-Version': 'v3',
  }
});

interface Pagination {
  page: number;         /* Current page */
  pageSize: number;     /* Items per page */
  total: number;        /* Total items */
  totalPages: number;   /* Total pages */
  nextPage: number | null;    /* Next page number */
  previousPage: number | null;/* Previous page number */
  hasNext: boolean;      /* Has more results */
  hasPrevious: boolean;  /* Has previous page */
}

import { AevumError, ErrorCode } from '@aevum/news-sdk';

try {
  const articles = await client.fetchArticles(...);
} catch (err) {
  if (err instanceof AevumError) {
    switch (err.code) {
      case ErrorCode.RATE_LIMIT:  // 429
        await wait(err.retryAfter);
        break;
      case ErrorCode.AUTH_FAILED: // 401
        refreshToken();
        break;
      case ErrorCode.NOT_FOUND: // 404
        console.log('No articles found');
        break;
    }
  }
}

const ws = client.createWebSocket({
  eventTypes: ['breaking', 'published'],
  filters: {
    categories: ['world', 'tech'],
    urgency: 'high',
  },
});

ws.on('open', () => console.log('Connected ✓'));
ws.on('news', (msg) => console.log(msg.data.title));
ws.on('close', () => console.log('Disconnected'));

/* ❌ v2.x (deprecated) */
import { AevumSDK } from '@aevum/sdk';
const sdk = new AevumSDK(key);
const articles = await sdk.getHeadlines();

/* ✅ v3.x (current) */
import { NewsClient } from '@aevum/news-sdk';
const client = new NewsClient({ apiKey: key });
const articles = await client.fetchArticles({ category: 'world' });