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

package/execution/index.d.ts

@@ -1,8 +1,17 @@
+/**
+ * Execute GraphQL operations and produce GraphQL execution results.
+ *
+ * These exports are also available from the root `graphql` package.
+ * @packageDocumentation
+ */
 export { pathToArray as responsePathAsArray } from "../jsutils/Path.js";
 export { createSourceEventStream, execute, executeRootSelectionSet, executeSubscriptionEvent, executeSync, experimentalExecuteIncrementally, experimentalExecuteRootSelectionSet, defaultFieldResolver, defaultTypeResolver, mapSourceToResponseEvent, subscribe, validateExecutionArgs, validateSubscriptionArgs, } from "./execute.js";
-export type { ExecutionArgs, RootSelectionSetExecutor } from "./execute.js";
-export type { AsyncWorkFinishedInfo, ExecutionHooks } from "./hooks.js";
-export type { ValidatedExecutionArgs, ValidatedSubscriptionArgs, ExecutionResult, FormattedExecutionResult, } from "./Executor.js";
+export { legacyExecuteIncrementally, legacyExecuteRootSelectionSet, } from "./legacyIncremental/legacyExecuteIncrementally.js";
+export type { AsyncWorkFinishedInfo, ExecutionArgs, ExecutionHooks, ValidatedExecutionArgs, ValidatedSubscriptionArgs, } from "./ExecutionArgs.js";
+export type { RootSelectionSetExecutor } from "./execute.js";
+export type { ExecutionResult, FormattedExecutionResult } from "./Executor.js";
 export type { ExperimentalIncrementalExecutionResults, InitialIncrementalExecutionResult, SubsequentIncrementalExecutionResult, IncrementalDeferResult, IncrementalStreamResult, IncrementalResult, FormattedExperimentalIncrementalExecutionResults, FormattedInitialIncrementalExecutionResult, FormattedSubsequentIncrementalExecutionResult, FormattedIncrementalDeferResult, FormattedIncrementalStreamResult, FormattedIncrementalResult, } from "./incremental/IncrementalExecutor.js";
+export type { LegacyExperimentalIncrementalExecutionResults, LegacyInitialIncrementalExecutionResult, LegacySubsequentIncrementalExecutionResult, LegacyIncrementalDeferResult, LegacyIncrementalStreamResult, LegacyIncrementalResult, FormattedLegacyExperimentalIncrementalExecutionResults, FormattedLegacyInitialIncrementalExecutionResult, FormattedLegacySubsequentIncrementalExecutionResult, FormattedLegacyIncrementalDeferResult, FormattedLegacyIncrementalStreamResult, FormattedLegacyIncrementalResult, } from "./legacyIncremental/BranchingIncrementalExecutor.js";
 export { AbortedGraphQLExecutionError } from "./AbortedGraphQLExecutionError.js";
 export { getArgumentValues, getVariableValues, getDirectiveValues, } from "./values.js";
+export type { VariableValues } from "./values.js";

package/execution/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDirectiveValues = exports.getVariableValues = exports.getArgumentValues = exports.AbortedGraphQLExecutionError = exports.validateSubscriptionArgs = exports.validateExecutionArgs = exports.subscribe = exports.mapSourceToResponseEvent = exports.defaultTypeResolver = exports.defaultFieldResolver = exports.experimentalExecuteRootSelectionSet = exports.experimentalExecuteIncrementally = exports.executeSync = exports.executeSubscriptionEvent = exports.executeRootSelectionSet = exports.execute = exports.createSourceEventStream = exports.responsePathAsArray = void 0;
+exports.getDirectiveValues = exports.getVariableValues = exports.getArgumentValues = exports.AbortedGraphQLExecutionError = exports.legacyExecuteRootSelectionSet = exports.legacyExecuteIncrementally = exports.validateSubscriptionArgs = exports.validateExecutionArgs = exports.subscribe = exports.mapSourceToResponseEvent = exports.defaultTypeResolver = exports.defaultFieldResolver = exports.experimentalExecuteRootSelectionSet = exports.experimentalExecuteIncrementally = exports.executeSync = exports.executeSubscriptionEvent = exports.executeRootSelectionSet = exports.execute = exports.createSourceEventStream = exports.responsePathAsArray = void 0;
 var Path_ts_1 = require("../jsutils/Path.js");
 Object.defineProperty(exports, "responsePathAsArray", { enumerable: true, get: function () { return Path_ts_1.pathToArray; } });
 var execute_ts_1 = require("./execute.js");
@@ -17,6 +17,9 @@ Object.defineProperty(exports, "mapSourceToResponseEvent", { enumerable: true, g
 Object.defineProperty(exports, "subscribe", { enumerable: true, get: function () { return execute_ts_1.subscribe; } });
 Object.defineProperty(exports, "validateExecutionArgs", { enumerable: true, get: function () { return execute_ts_1.validateExecutionArgs; } });
 Object.defineProperty(exports, "validateSubscriptionArgs", { enumerable: true, get: function () { return execute_ts_1.validateSubscriptionArgs; } });
+var legacyExecuteIncrementally_ts_1 = require("./legacyIncremental/legacyExecuteIncrementally.js");
+Object.defineProperty(exports, "legacyExecuteIncrementally", { enumerable: true, get: function () { return legacyExecuteIncrementally_ts_1.legacyExecuteIncrementally; } });
+Object.defineProperty(exports, "legacyExecuteRootSelectionSet", { enumerable: true, get: function () { return legacyExecuteIncrementally_ts_1.legacyExecuteRootSelectionSet; } });
 var AbortedGraphQLExecutionError_ts_1 = require("./AbortedGraphQLExecutionError.js");
 Object.defineProperty(exports, "AbortedGraphQLExecutionError", { enumerable: true, get: function () { return AbortedGraphQLExecutionError_ts_1.AbortedGraphQLExecutionError; } });
 var values_ts_1 = require("./values.js");

package/execution/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":";;;AAAA,8CAAwE;AAA/D,8GAAA,WAAW,OAAuB;AAE3C,2CAcsB;AAbpB,qHAAA,uBAAuB,OAAA;AACvB,qGAAA,OAAO,OAAA;AACP,qHAAA,uBAAuB,OAAA;AACvB,sHAAA,wBAAwB,OAAA;AACxB,yGAAA,WAAW,OAAA;AACX,8HAAA,gCAAgC,OAAA;AAChC,iIAAA,mCAAmC,OAAA;AACnC,kHAAA,oBAAoB,OAAA;AACpB,iHAAA,mBAAmB,OAAA;AACnB,sHAAA,wBAAwB,OAAA;AACxB,uGAAA,SAAS,OAAA;AACT,mHAAA,qBAAqB,OAAA;AACrB,sHAAA,wBAAwB,OAAA;AA4B1B,qFAAiF;AAAxE,+IAAA,4BAA4B,OAAA;AAErC,yCAIqB;AAHnB,8GAAA,iBAAiB,OAAA;AACjB,8GAAA,iBAAiB,OAAA;AACjB,+GAAA,kBAAkB,OAAA","sourcesContent":["export { pathToArray as responsePathAsArray } from '../jsutils/Path.ts';\n\nexport {\n  createSourceEventStream,\n  execute,\n  executeRootSelectionSet,\n  executeSubscriptionEvent,\n  executeSync,\n  experimentalExecuteIncrementally,\n  experimentalExecuteRootSelectionSet,\n  defaultFieldResolver,\n  defaultTypeResolver,\n  mapSourceToResponseEvent,\n  subscribe,\n  validateExecutionArgs,\n  validateSubscriptionArgs,\n} from './execute.ts';\nexport type { ExecutionArgs, RootSelectionSetExecutor } from './execute.ts';\n\nexport type { AsyncWorkFinishedInfo, ExecutionHooks } from './hooks.ts';\n\nexport type {\n  ValidatedExecutionArgs,\n  ValidatedSubscriptionArgs,\n  ExecutionResult,\n  FormattedExecutionResult,\n} from './Executor.ts';\n\nexport type {\n  ExperimentalIncrementalExecutionResults,\n  InitialIncrementalExecutionResult,\n  SubsequentIncrementalExecutionResult,\n  IncrementalDeferResult,\n  IncrementalStreamResult,\n  IncrementalResult,\n  FormattedExperimentalIncrementalExecutionResults,\n  FormattedInitialIncrementalExecutionResult,\n  FormattedSubsequentIncrementalExecutionResult,\n  FormattedIncrementalDeferResult,\n  FormattedIncrementalStreamResult,\n  FormattedIncrementalResult,\n} from './incremental/IncrementalExecutor.ts';\n\nexport { AbortedGraphQLExecutionError } from './AbortedGraphQLExecutionError.ts';\n\nexport {\n  getArgumentValues,\n  getVariableValues,\n  getDirectiveValues,\n} from './values.ts';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":";;;AAOA,8CAAwE;AAA/D,8GAAA,WAAW,OAAuB;AAE3C,2CAcsB;AAbpB,qHAAA,uBAAuB,OAAA;AACvB,qGAAA,OAAO,OAAA;AACP,qHAAA,uBAAuB,OAAA;AACvB,sHAAA,wBAAwB,OAAA;AACxB,yGAAA,WAAW,OAAA;AACX,8HAAA,gCAAgC,OAAA;AAChC,iIAAA,mCAAmC,OAAA;AACnC,kHAAA,oBAAoB,OAAA;AACpB,iHAAA,mBAAmB,OAAA;AACnB,sHAAA,wBAAwB,OAAA;AACxB,uGAAA,SAAS,OAAA;AACT,mHAAA,qBAAqB,OAAA;AACrB,sHAAA,wBAAwB,OAAA;AAE1B,mGAG2D;AAFzD,2IAAA,0BAA0B,OAAA;AAC1B,8IAAA,6BAA6B,OAAA;AA2C/B,qFAAiF;AAAxE,+IAAA,4BAA4B,OAAA;AAErC,yCAIqB;AAHnB,8GAAA,iBAAiB,OAAA;AACjB,8GAAA,iBAAiB,OAAA;AACjB,+GAAA,kBAAkB,OAAA","sourcesContent":["/**\n * Execute GraphQL operations and produce GraphQL execution results.\n *\n * These exports are also available from the root `graphql` package.\n * @packageDocumentation\n */\n\nexport { pathToArray as responsePathAsArray } from '../jsutils/Path.ts';\n\nexport {\n  createSourceEventStream,\n  execute,\n  executeRootSelectionSet,\n  executeSubscriptionEvent,\n  executeSync,\n  experimentalExecuteIncrementally,\n  experimentalExecuteRootSelectionSet,\n  defaultFieldResolver,\n  defaultTypeResolver,\n  mapSourceToResponseEvent,\n  subscribe,\n  validateExecutionArgs,\n  validateSubscriptionArgs,\n} from './execute.ts';\nexport {\n  legacyExecuteIncrementally,\n  legacyExecuteRootSelectionSet,\n} from './legacyIncremental/legacyExecuteIncrementally.ts';\nexport type {\n  AsyncWorkFinishedInfo,\n  ExecutionArgs,\n  ExecutionHooks,\n  ValidatedExecutionArgs,\n  ValidatedSubscriptionArgs,\n} from './ExecutionArgs.ts';\nexport type { RootSelectionSetExecutor } from './execute.ts';\n\nexport type { ExecutionResult, FormattedExecutionResult } from './Executor.ts';\n\nexport type {\n  ExperimentalIncrementalExecutionResults,\n  InitialIncrementalExecutionResult,\n  SubsequentIncrementalExecutionResult,\n  IncrementalDeferResult,\n  IncrementalStreamResult,\n  IncrementalResult,\n  FormattedExperimentalIncrementalExecutionResults,\n  FormattedInitialIncrementalExecutionResult,\n  FormattedSubsequentIncrementalExecutionResult,\n  FormattedIncrementalDeferResult,\n  FormattedIncrementalStreamResult,\n  FormattedIncrementalResult,\n} from './incremental/IncrementalExecutor.ts';\n\nexport type {\n  LegacyExperimentalIncrementalExecutionResults,\n  LegacyInitialIncrementalExecutionResult,\n  LegacySubsequentIncrementalExecutionResult,\n  LegacyIncrementalDeferResult,\n  LegacyIncrementalStreamResult,\n  LegacyIncrementalResult,\n  FormattedLegacyExperimentalIncrementalExecutionResults,\n  FormattedLegacyInitialIncrementalExecutionResult,\n  FormattedLegacySubsequentIncrementalExecutionResult,\n  FormattedLegacyIncrementalDeferResult,\n  FormattedLegacyIncrementalStreamResult,\n  FormattedLegacyIncrementalResult,\n} from './legacyIncremental/BranchingIncrementalExecutor.ts';\n\nexport { AbortedGraphQLExecutionError } from './AbortedGraphQLExecutionError.ts';\n\nexport {\n  getArgumentValues,\n  getVariableValues,\n  getDirectiveValues,\n} from './values.ts';\nexport type { VariableValues } from './values.ts';\n"]}

package/execution/index.mjs

@@ -1,5 +1,6 @@
 export { pathToArray as responsePathAsArray } from "../jsutils/Path.mjs";
 export { createSourceEventStream, execute, executeRootSelectionSet, executeSubscriptionEvent, executeSync, experimentalExecuteIncrementally, experimentalExecuteRootSelectionSet, defaultFieldResolver, defaultTypeResolver, mapSourceToResponseEvent, subscribe, validateExecutionArgs, validateSubscriptionArgs, } from "./execute.mjs";
+export { legacyExecuteIncrementally, legacyExecuteRootSelectionSet, } from "./legacyIncremental/legacyExecuteIncrementally.mjs";
 export { AbortedGraphQLExecutionError } from "./AbortedGraphQLExecutionError.mjs";
 export { getArgumentValues, getVariableValues, getDirectiveValues, } from "./values.mjs";
 //# sourceMappingURL=index.js.map

package/execution/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,IAAI,mBAAmB,EAAE,4BAA2B;AAExE,OAAO,EACL,uBAAuB,EACvB,OAAO,EACP,uBAAuB,EACvB,wBAAwB,EACxB,WAAW,EACX,gCAAgC,EAChC,mCAAmC,EACnC,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,SAAS,EACT,qBAAqB,EACrB,wBAAwB,GACzB,sBAAqB;AA2BtB,OAAO,EAAE,4BAA4B,EAAE,2CAA0C;AAEjF,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,GACnB,qBAAoB","sourcesContent":["export { pathToArray as responsePathAsArray } from '../jsutils/Path.ts';\n\nexport {\n  createSourceEventStream,\n  execute,\n  executeRootSelectionSet,\n  executeSubscriptionEvent,\n  executeSync,\n  experimentalExecuteIncrementally,\n  experimentalExecuteRootSelectionSet,\n  defaultFieldResolver,\n  defaultTypeResolver,\n  mapSourceToResponseEvent,\n  subscribe,\n  validateExecutionArgs,\n  validateSubscriptionArgs,\n} from './execute.ts';\nexport type { ExecutionArgs, RootSelectionSetExecutor } from './execute.ts';\n\nexport type { AsyncWorkFinishedInfo, ExecutionHooks } from './hooks.ts';\n\nexport type {\n  ValidatedExecutionArgs,\n  ValidatedSubscriptionArgs,\n  ExecutionResult,\n  FormattedExecutionResult,\n} from './Executor.ts';\n\nexport type {\n  ExperimentalIncrementalExecutionResults,\n  InitialIncrementalExecutionResult,\n  SubsequentIncrementalExecutionResult,\n  IncrementalDeferResult,\n  IncrementalStreamResult,\n  IncrementalResult,\n  FormattedExperimentalIncrementalExecutionResults,\n  FormattedInitialIncrementalExecutionResult,\n  FormattedSubsequentIncrementalExecutionResult,\n  FormattedIncrementalDeferResult,\n  FormattedIncrementalStreamResult,\n  FormattedIncrementalResult,\n} from './incremental/IncrementalExecutor.ts';\n\nexport { AbortedGraphQLExecutionError } from './AbortedGraphQLExecutionError.ts';\n\nexport {\n  getArgumentValues,\n  getVariableValues,\n  getDirectiveValues,\n} from './values.ts';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,IAAI,mBAAmB,EAAE,4BAA2B;AAExE,OAAO,EACL,uBAAuB,EACvB,OAAO,EACP,uBAAuB,EACvB,wBAAwB,EACxB,WAAW,EACX,gCAAgC,EAChC,mCAAmC,EACnC,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,SAAS,EACT,qBAAqB,EACrB,wBAAwB,GACzB,sBAAqB;AACtB,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,GAC9B,2DAA0D;AA0C3D,OAAO,EAAE,4BAA4B,EAAE,2CAA0C;AAEjF,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,GACnB,qBAAoB","sourcesContent":["/**\n * Execute GraphQL operations and produce GraphQL execution results.\n *\n * These exports are also available from the root `graphql` package.\n * @packageDocumentation\n */\n\nexport { pathToArray as responsePathAsArray } from '../jsutils/Path.ts';\n\nexport {\n  createSourceEventStream,\n  execute,\n  executeRootSelectionSet,\n  executeSubscriptionEvent,\n  executeSync,\n  experimentalExecuteIncrementally,\n  experimentalExecuteRootSelectionSet,\n  defaultFieldResolver,\n  defaultTypeResolver,\n  mapSourceToResponseEvent,\n  subscribe,\n  validateExecutionArgs,\n  validateSubscriptionArgs,\n} from './execute.ts';\nexport {\n  legacyExecuteIncrementally,\n  legacyExecuteRootSelectionSet,\n} from './legacyIncremental/legacyExecuteIncrementally.ts';\nexport type {\n  AsyncWorkFinishedInfo,\n  ExecutionArgs,\n  ExecutionHooks,\n  ValidatedExecutionArgs,\n  ValidatedSubscriptionArgs,\n} from './ExecutionArgs.ts';\nexport type { RootSelectionSetExecutor } from './execute.ts';\n\nexport type { ExecutionResult, FormattedExecutionResult } from './Executor.ts';\n\nexport type {\n  ExperimentalIncrementalExecutionResults,\n  InitialIncrementalExecutionResult,\n  SubsequentIncrementalExecutionResult,\n  IncrementalDeferResult,\n  IncrementalStreamResult,\n  IncrementalResult,\n  FormattedExperimentalIncrementalExecutionResults,\n  FormattedInitialIncrementalExecutionResult,\n  FormattedSubsequentIncrementalExecutionResult,\n  FormattedIncrementalDeferResult,\n  FormattedIncrementalStreamResult,\n  FormattedIncrementalResult,\n} from './incremental/IncrementalExecutor.ts';\n\nexport type {\n  LegacyExperimentalIncrementalExecutionResults,\n  LegacyInitialIncrementalExecutionResult,\n  LegacySubsequentIncrementalExecutionResult,\n  LegacyIncrementalDeferResult,\n  LegacyIncrementalStreamResult,\n  LegacyIncrementalResult,\n  FormattedLegacyExperimentalIncrementalExecutionResults,\n  FormattedLegacyInitialIncrementalExecutionResult,\n  FormattedLegacySubsequentIncrementalExecutionResult,\n  FormattedLegacyIncrementalDeferResult,\n  FormattedLegacyIncrementalStreamResult,\n  FormattedLegacyIncrementalResult,\n} from './legacyIncremental/BranchingIncrementalExecutor.ts';\n\nexport { AbortedGraphQLExecutionError } from './AbortedGraphQLExecutionError.ts';\n\nexport {\n  getArgumentValues,\n  getVariableValues,\n  getDirectiveValues,\n} from './values.ts';\nexport type { VariableValues } from './values.ts';\n"]}

package/execution/legacyIncremental/BranchingIncrementalExecutor.d.mts

@@ -0,0 +1,175 @@
+/** @category Legacy Incremental Execution */
+import type { ObjMap } from "../../jsutils/ObjMap.mjs";
+import type { GraphQLError, GraphQLFormattedError } from "../../error/GraphQLError.mjs";
+import type { GroupedFieldSet } from "../collectFields.mjs";
+import type { ExecutionResult, FormattedExecutionResult } from "../Executor.mjs";
+import type { DeferUsageSet, ExecutionPlan } from "../incremental/buildExecutionPlan.mjs";
+import { IncrementalExecutor } from "../incremental/IncrementalExecutor.mjs";
+/**
+ * Results for an operation that produced legacy incremental payloads.
+ * @typeParam TInitialData - Shape of the initial result data payload.
+ * @typeParam TDeferredData - Shape of deferred fragment data payloads.
+ * @typeParam TStreamItem - Shape of streamed list items.
+ * @typeParam TExtensions - Shape of extensions payloads.
+ */
+export interface LegacyExperimentalIncrementalExecutionResults<TInitialData = ObjMap<unknown>, TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> {
+    /** Initial execution result delivered before subsequent legacy incremental payloads. */
+    initialResult: LegacyInitialIncrementalExecutionResult<TInitialData, TExtensions>;
+    /** Async stream of legacy incremental payloads delivered after the initial result. */
+    subsequentResults: AsyncGenerator<LegacySubsequentIncrementalExecutionResult<TDeferredData, TStreamItem, TExtensions>, void, void>;
+}
+/**
+ * Initial execution result for an operation that produced legacy incremental payloads.
+ *
+ * Unlike `InitialIncrementalExecutionResult`, the legacy initial result does
+ * not include a `pending` list. Subsequent payloads identify their location
+ * directly with `path` and optional `label` fields.
+ * @typeParam TInitialData - Shape of the initial data payload.
+ * @typeParam TExtensions - Shape of the extensions payload.
+ */
+export interface LegacyInitialIncrementalExecutionResult<TInitialData = ObjMap<unknown>, TExtensions = ObjMap<unknown>> extends ExecutionResult<TInitialData, TExtensions> {
+    /** Data produced by the initial execution payload. */
+    data: TInitialData;
+    /** Indicates that subsequent legacy incremental payloads will follow. */
+    hasNext: true;
+    /** Additional non-standard metadata included in the initial result. */
+    extensions?: TExtensions;
+}
+/**
+ * Subsequent payload produced by legacy incremental execution.
+ *
+ * Legacy subsequent payloads may contain deferred fragment data, streamed list
+ * items, or only `hasNext: false` to complete the response stream.
+ * @typeParam TDeferredData - Shape of deferred fragment data payloads.
+ * @typeParam TStreamItem - Shape of streamed list items.
+ * @typeParam TExtensions - Shape of the extensions payload.
+ */
+export interface LegacySubsequentIncrementalExecutionResult<TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> {
+    /** Deferred or streamed payloads delivered by this response. */
+    incremental?: ReadonlyArray<LegacyIncrementalResult<TDeferredData, TStreamItem, TExtensions>>;
+    /** Indicates whether more legacy incremental payloads will follow. */
+    hasNext: boolean;
+    /** Additional non-standard metadata included in this payload. */
+    extensions?: TExtensions;
+}
+/**
+ * Deferred fragment or streamed list payload produced by legacy incremental execution.
+ * @typeParam TDeferredData - Shape of deferred fragment data.
+ * @typeParam TStreamItem - Shape of streamed list items.
+ * @typeParam TExtensions - Shape of extensions payloads.
+ */
+export type LegacyIncrementalResult<TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> = LegacyIncrementalDeferResult<TDeferredData, TExtensions> | LegacyIncrementalStreamResult<TStreamItem, TExtensions>;
+/**
+ * Legacy incremental payload produced by a deferred fragment.
+ *
+ * The payload location is identified directly by `path` and optional `label`
+ * instead of by an `id` from a pending entry.
+ * @typeParam TDeferredData - Shape of deferred fragment data.
+ * @typeParam TExtensions - Shape of extensions payloads.
+ */
+export interface LegacyIncrementalDeferResult<TDeferredData = ObjMap<unknown>, TExtensions = ObjMap<unknown>> extends ExecutionResult<TDeferredData, TExtensions> {
+    /** Response path to the deferred fragment payload. */
+    path: ReadonlyArray<string | number>;
+    /** Label from the `@defer` directive. */
+    label?: string;
+}
+/**
+ * Legacy incremental payload produced by a streamed list field.
+ * @typeParam TStreamItem - Shape of streamed list items.
+ * @typeParam TExtensions - Shape of extensions payloads.
+ */
+export interface LegacyIncrementalStreamResult<TStreamItem = unknown, TExtensions = ObjMap<unknown>> {
+    /** Errors raised while producing streamed items. */
+    errors?: ReadonlyArray<GraphQLError>;
+    /** Streamed list items delivered by this payload. */
+    items: ReadonlyArray<TStreamItem> | null;
+    /** Response path to the first streamed list item in this payload. */
+    path: ReadonlyArray<string | number>;
+    /** Label from the `@stream` directive. */
+    label?: string;
+    /** Additional non-standard metadata included in this payload. */
+    extensions?: TExtensions;
+}
+/**
+ * JSON-serializable form of legacy incremental execution results.
+ * @typeParam TInitialData - Shape of the formatted initial result data payload.
+ * @typeParam TDeferredData - Shape of formatted deferred fragment data payloads.
+ * @typeParam TStreamItem - Shape of formatted streamed list items.
+ * @typeParam TExtensions - Shape of formatted extensions payloads.
+ */
+export interface FormattedLegacyExperimentalIncrementalExecutionResults<TInitialData = ObjMap<unknown>, TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> {
+    /** Formatted initial execution result. */
+    initialResult: FormattedLegacyInitialIncrementalExecutionResult<TInitialData, TExtensions>;
+    /** Async stream of formatted legacy incremental payloads. */
+    subsequentResults: AsyncGenerator<FormattedLegacySubsequentIncrementalExecutionResult<TDeferredData, TStreamItem, TExtensions>, void, void>;
+}
+/**
+ * JSON-serializable form of a legacy initial incremental execution result.
+ * @typeParam TInitialData - Shape of the formatted initial data payload.
+ * @typeParam TExtensions - Shape of the formatted extensions payload.
+ */
+export interface FormattedLegacyInitialIncrementalExecutionResult<TInitialData = ObjMap<unknown>, TExtensions = ObjMap<unknown>> extends FormattedExecutionResult<TInitialData, TExtensions> {
+    /** Formatted data produced by the initial execution payload. */
+    data: TInitialData;
+    /** Indicates that subsequent legacy incremental payloads will follow. */
+    hasNext: true;
+    /** Additional non-standard metadata included in the formatted initial result. */
+    extensions?: TExtensions;
+}
+/**
+ * JSON-serializable form of a legacy subsequent incremental execution payload.
+ * @typeParam TDeferredData - Shape of formatted deferred fragment data payloads.
+ * @typeParam TStreamItem - Shape of formatted streamed list items.
+ * @typeParam TExtensions - Shape of formatted extensions payloads.
+ */
+export interface FormattedLegacySubsequentIncrementalExecutionResult<TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> {
+    /** Formatted deferred or streamed payloads delivered by this response. */
+    incremental?: ReadonlyArray<FormattedLegacyIncrementalResult<TDeferredData, TStreamItem, TExtensions>>;
+    /** Indicates whether more legacy incremental payloads will follow. */
+    hasNext: boolean;
+    /** Additional non-standard metadata included in this formatted payload. */
+    extensions?: TExtensions;
+}
+/**
+ * JSON-serializable deferred fragment or streamed list payload produced by
+ * legacy incremental execution.
+ * @typeParam TDeferredData - Shape of formatted deferred fragment data.
+ * @typeParam TStreamItem - Shape of formatted streamed list items.
+ * @typeParam TExtensions - Shape of formatted extensions payloads.
+ */
+export type FormattedLegacyIncrementalResult<TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> = FormattedLegacyIncrementalDeferResult<TDeferredData, TExtensions> | FormattedLegacyIncrementalStreamResult<TStreamItem, TExtensions>;
+/**
+ * JSON-serializable form of a legacy deferred fragment payload.
+ * @typeParam TDeferredData - Shape of formatted deferred fragment data.
+ * @typeParam TExtensions - Shape of formatted extensions payloads.
+ */
+export interface FormattedLegacyIncrementalDeferResult<TDeferredData = ObjMap<unknown>, TExtensions = ObjMap<unknown>> extends FormattedExecutionResult<TDeferredData, TExtensions> {
+    /** Response path to the formatted deferred fragment payload. */
+    path: ReadonlyArray<string | number>;
+    /** Label from the `@defer` directive. */
+    label?: string;
+}
+/**
+ * JSON-serializable form of a legacy streamed list payload.
+ * @typeParam TStreamItem - Shape of formatted streamed list items.
+ * @typeParam TExtensions - Shape of formatted extensions payloads.
+ */
+export interface FormattedLegacyIncrementalStreamResult<TStreamItem = unknown, TExtensions = ObjMap<unknown>> {
+    /** Formatted errors raised while producing streamed items. */
+    errors?: ReadonlyArray<GraphQLFormattedError>;
+    /** Formatted streamed list items delivered by this payload. */
+    items: ReadonlyArray<TStreamItem> | null;
+    /** Response path to the first streamed list item in this formatted payload. */
+    path: ReadonlyArray<string | number>;
+    /** Label from the `@stream` directive. */
+    label?: string;
+    /** Additional non-standard metadata included in this formatted payload. */
+    extensions?: TExtensions;
+}
+/** @internal */
+export declare class BranchingIncrementalExecutor extends IncrementalExecutor<LegacyExperimentalIncrementalExecutionResults> {
+    getCreateSubExecutor(): (deferUsageSet?: DeferUsageSet) => BranchingIncrementalExecutor;
+    buildResponse(data: ObjMap<unknown> | null): ExecutionResult | LegacyExperimentalIncrementalExecutionResults;
+    buildRootExecutionPlan(originalGroupedFieldSet: GroupedFieldSet): ExecutionPlan;
+    buildSubExecutionPlan(originalGroupedFieldSet: GroupedFieldSet): ExecutionPlan;
+}

package/execution/legacyIncremental/BranchingIncrementalExecutor.d.ts

@@ -0,0 +1,175 @@
+/** @category Legacy Incremental Execution */
+import type { ObjMap } from "../../jsutils/ObjMap.js";
+import type { GraphQLError, GraphQLFormattedError } from "../../error/GraphQLError.js";
+import type { GroupedFieldSet } from "../collectFields.js";
+import type { ExecutionResult, FormattedExecutionResult } from "../Executor.js";
+import type { DeferUsageSet, ExecutionPlan } from "../incremental/buildExecutionPlan.js";
+import { IncrementalExecutor } from "../incremental/IncrementalExecutor.js";
+/**
+ * Results for an operation that produced legacy incremental payloads.
+ * @typeParam TInitialData - Shape of the initial result data payload.
+ * @typeParam TDeferredData - Shape of deferred fragment data payloads.
+ * @typeParam TStreamItem - Shape of streamed list items.
+ * @typeParam TExtensions - Shape of extensions payloads.
+ */
+export interface LegacyExperimentalIncrementalExecutionResults<TInitialData = ObjMap<unknown>, TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> {
+    /** Initial execution result delivered before subsequent legacy incremental payloads. */
+    initialResult: LegacyInitialIncrementalExecutionResult<TInitialData, TExtensions>;
+    /** Async stream of legacy incremental payloads delivered after the initial result. */
+    subsequentResults: AsyncGenerator<LegacySubsequentIncrementalExecutionResult<TDeferredData, TStreamItem, TExtensions>, void, void>;
+}
+/**
+ * Initial execution result for an operation that produced legacy incremental payloads.
+ *
+ * Unlike `InitialIncrementalExecutionResult`, the legacy initial result does
+ * not include a `pending` list. Subsequent payloads identify their location
+ * directly with `path` and optional `label` fields.
+ * @typeParam TInitialData - Shape of the initial data payload.
+ * @typeParam TExtensions - Shape of the extensions payload.
+ */
+export interface LegacyInitialIncrementalExecutionResult<TInitialData = ObjMap<unknown>, TExtensions = ObjMap<unknown>> extends ExecutionResult<TInitialData, TExtensions> {
+    /** Data produced by the initial execution payload. */
+    data: TInitialData;
+    /** Indicates that subsequent legacy incremental payloads will follow. */
+    hasNext: true;
+    /** Additional non-standard metadata included in the initial result. */
+    extensions?: TExtensions;
+}
+/**
+ * Subsequent payload produced by legacy incremental execution.
+ *
+ * Legacy subsequent payloads may contain deferred fragment data, streamed list
+ * items, or only `hasNext: false` to complete the response stream.
+ * @typeParam TDeferredData - Shape of deferred fragment data payloads.
+ * @typeParam TStreamItem - Shape of streamed list items.
+ * @typeParam TExtensions - Shape of the extensions payload.
+ */
+export interface LegacySubsequentIncrementalExecutionResult<TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> {
+    /** Deferred or streamed payloads delivered by this response. */
+    incremental?: ReadonlyArray<LegacyIncrementalResult<TDeferredData, TStreamItem, TExtensions>>;
+    /** Indicates whether more legacy incremental payloads will follow. */
+    hasNext: boolean;
+    /** Additional non-standard metadata included in this payload. */
+    extensions?: TExtensions;
+}
+/**
+ * Deferred fragment or streamed list payload produced by legacy incremental execution.
+ * @typeParam TDeferredData - Shape of deferred fragment data.
+ * @typeParam TStreamItem - Shape of streamed list items.
+ * @typeParam TExtensions - Shape of extensions payloads.
+ */
+export type LegacyIncrementalResult<TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> = LegacyIncrementalDeferResult<TDeferredData, TExtensions> | LegacyIncrementalStreamResult<TStreamItem, TExtensions>;
+/**
+ * Legacy incremental payload produced by a deferred fragment.
+ *
+ * The payload location is identified directly by `path` and optional `label`
+ * instead of by an `id` from a pending entry.
+ * @typeParam TDeferredData - Shape of deferred fragment data.
+ * @typeParam TExtensions - Shape of extensions payloads.
+ */
+export interface LegacyIncrementalDeferResult<TDeferredData = ObjMap<unknown>, TExtensions = ObjMap<unknown>> extends ExecutionResult<TDeferredData, TExtensions> {
+    /** Response path to the deferred fragment payload. */
+    path: ReadonlyArray<string | number>;
+    /** Label from the `@defer` directive. */
+    label?: string;
+}
+/**
+ * Legacy incremental payload produced by a streamed list field.
+ * @typeParam TStreamItem - Shape of streamed list items.
+ * @typeParam TExtensions - Shape of extensions payloads.
+ */
+export interface LegacyIncrementalStreamResult<TStreamItem = unknown, TExtensions = ObjMap<unknown>> {
+    /** Errors raised while producing streamed items. */
+    errors?: ReadonlyArray<GraphQLError>;
+    /** Streamed list items delivered by this payload. */
+    items: ReadonlyArray<TStreamItem> | null;
+    /** Response path to the first streamed list item in this payload. */
+    path: ReadonlyArray<string | number>;
+    /** Label from the `@stream` directive. */
+    label?: string;
+    /** Additional non-standard metadata included in this payload. */
+    extensions?: TExtensions;
+}
+/**
+ * JSON-serializable form of legacy incremental execution results.
+ * @typeParam TInitialData - Shape of the formatted initial result data payload.
+ * @typeParam TDeferredData - Shape of formatted deferred fragment data payloads.
+ * @typeParam TStreamItem - Shape of formatted streamed list items.
+ * @typeParam TExtensions - Shape of formatted extensions payloads.
+ */
+export interface FormattedLegacyExperimentalIncrementalExecutionResults<TInitialData = ObjMap<unknown>, TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> {
+    /** Formatted initial execution result. */
+    initialResult: FormattedLegacyInitialIncrementalExecutionResult<TInitialData, TExtensions>;
+    /** Async stream of formatted legacy incremental payloads. */
+    subsequentResults: AsyncGenerator<FormattedLegacySubsequentIncrementalExecutionResult<TDeferredData, TStreamItem, TExtensions>, void, void>;
+}
+/**
+ * JSON-serializable form of a legacy initial incremental execution result.
+ * @typeParam TInitialData - Shape of the formatted initial data payload.
+ * @typeParam TExtensions - Shape of the formatted extensions payload.
+ */
+export interface FormattedLegacyInitialIncrementalExecutionResult<TInitialData = ObjMap<unknown>, TExtensions = ObjMap<unknown>> extends FormattedExecutionResult<TInitialData, TExtensions> {
+    /** Formatted data produced by the initial execution payload. */
+    data: TInitialData;
+    /** Indicates that subsequent legacy incremental payloads will follow. */
+    hasNext: true;
+    /** Additional non-standard metadata included in the formatted initial result. */
+    extensions?: TExtensions;
+}
+/**
+ * JSON-serializable form of a legacy subsequent incremental execution payload.
+ * @typeParam TDeferredData - Shape of formatted deferred fragment data payloads.
+ * @typeParam TStreamItem - Shape of formatted streamed list items.
+ * @typeParam TExtensions - Shape of formatted extensions payloads.
+ */
+export interface FormattedLegacySubsequentIncrementalExecutionResult<TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> {
+    /** Formatted deferred or streamed payloads delivered by this response. */
+    incremental?: ReadonlyArray<FormattedLegacyIncrementalResult<TDeferredData, TStreamItem, TExtensions>>;
+    /** Indicates whether more legacy incremental payloads will follow. */
+    hasNext: boolean;
+    /** Additional non-standard metadata included in this formatted payload. */
+    extensions?: TExtensions;
+}
+/**
+ * JSON-serializable deferred fragment or streamed list payload produced by
+ * legacy incremental execution.
+ * @typeParam TDeferredData - Shape of formatted deferred fragment data.
+ * @typeParam TStreamItem - Shape of formatted streamed list items.
+ * @typeParam TExtensions - Shape of formatted extensions payloads.
+ */
+export type FormattedLegacyIncrementalResult<TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> = FormattedLegacyIncrementalDeferResult<TDeferredData, TExtensions> | FormattedLegacyIncrementalStreamResult<TStreamItem, TExtensions>;
+/**
+ * JSON-serializable form of a legacy deferred fragment payload.
+ * @typeParam TDeferredData - Shape of formatted deferred fragment data.
+ * @typeParam TExtensions - Shape of formatted extensions payloads.
+ */
+export interface FormattedLegacyIncrementalDeferResult<TDeferredData = ObjMap<unknown>, TExtensions = ObjMap<unknown>> extends FormattedExecutionResult<TDeferredData, TExtensions> {
+    /** Response path to the formatted deferred fragment payload. */
+    path: ReadonlyArray<string | number>;
+    /** Label from the `@defer` directive. */
+    label?: string;
+}
+/**
+ * JSON-serializable form of a legacy streamed list payload.
+ * @typeParam TStreamItem - Shape of formatted streamed list items.
+ * @typeParam TExtensions - Shape of formatted extensions payloads.
+ */
+export interface FormattedLegacyIncrementalStreamResult<TStreamItem = unknown, TExtensions = ObjMap<unknown>> {
+    /** Formatted errors raised while producing streamed items. */
+    errors?: ReadonlyArray<GraphQLFormattedError>;
+    /** Formatted streamed list items delivered by this payload. */
+    items: ReadonlyArray<TStreamItem> | null;
+    /** Response path to the first streamed list item in this formatted payload. */
+    path: ReadonlyArray<string | number>;
+    /** Label from the `@stream` directive. */
+    label?: string;
+    /** Additional non-standard metadata included in this formatted payload. */
+    extensions?: TExtensions;
+}
+/** @internal */
+export declare class BranchingIncrementalExecutor extends IncrementalExecutor<LegacyExperimentalIncrementalExecutionResults> {
+    getCreateSubExecutor(): (deferUsageSet?: DeferUsageSet) => BranchingIncrementalExecutor;
+    buildResponse(data: ObjMap<unknown> | null): ExecutionResult | LegacyExperimentalIncrementalExecutionResults;
+    buildRootExecutionPlan(originalGroupedFieldSet: GroupedFieldSet): ExecutionPlan;
+    buildSubExecutionPlan(originalGroupedFieldSet: GroupedFieldSet): ExecutionPlan;
+}

package/execution/legacyIncremental/BranchingIncrementalExecutor.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BranchingIncrementalExecutor = void 0;
+const AccumulatorMap_ts_1 = require("../../jsutils/AccumulatorMap.js");
+const getBySet_ts_1 = require("../../jsutils/getBySet.js");
+const invariant_ts_1 = require("../../jsutils/invariant.js");
+const isSameSet_ts_1 = require("../../jsutils/isSameSet.js");
+const memoize1_ts_1 = require("../../jsutils/memoize1.js");
+const memoize2_ts_1 = require("../../jsutils/memoize2.js");
+const IncrementalExecutor_ts_1 = require("../incremental/IncrementalExecutor.js");
+const BranchingIncrementalPublisher_ts_1 = require("./BranchingIncrementalPublisher.js");
+const buildBranchingExecutionPlanFromInitial = (0, memoize1_ts_1.memoize1)((groupedFieldSet) => buildBranchingExecutionPlan(groupedFieldSet));
+const buildBranchingExecutionPlanFromDeferred = (0, memoize2_ts_1.memoize2)((groupedFieldSet, deferUsageSet) => buildBranchingExecutionPlan(groupedFieldSet, deferUsageSet));
+class BranchingIncrementalExecutor extends IncrementalExecutor_ts_1.IncrementalExecutor {
+    getCreateSubExecutor() {
+        const validatedExecutionArgs = this.validatedExecutionArgs;
+        const sharedExecutionContext = this.sharedExecutionContext;
+        return (deferUsageSet) => new BranchingIncrementalExecutor(validatedExecutionArgs, sharedExecutionContext, deferUsageSet);
+    }
+    buildResponse(data) {
+        const work = this.getIncrementalWork();
+        const { tasks, streams } = work;
+        if (tasks?.length === 0 && streams?.length === 0) {
+            return super.buildResponse(data);
+        }
+        const errors = this.collectedErrors.errors;
+        if (!(data !== null))
+            (0, invariant_ts_1.invariant)(false);
+        const incrementalPublisher = new BranchingIncrementalPublisher_ts_1.BranchingIncrementalPublisher();
+        return incrementalPublisher.buildResponse(data, errors, work, this.validatedExecutionArgs.externalAbortSignal, this.getFinishSharedExecution());
+    }
+    buildRootExecutionPlan(originalGroupedFieldSet) {
+        return buildBranchingExecutionPlanFromInitial(originalGroupedFieldSet);
+    }
+    buildSubExecutionPlan(originalGroupedFieldSet) {
+        return this.deferUsageSet === undefined
+            ? buildBranchingExecutionPlanFromInitial(originalGroupedFieldSet)
+            : buildBranchingExecutionPlanFromDeferred(originalGroupedFieldSet, this.deferUsageSet);
+    }
+}
+exports.BranchingIncrementalExecutor = BranchingIncrementalExecutor;
+function buildBranchingExecutionPlan(originalGroupedFieldSet, parentDeferUsages = new Set()) {
+    const groupedFieldSet = new AccumulatorMap_ts_1.AccumulatorMap();
+    const newGroupedFieldSets = new Map();
+    for (const [responseKey, fieldGroup] of originalGroupedFieldSet) {
+        for (const fieldDetails of fieldGroup) {
+            const deferUsage = fieldDetails.deferUsage;
+            const deferUsageSet = deferUsage === undefined
+                ? new Set()
+                : new Set([deferUsage]);
+            if ((0, isSameSet_ts_1.isSameSet)(parentDeferUsages, deferUsageSet)) {
+                groupedFieldSet.add(responseKey, fieldDetails);
+            }
+            else {
+                let newGroupedFieldSet = (0, getBySet_ts_1.getBySet)(newGroupedFieldSets, deferUsageSet);
+                if (newGroupedFieldSet === undefined) {
+                    newGroupedFieldSet = new AccumulatorMap_ts_1.AccumulatorMap();
+                    newGroupedFieldSets.set(deferUsageSet, newGroupedFieldSet);
+                }
+                newGroupedFieldSet.add(responseKey, fieldDetails);
+            }
+        }
+    }
+    return {
+        groupedFieldSet,
+        newGroupedFieldSets,
+    };
+}
+//# sourceMappingURL=BranchingIncrementalExecutor.js.map

package/execution/legacyIncremental/BranchingIncrementalExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BranchingIncrementalExecutor.js","sourceRoot":"","sources":["../../../src/execution/legacyIncremental/BranchingIncrementalExecutor.ts"],"names":[],"mappings":";;;AAEA,uEAAiE;AACjE,2DAAqD;AACrD,6DAAuD;AACvD,6DAAuD;AACvD,2DAAqD;AACrD,2DAAqD;AAkBrD,kFAA4E;AAE5E,yFAAmF;AAkInF,MAAM,sCAAsC,GAAG,IAAA,sBAAQ,EACrD,CAAC,eAAgC,EAAE,EAAE,CACnC,2BAA2B,CAAC,eAAe,CAAC,CAC/C,CAAC;AAEF,MAAM,uCAAuC,GAAG,IAAA,sBAAQ,EACtD,CAAC,eAAgC,EAAE,aAA4B,EAAE,EAAE,CACjE,2BAA2B,CAAC,eAAe,EAAE,aAAa,CAAC,CAC9D,CAAC;AAyHF,MAAa,4BAA6B,SAAQ,4CAAkE;IACzG,oBAAoB;QAG3B,MAAM,sBAAsB,GAAG,IAAI,CAAC,sBAAsB,CAAC;QAC3D,MAAM,sBAAsB,GAAG,IAAI,CAAC,sBAAsB,CAAC;QAE3D,OAAO,CAAC,aAA6B,EAAE,EAAE,CACvC,IAAI,4BAA4B,CAC9B,sBAAsB,EACtB,sBAAsB,EACtB,aAAa,CACd,CAAC;IACN,CAAC;IAEQ,aAAa,CACpB,IAA4B;QAE5B,MAAM,IAAI,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACvC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAChC,IAAI,KAAK,EAAE,MAAM,KAAK,CAAC,IAAI,OAAO,EAAE,MAAM,KAAK,CAAC,EAAE,CAAC;YACjD,OAAO,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC;cACjC,IAAI,KAAK,IAAI;gBAAvB,wBAAS;QACT,MAAM,oBAAoB,GAAG,IAAI,gEAA6B,EAAE,CAAC;QACjE,OAAO,oBAAoB,CAAC,aAAa,CACvC,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,IAAI,CAAC,sBAAsB,CAAC,mBAAmB,EAC/C,IAAI,CAAC,wBAAwB,EAAE,CAChC,CAAC;IACJ,CAAC;IAEQ,sBAAsB,CAC7B,uBAAwC;QAExC,OAAO,sCAAsC,CAAC,uBAAuB,CAAC,CAAC;IACzE,CAAC;IAEQ,qBAAqB,CAC5B,uBAAwC;QAExC,OAAO,IAAI,CAAC,aAAa,KAAK,SAAS;YACrC,CAAC,CAAC,sCAAsC,CAAC,uBAAuB,CAAC;YACjE,CAAC,CAAC,uCAAuC,CACrC,uBAAuB,EACvB,IAAI,CAAC,aAAa,CACnB,CAAC;IACR,CAAC;CACF;AApDD,oEAoDC;AAED,SAAS,2BAA2B,CAClC,uBAAwC,EACxC,oBAAmC,IAAI,GAAG,EAAc;IAExD,MAAM,eAAe,GAAG,IAAI,kCAAc,EAAwB,CAAC;IAEnE,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAGhC,CAAC;IAEJ,KAAK,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC,IAAI,uBAAuB,EAAE,CAAC;QAChE,KAAK,MAAM,YAAY,IAAI,UAAU,EAAE,CAAC;YACtC,MAAM,UAAU,GAAG,YAAY,CAAC,UAAU,CAAC;YAC3C,MAAM,aAAa,GACjB,UAAU,KAAK,SAAS;gBACtB,CAAC,CAAC,IAAI,GAAG,EAAc;gBACvB,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;YAC5B,IAAI,IAAA,wBAAS,EAAC,iBAAiB,EAAE,aAAa,CAAC,EAAE,CAAC;gBAChD,eAAe,CAAC,GAAG,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;YACjD,CAAC;iBAAM,CAAC;gBACN,IAAI,kBAAkB,GAAG,IAAA,sBAAQ,EAAC,mBAAmB,EAAE,aAAa,CAAC,CAAC;gBACtE,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;oBACrC,kBAAkB,GAAG,IAAI,kCAAc,EAAE,CAAC;oBAC1C,mBAAmB,CAAC,GAAG,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;gBAC7D,CAAC;gBACD,kBAAkB,CAAC,GAAG,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,eAAe;QACf,mBAAmB;KACpB,CAAC;AACJ,CAAC","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/BranchingIncrementalExecutor.mjs

@@ -0,0 +1,65 @@
+import { AccumulatorMap } from "../../jsutils/AccumulatorMap.mjs";
+import { getBySet } from "../../jsutils/getBySet.mjs";
+import { invariant } from "../../jsutils/invariant.mjs";
+import { isSameSet } from "../../jsutils/isSameSet.mjs";
+import { memoize1 } from "../../jsutils/memoize1.mjs";
+import { memoize2 } from "../../jsutils/memoize2.mjs";
+import { IncrementalExecutor } from "../incremental/IncrementalExecutor.mjs";
+import { BranchingIncrementalPublisher } from "./BranchingIncrementalPublisher.mjs";
+const buildBranchingExecutionPlanFromInitial = memoize1((groupedFieldSet) => buildBranchingExecutionPlan(groupedFieldSet));
+const buildBranchingExecutionPlanFromDeferred = memoize2((groupedFieldSet, deferUsageSet) => buildBranchingExecutionPlan(groupedFieldSet, deferUsageSet));
+export class BranchingIncrementalExecutor extends IncrementalExecutor {
+    getCreateSubExecutor() {
+        const validatedExecutionArgs = this.validatedExecutionArgs;
+        const sharedExecutionContext = this.sharedExecutionContext;
+        return (deferUsageSet) => new BranchingIncrementalExecutor(validatedExecutionArgs, sharedExecutionContext, deferUsageSet);
+    }
+    buildResponse(data) {
+        const work = this.getIncrementalWork();
+        const { tasks, streams } = work;
+        if (tasks?.length === 0 && streams?.length === 0) {
+            return super.buildResponse(data);
+        }
+        const errors = this.collectedErrors.errors;
+        if (!(data !== null))
+            invariant(false);
+        const incrementalPublisher = new BranchingIncrementalPublisher();
+        return incrementalPublisher.buildResponse(data, errors, work, this.validatedExecutionArgs.externalAbortSignal, this.getFinishSharedExecution());
+    }
+    buildRootExecutionPlan(originalGroupedFieldSet) {
+        return buildBranchingExecutionPlanFromInitial(originalGroupedFieldSet);
+    }
+    buildSubExecutionPlan(originalGroupedFieldSet) {
+        return this.deferUsageSet === undefined
+            ? buildBranchingExecutionPlanFromInitial(originalGroupedFieldSet)
+            : buildBranchingExecutionPlanFromDeferred(originalGroupedFieldSet, this.deferUsageSet);
+    }
+}
+function buildBranchingExecutionPlan(originalGroupedFieldSet, parentDeferUsages = new Set()) {
+    const groupedFieldSet = new AccumulatorMap();
+    const newGroupedFieldSets = new Map();
+    for (const [responseKey, fieldGroup] of originalGroupedFieldSet) {
+        for (const fieldDetails of fieldGroup) {
+            const deferUsage = fieldDetails.deferUsage;
+            const deferUsageSet = deferUsage === undefined
+                ? new Set()
+                : new Set([deferUsage]);
+            if (isSameSet(parentDeferUsages, deferUsageSet)) {
+                groupedFieldSet.add(responseKey, fieldDetails);
+            }
+            else {
+                let newGroupedFieldSet = getBySet(newGroupedFieldSets, deferUsageSet);
+                if (newGroupedFieldSet === undefined) {
+                    newGroupedFieldSet = new AccumulatorMap();
+                    newGroupedFieldSets.set(deferUsageSet, newGroupedFieldSet);
+                }
+                newGroupedFieldSet.add(responseKey, fieldDetails);
+            }
+        }
+    }
+    return {
+        groupedFieldSet,
+        newGroupedFieldSets,
+    };
+}
+//# sourceMappingURL=BranchingIncrementalExecutor.js.map