summaryrefslogtreecommitdiff
path: root/alarm/node_modules/graphql/validation/validate.js.flow
diff options
context:
space:
mode:
Diffstat (limited to 'alarm/node_modules/graphql/validation/validate.js.flow')
-rw-r--r--alarm/node_modules/graphql/validation/validate.js.flow128
1 files changed, 128 insertions, 0 deletions
diff --git a/alarm/node_modules/graphql/validation/validate.js.flow b/alarm/node_modules/graphql/validation/validate.js.flow
new file mode 100644
index 0000000..26dc0a5
--- /dev/null
+++ b/alarm/node_modules/graphql/validation/validate.js.flow
@@ -0,0 +1,128 @@
+// @flow strict
+import devAssert from '../jsutils/devAssert';
+
+import { GraphQLError } from '../error/GraphQLError';
+
+import type { DocumentNode } from '../language/ast';
+import { visit, visitInParallel } from '../language/visitor';
+
+import type { GraphQLSchema } from '../type/schema';
+import { assertValidSchema } from '../type/validate';
+
+import { TypeInfo, visitWithTypeInfo } from '../utilities/TypeInfo';
+
+import type { SDLValidationRule, ValidationRule } from './ValidationContext';
+import { specifiedRules, specifiedSDLRules } from './specifiedRules';
+import { SDLValidationContext, ValidationContext } from './ValidationContext';
+
+/**
+ * Implements the "Validation" section of the spec.
+ *
+ * Validation runs synchronously, returning an array of encountered errors, or
+ * an empty array if no errors were encountered and the document is valid.
+ *
+ * A list of specific validation rules may be provided. If not provided, the
+ * default list of rules defined by the GraphQL specification will be used.
+ *
+ * Each validation rules is a function which returns a visitor
+ * (see the language/visitor API). Visitor methods are expected to return
+ * GraphQLErrors, or Arrays of GraphQLErrors when invalid.
+ *
+ * Optionally a custom TypeInfo instance may be provided. If not provided, one
+ * will be created from the provided schema.
+ */
+export function validate(
+ schema: GraphQLSchema,
+ documentAST: DocumentNode,
+ rules: $ReadOnlyArray<ValidationRule> = specifiedRules,
+ typeInfo: TypeInfo = new TypeInfo(schema),
+ options: {| maxErrors?: number |} = { maxErrors: undefined },
+): $ReadOnlyArray<GraphQLError> {
+ devAssert(documentAST, 'Must provide document.');
+ // If the schema used for validation is invalid, throw an error.
+ assertValidSchema(schema);
+
+ const abortObj = Object.freeze({});
+ const errors = [];
+ const context = new ValidationContext(
+ schema,
+ documentAST,
+ typeInfo,
+ (error) => {
+ if (options.maxErrors != null && errors.length >= options.maxErrors) {
+ errors.push(
+ new GraphQLError(
+ 'Too many validation errors, error limit reached. Validation aborted.',
+ ),
+ );
+ throw abortObj;
+ }
+ errors.push(error);
+ },
+ );
+
+ // This uses a specialized visitor which runs multiple visitors in parallel,
+ // while maintaining the visitor skip and break API.
+ const visitor = visitInParallel(rules.map((rule) => rule(context)));
+
+ // Visit the whole document with each instance of all provided rules.
+ try {
+ visit(documentAST, visitWithTypeInfo(typeInfo, visitor));
+ } catch (e) {
+ if (e !== abortObj) {
+ throw e;
+ }
+ }
+ return errors;
+}
+
+/**
+ * @internal
+ */
+export function validateSDL(
+ documentAST: DocumentNode,
+ schemaToExtend?: ?GraphQLSchema,
+ rules: $ReadOnlyArray<SDLValidationRule> = specifiedSDLRules,
+): $ReadOnlyArray<GraphQLError> {
+ const errors = [];
+ const context = new SDLValidationContext(
+ documentAST,
+ schemaToExtend,
+ (error) => {
+ errors.push(error);
+ },
+ );
+
+ const visitors = rules.map((rule) => rule(context));
+ visit(documentAST, visitInParallel(visitors));
+ return errors;
+}
+
+/**
+ * Utility function which asserts a SDL document is valid by throwing an error
+ * if it is invalid.
+ *
+ * @internal
+ */
+export function assertValidSDL(documentAST: DocumentNode): void {
+ const errors = validateSDL(documentAST);
+ if (errors.length !== 0) {
+ throw new Error(errors.map((error) => error.message).join('\n\n'));
+ }
+}
+
+/**
+ * Utility function which asserts a SDL document is valid by throwing an error
+ * if it is invalid.
+ *
+ * @internal
+ */
+export function assertValidSDLExtension(
+ documentAST: DocumentNode,
+ schema: GraphQLSchema,
+): void {
+ const errors = validateSDL(documentAST, schema);
+ if (errors.length !== 0) {
+ throw new Error(errors.map((error) => error.message).join('\n\n'));
+ }
+}