uvako-cli 0.1.2 → 0.2.0

package/src/config.js

@@ -0,0 +1,100 @@
+import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+
+// Giriş bilgileri kullanıcının ev klasöründe, yalnızca kullanıcının okuyabildiği bir dosyada durur.
+// Tema klasörüne hiçbir zaman yazılmaz; böylece pakete ya da sürüm kontrolüne karışmaz.
+
+export const defaultStoreApex = "uvoo.store";
+export const siteOrigin = () => process.env.UVAKO_SITE_URL || "https://uvako.com";
+
+export function configDir() {
+  if (process.env.UVAKO_CONFIG_DIR) return process.env.UVAKO_CONFIG_DIR;
+  if (process.platform === "win32" && process.env.APPDATA) return path.join(process.env.APPDATA, "uvako");
+  return path.join(process.env.XDG_CONFIG_HOME || path.join(os.homedir(), ".config"), "uvako");
+}
+
+const file = () => path.join(configDir(), "credentials.json");
+
+function read() {
+  try {
+    const data = JSON.parse(readFileSync(file(), "utf8"));
+    return { current: typeof data.current === "string" ? data.current : "", stores: data.stores && typeof data.stores === "object" ? data.stores : {} };
+  } catch {
+    return { current: "", stores: {} };
+  }
+}
+
+function write(data) {
+  mkdirSync(configDir(), { recursive: true, mode: 0o700 });
+  writeFileSync(file(), `${JSON.stringify(data, null, 2)}\n`, { mode: 0o600 });
+  // Dosya önceden varsa izinleri yazma sırasında değişmez.
+  try {
+    chmodSync(file(), 0o600);
+  } catch {
+    // Windows'ta dosya zaten yalnızca kullanıcının profilindedir.
+  }
+}
+
+const local = (hostname) => hostname === "localhost" || hostname === "127.0.0.1" || hostname.endsWith(".localhost");
+
+/**
+ * Mağaza adresini mağazanın kök adresine çevirir: "magazam" → https://magazam.uvoo.store,
+ * "www.magazam.com" → https://www.magazam.com. Şifresiz (http) bağlantı yalnızca yerel
+ * geliştirme adreslerinde kabul edilir: erişim anahtarı açık ağdan gönderilmez.
+ */
+export function storeOrigin(input) {
+  let value = String(input ?? "").trim().replace(/\/+$/, "");
+  if (!value) throw new Error("Mağaza adresi gerekli (ör. magazam ya da magazam.uvoo.store).");
+  if (!/^https?:\/\//i.test(value)) {
+    if (!value.includes(".") && !value.includes(":")) value = `${value}.${defaultStoreApex}`;
+    value = `${local(value.split(":")[0]) ? "http" : "https"}://${value}`;
+  }
+  let url;
+  try {
+    url = new URL(value);
+  } catch {
+    throw new Error(`Mağaza adresi okunamadı: ${input}`);
+  }
+  if (url.protocol !== "https:" && !local(url.hostname)) throw new Error("Mağazaya yalnızca https ile bağlanılır.");
+  if (url.username || url.password) throw new Error("Mağaza adresinde kullanıcı adı ya da parola olamaz.");
+  return url.origin;
+}
+
+/** Etkin oturum: önce ortam değişkenleri (CI), sonra kayıtlı giriş. */
+export function session(storeOption) {
+  if (process.env.UVAKO_TOKEN && (storeOption || process.env.UVAKO_STORE)) {
+    return { origin: storeOrigin(storeOption || process.env.UVAKO_STORE), token: process.env.UVAKO_TOKEN.trim() };
+  }
+  const data = read();
+  const origin = storeOption ? storeOrigin(storeOption) : data.current;
+  const entry = origin ? data.stores[origin] : null;
+  if (!origin || !entry?.token) {
+    throw new Error(storeOption ? `Bu mağaza için giriş yapılmamış: ${origin}\nÖnce: uvako login --store ${storeOption}` : "Giriş yapılmamış. Önce: uvako login --store <mağaza>");
+  }
+  return { origin, token: entry.token, name: entry.name };
+}
+
+export function saveSession(origin, token, name) {
+  const data = read();
+  data.stores[origin] = { token, name, savedAt: new Date().toISOString() };
+  data.current = origin;
+  write(data);
+}
+
+export function dropSession(storeOption) {
+  const data = read();
+  const origin = storeOption ? storeOrigin(storeOption) : data.current;
+  if (!origin || !data.stores[origin]) return "";
+  delete data.stores[origin];
+  if (data.current === origin) data.current = Object.keys(data.stores)[0] ?? "";
+  write(data);
+  return origin;
+}
+
+export function sessions() {
+  const data = read();
+  return Object.entries(data.stores).map(([origin, entry]) => ({ origin, name: entry.name ?? "", current: origin === data.current }));
+}
+
+export const credentialsPath = () => (existsSync(file()) ? file() : "");

package/src/init.js

@@ -1,7 +1,8 @@
 import { existsSync, mkdirSync, writeFileSync } from "node:fs";
 import path from "node:path";
 
-// Yeni tema iskeleti. Tema kod içermez: ayar şeması, bölüm sırası, SCSS ve görsellerden oluşur.
+// Yeni tema iskeleti. Tema kod içermez: bir katalog temasını ("base") temel alır ve onun üstüne
+// ayar, ana sayfa bölüm sırası, SCSS ve görsel getirir.
 const keyPattern = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 
 const json = (value) => `${JSON.stringify(value, null, 2)}\n`;
@@ -13,8 +14,13 @@ function logo(name) {
 `;
 }
 
-export function initTheme(key, { name, author, cwd }) {
+/**
+ * `starter` temel temanın ayarlarıdır (platformdan okunur: şema, varsayılanlar, bölüm türleri, ana
+ * sayfa şablonu). Verilmezse iskelet şablonsuz kurulur; tema temel temanın bölüm sırasını kullanır.
+ */
+export function initTheme(key, { name, author, cwd, base = "linea", starter = null }) {
   if (!keyPattern.test(key) || key.length > 40) throw new Error(`Tema anahtarı küçük harf, rakam ve tireden oluşmalı (ör. "atolye"): ${key}`);
+  if (!keyPattern.test(base)) throw new Error(`Temel tema adı geçersiz: ${base}`);
   const dir = path.join(cwd, key);
   if (existsSync(dir)) throw new Error(`Klasör zaten var: ${dir}`);
   const title = String(name || key.replace(/(^|-)([a-z])/g, (_, dash, letter) => (dash ? " " : "") + letter.toUpperCase()));
@@ -24,82 +30,37 @@ export function initTheme(key, { name, author, cwd }) {
     writeFileSync(file, content, "utf8");
   };
 
-  write("theme.json", json({ key, name: title, version: "0.1.0", author: String(author || ""), description: `${title} teması.`, base: "editorial", screenshot: "" }));
-
-  write("config/settings_schema.json", json({
-    theme_version: 2,
-    group: {
-      type: "tab",
-      values: [
-        {
-          name: "Genel Ayarlar",
-          settings: {
-            logo: { type: "image", default_value: "uploads/logo.svg", filename: "logo", label: "Logo", info: "" },
-            color_primary: { type: "color", default_value: "#111111", label: "Ana renk", info: "Düğme ve vurgu rengi." },
-            header_top_bar_text: { type: "text", default_value: "", label: "Üst şerit yazısı", info: "" },
-          },
-        },
-        {
-          name: "Ana Sayfa",
-          settings: {
-            slide_status: { type: "checkbox", default_value: 1, label: "Slaytı göster", info: "" },
-            slider_status_1: { type: "checkbox", default_value: 1, label: "1. slayt açık", info: "" },
-            slider_picture_1: { type: "image", default_value: "", filename: "slider_1", label: "1. slayt görseli", info: "Önerilen: 1920×1080" },
-            slider_title_1: { type: "text", default_value: "", label: "1. slayt başlığı", info: "" },
-            slider_button_1: { type: "text", default_value: "", label: "1. slayt düğme yazısı", info: "" },
-            slider_link_1: { type: "text", default_value: "/search", label: "1. slayt bağlantısı", info: "" },
-            home_products_title: { type: "text", default_value: "Yeni gelenler", label: "Ürün vitrini başlığı", info: "" },
-          },
-        },
-      ],
-    },
-  }));
-
-  write("config/settings_data.json", json({
-    logo: "uploads/logo.svg",
-    color_primary: "#111111",
-    header_top_bar_text: "",
-    slide_status: 1,
-    slider_status_1: 1,
-    slider_title_1: "Yeni koleksiyon",
-    slider_button_1: "Keşfet",
-    slider_link_1: "/search",
-    home_products_title: "Yeni gelenler",
-  }));
-
-  write("config/sections.json", json({
-    sections: {
-      [`${key}-slider`]: { name: "Slayt", icon: "image", keys: ["slide_status", "slider_status_1", "slider_picture_1", "slider_title_1", "slider_button_1", "slider_link_1"] },
-      [`${key}-home-products`]: { name: "Ürün vitrini", icon: "grid", keys: ["home_products_title"] },
-    },
-  }));
-
-  write("templates/index.json", json({
-    order: ["slider", "home_products"],
-    sections: {
-      slider: { type: `${key}-slider`, disabled: false, settings: {} },
-      home_products: { type: `${key}-home-products`, disabled: false, settings: {} },
-    },
-  }));
-
-  write("styles/_tokens.scss", `// Temanın renk ve yazı tipi değişkenleri. Platformun temel stilleri bu değerlerle derlenir.
-$font-family: 'Manrope', sans-serif;
-$font-family-sub: 'Bodoni Moda', 'Times New Roman', serif;
-
-$color-text: #111111;
-$color-sub-text: #6b6b6b;
-$color-border: #e5e5e5;
-$color-background: #ffffff;
-$border-radius: 0;
+  write("theme.json", json({ key, name: title, version: "0.1.0", base, author: String(author || ""), description: `${title} teması.`, screenshot: "", industries: [], features: [], price: 0 }));
+
+  // Yalnızca temel temadan farklı olan değerler yazılır; gerisi temel temadan gelir.
+  write("config/settings_data.json", json({ logo: "uploads/logo.svg" }));
+
+  if (starter?.template) write("templates/index.json", json(starter.template));
+  if (starter) {
+    // Başvuru dosyaları: pakete girmez. Hangi ayarların ve bölüm türlerinin olduğunu gösterir.
+    write("reference/settings_schema.json", json(starter.schema ?? {}));
+    write("reference/settings_defaults.json", json(starter.defaults ?? {}));
+    write("reference/sections.json", json(starter.sections ?? {}));
+  }
+
+  write("styles/_tokens.scss", `// Temel temanın değişkenlerinin üstüne yazılır: burada verdiğiniz değerler temanın tamamına yayılır.
+// Bu dosyada yalnızca değişken ataması ve yazı tipi @import'u bulunabilir.
+//
+// @import url('https://fonts.googleapis.com/css2?family=Manrope:wght@400;500;600;700&display=swap');
+// $font-family: 'Manrope', sans-serif;
+// $color-text: #111111;
+// $color-sub-text: #6b6b6b;
+// $color-border: #e5e5e5;
+// $color-background: #ffffff;
+// $border-radius: 0;
 `);
 
-  write("styles/theme.scss", `// Temaya özgü kurallar. Bütün seçiciler .theme-${key} altında yazılır.
-@import 'tokens';
+  write("styles/theme.scss", `// Temaya özgü kurallar. Temel temanın stilinden sonra derlenir; temel temanın değişkenleri
+// ($color-text, $font-family…) ve mixin'leri (@include) kullanılabilir.
+// Görseller: url("#{$theme-assets}/uploads/dosya.webp")
+// Panel ayarları: $s-<ayar_adı> (ör. $s-color_primary)
 
-.theme-${key} {
-    .products-header span {
-        font-family: $font-family-sub;
-    }
+.theme-${base} {
 }
 `);
 
@@ -107,22 +68,27 @@ $border-radius: 0;
 
   write("README.md", `# ${title}
 
-Uvako teması. Bu klasör kod içermez: ayar şeması, ana sayfa bölüm sırası, SCSS ve görseller.
+Uvako teması. \`${base}\` temasını temel alır; kod içermez.
 
-- \`theme.json\` — kimlik (anahtar, ad, sürüm).
-- \`config/settings_schema.json\` — mağaza sahibinin panelde göreceği ayarlar.
-- \`config/settings_data.json\` — ayarların varsayılan değerleri.
-- \`config/sections.json\` — ana sayfa bölüm türleri ve bağlı ayarları.
-- \`templates/index.json\` — ana sayfadaki bölümlerin sırası.
-- \`styles/\` — renk / yazı tipi değişkenleri ve temaya özgü SCSS.
-- \`assets/\` — logo, slayt ve banner görselleri.
+- \`theme.json\` — kimlik: anahtar, ad, sürüm, temel tema, 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; yoksa temel temanınki kullanılır.
+- \`templates/index.json\` — (isteğe bağlı) ana sayfadaki bölümlerin sırası.
+- \`styles/_tokens.scss\` — renk, yazı tipi, köşe gibi değişkenler.
+- \`styles/theme.scss\` — temaya özgü SCSS.
+- \`assets/\` — logo, slayt ve banner görselleri, yazı tipleri.
+- \`reference/\` — temel temanın ayar şeması, varsayılanları ve bölüm türleri. Pakete girmez.
 
 \`\`\`bash
-uvako-cli theme check .
+uvako login --store magazam
 \`\`\`
 
 \`\`\`bash
-uvako-cli theme package .
+uvako theme dev
+\`\`\`
+
+\`\`\`bash
+uvako theme push
 \`\`\`
 `);
   return dir;

package/src/main.js

@@ -1,23 +1,41 @@
 import { readFileSync } from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
+import { ApiError, call, starter } from "./api.js";
 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";
 
 const version = JSON.parse(readFileSync(path.join(path.dirname(fileURLToPath(import.meta.url)), "..", "package.json"), "utf8")).version;
 
 const help = `uvako-cli ${version} — Uvako tema geliştirme aracı
 https://uvako.com
 
-Kullanım:
-  uvako-cli theme init <anahtar> [--name "Ad"] [--author "Yazar"]   Yeni tema iskeleti oluşturur
-  uvako-cli theme check [klasör]                                    Temayı denetler (yapı, ayarlar, güvenlik)
-  uvako-cli theme package [klasör] [--out dosya.zip]                Denetleyip yüklenebilir zip paketi üretir
-  uvako-cli version                                                 Sürümü yazar
+Giriş:
+  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
 
-Tema, kod çalıştırmayan bir pakettir: ayar şeması, bölüm sırası, SCSS ve görseller.
-JavaScript, TypeScript ya da sunucu kodu içeren paketler reddedilir.
+Tema:
+  uvako theme init <anahtar> [--base linea] [--name "Ad"] [--author "Yazar"]
+                                               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
+  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
+  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.
+
+CI için: UVAKO_STORE ve UVAKO_TOKEN ortam değişkenleri girişin yerini tutar.
 
 Uvako — https://uvako.com
 Rox Software · Rox Group`;
@@ -40,6 +58,24 @@ export function parseArgs(args) {
   return { options, rest };
 }
 
+/** Temel temanın başlangıç ayarları: giriş yapılmışsa mağazadan, değilse uvako.com'dan okunur. */
+async function fetchStarter(base, options) {
+  if (options.offline) return null;
+  try {
+    let current = null;
+    try {
+      current = session(typeof options.store === "string" ? options.store : "");
+    } catch {
+      // Giriş yoksa herkese açık uç nokta kullanılır.
+    }
+    return current ? await call(current, "GET", `/bases/${encodeURIComponent(base)}`) : await starter(siteOrigin(), base);
+  } catch (error) {
+    if (error instanceof ApiError && error.status === 404) throw new Error(`"${base}" adında bir temel tema yok. Temalar: https://themes.uvako.com`);
+    console.warn(`! Temel temanın ayarları okunamadı (${error.message}). İskelet başvuru dosyaları olmadan kuruluyor.`);
+    return null;
+  }
+}
+
 export async function main(argv) {
   const { options, rest } = parseArgs(argv);
   const [group, command, target] = rest;
@@ -51,15 +87,20 @@ 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);
   if (group !== "theme") {
     console.error(`Bilinmeyen komut: ${group}\n\n${help}`);
     return 1;
   }
   if (command === "init") {
-    if (!target) throw new Error("Tema anahtarı gerekli: uvako-cli theme init <anahtar>");
-    const dir = initTheme(target, { name: options.name, author: options.author, cwd: process.cwd() });
-    console.log(`Tema oluşturuldu: ${path.relative(process.cwd(), dir) || "."}`);
-    console.log(`Sıradaki adım: uvako-cli theme check ${path.relative(process.cwd(), dir)}`);
+    if (!target) throw new Error("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 rel = path.relative(process.cwd(), dir) || ".";
+    console.log(`Tema oluşturuldu: ${rel} (temel: ${base})`);
+    console.log(`Sıradaki adım: uvako login --store <mağaza>, sonra: uvako theme dev ${rel}`);
     return 0;
   }
   if (command === "check") {
@@ -69,16 +110,21 @@ export async function main(argv) {
   }
   if (command === "package") {
     const result = packageTheme(path.resolve(target ?? "."), { out: typeof options.out === "string" ? options.out : undefined });
+    printReport(result.report);
     if (!result.ok) {
-      printReport(result.report);
       console.error("Paket oluşturulmadı: önce hataları düzeltin.");
       return 1;
     }
-    printReport(result.report);
     console.log(`Paket: ${result.file} (${result.files} dosya, ${(result.bytes / 1024).toFixed(0)} KB)`);
     console.log(`SHA-256: ${result.sha256}`);
     return 0;
   }
+  if (command === "push") return push(target, options);
+  if (command === "dev") return dev(target, options);
+  if (command === "pull") return pull(target, options);
+  if (command === "list") return list(options);
+  if (command === "submit") return submit(target, options);
+  if (command === "delete") return remove(target, options);
   console.error(`Bilinmeyen tema komutu: ${command ?? "(yok)"}\n\n${help}`);
   return 1;
 }

package/src/package.js

@@ -1,75 +1,34 @@
 import { createHash } from "node:crypto";
 import { readFileSync, writeFileSync } from "node:fs";
 import path from "node:path";
-import zlib from "node:zlib";
-import { checkTheme } from "./check.js";
+import { checkTheme, limits, localOnly } from "./check.js";
 import { walk } from "./files.js";
+import { zip } from "./zip.js";
 
-// Denetimden geçen temayı zip paketine çevirir. Zip burada yazılır (ek bağımlılık yok); dosya
-// tarihleri sabit tutulur, böylece aynı içerik her zaman aynı SHA-256 özetini verir.
-const DOS_DATE = ((2026 - 1980) << 9) | (1 << 5) | 1;
-
-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]);
-}
-
-export function packageTheme(dir, { out } = {}) {
+/** 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 yalnızca bağımsız tema klasörlerinde yapılır.");
+    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.");
     return { ok: false, report };
   }
   const meta = JSON.parse(readFileSync(path.join(dir, "theme.json"), "utf8"));
-  const { files } = walk(dir);
-  const entries = files
-    .filter((file) => !file.rel.endsWith(".zip"))
+  const entries = walk(dir)
+    .files.filter((file) => !localOnly(file.rel))
     .map((file) => ({ name: `${meta.key}/${file.rel}`, data: readFileSync(file.full) }));
   const buffer = zip(entries);
-  const file = path.resolve(out ?? path.join(path.dirname(dir), `${meta.key}-${meta.version}.zip`));
-  writeFileSync(file, buffer);
-  return { ok: true, report, file, files: entries.length, bytes: buffer.length, sha256: createHash("sha256").update(buffer).digest("hex") };
+  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.`);
+    return { ok: false, report };
+  }
+  return { ok: true, report, meta, buffer, files: entries.length, sha256: createHash("sha256").update(buffer).digest("hex") };
+}
+
+export function packageTheme(dir, { out } = {}) {
+  const built = buildArchive(dir);
+  if (!built.ok) return built;
+  const file = path.resolve(out ?? path.join(path.dirname(dir), `${built.meta.key}-${built.meta.version}.zip`));
+  writeFileSync(file, built.buffer);
+  return { ok: true, report: built.report, file, files: built.files, bytes: built.buffer.length, sha256: built.sha256 };
 }