static/pages/news/examples/api-client-examples.js

/**

 * نمونه کدهای استفاده از API اخبار کریپتو

 * Crypto News API Client Examples in JavaScript/Node.js

 * 

 * این فایل شامل مثال‌های مختلف برای استفاده از API اخبار است

 * This file contains various examples for using the News API

 */

/**

 * کلاس کلاینت برای دسترسی به API اخبار

 * Client class for accessing the News API

 */
class CryptoNewsClient {
  /**

   * @param {string} baseUrl - آدرس پایه سرور / Base URL of the server

   */
  constructor(baseUrl = window.location.origin) {
    this.baseUrl = baseUrl;
  }

  /**

   * دریافت تمام اخبار

   * Get all news articles

   * 

   * @param {number} limit - تعداد نتایج / Number of results

   * @returns {Promise<Array>} آرایه مقالات / Array of articles

   * 

   * @example

   * const client = new CryptoNewsClient();

   * const articles = await client.getAllNews(50);

   * console.log(`Found ${articles.length} articles`);

   */
  async getAllNews(limit = 100) {
    try {
      const url = `${this.baseUrl}/api/news?limit=${limit}`;
      const response = await fetch(url);
      
      if (!response.ok) {
        throw new Error(`HTTP ${response.status}: ${response.statusText}`);
      }
      
      const data = await response.json();
      return data.articles || [];
    } catch (error) {
      console.error('خطا در دریافت اخبار / Error fetching news:', error);
      return [];
    }
  }

  /**

   * دریافت اخبار بر اساس احساسات

   * Get news by sentiment

   * 

   * @param {string} sentiment - 'positive', 'negative', or 'neutral'

   * @param {number} limit - تعداد نتایج / Number of results

   * @returns {Promise<Array>}

   * 

   * @example

   * const client = new CryptoNewsClient();

   * const positiveNews = await client.getNewsBySentiment('positive');

   * positiveNews.forEach(article => console.log(article.title));

   */
  async getNewsBySentiment(sentiment, limit = 50) {
    try {
      const url = `${this.baseUrl}/api/news?sentiment=${sentiment}&limit=${limit}`;
      const response = await fetch(url);
      
      if (!response.ok) {
        throw new Error(`HTTP ${response.status}`);
      }
      
      const data = await response.json();
      const articles = data.articles || [];
      
      // فیلتر سمت کلاینت / Client-side filter
      return articles.filter(a => a.sentiment === sentiment);
    } catch (error) {
      console.error('Error:', error);
      return [];
    }
  }

  /**

   * دریافت اخبار از یک منبع خاص

   * Get news from a specific source

   * 

   * @param {string} source - نام منبع / Source name

   * @param {number} limit - تعداد نتایج / Number of results

   * @returns {Promise<Array>}

   * 

   * @example

   * const client = new CryptoNewsClient();

   * const coinDeskNews = await client.getNewsBySource('CoinDesk');

   */
  async getNewsBySource(source, limit = 50) {
    try {
      const url = `${this.baseUrl}/api/news?source=${encodeURIComponent(source)}&limit=${limit}`;
      const response = await fetch(url);
      
      if (!response.ok) {
        throw new Error(`HTTP ${response.status}`);
      }
      
      const data = await response.json();
      return data.articles || [];
    } catch (error) {
      console.error('Error:', error);
      return [];
    }
  }

  /**

   * جستجوی اخبار بر اساس کلمه کلیدی

   * Search news by keyword

   * 

   * @param {string} keyword - کلمه کلیدی / Keyword

   * @param {number} limit - تعداد نتایج / Number of results

   * @returns {Promise<Array>}

   * 

   * @example

   * const client = new CryptoNewsClient();

   * const bitcoinNews = await client.searchNews('bitcoin');

   * console.log(`Found ${bitcoinNews.length} articles about Bitcoin`);

   */
  async searchNews(keyword, limit = 100) {
    const articles = await this.getAllNews(limit);
    const keywordLower = keyword.toLowerCase();
    
    return articles.filter(article => {
      const title = (article.title || '').toLowerCase();
      const content = (article.content || '').toLowerCase();
      return title.includes(keywordLower) || content.includes(keywordLower);
    });
  }

  /**

   * دریافت آخرین اخبار

   * Get latest news

   * 

   * @param {number} count - تعداد نتایج / Number of results

   * @returns {Promise<Array>}

   * 

   * @example

   * const client = new CryptoNewsClient();

   * const latest = await client.getLatestNews(5);

   * latest.forEach(article => {

   *   console.log(`${article.title} - ${article.published_at}`);

   * });

   */
  async getLatestNews(count = 10) {
    const articles = await this.getAllNews(100);
    
    // مرتب‌سازی بر اساس تاریخ انتشار / Sort by publish date
    const sorted = articles.sort((a, b) => {
      const dateA = new Date(a.published_at || 0);
      const dateB = new Date(b.published_at || 0);
      return dateB - dateA;
    });
    
    return sorted.slice(0, count);
  }

  /**

   * دریافت آمار اخبار

   * Get news statistics

   * 

   * @returns {Promise<Object>} آمار / Statistics

   * 

   * @example

   * const client = new CryptoNewsClient();

   * const stats = await client.getNewsStatistics();

   * console.log(`Total: ${stats.total}`);

   * console.log(`Positive: ${stats.positive}`);

   */
  async getNewsStatistics() {
    const articles = await this.getAllNews();
    
    const stats = {
      total: articles.length,
      positive: articles.filter(a => a.sentiment === 'positive').length,
      negative: articles.filter(a => a.sentiment === 'negative').length,
      neutral: articles.filter(a => a.sentiment === 'neutral').length,
      sources: new Set(articles.map(a => a.source?.title || '')).size
    };
    
    return stats;
  }
}

// ==============================================================================
// مثال‌های استفاده / Usage Examples
// ==============================================================================

/**

 * مثال ۱: استفاده ساده / Example 1: Basic Usage

 */
async function example1BasicUsage() {
  console.log('='.repeat(60));
  console.log('مثال ۱: دریافت تمام اخبار / Example 1: Get All News');
  console.log('='.repeat(60));
  
  const client = new CryptoNewsClient();
  const articles = await client.getAllNews(10);
  
  console.log(`\nتعداد مقالات / Number of articles: ${articles.length}\n`);
  
  articles.slice(0, 5).forEach((article, i) => {
    console.log(`${i + 1}. ${article.title || 'No title'}`);
    console.log(`   منبع / Source: ${article.source?.title || 'Unknown'}`);
    console.log(`   احساسات / Sentiment: ${article.sentiment || 'neutral'}`);
    console.log('');
  });
}

/**

 * مثال ۲: فیلتر بر اساس احساسات / Example 2: Sentiment Filtering

 */
async function example2SentimentFiltering() {
  console.log('='.repeat(60));
  console.log('مثال ۲: فیلتر اخبار مثبت / Example 2: Positive News Filter');
  console.log('='.repeat(60));
  
  const client = new CryptoNewsClient();
  const positiveNews = await client.getNewsBySentiment('positive', 50);
  
  console.log(`\nاخبار مثبت / Positive news: ${positiveNews.length}\n`);
  
  positiveNews.slice(0, 3).forEach(article => {
    console.log(`✓ ${article.title || 'No title'}`);
    console.log(`  ${(article.content || '').substring(0, 100)}...`);
    console.log('');
  });
}

/**

 * مثال ۳: جستجو با کلمه کلیدی / Example 3: Keyword Search

 */
async function example3KeywordSearch() {
  console.log('='.repeat(60));
  console.log('مثال ۳: جستجوی بیت‌کوین / Example 3: Bitcoin Search');
  console.log('='.repeat(60));
  
  const client = new CryptoNewsClient();
  const bitcoinNews = await client.searchNews('bitcoin');
  
  console.log(`\nمقالات مرتبط با بیت‌کوین / Bitcoin articles: ${bitcoinNews.length}\n`);
  
  bitcoinNews.slice(0, 5).forEach(article => {
    console.log(`• ${article.title || 'No title'}`);
  });
}

/**

 * مثال ۴: آمار اخبار / Example 4: News Statistics

 */
async function example4Statistics() {
  console.log('='.repeat(60));
  console.log('مثال ۴: آمار اخبار / Example 4: Statistics');
  console.log('='.repeat(60));
  
  const client = new CryptoNewsClient();
  const stats = await client.getNewsStatistics();
  
  console.log('\n📊 آمار / Statistics:');
  console.log(`   مجموع مقالات / Total: ${stats.total}`);
  console.log(`   مثبت / Positive: ${stats.positive} (${(stats.positive/stats.total*100).toFixed(1)}%)`);
  console.log(`   منفی / Negative: ${stats.negative} (${(stats.negative/stats.total*100).toFixed(1)}%)`);
  console.log(`   خنثی / Neutral: ${stats.neutral} (${(stats.neutral/stats.total*100).toFixed(1)}%)`);
  console.log(`   منابع / Sources: ${stats.sources}`);
}

/**

 * مثال ۵: آخرین اخبار / Example 5: Latest News

 */
async function example5LatestNews() {
  console.log('='.repeat(60));
  console.log('مثال ۵: آخرین اخبار / Example 5: Latest News');
  console.log('='.repeat(60));
  
  const client = new CryptoNewsClient();
  const latest = await client.getLatestNews(5);
  
  console.log('\n🕒 آخرین اخبار / Latest news:\n');
  
  latest.forEach((article, i) => {
    const published = article.published_at || '';
    const timeStr = published ? new Date(published).toLocaleString() : 'Unknown time';
    
    console.log(`${i + 1}. ${article.title || 'No title'}`);
    console.log(`   زمان / Time: ${timeStr}`);
    console.log('');
  });
}

/**

 * مثال ۶: فیلتر پیشرفته / Example 6: Advanced Filtering

 */
async function example6AdvancedFiltering() {
  console.log('='.repeat(60));
  console.log('مثال ۶: فیلتر ترکیبی / Example 6: Combined Filters');
  console.log('='.repeat(60));
  
  const client = new CryptoNewsClient();
  
  // دریافت اخبار مثبت درباره اتریوم
  // Get positive news about Ethereum
  const allNews = await client.getAllNews(100);
  
  const filtered = allNews.filter(article => {
    const isPositive = article.sentiment === 'positive';
    const isEthereum = (article.title || '').toLowerCase().includes('ethereum');
    return isPositive && isEthereum;
  });
  
  console.log(`\nاخبار مثبت درباره اتریوم / Positive Ethereum news: ${filtered.length}\n`);
  
  filtered.slice(0, 3).forEach(article => {
    console.log(`✓ ${article.title || 'No title'}`);
    console.log(`  منبع / Source: ${article.source?.title || 'Unknown'}`);
    console.log('');
  });
}

/**

 * تابع اصلی / Main function

 */
async function main() {
  console.log('\n' + '='.repeat(60));
  console.log('نمونه‌های استفاده از API اخبار کریپتو');
  console.log('Crypto News API Usage Examples');
  console.log('='.repeat(60) + '\n');
  
  try {
    // اجرای تمام مثال‌ها / Run all examples
    await example1BasicUsage();
    console.log('\n');
    
    await example2SentimentFiltering();
    console.log('\n');
    
    await example3KeywordSearch();
    console.log('\n');
    
    await example4Statistics();
    console.log('\n');
    
    await example5LatestNews();
    console.log('\n');
    
    await example6AdvancedFiltering();
    
  } catch (error) {
    console.error('\nخطا / Error:', error.message);
    console.error('لطفاً مطمئن شوید که سرور در حال اجرا است');
    console.error('Please make sure the server is running');
  }
}

// اجرای برنامه اگر به صورت مستقیم فراخوانی شود
// Run the program if executed directly
if (typeof window === 'undefined') {
  // Node.js environment
  main();
} else {
  // Browser environment - export for use
  window.CryptoNewsClient = CryptoNewsClient;
  console.log('CryptoNewsClient class is now available globally');
  console.log('Usage: const client = new CryptoNewsClient();');
}

// Export for ES6 modules
export { CryptoNewsClient };
export default CryptoNewsClient;