jskelet 0.6.1 → 0.6.3

package/src/compile/resolve.js

@@ -1,211 +1,211 @@
-/**
- * View kökleri ve `.jsk` dosya keşfi.
- *
- * Sıra: views, sonra shared/views, sonra her feature altındaki views.
- * Aynı view id birden fazla kökte varsa son bulunan kazanır.
- */
-import fs from "node:fs";
-import path from "node:path";
-import { toPascalCase } from "./codegen.js";
-import { CompileError } from "./errors.js";
-import { scanNamedExports } from "./scan-exports.js";
-
-/**
- * Runtime'ın camelCase → PascalCase alias'ı ile aynı kural.
- * @param {string} name
- * @returns {string}
- */
-export function toComponentTag(name) {
-  return name.charAt(0).toUpperCase() + name.slice(1);
-}
-
-/**
- * @param {{ root: string, dirs: Record<string, string> }} config
- * @returns {string[]} Mutlak view kökleri (var olanlar).
- */
-export function getViewRoots(config) {
-  /** @type {string[]} */
-  const roots = [];
-  const { dirs, root } = config;
-
-  if (dirs.views && fs.existsSync(dirs.views)) {
-    roots.push(dirs.views);
-  }
-
-  const sharedViews = dirs.shared
-    ? path.join(dirs.shared, "views")
-    : path.join(root, "shared", "views");
-  if (fs.existsSync(sharedViews)) roots.push(sharedViews);
-
-  const featuresDir = dirs.features ?? path.join(root, "features");
-  if (fs.existsSync(featuresDir)) {
-    const features = fs
-      .readdirSync(featuresDir, { withFileTypes: true })
-      .filter((e) => e.isDirectory())
-      .map((e) => e.name)
-      .sort((a, b) => a.localeCompare(b));
-
-    for (const name of features) {
-      const views = path.join(featuresDir, name, "views");
-      if (fs.existsSync(views)) roots.push(views);
-    }
-  }
-
-  return roots;
-}
-
-/**
- * Bileşen dizinleri: her view kökü altındaki `components/`.
- * @param {{ root: string, dirs: Record<string, string> }} config
- * @returns {string[]}
- */
-export function getComponentDirs(config) {
-  return getViewRoots(config)
-    .map((root) => path.join(root, "components"))
-    .filter((dir) => fs.existsSync(dir));
-}
-
-/**
- * @param {string[]} viewRoots
- * @returns {Map<string, string>} viewId → mutlak `.jsk` yolu
- */
-export function discoverJskFiles(viewRoots) {
-  /** @type {Map<string, string>} */
-  const map = new Map();
-
-  for (const root of viewRoots) {
-    collectJsk(root, root, map);
-  }
-
-  return map;
-}
-
-/**
- * @param {string} dir
- * @param {string} root
- * @param {Map<string, string>} out
- */
-function collectJsk(dir, root, out) {
-  if (!fs.existsSync(dir)) return;
-
-  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-    const full = path.join(dir, entry.name);
-    if (entry.isDirectory()) {
-      collectJsk(full, root, out);
-      continue;
-    }
-    if (!entry.name.endsWith(".jsk")) continue;
-    const rel = path.relative(root, full).split(path.sep).join("/");
-    const viewId = rel.replace(/\.jsk$/i, "");
-    out.set(viewId, full);
-  }
-}
-
-/**
- * `components/foo-bar.jsk` → `FooBar`
- * @param {string} viewId
- * @returns {string | null}
- */
-export function componentNameFromViewId(viewId) {
-  const parts = viewId.split("/");
-  if (parts[0] !== "components" || parts.length < 2) return null;
-  const base = parts[parts.length - 1];
-  return toPascalCase(base);
-}
-
-/**
- * Bilinen bileşen adları: JS named export'lar + derlenecek `.jsk` bileşenleri
- * + yerleşik etiketler.
- *
- * JS tarafında dosya adı varsayılmaz; kaynak metinden `export` adları okunur.
- * Aynı export (veya aynı PascalCase etiket) iki dosyada varsa derleme hatası.
- *
- * @param {string[]} componentDirs
- * @param {Map<string, string>} jskFiles
- * @returns {Set<string>}
- */
-export function collectKnownComponents(componentDirs, jskFiles) {
-  const known = new Set([
-    "Link",
-    "Image",
-    "Icon",
-    "CsrfField",
-    "PreloadImage",
-    "Stylesheets",
-    "BodyScripts",
-    "JsonLd",
-  ]);
-
-  /** @type {Map<string, string>} export adı → göreli yol */
-  const byName = new Map();
-  /** @type {Map<string, string>} PascalCase etiket → göreli yol */
-  const byTag = new Map();
-
-  for (const [viewId] of jskFiles) {
-    const name = componentNameFromViewId(viewId);
-    if (!name) continue;
-    known.add(name);
-    byTag.set(name, `${viewId}.jsk`);
-  }
-
-  for (const dir of componentDirs) {
-    collectJsComponentNames(dir, known, byName, byTag);
-  }
-
-  return known;
-}
-
-/**
- * @param {string} name
- * @param {string} origin
- * @param {Map<string, string>} byName
- * @param {Map<string, string>} byTag
- */
-function registerExportOrigin(name, origin, byName, byTag) {
-  const previousName = byName.get(name);
-  if (previousName && previousName !== origin) {
-    throw new CompileError(
-      `Component '${name}' is defined twice: ${previousName} and ${origin}`,
-    );
-  }
-  byName.set(name, origin);
-
-  const tag = toComponentTag(name);
-  const previousTag = byTag.get(tag);
-  if (previousTag && previousTag !== origin) {
-    throw new CompileError(
-      `Component '${tag}' is defined twice: ${previousTag} and ${origin}`,
-    );
-  }
-  byTag.set(tag, origin);
-}
-
-/**
- * @param {string} dir
- * @param {Set<string>} out
- * @param {Map<string, string>} byName
- * @param {Map<string, string>} byTag
- */
-function collectJsComponentNames(dir, out, byName, byTag) {
-  if (!fs.existsSync(dir)) return;
-  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-    const full = path.join(dir, entry.name);
-    if (entry.isDirectory()) {
-      collectJsComponentNames(full, out, byName, byTag);
-      continue;
-    }
-    if (!entry.name.endsWith(".js")) continue;
-    if (entry.name === "loader.js" || entry.name === "index.js") continue;
-
-    // Kimlik mutlak yol: çoklu kökte iki `list.js` aynı göreli ada sahip olabilir.
-    const origin = full.split(path.sep).join("/");
-    const source = fs.readFileSync(full, "utf8");
-    const exports = scanNamedExports(source);
-
-    for (const name of exports) {
-      registerExportOrigin(name, origin, byName, byTag);
-      out.add(name);
-      out.add(toComponentTag(name));
-    }
-  }
-}
+/**
+ * View kökleri ve `.jsk` dosya keşfi.
+ *
+ * Sıra: views, sonra shared/views, sonra her feature altındaki views.
+ * Aynı view id birden fazla kökte varsa son bulunan kazanır.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { toPascalCase } from "./codegen.js";
+import { CompileError } from "./errors.js";
+import { scanNamedExports } from "./scan-exports.js";
+
+/**
+ * Runtime'ın camelCase → PascalCase alias'ı ile aynı kural.
+ * @param {string} name
+ * @returns {string}
+ */
+export function toComponentTag(name) {
+  return name.charAt(0).toUpperCase() + name.slice(1);
+}
+
+/**
+ * @param {{ root: string, dirs: Record<string, string> }} config
+ * @returns {string[]} Mutlak view kökleri (var olanlar).
+ */
+export function getViewRoots(config) {
+  /** @type {string[]} */
+  const roots = [];
+  const { dirs, root } = config;
+
+  if (dirs.views && fs.existsSync(dirs.views)) {
+    roots.push(dirs.views);
+  }
+
+  const sharedViews = dirs.shared
+    ? path.join(dirs.shared, "views")
+    : path.join(root, "shared", "views");
+  if (fs.existsSync(sharedViews)) roots.push(sharedViews);
+
+  const featuresDir = dirs.features ?? path.join(root, "features");
+  if (fs.existsSync(featuresDir)) {
+    const features = fs
+      .readdirSync(featuresDir, { withFileTypes: true })
+      .filter((e) => e.isDirectory())
+      .map((e) => e.name)
+      .sort((a, b) => a.localeCompare(b));
+
+    for (const name of features) {
+      const views = path.join(featuresDir, name, "views");
+      if (fs.existsSync(views)) roots.push(views);
+    }
+  }
+
+  return roots;
+}
+
+/**
+ * Bileşen dizinleri: her view kökü altındaki `components/`.
+ * @param {{ root: string, dirs: Record<string, string> }} config
+ * @returns {string[]}
+ */
+export function getComponentDirs(config) {
+  return getViewRoots(config)
+    .map((root) => path.join(root, "components"))
+    .filter((dir) => fs.existsSync(dir));
+}
+
+/**
+ * @param {string[]} viewRoots
+ * @returns {Map<string, string>} viewId → mutlak `.jsk` yolu
+ */
+export function discoverJskFiles(viewRoots) {
+  /** @type {Map<string, string>} */
+  const map = new Map();
+
+  for (const root of viewRoots) {
+    collectJsk(root, root, map);
+  }
+
+  return map;
+}
+
+/**
+ * @param {string} dir
+ * @param {string} root
+ * @param {Map<string, string>} out
+ */
+function collectJsk(dir, root, out) {
+  if (!fs.existsSync(dir)) return;
+
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      collectJsk(full, root, out);
+      continue;
+    }
+    if (!entry.name.endsWith(".jsk")) continue;
+    const rel = path.relative(root, full).split(path.sep).join("/");
+    const viewId = rel.replace(/\.jsk$/i, "");
+    out.set(viewId, full);
+  }
+}
+
+/**
+ * `components/foo-bar.jsk` → `FooBar`
+ * @param {string} viewId
+ * @returns {string | null}
+ */
+export function componentNameFromViewId(viewId) {
+  const parts = viewId.split("/");
+  if (parts[0] !== "components" || parts.length < 2) return null;
+  const base = parts[parts.length - 1];
+  return toPascalCase(base);
+}
+
+/**
+ * Bilinen bileşen adları: JS named export'lar + derlenecek `.jsk` bileşenleri
+ * + yerleşik etiketler.
+ *
+ * JS tarafında dosya adı varsayılmaz; kaynak metinden `export` adları okunur.
+ * Aynı export (veya aynı PascalCase etiket) iki dosyada varsa derleme hatası.
+ *
+ * @param {string[]} componentDirs
+ * @param {Map<string, string>} jskFiles
+ * @returns {Set<string>}
+ */
+export function collectKnownComponents(componentDirs, jskFiles) {
+  const known = new Set([
+    "Link",
+    "Image",
+    "Icon",
+    "CsrfField",
+    "PreloadImage",
+    "Stylesheets",
+    "BodyScripts",
+    "JsonLd",
+  ]);
+
+  /** @type {Map<string, string>} export adı → göreli yol */
+  const byName = new Map();
+  /** @type {Map<string, string>} PascalCase etiket → göreli yol */
+  const byTag = new Map();
+
+  for (const [viewId] of jskFiles) {
+    const name = componentNameFromViewId(viewId);
+    if (!name) continue;
+    known.add(name);
+    byTag.set(name, `${viewId}.jsk`);
+  }
+
+  for (const dir of componentDirs) {
+    collectJsComponentNames(dir, known, byName, byTag);
+  }
+
+  return known;
+}
+
+/**
+ * @param {string} name
+ * @param {string} origin
+ * @param {Map<string, string>} byName
+ * @param {Map<string, string>} byTag
+ */
+function registerExportOrigin(name, origin, byName, byTag) {
+  const previousName = byName.get(name);
+  if (previousName && previousName !== origin) {
+    throw new CompileError(
+      `Component '${name}' is defined twice: ${previousName} and ${origin}`,
+    );
+  }
+  byName.set(name, origin);
+
+  const tag = toComponentTag(name);
+  const previousTag = byTag.get(tag);
+  if (previousTag && previousTag !== origin) {
+    throw new CompileError(
+      `Component '${tag}' is defined twice: ${previousTag} and ${origin}`,
+    );
+  }
+  byTag.set(tag, origin);
+}
+
+/**
+ * @param {string} dir
+ * @param {Set<string>} out
+ * @param {Map<string, string>} byName
+ * @param {Map<string, string>} byTag
+ */
+function collectJsComponentNames(dir, out, byName, byTag) {
+  if (!fs.existsSync(dir)) return;
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      collectJsComponentNames(full, out, byName, byTag);
+      continue;
+    }
+    if (!entry.name.endsWith(".js")) continue;
+    if (entry.name === "loader.js" || entry.name === "index.js") continue;
+
+    // Kimlik mutlak yol: çoklu kökte iki `list.js` aynı göreli ada sahip olabilir.
+    const origin = full.split(path.sep).join("/");
+    const source = fs.readFileSync(full, "utf8");
+    const exports = scanNamedExports(source);
+
+    for (const name of exports) {
+      registerExportOrigin(name, origin, byName, byTag);
+      out.add(name);
+      out.add(toComponentTag(name));
+    }
+  }
+}

package/src/compile/scan-exports.js

@@ -1,51 +1,51 @@
-/**
- * Kaynak metinden named export adlarını çıkarır — modülü çalıştırmadan.
- * Compile-time bilinen bileşen listesi için; `default` yok sayılır.
- */
-
-/**
- * Yorumları kaba şekilde siler; string içindeki sahte eşleşmeler nadirdir.
- * @param {string} source
- * @returns {string}
- */
-function stripComments(source) {
-  return source.replace(/\/\*[\s\S]*?\*\//g, "").replace(/\/\/.*$/gm, "");
-}
-
-/**
- * `export { a, b as C, default as X }` listesinden dışa verilen adları toplar.
- * @param {string} clause
- * @param {Set<string>} out
- */
-function addExportList(clause, out) {
-  for (const part of clause.split(",")) {
-    const trimmed = part.trim();
-    if (!trimmed) continue;
-    const bits = trimmed.split(/\s+as\s+/i);
-    const exported = (bits[1] ?? bits[0]).trim();
-    if (!exported || exported === "default") continue;
-    out.add(exported);
-  }
-}
-
-/**
- * @param {string} source
- * @returns {string[]}
- */
-export function scanNamedExports(source) {
-  const text = stripComments(source);
-  /** @type {Set<string>} */
-  const names = new Set();
-
-  for (const match of text.matchAll(
-    /\bexport\s+(?:async\s+)?(?:function\*?|class|const|let|var)\s+([A-Za-z_$][\w$]*)/g,
-  )) {
-    names.add(match[1]);
-  }
-
-  for (const match of text.matchAll(/\bexport\s*\{([^}]+)\}/g)) {
-    addExportList(match[1], names);
-  }
-
-  return [...names];
-}
+/**
+ * Kaynak metinden named export adlarını çıkarır — modülü çalıştırmadan.
+ * Compile-time bilinen bileşen listesi için; `default` yok sayılır.
+ */
+
+/**
+ * Yorumları kaba şekilde siler; string içindeki sahte eşleşmeler nadirdir.
+ * @param {string} source
+ * @returns {string}
+ */
+function stripComments(source) {
+  return source.replace(/\/\*[\s\S]*?\*\//g, "").replace(/\/\/.*$/gm, "");
+}
+
+/**
+ * `export { a, b as C, default as X }` listesinden dışa verilen adları toplar.
+ * @param {string} clause
+ * @param {Set<string>} out
+ */
+function addExportList(clause, out) {
+  for (const part of clause.split(",")) {
+    const trimmed = part.trim();
+    if (!trimmed) continue;
+    const bits = trimmed.split(/\s+as\s+/i);
+    const exported = (bits[1] ?? bits[0]).trim();
+    if (!exported || exported === "default") continue;
+    out.add(exported);
+  }
+}
+
+/**
+ * @param {string} source
+ * @returns {string[]}
+ */
+export function scanNamedExports(source) {
+  const text = stripComments(source);
+  /** @type {Set<string>} */
+  const names = new Set();
+
+  for (const match of text.matchAll(
+    /\bexport\s+(?:async\s+)?(?:function\*?|class|const|let|var)\s+([A-Za-z_$][\w$]*)/g,
+  )) {
+    names.add(match[1]);
+  }
+
+  for (const match of text.matchAll(/\bexport\s*\{([^}]+)\}/g)) {
+    addExportList(match[1], names);
+  }
+
+  return [...names];
+}

package/src/config/defaults.js

@@ -169,6 +169,19 @@ export const HTML_CACHE_MAX_ENTRIES_CEILING = 800;
  */
 export const HTML_CACHE_BYTE_BUDGET = 256 * 1024 * 1024;
 
+/**
+ * Süreç içi veri önbelleğinin JSON bayt tavanı (64 MB). Sayı tavanı
+ * şişman gövdeleri tutmaz; config yükseltemez. Tek değer bütçeden büyükse
+ * saklanmaz, çağıran sonucu yine alır.
+ */
+export const DATA_CACHE_BYTE_BUDGET = 64 * 1024 * 1024;
+
+/**
+ * Uzak görsel disk önbelleğinin tavanı (256 MB). `.jskelet/image-cache/`
+ * bu boyutu aşınca en eski dosya düşer. Config yükseltemez.
+ */
+export const IMAGE_CACHE_BYTE_BUDGET = 256 * 1024 * 1024;
+
 /** `cache().data.maxEntries` için sert tavan. Uzun kuyruk burada durur, HTML'de değil. */
 export const DATA_CACHE_MAX_ENTRIES_CEILING = 20_000;
 
@@ -297,7 +310,10 @@ export const DEFAULT_LOGS = {
     enabled: false,
     /** Proje köküne göre relative. */
     dir: "logs",
-    /** Yalnızca günlük rotasyon. */
+    /**
+     * Artık kullanılmıyor. Parçalar en fazla 5 dakika durur; alan çözülen
+     * config'te durur ki eski okuyucular kırılmasın.
+     */
     rotate: /** @type {"daily"} */ ("daily"),
   },
   s3: {

package/src/config/index.js

@@ -97,6 +97,10 @@ const CONFIG_FILE = "jskelet.config.mjs";
  *   basılsın mı (banner/build satırları etkilenmez).
  * @property {LogKind[]} kinds Sink'lere giden kayıt türleri.
  * @property {{ enabled: boolean, dir: string, rotate: "daily" }} file
+ *   `rotate` durur; dosya parçaları en fazla 5 dakika tutulur.
+ * @property {import('../server/logs/file-sink.js').DrainLog | null} drainLog
+ *   Mühürlenen zstd parçasını uygulamanın seçtiği yere aktarır. Hata
+ *   siteyi düşürmez.
  * @property {{ enabled: boolean, bucket: string | null, prefix: string,
  *   region: string | null, endpoint: string | null, flushIntervalMs: number,
  *   maxBatch: number }} s3
@@ -578,6 +582,14 @@ export function normalizeLogs(raw) {
     envText(process.env.JSKELET_S3_REGION) ??
     "auto";
 
+  /** @type {import('../server/logs/file-sink.js').DrainLog | null} */
+  let drainLog = null;
+  if (typeof source.drainLog === "function") {
+    drainLog = source.drainLog;
+  } else if (source.drainLog != null) {
+    console.warn("[config] logs.drainLog must be a function, ignoring it");
+  }
+
   const credentials = readS3CredentialsFromEnv();
   // `JSKELET_LOG_BUCKET` (veya S3 bucket) + credential varsa config'te
   // `enabled: true` unutulmuş olsa bile aç. Açık `enabled: false` ezer.
@@ -603,6 +615,7 @@ export function normalizeLogs(raw) {
           : DEFAULT_LOGS.file.dir,
       rotate: "daily",
     },
+    drainLog,
     s3: {
       enabled,
       bucket: bucketPath.bucket,