graphql 14.0.0 → 14.1.1

package/type/directives.js

@@ -4,9 +4,12 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.isDirective = isDirective;
+exports.assertDirective = assertDirective;
 exports.isSpecifiedDirective = isSpecifiedDirective;
 exports.specifiedDirectives = exports.GraphQLDeprecatedDirective = exports.DEFAULT_DEPRECATION_REASON = exports.GraphQLSkipDirective = exports.GraphQLIncludeDirective = exports.GraphQLDirective = void 0;
 
+var _objectEntries = _interopRequireDefault(require("../polyfills/objectEntries"));
+
 var _definition = require("./definition");
 
 var _scalars = require("./scalars");
@@ -19,16 +22,23 @@ var _instanceOf = _interopRequireDefault(require("../jsutils/instanceOf"));
 
 var _invariant = _interopRequireDefault(require("../jsutils/invariant"));
 
+var _inspect = _interopRequireDefault(require("../jsutils/inspect"));
+
 var _directiveLocation = require("../language/directiveLocation");
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
-function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _typeof(obj) { if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
 
 // eslint-disable-next-line no-redeclare
 function isDirective(directive) {
   return (0, _instanceOf.default)(directive, GraphQLDirective);
 }
+
+function assertDirective(directive) {
+  !isDirective(directive) ? (0, _invariant.default)(0, "Expected ".concat((0, _inspect.default)(directive), " to be a GraphQL directive.")) : void 0;
+  return directive;
+}
 /**
  * Directives are used by the GraphQL runtime as a way of modifying execution
  * behavior. Type system creators will usually not create these directly.
@@ -39,39 +49,25 @@ var GraphQLDirective =
 /*#__PURE__*/
 function () {
   function GraphQLDirective(config) {
-    _defineProperty(this, "name", void 0);
-
-    _defineProperty(this, "description", void 0);
-
-    _defineProperty(this, "locations", void 0);
-
-    _defineProperty(this, "args", void 0);
-
-    _defineProperty(this, "astNode", void 0);
-
     this.name = config.name;
     this.description = config.description;
     this.locations = config.locations;
     this.astNode = config.astNode;
     !config.name ? (0, _invariant.default)(0, 'Directive must be named.') : void 0;
-    !Array.isArray(config.locations) ? (0, _invariant.default)(0, 'Must provide locations for directive.') : void 0;
-    var args = config.args;
-
-    if (!args) {
-      this.args = [];
-    } else {
-      !!Array.isArray(args) ? (0, _invariant.default)(0, "@".concat(config.name, " args must be an object with argument names as keys.")) : void 0;
-      this.args = Object.keys(args).map(function (argName) {
-        var arg = args[argName];
-        return {
-          name: argName,
-          description: arg.description === undefined ? null : arg.description,
-          type: arg.type,
-          defaultValue: arg.defaultValue,
-          astNode: arg.astNode
-        };
-      });
-    }
+    !Array.isArray(config.locations) ? (0, _invariant.default)(0, "@".concat(config.name, " locations must be an Array.")) : void 0;
+    var args = config.args || {};
+    !(_typeof(args) === 'object' && !Array.isArray(args)) ? (0, _invariant.default)(0, "@".concat(config.name, " args must be an object with argument names as keys.")) : void 0;
+    this.args = (0, _objectEntries.default)(args).map(function (_ref) {
+      var argName = _ref[0],
+          arg = _ref[1];
+      return {
+        name: argName,
+        description: arg.description === undefined ? null : arg.description,
+        type: arg.type,
+        defaultValue: arg.defaultValue,
+        astNode: arg.astNode
+      };
+    });
   }
 
   var _proto = GraphQLDirective.prototype;

package/type/directives.js.flow

@@ -7,6 +7,7 @@
  * @flow strict
  */
 
+import objectEntries from '../polyfills/objectEntries';
 import type {
   GraphQLFieldConfigArgumentMap,
   GraphQLArgument,
@@ -17,6 +18,7 @@ import defineToStringTag from '../jsutils/defineToStringTag';
 import defineToJSON from '../jsutils/defineToJSON';
 import instanceOf from '../jsutils/instanceOf';
 import invariant from '../jsutils/invariant';
+import inspect from '../jsutils/inspect';
 import type { DirectiveDefinitionNode } from '../language/ast';
 import {
   DirectiveLocation,
@@ -34,6 +36,14 @@ export function isDirective(directive) {
   return instanceOf(directive, GraphQLDirective);
 }
 
+export function assertDirective(directive: mixed): GraphQLDirective {
+  invariant(
+    isDirective(directive),
+    `Expected ${inspect(directive)} to be a GraphQL directive.`,
+  );
+  return directive;
+}
+
 /**
  * Directives are used by the GraphQL runtime as a way of modifying execution
  * behavior. Type system creators will usually not create these directly.
@@ -53,28 +63,22 @@ export class GraphQLDirective {
     invariant(config.name, 'Directive must be named.');
     invariant(
       Array.isArray(config.locations),
-      'Must provide locations for directive.',
+      `@${config.name} locations must be an Array.`,
+    );
+
+    const args = config.args || {};
+    invariant(
+      typeof args === 'object' && !Array.isArray(args),
+      `@${config.name} args must be an object with argument names as keys.`,
     );
 
-    const args = config.args;
-    if (!args) {
-      this.args = [];
-    } else {
-      invariant(
-        !Array.isArray(args),
-        `@${config.name} args must be an object with argument names as keys.`,
-      );
-      this.args = Object.keys(args).map(argName => {
-        const arg = args[argName];
-        return {
-          name: argName,
-          description: arg.description === undefined ? null : arg.description,
-          type: arg.type,
-          defaultValue: arg.defaultValue,
-          astNode: arg.astNode,
-        };
-      });
-    }
+    this.args = objectEntries(args).map(([argName, arg]) => ({
+      name: argName,
+      description: arg.description === undefined ? null : arg.description,
+      type: arg.type,
+      defaultValue: arg.defaultValue,
+      astNode: arg.astNode,
+    }));
   }
 
   toString(): string {

package/type/directives.mjs

@@ -1,4 +1,4 @@
-function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _typeof(obj) { if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
 
 /**
  * Copyright (c) 2015-present, Facebook, Inc.
@@ -6,14 +6,16 @@ function _defineProperty(obj, key, value) { if (key in obj) { Object.definePrope
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- *  strict
+ * 
  */
+import objectEntries from '../polyfills/objectEntries';
 import { GraphQLNonNull } from './definition';
 import { GraphQLString, GraphQLBoolean } from './scalars';
 import defineToStringTag from '../jsutils/defineToStringTag';
 import defineToJSON from '../jsutils/defineToJSON';
 import instanceOf from '../jsutils/instanceOf';
 import invariant from '../jsutils/invariant';
+import inspect from '../jsutils/inspect';
 import { DirectiveLocation } from '../language/directiveLocation';
 /**
  * Test if the given value is a GraphQL directive.
@@ -23,6 +25,10 @@ import { DirectiveLocation } from '../language/directiveLocation';
 export function isDirective(directive) {
   return instanceOf(directive, GraphQLDirective);
 }
+export function assertDirective(directive) {
+  !isDirective(directive) ? invariant(0, "Expected ".concat(inspect(directive), " to be a GraphQL directive.")) : void 0;
+  return directive;
+}
 /**
  * Directives are used by the GraphQL runtime as a way of modifying execution
  * behavior. Type system creators will usually not create these directly.
@@ -32,39 +38,25 @@ export var GraphQLDirective =
 /*#__PURE__*/
 function () {
   function GraphQLDirective(config) {
-    _defineProperty(this, "name", void 0);
-
-    _defineProperty(this, "description", void 0);
-
-    _defineProperty(this, "locations", void 0);
-
-    _defineProperty(this, "args", void 0);
-
-    _defineProperty(this, "astNode", void 0);
-
     this.name = config.name;
     this.description = config.description;
     this.locations = config.locations;
     this.astNode = config.astNode;
     !config.name ? invariant(0, 'Directive must be named.') : void 0;
-    !Array.isArray(config.locations) ? invariant(0, 'Must provide locations for directive.') : void 0;
-    var args = config.args;
-
-    if (!args) {
-      this.args = [];
-    } else {
-      !!Array.isArray(args) ? invariant(0, "@".concat(config.name, " args must be an object with argument names as keys.")) : void 0;
-      this.args = Object.keys(args).map(function (argName) {
-        var arg = args[argName];
-        return {
-          name: argName,
-          description: arg.description === undefined ? null : arg.description,
-          type: arg.type,
-          defaultValue: arg.defaultValue,
-          astNode: arg.astNode
-        };
-      });
-    }
+    !Array.isArray(config.locations) ? invariant(0, "@".concat(config.name, " locations must be an Array.")) : void 0;
+    var args = config.args || {};
+    !(_typeof(args) === 'object' && !Array.isArray(args)) ? invariant(0, "@".concat(config.name, " args must be an object with argument names as keys.")) : void 0;
+    this.args = objectEntries(args).map(function (_ref) {
+      var argName = _ref[0],
+          arg = _ref[1];
+      return {
+        name: argName,
+        description: arg.description === undefined ? null : arg.description,
+        type: arg.type,
+        defaultValue: arg.defaultValue,
+        astNode: arg.astNode
+      };
+    });
   }
 
   var _proto = GraphQLDirective.prototype;

package/type/index.js

@@ -9,6 +9,12 @@ Object.defineProperty(exports, "isSchema", {
     return _schema.isSchema;
   }
 });
+Object.defineProperty(exports, "assertSchema", {
+  enumerable: true,
+  get: function get() {
+    return _schema.assertSchema;
+  }
+});
 Object.defineProperty(exports, "GraphQLSchema", {
   enumerable: true,
   get: function get() {
@@ -297,6 +303,12 @@ Object.defineProperty(exports, "isDirective", {
     return _directives.isDirective;
   }
 });
+Object.defineProperty(exports, "assertDirective", {
+  enumerable: true,
+  get: function get() {
+    return _directives.assertDirective;
+  }
+});
 Object.defineProperty(exports, "GraphQLDirective", {
   enumerable: true,
   get: function get() {

package/type/index.js.flow

@@ -10,6 +10,8 @@
 export {
   // Predicate
   isSchema,
+  // Assertion
+  assertSchema,
   // GraphQL Schema definition
   GraphQLSchema,
 } from './schema';
@@ -73,6 +75,8 @@ export {
 export {
   // Predicate
   isDirective,
+  // Assertion
+  assertDirective,
   // Directives Definition
   GraphQLDirective,
   // Built-in Directives defined by the Spec

package/type/index.mjs

@@ -4,10 +4,11 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- *  strict
+ * 
  */
 export { // Predicate
-isSchema, // GraphQL Schema definition
+isSchema, // Assertion
+assertSchema, // GraphQL Schema definition
 GraphQLSchema } from './schema';
 export { // Predicates
 isType, isScalarType, isObjectType, isInterfaceType, isUnionType, isEnumType, isInputObjectType, isListType, isNonNullType, isInputType, isOutputType, isLeafType, isCompositeType, isAbstractType, isWrappingType, isNullableType, isNamedType, isRequiredArgument, isRequiredInputField, // Assertions
@@ -16,7 +17,8 @@ getNullableType, getNamedType, // Definitions
 GraphQLScalarType, GraphQLObjectType, GraphQLInterfaceType, GraphQLUnionType, GraphQLEnumType, GraphQLInputObjectType, // Type Wrappers
 GraphQLList, GraphQLNonNull } from './definition';
 export { // Predicate
-isDirective, // Directives Definition
+isDirective, // Assertion
+assertDirective, // Directives Definition
 GraphQLDirective, // Built-in Directives defined by the Spec
 isSpecifiedDirective, specifiedDirectives, GraphQLIncludeDirective, GraphQLSkipDirective, GraphQLDeprecatedDirective, // Constant Deprecation Reason
 DEFAULT_DEPRECATION_REASON } from './directives';

package/type/introspection.js

@@ -6,9 +6,9 @@ Object.defineProperty(exports, "__esModule", {
 exports.isIntrospectionType = isIntrospectionType;
 exports.introspectionTypes = exports.TypeNameMetaFieldDef = exports.TypeMetaFieldDef = exports.SchemaMetaFieldDef = exports.__TypeKind = exports.TypeKind = exports.__EnumValue = exports.__InputValue = exports.__Field = exports.__Type = exports.__DirectiveLocation = exports.__Directive = exports.__Schema = void 0;
 
-var _isInvalid = _interopRequireDefault(require("../jsutils/isInvalid"));
+var _objectValues = _interopRequireDefault(require("../polyfills/objectValues"));
 
-var _objectValues = _interopRequireDefault(require("../jsutils/objectValues"));
+var _isInvalid = _interopRequireDefault(require("../jsutils/isInvalid"));
 
 var _astFromValue = require("../utilities/astFromValue");
 
@@ -28,7 +28,7 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- *  strict
+ * 
  */
 var __Schema = new _definition.GraphQLObjectType({
   name: '__Schema',

package/type/introspection.js.flow

@@ -7,8 +7,8 @@
  * @flow strict
  */
 
+import objectValues from '../polyfills/objectValues';
 import isInvalid from '../jsutils/isInvalid';
-import objectValues from '../jsutils/objectValues';
 import { astFromValue } from '../utilities/astFromValue';
 import { print } from '../language/printer';
 import {

package/type/introspection.mjs

@@ -4,10 +4,10 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- *  strict
+ * 
  */
+import objectValues from '../polyfills/objectValues';
 import isInvalid from '../jsutils/isInvalid';
-import objectValues from '../jsutils/objectValues';
 import { astFromValue } from '../utilities/astFromValue';
 import { print } from '../language/printer';
 import { GraphQLObjectType, GraphQLEnumType, GraphQLList, GraphQLNonNull, isScalarType, isObjectType, isInterfaceType, isUnionType, isEnumType, isInputObjectType, isListType, isNonNullType, isAbstractType, isNamedType } from './definition';

package/type/scalars.js

@@ -6,11 +6,11 @@ Object.defineProperty(exports, "__esModule", {
 exports.isSpecifiedScalarType = isSpecifiedScalarType;
 exports.specifiedScalarTypes = exports.GraphQLID = exports.GraphQLBoolean = exports.GraphQLString = exports.GraphQLFloat = exports.GraphQLInt = void 0;
 
-var _inspect = _interopRequireDefault(require("../jsutils/inspect"));
+var _isFinite = _interopRequireDefault(require("../polyfills/isFinite"));
 
-var _isFinite = _interopRequireDefault(require("../jsutils/isFinite"));
+var _isInteger = _interopRequireDefault(require("../polyfills/isInteger"));
 
-var _isInteger = _interopRequireDefault(require("../jsutils/isInteger"));
+var _inspect = _interopRequireDefault(require("../jsutils/inspect"));
 
 var _definition = require("./definition");
 
@@ -18,14 +18,8 @@ var _kinds = require("../language/kinds");
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
-/**
- * Copyright (c) 2015-present, Facebook, Inc.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- *
- *  strict
- */
+function _typeof(obj) { if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
+
 // As per the GraphQL Spec, Integers are only treated as valid when a valid
 // 32-bit signed integer, providing the broadest support across platforms.
 //
@@ -115,35 +109,54 @@ function coerceFloat(value) {
 
 var GraphQLFloat = new _definition.GraphQLScalarType({
   name: 'Float',
-  description: 'The `Float` scalar type represents signed double-precision fractional ' + 'values as specified by ' + '[IEEE 754](http://en.wikipedia.org/wiki/IEEE_floating_point). ',
+  description: 'The `Float` scalar type represents signed double-precision fractional ' + 'values as specified by ' + '[IEEE 754](https://en.wikipedia.org/wiki/IEEE_floating_point). ',
   serialize: serializeFloat,
   parseValue: coerceFloat,
   parseLiteral: function parseLiteral(ast) {
     return ast.kind === _kinds.Kind.FLOAT || ast.kind === _kinds.Kind.INT ? parseFloat(ast.value) : undefined;
   }
-});
+}); // Support serializing objects with custom valueOf() or toJSON() functions -
+// a common way to represent a complex value which can be represented as
+// a string (ex: MongoDB id objects).
+
 exports.GraphQLFloat = GraphQLFloat;
 
-function serializeString(value) {
-  // Support serializing objects with custom valueOf() functions - a common way
-  // to represent an complex value which can be represented as a string
-  // (ex: MongoDB id objects).
-  var result = value && typeof value.valueOf === 'function' ? value.valueOf() : value; // Serialize string, boolean and number values to a string, but do not
+function serializeObject(value) {
+  if (_typeof(value) === 'object' && value !== null) {
+    if (typeof value.valueOf === 'function') {
+      var valueOfResult = value.valueOf();
+
+      if (_typeof(valueOfResult) !== 'object') {
+        return valueOfResult;
+      }
+    }
+
+    if (typeof value.toJSON === 'function') {
+      // $FlowFixMe(>=0.90.0)
+      return value.toJSON();
+    }
+  }
+
+  return value;
+}
+
+function serializeString(rawValue) {
+  var value = serializeObject(rawValue); // Serialize string, boolean and number values to a string, but do not
   // attempt to coerce object, function, symbol, or other types as strings.
 
-  if (typeof result === 'string') {
-    return result;
+  if (typeof value === 'string') {
+    return value;
   }
 
-  if (typeof result === 'boolean') {
-    return result ? 'true' : 'false';
+  if (typeof value === 'boolean') {
+    return value ? 'true' : 'false';
   }
 
-  if ((0, _isFinite.default)(result)) {
-    return result.toString();
+  if ((0, _isFinite.default)(value)) {
+    return value.toString();
   }
 
-  throw new TypeError("String cannot represent value: ".concat((0, _inspect.default)(value)));
+  throw new TypeError("String cannot represent value: ".concat((0, _inspect.default)(rawValue)));
 }
 
 function coerceString(value) {
@@ -196,20 +209,18 @@ var GraphQLBoolean = new _definition.GraphQLScalarType({
 });
 exports.GraphQLBoolean = GraphQLBoolean;
 
-function serializeID(value) {
-  // Support serializing objects with custom valueOf() functions - a common way
-  // to represent an object identifier (ex. MongoDB).
-  var result = value && typeof value.valueOf === 'function' ? value.valueOf() : value;
+function serializeID(rawValue) {
+  var value = serializeObject(rawValue);
 
-  if (typeof result === 'string') {
-    return result;
+  if (typeof value === 'string') {
+    return value;
   }
 
-  if ((0, _isInteger.default)(result)) {
-    return String(result);
+  if ((0, _isInteger.default)(value)) {
+    return String(value);
   }
 
-  throw new TypeError("ID cannot represent value: ".concat((0, _inspect.default)(value)));
+  throw new TypeError("ID cannot represent value: ".concat((0, _inspect.default)(rawValue)));
 }
 
 function coerceID(value) {

package/type/scalars.js.flow

@@ -7,9 +7,9 @@
  * @flow strict
  */
 
+import isFinite from '../polyfills/isFinite';
+import isInteger from '../polyfills/isInteger';
 import inspect from '../jsutils/inspect';
-import isFinite from '../jsutils/isFinite';
-import isInteger from '../jsutils/isInteger';
 import { GraphQLScalarType, isNamedType } from './definition';
 import { Kind } from '../language/kinds';
 
@@ -107,7 +107,7 @@ export const GraphQLFloat = new GraphQLScalarType({
   description:
     'The `Float` scalar type represents signed double-precision fractional ' +
     'values as specified by ' +
-    '[IEEE 754](http://en.wikipedia.org/wiki/IEEE_floating_point). ',
+    '[IEEE 754](https://en.wikipedia.org/wiki/IEEE_floating_point). ',
   serialize: serializeFloat,
   parseValue: coerceFloat,
   parseLiteral(ast) {
@@ -117,24 +117,40 @@ export const GraphQLFloat = new GraphQLScalarType({
   },
 });
 
-function serializeString(value: mixed): string {
-  // Support serializing objects with custom valueOf() functions - a common way
-  // to represent an complex value which can be represented as a string
-  // (ex: MongoDB id objects).
-  const result =
-    value && typeof value.valueOf === 'function' ? value.valueOf() : value;
+// Support serializing objects with custom valueOf() or toJSON() functions -
+// a common way to represent a complex value which can be represented as
+// a string (ex: MongoDB id objects).
+function serializeObject(value: mixed): mixed {
+  if (typeof value === 'object' && value !== null) {
+    if (typeof value.valueOf === 'function') {
+      const valueOfResult = value.valueOf();
+      if (typeof valueOfResult !== 'object') {
+        return valueOfResult;
+      }
+    }
+    if (typeof value.toJSON === 'function') {
+      // $FlowFixMe(>=0.90.0)
+      return value.toJSON();
+    }
+  }
+  return value;
+}
+
+function serializeString(rawValue: mixed): string {
+  const value = serializeObject(rawValue);
+
   // Serialize string, boolean and number values to a string, but do not
   // attempt to coerce object, function, symbol, or other types as strings.
-  if (typeof result === 'string') {
-    return result;
+  if (typeof value === 'string') {
+    return value;
   }
-  if (typeof result === 'boolean') {
-    return result ? 'true' : 'false';
+  if (typeof value === 'boolean') {
+    return value ? 'true' : 'false';
   }
-  if (isFinite(result)) {
-    return result.toString();
+  if (isFinite(value)) {
+    return value.toString();
   }
-  throw new TypeError(`String cannot represent value: ${inspect(value)}`);
+  throw new TypeError(`String cannot represent value: ${inspect(rawValue)}`);
 }
 
 function coerceString(value: mixed): string {
@@ -190,18 +206,16 @@ export const GraphQLBoolean = new GraphQLScalarType({
   },
 });
 
-function serializeID(value: mixed): string {
-  // Support serializing objects with custom valueOf() functions - a common way
-  // to represent an object identifier (ex. MongoDB).
-  const result =
-    value && typeof value.valueOf === 'function' ? value.valueOf() : value;
-  if (typeof result === 'string') {
-    return result;
+function serializeID(rawValue: mixed): string {
+  const value = serializeObject(rawValue);
+
+  if (typeof value === 'string') {
+    return value;
   }
-  if (isInteger(result)) {
-    return String(result);
+  if (isInteger(value)) {
+    return String(value);
   }
-  throw new TypeError(`ID cannot represent value: ${inspect(value)}`);
+  throw new TypeError(`ID cannot represent value: ${inspect(rawValue)}`);
 }
 
 function coerceID(value: mixed): string {