@rudderjs/router 1.2.0 → 1.3.0

package/README.md

@@ -196,6 +196,23 @@ Returning `null` from `findForRoute` triggers `RouteModelNotFoundError` (HTTP 40
 
 The `RouteResolver` contract is duck-typed — `name: string` + `findForRoute(value): unknown | Promise<unknown | null>` — so the router doesn't depend on `@rudderjs/orm`.
 
+### Catch-all fallback with `router.fallback()`
+
+Register a handler that runs when no other route matches — Laravel's `Route::fallback()`. Use it for custom 404 JSON shapes, vanity URL redirects, or a "soft" landing on api routes:
+
+```ts
+router.fallback((_req, res) => res.status(404).json({
+  message: 'Endpoint not found',
+}))
+
+// Per-request middleware works too
+router.fallback(handler, [LogUnknownRoute()])
+```
+
+Only one fallback per router — registering a second one replaces the first. The fallback runs after every other matcher, including `router.all('/api/*', ...)`, so use it as the last-resort 404 path.
+
+---
+
 ### Custom 404 with `.missing()`
 
 Override the default 404 response per route. Receives the request and the binding error; return a value the route handler may return — `Response`, plain object → JSON, string → body, or `undefined` (you wrote to `res` directly).
@@ -368,6 +385,7 @@ router.mount(serverAdapter)
 | `use(middleware)` | `this` | Register global middleware |
 | `bind(name, resolver, opts?)` | `this` | Bind a `:param` to a `RouteResolver` (e.g. an ORM Model) for auto-resolution |
 | `listBindings()` | `Record<string, RouteResolver>` | All registered route bindings |
+| `fallback(handler, mw?)` | `RouteBuilder` | Catch-all handler when no other route matches |
 | `group(opts, fn)` | `this` | Apply prefix/domain/middleware to every route registered inside `fn` |
 | `resource(name, Ctrl, opts?)` | `ResourceRegistration` | Register the seven canonical RESTful routes |
 | `apiResource(name, Ctrl, opts?)` | `ResourceRegistration` | Resource minus `create`/`edit` |

package/dist/binding-middleware.d.ts

@@ -0,0 +1,54 @@
+import type { MiddlewareHandler, RouteDefinition } from '@rudderjs/contracts';
+/**
+ * Duck-typed contract for any object that resolves a string route parameter
+ * into a value (typically a Model instance, but the router doesn't depend on
+ * `@rudderjs/orm` — anything with a static `findForRoute` method works).
+ *
+ * Returning `null` signals "not found" — the router maps that to a thrown
+ * `RouteModelNotFoundError`, which the framework's HTTP layer renders as a 404.
+ */
+export interface RouteResolver {
+    /** Owning class name — used for error messages only. */
+    name: string;
+    /** Resolve the raw param value. Return `null` for not-found. */
+    findForRoute(value: string): Promise<unknown | null> | unknown | null;
+}
+export interface RouteBindingOptions {
+    /**
+     * When `true`, an absent or unresolvable param value silently sets
+     * `req.bound[name] = null` instead of throwing. Useful for shared routes
+     * that may or may not have a logged-in subject.
+     */
+    optional?: boolean;
+}
+/** @internal — stored entry in `Router.bindings`. */
+export interface RouteBinding {
+    resolver: RouteResolver;
+    optional: boolean;
+}
+/**
+ * Thrown by route binding middleware when a required `{param}` cannot be
+ * resolved into a model instance. `@rudderjs/core` picks up the duck-typed
+ * `httpStatus` and renders this as an HTTP 404; apps can catch it explicitly
+ * to render a custom not-found page.
+ */
+export declare class RouteModelNotFoundError extends Error {
+    readonly model: string;
+    readonly param: string;
+    readonly value: string;
+    /** Duck-typed signal to `@rudderjs/core`'s exception handler. */
+    readonly httpStatus = 404;
+    constructor(model: string, param: string, value: string);
+}
+/**
+ * Build per-route binding middleware from the route's `{param}` segments and
+ * the router's binding map. Returns `null` when the route's path contains no
+ * bound params — callers skip installation in that case so unbound routes
+ * keep their original middleware chain.
+ *
+ * Takes the full `RouteDefinition` (not just `path`) so the closure can
+ * capture `def.missing` — the per-route 404 customisation set via
+ * `RouteBuilder.missing()`.
+ */
+export declare function buildBindingMiddleware(bindings: Map<string, RouteBinding>, def: RouteDefinition): MiddlewareHandler | null;
+//# sourceMappingURL=binding-middleware.d.ts.map

package/dist/binding-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-middleware.d.ts","sourceRoot":"","sources":["../src/binding-middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAK7E;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ,gEAAgE;IAChE,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,OAAO,GAAG,IAAI,CAAA;CACtE;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,aAAa,CAAA;IACvB,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED;;;;;GAKG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IAEtB,iEAAiE;IACjE,QAAQ,CAAC,UAAU,OAAM;gBAEb,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAOxD;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EACnC,GAAG,EAAE,eAAe,GACnB,iBAAiB,GAAG,IAAI,CAuD1B"}

package/dist/binding-middleware.js

@@ -0,0 +1,101 @@
+import { stripRegexSegments } from './index.js';
+/**
+ * Thrown by route binding middleware when a required `{param}` cannot be
+ * resolved into a model instance. `@rudderjs/core` picks up the duck-typed
+ * `httpStatus` and renders this as an HTTP 404; apps can catch it explicitly
+ * to render a custom not-found page.
+ */
+export class RouteModelNotFoundError extends Error {
+    model;
+    param;
+    value;
+    /** Duck-typed signal to `@rudderjs/core`'s exception handler. */
+    httpStatus = 404;
+    constructor(model, param, value) {
+        super(`[RudderJS] No ${model} matched route parameter "${param}" with value "${value}".`);
+        this.name = 'RouteModelNotFoundError';
+        this.model = model;
+        this.param = param;
+        this.value = value;
+    }
+}
+/**
+ * Build per-route binding middleware from the route's `{param}` segments and
+ * the router's binding map. Returns `null` when the route's path contains no
+ * bound params — callers skip installation in that case so unbound routes
+ * keep their original middleware chain.
+ *
+ * Takes the full `RouteDefinition` (not just `path`) so the closure can
+ * capture `def.missing` — the per-route 404 customisation set via
+ * `RouteBuilder.missing()`.
+ */
+export function buildBindingMiddleware(bindings, def) {
+    // Strip `{regex}` constraint segments from `where*()` before scanning for
+    // param names — otherwise a `:` inside a custom pattern could be misread
+    // as a route param. Uses balanced-brace stripping to support nested `{n}`
+    // quantifiers (e.g. UUID's `[0-9a-f]{8}-...`).
+    const stripped = stripRegexSegments(def.path);
+    const paramNames = [...stripped.matchAll(/:([a-zA-Z_][a-zA-Z0-9_]*)\??/g)].map(m => m[1]);
+    const matches = [];
+    for (const name of paramNames) {
+        const binding = bindings.get(name);
+        if (binding)
+            matches.push([name, binding]);
+    }
+    if (matches.length === 0)
+        return null;
+    return async (req, res, next) => {
+        // Lazy-init bound bag so handlers always see an object.
+        const bound = req.bound ?? {};
+        req.bound = bound;
+        for (const [name, binding] of matches) {
+            const raw = req.params[name];
+            let err = null;
+            if (raw === undefined || raw === '') {
+                if (binding.optional) {
+                    bound[name] = null;
+                    continue;
+                }
+                err = new RouteModelNotFoundError(binding.resolver.name, name, '');
+            }
+            else {
+                const resolved = await binding.resolver.findForRoute(raw);
+                if (resolved === null || resolved === undefined) {
+                    if (binding.optional) {
+                        bound[name] = null;
+                        continue;
+                    }
+                    err = new RouteModelNotFoundError(binding.resolver.name, name, raw);
+                }
+                else {
+                    bound[name] = resolved;
+                }
+            }
+            if (err) {
+                if (def.missing) {
+                    // Route opted into a custom 404 — dispatch the result the same
+                    // way registerRoute() handles a route handler's return value.
+                    const result = await def.missing(req, err);
+                    if (result instanceof Response) {
+                        ;
+                        res.raw.res = result;
+                        return;
+                    }
+                    if (typeof result === 'string') {
+                        res.send(result);
+                        return;
+                    }
+                    if (result !== undefined && result !== null) {
+                        res.json(result);
+                        return;
+                    }
+                    // undefined → callback wrote to res directly; trust that.
+                    return;
+                }
+                throw err;
+            }
+        }
+        await next();
+    };
+}
+//# sourceMappingURL=binding-middleware.js.map

package/dist/binding-middleware.js.map

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

package/dist/index.d.ts

@@ -1,6 +1,45 @@
 import 'reflect-metadata';
-import type { ServerAdapter, RouteDefinition, RouteHandler, MiddlewareHandler, HttpMethod, RouteGroup, AppRequest } from '@rudderjs/contracts';
+import type { ServerAdapter, RouteDefinition, RouteHandler, MiddlewareHandler, HttpMethod, RouteGroup } from '@rudderjs/contracts';
+import type { ZodType, z } from 'zod';
+import type { TypedHandler } from './typed-routes.js';
+export type { ExtractParams, TypedRequest, TypedHandler } from './typed-routes.js';
+/**
+ * Per-route options accepted in the 3-arg form of `Router.get/post/etc`.
+ *
+ * The 3-arg form exists so the handler closure can be typed against the
+ * Zod-inferred query shape *at write time* — the bare 2-arg form types
+ * `req.query` as `Record<string, string>`, and chaining `.query(schema)`
+ * after that can't go back and re-type the closure.
+ */
+export interface RouteOptions<S extends ZodType = ZodType> {
+    /** Zod schema to validate `req.query` against. Parsed result replaces `req.query`. */
+    query?: S;
+    /** Per-route middleware (prepended before the handler). */
+    middleware?: MiddlewareHandler[];
+}
+/**
+ * Tag every route registered while `fn` runs with `group` ('web' | 'api').
+ *
+ * **Synchronous bodies are the supported case.** Route loaders call
+ * `Route.get/post/...` at module-evaluation time — those calls complete
+ * before `fn` resolves, even when `fn` is `async`. The implementation
+ * supports an async `fn` (restoring the previous group in a `.finally()`),
+ * but two concurrent `runWithGroup` invocations on the same module instance
+ * will clobber each other: this is a single module-level variable, not an
+ * AsyncLocalStorage scope. Callers must run loaders **serially** — see
+ * `@rudderjs/core`'s `withRouting()` which sequentially `await`s each
+ * loader.
+ *
+ * Outside any `runWithGroup` scope, routes register without a group tag and
+ * receive only global `m.use(...)` middleware (no `m.web(...)` / `m.api(...)`
+ * stack).
+ */
 export declare function runWithGroup<R>(group: RouteGroup, fn: () => R | Promise<R>): R | Promise<R>;
+/**
+ * Read the current group tag. Reads the module-level slot directly; returns
+ * `undefined` outside any `runWithGroup(...)` block. Called by route
+ * decorators to stamp each `RouteDefinition` with its group.
+ */
 export declare function currentGroup(): RouteGroup | undefined;
 /** Mark a class as a controller with an optional route prefix */
 export declare function Controller(prefix?: string): ClassDecorator;
@@ -12,6 +51,13 @@ 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;
+/**
+ * Remove every balanced `{...}` block from a path. Used to peel off
+ * `where*()` regex constraint segments before scanning the path for `:param`
+ * names.
+ */
+/** @internal — exported so sibling modules (binding-middleware) can reuse. */
+export declare function stripRegexSegments(path: string): string;
 /** Matches one or more digits — `[0-9]+`. */
 export declare const ROUTE_PATTERN_NUMBER = "[0-9]+";
 /** Matches one or more ASCII letters — `[A-Za-z]+`. */
@@ -30,9 +76,12 @@ export declare const ROUTE_PATTERN_ULID = "[0-7][0-9A-HJKMNP-TV-Z]{25}";
  * router.get('/users/:id', handler).name('users.show').whereNumber('id')
  * route('users.show', { id: 1 })  // → '/users/1'
  */
-export declare class RouteBuilder {
+export declare class RouteBuilder<P extends string = string, // path literal — preserved for .query() / future .body() chains
+Q = Record<string, string>> {
     private readonly definition;
     private readonly _router;
+    readonly _path: P;
+    readonly _query: Q;
     constructor(definition: RouteDefinition, _router: Router);
     /** Assign a name to this route for use with `route()` and `Url.signedRoute()`. */
     name(n: string): this;
@@ -89,6 +138,27 @@ export declare class RouteBuilder {
      *   .missing((_req, err) => Response.json({ error: err.message }, { status: 404 }))
      */
     missing(fn: NonNullable<RouteDefinition['missing']>): this;
+    /**
+     * Install a Zod validator on `req.query` for this route. The parsed result
+     * replaces `req.query` at request time, so `z.coerce.number()` end-to-end
+     * works.
+     *
+     * **Note on typing:** the handler was already passed (and typed) when this
+     * route was registered. Chaining `.query(schema)` AFTER cannot re-type a
+     * closure that's already been bound. The returned `RouteBuilder<P, z.infer<S>>`
+     * carries the inferred query for downstream chain methods, but the
+     * already-registered handler still sees the original typing of its closure.
+     *
+     * For type-safe query at the handler closure, use the opts-object form:
+     *
+     * @example
+     * // Type-safe (handler closure sees `req.query.page: number`)
+     * Route.get('/users', { query: z.object({ page: z.coerce.number() }) }, (req) => req.query.page)
+     *
+     * // Runtime-only (validation runs, but `req.query.page` is still typed string)
+     * Route.get('/users', (req) => req.query.page).query(z.object({ page: z.coerce.number() }))
+     */
+    query<S extends ZodType>(schema: S): RouteBuilder<P, z.infer<S>>;
 }
 /**
  * Options accepted by `router.group(opts, fn)`. Each route registered inside
@@ -105,42 +175,9 @@ export interface RouteGroupOptions {
     /** Middleware prepended to every route's chain (before per-route middleware). */
     middleware?: MiddlewareHandler[];
 }
-/**
- * Duck-typed contract for any object that resolves a string route parameter
- * into a value (typically a Model instance, but the router doesn't depend on
- * `@rudderjs/orm` — anything with a static `findForRoute` method works).
- *
- * Returning `null` signals "not found" — the router maps that to a thrown
- * `RouteModelNotFoundError`, which the framework's HTTP layer renders as a 404.
- */
-export interface RouteResolver {
-    /** Owning class name — used for error messages only. */
-    name: string;
-    /** Resolve the raw param value. Return `null` for not-found. */
-    findForRoute(value: string): Promise<unknown | null> | unknown | null;
-}
-export interface RouteBindingOptions {
-    /**
-     * When `true`, an absent or unresolvable param value silently sets
-     * `req.bound[name] = null` instead of throwing. Useful for shared routes
-     * that may or may not have a logged-in subject.
-     */
-    optional?: boolean;
-}
-/**
- * Thrown by route binding middleware when a required `{param}` cannot be
- * resolved into a model instance. `@rudderjs/core` picks up the duck-typed
- * `httpStatus` and renders this as an HTTP 404; apps can catch it explicitly
- * to render a custom not-found page.
- */
-export declare class RouteModelNotFoundError extends Error {
-    readonly model: string;
-    readonly param: string;
-    readonly value: string;
-    /** Duck-typed signal to `@rudderjs/core`'s exception handler. */
-    readonly httpStatus = 404;
-    constructor(model: string, param: string, value: string);
-}
+import { type RouteResolver, type RouteBindingOptions } from './binding-middleware.js';
+export { RouteModelNotFoundError } from './binding-middleware.js';
+export type { RouteResolver, RouteBindingOptions } from './binding-middleware.js';
 export declare class Router {
     private routes;
     private globalMiddleware;
@@ -242,12 +279,35 @@ export declare class Router {
     private _buildBindingMiddleware;
     /** 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;
+    get<P extends string>(path: P, handler: TypedHandler<P>, middleware?: MiddlewareHandler[]): RouteBuilder<P>;
+    get<P extends string, S extends ZodType>(path: P, opts: RouteOptions<S> & {
+        query: S;
+    }, handler: TypedHandler<P, z.infer<S>>): RouteBuilder<P, z.infer<S>>;
+    post<P extends string>(path: P, handler: TypedHandler<P>, middleware?: MiddlewareHandler[]): RouteBuilder<P>;
+    post<P extends string, S extends ZodType>(path: P, opts: RouteOptions<S> & {
+        query: S;
+    }, handler: TypedHandler<P, z.infer<S>>): RouteBuilder<P, z.infer<S>>;
+    put<P extends string>(path: P, handler: TypedHandler<P>, middleware?: MiddlewareHandler[]): RouteBuilder<P>;
+    put<P extends string, S extends ZodType>(path: P, opts: RouteOptions<S> & {
+        query: S;
+    }, handler: TypedHandler<P, z.infer<S>>): RouteBuilder<P, z.infer<S>>;
+    patch<P extends string>(path: P, handler: TypedHandler<P>, middleware?: MiddlewareHandler[]): RouteBuilder<P>;
+    patch<P extends string, S extends ZodType>(path: P, opts: RouteOptions<S> & {
+        query: S;
+    }, handler: TypedHandler<P, z.infer<S>>): RouteBuilder<P, z.infer<S>>;
+    delete<P extends string>(path: P, handler: TypedHandler<P>, middleware?: MiddlewareHandler[]): RouteBuilder<P>;
+    delete<P extends string, S extends ZodType>(path: P, opts: RouteOptions<S> & {
+        query: S;
+    }, handler: TypedHandler<P, z.infer<S>>): RouteBuilder<P, z.infer<S>>;
+    all<P extends string>(path: P, handler: TypedHandler<P>, middleware?: MiddlewareHandler[]): RouteBuilder<P>;
+    all<P extends string, S extends ZodType>(path: P, opts: RouteOptions<S> & {
+        query: S;
+    }, handler: TypedHandler<P, z.infer<S>>): RouteBuilder<P, z.infer<S>>;
+    /**
+     * Internal dispatcher for the two-overload shorthand methods. Decides
+     * between bare and opts form by whether the second arg is callable.
+     */
+    private _verb;
     /**
      * Register a catch-all fallback route. Runs when no other route matches.
      * Register it last — Hono evaluates routes in registration order.
@@ -308,63 +368,9 @@ export declare class Router {
     /** @internal — shared registration loop for resource/apiResource/singleton. */
     _registerResource(name: string, Ctrl: new () => object, table: readonly ResourceVerbSpec[], opts: ResourceOptions): ResourceRegistration;
 }
-/** The seven canonical RESTful verbs Laravel's `Route::resource` exposes. */
-export type ResourceVerb = 'index' | 'create' | 'store' | 'show' | 'edit' | 'update' | 'destroy';
-interface ResourceVerbSpec {
-    verb: ResourceVerb;
-    method: HttpMethod;
-    path: (name: string, param: string) => string;
-    nameSuffix: string;
-}
-/**
- * Options accepted by `router.resource`/`apiResource`/`singleton`.
- *
- * - `only`/`except` — restrict the verbs registered.
- * - `parameters` — override the `:param` segment name for a given resource
- *   (e.g. `{ posts: 'article' }` → `/posts/:article`).
- * - `names` — override the generated route names per verb.
- * - `middleware` — applied to every route registered by the resource.
- */
-export interface ResourceOptions {
-    only?: readonly ResourceVerb[];
-    except?: readonly ResourceVerb[];
-    parameters?: Record<string, string>;
-    names?: Partial<Record<ResourceVerb, string>>;
-    middleware?: MiddlewareHandler[];
-}
-/**
- * Returned by `router.resource()`/`apiResource()`. The `builders` array holds
- * one `RouteBuilder` per registered route in declaration order — apply
- * `where*()`, additional middleware, or rename individual routes by indexing
- * directly. The `update` PATCH alias is included as a separate builder
- * immediately after its PUT counterpart.
- */
-export declare class ResourceRegistration {
-    readonly builders: RouteBuilder[];
-    constructor(builders: RouteBuilder[]);
-}
-/**
- * Returned by `router.singleton()`. Adds two opt-in helpers on top of
- * `ResourceRegistration` for resources that also expose a creation flow
- * (`.creatable()`) or deletion flow (`.destroyable()`).
- */
-export declare class SingletonRegistration extends ResourceRegistration {
-    private readonly _router;
-    private readonly _name;
-    private readonly _Ctrl;
-    private readonly _opts;
-    constructor(builders: RouteBuilder[], _router: Router, _name: string, _Ctrl: new () => object, _opts: ResourceOptions);
-    /**
-     * Add `GET /<name>/create` and `POST /<name>` — the create/store half of a
-     * full resource. Skipped for any verb the controller doesn't implement.
-     */
-    creatable(): this;
-    /**
-     * Add `DELETE /<name>` — the destroy half of a full resource. Skipped if
-     * the controller doesn't implement `destroy()`.
-     */
-    destroyable(): this;
-}
+import { ResourceRegistration, SingletonRegistration, type ResourceOptions, type ResourceVerbSpec } from './resource.js';
+export type { ResourceVerb, ResourceOptions } from './resource.js';
+export { ResourceRegistration, SingletonRegistration } from './resource.js';
 export declare const router: Router;
 /** Alias for router — Laravel-style capitalised name */
 export declare const Route: Router;
@@ -380,49 +386,5 @@ export declare const Route: Router;
  * 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;
-export {};
+export { Url, ValidateSignature } from './url-signing.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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