@graphql-eslint/eslint-plugin 3.14.4-alpha-20230111221804-f30b422 → 3.14.4-alpha-20230111225020-02d9c28

package/docs/rules/no-duplicate-fields.md

@@ -1,69 +0,0 @@
-# `no-duplicate-fields`
-
-✅ The `"extends": "plugin:@graphql-eslint/operations-recommended"` property in a configuration file
-enables this rule.
-
-💡 This rule provides
-[suggestions](https://eslint.org/docs/developer-guide/working-with-rules#providing-suggestions)
-
-- Category: `Operations`
-- Rule name: `@graphql-eslint/no-duplicate-fields`
-- Requires GraphQL Schema: `false` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `false`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-Checks for duplicate fields in selection set, variables in operation definition, or in arguments set
-of a field.
-
-## Usage Examples
-
-### Incorrect
-
-```graphql
-# eslint @graphql-eslint/no-duplicate-fields: 'error'
-
-query {
-  user {
-    name
-    email
-    name # duplicate field
-  }
-}
-```
-
-### Incorrect
-
-```graphql
-# eslint @graphql-eslint/no-duplicate-fields: 'error'
-
-query {
-  users(
-    first: 100
-    skip: 50
-    after: "cji629tngfgou0b73kt7vi5jo"
-    first: 100 # duplicate argument
-  ) {
-    id
-  }
-}
-```
-
-### Incorrect
-
-```graphql
-# eslint @graphql-eslint/no-duplicate-fields: 'error'
-
-query (
-  $first: Int!
-  $first: Int! # duplicate variable
-) {
-  users(first: $first, skip: 50) {
-    id
-  }
-}
-```
-
-## Resources
-
-- [Rule source](../../packages/plugin/src/rules/no-duplicate-fields.ts)
-- [Test source](../../packages/plugin/tests/no-duplicate-fields.spec.ts)

package/docs/rules/no-fragment-cycles.md

@@ -1,19 +0,0 @@
-# `no-fragment-cycles`
-
-✅ The `"extends": "plugin:@graphql-eslint/operations-recommended"` property in a configuration file
-enables this rule.
-
-- Category: `Operations`
-- Rule name: `@graphql-eslint/no-fragment-cycles`
-- Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `false`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-A GraphQL fragment is only valid when it does not have cycles in fragments usage.
-
-> This rule is a wrapper around a `graphql-js` validation function.
-
-## Resources
-
-- [Rule source](https://github.com/graphql/graphql-js/blob/main/src/validation/rules/NoFragmentCyclesRule.ts)
-- [Test source](https://github.com/graphql/graphql-js/tree/main/src/validation/__tests__/NoFragmentCyclesRule-test.ts)

package/docs/rules/no-hashtag-description.md

@@ -1,62 +0,0 @@
-# `no-hashtag-description`
-
-✅ The `"extends": "plugin:@graphql-eslint/schema-recommended"` property in a configuration file
-enables this rule.
-
-💡 This rule provides
-[suggestions](https://eslint.org/docs/developer-guide/working-with-rules#providing-suggestions)
-
-- Category: `Schema`
-- Rule name: `@graphql-eslint/no-hashtag-description`
-- Requires GraphQL Schema: `false` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `false`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-Requires to use `"""` or `"` for adding a GraphQL description instead of `#`. Allows to use hashtag
-for comments, as long as it's not attached to an AST definition.
-
-## Usage Examples
-
-### Incorrect
-
-```graphql
-# eslint @graphql-eslint/no-hashtag-description: 'error'
-
-# Represents a user
-type User {
-  id: ID!
-  name: String
-}
-```
-
-### Correct
-
-```graphql
-# eslint @graphql-eslint/no-hashtag-description: 'error'
-
-" Represents a user "
-type User {
-  id: ID!
-  name: String
-}
-```
-
-### Correct
-
-```graphql
-# eslint @graphql-eslint/no-hashtag-description: 'error'
-
-# This file defines the basic User type.
-# This comment is valid because it's not attached specifically to an AST object.
-
-" Represents a user "
-type User {
-  id: ID! # This one is also valid, since it comes after the AST object
-  name: String
-}
-```
-
-## Resources
-
-- [Rule source](../../packages/plugin/src/rules/no-hashtag-description.ts)
-- [Test source](../../packages/plugin/tests/no-hashtag-description.spec.ts)

package/docs/rules/no-one-place-fragments.md

@@ -1,51 +0,0 @@
-# `no-one-place-fragments`
-
-- Category: `Operations`
-- Rule name: `@graphql-eslint/no-one-place-fragments`
-- Requires GraphQL Schema: `false` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `true`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-Disallow fragments that are used only in one place.
-
-## Usage Examples
-
-### Incorrect
-
-```graphql
-# eslint @graphql-eslint/no-one-place-fragments: 'error'
-
-fragment UserFields on User {
-  id
-}
-
-{
-  user {
-    ...UserFields
-  }
-}
-```
-
-### Correct
-
-```graphql
-# eslint @graphql-eslint/no-one-place-fragments: 'error'
-
-fragment UserFields on User {
-  id
-}
-
-{
-  user {
-    ...UserFields
-    friends {
-      ...UserFields
-    }
-  }
-}
-```
-
-## Resources
-
-- [Rule source](../../packages/plugin/src/rules/no-one-place-fragments.ts)
-- [Test source](../../packages/plugin/tests/no-one-place-fragments.spec.ts)

package/docs/rules/no-root-type.md

@@ -1,55 +0,0 @@
-# `no-root-type`
-
-💡 This rule provides
-[suggestions](https://eslint.org/docs/developer-guide/working-with-rules#providing-suggestions)
-
-- Category: `Schema`
-- Rule name: `@graphql-eslint/no-root-type`
-- Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `false`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-Disallow using root types `mutation` and/or `subscription`.
-
-## Usage Examples
-
-### Incorrect
-
-```graphql
-# eslint @graphql-eslint/no-root-type: ['error', { disallow: ['mutation', 'subscription'] }]
-
-type Mutation {
-  createUser(input: CreateUserInput!): User!
-}
-```
-
-### Correct
-
-```graphql
-# eslint @graphql-eslint/no-root-type: ['error', { disallow: ['mutation', 'subscription'] }]
-
-type Query {
-  users: [User!]!
-}
-```
-
-## Config Schema
-
-The schema defines the following properties:
-
-### `disallow` (array, required)
-
-The elements of the array can contain the following enum values:
-
-- `mutation`
-- `subscription`
-
-Additional restrictions:
-
-- Minimum items: `1`
-- Unique items: `true`
-
-## Resources
-
-- [Rule source](../../packages/plugin/src/rules/no-root-type.ts)
-- [Test source](../../packages/plugin/tests/no-root-type.spec.ts)

package/docs/rules/no-scalar-result-type-on-mutation.md

@@ -1,39 +0,0 @@
-# `no-scalar-result-type-on-mutation`
-
-💡 This rule provides
-[suggestions](https://eslint.org/docs/developer-guide/working-with-rules#providing-suggestions)
-
-- Category: `Schema`
-- Rule name: `@graphql-eslint/no-scalar-result-type-on-mutation`
-- Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `false`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-Avoid scalar result type on mutation type to make sure to return a valid state.
-
-## Usage Examples
-
-### Incorrect
-
-```graphql
-# eslint @graphql-eslint/no-scalar-result-type-on-mutation: 'error'
-
-type Mutation {
-  createUser: Boolean
-}
-```
-
-### Correct
-
-```graphql
-# eslint @graphql-eslint/no-scalar-result-type-on-mutation: 'error'
-
-type Mutation {
-  createUser: User!
-}
-```
-
-## Resources
-
-- [Rule source](../../packages/plugin/src/rules/no-scalar-result-type-on-mutation.ts)
-- [Test source](../../packages/plugin/tests/no-scalar-result-type-on-mutation.spec.ts)

package/docs/rules/no-typename-prefix.md

@@ -1,42 +0,0 @@
-# `no-typename-prefix`
-
-✅ The `"extends": "plugin:@graphql-eslint/schema-recommended"` property in a configuration file
-enables this rule.
-
-💡 This rule provides
-[suggestions](https://eslint.org/docs/developer-guide/working-with-rules#providing-suggestions)
-
-- Category: `Schema`
-- Rule name: `@graphql-eslint/no-typename-prefix`
-- Requires GraphQL Schema: `false` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `false`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-Enforces users to avoid using the type name in a field name while defining your schema.
-
-## Usage Examples
-
-### Incorrect
-
-```graphql
-# eslint @graphql-eslint/no-typename-prefix: 'error'
-
-type User {
-  userId: ID!
-}
-```
-
-### Correct
-
-```graphql
-# eslint @graphql-eslint/no-typename-prefix: 'error'
-
-type User {
-  id: ID!
-}
-```
-
-## Resources
-
-- [Rule source](../../packages/plugin/src/rules/no-typename-prefix.ts)
-- [Test source](../../packages/plugin/tests/no-typename-prefix.spec.ts)

package/docs/rules/no-undefined-variables.md

@@ -1,20 +0,0 @@
-# `no-undefined-variables`
-
-✅ The `"extends": "plugin:@graphql-eslint/operations-recommended"` property in a configuration file
-enables this rule.
-
-- Category: `Operations`
-- Rule name: `@graphql-eslint/no-undefined-variables`
-- Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `true`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-A GraphQL operation is only valid if all variables encountered, both directly and via fragment
-spreads, are defined by that operation.
-
-> This rule is a wrapper around a `graphql-js` validation function.
-
-## Resources
-
-- [Rule source](https://github.com/graphql/graphql-js/blob/main/src/validation/rules/NoUndefinedVariablesRule.ts)
-- [Test source](https://github.com/graphql/graphql-js/tree/main/src/validation/__tests__/NoUndefinedVariablesRule-test.ts)

package/docs/rules/no-unreachable-types.md

@@ -1,52 +0,0 @@
-# `no-unreachable-types`
-
-✅ The `"extends": "plugin:@graphql-eslint/schema-recommended"` property in a configuration file
-enables this rule.
-
-💡 This rule provides
-[suggestions](https://eslint.org/docs/developer-guide/working-with-rules#providing-suggestions)
-
-- Category: `Schema`
-- Rule name: `@graphql-eslint/no-unreachable-types`
-- Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `false`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-Requires all types to be reachable at some level by root level fields.
-
-## Usage Examples
-
-### Incorrect
-
-```graphql
-# eslint @graphql-eslint/no-unreachable-types: 'error'
-
-type User {
-  id: ID!
-  name: String
-}
-
-type Query {
-  me: String
-}
-```
-
-### Correct
-
-```graphql
-# eslint @graphql-eslint/no-unreachable-types: 'error'
-
-type User {
-  id: ID!
-  name: String
-}
-
-type Query {
-  me: User
-}
-```
-
-## Resources
-
-- [Rule source](../../packages/plugin/src/rules/no-unreachable-types.ts)
-- [Test source](../../packages/plugin/tests/no-unreachable-types.spec.ts)

package/docs/rules/no-unused-fields.md

@@ -1,64 +0,0 @@
-# `no-unused-fields`
-
-💡 This rule provides
-[suggestions](https://eslint.org/docs/developer-guide/working-with-rules#providing-suggestions)
-
-- Category: `Schema`
-- Rule name: `@graphql-eslint/no-unused-fields`
-- Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `true`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-Requires all fields to be used at some level by siblings operations.
-
-## Usage Examples
-
-### Incorrect
-
-```graphql
-# eslint @graphql-eslint/no-unused-fields: 'error'
-
-type User {
-  id: ID!
-  name: String
-  someUnusedField: String
-}
-
-type Query {
-  me: User
-}
-
-query {
-  me {
-    id
-    name
-  }
-}
-```
-
-### Correct
-
-```graphql
-# eslint @graphql-eslint/no-unused-fields: 'error'
-
-type User {
-  id: ID!
-  name: String
-}
-
-type Query {
-  me: User
-}
-
-query {
-  me {
-    id
-    name
-  }
-}
-```
-
-## Resources
-
-- [Rule source](../../packages/plugin/src/rules/no-unused-fields.ts)
-- [Test source](../../packages/plugin/tests/no-unused-fields.spec.ts)

package/docs/rules/no-unused-fragments.md

@@ -1,20 +0,0 @@
-# `no-unused-fragments`
-
-✅ The `"extends": "plugin:@graphql-eslint/operations-recommended"` property in a configuration file
-enables this rule.
-
-- Category: `Operations`
-- Rule name: `@graphql-eslint/no-unused-fragments`
-- Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `true`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-A GraphQL document is only valid if all fragment definitions are spread within operations, or spread
-within other fragments spread within operations.
-
-> This rule is a wrapper around a `graphql-js` validation function.
-
-## Resources
-
-- [Rule source](https://github.com/graphql/graphql-js/blob/main/src/validation/rules/NoUnusedFragmentsRule.ts)
-- [Test source](https://github.com/graphql/graphql-js/tree/main/src/validation/__tests__/NoUnusedFragmentsRule-test.ts)

package/docs/rules/no-unused-variables.md

@@ -1,20 +0,0 @@
-# `no-unused-variables`
-
-✅ The `"extends": "plugin:@graphql-eslint/operations-recommended"` property in a configuration file
-enables this rule.
-
-- Category: `Operations`
-- Rule name: `@graphql-eslint/no-unused-variables`
-- Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `true`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-A GraphQL operation is only valid if all variables defined by an operation are used, either directly
-or within a spread fragment.
-
-> This rule is a wrapper around a `graphql-js` validation function.
-
-## Resources
-
-- [Rule source](https://github.com/graphql/graphql-js/blob/main/src/validation/rules/NoUnusedVariablesRule.ts)
-- [Test source](https://github.com/graphql/graphql-js/tree/main/src/validation/__tests__/NoUnusedVariablesRule-test.ts)

package/docs/rules/one-field-subscriptions.md

@@ -1,19 +0,0 @@
-# `one-field-subscriptions`
-
-✅ The `"extends": "plugin:@graphql-eslint/operations-recommended"` property in a configuration file
-enables this rule.
-
-- Category: `Operations`
-- Rule name: `@graphql-eslint/one-field-subscriptions`
-- Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `false`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-A GraphQL subscription is valid only if it contains a single root field.
-
-> This rule is a wrapper around a `graphql-js` validation function.
-
-## Resources
-
-- [Rule source](https://github.com/graphql/graphql-js/blob/main/src/validation/rules/SingleFieldSubscriptionsRule.ts)
-- [Test source](https://github.com/graphql/graphql-js/tree/main/src/validation/__tests__/SingleFieldSubscriptionsRule-test.ts)

package/docs/rules/overlapping-fields-can-be-merged.md

@@ -1,20 +0,0 @@
-# `overlapping-fields-can-be-merged`
-
-✅ The `"extends": "plugin:@graphql-eslint/operations-recommended"` property in a configuration file
-enables this rule.
-
-- Category: `Operations`
-- Rule name: `@graphql-eslint/overlapping-fields-can-be-merged`
-- Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `false`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-A selection set is only valid if all fields (including spreading any fragments) either correspond to
-distinct response names or can be merged without ambiguity.
-
-> This rule is a wrapper around a `graphql-js` validation function.
-
-## Resources
-
-- [Rule source](https://github.com/graphql/graphql-js/blob/main/src/validation/rules/OverlappingFieldsCanBeMergedRule.ts)
-- [Test source](https://github.com/graphql/graphql-js/tree/main/src/validation/__tests__/OverlappingFieldsCanBeMergedRule-test.ts)

package/docs/rules/possible-fragment-spread.md

@@ -1,21 +0,0 @@
-# `possible-fragment-spread`
-
-✅ The `"extends": "plugin:@graphql-eslint/operations-recommended"` property in a configuration file
-enables this rule.
-
-- Category: `Operations`
-- Rule name: `@graphql-eslint/possible-fragment-spread`
-- Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `false`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-A fragment spread is only valid if the type condition could ever possibly be true: if there is a
-non-empty intersection of the possible parent types, and possible types which pass the type
-condition.
-
-> This rule is a wrapper around a `graphql-js` validation function.
-
-## Resources
-
-- [Rule source](https://github.com/graphql/graphql-js/blob/main/src/validation/rules/PossibleFragmentSpreadsRule.ts)
-- [Test source](https://github.com/graphql/graphql-js/tree/main/src/validation/__tests__/PossibleFragmentSpreadsRule-test.ts)

package/docs/rules/possible-type-extension.md

@@ -1,19 +0,0 @@
-# `possible-type-extension`
-
-💡 This rule provides
-[suggestions](https://eslint.org/docs/developer-guide/working-with-rules#providing-suggestions)
-
-- Category: `Schema`
-- Rule name: `@graphql-eslint/possible-type-extension`
-- Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `false`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-A type extension is only valid if the type is defined and has the same kind.
-
-> This rule is a wrapper around a `graphql-js` validation function.
-
-## Resources
-
-- [Rule source](https://github.com/graphql/graphql-js/blob/main/src/validation/rules/PossibleTypeExtensionsRule.ts)
-- [Test source](https://github.com/graphql/graphql-js/tree/main/src/validation/__tests__/PossibleTypeExtensionsRule-test.ts)

package/docs/rules/provided-required-arguments.md

@@ -1,21 +0,0 @@
-# `provided-required-arguments`
-
-✅ The `"extends": "plugin:@graphql-eslint/schema-recommended"` and
-`"plugin:@graphql-eslint/operations-recommended"` property in a configuration file enables this
-rule.
-
-- Category: `Schema & Operations`
-- Rule name: `@graphql-eslint/provided-required-arguments`
-- Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `false`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-A field or directive is only valid if all required (non-null without a default value) field
-arguments have been provided.
-
-> This rule is a wrapper around a `graphql-js` validation function.
-
-## Resources
-
-- [Rule source](https://github.com/graphql/graphql-js/blob/main/src/validation/rules/ProvidedRequiredArgumentsRule.ts)
-- [Test source](https://github.com/graphql/graphql-js/tree/main/src/validation/__tests__/ProvidedRequiredArgumentsRule-test.ts)