@arikajs/router 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ArikaJs
+
+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/README.md

@@ -0,0 +1,189 @@
+## Arika Router
+
+`@arikajs/router` is the **routing and request-dispatching layer** of the ArikaJS framework.
+
+It is responsible for mapping HTTP requests to route handlers in a predictable, framework-controlled way, without depending on Express, Fastify, or any external routing library.
+
+Arika Router integrates directly with **@arikajs/http** and **@arikajs/foundation** to provide an elegant, intuitive routing experience.
+
+---
+
+### Status
+
+- **Stage**: Early Development / v0.x
+- **Scope (v1.x)**:
+  - HTTP method based routing (GET, POST, PUT, PATCH, DELETE)
+  - Path-based route matching (Static & Regex)
+  - Route parameters (`/users/:id`)
+  - Central route registry
+  - Route grouping with prefixes & middleware
+  - Route naming
+  - Controller resolution from container
+  - Route handler execution (dispatching)
+- **Out of scope (for now)**:
+  - API Versioning helpers
+  - Automatic OpenAPI/Swagger generation
+
+---
+
+## Features
+
+- **Core Routing**
+  - HTTP method based routing (GET, POST, PUT, PATCH, DELETE)
+  - Path-based route matching
+  - Central route registry
+
+- **Route Grouping**
+  - Group routes with a common prefix
+  - Nested groups support
+
+- **Request Matching**
+  - Method + path matching
+  - First match wins logic
+  - Predictable matching order
+
+- **Dispatching**
+  - Route handler execution
+  - Framework-controlled dispatch flow
+  - Decoupled from HTTP response handling
+
+---
+
+## Installation
+
+```bash
+npm install @arikajs/router
+# or
+yarn add @arikajs/router
+# or
+pnpm add @arikajs/router
+```
+
+⚠️ Requires `@arikajs/http` and `@arikajs/foundation`.
+
+---
+
+## Quick Start
+
+### 1. Register Routes
+
+```ts
+import { Route } from '@arikajs/router';
+
+Route.get('/hello', () => {
+  return 'Hello World';
+});
+
+Route.post('/submit', (request) => {
+  return 'Form submitted';
+});
+```
+
+### 2. Route Parameters & Fluent Chaining
+
+```ts
+Route.get('/users/:id', (request, id) => {
+  return `User ID: ${id}`;
+})
+.as('users.show')
+.withMiddleware(AuthMiddleware);
+```
+
+### 3. Controller Resolution
+
+```ts
+import { UserController } from './controllers/UserController';
+
+Route.get('/users', [UserController, 'index']);
+```
+
+### 4. Route Grouping
+
+```ts
+Route.group('/api', () => {
+  Route.get('/users', () => {
+    return ['user1', 'user2'];
+  });
+});
+```
+
+---
+
+## Architecture Overview
+
+The router follows a simple flow:
+
+```text
+HTTP Request
+↓
+HttpKernel (@arikajs/http)
+↓
+RouteMatcher
+↓
+Matched Route
+↓
+Dispatcher
+↓
+Handler Execution
+```
+
+The router never writes to the response directly. It only decides **which handler should run**.
+
+---
+
+## Route Matching
+
+The router matches incoming requests using method and path:
+
+```ts
+const route = routeMatcher.match('GET', '/hello');
+```
+
+Matching rules:
+- Method must match exactly.
+- Supports both static paths and dynamic parameters (`/users/:id`).
+- The first route defined that matches will be selected.
+
+---
+
+## Dispatching
+
+Once a route is matched, the dispatcher executes the handler:
+
+```ts
+await dispatcher.dispatch(route, request);
+```
+
+The dispatcher focuses purely on execution, leaving middleware and response formatting to other layers of the framework.
+
+---
+
+## Road Map
+
+- [x] Route parameters (`/users/:id`)
+- [x] Controller resolution from container
+- [x] Route-level middleware
+- [x] Named routes
+- [x] Route caching for performance
+
+---
+
+## Versioning & Stability
+
+- While in **v0.x**, the API may change between minor versions.
+- Once the core routing engine stabilizes, `@arikajs/router` will move to **v1.0** and follow **semver** strictly.
+
+---
+
+## Contributing
+
+Contributions are welcome! Please ensure you:
+- Run the test suite before submitting PRs.
+- Add tests for new features.
+- Follow the existing coding style.
+
+---
+
+## License
+
+`@arikajs/router` is open-sourced software licensed under the **MIT license**.

package/dist/Route.d.ts

@@ -0,0 +1,15 @@
+import { RouteHandler } from './types';
+import { RouteEntry } from './RouteEntry';
+export declare class Route {
+    static get(path: string, handler: RouteHandler): RouteEntry;
+    static post(path: string, handler: RouteHandler): RouteEntry;
+    static put(path: string, handler: RouteHandler): RouteEntry;
+    static patch(path: string, handler: RouteHandler): RouteEntry;
+    static delete(path: string, handler: RouteHandler): RouteEntry;
+    static group(options: string | {
+        prefix?: string;
+        middleware?: any | any[];
+    }, callback: () => void): void;
+    static model(key: string, resolver: any): void;
+}
+//# sourceMappingURL=Route.d.ts.map

package/dist/Route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Route.d.ts","sourceRoot":"","sources":["../src/Route.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,qBAAa,KAAK;WACA,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,UAAU;WAIpD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,UAAU;WAIrD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,UAAU;WAIpD,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,UAAU;WAItD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,UAAU;WAIvD,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,GAAG,GAAG,GAAG,EAAE,CAAA;KAAE,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;WAIlG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,IAAI;CAGxD"}

package/dist/Route.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Route = void 0;
+const RouteRegistry_1 = require("./RouteRegistry");
+class Route {
+    static get(path, handler) {
+        return RouteRegistry_1.RouteRegistry.getInstance().addRoute('GET', path, handler);
+    }
+    static post(path, handler) {
+        return RouteRegistry_1.RouteRegistry.getInstance().addRoute('POST', path, handler);
+    }
+    static put(path, handler) {
+        return RouteRegistry_1.RouteRegistry.getInstance().addRoute('PUT', path, handler);
+    }
+    static patch(path, handler) {
+        return RouteRegistry_1.RouteRegistry.getInstance().addRoute('PATCH', path, handler);
+    }
+    static delete(path, handler) {
+        return RouteRegistry_1.RouteRegistry.getInstance().addRoute('DELETE', path, handler);
+    }
+    static group(options, callback) {
+        RouteRegistry_1.RouteRegistry.getInstance().group(options, callback);
+    }
+    static model(key, resolver) {
+        RouteRegistry_1.RouteRegistry.getInstance().model(key, resolver);
+    }
+}
+exports.Route = Route;
+//# sourceMappingURL=Route.js.map

package/dist/Route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Route.js","sourceRoot":"","sources":["../src/Route.ts"],"names":[],"mappings":";;;AAAA,mDAAgD;AAIhD,MAAa,KAAK;IACP,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,OAAqB;QACjD,OAAO,6BAAa,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IAEM,MAAM,CAAC,IAAI,CAAC,IAAY,EAAE,OAAqB;QAClD,OAAO,6BAAa,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;IAEM,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,OAAqB;QACjD,OAAO,6BAAa,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,IAAY,EAAE,OAAqB;QACnD,OAAO,6BAAa,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACxE,CAAC;IAEM,MAAM,CAAC,MAAM,CAAC,IAAY,EAAE,OAAqB;QACpD,OAAO,6BAAa,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,OAA+D,EAAE,QAAoB;QACrG,6BAAa,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACzD,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,GAAW,EAAE,QAAa;QAC1C,6BAAa,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACrD,CAAC;CACJ;AA5BD,sBA4BC"}

package/dist/RouteEntry.d.ts

@@ -0,0 +1,25 @@
+import { RouteHandler, RouteDefinition } from './types';
+export declare class RouteEntry implements RouteDefinition {
+    method: string;
+    path: string;
+    handler: RouteHandler;
+    name?: string;
+    prefix?: string;
+    middleware: any[];
+    regex: RegExp;
+    paramKeys: string[];
+    constructor(method: string, path: string, handler: RouteHandler, prefix?: string, groupMiddleware?: any[]);
+    /**
+     * Set a name for the route.
+     */
+    as(name: string): this;
+    /**
+     * Add middleware to the route.
+     */
+    withMiddleware(middleware: any | any[]): this;
+    /**
+     * Compile the path into a regex.
+     */
+    private compilePath;
+}
+//# sourceMappingURL=RouteEntry.d.ts.map

package/dist/RouteEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteEntry.d.ts","sourceRoot":"","sources":["../src/RouteEntry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAExD,qBAAa,UAAW,YAAW,eAAe;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,GAAG,EAAE,CAAM;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,EAAE,CAAM;gBAEpB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,eAAe,GAAE,GAAG,EAAO;IAY7G;;OAEG;IACI,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK7B;;OAEG;IACI,cAAc,CAAC,UAAU,EAAE,GAAG,GAAG,GAAG,EAAE,GAAG,IAAI;IASpD;;OAEG;IACH,OAAO,CAAC,WAAW;CActB"}

package/dist/RouteEntry.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RouteEntry = void 0;
+class RouteEntry {
+    constructor(method, path, handler, prefix, groupMiddleware = []) {
+        this.middleware = [];
+        this.paramKeys = [];
+        this.method = method.toUpperCase();
+        this.path = path;
+        this.handler = handler;
+        this.prefix = prefix;
+        this.middleware = [...groupMiddleware];
+        const { regex, paramKeys } = this.compilePath(path);
+        this.regex = regex;
+        this.paramKeys = paramKeys;
+    }
+    /**
+     * Set a name for the route.
+     */
+    as(name) {
+        this.name = name;
+        return this;
+    }
+    /**
+     * Add middleware to the route.
+     */
+    withMiddleware(middleware) {
+        if (Array.isArray(middleware)) {
+            this.middleware.push(...middleware);
+        }
+        else {
+            this.middleware.push(middleware);
+        }
+        return this;
+    }
+    /**
+     * Compile the path into a regex.
+     */
+    compilePath(path) {
+        const paramKeys = [];
+        const pattern = path
+            .replace(/:([a-zA-Z0-9_]+)|\{([a-zA-Z0-9_]+)\}/g, (_, key1, key2) => {
+            paramKeys.push(key1 || key2);
+            return '([^/]+)';
+        })
+            .replace(/\//g, '\\/');
+        return {
+            regex: new RegExp(`^${pattern}$`),
+            paramKeys
+        };
+    }
+}
+exports.RouteEntry = RouteEntry;
+//# sourceMappingURL=RouteEntry.js.map

package/dist/RouteEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteEntry.js","sourceRoot":"","sources":["../src/RouteEntry.ts"],"names":[],"mappings":";;;AAEA,MAAa,UAAU;IAUnB,YAAY,MAAc,EAAE,IAAY,EAAE,OAAqB,EAAE,MAAe,EAAE,kBAAyB,EAAE;QAJtG,eAAU,GAAU,EAAE,CAAC;QAEvB,cAAS,GAAa,EAAE,CAAC;QAG5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,CAAC,GAAG,eAAe,CAAC,CAAC;QAEvC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC/B,CAAC;IAED;;OAEG;IACI,EAAE,CAAC,IAAY;QAClB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACI,cAAc,CAAC,UAAuB;QACzC,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,IAAY;QAC5B,MAAM,SAAS,GAAa,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,IAAI;aACf,OAAO,CAAC,uCAAuC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;YAChE,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;YAC7B,OAAO,SAAS,CAAC;QACrB,CAAC,CAAC;aACD,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAE3B,OAAO;YACH,KAAK,EAAE,IAAI,MAAM,CAAC,IAAI,OAAO,GAAG,CAAC;YACjC,SAAS;SACZ,CAAC;IACN,CAAC;CACJ;AA3DD,gCA2DC"}

package/dist/RouteMatcher.d.ts

@@ -0,0 +1,6 @@
+import { MatchedRoute } from './types';
+export declare class RouteMatcher {
+    match(method: string, path: string): MatchedRoute | null;
+    private normalizePath;
+}
+//# sourceMappingURL=RouteMatcher.d.ts.map

package/dist/RouteMatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteMatcher.d.ts","sourceRoot":"","sources":["../src/RouteMatcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGvC,qBAAa,YAAY;IACd,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IA2B/D,OAAO,CAAC,aAAa;CAGxB"}

package/dist/RouteMatcher.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RouteMatcher = void 0;
+const RouteRegistry_1 = require("./RouteRegistry");
+class RouteMatcher {
+    match(method, path) {
+        const routes = RouteRegistry_1.RouteRegistry.getInstance().getRoutes();
+        const normalizedMethod = method.toUpperCase();
+        const normalizedPath = this.normalizePath(path);
+        for (const route of routes) {
+            if (route.method !== normalizedMethod) {
+                continue;
+            }
+            const match = normalizedPath.match(route.regex);
+            if (match) {
+                const params = {};
+                route.paramKeys.forEach((key, index) => {
+                    params[key] = match[index + 1];
+                });
+                return {
+                    route,
+                    params
+                };
+            }
+        }
+        return null;
+    }
+    normalizePath(path) {
+        return path.replace(/\/+/g, '/') || '/';
+    }
+}
+exports.RouteMatcher = RouteMatcher;
+//# sourceMappingURL=RouteMatcher.js.map

package/dist/RouteMatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteMatcher.js","sourceRoot":"","sources":["../src/RouteMatcher.ts"],"names":[],"mappings":";;;AACA,mDAAgD;AAEhD,MAAa,YAAY;IACd,KAAK,CAAC,MAAc,EAAE,IAAY;QACrC,MAAM,MAAM,GAAG,6BAAa,CAAC,WAAW,EAAE,CAAC,SAAS,EAAE,CAAC;QACvD,MAAM,gBAAgB,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QAC9C,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAEhD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACzB,IAAI,KAAK,CAAC,MAAM,KAAK,gBAAgB,EAAE,CAAC;gBACpC,SAAS;YACb,CAAC;YAED,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAChD,IAAI,KAAK,EAAE,CAAC;gBACR,MAAM,MAAM,GAA2B,EAAE,CAAC;gBAC1C,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;oBACnC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;gBACnC,CAAC,CAAC,CAAC;gBAEH,OAAO;oBACH,KAAK;oBACL,MAAM;iBACT,CAAC;YACN,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC;IAChB,CAAC;IAEO,aAAa,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC;IAC5C,CAAC;CACJ;AA/BD,oCA+BC"}

package/dist/RouteRegistry.d.ts

@@ -0,0 +1,22 @@
+import { RouteHandler } from './types';
+import { RouteEntry } from './RouteEntry';
+export declare class RouteRegistry {
+    private static instance;
+    private routes;
+    private groupStack;
+    private middlewareStack;
+    private models;
+    private constructor();
+    static getInstance(): RouteRegistry;
+    model(key: string, resolver: any): void;
+    getModels(): Map<string, any>;
+    addRoute(method: string, path: string, handler: RouteHandler): RouteEntry;
+    group(options: string | {
+        prefix?: string;
+        middleware?: any | any[];
+    }, callback: () => void): void;
+    getRoutes(): RouteEntry[];
+    clear(): void;
+    private normalizePath;
+}
+//# sourceMappingURL=RouteRegistry.d.ts.map

package/dist/RouteRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteRegistry.d.ts","sourceRoot":"","sources":["../src/RouteRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,qBAAa,aAAa;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgB;IACvC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,eAAe,CAAe;IACtC,OAAO,CAAC,MAAM,CAA+B;IAE7C,OAAO;WAEO,WAAW,IAAI,aAAa;IAOnC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,IAAI;IAIvC,SAAS,IAAI,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC;IAI7B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,UAAU;IAiBzE,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,GAAG,GAAG,GAAG,EAAE,CAAA;KAAE,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAkBlG,SAAS,IAAI,UAAU,EAAE;IAIzB,KAAK,IAAI,IAAI;IAMpB,OAAO,CAAC,aAAa;CAIxB"}

package/dist/RouteRegistry.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RouteRegistry = void 0;
+const RouteEntry_1 = require("./RouteEntry");
+class RouteRegistry {
+    constructor() {
+        this.routes = [];
+        this.groupStack = [];
+        this.middlewareStack = [];
+        this.models = new Map();
+    }
+    static getInstance() {
+        if (!RouteRegistry.instance) {
+            RouteRegistry.instance = new RouteRegistry();
+        }
+        return RouteRegistry.instance;
+    }
+    model(key, resolver) {
+        this.models.set(key, resolver);
+    }
+    getModels() {
+        return this.models;
+    }
+    addRoute(method, path, handler) {
+        const prefix = this.groupStack.join('');
+        const fullPath = this.normalizePath(prefix + '/' + path);
+        const groupMiddleware = this.middlewareStack.flat();
+        const route = new RouteEntry_1.RouteEntry(method, fullPath, handler, prefix || undefined, groupMiddleware);
+        this.routes.push(route);
+        return route;
+    }
+    group(options, callback) {
+        let prefix = typeof options === 'string' ? options : options.prefix || '';
+        if (prefix && !prefix.startsWith('/')) {
+            prefix = '/' + prefix;
+        }
+        const middleware = typeof options === 'string' ? [] : (Array.isArray(options.middleware) ? options.middleware : (options.middleware ? [options.middleware] : []));
+        this.groupStack.push(prefix);
+        this.middlewareStack.push(middleware);
+        callback();
+        this.middlewareStack.pop();
+        this.groupStack.pop();
+    }
+    getRoutes() {
+        return this.routes;
+    }
+    clear() {
+        this.routes = [];
+        this.groupStack = [];
+        this.middlewareStack = [];
+    }
+    normalizePath(path) {
+        const normalized = path.replace(/\/+/g, '/');
+        return normalized.startsWith('/') ? normalized : '/' + normalized;
+    }
+}
+exports.RouteRegistry = RouteRegistry;
+//# sourceMappingURL=RouteRegistry.js.map

package/dist/RouteRegistry.js.map

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

package/dist/Router.d.ts

@@ -0,0 +1,44 @@
+import { Request, Response } from '@arikajs/http';
+import { MatchedRoute, Container } from './types';
+export declare class Router {
+    private matcher;
+    private dispatcher;
+    private cache;
+    constructor(container?: Container);
+    /**
+     * Sync models from the static registry.
+     */
+    private syncModels;
+    /**
+     * Set the container for the dispatcher.
+     */
+    setContainer(container: Container): this;
+    /**
+     * Set the middleware groups.
+     */
+    setMiddlewareGroups(groups: Record<string, any[]>): this;
+    /**
+     * Set the route middleware aliases.
+     */
+    setRouteMiddleware(middleware: Record<string, any>): this;
+    /**
+     * Register a route model binding.
+     */
+    model(key: string, resolver: ((value: any) => Promise<any>) | {
+        findOrFail: (id: any) => Promise<any>;
+    }): this;
+    /**
+     * Match a request to a route.
+     */
+    match(method: string, path: string): MatchedRoute | null;
+    /**
+     * Clear the route cache.
+     */
+    clearCache(): void;
+    /**
+     * Dispatch the request to the matching route and return the result.
+     * Note: This does not wrap the result in a Response object.
+     */
+    dispatch(request: Request, response: Response): Promise<any>;
+}
+//# sourceMappingURL=Router.d.ts.map

package/dist/Router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Router.d.ts","sourceRoot":"","sources":["../src/Router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGlD,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGlD,qBAAa,MAAM;IACf,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,KAAK,CAA+C;gBAEhD,SAAS,CAAC,EAAE,SAAS;IAKjC;;OAEG;IACH,OAAO,CAAC,UAAU;IAOlB;;OAEG;IACI,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAK/C;;OAEG;IACI,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,IAAI;IAK/D;;OAEG;IACI,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAKhE;;OAEG;IACI,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG;QAAE,UAAU,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;KAAE,GAAG,IAAI;IAKrH;;OAEG;IACI,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAa/D;;OAEG;IACI,UAAU,IAAI,IAAI;IAIzB;;;OAGG;IACU,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC;CAU5E"}

package/dist/Router.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Router = void 0;
+const RouteMatcher_1 = require("./RouteMatcher");
+const dispatcher_1 = require("@arikajs/dispatcher");
+const RouteRegistry_1 = require("./RouteRegistry");
+class Router {
+    constructor(container) {
+        this.cache = new Map();
+        this.matcher = new RouteMatcher_1.RouteMatcher();
+        this.dispatcher = new dispatcher_1.Dispatcher(container);
+    }
+    /**
+     * Sync models from the static registry.
+     */
+    syncModels() {
+        const models = RouteRegistry_1.RouteRegistry.getInstance().getModels();
+        for (const [key, resolver] of models.entries()) {
+            this.dispatcher.bind(key, resolver);
+        }
+    }
+    /**
+     * Set the container for the dispatcher.
+     */
+    setContainer(container) {
+        this.dispatcher.setContainer(container);
+        return this;
+    }
+    /**
+     * Set the middleware groups.
+     */
+    setMiddlewareGroups(groups) {
+        this.dispatcher.setMiddlewareGroups(groups);
+        return this;
+    }
+    /**
+     * Set the route middleware aliases.
+     */
+    setRouteMiddleware(middleware) {
+        this.dispatcher.setRouteMiddleware(middleware);
+        return this;
+    }
+    /**
+     * Register a route model binding.
+     */
+    model(key, resolver) {
+        this.dispatcher.bind(key, resolver);
+        return this;
+    }
+    /**
+     * Match a request to a route.
+     */
+    match(method, path) {
+        const cacheKey = `${method.toUpperCase()}:${path}`;
+        if (this.cache.has(cacheKey)) {
+            return this.cache.get(cacheKey);
+        }
+        const matched = this.matcher.match(method, path);
+        this.cache.set(cacheKey, matched);
+        return matched;
+    }
+    /**
+     * Clear the route cache.
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * Dispatch the request to the matching route and return the result.
+     * Note: This does not wrap the result in a Response object.
+     */
+    async dispatch(request, response) {
+        this.syncModels();
+        const matched = this.match(request.method(), request.path());
+        if (!matched) {
+            return null;
+        }
+        return await this.dispatcher.dispatch(matched, request, response);
+    }
+}
+exports.Router = Router;
+//# sourceMappingURL=Router.js.map

package/dist/Router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Router.js","sourceRoot":"","sources":["../src/Router.ts"],"names":[],"mappings":";;;AACA,iDAA8C;AAC9C,oDAAiD;AAEjD,mDAAgD;AAEhD,MAAa,MAAM;IAKf,YAAY,SAAqB;QAFzB,UAAK,GAAqC,IAAI,GAAG,EAAE,CAAC;QAGxD,IAAI,CAAC,OAAO,GAAG,IAAI,2BAAY,EAAE,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,IAAI,uBAAU,CAAC,SAAS,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACK,UAAU;QACd,MAAM,MAAM,GAAG,6BAAa,CAAC,WAAW,EAAE,CAAC,SAAS,EAAE,CAAC;QACvD,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;YAC7C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACxC,CAAC;IACL,CAAC;IAED;;OAEG;IACI,YAAY,CAAC,SAAoB;QACpC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACI,mBAAmB,CAAC,MAA6B;QACpD,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACI,kBAAkB,CAAC,UAA+B;QACrD,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,GAAW,EAAE,QAAoF;QAC1G,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,MAAc,EAAE,IAAY;QACrC,MAAM,QAAQ,GAAG,GAAG,MAAM,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC;QAEnD,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC;QACrC,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAElC,OAAO,OAAO,CAAC;IACnB,CAAC;IAED;;OAEG;IACI,UAAU;QACb,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,QAAQ,CAAC,OAAgB,EAAE,QAAkB;QACtD,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAE7D,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,OAAO,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IACtE,CAAC;CACJ;AAzFD,wBAyFC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './Route';
+export * from './RouteEntry';
+export * from './Router';
+export * from './RouteMatcher';
+export * from './RouteRegistry';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Route"), exports);
+__exportStar(require("./RouteEntry"), exports);
+__exportStar(require("./Router"), exports);
+__exportStar(require("./RouteMatcher"), exports);
+__exportStar(require("./RouteRegistry"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,+CAA6B;AAC7B,2CAAyB;AACzB,iDAA+B;AAC/B,kDAAgC;AAChC,0CAAwB"}

package/dist/tests/Router.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Router.test.d.ts.map

package/dist/tests/Router.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Router.test.d.ts","sourceRoot":"","sources":["../../src/tests/Router.test.ts"],"names":[],"mappings":""}

package/dist/tests/Router.test.js

@@ -0,0 +1,137 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const node_assert_1 = __importDefault(require("node:assert"));
+const index_1 = require("../index");
+(0, node_test_1.test)('Router can register and match routes', async (t) => {
+    index_1.RouteRegistry.getInstance().clear();
+    index_1.Route.get('/hello', () => 'world');
+    const router = new index_1.Router();
+    const matched = router.match('GET', '/hello');
+    node_assert_1.default.ok(matched);
+    node_assert_1.default.strictEqual(matched.route.path, '/hello');
+    node_assert_1.default.strictEqual(matched.route.method, 'GET');
+});
+(0, node_test_1.test)('Router can handle groups with prefixes', async (t) => {
+    index_1.RouteRegistry.getInstance().clear();
+    index_1.Route.group('/api', () => {
+        index_1.Route.get('/users', () => 'users');
+    });
+    const router = new index_1.Router();
+    const matched = router.match('GET', '/api/users');
+    node_assert_1.default.ok(matched);
+    node_assert_1.default.strictEqual(matched.route.path, '/api/users');
+});
+(0, node_test_1.test)('Router supports nested groups', async (t) => {
+    index_1.RouteRegistry.getInstance().clear();
+    index_1.Route.group('/admin', () => {
+        index_1.Route.group('/users', () => {
+            index_1.Route.get('/list', () => 'admin-users-list');
+        });
+    });
+    const router = new index_1.Router();
+    const matched = router.match('GET', '/admin/users/list');
+    node_assert_1.default.ok(matched);
+    node_assert_1.default.strictEqual(matched.route.path, '/admin/users/list');
+});
+(0, node_test_1.test)('Router can extract route parameters', async (t) => {
+    index_1.RouteRegistry.getInstance().clear();
+    index_1.Route.get('/users/:id', (request, id) => id);
+    const router = new index_1.Router();
+    const matched = router.match('GET', '/users/123');
+    node_assert_1.default.ok(matched);
+    node_assert_1.default.strictEqual(matched.params.id, '123');
+    // Mock request
+    const mockRequest = {
+        method: () => 'GET',
+        path: () => '/users/123'
+    };
+    const mockResponse = {};
+    const result = await router.dispatch(mockRequest, mockResponse);
+    node_assert_1.default.strictEqual(result, '123');
+});
+(0, node_test_1.test)('Router supports group middleware', async (t) => {
+    index_1.RouteRegistry.getInstance().clear();
+    const middleware1 = () => { };
+    const middleware2 = () => { };
+    index_1.Route.group({ prefix: '/api', middleware: [middleware1] }, () => {
+        index_1.Route.get('/users', () => 'users').withMiddleware(middleware2);
+    });
+    const router = new index_1.Router();
+    const matched = router.match('GET', '/api/users');
+    node_assert_1.default.ok(matched);
+    node_assert_1.default.strictEqual(matched.route.middleware.length, 2);
+    node_assert_1.default.strictEqual(matched.route.middleware[0], middleware1);
+    node_assert_1.default.strictEqual(matched.route.middleware[1], middleware2);
+});
+(0, node_test_1.test)('Router supports fluent chaining', async (t) => {
+    index_1.RouteRegistry.getInstance().clear();
+    const route = index_1.Route.get('/fluent', () => 'ok')
+        .as('fluent.route')
+        .withMiddleware('some-middleware');
+    node_assert_1.default.strictEqual(route.name, 'fluent.route');
+    node_assert_1.default.strictEqual(route.middleware[0], 'some-middleware');
+});
+(0, node_test_1.test)('Router can dispatch routes', async (t) => {
+    index_1.RouteRegistry.getInstance().clear();
+    index_1.Route.get('/hello', () => 'world');
+    const router = new index_1.Router();
+    // Mock request
+    const mockRequest = {
+        method: () => 'GET',
+        path: () => '/hello'
+    };
+    const mockResponse = {};
+    const result = await router.dispatch(mockRequest, mockResponse);
+    node_assert_1.default.strictEqual(result, 'world');
+});
+(0, node_test_1.test)('Router returns null if no match', async (t) => {
+    index_1.RouteRegistry.getInstance().clear();
+    index_1.Route.get('/hello', () => 'world');
+    const router = new index_1.Router();
+    const mockRequest = {
+        method: () => 'GET',
+        path: () => '/not-found'
+    };
+    const mockResponse = {};
+    const result = await router.dispatch(mockRequest, mockResponse);
+    node_assert_1.default.strictEqual(result, null);
+});
+(0, node_test_1.test)('Router caches match results', async (t) => {
+    index_1.RouteRegistry.getInstance().clear();
+    index_1.Route.get('/cache-test', () => 'ok');
+    let matchCount = 0;
+    const router = new index_1.Router();
+    // Patch the matcher to track calls
+    const matcher = router.matcher;
+    const originalMatch = matcher.match;
+    matcher.match = (...args) => {
+        matchCount++;
+        return originalMatch.apply(matcher, args);
+    };
+    router.match('GET', '/cache-test');
+    router.match('GET', '/cache-test');
+    const result = router.match('GET', '/cache-test');
+    node_assert_1.default.ok(result);
+    node_assert_1.default.strictEqual(matchCount, 1, 'Matcher should only be called once due to caching');
+});
+(0, node_test_1.test)('Router can clear cache', async (t) => {
+    index_1.RouteRegistry.getInstance().clear();
+    index_1.Route.get('/cache-test', () => 'ok');
+    let matchCount = 0;
+    const router = new index_1.Router();
+    const matcher = router.matcher;
+    const originalMatch = matcher.match;
+    matcher.match = (...args) => {
+        matchCount++;
+        return originalMatch.apply(matcher, args);
+    };
+    router.match('GET', '/cache-test');
+    router.clearCache();
+    router.match('GET', '/cache-test');
+    node_assert_1.default.strictEqual(matchCount, 2, 'Matcher should be called twice because cache was cleared');
+});
+//# sourceMappingURL=Router.test.js.map

package/dist/tests/Router.test.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,19 @@
+export type RouteHandler = any;
+export interface RouteDefinition {
+    method: string;
+    path: string;
+    handler: RouteHandler;
+    name?: string;
+    prefix?: string;
+    middleware: any[];
+    regex?: RegExp;
+    paramKeys?: string[];
+}
+export interface MatchedRoute {
+    route: RouteDefinition;
+    params: Record<string, string>;
+}
+export interface Container {
+    make<T>(token: any): T;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,GAAG,CAAC;AAE/B,MAAM,WAAW,eAAe;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,GAAG,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE,eAAe,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,SAAS;IACtB,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC;CAC1B"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,47 @@
+{
+    "name": "@arikajs/router",
+    "version": "0.0.1",
+    "description": "Routing and request-dispatching layer of the ArikaJS framework.",
+    "license": "MIT",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "scripts": {
+        "build": "tsc -p tsconfig.json",
+        "clean": "rm -rf dist",
+        "prepare": "echo skip",
+        "lint": "eslint src --ext .ts",
+        "test": "npx tsx --test tests/**/*.test.ts",
+        "test:watch": "npx tsx --test --watch tests/**/*.test.ts"
+    },
+    "files": [
+        "dist"
+    ],
+    "keywords": [
+        "arika",
+        "arika-js",
+        "framework",
+        "router",
+        "routing",
+        "dispatcher"
+    ],
+    "engines": {
+        "node": ">=20.0.0"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/arikajs/router.git"
+    },
+    "bugs": {
+        "url": "https://github.com/arikajs/router/issues"
+    },
+    "homepage": "https://github.com/arikajs/router#readme",
+    "dependencies": {
+        "@arikajs/http": "^0.0.1",
+        "@arikajs/dispatcher": "^0.0.1"
+    },
+    "devDependencies": {
+        "@types/node": "^20.11.24",
+        "typescript": "^5.3.3"
+    },
+    "author": "Prakash Tank"
+}