graphql 16.13.2 → 16.14.0

package/index.d.ts

@@ -280,6 +280,7 @@ export type {
   UnionTypeExtensionNode,
   EnumTypeExtensionNode,
   InputObjectTypeExtensionNode,
+  DirectiveExtensionNode,
   SchemaCoordinateNode,
   TypeCoordinateNode,
   MemberCoordinateNode,

package/language/ast.d.ts

@@ -135,6 +135,7 @@ export declare type ASTNode =
   | UnionTypeExtensionNode
   | EnumTypeExtensionNode
   | InputObjectTypeExtensionNode
+  | DirectiveExtensionNode
   | TypeCoordinateNode
   | MemberCoordinateNode
   | ArgumentCoordinateNode
@@ -480,13 +481,15 @@ export interface DirectiveDefinitionNode {
   readonly description?: StringValueNode;
   readonly name: NameNode;
   readonly arguments?: ReadonlyArray<InputValueDefinitionNode>;
+  readonly directives?: ReadonlyArray<ConstDirectiveNode>;
   readonly repeatable: boolean;
   readonly locations: ReadonlyArray<NameNode>;
 }
 /** Type System Extensions */
 export declare type TypeSystemExtensionNode =
   | SchemaExtensionNode
-  | TypeExtensionNode;
+  | TypeExtensionNode
+  | DirectiveExtensionNode;
 export interface SchemaExtensionNode {
   readonly kind: Kind.SCHEMA_EXTENSION;
   readonly loc?: Location;
@@ -544,6 +547,12 @@ export interface InputObjectTypeExtensionNode {
   readonly directives?: ReadonlyArray<ConstDirectiveNode>;
   readonly fields?: ReadonlyArray<InputValueDefinitionNode>;
 }
+export interface DirectiveExtensionNode {
+  readonly kind: Kind.DIRECTIVE_EXTENSION;
+  readonly loc?: Location;
+  readonly name: NameNode;
+  readonly directives?: ReadonlyArray<ConstDirectiveNode>;
+}
 /** Schema Coordinates */
 export declare type SchemaCoordinateNode =
   | TypeCoordinateNode

package/language/ast.js

@@ -200,8 +200,15 @@ const QueryDocumentKeys = {
   EnumTypeDefinition: ['description', 'name', 'directives', 'values'],
   EnumValueDefinition: ['description', 'name', 'directives'],
   InputObjectTypeDefinition: ['description', 'name', 'directives', 'fields'],
-  DirectiveDefinition: ['description', 'name', 'arguments', 'locations'],
+  DirectiveDefinition: [
+    'description',
+    'name',
+    'arguments',
+    'directives',
+    'locations',
+  ],
   SchemaExtension: ['directives', 'operationTypes'],
+  DirectiveExtension: ['name', 'directives'],
   ScalarTypeExtension: ['name', 'directives'],
   ObjectTypeExtension: ['name', 'interfaces', 'directives', 'fields'],
   InterfaceTypeExtension: ['name', 'interfaces', 'directives', 'fields'],

package/language/ast.mjs

@@ -184,8 +184,15 @@ export const QueryDocumentKeys = {
   EnumTypeDefinition: ['description', 'name', 'directives', 'values'],
   EnumValueDefinition: ['description', 'name', 'directives'],
   InputObjectTypeDefinition: ['description', 'name', 'directives', 'fields'],
-  DirectiveDefinition: ['description', 'name', 'arguments', 'locations'],
+  DirectiveDefinition: [
+    'description',
+    'name',
+    'arguments',
+    'directives',
+    'locations',
+  ],
   SchemaExtension: ['directives', 'operationTypes'],
+  DirectiveExtension: ['name', 'directives'],
   ScalarTypeExtension: ['name', 'directives'],
   ObjectTypeExtension: ['name', 'interfaces', 'directives', 'fields'],
   InterfaceTypeExtension: ['name', 'interfaces', 'directives', 'fields'],

package/language/directiveLocation.d.ts

@@ -23,6 +23,7 @@ declare enum DirectiveLocation {
   ENUM_VALUE = 'ENUM_VALUE',
   INPUT_OBJECT = 'INPUT_OBJECT',
   INPUT_FIELD_DEFINITION = 'INPUT_FIELD_DEFINITION',
+  DIRECTIVE_DEFINITION = 'DIRECTIVE_DEFINITION',
 }
 export { DirectiveLocation };
 /**

package/language/directiveLocation.js

@@ -31,6 +31,7 @@ exports.DirectiveLocation = DirectiveLocation;
   DirectiveLocation['ENUM_VALUE'] = 'ENUM_VALUE';
   DirectiveLocation['INPUT_OBJECT'] = 'INPUT_OBJECT';
   DirectiveLocation['INPUT_FIELD_DEFINITION'] = 'INPUT_FIELD_DEFINITION';
+  DirectiveLocation['DIRECTIVE_DEFINITION'] = 'DIRECTIVE_DEFINITION';
 })(DirectiveLocation || (exports.DirectiveLocation = DirectiveLocation = {}));
 /**
  * The enum type representing the directive location values.

package/language/directiveLocation.mjs

@@ -23,6 +23,7 @@ var DirectiveLocation;
   DirectiveLocation['ENUM_VALUE'] = 'ENUM_VALUE';
   DirectiveLocation['INPUT_OBJECT'] = 'INPUT_OBJECT';
   DirectiveLocation['INPUT_FIELD_DEFINITION'] = 'INPUT_FIELD_DEFINITION';
+  DirectiveLocation['DIRECTIVE_DEFINITION'] = 'DIRECTIVE_DEFINITION';
 })(DirectiveLocation || (DirectiveLocation = {}));
 
 export { DirectiveLocation };

package/language/index.d.ts

@@ -86,6 +86,7 @@ export type {
   UnionTypeExtensionNode,
   EnumTypeExtensionNode,
   InputObjectTypeExtensionNode,
+  DirectiveExtensionNode,
   SchemaCoordinateNode,
   TypeCoordinateNode,
   MemberCoordinateNode,

package/language/kinds.d.ts

@@ -49,6 +49,7 @@ declare enum Kind {
   DIRECTIVE_DEFINITION = 'DirectiveDefinition',
   /** Type System Extensions */
   SCHEMA_EXTENSION = 'SchemaExtension',
+  DIRECTIVE_EXTENSION = 'DirectiveExtension',
   /** Type Extensions */
   SCALAR_TYPE_EXTENSION = 'ScalarTypeExtension',
   OBJECT_TYPE_EXTENSION = 'ObjectTypeExtension',

package/language/kinds.js

@@ -49,6 +49,7 @@ exports.Kind = Kind;
   Kind['INPUT_OBJECT_TYPE_DEFINITION'] = 'InputObjectTypeDefinition';
   Kind['DIRECTIVE_DEFINITION'] = 'DirectiveDefinition';
   Kind['SCHEMA_EXTENSION'] = 'SchemaExtension';
+  Kind['DIRECTIVE_EXTENSION'] = 'DirectiveExtension';
   Kind['SCALAR_TYPE_EXTENSION'] = 'ScalarTypeExtension';
   Kind['OBJECT_TYPE_EXTENSION'] = 'ObjectTypeExtension';
   Kind['INTERFACE_TYPE_EXTENSION'] = 'InterfaceTypeExtension';

package/language/kinds.mjs

@@ -41,6 +41,7 @@ var Kind;
   Kind['INPUT_OBJECT_TYPE_DEFINITION'] = 'InputObjectTypeDefinition';
   Kind['DIRECTIVE_DEFINITION'] = 'DirectiveDefinition';
   Kind['SCHEMA_EXTENSION'] = 'SchemaExtension';
+  Kind['DIRECTIVE_EXTENSION'] = 'DirectiveExtension';
   Kind['SCALAR_TYPE_EXTENSION'] = 'ScalarTypeExtension';
   Kind['OBJECT_TYPE_EXTENSION'] = 'ObjectTypeExtension';
   Kind['INTERFACE_TYPE_EXTENSION'] = 'InterfaceTypeExtension';

package/language/parser.d.ts

@@ -10,6 +10,7 @@ import type {
   ConstValueNode,
   DefinitionNode,
   DirectiveDefinitionNode,
+  DirectiveExtensionNode,
   DirectiveNode,
   DocumentNode,
   EnumTypeDefinitionNode,
@@ -89,6 +90,17 @@ export interface ParseOptions {
    * ```
    */
   allowLegacyFragmentVariables?: boolean;
+  /**
+   * EXPERIMENTAL:
+   *
+   * If enabled, the parser will parse directives on directive definitions.
+   * This syntax is not part of the GraphQL specification and may change.
+   *
+   * ```graphql
+   * directive @foo @bar on FIELD
+   * ```
+   */
+  experimentalDirectivesOnDirectiveDefinitions?: boolean;
   /**
    * You may override the Lexer class used to lex the source; this is used by
    * schema coordinates to introduce a lexer with a restricted syntax.
@@ -447,6 +459,7 @@ export declare class Parser {
    *   - UnionTypeExtension
    *   - EnumTypeExtension
    *   - InputObjectTypeDefinition
+   *   - DirectiveDefinitionExtension
    */
   parseTypeSystemExtension(): TypeSystemExtensionNode;
   /**
@@ -494,6 +507,7 @@ export declare class Parser {
    *   - extend input Name Directives[Const]
    */
   parseInputObjectTypeExtension(): InputObjectTypeExtensionNode;
+  parseDirectiveDefinitionExtension(): DirectiveExtensionNode;
   /**
    * ```
    * DirectiveDefinition :

package/language/parser.js

@@ -1112,6 +1112,7 @@ class Parser {
    *   - UnionTypeExtension
    *   - EnumTypeExtension
    *   - InputObjectTypeDefinition
+   *   - DirectiveDefinitionExtension
    */
 
   parseTypeSystemExtension() {
@@ -1139,6 +1140,13 @@ class Parser {
 
         case 'input':
           return this.parseInputObjectTypeExtension();
+
+        case 'directive':
+          if (this._options.experimentalDirectivesOnDirectiveDefinitions) {
+            return this.parseDirectiveDefinitionExtension();
+          }
+
+          break;
       }
     }
 
@@ -1334,6 +1342,25 @@ class Parser {
       fields,
     });
   }
+
+  parseDirectiveDefinitionExtension() {
+    const start = this._lexer.token;
+    this.expectKeyword('extend');
+    this.expectKeyword('directive');
+    this.expectToken(_tokenKind.TokenKind.AT);
+    const name = this.parseName();
+    const directives = this.parseConstDirectives();
+
+    if (directives.length === 0) {
+      throw this.unexpected();
+    }
+
+    return this.node(start, {
+      kind: _kinds.Kind.DIRECTIVE_EXTENSION,
+      name,
+      directives,
+    });
+  }
   /**
    * ```
    * DirectiveDefinition :
@@ -1348,6 +1375,10 @@ class Parser {
     this.expectToken(_tokenKind.TokenKind.AT);
     const name = this.parseName();
     const args = this.parseArgumentDefs();
+    const directives = this._options
+      .experimentalDirectivesOnDirectiveDefinitions
+      ? this.parseConstDirectives()
+      : [];
     const repeatable = this.expectOptionalKeyword('repeatable');
     this.expectKeyword('on');
     const locations = this.parseDirectiveLocations();
@@ -1356,6 +1387,7 @@ class Parser {
       description,
       name,
       arguments: args,
+      directives,
       repeatable,
       locations,
     });
@@ -1398,6 +1430,7 @@ class Parser {
    *   `ENUM_VALUE`
    *   `INPUT_OBJECT`
    *   `INPUT_FIELD_DEFINITION`
+   *   `DIRECTIVE_DEFINITION`
    */
 
   parseDirectiveLocation() {

package/language/parser.mjs

@@ -1075,6 +1075,7 @@ export class Parser {
    *   - UnionTypeExtension
    *   - EnumTypeExtension
    *   - InputObjectTypeDefinition
+   *   - DirectiveDefinitionExtension
    */
 
   parseTypeSystemExtension() {
@@ -1102,6 +1103,13 @@ export class Parser {
 
         case 'input':
           return this.parseInputObjectTypeExtension();
+
+        case 'directive':
+          if (this._options.experimentalDirectivesOnDirectiveDefinitions) {
+            return this.parseDirectiveDefinitionExtension();
+          }
+
+          break;
       }
     }
 
@@ -1297,6 +1305,25 @@ export class Parser {
       fields,
     });
   }
+
+  parseDirectiveDefinitionExtension() {
+    const start = this._lexer.token;
+    this.expectKeyword('extend');
+    this.expectKeyword('directive');
+    this.expectToken(TokenKind.AT);
+    const name = this.parseName();
+    const directives = this.parseConstDirectives();
+
+    if (directives.length === 0) {
+      throw this.unexpected();
+    }
+
+    return this.node(start, {
+      kind: Kind.DIRECTIVE_EXTENSION,
+      name,
+      directives,
+    });
+  }
   /**
    * ```
    * DirectiveDefinition :
@@ -1311,6 +1338,10 @@ export class Parser {
     this.expectToken(TokenKind.AT);
     const name = this.parseName();
     const args = this.parseArgumentDefs();
+    const directives = this._options
+      .experimentalDirectivesOnDirectiveDefinitions
+      ? this.parseConstDirectives()
+      : [];
     const repeatable = this.expectOptionalKeyword('repeatable');
     this.expectKeyword('on');
     const locations = this.parseDirectiveLocations();
@@ -1319,6 +1350,7 @@ export class Parser {
       description,
       name,
       arguments: args,
+      directives,
       repeatable,
       locations,
     });
@@ -1358,6 +1390,7 @@ export class Parser {
    *   `ENUM_VALUE`
    *   `INPUT_OBJECT`
    *   `INPUT_FIELD_DEFINITION`
+   *   `DIRECTIVE_DEFINITION`
    */
 
   parseDirectiveLocation() {

package/language/predicates.js

@@ -94,7 +94,9 @@ function isTypeDefinitionNode(node) {
 
 function isTypeSystemExtensionNode(node) {
   return (
-    node.kind === _kinds.Kind.SCHEMA_EXTENSION || isTypeExtensionNode(node)
+    node.kind === _kinds.Kind.SCHEMA_EXTENSION ||
+    node.kind === _kinds.Kind.DIRECTIVE_EXTENSION ||
+    isTypeExtensionNode(node)
   );
 }
 

package/language/predicates.mjs

@@ -67,7 +67,11 @@ export function isTypeDefinitionNode(node) {
   );
 }
 export function isTypeSystemExtensionNode(node) {
-  return node.kind === Kind.SCHEMA_EXTENSION || isTypeExtensionNode(node);
+  return (
+    node.kind === Kind.SCHEMA_EXTENSION ||
+    node.kind === Kind.DIRECTIVE_EXTENSION ||
+    isTypeExtensionNode(node)
+  );
 }
 export function isTypeExtensionNode(node) {
   return (

package/language/printer.js

@@ -240,13 +240,21 @@ const printDocASTReducer = {
       join(['input', name, join(directives, ' '), block(fields)], ' '),
   },
   DirectiveDefinition: {
-    leave: ({ description, name, arguments: args, repeatable, locations }) =>
+    leave: ({
+      description,
+      name,
+      arguments: args,
+      directives,
+      repeatable,
+      locations,
+    }) =>
       wrap('', description, '\n') +
       'directive @' +
       name +
       (hasMultilineItems(args)
         ? wrap('(\n', indent(join(args, '\n')), '\n)')
         : wrap('(', join(args, ', '), ')')) +
+      wrap(' ', join(directives, ' ')) +
       (repeatable ? ' repeatable' : '') +
       ' on ' +
       join(locations, ' | '),
@@ -308,6 +316,10 @@ const printDocASTReducer = {
     leave: ({ name, directives, fields }) =>
       join(['extend input', name, join(directives, ' '), block(fields)], ' '),
   },
+  DirectiveExtension: {
+    leave: ({ name, directives }) =>
+      join(['extend directive @' + name, join(directives, ' ')], ' '),
+  },
   // Schema Coordinates
   TypeCoordinate: {
     leave: ({ name }) => name,

package/language/printer.mjs

@@ -228,13 +228,21 @@ const printDocASTReducer = {
       join(['input', name, join(directives, ' '), block(fields)], ' '),
   },
   DirectiveDefinition: {
-    leave: ({ description, name, arguments: args, repeatable, locations }) =>
+    leave: ({
+      description,
+      name,
+      arguments: args,
+      directives,
+      repeatable,
+      locations,
+    }) =>
       wrap('', description, '\n') +
       'directive @' +
       name +
       (hasMultilineItems(args)
         ? wrap('(\n', indent(join(args, '\n')), '\n)')
         : wrap('(', join(args, ', '), ')')) +
+      wrap(' ', join(directives, ' ')) +
       (repeatable ? ' repeatable' : '') +
       ' on ' +
       join(locations, ' | '),
@@ -296,6 +304,10 @@ const printDocASTReducer = {
     leave: ({ name, directives, fields }) =>
       join(['extend input', name, join(directives, ' '), block(fields)], ' '),
   },
+  DirectiveExtension: {
+    leave: ({ name, directives }) =>
+      join(['extend directive @' + name, join(directives, ' ')], ' '),
+  },
   // Schema Coordinates
   TypeCoordinate: {
     leave: ({ name }) => name,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "graphql",
-  "version": "16.13.2",
+  "version": "16.14.0",
   "description": "A Query Language and Runtime which can target any service.",
   "license": "MIT",
   "main": "index",

package/type/directives.d.ts

@@ -1,5 +1,8 @@
 import type { Maybe } from '../jsutils/Maybe';
-import type { DirectiveDefinitionNode } from '../language/ast';
+import type {
+  DirectiveDefinitionNode,
+  DirectiveExtensionNode,
+} from '../language/ast';
 import { DirectiveLocation } from '../language/directiveLocation';
 import type {
   GraphQLArgument,
@@ -34,8 +37,10 @@ export declare class GraphQLDirective {
   locations: ReadonlyArray<DirectiveLocation>;
   args: ReadonlyArray<GraphQLArgument>;
   isRepeatable: boolean;
+  deprecationReason: Maybe<string>;
   extensions: Readonly<GraphQLDirectiveExtensions>;
   astNode: Maybe<DirectiveDefinitionNode>;
+  extensionASTNodes: ReadonlyArray<DirectiveExtensionNode>;
   constructor(config: Readonly<GraphQLDirectiveConfig>);
   get [Symbol.toStringTag](): string;
   toConfig(): GraphQLDirectiveNormalizedConfig;
@@ -48,13 +53,16 @@ export interface GraphQLDirectiveConfig {
   locations: ReadonlyArray<DirectiveLocation>;
   args?: Maybe<GraphQLFieldConfigArgumentMap>;
   isRepeatable?: Maybe<boolean>;
+  deprecationReason?: Maybe<string>;
   extensions?: Maybe<Readonly<GraphQLDirectiveExtensions>>;
   astNode?: Maybe<DirectiveDefinitionNode>;
+  extensionASTNodes?: Maybe<ReadonlyArray<DirectiveExtensionNode>>;
 }
 interface GraphQLDirectiveNormalizedConfig extends GraphQLDirectiveConfig {
   args: GraphQLFieldConfigArgumentMap;
   isRepeatable: boolean;
   extensions: Readonly<GraphQLDirectiveExtensions>;
+  extensionASTNodes: ReadonlyArray<DirectiveExtensionNode>;
 }
 /**
  * Used to conditionally include fields or fragments.

package/type/directives.js

@@ -66,7 +66,7 @@ function assertDirective(directive) {
  */
 class GraphQLDirective {
   constructor(config) {
-    var _config$isRepeatable, _config$args;
+    var _config$isRepeatable, _config$extensionASTN, _config$args;
 
     this.name = (0, _assertName.assertName)(config.name);
     this.description = config.description;
@@ -76,8 +76,14 @@ class GraphQLDirective {
       _config$isRepeatable !== void 0
         ? _config$isRepeatable
         : false;
+    this.deprecationReason = config.deprecationReason;
     this.extensions = (0, _toObjMap.toObjMap)(config.extensions);
     this.astNode = config.astNode;
+    this.extensionASTNodes =
+      (_config$extensionASTN = config.extensionASTNodes) !== null &&
+      _config$extensionASTN !== void 0
+        ? _config$extensionASTN
+        : [];
     Array.isArray(config.locations) ||
       (0, _devAssert.devAssert)(
         false,
@@ -106,8 +112,10 @@ class GraphQLDirective {
       locations: this.locations,
       args: (0, _definition.argsToArgsConfig)(this.args),
       isRepeatable: this.isRepeatable,
+      deprecationReason: this.deprecationReason,
       extensions: this.extensions,
       astNode: this.astNode,
+      extensionASTNodes: this.extensionASTNodes,
     };
   }
 
@@ -181,6 +189,7 @@ const GraphQLDeprecatedDirective = new GraphQLDirective({
     _directiveLocation.DirectiveLocation.ARGUMENT_DEFINITION,
     _directiveLocation.DirectiveLocation.INPUT_FIELD_DEFINITION,
     _directiveLocation.DirectiveLocation.ENUM_VALUE,
+    _directiveLocation.DirectiveLocation.DIRECTIVE_DEFINITION,
   ],
   args: {
     reason: {

package/type/directives.mjs

@@ -43,7 +43,7 @@ export function assertDirective(directive) {
  */
 export class GraphQLDirective {
   constructor(config) {
-    var _config$isRepeatable, _config$args;
+    var _config$isRepeatable, _config$extensionASTN, _config$args;
 
     this.name = assertName(config.name);
     this.description = config.description;
@@ -53,8 +53,14 @@ export class GraphQLDirective {
       _config$isRepeatable !== void 0
         ? _config$isRepeatable
         : false;
+    this.deprecationReason = config.deprecationReason;
     this.extensions = toObjMap(config.extensions);
     this.astNode = config.astNode;
+    this.extensionASTNodes =
+      (_config$extensionASTN = config.extensionASTNodes) !== null &&
+      _config$extensionASTN !== void 0
+        ? _config$extensionASTN
+        : [];
     Array.isArray(config.locations) ||
       devAssert(false, `@${config.name} locations must be an Array.`);
     const args =
@@ -80,8 +86,10 @@ export class GraphQLDirective {
       locations: this.locations,
       args: argsToArgsConfig(this.args),
       isRepeatable: this.isRepeatable,
+      deprecationReason: this.deprecationReason,
       extensions: this.extensions,
       astNode: this.astNode,
+      extensionASTNodes: this.extensionASTNodes,
     };
   }
 
@@ -150,6 +158,7 @@ export const GraphQLDeprecatedDirective = new GraphQLDirective({
     DirectiveLocation.ARGUMENT_DEFINITION,
     DirectiveLocation.INPUT_FIELD_DEFINITION,
     DirectiveLocation.ENUM_VALUE,
+    DirectiveLocation.DIRECTIVE_DEFINITION,
   ],
   args: {
     reason: {

package/type/introspection.js

@@ -76,7 +76,18 @@ const __Schema = new _definition.GraphQLObjectType({
           new _definition.GraphQLNonNull(__Directive),
         ),
       ),
-      resolve: (schema) => schema.getDirectives(),
+      args: {
+        includeDeprecated: {
+          type: new _definition.GraphQLNonNull(_scalars.GraphQLBoolean),
+          defaultValue: false,
+        },
+      },
+      resolve: (schema, { includeDeprecated }) =>
+        includeDeprecated
+          ? schema.getDirectives()
+          : schema
+              .getDirectives()
+              .filter((directive) => directive.deprecationReason == null),
     },
   }),
 });
@@ -127,6 +138,14 @@ const __Directive = new _definition.GraphQLObjectType({
           : field.args.filter((arg) => arg.deprecationReason == null);
       },
     },
+    isDeprecated: {
+      type: new _definition.GraphQLNonNull(_scalars.GraphQLBoolean),
+      resolve: (directive) => directive.deprecationReason != null,
+    },
+    deprecationReason: {
+      type: _scalars.GraphQLString,
+      resolve: (directive) => directive.deprecationReason,
+    },
   }),
 });
 
@@ -213,6 +232,10 @@ const __DirectiveLocation = new _definition.GraphQLEnumType({
       value: _directiveLocation.DirectiveLocation.INPUT_FIELD_DEFINITION,
       description: 'Location adjacent to an input object field definition.',
     },
+    DIRECTIVE_DEFINITION: {
+      value: _directiveLocation.DirectiveLocation.DIRECTIVE_DEFINITION,
+      description: 'Location adjacent to a directive definition.',
+    },
   },
 });
 

package/type/introspection.mjs

@@ -58,7 +58,18 @@ export const __Schema = new GraphQLObjectType({
       type: new GraphQLNonNull(
         new GraphQLList(new GraphQLNonNull(__Directive)),
       ),
-      resolve: (schema) => schema.getDirectives(),
+      args: {
+        includeDeprecated: {
+          type: new GraphQLNonNull(GraphQLBoolean),
+          defaultValue: false,
+        },
+      },
+      resolve: (schema, { includeDeprecated }) =>
+        includeDeprecated
+          ? schema.getDirectives()
+          : schema
+              .getDirectives()
+              .filter((directive) => directive.deprecationReason == null),
     },
   }),
 });
@@ -102,6 +113,14 @@ export const __Directive = new GraphQLObjectType({
           : field.args.filter((arg) => arg.deprecationReason == null);
       },
     },
+    isDeprecated: {
+      type: new GraphQLNonNull(GraphQLBoolean),
+      resolve: (directive) => directive.deprecationReason != null,
+    },
+    deprecationReason: {
+      type: GraphQLString,
+      resolve: (directive) => directive.deprecationReason,
+    },
   }),
 });
 export const __DirectiveLocation = new GraphQLEnumType({
@@ -185,6 +204,10 @@ export const __DirectiveLocation = new GraphQLEnumType({
       value: DirectiveLocation.INPUT_FIELD_DEFINITION,
       description: 'Location adjacent to an input object field definition.',
     },
+    DIRECTIVE_DEFINITION: {
+      value: DirectiveLocation.DIRECTIVE_DEFINITION,
+      description: 'Location adjacent to a directive definition.',
+    },
   },
 });
 export const __Type = new GraphQLObjectType({

package/utilities/buildASTSchema.js

@@ -105,6 +105,10 @@ function buildSchema(source, options) {
       options === null || options === void 0
         ? void 0
         : options.allowLegacyFragmentVariables,
+    experimentalDirectivesOnDirectiveDefinitions:
+      options === null || options === void 0
+        ? void 0
+        : options.experimentalDirectivesOnDirectiveDefinitions,
   });
   return buildASTSchema(document, {
     assumeValidSDL: