@blocofy/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Blocofy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,48 @@
+# @blocofy/cli
+
+Blocofy tema geliştirme CLI — Shopify CLI modeli: local tema + **canlı veri** ile anında
+önizleme, sonra yayına alma. CLI **build almaz**; asset'leri kendi araçlarınla
+(npm/Vite/Tailwind) üretirsin, platform Liquid + statik asset olarak sunar.
+
+```bash
+npx @blocofy/cli login          # site URL + dev token (admin → Ayarlar → Tema CLI token'ları)
+cd path/to/tema
+npx @blocofy/cli theme dev       # http://localhost:3030 — local tema + canlı veri, livereload
+```
+
+## Komutlar
+
+```bash
+blocofy login [--url <url>] [--token <bcf_…>]
+                          # Platform URL + dev token kaydet (~/.blocofy/credentials.json, 0600).
+blocofy theme dev [dir]   # Local dev sunucusu: düzenle → tarayıcı otomatik yenilenir.
+                          # --port <n> (varsayılan 3030)
+blocofy theme pull [dir]  # Canlı temayı diske indir.
+blocofy theme push [dir]  # Local temayı canlı siteye yaz (create/update; silme yok).
+blocofy --version
+blocofy --help
+```
+
+## Nasıl çalışır
+
+`theme dev` kendi http sunucusunu açar; her sayfa isteğinde local tema dosyalarını okuyup
+platformun dev-render endpoint'ine (`/api/dev/render`) gönderir. Platform site'ın **canlı
+verisiyle** render edip HTML döner — yani CLI render motorunu içermez, üretimle birebir aynı
+çıktı görürsün. `fs.watch` ile dosya değişince tarayıcı SSE üzerinden yenilenir.
+
+Kimlik bilgisi: `~/.blocofy/credentials.json` ya da `BLOCOFY_URL` + `BLOCOFY_TOKEN` ortam
+değişkenleri (CI/agent için).
+
+## Geliştirme
+
+Zero-dependency (yalnız Node yerleşikleri). Test:
+
+```bash
+node --test
+```
+
+Node ≥ 18 gerekir.
+
+## Lisans
+
+[MIT](./LICENSE)

package/bin/blocofy.mjs

@@ -0,0 +1,252 @@
+#!/usr/bin/env node
+/**
+ * Blocofy tema CLI (#119). Shopify CLI modeli: local tema + canlı veri instant
+ * preview, sonra yayına alma.
+ *
+ * İki mod:
+ *  - Standalone (Faz 3d): `blocofy login` ile platform URL + dev token kaydet →
+ *    `blocofy theme dev` kendi http sunucusunu açar, her isteği platformun
+ *    `/api/dev/render`'ına proxy'ler (local tema + canlı veri), fs.watch ile
+ *    livereload. Monorepo GEREKMEZ → external müşteri `npx @blocofy/cli` ile.
+ *  - Monorepo (Faz 2 v1): login yoksa, monorepo içindeyse renderer'ı THEME_DEV_DIR
+ *    ile spawn eder (fallback).
+ */
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { createInterface } from "node:readline/promises";
+import { fileURLToPath } from "node:url";
+
+import { credentialsPath, loadCredentials, saveCredentials } from "../lib/credentials.mjs";
+import { startDevServer } from "../lib/dev-server.mjs";
+import { pullTheme, pushTheme } from "../lib/theme-sync.mjs";
+
+const VERSION = "0.1.0";
+const args = process.argv.slice(2);
+
+/** `--key value` ve `--flag` (boolean) ayrıştırıcı. */
+function parseFlags(rest) {
+  const flags = {};
+  for (let i = 0; i < rest.length; i++) {
+    const arg = rest[i];
+    if (!arg.startsWith("--")) continue;
+    const key = arg.slice(2);
+    const next = rest[i + 1];
+    if (next && !next.startsWith("--")) {
+      flags[key] = next;
+      i++;
+    } else {
+      flags[key] = true;
+    }
+  }
+  return flags;
+}
+
+function findMonorepoRoot(start) {
+  let dir = start;
+  for (let i = 0; i < 8; i++) {
+    if (existsSync(resolve(dir, "pnpm-workspace.yaml"))) return dir;
+    const parent = resolve(dir, "..");
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return null;
+}
+
+function printHelp() {
+  console.log(`blocofy — Blocofy tema geliştirme CLI (v${VERSION})
+
+Kullanım:
+  blocofy login [--url <url>] [--token <bcf_…>]
+                            Platform URL + dev token kaydet (~/.blocofy/credentials.json).
+                            Token: admin → Ayarlar → Tema CLI token'ları.
+  blocofy theme dev [dir]   Local tema dev sunucusu — local tema + canlı veri instant
+                            preview. Giriş yapıldıysa standalone (monorepo gerekmez);
+                            yoksa monorepo içinde renderer'ı sarar. dir varsayılan: cwd.
+                            --port <n> (varsayılan 3030), --standalone, --monorepo
+  blocofy theme pull [dir]  Canlı temayı diske indir (giriş gerekli). dir varsayılan: cwd.
+  blocofy theme push [dir]  Local temayı canlı siteye yaz (create/update; v1 silme yok).
+  blocofy --version
+  blocofy --help
+
+Yakında (#119): blocofy init, blocofy check.
+Not: CLI build ALMAZ — asset'leri kendi araçlarınla (npm/Vite/Tailwind) üretirsin;
+platform Liquid + statik asset olarak kalır.`);
+}
+
+async function login(rest) {
+  const flags = parseFlags(rest);
+  let url = typeof flags.url === "string" ? flags.url : "";
+  let token = typeof flags.token === "string" ? flags.token : "";
+
+  if (!url || !token) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+      if (!url) url = (await rl.question("Platform/site URL (örn. https://magaza.myblocofy.com): ")).trim();
+      if (!token) token = (await rl.question("Dev token (bcf_…): ")).trim();
+    } finally {
+      rl.close();
+    }
+  }
+
+  url = url.replace(/\/+$/, "");
+  if (!/^https?:\/\//.test(url)) {
+    console.error("Geçersiz URL — http(s):// ile başlamalı.");
+    process.exit(1);
+  }
+  if (!token.startsWith("bcf_")) {
+    console.error("Geçersiz token — bcf_ ile başlamalı (admin → Ayarlar → Tema CLI token'ları).");
+    process.exit(1);
+  }
+
+  saveCredentials({ url, token });
+  console.log(`Giriş kaydedildi: ${credentialsPath()}`);
+  console.log(`Artık tema dizininde: blocofy theme dev`);
+}
+
+/** Giriş bilgisi (URL+token) çöz ya da hata ver. pull/push standalone gerektirir. */
+function requireCreds() {
+  const creds = loadCredentials();
+  if (!creds || !creds.url || !creds.token) {
+    console.error("Giriş gerekli: `blocofy login` (ya da BLOCOFY_URL + BLOCOFY_TOKEN).");
+    process.exit(1);
+  }
+  return creds;
+}
+
+async function themePull(rest) {
+  const positional = rest.filter((a) => !a.startsWith("--"));
+  const dir = resolve(positional[0] ?? process.cwd());
+  const creds = requireCreds();
+  const { count } = await pullTheme({ dir, url: creds.url, token: creds.token });
+  console.log(`${count} tema dosyası indirildi → ${dir}`);
+}
+
+async function themePush(rest) {
+  const positional = rest.filter((a) => !a.startsWith("--"));
+  const dir = resolve(positional[0] ?? process.cwd());
+  if (!existsSync(dir)) {
+    console.error(`Tema dizini yok: ${dir}`);
+    process.exit(1);
+  }
+  const creds = requireCreds();
+  const result = await pushTheme({ dir, url: creds.url, token: creds.token });
+  const extra = result.skippedDeletes
+    ? `, ${result.skippedDeletes} uzak dosya yerelde yok (v1: silinmedi)`
+    : "";
+  console.log(`Push: ${result.created} yeni, ${result.updated} güncellendi${extra}.`);
+}
+
+function themeDev(rest) {
+  const flags = parseFlags(rest);
+  const positional = rest.filter((a) => !a.startsWith("--"));
+  const themeDir = resolve(positional[0] ?? process.cwd());
+
+  if (!existsSync(themeDir)) {
+    console.error(`Tema dizini yok: ${themeDir}`);
+    process.exit(1);
+  }
+
+  const creds = flags.monorepo ? null : loadCredentials();
+  const canStandalone = Boolean(creds && creds.url && creds.token);
+
+  // Standalone: giriş yapıldıysa (ya da --standalone zorlanırsa).
+  if (canStandalone || flags.standalone) {
+    if (!canStandalone) {
+      console.error("Standalone için giriş gerekli: `blocofy login` (ya da BLOCOFY_URL + BLOCOFY_TOKEN).");
+      process.exit(1);
+    }
+    const port = Number(flags.port) || 3030;
+    console.log(`blocofy theme dev (standalone)`);
+    console.log(`  tema dizini : ${themeDir}`);
+    console.log(`  platform    : ${creds.url}`);
+    console.log(`  token       : ${creds.token.slice(0, 8)}… (${creds.source})`);
+    console.log(`  önizleme    : http://localhost:${port}`);
+    console.log(`  → tema dosyasını düzenle, kaydet = tarayıcı otomatik yenilenir (livereload)`);
+
+    if (flags.dry) {
+      console.log("(--dry: sunucu başlatılmadı)");
+      return;
+    }
+
+    const handle = startDevServer({
+      dir: themeDir,
+      url: creds.url,
+      token: creds.token,
+      port,
+      onError: (err) => {
+        if (err && err.code === "EADDRINUSE") {
+          console.error(`Port ${port} kullanımda. Farklı port: blocofy theme dev --port <n>`);
+        } else {
+          console.error(`Sunucu hatası: ${err?.message ?? err}`);
+        }
+        process.exit(1);
+      },
+    });
+    const shutdown = () => {
+      handle.close();
+      process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    return;
+  }
+
+  // Monorepo fallback (Faz 2 v1): renderer'ı THEME_DEV_DIR ile spawn et.
+  const root = findMonorepoRoot(dirname(fileURLToPath(import.meta.url)));
+  if (!root) {
+    console.error(
+      "Ne giriş yapıldı ne de monorepo bulundu.\n" +
+        "External kullanım için: `blocofy login` (admin'den dev token al).\n" +
+        "Monorepo içinde çalışıyorsan pnpm-workspace.yaml görünür bir dizinden çalıştır.",
+    );
+    process.exit(1);
+  }
+
+  console.log(`blocofy theme dev (monorepo)`);
+  console.log(`  tema dizini : ${themeDir}`);
+  console.log(`  renderer    : ${root} (THEME_DEV_DIR ile)`);
+  console.log(`  önizleme    : http://<slug>.localhost:3003  (örn. test-cafe.localhost)`);
+  console.log(`  → tema dosyasını düzenle, tarayıcıyı yenile = instant preview (gerçek içerikle)`);
+
+  if (flags.dry) {
+    console.log("(--dry: renderer başlatılmadı)");
+    return;
+  }
+
+  const child = spawn("pnpm", ["--filter", "renderer", "dev"], {
+    cwd: root,
+    env: { ...process.env, THEME_DEV_DIR: themeDir },
+    stdio: "inherit",
+  });
+  child.on("exit", (code) => process.exit(code ?? 0));
+}
+
+const [first, ...rest] = args;
+
+if (first === "--version" || first === "-v") {
+  console.log(VERSION);
+} else if (!first || first === "--help" || first === "-h" || first === "help") {
+  printHelp();
+} else if (first === "login") {
+  login(rest).catch((error) => {
+    console.error(error?.message ?? error);
+    process.exit(1);
+  });
+} else if (first === "theme" && rest[0] === "dev") {
+  themeDev(rest.slice(1));
+} else if (first === "theme" && rest[0] === "pull") {
+  themePull(rest.slice(1)).catch((error) => {
+    console.error(error?.message ?? error);
+    process.exit(1);
+  });
+} else if (first === "theme" && rest[0] === "push") {
+  themePush(rest.slice(1)).catch((error) => {
+    console.error(error?.message ?? error);
+    process.exit(1);
+  });
+} else {
+  console.error(`Bilinmeyen komut: ${args.join(" ")}\n`);
+  printHelp();
+  process.exit(1);
+}

package/lib/credentials.mjs

@@ -0,0 +1,50 @@
+import { chmodSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+/**
+ * Blocofy CLI kimlik bilgileri (#119 Faz 3d). `blocofy login` platform URL'i +
+ * dev token'ı `~/.blocofy/credentials.json`'a (0600) yazar; `blocofy theme dev`
+ * standalone modu bunu okur. Env (BLOCOFY_URL/BLOCOFY_TOKEN) dosyayı geçersiz
+ * kılar (CI/agent). Token plaintext diskte tutulur (Shopify/gh CLI deseni) →
+ * dosya izni 0600.
+ */
+
+const DIR = join(homedir(), ".blocofy");
+const FILE = join(DIR, "credentials.json");
+
+export function credentialsPath() {
+  return FILE;
+}
+
+/** URL + token'ı 0600 izniyle yaz. */
+export function saveCredentials({ url, token }) {
+  mkdirSync(DIR, { recursive: true, mode: 0o700 });
+  writeFileSync(FILE, JSON.stringify({ url, token }, null, 2) + "\n", { mode: 0o600 });
+  chmodSync(FILE, 0o600); // dosya zaten varsa create-mode uygulanmaz → zorla
+}
+
+/**
+ * Kimlik bilgisi çöz: önce env (tam çift), sonra dosya. `{ url, token, source }`
+ * ya da null. URL sondaki `/`'lardan arındırılır.
+ */
+export function loadCredentials() {
+  const envUrl = process.env.BLOCOFY_URL;
+  const envToken = process.env.BLOCOFY_TOKEN;
+  if (envUrl && envToken) {
+    return { url: stripSlash(envUrl), token: envToken, source: "env" };
+  }
+  try {
+    const data = JSON.parse(readFileSync(FILE, "utf8"));
+    if (data && typeof data.url === "string" && typeof data.token === "string") {
+      return { url: stripSlash(data.url), token: data.token, source: "file" };
+    }
+  } catch {
+    // dosya yok/bozuk → null
+  }
+  return null;
+}
+
+function stripSlash(url) {
+  return url.replace(/\/+$/, "");
+}

package/lib/dev-server.mjs

@@ -0,0 +1,155 @@
+import { createServer } from "node:http";
+import { existsSync, readFileSync, statSync, watch } from "node:fs";
+import { join, normalize, sep } from "node:path";
+
+import {
+  LIVERELOAD_PATH,
+  contentTypeFor,
+  injectLivereload,
+  readLocalTemplates,
+} from "./local-theme.mjs";
+
+/**
+ * Standalone dev sunucusu (#119 Faz 3d). Her sayfa isteğinde local tema dosyalarını
+ * okuyup platformun `/api/dev/render`'ına yollar, dönen HTML'e livereload script'i
+ * enjekte eder. `fs.watch` ile dosya değişince SSE üzerinden tarayıcıyı yeniler.
+ *
+ * Asset'ler genelde `{% render 'asset/x.css' %}` ile HTML'e GÖMÜLÜ gelir (ayrı
+ * istek yok); doğrudan `/asset/*` referansları için diskten statik servis edilir.
+ * Görsel/JS uzak (Directus/CDN) → local servise gerek yok.
+ */
+export function startDevServer({ dir, url, token, port, onError }) {
+  const base = url.replace(/\/+$/, "");
+  const clients = new Set();
+
+  async function renderPath(pathname) {
+    const templates = readLocalTemplates(dir);
+    const res = await fetch(`${base}/api/dev/render`, {
+      method: "POST",
+      headers: { "content-type": "application/json", authorization: `Bearer ${token}` },
+      body: JSON.stringify({ path: pathname, templates }),
+    });
+    const text = await res.text();
+    if (!res.ok) {
+      let message = text;
+      try {
+        message = JSON.parse(text).error ?? text;
+      } catch {
+        /* ham metin */
+      }
+      return { status: res.status, html: errorHtml(res.status, message) };
+    }
+    try {
+      return { status: 200, html: JSON.parse(text).html ?? "" };
+    } catch {
+      return { status: 200, html: text };
+    }
+  }
+
+  const server = createServer(async (req, res) => {
+    try {
+      const pathname = decodeURIComponent(new URL(req.url, "http://localhost").pathname);
+
+      // Livereload SSE kanalı.
+      if (pathname === LIVERELOAD_PATH) {
+        res.writeHead(200, {
+          "content-type": "text/event-stream",
+          "cache-control": "no-cache, no-transform",
+          connection: "keep-alive",
+        });
+        res.write("retry: 1000\n\n");
+        clients.add(res);
+        req.on("close", () => clients.delete(res));
+        return;
+      }
+
+      // Doğrudan /asset/* referansı → diskten servis et (varsa).
+      const assetFile = safeAssetFile(dir, pathname);
+      if (assetFile) {
+        res.writeHead(200, { "content-type": contentTypeFor(assetFile), "cache-control": "no-store" });
+        res.end(readFileSync(assetFile));
+        return;
+      }
+
+      // Sayfa → platforma render ettir.
+      const { status, html } = await renderPath(pathname);
+      res.writeHead(status, { "content-type": "text/html; charset=utf-8", "cache-control": "no-store" });
+      res.end(injectLivereload(html));
+    } catch (err) {
+      res.writeHead(502, { "content-type": "text/html; charset=utf-8" });
+      res.end(injectLivereload(errorHtml(502, err?.message ?? String(err))));
+    }
+  });
+
+  if (onError) server.on("error", onError);
+
+  const watcher = startWatch(dir, () => {
+    for (const client of clients) client.write("data: reload\n\n");
+  });
+
+  server.listen(port);
+
+  return {
+    server,
+    close() {
+      try {
+        watcher?.close();
+      } catch {
+        /* yoksay */
+      }
+      for (const client of clients) client.end();
+      server.close();
+    },
+  };
+}
+
+/**
+ * `dir`'i izle; recursive desteklenmiyorsa (eski Node/Linux) recursive'siz dener.
+ * Debounce'lu `onChange` çağırır. İzlenemezse null (livereload pasif).
+ */
+function startWatch(dir, onChange) {
+  let timer = null;
+  const fire = () => {
+    if (timer) clearTimeout(timer);
+    timer = setTimeout(onChange, 120);
+  };
+  try {
+    return watch(dir, { recursive: true }, fire);
+  } catch {
+    try {
+      return watch(dir, fire);
+    } catch {
+      return null;
+    }
+  }
+}
+
+/** `/asset/*` yolunu disk dosyasına eşle (path-traversal korumalı); yoksa null. */
+function safeAssetFile(dir, pathname) {
+  if (!pathname.startsWith("/asset/")) return null;
+  const root = normalize(dir);
+  const full = normalize(join(dir, pathname.replace(/^\/+/, "")));
+  if (full !== root && !full.startsWith(root + sep)) return null;
+  try {
+    if (existsSync(full) && statSync(full).isFile()) return full;
+  } catch {
+    /* yoksay */
+  }
+  return null;
+}
+
+function escapeHtml(value) {
+  return String(value).replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+
+function errorHtml(status, message) {
+  return (
+    `<!doctype html><html lang="tr"><head><meta charset="utf-8">` +
+    `<title>blocofy dev — ${status}</title></head>` +
+    `<body style="font-family:system-ui,sans-serif;padding:2rem;max-width:48rem;margin:0 auto">` +
+    `<h1 style="color:#b91c1c">Render hatası (${status})</h1>` +
+    `<pre style="white-space:pre-wrap;background:#f4f4f5;padding:1rem;border-radius:.5rem;color:#333">${escapeHtml(message)}</pre>` +
+    `<p style="color:#666">Tema dosyasını düzelt — kaydedince bu sayfa otomatik yenilenir.</p>` +
+    `</body></html>`
+  );
+}

package/lib/local-theme.mjs

@@ -0,0 +1,82 @@
+import { readdirSync, readFileSync, statSync } from "node:fs";
+import { extname, join, relative, sep } from "node:path";
+
+/**
+ * Local tema dosyalarını okuma + livereload — `@blocofy/cms`'in zero-dep aynası
+ * (standalone CLI cms'i bundle edemez). `readLocalTemplates`, cms'teki
+ * `loadLocalTemplates` (templates.ts) ile BİREBİR aynı eşlemeyi yapar:
+ * üst-dizini THEME_DIRS olan dosyalar, key = göreli yol, `.liquid` strip'li.
+ */
+
+const THEME_DIRS = new Set(["layout", "section", "block", "partial", "asset", "template"]);
+const LIQUID_KINDS = new Set(["layout", "section", "block", "partial", "template"]);
+
+/**
+ * Stripped key → disk yolu (cms `repoPathFor`'un aynası): liquid kind'lara `.liquid`
+ * ekler, asset'i ham bırakır. `pull` diske yazarken kullanır (readLocalTemplates tersi).
+ */
+export function localPathFor(key) {
+  const top = key.split("/")[0] ?? "";
+  return LIQUID_KINDS.has(top) && !key.endsWith(".liquid") ? `${key}.liquid` : key;
+}
+
+/** Tema dizinini `{path: content}` haritasına çevir (dev-render'a gönderilir). */
+export function readLocalTemplates(dir) {
+  const out = {};
+  const walk = (current) => {
+    for (const name of readdirSync(current)) {
+      const full = join(current, name);
+      if (statSync(full).isDirectory()) {
+        walk(full);
+        continue;
+      }
+      const rel = relative(dir, full).split(sep).join("/");
+      const top = rel.split("/")[0] ?? "";
+      if (!THEME_DIRS.has(top)) continue;
+      out[rel.endsWith(".liquid") ? rel.slice(0, -7) : rel] = readFileSync(full, "utf8");
+    }
+  };
+  walk(dir);
+  return out;
+}
+
+const LIVERELOAD_PATH = "/__blocofy_livereload";
+
+const LIVERELOAD_SNIPPET = `<script>
+(function(){try{var es=new EventSource(${JSON.stringify(LIVERELOAD_PATH)});es.onmessage=function(e){if(e.data==="reload")location.reload();};}catch(_){}})();
+</script>`;
+
+export { LIVERELOAD_PATH };
+
+/** Render edilen HTML'e livereload script'ini ekle (</body>'den önce). */
+export function injectLivereload(html) {
+  if (typeof html !== "string") return html;
+  return html.includes("</body>")
+    ? html.replace("</body>", LIVERELOAD_SNIPPET + "</body>")
+    : html + LIVERELOAD_SNIPPET;
+}
+
+const CONTENT_TYPES = {
+  ".css": "text/css",
+  ".js": "text/javascript",
+  ".mjs": "text/javascript",
+  ".json": "application/json",
+  ".svg": "image/svg+xml",
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".gif": "image/gif",
+  ".webp": "image/webp",
+  ".avif": "image/avif",
+  ".ico": "image/x-icon",
+  ".woff": "font/woff",
+  ".woff2": "font/woff2",
+  ".ttf": "font/ttf",
+  ".txt": "text/plain",
+  ".map": "application/json",
+};
+
+/** Uzantıdan content-type (statik asset servisi için). */
+export function contentTypeFor(p) {
+  return CONTENT_TYPES[extname(p).toLowerCase()] ?? "application/octet-stream";
+}

package/lib/theme-sync.mjs

@@ -0,0 +1,48 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+
+import { localPathFor, readLocalTemplates } from "./local-theme.mjs";
+
+/**
+ * `blocofy theme pull/push` (#119 Faz 3e). Platformun `/api/dev/theme` endpoint'iyle
+ * konuşur (token Bearer). pull = GET → diske yaz (.liquid re-map); push = readLocalTemplates
+ * → POST (create/update; v1 silme yok).
+ */
+
+async function errorText(res) {
+  const text = await res.text();
+  try {
+    return JSON.parse(text).error ?? text;
+  } catch {
+    return text;
+  }
+}
+
+/** Canlı temayı diske indir. `{path: content}` (stripped) → `.liquid`'li disk dosyaları. */
+export async function pullTheme({ dir, url, token }) {
+  const base = url.replace(/\/+$/, "");
+  const res = await fetch(`${base}/api/dev/theme`, { headers: { authorization: `Bearer ${token}` } });
+  if (!res.ok) throw new Error(await errorText(res));
+  const { files } = await res.json();
+  let count = 0;
+  for (const [key, content] of Object.entries(files ?? {})) {
+    const full = join(dir, localPathFor(key));
+    mkdirSync(dirname(full), { recursive: true });
+    writeFileSync(full, typeof content === "string" ? content : "");
+    count += 1;
+  }
+  return { count };
+}
+
+/** Local temayı canlı siteye yaz (create/update; v1 silme yok). */
+export async function pushTheme({ dir, url, token }) {
+  const base = url.replace(/\/+$/, "");
+  const files = readLocalTemplates(dir);
+  const res = await fetch(`${base}/api/dev/theme`, {
+    method: "POST",
+    headers: { "content-type": "application/json", authorization: `Bearer ${token}` },
+    body: JSON.stringify({ files }),
+  });
+  if (!res.ok) throw new Error(await errorText(res));
+  return res.json();
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@blocofy/cli",
+  "version": "0.1.0",
+  "description": "Blocofy tema geliştirme CLI — local dev, pull, push (Shopify CLI modeli).",
+  "type": "module",
+  "license": "MIT",
+  "author": "Blocofy",
+  "homepage": "https://github.com/Blocofy/cli#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Blocofy/cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Blocofy/cli/issues"
+  },
+  "keywords": [
+    "blocofy",
+    "theme",
+    "cli",
+    "liquid",
+    "shopify-cli"
+  ],
+  "bin": {
+    "blocofy": "./bin/blocofy.mjs"
+  },
+  "files": [
+    "bin",
+    "lib"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "node --test"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}