uvako-cli 0.1.2 → 0.2.1

package/src/remote.js

@@ -0,0 +1,297 @@
+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";
+import { dropSession, saveSession, session, sessions, storeOrigin } from "./config.js";
+import { buildArchive } from "./package.js";
+import { unzip } from "./zip.js";
+
+// Mağazayla konuşan komutlar: giriş, yükleme, canlı geliştirme, indirme, incelemeye gönderme.
+
+/** Erişim anahtarını ekrana yazdırmadan okur. Anahtar komut satırına yazılmaz (kabuk geçmişinde kalır). */
+function askSecret(question) {
+  const input = process.stdin;
+  if (!input.isTTY) {
+    return new Promise((resolve) => {
+      let data = "";
+      input.setEncoding("utf8");
+      input.on("data", (chunk) => (data += chunk));
+      input.on("end", () => resolve(data.trim()));
+    });
+  }
+  return new Promise((resolve, reject) => {
+    process.stdout.write(question);
+    let value = "";
+    input.setRawMode(true);
+    input.resume();
+    input.setEncoding("utf8");
+    const done = (fn, arg) => {
+      input.setRawMode(false);
+      input.pause();
+      input.off("data", onData);
+      process.stdout.write("\n");
+      fn(arg);
+    };
+    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 === "\u007f" || char === "\b") value = value.slice(0, -1);
+        else if (char >= " ") value += char;
+      }
+    };
+    input.on("data", onData);
+  });
+}
+
+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`.");
+  return 1;
+}
+
+const previewUrl = (origin, installationId) => `${origin}/?preview=${installationId}`;
+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).");
+  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).");
+  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.");
+    return 0;
+  } catch (error) {
+    return explain(error);
+  }
+}
+
+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.");
+  return 0;
+}
+
+export async function whoami(options) {
+  try {
+    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}`);
+    return 0;
+  } catch (error) {
+    return explain(error);
+  }
+}
+
+const statusLabels = { private: "yalnızca bu mağazada", pending: "incelemede", approved: "tema mağazasında", rejected: "reddedildi" };
+
+export async function list(options) {
+  try {
+    const current = session(typeof options.store === "string" ? options.store : "");
+    const data = await call(current, "GET", "/themes");
+    if (options.json) {
+      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.");
+    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}` : ""}`);
+      if (pkg.status === "rejected" && pkg.reviewNote) console.log(`      not: ${pkg.reviewNote}`);
+    }
+    return 0;
+  } catch (error) {
+    return explain(error);
+  }
+}
+
+async function upload(current, dir, quiet = 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 });
+  for (const warning of result.warnings ?? []) console.warn(`  ! ${warning}`);
+  return result;
+}
+
+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);
+    if (!result) {
+      console.error("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}`);
+    return 0;
+  } catch (error) {
+    return explain(error);
+  }
+}
+
+/** Canlı geliştirme: klasörü izler, her kayıtta temayı mağazaya yükler; açık önizleme sayfası kendini yeniler. */
+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) {
+    if (error instanceof ApiError) return explain(error);
+    console.error(`✖ ${error.message}`);
+    return 1;
+  }
+  if (!first) {
+    console.error("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("");
+
+  let timer = null;
+  let running = false;
+  let again = false;
+  const stamp = () => new Date().toLocaleTimeString("tr-TR");
+  const sync = async () => {
+    if (running) {
+      again = true;
+      return;
+    }
+    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.`);
+    } catch (error) {
+      if (error instanceof ApiError) {
+        console.error(`[${stamp()}] ✖ ${error.message}`);
+        for (const problem of error.problems) console.error(`  ✖ ${problem}`);
+        if (error.status === 401 || error.status === 403) process.exit(1);
+      } else {
+        console.error(`[${stamp()}] ✖ ${error.message}`);
+      }
+    } finally {
+      running = false;
+      if (again) {
+        again = false;
+        void sync();
+      }
+    }
+  };
+  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;
+    clearTimeout(timer);
+    timer = setTimeout(() => void sync(), 300);
+  });
+  return new Promise((resolve) => {
+    let stopping = false;
+    process.on("SIGINT", async () => {
+      if (stopping) return;
+      stopping = true;
+      watcher.close();
+      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);
+      }
+    });
+  });
+}
+
+export async function pull(key, options) {
+  if (!key) throw new Error("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.`);
+  try {
+    const current = session(typeof options.store === "string" ? options.store : "");
+    const archive = await call(current, "GET", `/themes/${encodeURIComponent(key)}/package`, { raw: true });
+    let count = 0;
+    for (const entry of unzip(archive)) {
+      // 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}`);
+      mkdirSync(path.dirname(file), { recursive: true });
+      writeFileSync(file, entry.data);
+      count++;
+    }
+    console.log(`İndirildi: ${path.relative(process.cwd(), dir) || "."} (${count} dosya)`);
+    return 0;
+  } catch (error) {
+    return explain(error);
+  }
+}
+
+export async function submit(key, options) {
+  if (!key) throw new Error("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.");
+    return 0;
+  } catch (error) {
+    return explain(error);
+  }
+}
+
+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.`);
+  try {
+    const current = session(typeof options.store === "string" ? options.store : "");
+    await call(current, "DELETE", `/themes/${encodeURIComponent(key)}`);
+    console.log(`Silindi: ${key}`);
+    return 0;
+  } catch (error) {
+    return explain(error);
+  }
+}

package/src/zip.js

@@ -0,0 +1,91 @@
+import zlib from "node:zlib";
+
+// Bağımlılıksız zip yazıcı ve okuyucu. Dosya tarihleri sabit tutulur; aynı içerik her zaman aynı
+// özeti verir.
+const DOS_DATE = ((2026 - 1980) << 9) | (1 << 5) | 1;
+
+export function zip(entries) {
+  const parts = [];
+  const central = [];
+  let offset = 0;
+  for (const { name, data } of entries) {
+    const nameBytes = Buffer.from(name, "utf8");
+    const compressed = zlib.deflateRawSync(data, { level: 9 });
+    const crc = zlib.crc32(data);
+    const local = Buffer.alloc(30);
+    local.writeUInt32LE(0x04034b50, 0);
+    local.writeUInt16LE(20, 4);
+    local.writeUInt16LE(0x0800, 6); // UTF-8 dosya adları
+    local.writeUInt16LE(8, 8);
+    local.writeUInt16LE(0, 10);
+    local.writeUInt16LE(DOS_DATE, 12);
+    local.writeUInt32LE(crc, 14);
+    local.writeUInt32LE(compressed.length, 18);
+    local.writeUInt32LE(data.length, 22);
+    local.writeUInt16LE(nameBytes.length, 26);
+    parts.push(local, nameBytes, compressed);
+
+    const header = Buffer.alloc(46);
+    header.writeUInt32LE(0x02014b50, 0);
+    header.writeUInt16LE(20, 4);
+    header.writeUInt16LE(20, 6);
+    header.writeUInt16LE(0x0800, 8);
+    header.writeUInt16LE(8, 10);
+    header.writeUInt16LE(0, 12);
+    header.writeUInt16LE(DOS_DATE, 14);
+    header.writeUInt32LE(crc, 16);
+    header.writeUInt32LE(compressed.length, 20);
+    header.writeUInt32LE(data.length, 24);
+    header.writeUInt16LE(nameBytes.length, 28);
+    header.writeUInt32LE(offset, 42);
+    central.push(header, nameBytes);
+    offset += local.length + nameBytes.length + compressed.length;
+  }
+  const centralSize = central.reduce((sum, part) => sum + part.length, 0);
+  const end = Buffer.alloc(22);
+  end.writeUInt32LE(0x06054b50, 0);
+  end.writeUInt16LE(entries.length, 8);
+  end.writeUInt16LE(entries.length, 10);
+  end.writeUInt32LE(centralSize, 12);
+  end.writeUInt32LE(offset, 16);
+  return Buffer.concat([...parts, ...central, end]);
+}
+
+const maxEntryBytes = 16 * 1024 * 1024;
+
+/** Zip içindeki dosyaları {name, data} olarak döndürür. Yalnızca "stored" ve "deflate" desteklenir. */
+export function unzip(buffer) {
+  let end = -1;
+  for (let i = buffer.length - 22; i >= Math.max(0, buffer.length - 65557); i--) {
+    if (buffer.readUInt32LE(i) === 0x06054b50) {
+      end = i;
+      break;
+    }
+  }
+  if (end < 0) throw new Error("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ı.");
+    const method = buffer.readUInt16LE(cursor + 10);
+    const compressedSize = buffer.readUInt32LE(cursor + 20);
+    const size = buffer.readUInt32LE(cursor + 24);
+    const nameLength = buffer.readUInt16LE(cursor + 28);
+    const extraLength = buffer.readUInt16LE(cursor + 30);
+    const commentLength = buffer.readUInt16LE(cursor + 32);
+    const localOffset = buffer.readUInt32LE(cursor + 42);
+    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.`);
+    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.`);
+    entries.push({ name, data });
+  }
+  return entries;
+}