xypriss 9.11.13 → 9.12.0

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

@@ -0,0 +1,578 @@
+/***************************************************************************
+ * 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 { SendFileHandler } from "./SendFileHandler";
+/**
+ * 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 class ResponseEnhancer {
+    constructor(logger) {
+        this.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, req) {
+        const XyPrisRes = res;
+        XyPrisRes.locals = {};
+        // Inject professional branding headers immediately
+        // XyPrisRes.setHeader("Server", "XyPriss/XHSC");
+        // XyPrisRes.setHeader("X-XyPriss-Runtime", "XHSC-G4 (Hyper-System Core)");
+        // XyPrisRes.setHeader("X-Powered-By", "XyPriss");
+        // Bind methods to preserve context
+        XyPrisRes.json = this._createJsonMethod(XyPrisRes, req);
+        XyPrisRes.html = this._createHtmlMethod(XyPrisRes, req);
+        XyPrisRes.send = this._createSendMethod(XyPrisRes, req);
+        XyPrisRes.sendFile = this._createSendFileMethod(XyPrisRes, req);
+        XyPrisRes.status = this._createStatusMethod(XyPrisRes);
+        XyPrisRes.setHeader = this._createSetHeaderMethod(XyPrisRes);
+        XyPrisRes.set = this._createSetMethod(XyPrisRes);
+        XyPrisRes.redirect = this._createRedirectMethod(XyPrisRes);
+        XyPrisRes.cookie = this._createCookieMethod(XyPrisRes);
+        XyPrisRes.clearCookie = this._createClearCookieMethod(XyPrisRes);
+        XyPrisRes.get = this._createGetMethod(XyPrisRes);
+        XyPrisRes.success = this._createSuccessMethod(XyPrisRes, req);
+        return XyPrisRes;
+    }
+    /**
+     * 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.
+     */
+    _isResponseEnded(res, req, methodName) {
+        if (res.writableEnded) {
+            this.logger.error("server", `[HttpServer] ${methodName} called after response already finished (${req.method} ${req.path}).`);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * 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.
+     */
+    _createJsonMethod(res, req) {
+        return (data) => {
+            if (this._isResponseEnded(res, req, "res.json()"))
+                return;
+            try {
+                const jsonData = this._safeJsonStringify(data);
+                res.setHeader("Content-Type", "application/json");
+                res.setHeader("Server", "XyPriss/XHSC");
+                res.setHeader("X-Runtime", "XyPriss - Hyper-System Core (XHSC)");
+                res.setHeader("X-Powered-By", "XyPriss");
+                res.end(jsonData);
+            }
+            catch (error) {
+                this.logger.error("server", `[HttpServer] Failed to stringify JSON: ${error instanceof Error ? error.message : String(error)}`);
+                res.statusCode = 500;
+                res.end('{"error":"Internal Server Error"}');
+            }
+        };
+    }
+    /**
+     * 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.
+     */
+    _createSuccessMethod(res, req) {
+        return (message, data) => {
+            if (this._isResponseEnded(res, req, "res.success()"))
+                return;
+            res.json({ success: true, message, data });
+        };
+    }
+    /**
+     * 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.
+     */
+    _createHtmlMethod(res, req) {
+        return (htmlString) => {
+            if (this._isResponseEnded(res, req, "res.html()"))
+                return;
+            res.setHeader("Content-Type", "text/html; charset=utf-8");
+            // res.setHeader("Server", "XyPriss/XHSC");
+            // res.setHeader("X-Runtime", "XyPriss - Hyper-System Core (XHSC)");
+            // res.setHeader("X-Powered-By", "XyPriss");
+            res.end(htmlString);
+        };
+    }
+    /**
+     * 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.
+     */
+    _safeJsonStringify(data) {
+        // Fast detection for primitive and null types
+        if (data === null)
+            return "null";
+        if (data === undefined)
+            return "null";
+        const type = typeof data;
+        if (type === "string" || type === "number" || type === "boolean") {
+            return JSON.stringify(data);
+        }
+        // Handle complex objects and arrays
+        return JSON.stringify(data, this._jsonReplacer);
+    }
+    /**
+     * 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.
+     */
+    _jsonReplacer(key, value) {
+        // Handle Error objects which are not natively serializable
+        if (value instanceof Error) {
+            return {
+                name: value.name,
+                message: value.message,
+                stack: value.stack,
+            };
+        }
+        // Convert BigInt to string as JSON does not support BigInt
+        if (typeof value === "bigint") {
+            return value.toString();
+        }
+        return value;
+    }
+    /**
+     * 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.
+     */
+    _createSendMethod(res, req) {
+        return (data) => {
+            if (this._isResponseEnded(res, req, "res.send()"))
+                return;
+            if (this._isJsonData(data)) {
+                res.json(data);
+            }
+            else {
+                res.end(this._convertToString(data));
+            }
+        };
+    }
+    /**
+     * 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.
+     */
+    _createSendFileMethod(res, req) {
+        return async (filePath, options) => {
+            if (this._isResponseEnded(res, req, "res.sendFile()"))
+                return;
+            // Lazy load the handler to prevent circular references and fast tracking
+            const sfh = new SendFileHandler(res, this.logger);
+            await sfh.handle(filePath, options);
+        };
+    }
+    /**
+     * 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.
+     */
+    _isJsonData(data) {
+        if (data === null || data === undefined)
+            return false;
+        const type = typeof data;
+        return type === "object" && !Buffer.isBuffer(data);
+    }
+    /**
+     * 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.
+     */
+    _convertToString(data) {
+        if (data === null || data === undefined)
+            return "";
+        if (Buffer.isBuffer(data))
+            return data.toString();
+        return String(data);
+    }
+    /**
+     * 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.
+     */
+    _createStatusMethod(res) {
+        return (code) => {
+            if (this._isValidStatusCode(code)) {
+                res.statusCode = code;
+            }
+            return res;
+        };
+    }
+    /**
+     * 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.
+     */
+    _isValidStatusCode(code) {
+        return Number.isInteger(code) && (code === 0 || (code >= 100 && code < 600));
+    }
+    /**
+     * 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.
+     */
+    _createSetHeaderMethod(res) {
+        const originalSetHeader = res.setHeader.bind(res);
+        return (name, value) => {
+            if (!res.headersSent && this._isValidHeaderName(name)) {
+                try {
+                    originalSetHeader(name, value);
+                }
+                catch (error) {
+                    this.logger.error("server", `[HttpServer] Failed to set header "${name}": ${error instanceof Error
+                        ? error.message
+                        : String(error)}`);
+                }
+            }
+            return res;
+        };
+    }
+    /**
+     * 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.
+     */
+    _isValidHeaderName(name) {
+        return typeof name === "string" && name.length > 0;
+    }
+    /**
+     * 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.
+     */
+    _createSetMethod(res) {
+        return (field, value) => {
+            if (typeof field === "string" && value !== undefined) {
+                res.setHeader(field, value);
+            }
+            else if (this._isPlainObject(field)) {
+                this._setMultipleHeaders(res, field);
+            }
+            return res;
+        };
+    }
+    /**
+     * 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.
+     */
+    _isPlainObject(obj) {
+        return (obj !== null &&
+            typeof obj === "object" &&
+            !Array.isArray(obj) &&
+            Object.getPrototypeOf(obj) === Object.prototype);
+    }
+    /**
+     * 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.
+     */
+    _setMultipleHeaders(res, headers) {
+        const entries = Object.entries(headers);
+        for (let i = 0; i < entries.length; i++) {
+            const [key, val] = entries[i];
+            if (this._isValidHeaderName(key)) {
+                res.setHeader(key, val);
+            }
+        }
+    }
+    /**
+     * 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.
+     */
+    _createRedirectMethod(res) {
+        return (statusOrUrl, url) => {
+            let redirectUrl;
+            let statusCode;
+            if (typeof statusOrUrl === "number" && url) {
+                statusCode = this._isValidStatusCode(statusOrUrl)
+                    ? statusOrUrl
+                    : 302;
+                redirectUrl = url;
+            }
+            else {
+                statusCode = 302;
+                redirectUrl = statusOrUrl;
+            }
+            if (this._isValidRedirectUrl(redirectUrl)) {
+                res.statusCode = statusCode;
+                res.setHeader("Location", redirectUrl);
+            }
+            res.end();
+        };
+    }
+    /**
+     * 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.
+     */
+    _isValidRedirectUrl(url) {
+        return typeof url === "string" && url.length > 0;
+    }
+    /**
+     * 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.
+     */
+    _createCookieMethod(res) {
+        return (name, value, options = {}) => {
+            if (!this._isValidCookieName(name)) {
+                this.logger.error("server", `[HttpServer] Invalid cookie name: ${name}`);
+                return;
+            }
+            const cookieString = this._buildCookieString(name, value, options);
+            this._appendCookie(res, cookieString);
+        };
+    }
+    /**
+     * 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.
+     */
+    _isValidCookieName(name) {
+        return (typeof name === "string" &&
+            name.length > 0 &&
+            ResponseEnhancer.COOKIE_NAME_REGEX.test(name));
+    }
+    /**
+     * 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.
+     */
+    _buildCookieString(name, value, options) {
+        const parts = [`${name}=${encodeURIComponent(value)}`];
+        if (options.maxAge !== undefined) {
+            parts.push(`Max-Age=${options.maxAge}`);
+        }
+        if (options.expires instanceof Date) {
+            parts.push(`Expires=${options.expires.toUTCString()}`);
+        }
+        if (options.httpOnly)
+            parts.push("HttpOnly");
+        if (options.secure)
+            parts.push("Secure");
+        parts.push(`Path=${options.path || "/"}`);
+        if (options.domain) {
+            parts.push(`Domain=${options.domain}`);
+        }
+        if (options.sameSite) {
+            parts.push(this._buildSameSiteAttribute(options.sameSite));
+        }
+        return parts.join("; ");
+    }
+    /**
+     * 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.
+     */
+    _buildSameSiteAttribute(sameSite) {
+        const value = typeof sameSite === "string" ? sameSite.toLowerCase() : sameSite;
+        switch (value) {
+            case "lax":
+                return "SameSite=Lax";
+            case "strict":
+                return "SameSite=Strict";
+            case "none":
+                return "SameSite=None";
+            default:
+                return `SameSite=${sameSite}`;
+        }
+    }
+    /**
+     * 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.
+     */
+    _appendCookie(res, cookieString) {
+        const existing = res.getHeader("Set-Cookie");
+        let cookiesArray;
+        if (!existing) {
+            cookiesArray = [cookieString];
+        }
+        else if (Array.isArray(existing)) {
+            cookiesArray = [...existing, cookieString];
+        }
+        else {
+            cookiesArray = [String(existing), cookieString];
+        }
+        res.setHeader("Set-Cookie", cookiesArray);
+    }
+    /**
+     * 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.
+     */
+    _createClearCookieMethod(res) {
+        return (name, options = {}) => {
+            res.cookie(name, "", {
+                ...options,
+                maxAge: 0,
+                expires: new Date(0),
+            });
+        };
+    }
+    /**
+     * 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.
+     */
+    _createGetMethod(res) {
+        return (name) => {
+            return res.getHeader(name);
+        };
+    }
+}
+// Cache for frequently used regular expressions to optimize performance
+ResponseEnhancer.SAFE_STRING_REGEX = /^[\w\-]+$/;
+ResponseEnhancer.COOKIE_NAME_REGEX = /^[\w!#$%&'*+\-.^_`|~]+$/;
+//# sourceMappingURL=ResponseEnhancer.js.map

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

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

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

@@ -0,0 +1,12 @@
+import { Logger } from "../../shared/logger/Logger";
+import { SendFileOptions, XyPrisResponse } from "../../types/httpServer.type";
+export declare class SendFileHandler {
+    private res;
+    private logger?;
+    constructor(res: XyPrisResponse, logger?: Logger);
+    handle(filePath: string, options?: SendFileOptions): Promise<void>;
+    private _streamFile;
+    static registerMimeTypes(types: Record<string, string>): void;
+    static getMimeType(ext: string): string;
+}
+//# sourceMappingURL=SendFileHandler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SendFileHandler.d.ts","sourceRoot":"","sources":["../../../../src/server/core/SendFileHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAc9E,qBAAa,eAAe;IACxB,OAAO,CAAC,GAAG,CAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,CAAS;gBAEZ,GAAG,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,MAAM;IAKnC,MAAM,CACf,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,eAAoB,GAC9B,OAAO,CAAC,IAAI,CAAC;IAoEhB,OAAO,CAAC,WAAW;WAKL,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;WAItD,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAGjD"}