@bombillazo/error-x 0.4.2 → 0.4.4

package/README.md

@@ -63,11 +63,11 @@ throw new ErrorX({
 })
 
 // Using HTTP presets
-throw new ErrorX(http.notFound)
+throw new ErrorX(http[404])
 
 // Customizing presets
 throw new ErrorX({
-  ...http.unauthorized,
+  ...http[401],
   message: 'Session expired',
   metadata: { userId: 123 }
 })
@@ -104,7 +104,7 @@ All parameters are optional. ErrorX uses sensible defaults:
 | sourceUrl | `string \| undefined`        | `undefined`                           | URL related to the error (API endpoint, page URL, resource URL)   |
 | docsUrl   | `string \| undefined`        | `undefined` or auto-generated         | Documentation URL for this specific error                         |
 | source    | `string \| undefined`        | `undefined` or from config            | Where the error originated (service name, module, component)      |
-| timestamp | `Date`                       | `new Date()`                          | When the error was created (read-only)                            |
+| timestamp | `number`                     | `Date.now()`                          | Unix epoch timestamp in milliseconds when error was created       |
 | stack     | `string`                     | Auto-generated                        | Stack trace with preservation and cleaning (inherited from Error) |
 
 ### HTTP Error Presets
@@ -115,12 +115,12 @@ ErrorX provides pre-configured error templates via the `http` export:
 import { ErrorX, http } from '@bombillazo/error-x'
 
 // Use preset directly
-throw new ErrorX(http.notFound)
+throw new ErrorX(http[404])
 // Result: 404 error with message "Not found.", code "NOT_FOUND", etc.
 
 // Override specific fields
 throw new ErrorX({
-  ...http.notFound,
+  ...http[404],
   message: 'User not found',
   metadata: { userId: 123 }
 })
@@ -130,7 +130,7 @@ try {
   // some operation
 } catch (originalError) {
   throw new ErrorX({
-    ...http.internalServerError,
+    ...http[500],
     cause: originalError,
     metadata: { operation: 'database-query' }
   })
@@ -139,7 +139,7 @@ try {
 
 #### Available Presets
 
-All presets use **camelCase naming** and include:
+All presets are indexed by **HTTP status code** (numeric keys) and include:
 - `httpStatus`: HTTP status code
 - `code`: Error code in UPPER_SNAKE_CASE
 - `name`: Descriptive error name
@@ -149,10 +149,10 @@ All presets use **camelCase naming** and include:
 
 **4xx Client Errors:**
 
-`badRequest`, `unauthorized`, `paymentRequired`, `forbidden`, `notFound`, `methodNotAllowed`, `notAcceptable`, `proxyAuthenticationRequired`, `requestTimeout`, `conflict`, `gone`, `lengthRequired`, `preconditionFailed`, `payloadTooLarge`, `uriTooLong`, `unsupportedMediaType`, `rangeNotSatisfiable`, `expectationFailed`, `imATeapot`, `unprocessableEntity`, `locked`, `failedDependency`, `tooEarly`, `upgradeRequired`, `preconditionRequired`, `tooManyRequests`, `requestHeaderFieldsTooLarge`, `unavailableForLegalReasons`
+`400`, `401`, `402`, `403`, `404`, `405`, `406`, `407`, `408`, `409`, `410`, `411`, `412`, `413`, `414`, `415`, `416`, `417`, `418`, `422`, `423`, `424`, `425`, `426`, `428`, `429`, `431`, `451`
 
 **5xx Server Errors:**
-`internalServerError`, `notImplemented`, `badGateway`, `serviceUnavailable`, `gatewayTimeout`, `httpVersionNotSupported`, `variantAlsoNegotiates`, `insufficientStorage`, `loopDetected`, `notExtended`, `networkAuthenticationRequired`
+`500`, `501`, `502`, `503`, `504`, `505`, `506`, `507`, `508`, `510`, `511`
 
 #### Creating Your Own Presets
 
@@ -344,7 +344,7 @@ async function fetchUser(id: string) {
     const response = await fetch(`/api/users/${id}`)
     if (!response.ok) {
       throw new ErrorX({
-        ...http[response.status === 404 ? 'notFound' : 'internalServerError'],
+        ...http[response.status === 404 ? 404 : 500],
         metadata: { status: response.status, statusText: response.statusText }
       })
     }

package/dist/index.cjs

@@ -34,7 +34,7 @@ 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;
@@ -100,7 +100,7 @@ var ErrorX = class _ErrorX extends Error {
     this.metadata = options.metadata;
     this.httpStatus = _ErrorX.validateHttpStatus(options.httpStatus);
     this.type = _ErrorX.validateType(options.type);
-    this.timestamp = /* @__PURE__ */ new Date();
+    this.timestamp = Date.now();
     this.sourceUrl = options.sourceUrl;
     this.source = options.source ?? envConfig?.source;
     let generatedDocsUrl;
@@ -119,8 +119,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.
@@ -526,7 +526,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() {
@@ -535,7 +535,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__default.default(this.metadata);
       parts.push(`metadata: ${metadataStr}`);
@@ -576,7 +576,7 @@ ${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;
@@ -616,7 +616,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)
@@ -643,7 +643,7 @@ ${this.stack}`;
     if (serialized.stack) {
       error.stack = serialized.stack;
     }
-    error.timestamp = new Date(serialized.timestamp);
+    error.timestamp = serialized.timestamp;
     return error;
   }
 };
@@ -651,7 +651,7 @@ ${this.stack}`;
 // src/presets.ts
 var http = {
   // 4xx Client Errors
-  badRequest: {
+  400: {
     httpStatus: 400,
     code: "BAD_REQUEST",
     name: "Bad Request Error",
@@ -659,7 +659,7 @@ var http = {
     uiMessage: "The request could not be processed. Please check your input and try again.",
     type: "http"
   },
-  unauthorized: {
+  401: {
     httpStatus: 401,
     code: "UNAUTHORIZED",
     name: "Unauthorized Error",
@@ -667,7 +667,7 @@ var http = {
     uiMessage: "Authentication required. Please log in to continue.",
     type: "http"
   },
-  paymentRequired: {
+  402: {
     httpStatus: 402,
     code: "PAYMENT_REQUIRED",
     name: "Payment Required Error",
@@ -675,7 +675,7 @@ var http = {
     uiMessage: "Payment is required to access this resource.",
     type: "http"
   },
-  forbidden: {
+  403: {
     httpStatus: 403,
     code: "FORBIDDEN",
     name: "Forbidden Error",
@@ -683,7 +683,7 @@ var http = {
     uiMessage: "You do not have permission to access this resource.",
     type: "http"
   },
-  notFound: {
+  404: {
     httpStatus: 404,
     code: "NOT_FOUND",
     name: "Not Found Error",
@@ -691,7 +691,7 @@ var http = {
     uiMessage: "The requested resource could not be found.",
     type: "http"
   },
-  methodNotAllowed: {
+  405: {
     httpStatus: 405,
     code: "METHOD_NOT_ALLOWED",
     name: "Method Not Allowed Error",
@@ -699,7 +699,7 @@ var http = {
     uiMessage: "This action is not allowed for the requested resource.",
     type: "http"
   },
-  notAcceptable: {
+  406: {
     httpStatus: 406,
     code: "NOT_ACCEPTABLE",
     name: "Not Acceptable Error",
@@ -707,7 +707,7 @@ var http = {
     uiMessage: "The requested format is not supported.",
     type: "http"
   },
-  proxyAuthenticationRequired: {
+  407: {
     httpStatus: 407,
     code: "PROXY_AUTHENTICATION_REQUIRED",
     name: "Proxy Authentication Required Error",
@@ -715,7 +715,7 @@ var http = {
     uiMessage: "Proxy authentication is required to access this resource.",
     type: "http"
   },
-  requestTimeout: {
+  408: {
     httpStatus: 408,
     code: "REQUEST_TIMEOUT",
     name: "Request Timeout Error",
@@ -723,7 +723,7 @@ var http = {
     uiMessage: "The request took too long to complete. Please try again.",
     type: "http"
   },
-  conflict: {
+  409: {
     httpStatus: 409,
     code: "CONFLICT",
     name: "Conflict Error",
@@ -731,7 +731,7 @@ var http = {
     uiMessage: "The request conflicts with the current state. Please refresh and try again.",
     type: "http"
   },
-  gone: {
+  410: {
     httpStatus: 410,
     code: "GONE",
     name: "Gone Error",
@@ -739,7 +739,7 @@ var http = {
     uiMessage: "This resource is no longer available.",
     type: "http"
   },
-  lengthRequired: {
+  411: {
     httpStatus: 411,
     code: "LENGTH_REQUIRED",
     name: "Length Required Error",
@@ -747,7 +747,7 @@ var http = {
     uiMessage: "The request is missing required length information.",
     type: "http"
   },
-  preconditionFailed: {
+  412: {
     httpStatus: 412,
     code: "PRECONDITION_FAILED",
     name: "Precondition Failed Error",
@@ -755,7 +755,7 @@ var http = {
     uiMessage: "A required condition was not met. Please try again.",
     type: "http"
   },
-  payloadTooLarge: {
+  413: {
     httpStatus: 413,
     code: "PAYLOAD_TOO_LARGE",
     name: "Payload Too Large Error",
@@ -763,7 +763,7 @@ var http = {
     uiMessage: "The request is too large. Please reduce the size and try again.",
     type: "http"
   },
-  uriTooLong: {
+  414: {
     httpStatus: 414,
     code: "URI_TOO_LONG",
     name: "URI Too Long Error",
@@ -771,7 +771,7 @@ var http = {
     uiMessage: "The request URL is too long.",
     type: "http"
   },
-  unsupportedMediaType: {
+  415: {
     httpStatus: 415,
     code: "UNSUPPORTED_MEDIA_TYPE",
     name: "Unsupported Media Type Error",
@@ -779,7 +779,7 @@ var http = {
     uiMessage: "The file type is not supported.",
     type: "http"
   },
-  rangeNotSatisfiable: {
+  416: {
     httpStatus: 416,
     code: "RANGE_NOT_SATISFIABLE",
     name: "Range Not Satisfiable Error",
@@ -787,7 +787,7 @@ var http = {
     uiMessage: "The requested range cannot be satisfied.",
     type: "http"
   },
-  expectationFailed: {
+  417: {
     httpStatus: 417,
     code: "EXPECTATION_FAILED",
     name: "Expectation Failed Error",
@@ -795,7 +795,7 @@ var http = {
     uiMessage: "The server cannot meet the requirements of the request.",
     type: "http"
   },
-  imATeapot: {
+  418: {
     httpStatus: 418,
     code: "IM_A_TEAPOT",
     name: "Im A Teapot Error",
@@ -803,7 +803,7 @@ var http = {
     uiMessage: "I'm a teapot and cannot brew coffee.",
     type: "http"
   },
-  unprocessableEntity: {
+  422: {
     httpStatus: 422,
     code: "UNPROCESSABLE_ENTITY",
     name: "Unprocessable Entity Error",
@@ -811,7 +811,7 @@ var http = {
     uiMessage: "The request contains invalid data. Please check your input.",
     type: "http"
   },
-  locked: {
+  423: {
     httpStatus: 423,
     code: "LOCKED",
     name: "Locked Error",
@@ -819,7 +819,7 @@ var http = {
     uiMessage: "This resource is locked and cannot be modified.",
     type: "http"
   },
-  failedDependency: {
+  424: {
     httpStatus: 424,
     code: "FAILED_DEPENDENCY",
     name: "Failed Dependency Error",
@@ -827,7 +827,7 @@ var http = {
     uiMessage: "The request failed due to a dependency error.",
     type: "http"
   },
-  tooEarly: {
+  425: {
     httpStatus: 425,
     code: "TOO_EARLY",
     name: "Too Early Error",
@@ -835,7 +835,7 @@ var http = {
     uiMessage: "The request was sent too early. Please try again later.",
     type: "http"
   },
-  upgradeRequired: {
+  426: {
     httpStatus: 426,
     code: "UPGRADE_REQUIRED",
     name: "Upgrade Required Error",
@@ -843,7 +843,7 @@ var http = {
     uiMessage: "Please upgrade to continue using this service.",
     type: "http"
   },
-  preconditionRequired: {
+  428: {
     httpStatus: 428,
     code: "PRECONDITION_REQUIRED",
     name: "Precondition Required Error",
@@ -851,7 +851,7 @@ var http = {
     uiMessage: "Required conditions are missing from the request.",
     type: "http"
   },
-  tooManyRequests: {
+  429: {
     httpStatus: 429,
     code: "TOO_MANY_REQUESTS",
     name: "Too Many Requests Error",
@@ -859,7 +859,7 @@ var http = {
     uiMessage: "You have made too many requests. Please wait and try again.",
     type: "http"
   },
-  requestHeaderFieldsTooLarge: {
+  431: {
     httpStatus: 431,
     code: "REQUEST_HEADER_FIELDS_TOO_LARGE",
     name: "Request Header Fields Too Large Error",
@@ -867,7 +867,7 @@ var http = {
     uiMessage: "The request headers are too large.",
     type: "http"
   },
-  unavailableForLegalReasons: {
+  451: {
     httpStatus: 451,
     code: "UNAVAILABLE_FOR_LEGAL_REASONS",
     name: "Unavailable For Legal Reasons Error",
@@ -876,7 +876,7 @@ var http = {
     type: "http"
   },
   // 5xx Server Errors
-  internalServerError: {
+  500: {
     httpStatus: 500,
     code: "INTERNAL_SERVER_ERROR",
     name: "Internal Server Error",
@@ -884,7 +884,7 @@ var http = {
     uiMessage: "An unexpected error occurred. Please try again later.",
     type: "http"
   },
-  notImplemented: {
+  501: {
     httpStatus: 501,
     code: "NOT_IMPLEMENTED",
     name: "Not Implemented Error",
@@ -892,7 +892,7 @@ var http = {
     uiMessage: "This feature is not yet available.",
     type: "http"
   },
-  badGateway: {
+  502: {
     httpStatus: 502,
     code: "BAD_GATEWAY",
     name: "Bad Gateway Error",
@@ -900,7 +900,7 @@ var http = {
     uiMessage: "Unable to connect to the server. Please try again later.",
     type: "http"
   },
-  serviceUnavailable: {
+  503: {
     httpStatus: 503,
     code: "SERVICE_UNAVAILABLE",
     name: "Service Unavailable Error",
@@ -908,7 +908,7 @@ var http = {
     uiMessage: "The service is temporarily unavailable. Please try again later.",
     type: "http"
   },
-  gatewayTimeout: {
+  504: {
     httpStatus: 504,
     code: "GATEWAY_TIMEOUT",
     name: "Gateway Timeout Error",
@@ -916,7 +916,7 @@ var http = {
     uiMessage: "The server took too long to respond. Please try again.",
     type: "http"
   },
-  httpVersionNotSupported: {
+  505: {
     httpStatus: 505,
     code: "HTTP_VERSION_NOT_SUPPORTED",
     name: "HTTP Version Not Supported Error",
@@ -924,7 +924,7 @@ var http = {
     uiMessage: "Your browser version is not supported.",
     type: "http"
   },
-  variantAlsoNegotiates: {
+  506: {
     httpStatus: 506,
     code: "VARIANT_ALSO_NEGOTIATES",
     name: "Variant Also Negotiates Error",
@@ -932,7 +932,7 @@ var http = {
     uiMessage: "The server has an internal configuration error.",
     type: "http"
   },
-  insufficientStorage: {
+  507: {
     httpStatus: 507,
     code: "INSUFFICIENT_STORAGE",
     name: "Insufficient Storage Error",
@@ -940,7 +940,7 @@ var http = {
     uiMessage: "The server has insufficient storage to complete the request.",
     type: "http"
   },
-  loopDetected: {
+  508: {
     httpStatus: 508,
     code: "LOOP_DETECTED",
     name: "Loop Detected Error",
@@ -948,7 +948,7 @@ var http = {
     uiMessage: "The server detected an infinite loop.",
     type: "http"
   },
-  notExtended: {
+  510: {
     httpStatus: 510,
     code: "NOT_EXTENDED",
     name: "Not Extended Error",
@@ -956,7 +956,7 @@ var http = {
     uiMessage: "Additional extensions are required.",
     type: "http"
   },
-  networkAuthenticationRequired: {
+  511: {
     httpStatus: 511,
     code: "NETWORK_AUTHENTICATION_REQUIRED",
     name: "Network Authentication Required Error",