graphql 0.0.1-test.1

package/validation/rules/FieldsOnCorrectTypeRule.mjs

@@ -0,0 +1,125 @@
+import { didYouMean } from '../../jsutils/didYouMean.mjs';
+import { naturalCompare } from '../../jsutils/naturalCompare.mjs';
+import { suggestionList } from '../../jsutils/suggestionList.mjs';
+import { GraphQLError } from '../../error/GraphQLError.mjs';
+import {
+  isAbstractType,
+  isInterfaceType,
+  isObjectType,
+} from '../../type/definition.mjs';
+
+/**
+ * Fields on correct type
+ *
+ * A GraphQL document is only valid if all fields selected are defined by the
+ * parent type, or are an allowed meta field such as __typename.
+ *
+ * See https://spec.graphql.org/draft/#sec-Field-Selections
+ */
+export function FieldsOnCorrectTypeRule(context) {
+  return {
+    Field(node) {
+      const type = context.getParentType();
+
+      if (type) {
+        const fieldDef = context.getFieldDef();
+
+        if (!fieldDef) {
+          // This field doesn't exist, lets look for suggestions.
+          const schema = context.getSchema();
+          const fieldName = node.name.value; // First determine if there are any suggested types to condition on.
+
+          let suggestion = didYouMean(
+            'to use an inline fragment on',
+            getSuggestedTypeNames(schema, type, fieldName),
+          ); // If there are no suggested types, then perhaps this was a typo?
+
+          if (suggestion === '') {
+            suggestion = didYouMean(getSuggestedFieldNames(type, fieldName));
+          } // Report an error, including helpful suggestions.
+
+          context.reportError(
+            new GraphQLError(
+              `Cannot query field "${fieldName}" on type "${type.name}".` +
+                suggestion,
+              node,
+            ),
+          );
+        }
+      }
+    },
+  };
+}
+/**
+ * Go through all of the implementations of type, as well as the interfaces that
+ * they implement. If any of those types include the provided field, suggest them,
+ * sorted by how often the type is referenced.
+ */
+
+function getSuggestedTypeNames(schema, type, fieldName) {
+  if (!isAbstractType(type)) {
+    // Must be an Object type, which does not have possible fields.
+    return [];
+  }
+
+  const suggestedTypes = new Set();
+  const usageCount = Object.create(null);
+
+  for (const possibleType of schema.getPossibleTypes(type)) {
+    if (!possibleType.getFields()[fieldName]) {
+      continue;
+    } // This object type defines this field.
+
+    suggestedTypes.add(possibleType);
+    usageCount[possibleType.name] = 1;
+
+    for (const possibleInterface of possibleType.getInterfaces()) {
+      var _usageCount$possibleI;
+
+      if (!possibleInterface.getFields()[fieldName]) {
+        continue;
+      } // This interface type defines this field.
+
+      suggestedTypes.add(possibleInterface);
+      usageCount[possibleInterface.name] =
+        ((_usageCount$possibleI = usageCount[possibleInterface.name]) !==
+          null && _usageCount$possibleI !== void 0
+          ? _usageCount$possibleI
+          : 0) + 1;
+    }
+  }
+
+  return [...suggestedTypes]
+    .sort((typeA, typeB) => {
+      // Suggest both interface and object types based on how common they are.
+      const usageCountDiff = usageCount[typeB.name] - usageCount[typeA.name];
+
+      if (usageCountDiff !== 0) {
+        return usageCountDiff;
+      } // Suggest super types first followed by subtypes
+
+      if (isInterfaceType(typeA) && schema.isSubType(typeA, typeB)) {
+        return -1;
+      }
+
+      if (isInterfaceType(typeB) && schema.isSubType(typeB, typeA)) {
+        return 1;
+      }
+
+      return naturalCompare(typeA.name, typeB.name);
+    })
+    .map((x) => x.name);
+}
+/**
+ * For the field name provided, determine if there are any similar field names
+ * that may be the result of a typo.
+ */
+
+function getSuggestedFieldNames(type, fieldName) {
+  if (isObjectType(type) || isInterfaceType(type)) {
+    const possibleFieldNames = Object.keys(type.getFields());
+    return suggestionList(fieldName, possibleFieldNames);
+  } // Otherwise, must be a Union type, which does not define fields.
+
+  return [];
+}

package/validation/rules/FragmentsOnCompositeTypesRule.d.ts

@@ -0,0 +1,14 @@
+import type { ASTVisitor } from '../../language/visitor';
+import type { ValidationContext } from '../ValidationContext';
+/**
+ * Fragments on composite type
+ *
+ * Fragments use a type condition to determine if they apply, since fragments
+ * can only be spread into a composite type (object, interface, or union), the
+ * type condition must also be a composite type.
+ *
+ * See https://spec.graphql.org/draft/#sec-Fragments-On-Composite-Types
+ */
+export declare function FragmentsOnCompositeTypesRule(
+  context: ValidationContext,
+): ASTVisitor;

package/validation/rules/FragmentsOnCompositeTypesRule.js

@@ -0,0 +1,65 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', {
+  value: true,
+});
+exports.FragmentsOnCompositeTypesRule = FragmentsOnCompositeTypesRule;
+
+var _GraphQLError = require('../../error/GraphQLError.js');
+
+var _printer = require('../../language/printer.js');
+
+var _definition = require('../../type/definition.js');
+
+var _typeFromAST = require('../../utilities/typeFromAST.js');
+
+/**
+ * Fragments on composite type
+ *
+ * Fragments use a type condition to determine if they apply, since fragments
+ * can only be spread into a composite type (object, interface, or union), the
+ * type condition must also be a composite type.
+ *
+ * See https://spec.graphql.org/draft/#sec-Fragments-On-Composite-Types
+ */
+function FragmentsOnCompositeTypesRule(context) {
+  return {
+    InlineFragment(node) {
+      const typeCondition = node.typeCondition;
+
+      if (typeCondition) {
+        const type = (0, _typeFromAST.typeFromAST)(
+          context.getSchema(),
+          typeCondition,
+        );
+
+        if (type && !(0, _definition.isCompositeType)(type)) {
+          const typeStr = (0, _printer.print)(typeCondition);
+          context.reportError(
+            new _GraphQLError.GraphQLError(
+              `Fragment cannot condition on non composite type "${typeStr}".`,
+              typeCondition,
+            ),
+          );
+        }
+      }
+    },
+
+    FragmentDefinition(node) {
+      const type = (0, _typeFromAST.typeFromAST)(
+        context.getSchema(),
+        node.typeCondition,
+      );
+
+      if (type && !(0, _definition.isCompositeType)(type)) {
+        const typeStr = (0, _printer.print)(node.typeCondition);
+        context.reportError(
+          new _GraphQLError.GraphQLError(
+            `Fragment "${node.name.value}" cannot condition on non composite type "${typeStr}".`,
+            node.typeCondition,
+          ),
+        );
+      }
+    },
+  };
+}

package/validation/rules/FragmentsOnCompositeTypesRule.mjs

@@ -0,0 +1,49 @@
+import { GraphQLError } from '../../error/GraphQLError.mjs';
+import { print } from '../../language/printer.mjs';
+import { isCompositeType } from '../../type/definition.mjs';
+import { typeFromAST } from '../../utilities/typeFromAST.mjs';
+
+/**
+ * Fragments on composite type
+ *
+ * Fragments use a type condition to determine if they apply, since fragments
+ * can only be spread into a composite type (object, interface, or union), the
+ * type condition must also be a composite type.
+ *
+ * See https://spec.graphql.org/draft/#sec-Fragments-On-Composite-Types
+ */
+export function FragmentsOnCompositeTypesRule(context) {
+  return {
+    InlineFragment(node) {
+      const typeCondition = node.typeCondition;
+
+      if (typeCondition) {
+        const type = typeFromAST(context.getSchema(), typeCondition);
+
+        if (type && !isCompositeType(type)) {
+          const typeStr = print(typeCondition);
+          context.reportError(
+            new GraphQLError(
+              `Fragment cannot condition on non composite type "${typeStr}".`,
+              typeCondition,
+            ),
+          );
+        }
+      }
+    },
+
+    FragmentDefinition(node) {
+      const type = typeFromAST(context.getSchema(), node.typeCondition);
+
+      if (type && !isCompositeType(type)) {
+        const typeStr = print(node.typeCondition);
+        context.reportError(
+          new GraphQLError(
+            `Fragment "${node.name.value}" cannot condition on non composite type "${typeStr}".`,
+            node.typeCondition,
+          ),
+        );
+      }
+    },
+  };
+}

package/validation/rules/KnownArgumentNamesRule.d.ts

@@ -0,0 +1,23 @@
+import type { ASTVisitor } from '../../language/visitor';
+import type {
+  SDLValidationContext,
+  ValidationContext,
+} from '../ValidationContext';
+/**
+ * Known argument names
+ *
+ * A GraphQL field is only valid if all supplied arguments are defined by
+ * that field.
+ *
+ * See https://spec.graphql.org/draft/#sec-Argument-Names
+ * See https://spec.graphql.org/draft/#sec-Directives-Are-In-Valid-Locations
+ */
+export declare function KnownArgumentNamesRule(
+  context: ValidationContext,
+): ASTVisitor;
+/**
+ * @internal
+ */
+export declare function KnownArgumentNamesOnDirectivesRule(
+  context: ValidationContext | SDLValidationContext,
+): ASTVisitor;

package/validation/rules/KnownArgumentNamesRule.js

@@ -0,0 +1,116 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', {
+  value: true,
+});
+exports.KnownArgumentNamesOnDirectivesRule = KnownArgumentNamesOnDirectivesRule;
+exports.KnownArgumentNamesRule = KnownArgumentNamesRule;
+
+var _didYouMean = require('../../jsutils/didYouMean.js');
+
+var _suggestionList = require('../../jsutils/suggestionList.js');
+
+var _GraphQLError = require('../../error/GraphQLError.js');
+
+var _kinds = require('../../language/kinds.js');
+
+var _directives = require('../../type/directives.js');
+
+/**
+ * Known argument names
+ *
+ * A GraphQL field is only valid if all supplied arguments are defined by
+ * that field.
+ *
+ * See https://spec.graphql.org/draft/#sec-Argument-Names
+ * See https://spec.graphql.org/draft/#sec-Directives-Are-In-Valid-Locations
+ */
+function KnownArgumentNamesRule(context) {
+  return {
+    // eslint-disable-next-line new-cap
+    ...KnownArgumentNamesOnDirectivesRule(context),
+
+    Argument(argNode) {
+      const argDef = context.getArgument();
+      const fieldDef = context.getFieldDef();
+      const parentType = context.getParentType();
+
+      if (!argDef && fieldDef && parentType) {
+        const argName = argNode.name.value;
+        const knownArgsNames = fieldDef.args.map((arg) => arg.name);
+        const suggestions = (0, _suggestionList.suggestionList)(
+          argName,
+          knownArgsNames,
+        );
+        context.reportError(
+          new _GraphQLError.GraphQLError(
+            `Unknown argument "${argName}" on field "${parentType.name}.${fieldDef.name}".` +
+              (0, _didYouMean.didYouMean)(suggestions),
+            argNode,
+          ),
+        );
+      }
+    },
+  };
+}
+/**
+ * @internal
+ */
+
+function KnownArgumentNamesOnDirectivesRule(context) {
+  const directiveArgs = Object.create(null);
+  const schema = context.getSchema();
+  const definedDirectives = schema
+    ? schema.getDirectives()
+    : _directives.specifiedDirectives;
+
+  for (const directive of definedDirectives) {
+    directiveArgs[directive.name] = directive.args.map((arg) => arg.name);
+  }
+
+  const astDefinitions = context.getDocument().definitions;
+
+  for (const def of astDefinitions) {
+    if (def.kind === _kinds.Kind.DIRECTIVE_DEFINITION) {
+      var _def$arguments;
+
+      // FIXME: https://github.com/graphql/graphql-js/issues/2203
+
+      /* c8 ignore next */
+      const argsNodes =
+        (_def$arguments = def.arguments) !== null && _def$arguments !== void 0
+          ? _def$arguments
+          : [];
+      directiveArgs[def.name.value] = argsNodes.map((arg) => arg.name.value);
+    }
+  }
+
+  return {
+    Directive(directiveNode) {
+      const directiveName = directiveNode.name.value;
+      const knownArgs = directiveArgs[directiveName];
+
+      if (directiveNode.arguments && knownArgs) {
+        for (const argNode of directiveNode.arguments) {
+          const argName = argNode.name.value;
+
+          if (!knownArgs.includes(argName)) {
+            const suggestions = (0, _suggestionList.suggestionList)(
+              argName,
+              knownArgs,
+            );
+            context.reportError(
+              new _GraphQLError.GraphQLError(
+                `Unknown argument "${argName}" on directive "@${directiveName}".` +
+                  (0, _didYouMean.didYouMean)(suggestions),
+                argNode,
+              ),
+            );
+          }
+        }
+      }
+
+      return false;
+    },
+  };
+}

package/validation/rules/KnownArgumentNamesRule.mjs

@@ -0,0 +1,98 @@
+import { didYouMean } from '../../jsutils/didYouMean.mjs';
+import { suggestionList } from '../../jsutils/suggestionList.mjs';
+import { GraphQLError } from '../../error/GraphQLError.mjs';
+import { Kind } from '../../language/kinds.mjs';
+import { specifiedDirectives } from '../../type/directives.mjs';
+
+/**
+ * Known argument names
+ *
+ * A GraphQL field is only valid if all supplied arguments are defined by
+ * that field.
+ *
+ * See https://spec.graphql.org/draft/#sec-Argument-Names
+ * See https://spec.graphql.org/draft/#sec-Directives-Are-In-Valid-Locations
+ */
+export function KnownArgumentNamesRule(context) {
+  return {
+    // eslint-disable-next-line new-cap
+    ...KnownArgumentNamesOnDirectivesRule(context),
+
+    Argument(argNode) {
+      const argDef = context.getArgument();
+      const fieldDef = context.getFieldDef();
+      const parentType = context.getParentType();
+
+      if (!argDef && fieldDef && parentType) {
+        const argName = argNode.name.value;
+        const knownArgsNames = fieldDef.args.map((arg) => arg.name);
+        const suggestions = suggestionList(argName, knownArgsNames);
+        context.reportError(
+          new GraphQLError(
+            `Unknown argument "${argName}" on field "${parentType.name}.${fieldDef.name}".` +
+              didYouMean(suggestions),
+            argNode,
+          ),
+        );
+      }
+    },
+  };
+}
+/**
+ * @internal
+ */
+
+export function KnownArgumentNamesOnDirectivesRule(context) {
+  const directiveArgs = Object.create(null);
+  const schema = context.getSchema();
+  const definedDirectives = schema
+    ? schema.getDirectives()
+    : specifiedDirectives;
+
+  for (const directive of definedDirectives) {
+    directiveArgs[directive.name] = directive.args.map((arg) => arg.name);
+  }
+
+  const astDefinitions = context.getDocument().definitions;
+
+  for (const def of astDefinitions) {
+    if (def.kind === Kind.DIRECTIVE_DEFINITION) {
+      var _def$arguments;
+
+      // FIXME: https://github.com/graphql/graphql-js/issues/2203
+
+      /* c8 ignore next */
+      const argsNodes =
+        (_def$arguments = def.arguments) !== null && _def$arguments !== void 0
+          ? _def$arguments
+          : [];
+      directiveArgs[def.name.value] = argsNodes.map((arg) => arg.name.value);
+    }
+  }
+
+  return {
+    Directive(directiveNode) {
+      const directiveName = directiveNode.name.value;
+      const knownArgs = directiveArgs[directiveName];
+
+      if (directiveNode.arguments && knownArgs) {
+        for (const argNode of directiveNode.arguments) {
+          const argName = argNode.name.value;
+
+          if (!knownArgs.includes(argName)) {
+            const suggestions = suggestionList(argName, knownArgs);
+            context.reportError(
+              new GraphQLError(
+                `Unknown argument "${argName}" on directive "@${directiveName}".` +
+                  didYouMean(suggestions),
+                argNode,
+              ),
+            );
+          }
+        }
+      }
+
+      return false;
+    },
+  };
+}

package/validation/rules/KnownDirectivesRule.d.ts

@@ -0,0 +1,16 @@
+import type { ASTVisitor } from '../../language/visitor';
+import type {
+  SDLValidationContext,
+  ValidationContext,
+} from '../ValidationContext';
+/**
+ * Known directives
+ *
+ * A GraphQL document is only valid if all `@directives` are known by the
+ * schema and legally positioned.
+ *
+ * See https://spec.graphql.org/draft/#sec-Directives-Are-Defined
+ */
+export declare function KnownDirectivesRule(
+  context: ValidationContext | SDLValidationContext,
+): ASTVisitor;

package/validation/rules/KnownDirectivesRule.js

@@ -0,0 +1,163 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', {
+  value: true,
+});
+exports.KnownDirectivesRule = KnownDirectivesRule;
+
+var _inspect = require('../../jsutils/inspect.js');
+
+var _invariant = require('../../jsutils/invariant.js');
+
+var _GraphQLError = require('../../error/GraphQLError.js');
+
+var _ast = require('../../language/ast.js');
+
+var _directiveLocation = require('../../language/directiveLocation.js');
+
+var _kinds = require('../../language/kinds.js');
+
+var _directives = require('../../type/directives.js');
+
+/**
+ * Known directives
+ *
+ * A GraphQL document is only valid if all `@directives` are known by the
+ * schema and legally positioned.
+ *
+ * See https://spec.graphql.org/draft/#sec-Directives-Are-Defined
+ */
+function KnownDirectivesRule(context) {
+  const locationsMap = Object.create(null);
+  const schema = context.getSchema();
+  const definedDirectives = schema
+    ? schema.getDirectives()
+    : _directives.specifiedDirectives;
+
+  for (const directive of definedDirectives) {
+    locationsMap[directive.name] = directive.locations;
+  }
+
+  const astDefinitions = context.getDocument().definitions;
+
+  for (const def of astDefinitions) {
+    if (def.kind === _kinds.Kind.DIRECTIVE_DEFINITION) {
+      locationsMap[def.name.value] = def.locations.map((name) => name.value);
+    }
+  }
+
+  return {
+    Directive(node, _key, _parent, _path, ancestors) {
+      const name = node.name.value;
+      const locations = locationsMap[name];
+
+      if (!locations) {
+        context.reportError(
+          new _GraphQLError.GraphQLError(`Unknown directive "@${name}".`, node),
+        );
+        return;
+      }
+
+      const candidateLocation = getDirectiveLocationForASTPath(ancestors);
+
+      if (candidateLocation && !locations.includes(candidateLocation)) {
+        context.reportError(
+          new _GraphQLError.GraphQLError(
+            `Directive "@${name}" may not be used on ${candidateLocation}.`,
+            node,
+          ),
+        );
+      }
+    },
+  };
+}
+
+function getDirectiveLocationForASTPath(ancestors) {
+  const appliedTo = ancestors[ancestors.length - 1];
+  'kind' in appliedTo || (0, _invariant.invariant)(false);
+
+  switch (appliedTo.kind) {
+    case _kinds.Kind.OPERATION_DEFINITION:
+      return getDirectiveLocationForOperation(appliedTo.operation);
+
+    case _kinds.Kind.FIELD:
+      return _directiveLocation.DirectiveLocation.FIELD;
+
+    case _kinds.Kind.FRAGMENT_SPREAD:
+      return _directiveLocation.DirectiveLocation.FRAGMENT_SPREAD;
+
+    case _kinds.Kind.INLINE_FRAGMENT:
+      return _directiveLocation.DirectiveLocation.INLINE_FRAGMENT;
+
+    case _kinds.Kind.FRAGMENT_DEFINITION:
+      return _directiveLocation.DirectiveLocation.FRAGMENT_DEFINITION;
+
+    case _kinds.Kind.VARIABLE_DEFINITION:
+      return _directiveLocation.DirectiveLocation.VARIABLE_DEFINITION;
+
+    case _kinds.Kind.SCHEMA_DEFINITION:
+    case _kinds.Kind.SCHEMA_EXTENSION:
+      return _directiveLocation.DirectiveLocation.SCHEMA;
+
+    case _kinds.Kind.SCALAR_TYPE_DEFINITION:
+    case _kinds.Kind.SCALAR_TYPE_EXTENSION:
+      return _directiveLocation.DirectiveLocation.SCALAR;
+
+    case _kinds.Kind.OBJECT_TYPE_DEFINITION:
+    case _kinds.Kind.OBJECT_TYPE_EXTENSION:
+      return _directiveLocation.DirectiveLocation.OBJECT;
+
+    case _kinds.Kind.FIELD_DEFINITION:
+      return _directiveLocation.DirectiveLocation.FIELD_DEFINITION;
+
+    case _kinds.Kind.INTERFACE_TYPE_DEFINITION:
+    case _kinds.Kind.INTERFACE_TYPE_EXTENSION:
+      return _directiveLocation.DirectiveLocation.INTERFACE;
+
+    case _kinds.Kind.UNION_TYPE_DEFINITION:
+    case _kinds.Kind.UNION_TYPE_EXTENSION:
+      return _directiveLocation.DirectiveLocation.UNION;
+
+    case _kinds.Kind.ENUM_TYPE_DEFINITION:
+    case _kinds.Kind.ENUM_TYPE_EXTENSION:
+      return _directiveLocation.DirectiveLocation.ENUM;
+
+    case _kinds.Kind.ENUM_VALUE_DEFINITION:
+      return _directiveLocation.DirectiveLocation.ENUM_VALUE;
+
+    case _kinds.Kind.INPUT_OBJECT_TYPE_DEFINITION:
+    case _kinds.Kind.INPUT_OBJECT_TYPE_EXTENSION:
+      return _directiveLocation.DirectiveLocation.INPUT_OBJECT;
+
+    case _kinds.Kind.INPUT_VALUE_DEFINITION: {
+      const parentNode = ancestors[ancestors.length - 3];
+      'kind' in parentNode || (0, _invariant.invariant)(false);
+      return parentNode.kind === _kinds.Kind.INPUT_OBJECT_TYPE_DEFINITION
+        ? _directiveLocation.DirectiveLocation.INPUT_FIELD_DEFINITION
+        : _directiveLocation.DirectiveLocation.ARGUMENT_DEFINITION;
+    }
+    // Not reachable, all possible types have been considered.
+
+    /* c8 ignore next */
+
+    default:
+      false ||
+        (0, _invariant.invariant)(
+          false,
+          'Unexpected kind: ' + (0, _inspect.inspect)(appliedTo.kind),
+        );
+  }
+}
+
+function getDirectiveLocationForOperation(operation) {
+  switch (operation) {
+    case _ast.OperationTypeNode.QUERY:
+      return _directiveLocation.DirectiveLocation.QUERY;
+
+    case _ast.OperationTypeNode.MUTATION:
+      return _directiveLocation.DirectiveLocation.MUTATION;
+
+    case _ast.OperationTypeNode.SUBSCRIPTION:
+      return _directiveLocation.DirectiveLocation.SUBSCRIPTION;
+  }
+}