@mtkruto/node 0.63.2 → 0.63.4

package/esm/deps/jsr.io/@std/async/1.0.12/mux_async_iterator.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Multiplexes multiple async iterators into a single stream. It currently
+ * makes an assumption that the final result (the value returned and not
+ * yielded from the iterator) does not matter; if there is any result, it is
+ * discarded.
+ *
+ * @example Usage
+ * ```ts
+ * import { MuxAsyncIterator } from "@std/async/mux-async-iterator";
+ * import { assertEquals } from "@std/assert";
+ *
+ * async function* gen123(): AsyncIterableIterator<number> {
+ *   yield 1;
+ *   yield 2;
+ *   yield 3;
+ * }
+ *
+ * async function* gen456(): AsyncIterableIterator<number> {
+ *   yield 4;
+ *   yield 5;
+ *   yield 6;
+ * }
+ *
+ * const mux = new MuxAsyncIterator<number>();
+ * mux.add(gen123());
+ * mux.add(gen456());
+ *
+ * const result = await Array.fromAsync(mux);
+ *
+ * assertEquals(result, [1, 4, 2, 5, 3, 6]);
+ * ```
+ *
+ * @typeParam T The type of the provided async iterables and generated async iterable.
+ */
+export declare class MuxAsyncIterator<T> implements AsyncIterable<T> {
+    #private;
+    /**
+     * Add an async iterable to the stream.
+     *
+     * @param iterable The async iterable to add.
+     *
+     * @example Usage
+     * ```ts
+     * import { MuxAsyncIterator } from "@std/async/mux-async-iterator";
+     * import { assertEquals } from "@std/assert";
+     *
+     * async function* gen123(): AsyncIterableIterator<number> {
+     *   yield 1;
+     *   yield 2;
+     *   yield 3;
+     * }
+     *
+     * const mux = new MuxAsyncIterator<number>();
+     * mux.add(gen123());
+     *
+     * const result = await Array.fromAsync(mux.iterate());
+     *
+     * assertEquals(result, [1, 2, 3]);
+     * ```
+     */
+    add(iterable: AsyncIterable<T>): void;
+    /**
+     * Returns an async iterator of the stream.
+     * @returns the async iterator for all the added async iterables.
+     *
+     * @example Usage
+     * ```ts
+     * import { MuxAsyncIterator } from "@std/async/mux-async-iterator";
+     * import { assertEquals } from "@std/assert";
+     *
+     * async function* gen123(): AsyncIterableIterator<number> {
+     *   yield 1;
+     *   yield 2;
+     *   yield 3;
+     * }
+     *
+     * const mux = new MuxAsyncIterator<number>();
+     * mux.add(gen123());
+     *
+     * const result = await Array.fromAsync(mux.iterate());
+     *
+     * assertEquals(result, [1, 2, 3]);
+     * ```
+     */
+    iterate(): AsyncIterableIterator<T>;
+    /**
+     * Implements an async iterator for the stream.
+     * @returns the async iterator for all the added async iterables.
+     *
+     * @example Usage
+     * ```ts
+     * import { MuxAsyncIterator } from "@std/async/mux-async-iterator";
+     * import { assertEquals } from "@std/assert";
+     *
+     * async function* gen123(): AsyncIterableIterator<number> {
+     *   yield 1;
+     *   yield 2;
+     *   yield 3;
+     * }
+     *
+     * const mux = new MuxAsyncIterator<number>();
+     * mux.add(gen123());
+     *
+     * const result = await Array.fromAsync(mux);
+     *
+     * assertEquals(result, [1, 2, 3]);
+     * ```
+     */
+    [Symbol.asyncIterator](): AsyncIterator<T>;
+}
+//# sourceMappingURL=mux_async_iterator.d.ts.map

package/esm/deps/jsr.io/@std/async/1.0.12/mux_async_iterator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mux_async_iterator.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/async/1.0.12/mux_async_iterator.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,gBAAgB,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;;IAO1D;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,GAAG,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;IAqB9B;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACI,OAAO,IAAI,qBAAqB,CAAC,CAAC,CAAC;IAsB1C;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC;CAG3C"}

package/esm/deps/jsr.io/@std/async/1.0.12/mux_async_iterator.js

@@ -0,0 +1,170 @@
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var _MuxAsyncIterator_instances, _MuxAsyncIterator_iteratorCount, _MuxAsyncIterator_yields, _MuxAsyncIterator_throws, _MuxAsyncIterator_signal, _MuxAsyncIterator_callIteratorNext;
+/**
+ * Multiplexes multiple async iterators into a single stream. It currently
+ * makes an assumption that the final result (the value returned and not
+ * yielded from the iterator) does not matter; if there is any result, it is
+ * discarded.
+ *
+ * @example Usage
+ * ```ts
+ * import { MuxAsyncIterator } from "@std/async/mux-async-iterator";
+ * import { assertEquals } from "@std/assert";
+ *
+ * async function* gen123(): AsyncIterableIterator<number> {
+ *   yield 1;
+ *   yield 2;
+ *   yield 3;
+ * }
+ *
+ * async function* gen456(): AsyncIterableIterator<number> {
+ *   yield 4;
+ *   yield 5;
+ *   yield 6;
+ * }
+ *
+ * const mux = new MuxAsyncIterator<number>();
+ * mux.add(gen123());
+ * mux.add(gen456());
+ *
+ * const result = await Array.fromAsync(mux);
+ *
+ * assertEquals(result, [1, 4, 2, 5, 3, 6]);
+ * ```
+ *
+ * @typeParam T The type of the provided async iterables and generated async iterable.
+ */
+export class MuxAsyncIterator {
+    constructor() {
+        _MuxAsyncIterator_instances.add(this);
+        _MuxAsyncIterator_iteratorCount.set(this, 0);
+        _MuxAsyncIterator_yields.set(this, []);
+        // deno-lint-ignore no-explicit-any
+        _MuxAsyncIterator_throws.set(this, []);
+        _MuxAsyncIterator_signal.set(this, Promise.withResolvers());
+    }
+    /**
+     * Add an async iterable to the stream.
+     *
+     * @param iterable The async iterable to add.
+     *
+     * @example Usage
+     * ```ts
+     * import { MuxAsyncIterator } from "@std/async/mux-async-iterator";
+     * import { assertEquals } from "@std/assert";
+     *
+     * async function* gen123(): AsyncIterableIterator<number> {
+     *   yield 1;
+     *   yield 2;
+     *   yield 3;
+     * }
+     *
+     * const mux = new MuxAsyncIterator<number>();
+     * mux.add(gen123());
+     *
+     * const result = await Array.fromAsync(mux.iterate());
+     *
+     * assertEquals(result, [1, 2, 3]);
+     * ```
+     */
+    add(iterable) {
+        var _a;
+        __classPrivateFieldSet(this, _MuxAsyncIterator_iteratorCount, (_a = __classPrivateFieldGet(this, _MuxAsyncIterator_iteratorCount, "f"), ++_a), "f");
+        __classPrivateFieldGet(this, _MuxAsyncIterator_instances, "m", _MuxAsyncIterator_callIteratorNext).call(this, iterable[Symbol.asyncIterator]());
+    }
+    /**
+     * Returns an async iterator of the stream.
+     * @returns the async iterator for all the added async iterables.
+     *
+     * @example Usage
+     * ```ts
+     * import { MuxAsyncIterator } from "@std/async/mux-async-iterator";
+     * import { assertEquals } from "@std/assert";
+     *
+     * async function* gen123(): AsyncIterableIterator<number> {
+     *   yield 1;
+     *   yield 2;
+     *   yield 3;
+     * }
+     *
+     * const mux = new MuxAsyncIterator<number>();
+     * mux.add(gen123());
+     *
+     * const result = await Array.fromAsync(mux.iterate());
+     *
+     * assertEquals(result, [1, 2, 3]);
+     * ```
+     */
+    async *iterate() {
+        while (__classPrivateFieldGet(this, _MuxAsyncIterator_iteratorCount, "f") > 0) {
+            // Sleep until any of the wrapped iterators yields.
+            await __classPrivateFieldGet(this, _MuxAsyncIterator_signal, "f").promise;
+            // Note that while we're looping over `yields`, new items may be added.
+            for (const { iterator, value } of __classPrivateFieldGet(this, _MuxAsyncIterator_yields, "f")) {
+                yield value;
+                __classPrivateFieldGet(this, _MuxAsyncIterator_instances, "m", _MuxAsyncIterator_callIteratorNext).call(this, iterator);
+            }
+            if (__classPrivateFieldGet(this, _MuxAsyncIterator_throws, "f").length) {
+                for (const e of __classPrivateFieldGet(this, _MuxAsyncIterator_throws, "f")) {
+                    throw e;
+                }
+            }
+            // Clear the `yields` list and reset the `signal` promise.
+            __classPrivateFieldGet(this, _MuxAsyncIterator_yields, "f").length = 0;
+            __classPrivateFieldSet(this, _MuxAsyncIterator_signal, Promise.withResolvers(), "f");
+        }
+    }
+    /**
+     * Implements an async iterator for the stream.
+     * @returns the async iterator for all the added async iterables.
+     *
+     * @example Usage
+     * ```ts
+     * import { MuxAsyncIterator } from "@std/async/mux-async-iterator";
+     * import { assertEquals } from "@std/assert";
+     *
+     * async function* gen123(): AsyncIterableIterator<number> {
+     *   yield 1;
+     *   yield 2;
+     *   yield 3;
+     * }
+     *
+     * const mux = new MuxAsyncIterator<number>();
+     * mux.add(gen123());
+     *
+     * const result = await Array.fromAsync(mux);
+     *
+     * assertEquals(result, [1, 2, 3]);
+     * ```
+     */
+    [(_MuxAsyncIterator_iteratorCount = new WeakMap(), _MuxAsyncIterator_yields = new WeakMap(), _MuxAsyncIterator_throws = new WeakMap(), _MuxAsyncIterator_signal = new WeakMap(), _MuxAsyncIterator_instances = new WeakSet(), _MuxAsyncIterator_callIteratorNext = async function _MuxAsyncIterator_callIteratorNext(iterator) {
+        var _a;
+        try {
+            const { value, done } = await iterator.next();
+            if (done) {
+                __classPrivateFieldSet(this, _MuxAsyncIterator_iteratorCount, (_a = __classPrivateFieldGet(this, _MuxAsyncIterator_iteratorCount, "f"), --_a), "f");
+            }
+            else {
+                __classPrivateFieldGet(this, _MuxAsyncIterator_yields, "f").push({ iterator, value });
+            }
+        }
+        catch (e) {
+            __classPrivateFieldGet(this, _MuxAsyncIterator_throws, "f").push(e);
+        }
+        __classPrivateFieldGet(this, _MuxAsyncIterator_signal, "f").resolve();
+    }, Symbol.asyncIterator)]() {
+        return this.iterate();
+    }
+}

package/esm/deps/jsr.io/@std/async/1.0.12/pool.d.ts

@@ -0,0 +1,33 @@
+/**
+ * pooledMap transforms values from an (async) iterable into another async
+ * iterable. The transforms are done concurrently, with a max concurrency
+ * defined by the poolLimit.
+ *
+ * If an error is thrown from `iterableFn`, no new transformations will begin.
+ * All currently executing transformations are allowed to finish and still
+ * yielded on success. After that, the rejections among them are gathered and
+ * thrown by the iterator in an `AggregateError`.
+ *
+ * @example Usage
+ * ```ts
+ * import { pooledMap } from "@std/async/pool";
+ * import { assertEquals } from "@std/assert";
+ *
+ * const results = pooledMap(
+ *   2,
+ *   [1, 2, 3],
+ *   (i) => new Promise((r) => setTimeout(() => r(i), 1000)),
+ * );
+ *
+ * assertEquals(await Array.fromAsync(results), [1, 2, 3]);
+ * ```
+ *
+ * @typeParam T the input type.
+ * @typeParam R the output type.
+ * @param poolLimit The maximum count of items being processed concurrently.
+ * @param array The input array for mapping.
+ * @param iteratorFn The function to call for every item of the array.
+ * @returns The async iterator with the transformed values.
+ */
+export declare function pooledMap<T, R>(poolLimit: number, array: Iterable<T> | AsyncIterable<T>, iteratorFn: (data: T) => Promise<R>): AsyncIterableIterator<R>;
+//# sourceMappingURL=pool.d.ts.map

package/esm/deps/jsr.io/@std/async/1.0.12/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/async/1.0.12/pool.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAC5B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,EACrC,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAClC,qBAAqB,CAAC,CAAC,CAAC,CAqE1B"}

package/esm/deps/jsr.io/@std/async/1.0.12/pool.js

@@ -0,0 +1,99 @@
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+/** Error message emitted from the thrown error while mapping. */
+const ERROR_WHILE_MAPPING_MESSAGE = "Cannot complete the mapping as an error was thrown from an item";
+/**
+ * pooledMap transforms values from an (async) iterable into another async
+ * iterable. The transforms are done concurrently, with a max concurrency
+ * defined by the poolLimit.
+ *
+ * If an error is thrown from `iterableFn`, no new transformations will begin.
+ * All currently executing transformations are allowed to finish and still
+ * yielded on success. After that, the rejections among them are gathered and
+ * thrown by the iterator in an `AggregateError`.
+ *
+ * @example Usage
+ * ```ts
+ * import { pooledMap } from "@std/async/pool";
+ * import { assertEquals } from "@std/assert";
+ *
+ * const results = pooledMap(
+ *   2,
+ *   [1, 2, 3],
+ *   (i) => new Promise((r) => setTimeout(() => r(i), 1000)),
+ * );
+ *
+ * assertEquals(await Array.fromAsync(results), [1, 2, 3]);
+ * ```
+ *
+ * @typeParam T the input type.
+ * @typeParam R the output type.
+ * @param poolLimit The maximum count of items being processed concurrently.
+ * @param array The input array for mapping.
+ * @param iteratorFn The function to call for every item of the array.
+ * @returns The async iterator with the transformed values.
+ */
+export function pooledMap(poolLimit, array, iteratorFn) {
+    // Create the async iterable that is returned from this function.
+    const res = new TransformStream({
+        async transform(p, controller) {
+            try {
+                const s = await p;
+                controller.enqueue(s);
+            }
+            catch (e) {
+                if (e instanceof AggregateError &&
+                    e.message === ERROR_WHILE_MAPPING_MESSAGE) {
+                    controller.error(e);
+                }
+            }
+        },
+    });
+    // Start processing items from the iterator
+    (async () => {
+        const writer = res.writable.getWriter();
+        const executing = [];
+        try {
+            for await (const item of array) {
+                const p = Promise.resolve().then(() => iteratorFn(item));
+                // Only write on success. If we `writer.write()` a rejected promise,
+                // that will end the iteration. We don't want that yet. Instead let it
+                // fail the race, taking us to the catch block where all currently
+                // executing jobs are allowed to finish and all rejections among them
+                // can be reported together.
+                writer.write(p);
+                const e = p.then(() => executing.splice(executing.indexOf(e), 1));
+                executing.push(e);
+                if (executing.length >= poolLimit) {
+                    await Promise.race(executing);
+                }
+            }
+            // Wait until all ongoing events have processed, then close the writer.
+            await Promise.all(executing);
+            writer.close();
+        }
+        catch {
+            const errors = [];
+            for (const result of await Promise.allSettled(executing)) {
+                if (result.status === "rejected") {
+                    errors.push(result.reason);
+                }
+            }
+            writer.write(Promise.reject(new AggregateError(errors, ERROR_WHILE_MAPPING_MESSAGE))).catch(() => { });
+        }
+    })();
+    // Feature test until browser coverage is adequate
+    return Symbol.asyncIterator in res.readable &&
+        typeof res.readable[Symbol.asyncIterator] === "function"
+        ? res.readable[Symbol.asyncIterator]()
+        : (async function* () {
+            const reader = res.readable.getReader();
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                yield value;
+            }
+            reader.releaseLock();
+        })();
+}

package/esm/deps/jsr.io/@std/async/1.0.12/retry.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Error thrown in {@linkcode retry} once the maximum number of failed attempts
+ * has been reached.
+ *
+ * @example Usage
+ * ```ts no-assert ignore
+ * import { RetryError } from "@std/async/retry";
+ *
+ * throw new RetryError({ foo: "bar" }, 3);
+ * ```
+ */
+export declare class RetryError extends Error {
+    /**
+     * Constructs a new {@linkcode RetryError} instance.
+     *
+     * @param cause the cause for this error.
+     * @param attempts the number of retry attempts made.
+     */
+    constructor(cause: unknown, attempts: number);
+}
+/** Options for {@linkcode retry}. */
+export interface RetryOptions {
+    /**
+     * How much to backoff after each retry.
+     *
+     * @default {2}
+     */
+    multiplier?: number;
+    /**
+     * The maximum milliseconds between attempts.
+     *
+     * @default {60000}
+     */
+    maxTimeout?: number;
+    /**
+     * The maximum amount of attempts until failure.
+     *
+     * @default {5}
+     */
+    maxAttempts?: number;
+    /**
+     * The initial and minimum amount of milliseconds between attempts.
+     *
+     * @default {1000}
+     */
+    minTimeout?: number;
+    /**
+     * Amount of jitter to introduce to the time between attempts. This is `1`
+     * for full jitter by default.
+     *
+     * @default {1}
+     */
+    jitter?: number;
+}
+/**
+ * Calls the given (possibly asynchronous) function up to `maxAttempts` times.
+ * Retries as long as the given function throws. If the attempts are exhausted,
+ * throws a {@linkcode RetryError} with `cause` set to the inner exception.
+ *
+ * The backoff is calculated by multiplying `minTimeout` with `multiplier` to the power of the current attempt counter (starting at 0 up to `maxAttempts - 1`). It is capped at `maxTimeout` however.
+ * How long the actual delay is, depends on `jitter`.
+ *
+ * When `jitter` is the default value of `1`, waits between two attempts for a
+ * randomized amount between 0 and the backoff time. With the default options
+ * the maximal delay will be `15s = 1s + 2s + 4s + 8s`. If all five attempts
+ * are exhausted the mean delay will be `9.5s = ½(4s + 15s)`.
+ *
+ * When `jitter` is `0`, waits the full backoff time.
+ *
+ * @example Example configuration 1
+ * ```ts no-assert
+ * import { retry } from "@std/async/retry";
+ * const req = async () => {
+ *  // some function that throws sometimes
+ * };
+ *
+ * // Below resolves to the first non-error result of `req`
+ * const retryPromise = await retry(req, {
+ *  multiplier: 2,
+ *  maxTimeout: 60000,
+ *  maxAttempts: 5,
+ *  minTimeout: 100,
+ *  jitter: 1,
+ * });
+ * ```
+ *
+ * @example Example configuration 2
+ * ```ts no-assert
+ * import { retry } from "@std/async/retry";
+ * const req = async () => {
+ *  // some function that throws sometimes
+ * };
+ *
+ * // Make sure we wait at least 1 minute, but at most 2 minutes
+ * const retryPromise = await retry(req, {
+ *  multiplier: 2.34,
+ *  maxTimeout: 80000,
+ *  maxAttempts: 7,
+ *  minTimeout: 1000,
+ *  jitter: 0.5,
+ * });
+ * ```
+ *
+ * @typeParam T The return type of the function to retry and returned promise.
+ * @param fn The function to retry.
+ * @param options Additional options.
+ * @returns The promise that resolves with the value returned by the function to retry.
+ */
+export declare function retry<T>(fn: (() => Promise<T>) | (() => T), options?: RetryOptions): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/esm/deps/jsr.io/@std/async/1.0.12/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/async/1.0.12/retry.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;GAUG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC;;;;;OAKG;gBACS,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM;CAK7C;AAED,qCAAqC;AACrC,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAClC,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,CAAC,CAAC,CA6CZ"}

package/esm/deps/jsr.io/@std/async/1.0.12/retry.js

@@ -0,0 +1,107 @@
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+import { exponentialBackoffWithJitter } from "./_util.js";
+/**
+ * Error thrown in {@linkcode retry} once the maximum number of failed attempts
+ * has been reached.
+ *
+ * @example Usage
+ * ```ts no-assert ignore
+ * import { RetryError } from "@std/async/retry";
+ *
+ * throw new RetryError({ foo: "bar" }, 3);
+ * ```
+ */
+export class RetryError extends Error {
+    /**
+     * Constructs a new {@linkcode RetryError} instance.
+     *
+     * @param cause the cause for this error.
+     * @param attempts the number of retry attempts made.
+     */
+    constructor(cause, attempts) {
+        super(`Retrying exceeded the maxAttempts (${attempts}).`);
+        this.name = "RetryError";
+        this.cause = cause;
+    }
+}
+/**
+ * Calls the given (possibly asynchronous) function up to `maxAttempts` times.
+ * Retries as long as the given function throws. If the attempts are exhausted,
+ * throws a {@linkcode RetryError} with `cause` set to the inner exception.
+ *
+ * The backoff is calculated by multiplying `minTimeout` with `multiplier` to the power of the current attempt counter (starting at 0 up to `maxAttempts - 1`). It is capped at `maxTimeout` however.
+ * How long the actual delay is, depends on `jitter`.
+ *
+ * When `jitter` is the default value of `1`, waits between two attempts for a
+ * randomized amount between 0 and the backoff time. With the default options
+ * the maximal delay will be `15s = 1s + 2s + 4s + 8s`. If all five attempts
+ * are exhausted the mean delay will be `9.5s = ½(4s + 15s)`.
+ *
+ * When `jitter` is `0`, waits the full backoff time.
+ *
+ * @example Example configuration 1
+ * ```ts no-assert
+ * import { retry } from "@std/async/retry";
+ * const req = async () => {
+ *  // some function that throws sometimes
+ * };
+ *
+ * // Below resolves to the first non-error result of `req`
+ * const retryPromise = await retry(req, {
+ *  multiplier: 2,
+ *  maxTimeout: 60000,
+ *  maxAttempts: 5,
+ *  minTimeout: 100,
+ *  jitter: 1,
+ * });
+ * ```
+ *
+ * @example Example configuration 2
+ * ```ts no-assert
+ * import { retry } from "@std/async/retry";
+ * const req = async () => {
+ *  // some function that throws sometimes
+ * };
+ *
+ * // Make sure we wait at least 1 minute, but at most 2 minutes
+ * const retryPromise = await retry(req, {
+ *  multiplier: 2.34,
+ *  maxTimeout: 80000,
+ *  maxAttempts: 7,
+ *  minTimeout: 1000,
+ *  jitter: 0.5,
+ * });
+ * ```
+ *
+ * @typeParam T The return type of the function to retry and returned promise.
+ * @param fn The function to retry.
+ * @param options Additional options.
+ * @returns The promise that resolves with the value returned by the function to retry.
+ */
+export async function retry(fn, options) {
+    const { multiplier = 2, maxTimeout = 60000, maxAttempts = 5, minTimeout = 1000, jitter = 1, } = options ?? {};
+    if (maxTimeout <= 0) {
+        throw new TypeError(`Cannot retry as 'maxTimeout' must be positive: current value is ${maxTimeout}`);
+    }
+    if (minTimeout > maxTimeout) {
+        throw new TypeError(`Cannot retry as 'minTimeout' must be <= 'maxTimeout': current values 'minTimeout=${minTimeout}', 'maxTimeout=${maxTimeout}'`);
+    }
+    if (jitter > 1) {
+        throw new TypeError(`Cannot retry as 'jitter' must be <= 1: current value is ${jitter}`);
+    }
+    let attempt = 0;
+    while (true) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            if (attempt + 1 >= maxAttempts) {
+                throw new RetryError(error, maxAttempts);
+            }
+            const timeout = exponentialBackoffWithJitter(maxTimeout, minTimeout, attempt, multiplier, jitter);
+            await new Promise((r) => setTimeout(r, timeout));
+        }
+        attempt++;
+    }
+}

package/esm/deps/jsr.io/@std/async/1.0.12/tee.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Utility for representing n-tuple. Used in {@linkcode tee}.
+ *
+ * @internal
+ */
+export type Tuple<T, N extends number> = N extends N ? number extends N ? T[] : TupleOf<T, N, []> : never;
+/**
+ * Utility for representing n-tuple of. Used in {@linkcode Tuple}.
+ *
+ * @internal
+ */
+export type TupleOf<T, N extends number, R extends unknown[]> = R["length"] extends N ? R : TupleOf<T, N, [T, ...R]>;
+/**
+ * Branches the given async iterable into the `n` branches.
+ *
+ * @example Usage
+ * ```ts
+ * import { tee } from "@std/async/tee";
+ * import { assertEquals } from "@std/assert";
+ *
+ * const gen = async function* gen() {
+ *   yield 1;
+ *   yield 2;
+ *   yield 3;
+ * };
+ *
+ * const [branch1, branch2] = tee(gen());
+ *
+ * const result1 = await Array.fromAsync(branch1);
+ * assertEquals(result1, [1, 2, 3]);
+ *
+ * const result2 = await Array.fromAsync(branch2);
+ * assertEquals(result2, [1, 2, 3]);
+ * ```
+ *
+ * @typeParam T The type of the provided async iterable and the returned async iterables.
+ * @typeParam N The amount of branches to tee into.
+ * @param iterable The iterable to tee.
+ * @param n The amount of branches to tee into.
+ * @returns The tuple where each element is an async iterable.
+ */
+export declare function tee<T, N extends number = 2>(iterable: AsyncIterable<T>, n?: N): Tuple<AsyncIterable<T>, N>;
+//# sourceMappingURL=tee.d.ts.map