@bombillazo/error-x 0.2.0 → 0.2.1

package/dist/index.d.ts

@@ -207,6 +207,10 @@ type ErrorXOptions = {
     metadata?: ErrorMetadata;
     /** Actions to perform when this error occurs (default: undefined) */
     actions?: ErrorAction[];
+    /** HTTP status code (100-599) for HTTP-related errors (default: undefined) */
+    httpStatus?: number | undefined;
+    /** Error type for categorization */
+    type?: string | undefined;
 };
 /**
  * JSON-serializable representation of an ErrorX instance.
@@ -255,6 +259,10 @@ type SerializableError = {
     actions?: ErrorAction[];
     /** Serialized cause error (for error chaining) */
     cause?: SerializableError;
+    /** HTTP status code for HTTP-related errors */
+    httpStatus?: number;
+    /** Error type for categorization */
+    type?: string;
 };
 
 /**
@@ -288,6 +296,10 @@ declare class ErrorX extends Error {
     readonly timestamp: Date;
     /** Error actions for UI behavior and handling */
     readonly actions: ErrorAction[] | undefined;
+    /** HTTP status code (100-599) for HTTP-related errors */
+    readonly httpStatus: number | undefined;
+    /** Error type for categorization */
+    readonly type: string | undefined;
     /**
      * Creates a new ErrorX instance with enhanced error handling capabilities.
      *
@@ -331,6 +343,20 @@ declare class ErrorX extends Error {
      * @returns Default error name 'Error'
      */
     private static getDefaultName;
+    /**
+     * 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
+     *
+     * @param type - Type value to validate
+     * @returns Validated type string or undefined if invalid/empty
+     */
+    private static validateType;
     /**
      * Validates if an object is a valid ErrorXOptions object.
      * Checks that the object only contains accepted ErrorXOptions fields.
@@ -572,4 +598,352 @@ declare class ErrorX extends Error {
     static fromJSON(serialized: SerializableError): ErrorX;
 }
 
-export { type CustomAction, type ErrorAction, type ErrorMetadata, ErrorX, type ErrorXOptions, type HandlingTarget, HandlingTargets, type LogoutAction, type NotifyAction, type RedirectAction, type SerializableError };
+/**
+ * Preset configurations for common errors organized by category.
+ * Each preset includes httpStatus (for HTTP errors), code, name, message, and uiMessage.
+ *
+ * @example
+ * ```typescript
+ * import { ErrorX, ErrorPresets } from '@bombillazo/error-x'
+ *
+ * // Use preset directly
+ * const error = new ErrorX(ErrorPresets.HTTP.NOT_FOUND)
+ *
+ * // Override preset values
+ * const error = new ErrorX({
+ *   ...ErrorPresets.HTTP.NOT_FOUND,
+ *   message: 'User not found',
+ *   metadata: { userId: 123 }
+ * })
+ *
+ * // Use with additional options
+ * const error = new ErrorX({
+ *   ...ErrorPresets.HTTP.UNAUTHORIZED,
+ *   actions: [{ action: 'redirect', payload: { redirectURL: '/login' } }]
+ * })
+ * ```
+ *
+ * @public
+ */
+declare const PRESETS: {
+    /**
+     * HTTP error presets for common HTTP status codes.
+     * Includes both 4xx client errors and 5xx server errors.
+     */
+    readonly HTTP: {
+        readonly BAD_REQUEST: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly UNAUTHORIZED: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly PAYMENT_REQUIRED: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly FORBIDDEN: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly NOT_FOUND: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly METHOD_NOT_ALLOWED: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly NOT_ACCEPTABLE: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly PROXY_AUTHENTICATION_REQUIRED: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly REQUEST_TIMEOUT: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly CONFLICT: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly GONE: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly LENGTH_REQUIRED: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly PRECONDITION_FAILED: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly PAYLOAD_TOO_LARGE: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly URI_TOO_LONG: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly UNSUPPORTED_MEDIA_TYPE: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly RANGE_NOT_SATISFIABLE: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly EXPECTATION_FAILED: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly IM_A_TEAPOT: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly UNPROCESSABLE_ENTITY: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly LOCKED: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly FAILED_DEPENDENCY: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly TOO_EARLY: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly UPGRADE_REQUIRED: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly PRECONDITION_REQUIRED: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly TOO_MANY_REQUESTS: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly REQUEST_HEADER_FIELDS_TOO_LARGE: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly UNAVAILABLE_FOR_LEGAL_REASONS: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly INTERNAL_SERVER_ERROR: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly NOT_IMPLEMENTED: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly BAD_GATEWAY: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly SERVICE_UNAVAILABLE: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly GATEWAY_TIMEOUT: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly HTTP_VERSION_NOT_SUPPORTED: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly VARIANT_ALSO_NEGOTIATES: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly INSUFFICIENT_STORAGE: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly LOOP_DETECTED: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly NOT_EXTENDED: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+        readonly NETWORK_AUTHENTICATION_REQUIRED: {
+            httpStatus: number;
+            code: string;
+            name: string;
+            message: string;
+            uiMessage: string;
+            type: string;
+        };
+    };
+};
+
+export { type CustomAction, type ErrorAction, type ErrorMetadata, ErrorX, type ErrorXOptions, type HandlingTarget, HandlingTargets, type LogoutAction, type NotifyAction, PRESETS, type RedirectAction, type SerializableError };