@andrew_l/toolkit 0.2.4 → 0.2.5

package/dist/index.mjs

@@ -1,9 +1,9 @@
-import _get from 'lodash/get';
-import _cloneDeep from 'lodash/cloneDeep';
-import _cloneDeepWith from 'lodash/cloneDeepWith';
-import _defaultsDeep from 'lodash/defaultsDeep';
-import _set from 'lodash/set';
-import _unset from 'lodash/unset';
+import _get from 'lodash/get.js';
+import _cloneDeep from 'lodash/cloneDeep.js';
+import _cloneDeepWith from 'lodash/cloneDeepWith.js';
+import _defaultsDeep from 'lodash/defaultsDeep.js';
+import _set from 'lodash/set.js';
+import _unset from 'lodash/unset.js';
 
 const isClient = typeof globalThis?.window !== "undefined";
 const isDef = (val) => typeof val !== "undefined";
@@ -237,6 +237,30 @@ function difference(...arrays) {
   return Array.from(set);
 }
 
+function groupBy(array, keyBy, objectMode) {
+  const getItemKey = isFunction(keyBy) ? keyBy : (item) => item?.[keyBy];
+  let key;
+  if (objectMode === true) {
+    const result2 = {};
+    for (const item of array) {
+      key = getItemKey(item);
+      result2[key] = result2[key] || [];
+      result2[key].push(item);
+    }
+    return result2;
+  }
+  const result = /* @__PURE__ */ new Map();
+  for (const item of array) {
+    key = getItemKey(item);
+    if (!result.has(key)) {
+      result.set(key, [item]);
+    } else {
+      result.get(key).push(item);
+    }
+  }
+  return result;
+}
+
 function intersection(...arrays) {
   if (arrays.length === 0) return [];
   if (arrays.length === 1) return arrays[0];
@@ -347,6 +371,7 @@ let AssertionError;
     (r) => r.BrowserAssertionError
   ) : await import('node:assert').then((r) => r.AssertionError);
 })();
+
 function ok(value, message) {
   if (!value) {
     throw toError$1(
@@ -368,6 +393,11 @@ function equal(actual, expected, message) {
     });
   }
 }
+function empty$1(value, message) {
+  if (isEmpty(value)) {
+    throw toError$1(empty$1, value, message, "Expected not empty value.");
+  }
+}
 function object(value, message) {
   if (!isObject(value)) {
     throw toError$1(object, value, message, "Expected object value.");
@@ -398,6 +428,36 @@ function number$1(value, message) {
     throw toError$1(number$1, value, message, "Expected number value.");
   }
 }
+function date(value, message) {
+  if (!isDate(value)) {
+    throw toError$1(date, value, message, "Expected date value.");
+  }
+}
+function fn(value, message) {
+  if (!isNumber(value)) {
+    throw toError$1(fn, value, message, "Expected function value.");
+  }
+}
+function greaterThan(value, target, message) {
+  if (!isNumber(value) || value < target) {
+    throw toError$1(
+      greaterThan,
+      value,
+      message,
+      "Expected number value greater then " + target + "."
+    );
+  }
+}
+function lessThan(value, target, message) {
+  if (!isNumber(value) || value > target) {
+    throw toError$1(
+      lessThan,
+      value,
+      message,
+      "Expected number value less then " + target + "."
+    );
+  }
+}
 function array(value, message) {
   if (!Array.isArray(value)) {
     throw toError$1(array, value, message, "Expected array value.");
@@ -431,7 +491,12 @@ const assert = {
   arrayNumbers: arrayNumbers,
   arrayStrings: arrayStrings,
   boolean: boolean,
+  date: date,
+  empty: empty$1,
   equal: equal,
+  fn: fn,
+  greaterThan: greaterThan,
+  lessThan: lessThan,
   notEmptyString: notEmptyString,
   number: number$1,
   object: object,
@@ -439,6 +504,53 @@ const assert = {
   string: string
 };
 
+function weightedRoundRobin(arr) {
+  ok(arr.length > 0, "Array must contain at least one item.");
+  const instance = new WeightedRoundRobin(
+    arr.map((v) => ({
+      item: v.item,
+      weight: Math.min(v.weight ?? 1, 1)
+    }))
+  );
+  return () => instance.nextItem();
+}
+const gcd = (a, b) => !b ? a : gcd(b, a % b);
+class WeightedRoundRobin {
+  constructor(items) {
+    this.items = items;
+    this.maxWeight = this._calculateMaxWeight();
+    this.gcdWeight = this._calculateGCD();
+  }
+  currentIndex = -1;
+  currentWeight = 0;
+  maxWeight;
+  gcdWeight;
+  _calculateGCD() {
+    return this.items.reduce(
+      (acc, curr) => gcd(acc, curr.weight),
+      this.items[0].weight
+    );
+  }
+  _calculateMaxWeight() {
+    return Math.max(...this.items.map((s) => s.weight));
+  }
+  nextItem() {
+    const n = this.items.length;
+    while (true) {
+      this.currentIndex = (this.currentIndex + 1) % n;
+      if (this.currentIndex === 0) {
+        this.currentWeight -= this.gcdWeight;
+        if (this.currentWeight <= 0) {
+          this.currentWeight = this.maxWeight;
+        }
+      }
+      if (this.items[this.currentIndex].weight >= this.currentWeight) {
+        return this.items[this.currentIndex].item;
+      }
+    }
+  }
+}
+
 class Base64Encoding {
   alphabet;
   padding;
@@ -647,13 +759,12 @@ const def = (obj, key, value, writable = false) => {
 const rndCharacters = "abcdefghijklmnopqrstuvwxyz0123456789";
 const charactersLength = rndCharacters.length;
 function randomString(length) {
-  let result = "";
-  for (let i = 0; i < length; i++) {
-    result += rndCharacters.charAt(
-      Math.floor(Math.random() * charactersLength)
-    );
+  let str = "";
+  let num = isNumber(length) ? Math.max(0, length) : 0;
+  while (num--) {
+    str += rndCharacters[charactersLength * Math.random() | 0];
   }
-  return result;
+  return str;
 }
 
 const objectKeys = /* @__PURE__ */ new WeakMap();
@@ -1446,27 +1557,57 @@ function flatten(obj, {
   isObjectCompare = isObject
 } = {}) {
   const result = {};
-  const processed = /* @__PURE__ */ new WeakSet();
-  const handle = (node, prefix, initial) => {
-    if (processed.has(node)) return;
-    if (isObjectCompare(node)) {
-      processed.add(node);
-      prefix = prefix && !initial ? `${prefix}${separator}` : prefix;
-      for (const [key, value] of Object.entries(node)) {
-        handle(value, `${prefix}${key}`);
-      }
+  const seen = /* @__PURE__ */ new WeakSet();
+  if (isObjectCompare(obj)) {
+    iter(
+      result,
+      seen,
+      isObjectCompare,
+      separator,
+      withArrays,
+      obj,
+      initialPrefix,
+      true
+    );
+  }
+  return result;
+}
+function iter(output, seen, isObjectCompare, separator, withArrays, val, key, initial) {
+  if (seen.has(val)) return;
+  let k, pfx = key && !initial ? key + separator : key;
+  if (Array.isArray(val)) {
+    seen.add(val);
+    if (!withArrays) {
+      output[key] = val;
       return;
     }
-    if (Array.isArray(node) && withArrays) {
-      processed.add(node);
-      prefix = prefix && !initial ? `${prefix}${separator}` : prefix;
-      node.forEach((value, idx) => handle(value, `${prefix}${idx}`));
-      return;
+    for (k = 0; k < val.length; k++) {
+      iter(
+        output,
+        seen,
+        isObjectCompare,
+        separator,
+        withArrays,
+        val[k],
+        pfx + k
+      );
     }
-    result[prefix] = node;
-  };
-  handle(obj, initialPrefix, true);
-  return result;
+  } else if (isObjectCompare(val)) {
+    seen.add(val);
+    for (k in val) {
+      iter(
+        output,
+        seen,
+        isObjectCompare,
+        separator,
+        withArrays,
+        val[k],
+        pfx + k
+      );
+    }
+  } else {
+    output[key] = val;
+  }
 }
 
 function has(value, keys) {
@@ -1547,12 +1688,40 @@ const toMap = (obj) => {
   return map;
 };
 
-function unflatten(obj, separator = "_") {
-  const result = {};
-  Object.keys(obj).forEach((path) => {
-    set(result, path.split(separator), obj[path]);
-  });
-  return result;
+const badKeys = Object.freeze(
+  /* @__PURE__ */ new Set(["constructor", "__proto__", "prototype"])
+);
+function unflatten(input, separator = "_") {
+  if (!isObject(input)) {
+    return {};
+  }
+  let arr, tmp, output;
+  let i = 0, k, key;
+  for (k in input) {
+    tmp = output;
+    arr = k.split(separator);
+    for (i = 0; i < arr.length; ) {
+      key = arr[i++];
+      if (tmp == null) {
+        tmp = empty(+key);
+        output = output || tmp;
+      }
+      if (badKeys.has(key)) break;
+      if (i < arr.length) {
+        if (key in tmp) {
+          tmp = tmp[key];
+        } else {
+          tmp = tmp[key] = empty(+arr[i]);
+        }
+      } else {
+        tmp[key] = input[k];
+      }
+    }
+  }
+  return output;
+}
+function empty(key) {
+  return key === key ? [] : {};
 }
 
 const unset = _unset;
@@ -3177,7 +3346,7 @@ function getFileExtension(name, withDot = true) {
     return null;
   }
   const ext = name.split(".").at(-1)?.split("?")?.at(0);
-  return ext ? withDot ? ext : `.${ext}` : null;
+  return ext ? withDot ? `.${ext}` : ext : null;
 }
 
 const DEF_PROTOCOLS = ["http://", "https://"];
@@ -3195,7 +3364,21 @@ function getFileName(value) {
   if (!ext) {
     return value;
   }
-  return value.slice(0, -ext.length - 1);
+  return value.slice(0, -ext.length);
+}
+
+function getMostSpecificPaths(keys) {
+  keys = [...keys].sort();
+  const result = [];
+  for (let i = 0; i < keys.length; i++) {
+    const currentPath = keys[i];
+    const nextPath = keys[i + 1];
+    if (currentPath === nextPath) continue;
+    if (!nextPath || !nextPath.startsWith(currentPath + ".")) {
+      result.push(currentPath);
+    }
+  }
+  return result;
 }
 
 function humanFileSize(bytes, digits = 1, withSpace = true) {
@@ -4220,5 +4403,5 @@ function wrapText(value, maxLength = 30) {
   return value;
 }
 
-export { AppError, AsyncIterableQueue, BrowserAssertionError, CancellablePromise, ColorParser, instance as EJSON, EJSONStream, FindMean, FixedMap, FixedWeakMap, LruCache, Queue, SimpleEventEmitter, TWEMOJI_REGEX, TimeBucket, TimeSpan, alpha, arrayable, assert, asyncFilter, asyncFind, asyncForEach, asyncMap, avg, base64ToBytes, bigIntBytes, bigIntFromBytes, blendColors, buildCssColor, bytesToBase64, cache, cacheBucket, cacheFixed, cacheLRU, camelCase, capitalize, captureStackTrace, catchError, channelsToHSL, channelsToHex, channelsToRGB, checkBitmask, chunk, chunkSeries, clamp, cleanEmpty, cleanObject, colorToChannels, compareBytes, concatenateBytes, contrastRatio, convertToUnit, crc32, createCustomizer, createCustomizerFactory, createDateObject, createDeepCloneWith, createEJSON, createEJSONStream, createEnvParser, createRandomizer, createSecureCustomizer, createTimeObject, createTimeSpan, createWithCache, cssVariable, dateInDays, dateInSeconds, deepAssign, deepClone, deepCloneWith, deepDefaults, deepFreeze, def, defer, delay, difference, dropCache, env, escapeHtml, escapeNumeric, escapeRegExp, fastIdle, fastIdlePromise, fastRaf, findMean, flagsToMap, flatten, formatMoney, formatNumber, get, getFileExtension, getFileName, getInitials, getRandomInt, getRandomTime, getWords, has, hasOwn, hasProtocol, hex, hexToChannels, hmToSeconds, hslToChannels, humanFileSize, humanize, interpolateColor, intersection, isBigInt, isBoolean, isCached, isClient, isColorChannels, isCustomizerFactory, isDate, isDateObject, isDef, isEmpty, isEqual, isError, isFunction, isInfinity, isMap, isNullOrUndefined, isNumber, isObject, isOneEmoji, isPlainObject, isPrimitive, isPromise, isSet, isSkip, isString, isSuccess, isSymbol, isTimeObject, isTimeString, isTimeValue, isValidWeekDay, isWeakMap, isWeakSet, isWithCache, isoToFlagEmoji, kebabCase, keyBy, logger, lowerCase, luminance, maskingEmail, maskingPhone, maskingWords, nextTickIteration, noop, objectId, omit, omitPrefixed, orderBy, parseAllNumbers, parseAlpha, parsePercentage, percentOf, pick, pickPrefixed, qs, rafPromise, randomString, removeVS16s, retryOnError, rgbToChannels, round2digits, secondsToHm, set, shuffle, snakeCase, sprintf, startCase, strAssign, sum, timeFromMinutes, timeStringify, timeToMinutes, timeout, timestamp, timestampMs, timestampToDate, tintedTextColor, toError, toMap, truncate, typeOf, uint16ToUint8, uint32ToUint8, uint8ToUint16, uint8ToUint32, unflatten, union, uniq, uniqBy, unset, weeksInYear, withCache, withCacheBucket, withCacheBucketBatch, withCacheFixed, withCacheLRU, withDeepClone, withPointerCache, wrapText };
+export { AppError, AsyncIterableQueue, BrowserAssertionError, CancellablePromise, ColorParser, instance as EJSON, EJSONStream, FindMean, FixedMap, FixedWeakMap, LruCache, Queue, SimpleEventEmitter, TWEMOJI_REGEX, TimeBucket, TimeSpan, alpha, arrayable, assert, asyncFilter, asyncFind, asyncForEach, asyncMap, avg, base64ToBytes, bigIntBytes, bigIntFromBytes, blendColors, buildCssColor, bytesToBase64, cache, cacheBucket, cacheFixed, cacheLRU, camelCase, capitalize, captureStackTrace, catchError, channelsToHSL, channelsToHex, channelsToRGB, checkBitmask, chunk, chunkSeries, clamp, cleanEmpty, cleanObject, colorToChannels, compareBytes, concatenateBytes, contrastRatio, convertToUnit, crc32, createCustomizer, createCustomizerFactory, createDateObject, createDeepCloneWith, createEJSON, createEJSONStream, createEnvParser, createRandomizer, createSecureCustomizer, createTimeObject, createTimeSpan, createWithCache, cssVariable, dateInDays, dateInSeconds, deepAssign, deepClone, deepCloneWith, deepDefaults, deepFreeze, def, defer, delay, difference, dropCache, env, escapeHtml, escapeNumeric, escapeRegExp, fastIdle, fastIdlePromise, fastRaf, findMean, flagsToMap, flatten, formatMoney, formatNumber, get, getFileExtension, getFileName, getInitials, getMostSpecificPaths, getRandomInt, getRandomTime, getWords, groupBy, has, hasOwn, hasProtocol, hex, hexToChannels, hmToSeconds, hslToChannels, humanFileSize, humanize, interpolateColor, intersection, isBigInt, isBoolean, isCached, isClient, isColorChannels, isCustomizerFactory, isDate, isDateObject, isDef, isEmpty, isEqual, isError, isFunction, isInfinity, isMap, isNullOrUndefined, isNumber, isObject, isOneEmoji, isPlainObject, isPrimitive, isPromise, isSet, isSkip, isString, isSuccess, isSymbol, isTimeObject, isTimeString, isTimeValue, isValidWeekDay, isWeakMap, isWeakSet, isWithCache, isoToFlagEmoji, kebabCase, keyBy, logger, lowerCase, luminance, maskingEmail, maskingPhone, maskingWords, nextTickIteration, noop, objectId, omit, omitPrefixed, orderBy, parseAllNumbers, parseAlpha, parsePercentage, percentOf, pick, pickPrefixed, qs, rafPromise, randomString, removeVS16s, retryOnError, rgbToChannels, round2digits, secondsToHm, set, shuffle, snakeCase, sprintf, startCase, strAssign, sum, timeFromMinutes, timeStringify, timeToMinutes, timeout, timestamp, timestampMs, timestampToDate, tintedTextColor, toError, toMap, truncate, typeOf, uint16ToUint8, uint32ToUint8, uint8ToUint16, uint8ToUint32, unflatten, union, uniq, uniqBy, unset, weeksInYear, weightedRoundRobin, withCache, withCacheBucket, withCacheBucketBatch, withCacheFixed, withCacheLRU, withDeepClone, withPointerCache, wrapText };
 //# sourceMappingURL=index.mjs.map