veryfront 0.1.49 → 0.1.51

package/src/src/build/production-build/templates.ts

@@ -11,7 +11,7 @@ export const CLIENT_STYLES =
   ".error-container {\n  max-width: 600px;\n  margin: 2rem auto;\n  padding: 2rem;\n  background: #fee;\n  border: 1px solid #fcc;\n  border-radius: 8px;\n  color: #c00;\n}";
 
 export const CLIENT_ROUTER_BUNDLE: string | undefined =
-  'var __defProp = Object.defineProperty;\nvar __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;\nvar __publicField = (obj, key, value) => {\n  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);\n  return value;\n};\n\n// src/rendering/client/router.ts\nimport { rendererLogger } from "#veryfront/utils";\nimport ReactDOM from "react-dom/client";\nimport {\n  extractPageDataFromScript,\n  NavigationHandlers,\n  PageLoader,\n  PageTransition,\n  ViewportPrefetch\n} from "#veryfront/routing";\nvar logger = rendererLogger.component("veryfront");\nvar VeryfrontRouter = class {\n  constructor(options = {}) {\n    __publicField(this, "baseUrl");\n    __publicField(this, "currentPath");\n    __publicField(this, "root", null);\n    __publicField(this, "options");\n    __publicField(this, "spaMode");\n    __publicField(this, "spaNavigationHandler", null);\n    __publicField(this, "pageLoader");\n    __publicField(this, "navigationHandlers");\n    __publicField(this, "pageTransition");\n    __publicField(this, "viewportPrefetch");\n    __publicField(this, "handleClick");\n    __publicField(this, "handlePopState");\n    __publicField(this, "handleMouseOver");\n    const globalOptions = this.loadGlobalOptions();\n    this.options = { ...globalOptions, ...options };\n    this.baseUrl = this.options.baseUrl || globalThis.location.origin;\n    this.currentPath = globalThis.location.pathname;\n    this.spaMode = this.options.spaMode ?? globalThis.__VERYFRONT_SPA_MODE__ ?? false;\n    this.pageLoader = new PageLoader();\n    this.navigationHandlers = new NavigationHandlers(\n      this.options.prefetchDelay,\n      this.options.prefetch\n    );\n    this.pageTransition = new PageTransition((root) => this.viewportPrefetch.setup(root));\n    this.viewportPrefetch = new ViewportPrefetch(\n      (path) => this.prefetch(path),\n      this.options.prefetch\n    );\n    this.handleClick = this.navigationHandlers.createClickHandler({\n      onNavigate: (url) => this.navigate(url),\n      onPrefetch: (url) => this.prefetch(url)\n    });\n    this.handlePopState = this.navigationHandlers.createPopStateHandler({\n      onNavigate: (url) => this.navigate(url, false),\n      onPrefetch: (url) => this.prefetch(url)\n    });\n    this.handleMouseOver = this.navigationHandlers.createMouseOverHandler({\n      onNavigate: (url) => this.navigate(url),\n      onPrefetch: (url) => this.prefetch(url)\n    });\n  }\n  registerNavigationHandler(handler) {\n    logger.debug("Registering SPA navigation handler");\n    this.spaNavigationHandler = handler;\n    this.spaMode = true;\n  }\n  loadGlobalOptions() {\n    try {\n      const options = globalThis.__VERYFRONT_ROUTER_OPTS__;\n      if (!options) {\n        logger.debug("No global options configured");\n        return {};\n      }\n      return options;\n    } catch (error) {\n      logger.error("Failed to read global options:", error);\n      return {};\n    }\n  }\n  init() {\n    logger.debug("Initializing client-side router");\n    const rootElement = document.getElementById("root");\n    if (!rootElement) {\n      logger.error("Root element not found");\n      return;\n    }\n    const ReactDOMToUse = globalThis.ReactDOM ?? ReactDOM;\n    this.root = ReactDOMToUse.createRoot(rootElement);\n    document.addEventListener("click", this.handleClick);\n    globalThis.addEventListener("popstate", this.handlePopState);\n    document.addEventListener("mouseover", this.handleMouseOver);\n    this.viewportPrefetch.setup(document);\n    this.cacheCurrentPage();\n  }\n  cacheCurrentPage() {\n    const pageData = extractPageDataFromScript();\n    if (pageData)\n      this.pageLoader.setCache(this.currentPath, pageData);\n  }\n  async navigate(url, pushState = true) {\n    logger.debug(`Navigating to ${url} (SPA mode: ${this.spaMode})`);\n    this.navigationHandlers.saveScrollPosition(this.currentPath);\n    this.options.onStart?.(url);\n    if (pushState)\n      globalThis.history.pushState({}, "", url);\n    if (this.spaMode && this.spaNavigationHandler) {\n      await this.loadSpaPage(url);\n    } else {\n      await this.loadPage(url);\n    }\n    this.options.onNavigate?.(url);\n  }\n  async loadSpaPage(path) {\n    logger.debug(`Loading SPA page: ${path}`);\n    try {\n      const spaData = await this.pageLoader.loadSpaPageData(path);\n      await this.spaNavigationHandler?.(spaData);\n      this.currentPath = path;\n      this.handleScrollAfterNavigation();\n      this.options.onComplete?.(path);\n    } catch (error) {\n      const normalizedError = error instanceof Error ? error : new Error(String(error));\n      logger.error(`Failed to load SPA page ${path}`, normalizedError);\n      this.options.onError?.(normalizedError);\n      this.pageTransition.showError(normalizedError);\n    }\n  }\n  handleScrollAfterNavigation() {\n    const isPopState = this.navigationHandlers.isPopState();\n    const scrollY = this.navigationHandlers.getScrollPosition(this.currentPath);\n    try {\n      globalThis.scrollTo(0, isPopState ? scrollY : 0);\n    } catch (error) {\n      logger.warn("scroll handling failed", error);\n    }\n    this.navigationHandlers.clearPopStateFlag();\n  }\n  async loadPage(path, updateUI = true) {\n    if (this.pageLoader.isCached(path)) {\n      logger.debug(`Loading ${path} from cache`);\n      const data = this.pageLoader.getCached(path);\n      if (data) {\n        if (updateUI)\n          this.updatePage(data);\n        return;\n      }\n      logger.warn(`Cache entry for ${path} was unexpectedly null, fetching fresh data`);\n    }\n    this.pageTransition.setLoadingState(true);\n    try {\n      const data = await this.pageLoader.loadPage(path);\n      if (updateUI)\n        this.updatePage(data);\n      this.currentPath = path;\n      this.options.onComplete?.(path);\n    } catch (error) {\n      const normalizedError = error instanceof Error ? error : new Error(String(error));\n      logger.error(`Failed to load ${path}`, normalizedError);\n      this.options.onError?.(normalizedError);\n      this.pageTransition.showError(normalizedError);\n    } finally {\n      this.pageTransition.setLoadingState(false);\n    }\n  }\n  async prefetch(path) {\n    if (this.spaMode) {\n      await this.pageLoader.prefetchSpaPageData(path);\n      return;\n    }\n    await this.pageLoader.prefetch(path);\n  }\n  updatePage(data) {\n    if (!this.root)\n      return;\n    const isPopState = this.navigationHandlers.isPopState();\n    const scrollY = this.navigationHandlers.getScrollPosition(this.currentPath);\n    this.pageTransition.updatePage(data, isPopState, scrollY);\n    this.navigationHandlers.clearPopStateFlag();\n  }\n  destroy() {\n    document.removeEventListener("click", this.handleClick);\n    globalThis.removeEventListener("popstate", this.handlePopState);\n    document.removeEventListener("mouseover", this.handleMouseOver);\n    this.viewportPrefetch.disconnect();\n    this.pageLoader.clearCache();\n    this.navigationHandlers.clear();\n    this.pageTransition.destroy();\n  }\n};\nif (typeof window !== "undefined" && globalThis.document) {\n  const router = new VeryfrontRouter();\n  if (document.readyState === "loading") {\n    document.addEventListener("DOMContentLoaded", () => router.init());\n  } else {\n    router.init();\n  }\n  globalThis.veryFrontRouter = router;\n}\nexport {\n  VeryfrontRouter\n};\n';
+  'var __defProp = Object.defineProperty;\nvar __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;\nvar __publicField = (obj, key, value) => {\n  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);\n  return value;\n};\n\n// src/rendering/client/router.ts\nimport { rendererLogger } from "#veryfront/utils";\nimport ReactDOM from "react-dom/client";\nimport {\n  extractPageDataFromScript,\n  NavigationHandlers,\n  PageLoader,\n  PageTransition,\n  ViewportPrefetch\n} from "#veryfront/routing";\nvar logger = rendererLogger.component("veryfront");\nvar VeryfrontRouter = class {\n  constructor(options = {}) {\n    __publicField(this, "baseUrl");\n    __publicField(this, "currentPath");\n    __publicField(this, "root", null);\n    __publicField(this, "options");\n    __publicField(this, "spaMode");\n    __publicField(this, "spaNavigationHandler", null);\n    __publicField(this, "pageLoader");\n    __publicField(this, "navigationHandlers");\n    __publicField(this, "pageTransition");\n    __publicField(this, "viewportPrefetch");\n    __publicField(this, "handleClick");\n    __publicField(this, "handlePopState");\n    __publicField(this, "handleMouseOver");\n    const globalOptions = this.loadGlobalOptions();\n    this.options = { ...globalOptions, ...options };\n    this.baseUrl = this.options.baseUrl || globalThis.location.origin;\n    this.currentPath = globalThis.location.pathname;\n    this.spaMode = this.options.spaMode ?? globalThis.__VERYFRONT_SPA_MODE__ ?? false;\n    this.pageLoader = new PageLoader();\n    this.navigationHandlers = new NavigationHandlers(\n      this.options.prefetchDelay,\n      this.options.prefetch\n    );\n    this.pageTransition = new PageTransition((root) => this.viewportPrefetch.setup(root));\n    this.viewportPrefetch = new ViewportPrefetch(\n      (path) => this.prefetch(path),\n      this.options.prefetch\n    );\n    this.handleClick = this.navigationHandlers.createClickHandler({\n      onNavigate: (url) => this.navigate(url),\n      onPrefetch: (url) => this.prefetch(url)\n    });\n    this.handlePopState = this.navigationHandlers.createPopStateHandler({\n      onNavigate: (url) => this.navigate(url, false),\n      onPrefetch: (url) => this.prefetch(url)\n    });\n    this.handleMouseOver = this.navigationHandlers.createMouseOverHandler({\n      onNavigate: (url) => this.navigate(url),\n      onPrefetch: (url) => this.prefetch(url)\n    });\n  }\n  registerNavigationHandler(handler) {\n    logger.debug("Registering SPA navigation handler");\n    this.spaNavigationHandler = handler;\n    this.spaMode = true;\n  }\n  loadGlobalOptions() {\n    try {\n      const options = globalThis.__VERYFRONT_ROUTER_OPTS__;\n      if (!options) {\n        logger.debug("No global options configured");\n        return {};\n      }\n      return options;\n    } catch (error) {\n      logger.error("Failed to read global options:", error);\n      return {};\n    }\n  }\n  init() {\n    logger.debug("Initializing client-side router");\n    const rootElement = document.getElementById("root");\n    if (!rootElement) {\n      logger.error("Root element not found");\n      return;\n    }\n    const ReactDOMToUse = globalThis.ReactDOM ?? ReactDOM;\n    this.root = ReactDOMToUse.createRoot(rootElement);\n    document.addEventListener("click", this.handleClick);\n    globalThis.addEventListener("popstate", this.handlePopState);\n    document.addEventListener("mouseover", this.handleMouseOver);\n    this.viewportPrefetch.setup(document);\n    this.cacheCurrentPage();\n  }\n  cacheCurrentPage() {\n    const pageData = extractPageDataFromScript();\n    if (pageData)\n      this.pageLoader.setCache(this.currentPath, pageData);\n  }\n  async navigate(url, pushState = true) {\n    logger.debug(`Navigating to ${url} (SPA mode: ${this.spaMode})`);\n    this.navigationHandlers.saveScrollPosition(this.currentPath);\n    this.options.onStart?.(url);\n    if (pushState)\n      globalThis.history.pushState({}, "", url);\n    if (this.spaMode && this.spaNavigationHandler) {\n      await this.loadSpaPage(url);\n    } else {\n      await this.loadPage(url);\n    }\n    this.options.onNavigate?.(url);\n  }\n  async loadSpaPage(path) {\n    logger.debug(`Loading SPA page: ${path}`);\n    try {\n      const spaData = await this.pageLoader.loadSpaPageData(path);\n      await this.spaNavigationHandler?.(spaData);\n      this.currentPath = path;\n      this.handleScrollAfterNavigation();\n      this.options.onComplete?.(path);\n    } catch (error) {\n      const normalizedError = error instanceof Error ? error : new Error(String(error));\n      logger.error(`Failed to load SPA page ${path}`, normalizedError);\n      this.options.onError?.(normalizedError);\n      this.pageTransition.showError(normalizedError);\n    }\n  }\n  handleScrollAfterNavigation() {\n    const isPopState = this.navigationHandlers.isPopState();\n    const scrollY = this.navigationHandlers.getScrollPosition(this.currentPath);\n    try {\n      globalThis.scrollTo(0, isPopState ? scrollY : 0);\n    } catch (error) {\n      logger.warn("scroll handling failed", error);\n    }\n    this.navigationHandlers.clearPopStateFlag();\n  }\n  async loadPage(path, updateUI = true) {\n    if (this.pageLoader.isCached(path)) {\n      logger.debug(`Loading ${path} from cache`);\n      const data = this.pageLoader.getCached(path);\n      if (data) {\n        if (updateUI)\n          this.updatePage(data);\n        return;\n      }\n      logger.warn(`Cache entry for ${path} was unexpectedly null, fetching fresh data`);\n    }\n    this.pageTransition.setLoadingState(true);\n    try {\n      const data = await this.pageLoader.loadPage(path);\n      if (updateUI)\n        this.updatePage(data);\n      this.currentPath = path;\n      this.options.onComplete?.(path);\n    } catch (error) {\n      const normalizedError = error instanceof Error ? error : new Error(String(error));\n      logger.error(`Failed to load ${path}`, normalizedError);\n      this.options.onError?.(normalizedError);\n      this.pageTransition.showError(normalizedError);\n    } finally {\n      this.pageTransition.setLoadingState(false);\n    }\n  }\n  async prefetch(path) {\n    if (this.spaMode) {\n      await this.pageLoader.prefetchSpaPageData(path);\n      return;\n    }\n    await this.pageLoader.prefetch(path);\n  }\n  updatePage(data) {\n    if (!this.root)\n      return;\n    const isPopState = this.navigationHandlers.isPopState();\n    const scrollY = this.navigationHandlers.getScrollPosition(this.currentPath);\n    this.pageTransition.updatePage(data, isPopState, scrollY);\n    this.navigationHandlers.clearPopStateFlag();\n  }\n  destroy() {\n    document.removeEventListener("click", this.handleClick);\n    globalThis.removeEventListener("popstate", this.handlePopState);\n    document.removeEventListener("mouseover", this.handleMouseOver);\n    this.viewportPrefetch.disconnect();\n    this.pageLoader.clearCache();\n    this.navigationHandlers.clear();\n    this.pageTransition.destroy();\n  }\n};\nif (typeof window !== "undefined" && globalThis.document) {\n  const router = new VeryfrontRouter();\n  if (document.readyState === "loading") {\n    document.addEventListener("DOMContentLoaded", () => router.init(), { once: true });\n  } else {\n    router.init();\n  }\n  globalThis.veryFrontRouter = router;\n}\nexport {\n  VeryfrontRouter\n};\n';
 
 export const CLIENT_PREFETCH_BUNDLE: string | undefined =
-  'var __defProp = Object.defineProperty;\nvar __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;\nvar __publicField = (obj, key, value) => {\n  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);\n  return value;\n};\n\n// src/rendering/client/browser-logger.ts\nvar ConditionalBrowserLogger = class {\n  constructor(prefix, level) {\n    this.prefix = prefix;\n    this.level = level;\n  }\n  log(minLevel, fn, message, ...args) {\n    if (this.level > minLevel)\n      return;\n    fn?.(message, ...args);\n  }\n  debug(message, ...args) {\n    this.log(\n      0 /* DEBUG */,\n      console.debug,\n      `[${this.prefix}] DEBUG: ${message}`,\n      ...args\n    );\n  }\n  info(message, ...args) {\n    this.log(1 /* INFO */, console.log, `[${this.prefix}] ${message}`, ...args);\n  }\n  warn(message, ...args) {\n    this.log(\n      2 /* WARN */,\n      console.warn,\n      `[${this.prefix}] WARN: ${message}`,\n      ...args\n    );\n  }\n  error(message, ...args) {\n    this.log(\n      3 /* ERROR */,\n      console.error,\n      `[${this.prefix}] ERROR: ${message}`,\n      ...args\n    );\n  }\n};\nfunction getBrowserLogLevel() {\n  if (typeof window === "undefined")\n    return 2 /* WARN */;\n  const g = globalThis;\n  const isDevelopment = g.__VERYFRONT_DEV__ || g.__RSC_DEV__;\n  if (!isDevelopment)\n    return 2 /* WARN */;\n  const isDebugEnabled = g.__VERYFRONT_DEBUG__ || g.__RSC_DEBUG__;\n  return isDebugEnabled ? 0 /* DEBUG */ : 1 /* INFO */;\n}\nvar defaultLevel = getBrowserLogLevel();\nvar rscLogger = new ConditionalBrowserLogger("RSC", defaultLevel);\nvar prefetchLogger = new ConditionalBrowserLogger("PREFETCH", defaultLevel);\nvar hydrateLogger = new ConditionalBrowserLogger("HYDRATE", defaultLevel);\nvar browserLogger = new ConditionalBrowserLogger("VERYFRONT", defaultLevel);\n\n// src/rendering/client/prefetch/link-observer.ts\nfunction isAnchorElement(element) {\n  return typeof HTMLAnchorElement !== "undefined" ? element instanceof HTMLAnchorElement : element.tagName === "A";\n}\nvar LinkObserver = class {\n  constructor(options, prefetchedUrls) {\n    __publicField(this, "options");\n    __publicField(this, "intersectionObserver", null);\n    __publicField(this, "mutationObserver", null);\n    __publicField(this, "prefetchedUrls");\n    __publicField(this, "pendingTimeouts", /* @__PURE__ */ new Map());\n    __publicField(this, "elementTimeoutMap", /* @__PURE__ */ new WeakMap());\n    __publicField(this, "timeoutCounter", 0);\n    this.options = options;\n    this.prefetchedUrls = prefetchedUrls;\n  }\n  init() {\n    this.createIntersectionObserver();\n    this.observeLinks();\n    this.setupMutationObserver();\n  }\n  createIntersectionObserver() {\n    this.intersectionObserver = new IntersectionObserver(\n      (entries) => this.handleIntersection(entries),\n      { rootMargin: this.options.rootMargin }\n    );\n  }\n  handleIntersection(entries) {\n    for (const entry of entries) {\n      if (!entry.isIntersecting)\n        continue;\n      if (!isAnchorElement(entry.target))\n        continue;\n      const link = entry.target;\n      if (this.timeoutCounter > 1e6)\n        this.timeoutCounter = 0;\n      const timeoutKey = this.timeoutCounter++;\n      const timeoutId = setTimeout(() => {\n        this.pendingTimeouts.delete(timeoutKey);\n        this.elementTimeoutMap.delete(link);\n        this.options.onLinkVisible(link);\n      }, this.options.delay);\n      this.pendingTimeouts.set(timeoutKey, timeoutId);\n      this.elementTimeoutMap.set(link, timeoutKey);\n    }\n  }\n  observeLinks() {\n    this.observeAnchors(document.querySelectorAll(\'a[href^="/"], a[href^="./"]\'));\n  }\n  setupMutationObserver() {\n    this.mutationObserver = new MutationObserver((mutations) => {\n      for (const mutation of mutations) {\n        if (mutation.type !== "childList")\n          continue;\n        for (const node of mutation.addedNodes) {\n          if (node.nodeType !== Node.ELEMENT_NODE)\n            continue;\n          this.observeElement(node);\n        }\n        for (const node of mutation.removedNodes) {\n          if (node.nodeType !== Node.ELEMENT_NODE)\n            continue;\n          this.clearElementTimeouts(node);\n        }\n      }\n    });\n    this.mutationObserver.observe(document.body, { childList: true, subtree: true });\n  }\n  clearTimeoutForElement(element) {\n    const timeoutKey = this.elementTimeoutMap.get(element);\n    if (timeoutKey === void 0)\n      return;\n    const timeoutId = this.pendingTimeouts.get(timeoutKey);\n    if (timeoutId !== void 0) {\n      clearTimeout(timeoutId);\n      this.pendingTimeouts.delete(timeoutKey);\n    }\n    this.elementTimeoutMap.delete(element);\n  }\n  clearElementTimeouts(element) {\n    if (isAnchorElement(element))\n      this.clearTimeoutForElement(element);\n    for (const link of element.querySelectorAll("a")) {\n      this.clearTimeoutForElement(link);\n    }\n  }\n  observeElement(element) {\n    if (isAnchorElement(element) && this.isValidLink(element)) {\n      this.intersectionObserver?.observe(element);\n    }\n    this.observeAnchors(element.querySelectorAll(\'a[href^="/"], a[href^="./"]\'));\n  }\n  observeAnchors(links) {\n    for (const link of links) {\n      if (!isAnchorElement(link))\n        continue;\n      if (!this.isValidLink(link))\n        continue;\n      this.intersectionObserver?.observe(link);\n    }\n  }\n  isValidLink(link) {\n    if (link.hostname !== globalThis.location.hostname)\n      return false;\n    if (link.hasAttribute("download"))\n      return false;\n    if (link.target === "_blank")\n      return false;\n    const url = link.href;\n    if (this.prefetchedUrls.has(url))\n      return false;\n    if (url === globalThis.location.href)\n      return false;\n    if (link.hash && link.pathname === globalThis.location.pathname)\n      return false;\n    if (link.dataset.noPrefetch)\n      return false;\n    return true;\n  }\n  destroy() {\n    for (const timeoutId of this.pendingTimeouts.values()) {\n      clearTimeout(timeoutId);\n    }\n    this.pendingTimeouts.clear();\n    this.timeoutCounter = 0;\n    this.intersectionObserver?.disconnect();\n    this.intersectionObserver = null;\n    this.mutationObserver?.disconnect();\n    this.mutationObserver = null;\n  }\n};\n\n// src/rendering/client/prefetch/network-utils.ts\nvar NetworkUtils = class {\n  constructor(allowedNetworks = ["4g", "wifi", "ethernet"]) {\n    __publicField(this, "networkInfo");\n    __publicField(this, "allowedNetworks");\n    this.allowedNetworks = allowedNetworks;\n    this.networkInfo = this.getNetworkConnection();\n  }\n  getNavigatorWithConnection() {\n    if (typeof globalThis.navigator === "undefined")\n      return null;\n    return globalThis.navigator;\n  }\n  getNetworkConnection() {\n    const nav = this.getNavigatorWithConnection();\n    return nav?.connection ?? nav?.mozConnection ?? nav?.webkitConnection ?? null;\n  }\n  shouldPrefetch() {\n    if (this.networkInfo?.saveData)\n      return false;\n    const effectiveType = this.networkInfo?.effectiveType;\n    if (effectiveType != null && !this.allowedNetworks.includes(effectiveType))\n      return false;\n    return true;\n  }\n  onNetworkChange(callback) {\n    this.networkInfo?.addEventListener?.("change", callback);\n  }\n  getNetworkInfo() {\n    return this.networkInfo;\n  }\n};\n\n// src/rendering/client/prefetch/prefetch-queue.ts\nimport { PREFETCH_QUEUE_MAX_SIZE_BYTES } from "#veryfront/utils/constants/index.ts";\nvar DEFAULT_OPTIONS = {\n  maxConcurrent: 4,\n  maxSize: PREFETCH_QUEUE_MAX_SIZE_BYTES,\n  timeout: 5e3\n};\nfunction isAbortError(error) {\n  if (typeof error !== "object" || error === null)\n    return false;\n  if (!("name" in error))\n    return false;\n  return error.name === "AbortError";\n}\nvar PrefetchQueue = class {\n  constructor(options = {}, prefetchedUrls) {\n    __publicField(this, "options");\n    __publicField(this, "controllers", /* @__PURE__ */ new Map());\n    __publicField(this, "prefetchedUrls");\n    __publicField(this, "concurrent", 0);\n    __publicField(this, "stopped", false);\n    __publicField(this, "onResourcesFetched");\n    this.options = { ...DEFAULT_OPTIONS, ...options };\n    this.prefetchedUrls = prefetchedUrls ?? /* @__PURE__ */ new Set();\n  }\n  setResourceCallback(callback) {\n    this.onResourcesFetched = callback;\n  }\n  enqueue(url) {\n    void this.prefetch(url);\n  }\n  has(url) {\n    return this.prefetchedUrls.has(url) || this.controllers.has(url);\n  }\n  get size() {\n    return this.controllers.size;\n  }\n  clear() {\n    this.stopAll();\n    this.prefetchedUrls.clear();\n  }\n  start() {\n    this.stopped = false;\n  }\n  stop() {\n    this.stopped = true;\n    this.stopAll();\n  }\n  getQueueSize() {\n    return this.controllers.size;\n  }\n  getConcurrentCount() {\n    return this.concurrent;\n  }\n  async prefetchLink(link) {\n    if (this.stopped)\n      return;\n    const url = link.href;\n    if (!url || this.controllers.has(url) || this.prefetchedUrls.has(url))\n      return;\n    if (this.concurrent >= this.options.maxConcurrent) {\n      prefetchLogger.debug?.(`Prefetch queue full, skipping ${url}`);\n      return;\n    }\n    let parsedUrl;\n    try {\n      parsedUrl = new URL(url);\n    } catch {\n      prefetchLogger.debug?.(`Invalid prefetch URL ${url}`);\n      return;\n    }\n    const controller = new AbortController();\n    this.controllers.set(url, controller);\n    this.concurrent += 1;\n    const timeoutId = this.options.timeout > 0 ? setTimeout(() => controller.abort(), this.options.timeout) : void 0;\n    try {\n      const response = await fetch(parsedUrl.toString(), {\n        method: "GET",\n        signal: controller.signal,\n        headers: { "X-Veryfront-Prefetch": "1" }\n      });\n      if (!response.ok)\n        return;\n      if (this.isResponseTooLarge(response)) {\n        prefetchLogger.debug?.(`Prefetch too large, skipping ${url}`);\n        return;\n      }\n      this.prefetchedUrls.add(url);\n      if (!this.onResourcesFetched)\n        return;\n      try {\n        await this.onResourcesFetched(response, url);\n      } catch (callbackError) {\n        prefetchLogger.error?.(`Prefetch callback failed for ${url}`, callbackError);\n      }\n    } catch (error) {\n      if (!isAbortError(error)) {\n        prefetchLogger.error?.(`Failed to prefetch ${url}`, error);\n      }\n    } finally {\n      if (timeoutId !== void 0)\n        clearTimeout(timeoutId);\n      this.controllers.delete(url);\n      this.concurrent = Math.max(0, this.concurrent - 1);\n    }\n  }\n  async prefetch(url) {\n    const link = typeof document !== "undefined" ? document.createElement("a") : { href: url };\n    link.href = url;\n    await this.prefetchLink(link);\n  }\n  stopAll() {\n    for (const controller of this.controllers.values()) {\n      controller.abort();\n    }\n    this.controllers.clear();\n    this.concurrent = 0;\n  }\n  isResponseTooLarge(response) {\n    const rawLength = response.headers.get("content-length");\n    if (rawLength === null)\n      return false;\n    const size = Number.parseInt(rawLength, 10);\n    if (!Number.isFinite(size))\n      return false;\n    return size > this.options.maxSize;\n  }\n};\nvar prefetchQueue = new PrefetchQueue();\n\n// src/rendering/client/prefetch/resource-hints.ts\nvar ResourceHintsManager = class {\n  constructor() {\n    __publicField(this, "appliedHints", /* @__PURE__ */ new Set());\n  }\n  applyResourceHints(hints) {\n    for (const hint of hints) {\n      const key = `${hint.type}:${hint.href}`;\n      if (this.appliedHints.has(key))\n        continue;\n      const existing = document.querySelector(\n        `link[rel="${hint.type}"][href="${hint.href}"]`\n      );\n      if (existing) {\n        this.appliedHints.add(key);\n        continue;\n      }\n      this.createAndAppendHint(hint);\n      this.appliedHints.add(key);\n      prefetchLogger.debug(`Added resource hint: ${hint.type} ${hint.href}`);\n    }\n  }\n  createAndAppendHint(hint) {\n    if (!document.head) {\n      prefetchLogger.warn("document.head is not available, skipping resource hint");\n      return;\n    }\n    const link = document.createElement("link");\n    link.rel = hint.type;\n    link.href = hint.href;\n    if (hint.as)\n      link.setAttribute("as", hint.as);\n    if (hint.crossOrigin)\n      link.setAttribute("crossorigin", hint.crossOrigin);\n    if (hint.media)\n      link.setAttribute("media", hint.media);\n    document.head.appendChild(link);\n  }\n  extractResourceHints(html, prefetchedUrls) {\n    try {\n      const doc = new DOMParser().parseFromString(html, "text/html");\n      const hints = [];\n      this.extractPreloadLinks(doc, prefetchedUrls, hints);\n      this.extractScripts(doc, prefetchedUrls, hints);\n      this.extractStylesheets(doc, prefetchedUrls, hints);\n      return hints;\n    } catch (error) {\n      prefetchLogger.error("Failed to parse prefetched page", error);\n      return [];\n    }\n  }\n  isValidResourceHintType(rel) {\n    switch (rel) {\n      case "prefetch":\n      case "preload":\n      case "preconnect":\n      case "dns-prefetch":\n        return true;\n      default:\n        return false;\n    }\n  }\n  extractPreloadLinks(doc, prefetchedUrls, hints) {\n    const links = doc.querySelectorAll(\n      \'link[rel="preload"], link[rel="prefetch"]\'\n    );\n    for (const link of links) {\n      const href = link.href;\n      if (!href)\n        continue;\n      if (prefetchedUrls.has(href))\n        continue;\n      if (!this.isValidResourceHintType(link.rel))\n        continue;\n      hints.push({\n        type: link.rel,\n        href,\n        as: link.getAttribute("as") ?? void 0\n      });\n    }\n  }\n  extractScripts(doc, prefetchedUrls, hints) {\n    for (const script of doc.querySelectorAll("script[src]")) {\n      const src = script.src;\n      if (!src || prefetchedUrls.has(src))\n        continue;\n      hints.push({ type: "prefetch", href: src, as: "script" });\n    }\n  }\n  extractStylesheets(doc, prefetchedUrls, hints) {\n    for (const link of doc.querySelectorAll(\'link[rel="stylesheet"]\')) {\n      const href = link.href;\n      if (!href || prefetchedUrls.has(href))\n        continue;\n      hints.push({ type: "prefetch", href, as: "style" });\n    }\n  }\n  static generateResourceHints(_route, assets) {\n    const hints = [\n      \'<link rel="dns-prefetch" href="https://cdn.jsdelivr.net">\',\n      \'<link rel="dns-prefetch" href="https://esm.sh">\',\n      \'<link rel="preconnect" href="https://cdn.jsdelivr.net" crossorigin>\'\n    ];\n    for (const asset of assets) {\n      if (asset.endsWith(".js")) {\n        hints.push(`<link rel="modulepreload" href="${asset}">`);\n        continue;\n      }\n      if (asset.endsWith(".css")) {\n        hints.push(`<link rel="preload" as="style" href="${asset}">`);\n        continue;\n      }\n      if (/\\.(woff2?|ttf|otf)$/.test(asset)) {\n        hints.push(`<link rel="preload" as="font" href="${asset}" crossorigin>`);\n      }\n    }\n    return hints.join("\\n");\n  }\n};\n\n// src/rendering/client/prefetch.ts\nimport {\n  PREFETCH_DEFAULT_DELAY_MS,\n  PREFETCH_DEFAULT_TIMEOUT_MS,\n  PREFETCH_MAX_SIZE_BYTES\n} from "#veryfront/utils";\nvar PrefetchManager = class {\n  constructor(options = {}) {\n    __publicField(this, "options");\n    __publicField(this, "prefetchedUrls", /* @__PURE__ */ new Set());\n    __publicField(this, "networkUtils");\n    __publicField(this, "linkObserver", null);\n    __publicField(this, "resourceHintsManager");\n    __publicField(this, "prefetchQueue");\n    this.options = {\n      rootMargin: options.rootMargin ?? "50px",\n      delay: options.delay ?? PREFETCH_DEFAULT_DELAY_MS,\n      maxConcurrent: options.maxConcurrent ?? 2,\n      allowedNetworks: options.allowedNetworks ?? ["4g", "wifi", "ethernet"],\n      maxSize: options.maxSize ?? PREFETCH_MAX_SIZE_BYTES,\n      timeout: options.timeout ?? PREFETCH_DEFAULT_TIMEOUT_MS\n    };\n    this.networkUtils = new NetworkUtils(this.options.allowedNetworks);\n    this.resourceHintsManager = new ResourceHintsManager();\n    this.prefetchQueue = new PrefetchQueue(\n      {\n        maxConcurrent: this.options.maxConcurrent,\n        maxSize: this.options.maxSize,\n        timeout: this.options.timeout\n      },\n      this.prefetchedUrls\n    );\n    this.prefetchQueue.setResourceCallback(\n      (response, url) => this.prefetchPageResources(response, url)\n    );\n  }\n  init() {\n    prefetchLogger.info("Initializing prefetch manager");\n    if (!this.networkUtils.shouldPrefetch()) {\n      prefetchLogger.info("Prefetching disabled due to network conditions");\n      return;\n    }\n    this.linkObserver = new LinkObserver(\n      {\n        rootMargin: this.options.rootMargin,\n        delay: this.options.delay,\n        onLinkVisible: (link) => this.prefetchQueue.prefetchLink(link)\n      },\n      this.prefetchedUrls\n    );\n    this.linkObserver.init();\n    this.networkUtils.onNetworkChange(() => {\n      if (!this.networkUtils.shouldPrefetch())\n        this.prefetchQueue.stopAll();\n    });\n  }\n  async prefetchPageResources(response, _pageUrl) {\n    const html = await response.text();\n    const hints = this.resourceHintsManager.extractResourceHints(html, this.prefetchedUrls);\n    this.resourceHintsManager.applyResourceHints(hints);\n  }\n  applyResourceHints(hints) {\n    this.resourceHintsManager.applyResourceHints(hints);\n  }\n  async prefetch(url) {\n    await this.prefetchQueue.prefetch(url);\n  }\n  static generateResourceHints(route, assets) {\n    return ResourceHintsManager.generateResourceHints(route, assets);\n  }\n  destroy() {\n    this.linkObserver?.destroy();\n    this.prefetchQueue.stopAll();\n    this.prefetchedUrls.clear();\n  }\n};\nfunction initPrefetch(options) {\n  const prefetchManager = new PrefetchManager(options);\n  if (document.readyState === "loading") {\n    document.addEventListener("DOMContentLoaded", () => prefetchManager.init());\n  } else {\n    prefetchManager.init();\n  }\n  globalThis.veryFrontPrefetch = prefetchManager;\n  return prefetchManager;\n}\nfunction resolveAutoInitOptions() {\n  const setting = globalThis.__VERYFRONT_PREFETCH__;\n  if (!setting)\n    return null;\n  if (setting === true)\n    return {};\n  if (typeof setting === "object")\n    return setting;\n  return null;\n}\nfunction shouldAutoInitPrefetch(options) {\n  if (!options)\n    return false;\n  if (typeof window === "undefined" || typeof document === "undefined")\n    return false;\n  const win = window;\n  const doc = document;\n  if (win.__veryfrontSSRStub || doc.__veryfrontSSRStub)\n    return false;\n  if (typeof IntersectionObserver === "undefined")\n    return false;\n  if (typeof MutationObserver === "undefined")\n    return false;\n  return true;\n}\nvar autoInitOptions = resolveAutoInitOptions();\nif (shouldAutoInitPrefetch(autoInitOptions))\n  initPrefetch(autoInitOptions);\nexport {\n  PrefetchManager,\n  initPrefetch\n};\n';
+  'var __defProp = Object.defineProperty;\nvar __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;\nvar __publicField = (obj, key, value) => {\n  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);\n  return value;\n};\n\n// src/rendering/client/browser-logger.ts\nvar ConditionalBrowserLogger = class {\n  constructor(prefix, level) {\n    this.prefix = prefix;\n    this.level = level;\n  }\n  log(minLevel, fn, message, ...args) {\n    if (this.level > minLevel)\n      return;\n    fn?.(message, ...args);\n  }\n  debug(message, ...args) {\n    this.log(\n      0 /* DEBUG */,\n      console.debug,\n      `[${this.prefix}] DEBUG: ${message}`,\n      ...args\n    );\n  }\n  info(message, ...args) {\n    this.log(1 /* INFO */, console.log, `[${this.prefix}] ${message}`, ...args);\n  }\n  warn(message, ...args) {\n    this.log(\n      2 /* WARN */,\n      console.warn,\n      `[${this.prefix}] WARN: ${message}`,\n      ...args\n    );\n  }\n  error(message, ...args) {\n    this.log(\n      3 /* ERROR */,\n      console.error,\n      `[${this.prefix}] ERROR: ${message}`,\n      ...args\n    );\n  }\n};\nfunction getBrowserLogLevel() {\n  if (typeof window === "undefined")\n    return 2 /* WARN */;\n  const g = globalThis;\n  const isDevelopment = g.__VERYFRONT_DEV__ || g.__RSC_DEV__;\n  if (!isDevelopment)\n    return 2 /* WARN */;\n  const isDebugEnabled = g.__VERYFRONT_DEBUG__ || g.__RSC_DEBUG__;\n  return isDebugEnabled ? 0 /* DEBUG */ : 1 /* INFO */;\n}\nvar defaultLevel = getBrowserLogLevel();\nvar rscLogger = new ConditionalBrowserLogger("RSC", defaultLevel);\nvar prefetchLogger = new ConditionalBrowserLogger("PREFETCH", defaultLevel);\nvar hydrateLogger = new ConditionalBrowserLogger("HYDRATE", defaultLevel);\nvar browserLogger = new ConditionalBrowserLogger("VERYFRONT", defaultLevel);\n\n// src/rendering/client/prefetch/link-observer.ts\nfunction isAnchorElement(element) {\n  return typeof HTMLAnchorElement !== "undefined" ? element instanceof HTMLAnchorElement : element.tagName === "A";\n}\nvar LinkObserver = class {\n  constructor(options, prefetchedUrls) {\n    __publicField(this, "options");\n    __publicField(this, "intersectionObserver", null);\n    __publicField(this, "mutationObserver", null);\n    __publicField(this, "prefetchedUrls");\n    __publicField(this, "pendingTimeouts", /* @__PURE__ */ new Map());\n    __publicField(this, "elementTimeoutMap", /* @__PURE__ */ new WeakMap());\n    __publicField(this, "timeoutCounter", 0);\n    this.options = options;\n    this.prefetchedUrls = prefetchedUrls;\n  }\n  init() {\n    this.createIntersectionObserver();\n    this.observeLinks();\n    this.setupMutationObserver();\n  }\n  createIntersectionObserver() {\n    this.intersectionObserver = new IntersectionObserver(\n      (entries) => this.handleIntersection(entries),\n      { rootMargin: this.options.rootMargin }\n    );\n  }\n  handleIntersection(entries) {\n    for (const entry of entries) {\n      if (!entry.isIntersecting)\n        continue;\n      if (!isAnchorElement(entry.target))\n        continue;\n      const link = entry.target;\n      if (this.timeoutCounter > 1e6)\n        this.timeoutCounter = 0;\n      const timeoutKey = this.timeoutCounter++;\n      const timeoutId = setTimeout(() => {\n        this.pendingTimeouts.delete(timeoutKey);\n        this.elementTimeoutMap.delete(link);\n        this.options.onLinkVisible(link);\n      }, this.options.delay);\n      this.pendingTimeouts.set(timeoutKey, timeoutId);\n      this.elementTimeoutMap.set(link, timeoutKey);\n    }\n  }\n  observeLinks() {\n    this.observeAnchors(document.querySelectorAll(\'a[href^="/"], a[href^="./"]\'));\n  }\n  setupMutationObserver() {\n    this.mutationObserver = new MutationObserver((mutations) => {\n      for (const mutation of mutations) {\n        if (mutation.type !== "childList")\n          continue;\n        for (const node of mutation.addedNodes) {\n          if (node.nodeType !== Node.ELEMENT_NODE)\n            continue;\n          this.observeElement(node);\n        }\n        for (const node of mutation.removedNodes) {\n          if (node.nodeType !== Node.ELEMENT_NODE)\n            continue;\n          this.clearElementTimeouts(node);\n        }\n      }\n    });\n    this.mutationObserver.observe(document.body, { childList: true, subtree: true });\n  }\n  clearTimeoutForElement(element) {\n    const timeoutKey = this.elementTimeoutMap.get(element);\n    if (timeoutKey === void 0)\n      return;\n    const timeoutId = this.pendingTimeouts.get(timeoutKey);\n    if (timeoutId !== void 0) {\n      clearTimeout(timeoutId);\n      this.pendingTimeouts.delete(timeoutKey);\n    }\n    this.elementTimeoutMap.delete(element);\n  }\n  clearElementTimeouts(element) {\n    if (isAnchorElement(element))\n      this.clearTimeoutForElement(element);\n    for (const link of element.querySelectorAll("a")) {\n      this.clearTimeoutForElement(link);\n    }\n  }\n  observeElement(element) {\n    if (isAnchorElement(element) && this.isValidLink(element)) {\n      this.intersectionObserver?.observe(element);\n    }\n    this.observeAnchors(element.querySelectorAll(\'a[href^="/"], a[href^="./"]\'));\n  }\n  observeAnchors(links) {\n    for (const link of links) {\n      if (!isAnchorElement(link))\n        continue;\n      if (!this.isValidLink(link))\n        continue;\n      this.intersectionObserver?.observe(link);\n    }\n  }\n  isValidLink(link) {\n    if (link.hostname !== globalThis.location.hostname)\n      return false;\n    if (link.hasAttribute("download"))\n      return false;\n    if (link.target === "_blank")\n      return false;\n    const url = link.href;\n    if (this.prefetchedUrls.has(url))\n      return false;\n    if (url === globalThis.location.href)\n      return false;\n    if (link.hash && link.pathname === globalThis.location.pathname)\n      return false;\n    if (link.dataset.noPrefetch)\n      return false;\n    return true;\n  }\n  destroy() {\n    for (const timeoutId of this.pendingTimeouts.values()) {\n      clearTimeout(timeoutId);\n    }\n    this.pendingTimeouts.clear();\n    this.timeoutCounter = 0;\n    this.intersectionObserver?.disconnect();\n    this.intersectionObserver = null;\n    this.mutationObserver?.disconnect();\n    this.mutationObserver = null;\n  }\n};\n\n// src/rendering/client/prefetch/network-utils.ts\nvar NetworkUtils = class {\n  constructor(allowedNetworks = ["4g", "wifi", "ethernet"]) {\n    __publicField(this, "networkInfo");\n    __publicField(this, "allowedNetworks");\n    this.allowedNetworks = allowedNetworks;\n    this.networkInfo = this.getNetworkConnection();\n  }\n  getNavigatorWithConnection() {\n    if (typeof globalThis.navigator === "undefined")\n      return null;\n    return globalThis.navigator;\n  }\n  getNetworkConnection() {\n    const nav = this.getNavigatorWithConnection();\n    return nav?.connection ?? nav?.mozConnection ?? nav?.webkitConnection ?? null;\n  }\n  shouldPrefetch() {\n    if (this.networkInfo?.saveData)\n      return false;\n    const effectiveType = this.networkInfo?.effectiveType;\n    if (effectiveType != null && !this.allowedNetworks.includes(effectiveType))\n      return false;\n    return true;\n  }\n  onNetworkChange(callback) {\n    this.networkInfo?.addEventListener?.("change", callback);\n  }\n  getNetworkInfo() {\n    return this.networkInfo;\n  }\n};\n\n// src/rendering/client/prefetch/prefetch-queue.ts\nimport { PREFETCH_QUEUE_MAX_SIZE_BYTES } from "#veryfront/utils/constants/index.ts";\nvar DEFAULT_OPTIONS = {\n  maxConcurrent: 4,\n  maxSize: PREFETCH_QUEUE_MAX_SIZE_BYTES,\n  timeout: 5e3\n};\nfunction isAbortError(error) {\n  if (typeof error !== "object" || error === null)\n    return false;\n  if (!("name" in error))\n    return false;\n  return error.name === "AbortError";\n}\nvar PrefetchQueue = class {\n  constructor(options = {}, prefetchedUrls) {\n    __publicField(this, "options");\n    __publicField(this, "controllers", /* @__PURE__ */ new Map());\n    __publicField(this, "prefetchedUrls");\n    __publicField(this, "concurrent", 0);\n    __publicField(this, "stopped", false);\n    __publicField(this, "onResourcesFetched");\n    this.options = { ...DEFAULT_OPTIONS, ...options };\n    this.prefetchedUrls = prefetchedUrls ?? /* @__PURE__ */ new Set();\n  }\n  setResourceCallback(callback) {\n    this.onResourcesFetched = callback;\n  }\n  enqueue(url) {\n    void this.prefetch(url);\n  }\n  has(url) {\n    return this.prefetchedUrls.has(url) || this.controllers.has(url);\n  }\n  get size() {\n    return this.controllers.size;\n  }\n  clear() {\n    this.stopAll();\n    this.prefetchedUrls.clear();\n  }\n  start() {\n    this.stopped = false;\n  }\n  stop() {\n    this.stopped = true;\n    this.stopAll();\n  }\n  getQueueSize() {\n    return this.controllers.size;\n  }\n  getConcurrentCount() {\n    return this.concurrent;\n  }\n  async prefetchLink(link) {\n    if (this.stopped)\n      return;\n    const url = link.href;\n    if (!url || this.controllers.has(url) || this.prefetchedUrls.has(url))\n      return;\n    if (this.concurrent >= this.options.maxConcurrent) {\n      prefetchLogger.debug?.(`Prefetch queue full, skipping ${url}`);\n      return;\n    }\n    let parsedUrl;\n    try {\n      parsedUrl = new URL(url);\n    } catch (_) {\n      prefetchLogger.debug?.(`Invalid prefetch URL ${url}`);\n      return;\n    }\n    const controller = new AbortController();\n    this.controllers.set(url, controller);\n    this.concurrent += 1;\n    const timeoutId = this.options.timeout > 0 ? setTimeout(() => controller.abort(), this.options.timeout) : void 0;\n    try {\n      const response = await fetch(parsedUrl.toString(), {\n        method: "GET",\n        signal: controller.signal,\n        headers: { "X-Veryfront-Prefetch": "1" }\n      });\n      if (!response.ok)\n        return;\n      if (this.isResponseTooLarge(response)) {\n        prefetchLogger.debug?.(`Prefetch too large, skipping ${url}`);\n        return;\n      }\n      this.prefetchedUrls.add(url);\n      if (!this.onResourcesFetched)\n        return;\n      try {\n        await this.onResourcesFetched(response, url);\n      } catch (callbackError) {\n        prefetchLogger.error?.(`Prefetch callback failed for ${url}`, callbackError);\n      }\n    } catch (error) {\n      if (!isAbortError(error)) {\n        prefetchLogger.error?.(`Failed to prefetch ${url}`, error);\n      }\n    } finally {\n      if (timeoutId !== void 0)\n        clearTimeout(timeoutId);\n      this.controllers.delete(url);\n      this.concurrent = Math.max(0, this.concurrent - 1);\n    }\n  }\n  async prefetch(url) {\n    const link = typeof document !== "undefined" ? document.createElement("a") : { href: url };\n    link.href = url;\n    await this.prefetchLink(link);\n  }\n  stopAll() {\n    for (const controller of this.controllers.values()) {\n      controller.abort();\n    }\n    this.controllers.clear();\n    this.concurrent = 0;\n  }\n  isResponseTooLarge(response) {\n    const rawLength = response.headers.get("content-length");\n    if (rawLength === null)\n      return false;\n    const size = Number.parseInt(rawLength, 10);\n    if (!Number.isFinite(size))\n      return false;\n    return size > this.options.maxSize;\n  }\n};\nvar prefetchQueue = new PrefetchQueue();\n\n// src/rendering/client/prefetch/resource-hints.ts\nvar ResourceHintsManager = class {\n  constructor() {\n    __publicField(this, "appliedHints", /* @__PURE__ */ new Set());\n  }\n  applyResourceHints(hints) {\n    for (const hint of hints) {\n      const key = `${hint.type}:${hint.href}`;\n      if (this.appliedHints.has(key))\n        continue;\n      const existing = document.querySelector(\n        `link[rel="${hint.type}"][href="${hint.href}"]`\n      );\n      if (existing) {\n        this.appliedHints.add(key);\n        continue;\n      }\n      this.createAndAppendHint(hint);\n      this.appliedHints.add(key);\n      prefetchLogger.debug(`Added resource hint: ${hint.type} ${hint.href}`);\n    }\n  }\n  createAndAppendHint(hint) {\n    if (!document.head) {\n      prefetchLogger.warn("document.head is not available, skipping resource hint");\n      return;\n    }\n    const link = document.createElement("link");\n    link.rel = hint.type;\n    link.href = hint.href;\n    if (hint.as)\n      link.setAttribute("as", hint.as);\n    if (hint.crossOrigin)\n      link.setAttribute("crossorigin", hint.crossOrigin);\n    if (hint.media)\n      link.setAttribute("media", hint.media);\n    document.head.appendChild(link);\n  }\n  extractResourceHints(html, prefetchedUrls) {\n    try {\n      const doc = new DOMParser().parseFromString(html, "text/html");\n      const hints = [];\n      this.extractPreloadLinks(doc, prefetchedUrls, hints);\n      this.extractScripts(doc, prefetchedUrls, hints);\n      this.extractStylesheets(doc, prefetchedUrls, hints);\n      return hints;\n    } catch (error) {\n      prefetchLogger.error("Failed to parse prefetched page", error);\n      return [];\n    }\n  }\n  isValidResourceHintType(rel) {\n    switch (rel) {\n      case "prefetch":\n      case "preload":\n      case "preconnect":\n      case "dns-prefetch":\n        return true;\n      default:\n        return false;\n    }\n  }\n  extractPreloadLinks(doc, prefetchedUrls, hints) {\n    const links = doc.querySelectorAll(\n      \'link[rel="preload"], link[rel="prefetch"]\'\n    );\n    for (const link of links) {\n      const href = link.href;\n      if (!href)\n        continue;\n      if (prefetchedUrls.has(href))\n        continue;\n      if (!this.isValidResourceHintType(link.rel))\n        continue;\n      hints.push({\n        type: link.rel,\n        href,\n        as: link.getAttribute("as") ?? void 0\n      });\n    }\n  }\n  extractScripts(doc, prefetchedUrls, hints) {\n    for (const script of doc.querySelectorAll("script[src]")) {\n      const src = script.src;\n      if (!src || prefetchedUrls.has(src))\n        continue;\n      hints.push({ type: "prefetch", href: src, as: "script" });\n    }\n  }\n  extractStylesheets(doc, prefetchedUrls, hints) {\n    for (const link of doc.querySelectorAll(\'link[rel="stylesheet"]\')) {\n      const href = link.href;\n      if (!href || prefetchedUrls.has(href))\n        continue;\n      hints.push({ type: "prefetch", href, as: "style" });\n    }\n  }\n  static generateResourceHints(_route, assets) {\n    const hints = [\n      \'<link rel="dns-prefetch" href="https://cdn.jsdelivr.net">\',\n      \'<link rel="dns-prefetch" href="https://esm.sh">\',\n      \'<link rel="preconnect" href="https://cdn.jsdelivr.net" crossorigin>\'\n    ];\n    for (const asset of assets) {\n      if (asset.endsWith(".js")) {\n        hints.push(`<link rel="modulepreload" href="${asset}">`);\n        continue;\n      }\n      if (asset.endsWith(".css")) {\n        hints.push(`<link rel="preload" as="style" href="${asset}">`);\n        continue;\n      }\n      if (/\\.(woff2?|ttf|otf)$/.test(asset)) {\n        hints.push(`<link rel="preload" as="font" href="${asset}" crossorigin>`);\n      }\n    }\n    return hints.join("\\n");\n  }\n};\n\n// src/rendering/client/prefetch.ts\nimport {\n  PREFETCH_DEFAULT_DELAY_MS,\n  PREFETCH_DEFAULT_TIMEOUT_MS,\n  PREFETCH_MAX_SIZE_BYTES\n} from "#veryfront/utils";\nvar PrefetchManager = class {\n  constructor(options = {}) {\n    __publicField(this, "options");\n    __publicField(this, "prefetchedUrls", /* @__PURE__ */ new Set());\n    __publicField(this, "networkUtils");\n    __publicField(this, "linkObserver", null);\n    __publicField(this, "resourceHintsManager");\n    __publicField(this, "prefetchQueue");\n    this.options = {\n      rootMargin: options.rootMargin ?? "50px",\n      delay: options.delay ?? PREFETCH_DEFAULT_DELAY_MS,\n      maxConcurrent: options.maxConcurrent ?? 2,\n      allowedNetworks: options.allowedNetworks ?? ["4g", "wifi", "ethernet"],\n      maxSize: options.maxSize ?? PREFETCH_MAX_SIZE_BYTES,\n      timeout: options.timeout ?? PREFETCH_DEFAULT_TIMEOUT_MS\n    };\n    this.networkUtils = new NetworkUtils(this.options.allowedNetworks);\n    this.resourceHintsManager = new ResourceHintsManager();\n    this.prefetchQueue = new PrefetchQueue(\n      {\n        maxConcurrent: this.options.maxConcurrent,\n        maxSize: this.options.maxSize,\n        timeout: this.options.timeout\n      },\n      this.prefetchedUrls\n    );\n    this.prefetchQueue.setResourceCallback(\n      (response, url) => this.prefetchPageResources(response, url)\n    );\n  }\n  init() {\n    prefetchLogger.info("Initializing prefetch manager");\n    if (!this.networkUtils.shouldPrefetch()) {\n      prefetchLogger.info("Prefetching disabled due to network conditions");\n      return;\n    }\n    this.linkObserver = new LinkObserver(\n      {\n        rootMargin: this.options.rootMargin,\n        delay: this.options.delay,\n        onLinkVisible: (link) => this.prefetchQueue.prefetchLink(link)\n      },\n      this.prefetchedUrls\n    );\n    this.linkObserver.init();\n    this.networkUtils.onNetworkChange(() => {\n      if (!this.networkUtils.shouldPrefetch())\n        this.prefetchQueue.stopAll();\n    });\n  }\n  async prefetchPageResources(response, _pageUrl) {\n    const html = await response.text();\n    const hints = this.resourceHintsManager.extractResourceHints(html, this.prefetchedUrls);\n    this.resourceHintsManager.applyResourceHints(hints);\n  }\n  applyResourceHints(hints) {\n    this.resourceHintsManager.applyResourceHints(hints);\n  }\n  async prefetch(url) {\n    await this.prefetchQueue.prefetch(url);\n  }\n  static generateResourceHints(route, assets) {\n    return ResourceHintsManager.generateResourceHints(route, assets);\n  }\n  destroy() {\n    this.linkObserver?.destroy();\n    this.prefetchQueue.stopAll();\n    this.prefetchedUrls.clear();\n  }\n};\nfunction initPrefetch(options) {\n  const prefetchManager = new PrefetchManager(options);\n  if (document.readyState === "loading") {\n    document.addEventListener("DOMContentLoaded", () => prefetchManager.init(), { once: true });\n  } else {\n    prefetchManager.init();\n  }\n  globalThis.veryFrontPrefetch = prefetchManager;\n  return prefetchManager;\n}\nfunction resolveAutoInitOptions() {\n  const setting = globalThis.__VERYFRONT_PREFETCH__;\n  if (!setting)\n    return null;\n  if (setting === true)\n    return {};\n  if (typeof setting === "object")\n    return setting;\n  return null;\n}\nfunction shouldAutoInitPrefetch(options) {\n  if (!options)\n    return false;\n  if (typeof window === "undefined" || typeof document === "undefined")\n    return false;\n  const win = window;\n  const doc = document;\n  if (win.__veryfrontSSRStub || doc.__veryfrontSSRStub)\n    return false;\n  if (typeof IntersectionObserver === "undefined")\n    return false;\n  if (typeof MutationObserver === "undefined")\n    return false;\n  return true;\n}\nvar autoInitOptions = resolveAutoInitOptions();\nif (shouldAutoInitPrefetch(autoInitOptions))\n  initPrefetch(autoInitOptions);\nexport {\n  PrefetchManager,\n  initPrefetch\n};\n';

package/src/src/cache/backends/api.ts

@@ -6,9 +6,16 @@ import { tryGetCacheKeyContext } from "../cache-key-builder.js";
 import { CircuitBreakerOpen, getCircuitBreaker } from "../../utils/circuit-breaker.js";
 import type { CacheBackend } from "../types.js";
 import { getEnvValue } from "./helpers.js";
+import { REQUEST_ERROR } from "../../errors/index.js";
 
 const logger = baseLogger.component("api-cache-backend");
 
+const DEFAULT_TIMEOUT_MS = 10_000;
+const CIRCUIT_BREAKER_RESET_TIMEOUT_MS = 15_000;
+const CIRCUIT_BREAKER_FAILURE_THRESHOLD = 10;
+const CIRCUIT_BREAKER_SUCCESS_THRESHOLD = 2;
+const ERROR_BODY_MAX_LENGTH = 500;
+
 type CacheRequestContext = {
   token?: string;
   projectId?: string;
@@ -41,13 +48,13 @@ export class ApiCacheBackend implements CacheBackend {
       getEnvValue("VERYFRONT_API_BASE_URL") ??
       "https://api.veryfront.com";
     this.keyPrefix = options.keyPrefix ?? "";
-    this.timeoutMs = options.timeoutMs ?? 10000;
+    this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
 
     const breakerName = options.circuitBreakerName ?? "api-cache";
     this.circuitBreaker = getCircuitBreaker(breakerName, {
-      failureThreshold: 10,
-      resetTimeoutMs: 15000,
-      successThreshold: 2,
+      failureThreshold: CIRCUIT_BREAKER_FAILURE_THRESHOLD,
+      resetTimeoutMs: CIRCUIT_BREAKER_RESET_TIMEOUT_MS,
+      successThreshold: CIRCUIT_BREAKER_SUCCESS_THRESHOLD,
     });
   }
 
@@ -114,7 +121,9 @@ export class ApiCacheBackend implements CacheBackend {
                 error: bodyError instanceof Error ? bodyError.message : String(bodyError),
               });
             }
-            throw new Error(`HTTP ${response.status}: ${responseBody.slice(0, 500)}`);
+            throw REQUEST_ERROR.create({
+              detail: `HTTP ${response.status}: ${responseBody.slice(0, ERROR_BODY_MAX_LENGTH)}`,
+            });
           }
 
           return (await response.json()) as T;

package/src/src/cache/backends/disk.ts

@@ -4,6 +4,7 @@ import { logger } from "../../utils/index.js";
 import type { CacheBackend } from "../types.js";
 
 const CACHE_SUBDIR = "veryfront-files";
+const MAX_REGEX_CACHE_SIZE = 100;
 const fsPromises = import("node:fs/promises");
 
 interface DiskCacheEnvelope {
@@ -110,7 +111,7 @@ export class DiskCacheBackend implements CacheBackend {
     if (!regex) {
       const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&");
       regex = new RegExp(`^${escaped.replace(/\*/g, ".*").replace(/\?/g, ".")}$`);
-      if (this.regexCache.size >= 100) {
+      if (this.regexCache.size >= MAX_REGEX_CACHE_SIZE) {
         const firstKey = this.regexCache.keys().next().value as string | undefined;
         if (firstKey) this.regexCache.delete(firstKey);
       }

package/src/src/cache/backends/factory.ts

@@ -17,6 +17,8 @@ import { getEnvValue } from "./helpers.js";
 
 const logger = baseLogger.component("cache-backend");
 
+const DEFAULT_MEMORY_MAX_ENTRIES = 500;
+
 // Re-export gateway types for backward compatibility
 export type { CodeCacheGateway, TokenizingCacheGateway };
 
@@ -47,7 +49,7 @@ export function isDiskCacheConfigured(): boolean {
 export function createCacheBackend(config: CacheBackendConfig = {}): Promise<CacheBackend> {
   const {
     keyPrefix = "",
-    memoryMaxEntries = 500,
+    memoryMaxEntries = DEFAULT_MEMORY_MAX_ENTRIES,
     preferredBackend,
     apiBaseUrl,
     circuitBreakerName,

package/src/src/cache/backends/memory.ts

@@ -4,6 +4,9 @@ import {
 } from "../../utils/constants/cache.js";
 import type { CacheBackend } from "../types.js";
 
+const DEFAULT_TTL_SECONDS = 300;
+const MAX_REGEX_CACHE_SIZE = 100;
+
 export class MemoryCacheBackend implements CacheBackend {
   readonly type = "memory" as const;
   private store = new Map<string, { value: string; expiresAt: number; sizeBytes: number }>();
@@ -66,7 +69,7 @@ export class MemoryCacheBackend implements CacheBackend {
     return Promise.resolve(results);
   }
 
-  set(key: string, value: string, ttlSeconds = 300): Promise<void> {
+  set(key: string, value: string, ttlSeconds = DEFAULT_TTL_SECONDS): Promise<void> {
     const entrySize = this.estimateSize(key, value);
 
     // Reject single entries that exceed the byte limit on their own
@@ -120,7 +123,7 @@ export class MemoryCacheBackend implements CacheBackend {
       this.currentSizeBytes += entrySize;
       this.store.set(key, {
         value,
-        expiresAt: now + (ttl ?? 300) * 1000,
+        expiresAt: now + (ttl ?? DEFAULT_TTL_SECONDS) * 1000,
         sizeBytes: entrySize,
       });
     }
@@ -141,7 +144,7 @@ export class MemoryCacheBackend implements CacheBackend {
       const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&");
       regex = new RegExp(`^${escaped.replace(/\*/g, ".*").replace(/\?/g, ".")}$`);
 
-      if (this.regexCache.size >= 100) {
+      if (this.regexCache.size >= MAX_REGEX_CACHE_SIZE) {
         const firstKey = this.regexCache.keys().next().value as string | undefined;
         if (firstKey) this.regexCache.delete(firstKey);
       }

package/src/src/cache/cache-key-builder.ts

@@ -3,6 +3,7 @@ import { AsyncLocalStorage } from "node:async_hooks";
 import type { HandlerContext } from "../types/index.js";
 import { type CacheKeyContext, CacheKeyContextSchema } from "./schemas/index.js";
 import { buildContentHashCacheKey } from "./keys.js";
+import { CACHE_INVARIANT_VIOLATION } from "../errors/index.js";
 
 type MultiProjectRequestContextType = {
   projectSlug: string;
@@ -41,10 +42,10 @@ export function getCurrentCacheKeyContext(): CacheKeyContext {
   const ctx = cacheKeyContextStorage.getStore();
   if (ctx) return ctx;
 
-  throw new Error(
-    "[CacheKeyBuilder] No cache context available. " +
+  throw CACHE_INVARIANT_VIOLATION.create({
+    detail: "[CacheKeyBuilder] No cache context available. " +
       "Ensure runWithCacheKeyContext() was called at request entry.",
-  );
+  });
 }
 
 function getRequestContextFn(): (() => MultiProjectRequestContextType | null) | null {
@@ -55,7 +56,8 @@ function getRequestContextFn(): (() => MultiProjectRequestContextType | null) |
       | { getCurrentRequestContext?: () => MultiProjectRequestContextType | null }
       | undefined;
     _getCurrentRequestContext = mod?.getCurrentRequestContext ?? null;
-  } catch {
+  } catch (_) {
+    // expected: multi-project adapter may not be available
     _getCurrentRequestContext = null;
   }
 

package/src/src/cache/config-hash.ts

@@ -16,7 +16,7 @@ import {
 /**
  * Configuration that affects transform output.
  */
-export interface TransformConfig {
+interface TransformConfig {
   /** React version for esm.sh URLs */
   reactVersion?: string;
   /** JSX import source */

package/src/src/cache/dependency-graph.ts

@@ -201,7 +201,8 @@ async function buildDependencyGraph(
         buildDependencyGraph(dep, graph, contentHashes, getContent, projectDir, visited)
       ),
     );
-  } catch {
+  } catch (_) {
+    // expected: file may not exist or imports may fail to parse
     graph.addModule(filePath, []);
   }
 }

package/src/src/cache/distributed-cache-init.ts

@@ -10,7 +10,7 @@ import { isApiCacheAvailable, isDiskCacheConfigured } from "./backend.js";
 
 const logger = baseLogger.component("distributed-cache");
 
-export interface DistributedCacheStatus {
+interface DistributedCacheStatus {
   backend: "api" | "redis" | "disk" | "memory";
   transformCache: boolean;
   ssrModuleCache: boolean;

package/src/src/cache/keys/builders/file.ts

@@ -10,6 +10,7 @@
 import { VERSION } from "../../../utils/version.js";
 import { CacheKeyPrefix, type FileOperationContext } from "../prefixes.js";
 import { hashPathWithName } from "../utils.js";
+import { CACHE_INVARIANT_VIOLATION } from "../../../errors/index.js";
 
 function getSourceTypeKey(sourceType: "branch" | "release" | "environment"): string {
   return sourceType === "environment" ? "env" : sourceType;
@@ -19,9 +20,9 @@ function buildSourceQualifier(ctx: FileOperationContext): string {
   if (ctx.sourceType === "branch") return ctx.branch ?? "main";
 
   if (!ctx.releaseId) {
-    throw new Error(
-      `Missing releaseId for ${ctx.sourceType} sourceType (project: ${ctx.projectSlug})`,
-    );
+    throw CACHE_INVARIANT_VIOLATION.create({
+      detail: `Missing releaseId for ${ctx.sourceType} sourceType (project: ${ctx.projectSlug})`,
+    });
   }
 
   if (ctx.sourceType === "release") return ctx.releaseId;

package/src/src/cache/keys/builders/render.ts

@@ -11,6 +11,7 @@ import { VERSION } from "../../../utils/version.js";
 import { CacheKeyPrefix } from "../prefixes.js";
 import type { QueryParamCacheOptions } from "../prefixes.js";
 import { sanitizeQueryParamsForCacheKey } from "../utils.js";
+import { CACHE_INVARIANT_VIOLATION } from "../../../errors/index.js";
 
 export function buildRenderCachePrefix(
   projectId: string,
@@ -45,7 +46,9 @@ export function computeContentSourceId(
 
   if (environment === "production") {
     if (!releaseId) {
-      throw new Error("Missing releaseId for production contentSourceId");
+      throw CACHE_INVARIANT_VIOLATION.create({
+        detail: "Missing releaseId for production contentSourceId",
+      });
     }
     return `release-${releaseId}`;
   }
@@ -92,7 +95,9 @@ export function buildProxyManagerCacheKey(
 
   if (productionMode) {
     if (!releaseId) {
-      throw new Error(`Missing releaseId in production for ${projectSlug}`);
+      throw CACHE_INVARIANT_VIOLATION.create({
+        detail: `Missing releaseId in production for ${projectSlug}`,
+      });
     }
     return `${CacheKeyPrefix.PROXY}:${projectSlug}:${mode}:${releaseId}`;
   }

package/src/src/cache/registry.ts

@@ -6,6 +6,9 @@ import type { Span } from "@opentelemetry/api";
 
 const logger = rendererLogger.component("cache-registry");
 
+const DEFAULT_REDIS_SCAN_LIMIT = 1_000;
+const REDIS_SCAN_BATCH_COUNT = 100;
+
 export interface CacheStore {
   readonly name: string;
   get(key: string): unknown;
@@ -207,7 +210,7 @@ class CacheRegistry {
     this.stores.clear();
   }
 
-  scanRedisKeys(pattern: string, limit = 1000): Promise<string[]> {
+  scanRedisKeys(pattern: string, limit = DEFAULT_REDIS_SCAN_LIMIT): Promise<string[]> {
     if (!isRedisConfigured()) return Promise.resolve([]);
 
     return withSpan(
@@ -219,7 +222,10 @@ class CacheRegistry {
           let cursor = 0;
 
           do {
-            const result = await client.scan(cursor, { MATCH: pattern, COUNT: 100 });
+            const result = await client.scan(cursor, {
+              MATCH: pattern,
+              COUNT: REDIS_SCAN_BATCH_COUNT,
+            });
             cursor = typeof result.cursor === "string"
               ? parseInt(result.cursor, 10)
               : result.cursor;

package/src/src/config/environment-config.ts

@@ -75,6 +75,11 @@ export interface EnvironmentConfig {
   veryfrontVersion: string | undefined;
 }
 
+/** Default timeout for incoming HTTP requests (used when REQUEST_TIMEOUT_MS is set but unparseable) */
+const DEFAULT_REQUEST_TIMEOUT_MS = 30_000;
+/** Default timeout for outgoing HTTP fetch calls (used when VF_HTTP_FETCH_TIMEOUT is set but unparseable) */
+const DEFAULT_HTTP_FETCH_TIMEOUT_MS = 30_000;
+
 const DEFAULTS = {
   apiBaseUrl: "https://api.veryfront.com",
   port: 3001,
@@ -142,8 +147,12 @@ function readEnvSnapshot(): EnvironmentConfig {
     appUrl: getEnv("APP_URL") || getEnv("NEXT_PUBLIC_APP_URL") || undefined,
 
     port: parseNumber(getEnv("PORT"), DEFAULTS.port),
-    requestTimeoutMs: requestTimeoutRaw ? parseNumber(requestTimeoutRaw, 30000) : undefined,
-    httpFetchTimeoutMs: httpFetchTimeoutRaw ? parseNumber(httpFetchTimeoutRaw, 30000) : undefined,
+    requestTimeoutMs: requestTimeoutRaw
+      ? parseNumber(requestTimeoutRaw, DEFAULT_REQUEST_TIMEOUT_MS)
+      : undefined,
+    httpFetchTimeoutMs: httpFetchTimeoutRaw
+      ? parseNumber(httpFetchTimeoutRaw, DEFAULT_HTTP_FETCH_TIMEOUT_MS)
+      : undefined,
     ssrMaxConcurrentTransforms: parseNumber(
       getEnv("SSR_MAX_CONCURRENT_TRANSFORMS"),
       DEFAULTS.ssrMaxConcurrentTransforms,

package/src/src/config/loader.ts

@@ -22,6 +22,19 @@ import { registerLRUCache } from "../cache/registry.js";
 
 const logger = serverLogger.component("config");
 
+/** Cache TTL for veryfront-api filesystem in proxy mode */
+const DEFAULT_FS_CACHE_TTL_MS = 60_000;
+/** Maximum retry attempts for veryfront-api filesystem requests */
+const DEFAULT_FS_MAX_RETRIES = 3;
+/** Initial backoff delay between retries */
+const DEFAULT_FS_INITIAL_DELAY_MS = 500;
+/** Maximum backoff delay between retries */
+const DEFAULT_FS_MAX_DELAY_MS = 5_000;
+/** Maximum entries in the render cache */
+const DEFAULT_RENDER_CACHE_MAX_ENTRIES = 500;
+/** Maximum entries in the per-project config cache */
+const DEFAULT_CONFIG_CACHE_MAX_ENTRIES = 100;
+
 export type { VeryfrontConfig } from "./schemas/index.js";
 
 /**
@@ -58,8 +71,12 @@ function getDefaultFsConfig(): VeryfrontConfig["fs"] {
       veryfront: {
         apiBaseUrl,
         proxyMode: true,
-        cache: { enabled: true, ttl: 60000 },
-        retry: { maxRetries: 3, initialDelay: 500, maxDelay: 5000 },
+        cache: { enabled: true, ttl: DEFAULT_FS_CACHE_TTL_MS },
+        retry: {
+          maxRetries: DEFAULT_FS_MAX_RETRIES,
+          initialDelay: DEFAULT_FS_INITIAL_DELAY_MS,
+          maxDelay: DEFAULT_FS_MAX_DELAY_MS,
+        },
       },
     };
   }
@@ -104,7 +121,7 @@ function createFreshDefaults(): Partial<VeryfrontConfig> {
       render: {
         type: "memory",
         ttl: undefined,
-        maxEntries: 500,
+        maxEntries: DEFAULT_RENDER_CACHE_MAX_ENTRIES,
         kvPath: undefined,
         redisUrl: undefined,
         redisKeyPrefix: undefined,
@@ -130,7 +147,7 @@ function createFreshDefaults(): Partial<VeryfrontConfig> {
 }
 
 const configCacheByProject = new LRUCache<string, { revision: number; config: VeryfrontConfig }>({
-  maxEntries: 100,
+  maxEntries: DEFAULT_CONFIG_CACHE_MAX_ENTRIES,
 });
 
 // Register cache for monitoring

package/src/src/config/runtime-config.ts

@@ -11,6 +11,9 @@ import type { VeryfrontConfig } from "./schemas/index.js";
 import type { EnvironmentConfig } from "./environment-config.js";
 import { createTestEnvironmentConfig, getEnvironmentConfig } from "./environment-config.js";
 
+/** Maximum entries in the default render cache */
+const DEFAULT_RENDER_CACHE_MAX_ENTRIES = 500;
+
 /**
  * Runtime-specific configuration derived from environment.
  */
@@ -70,7 +73,7 @@ export const DEFAULT_CONFIG: Partial<VeryfrontConfig> = {
     dir: ".veryfront",
     render: {
       type: "memory",
-      maxEntries: 500,
+      maxEntries: DEFAULT_RENDER_CACHE_MAX_ENTRIES,
     },
   },
   dev: {

package/src/src/data/data-fetcher.ts

@@ -12,8 +12,7 @@ export class DataFetcher {
   private staticFetcher: StaticDataFetcher;
   private pathsFetcher: StaticPathsFetcher;
 
-  // deno-lint-ignore no-unused-vars -- adapter kept for public API compatibility
-  constructor(adapter?: unknown) {
+  constructor(_adapter?: unknown) {
     this.cacheManager = new CacheManager();
     this.serverFetcher = new ServerDataFetcher();
     this.staticFetcher = new StaticDataFetcher(this.cacheManager);

package/src/src/data/static-data-fetcher.ts

@@ -258,8 +258,8 @@ export class StaticDataFetcher {
           });
         }
       });
-    } catch {
-      // Semaphore timeout - too many concurrent revalidations, skip this one
+    } catch (_) {
+      // expected: semaphore timeout when too many concurrent revalidations
       serverLogger.warn("DATA_REVALIDATION_SKIPPED semaphore timeout", {
         pathname,
         cacheKey,

package/src/src/discovery/file-discovery.ts

@@ -50,7 +50,8 @@ export async function findTypeScriptFiles(
         files.push(...(await findTypeScriptFiles(filePath, context)));
       }
     }
-  } catch {
+  } catch (_) {
+    /* expected: directory may not exist or be unreadable */
     return files;
   }
 
@@ -62,7 +63,7 @@ export async function findTypeScriptFiles(
  *
  * Only called when no fsAdapter is present — callers must guard accordingly.
  */
-export async function getNodeDeps(
+async function getNodeDeps(
   context: FileDiscoveryContext,
 ): Promise<{ fs: typeof import("node:fs"); path: typeof import("node:path") }> {
   if (context.nodeDeps) return context.nodeDeps;

package/src/src/discovery/handlers/skill-handler.ts

@@ -17,12 +17,12 @@ import type { FileDiscoveryContext } from "../types.js";
 
 const logger = agentLogger.component("skill-discovery");
 
-export interface SkillDiscoveryError {
+interface SkillDiscoveryError {
   file: string;
   error: Error;
 }
 
-export interface SkillDiscoveryResult {
+interface SkillDiscoveryResult {
   skills: Map<string, Skill>;
   errors: SkillDiscoveryError[];
 }

package/src/src/discovery/import-rewriter.ts

@@ -114,7 +114,8 @@ export async function rewriteDiscoveryImports(
               "index.js";
 
           return pathToFileURL(pathHelper.join(packagePath, entryPoint)).href;
-        } catch {
+        } catch (_) {
+          /* expected: package.json not found at this level, walk up */
           const parent = pathHelper.dirname(searchDir);
           if (parent === searchDir) break;
           searchDir = parent;
@@ -164,7 +165,8 @@ export async function rewriteDiscoveryImports(
       const vfPackageJsonPath = pathHelper.join(vfPackagePath, "package.json");
       const pkgJson = JSON.parse(await fs.readTextFile(vfPackageJsonPath));
       exportsMap = pkgJson.exports || {};
-    } catch {
+    } catch (_) {
+      /* expected: veryfront package.json not found, fallback to deno.json search */
       // Search for deno.json in parent directories
       let searchDir = projectDir;
 
@@ -177,8 +179,8 @@ export async function rewriteDiscoveryImports(
             vfPackagePath = searchDir;
             break;
           }
-        } catch {
-          // continue searching
+        } catch (_) {
+          /* expected: deno.json not found at this level */
         }
         searchDir = pathHelper.dirname(searchDir);
       }
@@ -211,7 +213,8 @@ export async function rewriteDiscoveryImports(
       const resolvedPath = pathHelper.join(vfPackagePath, exportPath);
       return `from "${pathToFileURL(resolvedPath).href}"`;
     });
-  } catch {
+  } catch (_) {
+    /* expected: Node.js URL module unavailable in non-Node runtime */
     return transformed;
   }
 

package/src/src/discovery/transpiler.ts

@@ -15,6 +15,7 @@ import { getEsbuildLoader } from "../utils/path-utils.js";
 import type { FileSystemAdapter } from "../platform/adapters/base.js";
 import type { FileDiscoveryContext } from "./types.js";
 import { rewriteDiscoveryImports, rewriteForDeno } from "./import-rewriter.js";
+import { COMPILATION_ERROR, FILE_NOT_FOUND } from "../errors/index.js";
 import { wrapWithCurrentContext } from "../platform/adapters/fs/veryfront/multi-project-adapter.js";
 // Static import ensures deno compile includes embedding in the binary.
 // Other modules (agent, tool, etc.) are statically imported elsewhere;
@@ -159,7 +160,10 @@ export async function importModule(
       ? await context.fsAdapter.readFile(filePath)
       : await createFileSystem().readTextFile(filePath);
   } catch (error) {
-    throw new Error(`Failed to read file ${filePath}: ${error}`);
+    throw FILE_NOT_FOUND.create({
+      detail: `Failed to read file ${filePath}: ${error}`,
+      cause: error,
+    });
   }
 
   const loader = getEsbuildLoader(filePath);
@@ -208,9 +212,9 @@ export async function importModule(
   });
 
   if (result.errors.length > 0) {
-    throw new Error(
-      `Failed to transpile ${filePath}: ${result.errors[0]?.text ?? "unknown error"}`,
-    );
+    throw COMPILATION_ERROR.create({
+      detail: `Failed to transpile ${filePath}: ${result.errors[0]?.text ?? "unknown error"}`,
+    });
   }
 
   const js = result.outputFiles?.[0]?.text ?? "export {}";