# trkit CLI

> Bileşen ve sayfa ekleme, yasal metinleri kontrol etme ve dışa aktarma komutları.

Projede `@trkit-app-pack/cli` geliştirme bağımlılığı olarak kuruludur; `npx trkit` ile çalıştırılır.

## `trkit list`

Eklenebilecek tüm öğeleri listeler.

```bash
npx trkit list
```

| Öğe | Tür | Açıklama |
|---|---|---|
| `kvkk`, `acik-riza`, `cerez-politikasi`, `mesafeli-satis`, `on-bilgilendirme`, `teslimat-iade`, `ticari-ileti`, `kvkk-basvuru` | Sayfa | Tek bir yasal sayfa |
| `yasal` | Sayfa | Tüm yasal sayfalar |
| `cerez-banner` | Bileşen | Çerez onay banner'ı, `ConsentGate`, onay kayıt uç noktası |
| `il-ilce-secici` | Bileşen | Bağımlı il/ilçe `<select>`'leri |
| `il-ilce-arama` | Bileşen | Türkçe duyarsız il/ilçe combobox'ı |
| `odeme` | Uç nokta | `lib/pay.ts` ve `/api/odeme/callback` |
| `odeme-onaylari` | Bileşen | Ön bilgilendirme + mesafeli satış onayı |
| `sms` | Kütüphane | `lib/sms.ts`: SMS ve OTP |
| `config` | Kütüphane | `trkit.config.ts` |

## `trkit add`

```bash
npx trkit add odeme odeme-onaylari
```

- Bağımlılıkları (`registryDependencies`) otomatik çözer. Örneğin `kvkk` eklemek `legal-page` bileşenini ve `trkit.config.ts`'i de ekler.
- Var olan dosyaların üzerine yazmaz. Üzerine yazmak için `--overwrite`.
- Kurulması gereken npm paketlerini, gereken ortam değişkenlerini ve kurulum notlarını yazdırır.
- `--install` ile paketleri otomatik kurar, `--dry-run` ile yalnızca ne yapacağını gösterir.

Dosyalar projenizin yapısına göre yerleştirilir: `src/` kullanıyorsanız `src/app`, shadcn/ui'nin `components.json` dosyası varsa onun dizinleri, `tsconfig.json`'daki import takma adı (`@/`, `~/`…).

## `trkit check`

`trkit.config.ts`'e göre tüm yasal metinleri üretir ve eksik bilgileri raporlar.

```bash
npx trkit check
```

```text
✓ Çerez Politikası
⚠ Mesafeli Satış Sözleşmesi
    – MERSİS no eksik
    – Telefon eksik
⚠ KVKK Aydınlatma Metni
    – Yurt dışı aktarım belirtilmedi. Vercel, AWS, Google Analytics... kullanıyorsanız kvkk.yurtDisiAktarim alanını doldurun
```

CI'da eksik bilgiyle yayına çıkmayı engellemek için `--strict` (uyarı varsa çıkış kodu 1).

> TypeScript config dosyasını okumak için Node.js 22.18 veya üzeri gerekir. Daha eski sürümlerde `npx tsx node_modules/.bin/trkit check` kullanın.

## `trkit generate`

Bir yasal metni dosyaya yazar; Next.js dışındaki projeler, PDF'e çevirme veya avukata gönderme için kullanışlıdır.

```bash
npx trkit generate kvkk-aydinlatma --format md --out kvkk.md
npx trkit generate mesafeli-satis --format html --out mesafeli.html
```

Biçimler: `md`, `html`, `txt`.

## `trkit init`

Mevcut bir projede `trkit.json` ve `trkit.config.ts` oluşturur. create-trkit-app ile oluşturulan projelerde gerekmez.