@alextheman/utility 2.0.0 → 2.1.1

package/dist/index.cjs

@@ -60,9 +60,11 @@ __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,
   wait: () => wait_default
 });
@@ -150,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);
 }
@@ -159,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;
 }
@@ -213,6 +215,30 @@ function omitProperties(object, keysToOmit) {
 }
 var omitProperties_default = omitProperties;
 
+// src/functions/parseIntStrict.ts
+var IntegerParsingError = new TypeError("INTEGER_PARSING_ERROR");
+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+$/;
+  if (!pattern.test(trimmedString)) {
+    throw IntegerParsingError;
+  }
+  if (radix && radix < 10 && [...trimmedString].some((character) => {
+    return parseInt(character) >= radix;
+  })) {
+    throw IntegerParsingError;
+  }
+  const parseIntResult = parseInt(trimmedString, radix);
+  if (isNaN(parseIntResult)) {
+    throw IntegerParsingError;
+  }
+  return parseIntResult;
+}
+var parseIntStrict_default = parseIntStrict;
+
 // src/functions/randomiseArray.ts
 function randomiseArray(array) {
   const mutableArray = [...array];
@@ -249,6 +275,16 @@ 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;
@@ -350,9 +386,11 @@ var UUID_default = parseUUID;
   omitProperties,
   parseEmail,
   parseEnv,
+  parseIntStrict,
   parseUUID,
   randomiseArray,
   range,
+  stringToBoolean,
   truncate,
   wait
 });

package/dist/index.d.cts

@@ -20,10 +20,14 @@ 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>;
@@ -58,4 +62,4 @@ type DisallowUndefined<T> = undefined extends T ? ["Error: Generic type cannot i
 
 type NonUndefined<T> = T extends undefined ? never : T;
 
-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, parseUUID, randomiseArray, range, truncate, 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

@@ -20,10 +20,14 @@ 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>;
@@ -58,4 +62,4 @@ type DisallowUndefined<T> = undefined extends T ? ["Error: Generic type cannot i
 
 type NonUndefined<T> = T extends undefined ? never : T;
 
-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, parseUUID, randomiseArray, range, truncate, 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

@@ -98,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);
 }
@@ -107,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;
 }
@@ -161,6 +161,30 @@ function omitProperties(object, keysToOmit) {
 }
 var omitProperties_default = omitProperties;
 
+// src/functions/parseIntStrict.ts
+var IntegerParsingError = new TypeError("INTEGER_PARSING_ERROR");
+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+$/;
+  if (!pattern.test(trimmedString)) {
+    throw IntegerParsingError;
+  }
+  if (radix && radix < 10 && [...trimmedString].some((character) => {
+    return parseInt(character) >= radix;
+  })) {
+    throw IntegerParsingError;
+  }
+  const parseIntResult = parseInt(trimmedString, radix);
+  if (isNaN(parseIntResult)) {
+    throw IntegerParsingError;
+  }
+  return parseIntResult;
+}
+var parseIntStrict_default = parseIntStrict;
+
 // src/functions/randomiseArray.ts
 function randomiseArray(array) {
   const mutableArray = [...array];
@@ -197,6 +221,16 @@ 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;
@@ -297,9 +331,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,
   wait_default as wait
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alextheman/utility",
-  "version": "2.0.0",
+  "version": "2.1.1",
   "description": "Helpful utility functions",
   "license": "ISC",
   "author": "alextheman",