@alextheman/utility 5.6.0 → 5.6.2

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import z, { ZodError, ZodType, z as z$1 } from "zod";
+import z$1, { ZodError, ZodType, z } from "zod";
 import { DotenvParseOutput } from "dotenv";
 
 //#region src/root/constants/FILE_PATH_REGEX.d.ts
@@ -30,7 +30,7 @@ declare const VERSION_NUMBER_REGEX: RegExp;
  *
  * @returns A Promise resolving to an array of the callback results.
  */
-declare function fillArray<ItemType>(callback: (index: number) => Promise<ItemType>, length?: number): Promise<ItemType[]>;
+declare function fillArray<ItemType>(callback: (index: number) => Promise<ItemType>, length?: number): Promise<Array<ItemType>>;
 /**
  * Creates a new array where each element is the result of the provided synchronous callback.
  *
@@ -44,7 +44,7 @@ declare function fillArray<ItemType>(callback: (index: number) => Promise<ItemTy
  *
  * @returns An array of the callback results.
  */
-declare function fillArray<ItemType>(callback: (index: number) => ItemType, length?: number): ItemType[];
+declare function fillArray<ItemType>(callback: (index: number) => ItemType, length?: number): Array<ItemType>;
 //#endregion
 //#region src/root/functions/arrayHelpers/paralleliseArrays.d.ts
 type ParallelTuple<A, B> = [A, B | undefined];
@@ -64,7 +64,7 @@ type ParallelTuple<A, B> = [A, B | undefined];
  *
  * @returns An array of `[firstItem, secondItem]` tuples for each index in `firstArray`.
  */
-declare function paralleliseArrays<FirstArrayItem, SecondArrayItem>(firstArray: readonly FirstArrayItem[], secondArray: readonly SecondArrayItem[]): ParallelTuple<FirstArrayItem, SecondArrayItem>[];
+declare function paralleliseArrays<FirstArrayItem, SecondArrayItem>(firstArray: ReadonlyArray<FirstArrayItem>, secondArray: ReadonlyArray<SecondArrayItem>): Array<ParallelTuple<FirstArrayItem, SecondArrayItem>>;
 //#endregion
 //#region src/root/functions/arrayHelpers/randomiseArray.d.ts
 /**
@@ -78,7 +78,7 @@ declare function paralleliseArrays<FirstArrayItem, SecondArrayItem>(firstArray:
  *
  * @returns A new array with the items randomised.
  */
-declare function randomiseArray<ItemType>(array: ItemType[]): ItemType[];
+declare function randomiseArray<ItemType>(array: Array<ItemType>): Array<ItemType>;
 //#endregion
 //#region src/root/functions/arrayHelpers/range.d.ts
 /**
@@ -98,7 +98,7 @@ declare function randomiseArray<ItemType>(array: ItemType[]): ItemType[];
  *
  * @returns An array of numbers satisfying the range provided.
  */
-declare function range(start: number, stop: number, step?: number): number[];
+declare function range(start: number, stop: number, step?: number): Array<number>;
 //#endregion
 //#region src/root/functions/arrayHelpers/removeDuplicates.d.ts
 /**
@@ -112,7 +112,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>(array: ItemType[] | readonly ItemType[]): ItemType[];
+declare function removeDuplicates<ItemType>(array: Array<ItemType> | ReadonlyArray<ItemType>): Array<ItemType>;
 //#endregion
 //#region src/root/functions/date/addDaysToDate.d.ts
 /**
@@ -409,7 +409,7 @@ declare class VersionNumber {
    */
   toString(): string;
 }
-declare const zodVersionNumber: z.ZodType<VersionNumber>;
+declare const zodVersionNumber: z$1.ZodType<VersionNumber>;
 //#endregion
 //#region src/root/types/ArrayElement.d.ts
 /**
@@ -419,7 +419,7 @@ declare const zodVersionNumber: z.ZodType<VersionNumber>;
  *
  * @template ArrayType - The type of the array itself.
  */
-type ArrayElement<ArrayType extends readonly unknown[]> = ArrayType extends readonly (infer ElementType)[] ? ElementType : never;
+type ArrayElement<ArrayType extends ReadonlyArray<unknown>> = ArrayType extends ReadonlyArray<infer ElementType> ? ElementType : never;
 //#endregion
 //#region src/root/types/CallReturnType.d.ts
 type CallReturnType<Function, Arguments> = Function extends ((arg: Arguments) => infer Return) ? Return : never;
@@ -578,7 +578,7 @@ declare function getRandomNumber(lowerBound: number, upperBound: number): number
  *
  * @returns `true` if the array is sorted in ascending order, and `false` otherwise.
  */
-declare function isOrdered(array: readonly number[]): boolean;
+declare function isOrdered(array: ReadonlyArray<number>): boolean;
 //#endregion
 //#region src/root/functions/miscellaneous/sayHello.d.ts
 /**
@@ -633,7 +633,7 @@ interface StringListToArrayOptions {
 declare function stringListToArray(stringList: string, {
   separator,
   trimWhitespace
-}?: StringListToArrayOptions): string[];
+}?: StringListToArrayOptions): Array<string>;
 //#endregion
 //#region src/root/functions/miscellaneous/wait.d.ts
 /**
@@ -659,7 +659,7 @@ declare function wait(seconds: number): Promise<void>;
  *
  * @returns An array with all the keys of the input object in string form, but properly typed as `keyof InputRecordType`.
  */
-declare function getRecordKeys<InputRecordType extends Record<RecordKey, unknown>>(record: InputRecordType & object): (keyof InputRecordType)[];
+declare function getRecordKeys<InputRecordType extends Record<RecordKey, unknown>>(record: InputRecordType & object): Array<keyof InputRecordType>;
 //#endregion
 //#region src/root/functions/objectHelpers/omitProperties.d.ts
 /**
@@ -675,7 +675,7 @@ declare function getRecordKeys<InputRecordType extends Record<RecordKey, unknown
  *
  * @returns An object with a new reference in memory, with the properties omitted.
  */
-declare function omitProperties<ObjectType extends Record<string, unknown> | Readonly<Record<string, unknown>>, KeysToOmit extends keyof ObjectType>(object: ObjectType, keysToOmit: KeysToOmit | readonly KeysToOmit[]): Omit<ObjectType, KeysToOmit>;
+declare function omitProperties<ObjectType extends Record<string, unknown> | Readonly<Record<string, unknown>>, KeysToOmit extends keyof ObjectType>(object: ObjectType, keysToOmit: KeysToOmit | ReadonlyArray<KeysToOmit>): Omit<ObjectType, KeysToOmit>;
 //#endregion
 //#region src/root/functions/objectHelpers/removeUndefinedFromObject.d.ts
 type RemoveUndefined<RecordType extends Record<RecordKey, unknown>> = { [Key in keyof RecordType]: Exclude<RecordType[Key], undefined> };
@@ -821,7 +821,7 @@ declare function parseVersionType(input: unknown): VersionType;
  *
  * @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$1.infer<SchemaType>;
+declare function parseZodSchema<SchemaType extends ZodType, ErrorType extends Error = DataError>(schema: SchemaType, input: unknown, onError?: ErrorType | ((zodError: ZodError) => ErrorType | void)): z.infer<SchemaType>;
 //#endregion
 //#region src/root/functions/parsers/zod/parseZodSchemaAsync.d.ts
 /**
@@ -840,7 +840,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$1.infer<SchemaType>>;
+declare function parseZodSchemaAsync<SchemaType extends ZodType, ErrorType extends Error = DataError>(schema: SchemaType, input: unknown, onError?: ErrorType | ((zodError: ZodError) => ErrorType | void)): Promise<z.infer<SchemaType>>;
 //#endregion
 //#region src/root/functions/recursive/deepCopy.d.ts
 /**
@@ -965,7 +965,7 @@ declare function truncate(stringToTruncate: string, maxLength?: number): string;
  *
  * @returns A template strings array that can be passed as the first argument of any tagged template function.
  */
-declare function createTemplateStringsArray(strings: readonly string[]): TemplateStringsArray;
+declare function createTemplateStringsArray(strings: ReadonlyArray<string>): TemplateStringsArray;
 //#endregion
 //#region src/root/functions/taggedTemplate/getStringsAndInterpolations.d.ts
 /**
@@ -997,7 +997,7 @@ declare function createTemplateStringsArray(strings: readonly string[]): Templat
  * interpolate(...getStringsAndInterpolations`The package ${packageName} uses the ${packageManager} package manager.`);
  * ```
  */
-declare function getStringsAndInterpolations<const InterpolationsType extends readonly unknown[]>(strings: TemplateStringsArray, ...interpolations: InterpolationsType): [TemplateStringsArray, ...InterpolationsType];
+declare function getStringsAndInterpolations<const InterpolationsType extends ReadonlyArray<unknown>>(strings: TemplateStringsArray, ...interpolations: InterpolationsType): [TemplateStringsArray, ...InterpolationsType];
 //#endregion
 //#region src/root/functions/taggedTemplate/interpolate.d.ts
 /**
@@ -1020,7 +1020,7 @@ declare function getStringsAndInterpolations<const InterpolationsType extends re
  *
  * @returns A new string with the strings and interpolations from the template applied.
  */
-declare function interpolate<const InterpolationsType extends readonly unknown[]>(strings: TemplateStringsArray, ...interpolations: InterpolationsType): string;
+declare function interpolate<const InterpolationsType extends ReadonlyArray<unknown>>(strings: TemplateStringsArray, ...interpolations: InterpolationsType): string;
 //#endregion
 //#region src/root/functions/taggedTemplate/interpolateObjects.d.ts
 /**
@@ -1041,7 +1041,7 @@ declare function interpolate<const InterpolationsType extends readonly unknown[]
  *
  * @returns A new string with the strings and interpolations from the template applied, with objects stringified.
  */
-declare function interpolateObjects<const InterpolationsType extends readonly unknown[]>(strings: TemplateStringsArray, ...interpolations: InterpolationsType): string;
+declare function interpolateObjects<const InterpolationsType extends ReadonlyArray<unknown>>(strings: TemplateStringsArray, ...interpolations: InterpolationsType): string;
 //#endregion
 //#region src/root/functions/taggedTemplate/isTemplateStringsArray.d.ts
 /**
@@ -1066,7 +1066,7 @@ interface NormaliseIndentsOptions {
   preserveTabs?: boolean;
 }
 type NormalizeIndentsOptions = NormaliseIndentsOptions;
-type NormaliseIndentsFunction = (strings: TemplateStringsArray, ...interpolations: unknown[]) => string;
+type NormaliseIndentsFunction = (strings: TemplateStringsArray, ...interpolations: Array<unknown>) => string;
 type NormalizeIndentsFunction = NormaliseIndentsFunction;
 /**
  * Provides a new function that removes any extraneous indents from a multi-line template string, with the given options applied.
@@ -1096,7 +1096,7 @@ declare function normaliseIndents(options: NormaliseIndentsOptions): NormaliseIn
  *
  * @returns A new string with the strings and interpolations from the template applied, and extraneous indents removed.
  */
-declare function normaliseIndents(strings: TemplateStringsArray, ...interpolations: unknown[]): string;
+declare function normaliseIndents(strings: TemplateStringsArray, ...interpolations: Array<unknown>): string;
 /**
  * Applies any options if provided, then removes any extraneous indents from a multi-line template string.
  *

package/dist/index.js

@@ -1,24 +1,19 @@
-import z, { z as z$1 } from "zod";
+import z$1, { z } from "zod";
 import sodium from "libsodium-wrappers";
-
 //#region src/root/constants/FILE_PATH_REGEX.ts
 const FILE_PATH_PATTERN = String.raw`(?<directory>.+)[\/\\](?<base>[^\/\\]+)`;
 const FILE_PATH_REGEX = RegExp(`^${FILE_PATH_PATTERN}$`);
-
 //#endregion
 //#region src/root/constants/ONE_DAY_IN_MILLISECONDS.ts
 const ONE_DAY_IN_MILLISECONDS = 1440 * 60 * 1e3;
-
 //#endregion
 //#region src/root/constants/UUID_REGEX.ts
 const UUID_PATTERN = "[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}";
 const UUID_REGEX = new RegExp(`^${UUID_PATTERN}$`);
-
 //#endregion
 //#region src/root/constants/VERSION_NUMBER_REGEX.ts
 const VERSION_NUMBER_PATTERN = String.raw`^(?:v)?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$`;
 const VERSION_NUMBER_REGEX = RegExp(`^${VERSION_NUMBER_PATTERN}$`);
-
 //#endregion
 //#region src/root/functions/arrayHelpers/fillArray.ts
 /**
@@ -45,7 +40,6 @@ function fillArray(callback, length = 1) {
 	})) return Promise.all(outputArray);
 	return outputArray;
 }
-
 //#endregion
 //#region src/root/functions/arrayHelpers/paralleliseArrays.ts
 /**
@@ -69,7 +63,6 @@ function paralleliseArrays(firstArray, secondArray) {
 	for (let i = 0; i < firstArray.length; i++) outputArray.push([firstArray[i], secondArray[i]]);
 	return outputArray;
 }
-
 //#endregion
 //#region src/root/types/APIError.ts
 const httpErrorCodeLookup = {
@@ -113,7 +106,6 @@ var APIError = class APIError extends Error {
 		return typeof data === "object" && data !== null && typeof data?.status === "number" && typeof data?.message === "string";
 	}
 };
-
 //#endregion
 //#region src/root/types/DataError.ts
 /**
@@ -203,7 +195,6 @@ var DataError = class DataError extends Error {
 		throw new Error("Expected a DataError to be thrown but none was thrown");
 	}
 };
-
 //#endregion
 //#region src/root/types/VersionNumber.ts
 /**
@@ -228,7 +219,7 @@ var VersionNumber = class VersionNumber {
 			this.minor = input.minor;
 			this.patch = input.patch;
 		} else if (typeof input === "string") {
-			if (!RegExp(VERSION_NUMBER_REGEX).test(input)) throw new DataError({ 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 (!VERSION_NUMBER_REGEX.test(input)) throw new DataError({ 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.`);
 			const [major, minor, patch] = VersionNumber.formatString(input, { omitPrefix: true }).split(".").map((number) => {
 				return parseIntStrict(number);
 			});
@@ -245,7 +236,10 @@ var VersionNumber = class VersionNumber {
 			this.major = major;
 			this.minor = minor;
 			this.patch = patch;
-		}
+		} else throw new DataError({ input }, "INVALID_INPUT", normaliseIndents`
+        The provided input can not be parsed into a valid version number.
+        Expected either a string of format X.Y.Z or vX.Y.Z, a tuple of three numbers, or another \`VersionNumber\` instance.
+      `);
 	}
 	/**
 	* Gets the current version type of the current instance of `VersionNumber`.
@@ -357,18 +351,17 @@ var VersionNumber = class VersionNumber {
 		return VersionNumber.formatString(rawString, { omitPrefix: false });
 	}
 };
-const zodVersionNumber = z.union([
-	z.string(),
-	z.tuple([
-		z.number(),
-		z.number(),
-		z.number()
+const zodVersionNumber = z$1.union([
+	z$1.string(),
+	z$1.tuple([
+		z$1.number(),
+		z$1.number(),
+		z$1.number()
 	]),
-	z.instanceof(VersionNumber)
+	z$1.instanceof(VersionNumber)
 ]).transform((rawVersionNumber) => {
 	return new VersionNumber(rawVersionNumber);
 });
-
 //#endregion
 //#region src/root/functions/parsers/parseIntStrict.ts
 /**
@@ -390,7 +383,7 @@ function parseIntStrict(string, 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) => {
+	if (radix && radix < 10 && [...trimmedString.replace(/^[+-]/, "")].some((character) => {
 		return parseInt(character) >= radix;
 	})) throw new DataError({
 		string,
@@ -400,7 +393,6 @@ function parseIntStrict(string, radix) {
 	if (isNaN(parseIntResult)) throw new DataError({ string }, "INTEGER_PARSING_ERROR", "Value is not a valid integer.");
 	return parseIntResult;
 }
-
 //#endregion
 //#region src/root/functions/miscellaneous/getRandomNumber.ts
 /**
@@ -418,7 +410,6 @@ function getRandomNumber(lowerBound, upperBound) {
 	const parsedUpperBound = parseIntStrict(`${upperBound}`);
 	return Math.floor(Math.random() * (parsedUpperBound - parsedLowerBound + 1) + parsedLowerBound);
 }
-
 //#endregion
 //#region src/root/functions/arrayHelpers/randomiseArray.ts
 /**
@@ -441,7 +432,6 @@ function randomiseArray(array) {
 	} while (mutableArray.length > 0);
 	return outputArray;
 }
-
 //#endregion
 //#region src/root/functions/arrayHelpers/range.ts
 /**
@@ -481,7 +471,6 @@ function range(start, stop, step = 1) {
 	}
 	return numbers;
 }
-
 //#endregion
 //#region src/root/functions/arrayHelpers/removeDuplicates.ts
 /**
@@ -500,7 +489,6 @@ function removeDuplicates(array) {
 	for (const item of array) if (!outputArray.includes(item)) outputArray.push(item);
 	return outputArray;
 }
-
 //#endregion
 //#region src/root/functions/date/addDaysToDate.ts
 /**
@@ -518,7 +506,6 @@ function addDaysToDate(currentDate = /* @__PURE__ */ new Date(), dayIncrement =
 	newDate.setDate(newDate.getDate() + dayIncrement);
 	return newDate;
 }
-
 //#endregion
 //#region src/root/functions/date/calculateMonthlyDifference.ts
 /**
@@ -533,7 +520,6 @@ function addDaysToDate(currentDate = /* @__PURE__ */ new Date(), dayIncrement =
 function calculateMonthlyDifference(firstDate, secondDate) {
 	return firstDate.getMonth() - secondDate.getMonth();
 }
-
 //#endregion
 //#region src/root/functions/date/isSameDate.ts
 /**
@@ -549,7 +535,6 @@ function calculateMonthlyDifference(firstDate, secondDate) {
 function isSameDate(firstDate, secondDate) {
 	return firstDate.getDate() === secondDate.getDate() && firstDate.getMonth() === secondDate.getMonth() && firstDate.getFullYear() === secondDate.getFullYear();
 }
-
 //#endregion
 //#region src/root/functions/date/formatDateAndTime.ts
 /**
@@ -573,7 +558,6 @@ function formatDateAndTime(inputDate) {
 	if (isSameDate(inputDate, today)) return `Today at ${inputTime}`;
 	return `${inputDate.getDate().toString().padStart(2, "0")}/${(inputDate.getMonth() + 1).toString().padStart(2, "0")}/${inputDate.getFullYear().toString()}, ${inputTime}`;
 }
-
 //#endregion
 //#region src/root/functions/date/isLeapYear.ts
 /**
@@ -591,7 +575,6 @@ function isLeapYear(year) {
 	const parsedYear = parseIntStrict(`${year}`);
 	return parsedYear % 4 === 0 && parsedYear % 100 !== 0 || parsedYear % 400 === 0;
 }
-
 //#endregion
 //#region src/root/functions/date/isAnniversary.ts
 function checkLeapYear(firstDate, secondDate) {
@@ -612,7 +595,6 @@ function isAnniversary(firstDate, secondDate) {
 	if (checkLeapYear(firstDate, secondDate) || checkLeapYear(secondDate, firstDate)) return true;
 	return firstDate.getDate() === secondDate.getDate() && firstDate.getMonth() === secondDate.getMonth();
 }
-
 //#endregion
 //#region src/root/functions/date/isMonthlyMultiple.ts
 function endOfMonthChecksButNotFebruary(firstDate, secondDate) {
@@ -661,7 +643,6 @@ function isMonthlyMultiple(firstDate, secondDate) {
 	if (leapYearFebruaryChecks(firstDate, secondDate) || leapYearFebruaryChecks(secondDate, firstDate)) return true;
 	return firstDate.getDate() === secondDate.getDate();
 }
-
 //#endregion
 //#region src/root/functions/miscellaneous/convertFileToBase64.ts
 /**
@@ -691,7 +672,6 @@ function convertFileToBase64(file) {
 		};
 	});
 }
-
 //#endregion
 //#region src/root/functions/miscellaneous/createFormData.ts
 function getNullableResolutionStrategy(key, strategy) {
@@ -763,7 +743,6 @@ function createFormData(data, options = {
 	} else formData.append(String(key), String(value));
 	return formData;
 }
-
 //#endregion
 //#region src/root/functions/miscellaneous/isOrdered.ts
 /**
@@ -781,7 +760,6 @@ function isOrdered(array) {
 	for (const index in newArray) if (newArray[index] !== array[index]) return false;
 	return true;
 }
-
 //#endregion
 //#region src/root/functions/recursive/deepFreeze.ts
 /**
@@ -805,7 +783,6 @@ function deepFreeze(object) {
 	}
 	return Object.freeze(object);
 }
-
 //#endregion
 //#region src/root/functions/taggedTemplate/createTemplateStringsArray.ts
 /**
@@ -820,7 +797,6 @@ function deepFreeze(object) {
 function createTemplateStringsArray(strings) {
 	return deepFreeze(Object.assign([...strings], { raw: [...strings] }));
 }
-
 //#endregion
 //#region src/root/functions/taggedTemplate/getStringsAndInterpolations.ts
 /**
@@ -861,7 +837,6 @@ function getStringsAndInterpolations(strings, ...interpolations) {
 	}, "INVALID_STRINGS_AND_INTERPOLATIONS_LENGTH", "The length of the strings must be exactly one more than the length of the interpolations.");
 	return [createTemplateStringsArray(strings), ...interpolations];
 }
-
 //#endregion
 //#region src/root/functions/taggedTemplate/interpolate.ts
 /**
@@ -889,7 +864,6 @@ function interpolate(strings, ...interpolations) {
 	for (const [string, interpolation = ""] of paralleliseArrays(strings, interpolations)) result += string + interpolation;
 	return result;
 }
-
 //#endregion
 //#region src/root/functions/taggedTemplate/interpolateObjects.ts
 /**
@@ -918,7 +892,6 @@ function interpolateObjects(strings, ...interpolations) {
 	}
 	return result;
 }
-
 //#endregion
 //#region src/root/functions/taggedTemplate/isTemplateStringsArray.ts
 /**
@@ -933,7 +906,6 @@ function interpolateObjects(strings, ...interpolations) {
 function isTemplateStringsArray(input) {
 	return typeof input === "object" && input !== null && "raw" in input;
 }
-
 //#endregion
 //#region src/root/functions/taggedTemplate/normaliseIndents.ts
 function calculateTabSize(line, whitespaceLength) {
@@ -1022,7 +994,6 @@ function normaliseIndents(first, ...args) {
 * @returns An additional function to invoke, or a new string with the strings and interpolations from the template applied, and extraneous indents removed.
 */
 const normalizeIndents = normaliseIndents;
-
 //#endregion
 //#region src/root/functions/miscellaneous/sayHello.ts
 /**
@@ -1136,7 +1107,6 @@ function sayHello() {
     I'll commit to you!
     `;
 }
-
 //#endregion
 //#region src/root/functions/miscellaneous/stringifyDotenv.ts
 /**
@@ -1172,7 +1142,6 @@ function stringifyDotenv(contents, options) {
 	}
 	return result;
 }
-
 //#endregion
 //#region src/root/functions/miscellaneous/stringListToArray.ts
 /**
@@ -1194,7 +1163,6 @@ function stringListToArray(stringList, { separator = ",", trimWhitespace = true
 		return item.trim();
 	}) : arrayList;
 }
-
 //#endregion
 //#region src/root/functions/miscellaneous/wait.ts
 /**
@@ -1213,7 +1181,6 @@ function wait(seconds) {
 		}, seconds * 1e3);
 	});
 }
-
 //#endregion
 //#region src/root/functions/objectHelpers/getRecordKeys.ts
 /**
@@ -1230,7 +1197,6 @@ function wait(seconds) {
 function getRecordKeys(record) {
 	return Object.keys(record);
 }
-
 //#endregion
 //#region src/root/functions/objectHelpers/omitProperties.ts
 /**
@@ -1253,7 +1219,6 @@ function omitProperties(object, keysToOmit) {
 	});
 	return outputObject;
 }
-
 //#endregion
 //#region src/root/functions/objectHelpers/removeUndefinedFromObject.ts
 /**
@@ -1268,7 +1233,6 @@ function removeUndefinedFromObject(object) {
 		return value !== void 0;
 	}));
 }
-
 //#endregion
 //#region src/root/functions/parsers/parseBoolean.ts
 /**
@@ -1287,7 +1251,6 @@ function parseBoolean(inputString) {
 	if (!["true", "false"].includes(normalisedString)) throw new DataError({ inputString }, "INVALID_BOOLEAN_STRING", "The provided boolean string must be one of `true | false`");
 	return normalisedString === "true";
 }
-
 //#endregion
 //#region src/root/functions/parsers/zod/_parseZodSchema.ts
 function _parseZodSchema(parsedResult, input, onError) {
@@ -1308,11 +1271,10 @@ function _parseZodSchema(parsedResult, input, onError) {
 			return secondCount - firstCount;
 		}).map(([code, count], _, allErrorCodes) => {
 			return allErrorCodes.length === 1 && count === 1 ? code : `${code}×${count}`;
-		}).join(","), `\n\n${z.prettifyError(parsedResult.error)}\n`);
+		}).join(","), `\n\n${z$1.prettifyError(parsedResult.error)}\n`);
 	}
 	return parsedResult.data;
 }
-
 //#endregion
 //#region src/root/functions/parsers/zod/parseZodSchema.ts
 /**
@@ -1336,7 +1298,6 @@ function _parseZodSchema(parsedResult, input, onError) {
 function parseZodSchema(schema, input, onError) {
 	return _parseZodSchema(schema.safeParse(input), input, onError);
 }
-
 //#endregion
 //#region src/root/functions/parsers/parseEnv.ts
 /**
@@ -1361,9 +1322,8 @@ const Env = {
 * @returns The specified environment if allowed.
 */
 function parseEnv(input) {
-	return parseZodSchema(z$1.enum(Env), input, new DataError({ input }, "INVALID_ENV", "The provided environment type must be one of `test | development | production`"));
+	return parseZodSchema(z.enum(Env), input, new DataError({ input }, "INVALID_ENV", "The provided environment type must be one of `test | development | production`"));
 }
-
 //#endregion
 //#region src/root/functions/parsers/parseFormData.ts
 /**
@@ -1386,7 +1346,6 @@ function parseFormData(formData, dataParser) {
 	if (dataParser) return dataParser(object);
 	return object;
 }
-
 //#endregion
 //#region src/root/functions/parsers/parseUUID.ts
 /**
@@ -1405,7 +1364,6 @@ function parseUUID(input) {
 	if (!UUID_REGEX.test(input)) throw new DataError({ input }, "INVALID_UUID", "The provided input does not match the expected shape for a UUID.");
 	return input;
 }
-
 //#endregion
 //#region src/root/functions/parsers/parseVersionType.ts
 /**
@@ -1430,9 +1388,8 @@ const VersionType = {
 * @returns The given version type if allowed.
 */
 function parseVersionType(input) {
-	return parseZodSchema(z.enum(VersionType), input, new DataError({ input }, "INVALID_VERSION_TYPE", "The provided version type must be one of `major | minor | patch`"));
+	return parseZodSchema(z$1.enum(VersionType), input, new DataError({ input }, "INVALID_VERSION_TYPE", "The provided version type must be one of `major | minor | patch`"));
 }
-
 //#endregion
 //#region src/root/functions/parsers/zod/parseZodSchemaAsync.ts
 /**
@@ -1454,7 +1411,6 @@ function parseVersionType(input) {
 async function parseZodSchemaAsync(schema, input, onError) {
 	return _parseZodSchema(await schema.safeParseAsync(input), input, onError);
 }
-
 //#endregion
 //#region src/root/functions/recursive/deepCopy.ts
 function callDeepCopy(input) {
@@ -1482,7 +1438,6 @@ function deepCopy(object) {
 	}
 	return clonedObject;
 }
-
 //#endregion
 //#region src/root/functions/security/encryptWithKey.ts
 /**
@@ -1503,7 +1458,6 @@ async function encryptWithKey(publicKey, plaintextValue) {
 		throw new DataError({ publicKey }, "ENCRYPTION_FAILED", "Encryption failed. Please double-check that the given key is a valid base 64 string.");
 	}
 }
-
 //#endregion
 //#region src/root/functions/stringHelpers/appendSemicolon.ts
 /**
@@ -1523,7 +1477,6 @@ function appendSemicolon(stringToAppendTo) {
 	if (stringWithNoTrailingWhitespace === "") return "";
 	return stringWithNoTrailingWhitespace[stringWithNoTrailingWhitespace.length - 1] === ";" ? stringWithNoTrailingWhitespace : `${stringWithNoTrailingWhitespace};`;
 }
-
 //#endregion
 //#region src/root/functions/stringHelpers/camelToKebab.ts
 /**
@@ -1562,7 +1515,6 @@ function camelToKebab(string, options = { preserveConsecutiveCapitals: true }) {
 	}
 	return result;
 }
-
 //#endregion
 //#region src/root/functions/stringHelpers/kebabToCamel.ts
 /**
@@ -1602,7 +1554,6 @@ function kebabToCamel(input, options) {
 	}
 	return outputString;
 }
-
 //#endregion
 //#region src/root/functions/stringHelpers/truncate.ts
 /**
@@ -1618,6 +1569,5 @@ function kebabToCamel(input, options) {
 function truncate(stringToTruncate, maxLength = 5) {
 	return stringToTruncate.length > maxLength ? `${stringToTruncate.slice(0, maxLength)}...` : stringToTruncate;
 }
-
 //#endregion
-export { APIError, DataError, Env, FILE_PATH_PATTERN, FILE_PATH_REGEX, ONE_DAY_IN_MILLISECONDS, UUID_PATTERN, UUID_REGEX, VERSION_NUMBER_PATTERN, VERSION_NUMBER_REGEX, VersionNumber, VersionType, addDaysToDate, appendSemicolon, calculateMonthlyDifference, camelToKebab, convertFileToBase64, createFormData, createTemplateStringsArray, deepCopy, deepFreeze, encryptWithKey, 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, truncate, wait, zodVersionNumber };
+export { APIError, DataError, Env, FILE_PATH_PATTERN, FILE_PATH_REGEX, ONE_DAY_IN_MILLISECONDS, UUID_PATTERN, UUID_REGEX, VERSION_NUMBER_PATTERN, VERSION_NUMBER_REGEX, VersionNumber, VersionType, addDaysToDate, appendSemicolon, calculateMonthlyDifference, camelToKebab, convertFileToBase64, createFormData, createTemplateStringsArray, deepCopy, deepFreeze, encryptWithKey, 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, truncate, wait, zodVersionNumber };