xypriss 9.10.19 → 9.10.21

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

@@ -1,330 +0,0 @@
-/***************************************************************************
- * 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 { XyPrisRequestApp } from "./RequestApp";
-/**
- * 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 class RequestEnhancer {
-    constructor(logger) {
-        this.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, app) {
-        const { pathname, query } = this._parseUrlSafely(req);
-        const XyPrisReq = this._buildBaseRequest(req, pathname, query);
-        this._attachProxyProperties(req, XyPrisReq);
-        this._attachExpressLikeProperties(req, XyPrisReq);
-        this._attachUtilityMethods(req, XyPrisReq);
-        XyPrisReq.app = new XyPrisRequestApp(app, this.logger);
-        return XyPrisReq;
-    }
-    /**
-     * 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.
-     */
-    parseCookies(cookieHeader) {
-        if (!cookieHeader || cookieHeader.length === 0) {
-            return {};
-        }
-        const cookies = {};
-        const parts = cookieHeader.split(RequestEnhancer.COOKIE_SEPARATOR);
-        for (let i = 0; i < parts.length; i++) {
-            const cookie = parts[i].trim();
-            if (!cookie)
-                continue;
-            const eqIdx = cookie.indexOf("=");
-            if (eqIdx === -1 || eqIdx === 0)
-                continue;
-            const name = cookie.substring(0, eqIdx);
-            const value = cookie.substring(eqIdx + 1);
-            try {
-                cookies[name] = decodeURIComponent(value);
-            }
-            catch (e) {
-                // If decoding fails, use the raw value as a fallback
-                cookies[name] = value;
-            }
-        }
-        return cookies;
-    }
-    /**
-     * 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.
-     */
-    _parseUrlSafely(req) {
-        const url = req.url || "/";
-        try {
-            const protocol = this.getProtocol(req);
-            const host = req.headers.host || RequestEnhancer.DEFAULT_HOST;
-            // Reconstruct full URL for parsing
-            const fullUrl = new URL(url, `${protocol}://${host}`);
-            let pathname = fullUrl.pathname;
-            if (pathname.length > 1 && pathname.endsWith("/")) {
-                pathname = pathname.slice(0, -1);
-            }
-            return {
-                pathname: pathname,
-                query: this._convertSearchParamsToObject(fullUrl.searchParams),
-            };
-        }
-        catch (error) {
-            this.logger.warn("server", `URL parsing failed with WHATWG API: ${error}. Falling back to defaults.`);
-            // Return defaults if parsing completely fails
-            return {
-                pathname: url.split("?")[0] || RequestEnhancer.DEFAULT_PATHNAME,
-                query: {},
-            };
-        }
-    }
-    /**
-     * 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.
-     */
-    _convertSearchParamsToObject(searchParams) {
-        const query = {};
-        for (const [key, value] of searchParams.entries()) {
-            const existing = query[key];
-            if (existing === undefined) {
-                query[key] = value;
-            }
-            else if (Array.isArray(existing)) {
-                existing.push(value);
-            }
-            else {
-                query[key] = [existing, value];
-            }
-        }
-        return query;
-    }
-    /**
-     * 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.
-     */
-    _buildBaseRequest(req, pathname, query) {
-        const XyPrisReq = req;
-        XyPrisReq.params = {};
-        XyPrisReq.query = query;
-        XyPrisReq.body = {};
-        XyPrisReq.path = pathname;
-        XyPrisReq.originalUrl = req.url || "";
-        XyPrisReq.baseUrl = "";
-        XyPrisReq.method = req.method || "GET";
-        return XyPrisReq;
-    }
-    /**
-     * 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.
-     */
-    _attachProxyProperties(req, XyPrisReq) {
-        const xRealIp = this.getFirstHeaderValue(req.headers["x-real-ip"]);
-        const xForwardedFor = req.headers["x-forwarded-for"];
-        const xForwardedHost = this.getFirstHeaderValue(req.headers["x-forwarded-host"]);
-        const socketIp = req.socket?.remoteAddress || "127.0.0.1";
-        XyPrisReq.ip =
-            xRealIp || this.getFirstHeaderValue(xForwardedFor) || socketIp;
-        if (xForwardedFor) {
-            XyPrisReq.ips = Array.isArray(xForwardedFor)
-                ? xForwardedFor
-                    .join(",")
-                    .split(",")
-                    .map((i) => i.trim())
-                    .filter(Boolean)
-                : xForwardedFor
-                    .split(",")
-                    .map((i) => i.trim())
-                    .filter(Boolean);
-        }
-        else {
-            XyPrisReq.ips = [XyPrisReq.ip];
-        }
-        XyPrisReq.protocol = this.getProtocol(req);
-        XyPrisReq.secure = XyPrisReq.protocol === "https";
-        XyPrisReq.hostname = xForwardedHost || req.headers.host || "localhost";
-        // Clean hostname from port if present
-        if (XyPrisReq.hostname.includes(":") &&
-            !XyPrisReq.hostname.startsWith("[")) {
-            XyPrisReq.hostname = XyPrisReq.hostname.split(":")[0];
-        }
-        else if (XyPrisReq.hostname.startsWith("[") &&
-            XyPrisReq.hostname.includes("]:")) {
-            XyPrisReq.hostname = XyPrisReq.hostname.substring(1, XyPrisReq.hostname.indexOf("]"));
-        }
-    }
-    getProtocol(req) {
-        const proto = this.getFirstHeaderValue(req.headers["x-forwarded-proto"]);
-        if (proto) {
-            return proto.toLowerCase();
-        }
-        return req.socket?.encrypted ? "https" : "http";
-    }
-    getFirstHeaderValue(header) {
-        if (!header)
-            return undefined;
-        const value = Array.isArray(header) ? header[0] : header;
-        const commaIndex = value.indexOf(",");
-        return commaIndex === -1
-            ? value.trim()
-            : value.substring(0, commaIndex).trim();
-    }
-    /**
-     * 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.
-     */
-    _attachExpressLikeProperties(req, XyPrisReq) {
-        const cookieHeader = req.headers.cookie;
-        XyPrisReq.cookies = cookieHeader ? this.parseCookies(cookieHeader) : {};
-        XyPrisReq.subdomains = this._extractSubdomains(XyPrisReq.hostname);
-        XyPrisReq.fresh = false;
-        XyPrisReq.stale = true;
-        XyPrisReq.xhr = this._isXmlHttpRequest(req);
-    }
-    /**
-     * 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.
-     */
-    _extractSubdomains(hostname) {
-        if (!hostname)
-            return [];
-        const parts = hostname.split(".");
-        // If fewer than 3 parts, there are no subdomains (e.g., example.com)
-        if (parts.length <= 2)
-            return [];
-        // Returns all parts except the last two (TLD + domain)
-        return parts.slice(0, -2);
-    }
-    /**
-     * 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.
-     */
-    _isXmlHttpRequest(req) {
-        const header = req.headers["x-requested-with"];
-        return header === RequestEnhancer.XMLHTTP_REQUEST;
-    }
-    /**
-     * 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.
-     */
-    _attachUtilityMethods(req, XyPrisReq) {
-        XyPrisReq.get = this._createGetHeaderMethod(req);
-    }
-    /**
-     * 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.
-     */
-    _createGetHeaderMethod(req) {
-        return (name) => {
-            const headerName = name.toLowerCase();
-            const value = req.headers[headerName];
-            if (Array.isArray(value)) {
-                return value.length > 0 ? value[0] : undefined;
-            }
-            return value;
-        };
-    }
-}
-// Cache for performance optimization
-RequestEnhancer.DEFAULT_HOST = "localhost";
-RequestEnhancer.DEFAULT_PATHNAME = "/";
-RequestEnhancer.COOKIE_SEPARATOR = ";";
-RequestEnhancer.XMLHTTP_REQUEST = "XMLHttpRequest";
-//# sourceMappingURL=RequestEnhancer.js.map

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

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

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

@@ -1,323 +0,0 @@
-/***************************************************************************
- * 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.
- *
- ***************************************************************************** */
-/// <reference types="node" />
-/// <reference types="node/http" />
-/// <reference types="csrf-csrf" />
-import type { ServerResponse } from "http";
-import { XyPrisResponse, XyPrisRequest } from "../../types/httpServer.type";
-import { Logger } from "../../shared/logger/Logger";
-/**
- * ResponseEnhancer - Enhances the standard Node.js ServerResponse with Express-like utility methods.
- *
- * This class is responsible for decorating the raw HTTP response object with a more
- * developer-friendly API, including methods for sending JSON, setting cookies,
- * handling redirects, and managing headers. It is optimized for performance
- * using private method factories and internal caching.
- */
-export declare class ResponseEnhancer {
-    private logger;
-    private static readonly SAFE_STRING_REGEX;
-    private static readonly COOKIE_NAME_REGEX;
-    constructor(logger: Logger);
-    /**
-     * Enhances a standard Node.js ServerResponse object by injecting XyPris-specific methods.
-     *
-     * This method performs a functional decoration of the response object, binding
-     * new methods to it while preserving the original context. It also initializes
-     * the `locals` object for storing request-scoped data.
-     *
-     * @param res - The original Node.js ServerResponse object.
-     * @param req - The enhanced XyPrisRequest object (used for logging and context).
-     * @returns The enhanced XyPrisResponse object.
-     */
-    enhance(res: ServerResponse, req: XyPrisRequest): XyPrisResponse;
-    /**
-     * Checks if the response has already been sent or ended.
-     *
-     * This is a safety check to prevent "Headers already sent" errors or attempts
-     * to write to a closed stream. If the response is ended, an error is logged
-     * with the context of the attempted operation.
-     *
-     * @param res - The response object to check.
-     * @param req - The request object for logging context.
-     * @param methodName - The name of the method that attempted to send data.
-     * @returns True if the response is already ended, false otherwise.
-     */
-    private _isResponseEnded;
-    /**
-     * Creates the `res.json()` method for the response object.
-     *
-     * The generated method serializes the provided data to JSON, sets the
-     * `Content-Type` header to `application/json`, and ends the response.
-     * It includes robust error handling for serialization failures.
-     *
-     * @param res - The response object to bind the method to.
-     * @param req - The request object for context.
-     * @returns A function that handles JSON responses.
-     */
-    private _createJsonMethod;
-    /**
-     * Creates the `res.success()` method for the response object.
-     *
-     * @param res - The response object to bind the method to.
-     * @param req - The request object for context.
-     * @returns A function that handles success responses.
-     */
-    private _createSuccessMethod;
-    /**
-     * Creates the `res.html()` method for the response object.
-     *
-     * The generated method sets the `Content-Type` header to `text/html; charset=utf-8`
-     * and ends the response with the provided HTML string.
-     *
-     * @param res - The response object to bind the method to.
-     * @param req - The request object for context.
-     * @returns A function that handles HTML responses.
-     */
-    private _createHtmlMethod;
-    /**
-     * Performs safe JSON serialization with error handling and support for special types.
-     *
-     * This method is optimized to quickly handle primitive types and uses a
-     * custom replacer for complex objects to handle circular references,
-     * Errors, and BigInt values.
-     *
-     * @param data - The data to serialize.
-     * @returns The JSON string representation of the data.
-     */
-    private _safeJsonStringify;
-    /**
-     * A custom replacer function for `JSON.stringify` to handle non-standard types.
-     *
-     * - Converts `Error` objects into a serializable format (name, message, stack).
-     * - Converts `BigInt` values to strings to prevent serialization errors.
-     * - Prevents potential issues with circular references in specific types.
-     *
-     * @param key - The key being serialized.
-     * @param value - The value being serialized.
-     * @returns The serializable version of the value.
-     */
-    private _jsonReplacer;
-    /**
-     * Creates the `res.send()` method for the response object.
-     *
-     * This method is polymorphic:
-     * - If the data is an object or array (and not a Buffer), it calls `res.json()`.
-     * - Otherwise, it converts the data to a string or Buffer and sends it.
-     *
-     * @param res - The response object to bind the method to.
-     * @param req - The request object for context.
-     * @returns A function that handles general data responses.
-     */
-    private _createSendMethod;
-    /**
-     * Creates the `res.sendFile()` method for the response object.
-     *
-     * Streams the content of a file to the client with appropriate MIME types.
-     *
-     * @param res - The response object to bind the method to.
-     * @param req - The request object for context.
-     * @returns A function that handles file streaming responses.
-     */
-    private _createSendFileMethod;
-    /**
-     * Determines if the provided data should be treated as JSON.
-     *
-     * Returns true for objects and arrays, excluding `null` and `Buffer` objects.
-     *
-     * @param data - The data to inspect.
-     * @returns True if the data is JSON-serializable, false otherwise.
-     */
-    private _isJsonData;
-    /**
-     * Safely converts any data type to a string representation for HTTP transmission.
-     *
-     * - Returns an empty string for `null` or `undefined`.
-     * - Converts `Buffer` to string using default encoding.
-     * - Uses `String()` for all other types.
-     *
-     * @param data - The data to convert.
-     * @returns The string representation of the data.
-     */
-    private _convertToString;
-    /**
-     * Creates the `res.status()` method for the response object.
-     *
-     * Sets the HTTP status code for the response. This method is chainable,
-     * allowing for patterns like `res.status(201).send(...)`.
-     *
-     * @param res - The response object to bind the method to.
-     * @returns A function that sets the status code and returns the response object.
-     */
-    private _createStatusMethod;
-    /**
-     * Validates if a number is a valid HTTP status code.
-     *
-     * A valid status code must be an integer between 100 and 599 (inclusive).
-     *
-     * @param code - The status code to validate.
-     * @returns True if the code is valid, false otherwise.
-     */
-    private _isValidStatusCode;
-    /**
-     * Creates an enhanced `res.setHeader()` method.
-     *
-     * This version adds safety checks to ensure headers are not set after
-     * they have already been sent to the client, and validates the header name.
-     *
-     * @param res - The response object to bind the method to.
-     * @returns A function that safely sets a response header.
-     */
-    private _createSetHeaderMethod;
-    /**
-     * Validates a header name for basic compliance.
-     *
-     * Ensures the name is a non-empty string.
-     *
-     * @param name - The header name to validate.
-     * @returns True if the name is valid, false otherwise.
-     */
-    private _isValidHeaderName;
-    /**
-     * Creates the `res.set()` method (Express-compatible).
-     *
-     * This method allows setting headers in two ways:
-     * 1. Providing a field name and a value.
-     * 2. Providing an object containing multiple field-value pairs.
-     *
-     * @param res - The response object to bind the method to.
-     * @returns A function that sets one or more headers.
-     */
-    private _createSetMethod;
-    /**
-     * Checks if a value is a plain JavaScript object.
-     *
-     * A plain object is one created by `{}` or `new Object()`, and is not
-     * an array, null, or a class instance.
-     *
-     * @param obj - The value to check.
-     * @returns True if it's a plain object, false otherwise.
-     */
-    private _isPlainObject;
-    /**
-     * Sets multiple headers at once from a key-value object.
-     *
-     * Iterates through the object entries and calls `res.setHeader` for each
-     * valid header name.
-     *
-     * @param res - The response object.
-     * @param headers - An object containing header names and values.
-     */
-    private _setMultipleHeaders;
-    /**
-     * Creates the `res.redirect()` method for the response object.
-     *
-     * Redirects the client to a specified URL with an optional status code.
-     * If no status code is provided, it defaults to 302 (Found).
-     *
-     * @param res - The response object to bind the method to.
-     * @returns A function that performs an HTTP redirection.
-     */
-    private _createRedirectMethod;
-    /**
-     * Validates a redirection URL.
-     *
-     * Ensures the URL is a non-empty string.
-     *
-     * @param url - The URL to validate.
-     * @returns True if the URL is valid, false otherwise.
-     */
-    private _isValidRedirectUrl;
-    /**
-     * Creates the `res.cookie()` method for the response object.
-     *
-     * Sets a cookie by adding a `Set-Cookie` header. Supports various options
-     * such as `maxAge`, `expires`, `httpOnly`, `secure`, `path`, `domain`, and `sameSite`.
-     *
-     * @param res - The response object to bind the method to.
-     * @returns A function that sets a cookie.
-     */
-    private _createCookieMethod;
-    /**
-     * Validates a cookie name against RFC 6265 specifications.
-     *
-     * Ensures the name is a non-empty string and contains only allowed characters.
-     *
-     * @param name - The cookie name to validate.
-     * @returns True if the name is valid, false otherwise.
-     */
-    private _isValidCookieName;
-    /**
-     * Constructs a formatted `Set-Cookie` header string based on the provided options.
-     *
-     * This method handles the serialization of cookie attributes like Expires,
-     * Max-Age, Domain, Path, Secure, HttpOnly, and SameSite.
-     *
-     * @param name - The name of the cookie.
-     * @param value - The value of the cookie (will be URI encoded).
-     * @param options - Configuration options for the cookie.
-     * @returns A fully formatted cookie string.
-     */
-    private _buildCookieString;
-    /**
-     * Builds the `SameSite` attribute string for a cookie.
-     *
-     * Supports standard values: Lax, Strict, and None.
-     *
-     * @param sameSite - The SameSite value or boolean.
-     * @returns The formatted `SameSite=Value` string.
-     */
-    private _buildSameSiteAttribute;
-    /**
-     * Appends a new cookie string to the `Set-Cookie` header.
-     *
-     * If headers already contain one or more cookies, the new one is appended
-     * to the array to ensure all cookies are sent to the client.
-     *
-     * @param res - The response object.
-     * @param cookieString - The formatted cookie string to append.
-     */
-    private _appendCookie;
-    /**
-     * Creates the `res.clearCookie()` method for the response object.
-     *
-     * Clears a cookie by setting its expiration date to the past and
-     * its `maxAge` to 0.
-     *
-     * @param res - The response object to bind the method to.
-     * @returns A function that clears a specific cookie.
-     */
-    private _createClearCookieMethod;
-    /**
-     * Creates the `res.get()` method for retrieving response headers.
-     *
-     * This provides Express compatibility for accessing headers that have
-     * already been set on the response object.
-     *
-     * @param res - The response object to bind the method to.
-     * @returns A function that retrieves a header value by name.
-     */
-    private _createGetMethod;
-}
-//# sourceMappingURL=ResponseEnhancer.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"ResponseEnhancer.d.ts","sourceRoot":"","sources":["../../../../src/server/core/ResponseEnhancer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;iFAsBiF;;;;AAEjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAGpD;;;;;;;GAOG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,MAAM,CAAS;IAGvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAe;IACxD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAA6B;gBAE1D,MAAM,EAAE,MAAM;IAI1B;;;;;;;;;;OAUG;IACI,OAAO,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,aAAa,GAAG,cAAc;IA0BvE;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,gBAAgB;IAexB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,iBAAiB;IA2BzB;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAO5B;;;;;;;;;OASG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;;;;;;;;OASG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,aAAa;IAkBrB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;;;;;;;OAQG;IACH,OAAO,CAAC,qBAAqB;IAY7B;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW;IAOnB;;;;;;;;;OASG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;;;;;;;OAQG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;;;;;;;OAQG;IACH,OAAO,CAAC,sBAAsB;IAsB9B;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;;;;;;;;OASG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;;;;;;;OAQG;IACH,OAAO,CAAC,cAAc;IAStB;;;;;;;;OAQG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;;;;;;;OAQG;IACH,OAAO,CAAC,qBAAqB;IAuB7B;;;;;;;OAOG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;;;;;;;OAQG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,kBAAkB;IA+B1B;;;;;;;OAOG;IACH,OAAO,CAAC,uBAAuB;IAgB/B;;;;;;;;OAQG;IACH,OAAO,CAAC,aAAa;IAerB;;;;;;;;OAQG;IACH,OAAO,CAAC,wBAAwB;IAUhC;;;;;;;;OAQG;IACH,OAAO,CAAC,gBAAgB;CAK3B"}