jskelet 0.7.0 → 0.7.2

package/types/config/defaults.d.ts

@@ -175,6 +175,11 @@ export declare const DATA_CACHE_MAX_ENTRIES_CEILING = 20000;
 export declare const DEFAULT_TRANSIENT_RETRY: {
     attempts: number;
     delayMs: number;
+    /**
+     * `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: boolean;
 };
 /**
  * Upstream veri önbelleği.
@@ -236,9 +241,8 @@ export declare 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 declare const DEFAULT_REDIS: {
     enabled: boolean;
@@ -251,7 +255,7 @@ export declare const DEFAULT_REDIS: {
     html: boolean;
     /** Veri önbelleği paylaşılsın mı. */
     data: boolean;
-    /** Brotli/gzip gövdeleri de paylaşılsın mı. */
+    /** Brotli gövdeleri de paylaşılsın mı (yazma sonrası preencode). */
     storeEncoded: boolean;
     /** pub/sub üzerinden invalidation yayını. */
     events: boolean;

package/types/config/index.d.ts

@@ -147,6 +147,7 @@ export type ResolvedConfig = {
     transientRetry: {
         attempts: number;
         delayMs: number;
+        background?: boolean;
     };
     /**
      * Opsiyonel Redis ikinci kademesi.

package/types/index.d.ts

@@ -5,7 +5,7 @@
  * controller'lar bu yüzeyi kullanır. Alt yollardan (`jskelet/server`)
  * ithal etmek de mümkün; buradaki liste "kararlı" sayılan yüzeydir.
  */
-export { route, fragment, renderPage, renderView, renderNotFound, } from "./server/render.js";
+export { route, fragment, 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";
 export { notFound, redirect, permanentRedirect, seeOther, isNotFoundError, isRedirectError, NotFoundError, RedirectError, } from "./http/control-flow.js";

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

@@ -7,7 +7,15 @@
  */
 export declare function encodeCacheValue(value: unknown): string | Buffer | Promise<string | Buffer> | null;
 /**
+ * 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}
  */
 export declare function decodeCacheValue(raw: Buffer | string): unknown;
+/**
+ * @param {Buffer | string} raw
+ * @returns {Promise<unknown>}
+ */
+export declare function decodeCacheValueAsync(raw: Buffer | string): Promise<unknown>;

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

@@ -3,6 +3,7 @@ export type DataEntry = {
     expiresAt: number;
     staleUntil: number;
     bytes: number;
+    produceMs: number;
 };
 /**
  * Süreç ömrü boyunca biriken sayaçlar.

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

@@ -50,10 +50,8 @@ export type HtmlEntry = {
  */
 export declare function earlyRefreshLeadMs(produceMs: number, ttlMs: number): number;
 /**
- * Sıkıştırılmış gövde `install()`'dan sonra, ilk brotli/gzip yanıtında
- * girdinin `encoded` haritasına eklenir. Sayacı delta ile büyütmek, o sıra
- * LRU'dan düşmüş bir haritaya yazınca bir daha inmeyen bir artık bırakır;
- * store'dan yeniden okumak o artığı taşımaz.
+ * Bayt sayacını store'dan yeniden hesaplar. Testler elle `encoded` doldurunca
+ * çağırır; hot path `rememberHtmlEncoding` delta kullanır.
  *
  * @returns {void}
  */
@@ -202,7 +200,8 @@ export declare function isHtmlCacheFresh(pathname: string, req?: {
 export declare function isHtmlCacheKeyFresh(key: string): boolean;
 /**
  * Girdide en fazla bir sıkıştırılmış gövde durur. Yeni kodlama eskisinin
- * yerini alır; ham HTML kalır. Bayt sayacı `noteHtmlCacheGrowth` ile işlenir.
+ * yerini alır; ham HTML kalır. Bayt sayacı delta ile güncellenir — harita
+ * LRU'dan düşmüşse (store'da yok) sayaç oynatılmaz.
  *
  * @param {Map<string, Buffer>} encoded
  * @param {string} encoding

package/types/server/render.d.ts

@@ -1,3 +1,22 @@
+export type RenderEngine = {
+    helpers: Record<string, unknown>;
+    options: Record<string, unknown>;
+    viewsDir: string;
+    viewRoots: string[];
+    layout: string;
+    compiled: Map<string, (data: object, helpers: object) => string>;
+    loading: Map<string, Promise<(data: object, helpers: object) => string | null>>;
+    manifest: Record<string, string>;
+    templatesDir: string;
+    bust: string;
+    layoutRender: ((data: object, helpers: object) => string) | null;
+};
+/**
+ * Listen öncesi: motor + asset manifest ısınır (sayfa prewarm değil).
+ *
+ * @returns {Promise<void>}
+ */
+export declare function warmRenderEngine(): Promise<void>;
 /**
  * Uygulama geliştirirken bileşen dosyaları değişince kayıt yenilenmeli.
  * Dev sunucusu süreci yeniden başlattığı için normalde gerekmez; gömülü