@shohaghinfo/aerojs 0.1.0

package/dist/router.js

@@ -0,0 +1,341 @@
+/**
+ * @file router.ts
+ * @description Radix Tree routing engine supporting route params, wildcards, and method matching.
+ */
+/**
+ * Node within the Radix Tree structure.
+ */
+class RadixNode {
+    /**
+     * Exact match child nodes mapped by path segment.
+     */
+    children = new Map();
+    /**
+     * Parameter child node (e.g., `:id`).
+     */
+    paramChild;
+    /**
+     * Wildcard child node (e.g., `*` or `*filepath`).
+     */
+    wildcardChild;
+    /**
+     * Registered routes on this node mapped by HTTP method.
+     */
+    routes = new Map();
+}
+/**
+ * Normalizes a URL path by stripping trailing slashes while preserving root `/`.
+ *
+ * @param path - Input URL path.
+ * @returns Normalized URL path.
+ */
+export function normalizePath(path) {
+    if (!path || path === '/') {
+        return '/';
+    }
+    const stripped = path.endsWith('/') ? path.slice(0, -1) : path;
+    return stripped.startsWith('/') ? stripped : `/${stripped}`;
+}
+/**
+ * Splits a path into constituent segments for Radix Tree indexing.
+ *
+ * @param path - URL path.
+ * @returns Array of non-empty segment strings.
+ */
+function splitPath(path) {
+    const norm = normalizePath(path);
+    if (norm === '/') {
+        return [];
+    }
+    return norm.slice(1).split('/');
+}
+/**
+ * Chainable route builder for configuring multiple HTTP methods on a single path.
+ */
+export class RouteChain {
+    router;
+    path;
+    constructor(router, path) {
+        this.router = router;
+        this.path = path;
+    }
+    get(...handlers) {
+        this.router.get(this.path, ...handlers);
+        return this;
+    }
+    post(...handlers) {
+        this.router.post(this.path, ...handlers);
+        return this;
+    }
+    put(...handlers) {
+        this.router.put(this.path, ...handlers);
+        return this;
+    }
+    patch(...handlers) {
+        this.router.patch(this.path, ...handlers);
+        return this;
+    }
+    delete(...handlers) {
+        this.router.delete(this.path, ...handlers);
+        return this;
+    }
+    all(...handlers) {
+        this.router.all(this.path, ...handlers);
+        return this;
+    }
+    options(...handlers) {
+        this.router.options(this.path, ...handlers);
+        return this;
+    }
+    head(...handlers) {
+        this.router.head(this.path, ...handlers);
+        return this;
+    }
+}
+/**
+ * High-performance Radix Tree router supporting route parameters,
+ * wildcards, trailing-slash normalization, and 405 Method Not Allowed discovery.
+ */
+export class Router {
+    root = new RadixNode();
+    allRoutes = [];
+    /**
+     * Registers a new route in the Radix Tree.
+     *
+     * @param method - HTTP method (e.g., 'GET', 'POST', 'ALL').
+     * @param path - URL pattern (e.g., '/users/:id/posts/:postId').
+     * @param handlers - One or more middleware handlers.
+     * @returns this
+     */
+    add(method, path, handlers, schema) {
+        const upperMethod = method.toUpperCase();
+        const normalized = normalizePath(path);
+        const segments = splitPath(normalized);
+        let current = this.root;
+        for (let i = 0; i < segments.length; i++) {
+            const segment = segments[i];
+            if (segment.startsWith('*')) {
+                // Wildcard segment: captures remainder of path
+                const paramName = segment.length > 1 ? segment.slice(1) : '*';
+                if (!current.wildcardChild) {
+                    current.wildcardChild = {
+                        paramName,
+                        node: new RadixNode(),
+                    };
+                }
+                current = current.wildcardChild.node;
+                // Wildcard must be the terminal segment
+                break;
+            }
+            else if (segment.startsWith(':')) {
+                // Parameter segment
+                const paramName = segment.slice(1);
+                if (!current.paramChild) {
+                    current.paramChild = {
+                        paramName,
+                        node: new RadixNode(),
+                    };
+                }
+                current = current.paramChild.node;
+            }
+            else {
+                // Static segment
+                let child = current.children.get(segment);
+                if (!child) {
+                    child = new RadixNode();
+                    current.children.set(segment, child);
+                }
+                current = child;
+            }
+        }
+        const route = {
+            method: upperMethod,
+            path: normalized,
+            handlers,
+            schema,
+        };
+        current.routes.set(upperMethod, route);
+        this.allRoutes.push(route);
+        return this;
+    }
+    /**
+     * Matches an incoming HTTP request method and path against the Radix Tree.
+     *
+     * @param method - HTTP method.
+     * @param path - URL pathname.
+     * @returns RouteMatch or null if no route matches.
+     */
+    match(method, path) {
+        const upperMethod = method.toUpperCase();
+        const normalized = normalizePath(path);
+        const segments = splitPath(normalized);
+        const params = {};
+        const node = this.searchNode(this.root, segments, 0, params);
+        if (!node) {
+            return null;
+        }
+        // Try exact method match
+        let route = node.routes.get(upperMethod);
+        // Fallback to 'ALL' wildcard handler
+        if (!route) {
+            route = node.routes.get('ALL');
+        }
+        // Fallback for HEAD request to GET handler
+        if (!route && upperMethod === 'HEAD') {
+            route = node.routes.get('GET');
+        }
+        if (!route) {
+            return null;
+        }
+        return {
+            route,
+            params,
+            handlers: route.handlers,
+        };
+    }
+    /**
+     * Checks whether ANY route is registered for the specified path,
+     * regardless of the HTTP method (used for 405 Method Not Allowed detection).
+     *
+     * @param path - URL pathname.
+     * @returns True if at least one route matches the path.
+     */
+    hasPath(path) {
+        const normalized = normalizePath(path);
+        const segments = splitPath(normalized);
+        const params = {};
+        const node = this.searchNode(this.root, segments, 0, params);
+        if (!node) {
+            return false;
+        }
+        return node.routes.size > 0;
+    }
+    /**
+     * Retrieves all HTTP methods registered for a given path.
+     *
+     * @param path - URL pathname.
+     * @returns Array of allowed HTTP method strings.
+     */
+    allowedMethods(path) {
+        const normalized = normalizePath(path);
+        const segments = splitPath(normalized);
+        const params = {};
+        const node = this.searchNode(this.root, segments, 0, params);
+        if (!node) {
+            return [];
+        }
+        const methods = new Set();
+        for (const m of node.routes.keys()) {
+            if (m === 'ALL') {
+                methods.add('GET');
+                methods.add('POST');
+                methods.add('PUT');
+                methods.add('PATCH');
+                methods.add('DELETE');
+                methods.add('HEAD');
+                methods.add('OPTIONS');
+            }
+            else {
+                methods.add(m);
+            }
+        }
+        // If GET is supported, HEAD is implicitly supported
+        if (methods.has('GET')) {
+            methods.add('HEAD');
+        }
+        methods.add('OPTIONS');
+        return Array.from(methods);
+    }
+    /**
+     * Recursively traverses the Radix Tree matching static, param, and wildcard segments.
+     */
+    searchNode(current, segments, index, params) {
+        // End of segments reached
+        if (index === segments.length) {
+            if (current.routes.size > 0) {
+                return current;
+            }
+            // If no route at exact end, check if wildcard child exists that can match empty remainder
+            if (current.wildcardChild && current.wildcardChild.node.routes.size > 0) {
+                params[current.wildcardChild.paramName] = '';
+                return current.wildcardChild.node;
+            }
+            return null;
+        }
+        const segment = segments[index];
+        // 1. Try static child match
+        const child = current.children.get(segment);
+        if (child) {
+            const match = this.searchNode(child, segments, index + 1, params);
+            if (match)
+                return match;
+        }
+        // 2. Try parameter child match
+        if (current.paramChild) {
+            params[current.paramChild.paramName] = segment;
+            const match = this.searchNode(current.paramChild.node, segments, index + 1, params);
+            if (match)
+                return match;
+            delete params[current.paramChild.paramName];
+        }
+        // 3. Try wildcard child match
+        if (current.wildcardChild) {
+            const remaining = segments.slice(index).join('/');
+            params[current.wildcardChild.paramName] = remaining;
+            return current.wildcardChild.node;
+        }
+        return null;
+    }
+    /**
+     * Registers a sub-router with a URL prefix.
+     *
+     * @param prefix - Base path prefix (e.g., '/api/v1').
+     * @param subRouter - Router instance to mount.
+     * @returns this
+     */
+    mount(prefix, subRouter) {
+        const cleanPrefix = normalizePath(prefix);
+        for (const route of subRouter.allRoutes) {
+            const combinedPath = route.path === '/'
+                ? cleanPrefix
+                : normalizePath(`${cleanPrefix}${route.path}`);
+            this.add(route.method, combinedPath, [...route.handlers], route.schema);
+        }
+        return this;
+    }
+    /**
+     * Creates a chainable RouteChain for configuring handlers on a path.
+     *
+     * @param path - URL path.
+     * @returns RouteChain instance.
+     */
+    route(path) {
+        return new RouteChain(this, path);
+    }
+    // --- HTTP Verb Shorthands ---
+    get(path, ...handlers) {
+        return this.add('GET', path, handlers);
+    }
+    post(path, ...handlers) {
+        return this.add('POST', path, handlers);
+    }
+    put(path, ...handlers) {
+        return this.add('PUT', path, handlers);
+    }
+    patch(path, ...handlers) {
+        return this.add('PATCH', path, handlers);
+    }
+    delete(path, ...handlers) {
+        return this.add('DELETE', path, handlers);
+    }
+    all(path, ...handlers) {
+        return this.add('ALL', path, handlers);
+    }
+    options(path, ...handlers) {
+        return this.add('OPTIONS', path, handlers);
+    }
+    head(path, ...handlers) {
+        return this.add('HEAD', path, handlers);
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA8DH;;GAEG;AACH,MAAM,SAAS;IACb;;OAEG;IACI,QAAQ,GAAkC,IAAI,GAAG,EAAE,CAAC;IAE3D;;OAEG;IACI,UAAU,CAGf;IAEF;;OAEG;IACI,aAAa,CAGlB;IAEF;;OAEG;IACI,MAAM,GAA8B,IAAI,GAAG,EAAE,CAAC;CACtD;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QAC1B,OAAO,GAAG,CAAC;IACb,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/D,OAAO,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC;AAC9D,CAAC;AAED;;;;;GAKG;AACH,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QACjB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,UAAU;IACJ,MAAM,CAAgB;IACtB,IAAI,CAAS;IAE9B,YAAY,MAAqB,EAAE,IAAY;QAC7C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAEM,GAAG,CAAC,GAAG,QAA6B;QACzC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,IAAI,CAAC,GAAG,QAA6B;QAC1C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,GAAG,CAAC,GAAG,QAA6B;QACzC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,KAAK,CAAC,GAAG,QAA6B;QAC3C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,MAAM,CAAC,GAAG,QAA6B;QAC5C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,GAAG,CAAC,GAAG,QAA6B;QACzC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,OAAO,CAAC,GAAG,QAA6B;QAC7C,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,IAAI,CAAC,GAAG,QAA6B;QAC1C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,MAAM;IACA,IAAI,GAAG,IAAI,SAAS,EAAS,CAAC;IAC9B,SAAS,GAAmB,EAAE,CAAC;IAEhD;;;;;;;OAOG;IACI,GAAG,CACR,MAAc,EACd,IAAY,EACZ,QAA6B,EAC7B,MAAoB;QAEpB,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QACzC,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,QAAQ,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;QAEvC,IAAI,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC;QAExB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;YAE7B,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC5B,+CAA+C;gBAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;gBAC9D,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;oBAC3B,OAAO,CAAC,aAAa,GAAG;wBACtB,SAAS;wBACT,IAAI,EAAE,IAAI,SAAS,EAAS;qBAC7B,CAAC;gBACJ,CAAC;gBACD,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC;gBACrC,wCAAwC;gBACxC,MAAM;YACR,CAAC;iBAAM,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnC,oBAAoB;gBACpB,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBACnC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;oBACxB,OAAO,CAAC,UAAU,GAAG;wBACnB,SAAS;wBACT,IAAI,EAAE,IAAI,SAAS,EAAS;qBAC7B,CAAC;gBACJ,CAAC;gBACD,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACN,iBAAiB;gBACjB,IAAI,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,KAAK,GAAG,IAAI,SAAS,EAAS,CAAC;oBAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gBACvC,CAAC;gBACD,OAAO,GAAG,KAAK,CAAC;YAClB,CAAC;QACH,CAAC;QAED,MAAM,KAAK,GAAiB;YAC1B,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,UAAU;YAChB,QAAQ;YACR,MAAM;SACP,CAAC;QAEF,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QACvC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAE3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,MAAc,EAAE,IAAY;QACvC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QACzC,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,QAAQ,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;QACvC,MAAM,MAAM,GAA2B,EAAE,CAAC;QAE1C,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,IAAI,CAAC;QACd,CAAC;QAED,yBAAyB;QACzB,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAEzC,qCAAqC;QACrC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;QAED,2CAA2C;QAC3C,IAAI,CAAC,KAAK,IAAI,WAAW,KAAK,MAAM,EAAE,CAAC;YACrC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;QAED,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO;YACL,KAAK;YACL,MAAM;YACN,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACI,OAAO,CAAC,IAAY;QACzB,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,QAAQ,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;QACvC,MAAM,MAAM,GAA2B,EAAE,CAAC;QAE1C,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;OAKG;IACI,cAAc,CAAC,IAAY;QAChC,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,QAAQ,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;QACvC,MAAM,MAAM,GAA2B,EAAE,CAAC;QAE1C,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YACnC,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC;gBAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACnB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACpB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACnB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACrB,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACtB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACpB,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACzB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;QAED,oDAAoD;QACpD,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAEvB,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACK,UAAU,CAChB,OAAyB,EACzB,QAAkB,EAClB,KAAa,EACb,MAA8B;QAE9B,0BAA0B;QAC1B,IAAI,KAAK,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;YAC9B,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBAC5B,OAAO,OAAO,CAAC;YACjB,CAAC;YACD,0FAA0F;YAC1F,IAAI,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACxE,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;gBAC7C,OAAO,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC;YACpC,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAE,CAAC;QAEjC,4BAA4B;QAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;YAClE,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAC;QAC1B,CAAC;QAED,+BAA+B;QAC/B,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;YAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;YACpF,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAC;YACxB,OAAO,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC9C,CAAC;QAED,8BAA8B;QAC9B,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;YAC1B,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClD,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;YACpD,OAAO,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC;QACpC,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,MAAc,EAAE,SAAwB;QACnD,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QAC1C,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;YACxC,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,KAAK,GAAG;gBACrC,CAAC,CAAC,WAAW;gBACb,CAAC,CAAC,aAAa,CAAC,GAAG,WAAW,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACjD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,IAAY;QACvB,OAAO,IAAI,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,+BAA+B;IAExB,GAAG,CAAC,IAAY,EAAE,GAAG,QAA6B;QACvD,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IACzC,CAAC;IAEM,IAAI,CAAC,IAAY,EAAE,GAAG,QAA6B;QACxD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAEM,GAAG,CAAC,IAAY,EAAE,GAAG,QAA6B;QACvD,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IACzC,CAAC;IAEM,KAAK,CAAC,IAAY,EAAE,GAAG,QAA6B;QACzD,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAEM,MAAM,CAAC,IAAY,EAAE,GAAG,QAA6B;QAC1D,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAEM,GAAG,CAAC,IAAY,EAAE,GAAG,QAA6B;QACvD,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IACzC,CAAC;IAEM,OAAO,CAAC,IAAY,EAAE,GAAG,QAA6B;QAC3D,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAEM,IAAI,CAAC,IAAY,EAAE,GAAG,QAA6B;QACxD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC;CACF"}

package/dist/routing/controller.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @file controller.ts
+ * @description Controller resolution and handler adapter for class-based routing.
+ */
+import type { DefaultState } from '../core/context.js';
+import type { Middleware } from '../core/types.js';
+export type ControllerConstructor<T = any> = new (...args: any[]) => T;
+export type ControllerTuple<T = any> = [ControllerConstructor<T>, string];
+/**
+ * Checks if a value is a controller tuple [ControllerClass, 'methodName'].
+ */
+export declare function isControllerTuple(val: unknown): val is [ControllerConstructor, string];
+/**
+ * Adapts a controller class and action method into an Aero Middleware function.
+ * Leverages the IoC container from ctx.container if available for automatic dependency injection.
+ */
+export declare function createControllerHandler<State = DefaultState>(target: ControllerConstructor | [ControllerConstructor, string], actionName?: string): Middleware<State>;
+//# sourceMappingURL=controller.d.ts.map

package/dist/routing/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/routing/controller.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,MAAM,qBAAqB,CAAC,CAAC,GAAG,GAAG,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AACvE,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAE1E;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAOtF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,GAAG,YAAY,EAC1D,MAAM,EAAE,qBAAqB,GAAG,CAAC,qBAAqB,EAAE,MAAM,CAAC,EAC/D,UAAU,CAAC,EAAE,MAAM,GAClB,UAAU,CAAC,KAAK,CAAC,CAmCnB"}

package/dist/routing/controller.js

@@ -0,0 +1,49 @@
+/**
+ * @file controller.ts
+ * @description Controller resolution and handler adapter for class-based routing.
+ */
+/**
+ * Checks if a value is a controller tuple [ControllerClass, 'methodName'].
+ */
+export function isControllerTuple(val) {
+    return (Array.isArray(val) &&
+        val.length === 2 &&
+        typeof val[0] === 'function' &&
+        typeof val[1] === 'string');
+}
+/**
+ * Adapts a controller class and action method into an Aero Middleware function.
+ * Leverages the IoC container from ctx.container if available for automatic dependency injection.
+ */
+export function createControllerHandler(target, actionName) {
+    let ControllerClass;
+    let action;
+    if (isControllerTuple(target)) {
+        ControllerClass = target[0];
+        action = target[1];
+    }
+    else if (typeof target === 'function' && typeof actionName === 'string') {
+        ControllerClass = target;
+        action = actionName;
+    }
+    else {
+        throw new TypeError('Invalid controller definition. Expected [Class, "method"] or (Class, "method").');
+    }
+    return async (ctx) => {
+        let instance;
+        if (ctx.container && typeof ctx.container.make === 'function') {
+            instance = ctx.container.make(ControllerClass);
+        }
+        else {
+            instance = new ControllerClass();
+        }
+        if (typeof instance[action] !== 'function') {
+            throw new Error(`Controller method '${action}' does not exist on ${ControllerClass.name || 'Controller'}.`);
+        }
+        const result = await instance[action](ctx);
+        if (result !== undefined && !ctx.res.isSent && !ctx.res.headersSent) {
+            ctx.send(result);
+        }
+    };
+}
+//# sourceMappingURL=controller.js.map

package/dist/routing/controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../src/routing/controller.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC5C,OAAO,CACL,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAClB,GAAG,CAAC,MAAM,KAAK,CAAC;QAChB,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,UAAU;QAC5B,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,QAAQ,CAC3B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAA+D,EAC/D,UAAmB;IAEnB,IAAI,eAAsC,CAAC;IAC3C,IAAI,MAAc,CAAC;IAEnB,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,eAAe,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;SAAM,IAAI,OAAO,MAAM,KAAK,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC1E,eAAe,GAAG,MAAM,CAAC;QACzB,MAAM,GAAG,UAAU,CAAC;IACtB,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,SAAS,CAAC,iFAAiF,CAAC,CAAC;IACzG,CAAC;IAED,OAAO,KAAK,EAAE,GAAuB,EAAE,EAAE;QACvC,IAAI,QAAa,CAAC;QAElB,IAAI,GAAG,CAAC,SAAS,IAAI,OAAQ,GAAG,CAAC,SAAiB,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACvE,QAAQ,GAAI,GAAG,CAAC,SAAiB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;QACnC,CAAC;QAED,IAAI,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,UAAU,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CACb,sBAAsB,MAAM,uBAAuB,eAAe,CAAC,IAAI,IAAI,YAAY,GAAG,CAC3F,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC;QAE3C,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;YACpE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/routing/named-middleware.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @file named-middleware.ts
+ * @description Named middleware registry allowing reusable, named middleware across routes and groups.
+ */
+import type { DefaultState } from '../core/context.js';
+import type { Middleware } from '../core/types.js';
+export declare class NamedMiddlewareRegistry<State = DefaultState> {
+    private readonly middlewares;
+    /**
+     * Registers a middleware function under a specific name.
+     */
+    register(name: string, middleware: Middleware<State>): this;
+    /**
+     * Retrieves a named middleware by key.
+     * Throws an error if the named middleware is not registered.
+     */
+    get(name: string): Middleware<State>;
+    /**
+     * Checks whether a named middleware is registered.
+     */
+    has(name: string): boolean;
+    /**
+     * Returns a copy of all registered named middlewares.
+     */
+    all(): Map<string, Middleware<State>>;
+}
+//# sourceMappingURL=named-middleware.d.ts.map

package/dist/routing/named-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"named-middleware.d.ts","sourceRoot":"","sources":["../../src/routing/named-middleware.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,qBAAa,uBAAuB,CAAC,KAAK,GAAG,YAAY;IACvD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwC;IAEpE;;OAEG;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,GAAG,IAAI;IAQlE;;;OAGG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC;IAQ3C;;OAEG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACI,GAAG,IAAI,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;CAG7C"}

package/dist/routing/named-middleware.js

@@ -0,0 +1,41 @@
+/**
+ * @file named-middleware.ts
+ * @description Named middleware registry allowing reusable, named middleware across routes and groups.
+ */
+export class NamedMiddlewareRegistry {
+    middlewares = new Map();
+    /**
+     * Registers a middleware function under a specific name.
+     */
+    register(name, middleware) {
+        if (typeof middleware !== 'function') {
+            throw new TypeError(`Named middleware '${name}' must be a function, received ${typeof middleware}`);
+        }
+        this.middlewares.set(name, middleware);
+        return this;
+    }
+    /**
+     * Retrieves a named middleware by key.
+     * Throws an error if the named middleware is not registered.
+     */
+    get(name) {
+        const mw = this.middlewares.get(name);
+        if (!mw) {
+            throw new Error(`Named middleware '${name}' is not registered.`);
+        }
+        return mw;
+    }
+    /**
+     * Checks whether a named middleware is registered.
+     */
+    has(name) {
+        return this.middlewares.has(name);
+    }
+    /**
+     * Returns a copy of all registered named middlewares.
+     */
+    all() {
+        return new Map(this.middlewares);
+    }
+}
+//# sourceMappingURL=named-middleware.js.map

package/dist/routing/named-middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"named-middleware.js","sourceRoot":"","sources":["../../src/routing/named-middleware.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,OAAO,uBAAuB;IACjB,WAAW,GAAG,IAAI,GAAG,EAA6B,CAAC;IAEpE;;OAEG;IACI,QAAQ,CAAC,IAAY,EAAE,UAA6B;QACzD,IAAI,OAAO,UAAU,KAAK,UAAU,EAAE,CAAC;YACrC,MAAM,IAAI,SAAS,CAAC,qBAAqB,IAAI,kCAAkC,OAAO,UAAU,EAAE,CAAC,CAAC;QACtG,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACI,GAAG,CAAC,IAAY;QACrB,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,sBAAsB,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACI,GAAG,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACI,GAAG;QACR,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/routing/route-builder.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @file route-builder.ts
+ * @description Fluent RouteBuilder enabling chainable route configuration (.as(), .middleware(), .schema()).
+ */
+import type { DefaultState } from '../core/context.js';
+import type { Middleware } from '../core/types.js';
+import type { Route, RouteSchema, Router } from '../core/router.js';
+import type { NamedMiddlewareRegistry } from './named-middleware.js';
+export declare class RouteBuilder<State = DefaultState> {
+    private readonly route;
+    private readonly router;
+    private readonly namedMiddleware?;
+    private readonly addedMiddlewares;
+    private readonly initialHandlers;
+    constructor(route: Route<State>, router: Router<State>, namedMiddleware?: NamedMiddlewareRegistry<State> | undefined);
+    /**
+     * Sets the unique name for this route (used by urlFor).
+     */
+    as(name: string): this;
+    /**
+     * Alias for as(name).
+     */
+    name(name: string): this;
+    /**
+     * Attaches one or more route-level middlewares (functions or registered names).
+     * Middlewares execute sequentially in the order registered before the route handler.
+     */
+    middleware(...middlewares: (Middleware<State> | string)[]): this;
+    /**
+     * Alias for middleware().
+     */
+    use(...middlewares: (Middleware<State> | string)[]): this;
+    /**
+     * Attaches schema validation rules to this route.
+     */
+    schema(schema: RouteSchema): this;
+    /**
+     * Attaches OpenAPI 3.1 metadata to this route.
+     */
+    openapi(meta: Record<string, any>): this;
+    /**
+     * Returns the underlying Route object.
+     */
+    getRoute(): Route<State>;
+    get(path: string, ...handlers: any[]): RouteBuilder<State>;
+    post(path: string, ...handlers: any[]): RouteBuilder<State>;
+    put(path: string, ...handlers: any[]): RouteBuilder<State>;
+    patch(path: string, ...handlers: any[]): RouteBuilder<State>;
+    delete(path: string, ...handlers: any[]): RouteBuilder<State>;
+    options(path: string, ...handlers: any[]): RouteBuilder<State>;
+    head(path: string, ...handlers: any[]): RouteBuilder<State>;
+    all(path: string, ...handlers: any[]): RouteBuilder<State>;
+}
+//# sourceMappingURL=route-builder.d.ts.map

package/dist/routing/route-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-builder.d.ts","sourceRoot":"","sources":["../../src/routing/route-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE,qBAAa,YAAY,CAAC,KAAK,GAAG,YAAY;IAK1C,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IANnC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAsC;IACvE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiC;gBAG9C,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,EACnB,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,EACrB,eAAe,CAAC,EAAE,uBAAuB,CAAC,KAAK,CAAC,YAAA;IAKnE;;OAEG;IACI,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM7B;;OAEG;IACI,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI/B;;;OAGG;IACI,UAAU,CAAC,GAAG,WAAW,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,EAAE,GAAG,IAAI;IAMvE;;OAEG;IACI,GAAG,CAAC,GAAG,WAAW,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,EAAE,GAAG,IAAI;IAIhE;;OAEG;IACI,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAQxC;;OAEG;IACI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAM/C;;OAEG;IACI,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC;IAKxB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC;IAI1D,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC;IAI3D,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC;IAI1D,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC;IAI5D,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC;IAI7D,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC;IAI9D,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC;IAI3D,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC;CAGlE"}

package/dist/routing/route-builder.js

@@ -0,0 +1,95 @@
+/**
+ * @file route-builder.ts
+ * @description Fluent RouteBuilder enabling chainable route configuration (.as(), .middleware(), .schema()).
+ */
+export class RouteBuilder {
+    route;
+    router;
+    namedMiddleware;
+    addedMiddlewares = [];
+    initialHandlers;
+    constructor(route, router, namedMiddleware) {
+        this.route = route;
+        this.router = router;
+        this.namedMiddleware = namedMiddleware;
+        this.initialHandlers = [...route.handlers];
+    }
+    /**
+     * Sets the unique name for this route (used by urlFor).
+     */
+    as(name) {
+        this.route.name = name;
+        this.router.registerNamedRoute(name, this.route);
+        return this;
+    }
+    /**
+     * Alias for as(name).
+     */
+    name(name) {
+        return this.as(name);
+    }
+    /**
+     * Attaches one or more route-level middlewares (functions or registered names).
+     * Middlewares execute sequentially in the order registered before the route handler.
+     */
+    middleware(...middlewares) {
+        this.addedMiddlewares.push(...middlewares);
+        this.route.handlers = [...this.addedMiddlewares, ...this.initialHandlers];
+        return this;
+    }
+    /**
+     * Alias for middleware().
+     */
+    use(...middlewares) {
+        return this.middleware(...middlewares);
+    }
+    /**
+     * Attaches schema validation rules to this route.
+     */
+    schema(schema) {
+        this.route.schema = {
+            ...this.route.schema,
+            ...schema,
+        };
+        return this;
+    }
+    /**
+     * Attaches OpenAPI 3.1 metadata to this route.
+     */
+    openapi(meta) {
+        this.route.openapi = meta;
+        return this;
+    }
+    /**
+     * Returns the underlying Route object.
+     */
+    getRoute() {
+        return this.route;
+    }
+    // Chaining support for defining subsequent routes directly
+    get(path, ...handlers) {
+        return this.router.get(path, ...handlers);
+    }
+    post(path, ...handlers) {
+        return this.router.post(path, ...handlers);
+    }
+    put(path, ...handlers) {
+        return this.router.put(path, ...handlers);
+    }
+    patch(path, ...handlers) {
+        return this.router.patch(path, ...handlers);
+    }
+    delete(path, ...handlers) {
+        return this.router.delete(path, ...handlers);
+    }
+    options(path, ...handlers) {
+        return this.router.options(path, ...handlers);
+    }
+    head(path, ...handlers) {
+        return this.router.head(path, ...handlers);
+    }
+    all(path, ...handlers) {
+        return this.router.all(path, ...handlers);
+    }
+}
+//# sourceMappingURL=route-builder.js.map

package/dist/routing/route-builder.js.map

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