jskelet 0.7.0 → 0.7.2

package/src/compile/codegen.js

@@ -1,6 +1,10 @@
 /**
  * AST → ESM kaynak metni. `eval` / `new Function` yok; çıktı diskteki
  * `.mjs` dosyasına yazılır ve runtime'da normal `import` ile yüklenir.
+ *
+ * Statik HTML parçaları bitişik `s +=` yerine tek literal'de birleşir;
+ * şablon girintisi (satır sonu içeren salt-whitespace) derlemede düşer.
+ * `pre` / `textarea` / `script` / `style` / `code` içinde whitespace korunur.
  */
 import { codegenExpr } from "./expr.js";
 import { CompileError } from "./errors.js";
@@ -10,6 +14,9 @@ import { CompileError } from "./errors.js";
  * @typedef {import('./parse.js').AttrNode} AttrNode
  */
 
+/** İçinde girinti sıkıştırması yapılmayan etiketler. */
+const PRESERVE_WS = new Set(["pre", "textarea", "script", "style", "code"]);
+
 /**
  * @param {AstNode[]} ast
  * @param {{ viewId: string, file?: string, knownComponents?: Set<string> }} options
@@ -49,6 +56,21 @@ export function toPascalCase(name) {
     .join("");
 }
 
+/**
+ * Şablon girintisini düşür: satır sonu içeren salt-whitespace → boş;
+ * yalnızca boşluk/tab → tek boşluk (inline aralık). Koruma alanı dışında.
+ *
+ * @param {string} value
+ * @param {boolean} preserve
+ * @returns {string}
+ */
+export function collapseTemplateWhitespace(value, preserve) {
+  if (preserve || !value) return value;
+  if (!/^[\t\n\r\f\v ]+$/.test(value)) return value;
+  if (/[\n\r]/.test(value)) return "";
+  return " ";
+}
+
 class CodegenContext {
   /**
    * @param {{ viewId: string, file?: string, knownComponents?: Set<string> }} options
@@ -71,6 +93,10 @@ class CodegenContext {
     this.locals = new Set();
     /** Çocuk gövdesinde `s` yerine kullanılacak değişken. */
     this.outVar = "s";
+    /** Bitişik statik parçalar — flush edilene kadar birikir. */
+    this.staticBuf = "";
+    /** `pre` vb. iç içe derinliği. */
+    this.preserveWs = 0;
   }
 
   /**
@@ -81,9 +107,28 @@ class CodegenContext {
   }
 
   /**
+   * Birikmiş statik HTML'i tek `+=` olarak yazar.
+   * @returns {void}
+   */
+  flushStatic() {
+    if (!this.staticBuf) return;
+    this.line(`${this.outVar} += ${JSON.stringify(this.staticBuf)};`);
+    this.staticBuf = "";
+  }
+
+  /**
+   * @param {string} text
+   */
+  appendStatic(text) {
+    if (text) this.staticBuf += text;
+  }
+
+  /**
+   * Dinamik ifade — önce statik tamponu boşaltır.
    * @param {string} exprJs
    */
   append(exprJs) {
+    this.flushStatic();
     this.line(`${this.outVar} += ${exprJs};`);
   }
 
@@ -105,9 +150,14 @@ class CodegenContext {
    */
   emit(node) {
     switch (node.type) {
-      case "Text":
-        if (node.value) this.append(JSON.stringify(node.value));
+      case "Text": {
+        const value = collapseTemplateWhitespace(
+          node.value,
+          this.preserveWs > 0,
+        );
+        if (value) this.appendStatic(value);
         break;
+      }
       case "Interp": {
         const expr = codegenExpr(node.expr, this.locals);
         if (node.raw) this.append(`(${expr} ?? "")`);
@@ -139,17 +189,21 @@ class CodegenContext {
    */
   emitElement(node) {
     const bound = node.attrs.some((a) => a.bound);
+    const preserve = PRESERVE_WS.has(node.name.toLowerCase());
+
     if (bound) {
       this.append(
         `"<${node.name}" + helpers.attrs({${this.attrsObject(node.attrs)}}) + ">"`,
       );
     } else {
-      this.append(JSON.stringify(`<${node.name}${staticAttrString(node.attrs)}>`));
+      this.appendStatic(`<${node.name}${staticAttrString(node.attrs)}>`);
     }
 
     if (!node.selfClosing) {
+      if (preserve) this.preserveWs += 1;
       this.emitNodes(node.children);
-      this.append(JSON.stringify(`</${node.name}>`));
+      if (preserve) this.preserveWs -= 1;
+      this.appendStatic(`</${node.name}>`);
     }
   }
 
@@ -186,13 +240,18 @@ class CodegenContext {
 
     if (node.children.length) {
       const tmp = this.nextTemp();
+      this.flushStatic();
       this.line(`{`);
       this.indent += 1;
       this.line(`let ${tmp} = "";`);
       const prevOut = this.outVar;
+      const prevStatic = this.staticBuf;
       this.outVar = tmp;
+      this.staticBuf = "";
       this.emitNodes(node.children);
+      this.flushStatic();
       this.outVar = prevOut;
+      this.staticBuf = prevStatic;
       const propsWithChildren = props
         ? `${props}, children: ${tmp}`
         : `children: ${tmp}`;
@@ -209,14 +268,17 @@ class CodegenContext {
    */
   emitIf(node) {
     const test = codegenExpr(node.test, this.locals);
+    this.flushStatic();
     this.line(`if (${test}) {`);
     this.indent += 1;
     this.emitNodes(node.consequent);
+    this.flushStatic();
     this.indent -= 1;
     if (node.alternate.length) {
       this.line(`} else {`);
       this.indent += 1;
       this.emitNodes(node.alternate);
+      this.flushStatic();
       this.indent -= 1;
     }
     this.line(`}`);
@@ -228,6 +290,7 @@ class CodegenContext {
   emitEach(node) {
     const list = codegenExpr(node.list, this.locals);
     const idx = node.indexName ?? `__i${++this.temp}`;
+    this.flushStatic();
     this.line(`{`);
     this.indent += 1;
     this.line(`const __list = ${list} ?? [];`);
@@ -239,6 +302,7 @@ class CodegenContext {
     this.locals.add(idx);
     if (node.indexName) this.locals.add(node.indexName);
     this.emitNodes(node.children);
+    this.flushStatic();
     this.locals = prev;
     this.indent -= 1;
     this.line(`}`);
@@ -259,6 +323,8 @@ class CodegenContext {
 
   /** @returns {string} */
   finish() {
+    this.flushStatic();
+
     const imports = [...this.includes]
       .map((id) => {
         const alias = includeAlias(id);

package/src/compile/compile-all.js

@@ -3,6 +3,7 @@
  */
 import fs from "node:fs";
 import path from "node:path";
+import process from "node:process";
 import { parseTemplate } from "./parse.js";
 import { codegen, normalizeIncludeId } from "./codegen.js";
 import { CompileError } from "./errors.js";
@@ -97,21 +98,35 @@ export async function compileAll(config, _options = {}) {
 }
 
 /**
- * Manifest yoksa veya herhangi bir `.jsk` daha yeniyse yeniden derler.
+ * Manifest yoksa veya (dev'de) herhangi bir `.jsk` daha yeniyse yeniden derler.
+ * Production'da manifest varsa mtime taraması atlanır — `jskelet build` CI
+ * güvencesi; ilk istekte yüzlerce `statSync` cold start'ı şişirmesin.
  * Dev sunucu restart'ında build watch kaçırmış olsa bile şablonlar güncel kalır.
  *
  * @param {{ root: string, dirs: Record<string, string> }} config
  * @returns {Promise<{ count: number, rebuilt: boolean }>}
  */
 export async function ensureTemplatesCompiled(config) {
+  const outDir = path.join(config.dirs.generated, "templates");
+  const manifestPath = path.join(outDir, "manifest.json");
+  const isProd = process.env.NODE_ENV === "production";
+
+  // Prod'da manifest varsa kaynak ağacını hiç gezme — cold start FS maliyeti.
+  if (isProd && fs.existsSync(manifestPath)) {
+    try {
+      const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
+      return { count: Object.keys(manifest).length, rebuilt: false };
+    } catch {
+      return { count: 0, rebuilt: false };
+    }
+  }
+
   const viewRoots = getViewRoots(config);
   const jskFiles = discoverJskFiles(viewRoots);
   if (jskFiles.size === 0) {
     return { count: 0, rebuilt: false };
   }
 
-  const outDir = path.join(config.dirs.generated, "templates");
-  const manifestPath = path.join(outDir, "manifest.json");
   let needs = !fs.existsSync(manifestPath);
 
   if (!needs) {

package/src/compile/index.js

@@ -4,7 +4,12 @@
 export { CompileError, indexToLocation } from "./errors.js";
 export { parseExpr, codegenExpr } from "./expr.js";
 export { parseTemplate, isComponentTag } from "./parse.js";
-export { codegen, toPascalCase, normalizeIncludeId } from "./codegen.js";
+export {
+  codegen,
+  toPascalCase,
+  normalizeIncludeId,
+  collapseTemplateWhitespace,
+} from "./codegen.js";
 export {
   getViewRoots,
   getComponentDirs,

package/src/config/defaults.js

@@ -209,6 +209,11 @@ export const DATA_CACHE_MAX_ENTRIES_CEILING = 20_000;
 export const DEFAULT_TRANSIENT_RETRY = {
   attempts: 1,
   delayMs: 300,
+  /**
+   * `true` (varsayılan): ilk transient `notFound`ta hemen 503; retry arka
+   * planda data cache'i ısıtır. `false`: yanıt öncesi senkron retry (eski).
+   */
+  background: true,
 };
 
 /**
@@ -273,9 +278,8 @@ export const DEFAULT_UPSTREAM_LIMIT = {
  * invalidation'ı bütün node'lara yaymak. Tek instance çalışan bir kurulumda
  * kazanç neredeyse yok; bu yüzden `enabled` varsayılan olarak kapalı.
  *
- * `storeEncoded` kapalı, çünkü sıkıştırılmış gövdeleri de paylaşmak girdi
- * başına boyutu iki-üç katına çıkarır ve brotli'yi yeniden üretmek Redis'ten
- * indirmekten çoğu zaman daha ucuz.
+ * `storeEncoded` açık: soğuk replica L2 HIT'te yeniden brotli ödemesin.
+ * Boyut artar; tek encoding (br) tutulduğu için maliyet sınırlıdır.
  */
 export const DEFAULT_REDIS = {
   enabled: false,
@@ -288,8 +292,8 @@ export const DEFAULT_REDIS = {
   html: true,
   /** Veri önbelleği paylaşılsın mı. */
   data: true,
-  /** Brotli/gzip gövdeleri de paylaşılsın mı. */
-  storeEncoded: false,
+  /** Brotli gövdeleri de paylaşılsın mı (yazma sonrası preencode). */
+  storeEncoded: true,
   /** pub/sub üzerinden invalidation yayını. */
   events: true,
   /**

package/src/config/index.js

@@ -140,7 +140,7 @@ const CONFIG_FILE = "jskelet.config.mjs";
  * @property {Record<string, unknown>} data Upstream veri önbelleği ayarları.
  * @property {boolean} trackUpstream `fetch` sarılıp geçici hatalar otomatik bildirilsin mi.
  * @property {boolean} trackDependencies Render'ın okuduğu veri anahtarları kaydedilsin mi.
- * @property {{ attempts: number, delayMs: number }} transientRetry
+ * @property {{ attempts: number, delayMs: number, background?: boolean }} transientRetry
  * @property {RedisConfig} redis Opsiyonel Redis ikinci kademesi.
  * @property {typeof DEFAULT_UPSTREAM_LIMIT} upstream Upstream hız freni.
  * @property {LogsConfig} logs Kalıcı log sink'leri (dosya + S3).
@@ -348,7 +348,7 @@ function normalizeRedis(raw) {
     keyPrefix: String(source.keyPrefix ?? DEFAULT_REDIS.keyPrefix),
     html: source.html !== false,
     data: source.data !== false,
-    storeEncoded: source.storeEncoded === true,
+    storeEncoded: source.storeEncoded !== false,
     events: source.events !== false,
     commandTimeoutMs:
       Number.isFinite(timeout) && timeout > 0
@@ -738,7 +738,7 @@ function normalizeVary(raw) {
  *   staleWhileRevalidate: number,
  *   data: Record<string, unknown>, trackUpstream: boolean,
  *   trackDependencies: boolean,
- *   transientRetry: { attempts: number, delayMs: number },
+ *   transientRetry: { attempts: number, delayMs: number, background?: boolean },
  *   redis: RedisConfig,
  *   upstream: typeof DEFAULT_UPSTREAM_LIMIT,
  *   cloudflare: typeof DEFAULT_CLOUDFLARE,

package/src/http/request-cache.js

@@ -18,6 +18,24 @@ export function withRequestCache(run) {
   return storage.run(new Map(), run);
 }
 
+/**
+ * Sık görülen ilkel argümanlarda `JSON.stringify` atlanır.
+ *
+ * @param {unknown[]} args
+ * @returns {string}
+ */
+function argsKey(args) {
+  if (args.length === 0) return "";
+  if (args.length === 1) {
+    const value = args[0];
+    const type = typeof value;
+    if (value == null) return `\0${value}`;
+    if (type === "string") return `\0s:${value}`;
+    if (type === "number" || type === "boolean") return `\0${type}:${value}`;
+  }
+  return JSON.stringify(args);
+}
+
 /**
  * @param {F} fn
  * @returns {F}
@@ -34,7 +52,7 @@ export function cache(fn) {
       contextStore.set(fn, perFn);
     }
 
-    const key = args.length === 0 ? "" : JSON.stringify(args);
+    const key = argsKey(args);
     if (perFn.has(key)) return perFn.get(key);
 
     const result = fn(...args);

package/src/index.js

@@ -11,6 +11,8 @@ export {
   renderPage,
   renderView,
   renderNotFound,
+  warmRenderEngine,
+  resetRenderEngine,
 } from "./server/render.js";
 export { renderStatusPage, statusFromError } from "./server/status-page.js";
 export { createApp, startServer } from "./server/create-app.js";

package/src/server/assets.js

@@ -151,6 +151,55 @@ export function getBuildId() {
 /** @type {Record<string, OptimizedImage> | null} */
 let images = null;
 
+/** Prefix uygulanmış kopya — her `optimizedImage` çağrısında map/spread yok. */
+/** @type {Record<string, OptimizedImage> | null} */
+let imagesPrefixed = null;
+
+/** @type {string | null} */
+let imagesPrefix = null;
+
+/**
+ * `images.json` yükler; CDN prefix varsa varyant URL'lerini bir kez materialize eder.
+ * @returns {Record<string, OptimizedImage>}
+ */
+function loadImages() {
+  const prefix = assetPrefix();
+  if (!isDev && images && imagesPrefix === prefix) {
+    return imagesPrefixed ?? images;
+  }
+
+  /** @type {Record<string, OptimizedImage>} */
+  let raw = {};
+  try {
+    const file = path.join(getConfig().dirs.generated, "images.json");
+    raw = JSON.parse(fs.readFileSync(file, "utf8")).images ?? {};
+  } catch {
+    raw = {};
+  }
+
+  images = raw;
+  imagesPrefix = prefix;
+
+  if (!prefix) {
+    imagesPrefixed = raw;
+    return raw;
+  }
+
+  /** @type {Record<string, OptimizedImage>} */
+  const prefixed = {};
+  for (const [key, entry] of Object.entries(raw)) {
+    prefixed[key] = {
+      ...entry,
+      variants: entry.variants.map((variant) => ({
+        ...variant,
+        url: applyAssetPrefix(prefix, variant.url),
+      })),
+    };
+  }
+  imagesPrefixed = prefixed;
+  return prefixed;
+}
+
 /**
  * `build/tasks/images.mjs` çıktısı: kaynak yolundan webp varyantlarına.
  * Build çalışmadıysa boş kalır ve görseller orijinalleriyle servis edilir.
@@ -159,29 +208,9 @@ let images = null;
  * @returns {OptimizedImage | undefined}
  */
 export function optimizedImage(src) {
-  if (isDev || !images) {
-    try {
-      const file = path.join(getConfig().dirs.generated, "images.json");
-      images = JSON.parse(fs.readFileSync(file, "utf8")).images ?? {};
-    } catch {
-      images = {};
-    }
-  }
-
+  const table = loadImages();
   if (!src) return undefined;
-  const entry = images[src];
-  if (!entry) return undefined;
-
-  const prefix = assetPrefix();
-  if (!prefix) return entry;
-
-  return {
-    ...entry,
-    variants: entry.variants.map((variant) => ({
-      ...variant,
-      url: applyAssetPrefix(prefix, variant.url),
-    })),
-  };
+  return table[src];
 }
 
 /** @type {{ url: string, ids: Set<string> } | null} */

package/src/server/cache-blob.js

@@ -53,6 +53,9 @@ export function encodeCacheValue(value) {
 }
 
 /**
+ * Senkron çözücü — küçük test / senkron yollar için. Hot path
+ * `decodeCacheValueAsync` kullanır (event loop'u brotli ile bloklamaz).
+ *
  * @param {Buffer | string} raw
  * @returns {unknown}
  */
@@ -68,3 +71,33 @@ export function decodeCacheValue(raw) {
   const text = Buffer.isBuffer(raw) ? raw.toString("utf8") : raw;
   return JSON.parse(text);
 }
+
+/**
+ * @param {Buffer | string} raw
+ * @returns {Promise<unknown>}
+ */
+export function decodeCacheValueAsync(raw) {
+  if (
+    Buffer.isBuffer(raw) &&
+    raw.length > CACHE_MAGIC.length &&
+    raw.subarray(0, CACHE_MAGIC.length).equals(CACHE_MAGIC)
+  ) {
+    const body = raw.subarray(CACHE_MAGIC.length);
+    return new Promise((resolve, reject) => {
+      zlib.brotliDecompress(body, (error, out) => {
+        if (error) {
+          reject(error);
+          return;
+        }
+        try {
+          resolve(JSON.parse(out.toString("utf8")));
+        } catch (parseError) {
+          reject(parseError);
+        }
+      });
+    });
+  }
+
+  const text = Buffer.isBuffer(raw) ? raw.toString("utf8") : raw;
+  return Promise.resolve(JSON.parse(text));
+}

package/src/server/create-app.js

@@ -247,6 +247,11 @@ export async function startServer(options = {}) {
 
   const app = await createApp(options);
 
+  // İlk istek TTFB'sine binmesin: şablon motoru + asset manifest burada ısınır.
+  // Sayfa prewarm değildir.
+  const { warmRenderEngine } = await import("./render.js");
+  await warmRenderEngine();
+
   // Varsayılan `::`, `0.0.0.0` değil: ikisi de "tüm arayüzler" demek, ama
   // yalnızca IPv6 soketi çift yığın çalışır ve `localhost`un `::1`e çözüldüğü
   // durumu da kapsar. Tarayıcılar `localhost` için önce `::1` deniyor; sıradan

package/src/server/data-cache.js

@@ -27,7 +27,7 @@ import { getConfig } from "../config/index.js";
 import { DATA_CACHE_BYTE_BUDGET, DEFAULT_DATA_CACHE } from "../config/defaults.js";
 import { recordDependency } from "./cache-deps.js";
 import { diskDrop, diskDropMatching, diskGetJson, diskSetJson, diskShares } from "./disk-cache.js";
-import { invalidateHtmlByDependency } from "./html-cache.js";
+import { earlyRefreshLeadMs, invalidateHtmlByDependency } from "./html-cache.js";
 import {
   cacheKey,
   onCacheEvent,
@@ -39,9 +39,12 @@ import {
 } from "./redis.js";
 
 /**
- * @typedef {{ value: unknown, expiresAt: number, staleUntil: number, bytes: number }} DataEntry
+ * @typedef {{ value: unknown, expiresAt: number, staleUntil: number, bytes: number,
+ *   produceMs: number }} DataEntry
  */
 
+const DEFAULT_PRODUCE_MS = 500;
+
 /** @type {Map<string, DataEntry>} */
 const store = new Map();
 
@@ -60,6 +63,14 @@ let byteBudgetOverride = null;
 /** @type {Map<string, Promise<unknown>>} */
 const inflight = new Map();
 
+/**
+ * L2 miss kısa belleği — boş Redis/disk turunu tekrarlamamak için.
+ * @type {Map<string, number>}
+ */
+const sharedMissUntil = new Map();
+const SHARED_MISS_TTL_MS = 2_000;
+const MAX_SHARED_MISS = 2_000;
+
 /**
  * Süreç ömrü boyunca biriken sayaçlar.
  *
@@ -106,9 +117,25 @@ function settings() {
   }
 }
 
+/**
+ * @param {DataEntry} entry
+ * @param {number} [now]
+ * @returns {boolean}
+ */
+function isEarly(entry, now = Date.now()) {
+  if (now >= entry.expiresAt) return false;
+  // `storedAt` yok; orijinal TTL = bayat penceresi / staleFactor.
+  const staleFactor = settings().staleFactor;
+  const staleWindow = Math.max(0, entry.staleUntil - entry.expiresAt);
+  const originalTtl =
+    staleFactor > 0 ? staleWindow / staleFactor : Math.max(staleWindow, entry.produceMs * 4);
+  const lead = earlyRefreshLeadMs(entry.produceMs ?? DEFAULT_PRODUCE_MS, originalTtl);
+  return now >= entry.expiresAt - lead;
+}
+
 /**
  * @param {string} key
- * @returns {{ value: unknown, stale: boolean } | null}
+ * @returns {{ value: unknown, stale: boolean, early: boolean } | null}
  */
 function read(key) {
   const entry = store.get(key);
@@ -124,7 +151,12 @@ function read(key) {
   store.delete(key);
   store.set(key, entry);
 
-  return { value: entry.value, stale: now >= entry.expiresAt };
+  const stale = now >= entry.expiresAt;
+  return {
+    value: entry.value,
+    stale,
+    early: !stale && isEarly(entry, now),
+  };
 }
 
 /**
@@ -200,8 +232,9 @@ function install(key, entry) {
  * @param {unknown} value
  * @param {number} ttlSeconds
  * @param {number} staleFactor
+ * @param {number} [produceMs]
  */
-function write(key, value, ttlSeconds, staleFactor) {
+function write(key, value, ttlSeconds, staleFactor, produceMs = DEFAULT_PRODUCE_MS) {
   const now = Date.now();
   const ttl = ttlSeconds * 1000;
 
@@ -211,8 +244,12 @@ function write(key, value, ttlSeconds, staleFactor) {
     expiresAt: now + ttl,
     staleUntil: now + ttl + ttl * staleFactor,
     bytes: valueBytes(value),
+    produceMs:
+      Number.isFinite(produceMs) && produceMs >= 0 ? Math.round(produceMs) : DEFAULT_PRODUCE_MS,
   };
 
+  sharedMissUntil.delete(key);
+
   // Bütçeye sığmayan değer Redis'e de yazılmaz: bir sonraki istek onu geri
   // alıp yine reddeder. Çağıran sonuç yine `producer`'ın döndürdüğüdür.
   if (!install(key, entry)) return;
@@ -236,9 +273,25 @@ function write(key, value, ttlSeconds, staleFactor) {
  */
 function promote(key, entry) {
   if (!entry.bytes) entry.bytes = valueBytes(entry.value);
+  if (!Number.isFinite(entry.produceMs) || entry.produceMs < 0) {
+    entry.produceMs = DEFAULT_PRODUCE_MS;
+  }
+  sharedMissUntil.delete(key);
   install(key, entry);
 }
 
+/**
+ * @param {string} key
+ * @returns {void}
+ */
+function rememberSharedMiss(key) {
+  if (sharedMissUntil.size >= MAX_SHARED_MISS) {
+    const oldest = sharedMissUntil.keys().next().value;
+    if (oldest !== undefined) sharedMissUntil.delete(oldest);
+  }
+  sharedMissUntil.set(key, Date.now() + SHARED_MISS_TTL_MS);
+}
+
 /**
  * Paylaşımlı kademeden okur.
  *
@@ -254,13 +307,24 @@ async function readShared(key) {
   const onDisk = diskShares("data");
   if (!onRedis && !onDisk) return null;
 
+  const missUntil = sharedMissUntil.get(key);
+  if (missUntil !== undefined) {
+    if (Date.now() < missUntil) return null;
+    sharedMissUntil.delete(key);
+  }
+
   const entry = onRedis ? await redisGetJson(cacheKey("data", key)) : await diskGetJson("data", key);
-  if (!entry || typeof entry.expiresAt !== "number") return null;
+  if (!entry || typeof entry.expiresAt !== "number") {
+    rememberSharedMiss(key);
+    return null;
+  }
   if (Date.now() >= entry.expiresAt) {
     if (onDisk) diskDrop("data", [key]);
+    rememberSharedMiss(key);
     return null;
   }
 
+  sharedMissUntil.delete(key);
   return /** @type {DataEntry} */ (entry);
 }
 
@@ -309,11 +373,13 @@ async function produce(key, ttlSeconds, producer, options, staleFactor) {
   }
 
   stats.produced += 1;
+  const startedAt = Date.now();
   const value = await producer();
+  const produceMs = Date.now() - startedAt;
 
   const empty = value === undefined || value === null;
   if (!empty || options.storeEmpty === true) {
-    write(key, value, ttlSeconds, staleFactor);
+    write(key, value, ttlSeconds, staleFactor, produceMs);
   }
 
   return value;
@@ -348,10 +414,9 @@ export async function withDataCache(key, ttlSeconds, producer, options = {}) {
     if (hit.stale) stats.stale += 1;
     else stats.hits += 1;
 
-    // Bayat girdi anında döner; tazeleme arkada yürür ve hatası bu isteği
-    // etkilemez — çağıran taraf bir şey beklemediği için upstream'in yavaş
-    // olması sayfaya yansımaz.
-    if (hit.stale) {
+    // Bayat veya erken penceredeki girdi anında döner; tazeleme arkada yürür
+    // — HTML cache ile aynı: TTL dolmadan upstream çağrısı bitsin.
+    if (hit.stale || hit.early) {
       void refresh(key, ttlSeconds, producer, options).catch((error) => {
         console.error(`[data-cache] background refresh failed: ${key}`, error);
       });
@@ -445,6 +510,7 @@ function clearLocal(prefix) {
     removed.push(...store.keys());
     store.clear();
     storedBytes = 0;
+    sharedMissUntil.clear();
   } else {
     for (const key of [...store.keys()]) {
       if (key.startsWith(prefix)) {