@bombillazo/error-x 0.4.1 → 0.4.3

package/dist/index.js

@@ -175,7 +175,8 @@ var ErrorX = class _ErrorX extends Error {
    *   docsMap: {
    *     'AUTH_FAILED': 'authentication-errors',
    *     'DB_ERROR': 'database-errors'
-   *   }
+   *   },
+   *   cleanStackDelimiter: 'app-entry-point' // Trim stack traces after this line
    * })
    * ```
    */
@@ -189,6 +190,19 @@ var ErrorX = class _ErrorX extends Error {
   static getConfig() {
     return _ErrorX._config;
   }
+  /**
+   * Reset global configuration to null.
+   * Useful for testing or when you want to clear all configuration.
+   *
+   * @example
+   * ```typescript
+   * ErrorX.resetConfig()
+   * const config = ErrorX.getConfig() // null
+   * ```
+   */
+  static resetConfig() {
+    _ErrorX._config = null;
+  }
   /**
    * Validates HTTP status code to ensure it's within valid range (100-599)
    *
@@ -276,13 +290,24 @@ var ErrorX = class _ErrorX extends Error {
     return [newErrorFirstLine, ...originalStackTrace].join("\n");
   }
   /**
-   * Cleans the stack trace by removing ErrorX internal method calls.
+   * Cleans a stack trace by removing ErrorX internal method calls and optionally trimming after a delimiter.
    * This provides cleaner stack traces that focus on user code.
    *
-   * @param stack - Raw stack trace to clean
-   * @returns Cleaned stack trace without ErrorX internal calls
+   * @param stack - Raw stack trace string to clean
+   * @param delimiter - Optional delimiter to trim stack trace after (overrides config delimiter)
+   * @returns Cleaned stack trace without internal calls and optionally trimmed after delimiter
+   *
+   * @example
+   * ```typescript
+   * // Clean with pattern-based removal only
+   * const cleaned = ErrorX.cleanStack(error.stack)
+   *
+   * // Clean and trim after delimiter
+   * const trimmed = ErrorX.cleanStack(error.stack, 'my-app-entry')
+   * // Returns stack trace starting after the line containing 'my-app-entry'
+   * ```
    */
-  static cleanStack(stack) {
+  static cleanStack(stack, delimiter) {
     if (!stack) return "";
     const config = _ErrorX.getConfig();
     const cleanStackConfig = config?.cleanStack ?? true;
@@ -306,30 +331,15 @@ var ErrorX = class _ErrorX extends Error {
       }
       cleanedLines.push(line);
     }
-    return cleanedLines.join("\n");
-  }
-  /**
-   * Processes an error's stack trace to trim it after a specified delimiter.
-   * Useful for removing irrelevant stack frames before a specific function.
-   *
-   * @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 processed = ErrorX.processErrorStack(error, 'my-app-entry')
-   * // Returns stack trace starting after the line containing 'my-app-entry'
-   * ```
-   */
-  static processErrorStack(error, delimiter) {
-    let stack = error.stack ?? "";
-    const stackLines = stack.split("\n");
-    const delimiterIndex = stackLines.findIndex((line) => line.includes(delimiter));
-    if (delimiterIndex !== -1) {
-      stack = stackLines.slice(delimiterIndex + 1).join("\n");
+    let cleanedStack = cleanedLines.join("\n");
+    const activeDelimiter = delimiter ?? config?.cleanStackDelimiter;
+    if (activeDelimiter) {
+      const delimiterIndex = cleanedLines.findIndex((line) => line.includes(activeDelimiter));
+      if (delimiterIndex !== -1) {
+        cleanedStack = cleanedLines.slice(delimiterIndex + 1).join("\n");
+      }
     }
-    return stack;
+    return cleanedStack;
   }
   /**
    * Creates a new ErrorX instance with additional metadata merged with existing metadata.
@@ -494,43 +504,6 @@ var ErrorX = class _ErrorX extends Error {
     const options = _ErrorX.convertUnknownToOptions(error);
     return new _ErrorX(options);
   }
-  /**
-   * 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.
-   *
-   * @param delimiter - Optional string to search for in stack lines
-   * @returns New ErrorX instance with cleaned stack trace, or the same instance if no cleaning needed
-   *
-   * @example
-   * ```typescript
-   * const error = new ErrorX({ message: 'Database error' })
-   * const cleanedError = error.cleanStackTrace('database-layer')
-   * // Returns new ErrorX with stack trace starting after 'database-layer'
-   * ```
-   */
-  cleanStackTrace(delimiter) {
-    if (delimiter && this.stack) {
-      const options = {
-        message: this.message,
-        name: this.name,
-        code: this.code,
-        uiMessage: this.uiMessage,
-        cause: this.cause,
-        httpStatus: this.httpStatus,
-        type: this.type,
-        sourceUrl: this.sourceUrl,
-        docsUrl: this.docsUrl,
-        source: this.source
-      };
-      if (this.metadata !== void 0) {
-        options.metadata = this.metadata;
-      }
-      const newError = new _ErrorX(options);
-      newError.stack = _ErrorX.processErrorStack(this, delimiter);
-      return newError;
-    }
-    return this;
-  }
   /**
    * Converts the ErrorX instance to a detailed string representation.
    * Includes error name, message, code, timestamp, metadata, and stack trace.
@@ -672,7 +645,7 @@ ${this.stack}`;
 // src/presets.ts
 var http = {
   // 4xx Client Errors
-  badRequest: {
+  400: {
     httpStatus: 400,
     code: "BAD_REQUEST",
     name: "Bad Request Error",
@@ -680,7 +653,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",
@@ -688,7 +661,7 @@ var http = {
     uiMessage: "Authentication required. Please log in to continue.",
     type: "http"
   },
-  paymentRequired: {
+  402: {
     httpStatus: 402,
     code: "PAYMENT_REQUIRED",
     name: "Payment Required Error",
@@ -696,7 +669,7 @@ var http = {
     uiMessage: "Payment is required to access this resource.",
     type: "http"
   },
-  forbidden: {
+  403: {
     httpStatus: 403,
     code: "FORBIDDEN",
     name: "Forbidden Error",
@@ -704,7 +677,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",
@@ -712,7 +685,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",
@@ -720,7 +693,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",
@@ -728,7 +701,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",
@@ -736,7 +709,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",
@@ -744,7 +717,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",
@@ -752,7 +725,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",
@@ -760,7 +733,7 @@ var http = {
     uiMessage: "This resource is no longer available.",
     type: "http"
   },
-  lengthRequired: {
+  411: {
     httpStatus: 411,
     code: "LENGTH_REQUIRED",
     name: "Length Required Error",
@@ -768,7 +741,7 @@ var http = {
     uiMessage: "The request is missing required length information.",
     type: "http"
   },
-  preconditionFailed: {
+  412: {
     httpStatus: 412,
     code: "PRECONDITION_FAILED",
     name: "Precondition Failed Error",
@@ -776,7 +749,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",
@@ -784,7 +757,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",
@@ -792,7 +765,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",
@@ -800,7 +773,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",
@@ -808,7 +781,7 @@ var http = {
     uiMessage: "The requested range cannot be satisfied.",
     type: "http"
   },
-  expectationFailed: {
+  417: {
     httpStatus: 417,
     code: "EXPECTATION_FAILED",
     name: "Expectation Failed Error",
@@ -816,7 +789,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",
@@ -824,7 +797,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",
@@ -832,7 +805,7 @@ var http = {
     uiMessage: "The request contains invalid data. Please check your input.",
     type: "http"
   },
-  locked: {
+  423: {
     httpStatus: 423,
     code: "LOCKED",
     name: "Locked Error",
@@ -840,7 +813,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",
@@ -848,7 +821,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",
@@ -856,7 +829,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",
@@ -864,7 +837,7 @@ var http = {
     uiMessage: "Please upgrade to continue using this service.",
     type: "http"
   },
-  preconditionRequired: {
+  428: {
     httpStatus: 428,
     code: "PRECONDITION_REQUIRED",
     name: "Precondition Required Error",
@@ -872,7 +845,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",
@@ -880,7 +853,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",
@@ -888,7 +861,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",
@@ -897,7 +870,7 @@ var http = {
     type: "http"
   },
   // 5xx Server Errors
-  internalServerError: {
+  500: {
     httpStatus: 500,
     code: "INTERNAL_SERVER_ERROR",
     name: "Internal Server Error",
@@ -905,7 +878,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",
@@ -913,7 +886,7 @@ var http = {
     uiMessage: "This feature is not yet available.",
     type: "http"
   },
-  badGateway: {
+  502: {
     httpStatus: 502,
     code: "BAD_GATEWAY",
     name: "Bad Gateway Error",
@@ -921,7 +894,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",
@@ -929,7 +902,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",
@@ -937,7 +910,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",
@@ -945,7 +918,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",
@@ -953,7 +926,7 @@ var http = {
     uiMessage: "The server has an internal configuration error.",
     type: "http"
   },
-  insufficientStorage: {
+  507: {
     httpStatus: 507,
     code: "INSUFFICIENT_STORAGE",
     name: "Insufficient Storage Error",
@@ -961,7 +934,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",
@@ -969,7 +942,7 @@ var http = {
     uiMessage: "The server detected an infinite loop.",
     type: "http"
   },
-  notExtended: {
+  510: {
     httpStatus: 510,
     code: "NOT_EXTENDED",
     name: "Not Extended Error",
@@ -977,7 +950,7 @@ var http = {
     uiMessage: "Additional extensions are required.",
     type: "http"
   },
-  networkAuthenticationRequired: {
+  511: {
     httpStatus: 511,
     code: "NETWORK_AUTHENTICATION_REQUIRED",
     name: "Network Authentication Required Error",