graphql 16.0.1 → 16.3.0

package/index.mjs

@@ -22,17 +22,17 @@
  * import { parse } from 'graphql';
  * import { parse } from 'graphql/language';
  * ```
+ *
+ * @packageDocumentation
  */
+// The GraphQL.js version info.
+export { version, versionInfo } from './version.mjs'; // The primary entry point into fulfilling a GraphQL request.
 
-/** The GraphQL.js version info. */
-export { version, versionInfo } from './version.mjs';
-/** The primary entry point into fulfilling a GraphQL request. */
-
-export { graphql, graphqlSync } from './graphql.mjs';
-/** Create and operate on GraphQL type definitions and schema. */
+export { graphql, graphqlSync } from './graphql.mjs'; // Create and operate on GraphQL type definitions and schema.
 
 export {
-  /** Definitions */
+  resolveObjMapThunk,
+  resolveReadonlyArrayThunk, // Definitions
   GraphQLSchema,
   GraphQLDirective,
   GraphQLScalarType,
@@ -42,25 +42,22 @@ export {
   GraphQLEnumType,
   GraphQLInputObjectType,
   GraphQLList,
-  GraphQLNonNull,
-  /** Standard GraphQL Scalars */
+  GraphQLNonNull, // Standard GraphQL Scalars
   specifiedScalarTypes,
   GraphQLInt,
   GraphQLFloat,
   GraphQLString,
   GraphQLBoolean,
-  GraphQLID,
-  /** Built-in Directives defined by the Spec */
+  GraphQLID, // Int boundaries constants
+  GRAPHQL_MAX_INT,
+  GRAPHQL_MIN_INT, // Built-in Directives defined by the Spec
   specifiedDirectives,
   GraphQLIncludeDirective,
   GraphQLSkipDirective,
   GraphQLDeprecatedDirective,
-  GraphQLSpecifiedByDirective,
-  /** "Enum" of Type Kinds */
-  TypeKind,
-  /** Constant Deprecation Reason */
-  DEFAULT_DEPRECATION_REASON,
-  /** GraphQL Types for introspection. */
+  GraphQLSpecifiedByDirective, // "Enum" of Type Kinds
+  TypeKind, // Constant Deprecation Reason
+  DEFAULT_DEPRECATION_REASON, // GraphQL Types for introspection.
   introspectionTypes,
   __Schema,
   __Directive,
@@ -69,12 +66,10 @@ export {
   __Field,
   __InputValue,
   __EnumValue,
-  __TypeKind,
-  /** Meta-field definitions. */
+  __TypeKind, // Meta-field definitions.
   SchemaMetaFieldDef,
   TypeMetaFieldDef,
-  TypeNameMetaFieldDef,
-  /** Predicates */
+  TypeNameMetaFieldDef, // Predicates
   isSchema,
   isDirective,
   isType,
@@ -98,8 +93,7 @@ export {
   isRequiredInputField,
   isSpecifiedScalarType,
   isIntrospectionType,
-  isSpecifiedDirective,
-  /** Assertions */
+  isSpecifiedDirective, // Assertions
   assertSchema,
   assertDirective,
   assertType,
@@ -118,47 +112,37 @@ export {
   assertAbstractType,
   assertWrappingType,
   assertNullableType,
-  assertNamedType,
-  /** Un-modifiers */
+  assertNamedType, // Un-modifiers
   getNullableType,
-  getNamedType,
-  /** Validate GraphQL schema. */
+  getNamedType, // Validate GraphQL schema.
   validateSchema,
-  assertValidSchema,
-  /** Upholds the spec rules about naming. */
+  assertValidSchema, // Upholds the spec rules about naming.
   assertName,
   assertEnumValueName,
 } from './type/index.mjs';
-
-/** Parse and operate on GraphQL language source files. */
+// Parse and operate on GraphQL language source files.
 export {
   Token,
   Source,
   Location,
   OperationTypeNode,
-  getLocation,
-  /** Print source location */
+  getLocation, // Print source location.
   printLocation,
-  printSourceLocation,
-  /** Lex */
+  printSourceLocation, // Lex
   Lexer,
-  TokenKind,
-  /** Parse */
+  TokenKind, // Parse
   parse,
   parseValue,
   parseConstValue,
-  parseType,
-  /** Print */
-  print,
-  /** Visit */
+  parseType, // Print
+  print, // Visit
   visit,
   visitInParallel,
   getVisitFn,
   getEnterLeaveForKind,
   BREAK,
   Kind,
-  DirectiveLocation,
-  /** Predicates */
+  DirectiveLocation, // Predicates
   isDefinitionNode,
   isExecutableDefinitionNode,
   isSelectionNode,
@@ -170,26 +154,23 @@ export {
   isTypeSystemExtensionNode,
   isTypeExtensionNode,
 } from './language/index.mjs';
-
-/** Execute GraphQL queries. */
+// Execute GraphQL queries.
 export {
   execute,
   executeSync,
   defaultFieldResolver,
   defaultTypeResolver,
   responsePathAsArray,
+  getVariableValues,
   getDirectiveValues,
   subscribe,
   createSourceEventStream,
 } from './execution/index.mjs';
-
-/** Validate GraphQL documents. */
+// Validate GraphQL documents.
 export {
   validate,
-  ValidationContext,
-  /** All validation rules in the GraphQL Specification. */
-  specifiedRules,
-  /** Individual validation rules. */
+  ValidationContext, // All validation rules in the GraphQL Specification.
+  specifiedRules, // Individual validation rules.
   ExecutableDefinitionsRule,
   FieldsOnCorrectTypeRule,
   FragmentsOnCompositeTypesRule,
@@ -215,8 +196,7 @@ export {
   UniqueVariableNamesRule,
   ValuesOfCorrectTypeRule,
   VariablesAreInputTypesRule,
-  VariablesInAllowedPositionRule,
-  /** SDL-specific validation rules */
+  VariablesInAllowedPositionRule, // SDL-specific validation rules
   LoneSchemaDefinitionRule,
   UniqueOperationTypesRule,
   UniqueTypeNamesRule,
@@ -224,13 +204,11 @@ export {
   UniqueFieldDefinitionNamesRule,
   UniqueArgumentDefinitionNamesRule,
   UniqueDirectiveNamesRule,
-  PossibleTypeExtensionsRule,
-  /** Custom validation rules */
+  PossibleTypeExtensionsRule, // Custom validation rules
   NoDeprecatedCustomRule,
   NoSchemaIntrospectionCustomRule,
 } from './validation/index.mjs';
-
-/** Create, format, and print GraphQL errors. */
+// Create, format, and print GraphQL errors.
 export {
   GraphQLError,
   syntaxError,
@@ -238,64 +216,37 @@ export {
   printError,
   formatError,
 } from './error/index.mjs';
-
-/** Utilities for operating on GraphQL type schema and parsed sources. */
+// Utilities for operating on GraphQL type schema and parsed sources.
 export {
-  /**
-   * Produce the GraphQL query recommended for a full schema introspection.
-   * Accepts optional IntrospectionOptions.
-   */
-  getIntrospectionQuery,
-  /** Gets the target Operation from a Document. */
-  getOperationAST,
-  /** Gets the Type for the target Operation AST. */
-  getOperationRootType,
-  /** Convert a GraphQLSchema to an IntrospectionQuery. */
-  introspectionFromSchema,
-  /** Build a GraphQLSchema from an introspection result. */
-  buildClientSchema,
-  /** Build a GraphQLSchema from a parsed GraphQL Schema language AST. */
-  buildASTSchema,
-  /** Build a GraphQLSchema from a GraphQL schema language document. */
-  buildSchema,
-  /** Extends an existing GraphQLSchema from a parsed GraphQL Schema language AST. */
-  extendSchema,
-  /** Sort a GraphQLSchema. */
-  lexicographicSortSchema,
-  /** Print a GraphQLSchema to GraphQL Schema language. */
-  printSchema,
-  /** Print a GraphQLType to GraphQL Schema language. */
-  printType,
-  /** Prints the built-in introspection schema in the Schema Language format. */
-  printIntrospectionSchema,
-  /** Create a GraphQLType from a GraphQL language AST. */
-  typeFromAST,
-  /** Create a JavaScript value from a GraphQL language AST with a Type. */
-  valueFromAST,
-  /** Create a JavaScript value from a GraphQL language AST without a Type. */
-  valueFromASTUntyped,
-  /** Create a GraphQL language AST from a JavaScript value. */
-  astFromValue,
-  /** A helper to use within recursive-descent visitors which need to be aware of the GraphQL type system. */
+  // Produce the GraphQL query recommended for a full schema introspection.
+  // Accepts optional IntrospectionOptions.
+  getIntrospectionQuery, // Gets the target Operation from a Document.
+  getOperationAST, // Gets the Type for the target Operation AST.
+  getOperationRootType, // Convert a GraphQLSchema to an IntrospectionQuery.
+  introspectionFromSchema, // Build a GraphQLSchema from an introspection result.
+  buildClientSchema, // Build a GraphQLSchema from a parsed GraphQL Schema language AST.
+  buildASTSchema, // Build a GraphQLSchema from a GraphQL schema language document.
+  buildSchema, // Extends an existing GraphQLSchema from a parsed GraphQL Schema language AST.
+  extendSchema, // Sort a GraphQLSchema.
+  lexicographicSortSchema, // Print a GraphQLSchema to GraphQL Schema language.
+  printSchema, // Print a GraphQLType to GraphQL Schema language.
+  printType, // Prints the built-in introspection schema in the Schema Language format.
+  printIntrospectionSchema, // Create a GraphQLType from a GraphQL language AST.
+  typeFromAST, // Create a JavaScript value from a GraphQL language AST with a Type.
+  valueFromAST, // Create a JavaScript value from a GraphQL language AST without a Type.
+  valueFromASTUntyped, // Create a GraphQL language AST from a JavaScript value.
+  astFromValue, // A helper to use within recursive-descent visitors which need to be aware of the GraphQL type system.
   TypeInfo,
-  visitWithTypeInfo,
-  /** Coerces a JavaScript value to a GraphQL type, or produces errors. */
-  coerceInputValue,
-  /** Concatenates multiple AST together. */
-  concatAST,
-  /** Separates an AST into an AST per Operation. */
-  separateOperations,
-  /** Strips characters that are not significant to the validity or execution of a GraphQL document. */
-  stripIgnoredCharacters,
-  /** Comparators for types */
+  visitWithTypeInfo, // Coerces a JavaScript value to a GraphQL type, or produces errors.
+  coerceInputValue, // Concatenates multiple AST together.
+  concatAST, // Separates an AST into an AST per Operation.
+  separateOperations, // Strips characters that are not significant to the validity or execution of a GraphQL document.
+  stripIgnoredCharacters, // Comparators for types
   isEqualType,
   isTypeSubTypeOf,
-  doTypesOverlap,
-  /** Asserts a string is a valid GraphQL name. */
-  assertValidName,
-  /** Determine if a string is a valid GraphQL name. */
-  isValidNameError,
-  /** Compares two GraphQLSchemas and detects breaking changes. */
+  doTypesOverlap, // Asserts a string is a valid GraphQL name.
+  assertValidName, // Determine if a string is a valid GraphQL name.
+  isValidNameError, // Compares two GraphQLSchemas and detects breaking changes.
   BreakingChangeType,
   DangerousChangeType,
   findBreakingChanges,

package/jsutils/devAssert.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, '__esModule', {
 exports.devAssert = devAssert;
 
 function devAssert(condition, message) {
-  const booleanCondition = Boolean(condition); // istanbul ignore else (See transformation done in './resources/inlineInvariant.js')
+  const booleanCondition = Boolean(condition);
 
   if (!booleanCondition) {
     throw new Error(message);

package/jsutils/devAssert.mjs

@@ -1,5 +1,5 @@
 export function devAssert(condition, message) {
-  const booleanCondition = Boolean(condition); // istanbul ignore else (See transformation done in './resources/inlineInvariant.js')
+  const booleanCondition = Boolean(condition);
 
   if (!booleanCondition) {
     throw new Error(message);

package/jsutils/instanceOf.js

@@ -14,7 +14,9 @@ var _inspect = require('./inspect.js');
  * See: https://webpack.js.org/guides/production/
  */
 const instanceOf =
-  process.env.NODE_ENV === 'production' // istanbul ignore next (See: 'https://github.com/graphql/graphql-js/issues/2317')
+  /* c8 ignore next 5 */
+  // FIXME: https://github.com/graphql/graphql-js/issues/2317
+  process.env.NODE_ENV === 'production'
     ? function instanceOf(value, constructor) {
         return value instanceof constructor;
       }

package/jsutils/instanceOf.mjs

@@ -7,7 +7,9 @@ import { inspect } from './inspect.mjs';
  */
 
 export const instanceOf =
-  process.env.NODE_ENV === 'production' // istanbul ignore next (See: 'https://github.com/graphql/graphql-js/issues/2317')
+  /* c8 ignore next 5 */
+  // FIXME: https://github.com/graphql/graphql-js/issues/2317
+  process.env.NODE_ENV === 'production'
     ? function instanceOf(value, constructor) {
         return value instanceof constructor;
       }

package/jsutils/invariant.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, '__esModule', {
 exports.invariant = invariant;
 
 function invariant(condition, message) {
-  const booleanCondition = Boolean(condition); // istanbul ignore else (See transformation done in './resources/inlineInvariant.js')
+  const booleanCondition = Boolean(condition);
 
   if (!booleanCondition) {
     throw new Error(

package/jsutils/invariant.mjs

@@ -1,5 +1,5 @@
 export function invariant(condition, message) {
-  const booleanCondition = Boolean(condition); // istanbul ignore else (See transformation done in './resources/inlineInvariant.js')
+  const booleanCondition = Boolean(condition);
 
   if (!booleanCondition) {
     throw new Error(

package/jsutils/mapValue.js

@@ -12,8 +12,8 @@ exports.mapValue = mapValue;
 function mapValue(map, fn) {
   const result = Object.create(null);
 
-  for (const [key, value] of Object.entries(map)) {
-    result[key] = fn(value, key);
+  for (const key of Object.keys(map)) {
+    result[key] = fn(map[key], key);
   }
 
   return result;

package/jsutils/mapValue.mjs

@@ -5,8 +5,8 @@
 export function mapValue(map, fn) {
   const result = Object.create(null);
 
-  for (const [key, value] of Object.entries(map)) {
-    result[key] = fn(value, key);
+  for (const key of Object.keys(map)) {
+    result[key] = fn(map[key], key);
   }
 
   return result;

package/jsutils/promiseReduce.mjs

@@ -1,4 +1,5 @@
 import { isPromise } from './isPromise.mjs';
+
 /**
  * Similar to Array.prototype.reduce(), however the reducing callback may return
  * a Promise, in which case reduction will continue after each promise resolves.
@@ -6,7 +7,6 @@ import { isPromise } from './isPromise.mjs';
  * If the callback does not return a Promise, then this function will also not
  * return a Promise.
  */
-
 export function promiseReduce(values, callbackFn, initialValue) {
   let accumulator = initialValue;
 

package/jsutils/toError.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Sometimes a non-error is thrown, wrap it as an Error instance to ensure a consistent Error interface.
+ */
+export declare function toError(thrownValue: unknown): Error;

package/jsutils/toError.js

@@ -0,0 +1,25 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', {
+  value: true,
+});
+exports.toError = toError;
+
+var _inspect = require('./inspect.js');
+
+/**
+ * Sometimes a non-error is thrown, wrap it as an Error instance to ensure a consistent Error interface.
+ */
+function toError(thrownValue) {
+  return thrownValue instanceof Error
+    ? thrownValue
+    : new NonErrorThrown(thrownValue);
+}
+
+class NonErrorThrown extends Error {
+  constructor(thrownValue) {
+    super('Unexpected error value: ' + (0, _inspect.inspect)(thrownValue));
+    this.name = 'NonErrorThrown';
+    this.thrownValue = thrownValue;
+  }
+}

package/jsutils/toError.mjs

@@ -0,0 +1,18 @@
+import { inspect } from './inspect.mjs';
+/**
+ * Sometimes a non-error is thrown, wrap it as an Error instance to ensure a consistent Error interface.
+ */
+
+export function toError(thrownValue) {
+  return thrownValue instanceof Error
+    ? thrownValue
+    : new NonErrorThrown(thrownValue);
+}
+
+class NonErrorThrown extends Error {
+  constructor(thrownValue) {
+    super('Unexpected error value: ' + inspect(thrownValue));
+    this.name = 'NonErrorThrown';
+    this.thrownValue = thrownValue;
+  }
+}

package/language/blockString.d.ts

@@ -6,11 +6,13 @@
  *
  * @internal
  */
-export declare function dedentBlockStringValue(rawString: string): string;
+export declare function dedentBlockStringLines(
+  lines: ReadonlyArray<string>,
+): Array<string>;
 /**
  * @internal
  */
-export declare function getBlockStringIndentation(value: string): number;
+export declare function isPrintableAsBlockString(value: string): boolean;
 /**
  * Print a block string in the indented block form by adding a leading and
  * trailing blank line. However, if a block string starts with whitespace and is
@@ -20,5 +22,7 @@ export declare function getBlockStringIndentation(value: string): number;
  */
 export declare function printBlockString(
   value: string,
-  preferMultipleLines?: boolean,
+  options?: {
+    minimize?: boolean;
+  },
 ): string;