iter-fest 0.1.1-main.c619924 → 0.1.1-main.cd25da6

package/README.md

@@ -33,9 +33,21 @@ console.log(iterableSome(iterable, value => value % 2)); // Prints "true".
 
 List of ported functions: [`at`](https://tc39.es/ecma262/#sec-array.prototype.at), [`concat`](https://tc39.es/ecma262/#sec-array.prototype.concat), [`entries`](https://tc39.es/ecma262/#sec-array.prototype.entries), [`every`](https://tc39.es/ecma262/#sec-array.prototype.every), [`filter`](https://tc39.es/ecma262/#sec-array.prototype.filter), [`find`](https://tc39.es/ecma262/#sec-array.prototype.find), [`findIndex`](https://tc39.es/ecma262/#sec-array.prototype.findindex), [`findLast`](https://tc39.es/ecma262/#sec-array.prototype.findlast), [`findLastIndex`](https://tc39.es/ecma262/#sec-array.prototype.findlastindex), [`forEach`](https://tc39.es/ecma262/#sec-array.prototype.foreach), [`includes`](https://tc39.es/ecma262/#sec-array.prototype.includes), [`indexOf`](https://tc39.es/ecma262/#sec-array.prototype.indexof), [`join`](https://tc39.es/ecma262/#sec-array.prototype.join), [`keys`](https://tc39.es/ecma262/#sec-array.prototype.keys), [`map`](https://tc39.es/ecma262/#sec-array.prototype.map), [`reduce`](https://tc39.es/ecma262/#sec-array.prototype.reduce), [`slice`](https://tc39.es/ecma262/#sec-array.prototype.slice), [`some`](https://tc39.es/ecma262/#sec-array.prototype.some), [`toSpliced`](https://tc39.es/ecma262/#sec-array.prototype.tospliced), and [`toString`](https://tc39.es/ecma262/#sec-array.prototype.tostring).
 
+## Conversions
+
+| From                          | To                      | Function signature                                                                                                                               |
+| ----------------------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `Iterator`                    | `IterableIterator`      | [`iteratorToIterable<T>(iterator: Iterator<T>): IterableIterator<T>`](#converting-an-iterator-to-iterable)                                       |
+| `Observable`                  | `ReadableStream`        | [`observableSubscribeAsReadable<T>(observable: Observable<T>): ReadableStream<T>`](#converting-an-observable-to-readablestream)                  |
+| `ReadableStreamDefaultReader` | `AsyncIterableIterator` | [`readerValues`<T>(reader: ReadableStreamDefaultReader<T>): AsyncIterableIterator<T>`](#iterating-readablestreamdefaultreader)                   |
+| `AsyncIterable`               | `Observable`            | [`observableFromAsync<T>(iterable: AsyncIterable<T>): Observable<T>`](#converting-an-asynciterable-to-observable)                                |
+| `AsyncIterable`/`Iterable`    | `ReadableStream`        | [`iterableGetReadable<T>(iterable: AsyncIterable<T> \| Iterable<T>): ReadableStream<T>`](#converting-an-asynciterableiterable-to-readablestream) |
+
+To convert `Observable` to `AsyncIterableIterator`, [use `ReadableStream` as intermediate format](#converting-an-observable-to-asynciterableiterator).
+
 ### Converting an iterator to iterable
 
-`iteratorToIterable` converts a pure iterator to `IterableIterator` and enable for-loop iteration.
+`iteratorToIterable` enable a [pure iterator](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Iterator) to be iterable using a for-loop statement.
 
 ```ts
 const iterate = (): Iterator<number> => {
@@ -44,7 +56,7 @@ const iterate = (): Iterator<number> => {
   return {
     next: () => {
       if (++value <= 3) {
-        return { done: false, value };
+        return { value };
       }
 
       return { done: true, value: undefined };
@@ -57,20 +69,17 @@ for (const value of iteratorToIterable(iterate())) {
 }
 ```
 
-### Typed `Observable`
-
-`Observable` and `Symbol.observable` is re-exported from `core-js-pure` with proper type definitions.
-
 ### Converting an `Observable` to `AsyncIterableIterator`
 
-`observableValues` subscribes to an `Observable` and return as `AsyncIterableIterator`.
+`ReadableStream` can be used to 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);
 
-for await (const value of observableValues(observable)) {
+for await (const value of readerValues(readable.getReader())) {
   console.log(value); // Prints "1", "2", "3".
 }
 ```
@@ -94,6 +103,85 @@ const next = value => console.log(value);
 observable.subscribe({ next }); // Prints "1", "2", "3".
 ```
 
+## Converting an `Observable` to `ReadableStream`
+
+`ReadableStream` is powerful for transforming and piping stream of data. It can be formed using data from both push-based and pull-based source with backpressuree.
+
+Note: `Observable` is push-based and it does not support flow control. When converting to `ReadableStream`, the internal buffer could build up quickly.
+
+```ts
+const observable = Observable.from([1, 2, 3]);
+const readable = observableSubscribeAsReadable(observable);
+const reader = readable.getReader();
+
+readable.pipeTo(stream.writable); // Will write 1, 2, 3.
+```
+
+### Iterating `ReadableStreamDefaultReader`
+
+`readerValues` will convert default reader of `ReadableStream` into an `AsyncIterableIterator` to use in for-loop.
+
+```ts
+const readableStream = new ReadableStream({
+  start(controller) {
+    controller.enqueue(1);
+    controller.enqueue(2);
+  },
+  pull(controller) {
+    controller.enqueue(3);
+    controller.close();
+  }
+});
+
+for await (const value of readerValues(readableStream.getReader())) {
+  console.log(value); // Prints "1", "2", "3".
+}
+```
+
+## Converting an `AsyncIterable`/`Iterable` to `ReadableStream`
+
+```ts
+const iterable = [1, 2, 3].values();
+const readable = iterableGetReadable(iterable);
+
+readable.pipeTo(stream.writable); // Will write 1, 2, 3.
+```
+
+## Others
+
+### Typed `Observable`
+
+`Observable` and `Symbol.observable` is re-exported from `core-js-pure` with proper type definitions.
+
+### Producer-consumer queue
+
+`PushAsyncIterableIterator` is a simple push-based producer-consumer queue and designed to decouple the flow between a producer and consumer. The producer can push a new job at anytime. The consumer can pull a job at its own convenience.
+
+Compare to pull-based queue, a push-based queue is easier to use. However, pull-based queue offers better flow control as it will produce a job only if there is a consumer ready to consume.
+
+For a full-featured producer-consumer queue that supports flow control, use `ReadableStream` instead.
+
+```ts
+const iterable = new PushAsyncIterableIterator();
+
+(async function consumer() {
+  for await (const value of iterable) {
+    console.log(value);
+  }
+
+  console.log('Done');
+})();
+
+(async function producer() {
+  iterable.push(1);
+  iterable.push(2);
+  iterable.push(3);
+  iterable.close();
+})();
+
+// Prints "1", "2", "3", "Done".
+```
+
 ## Behaviors
 
 ### How this compares to the TC39 proposals?

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

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

package/dist/chunk-MOBXUTO5.mjs.map

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

package/dist/chunk-O5SQJUKB.mjs

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

package/dist/chunk-O5SQJUKB.mjs.map

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

package/dist/iter-fest.d.mts

@@ -1,4 +1,5 @@
 export { CompleteFunction, ErrorFunction, NextFunction, Observable, Observer, StartFunction, SubscriberFunction, Subscription, SubscriptionObserver } from './iter-fest.observable.mjs';
+export { PushAsyncIterableIterator } from './iter-fest.pushAsyncIterableIterator.mjs';
 export { SymbolObservable } from './iter-fest.symbolObservable.mjs';
 export { iterableAt } from './iter-fest.iterableAt.mjs';
 export { iterableConcat } from './iter-fest.iterableConcat.mjs';
@@ -10,6 +11,7 @@ export { iterableFindIndex } from './iter-fest.iterableFindIndex.mjs';
 export { iterableFindLast } from './iter-fest.iterableFindLast.mjs';
 export { iterableFindLastIndex } from './iter-fest.iterableFindLastIndex.mjs';
 export { iterableForEach } from './iter-fest.iterableForEach.mjs';
+export { iterableGetReadable } from './iter-fest.iterableGetReadable.mjs';
 export { iterableIncludes } from './iter-fest.iterableIncludes.mjs';
 export { iterableIndexOf } from './iter-fest.iterableIndexOf.mjs';
 export { iterableJoin } from './iter-fest.iterableJoin.mjs';
@@ -22,5 +24,6 @@ export { iterableToSpliced } from './iter-fest.iterableToSpliced.mjs';
 export { iterableToString } from './iter-fest.iterableToString.mjs';
 export { iteratorToIterable } from './iter-fest.iteratorToIterable.mjs';
 export { observableFromAsync } from './iter-fest.observableFromAsync.mjs';
-export { observableValues } from './iter-fest.observableValues.mjs';
+export { observableSubscribeAsReadable } from './iter-fest.observableSubscribeAsReadable.mjs';
+export { readerValues } from './iter-fest.readerValues.mjs';
 import 'core-js-pure/full/observable';

package/dist/iter-fest.d.ts

@@ -1,4 +1,5 @@
 export { CompleteFunction, ErrorFunction, NextFunction, Observable, Observer, StartFunction, SubscriberFunction, Subscription, SubscriptionObserver } from './iter-fest.observable.js';
+export { PushAsyncIterableIterator } from './iter-fest.pushAsyncIterableIterator.js';
 export { SymbolObservable } from './iter-fest.symbolObservable.js';
 export { iterableAt } from './iter-fest.iterableAt.js';
 export { iterableConcat } from './iter-fest.iterableConcat.js';
@@ -10,6 +11,7 @@ export { iterableFindIndex } from './iter-fest.iterableFindIndex.js';
 export { iterableFindLast } from './iter-fest.iterableFindLast.js';
 export { iterableFindLastIndex } from './iter-fest.iterableFindLastIndex.js';
 export { iterableForEach } from './iter-fest.iterableForEach.js';
+export { iterableGetReadable } from './iter-fest.iterableGetReadable.js';
 export { iterableIncludes } from './iter-fest.iterableIncludes.js';
 export { iterableIndexOf } from './iter-fest.iterableIndexOf.js';
 export { iterableJoin } from './iter-fest.iterableJoin.js';
@@ -22,5 +24,6 @@ export { iterableToSpliced } from './iter-fest.iterableToSpliced.js';
 export { iterableToString } from './iter-fest.iterableToString.js';
 export { iteratorToIterable } from './iter-fest.iteratorToIterable.js';
 export { observableFromAsync } from './iter-fest.observableFromAsync.js';
-export { observableValues } from './iter-fest.observableValues.js';
+export { observableSubscribeAsReadable } from './iter-fest.observableSubscribeAsReadable.js';
+export { readerValues } from './iter-fest.readerValues.js';
 import 'core-js-pure/full/observable';

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

@@ -0,0 +1,3 @@
+declare function iterableGetReadable<T>(iterable: AsyncIterable<T> | Iterable<T>): ReadableStream<T>;
+
+export { iterableGetReadable };

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

@@ -0,0 +1,3 @@
+declare function iterableGetReadable<T>(iterable: AsyncIterable<T> | Iterable<T>): ReadableStream<T>;
+
+export { iterableGetReadable };

package/dist/iter-fest.iterableGetReadable.js

@@ -0,0 +1,46 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/iterableGetReadable.ts
+var iterableGetReadable_exports = {};
+__export(iterableGetReadable_exports, {
+  iterableGetReadable: () => iterableGetReadable
+});
+module.exports = __toCommonJS(iterableGetReadable_exports);
+function isIterable(iterable) {
+  return !!(iterable && typeof iterable === "object" && Symbol.iterator in iterable);
+}
+function iterableGetReadable(iterable) {
+  const iterator = isIterable(iterable) ? iterable[Symbol.iterator]() : iterable[Symbol.asyncIterator]();
+  return new ReadableStream({
+    async pull(controller) {
+      const result = await iterator.next();
+      if (result.done) {
+        controller.close();
+      } else {
+        controller.enqueue(result.value);
+      }
+    }
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  iterableGetReadable
+});
+//# sourceMappingURL=iter-fest.iterableGetReadable.js.map

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

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

package/dist/iter-fest.iterableGetReadable.mjs

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

package/dist/iter-fest.js

@@ -31,6 +31,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var src_exports = {};
 __export(src_exports, {
   Observable: () => Observable,
+  PushAsyncIterableIterator: () => PushAsyncIterableIterator,
   SymbolObservable: () => SymbolObservable,
   iterableAt: () => iterableAt,
   iterableConcat: () => iterableConcat,
@@ -42,6 +43,7 @@ __export(src_exports, {
   iterableFindLast: () => iterableFindLast,
   iterableFindLastIndex: () => iterableFindLastIndex,
   iterableForEach: () => iterableForEach,
+  iterableGetReadable: () => iterableGetReadable,
   iterableIncludes: () => iterableIncludes,
   iterableIndexOf: () => iterableIndexOf,
   iterableJoin: () => iterableJoin,
@@ -54,7 +56,8 @@ __export(src_exports, {
   iterableToString: () => iterableToString,
   iteratorToIterable: () => iteratorToIterable,
   observableFromAsync: () => observableFromAsync,
-  observableValues: () => observableValues
+  observableSubscribeAsReadable: () => observableSubscribeAsReadable,
+  readerValues: () => readerValues
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -86,6 +89,39 @@ var Observable = class extends import_observable2.default {
   }
 };
 
+// src/private/withResolvers.ts
+var import_with_resolvers = __toESM(require("core-js-pure/full/promise/with-resolvers"));
+function withResolvers() {
+  return (0, import_with_resolvers.default)();
+}
+
+// src/PushAsyncIterableIterator.ts
+var CLOSE = Symbol("close");
+var PushAsyncIterableIterator = class {
+  #closed = false;
+  #pushResolvers = withResolvers();
+  [Symbol.asyncIterator]() {
+    return this;
+  }
+  close() {
+    this.#closed = true;
+    this.#pushResolvers.resolve(CLOSE);
+  }
+  async next() {
+    const value = await this.#pushResolvers.promise;
+    if (value === CLOSE) {
+      return { done: true, value: void 0 };
+    }
+    return { done: false, value };
+  }
+  push(value) {
+    if (!this.#closed) {
+      this.#pushResolvers.resolve(value);
+      this.#pushResolvers = withResolvers();
+    }
+  }
+};
+
 // src/private/toIntegerOrInfinity.ts
 function toIntegerOrInfinity(value) {
   if (value === Infinity || value === -Infinity) {
@@ -237,6 +273,24 @@ function iterableForEach(iterable, callbackfn, thisArg) {
   }
 }
 
+// src/iterableGetReadable.ts
+function isIterable(iterable) {
+  return !!(iterable && typeof iterable === "object" && Symbol.iterator in iterable);
+}
+function iterableGetReadable(iterable) {
+  const iterator = isIterable(iterable) ? iterable[Symbol.iterator]() : iterable[Symbol.asyncIterator]();
+  return new ReadableStream({
+    async pull(controller) {
+      const result = await iterator.next();
+      if (result.done) {
+        controller.close();
+      } else {
+        controller.enqueue(result.value);
+      }
+    }
+  });
+}
+
 // src/iterableIncludes.ts
 function iterableIncludes(iterable, searchElement, fromIndex = 0) {
   let index = 0;
@@ -427,68 +481,53 @@ function observableFromAsync(iterable) {
   });
 }
 
-// src/private/withResolvers.ts
-var import_with_resolvers = __toESM(require("core-js-pure/full/promise/with-resolvers"));
-function withResolvers() {
-  return (0, import_with_resolvers.default)();
-}
-
-// src/observableValues.ts
-var COMPLETE = Symbol("complete");
-var NEXT = Symbol("next");
-var THROW = Symbol("throw");
-function observableValues(observable) {
-  const queue = [];
-  let deferred = withResolvers();
-  const push = (entry) => {
-    queue.push(entry);
-    deferred.resolve(entry);
-    deferred = withResolvers();
-  };
-  const subscription = observable.subscribe({
-    complete() {
-      push([COMPLETE]);
-    },
-    error(err) {
-      push([THROW, err]);
+// src/observableSubscribeAsReadable.ts
+function observableSubscribeAsReadable(observable) {
+  let subscription;
+  return new ReadableStream({
+    cancel() {
+      subscription.unsubscribe();
     },
-    next(value) {
-      push([NEXT, value]);
+    start(controller) {
+      subscription = observable.subscribe({
+        complete() {
+          controller.close();
+        },
+        error(err) {
+          controller.error(err);
+        },
+        next(value) {
+          controller.enqueue(value);
+        }
+      });
     }
   });
-  const asyncIterableIterator = {
+}
+
+// src/readerValues.ts
+function readerValues(reader) {
+  const iterable = {
     [Symbol.asyncIterator]() {
-      return this;
+      return iterable;
     },
     async next() {
-      let entry = queue.shift();
-      if (!entry) {
-        entry = await deferred.promise;
-        queue.shift();
-      }
-      switch (entry[0]) {
-        case COMPLETE:
-          return { done: true, value: void 0 };
-        case THROW:
-          throw entry[1];
-        case NEXT:
-          return { done: false, value: entry[1] };
+      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() {
-      subscription.unsubscribe();
-      return { done: true, value: void 0 };
-    },
-    async throw() {
-      subscription.unsubscribe();
+      reader.cancel();
       return { done: true, value: void 0 };
     }
   };
-  return asyncIterableIterator;
+  return iterable;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Observable,
+  PushAsyncIterableIterator,
   SymbolObservable,
   iterableAt,
   iterableConcat,
@@ -500,6 +539,7 @@ function observableValues(observable) {
   iterableFindLast,
   iterableFindLastIndex,
   iterableForEach,
+  iterableGetReadable,
   iterableIncludes,
   iterableIndexOf,
   iterableJoin,
@@ -512,6 +552,7 @@ function observableValues(observable) {
   iterableToString,
   iteratorToIterable,
   observableFromAsync,
-  observableValues
+  observableSubscribeAsReadable,
+  readerValues
 });
 //# sourceMappingURL=iter-fest.js.map