xypriss 9.11.13 → 9.12.0

package/dist/src/server/core/HttpServer.js

@@ -0,0 +1,276 @@
+/**
+ * XyPrisHttpServer - Express-free HTTP server implementation
+ *
+ * This module provides a XyPris HTTP server that replaces Express with
+ * direct Node.js HTTP handling for maximum performance and control.
+ * It maintains API compatibility while removing Express overhead.
+ */
+import { MiddlewareManager } from "../middleware/MiddlewareManager";
+import { NotFoundHandler } from "../handlers/NotFoundHandler";
+import { XyPrisRequestApp } from "./RequestApp";
+import { ResponseEnhancer } from "./ResponseEnhancer";
+import { RequestEnhancer } from "./RequestEnhancer";
+import { XVS as VirtualServer } from "./VirtualServer";
+import { UriNormalizer } from "../../middleware/built-in/security/UriNormalizer";
+import { HoneypotTarpit } from "../../middleware/built-in/security/HoneypotTarpit";
+// New Modules
+import { RouteManager } from "./http/RouteManager";
+import { BodyParser } from "./http/BodyParser";
+import { RequestForwarder } from "./http/RequestForwarder";
+import { HttpErrorHandler } from "./http/HttpErrorHandler";
+import { Configs } from "../..";
+import { ResponseControlManager } from "../components/response-control/ResponseControlManager";
+/**
+ * XyPrissHttpServer - XPris HTTP server implementation
+ */
+export class XyPrissHttpServer {
+    constructor(logger) {
+        this.logger = logger;
+        this.middlewareManager = new MiddlewareManager(logger);
+        const cfg = Configs.get("notFound");
+        const rc = Configs.get("responseControl");
+        const isNotFoundEnabled = cfg?.enabled !== false;
+        if (!isNotFoundEnabled && rc?.enabled) {
+            this.notFoundHandler = null;
+        }
+        else {
+            this.notFoundHandler = new NotFoundHandler();
+        }
+        this.responseEnhancer = new ResponseEnhancer(logger);
+        this.requestEnhancer = new RequestEnhancer(logger);
+        // Initialize modular components
+        this.routeManager = new RouteManager(logger);
+        this.requestForwarder = new RequestForwarder(logger);
+        this.httpErrorHandler = new HttpErrorHandler(logger, this.notFoundHandler);
+        this.responseControlManager = new ResponseControlManager(logger);
+        this.server = new VirtualServer();
+        this.httpErrorHandler.setupDefaultErrorHandler(this.server);
+        this.logger.debug("server", "[XyPrissHttpServer] Created new HTTP server with modularized components");
+    }
+    setApp(app) {
+        this.logger.debug("server", "[HttpServer] setApp called");
+        this.app = app;
+    }
+    use(pathOrMiddleware, middleware) {
+        if (typeof pathOrMiddleware === "function") {
+            this.middlewareManager.use(pathOrMiddleware);
+        }
+        else if (middleware) {
+            const pathMiddleware = (req, res, next) => {
+                if (req.path.startsWith(pathOrMiddleware)) {
+                    return middleware(req, res, next);
+                }
+                next?.();
+            };
+            this.middlewareManager.use(pathMiddleware, {
+                name: `path_middleware_${pathOrMiddleware}`,
+                description: `Path-specific middleware for ${pathOrMiddleware}`,
+            });
+        }
+    }
+    get(path, ...handlers) {
+        this.routeManager.addRoute("GET", path, handlers);
+    }
+    post(path, ...handlers) {
+        this.routeManager.addRoute("POST", path, handlers);
+    }
+    put(path, ...handlers) {
+        this.routeManager.addRoute("PUT", path, handlers);
+    }
+    delete(path, ...handlers) {
+        this.routeManager.addRoute("DELETE", path, handlers);
+    }
+    patch(path, ...handlers) {
+        this.routeManager.addRoute("PATCH", path, handlers);
+    }
+    options(path, ...handlers) {
+        this.routeManager.addRoute("OPTIONS", path, handlers);
+    }
+    head(path, ...handlers) {
+        this.routeManager.addRoute("HEAD", path, handlers);
+    }
+    connect(path, ...handlers) {
+        this.routeManager.addRoute("CONNECT", path, handlers);
+    }
+    trace(path, ...handlers) {
+        this.routeManager.addRoute("TRACE", path, handlers);
+    }
+    addRouteWithParams(method, path, paramNames, handlers) {
+        this.routeManager.addRouteWithParams(method, path, paramNames, handlers);
+    }
+    setTrustProxy(config) {
+        this.logger.debug("server", "Trust proxy is evaluated globally by XHSC.");
+    }
+    listen(port, host, callback) {
+        this.logger.debug("server", `listen() called: ${host}:${port} (Standard Mode)`);
+        this.server.listen(port, host, callback);
+        return this.server;
+    }
+    async handleRequest(req, res) {
+        const startTime = process.hrtime();
+        // Backward compatibility for csurf: expose csrfToken() method
+        req.csrfToken = () => req.headers["x-csrf-token"];
+        // Strict URI Normalization to prevent Path Traversal
+        if (req.url) {
+            const [pathPart, ...queryParts] = req.url.split("?");
+            const normalized = UriNormalizer.normalizePath(pathPart);
+            // Support both top-level security and nested server.security (common in multi-server)
+            const securityConfig = this.app?.configs?.security ||
+                this.app?.configs?.server?.security;
+            // Register custom traps if configuration is an object
+            if (typeof securityConfig?.honeypotTarpit === "object") {
+                HoneypotTarpit.registerCustomTraps(securityConfig.honeypotTarpit);
+            }
+            const hcfg = Configs.get("security")?.honeypotTarpit;
+            const hc2 = typeof hcfg === "object"
+                ? hcfg?.enabled !== false
+                : hcfg;
+            // console.log({
+            //     hc2,
+            //     hcfg,
+            //     typeofHCF: typeof hcfg === "object",
+            //     c1: (hcfg as HoneypotTarpitConfig)?.enabled !== false,
+            // });
+            const honeypotEnabled = hc2 ?? true;
+            // Dynamic Honeypot Tarpit: Drop connection instantly for known malicious bot probes
+            if (honeypotEnabled && HoneypotTarpit.isTrap(normalized)) {
+                HoneypotTarpit.handleTrap(req, res);
+                return;
+            }
+            req.url =
+                queryParts.length > 0
+                    ? `${normalized}?${queryParts.join("?")}`
+                    : normalized;
+            req.originalUrl = req.url;
+        }
+        let XyPrisReq;
+        let XyPrisRes;
+        try {
+            XyPrisReq = this.enhanceRequest(req);
+            XyPrisRes = this.enhanceResponse(res, XyPrisReq);
+        }
+        catch (error) {
+            this.logger.error("server", `Failed to enhance request: ${error}`);
+            res.statusCode = 400;
+            res.end(JSON.stringify({ error: "Bad Request" }));
+            return;
+        }
+        // Attach req.redirect — delegates to res.redirect
+        XyPrisReq.redirect = ((statusOrUrl, url) => {
+            if (typeof statusOrUrl === "number" && url) {
+                XyPrisRes.redirect(statusOrUrl, url);
+            }
+            else {
+                XyPrisRes.redirect(statusOrUrl);
+            }
+        });
+        // Attach req.forward — delegates to RequestForwarder
+        XyPrisReq.forward = async (url, options = {}) => {
+            return this.requestForwarder.forward(req, XyPrisReq, url, options);
+        };
+        const originalEnd = res.end.bind(res);
+        res.end = (chunk, encoding, cb) => {
+            if (res.writableEnded)
+                return res;
+            const diff = process.hrtime(startTime);
+            const responseTimeMs = (diff[0] * 1e9 + diff[1]) / 1e6;
+            const pluginManager = this.app?.pluginManager;
+            if (pluginManager &&
+                typeof pluginManager.triggerResponseTime === "function") {
+                pluginManager.triggerResponseTime(responseTimeMs, XyPrisReq, XyPrisRes);
+            }
+            return originalEnd(chunk, encoding, cb);
+        };
+        try {
+            const hasPayload = ["POST", "PUT", "PATCH", "DELETE"].includes(XyPrisReq.method) ||
+                (XyPrisReq.headers["content-length"] &&
+                    parseInt(XyPrisReq.headers["content-length"]) >
+                        0) ||
+                XyPrisReq.headers["transfer-encoding"];
+            if (hasPayload) {
+                const contentType = XyPrisReq.headers["content-type"] || "";
+                if (!contentType.includes("multipart/form-data")) {
+                    await BodyParser.parse(XyPrisReq);
+                }
+            }
+            const middlewareChainCompleted = await this.middlewareManager.execute(XyPrisReq, XyPrisRes);
+            if (!middlewareChainCompleted)
+                return;
+            const route = this.routeManager.findRoute(XyPrisReq.method, XyPrisReq.path, XyPrisReq);
+            if (route) {
+                for (const middleware of route.middleware) {
+                    await this.executeMiddlewareFunction(middleware, XyPrisReq, XyPrisRes);
+                }
+                if (!XyPrisRes.writableEnded) {
+                    await route.handler(XyPrisReq, XyPrisRes);
+                }
+            }
+            else {
+                if (!XyPrisRes.writableEnded) {
+                    await this.httpErrorHandler.send404(XyPrisReq, XyPrisRes, this.responseControlManager);
+                }
+            }
+        }
+        catch (error) {
+            this.httpErrorHandler.handleError(error, XyPrisReq, XyPrisRes, this.app, this.errorHandler);
+        }
+    }
+    enhanceRequest(req) {
+        if (req.originalUrl !== undefined && req.ip !== undefined) {
+            req.app = new XyPrisRequestApp(this.app, this.logger);
+            return req;
+        }
+        return this.requestEnhancer.enhance(req, this.app);
+    }
+    enhanceResponse(res, req) {
+        return this.responseEnhancer.enhance(res, req);
+    }
+    async executeMiddlewareFunction(middleware, req, res) {
+        return new Promise((resolve, reject) => {
+            let nextCalled = false;
+            const next = (error) => {
+                if (nextCalled)
+                    return;
+                nextCalled = true;
+                if (error)
+                    reject(error);
+                else
+                    resolve();
+            };
+            try {
+                const result = middleware(req, res, next);
+                if (result instanceof Promise)
+                    result.catch(reject);
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+    }
+    getServer() {
+        return this.server;
+    }
+    close(callback) {
+        if (this.xhscBridge)
+            this.xhscBridge.stop();
+        this.server.close(callback);
+    }
+    address() {
+        return this.server.address();
+    }
+    getRoutes() {
+        return this.routeManager.getRoutes();
+    }
+    setNotFoundHandler(config) {
+        if (this.notFoundHandler) {
+            this.notFoundHandler.updateConfig(config);
+        }
+    }
+    setResponseControl(config) {
+        this.responseControlManager.setConfig(config);
+    }
+    setErrorHandler(handler) {
+        this.errorHandler = handler;
+    }
+}
+//# sourceMappingURL=HttpServer.js.map

package/dist/src/server/core/HttpServer.js.map

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

package/dist/src/server/core/RequestApp.d.ts

@@ -0,0 +1,42 @@
+import { Logger } from "../../shared/logger/Logger";
+/**
+ * XyPrisRequestApp - An Express-compatible application object wrapper for requests.
+ *
+ * This class provides a robust implementation of the `req.app` property. It uses
+ * a Proxy to allow transparent access to the main application instance while
+ * providing specific methods for setting and getting application-level configurations.
+ */
+export declare class XyPrisRequestApp {
+    private appInstance;
+    private logger;
+    constructor(appInstance: any, logger: Logger);
+    /**
+     * Retrieves a setting value from the application instance.
+     *
+     * This method first checks the `settings` object of the application,
+     * and then falls back to checking direct properties on the application instance.
+     * It ensures that functions are correctly bound to the application context.
+     *
+     * @param key - The setting key or property name to retrieve.
+     * @returns The value associated with the key, or undefined if not found.
+     */
+    get(key: string): any;
+    /**
+     * Sets a configuration value on the application instance.
+     *
+     * This method attempts to use the application's `set` method if available.
+     * Otherwise, it falls back to modifying the `settings` object or the
+     * application instance directly. All changes are logged at the debug level.
+     *
+     * @param key - The configuration key to set.
+     * @param value - The value to assign to the key.
+     */
+    set(key: string, value: any): void;
+    /**
+     * Provides direct access to the application's Plugin Manager.
+     *
+     * @returns The PluginManager instance associated with the application.
+     */
+    get pluginManager(): any;
+}
+//# sourceMappingURL=RequestApp.d.ts.map

package/dist/src/server/core/RequestApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestApp.d.ts","sourceRoot":"","sources":["../../../../src/server/core/RequestApp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEpD;;;;;;GAMG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEX,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM;IA0B5C;;;;;;;;;OASG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG;IAoB5B;;;;;;;;;OASG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAiBzC;;;;OAIG;IACH,IAAW,aAAa,IAAI,GAAG,CAE9B;CACJ"}

package/dist/src/server/core/RequestApp.js

@@ -0,0 +1,91 @@
+/**
+ * XyPrisRequestApp - An Express-compatible application object wrapper for requests.
+ *
+ * This class provides a robust implementation of the `req.app` property. It uses
+ * a Proxy to allow transparent access to the main application instance while
+ * providing specific methods for setting and getting application-level configurations.
+ */
+export class XyPrisRequestApp {
+    constructor(appInstance, logger) {
+        this.appInstance = appInstance;
+        this.logger = logger;
+        // Return a Proxy to allow transparent access to appInstance properties
+        return new Proxy(this, {
+            get: (target, prop, receiver) => {
+                // If the property exists on this class, return it
+                if (prop in target || prop === "constructor") {
+                    return Reflect.get(target, prop, receiver);
+                }
+                // Otherwise, proxy to appInstance
+                if (this.appInstance && prop in this.appInstance) {
+                    const value = this.appInstance[prop];
+                    if (typeof value === "function") {
+                        return value.bind(this.appInstance);
+                    }
+                    return value;
+                }
+                return undefined;
+            },
+        });
+    }
+    /**
+     * Retrieves a setting value from the application instance.
+     *
+     * This method first checks the `settings` object of the application,
+     * and then falls back to checking direct properties on the application instance.
+     * It ensures that functions are correctly bound to the application context.
+     *
+     * @param key - The setting key or property name to retrieve.
+     * @returns The value associated with the key, or undefined if not found.
+     */
+    get(key) {
+        if (!this.appInstance)
+            return undefined;
+        // Check settings first
+        if (this.appInstance.settings && key in this.appInstance.settings) {
+            return this.appInstance.settings[key];
+        }
+        // Check if it's a property on the app
+        if (this.appInstance && key in this.appInstance) {
+            const value = this.appInstance[key];
+            if (typeof value === "function") {
+                return value.bind(this.appInstance);
+            }
+            return value;
+        }
+        return undefined;
+    }
+    /**
+     * Sets a configuration value on the application instance.
+     *
+     * This method attempts to use the application's `set` method if available.
+     * Otherwise, it falls back to modifying the `settings` object or the
+     * application instance directly. All changes are logged at the debug level.
+     *
+     * @param key - The configuration key to set.
+     * @param value - The value to assign to the key.
+     */
+    set(key, value) {
+        if (!this.appInstance)
+            return;
+        if (typeof this.appInstance.set === "function") {
+            this.appInstance.set(key, value);
+        }
+        else if (this.appInstance.settings) {
+            this.appInstance.settings[key] = value;
+        }
+        else {
+            this.appInstance[key] = value;
+        }
+        this.logger.debug("server", `[RequestApp] Set app setting: ${key} = ${value}`);
+    }
+    /**
+     * Provides direct access to the application's Plugin Manager.
+     *
+     * @returns The PluginManager instance associated with the application.
+     */
+    get pluginManager() {
+        return this.appInstance?.pluginManager;
+    }
+}
+//# sourceMappingURL=RequestApp.js.map

package/dist/src/server/core/RequestApp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestApp.js","sourceRoot":"","sources":["../../../../src/server/core/RequestApp.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAO,gBAAgB;IAIzB,YAAY,WAAgB,EAAE,MAAc;QACxC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,uEAAuE;QACvE,OAAO,IAAI,KAAK,CAAC,IAAI,EAAE;YACnB,GAAG,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;gBAC5B,kDAAkD;gBAClD,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;oBAC3C,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;gBAC/C,CAAC;gBAED,kCAAkC;gBAClC,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;oBAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;oBACrC,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;wBAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;oBACxC,CAAC;oBACD,OAAO,KAAK,CAAC;gBACjB,CAAC;gBAED,OAAO,SAAS,CAAC;YACrB,CAAC;SACJ,CAAC,CAAC;IACP,CAAC;IAED;;;;;;;;;OASG;IACI,GAAG,CAAC,GAAW;QAClB,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,OAAO,SAAS,CAAC;QAExC,uBAAuB;QACvB,IAAI,IAAI,CAAC,WAAW,CAAC,QAAQ,IAAI,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;YAChE,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC1C,CAAC;QAED,sCAAsC;QACtC,IAAI,IAAI,CAAC,WAAW,IAAI,GAAG,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YACpC,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;gBAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACxC,CAAC;YACD,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,OAAO,SAAS,CAAC;IACrB,CAAC;IAED;;;;;;;;;OASG;IACI,GAAG,CAAC,GAAW,EAAE,KAAU;QAC9B,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,OAAO;QAE9B,IAAI,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;YAC7C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACrC,CAAC;aAAM,IAAI,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;YACnC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC3C,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAClC,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,QAAQ,EACR,iCAAiC,GAAG,MAAM,KAAK,EAAE,CACpD,CAAC;IACN,CAAC;IAED;;;;OAIG;IACH,IAAW,aAAa;QACpB,OAAO,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC;IAC3C,CAAC;CACJ"}

package/dist/src/server/core/RequestEnhancer.d.ts

@@ -0,0 +1,171 @@
+/***************************************************************************
+ * XyPriss - Fast And Secure
+ *
+ * @author Nehonix
+ * @license Nehonix OSL (NOSL)
+ *
+ * Copyright (c) 2025 Nehonix. All rights reserved.
+ *
+ * This License governs the use, modification, and distribution of software
+ * provided by NEHONIX under its open source projects.
+ * NEHONIX is committed to fostering collaborative innovation while strictly
+ * protecting its intellectual property rights.
+ * Violation of any term of this License will result in immediate termination of all granted rights
+ * and may subject the violator to legal action.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE,
+ * AND NON-INFRINGEMENT.
+ * IN NO EVENT SHALL NEHONIX BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
+ * OR CONSEQUENTIAL DAMAGES ARISING FROM THE USE OR INABILITY TO USE THE SOFTWARE,
+ * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+ *
+ ***************************************************************************** */
+import type { IncomingMessage } from "http";
+import { XyPrisRequest } from "../../types/httpServer.type";
+import { Logger } from "../../shared/logger/Logger";
+/**
+ * RequestEnhancer - Enhances the standard Node.js IncomingMessage with Express-like properties and methods.
+ *
+ * This class is responsible for transforming a raw HTTP request into a more
+ * feature-rich XyPrisRequest. It handles URL parsing (with fallback mechanisms),
+ * client IP extraction via trust proxy settings, cookie parsing, and
+ * injection of application-level context.
+ */
+export declare class RequestEnhancer {
+    private logger;
+    private static readonly DEFAULT_HOST;
+    private static readonly DEFAULT_PATHNAME;
+    private static readonly COOKIE_SEPARATOR;
+    private static readonly XMLHTTP_REQUEST;
+    constructor(logger: Logger);
+    /**
+     * Enhances a standard Node.js IncomingMessage object by injecting XyPris-specific properties.
+     *
+     * This method performs several key operations:
+     * 1. Parses the request URL to extract the pathname and query parameters.
+     * 2. Injects standard Express-like properties such as `params`, `query`, `body`, and `path`.
+     * 3. Uses standard headers securely passed by XHSC to extract the client's IP and protocol.
+     * 4. Parses cookies from the `Cookie` header.
+     * 5. Attaches a proxied `app` object for access to application settings.
+     *
+     * @param req - The original Node.js IncomingMessage object.
+     * @param app - The application instance to be associated with the request.
+     * @returns The enhanced XyPrisRequest object.
+     */
+    enhance(req: IncomingMessage, app: any): XyPrisRequest;
+    /**
+     * Parses the raw `Cookie` header string into a key-value object.
+     *
+     * This method follows standard cookie parsing rules, splitting by semicolons
+     * and decoding URI components for both names and values.
+     *
+     * @param cookieHeader - The raw string from the `Cookie` HTTP header.
+     * @returns A record containing all parsed cookies.
+     */
+    private parseCookies;
+    /**
+     * Safely parses the request URL using the modern WHATWG URL API.
+     *
+     * This method prioritizes compliance and performance by using the
+     * standard URL constructor. It reconstructs the full URL using
+     * trust proxy settings.
+     *
+     * @private
+     * @param req - The incoming HTTP request object.
+     * @returns An object containing the parsed pathname and query parameters.
+     */
+    private _parseUrlSafely;
+    /**
+     * Converts `URLSearchParams` into a plain JavaScript object.
+     *
+     * This implementation supports multiple values for the same key by
+     * automatically converting them into an array, mirroring Express behavior.
+     * It is optimized to minimize unnecessary allocations.
+     *
+     * @private
+     * @param searchParams - The search parameters to convert.
+     * @returns A record containing all query parameters.
+     */
+    private _convertSearchParamsToObject;
+    /**
+     * Constructs the base request object with fundamental properties.
+     *
+     * Initializes core fields such as `params`, `query`, `body`, `path`,
+     * `originalUrl`, and `method`.
+     *
+     * @private
+     * @param req - The incoming HTTP request.
+     * @param pathname - The parsed URL pathname.
+     * @param query - The parsed query parameters.
+     * @returns The base XyPrisRequest object.
+     */
+    private _buildBaseRequest;
+    /**
+     * Attaches proxy-related properties to the request.
+     *
+     * Relies on the standard headers set by the XHSC Go core
+     * `X-Real-IP`, `X-Forwarded-For`, `X-Forwarded-Proto`, and `X-Forwarded-Host`.
+     *
+     * @private
+     * @param req - The original HTTP request.
+     * @param XyPrisReq - The enhanced request object.
+     */
+    private _attachProxyProperties;
+    private getProtocol;
+    private getFirstHeaderValue;
+    /**
+     * Attaches Express-like properties to the request.
+     *
+     * Injects properties such as `cookies`, `subdomains`, `fresh`, `stale`,
+     * and `xhr` to provide a familiar API for developers.
+     *
+     * @private
+     * @param req - The original HTTP request.
+     * @param XyPrisReq - The enhanced request object.
+     */
+    private _attachExpressLikeProperties;
+    /**
+     * Extracts subdomains from a given hostname.
+     *
+     * This method is optimized to avoid unnecessary allocations for simple
+     * domains (e.g., example.com) and correctly handles multi-level subdomains.
+     *
+     * @private
+     * @param hostname - The hostname to analyze.
+     * @returns An array of subdomains.
+     */
+    private _extractSubdomains;
+    /**
+     * Checks if the request is an AJAX (XMLHttpRequest) request.
+     *
+     * Inspects the `X-Requested-With` header for the value `XMLHttpRequest`.
+     *
+     * @private
+     * @param req - The HTTP request object.
+     * @returns True if it is an XHR request, false otherwise.
+     */
+    private _isXmlHttpRequest;
+    /**
+     * Attaches utility methods to the request object.
+     *
+     * Currently attaches the `get()` method for case-insensitive header retrieval.
+     *
+     * @private
+     * @param req - The original HTTP request.
+     * @param XyPrisReq - The enhanced request object.
+     */
+    private _attachUtilityMethods;
+    /**
+     * Creates the `req.get()` method for case-insensitive header retrieval.
+     *
+     * Uses a closure to capture the request context and optimize repeated
+     * header lookups.
+     *
+     * @private
+     * @param req - The original HTTP request.
+     * @returns The `get()` function.
+     */
+    private _createGetHeaderMethod;
+}
+//# sourceMappingURL=RequestEnhancer.d.ts.map

package/dist/src/server/core/RequestEnhancer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestEnhancer.d.ts","sourceRoot":"","sources":["../../../../src/server/core/RequestEnhancer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;iFAsBiF;AAEjF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAGpD;;;;;;;GAOG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,MAAM,CAAS;IAGvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAe;IACnD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAO;IAC/C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAO;IAC/C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAoB;gBAE/C,MAAM,EAAE,MAAM;IAI1B;;;;;;;;;;;;;OAaG;IACI,OAAO,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,GAAG,GAAG,aAAa;IAa7D;;;;;;;;OAQG;IACH,OAAO,CAAC,YAAY;IA6BpB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,eAAe;IAoCvB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,4BAA4B;IAoBpC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,iBAAiB;IAkBzB;;;;;;;;;OASG;IACH,OAAO,CAAC,sBAAsB;IAmD9B,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,mBAAmB;IAW3B;;;;;;;;;OASG;IACH,OAAO,CAAC,4BAA4B;IAapC;;;;;;;;;OASG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;;;;;;;OAQG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;;;;;;;OAQG;IACH,OAAO,CAAC,qBAAqB;IAO7B;;;;;;;;;OASG;IACH,OAAO,CAAC,sBAAsB;CAcjC"}