veryfront 0.1.501 → 0.1.503

package/esm/src/config/schemas/config.schema.js

@@ -1,93 +1,93 @@
-import { z } from "zod";
+import { defineSchema } from "../../schemas/index.js";
 import { createError, toError } from "../../errors/veryfront-error.js";
 // Sub-schemas
-const corsSchema = z.union([z.boolean(), z.object({ origin: z.string().optional() }).strict()]);
-const basicAuthSchema = z.object({
-    username: z.string(),
-    password: z.string(),
-    realm: z.string().optional(),
-});
-const bearerAuthSchema = z.object({
-    token: z.string(),
-});
-const embeddingDimensionSchema = z.union([
-    z.literal(768),
-    z.literal(1024),
-    z.literal(1536),
-    z.literal(3072),
-    z.literal(4096),
-]);
+const getCorsSchema = defineSchema((v) => v.union([v.boolean(), v.object({ origin: v.string().optional() }).strict()]));
+const getBasicAuthSchema = defineSchema((v) => v.object({
+    username: v.string(),
+    password: v.string(),
+    realm: v.string().optional(),
+}));
+const getBearerAuthSchema = defineSchema((v) => v.object({
+    token: v.string(),
+}));
+const getEmbeddingDimensionSchema = defineSchema((v) => v.union([
+    v.literal(768),
+    v.literal(1024),
+    v.literal(1536),
+    v.literal(3072),
+    v.literal(4096),
+]));
 // Main config schema
-export const veryfrontConfigSchema = z
+export const getVeryfrontConfigSchema = defineSchema((v) => v
     .object({
-    projectSlug: z.string().optional(),
-    title: z.string().optional(),
-    description: z.string().optional(),
-    react: z
+    projectSlug: v.string().optional(),
+    title: v.string().optional(),
+    description: v.string().optional(),
+    react: v
         .object({
         /** React version to use (e.g., "18.3.1", "19.1.1"). Defaults to auto-detect from package.json or 19.1.1 */
-        version: z.string().optional(),
+        version: v.string().optional(),
     })
         .partial()
         .optional(),
-    directories: z
+    directories: v
         .object({
-        app: z.string().optional(),
-        pages: z.string().optional(),
-        components: z.array(z.string()).optional(),
-        ai: z.string().optional(),
+        app: v.string().optional(),
+        pages: v.string().optional(),
+        components: v.array(v.string()).optional(),
+        ai: v.string().optional(),
     })
         .partial()
         .optional(),
-    experimental: z
+    experimental: v
         .object({
-        esmLayouts: z.boolean().optional(),
-        precompileMDX: z.boolean().optional(),
-        rsc: z.boolean().optional(),
+        esmLayouts: v.boolean().optional(),
+        precompileMDX: v.boolean().optional(),
+        rsc: v.boolean().optional(),
     })
         .partial()
         .optional(),
-    router: z.enum(["app", "pages"]).optional(),
+    router: v.enum(["app", "pages"]).optional(),
     /** Path to the layout component (e.g., 'components/layout.tsx'), or false to disable */
-    layout: z.union([z.string(), z.literal(false)]).optional(),
+    layout: v.union([v.string(), v.literal(false)]).optional(),
     /** Path to the app wrapper component (e.g., 'components/app.tsx'), or false to disable */
-    app: z.union([z.string(), z.literal(false)]).optional(),
-    theme: z.object({ colors: z.record(z.string(), z.string()).optional() }).partial().optional(),
-    build: z
+    app: v.union([v.string(), v.literal(false)]).optional(),
+    theme: v.object({ colors: v.record(v.string(), v.string()).optional() }).partial().optional(),
+    build: v
         .object({
-        outDir: z.string().optional(),
-        trailingSlash: z.boolean().optional(),
-        esbuild: z
+        outDir: v.string().optional(),
+        trailingSlash: v.boolean().optional(),
+        esbuild: v
             .object({
-            wasmURL: z.string().url().optional(),
-            worker: z.boolean().optional(),
+            wasmURL: v.string().url().optional(),
+            worker: v.boolean().optional(),
         })
             .partial()
             .optional(),
     })
         .partial()
         .optional(),
-    cache: z
+    cache: v
         .object({
-        dir: z.string().optional(),
-        bundleManifest: z
+        dir: v.string().optional(),
+        bundleManifest: v
             .object({
-            type: z.enum(["redis", "kv", "memory"]).optional(),
-            redisUrl: z.string().optional(),
-            keyPrefix: z.string().optional(),
-            ttl: z.number().int().positive().optional(),
-            enabled: z.boolean().optional(),
+            type: v.enum(["redis", "kv", "memory"]).optional(),
+            redisUrl: v.string().optional(),
+            keyPrefix: v.string().optional(),
+            ttl: v.number().int().positive().optional(),
+            enabled: v.boolean().optional(),
         })
             .partial()
             .optional(),
-        render: z
+        render: v
             .object({
-            type: z.enum(["memory", "filesystem", "kv", "redis"]).optional(),
-            ttl: z.number().optional(),
-            maxEntries: z.number().optional(),
-            kvPath: z.string().optional(),
-            redisUrl: z.string().optional(),
-            redisKeyPrefix: z.string().optional(),
+            type: v.enum(["memory", "filesystem", "kv", "redis"]).optional(),
+            ttl: v.number().optional(),
+            maxEntries: v.number().optional(),
+            kvPath: v.string().optional(),
+            redisUrl: v.string().optional(),
+            redisKeyPrefix: v.string().optional(),
         })
             .partial()
             .optional(),
@@ -109,53 +109,53 @@ export const veryfrontConfigSchema = z
          * // Only vary cache by specific params
          * cache: { queryParams: { policy: "include-list", params: ["page", "sort"] } }
          */
-        queryParams: z
+        queryParams: v
             .object({
-            policy: z.enum(["ignore-all", "include-all", "include-list", "exclude-list"])
+            policy: v.enum(["ignore-all", "include-all", "include-list", "exclude-list"])
                 .optional(),
-            params: z.array(z.string()).optional(),
+            params: v.array(v.string()).optional(),
         })
             .partial()
             .optional(),
     })
         .partial()
         .optional(),
-    dev: z
+    dev: v
         .object({
-        port: z.number().int().positive().optional(),
-        host: z.string().optional(),
-        open: z.boolean().optional(),
-        hmr: z.boolean().optional(),
-        hmrPort: z.number().optional(),
-        components: z.array(z.string()).optional(),
-        moduleServerUrl: z.string().optional(),
+        port: v.number().int().positive().optional(),
+        host: v.string().optional(),
+        open: v.boolean().optional(),
+        hmr: v.boolean().optional(),
+        hmrPort: v.number().optional(),
+        components: v.array(v.string()).optional(),
+        moduleServerUrl: v.string().optional(),
     })
         .partial()
         .optional(),
-    resolve: z
+    resolve: v
         .object({
-        importMap: z
+        importMap: v
             .object({
-            imports: z.record(z.string(), z.string()).optional(),
-            scopes: z.record(z.string(), z.record(z.string(), z.string())).optional(),
+            imports: v.record(v.string(), v.string()).optional(),
+            scopes: v.record(v.string(), v.record(v.string(), v.string())).optional(),
         })
             .partial()
             .optional(),
     })
         .partial()
         .optional(),
-    security: z
+    security: v
         .object({
-        auth: z
+        auth: v
             .object({
-            basic: basicAuthSchema.optional(),
-            bearer: bearerAuthSchema.optional(),
+            basic: getBasicAuthSchema().optional(),
+            bearer: getBearerAuthSchema().optional(),
         })
             .partial()
             .optional(),
-        csp: z.record(z.string(), z.array(z.string())).optional(),
-        remoteHosts: z.array(z.string().url()).optional(),
-        cors: corsSchema.optional(),
+        csp: v.record(v.string(), v.array(v.string())).optional(),
+        remoteHosts: v.array(v.string().url()).optional(),
+        cors: getCorsSchema().optional(),
         /**
          * CSRF protection using the double-submit cookie pattern.
          * Set `true` for defaults, or pass an object to customize.
@@ -167,105 +167,105 @@ export const veryfrontConfigSchema = z
          * Server Actions (`/_veryfront/rsc/action`) are CSRF-protected;
          * client code must forward the cookie value as the header.
          */
-        csrf: z.union([
-            z.boolean(),
-            z.object({
-                cookieName: z.string().optional(),
-                headerName: z.string().optional(),
-                excludePaths: z.array(z.string()).optional(),
-                ttlSec: z.number().int().positive().optional(),
+        csrf: v.union([
+            v.boolean(),
+            v.object({
+                cookieName: v.string().optional(),
+                headerName: v.string().optional(),
+                excludePaths: v.array(v.string()).optional(),
+                ttlSec: v.number().int().positive().optional(),
             }).strict(),
         ]).optional(),
-        coop: z.enum(["same-origin", "same-origin-allow-popups", "unsafe-none"]).optional(),
-        corp: z.enum(["same-origin", "same-site", "cross-origin"]).optional(),
-        coep: z.enum(["require-corp", "unsafe-none"]).optional(),
+        coop: v.enum(["same-origin", "same-origin-allow-popups", "unsafe-none"]).optional(),
+        corp: v.enum(["same-origin", "same-site", "cross-origin"]).optional(),
+        coep: v.enum(["require-corp", "unsafe-none"]).optional(),
         /**
          * Restrict module imports to specific directories (opt-in security).
          * When not set, users can import from any directory in the project.
          * When set, only imports from these directories are allowed.
          * @example ["app", "pages", "components", "lib", "src", "utils"]
          */
-        allowedImportDirs: z.array(z.string()).optional(),
+        allowedImportDirs: v.array(v.string()).optional(),
     })
         .partial()
         .optional(),
-    middleware: z
+    middleware: v
         .object({
-        custom: z.array(z.any()).optional(),
+        custom: v.array(v.any()).optional(),
     })
         .partial()
         .optional(),
-    theming: z
+    theming: v
         .object({
-        brandName: z.string().optional(),
-        logoHtml: z.string().optional(),
+        brandName: v.string().optional(),
+        logoHtml: v.string().optional(),
     })
         .partial()
         .optional(),
-    assetPipeline: z
+    assetPipeline: v
         .object({
-        images: z
+        images: v
             .object({
-            enabled: z.boolean().optional(),
-            formats: z.array(z.enum(["webp", "avif", "jpeg", "png"])).optional(),
-            sizes: z.array(z.number().int().positive()).optional(),
-            quality: z.number().int().min(1).max(100).optional(),
-            inputDir: z.string().optional(),
-            outputDir: z.string().optional(),
-            preserveOriginal: z.boolean().optional(),
+            enabled: v.boolean().optional(),
+            formats: v.array(v.enum(["webp", "avif", "jpeg", "png"])).optional(),
+            sizes: v.array(v.number().int().positive()).optional(),
+            quality: v.number().int().min(1).max(100).optional(),
+            inputDir: v.string().optional(),
+            outputDir: v.string().optional(),
+            preserveOriginal: v.boolean().optional(),
         })
             .partial()
             .optional(),
-        css: z
+        css: v
             .object({
-            enabled: z.boolean().optional(),
-            minify: z.boolean().optional(),
-            autoprefixer: z.boolean().optional(),
-            purge: z.boolean().optional(),
-            criticalCSS: z.boolean().optional(),
-            inputDir: z.string().optional(),
-            outputDir: z.string().optional(),
-            browsers: z.array(z.string()).optional(),
-            purgeContent: z.array(z.string()).optional(),
-            sourceMap: z.boolean().optional(),
+            enabled: v.boolean().optional(),
+            minify: v.boolean().optional(),
+            autoprefixer: v.boolean().optional(),
+            purge: v.boolean().optional(),
+            criticalCSS: v.boolean().optional(),
+            inputDir: v.string().optional(),
+            outputDir: v.string().optional(),
+            browsers: v.array(v.string()).optional(),
+            purgeContent: v.array(v.string()).optional(),
+            sourceMap: v.boolean().optional(),
         })
             .partial()
             .optional(),
     })
         .partial()
         .optional(),
-    observability: z
+    observability: v
         .object({
-        tracing: z
+        tracing: v
             .object({
-            enabled: z.boolean().optional(),
-            exporter: z.enum(["jaeger", "zipkin", "otlp", "console"]).optional(),
-            endpoint: z.string().optional(),
-            serviceName: z.string().optional(),
-            sampleRate: z.number().min(0).max(1).optional(),
+            enabled: v.boolean().optional(),
+            exporter: v.enum(["jaeger", "zipkin", "otlp", "console"]).optional(),
+            endpoint: v.string().optional(),
+            serviceName: v.string().optional(),
+            sampleRate: v.number().min(0).max(1).optional(),
         })
             .partial()
             .optional(),
-        metrics: z
+        metrics: v
             .object({
-            enabled: z.boolean().optional(),
-            exporter: z.enum(["prometheus", "otlp", "console"]).optional(),
-            endpoint: z.string().optional(),
-            prefix: z.string().optional(),
-            collectInterval: z.number().int().positive().optional(),
+            enabled: v.boolean().optional(),
+            exporter: v.enum(["prometheus", "otlp", "console"]).optional(),
+            endpoint: v.string().optional(),
+            prefix: v.string().optional(),
+            collectInterval: v.number().int().positive().optional(),
         })
             .partial()
             .optional(),
-        logging: z
+        logging: v
             .object({
-            file: z
+            file: v
                 .object({
-                enabled: z.boolean().optional(),
-                path: z.string().optional(),
-                maxSize: z.union([z.number().int().positive(), z.string()]).optional(),
-                maxFiles: z.number().int().positive().optional(),
-                level: z.enum(["debug", "info", "warn", "error"]).optional(),
-                format: z.enum(["json", "text"]).optional(),
+                enabled: v.boolean().optional(),
+                path: v.string().optional(),
+                maxSize: v.union([v.number().int().positive(), v.string()]).optional(),
+                maxFiles: v.number().int().positive().optional(),
+                level: v.enum(["debug", "info", "warn", "error"]).optional(),
+                format: v.enum(["json", "text"]).optional(),
             })
                 .partial()
                 .optional(),
@@ -275,96 +275,97 @@ export const veryfrontConfigSchema = z
     })
         .partial()
         .optional(),
-    search: z
+    search: v
         .object({
-        enabled: z.boolean().optional(),
-        embedding: z
+        enabled: v.boolean().optional(),
+        embedding: v
             .object({
-            provider: z.enum(["openai", "cohere", "voyageai", "custom"]).optional(),
-            model: z.string().optional(),
-            dimension: embeddingDimensionSchema.optional(),
-            apiKey: z.string().optional(),
-            batchSize: z.number().int().positive().optional(),
+            provider: v.enum(["openai", "cohere", "voyageai", "custom"]).optional(),
+            model: v.string().optional(),
+            dimension: getEmbeddingDimensionSchema().optional(),
+            apiKey: v.string().optional(),
+            batchSize: v.number().int().positive().optional(),
         })
             .partial()
             .optional(),
-        chunking: z
+        chunking: v
             .object({
-            maxTokens: z.number().int().positive().optional(),
-            overlapTokens: z.number().int().min(0).optional(),
-            include: z.array(z.string()).optional(),
-            exclude: z.array(z.string()).optional(),
+            maxTokens: v.number().int().positive().optional(),
+            overlapTokens: v.number().int().min(0).optional(),
+            include: v.array(v.string()).optional(),
+            exclude: v.array(v.string()).optional(),
         })
             .partial()
             .optional(),
-        autoIndex: z.boolean().optional(),
+        autoIndex: v.boolean().optional(),
     })
         .partial()
         .optional(),
-    fs: z
+    fs: v
         .object({
-        type: z.enum(["local", "veryfront-api", "memory", "github"]).optional(),
-        local: z.object({ baseDir: z.string().optional() }).partial().optional(),
-        veryfront: z
+        type: v.enum(["local", "veryfront-api", "memory", "github"]).optional(),
+        local: v.object({ baseDir: v.string().optional() }).partial().optional(),
+        veryfront: v
             .object({
-            apiBaseUrl: z.string().url(),
+            apiBaseUrl: v.string().url(),
             /** API token - optional in proxy mode (token provided per-request via headers) */
-            apiToken: z.string().optional(),
+            apiToken: v.string().optional(),
             /** Project slug - optional in proxy mode (slug provided per-request via headers) */
-            projectSlug: z.string().optional(),
+            projectSlug: v.string().optional(),
             /** Enable proxy mode for multi-project handling (tokens/slugs from headers) */
-            proxyMode: z.boolean().optional(),
+            proxyMode: v.boolean().optional(),
             /** Production mode - fetch from releases instead of draft files */
-            productionMode: z.boolean().optional(),
-            cache: z
+            productionMode: v.boolean().optional(),
+            cache: v
                 .object({
-                enabled: z.boolean().optional(),
-                ttl: z.number().int().positive().optional(),
-                maxSize: z.number().int().positive().optional(),
+                enabled: v.boolean().optional(),
+                ttl: v.number().int().positive().optional(),
+                maxSize: v.number().int().positive().optional(),
             })
                 .partial()
                 .optional(),
-            retry: z
+            retry: v
                 .object({
-                maxRetries: z.number().int().min(0).optional(),
-                initialDelay: z.number().int().positive().optional(),
-                maxDelay: z.number().int().positive().optional(),
+                maxRetries: v.number().int().min(0).optional(),
+                initialDelay: v.number().int().positive().optional(),
+                maxDelay: v.number().int().positive().optional(),
             })
                 .partial()
                 .optional(),
         })
             .partial()
             .optional(),
-        memory: z
+        memory: v
             .object({
-            files: z.record(z.string(), z.union([z.string(), z.instanceof(Uint8Array)])).optional(),
+            files: v.record(v.string(), v.union([v.string(), v.instanceof(Uint8Array)]))
+                .optional(),
         })
             .partial()
             .optional(),
-        github: z
+        github: v
             .object({
             /** GitHub Personal Access Token */
-            token: z.string(),
+            token: v.string(),
             /** Repository owner (user or organization) */
-            owner: z.string(),
+            owner: v.string(),
             /** Repository name */
-            repo: z.string(),
+            repo: v.string(),
             /** Branch, tag, or commit SHA (default: "main") */
-            ref: z.string().optional(),
-            cache: z
+            ref: v.string().optional(),
+            cache: v
                 .object({
-                enabled: z.boolean().optional(),
-                ttl: z.number().int().positive().optional(),
-                maxSize: z.number().int().positive().optional(),
-                maxMemory: z.number().int().positive().optional(),
+                enabled: v.boolean().optional(),
+                ttl: v.number().int().positive().optional(),
+                maxSize: v.number().int().positive().optional(),
+                maxMemory: v.number().int().positive().optional(),
             })
                 .partial()
                 .optional(),
-            retry: z
+            retry: v
                 .object({
-                maxRetries: z.number().int().min(0).optional(),
-                initialDelay: z.number().int().positive().optional(),
-                maxDelay: z.number().int().positive().optional(),
+                maxRetries: v.number().int().min(0).optional(),
+                initialDelay: v.number().int().positive().optional(),
+                maxDelay: v.number().int().positive().optional(),
             })
                 .partial()
                 .optional(),
@@ -373,125 +374,125 @@ export const veryfrontConfigSchema = z
     })
         .partial()
         .optional(),
-    ai: z
+    ai: v
         .object({
-        enabled: z.boolean().optional(),
-        providers: z.record(z.string(), z.object({
-            apiKey: z.string().optional(),
-            baseURL: z.string().optional(),
-            defaultModel: z.string().optional(),
-            organization: z.string().optional(),
+        enabled: v.boolean().optional(),
+        providers: v.record(v.string(), v.object({
+            apiKey: v.string().optional(),
+            baseURL: v.string().optional(),
+            defaultModel: v.string().optional(),
+            organization: v.string().optional(),
         }).passthrough()).optional(),
-        tools: z
+        tools: v
             .object({
-            discovery: z
+            discovery: v
                 .object({
-                enabled: z.boolean().optional(),
-                paths: z.array(z.string()).optional(),
+                enabled: v.boolean().optional(),
+                paths: v.array(v.string()).optional(),
             })
                 .partial()
                 .optional(),
         })
             .partial()
             .optional(),
-        agents: z
+        agents: v
             .object({
-            discovery: z
+            discovery: v
                 .object({
-                enabled: z.boolean().optional(),
-                paths: z.array(z.string()).optional(),
+                enabled: v.boolean().optional(),
+                paths: v.array(v.string()).optional(),
             })
                 .partial()
                 .optional(),
         })
             .partial()
             .optional(),
-        skills: z
+        skills: v
             .object({
-            discovery: z
+            discovery: v
                 .object({
-                enabled: z.boolean().optional(),
-                paths: z.array(z.string()).optional(),
+                enabled: v.boolean().optional(),
+                paths: v.array(v.string()).optional(),
             })
                 .partial()
                 .optional(),
         })
             .partial()
             .optional(),
-        resources: z
+        resources: v
             .object({
-            discovery: z
+            discovery: v
                 .object({
-                enabled: z.boolean().optional(),
-                paths: z.array(z.string()).optional(),
+                enabled: v.boolean().optional(),
+                paths: v.array(v.string()).optional(),
             })
                 .partial()
                 .optional(),
         })
             .partial()
             .optional(),
-        prompts: z
+        prompts: v
             .object({
-            discovery: z
+            discovery: v
                 .object({
-                enabled: z.boolean().optional(),
-                paths: z.array(z.string()).optional(),
+                enabled: v.boolean().optional(),
+                paths: v.array(v.string()).optional(),
             })
                 .partial()
                 .optional(),
         })
             .partial()
             .optional(),
-        workflows: z
+        workflows: v
             .object({
-            discovery: z
+            discovery: v
                 .object({
-                enabled: z.boolean().optional(),
-                paths: z.array(z.string()).optional(),
+                enabled: v.boolean().optional(),
+                paths: v.array(v.string()).optional(),
             })
                 .partial()
                 .optional(),
         })
             .partial()
             .optional(),
-        tasks: z
+        tasks: v
             .object({
-            discovery: z
+            discovery: v
                 .object({
-                enabled: z.boolean().optional(),
-                paths: z.array(z.string()).optional(),
+                enabled: v.boolean().optional(),
+                paths: v.array(v.string()).optional(),
             })
                 .partial()
                 .optional(),
         })
             .partial()
             .optional(),
-        mcp: z
+        mcp: v
             .object({
-            enabled: z.boolean().optional(),
-            port: z.number().optional(),
-            expose: z.array(z.string()).optional(),
+            enabled: v.boolean().optional(),
+            port: v.number().optional(),
+            expose: v.array(v.string()).optional(),
         })
             .partial()
             .optional(),
     })
         .partial()
         .optional(),
-    client: z
+    client: v
         .object({
         /** How to resolve veryfront client modules in browser */
-        moduleResolution: z.enum(["cdn", "self-hosted", "bundled"]).optional(),
+        moduleResolution: v.enum(["cdn", "self-hosted", "bundled"]).optional(),
         /** CDN options when moduleResolution is 'cdn' */
-        cdn: z
+        cdn: v
             .object({
-            provider: z.enum(["esm.sh", "unpkg", "jsdelivr"]).optional(),
+            provider: v.enum(["esm.sh", "unpkg", "jsdelivr"]).optional(),
             /** 'auto' detects from package.json, or pin specific versions */
-            versions: z
+            versions: v
                 .union([
-                z.literal("auto"),
-                z.object({
-                    react: z.string().optional(),
-                    veryfront: z.string().optional(),
+                v.literal("auto"),
+                v.object({
+                    react: v.string().optional(),
+                    veryfront: v.string().optional(),
                 }),
             ])
                 .optional(),
@@ -502,44 +503,44 @@ export const veryfrontConfigSchema = z
         .partial()
         .optional(),
     /** CLI generate command preferences */
-    generate: z
+    generate: v
         .object({
         /** Preferred router for generated pages */
-        preferredRouter: z.enum(["app-router", "pages-router"]).optional(),
+        preferredRouter: v.enum(["app-router", "pages-router"]).optional(),
     })
         .partial()
         .optional(),
-    tailwind: z
+    tailwind: v
         .object({
         /** Path to the global stylesheet (default: "globals.css") */
-        stylesheet: z.string().optional(),
+        stylesheet: v.string().optional(),
         /** Enable built-in Tailwind CDN plugins (forms, typography, aspect-ratio, container-queries) */
-        plugins: z.array(z.enum(["forms", "typography", "aspect-ratio", "container-queries"]))
+        plugins: v.array(v.enum(["forms", "typography", "aspect-ratio", "container-queries"]))
             .optional(),
         /** Extend the Tailwind theme (merged with veryfront defaults) */
-        theme: z
+        theme: v
             .object({
-            extend: z.record(z.string(), z.unknown()).optional(),
+            extend: v.record(v.string(), v.unknown()).optional(),
         })
             .partial()
             .optional(),
         /** Custom CSS content to add (for @layer, @apply directives, etc.) */
-        customCSS: z.string().optional(),
+        customCSS: v.string().optional(),
     })
         .partial()
         .optional(),
     /** Third-party integration configuration (e.g., Slack, GitHub) */
-    integrations: z
-        .record(z.string(), z
+    integrations: v
+        .record(v.string(), v
         .object({
         /** Token scope: "project" (shared) or "endUser" (per-end-user OAuth). */
-        scope: z.enum(["project", "endUser"]).optional(),
+        scope: v.enum(["project", "endUser"]).optional(),
         /** @deprecated Use `scope: "endUser"` instead. */
-        perUser: z.boolean().optional(),
+        perUser: v.boolean().optional(),
         /** Allowlist of tool IDs to expose. When set, only these tools are registered.
          * This keeps the MCP context narrow by excluding unused tools.
          * @example ["list-issues", "create-issue"] */
-        tools: z.array(z.string()).optional(),
+        tools: v.array(v.string()).optional(),
     })
         .partial()
         .optional())
@@ -551,44 +552,44 @@ export const veryfrontConfigSchema = z
      * disable directive `{ name, enabled: false }` that vetoes an extension
      * discovered from a lower-priority source. The runtime type is
      * tightened at the `veryfront/extensions` barrel — we keep this as
-     * `z.unknown()` here to avoid pulling the extensions module into the
+     * `v.unknown()` here to avoid pulling the extensions module into the
      * config layer (would introduce a circular import).
      */
-    extensions: z.array(z.unknown()).optional(),
+    extensions: v.array(v.unknown()).optional(),
     /** OpenAPI documentation configuration */
-    openapi: z
+    openapi: v
         .object({
         /** Enable OpenAPI endpoint (default: true) */
-        enabled: z.boolean().optional(),
+        enabled: v.boolean().optional(),
         /** Enable interactive docs page using Scalar (default: true) */
-        docs: z.boolean().optional(),
+        docs: v.boolean().optional(),
         /** API title for OpenAPI info section */
-        title: z.string().optional(),
+        title: v.string().optional(),
         /** API version (default: "1.0.0") */
-        version: z.string().optional(),
+        version: v.string().optional(),
         /** API description */
-        description: z.string().optional(),
+        description: v.string().optional(),
         /** Custom path configuration */
-        paths: z
+        paths: v
             .object({
             /** Path for JSON spec (default: "/_openapi.json") */
-            json: z.string().optional(),
+            json: v.string().optional(),
             /** Path for YAML spec (default: "/_openapi.yaml") */
-            yaml: z.string().optional(),
+            yaml: v.string().optional(),
             /** Path for interactive docs (default: "/_docs") */
-            docs: z.string().optional(),
+            docs: v.string().optional(),
         })
             .partial()
             .optional(),
         /** MCP integration configuration */
-        mcp: z
+        mcp: v
             .object({
             /** Expose OpenAPI spec as MCP resource at openapi://spec (default: true) */
-            resource: z.boolean().optional(),
+            resource: v.boolean().optional(),
             /** Auto-generate MCP tools from API routes (default: true) */
-            tools: z.boolean().optional(),
+            tools: v.boolean().optional(),
             /** Tool naming prefix (default: "api") - tools named as prefix:operationId */
-            toolPrefix: z.string().optional(),
+            toolPrefix: v.string().optional(),
         })
             .partial()
             .optional(),
@@ -596,13 +597,15 @@ export const veryfrontConfigSchema = z
         .partial()
         .optional(),
 })
-    .partial();
+    .partial());
+export const veryfrontConfigSchema = getVeryfrontConfigSchema();
 // Validation function
 export function validateVeryfrontConfig(input) {
-    const parsed = veryfrontConfigSchema.safeParse(input);
-    if (parsed.success)
-        return parsed.data;
-    const first = parsed.error.issues[0];
+    const result = veryfrontConfigSchema.safeParse(input);
+    if (result.success)
+        return result.data;
+    const issues = result.issues ?? [];
+    const first = issues[0];
     const path = first?.path?.length ? first.path.join(".") : "<root>";
     const expected = first?.message ?? String(first);
     const corsHint = path.includes("security.cors")
@@ -621,10 +624,39 @@ export function validateVeryfrontConfig(input) {
     }));
 }
 /**
- * Get known top-level keys from the schema definition.
- * Uses the schema's shape to avoid duplicating the list of keys.
+ * Known top-level keys from the config schema definition.
+ * Maintained in sync with the `getVeryfrontConfigSchema` shape above.
  */
-const knownConfigKeys = new Set(Object.keys(veryfrontConfigSchema.shape));
+const knownConfigKeys = new Set([
+    "projectSlug",
+    "title",
+    "description",
+    "react",
+    "directories",
+    "experimental",
+    "router",
+    "layout",
+    "app",
+    "theme",
+    "build",
+    "cache",
+    "dev",
+    "resolve",
+    "security",
+    "middleware",
+    "theming",
+    "assetPipeline",
+    "observability",
+    "search",
+    "fs",
+    "ai",
+    "client",
+    "generate",
+    "tailwind",
+    "integrations",
+    "extensions",
+    "openapi",
+]);
 export function findUnknownTopLevelKeys(input) {
     return Object.keys(input).filter((key) => !knownConfigKeys.has(key));
 }