turkiyem 1.5.0 → 1.6.0

package/README.md

@@ -1,17 +1,59 @@
 # turkiyem
 
-Turkiye Toplu Tasima ve Deprem CLI araci.
-
-AFAD deprem verileri, EGO (Ankara) otobus saatleri ve IETT (Istanbul) hat/saat bilgilerini terminalden sorgulayabilirsiniz.
-Open-Meteo ile API key gerektirmeden guncel hava, saatlik tahmin ve hava kalitesi sorgulayabilirsiniz.
+Türkiye için modern, terminal tabanlı bir **toplu taşıma + deprem + hava durumu** CLI aracı.
+
+`turkiyem`; AFAD deprem verileri, EGO (Ankara) hat saatleri, IETT (İstanbul) hat bilgileri / planlanan sefer saatleri / canlı konum akışları ve Open-Meteo hava verilerini tek komutta toplar.
+
+## İçindekiler
+
+- [Özellikler](#özellikler)
+- [Kurulum](#kurulum)
+- [Hızlı Başlangıç](#hızlı-başlangıç)
+- [Komut Referansı](#komut-referansı)
+- [Veri Kaynakları](#veri-kaynakları)
+- [Mimari ve Proje Yapısı](#mimari-ve-proje-yapısı)
+- [Yapılandırma ve Cache](#yapılandırma-ve-cache)
+- [Hata Yönetimi](#hata-yönetimi)
+- [Geliştirme](#geliştirme)
+- [Yayınlama (npm)](#yayınlama-npm)
+- [Sık Karşılaşılan Sorunlar](#sık-karşılaşılan-sorunlar)
+- [Lisans](#lisans)
+
+## Özellikler
+
+- **Deprem (AFAD):**
+  - Son 24 saat / son 7 gün deprem listesi
+  - Büyüklüğe göre filtreleme
+  - `>= 4.0` depremler için renkli vurgu
+- **Toplu taşıma (Ankara / EGO):**
+  - Hat bilgileri
+  - Gün tipine göre sefer saatleri (Hafta içi / Cumartesi / Pazar)
+- **Toplu taşıma (İstanbul / IETT):**
+  - GTFS tabanlı hat özeti
+  - SOAP tabanlı planlanan sefer saatleri
+  - SOAP başarısız olduğunda GTFS özete otomatik fallback
+  - `hat canli` ile canlı araç konumu (servis erişimine bağlı)
+- **Hava durumu (Open-Meteo):**
+  - API key gerektirmeden güncel hava
+  - Saatlik tahmin (1-7 gün)
+  - Hava kalitesi (PM10, PM2.5, CO, NO2)
+- **Ekonomi:**
+  - TCMB güncel döviz kurları listesi
+- **CLI UX:**
+  - Komut bazlı spinner
+  - Tablo tabanlı okunabilir terminal çıktısı
+  - Global şehir ayarı (`~/.turkiyem/config.json`)
+  - Bellek içi cache ile performans optimizasyonu
 
 ## Kurulum
 
+### Global (önerilen)
+
 ```bash
 npm install -g turkiyem
 ```
 
-Veya yerel olarak:
+### Yerel geliştirme
 
 ```bash
 git clone <repo-url>
@@ -20,156 +62,197 @@ npm install
 npm link
 ```
 
-## Gereksinimler
+### Gereksinim
+
+- Node.js `20+`
 
-- Node.js 20+
+## Hızlı Başlangıç
+
+```bash
+turkiyem
+turkiyem sehir istanbul
+turkiyem hat 34AS
+turkiyem deprem son24
+turkiyem hava guncel
+turkiyem doviz
+```
 
-## Kullanim
+## Komut Referansı
 
-### Banner ve Yardim
+### Genel
 
 ```bash
 turkiyem
 turkiyem help
+turkiyem --version
+turkiyem temizle
 ```
 
-### Sehir Secimi
-
-Hat sorgulama icin once sehir secmelisiniz:
+### Şehir seçimi
 
 ```bash
 turkiyem sehir ankara
 turkiyem sehir istanbul
 ```
 
-### Hat Sorgulama
+> `hat` komutları seçili şehre göre çalışır.
 
-Secili sehre gore hat bilgilerini sorgular:
+### Hat sorgulama
 
 ```bash
 # Ankara (EGO)
 turkiyem sehir ankara
 turkiyem hat 340
 
-# Istanbul (IETT)
+# İstanbul (IETT)
 turkiyem sehir istanbul
 turkiyem hat 34AS
+```
 
-# IETT canli arac konumu (ozet)
+İstanbul akışı:
+- 1) GTFS hat özeti
+- 2) SOAP planlanan sefer saatleri
+- 3) SOAP erişilemezse GTFS özeti + bilgilendirme mesajı
+
+### IETT canlı konum
+
+```bash
+# Özet çıktı
 turkiyem hat canli 34AS
 
-# IETT canli arac konumu (detay)
+# Detay çıktı
 turkiyem hat canli 34AS --detay
 ```
 
-Ankara icin EGO web sitesinden sefer saatleri cekilir.
-Istanbul icin once IETT SOAP Planlanan Sefer Saati servisi ile kalkis saatleri getirilir.
-SOAP servisi gecici olarak erisilemezse otomatik olarak GTFS ozet verisine dusulur.
+> Not: Canlı konum sadece `istanbul` şehir seçiliyken anlamlıdır ve servis erişimine bağlıdır.
 
-Istanbul cikti sirasi:
-- Hat bilgileri (GTFS)
-- Planlanan sefer saatleri (SOAP)
-- SOAP hatasinda: yalnizca GTFS ozet + uyari
-
-Canli konum ozelligi:
-- `turkiyem hat canli <numara>` varsayilan olarak ozet verir
-- `--detay` ile arac bazli konum tablosu acilir
-- Sadece `istanbul` seciliyken kullanilir
-
-### Deprem Sorgulama
-
-AFAD API uzerinden gercek zamanli deprem verileri:
+### Deprem (AFAD)
 
 ```bash
-# Son 24 saat
 turkiyem deprem son24
-
-# Son 7 gun
 turkiyem deprem 7gun
-
-# Buyukluge gore filtrele (ornegin >= 4.0)
 turkiyem deprem buyukluk 4.0
 ```
 
-Buyuklugu 4.0 ve ustu olan depremler kirmizi ile vurgulanir.
-
-### Hava Durumu ve Hava Kalitesi
-
-Open-Meteo uzerinden API key gerektirmeden sorgu yapar:
+### Hava durumu ve hava kalitesi (Open-Meteo)
 
 ```bash
-# Secili sehir icin guncel hava
+# Seçili şehir
 turkiyem hava guncel
 
-# Sehir bazli guncel hava
+# Şehir adıyla
 turkiyem hava guncel istanbul
+turkiyem hava saatlik ankara --gun 3
+turkiyem hava kalite izmir
 
-# Koordinat bazli guncel hava
+# Koordinatla
 turkiyem hava guncel 41.0082,28.9784
+```
 
-# Saatlik tahmin (varsayilan 2 gun)
-turkiyem hava saatlik istanbul
+### Ekonomi (TCMB)
 
-# Saatlik tahmin gun sayisi (1-7)
-turkiyem hava saatlik istanbul --gun 3
+```bash
+# Sık kullanılan kurlar (USD, EUR vb.)
+turkiyem doviz
 
-# Hava kalitesi
-turkiyem hava kalite ankara
+# Tüm kurlar listesi
+turkiyem doviz --tum
 ```
 
-### Temizleme
-
-Cache ve yapilandirmayi sifirlar:
-
-```bash
-turkiyem temizle
+## Veri Kaynakları
+
+| Kaynak | Kullanım |
+|---|---|
+| AFAD | Deprem verileri |
+| EGO | Ankara hat/sefer saatleri |
+| IETT GTFS | İstanbul hat özeti |
+| IETT SOAP (PlanlananSeferSaati) | İstanbul planlanan sefer saatleri |
+| IETT SOAP (SeferGerceklesme) | İstanbul canlı araç konumu |
+| Open-Meteo Forecast | Güncel hava + saatlik tahmin |
+| Open-Meteo Air Quality | Hava kalitesi |
+| TCMB | Döviz kurları |
+
+## Mimari ve Proje Yapısı
+
+```text
+src/
+  commands/   # CLI komut handler'ları
+  services/   # Dış API / scraping / SOAP katmanı
+  utils/      # Tablo, cache, config, banner yardımcıları
+  index.js    # Commander giriş noktası
 ```
 
-### Versiyon
+Mimari prensipleri:
+- Komut katmanı ile servis katmanı ayrımı
+- API bağımlılıklarının servis içinde izole edilmesi
+- Tekrarlanan işlerin util katmanına alınması
+- Tüm dış isteklerde timeout + anlamlı hata mesajı
 
-```bash
-turkiyem --version
-```
+## Yapılandırma ve Cache
 
-## Yapilandirma
+- Seçili şehir dosyası:
+  - `~/.turkiyem/config.json`
+- Varsayılan cache:
+  - Bellek içi (`node-cache`)
+  - Kaynak bazlı TTL (ör. IETT SOAP, hava durumu vb.)
 
-Secili sehir `~/.turkiyem/config.json` dosyasinda saklanir. Bu dosya otomatik olusturulur.
+Temizleme:
 
-## Veri Kaynaklari
+```bash
+turkiyem temizle
+```
 
-| Kaynak | Aciklama |
-|--------|----------|
-| AFAD | Deprem verileri (deprem.afad.gov.tr) |
-| EGO | Ankara otobus sefer saatleri (ego.gov.tr) |
-| IETT | Istanbul GTFS hat verileri (data.ibb.gov.tr) |
-| IETT SOAP | Planlanan sefer saatleri (api.ibb.gov.tr) |
-| IETT Live SOAP | Hat bazli canli arac konumu (api.ibb.gov.tr) |
-| Open-Meteo | Guncel hava ve saatlik tahmin (api.open-meteo.com) |
-| Open-Meteo AQ | Hava kalitesi (air-quality-api.open-meteo.com) |
+## Hata Yönetimi
 
-## npm Publish
+Projede:
+- `unhandledRejection` ve `uncaughtException` yakalanır
+- API hataları kullanıcı dostu mesajlara çevrilir
+- Ağ timeout / bağlantı sorunları için özel açıklamalar verilir
+- Erişilemeyen kaynaklarda mümkün olan yerlerde fallback uygulanır
 
-1. npm hesabiniza giris yapin:
+## Geliştirme
 
 ```bash
-npm login
+npm install
+npm start
 ```
 
-2. package.json icindeki `name`, `version`, `author` alanlarini duzenleyin.
-
-3. Yayinlayin:
+Örnek geliştirme doğrulama komutları:
 
 ```bash
-npm publish
+node src/index.js help
+node src/index.js deprem son24
+node src/index.js hava guncel istanbul
+node src/index.js hat 34AS
 ```
 
-4. Guncelleme icin versiyonu artirin:
+## Yayınlama (npm)
 
 ```bash
+# 1) sürüm artır
 npm version patch
-npm publish
+
+# 2) publish
+npm publish --access public
+
+# 3) kontrol
+npm view turkiyem version
 ```
 
+## Sık Karşılaşılan Sorunlar
+
+### `npm publish` 403 (aynı sürüm)
+Önceden yayınlanmış bir sürüm numarasını tekrar gönderemezsiniz.  
+Çözüm: `npm version patch|minor|major` sonrası tekrar publish.
+
+### `npm publish` 403 (2FA / token)
+NPM hesabınız için 2FA veya granular token gereksinimi olabilir.  
+Çözüm: NPM hesabında token/2FA ayarlarını tamamlayın.
+
+### IETT canlı konum 500
+SOAP servis tarafı geçici olarak hata döndürebilir.  
+Bu durumda kısa süre sonra tekrar deneyin.
+
 ## Lisans
 
 MIT

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "turkiyem",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Türkiye Toplu Taşıma ve Deprem CLI aracı - AFAD deprem verileri, EGO hat saatleri ve IETT SOAP/GTFS bilgileri",
   "type": "module",
   "main": "./src/index.js",
   "bin": {
-    "turkiyem": "./src/index.js"
+    "turkiyem": "src/index.js"
   },
   "scripts": {
     "start": "node src/index.js",

package/src/commands/doviz.js

@@ -0,0 +1,26 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { fetchExchangeRates } from '../services/tcmbService.js';
+import { createDovizTable } from '../utils/display.js';
+
+export async function dovizKurlari(options) {
+    const spinner = ora('TCMB döviz kurları alınıyor...').start();
+
+    try {
+        const result = await fetchExchangeRates();
+        spinner.succeed(`TCMB kurları alındı (Tarih: ${result.date || '-'})`);
+
+        const popular = ['USD', 'EUR', 'GBP', 'CHF', 'JPY', 'CAD', 'AUD', 'DKK', 'SEK', 'NOK'];
+        const kurlar = options.tum ? result.currencies : result.currencies.filter(c => popular.includes(c.kodu));
+
+        console.log('');
+        console.log(createDovizTable({ ...result, currencies: kurlar }));
+
+        if (!options.tum) {
+            console.log('');
+            console.log(chalk.gray('  Tüm kurları görmek için: turkiyem doviz --tum'));
+        }
+    } catch (err) {
+        spinner.fail(chalk.red(err.message));
+    }
+}

package/src/index.js

@@ -9,6 +9,7 @@ import { hatCanliSorgula, hatSorgula } from './commands/hat.js';
 import { depremSon24, deprem7Gun, depremBuyukluk } from './commands/deprem.js';
 import { havaGuncel, havaKalitesi, havaSaatlik } from './commands/hava.js';
 import { temizle } from './commands/temizle.js';
+import { dovizKurlari } from './commands/doviz.js';
 
 const require = createRequire(import.meta.url);
 const pkg = require('../package.json');
@@ -113,6 +114,14 @@ program
     temizle();
   });
 
+program
+  .command('doviz')
+  .description('TCMB güncel döviz kurlarını sorgula')
+  .option('--tum', 'Tüm kurları göster')
+  .action(async (options) => {
+    await dovizKurlari(options);
+  });
+
 program
   .command('help')
   .description('Yardım göster')

package/src/services/tcmbService.js

@@ -0,0 +1,47 @@
+import axios from 'axios';
+import * as cheerio from 'cheerio';
+import { getCached, setCached } from '../utils/cache.js';
+
+const CACHE_KEY = 'tcmb_kur';
+const CACHE_TTL = 3600; // 1 saat
+const URL = 'https://www.tcmb.gov.tr/kurlar/today.xml';
+
+export async function fetchExchangeRates() {
+  const cached = getCached(CACHE_KEY);
+  if (cached) return cached;
+
+  try {
+    const response = await axios.get(URL, { timeout: 10000 });
+    const $ = cheerio.load(response.data, { xmlMode: true });
+
+    const date = $('Tarih_Date').attr('Tarih');
+    const bultenNo = $('Tarih_Date').attr('Bulten_No');
+
+    const currencies = [];
+
+    $('Currency').each((_, el) => {
+      const isim = $(el).find('Isim').text().trim();
+      const code = $(el).attr('CurrencyCode');
+      const alis = $(el).find('ForexBuying').text().trim();
+      const satis = $(el).find('ForexSelling').text().trim();
+
+      if (isim && code) {
+        currencies.push({
+          isim,
+          kodu: code,
+          alis,
+          satis
+        });
+      }
+    });
+
+    const result = { date, bultenNo, currencies };
+    setCached(CACHE_KEY, result, CACHE_TTL);
+    return result;
+  } catch (error) {
+    if (error.code === 'ECONNABORTED' || error.message.includes('timeout')) {
+      throw new Error('TCMB servisine erişilemedi (Zaman aşımı).');
+    }
+    throw new Error(`TCMB veri hatası: ${error.message}`);
+  }
+}

package/src/utils/banner.js

@@ -29,6 +29,7 @@ export function printHelp() {
   console.log(chalk.cyan('    turkiyem deprem son24') + chalk.gray('             Son 24 saat depremler'));
   console.log(chalk.cyan('    turkiyem deprem 7gun') + chalk.gray('              Son 7 gün depremler'));
   console.log(chalk.cyan('    turkiyem deprem buyukluk <deger>') + chalk.gray('  Büyüklüğe göre filtrele'));
+  console.log(chalk.cyan('    turkiyem doviz [--tum]') + chalk.gray('            TCMB Döviz kurları'));
   console.log(chalk.cyan('    turkiyem temizle') + chalk.gray('                  Cache ve config temizle'));
   console.log(chalk.cyan('    turkiyem --version') + chalk.gray('                Versiyon göster'));
   console.log('');

package/src/utils/display.js

@@ -247,3 +247,28 @@ export function createIettLiveDetailTable(liveData) {
 
   return table.toString();
 }
+
+export function createDovizTable(result) {
+  const table = new Table({
+    head: [
+      chalk.white.bold('Kod'),
+      chalk.white.bold('Döviz Cinsi'),
+      chalk.white.bold('Alış (TL)'),
+      chalk.white.bold('Satış (TL)'),
+    ],
+    colWidths: [8, 30, 15, 15],
+    style: { head: [], border: ['gray'] },
+  });
+
+  for (const c of result.currencies) {
+    if (!c.alis && !c.satis) continue;
+    table.push([
+      chalk.cyan(c.kodu),
+      c.isim,
+      c.alis || '-',
+      c.satis || '-'
+    ]);
+  }
+
+  return table.toString();
+}