@libp2p/utils 6.3.1-fe8af37a1 → 6.4.0-26313e695

package/dist/src/is-async-generator.d.ts

@@ -0,0 +1,2 @@
+export declare function isAsyncGenerator(obj: unknown): obj is AsyncGenerator;
+//# sourceMappingURL=is-async-generator.d.ts.map

package/dist/src/is-async-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-async-generator.d.ts","sourceRoot":"","sources":["../../src/is-async-generator.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAAE,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,cAAc,CAerE"}

package/dist/src/is-async-generator.js

@@ -0,0 +1,12 @@
+export function isAsyncGenerator(obj) {
+    if (obj == null) {
+        return false;
+    }
+    const asyncIterator = obj?.[Symbol.asyncIterator];
+    if (typeof asyncIterator !== 'function') {
+        return false;
+    }
+    const instance = obj;
+    return typeof instance.next === 'function';
+}
+//# sourceMappingURL=is-async-generator.js.map

package/dist/src/is-async-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-async-generator.js","sourceRoot":"","sources":["../../src/is-async-generator.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,gBAAgB,CAAE,GAAY;IAC5C,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAChB,OAAO,KAAK,CAAA;IACd,CAAC;IAED,MAAM,aAAa,GAAI,GAA4C,EAAE,CACnE,MAAM,CAAC,aAAa,CACrB,CAAA;IAED,IAAI,OAAO,aAAa,KAAK,UAAU,EAAE,CAAC;QACxC,OAAO,KAAK,CAAA;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,GAAyB,CAAA;IAC1C,OAAO,OAAO,QAAQ,CAAC,IAAI,KAAK,UAAU,CAAA;AAC5C,CAAC"}

package/dist/src/is-generator.d.ts

@@ -0,0 +1,2 @@
+export declare function isGenerator(obj: unknown): obj is Generator;
+//# sourceMappingURL=is-generator.d.ts.map

package/dist/src/is-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-generator.d.ts","sourceRoot":"","sources":["../../src/is-generator.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAE,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,SAAS,CAc3D"}

package/dist/src/is-generator.js

@@ -0,0 +1,12 @@
+export function isGenerator(obj) {
+    if (obj == null) {
+        return false;
+    }
+    const iterator = obj?.[Symbol.iterator];
+    if (typeof iterator !== 'function') {
+        return false;
+    }
+    const instance = obj;
+    return typeof instance.next === 'function';
+}
+//# sourceMappingURL=is-generator.js.map

package/dist/src/is-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-generator.js","sourceRoot":"","sources":["../../src/is-generator.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAE,GAAY;IACvC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAChB,OAAO,KAAK,CAAA;IACd,CAAC;IAED,MAAM,QAAQ,GAAI,GAAuC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAE5E,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnC,OAAO,KAAK,CAAA;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,GAAyB,CAAA;IAE1C,OAAO,OAAO,QAAQ,CAAC,IAAI,KAAK,UAAU,CAAA;AAC5C,CAAC"}

package/dist/src/repeating-task.d.ts

@@ -1,6 +1,30 @@
 import type { AbortOptions } from '@libp2p/interface';
 export interface RepeatingTask {
+    /**
+     * Update the interval after which the next iteration of the task will run.
+     *
+     * This is useful if, for example, you want to retry a task with a short rest
+     * duration until it succeeds, then periodically after that.
+     *
+     * This only affects the next iteration of the task, if it is currently
+     * running, that run will not be interrupted.
+     */
+    setInterval(ms: number): void;
+    /**
+     * Update the amount of time a task will run before the passed abort signal
+     * will fire.
+     *
+     * * This only affects the next iteration of the task, if it is currently
+     * running, that run will not be interrupted.
+     */
+    setTimeout(ms: number): void;
+    /**
+     * Start the task running
+     */
     start(): void;
+    /**
+     * Stop the task running
+     */
     stop(): void;
 }
 export interface RepeatingTaskOptions {
@@ -11,6 +35,8 @@ export interface RepeatingTaskOptions {
     timeout?: number;
     /**
      * Whether to schedule the task to run immediately
+     *
+     * @default false
      */
     runImmediately?: boolean;
 }

package/dist/src/repeating-task.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repeating-task.d.ts","sourceRoot":"","sources":["../../src/repeating-task.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,MAAM,WAAW,aAAa;IAC5B,KAAK,IAAI,IAAI,CAAA;IACb,IAAI,IAAI,IAAI,CAAA;CACb;AAED,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,wBAAgB,aAAa,CAAE,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,aAAa,CA2DpJ"}
+{"version":3,"file":"repeating-task.d.ts","sourceRoot":"","sources":["../../src/repeating-task.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,MAAM,WAAW,aAAa;IAC5B;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IAE7B;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IAE5B;;OAEG;IACH,KAAK,IAAI,IAAI,CAAA;IAEb;;OAEG;IACH,IAAI,IAAI,IAAI,CAAA;CACb;AAED,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,wBAAgB,aAAa,CAAE,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,aAAa,CA2EpJ"}

package/dist/src/repeating-task.js

@@ -27,6 +27,20 @@ export function repeatingTask(fn, interval, options) {
     }
     let started = false;
     return {
+        setInterval: (ms) => {
+            interval = ms;
+            // maybe reschedule
+            if (timeout != null) {
+                clearTimeout(timeout);
+                timeout = setTimeout(runTask, interval);
+            }
+        },
+        setTimeout: (ms) => {
+            if (options == null) {
+                options = {};
+            }
+            options.timeout = ms;
+        },
         start: () => {
             if (started) {
                 return;

package/dist/src/repeating-task.js.map

@@ -1 +1 @@
-{"version":3,"file":"repeating-task.js","sourceRoot":"","sources":["../../src/repeating-task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAqBtC,MAAM,UAAU,aAAa,CAAE,EAAoD,EAAE,QAAgB,EAAE,OAA8B;IACnI,IAAI,OAAsC,CAAA;IAC1C,IAAI,kBAAmC,CAAA;IAEvC,SAAS,OAAO;QACd,MAAM,IAAI,GAAiB;YACzB,MAAM,EAAE,kBAAkB,CAAC,MAAM;SAClC,CAAA;QAED,IAAI,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;YAC3F,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;YAEjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACtB,CAAC;QAED,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YAChC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAA;QAChB,CAAC,CAAC;aACC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;aACf,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,kBAAkB,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACtC,gCAAgC;gBAChC,OAAM;YACR,CAAC;YAED,aAAa;YACb,OAAO,GAAG,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;QACzC,CAAC,CAAC,CAAA;IACN,CAAC;IAED,IAAI,OAAO,GAAG,KAAK,CAAA;IAEnB,OAAO;QACL,KAAK,EAAE,GAAG,EAAE;YACV,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAM;YACR,CAAC;YAED,OAAO,GAAG,IAAI,CAAA;YACd,kBAAkB,GAAG,IAAI,eAAe,EAAE,CAAA;YAC1C,eAAe,CAAC,QAAQ,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAA;YAEpD,UAAU;YACV,IAAI,OAAO,EAAE,cAAc,KAAK,IAAI,EAAE,CAAC;gBACrC,cAAc,CAAC,GAAG,EAAE;oBAClB,OAAO,EAAE,CAAA;gBACX,CAAC,CAAC,CAAA;YACJ,CAAC;iBAAM,CAAC;gBACN,YAAY;gBACZ,OAAO,GAAG,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;YACzC,CAAC;QACH,CAAC;QACD,IAAI,EAAE,GAAG,EAAE;YACT,YAAY,CAAC,OAAO,CAAC,CAAA;YACrB,kBAAkB,EAAE,KAAK,EAAE,CAAA;YAC3B,OAAO,GAAG,KAAK,CAAA;QACjB,CAAC;KACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"repeating-task.js","sourceRoot":"","sources":["../../src/repeating-task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAkDtC,MAAM,UAAU,aAAa,CAAE,EAAoD,EAAE,QAAgB,EAAE,OAA8B;IACnI,IAAI,OAAsC,CAAA;IAC1C,IAAI,kBAAmC,CAAA;IAEvC,SAAS,OAAO;QACd,MAAM,IAAI,GAAiB;YACzB,MAAM,EAAE,kBAAkB,CAAC,MAAM;SAClC,CAAA;QAED,IAAI,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;YAC3F,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;YAEjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACtB,CAAC;QAED,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YAChC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAA;QAChB,CAAC,CAAC;aACC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;aACf,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,kBAAkB,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACtC,gCAAgC;gBAChC,OAAM;YACR,CAAC;YAED,aAAa;YACb,OAAO,GAAG,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;QACzC,CAAC,CAAC,CAAA;IACN,CAAC;IAED,IAAI,OAAO,GAAG,KAAK,CAAA;IAEnB,OAAO;QACL,WAAW,EAAE,CAAC,EAAE,EAAE,EAAE;YAClB,QAAQ,GAAG,EAAE,CAAA;YAEb,mBAAmB;YACnB,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;gBACpB,YAAY,CAAC,OAAO,CAAC,CAAA;gBACrB,OAAO,GAAG,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;YACzC,CAAC;QACH,CAAC;QACD,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE;YACjB,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;gBACpB,OAAO,GAAG,EAAE,CAAA;YACd,CAAC;YAED,OAAO,CAAC,OAAO,GAAG,EAAE,CAAA;QACtB,CAAC;QACD,KAAK,EAAE,GAAG,EAAE;YACV,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAM;YACR,CAAC;YAED,OAAO,GAAG,IAAI,CAAA;YACd,kBAAkB,GAAG,IAAI,eAAe,EAAE,CAAA;YAC1C,eAAe,CAAC,QAAQ,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAA;YAEpD,UAAU;YACV,IAAI,OAAO,EAAE,cAAc,KAAK,IAAI,EAAE,CAAC;gBACrC,cAAc,CAAC,GAAG,EAAE;oBAClB,OAAO,EAAE,CAAA;gBACX,CAAC,CAAC,CAAA;YACJ,CAAC;iBAAM,CAAC;gBACN,YAAY;gBACZ,OAAO,GAAG,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;YACzC,CAAC;QACH,CAAC;QACD,IAAI,EAAE,GAAG,EAAE;YACT,YAAY,CAAC,OAAO,CAAC,CAAA;YACrB,kBAAkB,EAAE,KAAK,EAAE,CAAA;YAC3B,OAAO,GAAG,KAAK,CAAA;QACjB,CAAC;KACF,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@libp2p/utils",
-  "version": "6.3.1-fe8af37a1",
+  "version": "6.4.0-26313e695",
   "description": "Package to aggregate shared logic and dependencies for the libp2p ecosystem",
   "license": "Apache-2.0 OR MIT",
   "homepage": "https://github.com/libp2p/js-libp2p/tree/main/packages/utils#readme",
@@ -84,6 +84,14 @@
       "types": "./dist/src/ip-port-to-multiaddr.d.ts",
       "import": "./dist/src/ip-port-to-multiaddr.js"
     },
+    "./is-async-generator": {
+      "types": "./dist/src/is-async-generator.d.ts",
+      "import": "./dist/src/is-async-generator.js"
+    },
+    "./is-generator": {
+      "types": "./dist/src/is-generator.d.ts",
+      "import": "./dist/src/is-generator.js"
+    },
     "./is-promise": {
       "types": "./dist/src/is-promise.d.ts",
       "import": "./dist/src/is-promise.js"
@@ -173,9 +181,9 @@
   "dependencies": {
     "@chainsafe/is-ip": "^2.0.2",
     "@chainsafe/netmask": "^2.0.0",
-    "@libp2p/crypto": "5.0.9-fe8af37a1",
-    "@libp2p/interface": "2.4.0-fe8af37a1",
-    "@libp2p/logger": "5.1.6-fe8af37a1",
+    "@libp2p/crypto": "5.0.10-26313e695",
+    "@libp2p/interface": "2.4.1-26313e695",
+    "@libp2p/logger": "5.1.7-26313e695",
     "@multiformats/multiaddr": "^12.3.3",
     "@sindresorhus/fnv1a": "^3.1.0",
     "@types/murmurhash3js-revisited": "^3.0.3",
@@ -196,7 +204,7 @@
     "uint8arrays": "^5.1.0"
   },
   "devDependencies": {
-    "@libp2p/peer-id": "5.0.10-fe8af37a1",
+    "@libp2p/peer-id": "5.0.11-26313e695",
     "@types/netmask": "^2.0.5",
     "aegir": "^45.0.5",
     "benchmark": "^2.1.4",

package/src/is-async-generator.ts

@@ -0,0 +1,16 @@
+export function isAsyncGenerator (obj: unknown): obj is AsyncGenerator {
+  if (obj == null) {
+    return false
+  }
+
+  const asyncIterator = (obj as { [Symbol.asyncIterator]?: unknown })?.[
+    Symbol.asyncIterator
+  ]
+
+  if (typeof asyncIterator !== 'function') {
+    return false
+  }
+
+  const instance = obj as { next?: unknown }
+  return typeof instance.next === 'function'
+}

package/src/is-generator.ts

@@ -0,0 +1,15 @@
+export function isGenerator (obj: unknown): obj is Generator {
+  if (obj == null) {
+    return false
+  }
+
+  const iterator = (obj as { [Symbol.iterator]?: unknown })?.[Symbol.iterator]
+
+  if (typeof iterator !== 'function') {
+    return false
+  }
+
+  const instance = obj as { next?: unknown }
+
+  return typeof instance.next === 'function'
+}

package/src/repeating-task.ts

@@ -3,7 +3,34 @@ import { anySignal } from 'any-signal'
 import type { AbortOptions } from '@libp2p/interface'
 
 export interface RepeatingTask {
+  /**
+   * Update the interval after which the next iteration of the task will run.
+   *
+   * This is useful if, for example, you want to retry a task with a short rest
+   * duration until it succeeds, then periodically after that.
+   *
+   * This only affects the next iteration of the task, if it is currently
+   * running, that run will not be interrupted.
+   */
+  setInterval(ms: number): void
+
+  /**
+   * Update the amount of time a task will run before the passed abort signal
+   * will fire.
+   *
+   * * This only affects the next iteration of the task, if it is currently
+   * running, that run will not be interrupted.
+   */
+  setTimeout(ms: number): void
+
+  /**
+   * Start the task running
+   */
   start(): void
+
+  /**
+   * Stop the task running
+   */
   stop(): void
 }
 
@@ -16,6 +43,8 @@ export interface RepeatingTaskOptions {
 
   /**
    * Whether to schedule the task to run immediately
+   *
+   * @default false
    */
   runImmediately?: boolean
 }
@@ -54,6 +83,22 @@ export function repeatingTask (fn: (options?: AbortOptions) => void | Promise<vo
   let started = false
 
   return {
+    setInterval: (ms) => {
+      interval = ms
+
+      // maybe reschedule
+      if (timeout != null) {
+        clearTimeout(timeout)
+        timeout = setTimeout(runTask, interval)
+      }
+    },
+    setTimeout: (ms) => {
+      if (options == null) {
+        options = {}
+      }
+
+      options.timeout = ms
+    },
     start: () => {
       if (started) {
         return