@alextheman/utility 5.16.0 → 5.17.0

package/dist/index.cjs

@@ -1871,6 +1871,38 @@ 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
 exports.APIError = APIError;
 exports.DataError = DataError;
 exports.Env = Env;
@@ -1886,6 +1918,8 @@ exports.VersionType = VersionType;
 exports.addDaysToDate = addDaysToDate;
 exports.appendSemicolon = appendSemicolon;
 exports.assertNotNull = assertNotNull;
+exports.assertNotNullable = assertNotNullable;
+exports.assertNotUndefined = assertNotUndefined;
 exports.az = az;
 exports.calculateMonthlyDifference = calculateMonthlyDifference;
 exports.camelToKebab = camelToKebab;

package/dist/index.d.cts

@@ -1137,6 +1137,34 @@ type OptionalOnCondition<Condition extends boolean, ResolvedTypeIfTrue> = Condit
  */
 declare function assertNotNull<InputType>(input: InputType): asserts input is NonNull<InputType>;
 //#endregion
+//#region src/root/errors/assertNotNullable.d.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`.
+ */
+declare function assertNotNullable<InputType>(input: InputType): asserts input is NonNullable<InputType>;
+//#endregion
+//#region src/root/errors/assertNotUndefined.d.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`.
+ */
+declare function assertNotUndefined<InputType>(input: InputType): asserts input is NonUndefined<InputType>;
+//#endregion
 //#region src/v6/CodeError.d.ts
 interface ExpectErrorOptions<ErrorCode extends string = string> {
   expectedCode?: ErrorCode;
@@ -1340,4 +1368,4 @@ declare const az: {
   };
 };
 //#endregion
-export { APIError, type ArrayElement, type CallReturnType, CamelToKebabOptions, type CreateEnumType, type CreateFormDataOptions, type CreateFormDataOptionsNullableResolution, type CreateFormDataOptionsUndefinedOrNullResolution, DataError, type DisallowUndefined, Env, FILE_PATH_PATTERN, FILE_PATH_REGEX, type FormDataArrayResolutionStrategy, type FormDataNullableResolutionStrategy, type HTTPErrorCode, type IgnoreCase, type IsTypeArgumentString, KebabToCamelOptions, type NonNull, type NonUndefined, NormaliseIndentsFunction, NormaliseIndentsOptions, NormalizeIndentsFunction, NormalizeIndentsOptions, type NullableOnCondition, ONE_DAY_IN_MILLISECONDS, type OptionalOnCondition, ParallelTuple, RecordKey, RemoveUndefined, type StringListToArrayOptions, ToTitleCaseOptions, UUID_PATTERN, UUID_REGEX, VERSION_NUMBER_PATTERN, VERSION_NUMBER_REGEX, VersionNumber, type FormatOptionsBase as VersionNumberToStringOptions, VersionType, addDaysToDate, appendSemicolon, assertNotNull, 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, type ArrayElement, type CallReturnType, CamelToKebabOptions, type CreateEnumType, type CreateFormDataOptions, type CreateFormDataOptionsNullableResolution, type CreateFormDataOptionsUndefinedOrNullResolution, DataError, type DisallowUndefined, Env, FILE_PATH_PATTERN, FILE_PATH_REGEX, type FormDataArrayResolutionStrategy, type FormDataNullableResolutionStrategy, type HTTPErrorCode, type IgnoreCase, type IsTypeArgumentString, KebabToCamelOptions, type NonNull, type NonUndefined, NormaliseIndentsFunction, NormaliseIndentsOptions, NormalizeIndentsFunction, NormalizeIndentsOptions, type NullableOnCondition, ONE_DAY_IN_MILLISECONDS, type OptionalOnCondition, ParallelTuple, RecordKey, RemoveUndefined, type StringListToArrayOptions, ToTitleCaseOptions, UUID_PATTERN, UUID_REGEX, VERSION_NUMBER_PATTERN, VERSION_NUMBER_REGEX, VersionNumber, type FormatOptionsBase as VersionNumberToStringOptions, VersionType, addDaysToDate, appendSemicolon, 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 };

package/dist/index.d.ts

@@ -1137,6 +1137,34 @@ type OptionalOnCondition<Condition extends boolean, ResolvedTypeIfTrue> = Condit
  */
 declare function assertNotNull<InputType>(input: InputType): asserts input is NonNull<InputType>;
 //#endregion
+//#region src/root/errors/assertNotNullable.d.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`.
+ */
+declare function assertNotNullable<InputType>(input: InputType): asserts input is NonNullable<InputType>;
+//#endregion
+//#region src/root/errors/assertNotUndefined.d.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`.
+ */
+declare function assertNotUndefined<InputType>(input: InputType): asserts input is NonUndefined<InputType>;
+//#endregion
 //#region src/v6/CodeError.d.ts
 interface ExpectErrorOptions<ErrorCode extends string = string> {
   expectedCode?: ErrorCode;
@@ -1340,4 +1368,4 @@ declare const az: {
   };
 };
 //#endregion
-export { APIError, type ArrayElement, type CallReturnType, CamelToKebabOptions, type CreateEnumType, type CreateFormDataOptions, type CreateFormDataOptionsNullableResolution, type CreateFormDataOptionsUndefinedOrNullResolution, DataError, type DisallowUndefined, Env, FILE_PATH_PATTERN, FILE_PATH_REGEX, type FormDataArrayResolutionStrategy, type FormDataNullableResolutionStrategy, type HTTPErrorCode, type IgnoreCase, type IsTypeArgumentString, KebabToCamelOptions, type NonNull, type NonUndefined, NormaliseIndentsFunction, NormaliseIndentsOptions, NormalizeIndentsFunction, NormalizeIndentsOptions, type NullableOnCondition, ONE_DAY_IN_MILLISECONDS, type OptionalOnCondition, ParallelTuple, RecordKey, RemoveUndefined, type StringListToArrayOptions, ToTitleCaseOptions, UUID_PATTERN, UUID_REGEX, VERSION_NUMBER_PATTERN, VERSION_NUMBER_REGEX, VersionNumber, type FormatOptionsBase as VersionNumberToStringOptions, VersionType, addDaysToDate, appendSemicolon, assertNotNull, 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, type ArrayElement, type CallReturnType, CamelToKebabOptions, type CreateEnumType, type CreateFormDataOptions, type CreateFormDataOptionsNullableResolution, type CreateFormDataOptionsUndefinedOrNullResolution, DataError, type DisallowUndefined, Env, FILE_PATH_PATTERN, FILE_PATH_REGEX, type FormDataArrayResolutionStrategy, type FormDataNullableResolutionStrategy, type HTTPErrorCode, type IgnoreCase, type IsTypeArgumentString, KebabToCamelOptions, type NonNull, type NonUndefined, NormaliseIndentsFunction, NormaliseIndentsOptions, NormalizeIndentsFunction, NormalizeIndentsOptions, type NullableOnCondition, ONE_DAY_IN_MILLISECONDS, type OptionalOnCondition, ParallelTuple, RecordKey, RemoveUndefined, type StringListToArrayOptions, ToTitleCaseOptions, UUID_PATTERN, UUID_REGEX, VERSION_NUMBER_PATTERN, VERSION_NUMBER_REGEX, VersionNumber, type FormatOptionsBase as VersionNumberToStringOptions, VersionType, addDaysToDate, appendSemicolon, 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 };

package/dist/index.js

@@ -1847,4 +1847,36 @@ function assertNotNull(input) {
 	if (input === null) throw new DataError$1({ input }, "NULL_INPUT", "Expected the input not to be null");
 }
 //#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, 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 };
+//#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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alextheman/utility",
-  "version": "5.16.0",
+  "version": "5.17.0",
   "description": "Helpful utility functions.",
   "repository": {
     "type": "git",
@@ -37,34 +37,37 @@
   ],
   "dependencies": {
     "dotenv": "17.4.2",
-    "execa": "9.6.1",
-    "zod": "4.3.6"
+    "execa": "9.6.1"
   },
   "devDependencies": {
-    "@alextheman/eslint-plugin": "5.13.1",
+    "@alextheman/eslint-plugin": "5.14.0",
     "@types/node": "25.6.0",
-    "alex-c-line": "2.7.1",
+    "alex-c-line": "2.7.2",
     "cross-env": "10.1.0",
     "dotenv-cli": "11.0.0",
-    "eslint": "10.2.1",
-    "globals": "17.5.0",
+    "eslint": "10.3.0",
+    "globals": "17.6.0",
     "husky": "9.1.7",
-    "jsdom": "29.0.2",
+    "jsdom": "29.1.1",
     "prettier": "3.8.3",
     "tempy": "3.2.0",
-    "tsdown": "0.21.9",
+    "tsdown": "0.21.10",
     "tsx": "4.21.0",
     "typedoc": "0.28.19",
     "typedoc-plugin-markdown": "4.11.0",
     "typedoc-rhineai-theme": "1.2.0",
     "typescript": "6.0.3",
-    "typescript-eslint": "8.59.0",
+    "typescript-eslint": "8.59.1",
     "vite": "8.0.10",
-    "vitest": "4.1.5"
+    "vitest": "4.1.5",
+    "zod": "4.4.2"
   },
   "engines": {
     "node": ">=22.3.0"
   },
+  "peerDependencies": {
+    "zod": ">=4.0.0"
+  },
   "scripts": {
     "build": "tsdown",
     "build-configs": "tsdown --config tsdown.configs.config.ts",