jskelet 0.6.2 → 0.6.4

package/src/server/og-image.js

@@ -11,6 +11,7 @@
 import { tryImportFromApp } from "../build/resolve-peer.mjs";
 import { getConfig } from "../config/index.js";
 import { isNotFoundError } from "../http/control-flow.js";
+import { setEdgeCacheHeaders } from "./cache-control.js";
 
 /** @type {((input: Buffer, opts?: object) => import('sharp').Sharp) | null | undefined} */
 let sharpModule;
@@ -18,8 +19,12 @@ let sharpModule;
 /** Sosyal kartlar için yaygın boyut (Facebook / X / LinkedIn). */
 export const OG_SIZE = Object.freeze({ width: 1200, height: 630 });
 
-const DEFAULT_CACHE =
-  "public, max-age=0, s-maxage=86400, stale-while-revalidate=604800";
+/**
+ * OG süreleri HTML TTL'ye bağlanmaz. Yalnızca `s-maxage` kalkar; edge
+ * `CDN-Cache-Control` üzerinde aynı pencereyi görür.
+ */
+const OG_EDGE_MAX_AGE = 86400;
+const OG_EDGE_STALE = 604800;
 
 /**
  * @typedef {object} OgCardOptions
@@ -255,17 +260,25 @@ export async function ogImage(options = {}) {
 
 /**
  * Express yanıtına OG görseli basar.
+ *
+ * Varsayılan edge penceresi 86400 / 604800'tür ve HTML TTL'ye bağlı değildir.
+ * `cacheControl` verilirse yalnızca `Cache-Control` yazılır;
+ * `CDN-Cache-Control` basılmaz.
+ *
  * @param {import('express').Response} res
  * @param {OgImageOptions} [options]
  * @returns {Promise<OgImageResult>}
  */
 export async function sendOgImage(res, options = {}) {
   const result = await ogImage(options);
-  const cacheControl = options.cacheControl ?? DEFAULT_CACHE;
 
   res.status(200);
   res.setHeader("Content-Type", result.contentType);
-  res.setHeader("Cache-Control", cacheControl);
+  if (options.cacheControl != null) {
+    res.setHeader("Cache-Control", options.cacheControl);
+  } else {
+    setEdgeCacheHeaders(res, OG_EDGE_MAX_AGE, OG_EDGE_STALE);
+  }
   res.setHeader("Content-Length", String(result.body.length));
   // Kazıyıcılar ve CDN'ler için boyut ipucu (meta ile de verilir).
   res.setHeader("X-Og-Width", String(result.width));

package/src/server/prewarm.js

@@ -23,6 +23,7 @@ import { getRequestContext } from "../http/request-context.js";
 import { publicHost } from "./cache-vary.js";
 import {
   isHtmlCacheFresh,
+  isHtmlCacheKeyFresh,
   startEarlyExpirySweep,
   takeInvalidatedPaths,
   takeInvalidatedTargets,
@@ -107,6 +108,16 @@ const CLASSIC_PREWARM_ENV = [
  */
 const visitWarmSettings = { concurrency: null, rps: null };
 
+/**
+ * Süre dolumu ısıtması klasik turun `rps: 0` (sınırsız) ayarını kullanmaz.
+ * Bir TTL uçurumu tek seferde yüzlerce render başlatmasın.
+ */
+const EXPIRY_WARM_CONCURRENCY = 1;
+const EXPIRY_WARM_RPS = 2;
+
+/** @type {{ concurrency: number | null, rps: number | null }} */
+const expiryWarmSettings = { concurrency: null, rps: null };
+
 /**
  * Isıtmanın canlı durumu. Dev araçları bunu okuyup ilerlemeyi gösterir;
  * üretimde kimse okumazsa da maliyeti bir nesnedir.
@@ -208,6 +219,15 @@ function num(value, fallback) {
  * @returns {number}
  */
 function setting(envKey, configKey, fallback) {
+  if (
+    expiryWarmSettings.concurrency != null &&
+    configKey === "concurrency"
+  ) {
+    return expiryWarmSettings.concurrency;
+  }
+  if (expiryWarmSettings.rps != null && configKey === "rps") {
+    return expiryWarmSettings.rps;
+  }
   if (
     visitWarmSettings.concurrency != null &&
     configKey === "concurrency"
@@ -1015,11 +1035,13 @@ async function drainExpiryWarm() {
   if (!targets.length) return;
 
   expiryDraining = true;
+  expiryWarmSettings.concurrency = EXPIRY_WARM_CONCURRENCY;
+  expiryWarmSettings.rps = EXPIRY_WARM_RPS;
   try {
     /** @type {Map<string, string[]>} */
     const byHost = new Map();
     for (const target of targets) {
-      if (isHtmlCacheFresh(target.path, requestForHost(target.host))) continue;
+      if (isHtmlCacheKeyFresh(target.key)) continue;
       const host = target.host || "";
       const list = byHost.get(host);
       if (list) list.push(target.path);
@@ -1053,6 +1075,8 @@ async function drainExpiryWarm() {
   } catch (error) {
     console.error("[prewarm] expiry warm failed", error);
   } finally {
+    expiryWarmSettings.concurrency = null;
+    expiryWarmSettings.rps = null;
     expiryDraining = false;
   }
 }

package/src/server/redis.js

@@ -22,6 +22,7 @@ import crypto from "node:crypto";
 import { DEFAULT_REDIS } from "../config/defaults.js";
 import { tryImportFromApp } from "../build/resolve-peer.mjs";
 import { getBuildId } from "./assets.js";
+import { decodeCacheValue, encodeCacheValue } from "./cache-blob.js";
 
 /**
  * @typedef {import('../config/index.js').RedisConfig} RedisConfig
@@ -289,18 +290,34 @@ export async function redisGetJson(key) {
   if (!usable()) return null;
 
   try {
-    const raw = await client.get(key);
+    // `get` dizge döndürür ve ikili gövdeyi bozar. `getBuffer` yoksa (eski
+    // sahte istemci) düz JSON hâlâ `get` ile okunur.
+    const raw =
+      typeof client.getBuffer === "function" ? await client.getBuffer(key) : await client.get(key);
     noteSuccess();
-    return raw === null ? null : JSON.parse(raw);
+    return raw == null ? null : decodeCacheValue(raw);
   } catch (error) {
     noteFailure("get", error);
     return null;
   }
 }
 
+/**
+ * @param {string} key
+ * @param {string | Buffer} payload
+ * @param {number} ttlMs
+ * @returns {Promise<void>}
+ */
+function writeRaw(key, payload, ttlMs) {
+  return Promise.resolve(client.set(key, payload, "PX", Math.ceil(ttlMs)))
+    .then(noteSuccess)
+    .catch((error) => noteFailure("set", error));
+}
+
 /**
  * Ateşle-unut yazma. İsteğin yanıt yolunda beklenmez: HTML zaten L1'e
- * yazıldı, Redis kopyası yalnızca diğer node'lar için.
+ * yazıldı, Redis kopyası yalnızca diğer node'lar için. 1 KB ve üstü gövdeler
+ * brotli ile yazılır; okuma düz JSON'u da kabul eder.
  *
  * @param {string} key
  * @param {unknown} value
@@ -309,20 +326,22 @@ export async function redisGetJson(key) {
 export function redisSetJson(key, value, ttlMs) {
   if (!usable() || !(ttlMs > 0)) return;
 
-  /** @type {string} */
-  let payload;
-  try {
-    payload = JSON.stringify(value);
-  } catch (error) {
+  const encoded = encodeCacheValue(value);
+  if (encoded === null) {
     // Serileştirilemeyen değer (döngüsel referans, BigInt) sessizce atlanır;
     // L1 kopyası çalışmaya devam eder.
-    noteFailure("serialize", error);
+    noteFailure("serialize", new Error("not JSON"));
     return;
   }
 
-  Promise.resolve(client.set(key, payload, "PX", Math.ceil(ttlMs)))
-    .then(noteSuccess)
-    .catch((error) => noteFailure("set", error));
+  // Küçük gövde senkron döner ki testler `set`'ten hemen sonra kaydı okusun.
+  // Büyük gövdenin brotli'si MISS yanıtını bekletmez.
+  if (typeof encoded === "string" || Buffer.isBuffer(encoded)) {
+    writeRaw(key, encoded, ttlMs);
+    return;
+  }
+
+  encoded.then((payload) => writeRaw(key, payload, ttlMs));
 }
 
 /**