@graphql-eslint/eslint-plugin 4.0.0-alpha-20220821140530-e968cfc → 4.0.0-alpha-20230810155929-e89edf7

package/cjs/rules/relay-connection-types.js

@@ -0,0 +1,111 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: !0 });
+}, __copyProps = (to, from, except, desc) => {
+  if (from && typeof from == "object" || typeof from == "function")
+    for (let key of __getOwnPropNames(from))
+      !__hasOwnProp.call(to, key) && key !== except && __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: !0 }), mod);
+var relay_connection_types_exports = {};
+__export(relay_connection_types_exports, {
+  NON_OBJECT_TYPES: () => NON_OBJECT_TYPES,
+  rule: () => rule
+});
+module.exports = __toCommonJS(relay_connection_types_exports);
+var import_graphql = require("graphql");
+const MUST_BE_OBJECT_TYPE = "MUST_BE_OBJECT_TYPE", MUST_CONTAIN_FIELD_EDGES = "MUST_CONTAIN_FIELD_EDGES", MUST_CONTAIN_FIELD_PAGE_INFO = "MUST_CONTAIN_FIELD_PAGE_INFO", MUST_HAVE_CONNECTION_SUFFIX = "MUST_HAVE_CONNECTION_SUFFIX", EDGES_FIELD_MUST_RETURN_LIST_TYPE = "EDGES_FIELD_MUST_RETURN_LIST_TYPE", PAGE_INFO_FIELD_MUST_RETURN_NON_NULL_TYPE = "PAGE_INFO_FIELD_MUST_RETURN_NON_NULL_TYPE", NON_OBJECT_TYPES = [
+  import_graphql.Kind.SCALAR_TYPE_DEFINITION,
+  import_graphql.Kind.UNION_TYPE_DEFINITION,
+  import_graphql.Kind.UNION_TYPE_EXTENSION,
+  import_graphql.Kind.INPUT_OBJECT_TYPE_DEFINITION,
+  import_graphql.Kind.INPUT_OBJECT_TYPE_EXTENSION,
+  import_graphql.Kind.ENUM_TYPE_DEFINITION,
+  import_graphql.Kind.ENUM_TYPE_EXTENSION,
+  import_graphql.Kind.INTERFACE_TYPE_DEFINITION,
+  import_graphql.Kind.INTERFACE_TYPE_EXTENSION
+], notConnectionTypesSelector = `:matches(${NON_OBJECT_TYPES})[name.value=/Connection$/] > .name`, hasEdgesField = (node) => node.fields?.some((field) => field.name.value === "edges"), hasPageInfoField = (node) => node.fields?.some((field) => field.name.value === "pageInfo"), rule = {
+  meta: {
+    type: "problem",
+    docs: {
+      category: "Schema",
+      description: [
+        "Set of rules to follow Relay specification for Connection types.",
+        "",
+        '- Any type whose name ends in "Connection" is considered by spec to be a `Connection type`',
+        "- Connection type must be an Object type",
+        "- Connection type must contain a field `edges` that return a list type that wraps an edge type",
+        "- Connection type must contain a field `pageInfo` that return a non-null `PageInfo` Object type"
+      ].join(`
+`),
+      url: "https://the-guild.dev/graphql/eslint/rules/relay-connection-types",
+      isDisabledForAllConfig: !0,
+      examples: [
+        {
+          title: "Incorrect",
+          code: (
+            /* GraphQL */
+            `
+            type UserPayload { # should be an Object type with \`Connection\` suffix
+              edges: UserEdge! # should return a list type
+              pageInfo: PageInfo # should return a non-null \`PageInfo\` Object type
+            }
+          `
+          )
+        },
+        {
+          title: "Correct",
+          code: (
+            /* GraphQL */
+            `
+            type UserConnection {
+              edges: [UserEdge]
+              pageInfo: PageInfo!
+            }
+          `
+          )
+        }
+      ]
+    },
+    messages: {
+      // Connection types
+      [MUST_BE_OBJECT_TYPE]: "Connection type must be an Object type.",
+      [MUST_HAVE_CONNECTION_SUFFIX]: "Connection type must have `Connection` suffix.",
+      [MUST_CONTAIN_FIELD_EDGES]: "Connection type must contain a field `edges` that return a list type.",
+      [MUST_CONTAIN_FIELD_PAGE_INFO]: "Connection type must contain a field `pageInfo` that return a non-null `PageInfo` Object type.",
+      [EDGES_FIELD_MUST_RETURN_LIST_TYPE]: "`edges` field must return a list type.",
+      [PAGE_INFO_FIELD_MUST_RETURN_NON_NULL_TYPE]: "`pageInfo` field must return a non-null `PageInfo` Object type."
+    },
+    schema: []
+  },
+  create(context) {
+    return {
+      [notConnectionTypesSelector](node) {
+        context.report({ node, messageId: MUST_BE_OBJECT_TYPE });
+      },
+      ":matches(ObjectTypeDefinition, ObjectTypeExtension)[name.value!=/Connection$/]"(node) {
+        hasEdgesField(node) && hasPageInfoField(node) && context.report({ node: node.name, messageId: MUST_HAVE_CONNECTION_SUFFIX });
+      },
+      ":matches(ObjectTypeDefinition, ObjectTypeExtension)[name.value=/Connection$/]"(node) {
+        hasEdgesField(node) || context.report({ node: node.name, messageId: MUST_CONTAIN_FIELD_EDGES }), hasPageInfoField(node) || context.report({ node: node.name, messageId: MUST_CONTAIN_FIELD_PAGE_INFO });
+      },
+      ":matches(ObjectTypeDefinition, ObjectTypeExtension)[name.value=/Connection$/] > FieldDefinition[name.value=edges] > .gqlType"(node) {
+        node.kind === import_graphql.Kind.LIST_TYPE || node.kind === import_graphql.Kind.NON_NULL_TYPE && node.gqlType.kind === import_graphql.Kind.LIST_TYPE || context.report({ node, messageId: EDGES_FIELD_MUST_RETURN_LIST_TYPE });
+      },
+      ":matches(ObjectTypeDefinition, ObjectTypeExtension)[name.value=/Connection$/] > FieldDefinition[name.value=pageInfo] > .gqlType"(node) {
+        node.kind === import_graphql.Kind.NON_NULL_TYPE && node.gqlType.kind === import_graphql.Kind.NAMED_TYPE && node.gqlType.name.value === "PageInfo" || context.report({ node, messageId: PAGE_INFO_FIELD_MUST_RETURN_NON_NULL_TYPE });
+      }
+    };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  NON_OBJECT_TYPES,
+  rule
+});

package/cjs/rules/relay-edge-types.d.ts

@@ -0,0 +1,40 @@
+import { FromSchema } from 'json-schema-to-ts';
+import { GraphQLESLintRule } from '../types.js';
+import 'eslint';
+import 'estree';
+import 'graphql';
+import '../siblings.js';
+import '@graphql-tools/utils';
+import '../estree-converter/types.js';
+import 'graphql-config';
+
+declare const schema: {
+    readonly type: "array";
+    readonly maxItems: 1;
+    readonly items: {
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly minProperties: 1;
+        readonly properties: {
+            readonly withEdgeSuffix: {
+                readonly type: "boolean";
+                readonly default: true;
+                readonly description: "Edge type name must end in \"Edge\".";
+            };
+            readonly shouldImplementNode: {
+                readonly type: "boolean";
+                readonly default: true;
+                readonly description: "Edge type's field `node` must implement `Node` interface.";
+            };
+            readonly listTypeCanWrapOnlyEdgeType: {
+                readonly type: "boolean";
+                readonly default: true;
+                readonly description: "A list type should only wrap an edge type.";
+            };
+        };
+    };
+};
+type RuleOptions = FromSchema<typeof schema>;
+declare const rule: GraphQLESLintRule<RuleOptions, true>;
+
+export { RuleOptions, rule };

package/cjs/rules/relay-edge-types.js

@@ -0,0 +1,161 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: !0 });
+}, __copyProps = (to, from, except, desc) => {
+  if (from && typeof from == "object" || typeof from == "function")
+    for (let key of __getOwnPropNames(from))
+      !__hasOwnProp.call(to, key) && key !== except && __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: !0 }), mod);
+var relay_edge_types_exports = {};
+__export(relay_edge_types_exports, {
+  rule: () => rule
+});
+module.exports = __toCommonJS(relay_edge_types_exports);
+var import_utils = require("@graphql-tools/utils"), import_graphql = require("graphql"), import_utils2 = require("../utils.js");
+const RULE_ID = "relay-edge-types", MESSAGE_MUST_BE_OBJECT_TYPE = "MESSAGE_MUST_BE_OBJECT_TYPE", MESSAGE_MISSING_EDGE_SUFFIX = "MESSAGE_MISSING_EDGE_SUFFIX", MESSAGE_LIST_TYPE_ONLY_EDGE_TYPE = "MESSAGE_LIST_TYPE_ONLY_EDGE_TYPE", MESSAGE_SHOULD_IMPLEMENTS_NODE = "MESSAGE_SHOULD_IMPLEMENTS_NODE";
+let edgeTypesCache;
+function getEdgeTypes(schema2) {
+  if (edgeTypesCache)
+    return edgeTypesCache;
+  const edgeTypes = /* @__PURE__ */ new Set(), visitor = {
+    ObjectTypeDefinition(node) {
+      if (!node.name.value.endsWith("Connection"))
+        return;
+      const edges = node.fields?.find((field) => field.name.value === "edges");
+      if (edges) {
+        const edgesTypeName = (0, import_utils2.getTypeName)(edges), edgesType = schema2.getType(edgesTypeName);
+        (0, import_graphql.isObjectType)(edgesType) && edgeTypes.add(edgesTypeName);
+      }
+    }
+  }, astNode = (0, import_utils.getDocumentNodeFromSchema)(schema2);
+  return (0, import_graphql.visit)(astNode, visitor), edgeTypesCache = edgeTypes, edgeTypesCache;
+}
+const schema = {
+  type: "array",
+  maxItems: 1,
+  items: {
+    type: "object",
+    additionalProperties: !1,
+    minProperties: 1,
+    properties: {
+      withEdgeSuffix: {
+        type: "boolean",
+        default: !0,
+        description: 'Edge type name must end in "Edge".'
+      },
+      shouldImplementNode: {
+        type: "boolean",
+        default: !0,
+        description: "Edge type's field `node` must implement `Node` interface."
+      },
+      listTypeCanWrapOnlyEdgeType: {
+        type: "boolean",
+        default: !0,
+        description: "A list type should only wrap an edge type."
+      }
+    }
+  }
+}, rule = {
+  meta: {
+    type: "problem",
+    docs: {
+      category: "Schema",
+      description: [
+        "Set of rules to follow Relay specification for Edge types.",
+        "",
+        "- A type that is returned in list form by a connection type's `edges` field is considered by this spec to be an Edge type",
+        "- Edge type must be an Object type",
+        "- Edge type must contain a field `node` that return either Scalar, Enum, Object, Interface, Union, or a non-null wrapper around one of those types. Notably, this field cannot return a list",
+        "- Edge type must contain a field `cursor` that return either String, Scalar, or a non-null wrapper around one of those types",
+        '- Edge type name must end in "Edge" _(optional)_',
+        "- Edge type's field `node` must implement `Node` interface _(optional)_",
+        "- A list type should only wrap an edge type _(optional)_"
+      ].join(`
+`),
+      url: `https://the-guild.dev/graphql/eslint/rules/${RULE_ID}`,
+      isDisabledForAllConfig: !0,
+      requiresSchema: !0,
+      examples: [
+        {
+          title: "Correct",
+          code: (
+            /* GraphQL */
+            `
+            type UserConnection {
+              edges: [UserEdge]
+              pageInfo: PageInfo!
+            }
+          `
+          )
+        }
+      ]
+    },
+    messages: {
+      [MESSAGE_MUST_BE_OBJECT_TYPE]: "Edge type must be an Object type.",
+      [MESSAGE_MISSING_EDGE_SUFFIX]: 'Edge type must have "Edge" suffix.',
+      [MESSAGE_LIST_TYPE_ONLY_EDGE_TYPE]: "A list type should only wrap an edge type.",
+      [MESSAGE_SHOULD_IMPLEMENTS_NODE]: "Edge type's field `node` must implement `Node` interface."
+    },
+    schema
+  },
+  create(context) {
+    const schema2 = (0, import_utils2.requireGraphQLSchemaFromContext)(RULE_ID, context), edgeTypes = getEdgeTypes(schema2), options = {
+      withEdgeSuffix: !0,
+      shouldImplementNode: !0,
+      listTypeCanWrapOnlyEdgeType: !0,
+      ...context.options[0]
+    }, isNamedOrNonNullNamed = (node) => node.kind === import_graphql.Kind.NAMED_TYPE || node.kind === import_graphql.Kind.NON_NULL_TYPE && node.gqlType.kind === import_graphql.Kind.NAMED_TYPE, checkNodeField = (node) => {
+      const nodeField = node.fields?.find((field) => field.name.value === "node"), message = "return either a Scalar, Enum, Object, Interface, Union, or a non-null wrapper around one of those types.";
+      if (!nodeField)
+        context.report({
+          node: node.name,
+          message: `Edge type must contain a field \`node\` that ${message}`
+        });
+      else if (!isNamedOrNonNullNamed(nodeField.gqlType))
+        context.report({ node: nodeField.name, message: `Field \`node\` must ${message}` });
+      else if (options.shouldImplementNode) {
+        const nodeReturnTypeName = (0, import_utils2.getTypeName)(nodeField.gqlType.rawNode()), type = schema2.getType(nodeReturnTypeName);
+        if (!(0, import_graphql.isObjectType)(type))
+          return;
+        type.astNode.interfaces?.some((n) => n.name.value === "Node") || context.report({ node: node.name, messageId: MESSAGE_SHOULD_IMPLEMENTS_NODE });
+      }
+    }, checkCursorField = (node) => {
+      const cursorField = node.fields?.find((field) => field.name.value === "cursor"), message = "return either a String, Scalar, or a non-null wrapper wrapper around one of those types.";
+      if (!cursorField) {
+        context.report({
+          node: node.name,
+          message: `Edge type must contain a field \`cursor\` that ${message}`
+        });
+        return;
+      }
+      const typeName = (0, import_utils2.getTypeName)(cursorField.rawNode());
+      (!isNamedOrNonNullNamed(cursorField.gqlType) || typeName !== "String" && !(0, import_graphql.isScalarType)(schema2.getType(typeName))) && context.report({ node: cursorField.name, message: `Field \`cursor\` must ${message}` });
+    }, listeners = {
+      ":matches(ObjectTypeDefinition, ObjectTypeExtension)[name.value=/Connection$/] > FieldDefinition[name.value=edges] > .gqlType Name"(node) {
+        const type = schema2.getType(node.value);
+        (0, import_graphql.isObjectType)(type) || context.report({ node, messageId: MESSAGE_MUST_BE_OBJECT_TYPE });
+      },
+      ":matches(ObjectTypeDefinition, ObjectTypeExtension)"(node) {
+        const typeName = node.name.value;
+        edgeTypes.has(typeName) && (checkNodeField(node), checkCursorField(node), options.withEdgeSuffix && !typeName.endsWith("Edge") && context.report({ node: node.name, messageId: MESSAGE_MISSING_EDGE_SUFFIX }));
+      }
+    };
+    return options.listTypeCanWrapOnlyEdgeType && (listeners["FieldDefinition > .gqlType"] = (node) => {
+      if (node.kind === import_graphql.Kind.LIST_TYPE || node.kind === import_graphql.Kind.NON_NULL_TYPE && node.gqlType.kind === import_graphql.Kind.LIST_TYPE) {
+        const typeName = (0, import_utils2.getTypeName)(node.rawNode());
+        edgeTypes.has(typeName) || context.report({ node, messageId: MESSAGE_LIST_TYPE_ONLY_EDGE_TYPE });
+      }
+    }), listeners;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  rule
+});

package/cjs/rules/relay-page-info.d.ts

@@ -0,0 +1,13 @@
+import { GraphQLESLintRule } from '../types.js';
+import 'eslint';
+import 'estree';
+import 'graphql';
+import 'json-schema-to-ts';
+import '../siblings.js';
+import '@graphql-tools/utils';
+import '../estree-converter/types.js';
+import 'graphql-config';
+
+declare const rule: GraphQLESLintRule;
+
+export { rule };

package/cjs/rules/relay-page-info.js

@@ -0,0 +1,98 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: !0 });
+}, __copyProps = (to, from, except, desc) => {
+  if (from && typeof from == "object" || typeof from == "function")
+    for (let key of __getOwnPropNames(from))
+      !__hasOwnProp.call(to, key) && key !== except && __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: !0 }), mod);
+var relay_page_info_exports = {};
+__export(relay_page_info_exports, {
+  rule: () => rule
+});
+module.exports = __toCommonJS(relay_page_info_exports);
+var import_graphql = require("graphql"), import_utils = require("../utils.js"), import_relay_connection_types = require("./relay-connection-types.js");
+const RULE_ID = "relay-page-info", MESSAGE_MUST_EXIST = "MESSAGE_MUST_EXIST", MESSAGE_MUST_BE_OBJECT_TYPE = "MESSAGE_MUST_BE_OBJECT_TYPE", notPageInfoTypesSelector = `:matches(${import_relay_connection_types.NON_OBJECT_TYPES})[name.value=PageInfo] > .name`;
+let hasPageInfoChecked = !1;
+const rule = {
+  meta: {
+    type: "problem",
+    docs: {
+      category: "Schema",
+      description: [
+        "Set of rules to follow Relay specification for `PageInfo` object.",
+        "",
+        "- `PageInfo` must be an Object type",
+        "- `PageInfo` must contain fields `hasPreviousPage` and `hasNextPage`, that return non-null Boolean",
+        "- `PageInfo` must contain fields `startCursor` and `endCursor`, that return either String or Scalar, which can be null if there are no results"
+      ].join(`
+`),
+      url: `https://the-guild.dev/graphql/eslint/rules/${RULE_ID}`,
+      examples: [
+        {
+          title: "Correct",
+          code: (
+            /* GraphQL */
+            `
+            type PageInfo {
+              hasPreviousPage: Boolean!
+              hasNextPage: Boolean!
+              startCursor: String
+              endCursor: String
+            }
+          `
+          )
+        }
+      ],
+      isDisabledForAllConfig: !0,
+      requiresSchema: !0
+    },
+    messages: {
+      [MESSAGE_MUST_EXIST]: "The server must provide a `PageInfo` object.",
+      [MESSAGE_MUST_BE_OBJECT_TYPE]: "`PageInfo` must be an Object type."
+    },
+    schema: []
+  },
+  create(context) {
+    const schema = (0, import_utils.requireGraphQLSchemaFromContext)(RULE_ID, context);
+    return hasPageInfoChecked || (schema.getType("PageInfo") || context.report({
+      loc: import_utils.REPORT_ON_FIRST_CHARACTER,
+      messageId: MESSAGE_MUST_EXIST
+    }), hasPageInfoChecked = !0), {
+      [notPageInfoTypesSelector](node) {
+        context.report({ node, messageId: MESSAGE_MUST_BE_OBJECT_TYPE });
+      },
+      "ObjectTypeDefinition[name.value=PageInfo]"(node) {
+        const fieldMap = Object.fromEntries(
+          node.fields?.map((field) => [field.name.value, field]) || []
+        ), checkField = (fieldName, typeName) => {
+          const field = fieldMap[fieldName];
+          let isAllowedType = !1;
+          if (field) {
+            const type = field.gqlType;
+            typeName === "Boolean" ? isAllowedType = type.kind === import_graphql.Kind.NON_NULL_TYPE && type.gqlType.kind === import_graphql.Kind.NAMED_TYPE && type.gqlType.name.value === "Boolean" : type.kind === import_graphql.Kind.NAMED_TYPE && (isAllowedType = type.name.value === "String" || (0, import_graphql.isScalarType)(schema.getType(type.name.value)));
+          }
+          if (!isAllowedType) {
+            const returnType = typeName === "Boolean" ? "non-null Boolean" : "either String or Scalar, which can be null if there are no results";
+            context.report({
+              node: field ? field.name : node.name,
+              message: field ? `Field \`${fieldName}\` must return ${returnType}.` : `\`PageInfo\` must contain a field \`${fieldName}\`, that return ${returnType}.`
+            });
+          }
+        };
+        checkField("hasPreviousPage", "Boolean"), checkField("hasNextPage", "Boolean"), checkField("startCursor", "String"), checkField("endCursor", "String");
+      }
+    };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  rule
+});

package/cjs/rules/require-deprecation-date.d.ts

@@ -0,0 +1,27 @@
+import { FromSchema } from 'json-schema-to-ts';
+import { GraphQLESLintRule } from '../types.js';
+import 'eslint';
+import 'estree';
+import 'graphql';
+import '../siblings.js';
+import '@graphql-tools/utils';
+import '../estree-converter/types.js';
+import 'graphql-config';
+
+declare const schema: {
+    readonly type: "array";
+    readonly maxItems: 1;
+    readonly items: {
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly properties: {
+            readonly argumentName: {
+                readonly type: "string";
+            };
+        };
+    };
+};
+type RuleOptions = FromSchema<typeof schema>;
+declare const rule: GraphQLESLintRule<RuleOptions>;
+
+export { RuleOptions, rule };

package/cjs/rules/require-deprecation-date.js

@@ -0,0 +1,148 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: !0 });
+}, __copyProps = (to, from, except, desc) => {
+  if (from && typeof from == "object" || typeof from == "function")
+    for (let key of __getOwnPropNames(from))
+      !__hasOwnProp.call(to, key) && key !== except && __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: !0 }), mod);
+var require_deprecation_date_exports = {};
+__export(require_deprecation_date_exports, {
+  rule: () => rule
+});
+module.exports = __toCommonJS(require_deprecation_date_exports);
+var import_estree_converter = require("../estree-converter/index.js"), import_utils = require("../utils.js");
+const DATE_REGEX = /^\d{2}\/\d{2}\/\d{4}$/, MESSAGE_REQUIRE_DATE = "MESSAGE_REQUIRE_DATE", MESSAGE_INVALID_FORMAT = "MESSAGE_INVALID_FORMAT", MESSAGE_INVALID_DATE = "MESSAGE_INVALID_DATE", MESSAGE_CAN_BE_REMOVED = "MESSAGE_CAN_BE_REMOVED", schema = {
+  type: "array",
+  maxItems: 1,
+  items: {
+    type: "object",
+    additionalProperties: !1,
+    properties: {
+      argumentName: {
+        type: "string"
+      }
+    }
+  }
+}, rule = {
+  meta: {
+    type: "suggestion",
+    hasSuggestions: !0,
+    docs: {
+      category: "Schema",
+      description: "Require deletion date on `@deprecated` directive. Suggest removing deprecated things after deprecated date.",
+      url: "https://the-guild.dev/graphql/eslint/rules/require-deprecation-date",
+      examples: [
+        {
+          title: "Incorrect",
+          code: (
+            /* GraphQL */
+            `
+            type User {
+              firstname: String @deprecated
+              firstName: String
+            }
+          `
+          )
+        },
+        {
+          title: "Incorrect",
+          code: (
+            /* GraphQL */
+            `
+            type User {
+              firstname: String @deprecated(reason: "Use 'firstName' instead")
+              firstName: String
+            }
+          `
+          )
+        },
+        {
+          title: "Correct",
+          code: (
+            /* GraphQL */
+            `
+            type User {
+              firstname: String
+                @deprecated(reason: "Use 'firstName' instead", deletionDate: "25/12/2022")
+              firstName: String
+            }
+          `
+          )
+        }
+      ]
+    },
+    messages: {
+      [MESSAGE_REQUIRE_DATE]: 'Directive "@deprecated" must have a deletion date for {{ nodeName }}',
+      [MESSAGE_INVALID_FORMAT]: 'Deletion date must be in format "DD/MM/YYYY" for {{ nodeName }}',
+      [MESSAGE_INVALID_DATE]: 'Invalid "{{ deletionDate }}" deletion date for {{ nodeName }}',
+      [MESSAGE_CAN_BE_REMOVED]: "{{ nodeName }} \u0441an be removed"
+    },
+    schema
+  },
+  create(context) {
+    return {
+      "Directive[name.value=deprecated]"(node) {
+        const argName = context.options[0]?.argumentName || "deletionDate", deletionDateNode = node.arguments?.find((arg) => arg.name.value === argName);
+        if (!deletionDateNode) {
+          context.report({
+            node: node.name,
+            messageId: MESSAGE_REQUIRE_DATE,
+            data: {
+              nodeName: (0, import_utils.getNodeName)(node.parent)
+            }
+          });
+          return;
+        }
+        const deletionDate = (0, import_estree_converter.valueFromNode)(deletionDateNode.value);
+        if (!DATE_REGEX.test(deletionDate)) {
+          context.report({
+            node: deletionDateNode.value,
+            messageId: MESSAGE_INVALID_FORMAT,
+            data: { nodeName: (0, import_utils.getNodeName)(node.parent) }
+          });
+          return;
+        }
+        let [day, month, year] = deletionDate.split("/");
+        day = day.padStart(2, "0"), month = month.padStart(2, "0");
+        const deletionDateInMS = Date.parse(`${year}-${month}-${day}`);
+        if (Number.isNaN(deletionDateInMS)) {
+          context.report({
+            node: deletionDateNode.value,
+            messageId: MESSAGE_INVALID_DATE,
+            data: {
+              deletionDate,
+              nodeName: (0, import_utils.getNodeName)(node.parent)
+            }
+          });
+          return;
+        }
+        if (Date.now() > deletionDateInMS) {
+          const { parent } = node, nodeName = parent.name.value;
+          context.report({
+            node: parent.name,
+            messageId: MESSAGE_CAN_BE_REMOVED,
+            data: { nodeName: (0, import_utils.getNodeName)(parent) },
+            suggest: [
+              {
+                desc: `Remove \`${nodeName}\``,
+                fix: (fixer) => fixer.remove(parent)
+              }
+            ]
+          });
+        }
+      }
+    };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  rule
+});

package/cjs/rules/require-deprecation-reason.d.ts

@@ -0,0 +1,13 @@
+import { GraphQLESLintRule } from '../types.js';
+import 'eslint';
+import 'estree';
+import 'graphql';
+import 'json-schema-to-ts';
+import '../siblings.js';
+import '@graphql-tools/utils';
+import '../estree-converter/types.js';
+import 'graphql-config';
+
+declare const rule: GraphQLESLintRule;
+
+export { rule };