xypriss 9.11.13 → 9.12.0

package/dist/src/server/middleware/MiddlewareManager.js

@@ -0,0 +1,217 @@
+/**
+ * Modular Middleware Manager
+ * Handles middleware registration, execution, and management
+ */
+export class MiddlewareManager {
+    constructor(logger) {
+        this.middleware = [];
+        this.logger = logger;
+        this.logger.debug("middleware", "Created new middleware manager");
+    }
+    /**
+     * Register middleware
+     */
+    use(handler, config = {}) {
+        const middlewareConfig = {
+            name: config.name || `middleware_${this.middleware.length + 1}`,
+            enabled: config.enabled !== false,
+            priority: config.priority || 100,
+            description: config.description || "Custom middleware",
+        };
+        const entry = {
+            config: middlewareConfig,
+            handler,
+        };
+        this.middleware.push(entry);
+        // Sort by priority (lower numbers first)
+        this.middleware.sort((a, b) => a.config.priority - b.config.priority);
+        this.logger.debug("middleware", `Registered middleware: ${middlewareConfig.name} (priority: ${middlewareConfig.priority})`);
+        const stack = new Error().stack?.split("\n")[2]?.trim();
+        this.logger.debug("middleware", `Registered middleware: ${middlewareConfig.name} (priority: ${middlewareConfig.priority}) - Handler: ${handler.name || "anonymous"} (args: ${handler.length}) - Source: ${stack}`);
+    }
+    /**
+     * Execute all middleware in order
+     * @returns true if all middleware completed successfully, false if chain was stopped
+     */
+    async execute(req, res) {
+        this.logger.debug("middleware", `Executing ${this.middleware.length} middleware functions`);
+        let error = null;
+        for (let i = 0; i < this.middleware.length; i++) {
+            const entry = this.middleware[i];
+            // 1. Logic for Error Handlers (4 arguments: err, req, res, next)
+            if (entry.handler.length === 4) {
+                if (!error) {
+                    this.logger.debug("middleware", `Skipping error handler during normal flow: ${entry.config.name}`);
+                    continue;
+                }
+            }
+            else {
+                // 2. Logic for Normal Middleware (2 or 3 arguments: req, res, next)
+                if (error) {
+                    this.logger.debug("middleware", `Skipping normal middleware due to previous error: ${entry.config.name}`);
+                    continue;
+                }
+            }
+            if (!entry.config.enabled) {
+                this.logger.debug("middleware", `Skipping disabled middleware: ${entry.config.name}`);
+                continue;
+            }
+            /*
+            this.logger.debug(
+                "middleware",
+                `Executing middleware: ${entry.config.name} (${i + 1}/${
+                    this.middleware.length
+                })`,
+            );
+            */
+            try {
+                let nextCalled = false;
+                let middlewareCompleted = false;
+                const middlewarePromise = new Promise((resolve, reject) => {
+                    try {
+                        const onFinish = () => {
+                            resolve();
+                        };
+                        // Listen for asynchronous response completion
+                        res.once("finish", onFinish);
+                        const nextCallback = (mwError) => {
+                            nextCalled = true;
+                            res.removeListener("finish", onFinish);
+                            if (mwError) {
+                                reject(mwError);
+                            }
+                            else {
+                                resolve();
+                            }
+                        };
+                        if (entry.handler.length === 4) {
+                            // Error handler: (err, req, res, next)
+                            entry.handler(error, req, res, nextCallback);
+                            // Reset error once an error handler is reached to allow recovery
+                            // (Standard Express behavior: error handlers can resolve errors)
+                            error = null;
+                        }
+                        else {
+                            // Normal middleware: (req, res, next)
+                            entry.handler(req, res, nextCallback);
+                        }
+                        // If the middleware completed synchronously and ended the response,
+                        // resolve immediately so we don't leak promises or hang waiting for timeout.
+                        if (res.writableEnded || res.statusCode === 0) {
+                            res.removeListener("finish", onFinish);
+                            resolve();
+                        }
+                    }
+                    catch (e) {
+                        reject(e);
+                    }
+                });
+                try {
+                    await middlewarePromise;
+                    middlewareCompleted = true;
+                }
+                catch (mwError) {
+                    error = mwError;
+                    this.logger.debug("middleware", `Middleware ${entry.config.name} failed:`, mwError);
+                    // Standard behavior: continue to find the next error handler
+                    continue;
+                }
+                if (res.writableEnded) {
+                    /*
+                    this.logger.debug(
+                        "middleware",
+                        `Middleware ${entry.config.name} ended response - stopping chain`,
+                    );
+                    */
+                    return true;
+                }
+            }
+            catch (err) {
+                this.logger.error("middleware", `Critical failure in middleware manager loop for ${entry.config.name}:`, err);
+                error = err;
+            }
+        }
+        if (error) {
+            this.logger.error("middleware", "Request failed with unhandled error:", error);
+            // If we still have an error after all middleware, the request failed
+            return false;
+        }
+        this.logger.debug("middleware", `All middleware completed`);
+        return true;
+    }
+    /**
+     * Check if middleware function expects a next parameter
+     */
+    isMiddlewareWithNext(handler) {
+        return handler.length >= 3; // req, res, next
+    }
+    /**
+     * Get middleware statistics
+     */
+    getStats() {
+        const enabled = this.middleware.filter((m) => m.config.enabled);
+        const disabled = this.middleware.filter((m) => !m.config.enabled);
+        return {
+            total: this.middleware.length,
+            enabled: enabled.length,
+            disabled: disabled.length,
+            middleware: this.middleware.map((m) => ({
+                name: m.config.name,
+                enabled: m.config.enabled,
+                priority: m.config.priority,
+                description: m.config.description,
+            })),
+        };
+    }
+    /**
+     * Enable/disable middleware by name
+     */
+    setMiddlewareEnabled(name, enabled) {
+        const entry = this.middleware.find((m) => m.config.name === name);
+        if (entry) {
+            entry.config.enabled = enabled;
+            this.logger.debug("middleware", `${enabled ? "Enabled" : "Disabled"} middleware: ${name}`);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Remove middleware by name
+     */
+    removeMiddleware(name) {
+        const index = this.middleware.findIndex((m) => m.config.name === name);
+        if (index !== -1) {
+            this.middleware.splice(index, 1);
+            this.logger.debug("middleware", `Removed middleware: ${name}`);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Clear all middleware
+     */
+    clear() {
+        const count = this.middleware.length;
+        this.middleware = [];
+        this.logger.debug("middleware", `Cleared ${count} middleware functions`);
+    }
+    /**
+     * Get middleware by name
+     */
+    getMiddleware(name) {
+        return this.middleware.find((m) => m.config.name === name);
+    }
+    /**
+     * List all middleware names
+     */
+    listMiddleware() {
+        return this.middleware.map((m) => m.config.name);
+    }
+    /**
+     * Get all middleware entries
+     */
+    getAllMiddleware() {
+        return [...this.middleware];
+    }
+}
+//# sourceMappingURL=MiddlewareManager.js.map

package/dist/src/server/middleware/MiddlewareManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MiddlewareManager.js","sourceRoot":"","sources":["../../../../src/server/middleware/MiddlewareManager.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,MAAM,OAAO,iBAAiB;IAI1B,YAAY,MAAc;QAHlB,eAAU,GAAsB,EAAE,CAAC;QAIvC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,gCAAgC,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACI,GAAG,CACN,OAA2B,EAC3B,SAAoC,EAAE;QAEtC,MAAM,gBAAgB,GAAqB;YACvC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,cAAc,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE;YAC/D,OAAO,EAAE,MAAM,CAAC,OAAO,KAAK,KAAK;YACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,GAAG;YAChC,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,mBAAmB;SACzD,CAAC;QAEF,MAAM,KAAK,GAAoB;YAC3B,MAAM,EAAE,gBAAgB;YACxB,OAAO;SACV,CAAC;QAEF,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAE5B,yCAAyC;QACzC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAEtE,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,YAAY,EACZ,0BAA0B,gBAAgB,CAAC,IAAI,eAAe,gBAAgB,CAAC,QAAQ,GAAG,CAC7F,CAAC;QACF,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QACxD,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,YAAY,EACZ,0BAA0B,gBAAgB,CAAC,IAAI,eAAe,gBAAgB,CAAC,QAAQ,gBAAgB,OAAO,CAAC,IAAI,IAAI,WAAW,WAAW,OAAO,CAAC,MAAM,eAAe,KAAK,EAAE,CACpL,CAAC;IACN,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,OAAO,CAAC,GAAY,EAAE,GAAa;QAC5C,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,YAAY,EACZ,aAAa,IAAI,CAAC,UAAU,CAAC,MAAM,uBAAuB,CAC7D,CAAC;QAEF,IAAI,KAAK,GAAQ,IAAI,CAAC;QAEtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAEjC,iEAAiE;YACjE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC7B,IAAI,CAAC,KAAK,EAAE,CAAC;oBACT,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,YAAY,EACZ,8CAA8C,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CACpE,CAAC;oBACF,SAAS;gBACb,CAAC;YACL,CAAC;iBAAM,CAAC;gBACJ,oEAAoE;gBACpE,IAAI,KAAK,EAAE,CAAC;oBACR,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,YAAY,EACZ,qDAAqD,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAC3E,CAAC;oBACF,SAAS;gBACb,CAAC;YACL,CAAC;YAED,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACxB,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,YAAY,EACZ,iCAAiC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CACvD,CAAC;gBACF,SAAS;YACb,CAAC;YAED;;;;;;;cAOE;YAEF,IAAI,CAAC;gBACD,IAAI,UAAU,GAAG,KAAK,CAAC;gBACvB,IAAI,mBAAmB,GAAG,KAAK,CAAC;gBAEhC,MAAM,iBAAiB,GAAG,IAAI,OAAO,CACjC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;oBAChB,IAAI,CAAC;wBACD,MAAM,QAAQ,GAAG,GAAG,EAAE;4BAClB,OAAO,EAAE,CAAC;wBACd,CAAC,CAAC;wBAEF,8CAA8C;wBAC9C,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;wBAE7B,MAAM,YAAY,GAAG,CAAC,OAAa,EAAE,EAAE;4BACnC,UAAU,GAAG,IAAI,CAAC;4BAClB,GAAG,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;4BACvC,IAAI,OAAO,EAAE,CAAC;gCACV,MAAM,CAAC,OAAO,CAAC,CAAC;4BACpB,CAAC;iCAAM,CAAC;gCACJ,OAAO,EAAE,CAAC;4BACd,CAAC;wBACL,CAAC,CAAC;wBAEF,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;4BAC7B,uCAAuC;4BACvC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC;4BAC7C,iEAAiE;4BACjE,iEAAiE;4BACjE,KAAK,GAAG,IAAI,CAAC;wBACjB,CAAC;6BAAM,CAAC;4BACJ,sCAAsC;4BACtC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC;wBAC1C,CAAC;wBAED,oEAAoE;wBACpE,6EAA6E;wBAC7E,IAAI,GAAG,CAAC,aAAa,IAAK,GAAW,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;4BACrD,GAAG,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;4BACvC,OAAO,EAAE,CAAC;wBACd,CAAC;oBACL,CAAC;oBAAC,OAAO,CAAC,EAAE,CAAC;wBACT,MAAM,CAAC,CAAC,CAAC,CAAC;oBACd,CAAC;gBACL,CAAC,CACJ,CAAC;gBAEF,IAAI,CAAC;oBACD,MAAM,iBAAiB,CAAC;oBACxB,mBAAmB,GAAG,IAAI,CAAC;gBAC/B,CAAC;gBAAC,OAAO,OAAO,EAAE,CAAC;oBACf,KAAK,GAAG,OAAO,CAAC;oBAChB,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,YAAY,EACZ,cAAc,KAAK,CAAC,MAAM,CAAC,IAAI,UAAU,EACzC,OAAO,CACV,CAAC;oBACF,6DAA6D;oBAC7D,SAAS;gBACb,CAAC;gBAED,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC;oBACpB;;;;;sBAKE;oBACF,OAAO,IAAI,CAAC;gBAChB,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACX,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,YAAY,EACZ,mDAAmD,KAAK,CAAC,MAAM,CAAC,IAAI,GAAG,EACvE,GAAG,CACN,CAAC;gBACF,KAAK,GAAG,GAAG,CAAC;YAChB,CAAC;QACL,CAAC;QAED,IAAI,KAAK,EAAE,CAAC;YACR,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,YAAY,EACZ,sCAAsC,EACtC,KAAK,CACR,CAAC;YACF,qEAAqE;YACrE,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,0BAA0B,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,oBAAoB,CAAC,OAA2B;QACpD,OAAO,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,iBAAiB;IACjD,CAAC;IAED;;OAEG;IACI,QAAQ;QAWX,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAElE,OAAO;YACH,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM;YAC7B,OAAO,EAAE,OAAO,CAAC,MAAM;YACvB,QAAQ,EAAE,QAAQ,CAAC,MAAM;YACzB,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI;gBACnB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO;gBACzB,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ;gBAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,WAAW;aACpC,CAAC,CAAC;SACN,CAAC;IACN,CAAC;IAED;;OAEG;IACI,oBAAoB,CAAC,IAAY,EAAE,OAAgB;QACtD,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAClE,IAAI,KAAK,EAAE,CAAC;YACR,KAAK,CAAC,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,YAAY,EACZ,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,gBAAgB,IAAI,EAAE,CAC5D,CAAC;YACF,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;OAEG;IACI,gBAAgB,CAAC,IAAY;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACvE,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACf,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACjC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,uBAAuB,IAAI,EAAE,CAAC,CAAC;YAC/D,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;OAEG;IACI,KAAK;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,YAAY,EACZ,WAAW,KAAK,uBAAuB,CAC1C,CAAC;IACN,CAAC;IAED;;OAEG;IACI,aAAa,CAAC,IAAY;QAC7B,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACI,cAAc;QACjB,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACI,gBAAgB;QACnB,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IAChC,CAAC;CACJ"}

package/dist/src/server/routing/Router.d.ts

@@ -0,0 +1,57 @@
+/**
+ * XyPriss Router System — Ultra-Rich Edition
+ * Multi-module enterprise-grade router for XyPrissJS.
+ */
+import { RouteHandler, MiddlewareFunction } from "../../types/httpServer.type";
+import { RouterOptions, MiddlewareEntry } from "../../types/XyPrissRouter.types";
+import { RichRouteDefinition, RichRouteOptions, RouteGroupOptions, RouteRegistryEntry } from "./modules/types";
+import { IRouterInternal } from "./modules/registry";
+export declare class XyPrissRouter implements IRouterInternal {
+    private routes;
+    private middleware;
+    private logger;
+    private routerOptions;
+    static featureResolver: ((flag: string) => boolean) | null;
+    static setFeatureResolver(fn: (flag: string) => boolean): void;
+    constructor(options?: RouterOptions);
+    get upload(): import("../components/fastapi/upload/file-upload").FileUploadAPI;
+    use(middleware: MiddlewareFunction): XyPrissRouter;
+    use(path: string, middleware: MiddlewareFunction): XyPrissRouter;
+    use(path: string, router: XyPrissRouter): XyPrissRouter;
+    get(path: string, options: RichRouteOptions, ...handlers: RouteHandler[]): XyPrissRouter;
+    get(path: string, ...handlers: RouteHandler[]): XyPrissRouter;
+    post(path: string, options: RichRouteOptions, ...handlers: RouteHandler[]): XyPrissRouter;
+    post(path: string, ...handlers: RouteHandler[]): XyPrissRouter;
+    put(path: string, options: RichRouteOptions, ...handlers: RouteHandler[]): XyPrissRouter;
+    put(path: string, ...handlers: RouteHandler[]): XyPrissRouter;
+    patch(path: string, options: RichRouteOptions, ...handlers: RouteHandler[]): XyPrissRouter;
+    patch(path: string, ...handlers: RouteHandler[]): XyPrissRouter;
+    delete(path: string, options: RichRouteOptions, ...handlers: RouteHandler[]): XyPrissRouter;
+    delete(path: string, ...handlers: RouteHandler[]): XyPrissRouter;
+    head(path: string, options: RichRouteOptions, ...handlers: RouteHandler[]): XyPrissRouter;
+    head(path: string, ...handlers: RouteHandler[]): XyPrissRouter;
+    options(path: string, options: RichRouteOptions, ...handlers: RouteHandler[]): XyPrissRouter;
+    options(path: string, ...handlers: RouteHandler[]): XyPrissRouter;
+    all(path: string, options: RichRouteOptions, ...handlers: RouteHandler[]): XyPrissRouter;
+    all(path: string, ...handlers: RouteHandler[]): XyPrissRouter;
+    group(options: RouteGroupOptions, callback: (r: XyPrissRouter) => void): this;
+    version(ver: string, callback: (r: XyPrissRouter) => void): this;
+    redirect(from: string, to: string, status?: 301 | 302 | 307 | 308): this;
+    getRoutes(): RichRouteDefinition[];
+    getAllRoutes(): RichRouteDefinition[];
+    getMiddleware(): MiddlewareEntry[];
+    findById(id: string): RichRouteDefinition | undefined;
+    toRegistry(): RouteRegistryEntry[];
+    getStats(): {
+        totalRoutes: number;
+        activeRoutes: number;
+        totalMiddleware: number;
+        routesByMethod: any;
+        options: RouterOptions;
+    };
+    private _addRichRoute;
+    private _getState;
+}
+export declare const Router: (opts?: RouterOptions) => XyPrissRouter;
+export default Router;
+//# sourceMappingURL=Router.d.ts.map

package/dist/src/server/routing/Router.d.ts.map

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

package/dist/src/server/routing/Router.js

@@ -0,0 +1,173 @@
+/**
+ * XyPriss Router System — Ultra-Rich Edition
+ * Multi-module enterprise-grade router for XyPrissJS.
+ */
+import { Logger } from "../../shared/logger/Logger";
+import { SUPPORTED_HTTP_METHODS } from "../const/http";
+import { Upload } from "../components/fastapi/upload/file-upload";
+import { normalizePath } from "./modules/path";
+import { addRichRoute, mountRouter } from "./modules/registry";
+import { handleGroup } from "./modules/groups";
+export class XyPrissRouter {
+    static setFeatureResolver(fn) {
+        XyPrissRouter.featureResolver = fn;
+    }
+    constructor(options = {}) {
+        this.routes = [];
+        this.middleware = [];
+        this.routerOptions = {
+            caseSensitive: false,
+            mergeParams: false,
+            strict: false,
+            ...options,
+        };
+        this.logger = new Logger({ components: { router: true } });
+    }
+    get upload() {
+        return Upload;
+    }
+    use(pathOrM, mOrR) {
+        try {
+            const isRouter = (obj) => obj instanceof XyPrissRouter ||
+                (obj &&
+                    typeof obj.getRoutes === "function" &&
+                    typeof obj.getMiddleware === "function");
+            if (typeof pathOrM === "function") {
+                this.middleware.push({ handler: pathOrM });
+            }
+            else if (typeof mOrR === "function") {
+                this.middleware.push({
+                    path: normalizePath(pathOrM),
+                    handler: mOrR,
+                });
+            }
+            else if (isRouter(mOrR)) {
+                mountRouter(pathOrM, mOrR, this._getState());
+            }
+            else if (isRouter(pathOrM)) {
+                mountRouter("/", pathOrM, this._getState());
+            }
+        }
+        catch (e) {
+            this.logger.error("router", `Middleware error: ${e}`);
+            throw e;
+        }
+        return this;
+    }
+    get(path, ...args) {
+        return this._addRichRoute("GET", path, args);
+    }
+    post(path, ...args) {
+        return this._addRichRoute("POST", path, args);
+    }
+    put(path, ...args) {
+        return this._addRichRoute("PUT", path, args);
+    }
+    patch(path, ...args) {
+        return this._addRichRoute("PATCH", path, args);
+    }
+    delete(path, ...args) {
+        return this._addRichRoute("DELETE", path, args);
+    }
+    head(path, ...args) {
+        return this._addRichRoute("HEAD", path, args);
+    }
+    options(path, ...args) {
+        return this._addRichRoute("OPTIONS", path, args);
+    }
+    all(path, ...args) {
+        SUPPORTED_HTTP_METHODS.forEach((m) => this._addRichRoute(m, path, args));
+        return this;
+    }
+    // ─── Advanced Features ───────────────────────────────────────────────────
+    group(options, callback) {
+        const child = new XyPrissRouter(this.routerOptions);
+        handleGroup(this, child, options, callback, this._getState());
+        return this;
+    }
+    version(ver, callback) {
+        return this.group({ version: ver }, callback);
+    }
+    redirect(from, to, status = 302) {
+        return this._addRichRoute("GET", from, [
+            {
+                meta: { summary: `Redirect → ${to}`, tags: ["redirect"] },
+                priority: 10,
+            },
+            (req, res) => {
+                let target = to;
+                if (req.params) {
+                    for (const [key, value] of Object.entries(req.params)) {
+                        target = target.replace(`:${key}`, String(value));
+                    }
+                }
+                // Relative redirection logic: if target is absolute-looking (starts with /)
+                // but we are in a scoped router (baseUrl is set), prepend the base.
+                if (target.startsWith("/") && req.baseUrl) {
+                    // Prepend baseUrl but avoid double slashes and avoid double-prefixing
+                    const base = req.baseUrl.replace(/\/$/, "");
+                    if (!target.startsWith(base + "/") && target !== base) {
+                        target = base + target;
+                    }
+                }
+                res.redirect(status, target);
+            },
+        ]);
+    }
+    // ─── Registry & Inspection ───────────────────────────────────────────────
+    getRoutes() {
+        return this.routes.filter((r) => r.active);
+    }
+    getAllRoutes() {
+        return [...this.routes];
+    }
+    getMiddleware() {
+        return [...this.middleware];
+    }
+    findById(id) {
+        return this.routes.find((r) => r.id === id);
+    }
+    toRegistry() {
+        return this.getRoutes().map((r) => ({
+            id: r.id,
+            method: r.method,
+            path: r.originalPath,
+            version: r.version,
+            meta: r.meta,
+            hasGuards: !!r.guards,
+            hasRateLimit: !!r.rateLimit,
+            hasCache: !!r.cache,
+            paramNames: r.paramNames,
+            paramConstraints: r.paramConstraints,
+            responses: r.responses,
+        }));
+    }
+    getStats() {
+        const active = this.getRoutes();
+        return {
+            totalRoutes: this.routes.length,
+            activeRoutes: active.length,
+            totalMiddleware: this.middleware.length,
+            routesByMethod: active.reduce((a, r) => ({ ...a, [r.method]: (a[r.method] || 0) + 1 }), {}),
+            options: this.routerOptions,
+        };
+    }
+    // ─── Internal ───────────────────────────────────────────────────────────
+    _addRichRoute(method, path, args) {
+        addRichRoute(this, method, path, args, this._getState());
+        return this;
+    }
+    _getState() {
+        return {
+            routes: this.routes,
+            middleware: this.middleware,
+            logger: this.logger,
+            options: this.routerOptions,
+            featureResolver: XyPrissRouter.featureResolver,
+        };
+    }
+}
+XyPrissRouter.featureResolver = null;
+export const Router = (opts) => new XyPrissRouter(opts);
+export default Router;
+//# sourceMappingURL=Router.js.map

package/dist/src/server/routing/Router.js.map

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

package/dist/src/server/routing/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * XyPriss Router System Exports
+ */
+export { XyPrissRouter, Router } from "./Router";
+export type { 
+/**
+ * Alias for XyPrisRequest
+ */
+XyPrisRequest as XRequest, 
+/**
+ * Alias for XyPrisResponse
+ */
+XyPrisResponse as XResponse, } from "./modules/types";
+export type { XyPrisRequest, XyPrisResponse } from "./modules/types";
+export { Router as default } from "./Router";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/server/routing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/routing/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEjD,YAAY;AACR;;GAEG;AACH,aAAa,IAAI,QAAQ;AACzB;;GAEG;AACH,cAAc,IAAI,SAAS,GAC9B,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGrE,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,UAAU,CAAC"}

package/dist/src/server/routing/index.js

@@ -0,0 +1,7 @@
+/**
+ * XyPriss Router System Exports
+ */
+export { XyPrissRouter, Router } from "./Router";
+// Default export for convenience (Express-like)
+export { Router as default } from "./Router";
+//# sourceMappingURL=index.js.map

package/dist/src/server/routing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/server/routing/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAejD,gDAAgD;AAChD,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,UAAU,CAAC"}

package/dist/src/server/routing/modules/XyGuard.d.ts

@@ -0,0 +1,34 @@
+import { XyPrisRequest } from "./types";
+/** Supported built-in guard names */
+export type BuiltInGuardName = "authenticated" | "roles" | "permissions";
+export type GuardResolver = (req: XyPrisRequest, options?: any) => boolean | string | Promise<boolean | string>;
+/**
+ * XyGuard - Global registry for built-in guard resolvers.
+ * This allows XyPriss to handle declarative guards like 'authenticated' or 'roles'
+ * without being opinionated about the underlying implementation (session, JWT, etc.).
+ *
+ * @example
+ * ```typescript
+ * import { XyGuard } from "xypriss";
+ *
+ * XyGuard.define('authenticated', (req) => !!req.user);
+ * XyGuard.define('roles', (req, required) => required.includes(req.user?.role));
+ * ```
+ */
+export declare class XyGuard {
+    private static resolvers;
+    /**
+     * Define a resolver for the 'authenticated' guard.
+     */
+    static define(name: "authenticated", resolver: (req: XyPrisRequest) => boolean | string | Promise<boolean | string>): void;
+    /**
+     * Define a resolver for 'roles' or 'permissions' guards.
+     */
+    static define(name: "roles" | "permissions", resolver: (req: XyPrisRequest, required: string[]) => boolean | string | Promise<boolean | string>): void;
+    /**
+     * Get an existing resolver by name.
+     * @internal
+     */
+    static get(name: BuiltInGuardName): GuardResolver | undefined;
+}
+//# sourceMappingURL=XyGuard.d.ts.map

package/dist/src/server/routing/modules/XyGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"XyGuard.d.ts","sourceRoot":"","sources":["../../../../../src/server/routing/modules/XyGuard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,qCAAqC;AACrC,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG,OAAO,GAAG,aAAa,CAAC;AAEzE,MAAM,MAAM,aAAa,GAAG,CACxB,GAAG,EAAE,aAAa,EAClB,OAAO,CAAC,EAAE,GAAG,KACZ,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC;AAElD;;;;;;;;;;;;GAYG;AACH,qBAAa,OAAO;IAChB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAoC;IAE5D;;OAEG;WACW,MAAM,CAChB,IAAI,EAAE,eAAe,EACrB,QAAQ,EAAE,CACN,GAAG,EAAE,aAAa,KACjB,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,GAClD,IAAI;IAEP;;OAEG;WACW,MAAM,CAChB,IAAI,EAAE,OAAO,GAAG,aAAa,EAC7B,QAAQ,EAAE,CACN,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,MAAM,EAAE,KACjB,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,GAClD,IAAI;IASP;;;OAGG;WACW,GAAG,CAAC,IAAI,EAAE,gBAAgB,GAAG,aAAa,GAAG,SAAS;CAGvE"}

package/dist/src/server/routing/modules/XyGuard.js

@@ -0,0 +1,30 @@
+/**
+ * XyGuard - Global registry for built-in guard resolvers.
+ * This allows XyPriss to handle declarative guards like 'authenticated' or 'roles'
+ * without being opinionated about the underlying implementation (session, JWT, etc.).
+ *
+ * @example
+ * ```typescript
+ * import { XyGuard } from "xypriss";
+ *
+ * XyGuard.define('authenticated', (req) => !!req.user);
+ * XyGuard.define('roles', (req, required) => required.includes(req.user?.role));
+ * ```
+ */
+export class XyGuard {
+    /**
+     * Internal implementation of define.
+     */
+    static define(name, resolver) {
+        this.resolvers.set(name, resolver);
+    }
+    /**
+     * Get an existing resolver by name.
+     * @internal
+     */
+    static get(name) {
+        return this.resolvers.get(name);
+    }
+}
+XyGuard.resolvers = new Map();
+//# sourceMappingURL=XyGuard.js.map

package/dist/src/server/routing/modules/XyGuard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"XyGuard.js","sourceRoot":"","sources":["../../../../../src/server/routing/modules/XyGuard.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,OAAO;IAwBhB;;OAEG;IACI,MAAM,CAAC,MAAM,CAAC,IAAY,EAAE,QAAuB;QACtD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,GAAG,CAAC,IAAsB;QACpC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;;AApCc,iBAAS,GAAG,IAAI,GAAG,EAAyB,CAAC"}

package/dist/src/server/routing/modules/constants.d.ts

@@ -0,0 +1,5 @@
+/** Typed param extraction regex */
+export declare const TYPED_PARAM_REGEX: RegExp;
+/** Built-in param patterns for typed routing */
+export declare const BUILTIN_PARAM_PATTERNS: Record<string, string>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/src/server/routing/modules/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/server/routing/modules/constants.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,eAAO,MAAM,iBAAiB,QACkC,CAAC;AAEjE,gDAAgD;AAChD,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQzD,CAAC"}

package/dist/src/server/routing/modules/constants.js

@@ -0,0 +1,13 @@
+/** Typed param extraction regex */
+export const TYPED_PARAM_REGEX = /:([a-zA-Z_$][a-zA-Z0-9_$]*)(?:<([^>]+)>)?(?:\(([^)]+)\))?/g;
+/** Built-in param patterns for typed routing */
+export const BUILTIN_PARAM_PATTERNS = {
+    number: "-?\\d+(?:\\.\\d+)?",
+    integer: "-?\\d+",
+    boolean: "true|false",
+    uuid: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}",
+    alpha: "[a-zA-Z]+",
+    alphanumeric: "[a-zA-Z0-9]+",
+    string: "[^/]+",
+};
+//# sourceMappingURL=constants.js.map

package/dist/src/server/routing/modules/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/server/routing/modules/constants.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,MAAM,CAAC,MAAM,iBAAiB,GAC1B,4DAA4D,CAAC;AAEjE,gDAAgD;AAChD,MAAM,CAAC,MAAM,sBAAsB,GAA2B;IAC1D,MAAM,EAAE,oBAAoB;IAC5B,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,YAAY;IACrB,IAAI,EAAE,8DAA8D;IACpE,KAAK,EAAE,WAAW;IAClB,YAAY,EAAE,cAAc;IAC5B,MAAM,EAAE,OAAO;CAClB,CAAC"}

package/dist/src/server/routing/modules/groups.d.ts

@@ -0,0 +1,14 @@
+import type { XyPrissRouter } from "../Router";
+import { RichRouteDefinition, RouteGroupOptions } from "./types";
+import { MiddlewareEntry } from "../../../types/XyPrissRouter.types";
+/**
+ * Handles router.group() logic.
+ */
+export declare function handleGroup(parentRouter: XyPrissRouter, childRouter: XyPrissRouter, options: RouteGroupOptions, callback: (router: XyPrissRouter) => void, internalState: {
+    routes: RichRouteDefinition[];
+    middleware: MiddlewareEntry[];
+    logger: any;
+    options: any;
+    featureResolver: ((flag: string) => boolean) | null;
+}): void;
+//# sourceMappingURL=groups.d.ts.map

package/dist/src/server/routing/modules/groups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groups.d.ts","sourceRoot":"","sources":["../../../../../src/server/routing/modules/groups.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EACH,mBAAmB,EACnB,iBAAiB,EAIpB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAGrE;;GAEG;AACH,wBAAgB,WAAW,CACvB,YAAY,EAAE,aAAa,EAC3B,WAAW,EAAE,aAAa,EAC1B,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,EACzC,aAAa,EAAE;IACX,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,MAAM,EAAE,GAAG,CAAC;IACZ,OAAO,EAAE,GAAG,CAAC;IACb,eAAe,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,IAAI,CAAC;CACvD,GACF,IAAI,CAoEN"}