@h3ravel/router 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 h3ravel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,259 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AssetsServiceProvider: () => AssetsServiceProvider,
+  RouteServiceProvider: () => RouteServiceProvider,
+  Router: () => Router
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/Router.ts
+var import_core = require("@h3ravel/core");
+var import_support = require("@h3ravel/support");
+var Router = class {
+  static {
+    __name(this, "Router");
+  }
+  h3App;
+  app;
+  routes = [];
+  groupPrefix = "";
+  groupMiddleware = [];
+  constructor(h3App, app) {
+    this.h3App = h3App;
+    this.app = app;
+  }
+  /**
+   * Route Resolver
+   * 
+   * @param handler 
+   * @param middleware 
+   * @returns 
+   */
+  resolveHandler(handler, middleware = []) {
+    return async (event) => {
+      const kernel = new import_core.Kernel(middleware);
+      return kernel.handle(event, (ctx) => Promise.resolve(handler(ctx)));
+    };
+  }
+  /**
+   * Add a route to the stack
+   * 
+   * @param method 
+   * @param path 
+   * @param handler 
+   * @param name 
+   * @param middleware 
+   */
+  addRoute(method, path2, handler, name, middleware = []) {
+    const fullPath = `${this.groupPrefix}${path2}`.replace(/\/+/g, "/");
+    this.routes.push({
+      method,
+      path: fullPath,
+      name,
+      handler
+    });
+    this.h3App[method](fullPath, this.resolveHandler(handler, middleware));
+  }
+  resolveControllerOrHandler(handler, methodName) {
+    if (typeof handler === "function" && handler.prototype instanceof import_core.Controller) {
+      return (ctx) => {
+        const controller = new handler(this.app);
+        const action = methodName || "index";
+        if (typeof controller[action] !== "function") {
+          throw new Error(`Method "${action}" not found on controller ${handler.name}`);
+        }
+        return controller[action](ctx);
+      };
+    }
+    return handler;
+  }
+  get(path2, handler, methodName, name, middleware = []) {
+    this.addRoute("get", path2, this.resolveControllerOrHandler(handler, methodName), name, middleware);
+  }
+  post(path2, handler, methodName, name, middleware = []) {
+    this.addRoute("post", path2, this.resolveControllerOrHandler(handler, methodName), name, middleware);
+  }
+  put(path2, handler, methodName, name, middleware = []) {
+    this.addRoute("put", path2, this.resolveControllerOrHandler(handler, methodName), name, middleware);
+  }
+  delete(path2, handler, methodName, name, middleware = []) {
+    this.addRoute("delete", path2, this.resolveControllerOrHandler(handler, methodName), name, middleware);
+  }
+  /**
+   * API Resource support  
+   * 
+   * @param path 
+   * @param controller 
+   */
+  apiResource(path2, Controller2, middleware = []) {
+    path2 = path2.replace(/\//g, "/");
+    const name = (0, import_support.afterLast)(path2, "/");
+    const basePath = `/${path2}`.replace(/\/+/g, "/");
+    const controller = new Controller2(this.app);
+    this.addRoute("get", basePath, controller.index.bind(controller), `${name}.index`, middleware);
+    this.addRoute("post", basePath, controller.store.bind(controller), `${name}.store`, middleware);
+    this.addRoute("get", `${basePath}/:id`, controller.show.bind(controller), `${name}.show`, middleware);
+    this.addRoute("put", `${basePath}/:id`, controller.update.bind(controller), `${name}.update`, middleware);
+    this.addRoute("patch", `${basePath}/:id`, controller.update.bind(controller), `${name}.update`, middleware);
+    this.addRoute("delete", `${basePath}/:id`, controller.destroy.bind(controller), `${name}.destroy`, middleware);
+  }
+  /**
+   * Named route URL generator
+   * 
+   * @param name 
+   * @param params 
+   * @returns 
+   */
+  route(name, params = {}) {
+    const found = this.routes.find((r) => r.name === name);
+    if (!found) return void 0;
+    let url = found.path;
+    for (const [key, value] of Object.entries(params)) {
+      url = url.replace(`:${key}`, value);
+    }
+    return url;
+  }
+  /**
+   * Grouping
+   * 
+   * @param options 
+   * @param callback 
+   */
+  group(options, callback) {
+    const prevPrefix = this.groupPrefix;
+    const prevMiddleware = [
+      ...this.groupMiddleware
+    ];
+    this.groupPrefix += options.prefix || "";
+    this.groupMiddleware.push(...options.middleware || []);
+    callback();
+    this.groupPrefix = prevPrefix;
+    this.groupMiddleware = prevMiddleware;
+  }
+  middleware(path2, handler, opts) {
+    this.h3App.use(path2, handler, opts);
+  }
+};
+
+// src/Providers/AssetsServiceProvider.ts
+var import_promises = require("fs/promises");
+var import_core2 = require("@h3ravel/core");
+var import_support2 = require("@h3ravel/support");
+var import_node_path = require("path");
+var import_h3 = require("h3");
+var import_node_fs = require("fs");
+var AssetsServiceProvider = class extends import_core2.ServiceProvider {
+  static {
+    __name(this, "AssetsServiceProvider");
+  }
+  register() {
+    const app = this.app.make("router");
+    const config = this.app.make("config");
+    const fsconfig = config.get("filesystem");
+    const publicPath = this.app.getPath("public");
+    app.middleware(`/${fsconfig.public_mask}/**`, (event) => {
+      return (0, import_h3.serveStatic)(event, {
+        indexNames: [
+          "/index.html"
+        ],
+        getContents: /* @__PURE__ */ __name((id) => {
+          const newId = id.replace(`/${fsconfig.public_mask}/`, "");
+          return (0, import_promises.readFile)((0, import_node_path.join)((0, import_support2.before)(publicPath, newId), newId));
+        }, "getContents"),
+        getMeta: /* @__PURE__ */ __name(async (id) => {
+          const newId = id.replace(`/${fsconfig.public_mask}/`, "");
+          const stats = await (0, import_promises.stat)((0, import_node_path.join)((0, import_support2.before)(publicPath, newId), newId)).catch(() => {
+          });
+          if (stats?.isFile()) {
+            return {
+              size: stats.size,
+              mtime: stats.mtimeMs
+            };
+          }
+        }, "getMeta")
+      });
+    });
+    this.app.singleton("asset", () => {
+      return (key, def = "") => {
+        try {
+          (0, import_node_fs.statSync)((0, import_node_path.join)((0, import_support2.before)(publicPath, key), key));
+        } catch {
+          key = def;
+        }
+        return (0, import_node_path.join)(fsconfig.public_mask, key);
+      };
+    });
+  }
+};
+
+// src/Providers/RouteServiceProvider.ts
+var import_core3 = require("@h3ravel/core");
+var import_node_path2 = __toESM(require("path"), 1);
+var import_promises2 = require("fs/promises");
+var RouteServiceProvider = class extends import_core3.ServiceProvider {
+  static {
+    __name(this, "RouteServiceProvider");
+  }
+  register() {
+    this.app.singleton("router", () => {
+      const h3App = this.app.make("http.app");
+      return new Router(h3App, this.app);
+    });
+  }
+  /**
+   * Load routes from src/routes
+   */
+  async boot() {
+    try {
+      const routePath = this.app.getPath("routes");
+      const files = await (0, import_promises2.readdir)(routePath);
+      for (let i = 0; i < files.length; i++) {
+        const routesModule = await import(import_node_path2.default.join(routePath, files[i]));
+        if (typeof routesModule.default === "function") {
+          const router = this.app.make("router");
+          routesModule.default(router);
+        }
+      }
+    } catch (e) {
+      console.warn("No web routes found or failed to load:", e);
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AssetsServiceProvider,
+  RouteServiceProvider,
+  Router
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/Router.ts","../src/Providers/AssetsServiceProvider.ts","../src/Providers/RouteServiceProvider.ts"],"sourcesContent":["/**\n * @file Automatically generated by barrelsby.\n */\n\nexport * from './Controller';\nexport * from './Route';\nexport * from './Router';\nexport * from './Decorators/ApiResource';\nexport * from './Decorators/Controller';\nexport * from './Decorators/Get';\nexport * from './Decorators/Middleware';\nexport * from './Decorators/Post';\nexport * from './Providers/AssetsServiceProvider';\nexport * from './Providers/RouteServiceProvider';\n","import { H3Event, Middleware, MiddlewareOptions, type H3 } from 'h3'\nimport { Application, Controller, Kernel } from '@h3ravel/core'\nimport { Middleware as HttpMiddleware } from '@h3ravel/http'\nimport { HttpContext } from '@h3ravel/http'\nimport { afterLast } from '@h3ravel/support'\n\ntype EventHandler = (ctx: HttpContext) => unknown\n\ninterface RouteDefinition {\n    method: string\n    path: string\n    name?: string\n    handler: EventHandler\n}\n\nexport class Router {\n    private routes: RouteDefinition[] = []\n    private groupPrefix = ''\n    private groupMiddleware: EventHandler[] = []\n\n    constructor(private h3App: H3, private app: Application) { }\n\n    /**\n     * Route Resolver\n     * \n     * @param handler \n     * @param middleware \n     * @returns \n     */\n    private resolveHandler (handler: EventHandler, middleware: HttpMiddleware[] = []) {\n        return async (event: H3Event) => {\n            const kernel = new Kernel(middleware)\n            return kernel.handle(event, (ctx) => Promise.resolve(handler(ctx)))\n        }\n    }\n\n    /**\n     * Add a route to the stack\n     * \n     * @param method \n     * @param path \n     * @param handler \n     * @param name \n     * @param middleware \n     */\n    private addRoute (\n        method: string,\n        path: string,\n        handler: EventHandler,\n        name?: string,\n        middleware: HttpMiddleware[] = []\n    ) {\n        const fullPath = `${this.groupPrefix}${path}`.replace(/\\/+/g, '/')\n        this.routes.push({ method, path: fullPath, name, handler })\n        this.h3App[method as 'get'](fullPath, this.resolveHandler(handler, middleware))\n    }\n\n    private resolveControllerOrHandler (\n        handler: EventHandler | (new (...args: any[]) => Controller),\n        methodName?: string\n    ): EventHandler {\n        if (typeof handler === 'function' && (handler as any).prototype instanceof Controller) {\n            return (ctx) => {\n                const controller = new (handler as new (...args: any[]) => Controller)(this.app)\n                const action = (methodName || 'index') as keyof Controller\n\n                if (typeof controller[action] !== 'function') {\n                    throw new Error(`Method \"${action}\" not found on controller ${handler.name}`)\n                }\n\n                return controller[action](ctx)\n            }\n        }\n\n        return handler as EventHandler\n    }\n\n\n    get (\n        path: string,\n        handler: EventHandler | (new (...args: any[]) => Controller),\n        methodName?: string, name?: string, middleware: HttpMiddleware[] = []\n    ) {\n        this.addRoute('get', path, this.resolveControllerOrHandler(handler, methodName), name, middleware)\n    }\n\n    post (\n        path: string,\n        handler: EventHandler | (new (...args: any[]) => Controller),\n        methodName?: string, name?: string, middleware: HttpMiddleware[] = []\n    ) {\n        this.addRoute('post', path, this.resolveControllerOrHandler(handler, methodName), name, middleware)\n    }\n\n    put (\n        path: string,\n        handler: EventHandler | (new (...args: any[]) => Controller),\n        methodName?: string, name?: string, middleware: HttpMiddleware[] = []\n    ) {\n        this.addRoute('put', path, this.resolveControllerOrHandler(handler, methodName), name, middleware)\n    }\n\n    delete (\n        path: string,\n        handler: EventHandler | (new (...args: any[]) => Controller),\n        methodName?: string, name?: string, middleware: HttpMiddleware[] = []\n    ) {\n        this.addRoute('delete', path, this.resolveControllerOrHandler(handler, methodName), name, middleware)\n    }\n\n    /**\n     * API Resource support  \n     * \n     * @param path \n     * @param controller \n     */\n    apiResource (\n        path: string,\n        Controller: new (app: Application) => Controller,\n        middleware: HttpMiddleware[] = []\n    ) {\n        path = path.replace(/\\//g, '/')\n\n        const name = afterLast(path, '/')\n        const basePath = `/${path}`.replace(/\\/+/g, '/')\n\n        const controller = new Controller(this.app)\n\n        this.addRoute('get', basePath, controller.index.bind(controller), `${name}.index`, middleware)\n        this.addRoute('post', basePath, controller.store.bind(controller), `${name}.store`, middleware)\n        this.addRoute('get', `${basePath}/:id`, controller.show.bind(controller), `${name}.show`, middleware)\n        this.addRoute('put', `${basePath}/:id`, controller.update.bind(controller), `${name}.update`, middleware)\n        this.addRoute('patch', `${basePath}/:id`, controller.update.bind(controller), `${name}.update`, middleware)\n        this.addRoute('delete', `${basePath}/:id`, controller.destroy.bind(controller), `${name}.destroy`, middleware)\n    }\n\n    /**\n     * Named route URL generator\n     * \n     * @param name \n     * @param params \n     * @returns \n     */\n    route (name: string, params: Record<string, string> = {}): string | undefined {\n        const found = this.routes.find(r => r.name === name)\n        if (!found) return undefined\n\n        let url = found.path\n        for (const [key, value] of Object.entries(params)) {\n            url = url.replace(`:${key}`, value)\n        }\n        return url\n    }\n\n    /**\n     * Grouping\n     * \n     * @param options \n     * @param callback \n     */\n    group (options: { prefix?: string; middleware?: EventHandler[] }, callback: () => void) {\n        const prevPrefix = this.groupPrefix\n        const prevMiddleware = [...this.groupMiddleware]\n\n        this.groupPrefix += options.prefix || ''\n        this.groupMiddleware.push(...(options.middleware || []))\n\n        callback()\n\n        /**\n         * Restore state after group\n         */\n        this.groupPrefix = prevPrefix\n        this.groupMiddleware = prevMiddleware\n    }\n\n    middleware (path: string, handler: Middleware, opts?: MiddlewareOptions) {\n        this.h3App.use(path, handler, opts)\n    }\n}\n","import { readFile, stat } from \"node:fs/promises\";\n\nimport { ServiceProvider } from '@h3ravel/core'\nimport { before } from \"@h3ravel/support\";\nimport { join } from \"node:path\";\nimport { serveStatic } from 'h3'\nimport { statSync } from \"node:fs\";\n\n/**\n * Handles public assets loading\n * \n * Auto-Registered\n */\nexport class AssetsServiceProvider extends ServiceProvider {\n    register () {\n        const app = this.app.make('router')\n        const config = this.app.make('config')\n        const fsconfig = config.get('filesystem')\n        const publicPath = this.app.getPath('public')\n\n        app.middleware(`/${fsconfig.public_mask}/**`, (event) => {\n            return serveStatic(event, {\n                indexNames: [\"/index.html\"],\n                getContents: (id) => {\n                    const newId = id.replace(`/${fsconfig.public_mask}/`, '')\n                    return readFile(join(before(publicPath, newId), newId))\n                },\n                getMeta: async (id) => {\n                    const newId = id.replace(`/${fsconfig.public_mask}/`, '')\n                    const stats = await stat(join(before(publicPath, newId), newId)).catch(() => { });\n                    if (stats?.isFile()) {\n                        return {\n                            size: stats.size,\n                            mtime: stats.mtimeMs,\n                        };\n                    }\n                },\n            });\n        })\n\n        this.app.singleton('asset', () => {\n            return (key: string, def = '') => {\n                try {\n                    statSync(join(before(publicPath, key), key))\n                } catch {\n                    key = def\n                }\n\n                return join(fsconfig.public_mask, key)\n            }\n        })\n    }\n}\n","import { Router } from '../Router'\nimport { ServiceProvider } from '@h3ravel/core'\nimport path from 'node:path'\nimport { readdir } from 'node:fs/promises'\n\n/**\n * Handles routing registration\n * \n * Load route files (web.ts, api.ts).\n * Map controllers to routes.\n * Register route-related middleware.\n * \n * Auto-Registered\n */\nexport class RouteServiceProvider extends ServiceProvider {\n    register () {\n        this.app.singleton('router', () => {\n            const h3App = this.app.make('http.app')\n            return new Router(h3App, this.app)\n        })\n    }\n\n    /**\n     * Load routes from src/routes\n     */\n    async boot () {\n        try {\n            const routePath = this.app.getPath('routes')\n\n            const files = await readdir(routePath);\n\n            for (let i = 0; i < files.length; i++) {\n                const routesModule = await import(path.join(routePath, files[i]))\n\n                if (typeof routesModule.default === 'function') {\n                    const router = this.app.make('router')\n                    routesModule.default(router)\n                }\n            }\n        } catch (e) {\n            console.warn('No web routes found or failed to load:', e)\n        }\n    }\n}\n"],"mappings":"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","names":["Router","routes","groupPrefix","groupMiddleware","h3App","app","resolveHandler","handler","middleware","event","kernel","Kernel","handle","ctx","Promise","resolve","addRoute","method","path","name","fullPath","replace","push","resolveControllerOrHandler","methodName","prototype","Controller","controller","action","Error","get","post","put","delete","apiResource","afterLast","basePath","index","bind","store","show","update","destroy","route","params","found","find","r","undefined","url","key","value","Object","entries","group","options","callback","prevPrefix","prevMiddleware","prefix","opts","use","import_core","import_support","AssetsServiceProvider","ServiceProvider","register","app","make","config","fsconfig","get","publicPath","getPath","middleware","public_mask","event","serveStatic","indexNames","getContents","id","newId","replace","readFile","join","before","getMeta","stats","stat","catch","isFile","size","mtime","mtimeMs","singleton","key","def","statSync","import_core","import_node_path","import_promises","RouteServiceProvider","ServiceProvider","register","app","singleton","h3App","make","Router","boot","routePath","getPath","files","readdir","i","length","routesModule","path","join","default","router","e","console","warn"]}

package/dist/index.d.cts

@@ -0,0 +1,162 @@
+import { H3Event, H3, Middleware as Middleware$1, MiddlewareOptions } from 'h3';
+import { Application, Controller, ServiceProvider } from '@h3ravel/core';
+import { DotNestedKeys, DotNestedValue } from '@h3ravel/support';
+
+declare class Request {
+    private readonly event;
+    constructor(event: H3Event);
+    /**
+     * Get all input data (query + body).
+     */
+    all<T = Record<string, unknown>>(): Promise<T>;
+    /**
+     * Get a single input field from query or body.
+     */
+    input<T = unknown>(key: string, defaultValue?: T): Promise<T>;
+    /**
+     * Get route parameters.
+     */
+    params<T = Record<string, string>>(): T;
+    /**
+     * Get query parameters.
+     */
+    query<T = Record<string, string>>(): T;
+    /**
+     * Get the base event
+     */
+    getEvent(): H3Event;
+    getEvent<K extends DotNestedKeys<H3Event>>(key: K): DotNestedValue<H3Event, K>;
+}
+
+declare class Response {
+    private readonly event;
+    private statusCode;
+    private headers;
+    constructor(event: H3Event);
+    /**
+     * Set HTTP status code.
+     */
+    setStatusCode(code: number): this;
+    /**
+     * Set a header.
+     */
+    setHeader(name: string, value: string): this;
+    html(content: string): string;
+    /**
+     * Send a JSON response.
+     */
+    json<T = unknown>(data: T): T;
+    /**
+     * Send plain text.
+     */
+    text(data: string): string;
+    /**
+     * Redirect to another URL.
+     */
+    redirect(url: string, status?: number): string;
+    /**
+     * Apply headers before sending response.
+     */
+    private applyHeaders;
+    /**
+     * Get the base event
+     */
+    getEvent(): H3Event;
+    getEvent<K extends DotNestedKeys<H3Event>>(key: K): DotNestedValue<H3Event, K>;
+}
+
+interface HttpContext {
+    request: Request;
+    response: Response;
+}
+
+declare abstract class Middleware {
+    abstract handle(context: HttpContext, next: () => Promise<unknown>): Promise<unknown>;
+}
+
+type EventHandler = (ctx: HttpContext) => unknown;
+declare class Router {
+    private h3App;
+    private app;
+    private routes;
+    private groupPrefix;
+    private groupMiddleware;
+    constructor(h3App: H3, app: Application);
+    /**
+     * Route Resolver
+     *
+     * @param handler
+     * @param middleware
+     * @returns
+     */
+    private resolveHandler;
+    /**
+     * Add a route to the stack
+     *
+     * @param method
+     * @param path
+     * @param handler
+     * @param name
+     * @param middleware
+     */
+    private addRoute;
+    private resolveControllerOrHandler;
+    get(path: string, handler: EventHandler | (new (...args: any[]) => Controller), methodName?: string, name?: string, middleware?: Middleware[]): void;
+    post(path: string, handler: EventHandler | (new (...args: any[]) => Controller), methodName?: string, name?: string, middleware?: Middleware[]): void;
+    put(path: string, handler: EventHandler | (new (...args: any[]) => Controller), methodName?: string, name?: string, middleware?: Middleware[]): void;
+    delete(path: string, handler: EventHandler | (new (...args: any[]) => Controller), methodName?: string, name?: string, middleware?: Middleware[]): void;
+    /**
+     * API Resource support
+     *
+     * @param path
+     * @param controller
+     */
+    apiResource(path: string, Controller: new (app: Application) => Controller, middleware?: Middleware[]): void;
+    /**
+     * Named route URL generator
+     *
+     * @param name
+     * @param params
+     * @returns
+     */
+    route(name: string, params?: Record<string, string>): string | undefined;
+    /**
+     * Grouping
+     *
+     * @param options
+     * @param callback
+     */
+    group(options: {
+        prefix?: string;
+        middleware?: EventHandler[];
+    }, callback: () => void): void;
+    middleware(path: string, handler: Middleware$1, opts?: MiddlewareOptions): void;
+}
+
+/**
+ * Handles public assets loading
+ *
+ * Auto-Registered
+ */
+declare class AssetsServiceProvider extends ServiceProvider {
+    register(): void;
+}
+
+/**
+ * Handles routing registration
+ *
+ * Load route files (web.ts, api.ts).
+ * Map controllers to routes.
+ * Register route-related middleware.
+ *
+ * Auto-Registered
+ */
+declare class RouteServiceProvider extends ServiceProvider {
+    register(): void;
+    /**
+     * Load routes from src/routes
+     */
+    boot(): Promise<void>;
+}
+
+export { AssetsServiceProvider, RouteServiceProvider, Router };

package/dist/index.d.ts

@@ -0,0 +1,162 @@
+import { H3Event, H3, Middleware as Middleware$1, MiddlewareOptions } from 'h3';
+import { Application, Controller, ServiceProvider } from '@h3ravel/core';
+import { DotNestedKeys, DotNestedValue } from '@h3ravel/support';
+
+declare class Request {
+    private readonly event;
+    constructor(event: H3Event);
+    /**
+     * Get all input data (query + body).
+     */
+    all<T = Record<string, unknown>>(): Promise<T>;
+    /**
+     * Get a single input field from query or body.
+     */
+    input<T = unknown>(key: string, defaultValue?: T): Promise<T>;
+    /**
+     * Get route parameters.
+     */
+    params<T = Record<string, string>>(): T;
+    /**
+     * Get query parameters.
+     */
+    query<T = Record<string, string>>(): T;
+    /**
+     * Get the base event
+     */
+    getEvent(): H3Event;
+    getEvent<K extends DotNestedKeys<H3Event>>(key: K): DotNestedValue<H3Event, K>;
+}
+
+declare class Response {
+    private readonly event;
+    private statusCode;
+    private headers;
+    constructor(event: H3Event);
+    /**
+     * Set HTTP status code.
+     */
+    setStatusCode(code: number): this;
+    /**
+     * Set a header.
+     */
+    setHeader(name: string, value: string): this;
+    html(content: string): string;
+    /**
+     * Send a JSON response.
+     */
+    json<T = unknown>(data: T): T;
+    /**
+     * Send plain text.
+     */
+    text(data: string): string;
+    /**
+     * Redirect to another URL.
+     */
+    redirect(url: string, status?: number): string;
+    /**
+     * Apply headers before sending response.
+     */
+    private applyHeaders;
+    /**
+     * Get the base event
+     */
+    getEvent(): H3Event;
+    getEvent<K extends DotNestedKeys<H3Event>>(key: K): DotNestedValue<H3Event, K>;
+}
+
+interface HttpContext {
+    request: Request;
+    response: Response;
+}
+
+declare abstract class Middleware {
+    abstract handle(context: HttpContext, next: () => Promise<unknown>): Promise<unknown>;
+}
+
+type EventHandler = (ctx: HttpContext) => unknown;
+declare class Router {
+    private h3App;
+    private app;
+    private routes;
+    private groupPrefix;
+    private groupMiddleware;
+    constructor(h3App: H3, app: Application);
+    /**
+     * Route Resolver
+     *
+     * @param handler
+     * @param middleware
+     * @returns
+     */
+    private resolveHandler;
+    /**
+     * Add a route to the stack
+     *
+     * @param method
+     * @param path
+     * @param handler
+     * @param name
+     * @param middleware
+     */
+    private addRoute;
+    private resolveControllerOrHandler;
+    get(path: string, handler: EventHandler | (new (...args: any[]) => Controller), methodName?: string, name?: string, middleware?: Middleware[]): void;
+    post(path: string, handler: EventHandler | (new (...args: any[]) => Controller), methodName?: string, name?: string, middleware?: Middleware[]): void;
+    put(path: string, handler: EventHandler | (new (...args: any[]) => Controller), methodName?: string, name?: string, middleware?: Middleware[]): void;
+    delete(path: string, handler: EventHandler | (new (...args: any[]) => Controller), methodName?: string, name?: string, middleware?: Middleware[]): void;
+    /**
+     * API Resource support
+     *
+     * @param path
+     * @param controller
+     */
+    apiResource(path: string, Controller: new (app: Application) => Controller, middleware?: Middleware[]): void;
+    /**
+     * Named route URL generator
+     *
+     * @param name
+     * @param params
+     * @returns
+     */
+    route(name: string, params?: Record<string, string>): string | undefined;
+    /**
+     * Grouping
+     *
+     * @param options
+     * @param callback
+     */
+    group(options: {
+        prefix?: string;
+        middleware?: EventHandler[];
+    }, callback: () => void): void;
+    middleware(path: string, handler: Middleware$1, opts?: MiddlewareOptions): void;
+}
+
+/**
+ * Handles public assets loading
+ *
+ * Auto-Registered
+ */
+declare class AssetsServiceProvider extends ServiceProvider {
+    register(): void;
+}
+
+/**
+ * Handles routing registration
+ *
+ * Load route files (web.ts, api.ts).
+ * Map controllers to routes.
+ * Register route-related middleware.
+ *
+ * Auto-Registered
+ */
+declare class RouteServiceProvider extends ServiceProvider {
+    register(): void;
+    /**
+     * Load routes from src/routes
+     */
+    boot(): Promise<void>;
+}
+
+export { AssetsServiceProvider, RouteServiceProvider, Router };

package/dist/index.js

@@ -0,0 +1,222 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/Router.ts
+import { Controller, Kernel } from "@h3ravel/core";
+import { afterLast } from "@h3ravel/support";
+var Router = class {
+  static {
+    __name(this, "Router");
+  }
+  h3App;
+  app;
+  routes = [];
+  groupPrefix = "";
+  groupMiddleware = [];
+  constructor(h3App, app) {
+    this.h3App = h3App;
+    this.app = app;
+  }
+  /**
+   * Route Resolver
+   * 
+   * @param handler 
+   * @param middleware 
+   * @returns 
+   */
+  resolveHandler(handler, middleware = []) {
+    return async (event) => {
+      const kernel = new Kernel(middleware);
+      return kernel.handle(event, (ctx) => Promise.resolve(handler(ctx)));
+    };
+  }
+  /**
+   * Add a route to the stack
+   * 
+   * @param method 
+   * @param path 
+   * @param handler 
+   * @param name 
+   * @param middleware 
+   */
+  addRoute(method, path2, handler, name, middleware = []) {
+    const fullPath = `${this.groupPrefix}${path2}`.replace(/\/+/g, "/");
+    this.routes.push({
+      method,
+      path: fullPath,
+      name,
+      handler
+    });
+    this.h3App[method](fullPath, this.resolveHandler(handler, middleware));
+  }
+  resolveControllerOrHandler(handler, methodName) {
+    if (typeof handler === "function" && handler.prototype instanceof Controller) {
+      return (ctx) => {
+        const controller = new handler(this.app);
+        const action = methodName || "index";
+        if (typeof controller[action] !== "function") {
+          throw new Error(`Method "${action}" not found on controller ${handler.name}`);
+        }
+        return controller[action](ctx);
+      };
+    }
+    return handler;
+  }
+  get(path2, handler, methodName, name, middleware = []) {
+    this.addRoute("get", path2, this.resolveControllerOrHandler(handler, methodName), name, middleware);
+  }
+  post(path2, handler, methodName, name, middleware = []) {
+    this.addRoute("post", path2, this.resolveControllerOrHandler(handler, methodName), name, middleware);
+  }
+  put(path2, handler, methodName, name, middleware = []) {
+    this.addRoute("put", path2, this.resolveControllerOrHandler(handler, methodName), name, middleware);
+  }
+  delete(path2, handler, methodName, name, middleware = []) {
+    this.addRoute("delete", path2, this.resolveControllerOrHandler(handler, methodName), name, middleware);
+  }
+  /**
+   * API Resource support  
+   * 
+   * @param path 
+   * @param controller 
+   */
+  apiResource(path2, Controller2, middleware = []) {
+    path2 = path2.replace(/\//g, "/");
+    const name = afterLast(path2, "/");
+    const basePath = `/${path2}`.replace(/\/+/g, "/");
+    const controller = new Controller2(this.app);
+    this.addRoute("get", basePath, controller.index.bind(controller), `${name}.index`, middleware);
+    this.addRoute("post", basePath, controller.store.bind(controller), `${name}.store`, middleware);
+    this.addRoute("get", `${basePath}/:id`, controller.show.bind(controller), `${name}.show`, middleware);
+    this.addRoute("put", `${basePath}/:id`, controller.update.bind(controller), `${name}.update`, middleware);
+    this.addRoute("patch", `${basePath}/:id`, controller.update.bind(controller), `${name}.update`, middleware);
+    this.addRoute("delete", `${basePath}/:id`, controller.destroy.bind(controller), `${name}.destroy`, middleware);
+  }
+  /**
+   * Named route URL generator
+   * 
+   * @param name 
+   * @param params 
+   * @returns 
+   */
+  route(name, params = {}) {
+    const found = this.routes.find((r) => r.name === name);
+    if (!found) return void 0;
+    let url = found.path;
+    for (const [key, value] of Object.entries(params)) {
+      url = url.replace(`:${key}`, value);
+    }
+    return url;
+  }
+  /**
+   * Grouping
+   * 
+   * @param options 
+   * @param callback 
+   */
+  group(options, callback) {
+    const prevPrefix = this.groupPrefix;
+    const prevMiddleware = [
+      ...this.groupMiddleware
+    ];
+    this.groupPrefix += options.prefix || "";
+    this.groupMiddleware.push(...options.middleware || []);
+    callback();
+    this.groupPrefix = prevPrefix;
+    this.groupMiddleware = prevMiddleware;
+  }
+  middleware(path2, handler, opts) {
+    this.h3App.use(path2, handler, opts);
+  }
+};
+
+// src/Providers/AssetsServiceProvider.ts
+import { readFile, stat } from "fs/promises";
+import { ServiceProvider } from "@h3ravel/core";
+import { before } from "@h3ravel/support";
+import { join } from "path";
+import { serveStatic } from "h3";
+import { statSync } from "fs";
+var AssetsServiceProvider = class extends ServiceProvider {
+  static {
+    __name(this, "AssetsServiceProvider");
+  }
+  register() {
+    const app = this.app.make("router");
+    const config = this.app.make("config");
+    const fsconfig = config.get("filesystem");
+    const publicPath = this.app.getPath("public");
+    app.middleware(`/${fsconfig.public_mask}/**`, (event) => {
+      return serveStatic(event, {
+        indexNames: [
+          "/index.html"
+        ],
+        getContents: /* @__PURE__ */ __name((id) => {
+          const newId = id.replace(`/${fsconfig.public_mask}/`, "");
+          return readFile(join(before(publicPath, newId), newId));
+        }, "getContents"),
+        getMeta: /* @__PURE__ */ __name(async (id) => {
+          const newId = id.replace(`/${fsconfig.public_mask}/`, "");
+          const stats = await stat(join(before(publicPath, newId), newId)).catch(() => {
+          });
+          if (stats?.isFile()) {
+            return {
+              size: stats.size,
+              mtime: stats.mtimeMs
+            };
+          }
+        }, "getMeta")
+      });
+    });
+    this.app.singleton("asset", () => {
+      return (key, def = "") => {
+        try {
+          statSync(join(before(publicPath, key), key));
+        } catch {
+          key = def;
+        }
+        return join(fsconfig.public_mask, key);
+      };
+    });
+  }
+};
+
+// src/Providers/RouteServiceProvider.ts
+import { ServiceProvider as ServiceProvider2 } from "@h3ravel/core";
+import path from "path";
+import { readdir } from "fs/promises";
+var RouteServiceProvider = class extends ServiceProvider2 {
+  static {
+    __name(this, "RouteServiceProvider");
+  }
+  register() {
+    this.app.singleton("router", () => {
+      const h3App = this.app.make("http.app");
+      return new Router(h3App, this.app);
+    });
+  }
+  /**
+   * Load routes from src/routes
+   */
+  async boot() {
+    try {
+      const routePath = this.app.getPath("routes");
+      const files = await readdir(routePath);
+      for (let i = 0; i < files.length; i++) {
+        const routesModule = await import(path.join(routePath, files[i]));
+        if (typeof routesModule.default === "function") {
+          const router = this.app.make("router");
+          routesModule.default(router);
+        }
+      }
+    } catch (e) {
+      console.warn("No web routes found or failed to load:", e);
+    }
+  }
+};
+export {
+  AssetsServiceProvider,
+  RouteServiceProvider,
+  Router
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/Router.ts","../src/Providers/AssetsServiceProvider.ts","../src/Providers/RouteServiceProvider.ts"],"sourcesContent":["import { H3Event, Middleware, MiddlewareOptions, type H3 } from 'h3'\nimport { Application, Controller, Kernel } from '@h3ravel/core'\nimport { Middleware as HttpMiddleware } from '@h3ravel/http'\nimport { HttpContext } from '@h3ravel/http'\nimport { afterLast } from '@h3ravel/support'\n\ntype EventHandler = (ctx: HttpContext) => unknown\n\ninterface RouteDefinition {\n    method: string\n    path: string\n    name?: string\n    handler: EventHandler\n}\n\nexport class Router {\n    private routes: RouteDefinition[] = []\n    private groupPrefix = ''\n    private groupMiddleware: EventHandler[] = []\n\n    constructor(private h3App: H3, private app: Application) { }\n\n    /**\n     * Route Resolver\n     * \n     * @param handler \n     * @param middleware \n     * @returns \n     */\n    private resolveHandler (handler: EventHandler, middleware: HttpMiddleware[] = []) {\n        return async (event: H3Event) => {\n            const kernel = new Kernel(middleware)\n            return kernel.handle(event, (ctx) => Promise.resolve(handler(ctx)))\n        }\n    }\n\n    /**\n     * Add a route to the stack\n     * \n     * @param method \n     * @param path \n     * @param handler \n     * @param name \n     * @param middleware \n     */\n    private addRoute (\n        method: string,\n        path: string,\n        handler: EventHandler,\n        name?: string,\n        middleware: HttpMiddleware[] = []\n    ) {\n        const fullPath = `${this.groupPrefix}${path}`.replace(/\\/+/g, '/')\n        this.routes.push({ method, path: fullPath, name, handler })\n        this.h3App[method as 'get'](fullPath, this.resolveHandler(handler, middleware))\n    }\n\n    private resolveControllerOrHandler (\n        handler: EventHandler | (new (...args: any[]) => Controller),\n        methodName?: string\n    ): EventHandler {\n        if (typeof handler === 'function' && (handler as any).prototype instanceof Controller) {\n            return (ctx) => {\n                const controller = new (handler as new (...args: any[]) => Controller)(this.app)\n                const action = (methodName || 'index') as keyof Controller\n\n                if (typeof controller[action] !== 'function') {\n                    throw new Error(`Method \"${action}\" not found on controller ${handler.name}`)\n                }\n\n                return controller[action](ctx)\n            }\n        }\n\n        return handler as EventHandler\n    }\n\n\n    get (\n        path: string,\n        handler: EventHandler | (new (...args: any[]) => Controller),\n        methodName?: string, name?: string, middleware: HttpMiddleware[] = []\n    ) {\n        this.addRoute('get', path, this.resolveControllerOrHandler(handler, methodName), name, middleware)\n    }\n\n    post (\n        path: string,\n        handler: EventHandler | (new (...args: any[]) => Controller),\n        methodName?: string, name?: string, middleware: HttpMiddleware[] = []\n    ) {\n        this.addRoute('post', path, this.resolveControllerOrHandler(handler, methodName), name, middleware)\n    }\n\n    put (\n        path: string,\n        handler: EventHandler | (new (...args: any[]) => Controller),\n        methodName?: string, name?: string, middleware: HttpMiddleware[] = []\n    ) {\n        this.addRoute('put', path, this.resolveControllerOrHandler(handler, methodName), name, middleware)\n    }\n\n    delete (\n        path: string,\n        handler: EventHandler | (new (...args: any[]) => Controller),\n        methodName?: string, name?: string, middleware: HttpMiddleware[] = []\n    ) {\n        this.addRoute('delete', path, this.resolveControllerOrHandler(handler, methodName), name, middleware)\n    }\n\n    /**\n     * API Resource support  \n     * \n     * @param path \n     * @param controller \n     */\n    apiResource (\n        path: string,\n        Controller: new (app: Application) => Controller,\n        middleware: HttpMiddleware[] = []\n    ) {\n        path = path.replace(/\\//g, '/')\n\n        const name = afterLast(path, '/')\n        const basePath = `/${path}`.replace(/\\/+/g, '/')\n\n        const controller = new Controller(this.app)\n\n        this.addRoute('get', basePath, controller.index.bind(controller), `${name}.index`, middleware)\n        this.addRoute('post', basePath, controller.store.bind(controller), `${name}.store`, middleware)\n        this.addRoute('get', `${basePath}/:id`, controller.show.bind(controller), `${name}.show`, middleware)\n        this.addRoute('put', `${basePath}/:id`, controller.update.bind(controller), `${name}.update`, middleware)\n        this.addRoute('patch', `${basePath}/:id`, controller.update.bind(controller), `${name}.update`, middleware)\n        this.addRoute('delete', `${basePath}/:id`, controller.destroy.bind(controller), `${name}.destroy`, middleware)\n    }\n\n    /**\n     * Named route URL generator\n     * \n     * @param name \n     * @param params \n     * @returns \n     */\n    route (name: string, params: Record<string, string> = {}): string | undefined {\n        const found = this.routes.find(r => r.name === name)\n        if (!found) return undefined\n\n        let url = found.path\n        for (const [key, value] of Object.entries(params)) {\n            url = url.replace(`:${key}`, value)\n        }\n        return url\n    }\n\n    /**\n     * Grouping\n     * \n     * @param options \n     * @param callback \n     */\n    group (options: { prefix?: string; middleware?: EventHandler[] }, callback: () => void) {\n        const prevPrefix = this.groupPrefix\n        const prevMiddleware = [...this.groupMiddleware]\n\n        this.groupPrefix += options.prefix || ''\n        this.groupMiddleware.push(...(options.middleware || []))\n\n        callback()\n\n        /**\n         * Restore state after group\n         */\n        this.groupPrefix = prevPrefix\n        this.groupMiddleware = prevMiddleware\n    }\n\n    middleware (path: string, handler: Middleware, opts?: MiddlewareOptions) {\n        this.h3App.use(path, handler, opts)\n    }\n}\n","import { readFile, stat } from \"node:fs/promises\";\n\nimport { ServiceProvider } from '@h3ravel/core'\nimport { before } from \"@h3ravel/support\";\nimport { join } from \"node:path\";\nimport { serveStatic } from 'h3'\nimport { statSync } from \"node:fs\";\n\n/**\n * Handles public assets loading\n * \n * Auto-Registered\n */\nexport class AssetsServiceProvider extends ServiceProvider {\n    register () {\n        const app = this.app.make('router')\n        const config = this.app.make('config')\n        const fsconfig = config.get('filesystem')\n        const publicPath = this.app.getPath('public')\n\n        app.middleware(`/${fsconfig.public_mask}/**`, (event) => {\n            return serveStatic(event, {\n                indexNames: [\"/index.html\"],\n                getContents: (id) => {\n                    const newId = id.replace(`/${fsconfig.public_mask}/`, '')\n                    return readFile(join(before(publicPath, newId), newId))\n                },\n                getMeta: async (id) => {\n                    const newId = id.replace(`/${fsconfig.public_mask}/`, '')\n                    const stats = await stat(join(before(publicPath, newId), newId)).catch(() => { });\n                    if (stats?.isFile()) {\n                        return {\n                            size: stats.size,\n                            mtime: stats.mtimeMs,\n                        };\n                    }\n                },\n            });\n        })\n\n        this.app.singleton('asset', () => {\n            return (key: string, def = '') => {\n                try {\n                    statSync(join(before(publicPath, key), key))\n                } catch {\n                    key = def\n                }\n\n                return join(fsconfig.public_mask, key)\n            }\n        })\n    }\n}\n","import { Router } from '../Router'\nimport { ServiceProvider } from '@h3ravel/core'\nimport path from 'node:path'\nimport { readdir } from 'node:fs/promises'\n\n/**\n * Handles routing registration\n * \n * Load route files (web.ts, api.ts).\n * Map controllers to routes.\n * Register route-related middleware.\n * \n * Auto-Registered\n */\nexport class RouteServiceProvider extends ServiceProvider {\n    register () {\n        this.app.singleton('router', () => {\n            const h3App = this.app.make('http.app')\n            return new Router(h3App, this.app)\n        })\n    }\n\n    /**\n     * Load routes from src/routes\n     */\n    async boot () {\n        try {\n            const routePath = this.app.getPath('routes')\n\n            const files = await readdir(routePath);\n\n            for (let i = 0; i < files.length; i++) {\n                const routesModule = await import(path.join(routePath, files[i]))\n\n                if (typeof routesModule.default === 'function') {\n                    const router = this.app.make('router')\n                    routesModule.default(router)\n                }\n            }\n        } catch (e) {\n            console.warn('No web routes found or failed to load:', e)\n        }\n    }\n}\n"],"mappings":"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","names":["Controller","Kernel","afterLast","Router","routes","groupPrefix","groupMiddleware","h3App","app","resolveHandler","handler","middleware","event","kernel","Kernel","handle","ctx","Promise","resolve","addRoute","method","path","name","fullPath","replace","push","resolveControllerOrHandler","methodName","prototype","Controller","controller","action","Error","get","post","put","delete","apiResource","afterLast","basePath","index","bind","store","show","update","destroy","route","params","found","find","r","undefined","url","key","value","Object","entries","group","options","callback","prevPrefix","prevMiddleware","prefix","opts","use","readFile","stat","ServiceProvider","before","join","serveStatic","statSync","AssetsServiceProvider","ServiceProvider","register","app","make","config","fsconfig","get","publicPath","getPath","middleware","public_mask","event","serveStatic","indexNames","getContents","id","newId","replace","readFile","join","before","getMeta","stats","stat","catch","isFile","size","mtime","mtimeMs","singleton","key","def","statSync","ServiceProvider","path","readdir","RouteServiceProvider","ServiceProvider","register","app","singleton","h3App","make","Router","boot","routePath","getPath","files","readdir","i","length","routesModule","path","join","default","router","e","console","warn"]}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@h3ravel/router",
+  "version": "0.1.0",
+  "description": "Route facade, decorators and controller system for H3ravel.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "h3": "^2.0.0-beta.1",
+    "@h3ravel/core": "0.1.0",
+    "@h3ravel/support": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0"
+  },
+  "scripts": {
+    "barrel": "barrelsby --directory src --delete --singleQuotes",
+    "build": "tsup",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "lint": "eslint . --ext .ts",
+    "test": "vitest"
+  }
+}

package/src/Controller.ts

@@ -0,0 +1 @@
+export default class { }

package/src/Decorators/ApiResource.ts

@@ -0,0 +1 @@
+export default class { }

package/src/Decorators/Controller.ts

@@ -0,0 +1 @@
+export default class { }

package/src/Decorators/Get.ts

@@ -0,0 +1 @@
+export default class { }

package/src/Decorators/Middleware.ts

@@ -0,0 +1 @@
+export default class { }

package/src/Decorators/Post.ts

@@ -0,0 +1 @@
+export default class { }

package/src/Providers/AssetsServiceProvider.ts

@@ -0,0 +1,53 @@
+import { readFile, stat } from "node:fs/promises";
+
+import { ServiceProvider } from '@h3ravel/core'
+import { before } from "@h3ravel/support";
+import { join } from "node:path";
+import { serveStatic } from 'h3'
+import { statSync } from "node:fs";
+
+/**
+ * Handles public assets loading
+ * 
+ * Auto-Registered
+ */
+export class AssetsServiceProvider extends ServiceProvider {
+    register () {
+        const app = this.app.make('router')
+        const config = this.app.make('config')
+        const fsconfig = config.get('filesystem')
+        const publicPath = this.app.getPath('public')
+
+        app.middleware(`/${fsconfig.public_mask}/**`, (event) => {
+            return serveStatic(event, {
+                indexNames: ["/index.html"],
+                getContents: (id) => {
+                    const newId = id.replace(`/${fsconfig.public_mask}/`, '')
+                    return readFile(join(before(publicPath, newId), newId))
+                },
+                getMeta: async (id) => {
+                    const newId = id.replace(`/${fsconfig.public_mask}/`, '')
+                    const stats = await stat(join(before(publicPath, newId), newId)).catch(() => { });
+                    if (stats?.isFile()) {
+                        return {
+                            size: stats.size,
+                            mtime: stats.mtimeMs,
+                        };
+                    }
+                },
+            });
+        })
+
+        this.app.singleton('asset', () => {
+            return (key: string, def = '') => {
+                try {
+                    statSync(join(before(publicPath, key), key))
+                } catch {
+                    key = def
+                }
+
+                return join(fsconfig.public_mask, key)
+            }
+        })
+    }
+}

package/src/Providers/RouteServiceProvider.ts

@@ -0,0 +1,44 @@
+import { Router } from '../Router'
+import { ServiceProvider } from '@h3ravel/core'
+import path from 'node:path'
+import { readdir } from 'node:fs/promises'
+
+/**
+ * Handles routing registration
+ * 
+ * Load route files (web.ts, api.ts).
+ * Map controllers to routes.
+ * Register route-related middleware.
+ * 
+ * Auto-Registered
+ */
+export class RouteServiceProvider extends ServiceProvider {
+    register () {
+        this.app.singleton('router', () => {
+            const h3App = this.app.make('http.app')
+            return new Router(h3App, this.app)
+        })
+    }
+
+    /**
+     * Load routes from src/routes
+     */
+    async boot () {
+        try {
+            const routePath = this.app.getPath('routes')
+
+            const files = await readdir(routePath);
+
+            for (let i = 0; i < files.length; i++) {
+                const routesModule = await import(path.join(routePath, files[i]))
+
+                if (typeof routesModule.default === 'function') {
+                    const router = this.app.make('router')
+                    routesModule.default(router)
+                }
+            }
+        } catch (e) {
+            console.warn('No web routes found or failed to load:', e)
+        }
+    }
+}

package/src/Route.ts

@@ -0,0 +1 @@
+export default class { }

package/src/Router.ts

@@ -0,0 +1,180 @@
+import { H3Event, Middleware, MiddlewareOptions, type H3 } from 'h3'
+import { Application, Controller, Kernel } from '@h3ravel/core'
+import { Middleware as HttpMiddleware } from '@h3ravel/http'
+import { HttpContext } from '@h3ravel/http'
+import { afterLast } from '@h3ravel/support'
+
+type EventHandler = (ctx: HttpContext) => unknown
+
+interface RouteDefinition {
+    method: string
+    path: string
+    name?: string
+    handler: EventHandler
+}
+
+export class Router {
+    private routes: RouteDefinition[] = []
+    private groupPrefix = ''
+    private groupMiddleware: EventHandler[] = []
+
+    constructor(private h3App: H3, private app: Application) { }
+
+    /**
+     * Route Resolver
+     * 
+     * @param handler 
+     * @param middleware 
+     * @returns 
+     */
+    private resolveHandler (handler: EventHandler, middleware: HttpMiddleware[] = []) {
+        return async (event: H3Event) => {
+            const kernel = new Kernel(middleware)
+            return kernel.handle(event, (ctx) => Promise.resolve(handler(ctx)))
+        }
+    }
+
+    /**
+     * Add a route to the stack
+     * 
+     * @param method 
+     * @param path 
+     * @param handler 
+     * @param name 
+     * @param middleware 
+     */
+    private addRoute (
+        method: string,
+        path: string,
+        handler: EventHandler,
+        name?: string,
+        middleware: HttpMiddleware[] = []
+    ) {
+        const fullPath = `${this.groupPrefix}${path}`.replace(/\/+/g, '/')
+        this.routes.push({ method, path: fullPath, name, handler })
+        this.h3App[method as 'get'](fullPath, this.resolveHandler(handler, middleware))
+    }
+
+    private resolveControllerOrHandler (
+        handler: EventHandler | (new (...args: any[]) => Controller),
+        methodName?: string
+    ): EventHandler {
+        if (typeof handler === 'function' && (handler as any).prototype instanceof Controller) {
+            return (ctx) => {
+                const controller = new (handler as new (...args: any[]) => Controller)(this.app)
+                const action = (methodName || 'index') as keyof Controller
+
+                if (typeof controller[action] !== 'function') {
+                    throw new Error(`Method "${action}" not found on controller ${handler.name}`)
+                }
+
+                return controller[action](ctx)
+            }
+        }
+
+        return handler as EventHandler
+    }
+
+
+    get (
+        path: string,
+        handler: EventHandler | (new (...args: any[]) => Controller),
+        methodName?: string, name?: string, middleware: HttpMiddleware[] = []
+    ) {
+        this.addRoute('get', path, this.resolveControllerOrHandler(handler, methodName), name, middleware)
+    }
+
+    post (
+        path: string,
+        handler: EventHandler | (new (...args: any[]) => Controller),
+        methodName?: string, name?: string, middleware: HttpMiddleware[] = []
+    ) {
+        this.addRoute('post', path, this.resolveControllerOrHandler(handler, methodName), name, middleware)
+    }
+
+    put (
+        path: string,
+        handler: EventHandler | (new (...args: any[]) => Controller),
+        methodName?: string, name?: string, middleware: HttpMiddleware[] = []
+    ) {
+        this.addRoute('put', path, this.resolveControllerOrHandler(handler, methodName), name, middleware)
+    }
+
+    delete (
+        path: string,
+        handler: EventHandler | (new (...args: any[]) => Controller),
+        methodName?: string, name?: string, middleware: HttpMiddleware[] = []
+    ) {
+        this.addRoute('delete', path, this.resolveControllerOrHandler(handler, methodName), name, middleware)
+    }
+
+    /**
+     * API Resource support  
+     * 
+     * @param path 
+     * @param controller 
+     */
+    apiResource (
+        path: string,
+        Controller: new (app: Application) => Controller,
+        middleware: HttpMiddleware[] = []
+    ) {
+        path = path.replace(/\//g, '/')
+
+        const name = afterLast(path, '/')
+        const basePath = `/${path}`.replace(/\/+/g, '/')
+
+        const controller = new Controller(this.app)
+
+        this.addRoute('get', basePath, controller.index.bind(controller), `${name}.index`, middleware)
+        this.addRoute('post', basePath, controller.store.bind(controller), `${name}.store`, middleware)
+        this.addRoute('get', `${basePath}/:id`, controller.show.bind(controller), `${name}.show`, middleware)
+        this.addRoute('put', `${basePath}/:id`, controller.update.bind(controller), `${name}.update`, middleware)
+        this.addRoute('patch', `${basePath}/:id`, controller.update.bind(controller), `${name}.update`, middleware)
+        this.addRoute('delete', `${basePath}/:id`, controller.destroy.bind(controller), `${name}.destroy`, middleware)
+    }
+
+    /**
+     * Named route URL generator
+     * 
+     * @param name 
+     * @param params 
+     * @returns 
+     */
+    route (name: string, params: Record<string, string> = {}): string | undefined {
+        const found = this.routes.find(r => r.name === name)
+        if (!found) return undefined
+
+        let url = found.path
+        for (const [key, value] of Object.entries(params)) {
+            url = url.replace(`:${key}`, value)
+        }
+        return url
+    }
+
+    /**
+     * Grouping
+     * 
+     * @param options 
+     * @param callback 
+     */
+    group (options: { prefix?: string; middleware?: EventHandler[] }, callback: () => void) {
+        const prevPrefix = this.groupPrefix
+        const prevMiddleware = [...this.groupMiddleware]
+
+        this.groupPrefix += options.prefix || ''
+        this.groupMiddleware.push(...(options.middleware || []))
+
+        callback()
+
+        /**
+         * Restore state after group
+         */
+        this.groupPrefix = prevPrefix
+        this.groupMiddleware = prevMiddleware
+    }
+
+    middleware (path: string, handler: Middleware, opts?: MiddlewareOptions) {
+        this.h3App.use(path, handler, opts)
+    }
+}

package/src/index.ts

@@ -0,0 +1,14 @@
+/**
+ * @file Automatically generated by barrelsby.
+ */
+
+export * from './Controller';
+export * from './Route';
+export * from './Router';
+export * from './Decorators/ApiResource';
+export * from './Decorators/Controller';
+export * from './Decorators/Get';
+export * from './Decorators/Middleware';
+export * from './Decorators/Post';
+export * from './Providers/AssetsServiceProvider';
+export * from './Providers/RouteServiceProvider';

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "dist"
+  },
+  "include": ["src"],
+  "exclude": ["dist", "node_modules"]
+}

package/vite.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from 'tsup'
+
+export default defineConfig({
+    entry: ['src/index.ts'],
+    format: ['esm', 'cjs'],
+    dts: true,
+    sourcemap: true,
+    clean: true
+})