@bombillazo/error-x 0.3.0 → 0.4.0

package/dist/index.js

@@ -3,16 +3,6 @@ import safeStringify from 'safe-stringify';
 // src/error.ts
 
 // src/types.ts
-var HandlingTargets = /* @__PURE__ */ ((HandlingTargets2) => {
-  HandlingTargets2["MODAL"] = "modal";
-  HandlingTargets2["TOAST"] = "toast";
-  HandlingTargets2["INLINE"] = "inline";
-  HandlingTargets2["BANNER"] = "banner";
-  HandlingTargets2["CONSOLE"] = "console";
-  HandlingTargets2["LOGGER"] = "logger";
-  HandlingTargets2["NOTIFICATION"] = "notification";
-  return HandlingTargets2;
-})(HandlingTargets || {});
 var ERROR_X_OPTION_FIELDS = [
   "message",
   "name",
@@ -20,14 +10,18 @@ var ERROR_X_OPTION_FIELDS = [
   "uiMessage",
   "cause",
   "metadata",
-  "actions",
   "httpStatus",
-  "type"
+  "type",
+  "sourceUrl",
+  "docsUrl",
+  "source"
 ];
 
 // src/error.ts
 var acceptedFields = new Set(ERROR_X_OPTION_FIELDS);
 var ErrorX = class _ErrorX extends Error {
+  /** Global configuration for all ErrorX instances */
+  static _config = null;
   /** Error identifier code, auto-generated from name if not provided */
   code;
   /** User-friendly message suitable for display in UI */
@@ -36,71 +30,87 @@ var ErrorX = class _ErrorX extends Error {
   metadata;
   /** Timestamp when the error was created */
   timestamp;
-  /** Error actions for UI behavior and handling */
-  actions;
   /** 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) */
+  source;
   /**
    * Creates a new ErrorX instance with enhanced error handling capabilities.
    *
-   * @param messageOrOptions - Error message string, ErrorXOptions object, or any value to convert to ErrorX
-   * @param additionalOptions - Additional options when first parameter is a string (optional)
+   * @param messageOrOptions - Error message string or ErrorXOptions object (optional)
    *
    * @example
    * ```typescript
+   * // Create with default message
+   * const error1 = new ErrorX()
+   *
    * // Create with string message only
-   * const error1 = new ErrorX('Database query failed')
+   * const error2 = new ErrorX('Database query failed')
    *
-   * // Create with string message and additional options
-   * const error2 = new ErrorX('Database query failed', {
+   * // Create with options object
+   * const error3 = new ErrorX({
+   *   message: 'Database query failed',
    *   name: 'DatabaseError',
    *   code: 'DB_QUERY_FAILED',
    *   uiMessage: 'Unable to load data. Please try again.',
    *   metadata: { query: 'SELECT * FROM users', timeout: 5000 }
    * })
    *
-   * // Create with options object (backward compatible)
-   * const error3 = new ErrorX({
-   *   message: 'Database query failed',
-   *   name: 'DatabaseError',
-   *   code: 'DB_QUERY_FAILED',
-   *   actions: [
-   *     { action: 'notify', payload: { targets: [HandlingTargets.TOAST] } }
-   *   ]
+   * // With type-safe metadata
+   * type MyMeta = { userId: number };
+   * const error4 = new ErrorX<MyMeta>({
+   *   message: 'User action failed',
+   *   metadata: { userId: 123 }
    * })
    *
-   * // Create with unknown input (smart conversion)
+   * // For converting unknown errors, use ErrorX.from()
    * const apiError = { message: 'User not found', code: 404 }
-   * const error4 = new ErrorX(apiError)
-   *
-   * // Create with no options (uses defaults)
-   * const error5 = new ErrorX()
+   * const error5 = ErrorX.from(apiError)
    * ```
    */
-  constructor(messageOrOptions, additionalOptions) {
+  constructor(messageOrOptions) {
     let options = {};
     if (typeof messageOrOptions === "string") {
-      options = {
-        message: messageOrOptions,
-        ...additionalOptions
-      };
-    } else if (_ErrorX.isErrorXOptions(messageOrOptions)) {
-      options = messageOrOptions;
+      options = { message: messageOrOptions };
     } else if (messageOrOptions != null) {
-      options = _ErrorX.convertUnknownToOptions(messageOrOptions);
+      options = messageOrOptions;
+    }
+    const envConfig = _ErrorX.getConfig();
+    const message = options.message?.trim() ? options.message : "An error occurred";
+    super(message, { cause: options.cause });
+    if (options.cause !== void 0 && !Object.hasOwn(this, "cause")) {
+      Object.defineProperty(this, "cause", {
+        value: options.cause,
+        writable: true,
+        enumerable: false,
+        configurable: true
+      });
     }
-    const formattedMessage = _ErrorX.formatMessage(options.message);
-    super(formattedMessage, { cause: options.cause });
     this.name = options.name ?? _ErrorX.getDefaultName();
     this.code = options.code != null ? String(options.code) : _ErrorX.generateDefaultCode(options.name);
     this.uiMessage = options.uiMessage;
     this.metadata = options.metadata;
-    this.actions = options.actions;
     this.httpStatus = _ErrorX.validateHttpStatus(options.httpStatus);
     this.type = _ErrorX.validateType(options.type);
     this.timestamp = /* @__PURE__ */ new Date();
+    this.sourceUrl = options.sourceUrl;
+    this.source = options.source ?? envConfig?.source;
+    let generatedDocsUrl;
+    if (envConfig?.docsBaseURL && envConfig?.docsMap && this.code) {
+      const docPath = envConfig.docsMap[this.code];
+      if (docPath) {
+        const base = envConfig.docsBaseURL.replace(/\/+$/, "");
+        const path = docPath.replace(/^\/+/, "");
+        generatedDocsUrl = `${base}/${path}`;
+      }
+    }
+    this.docsUrl = options.docsUrl ?? generatedDocsUrl;
     if (options.cause instanceof Error) {
       this.stack = _ErrorX.preserveOriginalStack(options.cause, this);
     } else {
@@ -117,6 +127,34 @@ var ErrorX = class _ErrorX extends Error {
   static getDefaultName() {
     return "Error";
   }
+  /**
+   * Configure global ErrorX settings.
+   * This method allows you to set defaults for all ErrorX instances.
+   *
+   * @param config - Configuration object
+   *
+   * @example
+   * ```typescript
+   * ErrorX.configure({
+   *   source: 'my-api-service',
+   *   docsBaseURL: 'https://docs.example.com/errors',
+   *   docsMap: {
+   *     'AUTH_FAILED': 'authentication-errors',
+   *     'DB_ERROR': 'database-errors'
+   *   }
+   * })
+   * ```
+   */
+  static configure(config) {
+    _ErrorX._config = { ..._ErrorX._config || {}, ...config };
+  }
+  /**
+   * Get the current global configuration.
+   * Returns null if no configuration has been set.
+   */
+  static getConfig() {
+    return _ErrorX._config;
+  }
   /**
    * Validates HTTP status code to ensure it's within valid range (100-599)
    *
@@ -212,10 +250,24 @@ var ErrorX = class _ErrorX extends Error {
    */
   static cleanStack(stack) {
     if (!stack) return "";
+    const config = _ErrorX.getConfig();
+    const cleanStackConfig = config?.cleanStack ?? true;
+    if (cleanStackConfig === false) {
+      return stack;
+    }
     const stackLines = stack.split("\n");
     const cleanedLines = [];
+    const defaultPatterns = [
+      "new ErrorX",
+      "ErrorX.constructor",
+      "ErrorX.from",
+      "error-x/dist/",
+      "error-x/src/error.ts"
+    ];
+    const patterns = Array.isArray(cleanStackConfig) ? cleanStackConfig : defaultPatterns;
     for (const line of stackLines) {
-      if (line.includes("new ErrorX") || line.includes("ErrorX.constructor") || line.includes("ErrorX.toErrorX") || line.includes("error-x/dist/") || line.includes("error-x/src/error.ts")) {
+      const shouldSkip = patterns.some((pattern) => line.includes(pattern));
+      if (shouldSkip) {
         continue;
       }
       cleanedLines.push(line);
@@ -245,35 +297,6 @@ var ErrorX = class _ErrorX extends Error {
     }
     return stack;
   }
-  /**
-   * Formats error messages with proper capitalization and punctuation.
-   * Ensures consistent message formatting across all ErrorX instances.
-   *
-   * @param message - Raw error message to format (optional)
-   * @returns Formatted message with proper capitalization and punctuation
-   *
-   * @example
-   * ```typescript
-   * formatMessage('database connection failed') // 'Database connection failed.'
-   * formatMessage('user not found. please check credentials') // 'User not found. Please check credentials.'
-   * formatMessage() // 'An error occurred'
-   * ```
-   */
-  static formatMessage(message) {
-    if (!message || typeof message !== "string" || !message.trim()) {
-      return "An error occurred";
-    }
-    let formatted = message.split(". ").map((sentence) => {
-      const trimmed = sentence.trim();
-      if (!trimmed) return trimmed;
-      return trimmed.charAt(0).toUpperCase() + trimmed.slice(1);
-    }).join(". ");
-    const endsWithPunctuation = /[.!?)\]]$/.test(formatted);
-    if (!endsWithPunctuation) {
-      formatted = `${formatted}.`;
-    }
-    return formatted;
-  }
   /**
    * Creates a new ErrorX instance with additional metadata merged with existing metadata.
    * The original error properties are preserved while extending the metadata.
@@ -304,15 +327,16 @@ var ErrorX = class _ErrorX extends Error {
       cause: this.cause,
       metadata: { ...this.metadata ?? {}, ...additionalMetadata },
       httpStatus: this.httpStatus,
-      type: this.type
+      type: this.type,
+      sourceUrl: this.sourceUrl,
+      docsUrl: this.docsUrl,
+      source: this.source
     };
-    if (this.actions) {
-      options.actions = this.actions;
-    }
     const newError = new _ErrorX(options);
     if (this.stack) {
       newError.stack = this.stack;
     }
+    newError.timestamp = this.timestamp;
     return newError;
   }
   /**
@@ -352,9 +376,11 @@ var ErrorX = class _ErrorX extends Error {
     let uiMessage = "";
     let cause;
     let metadata = {};
-    let actions;
     let httpStatus;
     let type;
+    let url;
+    let href;
+    let source;
     if (error) {
       if (typeof error === "string") {
         message = error;
@@ -377,9 +403,6 @@ 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);
-        if ("actions" in error && Array.isArray(error.actions)) {
-          actions = error.actions;
-        }
         let _httpStatus;
         if ("httpStatus" in error) {
           _httpStatus = error.httpStatus;
@@ -395,6 +418,25 @@ var ErrorX = class _ErrorX extends Error {
         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) {
+          href = String(error.href);
+        } else if ("documentationUrl" in error && error.documentationUrl) {
+          href = String(error.documentationUrl);
+        }
+        if ("source" in error && error.source) {
+          source = String(error.source);
+        } else if ("service" in error && error.service) {
+          source = String(error.service);
+        } else if ("component" in error && error.component) {
+          source = String(error.component);
+        }
         metadata = { originalError: error };
       }
     }
@@ -406,58 +448,18 @@ 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 (actions && actions.length > 0) options.actions = actions;
     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;
   }
-  /**
-   * Converts unknown input into an ErrorX instance with intelligent property extraction.
-   * Handles strings, regular Error objects, API response objects, and unknown values.
-   *
-   * @param error - Value to convert to ErrorX
-   * @returns ErrorX instance with extracted properties
-   *
-   * @example
-   * ```typescript
-   * // Convert string error
-   * const error1 = ErrorX.toErrorX('Something went wrong')
-   *
-   * // Convert regular Error
-   * const error2 = ErrorX.toErrorX(new Error('Database failed'))
-   *
-   * // Convert API response object
-   * const apiError = {
-   *   message: 'User not found',
-   *   code: 'USER_404',
-   *   statusText: 'Not Found'
-   * }
-   * const error3 = ErrorX.toErrorX(apiError)
-   * ```
-   */
-  static toErrorX(error) {
+  static from(error) {
     if (error instanceof _ErrorX) return error;
     const options = _ErrorX.convertUnknownToOptions(error);
     return new _ErrorX(options);
   }
-  /**
-   * Public wrapper for processing error stack traces with delimiter.
-   * Delegates to the private processErrorStack method for implementation.
-   *
-   * @param error - Error whose stack to process
-   * @param delimiter - String to search for in stack lines
-   * @returns Processed stack trace starting after the delimiter
-   *
-   * @example
-   * ```typescript
-   * const error = new Error('Something failed')
-   * const cleanStack = ErrorX.processStack(error, 'my-app-entry')
-   * // Returns stack trace starting after the line containing 'my-app-entry'
-   * ```
-   */
-  static processStack(error, delimiter) {
-    return _ErrorX.processErrorStack(error, delimiter);
-  }
   /**
    * Creates a new ErrorX instance with cleaned stack trace using the specified delimiter.
    * Returns the same instance if no delimiter is provided or no stack is available.
@@ -481,14 +483,14 @@ var ErrorX = class _ErrorX extends Error {
         uiMessage: this.uiMessage,
         cause: this.cause,
         httpStatus: this.httpStatus,
-        type: this.type
+        type: this.type,
+        sourceUrl: this.sourceUrl,
+        docsUrl: this.docsUrl,
+        source: this.source
       };
       if (this.metadata !== void 0) {
         options.metadata = this.metadata;
       }
-      if (this.actions) {
-        options.actions = this.actions;
-      }
       const newError = new _ErrorX(options);
       newError.stack = _ErrorX.processErrorStack(this, delimiter);
       return newError;
@@ -551,7 +553,10 @@ ${this.stack}`;
    * ```
    */
   toJSON() {
-    const safeMetadata = this.metadata ? JSON.parse(safeStringify(this.metadata)) : void 0;
+    let safeMetadata;
+    if (this.metadata) {
+      safeMetadata = JSON.parse(safeStringify(this.metadata));
+    }
     const serialized = {
       name: this.name,
       message: this.message,
@@ -560,35 +565,52 @@ ${this.stack}`;
       metadata: safeMetadata,
       timestamp: this.timestamp.toISOString()
     };
-    if (this.actions && this.actions.length > 0) {
-      const stringified = safeStringify(this.actions);
-      serialized.actions = JSON.parse(stringified);
-    }
     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;
+    }
+    if (this.source !== void 0) {
+      serialized.source = this.source;
+    }
     if (this.stack) {
       serialized.stack = this.stack;
     }
     if (this.cause) {
-      if (this.cause instanceof _ErrorX) {
-        serialized.cause = this.cause.toJSON();
-      } else if (this.cause instanceof Error) {
-        const causeData = {
-          name: this.cause.name,
-          message: this.cause.message,
-          code: "ERROR",
-          uiMessage: void 0,
-          metadata: {},
-          timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      if (this.cause instanceof Error) {
+        const cause = {
+          message: this.cause.message
         };
+        if (this.cause.name) {
+          cause.name = this.cause.name;
+        }
         if (this.cause.stack) {
-          causeData.stack = this.cause.stack;
+          cause.stack = this.cause.stack;
         }
-        serialized.cause = causeData;
+        serialized.cause = cause;
+      } else if (typeof this.cause === "object" && this.cause !== null) {
+        const causeObj = this.cause;
+        const cause = {
+          message: String(causeObj.message || causeObj)
+        };
+        if (causeObj.name) {
+          cause.name = String(causeObj.name);
+        }
+        if (causeObj.stack) {
+          cause.stack = String(causeObj.stack);
+        }
+        serialized.cause = cause;
+      } else {
+        serialized.cause = {
+          message: String(this.cause)
+        };
       }
     }
     return serialized;
@@ -622,468 +644,354 @@ ${this.stack}`;
       code: serialized.code,
       uiMessage: serialized.uiMessage,
       httpStatus: serialized.httpStatus,
-      type: serialized.type
+      type: serialized.type,
+      sourceUrl: serialized.sourceUrl,
+      docsUrl: serialized.docsUrl,
+      source: serialized.source
     };
     if (serialized.metadata !== void 0) {
       options.metadata = serialized.metadata;
     }
-    if (serialized.actions && serialized.actions.length > 0) {
-      options.actions = serialized.actions;
-    }
     const error = new _ErrorX(options);
     if (serialized.stack) {
       error.stack = serialized.stack;
     }
-    Object.defineProperty(error, "timestamp", {
-      value: new Date(serialized.timestamp),
-      writable: false
-    });
+    error.timestamp = new Date(serialized.timestamp);
     if (serialized.cause) {
+      const causeError = new Error(serialized.cause.message);
+      if (serialized.cause.name) {
+        causeError.name = serialized.cause.name;
+      }
+      if (serialized.cause.stack) {
+        causeError.stack = serialized.cause.stack;
+      }
       Object.defineProperty(error, "cause", {
-        value: _ErrorX.fromJSON(serialized.cause),
-        writable: false
+        value: causeError,
+        writable: true
       });
     }
     return error;
   }
-  /**
-   * HTTP error presets for common HTTP status codes.
-   *
-   * ## Features
-   * - **Pre-configured error templates** for common HTTP status codes (400-511)
-   * - **Type-safe** with TypeScript support
-   * - **Fully customizable** via destructuring and override pattern
-   * - **User-friendly messages** included for all presets
-   * - **Categorized by type** - all HTTP presets include `type: 'http'`
-   *
-   * ## Usage Patterns
-   *
-   * ### 1. Direct Usage
-   * Use a preset as-is without any modifications:
-   * ```typescript
-   * throw new ErrorX(ErrorX.HTTP.NOT_FOUND)
-   * // Result: 404 error with default message and UI message
-   * ```
-   *
-   * ### 2. Override Specific Fields
-   * Customize the error while keeping other preset values:
-   * ```typescript
-   * throw new ErrorX({
-   *   ...ErrorX.HTTP.NOT_FOUND,
-   *   message: 'User not found',
-   *   metadata: { userId: 123 }
-   * })
-   * // Result: 404 error with custom message but keeps httpStatus, code, name, uiMessage, type
-   * ```
-   *
-   * ### 3. Add Metadata and Actions
-   * Enhance presets with additional context and behaviors:
-   * ```typescript
-   * throw new ErrorX({
-   *   ...ErrorX.HTTP.UNAUTHORIZED,
-   *   metadata: { attemptedAction: 'viewProfile', userId: 456 },
-   *   actions: [
-   *     { action: 'logout', payload: { clearStorage: true } },
-   *     { action: 'redirect', payload: { redirectURL: '/login' } }
-   *   ]
-   * })
-   * ```
-   *
-   * ### 4. Add Error Cause
-   * Chain errors by adding a cause:
-   * ```typescript
-   * try {
-   *   // some operation
-   * } catch (originalError) {
-   *   throw new ErrorX({
-   *     ...ErrorX.HTTP.INTERNAL_SERVER_ERROR,
-   *     cause: originalError,
-   *     metadata: { operation: 'database-query' }
-   *   })
-   * }
-   * ```
-   *
-   * ## Common HTTP Presets
-   *
-   * ### 4xx Client Errors
-   * - `BAD_REQUEST` (400) - Invalid request data
-   * - `UNAUTHORIZED` (401) - Authentication required
-   * - `FORBIDDEN` (403) - Insufficient permissions
-   * - `NOT_FOUND` (404) - Resource not found
-   * - `METHOD_NOT_ALLOWED` (405) - HTTP method not allowed
-   * - `CONFLICT` (409) - Resource conflict
-   * - `UNPROCESSABLE_ENTITY` (422) - Validation failed
-   * - `TOO_MANY_REQUESTS` (429) - Rate limit exceeded
-   *
-   * ### 5xx Server Errors
-   * - `INTERNAL_SERVER_ERROR` (500) - Unexpected server error
-   * - `NOT_IMPLEMENTED` (501) - Feature not implemented
-   * - `BAD_GATEWAY` (502) - Upstream server error
-   * - `SERVICE_UNAVAILABLE` (503) - Service temporarily down
-   * - `GATEWAY_TIMEOUT` (504) - Upstream timeout
-   *
-   * @example
-   * ```typescript
-   * // API endpoint example
-   * app.get('/users/:id', async (req, res) => {
-   *   const user = await db.users.findById(req.params.id)
-   *
-   *   if (!user) {
-   *     throw new ErrorX({
-   *       ...ErrorX.HTTP.NOT_FOUND,
-   *       message: 'User not found',
-   *       metadata: { userId: req.params.id }
-   *     })
-   *   }
-   *
-   *   res.json(user)
-   * })
-   *
-   * // Authentication middleware example
-   * const requireAuth = (req, res, next) => {
-   *   if (!req.user) {
-   *     throw new ErrorX({
-   *       ...ErrorX.HTTP.UNAUTHORIZED,
-   *       actions: [
-   *         { action: 'redirect', payload: { redirectURL: '/login' } }
-   *       ]
-   *     })
-   *   }
-   *   next()
-   * }
-   *
-   * // Rate limiting example
-   * if (isRateLimited(req.ip)) {
-   *   throw new ErrorX({
-   *     ...ErrorX.HTTP.TOO_MANY_REQUESTS,
-   *     metadata: {
-   *       ip: req.ip,
-   *       retryAfter: 60
-   *     }
-   *   })
-   * }
-   * ```
-   *
-   * @public
-   */
-  static HTTP = {
-    // 4xx Client Errors
-    BAD_REQUEST: {
-      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"
-    },
-    UNAUTHORIZED: {
-      httpStatus: 401,
-      code: "UNAUTHORIZED",
-      name: "Unauthorized Error",
-      message: "unauthorized",
-      uiMessage: "Authentication required. Please log in to continue.",
-      type: "http"
-    },
-    PAYMENT_REQUIRED: {
-      httpStatus: 402,
-      code: "PAYMENT_REQUIRED",
-      name: "Payment Required Error",
-      message: "payment required",
-      uiMessage: "Payment is required to access this resource.",
-      type: "http"
-    },
-    FORBIDDEN: {
-      httpStatus: 403,
-      code: "FORBIDDEN",
-      name: "Forbidden Error",
-      message: "forbidden",
-      uiMessage: "You do not have permission to access this resource.",
-      type: "http"
-    },
-    NOT_FOUND: {
-      httpStatus: 404,
-      code: "NOT_FOUND",
-      name: "Not Found Error",
-      message: "not found",
-      uiMessage: "The requested resource could not be found.",
-      type: "http"
-    },
-    METHOD_NOT_ALLOWED: {
-      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"
-    },
-    NOT_ACCEPTABLE: {
-      httpStatus: 406,
-      code: "NOT_ACCEPTABLE",
-      name: "Not Acceptable Error",
-      message: "not acceptable",
-      uiMessage: "The requested format is not supported.",
-      type: "http"
-    },
-    PROXY_AUTHENTICATION_REQUIRED: {
-      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"
-    },
-    REQUEST_TIMEOUT: {
-      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"
-    },
-    CONFLICT: {
-      httpStatus: 409,
-      code: "CONFLICT",
-      name: "Conflict Error",
-      message: "conflict",
-      uiMessage: "The request conflicts with the current state. Please refresh and try again.",
-      type: "http"
-    },
-    GONE: {
-      httpStatus: 410,
-      code: "GONE",
-      name: "Gone Error",
-      message: "gone",
-      uiMessage: "This resource is no longer available.",
-      type: "http"
-    },
-    LENGTH_REQUIRED: {
-      httpStatus: 411,
-      code: "LENGTH_REQUIRED",
-      name: "Length Required Error",
-      message: "length required",
-      uiMessage: "The request is missing required length information.",
-      type: "http"
-    },
-    PRECONDITION_FAILED: {
-      httpStatus: 412,
-      code: "PRECONDITION_FAILED",
-      name: "Precondition Failed Error",
-      message: "precondition failed",
-      uiMessage: "A required condition was not met. Please try again.",
-      type: "http"
-    },
-    PAYLOAD_TOO_LARGE: {
-      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"
-    },
-    URI_TOO_LONG: {
-      httpStatus: 414,
-      code: "URI_TOO_LONG",
-      name: "URI Too Long Error",
-      message: "URI too long",
-      uiMessage: "The request URL is too long.",
-      type: "http"
-    },
-    UNSUPPORTED_MEDIA_TYPE: {
-      httpStatus: 415,
-      code: "UNSUPPORTED_MEDIA_TYPE",
-      name: "Unsupported Media Type Error",
-      message: "unsupported media type",
-      uiMessage: "The file type is not supported.",
-      type: "http"
-    },
-    RANGE_NOT_SATISFIABLE: {
-      httpStatus: 416,
-      code: "RANGE_NOT_SATISFIABLE",
-      name: "Range Not Satisfiable Error",
-      message: "range not satisfiable",
-      uiMessage: "The requested range cannot be satisfied.",
-      type: "http"
-    },
-    EXPECTATION_FAILED: {
-      httpStatus: 417,
-      code: "EXPECTATION_FAILED",
-      name: "Expectation Failed Error",
-      message: "expectation failed",
-      uiMessage: "The server cannot meet the requirements of the request.",
-      type: "http"
-    },
-    IM_A_TEAPOT: {
-      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"
-    },
-    UNPROCESSABLE_ENTITY: {
-      httpStatus: 422,
-      code: "UNPROCESSABLE_ENTITY",
-      name: "Unprocessable Entity Error",
-      message: "unprocessable entity",
-      uiMessage: "The request contains invalid data. Please check your input.",
-      type: "http"
-    },
-    LOCKED: {
-      httpStatus: 423,
-      code: "LOCKED",
-      name: "Locked Error",
-      message: "locked",
-      uiMessage: "This resource is locked and cannot be modified.",
-      type: "http"
-    },
-    FAILED_DEPENDENCY: {
-      httpStatus: 424,
-      code: "FAILED_DEPENDENCY",
-      name: "Failed Dependency Error",
-      message: "failed dependency",
-      uiMessage: "The request failed due to a dependency error.",
-      type: "http"
-    },
-    TOO_EARLY: {
-      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"
-    },
-    UPGRADE_REQUIRED: {
-      httpStatus: 426,
-      code: "UPGRADE_REQUIRED",
-      name: "Upgrade Required Error",
-      message: "upgrade required",
-      uiMessage: "Please upgrade to continue using this service.",
-      type: "http"
-    },
-    PRECONDITION_REQUIRED: {
-      httpStatus: 428,
-      code: "PRECONDITION_REQUIRED",
-      name: "Precondition Required Error",
-      message: "precondition required",
-      uiMessage: "Required conditions are missing from the request.",
-      type: "http"
-    },
-    TOO_MANY_REQUESTS: {
-      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"
-    },
-    REQUEST_HEADER_FIELDS_TOO_LARGE: {
-      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"
-    },
-    UNAVAILABLE_FOR_LEGAL_REASONS: {
-      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"
-    },
-    // 5xx Server Errors
-    INTERNAL_SERVER_ERROR: {
-      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"
-    },
-    NOT_IMPLEMENTED: {
-      httpStatus: 501,
-      code: "NOT_IMPLEMENTED",
-      name: "Not Implemented Error",
-      message: "not implemented",
-      uiMessage: "This feature is not yet available.",
-      type: "http"
-    },
-    BAD_GATEWAY: {
-      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"
-    },
-    SERVICE_UNAVAILABLE: {
-      httpStatus: 503,
-      code: "SERVICE_UNAVAILABLE",
-      name: "Service Unavailable Error",
-      message: "service unavailable",
-      uiMessage: "The service is temporarily unavailable. Please try again later.",
-      type: "http"
-    },
-    GATEWAY_TIMEOUT: {
-      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"
-    },
-    HTTP_VERSION_NOT_SUPPORTED: {
-      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"
-    },
-    VARIANT_ALSO_NEGOTIATES: {
-      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"
-    },
-    INSUFFICIENT_STORAGE: {
-      httpStatus: 507,
-      code: "INSUFFICIENT_STORAGE",
-      name: "Insufficient Storage Error",
-      message: "insufficient storage",
-      uiMessage: "The server has insufficient storage to complete the request.",
-      type: "http"
-    },
-    LOOP_DETECTED: {
-      httpStatus: 508,
-      code: "LOOP_DETECTED",
-      name: "Loop Detected Error",
-      message: "loop detected",
-      uiMessage: "The server detected an infinite loop.",
-      type: "http"
-    },
-    NOT_EXTENDED: {
-      httpStatus: 510,
-      code: "NOT_EXTENDED",
-      name: "Not Extended Error",
-      message: "not extended",
-      uiMessage: "Additional extensions are required.",
-      type: "http"
-    },
-    NETWORK_AUTHENTICATION_REQUIRED: {
-      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"
-    }
-  };
 };
 
-export { ErrorX, HandlingTargets };
+// src/presets.ts
+var http = {
+  // 4xx Client Errors
+  badRequest: {
+    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"
+  },
+  unauthorized: {
+    httpStatus: 401,
+    code: "UNAUTHORIZED",
+    name: "Unauthorized Error",
+    message: "Unauthorized.",
+    uiMessage: "Authentication required. Please log in to continue.",
+    type: "http"
+  },
+  paymentRequired: {
+    httpStatus: 402,
+    code: "PAYMENT_REQUIRED",
+    name: "Payment Required Error",
+    message: "Payment required.",
+    uiMessage: "Payment is required to access this resource.",
+    type: "http"
+  },
+  forbidden: {
+    httpStatus: 403,
+    code: "FORBIDDEN",
+    name: "Forbidden Error",
+    message: "Forbidden.",
+    uiMessage: "You do not have permission to access this resource.",
+    type: "http"
+  },
+  notFound: {
+    httpStatus: 404,
+    code: "NOT_FOUND",
+    name: "Not Found Error",
+    message: "Not found.",
+    uiMessage: "The requested resource could not be found.",
+    type: "http"
+  },
+  methodNotAllowed: {
+    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"
+  },
+  notAcceptable: {
+    httpStatus: 406,
+    code: "NOT_ACCEPTABLE",
+    name: "Not Acceptable Error",
+    message: "Not acceptable.",
+    uiMessage: "The requested format is not supported.",
+    type: "http"
+  },
+  proxyAuthenticationRequired: {
+    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"
+  },
+  requestTimeout: {
+    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"
+  },
+  conflict: {
+    httpStatus: 409,
+    code: "CONFLICT",
+    name: "Conflict Error",
+    message: "Conflict.",
+    uiMessage: "The request conflicts with the current state. Please refresh and try again.",
+    type: "http"
+  },
+  gone: {
+    httpStatus: 410,
+    code: "GONE",
+    name: "Gone Error",
+    message: "Gone.",
+    uiMessage: "This resource is no longer available.",
+    type: "http"
+  },
+  lengthRequired: {
+    httpStatus: 411,
+    code: "LENGTH_REQUIRED",
+    name: "Length Required Error",
+    message: "Length required.",
+    uiMessage: "The request is missing required length information.",
+    type: "http"
+  },
+  preconditionFailed: {
+    httpStatus: 412,
+    code: "PRECONDITION_FAILED",
+    name: "Precondition Failed Error",
+    message: "Precondition failed.",
+    uiMessage: "A required condition was not met. Please try again.",
+    type: "http"
+  },
+  payloadTooLarge: {
+    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"
+  },
+  uriTooLong: {
+    httpStatus: 414,
+    code: "URI_TOO_LONG",
+    name: "URI Too Long Error",
+    message: "URI too long.",
+    uiMessage: "The request URL is too long.",
+    type: "http"
+  },
+  unsupportedMediaType: {
+    httpStatus: 415,
+    code: "UNSUPPORTED_MEDIA_TYPE",
+    name: "Unsupported Media Type Error",
+    message: "Unsupported media type.",
+    uiMessage: "The file type is not supported.",
+    type: "http"
+  },
+  rangeNotSatisfiable: {
+    httpStatus: 416,
+    code: "RANGE_NOT_SATISFIABLE",
+    name: "Range Not Satisfiable Error",
+    message: "Range not satisfiable.",
+    uiMessage: "The requested range cannot be satisfied.",
+    type: "http"
+  },
+  expectationFailed: {
+    httpStatus: 417,
+    code: "EXPECTATION_FAILED",
+    name: "Expectation Failed Error",
+    message: "Expectation failed.",
+    uiMessage: "The server cannot meet the requirements of the request.",
+    type: "http"
+  },
+  imATeapot: {
+    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"
+  },
+  unprocessableEntity: {
+    httpStatus: 422,
+    code: "UNPROCESSABLE_ENTITY",
+    name: "Unprocessable Entity Error",
+    message: "Unprocessable entity.",
+    uiMessage: "The request contains invalid data. Please check your input.",
+    type: "http"
+  },
+  locked: {
+    httpStatus: 423,
+    code: "LOCKED",
+    name: "Locked Error",
+    message: "Locked.",
+    uiMessage: "This resource is locked and cannot be modified.",
+    type: "http"
+  },
+  failedDependency: {
+    httpStatus: 424,
+    code: "FAILED_DEPENDENCY",
+    name: "Failed Dependency Error",
+    message: "Failed dependency.",
+    uiMessage: "The request failed due to a dependency error.",
+    type: "http"
+  },
+  tooEarly: {
+    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"
+  },
+  upgradeRequired: {
+    httpStatus: 426,
+    code: "UPGRADE_REQUIRED",
+    name: "Upgrade Required Error",
+    message: "Upgrade required.",
+    uiMessage: "Please upgrade to continue using this service.",
+    type: "http"
+  },
+  preconditionRequired: {
+    httpStatus: 428,
+    code: "PRECONDITION_REQUIRED",
+    name: "Precondition Required Error",
+    message: "Precondition required.",
+    uiMessage: "Required conditions are missing from the request.",
+    type: "http"
+  },
+  tooManyRequests: {
+    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"
+  },
+  requestHeaderFieldsTooLarge: {
+    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"
+  },
+  unavailableForLegalReasons: {
+    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"
+  },
+  // 5xx Server Errors
+  internalServerError: {
+    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"
+  },
+  notImplemented: {
+    httpStatus: 501,
+    code: "NOT_IMPLEMENTED",
+    name: "Not Implemented Error",
+    message: "Not implemented.",
+    uiMessage: "This feature is not yet available.",
+    type: "http"
+  },
+  badGateway: {
+    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"
+  },
+  serviceUnavailable: {
+    httpStatus: 503,
+    code: "SERVICE_UNAVAILABLE",
+    name: "Service Unavailable Error",
+    message: "Service unavailable.",
+    uiMessage: "The service is temporarily unavailable. Please try again later.",
+    type: "http"
+  },
+  gatewayTimeout: {
+    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"
+  },
+  httpVersionNotSupported: {
+    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"
+  },
+  variantAlsoNegotiates: {
+    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"
+  },
+  insufficientStorage: {
+    httpStatus: 507,
+    code: "INSUFFICIENT_STORAGE",
+    name: "Insufficient Storage Error",
+    message: "Insufficient storage.",
+    uiMessage: "The server has insufficient storage to complete the request.",
+    type: "http"
+  },
+  loopDetected: {
+    httpStatus: 508,
+    code: "LOOP_DETECTED",
+    name: "Loop Detected Error",
+    message: "Loop detected.",
+    uiMessage: "The server detected an infinite loop.",
+    type: "http"
+  },
+  notExtended: {
+    httpStatus: 510,
+    code: "NOT_EXTENDED",
+    name: "Not Extended Error",
+    message: "Not extended.",
+    uiMessage: "Additional extensions are required.",
+    type: "http"
+  },
+  networkAuthenticationRequired: {
+    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"
+  }
+};
+
+export { ErrorX, http };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map