@alextheman/utility 1.25.0 → 2.1.0

package/dist/index.cjs

@@ -41,26 +41,6 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-var __async = (__this, __arguments, generator) => {
-  return new Promise((resolve, reject) => {
-    var fulfilled = (value) => {
-      try {
-        step(generator.next(value));
-      } catch (e) {
-        reject(e);
-      }
-    };
-    var rejected = (value) => {
-      try {
-        step(generator.throw(value));
-      } catch (e) {
-        reject(e);
-      }
-    };
-    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
-    step((generator = generator.apply(__this, __arguments)).next());
-  });
-};
 
 // src/index.ts
 var index_exports = {};
@@ -70,7 +50,6 @@ __export(index_exports, {
   appendSemicolon: () => appendSemicolon_default,
   convertFileToBase64: () => convertFileToBase64_default,
   fillArray: () => fillArray_default,
-  fillArrayAsync: () => fillArrayAsync_default,
   formatDateAndTime: () => formatDateAndTime_default,
   getRandomNumber: () => getRandomNumber_default,
   httpErrorCodeLookup: () => httpErrorCodeLookup,
@@ -81,11 +60,12 @@ __export(index_exports, {
   omitProperties: () => omitProperties_default,
   parseEmail: () => Email_default,
   parseEnv: () => Env_default,
+  parseIntStrict: () => parseIntStrict_default,
   parseUUID: () => UUID_default,
   randomiseArray: () => randomiseArray_default,
   range: () => range_default,
+  stringToBoolean: () => stringToBoolean_default,
   truncate: () => truncate_default,
-  validateUUID: () => validateUUID_default,
   wait: () => wait_default
 });
 module.exports = __toCommonJS(index_exports);
@@ -145,18 +125,6 @@ function fillArray(callback, length = 1) {
 }
 var fillArray_default = fillArray;
 
-// src/functions/fillArrayAsync.ts
-function fillArrayAsync(callback, length = 1) {
-  return __async(this, null, function* () {
-    return Promise.all(
-      new Array(length).fill(null).map((_, index) => __async(null, null, function* () {
-        return yield callback(index);
-      }))
-    );
-  });
-}
-var fillArrayAsync_default = fillArrayAsync;
-
 // src/functions/isSameDate.ts
 function isSameDate(firstDate, secondDate) {
   return firstDate.getDate() === secondDate.getDate() && firstDate.getMonth() === secondDate.getMonth() && firstDate.getFullYear() === secondDate.getFullYear();
@@ -184,7 +152,7 @@ var formatDateAndTime_default = formatDateAndTime;
 // src/functions/getRandomNumber.ts
 function getRandomNumber(lowerBound, upperBound) {
   if (lowerBound % 1 !== 0 || upperBound % 1 !== 0) {
-    throw new Error("NON_INTEGER_INPUTS");
+    throw new TypeError("NON_INTEGER_INPUTS");
   }
   return Math.floor(Math.random() * (upperBound - lowerBound + 1) + lowerBound);
 }
@@ -193,7 +161,7 @@ var getRandomNumber_default = getRandomNumber;
 // src/functions/isLeapYear.ts
 function isLeapYear(year) {
   if (year % 1 !== 0) {
-    throw new Error("NON_INTEGER_INPUT");
+    throw new TypeError("NON_INTEGER_INPUT");
   }
   return year % 4 === 0 && year % 100 !== 0 || year % 400 === 0;
 }
@@ -247,6 +215,21 @@ function omitProperties(object, keysToOmit) {
 }
 var omitProperties_default = omitProperties;
 
+// src/functions/parseIntStrict.ts
+function parseIntStrict(string, radix) {
+  const trimmedString = string.trim();
+  const pattern = radix && radix > 10 && radix <= 36 ? (
+    // String.fromCharCode() gets the maximum possible alphabetical character for a base above 10
+    new RegExp(`^[+-]?[0-9a-${String.fromCharCode(87 + radix - 1)}]+$`, "i")
+  ) : /^[+-]?\d+$/;
+  const parseIntResult = parseInt(trimmedString, radix);
+  if (isNaN(parseIntResult) || !pattern.test(trimmedString)) {
+    throw new TypeError("INTEGER_PARSING_ERROR");
+  }
+  return parseIntResult;
+}
+var parseIntStrict_default = parseIntStrict;
+
 // src/functions/randomiseArray.ts
 function randomiseArray(array) {
   const mutableArray = [...array];
@@ -283,14 +266,44 @@ function range(start, stop, step = 1) {
 }
 var range_default = range;
 
+// src/functions/stringToBoolean.ts
+function stringToBoolean(inputString) {
+  const normalisedString = inputString.toLowerCase();
+  if (normalisedString !== "true" && normalisedString !== "false") {
+    throw new TypeError("INVALID_BOOLEAN_STRING");
+  }
+  return normalisedString === "true";
+}
+var stringToBoolean_default = stringToBoolean;
+
 // src/functions/truncate.ts
 function truncate(stringToTruncate, maxLength = 5) {
   return stringToTruncate.length > maxLength ? `${stringToTruncate.slice(0, maxLength)}...` : stringToTruncate;
 }
 var truncate_default = truncate;
 
-// src/functions/validateUUID.ts
-var import_zod4 = __toESM(require("zod"), 1);
+// src/functions/wait.ts
+function wait(seconds) {
+  return new Promise((resolve, _) => {
+    setTimeout(() => {
+      resolve();
+    }, seconds * 1e3);
+  });
+}
+var wait_default = wait;
+
+// src/functions/taggedTemplate/interpolateObjects.ts
+function interpolateObjects(strings, ...values) {
+  let result = "";
+  for (let i = 0; i < strings.length; i++) {
+    result += strings[i];
+    if (i !== strings.length - 1) {
+      result += values[i] && typeof values[i] === "object" ? JSON.stringify(values[i]) : values[i];
+    }
+  }
+  return result;
+}
+var interpolateObjects_default = interpolateObjects;
 
 // src/types/APIError.ts
 var httpErrorCodeLookup = {
@@ -347,40 +360,6 @@ function parseUUID(UUID) {
   return uuidSchema.parse(UUID);
 }
 var UUID_default = parseUUID;
-
-// src/functions/validateUUID.ts
-function validateUUID(UUID, error = new APIError_default(400, "INVALID_UUID")) {
-  const uuidSchema2 = import_zod4.default.uuid();
-  const parsedUUID = uuidSchema2.safeParse(UUID);
-  if (!parsedUUID.success) {
-    throw error;
-  }
-  return parsedUUID.data;
-}
-var validateUUID_default = validateUUID;
-
-// src/functions/wait.ts
-function wait(seconds) {
-  return new Promise((resolve, _) => {
-    setTimeout(() => {
-      resolve();
-    }, seconds * 1e3);
-  });
-}
-var wait_default = wait;
-
-// src/functions/taggedTemplate/interpolateObjects.ts
-function interpolateObjects(strings, ...values) {
-  let result = "";
-  for (let i = 0; i < strings.length; i++) {
-    result += strings[i];
-    if (i !== strings.length - 1) {
-      result += values[i] && typeof values[i] === "object" ? JSON.stringify(values[i]) : values[i];
-    }
-  }
-  return result;
-}
-var interpolateObjects_default = interpolateObjects;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   APIError,
@@ -388,7 +367,6 @@ var interpolateObjects_default = interpolateObjects;
   appendSemicolon,
   convertFileToBase64,
   fillArray,
-  fillArrayAsync,
   formatDateAndTime,
   getRandomNumber,
   httpErrorCodeLookup,
@@ -399,10 +377,11 @@ var interpolateObjects_default = interpolateObjects;
   omitProperties,
   parseEmail,
   parseEnv,
+  parseIntStrict,
   parseUUID,
   randomiseArray,
   range,
+  stringToBoolean,
   truncate,
-  validateUUID,
   wait
 });

package/dist/index.d.cts

@@ -8,11 +8,6 @@ declare function convertFileToBase64(file: File): Promise<string>;
 
 declare function fillArray<T>(callback: (index: number) => T | Promise<T>, length?: number): T[] | Promise<T[]>;
 
-/**
- * @deprecated The functionality of fillArrayAsync has been combined with fillArray, so fillArray should now be used instead.
- */
-declare function fillArrayAsync<T>(callback: (index: number) => Promise<T>, length?: number): Promise<T[]>;
-
 declare function formatDateAndTime(inputDate: Date): string;
 
 declare function getRandomNumber(lowerBound: number, upperBound: number): number;
@@ -25,12 +20,20 @@ declare function isSameDate(firstDate: Date, secondDate: Date): boolean;
 
 declare function omitProperties<T extends Record<string, unknown>, K extends keyof T>(object: T, keysToOmit: K | readonly K[]): Omit<T, K>;
 
+declare function parseIntStrict(string: string, radix?: number): number;
+
 declare function randomiseArray<T>(array: T[]): T[];
 
 declare function range(start: number, stop: number, step?: number): number[];
 
+declare function stringToBoolean(inputString: string): boolean;
+
 declare function truncate(stringToTruncate: string, maxLength?: number): string;
 
+declare function wait(seconds: number): Promise<void>;
+
+declare function interpolateObjects(strings: TemplateStringsArray, ...values: unknown[]): string;
+
 type HTTPErrorCodes = 400 | 401 | 403 | 404 | 418 | 500;
 declare const httpErrorCodeLookup: Record<HTTPErrorCodes, string>;
 declare class APIError extends Error {
@@ -55,17 +58,8 @@ declare const uuidSchema: z.core.$ZodBranded<z.ZodUUID, "UUID">;
 type UUID = z.infer<typeof uuidSchema>;
 declare function parseUUID(UUID: unknown): UUID;
 
-type NonUndefined<T> = T extends undefined ? never : T;
-
-type PreventUndefined<T> = undefined extends T ? ["Error: Generic type cannot include undefined"] : T;
+type DisallowUndefined<T> = undefined extends T ? ["Error: Generic type cannot include undefined"] : T;
 
-/**
- * @deprecated validateUUID() is deprecated in favour of parseUUID()
- */
-declare function validateUUID(UUID: string, error?: Error | APIError): string;
-
-declare function wait(seconds: number): Promise<void>;
-
-declare function interpolateObjects(strings: TemplateStringsArray, ...values: unknown[]): string;
+type NonUndefined<T> = T extends undefined ? never : T;
 
-export { APIError, type PreventUndefined as DisallowUndefined, type Email, type Env, type HTTPErrorCodes, type NonUndefined, type UUID, addDaysToDate, appendSemicolon, convertFileToBase64, fillArray, fillArrayAsync, formatDateAndTime, getRandomNumber, httpErrorCodeLookup, interpolateObjects, isLeapYear, isMonthlyMultiple, isSameDate, omitProperties, parseEmail, parseEnv, parseUUID, randomiseArray, range, truncate, validateUUID, wait };
+export { APIError, type DisallowUndefined, type Email, type Env, type HTTPErrorCodes, type NonUndefined, type UUID, addDaysToDate, appendSemicolon, convertFileToBase64, fillArray, formatDateAndTime, getRandomNumber, httpErrorCodeLookup, interpolateObjects, isLeapYear, isMonthlyMultiple, isSameDate, omitProperties, parseEmail, parseEnv, parseIntStrict, parseUUID, randomiseArray, range, stringToBoolean, truncate, wait };

package/dist/index.d.ts

@@ -8,11 +8,6 @@ declare function convertFileToBase64(file: File): Promise<string>;
 
 declare function fillArray<T>(callback: (index: number) => T | Promise<T>, length?: number): T[] | Promise<T[]>;
 
-/**
- * @deprecated The functionality of fillArrayAsync has been combined with fillArray, so fillArray should now be used instead.
- */
-declare function fillArrayAsync<T>(callback: (index: number) => Promise<T>, length?: number): Promise<T[]>;
-
 declare function formatDateAndTime(inputDate: Date): string;
 
 declare function getRandomNumber(lowerBound: number, upperBound: number): number;
@@ -25,12 +20,20 @@ declare function isSameDate(firstDate: Date, secondDate: Date): boolean;
 
 declare function omitProperties<T extends Record<string, unknown>, K extends keyof T>(object: T, keysToOmit: K | readonly K[]): Omit<T, K>;
 
+declare function parseIntStrict(string: string, radix?: number): number;
+
 declare function randomiseArray<T>(array: T[]): T[];
 
 declare function range(start: number, stop: number, step?: number): number[];
 
+declare function stringToBoolean(inputString: string): boolean;
+
 declare function truncate(stringToTruncate: string, maxLength?: number): string;
 
+declare function wait(seconds: number): Promise<void>;
+
+declare function interpolateObjects(strings: TemplateStringsArray, ...values: unknown[]): string;
+
 type HTTPErrorCodes = 400 | 401 | 403 | 404 | 418 | 500;
 declare const httpErrorCodeLookup: Record<HTTPErrorCodes, string>;
 declare class APIError extends Error {
@@ -55,17 +58,8 @@ declare const uuidSchema: z.core.$ZodBranded<z.ZodUUID, "UUID">;
 type UUID = z.infer<typeof uuidSchema>;
 declare function parseUUID(UUID: unknown): UUID;
 
-type NonUndefined<T> = T extends undefined ? never : T;
-
-type PreventUndefined<T> = undefined extends T ? ["Error: Generic type cannot include undefined"] : T;
+type DisallowUndefined<T> = undefined extends T ? ["Error: Generic type cannot include undefined"] : T;
 
-/**
- * @deprecated validateUUID() is deprecated in favour of parseUUID()
- */
-declare function validateUUID(UUID: string, error?: Error | APIError): string;
-
-declare function wait(seconds: number): Promise<void>;
-
-declare function interpolateObjects(strings: TemplateStringsArray, ...values: unknown[]): string;
+type NonUndefined<T> = T extends undefined ? never : T;
 
-export { APIError, type PreventUndefined as DisallowUndefined, type Email, type Env, type HTTPErrorCodes, type NonUndefined, type UUID, addDaysToDate, appendSemicolon, convertFileToBase64, fillArray, fillArrayAsync, formatDateAndTime, getRandomNumber, httpErrorCodeLookup, interpolateObjects, isLeapYear, isMonthlyMultiple, isSameDate, omitProperties, parseEmail, parseEnv, parseUUID, randomiseArray, range, truncate, validateUUID, wait };
+export { APIError, type DisallowUndefined, type Email, type Env, type HTTPErrorCodes, type NonUndefined, type UUID, addDaysToDate, appendSemicolon, convertFileToBase64, fillArray, formatDateAndTime, getRandomNumber, httpErrorCodeLookup, interpolateObjects, isLeapYear, isMonthlyMultiple, isSameDate, omitProperties, parseEmail, parseEnv, parseIntStrict, parseUUID, randomiseArray, range, stringToBoolean, truncate, wait };

package/dist/index.js

@@ -15,26 +15,6 @@ var __spreadValues = (a, b) => {
   return a;
 };
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-var __async = (__this, __arguments, generator) => {
-  return new Promise((resolve, reject) => {
-    var fulfilled = (value) => {
-      try {
-        step(generator.next(value));
-      } catch (e) {
-        reject(e);
-      }
-    };
-    var rejected = (value) => {
-      try {
-        step(generator.throw(value));
-      } catch (e) {
-        reject(e);
-      }
-    };
-    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
-    step((generator = generator.apply(__this, __arguments)).next());
-  });
-};
 
 // src/functions/addDaysToDate.ts
 function addDaysToDate(currentDate = /* @__PURE__ */ new Date(), dayIncrement = 1) {
@@ -91,18 +71,6 @@ function fillArray(callback, length = 1) {
 }
 var fillArray_default = fillArray;
 
-// src/functions/fillArrayAsync.ts
-function fillArrayAsync(callback, length = 1) {
-  return __async(this, null, function* () {
-    return Promise.all(
-      new Array(length).fill(null).map((_, index) => __async(null, null, function* () {
-        return yield callback(index);
-      }))
-    );
-  });
-}
-var fillArrayAsync_default = fillArrayAsync;
-
 // src/functions/isSameDate.ts
 function isSameDate(firstDate, secondDate) {
   return firstDate.getDate() === secondDate.getDate() && firstDate.getMonth() === secondDate.getMonth() && firstDate.getFullYear() === secondDate.getFullYear();
@@ -130,7 +98,7 @@ var formatDateAndTime_default = formatDateAndTime;
 // src/functions/getRandomNumber.ts
 function getRandomNumber(lowerBound, upperBound) {
   if (lowerBound % 1 !== 0 || upperBound % 1 !== 0) {
-    throw new Error("NON_INTEGER_INPUTS");
+    throw new TypeError("NON_INTEGER_INPUTS");
   }
   return Math.floor(Math.random() * (upperBound - lowerBound + 1) + lowerBound);
 }
@@ -139,7 +107,7 @@ var getRandomNumber_default = getRandomNumber;
 // src/functions/isLeapYear.ts
 function isLeapYear(year) {
   if (year % 1 !== 0) {
-    throw new Error("NON_INTEGER_INPUT");
+    throw new TypeError("NON_INTEGER_INPUT");
   }
   return year % 4 === 0 && year % 100 !== 0 || year % 400 === 0;
 }
@@ -193,6 +161,21 @@ function omitProperties(object, keysToOmit) {
 }
 var omitProperties_default = omitProperties;
 
+// src/functions/parseIntStrict.ts
+function parseIntStrict(string, radix) {
+  const trimmedString = string.trim();
+  const pattern = radix && radix > 10 && radix <= 36 ? (
+    // String.fromCharCode() gets the maximum possible alphabetical character for a base above 10
+    new RegExp(`^[+-]?[0-9a-${String.fromCharCode(87 + radix - 1)}]+$`, "i")
+  ) : /^[+-]?\d+$/;
+  const parseIntResult = parseInt(trimmedString, radix);
+  if (isNaN(parseIntResult) || !pattern.test(trimmedString)) {
+    throw new TypeError("INTEGER_PARSING_ERROR");
+  }
+  return parseIntResult;
+}
+var parseIntStrict_default = parseIntStrict;
+
 // src/functions/randomiseArray.ts
 function randomiseArray(array) {
   const mutableArray = [...array];
@@ -229,14 +212,44 @@ function range(start, stop, step = 1) {
 }
 var range_default = range;
 
+// src/functions/stringToBoolean.ts
+function stringToBoolean(inputString) {
+  const normalisedString = inputString.toLowerCase();
+  if (normalisedString !== "true" && normalisedString !== "false") {
+    throw new TypeError("INVALID_BOOLEAN_STRING");
+  }
+  return normalisedString === "true";
+}
+var stringToBoolean_default = stringToBoolean;
+
 // src/functions/truncate.ts
 function truncate(stringToTruncate, maxLength = 5) {
   return stringToTruncate.length > maxLength ? `${stringToTruncate.slice(0, maxLength)}...` : stringToTruncate;
 }
 var truncate_default = truncate;
 
-// src/functions/validateUUID.ts
-import z4 from "zod";
+// src/functions/wait.ts
+function wait(seconds) {
+  return new Promise((resolve, _) => {
+    setTimeout(() => {
+      resolve();
+    }, seconds * 1e3);
+  });
+}
+var wait_default = wait;
+
+// src/functions/taggedTemplate/interpolateObjects.ts
+function interpolateObjects(strings, ...values) {
+  let result = "";
+  for (let i = 0; i < strings.length; i++) {
+    result += strings[i];
+    if (i !== strings.length - 1) {
+      result += values[i] && typeof values[i] === "object" ? JSON.stringify(values[i]) : values[i];
+    }
+  }
+  return result;
+}
+var interpolateObjects_default = interpolateObjects;
 
 // src/types/APIError.ts
 var httpErrorCodeLookup = {
@@ -293,47 +306,12 @@ function parseUUID(UUID) {
   return uuidSchema.parse(UUID);
 }
 var UUID_default = parseUUID;
-
-// src/functions/validateUUID.ts
-function validateUUID(UUID, error = new APIError_default(400, "INVALID_UUID")) {
-  const uuidSchema2 = z4.uuid();
-  const parsedUUID = uuidSchema2.safeParse(UUID);
-  if (!parsedUUID.success) {
-    throw error;
-  }
-  return parsedUUID.data;
-}
-var validateUUID_default = validateUUID;
-
-// src/functions/wait.ts
-function wait(seconds) {
-  return new Promise((resolve, _) => {
-    setTimeout(() => {
-      resolve();
-    }, seconds * 1e3);
-  });
-}
-var wait_default = wait;
-
-// src/functions/taggedTemplate/interpolateObjects.ts
-function interpolateObjects(strings, ...values) {
-  let result = "";
-  for (let i = 0; i < strings.length; i++) {
-    result += strings[i];
-    if (i !== strings.length - 1) {
-      result += values[i] && typeof values[i] === "object" ? JSON.stringify(values[i]) : values[i];
-    }
-  }
-  return result;
-}
-var interpolateObjects_default = interpolateObjects;
 export {
   APIError_default as APIError,
   addDaysToDate_default as addDaysToDate,
   appendSemicolon_default as appendSemicolon,
   convertFileToBase64_default as convertFileToBase64,
   fillArray_default as fillArray,
-  fillArrayAsync_default as fillArrayAsync,
   formatDateAndTime_default as formatDateAndTime,
   getRandomNumber_default as getRandomNumber,
   httpErrorCodeLookup,
@@ -344,10 +322,11 @@ export {
   omitProperties_default as omitProperties,
   Email_default as parseEmail,
   Env_default as parseEnv,
+  parseIntStrict_default as parseIntStrict,
   UUID_default as parseUUID,
   randomiseArray_default as randomiseArray,
   range_default as range,
+  stringToBoolean_default as stringToBoolean,
   truncate_default as truncate,
-  validateUUID_default as validateUUID,
   wait_default as wait
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alextheman/utility",
-  "version": "1.25.0",
+  "version": "2.1.0",
   "description": "Helpful utility functions",
   "license": "ISC",
   "author": "alextheman",
@@ -37,9 +37,9 @@
   },
   "devDependencies": {
     "@alextheman/eslint-plugin": "^1.14.2",
-    "@eslint/js": "^9.37.0",
-    "@types/node": "^24.7.1",
-    "eslint": "^9.37.0",
+    "@eslint/js": "^9.38.0",
+    "@types/node": "^24.8.1",
+    "eslint": "^9.38.0",
     "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-import": "^2.32.0",
     "globals": "^16.4.0",
@@ -48,7 +48,7 @@
     "prettier": "^3.6.2",
     "tsup": "^8.5.0",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.46.0",
+    "typescript-eslint": "^8.46.1",
     "vite-tsconfig-paths": "^5.1.4",
     "vitest": "^3.2.4"
   }