jskelet 0.2.4 → 0.3.0

package/src/client/{cache-panel → admin}/panel.js

@@ -1,12 +1,13 @@
 /**
- * Önbellek panelinin istemci tarafı.
+ * Admin panelinin istemci tarafı.
  *
  * Build hattından geçmez, doğrudan diskten servis edilir: panelin açık olduğu
  * bir kurulumda `jskelet build` hiç koşmamış olabilir ve panel yine çalışmalı.
  * Bu yüzden burada import edilen bir framework modülü yok.
  *
  * Yenileme WebSocket değil, kısa aralıklı `fetch` ile: panel nadiren ve kısa
- * süre açık kalıyor, kalıcı bir kanal açmanın karşılığı yok.
+ * süre açık kalıyor, kalıcı bir kanal açmanın karşılığı yok. Log sayfası
+ * ayrıca SSE kullanır.
  *
  * Bütün görünen metin `i18n.js` üzerinden geçiyor; sunucudan gelen cevaplar da
  * metin değil `code` taşıyor, yani dil değişimi tek yerden hallediliyor.
@@ -14,6 +15,7 @@
 import { applyTranslations, languageSelect, t } from "./i18n.js";
 
 const REFRESH_MS = 3000;
+const PAGES = new Set(["overview", "cache", "routes", "views", "logs", "system"]);
 
 const $ = (/** @type {string} */ id) => document.getElementById(id);
 
@@ -25,6 +27,17 @@ let latest = null;
 /** @type {number | null} */
 let timer = null;
 let busy = false;
+/** @type {string} */
+let page = "overview";
+/** @type {any} */
+let routesPayload = null;
+/** @type {any} */
+let viewsPayload = null;
+/** @type {any[]} */
+let logBuffer = [];
+/** @type {EventSource | null} */
+let logSource = null;
+let logsPaused = false;
 
 /* ------------------------------------------------------------ biçimlendirme */
 
@@ -118,7 +131,7 @@ async function act(body) {
     headers: {
       "Content-Type": "application/json",
       // Panelin CSRF freni: çapraz siteden gönderilemeyen bir başlık.
-      "X-JSkelet-Cache-Panel": "1",
+      "X-JSkelet-Admin": "1",
     },
     body: JSON.stringify(body),
   });
@@ -206,6 +219,7 @@ function render() {
 
   renderRedis(redis, redisState);
   renderHost(host, proc, redis);
+  renderUpstream(latest.upstream);
 
   const done = prewarm.done ?? 0;
   const total = prewarm.total ?? 0;
@@ -219,6 +233,49 @@ function render() {
   renderTable();
 }
 
+/**
+ * @param {any} upstream
+ */
+function renderUpstream(upstream) {
+  const tbody = $("upstream-tbody");
+  const empty = $("upstream-empty");
+  const heading = $("upstream-heading");
+  if (!tbody || !empty || !heading) return;
+
+  const hosts = Array.isArray(upstream) ? upstream : [];
+  heading.textContent = String(hosts.length);
+  tbody.replaceChildren();
+
+  if (!hosts.length) {
+    empty.hidden = false;
+    return;
+  }
+
+  empty.hidden = true;
+  for (const info of hosts) {
+    const row = document.createElement("tr");
+    const state = info?.bypassed
+      ? "bypassed"
+      : info?.blockedMs > 0
+        ? "blocked"
+        : `${info?.active ?? 0} active`;
+    row.innerHTML = `<td class="mono">${escapeHtml(String(info.host ?? ""))}</td><td class="mono">${escapeHtml(String(info.rate ?? "—"))}</td><td class="mono">${escapeHtml(String(state))}</td>`;
+    tbody.append(row);
+  }
+}
+
+/**
+ * @param {string} value
+ * @returns {string}
+ */
+function escapeHtml(value) {
+  return value
+    .replaceAll("&", "&amp;")
+    .replaceAll("<", "&lt;")
+    .replaceAll(">", "&gt;")
+    .replaceAll('"', "&quot;");
+}
+
 /* ------------------------------------------------------------- cloudflare */
 
 /** @type {any} */
@@ -352,7 +409,7 @@ async function loadCloudflareAnalytics() {
     method: "POST",
     headers: {
       "Content-Type": "application/json",
-      "X-JSkelet-Cache-Panel": "1",
+      "X-JSkelet-Admin": "1",
     },
     body: JSON.stringify({ path }),
   });
@@ -888,11 +945,273 @@ function flip(value) {
 // Sekme arkaya alındığında yoklama durur: panel açık kalmış bir sekmede
 // dakikalarca boşa istek atmasın.
 document.addEventListener("visibilitychange", () => {
-  if (document.hidden) stopPolling();
-  else if ($("auto").checked) {
+  if (document.hidden) {
+    stopPolling();
+    stopLogStream();
+  } else if ($("auto").checked) {
     void load();
     startPolling();
+    if (page === "logs") startLogStream();
+  }
+});
+
+/* -------------------------------------------------------------- sayfalar */
+
+/**
+ * URL yolunun son segmentinden sayfa adı.
+ * @returns {string}
+ */
+function pageFromLocation() {
+  const parts = location.pathname.replace(/\/+$/, "").split("/");
+  const last = parts[parts.length - 1] || "";
+  if (PAGES.has(last)) return last;
+  return "overview";
+}
+
+/**
+ * @param {string} next
+ * @param {{ push?: boolean }} [options]
+ */
+function showPage(next, options = {}) {
+  const name = PAGES.has(next) ? next : "overview";
+  page = name;
+
+  for (const node of document.querySelectorAll(".page")) {
+    const el = /** @type {HTMLElement} */ (node);
+    el.hidden = el.dataset.page !== name;
+  }
+
+  for (const link of document.querySelectorAll("#nav a")) {
+    const a = /** @type {HTMLAnchorElement} */ (link);
+    if (a.dataset.page === name) a.setAttribute("aria-current", "page");
+    else a.removeAttribute("aria-current");
+  }
+
+  const sse = $("sse-status");
+  if (sse) sse.hidden = name !== "logs";
+
+  if (options.push !== false) {
+    const target = name === "overview" ? "./" : name;
+    history.pushState({ page: name }, "", target);
+  }
+
+  if (name === "routes") void loadRoutes();
+  if (name === "views") void loadViews();
+  if (name === "logs") startLogStream();
+  else stopLogStream();
+}
+
+async function loadRoutes() {
+  const response = await fetch("api/routes");
+  if (!alive(response)) return;
+  if (!response.ok) return;
+  routesPayload = await response.json();
+  renderRoutes();
+}
+
+async function loadViews() {
+  const response = await fetch("api/views");
+  if (!alive(response)) return;
+  if (!response.ok) return;
+  viewsPayload = await response.json();
+  renderViews();
+}
+
+function renderRoutes() {
+  if (!routesPayload) return;
+
+  const routes = routesPayload.routes ?? [];
+  const modules = routesPayload.modules ?? [];
+  const activity = routesPayload.activity ?? {};
+
+  $("routes-count").textContent = String(routes.length);
+  $("modules-count").textContent = String(modules.length);
+
+  const tbody = $("routes-tbody");
+  const empty = $("routes-empty");
+  tbody.replaceChildren();
+
+  if (!routes.length) {
+    empty.hidden = false;
+  } else {
+    empty.hidden = true;
+    for (const route of routes) {
+      const key = route.path;
+      const act = activity[key] ?? null;
+      const row = document.createElement("tr");
+      row.innerHTML = `
+        <td class="mono">${escapeHtml(route.method)}</td>
+        <td class="mono"><button type="button" class="linkish" data-path="${escapeHtml(route.path)}">${escapeHtml(route.path)}</button></td>
+        <td class="mono">${act ? act.status : "—"}</td>
+        <td class="mono">${act ? Math.round(act.ms) : "—"}</td>
+        <td class="mono">${act ? act.count : "—"}</td>`;
+      tbody.append(row);
+    }
+
+    tbody.querySelectorAll("button[data-path]").forEach((button) => {
+      button.addEventListener("click", () => {
+        const pathFilter = /** @type {HTMLElement} */ (button).dataset.path ?? "";
+        $("logs-path").value = pathFilter;
+        showPage("logs");
+        renderLogs();
+      });
+    });
+  }
+
+  const modulesBody = $("modules-tbody");
+  modulesBody.replaceChildren();
+  for (const mod of modules) {
+    const row = document.createElement("tr");
+    row.innerHTML = `<td class="mono">${escapeHtml(mod.relative)}</td>`;
+    modulesBody.append(row);
+  }
+}
+
+function renderViews() {
+  if (!viewsPayload) return;
+
+  const term = ($("views-search")?.value ?? "").trim().toLowerCase();
+  const views = (viewsPayload.views ?? []).filter(
+    (/** @type {{ relative: string }} */ view) =>
+      !term || view.relative.toLowerCase().includes(term),
+  );
+
+  $("views-count").textContent = String(views.length);
+  const tbody = $("views-tbody");
+  const empty = $("views-empty");
+  tbody.replaceChildren();
+
+  if (!views.length) {
+    empty.hidden = false;
+    return;
+  }
+
+  empty.hidden = true;
+  for (const view of views) {
+    const row = document.createElement("tr");
+    row.innerHTML = `<td class="mono">${escapeHtml(view.relative)}</td><td>${escapeHtml(view.kind)}</td>`;
+    tbody.append(row);
+  }
+}
+
+function startLogStream() {
+  if (logSource) return;
+
+  const chip = $("sse-status");
+  if (chip) {
+    chip.hidden = false;
+    chip.textContent = t("chip.sse.live");
+  }
+
+  logSource = new EventSource("api/logs/stream");
+  logSource.onmessage = (event) => {
+    try {
+      const entry = JSON.parse(event.data);
+      if (!logsPaused) {
+        logBuffer.push(entry);
+        if (logBuffer.length > 1000) logBuffer.shift();
+        renderLogs();
+      }
+    } catch {
+      // bozuk çerçeve yok sayılır
+    }
+  };
+  logSource.onerror = () => {
+    if (chip) chip.textContent = t("chip.sse.error");
+  };
+}
+
+function stopLogStream() {
+  if (logSource) {
+    logSource.close();
+    logSource = null;
+  }
+  const chip = $("sse-status");
+  if (chip) {
+    chip.textContent = t("chip.sse.off");
+    chip.hidden = page !== "logs";
+  }
+}
+
+function renderLogs() {
+  const list = $("logs-list");
+  const empty = $("logs-empty");
+  const count = $("logs-count");
+  if (!list || !empty || !count) return;
+
+  const q = ($("logs-q")?.value ?? "").trim().toLowerCase();
+  const kind = $("logs-kind")?.value ?? "";
+  const method = $("logs-method")?.value ?? "";
+  const statusClass = $("logs-status")?.value ?? "";
+  const cache = $("logs-cache")?.value ?? "";
+  const pathFilter = ($("logs-path")?.value ?? "").trim().toLowerCase();
+
+  const filtered = logBuffer.filter((entry) => {
+    if (kind && entry.kind !== kind) return false;
+    if (method && entry.method !== method) return false;
+    if (statusClass && entry.status != null) {
+      if (String(Math.floor(Number(entry.status) / 100)) !== statusClass) return false;
+    }
+    if (cache && entry.cache !== cache) return false;
+    if (pathFilter) {
+      const hay = `${entry.path ?? ""} ${entry.route ?? ""} ${entry.url ?? ""}`.toLowerCase();
+      if (!hay.includes(pathFilter)) return false;
+    }
+    if (q) {
+      const hay = `${entry.url ?? ""} ${entry.message ?? ""} ${entry.scope ?? ""} ${entry.path ?? ""}`.toLowerCase();
+      if (!hay.includes(q)) return false;
+    }
+    return true;
+  });
+
+  count.textContent = t("logs.shown", { shown: filtered.length, total: logBuffer.length });
+  empty.hidden = filtered.length > 0;
+
+  const lines = filtered.slice(-300).map(formatLogLine);
+  list.textContent = lines.join("\n");
+  list.scrollTop = list.scrollHeight;
+}
+
+/**
+ * @param {any} entry
+ * @returns {string}
+ */
+function formatLogLine(entry) {
+  const time = new Date(entry.at).toISOString().slice(11, 19);
+  if (entry.kind === "http") {
+    const cache = entry.cache ? ` ${entry.cache}` : "";
+    const route = entry.route ? ` [${entry.route}]` : "";
+    return `${time}  ${String(entry.method).padEnd(6)} ${entry.status}  ${Math.round(entry.ms)}ms${cache}${route}  ${entry.url}`;
   }
+  return `${time}  ${entry.kind.padEnd(6)} ${entry.scope ?? ""}  ${entry.message ?? ""}${entry.note ? `  ${entry.note}` : ""}`;
+}
+
+for (const link of document.querySelectorAll("#nav a")) {
+  link.addEventListener("click", (event) => {
+    event.preventDefault();
+    const next = /** @type {HTMLElement} */ (link).dataset.page ?? "overview";
+    showPage(next);
+  });
+}
+
+window.addEventListener("popstate", () => {
+  showPage(pageFromLocation(), { push: false });
+});
+
+$("views-search")?.addEventListener("input", () => renderViews());
+
+for (const id of ["logs-q", "logs-kind", "logs-method", "logs-status", "logs-cache", "logs-path"]) {
+  $(id)?.addEventListener("input", () => renderLogs());
+  $(id)?.addEventListener("change", () => renderLogs());
+}
+
+$("logs-pause")?.addEventListener("change", (event) => {
+  logsPaused = /** @type {HTMLInputElement} */ (event.target).checked;
+});
+
+$("logs-clear")?.addEventListener("click", () => {
+  logBuffer = [];
+  renderLogs();
 });
 
 /* -------------------------------------------------------------------- dil */
@@ -905,11 +1224,19 @@ $("language").append(
     if (latest) render();
     renderCloudflare();
     renderReport();
+    renderRoutes();
+    renderViews();
+    renderLogs();
   }),
 );
 
 applyTranslations();
 
+const params = new URLSearchParams(location.search);
+if (params.get("path")) $("logs-path").value = params.get("path") ?? "";
+if (params.get("route")) $("logs-path").value = params.get("route") ?? "";
+
+showPage(pageFromLocation(), { push: false });
 void load();
 void loadCloudflare();
 startPolling();

package/src/config/defaults.js

@@ -192,27 +192,36 @@ export const DEFAULT_REDIS = {
 };
 
 /**
- * Önbellek yönetim paneli.
+ * Framework yönetim paneli (`/_jskelet/admin`).
  *
  * `enabled` varsayılan olarak **kapalı** ve ortama bakmaz: panel açıldığında
  * production'da da çalışır, ama açılması bilinçli bir karar olmalı. Kapalıyken
  * router hiç mount edilmez — yolun kendisi de yok, yani 404 dönen bir uç bile
  * ortaya çıkmaz.
  *
- * Şifre her süreç başlangıcında yeniden üretilir (bkz.
- * `src/server/cache-panel.js`): panelin ömrü sürecin ömrü kadardır ve bir
- * deploy eski erişimi otomatik olarak iptal eder. Bu yüzden config'te şifre
- * alanı yok.
+ * Şifre her süreç başlangıcında yeniden üretilir (bkz. `src/server/admin/`):
+ * panelin ömrü sürecin ömrü kadardır ve bir deploy eski erişimi otomatik
+ * olarak iptal eder. Bu yüzden config'te şifre alanı yok.
  */
-export const DEFAULT_CACHE_PANEL = {
+export const DEFAULT_ADMIN = {
   enabled: false,
-  basePath: "/_jskelet/cache",
+  basePath: "/_jskelet/admin",
+  /**
+   * Boş dizi = IP kısıtı yok. Exact IP veya CIDR (`10.0.0.0/8`); listede
+   * olmayan her istek 404 (login dahil).
+   * @type {string[]}
+   */
+  allowIps: [],
+  /** Bilinen crawler / bot UA'ları 404 ile reddedilsin mi. */
+  blockBots: true,
   /** Kaç başarısız denemeden sonra IP yasaklanır. */
   banAttempts: 3,
   /** Yasağın süresi. */
   banHours: 24,
   /** Oturumun ömrü; süreç yeniden başladığında zaten sıfırlanır. */
   sessionHours: 12,
+  /** Canlı log ring boyutu (HTTP + framework olayları). */
+  logSize: 500,
 };
 
 /**

package/src/config/index.js

@@ -17,8 +17,8 @@
  *   rewrites()  → [{ source, destination }] | { beforeFiles?, afterFiles? }
  *   cache()     → { html?: { [source]: saniye },
  *                   query?: { [source]: string[] | true }, maxEntries?: number,
- *                   data?: {...}, redis?: {...}, prewarm?: {...},
- *                   panel?: {...} }
+ *                   data?: {...}, redis?: {...}, prewarm?: {...} }
+ *   admin()     → { enabled?, basePath?, allowIps?, blockBots?, … }
  *
  * Fonksiyon olmayan bölümler (`brand`, `security`, `static`, `navigation`…)
  * düz nesne olarak okunur.
@@ -29,8 +29,8 @@ import process from "node:process";
 import { pathToFileURL } from "node:url";
 import { compilePattern, matchPattern } from "./pattern.js";
 import {
+  DEFAULT_ADMIN,
   DEFAULT_BRAND,
-  DEFAULT_CACHE_PANEL,
   DEFAULT_CLOUDFLARE,
   DEFAULT_DATA_CACHE,
   DEFAULT_DEV_GATE_BYPASS,
@@ -96,7 +96,7 @@ const CONFIG_FILE = "jskelet.config.mjs";
  * @property {{ attempts: number, delayMs: number }} transientRetry
  * @property {RedisConfig} redis Opsiyonel Redis ikinci kademesi.
  * @property {typeof DEFAULT_UPSTREAM_LIMIT} upstream Upstream hız freni.
- * @property {typeof DEFAULT_CACHE_PANEL} cachePanel Önbellek yönetim paneli.
+ * @property {typeof DEFAULT_ADMIN} admin Framework yönetim paneli.
  * @property {typeof DEFAULT_CLOUDFLARE} cloudflare Cloudflare cache yüzeyi.
  * @property {Record<string, unknown>} prewarm
  * @property {{ source: string, test: (pathname: string) => boolean }[]} prewarmPriority
@@ -104,6 +104,7 @@ const CONFIG_FILE = "jskelet.config.mjs";
  * @property {Record<string, Function>} hooks
  * @property {string} layout Layout `.ejs` dosyasının mutlak yolu.
  * @property {string[] | null} routes Açık route modülü listesi.
+ * @property {boolean} trailingSlash URL'ler `/` ile bitsin mi (Next `trailingSlash`).
  * @property {{ extensions: Set<string>, prefixes: string[] }} static
  * @property {string[]} devGateBypass
  * @property {string[]} preconnect
@@ -301,46 +302,58 @@ function normalizeUpstream(raw) {
 }
 
 /**
- * Önbellek panelinin bölümü.
- *
- * `enabled` yalnızca açıkça `true` verildiğinde ya da `JSKELET_CACHE_PANEL`
- * ortam değişkeni ayarlandığında açılır: paneli yanlışlıkla açmanın bedeli,
- * önbelleği boşaltabilen bir ucu internete koymak.
+ * Yönetim paneli. `enabled` yalnızca açıkça `true` verildiğinde ya da
+ * `JSKELET_ADMIN` ortam değişkeni ayarlandığında açılır: paneli yanlışlıkla
+ * açmanın bedeli, önbelleği boşaltabilen bir ucu internete koymak.
  *
  * Ortam değişkeni config'in **üstünde** duruyor, çünkü paneli genelde bir
  * arıza sırasında tek seferlik açmak isteniyor ve o an config dosyasını
- * değiştirip yeniden dağıtmak istenmiyor. `JSKELET_CACHE_PANEL=0` aynı
- * mantıkla config'te açık olan paneli kapatır.
+ * değiştirip yeniden dağıtmak istenmiyor. `JSKELET_ADMIN=0` aynı mantıkla
+ * config'te açık olan paneli kapatır.
  *
  * @param {unknown} raw
- * @returns {typeof DEFAULT_CACHE_PANEL}
+ * @returns {typeof DEFAULT_ADMIN}
  */
-function normalizeCachePanel(raw) {
+function normalizeAdmin(raw) {
   const source = /** @type {Record<string, any>} */ (raw ?? {});
-  const env = process.env.JSKELET_CACHE_PANEL;
+  const env = process.env.JSKELET_ADMIN;
 
   const basePath =
     typeof source.basePath === "string" && source.basePath.startsWith("/")
       ? source.basePath.replace(/\/+$/, "")
-      : DEFAULT_CACHE_PANEL.basePath;
+      : DEFAULT_ADMIN.basePath;
 
   /** @param {string} key @param {number} min */
   const positive = (key, min) => {
     const value = Number(source[key]);
     return Number.isFinite(value) && value >= min
       ? value
-      : /** @type {any} */ (DEFAULT_CACHE_PANEL)[key];
+      : /** @type {any} */ (DEFAULT_ADMIN)[key];
   };
 
+  const allowIps = Array.isArray(source.allowIps)
+    ? source.allowIps
+        .filter((entry) => typeof entry === "string" && entry.trim())
+        .map((entry) => entry.trim())
+    : [...DEFAULT_ADMIN.allowIps];
+
+  const logSize = Number(source.logSize);
+
   return {
     enabled:
       env === undefined
         ? source.enabled === true
         : env !== "0" && env !== "false" && env !== "",
-    basePath: basePath || DEFAULT_CACHE_PANEL.basePath,
+    basePath: basePath || DEFAULT_ADMIN.basePath,
+    allowIps,
+    blockBots: source.blockBots !== false,
     banAttempts: Math.floor(positive("banAttempts", 1)),
     banHours: positive("banHours", 0),
     sessionHours: positive("sessionHours", 0),
+    logSize:
+      Number.isFinite(logSize) && logSize >= 50
+        ? Math.min(5000, Math.floor(logSize))
+        : DEFAULT_ADMIN.logSize,
   };
 }
 
@@ -423,7 +436,6 @@ function normalizeQueryRules(raw) {
  *   transientRetry: { attempts: number, delayMs: number },
  *   redis: RedisConfig,
  *   upstream: typeof DEFAULT_UPSTREAM_LIMIT,
- *   cachePanel: typeof DEFAULT_CACHE_PANEL,
  *   cloudflare: typeof DEFAULT_CLOUDFLARE,
  *   prewarm: Record<string, unknown>,
  *   prewarmPriority: ResolvedConfig["prewarmPriority"] }}
@@ -464,7 +476,6 @@ function normalizeCache(raw) {
         : { ...DEFAULT_TRANSIENT_RETRY, ...(raw?.transientRetry ?? {}) },
     redis: normalizeRedis(raw?.redis),
     upstream: normalizeUpstream(raw?.upstream),
-    cachePanel: normalizeCachePanel(raw?.panel),
     cloudflare: normalizeCloudflare(raw?.cloudflare),
     // Desenler derlenmiş hâlde ayrı alanda tutulur: `prewarm` sayısal
     // ayarların düz torbası olarak kalsın, her turda yeniden derlenmesin.
@@ -669,11 +680,12 @@ export async function loadConfig(options = {}) {
     }
   };
 
-  const [headers, redirects, rewrites, cache] = await Promise.all([
+  const [headers, redirects, rewrites, cache, admin] = await Promise.all([
     section("headers"),
     section("redirects"),
     section("rewrites"),
     section("cache"),
+    section("admin"),
   ]);
 
   const {
@@ -686,7 +698,6 @@ export async function loadConfig(options = {}) {
     transientRetry,
     redis,
     upstream,
-    cachePanel,
     cloudflare,
     prewarm,
     prewarmPriority,
@@ -710,7 +721,7 @@ export async function loadConfig(options = {}) {
     transientRetry,
     redis,
     upstream,
-    cachePanel,
+    admin: normalizeAdmin(admin),
     cloudflare,
     prewarm,
     prewarmPriority,
@@ -718,6 +729,11 @@ export async function loadConfig(options = {}) {
     hooks: source.hooks ?? {},
     layout: resolveLayout(dirs, source.layout),
     routes: Array.isArray(source.routes) ? source.routes : null,
+    // Varsayılan kapalı: açıkken `/hakkinda` → 308 `/hakkinda/` ve kanonik
+    // yanıt 200'dir. Kapalıyken slash dayatılmaz — Express'in non-strict
+    // eşleşmesi her iki biçimi de 200 ile servis eder (Next'in varsayılan
+    // "slash'ı kırp" davranışından bilinçli fark).
+    trailingSlash: source.trailingSlash === true,
     static: {
       extensions: new Set(source.static?.extensions ?? DEFAULT_STATIC.extensions),
       prefixes: source.static?.prefixes ?? DEFAULT_STATIC.prefixes,

package/src/log.mjs

@@ -253,6 +253,14 @@ export function event({ symbol = symbols.ok, scope, message, note, time = null }
     `${message}${note ? `  ${c.dim(note)}` : ""}${padding}` +
     `${c.gray((time == null ? "" : ms(time)).padStart(TIME))}\n`,
   );
+
+  emitLog({
+    kind: "event",
+    scope,
+    message,
+    note: note ?? null,
+    ms: time ?? null,
+  });
 }
 
 /**
@@ -271,6 +279,15 @@ export function http(info) {
     `${tint(String(info.status))} ${c.gray(ms(info.ms).padStart(TIME))}` +
     `${info.cache === "HIT" ? ` ${c.dim("cached")}` : ""}\n`,
   );
+
+  emitLog({
+    kind: "http",
+    method: info.method,
+    url: info.url,
+    status: info.status,
+    ms: info.ms,
+    cache: info.cache ?? null,
+  });
 }
 
 /**
@@ -337,6 +354,14 @@ export function errorBox({ title, name, message, lines = [] }) {
   }
   line("");
   write(`${c.red(bottom)}\n\n`);
+
+  emitLog({
+    kind: "error",
+    scope: title,
+    message: `${name}: ${message}`,
+    note: lines.length ? lines.join(" · ") : null,
+    ms: null,
+  });
 }
 
 /**
@@ -361,3 +386,36 @@ function wrap(text, max) {
   if (current) out.push(current);
   return out.length ? out : [""];
 }
+
+/* -------------------------------------------------------------- aboneler */
+
+/**
+ * Admin paneli gibi dinleyiciler. Abone yokken `emitLog` boş Set üzerinde
+ * döner — stdout yoluna maliyet eklemez.
+ *
+ * @type {Set<(entry: Record<string, unknown>) => void>}
+ */
+const listeners = new Set();
+
+/**
+ * @param {(entry: Record<string, unknown>) => void} listener
+ * @returns {() => void} Aboneliği iptal eden fonksiyon.
+ */
+export function subscribe(listener) {
+  listeners.add(listener);
+  return () => listeners.delete(listener);
+}
+
+/**
+ * @param {Record<string, unknown>} entry
+ */
+function emitLog(entry) {
+  if (!listeners.size) return;
+  for (const listener of listeners) {
+    try {
+      listener(entry);
+    } catch {
+      // Dinleyici paneli düşürmesin.
+    }
+  }
+}