@zudojs/errors 1.3.2 → 1.4.0

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

package/dist/infrastructure/network/index.js

@@ -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.js.map

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

@@ -4,4 +4,3 @@
 export { NetworkError, createNetworkError, isNetworkError, } from "./networkError.base.js";
 export type { NetworkErrorOptions } from "./networkError.base.js";
 export { connectionFailedError, networkTimeoutError, networkServiceUnavailableError, } from "./networkError.factory.js";
-//# sourceMappingURL=network.error.d.ts.map

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

@@ -3,4 +3,3 @@
  */
 export { NetworkError, createNetworkError, isNetworkError, } from "./networkError.base.js";
 export { connectionFailedError, networkTimeoutError, networkServiceUnavailableError, } from "./networkError.factory.js";
-//# sourceMappingURL=network.error.js.map

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

@@ -42,4 +42,3 @@ export declare class NetworkError extends BaseError {
 export declare function createNetworkError(message?: string, options?: NetworkErrorOptions): NetworkError;
 /** Determines whether an unknown value is a NetworkError. */
 export declare function isNetworkError(value: unknown): value is NetworkError;
-//# sourceMappingURL=networkError.base.d.ts.map

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

@@ -59,4 +59,3 @@ export function createNetworkError(message = "A network operation failed.", opti
 export function isNetworkError(value) {
     return value instanceof NetworkError;
 }
-//# sourceMappingURL=networkError.base.js.map

package/dist/infrastructure/network/networkError.factory.d.ts

@@ -15,4 +15,3 @@ export declare function networkTimeoutError(service?: string, options?: Omit<Net
  * the name `networkServiceUnavailableError`.
  */
 export declare function networkServiceUnavailableError(service?: string, options?: Omit<NetworkErrorOptions, "service">): NetworkError;
-//# sourceMappingURL=networkError.factory.d.ts.map

package/dist/infrastructure/network/networkError.factory.js

@@ -41,4 +41,3 @@ export function networkServiceUnavailableError(service, options = {}) {
         service,
     });
 }
-//# sourceMappingURL=networkError.factory.js.map

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

@@ -42,4 +42,3 @@ export declare function createRoutePatternError(message: string, options?: Route
  * Determines whether an unknown value is a RoutePatternError.
  */
 export declare function isRoutePatternError(value: unknown): value is RoutePatternError;
-//# sourceMappingURL=routePattern.error.d.ts.map

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

@@ -68,4 +68,3 @@ export function createRoutePatternError(message, options = {}) {
 export function isRoutePatternError(value) {
     return value instanceof RoutePatternError;
 }
-//# sourceMappingURL=routePattern.error.js.map

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

@@ -4,4 +4,3 @@
 export { TimeoutError, createTimeoutError, isTimeoutError, TimeoutOperation, } from "./timeoutError.base.js";
 export type { TimeoutErrorOptions } from "./timeoutError.base.js";
 export { requestTimeoutError, databaseTimeoutError, serviceTimeoutError, lockTimeoutError, } from "./timeoutError.factory.js";
-//# sourceMappingURL=timeout.error.d.ts.map

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

@@ -3,4 +3,3 @@
  */
 export { TimeoutError, createTimeoutError, isTimeoutError, TimeoutOperation, } from "./timeoutError.base.js";
 export { requestTimeoutError, databaseTimeoutError, serviceTimeoutError, lockTimeoutError, } from "./timeoutError.factory.js";
-//# sourceMappingURL=timeout.error.js.map

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

@@ -58,4 +58,3 @@ export declare function isTimeoutError(value: unknown): value is TimeoutError;
  * resources and stay internal.
  */
 export declare function isPublicTimeoutOperation(operation: TimeoutOperation | undefined): boolean;
-//# sourceMappingURL=timeoutError.base.d.ts.map

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

@@ -85,4 +85,3 @@ function validateTimeout(timeoutMs) {
         throw new RangeError("timeoutMs must be a finite non-negative number.");
     }
 }
-//# sourceMappingURL=timeoutError.base.js.map

package/dist/infrastructure/network/timeoutError.factory.d.ts

@@ -24,4 +24,3 @@ export declare function serviceTimeoutError(target?: string, timeoutMs?: number)
 /** Creates a lock acquisition timeout error. */
 export declare function lockTimeoutError(options?: TimeoutFactoryOptions): TimeoutError;
 export declare function lockTimeoutError(target?: string, timeoutMs?: number): TimeoutError;
-//# sourceMappingURL=timeoutError.factory.d.ts.map

package/dist/infrastructure/network/timeoutError.factory.js

@@ -58,4 +58,3 @@ export function lockTimeoutError(first, second) {
         statusCode: 409,
     });
 }
-//# sourceMappingURL=timeoutError.factory.js.map

package/dist/infrastructure/service/externalService.error.d.ts

@@ -4,4 +4,3 @@
 export { ExternalServiceError, createExternalServiceError, isExternalServiceError, } from "./externalServiceError.base.js";
 export type { ExternalServiceErrorOptions } from "./externalServiceError.base.js";
 export { externalServiceTimeoutError, externalServiceUnavailable, externalServiceUnavailableError, } from "./externalServiceError.factory.js";
-//# sourceMappingURL=externalService.error.d.ts.map

package/dist/infrastructure/service/externalService.error.js

@@ -3,4 +3,3 @@
  */
 export { ExternalServiceError, createExternalServiceError, isExternalServiceError, } from "./externalServiceError.base.js";
 export { externalServiceTimeoutError, externalServiceUnavailable, externalServiceUnavailableError, } from "./externalServiceError.factory.js";
-//# sourceMappingURL=externalService.error.js.map

package/dist/infrastructure/service/externalServiceError.base.d.ts

@@ -13,13 +13,20 @@ export interface ExternalServiceErrorOptions extends Omit<BaseErrorOptions, "cat
     readonly responseStatus?: number;
     readonly serviceCode?: string | number;
 }
-/** Error raised when an external dependency fails. */
+/**
+ * Error raised when an external dependency fails.
+ *
+ * `options.service` is required by the type. A JavaScript caller (or a
+ * `catch` block re-throwing with only a message) that omits the options
+ * object gets `service: "unknown"` rather than a `TypeError` thrown from
+ * inside the error constructor, which hid the failure it was reporting.
+ */
 export declare class ExternalServiceError extends BaseError {
     readonly service: string;
     readonly operation?: string;
     readonly responseStatus?: number;
     readonly serviceCode?: string | number;
-    constructor(message: string | undefined, options: ExternalServiceErrorOptions);
+    constructor(message?: string, options?: ExternalServiceErrorOptions);
     toJSON(): {
         name: string;
         message: string;
@@ -50,4 +57,3 @@ export declare function isExternalServiceError(value: unknown): value is Externa
  * can back off. Pass an explicit `statusCode` option to override.
  */
 export declare function mapResponseStatus(responseStatus: number | undefined): number;
-//# sourceMappingURL=externalServiceError.base.d.ts.map