vector-framework 0.8.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,oBAAY,QAAQ;IAClB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;CACV;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM;IAQ9C,OAAO,CAAC,aAAa;IAiBrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAM5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAM3C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAM3C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;IAS3C,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;CAGhC;AAED,eAAO,MAAM,MAAM,QAKjB,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,68 @@
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+})(LogLevel || (LogLevel = {}));
+export class Logger {
+    config;
+    constructor(config = {}) {
+        this.config = {
+            level: config.level ?? LogLevel.INFO,
+            prefix: config.prefix ?? '[Vector]',
+            timestamp: config.timestamp ?? true,
+        };
+    }
+    formatMessage(level, message) {
+        const parts = [];
+        if (this.config.timestamp) {
+            parts.push(`[${new Date().toISOString()}]`);
+        }
+        if (this.config.prefix) {
+            parts.push(this.config.prefix);
+        }
+        parts.push(`[${level}]`);
+        parts.push(message);
+        return parts.join(' ');
+    }
+    debug(message, ...args) {
+        if (this.config.level <= LogLevel.DEBUG) {
+            console.log(this.formatMessage('DEBUG', message), ...args);
+        }
+    }
+    info(message, ...args) {
+        if (this.config.level <= LogLevel.INFO) {
+            console.log(this.formatMessage('INFO', message), ...args);
+        }
+    }
+    warn(message, ...args) {
+        if (this.config.level <= LogLevel.WARN) {
+            console.warn(this.formatMessage('WARN', message), ...args);
+        }
+    }
+    error(message, error) {
+        if (this.config.level <= LogLevel.ERROR) {
+            console.error(this.formatMessage('ERROR', message));
+            if (error) {
+                console.error(error.stack || error.message);
+            }
+        }
+    }
+    success(message) {
+        console.log(`✅ ${message}`);
+    }
+    loading(message) {
+        console.log(`⏳ ${message}`);
+    }
+    setLevel(level) {
+        this.config.level = level;
+    }
+}
+export const logger = new Logger({
+    level: process.env.LOG_LEVEL
+        ? (LogLevel[process.env.LOG_LEVEL] ?? LogLevel.INFO)
+        : LogLevel.INFO,
+    timestamp: process.env.NODE_ENV !== 'production',
+});
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/validation.d.ts

@@ -0,0 +1,5 @@
+import type { VectorConfig } from '../types';
+export declare function validateConfig(config: VectorConfig): VectorConfig;
+export declare function isValidHttpMethod(method: string): boolean;
+export declare function isValidPath(path: string): boolean;
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,UAAU,CAAC;AAE1D,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAcjE;AAiCD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAGzD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD"}

package/dist/utils/validation.js

@@ -0,0 +1,48 @@
+import { DEFAULT_CONFIG } from '../constants';
+export function validateConfig(config) {
+    const validatedConfig = {
+        port: validatePort(config.port),
+        hostname: config.hostname || DEFAULT_CONFIG.HOSTNAME,
+        reusePort: config.reusePort !== false,
+        development: config.development || false,
+        routesDir: config.routesDir || DEFAULT_CONFIG.ROUTES_DIR,
+        autoDiscover: config.autoDiscover !== false,
+        cors: config.cors ? validateCorsOptions(config.cors) : undefined,
+        before: config.before || [],
+        finally: config.finally || [],
+    };
+    return validatedConfig;
+}
+function validatePort(port) {
+    if (port === undefined) {
+        return DEFAULT_CONFIG.PORT;
+    }
+    if (!Number.isInteger(port) || port < 1 || port > 65535) {
+        throw new Error(`Invalid port: ${port}. Port must be between 1 and 65535.`);
+    }
+    return port;
+}
+function validateCorsOptions(cors) {
+    if (cors === false) {
+        return undefined;
+    }
+    if (cors === true) {
+        return {
+            origin: '*',
+            credentials: true,
+            allowHeaders: ['Content-Type', 'Authorization'],
+            allowMethods: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS'],
+            exposeHeaders: ['Authorization'],
+            maxAge: DEFAULT_CONFIG.CORS_MAX_AGE,
+        };
+    }
+    return cors;
+}
+export function isValidHttpMethod(method) {
+    const validMethods = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS', 'HEAD'];
+    return validMethods.includes(method.toUpperCase());
+}
+export function isValidPath(path) {
+    return path.startsWith('/') && !path.includes(' ');
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,MAAM,UAAU,cAAc,CAAC,MAAoB;IACjD,MAAM,eAAe,GAAiB;QACpC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;QAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,cAAc,CAAC,QAAQ;QACpD,SAAS,EAAE,MAAM,CAAC,SAAS,KAAK,KAAK;QACrC,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,KAAK;QACxC,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,cAAc,CAAC,UAAU;QACxD,YAAY,EAAE,MAAM,CAAC,YAAY,KAAK,KAAK;QAC3C,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;QAChE,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;QAC3B,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;KAC9B,CAAC;IAEF,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,SAAS,YAAY,CAAC,IAAa;IACjC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,cAAc,CAAC,IAAI,CAAC;IAC7B,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,qCAAqC,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,mBAAmB,CAAC,IAA2B;IACtD,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACnB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO;YACL,MAAM,EAAE,GAAG;YACX,WAAW,EAAE,IAAI;YACjB,YAAY,EAAE,CAAC,cAAc,EAAE,eAAe,CAAC;YAC/C,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC;YAClE,aAAa,EAAE,CAAC,eAAe,CAAC;YAChC,MAAM,EAAE,cAAc,CAAC,YAAY;SACpC,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAClF,OAAO,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AACrD,CAAC"}

package/package.json

@@ -0,0 +1,110 @@
+{
+  "name": "vector-framework",
+  "version": "0.8.1",
+  "author": "",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/webhie-com/vector.git"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "dependencies": {
+    "itty-router": "^5.0.0"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "oxlint": "^1.15.0",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "bun": ">=1.0.0"
+  },
+  "exports": {
+    ".": {
+      "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"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/types/index.mjs",
+      "require": "./dist/types/index.js"
+    },
+    "./errors": {
+      "types": "./dist/errors/index.d.ts",
+      "import": "./dist/errors/index.mjs",
+      "require": "./dist/errors/index.js"
+    }
+  },
+  "bin": {
+    "vector": "./src/cli/index.ts"
+  },
+  "bugs": {
+    "url": "https://github.com/webhie-com/vector/issues"
+  },
+  "description": "A modern TypeScript API framework built with Bun and itty-router",
+  "engines": {
+    "bun": ">=1.0.0"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
+  "homepage": "https://github.com/webhie-com/vector#readme",
+  "keywords": [
+    "api",
+    "framework",
+    "bun",
+    "itty-router",
+    "typescript",
+    "rest",
+    "http",
+    "server",
+    "middleware",
+    "router"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "dev": "bun run src/cli/index.ts dev",
+    "start": "bun run src/cli/index.ts start",
+    "build": "bun run src/cli/index.ts build",
+    "example": "bun run examples/server.ts",
+    "build:lib": "bun run build:clean && bun run build:ts && bun run build:bundle",
+    "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",
+    "test": "bun test tests/api-error.test.ts tests/cache.test.ts tests/middleware.test.ts tests/router.test.ts tests/vector.test.ts",
+    "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 tests/e2e/e2e.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",
+    "test:all": "bun test 'tests/**/*.test.ts'",
+    "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",
+    "lint": "oxlint .",
+    "lint:fix": "oxlint . --fix",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun run build:lib && bun run test"
+  },
+  "type": "module",
+  "types": "./dist/index.d.ts"
+}

package/src/auth/protected.ts

@@ -0,0 +1,41 @@
+import type {
+  DefaultVectorTypes,
+  GetAuthType,
+  ProtectedHandler,
+  VectorRequest,
+  VectorTypes,
+} from '../types';
+
+export class AuthManager<TTypes extends VectorTypes = DefaultVectorTypes> {
+  private protectedHandler: ProtectedHandler<TTypes> | null = null;
+
+  setProtectedHandler(handler: ProtectedHandler<TTypes>) {
+    this.protectedHandler = handler;
+  }
+
+  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.'
+      );
+    }
+
+    try {
+      const authUser = await this.protectedHandler(request);
+      request.authUser = authUser;
+      return authUser;
+    } catch (error) {
+      throw new Error(
+        `Authentication failed: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+
+  isAuthenticated(request: VectorRequest<TTypes>): boolean {
+    return !!request.authUser;
+  }
+
+  getUser(request: VectorRequest<TTypes>): GetAuthType<TTypes> | null {
+    return request.authUser || null;
+  }
+}

package/src/cache/manager.ts

@@ -0,0 +1,133 @@
+import { DEFAULT_CONFIG } from '../constants';
+import type { CacheHandler, DefaultVectorTypes, GetCacheType, VectorTypes } from '../types';
+
+interface CacheEntry<T = any> {
+  value: T;
+  expires: number;
+}
+
+export class CacheManager<TTypes extends VectorTypes = DefaultVectorTypes> {
+  private cacheHandler: CacheHandler | null = null;
+  private memoryCache: Map<string, CacheEntry> = new Map();
+  private cleanupInterval: Timer | null = null;
+
+  setCacheHandler(handler: CacheHandler) {
+    this.cacheHandler = handler;
+  }
+
+  async get<T = GetCacheType<TTypes>>(
+    key: string,
+    factory: () => Promise<T>,
+    ttl: number = DEFAULT_CONFIG.CACHE_TTL
+  ): Promise<T> {
+    if (ttl <= 0) {
+      return factory();
+    }
+
+    if (this.cacheHandler) {
+      return this.cacheHandler(key, factory, ttl) as Promise<T>;
+    }
+
+    return this.getFromMemoryCache(key, factory, ttl);
+  }
+
+  private async getFromMemoryCache<T>(
+    key: string,
+    factory: () => Promise<T>,
+    ttl: number
+  ): Promise<T> {
+    const now = Date.now();
+    const cached = this.memoryCache.get(key);
+
+    if (this.isCacheValid(cached, now)) {
+      return cached!.value as T;
+    }
+
+    const value = await factory();
+    this.setInMemoryCache(key, value, ttl);
+
+    return value;
+  }
+
+  private isCacheValid(entry: CacheEntry | undefined, now: number): boolean {
+    return entry !== undefined && entry.expires > now;
+  }
+
+  private setInMemoryCache(key: string, value: any, ttl: number): void {
+    const expires = Date.now() + ttl * 1000;
+    this.memoryCache.set(key, { value, expires });
+
+    this.scheduleCleanup();
+  }
+
+  private scheduleCleanup(): void {
+    if (this.cleanupInterval) return;
+
+    this.cleanupInterval = setInterval(() => {
+      this.cleanupExpired();
+    }, 60000); // Clean up every minute
+  }
+
+  private cleanupExpired(): void {
+    const now = Date.now();
+    for (const [key, entry] of this.memoryCache.entries()) {
+      if (entry.expires <= now) {
+        this.memoryCache.delete(key);
+      }
+    }
+
+    if (this.memoryCache.size === 0 && this.cleanupInterval) {
+      clearInterval(this.cleanupInterval);
+      this.cleanupInterval = null;
+    }
+  }
+
+  clear(): void {
+    this.memoryCache.clear();
+    if (this.cleanupInterval) {
+      clearInterval(this.cleanupInterval);
+      this.cleanupInterval = null;
+    }
+  }
+
+  async set<T = GetCacheType<TTypes>>(
+    key: string,
+    value: T,
+    ttl: number = DEFAULT_CONFIG.CACHE_TTL
+  ): Promise<void> {
+    if (ttl <= 0) {
+      return;
+    }
+
+    if (this.cacheHandler) {
+      // Custom cache handler can implement its own set logic
+      await this.cacheHandler(key, async () => value, ttl);
+      return;
+    }
+
+    this.setInMemoryCache(key, value, ttl);
+  }
+
+  delete(key: string): boolean {
+    return this.memoryCache.delete(key);
+  }
+
+  has(key: string): boolean {
+    const entry = this.memoryCache.get(key);
+    if (!entry) return false;
+
+    if (entry.expires <= Date.now()) {
+      this.memoryCache.delete(key);
+      return false;
+    }
+
+    return true;
+  }
+
+  generateKey(request: Request, options?: { authUser?: any }): string {
+    const url = new URL(request.url);
+    const parts = [request.method, url.pathname, url.search, options?.authUser?.id || 'anonymous'];
+
+    return parts.join(':');
+  }
+}

package/src/cli/index.ts

@@ -0,0 +1,157 @@
+#!/usr/bin/env bun
+
+import { join } from 'node:path';
+import { parseArgs } from 'node:util';
+import vector from '../core/vector';
+
+const { values, positionals } = parseArgs({
+  args: Bun.argv.slice(2),
+  options: {
+    port: {
+      type: 'string',
+      short: 'p',
+      default: '3000',
+    },
+    host: {
+      type: 'string',
+      short: 'h',
+      default: 'localhost',
+    },
+    routes: {
+      type: 'string',
+      short: 'r',
+      default: './routes',
+    },
+    watch: {
+      type: 'boolean',
+      short: 'w',
+      default: true,
+    },
+    cors: {
+      type: 'boolean',
+      default: true,
+    },
+  },
+  strict: true,
+  allowPositionals: true,
+});
+
+const command = positionals[0] || 'dev';
+
+async function runDev() {
+  const isDev = command === 'dev';
+  console.log(`\n→ Starting Vector ${isDev ? 'development' : 'production'} server\n`);
+
+  const config = {
+    port: Number.parseInt(values.port as string),
+    hostname: values.host as string,
+    routesDir: values.routes as string,
+    development: isDev,
+    autoDiscover: true,
+    cors: values.cors
+      ? {
+          origin: '*',
+          credentials: true,
+          allowHeaders: 'Content-Type, Authorization',
+          allowMethods: 'GET, POST, PUT, PATCH, DELETE, OPTIONS',
+          exposeHeaders: 'Authorization',
+          maxAge: 86400,
+        }
+      : undefined,
+  };
+
+  try {
+    const userConfigPath = join(process.cwd(), 'vector.config.ts');
+    try {
+      const userConfig = await import(userConfigPath);
+      if (userConfig.default) {
+        Object.assign(config, userConfig.default);
+      }
+    } catch {
+      // No user config file, use defaults
+    }
+
+    await vector.serve(config);
+
+    const gray = '\x1b[90m';
+    const reset = '\x1b[0m';
+    const cyan = '\x1b[36m';
+    const green = '\x1b[32m';
+
+    console.log(`  ${gray}Routes${reset}     ${config.routesDir}`);
+    if (isDev && values.watch) {
+      console.log(`  ${gray}Watching${reset}   Enabled`);
+    }
+    console.log(`  ${gray}CORS${reset}       ${values.cors ? 'Enabled' : 'Disabled'}`);
+    console.log(`  ${gray}Mode${reset}       ${isDev ? 'Development' : 'Production'}\n`);
+    console.log(
+      `  ${green}Ready${reset} → ${cyan}http://${config.hostname}:${config.port}${reset}\n`
+    );
+  } catch (error) {
+    console.error('[ERROR] Failed to start server:', error);
+    process.exit(1);
+  }
+}
+
+async function runBuild() {
+  console.log('\n→ Building Vector application\n');
+
+  try {
+    const { RouteScanner } = await import('../dev/route-scanner');
+    const { RouteGenerator } = await import('../dev/route-generator');
+
+    const scanner = new RouteScanner(values.routes as string);
+    const generator = new RouteGenerator();
+
+    const routes = await scanner.scan();
+    await generator.generate(routes);
+
+    console.log(`  Generated ${routes.length} routes`);
+
+    const buildProcess = Bun.spawn([
+      'bun',
+      'build',
+      'src/index.ts',
+      '--outdir',
+      'dist',
+      '--minify',
+    ]);
+    await buildProcess.exited;
+
+    console.log('\n  ✓ Build complete\n');
+  } catch (error) {
+    console.error('[ERROR] Build failed:', error);
+    process.exit(1);
+  }
+}
+
+switch (command) {
+  case 'dev':
+    await runDev();
+    break;
+  case 'build':
+    await runBuild();
+    break;
+  case 'start':
+    process.env.NODE_ENV = 'production';
+    await runDev();
+    break;
+  default:
+    console.error(`Unknown command: ${command}`);
+    console.log(`
+Usage: vector [command] [options]
+
+Commands:
+  dev     Start development server (default)
+  build   Build for production
+  start   Start production server
+
+Options:
+  -p, --port <port>      Port to listen on (default: 3000)
+  -h, --host <host>      Hostname to bind to (default: localhost)
+  -r, --routes <dir>     Routes directory (default: ./routes)
+  -w, --watch            Watch for file changes (default: true)
+  --cors                 Enable CORS (default: true)
+`);
+    process.exit(1);
+}

package/src/constants/index.ts

@@ -0,0 +1,93 @@
+export const HTTP_STATUS = {
+  // 2xx Success
+  OK: 200,
+  CREATED: 201,
+  ACCEPTED: 202,
+  NON_AUTHORITATIVE_INFORMATION: 203,
+  NO_CONTENT: 204,
+  RESET_CONTENT: 205,
+  PARTIAL_CONTENT: 206,
+  MULTI_STATUS: 207,
+  ALREADY_REPORTED: 208,
+  IM_USED: 226,
+
+  // 3xx Redirection
+  MULTIPLE_CHOICES: 300,
+  MOVED_PERMANENTLY: 301,
+  FOUND: 302,
+  SEE_OTHER: 303,
+  NOT_MODIFIED: 304,
+  USE_PROXY: 305,
+  TEMPORARY_REDIRECT: 307,
+  PERMANENT_REDIRECT: 308,
+
+  // 4xx Client Errors
+  BAD_REQUEST: 400,
+  UNAUTHORIZED: 401,
+  PAYMENT_REQUIRED: 402,
+  FORBIDDEN: 403,
+  NOT_FOUND: 404,
+  METHOD_NOT_ALLOWED: 405,
+  NOT_ACCEPTABLE: 406,
+  PROXY_AUTHENTICATION_REQUIRED: 407,
+  REQUEST_TIMEOUT: 408,
+  CONFLICT: 409,
+  GONE: 410,
+  LENGTH_REQUIRED: 411,
+  PRECONDITION_FAILED: 412,
+  PAYLOAD_TOO_LARGE: 413,
+  URI_TOO_LONG: 414,
+  UNSUPPORTED_MEDIA_TYPE: 415,
+  RANGE_NOT_SATISFIABLE: 416,
+  EXPECTATION_FAILED: 417,
+  IM_A_TEAPOT: 418,
+  MISDIRECTED_REQUEST: 421,
+  UNPROCESSABLE_ENTITY: 422,
+  LOCKED: 423,
+  FAILED_DEPENDENCY: 424,
+  TOO_EARLY: 425,
+  UPGRADE_REQUIRED: 426,
+  PRECONDITION_REQUIRED: 428,
+  TOO_MANY_REQUESTS: 429,
+  REQUEST_HEADER_FIELDS_TOO_LARGE: 431,
+  UNAVAILABLE_FOR_LEGAL_REASONS: 451,
+
+  // 5xx Server Errors
+  INTERNAL_SERVER_ERROR: 500,
+  NOT_IMPLEMENTED: 501,
+  BAD_GATEWAY: 502,
+  SERVICE_UNAVAILABLE: 503,
+  GATEWAY_TIMEOUT: 504,
+  HTTP_VERSION_NOT_SUPPORTED: 505,
+  VARIANT_ALSO_NEGOTIATES: 506,
+  INSUFFICIENT_STORAGE: 507,
+  LOOP_DETECTED: 508,
+  NOT_EXTENDED: 510,
+  NETWORK_AUTHENTICATION_REQUIRED: 511,
+} as const;
+
+export const DEFAULT_CONFIG = {
+  PORT: 3000,
+  HOSTNAME: 'localhost',
+  ROUTES_DIR: './routes',
+  CACHE_TTL: 0,
+  CORS_MAX_AGE: 86400,
+} as const;
+
+export const CONTENT_TYPES = {
+  JSON: 'application/json',
+  TEXT: 'text/plain',
+  HTML: 'text/html',
+  FORM_URLENCODED: 'application/x-www-form-urlencoded',
+  MULTIPART: 'multipart/form-data',
+} as const;
+
+export const HTTP_METHODS = {
+  GET: 'GET',
+  POST: 'POST',
+  PUT: 'PUT',
+  PATCH: 'PATCH',
+  DELETE: 'DELETE',
+  OPTIONS: 'OPTIONS',
+  HEAD: 'HEAD',
+} as const;