iter-fest 0.1.1-main.0a3d131 → 0.1.1-main.149c8ad

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>`](#converting-a-readablestreamdefaultreader-to-asynciterableiterator) |
+| `AsyncIterable`               | `Observable`            | [`observableFromAsync<T>(iterable: AsyncIterable<T>): Observable<T>`](#converting-an-asynciterable-to-observable)                                          |
+| `AsyncIterable`/`Iterable`    | `ReadableStream`        | [`readableStreamFrom<T>(anyIterable: 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,10 +40,10 @@ const iterate = (): Iterator<number> => {
   return {
     next: () => {
       if (++value <= 3) {
-        return { done: false, value };
+        return { value };
       }
 
-      return { done: true, value: undefined };
+      return { done: true, value: undefined } satisfies IteratorResult<number>;
     }
   };
 };
@@ -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,14 +92,81 @@ 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.
+
+Note: It is not recommended to convert `AsyncGenerator` to an `Observable`. `AsyncGenerator` has more functionalities and `Observable` does not support many of them.
+
+### 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.
+```
+
+### Converting a `ReadableStreamDefaultReader` to `AsyncIterableIterator`
+
+`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`
+
+> Notes: this feature is part of [Streams Standard](https://developer.mozilla.org/en-US/docs/Web/API/ReadableStream/from_static).
+
+```ts
+const iterable = [1, 2, 3].values();
+const readable = readableStreamFrom(iterable);
+
+readable.pipeTo(stream.writable); // Will write 1, 2, 3.
+```
+
+Note: `readableStreamFrom()` 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.
+`IterableWritableStream` is a push-based producer-consumer queue designed to decouple the flow between a producer and multiple consumers. 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.
+`IterableWritableStream` supports multiple consumers and continuation:
+
+- Multiple consumers: when 2 or more consumers are active at the same time, jobs will be distributed across all consumers in a round robin fashion when possible
+- Continuation: when the last consumer disconnected while producer keep pushing new jobs, the next consumer will pick up where the last consumer left
+
+Compare to pull-based queue, a push-based queue is 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.
 
 ```ts
-const iterable = new PushAsyncIterableIterator();
+const iterable = new IterableWritableStream();
+const writer = iterable.getWriter();
 
 (async function consumer() {
   for await (const value of iterable) {
@@ -112,15 +177,89 @@ const iterable = new PushAsyncIterableIterator();
 })();
 
 (async function producer() {
-  iterable.push(1);
-  iterable.push(2);
-  iterable.push(3);
-  iterable.close();
+  writer.write(1);
+  writer.write(2);
+  writer.write(3);
+  writer.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; // { done: false, value: 1 }
+    yield 2; // { done: false, value: 2 }
+    yield 3; // { done: false, value: 3 }
+
+    return 'end'; // { done: true, value: '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.
+);
+```
+
+## Adding types to `core-js-pure`
+
+We added types to implementation from `core-js-pure`:
+
+- [`Iterator.drop`](https://tc39.es/ecma262/#sec-array.prototype.drop)
+- [`Iterator.every`](https://tc39.es/ecma262/#sec-array.prototype.every)
+- [`Iterator.filter`](https://tc39.es/ecma262/#sec-array.prototype.filter)
+- [`Iterator.find`](https://tc39.es/ecma262/#sec-array.prototype.find)
+- [`Iterator.flatMap`](https://tc39.es/ecma262/#sec-array.prototype.flatmap)
+- [`Iterator.forEach`](https://tc39.es/ecma262/#sec-array.prototype.foreach)
+- [`Iterator.from`](https://tc39.es/ecma262/#sec-array.prototype.from)
+- [`Iterator.map`](https://tc39.es/ecma262/#sec-array.prototype.map)
+- [`Iterator.reduce`](https://tc39.es/ecma262/#sec-array.prototype.reduce)
+- [`Iterator.some`](https://tc39.es/ecma262/#sec-array.prototype.some)
+- [`Iterator.take`](https://tc39.es/ecma262/#sec-array.prototype.take)
+- [`Iterator.toArray`](https://tc39.es/ecma262/#sec-array.prototype.toarray)
+
+## `Array.prototype` ports
+
+> Note: we are working to move them from `iterable*` to `iterator*` to make them similar to TC39 proposals.
+
+We ported majority of functions from `Array.prototype.*` to `iterable*`.
+
+```ts
+import { iteratorIncludes, iteratorReduce } from 'iter-fest'; // Via default exports.
+import { iteratorSome } from 'iter-fest/iteratorSome'; // Via named exports.
+
+const iterator: iterator<number> = [1, 2, 3, 4, 5].values();
+
+console.log(iteratorIncludes(iterator, 3)); // Prints "true".
+console.log(iteratorReduce(iterator, (sum, value) => sum + value, 0)); // Prints "15".
+console.log(iteratorSome(iterator, 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), [`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), [`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), [`slice`](https://tc39.es/ecma262/#sec-array.prototype.slice), [`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?
@@ -169,18 +308,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-3S6LCGE6.mjs

@@ -0,0 +1,10 @@
+// src/iteratorSome.ts
+import some from "core-js-pure/full/iterator/some";
+function iteratorSome(iterator, predicate) {
+  return some(iterator, predicate);
+}
+
+export {
+  iteratorSome
+};
+//# sourceMappingURL=chunk-3S6LCGE6.mjs.map

package/dist/chunk-3S6LCGE6.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/iteratorSome.ts"],"sourcesContent":["// @ts-expect-error core-js-pure is not typed.\nimport some from 'core-js-pure/full/iterator/some';\n\n/**\n * Determines whether the specified callback function returns true for any element of an iterable.\n *\n * @param predicate A function that accepts up to three arguments. The some method calls the predicate function for each element in the iterable until the predicate returns a value which is coercible to the Boolean value true, or until the end of the iterable.\n *\n * @link https://github.com/tc39/proposal-iterator-helpers/blob/main/README.md\n */\nexport function iteratorSome<T>(iterator: Iterator<T>, predicate: (value: T, index: number) => unknown): boolean {\n  return some(iterator, predicate);\n}\n"],"mappings":";AACA,OAAO,UAAU;AASV,SAAS,aAAgB,UAAuB,WAA0D;AAC/G,SAAO,KAAK,UAAU,SAAS;AACjC;","names":[]}

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-BWMXKULC.mjs

@@ -0,0 +1,46 @@
+// src/private/withResolvers.ts
+import coreJSPromiseWithResolvers from "core-js-pure/full/promise/with-resolvers";
+function withResolvers() {
+  return coreJSPromiseWithResolvers();
+}
+
+// src/iterableWritableStream.ts
+var CLOSE = Symbol();
+var IterableWritableStream = class extends WritableStream {
+  constructor() {
+    super({
+      close: () => {
+        this.#buffer.push(CLOSE);
+        this.#writeResolvers.resolve();
+      },
+      write: (chunk) => {
+        this.#buffer.push(chunk);
+        this.#writeResolvers.resolve();
+        this.#writeResolvers = withResolvers();
+      }
+    });
+  }
+  #buffer = [];
+  #writeResolvers = withResolvers();
+  [Symbol.asyncIterator]() {
+    return {
+      next: async () => {
+        while (!this.#buffer.length) {
+          await this.#writeResolvers.promise;
+        }
+        const value = this.#buffer[0];
+        if (value === CLOSE) {
+          return { done: true, value: void 0 };
+        }
+        this.#buffer.shift();
+        await void 0;
+        return { done: false, value };
+      }
+    };
+  }
+};
+
+export {
+  IterableWritableStream
+};
+//# sourceMappingURL=chunk-BWMXKULC.mjs.map

package/dist/chunk-BWMXKULC.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/private/withResolvers.ts","../src/iterableWritableStream.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();\n\nexport class IterableWritableStream<T> extends WritableStream<T> {\n  constructor() {\n    super({\n      close: () => {\n        this.#buffer.push(CLOSE);\n        this.#writeResolvers.resolve();\n      },\n      write: (chunk: T) => {\n        this.#buffer.push(chunk);\n        this.#writeResolvers.resolve();\n        this.#writeResolvers = withResolvers();\n      }\n    });\n  }\n\n  #buffer: (T | typeof CLOSE)[] = [];\n  #writeResolvers: PromiseWithResolvers<void> = withResolvers();\n\n  [Symbol.asyncIterator](): AsyncIterator<T> {\n    return {\n      next: async () => {\n        while (!this.#buffer.length) {\n          await this.#writeResolvers.promise;\n        }\n\n        const value = this.#buffer[0] as T | typeof CLOSE;\n\n        if (value === CLOSE) {\n          return { done: true, value: undefined };\n        }\n\n        // If it is not CLOSE, remove it from the queue.\n        this.#buffer.shift();\n\n        // Idle here so concurrent iteration has a chance to pick up the next value in a round robin fashion.\n        await undefined;\n\n        return { done: false, value };\n      }\n    };\n  }\n}\n"],"mappings":";AACA,OAAO,gCAAgC;AAExB,SAAR,gBAA6D;AAClE,SAAO,2BAA2B;AACpC;;;ACHA,IAAM,QAAQ,OAAO;AAEd,IAAM,yBAAN,cAAwC,eAAkB;AAAA,EAC/D,cAAc;AACZ,UAAM;AAAA,MACJ,OAAO,MAAM;AACX,aAAK,QAAQ,KAAK,KAAK;AACvB,aAAK,gBAAgB,QAAQ;AAAA,MAC/B;AAAA,MACA,OAAO,CAAC,UAAa;AACnB,aAAK,QAAQ,KAAK,KAAK;AACvB,aAAK,gBAAgB,QAAQ;AAC7B,aAAK,kBAAkB,cAAc;AAAA,MACvC;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,UAAgC,CAAC;AAAA,EACjC,kBAA8C,cAAc;AAAA,EAE5D,CAAC,OAAO,aAAa,IAAsB;AACzC,WAAO;AAAA,MACL,MAAM,YAAY;AAChB,eAAO,CAAC,KAAK,QAAQ,QAAQ;AAC3B,gBAAM,KAAK,gBAAgB;AAAA,QAC7B;AAEA,cAAM,QAAQ,KAAK,QAAQ,CAAC;AAE5B,YAAI,UAAU,OAAO;AACnB,iBAAO,EAAE,MAAM,MAAM,OAAO,OAAU;AAAA,QACxC;AAGA,aAAK,QAAQ,MAAM;AAGnB,cAAM;AAEN,eAAO,EAAE,MAAM,OAAO,MAAM;AAAA,MAC9B;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

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-FBST4AUL.mjs

@@ -0,0 +1,10 @@
+// src/iteratorFind.ts
+import find from "core-js-pure/full/iterator/find";
+function iteratorFind(iterator, predicate) {
+  return find(iterator, predicate);
+}
+
+export {
+  iteratorFind
+};
+//# sourceMappingURL=chunk-FBST4AUL.mjs.map

package/dist/chunk-FBST4AUL.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/iteratorFind.ts"],"sourcesContent":["// @ts-expect-error core-js-pure is not typed.\nimport find from 'core-js-pure/full/iterator/find';\n\n/**\n * Returns the value of the first element in the iterator where predicate is true, and undefined\n * otherwise.\n *\n * @param predicate find calls predicate once for each element of the iterator, in ascending\n * order, until it finds one where predicate returns true. If such an element is found, find\n * immediately returns that element value. Otherwise, find returns undefined.\n *\n * @link https://github.com/tc39/proposal-iterator-helpers/blob/main/README.md\n */\nexport function iteratorFind<T, S extends T>(\n  iterator: Iterator<T>,\n  predicate: (value: T, index: number) => value is S\n): S | undefined;\n\nexport function iteratorFind<T>(iterator: Iterator<T>, predicate: (value: T, index: number) => unknown): T | undefined;\n\nexport function iteratorFind<T, S extends T>(\n  iterator: Iterator<T>,\n  predicate: (value: T, index: number) => unknown\n): S | undefined {\n  return find(iterator, predicate);\n}\n"],"mappings":";AACA,OAAO,UAAU;AAmBV,SAAS,aACd,UACA,WACe;AACf,SAAO,KAAK,UAAU,SAAS;AACjC;","names":[]}

package/dist/chunk-FMIHIL6A.mjs

@@ -0,0 +1,10 @@
+// src/iteratorForEach.ts
+import forEach from "core-js-pure/full/iterator/for-each";
+function iteratorForEach(iterator, callbackfn) {
+  forEach(iterator, callbackfn);
+}
+
+export {
+  iteratorForEach
+};
+//# sourceMappingURL=chunk-FMIHIL6A.mjs.map

package/dist/chunk-FMIHIL6A.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/iteratorForEach.ts"],"sourcesContent":["// @ts-expect-error core-js-pure is not typed.\nimport forEach from 'core-js-pure/full/iterator/for-each';\n\n/**\n * Performs the specified action for each element in an iterator.\n *\n * @param callbackfn A function that accepts up to three arguments. forEach calls the callbackfn function one time for each element in the iterator.\n *\n * @link https://github.com/tc39/proposal-iterator-helpers/blob/main/README.md\n */\nexport function iteratorForEach<T>(iterator: Iterator<T>, callbackfn: (value: T, index: number) => void): void {\n  forEach(iterator, callbackfn);\n}\n"],"mappings":";AACA,OAAO,aAAa;AASb,SAAS,gBAAmB,UAAuB,YAAqD;AAC7G,UAAQ,UAAU,UAAU;AAC9B;","names":[]}

package/dist/chunk-KYMTQJIJ.mjs

@@ -0,0 +1,10 @@
+// src/iteratorFrom.ts
+import from from "core-js-pure/full/iterator/from";
+function iteratorFrom(iteratorLike) {
+  return from(iteratorLike);
+}
+
+export {
+  iteratorFrom
+};
+//# sourceMappingURL=chunk-KYMTQJIJ.mjs.map

package/dist/chunk-KYMTQJIJ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/iteratorFrom.ts"],"sourcesContent":["// @ts-expect-error core-js-pure is not typed.\nimport from from 'core-js-pure/full/iterator/from';\n\n/**\n * `.from` is a static method (unlike the others listed above) which takes an object as an argument. This method allows wrapping \"iterator-like\" objects with an iterator.\n *\n * @param limit\n *\n * @return Returns the object if it is already an iterator, returns a wrapping iterator if the passed object implements a callable @@iterator property.\n *\n * @link https://github.com/tc39/proposal-iterator-helpers/blob/main/README.md\n */\nexport function iteratorFrom<T>(iteratorLike: Iterator<T>): Iterator<T> {\n  return from(iteratorLike);\n}\n"],"mappings":";AACA,OAAO,UAAU;AAWV,SAAS,aAAgB,cAAwC;AACtE,SAAO,KAAK,YAAY;AAC1B;","names":[]}

package/dist/chunk-LIMQXDFK.mjs

@@ -0,0 +1,10 @@
+// src/iteratorReduce.ts
+import reduce from "core-js-pure/full/iterator/reduce";
+function iteratorReduce(iterator, callbackfn, initialValue) {
+  return reduce(iterator, callbackfn, initialValue);
+}
+
+export {
+  iteratorReduce
+};
+//# sourceMappingURL=chunk-LIMQXDFK.mjs.map

package/dist/chunk-LIMQXDFK.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/iteratorReduce.ts"],"sourcesContent":["// @ts-expect-error core-js-pure is not typed.\nimport reduce from 'core-js-pure/full/iterator/reduce';\n\n/**\n * Calls the specified callback function for all the elements in an iterator. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function.\n *\n * @param callbackfn A function that accepts up to four arguments. The reduce method calls the callbackfn function one time for each element in the iterator.\n *\n * @param initialValue If initialValue is specified, it is used as the initial value to start the accumulation. The first call to the callbackfn function provides this value as an argument instead of an iterator value.\n *\n * @link https://github.com/tc39/proposal-iterator-helpers/blob/main/README.md\n */\nexport function iteratorReduce<T>(\n  iterator: Iterator<T>,\n  callbackfn: (previousValue: T, currentValue: T, currentIndex: number) => T\n): T;\n\nexport function iteratorReduce<T>(\n  iterator: Iterator<T>,\n  callbackfn: (previousValue: T, currentValue: T, currentIndex: number) => T,\n  initialValue: T\n): T;\n\n/**\n * Calls the specified callback function for all the elements in an iterator. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function.\n *\n * @param callbackfn A function that accepts up to four arguments. The reduce method calls the callbackfn function one time for each element in the iterator.\n *\n * @param initialValue If initialValue is specified, it is used as the initial value to start the accumulation. The first call to the callbackfn function provides this value as an argument instead of an array value.\n *\n * @link https://github.com/tc39/proposal-iterator-helpers/blob/main/README.md\n */\nexport function iteratorReduce<T, U>(\n  iterator: Iterator<T>,\n  callbackfn: (previousValue: U, currentValue: T, currentIndex: number) => U,\n  initialValue: U\n): U;\n\nexport function iteratorReduce<T, U = undefined>(\n  iterator: Iterator<T>,\n  callbackfn: (previousValue: U | undefined, currentValue: T, currentIndex: number) => U,\n  initialValue?: U\n): U | undefined {\n  return reduce(iterator, callbackfn, initialValue);\n}\n"],"mappings":";AACA,OAAO,YAAY;AAqCZ,SAAS,eACd,UACA,YACA,cACe;AACf,SAAO,OAAO,UAAU,YAAY,YAAY;AAClD;","names":[]}

package/dist/chunk-OWUGLCQB.mjs

@@ -0,0 +1,10 @@
+// src/iteratorEvery.ts
+import every from "core-js-pure/full/iterator/every";
+function iteratorEvery(iterator, predicate) {
+  return every(iterator, predicate);
+}
+
+export {
+  iteratorEvery
+};
+//# sourceMappingURL=chunk-OWUGLCQB.mjs.map

package/dist/chunk-OWUGLCQB.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/iteratorEvery.ts"],"sourcesContent":["// @ts-expect-error core-js-pure is not typed.\nimport every from 'core-js-pure/full/iterator/every';\n\n/**\n * Determines whether all the members of an iterator satisfy the specified test.\n *\n * @param predicate A function that accepts up to three arguments. The every method calls\n * the predicate function for each element in the iterator until the predicate returns a value\n * which is coercible to the Boolean value false, or until the end of the iterator.\n *\n * @link https://github.com/tc39/proposal-iterator-helpers/blob/main/README.md\n */\nexport function iteratorEvery<T, S extends T>(\n  iterator: Iterator<T>,\n  predicate: (value: T, index: number) => value is S\n): iterator is Iterator<S>;\n\n/**\n * Determines whether all the members of an iterator satisfy the specified test.\n *\n * @param predicate A function that accepts up to three arguments. The every method calls\n * the predicate function for each element in the iterator until the predicate returns a value\n * which is coercible to the Boolean value false, or until the end of the iterator.\n *\n * @param thisArg An object to which the this keyword can refer in the predicate function.\n * If thisArg is omitted, undefined is used as the this value.\n *\n * @link https://github.com/tc39/proposal-iterator-helpers/blob/main/README.md\n */\nexport function iteratorEvery<T>(iterator: Iterator<T>, predicate: (value: T, index: number) => unknown): boolean;\n\nexport function iteratorEvery<T>(iterator: Iterator<T>, predicate: (value: T, index: number) => unknown): boolean {\n  return every(iterator, predicate);\n}\n"],"mappings":";AACA,OAAO,WAAW;AA8BX,SAAS,cAAiB,UAAuB,WAA0D;AAChH,SAAO,MAAM,UAAU,SAAS;AAClC;","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/chunk-QX6EMOSQ.mjs

@@ -0,0 +1,10 @@
+// src/iteratorFlatMap.ts
+import flatMap from "core-js-pure/full/iterator/flat-map";
+function iteratorFlatMap(iterable, mapperFn) {
+  return flatMap(iterable, mapperFn);
+}
+
+export {
+  iteratorFlatMap
+};
+//# sourceMappingURL=chunk-QX6EMOSQ.mjs.map