graphql 17.0.0-rc.0 → 17.0.0

package/execution/execute.d.ts

@@ -14,8 +14,9 @@ export type RootSelectionSetExecutor = (validatedExecutionArgs: ValidatedSubscri
  * are synchronous), or a Promise of an ExecutionResult that will eventually be
  * resolved and never rejected.
  *
- * If the arguments to this function do not result in a legal execution context,
- * a GraphQLError will be thrown immediately explaining the invalid input.
+ * If the schema is invalid, an error will be thrown immediately. GraphQL
+ * request errors, including missing operations and variable coercion errors,
+ * are returned in an errors-only ExecutionResult.
  *
  * Field errors are collected into the response instead of rejecting the
  * returned promise. Only the field that produced the error and its descendants
@@ -62,8 +63,9 @@ export declare function execute(args: ExecutionArgs): PromiseOrValue<ExecutionRe
  * ExperimentalIncrementalExecutionResults object containing an `initialResult`
  * and a stream of `subsequentResults`.
  *
- * If the arguments to this function do not result in a legal execution context,
- * a GraphQLError will be thrown immediately explaining the invalid input.
+ * If the schema is invalid, an error will be thrown immediately. GraphQL
+ * request errors, including missing operations and variable coercion errors,
+ * are returned in an errors-only ExecutionResult.
  * @param args - Execution arguments for the GraphQL operation.
  * @returns A single execution result or incremental execution results.
  * @example
@@ -94,17 +96,18 @@ export declare function executeIgnoringIncremental(args: ExecutionArgs): Promise
 /**
  * Implements the "Executing operations" section of the spec.
  *
- * Returns a Promise that will eventually resolve to the data described by
- * The "Response" section of the GraphQL specification.
+ * Returns either a synchronous ExecutionResult, or a Promise for an
+ * ExecutionResult, described by the "Response" section of the GraphQL
+ * specification.
  *
- * If errors are encountered while executing a GraphQL field, only that
- * field and its descendants will be omitted, and sibling fields will still
- * be executed. An execution which encounters errors will still result in a
- * resolved Promise.
+ * If errors are encountered while executing a GraphQL field, only that field
+ * and its descendants will be omitted, and sibling fields will still be
+ * executed. These field errors are collected into the returned result instead
+ * of being thrown or rejecting the returned promise.
  *
- * Errors from sub-fields of a NonNull type may propagate to the top level,
- * at which point we still log the error and null the parent field, which
- * in this case is the entire response.
+ * Errors from sub-fields of a NonNull type may propagate to the top level, at
+ * which point we still collect the error and null the parent field, which in
+ * this case is the entire response.
  * @param validatedExecutionArgs - Validated execution arguments.
  * @returns Execution result for the operation root selection set.
  * @example
@@ -112,7 +115,10 @@ export declare function executeIgnoringIncremental(args: ExecutionArgs): Promise
  * import assert from 'node:assert';
  * import { parse } from 'graphql/language';
  * import { buildSchema } from 'graphql/utilities';
- * import { executeRootSelectionSet, validateExecutionArgs } from 'graphql/execution';
+ * import {
+ *   executeRootSelectionSet,
+ *   validateExecutionArgs,
+ * } from 'graphql/execution';
  *
  * const schema = buildSchema('type Query { greeting: String }');
  * const validatedArgs = validateExecutionArgs({
@@ -185,6 +191,9 @@ export declare function executeRootSelectionSetIgnoringIncremental(validatedExec
 export declare function executeSync(args: ExecutionArgs): ExecutionResult;
 /**
  * Executes a subscription operation once for a single source event.
+ *
+ * Field errors are collected into the returned result instead of being thrown
+ * or rejecting the returned promise.
  * @param validatedExecutionArgs - Validated subscription execution arguments.
  * @returns Execution result for the subscription event.
  * @example
@@ -192,7 +201,10 @@ export declare function executeSync(args: ExecutionArgs): ExecutionResult;
  * import assert from 'node:assert';
  * import { parse } from 'graphql/language';
  * import { buildSchema } from 'graphql/utilities';
- * import { executeSubscriptionEvent, validateSubscriptionArgs } from 'graphql/execution';
+ * import {
+ *   executeSubscriptionEvent,
+ *   validateSubscriptionArgs,
+ * } from 'graphql/execution';
  *
  * const schema = buildSchema(`
  *   type Query {
@@ -219,21 +231,22 @@ export declare function executeSubscriptionEvent(validatedExecutionArgs: Validat
 /**
  * Implements the "Subscribe" algorithm described in the GraphQL specification.
  *
- * Returns a Promise that resolves to either an AsyncIterator (if successful)
- * or an ExecutionResult (error). The promise will be rejected if the schema or
- * other arguments to this function are invalid, or if the resolved event stream
- * is not an async iterable.
+ * Returns either an AsyncGenerator (if successful), an ExecutionResult (error),
+ * or a Promise for one of those results. The call will throw immediately if
+ * the schema is invalid or the selected operation is not a subscription.
  *
- * If the client-provided arguments to this function do not result in a
- * compliant subscription, a GraphQL Response (ExecutionResult) with descriptive
- * errors and no data will be returned.
+ * GraphQL request errors, including missing operations and variable coercion
+ * errors, return or resolve to a GraphQL Response (ExecutionResult) with
+ * descriptive errors and no data.
  *
  * If the source stream could not be created due to faulty subscription resolver
- * logic or underlying systems, the promise will resolve to a single
- * ExecutionResult containing `errors` and no `data`.
+ * logic, a non-async-iterable resolver result, or a system error, the
+ * function will return or resolve to a single ExecutionResult containing
+ * `errors` and no `data`.
  *
- * If the operation succeeded, the promise resolves to an AsyncIterator, which
- * yields a stream of ExecutionResults representing the response stream.
+ * If the operation succeeded, the function returns or resolves to an
+ * AsyncGenerator, which yields a stream of ExecutionResults representing the
+ * response stream.
  *
  * This function does not support incremental delivery (`@defer` and `@stream`).
  * If an operation which would defer or stream data is executed with this
@@ -335,21 +348,20 @@ export declare function subscribe(args: ExecutionArgs): PromiseOrValue<AsyncGene
  * GraphQL specification, resolving the subscription source event stream for a
  * previously validated subscription request.
  *
- * Returns a Promise that resolves to either an AsyncIterable (if successful)
- * or an ExecutionResult (error). The promise will be rejected if the validated
- * execution arguments are invalid, or if the resolved event stream is not an
- * async iterable.
+ * Returns either an AsyncIterable (if successful), an ExecutionResult (error),
+ * or a Promise for one of those results. The call will throw immediately if
+ * it is not passed validated execution arguments.
  *
- * If the client-provided arguments to this function do not result in a
- * compliant subscription, a GraphQL Response (ExecutionResult) with
- * descriptive errors and no data will be returned.
+ * If the validated arguments do not result in a compliant subscription, a
+ * GraphQL Response (ExecutionResult) with descriptive errors and no data will
+ * be returned.
  *
  * If the source stream could not be created due to faulty subscription
- * resolver logic or underlying systems, the promise will resolve to a single
- * ExecutionResult containing `errors` and no `data`.
+ * resolver logic or a system error, the function will return or
+ * resolve to a single ExecutionResult containing `errors` and no `data`.
  *
- * If the operation succeeded, the promise resolves to the AsyncIterable for the
- * event stream returned by the resolver.
+ * If the operation succeeded, the function returns or resolves to the
+ * AsyncIterable for the event stream returned by the resolver.
  *
  * A Source Event Stream represents a sequence of events, each of which triggers
  * a GraphQL execution for that event.
@@ -365,7 +377,10 @@ export declare function subscribe(args: ExecutionArgs): PromiseOrValue<AsyncGene
  * import assert from 'node:assert';
  * import { parse } from 'graphql/language';
  * import { buildSchema } from 'graphql/utilities';
- * import { createSourceEventStream, validateSubscriptionArgs } from 'graphql/execution';
+ * import {
+ *   createSourceEventStream,
+ *   validateSubscriptionArgs,
+ * } from 'graphql/execution';
  *
  * async function* greetings() {
  *   yield { greeting: 'Hello' };
@@ -394,12 +409,11 @@ export declare function subscribe(args: ExecutionArgs): PromiseOrValue<AsyncGene
  */
 export declare function createSourceEventStream(validatedExecutionArgs: ValidatedSubscriptionArgs): PromiseOrValue<AsyncIterable<unknown> | ExecutionResult>;
 /**
- * Constructs a ExecutionContext object from the arguments passed to
- * execute, which we will pass throughout the other execution methods.
- *
- * Throws a GraphQLError if a valid execution context cannot be created.
+ * Validates the arguments passed to execute, subscribe, and their lower-level
+ * helpers.
  *
- * TODO: consider no longer exporting this function
+ * Throws if the schema is invalid. GraphQL request errors, including variable
+ * coercion errors, are returned as a GraphQLError array.
  * @param args - Execution arguments to validate.
  * @returns Validated execution arguments, or validation errors.
  * @example
@@ -454,6 +468,10 @@ export declare function createSourceEventStream(validatedExecutionArgs: Validate
 export declare function validateExecutionArgs(args: ExecutionArgs): ReadonlyArray<GraphQLError> | ValidatedExecutionArgs;
 /**
  * Validates execution arguments for a subscription operation.
+ *
+ * Throws if the schema is invalid or the selected operation is not a
+ * subscription. GraphQL request errors, including variable coercion errors, are
+ * returned as a GraphQLError array.
  * @param args - Execution arguments to validate.
  * @returns Validated subscription execution arguments, or validation errors.
  * @example
@@ -514,7 +532,10 @@ export declare const defaultFieldResolver: GraphQLFieldResolver<unknown, unknown
  * import assert from 'node:assert';
  * import { parse } from 'graphql/language';
  * import { buildSchema } from 'graphql/utilities';
- * import { mapSourceToResponseEvent, validateSubscriptionArgs } from 'graphql/execution';
+ * import {
+ *   mapSourceToResponseEvent,
+ *   validateSubscriptionArgs,
+ * } from 'graphql/execution';
  *
  * async function* events() {
  *   yield { greeting: 'Hello' };

package/execution/execute.js

@@ -164,6 +164,7 @@ function validateExecutionArgs(args) {
     let operation;
     const fragmentDefinitions = Object.create(null);
     const fragments = Object.create(null);
+    const fragmentVariableSignatureErrors = [];
     for (const definition of document.definitions) {
         switch (definition.kind) {
             case kinds_ts_1.Kind.OPERATION_DEFINITION:
@@ -183,11 +184,16 @@ function validateExecutionArgs(args) {
                 fragmentDefinitions[definition.name.value] = definition;
                 let variableSignatures;
                 if (definition.variableDefinitions) {
-                    variableSignatures = Object.create(null);
+                    const signatures = Object.create(null);
                     for (const varDef of definition.variableDefinitions) {
                         const signature = (0, getVariableSignature_ts_1.getVariableSignature)(schema, varDef);
-                        variableSignatures[signature.name] = signature;
+                        if (signature instanceof GraphQLError_ts_1.GraphQLError) {
+                            fragmentVariableSignatureErrors.push(signature);
+                            continue;
+                        }
+                        signatures[signature.name] = signature;
                     }
+                    variableSignatures = signatures;
                 }
                 fragments[definition.name.value] = { definition, variableSignatures };
                 break;
@@ -201,6 +207,9 @@ function validateExecutionArgs(args) {
         }
         return [new GraphQLError_ts_1.GraphQLError('Must provide an operation.')];
     }
+    if (fragmentVariableSignatureErrors.length > 0) {
+        return fragmentVariableSignatureErrors;
+    }
     const variableDefinitions = operation.variableDefinitions ?? [];
     const hideSuggestions = args.hideSuggestions ?? false;
     const coercionInput = rawVariableValues ?? {};

package/execution/execute.js.map

@@ -1 +1 @@
-{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../src/execution/execute.ts"],"names":[],"mappings":"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","sourcesContent":["/** @category Execution */\n\nimport { inspect } from '../jsutils/inspect.ts';\nimport { isAsyncIterable } from '../jsutils/isAsyncIterable.ts';\nimport { isObjectLike } from '../jsutils/isObjectLike.ts';\nimport { isPromise, isPromiseLike } from '../jsutils/isPromise.ts';\nimport type { ObjMap } from '../jsutils/ObjMap.ts';\nimport { addPath, pathToArray } from '../jsutils/Path.ts';\nimport type { PromiseOrValue } from '../jsutils/PromiseOrValue.ts';\n\nimport { ensureGraphQLError } from '../error/ensureGraphQLError.ts';\nimport { GraphQLError } from '../error/GraphQLError.ts';\nimport { locatedError } from '../error/locatedError.ts';\n\nimport type {\n  FieldNode,\n  FragmentDefinitionNode,\n  OperationDefinitionNode,\n} from '../language/ast.ts';\nimport { Kind } from '../language/kinds.ts';\nimport { isSubscriptionOperationDefinitionNode } from '../language/predicates.ts';\n\nimport { GraphQLDisableErrorPropagationDirective } from '../type/directives.ts';\nimport type {\n  GraphQLFieldResolver,\n  GraphQLTypeResolver,\n} from '../type/index.ts';\nimport { assertValidSchema } from '../type/index.ts';\n\nimport { getOperationAST } from '../utilities/getOperationAST.ts';\n\nimport type { GraphQLExecuteContext } from '../diagnostics.ts';\nimport {\n  executeChannel,\n  executeVariableCoercionChannel,\n  shouldTrace,\n  subscribeChannel,\n  traceMixed,\n} from '../diagnostics.ts';\n\nimport { buildResolveInfo } from './buildResolveInfo.ts';\nimport { cancellablePromise } from './cancellablePromise.ts';\nimport type { FieldDetailsList, FragmentDetails } from './collectFields.ts';\nimport { collectFields } from './collectFields.ts';\nimport { createSharedExecutionContext } from './createSharedExecutionContext.ts';\nimport type {\n  ExecutionArgs,\n  ValidatedExecutionArgs,\n  ValidatedSubscriptionArgs,\n} from './ExecutionArgs.ts';\nimport type { ExecutionResult } from './Executor.ts';\nimport { Executor } from './Executor.ts';\nimport { ExecutorThrowingOnIncremental } from './ExecutorThrowingOnIncremental.ts';\nimport { getVariableSignature } from './getVariableSignature.ts';\nimport type { ExperimentalIncrementalExecutionResults } from './incremental/IncrementalExecutor.ts';\nimport { IncrementalExecutor } from './incremental/IncrementalExecutor.ts';\nimport { mapAsyncIterable } from './mapAsyncIterable.ts';\nimport { getArgumentValues, getVariableValues } from './values.ts';\n\nconst UNEXPECTED_EXPERIMENTAL_DIRECTIVES =\n  'The provided schema unexpectedly contains experimental directives (@defer or @stream). These directives may only be utilized if experimental execution features are explicitly enabled.';\n\n/** Function used to execute a validated root selection set for a subscription event. */\nexport type RootSelectionSetExecutor = (\n  validatedExecutionArgs: ValidatedSubscriptionArgs,\n) => PromiseOrValue<ExecutionResult>;\n\n/**\n * Implements the \"Executing requests\" section of the GraphQL specification.\n *\n * Returns either a synchronous ExecutionResult (if all encountered resolvers\n * are synchronous), or a Promise of an ExecutionResult that will eventually be\n * resolved and never rejected.\n *\n * If the arguments to this function do not result in a legal execution context,\n * a GraphQLError will be thrown immediately explaining the invalid input.\n *\n * Field errors are collected into the response instead of rejecting the\n * returned promise. Only the field that produced the error and its descendants\n * are omitted; sibling fields continue to execute. Errors from fields of\n * non-null type may propagate to the nearest nullable parent, which can be the\n * entire response data.\n *\n * This function does not support incremental delivery (`@defer` and `@stream`).\n * Use `experimentalExecuteIncrementally` to execute operations with\n * incremental delivery enabled.\n * @param args - The arguments used to perform the operation.\n * @returns A completed execution result, or a promise resolving to one when execution is asynchronous.\n * @example\n * ```ts\n * import { parse } from 'graphql/language';\n * import { buildSchema } from 'graphql/utilities';\n * import { execute } from 'graphql/execution';\n *\n * const schema = buildSchema(`\n *   type Query {\n *     greeting(name: String!): String\n *   }\n * `);\n *\n * const result = await execute({\n *   schema,\n *   document: parse('query ($name: String!) { greeting(name: $name) }'),\n *   rootValue: {\n *     greeting: ({ name }) => `Hello, ${name}!`,\n *   },\n *   variableValues: { name: 'Ada' },\n * });\n *\n * result; // => { data: { greeting: 'Hello, Ada!' } }\n * ```\n */\nexport function execute(args: ExecutionArgs): PromiseOrValue<ExecutionResult> {\n  if (!shouldTrace(executeChannel)) {\n    return executeImpl(args);\n  }\n  return traceMixed(executeChannel, buildOperationContextFromArgs(args), () =>\n    executeImpl(args),\n  );\n}\n\n/**\n * Build a graphql:execute channel context from raw ExecutionArgs. Defers\n * resolution of the operation AST to a lazy getter so the cost of walking\n * the document is only paid if a subscriber reads it.\n * @internal\n */\nfunction buildOperationContextFromArgs(\n  args: ExecutionArgs,\n): Omit<GraphQLExecuteContext, 'error' | 'result'> {\n  let operation: OperationDefinitionNode | null | undefined;\n  const resolveOperation = (): OperationDefinitionNode | null | undefined => {\n    if (operation === undefined) {\n      operation = getOperationAST(args.document, args.operationName);\n    }\n    return operation;\n  };\n  return {\n    schema: args.schema,\n    document: args.document,\n    rawVariableValues: args.variableValues,\n    get operationName() {\n      return args.operationName ?? resolveOperation()?.name?.value;\n    },\n    get operationType() {\n      return resolveOperation()?.operation;\n    },\n  };\n}\n\nfunction executeImpl(args: ExecutionArgs): PromiseOrValue<ExecutionResult> {\n  if (args.schema.getDirective('defer') || args.schema.getDirective('stream')) {\n    throw new Error(UNEXPECTED_EXPERIMENTAL_DIRECTIVES);\n  }\n\n  const validatedExecutionArgs = validateExecutionArgs(args);\n\n  // Return early errors if execution context failed.\n  if (!('schema' in validatedExecutionArgs)) {\n    return { errors: validatedExecutionArgs };\n  }\n\n  return executeRootSelectionSet(validatedExecutionArgs);\n}\n\n/**\n * Implements the \"Executing requests\" section of the GraphQL specification,\n * including `@defer` and `@stream` as proposed in\n * https://github.com/graphql/graphql-spec/pull/742\n *\n * This function returns either a single ExecutionResult, or an\n * ExperimentalIncrementalExecutionResults object containing an `initialResult`\n * and a stream of `subsequentResults`.\n *\n * If the arguments to this function do not result in a legal execution context,\n * a GraphQLError will be thrown immediately explaining the invalid input.\n * @param args - Execution arguments for the GraphQL operation.\n * @returns A single execution result or incremental execution results.\n * @example\n * ```ts\n * import { parse } from 'graphql/language';\n * import { buildSchema } from 'graphql/utilities';\n * import { experimentalExecuteIncrementally } from 'graphql/execution';\n *\n * const schema = buildSchema(`\n *   type Query {\n *     greeting: String\n *   }\n * `);\n *\n * const result = await experimentalExecuteIncrementally({\n *   schema,\n *   document: parse('{ greeting }'),\n *   rootValue: { greeting: 'Hello' },\n * });\n *\n * result; // => { data: { greeting: 'Hello' } }\n * ```\n * @category Incremental Execution\n */\nexport function experimentalExecuteIncrementally(\n  args: ExecutionArgs,\n): PromiseOrValue<ExecutionResult | ExperimentalIncrementalExecutionResults> {\n  if (!shouldTrace(executeChannel)) {\n    return experimentalExecuteIncrementallyImpl(args);\n  }\n  return traceMixed(executeChannel, buildOperationContextFromArgs(args), () =>\n    experimentalExecuteIncrementallyImpl(args),\n  );\n}\n\nfunction experimentalExecuteIncrementallyImpl(\n  args: ExecutionArgs,\n): PromiseOrValue<ExecutionResult | ExperimentalIncrementalExecutionResults> {\n  // If a valid execution context cannot be created due to incorrect arguments,\n  // a \"Response\" with only errors is returned.\n  const validatedExecutionArgs = validateExecutionArgs(args);\n\n  // Return early errors if execution context failed.\n  if (!('schema' in validatedExecutionArgs)) {\n    return { errors: validatedExecutionArgs };\n  }\n\n  return experimentalExecuteRootSelectionSet(validatedExecutionArgs);\n}\n\n/** @internal */\nexport function executeIgnoringIncremental(\n  args: ExecutionArgs,\n): PromiseOrValue<ExecutionResult | ExperimentalIncrementalExecutionResults> {\n  if (!shouldTrace(executeChannel)) {\n    return executeIgnoringIncrementalImpl(args);\n  }\n  return traceMixed(executeChannel, buildOperationContextFromArgs(args), () =>\n    executeIgnoringIncrementalImpl(args),\n  );\n}\n\nfunction executeIgnoringIncrementalImpl(\n  args: ExecutionArgs,\n): PromiseOrValue<ExecutionResult | ExperimentalIncrementalExecutionResults> {\n  // If a valid execution context cannot be created due to incorrect arguments,\n  // a \"Response\" with only errors is returned.\n  const validatedExecutionArgs = validateExecutionArgs(args);\n\n  // Return early errors if execution context failed.\n  if (!('schema' in validatedExecutionArgs)) {\n    return { errors: validatedExecutionArgs };\n  }\n\n  return executeRootSelectionSetIgnoringIncremental(validatedExecutionArgs);\n}\n\n/**\n * Implements the \"Executing operations\" section of the spec.\n *\n * Returns a Promise that will eventually resolve to the data described by\n * The \"Response\" section of the GraphQL specification.\n *\n * If errors are encountered while executing a GraphQL field, only that\n * field and its descendants will be omitted, and sibling fields will still\n * be executed. An execution which encounters errors will still result in a\n * resolved Promise.\n *\n * Errors from sub-fields of a NonNull type may propagate to the top level,\n * at which point we still log the error and null the parent field, which\n * in this case is the entire response.\n * @param validatedExecutionArgs - Validated execution arguments.\n * @returns Execution result for the operation root selection set.\n * @example\n * ```ts\n * import assert from 'node:assert';\n * import { parse } from 'graphql/language';\n * import { buildSchema } from 'graphql/utilities';\n * import { executeRootSelectionSet, validateExecutionArgs } from 'graphql/execution';\n *\n * const schema = buildSchema('type Query { greeting: String }');\n * const validatedArgs = validateExecutionArgs({\n *   schema,\n *   document: parse('{ greeting }'),\n *   rootValue: { greeting: 'Hello' },\n * });\n *\n * assert('schema' in validatedArgs);\n *\n * const result = await executeRootSelectionSet(validatedArgs);\n * result; // => { data: { greeting: 'Hello' } }\n * ```\n */\nexport function executeRootSelectionSet(\n  validatedExecutionArgs: ValidatedExecutionArgs,\n): PromiseOrValue<ExecutionResult> {\n  return new ExecutorThrowingOnIncremental(\n    validatedExecutionArgs,\n  ).executeRootSelectionSet();\n}\n\n/**\n * Executes the operation root selection set with incremental delivery enabled.\n * @param validatedExecutionArgs - Validated execution arguments.\n * @returns A single execution result or incremental execution results.\n * @example\n * ```ts\n * import assert from 'node:assert';\n * import { parse } from 'graphql/language';\n * import { buildSchema } from 'graphql/utilities';\n * import {\n *   experimentalExecuteRootSelectionSet,\n *   validateExecutionArgs,\n * } from 'graphql/execution';\n *\n * const schema = buildSchema('type Query { greeting: String }');\n * const validatedArgs = validateExecutionArgs({\n *   schema,\n *   document: parse('{ greeting }'),\n *   rootValue: { greeting: 'Hello' },\n * });\n *\n * assert('schema' in validatedArgs);\n *\n * const result = await experimentalExecuteRootSelectionSet(validatedArgs);\n * result; // => { data: { greeting: 'Hello' } }\n * ```\n * @category Incremental Execution\n */\nexport function experimentalExecuteRootSelectionSet(\n  validatedExecutionArgs: ValidatedExecutionArgs,\n): PromiseOrValue<ExecutionResult | ExperimentalIncrementalExecutionResults> {\n  return new IncrementalExecutor(\n    validatedExecutionArgs,\n  ).executeRootSelectionSet();\n}\n\n/** @internal */\nexport function executeRootSelectionSetIgnoringIncremental(\n  validatedExecutionArgs: ValidatedExecutionArgs,\n): PromiseOrValue<ExecutionResult | ExperimentalIncrementalExecutionResults> {\n  return new Executor(validatedExecutionArgs).executeRootSelectionSet();\n}\n\n/**\n * Also implements the \"Executing requests\" section of the GraphQL specification.\n * However, it guarantees to complete synchronously (or throw an error) assuming\n * that all field resolvers are also synchronous.\n * @param args - The arguments used to perform the operation.\n * @returns Completed execution output for a synchronous operation.\n * @example\n * ```ts\n * import { parse } from 'graphql/language';\n * import { buildSchema } from 'graphql/utilities';\n * import { executeSync } from 'graphql/execution';\n *\n * const schema = buildSchema('type Query { greeting: String }');\n *\n * const result = executeSync({\n *   schema,\n *   document: parse('{ greeting }'),\n *   rootValue: { greeting: 'Hello' },\n * });\n *\n * result; // => { data: { greeting: 'Hello' } }\n * ```\n */\nexport function executeSync(args: ExecutionArgs): ExecutionResult {\n  const result = experimentalExecuteIncrementally(args);\n\n  // Assert that the execution was synchronous.\n  if (isPromise(result) || 'initialResult' in result) {\n    throw new Error('GraphQL execution failed to complete synchronously.');\n  }\n\n  return result;\n}\n\n/**\n * Executes a subscription operation once for a single source event.\n * @param validatedExecutionArgs - Validated subscription execution arguments.\n * @returns Execution result for the subscription event.\n * @example\n * ```ts\n * import assert from 'node:assert';\n * import { parse } from 'graphql/language';\n * import { buildSchema } from 'graphql/utilities';\n * import { executeSubscriptionEvent, validateSubscriptionArgs } from 'graphql/execution';\n *\n * const schema = buildSchema(`\n *   type Query {\n *     noop: String\n *   }\n *\n *   type Subscription {\n *     greeting: String\n *   }\n * `);\n * const validatedArgs = validateSubscriptionArgs({\n *   schema,\n *   document: parse('subscription { greeting }'),\n *   rootValue: { greeting: 'Hello' },\n * });\n *\n * assert('schema' in validatedArgs);\n *\n * const result = await executeSubscriptionEvent(validatedArgs);\n * result; // => { data: { greeting: 'Hello' } }\n * ```\n */\nexport function executeSubscriptionEvent(\n  validatedExecutionArgs: ValidatedSubscriptionArgs,\n): PromiseOrValue<ExecutionResult> {\n  return new ExecutorThrowingOnIncremental(\n    validatedExecutionArgs,\n  ).executeRootSelectionSet(false);\n}\n\n/**\n * Implements the \"Subscribe\" algorithm described in the GraphQL specification.\n *\n * Returns a Promise that resolves to either an AsyncIterator (if successful)\n * or an ExecutionResult (error). The promise will be rejected if the schema or\n * other arguments to this function are invalid, or if the resolved event stream\n * is not an async iterable.\n *\n * If the client-provided arguments to this function do not result in a\n * compliant subscription, a GraphQL Response (ExecutionResult) with descriptive\n * errors and no data will be returned.\n *\n * If the source stream could not be created due to faulty subscription resolver\n * logic or underlying systems, the promise will resolve to a single\n * ExecutionResult containing `errors` and no `data`.\n *\n * If the operation succeeded, the promise resolves to an AsyncIterator, which\n * yields a stream of ExecutionResults representing the response stream.\n *\n * This function does not support incremental delivery (`@defer` and `@stream`).\n * If an operation which would defer or stream data is executed with this\n * function, a field error will be raised at the location of the `@defer` or\n * `@stream` directive.\n *\n * Accepts an object with named arguments.\n * @param args - Execution arguments for the subscription operation.\n * @returns A response stream for a valid subscription, or an execution result containing errors.\n * @example\n * ```ts\n * // Use a same-named rootValue function to provide the source event stream.\n * import assert from 'node:assert';\n * import { parse } from 'graphql/language';\n * import { buildSchema } from 'graphql/utilities';\n * import { subscribe } from 'graphql/execution';\n *\n * async function* greetings() {\n *   yield { greeting: 'Hello' };\n *   yield { greeting: 'Bonjour' };\n * }\n *\n * const schema = buildSchema(`\n *   type Query {\n *     noop: String\n *   }\n *\n *   type Subscription {\n *     greeting: String\n *   }\n * `);\n *\n * const result = await subscribe({\n *   schema,\n *   document: parse('subscription { greeting }'),\n *   rootValue: { greeting: () => greetings() },\n * });\n *\n * assert('next' in result);\n *\n * const firstPayload = await result.next();\n * firstPayload.value; // => { data: { greeting: 'Hello' } }\n * ```\n * @example\n * ```ts\n * // This variant supplies events through a custom subscribeFieldResolver.\n * import assert from 'node:assert';\n * import { parse } from 'graphql/language';\n * import { buildSchema } from 'graphql/utilities';\n * import { subscribe } from 'graphql/execution';\n *\n * async function* defaultGreetings() {\n *   yield { greeting: 'Hello' };\n * }\n *\n * async function* frenchGreetings() {\n *   yield { greeting: 'Bonjour' };\n * }\n *\n * const schema = buildSchema(`\n *   type Query {\n *     noop: String\n *   }\n *\n *   type Subscription {\n *     greeting(locale: String): String\n *   }\n * `);\n *\n * const result = await subscribe({\n *   schema,\n *   document: parse(\n *     'subscription Greeting($locale: String) { greeting(locale: $locale) }',\n *   ),\n *   rootValue: {\n *     greeting: (args, contextValue) => {\n *       const locale = args.locale ?? contextValue.defaultLocale;\n *       return locale === 'fr' ? frenchGreetings() : defaultGreetings();\n *     },\n *   },\n *   contextValue: { defaultLocale: 'fr' },\n *   variableValues: { locale: 'fr' },\n *   operationName: 'Greeting',\n *   subscribeFieldResolver: (rootValue, args, contextValue, info) => {\n *     args.locale; // => 'fr'\n *     return rootValue[info.fieldName](args, contextValue);\n *   },\n * });\n *\n * assert('next' in result);\n *\n * const firstPayload = await result.next();\n * firstPayload.value; // => { data: { greeting: 'Bonjour' } }\n * ```\n */\nexport function subscribe(\n  args: ExecutionArgs,\n): PromiseOrValue<\n  AsyncGenerator<ExecutionResult, void, void> | ExecutionResult\n> {\n  if (!shouldTrace(subscribeChannel)) {\n    return subscribeImpl(args);\n  }\n  return traceMixed(subscribeChannel, buildOperationContextFromArgs(args), () =>\n    subscribeImpl(args),\n  );\n}\n\nfunction subscribeImpl(\n  args: ExecutionArgs,\n): PromiseOrValue<\n  AsyncGenerator<ExecutionResult, void, void> | ExecutionResult\n> {\n  // If a valid execution context cannot be created due to incorrect arguments,\n  // a \"Response\" with only errors is returned.\n  const validatedExecutionArgs = validateSubscriptionArgs(args);\n\n  // Return early errors if execution context failed.\n  if (!('schema' in validatedExecutionArgs)) {\n    return { errors: validatedExecutionArgs };\n  }\n\n  const resultOrStream = createSourceEventStream(validatedExecutionArgs);\n\n  if (isPromise(resultOrStream)) {\n    return resultOrStream.then((resolvedResultOrStream) =>\n      isAsyncIterable(resolvedResultOrStream)\n        ? mapSourceToResponseEvent(\n            validatedExecutionArgs,\n            resolvedResultOrStream,\n          )\n        : resolvedResultOrStream,\n    );\n  }\n\n  return isAsyncIterable(resultOrStream)\n    ? mapSourceToResponseEvent(validatedExecutionArgs, resultOrStream)\n    : resultOrStream;\n}\n\n/**\n * Implements the \"CreateSourceEventStream\" algorithm described in the\n * GraphQL specification, resolving the subscription source event stream for a\n * previously validated subscription request.\n *\n * Returns a Promise that resolves to either an AsyncIterable (if successful)\n * or an ExecutionResult (error). The promise will be rejected if the validated\n * execution arguments are invalid, or if the resolved event stream is not an\n * async iterable.\n *\n * If the client-provided arguments to this function do not result in a\n * compliant subscription, a GraphQL Response (ExecutionResult) with\n * descriptive errors and no data will be returned.\n *\n * If the source stream could not be created due to faulty subscription\n * resolver logic or underlying systems, the promise will resolve to a single\n * ExecutionResult containing `errors` and no `data`.\n *\n * If the operation succeeded, the promise resolves to the AsyncIterable for the\n * event stream returned by the resolver.\n *\n * A Source Event Stream represents a sequence of events, each of which triggers\n * a GraphQL execution for that event.\n *\n * This may be useful when hosting the stateful subscription service in a\n * different process or machine than the stateless GraphQL execution engine,\n * or otherwise separating these two steps. For more on this, see the\n * \"Supporting Subscriptions at Scale\" information in the GraphQL specification.\n * @param validatedExecutionArgs - Validated subscription execution arguments.\n * @returns A source event stream, or an execution result containing errors.\n * @example\n * ```ts\n * import assert from 'node:assert';\n * import { parse } from 'graphql/language';\n * import { buildSchema } from 'graphql/utilities';\n * import { createSourceEventStream, validateSubscriptionArgs } from 'graphql/execution';\n *\n * async function* greetings() {\n *   yield { greeting: 'Hello' };\n * }\n *\n * const schema = buildSchema(`\n *   type Query {\n *     noop: String\n *   }\n *\n *   type Subscription {\n *     greeting: String\n *   }\n * `);\n * const validatedArgs = validateSubscriptionArgs({\n *   schema,\n *   document: parse('subscription { greeting }'),\n *   rootValue: { greeting: () => greetings() },\n * });\n *\n * assert('schema' in validatedArgs);\n *\n * const stream = await createSourceEventStream(validatedArgs);\n * Symbol.asyncIterator in stream; // => true\n * ```\n */\nexport function createSourceEventStream(\n  validatedExecutionArgs: ValidatedSubscriptionArgs,\n): PromiseOrValue<AsyncIterable<unknown> | ExecutionResult> {\n  if (!('operation' in validatedExecutionArgs)) {\n    throw new GraphQLError(\n      'Passing ExecutionArgs to createSourceEventStream() was removed in graphql-js@17.0.0; call validateSubscriptionArgs() first and pass the result instead, or use subscribe() for the full subscription pipeline.',\n    );\n  }\n\n  try {\n    const eventStream = executeSubscription(validatedExecutionArgs);\n    if (isPromise(eventStream)) {\n      return eventStream.then(undefined, (error: unknown) => ({\n        errors: [ensureGraphQLError(error)],\n      }));\n    }\n\n    return eventStream;\n  } catch (error) {\n    return { errors: [ensureGraphQLError(error)] };\n  }\n}\n\n/**\n * Constructs a ExecutionContext object from the arguments passed to\n * execute, which we will pass throughout the other execution methods.\n *\n * Throws a GraphQLError if a valid execution context cannot be created.\n *\n * TODO: consider no longer exporting this function\n * @param args - Execution arguments to validate.\n * @returns Validated execution arguments, or validation errors.\n * @example\n * ```ts\n * import assert from 'node:assert';\n * import { parse } from 'graphql/language';\n * import { buildSchema } from 'graphql/utilities';\n * import { validateExecutionArgs } from 'graphql/execution';\n *\n * const schema = buildSchema(`\n *   interface Named {\n *     name: String!\n *   }\n *\n *   type User implements Named {\n *     name: String!\n *   }\n *\n *   type Query {\n *     viewer: Named\n *   }\n * `);\n * const abortController = new AbortController();\n * const validatedArgs = validateExecutionArgs({\n *   schema,\n *   document: parse('query Viewer { viewer { __typename name } }'),\n *   rootValue: { viewer: { kind: 'user', name: 'Ada' } },\n *   contextValue: { locale: 'en' },\n *   operationName: 'Viewer',\n *   fieldResolver: (source, _args, contextValue, info) => {\n *     contextValue.locale; // => 'en'\n *     return source[info.fieldName];\n *   },\n *   typeResolver: (value) => {\n *     return value.kind === 'user' ? 'User' : undefined;\n *   },\n *   hideSuggestions: true,\n *   abortSignal: abortController.signal,\n *   enableEarlyExecution: true,\n *   hooks: {\n *     asyncWorkFinished: () => {},\n *   },\n *   options: { maxCoercionErrors: 1 },\n * });\n *\n * assert('operation' in validatedArgs);\n *\n * validatedArgs.operation.name?.value; // => 'Viewer'\n * validatedArgs.hideSuggestions; // => true\n * ```\n */\nexport function validateExecutionArgs(\n  args: ExecutionArgs,\n): ReadonlyArray<GraphQLError> | ValidatedExecutionArgs {\n  const {\n    schema,\n    document,\n    rootValue,\n    contextValue,\n    variableValues: rawVariableValues,\n    operationName,\n    fieldResolver,\n    typeResolver,\n    subscribeFieldResolver,\n    abortSignal: externalAbortSignal,\n    enableEarlyExecution,\n    hooks,\n    options,\n  } = args;\n\n  // If the schema used for execution is invalid, throw an error.\n  assertValidSchema(schema);\n\n  let operation: OperationDefinitionNode | undefined;\n  const fragmentDefinitions: ObjMap<FragmentDefinitionNode> =\n    Object.create(null);\n  const fragments: ObjMap<FragmentDetails> = Object.create(null);\n  for (const definition of document.definitions) {\n    switch (definition.kind) {\n      case Kind.OPERATION_DEFINITION:\n        if (operationName == null) {\n          if (operation !== undefined) {\n            return [\n              new GraphQLError(\n                'Must provide operation name if query contains multiple operations.',\n              ),\n            ];\n          }\n          operation = definition;\n        } else if (definition.name?.value === operationName) {\n          operation = definition;\n        }\n        break;\n      case Kind.FRAGMENT_DEFINITION: {\n        fragmentDefinitions[definition.name.value] = definition;\n        let variableSignatures;\n        if (definition.variableDefinitions) {\n          variableSignatures = Object.create(null);\n          for (const varDef of definition.variableDefinitions) {\n            const signature = getVariableSignature(schema, varDef);\n            variableSignatures[signature.name] = signature;\n          }\n        }\n        fragments[definition.name.value] = { definition, variableSignatures };\n        break;\n      }\n      default:\n      // ignore non-executable definitions\n    }\n  }\n\n  if (!operation) {\n    if (operationName != null) {\n      return [new GraphQLError(`Unknown operation named \"${operationName}\".`)];\n    }\n    return [new GraphQLError('Must provide an operation.')];\n  }\n\n  const variableDefinitions = operation.variableDefinitions ?? [];\n  const hideSuggestions = args.hideSuggestions ?? false;\n\n  const coercionInput = rawVariableValues ?? {};\n  const coercionOptions = {\n    maxErrors: options?.maxCoercionErrors ?? 50,\n    hideSuggestions,\n  };\n  const coercionChannel = executeVariableCoercionChannel;\n  const variableValuesOrErrors = shouldTrace(coercionChannel)\n    ? traceMixed(\n        coercionChannel,\n        {\n          schema,\n          document,\n          operation,\n          rawVariableValues,\n          operationName: operation.name?.value,\n          operationType: operation.operation,\n        },\n        () =>\n          getVariableValues(\n            schema,\n            variableDefinitions,\n            coercionInput,\n            coercionOptions,\n          ),\n      )\n    : getVariableValues(\n        schema,\n        variableDefinitions,\n        coercionInput,\n        coercionOptions,\n      );\n\n  if (variableValuesOrErrors.errors) {\n    return variableValuesOrErrors.errors;\n  }\n\n  const errorPropagation = !operation.directives?.find(\n    (directive) =>\n      directive.name.value === GraphQLDisableErrorPropagationDirective.name,\n  );\n\n  return {\n    schema,\n    document,\n    fragmentDefinitions,\n    fragments,\n    rootValue,\n    contextValue,\n    operation,\n    variableValues: variableValuesOrErrors.variableValues,\n    fieldResolver: fieldResolver ?? defaultFieldResolver,\n    typeResolver: typeResolver ?? defaultTypeResolver,\n    subscribeFieldResolver: subscribeFieldResolver ?? defaultFieldResolver,\n    hideSuggestions,\n    errorPropagation,\n    externalAbortSignal: externalAbortSignal ?? undefined,\n    enableEarlyExecution: enableEarlyExecution === true,\n    hooks: hooks ?? undefined,\n    rawVariableValues,\n  };\n}\n\n/**\n * Validates execution arguments for a subscription operation.\n * @param args - Execution arguments to validate.\n * @returns Validated subscription execution arguments, or validation errors.\n * @example\n * ```ts\n * import assert from 'node:assert';\n * import { parse } from 'graphql/language';\n * import { buildSchema } from 'graphql/utilities';\n * import { validateSubscriptionArgs } from 'graphql/execution';\n *\n * const schema = buildSchema(`\n *   type Query {\n *     noop: String\n *   }\n *\n *   type Subscription {\n *     greeting: String\n *   }\n * `);\n * const validatedArgs = validateSubscriptionArgs({\n *   schema,\n *   document: parse('subscription { greeting }'),\n * });\n *\n * assert('operation' in validatedArgs);\n *\n * validatedArgs.operation.operation; // => 'subscription'\n * ```\n */\nexport function validateSubscriptionArgs(\n  args: ExecutionArgs,\n): ReadonlyArray<GraphQLError> | ValidatedSubscriptionArgs {\n  const validatedExecutionArgs = validateExecutionArgs(args);\n  if (!('schema' in validatedExecutionArgs)) {\n    return validatedExecutionArgs;\n  }\n  assertSubscriptionExecutionArgs(validatedExecutionArgs);\n  return validatedExecutionArgs;\n}\n\nfunction assertSubscriptionExecutionArgs(\n  validatedExecutionArgs: ValidatedExecutionArgs,\n): asserts validatedExecutionArgs is ValidatedSubscriptionArgs {\n  if (\n    !isSubscriptionOperationDefinitionNode(validatedExecutionArgs.operation)\n  ) {\n    throw new GraphQLError('Expected subscription operation.');\n  }\n}\n\n/**\n * If a resolveType function is not given, then a default resolve behavior is\n * used which attempts two strategies:\n *\n * First, See if the provided value has a `__typename` field defined, if so, use\n * that value as name of the resolved type.\n *\n * Otherwise, test each possible type for the abstract type by calling\n * isTypeOf for the object being coerced, returning the first type that matches.\n */\nexport const defaultTypeResolver: GraphQLTypeResolver<unknown, unknown> =\n  function (value, contextValue, info, abstractType) {\n    // First, look for `__typename`.\n    if (isObjectLike(value) && typeof value.__typename === 'string') {\n      return value.__typename;\n    }\n\n    // Otherwise, test each possible type.\n    const possibleTypes = info.schema.getPossibleTypes(abstractType);\n    const promisedIsTypeOfResults: Array<PromiseLike<boolean>> = [];\n\n    try {\n      for (let i = 0; i < possibleTypes.length; i++) {\n        const type = possibleTypes[i];\n\n        if (type.isTypeOf) {\n          const isTypeOfResult = type.isTypeOf(value, contextValue, info);\n\n          if (isPromiseLike(isTypeOfResult)) {\n            promisedIsTypeOfResults[i] = isTypeOfResult;\n          } else if (isTypeOfResult) {\n            if (promisedIsTypeOfResults.length) {\n              info.getAsyncHelpers().track(promisedIsTypeOfResults);\n            }\n            return type.name;\n          }\n        }\n      }\n    } catch (error) {\n      if (promisedIsTypeOfResults.length) {\n        info.getAsyncHelpers().track(promisedIsTypeOfResults);\n      }\n      throw error;\n    }\n\n    if (promisedIsTypeOfResults.length) {\n      return info\n        .getAsyncHelpers()\n        .promiseAll(promisedIsTypeOfResults)\n        .then((isTypeOfResults) => {\n          for (let i = 0; i < isTypeOfResults.length; i++) {\n            if (isTypeOfResults[i]) {\n              return possibleTypes[i].name;\n            }\n          }\n        });\n    }\n  };\n\n/**\n * If a resolve function is not given, then a default resolve behavior is used\n * which takes the property of the source object of the same name as the field\n * and returns it as the result, or if it's a function, returns the result\n * of calling that function while passing along args and context value.\n */\nexport const defaultFieldResolver: GraphQLFieldResolver<unknown, unknown> =\n  function (source: any, args, contextValue, info) {\n    // ensure source is a value for which property access is acceptable.\n    if (isObjectLike(source) || typeof source === 'function') {\n      const property = source[info.fieldName];\n      if (typeof property === 'function') {\n        return source[info.fieldName](args, contextValue, info);\n      }\n      return property;\n    }\n  };\n\n/**\n * Implements the \"MapSourceToResponseEvent\" algorithm described in the\n * GraphQL specification, mapping each event from a subscription source event\n * stream to an ExecutionResult in the response stream.\n * @param validatedExecutionArgs - Validated subscription execution arguments.\n * @param sourceEventStream - Source event stream returned by the subscription resolver.\n * @param rootSelectionSetExecutor - Function used to execute each source event.\n * @returns A response stream of execution results.\n * @example\n * ```ts\n * import assert from 'node:assert';\n * import { parse } from 'graphql/language';\n * import { buildSchema } from 'graphql/utilities';\n * import { mapSourceToResponseEvent, validateSubscriptionArgs } from 'graphql/execution';\n *\n * async function* events() {\n *   yield { greeting: 'Hello' };\n * }\n *\n * const schema = buildSchema(`\n *   type Query {\n *     noop: String\n *   }\n *\n *   type Subscription {\n *     greeting: String\n *   }\n * `);\n * const validatedArgs = validateSubscriptionArgs({\n *   schema,\n *   document: parse('subscription { greeting }'),\n * });\n *\n * assert('schema' in validatedArgs);\n *\n * const responseStream = mapSourceToResponseEvent(validatedArgs, events());\n * const firstPayload = await responseStream.next();\n *\n * firstPayload.value; // => { data: { greeting: 'Hello' } }\n * ```\n */\nexport function mapSourceToResponseEvent(\n  validatedExecutionArgs: ValidatedSubscriptionArgs,\n  sourceEventStream: AsyncIterable<unknown>,\n  rootSelectionSetExecutor: RootSelectionSetExecutor = executeSubscriptionEvent,\n): AsyncGenerator<ExecutionResult, void, void> {\n  // For each payload yielded from a subscription, map it over the normal\n  // GraphQL `execute` function, with `payload` as the rootValue.\n  function mapFn(payload: unknown): PromiseOrValue<ExecutionResult> {\n    const perEventExecutionArgs: ValidatedSubscriptionArgs = {\n      ...validatedExecutionArgs,\n      rootValue: payload,\n    };\n    return rootSelectionSetExecutor(perEventExecutionArgs);\n  }\n\n  const externalAbortSignal = validatedExecutionArgs.externalAbortSignal;\n  if (externalAbortSignal) {\n    const generator = mapAsyncIterable(sourceEventStream, mapFn);\n    return {\n      ...generator,\n      next: () => cancellablePromise(generator.next(), externalAbortSignal),\n    };\n  }\n  return mapAsyncIterable(sourceEventStream, mapFn);\n}\n\nfunction executeSubscription(\n  validatedExecutionArgs: ValidatedExecutionArgs,\n): PromiseOrValue<AsyncIterable<unknown>> {\n  const {\n    schema,\n    fragments,\n    rootValue,\n    contextValue,\n    operation,\n    variableValues,\n    hideSuggestions,\n    externalAbortSignal,\n  } = validatedExecutionArgs;\n\n  const rootType = schema.getSubscriptionType();\n  if (rootType == null) {\n    throw new GraphQLError(\n      'Schema is not configured to execute subscription operation.',\n      { nodes: operation },\n    );\n  }\n\n  const { groupedFieldSet } = collectFields(\n    schema,\n    fragments,\n    variableValues,\n    rootType,\n    operation.selectionSet,\n    hideSuggestions,\n  );\n\n  const firstRootField = groupedFieldSet.entries().next().value as [\n    string,\n    FieldDetailsList,\n  ];\n  const [responseName, fieldDetailsList] = firstRootField;\n  const firstFieldDetails = fieldDetailsList[0];\n  const firstNode = firstFieldDetails.node;\n  const fieldName = firstNode.name.value;\n  const fieldDef = schema.getField(rootType, fieldName);\n\n  const fieldNodes = fieldDetailsList.map((fieldDetails) => fieldDetails.node);\n  if (!fieldDef) {\n    throw new GraphQLError(\n      `The subscription field \"${fieldName}\" is not defined.`,\n      { nodes: fieldNodes },\n    );\n  }\n\n  const sharedExecutionContext =\n    createSharedExecutionContext(externalAbortSignal);\n  const path = addPath(undefined, responseName, rootType.name);\n  const info = buildResolveInfo(\n    validatedExecutionArgs,\n    fieldDef,\n    fieldNodes,\n    rootType,\n    path,\n    sharedExecutionContext.getAbortSignal,\n    sharedExecutionContext.getAsyncHelpers,\n  );\n\n  try {\n    // Implements the \"ResolveFieldEventStream\" algorithm from GraphQL specification.\n    // It differs from \"ResolveFieldValue\" due to providing a different `resolveFn`.\n\n    // Build a JS object of arguments from the field.arguments AST, using the\n    // variables scope to fulfill any variable references.\n    const args = getArgumentValues(\n      fieldDef,\n      firstNode,\n      variableValues,\n      firstFieldDetails.fragmentVariableValues,\n      hideSuggestions,\n    );\n\n    // Call the `subscribe()` resolver or the default resolver to produce an\n    // AsyncIterable yielding raw payloads.\n    const resolveFn =\n      fieldDef.subscribe ?? validatedExecutionArgs.subscribeFieldResolver;\n\n    // The resolve function's optional third argument is a context value that\n    // is provided to every resolve function within an execution. It is commonly\n    // used to represent an authenticated user, or request-specific caches.\n    const result = resolveFn(rootValue, args, contextValue, info);\n\n    if (isPromiseLike(result)) {\n      const promisedResult = Promise.resolve(result);\n      const promise = externalAbortSignal\n        ? cancellablePromise(promisedResult, externalAbortSignal)\n        : promisedResult;\n      return promise\n        .then(assertEventStream)\n        .then(undefined, (error: unknown) => {\n          throw locatedError(\n            error,\n            toNodes(fieldDetailsList),\n            pathToArray(path),\n          );\n        });\n    }\n    return assertEventStream(result);\n  } catch (error) {\n    throw locatedError(error, fieldNodes, pathToArray(path));\n  }\n}\n\nfunction assertEventStream(result: unknown): AsyncIterable<unknown> {\n  if (result instanceof Error) {\n    throw result;\n  }\n\n  // Assert field returned an event stream, otherwise yield an error.\n  if (!isAsyncIterable(result)) {\n    throw new GraphQLError(\n      'Subscription field must return Async Iterable. ' +\n        `Received: ${inspect(result)}.`,\n    );\n  }\n\n  return result;\n}\n\nfunction toNodes(fieldDetailsList: FieldDetailsList): ReadonlyArray<FieldNode> {\n  return fieldDetailsList.map((fieldDetails) => fieldDetails.node);\n}\n"]}
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../src/execution/execute.ts"],"names":[],"mappings":"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","sourcesContent":["/** @category Execution */\n\nimport { inspect } from '../jsutils/inspect.ts';\nimport { isAsyncIterable } from '../jsutils/isAsyncIterable.ts';\nimport { isObjectLike } from '../jsutils/isObjectLike.ts';\nimport { isPromise, isPromiseLike } from '../jsutils/isPromise.ts';\nimport type { ObjMap } from '../jsutils/ObjMap.ts';\nimport { addPath, pathToArray } from '../jsutils/Path.ts';\nimport type { PromiseOrValue } from '../jsutils/PromiseOrValue.ts';\n\nimport { ensureGraphQLError } from '../error/ensureGraphQLError.ts';\nimport { GraphQLError } from '../error/GraphQLError.ts';\nimport { locatedError } from '../error/locatedError.ts';\n\nimport type {\n  FieldNode,\n  FragmentDefinitionNode,\n  OperationDefinitionNode,\n} from '../language/ast.ts';\nimport { Kind } from '../language/kinds.ts';\nimport { isSubscriptionOperationDefinitionNode } from '../language/predicates.ts';\n\nimport { GraphQLDisableErrorPropagationDirective } from '../type/directives.ts';\nimport type {\n  GraphQLFieldResolver,\n  GraphQLTypeResolver,\n} from '../type/index.ts';\nimport { assertValidSchema } from '../type/index.ts';\n\nimport { getOperationAST } from '../utilities/getOperationAST.ts';\n\nimport type { GraphQLExecuteContext } from '../diagnostics.ts';\nimport {\n  executeChannel,\n  executeVariableCoercionChannel,\n  shouldTrace,\n  subscribeChannel,\n  traceMixed,\n} from '../diagnostics.ts';\n\nimport { buildResolveInfo } from './buildResolveInfo.ts';\nimport { cancellablePromise } from './cancellablePromise.ts';\nimport type { FieldDetailsList, FragmentDetails } from './collectFields.ts';\nimport { collectFields } from './collectFields.ts';\nimport { createSharedExecutionContext } from './createSharedExecutionContext.ts';\nimport type {\n  ExecutionArgs,\n  ValidatedExecutionArgs,\n  ValidatedSubscriptionArgs,\n} from './ExecutionArgs.ts';\nimport type { ExecutionResult } from './Executor.ts';\nimport { Executor } from './Executor.ts';\nimport { ExecutorThrowingOnIncremental } from './ExecutorThrowingOnIncremental.ts';\nimport type { GraphQLVariableSignature } from './getVariableSignature.ts';\nimport { getVariableSignature } from './getVariableSignature.ts';\nimport type { ExperimentalIncrementalExecutionResults } from './incremental/IncrementalExecutor.ts';\nimport { IncrementalExecutor } from './incremental/IncrementalExecutor.ts';\nimport { mapAsyncIterable } from './mapAsyncIterable.ts';\nimport { getArgumentValues, getVariableValues } from './values.ts';\n\nconst UNEXPECTED_EXPERIMENTAL_DIRECTIVES =\n  'The provided schema unexpectedly contains experimental directives (@defer or @stream). These directives may only be utilized if experimental execution features are explicitly enabled.';\n\n/** Function used to execute a validated root selection set for a subscription event. */\nexport type RootSelectionSetExecutor = (\n  validatedExecutionArgs: ValidatedSubscriptionArgs,\n) => PromiseOrValue<ExecutionResult>;\n\n/**\n * Implements the \"Executing requests\" section of the GraphQL specification.\n *\n * Returns either a synchronous ExecutionResult (if all encountered resolvers\n * are synchronous), or a Promise of an ExecutionResult that will eventually be\n * resolved and never rejected.\n *\n * If the schema is invalid, an error will be thrown immediately. GraphQL\n * request errors, including missing operations and variable coercion errors,\n * are returned in an errors-only ExecutionResult.\n *\n * Field errors are collected into the response instead of rejecting the\n * returned promise. Only the field that produced the error and its descendants\n * are omitted; sibling fields continue to execute. Errors from fields of\n * non-null type may propagate to the nearest nullable parent, which can be the\n * entire response data.\n *\n * This function does not support incremental delivery (`@defer` and `@stream`).\n * Use `experimentalExecuteIncrementally` to execute operations with\n * incremental delivery enabled.\n * @param args - The arguments used to perform the operation.\n * @returns A completed execution result, or a promise resolving to one when execution is asynchronous.\n * @example\n * ```ts\n * import { parse } from 'graphql/language';\n * import { buildSchema } from 'graphql/utilities';\n * import { execute } from 'graphql/execution';\n *\n * const schema = buildSchema(`\n *   type Query {\n *     greeting(name: String!): String\n *   }\n * `);\n *\n * const result = await execute({\n *   schema,\n *   document: parse('query ($name: String!) { greeting(name: $name) }'),\n *   rootValue: {\n *     greeting: ({ name }) => `Hello, ${name}!`,\n *   },\n *   variableValues: { name: 'Ada' },\n * });\n *\n * result; // => { data: { greeting: 'Hello, Ada!' } }\n * ```\n */\nexport function execute(args: ExecutionArgs): PromiseOrValue<ExecutionResult> {\n  if (!shouldTrace(executeChannel)) {\n    return executeImpl(args);\n  }\n  return traceMixed(executeChannel, buildOperationContextFromArgs(args), () =>\n    executeImpl(args),\n  );\n}\n\n/**\n * Build a graphql:execute channel context from raw ExecutionArgs. Defers\n * resolution of the operation AST to a lazy getter so the cost of walking\n * the document is only paid if a subscriber reads it.\n * @internal\n */\nfunction buildOperationContextFromArgs(\n  args: ExecutionArgs,\n): Omit<GraphQLExecuteContext, 'error' | 'result'> {\n  let operation: OperationDefinitionNode | null | undefined;\n  const resolveOperation = (): OperationDefinitionNode | null | undefined => {\n    if (operation === undefined) {\n      operation = getOperationAST(args.document, args.operationName);\n    }\n    return operation;\n  };\n  return {\n    schema: args.schema,\n    document: args.document,\n    rawVariableValues: args.variableValues,\n    get operationName() {\n      return args.operationName ?? resolveOperation()?.name?.value;\n    },\n    get operationType() {\n      return resolveOperation()?.operation;\n    },\n  };\n}\n\nfunction executeImpl(args: ExecutionArgs): PromiseOrValue<ExecutionResult> {\n  if (args.schema.getDirective('defer') || args.schema.getDirective('stream')) {\n    throw new Error(UNEXPECTED_EXPERIMENTAL_DIRECTIVES);\n  }\n\n  const validatedExecutionArgs = validateExecutionArgs(args);\n\n  // Return early errors if execution context failed.\n  if (!('schema' in validatedExecutionArgs)) {\n    return { errors: validatedExecutionArgs };\n  }\n\n  return executeRootSelectionSet(validatedExecutionArgs);\n}\n\n/**\n * Implements the \"Executing requests\" section of the GraphQL specification,\n * including `@defer` and `@stream` as proposed in\n * https://github.com/graphql/graphql-spec/pull/742\n *\n * This function returns either a single ExecutionResult, or an\n * ExperimentalIncrementalExecutionResults object containing an `initialResult`\n * and a stream of `subsequentResults`.\n *\n * If the schema is invalid, an error will be thrown immediately. GraphQL\n * request errors, including missing operations and variable coercion errors,\n * are returned in an errors-only ExecutionResult.\n * @param args - Execution arguments for the GraphQL operation.\n * @returns A single execution result or incremental execution results.\n * @example\n * ```ts\n * import { parse } from 'graphql/language';\n * import { buildSchema } from 'graphql/utilities';\n * import { experimentalExecuteIncrementally } from 'graphql/execution';\n *\n * const schema = buildSchema(`\n *   type Query {\n *     greeting: String\n *   }\n * `);\n *\n * const result = await experimentalExecuteIncrementally({\n *   schema,\n *   document: parse('{ greeting }'),\n *   rootValue: { greeting: 'Hello' },\n * });\n *\n * result; // => { data: { greeting: 'Hello' } }\n * ```\n * @category Incremental Execution\n */\nexport function experimentalExecuteIncrementally(\n  args: ExecutionArgs,\n): PromiseOrValue<ExecutionResult | ExperimentalIncrementalExecutionResults> {\n  if (!shouldTrace(executeChannel)) {\n    return experimentalExecuteIncrementallyImpl(args);\n  }\n  return traceMixed(executeChannel, buildOperationContextFromArgs(args), () =>\n    experimentalExecuteIncrementallyImpl(args),\n  );\n}\n\nfunction experimentalExecuteIncrementallyImpl(\n  args: ExecutionArgs,\n): PromiseOrValue<ExecutionResult | ExperimentalIncrementalExecutionResults> {\n  // If the request cannot produce valid execution arguments, return a\n  // \"Response\" with only errors.\n  const validatedExecutionArgs = validateExecutionArgs(args);\n\n  // Return early errors if execution context failed.\n  if (!('schema' in validatedExecutionArgs)) {\n    return { errors: validatedExecutionArgs };\n  }\n\n  return experimentalExecuteRootSelectionSet(validatedExecutionArgs);\n}\n\n/** @internal */\nexport function executeIgnoringIncremental(\n  args: ExecutionArgs,\n): PromiseOrValue<ExecutionResult | ExperimentalIncrementalExecutionResults> {\n  if (!shouldTrace(executeChannel)) {\n    return executeIgnoringIncrementalImpl(args);\n  }\n  return traceMixed(executeChannel, buildOperationContextFromArgs(args), () =>\n    executeIgnoringIncrementalImpl(args),\n  );\n}\n\nfunction executeIgnoringIncrementalImpl(\n  args: ExecutionArgs,\n): PromiseOrValue<ExecutionResult | ExperimentalIncrementalExecutionResults> {\n  // If the request cannot produce valid execution arguments, return a\n  // \"Response\" with only errors.\n  const validatedExecutionArgs = validateExecutionArgs(args);\n\n  // Return early errors if execution context failed.\n  if (!('schema' in validatedExecutionArgs)) {\n    return { errors: validatedExecutionArgs };\n  }\n\n  return executeRootSelectionSetIgnoringIncremental(validatedExecutionArgs);\n}\n\n/**\n * Implements the \"Executing operations\" section of the spec.\n *\n * Returns either a synchronous ExecutionResult, or a Promise for an\n * ExecutionResult, described by the \"Response\" section of the GraphQL\n * specification.\n *\n * If errors are encountered while executing a GraphQL field, only that field\n * and its descendants will be omitted, and sibling fields will still be\n * executed. These field errors are collected into the returned result instead\n * of being thrown or rejecting the returned promise.\n *\n * Errors from sub-fields of a NonNull type may propagate to the top level, at\n * which point we still collect the error and null the parent field, which in\n * this case is the entire response.\n * @param validatedExecutionArgs - Validated execution arguments.\n * @returns Execution result for the operation root selection set.\n * @example\n * ```ts\n * import assert from 'node:assert';\n * import { parse } from 'graphql/language';\n * import { buildSchema } from 'graphql/utilities';\n * import {\n *   executeRootSelectionSet,\n *   validateExecutionArgs,\n * } from 'graphql/execution';\n *\n * const schema = buildSchema('type Query { greeting: String }');\n * const validatedArgs = validateExecutionArgs({\n *   schema,\n *   document: parse('{ greeting }'),\n *   rootValue: { greeting: 'Hello' },\n * });\n *\n * assert('schema' in validatedArgs);\n *\n * const result = await executeRootSelectionSet(validatedArgs);\n * result; // => { data: { greeting: 'Hello' } }\n * ```\n */\nexport function executeRootSelectionSet(\n  validatedExecutionArgs: ValidatedExecutionArgs,\n): PromiseOrValue<ExecutionResult> {\n  return new ExecutorThrowingOnIncremental(\n    validatedExecutionArgs,\n  ).executeRootSelectionSet();\n}\n\n/**\n * Executes the operation root selection set with incremental delivery enabled.\n * @param validatedExecutionArgs - Validated execution arguments.\n * @returns A single execution result or incremental execution results.\n * @example\n * ```ts\n * import assert from 'node:assert';\n * import { parse } from 'graphql/language';\n * import { buildSchema } from 'graphql/utilities';\n * import {\n *   experimentalExecuteRootSelectionSet,\n *   validateExecutionArgs,\n * } from 'graphql/execution';\n *\n * const schema = buildSchema('type Query { greeting: String }');\n * const validatedArgs = validateExecutionArgs({\n *   schema,\n *   document: parse('{ greeting }'),\n *   rootValue: { greeting: 'Hello' },\n * });\n *\n * assert('schema' in validatedArgs);\n *\n * const result = await experimentalExecuteRootSelectionSet(validatedArgs);\n * result; // => { data: { greeting: 'Hello' } }\n * ```\n * @category Incremental Execution\n */\nexport function experimentalExecuteRootSelectionSet(\n  validatedExecutionArgs: ValidatedExecutionArgs,\n): PromiseOrValue<ExecutionResult | ExperimentalIncrementalExecutionResults> {\n  return new IncrementalExecutor(\n    validatedExecutionArgs,\n  ).executeRootSelectionSet();\n}\n\n/** @internal */\nexport function executeRootSelectionSetIgnoringIncremental(\n  validatedExecutionArgs: ValidatedExecutionArgs,\n): PromiseOrValue<ExecutionResult | ExperimentalIncrementalExecutionResults> {\n  return new Executor(validatedExecutionArgs).executeRootSelectionSet();\n}\n\n/**\n * Also implements the \"Executing requests\" section of the GraphQL specification.\n * However, it guarantees to complete synchronously (or throw an error) assuming\n * that all field resolvers are also synchronous.\n * @param args - The arguments used to perform the operation.\n * @returns Completed execution output for a synchronous operation.\n * @example\n * ```ts\n * import { parse } from 'graphql/language';\n * import { buildSchema } from 'graphql/utilities';\n * import { executeSync } from 'graphql/execution';\n *\n * const schema = buildSchema('type Query { greeting: String }');\n *\n * const result = executeSync({\n *   schema,\n *   document: parse('{ greeting }'),\n *   rootValue: { greeting: 'Hello' },\n * });\n *\n * result; // => { data: { greeting: 'Hello' } }\n * ```\n */\nexport function executeSync(args: ExecutionArgs): ExecutionResult {\n  const result = experimentalExecuteIncrementally(args);\n\n  // Assert that the execution was synchronous.\n  if (isPromise(result) || 'initialResult' in result) {\n    throw new Error('GraphQL execution failed to complete synchronously.');\n  }\n\n  return result;\n}\n\n/**\n * Executes a subscription operation once for a single source event.\n *\n * Field errors are collected into the returned result instead of being thrown\n * or rejecting the returned promise.\n * @param validatedExecutionArgs - Validated subscription execution arguments.\n * @returns Execution result for the subscription event.\n * @example\n * ```ts\n * import assert from 'node:assert';\n * import { parse } from 'graphql/language';\n * import { buildSchema } from 'graphql/utilities';\n * import {\n *   executeSubscriptionEvent,\n *   validateSubscriptionArgs,\n * } from 'graphql/execution';\n *\n * const schema = buildSchema(`\n *   type Query {\n *     noop: String\n *   }\n *\n *   type Subscription {\n *     greeting: String\n *   }\n * `);\n * const validatedArgs = validateSubscriptionArgs({\n *   schema,\n *   document: parse('subscription { greeting }'),\n *   rootValue: { greeting: 'Hello' },\n * });\n *\n * assert('schema' in validatedArgs);\n *\n * const result = await executeSubscriptionEvent(validatedArgs);\n * result; // => { data: { greeting: 'Hello' } }\n * ```\n */\nexport function executeSubscriptionEvent(\n  validatedExecutionArgs: ValidatedSubscriptionArgs,\n): PromiseOrValue<ExecutionResult> {\n  return new ExecutorThrowingOnIncremental(\n    validatedExecutionArgs,\n  ).executeRootSelectionSet(false);\n}\n\n/**\n * Implements the \"Subscribe\" algorithm described in the GraphQL specification.\n *\n * Returns either an AsyncGenerator (if successful), an ExecutionResult (error),\n * or a Promise for one of those results. The call will throw immediately if\n * the schema is invalid or the selected operation is not a subscription.\n *\n * GraphQL request errors, including missing operations and variable coercion\n * errors, return or resolve to a GraphQL Response (ExecutionResult) with\n * descriptive errors and no data.\n *\n * If the source stream could not be created due to faulty subscription resolver\n * logic, a non-async-iterable resolver result, or a system error, the\n * function will return or resolve to a single ExecutionResult containing\n * `errors` and no `data`.\n *\n * If the operation succeeded, the function returns or resolves to an\n * AsyncGenerator, which yields a stream of ExecutionResults representing the\n * response stream.\n *\n * This function does not support incremental delivery (`@defer` and `@stream`).\n * If an operation which would defer or stream data is executed with this\n * function, a field error will be raised at the location of the `@defer` or\n * `@stream` directive.\n *\n * Accepts an object with named arguments.\n * @param args - Execution arguments for the subscription operation.\n * @returns A response stream for a valid subscription, or an execution result containing errors.\n * @example\n * ```ts\n * // Use a same-named rootValue function to provide the source event stream.\n * import assert from 'node:assert';\n * import { parse } from 'graphql/language';\n * import { buildSchema } from 'graphql/utilities';\n * import { subscribe } from 'graphql/execution';\n *\n * async function* greetings() {\n *   yield { greeting: 'Hello' };\n *   yield { greeting: 'Bonjour' };\n * }\n *\n * const schema = buildSchema(`\n *   type Query {\n *     noop: String\n *   }\n *\n *   type Subscription {\n *     greeting: String\n *   }\n * `);\n *\n * const result = await subscribe({\n *   schema,\n *   document: parse('subscription { greeting }'),\n *   rootValue: { greeting: () => greetings() },\n * });\n *\n * assert('next' in result);\n *\n * const firstPayload = await result.next();\n * firstPayload.value; // => { data: { greeting: 'Hello' } }\n * ```\n * @example\n * ```ts\n * // This variant supplies events through a custom subscribeFieldResolver.\n * import assert from 'node:assert';\n * import { parse } from 'graphql/language';\n * import { buildSchema } from 'graphql/utilities';\n * import { subscribe } from 'graphql/execution';\n *\n * async function* defaultGreetings() {\n *   yield { greeting: 'Hello' };\n * }\n *\n * async function* frenchGreetings() {\n *   yield { greeting: 'Bonjour' };\n * }\n *\n * const schema = buildSchema(`\n *   type Query {\n *     noop: String\n *   }\n *\n *   type Subscription {\n *     greeting(locale: String): String\n *   }\n * `);\n *\n * const result = await subscribe({\n *   schema,\n *   document: parse(\n *     'subscription Greeting($locale: String) { greeting(locale: $locale) }',\n *   ),\n *   rootValue: {\n *     greeting: (args, contextValue) => {\n *       const locale = args.locale ?? contextValue.defaultLocale;\n *       return locale === 'fr' ? frenchGreetings() : defaultGreetings();\n *     },\n *   },\n *   contextValue: { defaultLocale: 'fr' },\n *   variableValues: { locale: 'fr' },\n *   operationName: 'Greeting',\n *   subscribeFieldResolver: (rootValue, args, contextValue, info) => {\n *     args.locale; // => 'fr'\n *     return rootValue[info.fieldName](args, contextValue);\n *   },\n * });\n *\n * assert('next' in result);\n *\n * const firstPayload = await result.next();\n * firstPayload.value; // => { data: { greeting: 'Bonjour' } }\n * ```\n */\nexport function subscribe(\n  args: ExecutionArgs,\n): PromiseOrValue<\n  AsyncGenerator<ExecutionResult, void, void> | ExecutionResult\n> {\n  if (!shouldTrace(subscribeChannel)) {\n    return subscribeImpl(args);\n  }\n  return traceMixed(subscribeChannel, buildOperationContextFromArgs(args), () =>\n    subscribeImpl(args),\n  );\n}\n\nfunction subscribeImpl(\n  args: ExecutionArgs,\n): PromiseOrValue<\n  AsyncGenerator<ExecutionResult, void, void> | ExecutionResult\n> {\n  // If the request cannot produce valid execution arguments, return a\n  // \"Response\" with only errors.\n  const validatedExecutionArgs = validateSubscriptionArgs(args);\n\n  // Return early errors if execution context failed.\n  if (!('schema' in validatedExecutionArgs)) {\n    return { errors: validatedExecutionArgs };\n  }\n\n  const resultOrStream = createSourceEventStream(validatedExecutionArgs);\n\n  if (isPromise(resultOrStream)) {\n    return resultOrStream.then((resolvedResultOrStream) =>\n      isAsyncIterable(resolvedResultOrStream)\n        ? mapSourceToResponseEvent(\n            validatedExecutionArgs,\n            resolvedResultOrStream,\n          )\n        : resolvedResultOrStream,\n    );\n  }\n\n  return isAsyncIterable(resultOrStream)\n    ? mapSourceToResponseEvent(validatedExecutionArgs, resultOrStream)\n    : resultOrStream;\n}\n\n/**\n * Implements the \"CreateSourceEventStream\" algorithm described in the\n * GraphQL specification, resolving the subscription source event stream for a\n * previously validated subscription request.\n *\n * Returns either an AsyncIterable (if successful), an ExecutionResult (error),\n * or a Promise for one of those results. The call will throw immediately if\n * it is not passed validated execution arguments.\n *\n * If the validated arguments do not result in a compliant subscription, a\n * GraphQL Response (ExecutionResult) with descriptive errors and no data will\n * be returned.\n *\n * If the source stream could not be created due to faulty subscription\n * resolver logic or a system error, the function will return or\n * resolve to a single ExecutionResult containing `errors` and no `data`.\n *\n * If the operation succeeded, the function returns or resolves to the\n * AsyncIterable for the event stream returned by the resolver.\n *\n * A Source Event Stream represents a sequence of events, each of which triggers\n * a GraphQL execution for that event.\n *\n * This may be useful when hosting the stateful subscription service in a\n * different process or machine than the stateless GraphQL execution engine,\n * or otherwise separating these two steps. For more on this, see the\n * \"Supporting Subscriptions at Scale\" information in the GraphQL specification.\n * @param validatedExecutionArgs - Validated subscription execution arguments.\n * @returns A source event stream, or an execution result containing errors.\n * @example\n * ```ts\n * import assert from 'node:assert';\n * import { parse } from 'graphql/language';\n * import { buildSchema } from 'graphql/utilities';\n * import {\n *   createSourceEventStream,\n *   validateSubscriptionArgs,\n * } from 'graphql/execution';\n *\n * async function* greetings() {\n *   yield { greeting: 'Hello' };\n * }\n *\n * const schema = buildSchema(`\n *   type Query {\n *     noop: String\n *   }\n *\n *   type Subscription {\n *     greeting: String\n *   }\n * `);\n * const validatedArgs = validateSubscriptionArgs({\n *   schema,\n *   document: parse('subscription { greeting }'),\n *   rootValue: { greeting: () => greetings() },\n * });\n *\n * assert('schema' in validatedArgs);\n *\n * const stream = await createSourceEventStream(validatedArgs);\n * Symbol.asyncIterator in stream; // => true\n * ```\n */\nexport function createSourceEventStream(\n  validatedExecutionArgs: ValidatedSubscriptionArgs,\n): PromiseOrValue<AsyncIterable<unknown> | ExecutionResult> {\n  if (!('operation' in validatedExecutionArgs)) {\n    throw new GraphQLError(\n      'Passing ExecutionArgs to createSourceEventStream() was removed in graphql-js@17.0.0; call validateSubscriptionArgs() first and pass the result instead, or use subscribe() for the full subscription pipeline.',\n    );\n  }\n\n  try {\n    const eventStream = executeSubscription(validatedExecutionArgs);\n    if (isPromise(eventStream)) {\n      return eventStream.then(undefined, (error: unknown) => ({\n        errors: [ensureGraphQLError(error)],\n      }));\n    }\n\n    return eventStream;\n  } catch (error) {\n    return { errors: [ensureGraphQLError(error)] };\n  }\n}\n\n/**\n * Validates the arguments passed to execute, subscribe, and their lower-level\n * helpers.\n *\n * Throws if the schema is invalid. GraphQL request errors, including variable\n * coercion errors, are returned as a GraphQLError array.\n * @param args - Execution arguments to validate.\n * @returns Validated execution arguments, or validation errors.\n * @example\n * ```ts\n * import assert from 'node:assert';\n * import { parse } from 'graphql/language';\n * import { buildSchema } from 'graphql/utilities';\n * import { validateExecutionArgs } from 'graphql/execution';\n *\n * const schema = buildSchema(`\n *   interface Named {\n *     name: String!\n *   }\n *\n *   type User implements Named {\n *     name: String!\n *   }\n *\n *   type Query {\n *     viewer: Named\n *   }\n * `);\n * const abortController = new AbortController();\n * const validatedArgs = validateExecutionArgs({\n *   schema,\n *   document: parse('query Viewer { viewer { __typename name } }'),\n *   rootValue: { viewer: { kind: 'user', name: 'Ada' } },\n *   contextValue: { locale: 'en' },\n *   operationName: 'Viewer',\n *   fieldResolver: (source, _args, contextValue, info) => {\n *     contextValue.locale; // => 'en'\n *     return source[info.fieldName];\n *   },\n *   typeResolver: (value) => {\n *     return value.kind === 'user' ? 'User' : undefined;\n *   },\n *   hideSuggestions: true,\n *   abortSignal: abortController.signal,\n *   enableEarlyExecution: true,\n *   hooks: {\n *     asyncWorkFinished: () => {},\n *   },\n *   options: { maxCoercionErrors: 1 },\n * });\n *\n * assert('operation' in validatedArgs);\n *\n * validatedArgs.operation.name?.value; // => 'Viewer'\n * validatedArgs.hideSuggestions; // => true\n * ```\n */\nexport function validateExecutionArgs(\n  args: ExecutionArgs,\n): ReadonlyArray<GraphQLError> | ValidatedExecutionArgs {\n  const {\n    schema,\n    document,\n    rootValue,\n    contextValue,\n    variableValues: rawVariableValues,\n    operationName,\n    fieldResolver,\n    typeResolver,\n    subscribeFieldResolver,\n    abortSignal: externalAbortSignal,\n    enableEarlyExecution,\n    hooks,\n    options,\n  } = args;\n\n  // If the schema used for execution is invalid, throw an error.\n  assertValidSchema(schema);\n\n  let operation: OperationDefinitionNode | undefined;\n  const fragmentDefinitions: ObjMap<FragmentDefinitionNode> =\n    Object.create(null);\n  const fragments: ObjMap<FragmentDetails> = Object.create(null);\n  const fragmentVariableSignatureErrors: Array<GraphQLError> = [];\n  for (const definition of document.definitions) {\n    switch (definition.kind) {\n      case Kind.OPERATION_DEFINITION:\n        if (operationName == null) {\n          if (operation !== undefined) {\n            return [\n              new GraphQLError(\n                'Must provide operation name if query contains multiple operations.',\n              ),\n            ];\n          }\n          operation = definition;\n        } else if (definition.name?.value === operationName) {\n          operation = definition;\n        }\n        break;\n      case Kind.FRAGMENT_DEFINITION: {\n        fragmentDefinitions[definition.name.value] = definition;\n        let variableSignatures;\n        if (definition.variableDefinitions) {\n          const signatures: ObjMap<GraphQLVariableSignature> =\n            Object.create(null);\n          for (const varDef of definition.variableDefinitions) {\n            const signature = getVariableSignature(schema, varDef);\n            if (signature instanceof GraphQLError) {\n              fragmentVariableSignatureErrors.push(signature);\n              continue;\n            }\n            signatures[signature.name] = signature;\n          }\n          variableSignatures = signatures;\n        }\n        fragments[definition.name.value] = { definition, variableSignatures };\n        break;\n      }\n      default:\n      // ignore non-executable definitions\n    }\n  }\n\n  if (!operation) {\n    if (operationName != null) {\n      return [new GraphQLError(`Unknown operation named \"${operationName}\".`)];\n    }\n    return [new GraphQLError('Must provide an operation.')];\n  }\n\n  if (fragmentVariableSignatureErrors.length > 0) {\n    return fragmentVariableSignatureErrors;\n  }\n\n  const variableDefinitions = operation.variableDefinitions ?? [];\n  const hideSuggestions = args.hideSuggestions ?? false;\n\n  const coercionInput = rawVariableValues ?? {};\n  const coercionOptions = {\n    maxErrors: options?.maxCoercionErrors ?? 50,\n    hideSuggestions,\n  };\n  const coercionChannel = executeVariableCoercionChannel;\n  const variableValuesOrErrors = shouldTrace(coercionChannel)\n    ? traceMixed(\n        coercionChannel,\n        {\n          schema,\n          document,\n          operation,\n          rawVariableValues,\n          operationName: operation.name?.value,\n          operationType: operation.operation,\n        },\n        () =>\n          getVariableValues(\n            schema,\n            variableDefinitions,\n            coercionInput,\n            coercionOptions,\n          ),\n      )\n    : getVariableValues(\n        schema,\n        variableDefinitions,\n        coercionInput,\n        coercionOptions,\n      );\n\n  if (variableValuesOrErrors.errors) {\n    return variableValuesOrErrors.errors;\n  }\n\n  const errorPropagation = !operation.directives?.find(\n    (directive) =>\n      directive.name.value === GraphQLDisableErrorPropagationDirective.name,\n  );\n\n  return {\n    schema,\n    document,\n    fragmentDefinitions,\n    fragments,\n    rootValue,\n    contextValue,\n    operation,\n    variableValues: variableValuesOrErrors.variableValues,\n    fieldResolver: fieldResolver ?? defaultFieldResolver,\n    typeResolver: typeResolver ?? defaultTypeResolver,\n    subscribeFieldResolver: subscribeFieldResolver ?? defaultFieldResolver,\n    hideSuggestions,\n    errorPropagation,\n    externalAbortSignal: externalAbortSignal ?? undefined,\n    enableEarlyExecution: enableEarlyExecution === true,\n    hooks: hooks ?? undefined,\n    rawVariableValues,\n  };\n}\n\n/**\n * Validates execution arguments for a subscription operation.\n *\n * Throws if the schema is invalid or the selected operation is not a\n * subscription. GraphQL request errors, including variable coercion errors, are\n * returned as a GraphQLError array.\n * @param args - Execution arguments to validate.\n * @returns Validated subscription execution arguments, or validation errors.\n * @example\n * ```ts\n * import assert from 'node:assert';\n * import { parse } from 'graphql/language';\n * import { buildSchema } from 'graphql/utilities';\n * import { validateSubscriptionArgs } from 'graphql/execution';\n *\n * const schema = buildSchema(`\n *   type Query {\n *     noop: String\n *   }\n *\n *   type Subscription {\n *     greeting: String\n *   }\n * `);\n * const validatedArgs = validateSubscriptionArgs({\n *   schema,\n *   document: parse('subscription { greeting }'),\n * });\n *\n * assert('operation' in validatedArgs);\n *\n * validatedArgs.operation.operation; // => 'subscription'\n * ```\n */\nexport function validateSubscriptionArgs(\n  args: ExecutionArgs,\n): ReadonlyArray<GraphQLError> | ValidatedSubscriptionArgs {\n  const validatedExecutionArgs = validateExecutionArgs(args);\n  if (!('schema' in validatedExecutionArgs)) {\n    return validatedExecutionArgs;\n  }\n  assertSubscriptionExecutionArgs(validatedExecutionArgs);\n  return validatedExecutionArgs;\n}\n\nfunction assertSubscriptionExecutionArgs(\n  validatedExecutionArgs: ValidatedExecutionArgs,\n): asserts validatedExecutionArgs is ValidatedSubscriptionArgs {\n  if (\n    !isSubscriptionOperationDefinitionNode(validatedExecutionArgs.operation)\n  ) {\n    throw new GraphQLError('Expected subscription operation.');\n  }\n}\n\n/**\n * If a resolveType function is not given, then a default resolve behavior is\n * used which attempts two strategies:\n *\n * First, See if the provided value has a `__typename` field defined, if so, use\n * that value as name of the resolved type.\n *\n * Otherwise, test each possible type for the abstract type by calling\n * isTypeOf for the object being coerced, returning the first type that matches.\n */\nexport const defaultTypeResolver: GraphQLTypeResolver<unknown, unknown> =\n  function (value, contextValue, info, abstractType) {\n    // First, look for `__typename`.\n    if (isObjectLike(value) && typeof value.__typename === 'string') {\n      return value.__typename;\n    }\n\n    // Otherwise, test each possible type.\n    const possibleTypes = info.schema.getPossibleTypes(abstractType);\n    const promisedIsTypeOfResults: Array<PromiseLike<boolean>> = [];\n\n    try {\n      for (let i = 0; i < possibleTypes.length; i++) {\n        const type = possibleTypes[i];\n\n        if (type.isTypeOf) {\n          const isTypeOfResult = type.isTypeOf(value, contextValue, info);\n\n          if (isPromiseLike(isTypeOfResult)) {\n            promisedIsTypeOfResults[i] = isTypeOfResult;\n          } else if (isTypeOfResult) {\n            if (promisedIsTypeOfResults.length) {\n              info.getAsyncHelpers().track(promisedIsTypeOfResults);\n            }\n            return type.name;\n          }\n        }\n      }\n    } catch (error) {\n      if (promisedIsTypeOfResults.length) {\n        info.getAsyncHelpers().track(promisedIsTypeOfResults);\n      }\n      throw error;\n    }\n\n    if (promisedIsTypeOfResults.length) {\n      return info\n        .getAsyncHelpers()\n        .promiseAll(promisedIsTypeOfResults)\n        .then((isTypeOfResults) => {\n          for (let i = 0; i < isTypeOfResults.length; i++) {\n            if (isTypeOfResults[i]) {\n              return possibleTypes[i].name;\n            }\n          }\n        });\n    }\n  };\n\n/**\n * If a resolve function is not given, then a default resolve behavior is used\n * which takes the property of the source object of the same name as the field\n * and returns it as the result, or if it's a function, returns the result\n * of calling that function while passing along args and context value.\n */\nexport const defaultFieldResolver: GraphQLFieldResolver<unknown, unknown> =\n  function (source: any, args, contextValue, info) {\n    // ensure source is a value for which property access is acceptable.\n    if (isObjectLike(source) || typeof source === 'function') {\n      const property = source[info.fieldName];\n      if (typeof property === 'function') {\n        return source[info.fieldName](args, contextValue, info);\n      }\n      return property;\n    }\n  };\n\n/**\n * Implements the \"MapSourceToResponseEvent\" algorithm described in the\n * GraphQL specification, mapping each event from a subscription source event\n * stream to an ExecutionResult in the response stream.\n * @param validatedExecutionArgs - Validated subscription execution arguments.\n * @param sourceEventStream - Source event stream returned by the subscription resolver.\n * @param rootSelectionSetExecutor - Function used to execute each source event.\n * @returns A response stream of execution results.\n * @example\n * ```ts\n * import assert from 'node:assert';\n * import { parse } from 'graphql/language';\n * import { buildSchema } from 'graphql/utilities';\n * import {\n *   mapSourceToResponseEvent,\n *   validateSubscriptionArgs,\n * } from 'graphql/execution';\n *\n * async function* events() {\n *   yield { greeting: 'Hello' };\n * }\n *\n * const schema = buildSchema(`\n *   type Query {\n *     noop: String\n *   }\n *\n *   type Subscription {\n *     greeting: String\n *   }\n * `);\n * const validatedArgs = validateSubscriptionArgs({\n *   schema,\n *   document: parse('subscription { greeting }'),\n * });\n *\n * assert('schema' in validatedArgs);\n *\n * const responseStream = mapSourceToResponseEvent(validatedArgs, events());\n * const firstPayload = await responseStream.next();\n *\n * firstPayload.value; // => { data: { greeting: 'Hello' } }\n * ```\n */\nexport function mapSourceToResponseEvent(\n  validatedExecutionArgs: ValidatedSubscriptionArgs,\n  sourceEventStream: AsyncIterable<unknown>,\n  rootSelectionSetExecutor: RootSelectionSetExecutor = executeSubscriptionEvent,\n): AsyncGenerator<ExecutionResult, void, void> {\n  // For each payload yielded from a subscription, map it over the normal\n  // GraphQL `execute` function, with `payload` as the rootValue.\n  function mapFn(payload: unknown): PromiseOrValue<ExecutionResult> {\n    const perEventExecutionArgs: ValidatedSubscriptionArgs = {\n      ...validatedExecutionArgs,\n      rootValue: payload,\n    };\n    return rootSelectionSetExecutor(perEventExecutionArgs);\n  }\n\n  const externalAbortSignal = validatedExecutionArgs.externalAbortSignal;\n  if (externalAbortSignal) {\n    const generator = mapAsyncIterable(sourceEventStream, mapFn);\n    return {\n      ...generator,\n      next: () => cancellablePromise(generator.next(), externalAbortSignal),\n    };\n  }\n  return mapAsyncIterable(sourceEventStream, mapFn);\n}\n\nfunction executeSubscription(\n  validatedExecutionArgs: ValidatedExecutionArgs,\n): PromiseOrValue<AsyncIterable<unknown>> {\n  const {\n    schema,\n    fragments,\n    rootValue,\n    contextValue,\n    operation,\n    variableValues,\n    hideSuggestions,\n    externalAbortSignal,\n  } = validatedExecutionArgs;\n\n  const rootType = schema.getSubscriptionType();\n  if (rootType == null) {\n    throw new GraphQLError(\n      'Schema is not configured to execute subscription operation.',\n      { nodes: operation },\n    );\n  }\n\n  const { groupedFieldSet } = collectFields(\n    schema,\n    fragments,\n    variableValues,\n    rootType,\n    operation.selectionSet,\n    hideSuggestions,\n  );\n\n  const firstRootField = groupedFieldSet.entries().next().value as [\n    string,\n    FieldDetailsList,\n  ];\n  const [responseName, fieldDetailsList] = firstRootField;\n  const firstFieldDetails = fieldDetailsList[0];\n  const firstNode = firstFieldDetails.node;\n  const fieldName = firstNode.name.value;\n  const fieldDef = schema.getField(rootType, fieldName);\n\n  const fieldNodes = fieldDetailsList.map((fieldDetails) => fieldDetails.node);\n  if (!fieldDef) {\n    throw new GraphQLError(\n      `The subscription field \"${fieldName}\" is not defined.`,\n      { nodes: fieldNodes },\n    );\n  }\n\n  const sharedExecutionContext =\n    createSharedExecutionContext(externalAbortSignal);\n  const path = addPath(undefined, responseName, rootType.name);\n  const info = buildResolveInfo(\n    validatedExecutionArgs,\n    fieldDef,\n    fieldNodes,\n    rootType,\n    path,\n    sharedExecutionContext.getAbortSignal,\n    sharedExecutionContext.getAsyncHelpers,\n  );\n\n  try {\n    // Implements the \"ResolveFieldEventStream\" algorithm from GraphQL specification.\n    // It differs from \"ResolveFieldValue\" due to providing a different `resolveFn`.\n\n    // Build a JS object of arguments from the field.arguments AST, using the\n    // variables scope to fulfill any variable references.\n    const args = getArgumentValues(\n      fieldDef,\n      firstNode,\n      variableValues,\n      firstFieldDetails.fragmentVariableValues,\n      hideSuggestions,\n    );\n\n    // Call the `subscribe()` resolver or the default resolver to produce an\n    // AsyncIterable yielding raw payloads.\n    const resolveFn =\n      fieldDef.subscribe ?? validatedExecutionArgs.subscribeFieldResolver;\n\n    // The resolve function's optional third argument is a context value that\n    // is provided to every resolve function within an execution. It is commonly\n    // used to represent an authenticated user, or request-specific caches.\n    const result = resolveFn(rootValue, args, contextValue, info);\n\n    if (isPromiseLike(result)) {\n      const promisedResult = Promise.resolve(result);\n      const promise = externalAbortSignal\n        ? cancellablePromise(promisedResult, externalAbortSignal)\n        : promisedResult;\n      return promise\n        .then(assertEventStream)\n        .then(undefined, (error: unknown) => {\n          throw locatedError(\n            error,\n            toNodes(fieldDetailsList),\n            pathToArray(path),\n          );\n        });\n    }\n    return assertEventStream(result);\n  } catch (error) {\n    throw locatedError(error, fieldNodes, pathToArray(path));\n  }\n}\n\nfunction assertEventStream(result: unknown): AsyncIterable<unknown> {\n  if (result instanceof Error) {\n    throw result;\n  }\n\n  // Assert field returned an event stream, otherwise yield an error.\n  if (!isAsyncIterable(result)) {\n    throw new GraphQLError(\n      'Subscription field must return Async Iterable. ' +\n        `Received: ${inspect(result)}.`,\n    );\n  }\n\n  return result;\n}\n\nfunction toNodes(fieldDetailsList: FieldDetailsList): ReadonlyArray<FieldNode> {\n  return fieldDetailsList.map((fieldDetails) => fieldDetails.node);\n}\n"]}

package/execution/execute.mjs

@@ -148,6 +148,7 @@ export function validateExecutionArgs(args) {
     let operation;
     const fragmentDefinitions = Object.create(null);
     const fragments = Object.create(null);
+    const fragmentVariableSignatureErrors = [];
     for (const definition of document.definitions) {
         switch (definition.kind) {
             case Kind.OPERATION_DEFINITION:
@@ -167,11 +168,16 @@ export function validateExecutionArgs(args) {
                 fragmentDefinitions[definition.name.value] = definition;
                 let variableSignatures;
                 if (definition.variableDefinitions) {
-                    variableSignatures = Object.create(null);
+                    const signatures = Object.create(null);
                     for (const varDef of definition.variableDefinitions) {
                         const signature = getVariableSignature(schema, varDef);
-                        variableSignatures[signature.name] = signature;
+                        if (signature instanceof GraphQLError) {
+                            fragmentVariableSignatureErrors.push(signature);
+                            continue;
+                        }
+                        signatures[signature.name] = signature;
                     }
+                    variableSignatures = signatures;
                 }
                 fragments[definition.name.value] = { definition, variableSignatures };
                 break;
@@ -185,6 +191,9 @@ export function validateExecutionArgs(args) {
         }
         return [new GraphQLError('Must provide an operation.')];
     }
+    if (fragmentVariableSignatureErrors.length > 0) {
+        return fragmentVariableSignatureErrors;
+    }
     const variableDefinitions = operation.variableDefinitions ?? [];
     const hideSuggestions = args.hideSuggestions ?? false;
     const coercionInput = rawVariableValues ?? {};