@rudderjs/router 0.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Suleiman Shahbari
+
+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,220 @@
+# @rudderjs/router
+
+Decorator-based and fluent HTTP router for RudderJS. Supports named routes, URL generation, signed URLs, route-level middleware, and controller registration.
+
+## Installation
+
+```bash
+pnpm add @rudderjs/router
+```
+
+---
+
+## Fluent routing
+
+```ts
+import { router } from '@rudderjs/router'
+
+router.get('/api/health', (_req, res) => res.json({ status: 'ok' }))
+router.post('/api/users', async (req, res) => { /* ... */ })
+router.delete('/api/users/:id', async (req, res) => { /* ... */ })
+
+// Catch-all (matches any HTTP method)
+router.all('/api/*', (_req, res) => res.status(404).json({ message: 'Not found' }))
+```
+
+`router` is the global singleton. `Route` is an alias for it.
+
+---
+
+## Named routes
+
+Chain `.name()` on any fluent route registration to assign a name:
+
+```ts
+router.get('/users/:id', handler).name('users.show')
+router.post('/users', handler).name('users.store')
+router.get('/invoices/:id/download', handler, [ValidateSignature()]).name('invoice.download')
+```
+
+---
+
+## `route()` — URL generation
+
+Generate a URL from a named route. Route parameters are substituted; unused params are appended as a query string.
+
+```ts
+import { route } from '@rudderjs/router'
+
+route('users.show', { id: 42 })             // '/users/42'
+route('search', { q: 'hello', page: 2 })    // '/search?q=hello&page=2'
+route('users.list')                          // '/users'
+```
+
+Optional parameters (`:id?`) are omitted when not provided:
+
+```ts
+// route defined as '/posts/:category?/:slug'
+route('posts.show', { slug: 'hello' })  // '/posts/hello'
+```
+
+Throws if a required parameter is missing or the named route is not defined.
+
+---
+
+## `Url` — signed URLs
+
+Signed URLs include an HMAC-SHA256 `signature` parameter. The signing key is read from `APP_KEY` in your environment, or set explicitly with `Url.setKey()`.
+
+```ts
+import { Url } from '@rudderjs/router'
+
+// Sign a named route
+Url.signedRoute('invoice.download', { id: 42 })
+// → '/invoice/42?signature=abc123...'
+
+// Sign with an expiry (seconds from now)
+Url.temporarySignedRoute('invoice.download', 3600, { id: 42 })
+// → '/invoice/42?expires=1234567890&signature=abc123...'
+
+// Sign an arbitrary path
+Url.sign('/some/path?foo=bar')
+
+// Validate a request's signature
+Url.isValidSignature(req)   // → boolean
+
+// Current URL and referer helpers
+Url.current(req)            // → req.url
+Url.previous(req, '/')      // → Referer header or fallback
+
+// Override the signing key (e.g. in tests)
+Url.setKey('my-secret-key')
+```
+
+---
+
+## `ValidateSignature()` middleware
+
+Rejects requests with a missing, invalid, or expired URL signature with `403`.
+
+```ts
+import { ValidateSignature } from '@rudderjs/router'
+
+router.get('/invoice/:id/download', handler, [ValidateSignature()])
+  .name('invoice.download')
+```
+
+---
+
+## Decorator-based routing
+
+```ts
+import { Controller, Get, Post, Delete, Middleware, router } from '@rudderjs/router'
+import type { AppRequest, AppResponse } from '@rudderjs/contracts'
+
+@Controller('/api/users')
+@Middleware([authMiddleware])       // applies to all routes in this controller
+class UserController {
+  @Get('/')
+  index(_req: AppRequest, res: AppResponse) {
+    return res.json({ data: [] })
+  }
+
+  @Post('/')
+  async create(req: AppRequest, res: AppResponse) {
+    return res.status(201).json({ data: req.body })
+  }
+
+  @Delete('/:id')
+  @Middleware([adminMiddleware])    // additional middleware for this route only
+  async destroy(req: AppRequest, res: AppResponse) {
+    return res.status(204).send('')
+  }
+}
+
+router.registerController(UserController)
+```
+
+---
+
+## Route-level middleware (fluent)
+
+```ts
+router.get('/protected', handler, [authMiddleware])
+router.post('/admin', handler, [authMiddleware, adminMiddleware])
+```
+
+---
+
+## Mounting onto a server adapter
+
+```ts
+// bootstrap/app.ts — called automatically by Application.configure()
+router.mount(serverAdapter)
+```
+
+---
+
+## API Reference
+
+### `Router`
+
+| Method | Returns | Description |
+|--------|---------|-------------|
+| `get(path, handler, mw?)` | `RouteBuilder` | Register GET route |
+| `post(path, handler, mw?)` | `RouteBuilder` | Register POST route |
+| `put(path, handler, mw?)` | `RouteBuilder` | Register PUT route |
+| `patch(path, handler, mw?)` | `RouteBuilder` | Register PATCH route |
+| `delete(path, handler, mw?)` | `RouteBuilder` | Register DELETE route |
+| `all(path, handler, mw?)` | `RouteBuilder` | Register route matching any method |
+| `add(method, path, handler, mw?)` | `this` | Register route with explicit method |
+| `use(middleware)` | `this` | Register global middleware |
+| `registerController(Class)` | `this` | Register decorator-based controller |
+| `mount(serverAdapter)` | `void` | Apply middleware + routes to adapter |
+| `list()` | `RouteDefinition[]` | All registered routes |
+| `listNamed()` | `Record<string, string>` | All named routes |
+| `getNamedRoute(name)` | `string \| undefined` | Path for a named route |
+| `reset()` | `this` | Clear routes, middleware, and named routes |
+
+### `RouteBuilder`
+
+Returned by the shorthand route methods. Allows naming the registered route.
+
+| Method | Description |
+|--------|-------------|
+| `.name(n)` | Assign a name to the route |
+
+### `Url`
+
+| Method | Description |
+|--------|-------------|
+| `Url.setKey(key)` | Override the HMAC signing key |
+| `Url.current(req)` | Full URL of the request |
+| `Url.previous(req, fallback?)` | Referer header or fallback |
+| `Url.signedRoute(name, params?, expiresAt?)` | Signed URL for a named route |
+| `Url.temporarySignedRoute(name, seconds, params?)` | Expiring signed URL |
+| `Url.sign(path, expiresAt?)` | Sign an arbitrary path |
+| `Url.isValidSignature(req)` | Validate request signature |
+
+### Decorators
+
+| Decorator | Target | Description |
+|-----------|--------|-------------|
+| `@Controller(prefix?)` | class | Marks class as a controller with a route prefix |
+| `@Middleware([...handlers])` | class or method | Applies middleware handlers |
+| `@Get(path)` | method | GET route |
+| `@Post(path)` | method | POST route |
+| `@Put(path)` | method | PUT route |
+| `@Patch(path)` | method | PATCH route |
+| `@Delete(path)` | method | DELETE route |
+| `@Options(path)` | method | OPTIONS route |
+
+---
+
+## Notes
+
+- `router` and `Route` are the same global singleton
+- Decorator controllers require `reflect-metadata` at the app entry point
+- Double slashes in composed paths are normalised automatically
+- Signed URLs use HMAC-SHA256 with timing-safe comparison to prevent timing attacks
+- `APP_KEY` must be set (or `Url.setKey()` called) before using signed URLs

package/dist/index.d.ts

@@ -0,0 +1,116 @@
+import 'reflect-metadata';
+import type { ServerAdapter, RouteDefinition, RouteHandler, MiddlewareHandler, HttpMethod, AppRequest } from '@rudderjs/contracts';
+/** Mark a class as a controller with an optional route prefix */
+export declare function Controller(prefix?: string): ClassDecorator;
+/** Attach middleware to a controller class or route method */
+export declare function Middleware(middleware: MiddlewareHandler[]): ClassDecorator & MethodDecorator;
+export declare const Get: (path?: string) => MethodDecorator;
+export declare const Post: (path?: string) => MethodDecorator;
+export declare const Put: (path?: string) => MethodDecorator;
+export declare const Patch: (path?: string) => MethodDecorator;
+export declare const Delete: (path?: string) => MethodDecorator;
+export declare const Options: (path?: string) => MethodDecorator;
+/**
+ * Returned by `router.get/post/etc` — allows naming the registered route.
+ *
+ * @example
+ * router.get('/users/:id', handler).name('users.show')
+ * route('users.show', { id: 1 })  // → '/users/1'
+ */
+export declare class RouteBuilder {
+    private readonly definition;
+    private readonly _router;
+    constructor(definition: RouteDefinition, _router: Router);
+    /** Assign a name to this route for use with `route()` and `Url.signedRoute()`. */
+    name(n: string): this;
+}
+export declare class Router {
+    private routes;
+    private globalMiddleware;
+    private namedRoutes;
+    /** @internal — called by RouteBuilder */
+    _registerName(name: string, path: string): void;
+    /** Look up a named route's path. */
+    getNamedRoute(name: string): string | undefined;
+    /** All registered named routes. */
+    listNamed(): Record<string, string>;
+    /** Clear registered routes, middleware, and named routes. */
+    reset(): this;
+    /** Register a global middleware (runs on every route). */
+    use(middleware: MiddlewareHandler): this;
+    /** Manually register a route. Returns `this` for bulk registration. */
+    add(method: HttpMethod, path: string, handler: RouteHandler, middleware?: MiddlewareHandler[]): this;
+    get(path: string, handler: RouteHandler, middleware?: MiddlewareHandler[]): RouteBuilder;
+    post(path: string, handler: RouteHandler, middleware?: MiddlewareHandler[]): RouteBuilder;
+    put(path: string, handler: RouteHandler, middleware?: MiddlewareHandler[]): RouteBuilder;
+    patch(path: string, handler: RouteHandler, middleware?: MiddlewareHandler[]): RouteBuilder;
+    delete(path: string, handler: RouteHandler, middleware?: MiddlewareHandler[]): RouteBuilder;
+    all(path: string, handler: RouteHandler, middleware?: MiddlewareHandler[]): RouteBuilder;
+    private _rb;
+    /** Register all routes from a decorator-based controller class. */
+    registerController(ControllerClass: new () => object): this;
+    /** Mount all routes onto a server adapter. */
+    mount(server: ServerAdapter): void;
+    /** All registered routes — useful for `routes:list`. */
+    list(): RouteDefinition[];
+}
+export declare const router: Router;
+/** Alias for router — Laravel-style capitalised name */
+export declare const Route: Router;
+/**
+ * Generate a URL from a named route.
+ *
+ * - Route parameters (`:id`) are substituted from `params`.
+ * - Optional parameters (`:id?`) are omitted when not provided.
+ * - Unused params are appended as a query string.
+ *
+ * @example
+ * route('users.show', { id: 42 })           // '/users/42'
+ * route('search', { q: 'hello', page: 2 })  // '/search?q=hello&page=2'
+ */
+export declare function route(name: string, params?: Record<string, string | number>): string;
+export declare class Url {
+    /**
+     * Override the HMAC signing key used for signed URLs.
+     * Falls back to `process.env.APP_KEY`.
+     */
+    static setKey(key: string): void;
+    /** The full URL of the current request. */
+    static current(req: AppRequest): string;
+    /** The previous URL from the `Referer` header, or `fallback`. */
+    static previous(req: AppRequest, fallback?: string): string;
+    /**
+     * Generate a signed URL for a named route.
+     *
+     * @example
+     * Url.signedRoute('invoice.download', { id: 42 })
+     * // → '/invoice/42?signature=abc123'
+     */
+    static signedRoute(name: string, params?: Record<string, string | number>, expiresAt?: Date): string;
+    /**
+     * Generate a signed URL that expires after `seconds` seconds.
+     *
+     * @example
+     * Url.temporarySignedRoute('invoice.download', 3600, { id: 42 })
+     * // → '/invoice/42?expires=1234567890&signature=abc123'
+     */
+    static temporarySignedRoute(name: string, seconds: number, params?: Record<string, string | number>): string;
+    /**
+     * Sign an arbitrary path string.
+     * Appends `?signature=...` (and `?expires=...` if `expiresAt` given).
+     */
+    static sign(path: string, expiresAt?: Date): string;
+    /**
+     * Return `true` if the request has a valid (and non-expired) signature.
+     */
+    static isValidSignature(req: AppRequest): boolean;
+}
+/**
+ * Middleware that verifies a signed URL signature.
+ * Responds with 403 if the signature is missing, invalid, or expired.
+ *
+ * @example
+ * router.get('/invoice/:id/download', handler, [ValidateSignature()])
+ */
+export declare function ValidateSignature(): MiddlewareHandler;
+//# 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,OAAO,kBAAkB,CAAA;AAUzB,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,UAAU,EACV,UAAU,EACX,MAAM,qBAAqB,CAAA;AAoB5B,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,MAAM,SAAK,GAAG,cAAc,CAItD;AAED,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,cAAc,GAAG,eAAe,CAmB5F;AAiBD,eAAO,MAAM,GAAG,qBAbO,eAa4B,CAAA;AACnD,eAAO,MAAM,IAAI,qBAdM,eAc6B,CAAA;AACpD,eAAO,MAAM,GAAG,qBAfO,eAe4B,CAAA;AACnD,eAAO,MAAM,KAAK,qBAhBK,eAgB8B,CAAA;AACrD,eAAO,MAAM,MAAM,qBAjBI,eAiB+B,CAAA;AACtD,eAAO,MAAM,OAAO,qBAlBG,eAkBgC,CAAA;AAIvD;;;;;;GAMG;AACH,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,UAAU,EAAE,eAAe,EAC3B,OAAO,EAAE,MAAM;IAGlC,kFAAkF;IAClF,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;CAItB;AAID,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,gBAAgB,CAA0B;IAClD,OAAO,CAAC,WAAW,CAA4B;IAE/C,yCAAyC;IACzC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAI/C,oCAAoC;IACpC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI/C,mCAAmC;IACnC,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAInC,6DAA6D;IAC7D,KAAK,IAAI,IAAI;IAOb,0DAA0D;IAC1D,GAAG,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI;IAKxC,uEAAuE;IACvE,GAAG,CACD,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,EACrB,UAAU,GAAE,iBAAiB,EAAO,GACnC,IAAI;IAOP,GAAG,CAAI,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,iBAAiB,EAAE,GAAG,YAAY;IAC3F,IAAI,CAAG,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,iBAAiB,EAAE,GAAG,YAAY;IAC3F,GAAG,CAAI,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,iBAAiB,EAAE,GAAG,YAAY;IAC3F,KAAK,CAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,iBAAiB,EAAE,GAAG,YAAY;IAC3F,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,iBAAiB,EAAE,GAAG,YAAY;IAC3F,GAAG,CAAI,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,iBAAiB,EAAE,GAAG,YAAY;IAE3F,OAAO,CAAC,GAAG;IAMX,mEAAmE;IACnE,kBAAkB,CAAC,eAAe,EAAE,UAAU,MAAM,GAAG,IAAI;IAsB3D,8CAA8C;IAC9C,KAAK,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAKlC,wDAAwD;IACxD,IAAI,IAAI,eAAe,EAAE;CAG1B;AAID,eAAO,MAAM,MAAM,QAAe,CAAA;AAElC,wDAAwD;AACxD,eAAO,MAAM,KAAK,QAAS,CAAA;AAI3B;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAM,GAAG,MAAM,CA0BxF;AA6BD,qBAAa,GAAG;IACd;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIhC,2CAA2C;IAC3C,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM;IAIvC,iEAAiE;IACjE,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,SAAM,GAAG,MAAM;IAIxD;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,CAChB,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAM,EAC5C,SAAS,CAAC,EAAE,IAAI,GACf,MAAM;IAIT;;;;;;OAMG;IACH,MAAM,CAAC,oBAAoB,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAM,GAC3C,MAAM;IAIT;;;OAGG;IACH,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM;IAcnD;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO;CAuBlD;AAID;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,iBAAiB,CAOrD"}

package/dist/index.js

@@ -0,0 +1,311 @@
+import 'reflect-metadata';
+// Lazy-load node:crypto to avoid bundling it into the client.
+// Only used by Url (signed URLs) and ValidateSignature — server-only features.
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let _crypto;
+// Fire-and-forget: preload on server, no-op in browser
+if (typeof globalThis.process !== 'undefined') {
+    import(/* @vite-ignore */ 'node:crypto').then(m => { _crypto = m; }).catch(() => { });
+}
+// ─── Metadata Keys ─────────────────────────────────────────
+const CONTROLLER_PREFIX = 'rudderjs:controller:prefix';
+const CONTROLLER_MIDDLEWARE = 'rudderjs:controller:middleware';
+const ROUTE_DEFINITIONS = 'rudderjs:route:definitions';
+const ROUTE_MIDDLEWARE = 'rudderjs:route:middleware';
+// ─── Decorators ────────────────────────────────────────────
+/** Mark a class as a controller with an optional route prefix */
+export function Controller(prefix = '') {
+    return target => {
+        Reflect.defineMetadata(CONTROLLER_PREFIX, prefix, target);
+    };
+}
+/** Attach middleware to a controller class or route method */
+export function Middleware(middleware) {
+    return (target, key) => {
+        if (key) {
+            // Method-level middleware (supports both decorator orders)
+            const perHandler = Reflect.getMetadata(ROUTE_MIDDLEWARE, target) ?? {};
+            const handlerKey = String(key);
+            perHandler[handlerKey] = [...(perHandler[handlerKey] ?? []), ...middleware];
+            Reflect.defineMetadata(ROUTE_MIDDLEWARE, perHandler, target);
+            // If route metadata already exists, merge immediately too.
+            const routes = Reflect.getMetadata(ROUTE_DEFINITIONS, target) ?? [];
+            const route = routes.find(r => r.handlerKey === key);
+            if (route)
+                route.middleware = [...middleware, ...route.middleware];
+        }
+        else {
+            // Class-level middleware
+            Reflect.defineMetadata(CONTROLLER_MIDDLEWARE, middleware, target);
+        }
+    };
+}
+/** Create an HTTP method decorator */
+function createMethodDecorator(method) {
+    return (path = '/') => (target, key) => {
+        const perHandler = Reflect.getMetadata(ROUTE_MIDDLEWARE, target) ?? {};
+        const handlerMiddleware = perHandler[String(key)] ?? [];
+        const routes = Reflect.getMetadata(ROUTE_DEFINITIONS, target) ?? [];
+        routes.push({ method, path, handlerKey: key, middleware: [...handlerMiddleware] });
+        Reflect.defineMetadata(ROUTE_DEFINITIONS, routes, target);
+    };
+}
+export const Get = createMethodDecorator('GET');
+export const Post = createMethodDecorator('POST');
+export const Put = createMethodDecorator('PUT');
+export const Patch = createMethodDecorator('PATCH');
+export const Delete = createMethodDecorator('DELETE');
+export const Options = createMethodDecorator('OPTIONS');
+// ─── RouteBuilder ──────────────────────────────────────────
+/**
+ * Returned by `router.get/post/etc` — allows naming the registered route.
+ *
+ * @example
+ * router.get('/users/:id', handler).name('users.show')
+ * route('users.show', { id: 1 })  // → '/users/1'
+ */
+export class RouteBuilder {
+    definition;
+    _router;
+    constructor(definition, _router) {
+        this.definition = definition;
+        this._router = _router;
+    }
+    /** Assign a name to this route for use with `route()` and `Url.signedRoute()`. */
+    name(n) {
+        this._router._registerName(n, this.definition.path);
+        return this;
+    }
+}
+// ─── Router ────────────────────────────────────────────────
+export class Router {
+    routes = [];
+    globalMiddleware = [];
+    namedRoutes = new Map();
+    /** @internal — called by RouteBuilder */
+    _registerName(name, path) {
+        this.namedRoutes.set(name, path);
+    }
+    /** Look up a named route's path. */
+    getNamedRoute(name) {
+        return this.namedRoutes.get(name);
+    }
+    /** All registered named routes. */
+    listNamed() {
+        return Object.fromEntries(this.namedRoutes);
+    }
+    /** Clear registered routes, middleware, and named routes. */
+    reset() {
+        this.routes = [];
+        this.globalMiddleware = [];
+        this.namedRoutes.clear();
+        return this;
+    }
+    /** Register a global middleware (runs on every route). */
+    use(middleware) {
+        this.globalMiddleware.push(middleware);
+        return this;
+    }
+    /** Manually register a route. Returns `this` for bulk registration. */
+    add(method, path, handler, middleware = []) {
+        this.routes.push({ method, path, handler, middleware });
+        return this;
+    }
+    // ── Shorthand methods — return RouteBuilder for .name() support ──
+    get(path, handler, middleware) { return this._rb('GET', path, handler, middleware); }
+    post(path, handler, middleware) { return this._rb('POST', path, handler, middleware); }
+    put(path, handler, middleware) { return this._rb('PUT', path, handler, middleware); }
+    patch(path, handler, middleware) { return this._rb('PATCH', path, handler, middleware); }
+    delete(path, handler, middleware) { return this._rb('DELETE', path, handler, middleware); }
+    all(path, handler, middleware) { return this._rb('ALL', path, handler, middleware); }
+    _rb(method, path, handler, middleware = []) {
+        const def = { method, path, handler, middleware };
+        this.routes.push(def);
+        return new RouteBuilder(def, this);
+    }
+    /** Register all routes from a decorator-based controller class. */
+    registerController(ControllerClass) {
+        const instance = new ControllerClass();
+        const prefix = Reflect.getMetadata(CONTROLLER_PREFIX, ControllerClass) ?? '';
+        const ctrlMw = Reflect.getMetadata(CONTROLLER_MIDDLEWARE, ControllerClass) ?? [];
+        const routes = Reflect.getMetadata(ROUTE_DEFINITIONS, ControllerClass.prototype) ?? [];
+        for (const route of routes) {
+            const fullPath = `${prefix}${route.path}`.replace(/\/+/g, '/');
+            const handler = instance[route.handlerKey].bind(instance);
+            this.routes.push({
+                method: route.method,
+                path: fullPath,
+                handler,
+                middleware: [...ctrlMw, ...route.middleware],
+            });
+        }
+        return this;
+    }
+    /** Mount all routes onto a server adapter. */
+    mount(server) {
+        for (const mw of this.globalMiddleware)
+            server.applyMiddleware(mw);
+        for (const route of this.routes)
+            server.registerRoute(route);
+    }
+    /** All registered routes — useful for `routes:list`. */
+    list() {
+        return [...this.routes];
+    }
+}
+// ─── Global router instance ────────────────────────────────
+export const router = new Router();
+/** Alias for router — Laravel-style capitalised name */
+export const Route = router;
+// ─── route() helper ────────────────────────────────────────
+/**
+ * Generate a URL from a named route.
+ *
+ * - Route parameters (`:id`) are substituted from `params`.
+ * - Optional parameters (`:id?`) are omitted when not provided.
+ * - Unused params are appended as a query string.
+ *
+ * @example
+ * route('users.show', { id: 42 })           // '/users/42'
+ * route('search', { q: 'hello', page: 2 })  // '/search?q=hello&page=2'
+ */
+export function route(name, params = {}) {
+    const path = router.getNamedRoute(name);
+    if (path === undefined)
+        throw new Error(`[RudderJS] Named route "${name}" is not defined.`);
+    const used = new Set();
+    let result = path.replace(/:([a-zA-Z_][a-zA-Z0-9_]*)(\?)?/g, (_match, key, optional) => {
+        if (key in params) {
+            used.add(key);
+            return String(params[key]);
+        }
+        if (optional)
+            return '';
+        throw new Error(`[RudderJS] Missing required parameter "${key}" for route "${name}".`);
+    });
+    // Remove duplicate slashes that may appear when optional params are omitted
+    result = result.replace(/\/+/g, '/').replace(/\/$/, '') || '/';
+    // Remaining params → query string
+    const unused = Object.entries(params).filter(([k]) => !used.has(k));
+    if (unused.length > 0) {
+        const qs = new URLSearchParams(unused.map(([k, v]) => [k, String(v)])).toString();
+        result += (result.includes('?') ? '&' : '?') + qs;
+    }
+    return result;
+}
+// ─── Url ───────────────────────────────────────────────────
+let _urlKey = '';
+function _getSigningKey() {
+    const key = _urlKey || process.env['APP_KEY'] || '';
+    if (!key)
+        throw new Error('[RudderJS] No signing key configured. Set APP_KEY in your .env or call Url.setKey().');
+    return key;
+}
+function _splitPath(path) {
+    const idx = path.indexOf('?');
+    return idx === -1 ? [path, ''] : [path.slice(0, idx), path.slice(idx + 1)];
+}
+function _computeSignature(pathname, params) {
+    // Sort params for deterministic signing (exclude 'signature' itself)
+    const sorted = new URLSearchParams([...params.entries()]
+        .filter(([k]) => k !== 'signature')
+        .sort(([a], [b]) => a.localeCompare(b)));
+    const toSign = sorted.size > 0 ? `${pathname}?${sorted.toString()}` : pathname;
+    if (!_crypto)
+        throw new Error('[RudderJS Router] node:crypto not available — Url signing requires a server environment.');
+    return _crypto.createHmac('sha256', _getSigningKey()).update(toSign).digest('hex');
+}
+export class Url {
+    /**
+     * Override the HMAC signing key used for signed URLs.
+     * Falls back to `process.env.APP_KEY`.
+     */
+    static setKey(key) {
+        _urlKey = key;
+    }
+    /** The full URL of the current request. */
+    static current(req) {
+        return req.url;
+    }
+    /** The previous URL from the `Referer` header, or `fallback`. */
+    static previous(req, fallback = '/') {
+        return req.headers['referer'] ?? fallback;
+    }
+    /**
+     * Generate a signed URL for a named route.
+     *
+     * @example
+     * Url.signedRoute('invoice.download', { id: 42 })
+     * // → '/invoice/42?signature=abc123'
+     */
+    static signedRoute(name, params = {}, expiresAt) {
+        return Url.sign(route(name, params), expiresAt);
+    }
+    /**
+     * Generate a signed URL that expires after `seconds` seconds.
+     *
+     * @example
+     * Url.temporarySignedRoute('invoice.download', 3600, { id: 42 })
+     * // → '/invoice/42?expires=1234567890&signature=abc123'
+     */
+    static temporarySignedRoute(name, seconds, params = {}) {
+        return Url.signedRoute(name, params, new Date(Date.now() + seconds * 1000));
+    }
+    /**
+     * Sign an arbitrary path string.
+     * Appends `?signature=...` (and `?expires=...` if `expiresAt` given).
+     */
+    static sign(path, expiresAt) {
+        const [pathname, search] = _splitPath(path);
+        const params = new URLSearchParams(search);
+        if (expiresAt) {
+            params.set('expires', String(Math.floor(expiresAt.getTime() / 1000)));
+        }
+        const sig = _computeSignature(pathname, params);
+        params.set('signature', sig);
+        return `${pathname}?${params.toString()}`;
+    }
+    /**
+     * Return `true` if the request has a valid (and non-expired) signature.
+     */
+    static isValidSignature(req) {
+        const [pathname, search] = _splitPath(req.url);
+        const params = new URLSearchParams(search);
+        const signature = params.get('signature');
+        if (!signature)
+            return false;
+        // Check expiry before touching the signature
+        const expires = params.get('expires');
+        if (expires !== null) {
+            const expiry = parseInt(expires, 10);
+            if (isNaN(expiry) || Date.now() / 1000 > expiry)
+                return false;
+        }
+        const expected = _computeSignature(pathname, params);
+        try {
+            if (!_crypto)
+                return signature === expected;
+            return _crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
+        }
+        catch {
+            return false;
+        }
+    }
+}
+// ─── ValidateSignature middleware ───────────────────────────
+/**
+ * Middleware that verifies a signed URL signature.
+ * Responds with 403 if the signature is missing, invalid, or expired.
+ *
+ * @example
+ * router.get('/invoice/:id/download', handler, [ValidateSignature()])
+ */
+export function ValidateSignature() {
+    return async (req, res, next) => {
+        if (!Url.isValidSignature(req)) {
+            return res.status(403).json({ message: 'Invalid or expired URL signature.' });
+        }
+        await next();
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@rudderjs/router",
+  "version": "0.0.3",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rudderjs/rudder",
+    "directory": "packages/router"
+  },
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "default": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "reflect-metadata": "^0.2.2",
+    "@rudderjs/contracts": "0.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/reflect-metadata": "^0.1.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.4.0"
+  },
+  "author": "Suleiman Shahbari",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "clean": "rm -rf dist",
+    "test": "tsc -p tsconfig.test.json && node --test dist-test/index.test.js; EXIT=$?; rm -rf dist-test; exit $EXIT"
+  }
+}