jskelet 0.6.2 → 0.6.3

package/src/build/paths.mjs

@@ -1,153 +1,153 @@
-/**
- * Build çıktısı yolları ve hash'li varlık yazımı.
- *
- * Yollar `jskelet.config.mjs`'den gelir; `initBuildPaths()` çağrılmadan
- * kullanılamazlar. Tek bir mutasyon noktası olması bilinçli: framework
- * `node_modules/` içine girdiğinde `../..` sayarak kök bulmaya çalışan her
- * dosya bozulur.
- */
-import fs from "node:fs";
-import path from "node:path";
-import crypto from "node:crypto";
-
-/**
- * @type {{ root: string, generated: string, public: string, assets: string,
- *   fonts: string, client: string, views: string, routes: string, styles: string }}
- */
-export const paths = {
-  root: "",
-  generated: "",
-  public: "",
-  assets: "",
-  fonts: "",
-  client: "",
-  views: "",
-  routes: "",
-  styles: "",
-};
-
-/**
- * @param {import('../config/index.js').ResolvedConfig} config
- * @returns {void}
- */
-export function initBuildPaths(config) {
-  Object.assign(paths, config.dirs, { root: config.root });
-
-  fs.mkdirSync(paths.generated, { recursive: true });
-  fs.mkdirSync(paths.assets, { recursive: true });
-}
-
-/**
- * İçeriğe göre kısa hash. 10 hex karakter çakışma için fazlasıyla yeterli ve
- * dosya adlarını okunur tutuyor.
- *
- * @param {string | Buffer} content
- * @returns {string}
- */
-export function hash(content) {
-  return crypto.createHash("sha256").update(content).digest("hex").slice(0, 10);
-}
-
-/**
- * Hash'li dosyayı `public/assets` altına yazar ve public yolunu döner.
- *
- * @param {string} name Örn. "app.css"
- * @param {string | Buffer} content
- * @returns {string}
- */
-export function writeAsset(name, content) {
-  const ext = path.extname(name);
-  const base = name.slice(0, name.length - ext.length);
-  const fileName = `${base}.${hash(content)}${ext}`;
-
-  fs.mkdirSync(paths.assets, { recursive: true });
-  fs.writeFileSync(path.join(paths.assets, fileName), content);
-
-  return `/assets/${fileName}`;
-}
-
-/** @returns {string} */
-function manifestFile() {
-  return path.join(paths.generated, "manifest.json");
-}
-
-/** @param {Record<string, string>} manifest */
-export function writeManifest(manifest) {
-  fs.mkdirSync(paths.generated, { recursive: true });
-  const json = `${JSON.stringify(manifest, null, 2)}\n`;
-  fs.writeFileSync(manifestFile(), json);
-  writeBuildId(json);
-}
-
-/**
- * Build kimliği: manifest içeriğinin hash'i.
- *
- * Paylaşımlı bir önbellekte (Redis) HTML anahtarları bu kimliği taşımak
- * zorunda. Saklanan HTML hash'li varlık yollarını gömüyor; yeni bir deploy'dan
- * sonra eski HTML başka bir node'dan geri gelirse artık var olmayan
- * `/assets/app.<eskihash>.css` istenir ve sayfa stilsiz kalır. Kimlik önekte
- * durduğunda yeni build kendiliğinden yeni bir isim alanına yazar, eskisi TTL
- * ile ölür — elle temizlik gerekmez.
- *
- * Kimlik manifest'in **içine** yazılmaz: oradaki her anahtar `asset()`
- * yüzeyine sızıyor.
- *
- * @param {string} manifestJson
- */
-function writeBuildId(manifestJson) {
-  const payload = { id: hash(manifestJson), createdAt: new Date().toISOString() };
-  fs.writeFileSync(
-    path.join(paths.generated, "build.json"),
-    `${JSON.stringify(payload, null, 2)}\n`,
-  );
-}
-
-/**
- * Tek bir girdiyi günceller, diğerlerini korur.
- *
- * Watch modunda yeniden derlenen varlık yeni bir hash'e yazılıp eskisi
- * silindiği için manifest de güncellenmek zorunda: aksi hâlde HTML silinmiş
- * dosyayı isteyip 404 alır ve sayfa dev oturumunun kalanında stilsiz/JS'siz
- * kalır.
- *
- * @param {string} key
- * @param {string} url
- */
-export function patchManifest(key, url) {
-  /** @type {Record<string, string>} */
-  let current = {};
-  try {
-    current = JSON.parse(fs.readFileSync(manifestFile(), "utf8"));
-  } catch {
-    // Manifest henüz yoksa ilk yazımda oluşur.
-  }
-
-  if (current[key] === url) return;
-
-  current[key] = url;
-  writeManifest(current);
-}
-
-/**
- * Eski hash'li çıktıları temizler.
- *
- * Yeni dosya **önce** yazılmalı, prune sonra gelmeli: aynı içerik aynı hash'i
- * üretir ve önce silmek `/assets/app.<hash>.css` için kısa bir 404 penceresi
- * açar. CDN o 404'ü `immutable` ile saklarsa (eski headersMiddleware
- * davranışı) tarayıcı bir yıl boyunca stilsiz kalır.
- *
- * @param {string[]} prefixes
- * @param {{ keep?: string[] }} [options] Korunacak dosya adları (ör. yeni
- *   yazılan `app.<hash>.css`); `.br` / `.gz` sonekleri de eşleşir.
- */
-export function pruneAssets(prefixes, { keep = [] } = {}) {
-  if (!fs.existsSync(paths.assets)) return;
-
-  for (const file of fs.readdirSync(paths.assets)) {
-    if (!prefixes.some((prefix) => file.startsWith(prefix))) continue;
-    if (keep.some((name) => file === name || file.startsWith(`${name}.`))) {
-      continue;
-    }
-    fs.rmSync(path.join(paths.assets, file), { force: true });
-  }
-}
+/**
+ * Build çıktısı yolları ve hash'li varlık yazımı.
+ *
+ * Yollar `jskelet.config.mjs`'den gelir; `initBuildPaths()` çağrılmadan
+ * kullanılamazlar. Tek bir mutasyon noktası olması bilinçli: framework
+ * `node_modules/` içine girdiğinde `../..` sayarak kök bulmaya çalışan her
+ * dosya bozulur.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import crypto from "node:crypto";
+
+/**
+ * @type {{ root: string, generated: string, public: string, assets: string,
+ *   fonts: string, client: string, views: string, routes: string, styles: string }}
+ */
+export const paths = {
+  root: "",
+  generated: "",
+  public: "",
+  assets: "",
+  fonts: "",
+  client: "",
+  views: "",
+  routes: "",
+  styles: "",
+};
+
+/**
+ * @param {import('../config/index.js').ResolvedConfig} config
+ * @returns {void}
+ */
+export function initBuildPaths(config) {
+  Object.assign(paths, config.dirs, { root: config.root });
+
+  fs.mkdirSync(paths.generated, { recursive: true });
+  fs.mkdirSync(paths.assets, { recursive: true });
+}
+
+/**
+ * İçeriğe göre kısa hash. 10 hex karakter çakışma için fazlasıyla yeterli ve
+ * dosya adlarını okunur tutuyor.
+ *
+ * @param {string | Buffer} content
+ * @returns {string}
+ */
+export function hash(content) {
+  return crypto.createHash("sha256").update(content).digest("hex").slice(0, 10);
+}
+
+/**
+ * Hash'li dosyayı `public/assets` altına yazar ve public yolunu döner.
+ *
+ * @param {string} name Örn. "app.css"
+ * @param {string | Buffer} content
+ * @returns {string}
+ */
+export function writeAsset(name, content) {
+  const ext = path.extname(name);
+  const base = name.slice(0, name.length - ext.length);
+  const fileName = `${base}.${hash(content)}${ext}`;
+
+  fs.mkdirSync(paths.assets, { recursive: true });
+  fs.writeFileSync(path.join(paths.assets, fileName), content);
+
+  return `/assets/${fileName}`;
+}
+
+/** @returns {string} */
+function manifestFile() {
+  return path.join(paths.generated, "manifest.json");
+}
+
+/** @param {Record<string, string>} manifest */
+export function writeManifest(manifest) {
+  fs.mkdirSync(paths.generated, { recursive: true });
+  const json = `${JSON.stringify(manifest, null, 2)}\n`;
+  fs.writeFileSync(manifestFile(), json);
+  writeBuildId(json);
+}
+
+/**
+ * Build kimliği: manifest içeriğinin hash'i.
+ *
+ * Paylaşımlı bir önbellekte (Redis) HTML anahtarları bu kimliği taşımak
+ * zorunda. Saklanan HTML hash'li varlık yollarını gömüyor; yeni bir deploy'dan
+ * sonra eski HTML başka bir node'dan geri gelirse artık var olmayan
+ * `/assets/app.<eskihash>.css` istenir ve sayfa stilsiz kalır. Kimlik önekte
+ * durduğunda yeni build kendiliğinden yeni bir isim alanına yazar, eskisi TTL
+ * ile ölür — elle temizlik gerekmez.
+ *
+ * Kimlik manifest'in **içine** yazılmaz: oradaki her anahtar `asset()`
+ * yüzeyine sızıyor.
+ *
+ * @param {string} manifestJson
+ */
+function writeBuildId(manifestJson) {
+  const payload = { id: hash(manifestJson), createdAt: new Date().toISOString() };
+  fs.writeFileSync(
+    path.join(paths.generated, "build.json"),
+    `${JSON.stringify(payload, null, 2)}\n`,
+  );
+}
+
+/**
+ * Tek bir girdiyi günceller, diğerlerini korur.
+ *
+ * Watch modunda yeniden derlenen varlık yeni bir hash'e yazılıp eskisi
+ * silindiği için manifest de güncellenmek zorunda: aksi hâlde HTML silinmiş
+ * dosyayı isteyip 404 alır ve sayfa dev oturumunun kalanında stilsiz/JS'siz
+ * kalır.
+ *
+ * @param {string} key
+ * @param {string} url
+ */
+export function patchManifest(key, url) {
+  /** @type {Record<string, string>} */
+  let current = {};
+  try {
+    current = JSON.parse(fs.readFileSync(manifestFile(), "utf8"));
+  } catch {
+    // Manifest henüz yoksa ilk yazımda oluşur.
+  }
+
+  if (current[key] === url) return;
+
+  current[key] = url;
+  writeManifest(current);
+}
+
+/**
+ * Eski hash'li çıktıları temizler.
+ *
+ * Yeni dosya **önce** yazılmalı, prune sonra gelmeli: aynı içerik aynı hash'i
+ * üretir ve önce silmek `/assets/app.<hash>.css` için kısa bir 404 penceresi
+ * açar. CDN o 404'ü `immutable` ile saklarsa (eski headersMiddleware
+ * davranışı) tarayıcı bir yıl boyunca stilsiz kalır.
+ *
+ * @param {string[]} prefixes
+ * @param {{ keep?: string[] }} [options] Korunacak dosya adları (ör. yeni
+ *   yazılan `app.<hash>.css`); `.br` / `.gz` sonekleri de eşleşir.
+ */
+export function pruneAssets(prefixes, { keep = [] } = {}) {
+  if (!fs.existsSync(paths.assets)) return;
+
+  for (const file of fs.readdirSync(paths.assets)) {
+    if (!prefixes.some((prefix) => file.startsWith(prefix))) continue;
+    if (keep.some((name) => file === name || file.startsWith(`${name}.`))) {
+      continue;
+    }
+    fs.rmSync(path.join(paths.assets, file), { force: true });
+  }
+}

package/src/build/resolve-peer.mjs

@@ -1,36 +1,36 @@
-/**
- * Opsiyonel peer bağımlılıklarını **uygulamanın** node_modules'ünden yükler.
- *
- * Framework `file:` ya da workspace bağlantısıyla kuruluysa kaynak dosyaları
- * kendi dizininde çalışır ve düz bir `import "postcss"` framework'ün
- * node_modules'üne bakar — uygulamanınkine değil. Tailwind/PostCSS/sharp gibi
- * paketler uygulamanın devDependency'si olduğu için çözümlemeyi uygulama
- * kökünden başlatmak zorundayız.
- */
-import path from "node:path";
-import { createRequire } from "node:module";
-import { pathToFileURL } from "node:url";
-
-/**
- * @param {string} root Uygulama kökü.
- * @param {string} specifier
- * @returns {Promise<any>}
- * @throws Paket bulunamazsa; zorunlu bağımlılıklar için.
- */
-export async function importFromApp(root, specifier) {
-  const require = createRequire(path.join(root, "package.json"));
-  return import(pathToFileURL(require.resolve(specifier)).href);
-}
-
-/**
- * @param {string} root
- * @param {string} specifier
- * @returns {Promise<any | null>} Paket yoksa `null`; adım atlanabilsin diye.
- */
-export async function tryImportFromApp(root, specifier) {
-  try {
-    return await importFromApp(root, specifier);
-  } catch {
-    return null;
-  }
-}
+/**
+ * Opsiyonel peer bağımlılıklarını **uygulamanın** node_modules'ünden yükler.
+ *
+ * Framework `file:` ya da workspace bağlantısıyla kuruluysa kaynak dosyaları
+ * kendi dizininde çalışır ve düz bir `import "postcss"` framework'ün
+ * node_modules'üne bakar — uygulamanınkine değil. Tailwind/PostCSS/sharp gibi
+ * paketler uygulamanın devDependency'si olduğu için çözümlemeyi uygulama
+ * kökünden başlatmak zorundayız.
+ */
+import path from "node:path";
+import { createRequire } from "node:module";
+import { pathToFileURL } from "node:url";
+
+/**
+ * @param {string} root Uygulama kökü.
+ * @param {string} specifier
+ * @returns {Promise<any>}
+ * @throws Paket bulunamazsa; zorunlu bağımlılıklar için.
+ */
+export async function importFromApp(root, specifier) {
+  const require = createRequire(path.join(root, "package.json"));
+  return import(pathToFileURL(require.resolve(specifier)).href);
+}
+
+/**
+ * @param {string} root
+ * @param {string} specifier
+ * @returns {Promise<any | null>} Paket yoksa `null`; adım atlanabilsin diye.
+ */
+export async function tryImportFromApp(root, specifier) {
+  try {
+    return await importFromApp(root, specifier);
+  } catch {
+    return null;
+  }
+}