uvako-cli 0.2.0 → 0.3.0

package/README.md

@@ -1,125 +1,143 @@
-# 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. |
-| `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, 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).
+
+### Ü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.0",
+  "version": "0.3.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/check.js

@@ -172,6 +172,36 @@ function checkTemplate(index, types, report, source) {
   }
 }
 
+// Ürün sayfası sekmeleri: product_detail_page_tabs anahtarları ve her sekmenin başlık ayarı.
+export const productTabKeys = {
+  display_product_comments: "tab_product_comments",
+  display_product_questions: "tab_product_questions",
+  display_payment_options: "tab_product_payment_options",
+  display_product_feeds: "tab_product_feeds",
+  display_shopping_experiences: "tab_shopping_experiences",
+  display_special_information_area: null,
+};
+
+function checkProductTabs(data, report) {
+  if (!data || typeof data !== "object" || !("product_detail_page_tabs" in data)) return;
+  const value = data.product_detail_page_tabs;
+  if ([0, 1, "0", "1", true, false].includes(value)) return;
+  const where = 'config/settings_data.json: "product_detail_page_tabs"';
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
+    report.errors.push(`${where} 1 (hepsi açık) ya da {"display_product_comments": 1, …} nesnesi olmalı.`);
+    return;
+  }
+  for (const [key, flag] of Object.entries(value)) {
+    if (!(key in productTabKeys)) {
+      report.warnings.push(`${where}: "${key}" bilinen bir sekme değil (${Object.keys(productTabKeys).join(", ")}).`);
+      continue;
+    }
+    if (![0, 1, "0", "1", true, false].includes(flag)) report.errors.push(`${where}: "${key}" değeri 1 ya da 0 olmalı.`);
+    const label = productTabKeys[key];
+    if (label && label in data && typeof data[label] !== "string") report.errors.push(`config/settings_data.json: "${label}" sekme başlığı metin olmalı.`);
+  }
+}
+
 function checkImages(data, assets, report) {
   if (!data || typeof data !== "object") return;
   for (const [name, value] of Object.entries(data)) {
@@ -245,6 +275,7 @@ function checkPackage(dir, meta, report) {
   const reference = existsSync(path.join(dir, "reference", "sections.json")) ? readJson(path.join(dir, "reference", "sections.json"), { errors: [] }, "") : null;
   checkTemplate(index, reference?.sections ? new Set(Object.keys(reference.sections)) : null, report, `${base} temasında`);
   checkImages(data, path.join(dir, "assets"), report);
+  checkProductTabs(data, report);
   for (const shot of [meta?.screenshot, ...(Array.isArray(meta?.screenshots) ? meta.screenshots : [])]) {
     const rel = String(shot ?? "").trim().replace(/^\//, "").replace(/^assets\//, "");
     if (rel && !existsSync(path.join(dir, "assets", rel))) report.errors.push(`theme.json: ekran görüntüsü pakette yok (assets/${rel}).`);
@@ -289,6 +320,7 @@ function checkRepo(dir, meta, key, where, report) {
   }
   const data = readJson(path.join(dir, "config", "settings_data.json"), report, "config/settings_data.json");
   if (data && (typeof data !== "object" || Array.isArray(data))) report.errors.push("config/settings_data.json: anahtar-değer nesnesi olmalı.");
+  else checkProductTabs(data, report);
 
   const sections = readJson(path.join(dir, "config", "sections.json"), report, "config/sections.json");
   const types = new Set(Object.keys(sections?.sections ?? {}));

package/src/main.js

@@ -23,6 +23,7 @@ Tema:
                                                Bir katalog temasını temel alan yeni tema iskeleti
   uvako theme check [klasör]                   Temayı denetler (yapı, ayarlar, güvenlik)
   uvako theme dev [klasör]                     Canlı geliştirme: kaydettikçe mağazaya yükler, önizleme yenilenir
+                                               Durdurunca mağaza eski hâline döner (--keep: kütüphanede bırak)
   uvako theme push [klasör]                    Temayı mağazanın tema kütüphanesine yükler
   uvako theme pull <anahtar> [--dir klasör]    Yüklediğiniz temayı indirir
   uvako theme list                             Mağazadaki temaları ve yüklediğiniz paketleri listeler

package/src/remote.js

@@ -1,4 +1,4 @@
-import { existsSync, mkdirSync, watch, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, watch, writeFileSync } from "node:fs";
 import path from "node:path";
 import { ApiError, call } from "./api.js";
 import { printReport } from "./check.js";
@@ -152,11 +152,23 @@ export async function dev(target, options) {
   const dir = path.resolve(target ?? ".");
   let current;
   let first;
+  // Geliştirme bitince mağaza başladığı hâle döner: paket önceden yüklüyse o sürüm geri yüklenir,
+  // değilse geliştirme kopyası silinir. `--keep` son hâli kütüphanede bırakır.
+  let before = null;
+  let existed = false;
   try {
     current = session(typeof options.store === "string" ? options.store : "");
+    const key = String(JSON.parse(readFileSync(path.join(dir, "theme.json"), "utf8")).key ?? "");
+    if (!options.keep && key) {
+      const state = await call(current, "GET", "/themes");
+      existed = state.packages.some((pkg) => pkg.key === key);
+      if (existed) before = await call(current, "GET", `/themes/${encodeURIComponent(key)}/package`, { raw: true });
+    }
     first = await upload(current, dir);
   } catch (error) {
-    return explain(error);
+    if (error instanceof ApiError) return explain(error);
+    console.error(`✖ ${error.message}`);
+    return 1;
   }
   if (!first) {
     console.error("Başlatılamadı: önce hataları düzeltin.");
@@ -166,6 +178,8 @@ export async function dev(target, options) {
   console.log(`Önizleme:  ${previewUrl(current.origin, first.installationId)}`);
   console.log(`Düzenleme: ${editorUrl(current.origin, first.installationId)}`);
   console.log("Önizleme için tarayıcıda mağaza paneline giriş yapın. Dosyaları kaydettikçe sayfa yenilenir. Durdurmak için Ctrl+C.\n");
+  console.log(options.keep ? "Durdurduğunuzda tema son hâliyle kütüphanede kalır (--keep)." : existed ? "Durdurduğunuzda mağazadaki paket geliştirme öncesindeki sürümüne döner. Kalıcı yüklemek için: uvako theme push" : "Durdurduğunuzda geliştirme kopyası mağazadan silinir. Kalıcı yüklemek için: uvako theme push");
+  console.log("");
 
   let timer = null;
   let running = false;
@@ -204,10 +218,29 @@ export async function dev(target, options) {
     timer = setTimeout(() => void sync(), 300);
   });
   return new Promise((resolve) => {
-    process.on("SIGINT", () => {
+    let stopping = false;
+    process.on("SIGINT", async () => {
+      if (stopping) return;
+      stopping = true;
       watcher.close();
-      console.log("\nCanlı geliştirme durdu. Tema mağaza kütüphanesinde duruyor.");
-      resolve(0);
+      clearTimeout(timer);
+      const key = first.package.key;
+      try {
+        if (options.keep) {
+          console.log("\nCanlı geliştirme durdu. Tema son hâliyle mağaza kütüphanesinde duruyor.");
+        } else if (before) {
+          await call(current, "PUT", "/themes", { body: before });
+          console.log("\nCanlı geliştirme durdu. Mağazadaki paket geliştirme öncesindeki sürümüne döndü.");
+        } else {
+          await call(current, "DELETE", `/themes/${encodeURIComponent(key)}`);
+          console.log("\nCanlı geliştirme durdu. Geliştirme kopyası mağazadan silindi; vitrin ve kütüphane eski hâlinde.");
+        }
+        resolve(0);
+      } catch (error) {
+        console.error(`\nCanlı geliştirme durdu ama mağaza eski hâline döndürülemedi: ${error.message}`);
+        console.error(`Elle kaldırmak için: uvako theme delete ${key} --yes`);
+        resolve(1);
+      }
     });
   });
 }