@alessiofrittoli/exception 4.1.1 → 4.3.0

package/dist/abort/index.d.cts

@@ -1,6 +1,5 @@
+import { n as ExceptionOptions, t as Exception } from "../index-CAXMeOIU.cjs";
 import { ErrorCode } from "../code/index.cjs";
-import { Exception, ExceptionOptions } from "../index.cjs";
-//#region src/abort/index.d.ts
 /**
  * Interface representing the options for an Exception.
  *
@@ -25,5 +24,4 @@ export declare class AbortError<T = ErrorCode> extends Exception<T> implements A
    * @returns	`true` if the error is an `AbortError` and has the ABORT ErrorCode, `false` otherwise.
    */
   static isAbortError<T = ErrorCode>(error: any, code?: T): error is AbortError<T>;
-}
-//#endregion
+}

package/dist/abort/index.d.mts

@@ -1,6 +1,5 @@
+import { n as ExceptionOptions, t as Exception } from "../index-D_kjKA8h.mjs";
 import { ErrorCode } from "../code/index.mjs";
-import { Exception, ExceptionOptions } from "../index.mjs";
-//#region src/abort/index.d.ts
 /**
  * Interface representing the options for an Exception.
  *
@@ -25,5 +24,4 @@ export declare class AbortError<T = ErrorCode> extends Exception<T> implements A
    * @returns	`true` if the error is an `AbortError` and has the ABORT ErrorCode, `false` otherwise.
    */
   static isAbortError<T = ErrorCode>(error: any, code?: T): error is AbortError<T>;
-}
-//#endregion
+}

package/dist/code/index.d.cts

@@ -1,4 +1,3 @@
-//#region src/code/index.d.ts
 /**
  * Most common error codes.
  *
@@ -15,5 +14,4 @@ export declare const ErrorCode: {
   readonly NOT_FOUND: "ERR:NOTFOUND";
   readonly OFFLINE: "ERR:INTERNETDISCONNECTED";
 };
-export type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];
-//#endregion
+export type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];

package/dist/code/index.d.mts

@@ -1,4 +1,3 @@
-//#region src/code/index.d.ts
 /**
  * Most common error codes.
  *
@@ -15,5 +14,4 @@ export declare const ErrorCode: {
   readonly NOT_FOUND: "ERR:NOTFOUND";
   readonly OFFLINE: "ERR:INTERNETDISCONNECTED";
 };
-export type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];
-//#endregion
+export type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];

package/dist/index-CAXMeOIU.d.cts

@@ -0,0 +1,240 @@
+import { ErrorCode } from "./code/index.cjs";
+/**
+ * Constructs a type by picking all properties from `T` and then removing `U`.
+ *
+ * This is a strict version of the built-in `Omit`. The built-in one declares its keys
+ * as `K extends keyof any`, so it accepts **any** string, number or symbol: a typo or a
+ * property removed/renamed from `T` is silently ignored and the omission becomes a no-op,
+ * with no editor autocompletion on the keys either.
+ *
+ * Constraining `U` to `keyof T` makes the compiler reject keys that don't exist on `T`,
+ * so omitted properties stay in sync with the source type when it changes.
+ *
+ * @template T The type/interface from which properties will be omitted.
+ * @template U The keys of `T` to omit.
+ *
+ * @example
+ * ```ts
+ * interface User {
+ * 	id: string
+ * 	name: string
+ * }
+ *
+ * type A = globalThis.Omit<User, 'nmae'> // ✅ compiles, `name` is NOT omitted
+ * type B = Omit<User, 'nmae'> // ❌ Type '"nmae"' does not satisfy the constraint 'keyof User'.
+ * type C = Omit<User, 'name'> // ✅ `{ id: string }`
+ * ```
+ */
+type Omit<T, U extends keyof T> = globalThis.Omit<T, U>;
+/**
+ * Exception Name.
+ *
+ * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/DOMException#error_names)
+ */
+declare const ExceptionName: {
+  readonly Exception: "Exception";
+  readonly AbortError: "AbortError";
+  readonly NotAllowedError: "NotAllowedError";
+  readonly NotFoundError: "NotFoundError";
+  readonly NotSupportedError: "NotSupportedError";
+  readonly InvalidStateError: "InvalidStateError";
+  readonly InvalidAccessError: "InvalidAccessError";
+  readonly NetworkError: "NetworkError";
+  readonly SecurityError: "SecurityError";
+  readonly TimeoutError: "TimeoutError";
+  readonly QuotaExceededError: "QuotaExceededError";
+  readonly DataError: "DataError";
+  readonly EncodingError: "EncodingError";
+  readonly OperationError: "OperationError";
+  readonly ConstraintError: "ConstraintError";
+  readonly TransactionInactiveError: "TransactionInactiveError";
+  readonly ReadOnlyError: "ReadOnlyError";
+  readonly VersionError: "VersionError";
+  readonly NoModificationAllowedError: "NoModificationAllowedError";
+  readonly HierarchyRequestError: "HierarchyRequestError";
+  readonly WrongDocumentError: "WrongDocumentError";
+  readonly InvalidCharacterError: "InvalidCharacterError";
+  readonly NamespaceError: "NamespaceError";
+  readonly SyntaxError: "SyntaxError";
+  readonly DataCloneError: "DataCloneError";
+  readonly URLMismatchError: "URLMismatchError";
+  readonly InvalidModificationError: "InvalidModificationError";
+  readonly NotReadableError: "NotReadableError";
+};
+type ExceptionName = (typeof ExceptionName)[keyof typeof ExceptionName];
+/**
+ * The `Exception` severity.
+ *
+ */
+type Severity = typeof Exception.RECOVERABLE | typeof Exception.SEVERE | typeof Exception.CRITICAL;
+interface JSONException<T = ErrorCode> extends Omit<Exception<T>, 'toJSON'> {
+  Symbol: typeof ExceptionName.Exception;
+}
+/**
+ * Interface representing the options for an Exception.
+ *
+ * @template T The type of the error code.
+ *
+ * @extends ErrorOptions
+ */
+interface ExceptionOptions<T = ErrorCode> extends ErrorOptions {
+  /**
+   * The error interface name.
+   *
+   * @see {@link ExceptionName} for a list of possible standard values.
+   *
+   * @default ExceptionName.Exception
+   */
+  name?: string;
+  /**
+   * The error message containing technical informations about the error.
+   *
+   * It shouldn't be rendered to the user.
+   */
+  message?: string;
+  /**
+   * The error title.
+   *
+   */
+  title?: string;
+  /**
+   * The error description.
+   *
+   */
+  description?: string;
+  /**
+   * The error code associated with the Exception.
+   *
+   */
+  code: T;
+  /**
+   * Indicates whether the error is a critical error.
+   *
+   * @default false
+   */
+  isCritical?: boolean;
+  /**
+   * Indicates the error severity.
+   *
+   */
+  severity?: Severity;
+  /**
+   * The HTTP status code associated with the Exception.
+   *
+   */
+  status?: number;
+  /**
+   * The error cause.
+   *
+   */
+  cause?: unknown;
+}
+/**
+ * Exception Class.
+ *
+ * @template T The type of the code property of the Exception. Defaults to `ErrorCode`.
+ *
+ * @extends Error
+ */
+declare class Exception<T = ErrorCode> extends Error {
+  static readonly Symbol: unique symbol;
+  /**
+   * The error interface name.
+   *
+   */
+  readonly name: string;
+  /**
+   * The error message containing technical informations about the error.
+   *
+   * ⚠️ do not render `Exception.message` to the user.
+   */
+  readonly message: string;
+  /**
+   * The error title that can be rendered to the user.
+   *
+   */
+  readonly title: string | undefined;
+  /**
+   * The error description that can be rendered to the user.
+   *
+   */
+  readonly description: string | undefined;
+  /**
+   * The error code.
+   *
+   */
+  readonly code: T;
+  /**
+   * The HTTP status code associated with the Exception.
+   *
+   */
+  readonly status: number | undefined;
+  /**
+   * The error cause.
+   *
+   */
+  readonly cause: unknown;
+  /**
+   * The error severity.
+   *
+   */
+  readonly severity?: Severity;
+  /**
+   * Indicates whether the `Exception.severity` is critical.
+   *
+   */
+  readonly isCritical: boolean;
+  /**
+   * A non-critical error that could be resolved by retrying the algorithm maybe with different parameters.
+   *
+   */
+  static readonly RECOVERABLE = 1;
+  /**
+   * An error that interrupted some algorithms but the overall system still works.
+   *
+   */
+  static readonly SEVERE = 2;
+  /**
+   * An error that interrupts the algorithm.
+   *
+   */
+  static readonly CRITICAL = 3;
+  /**
+   * Constructs a new Exception instance.
+   *
+   * @param options An object defining Exception options. See {@link ExceptionOptions} for more info.
+   */
+  constructor(options: ExceptionOptions<T>);
+  /**
+   * Determines if the provided error is an instance of the Exception class.
+   *
+   * @template T 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.
+   */
+  static isException<T = ErrorCode>(error: unknown): error is Exception<T> | JSONException<T>;
+  /**
+   * Determines if the provided error is an instance of the Exception class and has the ABORT ErrorCode.
+   *
+   * @template T The type of the code 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<T = ErrorCode>(error: any, code?: T): error is Exception<T>;
+  /**
+   * Converts the instance to a JSON object.
+   *
+   * @returns A JSON representation of the instance, including the message property.
+   */
+  toJSON(): JSONException<T>;
+  /**
+   * Attempts to normalize the given `cause` to a possible `Exception` instance.
+   *
+   * @param cause The error cause.
+   * @returns The cause as `Exception` instance if applicable, the given cause as is (`unknown`) otherwise.
+   */
+  private static normalizeCause;
+}
+export { ExceptionName as a, Severity as i, ExceptionOptions as n, JSONException as r, Exception as t };

package/dist/index-D_kjKA8h.d.mts

@@ -0,0 +1,240 @@
+import { ErrorCode } from "./code/index.mjs";
+/**
+ * Constructs a type by picking all properties from `T` and then removing `U`.
+ *
+ * This is a strict version of the built-in `Omit`. The built-in one declares its keys
+ * as `K extends keyof any`, so it accepts **any** string, number or symbol: a typo or a
+ * property removed/renamed from `T` is silently ignored and the omission becomes a no-op,
+ * with no editor autocompletion on the keys either.
+ *
+ * Constraining `U` to `keyof T` makes the compiler reject keys that don't exist on `T`,
+ * so omitted properties stay in sync with the source type when it changes.
+ *
+ * @template T The type/interface from which properties will be omitted.
+ * @template U The keys of `T` to omit.
+ *
+ * @example
+ * ```ts
+ * interface User {
+ * 	id: string
+ * 	name: string
+ * }
+ *
+ * type A = globalThis.Omit<User, 'nmae'> // ✅ compiles, `name` is NOT omitted
+ * type B = Omit<User, 'nmae'> // ❌ Type '"nmae"' does not satisfy the constraint 'keyof User'.
+ * type C = Omit<User, 'name'> // ✅ `{ id: string }`
+ * ```
+ */
+type Omit<T, U extends keyof T> = globalThis.Omit<T, U>;
+/**
+ * Exception Name.
+ *
+ * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/DOMException#error_names)
+ */
+declare const ExceptionName: {
+  readonly Exception: "Exception";
+  readonly AbortError: "AbortError";
+  readonly NotAllowedError: "NotAllowedError";
+  readonly NotFoundError: "NotFoundError";
+  readonly NotSupportedError: "NotSupportedError";
+  readonly InvalidStateError: "InvalidStateError";
+  readonly InvalidAccessError: "InvalidAccessError";
+  readonly NetworkError: "NetworkError";
+  readonly SecurityError: "SecurityError";
+  readonly TimeoutError: "TimeoutError";
+  readonly QuotaExceededError: "QuotaExceededError";
+  readonly DataError: "DataError";
+  readonly EncodingError: "EncodingError";
+  readonly OperationError: "OperationError";
+  readonly ConstraintError: "ConstraintError";
+  readonly TransactionInactiveError: "TransactionInactiveError";
+  readonly ReadOnlyError: "ReadOnlyError";
+  readonly VersionError: "VersionError";
+  readonly NoModificationAllowedError: "NoModificationAllowedError";
+  readonly HierarchyRequestError: "HierarchyRequestError";
+  readonly WrongDocumentError: "WrongDocumentError";
+  readonly InvalidCharacterError: "InvalidCharacterError";
+  readonly NamespaceError: "NamespaceError";
+  readonly SyntaxError: "SyntaxError";
+  readonly DataCloneError: "DataCloneError";
+  readonly URLMismatchError: "URLMismatchError";
+  readonly InvalidModificationError: "InvalidModificationError";
+  readonly NotReadableError: "NotReadableError";
+};
+type ExceptionName = (typeof ExceptionName)[keyof typeof ExceptionName];
+/**
+ * The `Exception` severity.
+ *
+ */
+type Severity = typeof Exception.RECOVERABLE | typeof Exception.SEVERE | typeof Exception.CRITICAL;
+interface JSONException<T = ErrorCode> extends Omit<Exception<T>, 'toJSON'> {
+  Symbol: typeof ExceptionName.Exception;
+}
+/**
+ * Interface representing the options for an Exception.
+ *
+ * @template T The type of the error code.
+ *
+ * @extends ErrorOptions
+ */
+interface ExceptionOptions<T = ErrorCode> extends ErrorOptions {
+  /**
+   * The error interface name.
+   *
+   * @see {@link ExceptionName} for a list of possible standard values.
+   *
+   * @default ExceptionName.Exception
+   */
+  name?: string;
+  /**
+   * The error message containing technical informations about the error.
+   *
+   * It shouldn't be rendered to the user.
+   */
+  message?: string;
+  /**
+   * The error title.
+   *
+   */
+  title?: string;
+  /**
+   * The error description.
+   *
+   */
+  description?: string;
+  /**
+   * The error code associated with the Exception.
+   *
+   */
+  code: T;
+  /**
+   * Indicates whether the error is a critical error.
+   *
+   * @default false
+   */
+  isCritical?: boolean;
+  /**
+   * Indicates the error severity.
+   *
+   */
+  severity?: Severity;
+  /**
+   * The HTTP status code associated with the Exception.
+   *
+   */
+  status?: number;
+  /**
+   * The error cause.
+   *
+   */
+  cause?: unknown;
+}
+/**
+ * Exception Class.
+ *
+ * @template T The type of the code property of the Exception. Defaults to `ErrorCode`.
+ *
+ * @extends Error
+ */
+declare class Exception<T = ErrorCode> extends Error {
+  static readonly Symbol: unique symbol;
+  /**
+   * The error interface name.
+   *
+   */
+  readonly name: string;
+  /**
+   * The error message containing technical informations about the error.
+   *
+   * ⚠️ do not render `Exception.message` to the user.
+   */
+  readonly message: string;
+  /**
+   * The error title that can be rendered to the user.
+   *
+   */
+  readonly title: string | undefined;
+  /**
+   * The error description that can be rendered to the user.
+   *
+   */
+  readonly description: string | undefined;
+  /**
+   * The error code.
+   *
+   */
+  readonly code: T;
+  /**
+   * The HTTP status code associated with the Exception.
+   *
+   */
+  readonly status: number | undefined;
+  /**
+   * The error cause.
+   *
+   */
+  readonly cause: unknown;
+  /**
+   * The error severity.
+   *
+   */
+  readonly severity?: Severity;
+  /**
+   * Indicates whether the `Exception.severity` is critical.
+   *
+   */
+  readonly isCritical: boolean;
+  /**
+   * A non-critical error that could be resolved by retrying the algorithm maybe with different parameters.
+   *
+   */
+  static readonly RECOVERABLE = 1;
+  /**
+   * An error that interrupted some algorithms but the overall system still works.
+   *
+   */
+  static readonly SEVERE = 2;
+  /**
+   * An error that interrupts the algorithm.
+   *
+   */
+  static readonly CRITICAL = 3;
+  /**
+   * Constructs a new Exception instance.
+   *
+   * @param options An object defining Exception options. See {@link ExceptionOptions} for more info.
+   */
+  constructor(options: ExceptionOptions<T>);
+  /**
+   * Determines if the provided error is an instance of the Exception class.
+   *
+   * @template T 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.
+   */
+  static isException<T = ErrorCode>(error: unknown): error is Exception<T> | JSONException<T>;
+  /**
+   * Determines if the provided error is an instance of the Exception class and has the ABORT ErrorCode.
+   *
+   * @template T The type of the code 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<T = ErrorCode>(error: any, code?: T): error is Exception<T>;
+  /**
+   * Converts the instance to a JSON object.
+   *
+   * @returns A JSON representation of the instance, including the message property.
+   */
+  toJSON(): JSONException<T>;
+  /**
+   * Attempts to normalize the given `cause` to a possible `Exception` instance.
+   *
+   * @param cause The error cause.
+   * @returns The cause as `Exception` instance if applicable, the given cause as is (`unknown`) otherwise.
+   */
+  private static normalizeCause;
+}
+export { ExceptionName as a, Severity as i, ExceptionOptions as n, JSONException as r, Exception as t };

package/dist/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./code/index.cjs"),t={Exception:`Exception`,AbortError:`AbortError`,NotAllowedError:`NotAllowedError`,NotFoundError:`NotFoundError`,NotSupportedError:`NotSupportedError`,InvalidStateError:`InvalidStateError`,InvalidAccessError:`InvalidAccessError`,NetworkError:`NetworkError`,SecurityError:`SecurityError`,TimeoutError:`TimeoutError`,QuotaExceededError:`QuotaExceededError`,DataError:`DataError`,EncodingError:`EncodingError`,OperationError:`OperationError`,ConstraintError:`ConstraintError`,TransactionInactiveError:`TransactionInactiveError`,ReadOnlyError:`ReadOnlyError`,VersionError:`VersionError`,NoModificationAllowedError:`NoModificationAllowedError`,HierarchyRequestError:`HierarchyRequestError`,WrongDocumentError:`WrongDocumentError`,InvalidCharacterError:`InvalidCharacterError`,NamespaceError:`NamespaceError`,SyntaxError:`SyntaxError`,DataCloneError:`DataCloneError`,URLMismatchError:`URLMismatchError`,InvalidModificationError:`InvalidModificationError`,NotReadableError:`NotReadableError`};var n=class n extends Error{__typename=t.Exception;name=this.__typename;message;title;description;code;isCritical;status;cause;constructor(e){let{message:t=`Unknown error.`}=e;super(t),e.name&&(this.name=e.name),this.message=t,this.title=e.title,this.description=e.description,this.code=e.code,this.isCritical=e.isCritical??!1,this.status=e.status,this.cause=n.isException(e.cause)?new n(e.cause):e.cause}static isException(e){return e instanceof n||!!e&&typeof e==`object`&&`__typename`in e&&e.__typename===t.Exception}static isAbortError(r,i=e.ErrorCode.ABORT){return n.isException(r)&&(r.name===t.AbortError||r.code===i)}toJSON(){return{...this,message:this.message,cause:this.cause}}};exports.Exception=n,exports.ExceptionName=t;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./code/index.cjs"),t={Exception:`Exception`,AbortError:`AbortError`,NotAllowedError:`NotAllowedError`,NotFoundError:`NotFoundError`,NotSupportedError:`NotSupportedError`,InvalidStateError:`InvalidStateError`,InvalidAccessError:`InvalidAccessError`,NetworkError:`NetworkError`,SecurityError:`SecurityError`,TimeoutError:`TimeoutError`,QuotaExceededError:`QuotaExceededError`,DataError:`DataError`,EncodingError:`EncodingError`,OperationError:`OperationError`,ConstraintError:`ConstraintError`,TransactionInactiveError:`TransactionInactiveError`,ReadOnlyError:`ReadOnlyError`,VersionError:`VersionError`,NoModificationAllowedError:`NoModificationAllowedError`,HierarchyRequestError:`HierarchyRequestError`,WrongDocumentError:`WrongDocumentError`,InvalidCharacterError:`InvalidCharacterError`,NamespaceError:`NamespaceError`,SyntaxError:`SyntaxError`,DataCloneError:`DataCloneError`,URLMismatchError:`URLMismatchError`,InvalidModificationError:`InvalidModificationError`,NotReadableError:`NotReadableError`};var n=class n extends Error{static Symbol=Symbol.for(t.Exception);name=t.Exception;message;title;description;code;status;cause;severity;isCritical;static RECOVERABLE=1;static SEVERE=2;static CRITICAL=3;constructor(e){let{message:t=`Unknown error.`}=e;super(t),e.name&&(this.name=e.name);let{isCritical:r,severity:i=r?n.CRITICAL:void 0}=e;this.message=t,this.title=e.title,this.description=e.description,this.code=e.code,this.severity=i,this.isCritical=r??this.severity===n.CRITICAL,this.status=e.status,this.cause=n.normalizeCause(e.cause)}static isException(e){return!e||typeof e!=`object`?!1:e instanceof n?!0:`Symbol`in e?e.Symbol===n.Symbol||typeof e.Symbol==`string`&&Symbol.for(e.Symbol)===n.Symbol:!1}static isAbortError(r,i=e.ErrorCode.ABORT){return n.isException(r)&&(r.name===t.AbortError||r.code===i)}toJSON(){return{Symbol:t.Exception,name:this.name,message:this.message,code:this.code,title:this.title,description:this.description,isCritical:this.isCritical,severity:this.severity,status:this.status,cause:this.cause}}static normalizeCause(e){return!n.isException(e)||e instanceof n?e:new n(e)}};exports.Exception=n,exports.ExceptionName=t;

package/dist/index.d.cts

@@ -1,177 +1,2 @@
-import { ErrorCode } from "./code/index.cjs";
-//#region src/error-names.d.ts
-/**
- * Exception Name.
- *
- * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/DOMException#error_names)
- */
-export declare const ExceptionName: {
-  readonly Exception: "Exception";
-  readonly AbortError: "AbortError";
-  readonly NotAllowedError: "NotAllowedError";
-  readonly NotFoundError: "NotFoundError";
-  readonly NotSupportedError: "NotSupportedError";
-  readonly InvalidStateError: "InvalidStateError";
-  readonly InvalidAccessError: "InvalidAccessError";
-  readonly NetworkError: "NetworkError";
-  readonly SecurityError: "SecurityError";
-  readonly TimeoutError: "TimeoutError";
-  readonly QuotaExceededError: "QuotaExceededError";
-  readonly DataError: "DataError";
-  readonly EncodingError: "EncodingError";
-  readonly OperationError: "OperationError";
-  readonly ConstraintError: "ConstraintError";
-  readonly TransactionInactiveError: "TransactionInactiveError";
-  readonly ReadOnlyError: "ReadOnlyError";
-  readonly VersionError: "VersionError";
-  readonly NoModificationAllowedError: "NoModificationAllowedError";
-  readonly HierarchyRequestError: "HierarchyRequestError";
-  readonly WrongDocumentError: "WrongDocumentError";
-  readonly InvalidCharacterError: "InvalidCharacterError";
-  readonly NamespaceError: "NamespaceError";
-  readonly SyntaxError: "SyntaxError";
-  readonly DataCloneError: "DataCloneError";
-  readonly URLMismatchError: "URLMismatchError";
-  readonly InvalidModificationError: "InvalidModificationError";
-  readonly NotReadableError: "NotReadableError";
-};
-export type ExceptionName = (typeof ExceptionName)[keyof typeof ExceptionName];
-//#endregion
-//#region src/index.d.ts
-/**
- * Interface representing the options for an Exception.
- *
- * @template T The type of the error code.
- *
- * @extends ErrorOptions
- */
-export interface ExceptionOptions<T = ErrorCode> extends ErrorOptions {
-  /**
-   * The error interface name.
-   *
-   * @see {@link ExceptionName} for a list of possible standard values.
-   *
-   * @default ExceptionName.Exception
-   */
-  name?: string;
-  /**
-   * The error message containing technical informations about the error.
-   *
-   * It shouldn't be rendered to the user.
-   */
-  message?: string;
-  /**
-   * The error title.
-   *
-   */
-  title?: string;
-  /**
-   * The error description.
-   *
-   */
-  description?: string;
-  /**
-   * The error code associated with the Exception.
-   *
-   */
-  code: T;
-  /**
-   * Indicates whether the error is a critical error.
-   *
-   * @default false
-   */
-  isCritical?: boolean;
-  /**
-   * The HTTP status code associated with the Exception.
-   *
-   */
-  status?: number;
-  /**
-   * The error cause.
-   *
-   */
-  cause?: unknown;
-}
-/**
- * Exception Class.
- *
- * @template T The type of the code property of the Exception. Defaults to `ErrorCode`.
- *
- * @extends Error
- * @implements ExceptionOptions<T>
- */
-export declare class Exception<T = ErrorCode> extends Error {
-  private readonly __typename;
-  /**
-   * The error interface name.
-   *
-   */
-  readonly name: string;
-  /**
-   * The error message containing technical informations about the error.
-   *
-   * ⚠️ do not render `Exception.message` to the user.
-   */
-  readonly message: string;
-  /**
-   * The error title that can be rendered to the user.
-   *
-   */
-  readonly title: string | undefined;
-  /**
-   * The error description that can be rendered to the user.
-   *
-   */
-  readonly description: string | undefined;
-  /**
-   * The error code.
-   *
-   */
-  readonly code: T;
-  /**
-   * Indicates whether the error is a critical error.
-   *
-   */
-  readonly isCritical: boolean;
-  /**
-   * The HTTP status code associated with the Exception.
-   *
-   */
-  readonly status: number | undefined;
-  /**
-   * The error cause.
-   *
-   */
-  readonly cause: unknown;
-  /**
-   * Constructs a new Exception instance.
-   *
-   * @param options An object defining Exception options. See {@link ExceptionOptions} for more info.
-   */
-  constructor(options: ExceptionOptions<T>);
-  /**
-   * Determines if the provided error is an instance of the Exception class.
-   *
-   * @template T 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.
-   */
-  static isException<T = ErrorCode>(error: any): error is Exception<T>;
-  /**
-   * Determines if the provided error is an instance of the Exception class and has the ABORT ErrorCode.
-   *
-   * @template T The type of the code 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<T = ErrorCode>(error: any, code?: T): error is Exception<T>;
-  /**
-   * Converts the instance to a JSON object.
-   *
-   * @returns A JSON representation of the instance, including the message property.
-   */
-  toJSON(): this;
-}
-//#endregion
+import { a as ExceptionName, i as Severity, n as ExceptionOptions, r as JSONException, t as Exception } from "./index-CAXMeOIU.cjs";
+export { Exception, ExceptionName, ExceptionOptions, JSONException, Severity };

package/dist/index.d.mts

@@ -1,177 +1,2 @@
-import { ErrorCode } from "./code/index.mjs";
-//#region src/error-names.d.ts
-/**
- * Exception Name.
- *
- * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/DOMException#error_names)
- */
-export declare const ExceptionName: {
-  readonly Exception: "Exception";
-  readonly AbortError: "AbortError";
-  readonly NotAllowedError: "NotAllowedError";
-  readonly NotFoundError: "NotFoundError";
-  readonly NotSupportedError: "NotSupportedError";
-  readonly InvalidStateError: "InvalidStateError";
-  readonly InvalidAccessError: "InvalidAccessError";
-  readonly NetworkError: "NetworkError";
-  readonly SecurityError: "SecurityError";
-  readonly TimeoutError: "TimeoutError";
-  readonly QuotaExceededError: "QuotaExceededError";
-  readonly DataError: "DataError";
-  readonly EncodingError: "EncodingError";
-  readonly OperationError: "OperationError";
-  readonly ConstraintError: "ConstraintError";
-  readonly TransactionInactiveError: "TransactionInactiveError";
-  readonly ReadOnlyError: "ReadOnlyError";
-  readonly VersionError: "VersionError";
-  readonly NoModificationAllowedError: "NoModificationAllowedError";
-  readonly HierarchyRequestError: "HierarchyRequestError";
-  readonly WrongDocumentError: "WrongDocumentError";
-  readonly InvalidCharacterError: "InvalidCharacterError";
-  readonly NamespaceError: "NamespaceError";
-  readonly SyntaxError: "SyntaxError";
-  readonly DataCloneError: "DataCloneError";
-  readonly URLMismatchError: "URLMismatchError";
-  readonly InvalidModificationError: "InvalidModificationError";
-  readonly NotReadableError: "NotReadableError";
-};
-export type ExceptionName = (typeof ExceptionName)[keyof typeof ExceptionName];
-//#endregion
-//#region src/index.d.ts
-/**
- * Interface representing the options for an Exception.
- *
- * @template T The type of the error code.
- *
- * @extends ErrorOptions
- */
-export interface ExceptionOptions<T = ErrorCode> extends ErrorOptions {
-  /**
-   * The error interface name.
-   *
-   * @see {@link ExceptionName} for a list of possible standard values.
-   *
-   * @default ExceptionName.Exception
-   */
-  name?: string;
-  /**
-   * The error message containing technical informations about the error.
-   *
-   * It shouldn't be rendered to the user.
-   */
-  message?: string;
-  /**
-   * The error title.
-   *
-   */
-  title?: string;
-  /**
-   * The error description.
-   *
-   */
-  description?: string;
-  /**
-   * The error code associated with the Exception.
-   *
-   */
-  code: T;
-  /**
-   * Indicates whether the error is a critical error.
-   *
-   * @default false
-   */
-  isCritical?: boolean;
-  /**
-   * The HTTP status code associated with the Exception.
-   *
-   */
-  status?: number;
-  /**
-   * The error cause.
-   *
-   */
-  cause?: unknown;
-}
-/**
- * Exception Class.
- *
- * @template T The type of the code property of the Exception. Defaults to `ErrorCode`.
- *
- * @extends Error
- * @implements ExceptionOptions<T>
- */
-export declare class Exception<T = ErrorCode> extends Error {
-  private readonly __typename;
-  /**
-   * The error interface name.
-   *
-   */
-  readonly name: string;
-  /**
-   * The error message containing technical informations about the error.
-   *
-   * ⚠️ do not render `Exception.message` to the user.
-   */
-  readonly message: string;
-  /**
-   * The error title that can be rendered to the user.
-   *
-   */
-  readonly title: string | undefined;
-  /**
-   * The error description that can be rendered to the user.
-   *
-   */
-  readonly description: string | undefined;
-  /**
-   * The error code.
-   *
-   */
-  readonly code: T;
-  /**
-   * Indicates whether the error is a critical error.
-   *
-   */
-  readonly isCritical: boolean;
-  /**
-   * The HTTP status code associated with the Exception.
-   *
-   */
-  readonly status: number | undefined;
-  /**
-   * The error cause.
-   *
-   */
-  readonly cause: unknown;
-  /**
-   * Constructs a new Exception instance.
-   *
-   * @param options An object defining Exception options. See {@link ExceptionOptions} for more info.
-   */
-  constructor(options: ExceptionOptions<T>);
-  /**
-   * Determines if the provided error is an instance of the Exception class.
-   *
-   * @template T 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.
-   */
-  static isException<T = ErrorCode>(error: any): error is Exception<T>;
-  /**
-   * Determines if the provided error is an instance of the Exception class and has the ABORT ErrorCode.
-   *
-   * @template T The type of the code 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<T = ErrorCode>(error: any, code?: T): error is Exception<T>;
-  /**
-   * Converts the instance to a JSON object.
-   *
-   * @returns A JSON representation of the instance, including the message property.
-   */
-  toJSON(): this;
-}
-//#endregion
+import { a as ExceptionName, i as Severity, n as ExceptionOptions, r as JSONException, t as Exception } from "./index-D_kjKA8h.mjs";
+export { Exception, ExceptionName, ExceptionOptions, JSONException, Severity };

package/dist/index.mjs

@@ -1 +1 @@
-import{ErrorCode as e}from"./code/index.mjs";const t={Exception:`Exception`,AbortError:`AbortError`,NotAllowedError:`NotAllowedError`,NotFoundError:`NotFoundError`,NotSupportedError:`NotSupportedError`,InvalidStateError:`InvalidStateError`,InvalidAccessError:`InvalidAccessError`,NetworkError:`NetworkError`,SecurityError:`SecurityError`,TimeoutError:`TimeoutError`,QuotaExceededError:`QuotaExceededError`,DataError:`DataError`,EncodingError:`EncodingError`,OperationError:`OperationError`,ConstraintError:`ConstraintError`,TransactionInactiveError:`TransactionInactiveError`,ReadOnlyError:`ReadOnlyError`,VersionError:`VersionError`,NoModificationAllowedError:`NoModificationAllowedError`,HierarchyRequestError:`HierarchyRequestError`,WrongDocumentError:`WrongDocumentError`,InvalidCharacterError:`InvalidCharacterError`,NamespaceError:`NamespaceError`,SyntaxError:`SyntaxError`,DataCloneError:`DataCloneError`,URLMismatchError:`URLMismatchError`,InvalidModificationError:`InvalidModificationError`,NotReadableError:`NotReadableError`};var n=class n extends Error{__typename=t.Exception;name=this.__typename;message;title;description;code;isCritical;status;cause;constructor(e){let{message:t=`Unknown error.`}=e;super(t),e.name&&(this.name=e.name),this.message=t,this.title=e.title,this.description=e.description,this.code=e.code,this.isCritical=e.isCritical??!1,this.status=e.status,this.cause=n.isException(e.cause)?new n(e.cause):e.cause}static isException(e){return e instanceof n||!!e&&typeof e==`object`&&`__typename`in e&&e.__typename===t.Exception}static isAbortError(r,i=e.ABORT){return n.isException(r)&&(r.name===t.AbortError||r.code===i)}toJSON(){return{...this,message:this.message,cause:this.cause}}};export{n as Exception,t as ExceptionName};
+import{ErrorCode as e}from"./code/index.mjs";const t={Exception:`Exception`,AbortError:`AbortError`,NotAllowedError:`NotAllowedError`,NotFoundError:`NotFoundError`,NotSupportedError:`NotSupportedError`,InvalidStateError:`InvalidStateError`,InvalidAccessError:`InvalidAccessError`,NetworkError:`NetworkError`,SecurityError:`SecurityError`,TimeoutError:`TimeoutError`,QuotaExceededError:`QuotaExceededError`,DataError:`DataError`,EncodingError:`EncodingError`,OperationError:`OperationError`,ConstraintError:`ConstraintError`,TransactionInactiveError:`TransactionInactiveError`,ReadOnlyError:`ReadOnlyError`,VersionError:`VersionError`,NoModificationAllowedError:`NoModificationAllowedError`,HierarchyRequestError:`HierarchyRequestError`,WrongDocumentError:`WrongDocumentError`,InvalidCharacterError:`InvalidCharacterError`,NamespaceError:`NamespaceError`,SyntaxError:`SyntaxError`,DataCloneError:`DataCloneError`,URLMismatchError:`URLMismatchError`,InvalidModificationError:`InvalidModificationError`,NotReadableError:`NotReadableError`};var n=class n extends Error{static Symbol=Symbol.for(t.Exception);name=t.Exception;message;title;description;code;status;cause;severity;isCritical;static RECOVERABLE=1;static SEVERE=2;static CRITICAL=3;constructor(e){let{message:t=`Unknown error.`}=e;super(t),e.name&&(this.name=e.name);let{isCritical:r,severity:i=r?n.CRITICAL:void 0}=e;this.message=t,this.title=e.title,this.description=e.description,this.code=e.code,this.severity=i,this.isCritical=r??this.severity===n.CRITICAL,this.status=e.status,this.cause=n.normalizeCause(e.cause)}static isException(e){return!e||typeof e!=`object`?!1:e instanceof n?!0:`Symbol`in e?e.Symbol===n.Symbol||typeof e.Symbol==`string`&&Symbol.for(e.Symbol)===n.Symbol:!1}static isAbortError(r,i=e.ABORT){return n.isException(r)&&(r.name===t.AbortError||r.code===i)}toJSON(){return{Symbol:t.Exception,name:this.name,message:this.message,code:this.code,title:this.title,description:this.description,isCritical:this.isCritical,severity:this.severity,status:this.status,cause:this.cause}}static normalizeCause(e){return!n.isException(e)||e instanceof n?e:new n(e)}};export{n as Exception,t as ExceptionName};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alessiofrittoli/exception",
-  "version": "4.1.1",
+  "version": "4.3.0",
   "description": "Handle errors with ease",
   "type": "module",
   "author": {
@@ -62,26 +62,27 @@
   },
   "sideEffects": false,
   "devDependencies": {
-    "@alessiofrittoli/node-scripts": "^4.0.0-alpha.3",
-    "@alessiofrittoli/package-configs": "^1.6.0",
+    "@alessiofrittoli/node-scripts": "^4.2.0",
+    "@alessiofrittoli/package-configs": "^1.12.0",
+    "@alessiofrittoli/type-utils": "^2.2.0",
     "@types/node": "^24.19.1",
-    "@vitest/coverage-v8": "^5.0.3",
-    "concurrently": "^9.2.1",
+    "@vitest/coverage-v8": "^5.1.0",
+    "concurrently": "^10.0.6",
     "http-server": "^14.1.1",
-    "oxlint": "^1.86.0",
-    "prettier": "^3.9.9",
+    "oxlint": "^1.90.0",
+    "oxlint-tsgolint": "^7.0.2005",
+    "prettier": "^3.9.10",
     "prettier-plugin-sort-imports": "^1.8.11",
-    "tsdown": "^0.23.0",
+    "tsdown": "^0.23.4",
     "typescript": "^6.0.3",
-    "vite": "^8.3.2",
-    "vitest": "^5.0.3"
+    "vitest": "^5.1.0"
   },
   "scripts": {
     "//1a": "*********************************************************************",
     "//1b": "******************** DEV - BUILD - LINT - RELEASE *******************",
     "//1c": "*********************************************************************",
     "dev": "tsdown --watch",
-    "build": "pnpm lint && pnpm tsc && pnpm tsdown",
+    "build": "pnpm lint && pnpm tsdown",
     "lint": "oxlint --report-unused-disable-directives --max-warnings 0",
     "release": "node scripts/release.ts --verbose --npm",
     "//2a": "*********************************************************************",