@naturalcycles/js-lib 14.254.0 → 14.255.0

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

@@ -161,11 +161,15 @@ export declare function _intersection<T>(a1: T[], a2: T[] | Set<T>): T[];
  */
 export declare function _intersectsWith<T>(a1: T[], a2: T[] | Set<T>): boolean;
 /**
+ * Returns array1 minus array2.
+ *
  * @example
  * _difference([2, 1], [2, 3])
  * // [1]
+ *
+ * Passing second array as Set is more performant (it'll skip turning the array into Set in-place).
  */
-export declare function _difference<T>(source: T[], ...diffs: T[][]): T[];
+export declare function _difference<T>(a1: T[], a2: T[] | Set<T>): T[];
 /**
  * Returns the sum of items, or 0 for empty array.
  */

package/dist/array/array.util.js

@@ -318,16 +318,17 @@ function _intersectsWith(a1, a2) {
     return a1.some(v => a2set.has(v));
 }
 /**
+ * Returns array1 minus array2.
+ *
  * @example
  * _difference([2, 1], [2, 3])
  * // [1]
+ *
+ * Passing second array as Set is more performant (it'll skip turning the array into Set in-place).
  */
-function _difference(source, ...diffs) {
-    let a = source;
-    for (const b of diffs) {
-        a = a.filter(c => !b.includes(c));
-    }
-    return a;
+function _difference(a1, a2) {
+    const a2set = a2 instanceof Set ? a2 : new Set(a2);
+    return a1.filter(v => !a2set.has(v));
 }
 /**
  * Returns the sum of items, or 0 for empty array.

package/dist/error/tryCatch.js

@@ -29,7 +29,7 @@ function _tryCatch(fn, opt = {}) {
             }
             if (onError) {
                 try {
-                    return await onError((0, index_1._anyToError)(err)); // eslint-disable-line @typescript-eslint/return-await
+                    return await onError((0, index_1._anyToError)(err));
                 }
                 catch { }
             }

package/dist/types.d.ts

@@ -1,4 +1,18 @@
 import type { Promisable } from './typeFest';
+declare const __brand: unique symbol;
+interface Brand<B> {
+    [__brand]: B;
+}
+/**
+ * Helper to create "Branded" types.
+ *
+ * Example:
+ * export type MyId = Branded<string, 'MyId'>
+ *
+ * MyId can be assigned to a string,
+ * but string cannot be assigned to MyId without casting it (`as MyId`).
+ */
+export type Branded<T, B> = T & Brand<B>;
 /**
  * Map from String to String (or <T>).
  *
@@ -292,3 +306,4 @@ export interface CommonClient extends AsyncDisposable {
     disconnect: () => Promise<void>;
     ping: () => Promise<void>;
 }
+export {};

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

@@ -277,16 +277,17 @@ export function _intersectsWith(a1, a2) {
     return a1.some(v => a2set.has(v));
 }
 /**
+ * Returns array1 minus array2.
+ *
  * @example
  * _difference([2, 1], [2, 3])
  * // [1]
+ *
+ * Passing second array as Set is more performant (it'll skip turning the array into Set in-place).
  */
-export function _difference(source, ...diffs) {
-    let a = source;
-    for (const b of diffs) {
-        a = a.filter(c => !b.includes(c));
-    }
-    return a;
+export function _difference(a1, a2) {
+    const a2set = a2 instanceof Set ? a2 : new Set(a2);
+    return a1.filter(v => !a2set.has(v));
 }
 /**
  * Returns the sum of items, or 0 for empty array.

package/dist-esm/error/tryCatch.js

@@ -25,7 +25,7 @@ export function _tryCatch(fn, opt = {}) {
             }
             if (onError) {
                 try {
-                    return await onError(_anyToError(err)); // eslint-disable-line @typescript-eslint/return-await
+                    return await onError(_anyToError(err));
                 }
                 catch { }
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.254.0",
+  "version": "14.255.0",
   "scripts": {
     "prepare": "husky",
     "build": "dev-lib build-esm-cjs",

package/src/array/array.util.ts

@@ -331,16 +331,17 @@ export function _intersectsWith<T>(a1: T[], a2: T[] | Set<T>): boolean {
 }
 
 /**
+ * Returns array1 minus array2.
+ *
  * @example
  * _difference([2, 1], [2, 3])
  * // [1]
+ *
+ * Passing second array as Set is more performant (it'll skip turning the array into Set in-place).
  */
-export function _difference<T>(source: T[], ...diffs: T[][]): T[] {
-  let a = source
-  for (const b of diffs) {
-    a = a.filter(c => !b.includes(c))
-  }
-  return a
+export function _difference<T>(a1: T[], a2: T[] | Set<T>): T[] {
+  const a2set = a2 instanceof Set ? a2 : new Set(a2)
+  return a1.filter(v => !a2set.has(v))
 }
 
 /**

package/src/error/tryCatch.ts

@@ -56,7 +56,7 @@ export function _tryCatch<T extends AnyFunction>(fn: T, opt: TryCatchOptions = {
 
       if (onError) {
         try {
-          return await onError(_anyToError(err)) // eslint-disable-line @typescript-eslint/return-await
+          return await onError(_anyToError(err))
         } catch {}
       }
       // returns undefined, but doesn't rethrow

package/src/types.ts

@@ -1,5 +1,22 @@
 import type { Promisable } from './typeFest'
 
+declare const __brand: unique symbol
+
+interface Brand<B> {
+  [__brand]: B
+}
+
+/**
+ * Helper to create "Branded" types.
+ *
+ * Example:
+ * export type MyId = Branded<string, 'MyId'>
+ *
+ * MyId can be assigned to a string,
+ * but string cannot be assigned to MyId without casting it (`as MyId`).
+ */
+export type Branded<T, B> = T & Brand<B>
+
 /**
  * Map from String to String (or <T>).
  *