veryfront 0.1.49 → 0.1.51

package/src/src/rendering/element-validator/primitive-checks.ts

@@ -61,7 +61,7 @@ export function getElementTypeName(element: React.ReactElement): string {
   const { type } = element;
 
   if (typeof type === "function") {
-    const componentType = type as React.ComponentType<any>;
+    const componentType = type as React.ComponentType<unknown>;
     return type.name || componentType.displayName || "<Anonymous>";
   }
 
@@ -79,7 +79,8 @@ export function getObjectKeys(obj: unknown): string[] {
 export function getObjectSample(obj: unknown): string {
   try {
     return JSON.stringify(obj, null, 2).slice(0, 500);
-  } catch {
+  } catch (_) {
+    /* expected: object may contain circular references or non-serializable values */
     return "[Unable to stringify]";
   }
 }

package/src/src/rendering/factories/service-factories.ts

@@ -11,6 +11,7 @@ import { PageRenderer } from "../page-renderer.js";
 export function createPageResolver(ctx: RenderContext): PageResolver {
   return new PageResolver({
     projectDir: ctx.projectDir,
+    projectId: ctx.projectId,
     config: ctx.config,
     adapter: ctx.adapter,
   });
@@ -22,6 +23,7 @@ export function createLayoutCollector(
 ): LayoutCollector {
   return new LayoutCollector({
     projectDir: ctx.projectDir,
+    projectId: ctx.projectId,
     adapter: ctx.adapter,
     config: ctx.config,
     compileMDX,
@@ -39,7 +41,7 @@ export function createLayoutCompiler(
 }
 
 export function createSSRRenderer(ctx: RenderContext): SSRRenderer {
-  return new SSRRenderer(ctx.mode, ctx.adapter, ctx.projectDir);
+  return new SSRRenderer(ctx.mode, ctx.adapter, ctx.projectDir, ctx.projectId);
 }
 
 export function createComponentRegistry(

package/src/src/rendering/layouts/layout-applicator.ts

@@ -89,7 +89,9 @@ export class LayoutApplicator {
           layoutDataMap,
         );
 
-        const useAppRouter = await detectAppRouter(this.projectDir, this.config, this.adapter);
+        const useAppRouter = await detectAppRouter(this.projectDir, this.config, this.adapter, {
+          projectId: this.projectId,
+        });
         const pageFilePath = pageInfo.entity.path;
 
         const isDotPath = pageFilePath
@@ -230,8 +232,7 @@ export class LayoutApplicator {
           const appSource = await this.adapter.fs.readFile(appPath);
           const isMdx = appPath.endsWith(".mdx") || appPath.endsWith(".md");
 
-          // deno-lint-ignore no-explicit-any
-          let App: any;
+          let App: BundledReact.ComponentType<Record<string, unknown>> | null;
 
           if (isMdx) {
             App = await this.loadMdxAppComponent(appSource, appPath);
@@ -270,8 +271,10 @@ export class LayoutApplicator {
     );
   }
 
-  // deno-lint-ignore no-explicit-any
-  private async loadMdxAppComponent(source: string, appPath: string): Promise<any> {
+  private async loadMdxAppComponent(
+    source: string,
+    appPath: string,
+  ): Promise<BundledReact.ComponentType<Record<string, unknown>> | null> {
     try {
       const { compile } = await import("@mdx-js/mdx");
       const { getRehypePlugins, getRemarkPlugins } = await import(

package/src/src/rendering/layouts/layout-collector.ts

@@ -9,6 +9,7 @@ import { detectAppRouter } from "../router-detection.js";
 import { LAYOUT_EXTENSIONS, type LayoutExtension } from "./types.js";
 import { withSpan } from "../../observability/tracing/otlp-setup.js";
 import { SpanNames } from "../../observability/tracing/span-names.js";
+import { LAYOUT_NOT_FOUND } from "../../errors/error-registry.js";
 
 const logger = rendererLogger.component("layout-collector");
 
@@ -65,7 +66,7 @@ export async function discoverComponentsLayoutPath(
 /**
  * Result from discovering a components layout file.
  */
-export interface ComponentsLayoutDiscoveryResult {
+interface ComponentsLayoutDiscoveryResult {
   layoutPath: string;
   extension: LayoutExtension;
 }
@@ -77,6 +78,7 @@ export interface LayoutCollectionResult {
 
 export interface LayoutCollectorOptions {
   projectDir: string;
+  projectId?: string;
   adapter: RuntimeAdapter;
   config: VeryfrontConfig;
   compileMDX: (
@@ -88,6 +90,7 @@ export interface LayoutCollectorOptions {
 
 export class LayoutCollector {
   private projectDir: string;
+  private projectId?: string;
   private adapter: RuntimeAdapter;
   private config: VeryfrontConfig;
   private compileMDX: (
@@ -98,6 +101,7 @@ export class LayoutCollector {
 
   constructor(options: LayoutCollectorOptions) {
     this.projectDir = options.projectDir;
+    this.projectId = options.projectId;
     this.adapter = options.adapter;
     this.config = options.config;
     this.compileMDX = options.compileMDX;
@@ -246,10 +250,10 @@ export class LayoutCollector {
 
     if (!layoutInfo) {
       const source = typeof layoutValue === "string" ? "frontmatter" : "config";
-      throw new Error(
-        `Layout "${layoutName}" not found. Specified in ${source} for page "${pageInfo.entity.path}". ` +
-          `Check that the layout file exists.`,
-      );
+      throw LAYOUT_NOT_FOUND.create({
+        detail:
+          `Layout "${layoutName}" not found. Specified in ${source} for page "${pageInfo.entity.path}". Check that the layout file exists.`,
+      });
     }
 
     const layoutPath = layoutInfo.entity.path;
@@ -302,7 +306,9 @@ export class LayoutCollector {
 
   private async collectNestedLayouts(pageInfo: EntityInfo): Promise<LayoutItem[]> {
     const pageFilePath = pageInfo.entity.path;
-    const useAppRouter = await detectAppRouter(this.projectDir, this.config, this.adapter);
+    const useAppRouter = await detectAppRouter(this.projectDir, this.config, this.adapter, {
+      projectId: this.projectId,
+    });
 
     // Unified path for ALL adapters - discoverNestedLayouts uses adapter.fs.stat()
     // which works for both filesystem and API adapters
@@ -364,7 +370,8 @@ export class LayoutCollector {
         try {
           const stat = await this.adapter.fs.stat(path);
           return stat.isFile;
-        } catch {
+        } catch (_) {
+          /* expected: file may not exist */
           return false;
         }
       },

package/src/src/rendering/layouts/utils/app-resolver.ts

@@ -2,6 +2,7 @@ import { join } from "../../../platform/compat/path/index.js";
 import type { RuntimeAdapter } from "../../../platform/adapters/base.js";
 import type { VeryfrontConfig } from "../../../config/index.js";
 import { rendererLogger } from "../../../utils/index.js";
+import { CONFIG_INVALID } from "../../../errors/error-registry.js";
 
 const logger = rendererLogger.component("app-resolver");
 
@@ -33,9 +34,10 @@ export async function resolveAppComponentPath(
 
   if (configApp) {
     if (!isValidComponentPath(configApp)) {
-      throw new Error(
-        `App component not found: "${configApp}". Check your veryfront.config.ts 'app' setting.`,
-      );
+      throw CONFIG_INVALID.create({
+        detail:
+          `Invalid app component path: "${configApp}". Check your veryfront.config.ts 'app' setting.`,
+      });
     }
 
     const appPath = configApp.startsWith("/") || configApp.startsWith(projectDir)
@@ -43,9 +45,10 @@ export async function resolveAppComponentPath(
       : join(projectDir, configApp);
 
     if (!(await adapter.fs.exists(appPath))) {
-      throw new Error(
-        `App component not found: "${configApp}" (resolved to "${appPath}"). Check your veryfront.config.ts 'app' setting.`,
-      );
+      throw CONFIG_INVALID.create({
+        detail:
+          `Configured app component does not exist: "${configApp}" (resolved to "${appPath}"). Check your veryfront.config.ts 'app' setting.`,
+      });
     }
 
     logger.debug("Using config.app", { path: appPath });

package/src/src/rendering/layouts/utils/component-loader.ts

@@ -133,7 +133,7 @@ export function loadMDXLayout(
         hasPreloadedImportMap: !!preloadedImportMap,
       });
 
-      const map = preloadedImportMap ?? (await preloadImportMap(projectDir, adapter));
+      const map = preloadedImportMap ?? (await preloadImportMap(projectDir, adapter, projectId));
       if (preloadedImportMap) {
         loadMdxLayoutLog.debug("Using preloaded import map", { projectSlug });
       }

package/src/src/rendering/layouts/utils/hash-calculator.ts

@@ -23,13 +23,15 @@ export async function computeDepsHash(
       const componentPath = item.componentPath;
       if (componentPath) {
         hashPromises.push(
-          adapter.fs
-            .readFile(componentPath)
-            .then((src) => computeHash(src))
-            .catch((e) => {
+          (async () => {
+            try {
+              const src = await adapter.fs.readFile(componentPath);
+              return await computeHash(src);
+            } catch (e) {
               logger.debug("reading tsx layout for dep hash failed", e as Error);
               return "";
-            }),
+            }
+          })(),
         );
         continue;
       }

package/src/src/rendering/orchestrator/css-cache.ts

@@ -10,7 +10,7 @@
 import type { CacheRepository } from "../../repositories/types.js";
 
 /** Timeout for CSS generation SSR (shorter than full SSR since it's optional) */
-export const CSS_SSR_TIMEOUT_MS = 5000;
+export const CSS_SSR_TIMEOUT_MS = 5_000;
 
 /**
  * Per-page CSS cache to avoid redundant SSR for CSS generation.
@@ -62,7 +62,7 @@ export function getCachedPageCss(cacheKey: string): string | undefined {
 }
 
 /** Cache CSS for a page - async to support injected repo */
-export async function cachePageCssAsync(cacheKey: string, css: string): Promise<void> {
+async function cachePageCssAsync(cacheKey: string, css: string): Promise<void> {
   if (injectedCssCacheRepo) {
     await injectedCssCacheRepo.set(cacheKey, css);
     return;

package/src/src/rendering/orchestrator/css-candidate-manifest.ts

@@ -25,7 +25,7 @@ interface RouteCandidateOptions {
 
 const logger = rendererLogger.component("css-candidate-manifest");
 const SOURCE_EXTENSIONS = [".tsx", ".jsx", ".mdx", ".ts", ".js"];
-const DEV_MANIFEST_TTL_MS = 2000;
+const DEV_MANIFEST_TTL_MS = 2_000;
 
 const manifestCache = new Map<string, CandidateManifest>();
 const routeCandidateCache = new Map<string, Set<string>>();

package/src/src/rendering/orchestrator/file-resolver/candidates.ts

@@ -17,8 +17,8 @@ export async function findFirstExisting(
     try {
       await statFn(fullPath);
       return fullPath;
-    } catch {
-      // ignore
+    } catch (_) {
+      /* expected: file may not exist at this candidate path */
     }
   }
   return null;

package/src/src/rendering/orchestrator/html.ts

@@ -142,7 +142,8 @@ export class HTMLGenerator {
       }
 
       return isClientPage;
-    } catch {
+    } catch (_) {
+      /* expected: file may not exist for directive detection */
       logger.debug(
         `[HTMLGenerator] Could not read page file for directive detection: ${pagePath}`,
       );
@@ -301,7 +302,8 @@ export class HTMLGenerator {
       const content = await this.config.adapter.fs.readFile(filePath);
       logger.debug(`Loaded ${filename}`, { length: content.length });
       return content;
-    } catch {
+    } catch (_) {
+      /* expected: project file may not exist */
       logger.debug(`No ${filename} found, using default`);
       return undefined;
     }
@@ -312,10 +314,11 @@ export class HTMLGenerator {
     mergedFrontmatter: MDXFrontmatter,
   ): Promise<HTMLGenerationOptions> {
     const stylesheetPath = this.config.config?.tailwind?.stylesheet || "globals.css";
-    const [appComponentPath, globalCSS] = await Promise.all([
-      this.resolveAppPath().then((p) => p ?? undefined),
+    const [appComponentPathOrNull, globalCSS] = await Promise.all([
+      this.resolveAppPath(),
       this.loadProjectFile(stylesheetPath),
     ]);
+    const appComponentPath = appComponentPathOrNull ?? undefined;
     const projectClasses = await this.extractProjectClassesForRoute(context, appComponentPath);
 
     // Load CSS imported by components and merge with globalCSS.
@@ -422,7 +425,8 @@ export class HTMLGenerator {
         } else {
           regularCssSegments.push(content);
         }
-      } catch {
+      } catch (_) {
+        /* expected: imported CSS file may not exist */
         logger.debug("Could not load imported CSS file", { cssPath });
       }
     }

package/src/src/rendering/orchestrator/layout.ts

@@ -35,14 +35,14 @@ export interface LayoutCollectionResult {
   nestedLayouts: LayoutItem[];
 }
 
-export interface LayoutPreloadResult {
+interface LayoutPreloadResult {
   type: "tsx" | "mdx" | "importMap";
   path?: string;
   success: boolean;
   error?: string;
 }
 
-export interface LayoutPreloadSummary {
+interface LayoutPreloadSummary {
   tsxTotal: number;
   tsxSuccess: number;
   tsxFailures: Array<{ path: string; error: string }>;
@@ -74,7 +74,7 @@ export class LayoutOrchestrator {
       this.config.layoutCache.clear();
     }
     clearSSRModuleCacheForProject(this.config.projectId);
-    clearImportMapCache(this.config.projectDir);
+    clearImportMapCache(this.config.projectId);
     this._preloadedImportMap = null;
   }
 
@@ -125,12 +125,16 @@ export class LayoutOrchestrator {
 
         if (mdxLayouts.length > 0) {
           preloadPromises.push(
-            preloadImportMap(this.config.projectDir, this.config.adapter)
-              .then((importMap) => {
+            (async (): Promise<LayoutPreloadResult> => {
+              try {
+                const importMap = await preloadImportMap(
+                  this.config.projectDir,
+                  this.config.adapter,
+                  this.config.projectId,
+                );
                 this._preloadedImportMap = importMap;
                 return { type: "importMap" as const, success: true };
-              })
-              .catch((error) => {
+              } catch (error) {
                 const errorMsg = error instanceof Error ? error.message : String(error);
                 logger.error("Failed to preload import map", {
                   error: errorMsg,
@@ -138,24 +142,27 @@ export class LayoutOrchestrator {
                 });
                 this._preloadedImportMap = null;
                 return { type: "importMap" as const, success: false, error: errorMsg };
-              }),
+              }
+            })(),
           );
         }
 
         for (const layout of tsxLayouts) {
           const componentPath = layout.componentPath!;
           preloadPromises.push(
-            loadTSXComponent(
-              componentPath,
-              this.config.projectDir,
-              this.config.layoutCache,
-              this.config.adapter,
-              this.config.projectId,
-              this.config.projectSlug,
-              this.config.contentSourceId,
-            )
-              .then(() => ({ type: "tsx" as const, path: componentPath, success: true }))
-              .catch((error) => {
+            (async (): Promise<LayoutPreloadResult> => {
+              try {
+                await loadTSXComponent(
+                  componentPath,
+                  this.config.projectDir,
+                  this.config.layoutCache,
+                  this.config.adapter,
+                  this.config.projectId,
+                  this.config.projectSlug,
+                  this.config.contentSourceId,
+                );
+                return { type: "tsx" as const, path: componentPath, success: true };
+              } catch (error) {
                 const errorMsg = error instanceof Error ? error.message : String(error);
                 logger.error("Failed to preload TSX layout", {
                   path: componentPath,
@@ -168,22 +175,25 @@ export class LayoutOrchestrator {
                   success: false,
                   error: errorMsg,
                 };
-              }),
+              }
+            })(),
           );
         }
 
         for (const layout of mdxLayouts) {
           preloadPromises.push(
-            preloadMDXLayoutModule(
-              layout.bundle!,
-              this.config.projectDir,
-              this.config.adapter,
-              this.config.projectId,
-              this.config.projectSlug,
-              this.config.contentSourceId,
-            )
-              .then(() => ({ type: "mdx" as const, path: layout.path, success: true }))
-              .catch((error) => {
+            (async (): Promise<LayoutPreloadResult> => {
+              try {
+                await preloadMDXLayoutModule(
+                  layout.bundle!,
+                  this.config.projectDir,
+                  this.config.adapter,
+                  this.config.projectId,
+                  this.config.projectSlug,
+                  this.config.contentSourceId,
+                );
+                return { type: "mdx" as const, path: layout.path, success: true };
+              } catch (error) {
                 const errorMsg = error instanceof Error ? error.message : String(error);
                 logger.error("Failed to preload MDX layout", {
                   path: layout.path,
@@ -191,7 +201,8 @@ export class LayoutOrchestrator {
                   hint: "Layout will be retried during apply phase",
                 });
                 return { type: "mdx" as const, path: layout.path, success: false, error: errorMsg };
-              }),
+              }
+            })(),
           );
         }
 

package/src/src/rendering/orchestrator/lifecycle.ts

@@ -25,6 +25,11 @@ import { CompilerService } from "./compiler-service.js";
 
 const logger = rendererLogger.component("lifecycle");
 
+/** Default max cache entries for debug mode */
+const DEBUG_MODE_MAX_ENTRIES = 50;
+/** Default max cache entries for production mode */
+const PRODUCTION_MAX_ENTRIES = 500;
+
 export interface LifecycleOptions {
   configManager: ConfigurationManager;
   port: number;
@@ -117,7 +122,8 @@ export class RendererLifecycle {
       case "memory":
       default:
         cacheStore = new MemoryCacheStore({
-          maxEntries: renderCacheConfig.maxEntries ?? (debugMode ? 50 : 500),
+          maxEntries: renderCacheConfig.maxEntries ??
+            (debugMode ? DEBUG_MODE_MAX_ENTRIES : PRODUCTION_MAX_ENTRIES),
           ttlMs: renderCacheConfig.ttl,
         });
         break;
@@ -137,6 +143,7 @@ export class RendererLifecycle {
 
     const layoutCollector = new LayoutCollector({
       projectDir,
+      projectId: this.projectId,
       adapter: this.adapter,
       config,
       compileMDX: compileMDXProxy,
@@ -152,7 +159,7 @@ export class RendererLifecycle {
       debugMode,
     });
 
-    const ssrRenderer = new SSRRenderer(mode, this.adapter, projectDir);
+    const ssrRenderer = new SSRRenderer(mode, this.adapter, projectDir, this.projectId);
 
     const pageRenderer = new PageRenderer({
       projectDir,
@@ -166,6 +173,7 @@ export class RendererLifecycle {
 
     const pageResolver = new PageResolver({
       projectDir,
+      projectId: this.projectId,
       config,
       adapter: this.adapter,
     });

package/src/src/rendering/orchestrator/module-collection.ts

@@ -8,7 +8,7 @@
  */
 
 /** Timeout for module loading in resolvePageData (prevents hanging on slow transforms) */
-export const MODULE_LOAD_TIMEOUT_MS = 10000;
+export const MODULE_LOAD_TIMEOUT_MS = 10_000;
 
 /** Timeout for data fetching (getStaticData, getServerData) */
 export const DATA_FETCH_TIMEOUT_MS = 15_000;
@@ -27,8 +27,7 @@ export interface ModuleToLoad {
 export interface LoadedModule {
   type: "page" | "layout";
   id: string;
-  // deno-lint-ignore no-explicit-any
-  mod: any;
+  mod: unknown;
 }
 
 /**

package/src/src/rendering/orchestrator/module-loader/esm-rewriter.ts

@@ -1,5 +1,6 @@
 import * as dntShim from "../../../../_dnt.shims.js";
 import { rendererLogger } from "../../../utils/index.js";
+import { MODULE_NOT_FOUND } from "../../../errors/error-registry.js";
 import type { RuntimeAdapter } from "../../../platform/adapters/base.js";
 import { generateHash } from "./cache.js";
 
@@ -60,7 +61,9 @@ export async function fetchEsmModule(
   logger.debug("Fetching esm.sh module:", url);
 
   const response = await dntShim.fetch(url);
-  if (!response.ok) throw new Error(`Failed to fetch ${url}: ${response.status}`);
+  if (!response.ok) {
+    throw MODULE_NOT_FOUND.create({ detail: `Failed to fetch ${url}: ${response.status}` });
+  }
 
   let code = await response.text();
 

package/src/src/rendering/orchestrator/module-loader/index.ts

@@ -41,7 +41,7 @@ export { createEsmCache, createModuleCache, generateHash } from "./cache.js";
 export { fetchEsmModule, rewriteEsmPaths } from "./esm-rewriter.js";
 
 /** Maximum number of directories to track to prevent memory leaks */
-const MAX_CREATED_DIRS = 5000;
+const MAX_CREATED_DIRS = 5_000;
 
 /** Cache for created directories to avoid repeated mkdir calls (LRU-style) */
 const createdDirs = new Set<string>();
@@ -84,8 +84,8 @@ async function ensureDir(adapter: RuntimeAdapter, dir: string): Promise<void> {
 
   try {
     await adapter.fs.mkdir(dir, { recursive: true });
-  } catch {
-    // Directory might already exist, ignore errors
+  } catch (_) {
+    /* expected: directory might already exist */
   } finally {
     createdDirs.add(dir);
     pruneCreatedDirs();
@@ -213,8 +213,8 @@ export async function transformModuleWithDeps(
       } else {
         return cachedPath;
       }
-    } catch {
-      // File doesn't exist or can't be read - fall through to re-transform
+    } catch (_) {
+      /* expected: cached file may no longer exist on disk */
       moduleCache.delete(cacheKey);
     }
   }
@@ -246,14 +246,14 @@ export async function transformModuleWithDeps(
 
   // Match @/ alias imports
   const aliasImports: AliasImport[] = [...fileContent.matchAll(/from\s+["'](@\/[^"']+)["']/g)].map(
-    (m) => ({ full: m[0], path: m[1]! }),
+    (m) => ({ full: m[0], path: m[1] ?? "" }),
   );
 
   // Match relative imports (./ and ../) - exclude npm:, http://, https://, file://
   const relativeImports: RelativeImport[] = [
     ...fileContent.matchAll(/from\s+["'](\.\.?\/[^"']+)["']/g),
   ]
-    .map((m) => ({ full: m[0], path: m[1]!, fromDir: fileDir }))
+    .map((m) => ({ full: m[0], path: m[1] ?? "", fromDir: fileDir }))
     // Filter out already-transformed file:// imports
     .filter((imp) => !imp.path.includes("file://"));
 
@@ -524,7 +524,10 @@ async function getModuleCacheDir(config: ModuleLoaderConfig): Promise<string> {
  * @param config - Module loader configuration
  * @returns The loaded module
  */
-export async function loadModule(filePath: string, config: ModuleLoaderConfig): Promise<any> {
+export async function loadModule(
+  filePath: string,
+  config: ModuleLoaderConfig,
+): Promise<Record<string, unknown>> {
   const tmpDir = await getModuleCacheDir(config);
   const localAdapter = await getLocalAdapter();