akanjs 2.2.12 → 2.2.13-rc.1

package/server/webRouter.ts

@@ -8,7 +8,7 @@ import {
   Logger,
   parseAkanI18nEnv,
 } from "akanjs/common";
-import { parseCookieHeader } from "akanjs/fetch";
+import { type AkanRequestStore, createRequestStore, parseCookieHeader } from "akanjs/fetch";
 import type { AkanMetricsReport } from "akanjs/service";
 import {
   type BuilderRpc,
@@ -17,12 +17,25 @@ import {
   RouteSeedIndexStore,
   RoutesManifestStore,
 } from "./artifact";
+import {
+  createRouteCacheEntry,
+  getClientFacingOrigin,
+  isPublicRouteCacheableRequest,
+  isRouteCachePathAllowed,
+  LruTtlCache,
+  normalizeRouteCacheTtl,
+  parsePositiveInt,
+  type RouteCacheEntry,
+  type RouteCacheRenderState,
+  resolveRouteCacheStoreTtl,
+  shouldStoreRouteCache,
+} from "./cachePolicy";
 import { DevHmrController } from "./hmr";
 import { HMR_CLIENT_SCRIPT } from "./hmr/clientScript";
 import type { HmrWsData, HmrWsHub } from "./hmr/wsHub";
 import { ImageOptimizer } from "./imageOptimizer";
 import { createDefaultRobotsTxt } from "./robots";
-import { type RscRedirectMethod, type RscRedirectStatus, RscWorker } from "./rscWorkerHost";
+import { type RscRedirectMethod, type RscRedirectStatus, type RscRenderResult, RscWorker } from "./rscWorkerHost";
 import { createDefaultSitemapXml, getSitemapBasePath } from "./sitemap";
 import { SsrFromRscRenderer } from "./ssrFromRscRenderer";
 import { createSystemPageResponse, getSystemPageHomeHref } from "./systemPages";
@@ -57,6 +70,94 @@ export function createRscStreamResponse(stream: BodyInit, status = 200): Respons
   });
 }
 
+export function createRscNotFoundFallbackResponse(): Response {
+  return createRscStreamResponse("0:null\n", 404);
+}
+
+export function cacheHtmlWhileStreaming(
+  stream: ReadableStream<Uint8Array>,
+  onComplete: (html: string) => void,
+  options: { shouldCache?: () => boolean | Promise<boolean>; maxBodyBytes?: number | null } = {},
+): ReadableStream<Uint8Array> {
+  const chunks: Uint8Array[] = [];
+  let byteLength = 0;
+  let exceededMaxBodyBytes = false;
+  const decoder = new TextDecoder();
+
+  return stream.pipeThrough(
+    new TransformStream<Uint8Array, Uint8Array>({
+      transform(chunk, controller) {
+        if (!exceededMaxBodyBytes) {
+          byteLength += chunk.byteLength;
+          if (options.maxBodyBytes && byteLength > options.maxBodyBytes) {
+            exceededMaxBodyBytes = true;
+            chunks.length = 0;
+          } else {
+            chunks.push(chunk.slice());
+          }
+        }
+        controller.enqueue(chunk);
+      },
+      async flush() {
+        if (exceededMaxBodyBytes) return;
+        const body = new Uint8Array(byteLength);
+        let offset = 0;
+        for (const chunk of chunks) {
+          body.set(chunk, offset);
+          offset += chunk.byteLength;
+        }
+        try {
+          if (options.shouldCache && !(await options.shouldCache())) return;
+          onComplete(decoder.decode(body));
+        } catch {
+        }
+      },
+    }),
+  );
+}
+
+export function cancelStreamForHeadResponse(stream: ReadableStream<Uint8Array>, reason: unknown): void {
+  void stream.cancel(reason).catch(() => {
+  });
+}
+
+export function resolveHtmlRouteCacheStoreTtl(input: {
+  baseTtl: number;
+  workerCacheState: RouteCacheRenderState;
+  hostRequestStore: AkanRequestStore;
+  lateControl?: { type: "redirect" } | null;
+}): number | null {
+  if (input.lateControl?.type === "redirect") return null;
+  const workerTtl = resolveRouteCacheStoreTtl(input.baseTtl, input.workerCacheState);
+  if (workerTtl === null) return null;
+  const hostCacheState = shouldStoreRouteCache({
+    policy: input.hostRequestStore.policy,
+    dynamicUsage: input.hostRequestStore.dynamicUsage,
+  });
+  return resolveRouteCacheStoreTtl(workerTtl, hostCacheState);
+}
+
+export function isHtmlRouteCachePathAllowed(
+  pathname: string,
+  env: {
+    [key: string]: string | undefined;
+    AKAN_HTML_RESULT_CACHE_PATHS?: string;
+    AKAN_HTML_RESULT_CACHE_EXCLUDE_PATHS?: string;
+  } = process.env as Record<string, string | undefined>,
+): boolean {
+  return isRouteCachePathAllowed(pathname, {
+    allow: env.AKAN_HTML_RESULT_CACHE_PATHS,
+    deny: env.AKAN_HTML_RESULT_CACHE_EXCLUDE_PATHS,
+  });
+}
+
+export async function createRscNavigationStreamResponse(
+  result: Extract<RscRenderResult, { type: "stream" }>,
+): Promise<Response> {
+
+  return createRscStreamResponse(result.stream, result.status ?? 200);
+}
+
 export function normalizeRscTargetUrlForHostBasePath(
   targetUrl: URL,
   options: {
@@ -107,7 +208,6 @@ interface WebRouterOptions {
 }
 
 interface CachedHtmlResult {
-  expiresAt: number;
   html: string;
 }
 
@@ -128,7 +228,9 @@ export class WebRouter {
     csr: 0,
     image: 0,
   };
-  readonly #htmlCache = new Map<string, CachedHtmlResult>();
+  readonly #htmlCache = new LruTtlCache<CachedHtmlResult>(
+    parsePositiveInt(process.env.AKAN_HTML_RESULT_CACHE_MAX_ENTRIES) ?? 100,
+  );
   #htmlCacheHits = 0;
   #htmlCacheMisses = 0;
   #htmlCacheBypass = 0;
@@ -288,13 +390,14 @@ export class WebRouter {
           });
           const result = await this.#rsc.renderWithMeta(rscReq, {
             clientManifest: manifest.clientManifest,
+            signal: req.signal,
           });
           if (result.type === "redirect")
             return createRscRedirectResponse(result.location, result.method, result.status);
           if (result.type === "not-found") return WebRouter.#rscNotFoundResponse();
           if (result.status && result.status >= 500)
             return this.#renderRscErrorResponse("__rsc", "Internal Server Error");
-          return createRscStreamResponse(result.stream, result.status ?? 200);
+          return createRscNavigationStreamResponse(result);
         } catch (err) {
           return this.#renderRscErrorResponse("__rsc", err);
         }
@@ -377,8 +480,8 @@ export class WebRouter {
         try {
           this.#requestStats.fullSsr += 1;
           const manifest = await this.#ensureRoute(url);
-          const htmlCacheKey = this.#getHtmlCacheKey(req, url);
-          const cachedHtml = htmlCacheKey ? this.#getCachedHtml(htmlCacheKey) : null;
+          const htmlCacheEntry = this.#getHtmlCacheEntry(req, url);
+          const cachedHtml = htmlCacheEntry ? this.#getCachedHtml(htmlCacheEntry.key) : null;
           if (cachedHtml) {
             return new Response(cachedHtml, {
               headers: {
@@ -389,33 +492,70 @@ export class WebRouter {
           }
           const rscResult = await this.#rsc.renderWithMeta(req, {
             clientManifest: manifest.clientManifest,
+            signal: req.signal,
           });
           if (rscResult.type === "redirect")
             return Response.redirect(new URL(rscResult.location, url.origin), rscResult.status);
           if (rscResult.type === "not-found") return this.#renderNotFoundResponse(req, url);
           const themeCookieExists = WebRouter.#hasCookie(req, "theme");
+          const hostRequestStore = createRequestStore(req);
           const htmlStream = await new SsrFromRscRenderer().render({
             request: req,
+            requestStore: hostRequestStore,
             rscStream: rscResult.stream,
             ssrManifest: manifest.ssrManifest,
             bootstrapModules: [this.#artifact.rscClientUrl],
             extraBootstrapInline: !this.#prodMode ? HMR_CLIENT_SCRIPT : undefined,
             importmap: this.#artifact.vendorMap,
             theme: themeCookieExists ? undefined : (rscResult.theme ?? "system"),
+            lateControl: rscResult.lateControl,
+            onCancel: (reason: unknown) => {
+              rscResult.cancel(reason);
+            },
           });
           const responseStatus = rscResult.status ?? 200;
           const responseHeaders = WebRouter.#htmlResponseHeaders(responseStatus);
-          if (htmlCacheKey && responseStatus === 200) {
-            const html = await new Response(htmlStream).text();
-            this.#setCachedHtml(htmlCacheKey, html);
-            return new Response(html, {
-              headers: {
-                "Content-Type": "text/html; charset=utf-8",
-                "X-Akan-Cache": "MISS",
+          if (req.method === "HEAD") {
+            const headers = new Headers(responseHeaders);
+            if (htmlCacheEntry && responseStatus === 200) headers.set("X-Akan-Cache", "MISS");
+            cancelStreamForHeadResponse(htmlStream, new Error("HEAD response does not consume body"));
+            return new Response(null, { status: responseStatus, headers });
+          }
+          if (htmlCacheEntry && responseStatus === 200) {
+            const headers = new Headers(responseHeaders);
+            headers.set("X-Akan-Cache", "MISS");
+            let htmlStoreTtl = htmlCacheEntry.ttl;
+            const shouldCacheHtml = Promise.all([rscResult.lateControl, rscResult.cacheState]).then(
+              ([control, cacheState]) => {
+                const storeTtl = resolveHtmlRouteCacheStoreTtl({
+                  baseTtl: htmlCacheEntry.ttl,
+                  workerCacheState: cacheState,
+                  hostRequestStore,
+                  lateControl: control,
+                });
+                if (storeTtl === null) return false;
+                htmlStoreTtl = storeTtl;
+                return true;
               },
-            });
+            );
+            return new Response(
+              cacheHtmlWhileStreaming(
+                htmlStream,
+                (html) => {
+                  this.#setCachedHtml(htmlCacheEntry.key, html, htmlStoreTtl);
+                },
+                {
+                  shouldCache: () => shouldCacheHtml,
+                  maxBodyBytes: parsePositiveInt(process.env.AKAN_HTML_RESULT_CACHE_MAX_BODY_BYTES),
+                },
+              ),
+              {
+                status: responseStatus,
+                headers,
+              },
+            );
           }
-          return new Response(req.method === "HEAD" ? null : htmlStream, {
+          return new Response(htmlStream, {
             status: responseStatus,
             headers: responseHeaders,
           });
@@ -452,23 +592,19 @@ export class WebRouter {
       httpHtmlCacheBypass: this.#htmlCacheBypass,
     };
   }
+
+  /** @internal Clears local route result caches owned by the host and RSC worker. */
+  invalidateRouteCaches(reason?: string): void {
+    this.#htmlCache.clear();
+    this.#rsc.invalidateRouteResultCache(reason);
+  }
+
   /**
    * Reconstruct origin as the browser saw it when behind Ingress / reverse proxies
    * (prevents `/__rsc` same-origin rejecting because `req.url` is internal).
    */
   static #clientFacingOrigin(req: Request): string {
-    const parsed = new URL(req.url);
-    const fwdProto = req.headers.get("x-forwarded-proto")?.split(",")[0]?.trim();
-    const fwdHost = req.headers.get("x-forwarded-host")?.split(",")[0]?.trim();
-    const hostFallback = fwdHost ?? req.headers.get("host");
-    const protoFallback = fwdProto ?? parsed.protocol.slice(0, -1); 
-    if (hostFallback && protoFallback) {
-      try {
-        return new URL(`${protoFallback}://${hostFallback}`).origin;
-      } catch {
-      }
-    }
-    return parsed.origin;
+    return getClientFacingOrigin(req);
   }
 
   static #basePathForRequestHost(req: Request, subRoutes: Record<string, string[]>): string | null {
@@ -495,33 +631,25 @@ export class WebRouter {
   static #hasCookie(req: Request, name: string): boolean {
     return parseCookieHeader(req.headers.get("cookie") ?? "").has(name);
   }
-  #getHtmlCacheKey(req: Request, url: URL): string | null {
+  #getHtmlCacheEntry(req: Request, url: URL): RouteCacheEntry | null {
     if (!this.#prodMode || process.env.AKAN_HTML_RESULT_CACHE !== "1") {
       this.#htmlCacheBypass += 1;
       return null;
     }
-    if (!WebRouter.#isPublicCacheableRequest(req)) {
+    if (!isPublicRouteCacheableRequest(req)) {
       this.#htmlCacheBypass += 1;
       return null;
     }
-    if (!WebRouter.#isHtmlCachePathAllowed(url.pathname)) {
+    if (!isHtmlRouteCachePathAllowed(url.pathname)) {
       this.#htmlCacheBypass += 1;
       return null;
     }
-    const ttl = WebRouter.#htmlCacheTtlSeconds();
-    if (ttl <= 0) {
+    const ttl = normalizeRouteCacheTtl(process.env.AKAN_HTML_RESULT_CACHE_TTL);
+    if (ttl === null) {
       this.#htmlCacheBypass += 1;
       return null;
     }
-    return [
-      WebRouter.#clientFacingOrigin(req),
-      req.headers.get("x-base-path") ?? "",
-      url.pathname,
-      url.search,
-      req.headers.get("accept-language") ?? "",
-      WebRouter.#cookieValue(req, "theme") ?? "",
-      ttl,
-    ].join("\n");
+    return createRouteCacheEntry({ request: req, url, theme: WebRouter.#cookieValue(req, "theme"), ttl });
   }
 
   #getCachedHtml(cacheKey: string): string | null {
@@ -530,58 +658,18 @@ export class WebRouter {
       this.#htmlCacheMisses += 1;
       return null;
     }
-    if (cached.expiresAt <= Date.now()) {
-      this.#htmlCache.delete(cacheKey);
-      this.#htmlCacheMisses += 1;
-      return null;
-    }
     this.#htmlCacheHits += 1;
     return cached.html;
   }
 
-  #setCachedHtml(cacheKey: string, html: string): void {
-    const ttl = Number.parseInt(cacheKey.split("\n").at(-1) ?? "30", 10);
-    const maxEntries = WebRouter.#positiveIntEnv("AKAN_HTML_RESULT_CACHE_MAX_ENTRIES") ?? 100;
-    while (this.#htmlCache.size >= maxEntries) {
-      const firstKey = this.#htmlCache.keys().next().value;
-      if (!firstKey) break;
-      this.#htmlCache.delete(firstKey);
-    }
-    this.#htmlCache.set(cacheKey, { html, expiresAt: Date.now() + ttl * 1000 });
+  #setCachedHtml(cacheKey: string, html: string, ttl: number): void {
+    this.#htmlCache.set(cacheKey, { html }, ttl);
   }
 
   static #cookieValue(req: Request, name: string): string | undefined {
     return parseCookieHeader(req.headers.get("cookie") ?? "").get(name)?.value;
   }
 
-  static #isPublicCacheableRequest(req: Request): boolean {
-    if (req.method !== "GET") return false;
-    if (req.headers.has("authorization")) return false;
-    const cookie = req.headers.get("cookie");
-    if (!cookie) return true;
-    return [...parseCookieHeader(cookie).keys()].every((name) => name === "theme" || name.startsWith("akan_public_"));
-  }
-
-  static #htmlCacheTtlSeconds(): number {
-    return WebRouter.#positiveIntEnv("AKAN_HTML_RESULT_CACHE_TTL") ?? 30;
-  }
-
-  static #isHtmlCachePathAllowed(pathname: string): boolean {
-    const prefixes = (process.env.AKAN_HTML_RESULT_CACHE_PATHS ?? "")
-      .split(",")
-      .map((prefix) => prefix.trim())
-      .filter(Boolean);
-    if (prefixes.length === 0) return false;
-    return prefixes.some(
-      (prefix) => pathname === prefix || pathname.startsWith(prefix.endsWith("/") ? prefix : `${prefix}/`),
-    );
-  }
-
-  static #positiveIntEnv(name: string): number | null {
-    const parsed = Number.parseInt(process.env[name] ?? "", 10);
-    return Number.isFinite(parsed) && parsed > 0 ? parsed : null;
-  }
-
   static #isImageOptimizerPath(pathname: string): boolean {
     return pathname === "/_akan/image" || pathname.endsWith("/_akan/image");
   }
@@ -675,10 +763,7 @@ export class WebRouter {
     return `${html.slice(0, last.index)}${snippet}\n${html.slice(last.index)}`;
   }
   static #rscNotFoundResponse(): Response {
-    return new Response("Not Found", {
-      status: 404,
-      headers: { "Content-Type": "text/plain; charset=utf-8", "Cache-Control": "no-store" },
-    });
+    return createRscNotFoundFallbackResponse();
   }
   #getProductionRouteCache() {
     return new RouteClientCache({

package/service/ipcTypes.ts

@@ -57,6 +57,7 @@ export interface AkanMetricsReport {
   rscWorkerLastRecycleReason?: string;
   rscPendingRenderCount?: number;
   rscQueuedSendCount?: number;
+  rscHostPendingChunkOverflowCount?: number;
   rscRenderCount?: number;
   rscInFlightRenderCount?: number;
   rscLastRenderedPath?: string;

package/types/client/csrTypes.d.ts

@@ -5,7 +5,7 @@ import type { AnimatedComponent, AnimatedProps, Interpolation, SpringValue } fro
 import type { RouterInstance } from "./router.d.ts";
 import type { ReactFont } from "./types.d.ts";
 export type TransitionType = "none" | "fade" | "bottomUp" | "stack" | "scaleOut";
-/** Per-page CSR configuration for transition, safe-area, gesture, and cache behavior. */
+/** Per-page CSR configuration for transition, safe-area, and gesture behavior. */
 export interface PageConfig {
     transition?: TransitionType;
     safeArea?: boolean | "top" | "bottom";
@@ -16,8 +16,6 @@ export interface PageConfig {
     bottomInset?: boolean | number;
     gesture?: boolean;
     cache?: boolean;
-    rscCache?: "public" | false;
-    rscCacheTtl?: number;
     topSafeAreaColor?: string;
     bottomSafeAreaColor?: string;
 }
@@ -63,7 +61,12 @@ export interface LayoutErrorProps extends LayoutNotFoundProps {
 }
 export type Head = ReactNode;
 export type GenerateHead = (props: PageProps) => PromiseOrObject<Head | null | undefined>;
-export type ResolveHead = (props: PageProps) => PromiseOrObject<Head | null | undefined>;
+export interface ResolvedHead {
+    node: Head | null | undefined;
+    hasExplicitLanguageAlternates: boolean;
+}
+export type ResolveHeadResult = Head | ResolvedHead | null | undefined;
+export type ResolveHead = (props: PageProps) => PromiseOrObject<ResolveHeadResult>;
 export type HeadProps = PageProps;
 export type PageRender = (props: PageProps) => PromiseOrObject<ReactNode>;
 export type LayoutRender = (props: LayoutProps) => PromiseOrObject<ReactNode>;
@@ -107,17 +110,45 @@ export interface WebAppManifest {
     screenshots?: WebAppManifestIcon[];
     [key: string]: unknown;
 }
+export interface AkanMetadata {
+    title?: string;
+    description?: string;
+    robots?: string;
+    openGraph?: {
+        title?: string;
+        description?: string;
+        type?: string;
+        url?: string;
+        siteName?: string;
+        images?: string | string[];
+    };
+    twitter?: {
+        card?: "summary" | "summary_large_image" | "app" | "player" | (string & {});
+        title?: string;
+        description?: string;
+        images?: string | string[];
+    };
+    alternates?: {
+        canonical?: string;
+        languages?: Record<string, string>;
+    };
+}
+export type GenerateMetadata = (props: PageProps) => PromiseOrObject<AkanMetadata | null | undefined>;
 export interface PageModule {
     default?: PageRender;
     pageConfig?: PageConfig;
     head?: Head;
+    metadata?: AkanMetadata;
     generateHead?: GenerateHead;
+    generateMetadata?: GenerateMetadata;
     Loading?: PageLoadingRender;
 }
 export interface LayoutModule {
     default?: LayoutRender;
     head?: Head;
+    metadata?: AkanMetadata;
     generateHead?: GenerateHead;
+    generateMetadata?: GenerateMetadata;
     fonts?: ReactFont[];
     manifest?: WebAppManifest;
     theme?: string;
@@ -137,7 +168,7 @@ export interface Route {
     renderLayout?: RouteRender;
     pageIncludesOwnLayout?: boolean;
     isSpecialRoute?: boolean;
-    loader?: () => any;
+    loader?: () => unknown;
     pageState?: PageState;
     children: Map<string, Route>;
 }
@@ -218,7 +249,7 @@ export interface RouteState {
     pathRoutes: PathRoute[];
 }
 export type UseCsrTransition = CsrTransitionStyles & {
-    pageBind: (...args: any[]) => ReactDOMAttributes;
+    pageBind: (...args: unknown[]) => ReactDOMAttributes;
     pageClassName: string;
     transDirection: "vertical" | "horizontal" | "none";
     transUnitRange: number[];

package/types/dictionary/base.dictionary.d.ts

@@ -1 +1 @@
-export declare const baseDictionary: import("./dictInfo.d.ts").ServiceDictInfo<[string, string], string, never, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "failed" | "success" | "edit" | "view" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "new">;
+export declare const baseDictionary: import("./dictInfo.d.ts").ServiceDictInfo<[string, string], string, never, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "failed" | "cancel" | "success" | "edit" | "view" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "new">;

package/types/dictionary/dictionary.d.ts

@@ -1,11 +1,11 @@
 import type { BaseEndpoint } from "akanjs/signal";
 export declare const dictionary: {
-    base: import("./locale.d.ts").DictModule<import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "failed" | "success" | "edit" | "view" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "new">, never>;
+    base: import("./locale.d.ts").DictModule<import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "failed" | "cancel" | "success" | "edit" | "view" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "new">, never>;
 };
-export declare const Err: import("./trans.d.ts").ErrConstructor<never>, translate: (lang: "en" | "ko" | "zhChs" | "zhCht" | "ja", key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "failed" | "success" | "edit" | "view" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "new">, data?: import("./trans.d.ts").TranslationData) => string, msg: {
-    info: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "failed" | "success" | "edit" | "view" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "new">, option?: import("./trans.d.ts").TransMessageOption) => void;
-    success: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "failed" | "success" | "edit" | "view" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "new">, option?: import("./trans.d.ts").TransMessageOption) => void;
-    error: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "failed" | "success" | "edit" | "view" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "new">, option?: import("./trans.d.ts").TransMessageOption) => void;
-    warning: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "failed" | "success" | "edit" | "view" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "new">, option?: import("./trans.d.ts").TransMessageOption) => void;
-    loading: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "failed" | "success" | "edit" | "view" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "new">, option?: import("./trans.d.ts").TransMessageOption) => void;
-}, getDictionary: (lang: "en" | "ko" | "zhChs" | "zhCht" | "ja") => object, getAllDictionary: () => import("./trans.d.ts").RootDictionary, __Dict_Key__: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "failed" | "success" | "edit" | "view" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "new">, __Error_Key__: never;
+export declare const Err: import("./trans.d.ts").ErrConstructor<never>, translate: (lang: "en" | "ko" | "zhChs" | "zhCht" | "ja", key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "failed" | "cancel" | "success" | "edit" | "view" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "new">, data?: import("./trans.d.ts").TranslationData) => string, msg: {
+    info: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "failed" | "cancel" | "success" | "edit" | "view" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "new">, option?: import("./trans.d.ts").TransMessageOption) => void;
+    success: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "failed" | "cancel" | "success" | "edit" | "view" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "new">, option?: import("./trans.d.ts").TransMessageOption) => void;
+    error: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "failed" | "cancel" | "success" | "edit" | "view" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "new">, option?: import("./trans.d.ts").TransMessageOption) => void;
+    warning: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "failed" | "cancel" | "success" | "edit" | "view" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "new">, option?: import("./trans.d.ts").TransMessageOption) => void;
+    loading: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "failed" | "cancel" | "success" | "edit" | "view" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "new">, option?: import("./trans.d.ts").TransMessageOption) => void;
+}, getDictionary: (lang: "en" | "ko" | "zhChs" | "zhCht" | "ja") => object, getAllDictionary: () => import("./trans.d.ts").RootDictionary, __Dict_Key__: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "failed" | "cancel" | "success" | "edit" | "view" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "new">, __Error_Key__: never;

package/types/fetch/requestStorage.d.ts

@@ -1,8 +1,6 @@
 export type AkanTheme = "css" | "system" | (string & {});
 export interface AkanRequestPolicy {
     routeId?: string;
-    rscCache?: "public" | false;
-    rscCacheTtl?: number;
     cacheable?: boolean;
     revalidate?: number | false;
     tags: Set<string>;
@@ -31,11 +29,15 @@ export declare function createRequestStore(request: Request, policy?: Partial<Om
 /** Stores theme preference on the active request when server rendering. */
 export declare function setRequestTheme(theme: AkanTheme | undefined): void;
 export declare function getRequestTheme(): AkanTheme | undefined;
-export declare function pushRequestFallback(req: Request): () => void;
+export declare function pushRequestFallback(storeOrRequest: Request | AkanRequestStore): () => void;
 /** Returns the active server request store from AsyncLocalStorage or the fallback stack. */
 export declare function getRequestStore(): AkanRequestStore | undefined;
 /** Returns the active server request from AsyncLocalStorage or the fallback stack. */
-export declare function getRequest(): Request | undefined;
+export declare function getRequest(options?: {
+    trackDynamic?: boolean;
+}): Request | undefined;
+/** Reads the framework's active server request without marking the user route dynamic. */
+export declare function untrackedRequest(): Request | undefined;
 export declare function getRequestPolicy(): AkanRequestPolicy | undefined;
 export declare function updateRequestPolicy(patch: Partial<Omit<AkanRequestPolicy, "tags">> & {
     tags?: Iterable<string>;
@@ -44,11 +46,19 @@ export declare function getRequestDynamicUsage(): AkanDynamicUsage | undefined;
 /** Deduplicates a promise-producing query within the active request. */
 export declare function memoizeRequestQuery<T>(key: string, factory: () => Promise<T>): Promise<T>;
 /** Returns current request headers as a Map, or an empty Map outside a request. */
-export declare function headers(): Map<string, string>;
+export declare function headers(options?: {
+    trackDynamic?: boolean;
+}): Map<string, string>;
+/** Reads headers for framework internals without marking the user route dynamic. */
+export declare function untrackedHeaders(): Map<string, string>;
 export interface CookieEntry {
     name: string;
     value: string;
 }
 export declare function parseCookieHeader(cookieHeader: string): Map<string, CookieEntry>;
 /** Returns parsed cookies from the current request, or an empty Map outside a request. */
-export declare function cookies(): Map<string, CookieEntry>;
+export declare function cookies(options?: {
+    trackDynamic?: boolean;
+}): Map<string, CookieEntry>;
+/** Reads cookies for framework internals without marking the user route dynamic. */
+export declare function untrackedCookies(): Map<string, CookieEntry>;