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

package/utilities/coerceInputValue.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"coerceInputValue.js","sourceRoot":"","sources":["../../src/utilities/coerceInputValue.ts"],"names":[],"mappings":"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","sourcesContent":["import { inspect } from '../jsutils/inspect.ts';\nimport { invariant } from '../jsutils/invariant.ts';\nimport { isIterableObject } from '../jsutils/isIterableObject.ts';\nimport { isObjectLike } from '../jsutils/isObjectLike.ts';\nimport type { Maybe } from '../jsutils/Maybe.ts';\nimport type { ObjMap } from '../jsutils/ObjMap.ts';\n\nimport type { ValueNode, VariableNode } from '../language/ast.ts';\nimport { Kind } from '../language/kinds.ts';\n\nimport type {\n  GraphQLDefaultInput,\n  GraphQLInputType,\n} from '../type/definition.ts';\nimport {\n  assertLeafType,\n  isInputObjectType,\n  isListType,\n  isNonNullType,\n  isRequiredInputField,\n} from '../type/definition.ts';\n\nimport type { FragmentVariableValues } from '../execution/collectFields.ts';\nimport type { VariableValues } from '../execution/values.ts';\n\nimport { replaceVariables } from './replaceVariables.ts';\n\n/**\n * Coerces a JavaScript value given a GraphQL Input Type.\n *\n * Returns `undefined` when the value could not be validly coerced according to\n * the provided type.\n */\nexport function coerceInputValue(\n  inputValue: unknown,\n  type: GraphQLInputType,\n): unknown {\n  if (isNonNullType(type)) {\n    if (inputValue == null) {\n      return; // Invalid: intentionally return no value.\n    }\n    return coerceInputValue(inputValue, type.ofType);\n  }\n\n  if (inputValue == null) {\n    return null; // Explicitly return the value null.\n  }\n\n  if (isListType(type)) {\n    if (!isIterableObject(inputValue)) {\n      // Lists accept a non-list value as a list of one.\n      const coercedItem = coerceInputValue(inputValue, type.ofType);\n      if (coercedItem === undefined) {\n        return; // Invalid: intentionally return no value.\n      }\n      return [coercedItem];\n    }\n    const coercedValue = [];\n    for (const itemValue of inputValue) {\n      const coercedItem = coerceInputValue(itemValue, type.ofType);\n      if (coercedItem === undefined) {\n        return; // Invalid: intentionally return no value.\n      }\n      coercedValue.push(coercedItem);\n    }\n    return coercedValue;\n  }\n\n  if (isInputObjectType(type)) {\n    if (!isObjectLike(inputValue) || Array.isArray(inputValue)) {\n      return; // Invalid: intentionally return no value.\n    }\n\n    const coercedValue: ObjMap<unknown> = Object.create(null);\n    const fieldDefs = type.getFields();\n    let definedFieldCount = 0;\n    for (const fieldName of Object.keys(inputValue)) {\n      if (inputValue[fieldName] === undefined) {\n        continue;\n      }\n      definedFieldCount++;\n      if (!Object.hasOwn(fieldDefs, fieldName)) {\n        return; // Invalid: intentionally return no value.\n      }\n    }\n    for (const field of Object.values(fieldDefs)) {\n      const fieldValue = inputValue[field.name];\n      if (fieldValue === undefined) {\n        if (isRequiredInputField(field)) {\n          return; // Invalid: intentionally return no value.\n        }\n        const coercedDefaultValue = coerceDefaultValue(field);\n        if (coercedDefaultValue !== undefined) {\n          coercedValue[field.name] = coercedDefaultValue;\n        }\n      } else {\n        const coercedField = coerceInputValue(fieldValue, field.type);\n        if (coercedField === undefined) {\n          return; // Invalid: intentionally return no value.\n        }\n        coercedValue[field.name] = coercedField;\n      }\n    }\n\n    if (type.isOneOf) {\n      const keys = Object.keys(coercedValue);\n      if (definedFieldCount !== 1 || keys.length !== 1) {\n        return; // Invalid: intentionally return no value.\n      }\n\n      const key = keys[0];\n      const value = coercedValue[key];\n      if (value === null) {\n        return; // Invalid: intentionally return no value.\n      }\n    }\n\n    return coercedValue;\n  }\n\n  const leafType = assertLeafType(type);\n\n  try {\n    return leafType.coerceInputValue(inputValue);\n  } catch (_error) {\n    // Invalid: ignore error and intentionally return no value.\n  }\n}\n\n/**\n * Produces a coerced \"internal\" JavaScript value given a GraphQL Value AST.\n *\n * Returns `undefined` when the value could not be validly coerced according to\n * the provided type.\n */\nexport function coerceInputLiteral(\n  valueNode: ValueNode,\n  type: GraphQLInputType,\n  variableValues?: Maybe<VariableValues>,\n  fragmentVariableValues?: Maybe<FragmentVariableValues>,\n): unknown {\n  if (valueNode.kind === Kind.VARIABLE) {\n    const coercedVariableValue = getCoercedVariableValue(\n      valueNode,\n      variableValues,\n      fragmentVariableValues,\n    );\n    if (coercedVariableValue == null && isNonNullType(type)) {\n      return; // Invalid: intentionally return no value.\n    }\n    // Note: This does no further checking that this variable is correct.\n    // This assumes validated has checked this variable is of the correct type.\n    return coercedVariableValue;\n  }\n\n  if (isNonNullType(type)) {\n    if (valueNode.kind === Kind.NULL) {\n      return; // Invalid: intentionally return no value.\n    }\n    return coerceInputLiteral(\n      valueNode,\n      type.ofType,\n      variableValues,\n      fragmentVariableValues,\n    );\n  }\n\n  if (valueNode.kind === Kind.NULL) {\n    return null; // Explicitly return the value null.\n  }\n\n  if (isListType(type)) {\n    if (valueNode.kind !== Kind.LIST) {\n      // Lists accept a non-list value as a list of one.\n      const itemValue = coerceInputLiteral(\n        valueNode,\n        type.ofType,\n        variableValues,\n        fragmentVariableValues,\n      );\n      if (itemValue === undefined) {\n        return; // Invalid: intentionally return no value.\n      }\n      return [itemValue];\n    }\n    const coercedValue: Array<unknown> = [];\n    for (const itemNode of valueNode.values) {\n      let itemValue = coerceInputLiteral(\n        itemNode,\n        type.ofType,\n        variableValues,\n        fragmentVariableValues,\n      );\n      if (itemValue === undefined) {\n        if (\n          itemNode.kind === Kind.VARIABLE &&\n          getCoercedVariableValue(\n            itemNode,\n            variableValues,\n            fragmentVariableValues,\n          ) == null &&\n          !isNonNullType(type.ofType)\n        ) {\n          // A missing variable within a list is coerced to null.\n          itemValue = null;\n        } else {\n          return; // Invalid: intentionally return no value.\n        }\n      }\n      coercedValue.push(itemValue);\n    }\n    return coercedValue;\n  }\n\n  if (isInputObjectType(type)) {\n    if (valueNode.kind !== Kind.OBJECT) {\n      return; // Invalid: intentionally return no value.\n    }\n\n    const coercedValue: ObjMap<unknown> = Object.create(null);\n    const fieldDefs = type.getFields();\n    const hasUndefinedField = valueNode.fields.some(\n      (field) => !Object.hasOwn(fieldDefs, field.name.value),\n    );\n    if (hasUndefinedField) {\n      return; // Invalid: intentionally return no value.\n    }\n    const fieldNodes = new Map(\n      valueNode.fields.map((field) => [field.name.value, field]),\n    );\n    for (const field of Object.values(fieldDefs)) {\n      const fieldNode = fieldNodes.get(field.name);\n      if (\n        !fieldNode ||\n        (fieldNode.value.kind === Kind.VARIABLE &&\n          isMissingVariable(\n            fieldNode.value,\n            variableValues,\n            fragmentVariableValues,\n          ))\n      ) {\n        if (isRequiredInputField(field)) {\n          return; // Invalid: intentionally return no value.\n        }\n        const coercedDefaultValue = coerceDefaultValue(field);\n        if (coercedDefaultValue !== undefined) {\n          coercedValue[field.name] = coercedDefaultValue;\n        }\n      } else {\n        const fieldValue = coerceInputLiteral(\n          fieldNode.value,\n          field.type,\n          variableValues,\n          fragmentVariableValues,\n        );\n        if (fieldValue === undefined) {\n          return; // Invalid: intentionally return no value.\n        }\n        coercedValue[field.name] = fieldValue;\n      }\n    }\n\n    if (type.isOneOf) {\n      const coercedKeys = Object.keys(coercedValue);\n      if (fieldNodes.size !== 1 || coercedKeys.length !== 1) {\n        return; // Invalid: not exactly one key, intentionally return no value.\n      }\n\n      for (const [fieldName, fieldNode] of fieldNodes) {\n        if (\n          fieldNode.value.kind === Kind.NULL ||\n          coercedValue[fieldName] === null\n        ) {\n          return; // Invalid: value not non-null, intentionally return no value.\n        }\n      }\n    }\n\n    return coercedValue;\n  }\n\n  const leafType = assertLeafType(type);\n  try {\n    return leafType.coerceInputLiteral\n      ? leafType.coerceInputLiteral(\n          replaceVariables(valueNode, variableValues, fragmentVariableValues),\n        )\n      : leafType.parseLiteral(valueNode, variableValues?.coerced);\n  } catch (_error) {\n    // Invalid: ignore error and intentionally return no value.\n  }\n}\n\n// Retrieves the variable value for the given variable node.\nfunction getCoercedVariableValue(\n  variableNode: VariableNode,\n  variableValues: Maybe<VariableValues>,\n  fragmentVariableValues: Maybe<FragmentVariableValues>,\n): unknown {\n  const varName = variableNode.name.value;\n  if (fragmentVariableValues?.sources[varName] !== undefined) {\n    return fragmentVariableValues.coerced[varName];\n  }\n\n  return variableValues?.coerced[varName];\n}\n\nfunction isMissingVariable(\n  variableNode: VariableNode,\n  variableValues: Maybe<VariableValues>,\n  fragmentVariableValues: Maybe<FragmentVariableValues>,\n): boolean {\n  const varName = variableNode.name.value;\n  const scopedValues =\n    fragmentVariableValues?.sources[varName] !== undefined\n      ? fragmentVariableValues.coerced\n      : variableValues?.coerced;\n  return scopedValues?.[varName] === undefined;\n}\n\ninterface InputValue {\n  type: GraphQLInputType;\n  default?: GraphQLDefaultInput | undefined;\n  defaultValue?: unknown;\n}\n\n/**\n * Returns the coerced default value for an input value definition, if it exists.\n *\n * If the default value is invalid, this will throw an error. Invalid default\n * values should be caught during validation, however, so this function assumes\n * that the default value is valid.\n * @internal\n */\nexport function coerceDefaultValue(inputValue: InputValue): unknown {\n  // Memoize the result of coercing the default value in a hidden field.\n  let coercedDefaultValue = (inputValue as any)._memoizedCoercedDefaultValue;\n  if (coercedDefaultValue !== undefined) {\n    return coercedDefaultValue;\n  }\n\n  const defaultInput = inputValue.default;\n  if (defaultInput !== undefined) {\n    coercedDefaultValue = defaultInput.literal\n      ? coerceInputLiteral(defaultInput.literal, inputValue.type)\n      : coerceInputValue(defaultInput.value, inputValue.type);\n    invariant(\n      coercedDefaultValue !== undefined,\n      `Expected value of type \"${inputValue.type}\" to be valid, found: ${inspect(\n        defaultInput.literal ?? defaultInput.value,\n      )}.`,\n    );\n    (inputValue as any)._memoizedCoercedDefaultValue = coercedDefaultValue;\n    return coercedDefaultValue;\n  }\n\n  const defaultValue = inputValue.defaultValue;\n  if (defaultValue !== undefined) {\n    (inputValue as any)._memoizedCoercedDefaultValue = defaultValue;\n  }\n  return defaultValue;\n}\n"]}
+{"version":3,"file":"coerceInputValue.js","sourceRoot":"","sources":["../../src/utilities/coerceInputValue.ts"],"names":[],"mappings":"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","sourcesContent":["/** @category Values */\n\nimport { inspect } from '../jsutils/inspect.ts';\nimport { invariant } from '../jsutils/invariant.ts';\nimport { isIterableObject } from '../jsutils/isIterableObject.ts';\nimport { isObjectLike } from '../jsutils/isObjectLike.ts';\nimport type { Maybe } from '../jsutils/Maybe.ts';\nimport type { ObjMap } from '../jsutils/ObjMap.ts';\n\nimport type { ValueNode, VariableNode } from '../language/ast.ts';\nimport { Kind } from '../language/kinds.ts';\n\nimport type {\n  GraphQLDefaultInput,\n  GraphQLInputType,\n} from '../type/definition.ts';\nimport {\n  assertLeafType,\n  isInputObjectType,\n  isListType,\n  isNonNullType,\n  isRequiredInputField,\n} from '../type/definition.ts';\n\nimport type { FragmentVariableValues } from '../execution/collectFields.ts';\nimport type { VariableValues } from '../execution/values.ts';\n\nimport { replaceVariables } from './replaceVariables.ts';\n\n/**\n * Coerces a JavaScript value given a GraphQL Input Type.\n *\n * Returns `undefined` when the value could not be validly coerced according to\n * the provided type. Use `validateInputValue` when coercion diagnostics\n * are needed.\n * @param inputValue - JavaScript value to coerce.\n * @param type - GraphQL input type to coerce the value against.\n * @returns Coerced value, or undefined if coercion fails.\n * @example\n * ```ts\n * // Coerce runtime input values, returning undefined when coercion fails.\n * import {\n *   GraphQLInputObjectType,\n *   GraphQLInt,\n *   GraphQLList,\n *   GraphQLNonNull,\n *   GraphQLString,\n * } from 'graphql/type';\n * import { coerceInputValue } from 'graphql/utilities';\n *\n * const ReviewInput = new GraphQLInputObjectType({\n *   name: 'ReviewInput',\n *   fields: {\n *     stars: { type: new GraphQLNonNull(GraphQLInt) },\n *     tags: { type: new GraphQLList(GraphQLString) },\n *   },\n * });\n *\n * coerceInputValue({ stars: '5', tags: ['featured'] }, ReviewInput); // => { stars: 5, tags: ['featured'] }\n * coerceInputValue({ stars: 'bad' }, ReviewInput); // => undefined\n * ```\n */\nexport function coerceInputValue(\n  inputValue: unknown,\n  type: GraphQLInputType,\n): unknown {\n  if (isNonNullType(type)) {\n    if (inputValue == null) {\n      return; // Invalid: intentionally return no value.\n    }\n    return coerceInputValue(inputValue, type.ofType);\n  }\n\n  if (inputValue == null) {\n    return null; // Explicitly return the value null.\n  }\n\n  if (isListType(type)) {\n    if (!isIterableObject(inputValue)) {\n      // Lists accept a non-list value as a list of one.\n      const coercedItem = coerceInputValue(inputValue, type.ofType);\n      if (coercedItem === undefined) {\n        return; // Invalid: intentionally return no value.\n      }\n      return [coercedItem];\n    }\n    const coercedValue = [];\n    for (const itemValue of inputValue) {\n      const coercedItem = coerceInputValue(itemValue, type.ofType);\n      if (coercedItem === undefined) {\n        return; // Invalid: intentionally return no value.\n      }\n      coercedValue.push(coercedItem);\n    }\n    return coercedValue;\n  }\n\n  if (isInputObjectType(type)) {\n    if (!isObjectLike(inputValue) || Array.isArray(inputValue)) {\n      return; // Invalid: intentionally return no value.\n    }\n\n    const coercedValue: ObjMap<unknown> = Object.create(null);\n    const fieldDefs = type.getFields();\n    let definedFieldCount = 0;\n    for (const fieldName of Object.keys(inputValue)) {\n      if (inputValue[fieldName] === undefined) {\n        continue;\n      }\n      definedFieldCount++;\n      if (!Object.hasOwn(fieldDefs, fieldName)) {\n        return; // Invalid: intentionally return no value.\n      }\n    }\n    for (const field of Object.values(fieldDefs)) {\n      const fieldValue = inputValue[field.name];\n      if (fieldValue === undefined) {\n        if (isRequiredInputField(field)) {\n          return; // Invalid: intentionally return no value.\n        }\n        const coercedDefaultValue = coerceDefaultValue(field);\n        if (coercedDefaultValue !== undefined) {\n          coercedValue[field.name] = coercedDefaultValue;\n        }\n      } else {\n        const coercedField = coerceInputValue(fieldValue, field.type);\n        if (coercedField === undefined) {\n          return; // Invalid: intentionally return no value.\n        }\n        coercedValue[field.name] = coercedField;\n      }\n    }\n\n    if (type.isOneOf) {\n      const keys = Object.keys(coercedValue);\n      if (definedFieldCount !== 1 || keys.length !== 1) {\n        return; // Invalid: intentionally return no value.\n      }\n\n      const key = keys[0];\n      const value = coercedValue[key];\n      if (value === null) {\n        return; // Invalid: intentionally return no value.\n      }\n    }\n\n    return coercedValue;\n  }\n\n  const leafType = assertLeafType(type);\n\n  try {\n    return leafType.coerceInputValue(inputValue);\n  } catch (_error) {\n    // Invalid: ignore error and intentionally return no value.\n  }\n}\n\n/**\n * Produces a coerced \"internal\" JavaScript value given a GraphQL Value AST.\n *\n * Returns `undefined` when the value could not be validly coerced according to\n * the provided type.\n * @param valueNode - GraphQL value AST node to coerce.\n * @param type - GraphQL input type to coerce the literal against.\n * @param variableValues - Operation variable values returned by getVariableValues.\n * @param fragmentVariableValues - Fragment variable values for the current fragment scope.\n * @returns Coerced value, or undefined if coercion fails.\n * @example\n * ```ts\n * // Coerce literal input values without variables.\n * import { parseValue } from 'graphql/language';\n * import {\n *   GraphQLInputObjectType,\n *   GraphQLInt,\n *   GraphQLNonNull,\n *   GraphQLString,\n * } from 'graphql/type';\n * import { coerceInputLiteral } from 'graphql/utilities';\n *\n * const ReviewInput = new GraphQLInputObjectType({\n *   name: 'ReviewInput',\n *   fields: {\n *     stars: { type: new GraphQLNonNull(GraphQLInt) },\n *     comment: { type: GraphQLString },\n *   },\n * });\n *\n * coerceInputLiteral(parseValue('{ stars: 5, comment: \"Loved it\" }'), ReviewInput); // => { stars: 5, comment: 'Loved it' }\n * coerceInputLiteral(parseValue('{ comment: \"Missing\" }'), ReviewInput); // => undefined\n * ```\n * @example\n * ```ts\n * // This variant resolves variable references using VariableValues from getVariableValues().\n * import assert from 'node:assert';\n * import { parse, parseValue } from 'graphql/language';\n * import { GraphQLInt } from 'graphql/type';\n * import { getVariableValues } from 'graphql/execution';\n * import { buildSchema, coerceInputLiteral } from 'graphql/utilities';\n *\n * const schema = buildSchema(`\n *   type Query {\n *     review(stars: Int): String\n *   }\n * `);\n * const document = parse('query ($stars: Int = 5) { review(stars: $stars) }');\n * const operation = document.definitions[0];\n * const result = getVariableValues(\n *   schema,\n *   operation.variableDefinitions,\n *   { stars: '4' },\n * );\n *\n * assert('variableValues' in result);\n *\n * coerceInputLiteral(parseValue('$stars'), GraphQLInt, result.variableValues); // => 4\n * ```\n */\nexport function coerceInputLiteral(\n  valueNode: ValueNode,\n  type: GraphQLInputType,\n  variableValues?: Maybe<VariableValues>,\n  fragmentVariableValues?: Maybe<FragmentVariableValues>,\n): unknown {\n  if (valueNode.kind === Kind.VARIABLE) {\n    const coercedVariableValue = getCoercedVariableValue(\n      valueNode,\n      variableValues,\n      fragmentVariableValues,\n    );\n    if (coercedVariableValue == null && isNonNullType(type)) {\n      return; // Invalid: intentionally return no value.\n    }\n    // Note: This does no further checking that this variable is correct.\n    // This assumes validated has checked this variable is of the correct type.\n    return coercedVariableValue;\n  }\n\n  if (isNonNullType(type)) {\n    if (valueNode.kind === Kind.NULL) {\n      return; // Invalid: intentionally return no value.\n    }\n    return coerceInputLiteral(\n      valueNode,\n      type.ofType,\n      variableValues,\n      fragmentVariableValues,\n    );\n  }\n\n  if (valueNode.kind === Kind.NULL) {\n    return null; // Explicitly return the value null.\n  }\n\n  if (isListType(type)) {\n    if (valueNode.kind !== Kind.LIST) {\n      // Lists accept a non-list value as a list of one.\n      const itemValue = coerceInputLiteral(\n        valueNode,\n        type.ofType,\n        variableValues,\n        fragmentVariableValues,\n      );\n      if (itemValue === undefined) {\n        return; // Invalid: intentionally return no value.\n      }\n      return [itemValue];\n    }\n    const coercedValue: Array<unknown> = [];\n    for (const itemNode of valueNode.values) {\n      let itemValue = coerceInputLiteral(\n        itemNode,\n        type.ofType,\n        variableValues,\n        fragmentVariableValues,\n      );\n      if (itemValue === undefined) {\n        if (\n          itemNode.kind === Kind.VARIABLE &&\n          getCoercedVariableValue(\n            itemNode,\n            variableValues,\n            fragmentVariableValues,\n          ) == null &&\n          !isNonNullType(type.ofType)\n        ) {\n          // A missing variable within a list is coerced to null.\n          itemValue = null;\n        } else {\n          return; // Invalid: intentionally return no value.\n        }\n      }\n      coercedValue.push(itemValue);\n    }\n    return coercedValue;\n  }\n\n  if (isInputObjectType(type)) {\n    if (valueNode.kind !== Kind.OBJECT) {\n      return; // Invalid: intentionally return no value.\n    }\n\n    const coercedValue: ObjMap<unknown> = Object.create(null);\n    const fieldDefs = type.getFields();\n    const hasUndefinedField = valueNode.fields.some(\n      (field) => !Object.hasOwn(fieldDefs, field.name.value),\n    );\n    if (hasUndefinedField) {\n      return; // Invalid: intentionally return no value.\n    }\n    const fieldNodes = new Map(\n      valueNode.fields.map((field) => [field.name.value, field]),\n    );\n    for (const field of Object.values(fieldDefs)) {\n      const fieldNode = fieldNodes.get(field.name);\n      if (\n        !fieldNode ||\n        (fieldNode.value.kind === Kind.VARIABLE &&\n          isMissingVariable(\n            fieldNode.value,\n            variableValues,\n            fragmentVariableValues,\n          ))\n      ) {\n        if (isRequiredInputField(field)) {\n          return; // Invalid: intentionally return no value.\n        }\n        const coercedDefaultValue = coerceDefaultValue(field);\n        if (coercedDefaultValue !== undefined) {\n          coercedValue[field.name] = coercedDefaultValue;\n        }\n      } else {\n        const fieldValue = coerceInputLiteral(\n          fieldNode.value,\n          field.type,\n          variableValues,\n          fragmentVariableValues,\n        );\n        if (fieldValue === undefined) {\n          return; // Invalid: intentionally return no value.\n        }\n        coercedValue[field.name] = fieldValue;\n      }\n    }\n\n    if (type.isOneOf) {\n      const coercedKeys = Object.keys(coercedValue);\n      if (fieldNodes.size !== 1 || coercedKeys.length !== 1) {\n        return; // Invalid: not exactly one key, intentionally return no value.\n      }\n\n      for (const [fieldName, fieldNode] of fieldNodes) {\n        if (\n          fieldNode.value.kind === Kind.NULL ||\n          coercedValue[fieldName] === null\n        ) {\n          return; // Invalid: value not non-null, intentionally return no value.\n        }\n      }\n    }\n\n    return coercedValue;\n  }\n\n  const leafType = assertLeafType(type);\n  try {\n    return leafType.coerceInputLiteral\n      ? leafType.coerceInputLiteral(\n          replaceVariables(valueNode, variableValues, fragmentVariableValues),\n        )\n      : leafType.parseLiteral(valueNode, variableValues?.coerced);\n  } catch (_error) {\n    // Invalid: ignore error and intentionally return no value.\n  }\n}\n\n// Retrieves the variable value for the given variable node.\nfunction getCoercedVariableValue(\n  variableNode: VariableNode,\n  variableValues: Maybe<VariableValues>,\n  fragmentVariableValues: Maybe<FragmentVariableValues>,\n): unknown {\n  const varName = variableNode.name.value;\n  if (fragmentVariableValues?.sources[varName] !== undefined) {\n    return fragmentVariableValues.coerced[varName];\n  }\n\n  return variableValues?.coerced[varName];\n}\n\nfunction isMissingVariable(\n  variableNode: VariableNode,\n  variableValues: Maybe<VariableValues>,\n  fragmentVariableValues: Maybe<FragmentVariableValues>,\n): boolean {\n  const varName = variableNode.name.value;\n  const scopedValues =\n    fragmentVariableValues?.sources[varName] !== undefined\n      ? fragmentVariableValues.coerced\n      : variableValues?.coerced;\n  return scopedValues?.[varName] === undefined;\n}\n\ninterface InputValue {\n  type: GraphQLInputType;\n  default?: GraphQLDefaultInput | undefined;\n  defaultValue?: unknown;\n  /** @private */\n  _memoizedCoercedDefaultValue?: unknown;\n}\n\n/**\n * Returns the coerced default value for an input value definition, if it exists.\n *\n * If the default value is invalid, this will throw an error. Invalid default\n * values should be caught during validation, however, so this function assumes\n * that the default value is valid.\n * @internal\n */\nexport function coerceDefaultValue(inputValue: InputValue): unknown {\n  // Memoize the result of coercing the default value in a hidden field.\n  let coercedDefaultValue = inputValue._memoizedCoercedDefaultValue;\n  if (coercedDefaultValue !== undefined) {\n    return coercedDefaultValue;\n  }\n\n  const defaultInput = inputValue.default;\n  if (defaultInput !== undefined) {\n    coercedDefaultValue = defaultInput.literal\n      ? coerceInputLiteral(defaultInput.literal, inputValue.type)\n      : coerceInputValue(defaultInput.value, inputValue.type);\n    invariant(\n      coercedDefaultValue !== undefined,\n      `Expected value of type \"${inputValue.type}\" to be valid, found: ${inspect(\n        defaultInput.literal ?? defaultInput.value,\n      )}.`,\n    );\n    inputValue._memoizedCoercedDefaultValue = coercedDefaultValue;\n    return coercedDefaultValue;\n  }\n\n  const defaultValue = inputValue.defaultValue;\n  if (defaultValue !== undefined) {\n    inputValue._memoizedCoercedDefaultValue = defaultValue;\n  }\n  return defaultValue;\n}\n"]}

package/utilities/concatAST.d.mts

@@ -1,7 +1,19 @@
+/** @category AST Utilities */
 import type { DocumentNode } from "../language/ast.mjs";
 /**
  * Provided a collection of ASTs, presumably each from different files,
  * concatenate the ASTs together into batched AST, useful for validating many
  * GraphQL source files which together represent one conceptual application.
+ * @param documents - Document ASTs to concatenate.
+ * @returns A document AST containing all definitions from the provided documents.
+ * @example
+ * ```ts
+ * import { parse } from 'graphql/language';
+ * import { concatAST } from 'graphql/utilities';
+ *
+ * const document = concatAST([parse('type Query { a: String }'), parse('type User { id: ID }')]);
+ *
+ * document.definitions.length; // => 2
+ * ```
  */
 export declare function concatAST(documents: ReadonlyArray<DocumentNode>): DocumentNode;

package/utilities/concatAST.d.ts

@@ -1,7 +1,19 @@
+/** @category AST Utilities */
 import type { DocumentNode } from "../language/ast.js";
 /**
  * Provided a collection of ASTs, presumably each from different files,
  * concatenate the ASTs together into batched AST, useful for validating many
  * GraphQL source files which together represent one conceptual application.
+ * @param documents - Document ASTs to concatenate.
+ * @returns A document AST containing all definitions from the provided documents.
+ * @example
+ * ```ts
+ * import { parse } from 'graphql/language';
+ * import { concatAST } from 'graphql/utilities';
+ *
+ * const document = concatAST([parse('type Query { a: String }'), parse('type User { id: ID }')]);
+ *
+ * document.definitions.length; // => 2
+ * ```
  */
 export declare function concatAST(documents: ReadonlyArray<DocumentNode>): DocumentNode;

package/utilities/concatAST.js

@@ -2,11 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.concatAST = concatAST;
 const kinds_ts_1 = require("../language/kinds.js");
-/**
- * Provided a collection of ASTs, presumably each from different files,
- * concatenate the ASTs together into batched AST, useful for validating many
- * GraphQL source files which together represent one conceptual application.
- */
 function concatAST(documents) {
     const definitions = [];
     for (const doc of documents) {

package/utilities/concatAST.js.map

@@ -1 +1 @@
-{"version":3,"file":"concatAST.js","sourceRoot":"","sources":["../../src/utilities/concatAST.ts"],"names":[],"mappings":";;AAQA,8BAQC;AAfD,mDAA4C;AAE5C;;;;GAIG;AACH,SAAgB,SAAS,CACvB,SAAsC;IAEtC,MAAM,WAAW,GAA0B,EAAE,CAAC;IAC9C,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,WAAW,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,eAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC;AAC9C,CAAC","sourcesContent":["import type { DefinitionNode, DocumentNode } from '../language/ast.ts';\nimport { Kind } from '../language/kinds.ts';\n\n/**\n * Provided a collection of ASTs, presumably each from different files,\n * concatenate the ASTs together into batched AST, useful for validating many\n * GraphQL source files which together represent one conceptual application.\n */\nexport function concatAST(\n  documents: ReadonlyArray<DocumentNode>,\n): DocumentNode {\n  const definitions: Array<DefinitionNode> = [];\n  for (const doc of documents) {\n    definitions.push(...doc.definitions);\n  }\n  return { kind: Kind.DOCUMENT, definitions };\n}\n"]}
+{"version":3,"file":"concatAST.js","sourceRoot":"","sources":["../../src/utilities/concatAST.ts"],"names":[],"mappings":";;AAqBA,8BAQC;AA1BD,mDAA4C;AAkB5C,SAAgB,SAAS,CACvB,SAAsC;IAEtC,MAAM,WAAW,GAA0B,EAAE,CAAC;IAC9C,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,WAAW,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,eAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC;AAC9C,CAAC","sourcesContent":["/** @category AST Utilities */\n\nimport type { DefinitionNode, DocumentNode } from '../language/ast.ts';\nimport { Kind } from '../language/kinds.ts';\n\n/**\n * Provided a collection of ASTs, presumably each from different files,\n * concatenate the ASTs together into batched AST, useful for validating many\n * GraphQL source files which together represent one conceptual application.\n * @param documents - Document ASTs to concatenate.\n * @returns A document AST containing all definitions from the provided documents.\n * @example\n * ```ts\n * import { parse } from 'graphql/language';\n * import { concatAST } from 'graphql/utilities';\n *\n * const document = concatAST([parse('type Query { a: String }'), parse('type User { id: ID }')]);\n *\n * document.definitions.length; // => 2\n * ```\n */\nexport function concatAST(\n  documents: ReadonlyArray<DocumentNode>,\n): DocumentNode {\n  const definitions: Array<DefinitionNode> = [];\n  for (const doc of documents) {\n    definitions.push(...doc.definitions);\n  }\n  return { kind: Kind.DOCUMENT, definitions };\n}\n"]}

package/utilities/concatAST.mjs

@@ -1,9 +1,4 @@
 import { Kind } from "../language/kinds.mjs";
-/**
- * Provided a collection of ASTs, presumably each from different files,
- * concatenate the ASTs together into batched AST, useful for validating many
- * GraphQL source files which together represent one conceptual application.
- */
 export function concatAST(documents) {
     const definitions = [];
     for (const doc of documents) {

package/utilities/concatAST.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"concatAST.js","sourceRoot":"","sources":["../../src/utilities/concatAST.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,8BAA6B;AAE5C;;;;GAIG;AACH,MAAM,UAAU,SAAS,CACvB,SAAsC;IAEtC,MAAM,WAAW,GAA0B,EAAE,CAAC;IAC9C,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,WAAW,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC;AAC9C,CAAC","sourcesContent":["import type { DefinitionNode, DocumentNode } from '../language/ast.ts';\nimport { Kind } from '../language/kinds.ts';\n\n/**\n * Provided a collection of ASTs, presumably each from different files,\n * concatenate the ASTs together into batched AST, useful for validating many\n * GraphQL source files which together represent one conceptual application.\n */\nexport function concatAST(\n  documents: ReadonlyArray<DocumentNode>,\n): DocumentNode {\n  const definitions: Array<DefinitionNode> = [];\n  for (const doc of documents) {\n    definitions.push(...doc.definitions);\n  }\n  return { kind: Kind.DOCUMENT, definitions };\n}\n"]}
+{"version":3,"file":"concatAST.js","sourceRoot":"","sources":["../../src/utilities/concatAST.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAE,8BAA6B;AAkB5C,MAAM,UAAU,SAAS,CACvB,SAAsC;IAEtC,MAAM,WAAW,GAA0B,EAAE,CAAC;IAC9C,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,WAAW,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC;AAC9C,CAAC","sourcesContent":["/** @category AST Utilities */\n\nimport type { DefinitionNode, DocumentNode } from '../language/ast.ts';\nimport { Kind } from '../language/kinds.ts';\n\n/**\n * Provided a collection of ASTs, presumably each from different files,\n * concatenate the ASTs together into batched AST, useful for validating many\n * GraphQL source files which together represent one conceptual application.\n * @param documents - Document ASTs to concatenate.\n * @returns A document AST containing all definitions from the provided documents.\n * @example\n * ```ts\n * import { parse } from 'graphql/language';\n * import { concatAST } from 'graphql/utilities';\n *\n * const document = concatAST([parse('type Query { a: String }'), parse('type User { id: ID }')]);\n *\n * document.definitions.length; // => 2\n * ```\n */\nexport function concatAST(\n  documents: ReadonlyArray<DocumentNode>,\n): DocumentNode {\n  const definitions: Array<DefinitionNode> = [];\n  for (const doc of documents) {\n    definitions.push(...doc.definitions);\n  }\n  return { kind: Kind.DOCUMENT, definitions };\n}\n"]}

package/utilities/extendSchema.d.mts

@@ -1,3 +1,4 @@
+/** @category Schema Construction */
 import type { DocumentNode } from "../language/ast.mjs";
 import type { GraphQLSchemaNormalizedConfig, GraphQLSchemaValidationOptions } from "../type/schema.mjs";
 import { GraphQLSchema } from "../type/schema.mjs";
@@ -6,6 +7,8 @@ interface Options extends GraphQLSchemaValidationOptions {
      * Set to true to assume the SDL is valid.
      *
      * Default: false
+     *
+     * @internal
      */
     assumeValidSDL?: boolean | undefined;
 }
@@ -20,10 +23,62 @@ interface Options extends GraphQLSchemaValidationOptions {
  *
  * This algorithm copies the provided schema, applying extensions while
  * producing the copy. The original schema remains unaltered.
+ * @param schema - GraphQL schema to use.
+ * @param documentAST - The parsed GraphQL document AST.
+ * @param options - Optional configuration for this operation.
+ * @returns A new schema with the extensions and definitions applied.
+ * @example
+ * ```ts
+ * // Extend a schema with new fields and types.
+ * import { parse } from 'graphql/language';
+ * import { buildSchema, extendSchema } from 'graphql/utilities';
+ *
+ * const schema = buildSchema(`
+ *   type Query {
+ *     greeting: String
+ *   }
+ * `);
+ * const extensionAST = parse(`
+ *   extend type Query {
+ *     farewell: String
+ *   }
+ *
+ *   type Review {
+ *     body: String
+ *   }
+ * `);
+ *
+ * const extendedSchema = extendSchema(schema, extensionAST);
+ *
+ * schema.getType('Review'); // => undefined
+ * extendedSchema.getType('Review')?.name; // => 'Review'
+ * Object.keys(extendedSchema.getQueryType().getFields()); // => ['greeting', 'farewell']
+ * ```
+ * @example
+ * ```ts
+ * // This variant bypasses validation for an otherwise invalid extension.
+ * import { parse } from 'graphql/language';
+ * import { buildSchema, extendSchema } from 'graphql/utilities';
+ *
+ * const schema = buildSchema(`
+ *   type Query {
+ *     greeting: String
+ *   }
+ * `);
+ * const invalidExtension = parse(`
+ *   extend type Missing {
+ *     field: String
+ *   }
+ * `);
+ *
+ * extendSchema(schema, invalidExtension); // throws an error
+ * extendSchema(schema, invalidExtension, {
+ *     assumeValid: true,
+ *     assumeValidSDL: true,
+ *   }); // does not throw
+ * ```
  */
 export declare function extendSchema(schema: GraphQLSchema, documentAST: DocumentNode, options?: Options): GraphQLSchema;
-/**
- * @internal
- */
+/** @internal */
 export declare function extendSchemaImpl(schemaConfig: GraphQLSchemaNormalizedConfig, documentAST: DocumentNode, options?: Options): GraphQLSchemaNormalizedConfig;
 export {};

package/utilities/extendSchema.d.ts

@@ -1,3 +1,4 @@
+/** @category Schema Construction */
 import type { DocumentNode } from "../language/ast.js";
 import type { GraphQLSchemaNormalizedConfig, GraphQLSchemaValidationOptions } from "../type/schema.js";
 import { GraphQLSchema } from "../type/schema.js";
@@ -6,6 +7,8 @@ interface Options extends GraphQLSchemaValidationOptions {
      * Set to true to assume the SDL is valid.
      *
      * Default: false
+     *
+     * @internal
      */
     assumeValidSDL?: boolean | undefined;
 }
@@ -20,10 +23,62 @@ interface Options extends GraphQLSchemaValidationOptions {
  *
  * This algorithm copies the provided schema, applying extensions while
  * producing the copy. The original schema remains unaltered.
+ * @param schema - GraphQL schema to use.
+ * @param documentAST - The parsed GraphQL document AST.
+ * @param options - Optional configuration for this operation.
+ * @returns A new schema with the extensions and definitions applied.
+ * @example
+ * ```ts
+ * // Extend a schema with new fields and types.
+ * import { parse } from 'graphql/language';
+ * import { buildSchema, extendSchema } from 'graphql/utilities';
+ *
+ * const schema = buildSchema(`
+ *   type Query {
+ *     greeting: String
+ *   }
+ * `);
+ * const extensionAST = parse(`
+ *   extend type Query {
+ *     farewell: String
+ *   }
+ *
+ *   type Review {
+ *     body: String
+ *   }
+ * `);
+ *
+ * const extendedSchema = extendSchema(schema, extensionAST);
+ *
+ * schema.getType('Review'); // => undefined
+ * extendedSchema.getType('Review')?.name; // => 'Review'
+ * Object.keys(extendedSchema.getQueryType().getFields()); // => ['greeting', 'farewell']
+ * ```
+ * @example
+ * ```ts
+ * // This variant bypasses validation for an otherwise invalid extension.
+ * import { parse } from 'graphql/language';
+ * import { buildSchema, extendSchema } from 'graphql/utilities';
+ *
+ * const schema = buildSchema(`
+ *   type Query {
+ *     greeting: String
+ *   }
+ * `);
+ * const invalidExtension = parse(`
+ *   extend type Missing {
+ *     field: String
+ *   }
+ * `);
+ *
+ * extendSchema(schema, invalidExtension); // throws an error
+ * extendSchema(schema, invalidExtension, {
+ *     assumeValid: true,
+ *     assumeValidSDL: true,
+ *   }); // does not throw
+ * ```
  */
 export declare function extendSchema(schema: GraphQLSchema, documentAST: DocumentNode, options?: Options): GraphQLSchema;
-/**
- * @internal
- */
+/** @internal */
 export declare function extendSchemaImpl(schemaConfig: GraphQLSchemaNormalizedConfig, documentAST: DocumentNode, options?: Options): GraphQLSchemaNormalizedConfig;
 export {};

package/utilities/extendSchema.js

@@ -13,18 +13,6 @@ const schema_ts_1 = require("../type/schema.js");
 const validate_ts_1 = require("../validation/validate.js");
 const values_ts_1 = require("../execution/values.js");
 const mapSchemaConfig_ts_1 = require("./mapSchemaConfig.js");
-/**
- * Produces a new schema given an existing schema and a document which may
- * contain GraphQL type extensions and definitions. The original schema will
- * remain unaltered.
- *
- * Because a schema represents a graph of references, a schema cannot be
- * extended without effectively making an entire copy. We do not know until it's
- * too late if subgraphs remain unchanged.
- *
- * This algorithm copies the provided schema, applying extensions while
- * producing the copy. The original schema remains unaltered.
- */
 function extendSchema(schema, documentAST, options) {
     (0, schema_ts_1.assertSchema)(schema);
     if (options?.assumeValid !== true && options?.assumeValidSDL !== true) {
@@ -36,11 +24,7 @@ function extendSchema(schema, documentAST, options) {
         ? schema
         : new schema_ts_1.GraphQLSchema(extendedConfig);
 }
-/**
- * @internal
- */
 function extendSchemaImpl(schemaConfig, documentAST, options) {
-    // Collect the type definitions and extensions found in the document.
     const typeDefs = [];
     const scalarExtensions = new AccumulatorMap_ts_1.AccumulatorMap();
     const objectExtensions = new AccumulatorMap_ts_1.AccumulatorMap();
@@ -49,11 +33,8 @@ function extendSchemaImpl(schemaConfig, documentAST, options) {
     const enumExtensions = new AccumulatorMap_ts_1.AccumulatorMap();
     const inputObjectExtensions = new AccumulatorMap_ts_1.AccumulatorMap();
     const directiveExtensions = new AccumulatorMap_ts_1.AccumulatorMap();
-    // New directives and types are separate because a directives and types can
-    // have the same name. For example, a type named "skip".
     const directiveDefs = [];
     let schemaDef;
-    // Schema extensions are collected which may add additional operation types.
     const schemaExtensions = [];
     let isSchemaChanged = false;
     for (const def of documentAST.definitions) {
@@ -70,7 +51,6 @@ function extendSchemaImpl(schemaConfig, documentAST, options) {
             case kinds_ts_1.Kind.DIRECTIVE_EXTENSION:
                 directiveExtensions.add(def.name.value, def);
                 break;
-            // Type Definitions
             case kinds_ts_1.Kind.SCALAR_TYPE_DEFINITION:
             case kinds_ts_1.Kind.OBJECT_TYPE_DEFINITION:
             case kinds_ts_1.Kind.INTERFACE_TYPE_DEFINITION:
@@ -79,7 +59,6 @@ function extendSchemaImpl(schemaConfig, documentAST, options) {
             case kinds_ts_1.Kind.INPUT_OBJECT_TYPE_DEFINITION:
                 typeDefs.push(def);
                 break;
-            // Type System Extensions
             case kinds_ts_1.Kind.SCALAR_TYPE_EXTENSION:
                 scalarExtensions.add(def.name.value, def);
                 break;
@@ -103,8 +82,6 @@ function extendSchemaImpl(schemaConfig, documentAST, options) {
         }
         isSchemaChanged = true;
     }
-    // If this document contains no new types, extensions, or directives then
-    // return the same unmodified GraphQLSchema instance.
     if (!isSchemaChanged) {
         return schemaConfig;
     }
@@ -117,18 +94,15 @@ function extendSchemaImpl(schemaConfig, documentAST, options) {
                     setNamedType(type);
                 }
                 const operationTypes = {
-                    // Get the extended root operation types.
                     query: config.query &&
                         getNamedType(config.query.name),
                     mutation: config.mutation &&
                         getNamedType(config.mutation.name),
                     subscription: config.subscription &&
                         getNamedType(config.subscription.name),
-                    // Then, incorporate schema definition and all schema extensions.
                     ...(schemaDef && getOperationTypes([schemaDef])),
                     ...getOperationTypes(schemaExtensions),
                 };
-                // Then produce and return a Schema config with these types.
                 return {
                     description: schemaDef?.description?.value ?? config.description,
                     ...operationTypes,
@@ -221,10 +195,6 @@ function extendSchemaImpl(schemaConfig, documentAST, options) {
             for (const node of nodes) {
                 const operationTypesNodes = node.operationTypes ?? [];
                 for (const operationType of operationTypesNodes) {
-                    // Note: While this could make early assertions to get the correctly
-                    // typed values below, that would throw immediately while type system
-                    // validation with validateSchema() will produce more actionable results.
-                    // @ts-expect-error
                     opTypes[operationType.operation] = namedTypeFromAST(operationType.type);
                 }
             }
@@ -255,7 +225,6 @@ function extendSchemaImpl(schemaConfig, documentAST, options) {
             return new directives_ts_1.GraphQLDirective({
                 name: node.name.value,
                 description: node.description?.value,
-                // @ts-expect-error
                 locations: node.locations.map(({ value }) => value),
                 isRepeatable: node.repeatable,
                 args: buildArgumentMap(node.arguments),
@@ -285,9 +254,6 @@ function extendSchemaImpl(schemaConfig, documentAST, options) {
                 const nodeFields = node.fields ?? [];
                 for (const field of nodeFields) {
                     fieldConfigMap[field.name.value] = {
-                        // Note: While this could make assertions to get the correctly typed
-                        // value, that would throw immediately while type system validation
-                        // with validateSchema() will produce more actionable results.
                         type: typeFromAST(field.type),
                         description: field.description?.value,
                         args: buildArgumentMap(field.arguments),
@@ -302,9 +268,6 @@ function extendSchemaImpl(schemaConfig, documentAST, options) {
             const argsNodes = args ?? [];
             const argConfigMap = Object.create(null);
             for (const arg of argsNodes) {
-                // Note: While this could make assertions to get the correctly typed
-                // value, that would throw immediately while type system validation
-                // with validateSchema() will produce more actionable results.
                 const type = typeFromAST(arg.type);
                 argConfigMap[arg.name.value] = {
                     type,
@@ -321,9 +284,6 @@ function extendSchemaImpl(schemaConfig, documentAST, options) {
             for (const node of nodes) {
                 const fieldsNodes = node.fields ?? [];
                 for (const field of fieldsNodes) {
-                    // Note: While this could make assertions to get the correctly typed
-                    // value, that would throw immediately while type system validation
-                    // with validateSchema() will produce more actionable results.
                     const type = typeFromAST(field.type);
                     inputFieldMap[field.name.value] = {
                         type,
@@ -351,17 +311,9 @@ function extendSchemaImpl(schemaConfig, documentAST, options) {
             return enumValueMap;
         }
         function buildInterfaces(nodes) {
-            // Note: While this could make assertions to get the correctly typed
-            // values below, that would throw immediately while type system
-            // validation with validateSchema() will produce more actionable results.
-            // @ts-expect-error
             return nodes.flatMap((node) => node.interfaces?.map(namedTypeFromAST) ?? []);
         }
         function buildUnionTypes(nodes) {
-            // Note: While this could make assertions to get the correctly typed
-            // values below, that would throw immediately while type system
-            // validation with validateSchema() will produce more actionable results.
-            // @ts-expect-error
             return nodes.flatMap((node) => node.types?.map(namedTypeFromAST) ?? []);
         }
         function buildNamedType(astNode) {
@@ -443,26 +395,14 @@ const stdTypeMap = new Map([...scalars_ts_1.specifiedScalarTypes, ...introspecti
     type.name,
     type,
 ]));
-/**
- * Given a field or enum value node, returns the string value for the
- * deprecation reason.
- */
 function getDeprecationReason(node) {
     const deprecated = (0, values_ts_1.getDirectiveValues)(directives_ts_1.GraphQLDeprecatedDirective, node);
-    // @ts-expect-error validated by `getDirectiveValues`
     return deprecated?.reason;
 }
-/**
- * Given a scalar node, returns the string value for the specifiedByURL.
- */
 function getSpecifiedByURL(node) {
     const specifiedBy = (0, values_ts_1.getDirectiveValues)(directives_ts_1.GraphQLSpecifiedByDirective, node);
-    // @ts-expect-error validated by `getDirectiveValues`
     return specifiedBy?.url;
 }
-/**
- * Given an input object node, returns if the node should be OneOf.
- */
 function isOneOf(node) {
     return Boolean((0, values_ts_1.getDirectiveValues)(directives_ts_1.GraphQLOneOfDirective, node));
 }