graphql 17.0.0-beta.1 → 17.0.0-beta.2

package/utilities/getIntrospectionQuery.d.ts

@@ -1,6 +1,8 @@
+/** @category Introspection */
 import type { Maybe } from "../jsutils/Maybe.js";
 import type { DirectiveLocation } from "../language/directiveLocation.js";
 import type { TypeKind } from "../type/introspection.js";
+/** Options controlling which fields are included in the introspection query. */
 export interface IntrospectionOptions {
     /**
      * Whether to include descriptions in the introspection result.
@@ -50,105 +52,235 @@ export interface IntrospectionOptions {
 /**
  * Produce the GraphQL query recommended for a full schema introspection.
  * Accepts optional IntrospectionOptions.
+ * @param options - Optional configuration for this operation.
+ * @returns The resolved introspection query.
+ * @example
+ * ```ts
+ * // Generate the default introspection query.
+ * import { getIntrospectionQuery } from 'graphql/utilities';
+ *
+ * const query = getIntrospectionQuery();
+ *
+ * query; // matches /__schema/
+ * query; // matches /description/
+ * query; // does not match /specifiedByURL/
+ * ```
+ * @example
+ * ```ts
+ * // This variant customizes optional introspection fields and nesting depth.
+ * import { getIntrospectionQuery } from 'graphql/utilities';
+ *
+ * const query = getIntrospectionQuery({
+ *   descriptions: false,
+ *   specifiedByUrl: true,
+ *   directiveIsRepeatable: true,
+ *   schemaDescription: true,
+ *   inputValueDeprecation: true,
+ *   experimentalDirectiveDeprecation: true,
+ *   oneOf: true,
+ *   typeDepth: 3,
+ * });
+ *
+ * query; // does not match /description/
+ * query; // matches /specifiedByURL/
+ * query; // matches /isRepeatable/
+ * query; // matches /includeDeprecated: true/
+ * query; // matches /isOneOf/
+ * (query.match(/ofType/g)?.length ?? 0) > 0; // => true
+ * ```
  */
 export declare function getIntrospectionQuery(options?: IntrospectionOptions): string;
+/** The result shape returned by a full introspection query. */
 export interface IntrospectionQuery {
+    /** The  schema. */
     readonly __schema: IntrospectionSchema;
 }
+/** The introspection representation of a GraphQL schema. */
 export interface IntrospectionSchema {
+    /** Human-readable description for this schema element, if provided. */
     readonly description?: Maybe<string>;
+    /** The root object type used for query operations. */
     readonly queryType: IntrospectionNamedTypeRef<IntrospectionObjectType>;
+    /** The root object type used for mutation operations, if supported. */
     readonly mutationType: Maybe<IntrospectionNamedTypeRef<IntrospectionObjectType>>;
+    /** The root object type used for subscription operations, if supported. */
     readonly subscriptionType: Maybe<IntrospectionNamedTypeRef<IntrospectionObjectType>>;
+    /** Object types that belong to this union type. */
     readonly types: ReadonlyArray<IntrospectionType>;
+    /** Directives available in this schema or applied to this AST node. */
     readonly directives: ReadonlyArray<IntrospectionDirective>;
 }
+/** Any introspection representation of a GraphQL type. */
 export type IntrospectionType = IntrospectionScalarType | IntrospectionObjectType | IntrospectionInterfaceType | IntrospectionUnionType | IntrospectionEnumType | IntrospectionInputObjectType;
+/** An introspection type that can appear in output position. */
 export type IntrospectionOutputType = IntrospectionScalarType | IntrospectionObjectType | IntrospectionInterfaceType | IntrospectionUnionType | IntrospectionEnumType;
+/** An introspection type that can appear in input position. */
 export type IntrospectionInputType = IntrospectionScalarType | IntrospectionEnumType | IntrospectionInputObjectType;
+/** The introspection representation of a scalar type. */
 export interface IntrospectionScalarType {
+    /** The introspection kind discriminator for this type reference or type. */
     readonly kind: typeof TypeKind.SCALAR;
+    /** The GraphQL name for this schema element. */
     readonly name: string;
+    /** Human-readable description for this schema element, if provided. */
     readonly description?: Maybe<string>;
+    /** URL identifying the behavior specified for this custom scalar. */
     readonly specifiedByURL?: Maybe<string>;
 }
+/** The introspection representation of an object type. */
 export interface IntrospectionObjectType {
+    /** The introspection kind discriminator for this type reference or type. */
     readonly kind: typeof TypeKind.OBJECT;
+    /** The GraphQL name for this schema element. */
     readonly name: string;
+    /** Human-readable description for this schema element, if provided. */
     readonly description?: Maybe<string>;
+    /** Fields declared by this object, interface, input object, or literal. */
     readonly fields: ReadonlyArray<IntrospectionField>;
+    /** Interfaces implemented by this object or interface type. */
     readonly interfaces: ReadonlyArray<IntrospectionNamedTypeRef<IntrospectionInterfaceType>>;
 }
+/** The introspection representation of an interface type. */
 export interface IntrospectionInterfaceType {
+    /** The introspection kind discriminator for this type reference or type. */
     readonly kind: typeof TypeKind.INTERFACE;
+    /** The GraphQL name for this schema element. */
     readonly name: string;
+    /** Human-readable description for this schema element, if provided. */
     readonly description?: Maybe<string>;
+    /** Fields declared by this object, interface, input object, or literal. */
     readonly fields: ReadonlyArray<IntrospectionField>;
+    /** Interfaces implemented by this object or interface type. */
     readonly interfaces: ReadonlyArray<IntrospectionNamedTypeRef<IntrospectionInterfaceType>>;
+    /** Object types that may be returned for this abstract type. */
     readonly possibleTypes: ReadonlyArray<IntrospectionNamedTypeRef<IntrospectionObjectType>>;
 }
+/** The introspection representation of a union type. */
 export interface IntrospectionUnionType {
+    /** The introspection kind discriminator for this type reference or type. */
     readonly kind: typeof TypeKind.UNION;
+    /** The GraphQL name for this schema element. */
     readonly name: string;
+    /** Human-readable description for this schema element, if provided. */
     readonly description?: Maybe<string>;
+    /** Object types that may be returned for this abstract type. */
     readonly possibleTypes: ReadonlyArray<IntrospectionNamedTypeRef<IntrospectionObjectType>>;
 }
+/** The introspection representation of an enum type. */
 export interface IntrospectionEnumType {
+    /** The introspection kind discriminator for this type reference or type. */
     readonly kind: typeof TypeKind.ENUM;
+    /** The GraphQL name for this schema element. */
     readonly name: string;
+    /** Human-readable description for this schema element, if provided. */
     readonly description?: Maybe<string>;
+    /** Values declared by this enum type. */
     readonly enumValues: ReadonlyArray<IntrospectionEnumValue>;
 }
+/** The introspection representation of an input object type. */
 export interface IntrospectionInputObjectType {
+    /** The introspection kind discriminator for this type reference or type. */
     readonly kind: typeof TypeKind.INPUT_OBJECT;
+    /** The GraphQL name for this schema element. */
     readonly name: string;
+    /** Human-readable description for this schema element, if provided. */
     readonly description?: Maybe<string>;
+    /** Input fields declared by this input object type. */
     readonly inputFields: ReadonlyArray<IntrospectionInputValue>;
+    /** Whether this input object uses the experimental OneOf input object semantics. */
     readonly isOneOf: boolean;
 }
+/**
+ * The introspection representation of a list type reference.
+ * @typeParam T - The introspection type reference wrapped by this list type reference.
+ */
 export interface IntrospectionListTypeRef<T extends IntrospectionTypeRef = IntrospectionTypeRef> {
+    /** The introspection kind discriminator for this type reference or type. */
     readonly kind: typeof TypeKind.LIST;
+    /** The type wrapped by this list or non-null type. */
     readonly ofType: T;
 }
+/**
+ * The introspection representation of a non-null type reference.
+ * @typeParam T - The introspection type reference wrapped by this non-null type reference.
+ */
 export interface IntrospectionNonNullTypeRef<T extends IntrospectionTypeRef = IntrospectionTypeRef> {
+    /** The introspection kind discriminator for this type reference or type. */
     readonly kind: typeof TypeKind.NON_NULL;
+    /** The type wrapped by this list or non-null type. */
     readonly ofType: T;
 }
+/** Any introspection representation of a type reference. */
 export type IntrospectionTypeRef = IntrospectionNamedTypeRef | IntrospectionListTypeRef | IntrospectionNonNullTypeRef<IntrospectionNamedTypeRef | IntrospectionListTypeRef>;
+/** An introspection type reference that can appear in output position. */
 export type IntrospectionOutputTypeRef = IntrospectionNamedTypeRef<IntrospectionOutputType> | IntrospectionListTypeRef<IntrospectionOutputTypeRef> | IntrospectionNonNullTypeRef<IntrospectionNamedTypeRef<IntrospectionOutputType> | IntrospectionListTypeRef<IntrospectionOutputTypeRef>>;
+/** An introspection type reference that can appear in input position. */
 export type IntrospectionInputTypeRef = IntrospectionNamedTypeRef<IntrospectionInputType> | IntrospectionListTypeRef<IntrospectionInputTypeRef> | IntrospectionNonNullTypeRef<IntrospectionNamedTypeRef<IntrospectionInputType> | IntrospectionListTypeRef<IntrospectionInputTypeRef>>;
+/**
+ * The introspection representation of a named type reference.
+ * @typeParam T - The introspection type represented by this named type reference.
+ */
 export interface IntrospectionNamedTypeRef<T extends IntrospectionType = IntrospectionType> {
+    /** The introspection kind discriminator for this type reference or type. */
     readonly kind: T['kind'];
+    /** The GraphQL name for this schema element. */
     readonly name: string;
 }
+/** The introspection representation of a field. */
 export interface IntrospectionField {
+    /** The GraphQL name for this schema element. */
     readonly name: string;
+    /** Human-readable description for this schema element, if provided. */
     readonly description?: Maybe<string>;
+    /** Arguments accepted by this field or directive. */
     readonly args: ReadonlyArray<IntrospectionInputValue>;
+    /** The GraphQL type reference or runtime type for this element. */
     readonly type: IntrospectionOutputTypeRef;
+    /** Whether this field, argument, enum value, or input value is deprecated. */
     readonly isDeprecated: boolean;
+    /** Reason this element is deprecated, if one was provided. */
     readonly deprecationReason: Maybe<string>;
 }
+/** The introspection representation of an argument or input field. */
 export interface IntrospectionInputValue {
+    /** The GraphQL name for this schema element. */
     readonly name: string;
+    /** Human-readable description for this schema element, if provided. */
     readonly description?: Maybe<string>;
+    /** The GraphQL type reference or runtime type for this element. */
     readonly type: IntrospectionInputTypeRef;
+    /** Default value used when no explicit value is supplied. */
     readonly defaultValue: Maybe<string>;
+    /** Whether this field, argument, enum value, or input value is deprecated. */
     readonly isDeprecated?: boolean;
+    /** Reason this element is deprecated, if one was provided. */
     readonly deprecationReason?: Maybe<string>;
 }
+/** The introspection representation of an enum value. */
 export interface IntrospectionEnumValue {
+    /** The GraphQL name for this schema element. */
     readonly name: string;
+    /** Human-readable description for this schema element, if provided. */
     readonly description?: Maybe<string>;
+    /** Whether this field, argument, enum value, or input value is deprecated. */
     readonly isDeprecated: boolean;
+    /** Reason this element is deprecated, if one was provided. */
     readonly deprecationReason: Maybe<string>;
 }
+/** The introspection representation of a directive. */
 export interface IntrospectionDirective {
+    /** The GraphQL name for this schema element. */
     readonly name: string;
+    /** Human-readable description for this schema element, if provided. */
     readonly description?: Maybe<string>;
+    /** Whether this directive may appear more than once at the same location. */
     readonly isRepeatable?: boolean;
+    /** Whether this field, argument, enum value, or input value is deprecated. */
     readonly isDeprecated?: boolean;
+    /** Reason this element is deprecated, if one was provided. */
     readonly deprecationReason?: Maybe<string>;
+    /** Locations where this directive may be applied. */
     readonly locations: ReadonlyArray<DirectiveLocation>;
+    /** Arguments accepted by this field or directive. */
     readonly args: ReadonlyArray<IntrospectionInputValue>;
 }

package/utilities/getIntrospectionQuery.js

@@ -1,10 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getIntrospectionQuery = getIntrospectionQuery;
-/**
- * Produce the GraphQL query recommended for a full schema introspection.
- * Accepts optional IntrospectionOptions.
- */
 function getIntrospectionQuery(options) {
     const optionsWithDefault = {
         descriptions: true,

package/utilities/getIntrospectionQuery.js.map

@@ -1 +1 @@
-{"version":3,"file":"getIntrospectionQuery.js","sourceRoot":"","sources":["../../src/utilities/getIntrospectionQuery.ts"],"names":[],"mappings":";;AAgEA,sDA0HC;AA9HD;;;GAGG;AACH,SAAgB,qBAAqB,CAAC,OAA8B;IAClE,MAAM,kBAAkB,GAAG;QACzB,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,KAAK;QACrB,qBAAqB,EAAE,KAAK;QAC5B,iBAAiB,EAAE,KAAK;QACxB,qBAAqB,EAAE,KAAK;QAC5B,gCAAgC,EAAE,KAAK;QACvC,KAAK,EAAE,KAAK;QACZ,SAAS,EAAE,CAAC;QACZ,GAAG,OAAO;KACX,CAAC;IAEF,MAAM,YAAY,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1E,MAAM,cAAc,GAAG,kBAAkB,CAAC,cAAc;QACtD,CAAC,CAAC,gBAAgB;QAClB,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,qBAAqB,GAAG,kBAAkB,CAAC,qBAAqB;QACpE,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,iBAAiB;QAC5D,CAAC,CAAC,YAAY;QACd,CAAC,CAAC,EAAE,CAAC;IAEP,SAAS,gBAAgB,CAAC,GAAW;QACnC,OAAO,kBAAkB,CAAC,qBAAqB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,CAAC;IACD,SAAS,gCAAgC,CAAC,GAAW;QACnD,OAAO,kBAAkB,CAAC,gCAAgC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,CAAC;IACD,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,SAAS,MAAM,CAAC,KAAa,EAAE,MAAc;QAC3C,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACf,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAC;QACJ,CAAC;QACD,OAAO;EACT,MAAM;EACN,MAAM;EACN,MAAM,SAAS,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;EAC/C,MAAM,GAAG,CAAC;IACV,CAAC;IAED,OAAO;;;UAGC,iBAAiB;;;;;;;oBAOP,gCAAgC,CAC1C,2BAA2B,CAC5B;;YAEG,YAAY;YACZ,qBAAqB;YACrB,gCAAgC,CAAC,cAAc,CAAC;YAChD,gCAAgC,CAAC,mBAAmB,CAAC;;gBAEjD,gBAAgB,CAAC,2BAA2B,CAAC;;;;;;;;;;QAUrD,YAAY;QACZ,cAAc;QACd,KAAK;;;UAGH,YAAY;cACR,gBAAgB,CAAC,2BAA2B,CAAC;;;;;;;;;mBASxC,gBAAgB,CAAC,2BAA2B,CAAC;;;;;;;;UAQtD,YAAY;;;;;;;;;;;QAWd,YAAY;;;QAGZ,gBAAgB,CAAC,cAAc,CAAC;QAChC,gBAAgB,CAAC,mBAAmB,CAAC;;;;;YAKjC,MAAM,CAAC,kBAAkB,CAAC,SAAS,EAAE,QAAQ,CAAC;;GAEvD,CAAC;AACJ,CAAC","sourcesContent":["import type { Maybe } from '../jsutils/Maybe.ts';\n\nimport type { DirectiveLocation } from '../language/directiveLocation.ts';\n\nimport type { TypeKind } from '../type/introspection.ts';\n\nexport interface IntrospectionOptions {\n  /**\n   * Whether to include descriptions in the introspection result.\n   * Default: true\n   */\n  descriptions?: boolean;\n\n  /**\n   * Whether to include `specifiedByURL` in the introspection result.\n   * Default: false\n   */\n  specifiedByUrl?: boolean;\n\n  /**\n   * Whether to include `isRepeatable` flag on directives.\n   * Default: false\n   */\n  directiveIsRepeatable?: boolean;\n\n  /**\n   * Whether to include `description` field on schema.\n   * Default: false\n   */\n  schemaDescription?: boolean;\n\n  /**\n   * Whether target GraphQL server support deprecation of input values.\n   * Default: false\n   */\n  inputValueDeprecation?: boolean;\n\n  /**\n   * Whether target GraphQL server supports deprecation of directives.\n   * Default: false\n   */\n  experimentalDirectiveDeprecation?: boolean;\n\n  /**\n   * Whether target GraphQL server supports `@oneOf` input objects.\n   * Default: false\n   */\n  oneOf?: boolean;\n\n  /**\n   * How deep to recurse into nested types, larger values will result in more\n   * accurate results, but have a higher load on the server.\n   * Some servers might restrict the maximum query depth or complexity.\n   * If that's the case, try decreasing this value.\n   *\n   * Default: 9\n   */\n  typeDepth?: number;\n}\n\n/**\n * Produce the GraphQL query recommended for a full schema introspection.\n * Accepts optional IntrospectionOptions.\n */\nexport function getIntrospectionQuery(options?: IntrospectionOptions): string {\n  const optionsWithDefault = {\n    descriptions: true,\n    specifiedByUrl: false,\n    directiveIsRepeatable: false,\n    schemaDescription: false,\n    inputValueDeprecation: false,\n    experimentalDirectiveDeprecation: false,\n    oneOf: false,\n    typeDepth: 9,\n    ...options,\n  };\n\n  const descriptions = optionsWithDefault.descriptions ? 'description' : '';\n  const specifiedByUrl = optionsWithDefault.specifiedByUrl\n    ? 'specifiedByURL'\n    : '';\n  const directiveIsRepeatable = optionsWithDefault.directiveIsRepeatable\n    ? 'isRepeatable'\n    : '';\n  const schemaDescription = optionsWithDefault.schemaDescription\n    ? descriptions\n    : '';\n\n  function inputDeprecation(str: string) {\n    return optionsWithDefault.inputValueDeprecation ? str : '';\n  }\n  function experimentalDirectiveDeprecation(str: string) {\n    return optionsWithDefault.experimentalDirectiveDeprecation ? str : '';\n  }\n  const oneOf = optionsWithDefault.oneOf ? 'isOneOf' : '';\n  function ofType(level: number, indent: string): string {\n    if (level <= 0) {\n      return '';\n    }\n    if (level > 100) {\n      throw new Error(\n        'Please set typeDepth to a reasonable value between 0 and 100; the default is 9.',\n      );\n    }\n    return `\n${indent}ofType {\n${indent}  name\n${indent}  kind${ofType(level - 1, indent + '  ')}\n${indent}}`;\n  }\n\n  return `\n    query IntrospectionQuery {\n      __schema {\n        ${schemaDescription}\n        queryType { name kind }\n        mutationType { name kind }\n        subscriptionType { name kind }\n        types {\n          ...FullType\n        }\n        directives${experimentalDirectiveDeprecation(\n          '(includeDeprecated: true)',\n        )} {\n          name\n          ${descriptions}\n          ${directiveIsRepeatable}\n          ${experimentalDirectiveDeprecation('isDeprecated')}\n          ${experimentalDirectiveDeprecation('deprecationReason')}\n          locations\n          args${inputDeprecation('(includeDeprecated: true)')} {\n            ...InputValue\n          }\n        }\n      }\n    }\n\n    fragment FullType on __Type {\n      kind\n      name\n      ${descriptions}\n      ${specifiedByUrl}\n      ${oneOf}\n      fields(includeDeprecated: true) {\n        name\n        ${descriptions}\n        args${inputDeprecation('(includeDeprecated: true)')} {\n          ...InputValue\n        }\n        type {\n          ...TypeRef\n        }\n        isDeprecated\n        deprecationReason\n      }\n      inputFields${inputDeprecation('(includeDeprecated: true)')} {\n        ...InputValue\n      }\n      interfaces {\n        ...TypeRef\n      }\n      enumValues(includeDeprecated: true) {\n        name\n        ${descriptions}\n        isDeprecated\n        deprecationReason\n      }\n      possibleTypes {\n        ...TypeRef\n      }\n    }\n\n    fragment InputValue on __InputValue {\n      name\n      ${descriptions}\n      type { ...TypeRef }\n      defaultValue\n      ${inputDeprecation('isDeprecated')}\n      ${inputDeprecation('deprecationReason')}\n    }\n\n    fragment TypeRef on __Type {\n      kind\n      name${ofType(optionsWithDefault.typeDepth, '      ')}\n    }\n  `;\n}\n\nexport interface IntrospectionQuery {\n  readonly __schema: IntrospectionSchema;\n}\n\nexport interface IntrospectionSchema {\n  readonly description?: Maybe<string>;\n  readonly queryType: IntrospectionNamedTypeRef<IntrospectionObjectType>;\n  readonly mutationType: Maybe<\n    IntrospectionNamedTypeRef<IntrospectionObjectType>\n  >;\n  readonly subscriptionType: Maybe<\n    IntrospectionNamedTypeRef<IntrospectionObjectType>\n  >;\n  readonly types: ReadonlyArray<IntrospectionType>;\n  readonly directives: ReadonlyArray<IntrospectionDirective>;\n}\n\nexport type IntrospectionType =\n  | IntrospectionScalarType\n  | IntrospectionObjectType\n  | IntrospectionInterfaceType\n  | IntrospectionUnionType\n  | IntrospectionEnumType\n  | IntrospectionInputObjectType;\n\nexport type IntrospectionOutputType =\n  | IntrospectionScalarType\n  | IntrospectionObjectType\n  | IntrospectionInterfaceType\n  | IntrospectionUnionType\n  | IntrospectionEnumType;\n\nexport type IntrospectionInputType =\n  | IntrospectionScalarType\n  | IntrospectionEnumType\n  | IntrospectionInputObjectType;\n\nexport interface IntrospectionScalarType {\n  readonly kind: typeof TypeKind.SCALAR;\n  readonly name: string;\n  readonly description?: Maybe<string>;\n  readonly specifiedByURL?: Maybe<string>;\n}\n\nexport interface IntrospectionObjectType {\n  readonly kind: typeof TypeKind.OBJECT;\n  readonly name: string;\n  readonly description?: Maybe<string>;\n  readonly fields: ReadonlyArray<IntrospectionField>;\n  readonly interfaces: ReadonlyArray<\n    IntrospectionNamedTypeRef<IntrospectionInterfaceType>\n  >;\n}\n\nexport interface IntrospectionInterfaceType {\n  readonly kind: typeof TypeKind.INTERFACE;\n  readonly name: string;\n  readonly description?: Maybe<string>;\n  readonly fields: ReadonlyArray<IntrospectionField>;\n  readonly interfaces: ReadonlyArray<\n    IntrospectionNamedTypeRef<IntrospectionInterfaceType>\n  >;\n  readonly possibleTypes: ReadonlyArray<\n    IntrospectionNamedTypeRef<IntrospectionObjectType>\n  >;\n}\n\nexport interface IntrospectionUnionType {\n  readonly kind: typeof TypeKind.UNION;\n  readonly name: string;\n  readonly description?: Maybe<string>;\n  readonly possibleTypes: ReadonlyArray<\n    IntrospectionNamedTypeRef<IntrospectionObjectType>\n  >;\n}\n\nexport interface IntrospectionEnumType {\n  readonly kind: typeof TypeKind.ENUM;\n  readonly name: string;\n  readonly description?: Maybe<string>;\n  readonly enumValues: ReadonlyArray<IntrospectionEnumValue>;\n}\n\nexport interface IntrospectionInputObjectType {\n  readonly kind: typeof TypeKind.INPUT_OBJECT;\n  readonly name: string;\n  readonly description?: Maybe<string>;\n  readonly inputFields: ReadonlyArray<IntrospectionInputValue>;\n  readonly isOneOf: boolean;\n}\n\nexport interface IntrospectionListTypeRef<\n  T extends IntrospectionTypeRef = IntrospectionTypeRef,\n> {\n  readonly kind: typeof TypeKind.LIST;\n  readonly ofType: T;\n}\n\nexport interface IntrospectionNonNullTypeRef<\n  T extends IntrospectionTypeRef = IntrospectionTypeRef,\n> {\n  readonly kind: typeof TypeKind.NON_NULL;\n  readonly ofType: T;\n}\n\nexport type IntrospectionTypeRef =\n  | IntrospectionNamedTypeRef\n  | IntrospectionListTypeRef\n  | IntrospectionNonNullTypeRef<\n      IntrospectionNamedTypeRef | IntrospectionListTypeRef\n    >;\n\nexport type IntrospectionOutputTypeRef =\n  | IntrospectionNamedTypeRef<IntrospectionOutputType>\n  | IntrospectionListTypeRef<IntrospectionOutputTypeRef>\n  | IntrospectionNonNullTypeRef<\n      | IntrospectionNamedTypeRef<IntrospectionOutputType>\n      | IntrospectionListTypeRef<IntrospectionOutputTypeRef>\n    >;\n\nexport type IntrospectionInputTypeRef =\n  | IntrospectionNamedTypeRef<IntrospectionInputType>\n  | IntrospectionListTypeRef<IntrospectionInputTypeRef>\n  | IntrospectionNonNullTypeRef<\n      | IntrospectionNamedTypeRef<IntrospectionInputType>\n      | IntrospectionListTypeRef<IntrospectionInputTypeRef>\n    >;\n\nexport interface IntrospectionNamedTypeRef<\n  T extends IntrospectionType = IntrospectionType,\n> {\n  readonly kind: T['kind'];\n  readonly name: string;\n}\n\nexport interface IntrospectionField {\n  readonly name: string;\n  readonly description?: Maybe<string>;\n  readonly args: ReadonlyArray<IntrospectionInputValue>;\n  readonly type: IntrospectionOutputTypeRef;\n  readonly isDeprecated: boolean;\n  readonly deprecationReason: Maybe<string>;\n}\n\nexport interface IntrospectionInputValue {\n  readonly name: string;\n  readonly description?: Maybe<string>;\n  readonly type: IntrospectionInputTypeRef;\n  readonly defaultValue: Maybe<string>;\n  readonly isDeprecated?: boolean;\n  readonly deprecationReason?: Maybe<string>;\n}\n\nexport interface IntrospectionEnumValue {\n  readonly name: string;\n  readonly description?: Maybe<string>;\n  readonly isDeprecated: boolean;\n  readonly deprecationReason: Maybe<string>;\n}\n\nexport interface IntrospectionDirective {\n  readonly name: string;\n  readonly description?: Maybe<string>;\n  readonly isRepeatable?: boolean;\n  readonly isDeprecated?: boolean;\n  readonly deprecationReason?: Maybe<string>;\n  readonly locations: ReadonlyArray<DirectiveLocation>;\n  readonly args: ReadonlyArray<IntrospectionInputValue>;\n}\n"]}
+{"version":3,"file":"getIntrospectionQuery.js","sourceRoot":"","sources":["../../src/utilities/getIntrospectionQuery.ts"],"names":[],"mappings":";;AAuGA,sDA0HC;AA1HD,SAAgB,qBAAqB,CAAC,OAA8B;IAClE,MAAM,kBAAkB,GAAG;QACzB,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,KAAK;QACrB,qBAAqB,EAAE,KAAK;QAC5B,iBAAiB,EAAE,KAAK;QACxB,qBAAqB,EAAE,KAAK;QAC5B,gCAAgC,EAAE,KAAK;QACvC,KAAK,EAAE,KAAK;QACZ,SAAS,EAAE,CAAC;QACZ,GAAG,OAAO;KACX,CAAC;IAEF,MAAM,YAAY,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1E,MAAM,cAAc,GAAG,kBAAkB,CAAC,cAAc;QACtD,CAAC,CAAC,gBAAgB;QAClB,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,qBAAqB,GAAG,kBAAkB,CAAC,qBAAqB;QACpE,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,iBAAiB;QAC5D,CAAC,CAAC,YAAY;QACd,CAAC,CAAC,EAAE,CAAC;IAEP,SAAS,gBAAgB,CAAC,GAAW;QACnC,OAAO,kBAAkB,CAAC,qBAAqB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,CAAC;IACD,SAAS,gCAAgC,CAAC,GAAW;QACnD,OAAO,kBAAkB,CAAC,gCAAgC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,CAAC;IACD,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,SAAS,MAAM,CAAC,KAAa,EAAE,MAAc;QAC3C,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACf,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAC;QACJ,CAAC;QACD,OAAO;EACT,MAAM;EACN,MAAM;EACN,MAAM,SAAS,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;EAC/C,MAAM,GAAG,CAAC;IACV,CAAC;IAED,OAAO;;;UAGC,iBAAiB;;;;;;;oBAOP,gCAAgC,CAC1C,2BAA2B,CAC5B;;YAEG,YAAY;YACZ,qBAAqB;YACrB,gCAAgC,CAAC,cAAc,CAAC;YAChD,gCAAgC,CAAC,mBAAmB,CAAC;;gBAEjD,gBAAgB,CAAC,2BAA2B,CAAC;;;;;;;;;;QAUrD,YAAY;QACZ,cAAc;QACd,KAAK;;;UAGH,YAAY;cACR,gBAAgB,CAAC,2BAA2B,CAAC;;;;;;;;;mBASxC,gBAAgB,CAAC,2BAA2B,CAAC;;;;;;;;UAQtD,YAAY;;;;;;;;;;;QAWd,YAAY;;;QAGZ,gBAAgB,CAAC,cAAc,CAAC;QAChC,gBAAgB,CAAC,mBAAmB,CAAC;;;;;YAKjC,MAAM,CAAC,kBAAkB,CAAC,SAAS,EAAE,QAAQ,CAAC;;GAEvD,CAAC;AACJ,CAAC","sourcesContent":["/** @category Introspection */\n\nimport type { Maybe } from '../jsutils/Maybe.ts';\n\nimport type { DirectiveLocation } from '../language/directiveLocation.ts';\n\nimport type { TypeKind } from '../type/introspection.ts';\n\n/** Options controlling which fields are included in the introspection query. */\nexport interface IntrospectionOptions {\n  /**\n   * Whether to include descriptions in the introspection result.\n   * Default: true\n   */\n  descriptions?: boolean;\n\n  /**\n   * Whether to include `specifiedByURL` in the introspection result.\n   * Default: false\n   */\n  specifiedByUrl?: boolean;\n\n  /**\n   * Whether to include `isRepeatable` flag on directives.\n   * Default: false\n   */\n  directiveIsRepeatable?: boolean;\n\n  /**\n   * Whether to include `description` field on schema.\n   * Default: false\n   */\n  schemaDescription?: boolean;\n\n  /**\n   * Whether target GraphQL server support deprecation of input values.\n   * Default: false\n   */\n  inputValueDeprecation?: boolean;\n\n  /**\n   * Whether target GraphQL server supports deprecation of directives.\n   * Default: false\n   */\n  experimentalDirectiveDeprecation?: boolean;\n\n  /**\n   * Whether target GraphQL server supports `@oneOf` input objects.\n   * Default: false\n   */\n  oneOf?: boolean;\n\n  /**\n   * How deep to recurse into nested types, larger values will result in more\n   * accurate results, but have a higher load on the server.\n   * Some servers might restrict the maximum query depth or complexity.\n   * If that's the case, try decreasing this value.\n   *\n   * Default: 9\n   */\n  typeDepth?: number;\n}\n\n/**\n * Produce the GraphQL query recommended for a full schema introspection.\n * Accepts optional IntrospectionOptions.\n * @param options - Optional configuration for this operation.\n * @returns The resolved introspection query.\n * @example\n * ```ts\n * // Generate the default introspection query.\n * import { getIntrospectionQuery } from 'graphql/utilities';\n *\n * const query = getIntrospectionQuery();\n *\n * query; // matches /__schema/\n * query; // matches /description/\n * query; // does not match /specifiedByURL/\n * ```\n * @example\n * ```ts\n * // This variant customizes optional introspection fields and nesting depth.\n * import { getIntrospectionQuery } from 'graphql/utilities';\n *\n * const query = getIntrospectionQuery({\n *   descriptions: false,\n *   specifiedByUrl: true,\n *   directiveIsRepeatable: true,\n *   schemaDescription: true,\n *   inputValueDeprecation: true,\n *   experimentalDirectiveDeprecation: true,\n *   oneOf: true,\n *   typeDepth: 3,\n * });\n *\n * query; // does not match /description/\n * query; // matches /specifiedByURL/\n * query; // matches /isRepeatable/\n * query; // matches /includeDeprecated: true/\n * query; // matches /isOneOf/\n * (query.match(/ofType/g)?.length ?? 0) > 0; // => true\n * ```\n */\nexport function getIntrospectionQuery(options?: IntrospectionOptions): string {\n  const optionsWithDefault = {\n    descriptions: true,\n    specifiedByUrl: false,\n    directiveIsRepeatable: false,\n    schemaDescription: false,\n    inputValueDeprecation: false,\n    experimentalDirectiveDeprecation: false,\n    oneOf: false,\n    typeDepth: 9,\n    ...options,\n  };\n\n  const descriptions = optionsWithDefault.descriptions ? 'description' : '';\n  const specifiedByUrl = optionsWithDefault.specifiedByUrl\n    ? 'specifiedByURL'\n    : '';\n  const directiveIsRepeatable = optionsWithDefault.directiveIsRepeatable\n    ? 'isRepeatable'\n    : '';\n  const schemaDescription = optionsWithDefault.schemaDescription\n    ? descriptions\n    : '';\n\n  function inputDeprecation(str: string) {\n    return optionsWithDefault.inputValueDeprecation ? str : '';\n  }\n  function experimentalDirectiveDeprecation(str: string) {\n    return optionsWithDefault.experimentalDirectiveDeprecation ? str : '';\n  }\n  const oneOf = optionsWithDefault.oneOf ? 'isOneOf' : '';\n  function ofType(level: number, indent: string): string {\n    if (level <= 0) {\n      return '';\n    }\n    if (level > 100) {\n      throw new Error(\n        'Please set typeDepth to a reasonable value between 0 and 100; the default is 9.',\n      );\n    }\n    return `\n${indent}ofType {\n${indent}  name\n${indent}  kind${ofType(level - 1, indent + '  ')}\n${indent}}`;\n  }\n\n  return `\n    query IntrospectionQuery {\n      __schema {\n        ${schemaDescription}\n        queryType { name kind }\n        mutationType { name kind }\n        subscriptionType { name kind }\n        types {\n          ...FullType\n        }\n        directives${experimentalDirectiveDeprecation(\n          '(includeDeprecated: true)',\n        )} {\n          name\n          ${descriptions}\n          ${directiveIsRepeatable}\n          ${experimentalDirectiveDeprecation('isDeprecated')}\n          ${experimentalDirectiveDeprecation('deprecationReason')}\n          locations\n          args${inputDeprecation('(includeDeprecated: true)')} {\n            ...InputValue\n          }\n        }\n      }\n    }\n\n    fragment FullType on __Type {\n      kind\n      name\n      ${descriptions}\n      ${specifiedByUrl}\n      ${oneOf}\n      fields(includeDeprecated: true) {\n        name\n        ${descriptions}\n        args${inputDeprecation('(includeDeprecated: true)')} {\n          ...InputValue\n        }\n        type {\n          ...TypeRef\n        }\n        isDeprecated\n        deprecationReason\n      }\n      inputFields${inputDeprecation('(includeDeprecated: true)')} {\n        ...InputValue\n      }\n      interfaces {\n        ...TypeRef\n      }\n      enumValues(includeDeprecated: true) {\n        name\n        ${descriptions}\n        isDeprecated\n        deprecationReason\n      }\n      possibleTypes {\n        ...TypeRef\n      }\n    }\n\n    fragment InputValue on __InputValue {\n      name\n      ${descriptions}\n      type { ...TypeRef }\n      defaultValue\n      ${inputDeprecation('isDeprecated')}\n      ${inputDeprecation('deprecationReason')}\n    }\n\n    fragment TypeRef on __Type {\n      kind\n      name${ofType(optionsWithDefault.typeDepth, '      ')}\n    }\n  `;\n}\n\n/** The result shape returned by a full introspection query. */\nexport interface IntrospectionQuery {\n  /** The  schema. */\n  readonly __schema: IntrospectionSchema;\n}\n\n/** The introspection representation of a GraphQL schema. */\nexport interface IntrospectionSchema {\n  /** Human-readable description for this schema element, if provided. */\n  readonly description?: Maybe<string>;\n  /** The root object type used for query operations. */\n  readonly queryType: IntrospectionNamedTypeRef<IntrospectionObjectType>;\n  /** The root object type used for mutation operations, if supported. */\n  readonly mutationType: Maybe<\n    IntrospectionNamedTypeRef<IntrospectionObjectType>\n  >;\n  /** The root object type used for subscription operations, if supported. */\n  readonly subscriptionType: Maybe<\n    IntrospectionNamedTypeRef<IntrospectionObjectType>\n  >;\n  /** Object types that belong to this union type. */\n  readonly types: ReadonlyArray<IntrospectionType>;\n  /** Directives available in this schema or applied to this AST node. */\n  readonly directives: ReadonlyArray<IntrospectionDirective>;\n}\n\n/** Any introspection representation of a GraphQL type. */\nexport type IntrospectionType =\n  | IntrospectionScalarType\n  | IntrospectionObjectType\n  | IntrospectionInterfaceType\n  | IntrospectionUnionType\n  | IntrospectionEnumType\n  | IntrospectionInputObjectType;\n\n/** An introspection type that can appear in output position. */\nexport type IntrospectionOutputType =\n  | IntrospectionScalarType\n  | IntrospectionObjectType\n  | IntrospectionInterfaceType\n  | IntrospectionUnionType\n  | IntrospectionEnumType;\n\n/** An introspection type that can appear in input position. */\nexport type IntrospectionInputType =\n  | IntrospectionScalarType\n  | IntrospectionEnumType\n  | IntrospectionInputObjectType;\n\n/** The introspection representation of a scalar type. */\nexport interface IntrospectionScalarType {\n  /** The introspection kind discriminator for this type reference or type. */\n  readonly kind: typeof TypeKind.SCALAR;\n  /** The GraphQL name for this schema element. */\n  readonly name: string;\n  /** Human-readable description for this schema element, if provided. */\n  readonly description?: Maybe<string>;\n  /** URL identifying the behavior specified for this custom scalar. */\n  readonly specifiedByURL?: Maybe<string>;\n}\n\n/** The introspection representation of an object type. */\nexport interface IntrospectionObjectType {\n  /** The introspection kind discriminator for this type reference or type. */\n  readonly kind: typeof TypeKind.OBJECT;\n  /** The GraphQL name for this schema element. */\n  readonly name: string;\n  /** Human-readable description for this schema element, if provided. */\n  readonly description?: Maybe<string>;\n  /** Fields declared by this object, interface, input object, or literal. */\n  readonly fields: ReadonlyArray<IntrospectionField>;\n  /** Interfaces implemented by this object or interface type. */\n  readonly interfaces: ReadonlyArray<\n    IntrospectionNamedTypeRef<IntrospectionInterfaceType>\n  >;\n}\n\n/** The introspection representation of an interface type. */\nexport interface IntrospectionInterfaceType {\n  /** The introspection kind discriminator for this type reference or type. */\n  readonly kind: typeof TypeKind.INTERFACE;\n  /** The GraphQL name for this schema element. */\n  readonly name: string;\n  /** Human-readable description for this schema element, if provided. */\n  readonly description?: Maybe<string>;\n  /** Fields declared by this object, interface, input object, or literal. */\n  readonly fields: ReadonlyArray<IntrospectionField>;\n  /** Interfaces implemented by this object or interface type. */\n  readonly interfaces: ReadonlyArray<\n    IntrospectionNamedTypeRef<IntrospectionInterfaceType>\n  >;\n  /** Object types that may be returned for this abstract type. */\n  readonly possibleTypes: ReadonlyArray<\n    IntrospectionNamedTypeRef<IntrospectionObjectType>\n  >;\n}\n\n/** The introspection representation of a union type. */\nexport interface IntrospectionUnionType {\n  /** The introspection kind discriminator for this type reference or type. */\n  readonly kind: typeof TypeKind.UNION;\n  /** The GraphQL name for this schema element. */\n  readonly name: string;\n  /** Human-readable description for this schema element, if provided. */\n  readonly description?: Maybe<string>;\n  /** Object types that may be returned for this abstract type. */\n  readonly possibleTypes: ReadonlyArray<\n    IntrospectionNamedTypeRef<IntrospectionObjectType>\n  >;\n}\n\n/** The introspection representation of an enum type. */\nexport interface IntrospectionEnumType {\n  /** The introspection kind discriminator for this type reference or type. */\n  readonly kind: typeof TypeKind.ENUM;\n  /** The GraphQL name for this schema element. */\n  readonly name: string;\n  /** Human-readable description for this schema element, if provided. */\n  readonly description?: Maybe<string>;\n  /** Values declared by this enum type. */\n  readonly enumValues: ReadonlyArray<IntrospectionEnumValue>;\n}\n\n/** The introspection representation of an input object type. */\nexport interface IntrospectionInputObjectType {\n  /** The introspection kind discriminator for this type reference or type. */\n  readonly kind: typeof TypeKind.INPUT_OBJECT;\n  /** The GraphQL name for this schema element. */\n  readonly name: string;\n  /** Human-readable description for this schema element, if provided. */\n  readonly description?: Maybe<string>;\n  /** Input fields declared by this input object type. */\n  readonly inputFields: ReadonlyArray<IntrospectionInputValue>;\n  /** Whether this input object uses the experimental OneOf input object semantics. */\n  readonly isOneOf: boolean;\n}\n\n/**\n * The introspection representation of a list type reference.\n * @typeParam T - The introspection type reference wrapped by this list type reference.\n */\nexport interface IntrospectionListTypeRef<\n  T extends IntrospectionTypeRef = IntrospectionTypeRef,\n> {\n  /** The introspection kind discriminator for this type reference or type. */\n  readonly kind: typeof TypeKind.LIST;\n  /** The type wrapped by this list or non-null type. */\n  readonly ofType: T;\n}\n\n/**\n * The introspection representation of a non-null type reference.\n * @typeParam T - The introspection type reference wrapped by this non-null type reference.\n */\nexport interface IntrospectionNonNullTypeRef<\n  T extends IntrospectionTypeRef = IntrospectionTypeRef,\n> {\n  /** The introspection kind discriminator for this type reference or type. */\n  readonly kind: typeof TypeKind.NON_NULL;\n  /** The type wrapped by this list or non-null type. */\n  readonly ofType: T;\n}\n\n/** Any introspection representation of a type reference. */\nexport type IntrospectionTypeRef =\n  | IntrospectionNamedTypeRef\n  | IntrospectionListTypeRef\n  | IntrospectionNonNullTypeRef<\n      IntrospectionNamedTypeRef | IntrospectionListTypeRef\n    >;\n\n/** An introspection type reference that can appear in output position. */\nexport type IntrospectionOutputTypeRef =\n  | IntrospectionNamedTypeRef<IntrospectionOutputType>\n  | IntrospectionListTypeRef<IntrospectionOutputTypeRef>\n  | IntrospectionNonNullTypeRef<\n      | IntrospectionNamedTypeRef<IntrospectionOutputType>\n      | IntrospectionListTypeRef<IntrospectionOutputTypeRef>\n    >;\n\n/** An introspection type reference that can appear in input position. */\nexport type IntrospectionInputTypeRef =\n  | IntrospectionNamedTypeRef<IntrospectionInputType>\n  | IntrospectionListTypeRef<IntrospectionInputTypeRef>\n  | IntrospectionNonNullTypeRef<\n      | IntrospectionNamedTypeRef<IntrospectionInputType>\n      | IntrospectionListTypeRef<IntrospectionInputTypeRef>\n    >;\n\n/**\n * The introspection representation of a named type reference.\n * @typeParam T - The introspection type represented by this named type reference.\n */\nexport interface IntrospectionNamedTypeRef<\n  T extends IntrospectionType = IntrospectionType,\n> {\n  /** The introspection kind discriminator for this type reference or type. */\n  readonly kind: T['kind'];\n  /** The GraphQL name for this schema element. */\n  readonly name: string;\n}\n\n/** The introspection representation of a field. */\nexport interface IntrospectionField {\n  /** The GraphQL name for this schema element. */\n  readonly name: string;\n  /** Human-readable description for this schema element, if provided. */\n  readonly description?: Maybe<string>;\n  /** Arguments accepted by this field or directive. */\n  readonly args: ReadonlyArray<IntrospectionInputValue>;\n  /** The GraphQL type reference or runtime type for this element. */\n  readonly type: IntrospectionOutputTypeRef;\n  /** Whether this field, argument, enum value, or input value is deprecated. */\n  readonly isDeprecated: boolean;\n  /** Reason this element is deprecated, if one was provided. */\n  readonly deprecationReason: Maybe<string>;\n}\n\n/** The introspection representation of an argument or input field. */\nexport interface IntrospectionInputValue {\n  /** The GraphQL name for this schema element. */\n  readonly name: string;\n  /** Human-readable description for this schema element, if provided. */\n  readonly description?: Maybe<string>;\n  /** The GraphQL type reference or runtime type for this element. */\n  readonly type: IntrospectionInputTypeRef;\n  /** Default value used when no explicit value is supplied. */\n  readonly defaultValue: Maybe<string>;\n  /** Whether this field, argument, enum value, or input value is deprecated. */\n  readonly isDeprecated?: boolean;\n  /** Reason this element is deprecated, if one was provided. */\n  readonly deprecationReason?: Maybe<string>;\n}\n\n/** The introspection representation of an enum value. */\nexport interface IntrospectionEnumValue {\n  /** The GraphQL name for this schema element. */\n  readonly name: string;\n  /** Human-readable description for this schema element, if provided. */\n  readonly description?: Maybe<string>;\n  /** Whether this field, argument, enum value, or input value is deprecated. */\n  readonly isDeprecated: boolean;\n  /** Reason this element is deprecated, if one was provided. */\n  readonly deprecationReason: Maybe<string>;\n}\n\n/** The introspection representation of a directive. */\nexport interface IntrospectionDirective {\n  /** The GraphQL name for this schema element. */\n  readonly name: string;\n  /** Human-readable description for this schema element, if provided. */\n  readonly description?: Maybe<string>;\n  /** Whether this directive may appear more than once at the same location. */\n  readonly isRepeatable?: boolean;\n  /** Whether this field, argument, enum value, or input value is deprecated. */\n  readonly isDeprecated?: boolean;\n  /** Reason this element is deprecated, if one was provided. */\n  readonly deprecationReason?: Maybe<string>;\n  /** Locations where this directive may be applied. */\n  readonly locations: ReadonlyArray<DirectiveLocation>;\n  /** Arguments accepted by this field or directive. */\n  readonly args: ReadonlyArray<IntrospectionInputValue>;\n}\n"]}

package/utilities/getIntrospectionQuery.mjs

@@ -1,7 +1,3 @@
-/**
- * Produce the GraphQL query recommended for a full schema introspection.
- * Accepts optional IntrospectionOptions.
- */
 export function getIntrospectionQuery(options) {
     const optionsWithDefault = {
         descriptions: true,

package/utilities/getIntrospectionQuery.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"getIntrospectionQuery.js","sourceRoot":"","sources":["../../src/utilities/getIntrospectionQuery.ts"],"names":[],"mappings":"AA4DA;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA8B;IAClE,MAAM,kBAAkB,GAAG;QACzB,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,KAAK;QACrB,qBAAqB,EAAE,KAAK;QAC5B,iBAAiB,EAAE,KAAK;QACxB,qBAAqB,EAAE,KAAK;QAC5B,gCAAgC,EAAE,KAAK;QACvC,KAAK,EAAE,KAAK;QACZ,SAAS,EAAE,CAAC;QACZ,GAAG,OAAO;KACX,CAAC;IAEF,MAAM,YAAY,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1E,MAAM,cAAc,GAAG,kBAAkB,CAAC,cAAc;QACtD,CAAC,CAAC,gBAAgB;QAClB,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,qBAAqB,GAAG,kBAAkB,CAAC,qBAAqB;QACpE,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,iBAAiB;QAC5D,CAAC,CAAC,YAAY;QACd,CAAC,CAAC,EAAE,CAAC;IAEP,SAAS,gBAAgB,CAAC,GAAW;QACnC,OAAO,kBAAkB,CAAC,qBAAqB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,CAAC;IACD,SAAS,gCAAgC,CAAC,GAAW;QACnD,OAAO,kBAAkB,CAAC,gCAAgC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,CAAC;IACD,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,SAAS,MAAM,CAAC,KAAa,EAAE,MAAc;QAC3C,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACf,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAC;QACJ,CAAC;QACD,OAAO;EACT,MAAM;EACN,MAAM;EACN,MAAM,SAAS,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;EAC/C,MAAM,GAAG,CAAC;IACV,CAAC;IAED,OAAO;;;UAGC,iBAAiB;;;;;;;oBAOP,gCAAgC,CAC1C,2BAA2B,CAC5B;;YAEG,YAAY;YACZ,qBAAqB;YACrB,gCAAgC,CAAC,cAAc,CAAC;YAChD,gCAAgC,CAAC,mBAAmB,CAAC;;gBAEjD,gBAAgB,CAAC,2BAA2B,CAAC;;;;;;;;;;QAUrD,YAAY;QACZ,cAAc;QACd,KAAK;;;UAGH,YAAY;cACR,gBAAgB,CAAC,2BAA2B,CAAC;;;;;;;;;mBASxC,gBAAgB,CAAC,2BAA2B,CAAC;;;;;;;;UAQtD,YAAY;;;;;;;;;;;QAWd,YAAY;;;QAGZ,gBAAgB,CAAC,cAAc,CAAC;QAChC,gBAAgB,CAAC,mBAAmB,CAAC;;;;;YAKjC,MAAM,CAAC,kBAAkB,CAAC,SAAS,EAAE,QAAQ,CAAC;;GAEvD,CAAC;AACJ,CAAC","sourcesContent":["import type { Maybe } from '../jsutils/Maybe.ts';\n\nimport type { DirectiveLocation } from '../language/directiveLocation.ts';\n\nimport type { TypeKind } from '../type/introspection.ts';\n\nexport interface IntrospectionOptions {\n  /**\n   * Whether to include descriptions in the introspection result.\n   * Default: true\n   */\n  descriptions?: boolean;\n\n  /**\n   * Whether to include `specifiedByURL` in the introspection result.\n   * Default: false\n   */\n  specifiedByUrl?: boolean;\n\n  /**\n   * Whether to include `isRepeatable` flag on directives.\n   * Default: false\n   */\n  directiveIsRepeatable?: boolean;\n\n  /**\n   * Whether to include `description` field on schema.\n   * Default: false\n   */\n  schemaDescription?: boolean;\n\n  /**\n   * Whether target GraphQL server support deprecation of input values.\n   * Default: false\n   */\n  inputValueDeprecation?: boolean;\n\n  /**\n   * Whether target GraphQL server supports deprecation of directives.\n   * Default: false\n   */\n  experimentalDirectiveDeprecation?: boolean;\n\n  /**\n   * Whether target GraphQL server supports `@oneOf` input objects.\n   * Default: false\n   */\n  oneOf?: boolean;\n\n  /**\n   * How deep to recurse into nested types, larger values will result in more\n   * accurate results, but have a higher load on the server.\n   * Some servers might restrict the maximum query depth or complexity.\n   * If that's the case, try decreasing this value.\n   *\n   * Default: 9\n   */\n  typeDepth?: number;\n}\n\n/**\n * Produce the GraphQL query recommended for a full schema introspection.\n * Accepts optional IntrospectionOptions.\n */\nexport function getIntrospectionQuery(options?: IntrospectionOptions): string {\n  const optionsWithDefault = {\n    descriptions: true,\n    specifiedByUrl: false,\n    directiveIsRepeatable: false,\n    schemaDescription: false,\n    inputValueDeprecation: false,\n    experimentalDirectiveDeprecation: false,\n    oneOf: false,\n    typeDepth: 9,\n    ...options,\n  };\n\n  const descriptions = optionsWithDefault.descriptions ? 'description' : '';\n  const specifiedByUrl = optionsWithDefault.specifiedByUrl\n    ? 'specifiedByURL'\n    : '';\n  const directiveIsRepeatable = optionsWithDefault.directiveIsRepeatable\n    ? 'isRepeatable'\n    : '';\n  const schemaDescription = optionsWithDefault.schemaDescription\n    ? descriptions\n    : '';\n\n  function inputDeprecation(str: string) {\n    return optionsWithDefault.inputValueDeprecation ? str : '';\n  }\n  function experimentalDirectiveDeprecation(str: string) {\n    return optionsWithDefault.experimentalDirectiveDeprecation ? str : '';\n  }\n  const oneOf = optionsWithDefault.oneOf ? 'isOneOf' : '';\n  function ofType(level: number, indent: string): string {\n    if (level <= 0) {\n      return '';\n    }\n    if (level > 100) {\n      throw new Error(\n        'Please set typeDepth to a reasonable value between 0 and 100; the default is 9.',\n      );\n    }\n    return `\n${indent}ofType {\n${indent}  name\n${indent}  kind${ofType(level - 1, indent + '  ')}\n${indent}}`;\n  }\n\n  return `\n    query IntrospectionQuery {\n      __schema {\n        ${schemaDescription}\n        queryType { name kind }\n        mutationType { name kind }\n        subscriptionType { name kind }\n        types {\n          ...FullType\n        }\n        directives${experimentalDirectiveDeprecation(\n          '(includeDeprecated: true)',\n        )} {\n          name\n          ${descriptions}\n          ${directiveIsRepeatable}\n          ${experimentalDirectiveDeprecation('isDeprecated')}\n          ${experimentalDirectiveDeprecation('deprecationReason')}\n          locations\n          args${inputDeprecation('(includeDeprecated: true)')} {\n            ...InputValue\n          }\n        }\n      }\n    }\n\n    fragment FullType on __Type {\n      kind\n      name\n      ${descriptions}\n      ${specifiedByUrl}\n      ${oneOf}\n      fields(includeDeprecated: true) {\n        name\n        ${descriptions}\n        args${inputDeprecation('(includeDeprecated: true)')} {\n          ...InputValue\n        }\n        type {\n          ...TypeRef\n        }\n        isDeprecated\n        deprecationReason\n      }\n      inputFields${inputDeprecation('(includeDeprecated: true)')} {\n        ...InputValue\n      }\n      interfaces {\n        ...TypeRef\n      }\n      enumValues(includeDeprecated: true) {\n        name\n        ${descriptions}\n        isDeprecated\n        deprecationReason\n      }\n      possibleTypes {\n        ...TypeRef\n      }\n    }\n\n    fragment InputValue on __InputValue {\n      name\n      ${descriptions}\n      type { ...TypeRef }\n      defaultValue\n      ${inputDeprecation('isDeprecated')}\n      ${inputDeprecation('deprecationReason')}\n    }\n\n    fragment TypeRef on __Type {\n      kind\n      name${ofType(optionsWithDefault.typeDepth, '      ')}\n    }\n  `;\n}\n\nexport interface IntrospectionQuery {\n  readonly __schema: IntrospectionSchema;\n}\n\nexport interface IntrospectionSchema {\n  readonly description?: Maybe<string>;\n  readonly queryType: IntrospectionNamedTypeRef<IntrospectionObjectType>;\n  readonly mutationType: Maybe<\n    IntrospectionNamedTypeRef<IntrospectionObjectType>\n  >;\n  readonly subscriptionType: Maybe<\n    IntrospectionNamedTypeRef<IntrospectionObjectType>\n  >;\n  readonly types: ReadonlyArray<IntrospectionType>;\n  readonly directives: ReadonlyArray<IntrospectionDirective>;\n}\n\nexport type IntrospectionType =\n  | IntrospectionScalarType\n  | IntrospectionObjectType\n  | IntrospectionInterfaceType\n  | IntrospectionUnionType\n  | IntrospectionEnumType\n  | IntrospectionInputObjectType;\n\nexport type IntrospectionOutputType =\n  | IntrospectionScalarType\n  | IntrospectionObjectType\n  | IntrospectionInterfaceType\n  | IntrospectionUnionType\n  | IntrospectionEnumType;\n\nexport type IntrospectionInputType =\n  | IntrospectionScalarType\n  | IntrospectionEnumType\n  | IntrospectionInputObjectType;\n\nexport interface IntrospectionScalarType {\n  readonly kind: typeof TypeKind.SCALAR;\n  readonly name: string;\n  readonly description?: Maybe<string>;\n  readonly specifiedByURL?: Maybe<string>;\n}\n\nexport interface IntrospectionObjectType {\n  readonly kind: typeof TypeKind.OBJECT;\n  readonly name: string;\n  readonly description?: Maybe<string>;\n  readonly fields: ReadonlyArray<IntrospectionField>;\n  readonly interfaces: ReadonlyArray<\n    IntrospectionNamedTypeRef<IntrospectionInterfaceType>\n  >;\n}\n\nexport interface IntrospectionInterfaceType {\n  readonly kind: typeof TypeKind.INTERFACE;\n  readonly name: string;\n  readonly description?: Maybe<string>;\n  readonly fields: ReadonlyArray<IntrospectionField>;\n  readonly interfaces: ReadonlyArray<\n    IntrospectionNamedTypeRef<IntrospectionInterfaceType>\n  >;\n  readonly possibleTypes: ReadonlyArray<\n    IntrospectionNamedTypeRef<IntrospectionObjectType>\n  >;\n}\n\nexport interface IntrospectionUnionType {\n  readonly kind: typeof TypeKind.UNION;\n  readonly name: string;\n  readonly description?: Maybe<string>;\n  readonly possibleTypes: ReadonlyArray<\n    IntrospectionNamedTypeRef<IntrospectionObjectType>\n  >;\n}\n\nexport interface IntrospectionEnumType {\n  readonly kind: typeof TypeKind.ENUM;\n  readonly name: string;\n  readonly description?: Maybe<string>;\n  readonly enumValues: ReadonlyArray<IntrospectionEnumValue>;\n}\n\nexport interface IntrospectionInputObjectType {\n  readonly kind: typeof TypeKind.INPUT_OBJECT;\n  readonly name: string;\n  readonly description?: Maybe<string>;\n  readonly inputFields: ReadonlyArray<IntrospectionInputValue>;\n  readonly isOneOf: boolean;\n}\n\nexport interface IntrospectionListTypeRef<\n  T extends IntrospectionTypeRef = IntrospectionTypeRef,\n> {\n  readonly kind: typeof TypeKind.LIST;\n  readonly ofType: T;\n}\n\nexport interface IntrospectionNonNullTypeRef<\n  T extends IntrospectionTypeRef = IntrospectionTypeRef,\n> {\n  readonly kind: typeof TypeKind.NON_NULL;\n  readonly ofType: T;\n}\n\nexport type IntrospectionTypeRef =\n  | IntrospectionNamedTypeRef\n  | IntrospectionListTypeRef\n  | IntrospectionNonNullTypeRef<\n      IntrospectionNamedTypeRef | IntrospectionListTypeRef\n    >;\n\nexport type IntrospectionOutputTypeRef =\n  | IntrospectionNamedTypeRef<IntrospectionOutputType>\n  | IntrospectionListTypeRef<IntrospectionOutputTypeRef>\n  | IntrospectionNonNullTypeRef<\n      | IntrospectionNamedTypeRef<IntrospectionOutputType>\n      | IntrospectionListTypeRef<IntrospectionOutputTypeRef>\n    >;\n\nexport type IntrospectionInputTypeRef =\n  | IntrospectionNamedTypeRef<IntrospectionInputType>\n  | IntrospectionListTypeRef<IntrospectionInputTypeRef>\n  | IntrospectionNonNullTypeRef<\n      | IntrospectionNamedTypeRef<IntrospectionInputType>\n      | IntrospectionListTypeRef<IntrospectionInputTypeRef>\n    >;\n\nexport interface IntrospectionNamedTypeRef<\n  T extends IntrospectionType = IntrospectionType,\n> {\n  readonly kind: T['kind'];\n  readonly name: string;\n}\n\nexport interface IntrospectionField {\n  readonly name: string;\n  readonly description?: Maybe<string>;\n  readonly args: ReadonlyArray<IntrospectionInputValue>;\n  readonly type: IntrospectionOutputTypeRef;\n  readonly isDeprecated: boolean;\n  readonly deprecationReason: Maybe<string>;\n}\n\nexport interface IntrospectionInputValue {\n  readonly name: string;\n  readonly description?: Maybe<string>;\n  readonly type: IntrospectionInputTypeRef;\n  readonly defaultValue: Maybe<string>;\n  readonly isDeprecated?: boolean;\n  readonly deprecationReason?: Maybe<string>;\n}\n\nexport interface IntrospectionEnumValue {\n  readonly name: string;\n  readonly description?: Maybe<string>;\n  readonly isDeprecated: boolean;\n  readonly deprecationReason: Maybe<string>;\n}\n\nexport interface IntrospectionDirective {\n  readonly name: string;\n  readonly description?: Maybe<string>;\n  readonly isRepeatable?: boolean;\n  readonly isDeprecated?: boolean;\n  readonly deprecationReason?: Maybe<string>;\n  readonly locations: ReadonlyArray<DirectiveLocation>;\n  readonly args: ReadonlyArray<IntrospectionInputValue>;\n}\n"]}
+{"version":3,"file":"getIntrospectionQuery.js","sourceRoot":"","sources":["../../src/utilities/getIntrospectionQuery.ts"],"names":[],"mappings":"AAuGA,MAAM,UAAU,qBAAqB,CAAC,OAA8B;IAClE,MAAM,kBAAkB,GAAG;QACzB,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,KAAK;QACrB,qBAAqB,EAAE,KAAK;QAC5B,iBAAiB,EAAE,KAAK;QACxB,qBAAqB,EAAE,KAAK;QAC5B,gCAAgC,EAAE,KAAK;QACvC,KAAK,EAAE,KAAK;QACZ,SAAS,EAAE,CAAC;QACZ,GAAG,OAAO;KACX,CAAC;IAEF,MAAM,YAAY,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1E,MAAM,cAAc,GAAG,kBAAkB,CAAC,cAAc;QACtD,CAAC,CAAC,gBAAgB;QAClB,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,qBAAqB,GAAG,kBAAkB,CAAC,qBAAqB;QACpE,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,iBAAiB;QAC5D,CAAC,CAAC,YAAY;QACd,CAAC,CAAC,EAAE,CAAC;IAEP,SAAS,gBAAgB,CAAC,GAAW;QACnC,OAAO,kBAAkB,CAAC,qBAAqB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,CAAC;IACD,SAAS,gCAAgC,CAAC,GAAW;QACnD,OAAO,kBAAkB,CAAC,gCAAgC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,CAAC;IACD,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,SAAS,MAAM,CAAC,KAAa,EAAE,MAAc;QAC3C,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACf,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAC;QACJ,CAAC;QACD,OAAO;EACT,MAAM;EACN,MAAM;EACN,MAAM,SAAS,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;EAC/C,MAAM,GAAG,CAAC;IACV,CAAC;IAED,OAAO;;;UAGC,iBAAiB;;;;;;;oBAOP,gCAAgC,CAC1C,2BAA2B,CAC5B;;YAEG,YAAY;YACZ,qBAAqB;YACrB,gCAAgC,CAAC,cAAc,CAAC;YAChD,gCAAgC,CAAC,mBAAmB,CAAC;;gBAEjD,gBAAgB,CAAC,2BAA2B,CAAC;;;;;;;;;;QAUrD,YAAY;QACZ,cAAc;QACd,KAAK;;;UAGH,YAAY;cACR,gBAAgB,CAAC,2BAA2B,CAAC;;;;;;;;;mBASxC,gBAAgB,CAAC,2BAA2B,CAAC;;;;;;;;UAQtD,YAAY;;;;;;;;;;;QAWd,YAAY;;;QAGZ,gBAAgB,CAAC,cAAc,CAAC;QAChC,gBAAgB,CAAC,mBAAmB,CAAC;;;;;YAKjC,MAAM,CAAC,kBAAkB,CAAC,SAAS,EAAE,QAAQ,CAAC;;GAEvD,CAAC;AACJ,CAAC","sourcesContent":["/** @category Introspection */\n\nimport type { Maybe } from '../jsutils/Maybe.ts';\n\nimport type { DirectiveLocation } from '../language/directiveLocation.ts';\n\nimport type { TypeKind } from '../type/introspection.ts';\n\n/** Options controlling which fields are included in the introspection query. */\nexport interface IntrospectionOptions {\n  /**\n   * Whether to include descriptions in the introspection result.\n   * Default: true\n   */\n  descriptions?: boolean;\n\n  /**\n   * Whether to include `specifiedByURL` in the introspection result.\n   * Default: false\n   */\n  specifiedByUrl?: boolean;\n\n  /**\n   * Whether to include `isRepeatable` flag on directives.\n   * Default: false\n   */\n  directiveIsRepeatable?: boolean;\n\n  /**\n   * Whether to include `description` field on schema.\n   * Default: false\n   */\n  schemaDescription?: boolean;\n\n  /**\n   * Whether target GraphQL server support deprecation of input values.\n   * Default: false\n   */\n  inputValueDeprecation?: boolean;\n\n  /**\n   * Whether target GraphQL server supports deprecation of directives.\n   * Default: false\n   */\n  experimentalDirectiveDeprecation?: boolean;\n\n  /**\n   * Whether target GraphQL server supports `@oneOf` input objects.\n   * Default: false\n   */\n  oneOf?: boolean;\n\n  /**\n   * How deep to recurse into nested types, larger values will result in more\n   * accurate results, but have a higher load on the server.\n   * Some servers might restrict the maximum query depth or complexity.\n   * If that's the case, try decreasing this value.\n   *\n   * Default: 9\n   */\n  typeDepth?: number;\n}\n\n/**\n * Produce the GraphQL query recommended for a full schema introspection.\n * Accepts optional IntrospectionOptions.\n * @param options - Optional configuration for this operation.\n * @returns The resolved introspection query.\n * @example\n * ```ts\n * // Generate the default introspection query.\n * import { getIntrospectionQuery } from 'graphql/utilities';\n *\n * const query = getIntrospectionQuery();\n *\n * query; // matches /__schema/\n * query; // matches /description/\n * query; // does not match /specifiedByURL/\n * ```\n * @example\n * ```ts\n * // This variant customizes optional introspection fields and nesting depth.\n * import { getIntrospectionQuery } from 'graphql/utilities';\n *\n * const query = getIntrospectionQuery({\n *   descriptions: false,\n *   specifiedByUrl: true,\n *   directiveIsRepeatable: true,\n *   schemaDescription: true,\n *   inputValueDeprecation: true,\n *   experimentalDirectiveDeprecation: true,\n *   oneOf: true,\n *   typeDepth: 3,\n * });\n *\n * query; // does not match /description/\n * query; // matches /specifiedByURL/\n * query; // matches /isRepeatable/\n * query; // matches /includeDeprecated: true/\n * query; // matches /isOneOf/\n * (query.match(/ofType/g)?.length ?? 0) > 0; // => true\n * ```\n */\nexport function getIntrospectionQuery(options?: IntrospectionOptions): string {\n  const optionsWithDefault = {\n    descriptions: true,\n    specifiedByUrl: false,\n    directiveIsRepeatable: false,\n    schemaDescription: false,\n    inputValueDeprecation: false,\n    experimentalDirectiveDeprecation: false,\n    oneOf: false,\n    typeDepth: 9,\n    ...options,\n  };\n\n  const descriptions = optionsWithDefault.descriptions ? 'description' : '';\n  const specifiedByUrl = optionsWithDefault.specifiedByUrl\n    ? 'specifiedByURL'\n    : '';\n  const directiveIsRepeatable = optionsWithDefault.directiveIsRepeatable\n    ? 'isRepeatable'\n    : '';\n  const schemaDescription = optionsWithDefault.schemaDescription\n    ? descriptions\n    : '';\n\n  function inputDeprecation(str: string) {\n    return optionsWithDefault.inputValueDeprecation ? str : '';\n  }\n  function experimentalDirectiveDeprecation(str: string) {\n    return optionsWithDefault.experimentalDirectiveDeprecation ? str : '';\n  }\n  const oneOf = optionsWithDefault.oneOf ? 'isOneOf' : '';\n  function ofType(level: number, indent: string): string {\n    if (level <= 0) {\n      return '';\n    }\n    if (level > 100) {\n      throw new Error(\n        'Please set typeDepth to a reasonable value between 0 and 100; the default is 9.',\n      );\n    }\n    return `\n${indent}ofType {\n${indent}  name\n${indent}  kind${ofType(level - 1, indent + '  ')}\n${indent}}`;\n  }\n\n  return `\n    query IntrospectionQuery {\n      __schema {\n        ${schemaDescription}\n        queryType { name kind }\n        mutationType { name kind }\n        subscriptionType { name kind }\n        types {\n          ...FullType\n        }\n        directives${experimentalDirectiveDeprecation(\n          '(includeDeprecated: true)',\n        )} {\n          name\n          ${descriptions}\n          ${directiveIsRepeatable}\n          ${experimentalDirectiveDeprecation('isDeprecated')}\n          ${experimentalDirectiveDeprecation('deprecationReason')}\n          locations\n          args${inputDeprecation('(includeDeprecated: true)')} {\n            ...InputValue\n          }\n        }\n      }\n    }\n\n    fragment FullType on __Type {\n      kind\n      name\n      ${descriptions}\n      ${specifiedByUrl}\n      ${oneOf}\n      fields(includeDeprecated: true) {\n        name\n        ${descriptions}\n        args${inputDeprecation('(includeDeprecated: true)')} {\n          ...InputValue\n        }\n        type {\n          ...TypeRef\n        }\n        isDeprecated\n        deprecationReason\n      }\n      inputFields${inputDeprecation('(includeDeprecated: true)')} {\n        ...InputValue\n      }\n      interfaces {\n        ...TypeRef\n      }\n      enumValues(includeDeprecated: true) {\n        name\n        ${descriptions}\n        isDeprecated\n        deprecationReason\n      }\n      possibleTypes {\n        ...TypeRef\n      }\n    }\n\n    fragment InputValue on __InputValue {\n      name\n      ${descriptions}\n      type { ...TypeRef }\n      defaultValue\n      ${inputDeprecation('isDeprecated')}\n      ${inputDeprecation('deprecationReason')}\n    }\n\n    fragment TypeRef on __Type {\n      kind\n      name${ofType(optionsWithDefault.typeDepth, '      ')}\n    }\n  `;\n}\n\n/** The result shape returned by a full introspection query. */\nexport interface IntrospectionQuery {\n  /** The  schema. */\n  readonly __schema: IntrospectionSchema;\n}\n\n/** The introspection representation of a GraphQL schema. */\nexport interface IntrospectionSchema {\n  /** Human-readable description for this schema element, if provided. */\n  readonly description?: Maybe<string>;\n  /** The root object type used for query operations. */\n  readonly queryType: IntrospectionNamedTypeRef<IntrospectionObjectType>;\n  /** The root object type used for mutation operations, if supported. */\n  readonly mutationType: Maybe<\n    IntrospectionNamedTypeRef<IntrospectionObjectType>\n  >;\n  /** The root object type used for subscription operations, if supported. */\n  readonly subscriptionType: Maybe<\n    IntrospectionNamedTypeRef<IntrospectionObjectType>\n  >;\n  /** Object types that belong to this union type. */\n  readonly types: ReadonlyArray<IntrospectionType>;\n  /** Directives available in this schema or applied to this AST node. */\n  readonly directives: ReadonlyArray<IntrospectionDirective>;\n}\n\n/** Any introspection representation of a GraphQL type. */\nexport type IntrospectionType =\n  | IntrospectionScalarType\n  | IntrospectionObjectType\n  | IntrospectionInterfaceType\n  | IntrospectionUnionType\n  | IntrospectionEnumType\n  | IntrospectionInputObjectType;\n\n/** An introspection type that can appear in output position. */\nexport type IntrospectionOutputType =\n  | IntrospectionScalarType\n  | IntrospectionObjectType\n  | IntrospectionInterfaceType\n  | IntrospectionUnionType\n  | IntrospectionEnumType;\n\n/** An introspection type that can appear in input position. */\nexport type IntrospectionInputType =\n  | IntrospectionScalarType\n  | IntrospectionEnumType\n  | IntrospectionInputObjectType;\n\n/** The introspection representation of a scalar type. */\nexport interface IntrospectionScalarType {\n  /** The introspection kind discriminator for this type reference or type. */\n  readonly kind: typeof TypeKind.SCALAR;\n  /** The GraphQL name for this schema element. */\n  readonly name: string;\n  /** Human-readable description for this schema element, if provided. */\n  readonly description?: Maybe<string>;\n  /** URL identifying the behavior specified for this custom scalar. */\n  readonly specifiedByURL?: Maybe<string>;\n}\n\n/** The introspection representation of an object type. */\nexport interface IntrospectionObjectType {\n  /** The introspection kind discriminator for this type reference or type. */\n  readonly kind: typeof TypeKind.OBJECT;\n  /** The GraphQL name for this schema element. */\n  readonly name: string;\n  /** Human-readable description for this schema element, if provided. */\n  readonly description?: Maybe<string>;\n  /** Fields declared by this object, interface, input object, or literal. */\n  readonly fields: ReadonlyArray<IntrospectionField>;\n  /** Interfaces implemented by this object or interface type. */\n  readonly interfaces: ReadonlyArray<\n    IntrospectionNamedTypeRef<IntrospectionInterfaceType>\n  >;\n}\n\n/** The introspection representation of an interface type. */\nexport interface IntrospectionInterfaceType {\n  /** The introspection kind discriminator for this type reference or type. */\n  readonly kind: typeof TypeKind.INTERFACE;\n  /** The GraphQL name for this schema element. */\n  readonly name: string;\n  /** Human-readable description for this schema element, if provided. */\n  readonly description?: Maybe<string>;\n  /** Fields declared by this object, interface, input object, or literal. */\n  readonly fields: ReadonlyArray<IntrospectionField>;\n  /** Interfaces implemented by this object or interface type. */\n  readonly interfaces: ReadonlyArray<\n    IntrospectionNamedTypeRef<IntrospectionInterfaceType>\n  >;\n  /** Object types that may be returned for this abstract type. */\n  readonly possibleTypes: ReadonlyArray<\n    IntrospectionNamedTypeRef<IntrospectionObjectType>\n  >;\n}\n\n/** The introspection representation of a union type. */\nexport interface IntrospectionUnionType {\n  /** The introspection kind discriminator for this type reference or type. */\n  readonly kind: typeof TypeKind.UNION;\n  /** The GraphQL name for this schema element. */\n  readonly name: string;\n  /** Human-readable description for this schema element, if provided. */\n  readonly description?: Maybe<string>;\n  /** Object types that may be returned for this abstract type. */\n  readonly possibleTypes: ReadonlyArray<\n    IntrospectionNamedTypeRef<IntrospectionObjectType>\n  >;\n}\n\n/** The introspection representation of an enum type. */\nexport interface IntrospectionEnumType {\n  /** The introspection kind discriminator for this type reference or type. */\n  readonly kind: typeof TypeKind.ENUM;\n  /** The GraphQL name for this schema element. */\n  readonly name: string;\n  /** Human-readable description for this schema element, if provided. */\n  readonly description?: Maybe<string>;\n  /** Values declared by this enum type. */\n  readonly enumValues: ReadonlyArray<IntrospectionEnumValue>;\n}\n\n/** The introspection representation of an input object type. */\nexport interface IntrospectionInputObjectType {\n  /** The introspection kind discriminator for this type reference or type. */\n  readonly kind: typeof TypeKind.INPUT_OBJECT;\n  /** The GraphQL name for this schema element. */\n  readonly name: string;\n  /** Human-readable description for this schema element, if provided. */\n  readonly description?: Maybe<string>;\n  /** Input fields declared by this input object type. */\n  readonly inputFields: ReadonlyArray<IntrospectionInputValue>;\n  /** Whether this input object uses the experimental OneOf input object semantics. */\n  readonly isOneOf: boolean;\n}\n\n/**\n * The introspection representation of a list type reference.\n * @typeParam T - The introspection type reference wrapped by this list type reference.\n */\nexport interface IntrospectionListTypeRef<\n  T extends IntrospectionTypeRef = IntrospectionTypeRef,\n> {\n  /** The introspection kind discriminator for this type reference or type. */\n  readonly kind: typeof TypeKind.LIST;\n  /** The type wrapped by this list or non-null type. */\n  readonly ofType: T;\n}\n\n/**\n * The introspection representation of a non-null type reference.\n * @typeParam T - The introspection type reference wrapped by this non-null type reference.\n */\nexport interface IntrospectionNonNullTypeRef<\n  T extends IntrospectionTypeRef = IntrospectionTypeRef,\n> {\n  /** The introspection kind discriminator for this type reference or type. */\n  readonly kind: typeof TypeKind.NON_NULL;\n  /** The type wrapped by this list or non-null type. */\n  readonly ofType: T;\n}\n\n/** Any introspection representation of a type reference. */\nexport type IntrospectionTypeRef =\n  | IntrospectionNamedTypeRef\n  | IntrospectionListTypeRef\n  | IntrospectionNonNullTypeRef<\n      IntrospectionNamedTypeRef | IntrospectionListTypeRef\n    >;\n\n/** An introspection type reference that can appear in output position. */\nexport type IntrospectionOutputTypeRef =\n  | IntrospectionNamedTypeRef<IntrospectionOutputType>\n  | IntrospectionListTypeRef<IntrospectionOutputTypeRef>\n  | IntrospectionNonNullTypeRef<\n      | IntrospectionNamedTypeRef<IntrospectionOutputType>\n      | IntrospectionListTypeRef<IntrospectionOutputTypeRef>\n    >;\n\n/** An introspection type reference that can appear in input position. */\nexport type IntrospectionInputTypeRef =\n  | IntrospectionNamedTypeRef<IntrospectionInputType>\n  | IntrospectionListTypeRef<IntrospectionInputTypeRef>\n  | IntrospectionNonNullTypeRef<\n      | IntrospectionNamedTypeRef<IntrospectionInputType>\n      | IntrospectionListTypeRef<IntrospectionInputTypeRef>\n    >;\n\n/**\n * The introspection representation of a named type reference.\n * @typeParam T - The introspection type represented by this named type reference.\n */\nexport interface IntrospectionNamedTypeRef<\n  T extends IntrospectionType = IntrospectionType,\n> {\n  /** The introspection kind discriminator for this type reference or type. */\n  readonly kind: T['kind'];\n  /** The GraphQL name for this schema element. */\n  readonly name: string;\n}\n\n/** The introspection representation of a field. */\nexport interface IntrospectionField {\n  /** The GraphQL name for this schema element. */\n  readonly name: string;\n  /** Human-readable description for this schema element, if provided. */\n  readonly description?: Maybe<string>;\n  /** Arguments accepted by this field or directive. */\n  readonly args: ReadonlyArray<IntrospectionInputValue>;\n  /** The GraphQL type reference or runtime type for this element. */\n  readonly type: IntrospectionOutputTypeRef;\n  /** Whether this field, argument, enum value, or input value is deprecated. */\n  readonly isDeprecated: boolean;\n  /** Reason this element is deprecated, if one was provided. */\n  readonly deprecationReason: Maybe<string>;\n}\n\n/** The introspection representation of an argument or input field. */\nexport interface IntrospectionInputValue {\n  /** The GraphQL name for this schema element. */\n  readonly name: string;\n  /** Human-readable description for this schema element, if provided. */\n  readonly description?: Maybe<string>;\n  /** The GraphQL type reference or runtime type for this element. */\n  readonly type: IntrospectionInputTypeRef;\n  /** Default value used when no explicit value is supplied. */\n  readonly defaultValue: Maybe<string>;\n  /** Whether this field, argument, enum value, or input value is deprecated. */\n  readonly isDeprecated?: boolean;\n  /** Reason this element is deprecated, if one was provided. */\n  readonly deprecationReason?: Maybe<string>;\n}\n\n/** The introspection representation of an enum value. */\nexport interface IntrospectionEnumValue {\n  /** The GraphQL name for this schema element. */\n  readonly name: string;\n  /** Human-readable description for this schema element, if provided. */\n  readonly description?: Maybe<string>;\n  /** Whether this field, argument, enum value, or input value is deprecated. */\n  readonly isDeprecated: boolean;\n  /** Reason this element is deprecated, if one was provided. */\n  readonly deprecationReason: Maybe<string>;\n}\n\n/** The introspection representation of a directive. */\nexport interface IntrospectionDirective {\n  /** The GraphQL name for this schema element. */\n  readonly name: string;\n  /** Human-readable description for this schema element, if provided. */\n  readonly description?: Maybe<string>;\n  /** Whether this directive may appear more than once at the same location. */\n  readonly isRepeatable?: boolean;\n  /** Whether this field, argument, enum value, or input value is deprecated. */\n  readonly isDeprecated?: boolean;\n  /** Reason this element is deprecated, if one was provided. */\n  readonly deprecationReason?: Maybe<string>;\n  /** Locations where this directive may be applied. */\n  readonly locations: ReadonlyArray<DirectiveLocation>;\n  /** Arguments accepted by this field or directive. */\n  readonly args: ReadonlyArray<IntrospectionInputValue>;\n}\n"]}

package/utilities/getOperationAST.d.mts

@@ -1,8 +1,23 @@
+/** @category Operations */
 import type { Maybe } from "../jsutils/Maybe.mjs";
 import type { DocumentNode, OperationDefinitionNode } from "../language/ast.mjs";
 /**
  * Returns an operation AST given a document AST and optionally an operation
  * name. If a name is not provided, an operation is only returned if only one is
  * provided in the document.
+ * @param documentAST - The parsed GraphQL document AST.
+ * @param operationName - The optional operation name to select.
+ * @returns The resolved operation ast.
+ * @example
+ * ```ts
+ * import { parse } from 'graphql/language';
+ * import { getOperationAST } from 'graphql/utilities';
+ *
+ * const document = parse('query GetName { name }');
+ * const operation = getOperationAST(document, 'GetName');
+ *
+ * operation.name.value; // => 'GetName'
+ * getOperationAST(document, 'Missing'); // => undefined
+ * ```
  */
 export declare function getOperationAST(documentAST: DocumentNode, operationName?: Maybe<string>): Maybe<OperationDefinitionNode>;

package/utilities/getOperationAST.d.ts

@@ -1,8 +1,23 @@
+/** @category Operations */
 import type { Maybe } from "../jsutils/Maybe.js";
 import type { DocumentNode, OperationDefinitionNode } from "../language/ast.js";
 /**
  * Returns an operation AST given a document AST and optionally an operation
  * name. If a name is not provided, an operation is only returned if only one is
  * provided in the document.
+ * @param documentAST - The parsed GraphQL document AST.
+ * @param operationName - The optional operation name to select.
+ * @returns The resolved operation ast.
+ * @example
+ * ```ts
+ * import { parse } from 'graphql/language';
+ * import { getOperationAST } from 'graphql/utilities';
+ *
+ * const document = parse('query GetName { name }');
+ * const operation = getOperationAST(document, 'GetName');
+ *
+ * operation.name.value; // => 'GetName'
+ * getOperationAST(document, 'Missing'); // => undefined
+ * ```
  */
 export declare function getOperationAST(documentAST: DocumentNode, operationName?: Maybe<string>): Maybe<OperationDefinitionNode>;

package/utilities/getOperationAST.js

@@ -2,19 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getOperationAST = getOperationAST;
 const kinds_ts_1 = require("../language/kinds.js");
-/**
- * Returns an operation AST given a document AST and optionally an operation
- * name. If a name is not provided, an operation is only returned if only one is
- * provided in the document.
- */
 function getOperationAST(documentAST, operationName) {
     let operation = null;
     for (const definition of documentAST.definitions) {
         if (definition.kind === kinds_ts_1.Kind.OPERATION_DEFINITION) {
             if (operationName == null) {
-                // If no operation name was provided, only return an Operation if there
-                // is one defined in the document. Upon encountering the second, return
-                // null.
                 if (operation) {
                     return null;
                 }

package/utilities/getOperationAST.js.map

@@ -1 +1 @@
-{"version":3,"file":"getOperationAST.js","sourceRoot":"","sources":["../../src/utilities/getOperationAST.ts"],"names":[],"mappings":";;AAUA,0CAqBC;AA5BD,mDAA4C;AAE5C;;;;GAIG;AACH,SAAgB,eAAe,CAC7B,WAAyB,EACzB,aAA6B;IAE7B,IAAI,SAAS,GAAG,IAAI,CAAC;IACrB,KAAK,MAAM,UAAU,IAAI,WAAW,CAAC,WAAW,EAAE,CAAC;QACjD,IAAI,UAAU,CAAC,IAAI,KAAK,eAAI,CAAC,oBAAoB,EAAE,CAAC;YAClD,IAAI,aAAa,IAAI,IAAI,EAAE,CAAC;gBAC1B,uEAAuE;gBACvE,uEAAuE;gBACvE,QAAQ;gBACR,IAAI,SAAS,EAAE,CAAC;oBACd,OAAO,IAAI,CAAC;gBACd,CAAC;gBACD,SAAS,GAAG,UAAU,CAAC;YACzB,CAAC;iBAAM,IAAI,UAAU,CAAC,IAAI,EAAE,KAAK,KAAK,aAAa,EAAE,CAAC;gBACpD,OAAO,UAAU,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["import type { Maybe } from '../jsutils/Maybe.ts';\n\nimport type { DocumentNode, OperationDefinitionNode } from '../language/ast.ts';\nimport { Kind } from '../language/kinds.ts';\n\n/**\n * Returns an operation AST given a document AST and optionally an operation\n * name. If a name is not provided, an operation is only returned if only one is\n * provided in the document.\n */\nexport function getOperationAST(\n  documentAST: DocumentNode,\n  operationName?: Maybe<string>,\n): Maybe<OperationDefinitionNode> {\n  let operation = null;\n  for (const definition of documentAST.definitions) {\n    if (definition.kind === Kind.OPERATION_DEFINITION) {\n      if (operationName == null) {\n        // If no operation name was provided, only return an Operation if there\n        // is one defined in the document. Upon encountering the second, return\n        // null.\n        if (operation) {\n          return null;\n        }\n        operation = definition;\n      } else if (definition.name?.value === operationName) {\n        return definition;\n      }\n    }\n  }\n  return operation;\n}\n"]}
+{"version":3,"file":"getOperationAST.js","sourceRoot":"","sources":["../../src/utilities/getOperationAST.ts"],"names":[],"mappings":";;AA0BA,0CAqBC;AA1CD,mDAA4C;AAqB5C,SAAgB,eAAe,CAC7B,WAAyB,EACzB,aAA6B;IAE7B,IAAI,SAAS,GAAG,IAAI,CAAC;IACrB,KAAK,MAAM,UAAU,IAAI,WAAW,CAAC,WAAW,EAAE,CAAC;QACjD,IAAI,UAAU,CAAC,IAAI,KAAK,eAAI,CAAC,oBAAoB,EAAE,CAAC;YAClD,IAAI,aAAa,IAAI,IAAI,EAAE,CAAC;gBAI1B,IAAI,SAAS,EAAE,CAAC;oBACd,OAAO,IAAI,CAAC;gBACd,CAAC;gBACD,SAAS,GAAG,UAAU,CAAC;YACzB,CAAC;iBAAM,IAAI,UAAU,CAAC,IAAI,EAAE,KAAK,KAAK,aAAa,EAAE,CAAC;gBACpD,OAAO,UAAU,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["/** @category Operations */\n\nimport type { Maybe } from '../jsutils/Maybe.ts';\n\nimport type { DocumentNode, OperationDefinitionNode } from '../language/ast.ts';\nimport { Kind } from '../language/kinds.ts';\n\n/**\n * Returns an operation AST given a document AST and optionally an operation\n * name. If a name is not provided, an operation is only returned if only one is\n * provided in the document.\n * @param documentAST - The parsed GraphQL document AST.\n * @param operationName - The optional operation name to select.\n * @returns The resolved operation ast.\n * @example\n * ```ts\n * import { parse } from 'graphql/language';\n * import { getOperationAST } from 'graphql/utilities';\n *\n * const document = parse('query GetName { name }');\n * const operation = getOperationAST(document, 'GetName');\n *\n * operation.name.value; // => 'GetName'\n * getOperationAST(document, 'Missing'); // => undefined\n * ```\n */\nexport function getOperationAST(\n  documentAST: DocumentNode,\n  operationName?: Maybe<string>,\n): Maybe<OperationDefinitionNode> {\n  let operation = null;\n  for (const definition of documentAST.definitions) {\n    if (definition.kind === Kind.OPERATION_DEFINITION) {\n      if (operationName == null) {\n        // If no operation name was provided, only return an Operation if there\n        // is one defined in the document. Upon encountering the second, return\n        // null.\n        if (operation) {\n          return null;\n        }\n        operation = definition;\n      } else if (definition.name?.value === operationName) {\n        return definition;\n      }\n    }\n  }\n  return operation;\n}\n"]}

package/utilities/getOperationAST.mjs

@@ -1,17 +1,9 @@
 import { Kind } from "../language/kinds.mjs";
-/**
- * Returns an operation AST given a document AST and optionally an operation
- * name. If a name is not provided, an operation is only returned if only one is
- * provided in the document.
- */
 export function getOperationAST(documentAST, operationName) {
     let operation = null;
     for (const definition of documentAST.definitions) {
         if (definition.kind === Kind.OPERATION_DEFINITION) {
             if (operationName == null) {
-                // If no operation name was provided, only return an Operation if there
-                // is one defined in the document. Upon encountering the second, return
-                // null.
                 if (operation) {
                     return null;
                 }

package/utilities/getOperationAST.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"getOperationAST.js","sourceRoot":"","sources":["../../src/utilities/getOperationAST.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAE,8BAA6B;AAE5C;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,WAAyB,EACzB,aAA6B;IAE7B,IAAI,SAAS,GAAG,IAAI,CAAC;IACrB,KAAK,MAAM,UAAU,IAAI,WAAW,CAAC,WAAW,EAAE,CAAC;QACjD,IAAI,UAAU,CAAC,IAAI,KAAK,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAClD,IAAI,aAAa,IAAI,IAAI,EAAE,CAAC;gBAC1B,uEAAuE;gBACvE,uEAAuE;gBACvE,QAAQ;gBACR,IAAI,SAAS,EAAE,CAAC;oBACd,OAAO,IAAI,CAAC;gBACd,CAAC;gBACD,SAAS,GAAG,UAAU,CAAC;YACzB,CAAC;iBAAM,IAAI,UAAU,CAAC,IAAI,EAAE,KAAK,KAAK,aAAa,EAAE,CAAC;gBACpD,OAAO,UAAU,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["import type { Maybe } from '../jsutils/Maybe.ts';\n\nimport type { DocumentNode, OperationDefinitionNode } from '../language/ast.ts';\nimport { Kind } from '../language/kinds.ts';\n\n/**\n * Returns an operation AST given a document AST and optionally an operation\n * name. If a name is not provided, an operation is only returned if only one is\n * provided in the document.\n */\nexport function getOperationAST(\n  documentAST: DocumentNode,\n  operationName?: Maybe<string>,\n): Maybe<OperationDefinitionNode> {\n  let operation = null;\n  for (const definition of documentAST.definitions) {\n    if (definition.kind === Kind.OPERATION_DEFINITION) {\n      if (operationName == null) {\n        // If no operation name was provided, only return an Operation if there\n        // is one defined in the document. Upon encountering the second, return\n        // null.\n        if (operation) {\n          return null;\n        }\n        operation = definition;\n      } else if (definition.name?.value === operationName) {\n        return definition;\n      }\n    }\n  }\n  return operation;\n}\n"]}
+{"version":3,"file":"getOperationAST.js","sourceRoot":"","sources":["../../src/utilities/getOperationAST.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,IAAI,EAAE,8BAA6B;AAqB5C,MAAM,UAAU,eAAe,CAC7B,WAAyB,EACzB,aAA6B;IAE7B,IAAI,SAAS,GAAG,IAAI,CAAC;IACrB,KAAK,MAAM,UAAU,IAAI,WAAW,CAAC,WAAW,EAAE,CAAC;QACjD,IAAI,UAAU,CAAC,IAAI,KAAK,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAClD,IAAI,aAAa,IAAI,IAAI,EAAE,CAAC;gBAI1B,IAAI,SAAS,EAAE,CAAC;oBACd,OAAO,IAAI,CAAC;gBACd,CAAC;gBACD,SAAS,GAAG,UAAU,CAAC;YACzB,CAAC;iBAAM,IAAI,UAAU,CAAC,IAAI,EAAE,KAAK,KAAK,aAAa,EAAE,CAAC;gBACpD,OAAO,UAAU,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["/** @category Operations */\n\nimport type { Maybe } from '../jsutils/Maybe.ts';\n\nimport type { DocumentNode, OperationDefinitionNode } from '../language/ast.ts';\nimport { Kind } from '../language/kinds.ts';\n\n/**\n * Returns an operation AST given a document AST and optionally an operation\n * name. If a name is not provided, an operation is only returned if only one is\n * provided in the document.\n * @param documentAST - The parsed GraphQL document AST.\n * @param operationName - The optional operation name to select.\n * @returns The resolved operation ast.\n * @example\n * ```ts\n * import { parse } from 'graphql/language';\n * import { getOperationAST } from 'graphql/utilities';\n *\n * const document = parse('query GetName { name }');\n * const operation = getOperationAST(document, 'GetName');\n *\n * operation.name.value; // => 'GetName'\n * getOperationAST(document, 'Missing'); // => undefined\n * ```\n */\nexport function getOperationAST(\n  documentAST: DocumentNode,\n  operationName?: Maybe<string>,\n): Maybe<OperationDefinitionNode> {\n  let operation = null;\n  for (const definition of documentAST.definitions) {\n    if (definition.kind === Kind.OPERATION_DEFINITION) {\n      if (operationName == null) {\n        // If no operation name was provided, only return an Operation if there\n        // is one defined in the document. Upon encountering the second, return\n        // null.\n        if (operation) {\n          return null;\n        }\n        operation = definition;\n      } else if (definition.name?.value === operationName) {\n        return definition;\n      }\n    }\n  }\n  return operation;\n}\n"]}

package/utilities/index.d.mts

@@ -1,3 +1,10 @@
+/**
+ * Utilities for building schemas, working with introspection, transforming ASTs,
+ * and comparing GraphQL types.
+ *
+ * These exports are also available from the root `graphql` package.
+ * @packageDocumentation
+ */
 export { getIntrospectionQuery } from "./getIntrospectionQuery.mjs";
 export type { IntrospectionOptions, IntrospectionQuery, IntrospectionSchema, IntrospectionType, IntrospectionInputType, IntrospectionOutputType, IntrospectionScalarType, IntrospectionObjectType, IntrospectionInterfaceType, IntrospectionUnionType, IntrospectionEnumType, IntrospectionInputObjectType, IntrospectionTypeRef, IntrospectionInputTypeRef, IntrospectionOutputTypeRef, IntrospectionNamedTypeRef, IntrospectionListTypeRef, IntrospectionNonNullTypeRef, IntrospectionField, IntrospectionInputValue, IntrospectionEnumValue, IntrospectionDirective, } from "./getIntrospectionQuery.mjs";
 export { getOperationAST } from "./getOperationAST.mjs";
@@ -10,11 +17,19 @@ export { lexicographicSortSchema } from "./lexicographicSortSchema.mjs";
 export { printSchema, printType, printDirective, printIntrospectionSchema, } from "./printSchema.mjs";
 export { typeFromAST } from "./typeFromAST.mjs";
 export { 
-/** @deprecated use `coerceInputLiteral()` instead - will be removed in v18 */
+/**
+ * Deprecated export retained for compatibility. Use `coerceInputLiteral()`
+ * instead.
+ * @deprecated use `coerceInputLiteral()` instead - will be removed in v18
+ */
 valueFromAST, } from "./valueFromAST.mjs";
 export { valueFromASTUntyped } from "./valueFromASTUntyped.mjs";
 export { 
-/** @deprecated use `valueToLiteral()` instead with care to operate on external values - `astFromValue()` will be removed in v18 */
+/**
+ * Deprecated export retained for compatibility. Use `valueToLiteral()`
+ * instead, and take care to operate on external values.
+ * @deprecated use `valueToLiteral()` instead with care to operate on external values - `astFromValue()` will be removed in v18
+ */
 astFromValue, } from "./astFromValue.mjs";
 export { TypeInfo, visitWithTypeInfo } from "./TypeInfo.mjs";
 export { replaceVariables } from "./replaceVariables.mjs";
@@ -26,7 +41,7 @@ export { separateOperations } from "./separateOperations.mjs";
 export { stripIgnoredCharacters } from "./stripIgnoredCharacters.mjs";
 export { isEqualType, isTypeSubTypeOf, doTypesOverlap, } from "./typeComparators.mjs";
 export { BreakingChangeType, DangerousChangeType, SafeChangeType, findBreakingChanges, findDangerousChanges, findSchemaChanges, } from "./findSchemaChanges.mjs";
-export type { BreakingChange, DangerousChange, SafeChange, } from "./findSchemaChanges.mjs";
+export type { BreakingChange, DangerousChange, SafeChange, SchemaChange, } from "./findSchemaChanges.mjs";
 export type { TypedQueryDocumentNode } from "./typedQueryDocumentNode.mjs";
 export { resolveSchemaCoordinate, resolveASTSchemaCoordinate, } from "./resolveSchemaCoordinate.mjs";
 export type { ResolvedSchemaElement } from "./resolveSchemaCoordinate.mjs";

package/utilities/index.d.ts

@@ -1,3 +1,10 @@
+/**
+ * Utilities for building schemas, working with introspection, transforming ASTs,
+ * and comparing GraphQL types.
+ *
+ * These exports are also available from the root `graphql` package.
+ * @packageDocumentation
+ */
 export { getIntrospectionQuery } from "./getIntrospectionQuery.js";
 export type { IntrospectionOptions, IntrospectionQuery, IntrospectionSchema, IntrospectionType, IntrospectionInputType, IntrospectionOutputType, IntrospectionScalarType, IntrospectionObjectType, IntrospectionInterfaceType, IntrospectionUnionType, IntrospectionEnumType, IntrospectionInputObjectType, IntrospectionTypeRef, IntrospectionInputTypeRef, IntrospectionOutputTypeRef, IntrospectionNamedTypeRef, IntrospectionListTypeRef, IntrospectionNonNullTypeRef, IntrospectionField, IntrospectionInputValue, IntrospectionEnumValue, IntrospectionDirective, } from "./getIntrospectionQuery.js";
 export { getOperationAST } from "./getOperationAST.js";
@@ -10,11 +17,19 @@ export { lexicographicSortSchema } from "./lexicographicSortSchema.js";
 export { printSchema, printType, printDirective, printIntrospectionSchema, } from "./printSchema.js";
 export { typeFromAST } from "./typeFromAST.js";
 export { 
-/** @deprecated use `coerceInputLiteral()` instead - will be removed in v18 */
+/**
+ * Deprecated export retained for compatibility. Use `coerceInputLiteral()`
+ * instead.
+ * @deprecated use `coerceInputLiteral()` instead - will be removed in v18
+ */
 valueFromAST, } from "./valueFromAST.js";
 export { valueFromASTUntyped } from "./valueFromASTUntyped.js";
 export { 
-/** @deprecated use `valueToLiteral()` instead with care to operate on external values - `astFromValue()` will be removed in v18 */
+/**
+ * Deprecated export retained for compatibility. Use `valueToLiteral()`
+ * instead, and take care to operate on external values.
+ * @deprecated use `valueToLiteral()` instead with care to operate on external values - `astFromValue()` will be removed in v18
+ */
 astFromValue, } from "./astFromValue.js";
 export { TypeInfo, visitWithTypeInfo } from "./TypeInfo.js";
 export { replaceVariables } from "./replaceVariables.js";
@@ -26,7 +41,7 @@ export { separateOperations } from "./separateOperations.js";
 export { stripIgnoredCharacters } from "./stripIgnoredCharacters.js";
 export { isEqualType, isTypeSubTypeOf, doTypesOverlap, } from "./typeComparators.js";
 export { BreakingChangeType, DangerousChangeType, SafeChangeType, findBreakingChanges, findDangerousChanges, findSchemaChanges, } from "./findSchemaChanges.js";
-export type { BreakingChange, DangerousChange, SafeChange, } from "./findSchemaChanges.js";
+export type { BreakingChange, DangerousChange, SafeChange, SchemaChange, } from "./findSchemaChanges.js";
 export type { TypedQueryDocumentNode } from "./typedQueryDocumentNode.js";
 export { resolveSchemaCoordinate, resolveASTSchemaCoordinate, } from "./resolveSchemaCoordinate.js";
 export type { ResolvedSchemaElement } from "./resolveSchemaCoordinate.js";