@bombillazo/error-x 0.2.0 → 0.2.1

package/dist/index.js

@@ -20,7 +20,9 @@ var ERROR_X_OPTION_FIELDS = [
   "uiMessage",
   "cause",
   "metadata",
-  "actions"
+  "actions",
+  "httpStatus",
+  "type"
 ];
 
 // src/error.ts
@@ -36,6 +38,10 @@ var ErrorX = class _ErrorX extends Error {
   timestamp;
   /** Error actions for UI behavior and handling */
   actions;
+  /** HTTP status code (100-599) for HTTP-related errors */
+  httpStatus;
+  /** Error type for categorization */
+  type;
   /**
    * Creates a new ErrorX instance with enhanced error handling capabilities.
    *
@@ -92,6 +98,8 @@ var ErrorX = class _ErrorX extends Error {
     this.uiMessage = options.uiMessage;
     this.metadata = options.metadata;
     this.actions = options.actions;
+    this.httpStatus = _ErrorX.validateHttpStatus(options.httpStatus);
+    this.type = _ErrorX.validateType(options.type);
     this.timestamp = /* @__PURE__ */ new Date();
     if (options.cause instanceof Error) {
       this.stack = _ErrorX.preserveOriginalStack(options.cause, this);
@@ -109,6 +117,38 @@ var ErrorX = class _ErrorX extends Error {
   static getDefaultName() {
     return "Error";
   }
+  /**
+   * Validates HTTP status code to ensure it's within valid range (100-599)
+   *
+   * @param status - Status code to validate
+   * @returns Valid status code or undefined if invalid/not provided
+   */
+  static validateHttpStatus(status) {
+    if (status === void 0 || status === null) {
+      return void 0;
+    }
+    const statusNum = Number(status);
+    if (Number.isNaN(statusNum) || statusNum < 100 || statusNum > 599) {
+      return void 0;
+    }
+    return Math.floor(statusNum);
+  }
+  /**
+   * Validates and normalizes the type field
+   *
+   * @param type - Type value to validate
+   * @returns Validated type string or undefined if invalid/empty
+   */
+  static validateType(type) {
+    if (type === void 0 || type === null) {
+      return void 0;
+    }
+    const typeStr = String(type).trim();
+    if (typeStr === "") {
+      return void 0;
+    }
+    return typeStr;
+  }
   /**
    * Validates if an object is a valid ErrorXOptions object.
    * Checks that the object only contains accepted ErrorXOptions fields.
@@ -262,7 +302,9 @@ var ErrorX = class _ErrorX extends Error {
       code: this.code,
       uiMessage: this.uiMessage,
       cause: this.cause,
-      metadata: { ...this.metadata ?? {}, ...additionalMetadata }
+      metadata: { ...this.metadata ?? {}, ...additionalMetadata },
+      httpStatus: this.httpStatus,
+      type: this.type
     };
     if (this.actions) {
       options.actions = this.actions;
@@ -311,6 +353,8 @@ var ErrorX = class _ErrorX extends Error {
     let cause;
     let metadata = {};
     let actions;
+    let httpStatus;
+    let type;
     if (error) {
       if (typeof error === "string") {
         message = error;
@@ -328,13 +372,29 @@ var ErrorX = class _ErrorX extends Error {
         else if ("info" in error && error.info) message = String(error.info);
         else if ("statusText" in error && error.statusText) message = String(error.statusText);
         else if ("error" in error && error.error) message = String(error.error);
-        else if ("errorMessage" in error && error.errorMessage) message = String(error.errorMessage);
+        else if ("errorMessage" in error && error.errorMessage)
+          message = String(error.errorMessage);
         if ("code" in error && error.code) code = String(error.code);
         if ("uiMessage" in error && error.uiMessage) uiMessage = String(error.uiMessage);
         else if ("userMessage" in error && error.userMessage) uiMessage = String(error.userMessage);
         if ("actions" in error && Array.isArray(error.actions)) {
           actions = error.actions;
         }
+        let _httpStatus;
+        if ("httpStatus" in error) {
+          _httpStatus = error.httpStatus;
+        } else if ("status" in error) {
+          _httpStatus = error.status;
+        } else if ("statusCode" in error) {
+          _httpStatus = error.statusCode;
+        }
+        if (_httpStatus !== void 0 && _httpStatus !== null) {
+          const num = typeof _httpStatus === "number" ? _httpStatus : Number(_httpStatus);
+          httpStatus = _ErrorX.validateHttpStatus(num);
+        }
+        if ("type" in error && error.type) {
+          type = _ErrorX.validateType(String(error.type));
+        }
         metadata = { originalError: error };
       }
     }
@@ -347,6 +407,8 @@ var ErrorX = class _ErrorX extends Error {
     if (cause) options.cause = cause;
     if (Object.keys(metadata).length > 0) options.metadata = metadata;
     if (actions && actions.length > 0) options.actions = actions;
+    if (httpStatus) options.httpStatus = httpStatus;
+    if (type) options.type = type;
     return options;
   }
   /**
@@ -417,7 +479,9 @@ var ErrorX = class _ErrorX extends Error {
         name: this.name,
         code: this.code,
         uiMessage: this.uiMessage,
-        cause: this.cause
+        cause: this.cause,
+        httpStatus: this.httpStatus,
+        type: this.type
       };
       if (this.metadata !== void 0) {
         options.metadata = this.metadata;
@@ -500,6 +564,12 @@ ${this.stack}`;
       const stringified = safeStringify(this.actions);
       serialized.actions = JSON.parse(stringified);
     }
+    if (this.httpStatus !== void 0) {
+      serialized.httpStatus = this.httpStatus;
+    }
+    if (this.type !== void 0) {
+      serialized.type = this.type;
+    }
     if (this.stack) {
       serialized.stack = this.stack;
     }
@@ -550,7 +620,9 @@ ${this.stack}`;
       message: serialized.message,
       name: serialized.name,
       code: serialized.code,
-      uiMessage: serialized.uiMessage
+      uiMessage: serialized.uiMessage,
+      httpStatus: serialized.httpStatus,
+      type: serialized.type
     };
     if (serialized.metadata !== void 0) {
       options.metadata = serialized.metadata;
@@ -576,6 +648,330 @@ ${this.stack}`;
   }
 };
 
-export { ErrorX, HandlingTargets };
+// src/presets.ts
+var PRESETS = {
+  /**
+   * HTTP error presets for common HTTP status codes.
+   * Includes both 4xx client errors and 5xx server errors.
+   */
+  HTTP: {
+    // 4xx Client Errors
+    BAD_REQUEST: {
+      httpStatus: 400,
+      code: "BAD_REQUEST",
+      name: "BadRequestError",
+      message: "Bad request",
+      uiMessage: "The request could not be processed. Please check your input and try again.",
+      type: "http"
+    },
+    UNAUTHORIZED: {
+      httpStatus: 401,
+      code: "UNAUTHORIZED",
+      name: "UnauthorizedError",
+      message: "Unauthorized",
+      uiMessage: "Authentication required. Please log in to continue.",
+      type: "http"
+    },
+    PAYMENT_REQUIRED: {
+      httpStatus: 402,
+      code: "PAYMENT_REQUIRED",
+      name: "PaymentRequiredError",
+      message: "Payment required",
+      uiMessage: "Payment is required to access this resource.",
+      type: "http"
+    },
+    FORBIDDEN: {
+      httpStatus: 403,
+      code: "FORBIDDEN",
+      name: "ForbiddenError",
+      message: "Forbidden",
+      uiMessage: "You do not have permission to access this resource.",
+      type: "http"
+    },
+    NOT_FOUND: {
+      httpStatus: 404,
+      code: "NOT_FOUND",
+      name: "NotFoundError",
+      message: "Not found",
+      uiMessage: "The requested resource could not be found.",
+      type: "http"
+    },
+    METHOD_NOT_ALLOWED: {
+      httpStatus: 405,
+      code: "METHOD_NOT_ALLOWED",
+      name: "MethodNotAllowedError",
+      message: "Method not allowed",
+      uiMessage: "This action is not allowed for the requested resource.",
+      type: "http"
+    },
+    NOT_ACCEPTABLE: {
+      httpStatus: 406,
+      code: "NOT_ACCEPTABLE",
+      name: "NotAcceptableError",
+      message: "Not acceptable",
+      uiMessage: "The requested format is not supported.",
+      type: "http"
+    },
+    PROXY_AUTHENTICATION_REQUIRED: {
+      httpStatus: 407,
+      code: "PROXY_AUTHENTICATION_REQUIRED",
+      name: "ProxyAuthenticationRequiredError",
+      message: "Proxy authentication required",
+      uiMessage: "Proxy authentication is required to access this resource.",
+      type: "http"
+    },
+    REQUEST_TIMEOUT: {
+      httpStatus: 408,
+      code: "REQUEST_TIMEOUT",
+      name: "RequestTimeoutError",
+      message: "Request timeout",
+      uiMessage: "The request took too long to complete. Please try again.",
+      type: "http"
+    },
+    CONFLICT: {
+      httpStatus: 409,
+      code: "CONFLICT",
+      name: "ConflictError",
+      message: "Conflict",
+      uiMessage: "The request conflicts with the current state. Please refresh and try again.",
+      type: "http"
+    },
+    GONE: {
+      httpStatus: 410,
+      code: "GONE",
+      name: "GoneError",
+      message: "Gone",
+      uiMessage: "This resource is no longer available.",
+      type: "http"
+    },
+    LENGTH_REQUIRED: {
+      httpStatus: 411,
+      code: "LENGTH_REQUIRED",
+      name: "LengthRequiredError",
+      message: "Length required",
+      uiMessage: "The request is missing required length information.",
+      type: "http"
+    },
+    PRECONDITION_FAILED: {
+      httpStatus: 412,
+      code: "PRECONDITION_FAILED",
+      name: "PreconditionFailedError",
+      message: "Precondition failed",
+      uiMessage: "A required condition was not met. Please try again.",
+      type: "http"
+    },
+    PAYLOAD_TOO_LARGE: {
+      httpStatus: 413,
+      code: "PAYLOAD_TOO_LARGE",
+      name: "PayloadTooLargeError",
+      message: "Payload too large",
+      uiMessage: "The request is too large. Please reduce the size and try again.",
+      type: "http"
+    },
+    URI_TOO_LONG: {
+      httpStatus: 414,
+      code: "URI_TOO_LONG",
+      name: "URITooLongError",
+      message: "URI too long",
+      uiMessage: "The request URL is too long.",
+      type: "http"
+    },
+    UNSUPPORTED_MEDIA_TYPE: {
+      httpStatus: 415,
+      code: "UNSUPPORTED_MEDIA_TYPE",
+      name: "UnsupportedMediaTypeError",
+      message: "Unsupported media type",
+      uiMessage: "The file type is not supported.",
+      type: "http"
+    },
+    RANGE_NOT_SATISFIABLE: {
+      httpStatus: 416,
+      code: "RANGE_NOT_SATISFIABLE",
+      name: "RangeNotSatisfiableError",
+      message: "Range not satisfiable",
+      uiMessage: "The requested range cannot be satisfied.",
+      type: "http"
+    },
+    EXPECTATION_FAILED: {
+      httpStatus: 417,
+      code: "EXPECTATION_FAILED",
+      name: "ExpectationFailedError",
+      message: "Expectation failed",
+      uiMessage: "The server cannot meet the requirements of the request.",
+      type: "http"
+    },
+    IM_A_TEAPOT: {
+      httpStatus: 418,
+      code: "IM_A_TEAPOT",
+      name: "ImATeapotError",
+      message: "I'm a teapot",
+      uiMessage: "I'm a teapot and cannot brew coffee.",
+      type: "http"
+    },
+    UNPROCESSABLE_ENTITY: {
+      httpStatus: 422,
+      code: "UNPROCESSABLE_ENTITY",
+      name: "UnprocessableEntityError",
+      message: "Unprocessable entity",
+      uiMessage: "The request contains invalid data. Please check your input.",
+      type: "http"
+    },
+    LOCKED: {
+      httpStatus: 423,
+      code: "LOCKED",
+      name: "LockedError",
+      message: "Locked",
+      uiMessage: "This resource is locked and cannot be modified.",
+      type: "http"
+    },
+    FAILED_DEPENDENCY: {
+      httpStatus: 424,
+      code: "FAILED_DEPENDENCY",
+      name: "FailedDependencyError",
+      message: "Failed dependency",
+      uiMessage: "The request failed due to a dependency error.",
+      type: "http"
+    },
+    TOO_EARLY: {
+      httpStatus: 425,
+      code: "TOO_EARLY",
+      name: "TooEarlyError",
+      message: "Too early",
+      uiMessage: "The request was sent too early. Please try again later.",
+      type: "http"
+    },
+    UPGRADE_REQUIRED: {
+      httpStatus: 426,
+      code: "UPGRADE_REQUIRED",
+      name: "UpgradeRequiredError",
+      message: "Upgrade required",
+      uiMessage: "Please upgrade to continue using this service.",
+      type: "http"
+    },
+    PRECONDITION_REQUIRED: {
+      httpStatus: 428,
+      code: "PRECONDITION_REQUIRED",
+      name: "PreconditionRequiredError",
+      message: "Precondition required",
+      uiMessage: "Required conditions are missing from the request.",
+      type: "http"
+    },
+    TOO_MANY_REQUESTS: {
+      httpStatus: 429,
+      code: "TOO_MANY_REQUESTS",
+      name: "TooManyRequestsError",
+      message: "Too many requests",
+      uiMessage: "You have made too many requests. Please wait and try again.",
+      type: "http"
+    },
+    REQUEST_HEADER_FIELDS_TOO_LARGE: {
+      httpStatus: 431,
+      code: "REQUEST_HEADER_FIELDS_TOO_LARGE",
+      name: "RequestHeaderFieldsTooLargeError",
+      message: "Request header fields too large",
+      uiMessage: "The request headers are too large.",
+      type: "http"
+    },
+    UNAVAILABLE_FOR_LEGAL_REASONS: {
+      httpStatus: 451,
+      code: "UNAVAILABLE_FOR_LEGAL_REASONS",
+      name: "UnavailableForLegalReasonsError",
+      message: "Unavailable for legal reasons",
+      uiMessage: "This content is unavailable for legal reasons.",
+      type: "http"
+    },
+    // 5xx Server Errors
+    INTERNAL_SERVER_ERROR: {
+      httpStatus: 500,
+      code: "INTERNAL_SERVER_ERROR",
+      name: "InternalServerError",
+      message: "Internal server error",
+      uiMessage: "An unexpected error occurred. Please try again later.",
+      type: "http"
+    },
+    NOT_IMPLEMENTED: {
+      httpStatus: 501,
+      code: "NOT_IMPLEMENTED",
+      name: "NotImplementedError",
+      message: "Not implemented",
+      uiMessage: "This feature is not yet available.",
+      type: "http"
+    },
+    BAD_GATEWAY: {
+      httpStatus: 502,
+      code: "BAD_GATEWAY",
+      name: "BadGatewayError",
+      message: "Bad gateway",
+      uiMessage: "Unable to connect to the server. Please try again later.",
+      type: "http"
+    },
+    SERVICE_UNAVAILABLE: {
+      httpStatus: 503,
+      code: "SERVICE_UNAVAILABLE",
+      name: "ServiceUnavailableError",
+      message: "Service unavailable",
+      uiMessage: "The service is temporarily unavailable. Please try again later.",
+      type: "http"
+    },
+    GATEWAY_TIMEOUT: {
+      httpStatus: 504,
+      code: "GATEWAY_TIMEOUT",
+      name: "GatewayTimeoutError",
+      message: "Gateway timeout",
+      uiMessage: "The server took too long to respond. Please try again.",
+      type: "http"
+    },
+    HTTP_VERSION_NOT_SUPPORTED: {
+      httpStatus: 505,
+      code: "HTTP_VERSION_NOT_SUPPORTED",
+      name: "HTTPVersionNotSupportedError",
+      message: "HTTP version not supported",
+      uiMessage: "Your browser version is not supported.",
+      type: "http"
+    },
+    VARIANT_ALSO_NEGOTIATES: {
+      httpStatus: 506,
+      code: "VARIANT_ALSO_NEGOTIATES",
+      name: "VariantAlsoNegotiatesError",
+      message: "Variant also negotiates",
+      uiMessage: "The server has an internal configuration error.",
+      type: "http"
+    },
+    INSUFFICIENT_STORAGE: {
+      httpStatus: 507,
+      code: "INSUFFICIENT_STORAGE",
+      name: "InsufficientStorageError",
+      message: "Insufficient storage",
+      uiMessage: "The server has insufficient storage to complete the request.",
+      type: "http"
+    },
+    LOOP_DETECTED: {
+      httpStatus: 508,
+      code: "LOOP_DETECTED",
+      name: "LoopDetectedError",
+      message: "Loop detected",
+      uiMessage: "The server detected an infinite loop.",
+      type: "http"
+    },
+    NOT_EXTENDED: {
+      httpStatus: 510,
+      code: "NOT_EXTENDED",
+      name: "NotExtendedError",
+      message: "Not extended",
+      uiMessage: "Additional extensions are required.",
+      type: "http"
+    },
+    NETWORK_AUTHENTICATION_REQUIRED: {
+      httpStatus: 511,
+      code: "NETWORK_AUTHENTICATION_REQUIRED",
+      name: "NetworkAuthenticationRequiredError",
+      message: "Network authentication required",
+      uiMessage: "Network authentication is required to access this resource.",
+      type: "http"
+    }
+  }
+};
+
+export { ErrorX, HandlingTargets, PRESETS };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map