jskelet 0.6.0 → 0.6.2

package/types/config/defaults.d.ts

@@ -94,25 +94,53 @@ export declare const DEFAULT_PREWARM_ON_VISIT: {
     /** Sayfa başına üstten alta en fazla kaç link kuyruğa alınır. */
     perPage: number;
     /**
-     * Paralel işçi; `null` → klasik prewarm ile aynı varsayılan
-     * (prod 4 / dev 1) `startPrewarm` içinde çözülür.
+     * Paralel işçi. `null` yalnızca kapalı modda durur; açıkken tavan
+     * (`ON_VISIT_CONCURRENCY_CEILING`) uygulanır. Klasik prewarm'daki
+     * prod 4 burada geçerli değil — onVisit sürekli çalışır.
      * @type {number | null}
      */
     concurrency: number | null;
     /**
-     * Saniyedeki istek tavanı; `null` → klasik ile aynı (prod 0 / dev 4).
+     * Saniyedeki istek tavanı. `null` yalnızca kapalı modda durur; açıkken
+     * `0` (sınırsız) dahil her şey `ON_VISIT_RPS_CEILING` ile kesilir.
      * @type {number | null}
      */
     rps: number | null;
 };
+/**
+ * onVisit sürekli tur olduğu için klasik prewarm'daki "sınırsız" burada yok.
+ * Config daha yükseğini yazsa da çözümlenen değer bu tavanları geçemez.
+ */
+export declare const ON_VISIT_PER_PAGE_CEILING = 20;
+export declare const ON_VISIT_RPS_CEILING = 2;
+export declare const ON_VISIT_CONCURRENCY_CEILING = 2;
+/**
+ * Bekleyen onVisit yolları. Bir sayfa düzinelerce link basınca kuyruk
+ * birikmesin; taşan link bu turda alınmaz.
+ */
+export declare const ON_VISIT_QUEUE_MAX = 64;
 /** `onVisit` açıkken `cache().prewarm` kökünde yasak olan klasik alanlar. */
 export declare const CLASSIC_PREWARM_KEYS: string[];
 /**
  * HTML önbelleğinin girdi sınırı. 500 girdi ortalama bir sayfa boyutunda
  * yaklaşık 100-200 MB tutar; uzun kuyruklu siteler bunu yükseltmek yerine
  * veri önbelleğine yaslanmalı (bkz. `DEFAULT_DATA_CACHE`).
+ *
+ * Config daha yükseğini istese de girdi sayısı `HTML_CACHE_MAX_ENTRIES_CEILING`
+ * değerini geçemez. Asıl bellek freni bayt bütçesidir: şişman sayfa ve
+ * `vary.host` kopyası sayı tavanının altında da RSS'i şişirir.
  */
 export declare const DEFAULT_HTML_CACHE_MAX_ENTRIES = 500;
+/** `cache().maxEntries` için sert tavan. Üstü uyarıyla bu değere çekilir. */
+export declare const HTML_CACHE_MAX_ENTRIES_CEILING = 800;
+/**
+ * Süreç içi HTML string + sıkıştırılmış gövde tavanı (256 MB).
+ * `install()` bunu uygular; config yükseltemez. Tek sayfa bütçeden büyükse
+ * saklanmaz, yanıt yine gider.
+ */
+export declare const HTML_CACHE_BYTE_BUDGET: number;
+/** `cache().data.maxEntries` için sert tavan. Uzun kuyruk burada durur, HTML'de değil. */
+export declare const DATA_CACHE_MAX_ENTRIES_CEILING = 20000;
 /**
  * `notFound()` geçici bir upstream hatasına denk geldiğinde sayfanın kaç kez
  * daha denenmesi gerektiği.

package/types/config/index.d.ts

@@ -178,6 +178,11 @@ export type ResolvedConfig = {
         extensions: Set<string>;
         prefixes: string[];
     };
+    /**
+     * `DEV_TOKEN` tek başına siteyi kilitlemez; gate
+     * ancak bu bayrak veya `DEV_GATE=1` ile açılır.
+     */
+    devGate: boolean;
     devGateBypass: string[];
     preconnect: string[];
     navigation: NavigationConfig;

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

@@ -49,6 +49,23 @@ export type HtmlEntry = {
  * @returns {number}
  */
 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.
+ *
+ * @returns {void}
+ */
+export declare function noteHtmlCacheGrowth(): void;
+/**
+ * Bellek freninin bayt tavanını geçici olarak değiştirir. Testler LRU
+ * tahliyesini küçük bir değerle doğrular; `null` üretim tavanına döner.
+ *
+ * @param {number | null} bytes
+ * @returns {void}
+ */
+export declare function setHtmlCacheByteBudget(bytes: number | null): void;
 /**
  * @param {string} key
  * @param {number} ttlSeconds 0 → cache yok
@@ -121,12 +138,20 @@ export declare function invalidateHtmlByDependency(dataKeys: Iterable<string>):
  */
 export declare function dropHtmlCacheKey(key: string): boolean;
 /**
- * Invalidate edilmiş ve henüz kimsenin istemediği yolları döner ve kuyruğu
- * boşaltır. Isıtma turu bunları başa alır; iki tur aynı yolu tekrar
- * ısıtmasın diye okuma yıkıcıdır.
+ * Invalidate edilmiş yollar. Okuma yıkıcıdır; iki tur aynı yolu tekrar
+ * ısıtmasın. `onlyHost` verilirse başka host'ların anahtarları kuyrukta
+ * kalır — süre dolumu onları kendi host'uyla ısıtır, `127.0.0.1` anahtarı
+ * açılmaz.
  *
- * Vary öneki (`h=…|`) düşülür — HTTP ısıtması yalnızca yolu ister; host
- * ayrımı `prewarm.origins` / istek Host'u ile yapılır.
+ * @param {string} [onlyHost]
+ * @returns {{ path: string, host: string }[]}
+ */
+export declare function takeInvalidatedTargets(onlyHost?: string): {
+    path: string;
+    host: string;
+}[];
+/**
+ * Yol listesi. Vary öneki düşülür; host ayrımı `takeInvalidatedTargets`.
  *
  * @returns {string[]}
  */
@@ -152,10 +177,19 @@ export declare function getHtmlCacheEntries(): {
  * Yol (query'siz) için taze bir HTML girdisi var mı? Ziyaret ısıtması yalnızca
  * soğuk / bayat hedefleri kuyruğa alır; HIT'leri yeniden çekmez.
  *
+ * Gerçek anahtar `h=host|/yol?` biçimindedir: düz `store.get(pathname)` hem
+ * vary önekini hem sondaki `?` işaretini kaçırır ve sıcak sayfayı yeniden
+ * ısıtır. `vary.host` açıkken yalnızca bu isteğin host'u sayılır; diğer
+ * locale'in kopyası bu yolu sıcak yapmaz.
+ *
  * @param {string} pathname
+ * @param {{ headers?: Record<string, unknown>, get?: (name: string) => string | undefined }} [req]
  * @returns {boolean}
  */
-export declare function isHtmlCacheFresh(pathname: string): boolean;
+export declare function isHtmlCacheFresh(pathname: string, req?: {
+    headers?: Record<string, unknown>;
+    get?: (name: string) => string | undefined;
+}): boolean;
 /**
  * Erken tazeleme penceresine girmiş (veya TTL'i dolmuş) trafiksiz girdileri
  * soft-bayatlatır ve ısıtma kuyruğuna alır. HTTP ısıtması producer'sız

package/types/server/middleware/robots-txt.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @param {string} [brandName]
+ * @returns {string}
+ */
+export declare function frameworkRobotsNote(brandName?: string): string;
+/**
+ * `robots.txt`'e yazılacak `Disallow` yolları.
+ *
+ * Üç önek her zaman vardır. Panel, uzak görsel ve handoff yalnızca
+ * gerçekten mount edildiklerinde ve öneklerin dışına taşındıklarında eklenir.
+ * Dev araçlarının özel yolu yalnızca development'ta yazılır: production'da
+ * o yol uygulamanın kendi sayfası olabilir.
+ *
+ * @param {object} [config]
+ * @param {{ dev?: boolean }} [options]
+ * @returns {string[]}
+ */
+export declare function frameworkDisallowPaths(config?: object, options?: {
+    dev?: boolean;
+}): string[];
+/**
+ * @param {string} body
+ * @param {{ brandName?: string, paths: string[] }} options
+ * @returns {string}
+ */
+export declare function appendFrameworkRobots(body: string, options: {
+    brandName?: string;
+    paths: string[];
+}): string;
+/**
+ * @returns {import('express').RequestHandler}
+ */
+export declare function robotsTxtMiddleware(): import('express').RequestHandler;

package/types/server/prewarm.d.ts

@@ -65,15 +65,18 @@ export declare function notePrewarmError(status: number, error: unknown): void;
  */
 export declare function selectPrewarmPaths(all: string[], limit: number, rotate?: boolean): string[];
 /**
- * @param {{ origin: string, quiet?: boolean, paths?: string[] }} options
+ * @param {{ origin: string, quiet?: boolean, paths?: string[],
+ *   forwardedHost?: string }} options
  *   `paths` verilirse hook çağrılmaz, yalnızca o yollar ısıtılır (dev
- *   panelindeki "tekrar dene" bunu kullanır).
+ *   panelindeki "tekrar dene" bunu kullanır). `forwardedHost` loopback
+ *   isteğine public host'u taşır; cache anahtarı `h=127.0.0.1` olmasın.
  * @returns {Promise<{ ok: number, failed: number, total: number, elapsed: number }>}
  */
-export declare function prewarm({ origin, quiet, paths: only }: {
+export declare function prewarm({ origin, quiet, paths: only, forwardedHost }: {
     origin: string;
     quiet?: boolean;
     paths?: string[];
+    forwardedHost?: string;
 }): Promise<{
     ok: number;
     failed: number;