vector-framework 1.1.1 → 1.2.1

package/dist/core/server.js

@@ -1,21 +1,196 @@
-import { cors } from 'itty-router';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { STATIC_RESPONSES } from '../constants';
+import { cors } from '../utils/cors';
+import { renderOpenAPIDocsHtml } from '../openapi/docs-ui';
+import { generateOpenAPIDocument } from '../openapi/generator';
+const OPENAPI_TAILWIND_ASSET_PATH = '/_vector/openapi/tailwindcdn.js';
+const OPENAPI_LOGO_DARK_ASSET_PATH = '/_vector/openapi/logo_dark.svg';
+const OPENAPI_LOGO_WHITE_ASSET_PATH = '/_vector/openapi/logo_white.svg';
+const OPENAPI_APPLE_TOUCH_ICON_ASSET_PATH = '/_vector/openapi/favicon/apple-touch-icon.png';
+const OPENAPI_FAVICON_32_ASSET_PATH = '/_vector/openapi/favicon/favicon-32x32.png';
+const OPENAPI_FAVICON_16_ASSET_PATH = '/_vector/openapi/favicon/favicon-16x16.png';
+const OPENAPI_FAVICON_ICO_ASSET_PATH = '/_vector/openapi/favicon/favicon.ico';
+const OPENAPI_WEBMANIFEST_ASSET_PATH = '/_vector/openapi/favicon/site.webmanifest';
+const OPENAPI_ANDROID_192_ASSET_PATH = '/_vector/openapi/favicon/android-chrome-192x192.png';
+const OPENAPI_ANDROID_512_ASSET_PATH = '/_vector/openapi/favicon/android-chrome-512x512.png';
+const OPENAPI_TAILWIND_ASSET_RELATIVE_CANDIDATES = [
+    // Source execution (src/core/server.ts -> src/openapi/assets/tailwindcdn.js)
+    '../openapi/assets/tailwindcdn.js',
+    // Bundled dist entrypoints (dist/index.mjs|dist/cli.js -> src/openapi/assets/tailwindcdn.js)
+    '../src/openapi/assets/tailwindcdn.js',
+    // Unbundled dist/core/server.js execution (dist/core -> src/openapi/assets/tailwindcdn.js)
+    '../../src/openapi/assets/tailwindcdn.js',
+];
+const OPENAPI_LOGO_DARK_ASSET_RELATIVE_CANDIDATES = [
+    // Source execution (src/core/server.ts -> src/openapi/assets/logo_dark.svg)
+    '../openapi/assets/logo_dark.svg',
+    // Bundled dist entrypoints (dist/index.mjs|dist/cli.js -> src/openapi/assets/logo_dark.svg)
+    '../src/openapi/assets/logo_dark.svg',
+    // Unbundled dist/core/server.js execution (dist/core -> src/openapi/assets/logo_dark.svg)
+    '../../src/openapi/assets/logo_dark.svg',
+];
+const OPENAPI_LOGO_WHITE_ASSET_RELATIVE_CANDIDATES = [
+    // Source execution (src/core/server.ts -> src/openapi/assets/logo_white.svg)
+    '../openapi/assets/logo_white.svg',
+    // Bundled dist entrypoints (dist/index.mjs|dist/cli.js -> src/openapi/assets/logo_white.svg)
+    '../src/openapi/assets/logo_white.svg',
+    // Unbundled dist/core/server.js execution (dist/core -> src/openapi/assets/logo_white.svg)
+    '../../src/openapi/assets/logo_white.svg',
+];
+const OPENAPI_TAILWIND_ASSET_CWD_CANDIDATES = [
+    'src/openapi/assets/tailwindcdn.js',
+    'openapi/assets/tailwindcdn.js',
+    'dist/openapi/assets/tailwindcdn.js',
+];
+const OPENAPI_LOGO_DARK_ASSET_CWD_CANDIDATES = [
+    'src/openapi/assets/logo_dark.svg',
+    'openapi/assets/logo_dark.svg',
+    'dist/openapi/assets/logo_dark.svg',
+];
+const OPENAPI_LOGO_WHITE_ASSET_CWD_CANDIDATES = [
+    'src/openapi/assets/logo_white.svg',
+    'openapi/assets/logo_white.svg',
+    'dist/openapi/assets/logo_white.svg',
+];
+const OPENAPI_FAVICON_ASSET_RELATIVE_BASE_CANDIDATES = [
+    '../openapi/assets/favicon',
+    '../src/openapi/assets/favicon',
+    '../../src/openapi/assets/favicon',
+];
+const OPENAPI_FAVICON_ASSET_CWD_BASE_CANDIDATES = [
+    'src/openapi/assets/favicon',
+    'openapi/assets/favicon',
+    'dist/openapi/assets/favicon',
+];
+const OPENAPI_TAILWIND_ASSET_INLINE_FALLBACK = '/* OpenAPI docs runtime asset missing: tailwind disabled */';
+function buildOpenAPIAssetCandidatePaths(bases, filename) {
+    return bases.map((base) => `${base}/${filename}`);
+}
+function resolveOpenAPIAssetFile(relativeCandidates, cwdCandidates) {
+    for (const relativePath of relativeCandidates) {
+        try {
+            const fileUrl = new URL(relativePath, import.meta.url);
+            if (existsSync(fileUrl)) {
+                return Bun.file(fileUrl);
+            }
+        }
+        catch {
+            // Ignore resolution failures and try the next candidate.
+        }
+    }
+    const cwd = process.cwd();
+    for (const relativePath of cwdCandidates) {
+        const absolutePath = join(cwd, relativePath);
+        if (existsSync(absolutePath)) {
+            return Bun.file(absolutePath);
+        }
+    }
+    return null;
+}
+const OPENAPI_TAILWIND_ASSET_FILE = resolveOpenAPIAssetFile(OPENAPI_TAILWIND_ASSET_RELATIVE_CANDIDATES, OPENAPI_TAILWIND_ASSET_CWD_CANDIDATES);
+const OPENAPI_LOGO_DARK_ASSET_FILE = resolveOpenAPIAssetFile(OPENAPI_LOGO_DARK_ASSET_RELATIVE_CANDIDATES, OPENAPI_LOGO_DARK_ASSET_CWD_CANDIDATES);
+const OPENAPI_LOGO_WHITE_ASSET_FILE = resolveOpenAPIAssetFile(OPENAPI_LOGO_WHITE_ASSET_RELATIVE_CANDIDATES, OPENAPI_LOGO_WHITE_ASSET_CWD_CANDIDATES);
+const OPENAPI_APPLE_TOUCH_ICON_ASSET_FILE = resolveOpenAPIAssetFile(buildOpenAPIAssetCandidatePaths(OPENAPI_FAVICON_ASSET_RELATIVE_BASE_CANDIDATES, 'apple-touch-icon.png'), buildOpenAPIAssetCandidatePaths(OPENAPI_FAVICON_ASSET_CWD_BASE_CANDIDATES, 'apple-touch-icon.png'));
+const OPENAPI_FAVICON_32_ASSET_FILE = resolveOpenAPIAssetFile(buildOpenAPIAssetCandidatePaths(OPENAPI_FAVICON_ASSET_RELATIVE_BASE_CANDIDATES, 'favicon-32x32.png'), buildOpenAPIAssetCandidatePaths(OPENAPI_FAVICON_ASSET_CWD_BASE_CANDIDATES, 'favicon-32x32.png'));
+const OPENAPI_FAVICON_16_ASSET_FILE = resolveOpenAPIAssetFile(buildOpenAPIAssetCandidatePaths(OPENAPI_FAVICON_ASSET_RELATIVE_BASE_CANDIDATES, 'favicon-16x16.png'), buildOpenAPIAssetCandidatePaths(OPENAPI_FAVICON_ASSET_CWD_BASE_CANDIDATES, 'favicon-16x16.png'));
+const OPENAPI_FAVICON_ICO_ASSET_FILE = resolveOpenAPIAssetFile(buildOpenAPIAssetCandidatePaths(OPENAPI_FAVICON_ASSET_RELATIVE_BASE_CANDIDATES, 'favicon.ico'), buildOpenAPIAssetCandidatePaths(OPENAPI_FAVICON_ASSET_CWD_BASE_CANDIDATES, 'favicon.ico'));
+const OPENAPI_WEBMANIFEST_ASSET_FILE = resolveOpenAPIAssetFile(buildOpenAPIAssetCandidatePaths(OPENAPI_FAVICON_ASSET_RELATIVE_BASE_CANDIDATES, 'site.webmanifest'), buildOpenAPIAssetCandidatePaths(OPENAPI_FAVICON_ASSET_CWD_BASE_CANDIDATES, 'site.webmanifest'));
+const OPENAPI_ANDROID_192_ASSET_FILE = resolveOpenAPIAssetFile(buildOpenAPIAssetCandidatePaths(OPENAPI_FAVICON_ASSET_RELATIVE_BASE_CANDIDATES, 'android-chrome-192x192.png'), buildOpenAPIAssetCandidatePaths(OPENAPI_FAVICON_ASSET_CWD_BASE_CANDIDATES, 'android-chrome-192x192.png'));
+const OPENAPI_ANDROID_512_ASSET_FILE = resolveOpenAPIAssetFile(buildOpenAPIAssetCandidatePaths(OPENAPI_FAVICON_ASSET_RELATIVE_BASE_CANDIDATES, 'android-chrome-512x512.png'), buildOpenAPIAssetCandidatePaths(OPENAPI_FAVICON_ASSET_CWD_BASE_CANDIDATES, 'android-chrome-512x512.png'));
+const OPENAPI_FAVICON_ASSETS = [
+    {
+        path: OPENAPI_APPLE_TOUCH_ICON_ASSET_PATH,
+        file: OPENAPI_APPLE_TOUCH_ICON_ASSET_FILE,
+        contentType: 'image/png',
+        filename: 'apple-touch-icon.png',
+    },
+    {
+        path: OPENAPI_FAVICON_32_ASSET_PATH,
+        file: OPENAPI_FAVICON_32_ASSET_FILE,
+        contentType: 'image/png',
+        filename: 'favicon-32x32.png',
+    },
+    {
+        path: OPENAPI_FAVICON_16_ASSET_PATH,
+        file: OPENAPI_FAVICON_16_ASSET_FILE,
+        contentType: 'image/png',
+        filename: 'favicon-16x16.png',
+    },
+    {
+        path: OPENAPI_FAVICON_ICO_ASSET_PATH,
+        file: OPENAPI_FAVICON_ICO_ASSET_FILE,
+        contentType: 'image/x-icon',
+        filename: 'favicon.ico',
+    },
+    {
+        path: OPENAPI_WEBMANIFEST_ASSET_PATH,
+        file: OPENAPI_WEBMANIFEST_ASSET_FILE,
+        contentType: 'application/manifest+json; charset=utf-8',
+        filename: 'site.webmanifest',
+    },
+    {
+        path: OPENAPI_ANDROID_192_ASSET_PATH,
+        file: OPENAPI_ANDROID_192_ASSET_FILE,
+        contentType: 'image/png',
+        filename: 'android-chrome-192x192.png',
+    },
+    {
+        path: OPENAPI_ANDROID_512_ASSET_PATH,
+        file: OPENAPI_ANDROID_512_ASSET_FILE,
+        contentType: 'image/png',
+        filename: 'android-chrome-512x512.png',
+    },
+];
+const DOCS_HTML_CACHE_CONTROL = 'public, max-age=0, must-revalidate';
+const DOCS_ASSET_CACHE_CONTROL = 'public, max-age=31536000, immutable';
+const DOCS_ASSET_ERROR_CACHE_CONTROL = 'no-store';
+function escapeRegex(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function wildcardPatternToRegex(pattern) {
+    let regexSource = '^';
+    for (const char of pattern) {
+        if (char === '*') {
+            regexSource += '.*';
+            continue;
+        }
+        regexSource += escapeRegex(char);
+    }
+    regexSource += '$';
+    return new RegExp(regexSource);
+}
+function matchesExposePath(path, exposePathPattern) {
+    if (!exposePathPattern.includes('*')) {
+        return path === exposePathPattern;
+    }
+    return wildcardPatternToRegex(exposePathPattern).test(path);
+}
 export class VectorServer {
     server = null;
     router;
     config;
-    corsHandler;
-    corsHeaders = null;
+    openapiConfig;
+    openapiDocCache = null;
+    openapiDocsHtmlCache = null;
+    openapiWarningsLogged = false;
+    openapiTailwindMissingLogged = false;
+    openapiLogoDarkMissingLogged = false;
+    openapiLogoWhiteMissingLogged = false;
+    corsHandler = null;
+    corsHeadersEntries = null;
     constructor(router, config) {
         this.router = router;
         this.config = config;
+        this.openapiConfig = this.normalizeOpenAPIConfig(config.openapi, config.development);
         if (config.cors) {
             const opts = this.normalizeCorsOptions(config.cors);
             const { preflight, corsify } = cors(opts);
             this.corsHandler = { preflight, corsify };
-            // Pre-build static CORS headers when origin is a fixed string.
-            // Avoids cloning the Response on every request via corsify().
-            if (typeof opts.origin === 'string') {
-                this.corsHeaders = {
+            // Pre-build static CORS headers when origin does not require per-request reflection.
+            const canUseStaticCorsHeaders = typeof opts.origin === 'string' && (opts.origin !== '*' || !opts.credentials);
+            if (canUseStaticCorsHeaders) {
+                const corsHeaders = {
                     'access-control-allow-origin': opts.origin,
                     'access-control-allow-methods': opts.allowMethods,
                     'access-control-allow-headers': opts.allowHeaders,
@@ -23,10 +198,266 @@ export class VectorServer {
                     'access-control-max-age': String(opts.maxAge),
                 };
                 if (opts.credentials) {
-                    this.corsHeaders['access-control-allow-credentials'] = 'true';
+                    corsHeaders['access-control-allow-credentials'] = 'true';
+                }
+                this.corsHeadersEntries = Object.entries(corsHeaders);
+            }
+            // Pass CORS behavior to router so matched routes also receive CORS headers.
+            this.router.setCorsHeaders(this.corsHeadersEntries);
+            this.router.setCorsHandler(this.corsHeadersEntries ? null : this.corsHandler.corsify);
+        }
+    }
+    normalizeOpenAPIConfig(openapi, development) {
+        const isDev = development !== false && process.env.NODE_ENV !== 'production';
+        const defaultEnabled = isDev;
+        if (openapi === false) {
+            return {
+                enabled: false,
+                path: '/openapi.json',
+                target: 'openapi-3.0',
+                docs: { enabled: false, path: '/docs' },
+            };
+        }
+        if (openapi === true) {
+            return {
+                enabled: true,
+                path: '/openapi.json',
+                target: 'openapi-3.0',
+                docs: { enabled: false, path: '/docs' },
+            };
+        }
+        const openapiObject = openapi || {};
+        const docsValue = openapiObject.docs;
+        const docs = typeof docsValue === 'boolean'
+            ? { enabled: docsValue, path: '/docs', exposePaths: undefined }
+            : {
+                enabled: docsValue?.enabled === true,
+                path: docsValue?.path || '/docs',
+                exposePaths: Array.isArray(docsValue?.exposePaths)
+                    ? docsValue.exposePaths
+                        .map((path) => (typeof path === 'string' ? path.trim() : ''))
+                        .filter((path) => path.length > 0)
+                    : undefined,
+            };
+        return {
+            enabled: openapiObject.enabled ?? defaultEnabled,
+            path: openapiObject.path || '/openapi.json',
+            target: openapiObject.target || 'openapi-3.0',
+            docs,
+            info: openapiObject.info,
+        };
+    }
+    isDocsReservedPath(path) {
+        return (path === this.openapiConfig.path || (this.openapiConfig.docs.enabled && path === this.openapiConfig.docs.path));
+    }
+    getOpenAPIDocument() {
+        if (this.openapiDocCache) {
+            return this.openapiDocCache;
+        }
+        const routes = this.router.getRouteDefinitions().filter((route) => !this.isDocsReservedPath(route.path));
+        const result = generateOpenAPIDocument(routes, {
+            target: this.openapiConfig.target,
+            info: this.openapiConfig.info,
+        });
+        if (!this.openapiWarningsLogged && result.warnings.length > 0) {
+            for (const warning of result.warnings) {
+                console.warn(warning);
+            }
+            this.openapiWarningsLogged = true;
+        }
+        this.openapiDocCache = result.document;
+        return this.openapiDocCache;
+    }
+    getOpenAPIDocumentForDocs() {
+        const exposePaths = this.openapiConfig.docs.exposePaths;
+        const document = this.getOpenAPIDocument();
+        if (!Array.isArray(exposePaths) || exposePaths.length === 0) {
+            return document;
+        }
+        const existingPaths = document.paths && typeof document.paths === 'object' && !Array.isArray(document.paths)
+            ? document.paths
+            : {};
+        const filteredPaths = {};
+        for (const [path, value] of Object.entries(existingPaths)) {
+            if (exposePaths.some((pattern) => matchesExposePath(path, pattern))) {
+                filteredPaths[path] = value;
+            }
+        }
+        return {
+            ...document,
+            paths: filteredPaths,
+        };
+    }
+    getOpenAPIDocsHtmlCacheEntry() {
+        if (this.openapiDocsHtmlCache) {
+            return this.openapiDocsHtmlCache;
+        }
+        const html = renderOpenAPIDocsHtml(this.getOpenAPIDocumentForDocs(), this.openapiConfig.path, OPENAPI_TAILWIND_ASSET_PATH, OPENAPI_LOGO_DARK_ASSET_PATH, OPENAPI_LOGO_WHITE_ASSET_PATH, OPENAPI_APPLE_TOUCH_ICON_ASSET_PATH, OPENAPI_FAVICON_32_ASSET_PATH, OPENAPI_FAVICON_16_ASSET_PATH, OPENAPI_WEBMANIFEST_ASSET_PATH);
+        const gzip = Bun.gzipSync(html);
+        const etag = `"${Bun.hash(html).toString(16)}"`;
+        this.openapiDocsHtmlCache = { html, gzip, etag };
+        return this.openapiDocsHtmlCache;
+    }
+    requestAcceptsGzip(request) {
+        const acceptEncoding = request.headers.get('accept-encoding');
+        return Boolean(acceptEncoding && /\bgzip\b/i.test(acceptEncoding));
+    }
+    validateReservedOpenAPIPaths() {
+        if (!this.openapiConfig.enabled) {
+            return;
+        }
+        const reserved = new Set([this.openapiConfig.path]);
+        if (this.openapiConfig.docs.enabled) {
+            reserved.add(this.openapiConfig.docs.path);
+            reserved.add(OPENAPI_TAILWIND_ASSET_PATH);
+            reserved.add(OPENAPI_LOGO_DARK_ASSET_PATH);
+            reserved.add(OPENAPI_LOGO_WHITE_ASSET_PATH);
+            for (const asset of OPENAPI_FAVICON_ASSETS) {
+                reserved.add(asset.path);
+            }
+        }
+        const methodConflicts = this.router
+            .getRouteDefinitions()
+            .filter((route) => reserved.has(route.path))
+            .map((route) => `${route.method} ${route.path}`);
+        const staticConflicts = Object.entries(this.router.getRouteTable())
+            .filter(([path, value]) => reserved.has(path) && value instanceof Response)
+            .map(([path]) => `STATIC ${path}`);
+        const conflicts = [...methodConflicts, ...staticConflicts];
+        if (conflicts.length > 0) {
+            throw new Error(`OpenAPI reserved path conflict: ${conflicts.join(', ')}. Change your route path(s) or reconfigure openapi.path/docs.path.`);
+        }
+    }
+    tryHandleOpenAPIRequest(request) {
+        if (!this.openapiConfig.enabled || request.method !== 'GET') {
+            return null;
+        }
+        const pathname = new URL(request.url).pathname;
+        if (pathname === this.openapiConfig.path) {
+            return Response.json(this.getOpenAPIDocument());
+        }
+        if (this.openapiConfig.docs.enabled && pathname === this.openapiConfig.docs.path) {
+            const { html, gzip, etag } = this.getOpenAPIDocsHtmlCacheEntry();
+            if (request.headers.get('if-none-match') === etag) {
+                return new Response(null, {
+                    status: 304,
+                    headers: {
+                        etag,
+                        'cache-control': DOCS_HTML_CACHE_CONTROL,
+                        vary: 'accept-encoding',
+                    },
+                });
+            }
+            if (this.requestAcceptsGzip(request)) {
+                return new Response(gzip, {
+                    status: 200,
+                    headers: {
+                        'content-type': 'text/html; charset=utf-8',
+                        'content-encoding': 'gzip',
+                        etag,
+                        'cache-control': DOCS_HTML_CACHE_CONTROL,
+                        vary: 'accept-encoding',
+                    },
+                });
+            }
+            return new Response(html, {
+                status: 200,
+                headers: {
+                    'content-type': 'text/html; charset=utf-8',
+                    etag,
+                    'cache-control': DOCS_HTML_CACHE_CONTROL,
+                    vary: 'accept-encoding',
+                },
+            });
+        }
+        if (this.openapiConfig.docs.enabled && pathname === OPENAPI_TAILWIND_ASSET_PATH) {
+            if (!OPENAPI_TAILWIND_ASSET_FILE) {
+                if (!this.openapiTailwindMissingLogged) {
+                    this.openapiTailwindMissingLogged = true;
+                    console.warn('[OpenAPI] Missing docs runtime asset "tailwindcdn.js". Serving inline fallback script instead.');
                 }
+                return new Response(OPENAPI_TAILWIND_ASSET_INLINE_FALLBACK, {
+                    status: 200,
+                    headers: {
+                        'content-type': 'application/javascript; charset=utf-8',
+                        'cache-control': DOCS_ASSET_CACHE_CONTROL,
+                    },
+                });
             }
+            return new Response(OPENAPI_TAILWIND_ASSET_FILE, {
+                status: 200,
+                headers: {
+                    'content-type': 'application/javascript; charset=utf-8',
+                    'cache-control': DOCS_ASSET_CACHE_CONTROL,
+                },
+            });
         }
+        if (this.openapiConfig.docs.enabled && pathname === OPENAPI_LOGO_DARK_ASSET_PATH) {
+            if (!OPENAPI_LOGO_DARK_ASSET_FILE) {
+                if (!this.openapiLogoDarkMissingLogged) {
+                    this.openapiLogoDarkMissingLogged = true;
+                    console.warn('[OpenAPI] Missing docs runtime asset "logo_dark.svg".');
+                }
+                return new Response('OpenAPI docs runtime asset missing: logo_dark.svg', {
+                    status: 404,
+                    headers: {
+                        'content-type': 'text/plain; charset=utf-8',
+                        'cache-control': DOCS_ASSET_ERROR_CACHE_CONTROL,
+                    },
+                });
+            }
+            return new Response(OPENAPI_LOGO_DARK_ASSET_FILE, {
+                status: 200,
+                headers: {
+                    'content-type': 'image/svg+xml; charset=utf-8',
+                    'cache-control': DOCS_ASSET_CACHE_CONTROL,
+                },
+            });
+        }
+        if (this.openapiConfig.docs.enabled && pathname === OPENAPI_LOGO_WHITE_ASSET_PATH) {
+            if (!OPENAPI_LOGO_WHITE_ASSET_FILE) {
+                if (!this.openapiLogoWhiteMissingLogged) {
+                    this.openapiLogoWhiteMissingLogged = true;
+                    console.warn('[OpenAPI] Missing docs runtime asset "logo_white.svg".');
+                }
+                return new Response('OpenAPI docs runtime asset missing: logo_white.svg', {
+                    status: 404,
+                    headers: {
+                        'content-type': 'text/plain; charset=utf-8',
+                        'cache-control': DOCS_ASSET_ERROR_CACHE_CONTROL,
+                    },
+                });
+            }
+            return new Response(OPENAPI_LOGO_WHITE_ASSET_FILE, {
+                status: 200,
+                headers: {
+                    'content-type': 'image/svg+xml; charset=utf-8',
+                    'cache-control': DOCS_ASSET_CACHE_CONTROL,
+                },
+            });
+        }
+        if (this.openapiConfig.docs.enabled) {
+            const faviconAsset = OPENAPI_FAVICON_ASSETS.find((asset) => asset.path === pathname);
+            if (faviconAsset) {
+                if (!faviconAsset.file) {
+                    return new Response(`OpenAPI docs runtime asset missing: ${faviconAsset.filename}`, {
+                        status: 404,
+                        headers: {
+                            'content-type': 'text/plain; charset=utf-8',
+                            'cache-control': DOCS_ASSET_ERROR_CACHE_CONTROL,
+                        },
+                    });
+                }
+                return new Response(faviconAsset.file, {
+                    status: 200,
+                    headers: {
+                        'content-type': faviconAsset.contentType,
+                        'cache-control': DOCS_ASSET_CACHE_CONTROL,
+                    },
+                });
+            }
+        }
+        return null;
     }
     normalizeCorsOptions(options) {
         return {
@@ -44,31 +475,39 @@ export class VectorServer {
             maxAge: options.maxAge || 86400,
         };
     }
+    applyCors(response, request) {
+        if (this.corsHeadersEntries) {
+            for (const [k, v] of this.corsHeadersEntries) {
+                response.headers.set(k, v);
+            }
+            return response;
+        }
+        if (this.corsHandler && request) {
+            return this.corsHandler.corsify(response, request);
+        }
+        return response;
+    }
     async start() {
-        const port = this.config.port || 3000;
+        const port = this.config.port ?? 3000;
         const hostname = this.config.hostname || 'localhost';
-        const fetch = async (request) => {
+        this.validateReservedOpenAPIPaths();
+        const fallbackFetch = async (request) => {
             try {
-                // Handle CORS preflight
+                // Handle CORS preflight for any path
                 if (this.corsHandler && request.method === 'OPTIONS') {
                     return this.corsHandler.preflight(request);
                 }
-                // Try to handle the request with our router
-                let response = await this.router.handle(request);
-                // Apply CORS headers if configured
-                if (this.corsHeaders) {
-                    for (const [k, v] of Object.entries(this.corsHeaders)) {
-                        response.headers.set(k, v);
-                    }
-                }
-                else if (this.corsHandler) {
-                    response = this.corsHandler.corsify(response, request);
+                // Handle built-in docs endpoints for requests that fell through the Bun route table.
+                const openapiResponse = this.tryHandleOpenAPIRequest(request);
+                if (openapiResponse) {
+                    return this.applyCors(openapiResponse, request);
                 }
-                return response;
+                // No route matched — return 404
+                return this.applyCors(STATIC_RESPONSES.NOT_FOUND.clone(), request);
             }
             catch (error) {
                 console.error('Server error:', error);
-                return new Response('Internal Server Error', { status: 500 });
+                return this.applyCors(new Response('Internal Server Error', { status: 500 }), request);
             }
         };
         try {
@@ -76,22 +515,20 @@ export class VectorServer {
                 port,
                 hostname,
                 reusePort: this.config.reusePort !== false,
-                fetch,
-                idleTimeout: this.config.idleTimeout || 60,
-                error: (error) => {
+                routes: this.router.getRouteTable(),
+                fetch: fallbackFetch,
+                idleTimeout: this.config.idleTimeout ?? 60,
+                error: (error, request) => {
                     console.error('[ERROR] Server error:', error);
-                    return new Response('Internal Server Error', { status: 500 });
+                    return this.applyCors(new Response('Internal Server Error', { status: 500 }), request);
                 },
             });
-            // Validate that the server actually started
             if (!this.server || !this.server.port) {
                 throw new Error(`Failed to start server on ${hostname}:${port} - server object is invalid`);
             }
-            // Server logs are handled by CLI
             return this.server;
         }
         catch (error) {
-            // Enhance error message with context for common issues
             if (error.code === 'EADDRINUSE' || error.message?.includes('address already in use')) {
                 error.message = `Port ${port} is already in use`;
                 error.port = port;
@@ -111,6 +548,9 @@ export class VectorServer {
         if (this.server) {
             this.server.stop();
             this.server = null;
+            this.openapiDocCache = null;
+            this.openapiDocsHtmlCache = null;
+            this.openapiWarningsLogged = false;
             console.log('Server stopped');
         }
     }
@@ -118,7 +558,7 @@ export class VectorServer {
         return this.server;
     }
     getPort() {
-        return this.server?.port || this.config.port || 3000;
+        return this.server?.port ?? this.config.port ?? 3000;
     }
     getHostname() {
         return this.server?.hostname || this.config.hostname || 'localhost';

package/dist/core/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/core/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/core/server.ts"],"names":[],"mappings":"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"}

package/dist/core/vector.d.ts

@@ -1,8 +1,7 @@
 import type { Server } from 'bun';
-import type { RouteEntry } from 'itty-router';
 import { AuthManager } from '../auth/protected';
 import { CacheManager } from '../cache/manager';
-import type { CacheHandler, DefaultVectorTypes, ProtectedHandler, RouteHandler, RouteOptions, VectorConfig, VectorTypes } from '../types';
+import type { CacheHandler, DefaultVectorTypes, InferRouteInputFromSchemaDefinition, ProtectedHandler, RouteHandler, RouteOptions, RouteSchemaDefinition, VectorConfig, VectorTypes } from '../types';
 import { VectorRouter } from './router';
 import { VectorServer } from './server';
 export declare class Vector<TTypes extends VectorTypes = DefaultVectorTypes> {
@@ -17,13 +16,16 @@ export declare class Vector<TTypes extends VectorTypes = DefaultVectorTypes> {
     private routeGenerator;
     private _protectedHandler;
     private _cacheHandler;
+    private shutdownPromise;
     private constructor();
     static getInstance<T extends VectorTypes = DefaultVectorTypes>(): Vector<T>;
-    setProtectedHandler(handler: ProtectedHandler<TTypes>): void;
+    setProtectedHandler(handler: ProtectedHandler<TTypes> | null): void;
     getProtectedHandler(): ProtectedHandler<TTypes> | null;
-    setCacheHandler(handler: CacheHandler): void;
+    setCacheHandler(handler: CacheHandler | null): void;
     getCacheHandler(): CacheHandler | null;
-    addRoute(options: RouteOptions<TTypes>, handler: RouteHandler<TTypes>): RouteEntry;
+    addRoute<TSchemaDef extends RouteSchemaDefinition | undefined>(options: Omit<RouteOptions<TTypes>, 'schema'> & {
+        schema?: TSchemaDef;
+    }, handler: RouteHandler<TTypes, InferRouteInputFromSchemaDefinition<TSchemaDef>>): void;
     startServer(config?: VectorConfig<TTypes>): Promise<Server>;
     private discoverRoutes;
     loadRoute(routeModule: any): Promise<void>;
@@ -31,6 +33,7 @@ export declare class Vector<TTypes extends VectorTypes = DefaultVectorTypes> {
     private isRouteDefinition;
     private logRouteLoaded;
     stop(): void;
+    shutdown(): Promise<void>;
     getServer(): VectorServer<TTypes> | null;
     getRouter(): VectorRouter<TTypes>;
     getCacheManager(): CacheManager<TTypes>;