graphql 16.0.1 → 16.3.0

package/type/directives.js

@@ -15,24 +15,24 @@ exports.isDirective = isDirective;
 exports.isSpecifiedDirective = isSpecifiedDirective;
 exports.specifiedDirectives = void 0;
 
-var _inspect = require('../jsutils/inspect.js');
-
-var _toObjMap = require('../jsutils/toObjMap.js');
-
 var _devAssert = require('../jsutils/devAssert.js');
 
+var _inspect = require('../jsutils/inspect.js');
+
 var _instanceOf = require('../jsutils/instanceOf.js');
 
 var _isObjectLike = require('../jsutils/isObjectLike.js');
 
+var _toObjMap = require('../jsutils/toObjMap.js');
+
 var _directiveLocation = require('../language/directiveLocation.js');
 
 var _assertName = require('./assertName.js');
 
-var _scalars = require('./scalars.js');
-
 var _definition = require('./definition.js');
 
+var _scalars = require('./scalars.js');
+
 /**
  * Test if the given value is a GraphQL directive.
  */
@@ -191,18 +191,18 @@ const GraphQLDeprecatedDirective = new GraphQLDirective({
   },
 });
 /**
- * Used to provide a URL for specifying the behaviour of custom scalar definitions.
+ * Used to provide a URL for specifying the behavior of custom scalar definitions.
  */
 
 exports.GraphQLDeprecatedDirective = GraphQLDeprecatedDirective;
 const GraphQLSpecifiedByDirective = new GraphQLDirective({
   name: 'specifiedBy',
-  description: 'Exposes a URL that specifies the behaviour of this scalar.',
+  description: 'Exposes a URL that specifies the behavior of this scalar.',
   locations: [_directiveLocation.DirectiveLocation.SCALAR],
   args: {
     url: {
       type: new _definition.GraphQLNonNull(_scalars.GraphQLString),
-      description: 'The URL that specifies the behaviour of this scalar.',
+      description: 'The URL that specifies the behavior of this scalar.',
     },
   },
 });

package/type/directives.mjs

@@ -1,16 +1,16 @@
-import { inspect } from '../jsutils/inspect.mjs';
-import { toObjMap } from '../jsutils/toObjMap.mjs';
 import { devAssert } from '../jsutils/devAssert.mjs';
+import { inspect } from '../jsutils/inspect.mjs';
 import { instanceOf } from '../jsutils/instanceOf.mjs';
 import { isObjectLike } from '../jsutils/isObjectLike.mjs';
+import { toObjMap } from '../jsutils/toObjMap.mjs';
 import { DirectiveLocation } from '../language/directiveLocation.mjs';
 import { assertName } from './assertName.mjs';
-import { GraphQLString, GraphQLBoolean } from './scalars.mjs';
 import {
-  defineArguments,
   argsToArgsConfig,
+  defineArguments,
   GraphQLNonNull,
 } from './definition.mjs';
+import { GraphQLBoolean, GraphQLString } from './scalars.mjs';
 /**
  * Test if the given value is a GraphQL directive.
  */
@@ -161,17 +161,17 @@ export const GraphQLDeprecatedDirective = new GraphQLDirective({
   },
 });
 /**
- * Used to provide a URL for specifying the behaviour of custom scalar definitions.
+ * Used to provide a URL for specifying the behavior of custom scalar definitions.
  */
 
 export const GraphQLSpecifiedByDirective = new GraphQLDirective({
   name: 'specifiedBy',
-  description: 'Exposes a URL that specifies the behaviour of this scalar.',
+  description: 'Exposes a URL that specifies the behavior of this scalar.',
   locations: [DirectiveLocation.SCALAR],
   args: {
     url: {
       type: new GraphQLNonNull(GraphQLString),
-      description: 'The URL that specifies the behaviour of this scalar.',
+      description: 'The URL that specifies the behavior of this scalar.',
     },
   },
 });

package/type/index.d.ts

@@ -1,15 +1,9 @@
 export type { Path as ResponsePath } from '../jsutils/Path';
-export {
-  /** Predicate */
-  isSchema,
-  /** Assertion */
-  assertSchema,
-  /** GraphQL Schema definition */
-  GraphQLSchema,
-} from './schema';
+export { isSchema, assertSchema, GraphQLSchema } from './schema';
 export type { GraphQLSchemaConfig, GraphQLSchemaExtensions } from './schema';
 export {
-  /** Predicates */
+  resolveObjMapThunk,
+  resolveReadonlyArrayThunk,
   isType,
   isScalarType,
   isObjectType,
@@ -29,7 +23,6 @@ export {
   isNamedType,
   isRequiredArgument,
   isRequiredInputField,
-  /** Assertions */
   assertType,
   assertScalarType,
   assertObjectType,
@@ -47,17 +40,14 @@ export {
   assertWrappingType,
   assertNullableType,
   assertNamedType,
-  /** Un-modifiers */
   getNullableType,
   getNamedType,
-  /** Definitions */
   GraphQLScalarType,
   GraphQLObjectType,
   GraphQLInterfaceType,
   GraphQLUnionType,
   GraphQLEnumType,
   GraphQLInputObjectType,
-  /** Type Wrappers */
   GraphQLList,
   GraphQLNonNull,
 } from './definition';
@@ -114,42 +104,34 @@ export type {
   GraphQLScalarLiteralParser,
 } from './definition';
 export {
-  /** Predicate */
   isDirective,
-  /** Assertion */
   assertDirective,
-  /** Directives Definition */
   GraphQLDirective,
-  /** Built-in Directives defined by the Spec */
   isSpecifiedDirective,
   specifiedDirectives,
   GraphQLIncludeDirective,
   GraphQLSkipDirective,
   GraphQLDeprecatedDirective,
   GraphQLSpecifiedByDirective,
-  /** Constant Deprecation Reason */
   DEFAULT_DEPRECATION_REASON,
 } from './directives';
 export type {
   GraphQLDirectiveConfig,
   GraphQLDirectiveExtensions,
 } from './directives';
-/** Common built-in scalar instances. */
 export {
-  /** Predicate */
   isSpecifiedScalarType,
-  /** Standard GraphQL Scalars */
   specifiedScalarTypes,
   GraphQLInt,
   GraphQLFloat,
   GraphQLString,
   GraphQLBoolean,
   GraphQLID,
+  GRAPHQL_MAX_INT,
+  GRAPHQL_MIN_INT,
 } from './scalars';
 export {
-  /** Predicate */
   isIntrospectionType,
-  /** GraphQL Types for introspection. */
   introspectionTypes,
   __Schema,
   __Directive,
@@ -159,14 +141,10 @@ export {
   __InputValue,
   __EnumValue,
   __TypeKind,
-  /** "Enum" of Type Kinds */
   TypeKind,
-  /** Meta-field definitions. */
   SchemaMetaFieldDef,
   TypeMetaFieldDef,
   TypeNameMetaFieldDef,
 } from './introspection';
-/** Validate GraphQL schema. */
 export { validateSchema, assertValidSchema } from './validate';
-/** Upholds the spec rules about naming. */
 export { assertName, assertEnumValueName } from './assertName';

package/type/index.js

@@ -9,6 +9,18 @@ Object.defineProperty(exports, 'DEFAULT_DEPRECATION_REASON', {
     return _directives.DEFAULT_DEPRECATION_REASON;
   },
 });
+Object.defineProperty(exports, 'GRAPHQL_MAX_INT', {
+  enumerable: true,
+  get: function () {
+    return _scalars.GRAPHQL_MAX_INT;
+  },
+});
+Object.defineProperty(exports, 'GRAPHQL_MIN_INT', {
+  enumerable: true,
+  get: function () {
+    return _scalars.GRAPHQL_MIN_INT;
+  },
+});
 Object.defineProperty(exports, 'GraphQLBoolean', {
   enumerable: true,
   get: function () {
@@ -489,6 +501,18 @@ Object.defineProperty(exports, 'isWrappingType', {
     return _definition.isWrappingType;
   },
 });
+Object.defineProperty(exports, 'resolveObjMapThunk', {
+  enumerable: true,
+  get: function () {
+    return _definition.resolveObjMapThunk;
+  },
+});
+Object.defineProperty(exports, 'resolveReadonlyArrayThunk', {
+  enumerable: true,
+  get: function () {
+    return _definition.resolveReadonlyArrayThunk;
+  },
+});
 Object.defineProperty(exports, 'specifiedDirectives', {
   enumerable: true,
   get: function () {

package/type/index.mjs

@@ -1,13 +1,12 @@
 export {
-  /** Predicate */
-  isSchema,
-  /** Assertion */
-  assertSchema,
-  /** GraphQL Schema definition */
+  // Predicate
+  isSchema, // Assertion
+  assertSchema, // GraphQL Schema definition
   GraphQLSchema,
 } from './schema.mjs';
 export {
-  /** Predicates */
+  resolveObjMapThunk,
+  resolveReadonlyArrayThunk, // Predicates
   isType,
   isScalarType,
   isObjectType,
@@ -26,8 +25,7 @@ export {
   isNullableType,
   isNamedType,
   isRequiredArgument,
-  isRequiredInputField,
-  /** Assertions */
+  isRequiredInputField, // Assertions
   assertType,
   assertScalarType,
   assertObjectType,
@@ -44,55 +42,47 @@ export {
   assertAbstractType,
   assertWrappingType,
   assertNullableType,
-  assertNamedType,
-  /** Un-modifiers */
+  assertNamedType, // Un-modifiers
   getNullableType,
-  getNamedType,
-  /** Definitions */
+  getNamedType, // Definitions
   GraphQLScalarType,
   GraphQLObjectType,
   GraphQLInterfaceType,
   GraphQLUnionType,
   GraphQLEnumType,
-  GraphQLInputObjectType,
-  /** Type Wrappers */
+  GraphQLInputObjectType, // Type Wrappers
   GraphQLList,
   GraphQLNonNull,
 } from './definition.mjs';
 export {
-  /** Predicate */
-  isDirective,
-  /** Assertion */
-  assertDirective,
-  /** Directives Definition */
-  GraphQLDirective,
-  /** Built-in Directives defined by the Spec */
+  // Predicate
+  isDirective, // Assertion
+  assertDirective, // Directives Definition
+  GraphQLDirective, // Built-in Directives defined by the Spec
   isSpecifiedDirective,
   specifiedDirectives,
   GraphQLIncludeDirective,
   GraphQLSkipDirective,
   GraphQLDeprecatedDirective,
-  GraphQLSpecifiedByDirective,
-  /** Constant Deprecation Reason */
+  GraphQLSpecifiedByDirective, // Constant Deprecation Reason
   DEFAULT_DEPRECATION_REASON,
 } from './directives.mjs';
-
-/** Common built-in scalar instances. */
+// Common built-in scalar instances.
 export {
-  /** Predicate */
-  isSpecifiedScalarType,
-  /** Standard GraphQL Scalars */
+  // Predicate
+  isSpecifiedScalarType, // Standard GraphQL Scalars
   specifiedScalarTypes,
   GraphQLInt,
   GraphQLFloat,
   GraphQLString,
   GraphQLBoolean,
-  GraphQLID,
+  GraphQLID, // Int boundaries constants
+  GRAPHQL_MAX_INT,
+  GRAPHQL_MIN_INT,
 } from './scalars.mjs';
 export {
-  /** Predicate */
-  isIntrospectionType,
-  /** GraphQL Types for introspection. */
+  // Predicate
+  isIntrospectionType, // GraphQL Types for introspection.
   introspectionTypes,
   __Schema,
   __Directive,
@@ -101,17 +91,13 @@ export {
   __Field,
   __InputValue,
   __EnumValue,
-  __TypeKind,
-  /** "Enum" of Type Kinds */
-  TypeKind,
-  /** Meta-field definitions. */
+  __TypeKind, // "Enum" of Type Kinds
+  TypeKind, // Meta-field definitions.
   SchemaMetaFieldDef,
   TypeMetaFieldDef,
   TypeNameMetaFieldDef,
-} from './introspection.mjs';
-/** Validate GraphQL schema. */
+} from './introspection.mjs'; // Validate GraphQL schema.
 
-export { validateSchema, assertValidSchema } from './validate.mjs';
-/** Upholds the spec rules about naming. */
+export { validateSchema, assertValidSchema } from './validate.mjs'; // Upholds the spec rules about naming.
 
 export { assertName, assertEnumValueName } from './assertName.mjs';

package/type/introspection.d.ts

@@ -1,5 +1,5 @@
-import type { GraphQLNamedType, GraphQLField } from './definition';
-import { GraphQLObjectType, GraphQLEnumType } from './definition';
+import type { GraphQLField, GraphQLNamedType } from './definition';
+import { GraphQLEnumType, GraphQLObjectType } from './definition';
 export declare const __Schema: GraphQLObjectType;
 export declare const __Directive: GraphQLObjectType;
 export declare const __DirectiveLocation: GraphQLEnumType;

package/type/introspection.js

@@ -23,16 +23,16 @@ var _inspect = require('../jsutils/inspect.js');
 
 var _invariant = require('../jsutils/invariant.js');
 
-var _printer = require('../language/printer.js');
-
 var _directiveLocation = require('../language/directiveLocation.js');
 
-var _astFromValue = require('../utilities/astFromValue.js');
+var _printer = require('../language/printer.js');
 
-var _scalars = require('./scalars.js');
+var _astFromValue = require('../utilities/astFromValue.js');
 
 var _definition = require('./definition.js');
 
+var _scalars = require('./scalars.js');
+
 const __Schema = new _definition.GraphQLObjectType({
   name: '__Schema',
   description:
@@ -253,11 +253,13 @@ const __Type = new _definition.GraphQLObjectType({
 
         if ((0, _definition.isListType)(type)) {
           return TypeKind.LIST;
-        } // istanbul ignore else (See: 'https://github.com/graphql/graphql-js/issues/2618')
+        }
 
         if ((0, _definition.isNonNullType)(type)) {
           return TypeKind.NON_NULL;
-        } // istanbul ignore next (Not reachable. All possible types have been considered)
+        }
+        /* c8 ignore next 3 */
+        // Not reachable, all possible types have been considered)
 
         false ||
           (0, _invariant.invariant)(
@@ -273,8 +275,10 @@ const __Type = new _definition.GraphQLObjectType({
     description: {
       type: _scalars.GraphQLString,
       resolve: (
-        type, // istanbul ignore next (FIXME: add test case)
-      ) => ('description' in type ? type.description : undefined),
+        type, // FIXME: add test case
+      ) =>
+        /* c8 ignore next */
+        'description' in type ? type.description : undefined,
     },
     specifiedByURL: {
       type: _scalars.GraphQLString,

package/type/introspection.mjs

@@ -1,24 +1,24 @@
 import { inspect } from '../jsutils/inspect.mjs';
 import { invariant } from '../jsutils/invariant.mjs';
-import { print } from '../language/printer.mjs';
 import { DirectiveLocation } from '../language/directiveLocation.mjs';
+import { print } from '../language/printer.mjs';
 import { astFromValue } from '../utilities/astFromValue.mjs';
-import { GraphQLString, GraphQLBoolean } from './scalars.mjs';
 import {
+  GraphQLEnumType,
   GraphQLList,
   GraphQLNonNull,
   GraphQLObjectType,
-  GraphQLEnumType,
-  isScalarType,
-  isObjectType,
-  isInterfaceType,
-  isUnionType,
+  isAbstractType,
   isEnumType,
   isInputObjectType,
+  isInterfaceType,
   isListType,
   isNonNullType,
-  isAbstractType,
+  isObjectType,
+  isScalarType,
+  isUnionType,
 } from './definition.mjs';
+import { GraphQLBoolean, GraphQLString } from './scalars.mjs';
 export const __Schema = new GraphQLObjectType({
   name: '__Schema',
   description:
@@ -222,11 +222,13 @@ export const __Type = new GraphQLObjectType({
 
         if (isListType(type)) {
           return TypeKind.LIST;
-        } // istanbul ignore else (See: 'https://github.com/graphql/graphql-js/issues/2618')
+        }
 
         if (isNonNullType(type)) {
           return TypeKind.NON_NULL;
-        } // istanbul ignore next (Not reachable. All possible types have been considered)
+        }
+        /* c8 ignore next 3 */
+        // Not reachable, all possible types have been considered)
 
         false || invariant(false, `Unexpected type: "${inspect(type)}".`);
       },
@@ -238,8 +240,10 @@ export const __Type = new GraphQLObjectType({
     description: {
       type: GraphQLString,
       resolve: (
-        type, // istanbul ignore next (FIXME: add test case)
-      ) => ('description' in type ? type.description : undefined),
+        type, // FIXME: add test case
+      ) =>
+        /* c8 ignore next */
+        'description' in type ? type.description : undefined,
     },
     specifiedByURL: {
       type: GraphQLString,

package/type/scalars.d.ts

@@ -1,5 +1,15 @@
 import type { GraphQLNamedType } from './definition';
 import { GraphQLScalarType } from './definition';
+/**
+ * Maximum possible Int value as per GraphQL Spec (32-bit signed integer).
+ * n.b. This differs from JavaScript's numbers that are IEEE 754 doubles safe up-to 2^53 - 1
+ * */
+export declare const GRAPHQL_MAX_INT = 2147483647;
+/**
+ * Minimum possible Int value as per GraphQL Spec (32-bit signed integer).
+ * n.b. This differs from JavaScript's numbers that are IEEE 754 doubles safe starting at -(2^53 - 1)
+ * */
+export declare const GRAPHQL_MIN_INT = -2147483648;
 export declare const GraphQLInt: GraphQLScalarType<number, number>;
 export declare const GraphQLFloat: GraphQLScalarType<number, number>;
 export declare const GraphQLString: GraphQLScalarType<string, string>;

package/type/scalars.js

@@ -8,6 +8,8 @@ exports.GraphQLString =
   exports.GraphQLID =
   exports.GraphQLFloat =
   exports.GraphQLBoolean =
+  exports.GRAPHQL_MIN_INT =
+  exports.GRAPHQL_MAX_INT =
     void 0;
 exports.isSpecifiedScalarType = isSpecifiedScalarType;
 exports.specifiedScalarTypes = void 0;
@@ -16,21 +18,27 @@ var _inspect = require('../jsutils/inspect.js');
 
 var _isObjectLike = require('../jsutils/isObjectLike.js');
 
+var _GraphQLError = require('../error/GraphQLError.js');
+
 var _kinds = require('../language/kinds.js');
 
 var _printer = require('../language/printer.js');
 
-var _GraphQLError = require('../error/GraphQLError.js');
-
 var _definition = require('./definition.js');
 
-// As per the GraphQL Spec, Integers are only treated as valid when a valid
-// 32-bit signed integer, providing the broadest support across platforms.
-//
-// n.b. JavaScript's integers are safe between -(2^53 - 1) and 2^53 - 1 because
-// they are internally represented as IEEE 754 doubles.
-const MAX_INT = 2147483647;
-const MIN_INT = -2147483648;
+/**
+ * Maximum possible Int value as per GraphQL Spec (32-bit signed integer).
+ * n.b. This differs from JavaScript's numbers that are IEEE 754 doubles safe up-to 2^53 - 1
+ * */
+const GRAPHQL_MAX_INT = 2147483647;
+/**
+ * Minimum possible Int value as per GraphQL Spec (32-bit signed integer).
+ * n.b. This differs from JavaScript's numbers that are IEEE 754 doubles safe starting at -(2^53 - 1)
+ * */
+
+exports.GRAPHQL_MAX_INT = GRAPHQL_MAX_INT;
+const GRAPHQL_MIN_INT = -2147483648;
+exports.GRAPHQL_MIN_INT = GRAPHQL_MIN_INT;
 const GraphQLInt = new _definition.GraphQLScalarType({
   name: 'Int',
   description:
@@ -57,7 +65,7 @@ const GraphQLInt = new _definition.GraphQLScalarType({
       );
     }
 
-    if (num > MAX_INT || num < MIN_INT) {
+    if (num > GRAPHQL_MAX_INT || num < GRAPHQL_MIN_INT) {
       throw new _GraphQLError.GraphQLError(
         'Int cannot represent non 32-bit signed integer value: ' +
           (0, _inspect.inspect)(coercedValue),
@@ -76,7 +84,7 @@ const GraphQLInt = new _definition.GraphQLScalarType({
       );
     }
 
-    if (inputValue > MAX_INT || inputValue < MIN_INT) {
+    if (inputValue > GRAPHQL_MAX_INT || inputValue < GRAPHQL_MIN_INT) {
       throw new _GraphQLError.GraphQLError(
         `Int cannot represent non 32-bit signed integer value: ${inputValue}`,
       );
@@ -97,7 +105,7 @@ const GraphQLInt = new _definition.GraphQLScalarType({
 
     const num = parseInt(valueNode.value, 10);
 
-    if (num > MAX_INT || num < MIN_INT) {
+    if (num > GRAPHQL_MAX_INT || num < GRAPHQL_MIN_INT) {
       throw new _GraphQLError.GraphQLError(
         `Int cannot represent non 32-bit signed integer value: ${valueNode.value}`,
         valueNode,

package/type/scalars.mjs

@@ -1,16 +1,21 @@
 import { inspect } from '../jsutils/inspect.mjs';
 import { isObjectLike } from '../jsutils/isObjectLike.mjs';
+import { GraphQLError } from '../error/GraphQLError.mjs';
 import { Kind } from '../language/kinds.mjs';
 import { print } from '../language/printer.mjs';
-import { GraphQLError } from '../error/GraphQLError.mjs';
-import { GraphQLScalarType } from './definition.mjs'; // As per the GraphQL Spec, Integers are only treated as valid when a valid
-// 32-bit signed integer, providing the broadest support across platforms.
-//
-// n.b. JavaScript's integers are safe between -(2^53 - 1) and 2^53 - 1 because
-// they are internally represented as IEEE 754 doubles.
-
-const MAX_INT = 2147483647;
-const MIN_INT = -2147483648;
+import { GraphQLScalarType } from './definition.mjs';
+/**
+ * Maximum possible Int value as per GraphQL Spec (32-bit signed integer).
+ * n.b. This differs from JavaScript's numbers that are IEEE 754 doubles safe up-to 2^53 - 1
+ * */
+
+export const GRAPHQL_MAX_INT = 2147483647;
+/**
+ * Minimum possible Int value as per GraphQL Spec (32-bit signed integer).
+ * n.b. This differs from JavaScript's numbers that are IEEE 754 doubles safe starting at -(2^53 - 1)
+ * */
+
+export const GRAPHQL_MIN_INT = -2147483648;
 export const GraphQLInt = new GraphQLScalarType({
   name: 'Int',
   description:
@@ -35,7 +40,7 @@ export const GraphQLInt = new GraphQLScalarType({
       );
     }
 
-    if (num > MAX_INT || num < MIN_INT) {
+    if (num > GRAPHQL_MAX_INT || num < GRAPHQL_MIN_INT) {
       throw new GraphQLError(
         'Int cannot represent non 32-bit signed integer value: ' +
           inspect(coercedValue),
@@ -52,7 +57,7 @@ export const GraphQLInt = new GraphQLScalarType({
       );
     }
 
-    if (inputValue > MAX_INT || inputValue < MIN_INT) {
+    if (inputValue > GRAPHQL_MAX_INT || inputValue < GRAPHQL_MIN_INT) {
       throw new GraphQLError(
         `Int cannot represent non 32-bit signed integer value: ${inputValue}`,
       );
@@ -71,7 +76,7 @@ export const GraphQLInt = new GraphQLScalarType({
 
     const num = parseInt(valueNode.value, 10);
 
-    if (num > MAX_INT || num < MIN_INT) {
+    if (num > GRAPHQL_MAX_INT || num < GRAPHQL_MIN_INT) {
       throw new GraphQLError(
         `Int cannot represent non 32-bit signed integer value: ${valueNode.value}`,
         valueNode,

package/type/schema.d.ts

@@ -1,16 +1,16 @@
-import type { ObjMap } from '../jsutils/ObjMap';
 import type { Maybe } from '../jsutils/Maybe';
+import type { ObjMap } from '../jsutils/ObjMap';
 import type { GraphQLError } from '../error/GraphQLError';
 import type {
-  OperationTypeNode,
   SchemaDefinitionNode,
   SchemaExtensionNode,
 } from '../language/ast';
+import { OperationTypeNode } from '../language/ast';
 import type {
-  GraphQLNamedType,
   GraphQLAbstractType,
-  GraphQLObjectType,
   GraphQLInterfaceType,
+  GraphQLNamedType,
+  GraphQLObjectType,
 } from './definition';
 import type { GraphQLDirective } from './directives';
 /**