@dereekb/util 10.1.10 → 10.1.12

package/fetch/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+## [10.1.12](https://github.com/dereekb/dbx-components/compare/v10.1.11-dev...v10.1.12) (2024-04-30)
+
+
+
+## [10.1.11](https://github.com/dereekb/dbx-components/compare/v10.1.10-dev...v10.1.11) (2024-04-27)
+
+
+
 ## [10.1.10](https://github.com/dereekb/dbx-components/compare/v10.1.9-dev...v10.1.10) (2024-04-12)
 
 

package/fetch/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/util/fetch",
-  "version": "10.1.10",
+  "version": "10.1.12",
   "type": "commonjs",
   "peerDependencies": {
     "@dereekb/util": "*"

package/index.cjs.js

@@ -1972,6 +1972,15 @@ function asIterable(values, treatStringAsIterable) {
   }
   return iterable;
 }
+/**
+ * Converts the input IterableOrValue value to an array.
+ *
+ * By default will treat strings as a non-iterable value, using the string as a single value.
+ *
+ * @param values
+ * @param treatStringAsIterable
+ * @returns
+ */
 function iterableToArray(values, treatStringAsIterable) {
   let iterable;
   if (treatStringAsIterable && typeof values === 'string') {
@@ -1983,6 +1992,25 @@ function iterableToArray(values, treatStringAsIterable) {
   }
   return iterable;
 }
+/**
+ * Converts the input IterableOrValue value to a Set.
+ *
+ * By default will treat strings as a non-iterable value, using the string as a single value.
+ *
+ * @param values
+ * @param treatStringAsIterable
+ * @returns
+ */
+function iterableToSet(values, treatStringAsIterable = false) {
+  return new Set(iterableToArray(values, treatStringAsIterable));
+}
+/**
+ * Converts the input IterableOrValue value to a Map using the input readKey function.
+ *
+ * @param values
+ * @param readKey
+ * @returns
+ */
 function iterableToMap(values, readKey) {
   const map = new Map(iterableToArray(values).map(value => [readKey(value), value]));
   return map;
@@ -9457,6 +9485,265 @@ function compareEqualityWithValueFromItemsFunctionFactory(readValues) {
   return fn;
 }
 
+/**
+ * TODO: Need to improve to support negative years.
+ */
+const ISO_8601_DATE_STRING_REGEX = /(\d{4,})-(\d{2})-(\d{2})T(\d{2})\:(\d{2})\:(\d{2})(Z|[+-](\d{2})\:(\d{2}))?/;
+function isISO8601DateString(input) {
+  return ISO_8601_DATE_STRING_REGEX.test(input);
+}
+/**
+ * Match examples:
+ *
+ * Sat, 03 Feb 2001 04:05:06 GMT
+ * Tue, 14 Mar 2023 12:34:56 UTC
+ * Wed, 25 May 2024 20:45:07 EST
+ */
+const UTC_DATE_STRING_REGEX = /^([a-zA-Z]{3}, [0-9]{2} [a-zA-Z]{3} [0-9]{4} [0-9]{2}:[0-9]{2}:[0-9]{2} [A-Z]{3})$/;
+function isUTCDateString(input) {
+  return UTC_DATE_STRING_REGEX.test(input);
+}
+/**
+ * Returns true only if the inputs have the same timezone, or both do not have a timezone set.
+ *
+ * @param a
+ * @param b
+ * @returns
+ */
+function hasSameTimezone(a, b) {
+  const tzA = a === null || a === void 0 ? void 0 : a.timezone;
+  const tzB = b === null || b === void 0 ? void 0 : b.timezone;
+  return valuesAreBothNullishOrEquivalent(tzA, tzB);
+}
+/**
+ * Constant for the UTC timezone string, "UTC".
+ */
+const UTC_TIMEZONE_STRING = 'UTC';
+function isConsideredUtcTimezoneString(timezone) {
+  return timezone == null || timezone === UTC_TIMEZONE_STRING;
+}
+/**
+ * Regex for an ISO8601DayString.
+ */
+const ISO8601_DAY_STRING_REGEX = /^\d{4,}-\d{2}-\d{2}$/;
+/**
+ * Regex for a string that starts as an ISO8601DayString.
+ */
+const ISO8601_DAY_STRING_START_REGEX = /^\d{4,}-\d{2}-\d{2}/;
+/**
+ * Returns the start of the input date's UTC time in UTC.
+ *
+ * I.E. 2022-01-02T04:00:00.000Z in GMT-6 returns 2022-01-02
+ *
+ * @param date
+ * @returns
+ */
+function startOfDayForUTCDateInUTC(date) {
+  return new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate()));
+}
+/**
+ * Returns the system's date in UTC.
+ *
+ * I.E. 2022-01-02T04:00:00.000Z in GMT-6 (10PM Jan 1st CST) returns 2022-01-01
+ *
+ * @param date
+ * @returns
+ */
+function startOfDayForSystemDateInUTC(date) {
+  return new Date(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()));
+}
+/**
+ * Parses a ISO8601DayString to a Date.
+ *
+ * @param inputDateString
+ * @returns
+ */
+function parseISO8601DayStringToUTCDate(inputDateString) {
+  const [yearString, monthString, dateString] = inputDateString.split('-');
+  return new Date(Date.UTC(Number(yearString), Number(monthString) - 1, Number(dateString)));
+}
+/**
+ * Returns true if the input date is strictly a
+ * @param input
+ * @returns
+ */
+function isISO8601DayString(input) {
+  return ISO8601_DAY_STRING_REGEX.test(input);
+}
+function isISO8601DayStringStart(input) {
+  return ISO8601_DAY_STRING_START_REGEX.test(input);
+}
+/**
+ * Regex for a MonthDaySlashDate.
+ */
+const MONTH_DAY_SLASH_DATE_STRING_REGEX = /^\d{1,2}\/\d{1,2}\/\d+$/;
+function isMonthDaySlashDate(input) {
+  return MONTH_DAY_SLASH_DATE_STRING_REGEX.test(input);
+}
+/**
+ * Converts the input MonthDaySlashDate to an ISO8601DayString.
+ *
+ * @param slashDate
+ * @returns
+ */
+function monthDaySlashDateToDateString(slashDate) {
+  let [month, day, year] = slashDate.split('/');
+  if (month.length === 1) {
+    month = `0${month}`;
+  }
+  if (day.length === 1) {
+    day = `0${day}`;
+  }
+  if (year.length === 2) {
+    year = `20${year}`;
+  }
+  const result = `${year}-${month}-${day}`;
+  return result;
+}
+const HOURS_IN_DAY = 24;
+const SECONDS_IN_MINUTE = 60;
+const MINUTES_IN_DAY = 1440;
+const MINUTES_IN_HOUR = 60;
+const MS_IN_SECOND = 1000;
+const MS_IN_MINUTE = MS_IN_SECOND * 60;
+const MS_IN_HOUR = MS_IN_MINUTE * 60;
+const MS_IN_DAY = MS_IN_HOUR * HOURS_IN_DAY;
+/**
+ * Retrieves the MonthOfYear value from the input Date.
+ *
+ * @param date
+ * @returns
+ */
+function monthOfYearFromDate(date) {
+  return monthOfYearFromDateMonth(date.getMonth());
+}
+function monthOfYearFromDateMonth(dateMonth) {
+  return dateMonth + 1;
+}
+function makeDateMonthForMonthOfYear(monthOfYear) {
+  return monthOfYear - 1;
+}
+/**
+ * Returns true if the value is a date.
+ *
+ * @param value
+ * @returns
+ */
+function isDate(value) {
+  return value instanceof Date || typeof value === 'object' && Object.prototype.toString.call(value) === '[object Date]';
+}
+
+const FRACTIONAL_HOURS_PRECISION_FUNCTION = cutValueToPrecisionFunction(3);
+/**
+ * Converts the number of minnutes to a fractional hour.
+ *
+ * Minutes are rounded down.
+ */
+function minutesToFractionalHours(minutes) {
+  return FRACTIONAL_HOURS_PRECISION_FUNCTION(Math.floor(minutes) / MINUTES_IN_HOUR);
+}
+/**
+ * Converts the fractional hour to a minute.
+ */
+function fractionalHoursToMinutes(hours) {
+  return Math.round(hours * MINUTES_IN_HOUR);
+}
+/**
+ * Rounds the input hour to the nearest FractionalHour.
+ *
+ * @param hour
+ * @returns
+ */
+function hourToFractionalHour(hour) {
+  return minutesToFractionalHours(fractionalHoursToMinutes(hour));
+}
+function computeNextFractionalHour(input, change) {
+  let result = input;
+  if (change.minutes) {
+    result += minutesToFractionalHours(change.minutes);
+  }
+  if (change.hours) {
+    result += hourToFractionalHour(change.hours);
+  }
+  return result;
+}
+/**
+ * Converts the input number of minutes to the equivalent in hours and minutes.
+ *
+ * @param inputMinutes
+ * @returns
+ */
+function minutesToHoursAndMinutes(inputMinutes) {
+  const hour = Math.floor(inputMinutes / 60);
+  const minute = inputMinutes % 60;
+  return {
+    hour,
+    minute
+  };
+}
+/**
+ * Reads the hour and minutes of the Date.
+ *
+ * @param date
+ * @returns
+ */
+function dateToHoursAndMinutes(date) {
+  const hour = date.getHours();
+  const minute = date.getMinutes();
+  return {
+    hour,
+    minute
+  };
+}
+/**
+ * Converts the input hours and minutes to a MinuteOfDay.
+ *
+ * @param hour
+ * @param minute
+ * @returns
+ */
+function toMinuteOfDay(hour, minute) {
+  return asMinuteOfDay(hour * 60 + minute);
+}
+/**
+ * Creates a new date from the minute of the day.
+ *
+ * @param minuteOfDay
+ * @param day
+ * @returns
+ */
+function dateFromMinuteOfDay(minuteOfDay, day) {
+  const date = day || new Date();
+  const {
+    hour,
+    minute
+  } = minutesToHoursAndMinutes(asMinuteOfDay(minuteOfDay));
+  date.setHours(hour, minute, 0, 0);
+  return date;
+}
+/**
+ * Converts a Date to a MinuteOfDay.
+ *
+ * @param date
+ * @returns
+ */
+function dateToMinuteOfDay(date) {
+  const {
+    hour,
+    minute
+  } = dateToHoursAndMinutes(date);
+  return toMinuteOfDay(hour, minute);
+}
+/**
+ * Converts the input minutes to a MinuteOfDay.
+ *
+ * @param minutes
+ * @returns
+ */
+function asMinuteOfDay(minutes) {
+  return Math.max(0, minutes % MINUTES_IN_DAY);
+}
+
 /**
  * Creates a CronExpression for the input number of minutes.
  *
@@ -9468,13 +9755,13 @@ function compareEqualityWithValueFromItemsFunctionFactory(readValues) {
  * @returns
  */
 function cronExpressionRepeatingEveryNMinutes(inputMinutes) {
-  let minutes;
-  let hours;
   let expression;
   if (inputMinutes >= 60) {
-    hours = Math.floor(inputMinutes / 60);
-    minutes = inputMinutes % 60;
-    expression = `${minutes} */${hours} * * *`; // every nth hour at the given minute
+    const {
+      hour,
+      minute
+    } = minutesToHoursAndMinutes(inputMinutes);
+    expression = `${minute} */${hour} * * *`; // every nth hour at the given minute
   } else {
     expression = `*/${inputMinutes} * * * *`; // every nth minute
   }
@@ -13544,154 +13831,6 @@ function randomBoolean(chance = 50) {
   })();
 }
 
-/**
- * TODO: Need to improve to support negative years.
- */
-const ISO_8601_DATE_STRING_REGEX = /(\d{4,})-(\d{2})-(\d{2})T(\d{2})\:(\d{2})\:(\d{2})(Z|[+-](\d{2})\:(\d{2}))?/;
-function isISO8601DateString(input) {
-  return ISO_8601_DATE_STRING_REGEX.test(input);
-}
-/**
- * Match examples:
- *
- * Sat, 03 Feb 2001 04:05:06 GMT
- * Tue, 14 Mar 2023 12:34:56 UTC
- * Wed, 25 May 2024 20:45:07 EST
- */
-const UTC_DATE_STRING_REGEX = /^([a-zA-Z]{3}, [0-9]{2} [a-zA-Z]{3} [0-9]{4} [0-9]{2}:[0-9]{2}:[0-9]{2} [A-Z]{3})$/;
-function isUTCDateString(input) {
-  return UTC_DATE_STRING_REGEX.test(input);
-}
-/**
- * Returns true only if the inputs have the same timezone, or both do not have a timezone set.
- *
- * @param a
- * @param b
- * @returns
- */
-function hasSameTimezone(a, b) {
-  const tzA = a === null || a === void 0 ? void 0 : a.timezone;
-  const tzB = b === null || b === void 0 ? void 0 : b.timezone;
-  return valuesAreBothNullishOrEquivalent(tzA, tzB);
-}
-/**
- * Constant for the UTC timezone string, "UTC".
- */
-const UTC_TIMEZONE_STRING = 'UTC';
-function isConsideredUtcTimezoneString(timezone) {
-  return timezone == null || timezone === UTC_TIMEZONE_STRING;
-}
-/**
- * Regex for an ISO8601DayString.
- */
-const ISO8601_DAY_STRING_REGEX = /^\d{4,}-\d{2}-\d{2}$/;
-/**
- * Regex for a string that starts as an ISO8601DayString.
- */
-const ISO8601_DAY_STRING_START_REGEX = /^\d{4,}-\d{2}-\d{2}/;
-/**
- * Returns the start of the input date's UTC time in UTC.
- *
- * I.E. 2022-01-02T04:00:00.000Z in GMT-6 returns 2022-01-02
- *
- * @param date
- * @returns
- */
-function startOfDayForUTCDateInUTC(date) {
-  return new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate()));
-}
-/**
- * Returns the system's date in UTC.
- *
- * I.E. 2022-01-02T04:00:00.000Z in GMT-6 (10PM Jan 1st CST) returns 2022-01-01
- *
- * @param date
- * @returns
- */
-function startOfDayForSystemDateInUTC(date) {
-  return new Date(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()));
-}
-/**
- * Parses a ISO8601DayString to a Date.
- *
- * @param inputDateString
- * @returns
- */
-function parseISO8601DayStringToUTCDate(inputDateString) {
-  const [yearString, monthString, dateString] = inputDateString.split('-');
-  return new Date(Date.UTC(Number(yearString), Number(monthString) - 1, Number(dateString)));
-}
-/**
- * Returns true if the input date is strictly a
- * @param input
- * @returns
- */
-function isISO8601DayString(input) {
-  return ISO8601_DAY_STRING_REGEX.test(input);
-}
-function isISO8601DayStringStart(input) {
-  return ISO8601_DAY_STRING_START_REGEX.test(input);
-}
-/**
- * Regex for a MonthDaySlashDate.
- */
-const MONTH_DAY_SLASH_DATE_STRING_REGEX = /^\d{1,2}\/\d{1,2}\/\d+$/;
-function isMonthDaySlashDate(input) {
-  return MONTH_DAY_SLASH_DATE_STRING_REGEX.test(input);
-}
-/**
- * Converts the input MonthDaySlashDate to an ISO8601DayString.
- *
- * @param slashDate
- * @returns
- */
-function monthDaySlashDateToDateString(slashDate) {
-  let [month, day, year] = slashDate.split('/');
-  if (month.length === 1) {
-    month = `0${month}`;
-  }
-  if (day.length === 1) {
-    day = `0${day}`;
-  }
-  if (year.length === 2) {
-    year = `20${year}`;
-  }
-  const result = `${year}-${month}-${day}`;
-  return result;
-}
-const HOURS_IN_DAY = 24;
-const SECONDS_IN_MINUTE = 60;
-const MINUTES_IN_DAY = 1440;
-const MINUTES_IN_HOUR = 60;
-const MS_IN_SECOND = 1000;
-const MS_IN_MINUTE = MS_IN_SECOND * 60;
-const MS_IN_HOUR = MS_IN_MINUTE * 60;
-const MS_IN_DAY = MS_IN_HOUR * HOURS_IN_DAY;
-/**
- * Retrieves the MonthOfYear value from the input Date.
- *
- * @param date
- * @returns
- */
-function monthOfYearFromDate(date) {
-  return monthOfYearFromDateMonth(date.getMonth());
-}
-function monthOfYearFromDateMonth(dateMonth) {
-  return dateMonth + 1;
-}
-function makeDateMonthForMonthOfYear(monthOfYear) {
-  return monthOfYear - 1;
-}
-/**
- * Returns true if the value is a date.
- *
- * @param value
- * @returns
- */
-function isDate(value) {
-  return value instanceof Date || typeof value === 'object' && Object.prototype.toString.call(value) === '[object Date]';
-}
-
 /**
  * Returns the day of the week for the input day.
  *
@@ -13849,41 +13988,6 @@ function getNextDay(day, days = 1) {
   return result;
 }
 
-const FRACTIONAL_HOURS_PRECISION_FUNCTION = cutValueToPrecisionFunction(3);
-/**
- * Converts the number of minnutes to a fractional hour.
- *
- * Minutes are rounded down.
- */
-function minutesToFractionalHours(minutes) {
-  return FRACTIONAL_HOURS_PRECISION_FUNCTION(Math.floor(minutes) / MINUTES_IN_HOUR);
-}
-/**
- * Converts the fractional hour to a minute.
- */
-function fractionalHoursToMinutes(hours) {
-  return Math.round(hours * MINUTES_IN_HOUR);
-}
-/**
- * Rounds the input hour to the nearest FractionalHour.
- *
- * @param hour
- * @returns
- */
-function hourToFractionalHour(hour) {
-  return minutesToFractionalHours(fractionalHoursToMinutes(hour));
-}
-function computeNextFractionalHour(input, change) {
-  let result = input;
-  if (change.minutes) {
-    result += minutesToFractionalHours(change.minutes);
-  }
-  if (change.hours) {
-    result += hourToFractionalHour(change.hours);
-  }
-  return result;
-}
-
 function timePeriodCounter(timePeriodLength, lastTimePeriodStart) {
   function reset(inputStart) {
     const start = inputStart !== null && inputStart !== void 0 ? inputStart : new Date();
@@ -14376,6 +14480,7 @@ exports.asDecisionFunction = asDecisionFunction;
 exports.asGetter = asGetter;
 exports.asIndexRangeCheckFunctionConfig = asIndexRangeCheckFunctionConfig;
 exports.asIterable = asIterable;
+exports.asMinuteOfDay = asMinuteOfDay;
 exports.asNumber = asNumber;
 exports.asObjectCopyFactory = asObjectCopyFactory;
 exports.asPromise = asPromise;
@@ -14444,6 +14549,9 @@ exports.cutValueToInteger = cutValueToInteger;
 exports.cutValueToPrecision = cutValueToPrecision;
 exports.cutValueToPrecisionFunction = cutValueToPrecisionFunction;
 exports.dateFromLogicalDate = dateFromLogicalDate;
+exports.dateFromMinuteOfDay = dateFromMinuteOfDay;
+exports.dateToHoursAndMinutes = dateToHoursAndMinutes;
+exports.dateToMinuteOfDay = dateToMinuteOfDay;
 exports.dayOfWeek = dayOfWeek;
 exports.daysOfWeekArray = daysOfWeekArray;
 exports.daysOfWeekFromEnabledDays = daysOfWeekFromEnabledDays;
@@ -14669,6 +14777,7 @@ exports.isolateWebsitePathFunction = isolateWebsitePathFunction;
 exports.itemCountForBatchIndex = itemCountForBatchIndex;
 exports.iterableToArray = iterableToArray;
 exports.iterableToMap = iterableToMap;
+exports.iterableToSet = iterableToSet;
 exports.iterablesAreSetEquivalent = iterablesAreSetEquivalent;
 exports.iterate = iterate;
 exports.iterateFilteredPages = iterateFilteredPages;
@@ -14767,6 +14876,7 @@ exports.minAndMaxIndexFunction = minAndMaxIndexFunction;
 exports.minAndMaxIndexItemsFunction = minAndMaxIndexItemsFunction;
 exports.minAndMaxNumber = minAndMaxNumber;
 exports.minutesToFractionalHours = minutesToFractionalHours;
+exports.minutesToHoursAndMinutes = minutesToHoursAndMinutes;
 exports.modelFieldConversions = modelFieldConversions;
 exports.modelFieldMapFunction = modelFieldMapFunction;
 exports.modelFieldMapFunctions = modelFieldMapFunctions;
@@ -14985,6 +15095,7 @@ exports.timePeriodCounter = timePeriodCounter;
 exports.timer = timer;
 exports.toAbsoluteSlashPathStartType = toAbsoluteSlashPathStartType;
 exports.toCaseInsensitiveStringArray = toCaseInsensitiveStringArray;
+exports.toMinuteOfDay = toMinuteOfDay;
 exports.toModelFieldConversions = toModelFieldConversions;
 exports.toModelMapFunctions = toModelMapFunctions;
 exports.toReadableError = toReadableError;