veryfront 0.1.49 → 0.1.51

package/src/src/react/components/ai/agent-card.tsx

@@ -6,12 +6,12 @@ import {
   ToolInvocation,
   ToolResult,
 } from "../../primitives/index.js";
-import type { AgentStatus, Message, ToolCall } from "../../../agent/index.js";
+import type { AgentMessage, AgentStatus, ToolCall } from "../../../agent/index.js";
 import { type AgentTheme, cn, defaultAgentTheme, mergeThemes } from "./theme.js";
 
 export interface AgentCardProps {
   /** Agent messages */
-  messages?: Message[];
+  messages?: AgentMessage[];
 
   /** Tool calls */
   toolCalls?: ToolCall[];
@@ -111,7 +111,7 @@ export const AgentCard = React.forwardRef<HTMLDivElement, AgentCardProps>(
                 Messages
               </h3>
               <div className="space-y-2 max-h-96 overflow-y-auto">
-                {messages!.map((msg) => {
+                {messages?.map((msg) => {
                   const text = msg.parts
                     ?.filter((p): p is { type: "text"; text: string } => p.type === "text")
                     .map((p) => p.text)

package/src/src/react/components/ai/chat/components/code-block.tsx

@@ -17,7 +17,8 @@ export const RichCodeBlock = React.forwardRef<HTMLDivElement, CodeBlockProps>(
     const handleCopy = React.useCallback(async (): Promise<void> => {
       try {
         await navigator.clipboard.writeText(code);
-      } catch {
+      } catch (_) {
+        /* expected: clipboard API unavailable, using fallback */
         const textarea = document.createElement("textarea");
         textarea.value = code;
         document.body.appendChild(textarea);

package/src/src/react/components/ai/chat/components/message-actions.tsx

@@ -34,8 +34,8 @@ export const MessageActions = React.forwardRef<HTMLDivElement, MessageActionsPro
     const handleCopy = React.useCallback(async (): Promise<void> => {
       try {
         await navigator.clipboard.writeText(content);
-      } catch {
-        // Fallback for older browsers
+      } catch (_) {
+        /* expected: clipboard API unavailable in older browsers */
         fallbackCopy();
       } finally {
         setCopiedWithTimeout();

package/src/src/react/components/ai/chat/components/reasoning.tsx

@@ -5,7 +5,7 @@ import { Markdown } from "../../markdown.js";
 import { BrainIcon, ChevronDownIcon } from "../../icons/index.js";
 import { Shimmer } from "./animations.js";
 
-export type ReasoningCardProps = {
+type ReasoningCardProps = {
   text: string;
   isStreaming?: boolean;
   className?: string;

package/src/src/react/components/ai/chat/components/upgrade-cta.tsx

@@ -11,7 +11,8 @@ export function UpgradeCTA({ inferenceMode }: UpgradeCTAProps): React.ReactEleme
   const [dismissed, setDismissed] = React.useState(() => {
     try {
       return localStorage.getItem(DISMISS_KEY) === "1";
-    } catch {
+    } catch (_) {
+      /* expected: localStorage may be unavailable */
       return false;
     }
   });
@@ -22,8 +23,8 @@ export function UpgradeCTA({ inferenceMode }: UpgradeCTAProps): React.ReactEleme
     setDismissed(true);
     try {
       localStorage.setItem(DISMISS_KEY, "1");
-    } catch {
-      // localStorage may be unavailable
+    } catch (_) {
+      /* expected: localStorage may be unavailable */
     }
   };
 

package/src/src/react/components/ai/chat/components/uploads-panel.tsx

@@ -7,6 +7,7 @@ export interface UploadedFile {
   name: string;
   size?: number;
   type?: string;
+  url?: string;
 }
 
 export interface UploadsPanelProps {
@@ -66,9 +67,22 @@ export function UploadsPanel({
                     <FileTextIcon className="size-4" />
                   </div>
                   <div className="flex-1 min-w-0">
-                    <p className="text-sm text-[var(--card-foreground)] truncate">
-                      {doc.name}
-                    </p>
+                    {doc.url
+                      ? (
+                        <a
+                          href={doc.url}
+                          target="_blank"
+                          rel="noreferrer"
+                          className="block truncate text-sm text-[var(--card-foreground)] hover:underline"
+                        >
+                          {doc.name}
+                        </a>
+                      )
+                      : (
+                        <p className="text-sm text-[var(--card-foreground)] truncate">
+                          {doc.name}
+                        </p>
+                      )}
                     {doc.size != null && (
                       <p className="text-xs text-[var(--muted-foreground)]">
                         {formatFileSize(doc.size)}

package/src/src/react/components/ai/chat/composition/message.tsx

@@ -85,7 +85,8 @@ const MessageRoot = React.forwardRef<HTMLDivElement, MessageRootProps>(
     const onCopy = React.useCallback(async () => {
       try {
         await navigator.clipboard.writeText(textContent);
-      } catch {
+      } catch (_) {
+        /* expected: clipboard API unavailable, using fallback */
         const textarea = document.createElement("textarea");
         textarea.value = textContent;
         document.body.appendChild(textarea);
@@ -162,7 +163,7 @@ MessageRoot.displayName = "Message.Root";
 // Message.Avatar
 // ---------------------------------------------------------------------------
 
-export interface MessageAvatarProps {
+interface MessageAvatarProps {
   className?: string;
 }
 
@@ -266,7 +267,7 @@ MessageContent.displayName = "Message.Content";
 // Message.Actions
 // ---------------------------------------------------------------------------
 
-export interface MessageActionsWrapperProps {
+interface MessageActionsWrapperProps {
   className?: string;
 }
 
@@ -283,7 +284,7 @@ MessageActionsWrapper.displayName = "Message.Actions";
 // Message.Feedback
 // ---------------------------------------------------------------------------
 
-export interface MessageFeedbackWrapperProps {
+interface MessageFeedbackWrapperProps {
   className?: string;
 }
 

package/src/src/react/components/ai/chat/contexts/chat-context.tsx

@@ -7,6 +7,7 @@
  */
 
 import * as React from "react";
+import { COMPONENT_ERROR } from "../../../../../errors/index.js";
 import type { UIMessage } from "../../../../../agent/react/index.js";
 import type { ChatTheme } from "../../theme.js";
 import type { ModelOption } from "../../model-selector.js";
@@ -66,7 +67,9 @@ const ChatContext = React.createContext<ChatContextValue | null>(null);
 export function useChatContext(): ChatContextValue {
   const context = React.useContext(ChatContext);
   if (!context) {
-    throw new Error("useChatContext must be used within a ChatRoot or Chat component");
+    throw COMPONENT_ERROR.create({
+      detail: "useChatContext must be used within a ChatRoot or Chat component",
+    });
   }
   return context;
 }

package/src/src/react/components/ai/chat/contexts/composer-context.tsx

@@ -8,6 +8,7 @@
  */
 
 import * as React from "react";
+import { COMPONENT_ERROR } from "../../../../../errors/index.js";
 import type { AttachmentInfo } from "../components/attachment-pill.js";
 import type { ModelOption } from "../../model-selector.js";
 
@@ -47,7 +48,9 @@ const ComposerContext = React.createContext<ComposerContextValue | null>(null);
 export function useComposerContext(): ComposerContextValue {
   const context = React.useContext(ComposerContext);
   if (!context) {
-    throw new Error("useComposerContext must be used within a Composer or Chat component");
+    throw COMPONENT_ERROR.create({
+      detail: "useComposerContext must be used within a Composer or Chat component",
+    });
   }
   return context;
 }

package/src/src/react/components/ai/chat/contexts/message-context.tsx

@@ -8,6 +8,7 @@
  */
 
 import * as React from "react";
+import { COMPONENT_ERROR } from "../../../../../errors/index.js";
 import type { BranchInfo, UIMessage } from "../../../../../agent/react/index.js";
 import type { FeedbackValue } from "../components/message-feedback.js";
 import type { PartGroup } from "../utils/message-parts.js";
@@ -37,7 +38,9 @@ const MessageContext = React.createContext<MessageContextValue | null>(null);
 export function useMessageContext(): MessageContextValue {
   const context = React.useContext(MessageContext);
   if (!context) {
-    throw new Error("useMessageContext must be used within a Message component");
+    throw COMPONENT_ERROR.create({
+      detail: "useMessageContext must be used within a Message component",
+    });
   }
   return context;
 }

package/src/src/react/components/ai/chat/contexts/thread-list-context.tsx

@@ -8,6 +8,7 @@
  */
 
 import * as React from "react";
+import { COMPONENT_ERROR } from "../../../../../errors/index.js";
 import type { Thread } from "../hooks/use-threads.js";
 
 export interface ThreadListContextValue {
@@ -28,7 +29,9 @@ const ThreadListContext = React.createContext<ThreadListContextValue | null>(nul
 export function useThreadListContext(): ThreadListContextValue {
   const context = React.useContext(ThreadListContext);
   if (!context) {
-    throw new Error("useThreadListContext must be used within a ThreadList provider");
+    throw COMPONENT_ERROR.create({
+      detail: "useThreadListContext must be used within a ThreadList provider",
+    });
   }
   return context;
 }

package/src/src/react/components/ai/chat/hooks/use-threads.ts

@@ -50,7 +50,7 @@ function loadIndex(key: string): ThreadIndex {
   try {
     const raw = localStorage.getItem(`${key}-index`);
     if (raw) return JSON.parse(raw) as ThreadIndex;
-  } catch { /* corrupted */ }
+  } catch (_) { /* expected: corrupted localStorage data */ }
   return { ids: [] };
 }
 
@@ -64,7 +64,7 @@ function loadThread(key: string, id: string): Thread | null {
   try {
     const raw = localStorage.getItem(`${key}-${id}`);
     if (raw) return JSON.parse(raw) as Thread;
-  } catch { /* corrupted */ }
+  } catch (_) { /* expected: corrupted localStorage data */ }
   return null;
 }
 

package/src/src/react/components/ai/theme.ts

@@ -19,7 +19,7 @@ export { cva, type VariantProps } from "class-variance-authority";
  * Light-mode defaults that match the Veryfront Studio `:root` values.
  * Uses OKLch for perceptual uniformity.
  */
-export const TOKENS_LIGHT = {
+const TOKENS_LIGHT = {
   "--background": "oklch(0.9512 0.008 98.88)",
   "--foreground": "oklch(0.2768 0 0)",
   "--card": "oklch(1 0 0)",
@@ -54,7 +54,7 @@ export const TOKENS_LIGHT = {
 /**
  * Dark-mode defaults that match the Studio `[data-theme="dark"]` values.
  */
-export const TOKENS_DARK = {
+const TOKENS_DARK = {
   "--background": "oklch(0.2768 0 0)",
   "--foreground": "oklch(0.9512 0.008 98.88)",
   "--card": "oklch(0.3211 0 0)",

package/src/src/react/head-collector.ts

@@ -23,7 +23,7 @@ export interface HeadLink {
   [key: string]: string | undefined;
 }
 
-export interface HeadScript {
+interface HeadScript {
   /** Inline script content */
   content?: string;
   /** Script src URL */

package/src/src/react/primitives/input-box.tsx

@@ -41,8 +41,7 @@ export const InputBox = React.forwardRef<
   if (multiline) {
     return (
       <textarea
-        // deno-lint-ignore no-explicit-any
-        ref={textareaRef as any}
+        ref={textareaRef as React.RefObject<HTMLTextAreaElement>}
         className={className}
         style={{ resize: "none", border: "none", outline: "none" }}
         value={value}
@@ -58,8 +57,7 @@ export const InputBox = React.forwardRef<
 
   return (
     <input
-      // deno-lint-ignore no-explicit-any
-      ref={ref as any}
+      ref={ref as React.RefObject<HTMLInputElement>}
       type="text"
       className={className}
       value={value}

package/src/src/rendering/app-reserved.ts

@@ -99,8 +99,8 @@ export async function tryLoadReservedInDirs(
           contentSourceId,
         });
         if (typeof Cmp === "function") return Cmp as ReservedComponent;
-      } catch {
-        // Component not found in this path, continue to next
+      } catch (_) {
+        /* expected: component not found in this path, continue to next */
       }
     }
   }

package/src/src/rendering/app-route-resolver.ts

@@ -85,8 +85,8 @@ async function tryDynamicMatch(
         currentDir = exactPath;
         continue;
       }
-    } catch {
-      // Exact match failed, try dynamic segments
+    } catch (_) {
+      /* expected: exact path may not exist, try dynamic segments */
     }
 
     const dynamic = await findDynamicDir(currentDir, adapter);
@@ -115,8 +115,8 @@ async function findDynamicDir(
       if (!entry.isDirectory || !isDynamicSegment(entry.name)) continue;
       return { name: entry.name, isCatchAll: entry.name.startsWith("[...") };
     }
-  } catch {
-    // adapter.fs.readDir failed - no fallback to Deno for npm compatibility
+  } catch (_) {
+    /* expected: adapter.fs.readDir may fail for npm compatibility */
   }
 
   return null;
@@ -130,14 +130,16 @@ async function tryLoadPageFile(
   try {
     const info = await adapter.fs.stat(file);
     if (!info.isFile) return null;
-  } catch {
+  } catch (_) {
+    /* expected: file may not exist */
     return null;
   }
 
   let raw: string;
   try {
     raw = await adapter.fs.readFile(file);
-  } catch {
+  } catch (_) {
+    /* expected: file may not be readable */
     return null;
   }
 
@@ -149,9 +151,8 @@ async function tryLoadPageFile(
       const ex = extract(raw);
       content = ex.body;
       fm = (ex.attrs as Record<string, unknown>) ?? {};
-    } catch {
-      // Malformed frontmatter - use raw content as-is
-      // This allows pages with invalid YAML to still render
+    } catch (_) {
+      /* expected: malformed frontmatter - use raw content as-is */
       content = raw;
     }
   }

package/src/src/rendering/cache/cache-coordinator.ts

@@ -4,6 +4,9 @@ import type { CachePayload, CacheStore } from "./types.js";
 import { MemoryCacheStore, type MemoryCacheStoreOptions } from "./stores/index.js";
 import { withSpan } from "../../observability/tracing/otlp-setup.js";
 
+/** Default TTL for cache entries (5 minutes) */
+const DEFAULT_CACHE_TTL_MS = 5 * 60 * 1_000;
+
 export interface CacheCoordinatorOptions {
   store?: CacheStore;
   memory?: MemoryCacheStoreOptions;
@@ -37,7 +40,7 @@ export interface CacheLookupResult {
 export class CacheCoordinator {
   private store: CacheStore;
   private ttlMs: number | undefined;
-  private readonly defaultTtlMs = 5 * 60 * 1000; // 5 minutes
+  private readonly defaultTtlMs = DEFAULT_CACHE_TTL_MS;
   private readonly projectId: string | undefined;
   private readonly contentSourceId: string | undefined;
   private readonly cachePrefix: string;

package/src/src/rendering/cache/stores/api-store.ts

@@ -5,6 +5,11 @@ import { type CacheBackend, createCacheBackend } from "../../../cache/backend.js
 
 const logger = rendererLogger.component("api-cache-store");
 
+/** Default TTL for distributed cache entries (1 hour) */
+const DEFAULT_TTL_SECONDS = 3_600;
+/** Default max entries for the local memory cache (fast reads) */
+const DEFAULT_LOCAL_MAX_ENTRIES = 200;
+
 export interface APICacheStoreOptions {
   /** Key prefix for cache entries */
   keyPrefix?: string;
@@ -47,12 +52,12 @@ export class APICacheStore implements CacheStore {
 
   constructor(options: APICacheStoreOptions = {}) {
     this.keyPrefix = options.keyPrefix ?? "render";
-    this.ttlSeconds = options.ttlSeconds ?? 3600; // 1 hour default
+    this.ttlSeconds = options.ttlSeconds ?? DEFAULT_TTL_SECONDS;
 
     const enableLocalCache = options.enableLocalCache ?? true;
     this.localCache = enableLocalCache
       ? new MemoryCacheStore({
-        maxEntries: options.localMaxEntries ?? 200,
+        maxEntries: options.localMaxEntries ?? DEFAULT_LOCAL_MAX_ENTRIES,
         ttlMs: this.ttlSeconds * 1000,
       })
       : null;
@@ -62,25 +67,26 @@ export class APICacheStore implements CacheStore {
     if (this.backend) return Promise.resolve(this.backend);
     if (this.backendInitPromise) return this.backendInitPromise;
 
-    this.backendInitPromise = createCacheBackend({
-      keyPrefix: this.keyPrefix,
-      preferredBackend: "api",
-    })
-      .then((backend) => {
+    this.backendInitPromise = (async () => {
+      try {
+        const backend = await createCacheBackend({
+          keyPrefix: this.keyPrefix,
+          preferredBackend: "api",
+        });
         this.backend = backend;
         logger.debug("Distributed cache initialized", {
           type: backend.type,
         });
         return backend;
-      })
-      .catch((error) => {
+      } catch (error) {
         logger.warn(
           "[APICacheStore] Failed to init distributed cache, skipping fallback",
           { error },
         );
         this.backend = null;
         throw error;
-      });
+      }
+    })();
 
     return this.backendInitPromise;
   }
@@ -153,14 +159,17 @@ export class APICacheStore implements CacheStore {
 
     await this.localCache?.set(key, value);
 
-    this.getBackend()
-      .then((backend) => backend.set(key, this.serialize(value), this.ttlSeconds))
-      .catch((error) => {
+    void (async () => {
+      try {
+        const backend = await this.getBackend();
+        await backend.set(key, this.serialize(value), this.ttlSeconds);
+      } catch (error) {
         logger.debug(
           "[APICacheStore] Failed to store in distributed cache (no fallback)",
           { key, error },
         );
-      });
+      }
+    })();
   }
 
   async delete(key: string): Promise<void> {

package/src/src/rendering/cache/stores/filesystem-store.ts

@@ -28,7 +28,8 @@ export class FilesystemCacheStore implements CacheStore {
 
     try {
       return JSON.parse(file) as CachePayload;
-    } catch {
+    } catch (_) {
+      /* expected: cached file may contain malformed JSON */
       return undefined;
     }
   }
@@ -47,8 +48,8 @@ export class FilesystemCacheStore implements CacheStore {
     try {
       const fs = await this.getLocalFS();
       await fs.remove(filePath);
-    } catch {
-      // ignore missing files
+    } catch (_) {
+      /* expected: file may not exist */
     }
   }
 
@@ -65,8 +66,8 @@ export class FilesystemCacheStore implements CacheStore {
         await fs.remove(join(this.baseDir, entry.name));
         deleted++;
       }
-    } catch {
-      // ignore missing dir or read errors
+    } catch (_) {
+      /* expected: directory may not exist or read errors */
     }
 
     return deleted;
@@ -76,8 +77,8 @@ export class FilesystemCacheStore implements CacheStore {
     try {
       const fs = await this.getLocalFS();
       await fs.remove(this.baseDir, { recursive: true });
-    } catch {
-      // ignore
+    } catch (_) {
+      /* expected: directory may not exist */
     }
   }
 
@@ -105,7 +106,8 @@ export class FilesystemCacheStore implements CacheStore {
     try {
       const fs = await this.getLocalFS();
       return await fs.readFile(filePath);
-    } catch {
+    } catch (_) {
+      /* expected: cache file may not exist */
       return null;
     }
   }

package/src/src/rendering/cache/stores/memory-store.ts

@@ -15,7 +15,7 @@ import type { CachePayload, CacheStore } from "../types.js";
 
 const DEFAULT_MAX_ENTRIES = 100;
 
-export interface CacheLike<K, V> {
+interface CacheLike<K, V> {
   get(key: K): V | undefined;
   set(key: K, value: V): void;
   delete(key: K): void;

package/src/src/rendering/cache/stores/redis-store.ts

@@ -16,7 +16,13 @@ interface RedisClient {
 }
 
 /** Default TTL for Redis cache entries (1 hour) */
-const DEFAULT_TTL_SECONDS = 3600;
+const DEFAULT_TTL_SECONDS = 3_600;
+/** Max entries for the in-memory fallback cache when Redis is unavailable */
+const FALLBACK_MAX_ENTRIES = 100;
+/** Number of keys to scan per Redis SCAN iteration */
+const REDIS_SCAN_COUNT = 100;
+/** Smaller scan batch size for clear operations (deletes each key inline) */
+const REDIS_CLEAR_SCAN_COUNT = 50;
 
 export interface RedisCacheStoreOptions {
   url?: string;
@@ -46,9 +52,9 @@ export class RedisCacheStore implements CacheStore {
   private getFallbackStore(): MemoryCacheStore {
     if (this.fallbackStore) return this.fallbackStore;
 
-    // Small fallback cache (100 entries) for when Redis is unavailable
+    // Small fallback cache for when Redis is unavailable
     this.fallbackStore = new MemoryCacheStore({
-      maxEntries: 100,
+      maxEntries: FALLBACK_MAX_ENTRIES,
       ttlMs: this.ttlSeconds * 1000,
     });
     logger.warn("Redis unavailable, using memory cache fallback");
@@ -65,7 +71,8 @@ export class RedisCacheStore implements CacheStore {
       const redisClientModule = ["npm:@redis/client", "@1.5.8"].join("");
       const mod = await import(redisClientModule);
       createClient = mod.createClient as (options: { url?: string }) => RedisClient;
-    } catch {
+    } catch (_) {
+      /* expected: redis client package may not be installed */
       throw toError(
         createError({
           type: "render",
@@ -119,7 +126,8 @@ export class RedisCacheStore implements CacheStore {
 
       try {
         return JSON.parse(raw) as CachePayload;
-      } catch {
+      } catch (_) {
+        /* expected: cached data may be corrupted or malformed JSON */
         return undefined;
       }
     } catch (error) {
@@ -189,7 +197,7 @@ export class RedisCacheStore implements CacheStore {
       do {
         const [nextCursor, keys] = await client.scan(cursor, {
           MATCH: `${this.keyPrefix}${prefix}*`,
-          COUNT: 100,
+          COUNT: REDIS_SCAN_COUNT,
         });
         cursor = nextCursor;
         if (keys.length) keysToDelete.push(...keys);
@@ -225,7 +233,7 @@ export class RedisCacheStore implements CacheStore {
       do {
         const [nextCursor, keys] = await client.scan(cursor, {
           MATCH: `${this.keyPrefix}*`,
-          COUNT: 50,
+          COUNT: REDIS_CLEAR_SCAN_COUNT,
         });
         cursor = nextCursor;
 

package/src/src/rendering/component-handling.ts

@@ -13,7 +13,7 @@ import { buildComponentCacheKey } from "../cache/keys.js";
 import { LRUCache } from "../utils/lru-wrapper.js";
 import { registerLRUCache } from "../cache/index.js";
 
-export interface ComponentPageResult {
+interface ComponentPageResult {
   pageElement: BundledReact.ReactElement;
   pageBundle: PageBundle;
 }
@@ -24,7 +24,7 @@ export interface ComponentPageResult {
  * Safe for multi-tenant use (project-scoped + content-hashed).
  * Evicted when exceeding MAX_COMPONENT_CACHE_SIZE to prevent unbounded memory growth.
  */
-const MAX_COMPONENT_CACHE_SIZE = 5000;
+const MAX_COMPONENT_CACHE_SIZE = 5_000;
 const componentHydrationCache = new LRUCache<string, string>({
   maxEntries: MAX_COMPONENT_CACHE_SIZE,
 });

package/src/src/rendering/context/render-context.ts

@@ -2,6 +2,7 @@ import type { RuntimeAdapter } from "../../platform/adapters/base.js";
 import type { VeryfrontConfig } from "../../config/index.js";
 import type { HandlerContext } from "../../types/index.js";
 import type { EnrichedContext } from "../../server/context/enriched-context.js";
+import { INVALID_ARGUMENT } from "../../errors/error-registry.js";
 import {
   buildRenderCacheKey,
   buildRenderCachePrefix,
@@ -42,10 +43,12 @@ export function createRenderContext(
 ): RenderContext {
   if (ctx.enriched) return createRenderContextFromEnriched(ctx.enriched, options);
 
-  if (!ctx.config) throw new Error("RenderContext requires config to be pre-loaded");
-  if (!ctx.adapter) throw new Error("RenderContext requires adapter");
+  if (!ctx.config) {
+    throw INVALID_ARGUMENT.create({ detail: "RenderContext requires config to be pre-loaded" });
+  }
+  if (!ctx.adapter) throw INVALID_ARGUMENT.create({ detail: "RenderContext requires adapter" });
   if (!ctx.projectSlug && !ctx.projectId) {
-    throw new Error("RenderContext requires projectSlug or projectId");
+    throw INVALID_ARGUMENT.create({ detail: "RenderContext requires projectSlug or projectId" });
   }
 
   const environment: RenderEnvironment = ctx.requestContext?.mode ?? "preview";
@@ -98,10 +101,16 @@ export function createRenderContextFromEnriched(
   enriched: EnrichedContext,
   options?: CreateRenderContextOptions,
 ): RenderContext {
-  if (!enriched.config) throw new Error("EnrichedContext is missing required config");
-  if (!enriched.adapter) throw new Error("EnrichedContext is missing required adapter");
+  if (!enriched.config) {
+    throw INVALID_ARGUMENT.create({ detail: "EnrichedContext is missing required config" });
+  }
+  if (!enriched.adapter) {
+    throw INVALID_ARGUMENT.create({ detail: "EnrichedContext is missing required adapter" });
+  }
   if (!enriched.contentSourceId) {
-    throw new Error("EnrichedContext is missing required contentSourceId");
+    throw INVALID_ARGUMENT.create({
+      detail: "EnrichedContext is missing required contentSourceId",
+    });
   }
 
   return {