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

package/execution/values.d.ts

@@ -1,3 +1,4 @@
+/** @category Values */
 import type { Maybe } from "../jsutils/Maybe.js";
 import type { ObjMap, ReadOnlyObjMap } from "../jsutils/ObjMap.js";
 import { GraphQLError } from "../error/GraphQLError.js";
@@ -7,8 +8,18 @@ import type { GraphQLDirective } from "../type/directives.js";
 import type { GraphQLSchema } from "../type/schema.js";
 import type { FragmentVariableValues } from "./collectFields.js";
 import type { GraphQLVariableSignature } from "./getVariableSignature.js";
+/**
+ * Coerced variable values prepared for execution.
+ *
+ * The `coerced` map contains runtime values keyed by variable name. The
+ * `sources` map records whether each value came from request input, an operation
+ * default, or a fragment-variable default so utilities can preserve defaults
+ * when replacing variables in literals.
+ */
 export interface VariableValues {
+    /** Source metadata for each variable value keyed by variable name. */
     readonly sources: ReadOnlyObjMap<VariableValueSource>;
+    /** Coerced runtime variable values keyed by variable name. */
     readonly coerced: ReadOnlyObjMap<unknown>;
 }
 interface VariableValueSource {
@@ -25,10 +36,85 @@ type VariableValuesOrErrors = {
 /**
  * Prepares an object map of variableValues of the correct type based on the
  * provided variable definitions and arbitrary input. If the input cannot be
- * parsed to match the variable definitions, a GraphQLError will be thrown.
+ * parsed to match the variable definitions, GraphQLError values are returned.
+ *
+ * Note: Returned maps use null prototypes to avoid collisions with
+ * Object prototype properties.
+ * @param schema - GraphQL schema to use.
+ * @param varDefNodes - The variable definition AST nodes to coerce.
+ * @param inputs - The runtime variable values keyed by variable name.
+ * @param options - Optional configuration for this operation.
+ * @param [options.maxErrors] - Maximum number of coercion errors to report.
+ * @param [options.hideSuggestions] - Whether suggestion text should be omitted
+ * from errors.
+ * @returns Coerced variable values with source metadata, or request errors.
+ * @example
+ * ```ts
+ * // Coerce provided variables and apply operation defaults.
+ * import assert from 'node:assert';
+ * import { parse } from 'graphql/language';
+ * import { buildSchema } from 'graphql/utilities';
+ * import { getVariableValues } from 'graphql/execution';
+ *
+ * const schema = buildSchema(`
+ *   type Query {
+ *     reviews(stars: Int!, limit: Int = 10): [String]
+ *   }
+ * `);
+ * const document = parse(`
+ *   query ($stars: Int!, $limit: Int = 10) {
+ *     reviews(stars: $stars, limit: $limit)
+ *   }
+ * `);
+ * const operation = document.definitions[0];
+ *
+ * const result = getVariableValues(
+ *   schema,
+ *   operation.variableDefinitions,
+ *   { stars: '5' },
+ * );
+ *
+ * assert('variableValues' in result);
+ *
+ * result.variableValues.coerced; // => { stars: 5, limit: 10 }
+ * ```
+ * @example
+ * ```ts
+ * // This variant uses maxErrors to cap reported coercion errors.
+ * import assert from 'node:assert';
+ * import { parse } from 'graphql/language';
+ * import { buildSchema } from 'graphql/utilities';
+ * import { getVariableValues } from 'graphql/execution';
+ *
+ * const schema = buildSchema(`
+ *   input ReviewInput {
+ *     stars: Int!
+ *   }
+ *
+ *   type Query {
+ *     review(input: ReviewInput!): String
+ *   }
+ * `);
+ * const document = parse(`
+ *   query ($first: ReviewInput!, $second: ReviewInput!) {
+ *     first: review(input: $first)
+ *     second: review(input: $second)
+ *   }
+ * `);
+ * const operation = document.definitions[0];
+ *
+ * const result = getVariableValues(
+ *   schema,
+ *   operation.variableDefinitions,
+ *   { first: { stars: 'bad' }, second: { stars: 'also bad' } },
+ *   { maxErrors: 1 },
+ * );
  *
- * Note: The `coerced` and `sources` properties of VariableValues use null
- * prototype to avoid collisions with JavaScript's own property names.
+ * assert('errors' in result);
+ *
+ * result.errors.length; // => 2
+ * result.errors[1].message; // matches /error limit reached/
+ * ```
  */
 export declare function getVariableValues(schema: GraphQLSchema, varDefNodes: ReadonlyArray<VariableDefinitionNode>, inputs: {
     readonly [variable: string]: unknown;
@@ -36,13 +122,66 @@ export declare function getVariableValues(schema: GraphQLSchema, varDefNodes: Re
     maxErrors?: number;
     hideSuggestions?: boolean;
 }): VariableValuesOrErrors;
+/** @internal */
 export declare function getFragmentVariableValues(fragmentSpreadNode: FragmentSpreadNode, fragmentSignatures: ReadOnlyObjMap<GraphQLVariableSignature>, variableValues: VariableValues, fragmentVariableValues?: Maybe<FragmentVariableValues>, hideSuggestions?: Maybe<boolean>): FragmentVariableValues;
 /**
  * Prepares an object map of argument values given a list of argument
  * definitions and list of argument AST nodes.
  *
- * Note: The returned value uses a null prototype to avoid collisions with
+ * Note: Returned value uses a null prototype to avoid collisions with
  * JavaScript's own property names.
+ * @param def - Field or directive definition that declares the arguments.
+ * @param node - Field or directive AST node supplying argument literals.
+ * @param variableValues - Operation variable values returned by getVariableValues.
+ * @param fragmentVariableValues - Fragment variable values for the current fragment scope.
+ * @param hideSuggestions - Whether suggestion text should be omitted from errors.
+ * @returns A map of coerced argument values.
+ * @example
+ * ```ts
+ * // Read literal argument values and defaults.
+ * import { parse } from 'graphql/language';
+ * import { buildSchema } from 'graphql/utilities';
+ * import { getArgumentValues } from 'graphql/execution';
+ *
+ * const schema = buildSchema(`
+ *   type Query {
+ *     reviews(stars: Int!, limit: Int = 10): [String]
+ *   }
+ * `);
+ * const fieldDef = schema.getQueryType().getFields().reviews;
+ * const document = parse('{ reviews(stars: 5) }');
+ * const fieldNode = document.definitions[0].selectionSet.selections[0];
+ *
+ * getArgumentValues(fieldDef, fieldNode); // => { stars: 5, limit: 10 }
+ * ```
+ * @example
+ * ```ts
+ * // This variant resolves argument values from operation variables.
+ * import assert from 'node:assert';
+ * import { parse } from 'graphql/language';
+ * import { buildSchema } from 'graphql/utilities';
+ * import { getArgumentValues, getVariableValues } from 'graphql/execution';
+ *
+ * const schema = buildSchema(`
+ *   type Query {
+ *     reviews(stars: Int!): [String]
+ *   }
+ * `);
+ * const fieldDef = schema.getQueryType().getFields().reviews;
+ * const document = parse('query ($stars: Int!) { reviews(stars: $stars) }');
+ * const operation = document.definitions[0];
+ * const fieldNode = document.definitions[0].selectionSet.selections[0];
+ * const variables = getVariableValues(
+ *   schema,
+ *   operation.variableDefinitions,
+ *   { stars: '5' },
+ * );
+ *
+ * assert('variableValues' in variables);
+ *
+ * getArgumentValues(fieldDef, fieldNode, variables.variableValues); // => { stars: 5 }
+ * getArgumentValues(fieldDef, fieldNode); // throws an error
+ * ```
  */
 export declare function getArgumentValues(def: GraphQLField<unknown, unknown> | GraphQLDirective, node: FieldNode | DirectiveNode, variableValues?: Maybe<VariableValues>, fragmentVariableValues?: Maybe<FragmentVariableValues>, hideSuggestions?: Maybe<boolean>): ObjMap<unknown>;
 /**
@@ -52,8 +191,51 @@ export declare function getArgumentValues(def: GraphQLField<unknown, unknown> |
  *
  * If the directive does not exist on the node, returns undefined.
  *
- * Note: The returned value uses a null prototype to avoid collisions with
+ * Note: Returned value uses a null prototype to avoid collisions with
  * JavaScript's own property names.
+ * @param directiveDef - Directive definition to read argument definitions from.
+ * @param node - AST node that may contain directives.
+ * @param node.directives - The directives on the AST node.
+ * @param variableValues - Operation variable values returned by getVariableValues.
+ * @param fragmentVariableValues - Fragment variable values for the current fragment scope.
+ * @param hideSuggestions - Whether suggestion text should be omitted from errors.
+ * @returns A map of coerced directive argument values, or undefined when absent.
+ * @example
+ * ```ts
+ * // Read literal directive arguments from a node.
+ * import { parse } from 'graphql/language';
+ * import { GraphQLSkipDirective } from 'graphql/type';
+ * import { getDirectiveValues } from 'graphql/execution';
+ *
+ * const document = parse('{ name @skip(if: true) }');
+ * const fieldNode = document.definitions[0].selectionSet.selections[0];
+ *
+ * getDirectiveValues(GraphQLSkipDirective, fieldNode); // => { if: true }
+ * ```
+ * @example
+ * ```ts
+ * // This variant resolves directive arguments from variables and handles absent directives.
+ * import assert from 'node:assert';
+ * import { parse } from 'graphql/language';
+ * import { GraphQLIncludeDirective } from 'graphql/type';
+ * import { buildSchema } from 'graphql/utilities';
+ * import { getDirectiveValues, getVariableValues } from 'graphql/execution';
+ *
+ * const schema = buildSchema('type Query { name: String }');
+ * const document = parse('query ($includeName: Boolean!) { name @include(if: $includeName) }');
+ * const operation = document.definitions[0];
+ * const fieldNode = document.definitions[0].selectionSet.selections[0];
+ * const variables = getVariableValues(
+ *   schema,
+ *   operation.variableDefinitions,
+ *   { includeName: false },
+ * );
+ *
+ * assert('variableValues' in variables);
+ *
+ * getDirectiveValues(GraphQLIncludeDirective, fieldNode, variables.variableValues); // => { if: false }
+ * getDirectiveValues(GraphQLIncludeDirective, { directives: [] }); // => undefined
+ * ```
  */
 export declare function getDirectiveValues(directiveDef: GraphQLDirective, node: {
     readonly directives?: ReadonlyArray<DirectiveNode> | undefined;

package/execution/values.js

@@ -14,14 +14,6 @@ const validate_ts_1 = require("../type/validate.js");
 const coerceInputValue_ts_1 = require("../utilities/coerceInputValue.js");
 const validateInputValue_ts_1 = require("../utilities/validateInputValue.js");
 const getVariableSignature_ts_1 = require("./getVariableSignature.js");
-/**
- * Prepares an object map of variableValues of the correct type based on the
- * provided variable definitions and arbitrary input. If the input cannot be
- * parsed to match the variable definitions, a GraphQLError will be thrown.
- *
- * Note: The `coerced` and `sources` properties of VariableValues use null
- * prototype to avoid collisions with JavaScript's own property names.
- */
 function getVariableValues(schema, varDefNodes, inputs, options) {
     const errors = [];
     const maxErrors = options?.maxErrors;
@@ -61,7 +53,6 @@ function coerceVariableValues(schema, varDefNodes, inputs, onError, hideSuggesti
                 continue;
             }
             else if (!(0, definition_ts_1.isNonNullType)(varType)) {
-                // Non-provided values for nullable variables are omitted.
                 continue;
             }
         }
@@ -82,9 +73,6 @@ function coerceVariableValues(schema, varDefNodes, inputs, onError, hideSuggesti
 }
 function maybeUseDefaultValue(coercedValues, name, inputValue, onError, hideSuggestions) {
     try {
-        // coerceDefaultValue assumes validation has already rejected invalid
-        // defaults. If validation was skipped, invalid defaults or nested input
-        // field defaults can throw here; recover with validation-style errors below.
         const coercedDefaultValue = (0, coerceInputValue_ts_1.coerceDefaultValue)(inputValue);
         if (coercedDefaultValue !== undefined) {
             coercedValues[name] = coercedDefaultValue;
@@ -92,20 +80,15 @@ function maybeUseDefaultValue(coercedValues, name, inputValue, onError, hideSugg
     }
     catch (error) {
         const defaultInput = inputValue.default;
-        // Defensive: coerceDefaultValue should only throw while coercing a default.
-        /* node:coverage ignore next 3 */
         if (defaultInput === undefined) {
             throw error;
         }
-        // Prefer validation's user-facing errors for invalid defaults.
         let reportedValidationError = false;
         (0, validate_ts_1.validateDefaultInput)(defaultInput, inputValue.type, (defaultError, path) => {
             reportedValidationError = true;
             onError(defaultError, path);
         }, hideSuggestions);
         if (!reportedValidationError) {
-            // The default itself validated, so coercion failed while applying a nested
-            // input field default. Surface the original coercion error.
             onError((0, ensureGraphQLError_ts_1.ensureGraphQLError)(error), []);
         }
     }
@@ -116,26 +99,26 @@ function getFragmentVariableValues(fragmentSpreadNode, fragmentSignatures, varia
     const sources = Object.create(null);
     const coerced = Object.create(null);
     for (const [varName, varSignature] of Object.entries(fragmentSignatures)) {
-        sources[varName] = {
-            signature: varSignature,
-        };
         const argumentNode = argNodeMap.get(varName);
         if (argumentNode !== undefined) {
-            const source = sources[varName];
-            source.value = argumentNode.value;
-            source.fragmentVariableValues = fragmentVariableValues;
+            sources[varName] =
+                fragmentVariableValues == null
+                    ? { signature: varSignature, value: argumentNode.value }
+                    : {
+                        signature: varSignature,
+                        value: argumentNode.value,
+                        fragmentVariableValues,
+                    };
+        }
+        else {
+            sources[varName] = {
+                signature: varSignature,
+            };
         }
         coerceArgument(coerced, fragmentSpreadNode, varName, varSignature, argumentNode, variableValues, fragmentVariableValues, hideSuggestions);
     }
     return { sources, coerced };
 }
-/**
- * Prepares an object map of argument values given a list of argument
- * definitions and list of argument AST nodes.
- *
- * Note: The returned value uses a null prototype to avoid collisions with
- * JavaScript's own property names.
- */
 function getArgumentValues(def, node, variableValues, fragmentVariableValues, hideSuggestions) {
     const coercedValues = Object.create(null);
     const argumentNodes = node.arguments ?? [];
@@ -146,7 +129,6 @@ function getArgumentValues(def, node, variableValues, fragmentVariableValues, hi
     }
     return coercedValues;
 }
-// eslint-disable-next-line max-params
 function coerceArgument(coercedValues, node, argName, argDef, argumentNode, variableValues, fragmentVariableValues, hideSuggestions) {
     const argType = argDef.type;
     const onArgDefaultValueError = (error, path) => {
@@ -154,19 +136,12 @@ function coerceArgument(coercedValues, node, argName, argDef, argumentNode, vari
     };
     if (!argumentNode) {
         if ((0, definition_ts_1.isRequiredArgument)(argDef)) {
-            // Note: ProvidedRequiredArgumentsRule validation should catch this before
-            // execution. This is a runtime check to ensure execution does not
-            // continue with an invalid argument value.
-            throw new GraphQLError_ts_1.GraphQLError(
-            // TODO: clean up the naming of isRequiredArgument(), isArgument(), and argDef if/when experimental fragment variables are merged
-            `${printArgumentOrFragmentVariable(argDef, node)} of required type "${argType}" was not provided.`, { nodes: node });
+            throw new GraphQLError_ts_1.GraphQLError(`${printArgumentOrFragmentVariable(argDef, node)} of required type "${argType}" was not provided.`, { nodes: node });
         }
         maybeUseDefaultValue(coercedValues, argName, argDef, onArgDefaultValueError, hideSuggestions);
         return;
     }
     const valueNode = argumentNode.value;
-    // Variables without a value are treated as if no argument was provided if
-    // the argument is not required.
     if (valueNode.kind === kinds_ts_1.Kind.VARIABLE) {
         const variableName = valueNode.name.value;
         const scopedVariableValues = fragmentVariableValues?.sources[variableName]
@@ -181,35 +156,19 @@ function coerceArgument(coercedValues, node, argName, argDef, argumentNode, vari
     }
     const coercedValue = (0, coerceInputValue_ts_1.coerceInputLiteral)(valueNode, argType, variableValues, fragmentVariableValues);
     if (coercedValue === undefined) {
-        // Note: ValuesOfCorrectTypeRule validation should catch this before
-        // execution. This is a runtime check to ensure execution does not
-        // continue with an invalid argument value.
         (0, validateInputValue_ts_1.validateInputLiteral)(valueNode, argType, (error, path) => {
-            // TODO: clean up the naming of isRequiredArgument(), isArgument(), and argDef if/when experimental fragment variables are merged
             error.message = `${printArgumentOrFragmentVariable(argDef, node)} has invalid value${(0, printPathArray_ts_1.printPathArray)(path)}: ${error.message}`;
             throw error;
         }, variableValues, fragmentVariableValues, hideSuggestions);
-        /* node:coverage ignore next */
         (0, invariant_ts_1.invariant)(false, 'Invalid argument');
     }
     coercedValues[argName] = coercedValue;
 }
-// TODO: clean up the naming of isRequiredArgument(), isArgument(), and argDef if/when experimental fragment variables are merged
 function printArgumentOrFragmentVariable(argDef, node) {
     return (0, definition_ts_1.isArgument)(argDef)
         ? `Argument "${argDef}"`
         : `Variable "$${argDef.name}" defined by fragment "${node.name.value}"`;
 }
-/**
- * Prepares an object map of argument values given a directive definition
- * and a AST node which may contain directives. Optionally also accepts a map
- * of variable values.
- *
- * If the directive does not exist on the node, returns undefined.
- *
- * Note: The returned value uses a null prototype to avoid collisions with
- * JavaScript's own property names.
- */
 function getDirectiveValues(directiveDef, node, variableValues, fragmentVariableValues, hideSuggestions) {
     const directiveNode = node.directives?.find((directive) => directive.name.value === directiveDef.name);
     if (directiveNode) {

package/execution/values.js.map

@@ -1 +1 @@
-{"version":3,"file":"values.js","sourceRoot":"","sources":["../../src/execution/values.ts"],"names":[],"mappings":"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","sourcesContent":["import { invariant } from '../jsutils/invariant.ts';\nimport type { Maybe } from '../jsutils/Maybe.ts';\nimport type { ObjMap, ReadOnlyObjMap } from '../jsutils/ObjMap.ts';\nimport { printPathArray } from '../jsutils/printPathArray.ts';\n\nimport { ensureGraphQLError } from '../error/ensureGraphQLError.ts';\nimport { GraphQLError } from '../error/GraphQLError.ts';\n\nimport type {\n  ArgumentNode,\n  DirectiveNode,\n  FieldNode,\n  FragmentArgumentNode,\n  FragmentSpreadNode,\n  VariableDefinitionNode,\n} from '../language/ast.ts';\nimport { Kind } from '../language/kinds.ts';\n\nimport type { GraphQLArgument, GraphQLField } from '../type/definition.ts';\nimport {\n  isArgument,\n  isNonNullType,\n  isRequiredArgument,\n} from '../type/definition.ts';\nimport type { GraphQLDirective } from '../type/directives.ts';\nimport type { GraphQLSchema } from '../type/schema.ts';\nimport { validateDefaultInput } from '../type/validate.ts';\n\nimport {\n  coerceDefaultValue,\n  coerceInputLiteral,\n  coerceInputValue,\n} from '../utilities/coerceInputValue.ts';\nimport {\n  validateInputLiteral,\n  validateInputValue,\n} from '../utilities/validateInputValue.ts';\n\nimport type { FragmentVariableValues } from './collectFields.ts';\nimport type { GraphQLVariableSignature } from './getVariableSignature.ts';\nimport { getVariableSignature } from './getVariableSignature.ts';\n\nexport interface VariableValues {\n  readonly sources: ReadOnlyObjMap<VariableValueSource>;\n  readonly coerced: ReadOnlyObjMap<unknown>;\n}\n\ninterface VariableValueSource {\n  readonly signature: GraphQLVariableSignature;\n  readonly value?: unknown;\n}\n\ntype VariableValuesOrErrors =\n  | { variableValues: VariableValues; errors?: never }\n  | { errors: ReadonlyArray<GraphQLError>; variableValues?: never };\n\n/**\n * Prepares an object map of variableValues of the correct type based on the\n * provided variable definitions and arbitrary input. If the input cannot be\n * parsed to match the variable definitions, a GraphQLError will be thrown.\n *\n * Note: The `coerced` and `sources` properties of VariableValues use null\n * prototype to avoid collisions with JavaScript's own property names.\n */\nexport function getVariableValues(\n  schema: GraphQLSchema,\n  varDefNodes: ReadonlyArray<VariableDefinitionNode>,\n  inputs: { readonly [variable: string]: unknown },\n  options?: { maxErrors?: number; hideSuggestions?: boolean },\n): VariableValuesOrErrors {\n  const errors: Array<GraphQLError> = [];\n  const maxErrors = options?.maxErrors;\n  try {\n    const variableValues = coerceVariableValues(\n      schema,\n      varDefNodes,\n      inputs,\n      (error) => {\n        if (maxErrors != null && errors.length >= maxErrors) {\n          throw new GraphQLError(\n            'Too many errors processing variables, error limit reached. Execution aborted.',\n          );\n        }\n        errors.push(error);\n      },\n      options?.hideSuggestions,\n    );\n\n    if (errors.length === 0) {\n      return { variableValues };\n    }\n  } catch (error) {\n    errors.push(ensureGraphQLError(error));\n  }\n\n  return { errors };\n}\n\nfunction coerceVariableValues(\n  schema: GraphQLSchema,\n  varDefNodes: ReadonlyArray<VariableDefinitionNode>,\n  inputs: { readonly [variable: string]: unknown },\n  onError: (error: GraphQLError) => void,\n  hideSuggestions?: Maybe<boolean>,\n): VariableValues {\n  const sources: ObjMap<VariableValueSource> = Object.create(null);\n  const coerced: ObjMap<unknown> = Object.create(null);\n  for (const varDefNode of varDefNodes) {\n    const varSignature = getVariableSignature(schema, varDefNode);\n\n    if (varSignature instanceof GraphQLError) {\n      onError(varSignature);\n      continue;\n    }\n\n    const { name: varName, type: varType } = varSignature;\n    const value = Object.hasOwn(inputs, varName) ? inputs[varName] : undefined;\n    if (value === undefined) {\n      sources[varName] = { signature: varSignature };\n      if (varDefNode.defaultValue) {\n        maybeUseDefaultValue(\n          coerced,\n          varName,\n          varSignature,\n          (error, path) => {\n            onError(\n              new GraphQLError(\n                `Variable \"$${varName}\" has invalid default value${printPathArray(path)}: ${error.message}`,\n                { nodes: varDefNode },\n              ),\n            );\n          },\n          hideSuggestions,\n        );\n        continue;\n      } else if (!isNonNullType(varType)) {\n        // Non-provided values for nullable variables are omitted.\n        continue;\n      }\n    } else {\n      sources[varName] = { signature: varSignature, value };\n    }\n\n    const coercedValue = coerceInputValue(value, varType);\n    if (coercedValue !== undefined) {\n      coerced[varName] = coercedValue;\n    } else {\n      validateInputValue(\n        value,\n        varType,\n        (error, path) => {\n          onError(\n            new GraphQLError(\n              `Variable \"$${varName}\" has invalid value${printPathArray(path)}: ${\n                error.message\n              }`,\n              { nodes: varDefNode, originalError: error },\n            ),\n          );\n        },\n        hideSuggestions,\n      );\n    }\n  }\n\n  return { sources, coerced };\n}\n\nfunction maybeUseDefaultValue(\n  coercedValues: ObjMap<unknown>,\n  name: string,\n  inputValue: GraphQLArgument | GraphQLVariableSignature,\n  onError: (error: GraphQLError, path: ReadonlyArray<string | number>) => void,\n  hideSuggestions?: Maybe<boolean>,\n): void {\n  try {\n    // coerceDefaultValue assumes validation has already rejected invalid\n    // defaults. If validation was skipped, invalid defaults or nested input\n    // field defaults can throw here; recover with validation-style errors below.\n    const coercedDefaultValue = coerceDefaultValue(inputValue);\n    if (coercedDefaultValue !== undefined) {\n      coercedValues[name] = coercedDefaultValue;\n    }\n  } catch (error) {\n    const defaultInput = inputValue.default;\n    // Defensive: coerceDefaultValue should only throw while coercing a default.\n    /* node:coverage ignore next 3 */\n    if (defaultInput === undefined) {\n      throw error;\n    }\n\n    // Prefer validation's user-facing errors for invalid defaults.\n    let reportedValidationError = false;\n    validateDefaultInput(\n      defaultInput,\n      inputValue.type,\n      (defaultError, path) => {\n        reportedValidationError = true;\n        onError(defaultError, path);\n      },\n      hideSuggestions,\n    );\n\n    if (!reportedValidationError) {\n      // The default itself validated, so coercion failed while applying a nested\n      // input field default. Surface the original coercion error.\n      onError(ensureGraphQLError(error), []);\n    }\n  }\n}\n\nexport function getFragmentVariableValues(\n  fragmentSpreadNode: FragmentSpreadNode,\n  fragmentSignatures: ReadOnlyObjMap<GraphQLVariableSignature>,\n  variableValues: VariableValues,\n  fragmentVariableValues?: Maybe<FragmentVariableValues>,\n  hideSuggestions?: Maybe<boolean>,\n): FragmentVariableValues {\n  const argumentNodes = fragmentSpreadNode.arguments ?? [];\n  const argNodeMap = new Map(argumentNodes.map((arg) => [arg.name.value, arg]));\n  const sources = Object.create(null);\n  const coerced = Object.create(null);\n  for (const [varName, varSignature] of Object.entries(fragmentSignatures)) {\n    sources[varName] = {\n      signature: varSignature,\n    };\n    const argumentNode = argNodeMap.get(varName);\n    if (argumentNode !== undefined) {\n      const source = sources[varName];\n      source.value = argumentNode.value;\n      source.fragmentVariableValues = fragmentVariableValues;\n    }\n\n    coerceArgument(\n      coerced,\n      fragmentSpreadNode,\n      varName,\n      varSignature,\n      argumentNode,\n      variableValues,\n      fragmentVariableValues,\n      hideSuggestions,\n    );\n  }\n\n  return { sources, coerced };\n}\n\n/**\n * Prepares an object map of argument values given a list of argument\n * definitions and list of argument AST nodes.\n *\n * Note: The returned value uses a null prototype to avoid collisions with\n * JavaScript's own property names.\n */\nexport function getArgumentValues(\n  def: GraphQLField<unknown, unknown> | GraphQLDirective,\n  node: FieldNode | DirectiveNode,\n  variableValues?: Maybe<VariableValues>,\n  fragmentVariableValues?: Maybe<FragmentVariableValues>,\n  hideSuggestions?: Maybe<boolean>,\n): ObjMap<unknown> {\n  const coercedValues: ObjMap<unknown> = Object.create(null);\n\n  const argumentNodes = node.arguments ?? [];\n  const argNodeMap = new Map(argumentNodes.map((arg) => [arg.name.value, arg]));\n\n  for (const argDef of def.args) {\n    const name = argDef.name;\n    coerceArgument(\n      coercedValues,\n      node,\n      name,\n      argDef,\n      argNodeMap.get(argDef.name),\n      variableValues,\n      fragmentVariableValues,\n      hideSuggestions,\n    );\n  }\n  return coercedValues;\n}\n\n// eslint-disable-next-line max-params\nfunction coerceArgument(\n  coercedValues: ObjMap<unknown>,\n  node: FieldNode | DirectiveNode | FragmentSpreadNode,\n  argName: string,\n  argDef: GraphQLArgument | GraphQLVariableSignature,\n  argumentNode: ArgumentNode | FragmentArgumentNode | undefined,\n  variableValues: Maybe<VariableValues>,\n  fragmentVariableValues: Maybe<FragmentVariableValues>,\n  hideSuggestions?: Maybe<boolean>,\n): void {\n  const argType = argDef.type;\n  const onArgDefaultValueError = (\n    error: GraphQLError,\n    path: ReadonlyArray<string | number>,\n  ): never => {\n    throw new GraphQLError(\n      `${printArgumentOrFragmentVariable(argDef, node)} has invalid default value${printPathArray(path)}: ${error.message}`,\n      { nodes: node },\n    );\n  };\n\n  if (!argumentNode) {\n    if (isRequiredArgument(argDef)) {\n      // Note: ProvidedRequiredArgumentsRule validation should catch this before\n      // execution. This is a runtime check to ensure execution does not\n      // continue with an invalid argument value.\n      throw new GraphQLError(\n        // TODO: clean up the naming of isRequiredArgument(), isArgument(), and argDef if/when experimental fragment variables are merged\n        `${printArgumentOrFragmentVariable(argDef, node)} of required type \"${argType}\" was not provided.`,\n        { nodes: node },\n      );\n    }\n    maybeUseDefaultValue(\n      coercedValues,\n      argName,\n      argDef,\n      onArgDefaultValueError,\n      hideSuggestions,\n    );\n    return;\n  }\n\n  const valueNode = argumentNode.value;\n\n  // Variables without a value are treated as if no argument was provided if\n  // the argument is not required.\n  if (valueNode.kind === Kind.VARIABLE) {\n    const variableName = valueNode.name.value;\n    const scopedVariableValues = fragmentVariableValues?.sources[variableName]\n      ? fragmentVariableValues\n      : variableValues;\n    if (\n      (scopedVariableValues == null ||\n        !Object.hasOwn(scopedVariableValues.coerced, variableName)) &&\n      !isRequiredArgument(argDef)\n    ) {\n      maybeUseDefaultValue(\n        coercedValues,\n        argName,\n        argDef,\n        onArgDefaultValueError,\n        hideSuggestions,\n      );\n      return;\n    }\n  }\n  const coercedValue = coerceInputLiteral(\n    valueNode,\n    argType,\n    variableValues,\n    fragmentVariableValues,\n  );\n  if (coercedValue === undefined) {\n    // Note: ValuesOfCorrectTypeRule validation should catch this before\n    // execution. This is a runtime check to ensure execution does not\n    // continue with an invalid argument value.\n    validateInputLiteral(\n      valueNode,\n      argType,\n      (error, path) => {\n        // TODO: clean up the naming of isRequiredArgument(), isArgument(), and argDef if/when experimental fragment variables are merged\n        error.message = `${printArgumentOrFragmentVariable(argDef, node)} has invalid value${printPathArray(\n          path,\n        )}: ${error.message}`;\n        throw error;\n      },\n      variableValues,\n      fragmentVariableValues,\n      hideSuggestions,\n    );\n    /* node:coverage ignore next */\n    invariant(false, 'Invalid argument');\n  }\n  coercedValues[argName] = coercedValue;\n}\n\n// TODO: clean up the naming of isRequiredArgument(), isArgument(), and argDef if/when experimental fragment variables are merged\nfunction printArgumentOrFragmentVariable(\n  argDef: GraphQLArgument | GraphQLVariableSignature,\n  node: FieldNode | DirectiveNode | FragmentSpreadNode,\n): string {\n  return isArgument(argDef)\n    ? `Argument \"${argDef}\"`\n    : `Variable \"$${argDef.name}\" defined by fragment \"${node.name.value}\"`;\n}\n\n/**\n * Prepares an object map of argument values given a directive definition\n * and a AST node which may contain directives. Optionally also accepts a map\n * of variable values.\n *\n * If the directive does not exist on the node, returns undefined.\n *\n * Note: The returned value uses a null prototype to avoid collisions with\n * JavaScript's own property names.\n */\nexport function getDirectiveValues(\n  directiveDef: GraphQLDirective,\n  node: { readonly directives?: ReadonlyArray<DirectiveNode> | undefined },\n  variableValues?: Maybe<VariableValues>,\n  fragmentVariableValues?: Maybe<FragmentVariableValues>,\n  hideSuggestions?: Maybe<boolean>,\n): undefined | ObjMap<unknown> {\n  const directiveNode = node.directives?.find(\n    (directive) => directive.name.value === directiveDef.name,\n  );\n\n  if (directiveNode) {\n    return getArgumentValues(\n      directiveDef,\n      directiveNode,\n      variableValues,\n      fragmentVariableValues,\n      hideSuggestions,\n    );\n  }\n}\n"]}
+{"version":3,"file":"values.js","sourceRoot":"","sources":["../../src/execution/values.ts"],"names":[],"mappings":"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","sourcesContent":["/** @category Values */\n\nimport { invariant } from '../jsutils/invariant.ts';\nimport type { Maybe } from '../jsutils/Maybe.ts';\nimport type { ObjMap, ReadOnlyObjMap } from '../jsutils/ObjMap.ts';\nimport { printPathArray } from '../jsutils/printPathArray.ts';\n\nimport { ensureGraphQLError } from '../error/ensureGraphQLError.ts';\nimport { GraphQLError } from '../error/GraphQLError.ts';\n\nimport type {\n  ArgumentNode,\n  DirectiveNode,\n  FieldNode,\n  FragmentArgumentNode,\n  FragmentSpreadNode,\n  VariableDefinitionNode,\n} from '../language/ast.ts';\nimport { Kind } from '../language/kinds.ts';\n\nimport type { GraphQLArgument, GraphQLField } from '../type/definition.ts';\nimport {\n  isArgument,\n  isNonNullType,\n  isRequiredArgument,\n} from '../type/definition.ts';\nimport type { GraphQLDirective } from '../type/directives.ts';\nimport type { GraphQLSchema } from '../type/schema.ts';\nimport { validateDefaultInput } from '../type/validate.ts';\n\nimport {\n  coerceDefaultValue,\n  coerceInputLiteral,\n  coerceInputValue,\n} from '../utilities/coerceInputValue.ts';\nimport {\n  validateInputLiteral,\n  validateInputValue,\n} from '../utilities/validateInputValue.ts';\n\nimport type {\n  FragmentVariableValues,\n  FragmentVariableValueSource,\n} from './collectFields.ts';\nimport type { GraphQLVariableSignature } from './getVariableSignature.ts';\nimport { getVariableSignature } from './getVariableSignature.ts';\n\n/**\n * Coerced variable values prepared for execution.\n *\n * The `coerced` map contains runtime values keyed by variable name. The\n * `sources` map records whether each value came from request input, an operation\n * default, or a fragment-variable default so utilities can preserve defaults\n * when replacing variables in literals.\n */\nexport interface VariableValues {\n  /** Source metadata for each variable value keyed by variable name. */\n  readonly sources: ReadOnlyObjMap<VariableValueSource>;\n  /** Coerced runtime variable values keyed by variable name. */\n  readonly coerced: ReadOnlyObjMap<unknown>;\n}\n\ninterface VariableValueSource {\n  readonly signature: GraphQLVariableSignature;\n  readonly value?: unknown;\n}\n\ntype VariableValuesOrErrors =\n  | { variableValues: VariableValues; errors?: never }\n  | { errors: ReadonlyArray<GraphQLError>; variableValues?: never };\n\n/**\n * Prepares an object map of variableValues of the correct type based on the\n * provided variable definitions and arbitrary input. If the input cannot be\n * parsed to match the variable definitions, GraphQLError values are returned.\n *\n * Note: Returned maps use null prototypes to avoid collisions with\n * Object prototype properties.\n * @param schema - GraphQL schema to use.\n * @param varDefNodes - The variable definition AST nodes to coerce.\n * @param inputs - The runtime variable values keyed by variable name.\n * @param options - Optional configuration for this operation.\n * @param [options.maxErrors] - Maximum number of coercion errors to report.\n * @param [options.hideSuggestions] - Whether suggestion text should be omitted\n * from errors.\n * @returns Coerced variable values with source metadata, or request errors.\n * @example\n * ```ts\n * // Coerce provided variables and apply operation defaults.\n * import assert from 'node:assert';\n * import { parse } from 'graphql/language';\n * import { buildSchema } from 'graphql/utilities';\n * import { getVariableValues } from 'graphql/execution';\n *\n * const schema = buildSchema(`\n *   type Query {\n *     reviews(stars: Int!, limit: Int = 10): [String]\n *   }\n * `);\n * const document = parse(`\n *   query ($stars: Int!, $limit: Int = 10) {\n *     reviews(stars: $stars, limit: $limit)\n *   }\n * `);\n * const operation = document.definitions[0];\n *\n * const result = getVariableValues(\n *   schema,\n *   operation.variableDefinitions,\n *   { stars: '5' },\n * );\n *\n * assert('variableValues' in result);\n *\n * result.variableValues.coerced; // => { stars: 5, limit: 10 }\n * ```\n * @example\n * ```ts\n * // This variant uses maxErrors to cap reported coercion errors.\n * import assert from 'node:assert';\n * import { parse } from 'graphql/language';\n * import { buildSchema } from 'graphql/utilities';\n * import { getVariableValues } from 'graphql/execution';\n *\n * const schema = buildSchema(`\n *   input ReviewInput {\n *     stars: Int!\n *   }\n *\n *   type Query {\n *     review(input: ReviewInput!): String\n *   }\n * `);\n * const document = parse(`\n *   query ($first: ReviewInput!, $second: ReviewInput!) {\n *     first: review(input: $first)\n *     second: review(input: $second)\n *   }\n * `);\n * const operation = document.definitions[0];\n *\n * const result = getVariableValues(\n *   schema,\n *   operation.variableDefinitions,\n *   { first: { stars: 'bad' }, second: { stars: 'also bad' } },\n *   { maxErrors: 1 },\n * );\n *\n * assert('errors' in result);\n *\n * result.errors.length; // => 2\n * result.errors[1].message; // matches /error limit reached/\n * ```\n */\nexport function getVariableValues(\n  schema: GraphQLSchema,\n  varDefNodes: ReadonlyArray<VariableDefinitionNode>,\n  inputs: { readonly [variable: string]: unknown },\n  options?: { maxErrors?: number; hideSuggestions?: boolean },\n): VariableValuesOrErrors {\n  const errors: Array<GraphQLError> = [];\n  const maxErrors = options?.maxErrors;\n  try {\n    const variableValues = coerceVariableValues(\n      schema,\n      varDefNodes,\n      inputs,\n      (error) => {\n        if (maxErrors != null && errors.length >= maxErrors) {\n          throw new GraphQLError(\n            'Too many errors processing variables, error limit reached. Execution aborted.',\n          );\n        }\n        errors.push(error);\n      },\n      options?.hideSuggestions,\n    );\n\n    if (errors.length === 0) {\n      return { variableValues };\n    }\n  } catch (error) {\n    errors.push(ensureGraphQLError(error));\n  }\n\n  return { errors };\n}\n\nfunction coerceVariableValues(\n  schema: GraphQLSchema,\n  varDefNodes: ReadonlyArray<VariableDefinitionNode>,\n  inputs: { readonly [variable: string]: unknown },\n  onError: (error: GraphQLError) => void,\n  hideSuggestions?: Maybe<boolean>,\n): VariableValues {\n  const sources: ObjMap<VariableValueSource> = Object.create(null);\n  const coerced: ObjMap<unknown> = Object.create(null);\n  for (const varDefNode of varDefNodes) {\n    const varSignature = getVariableSignature(schema, varDefNode);\n\n    if (varSignature instanceof GraphQLError) {\n      onError(varSignature);\n      continue;\n    }\n\n    const { name: varName, type: varType } = varSignature;\n    const value = Object.hasOwn(inputs, varName) ? inputs[varName] : undefined;\n    if (value === undefined) {\n      sources[varName] = { signature: varSignature };\n      if (varDefNode.defaultValue) {\n        maybeUseDefaultValue(\n          coerced,\n          varName,\n          varSignature,\n          (error, path) => {\n            onError(\n              new GraphQLError(\n                `Variable \"$${varName}\" has invalid default value${printPathArray(path)}: ${error.message}`,\n                { nodes: varDefNode },\n              ),\n            );\n          },\n          hideSuggestions,\n        );\n        continue;\n      } else if (!isNonNullType(varType)) {\n        // Non-provided values for nullable variables are omitted.\n        continue;\n      }\n    } else {\n      sources[varName] = { signature: varSignature, value };\n    }\n\n    const coercedValue = coerceInputValue(value, varType);\n    if (coercedValue !== undefined) {\n      coerced[varName] = coercedValue;\n    } else {\n      validateInputValue(\n        value,\n        varType,\n        (error, path) => {\n          onError(\n            new GraphQLError(\n              `Variable \"$${varName}\" has invalid value${printPathArray(path)}: ${\n                error.message\n              }`,\n              { nodes: varDefNode, originalError: error },\n            ),\n          );\n        },\n        hideSuggestions,\n      );\n    }\n  }\n\n  return { sources, coerced };\n}\n\nfunction maybeUseDefaultValue(\n  coercedValues: ObjMap<unknown>,\n  name: string,\n  inputValue: GraphQLArgument | GraphQLVariableSignature,\n  onError: (error: GraphQLError, path: ReadonlyArray<string | number>) => void,\n  hideSuggestions?: Maybe<boolean>,\n): void {\n  try {\n    // coerceDefaultValue assumes validation has already rejected invalid\n    // defaults. If validation was skipped, invalid defaults or nested input\n    // field defaults can throw here; recover with validation-style errors below.\n    const coercedDefaultValue = coerceDefaultValue(inputValue);\n    if (coercedDefaultValue !== undefined) {\n      coercedValues[name] = coercedDefaultValue;\n    }\n  } catch (error) {\n    const defaultInput = inputValue.default;\n    // Defensive: coerceDefaultValue should only throw while coercing a default.\n    /* node:coverage ignore next 3 */\n    if (defaultInput === undefined) {\n      throw error;\n    }\n\n    // Prefer validation's user-facing errors for invalid defaults.\n    let reportedValidationError = false;\n    validateDefaultInput(\n      defaultInput,\n      inputValue.type,\n      (defaultError, path) => {\n        reportedValidationError = true;\n        onError(defaultError, path);\n      },\n      hideSuggestions,\n    );\n\n    if (!reportedValidationError) {\n      // The default itself validated, so coercion failed while applying a nested\n      // input field default. Surface the original coercion error.\n      onError(ensureGraphQLError(error), []);\n    }\n  }\n}\n\n/** @internal */\nexport function getFragmentVariableValues(\n  fragmentSpreadNode: FragmentSpreadNode,\n  fragmentSignatures: ReadOnlyObjMap<GraphQLVariableSignature>,\n  variableValues: VariableValues,\n  fragmentVariableValues?: Maybe<FragmentVariableValues>,\n  hideSuggestions?: Maybe<boolean>,\n): FragmentVariableValues {\n  const argumentNodes = fragmentSpreadNode.arguments ?? [];\n  const argNodeMap = new Map(argumentNodes.map((arg) => [arg.name.value, arg]));\n  const sources: ObjMap<FragmentVariableValueSource> = Object.create(null);\n  const coerced: ObjMap<unknown> = Object.create(null);\n  for (const [varName, varSignature] of Object.entries(fragmentSignatures)) {\n    const argumentNode = argNodeMap.get(varName);\n    if (argumentNode !== undefined) {\n      sources[varName] =\n        fragmentVariableValues == null\n          ? { signature: varSignature, value: argumentNode.value }\n          : {\n              signature: varSignature,\n              value: argumentNode.value,\n              fragmentVariableValues,\n            };\n    } else {\n      sources[varName] = {\n        signature: varSignature,\n      };\n    }\n\n    coerceArgument(\n      coerced,\n      fragmentSpreadNode,\n      varName,\n      varSignature,\n      argumentNode,\n      variableValues,\n      fragmentVariableValues,\n      hideSuggestions,\n    );\n  }\n\n  return { sources, coerced };\n}\n\n/**\n * Prepares an object map of argument values given a list of argument\n * definitions and list of argument AST nodes.\n *\n * Note: Returned value uses a null prototype to avoid collisions with\n * JavaScript's own property names.\n * @param def - Field or directive definition that declares the arguments.\n * @param node - Field or directive AST node supplying argument literals.\n * @param variableValues - Operation variable values returned by getVariableValues.\n * @param fragmentVariableValues - Fragment variable values for the current fragment scope.\n * @param hideSuggestions - Whether suggestion text should be omitted from errors.\n * @returns A map of coerced argument values.\n * @example\n * ```ts\n * // Read literal argument values and defaults.\n * import { parse } from 'graphql/language';\n * import { buildSchema } from 'graphql/utilities';\n * import { getArgumentValues } from 'graphql/execution';\n *\n * const schema = buildSchema(`\n *   type Query {\n *     reviews(stars: Int!, limit: Int = 10): [String]\n *   }\n * `);\n * const fieldDef = schema.getQueryType().getFields().reviews;\n * const document = parse('{ reviews(stars: 5) }');\n * const fieldNode = document.definitions[0].selectionSet.selections[0];\n *\n * getArgumentValues(fieldDef, fieldNode); // => { stars: 5, limit: 10 }\n * ```\n * @example\n * ```ts\n * // This variant resolves argument values from operation variables.\n * import assert from 'node:assert';\n * import { parse } from 'graphql/language';\n * import { buildSchema } from 'graphql/utilities';\n * import { getArgumentValues, getVariableValues } from 'graphql/execution';\n *\n * const schema = buildSchema(`\n *   type Query {\n *     reviews(stars: Int!): [String]\n *   }\n * `);\n * const fieldDef = schema.getQueryType().getFields().reviews;\n * const document = parse('query ($stars: Int!) { reviews(stars: $stars) }');\n * const operation = document.definitions[0];\n * const fieldNode = document.definitions[0].selectionSet.selections[0];\n * const variables = getVariableValues(\n *   schema,\n *   operation.variableDefinitions,\n *   { stars: '5' },\n * );\n *\n * assert('variableValues' in variables);\n *\n * getArgumentValues(fieldDef, fieldNode, variables.variableValues); // => { stars: 5 }\n * getArgumentValues(fieldDef, fieldNode); // throws an error\n * ```\n */\nexport function getArgumentValues(\n  def: GraphQLField<unknown, unknown> | GraphQLDirective,\n  node: FieldNode | DirectiveNode,\n  variableValues?: Maybe<VariableValues>,\n  fragmentVariableValues?: Maybe<FragmentVariableValues>,\n  hideSuggestions?: Maybe<boolean>,\n): ObjMap<unknown> {\n  const coercedValues: ObjMap<unknown> = Object.create(null);\n\n  const argumentNodes = node.arguments ?? [];\n  const argNodeMap = new Map(argumentNodes.map((arg) => [arg.name.value, arg]));\n\n  for (const argDef of def.args) {\n    const name = argDef.name;\n    coerceArgument(\n      coercedValues,\n      node,\n      name,\n      argDef,\n      argNodeMap.get(argDef.name),\n      variableValues,\n      fragmentVariableValues,\n      hideSuggestions,\n    );\n  }\n  return coercedValues;\n}\n\n/** @internal */\n// eslint-disable-next-line max-params\nfunction coerceArgument(\n  coercedValues: ObjMap<unknown>,\n  node: FieldNode | DirectiveNode | FragmentSpreadNode,\n  argName: string,\n  argDef: GraphQLArgument | GraphQLVariableSignature,\n  argumentNode: ArgumentNode | FragmentArgumentNode | undefined,\n  variableValues: Maybe<VariableValues>,\n  fragmentVariableValues: Maybe<FragmentVariableValues>,\n  hideSuggestions?: Maybe<boolean>,\n): void {\n  const argType = argDef.type;\n  const onArgDefaultValueError = (\n    error: GraphQLError,\n    path: ReadonlyArray<string | number>,\n  ): never => {\n    throw new GraphQLError(\n      `${printArgumentOrFragmentVariable(argDef, node)} has invalid default value${printPathArray(path)}: ${error.message}`,\n      { nodes: node },\n    );\n  };\n\n  if (!argumentNode) {\n    if (isRequiredArgument(argDef)) {\n      // Note: ProvidedRequiredArgumentsRule validation should catch this before\n      // execution. This is a runtime check to ensure execution does not\n      // continue with an invalid argument value.\n      throw new GraphQLError(\n        // TODO: clean up the naming of isRequiredArgument(), isArgument(), and argDef if/when experimental fragment variables are merged\n        `${printArgumentOrFragmentVariable(argDef, node)} of required type \"${argType}\" was not provided.`,\n        { nodes: node },\n      );\n    }\n    maybeUseDefaultValue(\n      coercedValues,\n      argName,\n      argDef,\n      onArgDefaultValueError,\n      hideSuggestions,\n    );\n    return;\n  }\n\n  const valueNode = argumentNode.value;\n\n  // Variables without a value are treated as if no argument was provided if\n  // the argument is not required.\n  if (valueNode.kind === Kind.VARIABLE) {\n    const variableName = valueNode.name.value;\n    const scopedVariableValues = fragmentVariableValues?.sources[variableName]\n      ? fragmentVariableValues\n      : variableValues;\n    if (\n      (scopedVariableValues == null ||\n        !Object.hasOwn(scopedVariableValues.coerced, variableName)) &&\n      !isRequiredArgument(argDef)\n    ) {\n      maybeUseDefaultValue(\n        coercedValues,\n        argName,\n        argDef,\n        onArgDefaultValueError,\n        hideSuggestions,\n      );\n      return;\n    }\n  }\n  const coercedValue = coerceInputLiteral(\n    valueNode,\n    argType,\n    variableValues,\n    fragmentVariableValues,\n  );\n  if (coercedValue === undefined) {\n    // Note: ValuesOfCorrectTypeRule validation should catch this before\n    // execution. This is a runtime check to ensure execution does not\n    // continue with an invalid argument value.\n    validateInputLiteral(\n      valueNode,\n      argType,\n      (error, path) => {\n        // TODO: clean up the naming of isRequiredArgument(), isArgument(), and argDef if/when experimental fragment variables are merged\n        error.message = `${printArgumentOrFragmentVariable(argDef, node)} has invalid value${printPathArray(\n          path,\n        )}: ${error.message}`;\n        throw error;\n      },\n      variableValues,\n      fragmentVariableValues,\n      hideSuggestions,\n    );\n    /* node:coverage ignore next */\n    invariant(false, 'Invalid argument');\n  }\n  coercedValues[argName] = coercedValue;\n}\n\n// TODO: clean up the naming of isRequiredArgument(), isArgument(), and argDef if/when experimental fragment variables are merged\nfunction printArgumentOrFragmentVariable(\n  argDef: GraphQLArgument | GraphQLVariableSignature,\n  node: FieldNode | DirectiveNode | FragmentSpreadNode,\n): string {\n  return isArgument(argDef)\n    ? `Argument \"${argDef}\"`\n    : `Variable \"$${argDef.name}\" defined by fragment \"${node.name.value}\"`;\n}\n\n/**\n * Prepares an object map of argument values given a directive definition\n * and a AST node which may contain directives. Optionally also accepts a map\n * of variable values.\n *\n * If the directive does not exist on the node, returns undefined.\n *\n * Note: Returned value uses a null prototype to avoid collisions with\n * JavaScript's own property names.\n * @param directiveDef - Directive definition to read argument definitions from.\n * @param node - AST node that may contain directives.\n * @param node.directives - The directives on the AST node.\n * @param variableValues - Operation variable values returned by getVariableValues.\n * @param fragmentVariableValues - Fragment variable values for the current fragment scope.\n * @param hideSuggestions - Whether suggestion text should be omitted from errors.\n * @returns A map of coerced directive argument values, or undefined when absent.\n * @example\n * ```ts\n * // Read literal directive arguments from a node.\n * import { parse } from 'graphql/language';\n * import { GraphQLSkipDirective } from 'graphql/type';\n * import { getDirectiveValues } from 'graphql/execution';\n *\n * const document = parse('{ name @skip(if: true) }');\n * const fieldNode = document.definitions[0].selectionSet.selections[0];\n *\n * getDirectiveValues(GraphQLSkipDirective, fieldNode); // => { if: true }\n * ```\n * @example\n * ```ts\n * // This variant resolves directive arguments from variables and handles absent directives.\n * import assert from 'node:assert';\n * import { parse } from 'graphql/language';\n * import { GraphQLIncludeDirective } from 'graphql/type';\n * import { buildSchema } from 'graphql/utilities';\n * import { getDirectiveValues, getVariableValues } from 'graphql/execution';\n *\n * const schema = buildSchema('type Query { name: String }');\n * const document = parse('query ($includeName: Boolean!) { name @include(if: $includeName) }');\n * const operation = document.definitions[0];\n * const fieldNode = document.definitions[0].selectionSet.selections[0];\n * const variables = getVariableValues(\n *   schema,\n *   operation.variableDefinitions,\n *   { includeName: false },\n * );\n *\n * assert('variableValues' in variables);\n *\n * getDirectiveValues(GraphQLIncludeDirective, fieldNode, variables.variableValues); // => { if: false }\n * getDirectiveValues(GraphQLIncludeDirective, { directives: [] }); // => undefined\n * ```\n */\nexport function getDirectiveValues(\n  directiveDef: GraphQLDirective,\n  node: { readonly directives?: ReadonlyArray<DirectiveNode> | undefined },\n  variableValues?: Maybe<VariableValues>,\n  fragmentVariableValues?: Maybe<FragmentVariableValues>,\n  hideSuggestions?: Maybe<boolean>,\n): undefined | ObjMap<unknown> {\n  const directiveNode = node.directives?.find(\n    (directive) => directive.name.value === directiveDef.name,\n  );\n\n  if (directiveNode) {\n    return getArgumentValues(\n      directiveDef,\n      directiveNode,\n      variableValues,\n      fragmentVariableValues,\n      hideSuggestions,\n    );\n  }\n}\n"]}