uvako-cli 0.4.0 → 0.6.0

package/src/main.js

@@ -6,39 +6,56 @@ import { checkTheme, printReport } from "./check.js";
 import { session, siteOrigin } from "./config.js";
 import { initTheme } from "./init.js";
 import { packageTheme } from "./package.js";
-import { dev, list, login, logout, pull, push, remove, submit, whoami } from "./remote.js";
-import { getLocale, t } from "./i18n.js";
+import { dev, list, login, logout, pull, push, remoteCheck, remove, submit, whoami } from "./remote.js";
+import { appCommand } from "./app.js";
+import { partnerLogin, partnerLogout, partnerWhoami } from "./partner.js";
+import { getLocale, t, tm } from "./i18n.js";
 import { help as helpEn } from "./locales/en.js";
 
 const version = JSON.parse(readFileSync(path.join(path.dirname(fileURLToPath(import.meta.url)), "..", "package.json"), "utf8")).version;
 
-const helpTr = `uvako-cli ${version} — Uvako tema geliştirme aracı
+const helpTr = `uvako-cli ${version} — Uvako tema ve uygulama geliştirme aracı
 https://uvako.com
 
 Giriş:
+  uvako login                                  Partner hesabıyla giriş (tarayıcıda onaylanır; uygulama komutları)
   uvako login --store <mağaza>                 Mağazaya tema erişim anahtarıyla bağlanır (anahtar sorulur)
-  uvako logout [--store <mağaza>]              Kayıtlı girişi siler
-  uvako whoami                                 Bağlı mağazayı gösterir
+  uvako logout [--store <mağaza>] [--partner]  Kayıtlı girişi siler
+  uvako whoami                                 Bağlı mağazayı ve partner girişini gösterir
+
+Uygulama (herkese açık uygulamalar, partner girişiyle):
+  uvako app init <ad> [--dir klasör] [--offline]
+                                               Örnek uygulama (OAuth kurulumu, imzalı webhook'lar) ve uvako.app.json
+  uvako app dev [klasör] --store <mağaza> [--port 3000] [--no-serve] [--no-update]
+                                               Uygulamayı yerelde çalıştırır; geliştirme mağazası yerel adrese bağlanır,
+                                               o mağazanın webhook'ları bilgisayarınızdaki alıcıya aktarılır
+  uvako app deploy [klasör] [--submit]         uvako.app.json'u yeni sürüm olarak dağıtır (önce yalnızca kendi mağazalarınızda)
+  uvako app submit [klasör]                    Uygulamayı herkese açılması için Uvako incelemesine gönderir
+  uvako app list [--json]                      Kayıtlı uygulamalarınızı listeler
 
 Tema:
-  uvako theme init <anahtar> [--base linea] [--name "Ad"] [--author "Yazar"]
+  uvako theme init <anahtar> [--base linea] [--name "Ad"] [--author "Yazar"] [--engine sections]
                                                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
+                                               --engine sections: kendi bölümlerini getiren tema (örnek bölümlerle)
+  uvako theme check [klasör] [--offline]       Temayı denetler (yapı, ayarlar, güvenlik, bölüm şablonları);
+                                               giriş yapılmışsa sunucu da aynı kurallarla denetler
+  uvako theme dev [klasör]                     Canlı geliştirme: yalnızca değişen dosyayı 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 push [klasör] [--force]          Temayı mağazanın tema kütüphanesine yükler (SHA-256 ve revizyonla;
+                                               paket sizden sonra değiştiyse reddedilir, --force üzerine yazar)
+  uvako theme pull <anahtar> [--dir klasör]    Yüklediğiniz temayı indirir (sections/, snippets/, templates/ dahil)
   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] [--out x.zip]   Denetleyip zip paketi üretir
   uvako version                                Sürümü yazar
 
-Tema, kod çalıştırmayan bir pakettir: ayarlar, bölüm sırası, SCSS ve görseller.
-JavaScript, şablon ya da sunucu kodu içeren paketler reddedilir. Yüklenen tema yalnızca kendi
-mağazanızda görünür; tema mağazasında yayınlanması Uvako incelemesine bağlıdır.
+Tema, kod çalıştırmayan bir pakettir: ayarlar, sayfa şablonları, SCSS ve görseller. "engine": "sections"
+temaları kendi bölümlerini (sections/*.html.tmpl) getirebilir; bunlar yalnızca sunucuda, kısıtlı bir
+şablon dilinde çizilir. JavaScript ya da sunucu kodu içeren paketler reddedilir. Yüklenen tema yalnızca
+kendi mağazanızda görünür; tema mağazasında yayınlanması Uvako incelemesine bağlıdır.
 
-CI için: UVAKO_STORE ve UVAKO_TOKEN ortam değişkenleri girişin yerini tutar.
+CI için: UVAKO_STORE ve UVAKO_TOKEN (tema), UVAKO_PARTNER_TOKEN (uygulama) ortam değişkenleri girişin yerini tutar.
 Dil: --lang en ya da UVAKO_LANG=en çıktıyı İngilizce verir.
 
 Uvako — https://uvako.com
@@ -93,9 +110,31 @@ export async function main(argv) {
     console.log(version);
     return 0;
   }
-  if (group === "login") return login(options);
-  if (group === "logout") return logout(options);
-  if (group === "whoami") return whoami(options);
+  // Tek giriş: mağaza belirtilmezse partner hesabıyla (uygulama komutları), belirtilirse tema anahtarıyla.
+  if (group === "login") return options.store ? login(options) : partnerLogin(options);
+  if (group === "logout") {
+    if (options.partner) return partnerLogout();
+    const code = await logout(options);
+    if (options.all) await partnerLogout();
+    return code;
+  }
+  if (group === "whoami") {
+    const partner = await partnerWhoami();
+    if (partner && !options.store && !process.env.UVAKO_STORE) {
+      try {
+        session("");
+      } catch {
+        return 0;
+      }
+    }
+    return whoami(options);
+  }
+  if (group === "app") {
+    const code = await appCommand(command, target, options);
+    if (code !== null) return code;
+    console.error(t("Bilinmeyen uygulama komutu: {0}\n\n{1}", command ?? "(yok)", help));
+    return 1;
+  }
   if (group !== "theme") {
     console.error(t("Bilinmeyen komut: {0}\n\n{1}", group, help));
     return 1;
@@ -103,16 +142,33 @@ export async function main(argv) {
   if (command === "init") {
     if (!target) throw new Error(t("Tema anahtarı gerekli: uvako theme init <anahtar>"));
     const base = typeof options.base === "string" ? options.base : "linea";
-    const dir = initTheme(target, { name: options.name, author: options.author, cwd: process.cwd(), base, starter: await fetchStarter(base, options) });
+    const engine = typeof options.engine === "string" ? options.engine : "";
+    const dir = initTheme(target, { name: options.name, author: options.author, cwd: process.cwd(), base, engine, starter: await fetchStarter(base, options) });
     const rel = path.relative(process.cwd(), dir) || ".";
     console.log(t("Tema oluşturuldu: {0} (temel: {1})", rel, base));
     console.log(t("Sıradaki adım: uvako login --store <mağaza>, sonra: uvako theme dev {0}", rel));
     return 0;
   }
   if (command === "check") {
-    const report = checkTheme(path.resolve(target ?? "."));
+    const dir = path.resolve(target ?? ".");
+    const report = checkTheme(dir);
     printReport(report);
-    return report.errors.length ? 1 : 0;
+    if (report.errors.length) return 1;
+    // Giriş yapılmışsa sunucu da aynı paketi kuru olarak denetler: yerelde geçen sunucuda da geçer.
+    if (options.offline || report.layout !== "package") return 0;
+    const remote = await remoteCheck(dir, options);
+    if (!remote) {
+      console.log(t("Sunucu denetimi için giriş yapın (uvako login --store <mağaza>) ya da --offline ekleyin."));
+      return 0;
+    }
+    if (!remote.ok) {
+      console.error(t("✖ Sunucu denetimi ({0}): {1}", remote.origin, tm(remote.message)));
+      for (const problem of remote.problems) console.error(`  ✖ ${tm(problem)}`);
+      return 1;
+    }
+    for (const warning of remote.warnings) console.warn(`  ! ${tm(warning)}`);
+    console.log(t("Sunucu denetimi ({0}): geçti.", remote.origin));
+    return 0;
   }
   if (command === "package") {
     const result = packageTheme(path.resolve(target ?? "."), { out: typeof options.out === "string" ? options.out : undefined });

package/src/partner.js

@@ -0,0 +1,135 @@
+import { spawn } from "node:child_process";
+import os from "node:os";
+import { dropPartner, partnerOrigin, partnerSaved, partnerSession, savePartner } from "./config.js";
+import { ApiError } from "./api.js";
+import { t, tm } from "./i18n.js";
+
+// Partner paneliyle konuşan istemci (/api/partner/cli). Giriş cihaz akışıyla yapılır: CLI bir kod
+// alır, partner tarayıcıda partner paneline (şifre + iki adımlı doğrulama) girip onaylar, CLI uvp_
+// anahtarını alır. Anahtar ekrana yazılmaz, yalnızca partner adresine gönderilir; yönlendirme izlenmez.
+
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+
+async function request(origin, method, route, { token, body, timeout = 60000 } = {}) {
+  let response;
+  try {
+    response = await fetch(`${origin}/api/partner/cli${route}`, {
+      method,
+      redirect: "error",
+      headers: { Accept: "application/json", "User-Agent": "uvako-cli", ...(token ? { Authorization: `Bearer ${token}` } : {}), ...(body !== undefined ? { "Content-Type": "application/json" } : {}) },
+      body: body !== undefined ? JSON.stringify(body) : undefined,
+      signal: AbortSignal.timeout(timeout),
+    });
+  } catch (error) {
+    throw new ApiError(t("Partner paneline bağlanılamadı ({0}): {1}", origin, error.cause?.code ?? error.message));
+  }
+  let payload = null;
+  try {
+    payload = await response.json();
+  } catch {
+    // JSON olmayan yanıt (ör. ağ geçidi hatası).
+  }
+  if (response.ok) return payload;
+  // Cihaz girişinin RFC 8628 yanıtları {"error": "kod", "error_description": "…"} biçimindedir.
+  if (typeof payload?.error === "string") throw new ApiError(payload.error_description || payload.error, { status: response.status, code: payload.error });
+  const problem = payload?.error ?? {};
+  const fallback = response.status === 404 ? t("Bu adreste Uvako partner uç noktası yok (UVAKO_PARTNER_URL?).") : t("Sunucu {0} yanıtı verdi.", response.status);
+  throw new ApiError(problem.message || fallback, { status: response.status, code: problem.field || "", problems: [] });
+}
+
+/** Giriş yapmış partner olarak uç noktayı çağırır. */
+export function partnerCall(method, route, options = {}) {
+  const current = partnerSession();
+  return request(current.origin, method, route, { ...options, token: current.token });
+}
+
+export function explainPartner(error) {
+  if (!(error instanceof ApiError)) throw error;
+  console.error(`✖ ${tm(error.message)}${error.status === 422 && error.code ? ` (${error.code})` : ""}`);
+  if (error.status === 401) console.error(t("  Yeniden giriş yapın: uvako login"));
+  return 1;
+}
+
+function openBrowser(url) {
+  const [command, args] = process.platform === "win32" ? ["cmd", ["/c", "start", "", url]] : process.platform === "darwin" ? ["open", [url]] : ["xdg-open", [url]];
+  try {
+    const child = spawn(command, args, { stdio: "ignore", detached: true, windowsHide: true });
+    child.on("error", () => undefined);
+    child.unref();
+  } catch {
+    // Tarayıcı açılamazsa adres zaten ekranda.
+  }
+}
+
+/** `uvako login` (mağaza belirtilmeden): partner hesabıyla cihaz girişi. */
+export async function partnerLogin(options) {
+  const origin = partnerOrigin();
+  let device;
+  try {
+    device = await request(origin, "POST", "/device", { body: { label: `uvako-cli · ${os.hostname()}`.slice(0, 80) } });
+  } catch (error) {
+    return explainPartner(error);
+  }
+  // Sunucunun verdiği adres yalnızca partner panelinin kendi alan adındaysa açılır (yerel geliştirmede
+  // panel ile API farklı portlarda olabilir; şifresiz bağlantı yalnızca yerel adreste kabul edilir).
+  const verify = new URL(device.verification_uri_complete);
+  const api = new URL(origin);
+  const sameHost = verify.hostname === api.hostname && (verify.protocol === "https:" || (verify.protocol === "http:" && api.protocol === "http:"));
+  if (!sameHost) throw new Error(t("Sunucu beklenmeyen bir doğrulama adresi verdi: {0}", verify.origin));
+  console.log(t("Partner paneline giriş: tarayıcıda açılan sayfada kodu onaylayın."));
+  console.log(t("  Adres: {0}", verify.href));
+  console.log(t("  Kod:   {0}\n", device.user_code));
+  if (!options["no-browser"]) openBrowser(verify.href);
+  let interval = Math.max(1, Number(device.interval) || 3) * 1000;
+  const deadline = Date.now() + (Number(device.expires_in) || 600) * 1000;
+  while (Date.now() < deadline) {
+    await sleep(interval);
+    try {
+      const result = await request(origin, "POST", "/token", { body: { device_code: device.device_code } });
+      const me = await request(origin, "GET", "/me", { token: result.access_token });
+      const name = `${me.member?.firstName ?? ""} ${me.member?.lastName ?? ""}`.trim();
+      savePartner(origin, result.access_token, me.company?.name ?? "", me.member?.email ?? "");
+      console.log(t("Giriş yapıldı: {0} ({1}) — {2}", name || me.member?.email, me.company?.name ?? "", origin));
+      if (me.company?.status !== "approved") console.warn(t("! Partner başvurunuz henüz onaylanmadı; uygulama kaydı onaydan sonra açılır."));
+      return 0;
+    } catch (error) {
+      if (!(error instanceof ApiError)) throw error;
+      if (error.code === "authorization_pending") continue;
+      if (error.code === "slow_down") {
+        interval += 2000;
+        continue;
+      }
+      return explainPartner(error);
+    }
+  }
+  console.error(t("✖ Giriş kodunun süresi doldu. `uvako login` komutunu yeniden çalıştırın."));
+  return 1;
+}
+
+export async function partnerLogout() {
+  const saved = partnerSaved();
+  if (!saved) {
+    console.log(t("Kayıtlı partner girişi yok."));
+    return 0;
+  }
+  try {
+    await partnerCall("POST", "/logout", { body: {} });
+  } catch {
+    // Sunucuya ulaşılamasa da yerel giriş silinir; anahtar partner panelinden de kapatılabilir.
+  }
+  dropPartner();
+  console.log(t("Partner girişinden çıkıldı: {0}", saved.origin));
+  return 0;
+}
+
+export async function partnerWhoami() {
+  if (!partnerSaved() && !process.env.UVAKO_PARTNER_TOKEN) return false;
+  try {
+    const me = await partnerCall("GET", "/me");
+    console.log(t("Partner: {0} — {1} ({2})", me.company?.name ?? "", me.member?.email ?? "", partnerSession().origin));
+  } catch (error) {
+    if (error instanceof ApiError) console.error(t("Partner: {0}", tm(error.message)));
+    else throw error;
+  }
+  return true;
+}

package/src/remote.js

@@ -1,7 +1,7 @@
-import { existsSync, mkdirSync, readFileSync, watch, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, statSync, watch, writeFileSync } from "node:fs";
 import path from "node:path";
 import { ApiError, call } from "./api.js";
-import { printReport } from "./check.js";
+import { checkTheme, localOnly, printReport } from "./check.js";
 import { dropSession, saveSession, session, sessions, storeOrigin } from "./config.js";
 import { buildArchive } from "./package.js";
 import { unzip } from "./zip.js";
@@ -50,9 +50,31 @@ function explain(error) {
   console.error(`✖ ${tm(error.message)}`);
   for (const problem of error.problems) console.error(`  ✖ ${tm(problem)}`);
   if (error.status === 401) console.error(t("  Yeni anahtar: mağaza paneli → Ayarlar → Temalar → Geliştirici erişimi, sonra `uvako login`."));
+  if (error.status === 429) console.error(t("  Yükleme sınırı aşıldı. {0} saniye sonra tekrar deneyin.", error.retryAfter || 5));
+  if (error.code === "conflict") console.error(t("  Sunucudaki sürümü almak için: uvako theme pull <anahtar> --force. Üzerine yazmak için: uvako theme push --force"));
   return 1;
 }
 
+// Yerel durum: son push/pull'un revizyonu. Push bu revizyonu gönderir; paket arada başka biri
+// tarafından değiştirildiyse sunucu yüklemeyi reddeder (409). Dosya pakete girmez.
+function readState(dir) {
+  try {
+    return JSON.parse(readFileSync(path.join(dir, ".uvako", "state.json"), "utf8"));
+  } catch {
+    return null;
+  }
+}
+
+function writeState(dir, state) {
+  mkdirSync(path.join(dir, ".uvako"), { recursive: true });
+  writeFileSync(path.join(dir, ".uvako", "state.json"), `${JSON.stringify(state, null, 2)}\n`);
+}
+
+function baseRevision(dir, current, key, force) {
+  const state = readState(dir);
+  return !force && state && state.origin === current.origin && state.key === key && Number.isInteger(state.revision) ? { "X-Uvako-Base-Revision": String(state.revision) } : {};
+}
+
 const previewUrl = (origin, installationId) => `${origin}/?preview=${installationId}`;
 const editorUrl = (origin, installationId) => `${origin}/admin/ayarlar/temalar/${installationId}/editor`;
 
@@ -115,23 +137,46 @@ export async function list(options) {
   }
 }
 
-async function upload(current, dir, quiet = false) {
+async function upload(current, dir, quiet = false, force = false) {
   const built = buildArchive(dir);
   if (!built.ok) {
     printReport(built.report);
     return null;
   }
   if (!quiet) printReport(built.report);
-  const result = await call(current, "PUT", "/themes", { body: built.buffer });
+  // SHA-256: paket yolda bozulursa sunucu reddeder. Revizyon: başkasının yüklemesinin üstüne yazılmaz.
+  const headers = { "X-Uvako-Package-Sha256": built.sha256, ...baseRevision(dir, current, built.meta.key, force) };
+  const result = await call(current, "PUT", "/themes", { body: built.buffer, headers });
+  writeState(dir, { origin: current.origin, key: result.package.key, revision: result.package.revision });
   for (const warning of result.warnings ?? []) console.warn(`  ! ${warning}`);
   return result;
 }
 
+/** Kuru denetim: sunucu paketi yükleme kurallarıyla denetler, hiçbir şey kaydetmez. */
+export async function remoteCheck(dir, options) {
+  let current;
+  try {
+    current = session(typeof options.store === "string" ? options.store : "");
+  } catch {
+    return null;
+  }
+  const built = buildArchive(dir);
+  if (!built.ok) return null;
+  try {
+    const result = await call(current, "POST", "/themes/check", { body: built.buffer });
+    return { ok: true, origin: current.origin, warnings: result.warnings ?? [] };
+  } catch (error) {
+    if (!(error instanceof ApiError)) throw error;
+    if (error.status === 422 || error.status === 403) return { ok: false, origin: current.origin, message: error.message, problems: error.problems };
+    return { ok: true, origin: current.origin, warnings: [t("Sunucu denetimi yapılamadı: {0}", tm(error.message))] };
+  }
+}
+
 export async function push(target, options) {
   const dir = path.resolve(target ?? ".");
   try {
     const current = session(typeof options.store === "string" ? options.store : "");
-    const result = await upload(current, dir);
+    const result = await upload(current, dir, false, Boolean(options.force));
     if (!result) {
       console.error(t("Yüklenmedi: önce hataları düzeltin."));
       return 1;
@@ -185,7 +230,29 @@ export async function dev(target, options) {
   let timer = null;
   let running = false;
   let again = false;
+  const changed = new Set();
   const stamp = () => new Date().toLocaleTimeString("tr-TR");
+  // Yalnızca değişen dosyalar gönderilir; sunucu paketin tamamını yine aynı kurallarla denetler.
+  const sendChanges = async () => {
+    const files = [...changed];
+    changed.clear();
+    const report = checkTheme(dir);
+    if (report.errors.length) {
+      printReport(report);
+      return null;
+    }
+    if (files.length > 10 || files.includes("theme.json")) return upload(current, dir, true);
+    let result = null;
+    for (const rel of files) {
+      const full = path.join(dir, rel);
+      const exists = existsSync(full) && statSync(full).isFile();
+      const route = `/themes/${encodeURIComponent(first.package.key)}/files/${rel.split("/").map(encodeURIComponent).join("/")}`;
+      const headers = baseRevision(dir, current, first.package.key, false);
+      result = await call(current, exists ? "PUT" : "DELETE", route, exists ? { body: readFileSync(full), headers, contentType: "application/octet-stream" } : { headers });
+      writeState(dir, { origin: current.origin, key: result.package.key, revision: result.package.revision });
+    }
+    return result;
+  };
   const sync = async () => {
     if (running) {
       again = true;
@@ -193,13 +260,14 @@ export async function dev(target, options) {
     }
     running = true;
     try {
-      const result = await upload(current, dir, true);
+      const result = await sendChanges();
       if (result) console.log(t("[{0}] yüklendi (sürüm no {1})", stamp(), result.package.revision));
       else console.error(t("[{0}] yüklenmedi: hataları düzeltip kaydedin.", stamp()));
     } catch (error) {
       if (error instanceof ApiError) {
         console.error(`[${stamp()}] ✖ ${tm(error.message)}`);
         for (const problem of error.problems) console.error(`  ✖ ${tm(problem)}`);
+        if (error.status === 429) console.error(t("  Yükleme sınırı aşıldı. {0} saniye sonra tekrar deneyin.", error.retryAfter || 5));
         if (error.status === 401 || error.status === 403) process.exit(1);
       } else {
         console.error(`[${stamp()}] ✖ ${tm(error.message)}`);
@@ -214,7 +282,9 @@ export async function dev(target, options) {
   };
   const watcher = watch(dir, { recursive: true }, (_event, file) => {
     const rel = String(file ?? "").replaceAll("\\", "/");
-    if (!rel || rel.startsWith("reference/") || rel.startsWith(".git/") || rel.includes("node_modules/") || rel.endsWith(".zip") || rel.endsWith("~") || rel.split("/").some((part) => part.startsWith("."))) return;
+    if (!rel || localOnly(rel) || rel.startsWith(".git/") || rel.includes("node_modules/") || rel.endsWith("~") || rel.split("/").some((part) => part.startsWith("."))) return;
+    if (existsSync(path.join(dir, rel)) && statSync(path.join(dir, rel)).isDirectory()) return;
+    changed.add(rel);
     clearTimeout(timer);
     timer = setTimeout(() => void sync(), 300);
   });
@@ -264,6 +334,9 @@ export async function pull(key, options) {
       writeFileSync(file, entry.data);
       count++;
     }
+    const state = await call(current, "GET", "/themes");
+    const pkg = (state.packages ?? []).find((item) => item.key === key);
+    if (pkg) writeState(dir, { origin: current.origin, key, revision: pkg.revision });
     console.log(t("İndirildi: {0} ({1} dosya)", path.relative(process.cwd(), dir) || ".", count));
     return 0;
   } catch (error) {