@bombillazo/error-x 0.4.3 → 0.4.5

package/dist/index.js

@@ -10,9 +10,7 @@ var ERROR_X_OPTION_FIELDS = [
   "uiMessage",
   "cause",
   "metadata",
-  "httpStatus",
   "type",
-  "sourceUrl",
   "docsUrl",
   "source"
 ];
@@ -28,14 +26,10 @@ var ErrorX = class _ErrorX extends Error {
   uiMessage;
   /** Additional context and metadata associated with the error */
   metadata;
-  /** Timestamp when the error was created */
+  /** Unix epoch timestamp (milliseconds) when the error was created */
   timestamp;
-  /** HTTP status code (100-599) for HTTP-related errors */
-  httpStatus;
   /** Error type for categorization */
   type;
-  /** Source URL related to the error (API endpoint, page URL, resource URL) */
-  sourceUrl;
   /** Documentation URL for this specific error */
   docsUrl;
   /** Where the error originated (service name, module, component) */
@@ -92,10 +86,8 @@ var ErrorX = class _ErrorX extends Error {
     this.code = options.code != null ? String(options.code) : _ErrorX.generateDefaultCode(options.name);
     this.uiMessage = options.uiMessage;
     this.metadata = options.metadata;
-    this.httpStatus = _ErrorX.validateHttpStatus(options.httpStatus);
     this.type = _ErrorX.validateType(options.type);
-    this.timestamp = /* @__PURE__ */ new Date();
-    this.sourceUrl = options.sourceUrl;
+    this.timestamp = Date.now();
     this.source = options.source ?? envConfig?.source;
     let generatedDocsUrl;
     if (envConfig?.docsBaseURL && envConfig?.docsMap && this.code) {
@@ -113,8 +105,8 @@ var ErrorX = class _ErrorX extends Error {
       if (typeof Error.captureStackTrace === "function") {
         Error.captureStackTrace(this, this.constructor);
       }
-      this.stack = _ErrorX.cleanStack(this.stack);
     }
+    this.stack = _ErrorX.cleanStack(this.stack);
   }
   /**
    * Returns the default error name.
@@ -203,22 +195,6 @@ var ErrorX = class _ErrorX extends Error {
   static resetConfig() {
     _ErrorX._config = null;
   }
-  /**
-   * 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
    *
@@ -370,9 +346,7 @@ var ErrorX = class _ErrorX extends Error {
       uiMessage: this.uiMessage,
       cause: this.cause,
       metadata: { ...this.metadata ?? {}, ...additionalMetadata },
-      httpStatus: this.httpStatus,
       type: this.type,
-      sourceUrl: this.sourceUrl,
       docsUrl: this.docsUrl,
       source: this.source
     };
@@ -420,9 +394,7 @@ var ErrorX = class _ErrorX extends Error {
     let uiMessage = "";
     let cause;
     let metadata = {};
-    let httpStatus;
     let type;
-    let url;
     let href;
     let source;
     if (error) {
@@ -447,26 +419,9 @@ var ErrorX = class _ErrorX extends Error {
         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);
-        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));
         }
-        if ("sourceUrl" in error && error.sourceUrl) {
-          url = String(error.sourceUrl);
-        } else if ("url" in error && error.url) {
-          url = String(error.url);
-        }
         if ("docsUrl" in error && error.docsUrl) {
           href = String(error.docsUrl);
         } else if ("href" in error && error.href) {
@@ -492,9 +447,7 @@ var ErrorX = class _ErrorX extends Error {
     if (uiMessage) options.uiMessage = uiMessage;
     if (cause) options.cause = cause;
     if (Object.keys(metadata).length > 0) options.metadata = metadata;
-    if (httpStatus) options.httpStatus = httpStatus;
     if (type) options.type = type;
-    if (url) options.sourceUrl = url;
     if (href) options.docsUrl = href;
     if (source) options.source = source;
     return options;
@@ -520,7 +473,7 @@ var ErrorX = class _ErrorX extends Error {
    * })
    *
    * console.log(error.toString())
-   * // Output: "DatabaseError: Database connection failed. [DB_CONN_FAILED] (2024-01-15T10:30:45.123Z) metadata: {...}"
+   * // Output: "DatabaseError: Database connection failed. [DB_CONN_FAILED] 2025-01-15T10:30:45.123Z (1736937045123) metadata: {...}"
    * ```
    */
   toString() {
@@ -529,7 +482,7 @@ var ErrorX = class _ErrorX extends Error {
     if (this.code && this.code !== "ERROR") {
       parts.push(`[${this.code}]`);
     }
-    parts.push(`(${this.timestamp.toISOString()})`);
+    parts.push(`${new Date(this.timestamp).toISOString()} (${this.timestamp})`);
     if (this.metadata && Object.keys(this.metadata).length > 0) {
       const metadataStr = safeStringify(this.metadata);
       parts.push(`metadata: ${metadataStr}`);
@@ -570,17 +523,11 @@ ${this.stack}`;
       code: this.code,
       uiMessage: this.uiMessage,
       metadata: safeMetadata,
-      timestamp: this.timestamp.toISOString()
+      timestamp: this.timestamp
     };
-    if (this.httpStatus !== void 0) {
-      serialized.httpStatus = this.httpStatus;
-    }
     if (this.type !== void 0) {
       serialized.type = this.type;
     }
-    if (this.sourceUrl !== void 0) {
-      serialized.sourceUrl = this.sourceUrl;
-    }
     if (this.docsUrl !== void 0) {
       serialized.docsUrl = this.docsUrl;
     }
@@ -610,7 +557,7 @@ ${this.stack}`;
    *   code: 'DB_CONN_FAILED',
    *   uiMessage: 'Database is temporarily unavailable',
    *   metadata: { host: 'localhost' },
-   *   timestamp: '2024-01-15T10:30:45.123Z'
+   *   timestamp: 1705315845123
    * }
    *
    * const error = ErrorX.fromJSON(serializedError)
@@ -623,9 +570,7 @@ ${this.stack}`;
       name: serialized.name,
       code: serialized.code,
       uiMessage: serialized.uiMessage,
-      httpStatus: serialized.httpStatus,
       type: serialized.type,
-      sourceUrl: serialized.sourceUrl,
       docsUrl: serialized.docsUrl,
       source: serialized.source,
       cause: serialized.cause
@@ -637,7 +582,7 @@ ${this.stack}`;
     if (serialized.stack) {
       error.stack = serialized.stack;
     }
-    error.timestamp = new Date(serialized.timestamp);
+    error.timestamp = serialized.timestamp;
     return error;
   }
 };
@@ -646,317 +591,278 @@ ${this.stack}`;
 var http = {
   // 4xx Client Errors
   400: {
-    httpStatus: 400,
     code: "BAD_REQUEST",
     name: "Bad Request Error",
     message: "Bad request.",
     uiMessage: "The request could not be processed. Please check your input and try again.",
-    type: "http"
+    metadata: { status: 400 }
   },
   401: {
-    httpStatus: 401,
     code: "UNAUTHORIZED",
     name: "Unauthorized Error",
     message: "Unauthorized.",
     uiMessage: "Authentication required. Please log in to continue.",
-    type: "http"
+    metadata: { status: 401 }
   },
   402: {
-    httpStatus: 402,
     code: "PAYMENT_REQUIRED",
     name: "Payment Required Error",
     message: "Payment required.",
     uiMessage: "Payment is required to access this resource.",
-    type: "http"
+    metadata: { status: 402 }
   },
   403: {
-    httpStatus: 403,
     code: "FORBIDDEN",
     name: "Forbidden Error",
     message: "Forbidden.",
     uiMessage: "You do not have permission to access this resource.",
-    type: "http"
+    metadata: { status: 403 }
   },
   404: {
-    httpStatus: 404,
     code: "NOT_FOUND",
     name: "Not Found Error",
     message: "Not found.",
     uiMessage: "The requested resource could not be found.",
-    type: "http"
+    metadata: { status: 404 }
   },
   405: {
-    httpStatus: 405,
     code: "METHOD_NOT_ALLOWED",
     name: "Method Not Allowed Error",
     message: "Method not allowed.",
     uiMessage: "This action is not allowed for the requested resource.",
-    type: "http"
+    metadata: { status: 405 }
   },
   406: {
-    httpStatus: 406,
     code: "NOT_ACCEPTABLE",
     name: "Not Acceptable Error",
     message: "Not acceptable.",
     uiMessage: "The requested format is not supported.",
-    type: "http"
+    metadata: { status: 406 }
   },
   407: {
-    httpStatus: 407,
     code: "PROXY_AUTHENTICATION_REQUIRED",
     name: "Proxy Authentication Required Error",
     message: "Proxy authentication required.",
     uiMessage: "Proxy authentication is required to access this resource.",
-    type: "http"
+    metadata: { status: 407 }
   },
   408: {
-    httpStatus: 408,
     code: "REQUEST_TIMEOUT",
     name: "Request Timeout Error",
     message: "Request timeout.",
     uiMessage: "The request took too long to complete. Please try again.",
-    type: "http"
+    metadata: { status: 408 }
   },
   409: {
-    httpStatus: 409,
     code: "CONFLICT",
     name: "Conflict Error",
     message: "Conflict.",
     uiMessage: "The request conflicts with the current state. Please refresh and try again.",
-    type: "http"
+    metadata: { status: 409 }
   },
   410: {
-    httpStatus: 410,
     code: "GONE",
     name: "Gone Error",
     message: "Gone.",
     uiMessage: "This resource is no longer available.",
-    type: "http"
+    metadata: { status: 410 }
   },
   411: {
-    httpStatus: 411,
     code: "LENGTH_REQUIRED",
     name: "Length Required Error",
     message: "Length required.",
     uiMessage: "The request is missing required length information.",
-    type: "http"
+    metadata: { status: 411 }
   },
   412: {
-    httpStatus: 412,
     code: "PRECONDITION_FAILED",
     name: "Precondition Failed Error",
     message: "Precondition failed.",
     uiMessage: "A required condition was not met. Please try again.",
-    type: "http"
+    metadata: { status: 412 }
   },
   413: {
-    httpStatus: 413,
     code: "PAYLOAD_TOO_LARGE",
     name: "Payload Too Large Error",
     message: "Payload too large.",
     uiMessage: "The request is too large. Please reduce the size and try again.",
-    type: "http"
+    metadata: { status: 413 }
   },
   414: {
-    httpStatus: 414,
     code: "URI_TOO_LONG",
     name: "URI Too Long Error",
     message: "URI too long.",
     uiMessage: "The request URL is too long.",
-    type: "http"
+    metadata: { status: 414 }
   },
   415: {
-    httpStatus: 415,
     code: "UNSUPPORTED_MEDIA_TYPE",
     name: "Unsupported Media Type Error",
     message: "Unsupported media type.",
     uiMessage: "The file type is not supported.",
-    type: "http"
+    metadata: { status: 415 }
   },
   416: {
-    httpStatus: 416,
     code: "RANGE_NOT_SATISFIABLE",
     name: "Range Not Satisfiable Error",
     message: "Range not satisfiable.",
     uiMessage: "The requested range cannot be satisfied.",
-    type: "http"
+    metadata: { status: 416 }
   },
   417: {
-    httpStatus: 417,
     code: "EXPECTATION_FAILED",
     name: "Expectation Failed Error",
     message: "Expectation failed.",
     uiMessage: "The server cannot meet the requirements of the request.",
-    type: "http"
+    metadata: { status: 417 }
   },
   418: {
-    httpStatus: 418,
     code: "IM_A_TEAPOT",
     name: "Im A Teapot Error",
     message: "I'm a teapot.",
     uiMessage: "I'm a teapot and cannot brew coffee.",
-    type: "http"
+    metadata: { status: 418 }
   },
   422: {
-    httpStatus: 422,
     code: "UNPROCESSABLE_ENTITY",
     name: "Unprocessable Entity Error",
     message: "Unprocessable entity.",
     uiMessage: "The request contains invalid data. Please check your input.",
-    type: "http"
+    metadata: { status: 422 }
   },
   423: {
-    httpStatus: 423,
     code: "LOCKED",
     name: "Locked Error",
     message: "Locked.",
     uiMessage: "This resource is locked and cannot be modified.",
-    type: "http"
+    metadata: { status: 423 }
   },
   424: {
-    httpStatus: 424,
     code: "FAILED_DEPENDENCY",
     name: "Failed Dependency Error",
     message: "Failed dependency.",
     uiMessage: "The request failed due to a dependency error.",
-    type: "http"
+    metadata: { status: 424 }
   },
   425: {
-    httpStatus: 425,
     code: "TOO_EARLY",
     name: "Too Early Error",
     message: "Too early.",
     uiMessage: "The request was sent too early. Please try again later.",
-    type: "http"
+    metadata: { status: 425 }
   },
   426: {
-    httpStatus: 426,
     code: "UPGRADE_REQUIRED",
     name: "Upgrade Required Error",
     message: "Upgrade required.",
     uiMessage: "Please upgrade to continue using this service.",
-    type: "http"
+    metadata: { status: 426 }
   },
   428: {
-    httpStatus: 428,
     code: "PRECONDITION_REQUIRED",
     name: "Precondition Required Error",
     message: "Precondition required.",
     uiMessage: "Required conditions are missing from the request.",
-    type: "http"
+    metadata: { status: 428 }
   },
   429: {
-    httpStatus: 429,
     code: "TOO_MANY_REQUESTS",
     name: "Too Many Requests Error",
     message: "Too many requests.",
     uiMessage: "You have made too many requests. Please wait and try again.",
-    type: "http"
+    metadata: { status: 429 }
   },
   431: {
-    httpStatus: 431,
     code: "REQUEST_HEADER_FIELDS_TOO_LARGE",
     name: "Request Header Fields Too Large Error",
     message: "Request header fields too large.",
     uiMessage: "The request headers are too large.",
-    type: "http"
+    metadata: { status: 431 }
   },
   451: {
-    httpStatus: 451,
     code: "UNAVAILABLE_FOR_LEGAL_REASONS",
     name: "Unavailable For Legal Reasons Error",
     message: "Unavailable for legal reasons.",
     uiMessage: "This content is unavailable for legal reasons.",
-    type: "http"
+    metadata: { status: 451 }
   },
   // 5xx Server Errors
   500: {
-    httpStatus: 500,
     code: "INTERNAL_SERVER_ERROR",
     name: "Internal Server Error",
     message: "Internal server error.",
     uiMessage: "An unexpected error occurred. Please try again later.",
-    type: "http"
+    metadata: { status: 500 }
   },
   501: {
-    httpStatus: 501,
     code: "NOT_IMPLEMENTED",
     name: "Not Implemented Error",
     message: "Not implemented.",
     uiMessage: "This feature is not yet available.",
-    type: "http"
+    metadata: { status: 501 }
   },
   502: {
-    httpStatus: 502,
     code: "BAD_GATEWAY",
     name: "Bad Gateway Error",
     message: "Bad gateway.",
     uiMessage: "Unable to connect to the server. Please try again later.",
-    type: "http"
+    metadata: { status: 502 }
   },
   503: {
-    httpStatus: 503,
     code: "SERVICE_UNAVAILABLE",
     name: "Service Unavailable Error",
     message: "Service unavailable.",
     uiMessage: "The service is temporarily unavailable. Please try again later.",
-    type: "http"
+    metadata: { status: 503 }
   },
   504: {
-    httpStatus: 504,
     code: "GATEWAY_TIMEOUT",
     name: "Gateway Timeout Error",
     message: "Gateway timeout.",
     uiMessage: "The server took too long to respond. Please try again.",
-    type: "http"
+    metadata: { status: 504 }
   },
   505: {
-    httpStatus: 505,
     code: "HTTP_VERSION_NOT_SUPPORTED",
     name: "HTTP Version Not Supported Error",
     message: "HTTP version not supported.",
     uiMessage: "Your browser version is not supported.",
-    type: "http"
+    metadata: { status: 505 }
   },
   506: {
-    httpStatus: 506,
     code: "VARIANT_ALSO_NEGOTIATES",
     name: "Variant Also Negotiates Error",
     message: "Variant also negotiates.",
     uiMessage: "The server has an internal configuration error.",
-    type: "http"
+    metadata: { status: 506 }
   },
   507: {
-    httpStatus: 507,
     code: "INSUFFICIENT_STORAGE",
     name: "Insufficient Storage Error",
     message: "Insufficient storage.",
     uiMessage: "The server has insufficient storage to complete the request.",
-    type: "http"
+    metadata: { status: 507 }
   },
   508: {
-    httpStatus: 508,
     code: "LOOP_DETECTED",
     name: "Loop Detected Error",
     message: "Loop detected.",
     uiMessage: "The server detected an infinite loop.",
-    type: "http"
+    metadata: { status: 508 }
   },
   510: {
-    httpStatus: 510,
     code: "NOT_EXTENDED",
     name: "Not Extended Error",
     message: "Not extended.",
     uiMessage: "Additional extensions are required.",
-    type: "http"
+    metadata: { status: 510 }
   },
   511: {
-    httpStatus: 511,
     code: "NETWORK_AUTHENTICATION_REQUIRED",
     name: "Network Authentication Required Error",
     message: "Network authentication required.",
     uiMessage: "Network authentication is required to access this resource.",
-    type: "http"
+    metadata: { status: 511 }
   }
 };