iter-fest 0.2.2-main.fdb3230 → 0.3.1-main.8cda255

package/dist/iter-fest.readableStreamValuesWithSignal.js

@@ -0,0 +1,221 @@
+"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/readableStreamValuesWithSignal.ts
+var readableStreamValuesWithSignal_exports = {};
+__export(readableStreamValuesWithSignal_exports, {
+  readableStreamValuesWithSignal: () => readableStreamValuesWithSignal
+});
+module.exports = __toCommonJS(readableStreamValuesWithSignal_exports);
+
+// src/private/CriticalSection.ts
+var CriticalSection = class {
+  #callbacks = [];
+  enter(fn) {
+    const fnResolver = Promise.withResolvers();
+    const callback = async () => {
+      var _a, _b;
+      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.");
+      }
+      (_b = (_a = this.#callbacks)[0]) == null ? void 0 : _b.call(_a);
+    };
+    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) {
+    var _a;
+    const reader = stream.getReader();
+    this.#reader = reader;
+    const preventCancel = !!args[0].preventCancel;
+    this.#preventCancel = preventCancel;
+    this.#signal = args[0].signal;
+    (_a = this.#signal) == null ? void 0 : _a.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 = () => {
+    var _a;
+    if ((_a = this.#signal) == null ? void 0 : _a.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 () => {
+      var _a2, _b;
+      try {
+        const result = await reader.read();
+        if (result.done) {
+          if ((_a2 = this.#signal) == null ? void 0 : _a2.aborted) {
+            request.error(createAbortError());
+          }
+          request.close();
+        } else {
+          request.chunk(result.value);
+        }
+      } catch (error) {
+        if ((_b = this.#signal) == null ? void 0 : _b.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) {
+    var _a;
+    if ((_a = this.#signal) == null ? void 0 : _a.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 || {}]));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  readableStreamValuesWithSignal
+});
+//# sourceMappingURL=iter-fest.readableStreamValuesWithSignal.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/readableStreamValuesWithSignal.ts","../src/private/CriticalSection.ts","../src/private/AsyncIteratorMachinery.ts","../src/private/createAbortError.ts"],"sourcesContent":["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","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"],"mappings":"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","names":["_a"]}

package/dist/iter-fest.readableStreamValuesWithSignal.mjs

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

package/dist/iter-fest.readableStreamValuesWithSignal.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iter-fest",
-  "version": "0.2.2-main.fdb3230",
+  "version": "0.3.1-main.8cda255",
   "description": "A collection of utilities for iterations.",
   "files": [
     "./dist/"
@@ -496,6 +496,16 @@
         "default": "./dist/iter-fest.readableStreamValues.js"
       }
     },
+    "./readableStreamValuesWithSignal": {
+      "import": {
+        "types": "./dist/iter-fest.readableStreamValuesWithSignal.d.mts",
+        "default": "./dist/iter-fest.readableStreamValuesWithSignal.mjs"
+      },
+      "require": {
+        "types": "./dist/iter-fest.readableStreamValuesWithSignal.d.ts",
+        "default": "./dist/iter-fest.readableStreamValuesWithSignal.js"
+      }
+    },
     "./symbolObservable": {
       "import": {
         "types": "./dist/iter-fest.symbolObservable.d.mts",
@@ -552,23 +562,23 @@
     "core-js-pure": "^3.37.1"
   },
   "devDependencies": {
-    "@babel/preset-env": "^7.24.7",
-    "@babel/preset-typescript": "^7.24.7",
-    "@testing-library/react": "^16.0.0",
-    "@tsconfig/recommended": "^1.0.6",
+    "@babel/preset-env": "^7.25.8",
+    "@babel/preset-typescript": "^7.25.7",
+    "@testing-library/react": "^16.0.1",
+    "@tsconfig/recommended": "^1.0.7",
     "@tsconfig/strictest": "^2.0.5",
-    "@types/jest": "^29.5.12",
-    "@types/node": "^20.14.9",
-    "core-js-pure": "^3.37.1",
-    "esbuild": "^0.21.5",
+    "@types/jest": "^29.5.13",
+    "@types/node": "^22.7.5",
+    "core-js-pure": "^3.38.1",
+    "esbuild": "^0.24.0",
     "jest": "^29.7.0",
     "jest-environment-jsdom": "^29.7.0",
-    "prettier": "^3.3.2",
+    "prettier": "^3.3.3",
     "publint": "^0.2.11",
-    "tsup": "^8.1.0",
-    "typescript": "^5.5.2"
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.3"
   },
   "dependencies": {
-    "iter-fest": "^0.2.2-main.fdb3230"
+    "iter-fest": "^0.3.1-main.8cda255"
   }
 }

package/dist/chunk-2DE3J4J7.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/generatorWithLastValue.ts"],"sourcesContent":["const STILL_ITERATING = Symbol();\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type GeneratorWithLastValue<T = unknown, TReturn = any, TNext = unknown> = Generator<T, TReturn, TNext> & {\n  lastValue(): TReturn;\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function generatorWithLastValue<T = unknown, TReturn = any, TNext = unknown>(\n  generator: Generator<T, TReturn, TNext>\n): GeneratorWithLastValue<T, TReturn, TNext> {\n  let lastValue: typeof STILL_ITERATING | TReturn = STILL_ITERATING;\n\n  const generatorWithLastValue = {\n    [Symbol.iterator]() {\n      return generatorWithLastValue;\n    },\n    lastValue(): TReturn {\n      if (lastValue === STILL_ITERATING) {\n        throw new Error('Iteration has not complete yet, cannot get last value.');\n      }\n\n      return lastValue;\n    },\n    next(next: TNext) {\n      const result = generator.next(next);\n\n      if (result.done) {\n        lastValue = result.value;\n      }\n\n      return result;\n    },\n    return(value: TReturn) {\n      return generator.return(value);\n    },\n    throw(error: unknown) {\n      return generator.throw(error);\n    }\n  };\n\n  return generatorWithLastValue;\n}\n"],"mappings":";AAAA,IAAM,kBAAkB,OAAO;AAQxB,SAAS,uBACd,WAC2C;AAC3C,MAAI,YAA8C;AAElD,QAAMA,0BAAyB;AAAA,IAC7B,CAAC,OAAO,QAAQ,IAAI;AAClB,aAAOA;AAAA,IACT;AAAA,IACA,YAAqB;AACnB,UAAI,cAAc,iBAAiB;AACjC,cAAM,IAAI,MAAM,wDAAwD;AAAA,MAC1E;AAEA,aAAO;AAAA,IACT;AAAA,IACA,KAAK,MAAa;AAChB,YAAM,SAAS,UAAU,KAAK,IAAI;AAElC,UAAI,OAAO,MAAM;AACf,oBAAY,OAAO;AAAA,MACrB;AAEA,aAAO;AAAA,IACT;AAAA,IACA,OAAO,OAAgB;AACrB,aAAO,UAAU,OAAO,KAAK;AAAA,IAC/B;AAAA,IACA,MAAM,OAAgB;AACpB,aAAO,UAAU,MAAM,KAAK;AAAA,IAC9B;AAAA,EACF;AAEA,SAAOA;AACT;","names":["generatorWithLastValue"]}

package/dist/chunk-ANRVAYLW.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/asyncGeneratorWithLastValue.ts"],"sourcesContent":["const STILL_ITERATING = Symbol();\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AsyncGeneratorWithLastValue<T = unknown, TReturn = any, TNext = unknown> = AsyncGenerator<\n  T,\n  TReturn,\n  TNext\n> & {\n  lastValue(): TReturn;\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function asyncGeneratorWithLastValue<T = unknown, TReturn = any, TNext = unknown>(\n  generator: AsyncGenerator<T, TReturn, TNext>\n): AsyncGeneratorWithLastValue<T, TReturn, TNext> {\n  let lastValue: typeof STILL_ITERATING | TReturn = STILL_ITERATING;\n\n  const asyncGeneratorWithLastValue = {\n    [Symbol.asyncIterator]() {\n      return asyncGeneratorWithLastValue;\n    },\n    lastValue(): TReturn {\n      if (lastValue === STILL_ITERATING) {\n        throw new Error('Iteration has not complete yet, cannot get last value.');\n      }\n\n      return lastValue;\n    },\n    async next(next: TNext) {\n      const result = await generator.next(next);\n\n      if (result.done) {\n        lastValue = result.value;\n      }\n\n      return result;\n    },\n    return(value: TReturn) {\n      return generator.return(value);\n    },\n    throw(error: unknown) {\n      return generator.throw(error);\n    }\n  };\n\n  return asyncGeneratorWithLastValue;\n}\n"],"mappings":";AAAA,IAAM,kBAAkB,OAAO;AAYxB,SAAS,4BACd,WACgD;AAChD,MAAI,YAA8C;AAElD,QAAMA,+BAA8B;AAAA,IAClC,CAAC,OAAO,aAAa,IAAI;AACvB,aAAOA;AAAA,IACT;AAAA,IACA,YAAqB;AACnB,UAAI,cAAc,iBAAiB;AACjC,cAAM,IAAI,MAAM,wDAAwD;AAAA,MAC1E;AAEA,aAAO;AAAA,IACT;AAAA,IACA,MAAM,KAAK,MAAa;AACtB,YAAM,SAAS,MAAM,UAAU,KAAK,IAAI;AAExC,UAAI,OAAO,MAAM;AACf,oBAAY,OAAO;AAAA,MACrB;AAEA,aAAO;AAAA,IACT;AAAA,IACA,OAAO,OAAgB;AACrB,aAAO,UAAU,OAAO,KAAK;AAAA,IAC/B;AAAA,IACA,MAAM,OAAgB;AACpB,aAAO,UAAU,MAAM,KAAK;AAAA,IAC9B;AAAA,EACF;AAEA,SAAOA;AACT;","names":["asyncGeneratorWithLastValue"]}

package/dist/chunk-RVIERPEV.mjs

@@ -1,26 +0,0 @@
-// src/readableStreamValues.ts
-function readableStreamValues(readable) {
-  const reader = readable.getReader();
-  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.releaseLock();
-      return { done: true, value: void 0 };
-    }
-  };
-  return iterable;
-}
-
-export {
-  readableStreamValues
-};
-//# sourceMappingURL=chunk-RVIERPEV.mjs.map

package/dist/chunk-RVIERPEV.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/readableStreamValues.ts"],"sourcesContent":["export function readableStreamValues<T>(readable: ReadableStream<T>): AsyncIterableIterator<T> {\n  const reader = readable.getReader();\n\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      // Break/throw inside for-loop will trigger return().\n      reader.releaseLock();\n\n      return { done: true, value: undefined };\n    }\n  };\n\n  return iterable;\n}\n"],"mappings":";AAAO,SAAS,qBAAwB,UAAuD;AAC7F,QAAM,SAAS,SAAS,UAAU;AAElC,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,YAAY;AAEnB,aAAO,EAAE,MAAM,MAAM,OAAO,OAAU;AAAA,IACxC;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

package/dist/chunk-WMTE2GGJ.mjs

@@ -1,38 +0,0 @@
-import {
-  readableStreamValues
-} from "./chunk-RVIERPEV.mjs";
-import {
-  observableSubscribeAsReadable
-} from "./chunk-GOJ2PI5W.mjs";
-
-// src/observableValues.ts
-function observableValues(observable) {
-  const readable = observableSubscribeAsReadable(observable);
-  const iterable = readableStreamValues(readable);
-  const cancellableIterable = {
-    [Symbol.asyncIterator]() {
-      return cancellableIterable;
-    },
-    next() {
-      return iterable.next();
-    },
-    return() {
-      var _a;
-      try {
-        return ((_a = iterable.return) == null ? void 0 : _a.call(iterable)) ?? Promise.resolve({ done: true, value: void 0 });
-      } finally {
-        readable.cancel();
-      }
-    },
-    throw(error) {
-      var _a;
-      return ((_a = iterable.throw) == null ? void 0 : _a.call(iterable, error)) ?? Promise.resolve({ done: true, value: void 0 });
-    }
-  };
-  return cancellableIterable;
-}
-
-export {
-  observableValues
-};
-//# sourceMappingURL=chunk-WMTE2GGJ.mjs.map

package/dist/chunk-WMTE2GGJ.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/observableValues.ts"],"sourcesContent":["import { type Observable } from './Observable.ts';\nimport { observableSubscribeAsReadable } from './observableSubscribeAsReadable.ts';\nimport { readableStreamValues } from './readableStreamValues.ts';\n\nexport function observableValues<T>(observable: Observable<T>): AsyncIterableIterator<T> {\n  const readable = observableSubscribeAsReadable(observable);\n  const iterable = readableStreamValues(readable);\n\n  const cancellableIterable: AsyncIterableIterator<T> = {\n    [Symbol.asyncIterator]() {\n      return cancellableIterable;\n    },\n    next() {\n      return iterable.next();\n    },\n    return() {\n      try {\n        return iterable.return?.() ?? Promise.resolve({ done: true, value: undefined });\n      } finally {\n        readable.cancel();\n      }\n    },\n    throw(error) {\n      return iterable.throw?.(error) ?? Promise.resolve({ done: true, value: undefined });\n    }\n  };\n\n  return cancellableIterable;\n}\n"],"mappings":";;;;;;;;AAIO,SAAS,iBAAoB,YAAqD;AACvF,QAAM,WAAW,8BAA8B,UAAU;AACzD,QAAM,WAAW,qBAAqB,QAAQ;AAE9C,QAAM,sBAAgD;AAAA,IACpD,CAAC,OAAO,aAAa,IAAI;AACvB,aAAO;AAAA,IACT;AAAA,IACA,OAAO;AACL,aAAO,SAAS,KAAK;AAAA,IACvB;AAAA,IACA,SAAS;AAfb;AAgBM,UAAI;AACF,iBAAO,cAAS,WAAT,sCAAuB,QAAQ,QAAQ,EAAE,MAAM,MAAM,OAAO,OAAU,CAAC;AAAA,MAChF,UAAE;AACA,iBAAS,OAAO;AAAA,MAClB;AAAA,IACF;AAAA,IACA,MAAM,OAAO;AAtBjB;AAuBM,eAAO,cAAS,UAAT,kCAAiB,WAAU,QAAQ,QAAQ,EAAE,MAAM,MAAM,OAAO,OAAU,CAAC;AAAA,IACpF;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}