@alextheman/utility 5.19.2 → 5.21.0

package/dist/index.js

@@ -91,7 +91,7 @@ var CodeError = class CodeError extends Error {
 	*/
 	static check(input) {
 		if (input instanceof CodeError) return true;
-		return typeof input === "object" && input !== null && "message" in input && typeof input.message === "string" && "code" in input && typeof input.code === "string";
+		return containsKeys(input, ["message", "code"]) && typeof input.message === "string" && typeof input.code === "string";
 	}
 	static checkCaughtError(error, options) {
 		if (this.check(error)) {
@@ -204,7 +204,11 @@ var DataError$1 = class DataError$1 extends CodeError {
 	*/
 	static check(input) {
 		if (input instanceof DataError$1) return true;
-		return typeof input === "object" && input !== null && "message" in input && typeof input.message === "string" && "code" in input && typeof input.code === "string" && "data" in input && typeof input.data === "object" && input.data !== null;
+		return containsKeys(input, [
+			"data",
+			"code",
+			"message"
+		]) && typeof input.message === "string" && typeof input.code === "string" && isNonNullableObject(input.data);
 	}
 	/**
 	* Check a `DataError` against its error code
@@ -301,6 +305,107 @@ function range(start, stop, step = 1) {
 	return numbers;
 }
 //#endregion
+//#region src/root/functions/typeAssertions/assertNotNull.ts
+/**
+* Asserts that a given input is not `null`, and throws a DataError if it does.
+*
+* If no error is thrown from this, the input type gets narrowed down to not include `null`.
+*
+* @category Type Assertions
+*
+* @template InputType The type of the input.
+*
+* @param input - The input to assert against
+*
+* @throws {DataError} If the input is `null`.
+*/
+function assertNotNull(input) {
+	if (input === null) throw new DataError$1({ input }, "NULL_INPUT", "Expected the input not to be null");
+}
+//#endregion
+//#region src/root/functions/typeAssertions/assertNotNullable.ts
+/**
+* Asserts that a given input is not `undefined` or `null`, and throws a DataError if it does.
+*
+* If no error is thrown from this, the input type gets narrowed down to not include `undefined` or `null`.
+*
+* @category Type Assertions
+*
+* @template InputType The type of the input.
+*
+* @param input - The input to assert against.
+*
+* @throws {DataError} If the input is `undefined` or `null`.
+*/
+function assertNotNullable(input) {
+	if (input === null || input === void 0) throw new DataError$1({ input }, "NULLABLE_INPUT", "Expected the input not to be undefined or null");
+}
+//#endregion
+//#region src/root/functions/typeAssertions/assertNotUndefined.ts
+/**
+* Asserts that a given input is not `undefined`, and throws a DataError if it does.
+*
+* If no error is thrown from this, the input type gets narrowed down to not include `undefined`.
+*
+* @category Type Assertions
+*
+* @template InputType The type of the input.
+*
+* @param input - The input to assert against.
+*
+* @throws {DataError} If the input is `undefined`.
+*/
+function assertNotUndefined(input) {
+	if (input === void 0) throw new DataError$1({ input }, "UNDEFINED_INPUT", "Expected the input not to be undefined");
+}
+//#endregion
+//#region src/root/functions/typeAssertions/isNonNullableObject.ts
+/**
+* Determines if the given input is a non-nullable object, narrowing the type down as such if it is
+*
+* @category Type Assertions
+*
+* @param input - The input to check
+*
+* @returns `true` if the input is a non-nullable object, and `false` otherwise. The input type will also be narrowed down to be a non-nullable object.
+*/
+function isNonNullableObject(input) {
+	return typeof input === "object" && input !== null;
+}
+//#endregion
+//#region src/root/functions/typeAssertions/objectContainsKeys.ts
+/**
+* Determines if the given object contains all of the keys provided.
+*
+* @category Type Assertions
+*
+* @param input - The input object to check.
+* @param keys - The keys expected to be in the input object.
+*
+* @returns `true` if the input object contains all provided keys, and `false` otherwise. The input type will also be narrowed down to be a record with the provided keys with an unknown value type.
+*/
+function objectContainsKeys(input, keys) {
+	const expectedKeys = Array.isArray(keys) ? keys : [keys];
+	if (expectedKeys.length === 0) return false;
+	for (const key of expectedKeys) if (!(key in input)) return false;
+	return true;
+}
+//#endregion
+//#region src/root/functions/typeAssertions/containsKeys.ts
+/**
+* Determines if the given input is a non-nullable object, and if that object contains all of the keys provided.
+*
+* @category Type Assertions
+*
+* @param input - The input to check.
+* @param keys - The keys expected to be in the input if it's an object.
+*
+* @returns `true` if the input is an object containing all provided keys, and `false` otherwise. The input type will also be narrowed down to be a record with the provided keys, each with an unknown value type.
+*/
+function containsKeys(input, keys) {
+	return isNonNullableObject(input) && objectContainsKeys(input, keys);
+}
+//#endregion
 //#region src/root/functions/arrayHelpers/fillArray.ts
 /**
 * Creates a new array where each element is the result of the provided callback.
@@ -328,7 +433,7 @@ function fillArray(callback, length = 1, options) {
 		return callback(index);
 	});
 	if (outputArray.some((item) => {
-		return item instanceof Promise || typeof item === "object" && item !== null && "then" in item && typeof item.then === "function";
+		return item instanceof Promise || containsKeys(item, "then") && typeof item.then === "function";
 	})) return Promise.all(outputArray);
 	return outputArray;
 }
@@ -629,7 +734,7 @@ function convertFileToBase64(file) {
 //#endregion
 //#region src/root/functions/miscellaneous/createFormData.ts
 function getNullableResolutionStrategy(key, strategy) {
-	return (typeof strategy === "object" ? strategy[key] : strategy) ?? "empty";
+	return (isNonNullableObject(strategy) ? strategy[key] : strategy) ?? "empty";
 }
 function isPrimitive(item) {
 	return typeof item === "string" || typeof item === "number" || typeof item === "boolean";
@@ -698,6 +803,20 @@ function createFormData(data, options = {
 	return formData;
 }
 //#endregion
+//#region src/root/functions/miscellaneous/identity.ts
+/**
+* Gives back the original input.
+*
+* @template InputType - The input type.
+*
+* @param input - The input value.
+*
+* @returns The original input value.
+*/
+function identity(input) {
+	return input;
+}
+//#endregion
 //#region src/root/functions/miscellaneous/isOrdered.ts
 /**
 * Checks to see if the given array is sorted in ascending order.
@@ -828,6 +947,33 @@ I'll commit to you!
     `;
 }
 //#endregion
+//#region src/root/functions/miscellaneous/sortBy.ts
+/**
+* Provides a function to pass to the `sort` or `toSorted` methods on arrays, which will allow those methods to sort the items by the chosen value in the chosen direction.
+*
+* @template ItemType - The type of each array item.
+* @template SortValue - The type of the value to sort by.
+*
+* @param selector - A function that takes the item and returns the value to sort by.
+* @param direction - The sort direction.
+*
+* @returns A function to pass into the `.sort()` or `.toSorted()` methods on arrays.
+*/
+function sortBy(selector, direction = "asc") {
+	return (first, second) => {
+		const firstValue = selector(first);
+		const secondValue = selector(second);
+		if (firstValue instanceof Date && secondValue instanceof Date) {
+			const firstTime = firstValue.getTime();
+			const secondTime = secondValue.getTime();
+			return direction === "asc" ? firstTime - secondTime : secondTime - firstTime;
+		}
+		if (firstValue < secondValue) return direction === "asc" ? -1 : 1;
+		if (firstValue > secondValue) return direction === "asc" ? 1 : -1;
+		return 0;
+	};
+}
+//#endregion
 //#region src/root/functions/miscellaneous/stringifyDotenv.ts
 /**
 * Converts an object into a string in .env file format.
@@ -972,6 +1118,12 @@ function parseBoolean(inputString) {
 	return normalisedString === "true";
 }
 //#endregion
+//#region src/root/types/SortDirection.ts
+const SortDirection = {
+	DESC: "desc",
+	ASC: "asc"
+};
+//#endregion
 //#region src/root/types/VersionNumber.ts
 /**
 * Represents a software version number, considered to be made up of a major, minor, and patch part.
@@ -1330,7 +1482,7 @@ function parseVersionType(input) {
 //#endregion
 //#region src/root/functions/recursive/deepCopy.ts
 function callDeepCopy(input) {
-	return typeof input === "object" && input !== null ? deepCopy(input) : input;
+	return isNonNullableObject(input) ? deepCopy(input) : input;
 }
 /**
 * Deeply copies an object or array such that all child objects/arrays are also copied.
@@ -1649,7 +1801,7 @@ function interpolateObjects(strings, ...interpolations) {
 * @returns `true` if the input is a valid `TemplateStringsArray`, and false otherwise. The type of the input will also be narrowed down to `TemplateStringsArray` if `true`.
 */
 function isTemplateStringsArray(input) {
-	return typeof input === "object" && input !== null && "raw" in input;
+	return containsKeys(input, "raw");
 }
 //#endregion
 //#region src/root/functions/taggedTemplate/normaliseIndents.ts
@@ -1704,7 +1856,7 @@ function reduceLines(lines, { preserveTabs = true }) {
 * @returns An additional function to invoke, or a new string with the strings and interpolations from the template applied, and extraneous indents removed.
 */
 function normaliseIndents(first, ...args) {
-	if (typeof first === "object" && first !== null && !Array.isArray(first)) {
+	if (isNonNullableObject(first) && !Array.isArray(first)) {
 		const options = first;
 		return (strings, ...interpolations) => {
 			return normaliseIndents(strings, ...interpolations, options);
@@ -1831,52 +1983,4 @@ var DataError = class DataError extends Error {
 	}
 };
 //#endregion
-//#region src/root/errors/assertNotNull.ts
-/**
-* Asserts that a given input is not `null`, and throws a DataError if it does.
-*
-* If no error is thrown from this, the input type gets narrowed down to not include `null`.
-*
-* @template InputType The type of the input.
-*
-* @param input - The input to assert against
-*
-* @throws {DataError} If the input is `null`.
-*/
-function assertNotNull(input) {
-	if (input === null) throw new DataError$1({ input }, "NULL_INPUT", "Expected the input not to be null");
-}
-//#endregion
-//#region src/root/errors/assertNotNullable.ts
-/**
-* Asserts that a given input is not `undefined` or `null`, and throws a DataError if it does.
-*
-* If no error is thrown from this, the input type gets narrowed down to not include `undefined` or `null`.
-*
-* @template InputType The type of the input.
-*
-* @param input - The input to assert against.
-*
-* @throws {DataError} If the input is `undefined` or `null`.
-*/
-function assertNotNullable(input) {
-	if (input === null || input === void 0) throw new DataError$1({ input }, "NULLABLE_INPUT", "Expected the input not to be undefined or null");
-}
-//#endregion
-//#region src/root/errors/assertNotUndefined.ts
-/**
-* Asserts that a given input is not `undefined`, and throws a DataError if it does.
-*
-* If no error is thrown from this, the input type gets narrowed down to not include `undefined`.
-*
-* @template InputType The type of the input.
-*
-* @param input - The input to assert against.
-*
-* @throws {DataError} If the input is `undefined`.
-*/
-function assertNotUndefined(input) {
-	if (input === void 0) throw new DataError$1({ input }, "UNDEFINED_INPUT", "Expected the input not to be undefined");
-}
-//#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, assertNotNull, assertNotNullable, assertNotUndefined, az, calculateMonthlyDifference, camelToKebab, convertFileToBase64, createFormData, createTemplateStringsArray, deepCopy, deepFreeze, escapeRegexPattern, fillArray, formatDateAndTime, getRandomNumber, getRecordKeys, getStringsAndInterpolations, httpErrorCodeLookup, interpolate, interpolateObjects, isAnniversary, isLeapYear, isMonthlyMultiple, isOrdered, isSameDate, isTemplateStringsArray, kebabToCamel, normaliseIndents, normalizeIndents, omitProperties, paralleliseArrays, parseBoolean, parseEnv, parseFormData, parseIntStrict, parseUUID, parseVersionType, parseZodSchema, parseZodSchemaAsync, randomiseArray, range, removeDuplicates, removeUndefinedFromObject, sayHello, stringListToArray, stringifyDotenv, toTitleCase, truncate, wait, zodVersionNumber };
+export { APIError, DataError, Env, FILE_PATH_PATTERN, FILE_PATH_REGEX, ONE_DAY_IN_MILLISECONDS, SortDirection, UUID_PATTERN, UUID_REGEX, VERSION_NUMBER_PATTERN, VERSION_NUMBER_REGEX, VersionNumber, VersionType, addDaysToDate, appendSemicolon, assertNotNull, assertNotNullable, assertNotUndefined, az, calculateMonthlyDifference, camelToKebab, containsKeys, convertFileToBase64, createFormData, createTemplateStringsArray, deepCopy, deepFreeze, escapeRegexPattern, fillArray, formatDateAndTime, getRandomNumber, getRecordKeys, getStringsAndInterpolations, httpErrorCodeLookup, identity, interpolate, interpolateObjects, isAnniversary, isLeapYear, isMonthlyMultiple, isNonNullableObject, isOrdered, isSameDate, isTemplateStringsArray, kebabToCamel, normaliseIndents, normalizeIndents, objectContainsKeys, omitProperties, paralleliseArrays, parseBoolean, parseEnv, parseFormData, parseIntStrict, parseUUID, parseVersionType, parseZodSchema, parseZodSchemaAsync, randomiseArray, range, removeDuplicates, removeUndefinedFromObject, sayHello, sortBy, stringListToArray, stringifyDotenv, toTitleCase, truncate, wait, zodVersionNumber };

package/dist/internal/index.cjs

@@ -69,7 +69,7 @@ var CodeError = class CodeError extends Error {
 	*/
 	static check(input) {
 		if (input instanceof CodeError) return true;
-		return typeof input === "object" && input !== null && "message" in input && typeof input.message === "string" && "code" in input && typeof input.code === "string";
+		return containsKeys(input, ["message", "code"]) && typeof input.message === "string" && typeof input.code === "string";
 	}
 	static checkCaughtError(error, options) {
 		if (this.check(error)) {
@@ -182,7 +182,11 @@ var DataError = class DataError extends CodeError {
 	*/
 	static check(input) {
 		if (input instanceof DataError) return true;
-		return typeof input === "object" && input !== null && "message" in input && typeof input.message === "string" && "code" in input && typeof input.code === "string" && "data" in input && typeof input.data === "object" && input.data !== null;
+		return containsKeys(input, [
+			"data",
+			"code",
+			"message"
+		]) && typeof input.message === "string" && typeof input.code === "string" && isNonNullableObject(input.data);
 	}
 	/**
 	* Check a `DataError` against its error code
@@ -240,6 +244,49 @@ var DataError = class DataError extends CodeError {
 	}
 };
 //#endregion
+//#region src/root/functions/parsers/parseIntStrict.ts
+/**
+* Converts a string to an integer and throws an error if it cannot be converted.
+*
+* @category Parsers
+*
+* @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 {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();
+	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(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.replace(/^[+-]/, "")].some((character) => {
+		return parseInt(character) >= radix;
+	})) throw new DataError({
+		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 new DataError({ string }, "INTEGER_PARSING_ERROR", "Value is not a valid integer.");
+	return parseIntResult;
+}
+//#endregion
+//#region src/root/functions/parsers/parseVersionType.ts
+/**
+* Represents the three common software version types.
+*
+* @category Types
+*/
+const VersionType = {
+	MAJOR: "major",
+	MINOR: "minor",
+	PATCH: "patch"
+};
+//#endregion
 //#region src/root/functions/arrayHelpers/range.ts
 /**
 * Creates an array of numbers within a given range.
@@ -279,6 +326,53 @@ function range(start, stop, step = 1) {
 	return numbers;
 }
 //#endregion
+//#region src/root/functions/typeAssertions/isNonNullableObject.ts
+/**
+* Determines if the given input is a non-nullable object, narrowing the type down as such if it is
+*
+* @category Type Assertions
+*
+* @param input - The input to check
+*
+* @returns `true` if the input is a non-nullable object, and `false` otherwise. The input type will also be narrowed down to be a non-nullable object.
+*/
+function isNonNullableObject(input) {
+	return typeof input === "object" && input !== null;
+}
+//#endregion
+//#region src/root/functions/typeAssertions/objectContainsKeys.ts
+/**
+* Determines if the given object contains all of the keys provided.
+*
+* @category Type Assertions
+*
+* @param input - The input object to check.
+* @param keys - The keys expected to be in the input object.
+*
+* @returns `true` if the input object contains all provided keys, and `false` otherwise. The input type will also be narrowed down to be a record with the provided keys with an unknown value type.
+*/
+function objectContainsKeys(input, keys) {
+	const expectedKeys = Array.isArray(keys) ? keys : [keys];
+	if (expectedKeys.length === 0) return false;
+	for (const key of expectedKeys) if (!(key in input)) return false;
+	return true;
+}
+//#endregion
+//#region src/root/functions/typeAssertions/containsKeys.ts
+/**
+* Determines if the given input is a non-nullable object, and if that object contains all of the keys provided.
+*
+* @category Type Assertions
+*
+* @param input - The input to check.
+* @param keys - The keys expected to be in the input if it's an object.
+*
+* @returns `true` if the input is an object containing all provided keys, and `false` otherwise. The input type will also be narrowed down to be a record with the provided keys, each with an unknown value type.
+*/
+function containsKeys(input, keys) {
+	return isNonNullableObject(input) && objectContainsKeys(input, keys);
+}
+//#endregion
 //#region src/root/functions/arrayHelpers/fillArray.ts
 /**
 * Creates a new array where each element is the result of the provided callback.
@@ -306,7 +400,7 @@ function fillArray(callback, length = 1, options) {
 		return callback(index);
 	});
 	if (outputArray.some((item) => {
-		return item instanceof Promise || typeof item === "object" && item !== null && "then" in item && typeof item.then === "function";
+		return item instanceof Promise || containsKeys(item, "then") && typeof item.then === "function";
 	})) return Promise.all(outputArray);
 	return outputArray;
 }
@@ -334,49 +428,6 @@ function paralleliseArrays(firstArray, secondArray) {
 	return outputArray;
 }
 //#endregion
-//#region src/root/functions/parsers/parseIntStrict.ts
-/**
-* Converts a string to an integer and throws an error if it cannot be converted.
-*
-* @category Parsers
-*
-* @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 {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();
-	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(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.replace(/^[+-]/, "")].some((character) => {
-		return parseInt(character) >= radix;
-	})) throw new DataError({
-		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 new DataError({ string }, "INTEGER_PARSING_ERROR", "Value is not a valid integer.");
-	return parseIntResult;
-}
-//#endregion
-//#region src/root/functions/parsers/parseVersionType.ts
-/**
-* Represents the three common software version types.
-*
-* @category Types
-*/
-const VersionType = {
-	MAJOR: "major",
-	MINOR: "minor",
-	PATCH: "patch"
-};
-//#endregion
 //#region src/root/functions/taggedTemplate/interpolate.ts
 /**
 * Returns the result of interpolating a template string when given the strings and interpolations separately.
@@ -456,7 +507,7 @@ function reduceLines(lines, { preserveTabs = true }) {
 * @returns An additional function to invoke, or a new string with the strings and interpolations from the template applied, and extraneous indents removed.
 */
 function normaliseIndents(first, ...args) {
-	if (typeof first === "object" && first !== null && !Array.isArray(first)) {
+	if (isNonNullableObject(first) && !Array.isArray(first)) {
 		const options = first;
 		return (strings, ...interpolations) => {
 			return normaliseIndents(strings, ...interpolations, options);

package/dist/internal/index.js

@@ -44,7 +44,7 @@ var CodeError = class CodeError extends Error {
 	*/
 	static check(input) {
 		if (input instanceof CodeError) return true;
-		return typeof input === "object" && input !== null && "message" in input && typeof input.message === "string" && "code" in input && typeof input.code === "string";
+		return containsKeys(input, ["message", "code"]) && typeof input.message === "string" && typeof input.code === "string";
 	}
 	static checkCaughtError(error, options) {
 		if (this.check(error)) {
@@ -157,7 +157,11 @@ var DataError = class DataError extends CodeError {
 	*/
 	static check(input) {
 		if (input instanceof DataError) return true;
-		return typeof input === "object" && input !== null && "message" in input && typeof input.message === "string" && "code" in input && typeof input.code === "string" && "data" in input && typeof input.data === "object" && input.data !== null;
+		return containsKeys(input, [
+			"data",
+			"code",
+			"message"
+		]) && typeof input.message === "string" && typeof input.code === "string" && isNonNullableObject(input.data);
 	}
 	/**
 	* Check a `DataError` against its error code
@@ -215,6 +219,49 @@ var DataError = class DataError extends CodeError {
 	}
 };
 //#endregion
+//#region src/root/functions/parsers/parseIntStrict.ts
+/**
+* Converts a string to an integer and throws an error if it cannot be converted.
+*
+* @category Parsers
+*
+* @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 {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();
+	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(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.replace(/^[+-]/, "")].some((character) => {
+		return parseInt(character) >= radix;
+	})) throw new DataError({
+		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 new DataError({ string }, "INTEGER_PARSING_ERROR", "Value is not a valid integer.");
+	return parseIntResult;
+}
+//#endregion
+//#region src/root/functions/parsers/parseVersionType.ts
+/**
+* Represents the three common software version types.
+*
+* @category Types
+*/
+const VersionType = {
+	MAJOR: "major",
+	MINOR: "minor",
+	PATCH: "patch"
+};
+//#endregion
 //#region src/root/functions/arrayHelpers/range.ts
 /**
 * Creates an array of numbers within a given range.
@@ -254,6 +301,53 @@ function range(start, stop, step = 1) {
 	return numbers;
 }
 //#endregion
+//#region src/root/functions/typeAssertions/isNonNullableObject.ts
+/**
+* Determines if the given input is a non-nullable object, narrowing the type down as such if it is
+*
+* @category Type Assertions
+*
+* @param input - The input to check
+*
+* @returns `true` if the input is a non-nullable object, and `false` otherwise. The input type will also be narrowed down to be a non-nullable object.
+*/
+function isNonNullableObject(input) {
+	return typeof input === "object" && input !== null;
+}
+//#endregion
+//#region src/root/functions/typeAssertions/objectContainsKeys.ts
+/**
+* Determines if the given object contains all of the keys provided.
+*
+* @category Type Assertions
+*
+* @param input - The input object to check.
+* @param keys - The keys expected to be in the input object.
+*
+* @returns `true` if the input object contains all provided keys, and `false` otherwise. The input type will also be narrowed down to be a record with the provided keys with an unknown value type.
+*/
+function objectContainsKeys(input, keys) {
+	const expectedKeys = Array.isArray(keys) ? keys : [keys];
+	if (expectedKeys.length === 0) return false;
+	for (const key of expectedKeys) if (!(key in input)) return false;
+	return true;
+}
+//#endregion
+//#region src/root/functions/typeAssertions/containsKeys.ts
+/**
+* Determines if the given input is a non-nullable object, and if that object contains all of the keys provided.
+*
+* @category Type Assertions
+*
+* @param input - The input to check.
+* @param keys - The keys expected to be in the input if it's an object.
+*
+* @returns `true` if the input is an object containing all provided keys, and `false` otherwise. The input type will also be narrowed down to be a record with the provided keys, each with an unknown value type.
+*/
+function containsKeys(input, keys) {
+	return isNonNullableObject(input) && objectContainsKeys(input, keys);
+}
+//#endregion
 //#region src/root/functions/arrayHelpers/fillArray.ts
 /**
 * Creates a new array where each element is the result of the provided callback.
@@ -281,7 +375,7 @@ function fillArray(callback, length = 1, options) {
 		return callback(index);
 	});
 	if (outputArray.some((item) => {
-		return item instanceof Promise || typeof item === "object" && item !== null && "then" in item && typeof item.then === "function";
+		return item instanceof Promise || containsKeys(item, "then") && typeof item.then === "function";
 	})) return Promise.all(outputArray);
 	return outputArray;
 }
@@ -309,49 +403,6 @@ function paralleliseArrays(firstArray, secondArray) {
 	return outputArray;
 }
 //#endregion
-//#region src/root/functions/parsers/parseIntStrict.ts
-/**
-* Converts a string to an integer and throws an error if it cannot be converted.
-*
-* @category Parsers
-*
-* @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 {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();
-	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(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.replace(/^[+-]/, "")].some((character) => {
-		return parseInt(character) >= radix;
-	})) throw new DataError({
-		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 new DataError({ string }, "INTEGER_PARSING_ERROR", "Value is not a valid integer.");
-	return parseIntResult;
-}
-//#endregion
-//#region src/root/functions/parsers/parseVersionType.ts
-/**
-* Represents the three common software version types.
-*
-* @category Types
-*/
-const VersionType = {
-	MAJOR: "major",
-	MINOR: "minor",
-	PATCH: "patch"
-};
-//#endregion
 //#region src/root/functions/taggedTemplate/interpolate.ts
 /**
 * Returns the result of interpolating a template string when given the strings and interpolations separately.
@@ -431,7 +482,7 @@ function reduceLines(lines, { preserveTabs = true }) {
 * @returns An additional function to invoke, or a new string with the strings and interpolations from the template applied, and extraneous indents removed.
 */
 function normaliseIndents(first, ...args) {
-	if (typeof first === "object" && first !== null && !Array.isArray(first)) {
+	if (isNonNullableObject(first) && !Array.isArray(first)) {
 		const options = first;
 		return (strings, ...interpolations) => {
 			return normaliseIndents(strings, ...interpolations, options);