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

package/execution/legacyIncremental/BranchingIncrementalExecutor.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"BranchingIncrementalExecutor.js","sourceRoot":"","sources":["../../../src/execution/legacyIncremental/BranchingIncrementalExecutor.ts"],"names":[],"mappings":"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","sourcesContent":["/** @category Legacy Incremental Execution */\n\nimport { AccumulatorMap } from '../../jsutils/AccumulatorMap.ts';\nimport { getBySet } from '../../jsutils/getBySet.ts';\nimport { invariant } from '../../jsutils/invariant.ts';\nimport { isSameSet } from '../../jsutils/isSameSet.ts';\nimport { memoize1 } from '../../jsutils/memoize1.ts';\nimport { memoize2 } from '../../jsutils/memoize2.ts';\nimport type { ObjMap } from '../../jsutils/ObjMap.ts';\n\nimport type {\n  GraphQLError,\n  GraphQLFormattedError,\n} from '../../error/GraphQLError.ts';\n\nimport type {\n  DeferUsage,\n  FieldDetails,\n  GroupedFieldSet,\n} from '../collectFields.ts';\nimport type { ExecutionResult, FormattedExecutionResult } from '../Executor.ts';\nimport type {\n  DeferUsageSet,\n  ExecutionPlan,\n} from '../incremental/buildExecutionPlan.ts';\nimport { IncrementalExecutor } from '../incremental/IncrementalExecutor.ts';\n\nimport { BranchingIncrementalPublisher } from './BranchingIncrementalPublisher.ts';\n\n/**\n * Results for an operation that produced legacy incremental payloads.\n * @typeParam TInitialData - Shape of the initial result data payload.\n * @typeParam TDeferredData - Shape of deferred fragment data payloads.\n * @typeParam TStreamItem - Shape of streamed list items.\n * @typeParam TExtensions - Shape of extensions payloads.\n */\nexport interface LegacyExperimentalIncrementalExecutionResults<\n  TInitialData = ObjMap<unknown>,\n  TDeferredData = ObjMap<unknown>,\n  TStreamItem = unknown,\n  TExtensions = ObjMap<unknown>,\n> {\n  /** Initial execution result delivered before subsequent legacy incremental payloads. */\n  initialResult: LegacyInitialIncrementalExecutionResult<\n    TInitialData,\n    TExtensions\n  >;\n  /** Async stream of legacy incremental payloads delivered after the initial result. */\n  subsequentResults: AsyncGenerator<\n    LegacySubsequentIncrementalExecutionResult<\n      TDeferredData,\n      TStreamItem,\n      TExtensions\n    >,\n    void,\n    void\n  >;\n}\n\n/**\n * Initial execution result for an operation that produced legacy incremental payloads.\n *\n * Unlike `InitialIncrementalExecutionResult`, the legacy initial result does\n * not include a `pending` list. Subsequent payloads identify their location\n * directly with `path` and optional `label` fields.\n * @typeParam TInitialData - Shape of the initial data payload.\n * @typeParam TExtensions - Shape of the extensions payload.\n */\nexport interface LegacyInitialIncrementalExecutionResult<\n  TInitialData = ObjMap<unknown>,\n  TExtensions = ObjMap<unknown>,\n> extends ExecutionResult<TInitialData, TExtensions> {\n  /** Data produced by the initial execution payload. */\n  data: TInitialData;\n  /** Indicates that subsequent legacy incremental payloads will follow. */\n  hasNext: true;\n  /** Additional non-standard metadata included in the initial result. */\n  extensions?: TExtensions;\n}\n\n/**\n * Subsequent payload produced by legacy incremental execution.\n *\n * Legacy subsequent payloads may contain deferred fragment data, streamed list\n * items, or only `hasNext: false` to complete the response stream.\n * @typeParam TDeferredData - Shape of deferred fragment data payloads.\n * @typeParam TStreamItem - Shape of streamed list items.\n * @typeParam TExtensions - Shape of the extensions payload.\n */\nexport interface LegacySubsequentIncrementalExecutionResult<\n  TDeferredData = ObjMap<unknown>,\n  TStreamItem = unknown,\n  TExtensions = ObjMap<unknown>,\n> {\n  /** Deferred or streamed payloads delivered by this response. */\n  incremental?: ReadonlyArray<\n    LegacyIncrementalResult<TDeferredData, TStreamItem, TExtensions>\n  >;\n  /** Indicates whether more legacy incremental payloads will follow. */\n  hasNext: boolean;\n  /** Additional non-standard metadata included in this payload. */\n  extensions?: TExtensions;\n}\n\n/**\n * Deferred fragment or streamed list payload produced by legacy incremental execution.\n * @typeParam TDeferredData - Shape of deferred fragment data.\n * @typeParam TStreamItem - Shape of streamed list items.\n * @typeParam TExtensions - Shape of extensions payloads.\n */\nexport type LegacyIncrementalResult<\n  TDeferredData = ObjMap<unknown>,\n  TStreamItem = unknown,\n  TExtensions = ObjMap<unknown>,\n> =\n  | LegacyIncrementalDeferResult<TDeferredData, TExtensions>\n  | LegacyIncrementalStreamResult<TStreamItem, TExtensions>;\n\n/**\n * Legacy incremental payload produced by a deferred fragment.\n *\n * The payload location is identified directly by `path` and optional `label`\n * instead of by an `id` from a pending entry.\n * @typeParam TDeferredData - Shape of deferred fragment data.\n * @typeParam TExtensions - Shape of extensions payloads.\n */\nexport interface LegacyIncrementalDeferResult<\n  TDeferredData = ObjMap<unknown>,\n  TExtensions = ObjMap<unknown>,\n> extends ExecutionResult<TDeferredData, TExtensions> {\n  /** Response path to the deferred fragment payload. */\n  path: ReadonlyArray<string | number>;\n  /** Label from the `@defer` directive. */\n  label?: string;\n}\n\n/**\n * Legacy incremental payload produced by a streamed list field.\n * @typeParam TStreamItem - Shape of streamed list items.\n * @typeParam TExtensions - Shape of extensions payloads.\n */\nexport interface LegacyIncrementalStreamResult<\n  TStreamItem = unknown,\n  TExtensions = ObjMap<unknown>,\n> {\n  /** Errors raised while producing streamed items. */\n  errors?: ReadonlyArray<GraphQLError>;\n  /** Streamed list items delivered by this payload. */\n  items: ReadonlyArray<TStreamItem> | null;\n  /** Response path to the first streamed list item in this payload. */\n  path: ReadonlyArray<string | number>;\n  /** Label from the `@stream` directive. */\n  label?: string;\n  /** Additional non-standard metadata included in this payload. */\n  extensions?: TExtensions;\n}\n\nconst buildBranchingExecutionPlanFromInitial = memoize1(\n  (groupedFieldSet: GroupedFieldSet) =>\n    buildBranchingExecutionPlan(groupedFieldSet),\n);\n\nconst buildBranchingExecutionPlanFromDeferred = memoize2(\n  (groupedFieldSet: GroupedFieldSet, deferUsageSet: DeferUsageSet) =>\n    buildBranchingExecutionPlan(groupedFieldSet, deferUsageSet),\n);\n\n/**\n * JSON-serializable form of legacy incremental execution results.\n * @typeParam TInitialData - Shape of the formatted initial result data payload.\n * @typeParam TDeferredData - Shape of formatted deferred fragment data payloads.\n * @typeParam TStreamItem - Shape of formatted streamed list items.\n * @typeParam TExtensions - Shape of formatted extensions payloads.\n */\nexport interface FormattedLegacyExperimentalIncrementalExecutionResults<\n  TInitialData = ObjMap<unknown>,\n  TDeferredData = ObjMap<unknown>,\n  TStreamItem = unknown,\n  TExtensions = ObjMap<unknown>,\n> {\n  /** Formatted initial execution result. */\n  initialResult: FormattedLegacyInitialIncrementalExecutionResult<\n    TInitialData,\n    TExtensions\n  >;\n  /** Async stream of formatted legacy incremental payloads. */\n  subsequentResults: AsyncGenerator<\n    FormattedLegacySubsequentIncrementalExecutionResult<\n      TDeferredData,\n      TStreamItem,\n      TExtensions\n    >,\n    void,\n    void\n  >;\n}\n\n/**\n * JSON-serializable form of a legacy initial incremental execution result.\n * @typeParam TInitialData - Shape of the formatted initial data payload.\n * @typeParam TExtensions - Shape of the formatted extensions payload.\n */\nexport interface FormattedLegacyInitialIncrementalExecutionResult<\n  TInitialData = ObjMap<unknown>,\n  TExtensions = ObjMap<unknown>,\n> extends FormattedExecutionResult<TInitialData, TExtensions> {\n  /** Formatted data produced by the initial execution payload. */\n  data: TInitialData;\n  /** Indicates that subsequent legacy incremental payloads will follow. */\n  hasNext: true;\n  /** Additional non-standard metadata included in the formatted initial result. */\n  extensions?: TExtensions;\n}\n\n/**\n * JSON-serializable form of a legacy subsequent incremental execution payload.\n * @typeParam TDeferredData - Shape of formatted deferred fragment data payloads.\n * @typeParam TStreamItem - Shape of formatted streamed list items.\n * @typeParam TExtensions - Shape of formatted extensions payloads.\n */\nexport interface FormattedLegacySubsequentIncrementalExecutionResult<\n  TDeferredData = ObjMap<unknown>,\n  TStreamItem = unknown,\n  TExtensions = ObjMap<unknown>,\n> {\n  /** Formatted deferred or streamed payloads delivered by this response. */\n  incremental?: ReadonlyArray<\n    FormattedLegacyIncrementalResult<TDeferredData, TStreamItem, TExtensions>\n  >;\n  /** Indicates whether more legacy incremental payloads will follow. */\n  hasNext: boolean;\n  /** Additional non-standard metadata included in this formatted payload. */\n  extensions?: TExtensions;\n}\n\n/**\n * JSON-serializable deferred fragment or streamed list payload produced by\n * legacy incremental execution.\n * @typeParam TDeferredData - Shape of formatted deferred fragment data.\n * @typeParam TStreamItem - Shape of formatted streamed list items.\n * @typeParam TExtensions - Shape of formatted extensions payloads.\n */\nexport type FormattedLegacyIncrementalResult<\n  TDeferredData = ObjMap<unknown>,\n  TStreamItem = unknown,\n  TExtensions = ObjMap<unknown>,\n> =\n  | FormattedLegacyIncrementalDeferResult<TDeferredData, TExtensions>\n  | FormattedLegacyIncrementalStreamResult<TStreamItem, TExtensions>;\n\n/**\n * JSON-serializable form of a legacy deferred fragment payload.\n * @typeParam TDeferredData - Shape of formatted deferred fragment data.\n * @typeParam TExtensions - Shape of formatted extensions payloads.\n */\nexport interface FormattedLegacyIncrementalDeferResult<\n  TDeferredData = ObjMap<unknown>,\n  TExtensions = ObjMap<unknown>,\n> extends FormattedExecutionResult<TDeferredData, TExtensions> {\n  /** Response path to the formatted deferred fragment payload. */\n  path: ReadonlyArray<string | number>;\n  /** Label from the `@defer` directive. */\n  label?: string;\n}\n\n/**\n * JSON-serializable form of a legacy streamed list payload.\n * @typeParam TStreamItem - Shape of formatted streamed list items.\n * @typeParam TExtensions - Shape of formatted extensions payloads.\n */\nexport interface FormattedLegacyIncrementalStreamResult<\n  TStreamItem = unknown,\n  TExtensions = ObjMap<unknown>,\n> {\n  /** Formatted errors raised while producing streamed items. */\n  errors?: ReadonlyArray<GraphQLFormattedError>;\n  /** Formatted streamed list items delivered by this payload. */\n  items: ReadonlyArray<TStreamItem> | null;\n  /** Response path to the first streamed list item in this formatted payload. */\n  path: ReadonlyArray<string | number>;\n  /** Label from the `@stream` directive. */\n  label?: string;\n  /** Additional non-standard metadata included in this formatted payload. */\n  extensions?: TExtensions;\n}\n/** @internal */\nexport class BranchingIncrementalExecutor extends IncrementalExecutor<LegacyExperimentalIncrementalExecutionResults> {\n  override getCreateSubExecutor(): (\n    deferUsageSet?: DeferUsageSet,\n  ) => BranchingIncrementalExecutor {\n    const validatedExecutionArgs = this.validatedExecutionArgs;\n    const sharedExecutionContext = this.sharedExecutionContext;\n\n    return (deferUsageSet?: DeferUsageSet) =>\n      new BranchingIncrementalExecutor(\n        validatedExecutionArgs,\n        sharedExecutionContext,\n        deferUsageSet,\n      );\n  }\n\n  override buildResponse(\n    data: ObjMap<unknown> | null,\n  ): ExecutionResult | LegacyExperimentalIncrementalExecutionResults {\n    const work = this.getIncrementalWork();\n    const { tasks, streams } = work;\n    if (tasks?.length === 0 && streams?.length === 0) {\n      return super.buildResponse(data);\n    }\n\n    const errors = this.collectedErrors.errors;\n    invariant(data !== null);\n    const incrementalPublisher = new BranchingIncrementalPublisher();\n    return incrementalPublisher.buildResponse(\n      data,\n      errors,\n      work,\n      this.validatedExecutionArgs.externalAbortSignal,\n      this.getFinishSharedExecution(),\n    );\n  }\n\n  override buildRootExecutionPlan(\n    originalGroupedFieldSet: GroupedFieldSet,\n  ): ExecutionPlan {\n    return buildBranchingExecutionPlanFromInitial(originalGroupedFieldSet);\n  }\n\n  override buildSubExecutionPlan(\n    originalGroupedFieldSet: GroupedFieldSet,\n  ): ExecutionPlan {\n    return this.deferUsageSet === undefined\n      ? buildBranchingExecutionPlanFromInitial(originalGroupedFieldSet)\n      : buildBranchingExecutionPlanFromDeferred(\n          originalGroupedFieldSet,\n          this.deferUsageSet,\n        );\n  }\n}\n\nfunction buildBranchingExecutionPlan(\n  originalGroupedFieldSet: GroupedFieldSet,\n  parentDeferUsages: DeferUsageSet = new Set<DeferUsage>(),\n): ExecutionPlan {\n  const groupedFieldSet = new AccumulatorMap<string, FieldDetails>();\n\n  const newGroupedFieldSets = new Map<\n    DeferUsageSet,\n    AccumulatorMap<string, FieldDetails>\n  >();\n\n  for (const [responseKey, fieldGroup] of originalGroupedFieldSet) {\n    for (const fieldDetails of fieldGroup) {\n      const deferUsage = fieldDetails.deferUsage;\n      const deferUsageSet =\n        deferUsage === undefined\n          ? new Set<DeferUsage>()\n          : new Set([deferUsage]);\n      if (isSameSet(parentDeferUsages, deferUsageSet)) {\n        groupedFieldSet.add(responseKey, fieldDetails);\n      } else {\n        let newGroupedFieldSet = getBySet(newGroupedFieldSets, deferUsageSet);\n        if (newGroupedFieldSet === undefined) {\n          newGroupedFieldSet = new AccumulatorMap();\n          newGroupedFieldSets.set(deferUsageSet, newGroupedFieldSet);\n        }\n        newGroupedFieldSet.add(responseKey, fieldDetails);\n      }\n    }\n  }\n\n  return {\n    groupedFieldSet,\n    newGroupedFieldSets,\n  };\n}\n"]}

package/execution/legacyIncremental/BranchingIncrementalPublisher.d.mts

@@ -0,0 +1,12 @@
+import type { ObjMap } from "../../jsutils/ObjMap.mjs";
+import type { GraphQLError } from "../../error/GraphQLError.mjs";
+import type { IncrementalWork } from "../incremental/IncrementalExecutor.mjs";
+import type { LegacyExperimentalIncrementalExecutionResults } from "./BranchingIncrementalExecutor.mjs";
+/** @internal */
+export declare class BranchingIncrementalPublisher {
+    private _indices;
+    constructor();
+    buildResponse(data: ObjMap<unknown>, errors: ReadonlyArray<GraphQLError>, work: IncrementalWork, abortSignal: AbortSignal | undefined, onFinished: () => void): LegacyExperimentalIncrementalExecutionResults;
+    private _handleBatch;
+    private _handleWorkQueueEvent;
+}

package/execution/legacyIncremental/BranchingIncrementalPublisher.d.ts

@@ -0,0 +1,12 @@
+import type { ObjMap } from "../../jsutils/ObjMap.js";
+import type { GraphQLError } from "../../error/GraphQLError.js";
+import type { IncrementalWork } from "../incremental/IncrementalExecutor.js";
+import type { LegacyExperimentalIncrementalExecutionResults } from "./BranchingIncrementalExecutor.js";
+/** @internal */
+export declare class BranchingIncrementalPublisher {
+    private _indices;
+    constructor();
+    buildResponse(data: ObjMap<unknown>, errors: ReadonlyArray<GraphQLError>, work: IncrementalWork, abortSignal: AbortSignal | undefined, onFinished: () => void): LegacyExperimentalIncrementalExecutionResults;
+    private _handleBatch;
+    private _handleWorkQueueEvent;
+}

package/execution/legacyIncremental/BranchingIncrementalPublisher.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BranchingIncrementalPublisher = void 0;
+const Path_ts_1 = require("../../jsutils/Path.js");
+const ensureGraphQLError_ts_1 = require("../../error/ensureGraphQLError.js");
+const WorkQueue_ts_1 = require("../incremental/WorkQueue.js");
+const mapAsyncIterable_ts_1 = require("../mapAsyncIterable.js");
+const withConcurrentAbruptClose_ts_1 = require("../withConcurrentAbruptClose.js");
+class BranchingIncrementalPublisher {
+    constructor() {
+        this._indices = new Map();
+    }
+    buildResponse(data, errors, work, abortSignal, onFinished) {
+        const { initialStreams, events } = (0, WorkQueue_ts_1.createWorkQueue)(work);
+        for (const stream of initialStreams) {
+            this._indices.set(stream, stream.initialCount);
+        }
+        function abort() {
+            subsequentResults.throw(abortSignal?.reason).catch(() => {
+            });
+        }
+        if (abortSignal) {
+            abortSignal.addEventListener('abort', abort);
+        }
+        const onWorkQueueFinished = () => {
+            onFinished();
+            abortSignal?.removeEventListener('abort', abort);
+        };
+        const initialResult = errors.length
+            ? { errors, data, hasNext: true }
+            : { data, hasNext: true };
+        const subsequentResults = (0, withConcurrentAbruptClose_ts_1.withConcurrentAbruptClose)((0, mapAsyncIterable_ts_1.mapAsyncIterable)(events, (batch) => this._handleBatch(batch, onWorkQueueFinished)), () => onWorkQueueFinished());
+        return {
+            initialResult,
+            subsequentResults,
+        };
+    }
+    _handleBatch(batch, onWorkQueueFinished) {
+        const context = {
+            incremental: [],
+            hasNext: true,
+        };
+        for (const event of batch) {
+            this._handleWorkQueueEvent(event, context, onWorkQueueFinished);
+        }
+        const { incremental, hasNext } = context;
+        const result = { hasNext };
+        if (incremental.length > 0) {
+            result.incremental = incremental;
+        }
+        return result;
+    }
+    _handleWorkQueueEvent(event, context, onWorkQueueFinished) {
+        switch (event.kind) {
+            case 'GROUP_VALUES': {
+                const group = event.group;
+                for (const value of event.values) {
+                    context.incremental.push(buildIncrementalResult({
+                        data: value.data,
+                        path: (0, Path_ts_1.pathToArray)(group.path),
+                    }, group.label, value.errors));
+                }
+                break;
+            }
+            case 'GROUP_SUCCESS': {
+                break;
+            }
+            case 'GROUP_FAILURE': {
+                const group = event.group;
+                context.incremental.push(buildIncrementalResult({
+                    data: null,
+                    path: (0, Path_ts_1.pathToArray)(group.path),
+                }, group.label, [(0, ensureGraphQLError_ts_1.ensureGraphQLError)(event.error)]));
+                break;
+            }
+            case 'STREAM_VALUES': {
+                const stream = event.stream;
+                const { values } = event;
+                const items = [];
+                const errors = [];
+                for (const value of values) {
+                    items.push(value.item);
+                    if (value.errors !== undefined) {
+                        errors.push(...value.errors);
+                    }
+                }
+                let index = this._indices.get(stream);
+                if (index === undefined) {
+                    index = stream.initialCount;
+                    this._indices.set(stream, index);
+                }
+                this._indices.set(stream, index + items.length);
+                context.incremental.push(buildIncrementalResult({
+                    items,
+                    path: (0, Path_ts_1.pathToArray)((0, Path_ts_1.addPath)(stream.path, index, undefined)),
+                }, stream.label, errors.length > 0 ? errors : undefined));
+                break;
+            }
+            case 'STREAM_SUCCESS': {
+                this._indices.delete(event.stream);
+                break;
+            }
+            case 'STREAM_FAILURE': {
+                this._indices.delete(event.stream);
+                const stream = event.stream;
+                context.incremental.push(buildIncrementalResult({
+                    items: null,
+                    path: (0, Path_ts_1.pathToArray)(stream.path),
+                }, stream.label, [(0, ensureGraphQLError_ts_1.ensureGraphQLError)(event.error)]));
+                break;
+            }
+            case 'WORK_QUEUE_TERMINATION': {
+                onWorkQueueFinished?.();
+                context.hasNext = false;
+                break;
+            }
+        }
+    }
+}
+exports.BranchingIncrementalPublisher = BranchingIncrementalPublisher;
+function buildIncrementalResult(originalIncrementalResult, label, errors) {
+    const incrementalResult = originalIncrementalResult;
+    if (errors !== undefined) {
+        incrementalResult.errors = errors;
+    }
+    if (label !== undefined) {
+        incrementalResult.label = label;
+    }
+    return incrementalResult;
+}
+//# sourceMappingURL=BranchingIncrementalPublisher.js.map

package/execution/legacyIncremental/BranchingIncrementalPublisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BranchingIncrementalPublisher.js","sourceRoot":"","sources":["../../../src/execution/legacyIncremental/BranchingIncrementalPublisher.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ObjMap } from '../../jsutils/ObjMap.ts';\nimport { addPath, pathToArray } from '../../jsutils/Path.ts';\n\nimport { ensureGraphQLError } from '../../error/ensureGraphQLError.ts';\nimport type { GraphQLError } from '../../error/GraphQLError.ts';\n\nimport type {\n  DeliveryGroup,\n  ExecutionGroupValue,\n  IncrementalWork,\n  ItemStream,\n  StreamItemValue,\n} from '../incremental/IncrementalExecutor.ts';\nimport type { WorkQueueEvent } from '../incremental/WorkQueue.ts';\nimport { createWorkQueue } from '../incremental/WorkQueue.ts';\nimport { mapAsyncIterable } from '../mapAsyncIterable.ts';\nimport { withConcurrentAbruptClose } from '../withConcurrentAbruptClose.ts';\n\nimport type {\n  LegacyExperimentalIncrementalExecutionResults,\n  LegacyIncrementalDeferResult,\n  LegacyIncrementalResult,\n  LegacyIncrementalStreamResult,\n  LegacyInitialIncrementalExecutionResult,\n  LegacySubsequentIncrementalExecutionResult,\n} from './BranchingIncrementalExecutor.ts';\n\ninterface SubsequentIncrementalExecutionResultContext {\n  incremental: Array<LegacyIncrementalResult>;\n  hasNext: boolean;\n}\n\n/** @internal */\nexport class BranchingIncrementalPublisher {\n  private _indices: Map<ItemStream, number>;\n\n  constructor() {\n    this._indices = new Map();\n  }\n\n  buildResponse(\n    data: ObjMap<unknown>,\n    errors: ReadonlyArray<GraphQLError>,\n    work: IncrementalWork,\n    abortSignal: AbortSignal | undefined,\n    onFinished: () => void,\n  ): LegacyExperimentalIncrementalExecutionResults {\n    const { initialStreams, events } = createWorkQueue<\n      ExecutionGroupValue,\n      StreamItemValue,\n      DeliveryGroup,\n      ItemStream\n    >(work);\n\n    for (const stream of initialStreams) {\n      this._indices.set(stream, stream.initialCount);\n    }\n\n    function abort(): void {\n      subsequentResults.throw(abortSignal?.reason).catch(() => {\n        // Ignore errors\n      });\n    }\n\n    if (abortSignal) {\n      abortSignal.addEventListener('abort', abort);\n    }\n    const onWorkQueueFinished = () => {\n      onFinished();\n      abortSignal?.removeEventListener('abort', abort);\n    };\n\n    const initialResult: LegacyInitialIncrementalExecutionResult = errors.length\n      ? { errors, data, hasNext: true }\n      : { data, hasNext: true };\n\n    const subsequentResults = withConcurrentAbruptClose(\n      mapAsyncIterable(events, (batch) =>\n        this._handleBatch(batch, onWorkQueueFinished),\n      ),\n      () => onWorkQueueFinished(),\n    );\n\n    return {\n      initialResult,\n      subsequentResults,\n    };\n  }\n\n  private _handleBatch(\n    batch: ReadonlyArray<\n      WorkQueueEvent<\n        ExecutionGroupValue,\n        StreamItemValue,\n        DeliveryGroup,\n        ItemStream\n      >\n    >,\n    onWorkQueueFinished: (() => void) | undefined,\n  ): LegacySubsequentIncrementalExecutionResult {\n    const context: SubsequentIncrementalExecutionResultContext = {\n      incremental: [],\n      hasNext: true,\n    };\n\n    for (const event of batch) {\n      this._handleWorkQueueEvent(event, context, onWorkQueueFinished);\n    }\n\n    const { incremental, hasNext } = context;\n\n    const result: LegacySubsequentIncrementalExecutionResult = { hasNext };\n    if (incremental.length > 0) {\n      result.incremental = incremental;\n    }\n\n    return result;\n  }\n\n  private _handleWorkQueueEvent(\n    event: WorkQueueEvent<\n      ExecutionGroupValue,\n      StreamItemValue,\n      DeliveryGroup,\n      ItemStream\n    >,\n    context: SubsequentIncrementalExecutionResultContext,\n    onWorkQueueFinished: (() => void) | undefined,\n  ): void {\n    switch (event.kind) {\n      case 'GROUP_VALUES': {\n        const group = event.group;\n        for (const value of event.values) {\n          context.incremental.push(\n            buildIncrementalResult(\n              {\n                data: value.data,\n                path: pathToArray(group.path),\n              },\n              group.label,\n              value.errors,\n            ),\n          );\n        }\n        break;\n      }\n      case 'GROUP_SUCCESS': {\n        break;\n      }\n      case 'GROUP_FAILURE': {\n        const group = event.group;\n        context.incremental.push(\n          buildIncrementalResult(\n            {\n              data: null,\n              path: pathToArray(group.path),\n            },\n            group.label,\n            [ensureGraphQLError(event.error)],\n          ),\n        );\n        break;\n      }\n      case 'STREAM_VALUES': {\n        const stream = event.stream;\n        const { values } = event;\n        const items: Array<unknown> = [];\n        const errors: Array<GraphQLError> = [];\n        for (const value of values) {\n          items.push(value.item);\n          if (value.errors !== undefined) {\n            errors.push(...value.errors);\n          }\n        }\n        let index = this._indices.get(stream);\n        if (index === undefined) {\n          index = stream.initialCount;\n          this._indices.set(stream, index);\n        }\n        this._indices.set(stream, index + items.length);\n        context.incremental.push(\n          buildIncrementalResult(\n            {\n              items,\n              path: pathToArray(addPath(stream.path, index, undefined)),\n            },\n            stream.label,\n            errors.length > 0 ? errors : undefined,\n          ),\n        );\n        break;\n      }\n      case 'STREAM_SUCCESS': {\n        this._indices.delete(event.stream);\n        break;\n      }\n      case 'STREAM_FAILURE': {\n        this._indices.delete(event.stream);\n        const stream = event.stream;\n        context.incremental.push(\n          buildIncrementalResult(\n            {\n              items: null,\n              path: pathToArray(stream.path),\n            },\n            stream.label,\n            [ensureGraphQLError(event.error)],\n          ),\n        );\n        break;\n      }\n      case 'WORK_QUEUE_TERMINATION': {\n        onWorkQueueFinished?.();\n        context.hasNext = false;\n        break;\n      }\n    }\n  }\n}\n\nfunction buildIncrementalResult(\n  originalIncrementalResult:\n    | Omit<LegacyIncrementalDeferResult, 'label' | 'errors'>\n    | Omit<LegacyIncrementalStreamResult, 'label' | 'errors'>,\n  label: string | undefined,\n  errors: ReadonlyArray<GraphQLError> | undefined,\n): LegacyIncrementalResult {\n  const incrementalResult: LegacyIncrementalResult = originalIncrementalResult;\n  if (errors !== undefined) {\n    incrementalResult.errors = errors;\n  }\n  if (label !== undefined) {\n    incrementalResult.label = label;\n  }\n  return incrementalResult;\n}\n"]}

package/execution/legacyIncremental/BranchingIncrementalPublisher.mjs

@@ -0,0 +1,127 @@
+import { addPath, pathToArray } from "../../jsutils/Path.mjs";
+import { ensureGraphQLError } from "../../error/ensureGraphQLError.mjs";
+import { createWorkQueue } from "../incremental/WorkQueue.mjs";
+import { mapAsyncIterable } from "../mapAsyncIterable.mjs";
+import { withConcurrentAbruptClose } from "../withConcurrentAbruptClose.mjs";
+export class BranchingIncrementalPublisher {
+    constructor() {
+        this._indices = new Map();
+    }
+    buildResponse(data, errors, work, abortSignal, onFinished) {
+        const { initialStreams, events } = createWorkQueue(work);
+        for (const stream of initialStreams) {
+            this._indices.set(stream, stream.initialCount);
+        }
+        function abort() {
+            subsequentResults.throw(abortSignal?.reason).catch(() => {
+            });
+        }
+        if (abortSignal) {
+            abortSignal.addEventListener('abort', abort);
+        }
+        const onWorkQueueFinished = () => {
+            onFinished();
+            abortSignal?.removeEventListener('abort', abort);
+        };
+        const initialResult = errors.length
+            ? { errors, data, hasNext: true }
+            : { data, hasNext: true };
+        const subsequentResults = withConcurrentAbruptClose(mapAsyncIterable(events, (batch) => this._handleBatch(batch, onWorkQueueFinished)), () => onWorkQueueFinished());
+        return {
+            initialResult,
+            subsequentResults,
+        };
+    }
+    _handleBatch(batch, onWorkQueueFinished) {
+        const context = {
+            incremental: [],
+            hasNext: true,
+        };
+        for (const event of batch) {
+            this._handleWorkQueueEvent(event, context, onWorkQueueFinished);
+        }
+        const { incremental, hasNext } = context;
+        const result = { hasNext };
+        if (incremental.length > 0) {
+            result.incremental = incremental;
+        }
+        return result;
+    }
+    _handleWorkQueueEvent(event, context, onWorkQueueFinished) {
+        switch (event.kind) {
+            case 'GROUP_VALUES': {
+                const group = event.group;
+                for (const value of event.values) {
+                    context.incremental.push(buildIncrementalResult({
+                        data: value.data,
+                        path: pathToArray(group.path),
+                    }, group.label, value.errors));
+                }
+                break;
+            }
+            case 'GROUP_SUCCESS': {
+                break;
+            }
+            case 'GROUP_FAILURE': {
+                const group = event.group;
+                context.incremental.push(buildIncrementalResult({
+                    data: null,
+                    path: pathToArray(group.path),
+                }, group.label, [ensureGraphQLError(event.error)]));
+                break;
+            }
+            case 'STREAM_VALUES': {
+                const stream = event.stream;
+                const { values } = event;
+                const items = [];
+                const errors = [];
+                for (const value of values) {
+                    items.push(value.item);
+                    if (value.errors !== undefined) {
+                        errors.push(...value.errors);
+                    }
+                }
+                let index = this._indices.get(stream);
+                if (index === undefined) {
+                    index = stream.initialCount;
+                    this._indices.set(stream, index);
+                }
+                this._indices.set(stream, index + items.length);
+                context.incremental.push(buildIncrementalResult({
+                    items,
+                    path: pathToArray(addPath(stream.path, index, undefined)),
+                }, stream.label, errors.length > 0 ? errors : undefined));
+                break;
+            }
+            case 'STREAM_SUCCESS': {
+                this._indices.delete(event.stream);
+                break;
+            }
+            case 'STREAM_FAILURE': {
+                this._indices.delete(event.stream);
+                const stream = event.stream;
+                context.incremental.push(buildIncrementalResult({
+                    items: null,
+                    path: pathToArray(stream.path),
+                }, stream.label, [ensureGraphQLError(event.error)]));
+                break;
+            }
+            case 'WORK_QUEUE_TERMINATION': {
+                onWorkQueueFinished?.();
+                context.hasNext = false;
+                break;
+            }
+        }
+    }
+}
+function buildIncrementalResult(originalIncrementalResult, label, errors) {
+    const incrementalResult = originalIncrementalResult;
+    if (errors !== undefined) {
+        incrementalResult.errors = errors;
+    }
+    if (label !== undefined) {
+        incrementalResult.label = label;
+    }
+    return incrementalResult;
+}
+//# sourceMappingURL=BranchingIncrementalPublisher.js.map

package/execution/legacyIncremental/BranchingIncrementalPublisher.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"BranchingIncrementalPublisher.js","sourceRoot":"","sources":["../../../src/execution/legacyIncremental/BranchingIncrementalPublisher.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ObjMap } from '../../jsutils/ObjMap.ts';\nimport { addPath, pathToArray } from '../../jsutils/Path.ts';\n\nimport { ensureGraphQLError } from '../../error/ensureGraphQLError.ts';\nimport type { GraphQLError } from '../../error/GraphQLError.ts';\n\nimport type {\n  DeliveryGroup,\n  ExecutionGroupValue,\n  IncrementalWork,\n  ItemStream,\n  StreamItemValue,\n} from '../incremental/IncrementalExecutor.ts';\nimport type { WorkQueueEvent } from '../incremental/WorkQueue.ts';\nimport { createWorkQueue } from '../incremental/WorkQueue.ts';\nimport { mapAsyncIterable } from '../mapAsyncIterable.ts';\nimport { withConcurrentAbruptClose } from '../withConcurrentAbruptClose.ts';\n\nimport type {\n  LegacyExperimentalIncrementalExecutionResults,\n  LegacyIncrementalDeferResult,\n  LegacyIncrementalResult,\n  LegacyIncrementalStreamResult,\n  LegacyInitialIncrementalExecutionResult,\n  LegacySubsequentIncrementalExecutionResult,\n} from './BranchingIncrementalExecutor.ts';\n\ninterface SubsequentIncrementalExecutionResultContext {\n  incremental: Array<LegacyIncrementalResult>;\n  hasNext: boolean;\n}\n\n/** @internal */\nexport class BranchingIncrementalPublisher {\n  private _indices: Map<ItemStream, number>;\n\n  constructor() {\n    this._indices = new Map();\n  }\n\n  buildResponse(\n    data: ObjMap<unknown>,\n    errors: ReadonlyArray<GraphQLError>,\n    work: IncrementalWork,\n    abortSignal: AbortSignal | undefined,\n    onFinished: () => void,\n  ): LegacyExperimentalIncrementalExecutionResults {\n    const { initialStreams, events } = createWorkQueue<\n      ExecutionGroupValue,\n      StreamItemValue,\n      DeliveryGroup,\n      ItemStream\n    >(work);\n\n    for (const stream of initialStreams) {\n      this._indices.set(stream, stream.initialCount);\n    }\n\n    function abort(): void {\n      subsequentResults.throw(abortSignal?.reason).catch(() => {\n        // Ignore errors\n      });\n    }\n\n    if (abortSignal) {\n      abortSignal.addEventListener('abort', abort);\n    }\n    const onWorkQueueFinished = () => {\n      onFinished();\n      abortSignal?.removeEventListener('abort', abort);\n    };\n\n    const initialResult: LegacyInitialIncrementalExecutionResult = errors.length\n      ? { errors, data, hasNext: true }\n      : { data, hasNext: true };\n\n    const subsequentResults = withConcurrentAbruptClose(\n      mapAsyncIterable(events, (batch) =>\n        this._handleBatch(batch, onWorkQueueFinished),\n      ),\n      () => onWorkQueueFinished(),\n    );\n\n    return {\n      initialResult,\n      subsequentResults,\n    };\n  }\n\n  private _handleBatch(\n    batch: ReadonlyArray<\n      WorkQueueEvent<\n        ExecutionGroupValue,\n        StreamItemValue,\n        DeliveryGroup,\n        ItemStream\n      >\n    >,\n    onWorkQueueFinished: (() => void) | undefined,\n  ): LegacySubsequentIncrementalExecutionResult {\n    const context: SubsequentIncrementalExecutionResultContext = {\n      incremental: [],\n      hasNext: true,\n    };\n\n    for (const event of batch) {\n      this._handleWorkQueueEvent(event, context, onWorkQueueFinished);\n    }\n\n    const { incremental, hasNext } = context;\n\n    const result: LegacySubsequentIncrementalExecutionResult = { hasNext };\n    if (incremental.length > 0) {\n      result.incremental = incremental;\n    }\n\n    return result;\n  }\n\n  private _handleWorkQueueEvent(\n    event: WorkQueueEvent<\n      ExecutionGroupValue,\n      StreamItemValue,\n      DeliveryGroup,\n      ItemStream\n    >,\n    context: SubsequentIncrementalExecutionResultContext,\n    onWorkQueueFinished: (() => void) | undefined,\n  ): void {\n    switch (event.kind) {\n      case 'GROUP_VALUES': {\n        const group = event.group;\n        for (const value of event.values) {\n          context.incremental.push(\n            buildIncrementalResult(\n              {\n                data: value.data,\n                path: pathToArray(group.path),\n              },\n              group.label,\n              value.errors,\n            ),\n          );\n        }\n        break;\n      }\n      case 'GROUP_SUCCESS': {\n        break;\n      }\n      case 'GROUP_FAILURE': {\n        const group = event.group;\n        context.incremental.push(\n          buildIncrementalResult(\n            {\n              data: null,\n              path: pathToArray(group.path),\n            },\n            group.label,\n            [ensureGraphQLError(event.error)],\n          ),\n        );\n        break;\n      }\n      case 'STREAM_VALUES': {\n        const stream = event.stream;\n        const { values } = event;\n        const items: Array<unknown> = [];\n        const errors: Array<GraphQLError> = [];\n        for (const value of values) {\n          items.push(value.item);\n          if (value.errors !== undefined) {\n            errors.push(...value.errors);\n          }\n        }\n        let index = this._indices.get(stream);\n        if (index === undefined) {\n          index = stream.initialCount;\n          this._indices.set(stream, index);\n        }\n        this._indices.set(stream, index + items.length);\n        context.incremental.push(\n          buildIncrementalResult(\n            {\n              items,\n              path: pathToArray(addPath(stream.path, index, undefined)),\n            },\n            stream.label,\n            errors.length > 0 ? errors : undefined,\n          ),\n        );\n        break;\n      }\n      case 'STREAM_SUCCESS': {\n        this._indices.delete(event.stream);\n        break;\n      }\n      case 'STREAM_FAILURE': {\n        this._indices.delete(event.stream);\n        const stream = event.stream;\n        context.incremental.push(\n          buildIncrementalResult(\n            {\n              items: null,\n              path: pathToArray(stream.path),\n            },\n            stream.label,\n            [ensureGraphQLError(event.error)],\n          ),\n        );\n        break;\n      }\n      case 'WORK_QUEUE_TERMINATION': {\n        onWorkQueueFinished?.();\n        context.hasNext = false;\n        break;\n      }\n    }\n  }\n}\n\nfunction buildIncrementalResult(\n  originalIncrementalResult:\n    | Omit<LegacyIncrementalDeferResult, 'label' | 'errors'>\n    | Omit<LegacyIncrementalStreamResult, 'label' | 'errors'>,\n  label: string | undefined,\n  errors: ReadonlyArray<GraphQLError> | undefined,\n): LegacyIncrementalResult {\n  const incrementalResult: LegacyIncrementalResult = originalIncrementalResult;\n  if (errors !== undefined) {\n    incrementalResult.errors = errors;\n  }\n  if (label !== undefined) {\n    incrementalResult.label = label;\n  }\n  return incrementalResult;\n}\n"]}

package/execution/legacyIncremental/legacyExecuteIncrementally.d.mts

@@ -0,0 +1,165 @@
+/** @category Legacy Incremental Execution */
+import type { PromiseOrValue } from "../../jsutils/PromiseOrValue.mjs";
+import type { ExecutionArgs, ValidatedExecutionArgs } from "../ExecutionArgs.mjs";
+import type { ExecutionResult } from "../Executor.mjs";
+import type { LegacyExperimentalIncrementalExecutionResults } from "./BranchingIncrementalExecutor.mjs";
+/**
+ * Executes a GraphQL operation with support for `@defer` and `@stream` using
+ * the legacy incremental delivery payload format.
+ *
+ * Prefer `experimentalExecuteIncrementally` for the current incremental
+ * delivery format. In the legacy format, each subsequent incremental payload
+ * identifies its location with `path` and optional `label` fields. The current
+ * format instead tracks pending work by `id` and reports completion through
+ * `completed` entries.
+ * @param args - Execution arguments for the GraphQL operation.
+ * @returns A single execution result or legacy incremental execution results.
+ * @example
+ * ```ts
+ * import assert from 'node:assert';
+ * import { parse } from 'graphql/language';
+ * import { buildSchema } from 'graphql/utilities';
+ * import { legacyExecuteIncrementally } from 'graphql/execution';
+ *
+ * const schema = buildSchema(`
+ *   type Query {
+ *     hero: Hero
+ *   }
+ *
+ *   type Hero {
+ *     id: ID!
+ *     name: String!
+ *   }
+ * `);
+ *
+ * const result = await legacyExecuteIncrementally({
+ *   schema,
+ *   document: parse('{ hero { id ... @defer(label: "HeroName") { name } } }'),
+ *   rootValue: { hero: { id: '1', name: 'Luke' } },
+ * });
+ *
+ * assert('initialResult' in result);
+ *
+ * result.initialResult; // => { data: { hero: { id: '1' } }, hasNext: true }
+ *
+ * const deferred = await result.subsequentResults.next();
+ * deferred.value; // => { incremental: [ { data: { name: 'Luke' }, path: ['hero'], label: 'HeroName' } ], hasNext: false }
+ * ```
+ * @example
+ * Compare the legacy payload format with the current incremental delivery
+ * format returned by `experimentalExecuteIncrementally`.
+ * ```ts
+ * import assert from 'node:assert';
+ * import { parse } from 'graphql/language';
+ * import { buildSchema } from 'graphql/utilities';
+ * import {
+ *   experimentalExecuteIncrementally,
+ *   legacyExecuteIncrementally,
+ * } from 'graphql/execution';
+ *
+ * const schema = buildSchema(`
+ *   type Query {
+ *     hero: Hero
+ *   }
+ *
+ *   type Hero {
+ *     id: ID!
+ *     name: String!
+ *   }
+ * `);
+ * const document = parse('{ hero { id ... @defer { name } } }');
+ * const rootValue = { hero: { id: '1', name: 'Luke' } };
+ *
+ * const experimental = await experimentalExecuteIncrementally({
+ *   schema,
+ *   document,
+ *   rootValue,
+ * });
+ * const legacy = await legacyExecuteIncrementally({
+ *   schema,
+ *   document,
+ *   rootValue,
+ * });
+ *
+ * assert('initialResult' in experimental);
+ * assert('initialResult' in legacy);
+ *
+ * experimental.initialResult; // => { data: { hero: { id: '1' } }, pending: [ { id: '0', path: ['hero'] } ], hasNext: true }
+ * legacy.initialResult; // => { data: { hero: { id: '1' } }, hasNext: true }
+ *
+ * const experimentalDeferred = await experimental.subsequentResults.next();
+ * experimentalDeferred.value; // => { incremental: [{ data: { name: 'Luke' }, id: '0' }], completed: [{ id: '0' }], hasNext: false }
+ *
+ * const legacyDeferred = await legacy.subsequentResults.next();
+ * legacyDeferred.value; // => { incremental: [ { data: { name: 'Luke' }, path: ['hero'] } ], hasNext: false }
+ * ```
+ * @example
+ * Compare streamed list payloads in the legacy and current incremental
+ * delivery formats.
+ * ```ts
+ * import assert from 'node:assert';
+ * import { parse } from 'graphql/language';
+ * import { buildSchema } from 'graphql/utilities';
+ * import {
+ *   experimentalExecuteIncrementally,
+ *   legacyExecuteIncrementally,
+ * } from 'graphql/execution';
+ *
+ * const schema = buildSchema('type Query { colors: [String] }');
+ * const document = parse('{ colors @stream(initialCount: 1) }');
+ * const rootValue = { colors: ['red', 'green', 'blue'] };
+ *
+ * const experimental = await experimentalExecuteIncrementally({
+ *   schema,
+ *   document,
+ *   rootValue,
+ * });
+ * const legacy = await legacyExecuteIncrementally({
+ *   schema,
+ *   document,
+ *   rootValue,
+ * });
+ *
+ * assert('initialResult' in experimental);
+ * assert('initialResult' in legacy);
+ *
+ * experimental.initialResult; // => { data: { colors: ['red'] }, pending: [ { id: '0', path: ['colors'] } ], hasNext: true }
+ * legacy.initialResult; // => { data: { colors: ['red'] }, hasNext: true }
+ *
+ * const experimentalStream = await experimental.subsequentResults.next();
+ * experimentalStream.value; // => { incremental: [ { items: ['green', 'blue'], id: '0' } ], completed: [{ id: '0' }], hasNext: false }
+ *
+ * const legacyStream = await legacy.subsequentResults.next();
+ * legacyStream.value; // => { incremental: [ { items: ['green', 'blue'], path: ['colors', 1] } ], hasNext: false }
+ * ```
+ */
+export declare function legacyExecuteIncrementally(args: ExecutionArgs): PromiseOrValue<ExecutionResult | LegacyExperimentalIncrementalExecutionResults>;
+/**
+ * Executes a validated operation root selection set with support for `@defer`
+ * and `@stream` using the legacy incremental delivery payload format.
+ * @param validatedExecutionArgs - Validated execution arguments.
+ * @returns A single execution result or legacy incremental execution results.
+ * @example
+ * ```ts
+ * import assert from 'node:assert';
+ * import { parse } from 'graphql/language';
+ * import { buildSchema } from 'graphql/utilities';
+ * import {
+ *   legacyExecuteRootSelectionSet,
+ *   validateExecutionArgs,
+ * } from 'graphql/execution';
+ *
+ * const schema = buildSchema('type Query { greeting: String }');
+ * const validatedArgs = validateExecutionArgs({
+ *   schema,
+ *   document: parse('{ greeting }'),
+ *   rootValue: { greeting: 'Hello' },
+ * });
+ *
+ * assert('schema' in validatedArgs);
+ *
+ * const result = await legacyExecuteRootSelectionSet(validatedArgs);
+ * result; // => { data: { greeting: 'Hello' } }
+ * ```
+ */
+export declare function legacyExecuteRootSelectionSet(validatedExecutionArgs: ValidatedExecutionArgs): PromiseOrValue<ExecutionResult | LegacyExperimentalIncrementalExecutionResults>;