@zelgadis87/utils-core 5.0.2 → 5.0.4

package/esbuild/index.cjs

@@ -32,12 +32,12 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 
 // ../../node_modules/.pnpm/small-date@2.0.1/node_modules/small-date/lib/format.js
 var require_format = __commonJS({
-  "../../node_modules/.pnpm/small-date@2.0.1/node_modules/small-date/lib/format.js"(exports) {
+  "../../node_modules/.pnpm/small-date@2.0.1/node_modules/small-date/lib/format.js"(exports2) {
     "use strict";
-    Object.defineProperty(exports, "__esModule", {
+    Object.defineProperty(exports2, "__esModule", {
       value: true
     });
-    exports["default"] = format2;
+    exports2["default"] = format2;
     function ownKeys(object, enumerableOnly) {
       var keys = Object.keys(object);
       if (Object.getOwnPropertySymbols) {
@@ -153,24 +153,24 @@ var require_format = __commonJS({
 
 // ../../node_modules/.pnpm/small-date@2.0.1/node_modules/small-date/lib/index.js
 var require_lib = __commonJS({
-  "../../node_modules/.pnpm/small-date@2.0.1/node_modules/small-date/lib/index.js"(exports) {
+  "../../node_modules/.pnpm/small-date@2.0.1/node_modules/small-date/lib/index.js"(exports2) {
     "use strict";
-    Object.defineProperty(exports, "__esModule", {
+    Object.defineProperty(exports2, "__esModule", {
       value: true
     });
-    exports.format = void 0;
+    exports2.format = void 0;
     var _format = require_format();
     var _format2 = _interopRequireDefault(_format);
     function _interopRequireDefault(obj) {
       return obj && obj.__esModule ? obj : { "default": obj };
     }
-    exports.format = _format2["default"];
+    exports2.format = _format2["default"];
   }
 });
 
 // src/index.ts
-var src_exports = {};
-__export(src_exports, {
+var index_exports = {};
+__export(index_exports, {
   DataUpgrader: () => DataUpgrader,
   Deferred: () => Deferred,
   DeferredCanceledError: () => DeferredCanceledError,
@@ -236,6 +236,8 @@ __export(src_exports, {
   filterWithTypePredicate: () => filterWithTypePredicate,
   first: () => first,
   flatMapTruthys: () => flatMapTruthys,
+  getMessageFromError: () => getMessageFromError,
+  getStackFromError: () => getStackFromError,
   groupByBoolean: () => groupByBoolean,
   groupByBooleanWith: () => groupByBooleanWith,
   groupByNumber: () => groupByNumber,
@@ -297,8 +299,6 @@ __export(src_exports, {
   pipedInvoke: () => pipedInvoke,
   pipedInvokeFromArray: () => pipedInvokeFromArray,
   pluralize: () => pluralize,
-  printErrorMessage: () => printErrorMessage,
-  printErrorStack: () => printErrorStack,
   promiseSequence: () => promiseSequence,
   randomId: () => randomId,
   randomNumberInInterval: () => randomNumberInInterval,
@@ -330,7 +330,7 @@ __export(src_exports, {
   wrapWithString: () => wrapWithString,
   xor: () => xor
 });
-module.exports = __toCommonJS(src_exports);
+module.exports = __toCommonJS(index_exports);
 
 // src/async/Deferred.ts
 var DeferredCanceledError = class extends Error {
@@ -433,8 +433,7 @@ var RateThrottler = class {
         return slot.promise().then(() => fn());
       } finally {
         this._availableSlots.push(TimeInstant.now().addDuration(this.cooldown));
-        if (this._waitingRequests.length > 0)
-          this._waitingRequests.shift().resolve();
+        if (this._waitingRequests.length > 0) this._waitingRequests.shift().resolve();
       }
     };
     if (this._availableSlots.length > 0) {
@@ -600,16 +599,14 @@ function sumBy(arr, getter) {
   return sum(arr.map(getter));
 }
 function min(arr) {
-  if (arr.length === 0)
-    throw new Error("Cannot calculate value on empty array");
+  if (arr.length === 0) throw new Error("Cannot calculate value on empty array");
   return arr.reduce((min2, cur) => cur < min2 ? cur : min2);
 }
 function minBy(arr, getter) {
   return min(arr.map(getter));
 }
 function max(arr) {
-  if (arr.length === 0)
-    throw new Error("Cannot calculate value on empty array");
+  if (arr.length === 0) throw new Error("Cannot calculate value on empty array");
   return arr.reduce((max2, cur) => cur > max2 ? cur : max2);
 }
 function maxBy(arr, getter) {
@@ -681,17 +678,13 @@ function not(predicate) {
   return (t) => !predicate(t);
 }
 function and(...predicates) {
-  if (predicates.length === 0)
-    return constantTrue;
-  else if (predicates.length === 1)
-    return predicates[0];
+  if (predicates.length === 0) return constantTrue;
+  else if (predicates.length === 1) return predicates[0];
   return (t) => predicates.reduce((prev, cur) => prev ? cur(t) : false, true);
 }
 function or(...predicates) {
-  if (predicates.length === 0)
-    return constantTrue;
-  else if (predicates.length === 1)
-    return predicates[0];
+  if (predicates.length === 0) return constantTrue;
+  else if (predicates.length === 1) return predicates[0];
   return (t) => predicates.reduce((prev, cur) => prev ? true : cur(t), false);
 }
 function xor(a, b) {
@@ -735,13 +728,11 @@ function uniqByKey(arr, key) {
 
 // src/utils/arrays.ts
 function ensureArray(t) {
-  if (isNullOrUndefined(t))
-    return [];
+  if (isNullOrUndefined(t)) return [];
   return t instanceof Array ? t : [t];
 }
 function ensureReadableArray(t) {
-  if (isNullOrUndefined(t))
-    return [];
+  if (isNullOrUndefined(t)) return [];
   return t instanceof Array ? t : [t];
 }
 function isArray(t) {
@@ -760,8 +751,7 @@ function upsert(arr, item, isEqual) {
   }
 }
 function range(start, end) {
-  if (end < start)
-    throw new Error();
+  if (end < start) throw new Error();
   let length = end - start + 1;
   return new Array(length).fill(1).map((_, i) => start + i);
 }
@@ -820,8 +810,7 @@ function partition(arr, predicate) {
 function mapFirstTruthy(arr, mapFn) {
   for (let i = 0; i < arr.length; i++) {
     const result = mapFn(arr[i]);
-    if (result)
-      return result;
+    if (result) return result;
   }
   return null;
 }
@@ -849,8 +838,7 @@ function cssDeclarationRulesDictionaryToCss(syleDeclarationRulesForSelectorsProd
   const syleDeclarationRulesForSelectors = produceableToValue(syleDeclarationRulesForSelectorsProduceable);
   return Object.entries(syleDeclarationRulesForSelectors).map(([selector, styleDeclarationRules]) => {
     const cssRules = cssSelectorDeclarationRulesDictionaryToCss(styleDeclarationRules, indent + 1);
-    if (!cssRules.length)
-      return null;
+    if (!cssRules.length) return null;
     return repeat(tabulation, indent) + selector + space + openBracket + newLine + cssRules.join(newLine) + newLine + closeBracket;
   }).filter(Boolean).join(newLine + newLine);
 }
@@ -918,14 +906,14 @@ function asError(e) {
 function isError(e) {
   return e instanceof Error;
 }
-function printErrorMessage(error) {
-  const maybeCause = error.cause ? printErrorMessage(asError(error.cause)) : null;
+function getMessageFromError(error) {
+  const maybeCause = error.cause ? getMessageFromError(asError(error.cause)) : null;
   const cause = maybeCause ? `
 caused by: ${maybeCause}` : "";
   return `${error.name}: ${error.message}${cause}`;
 }
-function printErrorStack(error) {
-  const maybeCause = error.cause ? printErrorStack(asError(error.cause)) : null;
+function getStackFromError(error) {
+  const maybeCause = error.cause ? getStackFromError(asError(error.cause)) : null;
   const cause = maybeCause ? `
 caused by: ${maybeCause}` : "";
   const stack = error.stack && error.stack.includes(error.message) ? error.stack : error.message + " " + (error.stack ?? "");
@@ -937,8 +925,7 @@ function tryToParseJson(jsonContent) {
   return withTryCatch(() => JSON.parse(jsonContent));
 }
 function jsonCloneDeep(a) {
-  if (null === a || "object" !== typeof a)
-    return a;
+  if (null === a || "object" !== typeof a) return a;
   if (a instanceof Date) {
     return new Date(a.getTime());
   } else if (a instanceof Array) {
@@ -1045,13 +1032,10 @@ function clampInt0_100(n) {
 function tryToParseNumber(numberStr) {
   return withTryCatch(() => {
     const type = typeof ensureDefined(numberStr);
-    if (type !== "string")
-      throw new Error("Invalid number given: " + numberStr);
-    if (numberStr.trim().length === 0)
-      throw new Error("Invalid number given: " + numberStr);
+    if (type !== "string") throw new Error("Invalid number given: " + numberStr);
+    if (numberStr.trim().length === 0) throw new Error("Invalid number given: " + numberStr);
     const num = Number(numberStr);
-    if (isNaN(num))
-      throw new Error("Invalid number given: " + numberStr);
+    if (isNaN(num)) throw new Error("Invalid number given: " + numberStr);
     return num;
   });
 }
@@ -1131,8 +1115,7 @@ var StringParts = class _StringParts {
     return new _StringParts(...this.parts.map((part) => part.toLowerCase()));
   }
   capitalizeFirst() {
-    if (!this.length)
-      return this;
+    if (!this.length) return this;
     return new _StringParts(capitalizeWord(this.first), ...this.tail.map((part) => part.toLowerCase()));
   }
   capitalizeEach() {
@@ -1161,8 +1144,7 @@ var StringParts = class _StringParts {
     return this.toLowerCase().join("_");
   }
   toCamelCase() {
-    if (!this.length)
-      return "";
+    if (!this.length) return "";
     return [this.first.toLowerCase(), ...this.tail.map(capitalizeWord)].join("");
   }
   toKebabCase() {
@@ -1236,8 +1218,7 @@ function stringToNumber(s) {
 }
 function pad(str, n, char, where = "left") {
   const length = ensureDefined(str).length;
-  if (length >= ensureDefined(n))
-    return str;
+  if (length >= ensureDefined(n)) return str;
   if (ensureDefined(char).length !== 1)
     throw new Error("Illegal pad character");
   const padding = repeat(char, n - length);
@@ -1467,15 +1448,11 @@ var TimeUnit = class _TimeUnit {
   toDays(value) {
     return this.toUnit(value, _TimeUnit.DAYS);
   }
-  toWeeks(value) {
-    return this.toUnit(value, _TimeUnit.WEEKS);
-  }
   static MILLISECONDS = new _TimeUnit(1);
   static SECONDS = new _TimeUnit(1e3 * _TimeUnit.MILLISECONDS.multiplier);
   static MINUTES = new _TimeUnit(60 * _TimeUnit.SECONDS.multiplier);
   static HOURS = new _TimeUnit(60 * _TimeUnit.MINUTES.multiplier);
   static DAYS = new _TimeUnit(24 * _TimeUnit.HOURS.multiplier);
-  static WEEKS = new _TimeUnit(7 * _TimeUnit.DAYS.multiplier);
 };
 
 // src/time/TimeBase.ts
@@ -1484,18 +1461,33 @@ var TimeBase = class {
   constructor(value, unit) {
     this._ms = unit.toMs(value);
   }
+  /**
+   * Total number of milliseconds, rounded down.
+   */
   get ms() {
     return Math.floor(this._ms / TimeUnit.MILLISECONDS.multiplier);
   }
+  /**
+   * Total number of seconds, rounded down.
+   */
   get seconds() {
     return Math.floor(this._ms / TimeUnit.SECONDS.multiplier);
   }
+  /**
+   * Total number of minutes, rounded down.
+   */
   get minutes() {
     return Math.floor(this._ms / TimeUnit.MINUTES.multiplier);
   }
+  /**
+   * Total number of hours, rounded down.
+   */
   get hours() {
     return Math.floor(this._ms / TimeUnit.HOURS.multiplier);
   }
+  /**
+   * Total number of days, rounded down.
+   */
   get days() {
     return Math.floor(this._ms / TimeUnit.DAYS.multiplier);
   }
@@ -1540,17 +1532,18 @@ var TimeBase = class {
   }
   toUnits() {
     return {
-      days: Math.floor(this._ms / TimeUnit.DAYS.multiplier),
-      hours: Math.floor(this._ms / TimeUnit.HOURS.multiplier % 24),
-      minutes: Math.floor(this._ms / TimeUnit.MINUTES.multiplier % 60),
-      seconds: Math.floor(this._ms / TimeUnit.SECONDS.multiplier % 60)
+      milliseconds: this.ms % TimeUnit.SECONDS.multiplier,
+      seconds: Math.floor(this.seconds % 60),
+      minutes: Math.floor(this.minutes % 60),
+      hours: Math.floor(this.hours % 24),
+      days: Math.floor(this.days)
     };
   }
-  static toMs(units) {
+  static unitsToMs(units) {
     if (!units)
       throw new Error("Invalid units given");
     let ms = 0;
-    ms += units.ms ?? 0 * TimeUnit.MILLISECONDS.multiplier;
+    ms += (units.milliseconds ?? 0) * TimeUnit.MILLISECONDS.multiplier;
     ms += (units.seconds ?? 0) * TimeUnit.SECONDS.multiplier;
     ms += (units.minutes ?? 0) * TimeUnit.MINUTES.multiplier;
     ms += (units.hours ?? 0) * TimeUnit.HOURS.multiplier;
@@ -1600,8 +1593,7 @@ var TimeDuration = class _TimeDuration extends TimeBase {
   get formatted() {
     const format2 = (x, u1, y, u2) => `${x}${u1} ${pad(y.toString(), 2, "0")}${u2}`;
     const units = this.toUnits();
-    if (units.days >= 1)
-      return format2(units.days, "d", units.hours, "h");
+    if (units.days >= 1) return format2(units.days, "d", units.hours, "h");
     else if (units.hours >= 1)
       return format2(units.hours, "h", units.minutes, "m");
     else if (units.minutes >= 1)
@@ -1712,6 +1704,9 @@ var TimeDuration = class _TimeDuration extends TimeBase {
   isNotEmpty() {
     return this.ms > 0;
   }
+  toUnits() {
+    return super.toUnits();
+  }
   /**
   	* This method is used to provide a better DX when inspecting a TimeInstant object in DevTools.
   	*/
@@ -1725,7 +1720,7 @@ var TimeDuration = class _TimeDuration extends TimeBase {
     const match = humanTime.trim().match(/^(?:([0-9]+)d|)\s*(?:([0-9]+)h|)\s*(?:([0-9]+)m|)\s*(?:([0-9]+)s|)$/);
     if (match) {
       const [_, days, hours, minutes, seconds] = match;
-      return new _TimeDuration(TimeBase.toMs({ days: Number(days ?? 0), hours: Number(hours ?? 0), minutes: Number(minutes ?? 0), seconds: Number(seconds ?? 0) }), TimeUnit.MILLISECONDS);
+      return new _TimeDuration(TimeBase.unitsToMs({ days: Number(days ?? 0), hours: Number(hours ?? 0), minutes: Number(minutes ?? 0), seconds: Number(seconds ?? 0) }), TimeUnit.MILLISECONDS);
     }
     throw new Error("Failed to parse time: " + humanTime);
   }
@@ -1777,6 +1772,9 @@ var TimeDuration = class _TimeDuration extends TimeBase {
   static fromJSON(ms) {
     return _TimeDuration.ms(ms);
   }
+  static fromUnits(parameters) {
+    return _TimeDuration.ms(TimeBase.unitsToMs(parameters));
+  }
 };
 function isAllowedTimeDuration(t) {
   return typeof t === "number" && t > 0 || t instanceof TimeDuration;
@@ -1854,8 +1852,7 @@ var getFromDate = {
 };
 var toReferenceDate = (x) => {
   ensureDefined(x);
-  if (isTimeInstant(x))
-    return x.toDate();
+  if (isTimeInstant(x)) return x.toDate();
   return x;
 };
 function createTimeInstantFromParameters(aParameters, aReferenceDate = TimeInstant.now()) {
@@ -2250,6 +2247,12 @@ var Optional = class _Optional {
     this._value = t;
     this._present = true;
   }
+  setNullable(t) {
+    if (isDefined(t)) {
+      return this.set(t);
+    }
+    return this;
+  }
   clear() {
     this._value = void 0;
     this._present = false;
@@ -2275,32 +2278,69 @@ var Optional = class _Optional {
       callbackIfPresent(this.get());
     }
   }
-  orElse(newValue) {
+  orElseReturn(newValue) {
     if (this.isPresent()) {
-      return this._value;
+      return this.get();
     } else {
       return newValue;
     }
   }
-  orElseGet(newValueProducer) {
+  orElse = this.orElseReturn.bind(this);
+  orElseProduce(newValueProducer) {
     if (this.isPresent()) {
-      return this._value;
+      return this.get();
     } else {
       return newValueProducer();
     }
   }
-  orElseNullable(newValue) {
-    if (this.isEmpty())
-      return _Optional.ofNullable(newValue);
+  orElseGet = this.orElseProduce.bind(this);
+  orElseReturnAndApply(newValue) {
+    if (this.isPresent()) {
+      return this.get();
+    } else {
+      this.set(newValue);
+      return newValue;
+    }
+  }
+  orElseProduceAndApply(newValueProducer) {
+    if (this.isPresent()) {
+      return this.get();
+    } else {
+      const newValue = newValueProducer();
+      this.set(newValue);
+      return newValue;
+    }
+  }
+  orElseReturnNullableAndApply(newValue) {
+    if (this.isPresent()) {
+      return this;
+    } else {
+      this.setNullable(newValue);
+      return this;
+    }
+  }
+  orElseProduceNullableAndApply(newValueProducer) {
+    if (this.isPresent()) {
+      return this;
+    } else {
+      const newValue = newValueProducer();
+      this.setNullable(newValue);
+      return this;
+    }
+  }
+  orElseReturnNullable(newValue) {
+    if (this.isEmpty()) return _Optional.ofNullable(newValue);
     return this;
   }
-  orElseGetNullable(newValueProducer) {
+  orElseNullable = this.orElseReturnNullable.bind(this);
+  orElseProduceNullable(newValueProducer) {
     if (this.isEmpty()) {
       const newValue = newValueProducer();
       return _Optional.ofNullable(newValue);
     }
     return this;
   }
+  orElseGetNullable = this.orElseProduceNullable.bind(this);
   orElseThrow(errorProducer) {
     if (this.isEmpty())
       throw errorProducer();
@@ -2421,8 +2461,7 @@ var prioritizeSet = (fns, transform, set, reversed = false) => {
 var prioritizeArray = (fns, transform, arr, reversed = false) => {
   return compareNumbers(fns, (t) => {
     const r = transform(t);
-    if (!isDefined(r))
-      return Number.MAX_VALUE;
+    if (!isDefined(r)) return Number.MAX_VALUE;
     const indexOf = arr.indexOf(r);
     return indexOf === -1 ? Number.MAX_VALUE : indexOf;
   }, { direction: reversed ? "DESC" : "ASC", nullsFirst: false });
@@ -2870,6 +2909,8 @@ function isUpgradable(obj) {
   filterWithTypePredicate,
   first,
   flatMapTruthys,
+  getMessageFromError,
+  getStackFromError,
   groupByBoolean,
   groupByBooleanWith,
   groupByNumber,
@@ -2931,8 +2972,6 @@ function isUpgradable(obj) {
   pipedInvoke,
   pipedInvokeFromArray,
   pluralize,
-  printErrorMessage,
-  printErrorStack,
   promiseSequence,
   randomId,
   randomNumberInInterval,