xypriss 9.11.13 → 9.12.0

package/dist/src/server/utils/WorkerModeHandler.js

@@ -0,0 +1,60 @@
+import { Logger } from "../../shared/logger/Logger";
+/**
+ * Handle worker mode configuration automatically
+ * This function makes clustering transparent to developers
+ */
+export function handleWorkerMode(options) {
+    // Check if running in worker mode
+    if (process.env.XYPRISS_CLUSTER_MODE !== "true") {
+        return options; // Not a worker, return original options
+    }
+    // Worker mode detected - merge configuration from environment
+    let finalOptions = options;
+    if (process.env.XYPRISS_SERVER_CONFIG) {
+        try {
+            const workerConfig = JSON.parse(process.env.XYPRISS_SERVER_CONFIG);
+            // Merge worker configuration with provided options
+            // Worker-specific overrides take precedence
+            finalOptions = {
+                ...workerConfig,
+                ...options,
+                server: {
+                    ...workerConfig.server,
+                    ...options.server,
+                    // Use worker-specific port if provided
+                    port: process.env.WORKER_PORT
+                        ? parseInt(process.env.WORKER_PORT)
+                        : options.server?.port || workerConfig.server?.port,
+                },
+                // Disable clustering in worker processes to prevent recursive clustering
+                cluster: {
+                    ...workerConfig.cluster,
+                    enabled: false,
+                },
+            };
+            // Debug logging for development
+            if (process.env.NODE_ENV === "development") {
+                const logger = Logger.getInstance();
+                logger.info("cluster", `Worker ${process.env.WORKER_ID} initialized with port ${finalOptions.server?.port}`);
+            }
+        }
+        catch (error) {
+            const logger = Logger.getInstance();
+            logger.error("cluster", "Failed to parse worker configuration", error);
+            // Fall back to original options but disable clustering
+            finalOptions = {
+                ...options,
+                cluster: { ...options.cluster, enabled: false },
+            };
+        }
+    }
+    else {
+        // No worker config found, disable clustering to prevent issues
+        finalOptions = {
+            ...options,
+            cluster: { ...options.cluster, enabled: false },
+        };
+    }
+    return finalOptions;
+}
+//# sourceMappingURL=WorkerModeHandler.js.map

package/dist/src/server/utils/WorkerModeHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerModeHandler.js","sourceRoot":"","sources":["../../../../src/server/utils/WorkerModeHandler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEpD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAsB;IACnD,kCAAkC;IAClC,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,MAAM,EAAE,CAAC;QAC9C,OAAO,OAAO,CAAC,CAAC,wCAAwC;IAC5D,CAAC;IAED,8DAA8D;IAC9D,IAAI,YAAY,GAAG,OAAO,CAAC;IAE3B,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,CAAC;QACpC,IAAI,CAAC;YACD,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;YAEnE,mDAAmD;YACnD,4CAA4C;YAC5C,YAAY,GAAG;gBACX,GAAG,YAAY;gBACf,GAAG,OAAO;gBACV,MAAM,EAAE;oBACJ,GAAG,YAAY,CAAC,MAAM;oBACtB,GAAG,OAAO,CAAC,MAAM;oBACjB,uCAAuC;oBACvC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW;wBACzB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;wBACnC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,IAAI,YAAY,CAAC,MAAM,EAAE,IAAI;iBAC1D;gBACD,yEAAyE;gBACzE,OAAO,EAAE;oBACL,GAAG,YAAY,CAAC,OAAO;oBACvB,OAAO,EAAE,KAAK;iBACjB;aACJ,CAAC;YAEF,gCAAgC;YAChC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;gBACzC,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;gBACpC,MAAM,CAAC,IAAI,CACP,SAAS,EACT,UAAU,OAAO,CAAC,GAAG,CAAC,SAAS,0BAA0B,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,CACvF,CAAC;YACN,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;YACpC,MAAM,CAAC,KAAK,CACR,SAAS,EACT,sCAAsC,EACtC,KAAK,CACR,CAAC;YACF,uDAAuD;YACvD,YAAY,GAAG;gBACX,GAAG,OAAO;gBACV,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE;aAClD,CAAC;QACN,CAAC;IACL,CAAC;SAAM,CAAC;QACJ,+DAA+D;QAC/D,YAAY,GAAG;YACX,GAAG,OAAO;YACV,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE;SAClD,CAAC;IACN,CAAC;IAED,OAAO,YAAY,CAAC;AACxB,CAAC"}

package/dist/src/server/utils/es_modules.d.ts

@@ -0,0 +1,3 @@
+export declare const __filename__: any;
+export declare const __dirname__: any;
+//# sourceMappingURL=es_modules.d.ts.map

package/dist/src/server/utils/es_modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"es_modules.d.ts","sourceRoot":"","sources":["../../../../src/server/utils/es_modules.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,KAAiC,CAAC;AAC3D,eAAO,MAAM,WAAW,KAAwB,CAAC"}

package/dist/src/server/utils/es_modules.js

@@ -0,0 +1,5 @@
+import { fileURLToPath } from "url";
+import { dirname } from "path";
+export const __filename__ = fileURLToPath(import.meta.url);
+export const __dirname__ = dirname(__filename__);
+//# sourceMappingURL=es_modules.js.map

package/dist/src/server/utils/es_modules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"es_modules.js","sourceRoot":"","sources":["../../../../src/server/utils/es_modules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC"}

package/dist/src/server/utils/forceClosePort.d.ts

@@ -0,0 +1,100 @@
+export declare class Port {
+    private logger;
+    private port;
+    private execAsync;
+    private readonly MAX_RETRIES;
+    private readonly RETRY_DELAY;
+    private readonly PORT_FREE_WAIT;
+    constructor(port: number);
+    /**
+     * Attempt to forcefully close/free up the specified port
+     * @returns Promise<boolean> - true if successful, false if failed
+     */
+    forceClosePort(): Promise<boolean>;
+    /**
+     * Validates that the port number is within valid range
+     * @param port - The port number to validate
+     * @returns The validated port number
+     * @throws Error if port is invalid
+     */
+    private _validatePort;
+    /**
+     * Checks the current status of the port
+     * @returns Promise<PortCheckResult> - Information about port usage
+     */
+    private _checkPortStatus;
+    /**
+     * Gets list of processes using the port
+     * @returns Promise<PortProcess[]> - Array of processes using the port
+     */
+    private _getPortProcesses;
+    /**
+     * Gets processes using the port on Windows
+     * @returns Promise<PortProcess[]> - Array of Windows processes
+     */
+    private _getWindowsPortProcesses;
+    /**
+     * Gets processes using the port on Unix-like systems
+     * @returns Promise<PortProcess[]> - Array of Unix processes
+     */
+    private _getUnixPortProcesses;
+    /**
+     * Kills all processes using the port
+     * @param processes - Array of processes to kill
+     * @returns Promise<boolean> - true if all processes were handled successfully
+     */
+    private _killPortProcesses;
+    /**
+     * Kills a single process
+     * @param process - The process to kill
+     * @returns Promise<boolean> - true if successful or process no longer exists
+     */
+    private _killSingleProcess;
+    /**
+     * Executes a command with retry logic
+     * @param command - Command to execute
+     * @returns Promise with command result
+     */
+    private _executeWithRetry;
+    /**
+     * Waits for the port to be freed
+     */
+    private _waitForPortFree;
+    /**
+     * Verifies that the port is now free
+     * @returns Promise<boolean> - true if port is free
+     */
+    private _verifyPortIsFree;
+    /**
+     * Checks if a process still exists
+     * @param pid - Process ID to check
+     * @returns Promise<boolean> - true if process exists
+     */
+    private _processExists;
+    /**
+     * Checks if the address exactly matches our port
+     * @param address - Network address string (e.g., "0.0.0.0:3000")
+     * @param port - Port number to match
+     * @returns boolean - true if exact match
+     */
+    private _isExactPortMatch;
+    /**
+     * Extracts protocol information from lsof output
+     * @param lsofOutput - Output from lsof command
+     * @returns string - Protocol type
+     */
+    private _extractProtocolFromLsof;
+    /**
+     * Determines if error indicates process is already gone
+     * @param errorMessage - Error message to check
+     * @returns boolean - true if process no longer exists
+     */
+    private _isProcessAlreadyGoneError;
+    /**
+     * Determines if error indicates process is protected
+     * @param errorMessage - Error message to check
+     * @returns boolean - true if process is protected
+     */
+    private _isProcessProtectedError;
+}
+//# sourceMappingURL=forceClosePort.d.ts.map

package/dist/src/server/utils/forceClosePort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forceClosePort.d.ts","sourceRoot":"","sources":["../../../../src/server/utils/forceClosePort.ts"],"names":[],"mappings":"AAeA,qBAAa,IAAI;IACb,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,SAAS,CAEgC;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAK;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAO;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;gBAE3B,IAAI,EAAE,MAAM;IAMxB;;;OAGG;IACU,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAgD/C;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IASrB;;;OAGG;YACW,gBAAgB;IAgB9B;;;OAGG;YACW,iBAAiB;IAU/B;;;OAGG;YACW,wBAAwB;IAqCtC;;;OAGG;YACW,qBAAqB;IAyCnC;;;;OAIG;YACW,kBAAkB;IAehC;;;;OAIG;YACW,kBAAkB;IAuDhC;;;;OAIG;YACW,iBAAiB;IAyB/B;;OAEG;YACW,gBAAgB;IAM9B;;;OAGG;YACW,iBAAiB;IAU/B;;;;OAIG;YACW,cAAc;IAe5B;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;IAMhC;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;IAclC;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;CAWnC"}

package/dist/src/server/utils/forceClosePort.js

@@ -0,0 +1,328 @@
+import { Logger } from "../../shared/logger/Logger";
+import { exec } from "child_process";
+import { promisify } from "util";
+export class Port {
+    constructor(port) {
+        this.MAX_RETRIES = 3;
+        this.RETRY_DELAY = 500;
+        this.PORT_FREE_WAIT = 1000;
+        this.port = this._validatePort(port);
+        this.logger = Logger.getInstance();
+        this.execAsync = promisify(exec);
+    }
+    /**
+     * Attempt to forcefully close/free up the specified port
+     * @returns Promise<boolean> - true if successful, false if failed
+     */
+    async forceClosePort() {
+        try {
+            this.logger.debug("server", `Attempting to force close port ${this.port}...`);
+            // Check if port is actually in use
+            const portCheck = await this._checkPortStatus();
+            if (!portCheck.isInUse) {
+                this.logger.debug("server", `Port ${this.port} is already free`);
+                return true;
+            }
+            // Kill processes using the port
+            const success = await this._killPortProcesses(portCheck.processes);
+            if (!success) {
+                return false;
+            }
+            // Wait for port to be freed
+            await this._waitForPortFree();
+            // Final verification
+            const finalCheck = await this._verifyPortIsFree();
+            if (finalCheck) {
+                this.logger.info("server", `Port ${this.port} is now free`);
+                return true;
+            }
+            else {
+                this.logger.warn("server", `Port ${this.port} may still be in use after cleanup attempt`);
+                return false;
+            }
+        }
+        catch (error) {
+            this.logger.error("server", `Error force closing port ${this.port}:`, error.message);
+            return false;
+        }
+    }
+    /**
+     * Validates that the port number is within valid range
+     * @param port - The port number to validate
+     * @returns The validated port number
+     * @throws Error if port is invalid
+     */
+    _validatePort(port) {
+        if (!Number.isInteger(port) || port < 1 || port > 65535) {
+            throw new Error(`Invalid port number: ${port}. Port must be between 1 and 65535.`);
+        }
+        return port;
+    }
+    /**
+     * Checks the current status of the port
+     * @returns Promise<PortCheckResult> - Information about port usage
+     */
+    async _checkPortStatus() {
+        try {
+            const processes = await this._getPortProcesses();
+            return {
+                isInUse: processes.length > 0,
+                processes,
+            };
+        }
+        catch (error) {
+            this.logger.debug("server", `Error checking port status: ${error.message}`);
+            return { isInUse: false, processes: [] };
+        }
+    }
+    /**
+     * Gets list of processes using the port
+     * @returns Promise<PortProcess[]> - Array of processes using the port
+     */
+    async _getPortProcesses() {
+        const processes = [];
+        if (process.platform === "win32") {
+            return this._getWindowsPortProcesses();
+        }
+        else {
+            return this._getUnixPortProcesses();
+        }
+    }
+    /**
+     * Gets processes using the port on Windows
+     * @returns Promise<PortProcess[]> - Array of Windows processes
+     */
+    async _getWindowsPortProcesses() {
+        const processes = [];
+        try {
+            const { stdout } = await this._executeWithRetry(`netstat -ano | findstr :${this.port}`);
+            const lines = stdout.split("\n").filter((line) => line.trim());
+            for (const line of lines) {
+                const parts = line.trim().split(/\s+/);
+                if (parts.length >= 5) {
+                    const localAddress = parts[1];
+                    const protocol = parts[0];
+                    const state = parts[3];
+                    const pid = parts[4];
+                    // Ensure this is exactly our port (not a port that contains our port number)
+                    if (this._isExactPortMatch(localAddress, this.port) &&
+                        pid &&
+                        pid !== "0") {
+                        processes.push({ pid, protocol, state });
+                    }
+                }
+            }
+        }
+        catch (error) {
+            this.logger.debug("server", `Windows netstat command failed: ${error.message}`);
+        }
+        return processes;
+    }
+    /**
+     * Gets processes using the port on Unix-like systems
+     * @returns Promise<PortProcess[]> - Array of Unix processes
+     */
+    async _getUnixPortProcesses() {
+        const processes = [];
+        try {
+            const { stdout } = await this._executeWithRetry(`lsof -ti:${this.port}`);
+            const pids = stdout
+                .trim()
+                .split("\n")
+                .filter((pid) => pid && pid.trim());
+            for (const pid of pids) {
+                if (pid.trim()) {
+                    // Get additional process info
+                    try {
+                        const { stdout: processInfo } = await this.execAsync(`lsof -p ${pid.trim()} | grep :${this.port}`);
+                        const protocol = this._extractProtocolFromLsof(processInfo);
+                        processes.push({ pid: pid.trim(), protocol });
+                    }
+                    catch {
+                        // Fallback if detailed info fails
+                        processes.push({
+                            pid: pid.trim(),
+                            protocol: "unknown",
+                        });
+                    }
+                }
+            }
+        }
+        catch (error) {
+            this.logger.debug("server", `Unix lsof command failed: ${error.message}`);
+        }
+        return processes;
+    }
+    /**
+     * Kills all processes using the port
+     * @param processes - Array of processes to kill
+     * @returns Promise<boolean> - true if all processes were handled successfully
+     */
+    async _killPortProcesses(processes) {
+        let allSuccessful = true;
+        for (const process of processes) {
+            const success = await this._killSingleProcess(process);
+            if (!success) {
+                allSuccessful = false;
+            }
+        }
+        return allSuccessful;
+    }
+    /**
+     * Kills a single process
+     * @param process - The process to kill
+     * @returns Promise<boolean> - true if successful or process no longer exists
+     */
+    async _killSingleProcess(process) {
+        try {
+            this.logger.debug("server", `Attempting to kill process ${process.pid} (${process.protocol}) using port ${this.port}`);
+            if (globalThis.process.platform === "win32") {
+                await this._executeWithRetry(`taskkill /F /PID ${process.pid}`);
+            }
+            else {
+                // Try graceful kill first, then force kill
+                try {
+                    await this._executeWithRetry(`kill ${process.pid}`);
+                    await new Promise((resolve) => setTimeout(resolve, 500));
+                    // Check if process still exists
+                    const stillExists = await this._processExists(process.pid);
+                    if (stillExists) {
+                        await this._executeWithRetry(`kill -9 ${process.pid}`);
+                    }
+                }
+                catch {
+                    // Fallback to force kill
+                    await this._executeWithRetry(`kill -9 ${process.pid}`);
+                }
+            }
+            this.logger.info("server", `Successfully killed process ${process.pid} using port ${this.port}`);
+            return true;
+        }
+        catch (error) {
+            // Handle common scenarios where process is already gone or protected
+            if (this._isProcessAlreadyGoneError(error.message)) {
+                this.logger.info("server", `Process ${process.pid} using port ${this.port} had already exited`);
+                return true;
+            }
+            else if (this._isProcessProtectedError(error.message)) {
+                this.logger.warn("server", `Process ${process.pid} is protected and cannot be killed`);
+                return false;
+            }
+            else {
+                this.logger.warn("server", `Failed to kill process ${process.pid}: ${error.message}`);
+                return false;
+            }
+        }
+    }
+    /**
+     * Executes a command with retry logic
+     * @param command - Command to execute
+     * @returns Promise with command result
+     */
+    async _executeWithRetry(command) {
+        let lastError;
+        for (let attempt = 1; attempt <= this.MAX_RETRIES; attempt++) {
+            try {
+                return await this.execAsync(command);
+            }
+            catch (error) {
+                lastError = error;
+                if (attempt < this.MAX_RETRIES) {
+                    this.logger.debug("server", `Command failed (attempt ${attempt}/${this.MAX_RETRIES}), retrying: ${command}`);
+                    await new Promise((resolve) => setTimeout(resolve, this.RETRY_DELAY));
+                }
+            }
+        }
+        throw lastError;
+    }
+    /**
+     * Waits for the port to be freed
+     */
+    async _waitForPortFree() {
+        await new Promise((resolve) => setTimeout(resolve, this.PORT_FREE_WAIT));
+    }
+    /**
+     * Verifies that the port is now free
+     * @returns Promise<boolean> - true if port is free
+     */
+    async _verifyPortIsFree() {
+        try {
+            const portCheck = await this._checkPortStatus();
+            return !portCheck.isInUse;
+        }
+        catch (error) {
+            // If check fails, assume port is free (commands typically fail when nothing is using the port)
+            return true;
+        }
+    }
+    /**
+     * Checks if a process still exists
+     * @param pid - Process ID to check
+     * @returns Promise<boolean> - true if process exists
+     */
+    async _processExists(pid) {
+        try {
+            if (process.platform === "win32") {
+                await this.execAsync(`tasklist /FI "PID eq ${pid}" | findstr ${pid}`);
+            }
+            else {
+                await this.execAsync(`kill -0 ${pid}`);
+            }
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Checks if the address exactly matches our port
+     * @param address - Network address string (e.g., "0.0.0.0:3000")
+     * @param port - Port number to match
+     * @returns boolean - true if exact match
+     */
+    _isExactPortMatch(address, port) {
+        const portPattern = new RegExp(`:${port}$`);
+        return portPattern.test(address);
+    }
+    /**
+     * Extracts protocol information from lsof output
+     * @param lsofOutput - Output from lsof command
+     * @returns string - Protocol type
+     */
+    _extractProtocolFromLsof(lsofOutput) {
+        if (lsofOutput.includes("TCP"))
+            return "TCP";
+        if (lsofOutput.includes("UDP"))
+            return "UDP";
+        return "unknown";
+    }
+    /**
+     * Determines if error indicates process is already gone
+     * @param errorMessage - Error message to check
+     * @returns boolean - true if process no longer exists
+     */
+    _isProcessAlreadyGoneError(errorMessage) {
+        const goneIndicators = [
+            "n'a pas pu être arrêté",
+            "could not be terminated",
+            "No such process",
+            "not found",
+            "ERROR: The process",
+        ];
+        return goneIndicators.some((indicator) => errorMessage.toLowerCase().includes(indicator.toLowerCase()));
+    }
+    /**
+     * Determines if error indicates process is protected
+     * @param errorMessage - Error message to check
+     * @returns boolean - true if process is protected
+     */
+    _isProcessProtectedError(errorMessage) {
+        const protectedIndicators = [
+            "Operation not permitted",
+            "Access denied",
+            "insufficient privilege",
+        ];
+        return protectedIndicators.some((indicator) => errorMessage.toLowerCase().includes(indicator.toLowerCase()));
+    }
+}
+//# sourceMappingURL=forceClosePort.js.map

package/dist/src/server/utils/forceClosePort.js.map

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

package/dist/src/server/utils/internalFlagsFunctions.d.ts

@@ -0,0 +1,71 @@
+/***************************************************************************
+ * XyPrissJS - 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 { internalFlags } from "../const/internalFlags.js";
+/**
+ * Attaches an internal framework flag to a server options object,
+ * along with a signed token that authorizes its use.
+ *
+ * This function is **strictly reserved for XyPriss framework internals**.
+ * It must never be called or re-exported by plugin authors or end users.
+ *
+ * The signed token is automatically stripped by `rejectInternalFlag` before
+ * any user-visible processing occurs, so it never leaks into the options
+ * that reach `XyServerCreator.create()`.
+ *
+ * @param options - The base server options to extend
+ * @param flag - The internal flag name to inject (must be in `internalFlags`)
+ * @returns A new options object with the flag and authorization token attached
+ *
+ * @internal
+ * @example
+ * // Used internally in PluginLoader when spawning auxiliary servers:
+ * createServer(withInternalFlag({ server: { port: 5628 } }, "isAuxiliary"));
+ */
+export declare function withInternalFlag(options: Record<string, any>, flag: (typeof internalFlags)[number]): Record<string, any>;
+/**
+ * Validates that no internal-only flags are present in user-supplied options.
+ *
+ * This function acts as a **security gate** at the entry point of `createServer`.
+ * It inspects the incoming options for any flag listed in `internalFlags` and
+ * verifies that a valid framework-issued token accompanies it.
+ *
+ * Behavior:
+ * - If an internal flag is found **with** a valid token → allowed (framework call),
+ *   the token is stripped before further processing.
+ * - If an internal flag is found **without** a valid token → the flag is deleted
+ *   and a fatal `Error` is thrown, terminating server creation.
+ * - If no internal flags are present → no-op, options pass through unchanged.
+ *
+ * After this function runs, the options object is guaranteed to contain no
+ * authorization token, regardless of outcome.
+ *
+ * @param options - The raw server options passed to `createServer`
+ * @throws {Error} If an internal flag is detected without a valid authorization token
+ *
+ * @example
+ * // Called automatically at the top of createServer():
+ * rejectInternalFlag(options); // throws if user injected isAuxiliary
+ */
+export declare function rejectInternalFlag(options: Record<string, any>): void;
+//# sourceMappingURL=internalFlagsFunctions.d.ts.map

package/dist/src/server/utils/internalFlagsFunctions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internalFlagsFunctions.d.ts","sourceRoot":"","sources":["../../../../src/server/utils/internalFlagsFunctions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;iFAsBiF;AAGjF,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AA2C1D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,IAAI,EAAE,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,GACrC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAiBrB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CA0BrE"}