graphql 15.0.0 → 15.1.0

package/README.md

@@ -3,7 +3,7 @@
 The JavaScript reference implementation for GraphQL, a query language for APIs created by Facebook.
 
 [![npm version](https://badge.fury.io/js/graphql.svg)](https://badge.fury.io/js/graphql)
-[![Build Status](https://travis-ci.org/graphql/graphql-js.svg?branch=master)](https://travis-ci.org/graphql/graphql-js?branch=master)
+[![Build Status](https://github.com/graphql/graphql-js/workflows/CI/badge.svg?branch=master)](https://github.com/graphql/graphql-js/actions?query=branch%3Amaster)
 [![Coverage Status](https://codecov.io/gh/graphql/graphql-js/branch/master/graph/badge.svg)](https://codecov.io/gh/graphql/graphql-js)
 
 See more complete documentation at https://graphql.org/ and
@@ -24,16 +24,16 @@ through that README and the corresponding tests in parallel.
 
 Install GraphQL.js from npm
 
-With yarn:
+With npm:
 
 ```sh
-yarn add graphql
+npm install --save graphql
 ```
 
-or alternatively using npm:
+or alternatively using yarn:
 
 ```sh
-npm install --save graphql
+yarn add graphql
 ```
 
 GraphQL.js provides two important capabilities: building a type schema, and

package/error/GraphQLError.d.ts

@@ -1,4 +1,4 @@
-import Maybe from '../tsutils/Maybe';
+import { Maybe } from '../jsutils/Maybe';
 
 import { ASTNode } from '../language/ast';
 import { Source } from '../language/source';
@@ -13,7 +13,7 @@ import { SourceLocation } from '../language/location';
 export class GraphQLError extends Error {
   constructor(
     message: string,
-    nodes?: ReadonlyArray<ASTNode> | ASTNode | undefined,
+    nodes?: Maybe<ReadonlyArray<ASTNode> | ASTNode>,
     source?: Maybe<Source>,
     positions?: Maybe<ReadonlyArray<number>>,
     path?: Maybe<ReadonlyArray<string | number>>,

package/error/GraphQLError.js

@@ -24,14 +24,14 @@ function _defineProperties(target, props) { for (var i = 0; i < props.length; i+
 
 function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
 
-function _createSuper(Derived) { return function () { var Super = _getPrototypeOf(Derived), result; if (_isNativeReflectConstruct()) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
+function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); if (superClass) _setPrototypeOf(subClass, superClass); }
+
+function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
 
 function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } return _assertThisInitialized(self); }
 
 function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
 
-function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); if (superClass) _setPrototypeOf(subClass, superClass); }
-
 function _wrapNativeSuper(Class) { var _cache = typeof Map === "function" ? new Map() : undefined; _wrapNativeSuper = function _wrapNativeSuper(Class) { if (Class === null || !_isNativeFunction(Class)) return Class; if (typeof Class !== "function") { throw new TypeError("Super expression must either be null or a function"); } if (typeof _cache !== "undefined") { if (_cache.has(Class)) return _cache.get(Class); _cache.set(Class, Wrapper); } function Wrapper() { return _construct(Class, arguments, _getPrototypeOf(this).constructor); } Wrapper.prototype = Object.create(Class.prototype, { constructor: { value: Wrapper, enumerable: false, writable: true, configurable: true } }); return _setPrototypeOf(Wrapper, Class); }; return _wrapNativeSuper(Class); }
 
 function _construct(Parent, args, Class) { if (_isNativeReflectConstruct()) { _construct = Reflect.construct; } else { _construct = function _construct(Parent, args, Class) { var a = [null]; a.push.apply(a, args); var Constructor = Function.bind.apply(Parent, a); var instance = new Constructor(); if (Class) _setPrototypeOf(instance, Class.prototype); return instance; }; } return _construct.apply(null, arguments); }
@@ -226,8 +226,7 @@ var GraphQLError = /*#__PURE__*/function (_Error) {
         configurable: true
       });
       return _possibleConstructorReturn(_this);
-    }
-    /* istanbul ignore next (See: https://github.com/graphql/graphql-js/issues/2317) */
+    } // istanbul ignore next (See: 'https://github.com/graphql/graphql-js/issues/2317')
 
 
     if (Error.captureStackTrace) {

package/error/GraphQLError.js.flow

@@ -196,7 +196,7 @@ export class GraphQLError extends Error {
       return;
     }
 
-    /* istanbul ignore next (See: https://github.com/graphql/graphql-js/issues/2317) */
+    // istanbul ignore next (See: 'https://github.com/graphql/graphql-js/issues/2317')
     if (Error.captureStackTrace) {
       Error.captureStackTrace(this, GraphQLError);
     } else {

package/error/GraphQLError.mjs

@@ -6,14 +6,14 @@ function _defineProperties(target, props) { for (var i = 0; i < props.length; i+
 
 function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
 
-function _createSuper(Derived) { return function () { var Super = _getPrototypeOf(Derived), result; if (_isNativeReflectConstruct()) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
+function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); if (superClass) _setPrototypeOf(subClass, superClass); }
+
+function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
 
 function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } return _assertThisInitialized(self); }
 
 function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
 
-function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); if (superClass) _setPrototypeOf(subClass, superClass); }
-
 function _wrapNativeSuper(Class) { var _cache = typeof Map === "function" ? new Map() : undefined; _wrapNativeSuper = function _wrapNativeSuper(Class) { if (Class === null || !_isNativeFunction(Class)) return Class; if (typeof Class !== "function") { throw new TypeError("Super expression must either be null or a function"); } if (typeof _cache !== "undefined") { if (_cache.has(Class)) return _cache.get(Class); _cache.set(Class, Wrapper); } function Wrapper() { return _construct(Class, arguments, _getPrototypeOf(this).constructor); } Wrapper.prototype = Object.create(Class.prototype, { constructor: { value: Wrapper, enumerable: false, writable: true, configurable: true } }); return _setPrototypeOf(Wrapper, Class); }; return _wrapNativeSuper(Class); }
 
 function _construct(Parent, args, Class) { if (_isNativeReflectConstruct()) { _construct = Reflect.construct; } else { _construct = function _construct(Parent, args, Class) { var a = [null]; a.push.apply(a, args); var Constructor = Function.bind.apply(Parent, a); var instance = new Constructor(); if (Class) _setPrototypeOf(instance, Class.prototype); return instance; }; } return _construct.apply(null, arguments); }
@@ -215,8 +215,7 @@ export var GraphQLError = /*#__PURE__*/function (_Error) {
         configurable: true
       });
       return _possibleConstructorReturn(_this);
-    }
-    /* istanbul ignore next (See: https://github.com/graphql/graphql-js/issues/2317) */
+    } // istanbul ignore next (See: 'https://github.com/graphql/graphql-js/issues/2317')
 
 
     if (Error.captureStackTrace) {

package/error/locatedError.d.ts

@@ -1,4 +1,4 @@
-import Maybe from '../tsutils/Maybe';
+import { Maybe } from '../jsutils/Maybe';
 
 import { ASTNode } from '../language/ast';
 

package/execution/execute.d.ts

@@ -1,4 +1,5 @@
-import Maybe from '../tsutils/Maybe';
+import { Maybe } from '../jsutils/Maybe';
+
 import { PromiseOrValue } from '../jsutils/PromiseOrValue';
 import { Path } from '../jsutils/Path';
 
@@ -43,12 +44,13 @@ export interface ExecutionContext {
  *   - `errors` is included when any errors occurred as a non-empty array.
  *   - `data` is the result of a successful execution of the query.
  */
-export interface ExecutionResult {
+export interface ExecutionResult<TData = { [key: string]: any }> {
   errors?: ReadonlyArray<GraphQLError>;
-  data?: { [key: string]: any } | null;
+  // TS_SPECIFIC: TData. Motivation: https://github.com/graphql/graphql-js/pull/2490#issuecomment-639154229
+  data?: TData | null;
 }
 
-export type ExecutionArgs = {
+export interface ExecutionArgs {
   schema: GraphQLSchema;
   document: DocumentNode;
   rootValue?: any;
@@ -57,7 +59,7 @@ export type ExecutionArgs = {
   operationName?: Maybe<string>;
   fieldResolver?: Maybe<GraphQLFieldResolver<any, any>>;
   typeResolver?: Maybe<GraphQLTypeResolver<any, any>>;
-};
+}
 
 /**
  * Implements the "Evaluating requests" section of the GraphQL specification.
@@ -147,7 +149,7 @@ export function resolveFieldValueOrError(
   resolveFn: GraphQLFieldResolver<any, any>,
   source: any,
   info: GraphQLResolveInfo,
-): Error | any;
+): any;
 
 /**
  * If a resolveType function is not given, then a default resolve behavior is

package/execution/execute.js

@@ -182,8 +182,7 @@ function buildExecutionContext(schema, document, rootValue, contextValue, rawVar
     }
 
     return [new _GraphQLError.GraphQLError('Must provide an operation.')];
-  }
-  /* istanbul ignore next (See https://github.com/graphql/graphql-js/issues/2203) */
+  } // istanbul ignore next (See: 'https://github.com/graphql/graphql-js/issues/2203')
 
 
   var variableDefinitions = (_operation$variableDe = operation.variableDefinitions) !== null && _operation$variableDe !== void 0 ? _operation$variableDe : [];
@@ -603,16 +602,15 @@ function completeValue(exeContext, returnType, fieldNodes, info, path, result) {
   if ((0, _definition.isAbstractType)(returnType)) {
     return completeAbstractValue(exeContext, returnType, fieldNodes, info, path, result);
   } // If field type is Object, execute and complete all sub-selections.
+  // istanbul ignore else (See: 'https://github.com/graphql/graphql-js/issues/2618')
 
 
-  /* istanbul ignore else */
   if ((0, _definition.isObjectType)(returnType)) {
     return completeObjectValue(exeContext, returnType, fieldNodes, info, path, result);
-  } // Not reachable. All possible output types have been considered.
+  } // istanbul ignore next (Not reachable. All possible output types have been considered)
 
 
-  /* istanbul ignore next */
-  (0, _invariant.default)(false, 'Cannot complete value of unexpected output type: ' + (0, _inspect.default)(returnType));
+  false || (0, _invariant.default)(0, 'Cannot complete value of unexpected output type: ' + (0, _inspect.default)(returnType));
 }
 /**
  * Complete a list value by completing each item in the list with the

package/execution/execute.js.flow

@@ -311,7 +311,7 @@ export function buildExecutionContext(
     return [new GraphQLError('Must provide an operation.')];
   }
 
-  /* istanbul ignore next (See https://github.com/graphql/graphql-js/issues/2203) */
+  // istanbul ignore next (See: 'https://github.com/graphql/graphql-js/issues/2203')
   const variableDefinitions = operation.variableDefinitions ?? [];
 
   const coercedVariableValues = getVariableValues(
@@ -868,6 +868,7 @@ function completeValue(
   }
 
   // If field type is Object, execute and complete all sub-selections.
+  // istanbul ignore else (See: 'https://github.com/graphql/graphql-js/issues/2618')
   if (isObjectType(returnType)) {
     return completeObjectValue(
       exeContext,
@@ -879,7 +880,7 @@ function completeValue(
     );
   }
 
-  // Not reachable. All possible output types have been considered.
+  // istanbul ignore next (Not reachable. All possible output types have been considered)
   invariant(
     false,
     'Cannot complete value of unexpected output type: ' +

package/execution/execute.mjs

@@ -171,8 +171,7 @@ export function buildExecutionContext(schema, document, rootValue, contextValue,
     }
 
     return [new GraphQLError('Must provide an operation.')];
-  }
-  /* istanbul ignore next (See https://github.com/graphql/graphql-js/issues/2203) */
+  } // istanbul ignore next (See: 'https://github.com/graphql/graphql-js/issues/2203')
 
 
   var variableDefinitions = (_operation$variableDe = operation.variableDefinitions) !== null && _operation$variableDe !== void 0 ? _operation$variableDe : [];
@@ -588,16 +587,15 @@ function completeValue(exeContext, returnType, fieldNodes, info, path, result) {
   if (isAbstractType(returnType)) {
     return completeAbstractValue(exeContext, returnType, fieldNodes, info, path, result);
   } // If field type is Object, execute and complete all sub-selections.
+  // istanbul ignore else (See: 'https://github.com/graphql/graphql-js/issues/2618')
 
 
-  /* istanbul ignore else */
   if (isObjectType(returnType)) {
     return completeObjectValue(exeContext, returnType, fieldNodes, info, path, result);
-  } // Not reachable. All possible output types have been considered.
+  } // istanbul ignore next (Not reachable. All possible output types have been considered)
 
 
-  /* istanbul ignore next */
-  invariant(false, 'Cannot complete value of unexpected output type: ' + inspect(returnType));
+  false || invariant(0, 'Cannot complete value of unexpected output type: ' + inspect(returnType));
 }
 /**
  * Complete a list value by completing each item in the list with the

package/execution/values.d.ts

@@ -1,4 +1,5 @@
-import Maybe from '../tsutils/Maybe';
+import { Maybe } from '../jsutils/Maybe';
+
 import { GraphQLError } from '../error/GraphQLError';
 import {
   FieldNode,

package/execution/values.js

@@ -140,8 +140,7 @@ function coerceVariableValues(schema, varDefNodes, inputs, onError) {
 function getArgumentValues(def, node, variableValues) {
   var _node$arguments;
 
-  var coercedValues = {};
-  /* istanbul ignore next (See https://github.com/graphql/graphql-js/issues/2203) */
+  var coercedValues = {}; // istanbul ignore next (See: 'https://github.com/graphql/graphql-js/issues/2203')
 
   var argumentNodes = (_node$arguments = node.arguments) !== null && _node$arguments !== void 0 ? _node$arguments : [];
   var argNodeMap = (0, _keyMap.default)(argumentNodes, function (arg) {

package/execution/values.js.flow

@@ -170,7 +170,7 @@ export function getArgumentValues(
 ): { [argument: string]: mixed, ... } {
   const coercedValues = {};
 
-  /* istanbul ignore next (See https://github.com/graphql/graphql-js/issues/2203) */
+  // istanbul ignore next (See: 'https://github.com/graphql/graphql-js/issues/2203')
   const argumentNodes = node.arguments ?? [];
   const argNodeMap = keyMap(argumentNodes, (arg) => arg.name.value);
 

package/execution/values.mjs

@@ -119,8 +119,7 @@ function coerceVariableValues(schema, varDefNodes, inputs, onError) {
 export function getArgumentValues(def, node, variableValues) {
   var _node$arguments;
 
-  var coercedValues = {};
-  /* istanbul ignore next (See https://github.com/graphql/graphql-js/issues/2203) */
+  var coercedValues = {}; // istanbul ignore next (See: 'https://github.com/graphql/graphql-js/issues/2203')
 
   var argumentNodes = (_node$arguments = node.arguments) !== null && _node$arguments !== void 0 ? _node$arguments : [];
   var argNodeMap = keyMap(argumentNodes, function (arg) {

package/graphql.d.ts

@@ -1,4 +1,5 @@
-import Maybe from './tsutils/Maybe';
+import { Maybe } from './jsutils/Maybe';
+
 import { Source } from './language/source';
 import { GraphQLSchema } from './type/schema';
 import { GraphQLFieldResolver, GraphQLTypeResolver } from './type/definition';

package/index.d.ts

@@ -55,6 +55,7 @@ export {
   GraphQLIncludeDirective,
   GraphQLSkipDirective,
   GraphQLDeprecatedDirective,
+  GraphQLSpecifiedByDirective,
   // "Enum" of Type Kinds
   TypeKind,
   // Constant Deprecation Reason
@@ -171,7 +172,9 @@ export {
 
 // Parse and operate on GraphQL language source files.
 export {
+  Token,
   Source,
+  Location,
   getLocation,
   // Print source location
   printLocation,
@@ -207,8 +210,6 @@ export {
 export {
   ParseOptions,
   SourceLocation,
-  Location,
-  Token,
   TokenKindEnum,
   KindEnum,
   DirectiveLocationEnum,

package/index.js

@@ -147,6 +147,12 @@ Object.defineProperty(exports, "GraphQLDeprecatedDirective", {
     return _index.GraphQLDeprecatedDirective;
   }
 });
+Object.defineProperty(exports, "GraphQLSpecifiedByDirective", {
+  enumerable: true,
+  get: function get() {
+    return _index.GraphQLSpecifiedByDirective;
+  }
+});
 Object.defineProperty(exports, "TypeKind", {
   enumerable: true,
   get: function get() {
@@ -513,12 +519,24 @@ Object.defineProperty(exports, "assertValidSchema", {
     return _index.assertValidSchema;
   }
 });
+Object.defineProperty(exports, "Token", {
+  enumerable: true,
+  get: function get() {
+    return _index2.Token;
+  }
+});
 Object.defineProperty(exports, "Source", {
   enumerable: true,
   get: function get() {
     return _index2.Source;
   }
 });
+Object.defineProperty(exports, "Location", {
+  enumerable: true,
+  get: function get() {
+    return _index2.Location;
+  }
+});
 Object.defineProperty(exports, "getLocation", {
   enumerable: true,
   get: function get() {

package/index.js.flow

@@ -56,6 +56,7 @@ export {
   GraphQLIncludeDirective,
   GraphQLSkipDirective,
   GraphQLDeprecatedDirective,
+  GraphQLSpecifiedByDirective,
   // "Enum" of Type Kinds
   TypeKind,
   // Constant Deprecation Reason
@@ -172,7 +173,9 @@ export type {
 
 // Parse and operate on GraphQL language source files.
 export {
+  Token,
   Source,
+  Location,
   getLocation,
   // Print source location
   printLocation,
@@ -208,8 +211,6 @@ export {
 export type {
   ParseOptions,
   SourceLocation,
-  Location,
-  Token,
   TokenKindEnum,
   KindEnum,
   DirectiveLocationEnum,

package/index.mjs

@@ -29,7 +29,7 @@ export { graphql, graphqlSync } from "./graphql.mjs"; // Create and operate on G
 export { // Definitions
 GraphQLSchema, GraphQLDirective, GraphQLScalarType, GraphQLObjectType, GraphQLInterfaceType, GraphQLUnionType, GraphQLEnumType, GraphQLInputObjectType, GraphQLList, GraphQLNonNull // Standard GraphQL Scalars
 , specifiedScalarTypes, GraphQLInt, GraphQLFloat, GraphQLString, GraphQLBoolean, GraphQLID // Built-in Directives defined by the Spec
-, specifiedDirectives, GraphQLIncludeDirective, GraphQLSkipDirective, GraphQLDeprecatedDirective // "Enum" of Type Kinds
+, specifiedDirectives, GraphQLIncludeDirective, GraphQLSkipDirective, GraphQLDeprecatedDirective, GraphQLSpecifiedByDirective // "Enum" of Type Kinds
 , TypeKind // Constant Deprecation Reason
 , DEFAULT_DEPRECATION_REASON // GraphQL Types for introspection.
 , introspectionTypes, __Schema, __Directive, __DirectiveLocation, __Type, __Field, __InputValue, __EnumValue, __TypeKind // Meta-field definitions.
@@ -39,7 +39,7 @@ GraphQLSchema, GraphQLDirective, GraphQLScalarType, GraphQLObjectType, GraphQLIn
 , getNullableType, getNamedType // Validate GraphQL schema.
 , validateSchema, assertValidSchema } from "./type/index.mjs";
 // Parse and operate on GraphQL language source files.
-export { Source, getLocation // Print source location
+export { Token, Source, Location, getLocation // Print source location
 , printLocation, printSourceLocation // Lex
 , Lexer, TokenKind // Parse
 , parse, parseValue, parseType // Print

package/jsutils/Maybe.d.ts

@@ -0,0 +1,2 @@
+// Conveniently represents flow's "Maybe" type https://flow.org/en/docs/types/maybe/
+export type Maybe<T> = null | undefined | T;

package/jsutils/Path.d.ts

@@ -1,7 +1,7 @@
-export type Path = {
+export interface Path {
   prev: Path | undefined;
   key: string | number;
-};
+}
 
 /**
  * Given a Path and a key, return a new Path containing the new key.

package/jsutils/defineInspect.js

@@ -0,0 +1,25 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = defineInspect;
+
+var _invariant = _interopRequireDefault(require("./invariant"));
+
+var _nodejsCustomInspectSymbol = _interopRequireDefault(require("./nodejsCustomInspectSymbol"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+/**
+ * The `defineInspect()` function defines `inspect()` prototype method as alias of `toJSON`
+ */
+function defineInspect(classObject) {
+  var fn = classObject.prototype.toJSON;
+  typeof fn === 'function' || (0, _invariant.default)(0);
+  classObject.prototype.inspect = fn; // istanbul ignore else (See: 'https://github.com/graphql/graphql-js/issues/2317')
+
+  if (_nodejsCustomInspectSymbol.default) {
+    classObject.prototype[_nodejsCustomInspectSymbol.default] = fn;
+  }
+}

package/jsutils/defineInspect.js.flow

@@ -0,0 +1,21 @@
+// @flow strict
+
+import invariant from './invariant';
+import nodejsCustomInspectSymbol from './nodejsCustomInspectSymbol';
+
+/**
+ * The `defineInspect()` function defines `inspect()` prototype method as alias of `toJSON`
+ */
+export default function defineInspect(
+  classObject: Class<any> | ((...args: Array<any>) => mixed),
+): void {
+  const fn = classObject.prototype.toJSON;
+  invariant(typeof fn === 'function');
+
+  classObject.prototype.inspect = fn;
+
+  // istanbul ignore else (See: 'https://github.com/graphql/graphql-js/issues/2317')
+  if (nodejsCustomInspectSymbol) {
+    classObject.prototype[nodejsCustomInspectSymbol] = fn;
+  }
+}

package/jsutils/defineInspect.mjs

@@ -0,0 +1,15 @@
+import invariant from "./invariant.mjs";
+import nodejsCustomInspectSymbol from "./nodejsCustomInspectSymbol.mjs";
+/**
+ * The `defineInspect()` function defines `inspect()` prototype method as alias of `toJSON`
+ */
+
+export default function defineInspect(classObject) {
+  var fn = classObject.prototype.toJSON;
+  typeof fn === 'function' || invariant(0);
+  classObject.prototype.inspect = fn; // istanbul ignore else (See: 'https://github.com/graphql/graphql-js/issues/2317')
+
+  if (nodejsCustomInspectSymbol) {
+    classObject.prototype[nodejsCustomInspectSymbol] = fn;
+  }
+}

package/jsutils/devAssert.js

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

package/jsutils/devAssert.js.flow

@@ -2,7 +2,7 @@
 
 export default function devAssert(condition: mixed, message: string): void {
   const booleanCondition = Boolean(condition);
-  /* istanbul ignore else (see transformation done in './resources/inlineInvariant.js') */
+  // istanbul ignore else (See transformation done in './resources/inlineInvariant.js')
   if (!booleanCondition) {
     throw new Error(message);
   }

package/jsutils/devAssert.mjs

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

package/jsutils/instanceOf.js

@@ -11,8 +11,7 @@ exports.default = void 0;
  */
 // See: https://expressjs.com/en/advanced/best-practice-performance.html#set-node_env-to-production
 // See: https://webpack.js.org/guides/production/
-var _default = process.env.NODE_ENV === 'production' ?
-/* istanbul ignore next (See: https://github.com/graphql/graphql-js/issues/2317) */
+var _default = process.env.NODE_ENV === 'production' ? // istanbul ignore next (See: 'https://github.com/graphql/graphql-js/issues/2317')
 // eslint-disable-next-line no-shadow
 function instanceOf(value, constructor) {
   return value instanceof constructor;

package/jsutils/instanceOf.js.flow

@@ -12,7 +12,7 @@ declare function instanceOf(
 // See: https://expressjs.com/en/advanced/best-practice-performance.html#set-node_env-to-production
 // See: https://webpack.js.org/guides/production/
 export default process.env.NODE_ENV === 'production'
-  ? /* istanbul ignore next (See: https://github.com/graphql/graphql-js/issues/2317) */
+  ? // istanbul ignore next (See: 'https://github.com/graphql/graphql-js/issues/2317')
     // eslint-disable-next-line no-shadow
     function instanceOf(value: mixed, constructor: mixed) {
       return value instanceof constructor;

package/jsutils/instanceOf.mjs

@@ -4,8 +4,7 @@
  */
 // See: https://expressjs.com/en/advanced/best-practice-performance.html#set-node_env-to-production
 // See: https://webpack.js.org/guides/production/
-export default process.env.NODE_ENV === 'production' ?
-/* istanbul ignore next (See: https://github.com/graphql/graphql-js/issues/2317) */
+export default process.env.NODE_ENV === 'production' ? // istanbul ignore next (See: 'https://github.com/graphql/graphql-js/issues/2317')
 // eslint-disable-next-line no-shadow
 function instanceOf(value, constructor) {
   return value instanceof constructor;

package/jsutils/invariant.js

@@ -6,8 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.default = invariant;
 
 function invariant(condition, message) {
-  var booleanCondition = Boolean(condition);
-  /* istanbul ignore else (see transformation done in './resources/inlineInvariant.js') */
+  var booleanCondition = Boolean(condition); // istanbul ignore else (See transformation done in './resources/inlineInvariant.js')
 
   if (!booleanCondition) {
     throw new Error(message != null ? message : 'Unexpected invariant triggered.');

package/jsutils/invariant.js.flow

@@ -2,7 +2,7 @@
 
 export default function invariant(condition: mixed, message?: string): void {
   const booleanCondition = Boolean(condition);
-  /* istanbul ignore else (see transformation done in './resources/inlineInvariant.js') */
+  // istanbul ignore else (See transformation done in './resources/inlineInvariant.js')
   if (!booleanCondition) {
     throw new Error(
       message != null ? message : 'Unexpected invariant triggered.',

package/jsutils/invariant.mjs

@@ -1,6 +1,5 @@
 export default function invariant(condition, message) {
-  var booleanCondition = Boolean(condition);
-  /* istanbul ignore else (see transformation done in './resources/inlineInvariant.js') */
+  var booleanCondition = Boolean(condition); // istanbul ignore else (See transformation done in './resources/inlineInvariant.js')
 
   if (!booleanCondition) {
     throw new Error(message != null ? message : 'Unexpected invariant triggered.');

package/jsutils/nodejsCustomInspectSymbol.js

@@ -4,8 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = void 0;
-
-/* istanbul ignore next (See: https://github.com/graphql/graphql-js/issues/2317) */
+// istanbul ignore next (See: 'https://github.com/graphql/graphql-js/issues/2317')
 var nodejsCustomInspectSymbol = typeof Symbol === 'function' && typeof Symbol.for === 'function' ? Symbol.for('nodejs.util.inspect.custom') : undefined;
 var _default = nodejsCustomInspectSymbol;
 exports.default = _default;

package/jsutils/nodejsCustomInspectSymbol.js.flow

@@ -1,6 +1,6 @@
 // @flow strict
 
-/* istanbul ignore next (See: https://github.com/graphql/graphql-js/issues/2317) */
+// istanbul ignore next (See: 'https://github.com/graphql/graphql-js/issues/2317')
 const nodejsCustomInspectSymbol =
   typeof Symbol === 'function' && typeof Symbol.for === 'function'
     ? Symbol.for('nodejs.util.inspect.custom')

package/jsutils/nodejsCustomInspectSymbol.mjs

@@ -1,3 +1,3 @@
-/* istanbul ignore next (See: https://github.com/graphql/graphql-js/issues/2317) */
+// istanbul ignore next (See: 'https://github.com/graphql/graphql-js/issues/2317')
 var nodejsCustomInspectSymbol = typeof Symbol === 'function' && typeof Symbol.for === 'function' ? Symbol.for('nodejs.util.inspect.custom') : undefined;
 export default nodejsCustomInspectSymbol;