uvako-cli 0.3.0 → 0.5.0

package/src/package.js

@@ -4,13 +4,14 @@ import path from "node:path";
 import { checkTheme, limits, localOnly } from "./check.js";
 import { walk } from "./files.js";
 import { zip } from "./zip.js";
+import { t } from "./i18n.js";
 
 /** Denetimden geçen temanın zip paketini bellekte üretir. Yardımcı dosyalar (README, reference/) pakete girmez. */
 export function buildArchive(dir) {
   const report = checkTheme(dir);
   if (report.errors.length) return { ok: false, report };
   if (report.layout !== "package") {
-    report.errors.push("Bu klasör platform deposundaki bir tema; paketleme ve yükleme yalnızca bağımsız tema klasörlerinde yapılır.");
+    report.errors.push(t("Bu klasör platform deposundaki bir tema; paketleme ve yükleme yalnızca bağımsız tema klasörlerinde yapılır."));
     return { ok: false, report };
   }
   const meta = JSON.parse(readFileSync(path.join(dir, "theme.json"), "utf8"));
@@ -19,7 +20,7 @@ export function buildArchive(dir) {
     .map((file) => ({ name: `${meta.key}/${file.rel}`, data: readFileSync(file.full) }));
   const buffer = zip(entries);
   if (buffer.length > limits.archiveBytes) {
-    report.errors.push(`Paket ${(buffer.length / 1024 / 1024).toFixed(0)} MB; yükleme sınırı ${limits.archiveBytes / 1024 / 1024} MB.`);
+    report.errors.push(t("Paket {0} MB; yükleme sınırı {1} MB.", (buffer.length / 1024 / 1024).toFixed(0), limits.archiveBytes / 1024 / 1024));
     return { ok: false, report };
   }
   return { ok: true, report, meta, buffer, files: entries.length, sha256: createHash("sha256").update(buffer).digest("hex") };

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

@@ -5,6 +5,7 @@ import { printReport } from "./check.js";
 import { dropSession, saveSession, session, sessions, storeOrigin } from "./config.js";
 import { buildArchive } from "./package.js";
 import { unzip } from "./zip.js";
+import { t, tm } from "./i18n.js";
 
 // Mağazayla konuşan komutlar: giriş, yükleme, canlı geliştirme, indirme, incelemeye gönderme.
 
@@ -35,7 +36,7 @@ function askSecret(question) {
     const onData = (chunk) => {
       for (const char of chunk) {
         if (char === "\r" || char === "\n") return done(resolve, value.trim());
-        if (char === "\u0003") return done(reject, new Error("İptal edildi."));
+        if (char === "\u0003") return done(reject, new Error(t("İptal edildi.")));
         if (char === "\u007f" || char === "\b") value = value.slice(0, -1);
         else if (char >= " ") value += char;
       }
@@ -46,9 +47,9 @@ function askSecret(question) {
 
 function explain(error) {
   if (!(error instanceof ApiError)) throw error;
-  console.error(`✖ ${error.message}`);
-  for (const problem of error.problems) console.error(`  ✖ ${problem}`);
-  if (error.status === 401) console.error("  Yeni anahtar: mağaza paneli → Ayarlar → Temalar → Geliştirici erişimi, sonra `uvako login`.");
+  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`."));
   return 1;
 }
 
@@ -56,16 +57,16 @@ const previewUrl = (origin, installationId) => `${origin}/?preview=${installatio
 const editorUrl = (origin, installationId) => `${origin}/admin/ayarlar/temalar/${installationId}/editor`;
 
 export async function login(options) {
-  if (!options.store || options.store === true) throw new Error("Mağaza adresi gerekli: uvako login --store <mağaza>");
-  if (options.token) throw new Error("Erişim anahtarı komut satırına yazılmaz. Komutu --token olmadan çalıştırın; anahtar sorulacak (ya da UVAKO_TOKEN ortam değişkenini kullanın).");
+  if (!options.store || options.store === true) throw new Error(t("Mağaza adresi gerekli: uvako login --store <mağaza>"));
+  if (options.token) throw new Error(t("Erişim anahtarı komut satırına yazılmaz. Komutu --token olmadan çalıştırın; anahtar sorulacak (ya da UVAKO_TOKEN ortam değişkenini kullanın)."));
   const origin = storeOrigin(options.store);
-  const token = (process.env.UVAKO_TOKEN || (await askSecret(`${origin} için tema erişim anahtarı (panel → Ayarlar → Temalar → Geliştirici erişimi): `))).trim();
-  if (!/^uvt_[A-Za-z0-9_-]{20,}$/.test(token)) throw new Error("Bu bir tema erişim anahtarı değil (uvt_ ile başlar).");
+  const token = (process.env.UVAKO_TOKEN || (await askSecret(t("{0} için tema erişim anahtarı (panel → Ayarlar → Temalar → Geliştirici erişimi): ", origin)))).trim();
+  if (!/^uvt_[A-Za-z0-9_-]{20,}$/.test(token)) throw new Error(t("Bu bir tema erişim anahtarı değil (uvt_ ile başlar)."));
   try {
     const me = await call({ origin, token }, "GET", "/me");
     saveSession(origin, token, me.store?.name ?? "");
-    console.log(`Giriş yapıldı: ${me.store?.name ?? origin} (${origin})`);
-    if (me.uploadBlocked) console.warn("! Bu mağaza için tema yükleme kapatılmış. Uvako desteğine yazın.");
+    console.log(t("Giriş yapıldı: {0} ({1})", me.store?.name ?? origin, origin));
+    if (me.uploadBlocked) console.warn(t("! Bu mağaza için tema yükleme kapatılmış. Uvako desteğine yazın."));
     return 0;
   } catch (error) {
     return explain(error);
@@ -74,8 +75,8 @@ export async function login(options) {
 
 export function logout(options) {
   const origin = dropSession(typeof options.store === "string" ? options.store : "");
-  console.log(origin ? `Çıkış yapıldı: ${origin}` : "Kayıtlı giriş yok.");
-  console.log("Anahtarı tamamen geçersiz kılmak için mağaza panelinden iptal edin.");
+  console.log(origin ? t("Çıkış yapıldı: {0}", origin) : t("Kayıtlı giriş yok."));
+  console.log(t("Anahtarı tamamen geçersiz kılmak için mağaza panelinden iptal edin."));
   return 0;
 }
 
@@ -84,14 +85,14 @@ export async function whoami(options) {
     const current = session(typeof options.store === "string" ? options.store : "");
     const me = await call(current, "GET", "/me");
     console.log(`${me.store?.name ?? ""} — ${current.origin} (anahtar: ${me.token})`);
-    for (const other of sessions()) if (!other.current) console.log(`  diğer giriş: ${other.name || other.origin} — ${other.origin}`);
+    for (const other of sessions()) if (!other.current) console.log(t("  diğer giriş: {0} — {1}", other.name || other.origin, other.origin));
     return 0;
   } catch (error) {
     return explain(error);
   }
 }
 
-const statusLabels = { private: "yalnızca bu mağazada", pending: "incelemede", approved: "tema mağazasında", rejected: "reddedildi" };
+const statusLabels = { private: t("yalnızca bu mağazada"), pending: "incelemede", approved: t("tema mağazasında"), rejected: "reddedildi" };
 
 export async function list(options) {
   try {
@@ -101,11 +102,11 @@ export async function list(options) {
       console.log(JSON.stringify(data, null, 2));
       return 0;
     }
-    console.log(`Mağazadaki temalar (${current.origin}):`);
-    for (const item of data.installations) console.log(`  ${item.role === "published" ? "● yayında " : "○ kütüphane"}  ${item.name}  [${item.key}]${item.custom ? "  (paket)" : ""}`);
-    console.log(data.packages.length ? "\nYüklediğiniz paketler:" : "\nYüklediğiniz paket yok.");
+    console.log(t("Mağazadaki temalar ({0}):", current.origin));
+    for (const item of data.installations) console.log(`  ${item.role === "published" ? t("● yayında ") : t("○ kütüphane")}  ${item.name}  [${item.key}]${item.custom ? "  (paket)" : ""}`);
+    console.log(data.packages.length ? t("\nYüklediğiniz paketler:") : t("\nYüklediğiniz paket yok."));
     for (const pkg of data.packages) {
-      console.log(`  ${pkg.key}  ${pkg.version}  (temel: ${pkg.base})  ${statusLabels[pkg.status] ?? pkg.status}${pkg.publishedVersion ? `  · mağazadaki sürüm ${pkg.publishedVersion}` : ""}`);
+      console.log(`  ${pkg.key}  ${pkg.version}  (temel: ${pkg.base})  ${statusLabels[pkg.status] ?? pkg.status}${pkg.publishedVersion ? t("  · mağazadaki sürüm {0}", pkg.publishedVersion) : ""}`);
       if (pkg.status === "rejected" && pkg.reviewNote) console.log(`      not: ${pkg.reviewNote}`);
     }
     return 0;
@@ -132,15 +133,15 @@ export async function push(target, options) {
     const current = session(typeof options.store === "string" ? options.store : "");
     const result = await upload(current, dir);
     if (!result) {
-      console.error("Yüklenmedi: önce hataları düzeltin.");
+      console.error(t("Yüklenmedi: önce hataları düzeltin."));
       return 1;
     }
     const pkg = result.package;
-    console.log(`${result.created ? "Yüklendi" : "Güncellendi"}: ${pkg.name} ${pkg.version} (sürüm no ${pkg.revision}) → ${current.origin}`);
-    console.log(`Önizleme:  ${previewUrl(current.origin, result.installationId)}`);
-    console.log(`Düzenleme: ${editorUrl(current.origin, result.installationId)}`);
-    console.log("Önizleme için tarayıcıda mağaza paneline giriş yapmış olmalısınız. Tema, panelden yayınlanana kadar vitrini değiştirmez.");
-    if (pkg.publishedVersion) console.log(`Tema mağazasındaki sürüm (${pkg.publishedVersion}) değişmedi. Yeni sürümü incelemeye göndermek için: uvako theme submit ${pkg.key}`);
+    console.log(t("{0}: {1} {2} (sürüm no {3}) → {4}", result.created ? t("Yüklendi") : t("Güncellendi"), pkg.name, pkg.version, pkg.revision, current.origin));
+    console.log(t("Önizleme:  {0}", previewUrl(current.origin, result.installationId)));
+    console.log(t("Düzenleme: {0}", editorUrl(current.origin, result.installationId)));
+    console.log(t("Önizleme için tarayıcıda mağaza paneline giriş yapmış olmalısınız. Tema, panelden yayınlanana kadar vitrini değiştirmez."));
+    if (pkg.publishedVersion) console.log(t("Tema mağazasındaki sürüm ({0}) değişmedi. Yeni sürümü incelemeye göndermek için: uvako theme submit {1}", pkg.publishedVersion, pkg.key));
     return 0;
   } catch (error) {
     return explain(error);
@@ -167,18 +168,18 @@ export async function dev(target, options) {
     first = await upload(current, dir);
   } catch (error) {
     if (error instanceof ApiError) return explain(error);
-    console.error(`✖ ${error.message}`);
+    console.error(`✖ ${tm(error.message)}`);
     return 1;
   }
   if (!first) {
-    console.error("Başlatılamadı: önce hataları düzeltin.");
+    console.error(t("Başlatılamadı: önce hataları düzeltin."));
     return 1;
   }
-  console.log(`\nCanlı geliştirme: ${first.package.name} → ${current.origin}`);
-  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(t("\nCanlı geliştirme: {0} → {1}", first.package.name, current.origin));
+  console.log(t("Önizleme:  {0}", previewUrl(current.origin, first.installationId)));
+  console.log(t("Düzenleme: {0}", editorUrl(current.origin, first.installationId)));
+  console.log(t("Ö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 ? t("Durdurduğunuzda tema son hâliyle kütüphanede kalır (--keep).") : existed ? t("Durdurduğunuzda mağazadaki paket geliştirme öncesindeki sürümüne döner. Kalıcı yüklemek için: uvako theme push") : t("Durdurduğunuzda geliştirme kopyası mağazadan silinir. Kalıcı yüklemek için: uvako theme push"));
   console.log("");
 
   let timer = null;
@@ -193,15 +194,15 @@ export async function dev(target, options) {
     running = true;
     try {
       const result = await upload(current, dir, true);
-      if (result) console.log(`[${stamp()}] yüklendi (sürüm no ${result.package.revision})`);
-      else console.error(`[${stamp()}] yüklenmedi: hataları düzeltip kaydedin.`);
+      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()}] ✖ ${error.message}`);
-        for (const problem of error.problems) console.error(`  ✖ ${problem}`);
+        console.error(`[${stamp()}] ✖ ${tm(error.message)}`);
+        for (const problem of error.problems) console.error(`  ✖ ${tm(problem)}`);
         if (error.status === 401 || error.status === 403) process.exit(1);
       } else {
-        console.error(`[${stamp()}] ✖ ${error.message}`);
+        console.error(`[${stamp()}] ✖ ${tm(error.message)}`);
       }
     } finally {
       running = false;
@@ -227,18 +228,18 @@ export async function dev(target, options) {
       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.");
+          console.log(t("\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ü.");
+          console.log(t("\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.");
+          console.log(t("\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`);
+        console.error(t("\nCanlı geliştirme durdu ama mağaza eski hâline döndürülemedi: {0}", error.message));
+        console.error(t("Elle kaldırmak için: uvako theme delete {0} --yes", key));
         resolve(1);
       }
     });
@@ -246,10 +247,10 @@ export async function dev(target, options) {
 }
 
 export async function pull(key, options) {
-  if (!key) throw new Error("Tema anahtarı gerekli: uvako theme pull <anahtar>");
+  if (!key) throw new Error(t("Tema anahtarı gerekli: uvako theme pull <anahtar>"));
   const parent = path.resolve(typeof options.dir === "string" ? options.dir : ".");
   const dir = path.join(parent, key);
-  if (existsSync(dir) && !options.force) throw new Error(`Klasör zaten var: ${dir}\nÜstüne yazmak için --force ekleyin.`);
+  if (existsSync(dir) && !options.force) throw new Error(t("Klasör zaten var: {0}\nÜstüne yazmak için --force ekleyin.", dir));
   try {
     const current = session(typeof options.store === "string" ? options.store : "");
     const archive = await call(current, "GET", `/themes/${encodeURIComponent(key)}/package`, { raw: true });
@@ -258,12 +259,12 @@ export async function pull(key, options) {
       // Paket yalnızca kendi klasörünün içine açılır.
       const rel = entry.name.split("/").slice(1).join("/");
       const file = path.resolve(dir, rel);
-      if (!rel || !entry.name.startsWith(`${key}/`) || rel.split("/").includes("..") || !file.startsWith(dir + path.sep)) throw new Error(`Paketteki yol güvenli değil: ${entry.name}`);
+      if (!rel || !entry.name.startsWith(`${key}/`) || rel.split("/").includes("..") || !file.startsWith(dir + path.sep)) throw new Error(t("Paketteki yol güvenli değil: {0}", entry.name));
       mkdirSync(path.dirname(file), { recursive: true });
       writeFileSync(file, entry.data);
       count++;
     }
-    console.log(`İndirildi: ${path.relative(process.cwd(), dir) || "."} (${count} dosya)`);
+    console.log(t("İndirildi: {0} ({1} dosya)", path.relative(process.cwd(), dir) || ".", count));
     return 0;
   } catch (error) {
     return explain(error);
@@ -271,12 +272,12 @@ export async function pull(key, options) {
 }
 
 export async function submit(key, options) {
-  if (!key) throw new Error("Tema anahtarı gerekli: uvako theme submit <anahtar>");
+  if (!key) throw new Error(t("Tema anahtarı gerekli: uvako theme submit <anahtar>"));
   try {
     const current = session(typeof options.store === "string" ? options.store : "");
     const pkg = await call(current, "POST", `/themes/${encodeURIComponent(key)}/submit`);
-    console.log(`İncelemeye gönderildi: ${pkg.name} ${pkg.version}. Uvako ekibi onayladığında themes.uvako.com'da yayınlanır.`);
-    console.log("İnceleme sürerken yeni sürüm yüklerseniz onay o sürüm için yeniden istenir.");
+    console.log(t("İncelemeye gönderildi: {0} {1}. Uvako ekibi onayladığında themes.uvako.com'da yayınlanır.", pkg.name, pkg.version));
+    console.log(t("İnceleme sürerken yeni sürüm yüklerseniz onay o sürüm için yeniden istenir."));
     return 0;
   } catch (error) {
     return explain(error);
@@ -284,8 +285,8 @@ export async function submit(key, options) {
 }
 
 export async function remove(key, options) {
-  if (!key) throw new Error("Tema anahtarı gerekli: uvako theme delete <anahtar>");
-  if (!options.yes) throw new Error(`"${key}" paketi ve mağazadaki kopyaları silinir; geri alınamaz. Onaylamak için --yes ekleyin.`);
+  if (!key) throw new Error(t("Tema anahtarı gerekli: uvako theme delete <anahtar>"));
+  if (!options.yes) throw new Error(t("\"{0}\" paketi ve mağazadaki kopyaları silinir; geri alınamaz. Onaylamak için --yes ekleyin.", key));
   try {
     const current = session(typeof options.store === "string" ? options.store : "");
     await call(current, "DELETE", `/themes/${encodeURIComponent(key)}`);

package/src/zip.js

@@ -1,4 +1,5 @@
 import zlib from "node:zlib";
+import { t } from "./i18n.js";
 
 // Bağımlılıksız zip yazıcı ve okuyucu. Dosya tarihleri sabit tutulur; aynı içerik her zaman aynı
 // özeti verir.
@@ -62,12 +63,12 @@ export function unzip(buffer) {
       break;
     }
   }
-  if (end < 0) throw new Error("Geçerli bir zip dosyası değil.");
+  if (end < 0) throw new Error(t("Geçerli bir zip dosyası değil."));
   const count = buffer.readUInt16LE(end + 10);
   let cursor = buffer.readUInt32LE(end + 16);
   const entries = [];
   for (let i = 0; i < count; i++) {
-    if (buffer.readUInt32LE(cursor) !== 0x02014b50) throw new Error("Zip dizini okunamadı.");
+    if (buffer.readUInt32LE(cursor) !== 0x02014b50) throw new Error(t("Zip dizini okunamadı."));
     const method = buffer.readUInt16LE(cursor + 10);
     const compressedSize = buffer.readUInt32LE(cursor + 20);
     const size = buffer.readUInt32LE(cursor + 24);
@@ -78,13 +79,13 @@ export function unzip(buffer) {
     const name = buffer.subarray(cursor + 46, cursor + 46 + nameLength).toString("utf8");
     cursor += 46 + nameLength + extraLength + commentLength;
     if (name.endsWith("/")) continue;
-    if (size > maxEntryBytes) throw new Error(`${name}: dosya çok büyük.`);
+    if (size > maxEntryBytes) throw new Error(t("{0}: dosya çok büyük.", name));
     const dataStart = localOffset + 30 + buffer.readUInt16LE(localOffset + 26) + buffer.readUInt16LE(localOffset + 28);
     const raw = buffer.subarray(dataStart, dataStart + compressedSize);
     let data;
     if (method === 0) data = Buffer.from(raw);
     else if (method === 8) data = zlib.inflateRawSync(raw, { maxOutputLength: maxEntryBytes });
-    else throw new Error(`${name}: desteklenmeyen sıkıştırma yöntemi.`);
+    else throw new Error(t("{0}: desteklenmeyen sıkıştırma yöntemi.", name));
     entries.push({ name, data });
   }
   return entries;

package/templates/app/README.md

@@ -0,0 +1,39 @@
+# {{name}}
+
+Uvako için herkese açık uygulama. `uvako app init` ile oluşturuldu.
+
+## Yerelde çalıştırma
+
+```bash
+uvako login                       # partner hesabıyla bir kez
+uvako app dev --store <mağaza>    # geliştirme mağazalarınızdan biri
+```
+
+`uvako app dev`:
+
+- uygulamayı (`node server.js`) client id ve secret ortam değişkenleriyle başlatır,
+- seçtiğiniz geliştirme mağazasında uygulamanın adresini `http://localhost:3000` yapar,
+- o mağazanın webhook'larını bilgisayarınıza aktarır (imza ve başlıklar aynen gelir),
+- kurulum bağlantısını yazar. Bağlantıyı açıp onay ekranında **Uygulamayı kur** deyin.
+
+Durdurduğunuzda (Ctrl+C) mağaza dağıtılan adresleri yeniden kullanır.
+
+## Yapılandırma
+
+`uvako.app.json` uygulamanın yapılandırmasıdır: ad, adresler, kapsamlar, webhook'lar ve uygulama
+mağazası sayfası. Değiştirdikten sonra:
+
+```bash
+uvako app deploy    # yeni sürüm: önce yalnızca kendi mağazalarınızda geçerli
+uvako app submit    # herkese açmak için Uvako incelemesine gönderir
+```
+
+Client secret bu klasöre yazılmaz. Sunucunuzda `UVAKO_CLIENT_SECRET` ortam değişkeniyle verin.
+
+## Güvenlik
+
+- Kurulum dönüşünde `hmac` ve `state` doğrulanır; `shop` yalnızca `*.uvoo.store` olabilir.
+- Webhook gövdesi ayrıştırılmadan önce `X-Uvako-Hmac-Sha256` imzası doğrulanır.
+- Erişim anahtarları `.uvako/tokens.json` dosyasındadır; bu klasörü depoya koymayın.
+
+Ayrıntı: Uvako Admin API belgesi → Herkese açık uygulamalar.

package/templates/app/blocks/yildiz-puani/block.css

@@ -0,0 +1,5 @@
+.yp-block { max-width: 720px; margin: 32px auto; padding: 24px; border-radius: 16px; background: #fafafa; text-align: center; }
+.yp-title { margin: 0 0 8px; font-size: 22px; }
+.yp-stars { margin: 0 0 8px; font-size: 28px; letter-spacing: 4px; }
+.yp-text { margin: 0; color: #555; }
+.yp-link { display: inline-block; margin-top: 12px; }

package/templates/app/blocks/yildiz-puani/block.html

@@ -0,0 +1,8 @@
+<section class="yp-block">
+  <h2 class="yp-title">{{ .settings.title }}</h2>
+  <p class="yp-stars" style="color: {{ .settings.color }}" aria-label="{{ .settings.stars }} / 5">
+    {{ if eq .settings.stars 5.0 }}★★★★★{{ else if eq .settings.stars 4.0 }}★★★★☆{{ else if eq .settings.stars 3.0 }}★★★☆☆{{ else if eq .settings.stars 2.0 }}★★☆☆☆{{ else }}★☆☆☆☆{{ end }}
+  </p>
+  <p class="yp-text">{{ .settings.text }}</p>
+  {{ if and .settings.show_link .settings.link }}<a class="yp-link" href="{{ .settings.link }}">Tüm yorumlar</a>{{ end }}
+</section>

package/templates/app/blocks/yildiz-puani/block.json

@@ -0,0 +1,11 @@
+{
+  "name": "Yıldız puanı",
+  "settings": [
+    { "id": "title", "type": "text", "label": "Başlık", "default": "Müşterilerimiz ne diyor?" },
+    { "id": "text", "type": "textarea", "label": "Metin", "default": "Binlerce mutlu müşteri." },
+    { "id": "stars", "type": "range", "label": "Yıldız", "min": 1, "max": 5, "default": 5 },
+    { "id": "color", "type": "color", "label": "Yıldız rengi", "default": "#f5a524" },
+    { "id": "link", "type": "url", "label": "Bağlantı", "info": "https adresi ya da mağaza içi yol (ör. /yorumlar)" },
+    { "id": "show_link", "type": "checkbox", "label": "Bağlantıyı göster", "default": false }
+  ]
+}