vector-framework 1.0.0 → 1.1.1

package/dist/utils/path.d.ts

@@ -1,3 +1,4 @@
 export declare function toFileUrl(path: string): string;
 export declare function normalizePath(path: string): string;
+export declare function buildRouteRegex(path: string): RegExp;
 //# sourceMappingURL=path.d.ts.map

package/dist/utils/path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/utils/path.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI9C;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD"}
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/utils/path.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASpD"}

package/dist/utils/path.js

@@ -1,9 +1,15 @@
 export function toFileUrl(path) {
-    return process.platform === 'win32'
-        ? `file:///${path.replace(/\\/g, '/')}`
-        : path;
+    return process.platform === 'win32' ? `file:///${path.replace(/\\/g, '/')}` : path;
 }
 export function normalizePath(path) {
     return path.replace(/\\/g, '/').replace(/\/+/g, '/');
 }
+export function buildRouteRegex(path) {
+    return RegExp(`^${path
+        .replace(/\/+(\/|$)/g, '$1')
+        .replace(/(\/?\.?):(\w+)\+/g, '($1(?<$2>[\\s\\S]+))')
+        .replace(/(\/?\.?):(\w+)/g, '($1(?<$2>[^$1/]+?))')
+        .replace(/\./g, '\\.')
+        .replace(/(\/?)\*/g, '($1.*)?')}/*$`);
+}
 //# sourceMappingURL=path.js.map

package/dist/utils/path.js.map

@@ -1 +1 @@
-{"version":3,"file":"path.js","sourceRoot":"","sources":["../../src/utils/path.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO;QACjC,CAAC,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE;QACvC,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACvD,CAAC"}
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../src/utils/path.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,MAAM,CACX,IAAI,IAAI;SACL,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC;SAC3B,OAAO,CAAC,mBAAmB,EAAE,sBAAsB,CAAC;SACpD,OAAO,CAAC,iBAAiB,EAAE,qBAAqB,CAAC;SACjD,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,KAAK,CACvC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vector-framework",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "author": "webhie-com",
   "repository": {
     "type": "git",
@@ -12,6 +12,8 @@
     "itty-router": "^5.0.0"
   },
   "devDependencies": {
+    "@biomejs/biome": "^2.4.6",
+    "@biomejs/cli-darwin-arm64": "^2.4.6",
     "@types/bun": "latest",
     "oxlint": "^1.15.0",
     "typescript": "^5.0.0"
@@ -94,13 +96,15 @@
     "test:perf": "bun run test:load && bun run test:soak && bun run test:benchmark",
     "docker:build": "docker build -t vector:latest .",
     "docker:build:test": "docker build -t vector:test --target test .",
-    "docker:run": "docker-compose up",
-    "docker:run:dev": "docker-compose --profile dev up",
-    "docker:test": "docker-compose -f docker-compose.test.yml run test-all",
-    "docker:test:unit": "docker-compose -f docker-compose.test.yml run test-unit",
-    "docker:test:e2e": "docker-compose -f docker-compose.test.yml run test-e2e",
-    "docker:test:load": "docker-compose -f docker-compose.test.yml run test-load",
-    "docker:test:benchmark": "docker-compose -f docker-compose.test.yml run test-benchmark",
+    "docker:run": "docker compose up",
+    "docker:run:dev": "docker compose --profile dev up",
+    "docker:test": "docker compose -f docker-compose.test.yml run test-all",
+    "docker:test:unit": "docker compose -f docker-compose.test.yml run test-unit",
+    "docker:test:e2e": "docker compose -f docker-compose.test.yml run test-e2e",
+    "docker:test:load": "docker compose -f docker-compose.test.yml run test-load",
+    "docker:test:benchmark": "docker compose -f docker-compose.test.yml run test-benchmark",
+    "format": "biome format --write .",
+    "format:check": "biome format .",
     "lint": "oxlint .",
     "lint:fix": "oxlint . --fix",
     "typecheck": "tsc --noEmit",

package/src/cache/manager.ts

@@ -1,10 +1,5 @@
-import { DEFAULT_CONFIG } from "../constants";
-import type {
-  CacheHandler,
-  DefaultVectorTypes,
-  GetCacheType,
-  VectorTypes,
-} from "../types";
+import { DEFAULT_CONFIG } from '../constants';
+import type { CacheHandler, DefaultVectorTypes, GetCacheType, VectorTypes } from '../types';
 
 interface CacheEntry<T = any> {
   value: T;
@@ -15,6 +10,7 @@ export class CacheManager<TTypes extends VectorTypes = DefaultVectorTypes> {
   private cacheHandler: CacheHandler | null = null;
   private memoryCache: Map<string, CacheEntry> = new Map();
   private cleanupInterval: Timer | null = null;
+  private inflight: Map<string, Promise<any>> = new Map();
 
   setCacheHandler(handler: CacheHandler) {
     this.cacheHandler = handler;
@@ -48,10 +44,23 @@ export class CacheManager<TTypes extends VectorTypes = DefaultVectorTypes> {
       return cached!.value as T;
     }
 
-    const value = await factory();
-    this.setInMemoryCache(key, value, ttl);
+    // Deduplicate concurrent requests for the same key (cache stampede prevention)
+    if (this.inflight.has(key)) {
+      return (await this.inflight.get(key)!) as T;
+    }
 
-    return value;
+    const promise = (async () => {
+      const value = await factory();
+      this.setInMemoryCache(key, value, ttl);
+      return value;
+    })();
+
+    this.inflight.set(key, promise);
+    try {
+      return await promise;
+    } finally {
+      this.inflight.delete(key);
+    }
   }
 
   private isCacheValid(entry: CacheEntry | undefined, now: number): boolean {
@@ -129,15 +138,15 @@ export class CacheManager<TTypes extends VectorTypes = DefaultVectorTypes> {
     return true;
   }
 
-  generateKey(request: Request, options?: { authUser?: any }): string {
-    const url = new URL(request.url);
+  generateKey(request: Request & { _parsedUrl?: URL }, options?: { authUser?: any }): string {
+    const url = request._parsedUrl ?? new URL(request.url);
     const parts = [
       request.method,
       url.pathname,
       url.search,
-      options?.authUser?.id || "anonymous",
+      options?.authUser?.id != null ? String(options.authUser.id) : 'anonymous',
     ];
 
-    return parts.join(":");
+    return parts.join(':');
   }
 }

package/src/cli/index.ts

@@ -1,54 +1,53 @@
 #!/usr/bin/env bun
 
-import { watch } from "node:fs";
-import { parseArgs } from "node:util";
-import { getVectorInstance } from "../core/vector";
-import { ConfigLoader } from "../core/config-loader";
+import { watch } from 'node:fs';
+import { parseArgs } from 'node:util';
+import { getVectorInstance } from '../core/vector';
+import { ConfigLoader } from '../core/config-loader';
 
 // Compatibility layer for both Node and Bun
-const args =
-  typeof Bun !== "undefined" ? Bun.argv.slice(2) : process.argv.slice(2);
+const args = typeof Bun !== 'undefined' ? Bun.argv.slice(2) : process.argv.slice(2);
 
 const { values, positionals } = parseArgs({
   args,
   options: {
     port: {
-      type: "string",
-      short: "p",
-      default: "3000",
+      type: 'string',
+      short: 'p',
+      default: '3000',
     },
     host: {
-      type: "string",
-      short: "h",
-      default: "localhost",
+      type: 'string',
+      short: 'h',
+      default: 'localhost',
     },
     routes: {
-      type: "string",
-      short: "r",
-      default: "./routes",
+      type: 'string',
+      short: 'r',
+      default: './routes',
     },
     watch: {
-      type: "boolean",
-      short: "w",
+      type: 'boolean',
+      short: 'w',
       default: true,
     },
     cors: {
-      type: "boolean",
+      type: 'boolean',
       default: true,
     },
     config: {
-      type: "string",
-      short: "c",
+      type: 'string',
+      short: 'c',
     },
   },
   strict: true,
   allowPositionals: true,
 });
 
-const command = positionals[0] || "dev";
+const command = positionals[0] || 'dev';
 
 async function runDev() {
-  const isDev = command === "dev";
+  const isDev = command === 'dev';
 
   let server: any = null;
   let vector: any = null;
@@ -57,7 +56,7 @@ async function runDev() {
     // Create a timeout promise that rejects after 10 seconds
     const timeoutPromise = new Promise<never>((_, reject) => {
       setTimeout(() => {
-        reject(new Error("Server startup timed out (10s)"));
+        reject(new Error('Server startup timed out (10s)'));
       }, 10000);
     });
 
@@ -79,11 +78,11 @@ async function runDev() {
       // Only apply default CORS if config.cors is undefined (not set)
       if (config.cors === undefined && values.cors) {
         config.cors = {
-          origin: "*",
+          origin: '*',
           credentials: true,
-          allowHeaders: "Content-Type, Authorization",
-          allowMethods: "GET, POST, PUT, PATCH, DELETE, OPTIONS",
-          exposeHeaders: "Authorization",
+          allowHeaders: 'Content-Type, Authorization',
+          allowMethods: 'GET, POST, PUT, PATCH, DELETE, OPTIONS',
+          exposeHeaders: 'Authorization',
           maxAge: 86400,
         };
       }
@@ -108,15 +107,13 @@ async function runDev() {
 
       // Verify the server is actually running
       if (!server || !server.port) {
-        throw new Error("Server started but is not responding correctly");
+        throw new Error('Server started but is not responding correctly');
       }
 
-      const cyan = "\x1b[36m";
-      const reset = "\x1b[0m";
+      const cyan = '\x1b[36m';
+      const reset = '\x1b[0m';
 
-      console.log(
-        `\nListening on ${cyan}http://${config.hostname}:${config.port}${reset}\n`
-      );
+      console.log(`\nListening on ${cyan}http://${config.hostname}:${config.port}${reset}\n`);
 
       return { server, vector, config };
     })();
@@ -144,17 +141,16 @@ async function runDev() {
           const now = Date.now();
           if (isReloading || now - lastReloadTime < 1000) return;
 
+          const segments = filename ? filename.split(/[/\\]/) : [];
+          const excluded = segments.some((s) =>
+            ['node_modules', '.git', '.vector', 'dist'].includes(s)
+          );
           if (
             filename &&
-            (filename.endsWith(".ts") ||
-              filename.endsWith(".js") ||
-              filename.endsWith(".json")) &&
-            !filename.includes("node_modules") &&
-            !filename.includes(".git") &&
-            !filename.includes(".vector") && // Ignore generated files
-            !filename.includes("dist") && // Ignore dist folder
-            !filename.includes("bun.lockb") && // Ignore lock files
-            !filename.endsWith(".generated.ts") // Ignore generated files
+            (filename.endsWith('.ts') || filename.endsWith('.js') || filename.endsWith('.json')) &&
+            !excluded &&
+            !filename.includes('bun.lockb') && // Ignore lock files
+            !filename.endsWith('.generated.ts') // Ignore generated files
           ) {
             // Track changed files
             changedFiles.add(filename);
@@ -181,24 +177,13 @@ async function runDev() {
               // Small delay to ensure file system operations complete
               await new Promise((resolve) => setTimeout(resolve, 100));
 
-              // Clear module cache to ensure fresh imports
-              // Note: Bun uses ESM and doesn't have require.cache
-              // The Loader API will handle module reloading automatically
-              if (typeof require !== 'undefined' && require.cache) {
-                for (const key in require.cache) {
-                  if (!key.includes("node_modules")) {
-                    delete require.cache[key];
-                  }
-                }
-              }
-
               // Restart the server
               try {
                 const result = await startServer();
                 server = result.server;
                 vector = result.vector;
               } catch (error: any) {
-                console.error("\n[Reload Error]", error.message || error);
+                console.error('\n[Reload Error]', error.message || error);
                 // Don't exit the process on reload failures, just continue watching
               } finally {
                 // Reset flag immediately after reload completes
@@ -209,18 +194,18 @@ async function runDev() {
           }
         });
       } catch {
-        const yellow = "\x1b[33m";
-        const reset = "\x1b[0m";
+        const yellow = '\x1b[33m';
+        const reset = '\x1b[0m';
         console.warn(`${yellow}Warning: File watching not available${reset}`);
       }
     }
   } catch (error: any) {
-    const red = "\x1b[31m";
-    const reset = "\x1b[0m";
+    const red = '\x1b[31m';
+    const reset = '\x1b[0m';
 
     console.error(`\n${red}Error: ${error.message || error}${reset}\n`);
 
-    if (error.stack && process.env.NODE_ENV === "development") {
+    if (error.stack && process.env.NODE_ENV === 'development') {
       console.error(error.stack);
     }
 
@@ -230,8 +215,8 @@ async function runDev() {
 
 async function runBuild() {
   try {
-    const { RouteScanner } = await import("../dev/route-scanner");
-    const { RouteGenerator } = await import("../dev/route-generator");
+    const { RouteScanner } = await import('../dev/route-scanner');
+    const { RouteGenerator } = await import('../dev/route-generator');
 
     // Step 1: Scan and generate routes
     const scanner = new RouteScanner(values.routes as string);
@@ -241,17 +226,17 @@ async function runBuild() {
     await generator.generate(routes);
 
     // Step 2: Build the application with Bun
-    if (typeof Bun !== "undefined") {
+    if (typeof Bun !== 'undefined') {
       // Build the CLI as an executable
       const buildProcess = Bun.spawn([
-        "bun",
-        "build",
-        "src/cli/index.ts",
-        "--target",
-        "bun",
-        "--outfile",
-        "dist/server.js",
-        "--minify",
+        'bun',
+        'build',
+        'src/cli/index.ts',
+        '--target',
+        'bun',
+        '--outfile',
+        'dist/server.js',
+        '--minify',
       ]);
 
       const exitCode = await buildProcess.exited;
@@ -260,20 +245,12 @@ async function runBuild() {
       }
     } else {
       // For Node.js, use child_process
-      const { spawnSync } = await import("child_process");
+      const { spawnSync } = await import('child_process');
       const result = spawnSync(
-        "bun",
-        [
-          "build",
-          "src/cli/index.ts",
-          "--target",
-          "bun",
-          "--outfile",
-          "dist/server.js",
-          "--minify",
-        ],
+        'bun',
+        ['build', 'src/cli/index.ts', '--target', 'bun', '--outfile', 'dist/server.js', '--minify'],
         {
-          stdio: "inherit",
+          stdio: 'inherit',
           shell: true,
         }
       );
@@ -283,24 +260,24 @@ async function runBuild() {
       }
     }
 
-    console.log("\nBuild complete: dist/server.js\n");
+    console.log('\nBuild complete: dist/server.js\n');
   } catch (error: any) {
-    const red = "\x1b[31m";
-    const reset = "\x1b[0m";
+    const red = '\x1b[31m';
+    const reset = '\x1b[0m';
     console.error(`\n${red}Error: ${error.message || error}${reset}\n`);
     process.exit(1);
   }
 }
 
 switch (command) {
-  case "dev":
+  case 'dev':
     await runDev();
     break;
-  case "build":
+  case 'build':
     await runBuild();
     break;
-  case "start":
-    process.env.NODE_ENV = "production";
+  case 'start':
+    process.env.NODE_ENV = 'production';
     await runDev();
     break;
   default:

package/src/core/config-loader.ts

@@ -1,6 +1,6 @@
-import { existsSync } from "node:fs";
-import { resolve, isAbsolute } from "node:path";
-import { toFileUrl } from "../utils/path";
+import { existsSync } from 'node:fs';
+import { resolve, isAbsolute } from 'node:path';
+import { toFileUrl } from '../utils/path';
 import type {
   CacheHandler,
   CorsOptions,
@@ -9,21 +9,19 @@ import type {
   VectorConfig,
   VectorConfigSchema,
   VectorTypes,
-} from "../types";
+} from '../types';
 
 export class ConfigLoader<TTypes extends VectorTypes = DefaultVectorTypes> {
   private configPath: string;
   private config: VectorConfigSchema<TTypes> | null = null;
-  private configSource: "user" | "default" = "default";
+  private configSource: 'user' | 'default' = 'default';
 
   constructor(configPath?: string) {
     // Use provided config path or default to vector.config.ts
-    const path = configPath || "vector.config.ts";
+    const path = configPath || 'vector.config.ts';
 
     // Handle absolute vs relative paths
-    this.configPath = isAbsolute(path)
-      ? path
-      : resolve(process.cwd(), path);
+    this.configPath = isAbsolute(path) ? path : resolve(process.cwd(), path);
   }
 
   async load(): Promise<VectorConfig<TTypes>> {
@@ -34,12 +32,12 @@ export class ConfigLoader<TTypes extends VectorTypes = DefaultVectorTypes> {
         const userConfigPath = toFileUrl(this.configPath);
         const userConfig = await import(userConfigPath);
         this.config = userConfig.default || userConfig;
-        this.configSource = "user";
+        this.configSource = 'user';
       } catch (error: any) {
-        const red = "\x1b[31m";
-        const reset = "\x1b[0m";
+        const msg = error instanceof Error ? error.message : String(error);
+        console.error(`[Vector] Failed to load config from ${this.configPath}: ${msg}`);
         console.error(
-          `${red}Error loading config: ${error.message || error}${reset}`
+          '[Vector] Server is using default configuration. Fix your config file and restart.'
         );
         this.config = {};
       }
@@ -52,7 +50,7 @@ export class ConfigLoader<TTypes extends VectorTypes = DefaultVectorTypes> {
     return await this.buildLegacyConfig();
   }
 
-  getConfigSource(): "user" | "default" {
+  getConfigSource(): 'user' | 'default' {
     return this.configSource;
   }
 
@@ -65,7 +63,7 @@ export class ConfigLoader<TTypes extends VectorTypes = DefaultVectorTypes> {
       config.hostname = this.config.hostname;
       config.reusePort = this.config.reusePort;
       config.development = this.config.development;
-      config.routesDir = this.config.routesDir || "./routes";
+      config.routesDir = this.config.routesDir || './routes';
       config.idleTimeout = this.config.idleTimeout;
     }
 
@@ -74,14 +72,14 @@ export class ConfigLoader<TTypes extends VectorTypes = DefaultVectorTypes> {
 
     // CORS configuration
     if (this.config?.cors) {
-      if (typeof this.config.cors === "boolean") {
+      if (typeof this.config.cors === 'boolean') {
         config.cors = this.config.cors
           ? {
-              origin: "*",
+              origin: '*',
               credentials: true,
-              allowHeaders: "Content-Type, Authorization",
-              allowMethods: "GET, POST, PUT, PATCH, DELETE, OPTIONS",
-              exposeHeaders: "Authorization",
+              allowHeaders: 'Content-Type, Authorization',
+              allowMethods: 'GET, POST, PUT, PATCH, DELETE, OPTIONS',
+              exposeHeaders: 'Authorization',
               maxAge: 86400,
             }
           : undefined;