xypriss 9.11.13 → 9.12.0

package/dist/src/server/core/http/HttpErrorHandler.d.ts

@@ -0,0 +1,17 @@
+import { Logger } from "../../../shared/logger/Logger";
+import { NotFoundHandler } from "../../handlers/NotFoundHandler";
+import { XyPrisRequest, XyPrisResponse, NextFunction } from "../../../types/httpServer.type";
+import { ResponseControlManager } from "../../components/response-control/ResponseControlManager";
+/**
+ * HttpErrorHandler - Handles request errors and 404 responses.
+ */
+export declare class HttpErrorHandler {
+    private logger;
+    private notFoundHandler;
+    constructor(logger: Logger, notFoundHandler: NotFoundHandler | null);
+    send404(req: XyPrisRequest, res: XyPrisResponse, responseControlManager?: ResponseControlManager): Promise<void>;
+    handleError(error: any, req: XyPrisRequest, res: XyPrisResponse, app: any, errorHandler?: (error: any, req: XyPrisRequest, res: XyPrisResponse, next: NextFunction) => void, send404Callback?: (req: XyPrisRequest, res: XyPrisResponse) => Promise<void>): void;
+    sendErrorResponse(res: XyPrisResponse, statusCode: number, message: string): void;
+    setupDefaultErrorHandler(server: any): void;
+}
+//# sourceMappingURL=HttpErrorHandler.d.ts.map

package/dist/src/server/core/http/HttpErrorHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpErrorHandler.d.ts","sourceRoot":"","sources":["../../../../../src/server/core/http/HttpErrorHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EACH,aAAa,EACb,cAAc,EACd,YAAY,EACf,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0DAA0D,CAAC;AAElG;;GAEG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,eAAe,CAAyB;gBAEpC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,eAAe,GAAG,IAAI;IAKtD,OAAO,CAChB,GAAG,EAAE,aAAa,EAClB,GAAG,EAAE,cAAc,EACnB,sBAAsB,CAAC,EAAE,sBAAsB,GAChD,OAAO,CAAC,IAAI,CAAC;IAgBT,WAAW,CACd,KAAK,EAAE,GAAG,EACV,GAAG,EAAE,aAAa,EAClB,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,GAAG,EACR,YAAY,CAAC,EAAE,CACX,KAAK,EAAE,GAAG,EACV,GAAG,EAAE,aAAa,EAClB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,YAAY,KACjB,IAAI,EACT,eAAe,CAAC,EAAE,CACd,GAAG,EAAE,aAAa,EAClB,GAAG,EAAE,cAAc,KAClB,OAAO,CAAC,IAAI,CAAC,GACnB,IAAI;IAqBA,iBAAiB,CACpB,GAAG,EAAE,cAAc,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GAChB,IAAI;IAIA,wBAAwB,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI;CAKrD"}

package/dist/src/server/core/http/HttpErrorHandler.js

@@ -0,0 +1,49 @@
+/**
+ * HttpErrorHandler - Handles request errors and 404 responses.
+ */
+export class HttpErrorHandler {
+    constructor(logger, notFoundHandler) {
+        this.logger = logger;
+        this.notFoundHandler = notFoundHandler;
+    }
+    async send404(req, res, responseControlManager) {
+        if (responseControlManager) {
+            const handled = await responseControlManager.handleCustomResponse(req, res);
+            if (handled)
+                return;
+        }
+        if (this.notFoundHandler) {
+            this.notFoundHandler.handler(req, res);
+        }
+        else if (!res.headersSent) {
+            res.status(404).send("404 Not Found");
+        }
+    }
+    handleError(error, req, res, app, errorHandler, send404Callback) {
+        this.logger.error("server", `Request error: ${error.message}`, error);
+        const pluginManager = app?.pluginManager;
+        if (pluginManager &&
+            typeof pluginManager.triggerRouteError === "function") {
+            pluginManager.triggerRouteError(error, req, res);
+        }
+        if (errorHandler) {
+            errorHandler(error, req, res, () => {
+                if (!res.writableEnded)
+                    this.sendErrorResponse(res, 500, "Internal Server Error");
+            });
+        }
+        else {
+            this.sendErrorResponse(res, 500, "Internal Server Error");
+        }
+    }
+    sendErrorResponse(res, statusCode, message) {
+        if (!res.headersSent)
+            res.status(statusCode).json({ error: message });
+    }
+    setupDefaultErrorHandler(server) {
+        server.on("error", (error) => {
+            this.logger.error("server", `Server error: ${error.message}`);
+        });
+    }
+}
+//# sourceMappingURL=HttpErrorHandler.js.map

package/dist/src/server/core/http/HttpErrorHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpErrorHandler.js","sourceRoot":"","sources":["../../../../../src/server/core/http/HttpErrorHandler.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAIzB,YAAY,MAAc,EAAE,eAAuC;QAC/D,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;IAC3C,CAAC;IAEM,KAAK,CAAC,OAAO,CAChB,GAAkB,EAClB,GAAmB,EACnB,sBAA+C;QAE/C,IAAI,sBAAsB,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,MAAM,sBAAsB,CAAC,oBAAoB,CAC7D,GAAG,EACH,GAAG,CACN,CAAC;YACF,IAAI,OAAO;gBAAE,OAAO;QACxB,CAAC;QAED,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,GAAU,EAAE,GAAU,CAAC,CAAC;QACzD,CAAC;aAAM,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;YAC1B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC1C,CAAC;IACL,CAAC;IAEM,WAAW,CACd,KAAU,EACV,GAAkB,EAClB,GAAmB,EACnB,GAAQ,EACR,YAKS,EACT,eAGkB;QAElB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,kBAAkB,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;QAEtE,MAAM,aAAa,GAAG,GAAG,EAAE,aAAa,CAAC;QACzC,IACI,aAAa;YACb,OAAO,aAAa,CAAC,iBAAiB,KAAK,UAAU,EACvD,CAAC;YACC,aAAa,CAAC,iBAAiB,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QACrD,CAAC;QAED,IAAI,YAAY,EAAE,CAAC;YACf,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;gBAC/B,IAAI,CAAC,GAAG,CAAC,aAAa;oBAClB,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,uBAAuB,CAAC,CAAC;YAClE,CAAC,CAAC,CAAC;QACP,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,uBAAuB,CAAC,CAAC;QAC9D,CAAC;IACL,CAAC;IAEM,iBAAiB,CACpB,GAAmB,EACnB,UAAkB,EAClB,OAAe;QAEf,IAAI,CAAC,GAAG,CAAC,WAAW;YAAE,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1E,CAAC;IAEM,wBAAwB,CAAC,MAAW;QACvC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAU,EAAE,EAAE;YAC9B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,iBAAiB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;IACP,CAAC;CACJ"}

package/dist/src/server/core/http/RequestForwarder.d.ts

@@ -0,0 +1,11 @@
+import { Logger } from "../../../shared/logger/Logger";
+import { XyPrisRequest } from "../../../types/httpServer.type";
+/**
+ * RequestForwarder - Handles server-side request forwarding (req.forward).
+ */
+export declare class RequestForwarder {
+    private logger;
+    constructor(logger: Logger);
+    forward(req: any, XyPrisReq: XyPrisRequest, url: string, options?: any): Promise<any>;
+}
+//# sourceMappingURL=RequestForwarder.d.ts.map

package/dist/src/server/core/http/RequestForwarder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestForwarder.d.ts","sourceRoot":"","sources":["../../../../../src/server/core/http/RequestForwarder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAE/D;;GAEG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;IAIb,OAAO,CAChB,GAAG,EAAE,GAAG,EACR,SAAS,EAAE,aAAa,EACxB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,GAAQ,GAClB,OAAO,CAAC,GAAG,CAAC;CAuClB"}

package/dist/src/server/core/http/RequestForwarder.js

@@ -0,0 +1,41 @@
+/**
+ * RequestForwarder - Handles server-side request forwarding (req.forward).
+ */
+export class RequestForwarder {
+    constructor(logger) {
+        this.logger = logger;
+    }
+    async forward(req, XyPrisReq, url, options = {}) {
+        const targetUrl = url.startsWith("http")
+            ? url
+            : `http://localhost:${req.socket.localPort}${url.startsWith("/") ? "" : "/"}${url}`;
+        const forwardOptions = {
+            method: options.method || XyPrisReq.method,
+            headers: {
+                ...XyPrisReq.headers,
+                ...options.headers,
+            },
+            body: options.body ||
+                (XyPrisReq.method !== "GET" && XyPrisReq.method !== "HEAD"
+                    ? JSON.stringify(XyPrisReq.body)
+                    : undefined),
+            ...options,
+        };
+        // Remove headers that might cause issues with forwarding
+        delete forwardOptions.headers["host"];
+        delete forwardOptions.headers["content-length"];
+        try {
+            const response = await fetch(targetUrl, forwardOptions);
+            const contentType = response.headers.get("content-type");
+            if (contentType && contentType.includes("application/json")) {
+                return await response.json();
+            }
+            return await response.text();
+        }
+        catch (error) {
+            this.logger.error("server", `Forwarding request to ${targetUrl} failed: ${error}`);
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=RequestForwarder.js.map

package/dist/src/server/core/http/RequestForwarder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestForwarder.js","sourceRoot":"","sources":["../../../../../src/server/core/http/RequestForwarder.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAGzB,YAAY,MAAc;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAEM,KAAK,CAAC,OAAO,CAChB,GAAQ,EACR,SAAwB,EACxB,GAAW,EACX,UAAe,EAAE;QAEjB,MAAM,SAAS,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC;YACpC,CAAC,CAAC,GAAG;YACL,CAAC,CAAC,oBAAoB,GAAG,CAAC,MAAM,CAAC,SAAS,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC;QAExF,MAAM,cAAc,GAAG;YACnB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC,MAAM;YAC1C,OAAO,EAAE;gBACL,GAAG,SAAS,CAAC,OAAO;gBACpB,GAAG,OAAO,CAAC,OAAO;aACrB;YACD,IAAI,EACA,OAAO,CAAC,IAAI;gBACZ,CAAC,SAAS,CAAC,MAAM,KAAK,KAAK,IAAI,SAAS,CAAC,MAAM,KAAK,MAAM;oBACtD,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC;oBAChC,CAAC,CAAC,SAAS,CAAC;YACpB,GAAG,OAAO;SACb,CAAC;QAEF,yDAAyD;QACzD,OAAO,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACtC,OAAO,cAAc,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAEhD,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;YACxD,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAEzD,IAAI,WAAW,IAAI,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBAC1D,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACjC,CAAC;YACD,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,QAAQ,EACR,yBAAyB,SAAS,YAAY,KAAK,EAAE,CACxD,CAAC;YACF,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;CACJ"}

package/dist/src/server/core/http/RouteManager.d.ts

@@ -0,0 +1,16 @@
+import { Logger } from "../../../shared/logger/Logger";
+import { Route, XyPrisRequest, MiddlewareFunction, RouteHandler } from "../../../types/httpServer.type";
+/**
+ * RouteManager - Handles route registration and matching.
+ */
+export declare class RouteManager {
+    private routes;
+    private logger;
+    constructor(logger: Logger);
+    addRoute(method: string, path: string | RegExp, handlers: (MiddlewareFunction | RouteHandler)[]): void;
+    addRouteWithParams(method: string, path: RegExp, paramNames: string[], handlers: (MiddlewareFunction | RouteHandler)[]): void;
+    findRoute(method: string, path: string, req: XyPrisRequest): Route | null;
+    private matchPath;
+    getRoutes(): Route[];
+}
+//# sourceMappingURL=RouteManager.d.ts.map

package/dist/src/server/core/http/RouteManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteManager.d.ts","sourceRoot":"","sources":["../../../../../src/server/core/http/RouteManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACvD,OAAO,EACH,KAAK,EACL,aAAa,EACb,kBAAkB,EAClB,YAAY,EACf,MAAM,gCAAgC,CAAC;AAExC;;GAEG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;IAInB,QAAQ,CACX,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,QAAQ,EAAE,CAAC,kBAAkB,GAAG,YAAY,CAAC,EAAE,GAChD,IAAI;IAoBA,kBAAkB,CACrB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAAE,EACpB,QAAQ,EAAE,CAAC,kBAAkB,GAAG,YAAY,CAAC,EAAE,GAChD,IAAI;IAOA,SAAS,CACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,aAAa,GACnB,KAAK,GAAG,IAAI;IA+Cf,OAAO,CAAC,SAAS;IAsCV,SAAS,IAAI,KAAK,EAAE;CAG9B"}

package/dist/src/server/core/http/RouteManager.js

@@ -0,0 +1,103 @@
+/**
+ * RouteManager - Handles route registration and matching.
+ */
+export class RouteManager {
+    constructor(logger) {
+        this.routes = [];
+        this.logger = logger;
+    }
+    addRoute(method, path, handlers) {
+        const middleware = handlers.slice(0, -1);
+        const handler = handlers[handlers.length - 1];
+        let normalizedPath = path;
+        if (typeof normalizedPath === "string" &&
+            normalizedPath.length > 1 &&
+            normalizedPath.endsWith("/")) {
+            normalizedPath = normalizedPath.slice(0, -1);
+        }
+        this.routes.push({ method, path: normalizedPath, handler, middleware });
+        this.logger.debug("server", `Route registered: ${method} ${normalizedPath}`);
+    }
+    addRouteWithParams(method, path, paramNames, handlers) {
+        const middleware = handlers.slice(0, -1);
+        const handler = handlers[handlers.length - 1];
+        this.routes.push({ method, path, handler, middleware, paramNames });
+    }
+    findRoute(method, path, req) {
+        for (const route of this.routes) {
+            if (route.method !== method)
+                continue;
+            // 1. RegExp matching (highest precision, supports constraints/wildcards)
+            if (route.path instanceof RegExp) {
+                const match = route.path.exec(path);
+                if (match) {
+                    const params = {};
+                    if (match.length > 1 && route.paramNames) {
+                        for (let i = 1; i < match.length; i++) {
+                            if (match[i] !== undefined &&
+                                route.paramNames[i - 1]) {
+                                params[route.paramNames[i - 1]] = match[i];
+                            }
+                        }
+                    }
+                    else if (match.length > 1 && match[1] !== undefined) {
+                        params["*"] = match[1];
+                    }
+                    req.params = { ...req.params, ...params };
+                    return route;
+                }
+            }
+            // 2. String matching (fallback for simple static or basic parameterized paths)
+            else if (typeof route.path === "string") {
+                // If path contains complex markers, it MUST be matched via RegExp (handled above)
+                // If it reached here as a string, it might be a simple path or a legacy fallback
+                if (route.path.includes("(") ||
+                    route.path.includes("<") ||
+                    route.path.includes("**")) {
+                    continue; // Skip naive matching for complex routes
+                }
+                const params = this.matchPath(route.path, path);
+                if (params !== null) {
+                    req.params = { ...req.params, ...params };
+                    return route;
+                }
+            }
+        }
+        return null;
+    }
+    matchPath(routePath, requestPath) {
+        if (routePath === requestPath)
+            return {};
+        // Final sanity check: if it has complex markers, matchPath is NOT safe
+        if (routePath.includes("(") ||
+            routePath.includes("<") ||
+            routePath.includes("**")) {
+            return null;
+        }
+        const routeParts = routePath.split("/");
+        const requestParts = requestPath.split("/");
+        if (routeParts.length !== requestParts.length)
+            return null;
+        const params = {};
+        for (let i = 0; i < routeParts.length; i++) {
+            const rp = routeParts[i];
+            const qp = requestParts[i];
+            if (rp.startsWith(":")) {
+                const paramName = rp.substring(1);
+                // Ensure paramName doesn't contain type metadata (double protection)
+                if (paramName.includes("<") || paramName.includes("(")) {
+                    return null;
+                }
+                params[paramName] = qp;
+            }
+            else if (rp !== qp) {
+                return null;
+            }
+        }
+        return params;
+    }
+    getRoutes() {
+        return [...this.routes];
+    }
+}
+//# sourceMappingURL=RouteManager.js.map

package/dist/src/server/core/http/RouteManager.js.map

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

package/dist/src/server/core/request/XyRequestManager.d.ts

@@ -0,0 +1,57 @@
+import { ServerOptions } from "../../../types/types";
+import { XyprissApp } from "../XyprissApp";
+/**
+ * XyRequestManager - Dedicated module for handling request lifecycle,
+ * timeouts, concurrency, and advanced queuing.
+ *
+ * Performance Note: Heavy enforcement (Limits/Queuing) is delegated to Rust (XHSC)
+ * while business logic callbacks and middleware orchestration remain in TypeScript.
+ */
+export declare class XyRequestManager {
+    private app;
+    private logger;
+    private options;
+    private activeRequestsByIP;
+    private totalActiveRequests;
+    constructor(app: XyprissApp, options: ServerOptions["requestManagement"]);
+    /**
+     * Initialize the request management stack
+     */
+    initialize(): void;
+    /**
+     * Handle application-level timeouts with support for route-specific overrides
+     * and custom handlers.
+     */
+    private setupTimeoutMiddleware;
+    /**
+     * Handle concurrency limits and basic queuing at the application level.
+     * Note: High-performance enforcement is handled by Rust before reaching here.
+     */
+    private setupConcurrencyMiddleware;
+    /**
+     * Handle payload validation and restrictions
+     */
+    private setupPayloadMiddleware;
+    /**
+     * Monitor request lifecycle and timing
+     */
+    private setupLifecycleMiddleware;
+    /**
+     * Get current live statistics of request management
+     */
+    getStats(): Promise<{
+        native: any;
+        totalActive: number;
+        uniqueIPs: number;
+        timeoutEnabled: boolean;
+        concurrencyEnabled: boolean;
+    } | {
+        nativeError: any;
+        totalActive: number;
+        uniqueIPs: number;
+        timeoutEnabled: boolean;
+        concurrencyEnabled: boolean;
+    }>;
+    private fetchRustStats;
+}
+//# sourceMappingURL=XyRequestManager.d.ts.map

package/dist/src/server/core/request/XyRequestManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"XyRequestManager.d.ts","sourceRoot":"","sources":["../../../../../src/server/core/request/XyRequestManager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAI3C;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAOrB,OAAO,CAAC,GAAG;IANf,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,kBAAkB,CAA6B;IACvD,OAAO,CAAC,mBAAmB,CAAK;gBAGpB,GAAG,EAAE,UAAU,EACvB,OAAO,EAAE,aAAa,CAAC,mBAAmB,CAAC;IAM/C;;OAEG;IACI,UAAU,IAAI,IAAI;IAuBzB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAsC9B;;;OAGG;IACH,OAAO,CAAC,0BAA0B;IA2DlC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA2C9B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA+ChC;;OAEG;IACU,QAAQ;;;;;;;;;;;;;YAuBP,cAAc;CAW/B"}

package/dist/src/server/core/request/XyRequestManager.js

@@ -0,0 +1,226 @@
+import { Configs } from "../../../ConfigurationManager";
+/**
+ * XyRequestManager - Dedicated module for handling request lifecycle,
+ * timeouts, concurrency, and advanced queuing.
+ *
+ * Performance Note: Heavy enforcement (Limits/Queuing) is delegated to Rust (XHSC)
+ * while business logic callbacks and middleware orchestration remain in TypeScript.
+ */
+export class XyRequestManager {
+    constructor(app, options) {
+        this.app = app;
+        this.activeRequestsByIP = new Map();
+        this.totalActiveRequests = 0;
+        this.logger = app.logger;
+        this.options = options;
+    }
+    /**
+     * Initialize the request management stack
+     */
+    initialize() {
+        if (!this.options)
+            return;
+        if (!this.app.configs?.isAuxiliary) {
+            this.logger.info("server", "Initializing XRMS (XyPriss Request Management System)...");
+        }
+        // 1. Setup Timeout Middleware
+        this.setupTimeoutMiddleware();
+        // 2. Setup Concurrency & Queuing Middleware
+        this.setupConcurrencyMiddleware();
+        // 3. Setup Payload Middleware (Custom Validators, URL Length)
+        this.setupPayloadMiddleware();
+        // 4. Setup Lifecycle Middleware (Monitoring, Timing)
+        this.setupLifecycleMiddleware();
+    }
+    /**
+     * Handle application-level timeouts with support for route-specific overrides
+     * and custom handlers.
+     */
+    setupTimeoutMiddleware() {
+        if (!this.options?.timeout?.enabled)
+            return;
+        this.logger.debug("middleware", "Request timeout middleware activated");
+        this.app.use((req, res, next) => {
+            const route = req.route?.path || req.path;
+            const config = this.options.timeout;
+            const timeout = config.routes?.[route] || config.defaultTimeout || 30000;
+            const timeoutId = setTimeout(() => {
+                if (!res.headersSent) {
+                    if (config.onTimeout) {
+                        config.onTimeout(req, res);
+                    }
+                    else {
+                        res.status(408).xJson({
+                            error: "Request timeout (middleware)",
+                            timeout: timeout,
+                            message: config.errorMessage,
+                            path: req.path,
+                            ...(config.includeStackTrace && {
+                                stack: new Error().stack,
+                            }),
+                        });
+                    }
+                }
+            }, timeout);
+            // Cleanup
+            res.on("finish", () => clearTimeout(timeoutId));
+            res.on("close", () => clearTimeout(timeoutId));
+            next();
+        });
+    }
+    /**
+     * Handle concurrency limits and basic queuing at the application level.
+     * Note: High-performance enforcement is handled by Rust before reaching here.
+     */
+    setupConcurrencyMiddleware() {
+        const config = this.options?.concurrency;
+        if (!config || (!config.maxConcurrentRequests && !config.maxPerIP))
+            return;
+        this.logger.debug("middleware", "Concurrency control middleware activated");
+        this.app.use((req, res, next) => {
+            const clientIP = req.ip || req.connection.remoteAddress;
+            const maxTotal = config.maxConcurrentRequests || Infinity;
+            const maxPerIP = config.maxPerIP || Infinity;
+            const currentPerIP = this.activeRequestsByIP.get(clientIP) || 0;
+            // Check limits (Safety Net - Rust normally blocks this first)
+            if (this.totalActiveRequests >= maxTotal ||
+                currentPerIP >= maxPerIP) {
+                if (config.onQueueOverflow) {
+                    return config.onQueueOverflow(req, res);
+                }
+                else {
+                    return res.status(429).xJson({
+                        error: "Too many concurrent requests",
+                        totalActive: this.totalActiveRequests,
+                        limit: maxTotal,
+                        perIP: currentPerIP,
+                        perIPLimit: maxPerIP,
+                    });
+                }
+            }
+            // Track request start
+            this.totalActiveRequests++;
+            this.activeRequestsByIP.set(clientIP, currentPerIP + 1);
+            // Track request completion
+            const cleanup = () => {
+                this.totalActiveRequests--;
+                const count = this.activeRequestsByIP.get(clientIP) || 1;
+                if (count <= 1) {
+                    this.activeRequestsByIP.delete(clientIP);
+                }
+                else {
+                    this.activeRequestsByIP.set(clientIP, count - 1);
+                }
+                res.removeListener("finish", cleanup);
+                res.removeListener("close", cleanup);
+            };
+            res.on("finish", cleanup);
+            res.on("close", cleanup);
+            next();
+        });
+    }
+    /**
+     * Handle payload validation and restrictions
+     */
+    setupPayloadMiddleware() {
+        const config = this.options?.payload;
+        if (!config)
+            return;
+        this.logger.debug("middleware", "Payload validation middleware activated");
+        this.app.use(async (req, res, next) => {
+            // 1. Max URL Length (JS Backup - Rust handles this efficiently too)
+            if (config.maxUrlLength && req.url.length > config.maxUrlLength) {
+                return res.status(414).xJson({
+                    error: "URI Too Long",
+                    maxLength: config.maxUrlLength,
+                    currentLength: req.url.length,
+                });
+            }
+            // 2. Custom Validator
+            if (config.customValidator) {
+                try {
+                    const isValid = await config.customValidator(req);
+                    if (!isValid) {
+                        return res.status(400).xJson({
+                            error: "Invalid Request (Custom Validator Failed)",
+                        });
+                    }
+                }
+                catch (e) {
+                    this.logger.error("middleware", `Custom validator error: ${e.message}`);
+                    return res.status(500).xJson({
+                        error: "Internal Server Error (Validator)",
+                    });
+                }
+            }
+            next();
+        });
+    }
+    /**
+     * Monitor request lifecycle and timing
+     */
+    setupLifecycleMiddleware() {
+        const config = this.options?.lifecycle;
+        // Check strict enabled flag if present, otherwise default to enabled if config exists
+        if (!config || config.enabled === false)
+            return;
+        this.logger.debug("middleware", "Lifecycle monitoring middleware activated");
+        this.app.use((req, res, next) => {
+            const start = Date.now();
+            if (config.trackStartTime) {
+                req._startTime = start;
+                req.headers["x-request-start"] = start.toString();
+            }
+            if (config.onLifecycleEvent) {
+                config.onLifecycleEvent("start", req, { start });
+            }
+            const cleanup = () => {
+                const duration = Date.now() - start;
+                if (config.warnAfter && duration > config.warnAfter) {
+                    this.logger.warn("server", `Slow Request: ${req.method} ${req.url} took ${duration}ms (Threshold: ${config.warnAfter}ms)`);
+                }
+                if (config.onLifecycleEvent) {
+                    config.onLifecycleEvent("end", req, { duration });
+                }
+                res.removeListener("finish", cleanup);
+                res.removeListener("close", cleanup);
+            };
+            res.on("finish", cleanup);
+            res.on("close", cleanup);
+            next();
+        });
+    }
+    /**
+     * Get current live statistics of request management
+     */
+    async getStats() {
+        const jsStats = {
+            totalActive: this.totalActiveRequests,
+            uniqueIPs: this.activeRequestsByIP.size,
+            timeoutEnabled: this.options?.timeout?.enabled || false,
+            concurrencyEnabled: !!this.options?.concurrency,
+        };
+        try {
+            // Fetch native stats from XHSC
+            const rustStats = await this.fetchRustStats();
+            return {
+                ...jsStats,
+                native: rustStats,
+            };
+        }
+        catch (e) {
+            return {
+                ...jsStats,
+                nativeError: e.message,
+            };
+        }
+    }
+    async fetchRustStats() {
+        // Assuming XHSC is running on the configured port
+        const port = this.app.getPort();
+        const response = await fetch(`http://${Configs.get("server")?.host || "127.0.0.1"}:${port}/_xypriss/b/status`);
+        const data = await response.json();
+        return data.concurrency;
+    }
+}
+//# sourceMappingURL=XyRequestManager.js.map

package/dist/src/server/core/request/XyRequestManager.js.map

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

package/dist/src/server/handlers/NotFoundHandler.d.ts

@@ -0,0 +1,25 @@
+/**
+ * XyPriss Custom 404 Not Found Handler
+ *
+ * Customizable 404 error pages with XyPriss branding
+ * and user configuration options.
+ */
+import { ServerOptions, Request, Response } from "../ServerFactory";
+import { NotFoundConfig } from "../../types/NotFoundConfig";
+export declare class NotFoundHandler {
+    private config;
+    constructor();
+    /**
+     * XyPriss middleware handler for 404 errors
+     */
+    handler: (req: Request, res: Response) => void;
+    /**
+     * Update configuration
+     */
+    updateConfig(newConfig: Partial<NotFoundConfig>): void;
+}
+/**
+ * Create NotFoundHandler from ServerOptions
+ */
+export declare function createNotFoundHandler(options: ServerOptions): NotFoundHandler | null;
+//# sourceMappingURL=NotFoundHandler.d.ts.map

package/dist/src/server/handlers/NotFoundHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotFoundHandler.d.ts","sourceRoot":"","sources":["../../../../src/server/handlers/NotFoundHandler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEpE,OAAO,EACH,cAAc,EAGjB,MAAM,4BAA4B,CAAC;AAMpC,qBAAa,eAAe;IACxB,OAAO,CAAC,MAAM,CAAiB;;IAQ/B;;OAEG;IACI,OAAO,GAAI,KAAK,OAAO,EAAE,KAAK,QAAQ,KAAG,IAAI,CAwClD;IAEF;;OAEG;IACI,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;CAIhE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACjC,OAAO,EAAE,aAAa,GACvB,eAAe,GAAG,IAAI,CAexB"}