@alextheman/utility 5.12.0 → 5.13.1

package/dist/index.d.cts

@@ -16,6 +16,74 @@ declare const UUID_REGEX: RegExp;
 declare const VERSION_NUMBER_PATTERN: string;
 declare const VERSION_NUMBER_REGEX: RegExp;
 //#endregion
+//#region src/root/deprecated/DataError.d.ts
+interface ExpectErrorOptions$2 {
+  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$2): 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$2): Promise<DataError>;
+}
+//#endregion
+//#region src/root/deprecated/RecordKey.d.ts
+/**
+ * Represents the native Record's possible key type.
+ *
+ * @category Types
+ *
+ * @deprecated Please use the native `PropertyKey` type instead.
+ */
+type RecordKey = string | number | symbol;
+//#endregion
 //#region src/root/functions/arrayHelpers/fillArray.d.ts
 /**
  * Creates a new array where each element is the resolved result of the provided asynchronous callback.
@@ -461,62 +529,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 +806,119 @@ type VersionType = CreateEnumType<typeof VersionType>;
  */
 declare function parseVersionType(input: unknown): VersionType;
 //#endregion
+//#region src/v6/CodeError.d.ts
+interface ExpectErrorOptions$1<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$1<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$1<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$1<ErrorCode>): Promise<CodeError>;
+}
+//#endregion
+//#region src/v6/DataError.d.ts
+type DefaultDataErrorCode = "INVALID_DATA";
+interface ExpectErrorOptions<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<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<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 +934,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 +957,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,14 +1264,4 @@ declare function normaliseIndents(strings: TemplateStringsArray, ...interpolatio
  */
 declare const normalizeIndents: typeof normaliseIndents;
 //#endregion
-//#region src/root/deprecated/RecordKey.d.ts
-/**
- * Represents the native Record's possible key type.
- *
- * @category Types
- *
- * @deprecated Please use the native `PropertyKey` type instead.
- */
-type RecordKey = string | number | symbol;
-//#endregion
 export { APIError, type ArrayElement, type CallReturnType, CamelToKebabOptions, type CreateEnumType, type CreateFormDataOptions, type CreateFormDataOptionsNullableResolution, type CreateFormDataOptionsUndefinedOrNullResolution, DataError, type DisallowUndefined, Env, FILE_PATH_PATTERN, FILE_PATH_REGEX, type FormDataArrayResolutionStrategy, type FormDataNullableResolutionStrategy, type HTTPErrorCode, type IgnoreCase, type IsTypeArgumentString, KebabToCamelOptions, type NonUndefined, NormaliseIndentsFunction, NormaliseIndentsOptions, NormalizeIndentsFunction, NormalizeIndentsOptions, type NullableOnCondition, ONE_DAY_IN_MILLISECONDS, type OptionalOnCondition, ParallelTuple, RecordKey, RemoveUndefined, type StringListToArrayOptions, ToTitleCaseOptions, UUID_PATTERN, UUID_REGEX, VERSION_NUMBER_PATTERN, VERSION_NUMBER_REGEX, VersionNumber, type FormatOptionsBase as VersionNumberToStringOptions, VersionType, addDaysToDate, appendSemicolon, calculateMonthlyDifference, camelToKebab, convertFileToBase64, createFormData, createTemplateStringsArray, deepCopy, deepFreeze, escapeRegexPattern, fillArray, formatDateAndTime, getRandomNumber, getRecordKeys, getStringsAndInterpolations, httpErrorCodeLookup, interpolate, interpolateObjects, isAnniversary, isLeapYear, isMonthlyMultiple, isOrdered, isSameDate, isTemplateStringsArray, kebabToCamel, normaliseIndents, normalizeIndents, omitProperties, paralleliseArrays, parseBoolean, parseEnv, parseFormData, parseIntStrict, parseUUID, parseVersionType, parseZodSchema, parseZodSchemaAsync, randomiseArray, range, removeDuplicates, removeUndefinedFromObject, sayHello, stringListToArray, stringifyDotenv, toTitleCase, truncate, wait, zodVersionNumber };

package/dist/index.d.ts

@@ -16,6 +16,74 @@ declare const UUID_REGEX: RegExp;
 declare const VERSION_NUMBER_PATTERN: string;
 declare const VERSION_NUMBER_REGEX: RegExp;
 //#endregion
+//#region src/root/deprecated/DataError.d.ts
+interface ExpectErrorOptions$2 {
+  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$2): 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$2): Promise<DataError>;
+}
+//#endregion
+//#region src/root/deprecated/RecordKey.d.ts
+/**
+ * Represents the native Record's possible key type.
+ *
+ * @category Types
+ *
+ * @deprecated Please use the native `PropertyKey` type instead.
+ */
+type RecordKey = string | number | symbol;
+//#endregion
 //#region src/root/functions/arrayHelpers/fillArray.d.ts
 /**
  * Creates a new array where each element is the resolved result of the provided asynchronous callback.
@@ -461,62 +529,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 +806,119 @@ type VersionType = CreateEnumType<typeof VersionType>;
  */
 declare function parseVersionType(input: unknown): VersionType;
 //#endregion
+//#region src/v6/CodeError.d.ts
+interface ExpectErrorOptions$1<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$1<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$1<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$1<ErrorCode>): Promise<CodeError>;
+}
+//#endregion
+//#region src/v6/DataError.d.ts
+type DefaultDataErrorCode = "INVALID_DATA";
+interface ExpectErrorOptions<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<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<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 +934,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 +957,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,14 +1264,4 @@ declare function normaliseIndents(strings: TemplateStringsArray, ...interpolatio
  */
 declare const normalizeIndents: typeof normaliseIndents;
 //#endregion
-//#region src/root/deprecated/RecordKey.d.ts
-/**
- * Represents the native Record's possible key type.
- *
- * @category Types
- *
- * @deprecated Please use the native `PropertyKey` type instead.
- */
-type RecordKey = string | number | symbol;
-//#endregion
 export { APIError, type ArrayElement, type CallReturnType, CamelToKebabOptions, type CreateEnumType, type CreateFormDataOptions, type CreateFormDataOptionsNullableResolution, type CreateFormDataOptionsUndefinedOrNullResolution, DataError, type DisallowUndefined, Env, FILE_PATH_PATTERN, FILE_PATH_REGEX, type FormDataArrayResolutionStrategy, type FormDataNullableResolutionStrategy, type HTTPErrorCode, type IgnoreCase, type IsTypeArgumentString, KebabToCamelOptions, type NonUndefined, NormaliseIndentsFunction, NormaliseIndentsOptions, NormalizeIndentsFunction, NormalizeIndentsOptions, type NullableOnCondition, ONE_DAY_IN_MILLISECONDS, type OptionalOnCondition, ParallelTuple, RecordKey, RemoveUndefined, type StringListToArrayOptions, ToTitleCaseOptions, UUID_PATTERN, UUID_REGEX, VERSION_NUMBER_PATTERN, VERSION_NUMBER_REGEX, VersionNumber, type FormatOptionsBase as VersionNumberToStringOptions, VersionType, addDaysToDate, appendSemicolon, calculateMonthlyDifference, camelToKebab, convertFileToBase64, createFormData, createTemplateStringsArray, deepCopy, deepFreeze, escapeRegexPattern, fillArray, formatDateAndTime, getRandomNumber, getRecordKeys, getStringsAndInterpolations, httpErrorCodeLookup, interpolate, interpolateObjects, isAnniversary, isLeapYear, isMonthlyMultiple, isOrdered, isSameDate, isTemplateStringsArray, kebabToCamel, normaliseIndents, normalizeIndents, omitProperties, paralleliseArrays, parseBoolean, parseEnv, parseFormData, parseIntStrict, parseUUID, parseVersionType, parseZodSchema, parseZodSchemaAsync, randomiseArray, range, removeDuplicates, removeUndefinedFromObject, sayHello, stringListToArray, stringifyDotenv, toTitleCase, truncate, wait, zodVersionNumber };