@alextheman/utility 3.10.0 → 4.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License Copyright (c) 2025 AlexMan123456
+
+Permission is hereby granted, free
+of charge, to any person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use, copy, modify, merge,
+publish, distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice
+(including the next paragraph) shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
+ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/dist/index.cjs

@@ -88,27 +88,108 @@ function paralleliseArrays(firstArray, secondArray) {
 }
 var paralleliseArrays_default = paralleliseArrays;
 
+//#endregion
+//#region src/types/APIError.ts
+const httpErrorCodeLookup = {
+	400: "BAD_REQUEST",
+	401: "UNAUTHORISED",
+	403: "FORBIDDEN",
+	404: "NOT_FOUND",
+	418: "I_AM_A_TEAPOT",
+	500: "INTERNAL_SERVER_ERROR"
+};
+/** Represents common errors you may get from a HTTP API request. */
+var APIError = class extends Error {
+	status;
+	/**
+	* @param status - A HTTP status code. Can be any number, but numbers between 400 and 600 are encouraged to fit with HTTP status code conventions.
+	* @param message - An error message to display alongside the status code.
+	* @param options - Extra options to be passed to super Error constructor.
+	*/
+	constructor(status = 500, message, options) {
+		super(message, options);
+		this.status = status;
+		if (message) this.message = message;
+		else this.message = httpErrorCodeLookup[this.status] ?? "API_ERROR";
+		Object.defineProperty(this, "message", { enumerable: true });
+		Object.setPrototypeOf(this, new.target.prototype);
+	}
+	/**
+	* Checks whether the given input may have been caused by an APIError.
+	*
+	* @param input - The input to check.
+	*
+	* @returns `true` if the input is an APIError, and `false` otherwise. The type of the input will also be narrowed down to APIError if `true`.
+	*/
+	static check(input) {
+		const data = input;
+		return typeof data === "object" && data !== null && typeof data?.status === "number" && typeof data?.message === "string";
+	}
+};
+var APIError_default = APIError;
+
+//#endregion
+//#region src/types/DataError.ts
+/** Represents errors you may get that may've been caused by a specific piece of data. */
+var DataError = class extends Error {
+	data;
+	code;
+	/**
+	* @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, code = "INVALID_DATA", message = "The data provided is invalid", options) {
+		super(message, options);
+		if (Error.captureStackTrace) Error.captureStackTrace(this, new.target);
+		this.name = new.target.name;
+		this.code = code;
+		this.data = data;
+		Object.defineProperty(this, "message", { enumerable: true });
+		Object.setPrototypeOf(this, new.target.prototype);
+	}
+	/**
+	* 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(input) {
+		const data = input;
+		return typeof data === "object" && data !== null && typeof data.message === "string" && typeof data.code === "string" && "data" in data;
+	}
+};
+var DataError_default = DataError;
+
 //#endregion
 //#region src/functions/parsers/parseIntStrict.ts
-const IntegerParsingError = /* @__PURE__ */ new TypeError("INTEGER_PARSING_ERROR");
 /**
 * Converts a string to an integer and throws an error if it cannot be converted.
 *
 * @param string - A string to convert into a number.
 * @param radix - A value between 2 and 36 that specifies the base of the number in string. If this argument is not supplied, strings with a prefix of '0x' are considered hexadecimal. All other strings are considered decimal.
 *
-* @throws {TypeError} If the provided string cannot safely be converted to an integer.
+* @throws {DataError} If the provided string cannot safely be converted to an integer.
 *
 * @returns The integer parsed from the input string.
 */
 function parseIntStrict(string, radix) {
 	const trimmedString = string.trim();
-	if (!(radix && radix > 10 && radix <= 36 ? new RegExp(`^[+-]?[0-9a-${String.fromCharCode(87 + radix - 1)}]+$`, "i") : /^[+-]?\d+$/).test(trimmedString)) throw IntegerParsingError;
+	const maxAllowedAlphabeticalCharacter = radix && radix > 10 && radix <= 36 ? String.fromCharCode(87 + radix - 1) : void 0;
+	if (!(radix && radix > 10 && radix <= 36 ? new RegExp(`^[+-]?[0-9a-${maxAllowedAlphabeticalCharacter}]+$`, "i") : /^[+-]?\d+$/).test(trimmedString)) throw new DataError_default(radix ? {
+		string,
+		radix
+	} : string, "INTEGER_PARSING_ERROR", `Only numeric values${radix && radix > 10 && radix <= 36 ? ` or character${radix !== 11 ? "s" : ""} A${radix !== 11 ? `-${maxAllowedAlphabeticalCharacter?.toUpperCase()} ` : " "}` : " "}are allowed.`);
 	if (radix && radix < 10 && [...trimmedString].some((character) => {
 		return parseInt(character) >= radix;
-	})) throw IntegerParsingError;
+	})) throw new DataError_default({
+		string,
+		radix
+	}, "INTEGER_PARSING_ERROR", "Value contains one or more digits outside of the range of the given radix.");
 	const parseIntResult = parseInt(trimmedString, radix);
-	if (isNaN(parseIntResult)) throw IntegerParsingError;
+	if (isNaN(parseIntResult)) throw new DataError_default(string, "INTEGER_PARSING_ERROR", "Value is not a valid integer.");
 	return parseIntResult;
 }
 var parseIntStrict_default = parseIntStrict;
@@ -539,19 +620,42 @@ var omitProperties_default = omitProperties;
 *
 * @param inputString - The string to parse.
 *
-* @throws {TypeError} If the string is not either `true` or `false` (case insensitive).
+* @throws {DataError} If the string is not either `true` or `false` (case insensitive).
 *
 * @returns The string parsed as an actual boolean.
 */
 function parseBoolean(inputString) {
 	const normalisedString = inputString.toLowerCase();
-	if (!["true", "false"].includes(normalisedString)) throw new TypeError("INVALID_BOOLEAN_STRING");
+	if (!["true", "false"].includes(normalisedString)) throw new DataError_default(inputString, "INVALID_BOOLEAN_STRING", "The provided boolean string must be one of `true | false`");
 	return normalisedString === "true";
 }
-/** @deprecated This function has been renamed to parseBoolean. */
-const stringToBoolean = parseBoolean;
 var parseBoolean_default = parseBoolean;
 
+//#endregion
+//#region src/functions/parsers/parseZodSchema.ts
+/**
+* An alternative function to zodSchema.parse() that can be used to strictly parse Zod schemas.
+*
+* @template Output - The Zod output type.
+* @template Input - The Zod input type.
+* @template Internals - The Zod internal types based on the output and input types.
+* @template ErrorType - The type of error to throw on invalid data.
+*
+* @param schema - The Zod schema to use in parsing.
+* @param data - The data to parse.
+* @param error - A custom error to throw on invalid data (defaults to `DataError`).
+*
+* @throws {DataError} If the given data cannot be parsed according to the schema.
+*
+* @returns The parsed data from the Zod schema.
+*/
+function parseZodSchema(schema, data, error) {
+	const parsedResult = schema.safeParse(data);
+	if (!parsedResult.success) throw error ?? new DataError_default(data);
+	return parsedResult.data;
+}
+var parseZodSchema_default = parseZodSchema;
+
 //#endregion
 //#region src/functions/parsers/parseEnv.ts
 const envSchema = zod.z.enum([
@@ -564,12 +668,12 @@ const envSchema = zod.z.enum([
 *
 * @param data - The data to parse.
 *
-* @throws {ZodError} If the data does not match one of the environments allowed by the Env types ("test" | "development" | "production").
+* @throws {DataError} If the data does not match one of the environments allowed by the Env types ("test" | "development" | "production").
 *
 * @returns The specified environment if allowed.
 */
 function parseEnv(data) {
-	return envSchema.parse(data);
+	return parseZodSchema_default(envSchema, data, new DataError_default(data, "INVALID_ENV", "The provided environment type must be one of `test | development | production`"));
 }
 var parseEnv_default = parseEnv;
 
@@ -595,122 +699,6 @@ function parseFormData(formData, dataParser) {
 }
 var parseFormData_default = parseFormData;
 
-//#endregion
-//#region src/types/APIError.ts
-const httpErrorCodeLookup = {
-	400: "BAD_REQUEST",
-	401: "UNAUTHORISED",
-	403: "FORBIDDEN",
-	404: "NOT_FOUND",
-	418: "I_AM_A_TEAPOT",
-	500: "INTERNAL_SERVER_ERROR"
-};
-/** Represents common errors you may get from a HTTP API request. */
-var APIError = class extends Error {
-	status;
-	/**
-	* @param status - A HTTP status code. Can be any number, but numbers between 400 and 600 are encouraged to fit with HTTP status code conventions.
-	* @param message - An error message to display alongside the status code.
-	* @param options - Extra options to be passed to super Error constructor.
-	*/
-	constructor(status = 500, message, options) {
-		super(message, options);
-		this.status = status;
-		if (message) this.message = message;
-		else this.message = httpErrorCodeLookup[this.status] ?? "API_ERROR";
-		Object.defineProperty(this, "message", { enumerable: true });
-		Object.setPrototypeOf(this, new.target.prototype);
-	}
-	/**
-	* Checks whether the given input may have been caused by an APIError.
-	*
-	* @param input - The input to check.
-	*
-	* @returns `true` if the input is an APIError, and `false` otherwise. The type of the input will also be narrowed down to APIError if `true`.
-	*/
-	static check(input) {
-		const data = input;
-		return typeof data === "object" && data !== null && typeof data?.status === "number" && typeof data?.message === "string";
-	}
-};
-var APIError_default = APIError;
-
-//#endregion
-//#region src/types/DataError.ts
-/** Represents errors you may get that may've been caused by a specific piece of data. */
-var DataError = class extends Error {
-	data;
-	code;
-	/**
-	* @param data - The data that caused the error.
-	* @param message  - A human-readable error message (e.g. The data provided is invalid).
-	* @param code - A standardised code (e.g. UNEXPECTED_DATA).
-	* @param options - Extra options to pass to super Error constructor.
-	*/
-	constructor(data, message = "The data provided is invalid", code = "INVALID_DATA", options) {
-		super(message, options);
-		if (Error.captureStackTrace) Error.captureStackTrace(this, new.target);
-		this.name = new.target.name;
-		this.code = code;
-		this.data = data;
-		Object.defineProperty(this, "message", { enumerable: true });
-		Object.setPrototypeOf(this, new.target.prototype);
-	}
-	/**
-	* 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(input) {
-		const data = input;
-		return typeof data === "object" && data !== null && typeof data.message === "string" && typeof data.code === "string" && "data" in data;
-	}
-};
-var DataError_default = DataError;
-
-//#endregion
-//#region src/types/Email.ts
-const emailSchema = zod.default.email().brand();
-/** @deprecated Please use `z.email().parse() from Zod instead.`*/
-function parseEmail(data) {
-	return emailSchema.parse(data);
-}
-var Email_default = parseEmail;
-
-//#endregion
-//#region src/types/UUID.ts
-const uuidSchema = zod.default.uuid().brand();
-/** @deprecated Please use `z.uuid().parse() from Zod instead.`*/
-function parseUUID(UUID) {
-	return uuidSchema.parse(UUID);
-}
-var UUID_default = parseUUID;
-
-//#endregion
-//#region src/functions/parsers/parseZodSchema.ts
-/**
-* An alternative function to zodSchema.parse() that can be used to strictly parse Zod schemas.
-*
-* @template Output - The Zod output type.
-* @template Input - The Zod input type.
-* @template Internals - The Zod internal types based on the output and input types.
-*
-* @param schema - The Zod schema to use in parsing.
-* @param data - The data to parse.
-*
-* @throws {DataError} If the given data cannot be parsed according to the schema.
-*
-* @returns The parsed data from the Zod schema.
-*/
-function parseZodSchema(schema, data) {
-	const parsedResult = schema.safeParse(data);
-	if (!parsedResult.success) throw new DataError_default(data);
-	return parsedResult.data;
-}
-var parseZodSchema_default = parseZodSchema;
-
 //#endregion
 //#region src/functions/parsers/parseVersionType.ts
 const versionTypeSchema = zod.default.enum([
@@ -728,7 +716,7 @@ const versionTypeSchema = zod.default.enum([
 * @returns The given version type if allowed.
 */
 function parseVersionType(data) {
-	return parseZodSchema_default(versionTypeSchema, data);
+	return parseZodSchema_default(versionTypeSchema, data, new DataError_default(data, "INVALID_VERSION_TYPE", "The provided version type must be one of `major | minor | patch`"));
 }
 var parseVersionType_default = parseVersionType;
 
@@ -967,25 +955,25 @@ var interpolateObjects_default = interpolateObjects;
 
 //#endregion
 //#region src/functions/taggedTemplate/normaliseIndents.ts
-function calculateTabSize$1(line, whitespaceLength) {
+function calculateTabSize(line, whitespaceLength) {
 	const potentialWhitespacePart = line.slice(0, whitespaceLength);
 	const trimmedString = line.trimStart();
 	if (potentialWhitespacePart.trim() !== "") return 0;
 	const tabSize = line.length - (trimmedString.length + whitespaceLength);
 	return tabSize < 0 ? 0 : tabSize;
 }
-function getWhitespaceLength$1(lines) {
+function getWhitespaceLength(lines) {
 	const [firstNonEmptyLine] = lines.filter((line) => {
 		return line.trim() !== "";
 	});
 	return firstNonEmptyLine.length - firstNonEmptyLine.trimStart().length;
 }
-function reduceLines$1(lines, { preserveTabs = true }) {
+function reduceLines(lines, { preserveTabs = true }) {
 	const slicedLines = lines.slice(1);
 	const isFirstLineEmpty = lines[0].trim() === "";
-	const whitespaceLength = getWhitespaceLength$1(isFirstLineEmpty ? lines : slicedLines);
+	const whitespaceLength = getWhitespaceLength(isFirstLineEmpty ? lines : slicedLines);
 	return (isFirstLineEmpty ? slicedLines : lines).map((line) => {
-		const tabSize = calculateTabSize$1(line, whitespaceLength);
+		const tabSize = calculateTabSize(line, whitespaceLength);
 		return (preserveTabs ? fillArray_default(() => {
 			return " ";
 		}, tabSize).join("") : "") + line.trimStart();
@@ -1020,7 +1008,7 @@ function normaliseIndents(first, ...args) {
 	}
 	const strings = first;
 	const options = typeof args[args.length - 1] === "object" && !Array.isArray(args[args.length - 1]) ? args.pop() : {};
-	return reduceLines$1(interpolate_default(strings, ...[...args]).split("\n"), options);
+	return reduceLines(interpolate_default(strings, ...[...args]).split("\n"), options);
 }
 /**
 * Applies any options if provided, then removes any extraneous indents from a multi-line template string.
@@ -1045,45 +1033,6 @@ function normaliseIndents(first, ...args) {
 const normalizeIndents = normaliseIndents;
 var normaliseIndents_default = normaliseIndents;
 
-//#endregion
-//#region src/functions/taggedTemplate/removeIndents.ts
-function calculateTabSize(line, whitespaceLength) {
-	const potentialWhitespacePart = line.slice(0, whitespaceLength);
-	const trimmedString = line.trimStart();
-	if (potentialWhitespacePart.trim() !== "") return 0;
-	const tabSize = line.length - (trimmedString.length + whitespaceLength);
-	return tabSize < 0 ? 0 : tabSize;
-}
-function getWhitespaceLength(lines) {
-	const [firstNonEmptyLine] = lines.filter((line) => {
-		return line.trim() !== "";
-	});
-	return firstNonEmptyLine.length - firstNonEmptyLine.trimStart().length;
-}
-function reduceLines(lines, { preserveTabs = true }) {
-	const slicedLines = lines.slice(1);
-	const isFirstLineEmpty = lines[0].trim() === "";
-	const whitespaceLength = getWhitespaceLength(isFirstLineEmpty ? lines : slicedLines);
-	return (isFirstLineEmpty ? slicedLines : lines).map((line) => {
-		const tabSize = calculateTabSize(line, whitespaceLength);
-		return (preserveTabs ? fillArray_default(() => {
-			return " ";
-		}, tabSize).join("") : "") + line.trimStart();
-	}).join("\n");
-}
-function removeIndents(first, ...args) {
-	if (typeof first === "object" && first !== null && !Array.isArray(first)) {
-		const options$1 = first;
-		return (strings$1, ...interpolations) => {
-			return removeIndents(strings$1, ...interpolations, options$1);
-		};
-	}
-	const strings = first;
-	const options = typeof args[args.length - 1] === "object" && !Array.isArray(args[args.length - 1]) ? args.pop() : {};
-	return reduceLines(interpolate_default(strings, ...[...args]).split("\n"), options);
-}
-var removeIndents_default = removeIndents;
-
 //#endregion
 //#region src/functions/versioning/parseVersion.ts
 /**
@@ -1099,7 +1048,7 @@ var removeIndents_default = removeIndents;
 * @returns The validated version number, prefixed with `v` if it was not already.
 */
 function parseVersion(input, options) {
-	if (!RegExp(VERSION_NUMBER_REGEX_default).test(input)) throw new DataError_default(input, `"${input}" is not a valid version number. Version numbers must be of the format "X.Y.Z" or "vX.Y.Z", where X, Y, and Z are non-negative integers.`, "INVALID_VERSION");
+	if (!RegExp(VERSION_NUMBER_REGEX_default).test(input)) throw new DataError_default(input, "INVALID_VERSION", `"${input}" is not a valid version number. Version numbers must be of the format "X.Y.Z" or "vX.Y.Z", where X, Y, and Z are non-negative integers.`);
 	if (options?.omitPrefix) return input.startsWith("v") ? input.slice(1) : input;
 	return input.startsWith("v") ? input : `v${input}`;
 }
@@ -1199,19 +1148,15 @@ exports.normalizeIndents = normalizeIndents;
 exports.omitProperties = omitProperties_default;
 exports.paralleliseArrays = paralleliseArrays_default;
 exports.parseBoolean = parseBoolean_default;
-exports.parseEmail = Email_default;
 exports.parseEnv = parseEnv_default;
 exports.parseFormData = parseFormData_default;
 exports.parseIntStrict = parseIntStrict_default;
-exports.parseUUID = UUID_default;
 exports.parseVersion = parseVersion_default;
 exports.parseVersionType = parseVersionType_default;
 exports.parseZodSchema = parseZodSchema_default;
 exports.randomiseArray = randomiseArray_default;
 exports.range = range_default;
 exports.removeDuplicates = removeDuplicates_default;
-exports.removeIndents = removeIndents_default;
 exports.stringListToArray = stringListToArray_default;
-exports.stringToBoolean = stringToBoolean;
 exports.truncate = truncate_default;
 exports.wait = wait_default;

package/dist/index.d.cts

@@ -20,7 +20,7 @@ declare const VERSION_NUMBER_REGEX: string;
  *
  * @returns A Promise resolving to an array of the callback results.
  */
-declare function fillArray<ItemType$1>(callback: (index: number) => Promise<ItemType$1>, length?: number): Promise<ItemType$1[]>;
+declare function fillArray<ItemType>(callback: (index: number) => Promise<ItemType>, length?: number): Promise<ItemType[]>;
 /**
  * Creates a new array where each element is the result of the provided synchronous callback.
  *
@@ -34,7 +34,7 @@ declare function fillArray<ItemType$1>(callback: (index: number) => Promise<Item
  *
  * @returns An array of the callback results.
  */
-declare function fillArray<ItemType$1>(callback: (index: number) => ItemType$1, length?: number): ItemType$1[];
+declare function fillArray<ItemType>(callback: (index: number) => ItemType, length?: number): ItemType[];
 //#endregion
 //#region src/functions/arrayHelpers/paralleliseArrays.d.ts
 type ParallelTuple<A, B> = [A, B | undefined];
@@ -64,7 +64,7 @@ declare function paralleliseArrays<FirstArrayItem, SecondArrayItem>(firstArray:
  *
  * @returns A new array with the items randomised.
  */
-declare function randomiseArray<ItemType$1>(array: ItemType$1[]): ItemType$1[];
+declare function randomiseArray<ItemType>(array: ItemType[]): ItemType[];
 //#endregion
 //#region src/functions/arrayHelpers/range.d.ts
 /**
@@ -94,7 +94,7 @@ declare function range(start: number, stop: number, step?: number): number[];
  *
  * @returns A new array with a different reference in memory, with the duplicates removed.
  */
-declare function removeDuplicates<ItemType$1>(array: ItemType$1[] | readonly ItemType$1[]): ItemType$1[];
+declare function removeDuplicates<ItemType>(array: ItemType[] | readonly ItemType[]): ItemType[];
 //#endregion
 //#region src/functions/date/addDaysToDate.d.ts
 /**
@@ -207,11 +207,11 @@ declare class DataError extends Error {
   code: string;
   /**
    * @param data - The data that caused the error.
-   * @param message  - A human-readable error message (e.g. The data provided is invalid).
    * @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: unknown, message?: string, code?: string, options?: ErrorOptions);
+  constructor(data: unknown, code?: string, message?: string, options?: ErrorOptions);
   /**
    * Checks whether the given input may have been caused by a DataError.
    *
@@ -222,20 +222,6 @@ declare class DataError extends Error {
   static check(input: unknown): input is DataError;
 }
 //#endregion
-//#region src/types/Email.d.ts
-declare const emailSchema: z.core.$ZodBranded<z.ZodEmail, "Email">;
-/** @deprecated Please use the inferred type from `z.email() from Zod instead.` */
-type Email = z.infer<typeof emailSchema>;
-/** @deprecated Please use `z.email().parse() from Zod instead.`*/
-declare function parseEmail(data: unknown): Email;
-//#endregion
-//#region src/types/UUID.d.ts
-declare const uuidSchema: z.core.$ZodBranded<z.ZodUUID, "UUID">;
-/** @deprecated Please use the inferred type from `z.uuid() from Zod instead.` */
-type UUID = z.infer<typeof uuidSchema>;
-/** @deprecated Please use `z.uuid().parse() from Zod instead.`*/
-declare function parseUUID(UUID: unknown): UUID;
-//#endregion
 //#region src/types/ArrayElement.d.ts
 /**
  * Gets the individual element types from an array type.
@@ -244,10 +230,6 @@ declare function parseUUID(UUID: unknown): UUID;
  */
 type ArrayElement<ArrayType extends readonly unknown[]> = ArrayType extends readonly (infer ElementType)[] ? ElementType : never;
 //#endregion
-//#region src/types/DeepReadonly.d.ts
-/** @deprecated This type did not work with the deepFreeze function as intended and therefore should not be used. */
-type DeepReadonly<T> = T extends ((...args: unknown[]) => unknown) ? T : T extends (infer ItemType)[] ? readonly DeepReadonly<ItemType>[] : T extends object ? { readonly [K in keyof T]: DeepReadonly<T[K]> } : T;
-//#endregion
 //#region src/types/DisallowUndefined.d.ts
 /**
  * Resolves to an error message type if the type argument could potentially be undefined.
@@ -406,13 +388,11 @@ declare function omitProperties<ObjectType extends Record<string, unknown> | Rea
  *
  * @param inputString - The string to parse.
  *
- * @throws {TypeError} If the string is not either `true` or `false` (case insensitive).
+ * @throws {DataError} If the string is not either `true` or `false` (case insensitive).
  *
  * @returns The string parsed as an actual boolean.
  */
 declare function parseBoolean(inputString: string): boolean;
-/** @deprecated This function has been renamed to parseBoolean. */
-declare const stringToBoolean: typeof parseBoolean;
 //#endregion
 //#region src/functions/parsers/parseEnv.d.ts
 declare const envSchema: z$1.ZodEnum<{
@@ -427,7 +407,7 @@ type Env = z$1.infer<typeof envSchema>;
  *
  * @param data - The data to parse.
  *
- * @throws {ZodError} If the data does not match one of the environments allowed by the Env types ("test" | "development" | "production").
+ * @throws {DataError} If the data does not match one of the environments allowed by the Env types ("test" | "development" | "production").
  *
  * @returns The specified environment if allowed.
  */
@@ -461,7 +441,7 @@ declare function parseFormData(formData: FormData): Record<string, string | Blob
  * @param string - A string to convert into a number.
  * @param radix - A value between 2 and 36 that specifies the base of the number in string. If this argument is not supplied, strings with a prefix of '0x' are considered hexadecimal. All other strings are considered decimal.
  *
- * @throws {TypeError} If the provided string cannot safely be converted to an integer.
+ * @throws {DataError} If the provided string cannot safely be converted to an integer.
  *
  * @returns The integer parsed from the input string.
  */
@@ -492,15 +472,17 @@ declare function parseVersionType(data: unknown): VersionType;
  * @template Output - The Zod output type.
  * @template Input - The Zod input type.
  * @template Internals - The Zod internal types based on the output and input types.
+ * @template ErrorType - The type of error to throw on invalid data.
  *
  * @param schema - The Zod schema to use in parsing.
  * @param data - The data to parse.
+ * @param error - A custom error to throw on invalid data (defaults to `DataError`).
  *
  * @throws {DataError} If the given data cannot be parsed according to the schema.
  *
  * @returns The parsed data from the Zod schema.
  */
-declare function parseZodSchema<Output, Input, Internals extends core.$ZodTypeInternals<Output, Input>>(schema: ZodType<Output, Input, Internals>, data: unknown): core.output<ZodType<Output, Input, Internals>>;
+declare function parseZodSchema<Output, Input, Internals extends core.$ZodTypeInternals<Output, Input>, ErrorType extends Error>(schema: ZodType<Output, Input, Internals>, data: unknown, error?: ErrorType): core.output<ZodType<Output, Input, Internals>>;
 //#endregion
 //#region src/functions/recursive/deepCopy.d.ts
 /**
@@ -702,23 +684,6 @@ declare function normaliseIndents(strings: TemplateStringsArray, ...interpolatio
  */
 declare const normalizeIndents: typeof normaliseIndents;
 //#endregion
-//#region src/functions/taggedTemplate/removeIndents.d.ts
-interface RemoveIndentsOptions {
-  preserveTabs?: boolean;
-}
-type RemoveIndentsFunction = (strings: TemplateStringsArray, ...interpolations: unknown[]) => string;
-/**
- * @param options
- * @deprecated This function has been renamed to normaliseIndents
- */
-declare function removeIndents(options: RemoveIndentsOptions): RemoveIndentsFunction;
-/**
- * @param strings
- * @param interpolations
- * @deprecated This function has been renamed to normaliseIndents
- */
-declare function removeIndents(strings: TemplateStringsArray, ...interpolations: unknown[]): string;
-//#endregion
 //#region src/functions/versioning/determineVersionType.d.ts
 /**
  * Determines whether the given version is a major, minor, or patch version.
@@ -777,4 +742,4 @@ interface ParseVersionOptions {
  */
 declare function parseVersion(input: string, options?: ParseVersionOptions): string;
 //#endregion
-export { APIError, ArrayElement, CreateFormDataOptions, CreateFormDataOptionsNullableResolution, CreateFormDataOptionsUndefinedOrNullResolution, DataError, DeepReadonly, DisallowUndefined, Email, Env, FormDataArrayResolutionStrategy, FormDataNullableResolutionStrategy, HTTPErrorCode, IgnoreCase, IncrementVersionOptions, KebabToCamelOptions, NAMESPACE_EXPORT_REGEX, NonUndefined, NormaliseIndentsFunction, NormaliseIndentsOptions, NormalizeIndentsFunction, NormalizeIndentsOptions, OptionalOnCondition, ParseVersionOptions, RecordKey, RemoveIndentsFunction, RemoveIndentsOptions, StringListToArrayOptions, UUID, VERSION_NUMBER_REGEX, VersionType, addDaysToDate, appendSemicolon, camelToKebab, convertFileToBase64, createFormData, createTemplateStringsArray, deepCopy, deepFreeze, determineVersionType, fillArray, formatDateAndTime, getIndividualVersionNumbers, getRandomNumber, getRecordKeys, httpErrorCodeLookup, incrementVersion, interpolate, interpolateObjects, isAnniversary, isLeapYear, isMonthlyMultiple, isOrdered, isSameDate, kebabToCamel, normaliseImportPath, normaliseIndents, normalizeImportPath, normalizeIndents, omitProperties, paralleliseArrays, parseBoolean, parseEmail, parseEnv, parseFormData, parseIntStrict, parseUUID, parseVersion, parseVersionType, parseZodSchema, randomiseArray, range, removeDuplicates, removeIndents, stringListToArray, stringToBoolean, truncate, wait };
+export { APIError, ArrayElement, CreateFormDataOptions, CreateFormDataOptionsNullableResolution, CreateFormDataOptionsUndefinedOrNullResolution, DataError, DisallowUndefined, Env, FormDataArrayResolutionStrategy, FormDataNullableResolutionStrategy, HTTPErrorCode, IgnoreCase, IncrementVersionOptions, KebabToCamelOptions, NAMESPACE_EXPORT_REGEX, NonUndefined, NormaliseIndentsFunction, NormaliseIndentsOptions, NormalizeIndentsFunction, NormalizeIndentsOptions, OptionalOnCondition, ParseVersionOptions, RecordKey, StringListToArrayOptions, VERSION_NUMBER_REGEX, VersionType, addDaysToDate, appendSemicolon, camelToKebab, convertFileToBase64, createFormData, createTemplateStringsArray, deepCopy, deepFreeze, determineVersionType, fillArray, formatDateAndTime, getIndividualVersionNumbers, getRandomNumber, getRecordKeys, httpErrorCodeLookup, incrementVersion, interpolate, interpolateObjects, isAnniversary, isLeapYear, isMonthlyMultiple, isOrdered, isSameDate, kebabToCamel, normaliseImportPath, normaliseIndents, normalizeImportPath, normalizeIndents, omitProperties, paralleliseArrays, parseBoolean, parseEnv, parseFormData, parseIntStrict, parseVersion, parseVersionType, parseZodSchema, randomiseArray, range, removeDuplicates, stringListToArray, truncate, wait };

package/dist/index.d.ts

@@ -20,7 +20,7 @@ declare const VERSION_NUMBER_REGEX: string;
  *
  * @returns A Promise resolving to an array of the callback results.
  */
-declare function fillArray<ItemType$1>(callback: (index: number) => Promise<ItemType$1>, length?: number): Promise<ItemType$1[]>;
+declare function fillArray<ItemType>(callback: (index: number) => Promise<ItemType>, length?: number): Promise<ItemType[]>;
 /**
  * Creates a new array where each element is the result of the provided synchronous callback.
  *
@@ -34,7 +34,7 @@ declare function fillArray<ItemType$1>(callback: (index: number) => Promise<Item
  *
  * @returns An array of the callback results.
  */
-declare function fillArray<ItemType$1>(callback: (index: number) => ItemType$1, length?: number): ItemType$1[];
+declare function fillArray<ItemType>(callback: (index: number) => ItemType, length?: number): ItemType[];
 //#endregion
 //#region src/functions/arrayHelpers/paralleliseArrays.d.ts
 type ParallelTuple<A, B> = [A, B | undefined];
@@ -64,7 +64,7 @@ declare function paralleliseArrays<FirstArrayItem, SecondArrayItem>(firstArray:
  *
  * @returns A new array with the items randomised.
  */
-declare function randomiseArray<ItemType$1>(array: ItemType$1[]): ItemType$1[];
+declare function randomiseArray<ItemType>(array: ItemType[]): ItemType[];
 //#endregion
 //#region src/functions/arrayHelpers/range.d.ts
 /**
@@ -94,7 +94,7 @@ declare function range(start: number, stop: number, step?: number): number[];
  *
  * @returns A new array with a different reference in memory, with the duplicates removed.
  */
-declare function removeDuplicates<ItemType$1>(array: ItemType$1[] | readonly ItemType$1[]): ItemType$1[];
+declare function removeDuplicates<ItemType>(array: ItemType[] | readonly ItemType[]): ItemType[];
 //#endregion
 //#region src/functions/date/addDaysToDate.d.ts
 /**
@@ -207,11 +207,11 @@ declare class DataError extends Error {
   code: string;
   /**
    * @param data - The data that caused the error.
-   * @param message  - A human-readable error message (e.g. The data provided is invalid).
    * @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: unknown, message?: string, code?: string, options?: ErrorOptions);
+  constructor(data: unknown, code?: string, message?: string, options?: ErrorOptions);
   /**
    * Checks whether the given input may have been caused by a DataError.
    *
@@ -222,20 +222,6 @@ declare class DataError extends Error {
   static check(input: unknown): input is DataError;
 }
 //#endregion
-//#region src/types/Email.d.ts
-declare const emailSchema: z.core.$ZodBranded<z.ZodEmail, "Email">;
-/** @deprecated Please use the inferred type from `z.email() from Zod instead.` */
-type Email = z.infer<typeof emailSchema>;
-/** @deprecated Please use `z.email().parse() from Zod instead.`*/
-declare function parseEmail(data: unknown): Email;
-//#endregion
-//#region src/types/UUID.d.ts
-declare const uuidSchema: z.core.$ZodBranded<z.ZodUUID, "UUID">;
-/** @deprecated Please use the inferred type from `z.uuid() from Zod instead.` */
-type UUID = z.infer<typeof uuidSchema>;
-/** @deprecated Please use `z.uuid().parse() from Zod instead.`*/
-declare function parseUUID(UUID: unknown): UUID;
-//#endregion
 //#region src/types/ArrayElement.d.ts
 /**
  * Gets the individual element types from an array type.
@@ -244,10 +230,6 @@ declare function parseUUID(UUID: unknown): UUID;
  */
 type ArrayElement<ArrayType extends readonly unknown[]> = ArrayType extends readonly (infer ElementType)[] ? ElementType : never;
 //#endregion
-//#region src/types/DeepReadonly.d.ts
-/** @deprecated This type did not work with the deepFreeze function as intended and therefore should not be used. */
-type DeepReadonly<T> = T extends ((...args: unknown[]) => unknown) ? T : T extends (infer ItemType)[] ? readonly DeepReadonly<ItemType>[] : T extends object ? { readonly [K in keyof T]: DeepReadonly<T[K]> } : T;
-//#endregion
 //#region src/types/DisallowUndefined.d.ts
 /**
  * Resolves to an error message type if the type argument could potentially be undefined.
@@ -406,13 +388,11 @@ declare function omitProperties<ObjectType extends Record<string, unknown> | Rea
  *
  * @param inputString - The string to parse.
  *
- * @throws {TypeError} If the string is not either `true` or `false` (case insensitive).
+ * @throws {DataError} If the string is not either `true` or `false` (case insensitive).
  *
  * @returns The string parsed as an actual boolean.
  */
 declare function parseBoolean(inputString: string): boolean;
-/** @deprecated This function has been renamed to parseBoolean. */
-declare const stringToBoolean: typeof parseBoolean;
 //#endregion
 //#region src/functions/parsers/parseEnv.d.ts
 declare const envSchema: z$1.ZodEnum<{
@@ -427,7 +407,7 @@ type Env = z$1.infer<typeof envSchema>;
  *
  * @param data - The data to parse.
  *
- * @throws {ZodError} If the data does not match one of the environments allowed by the Env types ("test" | "development" | "production").
+ * @throws {DataError} If the data does not match one of the environments allowed by the Env types ("test" | "development" | "production").
  *
  * @returns The specified environment if allowed.
  */
@@ -461,7 +441,7 @@ declare function parseFormData(formData: FormData): Record<string, string | Blob
  * @param string - A string to convert into a number.
  * @param radix - A value between 2 and 36 that specifies the base of the number in string. If this argument is not supplied, strings with a prefix of '0x' are considered hexadecimal. All other strings are considered decimal.
  *
- * @throws {TypeError} If the provided string cannot safely be converted to an integer.
+ * @throws {DataError} If the provided string cannot safely be converted to an integer.
  *
  * @returns The integer parsed from the input string.
  */
@@ -492,15 +472,17 @@ declare function parseVersionType(data: unknown): VersionType;
  * @template Output - The Zod output type.
  * @template Input - The Zod input type.
  * @template Internals - The Zod internal types based on the output and input types.
+ * @template ErrorType - The type of error to throw on invalid data.
  *
  * @param schema - The Zod schema to use in parsing.
  * @param data - The data to parse.
+ * @param error - A custom error to throw on invalid data (defaults to `DataError`).
  *
  * @throws {DataError} If the given data cannot be parsed according to the schema.
  *
  * @returns The parsed data from the Zod schema.
  */
-declare function parseZodSchema<Output, Input, Internals extends core.$ZodTypeInternals<Output, Input>>(schema: ZodType<Output, Input, Internals>, data: unknown): core.output<ZodType<Output, Input, Internals>>;
+declare function parseZodSchema<Output, Input, Internals extends core.$ZodTypeInternals<Output, Input>, ErrorType extends Error>(schema: ZodType<Output, Input, Internals>, data: unknown, error?: ErrorType): core.output<ZodType<Output, Input, Internals>>;
 //#endregion
 //#region src/functions/recursive/deepCopy.d.ts
 /**
@@ -702,23 +684,6 @@ declare function normaliseIndents(strings: TemplateStringsArray, ...interpolatio
  */
 declare const normalizeIndents: typeof normaliseIndents;
 //#endregion
-//#region src/functions/taggedTemplate/removeIndents.d.ts
-interface RemoveIndentsOptions {
-  preserveTabs?: boolean;
-}
-type RemoveIndentsFunction = (strings: TemplateStringsArray, ...interpolations: unknown[]) => string;
-/**
- * @param options
- * @deprecated This function has been renamed to normaliseIndents
- */
-declare function removeIndents(options: RemoveIndentsOptions): RemoveIndentsFunction;
-/**
- * @param strings
- * @param interpolations
- * @deprecated This function has been renamed to normaliseIndents
- */
-declare function removeIndents(strings: TemplateStringsArray, ...interpolations: unknown[]): string;
-//#endregion
 //#region src/functions/versioning/determineVersionType.d.ts
 /**
  * Determines whether the given version is a major, minor, or patch version.
@@ -777,4 +742,4 @@ interface ParseVersionOptions {
  */
 declare function parseVersion(input: string, options?: ParseVersionOptions): string;
 //#endregion
-export { APIError, type ArrayElement, type CreateFormDataOptions, type CreateFormDataOptionsNullableResolution, type CreateFormDataOptionsUndefinedOrNullResolution, DataError, type DeepReadonly, type DisallowUndefined, type Email, type Env, type FormDataArrayResolutionStrategy, type FormDataNullableResolutionStrategy, type HTTPErrorCode, type IgnoreCase, type IncrementVersionOptions, KebabToCamelOptions, NAMESPACE_EXPORT_REGEX, type NonUndefined, NormaliseIndentsFunction, NormaliseIndentsOptions, NormalizeIndentsFunction, NormalizeIndentsOptions, type OptionalOnCondition, type ParseVersionOptions, type RecordKey, RemoveIndentsFunction, RemoveIndentsOptions, type StringListToArrayOptions, type UUID, VERSION_NUMBER_REGEX, type VersionType, addDaysToDate, appendSemicolon, camelToKebab, convertFileToBase64, createFormData, createTemplateStringsArray, deepCopy, deepFreeze, determineVersionType, fillArray, formatDateAndTime, getIndividualVersionNumbers, getRandomNumber, getRecordKeys, httpErrorCodeLookup, incrementVersion, interpolate, interpolateObjects, isAnniversary, isLeapYear, isMonthlyMultiple, isOrdered, isSameDate, kebabToCamel, normaliseImportPath, normaliseIndents, normalizeImportPath, normalizeIndents, omitProperties, paralleliseArrays, parseBoolean, parseEmail, parseEnv, parseFormData, parseIntStrict, parseUUID, parseVersion, parseVersionType, parseZodSchema, randomiseArray, range, removeDuplicates, removeIndents, stringListToArray, stringToBoolean, truncate, wait };
+export { APIError, ArrayElement, CreateFormDataOptions, CreateFormDataOptionsNullableResolution, CreateFormDataOptionsUndefinedOrNullResolution, DataError, DisallowUndefined, type Env, FormDataArrayResolutionStrategy, FormDataNullableResolutionStrategy, HTTPErrorCode, IgnoreCase, type IncrementVersionOptions, KebabToCamelOptions, NAMESPACE_EXPORT_REGEX, NonUndefined, NormaliseIndentsFunction, NormaliseIndentsOptions, NormalizeIndentsFunction, NormalizeIndentsOptions, OptionalOnCondition, type ParseVersionOptions, RecordKey, StringListToArrayOptions, VERSION_NUMBER_REGEX, type VersionType, addDaysToDate, appendSemicolon, camelToKebab, convertFileToBase64, createFormData, createTemplateStringsArray, deepCopy, deepFreeze, determineVersionType, fillArray, formatDateAndTime, getIndividualVersionNumbers, getRandomNumber, getRecordKeys, httpErrorCodeLookup, incrementVersion, interpolate, interpolateObjects, isAnniversary, isLeapYear, isMonthlyMultiple, isOrdered, isSameDate, kebabToCamel, normaliseImportPath, normaliseIndents, normalizeImportPath, normalizeIndents, omitProperties, paralleliseArrays, parseBoolean, parseEnv, parseFormData, parseIntStrict, parseVersion, parseVersionType, parseZodSchema, randomiseArray, range, removeDuplicates, stringListToArray, truncate, wait };

package/dist/index.js

@@ -59,27 +59,108 @@ function paralleliseArrays(firstArray, secondArray) {
 }
 var paralleliseArrays_default = paralleliseArrays;
 
+//#endregion
+//#region src/types/APIError.ts
+const httpErrorCodeLookup = {
+	400: "BAD_REQUEST",
+	401: "UNAUTHORISED",
+	403: "FORBIDDEN",
+	404: "NOT_FOUND",
+	418: "I_AM_A_TEAPOT",
+	500: "INTERNAL_SERVER_ERROR"
+};
+/** Represents common errors you may get from a HTTP API request. */
+var APIError = class extends Error {
+	status;
+	/**
+	* @param status - A HTTP status code. Can be any number, but numbers between 400 and 600 are encouraged to fit with HTTP status code conventions.
+	* @param message - An error message to display alongside the status code.
+	* @param options - Extra options to be passed to super Error constructor.
+	*/
+	constructor(status = 500, message, options) {
+		super(message, options);
+		this.status = status;
+		if (message) this.message = message;
+		else this.message = httpErrorCodeLookup[this.status] ?? "API_ERROR";
+		Object.defineProperty(this, "message", { enumerable: true });
+		Object.setPrototypeOf(this, new.target.prototype);
+	}
+	/**
+	* Checks whether the given input may have been caused by an APIError.
+	*
+	* @param input - The input to check.
+	*
+	* @returns `true` if the input is an APIError, and `false` otherwise. The type of the input will also be narrowed down to APIError if `true`.
+	*/
+	static check(input) {
+		const data = input;
+		return typeof data === "object" && data !== null && typeof data?.status === "number" && typeof data?.message === "string";
+	}
+};
+var APIError_default = APIError;
+
+//#endregion
+//#region src/types/DataError.ts
+/** Represents errors you may get that may've been caused by a specific piece of data. */
+var DataError = class extends Error {
+	data;
+	code;
+	/**
+	* @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, code = "INVALID_DATA", message = "The data provided is invalid", options) {
+		super(message, options);
+		if (Error.captureStackTrace) Error.captureStackTrace(this, new.target);
+		this.name = new.target.name;
+		this.code = code;
+		this.data = data;
+		Object.defineProperty(this, "message", { enumerable: true });
+		Object.setPrototypeOf(this, new.target.prototype);
+	}
+	/**
+	* 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(input) {
+		const data = input;
+		return typeof data === "object" && data !== null && typeof data.message === "string" && typeof data.code === "string" && "data" in data;
+	}
+};
+var DataError_default = DataError;
+
 //#endregion
 //#region src/functions/parsers/parseIntStrict.ts
-const IntegerParsingError = /* @__PURE__ */ new TypeError("INTEGER_PARSING_ERROR");
 /**
 * Converts a string to an integer and throws an error if it cannot be converted.
 *
 * @param string - A string to convert into a number.
 * @param radix - A value between 2 and 36 that specifies the base of the number in string. If this argument is not supplied, strings with a prefix of '0x' are considered hexadecimal. All other strings are considered decimal.
 *
-* @throws {TypeError} If the provided string cannot safely be converted to an integer.
+* @throws {DataError} If the provided string cannot safely be converted to an integer.
 *
 * @returns The integer parsed from the input string.
 */
 function parseIntStrict(string, radix) {
 	const trimmedString = string.trim();
-	if (!(radix && radix > 10 && radix <= 36 ? new RegExp(`^[+-]?[0-9a-${String.fromCharCode(87 + radix - 1)}]+$`, "i") : /^[+-]?\d+$/).test(trimmedString)) throw IntegerParsingError;
+	const maxAllowedAlphabeticalCharacter = radix && radix > 10 && radix <= 36 ? String.fromCharCode(87 + radix - 1) : void 0;
+	if (!(radix && radix > 10 && radix <= 36 ? new RegExp(`^[+-]?[0-9a-${maxAllowedAlphabeticalCharacter}]+$`, "i") : /^[+-]?\d+$/).test(trimmedString)) throw new DataError_default(radix ? {
+		string,
+		radix
+	} : string, "INTEGER_PARSING_ERROR", `Only numeric values${radix && radix > 10 && radix <= 36 ? ` or character${radix !== 11 ? "s" : ""} A${radix !== 11 ? `-${maxAllowedAlphabeticalCharacter?.toUpperCase()} ` : " "}` : " "}are allowed.`);
 	if (radix && radix < 10 && [...trimmedString].some((character) => {
 		return parseInt(character) >= radix;
-	})) throw IntegerParsingError;
+	})) throw new DataError_default({
+		string,
+		radix
+	}, "INTEGER_PARSING_ERROR", "Value contains one or more digits outside of the range of the given radix.");
 	const parseIntResult = parseInt(trimmedString, radix);
-	if (isNaN(parseIntResult)) throw IntegerParsingError;
+	if (isNaN(parseIntResult)) throw new DataError_default(string, "INTEGER_PARSING_ERROR", "Value is not a valid integer.");
 	return parseIntResult;
 }
 var parseIntStrict_default = parseIntStrict;
@@ -510,19 +591,42 @@ var omitProperties_default = omitProperties;
 *
 * @param inputString - The string to parse.
 *
-* @throws {TypeError} If the string is not either `true` or `false` (case insensitive).
+* @throws {DataError} If the string is not either `true` or `false` (case insensitive).
 *
 * @returns The string parsed as an actual boolean.
 */
 function parseBoolean(inputString) {
 	const normalisedString = inputString.toLowerCase();
-	if (!["true", "false"].includes(normalisedString)) throw new TypeError("INVALID_BOOLEAN_STRING");
+	if (!["true", "false"].includes(normalisedString)) throw new DataError_default(inputString, "INVALID_BOOLEAN_STRING", "The provided boolean string must be one of `true | false`");
 	return normalisedString === "true";
 }
-/** @deprecated This function has been renamed to parseBoolean. */
-const stringToBoolean = parseBoolean;
 var parseBoolean_default = parseBoolean;
 
+//#endregion
+//#region src/functions/parsers/parseZodSchema.ts
+/**
+* An alternative function to zodSchema.parse() that can be used to strictly parse Zod schemas.
+*
+* @template Output - The Zod output type.
+* @template Input - The Zod input type.
+* @template Internals - The Zod internal types based on the output and input types.
+* @template ErrorType - The type of error to throw on invalid data.
+*
+* @param schema - The Zod schema to use in parsing.
+* @param data - The data to parse.
+* @param error - A custom error to throw on invalid data (defaults to `DataError`).
+*
+* @throws {DataError} If the given data cannot be parsed according to the schema.
+*
+* @returns The parsed data from the Zod schema.
+*/
+function parseZodSchema(schema, data, error) {
+	const parsedResult = schema.safeParse(data);
+	if (!parsedResult.success) throw error ?? new DataError_default(data);
+	return parsedResult.data;
+}
+var parseZodSchema_default = parseZodSchema;
+
 //#endregion
 //#region src/functions/parsers/parseEnv.ts
 const envSchema = z$1.enum([
@@ -535,12 +639,12 @@ const envSchema = z$1.enum([
 *
 * @param data - The data to parse.
 *
-* @throws {ZodError} If the data does not match one of the environments allowed by the Env types ("test" | "development" | "production").
+* @throws {DataError} If the data does not match one of the environments allowed by the Env types ("test" | "development" | "production").
 *
 * @returns The specified environment if allowed.
 */
 function parseEnv(data) {
-	return envSchema.parse(data);
+	return parseZodSchema_default(envSchema, data, new DataError_default(data, "INVALID_ENV", "The provided environment type must be one of `test | development | production`"));
 }
 var parseEnv_default = parseEnv;
 
@@ -566,122 +670,6 @@ function parseFormData(formData, dataParser) {
 }
 var parseFormData_default = parseFormData;
 
-//#endregion
-//#region src/types/APIError.ts
-const httpErrorCodeLookup = {
-	400: "BAD_REQUEST",
-	401: "UNAUTHORISED",
-	403: "FORBIDDEN",
-	404: "NOT_FOUND",
-	418: "I_AM_A_TEAPOT",
-	500: "INTERNAL_SERVER_ERROR"
-};
-/** Represents common errors you may get from a HTTP API request. */
-var APIError = class extends Error {
-	status;
-	/**
-	* @param status - A HTTP status code. Can be any number, but numbers between 400 and 600 are encouraged to fit with HTTP status code conventions.
-	* @param message - An error message to display alongside the status code.
-	* @param options - Extra options to be passed to super Error constructor.
-	*/
-	constructor(status = 500, message, options) {
-		super(message, options);
-		this.status = status;
-		if (message) this.message = message;
-		else this.message = httpErrorCodeLookup[this.status] ?? "API_ERROR";
-		Object.defineProperty(this, "message", { enumerable: true });
-		Object.setPrototypeOf(this, new.target.prototype);
-	}
-	/**
-	* Checks whether the given input may have been caused by an APIError.
-	*
-	* @param input - The input to check.
-	*
-	* @returns `true` if the input is an APIError, and `false` otherwise. The type of the input will also be narrowed down to APIError if `true`.
-	*/
-	static check(input) {
-		const data = input;
-		return typeof data === "object" && data !== null && typeof data?.status === "number" && typeof data?.message === "string";
-	}
-};
-var APIError_default = APIError;
-
-//#endregion
-//#region src/types/DataError.ts
-/** Represents errors you may get that may've been caused by a specific piece of data. */
-var DataError = class extends Error {
-	data;
-	code;
-	/**
-	* @param data - The data that caused the error.
-	* @param message  - A human-readable error message (e.g. The data provided is invalid).
-	* @param code - A standardised code (e.g. UNEXPECTED_DATA).
-	* @param options - Extra options to pass to super Error constructor.
-	*/
-	constructor(data, message = "The data provided is invalid", code = "INVALID_DATA", options) {
-		super(message, options);
-		if (Error.captureStackTrace) Error.captureStackTrace(this, new.target);
-		this.name = new.target.name;
-		this.code = code;
-		this.data = data;
-		Object.defineProperty(this, "message", { enumerable: true });
-		Object.setPrototypeOf(this, new.target.prototype);
-	}
-	/**
-	* 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(input) {
-		const data = input;
-		return typeof data === "object" && data !== null && typeof data.message === "string" && typeof data.code === "string" && "data" in data;
-	}
-};
-var DataError_default = DataError;
-
-//#endregion
-//#region src/types/Email.ts
-const emailSchema = z.email().brand();
-/** @deprecated Please use `z.email().parse() from Zod instead.`*/
-function parseEmail(data) {
-	return emailSchema.parse(data);
-}
-var Email_default = parseEmail;
-
-//#endregion
-//#region src/types/UUID.ts
-const uuidSchema = z.uuid().brand();
-/** @deprecated Please use `z.uuid().parse() from Zod instead.`*/
-function parseUUID(UUID) {
-	return uuidSchema.parse(UUID);
-}
-var UUID_default = parseUUID;
-
-//#endregion
-//#region src/functions/parsers/parseZodSchema.ts
-/**
-* An alternative function to zodSchema.parse() that can be used to strictly parse Zod schemas.
-*
-* @template Output - The Zod output type.
-* @template Input - The Zod input type.
-* @template Internals - The Zod internal types based on the output and input types.
-*
-* @param schema - The Zod schema to use in parsing.
-* @param data - The data to parse.
-*
-* @throws {DataError} If the given data cannot be parsed according to the schema.
-*
-* @returns The parsed data from the Zod schema.
-*/
-function parseZodSchema(schema, data) {
-	const parsedResult = schema.safeParse(data);
-	if (!parsedResult.success) throw new DataError_default(data);
-	return parsedResult.data;
-}
-var parseZodSchema_default = parseZodSchema;
-
 //#endregion
 //#region src/functions/parsers/parseVersionType.ts
 const versionTypeSchema = z.enum([
@@ -699,7 +687,7 @@ const versionTypeSchema = z.enum([
 * @returns The given version type if allowed.
 */
 function parseVersionType(data) {
-	return parseZodSchema_default(versionTypeSchema, data);
+	return parseZodSchema_default(versionTypeSchema, data, new DataError_default(data, "INVALID_VERSION_TYPE", "The provided version type must be one of `major | minor | patch`"));
 }
 var parseVersionType_default = parseVersionType;
 
@@ -938,25 +926,25 @@ var interpolateObjects_default = interpolateObjects;
 
 //#endregion
 //#region src/functions/taggedTemplate/normaliseIndents.ts
-function calculateTabSize$1(line, whitespaceLength) {
+function calculateTabSize(line, whitespaceLength) {
 	const potentialWhitespacePart = line.slice(0, whitespaceLength);
 	const trimmedString = line.trimStart();
 	if (potentialWhitespacePart.trim() !== "") return 0;
 	const tabSize = line.length - (trimmedString.length + whitespaceLength);
 	return tabSize < 0 ? 0 : tabSize;
 }
-function getWhitespaceLength$1(lines) {
+function getWhitespaceLength(lines) {
 	const [firstNonEmptyLine] = lines.filter((line) => {
 		return line.trim() !== "";
 	});
 	return firstNonEmptyLine.length - firstNonEmptyLine.trimStart().length;
 }
-function reduceLines$1(lines, { preserveTabs = true }) {
+function reduceLines(lines, { preserveTabs = true }) {
 	const slicedLines = lines.slice(1);
 	const isFirstLineEmpty = lines[0].trim() === "";
-	const whitespaceLength = getWhitespaceLength$1(isFirstLineEmpty ? lines : slicedLines);
+	const whitespaceLength = getWhitespaceLength(isFirstLineEmpty ? lines : slicedLines);
 	return (isFirstLineEmpty ? slicedLines : lines).map((line) => {
-		const tabSize = calculateTabSize$1(line, whitespaceLength);
+		const tabSize = calculateTabSize(line, whitespaceLength);
 		return (preserveTabs ? fillArray_default(() => {
 			return " ";
 		}, tabSize).join("") : "") + line.trimStart();
@@ -991,7 +979,7 @@ function normaliseIndents(first, ...args) {
 	}
 	const strings = first;
 	const options = typeof args[args.length - 1] === "object" && !Array.isArray(args[args.length - 1]) ? args.pop() : {};
-	return reduceLines$1(interpolate_default(strings, ...[...args]).split("\n"), options);
+	return reduceLines(interpolate_default(strings, ...[...args]).split("\n"), options);
 }
 /**
 * Applies any options if provided, then removes any extraneous indents from a multi-line template string.
@@ -1016,45 +1004,6 @@ function normaliseIndents(first, ...args) {
 const normalizeIndents = normaliseIndents;
 var normaliseIndents_default = normaliseIndents;
 
-//#endregion
-//#region src/functions/taggedTemplate/removeIndents.ts
-function calculateTabSize(line, whitespaceLength) {
-	const potentialWhitespacePart = line.slice(0, whitespaceLength);
-	const trimmedString = line.trimStart();
-	if (potentialWhitespacePart.trim() !== "") return 0;
-	const tabSize = line.length - (trimmedString.length + whitespaceLength);
-	return tabSize < 0 ? 0 : tabSize;
-}
-function getWhitespaceLength(lines) {
-	const [firstNonEmptyLine] = lines.filter((line) => {
-		return line.trim() !== "";
-	});
-	return firstNonEmptyLine.length - firstNonEmptyLine.trimStart().length;
-}
-function reduceLines(lines, { preserveTabs = true }) {
-	const slicedLines = lines.slice(1);
-	const isFirstLineEmpty = lines[0].trim() === "";
-	const whitespaceLength = getWhitespaceLength(isFirstLineEmpty ? lines : slicedLines);
-	return (isFirstLineEmpty ? slicedLines : lines).map((line) => {
-		const tabSize = calculateTabSize(line, whitespaceLength);
-		return (preserveTabs ? fillArray_default(() => {
-			return " ";
-		}, tabSize).join("") : "") + line.trimStart();
-	}).join("\n");
-}
-function removeIndents(first, ...args) {
-	if (typeof first === "object" && first !== null && !Array.isArray(first)) {
-		const options$1 = first;
-		return (strings$1, ...interpolations) => {
-			return removeIndents(strings$1, ...interpolations, options$1);
-		};
-	}
-	const strings = first;
-	const options = typeof args[args.length - 1] === "object" && !Array.isArray(args[args.length - 1]) ? args.pop() : {};
-	return reduceLines(interpolate_default(strings, ...[...args]).split("\n"), options);
-}
-var removeIndents_default = removeIndents;
-
 //#endregion
 //#region src/functions/versioning/parseVersion.ts
 /**
@@ -1070,7 +1019,7 @@ var removeIndents_default = removeIndents;
 * @returns The validated version number, prefixed with `v` if it was not already.
 */
 function parseVersion(input, options) {
-	if (!RegExp(VERSION_NUMBER_REGEX_default).test(input)) throw new DataError_default(input, `"${input}" is not a valid version number. Version numbers must be of the format "X.Y.Z" or "vX.Y.Z", where X, Y, and Z are non-negative integers.`, "INVALID_VERSION");
+	if (!RegExp(VERSION_NUMBER_REGEX_default).test(input)) throw new DataError_default(input, "INVALID_VERSION", `"${input}" is not a valid version number. Version numbers must be of the format "X.Y.Z" or "vX.Y.Z", where X, Y, and Z are non-negative integers.`);
 	if (options?.omitPrefix) return input.startsWith("v") ? input.slice(1) : input;
 	return input.startsWith("v") ? input : `v${input}`;
 }
@@ -1135,4 +1084,4 @@ function incrementVersion(version, incrementType, options) {
 var incrementVersion_default = incrementVersion;
 
 //#endregion
-export { APIError_default as APIError, DataError_default as DataError, NAMESPACE_EXPORT_REGEX_default as NAMESPACE_EXPORT_REGEX, VERSION_NUMBER_REGEX_default as VERSION_NUMBER_REGEX, addDaysToDate_default as addDaysToDate, appendSemicolon_default as appendSemicolon, camelToKebab_default as camelToKebab, convertFileToBase64_default as convertFileToBase64, createFormData_default as createFormData, createTemplateStringsArray_default as createTemplateStringsArray, deepCopy_default as deepCopy, deepFreeze_default as deepFreeze, determineVersionType_default as determineVersionType, fillArray_default as fillArray, formatDateAndTime_default as formatDateAndTime, getIndividualVersionNumbers_default as getIndividualVersionNumbers, getRandomNumber_default as getRandomNumber, getRecordKeys_default as getRecordKeys, httpErrorCodeLookup, incrementVersion_default as incrementVersion, interpolate_default as interpolate, interpolateObjects_default as interpolateObjects, isAnniversary_default as isAnniversary, isLeapYear_default as isLeapYear, isMonthlyMultiple_default as isMonthlyMultiple, isOrdered_default as isOrdered, isSameDate_default as isSameDate, kebabToCamel_default as kebabToCamel, normaliseImportPath, normaliseIndents_default as normaliseIndents, normalizeImportPath_default as normalizeImportPath, normalizeIndents, omitProperties_default as omitProperties, paralleliseArrays_default as paralleliseArrays, parseBoolean_default as parseBoolean, Email_default as parseEmail, parseEnv_default as parseEnv, parseFormData_default as parseFormData, parseIntStrict_default as parseIntStrict, UUID_default as parseUUID, parseVersion_default as parseVersion, parseVersionType_default as parseVersionType, parseZodSchema_default as parseZodSchema, randomiseArray_default as randomiseArray, range_default as range, removeDuplicates_default as removeDuplicates, removeIndents_default as removeIndents, stringListToArray_default as stringListToArray, stringToBoolean, truncate_default as truncate, wait_default as wait };
+export { APIError_default as APIError, DataError_default as DataError, NAMESPACE_EXPORT_REGEX_default as NAMESPACE_EXPORT_REGEX, VERSION_NUMBER_REGEX_default as VERSION_NUMBER_REGEX, addDaysToDate_default as addDaysToDate, appendSemicolon_default as appendSemicolon, camelToKebab_default as camelToKebab, convertFileToBase64_default as convertFileToBase64, createFormData_default as createFormData, createTemplateStringsArray_default as createTemplateStringsArray, deepCopy_default as deepCopy, deepFreeze_default as deepFreeze, determineVersionType_default as determineVersionType, fillArray_default as fillArray, formatDateAndTime_default as formatDateAndTime, getIndividualVersionNumbers_default as getIndividualVersionNumbers, getRandomNumber_default as getRandomNumber, getRecordKeys_default as getRecordKeys, httpErrorCodeLookup, incrementVersion_default as incrementVersion, interpolate_default as interpolate, interpolateObjects_default as interpolateObjects, isAnniversary_default as isAnniversary, isLeapYear_default as isLeapYear, isMonthlyMultiple_default as isMonthlyMultiple, isOrdered_default as isOrdered, isSameDate_default as isSameDate, kebabToCamel_default as kebabToCamel, normaliseImportPath, normaliseIndents_default as normaliseIndents, normalizeImportPath_default as normalizeImportPath, normalizeIndents, omitProperties_default as omitProperties, paralleliseArrays_default as paralleliseArrays, parseBoolean_default as parseBoolean, parseEnv_default as parseEnv, parseFormData_default as parseFormData, parseIntStrict_default as parseIntStrict, parseVersion_default as parseVersion, parseVersionType_default as parseVersionType, parseZodSchema_default as parseZodSchema, randomiseArray_default as randomiseArray, range_default as range, removeDuplicates_default as removeDuplicates, stringListToArray_default as stringListToArray, truncate_default as truncate, wait_default as wait };

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@alextheman/utility",
-  "version": "3.10.0",
+  "version": "4.0.0",
   "description": "Helpful utility functions",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/AlexMan123456/utility.git"
   },
-  "license": "ISC",
+  "license": "MIT",
   "author": "alextheman",
   "type": "module",
   "main": "dist/index.cjs",
@@ -16,28 +16,30 @@
     "dist"
   ],
   "dependencies": {
-    "zod": "^4.1.13"
+    "zod": "^4.2.1"
   },
   "devDependencies": {
-    "@alextheman/eslint-plugin": "^4.8.6",
-    "@types/node": "^25.0.1",
+    "@alextheman/eslint-plugin": "^4.9.0",
+    "@types/node": "^25.0.3",
+    "alex-c-line": "^1.9.0",
     "dotenv-cli": "^11.0.0",
-    "eslint": "^9.39.1",
+    "eslint": "^9.39.2",
+    "eslint-plugin-perfectionist": "^5.0.0",
     "globals": "^16.5.0",
     "husky": "^9.1.7",
     "jsdom": "^27.3.0",
     "prettier": "^3.7.4",
-    "tsdown": "^0.17.3",
+    "tsdown": "^0.18.1",
     "typescript": "^5.9.3",
-    "vite-tsconfig-paths": "^5.1.4",
-    "vitest": "^4.0.15"
+    "vite-tsconfig-paths": "^6.0.3",
+    "vitest": "^4.0.16"
   },
   "scripts": {
     "build": "tsdown",
-    "change-major": "pnpm version major -m \"Change version number to v%s\"",
-    "change-minor": "pnpm version minor -m \"Change version number to v%s\"",
-    "change-patch": "pnpm version patch -m \"Change version number to v%s\"",
     "create-local-package": "pnpm run build && rm -f alextheman-utility-*.tgz && pnpm pack",
+    "create-release-note-major": "git pull origin main && alex-c-line create-release-note major",
+    "create-release-note-minor": "git pull origin main && alex-c-line create-release-note minor",
+    "create-release-note-patch": "git pull origin main && alex-c-line create-release-note patch",
     "format": "pnpm run format-prettier && pnpm run format-eslint",
     "format-eslint": "eslint --fix --suppress-all \"package.json\" \"src/**/*.ts\" \"tests/**/*.ts\" && rm -f eslint-suppressions.json",
     "format-prettier": "pnpm run format-prettier-typescript && pnpm run format-prettier-javascript",