xypriss 9.11.13 → 9.12.0

package/dist/src/server/components/multi-server/MultiServerManager.js

@@ -0,0 +1,363 @@
+import { Configs } from "../../../ConfigurationManager";
+import { XyServerCreator } from "../../core/XyServerCreator";
+import { Interface } from "reliant-type";
+import { rejectInternalFlag } from "../../utils/internalFlagsFunctions";
+import { QuickLogger } from "../../../shared/logger/quickLogger";
+import { defaultRouteStrategy } from "../../const/reStrategy";
+export class MultiServerManager {
+    constructor(baseConfig, logger, mainApp) {
+        this.servers = new Map();
+        this.baseConfig = { ...baseConfig };
+        delete this.baseConfig.multiServer;
+        this.logger = logger;
+        this.mainApp = mainApp;
+    }
+    /**
+     * Create multiple server instances based on configuration
+     */
+    async createServers(serverConfigs) {
+        const instances = [];
+        for (const serverConfig of serverConfigs) {
+            try {
+                const instance = await this.createServerInstance(serverConfig);
+                instances.push(instance);
+                this.servers.set(serverConfig.id, instance);
+                this.logger.debug("server", `Created server instance: ${serverConfig.id} on port ${serverConfig.port}`);
+            }
+            catch (error) {
+                this.logger.error("server", `Failed to create server ${serverConfig.id}:`, error.message);
+                throw error;
+            }
+        }
+        return instances;
+    }
+    /**
+     * Create a single server instance with merged configuration
+     * Uses the centralized Configs class for proper configuration management
+     */
+    async createServerInstance(config) {
+        // Save original global config to restore it later
+        const originalConfig = Configs.getAll();
+        try {
+            // 1. Start with the base configuration (Global Config)
+            // This ensures we inherit all default system settings
+            Configs.set(this.baseConfig);
+            // 2. Prepare the overrides from MultiServerConfig
+            // We want to merge the config object itself, which now extends ServerOptions
+            const overrides = { ...config };
+            // 3. Handle port and host explicitly to ensure they are in the right place
+            // MultiServerConfig has top-level port/host for convenience,
+            // but ServerOptions expects them in the 'server' object.
+            // Hoist security from server block if it exists there (users often nest it)
+            if (config.server?.security) {
+                overrides.security = {
+                    ...(overrides.security || {}),
+                    ...config.server.security,
+                };
+            }
+            overrides.server = {
+                ...(overrides.server || {}),
+                ...(config.port ? { port: config.port } : {}),
+                ...(config.host ? { host: config.host } : {}),
+            };
+            overrides.logging = {
+                ...(overrides.logging || {}),
+                instanceName: config.id,
+            };
+            rejectInternalFlag(overrides);
+            // 4. Remove MultiServer-specific properties that don't belong in ServerOptions
+            const multiServerProps = [
+                "id",
+                "port",
+                "host",
+                "routePrefix",
+                "allowedRoutes",
+                "responseControl",
+            ];
+            multiServerProps.forEach((prop) => {
+                delete overrides[prop];
+            });
+            // 5. Deep merge the overrides into the current Configs
+            // This will use our intelligent mergeWithDefaults logic
+            Configs.merge(overrides);
+            // 6. Get the final merged configuration
+            const mergedConfig = Configs.getAll();
+            // 7. Safety overrides for multi-server instances
+            // Disable clustering by default for instances unless explicitly requested
+            if (mergedConfig.cluster && !config.cluster?.enabled) {
+                mergedConfig.cluster.enabled = false;
+            }
+            // Child instances should act as fully-fledged servers with their own plugins
+            // rather than stripped-down auxiliary instances, to keep multi-server architecture robust.
+            // (mergedConfig as any).isAuxiliary = true;
+            // Remove multiServer configuration from individual instance to prevent recursion
+            delete mergedConfig.multiServer;
+            // console.log("[MultiServerManager] mergedConfig: ", mergedConfig);
+            // 8. Create server instance using the unified XyServerCreator
+            // It will use the configuration we just set in the Configs singleton
+            const app = XyServerCreator.create(mergedConfig);
+            // Wait for server to be ready (plugins initialized, etc.)
+            await app.waitForReady();
+            // 9. Apply server-specific response control if configured
+            if (config.responseControl) {
+                app.setResponseControl(config.responseControl);
+            }
+            // 10. Apply route filtering if specified
+            if (config.allowedRoutes || config.routePrefix) {
+                this.applyRouteFilteringFromMainApp(app, config);
+            }
+            return {
+                id: config.id,
+                app,
+                config,
+                port: mergedConfig.server?.port || config.port,
+                host: mergedConfig.server?.host || config.host || "localhost",
+            };
+        }
+        finally {
+            // Restore the original global config so other parts of the app aren't affected
+            Configs.set(originalConfig);
+        }
+    }
+    /**
+     * Apply route filtering by copying and filtering routes from main app
+     */
+    applyRouteFilteringFromMainApp(app, config) {
+        // Get routes from main app's HTTP server
+        const mainAppRoutes = this.mainApp?.getHttpServer?.()?.getRoutes?.() || [];
+        // Route filtering function
+        const shouldAllowRoute = (path) => {
+            // Check route prefix
+            const strategy = config.routePrefixStrategy || defaultRouteStrategy;
+            if (config.routePrefix && !path.startsWith(config.routePrefix)) {
+                if (strategy !== "both") {
+                    return false;
+                }
+            }
+            // Check allowed routes patterns
+            if (config.allowedRoutes) {
+                return config.allowedRoutes.some((pattern) => {
+                    if (pattern.endsWith("/*")) {
+                        // Wildcard pattern
+                        const prefix = pattern.slice(0, -2);
+                        return path.startsWith(prefix);
+                    }
+                    else {
+                        // Exact match
+                        return path === pattern;
+                    }
+                });
+            }
+            return true;
+        };
+        // Copy and filter routes from main app to this server app
+        if (mainAppRoutes && mainAppRoutes.length > 0) {
+            this.logger.debug("server", `Server ${config.id} copying ${mainAppRoutes.length} routes from main app`);
+            mainAppRoutes.forEach((route) => {
+                const prefix = config.routePrefix;
+                const strategy = config.routePrefixStrategy || defaultRouteStrategy;
+                let pathsToRegister = [route.path];
+                if (prefix && prefix !== "/") {
+                    if (strategy === "strict-match" &&
+                        !route.path.startsWith(prefix)) {
+                        return; // skip completely
+                    }
+                    if (strategy === "auto-inject" || strategy === "both") {
+                        if (!route.path.startsWith(prefix)) {
+                            let injectedPath = prefix + (route.path === "/" ? "" : route.path);
+                            injectedPath = injectedPath.replace(/\/+/g, "/");
+                            if (strategy === "auto-inject") {
+                                pathsToRegister = [injectedPath];
+                            }
+                            else if (strategy === "both") {
+                                pathsToRegister.push(injectedPath);
+                            }
+                        }
+                    }
+                }
+                pathsToRegister.forEach((finalPath) => {
+                    if (shouldAllowRoute(finalPath)) {
+                        this.logger.debug("server", `Server ${config.id} registering route: ${route.method} ${finalPath}`);
+                        // Register the route on this server
+                        const handlers = [
+                            ...(route.middleware || []),
+                            route.handler,
+                        ];
+                        switch (route.method?.toUpperCase()) {
+                            case "GET":
+                                app.get(finalPath, ...handlers);
+                                break;
+                            case "POST":
+                                app.post(finalPath, ...handlers);
+                                break;
+                            case "PUT":
+                                app.put(finalPath, ...handlers);
+                                break;
+                            case "DELETE":
+                                app.delete(finalPath, ...handlers);
+                                break;
+                            case "PATCH":
+                                app.patch(finalPath, ...handlers);
+                                break;
+                            case "OPTIONS":
+                                app.options(finalPath, ...handlers);
+                                break;
+                            case "HEAD":
+                                app.head(finalPath, ...handlers);
+                                break;
+                            default:
+                                this.logger.warn("server", `Server ${config.id} unsupported method: ${route.method} for ${route.path}`);
+                        }
+                    }
+                    else {
+                        this.logger.debug("server", `Server ${config.id} filtering out route: ${route.method} ${finalPath}`);
+                    }
+                });
+            });
+        }
+        // Handle router middleware from main app
+        this.copyRouterMiddlewareFromMainApp(app, config, shouldAllowRoute);
+    }
+    /**
+     * Copy and filter router middleware from main app
+     */
+    copyRouterMiddlewareFromMainApp(app, config, shouldAllowRoute) {
+        // Access main app's HTTP server to get middleware
+        const mainHttpServer = this.mainApp?.getHttpServer?.();
+        if (!mainHttpServer) {
+            return;
+        }
+        // Access middleware manager (private property, need casting)
+        const mainMiddlewareManager = mainHttpServer.middlewareManager;
+        if (!mainMiddlewareManager) {
+            return;
+        }
+        // Get all middleware entries
+        const allMiddleware = mainMiddlewareManager.getAllMiddleware();
+        if (allMiddleware.length === 0) {
+            return;
+        }
+        this.logger.debug("server", `Server ${config.id}: Copying ${allMiddleware.length} middleware from main app`);
+        // Access target app's HTTP server and middleware manager
+        const targetHttpServer = app.getHttpServer?.();
+        const targetMiddlewareManager = targetHttpServer
+            ?.middlewareManager;
+        if (!targetMiddlewareManager) {
+            this.logger.warn("server", `Server ${config.id}: Target middleware manager not found, falling back to app.use`);
+        }
+        // Register middleware on the new app
+        allMiddleware.forEach((entry) => {
+            // We register the handler with its original config (priority, name, etc.)
+            // Path-specific middleware is already wrapped in the handler, so we don't need to check paths here
+            // unless we wanted to strictly filter middleware by allowed routes (which is complex due to path matching)
+            if (targetMiddlewareManager) {
+                targetMiddlewareManager.use(entry.handler, entry.config);
+            }
+            else {
+                app.use(entry.handler);
+            }
+        });
+    }
+    /**
+     * Start all server instances
+     */
+    async startAllServers() {
+        const startPromises = Array.from(this.servers.values()).map(async (instance) => {
+            const xms_basic_schm = Interface({
+                id: "string",
+                // @fortify-ignore
+                port: "string(/^[0-9]{1,5}$/)",
+            });
+            const _result = xms_basic_schm.safeParse({
+                id: instance.id,
+                port: String(instance.port),
+            });
+            if (!_result.success) {
+                const errorMessage = _result.errors[0].message.includes("does not match")
+                    ? "XMS configuration error: server port must be a numeric value between 0 and 65535."
+                    : _result.errors[0].message;
+                this.logger.error("server", `Failed to start server "${instance.id}":`, errorMessage);
+                throw new Error(errorMessage);
+            }
+            try {
+                await instance.app.start();
+                QuickLogger.for("XMS").banner(`Server "${instance.id}" started on ${instance.host}:${instance.port}`);
+            }
+            catch (error) {
+                this.logger.error("server", `Failed to start server ${instance.id}:`, error.message);
+                throw error;
+            }
+        });
+        await Promise.all(startPromises);
+    }
+    /**
+     * Stop all server instances
+     */
+    async stopAllServers() {
+        const stopPromises = Array.from(this.servers.values()).map(async (instance) => {
+            try {
+                if (typeof instance.app.close === "function") {
+                    instance.app.close();
+                }
+                else if (instance.app.stop) {
+                    await instance.app.stop();
+                }
+                this.logger.info("server", `Server ${instance.id} stopped`);
+            }
+            catch (error) {
+                this.logger.error("server", `Failed to stop server ${instance.id}:`, error.message);
+            }
+        });
+        await Promise.all(stopPromises);
+    }
+    /**
+     * Get all server instances
+     */
+    getAllServers() {
+        return Array.from(this.servers.values());
+    }
+    /**
+     * Get a specific server instance by ID
+     */
+    getServer(id) {
+        return this.servers.get(id);
+    }
+    /**
+     * Stop a specific server instance by port
+     */
+    async stopServer(port) {
+        const instance = Array.from(this.servers.values()).find((s) => s.port === port);
+        if (!instance)
+            return false;
+        try {
+            if (typeof instance.app.close === "function") {
+                instance.app.close();
+            }
+            else if (instance.app.stop) {
+                await instance.app.stop();
+            }
+            this.logger.info("server", `Server ${instance.id} on port ${port} stopped`);
+            return true;
+        }
+        catch (error) {
+            this.logger.error("server", `Failed to stop server on port ${port}:`, error.message);
+            return false;
+        }
+    }
+    /**
+     * Get server statistics
+     */
+    getStats() {
+        const serverStats = Array.from(this.servers.entries()).map(([id, instance]) => ({
+            id,
+            port: instance.port,
+            host: instance.host,
+            // Add more stats as needed
+        }));
+        return {
+            totalServers: this.servers.size,
+            servers: serverStats,
+        };
+    }
+}
+//# sourceMappingURL=MultiServerManager.js.map

package/dist/src/server/components/multi-server/MultiServerManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiServerManager.js","sourceRoot":"","sources":["../../../../../src/server/components/multi-server/MultiServerManager.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAU9D,MAAM,OAAO,kBAAkB;IAM3B,YAAY,UAAyB,EAAE,MAAc,EAAE,OAAa;QAF5D,YAAO,GAAqC,IAAI,GAAG,EAAE,CAAC;QAG1D,IAAI,CAAC,UAAU,GAAG,EAAE,GAAG,UAAU,EAAE,CAAC;QACpC,OAAQ,IAAI,CAAC,UAAkB,CAAC,WAAW,CAAC;QAC5C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,aAAa,CACtB,aAAkC;QAElC,MAAM,SAAS,GAA0B,EAAE,CAAC;QAE5C,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;YACvC,IAAI,CAAC;gBACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;gBAC/D,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACzB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;gBAE5C,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,QAAQ,EACR,4BAA4B,YAAY,CAAC,EAAE,YAAY,YAAY,CAAC,IAAI,EAAE,CAC7E,CAAC;YACN,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBAClB,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,QAAQ,EACR,2BAA2B,YAAY,CAAC,EAAE,GAAG,EAC7C,KAAK,CAAC,OAAO,CAChB,CAAC;gBACF,MAAM,KAAK,CAAC;YAChB,CAAC;QACL,CAAC;QAED,OAAO,SAAS,CAAC;IACrB,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,oBAAoB,CAC9B,MAAyB;QAEzB,kDAAkD;QAClD,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAExC,IAAI,CAAC;YACD,uDAAuD;YACvD,sDAAsD;YACtD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAE7B,kDAAkD;YAClD,6EAA6E;YAC7E,MAAM,SAAS,GAA2B,EAAE,GAAG,MAAM,EAAE,CAAC;YAExD,2EAA2E;YAC3E,6DAA6D;YAC7D,yDAAyD;YAEzD,4EAA4E;YAC5E,IAAK,MAAM,CAAC,MAAc,EAAE,QAAQ,EAAE,CAAC;gBACnC,SAAS,CAAC,QAAQ,GAAG;oBACjB,GAAG,CAAC,SAAS,CAAC,QAAQ,IAAI,EAAE,CAAC;oBAC7B,GAAI,MAAM,CAAC,MAAc,CAAC,QAAQ;iBACrC,CAAC;YACN,CAAC;YAED,SAAS,CAAC,MAAM,GAAG;gBACf,GAAG,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,CAAC;gBAC3B,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7C,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAChD,CAAC;YAEF,SAAS,CAAC,OAAO,GAAG;gBAChB,GAAG,CAAC,SAAS,CAAC,OAAO,IAAI,EAAE,CAAC;gBAC5B,YAAY,EAAE,MAAM,CAAC,EAAE;aAC1B,CAAC;YAEF,kBAAkB,CAAC,SAAS,CAAC,CAAC;YAE9B,+EAA+E;YAC/E,MAAM,gBAAgB,GAAG;gBACrB,IAAI;gBACJ,MAAM;gBACN,MAAM;gBACN,aAAa;gBACb,eAAe;gBACf,iBAAiB;aACpB,CAAC;YACF,gBAAgB,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;gBAC9B,OAAQ,SAAiB,CAAC,IAAI,CAAC,CAAC;YACpC,CAAC,CAAC,CAAC;YAEH,uDAAuD;YACvD,wDAAwD;YACxD,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAEzB,wCAAwC;YACxC,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAEtC,iDAAiD;YACjD,0EAA0E;YAC1E,IAAI,YAAY,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC;gBACnD,YAAY,CAAC,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC;YACzC,CAAC;YAED,6EAA6E;YAC7E,2FAA2F;YAC3F,4CAA4C;YAE5C,iFAAiF;YACjF,OAAQ,YAAoB,CAAC,WAAW,CAAC;YAEzC,oEAAoE;YAEpE,8DAA8D;YAC9D,qEAAqE;YACrE,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YAEjD,0DAA0D;YAC1D,MAAM,GAAG,CAAC,YAAY,EAAE,CAAC;YAEzB,0DAA0D;YAC1D,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;gBACzB,GAAG,CAAC,kBAAkB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;YACnD,CAAC;YAED,yCAAyC;YACzC,IAAI,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;gBAC7C,IAAI,CAAC,8BAA8B,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACrD,CAAC;YAED,OAAO;gBACH,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,GAAG;gBACH,MAAM;gBACN,IAAI,EAAE,YAAY,CAAC,MAAM,EAAE,IAAI,IAAI,MAAM,CAAC,IAAI;gBAC9C,IAAI,EAAE,YAAY,CAAC,MAAM,EAAE,IAAI,IAAI,MAAM,CAAC,IAAI,IAAI,WAAW;aAChE,CAAC;QACN,CAAC;gBAAS,CAAC;YACP,+EAA+E;YAC/E,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAChC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,8BAA8B,CAClC,GAAQ,EACR,MAAyB;QAEzB,yCAAyC;QACzC,MAAM,aAAa,GACf,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC;QAEzD,2BAA2B;QAC3B,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAW,EAAE;YAC/C,qBAAqB;YACrB,MAAM,QAAQ,GAAG,MAAM,CAAC,mBAAmB,IAAI,oBAAoB,CAAC;YACpE,IAAI,MAAM,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC7D,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;oBACtB,OAAO,KAAK,CAAC;gBACjB,CAAC;YACL,CAAC;YAED,gCAAgC;YAChC,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;gBACvB,OAAO,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;oBACzC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;wBACzB,mBAAmB;wBACnB,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;wBACpC,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;oBACnC,CAAC;yBAAM,CAAC;wBACJ,cAAc;wBACd,OAAO,IAAI,KAAK,OAAO,CAAC;oBAC5B,CAAC;gBACL,CAAC,CAAC,CAAC;YACP,CAAC;YAED,OAAO,IAAI,CAAC;QAChB,CAAC,CAAC;QAEF,0DAA0D;QAC1D,IAAI,aAAa,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,QAAQ,EACR,UAAU,MAAM,CAAC,EAAE,YAAY,aAAa,CAAC,MAAM,uBAAuB,CAC7E,CAAC;YAEF,aAAa,CAAC,OAAO,CAAC,CAAC,KAAU,EAAE,EAAE;gBACjC,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC;gBAClC,MAAM,QAAQ,GAAG,MAAM,CAAC,mBAAmB,IAAI,oBAAoB,CAAC;gBACpE,IAAI,eAAe,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAEnC,IAAI,MAAM,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;oBAC3B,IACI,QAAQ,KAAK,cAAc;wBAC3B,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAChC,CAAC;wBACC,OAAO,CAAC,kBAAkB;oBAC9B,CAAC;oBAED,IAAI,QAAQ,KAAK,aAAa,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;wBACpD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;4BACjC,IAAI,YAAY,GACZ,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;4BACpD,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;4BAEjD,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;gCAC7B,eAAe,GAAG,CAAC,YAAY,CAAC,CAAC;4BACrC,CAAC;iCAAM,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;gCAC7B,eAAe,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;4BACvC,CAAC;wBACL,CAAC;oBACL,CAAC;gBACL,CAAC;gBAED,eAAe,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;oBAClC,IAAI,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;wBAC9B,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,QAAQ,EACR,UAAU,MAAM,CAAC,EAAE,uBAAuB,KAAK,CAAC,MAAM,IAAI,SAAS,EAAE,CACxE,CAAC;wBAEF,oCAAoC;wBACpC,MAAM,QAAQ,GAAG;4BACb,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC;4BAC3B,KAAK,CAAC,OAAO;yBAChB,CAAC;wBACF,QAAQ,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,CAAC;4BAClC,KAAK,KAAK;gCACN,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,QAAQ,CAAC,CAAC;gCAChC,MAAM;4BACV,KAAK,MAAM;gCACP,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,QAAQ,CAAC,CAAC;gCACjC,MAAM;4BACV,KAAK,KAAK;gCACN,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,QAAQ,CAAC,CAAC;gCAChC,MAAM;4BACV,KAAK,QAAQ;gCACT,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,QAAQ,CAAC,CAAC;gCACnC,MAAM;4BACV,KAAK,OAAO;gCACR,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,GAAG,QAAQ,CAAC,CAAC;gCAClC,MAAM;4BACV,KAAK,SAAS;gCACV,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,QAAQ,CAAC,CAAC;gCACpC,MAAM;4BACV,KAAK,MAAM;gCACP,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,QAAQ,CAAC,CAAC;gCACjC,MAAM;4BACV;gCACI,IAAI,CAAC,MAAM,CAAC,IAAI,CACZ,QAAQ,EACR,UAAU,MAAM,CAAC,EAAE,wBAAwB,KAAK,CAAC,MAAM,QAAQ,KAAK,CAAC,IAAI,EAAE,CAC9E,CAAC;wBACV,CAAC;oBACL,CAAC;yBAAM,CAAC;wBACJ,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,QAAQ,EACR,UAAU,MAAM,CAAC,EAAE,yBAAyB,KAAK,CAAC,MAAM,IAAI,SAAS,EAAE,CAC1E,CAAC;oBACN,CAAC;gBACL,CAAC,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;QACP,CAAC;QAED,yCAAyC;QACzC,IAAI,CAAC,+BAA+B,CAAC,GAAG,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACK,+BAA+B,CACnC,GAAQ,EACR,MAAyB,EACzB,gBAA2C;QAE3C,kDAAkD;QAClD,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,CAAC;QACvD,IAAI,CAAC,cAAc,EAAE,CAAC;YAClB,OAAO;QACX,CAAC;QAED,6DAA6D;QAC7D,MAAM,qBAAqB,GAAI,cAAsB,CAAC,iBAAiB,CAAC;QACxE,IAAI,CAAC,qBAAqB,EAAE,CAAC;YACzB,OAAO;QACX,CAAC;QAED,6BAA6B;QAC7B,MAAM,aAAa,GAAG,qBAAqB,CAAC,gBAAgB,EAAE,CAAC;QAE/D,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO;QACX,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,QAAQ,EACR,UAAU,MAAM,CAAC,EAAE,aAAa,aAAa,CAAC,MAAM,2BAA2B,CAClF,CAAC;QAEF,yDAAyD;QACzD,MAAM,gBAAgB,GAAG,GAAG,CAAC,aAAa,EAAE,EAAE,CAAC;QAC/C,MAAM,uBAAuB,GAAI,gBAAwB;YACrD,EAAE,iBAAiB,CAAC;QAExB,IAAI,CAAC,uBAAuB,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,IAAI,CACZ,QAAQ,EACR,UAAU,MAAM,CAAC,EAAE,gEAAgE,CACtF,CAAC;QACN,CAAC;QAED,qCAAqC;QACrC,aAAa,CAAC,OAAO,CAAC,CAAC,KAAU,EAAE,EAAE;YACjC,0EAA0E;YAC1E,mGAAmG;YACnG,2GAA2G;YAE3G,IAAI,uBAAuB,EAAE,CAAC;gBAC1B,uBAAuB,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YAC7D,CAAC;iBAAM,CAAC;gBACJ,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC3B,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,eAAe;QACxB,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CACvD,KAAK,EAAE,QAAQ,EAAE,EAAE;YACf,MAAM,cAAc,GAAG,SAAS,CAAC;gBAC7B,EAAE,EAAE,QAAQ;gBACZ,kBAAkB;gBAClB,IAAI,EAAE,wBAAwB;aACjC,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,cAAc,CAAC,SAAS,CAAC;gBACrC,EAAE,EAAE,QAAQ,CAAC,EAAE;gBACf,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;aAC9B,CAAC,CAAC;YAEH,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;gBACnB,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CACnD,gBAAgB,CACnB;oBACG,CAAC,CAAC,mFAAmF;oBACrF,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBAEhC,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,QAAQ,EACR,2BAA2B,QAAQ,CAAC,EAAE,IAAI,EAC1C,YAAY,CACf,CAAC;gBAEF,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;YAClC,CAAC;YAED,IAAI,CAAC;gBACD,MAAM,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;gBAC3B,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM,CACzB,WAAW,QAAQ,CAAC,EAAE,gBAAgB,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE,CACzE,CAAC;YACN,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBAClB,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,QAAQ,EACR,0BAA0B,QAAQ,CAAC,EAAE,GAAG,EACxC,KAAK,CAAC,OAAO,CAChB,CAAC;gBACF,MAAM,KAAK,CAAC;YAChB,CAAC;QACL,CAAC,CACJ,CAAC;QAEF,MAAM,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,cAAc;QACvB,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CACtD,KAAK,EAAE,QAAQ,EAAE,EAAE;YACf,IAAI,CAAC;gBACD,IAAI,OAAQ,QAAQ,CAAC,GAAW,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;oBACnD,QAAQ,CAAC,GAAW,CAAC,KAAK,EAAE,CAAC;gBAClC,CAAC;qBAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;oBAC3B,MAAM,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;gBAC9B,CAAC;gBACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,QAAQ,CAAC,EAAE,UAAU,CAAC,CAAC;YAChE,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBAClB,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,QAAQ,EACR,yBAAyB,QAAQ,CAAC,EAAE,GAAG,EACvC,KAAK,CAAC,OAAO,CAChB,CAAC;YACN,CAAC;QACL,CAAC,CACJ,CAAC;QAEF,MAAM,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACI,aAAa;QAChB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACI,SAAS,CAAC,EAAU;QACvB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,UAAU,CAAC,IAAY;QAChC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CACnD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CACzB,CAAC;QACF,IAAI,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAE5B,IAAI,CAAC;YACD,IAAI,OAAQ,QAAQ,CAAC,GAAW,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBACnD,QAAQ,CAAC,GAAW,CAAC,KAAK,EAAE,CAAC;YAClC,CAAC;iBAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;gBAC3B,MAAM,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YAC9B,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,IAAI,CACZ,QAAQ,EACR,UAAU,QAAQ,CAAC,EAAE,YAAY,IAAI,UAAU,CAClD,CAAC;YACF,OAAO,IAAI,CAAC;QAChB,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,QAAQ,EACR,iCAAiC,IAAI,GAAG,EACxC,KAAK,CAAC,OAAO,CAChB,CAAC;YACF,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAED;;OAEG;IACI,QAAQ;QACX,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CACtD,CAAC,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;YACjB,EAAE;YACF,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,2BAA2B;SAC9B,CAAC,CACL,CAAC;QAEF,OAAO;YACH,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;YAC/B,OAAO,EAAE,WAAW;SACvB,CAAC;IACN,CAAC;CACJ"}

package/dist/src/server/components/response-control/ResponseControlManager.d.ts

@@ -0,0 +1,22 @@
+import { XyPrisRequest, XyPrisResponse } from "../../../types/httpServer.type";
+import { ServerOptions } from "../../../types/types";
+import { Logger } from "../../../shared/logger/Logger";
+/**
+ * ResponseControlManager - Logic for custom response control (e.g. custom 404s)
+ * Works for both Single Server and Multi-Server (XMS) modes.
+ */
+export declare class ResponseControlManager {
+    private logger;
+    private config?;
+    constructor(logger: Logger);
+    /**
+     * Update the response control configuration
+     */
+    setConfig(config: ServerOptions["responseControl"]): void;
+    /**
+     * Execute the custom response if enabled
+     * @returns boolean true if the response was handled, false otherwise
+     */
+    handleCustomResponse(req: XyPrisRequest, res: XyPrisResponse): Promise<boolean>;
+}
+//# sourceMappingURL=ResponseControlManager.d.ts.map

package/dist/src/server/components/response-control/ResponseControlManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResponseControlManager.d.ts","sourceRoot":"","sources":["../../../../../src/server/components/response-control/ResponseControlManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAEvD;;;GAGG;AACH,qBAAa,sBAAsB;IAGnB,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,MAAM,CAAC,CAAmC;gBAE9B,MAAM,EAAE,MAAM;IAElC;;OAEG;IACI,SAAS,CAAC,MAAM,EAAE,aAAa,CAAC,iBAAiB,CAAC,GAAG,IAAI;IAIhE;;;OAGG;IACU,oBAAoB,CAC7B,GAAG,EAAE,aAAa,EAClB,GAAG,EAAE,cAAc,GACpB,OAAO,CAAC,OAAO,CAAC;CAgDtB"}

package/dist/src/server/components/response-control/ResponseControlManager.js

@@ -0,0 +1,60 @@
+/**
+ * ResponseControlManager - Logic for custom response control (e.g. custom 404s)
+ * Works for both Single Server and Multi-Server (XMS) modes.
+ */
+export class ResponseControlManager {
+    constructor(logger) {
+        this.logger = logger;
+    }
+    /**
+     * Update the response control configuration
+     */
+    setConfig(config) {
+        this.config = config;
+    }
+    /**
+     * Execute the custom response if enabled
+     * @returns boolean true if the response was handled, false otherwise
+     */
+    async handleCustomResponse(req, res) {
+        if (!this.config?.enabled) {
+            return false;
+        }
+        try {
+            const { statusCode, headers, contentType, handler, content } = this.config;
+            // 1. Set status code
+            res.statusCode = statusCode || 404;
+            // 2. Set custom headers
+            if (headers) {
+                res.set(headers);
+            }
+            // 3. Set content type
+            if (contentType) {
+                res.setHeader("Content-Type", contentType);
+            }
+            // 4. Execute custom handler if provided
+            if (handler) {
+                await handler(req, res);
+                return true;
+            }
+            // 5. Send custom content if provided
+            if (content !== undefined) {
+                if (typeof content === "object") {
+                    res.json(content);
+                }
+                else {
+                    res.send(content);
+                }
+                return true;
+            }
+            // Default fallback if enabled but no content/handler
+            res.send(`Route not found: ${req.method} ${req.path}`);
+            return true;
+        }
+        catch (error) {
+            this.logger.error("server", `ResponseControlManager: Error executing custom response: ${error.message}`);
+            return false; // Fallback to default NotFoundHandler
+        }
+    }
+}
+//# sourceMappingURL=ResponseControlManager.js.map

package/dist/src/server/components/response-control/ResponseControlManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResponseControlManager.js","sourceRoot":"","sources":["../../../../../src/server/components/response-control/ResponseControlManager.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,OAAO,sBAAsB;IAG/B,YAAoB,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAEtC;;OAEG;IACI,SAAS,CAAC,MAAwC;QACrD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,oBAAoB,CAC7B,GAAkB,EAClB,GAAmB;QAEnB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,IAAI,CAAC;YACD,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;YAE3E,qBAAqB;YACrB,GAAG,CAAC,UAAU,GAAG,UAAU,IAAI,GAAG,CAAC;YAEnC,wBAAwB;YACxB,IAAI,OAAO,EAAE,CAAC;gBACV,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACrB,CAAC;YAED,sBAAsB;YACtB,IAAI,WAAW,EAAE,CAAC;gBACd,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;YAC/C,CAAC;YAED,wCAAwC;YACxC,IAAI,OAAO,EAAE,CAAC;gBACV,MAAM,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;gBACxB,OAAO,IAAI,CAAC;YAChB,CAAC;YAED,qCAAqC;YACrC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBACxB,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;oBAC9B,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACtB,CAAC;qBAAM,CAAC;oBACJ,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACtB,CAAC;gBACD,OAAO,IAAI,CAAC;YAChB,CAAC;YAED,qDAAqD;YACrD,GAAG,CAAC,IAAI,CAAC,oBAAoB,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YACvD,OAAO,IAAI,CAAC;QAChB,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,QAAQ,EACR,4DAA4D,KAAK,CAAC,OAAO,EAAE,CAC9E,CAAC;YACF,OAAO,KAAK,CAAC,CAAC,sCAAsC;QACxD,CAAC;IACL,CAAC;CACJ"}

package/dist/src/server/components/static/IXStaticSchem.d.ts

@@ -0,0 +1,7 @@
+export declare const IXStaticSchem: import("reliant-type").InterfaceSchema<{
+    readonly lruCacheSize?: number | undefined;
+    readonly defaultMaxAge?: "string" | "number?" | undefined;
+    readonly zeroCopy?: boolean | undefined;
+    readonly concurrencyPool?: number | undefined;
+}>;
+//# sourceMappingURL=IXStaticSchem.d.ts.map

package/dist/src/server/components/static/IXStaticSchem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IXStaticSchem.d.ts","sourceRoot":"","sources":["../../../../../src/server/components/static/IXStaticSchem.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa;;;;;EA2BzB,CAAC"}

package/dist/src/server/components/static/IXStaticSchem.js

@@ -0,0 +1,25 @@
+import { Interface, Mod } from "reliant-type";
+export const IXStaticSchem = Mod.deepPartial(Interface({
+    /**
+     * Size of the negative-lookup LRU cache.
+     * Stores non-existent paths to prevent DDoS via disk hits.
+     * @default 5000
+     */
+    lruCacheSize: "number?",
+    /**
+     * Default Cache-Control max-age for all static routes.
+     * Can be a number (seconds) or string (e.g., "1d").
+     */
+    defaultMaxAge: "number?|string?",
+    /**
+     * Enable/Disable zero-copy file transfer via sendfile(2).
+     * @default true
+     */
+    zeroCopy: "boolean?",
+    /**
+     * Maximum number of concurrent goroutines for static I/O in Go engine.
+     * @default 1024
+     */
+    concurrencyPool: "number?",
+}));
+//# sourceMappingURL=IXStaticSchem.js.map

package/dist/src/server/components/static/IXStaticSchem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IXStaticSchem.js","sourceRoot":"","sources":["../../../../../src/server/components/static/IXStaticSchem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC,WAAW,CACxC,SAAS,CAAC;IACN;;;;OAIG;IACH,YAAY,EAAE,SAAS;IAEvB;;;OAGG;IACH,aAAa,EAAE,iBAAiB;IAEhC;;;OAGG;IACH,QAAQ,EAAE,UAAU;IAEpB;;;OAGG;IACH,eAAe,EAAE,SAAS;CAC7B,CAAC,CACL,CAAC"}

package/dist/src/server/components/static/MetaCache.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Lightweight LRU Cache for negative path lookups (anti-DDoS).
+ */
+export declare class XStaticMetaCache {
+    private maxSize;
+    private cache;
+    private keys;
+    constructor(maxSize: number);
+    get(path: string): {
+        exists: boolean;
+    } | null;
+    set(path: string, exists: boolean, ttlMs?: number): void;
+    private delete;
+}
+//# sourceMappingURL=MetaCache.d.ts.map

package/dist/src/server/components/static/MetaCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetaCache.d.ts","sourceRoot":"","sources":["../../../../../src/server/components/static/MetaCache.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,gBAAgB;IAKb,OAAO,CAAC,OAAO;IAJ3B,OAAO,CAAC,KAAK,CACC;IACd,OAAO,CAAC,IAAI,CAAgB;gBAER,OAAO,EAAE,MAAM;IAE5B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAU7C,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,GAAE,MAAc,GAAG,IAAI;IAYtE,OAAO,CAAC,MAAM;CAKjB"}

package/dist/src/server/components/static/MetaCache.js

@@ -0,0 +1,39 @@
+/**
+ * Lightweight LRU Cache for negative path lookups (anti-DDoS).
+ */
+export class XStaticMetaCache {
+    constructor(maxSize) {
+        this.maxSize = maxSize;
+        this.cache = new Map();
+        this.keys = [];
+    }
+    get(path) {
+        const item = this.cache.get(path);
+        if (!item)
+            return null;
+        if (Date.now() > item.expires) {
+            this.delete(path);
+            return null;
+        }
+        return { exists: item.exists };
+    }
+    set(path, exists, ttlMs = 30000) {
+        if (this.cache.has(path)) {
+            this.delete(path);
+        }
+        else if (this.keys.length >= this.maxSize) {
+            const oldest = this.keys.shift();
+            if (oldest)
+                this.cache.delete(oldest);
+        }
+        this.cache.set(path, { exists, expires: Date.now() + ttlMs });
+        this.keys.push(path);
+    }
+    delete(path) {
+        this.cache.delete(path);
+        const idx = this.keys.indexOf(path);
+        if (idx > -1)
+            this.keys.splice(idx, 1);
+    }
+}
+//# sourceMappingURL=MetaCache.js.map

package/dist/src/server/components/static/MetaCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetaCache.js","sourceRoot":"","sources":["../../../../../src/server/components/static/MetaCache.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAKzB,YAAoB,OAAe;QAAf,YAAO,GAAP,OAAO,CAAQ;QAJ3B,UAAK,GACT,IAAI,GAAG,EAAE,CAAC;QACN,SAAI,GAAa,EAAE,CAAC;IAEU,CAAC;IAEhC,GAAG,CAAC,IAAY;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAClB,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IACnC,CAAC;IAEM,GAAG,CAAC,IAAY,EAAE,MAAe,EAAE,QAAgB,KAAK;QAC3D,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACjC,IAAI,MAAM;gBAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAEO,MAAM,CAAC,IAAY;QACvB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,GAAG,GAAG,CAAC,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC3C,CAAC;CACJ"}