graphql 17.0.0-beta.1 → 17.0.0-beta.2

package/execution/incremental/Queue.js

@@ -5,51 +5,6 @@ const invariant_ts_1 = require("../../jsutils/invariant.js");
 const isPromise_ts_1 = require("../../jsutils/isPromise.js");
 const promiseWithResolvers_ts_1 = require("../../jsutils/promiseWithResolvers.js");
 const withConcurrentAbruptClose_ts_1 = require("../withConcurrentAbruptClose.js");
-/**
- * A Queue is a lightweight async-generator primitive inspired by Brian Kim's
- * Repeater (https://repeater.js.org, https://github.com/repeaterjs/repeater).
- * The ergonomics are similar, but this implementation favors clarity over
- * performance and gives producers flexibility to remain lazy, become eager, or
- * live somewhere in between.
- *
- * The constructor takes an executor function and an optional `initialCapacity`.
- * Executors receive `{ push, stop, onStop, started }` and may return `void` or
- * a promise if they perform asynchronous setup. They call `push` whenever
- * another item is ready, call `stop` when no more values will be produced
- * (optionally supplying an error), register stop-time cleanup via `onStop`,
- * and await `started` when setup should run only after iteration begins.
- * Because `push`, `stop`, and `onStop` are plain functions, executors can
- * hoist them into outside scopes or pass them to helpers. If the executor
- * throws or its returned promise rejects, the queue treats it as `stop(error)`
- * and propagates the failure.
- *
- * The `initialCapacity` argument (default `1`) governs backpressure. Capacity
- * is the maximum number of buffered items allowed before a push must wait.
- * When the backlog reaches capacity, `push` returns a promise that settles
- * once consumption releases space; otherwise it returns `undefined`. Setting
- * capacity to `1` yields a fully lazy queue (every push waits unless a prior
- * item has been consumed); higher capacities buffer that many items eagerly.
- * Capacity can be changed later via `setCapacity` and observed via
- * `getCapacity`.
- *
- * `subscribe(reducer)` returns an async generator whose batches feed a generator
- * of settled values into the reducer; whatever the reducer returns (other than
- * `undefined`) becomes the yielded value for that batch. Calling `return()` on
- * the subscription settles pending `next` calls thanks to `withConcurrent`,
- * providing direct abort semantics rather than leaving `next()` suspended.
- *
- * 'forEachBatch(reducer)` is a convenience method that subscribes with the
- * given reducer and runs it for each batch until the queue stops.
- *
- * Producers can stay lazy by awaiting `started`, using zero capacity, and
- * awaiting each `push`. Skipping those waits while raising capacity makes the
- * queue eager up to its configured limit. The `isStopped()` helper exposes
- * whether the queue has fully stopped, which can be useful when the reducer
- * function actually performs external work and wants to bail early without
- * awaiting another `next`.
- *
- * @internal
- */
 class Queue {
     constructor(executor, initialCapacity = 1) {
         this._backlog = 0;
@@ -60,9 +15,7 @@ class Queue {
         this._stopCleanupCallbacks = [];
         this._batchRequests = new Set();
         this._capacity = this._normalizeCapacity(initialCapacity);
-        const { promise: started, resolve: resolveStarted } = 
-        // eslint-disable-next-line @typescript-eslint/no-invalid-void-type
-        (0, promiseWithResolvers_ts_1.promiseWithResolvers)();
+        const { promise: started, resolve: resolveStarted } = (0, promiseWithResolvers_ts_1.promiseWithResolvers)();
         this._resolveStarted = resolveStarted;
         try {
             const result = executor({
@@ -78,7 +31,6 @@ class Queue {
         catch (error) {
             const stopped = this._stop(error);
             if ((0, isPromise_ts_1.isPromise)(stopped)) {
-                /* node:coverage ignore next */
                 stopped.catch(() => undefined);
             }
         }
@@ -108,7 +60,6 @@ class Queue {
                 this._batchRequests.clear();
                 return;
             }
-            // save rejection for later batch requests
             this._entries.push({
                 kind: 'item',
                 settled: { status: 'rejected', reason },
@@ -117,19 +68,14 @@ class Queue {
     }
     async forEachBatch(reducer) {
         const sub = this.subscribe(async (generator) => {
-            const { promise: drained, resolve } = 
-            // eslint-disable-next-line @typescript-eslint/no-invalid-void-type
-            (0, promiseWithResolvers_ts_1.promiseWithResolvers)();
+            const { promise: drained, resolve } = (0, promiseWithResolvers_ts_1.promiseWithResolvers)();
             const wrappedBatch = (function* wrapper() {
                 yield* generator;
                 resolve();
             })();
             await Promise.all([reducer(wrappedBatch), drained]);
         });
-        // Empty loop body is intentionally used to drain the subscription.
-        /* node:coverage ignore next 3 */
         for await (const _ of sub) {
-            // intentionally empty
         }
     }
     setCapacity(nextCapacity) {
@@ -155,7 +101,6 @@ class Queue {
         if (this._backlog < this._capacity) {
             return undefined;
         }
-        // eslint-disable-next-line @typescript-eslint/no-invalid-void-type
         const { promise, resolve } = (0, promiseWithResolvers_ts_1.promiseWithResolvers)();
         this._waiters.push(resolve);
         return promise;
@@ -180,7 +125,6 @@ class Queue {
                 return (0, isPromise_ts_1.isPromise)(result) ? [result] : [];
             }
             catch {
-                // ignore errors
                 return [];
             }
         });
@@ -198,11 +142,9 @@ class Queue {
     async *_iteratorLoop(reducer) {
         this._resolveStarted();
         let nextBatch;
-        // eslint-disable-next-line no-await-in-loop
         while ((nextBatch = await this._waitForNextBatch())) {
             let reduced = reducer(nextBatch);
             if ((0, isPromise_ts_1.isPromise)(reduced)) {
-                // eslint-disable-next-line no-await-in-loop
                 reduced = await reduced;
             }
             if (reduced === undefined) {
@@ -274,7 +216,6 @@ class Queue {
             this._deliverBatchIfReady();
         });
         if ((0, isPromise_ts_1.isPromise)(stopCompletion)) {
-            /* node:coverage ignore next */
             stopCompletion.catch(() => undefined);
         }
         return stopCompletion;
@@ -287,9 +228,7 @@ class Queue {
         const requests = this._batchRequests;
         if (headEntry !== undefined) {
             if (!(headEntry.kind !== 'stop'))
-                (0, 
-                // stop sentinel always follows other work
-                invariant_ts_1.invariant)(false);
+                (0, invariant_ts_1.invariant)(false);
             const settled = headEntry.settled;
             if (settled !== undefined) {
                 if (settled.status === 'fulfilled') {

package/execution/incremental/Queue.js.map

@@ -1 +1 @@
-{"version":3,"file":"Queue.js","sourceRoot":"","sources":["../../../src/execution/incremental/Queue.ts"],"names":[],"mappings":"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","sourcesContent":["import { invariant } from '../../jsutils/invariant.ts';\nimport { isPromise } from '../../jsutils/isPromise.ts';\nimport type { PromiseOrValue } from '../../jsutils/PromiseOrValue.ts';\nimport { promiseWithResolvers } from '../../jsutils/promiseWithResolvers.ts';\n\nimport { withConcurrentAbruptClose } from '../withConcurrentAbruptClose.ts';\n\ntype Settled<T> =\n  | { status: 'fulfilled'; value: T }\n  | { status: 'rejected'; reason: unknown };\n\ninterface ItemEntry<T> {\n  kind: 'item';\n  settled?: Settled<T>;\n}\n\ninterface StopEntry {\n  kind: 'stop';\n}\n\ntype Entry<T> = ItemEntry<T> | StopEntry;\n\ninterface BatchRequest<T> {\n  resolve: (generator: Generator<T> | undefined) => void;\n  reject: (reason: unknown) => void;\n}\n\ninterface QueueExecutorOptions<T> {\n  push: (item: PromiseOrValue<T>) => PromiseOrValue<void>;\n  stop: (reason?: unknown) => PromiseOrValue<void>;\n  onStop: (cleanup: (reason?: unknown) => PromiseOrValue<void>) => void;\n  started: Promise<void>;\n}\n\n/**\n * A Queue is a lightweight async-generator primitive inspired by Brian Kim's\n * Repeater (https://repeater.js.org, https://github.com/repeaterjs/repeater).\n * The ergonomics are similar, but this implementation favors clarity over\n * performance and gives producers flexibility to remain lazy, become eager, or\n * live somewhere in between.\n *\n * The constructor takes an executor function and an optional `initialCapacity`.\n * Executors receive `{ push, stop, onStop, started }` and may return `void` or\n * a promise if they perform asynchronous setup. They call `push` whenever\n * another item is ready, call `stop` when no more values will be produced\n * (optionally supplying an error), register stop-time cleanup via `onStop`,\n * and await `started` when setup should run only after iteration begins.\n * Because `push`, `stop`, and `onStop` are plain functions, executors can\n * hoist them into outside scopes or pass them to helpers. If the executor\n * throws or its returned promise rejects, the queue treats it as `stop(error)`\n * and propagates the failure.\n *\n * The `initialCapacity` argument (default `1`) governs backpressure. Capacity\n * is the maximum number of buffered items allowed before a push must wait.\n * When the backlog reaches capacity, `push` returns a promise that settles\n * once consumption releases space; otherwise it returns `undefined`. Setting\n * capacity to `1` yields a fully lazy queue (every push waits unless a prior\n * item has been consumed); higher capacities buffer that many items eagerly.\n * Capacity can be changed later via `setCapacity` and observed via\n * `getCapacity`.\n *\n * `subscribe(reducer)` returns an async generator whose batches feed a generator\n * of settled values into the reducer; whatever the reducer returns (other than\n * `undefined`) becomes the yielded value for that batch. Calling `return()` on\n * the subscription settles pending `next` calls thanks to `withConcurrent`,\n * providing direct abort semantics rather than leaving `next()` suspended.\n *\n * 'forEachBatch(reducer)` is a convenience method that subscribes with the\n * given reducer and runs it for each batch until the queue stops.\n *\n * Producers can stay lazy by awaiting `started`, using zero capacity, and\n * awaiting each `push`. Skipping those waits while raising capacity makes the\n * queue eager up to its configured limit. The `isStopped()` helper exposes\n * whether the queue has fully stopped, which can be useful when the reducer\n * function actually performs external work and wants to bail early without\n * awaiting another `next`.\n *\n * @internal\n */\nexport class Queue<T> {\n  private _capacity: number;\n  private _backlog = 0;\n  private _waiters: Array<() => void> = [];\n  private _entries: Array<Entry<T>> = [];\n  private _isStopped = false;\n  private _stopRequested = false;\n  private _stopCleanupCallbacks: Array<\n    (reason?: unknown) => PromiseOrValue<void>\n  > = [];\n  private _stopCompletion: Promise<void> | undefined;\n  private _batchRequests = new Set<BatchRequest<T>>();\n\n  private _resolveStarted: () => void;\n\n  constructor(\n    executor: ({\n      push,\n      stop,\n      onStop,\n      started,\n    }: QueueExecutorOptions<T>) => PromiseOrValue<void>,\n    initialCapacity = 1,\n  ) {\n    this._capacity = this._normalizeCapacity(initialCapacity);\n\n    const { promise: started, resolve: resolveStarted } =\n      // eslint-disable-next-line @typescript-eslint/no-invalid-void-type\n      promiseWithResolvers<void>();\n\n    this._resolveStarted = resolveStarted;\n\n    try {\n      const result = executor({\n        push: this._push.bind(this),\n        stop: this._stop.bind(this),\n        onStop: this._onStop.bind(this),\n        started,\n      });\n      if (isPromise(result)) {\n        result.catch(this._stop.bind(this));\n      }\n    } catch (error) {\n      const stopped = this._stop(error);\n      if (isPromise(stopped)) {\n        /* node:coverage ignore next */\n        stopped.catch(() => undefined);\n      }\n    }\n  }\n\n  subscribe<U>(\n    reducer: (\n      generator: Generator<T, void, void>,\n    ) => PromiseOrValue<U | undefined> = (generator) =>\n      Array.from(generator) as U,\n  ): AsyncGenerator<U, void, void> {\n    const generator = this._iteratorLoop(reducer);\n    return withConcurrentAbruptClose(\n      generator,\n      () => this.cancel(),\n      this.abort.bind(this),\n    );\n  }\n\n  cancel(): PromiseOrValue<void> {\n    if (this._stopRequested) {\n      return this._stopCompletion;\n    }\n    return this._terminate(undefined, () => {\n      this._isStopped = true;\n      this._batchRequests.forEach((request) => request.resolve(undefined));\n      this._batchRequests.clear();\n    });\n  }\n\n  abort(reason?: unknown): PromiseOrValue<void> {\n    if (this._stopRequested) {\n      return this._stopCompletion;\n    }\n    return this._terminate(reason, () => {\n      this._isStopped = true;\n      if (this._batchRequests.size) {\n        this._batchRequests.forEach((request) => request.reject(reason));\n        this._batchRequests.clear();\n        return;\n      }\n      // save rejection for later batch requests\n      this._entries.push({\n        kind: 'item',\n        settled: { status: 'rejected', reason },\n      });\n    });\n  }\n\n  async forEachBatch(\n    reducer: (generator: Generator<T, void, void>) => PromiseOrValue<void>,\n  ): Promise<void> {\n    const sub = this.subscribe(async (generator) => {\n      const { promise: drained, resolve } =\n        // eslint-disable-next-line @typescript-eslint/no-invalid-void-type\n        promiseWithResolvers<void>();\n\n      const wrappedBatch = (function* wrapper(): Generator<T> {\n        yield* generator;\n        resolve();\n      })();\n\n      await Promise.all([reducer(wrappedBatch), drained]);\n    });\n\n    // Empty loop body is intentionally used to drain the subscription.\n    /* node:coverage ignore next 3 */\n    for await (const _ of sub) {\n      // intentionally empty\n    }\n  }\n\n  setCapacity(nextCapacity: number): void {\n    this._capacity = this._normalizeCapacity(nextCapacity);\n    this._flush();\n  }\n\n  getCapacity(): number {\n    return this._capacity;\n  }\n\n  isStopped(): boolean {\n    return this._isStopped;\n  }\n\n  private _normalizeCapacity(capacity: number): number {\n    return Math.max(1, Math.floor(capacity));\n  }\n\n  private _flush(): void {\n    while (this._waiters.length > 0 && this._backlog < this._capacity) {\n      this._waiters.shift()?.();\n    }\n  }\n\n  private _reserve(): PromiseOrValue<void> {\n    this._backlog += 1;\n    if (this._backlog < this._capacity) {\n      return undefined;\n    }\n    // eslint-disable-next-line @typescript-eslint/no-invalid-void-type\n    const { promise, resolve } = promiseWithResolvers<void>();\n    this._waiters.push(resolve);\n    return promise;\n  }\n\n  private _release(): void {\n    if (this._backlog > 0) {\n      this._backlog -= 1;\n    }\n    this._flush();\n  }\n\n  private _onStop(cleanup: (reason?: unknown) => PromiseOrValue<void>): void {\n    if (this._stopRequested) {\n      throw new Error(\n        'Cannot register onStop cleanup after stop has been requested.',\n      );\n    }\n    this._stopCleanupCallbacks.push(cleanup);\n  }\n\n  private _runStopCleanup(\n    reason: unknown,\n    afterCleanup: () => void,\n  ): PromiseOrValue<void> {\n    this._stopRequested = true;\n    const cleanupPromises = this._stopCleanupCallbacks.flatMap(\n      (cleanupCallback): Array<Promise<unknown>> => {\n        try {\n          const result = cleanupCallback(reason);\n          return isPromise(result) ? [result] : [];\n        } catch {\n          // ignore errors\n          return [];\n        }\n      },\n    );\n    const cleanup =\n      cleanupPromises.length > 0\n        ? Promise.allSettled(cleanupPromises).then(() => undefined)\n        : undefined;\n    if (isPromise(cleanup)) {\n      this._stopCompletion = cleanup\n        .then(afterCleanup, afterCleanup)\n        .then(() => undefined);\n      return this._stopCompletion;\n    }\n    afterCleanup();\n  }\n\n  private async *_iteratorLoop<U>(\n    reducer: (\n      generator: Generator<T, void, void>,\n    ) => PromiseOrValue<U | undefined>,\n  ): AsyncGenerator<U, void, void> {\n    this._resolveStarted();\n    let nextBatch: Generator<T> | undefined;\n    // eslint-disable-next-line no-await-in-loop\n    while ((nextBatch = await this._waitForNextBatch())) {\n      let reduced = reducer(nextBatch);\n      if (isPromise(reduced)) {\n        // eslint-disable-next-line no-await-in-loop\n        reduced = await reduced;\n      }\n      if (reduced === undefined) {\n        continue;\n      }\n      yield reduced;\n    }\n  }\n\n  private _waitForNextBatch(): Promise<Generator<T> | undefined> {\n    const { promise, resolve, reject } = promiseWithResolvers<\n      Generator<T> | undefined\n    >();\n    this._batchRequests.add({ resolve, reject });\n    this._deliverBatchIfReady();\n    return promise;\n  }\n\n  private _push(item: PromiseOrValue<T>): PromiseOrValue<void> {\n    if (this._stopRequested) {\n      return;\n    }\n    const maybePushPromise = this._reserve();\n    if (isPromise(item)) {\n      const entry: ItemEntry<T> = { kind: 'item' };\n      this._entries.push(entry);\n      item.then(\n        (resolved) => {\n          entry.settled = { status: 'fulfilled', value: resolved };\n          this._deliverBatchIfReady();\n        },\n        (reason: unknown) => {\n          entry.settled = { status: 'rejected', reason };\n          this._deliverBatchIfReady();\n        },\n      );\n    } else {\n      this._entries.push({\n        kind: 'item',\n        settled: { status: 'fulfilled', value: item },\n      });\n      this._deliverBatchIfReady();\n    }\n    return maybePushPromise;\n  }\n\n  private _terminate(\n    reason: unknown,\n    afterCleanup: () => void,\n  ): PromiseOrValue<void> {\n    for (const entry of this._entries) {\n      if (entry.kind === 'item') {\n        this._release();\n      }\n    }\n    this._entries.length = 0;\n    return this._runStopCleanup(reason, afterCleanup);\n  }\n\n  private _stop(reason?: unknown): PromiseOrValue<void> {\n    if (this._stopRequested) {\n      return this._stopCompletion;\n    }\n    const stopCompletion = this._runStopCleanup(reason, () => {\n      if (reason === undefined) {\n        if (this._entries.length === 0) {\n          this._isStopped = true;\n          this._deliverBatchIfReady();\n          return;\n        }\n\n        this._entries.push({ kind: 'stop' });\n        this._deliverBatchIfReady();\n        return;\n      }\n\n      this._entries.push({\n        kind: 'item',\n        settled: { status: 'rejected', reason },\n      });\n      this._entries.push({ kind: 'stop' });\n      this._deliverBatchIfReady();\n    });\n\n    if (isPromise(stopCompletion)) {\n      /* node:coverage ignore next */\n      stopCompletion.catch(() => undefined);\n    }\n    return stopCompletion;\n  }\n\n  private _deliverBatchIfReady(): void {\n    if (!this._batchRequests.size) {\n      return;\n    }\n    const headEntry = this._entries[0];\n    const requests = this._batchRequests;\n    if (headEntry !== undefined) {\n      // stop sentinel always follows other work\n      invariant(headEntry.kind !== 'stop');\n\n      const settled = headEntry.settled;\n      if (settled !== undefined) {\n        if (settled.status === 'fulfilled') {\n          this._batchRequests = new Set();\n          requests.forEach((request) => request.resolve(this._drainBatch()));\n          return;\n        }\n        this._entries.shift();\n        this._release();\n        this._isStopped = true;\n        this._batchRequests = new Set();\n        requests.forEach((request) => request.reject(settled.reason));\n      }\n    } else if (this._isStopped) {\n      this._batchRequests = new Set();\n      requests.forEach((request) => request.resolve(undefined));\n    }\n  }\n\n  private *_drainBatch(): Generator<T> {\n    while (true) {\n      const entry = this._entries[0];\n      if (entry === undefined) {\n        return;\n      }\n      if (entry.kind === 'stop') {\n        this._isStopped = true;\n        this._entries.shift();\n        return;\n      }\n      const settled = entry.settled;\n      if (settled === undefined || settled.status === 'rejected') {\n        return;\n      }\n      this._entries.shift();\n      this._release();\n      yield settled.value;\n    }\n  }\n}\n"]}
+{"version":3,"file":"Queue.js","sourceRoot":"","sources":["../../../src/execution/incremental/Queue.ts"],"names":[],"mappings":"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","sourcesContent":["import { invariant } from '../../jsutils/invariant.ts';\nimport { isPromise } from '../../jsutils/isPromise.ts';\nimport type { PromiseOrValue } from '../../jsutils/PromiseOrValue.ts';\nimport { promiseWithResolvers } from '../../jsutils/promiseWithResolvers.ts';\n\nimport { withConcurrentAbruptClose } from '../withConcurrentAbruptClose.ts';\n\ntype Settled<T> =\n  | { status: 'fulfilled'; value: T }\n  | { status: 'rejected'; reason: unknown };\n\ninterface ItemEntry<T> {\n  kind: 'item';\n  settled?: Settled<T>;\n}\n\ninterface StopEntry {\n  kind: 'stop';\n}\n\ntype Entry<T> = ItemEntry<T> | StopEntry;\n\ninterface BatchRequest<T> {\n  resolve: (generator: Generator<T> | undefined) => void;\n  reject: (reason: unknown) => void;\n}\n\ninterface QueueExecutorOptions<T> {\n  push: (item: PromiseOrValue<T>) => PromiseOrValue<void>;\n  stop: (reason?: unknown) => PromiseOrValue<void>;\n  onStop: (cleanup: (reason?: unknown) => PromiseOrValue<void>) => void;\n  started: Promise<void>;\n}\n\n/**\n * A Queue is a lightweight async-generator primitive inspired by Brian Kim's\n * Repeater (https://repeater.js.org, https://github.com/repeaterjs/repeater).\n * The ergonomics are similar, but this implementation favors clarity over\n * performance and gives producers flexibility to remain lazy, become eager, or\n * live somewhere in between.\n *\n * The constructor takes an executor function and an optional `initialCapacity`.\n * Executors receive `{ push, stop, onStop, started }` and may return `void` or\n * a promise if they perform asynchronous setup. They call `push` whenever\n * another item is ready, call `stop` when no more values will be produced\n * (optionally supplying an error), register stop-time cleanup via `onStop`,\n * and await `started` when setup should run only after iteration begins.\n * Because `push`, `stop`, and `onStop` are plain functions, executors can\n * hoist them into outside scopes or pass them to helpers. If the executor\n * throws or its returned promise rejects, the queue treats it as `stop(error)`\n * and propagates the failure.\n *\n * The `initialCapacity` argument (default `1`) governs backpressure. Capacity\n * is the maximum number of buffered items allowed before a push must wait.\n * When the backlog reaches capacity, `push` returns a promise that settles\n * once consumption releases space; otherwise it returns `undefined`. Setting\n * capacity to `1` yields a fully lazy queue (every push waits unless a prior\n * item has been consumed); higher capacities buffer that many items eagerly.\n * Capacity can be changed later via `setCapacity` and observed via\n * `getCapacity`.\n *\n * `subscribe(reducer)` returns an async generator whose batches feed a generator\n * of settled values into the reducer; whatever the reducer returns (other than\n * `undefined`) becomes the yielded value for that batch. Calling `return()` on\n * the subscription settles pending `next` calls thanks to `withConcurrent`,\n * providing direct abort semantics rather than leaving `next()` suspended.\n *\n * 'forEachBatch(reducer)` is a convenience method that subscribes with the\n * given reducer and runs it for each batch until the queue stops.\n *\n * Producers can stay lazy by awaiting `started`, using zero capacity, and\n * awaiting each `push`. Skipping those waits while raising capacity makes the\n * queue eager up to its configured limit. The `isStopped()` helper exposes\n * whether the queue has fully stopped, which can be useful when the reducer\n * function actually performs external work and wants to bail early without\n * awaiting another `next`.\n *\n * @internal\n */\nexport class Queue<T> {\n  private _capacity: number;\n  private _backlog = 0;\n  private _waiters: Array<() => void> = [];\n  private _entries: Array<Entry<T>> = [];\n  private _isStopped = false;\n  private _stopRequested = false;\n  private _stopCleanupCallbacks: Array<\n    (reason?: unknown) => PromiseOrValue<void>\n  > = [];\n  private _stopCompletion: Promise<void> | undefined;\n  private _batchRequests = new Set<BatchRequest<T>>();\n\n  private _resolveStarted: () => void;\n\n  constructor(\n    executor: ({\n      push,\n      stop,\n      onStop,\n      started,\n    }: QueueExecutorOptions<T>) => PromiseOrValue<void>,\n    initialCapacity = 1,\n  ) {\n    this._capacity = this._normalizeCapacity(initialCapacity);\n\n    const { promise: started, resolve: resolveStarted } =\n      // eslint-disable-next-line @typescript-eslint/no-invalid-void-type\n      promiseWithResolvers<void>();\n\n    this._resolveStarted = resolveStarted;\n\n    try {\n      const result = executor({\n        push: this._push.bind(this),\n        stop: this._stop.bind(this),\n        onStop: this._onStop.bind(this),\n        started,\n      });\n      if (isPromise(result)) {\n        result.catch(this._stop.bind(this));\n      }\n    } catch (error) {\n      const stopped = this._stop(error);\n      if (isPromise(stopped)) {\n        /* node:coverage ignore next */\n        stopped.catch(() => undefined);\n      }\n    }\n  }\n\n  subscribe<U>(\n    reducer: (\n      generator: Generator<T, void, void>,\n    ) => PromiseOrValue<U | undefined> = (generator) =>\n      Array.from(generator) as U,\n  ): AsyncGenerator<U, void, void> {\n    const generator = this._iteratorLoop(reducer);\n    return withConcurrentAbruptClose(\n      generator,\n      () => this.cancel(),\n      this.abort.bind(this),\n    );\n  }\n\n  cancel(): PromiseOrValue<void> {\n    if (this._stopRequested) {\n      return this._stopCompletion;\n    }\n    return this._terminate(undefined, () => {\n      this._isStopped = true;\n      this._batchRequests.forEach((request) => request.resolve(undefined));\n      this._batchRequests.clear();\n    });\n  }\n\n  abort(reason?: unknown): PromiseOrValue<void> {\n    if (this._stopRequested) {\n      return this._stopCompletion;\n    }\n    return this._terminate(reason, () => {\n      this._isStopped = true;\n      if (this._batchRequests.size) {\n        this._batchRequests.forEach((request) => request.reject(reason));\n        this._batchRequests.clear();\n        return;\n      }\n      // save rejection for later batch requests\n      this._entries.push({\n        kind: 'item',\n        settled: { status: 'rejected', reason },\n      });\n    });\n  }\n\n  async forEachBatch(\n    reducer: (generator: Generator<T, void, void>) => PromiseOrValue<void>,\n  ): Promise<void> {\n    const sub = this.subscribe(async (generator) => {\n      const { promise: drained, resolve } =\n        // eslint-disable-next-line @typescript-eslint/no-invalid-void-type\n        promiseWithResolvers<void>();\n\n      const wrappedBatch = (function* wrapper(): Generator<T> {\n        yield* generator;\n        resolve();\n      })();\n\n      await Promise.all([reducer(wrappedBatch), drained]);\n    });\n\n    // Empty loop body is intentionally used to drain the subscription.\n    /* node:coverage ignore next 3 */\n    for await (const _ of sub) {\n      // intentionally empty\n    }\n  }\n\n  setCapacity(nextCapacity: number): void {\n    this._capacity = this._normalizeCapacity(nextCapacity);\n    this._flush();\n  }\n\n  getCapacity(): number {\n    return this._capacity;\n  }\n\n  isStopped(): boolean {\n    return this._isStopped;\n  }\n\n  private _normalizeCapacity(capacity: number): number {\n    return Math.max(1, Math.floor(capacity));\n  }\n\n  private _flush(): void {\n    while (this._waiters.length > 0 && this._backlog < this._capacity) {\n      this._waiters.shift()?.();\n    }\n  }\n\n  private _reserve(): PromiseOrValue<void> {\n    this._backlog += 1;\n    if (this._backlog < this._capacity) {\n      return undefined;\n    }\n    // eslint-disable-next-line @typescript-eslint/no-invalid-void-type\n    const { promise, resolve } = promiseWithResolvers<void>();\n    this._waiters.push(resolve);\n    return promise;\n  }\n\n  private _release(): void {\n    if (this._backlog > 0) {\n      this._backlog -= 1;\n    }\n    this._flush();\n  }\n\n  private _onStop(cleanup: (reason?: unknown) => PromiseOrValue<void>): void {\n    if (this._stopRequested) {\n      throw new Error(\n        'Cannot register onStop cleanup after stop has been requested.',\n      );\n    }\n    this._stopCleanupCallbacks.push(cleanup);\n  }\n\n  private _runStopCleanup(\n    reason: unknown,\n    afterCleanup: () => void,\n  ): PromiseOrValue<void> {\n    this._stopRequested = true;\n    const cleanupPromises = this._stopCleanupCallbacks.flatMap(\n      (cleanupCallback): Array<Promise<unknown>> => {\n        try {\n          const result = cleanupCallback(reason);\n          return isPromise(result) ? [result] : [];\n        } catch {\n          // ignore errors\n          return [];\n        }\n      },\n    );\n    const cleanup =\n      cleanupPromises.length > 0\n        ? Promise.allSettled(cleanupPromises).then(() => undefined)\n        : undefined;\n    if (isPromise(cleanup)) {\n      this._stopCompletion = cleanup\n        .then(afterCleanup, afterCleanup)\n        .then(() => undefined);\n      return this._stopCompletion;\n    }\n    afterCleanup();\n  }\n\n  private async *_iteratorLoop<U>(\n    reducer: (\n      generator: Generator<T, void, void>,\n    ) => PromiseOrValue<U | undefined>,\n  ): AsyncGenerator<U, void, void> {\n    this._resolveStarted();\n    let nextBatch: Generator<T> | undefined;\n    // eslint-disable-next-line no-await-in-loop\n    while ((nextBatch = await this._waitForNextBatch())) {\n      let reduced = reducer(nextBatch);\n      if (isPromise(reduced)) {\n        // eslint-disable-next-line no-await-in-loop\n        reduced = await reduced;\n      }\n      if (reduced === undefined) {\n        continue;\n      }\n      yield reduced;\n    }\n  }\n\n  private _waitForNextBatch(): Promise<Generator<T> | undefined> {\n    const { promise, resolve, reject } = promiseWithResolvers<\n      Generator<T> | undefined\n    >();\n    this._batchRequests.add({ resolve, reject });\n    this._deliverBatchIfReady();\n    return promise;\n  }\n\n  private _push(item: PromiseOrValue<T>): PromiseOrValue<void> {\n    if (this._stopRequested) {\n      return;\n    }\n    const maybePushPromise = this._reserve();\n    if (isPromise(item)) {\n      const entry: ItemEntry<T> = { kind: 'item' };\n      this._entries.push(entry);\n      item.then(\n        (resolved) => {\n          entry.settled = { status: 'fulfilled', value: resolved };\n          this._deliverBatchIfReady();\n        },\n        (reason: unknown) => {\n          entry.settled = { status: 'rejected', reason };\n          this._deliverBatchIfReady();\n        },\n      );\n    } else {\n      this._entries.push({\n        kind: 'item',\n        settled: { status: 'fulfilled', value: item },\n      });\n      this._deliverBatchIfReady();\n    }\n    return maybePushPromise;\n  }\n\n  private _terminate(\n    reason: unknown,\n    afterCleanup: () => void,\n  ): PromiseOrValue<void> {\n    for (const entry of this._entries) {\n      if (entry.kind === 'item') {\n        this._release();\n      }\n    }\n    this._entries.length = 0;\n    return this._runStopCleanup(reason, afterCleanup);\n  }\n\n  private _stop(reason?: unknown): PromiseOrValue<void> {\n    if (this._stopRequested) {\n      return this._stopCompletion;\n    }\n    const stopCompletion = this._runStopCleanup(reason, () => {\n      if (reason === undefined) {\n        if (this._entries.length === 0) {\n          this._isStopped = true;\n          this._deliverBatchIfReady();\n          return;\n        }\n\n        this._entries.push({ kind: 'stop' });\n        this._deliverBatchIfReady();\n        return;\n      }\n\n      this._entries.push({\n        kind: 'item',\n        settled: { status: 'rejected', reason },\n      });\n      this._entries.push({ kind: 'stop' });\n      this._deliverBatchIfReady();\n    });\n\n    if (isPromise(stopCompletion)) {\n      /* node:coverage ignore next */\n      stopCompletion.catch(() => undefined);\n    }\n    return stopCompletion;\n  }\n\n  private _deliverBatchIfReady(): void {\n    if (!this._batchRequests.size) {\n      return;\n    }\n    const headEntry = this._entries[0];\n    const requests = this._batchRequests;\n    if (headEntry !== undefined) {\n      // stop sentinel always follows other work\n      invariant(headEntry.kind !== 'stop');\n\n      const settled = headEntry.settled;\n      if (settled !== undefined) {\n        if (settled.status === 'fulfilled') {\n          this._batchRequests = new Set();\n          requests.forEach((request) => request.resolve(this._drainBatch()));\n          return;\n        }\n        this._entries.shift();\n        this._release();\n        this._isStopped = true;\n        this._batchRequests = new Set();\n        requests.forEach((request) => request.reject(settled.reason));\n      }\n    } else if (this._isStopped) {\n      this._batchRequests = new Set();\n      requests.forEach((request) => request.resolve(undefined));\n    }\n  }\n\n  private *_drainBatch(): Generator<T> {\n    while (true) {\n      const entry = this._entries[0];\n      if (entry === undefined) {\n        return;\n      }\n      if (entry.kind === 'stop') {\n        this._isStopped = true;\n        this._entries.shift();\n        return;\n      }\n      const settled = entry.settled;\n      if (settled === undefined || settled.status === 'rejected') {\n        return;\n      }\n      this._entries.shift();\n      this._release();\n      yield settled.value;\n    }\n  }\n}\n"]}

package/execution/incremental/Queue.mjs

@@ -2,51 +2,6 @@ import { invariant } from "../../jsutils/invariant.mjs";
 import { isPromise } from "../../jsutils/isPromise.mjs";
 import { promiseWithResolvers } from "../../jsutils/promiseWithResolvers.mjs";
 import { withConcurrentAbruptClose } from "../withConcurrentAbruptClose.mjs";
-/**
- * A Queue is a lightweight async-generator primitive inspired by Brian Kim's
- * Repeater (https://repeater.js.org, https://github.com/repeaterjs/repeater).
- * The ergonomics are similar, but this implementation favors clarity over
- * performance and gives producers flexibility to remain lazy, become eager, or
- * live somewhere in between.
- *
- * The constructor takes an executor function and an optional `initialCapacity`.
- * Executors receive `{ push, stop, onStop, started }` and may return `void` or
- * a promise if they perform asynchronous setup. They call `push` whenever
- * another item is ready, call `stop` when no more values will be produced
- * (optionally supplying an error), register stop-time cleanup via `onStop`,
- * and await `started` when setup should run only after iteration begins.
- * Because `push`, `stop`, and `onStop` are plain functions, executors can
- * hoist them into outside scopes or pass them to helpers. If the executor
- * throws or its returned promise rejects, the queue treats it as `stop(error)`
- * and propagates the failure.
- *
- * The `initialCapacity` argument (default `1`) governs backpressure. Capacity
- * is the maximum number of buffered items allowed before a push must wait.
- * When the backlog reaches capacity, `push` returns a promise that settles
- * once consumption releases space; otherwise it returns `undefined`. Setting
- * capacity to `1` yields a fully lazy queue (every push waits unless a prior
- * item has been consumed); higher capacities buffer that many items eagerly.
- * Capacity can be changed later via `setCapacity` and observed via
- * `getCapacity`.
- *
- * `subscribe(reducer)` returns an async generator whose batches feed a generator
- * of settled values into the reducer; whatever the reducer returns (other than
- * `undefined`) becomes the yielded value for that batch. Calling `return()` on
- * the subscription settles pending `next` calls thanks to `withConcurrent`,
- * providing direct abort semantics rather than leaving `next()` suspended.
- *
- * 'forEachBatch(reducer)` is a convenience method that subscribes with the
- * given reducer and runs it for each batch until the queue stops.
- *
- * Producers can stay lazy by awaiting `started`, using zero capacity, and
- * awaiting each `push`. Skipping those waits while raising capacity makes the
- * queue eager up to its configured limit. The `isStopped()` helper exposes
- * whether the queue has fully stopped, which can be useful when the reducer
- * function actually performs external work and wants to bail early without
- * awaiting another `next`.
- *
- * @internal
- */
 export class Queue {
     constructor(executor, initialCapacity = 1) {
         this._backlog = 0;
@@ -57,9 +12,7 @@ export class Queue {
         this._stopCleanupCallbacks = [];
         this._batchRequests = new Set();
         this._capacity = this._normalizeCapacity(initialCapacity);
-        const { promise: started, resolve: resolveStarted } = 
-        // eslint-disable-next-line @typescript-eslint/no-invalid-void-type
-        promiseWithResolvers();
+        const { promise: started, resolve: resolveStarted } = promiseWithResolvers();
         this._resolveStarted = resolveStarted;
         try {
             const result = executor({
@@ -75,7 +28,6 @@ export class Queue {
         catch (error) {
             const stopped = this._stop(error);
             if (isPromise(stopped)) {
-                /* node:coverage ignore next */
                 stopped.catch(() => undefined);
             }
         }
@@ -105,7 +57,6 @@ export class Queue {
                 this._batchRequests.clear();
                 return;
             }
-            // save rejection for later batch requests
             this._entries.push({
                 kind: 'item',
                 settled: { status: 'rejected', reason },
@@ -114,19 +65,14 @@ export class Queue {
     }
     async forEachBatch(reducer) {
         const sub = this.subscribe(async (generator) => {
-            const { promise: drained, resolve } = 
-            // eslint-disable-next-line @typescript-eslint/no-invalid-void-type
-            promiseWithResolvers();
+            const { promise: drained, resolve } = promiseWithResolvers();
             const wrappedBatch = (function* wrapper() {
                 yield* generator;
                 resolve();
             })();
             await Promise.all([reducer(wrappedBatch), drained]);
         });
-        // Empty loop body is intentionally used to drain the subscription.
-        /* node:coverage ignore next 3 */
         for await (const _ of sub) {
-            // intentionally empty
         }
     }
     setCapacity(nextCapacity) {
@@ -152,7 +98,6 @@ export class Queue {
         if (this._backlog < this._capacity) {
             return undefined;
         }
-        // eslint-disable-next-line @typescript-eslint/no-invalid-void-type
         const { promise, resolve } = promiseWithResolvers();
         this._waiters.push(resolve);
         return promise;
@@ -177,7 +122,6 @@ export class Queue {
                 return isPromise(result) ? [result] : [];
             }
             catch {
-                // ignore errors
                 return [];
             }
         });
@@ -195,11 +139,9 @@ export class Queue {
     async *_iteratorLoop(reducer) {
         this._resolveStarted();
         let nextBatch;
-        // eslint-disable-next-line no-await-in-loop
         while ((nextBatch = await this._waitForNextBatch())) {
             let reduced = reducer(nextBatch);
             if (isPromise(reduced)) {
-                // eslint-disable-next-line no-await-in-loop
                 reduced = await reduced;
             }
             if (reduced === undefined) {
@@ -271,7 +213,6 @@ export class Queue {
             this._deliverBatchIfReady();
         });
         if (isPromise(stopCompletion)) {
-            /* node:coverage ignore next */
             stopCompletion.catch(() => undefined);
         }
         return stopCompletion;
@@ -284,7 +225,6 @@ export class Queue {
         const requests = this._batchRequests;
         if (headEntry !== undefined) {
             if (!(headEntry.kind !== 'stop'))
-                // stop sentinel always follows other work
                 invariant(false);
             const settled = headEntry.settled;
             if (settled !== undefined) {

package/execution/incremental/Queue.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Queue.js","sourceRoot":"","sources":["../../../src/execution/incremental/Queue.ts"],"names":[],"mappings":"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","sourcesContent":["import { invariant } from '../../jsutils/invariant.ts';\nimport { isPromise } from '../../jsutils/isPromise.ts';\nimport type { PromiseOrValue } from '../../jsutils/PromiseOrValue.ts';\nimport { promiseWithResolvers } from '../../jsutils/promiseWithResolvers.ts';\n\nimport { withConcurrentAbruptClose } from '../withConcurrentAbruptClose.ts';\n\ntype Settled<T> =\n  | { status: 'fulfilled'; value: T }\n  | { status: 'rejected'; reason: unknown };\n\ninterface ItemEntry<T> {\n  kind: 'item';\n  settled?: Settled<T>;\n}\n\ninterface StopEntry {\n  kind: 'stop';\n}\n\ntype Entry<T> = ItemEntry<T> | StopEntry;\n\ninterface BatchRequest<T> {\n  resolve: (generator: Generator<T> | undefined) => void;\n  reject: (reason: unknown) => void;\n}\n\ninterface QueueExecutorOptions<T> {\n  push: (item: PromiseOrValue<T>) => PromiseOrValue<void>;\n  stop: (reason?: unknown) => PromiseOrValue<void>;\n  onStop: (cleanup: (reason?: unknown) => PromiseOrValue<void>) => void;\n  started: Promise<void>;\n}\n\n/**\n * A Queue is a lightweight async-generator primitive inspired by Brian Kim's\n * Repeater (https://repeater.js.org, https://github.com/repeaterjs/repeater).\n * The ergonomics are similar, but this implementation favors clarity over\n * performance and gives producers flexibility to remain lazy, become eager, or\n * live somewhere in between.\n *\n * The constructor takes an executor function and an optional `initialCapacity`.\n * Executors receive `{ push, stop, onStop, started }` and may return `void` or\n * a promise if they perform asynchronous setup. They call `push` whenever\n * another item is ready, call `stop` when no more values will be produced\n * (optionally supplying an error), register stop-time cleanup via `onStop`,\n * and await `started` when setup should run only after iteration begins.\n * Because `push`, `stop`, and `onStop` are plain functions, executors can\n * hoist them into outside scopes or pass them to helpers. If the executor\n * throws or its returned promise rejects, the queue treats it as `stop(error)`\n * and propagates the failure.\n *\n * The `initialCapacity` argument (default `1`) governs backpressure. Capacity\n * is the maximum number of buffered items allowed before a push must wait.\n * When the backlog reaches capacity, `push` returns a promise that settles\n * once consumption releases space; otherwise it returns `undefined`. Setting\n * capacity to `1` yields a fully lazy queue (every push waits unless a prior\n * item has been consumed); higher capacities buffer that many items eagerly.\n * Capacity can be changed later via `setCapacity` and observed via\n * `getCapacity`.\n *\n * `subscribe(reducer)` returns an async generator whose batches feed a generator\n * of settled values into the reducer; whatever the reducer returns (other than\n * `undefined`) becomes the yielded value for that batch. Calling `return()` on\n * the subscription settles pending `next` calls thanks to `withConcurrent`,\n * providing direct abort semantics rather than leaving `next()` suspended.\n *\n * 'forEachBatch(reducer)` is a convenience method that subscribes with the\n * given reducer and runs it for each batch until the queue stops.\n *\n * Producers can stay lazy by awaiting `started`, using zero capacity, and\n * awaiting each `push`. Skipping those waits while raising capacity makes the\n * queue eager up to its configured limit. The `isStopped()` helper exposes\n * whether the queue has fully stopped, which can be useful when the reducer\n * function actually performs external work and wants to bail early without\n * awaiting another `next`.\n *\n * @internal\n */\nexport class Queue<T> {\n  private _capacity: number;\n  private _backlog = 0;\n  private _waiters: Array<() => void> = [];\n  private _entries: Array<Entry<T>> = [];\n  private _isStopped = false;\n  private _stopRequested = false;\n  private _stopCleanupCallbacks: Array<\n    (reason?: unknown) => PromiseOrValue<void>\n  > = [];\n  private _stopCompletion: Promise<void> | undefined;\n  private _batchRequests = new Set<BatchRequest<T>>();\n\n  private _resolveStarted: () => void;\n\n  constructor(\n    executor: ({\n      push,\n      stop,\n      onStop,\n      started,\n    }: QueueExecutorOptions<T>) => PromiseOrValue<void>,\n    initialCapacity = 1,\n  ) {\n    this._capacity = this._normalizeCapacity(initialCapacity);\n\n    const { promise: started, resolve: resolveStarted } =\n      // eslint-disable-next-line @typescript-eslint/no-invalid-void-type\n      promiseWithResolvers<void>();\n\n    this._resolveStarted = resolveStarted;\n\n    try {\n      const result = executor({\n        push: this._push.bind(this),\n        stop: this._stop.bind(this),\n        onStop: this._onStop.bind(this),\n        started,\n      });\n      if (isPromise(result)) {\n        result.catch(this._stop.bind(this));\n      }\n    } catch (error) {\n      const stopped = this._stop(error);\n      if (isPromise(stopped)) {\n        /* node:coverage ignore next */\n        stopped.catch(() => undefined);\n      }\n    }\n  }\n\n  subscribe<U>(\n    reducer: (\n      generator: Generator<T, void, void>,\n    ) => PromiseOrValue<U | undefined> = (generator) =>\n      Array.from(generator) as U,\n  ): AsyncGenerator<U, void, void> {\n    const generator = this._iteratorLoop(reducer);\n    return withConcurrentAbruptClose(\n      generator,\n      () => this.cancel(),\n      this.abort.bind(this),\n    );\n  }\n\n  cancel(): PromiseOrValue<void> {\n    if (this._stopRequested) {\n      return this._stopCompletion;\n    }\n    return this._terminate(undefined, () => {\n      this._isStopped = true;\n      this._batchRequests.forEach((request) => request.resolve(undefined));\n      this._batchRequests.clear();\n    });\n  }\n\n  abort(reason?: unknown): PromiseOrValue<void> {\n    if (this._stopRequested) {\n      return this._stopCompletion;\n    }\n    return this._terminate(reason, () => {\n      this._isStopped = true;\n      if (this._batchRequests.size) {\n        this._batchRequests.forEach((request) => request.reject(reason));\n        this._batchRequests.clear();\n        return;\n      }\n      // save rejection for later batch requests\n      this._entries.push({\n        kind: 'item',\n        settled: { status: 'rejected', reason },\n      });\n    });\n  }\n\n  async forEachBatch(\n    reducer: (generator: Generator<T, void, void>) => PromiseOrValue<void>,\n  ): Promise<void> {\n    const sub = this.subscribe(async (generator) => {\n      const { promise: drained, resolve } =\n        // eslint-disable-next-line @typescript-eslint/no-invalid-void-type\n        promiseWithResolvers<void>();\n\n      const wrappedBatch = (function* wrapper(): Generator<T> {\n        yield* generator;\n        resolve();\n      })();\n\n      await Promise.all([reducer(wrappedBatch), drained]);\n    });\n\n    // Empty loop body is intentionally used to drain the subscription.\n    /* node:coverage ignore next 3 */\n    for await (const _ of sub) {\n      // intentionally empty\n    }\n  }\n\n  setCapacity(nextCapacity: number): void {\n    this._capacity = this._normalizeCapacity(nextCapacity);\n    this._flush();\n  }\n\n  getCapacity(): number {\n    return this._capacity;\n  }\n\n  isStopped(): boolean {\n    return this._isStopped;\n  }\n\n  private _normalizeCapacity(capacity: number): number {\n    return Math.max(1, Math.floor(capacity));\n  }\n\n  private _flush(): void {\n    while (this._waiters.length > 0 && this._backlog < this._capacity) {\n      this._waiters.shift()?.();\n    }\n  }\n\n  private _reserve(): PromiseOrValue<void> {\n    this._backlog += 1;\n    if (this._backlog < this._capacity) {\n      return undefined;\n    }\n    // eslint-disable-next-line @typescript-eslint/no-invalid-void-type\n    const { promise, resolve } = promiseWithResolvers<void>();\n    this._waiters.push(resolve);\n    return promise;\n  }\n\n  private _release(): void {\n    if (this._backlog > 0) {\n      this._backlog -= 1;\n    }\n    this._flush();\n  }\n\n  private _onStop(cleanup: (reason?: unknown) => PromiseOrValue<void>): void {\n    if (this._stopRequested) {\n      throw new Error(\n        'Cannot register onStop cleanup after stop has been requested.',\n      );\n    }\n    this._stopCleanupCallbacks.push(cleanup);\n  }\n\n  private _runStopCleanup(\n    reason: unknown,\n    afterCleanup: () => void,\n  ): PromiseOrValue<void> {\n    this._stopRequested = true;\n    const cleanupPromises = this._stopCleanupCallbacks.flatMap(\n      (cleanupCallback): Array<Promise<unknown>> => {\n        try {\n          const result = cleanupCallback(reason);\n          return isPromise(result) ? [result] : [];\n        } catch {\n          // ignore errors\n          return [];\n        }\n      },\n    );\n    const cleanup =\n      cleanupPromises.length > 0\n        ? Promise.allSettled(cleanupPromises).then(() => undefined)\n        : undefined;\n    if (isPromise(cleanup)) {\n      this._stopCompletion = cleanup\n        .then(afterCleanup, afterCleanup)\n        .then(() => undefined);\n      return this._stopCompletion;\n    }\n    afterCleanup();\n  }\n\n  private async *_iteratorLoop<U>(\n    reducer: (\n      generator: Generator<T, void, void>,\n    ) => PromiseOrValue<U | undefined>,\n  ): AsyncGenerator<U, void, void> {\n    this._resolveStarted();\n    let nextBatch: Generator<T> | undefined;\n    // eslint-disable-next-line no-await-in-loop\n    while ((nextBatch = await this._waitForNextBatch())) {\n      let reduced = reducer(nextBatch);\n      if (isPromise(reduced)) {\n        // eslint-disable-next-line no-await-in-loop\n        reduced = await reduced;\n      }\n      if (reduced === undefined) {\n        continue;\n      }\n      yield reduced;\n    }\n  }\n\n  private _waitForNextBatch(): Promise<Generator<T> | undefined> {\n    const { promise, resolve, reject } = promiseWithResolvers<\n      Generator<T> | undefined\n    >();\n    this._batchRequests.add({ resolve, reject });\n    this._deliverBatchIfReady();\n    return promise;\n  }\n\n  private _push(item: PromiseOrValue<T>): PromiseOrValue<void> {\n    if (this._stopRequested) {\n      return;\n    }\n    const maybePushPromise = this._reserve();\n    if (isPromise(item)) {\n      const entry: ItemEntry<T> = { kind: 'item' };\n      this._entries.push(entry);\n      item.then(\n        (resolved) => {\n          entry.settled = { status: 'fulfilled', value: resolved };\n          this._deliverBatchIfReady();\n        },\n        (reason: unknown) => {\n          entry.settled = { status: 'rejected', reason };\n          this._deliverBatchIfReady();\n        },\n      );\n    } else {\n      this._entries.push({\n        kind: 'item',\n        settled: { status: 'fulfilled', value: item },\n      });\n      this._deliverBatchIfReady();\n    }\n    return maybePushPromise;\n  }\n\n  private _terminate(\n    reason: unknown,\n    afterCleanup: () => void,\n  ): PromiseOrValue<void> {\n    for (const entry of this._entries) {\n      if (entry.kind === 'item') {\n        this._release();\n      }\n    }\n    this._entries.length = 0;\n    return this._runStopCleanup(reason, afterCleanup);\n  }\n\n  private _stop(reason?: unknown): PromiseOrValue<void> {\n    if (this._stopRequested) {\n      return this._stopCompletion;\n    }\n    const stopCompletion = this._runStopCleanup(reason, () => {\n      if (reason === undefined) {\n        if (this._entries.length === 0) {\n          this._isStopped = true;\n          this._deliverBatchIfReady();\n          return;\n        }\n\n        this._entries.push({ kind: 'stop' });\n        this._deliverBatchIfReady();\n        return;\n      }\n\n      this._entries.push({\n        kind: 'item',\n        settled: { status: 'rejected', reason },\n      });\n      this._entries.push({ kind: 'stop' });\n      this._deliverBatchIfReady();\n    });\n\n    if (isPromise(stopCompletion)) {\n      /* node:coverage ignore next */\n      stopCompletion.catch(() => undefined);\n    }\n    return stopCompletion;\n  }\n\n  private _deliverBatchIfReady(): void {\n    if (!this._batchRequests.size) {\n      return;\n    }\n    const headEntry = this._entries[0];\n    const requests = this._batchRequests;\n    if (headEntry !== undefined) {\n      // stop sentinel always follows other work\n      invariant(headEntry.kind !== 'stop');\n\n      const settled = headEntry.settled;\n      if (settled !== undefined) {\n        if (settled.status === 'fulfilled') {\n          this._batchRequests = new Set();\n          requests.forEach((request) => request.resolve(this._drainBatch()));\n          return;\n        }\n        this._entries.shift();\n        this._release();\n        this._isStopped = true;\n        this._batchRequests = new Set();\n        requests.forEach((request) => request.reject(settled.reason));\n      }\n    } else if (this._isStopped) {\n      this._batchRequests = new Set();\n      requests.forEach((request) => request.resolve(undefined));\n    }\n  }\n\n  private *_drainBatch(): Generator<T> {\n    while (true) {\n      const entry = this._entries[0];\n      if (entry === undefined) {\n        return;\n      }\n      if (entry.kind === 'stop') {\n        this._isStopped = true;\n        this._entries.shift();\n        return;\n      }\n      const settled = entry.settled;\n      if (settled === undefined || settled.status === 'rejected') {\n        return;\n      }\n      this._entries.shift();\n      this._release();\n      yield settled.value;\n    }\n  }\n}\n"]}
+{"version":3,"file":"Queue.js","sourceRoot":"","sources":["../../../src/execution/incremental/Queue.ts"],"names":[],"mappings":"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","sourcesContent":["import { invariant } from '../../jsutils/invariant.ts';\nimport { isPromise } from '../../jsutils/isPromise.ts';\nimport type { PromiseOrValue } from '../../jsutils/PromiseOrValue.ts';\nimport { promiseWithResolvers } from '../../jsutils/promiseWithResolvers.ts';\n\nimport { withConcurrentAbruptClose } from '../withConcurrentAbruptClose.ts';\n\ntype Settled<T> =\n  | { status: 'fulfilled'; value: T }\n  | { status: 'rejected'; reason: unknown };\n\ninterface ItemEntry<T> {\n  kind: 'item';\n  settled?: Settled<T>;\n}\n\ninterface StopEntry {\n  kind: 'stop';\n}\n\ntype Entry<T> = ItemEntry<T> | StopEntry;\n\ninterface BatchRequest<T> {\n  resolve: (generator: Generator<T> | undefined) => void;\n  reject: (reason: unknown) => void;\n}\n\ninterface QueueExecutorOptions<T> {\n  push: (item: PromiseOrValue<T>) => PromiseOrValue<void>;\n  stop: (reason?: unknown) => PromiseOrValue<void>;\n  onStop: (cleanup: (reason?: unknown) => PromiseOrValue<void>) => void;\n  started: Promise<void>;\n}\n\n/**\n * A Queue is a lightweight async-generator primitive inspired by Brian Kim's\n * Repeater (https://repeater.js.org, https://github.com/repeaterjs/repeater).\n * The ergonomics are similar, but this implementation favors clarity over\n * performance and gives producers flexibility to remain lazy, become eager, or\n * live somewhere in between.\n *\n * The constructor takes an executor function and an optional `initialCapacity`.\n * Executors receive `{ push, stop, onStop, started }` and may return `void` or\n * a promise if they perform asynchronous setup. They call `push` whenever\n * another item is ready, call `stop` when no more values will be produced\n * (optionally supplying an error), register stop-time cleanup via `onStop`,\n * and await `started` when setup should run only after iteration begins.\n * Because `push`, `stop`, and `onStop` are plain functions, executors can\n * hoist them into outside scopes or pass them to helpers. If the executor\n * throws or its returned promise rejects, the queue treats it as `stop(error)`\n * and propagates the failure.\n *\n * The `initialCapacity` argument (default `1`) governs backpressure. Capacity\n * is the maximum number of buffered items allowed before a push must wait.\n * When the backlog reaches capacity, `push` returns a promise that settles\n * once consumption releases space; otherwise it returns `undefined`. Setting\n * capacity to `1` yields a fully lazy queue (every push waits unless a prior\n * item has been consumed); higher capacities buffer that many items eagerly.\n * Capacity can be changed later via `setCapacity` and observed via\n * `getCapacity`.\n *\n * `subscribe(reducer)` returns an async generator whose batches feed a generator\n * of settled values into the reducer; whatever the reducer returns (other than\n * `undefined`) becomes the yielded value for that batch. Calling `return()` on\n * the subscription settles pending `next` calls thanks to `withConcurrent`,\n * providing direct abort semantics rather than leaving `next()` suspended.\n *\n * 'forEachBatch(reducer)` is a convenience method that subscribes with the\n * given reducer and runs it for each batch until the queue stops.\n *\n * Producers can stay lazy by awaiting `started`, using zero capacity, and\n * awaiting each `push`. Skipping those waits while raising capacity makes the\n * queue eager up to its configured limit. The `isStopped()` helper exposes\n * whether the queue has fully stopped, which can be useful when the reducer\n * function actually performs external work and wants to bail early without\n * awaiting another `next`.\n *\n * @internal\n */\nexport class Queue<T> {\n  private _capacity: number;\n  private _backlog = 0;\n  private _waiters: Array<() => void> = [];\n  private _entries: Array<Entry<T>> = [];\n  private _isStopped = false;\n  private _stopRequested = false;\n  private _stopCleanupCallbacks: Array<\n    (reason?: unknown) => PromiseOrValue<void>\n  > = [];\n  private _stopCompletion: Promise<void> | undefined;\n  private _batchRequests = new Set<BatchRequest<T>>();\n\n  private _resolveStarted: () => void;\n\n  constructor(\n    executor: ({\n      push,\n      stop,\n      onStop,\n      started,\n    }: QueueExecutorOptions<T>) => PromiseOrValue<void>,\n    initialCapacity = 1,\n  ) {\n    this._capacity = this._normalizeCapacity(initialCapacity);\n\n    const { promise: started, resolve: resolveStarted } =\n      // eslint-disable-next-line @typescript-eslint/no-invalid-void-type\n      promiseWithResolvers<void>();\n\n    this._resolveStarted = resolveStarted;\n\n    try {\n      const result = executor({\n        push: this._push.bind(this),\n        stop: this._stop.bind(this),\n        onStop: this._onStop.bind(this),\n        started,\n      });\n      if (isPromise(result)) {\n        result.catch(this._stop.bind(this));\n      }\n    } catch (error) {\n      const stopped = this._stop(error);\n      if (isPromise(stopped)) {\n        /* node:coverage ignore next */\n        stopped.catch(() => undefined);\n      }\n    }\n  }\n\n  subscribe<U>(\n    reducer: (\n      generator: Generator<T, void, void>,\n    ) => PromiseOrValue<U | undefined> = (generator) =>\n      Array.from(generator) as U,\n  ): AsyncGenerator<U, void, void> {\n    const generator = this._iteratorLoop(reducer);\n    return withConcurrentAbruptClose(\n      generator,\n      () => this.cancel(),\n      this.abort.bind(this),\n    );\n  }\n\n  cancel(): PromiseOrValue<void> {\n    if (this._stopRequested) {\n      return this._stopCompletion;\n    }\n    return this._terminate(undefined, () => {\n      this._isStopped = true;\n      this._batchRequests.forEach((request) => request.resolve(undefined));\n      this._batchRequests.clear();\n    });\n  }\n\n  abort(reason?: unknown): PromiseOrValue<void> {\n    if (this._stopRequested) {\n      return this._stopCompletion;\n    }\n    return this._terminate(reason, () => {\n      this._isStopped = true;\n      if (this._batchRequests.size) {\n        this._batchRequests.forEach((request) => request.reject(reason));\n        this._batchRequests.clear();\n        return;\n      }\n      // save rejection for later batch requests\n      this._entries.push({\n        kind: 'item',\n        settled: { status: 'rejected', reason },\n      });\n    });\n  }\n\n  async forEachBatch(\n    reducer: (generator: Generator<T, void, void>) => PromiseOrValue<void>,\n  ): Promise<void> {\n    const sub = this.subscribe(async (generator) => {\n      const { promise: drained, resolve } =\n        // eslint-disable-next-line @typescript-eslint/no-invalid-void-type\n        promiseWithResolvers<void>();\n\n      const wrappedBatch = (function* wrapper(): Generator<T> {\n        yield* generator;\n        resolve();\n      })();\n\n      await Promise.all([reducer(wrappedBatch), drained]);\n    });\n\n    // Empty loop body is intentionally used to drain the subscription.\n    /* node:coverage ignore next 3 */\n    for await (const _ of sub) {\n      // intentionally empty\n    }\n  }\n\n  setCapacity(nextCapacity: number): void {\n    this._capacity = this._normalizeCapacity(nextCapacity);\n    this._flush();\n  }\n\n  getCapacity(): number {\n    return this._capacity;\n  }\n\n  isStopped(): boolean {\n    return this._isStopped;\n  }\n\n  private _normalizeCapacity(capacity: number): number {\n    return Math.max(1, Math.floor(capacity));\n  }\n\n  private _flush(): void {\n    while (this._waiters.length > 0 && this._backlog < this._capacity) {\n      this._waiters.shift()?.();\n    }\n  }\n\n  private _reserve(): PromiseOrValue<void> {\n    this._backlog += 1;\n    if (this._backlog < this._capacity) {\n      return undefined;\n    }\n    // eslint-disable-next-line @typescript-eslint/no-invalid-void-type\n    const { promise, resolve } = promiseWithResolvers<void>();\n    this._waiters.push(resolve);\n    return promise;\n  }\n\n  private _release(): void {\n    if (this._backlog > 0) {\n      this._backlog -= 1;\n    }\n    this._flush();\n  }\n\n  private _onStop(cleanup: (reason?: unknown) => PromiseOrValue<void>): void {\n    if (this._stopRequested) {\n      throw new Error(\n        'Cannot register onStop cleanup after stop has been requested.',\n      );\n    }\n    this._stopCleanupCallbacks.push(cleanup);\n  }\n\n  private _runStopCleanup(\n    reason: unknown,\n    afterCleanup: () => void,\n  ): PromiseOrValue<void> {\n    this._stopRequested = true;\n    const cleanupPromises = this._stopCleanupCallbacks.flatMap(\n      (cleanupCallback): Array<Promise<unknown>> => {\n        try {\n          const result = cleanupCallback(reason);\n          return isPromise(result) ? [result] : [];\n        } catch {\n          // ignore errors\n          return [];\n        }\n      },\n    );\n    const cleanup =\n      cleanupPromises.length > 0\n        ? Promise.allSettled(cleanupPromises).then(() => undefined)\n        : undefined;\n    if (isPromise(cleanup)) {\n      this._stopCompletion = cleanup\n        .then(afterCleanup, afterCleanup)\n        .then(() => undefined);\n      return this._stopCompletion;\n    }\n    afterCleanup();\n  }\n\n  private async *_iteratorLoop<U>(\n    reducer: (\n      generator: Generator<T, void, void>,\n    ) => PromiseOrValue<U | undefined>,\n  ): AsyncGenerator<U, void, void> {\n    this._resolveStarted();\n    let nextBatch: Generator<T> | undefined;\n    // eslint-disable-next-line no-await-in-loop\n    while ((nextBatch = await this._waitForNextBatch())) {\n      let reduced = reducer(nextBatch);\n      if (isPromise(reduced)) {\n        // eslint-disable-next-line no-await-in-loop\n        reduced = await reduced;\n      }\n      if (reduced === undefined) {\n        continue;\n      }\n      yield reduced;\n    }\n  }\n\n  private _waitForNextBatch(): Promise<Generator<T> | undefined> {\n    const { promise, resolve, reject } = promiseWithResolvers<\n      Generator<T> | undefined\n    >();\n    this._batchRequests.add({ resolve, reject });\n    this._deliverBatchIfReady();\n    return promise;\n  }\n\n  private _push(item: PromiseOrValue<T>): PromiseOrValue<void> {\n    if (this._stopRequested) {\n      return;\n    }\n    const maybePushPromise = this._reserve();\n    if (isPromise(item)) {\n      const entry: ItemEntry<T> = { kind: 'item' };\n      this._entries.push(entry);\n      item.then(\n        (resolved) => {\n          entry.settled = { status: 'fulfilled', value: resolved };\n          this._deliverBatchIfReady();\n        },\n        (reason: unknown) => {\n          entry.settled = { status: 'rejected', reason };\n          this._deliverBatchIfReady();\n        },\n      );\n    } else {\n      this._entries.push({\n        kind: 'item',\n        settled: { status: 'fulfilled', value: item },\n      });\n      this._deliverBatchIfReady();\n    }\n    return maybePushPromise;\n  }\n\n  private _terminate(\n    reason: unknown,\n    afterCleanup: () => void,\n  ): PromiseOrValue<void> {\n    for (const entry of this._entries) {\n      if (entry.kind === 'item') {\n        this._release();\n      }\n    }\n    this._entries.length = 0;\n    return this._runStopCleanup(reason, afterCleanup);\n  }\n\n  private _stop(reason?: unknown): PromiseOrValue<void> {\n    if (this._stopRequested) {\n      return this._stopCompletion;\n    }\n    const stopCompletion = this._runStopCleanup(reason, () => {\n      if (reason === undefined) {\n        if (this._entries.length === 0) {\n          this._isStopped = true;\n          this._deliverBatchIfReady();\n          return;\n        }\n\n        this._entries.push({ kind: 'stop' });\n        this._deliverBatchIfReady();\n        return;\n      }\n\n      this._entries.push({\n        kind: 'item',\n        settled: { status: 'rejected', reason },\n      });\n      this._entries.push({ kind: 'stop' });\n      this._deliverBatchIfReady();\n    });\n\n    if (isPromise(stopCompletion)) {\n      /* node:coverage ignore next */\n      stopCompletion.catch(() => undefined);\n    }\n    return stopCompletion;\n  }\n\n  private _deliverBatchIfReady(): void {\n    if (!this._batchRequests.size) {\n      return;\n    }\n    const headEntry = this._entries[0];\n    const requests = this._batchRequests;\n    if (headEntry !== undefined) {\n      // stop sentinel always follows other work\n      invariant(headEntry.kind !== 'stop');\n\n      const settled = headEntry.settled;\n      if (settled !== undefined) {\n        if (settled.status === 'fulfilled') {\n          this._batchRequests = new Set();\n          requests.forEach((request) => request.resolve(this._drainBatch()));\n          return;\n        }\n        this._entries.shift();\n        this._release();\n        this._isStopped = true;\n        this._batchRequests = new Set();\n        requests.forEach((request) => request.reject(settled.reason));\n      }\n    } else if (this._isStopped) {\n      this._batchRequests = new Set();\n      requests.forEach((request) => request.resolve(undefined));\n    }\n  }\n\n  private *_drainBatch(): Generator<T> {\n    while (true) {\n      const entry = this._entries[0];\n      if (entry === undefined) {\n        return;\n      }\n      if (entry.kind === 'stop') {\n        this._isStopped = true;\n        this._entries.shift();\n        return;\n      }\n      const settled = entry.settled;\n      if (settled === undefined || settled.status === 'rejected') {\n        return;\n      }\n      this._entries.shift();\n      this._release();\n      yield settled.value;\n    }\n  }\n}\n"]}

package/execution/incremental/WorkQueue.d.mts

@@ -1,5 +1,6 @@
 import type { Computation } from "./Computation.mjs";
 import { Queue } from "./Queue.mjs";
+/** @internal */
 export interface Group<TSelf extends Group<TSelf>> {
     parent?: TSelf | undefined;
 }
@@ -7,9 +8,11 @@ interface WorkResult<TValue, T, I, G extends Group<G>, S extends Stream<T, I, G,
     value: TValue;
     work?: Work<T, I, G, S> | undefined;
 }
+/** @internal */
 export interface Stream<T, I, G extends Group<G>, S extends Stream<T, I, G, S>> {
     queue: Queue<StreamItem<T, I, G, S>>;
 }
+/** @internal */
 export interface Work<T, I, G extends Group<G>, S extends Stream<T, I, G, S>> {
     groups?: ReadonlyArray<G>;
     tasks?: ReadonlyArray<Task<T, I, G, S>>;
@@ -19,13 +22,17 @@ interface NewWork<T, I, G extends Group<G>, S extends Stream<T, I, G, S>> {
     newGroups: ReadonlyArray<G>;
     newStreams: ReadonlyArray<S>;
 }
+/** @internal */
 export interface WorkQueue<T, I, G extends Group<G>, S extends Stream<T, I, G, S>> {
     initialGroups: ReadonlyArray<G>;
     initialStreams: ReadonlyArray<S>;
     events: AsyncGenerator<ReadonlyArray<WorkQueueEvent<T, I, G, S>>, void, void>;
 }
+/** @internal */
 export type StreamItem<T, I, G extends Group<G>, S extends Stream<T, I, G, S>> = WorkResult<I, T, I, G, S>;
+/** @internal */
 export type TaskResult<T, I, G extends Group<G>, S extends Stream<T, I, G, S>> = WorkResult<T, T, I, G, S>;
+/** @internal */
 export interface Task<T, I, G extends Group<G>, S extends Stream<T, I, G, S>> {
     groups: ReadonlyArray<G>;
     computation: Computation<TaskResult<T, I, G, S>>;
@@ -61,6 +68,7 @@ interface StreamValuesEvent<T, I, G extends Group<G>, S extends Stream<T, I, G,
 interface WorkQueueTerminationEvent {
     kind: 'WORK_QUEUE_TERMINATION';
 }
+/** @internal */
 export type WorkQueueEvent<T, I, G extends Group<G>, S extends Stream<T, I, G, S>> = GroupValuesEvent<T, I, G, S> | GroupSuccessEvent<T, I, G, S> | GroupFailureEvent<G> | StreamValuesEvent<T, I, G, S> | StreamSuccessEvent<T, I, G, S> | StreamFailureEvent<T, I, G, S> | WorkQueueTerminationEvent;
 /** @internal */
 export declare function createWorkQueue<T, I, G extends Group<G>, S extends Stream<T, I, G, S>>(initialWork: Work<T, I, G, S> | undefined): WorkQueue<T, I, G, S>;

package/execution/incremental/WorkQueue.d.ts

@@ -1,5 +1,6 @@
 import type { Computation } from "./Computation.js";
 import { Queue } from "./Queue.js";
+/** @internal */
 export interface Group<TSelf extends Group<TSelf>> {
     parent?: TSelf | undefined;
 }
@@ -7,9 +8,11 @@ interface WorkResult<TValue, T, I, G extends Group<G>, S extends Stream<T, I, G,
     value: TValue;
     work?: Work<T, I, G, S> | undefined;
 }
+/** @internal */
 export interface Stream<T, I, G extends Group<G>, S extends Stream<T, I, G, S>> {
     queue: Queue<StreamItem<T, I, G, S>>;
 }
+/** @internal */
 export interface Work<T, I, G extends Group<G>, S extends Stream<T, I, G, S>> {
     groups?: ReadonlyArray<G>;
     tasks?: ReadonlyArray<Task<T, I, G, S>>;
@@ -19,13 +22,17 @@ interface NewWork<T, I, G extends Group<G>, S extends Stream<T, I, G, S>> {
     newGroups: ReadonlyArray<G>;
     newStreams: ReadonlyArray<S>;
 }
+/** @internal */
 export interface WorkQueue<T, I, G extends Group<G>, S extends Stream<T, I, G, S>> {
     initialGroups: ReadonlyArray<G>;
     initialStreams: ReadonlyArray<S>;
     events: AsyncGenerator<ReadonlyArray<WorkQueueEvent<T, I, G, S>>, void, void>;
 }
+/** @internal */
 export type StreamItem<T, I, G extends Group<G>, S extends Stream<T, I, G, S>> = WorkResult<I, T, I, G, S>;
+/** @internal */
 export type TaskResult<T, I, G extends Group<G>, S extends Stream<T, I, G, S>> = WorkResult<T, T, I, G, S>;
+/** @internal */
 export interface Task<T, I, G extends Group<G>, S extends Stream<T, I, G, S>> {
     groups: ReadonlyArray<G>;
     computation: Computation<TaskResult<T, I, G, S>>;
@@ -61,6 +68,7 @@ interface StreamValuesEvent<T, I, G extends Group<G>, S extends Stream<T, I, G,
 interface WorkQueueTerminationEvent {
     kind: 'WORK_QUEUE_TERMINATION';
 }
+/** @internal */
 export type WorkQueueEvent<T, I, G extends Group<G>, S extends Stream<T, I, G, S>> = GroupValuesEvent<T, I, G, S> | GroupSuccessEvent<T, I, G, S> | GroupFailureEvent<G> | StreamValuesEvent<T, I, G, S> | StreamSuccessEvent<T, I, G, S> | StreamFailureEvent<T, I, G, S> | WorkQueueTerminationEvent;
 /** @internal */
 export declare function createWorkQueue<T, I, G extends Group<G>, S extends Stream<T, I, G, S>>(initialWork: Work<T, I, G, S> | undefined): WorkQueue<T, I, G, S>;