@graphql-eslint/eslint-plugin/cjs/rules/require-description/index.js

GraphQL plugin for ESLint

"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }var _graphql = require('graphql');
var _utils = require('@graphql-tools/utils');
var _utilsjs = require('../../utils.js');
const RULE_ID = "require-description", ALLOWED_KINDS = [
  ..._utilsjs.TYPES_KINDS,
  _graphql.Kind.DIRECTIVE_DEFINITION,
  _graphql.Kind.FIELD_DEFINITION,
  _graphql.Kind.INPUT_VALUE_DEFINITION,
  _graphql.Kind.ENUM_VALUE_DEFINITION,
  _graphql.Kind.OPERATION_DEFINITION
], schema = {
  type: "array",
  minItems: 1,
  maxItems: 1,
  items: {
    type: "object",
    additionalProperties: !1,
    minProperties: 1,
    properties: {
      types: {
        type: "boolean",
        description: `Includes:
${_utilsjs.TYPES_KINDS.map((kind) => `- \`${kind}\``).join(`
`)}`
      },
      rootField: {
        type: "boolean",
        description: "Definitions within `Query`, `Mutation`, and `Subscription` root types."
      },
      ...Object.fromEntries(
        [...ALLOWED_KINDS].sort().map((kind) => {
          let description = `Read more about this kind on [spec.graphql.org](https://spec.graphql.org/October2021/#${kind}).`;
          return kind === _graphql.Kind.OPERATION_DEFINITION && (description += '\n> You must use only comment syntax `#` and not description syntax `"""` or `"`.'), [kind, { type: "boolean", description }];
        })
      )
    }
  }
}, rule = exports.rule = {
  meta: {
    docs: {
      category: "Schema",
      description: "Enforce descriptions in type definitions and operations.",
      url: `https://the-guild.dev/graphql/eslint/rules/${RULE_ID}`,
      examples: [
        {
          title: "Incorrect",
          usage: [{ types: !0, FieldDefinition: !0 }],
          code: (
            /* GraphQL */
            `
            type someTypeName {
              name: String
            }
          `
          )
        },
        {
          title: "Correct",
          usage: [{ types: !0, FieldDefinition: !0 }],
          code: (
            /* GraphQL */
            `
            """
            Some type description
            """
            type someTypeName {
              """
              Name description
              """
              name: String
            }
          `
          )
        },
        {
          title: "Correct",
          usage: [{ OperationDefinition: !0 }],
          code: (
            /* GraphQL */
            `
            # Create a new user
            mutation createUser {
              # ...
            }
          `
          )
        },
        {
          title: "Correct",
          usage: [{ rootField: !0 }],
          code: (
            /* GraphQL */
            `
            type Mutation {
              "Create a new user"
              createUser: User
            }

            type User {
              name: String
            }
          `
          )
        }
      ],
      configOptions: [
        {
          types: !0,
          [_graphql.Kind.DIRECTIVE_DEFINITION]: !0,
          rootField: !0
        }
      ],
      recommended: !0
    },
    type: "suggestion",
    messages: {
      [RULE_ID]: "Description is required for {{ nodeName }}"
    },
    schema
  },
  create(context) {
    const { types, rootField, ...restOptions } = context.options[0] || {}, kinds = new Set(types ? _utilsjs.TYPES_KINDS : []);
    for (const [kind, isEnabled] of Object.entries(restOptions))
      isEnabled ? kinds.add(kind) : kinds.delete(kind);
    if (rootField) {
      const schema2 = _utilsjs.requireGraphQLSchema.call(void 0, RULE_ID, context), rootTypeNames = _utils.getRootTypeNames.call(void 0, schema2);
      kinds.add(
        `:matches(ObjectTypeDefinition, ObjectTypeExtension)[name.value=/^(${[
          ...rootTypeNames
        ].join(",")})$/] > FieldDefinition`
      );
    }
    if (!kinds.size)
      throw new Error("At least one kind must be enabled");
    return {
      [[...kinds].join(",")](node) {
        let description = "";
        const isOperation = node.kind === _graphql.Kind.OPERATION_DEFINITION;
        if (isOperation) {
          const rawNode = node.rawNode(), { prev, line } = rawNode.loc.startToken;
          if (_optionalChain([prev, 'optionalAccess', _ => _.kind]) === _graphql.TokenKind.COMMENT) {
            const value = prev.value.trim(), linesBefore = line - prev.line;
            !value.startsWith("eslint") && linesBefore === 1 && (description = value);
          }
        } else
          description = _optionalChain([node, 'access', _2 => _2.description, 'optionalAccess', _3 => _3.value, 'access', _4 => _4.trim, 'call', _5 => _5()]) || "";
        description.length === 0 && context.report({
          loc: isOperation ? _utilsjs.getLocation.call(void 0, node.loc.start, node.operation) : node.name.loc,
          messageId: RULE_ID,
          data: {
            nodeName: _utilsjs.getNodeName.call(void 0, node)
          }
        });
      }
    };
  }
};



exports.RULE_ID = RULE_ID; exports.rule = rule;