1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
|
// @flow strict
import devAssert from '../jsutils/devAssert';
import type { Source } from '../language/source';
import type { DocumentNode } from '../language/ast';
import type { ParseOptions } from '../language/parser';
import { Kind } from '../language/kinds';
import { parse } from '../language/parser';
import { assertValidSDL } from '../validation/validate';
import type { GraphQLSchemaValidationOptions } from '../type/schema';
import { GraphQLSchema } from '../type/schema';
import { specifiedDirectives } from '../type/directives';
import { extendSchemaImpl } from './extendSchema';
export type BuildSchemaOptions = {|
...GraphQLSchemaValidationOptions,
/**
* Descriptions are defined as preceding string literals, however an older
* experimental version of the SDL supported preceding comments as
* descriptions. Set to true to enable this deprecated behavior.
* This option is provided to ease adoption and will be removed in v16.
*
* Default: false
*/
commentDescriptions?: boolean,
/**
* Set to true to assume the SDL is valid.
*
* Default: false
*/
assumeValidSDL?: boolean,
|};
/**
* 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
* and Mutation.
*
* Given that AST it constructs a GraphQLSchema. The resulting schema
* has no resolve methods, so execution will use default resolvers.
*
* Accepts options as a second argument:
*
* - commentDescriptions:
* Provide true to use preceding comments as the description.
*
*/
export function buildASTSchema(
documentAST: DocumentNode,
options?: BuildSchemaOptions,
): GraphQLSchema {
devAssert(
documentAST != null && documentAST.kind === Kind.DOCUMENT,
'Must provide valid Document AST.',
);
if (options?.assumeValid !== true && options?.assumeValidSDL !== true) {
assertValidSDL(documentAST);
}
const emptySchemaConfig = {
description: undefined,
types: [],
directives: [],
extensions: undefined,
extensionASTNodes: [],
assumeValid: false,
};
const config = 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':
config.query = (type: any);
break;
case 'Mutation':
config.mutation = (type: any);
break;
case 'Subscription':
config.subscription = (type: any);
break;
}
}
}
const { directives } = config;
// If specified directives were not explicitly declared, add them.
for (const stdDirective of specifiedDirectives) {
if (directives.every((directive) => directive.name !== stdDirective.name)) {
directives.push(stdDirective);
}
}
return new GraphQLSchema(config);
}
/**
* A helper function to build a GraphQLSchema directly from a source
* document.
*/
export function buildSchema(
source: string | Source,
options?: {| ...BuildSchemaOptions, ...ParseOptions |},
): GraphQLSchema {
const document = parse(source, {
noLocation: options?.noLocation,
allowLegacySDLEmptyFields: options?.allowLegacySDLEmptyFields,
allowLegacySDLImplementsInterfaces:
options?.allowLegacySDLImplementsInterfaces,
experimentalFragmentVariables: options?.experimentalFragmentVariables,
});
return buildASTSchema(document, {
commentDescriptions: options?.commentDescriptions,
assumeValidSDL: options?.assumeValidSDL,
assumeValid: options?.assumeValid,
});
}
|
