vector-framework 1.2.0 → 1.2.2

package/package.json

@@ -1,20 +1,22 @@
 {
   "name": "vector-framework",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "author": "webhie-com",
   "repository": {
     "type": "git",
     "url": "https://github.com/webhie-com/vector.git"
   },
-  "main": "./dist/index.js",
+  "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
   "dependencies": {},
   "devDependencies": {
     "@biomejs/biome": "^2.4.6",
     "@biomejs/cli-darwin-arm64": "^2.4.6",
     "@types/bun": "latest",
+    "arktype": "^2.2.0",
     "oxlint": "^1.15.0",
     "typescript": "^5.0.0",
+    "valibot": "^1.2.0",
     "zod": "^4.3.6"
   },
   "peerDependencies": {
@@ -24,22 +26,16 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
-    },
-    "./middleware": {
-      "types": "./dist/middleware/index.d.ts",
-      "import": "./dist/middleware/index.mjs",
-      "require": "./dist/middleware/index.js"
+      "require": "./dist/index.cjs"
     },
     "./types": {
       "types": "./dist/types/index.d.ts",
-      "import": "./dist/types/index.mjs",
-      "require": "./dist/types/index.js"
+      "default": "./dist/types/index.js"
     },
     "./errors": {
       "types": "./dist/errors/index.d.ts",
-      "import": "./dist/errors/index.mjs",
-      "require": "./dist/errors/index.js"
+      "import": "./dist/errors/index.js",
+      "require": "./dist/errors/index.cjs"
     }
   },
   "bin": {
@@ -79,7 +75,7 @@
     "build:lib": "bun run build:clean && bun run build:ts && bun run build:bundle && bun run build:cli",
     "build:clean": "rm -rf dist",
     "build:ts": "tsc",
-    "build:bundle": "bun build src/index.ts --format esm --minify --outfile dist/index.mjs && bun build src/index.ts --format cjs --minify --outfile dist/index.js",
+    "build:bundle": "bun build src/index.ts --target bun --format esm --minify --outfile dist/index.mjs && bun build src/index.ts --target bun --format cjs --minify --outfile dist/index.cjs && bun build src/errors/index.ts --target bun --format cjs --minify --outfile dist/errors/index.cjs",
     "build:cli": "bun build src/cli/index.ts --target bun --outfile dist/cli.js",
     "local:cli:build": "bun run build:lib",
     "local:cli:dev": "bun run dist/cli.js dev --config ./vector.config.ts",
@@ -88,7 +84,7 @@
     "test:unit": "bun test tests/*.test.ts",
     "test:watch": "bun test --watch tests/*.test.ts",
     "test:coverage": "bun test --coverage tests/*.test.ts",
-    "test:e2e": "bun test --max-concurrency 1 tests/e2e/e2e.test.ts tests/e2e/zod-io.e2e.test.ts",
+    "test:e2e": "bun test --max-concurrency 1 tests/e2e/e2e.test.ts tests/e2e/zod-io.e2e.test.ts tests/e2e/package-exports.test.ts",
     "test:load": "bun run tests/e2e/load.test.ts",
     "test:soak": "bun run tests/e2e/soak.test.ts",
     "test:benchmark": "bun run tests/e2e/benchmark.test.ts",

package/src/auth/protected.ts

@@ -7,6 +7,10 @@ export class AuthManager<TTypes extends VectorTypes = DefaultVectorTypes> {
     this.protectedHandler = handler;
   }
 
+  clearProtectedHandler() {
+    this.protectedHandler = null;
+  }
+
   async authenticate(request: VectorRequest<TTypes>): Promise<GetAuthType<TTypes> | null> {
     if (!this.protectedHandler) {
       throw new Error('Protected handler not configured. Use vector.protected() to set authentication handler.');

package/src/cache/manager.ts

@@ -16,6 +16,10 @@ export class CacheManager<TTypes extends VectorTypes = DefaultVectorTypes> {
     this.cacheHandler = handler;
   }
 
+  clearCacheHandler() {
+    this.cacheHandler = null;
+  }
+
   async get<T = GetCacheType<TTypes>>(
     key: string,
     factory: () => Promise<T>,

package/src/cli/graceful-shutdown.ts

@@ -0,0 +1,60 @@
+type SignalEvent = 'SIGINT' | 'SIGTERM';
+
+interface ShutdownTarget {
+  shutdown?: () => Promise<void> | void;
+  stop?: () => void;
+}
+
+interface GracefulShutdownOptions {
+  getTarget: () => ShutdownTarget | null | undefined;
+  on?: (event: SignalEvent, listener: () => void) => void;
+  off?: (event: SignalEvent, listener: () => void) => void;
+  exit?: (code: number) => void;
+  logError?: (message?: any, ...optionalParams: any[]) => void;
+}
+
+export function installGracefulShutdownHandlers(options: GracefulShutdownOptions): () => void {
+  const on = options.on ?? ((event: SignalEvent, listener: () => void) => process.on(event, listener));
+  const off = options.off ?? ((event: SignalEvent, listener: () => void) => process.off(event, listener));
+  const exit = options.exit ?? ((code: number) => process.exit(code));
+  const logError = options.logError ?? console.error;
+  let shuttingDown = false;
+
+  const handleSignal = async (signal: SignalEvent): Promise<void> => {
+    if (shuttingDown) {
+      return;
+    }
+    shuttingDown = true;
+
+    try {
+      const target = options.getTarget();
+      if (target) {
+        if (typeof target.shutdown === 'function') {
+          await target.shutdown();
+        } else if (typeof target.stop === 'function') {
+          target.stop();
+        }
+      }
+      exit(0);
+    } catch (error) {
+      logError(`[vector] Graceful shutdown failed after ${signal}:`, error);
+      exit(1);
+    }
+  };
+
+  const onSigint = () => {
+    void handleSignal('SIGINT');
+  };
+
+  const onSigterm = () => {
+    void handleSignal('SIGTERM');
+  };
+
+  on('SIGINT', onSigint);
+  on('SIGTERM', onSigterm);
+
+  return () => {
+    off('SIGINT', onSigint);
+    off('SIGTERM', onSigterm);
+  };
+}

package/src/cli/index.ts

@@ -2,9 +2,10 @@
 
 import { watch } from 'node:fs';
 import { parseArgs } from 'node:util';
-import { getVectorInstance } from '../core/vector';
-import { ConfigLoader } from '../core/config-loader';
 import { resolveHost, resolvePort, resolveRoutesDir } from './option-resolution';
+import { installGracefulShutdownHandlers } from './graceful-shutdown';
+import { startVector } from '../start-vector';
+import type { StartedVectorApp } from '../types';
 
 // Compatibility layer for both Node and Bun
 const args = typeof Bun !== 'undefined' ? Bun.argv.slice(2) : process.argv.slice(2);
@@ -54,9 +55,10 @@ async function runDev() {
   const isDev = command === 'dev';
 
   let server: any = null;
-  let vector: any = null;
+  let app: StartedVectorApp<any> | null = null;
+  let removeShutdownHandlers: (() => void) | null = null;
 
-  async function startServer(): Promise<{ server: any; vector: any; config: any }> {
+  async function startServer(): Promise<{ server: any; app: StartedVectorApp<any>; config: any }> {
     // Create a timeout promise that rejects after 10 seconds
     const timeoutPromise = new Promise<never>((_, reject) => {
       setTimeout(() => {
@@ -65,50 +67,35 @@ async function runDev() {
     });
 
     // Create the actual server start promise
-    const serverStartPromise = (async (): Promise<{ server: any; vector: any; config: any }> => {
+    const serverStartPromise = (async (): Promise<{ server: any; app: StartedVectorApp<any>; config: any }> => {
       const explicitConfigPath = values.config as string | undefined;
-      const configLoader = new ConfigLoader(explicitConfigPath);
-      const loadedConfig = await configLoader.load();
-      const config = { ...loadedConfig } as Record<string, any>;
-
-      // Merge CLI options with loaded config.
-      // Explicit --port/--host always override config values.
-      config.port = resolvePort(config.port, hasPortOption, values.port as string);
-      config.hostname = resolveHost(config.hostname, hasHostOption, values.host as string);
-      config.routesDir = resolveRoutesDir(config.routesDir, hasRoutesOption, values.routes as string);
-      config.development = config.development ?? isDev;
-      config.autoDiscover = true; // Always auto-discover routes
-
-      // Apply CLI CORS option if not explicitly set in config
-      // Only apply default CORS if config.cors is undefined (not set)
-      if (config.cors === undefined && values.cors) {
-        config.cors = {
-          origin: '*',
-          credentials: true,
-          allowHeaders: 'Content-Type, Authorization',
-          allowMethods: 'GET, POST, PUT, PATCH, DELETE, OPTIONS',
-          exposeHeaders: 'Authorization',
-          maxAge: 86400,
-        };
-      }
-
-      // Get Vector instance and configure handlers
-      vector = getVectorInstance();
-
-      // Load and set auth handler if configured
-      const authHandler = await configLoader.loadAuthHandler();
-      if (authHandler) {
-        vector.setProtectedHandler(authHandler);
-      }
+      app = await startVector({
+        configPath: explicitConfigPath,
+        mutateConfig: (loadedConfig) => {
+          const config = { ...loadedConfig } as Record<string, any>;
+          config.port = resolvePort(config.port, hasPortOption, values.port as string);
+          config.hostname = resolveHost(config.hostname, hasHostOption, values.host as string);
+          config.routesDir = resolveRoutesDir(config.routesDir, hasRoutesOption, values.routes as string);
+          config.development = config.development ?? isDev;
+          config.autoDiscover = true; // Always auto-discover routes
+
+          if (config.cors === undefined && values.cors) {
+            config.cors = {
+              origin: '*',
+              credentials: true,
+              allowHeaders: 'Content-Type, Authorization',
+              allowMethods: 'GET, POST, PUT, PATCH, DELETE, OPTIONS',
+              exposeHeaders: 'Authorization',
+              maxAge: 86400,
+            };
+          }
 
-      // Load and set cache handler if configured
-      const cacheHandler = await configLoader.loadCacheHandler();
-      if (cacheHandler) {
-        vector.setCacheHandler(cacheHandler);
-      }
+          return config;
+        },
+      });
 
-      // Start the server
-      server = await vector.startServer(config);
+      server = app.server;
+      const config = app.config as Record<string, any>;
 
       // Verify the server is actually running
       if (!server || !server.port) {
@@ -120,7 +107,7 @@ async function runDev() {
 
       console.log(`\nListening on ${cyan}http://${config.hostname}:${config.port}${reset}\n`);
 
-      return { server, vector, config };
+      return { server, app, config };
     })();
 
     // Race between server startup and timeout
@@ -132,6 +119,12 @@ async function runDev() {
     const result = await startServer();
     server = result.server;
 
+    if (!removeShutdownHandlers) {
+      removeShutdownHandlers = installGracefulShutdownHandlers({
+        getTarget: () => app,
+      });
+    }
+
     // Setup file watching for hot reload
     if (isDev && values.watch) {
       try {
@@ -173,8 +166,8 @@ async function runDev() {
               changedFiles.clear();
 
               // Stop the current server
-              if (vector) {
-                vector.stop();
+              if (app) {
+                app.stop();
               }
 
               // Small delay to ensure file system operations complete
@@ -184,7 +177,7 @@ async function runDev() {
               try {
                 const result = await startServer();
                 server = result.server;
-                vector = result.vector;
+                app = result.app;
               } catch (error: any) {
                 console.error('\n[Reload Error]', error.message || error);
                 // Don't exit the process on reload failures, just continue watching

package/src/core/config-loader.ts

@@ -35,8 +35,8 @@ export class ConfigLoader<TTypes extends VectorTypes = DefaultVectorTypes> {
         this.configSource = 'user';
       } catch (error: any) {
         const msg = error instanceof Error ? error.message : String(error);
-        console.error(`[Vector] Failed to load config from ${this.configPath}: ${msg}`);
-        console.error('[Vector] Server is using default configuration. Fix your config file and restart.');
+        console.error(`[vector] Failed to load config from ${this.configPath}: ${msg}`);
+        console.error('[vector] Server is using default configuration. Fix your config file and restart.');
         this.config = {};
       }
     } else {
@@ -62,9 +62,12 @@ export class ConfigLoader<TTypes extends VectorTypes = DefaultVectorTypes> {
       config.reusePort = this.config.reusePort;
       config.development = this.config.development;
       config.routesDir = this.config.routesDir || './routes';
+      config.routeExcludePatterns = this.config.routeExcludePatterns;
       config.idleTimeout = this.config.idleTimeout;
       config.defaults = this.config.defaults;
       config.openapi = this.config.openapi;
+      config.startup = this.config.startup;
+      config.shutdown = this.config.shutdown;
     }
 
     // Always auto-discover routes