@zelgadis87/utils-core 4.5.0 → 4.6.0

package/esbuild/index.cjs

@@ -1,13 +1,8 @@
 "use strict";
-var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __commonJS = (cb, mod) => function __require() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
-};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -20,155 +15,9 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// ../../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"(exports2) {
-    "use strict";
-    Object.defineProperty(exports2, "__esModule", {
-      value: true
-    });
-    exports2["default"] = format2;
-    function ownKeys(object, enumerableOnly) {
-      var keys = Object.keys(object);
-      if (Object.getOwnPropertySymbols) {
-        var symbols = Object.getOwnPropertySymbols(object);
-        if (enumerableOnly) {
-          symbols = symbols.filter(function(sym) {
-            return Object.getOwnPropertyDescriptor(object, sym).enumerable;
-          });
-        }
-        keys.push.apply(keys, symbols);
-      }
-      return keys;
-    }
-    function _objectSpread(target) {
-      for (var i = 1; i < arguments.length; i++) {
-        var source = arguments[i] != null ? arguments[i] : {};
-        if (i % 2) {
-          ownKeys(Object(source), true).forEach(function(key) {
-            _defineProperty(target, key, source[key]);
-          });
-        } else if (Object.getOwnPropertyDescriptors) {
-          Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
-        } else {
-          ownKeys(Object(source)).forEach(function(key) {
-            Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
-          });
-        }
-      }
-      return target;
-    }
-    function _defineProperty(obj, key, value) {
-      if (key in obj) {
-        Object.defineProperty(obj, key, { value, enumerable: true, configurable: true, writable: true });
-      } else {
-        obj[key] = value;
-      }
-      return obj;
-    }
-    var PATTERN_REGEX = /(M|y|d|D|h|H|m|s|S|G|Z|P|a)+/g;
-    var ESCAPE_REGEX = /\\"|"((?:\\"|[^"])*)"|(\+)/g;
-    var optionNames = {
-      y: "year",
-      M: "month",
-      d: "day",
-      D: "weekday",
-      S: "fractionalSecondDigits",
-      G: "era",
-      Z: "timeZoneName",
-      P: "dayPeriod",
-      a: "hour12",
-      h: "hour",
-      H: "hour",
-      m: "minute",
-      s: "second"
-    };
-    var values = {
-      y: ["numeric", "2-digit", void 0, "numeric"],
-      M: ["narrow", "2-digit", "short", "long"],
-      d: ["numeric", "2-digit"],
-      D: ["narrow", "short", "long"],
-      S: [1, 2, 3],
-      G: ["narrow", "short", "long"],
-      Z: ["short", "long"],
-      P: ["narrow", "short", "long"],
-      a: [true],
-      h: ["numeric", "2-digit"],
-      H: ["numeric", "2-digit"],
-      m: ["numeric", "2-digit"],
-      s: ["numeric", "2-digit"]
-    };
-    function padIf(condition, value, length) {
-      return condition && length === 2 && value / 10 < 1 ? "0" + value : value;
-    }
-    function formatType(date, type, length) {
-      var _options;
-      var _ref = arguments.length > 3 && arguments[3] !== void 0 ? arguments[3] : {}, locale = _ref.locale, timeZone = _ref.timeZone;
-      var option = optionNames[type];
-      var value = values[type][length - 1];
-      if (!value) {
-        return;
-      }
-      var options = (_options = {}, _defineProperty(_options, option, value), _defineProperty(_options, "timeZone", timeZone), _options);
-      if (type === "a") {
-        return Intl.DateTimeFormat(locale, _objectSpread(_objectSpread({}, options), {}, {
-          hour: "numeric"
-        })).formatToParts(date).pop().value;
-      }
-      if (type === "G" || type === "Z") {
-        return Intl.DateTimeFormat(locale, options).formatToParts(date).pop().value;
-      }
-      if (type === "H" || type === "h") {
-        return Intl.DateTimeFormat("en-GB", _objectSpread(_objectSpread({}, options), {}, {
-          hourCycle: type === "H" ? "h23" : "h11"
-        })).format(date).toLocaleLowerCase().replace(" am", "").replace(" pm", "");
-      }
-      return padIf(["m", "s"].includes(type) && value === "2-digit", Intl.DateTimeFormat(locale, options).format(date), 2);
-    }
-    function format2(date, pattern, config) {
-      return pattern.split(ESCAPE_REGEX).filter(function(sub) {
-        return sub !== void 0;
-      }).map(function(sub, index) {
-        if (index % 2 !== 0) {
-          return sub;
-        }
-        return sub.replace(PATTERN_REGEX, function(match) {
-          var type = match.charAt(0);
-          return formatType(date, type, match.length, config) || match;
-        });
-      }).join("");
-    }
-  }
-});
-
-// ../../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"(exports2) {
-    "use strict";
-    Object.defineProperty(exports2, "__esModule", {
-      value: true
-    });
-    exports2.format = void 0;
-    var _format = require_format();
-    var _format2 = _interopRequireDefault(_format);
-    function _interopRequireDefault(obj) {
-      return obj && obj.__esModule ? obj : { "default": obj };
-    }
-    exports2.format = _format2["default"];
-  }
-});
-
-// src/index.ts
+// packages/core/src/index.ts
 var src_exports = {};
 __export(src_exports, {
   ComparisonChain: () => ComparisonChain_default,
@@ -292,7 +141,9 @@ __export(src_exports, {
   pick: () => pick,
   pluralize: () => pluralize,
   promiseSequence: () => promiseSequence,
+  randomId: () => randomId,
   randomInterval: () => randomInterval,
+  randomNumberInInterval: () => randomNumberInInterval,
   randomPercentage: () => randomPercentage,
   range: () => range,
   repeat: () => repeat,
@@ -324,7 +175,7 @@ __export(src_exports, {
 });
 module.exports = __toCommonJS(src_exports);
 
-// src/async/Deferred.ts
+// packages/core/src/async/Deferred.ts
 var DeferredCanceledError = class extends Error {
   constructor() {
     super("Execution canceled");
@@ -409,7 +260,7 @@ var Deferred = class {
 };
 var Deferred_default = Deferred;
 
-// src/async/RateThrottler.ts
+// packages/core/src/async/RateThrottler.ts
 var RateThrottler = class {
   constructor(_frequency) {
     this._frequency = _frequency;
@@ -429,7 +280,8 @@ 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) {
@@ -448,7 +300,7 @@ function throttle(fn, frequence) {
   };
 }
 
-// src/async/Semaphore.ts
+// packages/core/src/async/Semaphore.ts
 var Semaphore = class {
   constructor(_availableSlots = 1) {
     this._availableSlots = _availableSlots;
@@ -477,8 +329,8 @@ var Semaphore = class {
     }
   }
   async execute(fn, cooldown = TimeDuration.ZERO) {
-    return this._awaitSlot().then(() => fn()).finally(() => {
-      void cooldown.promise().then(() => this._releaseSlot());
+    return this._awaitSlot().then(fn).finally(() => {
+      void cooldown.delay(() => this._releaseSlot());
     });
   }
   get availableSlots() {
@@ -492,7 +344,7 @@ var Semaphore = class {
   }
 };
 
-// src/utils/nulls.ts
+// packages/core/src/utils/nulls.ts
 function ensureDefined(v, name = "value") {
   if (isDefined(v))
     return v;
@@ -518,7 +370,7 @@ function ifNullOrUndefined(source, callback) {
     callback();
 }
 
-// src/utils/arrays/groupBy.ts
+// packages/core/src/utils/arrays/groupBy.ts
 function groupByString(arr, field) {
   return groupByStringWith(arr, (t) => t[field]);
 }
@@ -544,7 +396,7 @@ function groupBySymbolWith(arr, getter) {
   return doGroupByWith(arr, getter);
 }
 function doGroupByWith(arr, getter) {
-  return arr.reduce((dict, cur) => {
+  return [...arr].reduce((dict, cur) => {
     const key = getter(cur);
     if (key !== null && key !== void 0) {
       const arr2 = dict[key] ?? [];
@@ -555,7 +407,7 @@ function doGroupByWith(arr, getter) {
   }, {});
 }
 
-// src/utils/arrays/indexBy.ts
+// packages/core/src/utils/arrays/indexBy.ts
 function indexByString(arr, field) {
   return indexByStringWith(arr, (t) => t[field]);
 }
@@ -583,7 +435,7 @@ function doIndexByWith(arr, getter) {
   }, {});
 }
 
-// src/utils/arrays/statistics.ts
+// packages/core/src/utils/arrays/statistics.ts
 function average(arr) {
   const f = 1 / arr.length;
   return arr.reduce((tot, cur) => tot + cur * f, 0);
@@ -595,21 +447,23 @@ 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) {
   return max(arr.map(getter));
 }
 
-// src/utils/functions/constant.ts
+// packages/core/src/utils/functions/constant.ts
 function constant(v) {
   return () => v;
 }
@@ -624,7 +478,7 @@ var alwaysFalse = constantFalse;
 var constantZero = constant(0);
 var constantOne = constant(1);
 
-// src/utils/functions/iff.ts
+// packages/core/src/utils/functions/iff.ts
 function iff(firstPredicate, valueIfTrue) {
   if (firstPredicate === true || firstPredicate instanceof Function && firstPredicate() === true) {
     const ret = {
@@ -641,7 +495,7 @@ function iff(firstPredicate, valueIfTrue) {
   }
 }
 
-// src/utils/functions.ts
+// packages/core/src/utils/functions.ts
 function isFunction(t) {
   return typeof t === "function";
 }
@@ -654,20 +508,24 @@ 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) {
   return (t) => a(t) !== b(t);
 }
 
-// src/utils/arrays/uniqBy.ts
+// packages/core/src/utils/arrays/uniqBy.ts
 function uniq(arr) {
   return uniqBy(arr, identity);
 }
@@ -688,13 +546,15 @@ function uniqByKey(arr, key) {
   return uniqBy(arr, (item) => item[key]);
 }
 
-// src/utils/arrays.ts
+// packages/core/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) {
@@ -713,7 +573,8 @@ 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);
 }
@@ -772,7 +633,8 @@ 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;
 }
@@ -780,7 +642,7 @@ function makeArrayEmpty(arr) {
   arr.splice(0, arr.length);
 }
 
-// src/utils/booleans.ts
+// packages/core/src/utils/booleans.ts
 function isTrue(x) {
   return x === true;
 }
@@ -788,7 +650,7 @@ function isFalse(x) {
   return x === false;
 }
 
-// src/utils/errors/withTryCatch.ts
+// packages/core/src/utils/errors/withTryCatch.ts
 function withTryCatch(fn, errMapFn) {
   try {
     return [fn(), void 0];
@@ -800,7 +662,7 @@ async function withTryCatchAsync(fn, errMapFn) {
   return fn().then((value) => [value, void 0], (e) => [void 0, (errMapFn ?? identity)(asError(e))]);
 }
 
-// src/utils/errors.ts
+// packages/core/src/utils/errors.ts
 function asError(e) {
   if (e === void 0 || e === null)
     return new Error("Void message");
@@ -816,12 +678,13 @@ function isError(e) {
   return e instanceof Error;
 }
 
-// src/utils/json.ts
+// packages/core/src/utils/json.ts
 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) {
@@ -848,7 +711,7 @@ function omitFromJsonObject(o, ...keys) {
 }
 var omit = omitFromJsonObject;
 
-// src/utils/numbers/round.ts
+// packages/core/src/utils/numbers/round.ts
 var roundModes = {
   "toNearest": Math.round,
   "toLower": Math.floor,
@@ -867,7 +730,7 @@ var roundToUpper = (n, precision = 0) => round(n, precision, "toUpper");
 var roundTowardsZero = (n, precision = 0) => round(n, precision, "towardsZero");
 var roundAwayFromZero = (n, precision = 0) => round(n, precision, "awayFromZero");
 
-// src/utils/numbers.ts
+// packages/core/src/utils/numbers.ts
 function ensurePositiveNumber(v, name = "value") {
   if (v !== void 0 && v !== null && v > 0)
     return v;
@@ -926,15 +789,18 @@ function clamp(n, min2, max2) {
 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;
   });
 }
 
-// src/utils/promises.ts
+// packages/core/src/utils/promises.ts
 function asPromise(promisable) {
   return Promise.resolve(promisable);
 }
@@ -952,15 +818,17 @@ function delayPromise(duration) {
   return (result) => duration.promise().then(() => result);
 }
 
-// src/utils/random.ts
-function randomInterval(min2, max2) {
+// packages/core/src/utils/random.ts
+var randomInterval = (min2, max2) => randomNumberInInterval(min2, max2);
+var randomPercentage = (min2, max2) => randomNumberInInterval(min2, max2) / 100;
+function randomNumberInInterval(min2, max2) {
   return Math.floor(Math.random() * (max2 - min2 + 1) + min2);
 }
-function randomPercentage(min2, max2) {
-  return randomInterval(min2, max2) / 100;
-}
+var randomId = (length) => {
+  return Math.random().toString(36).substring(2, length + 2);
+};
 
-// src/utils/records/entries.ts
+// packages/core/src/utils/records/entries.ts
 function dictToEntries(obj) {
   return Object.entries(obj);
 }
@@ -971,7 +839,7 @@ function mapEntries(dict, mapper) {
   return entriesToDict(dictToEntries(dict).map((entry) => mapper(entry)));
 }
 
-// src/utils/records.ts
+// packages/core/src/utils/records.ts
 function dictToList(obj) {
   return Object.keys(obj).map((key) => obj[key]);
 }
@@ -982,7 +850,7 @@ function pick(o, keys) {
   }, {});
 }
 
-// src/utils/strings/StringParts.ts
+// packages/core/src/utils/strings/StringParts.ts
 var StringParts = class _StringParts {
   _parts;
   constructor(...parts) {
@@ -995,7 +863,8 @@ 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() {
@@ -1024,7 +893,8 @@ 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() {
@@ -1067,7 +937,7 @@ var StringParts = class _StringParts {
   };
 };
 
-// src/utils/strings.ts
+// packages/core/src/utils/strings.ts
 function hashCode(str) {
   let hash = 0;
   for (let i = 0; i < str.length; ++i)
@@ -1090,7 +960,8 @@ 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);
@@ -1130,7 +1001,7 @@ function wrapWithString(str, delimiter) {
 }
 var wrap = wrapWithString;
 
-// src/lazy/Lazy.ts
+// packages/core/src/lazy/Lazy.ts
 var Lazy = class _Lazy {
   _value = void 0;
   _initialized = false;
@@ -1188,7 +1059,7 @@ var Lazy = class _Lazy {
   }
 };
 
-// src/lazy/LazyAsync.ts
+// packages/core/src/lazy/LazyAsync.ts
 var LazyAsync = class _LazyAsync {
   _promise = void 0;
   _pending = false;
@@ -1270,10 +1141,10 @@ var LazyAsync = class _LazyAsync {
   }
 };
 
-// src/time/TimeInstant.ts
-var import_small_date = __toESM(require_lib());
+// packages/core/src/time/TimeInstant.ts
+var import_small_date = require("small-date");
 
-// src/time/TimeUnit.ts
+// packages/core/src/time/TimeUnit.ts
 var TimeUnit = class _TimeUnit {
   constructor(multiplier) {
     this.multiplier = multiplier;
@@ -1307,7 +1178,7 @@ var TimeUnit = class _TimeUnit {
   static WEEKS = new _TimeUnit(7 * _TimeUnit.DAYS.multiplier);
 };
 
-// src/time/TimeBase.ts
+// packages/core/src/time/TimeBase.ts
 var TimeBase = class {
   _ms;
   constructor(value, unit) {
@@ -1391,7 +1262,7 @@ var TimeBase = class {
   }
 };
 
-// src/time/TimeDuration.ts
+// packages/core/src/time/TimeDuration.ts
 var TimeDuration = class _TimeDuration extends TimeBase {
   constructor(value, unit) {
     super(value, unit);
@@ -1424,11 +1295,11 @@ var TimeDuration = class _TimeDuration extends TimeBase {
     return _TimeDuration.ms(this.ms / times);
   }
   /**
-   * Returns the current duration in a human readable format, prioritizing the most significant unit of time and excluding the rest.
-   * @todo[2023-06] Should allow more customization options
-   * @todo[2023-06] By default should show the secondary unit only when actually needed (eg, 1h 20m & 3h, instead of 1h 20m & 3h 28m)
-   * @todo[2023-06] Should not allow negative durations, as this is a duration and not an instant.
-   * @returns the duration, with only the most significant units displayed as a human readable string, eg: 1d 20h, 10m 30s.
+  	* Returns the current duration in a human readable format, prioritizing the most significant unit of time and excluding the rest.
+  	* @todo[2023-06] Should allow more customization options
+  	* @todo[2023-06] By default should show the secondary unit only when actually needed (eg, 1h 20m & 3h, instead of 1h 20m & 3h 28m)
+  	* @todo[2023-06] Should not allow negative durations, as this is a duration and not an instant.
+  	* @returns the duration, with only the most significant units displayed as a human readable string, eg: 1d 20h, 10m 30s.
   */
   get formatted() {
     const format2 = (x, u1, y, u2) => `${x}${u1} ${pad(y.toString(), 2, "0")}${u2}`;
@@ -1458,7 +1329,7 @@ var TimeDuration = class _TimeDuration extends TimeBase {
   timeout(cb) {
     return setTimeout(cb, this.ms);
   }
-  promise() {
+  cancelablePromise() {
     const deferred = new Deferred_default();
     if (this.ms > 0) {
       this.timeout(() => deferred.resolve());
@@ -1467,8 +1338,18 @@ var TimeDuration = class _TimeDuration extends TimeBase {
     }
     return deferred.asCancelablePromise();
   }
+  promise() {
+    if (this.isEmpty())
+      return Promise.resolve();
+    const deferred = new Deferred_default();
+    this.timeout(() => deferred.resolve());
+    return deferred.asPromise();
+  }
   delay(cb) {
-    const deferred = this.promise();
+    void this.promise().then(() => cb());
+  }
+  cancelableDelay(cb) {
+    const deferred = this.cancelablePromise();
     void deferred.then(() => {
       cb();
     }, (err) => {
@@ -1623,7 +1504,7 @@ function isAllowedTimeDuration(t) {
 }
 var TimeDuration_default = TimeDuration;
 
-// src/time/TimeInstantBuilder.ts
+// packages/core/src/time/TimeInstantBuilder.ts
 var isRelativeNumber = (x) => x !== void 0 && x.length > 0 && (x[0] === "+" || x[0] === "-");
 var defaultTimeInstantCreationParameters = {
   year: { relative: 0, relativeTo: "now" },
@@ -1692,7 +1573,8 @@ 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()) {
@@ -1756,7 +1638,7 @@ function timeInstantBuilder() {
   return ret;
 }
 
-// src/time/TimeInstant.ts
+// packages/core/src/time/TimeInstant.ts
 var TimeInstant = class _TimeInstant extends TimeBase {
   constructor(number, unit) {
     super(number, unit);
@@ -1776,6 +1658,14 @@ var TimeInstant = class _TimeInstant extends TimeBase {
   distanceFromNow() {
     return TimeDuration_default.fromMs(Math.abs(this.ms - Date.now()));
   }
+  timeLeftFrom(instant) {
+    const distance = this.ms - instant.ms;
+    return TimeDuration_default.fromMs(Math.max(distance, 0));
+  }
+  timeLeftFromNow() {
+    const distance = this.ms - Date.now();
+    return TimeDuration_default.fromMs(Math.max(distance, 0));
+  }
   distanceFromStartOfDay() {
     return this.distanceFrom(this.atStartOfDay());
   }
@@ -1789,14 +1679,16 @@ var TimeInstant = class _TimeInstant extends TimeBase {
     return this.atTime({ hours: 23, minutes: 59, seconds: 59, milliseconds: 999 });
   }
   promise() {
-    const ms = this.ms - Date.now();
-    const duration = TimeDuration_default.fromMs(Math.max(ms, 0));
-    return duration.promise();
+    return this.timeLeftFromNow().promise();
+  }
+  cancelablePromise() {
+    return this.timeLeftFromNow().cancelablePromise();
   }
   delay(cb) {
-    const ms = this.ms - Date.now();
-    const duration = TimeDuration_default.fromMs(Math.max(ms, 0));
-    return duration.delay(cb);
+    return this.timeLeftFromNow().delay(cb);
+  }
+  cancelableDelay(cb) {
+    return this.timeLeftFromNow().cancelableDelay(cb);
   }
   ensureInTheFuture() {
     if (!this.isInTheFuture)
@@ -1911,20 +1803,23 @@ var TimeInstant = class _TimeInstant extends TimeBase {
     }
   }
   /**
-  	* @deprecated[04/07/2023]: Use distanceFromNow instead
-  	*/
+   * @deprecated: Use {@link distanceFromNow} instead
+  */
+  // TODO[2023-07-04, Deprecated]: Remove this method in a future version
   fromNow() {
     return TimeDuration_default.ms(this.ms - Date.now());
   }
   /**
-  	* @deprecated[04/07/2023]: Use distanceFrom instead
-  	*/
+   * @deprecated: Use {@link distanceFrom} instead
+  */
+  // TODO[2023-07-04, Deprecated]: Remove this method in a future version
   from(instant) {
     return TimeDuration_default.ms(this.ms - instant.ms);
   }
   /**
-  	* @deprecated[04/07/2023]: Use distanceFromUnixTimestamp instead
-  	*/
+   * @deprecated: Use {@link distanceFromUnixTimestamp} instead
+  */
+  // TODO[2023-07-04, Deprecated]: Remove this method in a future version
   fromTimestamp(timestamp2) {
     return TimeDuration_default.ms(this.ms - timestamp2);
   }
@@ -1965,8 +1860,8 @@ var TimeInstant = class _TimeInstant extends TimeBase {
     return timeInstantBuilder();
   }
   /**
-  	* @deprecated[19/07/2023] Use {@link fromParameters} instead.
-  	*/
+   * @deprecated[19/07/2023] Use {@link fromParameters} instead.
+   */
   static fromUnits({ date, month, year, hours, minutes, seconds }) {
     const dt = Date.UTC(year, month - 1, date, hours ?? 0, minutes ?? 0, seconds ?? 0);
     if (isNaN(dt))
@@ -2024,9 +1919,9 @@ var TimeInstant = class _TimeInstant extends TimeBase {
     return this.toDate().getFullYear();
   }
   /**
-  	* Returns the week number represented by this instant, according to the ISO 8601 standard.
+   * Returns the week number represented by this instant, according to the ISO 8601 standard.
   	* Please note that the instant and the week number could be of two different years, eg the friday 1st january is actually part of week 52 of the previous year.
-  	*/
+   */
   get weekNumber() {
     const date = this.toDate();
     const oneDay = 1e3 * 60 * 60 * 24;
@@ -2037,8 +1932,8 @@ var TimeInstant = class _TimeInstant extends TimeBase {
     return { weekNumber, year: thursdayOfThisWeek.getFullYear() };
   }
   /**
-  	* This method is used to provide a better DX when inspecting a TimeInstant object in DevTools.
-  	*/
+   * This method is used to provide a better DX when inspecting a TimeInstant object in DevTools.
+   */
   get _time() {
     return this.asHumanTimestamp();
   }
@@ -2055,7 +1950,7 @@ function isTimeInstant(x) {
 }
 var TimeInstant_default = TimeInstant;
 
-// src/Logger.ts
+// packages/core/src/Logger.ts
 var LEVELS = ["log", "debug", "info", "warn", "error"];
 var timestamp = () => TimeInstant_default.now().asTimeString();
 var Logger = class {
@@ -2092,7 +1987,7 @@ var Logger = class {
   }
 };
 
-// src/Optional.ts
+// packages/core/src/Optional.ts
 var Optional = class _Optional {
   _present;
   _value;
@@ -2206,7 +2101,7 @@ var ErrorCannotInstantiatePresentOptionalWithEmptyValue = class extends Error {
   }
 };
 
-// src/sorting/ComparisonChain.ts
+// packages/core/src/sorting/ComparisonChain.ts
 var defaultCompareValueOptions = {
   nullsFirst: false,
   direction: "ASC"
@@ -2248,8 +2143,10 @@ function compareBooleans(options) {
   const fn = (a, b) => {
     if (a === b)
       return 0;
-    if (isNullOrUndefined(a)) return opts.nullsFirst ? -1 : 1;
-    if (isNullOrUndefined(b)) return opts.nullsFirst ? 1 : -1;
+    if (isNullOrUndefined(a))
+      return opts.nullsFirst ? -1 : 1;
+    if (isNullOrUndefined(b))
+      return opts.nullsFirst ? 1 : -1;
     return a === true && opts.truesFirst || a === false && !opts.truesFirst ? -1 : 1;
   };
   return (a, b) => applyDirection(fn(a, b), opts.direction);
@@ -2364,7 +2261,7 @@ function getComparisonFunction(arg) {
   return arg instanceof ComparisonChain ? arg.compare : arg;
 }
 
-// src/sorting/Sorter.ts
+// packages/core/src/sorting/Sorter.ts
 var defaultCompareValuesOptions = {
   nullsFirst: false
 };
@@ -2430,7 +2327,8 @@ 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 });
@@ -2596,7 +2494,7 @@ var Sorter = {
 };
 var Sorting = Sorter;
 
-// src/time/RandomTimeDuration.ts
+// packages/core/src/time/RandomTimeDuration.ts
 function randomize(unit) {
   return (a, b) => {
     return TimeDuration_default.fromMs(randomInterval(unit.toMs(a), unit.toMs(b)));
@@ -2612,7 +2510,7 @@ var RandomTimeDuration = class {
   static days = randomize(TimeUnit.DAYS);
 };
 
-// src/time/TimeFrequency.ts
+// packages/core/src/time/TimeFrequency.ts
 var TimeFrequency = class _TimeFrequency {
   constructor(times, period) {
     this.times = times;
@@ -2633,7 +2531,7 @@ var TimeFrequency = class _TimeFrequency {
   }
 };
 
-// src/time/TimeRange.ts
+// packages/core/src/time/TimeRange.ts
 var TimeRange = class _TimeRange {
   constructor(start, duration) {
     this.start = start;
@@ -2654,7 +2552,7 @@ var TimeRange = class _TimeRange {
   }
 };
 
-// src/upgrade/errors.ts
+// packages/core/src/upgrade/errors.ts
 var UnavailableUpgradeError = class extends Error {
   constructor(data, from, to) {
     super(`No transition found to upgrade data from version ${from} to version ${to}.`);
@@ -2672,7 +2570,7 @@ var EmptyUpgradeError = class extends Error {
   }
 };
 
-// src/upgrade/getTransitionsPath.ts
+// packages/core/src/upgrade/getTransitionsPath.ts
 var DEBUG_ENABLED = false;
 function getTransitionsPath(matrix, from, to) {
   return internalGetTransitionsPath(matrix, from, to, 0, DEBUG_ENABLED);
@@ -2721,7 +2619,7 @@ function printTransitions(transitions) {
   }, "" + transitions[0].from);
 }
 
-// src/upgrade/DataUpgrader.ts
+// packages/core/src/upgrade/DataUpgrader.ts
 var VERSION_FIELD = "$version";
 var DataUpgrader = class _DataUpgrader {
   constructor(latestVersion) {
@@ -2904,7 +2802,9 @@ function isUpgradable(obj) {
   pick,
   pluralize,
   promiseSequence,
+  randomId,
   randomInterval,
+  randomNumberInInterval,
   randomPercentage,
   range,
   repeat,