xypriss 9.11.13 → 9.12.0

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

@@ -0,0 +1,182 @@
+import { getSysApi } from "../../plugins/const/getSysApi";
+import { logger } from "../../shared/logger/Logger";
+import { XyPrissFS } from "../../xhsc/System";
+import { __sys__ } from "../../xhsc";
+import { XY_XHSC_REGISTER_FS } from "../../xhsc/api/env/env";
+import { getCallerProjectRoot } from "../../utils/ProjectDiscovery";
+import { ConfigSyntaxParser } from "../../utils/ConfigSyntaxParser";
+import { MetaConfigRunner } from "./MetaConfigRunner";
+import { JsonUtils } from "../../utils/JsonUtils";
+/**
+ * XyPriss Configuration Loader
+ *
+ * Automatically loads configuration from xypriss.config.json
+ * This loader identifies the project root and applies system variables to the global __sys__ object.
+ */
+export class ConfigLoader {
+    constructor() {
+        this.isConfigApplied = false;
+        this.packageJson = null;
+        this.metaRunner = new MetaConfigRunner();
+        this.sys = getSysApi();
+    }
+    /**
+     * Load all xypriss.config.json files found in the project and apply configurations
+     */
+    loadAndApplySysConfig() {
+        if (this.isConfigApplied)
+            return;
+        this.isConfigApplied = true;
+        const root = getCallerProjectRoot() || __sys__.__root__;
+        logger.debug("server", `ConfigLoader: Initializing discovery from root: ${root}`);
+        const configFiles = [];
+        // Only look for config at the absolute project root (preferring .jsonc)
+        for (const name of ["xypriss.config.jsonc", "xypriss.config.json"]) {
+            const potentialConfig = this.sys.path.join(root, name);
+            if (this.sys.fs.exist(potentialConfig)) {
+                logger.debug("server", `ConfigLoader: Found configuration file: ${potentialConfig}`);
+                configFiles.push(potentialConfig);
+                break; // Stop after first match in root
+            }
+        }
+        if (configFiles.length === 0) {
+            logger.debug("server", `ConfigLoader: No configuration file found in ${root}`);
+        }
+        // Process only the root configuration
+        for (const configPath of configFiles) {
+            this.applyConfigFromFile(configPath, root);
+        }
+        // Final meta search from root
+        this.metaRunner.executeMetaConfig(root);
+    }
+    /**
+     * Apply configuration from a specific file
+     */
+    applyConfigFromFile(configPath, projectRoot) {
+        const configDir = this.sys.path.dirname(configPath);
+        if (!this.sys.fs.exist(configPath))
+            return;
+        const rawContent = this.sys.fs.readSync(configPath);
+        const rawConfig = JsonUtils.parse(rawContent);
+        // Load package.json if not already loaded
+        this.loadPackageJson(projectRoot);
+        logger.debug("server", `ConfigLoader: Resolving references for ${this.sys.path.basename(configPath)}`);
+        if (__sys__?.__env__) {
+            const envSnapshot = __sys__.__env__.all();
+            logger.debug("server", `ConfigLoader: Env keys available in store for ${projectRoot}: ${Object.keys(envSnapshot).join(", ")}`);
+        }
+        // Resolve environment and package variable references
+        const config = this.resolveRefs(rawConfig);
+        if (!config)
+            return;
+        logger.debug("server", `ConfigLoader: Applied configuration from: ${this.sys.path.relative(projectRoot, configPath)}`);
+        // Apply __sys__ config if present
+        if (config?.$vars) {
+            if (__sys__) {
+                logger.debug("server", `ConfigLoader: Updating system variables with $vars: ${JSON.stringify(config.$vars)}`);
+                __sys__.vars.update(config.$vars);
+            }
+        }
+        // Process internal configuration
+        const internal = config?.vars?.internal || config?.internal || config?.$internal;
+        if (internal) {
+            this.processInternalConfig(internal, projectRoot, configDir);
+        }
+    }
+    /**
+     * Processes the internal configuration block.
+     * Handle specialized filesystems and meta logic defined by plugin IDs.
+     */
+    processInternalConfig(internalConfig, projectRoot, configDir) {
+        if (!__sys__)
+            return;
+        const allPermissions = [];
+        for (const [pluginId, sysConfig] of Object.entries(internalConfig)) {
+            const config = typeof sysConfig === "string" ? {} : sysConfig;
+            if (pluginId) {
+                // 1. Setup specialized FileSystem if __xfs__ is present
+                if (config.__xfs__ && config.__xfs__.path) {
+                    const rawPath = config.__xfs__.path;
+                    const resolvedFsPath = this.resolvePath(rawPath, projectRoot, configDir);
+                    if (resolvedFsPath &&
+                        this.sys.fs.exist(resolvedFsPath)) {
+                        const specializedFS = new XyPrissFS({
+                            __root__: resolvedFsPath,
+                            __mode__: __sys__.__env__.mode,
+                        });
+                        __sys__[XY_XHSC_REGISTER_FS](pluginId, specializedFS);
+                        logger.debug("server", `Specialized filesystem mapped: ${pluginId} -> ${resolvedFsPath} (from: ${rawPath})`);
+                    }
+                }
+                // 2. Execute additional meta logic if __meta__ is present
+                if (config.__meta__ && config.__meta__.path) {
+                    const rawPath = config.__meta__.path;
+                    const resolvedMetaPath = this.resolvePath(rawPath, projectRoot, configDir);
+                    if (resolvedMetaPath &&
+                        this.sys.fs.exist(resolvedMetaPath)) {
+                        if (this.sys.fs.stats(resolvedMetaPath).is_dir) {
+                            this.metaRunner.executeMetaConfig(resolvedMetaPath);
+                        }
+                        else {
+                            this.metaRunner.runMetaFile(resolvedMetaPath);
+                        }
+                    }
+                }
+                // 3. Extract plugin permissions
+                if (config.permissions) {
+                    allPermissions.push({
+                        name: pluginId,
+                        ...config.permissions,
+                    });
+                }
+            }
+        }
+        if (allPermissions.length > 0) {
+            __sys__.vars.set("pluginPermissions", allPermissions);
+            logger.debug("server", `Loaded ${allPermissions.length} plugin permission rules from configuration`);
+        }
+    }
+    /**
+     * Resolves a path string into an absolute path.
+     */
+    resolvePath(rawPath, projectRoot, configDir) {
+        try {
+            let cleanedPath = rawPath.replace(/\s*\/\s*/g, "/").trim();
+            // 1. Project Root Anchors: ROOT://
+            const rootMatch = cleanedPath.match(/^ROOT:\/\/(.*)$/i);
+            if (rootMatch) {
+                return this.sys.path.resolve(projectRoot, rootMatch[1].replace(/^\//, ""));
+            }
+            // 2. CWD Anchors: CWD://
+            const cwdMatch = cleanedPath.match(/^CWD:\/\/(.*)$/i);
+            if (cwdMatch) {
+                return this.sys.path.resolve(process.cwd(), cwdMatch[1].replace(/^\//, ""));
+            }
+            if (this.sys.path.isAbsolute(cleanedPath))
+                return cleanedPath;
+            return this.sys.path.resolve(configDir, cleanedPath);
+        }
+        catch (error) {
+            return null;
+        }
+    }
+    loadPackageJson(root) {
+        if (this.packageJson)
+            return;
+        const pkgPath = this.sys.path.join(root, "package.json");
+        if (this.sys.fs.exist(pkgPath)) {
+            try {
+                this.packageJson = JSON.parse(this.sys.fs.readSync(pkgPath));
+            }
+            catch (error) {
+                logger.warn("server", "Failed to parse package.json for configuration resolution");
+            }
+        }
+    }
+    resolveRefs(obj) {
+        const parser = new ConfigSyntaxParser(this.packageJson, __sys__?.__env__);
+        return parser.resolve(obj);
+    }
+}
+export const configLoader = new ConfigLoader();
+//# sourceMappingURL=ConfigLoader.js.map

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

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

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

@@ -0,0 +1,19 @@
+/**
+ * XyPriss Meta Configuration Runner
+ *
+ * Discovers and executes early initialization logic from meta files before
+ * the standard xypriss.config is fully processed.
+ */
+export declare class MetaConfigRunner {
+    private executedMetas;
+    /**
+     * Executes a specific meta configuration file
+     */
+    runMetaFile(metaPath: string): void;
+    /**
+     * Discovers and executes meta configuration files based on priority
+     */
+    executeMetaConfig(searchDir?: string): void;
+    private handleFatalError;
+}
+//# sourceMappingURL=MetaConfigRunner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MetaConfigRunner.d.ts","sourceRoot":"","sources":["../../../../src/server/utils/MetaConfigRunner.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,aAAa,CAAqB;IAE1C;;OAEG;IACI,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAwB1C;;OAEG;IACI,iBAAiB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IA6BlD,OAAO,CAAC,gBAAgB;CAa3B"}

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

@@ -0,0 +1,84 @@
+import { logger } from "../../shared/logger/Logger";
+import { __sys__ } from "../../xhsc";
+import { getSysApi } from "../../plugins/const/getSysApi";
+import { getCallerProjectRoot } from "../../utils/ProjectDiscovery";
+/**
+ * XyPriss Meta Configuration Runner
+ *
+ * Discovers and executes early initialization logic from meta files before
+ * the standard xypriss.config is fully processed.
+ */
+export class MetaConfigRunner {
+    constructor() {
+        this.executedMetas = new Set();
+    }
+    /**
+     * Executes a specific meta configuration file
+     */
+    runMetaFile(metaPath) {
+        const sys = getSysApi();
+        const absolutePath = sys.path.resolve(metaPath);
+        if (this.executedMetas.has(absolutePath))
+            return;
+        this.executedMetas.add(absolutePath);
+        try {
+            import(`file://${metaPath}`)
+                .then((module) => {
+                if (module && typeof module.run === "function") {
+                    // Allow synchronous or asynchronous run() functions
+                    const result = module.run();
+                    if (result instanceof Promise) {
+                        result.catch(this.handleFatalError.bind(this, metaPath));
+                    }
+                }
+                logger.debug("server", `Executed meta file: ${metaPath}`);
+            })
+                .catch(this.handleFatalError.bind(this, metaPath));
+        }
+        catch (error) {
+            this.handleFatalError(metaPath, error);
+        }
+    }
+    /**
+     * Discovers and executes meta configuration files based on priority
+     */
+    executeMetaConfig(searchDir) {
+        const sys = getSysApi();
+        const root = searchDir || getCallerProjectRoot() || __sys__.__root__;
+        const metaFiles = searchDir
+            ? [
+                sys.path.join(root, "+xypriss.meta.ts"),
+                sys.path.join(root, "+xypriss.meta.js"),
+                sys.path.join(root, ".meta", "+xypriss.meta.ts"),
+                sys.path.join(root, ".meta", "+xypriss.meta.js"),
+            ]
+            : [
+                sys.path.join(root, "+xypriss.meta.ts"),
+                sys.path.join(root, "+xypriss.meta.js"),
+                sys.path.join(root, ".private", "+xypriss.meta.ts"),
+                sys.path.join(root, ".private", "+xypriss.meta.js"),
+                sys.path.join(root, ".meta", "+xypriss.meta.js"),
+                sys.path.join(root, ".meta", "+xypriss.meta.ts"),
+                sys.path.join(root, ".xypriss", "+xypriss.meta.ts"),
+                sys.path.join(root, ".xypriss", "+xypriss.meta.js"),
+            ];
+        for (const metaPath of metaFiles) {
+            if (sys.fs.exist(metaPath)) {
+                this.runMetaFile(metaPath);
+                if (!searchDir)
+                    return;
+            }
+        }
+    }
+    handleFatalError(metaPath, error) {
+        logger.error("server", `FATAL: Failed to execute meta file ${metaPath}: ${error.message || error}`);
+        // Terminate process securely via system API
+        if (globalThis.__sys__ && typeof globalThis.__sys__.exit === "function") {
+            globalThis.__sys__.exit(1);
+        }
+        else {
+            process.exit(1);
+        }
+    }
+}
+//# sourceMappingURL=MetaConfigRunner.js.map

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

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

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

@@ -0,0 +1,61 @@
+export interface PortSwitchResult {
+    success: boolean;
+    port: number;
+    originalPort: number;
+    attempts: number;
+    switched: boolean;
+}
+export interface AutoPortSwitchConfig {
+    enabled?: boolean;
+    maxAttempts?: number;
+    startPort?: number;
+    endPort?: number;
+    skipPorts?: number[];
+    strategy?: "increment" | "random" | "predefined";
+    portRange?: [number, number];
+    predefinedPorts?: number[];
+    onPortSwitch?: (originalPort: number, newPort: number) => void;
+    autoKillConflict?: boolean;
+}
+export declare class PortManager {
+    private config;
+    private originalPort;
+    constructor(originalPort: number, config?: AutoPortSwitchConfig);
+    /**
+     * Attempts to kill the process listening on a specific port
+     */
+    killProcessOnPort(port: number): Promise<boolean>;
+    /**
+     * Check if a port is available
+     */
+    isPortAvailable(port: number, host?: string): Promise<boolean>;
+    /**
+     * Generate next port based on strategy
+     */
+    private getNextPort;
+    /**
+     * Validate port number
+     */
+    private isValidPort;
+    /**
+     * Find an available port automatically
+     */
+    findAvailablePort(host?: string): Promise<PortSwitchResult>;
+    /**
+     * Get configuration summary
+     */
+    getConfig(): AutoPortSwitchConfig;
+    /**
+     * Update configuration
+     */
+    updateConfig(newConfig: Partial<AutoPortSwitchConfig>): void;
+}
+/**
+ * Utility function to create a PortManager instance
+ */
+export declare function createPortManager(port: number, config?: AutoPortSwitchConfig): PortManager;
+/**
+ * Quick utility to find an available port
+ */
+export declare function findAvailablePort(port: number, config?: AutoPortSwitchConfig, host?: string): Promise<PortSwitchResult>;
+//# sourceMappingURL=PortManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PortManager.d.ts","sourceRoot":"","sources":["../../../../src/server/utils/PortManager.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,WAAW,GAAG,QAAQ,GAAG,YAAY,CAAC;IACjD,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,YAAY,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/D,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,qBAAa,WAAW;IACpB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,YAAY,CAAS;gBAEjB,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,oBAAoB;IAY/D;;OAEG;IACU,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA2D9D;;OAEG;IACU,eAAe,CACxB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAoB,GAC3B,OAAO,CAAC,OAAO,CAAC;IA0DnB;;OAEG;IACH,OAAO,CAAC,WAAW;IA0BnB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACU,iBAAiB,CAC1B,IAAI,GAAE,MAAoB,GAC3B,OAAO,CAAC,gBAAgB,CAAC;IAqE5B;;OAEG;IACI,SAAS,IAAI,oBAAoB;IAIxC;;OAEG;IACI,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI;CAGtE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC7B,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,oBAAoB,GAC9B,WAAW,CAEb;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACnC,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,oBAAoB,EAC7B,IAAI,GAAE,MAAoB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CAG3B"}

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

@@ -0,0 +1,245 @@
+/**
+ * Port Manager - Handles automatic port switching when ports are in use
+ */
+// ServerConfig removed - using ServerOptions instead
+import net from "net";
+export class PortManager {
+    constructor(originalPort, config) {
+        this.originalPort = originalPort;
+        this.config = {
+            enabled: false,
+            maxAttempts: 10,
+            startPort: originalPort,
+            strategy: "increment",
+            autoKillConflict: false,
+            ...config,
+        };
+    }
+    /**
+     * Attempts to kill the process listening on a specific port
+     */
+    async killProcessOnPort(port) {
+        const { execSync } = await import("node:child_process");
+        const os = await import("node:os");
+        try {
+            if (os.platform() === "win32") {
+                try {
+                    const output = execSync(`netstat -ano | findstr :${port}`).toString();
+                    const lines = output.split("\n");
+                    let killed = false;
+                    for (const line of lines) {
+                        if (line.includes("LISTENING")) {
+                            const parts = line.trim().split(/\s+/);
+                            const pid = parts[parts.length - 1];
+                            if (pid && pid !== "0") {
+                                execSync(`taskkill /F /PID ${pid}`, {
+                                    stdio: "ignore",
+                                });
+                                killed = true;
+                            }
+                        }
+                    }
+                    return killed;
+                }
+                catch (e) {
+                    return false;
+                }
+            }
+            else {
+                // Try fuser first (LinuX)
+                try {
+                    execSync(`fuser -k ${port}/tcp`, { stdio: "ignore" });
+                    return true;
+                }
+                catch (e) {
+                    // Fallback to lsof (macOS / Linux without psmisc)
+                    try {
+                        const pidOutput = execSync(`lsof -t -i:${port}`, {
+                            stdio: ["ignore", "pipe", "ignore"],
+                        })
+                            .toString()
+                            .trim();
+                        if (pidOutput) {
+                            const pids = pidOutput.split("\n");
+                            for (const pid of pids) {
+                                execSync(`kill -9 ${pid}`, { stdio: "ignore" });
+                            }
+                            return true;
+                        }
+                    }
+                    catch (e2) {
+                        return false;
+                    }
+                }
+            }
+        }
+        catch (error) {
+            return false;
+        }
+        return false;
+    }
+    /**
+     * Check if a port is available
+     */
+    async isPortAvailable(port, host = "localhost") {
+        return new Promise((resolve) => {
+            // Use net.connect to test port availability more reliably
+            const socket = new net.Socket();
+            let resolved = false;
+            const cleanup = () => {
+                if (!resolved) {
+                    resolved = true;
+                    try {
+                        socket.destroy();
+                    }
+                    catch (e) {
+                        // Ignore cleanup errors
+                    }
+                }
+            };
+            // Set a timeout to avoid hanging
+            const timeout = setTimeout(() => {
+                cleanup();
+                resolve(true); // If connection times out, assume port is available
+            }, 1000);
+            // Use the same host for port availability check to ensure proper conflict detection
+            const checkHost = host;
+            socket.setTimeout(1000);
+            socket.on("connect", () => {
+                // If we can connect, the port is in use
+                clearTimeout(timeout);
+                cleanup();
+                resolve(false);
+            });
+            socket.on("error", (err) => {
+                clearTimeout(timeout);
+                cleanup();
+                // If connection fails, the port is likely available
+                resolve(true);
+            });
+            socket.on("timeout", () => {
+                clearTimeout(timeout);
+                cleanup();
+                resolve(true);
+            });
+            try {
+                socket.connect(port, checkHost);
+            }
+            catch (error) {
+                clearTimeout(timeout);
+                cleanup();
+                resolve(true);
+            }
+        });
+    }
+    /**
+     * Generate next port based on strategy
+     */
+    getNextPort(currentPort, attempt) {
+        const { strategy, portRange, predefinedPorts } = this.config;
+        switch (strategy) {
+            case "increment":
+                return currentPort + attempt;
+            case "random":
+                if (portRange) {
+                    const [min, max] = portRange;
+                    return Math.floor(Math.random() * (max - min + 1)) + min;
+                }
+                return currentPort + Math.floor(Math.random() * 1000) + 1;
+            case "predefined":
+                if (predefinedPorts && predefinedPorts.length > 0) {
+                    return predefinedPorts[attempt % predefinedPorts.length];
+                }
+                // Fallback to increment if no predefined ports
+                return currentPort + attempt;
+            default:
+                return currentPort + attempt;
+        }
+    }
+    /**
+     * Validate port number
+     */
+    isValidPort(port) {
+        return port >= 1 && port <= 65535;
+    }
+    /**
+     * Find an available port automatically
+     */
+    async findAvailablePort(host = "localhost") {
+        const result = {
+            success: false,
+            port: this.originalPort,
+            originalPort: this.originalPort,
+            attempts: 0,
+            switched: false,
+        };
+        // If auto port switch is disabled, just check the original port
+        if (!this.config?.enabled) {
+            const available = await this.isPortAvailable(this.originalPort, host);
+            result.success = available;
+            result.attempts = 1;
+            return result;
+        }
+        const { maxAttempts, startPort, portRange } = this.config;
+        let currentPort = startPort || this.originalPort;
+        // First, try the original port
+        if (await this.isPortAvailable(this.originalPort, host)) {
+            result.success = true;
+            result.attempts = 1;
+            return result;
+        }
+        // If original port is not available, start searching
+        for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+            currentPort = this.getNextPort(startPort || this.originalPort, attempt);
+            // Validate port range if specified
+            if (portRange) {
+                const [min, max] = portRange;
+                if (currentPort < min || currentPort > max) {
+                    continue;
+                }
+            }
+            // Validate port number
+            if (!this.isValidPort(currentPort)) {
+                continue;
+            }
+            result.attempts = attempt + 1;
+            if (await this.isPortAvailable(currentPort, host)) {
+                result.success = true;
+                result.port = currentPort;
+                result.switched = true;
+                // Call the callback if provided
+                if (this.config?.onPortSwitch) {
+                    this.config.onPortSwitch(this.originalPort, currentPort);
+                }
+                break;
+            }
+        }
+        return result;
+    }
+    /**
+     * Get configuration summary
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(newConfig) {
+        this.config = { ...this.config, ...newConfig };
+    }
+}
+/**
+ * Utility function to create a PortManager instance
+ */
+export function createPortManager(port, config) {
+    return new PortManager(port, config);
+}
+/**
+ * Quick utility to find an available port
+ */
+export async function findAvailablePort(port, config, host = "localhost") {
+    const manager = new PortManager(port, config);
+    return manager.findAvailablePort(host);
+}
+//# sourceMappingURL=PortManager.js.map

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

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

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

@@ -0,0 +1,7 @@
+import { ServerOptions } from "../../types/types";
+/**
+ * Handle worker mode configuration automatically
+ * This function makes clustering transparent to developers
+ */
+export declare function handleWorkerMode(options: ServerOptions): ServerOptions;
+//# sourceMappingURL=WorkerModeHandler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerModeHandler.d.ts","sourceRoot":"","sources":["../../../../src/server/utils/WorkerModeHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CA+DtE"}