@johnhenry/iteration 0.0.0

package/MIT-LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2018-2022 John Henry
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/dist/abort.d.ts

@@ -0,0 +1,26 @@
+/**
+ * AbortSignal plumbing shared by the async consumers (consumers.ts),
+ * transduceAsync (transduce.ts), and the concurrency helpers
+ * (concurrency.ts).
+ */
+/** Options bag accepted by cancellable async operations. */
+export interface SignalOptions {
+    signal?: AbortSignal;
+}
+/** Throw the signal's abort reason if it has already aborted. */
+export declare const throwIfAborted: (signal?: AbortSignal) => void;
+/**
+ * Wrap an (a)sync iterable so that iteration rejects promptly with an
+ * AbortError when `signal` aborts -- even while awaiting a slow source --
+ * and `iterator.return()` is propagated to the source on abort, error, or
+ * early consumer exit. With no signal, delegates straight through.
+ *
+ * Note: on abort the source's `return()` is invoked but deliberately not
+ * awaited -- an async generator queues `return()` behind its in-flight
+ * `next()`, so awaiting it could postpone the rejection indefinitely on a
+ * hung source (the very case aborting is for).
+ * @kind function
+ * @name abortable
+ */
+export declare const abortable: <T>(iterable: AsyncIterable<T> | Iterable<T>, signal?: AbortSignal) => AsyncGenerator<T>;
+//# sourceMappingURL=abort.d.ts.map

package/dist/abort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.d.ts","sourceRoot":"","sources":["../src/abort.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAWD,iEAAiE;AACjE,eAAO,MAAM,cAAc,GAAI,SAAS,WAAW,KAAG,IAIrD,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,SAAS,GAAoB,CAAC,EACzC,UAAU,aAAa,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,EACxC,SAAS,WAAW,KACnB,cAAc,CAAC,CAAC,CAoClB,CAAC"}

package/dist/abort.js

@@ -0,0 +1,69 @@
+/**
+ * AbortSignal plumbing shared by the async consumers (consumers.ts),
+ * transduceAsync (transduce.ts), and the concurrency helpers
+ * (concurrency.ts).
+ */
+/**
+ * The error an aborted operation rejects with: the signal's own `reason`
+ * when set (AbortController.abort() defaults it to an "AbortError"
+ * DOMException), otherwise a fresh "AbortError" DOMException.
+ * @ignore
+ */
+const abortError = (signal) => signal.reason ?? new DOMException("This operation was aborted", "AbortError");
+/** Throw the signal's abort reason if it has already aborted. */
+export const throwIfAborted = (signal) => {
+    if (signal?.aborted) {
+        throw abortError(signal);
+    }
+};
+/**
+ * Wrap an (a)sync iterable so that iteration rejects promptly with an
+ * AbortError when `signal` aborts -- even while awaiting a slow source --
+ * and `iterator.return()` is propagated to the source on abort, error, or
+ * early consumer exit. With no signal, delegates straight through.
+ *
+ * Note: on abort the source's `return()` is invoked but deliberately not
+ * awaited -- an async generator queues `return()` behind its in-flight
+ * `next()`, so awaiting it could postpone the rejection indefinitely on a
+ * hung source (the very case aborting is for).
+ * @kind function
+ * @name abortable
+ */
+export const abortable = async function* (iterable, signal) {
+    if (!signal) {
+        yield* iterable;
+        return;
+    }
+    throwIfAborted(signal);
+    const it = Symbol.asyncIterator in Object(iterable)
+        ? iterable[Symbol.asyncIterator]()
+        : iterable[Symbol.iterator]();
+    let onAbort = () => { };
+    const aborted = new Promise((_, reject) => {
+        onAbort = () => reject(abortError(signal));
+        signal.addEventListener("abort", onAbort, { once: true });
+    });
+    // Pre-handle so an abort that never races (e.g. after completion, before
+    // listener removal) can't surface as an unhandled rejection.
+    aborted.catch(() => { });
+    let done = false;
+    try {
+        while (true) {
+            const result = await Promise.race([Promise.resolve(it.next()), aborted]);
+            if (result.done) {
+                done = true;
+                return;
+            }
+            yield result.value;
+        }
+    }
+    finally {
+        signal.removeEventListener("abort", onAbort);
+        if (!done && it.return) {
+            // Close the source on abort, error, or early consumer exit --
+            // fire-and-forget; see note above.
+            Promise.resolve(it.return()).catch(() => { });
+        }
+    }
+};
+//# sourceMappingURL=abort.js.map

package/dist/abort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.js","sourceRoot":"","sources":["../src/abort.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH;;;;;GAKG;AACH,MAAM,UAAU,GAAG,CAAC,MAAmB,EAAW,EAAE,CAClD,MAAM,CAAC,MAAM,IAAI,IAAI,YAAY,CAAC,4BAA4B,EAAE,YAAY,CAAC,CAAC;AAEhF,iEAAiE;AACjE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAoB,EAAQ,EAAE;IAC3D,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;QACpB,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,SAAS,CAAC,EACtC,QAAwC,EACxC,MAAoB;IAEpB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,KAAK,CAAC,CAAC,QAAQ,CAAC;QAChB,OAAO;IACT,CAAC;IACD,cAAc,CAAC,MAAM,CAAC,CAAC;IACvB,MAAM,EAAE,GACN,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,QAAQ,CAAC;QACtC,CAAC,CAAE,QAA6B,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE;QACxD,CAAC,CAAE,QAAwB,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;IACnD,IAAI,OAAO,GAAe,GAAG,EAAE,GAAE,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAC/C,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IACH,yEAAyE;IACzE,6DAA6D;IAC7D,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACxB,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;YACzE,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBAChB,IAAI,GAAG,IAAI,CAAC;gBACZ,OAAO;YACT,CAAC;YACD,MAAM,MAAM,CAAC,KAAK,CAAC;QACrB,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC;YACvB,8DAA8D;YAC9D,mCAAmC;YACnC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;AACH,CAAC,CAAC"}

package/dist/assertions/eventualequal.d.ts

@@ -0,0 +1,9 @@
+export declare class TestError extends Error {
+    val: Record<string, unknown>;
+    constructor(message: string, val?: Record<string, unknown>);
+    [Symbol.iterator](): IterableIterator<[string, unknown]>;
+}
+export declare const DefaultMessage = "should eventually be deep equal";
+declare const _default: (actual: unknown, expected: unknown, message?: string, operator?: string) => Promise<string | TestError>;
+export default _default;
+//# sourceMappingURL=eventualequal.d.ts.map

package/dist/assertions/eventualequal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventualequal.d.ts","sourceRoot":"","sources":["../../src/assertions/eventualequal.ts"],"names":[],"mappings":"AASA,qBAAa,SAAU,SAAQ,KAAK;IAClC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBACjB,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAI9D,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAGzD;AAED,eAAO,MAAM,cAAc,oCAAoC,CAAC;yBAE9D,QAAQ,OAAO,EACf,UAAU,OAAO,EACjB,UAAS,MAAuB,EAChC,iBAA0B,KACzB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;AAL9B,wBAcE"}

package/dist/assertions/eventualequal.js

@@ -0,0 +1,30 @@
+// Historically this module was a pop-quiz assertion and imported
+// pop-quiz/testerror. pop-quiz is no longer a dependency (the test suite
+// moved to node:test), so a structurally-compatible TestError is inlined
+// here to keep the "@johnhenry/iteration/pop-quiz/asserteventualequal" subpath
+// export working for existing consumers: it extends Error, exposes the
+// details on `.val`, and is iterable over the [key, value] entries --
+// exactly the shape pop-quiz@1's TestError had.
+import { eventualequal } from "../eventualequal.js";
+export class TestError extends Error {
+    val;
+    constructor(message, val = {}) {
+        super(message);
+        this.val = val;
+    }
+    [Symbol.iterator]() {
+        return Object.entries(this.val).values();
+    }
+}
+export const DefaultMessage = "should eventually be deep equal";
+export default async (actual, expected, message = DefaultMessage, operator = "eventualequal") => {
+    if (await eventualequal(actual, expected)) {
+        return message;
+    }
+    return new TestError(message, {
+        actual: actual,
+        expected: expected,
+        operator,
+    });
+};
+//# sourceMappingURL=eventualequal.js.map

package/dist/assertions/eventualequal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventualequal.js","sourceRoot":"","sources":["../../src/assertions/eventualequal.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,yEAAyE;AACzE,yEAAyE;AACzE,+EAA+E;AAC/E,uEAAuE;AACvE,sEAAsE;AACtE,gDAAgD;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC,GAAG,CAA0B;IAC7B,YAAY,OAAe,EAAE,MAA+B,EAAE;QAC5D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IACD,CAAC,MAAM,CAAC,QAAQ,CAAC;QACf,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,iCAAiC,CAAC;AAChE,eAAe,KAAK,EAClB,MAAe,EACf,QAAiB,EACjB,UAAkB,cAAc,EAChC,QAAQ,GAAG,eAAe,EACG,EAAE;IAC/B,IAAI,MAAM,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;QAC1C,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,IAAI,SAAS,CAAC,OAAO,EAAE;QAC5B,MAAM,EAAE,MAAM;QACd,QAAQ,EAAE,QAAQ;QAClB,QAAQ;KACT,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/async-channel.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Asynchronous Channel
+ * @kind namespace
+ * @name AsyncChannel
+ */
+/**
+ * Constant signaling channel's end
+ * @kind constant
+ * @name CHANNEL_END
+ */
+export declare const CHANNEL_END: unique symbol;
+export interface AsyncChannelOptions<T> {
+    cache?: Array<T | typeof CHANNEL_END | Error>;
+    limit?: number;
+    transform?: (item: T) => T | Promise<T>;
+    debug?: (...args: unknown[]) => unknown;
+}
+/**
+ * Asynchronous Channel class
+ * @kind class
+ * @name AsyncChannel
+ */
+export declare class AsyncChannel<T = unknown> {
+    limit: number;
+    cache: Array<T | typeof CHANNEL_END | Error>;
+    transform: (item: T) => T | Promise<T>;
+    debug?: (...args: unknown[]) => unknown;
+    private promise?;
+    private resolve?;
+    private reject?;
+    /** Producers awaiting capacity, FIFO (backpressure -- see put()). */
+    private putters;
+    /**
+     * Serializes delivery of concurrent put() calls into call order. Each
+     * put() grabs the current tail synchronously (before any `await`, so
+     * position is fixed by call order rather than by how long e.g.
+     * `transform()` happens to take) and only commits its value once its
+     * predecessor has committed.
+     */
+    private putOrder;
+    /**
+     * Asynchronous Channel constructor
+     * @kind function
+     * @name constructor
+     */
+    constructor({ cache, limit, transform, debug }?: AsyncChannelOptions<T>);
+    /**
+     * Move waiting producers' items into the cache while there is capacity,
+     * releasing their pending put() promises (FIFO).
+     * @ignore
+     */
+    private drainPutters;
+    /**
+     * Put item onto Asynchronous Channel. Returns a Promise<void> that
+     * resolves once the channel has accepted the item: immediately when a
+     * taker is waiting or the cache has capacity, otherwise when a later
+     * take() frees a slot (backpressure -- bounded by `limit`). Replaces the
+     * pre-2.1 behavior of throwing "cache full" at capacity.
+     * @kind function
+     * @name put
+     */
+    put(item: T, ...debug: unknown[]): Promise<void>;
+    /**
+     * Take item off of Asynchronous Channel
+     * @kind function
+     * @name take
+     */
+    take(...debug: unknown[]): Promise<T | typeof CHANNEL_END>;
+    /**
+     * Pause Asynchronous Channel
+     * @kind function
+     * @name break
+     */
+    break(...debug: unknown[]): Promise<void>;
+    /**
+     * Stop Asynchronous Channel
+     * @kind function
+     * @name throw
+     */
+    throw(message?: string, ...debug: unknown[]): Promise<void>;
+    /**
+     * Return pending status of Asynchronous Channel
+     * @kind function
+     * @name pending
+     * Note: should this be a getter?
+     */
+    pending(): boolean;
+    /**
+     * Return string representation of Asynchronous Channel
+     * @kind function
+     * @name toString
+     */
+    toString(): string;
+    /**
+     * Return Asynchronous Channel's iterator
+     * @kind function
+     * @name [Symbol.asyncIterator]
+     */
+    [Symbol.asyncIterator](...debug: unknown[]): AsyncGenerator<T>;
+}
+//# sourceMappingURL=async-channel.d.ts.map

package/dist/async-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-channel.d.ts","sourceRoot":"","sources":["../src/async-channel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,OAAO,MAA8B,CAAC;AAuBhE,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,OAAO,WAAW,GAAG,KAAK,CAAC,CAAC;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACxC,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;CACzC;AAED;;;;GAIG;AACH,qBAAa,YAAY,CAAC,CAAC,GAAG,OAAO;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,CAAC,CAAC,GAAG,OAAO,WAAW,GAAG,KAAK,CAAC,CAAC;IAC7C,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;IACxC,OAAO,CAAC,OAAO,CAAC,CAAkC;IAClD,OAAO,CAAC,OAAO,CAAC,CAA0C;IAC1D,OAAO,CAAC,MAAM,CAAC,CAA6B;IAC5C,qEAAqE;IACrE,OAAO,CAAC,OAAO,CAGP;IACR;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAoC;IAEpD;;;;OAIG;gBACS,EAAE,KAAU,EAAE,KAAgB,EAAE,SAAuB,EAAE,KAAK,EAAE,GAAE,mBAAmB,CAAC,CAAC,CAAM;IAMzG;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAUpB;;;;;;;;OAQG;IACG,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BtD;;;;OAIG;IACG,IAAI,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,OAAO,WAAW,CAAC;IA2BhE;;;;OAIG;IACG,KAAK,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/C;;;;OAIG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjE;;;;;OAKG;IACH,OAAO,IAAI,OAAO;IAGlB;;;;OAIG;IACH,QAAQ,IAAI,MAAM;IAGlB;;;;OAIG;IACI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC;CAStE"}

package/dist/async-channel.js

@@ -0,0 +1,208 @@
+/**
+ * Asynchronous Channel
+ * @kind namespace
+ * @name AsyncChannel
+ */
+/**
+ * Constant signaling channel's end
+ * @kind constant
+ * @name CHANNEL_END
+ */
+export const CHANNEL_END = Symbol("CHANNEL_END");
+/**
+ * Creates a promise that can be resolved/rejected outside of initial closure
+ * @kind function
+ * @name InvertedPromise
+ * @ignore
+ */
+const InvertedPromise = () => {
+    const out = {};
+    out.promise = new Promise((resolve, reject) => {
+        out.resolve = resolve;
+        out.reject = reject;
+    });
+    return out;
+};
+/**
+ * Asynchronous Channel class
+ * @kind class
+ * @name AsyncChannel
+ */
+export class AsyncChannel {
+    limit;
+    cache;
+    transform;
+    debug;
+    promise;
+    resolve;
+    reject;
+    /** Producers awaiting capacity, FIFO (backpressure -- see put()). */
+    putters = [];
+    /**
+     * Serializes delivery of concurrent put() calls into call order. Each
+     * put() grabs the current tail synchronously (before any `await`, so
+     * position is fixed by call order rather than by how long e.g.
+     * `transform()` happens to take) and only commits its value once its
+     * predecessor has committed.
+     */
+    putOrder = Promise.resolve();
+    /**
+     * Asynchronous Channel constructor
+     * @kind function
+     * @name constructor
+     */
+    constructor({ cache = [], limit = Infinity, transform = ($) => $, debug } = {}) {
+        this.limit = limit;
+        this.cache = cache.slice(0, limit);
+        this.transform = transform;
+        this.debug = debug;
+    }
+    /**
+     * Move waiting producers' items into the cache while there is capacity,
+     * releasing their pending put() promises (FIFO).
+     * @ignore
+     */
+    drainPutters() {
+        while (this.putters.length > 0 && this.cache.length < this.limit) {
+            const { value, release } = this.putters.shift();
+            this.cache.push(value);
+            release();
+        }
+    }
+    /**
+     * Put item onto Asynchronous Channel. Returns a Promise<void> that
+     * resolves once the channel has accepted the item: immediately when a
+     * taker is waiting or the cache has capacity, otherwise when a later
+     * take() frees a slot (backpressure -- bounded by `limit`). Replaces the
+     * pre-2.1 behavior of throwing "cache full" at capacity.
+     * @kind function
+     * @name put
+     */
+    async put(item, ...debug) {
+        this.debug?.("put", item, ...debug);
+        // Reserve this call's delivery slot synchronously, in call order,
+        // before doing any async work (transform() may resolve at a different
+        // speed for different items -- see class doc on putOrder).
+        const myTurn = this.putOrder;
+        let advance;
+        this.putOrder = new Promise((resolve) => {
+            advance = resolve;
+        });
+        try {
+            const value = await this.transform(item);
+            await myTurn;
+            if (this.promise) {
+                this.resolve?.(value);
+                return;
+            }
+            if (this.cache.length < this.limit) {
+                this.cache.push(value);
+                return;
+            }
+            await new Promise((release) => {
+                this.putters.push({ value, release });
+            });
+        }
+        finally {
+            advance();
+        }
+    }
+    /**
+     * Take item off of Asynchronous Channel
+     * @kind function
+     * @name take
+     */
+    async take(...debug) {
+        this.debug?.("take", ...debug);
+        if (this.cache.length) {
+            const value = this.cache.shift();
+            this.drainPutters();
+            return value;
+        }
+        if (this.putters.length) {
+            // limit of 0 (rendezvous) or drained cache with waiting producers:
+            // hand off directly.
+            const { value, release } = this.putters.shift();
+            release();
+            return value;
+        }
+        const { promise, resolve, reject } = InvertedPromise();
+        this.promise = promise;
+        this.resolve = resolve;
+        this.reject = reject;
+        const value = await this.promise;
+        delete this.promise;
+        delete this.resolve;
+        delete this.reject;
+        return value;
+    }
+    /**
+     * Pause Asynchronous Channel
+     * @kind function
+     * @name break
+     */
+    async break(...debug) {
+        this.debug?.("break", ...debug);
+        if (this.promise) {
+            await this.resolve?.(CHANNEL_END);
+        }
+        else if (this.putters.length > 0) {
+            // Keep FIFO order: the end marker must not overtake producers
+            // already waiting for capacity.
+            this.putters.push({ value: CHANNEL_END, release: () => { } });
+        }
+        else {
+            this.cache.push(CHANNEL_END);
+        }
+    }
+    /**
+     * Stop Asynchronous Channel
+     * @kind function
+     * @name throw
+     */
+    async throw(message, ...debug) {
+        this.debug?.("throw", ...debug);
+        if (this.promise) {
+            await this.reject?.(new Error(message));
+        }
+        else if (this.putters.length > 0) {
+            // Keep FIFO order behind producers already waiting for capacity.
+            this.putters.push({ value: new Error(message), release: () => { } });
+        }
+        else {
+            this.cache.push(new Error(message));
+        }
+    }
+    /**
+     * Return pending status of Asynchronous Channel
+     * @kind function
+     * @name pending
+     * Note: should this be a getter?
+     */
+    pending() {
+        return !!this.promise;
+    }
+    /**
+     * Return string representation of Asynchronous Channel
+     * @kind function
+     * @name toString
+     */
+    toString() {
+        return `AsyncChannel {${this.pending() ? "pending" : ""}} [${this.cache.length}/${this.limit}]`;
+    }
+    /**
+     * Return Asynchronous Channel's iterator
+     * @kind function
+     * @name [Symbol.asyncIterator]
+     */
+    async *[Symbol.asyncIterator](...debug) {
+        while (true) {
+            const answer = await this.take(...debug);
+            if (answer === CHANNEL_END) {
+                return;
+            }
+            yield answer;
+        }
+    }
+}
+//# sourceMappingURL=async-channel.js.map

package/dist/async-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-channel.js","sourceRoot":"","sources":["../src/async-channel.ts"],"names":[],"mappings":"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"}

package/dist/channel-decorators.d.ts

@@ -0,0 +1,23 @@
+import type { AsyncChannel } from "./async-channel.ts";
+interface EmitterLike {
+    addListener(event: string, listener: (...args: never[]) => unknown): unknown;
+}
+interface WebSocketLike {
+    onmessage: ((event: unknown) => unknown) | null;
+    onclose: ((event?: unknown) => unknown) | null;
+    onerror: ((event?: unknown) => unknown) | null;
+}
+/**
+ * Decorate Asynchronous Channel with generic emitter
+ * @kind function
+ * @name withEmitter
+ */
+export declare const withEmitter: <T, C extends AsyncChannel<T>>(channel: C, emitter: EmitterLike, data?: string, end?: string, error?: string) => C;
+/**
+ * Decorate Asynchronous Channel with websocket
+ * @kind function
+ * @name withWebSocket
+ */
+export declare const withWebSocket: <T, C extends AsyncChannel<T>>(channel: C, websocket: WebSocketLike) => C;
+export {};
+//# sourceMappingURL=channel-decorators.d.ts.map

package/dist/channel-decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-decorators.d.ts","sourceRoot":"","sources":["../src/channel-decorators.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,UAAU,WAAW;IACnB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,GAAG,OAAO,CAAC;CAC9E;AAED,UAAU,aAAa;IACrB,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG,IAAI,CAAC;IAChD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG,IAAI,CAAC;CAChD;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,EACtD,SAAS,CAAC,EACV,SAAS,WAAW,EACpB,aAAa,EACb,YAAW,EACX,cAAe,KACd,CASF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,WAAW,aAAa,KAAG,CASlG,CAAC"}

package/dist/channel-decorators.js

@@ -0,0 +1,31 @@
+/**
+ * Decorate Asynchronous Channel with generic emitter
+ * @kind function
+ * @name withEmitter
+ */
+export const withEmitter = (channel, emitter, data = "data", end = "end", error = "error") => {
+    emitter.addListener(data, (...args) => {
+        void channel.put(...args).catch((reason) => {
+            void channel.throw(reason instanceof Error ? reason.message : String(reason));
+        });
+    });
+    emitter.addListener(end, channel.break.bind(channel));
+    emitter.addListener(error, channel.throw.bind(channel));
+    return channel;
+};
+/**
+ * Decorate Asynchronous Channel with websocket
+ * @kind function
+ * @name withWebSocket
+ */
+export const withWebSocket = (channel, websocket) => {
+    websocket.onmessage = (event) => {
+        void channel.put(event).catch((reason) => {
+            void channel.throw(reason instanceof Error ? reason.message : String(reason));
+        });
+    };
+    websocket.onclose = channel.break.bind(channel);
+    websocket.onerror = channel.throw.bind(channel);
+    return channel;
+};
+//# sourceMappingURL=channel-decorators.js.map

package/dist/channel-decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-decorators.js","sourceRoot":"","sources":["../src/channel-decorators.ts"],"names":[],"mappings":"AAYA;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,OAAU,EACV,OAAoB,EACpB,IAAI,GAAG,MAAM,EACb,GAAG,GAAG,KAAK,EACX,KAAK,GAAG,OAAO,EACZ,EAAE;IACL,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,GAAG,IAAa,EAAE,EAAE;QAC7C,KAAK,OAAO,CAAC,GAAG,CAAC,GAAI,IAAkD,CAAC,CAAC,KAAK,CAAC,CAAC,MAAe,EAAE,EAAE;YACjG,KAAK,OAAO,CAAC,KAAK,CAAC,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAChF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD,OAAO,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACxD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAA+B,OAAU,EAAE,SAAwB,EAAK,EAAE;IACrG,SAAS,CAAC,SAAS,GAAG,CAAC,KAAc,EAAE,EAAE;QACvC,KAAK,OAAO,CAAC,GAAG,CAAC,KAAU,CAAC,CAAC,KAAK,CAAC,CAAC,MAAe,EAAE,EAAE;YACrD,KAAK,OAAO,CAAC,KAAK,CAAC,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAChF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IACF,SAAS,CAAC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAChD,SAAS,CAAC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAiC,CAAC;IAChF,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}

package/dist/concurrency.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Bounded-concurrency helpers: mapConcurrentAsync (parallel map over an
+ * (a)sync iterable with a concurrency limit) and prefetchAsync (eager
+ * read-ahead into a bounded buffer). Both propagate cancellation/early
+ * consumer exit upstream via iterator.return().
+ */
+import { type SignalOptions } from "./abort.ts";
+export interface MapConcurrentOptions extends SignalOptions {
+    /** Maximum number of `fn` invocations in flight at once (required, >= 1). */
+    concurrency: number;
+    /**
+     * true (default): yield results in input order.
+     * false: yield results in completion order.
+     */
+    ordered?: boolean;
+}
+/**
+ * Map `fn` over `iterable` with up to `concurrency` invocations in flight
+ * at once. With `ordered: true` (the default) results are yielded in input
+ * order; with `ordered: false` they are yielded in completion order.
+ *
+ * - Backpressure: at most `concurrency` results are held; the source is
+ *   only pulled while there is spare in-flight capacity.
+ * - Cancellation: an optional `signal` aborts promptly (rejecting with the
+ *   signal's reason, an "AbortError" DOMException by default) even while
+ *   awaiting a slow `fn` or source; the source iterator is closed via
+ *   `return()`.
+ * - Early exit / error: breaking out of the loop, or an `fn` rejection,
+ *   also closes the source via `return()`.
+ * @kind function
+ * @name mapConcurrentAsync
+ */
+export declare const mapConcurrentAsync: <In, Out>(fn: (item: In) => Out | Promise<Out>, iterable: AsyncIterable<In> | Iterable<In>, { concurrency, ordered, signal }: MapConcurrentOptions) => AsyncGenerator<Out>;
+/**
+ * Eagerly pull up to `n` items ahead of the consumer into a bounded
+ * buffer, so a slow consumer overlaps with a slow producer. `n <= 0`
+ * degenerates to plain iteration. Early consumer exit (or an error)
+ * closes the source via `return()`.
+ * @kind function
+ * @name prefetchAsync
+ */
+export declare const prefetchAsync: <T>(n: number, iterable: AsyncIterable<T> | Iterable<T>) => AsyncGenerator<T>;
+//# sourceMappingURL=concurrency.d.ts.map

package/dist/concurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../src/concurrency.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,aAAa,EAAkB,MAAM,YAAY,CAAC;AAEhE,MAAM,WAAW,oBAAqB,SAAQ,aAAa;IACzD,6EAA6E;IAC7E,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAUD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,kBAAkB,GAAoB,EAAE,EAAE,GAAG,EACxD,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,EACpC,UAAU,aAAa,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,EAC1C,kCAAyC,oBAAoB,KAC5D,cAAc,CAAC,GAAG,CA4EpB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GAAoB,CAAC,EAC7C,GAAG,MAAM,EACT,UAAU,aAAa,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,KACvC,cAAc,CAAC,CAAC,CA+BlB,CAAC"}