@alessiofrittoli/exception 3.0.0 → 3.2.0

package/README.md

@@ -28,7 +28,9 @@ This documentation describes the `Exception` class, which provides a structured
   - [ExceptionOptions Interface](#exceptionoptions-interface)
   - [Exception Class](#exception-class)
   - [AbortError Class](#aborterror-class)
-  - [Usage Scenarios](#usage-scenarios)
+    - [AbortError Usage Scenarios](#aborterror-usage-scenarios)
+  - [`ErrorCode` enum](#errorcode-enum)
+  - [Examples](#examples)
 - [Development](#development)
   - [Install depenendencies](#install-depenendencies)
   - [Build the source code](#build-the-source-code)
@@ -156,13 +158,13 @@ The constructor initializes an `AbortError` instance with a custom message and o
 | Parameter | Type               | Description                                                     |
 |-----------|--------------------|-----------------------------------------------------------------|
 | `message` | `TMessage`         | (Required) The error message. Can be a string or a custom type. |
-| `options` | `AbortErrorOptions`| (Optional) An object containing the error options. It extends the [`ExceptionOptions` Interface](#exceptionoptions-interface) and omit `code` and `name` properties wich are set by `AbortError` for you. |
+| `options` | `AbortErrorOptions`| (Optional) An object containing the error options. It extends the [`ExceptionOptions` Interface](#exceptionoptions-interface) and omit the `name` property. The `code` defaults to `ErrorCode.ABORT` but can be optionally customized. |
 
 ---
 
-#### Usage Scenarios
+##### AbortError Usage Scenarios
 
-##### Precise Abort Errors Handling
+###### Precise Abort Errors Handling
 
 ```ts
 import { AbortError } from '@alessiofrittoli/exception/abort'
@@ -194,6 +196,45 @@ try {
 
 ---
 
+###### Using custom Abort Error codes
+
+```ts
+import { AbortError } from '@alessiofrittoli/exception/abort'
+
+enum CustomAbortCode
+{
+  CUSTOM_CODE = 'ERR:CUSTOM_ABORT_CODE',
+}
+
+try {
+  const controller = new AbortController()
+  const { signal } = controller
+
+  button.addEventListener( 'click', () => {
+    controller.abort(
+      new AbortError( 'User cancelled the request.', { code: CustomAbortCode.CUSTOM_CODE } )
+    )
+  } )
+
+  await fetch( ..., { signal } )
+} catch ( error ) {
+
+  if ( AbortError.isException( error ) ) {
+    if ( AbortError.isAbortError( error, CustomAbortCode.CUSTOM_CODE ) ) {
+      // handle abort error
+      console.log( error.code ) // `error.code` is type of `CustomAbortCode.CUSTOM_CODE`.
+      return
+    }
+    // handle other Exception errors
+    return
+  }
+  // handle other unknown errors
+  
+}
+```
+
+---
+
 #### `ErrorCode` enum
 
 The `ErrorCode` enum is a utility that provides pre-defined constants for the most common error codes.\
@@ -203,14 +244,18 @@ It is designed to simplify error handling and improve feedback quality returned
 
 <summary>Constants Overview</summary>
 
-| Constant      | Value            | Description                                             |
-|---------------|------------------|---------------------------------------------------------|
-| `UNKNOWN`     | `ERR:UNKNOWN`    | Returned when an unexpected error occured.              |
-| `ABORT`       | `ERR:ABORT`      | Returned when user abort the request.                   |
-| `EMPTY_VALUE` | `ERR:EMPTYVALUE` | Returned when a required value is "falsy".              |
-| `WRONG_VALUE` | `ERR:WRONGVALUE` | Return when a required value is not the expected value. |
-| `EXPIRED`     | `ERR:EXPIRED`    | Returned when a requested has been performed too late.  |
-| `TOO_EARLY`   | `ERR:TOOEARLY`   | Returned when a request has been performed too early.   |
+| Constant        | Value              | Description                                             |
+|-----------------|--------------------|---------------------------------------------------------|
+| `UNKNOWN`       | `ERR:UNKNOWN`      | Returned when an unexpected error occured.              |
+| `ABORT`         | `ERR:ABORT`        | Returned when user abort the request.                   |
+| `EMPTY_VALUE`   | `ERR:EMPTYVALUE`   | Returned when a required value is "falsy".              |
+| `WRONG_VALUE`   | `ERR:WRONGVALUE`   | Return when a required value is not the expected value. |
+| `EXPIRED`       | `ERR:EXPIRED`      | Returned when a requested has been performed too late.  |
+| `TOO_EARLY`     | `ERR:TOOEARLY`     | Returned when a request has been performed too early.   |
+| `TOO_MANY`      | `ERR:TOOMANY`      | Could be return in combination with a 429 Too Many Requests Response Status. |
+| `QUOTA_REACHED` | `ERR:QUOTAREACHED` | Returned when a specific quota has been reached.        |
+| `NOT_FOUND`     | `ERR:NOTFOUND`     | Returned when a resource cannot be found.               |
+| `OFFLINE`       | `ERR:INTERNETDISCONNECTED` | Could be used to throw errors when user is offline. |
 
 </details>
 
@@ -246,11 +291,9 @@ export default ErrorCode
 
 ---
 
-<details>
-
-<summary>Usage</summary>
+#### Examples
 
-#### Using the default `ErrorCode` to throw a new `Exception`
+##### Using the default `ErrorCode` to throw a new `Exception`
 
 ```ts
 import { Exception } from '@alessiofrittoli/exception'
@@ -262,7 +305,7 @@ throw new Exception( 'Password is a required field to log you in.', {
 } )
 ```
 
-#### Using custom `ErrorCode` to throw a new `Exception`
+##### Using custom `ErrorCode` to throw a new `Exception`
 
 ```ts
 import { Exception } from '@alessiofrittoli/exception'
@@ -274,7 +317,7 @@ throw new Exception( 'Invalid signature.', {
 } )
 ```
 
-#### Using `ErrorCode` to handle errors
+##### Using `ErrorCode` to handle errors
 
 ```ts
 import { ErrorCode } from '@/error-code' // previously created in `myproject/src/error-code.ts`
@@ -295,8 +338,6 @@ try {
 }
 ```
 
-</details>
-
 ---
 
 ### Development

package/dist/abort.d.mts

@@ -6,7 +6,7 @@ import { ErrorCode } from './code.mjs';
  *
  * @extends ExceptionOptions
  */
-interface AbortErrorOptions extends Omit<ExceptionOptions, 'code' | 'name'> {
+interface AbortErrorOptions<TCode = ErrorCode> extends Partial<Omit<ExceptionOptions<TCode>, 'name'>> {
     /** The HTTP status code associated with the Exception. */
     status?: number;
 }
@@ -17,8 +17,8 @@ interface AbortErrorOptions extends Omit<ExceptionOptions, 'code' | 'name'> {
  *
  * @extends Exception
  */
-declare class AbortError<TMessage> extends Exception<TMessage, ErrorCode.ABORT> implements AbortErrorOptions {
-    constructor(reason: TMessage, options?: AbortErrorOptions);
+declare class AbortError<TMessage = string, TCode = ErrorCode> extends Exception<TMessage, TCode> implements AbortErrorOptions<TCode> {
+    constructor(reason: TMessage, options?: AbortErrorOptions<TCode>);
     /**
      * Determines if the provided error is an instance of the AbortError class and has the ABORT ErrorCode.
      *
@@ -29,7 +29,7 @@ declare class AbortError<TMessage> extends Exception<TMessage, ErrorCode.ABORT>
      * @param	error The error to check.
      * @returns	`true` if the error is an `AbortError` and has the ABORT ErrorCode, `false` otherwise.
      */
-    static isAbortError<TMessage = string>(error: any): error is AbortError<TMessage>;
+    static isAbortError<TMessage = string, TCode = ErrorCode>(error: any, code?: TCode): error is AbortError<TMessage, TCode>;
 }
 
 export { AbortError, type AbortErrorOptions };

package/dist/abort.d.ts

@@ -6,7 +6,7 @@ import { ErrorCode } from './code.js';
  *
  * @extends ExceptionOptions
  */
-interface AbortErrorOptions extends Omit<ExceptionOptions, 'code' | 'name'> {
+interface AbortErrorOptions<TCode = ErrorCode> extends Partial<Omit<ExceptionOptions<TCode>, 'name'>> {
     /** The HTTP status code associated with the Exception. */
     status?: number;
 }
@@ -17,8 +17,8 @@ interface AbortErrorOptions extends Omit<ExceptionOptions, 'code' | 'name'> {
  *
  * @extends Exception
  */
-declare class AbortError<TMessage> extends Exception<TMessage, ErrorCode.ABORT> implements AbortErrorOptions {
-    constructor(reason: TMessage, options?: AbortErrorOptions);
+declare class AbortError<TMessage = string, TCode = ErrorCode> extends Exception<TMessage, TCode> implements AbortErrorOptions<TCode> {
+    constructor(reason: TMessage, options?: AbortErrorOptions<TCode>);
     /**
      * Determines if the provided error is an instance of the AbortError class and has the ABORT ErrorCode.
      *
@@ -29,7 +29,7 @@ declare class AbortError<TMessage> extends Exception<TMessage, ErrorCode.ABORT>
      * @param	error The error to check.
      * @returns	`true` if the error is an `AbortError` and has the ABORT ErrorCode, `false` otherwise.
      */
-    static isAbortError<TMessage = string>(error: any): error is AbortError<TMessage>;
+    static isAbortError<TMessage = string, TCode = ErrorCode>(error: any, code?: TCode): error is AbortError<TMessage, TCode>;
 }
 
 export { AbortError, type AbortErrorOptions };

package/dist/abort.js

@@ -1,2 +1,32 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkOJYXDMWZjs = require('./chunk-OJYXDMWZ.js');require('./chunk-FXYDTIUG.js');var e=class extends _chunkOJYXDMWZjs.a{constructor(r,t){super(r,{name:"AbortError",code:"ERR:ABORT",...t})}static isAbortError(r){return super.isAbortError(r)}};exports.AbortError = e;
-//# sourceMappingURL=abort.js.map
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkJG4AGGUJjs = require('./chunk-JG4AGGUJ.js');
+require('./chunk-KMJW7KZM.js');
+
+// src/abort.ts
+var AbortError = class extends _chunkJG4AGGUJjs.Exception {
+  constructor(reason, options = {}) {
+    const name = "AbortError";
+    const {
+      code = "ERR:ABORT" /* ABORT */,
+      ...rest
+    } = options;
+    super(reason, { ...rest, name, code });
+  }
+  /**
+   * Determines if the provided error is an instance of the AbortError class and has the ABORT ErrorCode.
+   * 
+   * This won't work for `new DOMException( 'Abort reason', 'AbortError' )` since we type guard the checked value to `AbortError<TMessage>`.
+   *
+   * @template TMessage The type of the message property of the AbortError.
+   * 
+   * @param	error The error to check.
+   * @returns	`true` if the error is an `AbortError` and has the ABORT ErrorCode, `false` otherwise.
+   */
+  static isAbortError(error, code) {
+    return super.isAbortError(error, code);
+  }
+};
+
+
+exports.AbortError = AbortError;

package/dist/abort.mjs

@@ -1,2 +1,32 @@
-import{a as o}from"./chunk-CLZRQMJF.mjs";import"./chunk-JM2G32JS.mjs";var e=class extends o{constructor(r,t){super(r,{name:"AbortError",code:"ERR:ABORT",...t})}static isAbortError(r){return super.isAbortError(r)}};export{e as AbortError};
-//# sourceMappingURL=abort.mjs.map
+import {
+  Exception
+} from "./chunk-HGZVEYNW.mjs";
+import "./chunk-M2EF7GYS.mjs";
+
+// src/abort.ts
+var AbortError = class extends Exception {
+  constructor(reason, options = {}) {
+    const name = "AbortError";
+    const {
+      code = "ERR:ABORT" /* ABORT */,
+      ...rest
+    } = options;
+    super(reason, { ...rest, name, code });
+  }
+  /**
+   * Determines if the provided error is an instance of the AbortError class and has the ABORT ErrorCode.
+   * 
+   * This won't work for `new DOMException( 'Abort reason', 'AbortError' )` since we type guard the checked value to `AbortError<TMessage>`.
+   *
+   * @template TMessage The type of the message property of the AbortError.
+   * 
+   * @param	error The error to check.
+   * @returns	`true` if the error is an `AbortError` and has the ABORT ErrorCode, `false` otherwise.
+   */
+  static isAbortError(error, code) {
+    return super.isAbortError(error, code);
+  }
+};
+export {
+  AbortError
+};

package/dist/chunk-HGZVEYNW.mjs

@@ -0,0 +1,59 @@
+// src/index.ts
+var Exception = class _Exception extends Error {
+  /**
+   * Constructs a new Exception instance.
+   *
+   * @param message The message describing the exception.
+   * @param options Additional options for the exception.
+   */
+  constructor(message, options) {
+    super("", options);
+    this.__typename = "Exception";
+    this.name = options.name || this.__typename;
+    this.message = message;
+    this.code = options.code;
+    this.status = options.status;
+  }
+  /**
+   * Determines if the provided error is an instance of the Exception class.
+   *
+   * @template TMessage	The type of the message property of the Exception.
+   * @template TCode		The type of the code property of the Exception.
+   * 
+   * @param	error The error to check.
+   * @returns	`true` if the error is an instance of Exception or has a `__typename` property equal to 'Exception', `false` otherwise.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  static isException(error) {
+    return error instanceof _Exception || typeof error === "object" && "__typename" in error && error.__typename === "Exception";
+  }
+  /**
+   * Determines if the provided error is an instance of the Exception class and has the ABORT ErrorCode.
+   * 
+   * This won't work for `new DOMException( 'Abort reason', 'AbortError' )` since we type guard the checked value to `Exception<TMessage, ErrorCode.ABORT>`.
+   *
+   * @template TMessage The type of the message property of the Exception.
+   * 
+   * @param	error The error to check.
+   * @returns	`true` if the error is an `Exception` and has the ABORT ErrorCode, `false` otherwise.
+   */
+  static isAbortError(error, code = "ERR:ABORT" /* ABORT */) {
+    return _Exception.isException(error) && (error.name === "AbortError" || error.code === code);
+  }
+  /**
+   * Converts the instance to a JSON object.
+   *
+   * @returns A JSON representation of the instance, including the message property.
+   */
+  toJSON() {
+    return {
+      ...this,
+      message: this.message,
+      cause: this.cause
+    };
+  }
+};
+
+export {
+  Exception
+};

package/dist/chunk-JG4AGGUJ.js

@@ -0,0 +1,59 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/index.ts
+var Exception = class _Exception extends Error {
+  /**
+   * Constructs a new Exception instance.
+   *
+   * @param message The message describing the exception.
+   * @param options Additional options for the exception.
+   */
+  constructor(message, options) {
+    super("", options);
+    this.__typename = "Exception";
+    this.name = options.name || this.__typename;
+    this.message = message;
+    this.code = options.code;
+    this.status = options.status;
+  }
+  /**
+   * Determines if the provided error is an instance of the Exception class.
+   *
+   * @template TMessage	The type of the message property of the Exception.
+   * @template TCode		The type of the code property of the Exception.
+   * 
+   * @param	error The error to check.
+   * @returns	`true` if the error is an instance of Exception or has a `__typename` property equal to 'Exception', `false` otherwise.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  static isException(error) {
+    return error instanceof _Exception || typeof error === "object" && "__typename" in error && error.__typename === "Exception";
+  }
+  /**
+   * Determines if the provided error is an instance of the Exception class and has the ABORT ErrorCode.
+   * 
+   * This won't work for `new DOMException( 'Abort reason', 'AbortError' )` since we type guard the checked value to `Exception<TMessage, ErrorCode.ABORT>`.
+   *
+   * @template TMessage The type of the message property of the Exception.
+   * 
+   * @param	error The error to check.
+   * @returns	`true` if the error is an `Exception` and has the ABORT ErrorCode, `false` otherwise.
+   */
+  static isAbortError(error, code = "ERR:ABORT" /* ABORT */) {
+    return _Exception.isException(error) && (error.name === "AbortError" || error.code === code);
+  }
+  /**
+   * Converts the instance to a JSON object.
+   *
+   * @returns A JSON representation of the instance, including the message property.
+   */
+  toJSON() {
+    return {
+      ...this,
+      message: this.message,
+      cause: this.cause
+    };
+  }
+};
+
+
+
+exports.Exception = Exception;

package/dist/chunk-KMJW7KZM.js

@@ -0,0 +1,18 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/code.ts
+var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
+  ErrorCode2["UNKNOWN"] = "ERR:UNKNOWN";
+  ErrorCode2["ABORT"] = "ERR:ABORT";
+  ErrorCode2["EMPTY_VALUE"] = "ERR:EMPTYVALUE";
+  ErrorCode2["WRONG_VALUE"] = "ERR:WRONGVALUE";
+  ErrorCode2["EXPIRED"] = "ERR:EXPIRED";
+  ErrorCode2["TOO_EARLY"] = "ERR:TOOEARLY";
+  ErrorCode2["TOO_MANY"] = "ERR:TOOMANY";
+  ErrorCode2["QUOTA_REACHED"] = "ERR:QUOTAREACHED";
+  ErrorCode2["NOT_FOUND"] = "ERR:NOTFOUND";
+  ErrorCode2["OFFLINE"] = "ERR:INTERNETDISCONNECTED";
+  return ErrorCode2;
+})(ErrorCode || {});
+
+
+
+exports.ErrorCode = ErrorCode;

package/dist/chunk-M2EF7GYS.mjs

@@ -0,0 +1,18 @@
+// src/code.ts
+var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
+  ErrorCode2["UNKNOWN"] = "ERR:UNKNOWN";
+  ErrorCode2["ABORT"] = "ERR:ABORT";
+  ErrorCode2["EMPTY_VALUE"] = "ERR:EMPTYVALUE";
+  ErrorCode2["WRONG_VALUE"] = "ERR:WRONGVALUE";
+  ErrorCode2["EXPIRED"] = "ERR:EXPIRED";
+  ErrorCode2["TOO_EARLY"] = "ERR:TOOEARLY";
+  ErrorCode2["TOO_MANY"] = "ERR:TOOMANY";
+  ErrorCode2["QUOTA_REACHED"] = "ERR:QUOTAREACHED";
+  ErrorCode2["NOT_FOUND"] = "ERR:NOTFOUND";
+  ErrorCode2["OFFLINE"] = "ERR:INTERNETDISCONNECTED";
+  return ErrorCode2;
+})(ErrorCode || {});
+
+export {
+  ErrorCode
+};

package/dist/code.d.mts

@@ -8,7 +8,11 @@ declare enum ErrorCode {
     EMPTY_VALUE = "ERR:EMPTYVALUE",
     WRONG_VALUE = "ERR:WRONGVALUE",
     EXPIRED = "ERR:EXPIRED",
-    TOO_EARLY = "ERR:TOOEARLY"
+    TOO_EARLY = "ERR:TOOEARLY",
+    TOO_MANY = "ERR:TOOMANY",
+    QUOTA_REACHED = "ERR:QUOTAREACHED",
+    NOT_FOUND = "ERR:NOTFOUND",
+    OFFLINE = "ERR:INTERNETDISCONNECTED"
 }
 
 export { ErrorCode };

package/dist/code.d.ts

@@ -8,7 +8,11 @@ declare enum ErrorCode {
     EMPTY_VALUE = "ERR:EMPTYVALUE",
     WRONG_VALUE = "ERR:WRONGVALUE",
     EXPIRED = "ERR:EXPIRED",
-    TOO_EARLY = "ERR:TOOEARLY"
+    TOO_EARLY = "ERR:TOOEARLY",
+    TOO_MANY = "ERR:TOOMANY",
+    QUOTA_REACHED = "ERR:QUOTAREACHED",
+    NOT_FOUND = "ERR:NOTFOUND",
+    OFFLINE = "ERR:INTERNETDISCONNECTED"
 }
 
 export { ErrorCode };

package/dist/code.js

@@ -1,2 +1,6 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkFXYDTIUGjs = require('./chunk-FXYDTIUG.js');exports.ErrorCode = _chunkFXYDTIUGjs.a;
-//# sourceMappingURL=code.js.map
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkKMJW7KZMjs = require('./chunk-KMJW7KZM.js');
+
+
+exports.ErrorCode = _chunkKMJW7KZMjs.ErrorCode;

package/dist/code.mjs

@@ -1,2 +1,6 @@
-import{a}from"./chunk-JM2G32JS.mjs";export{a as ErrorCode};
-//# sourceMappingURL=code.mjs.map
+import {
+  ErrorCode
+} from "./chunk-M2EF7GYS.mjs";
+export {
+  ErrorCode
+};

package/dist/index.d.mts

@@ -56,7 +56,7 @@ declare class Exception<TMessage = string, TCode = ErrorCode> extends Error impl
      * @param	error The error to check.
      * @returns	`true` if the error is an `Exception` and has the ABORT ErrorCode, `false` otherwise.
      */
-    static isAbortError<TMessage = string>(error: any): error is Exception<TMessage, ErrorCode.ABORT>;
+    static isAbortError<TMessage = string, TCode = ErrorCode>(error: any, code?: TCode): error is Exception<TMessage, TCode>;
     /**
      * Converts the instance to a JSON object.
      *

package/dist/index.d.ts

@@ -56,7 +56,7 @@ declare class Exception<TMessage = string, TCode = ErrorCode> extends Error impl
      * @param	error The error to check.
      * @returns	`true` if the error is an `Exception` and has the ABORT ErrorCode, `false` otherwise.
      */
-    static isAbortError<TMessage = string>(error: any): error is Exception<TMessage, ErrorCode.ABORT>;
+    static isAbortError<TMessage = string, TCode = ErrorCode>(error: any, code?: TCode): error is Exception<TMessage, TCode>;
     /**
      * Converts the instance to a JSON object.
      *

package/dist/index.js

@@ -1,2 +1,7 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkOJYXDMWZjs = require('./chunk-OJYXDMWZ.js');require('./chunk-FXYDTIUG.js');exports.Exception = _chunkOJYXDMWZjs.a;
-//# sourceMappingURL=index.js.map
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkJG4AGGUJjs = require('./chunk-JG4AGGUJ.js');
+require('./chunk-KMJW7KZM.js');
+
+
+exports.Exception = _chunkJG4AGGUJjs.Exception;

package/dist/index.mjs

@@ -1,2 +1,7 @@
-import{a}from"./chunk-CLZRQMJF.mjs";import"./chunk-JM2G32JS.mjs";export{a as Exception};
-//# sourceMappingURL=index.mjs.map
+import {
+  Exception
+} from "./chunk-HGZVEYNW.mjs";
+import "./chunk-M2EF7GYS.mjs";
+export {
+  Exception
+};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@alessiofrittoli/exception",
-	"version": "3.0.0",
+	"version": "3.2.0",
 	"description": "Handle errors with ease",
 	"author": {
 		"name": "Alessio Frittoli",
@@ -53,10 +53,11 @@
 	"sideEffects": false,
 	"scripts": {
 		"//1a": "*********************************************************************",
-		"//1b": "*********************** BUILD - LINT - RELEASE **********************",
+		"//1b": "******************** DEV - BUILD - LINT - RELEASE *******************",
 		"//1c": "*********************************************************************",
-		"build": "pnpm lint && pnpm test:ci && tsup",
-		"build:watch": "tsup --watch",
+		"dev": "NODE_ENV=development tsup --watch",
+		"build:prod": "NODE_ENV=production tsup",
+		"build": "pnpm lint && pnpm test:ci && pnpm build:prod",
 		"lint": "eslint",
 		"release": "node scripts/publish.js --verbose --npm",
 		"//2a": "*********************************************************************",
@@ -74,11 +75,11 @@
 		"test:coverage:serve": "concurrently --prefix none --kill-others \"pnpm test:coverage\" \"pnpm test:serve-coverage\""
 	},
 	"devDependencies": {
-		"@alessiofrittoli/node-scripts": "^2.4.0",
+		"@alessiofrittoli/node-scripts": "^2.5.0",
 		"@eslint/js": "^9.25.1",
 		"@jest/globals": "^29.7.0",
 		"@types/jest": "^29.5.14",
-		"@types/node": "^22.15.2",
+		"@types/node": "^22.15.3",
 		"concurrently": "^9.1.2",
 		"dotenv": "^16.5.0",
 		"esbuild": "0.25.3",
@@ -90,7 +91,7 @@
 		"ts-node": "^10.9.2",
 		"tsup": "^8.4.0",
 		"typescript": "^5.8.3",
-		"typescript-eslint": "^8.31.0"
+		"typescript-eslint": "^8.31.1"
 	},
 	"pnpm": {
 		"onlyBuiltDependencies": [

package/dist/abort.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/Users/alessio/Documents/Personal/projects/exception/dist/abort.js","../src/abort.ts"],"names":["AbortError","Exception","reason","options","error"],"mappings":"AAAA,+HAAuC,+BAA4B,ICsBtDA,CAAAA,CAAN,MAAA,QAAmCC,kBAC1C,CACC,WAAA,CAAaC,CAAAA,CAAkBC,CAAAA,CAC/B,CACC,KAAA,CAAOD,CAAAA,CAAQ,CAAE,IAAA,CAAM,YAAA,CAAc,IAAA,CAAA,WAAA,CAAuB,GAAGC,CAAQ,CAAE,CAC1E,CAcA,OAAO,YAAA,CAAiCC,CAAAA,CACxC,CACC,OAAO,KAAA,CAAM,YAAA,CAAcA,CAAM,CAClC,CACD,CAAA,CAAA,uBAAA","file":"/Users/alessio/Documents/Personal/projects/exception/dist/abort.js","sourcesContent":[null,"import { Exception, ExceptionOptions } from '.'\nimport { ErrorCode } from './code'\n\n/**\n * Interface representing the options for an Exception.\n *\n * @extends ExceptionOptions\n */\nexport interface AbortErrorOptions extends Omit<ExceptionOptions, 'code' | 'name'>\n{\n\t/** The HTTP status code associated with the Exception. */\n\tstatus?: number\n}\n\n\n/**\n * Exception Class.\n * \n * @template TMessage The type of the message property of the Exception. Defaults to `string`.\n *\n * @extends Exception\n */\nexport class AbortError<TMessage> extends Exception<TMessage, ErrorCode.ABORT> implements AbortErrorOptions\n{\n\tconstructor( reason: TMessage, options?: AbortErrorOptions )\n\t{\n\t\tsuper( reason, { name: 'AbortError', code: ErrorCode.ABORT, ...options } )\n\t}\n\n\n\t/**\n\t * Determines if the provided error is an instance of the AbortError class and has the ABORT ErrorCode.\n\t * \n\t * This won't work for `new DOMException( 'Abort reason', 'AbortError' )` since we type guard the checked value to `AbortError<TMessage>`.\n\t *\n\t * @template TMessage The type of the message property of the AbortError.\n\t * \n\t * @param\terror The error to check.\n\t * @returns\t`true` if the error is an `AbortError` and has the ABORT ErrorCode, `false` otherwise.\n\t */\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\tstatic isAbortError<TMessage = string>( error: any ): error is AbortError<TMessage>\n\t{\n\t\treturn super.isAbortError( error )\n\t}\n}"]}

package/dist/abort.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/abort.ts"],"sourcesContent":["import { Exception, ExceptionOptions } from '.'\nimport { ErrorCode } from './code'\n\n/**\n * Interface representing the options for an Exception.\n *\n * @extends ExceptionOptions\n */\nexport interface AbortErrorOptions extends Omit<ExceptionOptions, 'code' | 'name'>\n{\n\t/** The HTTP status code associated with the Exception. */\n\tstatus?: number\n}\n\n\n/**\n * Exception Class.\n * \n * @template TMessage The type of the message property of the Exception. Defaults to `string`.\n *\n * @extends Exception\n */\nexport class AbortError<TMessage> extends Exception<TMessage, ErrorCode.ABORT> implements AbortErrorOptions\n{\n\tconstructor( reason: TMessage, options?: AbortErrorOptions )\n\t{\n\t\tsuper( reason, { name: 'AbortError', code: ErrorCode.ABORT, ...options } )\n\t}\n\n\n\t/**\n\t * Determines if the provided error is an instance of the AbortError class and has the ABORT ErrorCode.\n\t * \n\t * This won't work for `new DOMException( 'Abort reason', 'AbortError' )` since we type guard the checked value to `AbortError<TMessage>`.\n\t *\n\t * @template TMessage The type of the message property of the AbortError.\n\t * \n\t * @param\terror The error to check.\n\t * @returns\t`true` if the error is an `AbortError` and has the ABORT ErrorCode, `false` otherwise.\n\t */\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\tstatic isAbortError<TMessage = string>( error: any ): error is AbortError<TMessage>\n\t{\n\t\treturn super.isAbortError( error )\n\t}\n}"],"mappings":"sEAsBO,IAAMA,EAAN,cAAmCC,CAC1C,CACC,YAAaC,EAAkBC,EAC/B,CACC,MAAOD,EAAQ,CAAE,KAAM,aAAc,iBAAuB,GAAGC,CAAQ,CAAE,CAC1E,CAcA,OAAO,aAAiCC,EACxC,CACC,OAAO,MAAM,aAAcA,CAAM,CAClC,CACD","names":["AbortError","Exception","reason","options","error"]}

package/dist/chunk-CLZRQMJF.mjs

@@ -1,2 +0,0 @@
-var o=class t extends Error{constructor(e,s){super("",s),this.__typename="Exception",this.name=s.name||this.__typename,this.message=e,this.code=s.code,this.status=s.status}static isException(e){return e instanceof t||typeof e=="object"&&"__typename"in e&&e.__typename==="Exception"}static isAbortError(e){return t.isException(e)&&(e.name==="AbortError"||e.code==="ERR:ABORT")}toJSON(){return{...this,message:this.message,cause:this.cause}}};export{o as a};
-//# sourceMappingURL=chunk-CLZRQMJF.mjs.map

package/dist/chunk-CLZRQMJF.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { ErrorCode } from './code'\n\n/**\n * Interface representing the options for an Exception.\n *\n * @template TCode The type of the error code.\n * @extends ErrorOptions\n */\nexport interface ExceptionOptions<TCode = ErrorCode> extends ErrorOptions\n{\n\t/** The error code associated with the Exception. */\n\tcode: TCode\n\t/**  The name of the Exception. */\n\tname?: string\n\t/** The HTTP status code associated with the Exception. */\n\tstatus?: number\n}\n\n\n/**\n * Exception Class.\n * \n * @template TMessage\tThe type of the message property of the Exception. Defaults to `string`.\n * @template TCode\t\tThe type of the code property of the Exception. Defaults to `ErrorCode`.\n *\n * @extends Error\n * @implements ExceptionOptions<TCode>\n */\nexport class Exception<TMessage = string, TCode = ErrorCode> extends Error implements ExceptionOptions<TCode>\n{\n\t// @ts-expect-error Type 'TMessage' is not assignable to type 'string'.ts(2416)\n\tmessage: TMessage\n\tstatus\n\tname\n\tprivate __typename: 'Exception'\n\tcode\n\n\n\t/**\n\t * Constructs a new Exception instance.\n\t *\n\t * @param message The message describing the exception.\n\t * @param options Additional options for the exception.\n\t */\n\tconstructor( message: TMessage, options: ExceptionOptions<TCode> ) \n\t{\n\t\tsuper( '', options )\n\n\t\tthis.__typename\t= 'Exception'\n\t\tthis.name\t\t= options.name || this.__typename\n\t\tthis.message\t= message\n\t\tthis.code\t\t= options.code\n\t\tthis.status\t\t= options.status\n\t}\n\n\t\n\t\n\t/**\n\t * Determines if the provided error is an instance of the Exception class.\n\t *\n\t * @template TMessage\tThe type of the message property of the Exception.\n\t * @template TCode\t\tThe type of the code property of the Exception.\n\t * \n\t * @param\terror The error to check.\n\t * @returns\t`true` if the error is an instance of Exception or has a `__typename` property equal to 'Exception', `false` otherwise.\n\t */\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\tstatic isException<TMessage = string, TCode = ErrorCode>( error: any ): error is Exception<TMessage, TCode>\n\t{\n\t\treturn (\n\t\t\terror instanceof Exception ||\n\t\t\t( typeof error === 'object' && '__typename' in error && error.__typename === 'Exception' )\n\t\t)\n\t}\n\t\n\n\t/**\n\t * Determines if the provided error is an instance of the Exception class and has the ABORT ErrorCode.\n\t * \n\t * This won't work for `new DOMException( 'Abort reason', 'AbortError' )` since we type guard the checked value to `Exception<TMessage, ErrorCode.ABORT>`.\n\t *\n\t * @template TMessage The type of the message property of the Exception.\n\t * \n\t * @param\terror The error to check.\n\t * @returns\t`true` if the error is an `Exception` and has the ABORT ErrorCode, `false` otherwise.\n\t */\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\tstatic isAbortError<TMessage = string>( error: any ): error is Exception<TMessage, ErrorCode.ABORT>\n\t{\n\t\treturn (\n\t\t\tException.isException( error ) &&\n\t\t\t( error.name === 'AbortError' || error.code === ErrorCode.ABORT )\n\t\t)\n\t}\n\n\n\t/**\n\t * Converts the instance to a JSON object.\n\t *\n\t * @returns A JSON representation of the instance, including the message property.\n\t */\n\ttoJSON()\n\t{\n\t\treturn {\n\t\t\t...this,\n\t\t\tmessage\t: this.message,\n\t\t\tcause\t: this.cause,\n\t\t}\n\t}\n}"],"mappings":"AA4BO,IAAMA,EAAN,MAAMC,UAAwD,KACrE,CAeC,YAAaC,EAAmBC,EAChC,CACC,MAAO,GAAIA,CAAQ,EAEnB,KAAK,WAAa,YAClB,KAAK,KAAQA,EAAQ,MAAQ,KAAK,WAClC,KAAK,QAAUD,EACf,KAAK,KAAQC,EAAQ,KACrB,KAAK,OAAUA,EAAQ,MACxB,CAcA,OAAO,YAAmDC,EAC1D,CACC,OACCA,aAAiBH,GACf,OAAOG,GAAU,UAAY,eAAgBA,GAASA,EAAM,aAAe,WAE/E,CAcA,OAAO,aAAiCA,EACxC,CACC,OACCH,EAAU,YAAaG,CAAM,IAC3BA,EAAM,OAAS,cAAgBA,EAAM,OAAS,YAElD,CAQA,QACA,CACC,MAAO,CACN,GAAG,KACH,QAAU,KAAK,QACf,MAAQ,KAAK,KACd,CACD,CACD","names":["Exception","_Exception","message","options","error"]}

package/dist/chunk-FXYDTIUG.js

@@ -1,2 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var E=(R=>(R.UNKNOWN="ERR:UNKNOWN",R.ABORT="ERR:ABORT",R.EMPTY_VALUE="ERR:EMPTYVALUE",R.WRONG_VALUE="ERR:WRONGVALUE",R.EXPIRED="ERR:EXPIRED",R.TOO_EARLY="ERR:TOOEARLY",R))(E||{});exports.a = E;
-//# sourceMappingURL=chunk-FXYDTIUG.js.map

package/dist/chunk-FXYDTIUG.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/code.ts"],"names":["ErrorCode"],"mappings":"AAIO,6EAAKA,CAAAA,CAAAA,CAAAA,CAAAA,EAAAA,CAEXA,CAAAA,CAAA,OAAA,CAAW,aAAA,CACXA,CAAAA,CAAA,KAAA,CAAS,WAAA,CACTA,CAAAA,CAAA,WAAA,CAAc,gBAAA,CACdA,CAAAA,CAAA,WAAA,CAAc,gBAAA,CACdA,CAAAA,CAAA,OAAA,CAAW,aAAA,CACXA,CAAAA,CAAA,SAAA,CAAY,cAAA,CAPDA,CAAAA,CAAAA,CAAAA,CAAAA,CAAAA,EAAA,CAAA,CAAA,CAAA,CAAA,cAAA","file":"/Users/alessio/Documents/Personal/projects/exception/dist/chunk-FXYDTIUG.js","sourcesContent":["/**\n * Most common error codes.\n * \n */\nexport enum ErrorCode\n{\n\tUNKNOWN\t\t= 'ERR:UNKNOWN',\n\tABORT\t\t= 'ERR:ABORT',\n\tEMPTY_VALUE\t= 'ERR:EMPTYVALUE',\n\tWRONG_VALUE\t= 'ERR:WRONGVALUE',\n\tEXPIRED\t\t= 'ERR:EXPIRED',\n\tTOO_EARLY\t= 'ERR:TOOEARLY',\n}"]}

package/dist/chunk-JM2G32JS.mjs

@@ -1,2 +0,0 @@
-var E=(R=>(R.UNKNOWN="ERR:UNKNOWN",R.ABORT="ERR:ABORT",R.EMPTY_VALUE="ERR:EMPTYVALUE",R.WRONG_VALUE="ERR:WRONGVALUE",R.EXPIRED="ERR:EXPIRED",R.TOO_EARLY="ERR:TOOEARLY",R))(E||{});export{E as a};
-//# sourceMappingURL=chunk-JM2G32JS.mjs.map

package/dist/chunk-JM2G32JS.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/code.ts"],"sourcesContent":["/**\n * Most common error codes.\n * \n */\nexport enum ErrorCode\n{\n\tUNKNOWN\t\t= 'ERR:UNKNOWN',\n\tABORT\t\t= 'ERR:ABORT',\n\tEMPTY_VALUE\t= 'ERR:EMPTYVALUE',\n\tWRONG_VALUE\t= 'ERR:WRONGVALUE',\n\tEXPIRED\t\t= 'ERR:EXPIRED',\n\tTOO_EARLY\t= 'ERR:TOOEARLY',\n}"],"mappings":"AAIO,IAAKA,OAEXA,EAAA,QAAW,cACXA,EAAA,MAAS,YACTA,EAAA,YAAc,iBACdA,EAAA,YAAc,iBACdA,EAAA,QAAW,cACXA,EAAA,UAAY,eAPDA,OAAA","names":["ErrorCode"]}

package/dist/chunk-OJYXDMWZ.js

@@ -1,2 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var o=class t extends Error{constructor(e,s){super("",s),this.__typename="Exception",this.name=s.name||this.__typename,this.message=e,this.code=s.code,this.status=s.status}static isException(e){return e instanceof t||typeof e=="object"&&"__typename"in e&&e.__typename==="Exception"}static isAbortError(e){return t.isException(e)&&(e.name==="AbortError"||e.code==="ERR:ABORT")}toJSON(){return{...this,message:this.message,cause:this.cause}}};exports.a = o;
-//# sourceMappingURL=chunk-OJYXDMWZ.js.map

package/dist/chunk-OJYXDMWZ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/index.ts"],"names":["Exception","_Exception","message","options","error"],"mappings":"AA4BO,6EAAMA,CAAAA,CAAN,MAAMC,EAAAA,QAAwD,KACrE,CAeC,WAAA,CAAaC,CAAAA,CAAmBC,CAAAA,CAChC,CACC,KAAA,CAAO,EAAA,CAAIA,CAAQ,CAAA,CAEnB,IAAA,CAAK,UAAA,CAAa,WAAA,CAClB,IAAA,CAAK,IAAA,CAAQA,CAAAA,CAAQ,IAAA,EAAQ,IAAA,CAAK,UAAA,CAClC,IAAA,CAAK,OAAA,CAAUD,CAAAA,CACf,IAAA,CAAK,IAAA,CAAQC,CAAAA,CAAQ,IAAA,CACrB,IAAA,CAAK,MAAA,CAAUA,CAAAA,CAAQ,MACxB,CAcA,OAAO,WAAA,CAAmDC,CAAAA,CAC1D,CACC,OACCA,EAAAA,WAAiBH,CAAAA,EACf,OAAOG,CAAAA,EAAU,QAAA,EAAY,YAAA,GAAgBA,CAAAA,EAASA,CAAAA,CAAM,UAAA,GAAe,WAE/E,CAcA,OAAO,YAAA,CAAiCA,CAAAA,CACxC,CACC,OACCH,CAAAA,CAAU,WAAA,CAAaG,CAAM,CAAA,EAAA,CAC3BA,CAAAA,CAAM,IAAA,GAAS,YAAA,EAAgBA,CAAAA,CAAM,IAAA,GAAS,WAAA,CAElD,CAQA,MAAA,CAAA,CACA,CACC,MAAO,CACN,GAAG,IAAA,CACH,OAAA,CAAU,IAAA,CAAK,OAAA,CACf,KAAA,CAAQ,IAAA,CAAK,KACd,CACD,CACD,CAAA,CAAA,cAAA","file":"/Users/alessio/Documents/Personal/projects/exception/dist/chunk-OJYXDMWZ.js","sourcesContent":["import { ErrorCode } from './code'\n\n/**\n * Interface representing the options for an Exception.\n *\n * @template TCode The type of the error code.\n * @extends ErrorOptions\n */\nexport interface ExceptionOptions<TCode = ErrorCode> extends ErrorOptions\n{\n\t/** The error code associated with the Exception. */\n\tcode: TCode\n\t/**  The name of the Exception. */\n\tname?: string\n\t/** The HTTP status code associated with the Exception. */\n\tstatus?: number\n}\n\n\n/**\n * Exception Class.\n * \n * @template TMessage\tThe type of the message property of the Exception. Defaults to `string`.\n * @template TCode\t\tThe type of the code property of the Exception. Defaults to `ErrorCode`.\n *\n * @extends Error\n * @implements ExceptionOptions<TCode>\n */\nexport class Exception<TMessage = string, TCode = ErrorCode> extends Error implements ExceptionOptions<TCode>\n{\n\t// @ts-expect-error Type 'TMessage' is not assignable to type 'string'.ts(2416)\n\tmessage: TMessage\n\tstatus\n\tname\n\tprivate __typename: 'Exception'\n\tcode\n\n\n\t/**\n\t * Constructs a new Exception instance.\n\t *\n\t * @param message The message describing the exception.\n\t * @param options Additional options for the exception.\n\t */\n\tconstructor( message: TMessage, options: ExceptionOptions<TCode> ) \n\t{\n\t\tsuper( '', options )\n\n\t\tthis.__typename\t= 'Exception'\n\t\tthis.name\t\t= options.name || this.__typename\n\t\tthis.message\t= message\n\t\tthis.code\t\t= options.code\n\t\tthis.status\t\t= options.status\n\t}\n\n\t\n\t\n\t/**\n\t * Determines if the provided error is an instance of the Exception class.\n\t *\n\t * @template TMessage\tThe type of the message property of the Exception.\n\t * @template TCode\t\tThe type of the code property of the Exception.\n\t * \n\t * @param\terror The error to check.\n\t * @returns\t`true` if the error is an instance of Exception or has a `__typename` property equal to 'Exception', `false` otherwise.\n\t */\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\tstatic isException<TMessage = string, TCode = ErrorCode>( error: any ): error is Exception<TMessage, TCode>\n\t{\n\t\treturn (\n\t\t\terror instanceof Exception ||\n\t\t\t( typeof error === 'object' && '__typename' in error && error.__typename === 'Exception' )\n\t\t)\n\t}\n\t\n\n\t/**\n\t * Determines if the provided error is an instance of the Exception class and has the ABORT ErrorCode.\n\t * \n\t * This won't work for `new DOMException( 'Abort reason', 'AbortError' )` since we type guard the checked value to `Exception<TMessage, ErrorCode.ABORT>`.\n\t *\n\t * @template TMessage The type of the message property of the Exception.\n\t * \n\t * @param\terror The error to check.\n\t * @returns\t`true` if the error is an `Exception` and has the ABORT ErrorCode, `false` otherwise.\n\t */\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\tstatic isAbortError<TMessage = string>( error: any ): error is Exception<TMessage, ErrorCode.ABORT>\n\t{\n\t\treturn (\n\t\t\tException.isException( error ) &&\n\t\t\t( error.name === 'AbortError' || error.code === ErrorCode.ABORT )\n\t\t)\n\t}\n\n\n\t/**\n\t * Converts the instance to a JSON object.\n\t *\n\t * @returns A JSON representation of the instance, including the message property.\n\t */\n\ttoJSON()\n\t{\n\t\treturn {\n\t\t\t...this,\n\t\t\tmessage\t: this.message,\n\t\t\tcause\t: this.cause,\n\t\t}\n\t}\n}"]}

package/dist/code.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/Users/alessio/Documents/Personal/projects/exception/dist/code.js"],"names":[],"mappings":"AAAA,+HAAkC,uCAAuB","file":"/Users/alessio/Documents/Personal/projects/exception/dist/code.js"}

package/dist/code.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/Users/alessio/Documents/Personal/projects/exception/dist/index.js"],"names":[],"mappings":"AAAA,+HAAkC,+BAA4B,uCAAuB","file":"/Users/alessio/Documents/Personal/projects/exception/dist/index.js"}

package/dist/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}