jskelet 0.6.3 → 0.6.4

package/types/config/defaults.d.ts

@@ -131,6 +131,12 @@ export declare const CLASSIC_PREWARM_KEYS: string[];
  * `vary.host` kopyası sayı tavanının altında da RSS'i şişirir.
  */
 export declare const DEFAULT_HTML_CACHE_MAX_ENTRIES = 500;
+/**
+ * Edge taze penceresi bittikten sonra eski HTML'in sunulacağı süre (saniye).
+ * `cache().staleWhileRevalidate`. 0 ise `stale-while-revalidate` direktifi
+ * basılmaz. Süreç içi HTML cache'in stale penceresinden bağımsızdır.
+ */
+export declare const DEFAULT_STALE_WHILE_REVALIDATE = 60;
 /** `cache().maxEntries` için sert tavan. Üstü uyarıyla bu değere çekilir. */
 export declare const HTML_CACHE_MAX_ENTRIES_CEILING = 800;
 /**

package/types/config/index.d.ts

@@ -124,6 +124,12 @@ export type ResolvedConfig = {
      * HTML önbelleğinin girdi sınırı.
      */
     htmlMaxEntries: number;
+    /**
+     * Edge taze penceresi bittikten sonra
+     * eski HTML'in sunulacağı süre (saniye). 0 ise direktif basılmaz. Süreç içi
+     * HTML cache'in stale penceresinden bağımsızdır.
+     */
+    staleWhileRevalidate: number;
     /**
      * Upstream veri önbelleği ayarları.
      */

package/types/server/cache-control.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Tarayıcıya `max-age=0`, edge'e `CDN-Cache-Control`.
+ *
+ * `s-maxage` yazılmaz: Cloudflare `max-age=0` ile birlikte görünce nesneyi
+ * EXPIRED sayar. `must-revalidate`, `proxy-revalidate` ve `no-cache` aynı
+ * yanıtta stale penceresini keser; burada üretilmez. `s-maxage`'e dönen bir
+ * anahtar da yok — o mod aynı EXPIRED sonucunu geri getirir.
+ *
+ * Süreç içi HTML cache (`X-JSkelet-Cache: STALE`) ayrı katmandır; bu modül
+ * ona dokunmaz. Görsel optimizer kendi `max-age` + `stale-while-revalidate`
+ * yolunu kullanır.
+ */
+/**
+ * @param {number} maxAge Edge'in taze penceresi (saniye). HTML'de route TTL.
+ * @param {number} staleWhileRevalidate Taze pencere bitince eski kopyanın
+ *   sunulacağı süre. 0 ise direktif basılmaz.
+ * @returns {{ cacheControl: string, cdnCacheControl: string }}
+ */
+export declare function edgeCacheControl(maxAge: number, staleWhileRevalidate: number): {
+    cacheControl: string;
+    cdnCacheControl: string;
+};
+/**
+ * @param {import('express').Response} res
+ * @param {number} maxAge
+ * @param {number} staleWhileRevalidate
+ */
+export declare function setEdgeCacheHeaders(res: import('express').Response, maxAge: number, staleWhileRevalidate: number): void;

package/types/server/og-image.d.ts

@@ -94,6 +94,11 @@ export declare function buildOgSvg(options?: OgCardOptions & {
 export declare function ogImage(options?: OgImageOptions): Promise<OgImageResult>;
 /**
  * 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>}