@alextheman/utility 5.11.3 → 5.13.0

package/dist/index.d.cts

@@ -461,62 +461,6 @@ declare class APIError extends Error {
   static check(input: unknown): input is APIError;
 }
 //#endregion
-//#region src/root/types/DataError.d.ts
-interface ExpectErrorOptions {
-  expectedCode?: string;
-}
-/**
- * Represents errors you may get that may've been caused by a specific piece of data.
- *
- * @category Types
- *
- * @template DataType - The type of the data that caused the error.
- */
-declare class DataError<DataType extends Record<PropertyKey, unknown> = Record<PropertyKey, unknown>> extends Error {
-  code: string;
-  data: DataType;
-  /**
-   * @param data - The data that caused the error.
-   * @param code - A standardised code (e.g. UNEXPECTED_DATA).
-   * @param message  - A human-readable error message (e.g. The data provided is invalid).
-   * @param options - Extra options to pass to super Error constructor.
-   */
-  constructor(data: DataType, code?: string, message?: string, options?: ErrorOptions);
-  private static checkCaughtError;
-  /**
-   * Checks whether the given input may have been caused by a DataError.
-   *
-   * @param input - The input to check.
-   *
-   * @returns `true` if the input is a DataError, and `false` otherwise. The type of the input will also be narrowed down to DataError if `true`.
-   */
-  static check<DataType extends Record<PropertyKey, unknown> = Record<PropertyKey, unknown>>(input: unknown): input is DataError<DataType>;
-  /**
-   * Gets the thrown `DataError` from a given function if one was thrown, and re-throws any other errors, or throws a default `DataError` if no error thrown.
-   *
-   * @param errorFunction - The function expected to throw the error.
-   * @param options - Extra options to apply.
-   *
-   * @throws {Error} Any other errors thrown by the `errorFunction` that are not a `DataError`.
-   * @throws {Error} If no `DataError` was thrown by the `errorFunction`
-   *
-   * @returns The `DataError` that was thrown by the `errorFunction`
-   */
-  static expectError(errorFunction: () => unknown, options?: ExpectErrorOptions): DataError;
-  /**
-   * Gets the thrown `DataError` from a given asynchronous function if one was thrown, and re-throws any other errors, or throws a default `DataError` if no error thrown.
-   *
-   * @param errorFunction - The function expected to throw the error.
-   * @param options - Extra options to apply.
-   *
-   * @throws {Error} Any other errors thrown by the `errorFunction` that are not a `DataError`.
-   * @throws {Error} If no `DataError` was thrown by the `errorFunction`
-   *
-   * @returns The `DataError` that was thrown by the `errorFunction`
-   */
-  static expectErrorAsync(errorFunction: () => Promise<unknown>, options?: ExpectErrorOptions): Promise<DataError>;
-}
-//#endregion
 //#region src/root/types/VersionNumber.d.ts
 /**
  * Options to apply to the stringification of the version number.
@@ -794,6 +738,119 @@ type VersionType = CreateEnumType<typeof VersionType>;
  */
 declare function parseVersionType(input: unknown): VersionType;
 //#endregion
+//#region src/v6/CodeError.d.ts
+interface ExpectErrorOptions$2<ErrorCode extends string = string> {
+  expectedCode?: ErrorCode;
+}
+/**
+ * Represents errors that can be described using a standardised error code, and a human-readable error message.
+ *
+ * @category Types
+ *
+ * @template ErrorCode The type of the standardised error code.
+ */
+declare class CodeError<ErrorCode extends string = string> extends Error {
+  code: ErrorCode;
+  /**
+   * @param code - A standardised code (e.g. UNEXPECTED_DATA).
+   * @param message  - A human-readable error message (e.g. The data provided is invalid).
+   * @param options - Extra options to pass to super Error constructor.
+   */
+  constructor(code: ErrorCode, message?: string, options?: ErrorOptions);
+  /**
+   * Checks whether the given input may have been caused by a CodeError.
+   *
+   * @param input - The input to check.
+   *
+   * @returns `true` if the input is a CodeError, and `false` otherwise. The type of the input will also be narrowed down to CodeError if `true`.
+   */
+  static check(input: unknown): input is CodeError<string>;
+  protected static checkCaughtError<ErrorCode extends string = string>(this: typeof CodeError, error: unknown, options?: ExpectErrorOptions$2<ErrorCode>): CodeError;
+  /**
+   * Gets the thrown `CodeError` from a given function if one was thrown, and re-throws any other errors, or throws a default `CodeError` if no error thrown.
+   *
+   * @param errorFunction - The function expected to throw the error.
+   * @param options - Extra options to apply.
+   *
+   * @throws {Error} Any other errors thrown by the `errorFunction` that are not a `CodeError`.
+   * @throws {Error} If no `CodeError` was thrown by the `errorFunction`
+   *
+   * @returns The `CodeError` that was thrown by the `errorFunction`
+   */
+  static expectError<ErrorCode extends string = string>(this: typeof CodeError, errorFunction: () => unknown, options?: ExpectErrorOptions$2<ErrorCode>): CodeError;
+  /**
+   * Gets the thrown `CodeError` from a given asynchronous function if one was thrown, and re-throws any other errors, or throws a default `CodeError` if no error thrown.
+   *
+   * @param errorFunction - The function expected to throw the error.
+   * @param options - Extra options to apply.
+   *
+   * @throws {Error} Any other errors thrown by the `errorFunction` that are not a `CodeError`.
+   * @throws {Error} If no `CodeError` was thrown by the `errorFunction`
+   *
+   * @returns The `CodeError` that was thrown by the `errorFunction`
+   */
+  static expectErrorAsync<ErrorCode extends string = string>(this: typeof CodeError, errorFunction: () => Promise<unknown>, options?: ExpectErrorOptions$2<ErrorCode>): Promise<CodeError>;
+}
+//#endregion
+//#region src/v6/DataError.d.ts
+type DefaultDataErrorCode = "INVALID_DATA";
+interface ExpectErrorOptions$1<ErrorCode extends string = DefaultDataErrorCode> {
+  expectedCode?: ErrorCode | DefaultDataErrorCode;
+}
+declare const DataErrorCode: {
+  readonly INVALID_DATA: "INVALID_DATA";
+};
+type DataErrorCode = CreateEnumType<typeof DataErrorCode>;
+/**
+ * Represents errors you may get that may've been caused by a specific piece of data.
+ *
+ * @category Types
+ *
+ * @template DataType - The type of the data that caused the error.
+ */
+declare class DataError$1<DataType extends object = Record<PropertyKey, unknown>, ErrorCode extends string = DataErrorCode> extends CodeError<ErrorCode | DataErrorCode> {
+  data: DataType;
+  /**
+   * @param data - The data that caused the error.
+   * @param code - A standardised code (e.g. UNEXPECTED_DATA).
+   * @param message  - A human-readable error message (e.g. The data provided is invalid).
+   * @param options - Extra options to pass to super Error constructor.
+   */
+  constructor(data: DataType, code?: ErrorCode | DefaultDataErrorCode, message?: string, options?: ErrorOptions);
+  /**
+   * Checks whether the given input may have been caused by a DataError.
+   *
+   * @param input - The input to check.
+   *
+   * @returns `true` if the input is a DataError, and `false` otherwise. The type of the input will also be narrowed down to DataError if `true`.
+   */
+  static check<DataType extends object = Record<PropertyKey, unknown>, ErrorCode extends string = DataErrorCode>(input: unknown): input is DataError$1<DataType, ErrorCode>;
+  /**
+   * Gets the thrown `DataError` from a given function if one was thrown, and re-throws any other errors, or throws a default `DataError` if no error thrown.
+   *
+   * @param errorFunction - The function expected to throw the error.
+   * @param options - Extra options to apply.
+   *
+   * @throws {Error} Any other errors thrown by the `errorFunction` that are not a `DataError`.
+   * @throws {Error} If no `DataError` was thrown by the `errorFunction`
+   *
+   * @returns The `DataError` that was thrown by the `errorFunction`
+   */
+  static expectError<DataType extends Record<PropertyKey, unknown>, ErrorCode extends string = DefaultDataErrorCode>(errorFunction: () => unknown, options?: ExpectErrorOptions$1<ErrorCode>): DataError$1<DataType, ErrorCode>;
+  /**
+   * Gets the thrown `DataError` from a given asynchronous function if one was thrown, and re-throws any other errors, or throws a default `DataError` if no error thrown.
+   *
+   * @param errorFunction - The function expected to throw the error.
+   * @param options - Extra options to apply.
+   *
+   * @throws {Error} Any other errors thrown by the `errorFunction` that are not a `DataError`.
+   * @throws {Error} If no `DataError` was thrown by the `errorFunction`
+   *
+   * @returns The `DataError` that was thrown by the `errorFunction`
+   */
+  static expectErrorAsync<DataType extends Record<PropertyKey, unknown>, ErrorCode extends string = DefaultDataErrorCode>(errorFunction: () => Promise<unknown>, options?: ExpectErrorOptions$1<ErrorCode>): Promise<DataError$1<DataType, ErrorCode>>;
+}
+//#endregion
 //#region src/root/functions/parsers/zod/parseZodSchema.d.ts
 /**
  * An alternative function to zodSchema.parse() that can be used to strictly parse Zod schemas.
@@ -809,11 +866,11 @@ declare function parseVersionType(input: unknown): VersionType;
  * @param input - The data to parse.
  * @param onError - A custom error to throw on invalid data (defaults to `DataError`). May either be the error itself, or a function that returns the error or nothing. If nothing is returned, the default error is thrown instead.
  *
- * @throws {DataError} If the given data cannot be parsed according to the schema.
+ * @throws {DataErrorCode} If the given data cannot be parsed according to the schema.
  *
  * @returns The parsed data from the Zod schema.
  */
-declare function parseZodSchema<SchemaType extends ZodType, ErrorType extends Error = DataError>(schema: SchemaType, input: unknown, onError?: ErrorType | ((zodError: ZodError) => ErrorType | void)): z.infer<SchemaType>;
+declare function parseZodSchema<SchemaType extends ZodType, ErrorType extends Error = DataError$1>(schema: SchemaType, input: unknown, onError?: ErrorType | ((zodError: ZodError) => ErrorType | void)): z.infer<SchemaType>;
 //#endregion
 //#region src/root/functions/parsers/zod/parseZodSchemaAsync.d.ts
 /**
@@ -832,7 +889,7 @@ declare function parseZodSchema<SchemaType extends ZodType, ErrorType extends Er
  *
  * @returns The parsed data from the Zod schema.
  */
-declare function parseZodSchemaAsync<SchemaType extends ZodType, ErrorType extends Error = DataError>(schema: SchemaType, input: unknown, onError?: ErrorType | ((zodError: ZodError) => ErrorType | void)): Promise<z.infer<SchemaType>>;
+declare function parseZodSchemaAsync<SchemaType extends ZodType, ErrorType extends Error = DataError$1>(schema: SchemaType, input: unknown, onError?: ErrorType | ((zodError: ZodError) => ErrorType | void)): Promise<z.infer<SchemaType>>;
 //#endregion
 //#region src/root/functions/recursive/deepCopy.d.ts
 /**
@@ -1139,6 +1196,64 @@ declare function normaliseIndents(strings: TemplateStringsArray, ...interpolatio
  */
 declare const normalizeIndents: typeof normaliseIndents;
 //#endregion
+//#region src/root/deprecated/DataError.d.ts
+interface ExpectErrorOptions {
+  expectedCode?: string;
+}
+/**
+ * Represents errors you may get that may've been caused by a specific piece of data.
+ *
+ * @category Types
+ *
+ * @deprecated Please use `DataError` from `@alextheman/utility/v6` instead.
+ *
+ * @template DataType - The type of the data that caused the error.
+ */
+declare class DataError<DataType extends Record<PropertyKey, unknown> = Record<PropertyKey, unknown>> extends Error {
+  code: string;
+  data: DataType;
+  /**
+   * @param data - The data that caused the error.
+   * @param code - A standardised code (e.g. UNEXPECTED_DATA).
+   * @param message  - A human-readable error message (e.g. The data provided is invalid).
+   * @param options - Extra options to pass to super Error constructor.
+   */
+  constructor(data: DataType, code?: string, message?: string, options?: ErrorOptions);
+  private static checkCaughtError;
+  /**
+   * Checks whether the given input may have been caused by a DataError.
+   *
+   * @param input - The input to check.
+   *
+   * @returns `true` if the input is a DataError, and `false` otherwise. The type of the input will also be narrowed down to DataError if `true`.
+   */
+  static check<DataType extends Record<PropertyKey, unknown> = Record<PropertyKey, unknown>>(input: unknown): input is DataError<DataType>;
+  /**
+   * Gets the thrown `DataError` from a given function if one was thrown, and re-throws any other errors, or throws a default `DataError` if no error thrown.
+   *
+   * @param errorFunction - The function expected to throw the error.
+   * @param options - Extra options to apply.
+   *
+   * @throws {Error} Any other errors thrown by the `errorFunction` that are not a `DataError`.
+   * @throws {Error} If no `DataError` was thrown by the `errorFunction`
+   *
+   * @returns The `DataError` that was thrown by the `errorFunction`
+   */
+  static expectError(errorFunction: () => unknown, options?: ExpectErrorOptions): DataError;
+  /**
+   * Gets the thrown `DataError` from a given asynchronous function if one was thrown, and re-throws any other errors, or throws a default `DataError` if no error thrown.
+   *
+   * @param errorFunction - The function expected to throw the error.
+   * @param options - Extra options to apply.
+   *
+   * @throws {Error} Any other errors thrown by the `errorFunction` that are not a `DataError`.
+   * @throws {Error} If no `DataError` was thrown by the `errorFunction`
+   *
+   * @returns The `DataError` that was thrown by the `errorFunction`
+   */
+  static expectErrorAsync(errorFunction: () => Promise<unknown>, options?: ExpectErrorOptions): Promise<DataError>;
+}
+//#endregion
 //#region src/root/deprecated/RecordKey.d.ts
 /**
  * Represents the native Record's possible key type.

package/dist/index.d.ts

@@ -461,62 +461,6 @@ declare class APIError extends Error {
   static check(input: unknown): input is APIError;
 }
 //#endregion
-//#region src/root/types/DataError.d.ts
-interface ExpectErrorOptions {
-  expectedCode?: string;
-}
-/**
- * Represents errors you may get that may've been caused by a specific piece of data.
- *
- * @category Types
- *
- * @template DataType - The type of the data that caused the error.
- */
-declare class DataError<DataType extends Record<PropertyKey, unknown> = Record<PropertyKey, unknown>> extends Error {
-  code: string;
-  data: DataType;
-  /**
-   * @param data - The data that caused the error.
-   * @param code - A standardised code (e.g. UNEXPECTED_DATA).
-   * @param message  - A human-readable error message (e.g. The data provided is invalid).
-   * @param options - Extra options to pass to super Error constructor.
-   */
-  constructor(data: DataType, code?: string, message?: string, options?: ErrorOptions);
-  private static checkCaughtError;
-  /**
-   * Checks whether the given input may have been caused by a DataError.
-   *
-   * @param input - The input to check.
-   *
-   * @returns `true` if the input is a DataError, and `false` otherwise. The type of the input will also be narrowed down to DataError if `true`.
-   */
-  static check<DataType extends Record<PropertyKey, unknown> = Record<PropertyKey, unknown>>(input: unknown): input is DataError<DataType>;
-  /**
-   * Gets the thrown `DataError` from a given function if one was thrown, and re-throws any other errors, or throws a default `DataError` if no error thrown.
-   *
-   * @param errorFunction - The function expected to throw the error.
-   * @param options - Extra options to apply.
-   *
-   * @throws {Error} Any other errors thrown by the `errorFunction` that are not a `DataError`.
-   * @throws {Error} If no `DataError` was thrown by the `errorFunction`
-   *
-   * @returns The `DataError` that was thrown by the `errorFunction`
-   */
-  static expectError(errorFunction: () => unknown, options?: ExpectErrorOptions): DataError;
-  /**
-   * Gets the thrown `DataError` from a given asynchronous function if one was thrown, and re-throws any other errors, or throws a default `DataError` if no error thrown.
-   *
-   * @param errorFunction - The function expected to throw the error.
-   * @param options - Extra options to apply.
-   *
-   * @throws {Error} Any other errors thrown by the `errorFunction` that are not a `DataError`.
-   * @throws {Error} If no `DataError` was thrown by the `errorFunction`
-   *
-   * @returns The `DataError` that was thrown by the `errorFunction`
-   */
-  static expectErrorAsync(errorFunction: () => Promise<unknown>, options?: ExpectErrorOptions): Promise<DataError>;
-}
-//#endregion
 //#region src/root/types/VersionNumber.d.ts
 /**
  * Options to apply to the stringification of the version number.
@@ -794,6 +738,119 @@ type VersionType = CreateEnumType<typeof VersionType>;
  */
 declare function parseVersionType(input: unknown): VersionType;
 //#endregion
+//#region src/v6/CodeError.d.ts
+interface ExpectErrorOptions$2<ErrorCode extends string = string> {
+  expectedCode?: ErrorCode;
+}
+/**
+ * Represents errors that can be described using a standardised error code, and a human-readable error message.
+ *
+ * @category Types
+ *
+ * @template ErrorCode The type of the standardised error code.
+ */
+declare class CodeError<ErrorCode extends string = string> extends Error {
+  code: ErrorCode;
+  /**
+   * @param code - A standardised code (e.g. UNEXPECTED_DATA).
+   * @param message  - A human-readable error message (e.g. The data provided is invalid).
+   * @param options - Extra options to pass to super Error constructor.
+   */
+  constructor(code: ErrorCode, message?: string, options?: ErrorOptions);
+  /**
+   * Checks whether the given input may have been caused by a CodeError.
+   *
+   * @param input - The input to check.
+   *
+   * @returns `true` if the input is a CodeError, and `false` otherwise. The type of the input will also be narrowed down to CodeError if `true`.
+   */
+  static check(input: unknown): input is CodeError<string>;
+  protected static checkCaughtError<ErrorCode extends string = string>(this: typeof CodeError, error: unknown, options?: ExpectErrorOptions$2<ErrorCode>): CodeError;
+  /**
+   * Gets the thrown `CodeError` from a given function if one was thrown, and re-throws any other errors, or throws a default `CodeError` if no error thrown.
+   *
+   * @param errorFunction - The function expected to throw the error.
+   * @param options - Extra options to apply.
+   *
+   * @throws {Error} Any other errors thrown by the `errorFunction` that are not a `CodeError`.
+   * @throws {Error} If no `CodeError` was thrown by the `errorFunction`
+   *
+   * @returns The `CodeError` that was thrown by the `errorFunction`
+   */
+  static expectError<ErrorCode extends string = string>(this: typeof CodeError, errorFunction: () => unknown, options?: ExpectErrorOptions$2<ErrorCode>): CodeError;
+  /**
+   * Gets the thrown `CodeError` from a given asynchronous function if one was thrown, and re-throws any other errors, or throws a default `CodeError` if no error thrown.
+   *
+   * @param errorFunction - The function expected to throw the error.
+   * @param options - Extra options to apply.
+   *
+   * @throws {Error} Any other errors thrown by the `errorFunction` that are not a `CodeError`.
+   * @throws {Error} If no `CodeError` was thrown by the `errorFunction`
+   *
+   * @returns The `CodeError` that was thrown by the `errorFunction`
+   */
+  static expectErrorAsync<ErrorCode extends string = string>(this: typeof CodeError, errorFunction: () => Promise<unknown>, options?: ExpectErrorOptions$2<ErrorCode>): Promise<CodeError>;
+}
+//#endregion
+//#region src/v6/DataError.d.ts
+type DefaultDataErrorCode = "INVALID_DATA";
+interface ExpectErrorOptions$1<ErrorCode extends string = DefaultDataErrorCode> {
+  expectedCode?: ErrorCode | DefaultDataErrorCode;
+}
+declare const DataErrorCode: {
+  readonly INVALID_DATA: "INVALID_DATA";
+};
+type DataErrorCode = CreateEnumType<typeof DataErrorCode>;
+/**
+ * Represents errors you may get that may've been caused by a specific piece of data.
+ *
+ * @category Types
+ *
+ * @template DataType - The type of the data that caused the error.
+ */
+declare class DataError$1<DataType extends object = Record<PropertyKey, unknown>, ErrorCode extends string = DataErrorCode> extends CodeError<ErrorCode | DataErrorCode> {
+  data: DataType;
+  /**
+   * @param data - The data that caused the error.
+   * @param code - A standardised code (e.g. UNEXPECTED_DATA).
+   * @param message  - A human-readable error message (e.g. The data provided is invalid).
+   * @param options - Extra options to pass to super Error constructor.
+   */
+  constructor(data: DataType, code?: ErrorCode | DefaultDataErrorCode, message?: string, options?: ErrorOptions);
+  /**
+   * Checks whether the given input may have been caused by a DataError.
+   *
+   * @param input - The input to check.
+   *
+   * @returns `true` if the input is a DataError, and `false` otherwise. The type of the input will also be narrowed down to DataError if `true`.
+   */
+  static check<DataType extends object = Record<PropertyKey, unknown>, ErrorCode extends string = DataErrorCode>(input: unknown): input is DataError$1<DataType, ErrorCode>;
+  /**
+   * Gets the thrown `DataError` from a given function if one was thrown, and re-throws any other errors, or throws a default `DataError` if no error thrown.
+   *
+   * @param errorFunction - The function expected to throw the error.
+   * @param options - Extra options to apply.
+   *
+   * @throws {Error} Any other errors thrown by the `errorFunction` that are not a `DataError`.
+   * @throws {Error} If no `DataError` was thrown by the `errorFunction`
+   *
+   * @returns The `DataError` that was thrown by the `errorFunction`
+   */
+  static expectError<DataType extends Record<PropertyKey, unknown>, ErrorCode extends string = DefaultDataErrorCode>(errorFunction: () => unknown, options?: ExpectErrorOptions$1<ErrorCode>): DataError$1<DataType, ErrorCode>;
+  /**
+   * Gets the thrown `DataError` from a given asynchronous function if one was thrown, and re-throws any other errors, or throws a default `DataError` if no error thrown.
+   *
+   * @param errorFunction - The function expected to throw the error.
+   * @param options - Extra options to apply.
+   *
+   * @throws {Error} Any other errors thrown by the `errorFunction` that are not a `DataError`.
+   * @throws {Error} If no `DataError` was thrown by the `errorFunction`
+   *
+   * @returns The `DataError` that was thrown by the `errorFunction`
+   */
+  static expectErrorAsync<DataType extends Record<PropertyKey, unknown>, ErrorCode extends string = DefaultDataErrorCode>(errorFunction: () => Promise<unknown>, options?: ExpectErrorOptions$1<ErrorCode>): Promise<DataError$1<DataType, ErrorCode>>;
+}
+//#endregion
 //#region src/root/functions/parsers/zod/parseZodSchema.d.ts
 /**
  * An alternative function to zodSchema.parse() that can be used to strictly parse Zod schemas.
@@ -809,11 +866,11 @@ declare function parseVersionType(input: unknown): VersionType;
  * @param input - The data to parse.
  * @param onError - A custom error to throw on invalid data (defaults to `DataError`). May either be the error itself, or a function that returns the error or nothing. If nothing is returned, the default error is thrown instead.
  *
- * @throws {DataError} If the given data cannot be parsed according to the schema.
+ * @throws {DataErrorCode} If the given data cannot be parsed according to the schema.
  *
  * @returns The parsed data from the Zod schema.
  */
-declare function parseZodSchema<SchemaType extends ZodType, ErrorType extends Error = DataError>(schema: SchemaType, input: unknown, onError?: ErrorType | ((zodError: ZodError) => ErrorType | void)): z.infer<SchemaType>;
+declare function parseZodSchema<SchemaType extends ZodType, ErrorType extends Error = DataError$1>(schema: SchemaType, input: unknown, onError?: ErrorType | ((zodError: ZodError) => ErrorType | void)): z.infer<SchemaType>;
 //#endregion
 //#region src/root/functions/parsers/zod/parseZodSchemaAsync.d.ts
 /**
@@ -832,7 +889,7 @@ declare function parseZodSchema<SchemaType extends ZodType, ErrorType extends Er
  *
  * @returns The parsed data from the Zod schema.
  */
-declare function parseZodSchemaAsync<SchemaType extends ZodType, ErrorType extends Error = DataError>(schema: SchemaType, input: unknown, onError?: ErrorType | ((zodError: ZodError) => ErrorType | void)): Promise<z.infer<SchemaType>>;
+declare function parseZodSchemaAsync<SchemaType extends ZodType, ErrorType extends Error = DataError$1>(schema: SchemaType, input: unknown, onError?: ErrorType | ((zodError: ZodError) => ErrorType | void)): Promise<z.infer<SchemaType>>;
 //#endregion
 //#region src/root/functions/recursive/deepCopy.d.ts
 /**
@@ -1139,6 +1196,64 @@ declare function normaliseIndents(strings: TemplateStringsArray, ...interpolatio
  */
 declare const normalizeIndents: typeof normaliseIndents;
 //#endregion
+//#region src/root/deprecated/DataError.d.ts
+interface ExpectErrorOptions {
+  expectedCode?: string;
+}
+/**
+ * Represents errors you may get that may've been caused by a specific piece of data.
+ *
+ * @category Types
+ *
+ * @deprecated Please use `DataError` from `@alextheman/utility/v6` instead.
+ *
+ * @template DataType - The type of the data that caused the error.
+ */
+declare class DataError<DataType extends Record<PropertyKey, unknown> = Record<PropertyKey, unknown>> extends Error {
+  code: string;
+  data: DataType;
+  /**
+   * @param data - The data that caused the error.
+   * @param code - A standardised code (e.g. UNEXPECTED_DATA).
+   * @param message  - A human-readable error message (e.g. The data provided is invalid).
+   * @param options - Extra options to pass to super Error constructor.
+   */
+  constructor(data: DataType, code?: string, message?: string, options?: ErrorOptions);
+  private static checkCaughtError;
+  /**
+   * Checks whether the given input may have been caused by a DataError.
+   *
+   * @param input - The input to check.
+   *
+   * @returns `true` if the input is a DataError, and `false` otherwise. The type of the input will also be narrowed down to DataError if `true`.
+   */
+  static check<DataType extends Record<PropertyKey, unknown> = Record<PropertyKey, unknown>>(input: unknown): input is DataError<DataType>;
+  /**
+   * Gets the thrown `DataError` from a given function if one was thrown, and re-throws any other errors, or throws a default `DataError` if no error thrown.
+   *
+   * @param errorFunction - The function expected to throw the error.
+   * @param options - Extra options to apply.
+   *
+   * @throws {Error} Any other errors thrown by the `errorFunction` that are not a `DataError`.
+   * @throws {Error} If no `DataError` was thrown by the `errorFunction`
+   *
+   * @returns The `DataError` that was thrown by the `errorFunction`
+   */
+  static expectError(errorFunction: () => unknown, options?: ExpectErrorOptions): DataError;
+  /**
+   * Gets the thrown `DataError` from a given asynchronous function if one was thrown, and re-throws any other errors, or throws a default `DataError` if no error thrown.
+   *
+   * @param errorFunction - The function expected to throw the error.
+   * @param options - Extra options to apply.
+   *
+   * @throws {Error} Any other errors thrown by the `errorFunction` that are not a `DataError`.
+   * @throws {Error} If no `DataError` was thrown by the `errorFunction`
+   *
+   * @returns The `DataError` that was thrown by the `errorFunction`
+   */
+  static expectErrorAsync(errorFunction: () => Promise<unknown>, options?: ExpectErrorOptions): Promise<DataError>;
+}
+//#endregion
 //#region src/root/deprecated/RecordKey.d.ts
 /**
  * Represents the native Record's possible key type.