@morojs/moro 1.6.1 → 1.6.2

package/dist/core/routing/path-matcher.d.ts

@@ -0,0 +1,67 @@
+export interface CompiledPath {
+    pattern: RegExp | null;
+    paramNames: string[];
+    isStatic: boolean;
+    path: string;
+    segments: number;
+}
+export interface MatchResult {
+    params: Record<string, string>;
+}
+/**
+ * PathMatcher - Single source of truth for path pattern compilation and matching
+ */
+export declare class PathMatcher {
+    private static readonly cache;
+    private static compilationCount;
+    private static cacheHits;
+    private static cacheMisses;
+    /**
+     * Compile a path pattern into an efficient matching structure
+     * Results are cached for performance
+     */
+    static compile(path: string): CompiledPath;
+    /**
+     * Internal compilation logic
+     */
+    private static compileInternal;
+    /**
+     * Match a request path against a compiled pattern
+     * Returns match result with extracted parameters, or null if no match
+     */
+    static match(compiledPath: CompiledPath, requestPath: string): MatchResult | null;
+    /**
+     * Compile and match in one operation (convenience method)
+     */
+    static compileAndMatch(pathPattern: string, requestPath: string): MatchResult | null;
+    /**
+     * Check if a path pattern is static (no parameters)
+     */
+    static isStatic(path: string): boolean;
+    /**
+     * Get performance statistics
+     */
+    static getStats(): {
+        cacheSize: number;
+        cacheHits: number;
+        cacheMisses: number;
+        hitRate: number;
+        compilationCount: number;
+    };
+    /**
+     * Clear the cache (useful for testing)
+     */
+    static clearCache(): void;
+    /**
+     * Pre-compile multiple paths (cache warming)
+     */
+    static precompile(paths: string[]): void;
+}
+/**
+ * Legacy compatibility function - maps to PathMatcher.compile
+ * @deprecated Use PathMatcher.compile instead
+ */
+export declare function pathToRegex(path: string): {
+    pattern: RegExp;
+    paramNames: string[];
+};

package/dist/core/routing/path-matcher.js

@@ -0,0 +1,182 @@
+// Shared Path Matching Utility with Caching
+// Replaces 6 different pathToRegex implementations across the codebase
+/**
+ * LRU Cache implementation for compiled paths
+ */
+class LRUCache {
+    cache = new Map();
+    maxSize;
+    constructor(maxSize = 1000) {
+        this.maxSize = maxSize;
+    }
+    get(key) {
+        const value = this.cache.get(key);
+        if (value !== undefined) {
+            // Move to end (most recently used)
+            this.cache.delete(key);
+            this.cache.set(key, value);
+        }
+        return value;
+    }
+    set(key, value) {
+        // Remove if exists (to update position)
+        if (this.cache.has(key)) {
+            this.cache.delete(key);
+        }
+        // Add to end
+        this.cache.set(key, value);
+        // Evict oldest if over capacity
+        if (this.cache.size > this.maxSize) {
+            const firstKey = this.cache.keys().next().value;
+            if (firstKey !== undefined) {
+                this.cache.delete(firstKey);
+            }
+        }
+    }
+    has(key) {
+        return this.cache.has(key);
+    }
+    clear() {
+        this.cache.clear();
+    }
+    get size() {
+        return this.cache.size;
+    }
+}
+/**
+ * PathMatcher - Single source of truth for path pattern compilation and matching
+ */
+export class PathMatcher {
+    static cache = new LRUCache(1000);
+    static compilationCount = 0;
+    static cacheHits = 0;
+    static cacheMisses = 0;
+    /**
+     * Compile a path pattern into an efficient matching structure
+     * Results are cached for performance
+     */
+    static compile(path) {
+        // Check cache first
+        const cached = this.cache.get(path);
+        if (cached) {
+            this.cacheHits++;
+            return cached;
+        }
+        this.cacheMisses++;
+        this.compilationCount++;
+        // Compile the pattern
+        const compiled = this.compileInternal(path);
+        this.cache.set(path, compiled);
+        return compiled;
+    }
+    /**
+     * Internal compilation logic
+     */
+    static compileInternal(path) {
+        const paramNames = [];
+        const isStatic = !path.includes(':') && !path.includes('*');
+        // Calculate segment count for optimization
+        const segments = path.split('/').filter(s => s.length > 0).length;
+        if (isStatic) {
+            // No regex needed for static routes
+            return {
+                pattern: null,
+                paramNames: [],
+                isStatic: true,
+                path,
+                segments,
+            };
+        }
+        // Convert parameterized routes to regex
+        // Match :paramName and capture the parameter name
+        const regexPath = path
+            .replace(/\/:([^/]+)/g, (match, paramName) => {
+            paramNames.push(paramName);
+            return '/([^/]+)';
+        })
+            .replace(/\//g, '\\/');
+        return {
+            pattern: new RegExp(`^${regexPath}$`),
+            paramNames,
+            isStatic: false,
+            path,
+            segments,
+        };
+    }
+    /**
+     * Match a request path against a compiled pattern
+     * Returns match result with extracted parameters, or null if no match
+     */
+    static match(compiledPath, requestPath) {
+        // Path for static routes - simple string comparison
+        if (compiledPath.isStatic) {
+            return compiledPath.path === requestPath ? { params: {} } : null;
+        }
+        // Dynamic route - use regex matching
+        if (!compiledPath.pattern) {
+            return null;
+        }
+        const matches = requestPath.match(compiledPath.pattern);
+        if (!matches) {
+            return null;
+        }
+        // Extract parameters
+        const params = {};
+        compiledPath.paramNames.forEach((name, index) => {
+            params[name] = matches[index + 1];
+        });
+        return { params };
+    }
+    /**
+     * Compile and match in one operation (convenience method)
+     */
+    static compileAndMatch(pathPattern, requestPath) {
+        const compiled = this.compile(pathPattern);
+        return this.match(compiled, requestPath);
+    }
+    /**
+     * Check if a path pattern is static (no parameters)
+     */
+    static isStatic(path) {
+        return !path.includes(':') && !path.includes('*');
+    }
+    /**
+     * Get performance statistics
+     */
+    static getStats() {
+        const totalRequests = this.cacheHits + this.cacheMisses;
+        return {
+            cacheSize: this.cache.size,
+            cacheHits: this.cacheHits,
+            cacheMisses: this.cacheMisses,
+            hitRate: totalRequests > 0 ? this.cacheHits / totalRequests : 0,
+            compilationCount: this.compilationCount,
+        };
+    }
+    /**
+     * Clear the cache (useful for testing)
+     */
+    static clearCache() {
+        this.cache.clear();
+        this.cacheHits = 0;
+        this.cacheMisses = 0;
+    }
+    /**
+     * Pre-compile multiple paths (cache warming)
+     */
+    static precompile(paths) {
+        paths.forEach(path => this.compile(path));
+    }
+}
+/**
+ * Legacy compatibility function - maps to PathMatcher.compile
+ * @deprecated Use PathMatcher.compile instead
+ */
+export function pathToRegex(path) {
+    const compiled = PathMatcher.compile(path);
+    return {
+        pattern: compiled.pattern || new RegExp(`^${path.replace(/\//g, '\\/')}$`),
+        paramNames: compiled.paramNames,
+    };
+}
+//# sourceMappingURL=path-matcher.js.map

package/dist/core/routing/path-matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-matcher.js","sourceRoot":"","sources":["../../../src/core/routing/path-matcher.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,uEAAuE;AAcvE;;GAEG;AACH,MAAM,QAAQ;IACJ,KAAK,GAAG,IAAI,GAAG,EAAQ,CAAC;IACf,OAAO,CAAS;IAEjC,YAAY,UAAkB,IAAI;QAChC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,GAAG,CAAC,GAAM;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,mCAAmC;YACnC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,GAAG,CAAC,GAAM,EAAE,KAAQ;QAClB,wCAAwC;QACxC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;QAED,aAAa;QACb,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAE3B,gCAAgC;QAChC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAChD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IAED,GAAG,CAAC,GAAM;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,WAAW;IACd,MAAM,CAAU,KAAK,GAAG,IAAI,QAAQ,CAAuB,IAAI,CAAC,CAAC;IACjE,MAAM,CAAC,gBAAgB,GAAG,CAAC,CAAC;IAC5B,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC;IACrB,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC;IAE/B;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,IAAY;QACzB,oBAAoB;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAExB,sBAAsB;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC/B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,eAAe,CAAC,IAAY;QACzC,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAE5D,2CAA2C;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;QAElE,IAAI,QAAQ,EAAE,CAAC;YACb,oCAAoC;YACpC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,UAAU,EAAE,EAAE;gBACd,QAAQ,EAAE,IAAI;gBACd,IAAI;gBACJ,QAAQ;aACT,CAAC;QACJ,CAAC;QAED,wCAAwC;QACxC,kDAAkD;QAClD,MAAM,SAAS,GAAG,IAAI;aACnB,OAAO,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE;YAC3C,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC3B,OAAO,UAAU,CAAC;QACpB,CAAC,CAAC;aACD,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAEzB,OAAO;YACL,OAAO,EAAE,IAAI,MAAM,CAAC,IAAI,SAAS,GAAG,CAAC;YACrC,UAAU;YACV,QAAQ,EAAE,KAAK;YACf,IAAI;YACJ,QAAQ;SACT,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,YAA0B,EAAE,WAAmB;QAC1D,oDAAoD;QACpD,IAAI,YAAY,CAAC,QAAQ,EAAE,CAAC;YAC1B,OAAO,YAAY,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACnE,CAAC;QAED,qCAAqC;QACrC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,IAAI,CAAC;QACd,CAAC;QAED,qBAAqB;QACrB,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YAC9C,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,OAAO,EAAE,MAAM,EAAE,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,WAAmB,EAAE,WAAmB;QAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAY;QAC1B,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ;QACb,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC;QACxD,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;YAC1B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;YAC/D,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;SACxC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAU;QACf,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,KAAe;QAC/B,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5C,CAAC;;AAGH;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,OAAO;QACL,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,IAAI,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC;QAC1E,UAAU,EAAE,QAAQ,CAAC,UAAU;KAChC,CAAC;AACJ,CAAC"}

package/dist/core/routing/router.d.ts

@@ -0,0 +1,38 @@
+import { HttpRequest, HttpResponse, HttpHandler, Middleware, RouteDefinition } from '../../types/http.js';
+export declare class Router {
+    private logger;
+    private unifiedRouter;
+    private routes;
+    get(path: string, ...handlers: (Middleware | HttpHandler)[]): void;
+    post(path: string, ...handlers: (Middleware | HttpHandler)[]): void;
+    put(path: string, ...handlers: (Middleware | HttpHandler)[]): void;
+    delete(path: string, ...handlers: (Middleware | HttpHandler)[]): void;
+    patch(path: string, ...handlers: (Middleware | HttpHandler)[]): void;
+    private addRoute;
+    handle(req: HttpRequest, res: HttpResponse, basePath?: string): Promise<boolean>;
+    getRoutes(): RouteDefinition[];
+    getPerformanceStats(): {
+        poolManager: {
+            routeCacheHitRate: number;
+            responseCacheHitRate: number;
+            paramPoolUtilization: number;
+            totalMemoryKB: number;
+        };
+        pathMatcher: {
+            cacheSize: number;
+            cacheHits: number;
+            cacheMisses: number;
+            hitRate: number;
+            compilationCount: number;
+        };
+        totalRoutes: number;
+        staticRoutes: number;
+        dynamicRoutes: number;
+        fastPathRoutes: number;
+        requestCount: number;
+        fastPathHits: number;
+        staticHits: number;
+        dynamicHits: number;
+        cacheHits: number;
+    };
+}

package/dist/core/routing/router.js

@@ -0,0 +1,68 @@
+import { createFrameworkLogger } from '../logger/index.js';
+import { UnifiedRouter } from './unified-router.js';
+export class Router {
+    logger = createFrameworkLogger('Router');
+    // Delegate to shared UnifiedRouter singleton for actual routing
+    unifiedRouter = UnifiedRouter.getInstance();
+    // Maintain route definitions for backward compatibility (getRoutes())
+    routes = [];
+    get(path, ...handlers) {
+        this.addRoute('GET', path, handlers);
+    }
+    post(path, ...handlers) {
+        this.addRoute('POST', path, handlers);
+    }
+    put(path, ...handlers) {
+        this.addRoute('PUT', path, handlers);
+    }
+    delete(path, ...handlers) {
+        this.addRoute('DELETE', path, handlers);
+    }
+    patch(path, ...handlers) {
+        this.addRoute('PATCH', path, handlers);
+    }
+    addRoute(method, path, handlers) {
+        const handler = handlers.pop();
+        const middleware = handlers;
+        // Delegate to UnifiedRouter for actual routing
+        this.unifiedRouter.addRoute(method, path, handler, middleware);
+        // Keep route definition for backward compatibility (getRoutes())
+        const route = {
+            method,
+            path,
+            pattern: new RegExp(''), // Not used since we delegate
+            paramNames: [],
+            handler,
+            middleware,
+        };
+        this.routes.push(route);
+        this.logger.debug(`Delegated route to UnifiedRouter: ${method} ${path}`, 'Facade');
+    }
+    async handle(req, res, basePath = '') {
+        // Adjust path for basePath
+        let path = req.path.startsWith(basePath) ? req.path.substring(basePath.length) : req.path;
+        if (path === '' || path === undefined) {
+            path = '/';
+        }
+        this.logger.debug(`Router delegating to UnifiedRouter: originalPath="${req.path}", basePath="${basePath}", processedPath="${path}"`, 'Facade');
+        // Temporarily adjust request path for processing
+        const originalPath = req.path;
+        req.path = path;
+        try {
+            // Delegate to UnifiedRouter for actual routing
+            return await this.unifiedRouter.handleRequest(req, res);
+        }
+        finally {
+            // Restore original path
+            req.path = originalPath;
+        }
+    }
+    getRoutes() {
+        return [...this.routes];
+    }
+    // Performance statistics for monitoring (delegates to UnifiedRouter)
+    getPerformanceStats() {
+        return this.unifiedRouter.getStats();
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/core/routing/router.js.map

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

package/dist/core/routing/unified-router.d.ts

@@ -0,0 +1,148 @@
+import { HttpRequest, HttpResponse } from '../../types/http.js';
+import { ValidationSchema } from '../validation/schema-interface.js';
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';
+export type RouteHandler<T = any> = (req: HttpRequest, res: HttpResponse) => T | Promise<T>;
+export type Middleware = (req: HttpRequest, res: HttpResponse, next: () => void) => void | Promise<void>;
+export interface ValidationConfig {
+    body?: ValidationSchema;
+    query?: ValidationSchema;
+    params?: ValidationSchema;
+    headers?: ValidationSchema;
+}
+export interface AuthConfig {
+    roles?: string[];
+    permissions?: string[];
+    optional?: boolean;
+}
+export interface RateLimitConfig {
+    requests: number;
+    window: number;
+    skipSuccessfulRequests?: boolean;
+}
+export interface CacheConfig {
+    ttl: number;
+    key?: string;
+    tags?: string[];
+}
+export interface MiddlewarePhases {
+    before?: Middleware[];
+    after?: Middleware[];
+    transform?: Middleware[];
+}
+export interface RouteSchema {
+    method: HttpMethod;
+    path: string;
+    handler: RouteHandler;
+    validation?: ValidationConfig;
+    auth?: AuthConfig;
+    rateLimit?: RateLimitConfig;
+    cache?: CacheConfig;
+    middleware?: MiddlewarePhases | Middleware[];
+    description?: string;
+    tags?: string[];
+}
+export declare class RouteBuilder {
+    private schema;
+    private router;
+    constructor(method: HttpMethod, path: string, router: UnifiedRouter);
+    validate(config: ValidationConfig): this;
+    body<T>(schema: ValidationSchema<T>): this;
+    query<T>(schema: ValidationSchema<T>): this;
+    params<T>(schema: ValidationSchema<T>): this;
+    headers<T>(schema: ValidationSchema<T>): this;
+    auth(config: AuthConfig): this;
+    rateLimit(config: RateLimitConfig): this;
+    cache(config: CacheConfig): this;
+    before(...middleware: Middleware[]): this;
+    after(...middleware: Middleware[]): this;
+    transform(...middleware: Middleware[]): this;
+    use(...middleware: Middleware[]): this;
+    describe(description: string): this;
+    tag(...tags: string[]): this;
+    handler<T>(handler: RouteHandler<T>): void;
+}
+export declare class UnifiedRouter {
+    private static instance;
+    private readonly poolManager;
+    private staticRoutes;
+    private dynamicRoutesBySegments;
+    private fastPathRoutes;
+    private allRoutes;
+    private stats;
+    constructor();
+    /**
+     * Get singleton instance (optional - can still create new instances)
+     */
+    static getInstance(): UnifiedRouter;
+    /**
+     * Reset singleton (useful for testing)
+     */
+    static reset(): void;
+    /**
+     * Clear all routes (useful for testing)
+     */
+    clearAllRoutes(): void;
+    /**
+     * Register a route (internal method)
+     */
+    registerRoute(schema: RouteSchema): void;
+    /**
+     * Chainable API methods
+     */
+    get(path: string): RouteBuilder;
+    post(path: string): RouteBuilder;
+    put(path: string): RouteBuilder;
+    delete(path: string): RouteBuilder;
+    patch(path: string): RouteBuilder;
+    head(path: string): RouteBuilder;
+    options(path: string): RouteBuilder;
+    /**
+     * Schema-first route registration
+     */
+    route(schema: RouteSchema): void;
+    /**
+     * Direct API (for backward compatibility)
+     */
+    addRoute(method: HttpMethod, path: string, handler: RouteHandler, middleware?: Middleware[]): void;
+    /**
+     * Find a matching route for the request
+     * Returns boolean (sync) for fast-path routes, Promise<boolean> for others
+     */
+    handleRequest(req: HttpRequest, res: HttpResponse): Promise<boolean> | boolean;
+    private executeRoute;
+    private executePhase;
+    private executeMiddleware;
+    private executeRateLimit;
+    private executeAuth;
+    private executeValidation;
+    private executeCache;
+    private isFastPathRoute;
+    private buildExecutionOrder;
+    getAllRoutes(): RouteSchema[];
+    getRouteCount(): number;
+    getStats(): {
+        poolManager: {
+            routeCacheHitRate: number;
+            responseCacheHitRate: number;
+            paramPoolUtilization: number;
+            totalMemoryKB: number;
+        };
+        pathMatcher: {
+            cacheSize: number;
+            cacheHits: number;
+            cacheMisses: number;
+            hitRate: number;
+            compilationCount: number;
+        };
+        totalRoutes: number;
+        staticRoutes: number;
+        dynamicRoutes: number;
+        fastPathRoutes: number;
+        requestCount: number;
+        fastPathHits: number;
+        staticHits: number;
+        dynamicHits: number;
+        cacheHits: number;
+    };
+    logPerformanceStats(): void;
+}