turkiyem 1.4.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,144 +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
 ```
 
-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.
+İ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
 
-Istanbul cikti sirasi:
-- Hat bilgileri (GTFS)
-- Planlanan sefer saatleri (SOAP)
-- SOAP hatasinda: yalnizca GTFS ozet + uyari
+# Detay çıktı
+turkiyem hat canli 34AS --detay
+```
 
-### Deprem Sorgulama
+> Not: Canlı konum sadece `istanbul` şehir seçiliyken anlamlıdır ve servis erişimine bağlıdır.
 
-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) |
-| 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.4.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/commands/hat.js

@@ -2,9 +2,11 @@ import chalk from 'chalk';
 import ora from 'ora';
 import { getCity } from '../utils/config.js';
 import { fetchEgoSchedule } from '../services/egoService.js';
-import { fetchIettRouteWithPlannedTimes } from '../services/iettService.js';
+import { fetchIettLiveVehicles, fetchIettRouteWithPlannedTimes } from '../services/iettService.js';
 import {
   createEgoInfoTable,
+  createIettLiveDetailTable,
+  createIettLiveSummaryTable,
   createEgoScheduleTable,
   createIettPlannedTimesTable,
   createRouteTable,
@@ -34,6 +36,48 @@ export async function hatSorgula(hatNo) {
   }
 }
 
+export async function hatCanliSorgula(hatNo, options = {}) {
+  if (!hatNo) {
+    console.log(chalk.red('Hat numarası belirtmelisiniz. Örnek: turkiyem hat canli 34AS'));
+    return;
+  }
+
+  const city = getCity();
+  if (!city) {
+    console.log(chalk.yellow('Henüz şehir seçmediniz. Önce şehir seçin:'));
+    console.log(chalk.cyan('  turkiyem sehir istanbul'));
+    return;
+  }
+
+  if (city !== 'istanbul') {
+    console.log(chalk.yellow('Canlı konum özelliği sadece İstanbul (IETT) için kullanılabilir.'));
+    console.log(chalk.gray('Önce şehir seçimini istanbul yapın: turkiyem sehir istanbul'));
+    return;
+  }
+
+  const spinner = ora(`IETT canlı araç konumları alınıyor (${hatNo})...`).start();
+
+  try {
+    const liveData = await fetchIettLiveVehicles(hatNo);
+    spinner.succeed(`IETT canlı konum verisi alındı (${liveData.summary.totalVehicles} araç)`);
+    console.log('');
+
+    console.log(chalk.white.bold('  IETT Canlı Konum Özeti'));
+    console.log(createIettLiveSummaryTable(liveData));
+
+    if (options.detay) {
+      console.log('');
+      console.log(chalk.white.bold('  IETT Canlı Konum Detayları'));
+      console.log(createIettLiveDetailTable(liveData));
+    } else {
+      console.log('');
+      console.log(chalk.gray('  Detay tablo için: turkiyem hat canli <numara> --detay'));
+    }
+  } catch (err) {
+    spinner.fail(chalk.red(err.message));
+  }
+}
+
 async function queryEgo(hatNo) {
   const spinner = ora(`EGO hat ${hatNo} bilgileri alınıyor...`).start();
 

package/src/index.js

@@ -5,10 +5,11 @@ import { Command } from 'commander';
 import { createRequire } from 'node:module';
 import { printBanner, printHelp } from './utils/banner.js';
 import { sehirSec } from './commands/sehir.js';
-import { hatSorgula } from './commands/hat.js';
+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');
@@ -39,11 +40,20 @@ program
     sehirSec(sehir);
   });
 
-program
-  .command('hat <numara>')
-  .description('Hat bilgilerini sorgula')
-  .action(async (numara) => {
-    await hatSorgula(numara);
+const hatCmd = program
+  .command('hat')
+  .description('Hat bilgilerini sorgula');
+
+hatCmd
+  .argument('[arg1]', 'Hat numarası veya "canli"')
+  .argument('[arg2]', 'Canlı komutu için hat numarası')
+  .option('--detay', 'Araç bazlı detay tabloyu göster')
+  .action(async (arg1, arg2, options) => {
+    if (arg1 === 'canli') {
+      await hatCanliSorgula(arg2, options);
+      return;
+    }
+    await hatSorgula(arg1);
   });
 
 const depremCmd = program
@@ -104,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/iettService.js

@@ -5,6 +5,8 @@ const DATASTORE_SQL_URL = 'https://data.ibb.gov.tr/api/3/action/datastore_search
 const DATASTORE_SEARCH_URL = 'https://data.ibb.gov.tr/api/3/action/datastore_search';
 const PLANNED_TIME_SOAP_URL = 'https://api.ibb.gov.tr/iett/UlasimAnaVeri/PlanlananSeferSaati.asmx';
 const PLANNED_TIME_SOAP_ACTION = 'http://tempuri.org/GetPlanlananSeferSaati_json';
+const LIVE_SOAP_URL = 'https://api.ibb.gov.tr/iett/FiloDurum/SeferGerceklesme.asmx';
+const LIVE_SOAP_ACTION = 'http://tempuri.org/GetHatOtoKonum_json';
 
 const RESOURCE_IDS = {
   routes: '46dbe388-c8c2-45c4-ac72-c06953de56a2',
@@ -170,6 +172,79 @@ function extractSoapResultJson(xmlText) {
   return JSON.parse(jsonText);
 }
 
+function buildLiveSoapBody(routeCode) {
+  return `<?xml version="1.0" encoding="utf-8"?>
+<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+               xmlns:xsd="http://www.w3.org/2001/XMLSchema"
+               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
+  <soap:Body>
+    <GetHatOtoKonum_json xmlns="http://tempuri.org/">
+      <HatNo>${routeCode}</HatNo>
+    </GetHatOtoKonum_json>
+  </soap:Body>
+</soap:Envelope>`;
+}
+
+function extractLiveSoapResultJson(xmlText) {
+  const match = xmlText.match(
+    /<GetHatOtoKonum_jsonResult>([\s\S]*?)<\/GetHatOtoKonum_jsonResult>/i,
+  );
+
+  if (!match || !match[1]) return [];
+  const jsonText = match[1].trim();
+  if (!jsonText || jsonText === '[]') return [];
+  return JSON.parse(jsonText);
+}
+
+function normalizeLiveVehicles(records) {
+  return records.map((item) => ({
+    vehicleDoorNo: item.kapino || '-',
+    longitude: item.boylam || '-',
+    latitude: item.enlem || '-',
+    routeCode: item.hatkodu || '-',
+    routeVariantCode: item.guzergahkodu || '-',
+    routeName: item.hatad || '-',
+    direction: item.yon || '-',
+    lastLocationTime: item.son_konum_zamani || '-',
+    nearestStopCode: item.yakinDurakKodu || '-',
+  }));
+}
+
+function parseDateValue(value) {
+  if (!value || value === '-') return Number.NaN;
+  const normalized = value.includes('T') ? value : value.replace(' ', 'T');
+  const ts = new Date(normalized).getTime();
+  return Number.isNaN(ts) ? Number.NaN : ts;
+}
+
+function buildLiveSummary(vehicles) {
+  const directionCounter = new Map();
+  let latestTime = '-';
+  let latestTs = Number.NEGATIVE_INFINITY;
+
+  for (const vehicle of vehicles) {
+    const direction = vehicle.direction || '-';
+    directionCounter.set(direction, (directionCounter.get(direction) || 0) + 1);
+
+    const ts = parseDateValue(vehicle.lastLocationTime);
+    if (!Number.isNaN(ts) && ts > latestTs) {
+      latestTs = ts;
+      latestTime = vehicle.lastLocationTime;
+    }
+  }
+
+  const directionDistribution = Array.from(directionCounter.entries()).map(([direction, count]) => ({
+    direction,
+    count,
+  }));
+
+  return {
+    totalVehicles: vehicles.length,
+    latestLocationTime: latestTime,
+    directionDistribution,
+  };
+}
+
 export async function fetchIettPlannedTimes(routeCode) {
   const code = routeCode.toUpperCase();
   const cacheKey = `iett_soap_times_${code}`;
@@ -317,3 +392,64 @@ export async function fetchIettRouteWithPlannedTimes(routeCode) {
     };
   }
 }
+
+export async function fetchIettLiveVehicles(routeCode) {
+  const code = routeCode.toUpperCase();
+  const cacheKey = `iett_live_${code}`;
+  const cached = getCached(cacheKey);
+  if (cached) return cached;
+
+  const body = buildLiveSoapBody(code);
+
+  try {
+    const response = await axios.post(LIVE_SOAP_URL, body, {
+      timeout: 15000,
+      headers: {
+        'Content-Type': 'text/xml; charset=utf-8',
+        SOAPAction: LIVE_SOAP_ACTION,
+        ...API_HEADERS,
+      },
+      responseType: 'text',
+      maxRedirects: 5,
+      validateStatus: (status) => status >= 200 && status < 600,
+    });
+
+    if (response.status === 403) {
+      throw new Error('IETT canlı konum servisi erişimi engellendi (403).');
+    }
+    if (response.status >= 500) {
+      throw new Error(`IETT canlı konum servisi şu anda erişilemiyor (HTTP ${response.status}).`);
+    }
+    if (response.status !== 200) {
+      throw new Error(`IETT canlı konum servisi HTTP ${response.status} döndürdü.`);
+    }
+
+    const parsed = extractLiveSoapResultJson(response.data);
+    const vehicles = normalizeLiveVehicles(parsed);
+
+    if (vehicles.length === 0) {
+      throw new Error(`"${routeCode}" hattı için aktif araç konumu bulunamadı.`);
+    }
+
+    const summary = buildLiveSummary(vehicles);
+    const result = {
+      routeCode: code,
+      summary,
+      vehicles,
+    };
+
+    setCached(cacheKey, result, CACHE_TTL.IETT_LIVE);
+    return result;
+  } catch (err) {
+    if (err.code === 'ECONNABORTED') {
+      throw new Error('IETT canlı konum servisi zaman aşımına uğradı.');
+    }
+    if (err.code === 'ENOTFOUND' || err.code === 'ECONNREFUSED') {
+      throw new Error('IETT canlı konum servisine bağlanılamadı.');
+    }
+    if (err instanceof SyntaxError) {
+      throw new Error('IETT canlı konum yanıtı çözümlenemedi.');
+    }
+    throw err;
+  }
+}

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

@@ -22,12 +22,14 @@ export function printHelp() {
   console.log(chalk.white.bold('  Komutlar:\n'));
   console.log(chalk.cyan('    turkiyem sehir <ankara|istanbul>') + chalk.gray('  Şehir seç'));
   console.log(chalk.cyan('    turkiyem hat <numara>') + chalk.gray('             Hat sorgula'));
+  console.log(chalk.cyan('    turkiyem hat canli <numara> [--detay]') + chalk.gray('  IETT canlı konum'));
   console.log(chalk.cyan('    turkiyem hava guncel [sehir|lat,lon]') + chalk.gray('  Güncel hava'));
   console.log(chalk.cyan('    turkiyem hava saatlik [sehir|lat,lon] -g 2') + chalk.gray('  Saatlik tahmin'));
   console.log(chalk.cyan('    turkiyem hava kalite [sehir|lat,lon]') + chalk.gray('  Hava kalitesi'));
   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/cache.js

@@ -3,6 +3,7 @@ import NodeCache from 'node-cache';
 export const CACHE_TTL = Object.freeze({
   DEFAULT: 300,
   IETT_SOAP: 90,
+  IETT_LIVE: 45,
   WEATHER_CURRENT: 300,
   WEATHER_HOURLY: 600,
   WEATHER_AIR: 600,

package/src/utils/display.js

@@ -198,3 +198,77 @@ export function createAirQualityTable(result) {
 
   return table.toString();
 }
+
+export function createIettLiveSummaryTable(liveData) {
+  const table = new Table({
+    style: { head: [], border: ['gray'] },
+    wordWrap: true,
+  });
+
+  const directionText = (liveData.summary?.directionDistribution || [])
+    .map((item) => `${item.direction}: ${item.count}`)
+    .join(' | ');
+
+  table.push(
+    { [chalk.cyan('Hat Kodu')]: liveData.routeCode || '-' },
+    { [chalk.cyan('Aktif Araç Sayısı')]: String(liveData.summary?.totalVehicles ?? 0) },
+    { [chalk.cyan('Yön Dağılımı')]: directionText || '-' },
+    { [chalk.cyan('Son Konum Zamanı')]: liveData.summary?.latestLocationTime || '-' },
+  );
+
+  return table.toString();
+}
+
+export function createIettLiveDetailTable(liveData) {
+  const table = new Table({
+    head: [
+      chalk.white.bold('Kapı No'),
+      chalk.white.bold('Yön'),
+      chalk.white.bold('Enlem'),
+      chalk.white.bold('Boylam'),
+      chalk.white.bold('Yakın Durak'),
+      chalk.white.bold('Son Konum Zamanı'),
+    ],
+    colWidths: [10, 24, 12, 12, 14, 22],
+    style: { head: [], border: ['gray'] },
+    wordWrap: true,
+  });
+
+  for (const vehicle of liveData.vehicles || []) {
+    table.push([
+      vehicle.vehicleDoorNo || '-',
+      vehicle.direction || '-',
+      String(vehicle.latitude ?? '-'),
+      String(vehicle.longitude ?? '-'),
+      vehicle.nearestStopCode || '-',
+      vehicle.lastLocationTime || '-',
+    ]);
+  }
+
+  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();
+}