graphql 16.2.0 → 16.3.0

package/utilities/extendSchema.js

@@ -6,33 +6,33 @@ Object.defineProperty(exports, '__esModule', {
 exports.extendSchema = extendSchema;
 exports.extendSchemaImpl = extendSchemaImpl;
 
-var _keyMap = require('../jsutils/keyMap.js');
+var _devAssert = require('../jsutils/devAssert.js');
 
 var _inspect = require('../jsutils/inspect.js');
 
-var _mapValue = require('../jsutils/mapValue.js');
-
 var _invariant = require('../jsutils/invariant.js');
 
-var _devAssert = require('../jsutils/devAssert.js');
+var _keyMap = require('../jsutils/keyMap.js');
+
+var _mapValue = require('../jsutils/mapValue.js');
 
 var _kinds = require('../language/kinds.js');
 
 var _predicates = require('../language/predicates.js');
 
-var _validate = require('../validation/validate.js');
+var _definition = require('../type/definition.js');
 
-var _values = require('../execution/values.js');
+var _directives = require('../type/directives.js');
 
-var _schema = require('../type/schema.js');
+var _introspection = require('../type/introspection.js');
 
 var _scalars = require('../type/scalars.js');
 
-var _introspection = require('../type/introspection.js');
+var _schema = require('../type/schema.js');
 
-var _directives = require('../type/directives.js');
+var _validate = require('../validation/validate.js');
 
-var _definition = require('../type/definition.js');
+var _values = require('../execution/values.js');
 
 var _valueFromAST = require('./valueFromAST.js');
 

package/utilities/extendSchema.mjs

@@ -1,47 +1,47 @@
-import { keyMap } from '../jsutils/keyMap.mjs';
+import { devAssert } from '../jsutils/devAssert.mjs';
 import { inspect } from '../jsutils/inspect.mjs';
-import { mapValue } from '../jsutils/mapValue.mjs';
 import { invariant } from '../jsutils/invariant.mjs';
-import { devAssert } from '../jsutils/devAssert.mjs';
+import { keyMap } from '../jsutils/keyMap.mjs';
+import { mapValue } from '../jsutils/mapValue.mjs';
 import { Kind } from '../language/kinds.mjs';
 import {
   isTypeDefinitionNode,
   isTypeExtensionNode,
 } from '../language/predicates.mjs';
-import { assertValidSDLExtension } from '../validation/validate.mjs';
-import { getDirectiveValues } from '../execution/values.mjs';
-import { assertSchema, GraphQLSchema } from '../type/schema.mjs';
-import {
-  specifiedScalarTypes,
-  isSpecifiedScalarType,
-} from '../type/scalars.mjs';
 import {
-  introspectionTypes,
-  isIntrospectionType,
-} from '../type/introspection.mjs';
-import {
-  GraphQLDirective,
-  GraphQLDeprecatedDirective,
-  GraphQLSpecifiedByDirective,
-} from '../type/directives.mjs';
-import {
-  isScalarType,
-  isObjectType,
-  isInterfaceType,
-  isUnionType,
-  isListType,
-  isNonNullType,
-  isEnumType,
-  isInputObjectType,
+  GraphQLEnumType,
+  GraphQLInputObjectType,
+  GraphQLInterfaceType,
   GraphQLList,
   GraphQLNonNull,
-  GraphQLScalarType,
   GraphQLObjectType,
-  GraphQLInterfaceType,
+  GraphQLScalarType,
   GraphQLUnionType,
-  GraphQLEnumType,
-  GraphQLInputObjectType,
+  isEnumType,
+  isInputObjectType,
+  isInterfaceType,
+  isListType,
+  isNonNullType,
+  isObjectType,
+  isScalarType,
+  isUnionType,
 } from '../type/definition.mjs';
+import {
+  GraphQLDeprecatedDirective,
+  GraphQLDirective,
+  GraphQLSpecifiedByDirective,
+} from '../type/directives.mjs';
+import {
+  introspectionTypes,
+  isIntrospectionType,
+} from '../type/introspection.mjs';
+import {
+  isSpecifiedScalarType,
+  specifiedScalarTypes,
+} from '../type/scalars.mjs';
+import { assertSchema, GraphQLSchema } from '../type/schema.mjs';
+import { assertValidSDLExtension } from '../validation/validate.mjs';
+import { getDirectiveValues } from '../execution/values.mjs';
 import { valueFromAST } from './valueFromAST.mjs';
 
 /**

package/utilities/findBreakingChanges.js

@@ -7,24 +7,22 @@ exports.DangerousChangeType = exports.BreakingChangeType = void 0;
 exports.findBreakingChanges = findBreakingChanges;
 exports.findDangerousChanges = findDangerousChanges;
 
-var _keyMap = require('../jsutils/keyMap.js');
-
 var _inspect = require('../jsutils/inspect.js');
 
 var _invariant = require('../jsutils/invariant.js');
 
-var _naturalCompare = require('../jsutils/naturalCompare.js');
+var _keyMap = require('../jsutils/keyMap.js');
 
 var _printer = require('../language/printer.js');
 
-var _visitor = require('../language/visitor.js');
+var _definition = require('../type/definition.js');
 
 var _scalars = require('../type/scalars.js');
 
-var _definition = require('../type/definition.js');
-
 var _astFromValue = require('./astFromValue.js');
 
+var _sortValueNode = require('./sortValueNode.js');
+
 let BreakingChangeType;
 exports.BreakingChangeType = BreakingChangeType;
 
@@ -515,20 +513,7 @@ function typeKindName(type) {
 function stringifyValue(value, type) {
   const ast = (0, _astFromValue.astFromValue)(value, type);
   ast != null || (0, _invariant.invariant)(false);
-  const sortedAST = (0, _visitor.visit)(ast, {
-    ObjectValue(objectNode) {
-      // Make a copy since sort mutates array
-      const fields = [...objectNode.fields];
-      fields.sort((fieldA, fieldB) =>
-        (0, _naturalCompare.naturalCompare)(
-          fieldA.name.value,
-          fieldB.name.value,
-        ),
-      );
-      return { ...objectNode, fields };
-    },
-  });
-  return (0, _printer.print)(sortedAST);
+  return (0, _printer.print)((0, _sortValueNode.sortValueNode)(ast));
 }
 
 function diff(oldArray, newArray) {

package/utilities/findBreakingChanges.mjs

@@ -1,24 +1,23 @@
-import { keyMap } from '../jsutils/keyMap.mjs';
 import { inspect } from '../jsutils/inspect.mjs';
 import { invariant } from '../jsutils/invariant.mjs';
-import { naturalCompare } from '../jsutils/naturalCompare.mjs';
+import { keyMap } from '../jsutils/keyMap.mjs';
 import { print } from '../language/printer.mjs';
-import { visit } from '../language/visitor.mjs';
-import { isSpecifiedScalarType } from '../type/scalars.mjs';
 import {
-  isScalarType,
-  isObjectType,
-  isInterfaceType,
-  isUnionType,
   isEnumType,
   isInputObjectType,
-  isNonNullType,
+  isInterfaceType,
   isListType,
   isNamedType,
+  isNonNullType,
+  isObjectType,
   isRequiredArgument,
   isRequiredInputField,
+  isScalarType,
+  isUnionType,
 } from '../type/definition.mjs';
+import { isSpecifiedScalarType } from '../type/scalars.mjs';
 import { astFromValue } from './astFromValue.mjs';
+import { sortValueNode } from './sortValueNode.mjs';
 export let BreakingChangeType;
 
 (function (BreakingChangeType) {
@@ -483,17 +482,7 @@ function typeKindName(type) {
 function stringifyValue(value, type) {
   const ast = astFromValue(value, type);
   ast != null || invariant(false);
-  const sortedAST = visit(ast, {
-    ObjectValue(objectNode) {
-      // Make a copy since sort mutates array
-      const fields = [...objectNode.fields];
-      fields.sort((fieldA, fieldB) =>
-        naturalCompare(fieldA.name.value, fieldB.name.value),
-      );
-      return { ...objectNode, fields };
-    },
-  });
-  return print(sortedAST);
+  return print(sortValueNode(ast));
 }
 
 function diff(oldArray, newArray) {

package/utilities/getIntrospectionQuery.d.ts

@@ -27,6 +27,10 @@ export interface IntrospectionOptions {
    */
   inputValueDeprecation?: boolean;
 }
+/**
+ * Produce the GraphQL query recommended for a full schema introspection.
+ * Accepts optional IntrospectionOptions.
+ */
 export declare function getIntrospectionQuery(
   options?: IntrospectionOptions,
 ): string;

package/utilities/getIntrospectionQuery.js

@@ -5,6 +5,10 @@ Object.defineProperty(exports, '__esModule', {
 });
 exports.getIntrospectionQuery = getIntrospectionQuery;
 
+/**
+ * Produce the GraphQL query recommended for a full schema introspection.
+ * Accepts optional IntrospectionOptions.
+ */
 function getIntrospectionQuery(options) {
   const optionsWithDefault = {
     descriptions: true,

package/utilities/getIntrospectionQuery.mjs

@@ -1,3 +1,7 @@
+/**
+ * Produce the GraphQL query recommended for a full schema introspection.
+ * Accepts optional IntrospectionOptions.
+ */
 export function getIntrospectionQuery(options) {
   const optionsWithDefault = {
     descriptions: true,

package/utilities/getOperationRootType.d.ts

@@ -2,8 +2,8 @@ import type {
   OperationDefinitionNode,
   OperationTypeDefinitionNode,
 } from '../language/ast';
-import type { GraphQLSchema } from '../type/schema';
 import type { GraphQLObjectType } from '../type/definition';
+import type { GraphQLSchema } from '../type/schema';
 /**
  * Extracts the root type of the operation from the schema.
  *

package/utilities/index.d.ts

@@ -1,7 +1,3 @@
-/**
- * Produce the GraphQL query recommended for a full schema introspection.
- * Accepts optional IntrospectionOptions.
- */
 export { getIntrospectionQuery } from './getIntrospectionQuery';
 export type {
   IntrospectionOptions,
@@ -27,54 +23,34 @@ export type {
   IntrospectionEnumValue,
   IntrospectionDirective,
 } from './getIntrospectionQuery';
-/** Gets the target Operation from a Document. */
 export { getOperationAST } from './getOperationAST';
-/** Gets the Type for the target Operation AST. */
 export { getOperationRootType } from './getOperationRootType';
-/** Convert a GraphQLSchema to an IntrospectionQuery. */
 export { introspectionFromSchema } from './introspectionFromSchema';
-/** Build a GraphQLSchema from an introspection result. */
 export { buildClientSchema } from './buildClientSchema';
-/** Build a GraphQLSchema from GraphQL Schema language. */
 export { buildASTSchema, buildSchema } from './buildASTSchema';
 export type { BuildSchemaOptions } from './buildASTSchema';
-/** Extends an existing GraphQLSchema from a parsed GraphQL Schema language AST. */
 export { extendSchema } from './extendSchema';
-/** Sort a GraphQLSchema. */
 export { lexicographicSortSchema } from './lexicographicSortSchema';
-/** Print a GraphQLSchema to GraphQL Schema language. */
 export {
   printSchema,
   printType,
   printIntrospectionSchema,
 } from './printSchema';
-/** Create a GraphQLType from a GraphQL language AST. */
 export { typeFromAST } from './typeFromAST';
-/** Create a JavaScript value from a GraphQL language AST with a type. */
 export { valueFromAST } from './valueFromAST';
-/** Create a JavaScript value from a GraphQL language AST without a type. */
 export { valueFromASTUntyped } from './valueFromASTUntyped';
-/** Create a GraphQL language AST from a JavaScript value. */
 export { astFromValue } from './astFromValue';
-/** A helper to use within recursive-descent visitors which need to be aware of the GraphQL type system. */
 export { TypeInfo, visitWithTypeInfo } from './TypeInfo';
-/** Coerces a JavaScript value to a GraphQL type, or produces errors. */
 export { coerceInputValue } from './coerceInputValue';
-/** Concatenates multiple AST together. */
 export { concatAST } from './concatAST';
-/** Separates an AST into an AST per Operation. */
 export { separateOperations } from './separateOperations';
-/** Strips characters that are not significant to the validity or execution of a GraphQL document. */
 export { stripIgnoredCharacters } from './stripIgnoredCharacters';
-/** Comparators for types */
 export {
   isEqualType,
   isTypeSubTypeOf,
   doTypesOverlap,
 } from './typeComparators';
-/** Asserts that a string is a valid GraphQL name */
 export { assertValidName, isValidNameError } from './assertValidName';
-/** Compares two GraphQLSchemas and detects breaking changes. */
 export {
   BreakingChangeType,
   DangerousChangeType,
@@ -82,5 +58,4 @@ export {
   findDangerousChanges,
 } from './findBreakingChanges';
 export type { BreakingChange, DangerousChange } from './findBreakingChanges';
-/** Wrapper type that contains DocumentNode and types that can be deduced from it. */
 export type { TypedQueryDocumentNode } from './typedQueryDocumentNode';

package/utilities/index.mjs

@@ -1,74 +1,51 @@
-/**
- * Produce the GraphQL query recommended for a full schema introspection.
- * Accepts optional IntrospectionOptions.
- */
+// Produce the GraphQL query recommended for a full schema introspection.
 export { getIntrospectionQuery } from './getIntrospectionQuery.mjs';
+// Gets the target Operation from a Document.
+export { getOperationAST } from './getOperationAST.mjs'; // Gets the Type for the target Operation AST.
 
-/** Gets the target Operation from a Document. */
-export { getOperationAST } from './getOperationAST.mjs';
-/** Gets the Type for the target Operation AST. */
+export { getOperationRootType } from './getOperationRootType.mjs'; // Convert a GraphQLSchema to an IntrospectionQuery.
 
-export { getOperationRootType } from './getOperationRootType.mjs';
-/** Convert a GraphQLSchema to an IntrospectionQuery. */
+export { introspectionFromSchema } from './introspectionFromSchema.mjs'; // Build a GraphQLSchema from an introspection result.
 
-export { introspectionFromSchema } from './introspectionFromSchema.mjs';
-/** Build a GraphQLSchema from an introspection result. */
-
-export { buildClientSchema } from './buildClientSchema.mjs';
-/** Build a GraphQLSchema from GraphQL Schema language. */
+export { buildClientSchema } from './buildClientSchema.mjs'; // Build a GraphQLSchema from GraphQL Schema language.
 
 export { buildASTSchema, buildSchema } from './buildASTSchema.mjs';
+// Extends an existing GraphQLSchema from a parsed GraphQL Schema language AST.
+export { extendSchema } from './extendSchema.mjs'; // Sort a GraphQLSchema.
 
-/** Extends an existing GraphQLSchema from a parsed GraphQL Schema language AST. */
-export { extendSchema } from './extendSchema.mjs';
-/** Sort a GraphQLSchema. */
-
-export { lexicographicSortSchema } from './lexicographicSortSchema.mjs';
-/** Print a GraphQLSchema to GraphQL Schema language. */
+export { lexicographicSortSchema } from './lexicographicSortSchema.mjs'; // Print a GraphQLSchema to GraphQL Schema language.
 
 export {
   printSchema,
   printType,
   printIntrospectionSchema,
-} from './printSchema.mjs';
-/** Create a GraphQLType from a GraphQL language AST. */
+} from './printSchema.mjs'; // Create a GraphQLType from a GraphQL language AST.
 
-export { typeFromAST } from './typeFromAST.mjs';
-/** Create a JavaScript value from a GraphQL language AST with a type. */
+export { typeFromAST } from './typeFromAST.mjs'; // Create a JavaScript value from a GraphQL language AST with a type.
 
-export { valueFromAST } from './valueFromAST.mjs';
-/** Create a JavaScript value from a GraphQL language AST without a type. */
+export { valueFromAST } from './valueFromAST.mjs'; // Create a JavaScript value from a GraphQL language AST without a type.
 
-export { valueFromASTUntyped } from './valueFromASTUntyped.mjs';
-/** Create a GraphQL language AST from a JavaScript value. */
+export { valueFromASTUntyped } from './valueFromASTUntyped.mjs'; // Create a GraphQL language AST from a JavaScript value.
 
-export { astFromValue } from './astFromValue.mjs';
-/** A helper to use within recursive-descent visitors which need to be aware of the GraphQL type system. */
+export { astFromValue } from './astFromValue.mjs'; // A helper to use within recursive-descent visitors which need to be aware of the GraphQL type system.
 
-export { TypeInfo, visitWithTypeInfo } from './TypeInfo.mjs';
-/** Coerces a JavaScript value to a GraphQL type, or produces errors. */
+export { TypeInfo, visitWithTypeInfo } from './TypeInfo.mjs'; // Coerces a JavaScript value to a GraphQL type, or produces errors.
 
-export { coerceInputValue } from './coerceInputValue.mjs';
-/** Concatenates multiple AST together. */
+export { coerceInputValue } from './coerceInputValue.mjs'; // Concatenates multiple AST together.
 
-export { concatAST } from './concatAST.mjs';
-/** Separates an AST into an AST per Operation. */
+export { concatAST } from './concatAST.mjs'; // Separates an AST into an AST per Operation.
 
-export { separateOperations } from './separateOperations.mjs';
-/** Strips characters that are not significant to the validity or execution of a GraphQL document. */
+export { separateOperations } from './separateOperations.mjs'; // Strips characters that are not significant to the validity or execution of a GraphQL document.
 
-export { stripIgnoredCharacters } from './stripIgnoredCharacters.mjs';
-/** Comparators for types */
+export { stripIgnoredCharacters } from './stripIgnoredCharacters.mjs'; // Comparators for types
 
 export {
   isEqualType,
   isTypeSubTypeOf,
   doTypesOverlap,
-} from './typeComparators.mjs';
-/** Asserts that a string is a valid GraphQL name */
+} from './typeComparators.mjs'; // Asserts that a string is a valid GraphQL name
 
-export { assertValidName, isValidNameError } from './assertValidName.mjs';
-/** Compares two GraphQLSchemas and detects breaking changes. */
+export { assertValidName, isValidNameError } from './assertValidName.mjs'; // Compares two GraphQLSchemas and detects breaking changes.
 
 export {
   BreakingChangeType,

package/utilities/introspectionFromSchema.d.ts

@@ -1,7 +1,7 @@
 import type { GraphQLSchema } from '../type/schema';
 import type {
-  IntrospectionQuery,
   IntrospectionOptions,
+  IntrospectionQuery,
 } from './getIntrospectionQuery';
 /**
  * Build an IntrospectionQuery from a GraphQLSchema

package/utilities/lexicographicSortSchema.js

@@ -13,13 +13,13 @@ var _keyValMap = require('../jsutils/keyValMap.js');
 
 var _naturalCompare = require('../jsutils/naturalCompare.js');
 
-var _schema = require('../type/schema.js');
+var _definition = require('../type/definition.js');
 
 var _directives = require('../type/directives.js');
 
 var _introspection = require('../type/introspection.js');
 
-var _definition = require('../type/definition.js');
+var _schema = require('../type/schema.js');
 
 /**
  * Sort GraphQLSchema.

package/utilities/lexicographicSortSchema.mjs

@@ -2,26 +2,26 @@ import { inspect } from '../jsutils/inspect.mjs';
 import { invariant } from '../jsutils/invariant.mjs';
 import { keyValMap } from '../jsutils/keyValMap.mjs';
 import { naturalCompare } from '../jsutils/naturalCompare.mjs';
-import { GraphQLSchema } from '../type/schema.mjs';
-import { GraphQLDirective } from '../type/directives.mjs';
-import { isIntrospectionType } from '../type/introspection.mjs';
 import {
+  GraphQLEnumType,
+  GraphQLInputObjectType,
+  GraphQLInterfaceType,
   GraphQLList,
   GraphQLNonNull,
   GraphQLObjectType,
-  GraphQLInterfaceType,
   GraphQLUnionType,
-  GraphQLEnumType,
-  GraphQLInputObjectType,
+  isEnumType,
+  isInputObjectType,
+  isInterfaceType,
   isListType,
   isNonNullType,
-  isScalarType,
   isObjectType,
-  isInterfaceType,
+  isScalarType,
   isUnionType,
-  isEnumType,
-  isInputObjectType,
 } from '../type/definition.mjs';
+import { GraphQLDirective } from '../type/directives.mjs';
+import { isIntrospectionType } from '../type/introspection.mjs';
+import { GraphQLSchema } from '../type/schema.mjs';
 /**
  * Sort GraphQLSchema.
  *

package/utilities/printSchema.d.ts

@@ -1,5 +1,5 @@
-import type { GraphQLSchema } from '../type/schema';
 import type { GraphQLNamedType } from '../type/definition';
+import type { GraphQLSchema } from '../type/schema';
 export declare function printSchema(schema: GraphQLSchema): string;
 export declare function printIntrospectionSchema(schema: GraphQLSchema): string;
 export declare function printType(type: GraphQLNamedType): string;

package/utilities/printSchema.js

@@ -11,20 +11,20 @@ var _inspect = require('../jsutils/inspect.js');
 
 var _invariant = require('../jsutils/invariant.js');
 
+var _blockString = require('../language/blockString.js');
+
 var _kinds = require('../language/kinds.js');
 
 var _printer = require('../language/printer.js');
 
-var _blockString = require('../language/blockString.js');
+var _definition = require('../type/definition.js');
+
+var _directives = require('../type/directives.js');
 
 var _introspection = require('../type/introspection.js');
 
 var _scalars = require('../type/scalars.js');
 
-var _directives = require('../type/directives.js');
-
-var _definition = require('../type/definition.js');
-
 var _astFromValue = require('./astFromValue.js');
 
 function printSchema(schema) {

package/utilities/printSchema.mjs

@@ -1,22 +1,22 @@
 import { inspect } from '../jsutils/inspect.mjs';
 import { invariant } from '../jsutils/invariant.mjs';
+import { isPrintableAsBlockString } from '../language/blockString.mjs';
 import { Kind } from '../language/kinds.mjs';
 import { print } from '../language/printer.mjs';
-import { isPrintableAsBlockString } from '../language/blockString.mjs';
-import { isIntrospectionType } from '../type/introspection.mjs';
-import { isSpecifiedScalarType } from '../type/scalars.mjs';
 import {
-  DEFAULT_DEPRECATION_REASON,
-  isSpecifiedDirective,
-} from '../type/directives.mjs';
-import {
-  isScalarType,
-  isObjectType,
-  isInterfaceType,
-  isUnionType,
   isEnumType,
   isInputObjectType,
+  isInterfaceType,
+  isObjectType,
+  isScalarType,
+  isUnionType,
 } from '../type/definition.mjs';
+import {
+  DEFAULT_DEPRECATION_REASON,
+  isSpecifiedDirective,
+} from '../type/directives.mjs';
+import { isIntrospectionType } from '../type/introspection.mjs';
+import { isSpecifiedScalarType } from '../type/scalars.mjs';
 import { astFromValue } from './astFromValue.mjs';
 export function printSchema(schema) {
   return printFilteredSchema(

package/utilities/sortValueNode.d.ts

@@ -0,0 +1,9 @@
+import type { ValueNode } from '../language/ast';
+/**
+ * Sort ValueNode.
+ *
+ * This function returns a sorted copy of the given ValueNode.
+ *
+ * @internal
+ */
+export declare function sortValueNode(valueNode: ValueNode): ValueNode;

package/utilities/sortValueNode.js

@@ -0,0 +1,47 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', {
+  value: true,
+});
+exports.sortValueNode = sortValueNode;
+
+var _naturalCompare = require('../jsutils/naturalCompare.js');
+
+var _kinds = require('../language/kinds.js');
+
+/**
+ * Sort ValueNode.
+ *
+ * This function returns a sorted copy of the given ValueNode.
+ *
+ * @internal
+ */
+function sortValueNode(valueNode) {
+  switch (valueNode.kind) {
+    case _kinds.Kind.OBJECT:
+      return { ...valueNode, fields: sortFields(valueNode.fields) };
+
+    case _kinds.Kind.LIST:
+      return { ...valueNode, values: valueNode.values.map(sortValueNode) };
+
+    case _kinds.Kind.INT:
+    case _kinds.Kind.FLOAT:
+    case _kinds.Kind.STRING:
+    case _kinds.Kind.BOOLEAN:
+    case _kinds.Kind.NULL:
+    case _kinds.Kind.ENUM:
+    case _kinds.Kind.VARIABLE:
+      return valueNode;
+  }
+}
+
+function sortFields(fields) {
+  return fields
+    .map((fieldNode) => ({
+      ...fieldNode,
+      value: sortValueNode(fieldNode.value),
+    }))
+    .sort((fieldA, fieldB) =>
+      (0, _naturalCompare.naturalCompare)(fieldA.name.value, fieldB.name.value),
+    );
+}