qhttpx 2.1.0 → 2.3.1

package/dist/src/core/server.js

@@ -1,1511 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.QHTTPX = exports.QHTTPXContextImpl = void 0;
-const http_1 = __importDefault(require("http"));
-const path_1 = __importDefault(require("path"));
-const url_1 = require("url");
-const querystring_1 = require("querystring");
-const package_json_1 = __importDefault(require("../../package.json"));
-const router_1 = require("../router/router");
-const scheduler_1 = require("./scheduler");
-const tasks_1 = require("./tasks");
-const resources_1 = require("./resources");
-const metrics_1 = require("./metrics");
-const body_parser_1 = require("./body-parser");
-const buffer_pool_1 = require("./buffer-pool");
-const websocket_1 = require("./websocket");
-const serializer_1 = require("./serializer");
-const batch_1 = require("./batch");
-const fusion_1 = require("./fusion");
-const simple_1 = require("../validation/simple");
-const zod_1 = require("../validation/zod");
-const generator_1 = require("../openapi/generator");
-const cors_1 = require("../middleware/cors");
-const rate_limit_1 = require("../middleware/rate-limit");
-const logger_1 = require("../utils/logger");
-const security_1 = require("../middleware/security");
-const compression_1 = require("../middleware/compression");
-const types_1 = require("./types");
-const cookies_1 = require("../utils/cookies");
-const context_pool_1 = require("./context-pool");
-const scope_1 = require("./scope");
-const logger_2 = require("./logger");
-const timer_1 = require("./timer");
-const serializer_2 = require("./serializer");
-const EMPTY_QUERY = Object.freeze({});
-const CONTENT_TYPE = {
-    JSON: 'application/json; charset=utf-8',
-    HTML: 'text/html; charset=utf-8',
-    PLAIN: 'text/plain; charset=utf-8',
-};
-class QHTTPXContextImpl {
-    get params() { return this._params; }
-    set params(v) { this._params = v; this._dirty |= 0b0010; }
-    get body() { return this._body; }
-    set body(v) { this._body = v; this._dirty |= 0b0001; }
-    get files() { return this._files; }
-    set files(v) { this._files = v; this._dirty |= 0b10000; }
-    // Ultra-Simple API
-    httpError(status, message, details) {
-        return new types_1.HttpError(status, message, { details });
-    }
-    constructor(app) {
-        this._url = null;
-        // Dirty tracking for optimization
-        this._generation = 0;
-        this._dirty = 0;
-        this._customHeaders = null;
-        this._app = app;
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        this._appJsonSerializer = app.options.jsonSerializer;
-        this.json = this.json.bind(this);
-        this.send = this.send.bind(this);
-        this.html = this.html.bind(this);
-        this.redirect = this.redirect.bind(this);
-        this.setCookie = this.setCookie.bind(this);
-        this.render = this.render.bind(this);
-        this.validate = this.validate.bind(this);
-        this.httpError = this.httpError.bind(this);
-    }
-    get cookies() {
-        if (this._dirty & 0b1000)
-            return this._cookies;
-        if (!this._cookies)
-            this._cookies = Object.create(null);
-        const header = this.req.headers.cookie;
-        if (header) {
-            this._parseCookies(header);
-        }
-        this._dirty |= 0b1000;
-        return this._cookies;
-    }
-    set cookies(v) {
-        this._cookies = v;
-        this._dirty |= 0b1000;
-    }
-    get query() {
-        if (this._dirty & 0b0100)
-            return this._query;
-        const url = this.req.url || '/';
-        const queryIndex = url.indexOf('?');
-        if (queryIndex !== -1) {
-            const queryString = url.slice(queryIndex + 1);
-            if (queryString.length > 0) {
-                this._parseQuery(queryString);
-            }
-            else {
-                if (!this._query)
-                    this._query = Object.create(null);
-            }
-        }
-        else {
-            if (!this._query)
-                this._query = Object.create(null);
-        }
-        this._dirty |= 0b0100;
-        return this._query;
-    }
-    set query(v) {
-        this._query = v;
-        this._dirty |= 0b0100;
-    }
-    _parseQuery(queryString) {
-        if (!this._query)
-            this._query = Object.create(null);
-        const query = this._query;
-        let i = 0;
-        const len = queryString.length;
-        while (i < len) {
-            let keyStart = i;
-            let keyEnd = -1;
-            let valStart = -1;
-            let valEnd = -1;
-            // Find key
-            while (i < len) {
-                const c = queryString.charCodeAt(i);
-                if (c === 61) { // =
-                    keyEnd = i;
-                    valStart = i + 1;
-                    i++;
-                    break;
-                }
-                if (c === 38) { // &
-                    keyEnd = i;
-                    valEnd = i; // empty value
-                    i++;
-                    break;
-                }
-                i++;
-            }
-            if (keyEnd === -1) {
-                keyEnd = i;
-                valEnd = i; // empty value
-            }
-            // Find value
-            if (valStart !== -1) {
-                while (i < len) {
-                    if (queryString.charCodeAt(i) === 38) { // &
-                        valEnd = i;
-                        i++;
-                        break;
-                    }
-                    i++;
-                }
-                if (valEnd === -1)
-                    valEnd = i;
-            }
-            const key = decodeURIComponent(queryString.slice(keyStart, keyEnd));
-            const val = valStart !== -1 ? decodeURIComponent(queryString.slice(valStart, valEnd)) : '';
-            if (query[key] === undefined) {
-                query[key] = val;
-            }
-            else if (Array.isArray(query[key])) {
-                query[key].push(val);
-            }
-            else {
-                query[key] = [query[key], val];
-            }
-        }
-    }
-    _parseCookies(header) {
-        const list = this._cookies;
-        let start = 0;
-        let end = header.length;
-        // Inline cookie parsing for speed
-        while (start < end) {
-            let eqIdx = header.indexOf('=', start);
-            if (eqIdx === -1)
-                break;
-            let semiIdx = header.indexOf(';', start);
-            if (semiIdx === -1)
-                semiIdx = end;
-            if (eqIdx < semiIdx) {
-                const key = header.slice(start, eqIdx).trim();
-                let val = header.slice(eqIdx + 1, semiIdx).trim();
-                // Decode if needed, simple check first
-                if (val.indexOf('%') !== -1) {
-                    try {
-                        val = decodeURIComponent(val);
-                    }
-                    catch { /* ignore */ }
-                }
-                if (!list[key]) {
-                    list[key] = val;
-                }
-            }
-            start = semiIdx + 1;
-        }
-    }
-    get bufferPool() {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        return this._app.bufferPool;
-    }
-    get db() {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        return this._app.options.database;
-    }
-    get state() {
-        if (!this._state) {
-            this._state = {};
-            this._dirty |= 0b100000;
-        }
-        return this._state;
-    }
-    set state(v) {
-        this._state = v;
-        this._dirty |= 0b100000;
-    }
-    get ip() {
-        if (this._ip)
-            return this._ip;
-        this._ip = this.req.socket.remoteAddress || '';
-        return this._ip;
-    }
-    // Setter for manual override if needed (though usually read-only from socket)
-    set ip(v) {
-        this._ip = v;
-    }
-    get url() {
-        if (this._url)
-            return this._url;
-        const host = this.headers.host || 'localhost';
-        this._url = new url_1.URL(this.req.url || '/', `http://${host}`);
-        return this._url;
-    }
-    set url(v) {
-        this._url = v;
-    }
-    json(payload, status = 200) {
-        const res = this.res;
-        let body;
-        if (this.serializer) {
-            body = this.serializer(payload);
-        }
-        else if (this._appJsonSerializer) {
-            body = this._appJsonSerializer(payload);
-        }
-        else {
-            // Use optimized fast path serializer
-            body = (0, serializer_2.fastJsonStringify)(payload);
-        }
-        if (!res.headersSent) {
-            res.statusCode = status;
-            res.setHeader('content-type', CONTENT_TYPE.JSON);
-        }
-        res.end(body);
-    }
-    send(payload, status = 200) {
-        const res = this.res;
-        if (!res.headersSent) {
-            res.statusCode = status;
-        }
-        res.end(payload);
-    }
-    html(payload, status = 200) {
-        const res = this.res;
-        if (!res.headersSent) {
-            res.statusCode = status;
-            res.setHeader('content-type', CONTENT_TYPE.HTML);
-        }
-        res.end(payload);
-    }
-    redirect(url, status = 302) {
-        const res = this.res;
-        if (!res.headersSent) {
-            res.statusCode = status;
-            res.setHeader('Location', url);
-        }
-        res.end();
-    }
-    setCookie(name, value, options) {
-        const res = this.res;
-        const serialized = (0, cookies_1.serializeCookie)(name, value, options);
-        let existing = res.getHeader('Set-Cookie');
-        if (Array.isArray(existing)) {
-            existing.push(serialized);
-            res.setHeader('Set-Cookie', existing);
-        }
-        else if (existing) {
-            res.setHeader('Set-Cookie', [existing, serialized]);
-        }
-        else {
-            res.setHeader('Set-Cookie', serialized);
-        }
-    }
-    async render(view, locals) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const engine = this._app.options.viewEngine;
-        if (!engine) {
-            throw new Error('No view engine registered');
-        }
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const viewsPath = this._app.options.viewsPath || process.cwd();
-        const fullPath = path_1.default.resolve(viewsPath, view);
-        const html = await engine.render(fullPath, locals || {});
-        const res = this.res;
-        if (!res.headersSent) {
-            res.statusCode = 200;
-            res.setHeader('content-type', CONTENT_TYPE.HTML);
-        }
-        res.end(html);
-    }
-    async validate(schema, data) {
-        const target = data ?? this.body;
-        const result = await this._app.validator.validate(schema, target);
-        if (result.success) {
-            return result.data;
-        }
-        throw new types_1.HttpError(400, 'Validation Error', {
-            code: 'VALIDATION_ERROR',
-            details: result.error,
-        });
-    }
-    reset() {
-        // Tiered reset based on what was actually used
-        if (this._dirty & 0b0001)
-            this._body = undefined;
-        if (this._dirty & 0b0010)
-            this._params = null;
-        // Recycle query object
-        if (this._dirty & 0b0100) {
-            if (this._query) {
-                for (const key in this._query)
-                    delete this._query[key];
-            }
-        }
-        // Recycle cookies object
-        if (this._dirty & 0b1000) {
-            if (this._cookies) {
-                for (const key in this._cookies)
-                    delete this._cookies[key];
-            }
-        }
-        if (this._dirty & 0b10000)
-            this._files = undefined;
-        if (this._dirty & 0b100000)
-            this._state = undefined;
-        this._dirty = 0;
-        this.req = null;
-        this.res = null;
-        this.headers = null;
-        this._url = null;
-        this.method = null;
-        this._ip = undefined;
-        this.requestId = undefined;
-        this.requestStart = undefined;
-        this.serializer = undefined;
-        this.path = '';
-        this.disableAutoEnd = false;
-        this.error = undefined;
-        this.next = undefined;
-    }
-}
-exports.QHTTPXContextImpl = QHTTPXContextImpl;
-class QHTTPX {
-    constructor(options = {}) {
-        this.middlewares = [];
-        this.pipelineRunner = null;
-        this.onStartHooks = [];
-        this.onBeforeShutdownHooks = [];
-        this.onShutdownHooks = [];
-        this.nextRequestId = 1;
-        this.lastDateNow = Date.now();
-        this.lastDateString = this.lastDateNow.toString(36);
-        this.requestCounter = 0;
-        this.options = options;
-        this.logger = new logger_2.Logger({
-            name: options.name,
-            level: 'info'
-        });
-        this.errorHandler = options.errorHandler;
-        this.notFoundHandler = options.notFoundHandler;
-        this.methodNotAllowedHandler = options.methodNotAllowedHandler;
-        this.tracer = options.tracer;
-        this.workerCount = (0, resources_1.calculateWorkerCount)(options.workers ?? 'auto');
-        this.router = new router_1.Router();
-        this.wsManager = new websocket_1.WebSocketManager(this.generateRequestId.bind(this));
-        this.bufferPool = new buffer_pool_1.BufferPool(options.bufferPoolConfig);
-        const maxConcurrency = options.maxConcurrency ?? 1024;
-        this.poolLimit = maxConcurrency * 2;
-        this.scheduler = new scheduler_1.Scheduler({
-            maxConcurrency,
-        });
-        this.tasks = new tasks_1.TaskEngine(this.scheduler);
-        if (options.enableBatching) {
-            this.batchExecutor = new batch_1.BatchExecutor(options.database);
-        }
-        if (options.enableRequestFusion) {
-            this._fusion = new fusion_1.RequestFusion(options.enableRequestFusion);
-        }
-        this.validator = options.validator ?? new simple_1.SimpleValidator();
-        this._metrics = new metrics_1.Metrics(this.scheduler, {
-            enabled: this.options.metricsEnabled ?? true,
-        }, this.tasks, this._fusion);
-        this.contextPool = new context_pool_1.ContextPool(() => this.createContext(), (ctx) => ctx.reset(), maxConcurrency, this.poolLimit);
-        this.registerInternalRoutes();
-        this.compileMiddlewarePipeline();
-        this.server = http_1.default.createServer(this.handleRequest.bind(this));
-        if (this.options.keepAliveTimeoutMs !== undefined) {
-            this.server.keepAliveTimeout = this.options.keepAliveTimeoutMs;
-        }
-        if (this.options.headersTimeoutMs !== undefined) {
-            this.server.headersTimeout = this.options.headersTimeoutMs;
-        }
-        // Keep-alive and timeout settings handled by options above
-        this.server.on('upgrade', (req, socket, head) => {
-            void this.handleUpgrade(req, socket, head);
-        });
-    }
-    get serverInstance() {
-        return this.server;
-    }
-    get websocket() {
-        return this.wsManager;
-    }
-    setErrorHandler(handler) {
-        this.errorHandler = handler;
-    }
-    setNotFoundHandler(handler) {
-        this.notFoundHandler = handler;
-    }
-    setMethodNotAllowedHandler(handler) {
-        this.methodNotAllowedHandler = handler;
-    }
-    set404Handler(handler) {
-        this.setNotFoundHandler(handler);
-    }
-    set405Handler(handler) {
-        this.setMethodNotAllowedHandler(handler);
-    }
-    /**
-     * Alias for setErrorHandler
-     */
-    onError(handler) {
-        this.setErrorHandler(handler);
-    }
-    /**
-     * Alias for setNotFoundHandler
-     */
-    notFound(handler) {
-        this.setNotFoundHandler(handler);
-    }
-    onStart(hook) {
-        this.onStartHooks.push(hook);
-    }
-    onBeforeShutdown(hook) {
-        this.onBeforeShutdownHooks.push(hook);
-    }
-    onShutdown(hook) {
-        this.onShutdownHooks.push(hook);
-    }
-    upgrade(path, handler) {
-        this.wsManager.register(path, handler);
-    }
-    use(middleware) {
-        this.middlewares.push(middleware);
-        // Recompile pipeline after middleware is added
-        this.compileMiddlewarePipeline();
-    }
-    compileMiddlewarePipeline() {
-        const middlewares = this.middlewares;
-        let runner;
-        if (middlewares.length === 0) {
-            runner = async (ctx, handler) => {
-                const result = handler(ctx);
-                // Handle return values
-                if (result instanceof Promise) {
-                    const val = await result;
-                    if (val !== undefined && !ctx.res.headersSent) {
-                        if (ctx.method === 'POST' && ctx.res.statusCode === 200)
-                            ctx.res.statusCode = 201;
-                        if (typeof val === 'object')
-                            ctx.json(val);
-                        else
-                            ctx.send(String(val));
-                    }
-                }
-                else if (result !== undefined && !ctx.res.headersSent) {
-                    if (ctx.method === 'POST' && ctx.res.statusCode === 200)
-                        ctx.res.statusCode = 201;
-                    if (typeof result === 'object')
-                        ctx.json(result);
-                    else
-                        ctx.send(String(result));
-                }
-            };
-        }
-        else {
-            // Flatten middleware pipeline into a single function chain
-            // This eliminates Promise nesting, recursive dispatch overhead, and microtask backlogs
-            // Each middleware executes directly without closure allocation overhead
-            runner = async (ctx, handler) => {
-                let index = 0;
-                const executeNext = async () => {
-                    if (index >= middlewares.length) {
-                        // All middlewares done, execute handler
-                        const result = handler(ctx);
-                        // Handle return values (Auto-Response)
-                        if (result instanceof Promise) {
-                            const val = await result;
-                            if (val !== undefined && !ctx.res.headersSent) {
-                                if (typeof val === 'object')
-                                    ctx.json(val);
-                                else
-                                    ctx.send(String(val));
-                            }
-                        }
-                        else if (result !== undefined && !ctx.res.headersSent) {
-                            if (typeof result === 'object')
-                                ctx.json(result);
-                            else
-                                ctx.send(String(result));
-                        }
-                        return;
-                    }
-                    const currentIndex = index;
-                    index += 1;
-                    ctx.next = executeNext;
-                    const result = middlewares[currentIndex](ctx, executeNext);
-                    if (result && typeof result.then === 'function') {
-                        await result;
-                    }
-                };
-                await executeNext();
-            };
-        }
-        if (this._fusion) {
-            // Deprecated: Global fusion wrapping moved to per-route compilation
-            // to ensure body parsing and middleware execution happens before key generation.
-            // this.pipelineRunner = async (ctx, handler) => {
-            //    await this._fusion!.coalesce(ctx, async (c) => {
-            //        await runner(c, handler);
-            //    });
-            // };
-            this.pipelineRunner = runner;
-        }
-        else {
-            this.pipelineRunner = runner;
-        }
-    }
-    compileRoutePipeline(handler, 
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    schema) {
-        const middlewares = this.middlewares;
-        // Optimization: If no middleware and no schema and no fusion, return handler directly
-        // This avoids wrapping for simple routes
-        if (middlewares.length === 0 && !schema && !this._fusion) {
-            return handler;
-        }
-        // Heuristic: Is it a structured RouteSchema or a legacy ResponseSchema?
-        let responseSchema;
-        let requestSchema;
-        if (schema) {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            const s = schema;
-            if (s.body || s.query || s.params || s.headers || s.response) {
-                // It is a RouteSchema
-                requestSchema = s;
-                responseSchema = s.response;
-            }
-            else {
-                // It is a legacy ResponseSchema
-                responseSchema = s;
-            }
-        }
-        const stringifier = responseSchema ? (0, serializer_1.getStringifier)(responseSchema) : undefined;
-        // Build middleware chain
-        let pipeline = handler;
-        // Wrap with validation if needed (before handler, after global middleware)
-        if (requestSchema) {
-            const inner = pipeline;
-            pipeline = async (ctx) => {
-                // Validate Body
-                if (requestSchema.body) {
-                    const result = await this.validator.validate(requestSchema.body, ctx.body);
-                    if (!result.success) {
-                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                        const err = result.error;
-                        ctx.json({ error: 'Validation Error', details: err.details || err.message || err }, 400);
-                        return;
-                    }
-                    ctx.body = result.data;
-                }
-                // Validate Query
-                if (requestSchema.query) {
-                    const result = await this.validator.validate(requestSchema.query, ctx.query);
-                    if (!result.success) {
-                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                        const err = result.error;
-                        ctx.json({ error: 'Validation Error', details: err.details || err.message || err }, 400);
-                        return;
-                    }
-                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                    ctx.query = result.data;
-                }
-                // Validate Params
-                if (requestSchema.params) {
-                    const result = await this.validator.validate(requestSchema.params, ctx.params);
-                    if (!result.success) {
-                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                        const err = result.error;
-                        ctx.json({ error: 'Validation Error', details: err.details || err.message || err }, 400);
-                        return;
-                    }
-                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                    ctx.params = result.data;
-                }
-                return inner(ctx);
-            };
-        }
-        // Wrap with Request Fusion if enabled
-        if (this._fusion) {
-            const inner = pipeline;
-            pipeline = (ctx) => this._fusion.coalesce(ctx, inner);
-        }
-        // Optimization: Pre-compile middleware chain for this specific route
-        // This avoids closure allocation per-request and recursive dispatch overhead
-        // "Route-Specific Middleware Compilation"
-        if (middlewares.length > 0) {
-            const innerHandler = pipeline;
-            pipeline = async (ctx) => {
-                let index = 0;
-                const executeNext = async () => {
-                    if (index >= middlewares.length) {
-                        // All middlewares done, execute handler
-                        const result = innerHandler(ctx);
-                        if (result && typeof result.then === 'function') {
-                            await result;
-                        }
-                        return;
-                    }
-                    const currentIndex = index;
-                    index += 1;
-                    ctx.next = executeNext;
-                    const result = middlewares[currentIndex](ctx, executeNext);
-                    if (result && typeof result.then === 'function') {
-                        await result;
-                    }
-                };
-                await executeNext();
-            };
-        }
-        if (stringifier) {
-            const inner = pipeline;
-            return (ctx) => {
-                ctx.serializer = stringifier;
-                return inner(ctx);
-            };
-        }
-        return pipeline;
-    }
-    // Internal registration to be accessed by Scopes
-    _registerRoute(method, path, handlerOrOptions, handlerIfOptions) {
-        this.registerRoute(method, path, handlerOrOptions, handlerIfOptions);
-    }
-    async register(plugin, options) {
-        const scope = new scope_1.QHTTPXScope(this, options?.prefix);
-        await plugin(scope, options);
-    }
-    registerRoute(method, path, handlerOrOptions, handlerIfOptions) {
-        let handler;
-        let schema;
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        let staticResponse;
-        const options = {};
-        if (typeof handlerOrOptions === 'function') {
-            handler = handlerOrOptions;
-        }
-        else if (handlerIfOptions) {
-            handler = handlerIfOptions;
-            const config = handlerOrOptions;
-            // Extract schema from flattened options or use explicit schema
-            if (config.schema) {
-                schema = config.schema;
-            }
-            else if (config.body || config.params || config.query || config.headers || config.response) {
-                schema = {
-                    body: config.body,
-                    params: config.params,
-                    query: config.query,
-                    headers: config.headers,
-                    response: config.response
-                };
-            }
-            options.priority = config.priority;
-            staticResponse = config.staticResponse;
-        }
-        else {
-            const opts = handlerOrOptions;
-            if (opts.handler) {
-                handler = opts.handler;
-            }
-            else {
-                throw new Error(`Handler is required for route ${method} ${path}`);
-            }
-            // Extract schema from flattened options or use explicit schema
-            if (opts.schema) {
-                schema = opts.schema;
-            }
-            else if (opts.body || opts.params || opts.query || opts.headers || opts.response) {
-                schema = {
-                    body: opts.body,
-                    params: opts.params,
-                    query: opts.query,
-                    headers: opts.headers,
-                    response: opts.response
-                };
-            }
-            options.priority = opts.priority;
-            staticResponse = opts.staticResponse;
-        }
-        // Nuclear Optimization: Static Response Pre-building
-        if (staticResponse !== undefined) {
-            const jsonStr = JSON.stringify(staticResponse);
-            const buffer = Buffer.from(jsonStr);
-            const length = buffer.length;
-            // Replace handler with optimized one that bypasses serialization
-            handler = (ctx) => {
-                ctx.res.writeHead(200, {
-                    'Content-Type': 'application/json',
-                    'Content-Length': String(length),
-                });
-                ctx.res.end(buffer);
-            };
-        }
-        const compiled = this.compileRoutePipeline(handler, schema);
-        // Pass the compiled pipeline as metadata to the router
-        // This allows match results to contain the full execution chain directly
-        // The router will still perform matching based on path, but the resulting
-        // RouteMatch will have this pipeline readily available
-        options.metadata = {
-            needsQuery: false, // Calculated by Router.detectMetadata if not provided
-            needsCookies: false,
-            needsBody: false,
-            pipeline: compiled
-        };
-        this.router.register(method, path, compiled, { ...options, schema });
-    }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    get(path, arg1, arg2) {
-        this.registerRoute('GET', path, arg1, arg2);
-    }
-    post(path, handlerOrOptions, handlerOrConfig) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        this.registerRoute('POST', path, handlerOrOptions, handlerOrConfig);
-    }
-    put(path, handlerOrOptions, handlerOrConfig) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        this.registerRoute('PUT', path, handlerOrOptions, handlerOrConfig);
-    }
-    delete(path, handlerOrOptions, handlerOrConfig) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        this.registerRoute('DELETE', path, handlerOrOptions, handlerOrConfig);
-    }
-    patch(path, handlerOrOptions, handlerOrConfig) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        this.registerRoute('PATCH', path, handlerOrOptions, handlerOrConfig);
-    }
-    route(path) {
-        const register = (method, handler) => {
-            this.registerRoute(method, path, handler);
-        };
-        const builder = {
-            get(handler) {
-                register('GET', handler);
-                return this;
-            },
-            post(handler) {
-                register('POST', handler);
-                return this;
-            },
-            put(handler) {
-                register('PUT', handler);
-                return this;
-            },
-            delete(handler) {
-                register('DELETE', handler);
-                return this;
-            },
-        };
-        return builder;
-    }
-    task(name, handler, options) {
-        this.tasks.register(name, handler, options);
-    }
-    enqueue(name, payload) {
-        return this.tasks.enqueue(name, payload);
-    }
-    op(name, handler) {
-        if (!this.batchExecutor) {
-            // Auto-enable batch executor if op is called?
-            // Or throw?
-            // Better to throw or warn if not enabled.
-            // But for ease of use, let's create it if missing (but we miss DB context if done this way without options)
-            // The constructor handles options. If enableBatching is false, we shouldn't be here.
-            throw new Error('Batching is not enabled. Pass enableBatching: true to QHTTPX options.');
-        }
-        this.batchExecutor.register(name, handler);
-    }
-    registerInternalRoutes() {
-        this.router.register('GET', '/__qhttpx/health', ({ json }) => {
-            const version = typeof package_json_1.default.version === 'string' ? package_json_1.default.version : '';
-            const name = typeof package_json_1.default.name === 'string' ? package_json_1.default.name : '';
-            json({
-                status: 'ok',
-                name,
-                version,
-                workers: this.workerCount,
-            });
-        });
-        this.router.register('GET', '/__qhttpx/metrics', ({ json }) => {
-            const snapshot = this._metrics.snapshot();
-            json({
-                ...snapshot,
-                workers: this.workerCount,
-            });
-        });
-        this.router.register('GET', '/__qhttpx/runtime', ({ json }) => {
-            const schedulerStats = this.scheduler.getStats();
-            json({
-                workers: this.workerCount,
-                router: {
-                    frozen: this.router.isFrozenRouter(),
-                },
-                scheduler: schedulerStats,
-            });
-        });
-        if (this.options.enableBatching && this.batchExecutor) {
-            const endpoint = typeof this.options.enableBatching === 'object'
-                ? this.options.enableBatching.endpoint
-                : '/qhttpx';
-            this.router.register('POST', endpoint, async (ctx) => {
-                // Keep full ctx here as we pass it to handleBatch
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                const body = ctx.body;
-                if (!body || !Array.isArray(body.batch)) {
-                    ctx.json({ error: 'Invalid batch format' }, 400);
-                    return;
-                }
-                try {
-                    const result = await this.batchExecutor.handleBatch(ctx, body.batch);
-                    ctx.json(result);
-                }
-                catch (err) {
-                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                    ctx.json({ error: err.message }, 500);
-                }
-            });
-        }
-    }
-    // Sugar Methods for Fluent API
-    database(manager) {
-        this.options.database = manager;
-        // Auto-connect?
-        // manager.connect() is async.
-        // We can't await here.
-        // Maybe we queue it?
-        // But QHTTPX doesn't have a queue for DB connection.
-        // The user might need to await app.start().
-        // We can hook into onStart.
-        this.onStart(async () => {
-            await manager.connect();
-        });
-        return this;
-    }
-    security(options) {
-        // 1. CORS
-        let corsOpts = options?.cors;
-        if (corsOpts === undefined)
-            corsOpts = true;
-        if (corsOpts !== false) {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            const opts = corsOpts === true ? {} : corsOpts;
-            this.use((0, cors_1.createCorsMiddleware)(opts));
-        }
-        // 2. Security Headers
-        this.use((0, security_1.createSecurityHeadersMiddleware)(options?.securityHeaders));
-        // 3. Rate Limit (Default 100 req/15min)
-        const rateLimitOpts = options?.rateLimit || {};
-        this.use((0, rate_limit_1.rateLimit)({
-            windowMs: 15 * 60 * 1000,
-            max: 100,
-            ...rateLimitOpts
-        }));
-        return this;
-    }
-    log(options) {
-        const loggerOptions = typeof options === 'object' ? options : {};
-        this.use((0, logger_1.createLoggerMiddleware)(loggerOptions));
-        this.options.logging = options || true;
-        return this;
-    }
-    validate(validator) {
-        if (validator) {
-            this.options.validator = validator;
-        }
-        else {
-            // Default to ZodValidator
-            this.options.validator = new zod_1.ZodValidator();
-        }
-        return this;
-    }
-    production() {
-        this.options.performanceMode = 'default';
-        this.use((0, compression_1.createCompressionMiddleware)());
-        // Auto-Cluster
-        // Note: Clustering usually needs to be at the process entry point.
-        // But we can check if we are primary and fork.
-        // For now, let's just enable optimizations.
-        // We can add a helper or documentation that 'app.start()' handles clustering if production() was called?
-        // Or better, app.start() can check options.performanceMode.
-        return this;
-    }
-    routes(prefix, plugin) {
-        this.register(plugin, { prefix });
-        return this;
-    }
-    // Ultra-Simple API: Fluent Rate Limit
-    rateLimit(option, interval) {
-        if (typeof option === 'string') {
-            // Preset
-            const presets = {
-                'strict': { windowMs: 15 * 60 * 1000, max: 10 },
-                'standard': { windowMs: 15 * 60 * 1000, max: 100 },
-                'relaxed': { windowMs: 60 * 60 * 1000, max: 1000 }
-            };
-            const config = presets[option] || presets['standard'];
-            this.use((0, rate_limit_1.rateLimit)(config));
-        }
-        else if (typeof option === 'number') {
-            // app.rateLimit(100, "1m");
-            let ms = 60 * 1000;
-            if (interval) {
-                if (interval === 'minute' || interval === '1m')
-                    ms = 60 * 1000;
-                if (interval === 'hour' || interval === '1h')
-                    ms = 60 * 60 * 1000;
-                if (interval === 'second' || interval === '1s')
-                    ms = 1000;
-            }
-            this.use((0, rate_limit_1.rateLimit)({
-                max: option,
-                windowMs: ms
-            }));
-        }
-        return this;
-    }
-    allow(count) {
-        return {
-            per: (interval) => {
-                let ms = 60 * 1000;
-                if (interval === 'minute' || interval === '1m')
-                    ms = 60 * 1000;
-                if (interval === 'hour' || interval === '1h')
-                    ms = 60 * 60 * 1000;
-                if (interval === 'second' || interval === '1s')
-                    ms = 1000;
-                this.use((0, rate_limit_1.rateLimit)({
-                    max: count,
-                    windowMs: ms
-                }));
-                return this;
-            }
-        };
-    }
-    fusion(enable = true) {
-        if (enable === false) {
-            // We can't easily remove it if it's there, but we can disable it in logic if we had a flag.
-            // But for now, let's assume this is for enabling.
-            return this;
-        }
-        if (!this._fusion) {
-            // Lazy load the class to avoid circular dep issues if any (though imported at top)
-            // But we already import RequestFusion.
-            // We need to set it to this.fusion (which is readonly in TS, but we can cast or ignore)
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            this._fusion = new fusion_1.RequestFusion(enable);
-            // Re-compile pipeline to include fusion wrapper if needed
-            // Actually, fusion is applied per-route in compileRoutePipeline.
-            // But we might need to re-compile existing routes? 
-            // Usually configuration happens before routes.
-        }
-        return this;
-    }
-    bodyLimit(bytes) {
-        this.options.maxBodyBytes = bytes;
-        return this;
-    }
-    metrics(enable = true) {
-        this.options.metricsEnabled = enable;
-        this._metrics.setEnabled(enable);
-        return this;
-    }
-    error(status, message, details) {
-        return new types_1.HttpError(status, message, { details });
-    }
-    start(port) {
-        return this.listen(port);
-    }
-    getOpenAPI(options) {
-        const generator = new generator_1.OpenAPIGenerator(this.router, options);
-        return generator.generate();
-    }
-    async listen(port, hostnameOrCallback, callback) {
-        // Ultra-Simple API: Clustering support in Production
-        if (this.options.performanceMode === 'default' && !process.env.QHTTPX_NO_CLUSTER) {
-            const cluster = await Promise.resolve().then(() => __importStar(require('cluster')));
-            const os = await Promise.resolve().then(() => __importStar(require('os')));
-            if (cluster.default.isPrimary) {
-                const numCPUs = os.cpus().length;
-                console.log(`Primary ${process.pid} is running. Forking ${numCPUs} workers...`);
-                for (let i = 0; i < numCPUs; i++) {
-                    cluster.default.fork();
-                }
-                cluster.default.on('exit', (worker) => {
-                    console.log(`worker ${worker.process.pid} died`);
-                });
-                // Return a dummy promise for primary, it keeps running
-                return new Promise(() => { });
-            }
-            else {
-                // Worker process falls through to normal listen
-            }
-        }
-        let hostname;
-        let cb;
-        if (typeof hostnameOrCallback === 'function') {
-            cb = hostnameOrCallback;
-            hostname = undefined;
-        }
-        else {
-            hostname = hostnameOrCallback;
-            cb = callback;
-        }
-        if (this.options.database) {
-            await this.options.database.connect();
-        }
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        if (this.options.plugins) {
-            // Plugins are registered synchronously in constructor, but their async init happens now?
-            // Actually, plugins are registered via app.register() which is async.
-            // So they should be ready.
-        }
-        return new Promise((resolve, reject) => {
-            const onError = (error) => {
-                this.server.off('error', onError);
-                reject(error);
-            };
-            this.server.once('error', onError);
-            this.server.listen(port, hostname, () => {
-                this.server.off('error', onError);
-                // Freeze router after server starts to prevent further registrations
-                this.router.freeze();
-                void this.runLifecycleHooks(this.onStartHooks);
-                const address = this.server.address();
-                if (cb)
-                    cb();
-                if (address && typeof address === 'object') {
-                    resolve({ port: address.port });
-                }
-                else {
-                    resolve({ port });
-                }
-            });
-        });
-    }
-    close() {
-        return new Promise((resolve, reject) => {
-            this.server.close((err) => {
-                if (err) {
-                    reject(err);
-                    return;
-                }
-                resolve();
-            });
-        });
-    }
-    async shutdown() {
-        await this.runLifecycleHooks(this.onBeforeShutdownHooks);
-        await this.close();
-        await this.runLifecycleHooks(this.onShutdownHooks);
-    }
-    createContext() {
-        return new QHTTPXContextImpl(this);
-    }
-    acquireContext(req, res, urlOrPath, params, query, requestId, body, 
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    files, cookies) {
-        const ctx = this.contextPool.acquire();
-        // Reset and populate properties
-        // We use type assertions to write to readonly/managed properties for performance
-        const mutableCtx = ctx;
-        mutableCtx.req = req;
-        mutableCtx.res = res;
-        mutableCtx.headers = req.headers;
-        if (typeof urlOrPath === 'string') {
-            // Ultra mode or fast path: Lazy URL instantiation
-            mutableCtx.path = urlOrPath;
-            // Class-based getter handles URL parsing lazily using this.req
-        }
-        else {
-            mutableCtx.url = urlOrPath;
-            mutableCtx.path = urlOrPath.pathname;
-        }
-        mutableCtx.method = req.method;
-        mutableCtx.params = params;
-        if (query) {
-            mutableCtx.query = query;
-        }
-        mutableCtx.body = body;
-        mutableCtx.files = files;
-        if (cookies) {
-            mutableCtx.cookies = cookies;
-        }
-        mutableCtx.requestId = requestId;
-        mutableCtx.serializer = undefined;
-        // In ultra mode, skip cookie parsing to save overhead
-        // Cookies are now parsed lazily via getter in QHTTPXContextImpl
-        mutableCtx.disableAutoEnd = false;
-        return mutableCtx;
-    }
-    releaseContext(ctx) {
-        this.contextPool.release(ctx);
-    }
-    async handleNoMatch(ctx, allowedMethods) {
-        const res = ctx.res;
-        const hasAnyMethod = allowedMethods.length > 0;
-        if (hasAnyMethod && this.methodNotAllowedHandler) {
-            const result = this.methodNotAllowedHandler(ctx, allowedMethods);
-            if (result && typeof result.then === 'function') {
-                await result;
-            }
-            if (!res.writableEnded && !res.headersSent) {
-                res.statusCode = 405;
-                res.setHeader('content-type', CONTENT_TYPE.PLAIN);
-                res.end('Method Not Allowed');
-            }
-        }
-        else if (!hasAnyMethod && this.notFoundHandler) {
-            const result = this.notFoundHandler(ctx);
-            if (result && typeof result.then === 'function') {
-                await result;
-            }
-            if (!res.writableEnded && !res.headersSent) {
-                res.statusCode = 404;
-                res.setHeader('content-type', CONTENT_TYPE.PLAIN);
-                res.end('Not Found');
-            }
-        }
-        else if (hasAnyMethod) {
-            if (!res.headersSent) {
-                res.statusCode = 405;
-                res.setHeader('content-type', CONTENT_TYPE.PLAIN);
-            }
-            res.end('Method Not Allowed');
-        }
-        else {
-            if (!res.headersSent) {
-                res.statusCode = 404;
-                res.setHeader('content-type', CONTENT_TYPE.PLAIN);
-            }
-            res.end('Not Found');
-        }
-    }
-    handleRequest(req, res) {
-        // ⚡ Optimized request handling with fast routing
-        const rawUrl = req.url || '/';
-        const method = (req.method || 'GET');
-        // Single-pass pathname extraction
-        let pathname;
-        const qIndex = rawUrl.indexOf('?');
-        pathname = qIndex === -1 ? rawUrl : rawUrl.substring(0, qIndex);
-        // Fast route matching with O(1) static and optimized dynamic routes
-        let match = this.router.match(method, pathname);
-        // Request ID generation (from x-request-id header or generated)
-        let requestId;
-        const incomingRequestIdHeader = req.headers['x-request-id'];
-        if (typeof incomingRequestIdHeader === 'string') {
-            requestId = incomingRequestIdHeader;
-        }
-        else if (Array.isArray(incomingRequestIdHeader)) {
-            requestId = incomingRequestIdHeader[0];
-        }
-        if (!requestId) {
-            requestId = this.generateRequestId();
-        }
-        if (!res.headersSent && requestId) {
-            res.setHeader('x-request-id', requestId);
-        }
-        const hasRoute = !!match;
-        if (!match) {
-            match = QHTTPX.EMPTY_MATCH;
-        }
-        // Optimization: Predictive Query Parsing
-        // 1. If no query string exists, set empty query to avoid getter scan
-        // 2. If query string exists AND route needs it, parse eagerly
-        let query;
-        if (qIndex === -1) {
-            query = EMPTY_QUERY;
-        }
-        else if (match.metadata?.needsQuery) {
-            query = (0, querystring_1.parse)(rawUrl.slice(qIndex + 1));
-        }
-        // Optimization: Predictive Cookie Parsing
-        let cookies;
-        if (match.metadata?.needsCookies) {
-            cookies = (0, cookies_1.parseCookies)(req.headers.cookie);
-        }
-        // Optimization: Only calculate allowed methods if no route match found
-        const allowedMethods = hasRoute ? [] : this.router.getAllowedMethods(pathname);
-        if (!hasRoute && !res.headersSent) {
-            const hasAnyMethod = allowedMethods.length > 0;
-            res.statusCode = hasAnyMethod ? 405 : 404;
-        }
-        // Memory Checks (throttled to every 100 requests for performance)
-        if (this.options.maxMemoryBytes !== undefined && ++this.requestCounter % 100 === 0) {
-            const sampleRss = process.memoryUsage().rss;
-            const overloadedByMemory = (0, resources_1.isResourceOverloaded)({ rssBytes: sampleRss }, { maxRssBytes: this.options.maxMemoryBytes });
-            if (overloadedByMemory) {
-                const overloaded = () => {
-                    if (res.writableEnded) {
-                        return;
-                    }
-                    if (!res.headersSent) {
-                        res.statusCode = 503;
-                        res.setHeader('content-type', CONTENT_TYPE.PLAIN);
-                    }
-                    res.end('Server overloaded');
-                };
-                overloaded();
-                return;
-            }
-        }
-        else {
-            ++this.requestCounter;
-        }
-        if (method !== 'GET' && method !== 'HEAD') {
-            body_parser_1.BodyParser.parse(req, {
-                maxBodyBytes: this.options.maxBodyBytes,
-            }).then((parsed) => {
-                this.dispatch(req, res, method, pathname, query, requestId, match, hasRoute, allowedMethods, parsed.body, parsed.files, cookies);
-            }).catch((err) => {
-                if (err instanceof Error && err.message === 'QHTTPX_INVALID_JSON') {
-                    if (!res.headersSent) {
-                        res.statusCode = 400;
-                        res.setHeader('content-type', CONTENT_TYPE.PLAIN);
-                    }
-                    res.end('Invalid JSON');
-                    return;
-                }
-                if (err instanceof Error && err.message === 'QHTTPX_BODY_TOO_LARGE') {
-                    if (!res.headersSent) {
-                        res.statusCode = 413;
-                        res.setHeader('content-type', CONTENT_TYPE.PLAIN);
-                    }
-                    res.end('Payload Too Large');
-                    return;
-                }
-                if (!res.headersSent) {
-                    res.statusCode = 500;
-                    res.setHeader('content-type', CONTENT_TYPE.PLAIN);
-                }
-                res.end('Internal Server Error');
-            });
-            return;
-        }
-        this.dispatch(req, res, method, pathname, query, requestId, match, hasRoute, allowedMethods, undefined, undefined, cookies);
-    }
-    async dispatch(req, res, method, pathname, query, requestId, match, hasRoute, allowedMethods, body, files, cookies) {
-        const ctx = this.acquireContext(req, res, pathname, match.params, query, requestId, body, files, cookies);
-        // Balanced Mode Logic
-        const overloaded = () => {
-            if (res.writableEnded) {
-                return;
-            }
-            if (!res.headersSent) {
-                res.statusCode = 503;
-                res.setHeader('content-type', CONTENT_TYPE.PLAIN);
-            }
-            res.end('Server overloaded');
-        };
-        let timedOut = false;
-        const onTimeout = () => {
-            timedOut = true;
-            if (res.writableEnded) {
-                return;
-            }
-            if (!res.headersSent) {
-                res.statusCode = 504;
-                res.setHeader('content-type', CONTENT_TYPE.PLAIN);
-            }
-            res.end('Request timed out');
-        };
-        let start = 0;
-        const metricsEnabled = this._metrics.isEnabled;
-        if (metricsEnabled || this.tracer) {
-            start = timer_1.globalTimer.preciseNow();
-            ctx.requestStart = start;
-            if (metricsEnabled) {
-                this._metrics.onRequestStart();
-            }
-        }
-        if (this.tracer) {
-            const event = {
-                type: 'request_start',
-                method,
-                path: pathname,
-                requestId,
-            };
-            const result = this.tracer(event);
-            if (result && typeof result.then === 'function') {
-                void result;
-            }
-        }
-        const finish = () => {
-            let duration = 0;
-            if (metricsEnabled || this.tracer) {
-                duration = timer_1.globalTimer.preciseNow() - start;
-                if (metricsEnabled) {
-                    this._metrics.onRequestEnd(duration, res.statusCode);
-                    if (timedOut) {
-                        this._metrics.onTimeout();
-                    }
-                }
-            }
-            if (this.tracer) {
-                const event = {
-                    type: 'request_end',
-                    method,
-                    path: pathname,
-                    statusCode: res.statusCode,
-                    durationMs: duration,
-                    requestId,
-                };
-                const result = this.tracer(event);
-                if (result && typeof result.then === 'function') {
-                    void result;
-                }
-            }
-            this.releaseContext(ctx);
-        };
-        const handle = async () => {
-            const handler = match.handler;
-            try {
-                if (hasRoute) {
-                    const result = handler(ctx);
-                    if (result && typeof result.then === 'function') {
-                        await result;
-                    }
-                }
-                else if (this.pipelineRunner) {
-                    await this.pipelineRunner(ctx, handler);
-                }
-                if (!res.writableEnded) {
-                    if (!hasRoute) {
-                        await this.handleNoMatch(ctx, allowedMethods);
-                    }
-                    else if (!ctx.disableAutoEnd) {
-                        res.end();
-                    }
-                }
-            }
-            catch (err) {
-                await this.handleError(err, ctx);
-            }
-        };
-        // Use scheduler for request handling
-        this.scheduler.run(handle, {
-            priority: match.priority,
-            onOverloaded: overloaded,
-            timeoutMs: this.options.requestTimeoutMs,
-            onTimeout,
-        }).then(finish).catch((err) => {
-            console.error('Scheduler error:', err);
-            finish();
-        });
-    }
-    async handleUpgrade(req, socket, head) {
-        await this.wsManager.handleUpgrade(req, socket, head);
-    }
-    async runLifecycleHooks(hooks) {
-        if (hooks.length === 0) {
-            return;
-        }
-        for (const hook of hooks) {
-            try {
-                const result = hook();
-                if (result && typeof result.then === 'function') {
-                    await result;
-                }
-            }
-            catch {
-                // Ignore hook errors to avoid impacting core server flow
-            }
-        }
-    }
-    handleError(err, ctx) {
-        const res = ctx.res;
-        if (res.writableEnded) {
-            return;
-        }
-        if (this.errorHandler) {
-            try {
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                const errorContext = ctx;
-                errorContext.error = err;
-                const result = this.errorHandler(errorContext);
-                if (result && typeof result.then === 'function') {
-                    return result.then(() => {
-                        // Ensure response is sent if handler didn't
-                    });
-                }
-                if (res.writableEnded) {
-                    return;
-                }
-            }
-            catch (handlerErr) {
-                // Fall through to default error handling below
-                console.error('Error in error handler:', handlerErr);
-            }
-        }
-        if (res.writableEnded) {
-            return;
-        }
-        if (err instanceof types_1.HttpError) {
-            if (!res.headersSent) {
-                res.statusCode = err.status;
-                res.setHeader('content-type', CONTENT_TYPE.JSON);
-            }
-            const payload = {
-                error: {
-                    message: err.message,
-                    code: err.code ?? 'HTTP_ERROR',
-                    details: err.details,
-                },
-            };
-            const serializer = this.options.jsonSerializer;
-            const body = serializer !== undefined ? serializer(payload) : JSON.stringify(payload);
-            res.end(body);
-            return;
-        }
-        if (!res.headersSent) {
-            res.statusCode = 500;
-            res.setHeader('content-type', CONTENT_TYPE.PLAIN);
-        }
-        res.end('Internal Server Error');
-    }
-    generateRequestId() {
-        const now = timer_1.globalTimer.now();
-        if (now !== this.lastDateNow) {
-            this.lastDateNow = now;
-            this.lastDateString = now.toString(36);
-        }
-        const id = this.nextRequestId;
-        this.nextRequestId += 1;
-        return `${this.lastDateString}-${id.toString(36)}`;
-    }
-}
-exports.QHTTPX = QHTTPX;
-QHTTPX.EMPTY_PARAMS = Object.freeze({});
-QHTTPX.EMPTY_MATCH = Object.freeze({
-    handler: () => { },
-    params: QHTTPX.EMPTY_PARAMS,
-    priority: types_1.RoutePriority.STANDARD,
-    metadata: { needsQuery: false, needsCookies: false, needsBody: false, pipeline: undefined },
-});