graphql 17.0.0-beta.2 → 17.0.0

package/execution/execute.d.mts

@@ -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.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

@@ -26,6 +26,8 @@ const kinds_ts_1 = require("../language/kinds.js");
 const predicates_ts_1 = require("../language/predicates.js");
 const directives_ts_1 = require("../type/directives.js");
 const index_ts_1 = require("../type/index.js");
+const getOperationAST_ts_1 = require("../utilities/getOperationAST.js");
+const diagnostics_ts_1 = require("../diagnostics.js");
 const buildResolveInfo_ts_1 = require("./buildResolveInfo.js");
 const cancellablePromise_ts_1 = require("./cancellablePromise.js");
 const collectFields_ts_1 = require("./collectFields.js");
@@ -38,6 +40,32 @@ const mapAsyncIterable_ts_1 = require("./mapAsyncIterable.js");
 const values_ts_1 = require("./values.js");
 const UNEXPECTED_EXPERIMENTAL_DIRECTIVES = 'The provided schema unexpectedly contains experimental directives (@defer or @stream). These directives may only be utilized if experimental execution features are explicitly enabled.';
 function execute(args) {
+    if (!(0, diagnostics_ts_1.shouldTrace)(diagnostics_ts_1.executeChannel)) {
+        return executeImpl(args);
+    }
+    return (0, diagnostics_ts_1.traceMixed)(diagnostics_ts_1.executeChannel, buildOperationContextFromArgs(args), () => executeImpl(args));
+}
+function buildOperationContextFromArgs(args) {
+    let operation;
+    const resolveOperation = () => {
+        if (operation === undefined) {
+            operation = (0, getOperationAST_ts_1.getOperationAST)(args.document, args.operationName);
+        }
+        return operation;
+    };
+    return {
+        schema: args.schema,
+        document: args.document,
+        rawVariableValues: args.variableValues,
+        get operationName() {
+            return args.operationName ?? resolveOperation()?.name?.value;
+        },
+        get operationType() {
+            return resolveOperation()?.operation;
+        },
+    };
+}
+function executeImpl(args) {
     if (args.schema.getDirective('defer') || args.schema.getDirective('stream')) {
         throw new Error(UNEXPECTED_EXPERIMENTAL_DIRECTIVES);
     }
@@ -48,6 +76,12 @@ function execute(args) {
     return executeRootSelectionSet(validatedExecutionArgs);
 }
 function experimentalExecuteIncrementally(args) {
+    if (!(0, diagnostics_ts_1.shouldTrace)(diagnostics_ts_1.executeChannel)) {
+        return experimentalExecuteIncrementallyImpl(args);
+    }
+    return (0, diagnostics_ts_1.traceMixed)(diagnostics_ts_1.executeChannel, buildOperationContextFromArgs(args), () => experimentalExecuteIncrementallyImpl(args));
+}
+function experimentalExecuteIncrementallyImpl(args) {
     const validatedExecutionArgs = validateExecutionArgs(args);
     if (!('schema' in validatedExecutionArgs)) {
         return { errors: validatedExecutionArgs };
@@ -55,6 +89,12 @@ function experimentalExecuteIncrementally(args) {
     return experimentalExecuteRootSelectionSet(validatedExecutionArgs);
 }
 function executeIgnoringIncremental(args) {
+    if (!(0, diagnostics_ts_1.shouldTrace)(diagnostics_ts_1.executeChannel)) {
+        return executeIgnoringIncrementalImpl(args);
+    }
+    return (0, diagnostics_ts_1.traceMixed)(diagnostics_ts_1.executeChannel, buildOperationContextFromArgs(args), () => executeIgnoringIncrementalImpl(args));
+}
+function executeIgnoringIncrementalImpl(args) {
     const validatedExecutionArgs = validateExecutionArgs(args);
     if (!('schema' in validatedExecutionArgs)) {
         return { errors: validatedExecutionArgs };
@@ -81,6 +121,12 @@ function executeSubscriptionEvent(validatedExecutionArgs) {
     return new ExecutorThrowingOnIncremental_ts_1.ExecutorThrowingOnIncremental(validatedExecutionArgs).executeRootSelectionSet(false);
 }
 function subscribe(args) {
+    if (!(0, diagnostics_ts_1.shouldTrace)(diagnostics_ts_1.subscribeChannel)) {
+        return subscribeImpl(args);
+    }
+    return (0, diagnostics_ts_1.traceMixed)(diagnostics_ts_1.subscribeChannel, buildOperationContextFromArgs(args), () => subscribeImpl(args));
+}
+function subscribeImpl(args) {
     const validatedExecutionArgs = validateSubscriptionArgs(args);
     if (!('schema' in validatedExecutionArgs)) {
         return { errors: validatedExecutionArgs };
@@ -118,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:
@@ -137,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;
@@ -155,18 +207,34 @@ 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 variableValuesOrErrors = (0, values_ts_1.getVariableValues)(schema, variableDefinitions, rawVariableValues ?? {}, {
+    const coercionInput = rawVariableValues ?? {};
+    const coercionOptions = {
         maxErrors: options?.maxCoercionErrors ?? 50,
         hideSuggestions,
-    });
+    };
+    const coercionChannel = diagnostics_ts_1.executeVariableCoercionChannel;
+    const variableValuesOrErrors = (0, diagnostics_ts_1.shouldTrace)(coercionChannel)
+        ? (0, diagnostics_ts_1.traceMixed)(coercionChannel, {
+            schema,
+            document,
+            operation,
+            rawVariableValues,
+            operationName: operation.name?.value,
+            operationType: operation.operation,
+        }, () => (0, values_ts_1.getVariableValues)(schema, variableDefinitions, coercionInput, coercionOptions))
+        : (0, values_ts_1.getVariableValues)(schema, variableDefinitions, coercionInput, coercionOptions);
     if (variableValuesOrErrors.errors) {
         return variableValuesOrErrors.errors;
     }
     const errorPropagation = !operation.directives?.find((directive) => directive.name.value === directives_ts_1.GraphQLDisableErrorPropagationDirective.name);
     return {
         schema,
+        document,
         fragmentDefinitions,
         fragments,
         rootValue,
@@ -181,6 +249,7 @@ function validateExecutionArgs(args) {
         externalAbortSignal: externalAbortSignal ?? undefined,
         enableEarlyExecution: enableEarlyExecution === true,
         hooks: hooks ?? undefined,
+        rawVariableValues,
     };
 }
 function validateSubscriptionArgs(args) {