@zudojs/errors 1.3.1 → 1.4.0

package/dist/infrastructure/cache/index.js

@@ -4,4 +4,3 @@
  * Error classes and helpers for cache subsystem failures.
  */
 export * from "./cache.error.js";
-//# sourceMappingURL=index.js.map

package/dist/infrastructure/container/container.error.d.ts

@@ -4,4 +4,3 @@
 export { ContainerError, createContainerError, isContainerError, } from "./containerError.base.js";
 export type { ContainerErrorOptions } from "./containerError.base.js";
 export { DuplicateRegistrationError, RegistrationNotFoundError, CircularDependencyError, ProviderResolutionError, ContainerLifecycleError, } from "./containerError.registration.js";
-//# sourceMappingURL=container.error.d.ts.map

package/dist/infrastructure/container/container.error.js

@@ -3,4 +3,3 @@
  */
 export { ContainerError, createContainerError, isContainerError, } from "./containerError.base.js";
 export { DuplicateRegistrationError, RegistrationNotFoundError, CircularDependencyError, ProviderResolutionError, ContainerLifecycleError, } from "./containerError.registration.js";
-//# sourceMappingURL=container.error.js.map

package/dist/infrastructure/container/containerError.base.d.ts

@@ -33,4 +33,3 @@ export declare class ContainerError extends BaseError {
 export declare function createContainerError(message: string, options?: ContainerErrorOptions): ContainerError;
 /** Determines whether an unknown value is a ContainerError. */
 export declare function isContainerError(value: unknown): value is ContainerError;
-//# sourceMappingURL=containerError.base.d.ts.map

package/dist/infrastructure/container/containerError.base.js

@@ -35,4 +35,3 @@ export function createContainerError(message, options = {}) {
 export function isContainerError(value) {
     return value instanceof ContainerError;
 }
-//# sourceMappingURL=containerError.base.js.map

package/dist/infrastructure/container/containerError.registration.d.ts

@@ -90,4 +90,3 @@ export declare class ContainerLifecycleError extends ContainerError {
         phase: string;
     };
 }
-//# sourceMappingURL=containerError.registration.d.ts.map

package/dist/infrastructure/container/containerError.registration.js

@@ -91,4 +91,3 @@ export class ContainerLifecycleError extends ContainerError {
         return { ...super.toJSON(), phase: this.phase };
     }
 }
-//# sourceMappingURL=containerError.registration.js.map

package/dist/infrastructure/container/index.d.ts

@@ -4,4 +4,3 @@
  * Container and dependency injection error types.
  */
 export * from "./container.error.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/container/index.js

@@ -4,4 +4,3 @@
  * Container and dependency injection error types.
  */
 export * from "./container.error.js";
-//# sourceMappingURL=index.js.map

package/dist/infrastructure/httpPipeline/httpMiddleware.error.d.ts

@@ -23,4 +23,3 @@ export declare class HttpMiddlewarePipelineError extends BaseError {
     readonly errors: readonly HttpMiddlewareError[];
     constructor(errors: readonly HttpMiddlewareError[]);
 }
-//# sourceMappingURL=httpMiddleware.error.d.ts.map

package/dist/infrastructure/httpPipeline/httpMiddleware.error.js

@@ -40,4 +40,3 @@ export class HttpMiddlewarePipelineError extends BaseError {
         this.errors = Object.freeze([...errors]);
     }
 }
-//# sourceMappingURL=httpMiddleware.error.js.map

package/dist/infrastructure/httpPipeline/httpRequestGuard.error.d.ts

@@ -18,4 +18,3 @@ export declare class HttpRequestGuardError extends BaseError {
     readonly errors: readonly string[];
     constructor(result: HttpRequestGuardRejection);
 }
-//# sourceMappingURL=httpRequestGuard.error.d.ts.map

package/dist/infrastructure/httpPipeline/httpRequestGuard.error.js

@@ -25,4 +25,3 @@ export class HttpRequestGuardError extends BaseError {
         this.errors = Object.freeze(errors);
     }
 }
-//# sourceMappingURL=httpRequestGuard.error.js.map

package/dist/infrastructure/httpPipeline/index.d.ts

@@ -5,4 +5,3 @@
  */
 export * from "./httpMiddleware.error.js";
 export * from "./httpRequestGuard.error.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/httpPipeline/index.js

@@ -5,4 +5,3 @@
  */
 export * from "./httpMiddleware.error.js";
 export * from "./httpRequestGuard.error.js";
-//# sourceMappingURL=index.js.map

package/dist/infrastructure/index.d.ts

@@ -11,4 +11,3 @@ export * from "./cache/index.js";
 export * from "./middleware/index.js";
 export * from "./adapter/index.js";
 export * from "./httpPipeline/index.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/index.js

@@ -11,4 +11,3 @@ export * from "./cache/index.js";
 export * from "./middleware/index.js";
 export * from "./adapter/index.js";
 export * from "./httpPipeline/index.js";
-//# sourceMappingURL=index.js.map

package/dist/infrastructure/middleware/index.d.ts

@@ -5,4 +5,3 @@
  */
 export * from "./middleware.error.js";
 export * from "./middlewareError.types.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/middleware/index.js

@@ -5,4 +5,3 @@
  */
 export * from "./middleware.error.js";
 export * from "./middlewareError.types.js";
-//# sourceMappingURL=index.js.map

package/dist/infrastructure/middleware/middleware.error.d.ts

@@ -51,4 +51,3 @@ export declare class MiddlewareTimeoutError extends MiddlewareError {
 export declare class MiddlewareNextCalledMultipleTimesError extends MiddlewareError {
     constructor(middlewareName: string);
 }
-//# sourceMappingURL=middleware.error.d.ts.map

package/dist/infrastructure/middleware/middleware.error.js

@@ -48,9 +48,12 @@ export function isMiddlewareError(value) {
 export class MiddlewareTimeoutError extends MiddlewareError {
     timeoutMs;
     constructor(middlewareName, timeoutMs) {
+        // A middleware that ran out of time is a gateway timeout to the client
+        // (504), not an internal error (500). Message and code stay internal.
         super(`Middleware "${middlewareName}" timed out after ${timeoutMs}ms.`, {
             code: ErrorCode.MIDDLEWARE_TIMEOUT,
             middlewareName,
+            statusCode: 504,
             metadata: { timeoutMs },
         });
         this.timeoutMs = timeoutMs;
@@ -68,4 +71,3 @@ export class MiddlewareNextCalledMultipleTimesError extends MiddlewareError {
         });
     }
 }
-//# sourceMappingURL=middleware.error.js.map

package/dist/infrastructure/middleware/middlewareError.types.d.ts

@@ -12,17 +12,22 @@ export declare class MiddlewareDepthExceededError extends MiddlewareError {
     constructor(maxDepth: number);
 }
 /**
- * Error thrown when a rate limit is exceeded. `retryAfterMs` feeds a
- * `Retry-After` header.
+ * Error thrown when a rate limit is exceeded.
+ *
+ * Reaches HTTP clients as a 429 with `ERR_RATE_LIMITED`, an exposed message
+ * and a `Retry-After` header (`headers`), which `@zudojs/http` copies onto
+ * the response. It used to be a generic, unexposed 500 with the middleware
+ * execution code, so the documented 429 never happened.
  */
 export declare class MiddlewareRateLimitError extends MiddlewareError {
     readonly retryAfterMs: number;
     readonly limit: number;
     readonly windowMs: number;
+    /** Response headers for an HTTP adapter: `retry-after` in whole seconds. */
+    readonly headers: Readonly<Record<string, string>>;
     constructor(limit: number, windowMs: number, retryAfterMs: number);
 }
 /** Error thrown when a pipeline is aborted through its `AbortSignal`. */
 export declare class MiddlewareAbortedError extends MiddlewareError {
     constructor(reason?: unknown);
 }
-//# sourceMappingURL=middlewareError.types.d.ts.map

package/dist/infrastructure/middleware/middlewareError.types.js

@@ -2,7 +2,18 @@
  * Pipeline-guard middleware errors. Constructors and defaults match the
  * wrappers `@zudojs/middleware` defines over the shared `MiddlewareError`.
  */
+import { ErrorCode } from "../../base/types/errorCode.type.js";
+import { ErrorSeverity } from "../../base/types/errorSeverity.type.js";
 import { MiddlewareError } from "./middleware.error.js";
+/**
+ * `Retry-After` in whole seconds, never below 1: a client told to retry
+ * after 0 seconds retries immediately and is refused again.
+ */
+function retryAfterSeconds(retryAfterMs) {
+    if (!Number.isFinite(retryAfterMs) || retryAfterMs <= 0)
+        return 1;
+    return Math.max(1, Math.ceil(retryAfterMs / 1000));
+}
 /** Error thrown when a pipeline is configured with more middleware than allowed. */
 export class MiddlewareLimitExceededError extends MiddlewareError {
     constructor(count, maximum) {
@@ -18,21 +29,34 @@ export class MiddlewareDepthExceededError extends MiddlewareError {
     }
 }
 /**
- * Error thrown when a rate limit is exceeded. `retryAfterMs` feeds a
- * `Retry-After` header.
+ * Error thrown when a rate limit is exceeded.
+ *
+ * Reaches HTTP clients as a 429 with `ERR_RATE_LIMITED`, an exposed message
+ * and a `Retry-After` header (`headers`), which `@zudojs/http` copies onto
+ * the response. It used to be a generic, unexposed 500 with the middleware
+ * execution code, so the documented 429 never happened.
  */
 export class MiddlewareRateLimitError extends MiddlewareError {
     retryAfterMs;
     limit;
     windowMs;
+    /** Response headers for an HTTP adapter: `retry-after` in whole seconds. */
+    headers;
     constructor(limit, windowMs, retryAfterMs) {
         super(`Rate limit exceeded: ${limit} requests per ${windowMs}ms`, {
             middlewareName: "rate-limit",
-            metadata: { middlewareName: "rate-limit" },
+            code: ErrorCode.RATE_LIMITED,
+            statusCode: 429,
+            expose: true,
+            severity: ErrorSeverity.WARNING,
+            metadata: { middlewareName: "rate-limit", limit, windowMs, retryAfterMs },
         });
         this.retryAfterMs = retryAfterMs;
         this.limit = limit;
         this.windowMs = windowMs;
+        this.headers = Object.freeze({
+            "retry-after": String(retryAfterSeconds(retryAfterMs)),
+        });
     }
 }
 /** Error thrown when a pipeline is aborted through its `AbortSignal`. */
@@ -41,4 +65,3 @@ export class MiddlewareAbortedError extends MiddlewareError {
         super("Middleware pipeline aborted", { cause: reason });
     }
 }
-//# sourceMappingURL=middlewareError.types.js.map

package/dist/infrastructure/network/http.error.d.ts

@@ -3,4 +3,3 @@
  */
 export * from "./httpError.base.js";
 export * from "./httpError.helpers.js";
-//# sourceMappingURL=http.error.d.ts.map

package/dist/infrastructure/network/http.error.js

@@ -3,4 +3,3 @@
  */
 export * from "./httpError.base.js";
 export * from "./httpError.helpers.js";
-//# sourceMappingURL=http.error.js.map

package/dist/infrastructure/network/httpAdapter.error.d.ts

@@ -40,4 +40,3 @@ export declare function createHttpAdapterError(message: string, options?: HttpAd
  * Determines whether an unknown value is an HttpAdapterError.
  */
 export declare function isHttpAdapterError(value: unknown): value is HttpAdapterError;
-//# sourceMappingURL=httpAdapter.error.d.ts.map

package/dist/infrastructure/network/httpAdapter.error.js

@@ -62,4 +62,3 @@ export function createHttpAdapterError(message, options = {}) {
 export function isHttpAdapterError(value) {
     return value instanceof HttpAdapterError;
 }
-//# sourceMappingURL=httpAdapter.error.js.map

package/dist/infrastructure/network/httpClient.errors.d.ts

@@ -3,4 +3,3 @@
  */
 export * from "./httpClientError.base.js";
 export * from "./httpClientError.types.js";
-//# sourceMappingURL=httpClient.errors.d.ts.map

package/dist/infrastructure/network/httpClient.errors.js

@@ -3,4 +3,3 @@
  */
 export * from "./httpClientError.base.js";
 export * from "./httpClientError.types.js";
-//# sourceMappingURL=httpClient.errors.js.map

package/dist/infrastructure/network/httpClientError.advanced.d.ts

@@ -39,4 +39,3 @@ export declare class RequestHeaderFieldsTooLargeError extends HttpError {
 export declare class RequestAbortedError extends HttpError {
     constructor(message?: string, options?: HttpClientErrorOptions);
 }
-//# sourceMappingURL=httpClientError.advanced.d.ts.map

package/dist/infrastructure/network/httpClientError.advanced.js

@@ -93,4 +93,3 @@ export class RequestAbortedError extends HttpError {
         });
     }
 }
-//# sourceMappingURL=httpClientError.advanced.js.map

package/dist/infrastructure/network/httpClientError.base.d.ts

@@ -46,4 +46,3 @@ export declare class HttpClientError extends BaseError {
 export declare function mapUpstreamStatus(status: number | undefined): number;
 /** Removes credentials and the query string from a URL before storing it. */
 export declare function stripUrlCredentials(url: string): string;
-//# sourceMappingURL=httpClientError.base.d.ts.map

package/dist/infrastructure/network/httpClientError.base.js

@@ -81,4 +81,3 @@ export function stripUrlCredentials(url) {
         return withoutQuery.replace(/\/\/[^/@]*@/, "//");
     }
 }
-//# sourceMappingURL=httpClientError.base.js.map

package/dist/infrastructure/network/httpClientError.common.d.ts

@@ -78,4 +78,3 @@ export declare class RangeNotSatisfiableError extends HttpError {
 export declare class ExpectationFailedError extends HttpError {
     constructor(message?: string, options?: HttpClientErrorOptions);
 }
-//# sourceMappingURL=httpClientError.common.d.ts.map

package/dist/infrastructure/network/httpClientError.common.js

@@ -159,4 +159,3 @@ export class ExpectationFailedError extends HttpError {
         });
     }
 }
-//# sourceMappingURL=httpClientError.common.js.map

package/dist/infrastructure/network/httpClientError.error.d.ts

@@ -5,4 +5,3 @@ export type { HttpClientErrorOptions } from "./httpClientError.options.js";
 export { BadRequestError, UnauthorizedError, ForbiddenError, HttpNotFoundError, MethodNotAllowedError, NotAcceptableError, RequestTimeoutError, HttpConflictError, GoneError, LengthRequiredError, PayloadTooLargeError, URITooLongError, UnsupportedMediaTypeError, RangeNotSatisfiableError, ExpectationFailedError, } from "./httpClientError.common.js";
 export { UnprocessableEntityError, LockedError, FailedDependencyError, TooEarlyError, UpgradeRequiredError, PreconditionRequiredError, TooManyRequestsError, RequestHeaderFieldsTooLargeError, RequestAbortedError, } from "./httpClientError.advanced.js";
 export { RequestBodyTimeoutError, UnsupportedProtocolError, InvalidHeaderError, InvalidContentTypeError, } from "./httpClientError.specialized.js";
-//# sourceMappingURL=httpClientError.error.d.ts.map

package/dist/infrastructure/network/httpClientError.error.js

@@ -4,4 +4,3 @@
 export { BadRequestError, UnauthorizedError, ForbiddenError, HttpNotFoundError, MethodNotAllowedError, NotAcceptableError, RequestTimeoutError, HttpConflictError, GoneError, LengthRequiredError, PayloadTooLargeError, URITooLongError, UnsupportedMediaTypeError, RangeNotSatisfiableError, ExpectationFailedError, } from "./httpClientError.common.js";
 export { UnprocessableEntityError, LockedError, FailedDependencyError, TooEarlyError, UpgradeRequiredError, PreconditionRequiredError, TooManyRequestsError, RequestHeaderFieldsTooLargeError, RequestAbortedError, } from "./httpClientError.advanced.js";
 export { RequestBodyTimeoutError, UnsupportedProtocolError, InvalidHeaderError, InvalidContentTypeError, } from "./httpClientError.specialized.js";
-//# sourceMappingURL=httpClientError.error.js.map

package/dist/infrastructure/network/httpClientError.options.d.ts

@@ -8,4 +8,3 @@ export interface HttpClientErrorOptions {
     readonly expose?: boolean;
     readonly metadata?: ErrorMetadata;
 }
-//# sourceMappingURL=httpClientError.options.d.ts.map

package/dist/infrastructure/network/httpClientError.options.js

@@ -2,4 +2,3 @@
  * Options for creating HTTP client errors.
  */
 export {};
-//# sourceMappingURL=httpClientError.options.js.map

package/dist/infrastructure/network/httpClientError.specialized.d.ts

@@ -22,4 +22,3 @@ export declare class InvalidContentTypeError extends HttpError {
     readonly contentType: string | undefined;
     constructor(contentType?: string, options?: HttpClientErrorOptions);
 }
-//# sourceMappingURL=httpClientError.specialized.d.ts.map

package/dist/infrastructure/network/httpClientError.specialized.js

@@ -50,4 +50,3 @@ export class InvalidContentTypeError extends HttpError {
         this.contentType = contentType;
     }
 }
-//# sourceMappingURL=httpClientError.specialized.js.map

package/dist/infrastructure/network/httpClientError.types.d.ts

@@ -48,4 +48,3 @@ export declare class HttpClientAbortError extends HttpClientError {
 export declare class HttpClientNetworkError extends HttpClientError {
     constructor(message: string, request?: Request | HttpClientClientErrorOptions, cause?: unknown, options?: HttpClientClientErrorOptions);
 }
-//# sourceMappingURL=httpClientError.types.d.ts.map

package/dist/infrastructure/network/httpClientError.types.js

@@ -93,4 +93,3 @@ function describeSystemError(cause) {
     }
     return result;
 }
-//# sourceMappingURL=httpClientError.types.js.map

package/dist/infrastructure/network/httpError.base.d.ts

@@ -19,4 +19,3 @@ export declare class HttpError extends BaseError {
 export declare function createHttpError(message: string, statusCode: number, options?: Omit<HttpErrorOptions, "statusCode">): HttpError;
 /** Determines whether an unknown value is an HttpError. */
 export declare function isHttpError(value: unknown): value is HttpError;
-//# sourceMappingURL=httpError.base.d.ts.map

package/dist/infrastructure/network/httpError.base.js

@@ -37,4 +37,3 @@ function inferSeverity(statusCode) {
         return ErrorSeverity.WARNING;
     return ErrorSeverity.INFO;
 }
-//# sourceMappingURL=httpError.base.js.map

package/dist/infrastructure/network/httpError.helpers.d.ts

@@ -9,4 +9,3 @@ export declare function isHttpRedirectStatus(statusCode: number): boolean;
 export declare function isHttpClientErrorStatus(statusCode: number): boolean;
 /** Returns whether a status code represents a server error. */
 export declare function isHttpServerErrorStatus(statusCode: number): boolean;
-//# sourceMappingURL=httpError.helpers.d.ts.map

package/dist/infrastructure/network/httpError.helpers.js

@@ -17,4 +17,3 @@ export function isHttpClientErrorStatus(statusCode) {
 export function isHttpServerErrorStatus(statusCode) {
     return statusCode >= 500 && statusCode < 600;
 }
-//# sourceMappingURL=httpError.helpers.js.map

package/dist/infrastructure/network/httpResponse.error.d.ts

@@ -33,4 +33,3 @@ export declare function createHttpResponseWriterError(message: string, options?:
  * Determines whether an unknown value is an HttpResponseWriterError.
  */
 export declare function isHttpResponseWriterError(value: unknown): value is HttpResponseWriterError;
-//# sourceMappingURL=httpResponse.error.d.ts.map

package/dist/infrastructure/network/httpResponse.error.js

@@ -49,4 +49,3 @@ export function createHttpResponseWriterError(message, options = {}) {
 export function isHttpResponseWriterError(value) {
     return value instanceof HttpResponseWriterError;
 }
-//# sourceMappingURL=httpResponse.error.js.map

package/dist/infrastructure/network/httpRouter.error.d.ts

@@ -3,4 +3,3 @@
  */
 export * from "./httpRouterError.base.js";
 export * from "./httpRouterError.types.js";
-//# sourceMappingURL=httpRouter.error.d.ts.map

package/dist/infrastructure/network/httpRouter.error.js

@@ -3,4 +3,3 @@
  */
 export * from "./httpRouterError.base.js";
 export * from "./httpRouterError.types.js";
-//# sourceMappingURL=httpRouter.error.js.map

package/dist/infrastructure/network/httpRouterError.base.d.ts

@@ -17,4 +17,3 @@ export declare class HttpRouterError extends BaseError {
 export declare function createHttpRouterError(message: string, options?: HttpRouterErrorOptions): HttpRouterError;
 /** Determines whether an unknown value is an HttpRouterError. */
 export declare function isHttpRouterError(value: unknown): value is HttpRouterError;
-//# sourceMappingURL=httpRouterError.base.d.ts.map

package/dist/infrastructure/network/httpRouterError.base.js

@@ -25,4 +25,3 @@ export function createHttpRouterError(message, options = {}) {
 export function isHttpRouterError(value) {
     return value instanceof HttpRouterError;
 }
-//# sourceMappingURL=httpRouterError.base.js.map

package/dist/infrastructure/network/httpRouterError.types.d.ts

@@ -1,14 +1,35 @@
 import { RoutePatternError } from "./routePattern.error.js";
 import { HttpRouterError } from "./httpRouterError.base.js";
+/** Options for {@link RouteConflictError}. */
+export interface RouteConflictErrorOptions {
+    /**
+     * Replaces the default "A route for METHOD /path is already registered."
+     * message entirely, for a conflict that is not a duplicate registration.
+     */
+    readonly message?: string;
+    /**
+     * Why the route conflicts, e.g. `"shadowed by GET /users/:id"`. Recorded
+     * in `metadata.reason` and, unless `message` is given, reported as
+     * "A route for METHOD /path conflicts with an existing route: <reason>".
+     */
+    readonly reason?: string;
+    readonly cause?: unknown;
+}
 /**
  * Error thrown when a route conflicts with an existing route.
+ *
+ * The default message describes a duplicate registration; pass `reason` or
+ * `message` for other conflicts (an unreachable route shadowed by an earlier
+ * pattern, say). The code stays `ERR_HTTP_ROUTE_CONFLICT` either way.
  */
 export declare class RouteConflictError extends HttpRouterError {
     /** The route path that conflicts. */
     readonly path: string;
     /** The HTTP method that conflicts. */
     readonly method: string;
-    constructor(path: string, method: string);
+    /** Why the route conflicts, when the caller said. */
+    readonly reason?: string;
+    constructor(path: string, method: string, options?: RouteConflictErrorOptions);
 }
 /**
  * Error thrown when a route pattern is invalid.
@@ -19,4 +40,3 @@ export declare class RouteConflictError extends HttpRouterError {
 export declare class InvalidRoutePatternError extends RoutePatternError {
     constructor(pattern: string, message: string);
 }
-//# sourceMappingURL=httpRouterError.types.d.ts.map

package/dist/infrastructure/network/httpRouterError.types.js

@@ -3,20 +3,41 @@ import { RoutePatternError } from "./routePattern.error.js";
 import { HttpRouterError } from "./httpRouterError.base.js";
 /**
  * Error thrown when a route conflicts with an existing route.
+ *
+ * The default message describes a duplicate registration; pass `reason` or
+ * `message` for other conflicts (an unreachable route shadowed by an earlier
+ * pattern, say). The code stays `ERR_HTTP_ROUTE_CONFLICT` either way.
  */
 export class RouteConflictError extends HttpRouterError {
     /** The route path that conflicts. */
     path;
     /** The HTTP method that conflicts. */
     method;
-    constructor(path, method) {
-        super(`A route for ${method} ${path} is already registered.`, {
+    /** Why the route conflicts, when the caller said. */
+    reason;
+    constructor(path, method, options = {}) {
+        super(conflictMessage(path, method, options), {
             code: ErrorCode.HTTP_ROUTE_CONFLICT,
-            metadata: { path, method },
+            metadata: {
+                path,
+                method,
+                ...(options.reason !== undefined ? { reason: options.reason } : {}),
+            },
+            ...(options.cause !== undefined ? { cause: options.cause } : {}),
         });
         this.path = path;
         this.method = method;
+        this.reason = options.reason;
+    }
+}
+/** Builds the RouteConflictError message from the caller's options. */
+function conflictMessage(path, method, options) {
+    if (options.message !== undefined)
+        return options.message;
+    if (options.reason !== undefined) {
+        return `A route for ${method} ${path} conflicts with an existing route: ${options.reason}`;
     }
+    return `A route for ${method} ${path} is already registered.`;
 }
 /**
  * Error thrown when a route pattern is invalid.
@@ -32,4 +53,3 @@ export class InvalidRoutePatternError extends RoutePatternError {
         });
     }
 }
-//# sourceMappingURL=httpRouterError.types.js.map

package/dist/infrastructure/network/httpServerError.error.d.ts

@@ -36,6 +36,13 @@ export declare class BadGatewayError extends HttpError {
 }
 /**
  * 503 Service Unavailable
+ *
+ * Unlike the other 5xx classes this one exposes its message by default: 503
+ * is the status a service sends on purpose (maintenance, overload, a
+ * dependency down), and its message ("Back at 03:00 UTC") is written for the
+ * client, as it is for `APIUnavailableError` and `RPCUnavailableError`. Pass
+ * `expose: false` for a message that must stay internal. Metadata is not
+ * exposed by `expose` alone (see `ErrorSerializerOptions.exposeMetadata`).
  */
 export declare class ServiceUnavailableError extends HttpError {
     constructor(message?: string, options?: HttpServerErrorOptions);
@@ -46,4 +53,3 @@ export declare class ServiceUnavailableError extends HttpError {
 export declare class GatewayTimeoutError extends HttpError {
     constructor(message?: string, options?: HttpServerErrorOptions);
 }
-//# sourceMappingURL=httpServerError.error.d.ts.map

package/dist/infrastructure/network/httpServerError.error.js

@@ -48,6 +48,13 @@ export class BadGatewayError extends HttpError {
 }
 /**
  * 503 Service Unavailable
+ *
+ * Unlike the other 5xx classes this one exposes its message by default: 503
+ * is the status a service sends on purpose (maintenance, overload, a
+ * dependency down), and its message ("Back at 03:00 UTC") is written for the
+ * client, as it is for `APIUnavailableError` and `RPCUnavailableError`. Pass
+ * `expose: false` for a message that must stay internal. Metadata is not
+ * exposed by `expose` alone (see `ErrorSerializerOptions.exposeMetadata`).
  */
 export class ServiceUnavailableError extends HttpError {
     constructor(message = "Service Unavailable", options = {}) {
@@ -55,7 +62,7 @@ export class ServiceUnavailableError extends HttpError {
             ...options,
             statusCode: 503,
             code: options.code ?? ErrorCode.HTTP_SERVICE_UNAVAILABLE,
-            expose: options.expose ?? false,
+            expose: options.expose ?? true,
         });
     }
 }
@@ -72,4 +79,3 @@ export class GatewayTimeoutError extends HttpError {
         });
     }
 }
-//# sourceMappingURL=httpServerError.error.js.map

package/dist/infrastructure/network/httpServerLifecycle.error.d.ts

@@ -3,4 +3,3 @@
  */
 export * from "./httpServerLifecycleError.base.js";
 export * from "./httpServerLifecycleError.types.js";
-//# sourceMappingURL=httpServerLifecycle.error.d.ts.map

package/dist/infrastructure/network/httpServerLifecycle.error.js

@@ -3,4 +3,3 @@
  */
 export * from "./httpServerLifecycleError.base.js";
 export * from "./httpServerLifecycleError.types.js";
-//# sourceMappingURL=httpServerLifecycle.error.js.map

package/dist/infrastructure/network/httpServerLifecycleError.base.d.ts

@@ -17,4 +17,3 @@ export declare class HttpServerLifecycleError extends BaseError {
 export declare function createHttpServerLifecycleError(message: string, options?: HttpServerLifecycleErrorOptions): HttpServerLifecycleError;
 /** Determines whether an unknown value is an HttpServerLifecycleError. */
 export declare function isHttpServerLifecycleError(value: unknown): value is HttpServerLifecycleError;
-//# sourceMappingURL=httpServerLifecycleError.base.d.ts.map

package/dist/infrastructure/network/httpServerLifecycleError.base.js

@@ -25,4 +25,3 @@ export function createHttpServerLifecycleError(message, options = {}) {
 export function isHttpServerLifecycleError(value) {
     return value instanceof HttpServerLifecycleError;
 }
-//# sourceMappingURL=httpServerLifecycleError.base.js.map

package/dist/infrastructure/network/httpServerLifecycleError.types.d.ts

@@ -19,4 +19,3 @@ export declare class HttpServerStartError extends HttpServerLifecycleError {
 export declare class HttpServerStopError extends HttpServerLifecycleError {
     constructor(message: string, cause?: unknown);
 }
-//# sourceMappingURL=httpServerLifecycleError.types.d.ts.map

package/dist/infrastructure/network/httpServerLifecycleError.types.js

@@ -36,4 +36,3 @@ export class HttpServerStopError extends HttpServerLifecycleError {
         });
     }
 }
-//# sourceMappingURL=httpServerLifecycleError.types.js.map

package/dist/infrastructure/network/httpStream.error.d.ts

@@ -21,4 +21,3 @@ export declare function createHttpStreamError(message: string, options?: HttpStr
  * Determines whether an unknown value is an HttpStreamError.
  */
 export declare function isHttpStreamError(value: unknown): value is HttpStreamError;
-//# sourceMappingURL=httpStream.error.d.ts.map

package/dist/infrastructure/network/httpStream.error.js

@@ -29,4 +29,3 @@ export function createHttpStreamError(message, options = {}) {
 export function isHttpStreamError(value) {
     return value instanceof HttpStreamError;
 }
-//# sourceMappingURL=httpStream.error.js.map

package/dist/infrastructure/network/index.d.ts

@@ -15,4 +15,3 @@ export * from "./httpServerLifecycle.error.js";
 export * from "./httpStream.error.js";
 export * from "./httpResponse.error.js";
 export * from "./routePattern.error.js";
-//# sourceMappingURL=index.d.ts.map