@warlock.js/core 4.0.162 → 4.0.163

package/esm/router/route-builder.d.ts

@@ -0,0 +1,120 @@
+import { type Router } from "./router";
+import type { RequestHandlerType, RouteOptions } from "./types";
+export declare class RouteBuilder {
+    private readonly router;
+    private readonly path;
+    private readonly moreOptions;
+    protected addedRoutes: {
+        get: boolean;
+        post: boolean;
+        put: boolean;
+        delete: boolean;
+        patch: boolean;
+        options: boolean;
+        head: boolean;
+    };
+    constructor(router: Router, path: string, moreOptions?: RouteOptions);
+    /**
+     * Add a get method to the route
+     */
+    get(handler: RequestHandlerType, options?: RouteOptions): this;
+    /**
+     * Get one resource, appends /:id to the path
+     * For example: /posts/:id
+     */
+    getOne(handler: RequestHandlerType, options?: RouteOptions): this;
+    /**
+     * Add a post method to the route
+     */
+    post(handler: RequestHandlerType, options?: RouteOptions): this;
+    /**
+     * Post one resource, appends /:id to the path
+     * For example: /posts/:id
+     */
+    postOne(handler: RequestHandlerType, options?: RouteOptions): this;
+    /**
+     * Add a PUT request handler for current path
+     */
+    put(handler: RequestHandlerType, options?: RouteOptions): this;
+    /**
+     * Update one resource, appends /:id to the path
+     */
+    updateOne(handler: RequestHandlerType, options?: RouteOptions): this;
+    /**
+     * Add a PATCH request handler for current path
+     */
+    patch(handler: RequestHandlerType, options?: RouteOptions): this;
+    /**
+     * Patch one resource, appends /:id to the path
+     */
+    patchOne(handler: RequestHandlerType, options?: RouteOptions): this;
+    /**
+     * Add a DELETE request handler for current path
+     */
+    delete(handler: RequestHandlerType, options?: RouteOptions): this;
+    /**
+     * Delete one resource, appends /:id to the path
+     */
+    deleteOne(handler: RequestHandlerType, options?: RouteOptions): this;
+    /**
+     * List all resources (RESTful alias for GET collection)
+     * @example router.route("/posts").list(listPosts)
+     */
+    list(handler: RequestHandlerType, options?: RouteOptions): this;
+    /**
+     * Create a new resource (RESTful alias for POST)
+     * @example router.route("/posts").create(createPost)
+     */
+    create(handler: RequestHandlerType, options?: RouteOptions): this;
+    /**
+     * Show a single resource (RESTful alias for GET one)
+     * @example router.route("/posts").show(showPost) // GET /posts/:id
+     */
+    show(handler: RequestHandlerType, options?: RouteOptions): this;
+    /**
+     * Update a resource (RESTful alias for PUT one)
+     * @example router.route("/posts").update(updatePost) // PUT /posts/:id
+     */
+    update(handler: RequestHandlerType, options?: RouteOptions): this;
+    /**
+     * Destroy a resource (RESTful alias for DELETE one)
+     * @example router.route("/posts").destroy(deletePost) // DELETE /posts/:id
+     */
+    destroy(handler: RequestHandlerType, options?: RouteOptions): this;
+    /**
+     * Create a nested route builder
+     * Useful for building nested resources like /posts/:id/comments
+     * @example
+     * router.route("/posts/:id")
+     *   .getOne(showPost)
+     *   .nest("/comments")
+     *     .list(listComments)      // GET /posts/:id/comments
+     *     .create(createComment);  // POST /posts/:id/comments
+     */
+    nest(path: string, options?: RouteOptions): RouteBuilder;
+    /**
+     * Set up common RESTful CRUD routes in one call
+     * @example
+     * router.route("/posts").crud({
+     *   list: listPosts,        // GET /posts
+     *   create: createPost,     // POST /posts
+     *   show: showPost,         // GET /posts/:id
+     *   update: updatePost,     // PUT /posts/:id
+     *   destroy: deletePost,    // DELETE /posts/:id
+     *   patch: patchPost,       // PATCH /posts/:id
+     * });
+     */
+    crud(handlers: {
+        list?: RequestHandlerType;
+        create?: RequestHandlerType;
+        show?: RequestHandlerType;
+        update?: RequestHandlerType;
+        destroy?: RequestHandlerType;
+        patch?: RequestHandlerType;
+    }, options?: RouteOptions): this;
+    /**
+     * Merge options with moreOptions
+     */
+    protected withOptions(options?: RouteOptions): any;
+}
+//# sourceMappingURL=route-builder.d.ts.map

package/esm/router/route-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-builder.d.ts","sourceRoot":"","sources":["../../src/router/route-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEhE,qBAAa,YAAY;IAYrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAb9B,SAAS,CAAC,WAAW;;;;;;;;MAQnB;gBAGiB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,WAAW,GAAE,YAAiB;IAKjD;;OAEG;IACI,GAAG,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,GAAE,YAAiB;IAUlE;;;OAGG;IACI,MAAM,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,GAAE,YAAiB;IAKrE;;OAEG;IACI,IAAI,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,GAAE,YAAiB;IAUnE;;;OAGG;IACI,OAAO,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,GAAE,YAAiB;IAKtE;;OAEG;IACI,GAAG,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,GAAE,YAAiB;IAUlE;;OAEG;IACI,SAAS,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,GAAE,YAAiB;IAKxE;;OAEG;IACI,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,GAAE,YAAiB;IAUpE;;OAEG;IACI,QAAQ,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,GAAE,YAAiB;IAKvE;;OAEG;IACI,MAAM,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,GAAE,YAAiB;IAUrE;;OAEG;IACI,SAAS,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,GAAE,YAAiB;IASxE;;;OAGG;IACI,IAAI,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,GAAE,YAAiB;IAInE;;;OAGG;IACI,MAAM,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,GAAE,YAAiB;IAIrE;;;OAGG;IACI,IAAI,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,GAAE,YAAiB;IAInE;;;OAGG;IACI,MAAM,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,GAAE,YAAiB;IAIrE;;;OAGG;IACI,OAAO,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,GAAE,YAAiB;IAQtE;;;;;;;;;OASG;IACI,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,YAAY;IAMnE;;;;;;;;;;;OAWG;IACI,IAAI,CACT,QAAQ,EAAE;QACR,IAAI,CAAC,EAAE,kBAAkB,CAAC;QAC1B,MAAM,CAAC,EAAE,kBAAkB,CAAC;QAC5B,IAAI,CAAC,EAAE,kBAAkB,CAAC;QAC1B,MAAM,CAAC,EAAE,kBAAkB,CAAC;QAC5B,OAAO,CAAC,EAAE,kBAAkB,CAAC;QAC7B,KAAK,CAAC,EAAE,kBAAkB,CAAC;KAC5B,EACD,OAAO,GAAE,YAAiB;IAW5B;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,OAAO,GAAE,YAAiB;CAGjD"}

package/esm/router/route-builder.js

@@ -0,0 +1,201 @@
+import {merge}from'@mongez/reinforcements';class RouteBuilder {
+    router;
+    path;
+    moreOptions;
+    addedRoutes = {
+        get: false,
+        post: false,
+        put: false,
+        delete: false,
+        patch: false,
+        options: false,
+        head: false,
+    };
+    constructor(router, path, moreOptions = {}) {
+        this.router = router;
+        this.path = path;
+        this.moreOptions = moreOptions;
+        //
+    }
+    /**
+     * Add a get method to the route
+     */
+    get(handler, options = {}) {
+        if (this.addedRoutes.get) {
+            throw new Error(`Route ${this.path} already has a GET method`);
+        }
+        this.addedRoutes.get = true;
+        this.router.get(this.path, handler, this.withOptions(options));
+        return this;
+    }
+    /**
+     * Get one resource, appends /:id to the path
+     * For example: /posts/:id
+     */
+    getOne(handler, options = {}) {
+        this.router.get(`${this.path}/:id`, handler, this.withOptions(options));
+        return this;
+    }
+    /**
+     * Add a post method to the route
+     */
+    post(handler, options = {}) {
+        if (this.addedRoutes.post) {
+            throw new Error(`Route ${this.path} already has a POST method`);
+        }
+        this.addedRoutes.post = true;
+        this.router.post(this.path, handler, this.withOptions(options));
+        return this;
+    }
+    /**
+     * Post one resource, appends /:id to the path
+     * For example: /posts/:id
+     */
+    postOne(handler, options = {}) {
+        this.router.post(`${this.path}/:id`, handler, this.withOptions(options));
+        return this;
+    }
+    /**
+     * Add a PUT request handler for current path
+     */
+    put(handler, options = {}) {
+        if (this.addedRoutes.put) {
+            throw new Error(`Route ${this.path} already has a PUT method`);
+        }
+        this.addedRoutes.put = true;
+        this.router.put(this.path, handler, this.withOptions(options));
+        return this;
+    }
+    /**
+     * Update one resource, appends /:id to the path
+     */
+    updateOne(handler, options = {}) {
+        this.router.put(`${this.path}/:id`, handler, this.withOptions(options));
+        return this;
+    }
+    /**
+     * Add a PATCH request handler for current path
+     */
+    patch(handler, options = {}) {
+        if (this.addedRoutes.patch) {
+            throw new Error(`Route ${this.path} already has a PATCH method`);
+        }
+        this.addedRoutes.patch = true;
+        this.router.patch(this.path, handler, this.withOptions(options));
+        return this;
+    }
+    /**
+     * Patch one resource, appends /:id to the path
+     */
+    patchOne(handler, options = {}) {
+        this.router.patch(`${this.path}/:id`, handler, this.withOptions(options));
+        return this;
+    }
+    /**
+     * Add a DELETE request handler for current path
+     */
+    delete(handler, options = {}) {
+        if (this.addedRoutes.delete) {
+            throw new Error(`Route ${this.path} already has a DELETE method`);
+        }
+        this.addedRoutes.delete = true;
+        this.router.delete(this.path, handler, this.withOptions(options));
+        return this;
+    }
+    /**
+     * Delete one resource, appends /:id to the path
+     */
+    deleteOne(handler, options = {}) {
+        this.router.delete(`${this.path}/:id`, handler, this.withOptions(options));
+        return this;
+    }
+    // ============================================================================
+    // RESTful Semantic Aliases
+    // ============================================================================
+    /**
+     * List all resources (RESTful alias for GET collection)
+     * @example router.route("/posts").list(listPosts)
+     */
+    list(handler, options = {}) {
+        return this.get(handler, options);
+    }
+    /**
+     * Create a new resource (RESTful alias for POST)
+     * @example router.route("/posts").create(createPost)
+     */
+    create(handler, options = {}) {
+        return this.post(handler, options);
+    }
+    /**
+     * Show a single resource (RESTful alias for GET one)
+     * @example router.route("/posts").show(showPost) // GET /posts/:id
+     */
+    show(handler, options = {}) {
+        return this.getOne(handler, options);
+    }
+    /**
+     * Update a resource (RESTful alias for PUT one)
+     * @example router.route("/posts").update(updatePost) // PUT /posts/:id
+     */
+    update(handler, options = {}) {
+        return this.updateOne(handler, options);
+    }
+    /**
+     * Destroy a resource (RESTful alias for DELETE one)
+     * @example router.route("/posts").destroy(deletePost) // DELETE /posts/:id
+     */
+    destroy(handler, options = {}) {
+        return this.deleteOne(handler, options);
+    }
+    // ============================================================================
+    // Route Nesting
+    // ============================================================================
+    /**
+     * Create a nested route builder
+     * Useful for building nested resources like /posts/:id/comments
+     * @example
+     * router.route("/posts/:id")
+     *   .getOne(showPost)
+     *   .nest("/comments")
+     *     .list(listComments)      // GET /posts/:id/comments
+     *     .create(createComment);  // POST /posts/:id/comments
+     */
+    nest(path, options = {}) {
+        const nestedPath = `${this.path}${path}`;
+        const mergedOptions = this.withOptions(options);
+        return new RouteBuilder(this.router, nestedPath, mergedOptions);
+    }
+    /**
+     * Set up common RESTful CRUD routes in one call
+     * @example
+     * router.route("/posts").crud({
+     *   list: listPosts,        // GET /posts
+     *   create: createPost,     // POST /posts
+     *   show: showPost,         // GET /posts/:id
+     *   update: updatePost,     // PUT /posts/:id
+     *   destroy: deletePost,    // DELETE /posts/:id
+     *   patch: patchPost,       // PATCH /posts/:id
+     * });
+     */
+    crud(handlers, options = {}) {
+        if (handlers.list)
+            this.get(handlers.list, options);
+        if (handlers.create)
+            this.post(handlers.create, options);
+        if (handlers.show)
+            this.getOne(handlers.show, options);
+        if (handlers.update)
+            this.updateOne(handlers.update, options);
+        if (handlers.destroy)
+            this.deleteOne(handlers.destroy, options);
+        if (handlers.patch)
+            this.patchOne(handlers.patch, options);
+        return this;
+    }
+    /**
+     * Merge options with moreOptions
+     */
+    withOptions(options = {}) {
+        return merge(this.moreOptions, options);
+    }
+}export{RouteBuilder};//# sourceMappingURL=route-builder.js.map

package/esm/router/route-builder.js.map

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

package/esm/router/route-registry.d.ts

@@ -0,0 +1,30 @@
+import type { Route } from "./types";
+/**
+ * Route Registry
+ * Manages dynamic route matching using find-my-way for HMR support
+ */
+export declare class RouteRegistry {
+    private router;
+    constructor();
+    /**
+     * Register all routes from the router's internal list
+     */
+    register(routes: Route[]): void;
+    /**
+     * Register a single route
+     */
+    registerRoute(route: Route): void;
+    /**
+     * Find a matching route for the given method and URL
+     * @returns Matched route with extracted params, or null if no match
+     */
+    find(method: string, url: string): {
+        route: Route;
+        params: Record<string, string>;
+    } | null;
+    /**
+     * Get all registered routes count (for debugging)
+     */
+    getRouteCount(): number;
+}
+//# sourceMappingURL=route-registry.d.ts.map

package/esm/router/route-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-registry.d.ts","sourceRoot":"","sources":["../../src/router/route-registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAgB;;IAS9B;;OAEG;IACI,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI;IAmBtC;;OAEG;IACI,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAOxC;;;OAGG;IACI,IAAI,CACT,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,IAAI;IAe1D;;OAEG;IACI,aAAa,IAAI,MAAM;CAM/B"}

package/esm/router/route-registry.js

@@ -0,0 +1,67 @@
+import FindMyWay from'find-my-way';/**
+ * Route Registry
+ * Manages dynamic route matching using find-my-way for HMR support
+ */
+class RouteRegistry {
+    router;
+    constructor() {
+        this.router = FindMyWay({
+            ignoreTrailingSlash: true,
+            caseSensitive: false,
+        });
+    }
+    /**
+     * Register all routes from the router's internal list
+     */
+    register(routes) {
+        // Register each route
+        for (const route of routes) {
+            if (route.method === "all") {
+                this.registerRoute({
+                    ...route,
+                    method: "GET",
+                });
+                this.registerRoute({
+                    ...route,
+                    method: "POST",
+                });
+            }
+            else {
+                this.registerRoute(route);
+            }
+        }
+    }
+    /**
+     * Register a single route
+     */
+    registerRoute(route) {
+        this.router.on(route.method, route.path, (req, res, params) => {
+            // Store the route and params for later use
+            return { route, params };
+        });
+    }
+    /**
+     * Find a matching route for the given method and URL
+     * @returns Matched route with extracted params, or null if no match
+     */
+    find(method, url) {
+        // Strip query string from URL (find-my-way expects just the path)
+        const path = url.split("?")[0];
+        const match = this.router.find(method, path);
+        if (!match) {
+            return null;
+        }
+        // find-my-way handler expects (req, res, params, store, searchParams)
+        // We only care about the return value which contains { route, params }
+        return match.handler(null, null, match.params, match.store, {});
+    }
+    /**
+     * Get all registered routes count (for debugging)
+     */
+    getRouteCount() {
+        return this.router
+            .prettyPrint()
+            .split("\n")
+            .filter((line) => line.trim()).length;
+    }
+}export{RouteRegistry};//# sourceMappingURL=route-registry.js.map

package/esm/router/route-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-registry.js","sources":["../../src/router/route-registry.ts"],"sourcesContent":[null],"names":[],"mappings":"mCAGA;;;AAGG;MACU,aAAa,CAAA;AAChB,IAAA,MAAM,CAAgB;AAE9B,IAAA,WAAA,GAAA;AACE,QAAA,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;AACtB,YAAA,mBAAmB,EAAE,IAAI;AACzB,YAAA,aAAa,EAAE,KAAK;AACrB,SAAA,CAAC,CAAC;KACJ;AAED;;AAEG;AACI,IAAA,QAAQ,CAAC,MAAe,EAAA;;AAE7B,QAAA,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;AAC1B,YAAA,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,EAAE;gBAC1B,IAAI,CAAC,aAAa,CAAC;AACjB,oBAAA,GAAG,KAAK;AACR,oBAAA,MAAM,EAAE,KAAK;AACd,iBAAA,CAAC,CAAC;gBAEH,IAAI,CAAC,aAAa,CAAC;AACjB,oBAAA,GAAG,KAAK;AACR,oBAAA,MAAM,EAAE,MAAM;AACf,iBAAA,CAAC,CAAC;AACJ,aAAA;AAAM,iBAAA;AACL,gBAAA,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;AAC3B,aAAA;AACF,SAAA;KACF;AAED;;AAEG;AACI,IAAA,aAAa,CAAC,KAAY,EAAA;QAC/B,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,MAAoB,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,KAAI;;AAE1E,YAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,SAAC,CAAC,CAAC;KACJ;AAED;;;AAGG;IACI,IAAI,CACT,MAAc,EACd,GAAW,EAAA;;QAGX,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAE/B,QAAA,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAoB,EAAE,IAAI,CAAC,CAAC;QAE3D,IAAI,CAAC,KAAK,EAAE;AACV,YAAA,OAAO,IAAI,CAAC;AACb,SAAA;;;AAID,QAAA,OAAO,KAAK,CAAC,OAAO,CAAC,IAAW,EAAE,IAAW,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;KAC/E;AAED;;AAEG;IACI,aAAa,GAAA;QAClB,OAAO,IAAI,CAAC,MAAM;AACf,aAAA,WAAW,EAAE;aACb,KAAK,CAAC,IAAI,CAAC;AACX,aAAA,MAAM,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;KACzC;AACF"}

package/esm/router/route.d.ts

@@ -0,0 +1,34 @@
+import type { Route as RouteData } from "./types";
+export declare class Route {
+    data: RouteData;
+    constructor(data: RouteData);
+    /**
+     * Set route name
+     */
+    name(name: string): this;
+    /**
+     * Set route middleware
+     */
+    middleware(middleware: RouteData["middleware"]): this;
+    /**
+     * Set route description
+     */
+    description(description: string): this;
+    /**
+     * Set route label
+     */
+    label(label: string): this;
+    /**
+     * Set route path
+     */
+    path(path: string): this;
+    /**
+     * Set route method
+     */
+    method(method: RouteData["method"]): this;
+    /**
+     * Set route handler
+     */
+    handler(handler: RouteData["handler"]): this;
+}
+//# sourceMappingURL=route.d.ts.map

package/esm/router/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/router/route.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,SAAS,CAAC;AAElD,qBAAa,KAAK;IACU,IAAI,EAAE,SAAS;gBAAf,IAAI,EAAE,SAAS;IAEzC;;OAEG;IACI,IAAI,CAAC,IAAI,EAAE,MAAM;IAMxB;;OAEG;IACI,UAAU,CAAC,UAAU,EAAE,SAAS,CAAC,YAAY,CAAC;IAMrD;;OAEG;IACI,WAAW,CAAC,WAAW,EAAE,MAAM;IAMtC;;OAEG;IACI,KAAK,CAAC,KAAK,EAAE,MAAM;IAM1B;;OAEG;IACI,IAAI,CAAC,IAAI,EAAE,MAAM;IAMxB;;OAEG;IACI,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC;IAMzC;;OAEG;IACI,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC;CAK7C"}

package/esm/router/router.d.ts

@@ -0,0 +1,188 @@
+import { type FastifyHttpProxyOptions } from "@fastify/http-proxy";
+import { type FastifyStaticOptions } from "@fastify/static";
+import { type FastifyInstance } from "../http/server";
+import { RouteBuilder } from "./route-builder";
+import type { GroupedRoutesOptions, RequestHandler, RequestHandlerType, ResourceMethod, Route, RouteOptions, RouteResource, RouterGroupCallback, RouterStacks } from "./types";
+export declare class Router {
+    /**
+     * Routes list
+     */
+    private routes;
+    /**
+     * Router Instance
+     */
+    private static instance;
+    /**
+     * Static paths
+     */
+    protected staticDirectories: FastifyStaticOptions[];
+    /**
+     * Event listeners
+     */
+    protected eventListeners: Record<string, ((router: Router, server: FastifyInstance) => void)[]>;
+    /**
+     * Stacks
+     * Stacks will be used for grouping routes to add prefix, name or middleware
+     */
+    protected stacks: RouterStacks;
+    /**
+     * Get router instance
+     */
+    static getInstance(): Router;
+    private constructor();
+    /**
+     * Listen to router before scan
+     */
+    beforeScanning(callback: (router: Router, server: FastifyInstance) => void): this;
+    /**
+     * Listen to router after scanning
+     */
+    afterScanning(callback: (router: Router, server: FastifyInstance) => void): this;
+    /**
+     * Redirect path to another path
+     */
+    redirect(from: string, to: string, redirectMode?: "temporary" | "permanent"): this;
+    /**
+     * Server static folder
+     */
+    directory(options: FastifyStaticOptions): this;
+    /**
+     * Serve file
+     */
+    file(path: string, location: string, cacheTime?: number): this;
+    /**
+     * Serve cached file, it will cache the file to 1 year by default
+     */
+    cachedFile(path: string, location: string, cacheTime?: number): this;
+    /**
+     * Serve list of files
+     */
+    files(files: Record<string, string>, cacheTime?: number): void;
+    /**
+     * Serve list of cached files, it will cache the file to 1 year by default
+     */
+    cachedFiles(files: Record<string, string>, cacheTime?: number): void;
+    /**
+     * Add proxy route
+     */
+    proxy(path: string, baseUrl: string, options?: Omit<FastifyHttpProxyOptions, "prefix" | "upstream">): this;
+    proxy(options: FastifyHttpProxyOptions): this;
+    /**
+     * Add route to routes list
+     */
+    add(method: Route["method"], path: string | string[], handler: RequestHandlerType, options?: RouteOptions): this;
+    /**
+     * Add a request that accepts all methods
+     */
+    any(path: string, handler: RequestHandlerType, options?: RouteOptions): this;
+    /**
+     * Add get request method
+     */
+    get(path: string, handler: RequestHandlerType, options?: RouteOptions): this;
+    /**
+     * Add post request method
+     */
+    post(path: string | string[], handler: RequestHandlerType, options?: RouteOptions): this;
+    /**
+     * Add put request method
+     */
+    put(path: string, handler: RequestHandlerType, options?: RouteOptions): this;
+    /**
+     * Add delete request method
+     */
+    delete(path: string | string[], handler: RequestHandlerType, options?: RouteOptions): this;
+    /**
+     * Add patch request method
+     */
+    patch(path: string, handler: RequestHandlerType, options?: RouteOptions): this;
+    /**
+     * Add head request method
+     */
+    head(path: string, handler: RequestHandlerType, options?: RouteOptions): this;
+    /**
+     * Add options request method
+     */
+    options(path: string, handler: RequestHandlerType, options?: RouteOptions): this;
+    /**
+     * Get a chainable route builder for the same route path
+     */
+    route(path: string, options?: RouteOptions): RouteBuilder;
+    /**
+     * Add full restful resource routes
+     * This method will generate the following routes:
+     * 1. GET /path: list all resources
+     * 2. GET /path/:id: get a single resource
+     * 3. POST /path: create a new resource
+     * 4. PUT /path/:id: update a resource
+     * 5. DELETE /path/:id: delete a resource
+     * 6. PATCH /path/:id: update a resource partially
+     */
+    restfulResource(path: string, resource: RouteResource, options?: RouteOptions & {
+        only?: ResourceMethod[];
+        except?: ResourceMethod[];
+        replace?: Partial<Record<ResourceMethod, RequestHandler>> & {
+            bulkDelete?: RequestHandler;
+        };
+    }): this;
+    /**
+     * Group routes with options
+     */
+    group(options: GroupedRoutesOptions, callback: RouterGroupCallback): this;
+    /**
+     * Add prefix to all routes in the given callback
+     */
+    prefix(prefix: string, callback: () => void): this;
+    /**
+     * Add API version prefix to all routes in the given callback
+     * Automatically formats the version as /v{version}
+     * @example
+     * router.version("1", () => {
+     *   router.get("/users", getUsersV1); // /v1/users
+     * });
+     *
+     * router.version("2", () => {
+     *   router.get("/users", getUsersV2); // /v2/users
+     * });
+     */
+    version(version: string | number, callback: () => void): this;
+    /**
+     * Wrap route additions with a source file path
+     * Used for tracking which routes come from which file (for HMR)
+     * @param sourceFile Relative path to the source file (e.g., "src/app/users/routes.ts")
+     * @param callback Function that adds routes (will have sourceFile injected)
+     */
+    withSourceFile<T = any>(sourceFile: string, callback: () => T | Promise<T>): Promise<T | undefined>;
+    /**
+     * Remove all routes that belong to a specific source file
+     * Used when reloading routes files via HMR
+     * @param sourceFile Relative path to the source file
+     */
+    removeRoutesBySourceFile(sourceFile: string): void;
+    /**
+     * Manage validation system for the given resource
+     */
+    private manageValidation;
+    /**
+     * Get all routes list
+     */
+    list(): Route[];
+    /**
+     * Register routes to the server
+     */
+    scan(server: FastifyInstance): void;
+    /**
+     * Scan routes for the development server
+     * Uses wildcard routing with find-my-way for HMR support
+     */
+    scanDevServer(server: FastifyInstance): void;
+    /**
+     * Get the route path for the given route name
+     */
+    getRoute(name: string, params?: any): string;
+    /**
+     * Handle the given route
+     */
+    private handleRoute;
+}
+export declare const router: Router;
+//# sourceMappingURL=router.d.ts.map