@bombillazo/error-x 0.4.4 → 0.4.6

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) */
@@ -108,7 +104,6 @@ type ErrorXCause = {
  *     message: 'Request timeout.',
  *     stack: '...'
  *   },
- *   sourceUrl: 'https://api.example.com/auth',
  *   docsUrl: 'https://docs.example.com/errors#auth-failed',
  *   source: 'auth-service'
  * }
@@ -133,12 +128,8 @@ type ErrorXSerialized = {
     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 */
@@ -220,12 +211,8 @@ declare class ErrorX<TMetadata extends ErrorXMetadata = ErrorXMetadata> extends
     metadata: TMetadata | undefined;
     /** Unix epoch timestamp (milliseconds) when the error was created */
     timestamp: number;
-    /** 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) */
@@ -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
      *
@@ -423,7 +403,8 @@ declare class ErrorX<TMetadata extends ErrorXMetadata = ErrorXMetadata> extends
     /**
      * Converts unknown input into ErrorXOptions with intelligent property extraction.
      * Handles strings, regular Error objects, API response objects, and unknown values.
-     * This is a private helper method used by both the constructor and toErrorX.
+     * Extracts metadata directly from objects if present, without wrapping.
+     * This is a private helper method used by ErrorX.from().
      *
      * @param error - Value to convert to ErrorXOptions
      * @returns ErrorXOptions object with extracted properties
@@ -433,6 +414,7 @@ declare class ErrorX<TMetadata extends ErrorXMetadata = ErrorXMetadata> extends
     /**
      * Converts unknown input into an ErrorX instance with intelligent property extraction.
      * Handles strings, regular Error objects, API response objects, and unknown values.
+     * Extracts metadata directly from objects if present.
      *
      * @param error - Value to convert to ErrorX
      * @returns ErrorX instance with extracted properties
@@ -449,9 +431,10 @@ declare class ErrorX<TMetadata extends ErrorXMetadata = ErrorXMetadata> extends
      * const apiError = {
      *   message: 'User not found',
      *   code: 'USER_404',
-     *   statusText: 'Not Found'
+     *   metadata: { userId: 123, endpoint: '/api/users' }
      * }
      * const error3 = ErrorX.from(apiError)
+     * // error3.metadata = { userId: 123, endpoint: '/api/users' }
      * ```
      */
     static from<TMetadata extends ErrorXMetadata = ErrorXMetadata>(error: ErrorX<TMetadata>): ErrorX<TMetadata>;
@@ -631,316 +614,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;
+        };
     };
 };