@zudojs/errors 0.1.1 → 1.0.1

package/dist/infrastructure/adapter/adapterError.lifecycle.js

@@ -14,7 +14,6 @@ export class AdapterInitializationError extends AdapterError {
             expose: false,
             isOperational: false,
         });
-        this.name = "AdapterInitializationError";
     }
 }
 /** Error thrown when an adapter fails to configure. */
@@ -28,7 +27,6 @@ export class AdapterConfigurationError extends AdapterError {
             expose: false,
             isOperational: false,
         });
-        this.name = "AdapterConfigurationError";
     }
 }
 /** Error thrown when an adapter fails to dispose. */
@@ -42,7 +40,6 @@ export class AdapterDisposeError extends AdapterError {
             expose: false,
             isOperational: false,
         });
-        this.name = "AdapterDisposeError";
     }
 }
 //# sourceMappingURL=adapterError.lifecycle.js.map

package/dist/infrastructure/adapter/adapterError.operation.js

@@ -13,7 +13,6 @@ export class AdapterNotSupportedError extends AdapterError {
             statusCode: 501,
             expose: true,
         });
-        this.name = "AdapterNotSupportedError";
     }
 }
 /** Error thrown when an adapter capability is missing. */
@@ -26,7 +25,6 @@ export class AdapterCapabilityMissingError extends AdapterError {
             statusCode: 500,
             expose: false,
         });
-        this.name = "AdapterCapabilityMissingError";
     }
 }
 /** Error thrown when an adapter fails to connect. */
@@ -40,7 +38,6 @@ export class AdapterConnectionError extends AdapterError {
             expose: false,
             isOperational: false,
         });
-        this.name = "AdapterConnectionError";
     }
 }
 /** Error thrown when an adapter operation fails. */
@@ -55,7 +52,6 @@ export class AdapterOperationError extends AdapterError {
             expose: false,
             isOperational: false,
         });
-        this.name = "AdapterOperationError";
     }
 }
 /** Error thrown when an adapter operation times out. */
@@ -71,7 +67,6 @@ export class AdapterTimeoutError extends AdapterError {
             expose: false,
             isOperational: false,
         });
-        this.name = "AdapterTimeoutError";
         this.timeout = timeout;
     }
 }

package/dist/infrastructure/cache/cacheError.base.js

@@ -33,7 +33,7 @@ export class CacheError extends BaseError {
     constructor(message = "A cache operation failed.", options = {}) {
         super(message, {
             ...options,
-            code: options.code ?? ErrorCode.UNKNOWN,
+            code: options.code ?? ErrorCode.CACHE,
             category: options.category ?? ErrorCategory.CACHE,
             severity: options.severity ?? ErrorSeverity.ERROR,
             statusCode: options.statusCode ?? 500,

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

@@ -11,8 +11,9 @@ export class DuplicateRegistrationError extends ContainerError {
         super(message ?? `Token "${token}" is already registered.`, {
             code: ErrorCode.CONTAINER_DUPLICATE_REGISTRATION,
             token,
-            statusCode: 409,
-            expose: true,
+            statusCode: 500,
+            expose: false,
+            isOperational: false,
         });
         this.token = token;
         this.existingScope = options.existingScope;
@@ -34,8 +35,9 @@ export class RegistrationNotFoundError extends ContainerError {
         super(message ?? `No registration found for token "${token}".`, {
             code: ErrorCode.CONTAINER_REGISTRATION_NOT_FOUND,
             token,
-            statusCode: 404,
-            expose: true,
+            statusCode: 500,
+            expose: false,
+            isOperational: false,
         });
         this.requestedToken = token;
     }

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

@@ -19,7 +19,6 @@ export class HttpAdapterError extends BaseError {
             statusCode: options.statusCode ?? 500,
             expose: options.expose ?? false,
         });
-        this.name = "HttpAdapterError";
         this.adapter = options.adapter;
     }
 }
@@ -38,12 +37,15 @@ export class RequestBodyTooLargeError extends HttpAdapterError {
     constructor(maxSize, actualSize) {
         super(`HTTP request body exceeds the maximum allowed size of ${maxSize} bytes (actual: ${actualSize}).`, {
             code: ErrorCode.HTTP_REQUEST_BODY_TOO_LARGE,
+            statusCode: 413,
+            expose: true,
+            isOperational: true,
+            severity: ErrorSeverity.WARNING,
             metadata: {
                 maxSize,
                 actualSize,
             },
         });
-        this.name = "RequestBodyTooLargeError";
         this.maxSize = maxSize;
         this.actualSize = actualSize;
     }

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

@@ -1,6 +1,7 @@
 /**
  * Advanced HTTP client error classes (422+).
  */
+import { ErrorCode } from "../../base/types/errorCode.type.js";
 import { HttpError } from "./http.error.js";
 /** 422 Unprocessable Entity */
 export class UnprocessableEntityError extends HttpError {
@@ -8,9 +9,8 @@ export class UnprocessableEntityError extends HttpError {
         super(message, {
             ...options,
             statusCode: 422,
-            code: options.code ?? "UNPROCESSABLE_ENTITY",
+            code: options.code ?? ErrorCode.HTTP_UNPROCESSABLE_ENTITY,
         });
-        this.name = "UnprocessableEntityError";
     }
 }
 /** 423 Locked */
@@ -19,9 +19,8 @@ export class LockedError extends HttpError {
         super(message, {
             ...options,
             statusCode: 423,
-            code: options.code ?? "LOCKED",
+            code: options.code ?? ErrorCode.HTTP_LOCKED,
         });
-        this.name = "LockedError";
     }
 }
 /** 424 Failed Dependency */
@@ -30,9 +29,8 @@ export class FailedDependencyError extends HttpError {
         super(message, {
             ...options,
             statusCode: 424,
-            code: options.code ?? "FAILED_DEPENDENCY",
+            code: options.code ?? ErrorCode.HTTP_FAILED_DEPENDENCY,
         });
-        this.name = "FailedDependencyError";
     }
 }
 /** 425 Too Early */
@@ -41,9 +39,8 @@ export class TooEarlyError extends HttpError {
         super(message, {
             ...options,
             statusCode: 425,
-            code: options.code ?? "TOO_EARLY",
+            code: options.code ?? ErrorCode.HTTP_TOO_EARLY,
         });
-        this.name = "TooEarlyError";
     }
 }
 /** 426 Upgrade Required */
@@ -52,9 +49,8 @@ export class UpgradeRequiredError extends HttpError {
         super(message, {
             ...options,
             statusCode: 426,
-            code: options.code ?? "UPGRADE_REQUIRED",
+            code: options.code ?? ErrorCode.HTTP_UPGRADE_REQUIRED,
         });
-        this.name = "UpgradeRequiredError";
     }
 }
 /** 428 Precondition Required */
@@ -63,9 +59,8 @@ export class PreconditionRequiredError extends HttpError {
         super(message, {
             ...options,
             statusCode: 428,
-            code: options.code ?? "PRECONDITION_REQUIRED",
+            code: options.code ?? ErrorCode.HTTP_PRECONDITION_REQUIRED,
         });
-        this.name = "PreconditionRequiredError";
     }
 }
 /** 429 Too Many Requests */
@@ -74,9 +69,8 @@ export class TooManyRequestsError extends HttpError {
         super(message, {
             ...options,
             statusCode: 429,
-            code: options.code ?? "TOO_MANY_REQUESTS",
+            code: options.code ?? ErrorCode.HTTP_TOO_MANY_REQUESTS,
         });
-        this.name = "TooManyRequestsError";
     }
 }
 /** 431 Request Header Fields Too Large */
@@ -85,9 +79,8 @@ export class RequestHeaderFieldsTooLargeError extends HttpError {
         super(message, {
             ...options,
             statusCode: 431,
-            code: options.code ?? "REQUEST_HEADER_FIELDS_TOO_LARGE",
+            code: options.code ?? ErrorCode.HTTP_REQUEST_HEADER_FIELDS_TOO_LARGE,
         });
-        this.name = "RequestHeaderFieldsTooLargeError";
     }
 }
 /** 499 Request Aborted */
@@ -96,9 +89,8 @@ export class RequestAbortedError extends HttpError {
         super(message, {
             ...options,
             statusCode: 499,
-            code: options.code ?? "REQUEST_ABORTED",
+            code: options.code ?? ErrorCode.HTTP_REQUEST_ABORTED,
         });
-        this.name = "RequestAbortedError";
     }
 }
 //# sourceMappingURL=httpClientError.advanced.js.map

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

@@ -11,6 +11,8 @@ export interface HttpClientClientErrorOptions {
     readonly code?: string;
     readonly expose?: boolean;
     readonly metadata?: ErrorMetadata;
+    /** Local status code. Defaults to a mapping of the upstream `status` (502 for upstream failures). */
+    readonly statusCode?: number;
     readonly status?: number;
     readonly statusText?: string;
     readonly url?: string;
@@ -35,4 +37,13 @@ export declare class HttpClientError extends BaseError {
     get isAbortError(): boolean;
     get isHttpStatusError(): boolean;
 }
+/**
+ * Maps an upstream HTTP status to the local status reported to our caller.
+ *
+ * Upstream failures are our problem, not the caller's: everything except
+ * 429 (which is passed through) maps to 502 Bad Gateway.
+ */
+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

@@ -2,6 +2,9 @@
  * HTTP client error base class.
  */
 import { BaseError } from "../../base/core/baseError.core.js";
+import { ErrorCategory } from "../../base/types/errorCategory.type.js";
+import { ErrorCode } from "../../base/types/errorCode.type.js";
+import { ErrorSeverity } from "../../base/types/errorSeverity.type.js";
 /**
  * Base HTTP client error for outbound request failures.
  *
@@ -15,30 +18,67 @@ export class HttpClientError extends BaseError {
     response;
     request;
     constructor(message, options = {}) {
+        const url = options.url !== undefined ? stripUrlCredentials(options.url) : undefined;
         super(message, {
-            code: options.code ?? "HTTP_CLIENT_ERROR",
+            code: options.code ?? ErrorCode.HTTP_CLIENT,
+            category: ErrorCategory.NETWORK,
+            severity: ErrorSeverity.ERROR,
+            statusCode: options.statusCode ?? mapUpstreamStatus(options.status),
             expose: options.expose ?? false,
-            metadata: options.metadata,
+            isOperational: true,
+            metadata: {
+                ...options.metadata,
+                ...(options.status !== undefined ? { upstreamStatus: options.status } : {}),
+                ...(url !== undefined ? { url } : {}),
+            },
             cause: options.cause,
         });
-        this.name = "HttpClientError";
         this.status = options.status;
         this.statusText = options.statusText;
-        this.url = options.url;
+        this.url = url;
         this.response = options.response;
         this.request = options.request;
     }
     get isNetworkError() {
-        return this.code === "HTTP_CLIENT_NETWORK_ERROR";
+        return (this.code === ErrorCode.HTTP_CLIENT_NETWORK ||
+            this.code === "HTTP_CLIENT_NETWORK_ERROR");
     }
     get isTimeoutError() {
-        return this.code === "HTTP_CLIENT_TIMEOUT";
+        return (this.code === ErrorCode.HTTP_CLIENT_TIMEOUT ||
+            this.code === "HTTP_CLIENT_TIMEOUT");
     }
     get isAbortError() {
-        return this.code === "HTTP_CLIENT_ABORTED";
+        return (this.code === ErrorCode.HTTP_CLIENT_ABORTED ||
+            this.code === "HTTP_CLIENT_ABORTED");
     }
     get isHttpStatusError() {
         return this.status !== undefined;
     }
 }
+/**
+ * Maps an upstream HTTP status to the local status reported to our caller.
+ *
+ * Upstream failures are our problem, not the caller's: everything except
+ * 429 (which is passed through) maps to 502 Bad Gateway.
+ */
+export function mapUpstreamStatus(status) {
+    if (status === 429)
+        return 429;
+    return 502;
+}
+/** Removes credentials and the query string from a URL before storing it. */
+export function stripUrlCredentials(url) {
+    try {
+        const parsed = new URL(url);
+        parsed.username = "";
+        parsed.password = "";
+        parsed.search = "";
+        parsed.hash = "";
+        return parsed.toString();
+    }
+    catch {
+        const withoutQuery = url.split(/[?#]/)[0] ?? url;
+        return withoutQuery.replace(/\/\/[^/@]*@/, "//");
+    }
+}
 //# sourceMappingURL=httpClientError.base.js.map

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

@@ -23,6 +23,20 @@ export declare class HttpNotFoundError extends HttpError {
 export declare class MethodNotAllowedError extends HttpError {
     readonly methods: readonly string[];
     constructor(methods?: readonly string[], message?: string, options?: HttpClientErrorOptions);
+    toJSON(): {
+        name: string;
+        message: string;
+        code: string;
+        category: import("../../index.js").ErrorCategory;
+        severity: import("../../index.js").ErrorSeverity;
+        statusCode: number;
+        expose: boolean;
+        isOperational: boolean;
+        metadata: Readonly<import("../../index.js").ErrorMetadata>;
+        stack?: string;
+        cause?: import("../../index.js").SerializedBaseError | unknown;
+        methods: readonly string[];
+    };
 }
 /** 406 Not Acceptable */
 export declare class NotAcceptableError extends HttpError {

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

@@ -1,6 +1,7 @@
 /**
  * Common HTTP client error classes (400-417).
  */
+import { ErrorCode } from "../../base/types/errorCode.type.js";
 import { HttpError } from "./http.error.js";
 /** 400 Bad Request */
 export class BadRequestError extends HttpError {
@@ -8,9 +9,8 @@ export class BadRequestError extends HttpError {
         super(message, {
             ...options,
             statusCode: 400,
-            code: options.code ?? "BAD_REQUEST",
+            code: options.code ?? ErrorCode.HTTP_BAD_REQUEST,
         });
-        this.name = "BadRequestError";
     }
 }
 /** 401 Unauthorized */
@@ -19,9 +19,8 @@ export class UnauthorizedError extends HttpError {
         super(message, {
             ...options,
             statusCode: 401,
-            code: options.code ?? "UNAUTHORIZED",
+            code: options.code ?? ErrorCode.HTTP_UNAUTHORIZED,
         });
-        this.name = "UnauthorizedError";
     }
 }
 /** 403 Forbidden */
@@ -30,9 +29,8 @@ export class ForbiddenError extends HttpError {
         super(message, {
             ...options,
             statusCode: 403,
-            code: options.code ?? "FORBIDDEN",
+            code: options.code ?? ErrorCode.HTTP_FORBIDDEN,
         });
-        this.name = "ForbiddenError";
     }
 }
 /** 404 Not Found */
@@ -41,9 +39,8 @@ export class HttpNotFoundError extends HttpError {
         super(message, {
             ...options,
             statusCode: 404,
-            code: options.code ?? "NOT_FOUND",
+            code: options.code ?? ErrorCode.HTTP_NOT_FOUND,
         });
-        this.name = "HttpNotFoundError";
     }
 }
 /** 405 Method Not Allowed */
@@ -53,10 +50,13 @@ export class MethodNotAllowedError extends HttpError {
         super(message, {
             ...options,
             statusCode: 405,
-            code: options.code ?? "METHOD_NOT_ALLOWED",
+            code: options.code ?? ErrorCode.HTTP_METHOD_NOT_ALLOWED,
+            metadata: { ...options.metadata, allowedMethods: [...methods] },
         });
-        this.name = "MethodNotAllowedError";
-        this.methods = methods;
+        this.methods = Object.freeze([...methods]);
+    }
+    toJSON() {
+        return { ...super.toJSON(), methods: this.methods };
     }
 }
 /** 406 Not Acceptable */
@@ -65,9 +65,8 @@ export class NotAcceptableError extends HttpError {
         super(message, {
             ...options,
             statusCode: 406,
-            code: options.code ?? "NOT_ACCEPTABLE",
+            code: options.code ?? ErrorCode.HTTP_NOT_ACCEPTABLE,
         });
-        this.name = "NotAcceptableError";
     }
 }
 /** 408 Request Timeout */
@@ -76,9 +75,8 @@ export class RequestTimeoutError extends HttpError {
         super(message, {
             ...options,
             statusCode: 408,
-            code: options.code ?? "REQUEST_TIMEOUT",
+            code: options.code ?? ErrorCode.HTTP_REQUEST_TIMEOUT,
         });
-        this.name = "RequestTimeoutError";
     }
 }
 /** 409 Conflict */
@@ -87,9 +85,8 @@ export class HttpConflictError extends HttpError {
         super(message, {
             ...options,
             statusCode: 409,
-            code: options.code ?? "CONFLICT",
+            code: options.code ?? ErrorCode.HTTP_CONFLICT,
         });
-        this.name = "HttpConflictError";
     }
 }
 /** 410 Gone */
@@ -98,9 +95,8 @@ export class GoneError extends HttpError {
         super(message, {
             ...options,
             statusCode: 410,
-            code: options.code ?? "GONE",
+            code: options.code ?? ErrorCode.HTTP_GONE,
         });
-        this.name = "GoneError";
     }
 }
 /** 411 Length Required */
@@ -109,9 +105,8 @@ export class LengthRequiredError extends HttpError {
         super(message, {
             ...options,
             statusCode: 411,
-            code: options.code ?? "LENGTH_REQUIRED",
+            code: options.code ?? ErrorCode.HTTP_LENGTH_REQUIRED,
         });
-        this.name = "LengthRequiredError";
     }
 }
 /** 413 Payload Too Large */
@@ -120,9 +115,8 @@ export class PayloadTooLargeError extends HttpError {
         super(message, {
             ...options,
             statusCode: 413,
-            code: options.code ?? "PAYLOAD_TOO_LARGE",
+            code: options.code ?? ErrorCode.HTTP_PAYLOAD_TOO_LARGE,
         });
-        this.name = "PayloadTooLargeError";
     }
 }
 /** 414 URI Too Long */
@@ -131,9 +125,8 @@ export class URITooLongError extends HttpError {
         super(message, {
             ...options,
             statusCode: 414,
-            code: options.code ?? "URI_TOO_LONG",
+            code: options.code ?? ErrorCode.HTTP_URI_TOO_LONG,
         });
-        this.name = "URITooLongError";
     }
 }
 /** 415 Unsupported Media Type */
@@ -142,9 +135,8 @@ export class UnsupportedMediaTypeError extends HttpError {
         super(message, {
             ...options,
             statusCode: 415,
-            code: options.code ?? "UNSUPPORTED_MEDIA_TYPE",
+            code: options.code ?? ErrorCode.HTTP_UNSUPPORTED_MEDIA_TYPE,
         });
-        this.name = "UnsupportedMediaTypeError";
     }
 }
 /** 416 Range Not Satisfiable */
@@ -153,9 +145,8 @@ export class RangeNotSatisfiableError extends HttpError {
         super(message, {
             ...options,
             statusCode: 416,
-            code: options.code ?? "RANGE_NOT_SATISFIABLE",
+            code: options.code ?? ErrorCode.HTTP_RANGE_NOT_SATISFIABLE,
         });
-        this.name = "RangeNotSatisfiableError";
     }
 }
 /** 417 Expectation Failed */
@@ -164,9 +155,8 @@ export class ExpectationFailedError extends HttpError {
         super(message, {
             ...options,
             statusCode: 417,
-            code: options.code ?? "EXPECTATION_FAILED",
+            code: options.code ?? ErrorCode.HTTP_EXPECTATION_FAILED,
         });
-        this.name = "ExpectationFailedError";
     }
 }
 //# sourceMappingURL=httpClientError.common.js.map

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

@@ -1,6 +1,7 @@
 /**
  * Specialized HTTP client errors with additional properties.
  */
+import { ErrorCode } from "../../base/types/errorCode.type.js";
 import { HttpError } from "./http.error.js";
 /** 408 Request Body Timeout */
 export class RequestBodyTimeoutError extends HttpError {
@@ -8,9 +9,8 @@ export class RequestBodyTimeoutError extends HttpError {
         super(message, {
             ...options,
             statusCode: 408,
-            code: options.code ?? "REQUEST_BODY_TIMEOUT",
+            code: options.code ?? ErrorCode.HTTP_CLIENT_REQUEST_BODY_TIMEOUT,
         });
-        this.name = "RequestBodyTimeoutError";
     }
 }
 /** 400 Unsupported Protocol */
@@ -22,9 +22,8 @@ export class UnsupportedProtocolError extends HttpError {
             : "Unsupported protocol.", {
             ...options,
             statusCode: 400,
-            code: options.code ?? "UNSUPPORTED_PROTOCOL",
+            code: options.code ?? ErrorCode.HTTP_CLIENT_UNSUPPORTED_PROTOCOL,
         });
-        this.name = "UnsupportedProtocolError";
         this.protocol = protocol;
     }
 }
@@ -33,8 +32,7 @@ export class InvalidHeaderError extends HttpError {
     header;
     constructor(header, message, options = {}) {
         super(message ??
-            (header ? `Invalid HTTP header "${header}".` : "Invalid HTTP header."), { ...options, statusCode: 400, code: options.code ?? "INVALID_HEADER" });
-        this.name = "InvalidHeaderError";
+            (header ? `Invalid HTTP header "${header}".` : "Invalid HTTP header."), { ...options, statusCode: 400, code: options.code ?? ErrorCode.HTTP_CLIENT_INVALID_HEADER });
         this.header = header;
     }
 }
@@ -47,9 +45,8 @@ export class InvalidContentTypeError extends HttpError {
             : "Invalid content type.", {
             ...options,
             statusCode: 415,
-            code: options.code ?? "INVALID_CONTENT_TYPE",
+            code: options.code ?? ErrorCode.HTTP_CLIENT_INVALID_CONTENT_TYPE,
         });
-        this.name = "InvalidContentTypeError";
         this.contentType = contentType;
     }
 }

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

@@ -10,21 +10,42 @@ import { HttpClientError, type HttpClientClientErrorOptions } from "./httpClient
 export declare class HttpClientTimeoutError extends HttpClientError {
     readonly timeout: number;
     constructor(timeout: number, options?: HttpClientClientErrorOptions);
+    toJSON(): {
+        name: string;
+        message: string;
+        code: string;
+        category: import("../../index.js").ErrorCategory;
+        severity: import("../../index.js").ErrorSeverity;
+        statusCode: number;
+        expose: boolean;
+        isOperational: boolean;
+        metadata: Readonly<import("../../index.js").ErrorMetadata>;
+        stack?: string;
+        cause?: import("../../index.js").SerializedBaseError | unknown;
+        timeout: number;
+    };
 }
 /**
  * HTTP client abort error.
  *
  * Thrown when an outbound HTTP request is aborted via AbortSignal.
+ *
+ * Signature: `new HttpClientAbortError(request?, cause?, options?)`. The
+ * second argument is ALWAYS treated as the cause (never as options), so Node
+ * system errors and `DOMException`s that happen to carry a `code` property
+ * are preserved. The legacy single-options form is still accepted.
  */
 export declare class HttpClientAbortError extends HttpClientError {
-    constructor(requestOrOptions?: Request | HttpClientClientErrorOptions, causeOrOptions?: HttpClientClientErrorOptions | unknown);
+    constructor(request?: Request | HttpClientClientErrorOptions, cause?: unknown, options?: HttpClientClientErrorOptions);
 }
 /**
  * HTTP client network error.
  *
  * Thrown when an outbound HTTP request fails due to a network issue.
+ *
+ * Signature: `new HttpClientNetworkError(message, request?, cause?, options?)`.
  */
 export declare class HttpClientNetworkError extends HttpClientError {
-    constructor(message: string, requestOrOptions?: Request | HttpClientClientErrorOptions, causeOrOptions?: HttpClientClientErrorOptions | unknown);
+    constructor(message: string, request?: Request | HttpClientClientErrorOptions, cause?: unknown, options?: HttpClientClientErrorOptions);
 }
 //# sourceMappingURL=httpClientError.types.d.ts.map