From 3d1cd02f27518f1a04374c7c8320cd5d82ede6e9 Mon Sep 17 00:00:00 2001 From: Minteck Date: Thu, 23 Feb 2023 19:34:56 +0100 Subject: Updated 40 files, added 37 files, deleted 1103 files and renamed 3905 files (automated) --- .../graphql/validation/validate.js.flow | 128 +++++++++++++++++++++ 1 file changed, 128 insertions(+) create mode 100644 includes/external/school/node_modules/graphql/validation/validate.js.flow (limited to 'includes/external/school/node_modules/graphql/validation/validate.js.flow') diff --git a/includes/external/school/node_modules/graphql/validation/validate.js.flow b/includes/external/school/node_modules/graphql/validation/validate.js.flow new file mode 100644 index 0000000..26dc0a5 --- /dev/null +++ b/includes/external/school/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 = specifiedRules, + typeInfo: TypeInfo = new TypeInfo(schema), + options: {| maxErrors?: number |} = { maxErrors: undefined }, +): $ReadOnlyArray { + 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 = specifiedSDLRules, +): $ReadOnlyArray { + 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')); + } +} -- cgit