uvako-cli 0.2.1 → 0.4.0

package/README.md

@@ -1,125 +1,175 @@
-# uvako-cli
-
-Uvako mağazaları için tema geliştirme aracı. Temayı başlatır, denetler, mağazanıza yükler ve kaydettikçe canlı önizletir.
-
-**[Uvako](https://uvako.com)** — Rox Software ürünü.
-
-Node.js 22 ve üzeri gerekir. Ek bağımlılığı yoktur.
-
-## Kurulum
-
-```bash
-npm install -g uvako-cli
-uvako version
-```
-
-## Hızlı başlangıç
-
-1. Mağaza panelinde **Ayarlar → Temalar → Geliştirici erişimi** bölümünden bir erişim anahtarı oluşturun.
-2. Giriş yapın (anahtar sorulur, ekrana yazılmaz):
-
-```bash
-uvako login --store magazam
-```
-
-3. Bir katalog temasını temel alan yeni tema başlatın:
-
-```bash
-uvako theme init atolye --base linea
-```
-
-4. Canlı geliştirin: dosyaları kaydettikçe tema mağazanıza yüklenir, açık önizleme sayfası kendini yeniler.
-
-```bash
-uvako theme dev atolye
-```
-
-Önizleme adresi mağazanızın kendi adresidir (`https://magazam.uvoo.store/?preview=…`); tarayıcıda mağaza
-paneline giriş yapmış olmanız gerekir. Tema, panelden yayınlanana kadar vitrininizi değiştirmez.
-
-## Komutlar
-
-| Komut | Ne yapar |
-|---|---|
-| `uvako login --store <mağaza>` | Mağazaya tema erişim anahtarıyla bağlanır. |
-| `uvako logout` · `uvako whoami` | Kayıtlı girişi siler · bağlı mağazayı gösterir. |
-| `uvako theme init <anahtar>` | Yeni tema iskeleti (`--base`, `--name`, `--author`). |
-| `uvako theme check [klasör]` | Temayı denetler: yapı, ayarlar, bölümler, görseller, güvenlik. |
-| `uvako theme dev [klasör]` | Canlı geliştirme: kaydettikçe yükler, önizleme yenilenir. Durdurunca mağaza eski hâline döner (`--keep` ile kütüphanede kalır). |
-| `uvako theme push [klasör]` | Temayı mağazanın tema kütüphanesine yükler. |
-| `uvako theme pull <anahtar>` | Yüklediğiniz temayı indirir (`--dir`, `--force`). |
-| `uvako theme list` | Mağazadaki temaları ve yüklediğiniz paketleri listeler. |
-| `uvako theme submit <anahtar>` | Temayı themes.uvako.com için incelemeye gönderir. |
-| `uvako theme delete <anahtar> --yes` | Yüklediğiniz paketi siler. |
-| `uvako theme package [klasör]` | Denetimden geçen temayı zip paketine çevirir (`--out`). |
-| `uvako version` | Sürümü yazar. |
-
-`uvako-cli` aynı komutların uzun adıdır. Hata varsa çıkış kodu 1'dir. CI için `UVAKO_STORE` ve
-`UVAKO_TOKEN` ortam değişkenleri girişin yerini tutar.
-
-## Tema paketi
-
-Tema kod içermez. Bir katalog temasını (`base`) temel alır ve onun üstüne şunları getirir:
-
-```
-theme.json                     kimlik: key, name, version, base; mağaza vitrini bilgileri
-config/settings_data.json      temel temadan farklı olan ayar değerleri
-config/settings_schema.json    (isteğe bağlı) panelde görünen ayarlar
-templates/index.json           (isteğe bağlı) ana sayfadaki bölüm sırası
-styles/_tokens.scss            renk, yazı tipi, köşe değişkenleri (temanın tamamına yayılır)
-styles/theme.scss              temaya özgü SCSS
-assets/                        logo, slayt ve banner görselleri, yazı tipleri
-reference/                     temel temanın ayarları ve bölüm türleri (pakete girmez)
-```
-
-Bölümlerin kendisi (slayt, banner, ürün vitrini…) temel temadan gelir; paket hangilerinin hangi sırayla
-ve hangi görünümle kullanılacağını söyler. Katalog temaları: [themes.uvako.com](https://themes.uvako.com).
-
-## Yayınlama
-
-- `push` ile yüklenen tema **yalnızca kendi mağazanızda** görünür.
-- `submit` temayı Uvako incelemesine gönderir. Onaylanan sürüm themes.uvako.com'da listelenir ve diğer
-  mağazalar kurabilir. Fiyatı (`theme.json` içindeki `price` öneridir) Uvako onaylar.
-- Onaydan sonra yüklediğiniz yeni sürümler yeniden onaylanana kadar yalnızca kendi mağazanızı etkiler.
-
-## Güvenlik kuralları
-
-Mağaza, yüklenen paketi aynı kurallarla **kendisi yeniden denetler**; `check` hatayı önceden görmeniz içindir.
-
-- Yalnızca yukarıdaki dosyalar kabul edilir: JSON, SCSS, görsel ve yazı tipi. JavaScript, şablon ve
-  çalıştırılabilir dosyalar reddedilir.
-- `<script>`, `javascript:` adresleri, `onclick` gibi olay öznitelikleri, `<iframe>` (SVG ve ayar metinleri dahil).
-- Kod çalıştıran CSS (`expression`, `behavior`, `-moz-binding`).
-- SCSS içinde döngü, fonksiyon ve mixin tanımı (`@while`, `@for`, `@each`, `@function`, `@mixin`, `@use`).
-  Temel temanın mixin'leri `@include` ile kullanılabilir.
-- Paketin kendi dosyaları dışındaki `@import`'lar ve yazı tipi sağlayıcıları dışındaki adresler.
-- Sembolik bağlar, gizli dosyalar, 5 MB'tan büyük dosyalar, 60 MB'tan büyük ya da 600 dosyadan fazla paketler.
-- Gizli anahtar ya da parola gibi görünen değerler.
-
-Erişim anahtarı yalnızca tema işlemlerine yetkilidir; sipariş, müşteri ve ayarlara erişemez. Bilgisayarınızda
-kullanıcı klasörünüzde saklanır, tema klasörüne yazılmaz, yalnızca giriş yaptığınız mağazaya ve yalnızca
-https üzerinden gönderilir. Kaybederseniz panelden iptal edin.
-
-Araç platformun kaynak kodunu içermez.
-
-## Uvako
-
-[uvako.com](https://uvako.com)
-
-Uvako, işletmelerin kendi alan adıyla online mağaza kurmasını sağlayan e-ticaret altyapısıdır. Ürün, sipariş, ödeme, kargo, kampanya ve tema yönetimi tek panelde toplanır.
-
-## Rox Software · Rox Group
-
-Bu paket **Rox Software** tarafından geliştirilir ve yayınlanır.
-
-Rox Software; kurumsal web, e-ticaret, özel yazılım ve kendi ürün platformlarını (RoxB2B, RoxETS, Uvako) geliştiren Ankara merkezli yazılım ekibidir.
-
-**Rox Group Yazılım Havacılık Uzay ve Savunma Sanayi Limited Şirketi**  
-İvedikköy Mahallesi 1493. Sokak No:5 Daire:22  
-06378 Yenimahalle / Ankara
-
-- Site: [roxsoftware.net](https://www.roxsoftware.net/)
-- Uvako: [uvako.com](https://uvako.com)
-- E-posta: info@roxsoftware.net
-
-Tüm hakları saklıdır. © Rox Group
+# uvako-cli
+
+Uvako mağazaları için tema geliştirme aracı. Temayı başlatır, denetler, mağazanıza yükler ve kaydettikçe canlı önizletir.
+
+**[Uvako](https://uvako.com)** — Rox Software ürünü.
+
+Node.js 22 ve üzeri gerekir. Ek bağımlılığı yoktur.
+
+## Kurulum
+
+```bash
+npm install -g uvako-cli
+uvako version
+```
+
+## Hızlı başlangıç
+
+1. Mağaza panelinde **Ayarlar → Temalar → Geliştirici erişimi** bölümünden bir erişim anahtarı oluşturun.
+2. Giriş yapın (anahtar sorulur, ekrana yazılmaz):
+
+```bash
+uvako login --store magazam
+```
+
+3. Bir katalog temasını temel alan yeni tema başlatın:
+
+```bash
+uvako theme init atolye --base linea
+```
+
+4. Canlı geliştirin: dosyaları kaydettikçe tema mağazanıza yüklenir, açık önizleme sayfası kendini yeniler.
+
+```bash
+uvako theme dev atolye
+```
+
+Önizleme adresi mağazanızın kendi adresidir (`https://magazam.uvoo.store/?preview=…`); tarayıcıda mağaza
+paneline giriş yapmış olmanız gerekir. Tema, panelden yayınlanana kadar vitrininizi değiştirmez.
+
+## Komutlar
+
+| Komut | Ne yapar |
+|---|---|
+| `uvako login --store <mağaza>` | Mağazaya tema erişim anahtarıyla bağlanır. |
+| `uvako logout` · `uvako whoami` | Kayıtlı girişi siler · bağlı mağazayı gösterir. |
+| `uvako theme init <anahtar>` | Yeni tema iskeleti (`--base`, `--name`, `--author`). |
+| `uvako theme check [klasör]` | Temayı denetler: yapı, ayarlar, bölümler, görseller, çeviriler, güvenlik. |
+| `uvako theme dev [klasör]` | Canlı geliştirme: kaydettikçe yükler, önizleme yenilenir. Durdurunca mağaza eski hâline döner (`--keep` ile kütüphanede kalır). |
+| `uvako theme push [klasör]` | Temayı mağazanın tema kütüphanesine yükler. |
+| `uvako theme pull <anahtar>` | Yüklediğiniz temayı indirir (`--dir`, `--force`). |
+| `uvako theme list` | Mağazadaki temaları ve yüklediğiniz paketleri listeler. |
+| `uvako theme submit <anahtar>` | Temayı themes.uvako.com için incelemeye gönderir. |
+| `uvako theme delete <anahtar> --yes` | Yüklediğiniz paketi siler. |
+| `uvako theme package [klasör]` | Denetimden geçen temayı zip paketine çevirir (`--out`). |
+| `uvako version` | Sürümü yazar. |
+
+`uvako-cli` aynı komutların uzun adıdır. Hata varsa çıkış kodu 1'dir. CI için `UVAKO_STORE` ve
+`UVAKO_TOKEN` ortam değişkenleri girişin yerini tutar.
+
+## Tema paketi
+
+Tema kod içermez. Bir katalog temasını (`base`) temel alır ve onun üstüne şunları getirir:
+
+```
+theme.json                     kimlik: key, name, version, base; mağaza vitrini bilgileri
+config/settings_data.json      temel temadan farklı olan ayar değerleri
+config/settings_schema.json    (isteğe bağlı) panelde görünen ayarlar
+templates/index.json           (isteğe bağlı) ana sayfadaki bölüm sırası
+locales/en.json, de.json, tr.json  (isteğe bağlı) temanın kendi metinlerinin çevirisi
+styles/_tokens.scss            renk, yazı tipi, köşe değişkenleri (temanın tamamına yayılır)
+styles/theme.scss              temaya özgü SCSS
+assets/                        logo, slayt ve banner görselleri, yazı tipleri
+reference/                     temel temanın ayarları ve bölüm türleri (pakete girmez)
+```
+
+Bölümlerin kendisi (slayt, banner, ürün vitrini…) temel temadan gelir; paket hangilerinin hangi sırayla
+ve hangi görünümle kullanılacağını söyler. Katalog temaları: [themes.uvako.com](https://themes.uvako.com).
+
+### Diller
+
+Mağazalar vitrinini Türkçe, İngilizce ve Almanca yayınlayabilir. Temanın kendi metinlerini
+(`config/settings_data.json` içindeki başlık ve buton yazıları, `theme.json` içindeki açıklama, sektör ve
+özellikler) çevirmek için pakete sözlük dosyası koyun:
+
+```json
+{
+  "Yeni sezon geldi": "The new season is here",
+  "Alışverişe başla": "Start shopping"
+}
+```
+
+- Dosyalar: `locales/en.json`, `locales/de.json`, `locales/tr.json`. Anahtar temadaki metnin kendisi,
+  değer o dildeki karşılığıdır. Düz bir sözlüktür; iç içe nesne olamaz.
+- Temayı Türkçe yazdıysanız `en.json` ve `de.json` yeterlidir. Başka bir dilde yazdıysanız Türkçe
+  karşılıkları `tr.json` dosyasına koyun.
+- Çevirisi olmayan metin yazıldığı gibi gösterilir. `uvako theme check` her dosyada eksik kalan
+  metinleri uyarı olarak listeler.
+- Mağaza sahibinin panelden değiştirdiği metin sözlükte yoksa olduğu gibi kalır.
+- Sınırlar: dosya başına 256 KB ve 2.000 metin; metin 500, çevirisi 2.000 karakter.
+
+Temel temadan gelen metinler (sepet, ödeme, üyelik, menü) platform tarafından çevrilir; onları
+sözlüğe yazmanız gerekmez.
+
+### CLI dili
+
+Çıktı Türkçe ya da İngilizcedir. Dil sırasıyla `--lang` seçeneğinden, `UVAKO_LANG` ortam değişkeninden
+ve sistemin dilinden okunur: `uvako theme check --lang en`. İngilizce çalışırken `theme init` iskeleti
+(README, SCSS açıklamaları) İngilizce yazar ve Türkçe karşılığı `locales/tr.json` dosyasına koyar.
+
+### Ürün sayfası sekmeleri
+
+Ürün detay sayfasındaki sekmeler `config/settings_data.json` içindeki `product_detail_page_tabs` ile açılır
+(`1` açık, `0` kapalı). Sekme başlıkları ilgili `tab_*` ayarlarıyla değişir.
+
+| `product_detail_page_tabs` anahtarı | Sekme | Başlık ayarı |
+|---|---|---|
+| (her zaman açık) | Ürün Bilgisi | `tab_product_info` |
+| `display_product_comments` | Yorumlar | `tab_product_comments` |
+| `display_product_questions` | Soru & Cevap | `tab_product_questions` |
+| `display_payment_options` | Taksit Seçenekleri (sanal pos oranlarıyla, yoksa elle girilen planlarla) | `tab_product_payment_options` |
+| `display_product_feeds` | Önerileriniz (geri bildirim formu) | `tab_product_feeds` |
+| `display_shopping_experiences` | Alışveriş Deneyimi | `tab_shopping_experiences` |
+
+Taksit sekmesi mağazada satış kapalıysa (fiyatı gizli, WhatsApp satışı) görünmez.
+
+`uvako theme check` bu ayarı denetler: bilinmeyen sekme anahtarı uyarı, 1/0 dışı değer ve metin olmayan başlık hata verir.
+
+## Yayınlama
+
+- `push` ile yüklenen tema **yalnızca kendi mağazanızda** görünür.
+- `submit` temayı Uvako incelemesine gönderir. Onaylanan sürüm themes.uvako.com'da listelenir ve diğer
+  mağazalar kurabilir. Fiyatı (`theme.json` içindeki `price` öneridir) Uvako onaylar.
+- Onaydan sonra yüklediğiniz yeni sürümler yeniden onaylanana kadar yalnızca kendi mağazanızı etkiler.
+
+## Güvenlik kuralları
+
+Mağaza, yüklenen paketi aynı kurallarla **kendisi yeniden denetler**; `check` hatayı önceden görmeniz içindir.
+
+- Yalnızca yukarıdaki dosyalar kabul edilir: JSON, SCSS, görsel ve yazı tipi. JavaScript, şablon ve
+  çalıştırılabilir dosyalar reddedilir.
+- `<script>`, `javascript:` adresleri, `onclick` gibi olay öznitelikleri, `<iframe>` (SVG ve ayar metinleri dahil).
+- Kod çalıştıran CSS (`expression`, `behavior`, `-moz-binding`).
+- SCSS içinde döngü, fonksiyon ve mixin tanımı (`@while`, `@for`, `@each`, `@function`, `@mixin`, `@use`).
+  Temel temanın mixin'leri `@include` ile kullanılabilir.
+- Paketin kendi dosyaları dışındaki `@import`'lar ve yazı tipi sağlayıcıları dışındaki adresler.
+- Sembolik bağlar, gizli dosyalar, 5 MB'tan büyük dosyalar, 60 MB'tan büyük ya da 600 dosyadan fazla paketler.
+- Gizli anahtar ya da parola gibi görünen değerler.
+
+Erişim anahtarı yalnızca tema işlemlerine yetkilidir; sipariş, müşteri ve ayarlara erişemez. Bilgisayarınızda
+kullanıcı klasörünüzde saklanır, tema klasörüne yazılmaz, yalnızca giriş yaptığınız mağazaya ve yalnızca
+https üzerinden gönderilir. Kaybederseniz panelden iptal edin.
+
+Araç platformun kaynak kodunu içermez.
+
+## Uvako
+
+[uvako.com](https://uvako.com)
+
+Uvako, işletmelerin kendi alan adıyla online mağaza kurmasını sağlayan e-ticaret altyapısıdır. Ürün, sipariş, ödeme, kargo, kampanya ve tema yönetimi tek panelde toplanır.
+
+## Rox Software · Rox Group
+
+Bu paket **Rox Software** tarafından geliştirilir ve yayınlanır.
+
+Rox Software; kurumsal web, e-ticaret, özel yazılım ve kendi ürün platformlarını (RoxB2B, RoxETS, Uvako) geliştiren Ankara merkezli yazılım ekibidir.
+
+**Rox Group Yazılım Havacılık Uzay ve Savunma Sanayi Limited Şirketi**  
+İvedikköy Mahallesi 1493. Sokak No:5 Daire:22  
+06378 Yenimahalle / Ankara
+
+- Site: [roxsoftware.net](https://www.roxsoftware.net/)
+- Uvako: [uvako.com](https://uvako.com)
+- E-posta: info@roxsoftware.net
+
+Tüm hakları saklıdır. © Rox Group

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uvako-cli",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "description": "Uvako tema geliştirme aracı. Tema başlatır, denetler, mağazaya yükler ve canlı önizletir. https://uvako.com",
   "type": "module",
   "license": "UNLICENSED",

package/src/api.js

@@ -1,3 +1,4 @@
+import { t } from "./i18n.js";
 // Mağazanın tema uç noktası (/api/theme-cli). Erişim anahtarı yalnızca girişte seçilen mağazaya
 // gönderilir: yönlendirmeler izlenmez, böylece anahtar başka bir adrese taşınmaz.
 
@@ -21,7 +22,7 @@ export async function call({ origin, token }, method, route, { body, raw = false
       signal: AbortSignal.timeout(timeout),
     });
   } catch (error) {
-    throw new ApiError(`Mağazaya bağlanılamadı (${origin}): ${error.cause?.code ?? error.message}`);
+    throw new ApiError(t("Mağazaya bağlanılamadı ({0}): {1}", origin, error.cause?.code ?? error.message));
   }
   if (response.ok) return raw ? Buffer.from(await response.arrayBuffer()) : response.json();
   let payload = null;
@@ -31,7 +32,7 @@ export async function call({ origin, token }, method, route, { body, raw = false
     // JSON olmayan yanıt (ör. ağ geçidi hatası).
   }
   const problem = payload?.error ?? {};
-  const fallback = response.status === 404 ? "Bu adreste Uvako tema uç noktası yok. Mağaza adresini kontrol edin." : `Sunucu ${response.status} yanıtı verdi.`;
+  const fallback = response.status === 404 ? t("Bu adreste Uvako tema uç noktası yok. Mağaza adresini kontrol edin.") : t("Sunucu {0} yanıtı verdi.", response.status);
   throw new ApiError(problem.message || fallback, { status: response.status, code: problem.code || "", problems: Array.isArray(problem.problems) ? problem.problems : [] });
 }
 
@@ -41,9 +42,9 @@ export async function starter(site, base) {
   try {
     response = await fetch(`${site}/api/site/themes/${encodeURIComponent(base)}/starter`, { headers: { Accept: "application/json", "User-Agent": "uvako-cli" }, signal: AbortSignal.timeout(30000) });
   } catch (error) {
-    throw new ApiError(`uvako.com'a bağlanılamadı: ${error.cause?.code ?? error.message}`);
+    throw new ApiError(t("uvako.com'a bağlanılamadı: {0}", error.cause?.code ?? error.message));
   }
-  if (response.status === 404) throw new ApiError(`"${base}" adında bir temel tema yok. Temalar: https://themes.uvako.com`, { status: 404 });
-  if (!response.ok) throw new ApiError(`Temel tema okunamadı (${response.status}).`, { status: response.status });
+  if (response.status === 404) throw new ApiError(t("\"{0}\" adında bir temel tema yok. Temalar: https://themes.uvako.com", base), { status: 404 });
+  if (!response.ok) throw new ApiError(t("Temel tema okunamadı ({0}).", response.status), { status: response.status });
   return response.json();
 }