vector-framework 1.2.0 → 1.2.2

package/src/core/server.ts

@@ -15,6 +15,7 @@ interface NormalizedOpenAPIConfig {
   docs: {
     enabled: boolean;
     path: string;
+    exposePaths?: string[];
   };
   info?: {
     title?: string;
@@ -24,6 +25,15 @@ interface NormalizedOpenAPIConfig {
 }
 
 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',
@@ -32,15 +42,58 @@ const OPENAPI_TAILWIND_ASSET_RELATIVE_CANDIDATES = [
   // Unbundled dist/core/server.js execution (dist/core -> src/openapi/assets/tailwindcdn.js)
   '../../src/openapi/assets/tailwindcdn.js',
 ] as const;
+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',
+] as const;
+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',
+] as const;
 const OPENAPI_TAILWIND_ASSET_CWD_CANDIDATES = [
   'src/openapi/assets/tailwindcdn.js',
   'openapi/assets/tailwindcdn.js',
   'dist/openapi/assets/tailwindcdn.js',
 ] as const;
+const OPENAPI_LOGO_DARK_ASSET_CWD_CANDIDATES = [
+  'src/openapi/assets/logo_dark.svg',
+  'openapi/assets/logo_dark.svg',
+  'dist/openapi/assets/logo_dark.svg',
+] as const;
+const OPENAPI_LOGO_WHITE_ASSET_CWD_CANDIDATES = [
+  'src/openapi/assets/logo_white.svg',
+  'openapi/assets/logo_white.svg',
+  'dist/openapi/assets/logo_white.svg',
+] as const;
+const OPENAPI_FAVICON_ASSET_RELATIVE_BASE_CANDIDATES = [
+  '../openapi/assets/favicon',
+  '../src/openapi/assets/favicon',
+  '../../src/openapi/assets/favicon',
+] as const;
+const OPENAPI_FAVICON_ASSET_CWD_BASE_CANDIDATES = [
+  'src/openapi/assets/favicon',
+  'openapi/assets/favicon',
+  'dist/openapi/assets/favicon',
+] as const;
 const OPENAPI_TAILWIND_ASSET_INLINE_FALLBACK = '/* OpenAPI docs runtime asset missing: tailwind disabled */';
 
-function resolveOpenAPITailwindAssetFile(): ReturnType<typeof Bun.file> | null {
-  for (const relativePath of OPENAPI_TAILWIND_ASSET_RELATIVE_CANDIDATES) {
+function buildOpenAPIAssetCandidatePaths(bases: readonly string[], filename: string): string[] {
+  return bases.map((base) => `${base}/${filename}`);
+}
+
+function resolveOpenAPIAssetFile(
+  relativeCandidates: readonly string[],
+  cwdCandidates: readonly string[]
+): ReturnType<typeof Bun.file> | null {
+  for (const relativePath of relativeCandidates) {
     try {
       const fileUrl = new URL(relativePath, import.meta.url);
       if (existsSync(fileUrl)) {
@@ -52,7 +105,7 @@ function resolveOpenAPITailwindAssetFile(): ReturnType<typeof Bun.file> | null {
   }
 
   const cwd = process.cwd();
-  for (const relativePath of OPENAPI_TAILWIND_ASSET_CWD_CANDIDATES) {
+  for (const relativePath of cwdCandidates) {
     const absolutePath = join(cwd, relativePath);
     if (existsSync(absolutePath)) {
       return Bun.file(absolutePath);
@@ -62,9 +115,93 @@ function resolveOpenAPITailwindAssetFile(): ReturnType<typeof Bun.file> | null {
   return null;
 }
 
-const OPENAPI_TAILWIND_ASSET_FILE = resolveOpenAPITailwindAssetFile();
+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',
+  },
+] as const;
 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';
 
 interface OpenAPIDocsHtmlCacheEntry {
   html: string;
@@ -72,6 +209,30 @@ interface OpenAPIDocsHtmlCacheEntry {
   etag: string;
 }
 
+function escapeRegex(value: string): string {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+
+function wildcardPatternToRegex(pattern: string): RegExp {
+  let regexSource = '^';
+  for (const char of pattern) {
+    if (char === '*') {
+      regexSource += '.*';
+      continue;
+    }
+    regexSource += escapeRegex(char);
+  }
+  regexSource += '$';
+  return new RegExp(regexSource);
+}
+
+function matchesExposePath(path: string, exposePathPattern: string): boolean {
+  if (!exposePathPattern.includes('*')) {
+    return path === exposePathPattern;
+  }
+  return wildcardPatternToRegex(exposePathPattern).test(path);
+}
+
 export class VectorServer<TTypes extends VectorTypes = DefaultVectorTypes> {
   private server: Server | null = null;
   private router: VectorRouter<TTypes>;
@@ -81,6 +242,8 @@ export class VectorServer<TTypes extends VectorTypes = DefaultVectorTypes> {
   private openapiDocsHtmlCache: OpenAPIDocsHtmlCacheEntry | null = null;
   private openapiWarningsLogged = false;
   private openapiTailwindMissingLogged = false;
+  private openapiLogoDarkMissingLogged = false;
+  private openapiLogoWhiteMissingLogged = false;
   private corsHandler: {
     preflight: (request: Request) => Response;
     corsify: (response: Response, request: Request) => Response;
@@ -149,10 +312,15 @@ export class VectorServer<TTypes extends VectorTypes = DefaultVectorTypes> {
     const docsValue = openapiObject.docs;
     const docs =
       typeof docsValue === 'boolean'
-        ? { enabled: docsValue, path: '/docs' }
+        ? { 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 {
@@ -170,6 +338,17 @@ export class VectorServer<TTypes extends VectorTypes = DefaultVectorTypes> {
     );
   }
 
+  private shouldLogOpenAPIConversionWarnings(): boolean {
+    const nodeEnv = process.env.NODE_ENV;
+    const isDevelopment = this.config.development !== false && nodeEnv !== 'production';
+    if (!isDevelopment) {
+      return false;
+    }
+
+    const logLevel = process.env.LOG_LEVEL;
+    return typeof logLevel === 'string' && logLevel.toLowerCase() === 'debug';
+  }
+
   private getOpenAPIDocument(): Record<string, unknown> {
     if (this.openapiDocCache) {
       return this.openapiDocCache;
@@ -183,8 +362,10 @@ export class VectorServer<TTypes extends VectorTypes = DefaultVectorTypes> {
     });
 
     if (!this.openapiWarningsLogged && result.warnings.length > 0) {
-      for (const warning of result.warnings) {
-        console.warn(warning);
+      if (this.shouldLogOpenAPIConversionWarnings()) {
+        for (const warning of result.warnings) {
+          console.warn(warning);
+        }
       }
       this.openapiWarningsLogged = true;
     }
@@ -193,12 +374,48 @@ export class VectorServer<TTypes extends VectorTypes = DefaultVectorTypes> {
     return this.openapiDocCache;
   }
 
+  private getOpenAPIDocumentForDocs(): Record<string, unknown> {
+    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 as Record<string, unknown>)
+        : {};
+
+    const filteredPaths: Record<string, unknown> = {};
+    for (const [path, value] of Object.entries(existingPaths)) {
+      if (exposePaths.some((pattern) => matchesExposePath(path, pattern))) {
+        filteredPaths[path] = value;
+      }
+    }
+
+    return {
+      ...document,
+      paths: filteredPaths,
+    };
+  }
+
   private getOpenAPIDocsHtmlCacheEntry(): OpenAPIDocsHtmlCacheEntry {
     if (this.openapiDocsHtmlCache) {
       return this.openapiDocsHtmlCache;
     }
 
-    const html = renderOpenAPIDocsHtml(this.getOpenAPIDocument(), this.openapiConfig.path, OPENAPI_TAILWIND_ASSET_PATH);
+    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)}"`;
 
@@ -220,6 +437,11 @@ export class VectorServer<TTypes extends VectorTypes = DefaultVectorTypes> {
     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
@@ -316,6 +538,79 @@ export class VectorServer<TTypes extends VectorTypes = DefaultVectorTypes> {
       });
     }
 
+    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;
   }
 
@@ -385,7 +680,7 @@ export class VectorServer<TTypes extends VectorTypes = DefaultVectorTypes> {
         reusePort: this.config.reusePort !== false,
         routes: this.router.getRouteTable(),
         fetch: fallbackFetch,
-        idleTimeout: this.config.idleTimeout || 60,
+        idleTimeout: this.config.idleTimeout ?? 60,
         error: (error, request?: Request) => {
           console.error('[ERROR] Server error:', error);
           return this.applyCors(new Response('Internal Server Error', { status: 500 }), request);

package/src/core/vector.ts

@@ -39,6 +39,7 @@ export class Vector<TTypes extends VectorTypes = DefaultVectorTypes> {
   private routeGenerator: RouteGenerator | null = null;
   private _protectedHandler: ProtectedHandler<TTypes> | null = null;
   private _cacheHandler: CacheHandler | null = null;
+  private shutdownPromise: Promise<void> | null = null;
 
   private constructor() {
     this.middlewareManager = new MiddlewareManager<TTypes>();
@@ -56,9 +57,13 @@ export class Vector<TTypes extends VectorTypes = DefaultVectorTypes> {
   }
 
   // Internal method to set protected handler
-  setProtectedHandler(handler: ProtectedHandler<TTypes>) {
+  setProtectedHandler(handler: ProtectedHandler<TTypes> | null) {
     this._protectedHandler = handler;
-    this.authManager.setProtectedHandler(handler);
+    if (handler) {
+      this.authManager.setProtectedHandler(handler);
+      return;
+    }
+    this.authManager.clearProtectedHandler();
   }
 
   getProtectedHandler(): ProtectedHandler<TTypes> | null {
@@ -66,9 +71,13 @@ export class Vector<TTypes extends VectorTypes = DefaultVectorTypes> {
   }
 
   // Internal method to set cache handler
-  setCacheHandler(handler: CacheHandler) {
+  setCacheHandler(handler: CacheHandler | null) {
     this._cacheHandler = handler;
-    this.cacheManager.setCacheHandler(handler);
+    if (handler) {
+      this.cacheManager.setCacheHandler(handler);
+      return;
+    }
+    this.cacheManager.clearCacheHandler();
   }
 
   getCacheHandler(): CacheHandler | null {
@@ -107,6 +116,10 @@ export class Vector<TTypes extends VectorTypes = DefaultVectorTypes> {
       this.middlewareManager.addFinally(...config.finally);
     }
 
+    if (typeof this.config.startup === 'function') {
+      await this.config.startup();
+    }
+
     if (this.config.autoDiscover !== false) {
       await this.discoverRoutes();
     }
@@ -228,6 +241,27 @@ export class Vector<TTypes extends VectorTypes = DefaultVectorTypes> {
     // Routes will be cleared on next startServer() call
   }
 
+  async shutdown(): Promise<void> {
+    if (this.shutdownPromise) {
+      return this.shutdownPromise;
+    }
+
+    this.shutdownPromise = (async () => {
+      // Stop accepting new traffic first.
+      this.stop();
+
+      if (typeof this.config.shutdown === 'function') {
+        await this.config.shutdown();
+      }
+    })();
+
+    try {
+      await this.shutdownPromise;
+    } finally {
+      this.shutdownPromise = null;
+    }
+  }
+
   getServer(): VectorServer<TTypes> | null {
     return this.server;
   }

package/src/index.ts

@@ -1,8 +1,10 @@
-// Public exports for route definitions only
+// Public exports for route definitions and Vector startup API
 import { route } from './http';
+import { startVector } from './start-vector';
 
 // Export route function for defining routes
 export { route };
+export { startVector };
 
 // Export utilities for route handlers
 export { APIError, createResponse } from './http';
@@ -10,5 +12,4 @@ export { APIError, createResponse } from './http';
 // Export types for TypeScript users
 export * from './types';
 
-// Note: Vector framework is now config-driven and runs via CLI
-// Usage: Create vector.config.ts and run 'vector dev' or 'vector start'
+// Note: Vector is config-driven and can run via CLI or programmatic startup API

package/src/openapi/assets/favicon/site.webmanifest

@@ -0,0 +1,11 @@
+{
+  "name": "",
+  "short_name": "",
+  "icons": [
+    { "src": "/_vector/openapi/favicon/android-chrome-192x192.png", "sizes": "192x192", "type": "image/png" },
+    { "src": "/_vector/openapi/favicon/android-chrome-512x512.png", "sizes": "512x512", "type": "image/png" }
+  ],
+  "theme_color": "#00a1ff",
+  "background_color": "#ffffff",
+  "display": "standalone"
+}

package/src/openapi/assets/logo.svg

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 15.000000000000002 2.8668130259787783" preserveAspectRatio="xMidYMid meet">
+  <defs>
+    <linearGradient id="SvgjsLinearGradient2002">
+      <stop stop-color="#00ff8f" offset="0"/>
+      <stop stop-color="#00a1ff" offset="1"/>
+    </linearGradient>
+  </defs>
+  <g transform="matrix(0.09366995975118918,0,0,0.09366995975118918,-0.3622393421406193,-0.9696304427369192)" fill="url(#SvgjsLinearGradient2002)">
+    <path d="M25.664063 26.71875 l-7.5 13.359375 l-9.433594 0 l-1.386719 -13.359375 l-1.796875 0 l-1.679687 -15.957031 l10.214844 0 l1.191406 14.082031 c2.636719 -4.628906 5.019531 -9.472656 7.636719 -14.082031 l9.960938 0 l-8.964844 15.957031 l1.757813 0 z M31.503906 27.34375 l-1.992187 0 l3.828125 -16.484375 l20.917969 0 l-1.679687 7.402344 l-11.152344 0 l-0.585937 2.5 l10.253906 0 l-1.503906 6.582031 l1.992188 0 l-0.175781 0.78125 l-10.273437 0 l-1.035156 4.570313 l11.113281 0 l-1.679687 7.382813 l-20.957031 0 z M62.363281 27.265625 l2.226563 0 c-0.351562 4.707031 2.851563 8.242188 11.875 2.441406 l2.929688 0 l-1.835937 7.96875 c-9.902344 5.703125 -24.589844 3.984375 -22.441406 -10.410156 l-2.207031 0 c0.117188 -0.527344 0.234375 -1.152344 0.390625 -1.835937 c1.992188 -8.730469 8.652344 -15.078125 17.929688 -15.078125 c5.117188 0 8.066406 1.464844 9.824219 2.675781 l-1.894531 8.164063 l-3.144531 0 c-7.070312 -7.617187 -13.183594 0.15625 -13.652344 6.074219 z M99.101563 26.71875 l-2.96875 13.359375 l-9.902344 0 l3.046875 -13.359375 l-1.777344 0 l1.972656 -8.554687 l-7.8125 0 l1.71875 -7.402344 l25.351563 0 l-1.660156 7.402344 l-7.792969 0 l-1.914062 8.554688 l1.738281 0 z M134.003907 25.683594 c-0.15625 0.625 -0.332031 1.25 -0.566406 1.894531 l2.128906 0 c-2.480469 7.753906 -8.789062 13.378906 -17.441406 13.378906 c-8.925781 0 -12.402344 -5.625 -11.269531 -13.378906 l-2.070312 0 c0.078125 -0.644531 0.175781 -1.269531 0.3125 -1.894531 c2.070313 -8.925781 8.535156 -15.3125 17.929688 -15.3125 c9.199219 0 12.988281 6.445313 10.976563 15.3125 z M125.429688 27.578125 l-2.109375 0 c0.195313 -0.644531 0.390625 -1.269531 0.527344 -1.933594 c2.480469 -10.722656 -6.171875 -10.410156 -8.59375 0.039063 c-0.136719 0.683594 -0.234375 1.308594 -0.332031 1.894531 l2.109375 0 c-1.015625 8.164063 5.644531 7.988281 8.398438 0 z M138.457031 26.71875 l-1.777344 0 l3.632813 -15.957031 c3.398438 0 9.53125 -0.332031 14.375 0.3125 c4.277344 0.625 8.417969 2.207031 7.695313 7.34375 c-0.410156 3.105469 -2.792969 6.289063 -5.371094 8.300781 l1.757813 0 c-0.46875 0.351563 -0.9375 0.722656 -1.445312 0.976563 l6.679688 12.382813 l-11.71875 0 l-4.882812 -9.550781 l-2.167969 9.550781 l-9.84375 0 z M148.535156 17.988281 l-1.191406 5.039063 c4.707031 0 7.34375 -5.039062 1.191406 -5.039062 z"/>
+  </g>
+</svg>

package/src/openapi/assets/logo_dark.svg

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 15.000000000000002 2.8668130259787783" preserveAspectRatio="xMidYMid meet">
+  <g transform="matrix(0.09366995975118918,0,0,0.09366995975118918,-0.3622393421406193,-0.9696304427369192)" fill="#111">
+    <path d="M25.664063 26.71875 l-7.5 13.359375 l-9.433594 0 l-1.386719 -13.359375 l-1.796875 0 l-1.679687 -15.957031 l10.214844 0 l1.191406 14.082031 c2.636719 -4.628906 5.019531 -9.472656 7.636719 -14.082031 l9.960938 0 l-8.964844 15.957031 l1.757813 0 z M31.503906 27.34375 l-1.992187 0 l3.828125 -16.484375 l20.917969 0 l-1.679687 7.402344 l-11.152344 0 l-0.585937 2.5 l10.253906 0 l-1.503906 6.582031 l1.992188 0 l-0.175781 0.78125 l-10.273437 0 l-1.035156 4.570313 l11.113281 0 l-1.679687 7.382813 l-20.957031 0 z M62.363281 27.265625 l2.226563 0 c-0.351562 4.707031 2.851563 8.242188 11.875 2.441406 l2.929688 0 l-1.835937 7.96875 c-9.902344 5.703125 -24.589844 3.984375 -22.441406 -10.410156 l-2.207031 0 c0.117188 -0.527344 0.234375 -1.152344 0.390625 -1.835937 c1.992188 -8.730469 8.652344 -15.078125 17.929688 -15.078125 c5.117188 0 8.066406 1.464844 9.824219 2.675781 l-1.894531 8.164063 l-3.144531 0 c-7.070312 -7.617187 -13.183594 0.15625 -13.652344 6.074219 z M99.101563 26.71875 l-2.96875 13.359375 l-9.902344 0 l3.046875 -13.359375 l-1.777344 0 l1.972656 -8.554687 l-7.8125 0 l1.71875 -7.402344 l25.351563 0 l-1.660156 7.402344 l-7.792969 0 l-1.914062 8.554688 l1.738281 0 z M134.003907 25.683594 c-0.15625 0.625 -0.332031 1.25 -0.566406 1.894531 l2.128906 0 c-2.480469 7.753906 -8.789062 13.378906 -17.441406 13.378906 c-8.925781 0 -12.402344 -5.625 -11.269531 -13.378906 l-2.070312 0 c0.078125 -0.644531 0.175781 -1.269531 0.3125 -1.894531 c2.070313 -8.925781 8.535156 -15.3125 17.929688 -15.3125 c9.199219 0 12.988281 6.445313 10.976563 15.3125 z M125.429688 27.578125 l-2.109375 0 c0.195313 -0.644531 0.390625 -1.269531 0.527344 -1.933594 c2.480469 -10.722656 -6.171875 -10.410156 -8.59375 0.039063 c-0.136719 0.683594 -0.234375 1.308594 -0.332031 1.894531 l2.109375 0 c-1.015625 8.164063 5.644531 7.988281 8.398438 0 z M138.457031 26.71875 l-1.777344 0 l3.632813 -15.957031 c3.398438 0 9.53125 -0.332031 14.375 0.3125 c4.277344 0.625 8.417969 2.207031 7.695313 7.34375 c-0.410156 3.105469 -2.792969 6.289063 -5.371094 8.300781 l1.757813 0 c-0.46875 0.351563 -0.9375 0.722656 -1.445312 0.976563 l6.679688 12.382813 l-11.71875 0 l-4.882812 -9.550781 l-2.167969 9.550781 l-9.84375 0 z M148.535156 17.988281 l-1.191406 5.039063 c4.707031 0 7.34375 -5.039062 1.191406 -5.039062 z"/>
+  </g>
+</svg>

package/src/openapi/assets/logo_white.svg

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 15.000000000000002 2.8668130259787783" preserveAspectRatio="xMidYMid meet">
+  <g transform="matrix(0.09366995975118918,0,0,0.09366995975118918,-0.3622393421406193,-0.9696304427369192)" fill="#fff">
+    <path d="M25.664063 26.71875 l-7.5 13.359375 l-9.433594 0 l-1.386719 -13.359375 l-1.796875 0 l-1.679687 -15.957031 l10.214844 0 l1.191406 14.082031 c2.636719 -4.628906 5.019531 -9.472656 7.636719 -14.082031 l9.960938 0 l-8.964844 15.957031 l1.757813 0 z M31.503906 27.34375 l-1.992187 0 l3.828125 -16.484375 l20.917969 0 l-1.679687 7.402344 l-11.152344 0 l-0.585937 2.5 l10.253906 0 l-1.503906 6.582031 l1.992188 0 l-0.175781 0.78125 l-10.273437 0 l-1.035156 4.570313 l11.113281 0 l-1.679687 7.382813 l-20.957031 0 z M62.363281 27.265625 l2.226563 0 c-0.351562 4.707031 2.851563 8.242188 11.875 2.441406 l2.929688 0 l-1.835937 7.96875 c-9.902344 5.703125 -24.589844 3.984375 -22.441406 -10.410156 l-2.207031 0 c0.117188 -0.527344 0.234375 -1.152344 0.390625 -1.835937 c1.992188 -8.730469 8.652344 -15.078125 17.929688 -15.078125 c5.117188 0 8.066406 1.464844 9.824219 2.675781 l-1.894531 8.164063 l-3.144531 0 c-7.070312 -7.617187 -13.183594 0.15625 -13.652344 6.074219 z M99.101563 26.71875 l-2.96875 13.359375 l-9.902344 0 l3.046875 -13.359375 l-1.777344 0 l1.972656 -8.554687 l-7.8125 0 l1.71875 -7.402344 l25.351563 0 l-1.660156 7.402344 l-7.792969 0 l-1.914062 8.554688 l1.738281 0 z M134.003907 25.683594 c-0.15625 0.625 -0.332031 1.25 -0.566406 1.894531 l2.128906 0 c-2.480469 7.753906 -8.789062 13.378906 -17.441406 13.378906 c-8.925781 0 -12.402344 -5.625 -11.269531 -13.378906 l-2.070312 0 c0.078125 -0.644531 0.175781 -1.269531 0.3125 -1.894531 c2.070313 -8.925781 8.535156 -15.3125 17.929688 -15.3125 c9.199219 0 12.988281 6.445313 10.976563 15.3125 z M125.429688 27.578125 l-2.109375 0 c0.195313 -0.644531 0.390625 -1.269531 0.527344 -1.933594 c2.480469 -10.722656 -6.171875 -10.410156 -8.59375 0.039063 c-0.136719 0.683594 -0.234375 1.308594 -0.332031 1.894531 l2.109375 0 c-1.015625 8.164063 5.644531 7.988281 8.398438 0 z M138.457031 26.71875 l-1.777344 0 l3.632813 -15.957031 c3.398438 0 9.53125 -0.332031 14.375 0.3125 c4.277344 0.625 8.417969 2.207031 7.695313 7.34375 c-0.410156 3.105469 -2.792969 6.289063 -5.371094 8.300781 l1.757813 0 c-0.46875 0.351563 -0.9375 0.722656 -1.445312 0.976563 l6.679688 12.382813 l-11.71875 0 l-4.882812 -9.550781 l-2.167969 9.550781 l-9.84375 0 z M148.535156 17.988281 l-1.191406 5.039063 c4.707031 0 7.34375 -5.039062 1.191406 -5.039062 z"/>
+  </g>
+</svg>