veryfront 0.1.49 → 0.1.51

package/esm/src/rendering/renderer.js

@@ -32,7 +32,7 @@
 import * as dntShim from "../../_dnt.shims.js";
 import { rendererLogger } from "../utils/index.js";
 import { MDXCacheAdapter } from "../transforms/mdx/index.js";
-import { SERVICE_OVERLOADED } from "../errors/error-registry.js";
+import { INITIALIZATION_ERROR, SERVICE_OVERLOADED } from "../errors/error-registry.js";
 import { withSpan } from "../observability/tracing/otlp-setup.js";
 import { buildQueryAwareCacheKey } from "../cache/keys.js";
 import { getEnvNumber } from "../platform/compat/process.js";
@@ -55,7 +55,9 @@ const logger = rendererLogger.component("renderer");
  * Configurable via RENDER_TIMEOUT_MS env var for cold-start scenarios.
  * Default increased to 60s to handle cold-start module transforms.
  */
-const RENDER_PIPELINE_TIMEOUT_MS = getEnvNumber("RENDER_TIMEOUT_MS") ?? 60000;
+const DEFAULT_RENDER_PIPELINE_TIMEOUT_MS = 60_000;
+const RENDER_PIPELINE_TIMEOUT_MS = getEnvNumber("RENDER_TIMEOUT_MS") ??
+    DEFAULT_RENDER_PIPELINE_TIMEOUT_MS;
 /**
  * Renderer - Shared renderer for all projects
  *
@@ -110,7 +112,9 @@ export class Renderer {
     renderPage(slug, ctx, options) {
         return withSpan("renderer.renderPage", async () => {
             if (!this.initialized) {
-                throw new Error("Renderer not initialized. Call initialize() first.");
+                throw INITIALIZATION_ERROR.create({
+                    detail: "Renderer not initialized. Call initialize() first.",
+                });
             }
             const startTime = performance.now();
             logger.debug("Rendering page", {
@@ -279,7 +283,9 @@ export class Renderer {
     }
     resolvePageData(slug, ctx, options) {
         if (!this.initialized) {
-            throw new Error("Renderer not initialized. Call initialize() first.");
+            throw INITIALIZATION_ERROR.create({
+                detail: "Renderer not initialized. Call initialize() first.",
+            });
         }
         const services = this.createServicesForContext(ctx);
         return services.pipeline.resolvePageData(slug, {
@@ -292,7 +298,9 @@ export class Renderer {
     }
     getAllPages(ctx) {
         if (!this.initialized) {
-            throw new Error("Renderer not initialized. Call initialize() first.");
+            throw INITIALIZATION_ERROR.create({
+                detail: "Renderer not initialized. Call initialize() first.",
+            });
         }
         return createPageResolver(ctx).getAllPages();
     }
@@ -303,15 +311,6 @@ export class Renderer {
         }
         await this.cache.clearForContext(ctx);
     }
-    /**
-     * Clear all cached render results (across all contexts).
-     * Called by poke/invalidation handlers to ensure fresh renders.
-     * @deprecated Use clearCacheForProject for multi-tenant deployments
-     */
-    async clearAllCaches() {
-        logger.debug("Clearing ALL render caches (global)");
-        await this.cache.clearAll();
-    }
     async clearCacheForProject(projectId) {
         logger.debug("Clearing render cache for project", { projectId });
         await this.cache.clearForProject(projectId);
@@ -403,7 +402,9 @@ export { createRenderContext, createRenderContextFromEnriched, };
 let renderer = null;
 export function getRenderer() {
     if (!renderer) {
-        throw new Error("Renderer not initialized. Call initializeRenderer() first.");
+        throw INITIALIZATION_ERROR.create({
+            detail: "Renderer not initialized. Call initializeRenderer() first.",
+        });
     }
     return renderer;
 }
@@ -423,19 +424,6 @@ export async function destroyRenderer() {
     await renderer.destroy();
     renderer = null;
 }
-/**
- * Clear all cached render results from the singleton renderer.
- * Safe to call even if renderer is not initialized (no-op).
- * @deprecated Use clearRendererCacheForProject for multi-tenant deployments
- */
-export async function clearRendererCaches() {
-    logger.debug("clearRendererCaches called (global)", { hasRenderer: !!renderer });
-    if (!renderer) {
-        logger.debug("No renderer instance, skipping cache clear");
-        return;
-    }
-    await renderer.clearAllCaches();
-}
 export async function clearRendererCacheForProject(projectId) {
     logger.debug("clearRendererCacheForProject called", {
         projectId,

package/esm/src/rendering/router-detection.d.ts

@@ -17,10 +17,19 @@ export declare function clearRouterDetectionCache(): void;
 /**
  * Clear the router detection cache for a specific project.
  * Use this in multi-tenant deployments to avoid clearing other projects' caches.
+ *
+ * @param projectId - The project ID used as cache key. Falls back to projectDir for local dev.
  */
-export declare function clearRouterDetectionCacheForProject(projectDir: string): void;
+export declare function clearRouterDetectionCacheForProject(projectId: string): void;
+export interface DetectAppRouterOptions {
+    /** Project ID for cache isolation in multi-tenant deployments */
+    projectId?: string;
+}
 /**
- * Detect if app router should be used based on config and directory structure
+ * Detect if app router should be used based on config and directory structure.
+ *
+ * In multi-tenant proxy mode, `projectDir` is the same for all projects ("/app"),
+ * so the cache key must use `projectId` to avoid cross-project cache poisoning.
  */
-export declare function detectAppRouter(projectDir: string, config: VeryfrontConfig, adapter: RuntimeAdapter): Promise<boolean>;
+export declare function detectAppRouter(projectDir: string, config: VeryfrontConfig, adapter: RuntimeAdapter, options?: DetectAppRouterOptions): Promise<boolean>;
 //# sourceMappingURL=router-detection.d.ts.map

package/esm/src/rendering/router-detection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router-detection.d.ts","sourceRoot":"","sources":["../../../src/src/rendering/router-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;4BAO4B;AAI5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAM1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAO5D;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED;;;GAGG;AACH,wBAAgB,mCAAmC,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAE5E;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,OAAO,CAAC,CAmBlB"}
+{"version":3,"file":"router-detection.d.ts","sourceRoot":"","sources":["../../../src/src/rendering/router-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;4BAO4B;AAK5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAQ1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAY5D;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED;;;;;GAKG;AACH,wBAAgB,mCAAmC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAE3E;AAED,MAAM,WAAW,sBAAsB;IACrC,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,OAAO,CAAC,CA6BlB"}

package/esm/src/rendering/router-detection.js

@@ -8,15 +8,20 @@
  **************************/
 import { join } from "../platform/compat/path/index.js";
 import { createFileSystem } from "../platform/compat/fs.js";
+import { rendererLogger } from "../utils/index.js";
 import { LRUCache } from "../utils/lru-wrapper.js";
 import { withSpan } from "../observability/tracing/otlp-setup.js";
 import { SpanNames } from "../observability/tracing/span-names.js";
+const logger = rendererLogger.component("router-detection");
 // Re-export from app-route-resolver for backward compatibility
 export { getAppRouteEntity } from "./app-route-resolver.js";
+const ROUTER_DETECTION_CACHE_MAX_ENTRIES = 200;
+const ROUTER_DETECTION_CACHE_TTL_MS = 60_000;
 const routerDetectionCache = new LRUCache({
-    maxEntries: 200,
-    ttlMs: 60_000,
+    maxEntries: ROUTER_DETECTION_CACHE_MAX_ENTRIES,
+    ttlMs: ROUTER_DETECTION_CACHE_TTL_MS,
 });
+let warnedMissingProjectId = false;
 /**
  * Clear the router detection cache. Call when filesystem changes.
  * @deprecated Use clearRouterDetectionCacheForProject for multi-tenant deployments
@@ -27,27 +32,38 @@ export function clearRouterDetectionCache() {
 /**
  * Clear the router detection cache for a specific project.
  * Use this in multi-tenant deployments to avoid clearing other projects' caches.
+ *
+ * @param projectId - The project ID used as cache key. Falls back to projectDir for local dev.
  */
-export function clearRouterDetectionCacheForProject(projectDir) {
-    routerDetectionCache.delete(projectDir);
+export function clearRouterDetectionCacheForProject(projectId) {
+    routerDetectionCache.delete(projectId);
 }
 /**
- * Detect if app router should be used based on config and directory structure
+ * Detect if app router should be used based on config and directory structure.
+ *
+ * In multi-tenant proxy mode, `projectDir` is the same for all projects ("/app"),
+ * so the cache key must use `projectId` to avoid cross-project cache poisoning.
  */
-export async function detectAppRouter(projectDir, config, adapter) {
+export async function detectAppRouter(projectDir, config, adapter, options) {
     if (config?.router === "app")
         return true;
     if (config?.router === "pages")
         return false;
-    const cached = routerDetectionCache.get(projectDir);
+    const cacheKey = options?.projectId ?? projectDir;
+    const cached = routerDetectionCache.get(cacheKey);
     if (cached !== undefined)
         return cached;
+    if (!options?.projectId && config?.fs?.type === "veryfront-api" && !warnedMissingProjectId) {
+        warnedMissingProjectId = true;
+        logger.warn("detectAppRouter called without projectId in multi-tenant mode — cache key falls back to projectDir which may cause cross-tenant poisoning", { projectDir });
+    }
     return await withSpan(SpanNames.ROUTER_DETECT_APP, async () => {
         const result = await detectAppRouterImpl(projectDir, config, adapter);
-        routerDetectionCache.set(projectDir, result);
+        routerDetectionCache.set(cacheKey, result);
         return result;
     }, {
         "router.project_dir": projectDir,
+        "router.cache_key": cacheKey,
         "router.config_router": config?.router ?? "auto",
     });
 }
@@ -94,11 +110,13 @@ async function withAdapterFallback(adapterFn, fallbackFn, defaultValue) {
     try {
         return await adapterFn();
     }
-    catch {
+    catch (_) {
+        /* expected: adapter may not support this operation */
         try {
             return await fallbackFn();
         }
-        catch {
+        catch (_) {
+            /* expected: fallback may also fail */
             return defaultValue;
         }
     }

package/esm/src/rendering/rsc/client-boot.ts

@@ -154,7 +154,7 @@ if (typeof document !== "undefined") {
   };
 
   if (document.readyState === "loading") {
-    document.addEventListener("DOMContentLoaded", run);
+    document.addEventListener("DOMContentLoaded", run, { once: true });
   } else {
     run();
   }

package/esm/src/rendering/rsc/client-dom.ts

@@ -2,7 +2,7 @@ import { validateTrustedHtml } from "#veryfront/security/client/html-sanitizer.t
 import { rscLogger } from "../client/browser-logger.ts";
 import { RSC_ROOT_ID } from "./constants.ts";
 
-export type SlotMessage = { type: "slot"; id: string; html: string };
+type SlotMessage = { type: "slot"; id: string; html: string };
 
 export function getContainer(doc: Document, id: string): HTMLElement {
   const elementId = id === "root" ? RSC_ROOT_ID : `rsc-slot-${id}`;
@@ -16,7 +16,7 @@ export function getContainer(doc: Document, id: string): HTMLElement {
   return el;
 }
 
-export function applySlotMessage(doc: Document, msg: SlotMessage): void {
+function applySlotMessage(doc: Document, msg: SlotMessage): void {
   if (msg.type !== "slot") return;
 
   const el = getContainer(doc, msg.id);
@@ -24,7 +24,7 @@ export function applySlotMessage(doc: Document, msg: SlotMessage): void {
   el.innerHTML = validateTrustedHtml(String(msg.html ?? ""));
 }
 
-export function processNdjsonChunk(doc: Document, buffered: string): string {
+function processNdjsonChunk(doc: Document, buffered: string): string {
   const parts = buffered.split("\n");
   const remainder = parts.pop() ?? "";
 
@@ -32,9 +32,9 @@ export function processNdjsonChunk(doc: Document, buffered: string): string {
     const s = line.trim();
     if (!s) continue;
 
-    let msg: SlotMessage;
+    let parsed: unknown;
     try {
-      msg = JSON.parse(s) as SlotMessage;
+      parsed = JSON.parse(s);
     } catch (e) {
       rscLogger.debug("[client-dom] malformed NDJSON line", {
         line: s,
@@ -43,6 +43,8 @@ export function processNdjsonChunk(doc: Document, buffered: string): string {
       continue;
     }
 
+    if (!parsed || typeof parsed !== "object") continue;
+    const msg = parsed as SlotMessage;
     if (msg.type !== "slot") continue;
 
     applySlotMessage(doc, msg);
@@ -56,10 +58,6 @@ export function processNdjsonChunk(doc: Document, buffered: string): string {
   return remainder;
 }
 
-export function processNdjsonLines(doc: Document, ndjson: string): void {
-  processNdjsonChunk(doc, ndjson.endsWith("\n") ? ndjson : `${ndjson}\n`);
-}
-
 function createAbortPromise(signal: AbortSignal): Promise<never> {
   return new Promise<never>((_, reject) => {
     const abort = (): void => reject(new DOMException("aborted", "AbortError"));
@@ -141,7 +139,7 @@ export async function consumeNdjsonStream(
   }
 }
 
-export function findClientBoundaries(doc: Document, slotId: string): HTMLElement[] {
+function findClientBoundaries(doc: Document, slotId: string): HTMLElement[] {
   const root = getContainer(doc, slotId);
   const out: HTMLElement[] = [];
 
@@ -155,7 +153,7 @@ export function findClientBoundaries(doc: Document, slotId: string): HTMLElement
   return out;
 }
 
-export function hydrateClientBoundaries(doc: Document, slotId: string): void {
+function hydrateClientBoundaries(doc: Document, slotId: string): void {
   const nodes = findClientBoundaries(doc, slotId);
 
   for (const el of nodes) {

package/esm/src/rendering/rsc/client-hydrator.ts

@@ -16,7 +16,7 @@ interface WindowWithVeryfront extends Window {
 }
 
 export class RSCHydrator {
-  private componentCache = new Map<string, React.ComponentType<any>>();
+  private componentCache = new Map<string, React.ComponentType<Record<string, unknown>>>();
   private manifestUrl: string;
   private manifest: Record<string, string> | null = null;
   private onError?: (error: Error) => void;
@@ -59,7 +59,7 @@ export class RSCHydrator {
     const instanceId = element.dataset.rscId;
 
     try {
-      const props = propsJson ? JSON.parse(propsJson) : {};
+      const props: Record<string, unknown> = propsJson ? JSON.parse(propsJson) : {};
       const Component = await this.loadClientComponent(componentName);
       const reactElement = React.createElement(Component, props);
 
@@ -91,7 +91,9 @@ export class RSCHydrator {
     }
   }
 
-  private async loadClientComponent(name: string): Promise<React.ComponentType<any>> {
+  private async loadClientComponent(
+    name: string,
+  ): Promise<React.ComponentType<Record<string, unknown>>> {
     const cached = this.componentCache.get(name);
     if (cached) return cached;
 
@@ -122,8 +124,9 @@ export class RSCHydrator {
         });
       }
 
-      this.componentCache.set(name, Component);
-      return Component;
+      const validated = Component as React.ComponentType<Record<string, unknown>>;
+      this.componentCache.set(name, validated);
+      return validated;
     } catch (error) {
       rscLogger.error(`Failed to load component ${name}:`, error);
       if (
@@ -162,8 +165,8 @@ export class RSCHydrator {
         });
       }
 
-      const data = await response.json();
-      this.manifest = data.components || data;
+      const data: Record<string, unknown> = await response.json();
+      this.manifest = (data.components || data) as Record<string, string>;
 
       rscLogger.debug("Loaded manifest:", this.manifest);
     } catch (error) {
@@ -195,7 +198,7 @@ function autoHydrate(): void {
   };
 
   if (document.readyState === "loading") {
-    document.addEventListener("DOMContentLoaded", run);
+    document.addEventListener("DOMContentLoaded", run, { once: true });
     return;
   }
 

package/esm/src/rendering/rsc/hydrate-client.ts

@@ -51,7 +51,7 @@ function setClientModCache(key: string, mod: ClientModule): void {
   globalThis.__VF_CLIENT_MOD_CACHE.set(key, mod);
 }
 
-export function parseClientRef(ref: string): { rel: string; exportName: string } | null {
+function parseClientRef(ref: string): { rel: string; exportName: string } | null {
   const m = ref.match(/^\/app\/(.+)#([A-Za-z0-9_]+)$/);
   if (!m) return null;
   return { rel: `/${m[1] || ""}`, exportName: m[2] || "default" };
@@ -64,7 +64,8 @@ async function fetchManifest(): Promise<Manifest | null> {
     const res = await fetch("/_veryfront/rsc/manifest");
     if (!res.ok) return null;
     return (await res.json()) as Manifest;
-  } catch {
+  } catch (_) {
+    /* expected: manifest fetch may fail when RSC is not configured */
     return null;
   }
 }

package/esm/src/rendering/rsc/server-renderer/component-detector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component-detector.d.ts","sourceRoot":"","sources":["../../../../../src/src/rendering/rsc/server-renderer/component-detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AACpC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG;IACpD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,YAAY,EACvB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAC/C,OAAO,CAWT;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,YAAY,GAAG,MAAM,CAE9D;AAED,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,YAAY,EACvB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAChD,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,IAAI,CAQN"}
+{"version":3,"file":"component-detector.d.ts","sourceRoot":"","sources":["../../../../../src/src/rendering/rsc/server-renderer/component-detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AACpC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGvD,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG;IACpD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,YAAY,EACvB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAC/C,OAAO,CAWT;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,YAAY,GAAG,MAAM,CAE9D;AAED,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,YAAY,EACvB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAChD,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,IAAI,CAQN"}

package/esm/src/rendering/rsc/server-renderer/prop-serializer.js

@@ -55,7 +55,8 @@ function isSerializable(value, seen = new WeakSet()) {
         }
         return true;
     }
-    catch {
+    catch (_) {
+        /* expected: object may have non-enumerable or throwing getters */
         return false;
     }
 }

package/esm/src/rendering/rsc/server-renderer/rsc-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rsc-renderer.d.ts","sourceRoot":"","sources":["../../../../../src/src/rendering/rsc/server-renderer/rsc-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAGpC,OAAO,KAAK,EAAuB,UAAU,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAMvF,qBAAa,WAAW;IACtB,OAAO,CAAC,cAAc,CAAmC;IACzD,OAAO,CAAC,IAAI,CAA+B;IAC3C,OAAO,CAAC,UAAU,CAA6B;gBAEnC,OAAO,EAAE,kBAAkB;IAKvC,eAAe,CACb,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,YAAY,EACxD,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAClC,OAAO,CAAC,UAAU,CAAC;CAuBvB"}
+{"version":3,"file":"rsc-renderer.d.ts","sourceRoot":"","sources":["../../../../../src/src/rendering/rsc/server-renderer/rsc-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAGpC,OAAO,KAAK,EAAuB,UAAU,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAMvF,qBAAa,WAAW;IACtB,OAAO,CAAC,cAAc,CAAmC;IACzD,OAAO,CAAC,IAAI,CAA+B;IAC3C,OAAO,CAAC,UAAU,CAA6B;gBAEnC,OAAO,EAAE,kBAAkB;IAKvC,eAAe,CAEb,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,YAAY,EACxD,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAClC,OAAO,CAAC,UAAU,CAAC;CAuBvB"}

package/esm/src/rendering/rsc/server-renderer/rsc-renderer.js

@@ -11,7 +11,9 @@ export class RSCRenderer {
         this.clientManifest = options.clientManifest;
         this.mode = options.mode ?? "development";
     }
-    renderToPayload(Component, props = {}) {
+    renderToPayload(
+    // deno-lint-ignore no-explicit-any -- RSC components accept arbitrary props at runtime
+    Component, props = {}) {
         return withSpan("rsc.renderToPayload", async () => {
             this.clientRefs.clear();
             try {

package/esm/src/rendering/rsc/server-renderer/tree-processor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tree-processor.d.ts","sourceRoot":"","sources":["../../../../../src/src/rendering/rsc/server-renderer/tree-processor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAYhE,wDAAwD;AACxD,wBAAsB,UAAU,CAC9B,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAC7F,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAChD,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC,CAuClB;AAED,6DAA6D;AAC7D,wBAAsB,cAAc,CAClC,OAAO,EAAE,KAAK,CAAC,YAAY,EAC3B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAChD,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC,CAuClB;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,KAAK,CAAC,SAAS,EACzB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAChD,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,OAAO,CAAC,OAAO,EAAE,CAAC,CAYpB"}
+{"version":3,"file":"tree-processor.d.ts","sourceRoot":"","sources":["../../../../../src/src/rendering/rsc/server-renderer/tree-processor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAYhE,wDAAwD;AACxD,wBAAsB,UAAU,CAE9B,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAC7F,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAChD,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC,CAuClB;AAED,6DAA6D;AAC7D,wBAAsB,cAAc,CAClC,OAAO,EAAE,KAAK,CAAC,YAAY,EAC3B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAChD,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC,CAuClB;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,KAAK,CAAC,SAAS,EACzB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAChD,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,OAAO,CAAC,OAAO,EAAE,CAAC,CAYpB"}

package/esm/src/rendering/rsc/server-renderer/tree-processor.js

@@ -6,7 +6,9 @@ import { renderAttributes, treeToHTML } from "./html-generator.js";
 import { serializeProps } from "./prop-serializer.js";
 const logger = serverLogger.component("rsc");
 /** Recursively renders a component tree to RSC nodes */
-export async function renderTree(Component, props, clientManifest, clientRefs) {
+export async function renderTree(
+// deno-lint-ignore no-explicit-any -- RSC components accept arbitrary props at runtime
+Component, props, clientManifest, clientRefs) {
     if (Component == null || typeof Component === "string" || typeof Component === "number") {
         return { type: "html", html: Component == null ? "" : String(Component) };
     }

package/esm/src/rendering/script-page-handling.js

@@ -194,11 +194,12 @@ async function readFileWithFallback(adapter, modulePath, normalizedPath) {
     try {
         return await adapter.fs.readFile(modulePath);
     }
-    catch {
+    catch (_) {
+        /* expected: original path may not exist, try normalized path */
         try {
             return await adapter.fs.readFile(normalizedPath);
         }
-        catch {
+        catch (_) {
             throw toError(createError({
                 type: "file",
                 message: `Script file not found: ${modulePath} (tried: ${normalizedPath})`,

package/esm/src/rendering/shared/context-aware-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-aware-cache.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/shared/context-aware-cache.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAoB,KAAK,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAC1F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAKlE,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,uBAAuB,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAUD,MAAM,WAAW,6BAA6B;IAC5C,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,qBAAa,4BAA4B;IACvC,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiB;gBAElC,OAAO,GAAE,wBAA6B;IASlD,UAAU,CACR,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,aAAa,EAClB,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,EAC9B,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,6BAA6B,CAAC;IAqDnC,aAAa,CACjB,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,aAAa,EAClB,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,EAC9B,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,IAAI,CAAC;IAqBV,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BlD,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBjD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B1D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAKzB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAS5B,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,WAAW;CAkCpB"}
+{"version":3,"file":"context-aware-cache.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/shared/context-aware-cache.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAoB,KAAK,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAC1F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAUlE,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,uBAAuB,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAUD,MAAM,WAAW,6BAA6B;IAC5C,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,qBAAa,4BAA4B;IACvC,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwB;gBAEzC,OAAO,GAAE,wBAA6B;IASlD,UAAU,CACR,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,aAAa,EAClB,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,EAC9B,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,6BAA6B,CAAC;IAqDnC,aAAa,CACjB,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,aAAa,EAClB,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,EAC9B,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,IAAI,CAAC;IAqBV,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BlD,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBjD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B1D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAKzB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAS5B,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,WAAW;CAkCpB"}

package/esm/src/rendering/shared/context-aware-cache.js

@@ -4,15 +4,19 @@ import { SpanNames } from "../../observability/tracing/span-names.js";
 import { MemoryCacheStore } from "../cache/stores/index.js";
 import { createCacheKey } from "../context/render-context.js";
 const logger = rendererLogger.component("context-aware-cache");
+/** Default TTL for context-aware cache entries (5 minutes) */
+const DEFAULT_CACHE_TTL_MS = 5 * 60 * 1_000;
+/** Default max entries for the in-memory cache store */
+const DEFAULT_MAX_ENTRIES = 500;
 export class ContextAwareCacheCoordinator {
     store;
     ttlMs;
-    defaultTtlMs = 5 * 60 * 1000; // 5 minutes
+    defaultTtlMs = DEFAULT_CACHE_TTL_MS;
     constructor(options = {}) {
         this.ttlMs = options.ttlMs ?? this.defaultTtlMs;
         this.store = options.store ??
             new MemoryCacheStore({
-                maxEntries: options.memory?.maxEntries ?? 500,
+                maxEntries: options.memory?.maxEntries ?? DEFAULT_MAX_ENTRIES,
                 ttlMs: options.memory?.ttlMs ?? this.ttlMs,
             });
     }

package/esm/src/rendering/shared/shared-services.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared-services.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/shared/shared-services.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,EAAE,gBAAgB,EAA0B,MAAM,+BAA+B,CAAC;AACzF,OAAO,EAAE,KAAK,kBAAkB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAI/F,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,eAAe,EAAE,eAAe,CAAC;CAClC;AAKD,wBAAsB,wBAAwB,CAC5C,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,cAAc,CAAC,CA8CzB;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAKlD;AAED,wBAAgB,4BAA4B,IAAI,OAAO,CAEtD;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI,CAExE;AAED,wBAAgB,mBAAmB,IAAI,kBAAkB,CAExD;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C"}
+{"version":3,"file":"shared-services.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/shared/shared-services.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,OAAO,EAAE,gBAAgB,EAA0B,MAAM,+BAA+B,CAAC;AACzF,OAAO,EAAE,KAAK,kBAAkB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAI/F,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,eAAe,EAAE,eAAe,CAAC;CAClC;AAKD,wBAAsB,wBAAwB,CAC5C,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,cAAc,CAAC,CA8CzB;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAOlD;AAED,wBAAgB,4BAA4B,IAAI,OAAO,CAEtD;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI,CAExE;AAED,wBAAgB,mBAAmB,IAAI,kBAAkB,CAExD;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C"}

package/esm/src/rendering/shared/shared-services.js

@@ -11,6 +11,7 @@
  * @module rendering/shared/shared-services
  */
 import { rendererLogger } from "../../utils/index.js";
+import { INITIALIZATION_ERROR } from "../../errors/error-registry.js";
 import { initializeTransform, isUsingEsbuild } from "../../platform/compat/transform.js";
 import { withSpan } from "../../observability/tracing/otlp-setup.js";
 import { SpanNames } from "../../observability/tracing/span-names.js";
@@ -59,7 +60,9 @@ export async function initializeSharedServices(options = {}) {
 }
 export function getSharedServices() {
     if (!sharedServices) {
-        throw new Error("SharedServices not initialized. Call initializeSharedServices() first.");
+        throw INITIALIZATION_ERROR.create({
+            detail: "SharedServices not initialized. Call initializeSharedServices() first.",
+        });
     }
     return sharedServices;
 }

package/esm/src/rendering/snippet-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snippet-renderer.d.ts","sourceRoot":"","sources":["../../../src/src/rendering/snippet-renderer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAkB1D,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,aAAa,GAAG,YAAY,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AA+CD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEnE;AAED,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAsB7B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAaxC;AAED,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAyBrE;AAsBD,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAqI9B"}
+{"version":3,"file":"snippet-renderer.d.ts","sourceRoot":"","sources":["../../../src/src/rendering/snippet-renderer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAmB1D,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,aAAa,GAAG,YAAY,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAgDD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEnE;AAED,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAsB7B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAgBxC;AAED,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CA4BrE;AAuBD,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAoI9B"}