@bombillazo/error-x 0.4.3 → 0.4.5

package/dist/index.d.cts

@@ -64,12 +64,8 @@ type ErrorXOptions<TMetadata extends ErrorXMetadata = ErrorXMetadata> = {
     cause?: ErrorXCause | Error | unknown;
     /** Additional context and debugging information */
     metadata?: TMetadata | undefined;
-    /** HTTP status code (100-599) for HTTP-related errors */
-    httpStatus?: number | undefined;
     /** Error type for categorization */
     type?: string | undefined;
-    /** Source URL related to the error (API endpoint, page URL, resource URL) */
-    sourceUrl?: string | undefined;
     /** Documentation URL for this specific error */
     docsUrl?: string | undefined;
     /** Where the error originated (service name, module, component) */
@@ -102,13 +98,12 @@ type ErrorXCause = {
  *   uiMessage: 'Please check your credentials',
  *   stack: 'Error: Authentication failed.\n    at login (auth.ts:42:15)',
  *   metadata: { userId: 123, loginAttempt: 3 },
- *   timestamp: '2024-01-15T10:30:45.123Z',
+ *   timestamp: 1705315845123,
  *   cause: {
  *     name: 'NetworkError',
  *     message: 'Request timeout.',
  *     stack: '...'
  *   },
- *   sourceUrl: 'https://api.example.com/auth',
  *   docsUrl: 'https://docs.example.com/errors#auth-failed',
  *   source: 'auth-service'
  * }
@@ -129,16 +124,12 @@ type ErrorXSerialized = {
     stack?: string;
     /** Additional context and debugging information */
     metadata: ErrorXMetadata | undefined;
-    /** ISO timestamp when error was created */
-    timestamp: string;
+    /** Unix epoch timestamp (milliseconds) when error was created */
+    timestamp: number;
     /** Simplified cause error (for error chaining) */
     cause?: ErrorXCause;
-    /** HTTP status code for HTTP-related errors */
-    httpStatus?: number;
     /** Error type for categorization */
     type?: string;
-    /** Source URL related to the error */
-    sourceUrl?: string;
     /** Documentation URL for this error */
     docsUrl?: string;
     /** Where the error originated */
@@ -218,14 +209,10 @@ declare class ErrorX<TMetadata extends ErrorXMetadata = ErrorXMetadata> extends
     uiMessage: string | undefined;
     /** Additional context and metadata associated with the error */
     metadata: TMetadata | undefined;
-    /** Timestamp when the error was created */
-    timestamp: Date;
-    /** HTTP status code (100-599) for HTTP-related errors */
-    httpStatus: number | undefined;
+    /** Unix epoch timestamp (milliseconds) when the error was created */
+    timestamp: number;
     /** Error type for categorization */
     type: string | undefined;
-    /** Source URL related to the error (API endpoint, page URL, resource URL) */
-    sourceUrl: string | undefined;
     /** Documentation URL for this specific error */
     docsUrl: string | undefined;
     /** Where the error originated (service name, module, component) */
@@ -314,13 +301,6 @@ declare class ErrorX<TMetadata extends ErrorXMetadata = ErrorXMetadata> extends
      * ```
      */
     static resetConfig(): void;
-    /**
-     * 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
-     */
-    private static validateHttpStatus;
     /**
      * Validates and normalizes the type field
      *
@@ -400,7 +380,7 @@ declare class ErrorX<TMetadata extends ErrorXMetadata = ErrorXMetadata> extends
      * // Result: metadata = { endpoint: '/users', retryCount: 3, userId: 123 }
      * ```
      */
-    withMetadata(additionalMetadata: Partial<TMetadata>): ErrorX<TMetadata>;
+    withMetadata<TAdditionalMetadata extends Record<string, unknown> = ErrorXMetadata>(additionalMetadata: TAdditionalMetadata): ErrorX<TMetadata & TAdditionalMetadata>;
     /**
      * Type guard that checks if a value is an ErrorX instance.
      *
@@ -474,7 +454,7 @@ declare class ErrorX<TMetadata extends ErrorXMetadata = ErrorXMetadata> extends
      * })
      *
      * 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(): string;
@@ -512,7 +492,7 @@ declare class ErrorX<TMetadata extends ErrorXMetadata = ErrorXMetadata> extends
      *   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)
@@ -631,316 +611,355 @@ declare class ErrorX<TMetadata extends ErrorXMetadata = ErrorXMetadata> extends
  */
 declare const http: {
     readonly 400: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 401: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 402: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 403: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 404: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 405: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 406: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 407: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 408: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 409: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 410: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 411: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 412: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 413: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 414: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 415: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 416: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 417: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 418: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 422: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 423: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 424: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 425: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 426: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 428: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 429: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 431: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 451: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 500: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 501: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 502: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 503: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 504: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 505: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 506: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 507: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 508: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 510: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
     readonly 511: {
-        httpStatus: number;
         code: string;
         name: string;
         message: string;
         uiMessage: string;
-        type: string;
+        metadata: {
+            status: number;
+        };
     };
 };