iter-fest 0.1.1-main.22b897b → 0.1.1-main.2a21293

package/README.md

@@ -16,26 +16,22 @@ Iterables can contains infinite number of items, please use this package respons
 npm install iter-fest
 ```
 
-### `Array.prototype` ports
+## Conversions
 
-We ported majority of functions from `Array.prototype.*` to `iterable*`.
-
-```ts
-import { iterableIncludes, iterableReduce } from 'iter-fest'; // Via default exports.
-import { iterableSome } from 'iter-fest/iterableSome'; // Via named exports.
-
-const iterable: Iterable<number> = [1, 2, 3, 4, 5].values();
-
-console.log(iterableIncludes(iterable, 3)); // Prints "true".
-console.log(iterableReduce(iterable, (sum, value) => sum + value, 0)); // Prints "15".
-console.log(iterableSome(iterable, value => value % 2)); // Prints "true".
-```
+| 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) |
 
-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).
+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 +40,7 @@ const iterate = (): Iterator<number> => {
   return {
     next: () => {
       if (++value <= 3) {
-        return { done: false, value };
+        return { value };
       }
 
       return { done: true, value: undefined };
@@ -57,29 +53,31 @@ for (const value of iteratorToIterable(iterate())) {
 }
 ```
 
-### Typed `Observable`
-
-`Observable` and `Symbol.observable` is re-exported from `core-js-pure` with proper type definitions.
+Note: calling `[Symbol.iterator]()` or `[Symbol.asyncIterator]()` will not restart the iteration. This is because iterator is an instance of iteration and is not restartable.
 
 ### Converting an `Observable` to `AsyncIterableIterator`
 
-`observableValues` subscribes to an `Observable` and return as `AsyncIterableIterator`.
+`ReadableStream` can be used as an intermediate format when converting an `Observable` to `AsyncIterableIterator`.
 
-`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`.
+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);
+const iterable = readerValues(readable.getReader());
 
-for await (const value of observableValues(observable)) {
+for await (const value of iterable) {
   console.log(value); // Prints "1", "2", "3".
 }
 ```
 
+Note: calling `[Symbol.asyncIterator]()` will not resubscribe and read from the start of the observable. This is because the intermediate format does not support restart.
+
 ### Converting an `AsyncIterable` to `Observable`
 
 `Observable.from` converts `Iterable` into `Observable`. However, it does not convert `AsyncIterable`.
 
-`observableFromAsync` will convert `AsyncIterable` into `Observable`.
+`observableFromAsync` will convert `AsyncIterable` into `Observable`. It will try to restart the iteration by calling `[Symbol.asyncIterator]()`.
 
 ```ts
 async function* generate() {
@@ -94,11 +92,70 @@ const next = value => console.log(value);
 observable.subscribe({ next }); // Prints "1", "2", "3".
 ```
 
+Note: `observableFromAsync` will call `[Symbol.asyncIterator]()` initially to restart the iteration where possible.
+
+### 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);
+
+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();
+  }
+});
+
+const iterable = readerValues(readableStream.getReader());
+
+for await (const value of iterable) {
+  console.log(value); // Prints "1", "2", "3".
+}
+```
+
+Note: `[Symbol.asyncIterator]()` will not restart the reader and read from start of the stream. Reader is not restartable and streams are not seekable.
+
+### 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.
+```
+
+Note: `iterableGetReadable()` will call `[Symbol.iterator]()` initially to restart the iteration where possible.
+
+## Others
+
+### Typed `Observable`
+
+`Observable` and `Symbol.observable` is re-exported from `core-js-pure` with proper type definitions.
+
 ### Producer-consumer queue
 
-`PushAsyncIterableIterator` is a simple push-based producer-consumer queue. The producer can push a new job at anytime. The consumer will wait for jobs to be available.
+`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 via for-loop.
 
-A push-based queue is easier to use than a pull-based queue. However, pull-based queue offers better flow control. For a full-featured producer-consumer queue that supports flow control, use `ReadableStream` instead.
+Compare to pull-based queue, a push-based queue is very easy 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 iterable = new PushAsyncIterableIterator();
@@ -121,22 +178,61 @@ const iterable = new PushAsyncIterableIterator();
 // Prints "1", "2", "3", "Done".
 ```
 
-### Iterating `ReadableStreamDefaultReader`
+### Using for-loop with generator
+
+Compare to `Iterator`, `Generator` offers advanced capability.
 
-`readerToAsyncIterableIterator` will convert default reader of `ReadableStream` into an `AsyncIterableIterator` to use in for-loop.
+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 readableStream = new ReadableStream({ start(controller) {
-  controller.enqueue(1);
-  controller.enqueue(2);
-  controller.close();
-} });
+const generator = generatorWithLastValue(
+  (function* () {
+    yield 1;
+    yield 2;
+    yield 3;
+
+    return 'end';
+  })()
+);
 
-for await (const value of readerToAsyncIterableIterator(readableStream.getReader())) {
+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.
+);
 ```
 
+## `Array.prototype` ports
+
+We ported majority of functions from `Array.prototype.*` to `iterable*`.
+
+```ts
+import { iterableIncludes, iterableReduce } from 'iter-fest'; // Via default exports.
+import { iterableSome } from 'iter-fest/iterableSome'; // Via named exports.
+
+const iterable: Iterable<number> = [1, 2, 3, 4, 5].values();
+
+console.log(iterableIncludes(iterable, 3)); // Prints "true".
+console.log(iterableReduce(iterable, (sum, value) => sum + value, 0)); // Prints "15".
+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).
+
 ## Behaviors
 
 ### How this compares to the TC39 proposals?
@@ -185,18 +281,21 @@ Generator has more functionalities than iterator and array. It is not recommende
 - Generator can define the return value
   - `return { done: true, value: 'the very last value' }`
   - Iterating generator using for-loop will not get any values from `{ done: true }`
+  - The `generatorWithLastValue()` will help capturing and retrieving the last return value
 - Generator can receive feedback values from its iterator
   - `generator.next('something')`, the feedback can be assigned to variable via `const feedback = yield;`
   - For-loop cannot send feedbacks to generator
 
 ### When should I use `Iterable`, `IterableIterator` and `Iterator`?
 
-For best compatibility, you should generally follow this API signature: use `Iterable` for inputs, and use `IterableIterator` for outputs. You should avoid exporting pure `Iterator`.
+For best compatibility, you should generally follow this API signature: use `Iterable` for inputs, and use `IterableIterator` for outputs. You should avoid exporting pure `Iterator`. Sample function signature should looks below.
 
 ```ts
-function transform<T>(iterable: Iterable<T>): IterableIterator<T>;
+function myFunction<T>(input: Iterable<T>): IterableIterator<T>;
 ```
 
+`IterableIterator` may opt to support restarting the iteration through `[Symbol.iterator]()`. When consuming an `IterableIterator`, you should call `[Symbol.iterator]()` to obtain a fresh iteration or use for-loop statement if possible. However, `[Symbol.iterator]()` is an opt-in feature and does not always guarantee a fresh iteration.
+
 ### What is on the roadmap?
 
 We are planning to bring iterables and its siblings together, including:

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-2HLJODU3.mjs → chunk-EUVK4YM7.mjs}

@@ -1,5 +1,5 @@
-// src/readerToAsyncIterableIterator.ts
-function readerToAsyncIterableIterator(reader) {
+// src/readerValues.ts
+function readerValues(reader) {
   const iterable = {
     [Symbol.asyncIterator]() {
       return iterable;
@@ -10,12 +10,16 @@ function readerToAsyncIterableIterator(reader) {
         return { done: true, value: void 0 };
       }
       return { value: result.value };
+    },
+    async return() {
+      reader.cancel();
+      return { done: true, value: void 0 };
     }
   };
   return iterable;
 }
 
 export {
-  readerToAsyncIterableIterator
+  readerValues
 };
-//# sourceMappingURL=chunk-2HLJODU3.mjs.map
+//# 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-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-K5XV4W7G.mjs → chunk-O5SQJUKB.mjs}

@@ -1,6 +1,8 @@
-import {
-  withResolvers
-} from "./chunk-U6G4RNZ2.mjs";
+// 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");
@@ -32,4 +34,4 @@ var PushAsyncIterableIterator = class {
 export {
   PushAsyncIterableIterator
 };
-//# sourceMappingURL=chunk-K5XV4W7G.mjs.map
+//# 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