@blocofy/cli 0.5.0 → 0.6.0

package/README.md

@@ -33,6 +33,19 @@ blocofy --help
 
 ## Changelog
 
+- **0.6.0** — `theme dev`'s local view finally shows what you are working on. It used to render your
+  DRAFT theme against the site's LIVE page content, so draft page documents were invisible; each render
+  now carries the draft theme instance and the platform resolves that instance's pages. Three failures
+  caused by a retired server endpoint (`/api/dev/session`, gone since the platform's preview-security
+  work) are fixed at the root: **draft sync** was switched off whenever that endpoint failed even though
+  sync never used it (it posts to `/api/dev/theme`); **`theme publish`** without `--instance` called it
+  with no error handling and died with an empty message — it now resolves the CLI draft from
+  `blocofy status` (`source: "import"`); and an empty response body produced the undiagnosable
+  `dev session unavailable ()` — errors now fall back to `HTTP <status>` and a 410 explains itself.
+  If the server ever stops returning a draft handle, the CLI now says so instead of silently rendering
+  live content. Remote (shared-link and editor) preview is NOT restored — that surface was retired on
+  the platform side; `theme dev` prints the local view only.
+
 - **0.5.0** — M4 canonical deploy protocol. `theme push` now deploys through the platform's atomic
   source pipeline: the CLI declares the protocol handshake and auto-generates a per-push idempotency
   key (transport retries converge; `--idempotency-key <k>` overrides it for scripting). A `--live`

package/bin/blocofy.mjs

@@ -460,8 +460,8 @@ async function themeDev(rest) {
       session = await fetchDevSession({ url: creds.url, token: creds.token, name });
     } catch (error) {
       console.warn(
-        `Warning: dev session unavailable (${error?.message ?? error}). ` +
-          `Local preview only — live-domain/editor views + draft sync disabled.`,
+        `Warning: dev session unavailable (${error?.message || error}). ` +
+          `Live-domain and editor views are disabled; draft sync and local preview keep working.`,
       );
     }
   }
@@ -523,8 +523,12 @@ async function themeDev(rest) {
     url: creds.url,
     token: creds.token,
     port,
-    syncDraft: Boolean(session),
+    // Taslak senkronu dev session'a BAĞLI DEĞİL: `pushTheme({draft:true})` /api/dev/theme'e gider ve
+    // session'dan hiçbir veri kullanmaz. Bu satır `Boolean(session)` iken, session 410 alınca senkron
+    // da sessizce kapanıyordu — ölü bir uç, çalışan bir özelliği götürüyordu. Tek kapatma yolu --no-sync.
+    syncDraft: !flags["no-sync"],
     onRetry: (info) => console.error(`  ${retryNotice(info)}`),
+    onWarn: (msg) => console.warn(`  ⚠ ${msg}`),
     // Her kaydetmede ne olduğunu bas — "reloaded" = watch tetiklendi; "0 views"
     // = hiçbir tarayıcı sekmesi bağlı değil (yanlış görünüme bakıyorsun); sync
     // hatası = draft güncellenemedi (preview/editör eski kalır, local yine yenilenir).
@@ -585,9 +589,26 @@ async function themePublish(rest) {
   const creds = requireCreds();
   let instance = typeof flags.instance === "string" ? flags.instance : null;
   if (!instance) {
-    // Belirtilmediyse: `theme dev` / `theme push --draft`'ın yazdığı taslağı yayınla.
-    const session = await fetchDevSession({ url: creds.url, token: creds.token });
-    instance = session.draftInstanceId;
+    // Belirtilmediyse: `theme dev` / `theme push --draft`'ın yazdığı taslağı yayınla. Kaynak
+    // `GET /api/dev/site` — eski `fetchDevSession` yolu sunucuda 410'a döndü ve bu komutu
+    // try/catch'siz, boş mesajlı bir Error ile tamamen çalışmaz hâle getirmişti.
+    //
+    // `drafts` canlı OLMAYAN HER instance'ı içerir; sunucunun `ensureDraftInstance`'ı ise
+    // `source === "import"` olanı seçer (yayınlanan taslak import'tan çıkarılır). Aynı seçimi
+    // burada tekrarla — yoksa bir kez yayın yapmış her sitede iki taslak görünür ve komut takılır.
+    const status = await fetchSiteStatus({ url: creds.url, token: creds.token });
+    const drafts = status?.drafts ?? [];
+    const cliDrafts = drafts.filter((d) => d.source === "import");
+    if (cliDrafts.length === 1) {
+      instance = cliDrafts[0].id;
+    } else if (drafts.length === 0) {
+      console.error("No draft theme to publish. Create one first:  blocofy theme push --draft");
+      process.exit(1);
+    } else {
+      console.error("Could not tell which draft to publish — pick one with --instance <handle>:");
+      for (const d of drafts) console.error(`  ${d.id}  ${d.name ?? "(unnamed)"}`);
+      process.exit(1);
+    }
   }
   const result = await publishInstance({ url: creds.url, token: creds.token, instanceId: instance });
   console.log(

package/lib/dev-server.mjs

@@ -20,16 +20,52 @@ import { pushTheme } from "./theme-sync.mjs";
  * separate request); direct `/asset/*` references are served from disk. Images/JS
  * are remote (Directus/CDN), so no local serving is needed for them.
  */
-export function startDevServer({ dir, url, token, port, syncDraft = false, onError, onReload, onRetry }) {
+export function startDevServer({ dir, url, token, port, syncDraft = false, onError, onReload, onRetry, onWarn }) {
   const base = url.replace(/\/+$/, "");
   const clients = new Set();
 
+  // Taslak instance handle'ı: `pushTheme({draft:true})` yanıtından gelir (ek istek YOK). Render
+  // istekleri bunu taşıyınca platform CANLI sayfa belgeleri yerine TASLAĞIN sayfa belgelerini
+  // çözer — `theme dev`'in yerel görünümü nihayet üzerinde çalışılan şeyi gösterir.
+  let draftInstance = null;
+  // Kanonik yazma yolu ham control-plane JSON'u döndürür ve `instanceId` içermeyebilir. O durumda
+  // sessizce canlıya dönmek, bu onarımın kapattığı arıza sınıfının aynısı olurdu — bir kez uyar.
+  let warnedNoHandle = false;
+  const noteHandle = (pushed) => {
+    if (pushed?.instanceId) {
+      draftInstance = pushed.instanceId;
+      return;
+    }
+    if (!warnedNoHandle) {
+      warnedNoHandle = true;
+      onWarn?.(
+        "the server did not return a draft theme handle — local preview will render LIVE page content, not your draft.",
+      );
+    }
+  };
+
+  // Açılıştaki push'u BİR promise olarak tut: ilk render isteği bunu bekler, yoksa ilk sayfa
+  // yüklemesi canlı içerikle gelir ve geliştirici "taslağım görünmüyor" sanır.
+  const draftReady = syncDraft
+    ? pushTheme({ dir, url, token, draft: true, onRetry })
+        .then(noteHandle)
+        .catch(() => {})
+    : Promise.resolve();
+
   async function renderPath(pathname) {
+    // Açılış push'u bitene kadar bekle — yalnız ilk istekte gerçekten bekler, sonra çözülmüş promise.
+    if (!draftInstance) await draftReady;
     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 }),
+      // `preview` BİLİNÇLE gönderilmez: sunucuda preview yalnız tazelik değil — önizleme bandı,
+      // editör bridge'i ve blok işaretleyicileri de ona bağlı. `theme dev`'in vaadi prod paritesi.
+      body: JSON.stringify({
+        path: pathname,
+        templates,
+        ...(draftInstance ? { instance: draftInstance } : {}),
+      }),
     });
     const text = await res.text();
     if (!res.ok) {
@@ -100,7 +136,7 @@ export function startDevServer({ dir, url, token, port, syncDraft = false, onErr
         // BİLİNÇLE key'siz (0.5.0): dev sync her kayıtta koşar — kanonik mühür (key'li dal) kayıt
         // başına revizyon+deployment üretirdi (retention yok) ve taslak önizlemeye katkısı sıfır.
         // Key'siz istek sunucuda legacy draft yazımıdır; kanonik mühür bilinçli `theme push` işidir.
-        await pushTheme({ dir, url, token, draft: true, onRetry });
+        noteHandle(await pushTheme({ dir, url, token, draft: true, onRetry }));
       } catch (err) {
         error = err?.message ?? String(err); // senkron hatası reload'u engellemesin
       }
@@ -109,11 +145,6 @@ export function startDevServer({ dir, url, token, port, syncDraft = false, onErr
     onReload?.({ file, synced: syncDraft && !error, clients: clients.size, error });
   });
 
-  // Açılışta taslağı bir kez doldur → uzak görünümler hemen güncel local'i gösterir.
-  if (syncDraft) {
-    void pushTheme({ dir, url, token, draft: true, onRetry }).catch(() => {});
-  }
-
   server.listen(port);
 
   return {

package/lib/theme-sync.mjs

@@ -25,10 +25,14 @@ function canonicalHeaders(extra = {}) {
 async function errorText(res) {
   const text = await res.text();
   try {
-    return JSON.parse(text).error ?? text;
+    const parsed = JSON.parse(text).error;
+    if (parsed) return parsed;
   } catch {
-    return text;
+    /* JSON değil — ham metne düş */
   }
+  // İçeriksiz yanıt (ör. 410 tombstone) boş dize döndürüp `Error("")` üretiyordu; kullanıcı
+  // `unavailable ()` görüyordu. Gövde yoksa statü tek teşhis kaynağıdır — onu taşı.
+  return text || `HTTP ${res.status}${res.statusText ? ` ${res.statusText}` : ""}`;
 }
 
 /**
@@ -158,7 +162,19 @@ export async function fetchDevSession({ url, token, name = null }) {
   const res = await fetch(`${base}/api/dev/session${query}`, {
     headers: { authorization: `Bearer ${token}` },
   });
-  if (!res.ok) throw new Error(await errorText(res));
+  if (!res.ok) {
+    const detail = await errorText(res);
+    // Yeni sunucular 410'da açıklayıcı bir gövde döndürür — onu olduğu gibi göster, o otoritedir.
+    // Gövdesiz 410 (eski sunucu) `errorText`'ten "HTTP 410 …" olarak gelir; o durumda teşhisi
+    // biz veririz, yoksa kullanıcı yalnız bir statü kodu görür.
+    if (res.status === 410 && /^HTTP 410\b/.test(detail)) {
+      throw new Error(
+        "CLI remote preview (the signed preview URL and the editor view) is retired on this server " +
+          "(HTTP 410). Draft sync and `theme publish` are unaffected — they use different endpoints.",
+      );
+    }
+    throw new Error(detail);
+  }
   return res.json();
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blocofy/cli",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Develop your Blocofy theme locally against live data with instant preview — login, theme dev, pull, push.",
   "type": "module",
   "license": "MIT",