iter-fest 0.2.2-main.fdb3230 → 0.3.1-main.202512220058.031427d

package/README.md

@@ -23,7 +23,6 @@ npm install iter-fest
 | `Iterator`                 | `IterableIterator`      | [`iteratorToIterable`](#converting-an-iterator-to-iterable)                     |
 | `AsyncIterator`            | `AsyncIterableIterator` | [`asyncIteratorToAsyncIterable`](#converting-an-iterator-to-iterable)           |
 | `Observable`               | `ReadableStream`        | [`observableSubscribeAsReadable`](#converting-an-observable-to-readablestream)  |
-| `ReadableStream`           | `AsyncIterableIterator` | [`readableStreamValues`](#converting-a-readablestream-to-asynciterableiterator) |
 | `AsyncIterable`            | `Observable`            | [`observableFromAsync`](#converting-an-asynciterable-to-observable)             |
 | `AsyncIterable`/`Iterable` | `ReadableStream`        | [`readableStreamFrom`](#converting-an-asynciterableiterable-to-readablestream)  |
 | `Observable`               | `AsyncIterableIterator` | [`observableValues`](#converting-an-observable-to-asynciterableiterator)        |
@@ -31,9 +30,9 @@ npm install iter-fest
 ### Converting an iterator to iterable
 
 ```ts
-function iteratorToIterable<T>(iterator: Iterator<T>): IterableIterator<T>
+function iteratorToIterable<T>(iterator: Iterator<T>): IterableIterator<T>;
 
-function asyncIteratorToAsyncIterable<T>(asyncIterator: AsyncIterator<T>): AsyncIterableIterator<T>
+function asyncIteratorToAsyncIterable<T>(asyncIterator: AsyncIterator<T>): AsyncIterableIterator<T>;
 ```
 
 `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.
@@ -63,7 +62,7 @@ Note: calling `[Symbol.iterator]()` or `[Symbol.asyncIterator]()` will not resta
 ### Converting an `AsyncIterable` to `Observable`
 
 ```ts
-function observableFromAsync<T>(iterable: AsyncIterable<T>): Observable<T>
+function observableFromAsync<T>(iterable: AsyncIterable<T>): Observable<T>;
 ```
 
 `Observable.from` converts `Iterable` into `Observable`. However, it does not convert `AsyncIterable`.
@@ -90,7 +89,7 @@ Note: It is not recommended to convert `AsyncGenerator` to an `Observable`. `Asy
 ### Converting an `Observable` to `ReadableStream`
 
 ```ts
-function observableSubscribeAsReadable<T>(observable: Observable<T>): ReadableStream<T>
+function observableSubscribeAsReadable<T>(observable: Observable<T>): ReadableStream<T>;
 ```
 
 `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.
@@ -106,39 +105,18 @@ readable.pipeTo(stream.writable); // Will write 1, 2, 3.
 
 ### Converting a `ReadableStream` to `AsyncIterableIterator`
 
-```ts
-function readableStreamValues`<T>(readable: ReadableStream<T>): AsyncIterableIterator<T>
-```
-
-`readableStreamValues` allow iteration of `ReadableStream` as an `AsyncIterableIterator`.
+> This is deprecated and removed in favor of [native `ReadableStream.values()`](https://streams.spec.whatwg.org/#rs-asynciterator).
 
 ```ts
-const readable = new ReadableStream({
-  start(controller) {
-    controller.enqueue(1);
-    controller.enqueue(2);
-  },
-  pull(controller) {
-    controller.enqueue(3);
-    controller.close();
-  }
-});
-
-const iterable = readableStreamValues(readable);
-
-for await (const value of iterable) {
-  console.log(value); // Prints "1", "2", "3".
-}
+function readableStreamValues`<T>(
+  readable: ReadableStream<T>
+): AsyncIterableIterator<T>
 ```
 
-Note: The stream will be locked as soon as the iterable is created. When using iterating outside of for-loop, make sure to call `AsyncIterator.return` when the iteration is done to release the lock on the stream.
-
-Note: `[Symbol.asyncIterator]()` will not restart the stream.
-
 ### Converting an `AsyncIterable`/`Iterable` to `ReadableStream`
 
 ```ts
-function readableStreamFrom<T>(anyIterable: AsyncIterable<T> | Iterable<T>): ReadableStream<T>
+function readableStreamFrom<T>(anyIterable: AsyncIterable<T> | Iterable<T>): ReadableStream<T>;
 ```
 
 > Notes: this feature is part of [Streams Standard](https://developer.mozilla.org/en-US/docs/Web/API/ReadableStream/from_static).
@@ -155,7 +133,7 @@ Note: `readableStreamFrom()` will call `[Symbol.iterator]()` initially to restar
 ### Converting an `Observable` to `AsyncIterableIterator`
 
 ```ts
-function observableValues<T>(observable: Observable<T>): AsyncIterableIterator<T>
+function observableValues<T>(observable: Observable<T>): AsyncIterableIterator<T>;
 ```
 
 `Observable` can be converted to `AsyncIterableIterator` for easier consumption.
@@ -250,6 +228,43 @@ const generator = generatorWithLastValue(
 );
 ```
 
+### Iterating `ReadableStream` with `AbortSignal`
+
+> This is an unofficial extension to the [native `ReadableStream.values()`](https://streams.spec.whatwg.org/#rs-asynciterator).
+
+```ts
+function readableStreamValuesWithSignal`<T>(
+  readable: ReadableStream<T>,
+  options?: {
+    preventCancel?: boolean | undefined;
+    signal?: AbortSignal | undefined;
+  } | undefined
+): AsyncIterableIterator<T>
+```
+
+To break early without awaiting for the next value, pass an `AbortSignal` to `options.signal`. When the signal is aborted, all pending and future calls to `next()` and `return()` will reject with `DOMException` with name of `AbortError`.
+
+> Notes: native `ReadableStreamAsyncIterator` does not support `throw()`.
+
+```ts
+const abortController = new AbortController();
+const iterable = readableStreamValues(readable, { signal: abortController.signal });
+
+setTimeout(() => {
+  abortController.abort();
+}, 100);
+
+try {
+  for await (const value of iterable) {
+    console.log(value);
+  }
+} catch (error) {
+  // On abort, will throw DOMException with name of "AbortError"
+}
+```
+
+If `preventCancel` is `true`, the `ReadableStream` can be reopened and read by another reader.
+
 ## Adding types to `core-js-pure`
 
 We added types to [Iterator Helpers](https://github.com/tc39/proposal-iterator-helpers) and [Async Iterator Helpers](https://github.com/tc39/proposal-async-iterator-helpers) implementation from `core-js-pure`:

package/dist/chunk-6ZEIOTH6.mjs

@@ -0,0 +1,9 @@
+// src/readableStreamValues.ts
+function readableStreamValues(readable, options) {
+  return readable.values(options);
+}
+
+export {
+  readableStreamValues
+};
+//# sourceMappingURL=chunk-6ZEIOTH6.mjs.map

package/dist/chunk-6ZEIOTH6.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/readableStreamValues.ts"],"sourcesContent":["/**\n * This is deprecated. You should use `ReadableStream.values` instead.\n *\n * @deprecated\n */\nexport function readableStreamValues<T>(\n  readable: ReadableStream<T>,\n  options?: ReadableStreamIteratorOptions | undefined\n): AsyncIterableIterator<T> {\n  return readable.values(options);\n}\n"],"mappings":";AAKO,SAAS,qBACd,UACA,SAC0B;AAC1B,SAAO,SAAS,OAAO,OAAO;AAChC;","names":[]}

package/dist/{chunk-2DE3J4J7.mjs → chunk-AMBNMMKA.mjs}

@@ -3,6 +3,7 @@ var STILL_ITERATING = Symbol();
 function generatorWithLastValue(generator) {
   let lastValue = STILL_ITERATING;
   const generatorWithLastValue2 = {
+    ...generator,
     [Symbol.iterator]() {
       return generatorWithLastValue2;
     },
@@ -32,4 +33,4 @@ function generatorWithLastValue(generator) {
 export {
   generatorWithLastValue
 };
-//# sourceMappingURL=chunk-2DE3J4J7.mjs.map
+//# sourceMappingURL=chunk-AMBNMMKA.mjs.map

package/dist/chunk-AMBNMMKA.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    ...generator,\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,GAAG;AAAA,IACH,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 → chunk-P6MH6RRG.mjs}

@@ -3,6 +3,7 @@ var STILL_ITERATING = Symbol();
 function asyncGeneratorWithLastValue(generator) {
   let lastValue = STILL_ITERATING;
   const asyncGeneratorWithLastValue2 = {
+    ...generator,
     [Symbol.asyncIterator]() {
       return asyncGeneratorWithLastValue2;
     },
@@ -32,4 +33,4 @@ function asyncGeneratorWithLastValue(generator) {
 export {
   asyncGeneratorWithLastValue
 };
-//# sourceMappingURL=chunk-ANRVAYLW.mjs.map
+//# sourceMappingURL=chunk-P6MH6RRG.mjs.map

package/dist/chunk-P6MH6RRG.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    ...generator,\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,GAAG;AAAA,IACH,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-VF6V265K.mjs

@@ -0,0 +1,190 @@
+// src/private/CriticalSection.ts
+var CriticalSection = class {
+  #callbacks = [];
+  enter(fn) {
+    const fnResolver = Promise.withResolvers();
+    const callback = async () => {
+      try {
+        fnResolver.resolve(await fn());
+      } catch (error) {
+        fnResolver.reject(error);
+      }
+      if (this.#callbacks.shift() !== callback) {
+        throw new Error("ASSERTION: The first resolver must be self.");
+      }
+      this.#callbacks[0]?.();
+    };
+    this.#callbacks.push(callback);
+    this.#callbacks[0] === callback && callback();
+    return fnResolver.promise;
+  }
+};
+
+// src/private/AsyncIteratorMachinery.ts
+var AsyncIteratorMachinery = class {
+  constructor(iterator) {
+    this.#criticalSection = new CriticalSection();
+    this.#done = false;
+    const enter = this.#criticalSection.enter.bind(this.#criticalSection);
+    const return_ = iterator.return && iterator.return.bind(iterator);
+    const throw_ = iterator.throw && iterator.throw.bind(iterator);
+    this.next = (...[value]) => enter(async () => {
+      if (this.#done) {
+        return Promise.resolve({ done: true, value: void 0 });
+      }
+      const result = await iterator.next(...value ? [value] : []);
+      if (result.done) {
+        this.#done = true;
+      }
+      return result;
+    });
+    if (return_) {
+      this.return = (value) => enter(async () => {
+        if (this.#done) {
+          return {
+            done: true,
+            value: typeof value === "undefined" ? value : await value
+          };
+        }
+        this.#done = true;
+        return return_(value);
+      });
+    }
+    if (throw_) {
+      this.throw = (reason) => enter(() => {
+        if (this.#done) {
+          return Promise.reject(reason);
+        }
+        this.#done = true;
+        return throw_(reason);
+      });
+    }
+  }
+  #criticalSection;
+  #done;
+  async [Symbol.asyncDispose]() {
+  }
+  [Symbol.asyncIterator]() {
+    return this;
+  }
+  next;
+  return;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  throw;
+};
+
+// src/private/createAbortError.ts
+var ERROR_MESSAGE = "The operation is aborted";
+var ERROR_NAME = "AbortError";
+function createAbortError() {
+  if (typeof globalThis.DOMException === "undefined") {
+    const error = new Error(ERROR_MESSAGE);
+    error.name = ERROR_NAME;
+    return error;
+  } else {
+    return new DOMException(ERROR_MESSAGE, ERROR_NAME);
+  }
+}
+
+// src/readableStreamValuesWithSignal.ts
+var ReadableStreamIterator = class {
+  // The asynchronous iterator initialization steps for a ReadableStream, given stream, iterator, and args, are:
+  constructor(stream, args) {
+    const reader = stream.getReader();
+    this.#reader = reader;
+    const preventCancel = !!args[0].preventCancel;
+    this.#preventCancel = preventCancel;
+    this.#signal = args[0].signal;
+    this.#signal?.addEventListener(
+      "abort",
+      async () => {
+        this.#preventCancel || reader.cancel(createAbortError());
+        reader.releaseLock();
+      },
+      { once: true }
+    );
+  }
+  #preventCancel;
+  #reader;
+  #readRequests = [];
+  #signal;
+  [Symbol.asyncIterator]() {
+    return this;
+  }
+  async [Symbol.asyncDispose]() {
+  }
+  // The get the next iteration result steps for a ReadableStream, given stream and iterator, are:
+  // next(...[value]: [] | [any]): Promise<IteratorResult<T, any>> {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  next = () => {
+    if (this.#signal?.aborted) {
+      return Promise.reject(createAbortError());
+    }
+    const nextResolvers = Promise.withResolvers();
+    const reader = this.#reader;
+    const resolvers = Promise.withResolvers();
+    const request = {
+      // chunk steps, given chunk
+      chunk(value) {
+        resolvers.resolve({ done: false, value });
+      },
+      // close steps
+      close() {
+        reader.releaseLock();
+        resolvers.resolve({ done: true, value: void 0 });
+      },
+      // error steps, given e
+      error(reason) {
+        reader.releaseLock();
+        resolvers.reject(reason);
+      }
+    };
+    this.#readRequests.push(request);
+    (async () => {
+      try {
+        const result = await reader.read();
+        if (result.done) {
+          if (this.#signal?.aborted) {
+            request.error(createAbortError());
+          }
+          request.close();
+        } else {
+          request.chunk(result.value);
+        }
+      } catch (error) {
+        if (this.#signal?.aborted) {
+          request.error(createAbortError());
+        } else {
+          request.error(error);
+        }
+      } finally {
+        nextResolvers.resolve();
+      }
+    })();
+    return resolvers.promise;
+  };
+  // The asynchronous iterator return steps for a ReadableStream, given stream, iterator, and arg, are:
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  async return(value) {
+    if (this.#signal?.aborted) {
+      return Promise.reject(createAbortError());
+    }
+    const reader = this.#reader;
+    if (!this.#preventCancel) {
+      const cancelPromise = reader.cancel(value);
+      reader.releaseLock();
+      await cancelPromise;
+      return { done: true, value };
+    }
+    reader.releaseLock();
+    return { done: true, value };
+  }
+};
+function readableStreamValuesWithSignal(stream, options) {
+  return new AsyncIteratorMachinery(new ReadableStreamIterator(stream, [options || {}]));
+}
+
+export {
+  readableStreamValuesWithSignal
+};
+//# sourceMappingURL=chunk-VF6V265K.mjs.map

package/dist/chunk-VF6V265K.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/private/CriticalSection.ts","../src/private/AsyncIteratorMachinery.ts","../src/private/createAbortError.ts","../src/readableStreamValuesWithSignal.ts"],"sourcesContent":["export default class CriticalSection {\n  #callbacks: (() => void)[] = [];\n\n  enter<T>(fn: () => Promise<T>): Promise<T> {\n    const fnResolver = Promise.withResolvers<T>();\n\n    // const callback = () =>\n    //   fn()\n    //     .then(\n    //       value => fnResolver.resolve(value),\n    //       reason => fnResolver.reject(reason)\n    //     )\n    //     .then(() => {\n    //       /* istanbul ignore if */\n    //       if (this.#callbacks.shift() !== callback) {\n    //         throw new Error('ASSERTION: The first resolver must be self.');\n    //       }\n\n    //       this.#callbacks[0]?.();\n    //     });\n\n    const callback = async () => {\n      try {\n        fnResolver.resolve(await fn());\n      } catch (error) {\n        fnResolver.reject(error);\n      }\n\n      /* istanbul ignore if */\n      if (this.#callbacks.shift() !== callback) {\n        throw new Error('ASSERTION: The first resolver must be self.');\n      }\n\n      this.#callbacks[0]?.();\n    };\n\n    this.#callbacks.push(callback);\n\n    this.#callbacks[0] === callback && callback();\n\n    return fnResolver.promise;\n  }\n}\n","import CriticalSection from './CriticalSection.ts';\n\n/**\n * This machinery protect the logic of iterator/generator. It guarantees:\n *\n * - next(), return(), throw() are in the same critical section\n *    - They will be processed sequentially\n * - When the iterator is done\n *    - next() will always return { done: true, value: undefined }\n *    - return(value) will always return { done: true, value }, without calling underlying return()\n *    - throw(reason) will always throw reason, without calling underlying throw()\n */\nexport default class AsyncIteratorMachinery<T, TReturn, TNext> implements AsyncIteratorObject<T, TReturn, TNext> {\n  constructor(iterator: AsyncIterator<T, TReturn, TNext>) {\n    this.#criticalSection = new CriticalSection();\n    this.#done = false;\n\n    const enter = this.#criticalSection.enter.bind(this.#criticalSection);\n\n    const return_ = iterator.return && iterator.return.bind(iterator);\n    const throw_ = iterator.throw && iterator.throw.bind(iterator);\n\n    this.next = (...[value]) =>\n      enter(async () => {\n        if (this.#done) {\n          // Seems a bug in TypeScript that it doesn't allow undefined as TReturn for AsyncIterator\n          return Promise.resolve({ done: true, value: undefined as TReturn });\n        }\n\n        const result = await iterator.next(...(value ? [value] : []));\n\n        if (result.done) {\n          this.#done = true;\n        }\n\n        return result;\n      });\n\n    if (return_) {\n      this.return = value =>\n        enter(async () => {\n          if (this.#done) {\n            return {\n              done: true,\n              value: typeof value === 'undefined' ? (value as TReturn) : await value\n            };\n          }\n\n          this.#done = true;\n\n          return return_(value);\n        });\n    }\n\n    if (throw_) {\n      this.throw = reason =>\n        enter(() => {\n          if (this.#done) {\n            return Promise.reject(reason);\n          }\n\n          this.#done = true;\n\n          return throw_(reason);\n        });\n    }\n  }\n\n  #criticalSection: CriticalSection;\n  #done: boolean;\n\n  async [Symbol.asyncDispose]() {}\n\n  [Symbol.asyncIterator]() {\n    return this;\n  }\n\n  next: (...[value]: [] | [TNext]) => Promise<IteratorResult<T, TReturn>>;\n  return?: (value?: TReturn | PromiseLike<TReturn> | undefined) => Promise<IteratorResult<T, TReturn>>;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  throw?: (e?: any) => Promise<IteratorResult<T, TReturn>>;\n}\n","const ERROR_MESSAGE = 'The operation is aborted';\nconst ERROR_NAME = 'AbortError';\n\nexport default function createAbortError(): (DOMException & { name: 'AbortError' }) | Error {\n  if (typeof globalThis.DOMException === 'undefined') {\n    const error = new Error(ERROR_MESSAGE);\n\n    error.name = ERROR_NAME;\n\n    return error;\n  } else {\n    return new DOMException(ERROR_MESSAGE, ERROR_NAME);\n  }\n}\n","import AsyncIteratorMachinery from './private/AsyncIteratorMachinery.ts';\nimport createAbortError from './private/createAbortError.ts';\n\ntype ReadableStreamIteratorWithSignalOptions = ReadableStreamIteratorOptions & {\n  signal?: AbortSignal | undefined;\n};\n\ntype ReadableStreamIteratorReadRequest<T> = {\n  chunk(value: T): void;\n  close(): void;\n  error(error: unknown): void;\n};\n\nclass ReadableStreamIterator<T> implements ReadableStreamAsyncIterator<T> {\n  // The asynchronous iterator initialization steps for a ReadableStream, given stream, iterator, and args, are:\n  constructor(\n    stream: ReadableStream<T>,\n    args: [{ preventCancel?: boolean | undefined; signal?: AbortSignal | undefined }]\n  ) {\n    // 1. Let reader be ? AcquireReadableStreamDefaultReader(stream).\n    const reader = stream.getReader();\n\n    // 2. Set iterator’s reader to reader.\n    this.#reader = reader;\n\n    // 3. Let preventCancel be args[0][\"preventCancel\"].\n    const preventCancel = !!args[0].preventCancel;\n\n    // 4. Set iterator’s prevent cancel to preventCancel.\n    this.#preventCancel = preventCancel;\n\n    this.#signal = args[0].signal;\n\n    this.#signal?.addEventListener(\n      'abort',\n      async () => {\n        // Ignore cancel() rejections.\n        this.#preventCancel || reader.cancel(createAbortError());\n\n        reader.releaseLock();\n      },\n      { once: true }\n    );\n  }\n\n  #preventCancel: boolean;\n  #reader: ReadableStreamDefaultReader<T>;\n  #readRequests: ReadableStreamIteratorReadRequest<T>[] = [];\n  #signal: AbortSignal | undefined;\n\n  [Symbol.asyncIterator]() {\n    return this;\n  }\n\n  async [Symbol.asyncDispose]() {}\n\n  // The get the next iteration result steps for a ReadableStream, given stream and iterator, are:\n  // next(...[value]: [] | [any]): Promise<IteratorResult<T, any>> {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  next: () => Promise<IteratorResult<T, any>> = () => {\n    if (this.#signal?.aborted) {\n      return Promise.reject(createAbortError());\n    }\n\n    // Iterator machinery: iterator is busy, don't start return().\n    const nextResolvers = Promise.withResolvers<void>();\n\n    // 1. Let reader be iterator’s reader.\n    const reader = this.#reader;\n\n    // 2. Assert: reader.[[stream]] is not undefined.\n\n    // 3. Let promise be a new promise.\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const resolvers = Promise.withResolvers<IteratorResult<T, any>>();\n\n    // 4. Let readRequest be a new read request with the following items:\n    const request: ReadableStreamIteratorReadRequest<T> = {\n      // chunk steps, given chunk\n      chunk(value) {\n        // Resolve promise with chunk.\n        resolvers.resolve({ done: false, value });\n      },\n      // close steps\n      close() {\n        // Perform ! ReadableStreamDefaultReaderRelease(reader).\n        reader.releaseLock();\n\n        // Resolve promise with end of iteration.\n        resolvers.resolve({ done: true, value: undefined });\n      },\n      // error steps, given e\n      error(reason) {\n        // Perform ! ReadableStreamDefaultReaderRelease(reader).\n        reader.releaseLock();\n\n        // Reject promise with e.\n        resolvers.reject(reason);\n      }\n    };\n\n    this.#readRequests.push(request);\n\n    // 5. Perform ! ReadableStreamDefaultReaderRead(this, readRequest).\n    (async () => {\n      try {\n        const result = await reader.read();\n\n        if (result.done) {\n          if (this.#signal?.aborted) {\n            request.error(createAbortError());\n          }\n\n          request.close();\n        } else {\n          request.chunk(result.value);\n        }\n      } catch (error) {\n        if (this.#signal?.aborted) {\n          request.error(createAbortError());\n        } else {\n          request.error(error);\n        }\n      } finally {\n        nextResolvers.resolve();\n      }\n    })();\n\n    // 6. Return promise.\n    return resolvers.promise;\n  };\n\n  // The asynchronous iterator return steps for a ReadableStream, given stream, iterator, and arg, are:\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async return(value?: any): Promise<IteratorResult<T, any>> {\n    if (this.#signal?.aborted) {\n      return Promise.reject(createAbortError());\n    }\n\n    // 1. Let reader be iterator’s reader.\n    const reader = this.#reader;\n    // 2. Assert: reader.[[stream]] is not undefined.\n    // 3. Assert: reader.[[readRequests]] is empty, as the async iterator machinery guarantees that any previous calls to next() have settled before this is called.\n\n    // 4. If iterator’s prevent cancel is false:\n    if (!this.#preventCancel) {\n      // 1. Let result be ! ReadableStreamReaderGenericCancel(reader, arg).\n      const cancelPromise = reader.cancel(value);\n\n      // --- Seems WHATWG spec bug: if stream errored, we will fail at cancel() and would never able to call releaseLock(). ---\n      // --- Instead, regardless cancel() failed or not, we should release the reader lock. ---\n\n      // 2. Perform ! ReadableStreamDefaultReaderRelease(reader).\n      reader.releaseLock();\n\n      await cancelPromise;\n\n      // 3. Return result.\n      // --- Seems Node.js 22.14.0 implementation is different from W3C spec, see https://github.com/nodejs/node/issues/57681 ---\n      // return { done: true, value: undefined };\n      return { done: true, value };\n    }\n\n    // 5. Perform ! ReadableStreamDefaultReaderRelease(reader).\n    reader.releaseLock();\n\n    // 6. Return a promise resolved with undefined.\n    // --- Seems Node.js 22.14.0 implementation is different from W3C spec, see https://github.com/nodejs/node/issues/57681 ---\n    // return { done: true, value: undefined };\n    return { done: true, value };\n  }\n}\n\n/**\n * This is based on WHATWG Streams Asynchronous Iteration specification.\n *\n * @see https://streams.spec.whatwg.org/#rs-asynciterator\n *\n * @param stream\n * @param options\n * @returns\n */\nexport function readableStreamValuesWithSignal<T>(\n  stream: ReadableStream<T>,\n  options?: ReadableStreamIteratorWithSignalOptions | undefined\n): ReadableStreamAsyncIterator<T> {\n  return new AsyncIteratorMachinery(new ReadableStreamIterator(stream, [options || {}]));\n}\n\nexport { type ReadableStreamIteratorWithSignalOptions };\n"],"mappings":"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","names":[]}

package/dist/chunk-YGRCFTJT.mjs

@@ -0,0 +1,13 @@
+import {
+  observableSubscribeAsReadable
+} from "./chunk-GOJ2PI5W.mjs";
+
+// src/observableValues.ts
+function observableValues(observable) {
+  return observableSubscribeAsReadable(observable).values();
+}
+
+export {
+  observableValues
+};
+//# sourceMappingURL=chunk-YGRCFTJT.mjs.map

package/dist/chunk-YGRCFTJT.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/observableValues.ts"],"sourcesContent":["import { type Observable } from './Observable.ts';\nimport { observableSubscribeAsReadable } from './observableSubscribeAsReadable.ts';\n\nexport function observableValues<T>(observable: Observable<T>): AsyncIterableIterator<T> {\n  return observableSubscribeAsReadable(observable).values();\n}\n"],"mappings":";;;;;AAGO,SAAS,iBAAoB,YAAqD;AACvF,SAAO,8BAA8B,UAAU,EAAE,OAAO;AAC1D;","names":[]}

package/dist/iter-fest.asyncGeneratorWithLastValue.js

@@ -27,6 +27,7 @@ var STILL_ITERATING = Symbol();
 function asyncGeneratorWithLastValue(generator) {
   let lastValue = STILL_ITERATING;
   const asyncGeneratorWithLastValue2 = {
+    ...generator,
     [Symbol.asyncIterator]() {
       return asyncGeneratorWithLastValue2;
     },

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

@@ -1 +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"]}
+{"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    ...generator,\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,GAAG;AAAA,IACH,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

@@ -1,6 +1,6 @@
 import {
   asyncGeneratorWithLastValue
-} from "./chunk-ANRVAYLW.mjs";
+} from "./chunk-P6MH6RRG.mjs";
 export {
   asyncGeneratorWithLastValue
 };

package/dist/iter-fest.d.mts

@@ -48,4 +48,5 @@ export { observableSubscribeAsReadable } from './iter-fest.observableSubscribeAs
 export { observableValues } from './iter-fest.observableValues.mjs';
 export { readableStreamFrom } from './iter-fest.readableStreamFrom.mjs';
 export { readableStreamValues } from './iter-fest.readableStreamValues.mjs';
+export { ReadableStreamIteratorWithSignalOptions, readableStreamValuesWithSignal } from './iter-fest.readableStreamValuesWithSignal.mjs';
 import 'core-js-pure/full/observable/index.js';

package/dist/iter-fest.d.ts

@@ -48,4 +48,5 @@ export { observableSubscribeAsReadable } from './iter-fest.observableSubscribeAs
 export { observableValues } from './iter-fest.observableValues.js';
 export { readableStreamFrom } from './iter-fest.readableStreamFrom.js';
 export { readableStreamValues } from './iter-fest.readableStreamValues.js';
+export { ReadableStreamIteratorWithSignalOptions, readableStreamValuesWithSignal } from './iter-fest.readableStreamValuesWithSignal.js';
 import 'core-js-pure/full/observable/index.js';

package/dist/iter-fest.generatorWithLastValue.js

@@ -27,6 +27,7 @@ var STILL_ITERATING = Symbol();
 function generatorWithLastValue(generator) {
   let lastValue = STILL_ITERATING;
   const generatorWithLastValue2 = {
+    ...generator,
     [Symbol.iterator]() {
       return generatorWithLastValue2;
     },

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

@@ -1 +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;AAAA;AAAA;AAAA;AAAA;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"]}
+{"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    ...generator,\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;AAAA;AAAA;AAAA;AAAA;AAAA,IAAM,kBAAkB,OAAO;AAQxB,SAAS,uBACd,WAC2C;AAC3C,MAAI,YAA8C;AAElD,QAAMA,0BAAyB;AAAA,IAC7B,GAAG;AAAA,IACH,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/iter-fest.generatorWithLastValue.mjs

@@ -1,6 +1,6 @@
 import {
   generatorWithLastValue
-} from "./chunk-2DE3J4J7.mjs";
+} from "./chunk-AMBNMMKA.mjs";
 export {
   generatorWithLastValue
 };