iter-fest 0.2.2-main.5f5a121 → 0.2.2-main.f145669

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -23,7 +23,6 @@ npm install iter-fest
23
23
  | `Iterator` | `IterableIterator` | [`iteratorToIterable`](#converting-an-iterator-to-iterable) |
24
24
  | `AsyncIterator` | `AsyncIterableIterator` | [`asyncIteratorToAsyncIterable`](#converting-an-iterator-to-iterable) |
25
25
  | `Observable` | `ReadableStream` | [`observableSubscribeAsReadable`](#converting-an-observable-to-readablestream) |
26
- | `ReadableStream` | `AsyncIterableIterator` | [`readableStreamValues`](#converting-a-readablestream-to-asynciterableiterator) |
27
26
  | `AsyncIterable` | `Observable` | [`observableFromAsync`](#converting-an-asynciterable-to-observable) |
28
27
  | `AsyncIterable`/`Iterable` | `ReadableStream` | [`readableStreamFrom`](#converting-an-asynciterableiterable-to-readablestream) |
29
28
  | `Observable` | `AsyncIterableIterator` | [`observableValues`](#converting-an-observable-to-asynciterableiterator) |
@@ -31,9 +30,9 @@ npm install iter-fest
31
30
  ### Converting an iterator to iterable
32
31
 
33
32
  ```ts
34
- function iteratorToIterable<T>(iterator: Iterator<T>): IterableIterator<T>
33
+ function iteratorToIterable<T>(iterator: Iterator<T>): IterableIterator<T>;
35
34
 
36
- function asyncIteratorToAsyncIterable<T>(asyncIterator: AsyncIterator<T>): AsyncIterableIterator<T>
35
+ function asyncIteratorToAsyncIterable<T>(asyncIterator: AsyncIterator<T>): AsyncIterableIterator<T>;
37
36
  ```
38
37
 
39
38
  `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
63
62
  ### Converting an `AsyncIterable` to `Observable`
64
63
 
65
64
  ```ts
66
- function observableFromAsync<T>(iterable: AsyncIterable<T>): Observable<T>
65
+ function observableFromAsync<T>(iterable: AsyncIterable<T>): Observable<T>;
67
66
  ```
68
67
 
69
68
  `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
90
89
  ### Converting an `Observable` to `ReadableStream`
91
90
 
92
91
  ```ts
93
- function observableSubscribeAsReadable<T>(observable: Observable<T>): ReadableStream<T>
92
+ function observableSubscribeAsReadable<T>(observable: Observable<T>): ReadableStream<T>;
94
93
  ```
95
94
 
96
95
  `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,68 +105,18 @@ readable.pipeTo(stream.writable); // Will write 1, 2, 3.
106
105
 
107
106
  ### Converting a `ReadableStream` to `AsyncIterableIterator`
108
107
 
108
+ > This is deprecated and removed in favor of [native `ReadableStream.values()`](https://streams.spec.whatwg.org/#rs-asynciterator).
109
+
109
110
  ```ts
110
111
  function readableStreamValues`<T>(
111
- readable: ReadableStream<T>,
112
- init: {
113
- signal?: AbortSignal | undefined;
114
- }
112
+ readable: ReadableStream<T>
115
113
  ): AsyncIterableIterator<T>
116
114
  ```
117
115
 
118
- `readableStreamValues` allow iteration of `ReadableStream` as an `AsyncIterableIterator`.
119
-
120
- ```ts
121
- const readable = new ReadableStream({
122
- start(controller) {
123
- controller.enqueue(1);
124
- controller.enqueue(2);
125
- },
126
- pull(controller) {
127
- controller.enqueue(3);
128
- controller.close();
129
- }
130
- });
131
-
132
- const iterable = readableStreamValues(readable);
133
-
134
- for await (const value of iterable) {
135
- console.log(value); // Prints "1", "2", "3".
136
- }
137
- ```
138
-
139
- 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.
140
-
141
- Note: `[Symbol.asyncIterator]()` will not restart the stream.
142
-
143
- Note: When the iterating for-loop has broken, thrown, or is aborted via `init.signal`, the readable stream will be released and can be read again and continue where it left.
144
-
145
- #### Breaking the loop early
146
-
147
- To break early without awaiting for the next value, pass an `AbortSignal` to `init.signal`. When the signal is aborted, the `await` will be rejected with error message "Aborted" and release the reader gracefully. The reader can be reopened and will continue where it left.
148
-
149
- ```ts
150
- const abortController = new AbortController();
151
- const iterable = readableStreamValues(readable, { signal: abortController.signal });
152
-
153
- setTimeout(() => {
154
- abortController.abort();
155
- }, 100);
156
-
157
- try {
158
- for await (const value of iterable) {
159
- console.log(value);
160
- }
161
- } catch (error) {
162
- // Will throw with error message "Aborted".
163
- }
164
- ```
165
-
166
-
167
116
  ### Converting an `AsyncIterable`/`Iterable` to `ReadableStream`
168
117
 
169
118
  ```ts
170
- function readableStreamFrom<T>(anyIterable: AsyncIterable<T> | Iterable<T>): ReadableStream<T>
119
+ function readableStreamFrom<T>(anyIterable: AsyncIterable<T> | Iterable<T>): ReadableStream<T>;
171
120
  ```
172
121
 
173
122
  > Notes: this feature is part of [Streams Standard](https://developer.mozilla.org/en-US/docs/Web/API/ReadableStream/from_static).
@@ -184,7 +133,7 @@ Note: `readableStreamFrom()` will call `[Symbol.iterator]()` initially to restar
184
133
  ### Converting an `Observable` to `AsyncIterableIterator`
185
134
 
186
135
  ```ts
187
- function observableValues<T>(observable: Observable<T>): AsyncIterableIterator<T>
136
+ function observableValues<T>(observable: Observable<T>): AsyncIterableIterator<T>;
188
137
  ```
189
138
 
190
139
  `Observable` can be converted to `AsyncIterableIterator` for easier consumption.
@@ -279,6 +228,43 @@ const generator = generatorWithLastValue(
279
228
  );
280
229
  ```
281
230
 
231
+ ### Iterating `ReadableStream` with `AbortSignal`
232
+
233
+ > This is an unofficial extension to the [native `ReadableStream.values()`](https://streams.spec.whatwg.org/#rs-asynciterator).
234
+
235
+ ```ts
236
+ function readableStreamValuesWithSignal`<T>(
237
+ readable: ReadableStream<T>,
238
+ options?: {
239
+ preventCancel?: boolean | undefined;
240
+ signal?: AbortSignal | undefined;
241
+ } | undefined
242
+ ): AsyncIterableIterator<T>
243
+ ```
244
+
245
+ 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`.
246
+
247
+ > Notes: native `ReadableStreamAsyncIterator` does not support `throw()`.
248
+
249
+ ```ts
250
+ const abortController = new AbortController();
251
+ const iterable = readableStreamValues(readable, { signal: abortController.signal });
252
+
253
+ setTimeout(() => {
254
+ abortController.abort();
255
+ }, 100);
256
+
257
+ try {
258
+ for await (const value of iterable) {
259
+ console.log(value);
260
+ }
261
+ } catch (error) {
262
+ // On abort, will throw DOMException with name of "AbortError"
263
+ }
264
+ ```
265
+
266
+ If `preventCancel` is `true`, the `ReadableStream` can be reopened and read by another reader.
267
+
282
268
  ## Adding types to `core-js-pure`
283
269
 
284
270
  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`:
@@ -0,0 +1,195 @@
1
+ // src/private/CriticalSection.ts
2
+ var CriticalSection = class {
3
+ #callbacks = [];
4
+ enter(fn) {
5
+ const fnResolver = Promise.withResolvers();
6
+ const callback = async () => {
7
+ var _a, _b;
8
+ try {
9
+ fnResolver.resolve(await fn());
10
+ } catch (error) {
11
+ fnResolver.reject(error);
12
+ }
13
+ if (this.#callbacks.shift() !== callback) {
14
+ throw new Error("ASSERTION: The first resolver must be self.");
15
+ }
16
+ (_b = (_a = this.#callbacks)[0]) == null ? void 0 : _b.call(_a);
17
+ };
18
+ this.#callbacks.push(callback);
19
+ this.#callbacks[0] === callback && callback();
20
+ return fnResolver.promise;
21
+ }
22
+ };
23
+
24
+ // src/private/AsyncIteratorMachinery.ts
25
+ var AsyncIteratorMachinery = class {
26
+ constructor(iterator) {
27
+ this.#criticalSection = new CriticalSection();
28
+ this.#done = false;
29
+ const enter = this.#criticalSection.enter.bind(this.#criticalSection);
30
+ const return_ = iterator.return && iterator.return.bind(iterator);
31
+ const throw_ = iterator.throw && iterator.throw.bind(iterator);
32
+ this.next = (...[value]) => enter(async () => {
33
+ if (this.#done) {
34
+ return Promise.resolve({ done: true, value: void 0 });
35
+ }
36
+ const result = await iterator.next(...value ? [value] : []);
37
+ if (result.done) {
38
+ this.#done = true;
39
+ }
40
+ return result;
41
+ });
42
+ if (return_) {
43
+ this.return = (value) => enter(async () => {
44
+ if (this.#done) {
45
+ return {
46
+ done: true,
47
+ value: typeof value === "undefined" ? value : await value
48
+ };
49
+ }
50
+ this.#done = true;
51
+ return return_(value);
52
+ });
53
+ }
54
+ if (throw_) {
55
+ this.throw = (reason) => enter(() => {
56
+ if (this.#done) {
57
+ return Promise.reject(reason);
58
+ }
59
+ this.#done = true;
60
+ return throw_(reason);
61
+ });
62
+ }
63
+ }
64
+ #criticalSection;
65
+ #done;
66
+ async [Symbol.asyncDispose]() {
67
+ }
68
+ [Symbol.asyncIterator]() {
69
+ return this;
70
+ }
71
+ next;
72
+ return;
73
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
74
+ throw;
75
+ };
76
+
77
+ // src/private/createAbortError.ts
78
+ var ERROR_MESSAGE = "The operation is aborted";
79
+ var ERROR_NAME = "AbortError";
80
+ function createAbortError() {
81
+ if (typeof globalThis.DOMException === "undefined") {
82
+ const error = new Error(ERROR_MESSAGE);
83
+ error.name = ERROR_NAME;
84
+ return error;
85
+ } else {
86
+ return new DOMException(ERROR_MESSAGE, ERROR_NAME);
87
+ }
88
+ }
89
+
90
+ // src/readableStreamValuesWithSignal.ts
91
+ var ReadableStreamIterator = class {
92
+ // The asynchronous iterator initialization steps for a ReadableStream, given stream, iterator, and args, are:
93
+ constructor(stream, args) {
94
+ var _a;
95
+ const reader = stream.getReader();
96
+ this.#reader = reader;
97
+ const preventCancel = !!args[0].preventCancel;
98
+ this.#preventCancel = preventCancel;
99
+ this.#signal = args[0].signal;
100
+ (_a = this.#signal) == null ? void 0 : _a.addEventListener(
101
+ "abort",
102
+ async () => {
103
+ this.#preventCancel || reader.cancel(createAbortError());
104
+ reader.releaseLock();
105
+ },
106
+ { once: true }
107
+ );
108
+ }
109
+ #preventCancel;
110
+ #reader;
111
+ #readRequests = [];
112
+ #signal;
113
+ [Symbol.asyncIterator]() {
114
+ return this;
115
+ }
116
+ async [Symbol.asyncDispose]() {
117
+ }
118
+ // The get the next iteration result steps for a ReadableStream, given stream and iterator, are:
119
+ // next(...[value]: [] | [any]): Promise<IteratorResult<T, any>> {
120
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
121
+ next = () => {
122
+ var _a;
123
+ if ((_a = this.#signal) == null ? void 0 : _a.aborted) {
124
+ return Promise.reject(createAbortError());
125
+ }
126
+ const nextResolvers = Promise.withResolvers();
127
+ const reader = this.#reader;
128
+ const resolvers = Promise.withResolvers();
129
+ const request = {
130
+ // chunk steps, given chunk
131
+ chunk(value) {
132
+ resolvers.resolve({ done: false, value });
133
+ },
134
+ // close steps
135
+ close() {
136
+ reader.releaseLock();
137
+ resolvers.resolve({ done: true, value: void 0 });
138
+ },
139
+ // error steps, given e
140
+ error(reason) {
141
+ reader.releaseLock();
142
+ resolvers.reject(reason);
143
+ }
144
+ };
145
+ this.#readRequests.push(request);
146
+ (async () => {
147
+ var _a2, _b;
148
+ try {
149
+ const result = await reader.read();
150
+ if (result.done) {
151
+ if ((_a2 = this.#signal) == null ? void 0 : _a2.aborted) {
152
+ request.error(createAbortError());
153
+ }
154
+ request.close();
155
+ } else {
156
+ request.chunk(result.value);
157
+ }
158
+ } catch (error) {
159
+ if ((_b = this.#signal) == null ? void 0 : _b.aborted) {
160
+ request.error(createAbortError());
161
+ } else {
162
+ request.error(error);
163
+ }
164
+ } finally {
165
+ nextResolvers.resolve();
166
+ }
167
+ })();
168
+ return resolvers.promise;
169
+ };
170
+ // The asynchronous iterator return steps for a ReadableStream, given stream, iterator, and arg, are:
171
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
172
+ async return(value) {
173
+ var _a;
174
+ if ((_a = this.#signal) == null ? void 0 : _a.aborted) {
175
+ return Promise.reject(createAbortError());
176
+ }
177
+ const reader = this.#reader;
178
+ if (!this.#preventCancel) {
179
+ const cancelPromise = reader.cancel(value);
180
+ reader.releaseLock();
181
+ await cancelPromise;
182
+ return { done: true, value };
183
+ }
184
+ reader.releaseLock();
185
+ return { done: true, value };
186
+ }
187
+ };
188
+ function readableStreamValuesWithSignal(stream, options) {
189
+ return new AsyncIteratorMachinery(new ReadableStreamIterator(stream, [options || {}]));
190
+ }
191
+
192
+ export {
193
+ readableStreamValuesWithSignal
194
+ };
195
+ //# sourceMappingURL=chunk-4P4GJT2O.mjs.map
@@ -0,0 +1 @@
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":";AAAA,IAAqB,kBAArB,MAAqC;AAAA,EACnC,aAA6B,CAAC;AAAA,EAE9B,MAAS,IAAkC;AACzC,UAAM,aAAa,QAAQ,cAAiB;AAiB5C,UAAM,WAAW,YAAY;AArBjC;AAsBM,UAAI;AACF,mBAAW,QAAQ,MAAM,GAAG,CAAC;AAAA,MAC/B,SAAS,OAAO;AACd,mBAAW,OAAO,KAAK;AAAA,MACzB;AAGA,UAAI,KAAK,WAAW,MAAM,MAAM,UAAU;AACxC,cAAM,IAAI,MAAM,6CAA6C;AAAA,MAC/D;AAEA,uBAAK,YAAW,OAAhB;AAAA,IACF;AAEA,SAAK,WAAW,KAAK,QAAQ;AAE7B,SAAK,WAAW,CAAC,MAAM,YAAY,SAAS;AAE5C,WAAO,WAAW;AAAA,EACpB;AACF;;;AC9BA,IAAqB,yBAArB,MAAiH;AAAA,EAC/G,YAAY,UAA4C;AACtD,SAAK,mBAAmB,IAAI,gBAAgB;AAC5C,SAAK,QAAQ;AAEb,UAAM,QAAQ,KAAK,iBAAiB,MAAM,KAAK,KAAK,gBAAgB;AAEpE,UAAM,UAAU,SAAS,UAAU,SAAS,OAAO,KAAK,QAAQ;AAChE,UAAM,SAAS,SAAS,SAAS,SAAS,MAAM,KAAK,QAAQ;AAE7D,SAAK,OAAO,IAAI,CAAC,KAAK,MACpB,MAAM,YAAY;AAChB,UAAI,KAAK,OAAO;AAEd,eAAO,QAAQ,QAAQ,EAAE,MAAM,MAAM,OAAO,OAAqB,CAAC;AAAA,MACpE;AAEA,YAAM,SAAS,MAAM,SAAS,KAAK,GAAI,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAE;AAE5D,UAAI,OAAO,MAAM;AACf,aAAK,QAAQ;AAAA,MACf;AAEA,aAAO;AAAA,IACT,CAAC;AAEH,QAAI,SAAS;AACX,WAAK,SAAS,WACZ,MAAM,YAAY;AAChB,YAAI,KAAK,OAAO;AACd,iBAAO;AAAA,YACL,MAAM;AAAA,YACN,OAAO,OAAO,UAAU,cAAe,QAAoB,MAAM;AAAA,UACnE;AAAA,QACF;AAEA,aAAK,QAAQ;AAEb,eAAO,QAAQ,KAAK;AAAA,MACtB,CAAC;AAAA,IACL;AAEA,QAAI,QAAQ;AACV,WAAK,QAAQ,YACX,MAAM,MAAM;AACV,YAAI,KAAK,OAAO;AACd,iBAAO,QAAQ,OAAO,MAAM;AAAA,QAC9B;AAEA,aAAK,QAAQ;AAEb,eAAO,OAAO,MAAM;AAAA,MACtB,CAAC;AAAA,IACL;AAAA,EACF;AAAA,EAEA;AAAA,EACA;AAAA,EAEA,OAAO,OAAO,YAAY,IAAI;AAAA,EAAC;AAAA,EAE/B,CAAC,OAAO,aAAa,IAAI;AACvB,WAAO;AAAA,EACT;AAAA,EAEA;AAAA,EACA;AAAA;AAAA,EAEA;AACF;;;ACjFA,IAAM,gBAAgB;AACtB,IAAM,aAAa;AAEJ,SAAR,mBAAqF;AAC1F,MAAI,OAAO,WAAW,iBAAiB,aAAa;AAClD,UAAM,QAAQ,IAAI,MAAM,aAAa;AAErC,UAAM,OAAO;AAEb,WAAO;AAAA,EACT,OAAO;AACL,WAAO,IAAI,aAAa,eAAe,UAAU;AAAA,EACnD;AACF;;;ACAA,IAAM,yBAAN,MAA0E;AAAA;AAAA,EAExE,YACE,QACA,MACA;AAlBJ;AAoBI,UAAM,SAAS,OAAO,UAAU;AAGhC,SAAK,UAAU;AAGf,UAAM,gBAAgB,CAAC,CAAC,KAAK,CAAC,EAAE;AAGhC,SAAK,iBAAiB;AAEtB,SAAK,UAAU,KAAK,CAAC,EAAE;AAEvB,eAAK,YAAL,mBAAc;AAAA,MACZ;AAAA,MACA,YAAY;AAEV,aAAK,kBAAkB,OAAO,OAAO,iBAAiB,CAAC;AAEvD,eAAO,YAAY;AAAA,MACrB;AAAA,MACA,EAAE,MAAM,KAAK;AAAA;AAAA,EAEjB;AAAA,EAEA;AAAA,EACA;AAAA,EACA,gBAAwD,CAAC;AAAA,EACzD;AAAA,EAEA,CAAC,OAAO,aAAa,IAAI;AACvB,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,OAAO,YAAY,IAAI;AAAA,EAAC;AAAA;AAAA;AAAA;AAAA,EAK/B,OAA8C,MAAM;AA3DtD;AA4DI,SAAI,UAAK,YAAL,mBAAc,SAAS;AACzB,aAAO,QAAQ,OAAO,iBAAiB,CAAC;AAAA,IAC1C;AAGA,UAAM,gBAAgB,QAAQ,cAAoB;AAGlD,UAAM,SAAS,KAAK;AAMpB,UAAM,YAAY,QAAQ,cAAsC;AAGhE,UAAM,UAAgD;AAAA;AAAA,MAEpD,MAAM,OAAO;AAEX,kBAAU,QAAQ,EAAE,MAAM,OAAO,MAAM,CAAC;AAAA,MAC1C;AAAA;AAAA,MAEA,QAAQ;AAEN,eAAO,YAAY;AAGnB,kBAAU,QAAQ,EAAE,MAAM,MAAM,OAAO,OAAU,CAAC;AAAA,MACpD;AAAA;AAAA,MAEA,MAAM,QAAQ;AAEZ,eAAO,YAAY;AAGnB,kBAAU,OAAO,MAAM;AAAA,MACzB;AAAA,IACF;AAEA,SAAK,cAAc,KAAK,OAAO;AAG/B,KAAC,YAAY;AAxGjB,UAAAA,KAAA;AAyGM,UAAI;AACF,cAAM,SAAS,MAAM,OAAO,KAAK;AAEjC,YAAI,OAAO,MAAM;AACf,eAAIA,MAAA,KAAK,YAAL,gBAAAA,IAAc,SAAS;AACzB,oBAAQ,MAAM,iBAAiB,CAAC;AAAA,UAClC;AAEA,kBAAQ,MAAM;AAAA,QAChB,OAAO;AACL,kBAAQ,MAAM,OAAO,KAAK;AAAA,QAC5B;AAAA,MACF,SAAS,OAAO;AACd,aAAI,UAAK,YAAL,mBAAc,SAAS;AACzB,kBAAQ,MAAM,iBAAiB,CAAC;AAAA,QAClC,OAAO;AACL,kBAAQ,MAAM,KAAK;AAAA,QACrB;AAAA,MACF,UAAE;AACA,sBAAc,QAAQ;AAAA,MACxB;AAAA,IACF,GAAG;AAGH,WAAO,UAAU;AAAA,EACnB;AAAA;AAAA;AAAA,EAIA,MAAM,OAAO,OAA8C;AAtI7D;AAuII,SAAI,UAAK,YAAL,mBAAc,SAAS;AACzB,aAAO,QAAQ,OAAO,iBAAiB,CAAC;AAAA,IAC1C;AAGA,UAAM,SAAS,KAAK;AAKpB,QAAI,CAAC,KAAK,gBAAgB;AAExB,YAAM,gBAAgB,OAAO,OAAO,KAAK;AAMzC,aAAO,YAAY;AAEnB,YAAM;AAKN,aAAO,EAAE,MAAM,MAAM,MAAM;AAAA,IAC7B;AAGA,WAAO,YAAY;AAKnB,WAAO,EAAE,MAAM,MAAM,MAAM;AAAA,EAC7B;AACF;AAWO,SAAS,+BACd,QACA,SACgC;AAChC,SAAO,IAAI,uBAAuB,IAAI,uBAAuB,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;AACvF;","names":["_a"]}
@@ -0,0 +1,9 @@
1
+ // src/readableStreamValues.ts
2
+ function readableStreamValues(readable, options) {
3
+ return readable.values(options);
4
+ }
5
+
6
+ export {
7
+ readableStreamValues
8
+ };
9
+ //# sourceMappingURL=chunk-6ZEIOTH6.mjs.map
@@ -0,0 +1 @@
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":[]}
@@ -0,0 +1,13 @@
1
+ import {
2
+ observableSubscribeAsReadable
3
+ } from "./chunk-GOJ2PI5W.mjs";
4
+
5
+ // src/observableValues.ts
6
+ function observableValues(observable) {
7
+ return observableSubscribeAsReadable(observable).values();
8
+ }
9
+
10
+ export {
11
+ observableValues
12
+ };
13
+ //# sourceMappingURL=chunk-YGRCFTJT.mjs.map
@@ -0,0 +1 @@
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":[]}
@@ -48,4 +48,5 @@ export { observableSubscribeAsReadable } from './iter-fest.observableSubscribeAs
48
48
  export { observableValues } from './iter-fest.observableValues.mjs';
49
49
  export { readableStreamFrom } from './iter-fest.readableStreamFrom.mjs';
50
50
  export { readableStreamValues } from './iter-fest.readableStreamValues.mjs';
51
+ export { ReadableStreamIteratorWithSignalOptions, readableStreamValuesWithSignal } from './iter-fest.readableStreamValuesWithSignal.mjs';
51
52
  import 'core-js-pure/full/observable/index.js';
@@ -48,4 +48,5 @@ export { observableSubscribeAsReadable } from './iter-fest.observableSubscribeAs
48
48
  export { observableValues } from './iter-fest.observableValues.js';
49
49
  export { readableStreamFrom } from './iter-fest.readableStreamFrom.js';
50
50
  export { readableStreamValues } from './iter-fest.readableStreamValues.js';
51
+ export { ReadableStreamIteratorWithSignalOptions, readableStreamValuesWithSignal } from './iter-fest.readableStreamValuesWithSignal.js';
51
52
  import 'core-js-pure/full/observable/index.js';