actor-ts 0.10.0 → 0.11.0

package/dist/http/Marshalling.js

@@ -20,11 +20,11 @@ export function pickRequestSerializer(req) {
 export function pickResponseSerializer(req) {
     const accept = req.headers['accept'] ?? 'application/json';
     for (const tok of accept.split(',')) {
-        const t = tok.trim().split(';')[0].toLowerCase();
-        if (t === 'application/cbor' || t === 'application/x-cbor') {
+        const mediaType = tok.trim().split(';')[0].toLowerCase();
+        if (mediaType === 'application/cbor' || mediaType === 'application/x-cbor') {
             return { serializer: new CborSerializer(), contentType: 'application/cbor' };
         }
-        if (t === 'application/json' || t === '*/*') {
+        if (mediaType === 'application/json' || mediaType === '*/*') {
             return { serializer: new JsonSerializer(), contentType: 'application/json; charset=utf-8' };
         }
     }

package/dist/http/Marshalling.js.map

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

package/dist/http/MimeTypes.d.ts

@@ -0,0 +1,15 @@
+/**
+ * A small, dependency-free MIME-type registry — the response-side sibling
+ * of request marshalling.  Maps a file extension to a content-type for the
+ * static-file directives (and anyone building file responses by hand).
+ */
+/** Extension (lowercase, no dot) → content-type (no charset). */
+export declare const DEFAULT_MIME_TYPES: Readonly<Record<string, string>>;
+/**
+ * Resolve a content-type from a path or bare extension.  Text-ish types
+ * get `; charset=utf-8`; unknown extensions fall back to
+ * `application/octet-stream`.  `overrides` (ext → full content-type, taken
+ * verbatim) win over the defaults.
+ */
+export declare function contentTypeFor(pathOrExt: string, overrides?: Readonly<Record<string, string>>): string;
+//# sourceMappingURL=MimeTypes.d.ts.map

package/dist/http/MimeTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MimeTypes.d.ts","sourceRoot":"","sources":["../../src/http/MimeTypes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA6C9D,CAAC;AAuBH;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAOtG"}

package/dist/http/MimeTypes.js

@@ -0,0 +1,87 @@
+/**
+ * A small, dependency-free MIME-type registry — the response-side sibling
+ * of request marshalling.  Maps a file extension to a content-type for the
+ * static-file directives (and anyone building file responses by hand).
+ */
+/** Extension (lowercase, no dot) → content-type (no charset). */
+export const DEFAULT_MIME_TYPES = Object.freeze({
+    html: 'text/html',
+    htm: 'text/html',
+    xhtml: 'application/xhtml+xml',
+    css: 'text/css',
+    js: 'text/javascript',
+    mjs: 'text/javascript',
+    cjs: 'text/javascript',
+    json: 'application/json',
+    map: 'application/json',
+    webmanifest: 'application/manifest+json',
+    xml: 'application/xml',
+    txt: 'text/plain',
+    md: 'text/markdown',
+    csv: 'text/csv',
+    yaml: 'application/yaml',
+    yml: 'application/yaml',
+    svg: 'image/svg+xml',
+    png: 'image/png',
+    jpg: 'image/jpeg',
+    jpeg: 'image/jpeg',
+    gif: 'image/gif',
+    webp: 'image/webp',
+    avif: 'image/avif',
+    apng: 'image/apng',
+    bmp: 'image/bmp',
+    ico: 'image/x-icon',
+    woff: 'font/woff',
+    woff2: 'font/woff2',
+    ttf: 'font/ttf',
+    otf: 'font/otf',
+    pdf: 'application/pdf',
+    wasm: 'application/wasm',
+    mp3: 'audio/mpeg',
+    ogg: 'audio/ogg',
+    wav: 'audio/wav',
+    flac: 'audio/flac',
+    mp4: 'video/mp4',
+    m4v: 'video/mp4',
+    webm: 'video/webm',
+    mov: 'video/quicktime',
+    zip: 'application/zip',
+    gz: 'application/gzip',
+    tar: 'application/x-tar',
+    '7z': 'application/x-7z-compressed',
+});
+/** Non-`text/*` types that are still text and should carry a UTF-8 charset. */
+const CHARSET_TYPES = new Set([
+    'application/json',
+    'application/manifest+json',
+    'application/xml',
+    'application/xhtml+xml',
+    'application/yaml',
+    'image/svg+xml',
+]);
+/** Last-segment, last-dot extension, lowercased.  Accepts a path or a bare ext. */
+function extensionOf(pathOrExt) {
+    const segment = pathOrExt.split(/[\\/]/).pop() ?? '';
+    const dot = segment.lastIndexOf('.');
+    return (dot < 0 ? segment : segment.slice(dot + 1)).toLowerCase();
+}
+function needsCharset(type) {
+    return type.startsWith('text/') || CHARSET_TYPES.has(type);
+}
+/**
+ * Resolve a content-type from a path or bare extension.  Text-ish types
+ * get `; charset=utf-8`; unknown extensions fall back to
+ * `application/octet-stream`.  `overrides` (ext → full content-type, taken
+ * verbatim) win over the defaults.
+ */
+export function contentTypeFor(pathOrExt, overrides) {
+    const ext = extensionOf(pathOrExt);
+    const override = overrides?.[ext];
+    if (override)
+        return override;
+    const base = DEFAULT_MIME_TYPES[ext];
+    if (!base)
+        return 'application/octet-stream';
+    return needsCharset(base) ? `${base}; charset=utf-8` : base;
+}
+//# sourceMappingURL=MimeTypes.js.map

package/dist/http/MimeTypes.js.map

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

package/dist/http/Route.d.ts

@@ -1,9 +1,10 @@
 import type { ActorSystem } from '../ActorSystem.js';
 import { type HttpMethod, type HttpRequest, type HttpResponse } from './types.js';
-import type { WebSocketSocketAdapter } from './ws/SocketAdapter.js';
+import type { WebsocketSocketAdapter } from './websocket/SocketAdapter.js';
+import { type CorsRouteOptions } from './middleware/Cors.js';
 /**
  * A compiled HTTP route — the Route-DSL reduces to a list of these
- * (plus {@link CompiledWebSocketRoute}s), which the HTTP backend
+ * (plus {@link CompiledWebsocketRoute}s), which the HTTP backend
  * registers in its native routing table.
  */
 export interface CompiledRoute {
@@ -18,7 +19,7 @@ export interface CompiledRoute {
  * and a normalised socket; the closure (built by the `websocket()`
  * directive) owns the codec, target ref and per-route policy.
  */
-export type WebSocketConnectHandler = (system: ActorSystem, req: HttpRequest, socket: WebSocketSocketAdapter) => void;
+export type WebsocketConnectHandler = (system: ActorSystem, req: HttpRequest, socket: WebsocketSocketAdapter) => void;
 /**
  * A compiled WebSocket route.  Occupies the `GET` verb at its pattern
  * (that's how the HTTP upgrade arrives).  `authorize` folds any
@@ -26,21 +27,36 @@ export type WebSocketConnectHandler = (system: ActorSystem, req: HttpRequest, so
  * request, and returns `null` to accept or an {@link HttpResponse} to
  * reject the upgrade with a plain HTTP response.
  */
-export interface CompiledWebSocketRoute {
+export interface CompiledWebsocketRoute {
     readonly kind: 'websocket';
     readonly method: 'GET';
     readonly pattern: string;
-    readonly connect: WebSocketConnectHandler;
+    readonly connect: WebsocketConnectHandler;
     readonly authorize: (req: HttpRequest) => Promise<HttpResponse | null>;
 }
-/** A compiled endpoint is either a plain HTTP route or a WebSocket route. */
-export type CompiledEndpoint = CompiledRoute | CompiledWebSocketRoute;
+/**
+ * A compiled fallback — answers any request that matched no other route.
+ * Wired to the backend's not-found hook at bind time (exactly one per
+ * server), so unlike {@link CompiledRoute} it carries no method or pattern.
+ */
+export interface CompiledFallback {
+    readonly kind: 'fallback';
+    readonly handler: (req: HttpRequest) => Promise<HttpResponse> | HttpResponse;
+}
+/** A compiled endpoint: a plain HTTP route, a WebSocket route, or the fallback. */
+export type CompiledEndpoint = CompiledRoute | CompiledWebsocketRoute | CompiledFallback;
 /**
  * Per-request hook that runs around a handler.  Receives the request
  * and a `next()` thunk; either short-circuit by returning your own
  * response, or call `next()` and pass its result through (optionally
  * wrapped, decorated, or re-thrown).
  *
+ * `next()` optionally takes a **replacement request** — pass one to
+ * enrich what the handler (and any inner middleware) sees, e.g. to inject
+ * a generated request id or a verified CSRF token as a header.  Omit the
+ * argument to forward the request unchanged; the two forms are otherwise
+ * identical, so existing `next()` call sites keep working.
+ *
  * Examples (all shipped in `src/http/middleware/`):
  *   - `BearerTokenAuth({ tokens })` — checks `Authorization: Bearer`,
  *     short-circuits with 401 on mismatch.
@@ -51,7 +67,7 @@ export type CompiledEndpoint = CompiledRoute | CompiledWebSocketRoute;
  * Throwing `HttpError(status, msg)` is the idiomatic short-circuit:
  * the global error handler catches it and emits the right response.
  */
-export type Middleware = (req: HttpRequest, next: () => Promise<HttpResponse>) => Promise<HttpResponse> | HttpResponse;
+export type Middleware = (req: HttpRequest, next: (req?: HttpRequest) => Promise<HttpResponse>) => Promise<HttpResponse> | HttpResponse;
 /**
  * Node type emitted by DSL builders like `path(...)`, `get(...)`.  Internal
  * representation is a tree that knows how to flatten into CompiledRoutes.
@@ -73,7 +89,15 @@ export type Route = {
     readonly child: Route;
 } | {
     readonly kind: 'websocket';
-    readonly connect: WebSocketConnectHandler;
+    readonly connect: WebsocketConnectHandler;
+    readonly authorize?: (req: HttpRequest) => HttpResponse | null;
+} | {
+    readonly kind: 'fallback';
+    readonly handler: (req: HttpRequest) => Promise<HttpResponse> | HttpResponse;
+} | {
+    readonly kind: 'cors';
+    readonly settings: CorsRouteOptions;
+    readonly child: Route;
 };
 /** Compose several sibling routes (OR semantics — first matching wins). */
 export declare function concat(...routes: Route[]): Route;
@@ -102,6 +126,51 @@ export declare function pathPrefix(segment: string, child: Route): Route;
  *     );
  */
 export declare function withMiddleware(middleware: Middleware, child: Route): Route;
+/**
+ * Handler for {@link handleErrors}.  Receives the thrown value (an
+ * {@link HttpError} or anything else) plus the request; return an
+ * {@link HttpResponse} to handle it, or `null`/`undefined` to decline —
+ * declining re-throws so an outer `handleErrors` (or, failing that, the
+ * backend's default mapping) takes over.
+ */
+export type ExceptionHandler = (err: unknown, req: HttpRequest) => Promise<HttpResponse | null | undefined> | HttpResponse | null | undefined;
+/**
+ * Scope an exception handler over `child`'s subtree — the akka-http
+ * `ExceptionHandler` analogue, implemented as sugar over a `middleware`
+ * node so it inherits handler-wrapping (and the WebSocket authorize fold)
+ * for free.
+ *
+ * The handler sees the ORIGINAL thrown value — e.g. the `HttpError`
+ * instance with its `status` / `extra` / `headers` — because DSL-level
+ * wrappers run strictly before any backend's default error mapping.
+ * Handlers nest outside-in like {@link withMiddleware}: the innermost
+ * `handleErrors` gets first refusal, and returning `null` delegates
+ * outward.  Placed around a `withMiddleware(...)` node it also catches
+ * that middleware's throws (e.g. an auth 401).
+ *
+ *     handleErrors(
+ *       (err) => err instanceof NotFoundError ? complete(Status.NotFound, ...) : null,
+ *       path('users', concat(...)),
+ *     )
+ */
+export declare function handleErrors(handler: ExceptionHandler, child: Route): Route;
+/**
+ * Answer any request that matched no other route — the server-global
+ * not-found handler expressed in the DSL.  Wired to the backend's
+ * not-found hook at bind time, so it is method-agnostic (it also answers
+ * unmatched OPTIONS/HEAD) and MUST sit at the root of the tree: a fallback
+ * scoped under `path()` / `pathPrefix()` is rejected at compile time,
+ * because a server has exactly one not-found handler.  At most one
+ * `fallback()` per server.  It still composes with
+ * `withMiddleware()` / `handleErrors()`, which wrap its handler like any
+ * other, so a fallback can carry security headers or its own recovery.
+ *
+ *     concat(
+ *       path('api', apiRoutes),
+ *       fallback((req) => completeJson(Status.NotFound, { error: 'no route', path: req.path })),
+ *     )
+ */
+export declare function fallback(handler: (req: HttpRequest) => Promise<HttpResponse> | HttpResponse): Route;
 export declare const get: (h: (req: HttpRequest) => Promise<HttpResponse> | HttpResponse) => Route;
 export declare const post: (h: (req: HttpRequest) => Promise<HttpResponse> | HttpResponse) => Route;
 export declare const put: (h: (req: HttpRequest) => Promise<HttpResponse> | HttpResponse) => Route;
@@ -119,6 +188,14 @@ export declare function completeText(status: number, body: string, headers?: Rec
 export declare function redirect(url: string, status?: number): HttpResponse;
 /** Rejection — throw to short-circuit to a 4xx/5xx. */
 export declare function reject(status: number, message: string, extra?: Record<string, unknown>): never;
+/**
+ * The framework's default error→response mapping: an {@link HttpError}
+ * becomes its status + `{ error, ...extra }` JSON (carrying any custom
+ * `headers`); anything else becomes a generic 500 that deliberately does
+ * NOT echo the thrown message.  Kept in one place so the WebSocket
+ * upgrade-reject path and the `fallback()` wrapper map errors identically.
+ */
+export declare function defaultErrorResponse(err: unknown): HttpResponse;
 /** Flatten a Route tree into the list of concrete endpoint registrations. */
 export declare function compile(route: Route, prefix?: string[]): CompiledEndpoint[];
 /**

package/dist/http/Route.d.ts.map

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

package/dist/http/Route.js

@@ -1,5 +1,6 @@
 import { match } from 'ts-pattern';
 import { HttpError, Status } from './types.js';
+import { expandCors } from './middleware/Cors.js';
 /** Compose several sibling routes (OR semantics — first matching wins). */
 export function concat(...routes) {
     return { kind: 'concat', routes };
@@ -35,6 +36,58 @@ export function pathPrefix(segment, child) {
 export function withMiddleware(middleware, child) {
     return { kind: 'middleware', middleware, child };
 }
+/**
+ * Scope an exception handler over `child`'s subtree — the akka-http
+ * `ExceptionHandler` analogue, implemented as sugar over a `middleware`
+ * node so it inherits handler-wrapping (and the WebSocket authorize fold)
+ * for free.
+ *
+ * The handler sees the ORIGINAL thrown value — e.g. the `HttpError`
+ * instance with its `status` / `extra` / `headers` — because DSL-level
+ * wrappers run strictly before any backend's default error mapping.
+ * Handlers nest outside-in like {@link withMiddleware}: the innermost
+ * `handleErrors` gets first refusal, and returning `null` delegates
+ * outward.  Placed around a `withMiddleware(...)` node it also catches
+ * that middleware's throws (e.g. an auth 401).
+ *
+ *     handleErrors(
+ *       (err) => err instanceof NotFoundError ? complete(Status.NotFound, ...) : null,
+ *       path('users', concat(...)),
+ *     )
+ */
+export function handleErrors(handler, child) {
+    const middleware = async (req, next) => {
+        try {
+            return await next();
+        }
+        catch (err) {
+            const recovered = await handler(err, req);
+            if (recovered !== null && recovered !== undefined)
+                return recovered;
+            throw err; // declined → escalate to the next enclosing handler / default
+        }
+    };
+    return { kind: 'middleware', middleware, child };
+}
+/**
+ * Answer any request that matched no other route — the server-global
+ * not-found handler expressed in the DSL.  Wired to the backend's
+ * not-found hook at bind time, so it is method-agnostic (it also answers
+ * unmatched OPTIONS/HEAD) and MUST sit at the root of the tree: a fallback
+ * scoped under `path()` / `pathPrefix()` is rejected at compile time,
+ * because a server has exactly one not-found handler.  At most one
+ * `fallback()` per server.  It still composes with
+ * `withMiddleware()` / `handleErrors()`, which wrap its handler like any
+ * other, so a fallback can carry security headers or its own recovery.
+ *
+ *     concat(
+ *       path('api', apiRoutes),
+ *       fallback((req) => completeJson(Status.NotFound, { error: 'no route', path: req.path })),
+ *     )
+ */
+export function fallback(handler) {
+    return { kind: 'fallback', handler };
+}
 function normalizeSegment(s) {
     const trimmed = s.replace(/^\/+|\/+$/g, '');
     return trimmed;
@@ -71,6 +124,19 @@ export function redirect(url, status = Status.Found) {
 export function reject(status, message, extra) {
     throw new HttpError(status, message, extra);
 }
+/**
+ * The framework's default error→response mapping: an {@link HttpError}
+ * becomes its status + `{ error, ...extra }` JSON (carrying any custom
+ * `headers`); anything else becomes a generic 500 that deliberately does
+ * NOT echo the thrown message.  Kept in one place so the WebSocket
+ * upgrade-reject path and the `fallback()` wrapper map errors identically.
+ */
+export function defaultErrorResponse(err) {
+    if (err instanceof HttpError) {
+        return { status: err.status, headers: err.headers, body: { error: err.message, ...(err.extra ?? {}) } };
+    }
+    return { status: Status.InternalServerError, body: { error: 'Internal Server Error' } };
+}
 /* ------------------------------- Compilation ----------------------------- */
 /**
  * Sentinel returned by a WS route's inner `authorize` to mean "proceed
@@ -88,17 +154,32 @@ export function compile(route, prefix = []) {
             pattern: buildPattern(prefix),
             handler: r.handler,
         }])
-        .with({ kind: 'websocket' }, (r) => [{
-            kind: 'websocket',
-            method: 'GET',
-            pattern: buildPattern(prefix),
-            connect: r.connect,
-            // Innermost default: accept unconditionally.  Enclosing
-            // withMiddleware() nodes fold their checks into this below.
-            authorize: async () => null,
-        }])
+        .with({ kind: 'websocket' }, (r) => {
+        // Innermost gate: a route-level upgrade check (the CSWSH Origin
+        // allowlist from `websocket({ allowedOrigins })`) if the node
+        // carries one, else accept unconditionally.  Enclosing
+        // withMiddleware() nodes fold their checks around this below.
+        const gate = r.authorize;
+        return [{
+                kind: 'websocket',
+                method: 'GET',
+                pattern: buildPattern(prefix),
+                connect: r.connect,
+                authorize: gate
+                    ? async (req) => gate(req)
+                    : async () => null,
+            }];
+    })
         .with({ kind: 'path' }, (r) => compile(r.child, [...prefix, r.segment]))
         .with({ kind: 'concat' }, (r) => r.routes.flatMap((child) => compile(child, prefix)))
+        .with({ kind: 'fallback' }, (r) => {
+        if (prefix.length > 0) {
+            throw new Error('fallback() must sit at the root of the route tree — the not-found '
+                + 'handler is server-global, so a fallback scoped under path()/'
+                + 'pathPrefix() is not supported.');
+        }
+        return [{ kind: 'fallback', handler: r.handler }];
+    })
         .with({ kind: 'middleware' }, (r) => {
         // Compile the subtree, then fold the middleware in.  For HTTP
         // children it wraps the handler (nested middlewares stack
@@ -108,29 +189,36 @@ export function compile(route, prefix = []) {
             if (c.kind === 'http') {
                 return { ...c, handler: wrapHandler(r.middleware, c.handler) };
             }
+            if (c.kind === 'fallback') {
+                // A fallback under middleware: wrap its handler the same way
+                // (the fallback stays root-scoped — middleware doesn't add a
+                // path prefix, so the compile-time root guard still holds).
+                return { ...c, handler: wrapHandler(r.middleware, c.handler) };
+            }
             const inner = c.authorize;
             const authorize = async (req) => {
                 try {
-                    const res = await r.middleware(req, async () => (await inner(req)) ?? WS_ACCEPT);
+                    const res = await r.middleware(req, async (override) => (await inner(override ?? req)) ?? WS_ACCEPT);
                     // Identity: middleware passed the sentinel through → accept.
                     // Any other response (short-circuit or transform) → reject.
                     return res === WS_ACCEPT ? null : res;
                 }
                 catch (err) {
-                    if (err instanceof HttpError) {
-                        return { status: err.status, body: { error: err.message, ...(err.extra ?? {}) } };
-                    }
-                    return { status: Status.InternalServerError, body: { error: 'Internal Server Error' } };
+                    return defaultErrorResponse(err);
                 }
             };
             return { ...c, authorize };
         });
     })
+        .with({ kind: 'cors' }, (r) => expandCors(compile(r.child, prefix), r.settings))
         .exhaustive();
 }
 function wrapHandler(middleware, handler) {
     return async (req) => {
-        const next = async () => Promise.resolve(handler(req));
+        // `next(override?)` lets a middleware replace the request the handler
+        // (and any inner middleware) sees — the override threads through the
+        // stacked wraps because each wrap's `handler` is the next-inner one.
+        const next = async (override) => Promise.resolve(handler(override ?? req));
         return Promise.resolve(middleware(req, next));
     };
 }
@@ -149,18 +237,18 @@ function buildPattern(segments) {
  * params (e.g. `?x=1&x=2`) return the first value.
  */
 export function queryParam(req, name) {
-    const v = req.query[name];
-    if (v === undefined)
+    const value = req.query[name];
+    if (value === undefined)
         return undefined;
-    if (Array.isArray(v))
-        return v[0];
-    return v;
+    if (Array.isArray(value))
+        return value[0];
+    return value;
 }
 /** Extract a path parameter (guaranteed present by the pattern). */
 export function pathParam(req, name) {
-    const v = req.params[name];
-    if (v === undefined)
+    const value = req.params[name];
+    if (value === undefined)
         throw new HttpError(500, `Missing path parameter "${name}"`);
-    return v;
+    return value;
 }
 //# sourceMappingURL=Route.js.map

package/dist/http/Route.js.map

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

package/dist/http/backend/ExpressBackend.d.ts

@@ -1,7 +1,7 @@
 import type { Server } from 'node:http';
 import { type HttpRequest, type HttpResponse } from '../types.js';
 import type { ExpressBackendOptions } from './ExpressBackendOptions.js';
-import type { HttpServerBackend, RouteRegistration, ServerBinding, WebSocketRouteRegistration } from './HttpServerBackend.js';
+import type { HttpServerBackend, RouteRegistration, ServerBinding, WebsocketRouteRegistration } from './HttpServerBackend.js';
 /** Minimal shape of the Express Request we rely on. */
 interface ExpressRequestLike {
     method: string;
@@ -33,15 +33,20 @@ interface ExpressResponseLike {
 type ExpressNext = (err?: unknown) => void;
 type ExpressHandler = (req: ExpressRequestLike, res: ExpressResponseLike, next: ExpressNext) => void | Promise<void>;
 type ExpressErrorHandler = (err: unknown, req: ExpressRequestLike, res: ExpressResponseLike, next: ExpressNext) => void | Promise<void>;
-/** Subset of the Express app API we touch.  Covers v4 and v5. */
+/**
+ * Subset of the Express app API we touch.  Covers v4 and v5.  Paths accept
+ * a RegExp as well as a string: a trailing-`*` wildcard route registers as
+ * a RegExp so it works identically on Express 4 and 5 (v5's path-to-regexp
+ * rejects a bare string `*`).
+ */
 export interface ExpressAppLike {
-    get(path: string, handler: ExpressHandler): void;
-    post(path: string, handler: ExpressHandler): void;
-    put(path: string, handler: ExpressHandler): void;
-    delete(path: string, handler: ExpressHandler): void;
-    patch(path: string, handler: ExpressHandler): void;
-    head(path: string, handler: ExpressHandler): void;
-    options(path: string, handler: ExpressHandler): void;
+    get(path: string | RegExp, handler: ExpressHandler): void;
+    post(path: string | RegExp, handler: ExpressHandler): void;
+    put(path: string | RegExp, handler: ExpressHandler): void;
+    delete(path: string | RegExp, handler: ExpressHandler): void;
+    patch(path: string | RegExp, handler: ExpressHandler): void;
+    head(path: string | RegExp, handler: ExpressHandler): void;
+    options(path: string | RegExp, handler: ExpressHandler): void;
     use(mw: ExpressHandler | ExpressErrorHandler): void;
     listen(port: number, hostname: string, cb: (err?: Error) => void): Server;
 }
@@ -69,7 +74,7 @@ export declare class ExpressBackend implements HttpServerBackend {
     /** Inject / access the underlying Express app — useful for native middleware. */
     getApp(): ExpressAppLike;
     registerRoute(route: RouteRegistration): void;
-    registerWebSocket(reg: WebSocketRouteRegistration): void;
+    registerWebSocket(reg: WebsocketRouteRegistration): void;
     setNotFound(handler: (req: HttpRequest) => Promise<HttpResponse> | HttpResponse): void;
     setErrorHandler(handler: (err: unknown, req: HttpRequest) => Promise<HttpResponse> | HttpResponse): void;
     listen(host: string, port: number): Promise<ServerBinding>;

package/dist/http/backend/ExpressBackend.d.ts.map

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