@bombillazo/error-x 0.5.0 → 0.5.1

package/README.md

@@ -100,7 +100,7 @@ The base error class that extends the native `Error` with enhanced capabilities.
 | `chain`      | `readonly ErrorX[]`        | Full error sequence: `[this, parent, grandparent, ..., root]`  |
 | `root`       | `ErrorX \| undefined`      | Error that started the whole error chain                       |
 | `parent`     | `ErrorX \| undefined`      | Error that immediately precedes this error in the chain        |
-| `original`   | `ErrorXCause \| undefined` | Stores the original non-ErrorX error used to create this error |
+| `original`   | `ErrorXSnapshot \| undefined` | Stores the original non-ErrorX error used to create this error |
 
 #### Static Methods
 
@@ -158,15 +158,79 @@ new ErrorX<UserMeta>({
 
 ### ErrorXOptions
 
-| Property   | Type                              | Default               | Description                               |
-| ---------- | --------------------------------- | --------------------- | ----------------------------------------- |
-| message    | `string`                          | `'An error occurred'` | Technical error message                   |
-| name       | `string`                          | `'Error'`             | Error type/name                           |
-| code       | `string \| number`                | Auto-generated        | Error identifier (UPPER_SNAKE_CASE)       |
-| uiMessage  | `string`                          | `undefined`           | User-friendly message                     |
-| httpStatus | `number`                          | `undefined`           | HTTP status code                          |
-| metadata   | `TMetadata`                       | `undefined`           | Additional context                        |
-| cause      | `ErrorXCause \| Error \| unknown` | `undefined`           | Error that caused this (builds the chain) |
+| Property   | Type               | Default               | Description                               |
+| ---------- | ------------------ | --------------------- | ----------------------------------------- |
+| message    | `string`           | `'An error occurred'` | Technical error message                   |
+| name       | `string`           | `'Error'`             | Error type/name                           |
+| code       | `string \| number` | Auto-generated        | Error identifier (UPPER_SNAKE_CASE)       |
+| uiMessage  | `string`           | `undefined`           | User-friendly message                     |
+| httpStatus | `number`           | `undefined`           | HTTP status code                          |
+| metadata   | `TMetadata`        | `undefined`           | Additional context                        |
+| cause      | `unknown`          | `undefined`           | Error that caused this (builds the chain) |
+
+## Global Configuration
+
+Configure stack trace cleaning and other global settings.
+
+```typescript
+import { ErrorX } from "@bombillazo/error-x";
+
+// Enable stack cleaning with custom delimiter
+ErrorX.configure({
+  cleanStack: true,
+  cleanStackDelimiter: "my-app-entry",
+});
+
+// Custom patterns to remove from stack traces
+ErrorX.configure({
+  cleanStack: ["node_modules", "internal/"],
+});
+
+// Disable stack cleaning
+ErrorX.configure({ cleanStack: false });
+
+// Get current config
+const config = ErrorX.getConfig();
+
+// Reset to defaults
+ErrorX.resetConfig();
+```
+
+### Auto Code Generation
+
+Error codes are automatically generated from names in UPPER_SNAKE_CASE when not provided:
+
+```typescript
+new ErrorX({ name: "DatabaseError" });
+// → code: 'DATABASE_ERROR'
+
+new ErrorX({ name: "userAuthError" });
+// → code: 'USER_AUTH_ERROR'
+
+new ErrorX({ name: "API Timeout" });
+// → code: 'API_TIMEOUT'
+```
+
+### Message Formatting
+
+ErrorX does NOT auto-format messages. Messages are passed through as-is:
+
+```typescript
+new ErrorX({ message: "test error" });
+// → message: 'test error'
+
+new ErrorX({ message: "Test error." });
+// → message: 'Test error.'
+```
+
+Empty or whitespace-only messages default to `'An error occurred'`:
+
+```typescript
+new ErrorX({ message: "" });
+// → message: 'An error occurred'
+```
+
+Preset messages in specialized classes (HTTPErrorX, DBErrorX) are properly formatted with sentence casing and periods.
 
 ---
 
@@ -288,7 +352,7 @@ try {
 if (ErrorX.isErrorX(error)) {
   console.log(
     "Error chain:",
-    error.chain.map((e) => e.name)
+    error.chain.map((e) => e.name),
   );
   console.log("Root cause:", error.root?.original);
 }
@@ -492,12 +556,12 @@ export class PaymentErrorX extends ErrorX<PaymentMetadata> {
   // Override create for proper typing
   static override create(
     presetKey?: PaymentPresetKey,
-    overrides?: Partial<ErrorXOptions<PaymentMetadata>>
+    overrides?: Partial<ErrorXOptions<PaymentMetadata>>,
   ): PaymentErrorX {
     return ErrorX.create.call(
       PaymentErrorX,
       presetKey,
-      overrides
+      overrides,
     ) as PaymentErrorX;
   }
 }
@@ -514,76 +578,6 @@ if (error instanceof PaymentErrorX) {
 }
 ```
 
----
-
-## Other Usage
-
-### Global Configuration
-
-Configure stack trace cleaning and other global settings.
-
-```typescript
-import { ErrorX } from "@bombillazo/error-x";
-
-// Enable stack cleaning with custom delimiter
-ErrorX.configure({
-  cleanStack: true,
-  cleanStackDelimiter: "my-app-entry",
-});
-
-// Custom patterns to remove from stack traces
-ErrorX.configure({
-  cleanStack: ["node_modules", "internal/"],
-});
-
-// Disable stack cleaning
-ErrorX.configure({ cleanStack: false });
-
-// Get current config
-const config = ErrorX.getConfig();
-
-// Reset to defaults
-ErrorX.resetConfig();
-```
-
-### Auto Code Generation
-
-Error codes are automatically generated from names in UPPER_SNAKE_CASE when not provided:
-
-```typescript
-new ErrorX({ name: "DatabaseError" });
-// → code: 'DATABASE_ERROR'
-
-new ErrorX({ name: "userAuthError" });
-// → code: 'USER_AUTH_ERROR'
-
-new ErrorX({ name: "API Timeout" });
-// → code: 'API_TIMEOUT'
-```
-
-### Message Formatting
-
-ErrorX does NOT auto-format messages. Messages are passed through as-is:
-
-```typescript
-new ErrorX({ message: "test error" });
-// → message: 'test error'
-
-new ErrorX({ message: "Test error." });
-// → message: 'Test error.'
-```
-
-Empty or whitespace-only messages default to `'An error occurred'`:
-
-```typescript
-new ErrorX({ message: "" });
-// → message: 'An error occurred'
-```
-
-Preset messages in specialized classes (HTTPErrorX, DBErrorX) are properly formatted with sentence casing and periods.
-
----
-
 ## License
 
 MIT

package/dist/index.cjs

@@ -132,38 +132,38 @@ var ErrorX = class _ErrorX extends Error {
     return "Error";
   }
   /**
-   * Converts any value to ErrorXCause format.
-   * @param value - Value to convert to ErrorXCause
-   * @returns ErrorXCause object or undefined if value is null/undefined
+   * Converts any value to ErrorXSnapshot format.
+   * @param value - Value to convert to ErrorXSnapshot
+   * @returns ErrorXSnapshot object or undefined if value is null/undefined
    */
-  static toErrorXCause(value) {
+  static toErrorXSnapshot(value) {
     if (value === void 0 || value === null) {
       return void 0;
     }
     if (value instanceof Error) {
-      const cause = {
+      const snapshot = {
         message: value.message
       };
       if (value.name) {
-        cause.name = value.name;
+        snapshot.name = value.name;
       }
       if (value.stack) {
-        cause.stack = value.stack;
+        snapshot.stack = value.stack;
       }
-      return cause;
+      return snapshot;
     }
     if (typeof value === "object") {
       const obj = value;
-      const cause = {
+      const snapshot = {
         message: String(obj.message || obj)
       };
       if (obj.name) {
-        cause.name = String(obj.name);
+        snapshot.name = String(obj.name);
       }
       if (obj.stack) {
-        cause.stack = String(obj.stack);
+        snapshot.stack = String(obj.stack);
       }
-      return cause;
+      return snapshot;
     }
     return {
       message: String(value)
@@ -324,7 +324,10 @@ var ErrorX = class _ErrorX extends Error {
       name: this.name,
       code: this.code,
       uiMessage: this.uiMessage,
-      metadata: { ...this.metadata ?? {}, ...additionalMetadata },
+      metadata: {
+        ...this.metadata ?? {},
+        ...additionalMetadata
+      },
       httpStatus: this.httpStatus
     };
     const newError = new _ErrorX(options);
@@ -444,7 +447,7 @@ var ErrorX = class _ErrorX extends Error {
       metadata: extractedOptions.metadata || overrides.metadata ? deepmergeTs.deepmerge(extractedOptions.metadata ?? {}, overrides.metadata ?? {}) : void 0
     } : extractedOptions;
     const error = new _ErrorX(finalOptions);
-    error.original = _ErrorX.toErrorXCause(payload);
+    error.original = _ErrorX.toErrorXSnapshot(payload);
     if (payload instanceof Error && payload.stack) {
       error.stack = payload.stack;
     }
@@ -530,16 +533,22 @@ ${this.stack}`;
     }
     if (this._chain.length > 1) {
       serialized.chain = this._chain.map((err) => {
-        const causeEntry = {
-          message: err.message
-        };
-        if (err.name) {
-          causeEntry.name = err.name;
+        let safeMetadata2;
+        if (err.metadata) {
+          safeMetadata2 = JSON.parse(safeStringify__default.default(err.metadata));
         }
-        if (err.stack) {
-          causeEntry.stack = err.stack;
-        }
-        return causeEntry;
+        const chainEntry = {
+          name: err.name,
+          message: err.message,
+          code: err.code,
+          uiMessage: err.uiMessage,
+          metadata: safeMetadata2,
+          timestamp: err.timestamp
+        };
+        if (err.httpStatus !== void 0) chainEntry.httpStatus = err.httpStatus;
+        if (err.stack) chainEntry.stack = err.stack;
+        if (err.original) chainEntry.original = err.original;
+        return chainEntry;
       });
     }
     return serialized;
@@ -593,16 +602,28 @@ ${this.stack}`;
         const chainErrorOptions = {
           message: causeData.message
         };
-        if (causeData.name) {
-          chainErrorOptions.name = causeData.name;
-        }
+        if (causeData.name) chainErrorOptions.name = causeData.name;
+        if ("code" in causeData && causeData.code !== void 0)
+          chainErrorOptions.code = causeData.code;
+        if ("uiMessage" in causeData && causeData.uiMessage !== void 0)
+          chainErrorOptions.uiMessage = causeData.uiMessage;
+        if ("metadata" in causeData && causeData.metadata !== void 0)
+          chainErrorOptions.metadata = causeData.metadata;
+        if ("httpStatus" in causeData && causeData.httpStatus !== void 0)
+          chainErrorOptions.httpStatus = causeData.httpStatus;
         const chainError = new _ErrorX(chainErrorOptions);
-        if (causeData.stack) {
-          chainError.stack = causeData.stack;
-        }
+        if (causeData.stack) chainError.stack = causeData.stack;
+        if ("timestamp" in causeData && causeData.timestamp !== void 0)
+          chainError.timestamp = causeData.timestamp;
+        if ("original" in causeData && causeData.original) chainError.original = causeData.original;
         chainErrors.push(chainError);
       }
-      error._chain = chainErrors;
+      for (let i = 0; i < chainErrors.length; i++) {
+        const chainError = chainErrors[i];
+        if (chainError) {
+          chainError._chain = chainErrors.slice(i);
+        }
+      }
     }
     return error;
   }