@alextheman/utility 1.9.0 → 1.9.2

package/dist/index.cjs

@@ -22,8 +22,11 @@ var index_exports = {};
 __export(index_exports, {
   addDaysToDate: () => add_days_to_date_default,
   appendSemicolon: () => append_semicolon_default,
+  convertFileToBase64: () => convert_file_to_base_64_default,
   formatDateAndTime: () => format_date_and_time_default,
   getRandomNumber: () => get_random_number_default,
+  isMonthlyMultiple: () => is_monthly_multiple_default,
+  isSameDate: () => is_same_date_default,
   randomiseArray: () => randomise_array_default,
   range: () => range_default,
   truncate: () => truncate_default,
@@ -31,37 +34,6 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/get-random-number.ts
-function getRandomNumber(lowerBound, upperBound) {
-  if (lowerBound % 1 !== 0 || upperBound % 1 !== 0) {
-    throw new Error("NON_INTEGER_INPUTS");
-  }
-  return Math.floor(Math.random() * (upperBound - lowerBound + 1) + lowerBound);
-}
-var get_random_number_default = getRandomNumber;
-
-// src/randomise-array.ts
-function randomiseArray(array) {
-  const mutableArray = [...array];
-  const outputArray = [];
-  do {
-    const indexToRemove = get_random_number_default(0, mutableArray.length - 1);
-    outputArray.push(mutableArray.splice(indexToRemove, 1)[0]);
-  } while (mutableArray.length > 0);
-  return outputArray;
-}
-var randomise_array_default = randomiseArray;
-
-// src/wait.ts
-function wait(seconds) {
-  return new Promise((resolve, _) => {
-    setTimeout(() => {
-      resolve();
-    }, seconds * 1e3);
-  });
-}
-var wait_default = wait;
-
 // src/add-days-to-date.ts
 function addDaysToDate(currentDate = /* @__PURE__ */ new Date(), dayIncrement = 1) {
   const newDate = currentDate;
@@ -70,6 +42,38 @@ function addDaysToDate(currentDate = /* @__PURE__ */ new Date(), dayIncrement =
 }
 var add_days_to_date_default = addDaysToDate;
 
+// src/append-semicolon.ts
+function appendSemicolon(stringToAppendTo) {
+  if (stringToAppendTo.includes("\n")) {
+    throw new Error("MULTIPLE_LINE_ERROR");
+  }
+  const stringWithNoTrailingWhitespace = stringToAppendTo.trimEnd();
+  if (stringWithNoTrailingWhitespace === "") {
+    return "";
+  }
+  return stringWithNoTrailingWhitespace[stringWithNoTrailingWhitespace.length - 1] === ";" ? stringWithNoTrailingWhitespace : `${stringWithNoTrailingWhitespace};`;
+}
+var append_semicolon_default = appendSemicolon;
+
+// src/convert-file-to-base-64.ts
+function convertFileToBase64(file) {
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader();
+    reader.readAsDataURL(file);
+    reader.onload = () => {
+      if (reader.result === null) {
+        reject(new Error("FILE_CONVERSION_ERROR"));
+        return;
+      }
+      resolve(reader.result);
+    };
+    reader.onerror = () => {
+      reject(new Error("FILE_READER_ERROR"));
+    };
+  });
+}
+var convert_file_to_base_64_default = convertFileToBase64;
+
 // src/format-date-and-time.ts
 function formatDateAndTime(inputDate) {
   const yesterday = add_days_to_date_default(/* @__PURE__ */ new Date(), -1);
@@ -88,24 +92,69 @@ function formatDateAndTime(inputDate) {
 }
 var format_date_and_time_default = formatDateAndTime;
 
-// src/truncate.ts
-function truncate(stringToTruncate, maxLength = 5) {
-  return stringToTruncate.length > maxLength ? `${stringToTruncate.slice(0, maxLength)}...` : stringToTruncate;
+// src/get-random-number.ts
+function getRandomNumber(lowerBound, upperBound) {
+  if (lowerBound % 1 !== 0 || upperBound % 1 !== 0) {
+    throw new Error("NON_INTEGER_INPUTS");
+  }
+  return Math.floor(Math.random() * (upperBound - lowerBound + 1) + lowerBound);
 }
-var truncate_default = truncate;
+var get_random_number_default = getRandomNumber;
 
-// src/append-semicolon.ts
-function appendSemicolon(stringToAppendTo) {
-  if (stringToAppendTo.includes("\n")) {
-    throw new Error("MULTIPLE_LINE_ERROR");
+// src/is-monthly-multiple.ts
+function endOfMonthChecksButNotFebruary(firstDate, secondDate) {
+  if ([3, 5, 8, 10].includes(firstDate.getMonth())) {
+    return firstDate.getDate() === 30 && secondDate.getDate() === 31;
   }
-  const stringWithNoTrailingWhitespace = stringToAppendTo.trimEnd();
-  if (stringWithNoTrailingWhitespace === "") {
-    return "";
+  return false;
+}
+function nonLeapYearFebruaryChecks(firstDate, secondDate) {
+  if (firstDate.getMonth() === 1) {
+    if (firstDate.getFullYear() % 4 !== 0 && firstDate.getDate() === 28) {
+      return [28, 29, 30, 31].includes(secondDate.getDate());
+    }
   }
-  return stringWithNoTrailingWhitespace[stringWithNoTrailingWhitespace.length - 1] === ";" ? stringWithNoTrailingWhitespace : `${stringWithNoTrailingWhitespace};`;
+  return false;
 }
-var append_semicolon_default = appendSemicolon;
+function leapYearFebruaryChecks(firstDate, secondDate) {
+  if (firstDate.getMonth() === 1) {
+    if (firstDate.getFullYear() % 4 === 0 && firstDate.getDate() === 29) {
+      return [29, 30, 31].includes(secondDate.getDate());
+    }
+  }
+  return false;
+}
+function isMonthlyMultiple(firstDate, secondDate) {
+  if (endOfMonthChecksButNotFebruary(firstDate, secondDate) || endOfMonthChecksButNotFebruary(secondDate, firstDate)) {
+    return true;
+  }
+  if (nonLeapYearFebruaryChecks(firstDate, secondDate) || nonLeapYearFebruaryChecks(secondDate, firstDate)) {
+    return true;
+  }
+  if (leapYearFebruaryChecks(firstDate, secondDate) || leapYearFebruaryChecks(secondDate, firstDate)) {
+    return true;
+  }
+  return firstDate.getDate() === secondDate.getDate();
+}
+var is_monthly_multiple_default = isMonthlyMultiple;
+
+// src/is-same-date.ts
+function isSameDate(firstDate, secondDate) {
+  return firstDate.getDate() === secondDate.getDate() && firstDate.getMonth() === secondDate.getMonth() && firstDate.getFullYear() === secondDate.getFullYear();
+}
+var is_same_date_default = isSameDate;
+
+// src/randomise-array.ts
+function randomiseArray(array) {
+  const mutableArray = [...array];
+  const outputArray = [];
+  do {
+    const indexToRemove = get_random_number_default(0, mutableArray.length - 1);
+    outputArray.push(mutableArray.splice(indexToRemove, 1)[0]);
+  } while (mutableArray.length > 0);
+  return outputArray;
+}
+var randomise_array_default = randomiseArray;
 
 // src/range.ts
 function range(start, stop, step = 1) {
@@ -130,12 +179,31 @@ function range(start, stop, step = 1) {
   return numbers;
 }
 var range_default = range;
+
+// src/truncate.ts
+function truncate(stringToTruncate, maxLength = 5) {
+  return stringToTruncate.length > maxLength ? `${stringToTruncate.slice(0, maxLength)}...` : stringToTruncate;
+}
+var truncate_default = truncate;
+
+// src/wait.ts
+function wait(seconds) {
+  return new Promise((resolve, _) => {
+    setTimeout(() => {
+      resolve();
+    }, seconds * 1e3);
+  });
+}
+var wait_default = wait;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   addDaysToDate,
   appendSemicolon,
+  convertFileToBase64,
   formatDateAndTime,
   getRandomNumber,
+  isMonthlyMultiple,
+  isSameDate,
   randomiseArray,
   range,
   truncate,

package/dist/index.d.cts

@@ -1,17 +1,23 @@
-declare function getRandomNumber(lowerBound: number, upperBound: number): number;
+declare function addDaysToDate(currentDate?: Date, dayIncrement?: number): Date;
 
-declare function randomiseArray(array: unknown[]): unknown[];
+declare function appendSemicolon(stringToAppendTo: string): string;
 
-declare function wait(seconds: number): Promise<void>;
+declare function convertFileToBase64(file: File): Promise<string>;
 
 declare function formatDateAndTime(inputDate: Date): string;
 
-declare function addDaysToDate(currentDate?: Date, dayIncrement?: number): Date;
+declare function getRandomNumber(lowerBound: number, upperBound: number): number;
 
-declare function truncate(stringToTruncate: string, maxLength?: number): string;
+declare function isMonthlyMultiple(firstDate: Date, secondDate: Date): boolean;
 
-declare function appendSemicolon(stringToAppendTo: string): string;
+declare function isSameDate(firstDate: Date, secondDate: Date): boolean;
+
+declare function randomiseArray(array: unknown[]): unknown[];
 
 declare function range(start: number, stop: number, step?: number): number[];
 
-export { addDaysToDate, appendSemicolon, formatDateAndTime, getRandomNumber, randomiseArray, range, truncate, wait };
+declare function truncate(stringToTruncate: string, maxLength?: number): string;
+
+declare function wait(seconds: number): Promise<void>;
+
+export { addDaysToDate, appendSemicolon, convertFileToBase64, formatDateAndTime, getRandomNumber, isMonthlyMultiple, isSameDate, randomiseArray, range, truncate, wait };

package/dist/index.d.ts

@@ -1,17 +1,23 @@
-declare function getRandomNumber(lowerBound: number, upperBound: number): number;
+declare function addDaysToDate(currentDate?: Date, dayIncrement?: number): Date;
 
-declare function randomiseArray(array: unknown[]): unknown[];
+declare function appendSemicolon(stringToAppendTo: string): string;
 
-declare function wait(seconds: number): Promise<void>;
+declare function convertFileToBase64(file: File): Promise<string>;
 
 declare function formatDateAndTime(inputDate: Date): string;
 
-declare function addDaysToDate(currentDate?: Date, dayIncrement?: number): Date;
+declare function getRandomNumber(lowerBound: number, upperBound: number): number;
 
-declare function truncate(stringToTruncate: string, maxLength?: number): string;
+declare function isMonthlyMultiple(firstDate: Date, secondDate: Date): boolean;
 
-declare function appendSemicolon(stringToAppendTo: string): string;
+declare function isSameDate(firstDate: Date, secondDate: Date): boolean;
+
+declare function randomiseArray(array: unknown[]): unknown[];
 
 declare function range(start: number, stop: number, step?: number): number[];
 
-export { addDaysToDate, appendSemicolon, formatDateAndTime, getRandomNumber, randomiseArray, range, truncate, wait };
+declare function truncate(stringToTruncate: string, maxLength?: number): string;
+
+declare function wait(seconds: number): Promise<void>;
+
+export { addDaysToDate, appendSemicolon, convertFileToBase64, formatDateAndTime, getRandomNumber, isMonthlyMultiple, isSameDate, randomiseArray, range, truncate, wait };

package/dist/index.js

@@ -1,34 +1,3 @@
-// src/get-random-number.ts
-function getRandomNumber(lowerBound, upperBound) {
-  if (lowerBound % 1 !== 0 || upperBound % 1 !== 0) {
-    throw new Error("NON_INTEGER_INPUTS");
-  }
-  return Math.floor(Math.random() * (upperBound - lowerBound + 1) + lowerBound);
-}
-var get_random_number_default = getRandomNumber;
-
-// src/randomise-array.ts
-function randomiseArray(array) {
-  const mutableArray = [...array];
-  const outputArray = [];
-  do {
-    const indexToRemove = get_random_number_default(0, mutableArray.length - 1);
-    outputArray.push(mutableArray.splice(indexToRemove, 1)[0]);
-  } while (mutableArray.length > 0);
-  return outputArray;
-}
-var randomise_array_default = randomiseArray;
-
-// src/wait.ts
-function wait(seconds) {
-  return new Promise((resolve, _) => {
-    setTimeout(() => {
-      resolve();
-    }, seconds * 1e3);
-  });
-}
-var wait_default = wait;
-
 // src/add-days-to-date.ts
 function addDaysToDate(currentDate = /* @__PURE__ */ new Date(), dayIncrement = 1) {
   const newDate = currentDate;
@@ -37,6 +6,38 @@ function addDaysToDate(currentDate = /* @__PURE__ */ new Date(), dayIncrement =
 }
 var add_days_to_date_default = addDaysToDate;
 
+// src/append-semicolon.ts
+function appendSemicolon(stringToAppendTo) {
+  if (stringToAppendTo.includes("\n")) {
+    throw new Error("MULTIPLE_LINE_ERROR");
+  }
+  const stringWithNoTrailingWhitespace = stringToAppendTo.trimEnd();
+  if (stringWithNoTrailingWhitespace === "") {
+    return "";
+  }
+  return stringWithNoTrailingWhitespace[stringWithNoTrailingWhitespace.length - 1] === ";" ? stringWithNoTrailingWhitespace : `${stringWithNoTrailingWhitespace};`;
+}
+var append_semicolon_default = appendSemicolon;
+
+// src/convert-file-to-base-64.ts
+function convertFileToBase64(file) {
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader();
+    reader.readAsDataURL(file);
+    reader.onload = () => {
+      if (reader.result === null) {
+        reject(new Error("FILE_CONVERSION_ERROR"));
+        return;
+      }
+      resolve(reader.result);
+    };
+    reader.onerror = () => {
+      reject(new Error("FILE_READER_ERROR"));
+    };
+  });
+}
+var convert_file_to_base_64_default = convertFileToBase64;
+
 // src/format-date-and-time.ts
 function formatDateAndTime(inputDate) {
   const yesterday = add_days_to_date_default(/* @__PURE__ */ new Date(), -1);
@@ -55,24 +56,69 @@ function formatDateAndTime(inputDate) {
 }
 var format_date_and_time_default = formatDateAndTime;
 
-// src/truncate.ts
-function truncate(stringToTruncate, maxLength = 5) {
-  return stringToTruncate.length > maxLength ? `${stringToTruncate.slice(0, maxLength)}...` : stringToTruncate;
+// src/get-random-number.ts
+function getRandomNumber(lowerBound, upperBound) {
+  if (lowerBound % 1 !== 0 || upperBound % 1 !== 0) {
+    throw new Error("NON_INTEGER_INPUTS");
+  }
+  return Math.floor(Math.random() * (upperBound - lowerBound + 1) + lowerBound);
 }
-var truncate_default = truncate;
+var get_random_number_default = getRandomNumber;
 
-// src/append-semicolon.ts
-function appendSemicolon(stringToAppendTo) {
-  if (stringToAppendTo.includes("\n")) {
-    throw new Error("MULTIPLE_LINE_ERROR");
+// src/is-monthly-multiple.ts
+function endOfMonthChecksButNotFebruary(firstDate, secondDate) {
+  if ([3, 5, 8, 10].includes(firstDate.getMonth())) {
+    return firstDate.getDate() === 30 && secondDate.getDate() === 31;
   }
-  const stringWithNoTrailingWhitespace = stringToAppendTo.trimEnd();
-  if (stringWithNoTrailingWhitespace === "") {
-    return "";
+  return false;
+}
+function nonLeapYearFebruaryChecks(firstDate, secondDate) {
+  if (firstDate.getMonth() === 1) {
+    if (firstDate.getFullYear() % 4 !== 0 && firstDate.getDate() === 28) {
+      return [28, 29, 30, 31].includes(secondDate.getDate());
+    }
   }
-  return stringWithNoTrailingWhitespace[stringWithNoTrailingWhitespace.length - 1] === ";" ? stringWithNoTrailingWhitespace : `${stringWithNoTrailingWhitespace};`;
+  return false;
 }
-var append_semicolon_default = appendSemicolon;
+function leapYearFebruaryChecks(firstDate, secondDate) {
+  if (firstDate.getMonth() === 1) {
+    if (firstDate.getFullYear() % 4 === 0 && firstDate.getDate() === 29) {
+      return [29, 30, 31].includes(secondDate.getDate());
+    }
+  }
+  return false;
+}
+function isMonthlyMultiple(firstDate, secondDate) {
+  if (endOfMonthChecksButNotFebruary(firstDate, secondDate) || endOfMonthChecksButNotFebruary(secondDate, firstDate)) {
+    return true;
+  }
+  if (nonLeapYearFebruaryChecks(firstDate, secondDate) || nonLeapYearFebruaryChecks(secondDate, firstDate)) {
+    return true;
+  }
+  if (leapYearFebruaryChecks(firstDate, secondDate) || leapYearFebruaryChecks(secondDate, firstDate)) {
+    return true;
+  }
+  return firstDate.getDate() === secondDate.getDate();
+}
+var is_monthly_multiple_default = isMonthlyMultiple;
+
+// src/is-same-date.ts
+function isSameDate(firstDate, secondDate) {
+  return firstDate.getDate() === secondDate.getDate() && firstDate.getMonth() === secondDate.getMonth() && firstDate.getFullYear() === secondDate.getFullYear();
+}
+var is_same_date_default = isSameDate;
+
+// src/randomise-array.ts
+function randomiseArray(array) {
+  const mutableArray = [...array];
+  const outputArray = [];
+  do {
+    const indexToRemove = get_random_number_default(0, mutableArray.length - 1);
+    outputArray.push(mutableArray.splice(indexToRemove, 1)[0]);
+  } while (mutableArray.length > 0);
+  return outputArray;
+}
+var randomise_array_default = randomiseArray;
 
 // src/range.ts
 function range(start, stop, step = 1) {
@@ -97,11 +143,30 @@ function range(start, stop, step = 1) {
   return numbers;
 }
 var range_default = range;
+
+// src/truncate.ts
+function truncate(stringToTruncate, maxLength = 5) {
+  return stringToTruncate.length > maxLength ? `${stringToTruncate.slice(0, maxLength)}...` : stringToTruncate;
+}
+var truncate_default = truncate;
+
+// src/wait.ts
+function wait(seconds) {
+  return new Promise((resolve, _) => {
+    setTimeout(() => {
+      resolve();
+    }, seconds * 1e3);
+  });
+}
+var wait_default = wait;
 export {
   add_days_to_date_default as addDaysToDate,
   append_semicolon_default as appendSemicolon,
+  convert_file_to_base_64_default as convertFileToBase64,
   format_date_and_time_default as formatDateAndTime,
   get_random_number_default as getRandomNumber,
+  is_monthly_multiple_default as isMonthlyMultiple,
+  is_same_date_default as isSameDate,
   randomise_array_default as randomiseArray,
   range_default as range,
   truncate_default as truncate,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alextheman/utility",
-  "version": "1.9.0",
+  "version": "1.9.2",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -25,10 +25,10 @@
   "license": "ISC",
   "description": "",
   "devDependencies": {
-    "@alextheman/eslint-plugin": "^1.2.10",
-    "@eslint/js": "^9.32.0",
-    "@types/node": "^24.2.0",
-    "eslint": "^9.32.0",
+    "@alextheman/eslint-plugin": "^1.2.11",
+    "@eslint/js": "^9.33.0",
+    "@types/node": "^24.2.1",
+    "eslint": "^9.33.0",
     "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-import": "^2.32.0",
     "globals": "^16.3.0",