graphql 17.0.0-beta.0 → 17.0.0-beta.2

package/utilities/astFromValue.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"astFromValue.js","sourceRoot":"","sources":["../../src/utilities/astFromValue.ts"],"names":[],"mappings":"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","sourcesContent":["import { inspect } from '../jsutils/inspect.js';\nimport { invariant } from '../jsutils/invariant.js';\nimport { isIterableObject } from '../jsutils/isIterableObject.js';\nimport { isObjectLike } from '../jsutils/isObjectLike.js';\nimport type { Maybe } from '../jsutils/Maybe.js';\n\nimport type { ConstObjectFieldNode, ConstValueNode } from '../language/ast.js';\nimport { Kind } from '../language/kinds.js';\n\nimport type { GraphQLInputType } from '../type/definition.js';\nimport {\n  isEnumType,\n  isInputObjectType,\n  isLeafType,\n  isListType,\n  isNonNullType,\n} from '../type/definition.js';\nimport { GraphQLID } from '../type/scalars.js';\n\n/**\n * Produces a GraphQL Value AST given a JavaScript object.\n * Function will match JavaScript/JSON values to GraphQL AST schema format\n * by using suggested GraphQLInputType. For example:\n *\n *     astFromValue(\"value\", GraphQLString)\n *\n * A GraphQL type must be provided, which will be used to interpret different\n * JavaScript values.\n *\n * | JSON Value    | GraphQL Value        |\n * | ------------- | -------------------- |\n * | Object        | Input Object         |\n * | Array         | List                 |\n * | Boolean       | Boolean              |\n * | String        | String / Enum Value  |\n * | Number        | Int / Float          |\n * | BigInt        | Int                  |\n * | Unknown       | Enum Value           |\n * | null          | NullValue            |\n *\n * @deprecated use `valueToLiteral()` instead with care to operate on external values - `astFromValue()` will be removed in v18\n */\nexport function astFromValue(\n  value: unknown,\n  type: GraphQLInputType,\n): Maybe<ConstValueNode> {\n  if (isNonNullType(type)) {\n    const astValue = astFromValue(value, type.ofType);\n    if (astValue?.kind === Kind.NULL) {\n      return null;\n    }\n    return astValue;\n  }\n\n  // only explicit null, not undefined, NaN\n  if (value === null) {\n    return { kind: Kind.NULL };\n  }\n\n  // undefined\n  if (value === undefined) {\n    return null;\n  }\n\n  // Convert JavaScript array to GraphQL list. If the GraphQLType is a list, but\n  // the value is not an array, convert the value using the list's item type.\n  if (isListType(type)) {\n    const itemType = type.ofType;\n    if (isIterableObject(value)) {\n      const valuesNodes = [];\n      for (const item of value) {\n        const itemNode = astFromValue(item, itemType);\n        if (itemNode != null) {\n          valuesNodes.push(itemNode);\n        }\n      }\n      return { kind: Kind.LIST, values: valuesNodes };\n    }\n    return astFromValue(value, itemType);\n  }\n\n  // Populate the fields of the input object by creating ASTs from each value\n  // in the JavaScript object according to the fields in the input type.\n  if (isInputObjectType(type)) {\n    if (!isObjectLike(value)) {\n      return null;\n    }\n    const fieldNodes: Array<ConstObjectFieldNode> = [];\n    for (const field of Object.values(type.getFields())) {\n      const fieldValue = astFromValue(value[field.name], field.type);\n      if (fieldValue) {\n        fieldNodes.push({\n          kind: Kind.OBJECT_FIELD,\n          name: { kind: Kind.NAME, value: field.name },\n          value: fieldValue,\n        });\n      }\n    }\n    return { kind: Kind.OBJECT, fields: fieldNodes };\n  }\n\n  if (isLeafType(type)) {\n    // Since value is an internally represented value, it must be coerced\n    // to an externally represented value before converting into an AST.\n    const coerced = type.coerceOutputValue(value);\n    if (coerced == null) {\n      return null;\n    }\n\n    // Others coerce based on their corresponding JavaScript scalar types.\n    if (typeof coerced === 'boolean') {\n      return { kind: Kind.BOOLEAN, value: coerced };\n    }\n\n    // JavaScript numbers can be Int or Float values.\n    if (typeof coerced === 'number' && Number.isFinite(coerced)) {\n      const stringNum = String(coerced);\n      return integerStringRegExp.test(stringNum)\n        ? { kind: Kind.INT, value: stringNum }\n        : { kind: Kind.FLOAT, value: stringNum };\n    }\n\n    if (typeof coerced === 'bigint') {\n      return { kind: Kind.INT, value: String(coerced) };\n    }\n\n    if (typeof coerced === 'string') {\n      // Enum types use Enum literals.\n      if (isEnumType(type)) {\n        return { kind: Kind.ENUM, value: coerced };\n      }\n\n      // ID types can use Int literals.\n      if (type === GraphQLID && integerStringRegExp.test(coerced)) {\n        return { kind: Kind.INT, value: coerced };\n      }\n\n      return {\n        kind: Kind.STRING,\n        value: coerced,\n      };\n    }\n\n    throw new TypeError(`Cannot convert value to AST: ${inspect(coerced)}.`);\n    // c8 control statement technically placed a line early secondary to\n    // slight swc source mapping error (at least as compared to ts-node without swc)\n    /* c8 ignore next 4 */\n  }\n  // Not reachable, all possible types have been considered.\n  invariant(false, 'Unexpected input type: ' + inspect(type));\n}\n\n/**\n * IntValue:\n *   - NegativeSign? 0\n *   - NegativeSign? NonZeroDigit ( Digit+ )?\n */\nconst integerStringRegExp = /^-?(?:0|[1-9][0-9]*)$/;\n"]}
+{"version":3,"file":"astFromValue.js","sourceRoot":"","sources":["../../src/utilities/astFromValue.ts"],"names":[],"mappings":"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","sourcesContent":["/** @category Values */\n\nimport { inspect } from '../jsutils/inspect.ts';\nimport { invariant } from '../jsutils/invariant.ts';\nimport { isIterableObject } from '../jsutils/isIterableObject.ts';\nimport { isObjectLike } from '../jsutils/isObjectLike.ts';\nimport type { Maybe } from '../jsutils/Maybe.ts';\n\nimport type { ConstObjectFieldNode, ConstValueNode } from '../language/ast.ts';\nimport { Kind } from '../language/kinds.ts';\n\nimport type { GraphQLInputType } from '../type/definition.ts';\nimport {\n  isEnumType,\n  isInputObjectType,\n  isLeafType,\n  isListType,\n  isNonNullType,\n} from '../type/definition.ts';\nimport { GraphQLID } from '../type/scalars.ts';\n\n/**\n * Produces a GraphQL Value AST given a JavaScript object.\n * Function will match JavaScript/JSON values to GraphQL AST schema format\n * by using suggested GraphQLInputType.\n *\n * A GraphQL type must be provided, which will be used to interpret different\n * JavaScript values.\n *\n * This deprecated function will be removed in v18. Use `valueToLiteral()`\n * instead, and take care to operate on external values.\n *\n * | JSON Value    | GraphQL Value        |\n * | ------------- | -------------------- |\n * | Object        | Input Object         |\n * | Array         | List                 |\n * | Boolean       | Boolean              |\n * | String        | String / Enum Value  |\n * | Number        | Int / Float          |\n * | BigInt        | Int                  |\n * | Unknown       | Enum Value           |\n * | null          | NullValue            |\n * @param value - Runtime value to convert.\n * @param type - The GraphQL type to inspect.\n * @returns A GraphQL value AST for the provided JavaScript value, or null when no literal can represent it.\n * @example\n * ```ts\n * import { print } from 'graphql/language';\n * import {\n *   GraphQLInputObjectType,\n *   GraphQLInt,\n *   GraphQLList,\n *   GraphQLNonNull,\n *   GraphQLString,\n * } from 'graphql/type';\n * import { astFromValue } from 'graphql/utilities';\n *\n * const ReviewInput = new GraphQLInputObjectType({\n *   name: 'ReviewInput',\n *   fields: {\n *     stars: { type: new GraphQLNonNull(GraphQLInt) },\n *     tags: { type: new GraphQLList(GraphQLString) },\n *   },\n * });\n *\n * const valueNode = astFromValue(\n *   { stars: 5, tags: ['featured', 'verified'] },\n *   ReviewInput,\n * );\n *\n * print(valueNode); // => '{ stars: 5, tags: [\"featured\", \"verified\"] }'\n * astFromValue(undefined, GraphQLString); // => null\n * astFromValue(null, new GraphQLNonNull(GraphQLString)); // => null\n * ```\n * @deprecated use `valueToLiteral()` instead with care to operate on external values - `astFromValue()` will be removed in v18\n */\nexport function astFromValue(\n  value: unknown,\n  type: GraphQLInputType,\n): Maybe<ConstValueNode> {\n  if (isNonNullType(type)) {\n    const astValue = astFromValue(value, type.ofType);\n    if (astValue?.kind === Kind.NULL) {\n      return null;\n    }\n    return astValue;\n  }\n\n  // only explicit null, not undefined, NaN\n  if (value === null) {\n    return { kind: Kind.NULL };\n  }\n\n  // undefined\n  if (value === undefined) {\n    return null;\n  }\n\n  // Convert JavaScript array to GraphQL list. If the GraphQLType is a list, but\n  // the value is not an array, convert the value using the list's item type.\n  if (isListType(type)) {\n    const itemType = type.ofType;\n    if (isIterableObject(value)) {\n      const valuesNodes = [];\n      for (const item of value) {\n        const itemNode = astFromValue(item, itemType);\n        if (itemNode != null) {\n          valuesNodes.push(itemNode);\n        }\n      }\n      return { kind: Kind.LIST, values: valuesNodes };\n    }\n    return astFromValue(value, itemType);\n  }\n\n  // Populate the fields of the input object by creating ASTs from each value\n  // in the JavaScript object according to the fields in the input type.\n  if (isInputObjectType(type)) {\n    if (!isObjectLike(value)) {\n      return null;\n    }\n    const fieldNodes: Array<ConstObjectFieldNode> = [];\n    for (const field of Object.values(type.getFields())) {\n      const fieldValue = astFromValue(value[field.name], field.type);\n      if (fieldValue) {\n        fieldNodes.push({\n          kind: Kind.OBJECT_FIELD,\n          name: { kind: Kind.NAME, value: field.name },\n          value: fieldValue,\n        });\n      }\n    }\n    return { kind: Kind.OBJECT, fields: fieldNodes };\n  }\n\n  if (isLeafType(type)) {\n    // Since value is an internally represented value, it must be coerced\n    // to an externally represented value before converting into an AST.\n    const coerced = type.coerceOutputValue(value);\n    if (coerced == null) {\n      return null;\n    }\n\n    // Others coerce based on their corresponding JavaScript scalar types.\n    if (typeof coerced === 'boolean') {\n      return { kind: Kind.BOOLEAN, value: coerced };\n    }\n\n    // JavaScript numbers can be Int or Float values.\n    if (typeof coerced === 'number' && Number.isFinite(coerced)) {\n      const stringNum = String(coerced);\n      return integerStringRegExp.test(stringNum)\n        ? { kind: Kind.INT, value: stringNum }\n        : { kind: Kind.FLOAT, value: stringNum };\n    }\n\n    if (typeof coerced === 'bigint') {\n      return { kind: Kind.INT, value: String(coerced) };\n    }\n\n    if (typeof coerced === 'string') {\n      // Enum types use Enum literals.\n      if (isEnumType(type)) {\n        return { kind: Kind.ENUM, value: coerced };\n      }\n\n      // ID types can use Int literals.\n      if (type === GraphQLID && integerStringRegExp.test(coerced)) {\n        return { kind: Kind.INT, value: coerced };\n      }\n\n      return {\n        kind: Kind.STRING,\n        value: coerced,\n      };\n    }\n\n    throw new TypeError(`Cannot convert value to AST: ${inspect(coerced)}.`);\n    /* node:coverage ignore next 4 */\n  }\n  // Not reachable, all possible types have been considered.\n  invariant(false, 'Unexpected input type: ' + inspect(type));\n}\n\n/**\n * IntValue:\n *   - NegativeSign? 0\n *   - NegativeSign? NonZeroDigit ( Digit+ )?\n *\n * @internal\n */\nconst integerStringRegExp = /^-?(?:0|[1-9][0-9]*)$/;\n"]}

package/utilities/buildASTSchema.d.mts

@@ -1,8 +1,10 @@
-import type { DocumentNode } from '../language/ast.js';
-import type { ParseOptions } from '../language/parser.js';
-import type { Source } from '../language/source.js';
-import type { GraphQLSchemaValidationOptions } from '../type/schema.js';
-import { GraphQLSchema } from '../type/schema.js';
+/** @category Schema Construction */
+import type { DocumentNode } from "../language/ast.mjs";
+import type { ParseOptions } from "../language/parser.mjs";
+import type { Source } from "../language/source.mjs";
+import type { GraphQLSchemaValidationOptions } from "../type/schema.mjs";
+import { GraphQLSchema } from "../type/schema.mjs";
+/** Options used when building a schema from SDL or a parsed SDL document. */
 export interface BuildSchemaOptions extends GraphQLSchemaValidationOptions {
     /**
      * Set to true to assume the SDL is valid.
@@ -12,18 +14,76 @@ export interface BuildSchemaOptions extends GraphQLSchemaValidationOptions {
     assumeValidSDL?: boolean | undefined;
 }
 /**
- * This takes the ast of a schema document produced by the parse function in
- * src/language/parser.js.
+ * Builds a GraphQLSchema from a parsed schema definition language document.
  *
  * If no schema definition is provided, then it will look for types named Query,
  * Mutation and Subscription.
  *
- * Given that AST it constructs a GraphQLSchema. The resulting schema
- * has no resolve methods, so execution will use default resolvers.
+ * The resulting schema has no resolver functions, so execution will use the
+ * default field resolver.
+ * @param documentAST - The parsed GraphQL document AST.
+ * @param options - Optional configuration for this operation.
+ * @returns The schema built from the provided SDL document.
+ * @example
+ * ```ts
+ * // Build a schema from a valid parsed SDL document.
+ * import { parse } from 'graphql/language';
+ * import { buildASTSchema } from 'graphql/utilities';
+ *
+ * const document = parse('type Query { hello: String }');
+ * const schema = buildASTSchema(document);
+ *
+ * schema.getQueryType().name; // => 'Query'
+ * ```
+ * @example
+ * ```ts
+ * // This variant uses validation options when the SDL references unknown types.
+ * import { parse } from 'graphql/language';
+ * import { buildASTSchema } from 'graphql/utilities';
+ *
+ * const document = parse('type Query { broken: MissingType }');
+ *
+ * buildASTSchema(document); // throws an error
+ * buildASTSchema(document, {
+ *   assumeValid: true,
+ *   assumeValidSDL: true,
+ * }); // does not throw
+ * ```
  */
 export declare function buildASTSchema(documentAST: DocumentNode, options?: BuildSchemaOptions): GraphQLSchema;
 /**
- * A helper function to build a GraphQLSchema directly from a source
- * document.
+ * Builds a GraphQLSchema directly from a schema definition language source.
+ * @param source - The GraphQL source text or source object.
+ * @param options - Optional configuration for this operation.
+ * @returns The schema built from the provided SDL document.
+ * @example
+ * ```ts
+ * // Build a schema from SDL source using the default options.
+ * import { buildSchema } from 'graphql/utilities';
+ *
+ * const schema = buildSchema('type Query { hello: String }');
+ *
+ * schema.getQueryType().name; // => 'Query'
+ * ```
+ * @example
+ * ```ts
+ * // This variant enables parser options and omits source locations.
+ * import { buildSchema } from 'graphql/utilities';
+ *
+ * const schema = buildSchema(
+ *   'directive @tag on FIELD_DEFINITION\n' +
+ *     'directive @compose @tag on FIELD_DEFINITION',
+ *   {
+ *     experimentalDirectivesOnDirectiveDefinitions: true,
+ *     experimentalFragmentArguments: true,
+ *     noLocation: true,
+ *   },
+ * );
+ *
+ * const directive = schema.getDirective('compose');
+ *
+ * directive.name; // => 'compose'
+ * directive.astNode.loc; // => undefined
+ * ```
  */
 export declare function buildSchema(source: string | Source, options?: BuildSchemaOptions & ParseOptions): GraphQLSchema;

package/utilities/buildASTSchema.d.ts

@@ -1,8 +1,10 @@
-import type { DocumentNode } from '../language/ast.js';
-import type { ParseOptions } from '../language/parser.js';
-import type { Source } from '../language/source.js';
-import type { GraphQLSchemaValidationOptions } from '../type/schema.js';
-import { GraphQLSchema } from '../type/schema.js';
+/** @category Schema Construction */
+import type { DocumentNode } from "../language/ast.js";
+import type { ParseOptions } from "../language/parser.js";
+import type { Source } from "../language/source.js";
+import type { GraphQLSchemaValidationOptions } from "../type/schema.js";
+import { GraphQLSchema } from "../type/schema.js";
+/** Options used when building a schema from SDL or a parsed SDL document. */
 export interface BuildSchemaOptions extends GraphQLSchemaValidationOptions {
     /**
      * Set to true to assume the SDL is valid.
@@ -12,18 +14,76 @@ export interface BuildSchemaOptions extends GraphQLSchemaValidationOptions {
     assumeValidSDL?: boolean | undefined;
 }
 /**
- * This takes the ast of a schema document produced by the parse function in
- * src/language/parser.js.
+ * Builds a GraphQLSchema from a parsed schema definition language document.
  *
  * If no schema definition is provided, then it will look for types named Query,
  * Mutation and Subscription.
  *
- * Given that AST it constructs a GraphQLSchema. The resulting schema
- * has no resolve methods, so execution will use default resolvers.
+ * The resulting schema has no resolver functions, so execution will use the
+ * default field resolver.
+ * @param documentAST - The parsed GraphQL document AST.
+ * @param options - Optional configuration for this operation.
+ * @returns The schema built from the provided SDL document.
+ * @example
+ * ```ts
+ * // Build a schema from a valid parsed SDL document.
+ * import { parse } from 'graphql/language';
+ * import { buildASTSchema } from 'graphql/utilities';
+ *
+ * const document = parse('type Query { hello: String }');
+ * const schema = buildASTSchema(document);
+ *
+ * schema.getQueryType().name; // => 'Query'
+ * ```
+ * @example
+ * ```ts
+ * // This variant uses validation options when the SDL references unknown types.
+ * import { parse } from 'graphql/language';
+ * import { buildASTSchema } from 'graphql/utilities';
+ *
+ * const document = parse('type Query { broken: MissingType }');
+ *
+ * buildASTSchema(document); // throws an error
+ * buildASTSchema(document, {
+ *   assumeValid: true,
+ *   assumeValidSDL: true,
+ * }); // does not throw
+ * ```
  */
 export declare function buildASTSchema(documentAST: DocumentNode, options?: BuildSchemaOptions): GraphQLSchema;
 /**
- * A helper function to build a GraphQLSchema directly from a source
- * document.
+ * Builds a GraphQLSchema directly from a schema definition language source.
+ * @param source - The GraphQL source text or source object.
+ * @param options - Optional configuration for this operation.
+ * @returns The schema built from the provided SDL document.
+ * @example
+ * ```ts
+ * // Build a schema from SDL source using the default options.
+ * import { buildSchema } from 'graphql/utilities';
+ *
+ * const schema = buildSchema('type Query { hello: String }');
+ *
+ * schema.getQueryType().name; // => 'Query'
+ * ```
+ * @example
+ * ```ts
+ * // This variant enables parser options and omits source locations.
+ * import { buildSchema } from 'graphql/utilities';
+ *
+ * const schema = buildSchema(
+ *   'directive @tag on FIELD_DEFINITION\n' +
+ *     'directive @compose @tag on FIELD_DEFINITION',
+ *   {
+ *     experimentalDirectivesOnDirectiveDefinitions: true,
+ *     experimentalFragmentArguments: true,
+ *     noLocation: true,
+ *   },
+ * );
+ *
+ * const directive = schema.getDirective('compose');
+ *
+ * directive.name; // => 'compose'
+ * directive.astNode.loc; // => undefined
+ * ```
  */
 export declare function buildSchema(source: string | Source, options?: BuildSchemaOptions & ParseOptions): GraphQLSchema;

package/utilities/buildASTSchema.js

@@ -2,24 +2,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildASTSchema = buildASTSchema;
 exports.buildSchema = buildSchema;
-const parser_js_1 = require("../language/parser.js");
-const directives_js_1 = require("../type/directives.js");
-const schema_js_1 = require("../type/schema.js");
-const validate_js_1 = require("../validation/validate.js");
-const extendSchema_js_1 = require("./extendSchema.js");
-/**
- * This takes the ast of a schema document produced by the parse function in
- * src/language/parser.js.
- *
- * If no schema definition is provided, then it will look for types named Query,
- * Mutation and Subscription.
- *
- * Given that AST it constructs a GraphQLSchema. The resulting schema
- * has no resolve methods, so execution will use default resolvers.
- */
+const parser_ts_1 = require("../language/parser.js");
+const directives_ts_1 = require("../type/directives.js");
+const schema_ts_1 = require("../type/schema.js");
+const validate_ts_1 = require("../validation/validate.js");
+const extendSchema_ts_1 = require("./extendSchema.js");
 function buildASTSchema(documentAST, options) {
     if (options?.assumeValid !== true && options?.assumeValidSDL !== true) {
-        (0, validate_js_1.assertValidSDL)(documentAST);
+        (0, validate_ts_1.assertValidSDL)(documentAST);
     }
     const emptySchemaConfig = {
         description: undefined,
@@ -29,23 +19,17 @@ function buildASTSchema(documentAST, options) {
         extensionASTNodes: [],
         assumeValid: false,
     };
-    const config = (0, extendSchema_js_1.extendSchemaImpl)(emptySchemaConfig, documentAST, options);
+    const config = (0, extendSchema_ts_1.extendSchemaImpl)(emptySchemaConfig, documentAST, options);
     if (config.astNode == null) {
         for (const type of config.types) {
             switch (type.name) {
-                // Note: While this could make early assertions to get the correctly
-                // typed values below, that would throw immediately while type system
-                // validation with validateSchema() will produce more actionable results.
                 case 'Query':
-                    // @ts-expect-error validated in `validateSchema`
                     config.query = type;
                     break;
                 case 'Mutation':
-                    // @ts-expect-error validated in `validateSchema`
                     config.mutation = type;
                     break;
                 case 'Subscription':
-                    // @ts-expect-error validated in `validateSchema`
                     config.subscription = type;
                     break;
             }
@@ -53,19 +37,15 @@ function buildASTSchema(documentAST, options) {
     }
     const directives = [
         ...config.directives,
-        // If specified directives were not explicitly declared, add them.
-        ...directives_js_1.specifiedDirectives.filter((stdDirective) => config.directives.every((directive) => directive.name !== stdDirective.name)),
+        ...directives_ts_1.specifiedDirectives.filter((stdDirective) => config.directives.every((directive) => directive.name !== stdDirective.name)),
     ];
-    return new schema_js_1.GraphQLSchema({ ...config, directives });
+    return new schema_ts_1.GraphQLSchema({ ...config, directives });
 }
-/**
- * A helper function to build a GraphQLSchema directly from a source
- * document.
- */
 function buildSchema(source, options) {
-    const document = (0, parser_js_1.parse)(source, {
+    const document = (0, parser_ts_1.parse)(source, {
         noLocation: options?.noLocation,
         experimentalFragmentArguments: options?.experimentalFragmentArguments,
+        experimentalDirectivesOnDirectiveDefinitions: options?.experimentalDirectivesOnDirectiveDefinitions,
     });
     return buildASTSchema(document, {
         assumeValidSDL: options?.assumeValidSDL,

package/utilities/buildASTSchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildASTSchema.js","sourceRoot":"","sources":["../../src/utilities/buildASTSchema.ts"],"names":[],"mappings":";;AAgCA,wCAmDC;AAMD,kCAaC;AApGD,qDAA8C;AAG9C,yDAA4D;AAE5D,iDAAkD;AAElD,2DAA2D;AAE3D,uDAAqD;AAWrD;;;;;;;;;GASG;AACH,SAAgB,cAAc,CAC5B,WAAyB,EACzB,OAA4B;IAE5B,IAAI,OAAO,EAAE,WAAW,KAAK,IAAI,IAAI,OAAO,EAAE,cAAc,KAAK,IAAI,EAAE,CAAC;QACtE,IAAA,4BAAc,EAAC,WAAW,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,iBAAiB,GAAG;QACxB,WAAW,EAAE,SAAS;QACtB,KAAK,EAAE,EAAE;QACT,UAAU,EAAE,EAAE;QACd,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;QAC/B,iBAAiB,EAAE,EAAE;QACrB,WAAW,EAAE,KAAK;KACnB,CAAC;IACF,MAAM,MAAM,GAAG,IAAA,kCAAgB,EAAC,iBAAiB,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAEzE,IAAI,MAAM,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;gBAClB,oEAAoE;gBACpE,qEAAqE;gBACrE,yEAAyE;gBACzE,KAAK,OAAO;oBACV,iDAAiD;oBACjD,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;oBACpB,MAAM;gBACR,KAAK,UAAU;oBACb,iDAAiD;oBACjD,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC;oBACvB,MAAM;gBACR,KAAK,cAAc;oBACjB,iDAAiD;oBACjD,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC;oBAC3B,MAAM;YACV,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG;QACjB,GAAG,MAAM,CAAC,UAAU;QACpB,kEAAkE;QAClE,GAAG,mCAAmB,CAAC,MAAM,CAAC,CAAC,YAAY,EAAE,EAAE,CAC7C,MAAM,CAAC,UAAU,CAAC,KAAK,CACrB,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,YAAY,CAAC,IAAI,CACpD,CACF;KACF,CAAC;IAEF,OAAO,IAAI,yBAAa,CAAC,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,SAAgB,WAAW,CACzB,MAAuB,EACvB,OAA2C;IAE3C,MAAM,QAAQ,GAAG,IAAA,iBAAK,EAAC,MAAM,EAAE;QAC7B,UAAU,EAAE,OAAO,EAAE,UAAU;QAC/B,6BAA6B,EAAE,OAAO,EAAE,6BAA6B;KACtE,CAAC,CAAC;IAEH,OAAO,cAAc,CAAC,QAAQ,EAAE;QAC9B,cAAc,EAAE,OAAO,EAAE,cAAc;QACvC,WAAW,EAAE,OAAO,EAAE,WAAW;KAClC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { DocumentNode } from '../language/ast.js';\nimport type { ParseOptions } from '../language/parser.js';\nimport { parse } from '../language/parser.js';\nimport type { Source } from '../language/source.js';\n\nimport { specifiedDirectives } from '../type/directives.js';\nimport type { GraphQLSchemaValidationOptions } from '../type/schema.js';\nimport { GraphQLSchema } from '../type/schema.js';\n\nimport { assertValidSDL } from '../validation/validate.js';\n\nimport { extendSchemaImpl } from './extendSchema.js';\n\nexport interface BuildSchemaOptions extends GraphQLSchemaValidationOptions {\n  /**\n   * Set to true to assume the SDL is valid.\n   *\n   * Default: false\n   */\n  assumeValidSDL?: boolean | undefined;\n}\n\n/**\n * This takes the ast of a schema document produced by the parse function in\n * src/language/parser.js.\n *\n * If no schema definition is provided, then it will look for types named Query,\n * Mutation and Subscription.\n *\n * Given that AST it constructs a GraphQLSchema. The resulting schema\n * has no resolve methods, so execution will use default resolvers.\n */\nexport function buildASTSchema(\n  documentAST: DocumentNode,\n  options?: BuildSchemaOptions,\n): GraphQLSchema {\n  if (options?.assumeValid !== true && options?.assumeValidSDL !== true) {\n    assertValidSDL(documentAST);\n  }\n\n  const emptySchemaConfig = {\n    description: undefined,\n    types: [],\n    directives: [],\n    extensions: Object.create(null),\n    extensionASTNodes: [],\n    assumeValid: false,\n  };\n  const config = extendSchemaImpl(emptySchemaConfig, documentAST, options);\n\n  if (config.astNode == null) {\n    for (const type of config.types) {\n      switch (type.name) {\n        // Note: While this could make early assertions to get the correctly\n        // typed values below, that would throw immediately while type system\n        // validation with validateSchema() will produce more actionable results.\n        case 'Query':\n          // @ts-expect-error validated in `validateSchema`\n          config.query = type;\n          break;\n        case 'Mutation':\n          // @ts-expect-error validated in `validateSchema`\n          config.mutation = type;\n          break;\n        case 'Subscription':\n          // @ts-expect-error validated in `validateSchema`\n          config.subscription = type;\n          break;\n      }\n    }\n  }\n\n  const directives = [\n    ...config.directives,\n    // If specified directives were not explicitly declared, add them.\n    ...specifiedDirectives.filter((stdDirective) =>\n      config.directives.every(\n        (directive) => directive.name !== stdDirective.name,\n      ),\n    ),\n  ];\n\n  return new GraphQLSchema({ ...config, directives });\n}\n\n/**\n * A helper function to build a GraphQLSchema directly from a source\n * document.\n */\nexport function buildSchema(\n  source: string | Source,\n  options?: BuildSchemaOptions & ParseOptions,\n): GraphQLSchema {\n  const document = parse(source, {\n    noLocation: options?.noLocation,\n    experimentalFragmentArguments: options?.experimentalFragmentArguments,\n  });\n\n  return buildASTSchema(document, {\n    assumeValidSDL: options?.assumeValidSDL,\n    assumeValid: options?.assumeValid,\n  });\n}\n"]}
+{"version":3,"file":"buildASTSchema.js","sourceRoot":"","sources":["../../src/utilities/buildASTSchema.ts"],"names":[],"mappings":";;AA8DA,wCAmDC;AAqCD,kCAeC;AAjKD,qDAA8C;AAG9C,yDAA4D;AAE5D,iDAAkD;AAElD,2DAA2D;AAE3D,uDAAqD;AAiDrD,SAAgB,cAAc,CAC5B,WAAyB,EACzB,OAA4B;IAE5B,IAAI,OAAO,EAAE,WAAW,KAAK,IAAI,IAAI,OAAO,EAAE,cAAc,KAAK,IAAI,EAAE,CAAC;QACtE,IAAA,4BAAc,EAAC,WAAW,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,iBAAiB,GAAG;QACxB,WAAW,EAAE,SAAS;QACtB,KAAK,EAAE,EAAE;QACT,UAAU,EAAE,EAAE;QACd,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;QAC/B,iBAAiB,EAAE,EAAE;QACrB,WAAW,EAAE,KAAK;KACnB,CAAC;IACF,MAAM,MAAM,GAAG,IAAA,kCAAgB,EAAC,iBAAiB,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAEzE,IAAI,MAAM,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;gBAIlB,KAAK,OAAO;oBAEV,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;oBACpB,MAAM;gBACR,KAAK,UAAU;oBAEb,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC;oBACvB,MAAM;gBACR,KAAK,cAAc;oBAEjB,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC;oBAC3B,MAAM;YACV,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG;QACjB,GAAG,MAAM,CAAC,UAAU;QAEpB,GAAG,mCAAmB,CAAC,MAAM,CAAC,CAAC,YAAY,EAAE,EAAE,CAC7C,MAAM,CAAC,UAAU,CAAC,KAAK,CACrB,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,YAAY,CAAC,IAAI,CACpD,CACF;KACF,CAAC;IAEF,OAAO,IAAI,yBAAa,CAAC,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;AACtD,CAAC;AAqCD,SAAgB,WAAW,CACzB,MAAuB,EACvB,OAA2C;IAE3C,MAAM,QAAQ,GAAG,IAAA,iBAAK,EAAC,MAAM,EAAE;QAC7B,UAAU,EAAE,OAAO,EAAE,UAAU;QAC/B,6BAA6B,EAAE,OAAO,EAAE,6BAA6B;QACrE,4CAA4C,EAC1C,OAAO,EAAE,4CAA4C;KACxD,CAAC,CAAC;IAEH,OAAO,cAAc,CAAC,QAAQ,EAAE;QAC9B,cAAc,EAAE,OAAO,EAAE,cAAc;QACvC,WAAW,EAAE,OAAO,EAAE,WAAW;KAClC,CAAC,CAAC;AACL,CAAC","sourcesContent":["/** @category Schema Construction */\n\nimport type { DocumentNode } from '../language/ast.ts';\nimport type { ParseOptions } from '../language/parser.ts';\nimport { parse } from '../language/parser.ts';\nimport type { Source } from '../language/source.ts';\n\nimport { specifiedDirectives } from '../type/directives.ts';\nimport type { GraphQLSchemaValidationOptions } from '../type/schema.ts';\nimport { GraphQLSchema } from '../type/schema.ts';\n\nimport { assertValidSDL } from '../validation/validate.ts';\n\nimport { extendSchemaImpl } from './extendSchema.ts';\n\n/** Options used when building a schema from SDL or a parsed SDL document. */\nexport interface BuildSchemaOptions extends GraphQLSchemaValidationOptions {\n  /**\n   * Set to true to assume the SDL is valid.\n   *\n   * Default: false\n   */\n  assumeValidSDL?: boolean | undefined;\n}\n\n/**\n * Builds a GraphQLSchema from a parsed schema definition language document.\n *\n * If no schema definition is provided, then it will look for types named Query,\n * Mutation and Subscription.\n *\n * The resulting schema has no resolver functions, so execution will use the\n * default field resolver.\n * @param documentAST - The parsed GraphQL document AST.\n * @param options - Optional configuration for this operation.\n * @returns The schema built from the provided SDL document.\n * @example\n * ```ts\n * // Build a schema from a valid parsed SDL document.\n * import { parse } from 'graphql/language';\n * import { buildASTSchema } from 'graphql/utilities';\n *\n * const document = parse('type Query { hello: String }');\n * const schema = buildASTSchema(document);\n *\n * schema.getQueryType().name; // => 'Query'\n * ```\n * @example\n * ```ts\n * // This variant uses validation options when the SDL references unknown types.\n * import { parse } from 'graphql/language';\n * import { buildASTSchema } from 'graphql/utilities';\n *\n * const document = parse('type Query { broken: MissingType }');\n *\n * buildASTSchema(document); // throws an error\n * buildASTSchema(document, {\n *   assumeValid: true,\n *   assumeValidSDL: true,\n * }); // does not throw\n * ```\n */\nexport function buildASTSchema(\n  documentAST: DocumentNode,\n  options?: BuildSchemaOptions,\n): GraphQLSchema {\n  if (options?.assumeValid !== true && options?.assumeValidSDL !== true) {\n    assertValidSDL(documentAST);\n  }\n\n  const emptySchemaConfig = {\n    description: undefined,\n    types: [],\n    directives: [],\n    extensions: Object.create(null),\n    extensionASTNodes: [],\n    assumeValid: false,\n  };\n  const config = extendSchemaImpl(emptySchemaConfig, documentAST, options);\n\n  if (config.astNode == null) {\n    for (const type of config.types) {\n      switch (type.name) {\n        // Note: While this could make early assertions to get the correctly\n        // typed values below, that would throw immediately while type system\n        // validation with validateSchema() will produce more actionable results.\n        case 'Query':\n          // @ts-expect-error validated in `validateSchema`\n          config.query = type;\n          break;\n        case 'Mutation':\n          // @ts-expect-error validated in `validateSchema`\n          config.mutation = type;\n          break;\n        case 'Subscription':\n          // @ts-expect-error validated in `validateSchema`\n          config.subscription = type;\n          break;\n      }\n    }\n  }\n\n  const directives = [\n    ...config.directives,\n    // If specified directives were not explicitly declared, add them.\n    ...specifiedDirectives.filter((stdDirective) =>\n      config.directives.every(\n        (directive) => directive.name !== stdDirective.name,\n      ),\n    ),\n  ];\n\n  return new GraphQLSchema({ ...config, directives });\n}\n\n/**\n * Builds a GraphQLSchema directly from a schema definition language source.\n * @param source - The GraphQL source text or source object.\n * @param options - Optional configuration for this operation.\n * @returns The schema built from the provided SDL document.\n * @example\n * ```ts\n * // Build a schema from SDL source using the default options.\n * import { buildSchema } from 'graphql/utilities';\n *\n * const schema = buildSchema('type Query { hello: String }');\n *\n * schema.getQueryType().name; // => 'Query'\n * ```\n * @example\n * ```ts\n * // This variant enables parser options and omits source locations.\n * import { buildSchema } from 'graphql/utilities';\n *\n * const schema = buildSchema(\n *   'directive @tag on FIELD_DEFINITION\\n' +\n *     'directive @compose @tag on FIELD_DEFINITION',\n *   {\n *     experimentalDirectivesOnDirectiveDefinitions: true,\n *     experimentalFragmentArguments: true,\n *     noLocation: true,\n *   },\n * );\n *\n * const directive = schema.getDirective('compose');\n *\n * directive.name; // => 'compose'\n * directive.astNode.loc; // => undefined\n * ```\n */\nexport function buildSchema(\n  source: string | Source,\n  options?: BuildSchemaOptions & ParseOptions,\n): GraphQLSchema {\n  const document = parse(source, {\n    noLocation: options?.noLocation,\n    experimentalFragmentArguments: options?.experimentalFragmentArguments,\n    experimentalDirectivesOnDirectiveDefinitions:\n      options?.experimentalDirectivesOnDirectiveDefinitions,\n  });\n\n  return buildASTSchema(document, {\n    assumeValidSDL: options?.assumeValidSDL,\n    assumeValid: options?.assumeValid,\n  });\n}\n"]}

package/utilities/buildASTSchema.mjs

@@ -3,16 +3,6 @@ import { specifiedDirectives } from "../type/directives.mjs";
 import { GraphQLSchema } from "../type/schema.mjs";
 import { assertValidSDL } from "../validation/validate.mjs";
 import { extendSchemaImpl } from "./extendSchema.mjs";
-/**
- * This takes the ast of a schema document produced by the parse function in
- * src/language/parser.js.
- *
- * If no schema definition is provided, then it will look for types named Query,
- * Mutation and Subscription.
- *
- * Given that AST it constructs a GraphQLSchema. The resulting schema
- * has no resolve methods, so execution will use default resolvers.
- */
 export function buildASTSchema(documentAST, options) {
     if (options?.assumeValid !== true && options?.assumeValidSDL !== true) {
         assertValidSDL(documentAST);
@@ -29,19 +19,13 @@ export function buildASTSchema(documentAST, options) {
     if (config.astNode == null) {
         for (const type of config.types) {
             switch (type.name) {
-                // Note: While this could make early assertions to get the correctly
-                // typed values below, that would throw immediately while type system
-                // validation with validateSchema() will produce more actionable results.
                 case 'Query':
-                    // @ts-expect-error validated in `validateSchema`
                     config.query = type;
                     break;
                 case 'Mutation':
-                    // @ts-expect-error validated in `validateSchema`
                     config.mutation = type;
                     break;
                 case 'Subscription':
-                    // @ts-expect-error validated in `validateSchema`
                     config.subscription = type;
                     break;
             }
@@ -49,19 +33,15 @@ export function buildASTSchema(documentAST, options) {
     }
     const directives = [
         ...config.directives,
-        // If specified directives were not explicitly declared, add them.
         ...specifiedDirectives.filter((stdDirective) => config.directives.every((directive) => directive.name !== stdDirective.name)),
     ];
     return new GraphQLSchema({ ...config, directives });
 }
-/**
- * A helper function to build a GraphQLSchema directly from a source
- * document.
- */
 export function buildSchema(source, options) {
     const document = parse(source, {
         noLocation: options?.noLocation,
         experimentalFragmentArguments: options?.experimentalFragmentArguments,
+        experimentalDirectivesOnDirectiveDefinitions: options?.experimentalDirectivesOnDirectiveDefinitions,
     });
     return buildASTSchema(document, {
         assumeValidSDL: options?.assumeValidSDL,

package/utilities/buildASTSchema.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"buildASTSchema.js","sourceRoot":"","sources":["../../src/utilities/buildASTSchema.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,+BAA8B;AAG9C,OAAO,EAAE,mBAAmB,EAAE,+BAA8B;AAE5D,OAAO,EAAE,aAAa,EAAE,2BAA0B;AAElD,OAAO,EAAE,cAAc,EAAE,mCAAkC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,2BAA0B;AAWrD;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAC5B,WAAyB,EACzB,OAA4B;IAE5B,IAAI,OAAO,EAAE,WAAW,KAAK,IAAI,IAAI,OAAO,EAAE,cAAc,KAAK,IAAI,EAAE,CAAC;QACtE,cAAc,CAAC,WAAW,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,iBAAiB,GAAG;QACxB,WAAW,EAAE,SAAS;QACtB,KAAK,EAAE,EAAE;QACT,UAAU,EAAE,EAAE;QACd,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;QAC/B,iBAAiB,EAAE,EAAE;QACrB,WAAW,EAAE,KAAK;KACnB,CAAC;IACF,MAAM,MAAM,GAAG,gBAAgB,CAAC,iBAAiB,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAEzE,IAAI,MAAM,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;gBAClB,oEAAoE;gBACpE,qEAAqE;gBACrE,yEAAyE;gBACzE,KAAK,OAAO;oBACV,iDAAiD;oBACjD,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;oBACpB,MAAM;gBACR,KAAK,UAAU;oBACb,iDAAiD;oBACjD,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC;oBACvB,MAAM;gBACR,KAAK,cAAc;oBACjB,iDAAiD;oBACjD,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC;oBAC3B,MAAM;YACV,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG;QACjB,GAAG,MAAM,CAAC,UAAU;QACpB,kEAAkE;QAClE,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC,YAAY,EAAE,EAAE,CAC7C,MAAM,CAAC,UAAU,CAAC,KAAK,CACrB,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,YAAY,CAAC,IAAI,CACpD,CACF;KACF,CAAC;IAEF,OAAO,IAAI,aAAa,CAAC,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,MAAuB,EACvB,OAA2C;IAE3C,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,EAAE;QAC7B,UAAU,EAAE,OAAO,EAAE,UAAU;QAC/B,6BAA6B,EAAE,OAAO,EAAE,6BAA6B;KACtE,CAAC,CAAC;IAEH,OAAO,cAAc,CAAC,QAAQ,EAAE;QAC9B,cAAc,EAAE,OAAO,EAAE,cAAc;QACvC,WAAW,EAAE,OAAO,EAAE,WAAW;KAClC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { DocumentNode } from '../language/ast.js';\nimport type { ParseOptions } from '../language/parser.js';\nimport { parse } from '../language/parser.js';\nimport type { Source } from '../language/source.js';\n\nimport { specifiedDirectives } from '../type/directives.js';\nimport type { GraphQLSchemaValidationOptions } from '../type/schema.js';\nimport { GraphQLSchema } from '../type/schema.js';\n\nimport { assertValidSDL } from '../validation/validate.js';\n\nimport { extendSchemaImpl } from './extendSchema.js';\n\nexport interface BuildSchemaOptions extends GraphQLSchemaValidationOptions {\n  /**\n   * Set to true to assume the SDL is valid.\n   *\n   * Default: false\n   */\n  assumeValidSDL?: boolean | undefined;\n}\n\n/**\n * This takes the ast of a schema document produced by the parse function in\n * src/language/parser.js.\n *\n * If no schema definition is provided, then it will look for types named Query,\n * Mutation and Subscription.\n *\n * Given that AST it constructs a GraphQLSchema. The resulting schema\n * has no resolve methods, so execution will use default resolvers.\n */\nexport function buildASTSchema(\n  documentAST: DocumentNode,\n  options?: BuildSchemaOptions,\n): GraphQLSchema {\n  if (options?.assumeValid !== true && options?.assumeValidSDL !== true) {\n    assertValidSDL(documentAST);\n  }\n\n  const emptySchemaConfig = {\n    description: undefined,\n    types: [],\n    directives: [],\n    extensions: Object.create(null),\n    extensionASTNodes: [],\n    assumeValid: false,\n  };\n  const config = extendSchemaImpl(emptySchemaConfig, documentAST, options);\n\n  if (config.astNode == null) {\n    for (const type of config.types) {\n      switch (type.name) {\n        // Note: While this could make early assertions to get the correctly\n        // typed values below, that would throw immediately while type system\n        // validation with validateSchema() will produce more actionable results.\n        case 'Query':\n          // @ts-expect-error validated in `validateSchema`\n          config.query = type;\n          break;\n        case 'Mutation':\n          // @ts-expect-error validated in `validateSchema`\n          config.mutation = type;\n          break;\n        case 'Subscription':\n          // @ts-expect-error validated in `validateSchema`\n          config.subscription = type;\n          break;\n      }\n    }\n  }\n\n  const directives = [\n    ...config.directives,\n    // If specified directives were not explicitly declared, add them.\n    ...specifiedDirectives.filter((stdDirective) =>\n      config.directives.every(\n        (directive) => directive.name !== stdDirective.name,\n      ),\n    ),\n  ];\n\n  return new GraphQLSchema({ ...config, directives });\n}\n\n/**\n * A helper function to build a GraphQLSchema directly from a source\n * document.\n */\nexport function buildSchema(\n  source: string | Source,\n  options?: BuildSchemaOptions & ParseOptions,\n): GraphQLSchema {\n  const document = parse(source, {\n    noLocation: options?.noLocation,\n    experimentalFragmentArguments: options?.experimentalFragmentArguments,\n  });\n\n  return buildASTSchema(document, {\n    assumeValidSDL: options?.assumeValidSDL,\n    assumeValid: options?.assumeValid,\n  });\n}\n"]}
+{"version":3,"file":"buildASTSchema.js","sourceRoot":"","sources":["../../src/utilities/buildASTSchema.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,EAAE,+BAA8B;AAG9C,OAAO,EAAE,mBAAmB,EAAE,+BAA8B;AAE5D,OAAO,EAAE,aAAa,EAAE,2BAA0B;AAElD,OAAO,EAAE,cAAc,EAAE,mCAAkC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,2BAA0B;AAiDrD,MAAM,UAAU,cAAc,CAC5B,WAAyB,EACzB,OAA4B;IAE5B,IAAI,OAAO,EAAE,WAAW,KAAK,IAAI,IAAI,OAAO,EAAE,cAAc,KAAK,IAAI,EAAE,CAAC;QACtE,cAAc,CAAC,WAAW,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,iBAAiB,GAAG;QACxB,WAAW,EAAE,SAAS;QACtB,KAAK,EAAE,EAAE;QACT,UAAU,EAAE,EAAE;QACd,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;QAC/B,iBAAiB,EAAE,EAAE;QACrB,WAAW,EAAE,KAAK;KACnB,CAAC;IACF,MAAM,MAAM,GAAG,gBAAgB,CAAC,iBAAiB,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAEzE,IAAI,MAAM,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;gBAIlB,KAAK,OAAO;oBAEV,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;oBACpB,MAAM;gBACR,KAAK,UAAU;oBAEb,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC;oBACvB,MAAM;gBACR,KAAK,cAAc;oBAEjB,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC;oBAC3B,MAAM;YACV,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG;QACjB,GAAG,MAAM,CAAC,UAAU;QAEpB,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC,YAAY,EAAE,EAAE,CAC7C,MAAM,CAAC,UAAU,CAAC,KAAK,CACrB,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,YAAY,CAAC,IAAI,CACpD,CACF;KACF,CAAC;IAEF,OAAO,IAAI,aAAa,CAAC,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;AACtD,CAAC;AAqCD,MAAM,UAAU,WAAW,CACzB,MAAuB,EACvB,OAA2C;IAE3C,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,EAAE;QAC7B,UAAU,EAAE,OAAO,EAAE,UAAU;QAC/B,6BAA6B,EAAE,OAAO,EAAE,6BAA6B;QACrE,4CAA4C,EAC1C,OAAO,EAAE,4CAA4C;KACxD,CAAC,CAAC;IAEH,OAAO,cAAc,CAAC,QAAQ,EAAE;QAC9B,cAAc,EAAE,OAAO,EAAE,cAAc;QACvC,WAAW,EAAE,OAAO,EAAE,WAAW;KAClC,CAAC,CAAC;AACL,CAAC","sourcesContent":["/** @category Schema Construction */\n\nimport type { DocumentNode } from '../language/ast.ts';\nimport type { ParseOptions } from '../language/parser.ts';\nimport { parse } from '../language/parser.ts';\nimport type { Source } from '../language/source.ts';\n\nimport { specifiedDirectives } from '../type/directives.ts';\nimport type { GraphQLSchemaValidationOptions } from '../type/schema.ts';\nimport { GraphQLSchema } from '../type/schema.ts';\n\nimport { assertValidSDL } from '../validation/validate.ts';\n\nimport { extendSchemaImpl } from './extendSchema.ts';\n\n/** Options used when building a schema from SDL or a parsed SDL document. */\nexport interface BuildSchemaOptions extends GraphQLSchemaValidationOptions {\n  /**\n   * Set to true to assume the SDL is valid.\n   *\n   * Default: false\n   */\n  assumeValidSDL?: boolean | undefined;\n}\n\n/**\n * Builds a GraphQLSchema from a parsed schema definition language document.\n *\n * If no schema definition is provided, then it will look for types named Query,\n * Mutation and Subscription.\n *\n * The resulting schema has no resolver functions, so execution will use the\n * default field resolver.\n * @param documentAST - The parsed GraphQL document AST.\n * @param options - Optional configuration for this operation.\n * @returns The schema built from the provided SDL document.\n * @example\n * ```ts\n * // Build a schema from a valid parsed SDL document.\n * import { parse } from 'graphql/language';\n * import { buildASTSchema } from 'graphql/utilities';\n *\n * const document = parse('type Query { hello: String }');\n * const schema = buildASTSchema(document);\n *\n * schema.getQueryType().name; // => 'Query'\n * ```\n * @example\n * ```ts\n * // This variant uses validation options when the SDL references unknown types.\n * import { parse } from 'graphql/language';\n * import { buildASTSchema } from 'graphql/utilities';\n *\n * const document = parse('type Query { broken: MissingType }');\n *\n * buildASTSchema(document); // throws an error\n * buildASTSchema(document, {\n *   assumeValid: true,\n *   assumeValidSDL: true,\n * }); // does not throw\n * ```\n */\nexport function buildASTSchema(\n  documentAST: DocumentNode,\n  options?: BuildSchemaOptions,\n): GraphQLSchema {\n  if (options?.assumeValid !== true && options?.assumeValidSDL !== true) {\n    assertValidSDL(documentAST);\n  }\n\n  const emptySchemaConfig = {\n    description: undefined,\n    types: [],\n    directives: [],\n    extensions: Object.create(null),\n    extensionASTNodes: [],\n    assumeValid: false,\n  };\n  const config = extendSchemaImpl(emptySchemaConfig, documentAST, options);\n\n  if (config.astNode == null) {\n    for (const type of config.types) {\n      switch (type.name) {\n        // Note: While this could make early assertions to get the correctly\n        // typed values below, that would throw immediately while type system\n        // validation with validateSchema() will produce more actionable results.\n        case 'Query':\n          // @ts-expect-error validated in `validateSchema`\n          config.query = type;\n          break;\n        case 'Mutation':\n          // @ts-expect-error validated in `validateSchema`\n          config.mutation = type;\n          break;\n        case 'Subscription':\n          // @ts-expect-error validated in `validateSchema`\n          config.subscription = type;\n          break;\n      }\n    }\n  }\n\n  const directives = [\n    ...config.directives,\n    // If specified directives were not explicitly declared, add them.\n    ...specifiedDirectives.filter((stdDirective) =>\n      config.directives.every(\n        (directive) => directive.name !== stdDirective.name,\n      ),\n    ),\n  ];\n\n  return new GraphQLSchema({ ...config, directives });\n}\n\n/**\n * Builds a GraphQLSchema directly from a schema definition language source.\n * @param source - The GraphQL source text or source object.\n * @param options - Optional configuration for this operation.\n * @returns The schema built from the provided SDL document.\n * @example\n * ```ts\n * // Build a schema from SDL source using the default options.\n * import { buildSchema } from 'graphql/utilities';\n *\n * const schema = buildSchema('type Query { hello: String }');\n *\n * schema.getQueryType().name; // => 'Query'\n * ```\n * @example\n * ```ts\n * // This variant enables parser options and omits source locations.\n * import { buildSchema } from 'graphql/utilities';\n *\n * const schema = buildSchema(\n *   'directive @tag on FIELD_DEFINITION\\n' +\n *     'directive @compose @tag on FIELD_DEFINITION',\n *   {\n *     experimentalDirectivesOnDirectiveDefinitions: true,\n *     experimentalFragmentArguments: true,\n *     noLocation: true,\n *   },\n * );\n *\n * const directive = schema.getDirective('compose');\n *\n * directive.name; // => 'compose'\n * directive.astNode.loc; // => undefined\n * ```\n */\nexport function buildSchema(\n  source: string | Source,\n  options?: BuildSchemaOptions & ParseOptions,\n): GraphQLSchema {\n  const document = parse(source, {\n    noLocation: options?.noLocation,\n    experimentalFragmentArguments: options?.experimentalFragmentArguments,\n    experimentalDirectivesOnDirectiveDefinitions:\n      options?.experimentalDirectivesOnDirectiveDefinitions,\n  });\n\n  return buildASTSchema(document, {\n    assumeValidSDL: options?.assumeValidSDL,\n    assumeValid: options?.assumeValid,\n  });\n}\n"]}

package/utilities/buildClientSchema.d.mts

@@ -1,16 +1,31 @@
-import type { GraphQLSchemaValidationOptions } from '../type/schema.js';
-import { GraphQLSchema } from '../type/schema.js';
-import type { IntrospectionQuery } from './getIntrospectionQuery.js';
+/** @category Introspection */
+import type { GraphQLSchemaValidationOptions } from "../type/schema.mjs";
+import { GraphQLSchema } from "../type/schema.mjs";
+import type { IntrospectionQuery } from "./getIntrospectionQuery.mjs";
 /**
  * Build a GraphQLSchema for use by client tools.
  *
  * Given the result of a client running the introspection query, creates and
  * returns a GraphQLSchema instance which can be then used with all graphql-js
  * tools, but cannot be used to execute a query, as introspection does not
- * represent the "resolver", "coerceInputValue" or "coerceOutputValue"
- * functions or any other server-internal mechanisms.
+ * represent the "resolver", "parse" or "serialize" functions or any other
+ * server-internal mechanisms.
  *
  * This function expects a complete introspection result. Don't forget to check
  * the "errors" field of a server response before calling this function.
+ * @param introspection - Introspection result data to build from.
+ * @param options - Optional configuration for this operation.
+ * @returns The client schema represented by the introspection result.
+ * @example
+ * ```ts
+ * import { buildClientSchema, introspectionFromSchema, buildSchema } from 'graphql/utilities';
+ *
+ * const schema = buildSchema('type Query { hello: String }');
+ * const clientSchema = buildClientSchema(introspectionFromSchema(schema), {
+ *   assumeValid: true,
+ * });
+ *
+ * clientSchema.getQueryType().name; // => 'Query'
+ * ```
  */
 export declare function buildClientSchema(introspection: IntrospectionQuery, options?: GraphQLSchemaValidationOptions): GraphQLSchema;

package/utilities/buildClientSchema.d.ts

@@ -1,16 +1,31 @@
-import type { GraphQLSchemaValidationOptions } from '../type/schema.js';
-import { GraphQLSchema } from '../type/schema.js';
-import type { IntrospectionQuery } from './getIntrospectionQuery.js';
+/** @category Introspection */
+import type { GraphQLSchemaValidationOptions } from "../type/schema.js";
+import { GraphQLSchema } from "../type/schema.js";
+import type { IntrospectionQuery } from "./getIntrospectionQuery.js";
 /**
  * Build a GraphQLSchema for use by client tools.
  *
  * Given the result of a client running the introspection query, creates and
  * returns a GraphQLSchema instance which can be then used with all graphql-js
  * tools, but cannot be used to execute a query, as introspection does not
- * represent the "resolver", "coerceInputValue" or "coerceOutputValue"
- * functions or any other server-internal mechanisms.
+ * represent the "resolver", "parse" or "serialize" functions or any other
+ * server-internal mechanisms.
  *
  * This function expects a complete introspection result. Don't forget to check
  * the "errors" field of a server response before calling this function.
+ * @param introspection - Introspection result data to build from.
+ * @param options - Optional configuration for this operation.
+ * @returns The client schema represented by the introspection result.
+ * @example
+ * ```ts
+ * import { buildClientSchema, introspectionFromSchema, buildSchema } from 'graphql/utilities';
+ *
+ * const schema = buildSchema('type Query { hello: String }');
+ * const clientSchema = buildClientSchema(introspectionFromSchema(schema), {
+ *   assumeValid: true,
+ * });
+ *
+ * clientSchema.getQueryType().name; // => 'Query'
+ * ```
  */
 export declare function buildClientSchema(introspection: IntrospectionQuery, options?: GraphQLSchemaValidationOptions): GraphQLSchema;