@naturalcycles/js-lib 14.162.0 → 14.163.0

package/dist/array/array.util.d.ts

@@ -16,6 +16,25 @@ export declare function _chunk<T>(array: readonly T[], size?: number): T[][];
  * Removes duplicates from given array.
  */
 export declare function _uniq<T>(a: readonly T[]): T[];
+/**
+ * Pushes an item to an array if it's not already there.
+ * Mutates the array (same as normal `push`) and also returns it for chaining convenience.
+ *
+ * _pushUniq([1, 2, 3], 2) // => [1, 2, 3]
+ *
+ * Shortcut for:
+ * if (!a.includes(item)) a.push(item)
+ * // or
+ * a = [...new Set(a).add(item)]
+ * // or
+ * a = _uniq([...a, item])
+ */
+export declare function _pushUniq<T>(a: T[], ...items: T[]): T[];
+/**
+ * Like _pushUniq but uses a mapper to determine uniqueness (like _uniqBy).
+ * Mutates the array (same as normal `push`).
+ */
+export declare function _pushUniqBy<T>(a: T[], mapper: Mapper<T, any>, ...items: T[]): T[];
 /**
  * This method is like `_.uniq` except that it accepts `iteratee` which is
  * invoked for each element in `array` to generate the criterion by which

package/dist/array/array.util.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._minByOrUndefined = exports._maxByOrUndefined = exports._minBy = exports._maxBy = exports._max = exports._maxOrUndefined = exports._min = exports._minOrUndefined = exports._lastOrUndefined = exports._last = exports._shuffle = exports._mapToObject = exports._sumBy = exports._sum = exports._difference = exports._intersection = exports._countBy = exports._dropRightWhile = exports._dropWhile = exports._takeRightWhile = exports._takeWhile = exports._findLast = exports._sortBy = exports._groupBy = exports._by = exports._uniqBy = exports._uniq = exports._chunk = void 0;
+exports._minByOrUndefined = exports._maxByOrUndefined = exports._minBy = exports._maxBy = exports._max = exports._maxOrUndefined = exports._min = exports._minOrUndefined = exports._lastOrUndefined = exports._last = exports._shuffle = exports._mapToObject = exports._sumBy = exports._sum = exports._difference = exports._intersection = exports._countBy = exports._dropRightWhile = exports._dropWhile = exports._takeRightWhile = exports._takeWhile = exports._findLast = exports._sortBy = exports._groupBy = exports._by = exports._uniqBy = exports._pushUniqBy = exports._pushUniq = exports._uniq = exports._chunk = void 0;
 const is_util_1 = require("../is.util");
 /**
  * Creates an array of elements split into groups the length of size. If collection can’t be split evenly, the
@@ -27,6 +27,43 @@ function _uniq(a) {
     return [...new Set(a)];
 }
 exports._uniq = _uniq;
+/**
+ * Pushes an item to an array if it's not already there.
+ * Mutates the array (same as normal `push`) and also returns it for chaining convenience.
+ *
+ * _pushUniq([1, 2, 3], 2) // => [1, 2, 3]
+ *
+ * Shortcut for:
+ * if (!a.includes(item)) a.push(item)
+ * // or
+ * a = [...new Set(a).add(item)]
+ * // or
+ * a = _uniq([...a, item])
+ */
+function _pushUniq(a, ...items) {
+    items.forEach(item => {
+        if (!a.includes(item))
+            a.push(item);
+    });
+    return a;
+}
+exports._pushUniq = _pushUniq;
+/**
+ * Like _pushUniq but uses a mapper to determine uniqueness (like _uniqBy).
+ * Mutates the array (same as normal `push`).
+ */
+function _pushUniqBy(a, mapper, ...items) {
+    const mappedSet = new Set(a.map((item, i) => mapper(item, i)));
+    items.forEach((item, i) => {
+        const mapped = mapper(item, i);
+        if (!mappedSet.has(mapped)) {
+            a.push(item);
+            mappedSet.add(mapped);
+        }
+    });
+    return a;
+}
+exports._pushUniqBy = _pushUniqBy;
 /**
  * This method is like `_.uniq` except that it accepts `iteratee` which is
  * invoked for each element in `array` to generate the criterion by which

package/dist/error/error.model.d.ts

@@ -44,12 +44,16 @@ export interface ErrorData {
      * Can be used by error-reporting tools (e.g Sentry).
      * If fingerprint is defined - it'll be used INSTEAD of default fingerprint of a tool.
      * Can be used to force-group errors that are NOT needed to be split by endpoint or calling function.
+     *
+     * Sentry takes string[], but for convenience we allow to pass a singe string.
      */
-    fingerprint?: string[];
+    fingerprint?: string | string[];
     /**
      * If set to true - it'll use error.message as fingerprint,
      * so, all errors with the same message will be grouped together, even if they occurred in different places.
      * Defaults to false.
+     *
+     * @experimental
      */
     fingerprintByMessage?: boolean;
     /**

package/dist-esm/array/array.util.js

@@ -22,6 +22,41 @@ export function _chunk(array, size = 1) {
 export function _uniq(a) {
     return [...new Set(a)];
 }
+/**
+ * Pushes an item to an array if it's not already there.
+ * Mutates the array (same as normal `push`) and also returns it for chaining convenience.
+ *
+ * _pushUniq([1, 2, 3], 2) // => [1, 2, 3]
+ *
+ * Shortcut for:
+ * if (!a.includes(item)) a.push(item)
+ * // or
+ * a = [...new Set(a).add(item)]
+ * // or
+ * a = _uniq([...a, item])
+ */
+export function _pushUniq(a, ...items) {
+    items.forEach(item => {
+        if (!a.includes(item))
+            a.push(item);
+    });
+    return a;
+}
+/**
+ * Like _pushUniq but uses a mapper to determine uniqueness (like _uniqBy).
+ * Mutates the array (same as normal `push`).
+ */
+export function _pushUniqBy(a, mapper, ...items) {
+    const mappedSet = new Set(a.map((item, i) => mapper(item, i)));
+    items.forEach((item, i) => {
+        const mapped = mapper(item, i);
+        if (!mappedSet.has(mapped)) {
+            a.push(item);
+            mappedSet.add(mapped);
+        }
+    });
+    return a;
+}
 /**
  * This method is like `_.uniq` except that it accepts `iteratee` which is
  * invoked for each element in `array` to generate the criterion by which

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.162.0",
+  "version": "14.163.0",
   "scripts": {
     "prepare": "husky install",
     "build-prod": "build-prod-esm-cjs",

package/src/array/array.util.ts

@@ -26,6 +26,42 @@ export function _uniq<T>(a: readonly T[]): T[] {
   return [...new Set(a)]
 }
 
+/**
+ * Pushes an item to an array if it's not already there.
+ * Mutates the array (same as normal `push`) and also returns it for chaining convenience.
+ *
+ * _pushUniq([1, 2, 3], 2) // => [1, 2, 3]
+ *
+ * Shortcut for:
+ * if (!a.includes(item)) a.push(item)
+ * // or
+ * a = [...new Set(a).add(item)]
+ * // or
+ * a = _uniq([...a, item])
+ */
+export function _pushUniq<T>(a: T[], ...items: T[]): T[] {
+  items.forEach(item => {
+    if (!a.includes(item)) a.push(item)
+  })
+  return a
+}
+
+/**
+ * Like _pushUniq but uses a mapper to determine uniqueness (like _uniqBy).
+ * Mutates the array (same as normal `push`).
+ */
+export function _pushUniqBy<T>(a: T[], mapper: Mapper<T, any>, ...items: T[]): T[] {
+  const mappedSet = new Set(a.map((item, i) => mapper(item, i)))
+  items.forEach((item, i) => {
+    const mapped = mapper(item, i)
+    if (!mappedSet.has(mapped)) {
+      a.push(item)
+      mappedSet.add(mapped)
+    }
+  })
+  return a
+}
+
 /**
  * This method is like `_.uniq` except that it accepts `iteratee` which is
  * invoked for each element in `array` to generate the criterion by which

package/src/error/error.model.ts

@@ -54,13 +54,17 @@ export interface ErrorData {
    * Can be used by error-reporting tools (e.g Sentry).
    * If fingerprint is defined - it'll be used INSTEAD of default fingerprint of a tool.
    * Can be used to force-group errors that are NOT needed to be split by endpoint or calling function.
+   *
+   * Sentry takes string[], but for convenience we allow to pass a singe string.
    */
-  fingerprint?: string[]
+  fingerprint?: string | string[]
 
   /**
    * If set to true - it'll use error.message as fingerprint,
    * so, all errors with the same message will be grouped together, even if they occurred in different places.
    * Defaults to false.
+   *
+   * @experimental
    */
   fingerprintByMessage?: boolean