iter-fest 0.1.1-main.7bda6b5 → 0.1.1-main.94e44fc

package/README.md

@@ -33,9 +33,22 @@ console.log(iterableSome(iterable, value => value % 2)); // Prints "true".
 
 List of ported functions: [`at`](https://tc39.es/ecma262/#sec-array.prototype.at), [`concat`](https://tc39.es/ecma262/#sec-array.prototype.concat), [`entries`](https://tc39.es/ecma262/#sec-array.prototype.entries), [`every`](https://tc39.es/ecma262/#sec-array.prototype.every), [`filter`](https://tc39.es/ecma262/#sec-array.prototype.filter), [`find`](https://tc39.es/ecma262/#sec-array.prototype.find), [`findIndex`](https://tc39.es/ecma262/#sec-array.prototype.findindex), [`findLast`](https://tc39.es/ecma262/#sec-array.prototype.findlast), [`findLastIndex`](https://tc39.es/ecma262/#sec-array.prototype.findlastindex), [`forEach`](https://tc39.es/ecma262/#sec-array.prototype.foreach), [`includes`](https://tc39.es/ecma262/#sec-array.prototype.includes), [`indexOf`](https://tc39.es/ecma262/#sec-array.prototype.indexof), [`join`](https://tc39.es/ecma262/#sec-array.prototype.join), [`keys`](https://tc39.es/ecma262/#sec-array.prototype.keys), [`map`](https://tc39.es/ecma262/#sec-array.prototype.map), [`reduce`](https://tc39.es/ecma262/#sec-array.prototype.reduce), [`slice`](https://tc39.es/ecma262/#sec-array.prototype.slice), [`some`](https://tc39.es/ecma262/#sec-array.prototype.some), [`toSpliced`](https://tc39.es/ecma262/#sec-array.prototype.tospliced), and [`toString`](https://tc39.es/ecma262/#sec-array.prototype.tostring).
 
+## Conversions
+
+| From                          | To                      | Function signature                                                                                                                               |
+| ----------------------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `Iterator`                    | `IterableIterator`      | [`iteratorToIterable<T>(iterator: Iterator<T>): IterableIterator<T>`](#converting-an-iterator-to-iterable)                                       |
+| `AsyncIterator`               | `AsyncIterableIterator` | [`asyncIteratorToAsyncIterable<T>(asyncIterator: AsyncIterator<T>): AsyncIterableIterator<T>`](#converting-an-iterator-to-iterable)              |
+| `Observable`                  | `ReadableStream`        | [`observableSubscribeAsReadable<T>(observable: Observable<T>): ReadableStream<T>`](#converting-an-observable-to-readablestream)                  |
+| `ReadableStreamDefaultReader` | `AsyncIterableIterator` | [`readerValues`<T>(reader: ReadableStreamDefaultReader<T>): AsyncIterableIterator<T>`](#iterating-readablestreamdefaultreader)                   |
+| `AsyncIterable`               | `Observable`            | [`observableFromAsync<T>(iterable: AsyncIterable<T>): Observable<T>`](#converting-an-asynciterable-to-observable)                                |
+| `AsyncIterable`/`Iterable`    | `ReadableStream`        | [`iterableGetReadable<T>(iterable: AsyncIterable<T> \| Iterable<T>): ReadableStream<T>`](#converting-an-asynciterableiterable-to-readablestream) |
+
+To convert `Observable` to `AsyncIterableIterator`, [use `ReadableStream` as intermediate format](#converting-an-observable-to-asynciterableiterator).
+
 ### Converting an iterator to iterable
 
-`iteratorToIterable` converts a pure iterator to `IterableIterator` and enable for-loop iteration.
+`iteratorToIterable` and `asyncIteratorToAsyncIterable` enable a [pure iterator](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Iterator) to be iterable using a for-loop statement.
 
 ```ts
 const iterate = (): Iterator<number> => {
@@ -44,7 +57,7 @@ const iterate = (): Iterator<number> => {
   return {
     next: () => {
       if (++value <= 3) {
-        return { done: false, value };
+        return { value };
       }
 
       return { done: true, value: undefined };
@@ -57,22 +70,157 @@ for (const value of iteratorToIterable(iterate())) {
 }
 ```
 
+Note: calling `[Symbol.iterator]` will not refresh the iteration.
+
+### Converting an `Observable` to `AsyncIterableIterator`
+
+`ReadableStream` can be used to when converting an `Observable` to `AsyncIterableIterator`.
+
+Note: `Observable` is push-based and it does not support flow control. When converting to `AsyncIterableIteratorrr`, the internal buffer of `ReadableStream` could build up quickly.
+
+```ts
+const observable = Observable.from([1, 2, 3]);
+const readable = observableSubscribeAsReadable(observable);
+
+for await (const value of readerValues(readable.getReader())) {
+  console.log(value); // Prints "1", "2", "3".
+}
+```
+
+### Converting an `AsyncIterable` to `Observable`
+
+`Observable.from` converts `Iterable` into `Observable`. However, it does not convert `AsyncIterable`.
+
+`observableFromAsync` will convert `AsyncIterable` into `Observable`.
+
+```ts
+async function* generate() {
+  yield 1;
+  yield 2;
+  yield 3;
+}
+
+const observable = observableFromAsync(generate());
+const next = value => console.log(value);
+
+observable.subscribe({ next }); // Prints "1", "2", "3".
+```
+
+## Converting an `Observable` to `ReadableStream`
+
+`ReadableStream` is powerful for transforming and piping stream of data. It can be formed using data from both push-based and pull-based source with backpressuree.
+
+Note: `Observable` is push-based and it does not support flow control. When converting to `ReadableStream`, the internal buffer could build up quickly.
+
+```ts
+const observable = Observable.from([1, 2, 3]);
+const readable = observableSubscribeAsReadable(observable);
+const reader = readable.getReader();
+
+readable.pipeTo(stream.writable); // Will write 1, 2, 3.
+```
+
+### Iterating `ReadableStreamDefaultReader`
+
+`readerValues` will convert default reader of `ReadableStream` into an `AsyncIterableIterator` to use in for-loop.
+
+```ts
+const readableStream = new ReadableStream({
+  start(controller) {
+    controller.enqueue(1);
+    controller.enqueue(2);
+  },
+  pull(controller) {
+    controller.enqueue(3);
+    controller.close();
+  }
+});
+
+for await (const value of readerValues(readableStream.getReader())) {
+  console.log(value); // Prints "1", "2", "3".
+}
+```
+
+## Converting an `AsyncIterable`/`Iterable` to `ReadableStream`
+
+```ts
+const iterable = [1, 2, 3].values();
+const readable = iterableGetReadable(iterable);
+
+readable.pipeTo(stream.writable); // Will write 1, 2, 3.
+```
+
+## Others
+
 ### Typed `Observable`
 
 `Observable` and `Symbol.observable` is re-exported from `core-js-pure` with proper type definitions.
 
-### Converting an `Observable` to `AsyncIterable`
+### Producer-consumer queue
 
-`observableValues` subscribes to an `Observable` and return as `AsyncIterableIterator`.
+`PushAsyncIterableIterator` is a simple push-based producer-consumer queue and designed to decouple the flow between a producer and consumer. The producer can push a new job at anytime. The consumer can pull a job at its own convenience.
 
-`Observable` is push-based and `AsyncIterableIterator` is pull-based. Values from `Observable` may push continuously and will be buffered internally. When for-loop break or complete, the iterator will unsubscribe from the `Observable`.
+Compare to pull-based queue, a push-based queue is easier to use. However, pull-based queue offers better flow control as it will produce a job only if there is a consumer ready to consume.
+
+For a full-featured producer-consumer queue that supports flow control, use `ReadableStream` instead.
 
 ```ts
-const observable = Observable.from([1, 2, 3]);
+const iterable = new PushAsyncIterableIterator();
+
+(async function consumer() {
+  for await (const value of iterable) {
+    console.log(value);
+  }
+
+  console.log('Done');
+})();
 
-for await (const value of observableValues(observable)) {
+(async function producer() {
+  iterable.push(1);
+  iterable.push(2);
+  iterable.push(3);
+  iterable.close();
+})();
+
+// Prints "1", "2", "3", "Done".
+```
+
+### Using for-loop with generator
+
+Compare to `Iterator`, `Generator` offers advanced capability.
+
+When using for-loop with generator, the last value return from the generator is lost.
+
+The `generatorWithLastValue()` and `asyncGeneratorWithLastValue()` helps bridge the for-loop usage by capturing the value returned as `{ done: true }` and make it accessible via `lastValue()`.
+
+```ts
+const generator = generatorWithLastValue(
+  (function* () {
+    yield 1;
+    yield 2;
+    yield 3;
+
+    return 'end';
+  })()
+);
+
+for (const value of generator) {
   console.log(value); // Prints "1", "2", "3".
 }
+
+console.log(generator.lastValue()); // Prints "end".
+```
+
+Note: `lastValue()` will throw if it is being called before end of iteration. Also, excessive calls to `next()` will return `{ done: true, value: undefined }`, thus, `lastValue()` could become `undefined` if `next()` is called after the end of iteration.
+
+The value returned from `generatorWithLastValue()`/`asyncGeneratorWithLastValue()` will passthrough all function calls to original `Generator` with a minor difference. Calling `[Symbol.iterator]()`/`[Symbol.asyncIterator]()` on the returned generator will not start a fresh iteration. If a fresh iteration is required, create a new one before passing it to `generatorWithLastValue()`/`asyncGeneratorWithLastValue()`.
+
+```ts
+const generator = generatorWithLastValue(
+  (function* () {
+    // ...
+  })()[Symbol.iterator]() // Creates a fresh iteration.
+);
 ```
 
 ## Behaviors

package/dist/chunk-2DE3J4J7.mjs

@@ -0,0 +1,35 @@
+// src/generatorWithLastValue.ts
+var STILL_ITERATING = Symbol();
+function generatorWithLastValue(generator) {
+  let lastValue = STILL_ITERATING;
+  const generatorWithLastValue2 = {
+    [Symbol.iterator]() {
+      return generatorWithLastValue2;
+    },
+    lastValue() {
+      if (lastValue === STILL_ITERATING) {
+        throw new Error("Iteration has not complete yet, cannot get last value.");
+      }
+      return lastValue;
+    },
+    next(next) {
+      const result = generator.next(next);
+      if (result.done) {
+        lastValue = result.value;
+      }
+      return result;
+    },
+    return(value) {
+      return generator.return(value);
+    },
+    throw(error) {
+      return generator.throw(error);
+    }
+  };
+  return generatorWithLastValue2;
+}
+
+export {
+  generatorWithLastValue
+};
+//# sourceMappingURL=chunk-2DE3J4J7.mjs.map

package/dist/chunk-2DE3J4J7.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/generatorWithLastValue.ts"],"sourcesContent":["const STILL_ITERATING = Symbol();\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type GeneratorWithLastValue<T = unknown, TReturn = any, TNext = unknown> = Generator<T, TReturn, TNext> & {\n  lastValue(): TReturn;\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function generatorWithLastValue<T = unknown, TReturn = any, TNext = unknown>(\n  generator: Generator<T, TReturn, TNext>\n): GeneratorWithLastValue<T, TReturn, TNext> {\n  let lastValue: typeof STILL_ITERATING | TReturn = STILL_ITERATING;\n\n  const generatorWithLastValue = {\n    [Symbol.iterator]() {\n      return generatorWithLastValue;\n    },\n    lastValue(): TReturn {\n      if (lastValue === STILL_ITERATING) {\n        throw new Error('Iteration has not complete yet, cannot get last value.');\n      }\n\n      return lastValue;\n    },\n    next(next: TNext) {\n      const result = generator.next(next);\n\n      if (result.done) {\n        lastValue = result.value;\n      }\n\n      return result;\n    },\n    return(value: TReturn) {\n      return generator.return(value);\n    },\n    throw(error: unknown) {\n      return generator.throw(error);\n    }\n  };\n\n  return generatorWithLastValue;\n}\n"],"mappings":";AAAA,IAAM,kBAAkB,OAAO;AAQxB,SAAS,uBACd,WAC2C;AAC3C,MAAI,YAA8C;AAElD,QAAMA,0BAAyB;AAAA,IAC7B,CAAC,OAAO,QAAQ,IAAI;AAClB,aAAOA;AAAA,IACT;AAAA,IACA,YAAqB;AACnB,UAAI,cAAc,iBAAiB;AACjC,cAAM,IAAI,MAAM,wDAAwD;AAAA,MAC1E;AAEA,aAAO;AAAA,IACT;AAAA,IACA,KAAK,MAAa;AAChB,YAAM,SAAS,UAAU,KAAK,IAAI;AAElC,UAAI,OAAO,MAAM;AACf,oBAAY,OAAO;AAAA,MACrB;AAEA,aAAO;AAAA,IACT;AAAA,IACA,OAAO,OAAgB;AACrB,aAAO,UAAU,OAAO,KAAK;AAAA,IAC/B;AAAA,IACA,MAAM,OAAgB;AACpB,aAAO,UAAU,MAAM,KAAK;AAAA,IAC9B;AAAA,EACF;AAEA,SAAOA;AACT;","names":["generatorWithLastValue"]}

package/dist/chunk-ANRVAYLW.mjs

@@ -0,0 +1,35 @@
+// src/asyncGeneratorWithLastValue.ts
+var STILL_ITERATING = Symbol();
+function asyncGeneratorWithLastValue(generator) {
+  let lastValue = STILL_ITERATING;
+  const asyncGeneratorWithLastValue2 = {
+    [Symbol.asyncIterator]() {
+      return asyncGeneratorWithLastValue2;
+    },
+    lastValue() {
+      if (lastValue === STILL_ITERATING) {
+        throw new Error("Iteration has not complete yet, cannot get last value.");
+      }
+      return lastValue;
+    },
+    async next(next) {
+      const result = await generator.next(next);
+      if (result.done) {
+        lastValue = result.value;
+      }
+      return result;
+    },
+    return(value) {
+      return generator.return(value);
+    },
+    throw(error) {
+      return generator.throw(error);
+    }
+  };
+  return asyncGeneratorWithLastValue2;
+}
+
+export {
+  asyncGeneratorWithLastValue
+};
+//# sourceMappingURL=chunk-ANRVAYLW.mjs.map

package/dist/chunk-ANRVAYLW.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/asyncGeneratorWithLastValue.ts"],"sourcesContent":["const STILL_ITERATING = Symbol();\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AsyncGeneratorWithLastValue<T = unknown, TReturn = any, TNext = unknown> = AsyncGenerator<\n  T,\n  TReturn,\n  TNext\n> & {\n  lastValue(): TReturn;\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function asyncGeneratorWithLastValue<T = unknown, TReturn = any, TNext = unknown>(\n  generator: AsyncGenerator<T, TReturn, TNext>\n): AsyncGeneratorWithLastValue<T, TReturn, TNext> {\n  let lastValue: typeof STILL_ITERATING | TReturn = STILL_ITERATING;\n\n  const asyncGeneratorWithLastValue = {\n    [Symbol.asyncIterator]() {\n      return asyncGeneratorWithLastValue;\n    },\n    lastValue(): TReturn {\n      if (lastValue === STILL_ITERATING) {\n        throw new Error('Iteration has not complete yet, cannot get last value.');\n      }\n\n      return lastValue;\n    },\n    async next(next: TNext) {\n      const result = await generator.next(next);\n\n      if (result.done) {\n        lastValue = result.value;\n      }\n\n      return result;\n    },\n    return(value: TReturn) {\n      return generator.return(value);\n    },\n    throw(error: unknown) {\n      return generator.throw(error);\n    }\n  };\n\n  return asyncGeneratorWithLastValue;\n}\n"],"mappings":";AAAA,IAAM,kBAAkB,OAAO;AAYxB,SAAS,4BACd,WACgD;AAChD,MAAI,YAA8C;AAElD,QAAMA,+BAA8B;AAAA,IAClC,CAAC,OAAO,aAAa,IAAI;AACvB,aAAOA;AAAA,IACT;AAAA,IACA,YAAqB;AACnB,UAAI,cAAc,iBAAiB;AACjC,cAAM,IAAI,MAAM,wDAAwD;AAAA,MAC1E;AAEA,aAAO;AAAA,IACT;AAAA,IACA,MAAM,KAAK,MAAa;AACtB,YAAM,SAAS,MAAM,UAAU,KAAK,IAAI;AAExC,UAAI,OAAO,MAAM;AACf,oBAAY,OAAO;AAAA,MACrB;AAEA,aAAO;AAAA,IACT;AAAA,IACA,OAAO,OAAgB;AACrB,aAAO,UAAU,OAAO,KAAK;AAAA,IAC/B;AAAA,IACA,MAAM,OAAgB;AACpB,aAAO,UAAU,MAAM,KAAK;AAAA,IAC9B;AAAA,EACF;AAEA,SAAOA;AACT;","names":["asyncGeneratorWithLastValue"]}

package/dist/chunk-EIIP7YWB.mjs

@@ -0,0 +1,27 @@
+// src/observableSubscribeAsReadable.ts
+function observableSubscribeAsReadable(observable) {
+  let subscription;
+  return new ReadableStream({
+    cancel() {
+      subscription.unsubscribe();
+    },
+    start(controller) {
+      subscription = observable.subscribe({
+        complete() {
+          controller.close();
+        },
+        error(err) {
+          controller.error(err);
+        },
+        next(value) {
+          controller.enqueue(value);
+        }
+      });
+    }
+  });
+}
+
+export {
+  observableSubscribeAsReadable
+};
+//# sourceMappingURL=chunk-EIIP7YWB.mjs.map

package/dist/chunk-EIIP7YWB.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/observableSubscribeAsReadable.ts"],"sourcesContent":["import type { Observable, Subscription } from './Observable';\n\nexport function observableSubscribeAsReadable<T>(observable: Observable<T>): ReadableStream<T> {\n  let subscription: Subscription;\n\n  return new ReadableStream<T>({\n    cancel() {\n      subscription.unsubscribe();\n    },\n    start(controller) {\n      subscription = observable.subscribe({\n        complete() {\n          controller.close();\n        },\n        error(err: unknown) {\n          controller.error(err);\n        },\n        next(value) {\n          controller.enqueue(value);\n        }\n      });\n    }\n  });\n}\n"],"mappings":";AAEO,SAAS,8BAAiC,YAA8C;AAC7F,MAAI;AAEJ,SAAO,IAAI,eAAkB;AAAA,IAC3B,SAAS;AACP,mBAAa,YAAY;AAAA,IAC3B;AAAA,IACA,MAAM,YAAY;AAChB,qBAAe,WAAW,UAAU;AAAA,QAClC,WAAW;AACT,qBAAW,MAAM;AAAA,QACnB;AAAA,QACA,MAAM,KAAc;AAClB,qBAAW,MAAM,GAAG;AAAA,QACtB;AAAA,QACA,KAAK,OAAO;AACV,qBAAW,QAAQ,KAAK;AAAA,QAC1B;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF,CAAC;AACH;","names":[]}

package/dist/chunk-EUVK4YM7.mjs

@@ -0,0 +1,25 @@
+// src/readerValues.ts
+function readerValues(reader) {
+  const iterable = {
+    [Symbol.asyncIterator]() {
+      return iterable;
+    },
+    async next() {
+      const result = await Promise.race([reader.read(), reader.closed]);
+      if (!result || result.done) {
+        return { done: true, value: void 0 };
+      }
+      return { value: result.value };
+    },
+    async return() {
+      reader.cancel();
+      return { done: true, value: void 0 };
+    }
+  };
+  return iterable;
+}
+
+export {
+  readerValues
+};
+//# sourceMappingURL=chunk-EUVK4YM7.mjs.map

package/dist/chunk-EUVK4YM7.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/readerValues.ts"],"sourcesContent":["export function readerValues<T>(reader: ReadableStreamDefaultReader<T>): AsyncIterableIterator<T> {\n  const iterable: AsyncIterableIterator<T> = {\n    [Symbol.asyncIterator]() {\n      return iterable;\n    },\n    async next(): Promise<IteratorResult<T>> {\n      const result = await Promise.race([reader.read(), reader.closed]);\n\n      if (!result || result.done) {\n        return { done: true, value: undefined };\n      }\n\n      return { value: result.value };\n    },\n    async return() {\n      // Throw inside for-loop is return().\n      reader.cancel();\n\n      return { done: true, value: undefined };\n    }\n  };\n\n  return iterable;\n}\n"],"mappings":";AAAO,SAAS,aAAgB,QAAkE;AAChG,QAAM,WAAqC;AAAA,IACzC,CAAC,OAAO,aAAa,IAAI;AACvB,aAAO;AAAA,IACT;AAAA,IACA,MAAM,OAAmC;AACvC,YAAM,SAAS,MAAM,QAAQ,KAAK,CAAC,OAAO,KAAK,GAAG,OAAO,MAAM,CAAC;AAEhE,UAAI,CAAC,UAAU,OAAO,MAAM;AAC1B,eAAO,EAAE,MAAM,MAAM,OAAO,OAAU;AAAA,MACxC;AAEA,aAAO,EAAE,OAAO,OAAO,MAAM;AAAA,IAC/B;AAAA,IACA,MAAM,SAAS;AAEb,aAAO,OAAO;AAEd,aAAO,EAAE,MAAM,MAAM,OAAO,OAAU;AAAA,IACxC;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

package/dist/chunk-FEOLYD5R.mjs

@@ -0,0 +1,31 @@
+import {
+  Observable
+} from "./chunk-VLF6DI2U.mjs";
+
+// src/observableFromAsync.ts
+function observableFromAsync(iterable) {
+  return new Observable((subscriber) => {
+    let closed = false;
+    (async function() {
+      try {
+        for await (const value of iterable) {
+          if (closed) {
+            break;
+          }
+          subscriber.next(value);
+        }
+        subscriber.complete();
+      } catch (error) {
+        subscriber.error(error);
+      }
+    })();
+    return () => {
+      closed = true;
+    };
+  });
+}
+
+export {
+  observableFromAsync
+};
+//# sourceMappingURL=chunk-FEOLYD5R.mjs.map

package/dist/chunk-FEOLYD5R.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/observableFromAsync.ts"],"sourcesContent":["import { Observable } from './Observable';\n\nexport function observableFromAsync<T>(iterable: AsyncIterable<T>): Observable<T> {\n  return new Observable(subscriber => {\n    let closed = false;\n\n    (async function () {\n      try {\n        for await (const value of iterable) {\n          if (closed) {\n            break;\n          }\n\n          subscriber.next(value);\n        }\n\n        subscriber.complete();\n      } catch (error) {\n        subscriber.error(error);\n      }\n    })();\n\n    return () => {\n      closed = true;\n    };\n  });\n}\n"],"mappings":";;;;;AAEO,SAAS,oBAAuB,UAA2C;AAChF,SAAO,IAAI,WAAW,gBAAc;AAClC,QAAI,SAAS;AAEb,KAAC,iBAAkB;AACjB,UAAI;AACF,yBAAiB,SAAS,UAAU;AAClC,cAAI,QAAQ;AACV;AAAA,UACF;AAEA,qBAAW,KAAK,KAAK;AAAA,QACvB;AAEA,mBAAW,SAAS;AAAA,MACtB,SAAS,OAAO;AACd,mBAAW,MAAM,KAAK;AAAA,MACxB;AAAA,IACF,GAAG;AAEH,WAAO,MAAM;AACX,eAAS;AAAA,IACX;AAAA,EACF,CAAC;AACH;","names":[]}

package/dist/chunk-MOBXUTO5.mjs

@@ -0,0 +1,22 @@
+// src/iterableGetReadable.ts
+function isIterable(iterable) {
+  return !!(iterable && typeof iterable === "object" && Symbol.iterator in iterable);
+}
+function iterableGetReadable(iterable) {
+  const iterator = isIterable(iterable) ? iterable[Symbol.iterator]() : iterable[Symbol.asyncIterator]();
+  return new ReadableStream({
+    async pull(controller) {
+      const result = await iterator.next();
+      if (result.done) {
+        controller.close();
+      } else {
+        controller.enqueue(result.value);
+      }
+    }
+  });
+}
+
+export {
+  iterableGetReadable
+};
+//# sourceMappingURL=chunk-MOBXUTO5.mjs.map

package/dist/chunk-MOBXUTO5.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/iterableGetReadable.ts"],"sourcesContent":["function isIterable(iterable: unknown): iterable is Iterable<unknown> {\n  return !!(iterable && typeof iterable === 'object' && Symbol.iterator in iterable);\n}\n\nexport function iterableGetReadable<T>(iterable: AsyncIterable<T> | Iterable<T>): ReadableStream<T> {\n  const iterator = isIterable(iterable) ? iterable[Symbol.iterator]() : iterable[Symbol.asyncIterator]();\n\n  return new ReadableStream({\n    async pull(controller) {\n      const result = await iterator.next();\n\n      if (result.done) {\n        controller.close();\n      } else {\n        controller.enqueue(result.value);\n      }\n    }\n  });\n}\n"],"mappings":";AAAA,SAAS,WAAW,UAAkD;AACpE,SAAO,CAAC,EAAE,YAAY,OAAO,aAAa,YAAY,OAAO,YAAY;AAC3E;AAEO,SAAS,oBAAuB,UAA6D;AAClG,QAAM,WAAW,WAAW,QAAQ,IAAI,SAAS,OAAO,QAAQ,EAAE,IAAI,SAAS,OAAO,aAAa,EAAE;AAErG,SAAO,IAAI,eAAe;AAAA,IACxB,MAAM,KAAK,YAAY;AACrB,YAAM,SAAS,MAAM,SAAS,KAAK;AAEnC,UAAI,OAAO,MAAM;AACf,mBAAW,MAAM;AAAA,MACnB,OAAO;AACL,mBAAW,QAAQ,OAAO,KAAK;AAAA,MACjC;AAAA,IACF;AAAA,EACF,CAAC;AACH;","names":[]}

package/dist/chunk-O5SQJUKB.mjs

@@ -0,0 +1,37 @@
+// src/private/withResolvers.ts
+import coreJSPromiseWithResolvers from "core-js-pure/full/promise/with-resolvers";
+function withResolvers() {
+  return coreJSPromiseWithResolvers();
+}
+
+// src/PushAsyncIterableIterator.ts
+var CLOSE = Symbol("close");
+var PushAsyncIterableIterator = class {
+  #closed = false;
+  #pushResolvers = withResolvers();
+  [Symbol.asyncIterator]() {
+    return this;
+  }
+  close() {
+    this.#closed = true;
+    this.#pushResolvers.resolve(CLOSE);
+  }
+  async next() {
+    const value = await this.#pushResolvers.promise;
+    if (value === CLOSE) {
+      return { done: true, value: void 0 };
+    }
+    return { done: false, value };
+  }
+  push(value) {
+    if (!this.#closed) {
+      this.#pushResolvers.resolve(value);
+      this.#pushResolvers = withResolvers();
+    }
+  }
+};
+
+export {
+  PushAsyncIterableIterator
+};
+//# sourceMappingURL=chunk-O5SQJUKB.mjs.map

package/dist/chunk-O5SQJUKB.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/private/withResolvers.ts","../src/PushAsyncIterableIterator.ts"],"sourcesContent":["// @ts-expect-error \"core-js\" is not typed.\nimport coreJSPromiseWithResolvers from 'core-js-pure/full/promise/with-resolvers';\n\nexport default function withResolvers<T>(): PromiseWithResolvers<T> {\n  return coreJSPromiseWithResolvers();\n}\n","import withResolvers from './private/withResolvers';\n\nconst CLOSE = Symbol('close');\n\nexport class PushAsyncIterableIterator<T> implements AsyncIterableIterator<T> {\n  #closed: boolean = false;\n  #pushResolvers: PromiseWithResolvers<T | typeof CLOSE> = withResolvers();\n\n  [Symbol.asyncIterator]() {\n    return this;\n  }\n\n  close() {\n    this.#closed = true;\n    this.#pushResolvers.resolve(CLOSE);\n  }\n\n  async next(): Promise<IteratorResult<T>> {\n    const value = await this.#pushResolvers.promise;\n\n    if (value === CLOSE) {\n      return { done: true, value: undefined };\n    }\n\n    return { done: false, value };\n  }\n\n  push(value: T) {\n    if (!this.#closed) {\n      this.#pushResolvers.resolve(value);\n      this.#pushResolvers = withResolvers();\n    }\n  }\n}\n"],"mappings":";AACA,OAAO,gCAAgC;AAExB,SAAR,gBAA6D;AAClE,SAAO,2BAA2B;AACpC;;;ACHA,IAAM,QAAQ,OAAO,OAAO;AAErB,IAAM,4BAAN,MAAuE;AAAA,EAC5E,UAAmB;AAAA,EACnB,iBAAyD,cAAc;AAAA,EAEvE,CAAC,OAAO,aAAa,IAAI;AACvB,WAAO;AAAA,EACT;AAAA,EAEA,QAAQ;AACN,SAAK,UAAU;AACf,SAAK,eAAe,QAAQ,KAAK;AAAA,EACnC;AAAA,EAEA,MAAM,OAAmC;AACvC,UAAM,QAAQ,MAAM,KAAK,eAAe;AAExC,QAAI,UAAU,OAAO;AACnB,aAAO,EAAE,MAAM,MAAM,OAAO,OAAU;AAAA,IACxC;AAEA,WAAO,EAAE,MAAM,OAAO,MAAM;AAAA,EAC9B;AAAA,EAEA,KAAK,OAAU;AACb,QAAI,CAAC,KAAK,SAAS;AACjB,WAAK,eAAe,QAAQ,KAAK;AACjC,WAAK,iBAAiB,cAAc;AAAA,IACtC;AAAA,EACF;AACF;","names":[]}

package/dist/chunk-P4OSZLEH.mjs

@@ -0,0 +1,15 @@
+// src/asyncIteratorToAsyncIterable.ts
+function asyncIteratorToAsyncIterable(asyncIterator) {
+  const asyncIterableIterator = {
+    [Symbol.asyncIterator]: () => asyncIterableIterator,
+    next: asyncIterator.next.bind(asyncIterator),
+    ...asyncIterator.return ? { return: asyncIterator.return.bind(asyncIterator) } : {},
+    ...asyncIterator.throw ? { throw: asyncIterator.throw.bind(asyncIterator) } : {}
+  };
+  return asyncIterableIterator;
+}
+
+export {
+  asyncIteratorToAsyncIterable
+};
+//# sourceMappingURL=chunk-P4OSZLEH.mjs.map

package/dist/chunk-P4OSZLEH.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/asyncIteratorToAsyncIterable.ts"],"sourcesContent":["export function asyncIteratorToAsyncIterable<T>(asyncIterator: AsyncIterator<T>): AsyncIterableIterator<T> {\n  const asyncIterableIterator: AsyncIterableIterator<T> = {\n    [Symbol.asyncIterator]: () => asyncIterableIterator,\n    next: asyncIterator.next.bind(asyncIterator),\n    ...(asyncIterator.return ? { return: asyncIterator.return.bind(asyncIterator) } : {}),\n    ...(asyncIterator.throw ? { throw: asyncIterator.throw.bind(asyncIterator) } : {})\n  };\n\n  return asyncIterableIterator;\n}\n"],"mappings":";AAAO,SAAS,6BAAgC,eAA2D;AACzG,QAAM,wBAAkD;AAAA,IACtD,CAAC,OAAO,aAAa,GAAG,MAAM;AAAA,IAC9B,MAAM,cAAc,KAAK,KAAK,aAAa;AAAA,IAC3C,GAAI,cAAc,SAAS,EAAE,QAAQ,cAAc,OAAO,KAAK,aAAa,EAAE,IAAI,CAAC;AAAA,IACnF,GAAI,cAAc,QAAQ,EAAE,OAAO,cAAc,MAAM,KAAK,aAAa,EAAE,IAAI,CAAC;AAAA,EAClF;AAEA,SAAO;AACT;","names":[]}

package/dist/iter-fest.asyncGeneratorWithLastValue.d.mts

@@ -0,0 +1,6 @@
+type AsyncGeneratorWithLastValue<T = unknown, TReturn = any, TNext = unknown> = AsyncGenerator<T, TReturn, TNext> & {
+    lastValue(): TReturn;
+};
+declare function asyncGeneratorWithLastValue<T = unknown, TReturn = any, TNext = unknown>(generator: AsyncGenerator<T, TReturn, TNext>): AsyncGeneratorWithLastValue<T, TReturn, TNext>;
+
+export { type AsyncGeneratorWithLastValue, asyncGeneratorWithLastValue };

package/dist/iter-fest.asyncGeneratorWithLastValue.d.ts

@@ -0,0 +1,6 @@
+type AsyncGeneratorWithLastValue<T = unknown, TReturn = any, TNext = unknown> = AsyncGenerator<T, TReturn, TNext> & {
+    lastValue(): TReturn;
+};
+declare function asyncGeneratorWithLastValue<T = unknown, TReturn = any, TNext = unknown>(generator: AsyncGenerator<T, TReturn, TNext>): AsyncGeneratorWithLastValue<T, TReturn, TNext>;
+
+export { type AsyncGeneratorWithLastValue, asyncGeneratorWithLastValue };

package/dist/iter-fest.asyncGeneratorWithLastValue.js

@@ -0,0 +1,59 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/asyncGeneratorWithLastValue.ts
+var asyncGeneratorWithLastValue_exports = {};
+__export(asyncGeneratorWithLastValue_exports, {
+  asyncGeneratorWithLastValue: () => asyncGeneratorWithLastValue
+});
+module.exports = __toCommonJS(asyncGeneratorWithLastValue_exports);
+var STILL_ITERATING = Symbol();
+function asyncGeneratorWithLastValue(generator) {
+  let lastValue = STILL_ITERATING;
+  const asyncGeneratorWithLastValue2 = {
+    [Symbol.asyncIterator]() {
+      return asyncGeneratorWithLastValue2;
+    },
+    lastValue() {
+      if (lastValue === STILL_ITERATING) {
+        throw new Error("Iteration has not complete yet, cannot get last value.");
+      }
+      return lastValue;
+    },
+    async next(next) {
+      const result = await generator.next(next);
+      if (result.done) {
+        lastValue = result.value;
+      }
+      return result;
+    },
+    return(value) {
+      return generator.return(value);
+    },
+    throw(error) {
+      return generator.throw(error);
+    }
+  };
+  return asyncGeneratorWithLastValue2;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  asyncGeneratorWithLastValue
+});
+//# sourceMappingURL=iter-fest.asyncGeneratorWithLastValue.js.map

package/dist/iter-fest.asyncGeneratorWithLastValue.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/asyncGeneratorWithLastValue.ts"],"sourcesContent":["const STILL_ITERATING = Symbol();\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AsyncGeneratorWithLastValue<T = unknown, TReturn = any, TNext = unknown> = AsyncGenerator<\n  T,\n  TReturn,\n  TNext\n> & {\n  lastValue(): TReturn;\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function asyncGeneratorWithLastValue<T = unknown, TReturn = any, TNext = unknown>(\n  generator: AsyncGenerator<T, TReturn, TNext>\n): AsyncGeneratorWithLastValue<T, TReturn, TNext> {\n  let lastValue: typeof STILL_ITERATING | TReturn = STILL_ITERATING;\n\n  const asyncGeneratorWithLastValue = {\n    [Symbol.asyncIterator]() {\n      return asyncGeneratorWithLastValue;\n    },\n    lastValue(): TReturn {\n      if (lastValue === STILL_ITERATING) {\n        throw new Error('Iteration has not complete yet, cannot get last value.');\n      }\n\n      return lastValue;\n    },\n    async next(next: TNext) {\n      const result = await generator.next(next);\n\n      if (result.done) {\n        lastValue = result.value;\n      }\n\n      return result;\n    },\n    return(value: TReturn) {\n      return generator.return(value);\n    },\n    throw(error: unknown) {\n      return generator.throw(error);\n    }\n  };\n\n  return asyncGeneratorWithLastValue;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAAM,kBAAkB,OAAO;AAYxB,SAAS,4BACd,WACgD;AAChD,MAAI,YAA8C;AAElD,QAAMA,+BAA8B;AAAA,IAClC,CAAC,OAAO,aAAa,IAAI;AACvB,aAAOA;AAAA,IACT;AAAA,IACA,YAAqB;AACnB,UAAI,cAAc,iBAAiB;AACjC,cAAM,IAAI,MAAM,wDAAwD;AAAA,MAC1E;AAEA,aAAO;AAAA,IACT;AAAA,IACA,MAAM,KAAK,MAAa;AACtB,YAAM,SAAS,MAAM,UAAU,KAAK,IAAI;AAExC,UAAI,OAAO,MAAM;AACf,oBAAY,OAAO;AAAA,MACrB;AAEA,aAAO;AAAA,IACT;AAAA,IACA,OAAO,OAAgB;AACrB,aAAO,UAAU,OAAO,KAAK;AAAA,IAC/B;AAAA,IACA,MAAM,OAAgB;AACpB,aAAO,UAAU,MAAM,KAAK;AAAA,IAC9B;AAAA,EACF;AAEA,SAAOA;AACT;","names":["asyncGeneratorWithLastValue"]}

package/dist/iter-fest.asyncGeneratorWithLastValue.mjs

@@ -0,0 +1,7 @@
+import {
+  asyncGeneratorWithLastValue
+} from "./chunk-ANRVAYLW.mjs";
+export {
+  asyncGeneratorWithLastValue
+};
+//# sourceMappingURL=iter-fest.asyncGeneratorWithLastValue.mjs.map

package/dist/iter-fest.asyncIteratorToAsyncIterable.d.mts

@@ -0,0 +1,3 @@
+declare function asyncIteratorToAsyncIterable<T>(asyncIterator: AsyncIterator<T>): AsyncIterableIterator<T>;
+
+export { asyncIteratorToAsyncIterable };

package/dist/iter-fest.asyncIteratorToAsyncIterable.d.ts

@@ -0,0 +1,3 @@
+declare function asyncIteratorToAsyncIterable<T>(asyncIterator: AsyncIterator<T>): AsyncIterableIterator<T>;
+
+export { asyncIteratorToAsyncIterable };

package/dist/iter-fest.asyncIteratorToAsyncIterable.js

@@ -0,0 +1,39 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/asyncIteratorToAsyncIterable.ts
+var asyncIteratorToAsyncIterable_exports = {};
+__export(asyncIteratorToAsyncIterable_exports, {
+  asyncIteratorToAsyncIterable: () => asyncIteratorToAsyncIterable
+});
+module.exports = __toCommonJS(asyncIteratorToAsyncIterable_exports);
+function asyncIteratorToAsyncIterable(asyncIterator) {
+  const asyncIterableIterator = {
+    [Symbol.asyncIterator]: () => asyncIterableIterator,
+    next: asyncIterator.next.bind(asyncIterator),
+    ...asyncIterator.return ? { return: asyncIterator.return.bind(asyncIterator) } : {},
+    ...asyncIterator.throw ? { throw: asyncIterator.throw.bind(asyncIterator) } : {}
+  };
+  return asyncIterableIterator;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  asyncIteratorToAsyncIterable
+});
+//# sourceMappingURL=iter-fest.asyncIteratorToAsyncIterable.js.map

package/dist/iter-fest.asyncIteratorToAsyncIterable.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/asyncIteratorToAsyncIterable.ts"],"sourcesContent":["export function asyncIteratorToAsyncIterable<T>(asyncIterator: AsyncIterator<T>): AsyncIterableIterator<T> {\n  const asyncIterableIterator: AsyncIterableIterator<T> = {\n    [Symbol.asyncIterator]: () => asyncIterableIterator,\n    next: asyncIterator.next.bind(asyncIterator),\n    ...(asyncIterator.return ? { return: asyncIterator.return.bind(asyncIterator) } : {}),\n    ...(asyncIterator.throw ? { throw: asyncIterator.throw.bind(asyncIterator) } : {})\n  };\n\n  return asyncIterableIterator;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAO,SAAS,6BAAgC,eAA2D;AACzG,QAAM,wBAAkD;AAAA,IACtD,CAAC,OAAO,aAAa,GAAG,MAAM;AAAA,IAC9B,MAAM,cAAc,KAAK,KAAK,aAAa;AAAA,IAC3C,GAAI,cAAc,SAAS,EAAE,QAAQ,cAAc,OAAO,KAAK,aAAa,EAAE,IAAI,CAAC;AAAA,IACnF,GAAI,cAAc,QAAQ,EAAE,OAAO,cAAc,MAAM,KAAK,aAAa,EAAE,IAAI,CAAC;AAAA,EAClF;AAEA,SAAO;AACT;","names":[]}

package/dist/iter-fest.asyncIteratorToAsyncIterable.mjs

@@ -0,0 +1,7 @@
+import {
+  asyncIteratorToAsyncIterable
+} from "./chunk-P4OSZLEH.mjs";
+export {
+  asyncIteratorToAsyncIterable
+};
+//# sourceMappingURL=iter-fest.asyncIteratorToAsyncIterable.mjs.map

package/dist/iter-fest.asyncIteratorToAsyncIterable.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}