feat: introduce validateWithRules for complete document (sdl and/or executable) and/or existing schema validation

benchmark/validateWithRulesExecutable-benchmark.js

@@ -0,0 +1,20 @@
+import { parse } from 'graphql/language/parser.js';
+import { buildSchema } from 'graphql/utilities/buildASTSchema.js';
+import { getIntrospectionQuery } from 'graphql/utilities/getIntrospectionQuery.js';
+import * as GraphQLValidation from 'graphql/validation/index.js';
+import { validate } from 'graphql/validation/validate.js';
+
+import { bigSchemaSDL } from './fixtures.js';
+
+const validateWithRules = GraphQLValidation.validateWithRules;
+const schema = buildSchema(bigSchemaSDL, { assumeValid: true });
+const queryAST = parse(getIntrospectionQuery());
+
+export const benchmark = {
+  name: 'Validate With Rules - Executable Document',
+  measure: () =>
+    validateWithRules?.({
+      documentAST: queryAST,
+      schema,
+    }) ?? validate(schema, queryAST),
+};

benchmark/validateWithRulesExecutableSDL-benchmark.js

@@ -0,0 +1,31 @@
+import { parse } from 'graphql/language/parser.js';
+import { buildSchema } from 'graphql/utilities/buildASTSchema.js';
+import { extendSchema } from 'graphql/utilities/extendSchema.js';
+import { getIntrospectionQuery } from 'graphql/utilities/getIntrospectionQuery.js';
+import * as GraphQLValidation from 'graphql/validation/index.js';
+import { validate, validateSDL } from 'graphql/validation/validate.js';
+
+import { bigSchemaSDL } from './fixtures.js';
+
+const validateWithRules = GraphQLValidation.validateWithRules;
+const schema = buildSchema(bigSchemaSDL, { assumeValid: true });
+const extensionSDL = 'extend type Query { _benchmarkAddedField: String }';
+const extensionAST = parse(extensionSDL);
+const extendedSchema = extendSchema(schema, extensionAST);
+const queryAST = parse(getIntrospectionQuery());
+const documentAST = {
+  ...extensionAST,
+  definitions: extensionAST.definitions.concat(queryAST.definitions),
+};
+
+export const benchmark = {
+  name: 'Validate With Rules - Executable Document With SDL',
+  measure: () =>
+    validateWithRules?.({
+      documentAST,
+      schema,
+    }) ??
+    validateSDL(extensionAST, schema).concat(
+      validate(extendedSchema, queryAST),
+    ),
+};

benchmark/validateWithRulesGraphQLSchema-benchmark.js

@@ -0,0 +1,16 @@
+import { validateSchema } from 'graphql/type/validate.js';
+import { buildSchema } from 'graphql/utilities/buildASTSchema.js';
+import * as GraphQLValidation from 'graphql/validation/index.js';
+
+import { bigSchemaSDL } from './fixtures.js';
+
+const validateWithRules = GraphQLValidation.validateWithRules;
+const schema = buildSchema(bigSchemaSDL);
+
+export const benchmark = {
+  name: 'Validate With Rules - GraphQLSchema',
+  measure: () => {
+    schema.__validationErrors = undefined;
+    return validateWithRules?.({ schema }) ?? validateSchema(schema);
+  },
+};

benchmark/validateWithRulesSDL-benchmark.js

@@ -0,0 +1,16 @@
+import { parse } from 'graphql/language/parser.js';
+import * as GraphQLValidation from 'graphql/validation/index.js';
+import { validateSDL } from 'graphql/validation/validate.js';
+
+import { bigSchemaSDL } from './fixtures.js';
+
+const validateWithRules = GraphQLValidation.validateWithRules;
+const documentAST = parse(bigSchemaSDL);
+
+export const benchmark = {
+  name: 'Validate With Rules - SDL Document',
+  measure: () =>
+    validateWithRules?.({
+      documentAST,
+    }) ?? validateSDL(documentAST),
+};

benchmark/validateWithRulesSDLAndSchema-benchmark.js

@@ -0,0 +1,24 @@
+import { parse } from 'graphql/language/parser.js';
+import { validateSchema } from 'graphql/type/validate.js';
+import { buildASTSchema } from 'graphql/utilities/buildASTSchema.js';
+import * as GraphQLValidation from 'graphql/validation/index.js';
+import { validateSDL } from 'graphql/validation/validate.js';
+
+import { bigSchemaSDL } from './fixtures.js';
+
+const validateWithRules = GraphQLValidation.validateWithRules;
+const documentAST = parse(bigSchemaSDL);
+
+export const benchmark = {
+  name: 'Validate With Rules - SDL Document And Schema',
+  measure: () =>
+    (validateWithRules?.({
+      documentAST,
+    }) &&
+      buildASTSchema(documentAST, {
+        assumeValidSDL: true,
+        assumeValid: true,
+      })) ??
+    (validateSDL(documentAST) &&
+      validateSchema(buildASTSchema(documentAST, { assumeValidSDL: true }))),
+};

src/index.ts

@@ -431,9 +431,12 @@ export type {
 export {
   validate,
   ValidationContext,
+  validateWithRules,
   // All validation rules in the GraphQL Specification.
   specifiedRules,
   recommendedRules,
+  specifiedASTValidationRules,
+  specifiedTypeSystemValidationRules,
   // Individual validation rules.
   DeferStreamDirectiveLabelRule,
   DeferStreamDirectiveOnRootFieldRule,
@@ -481,7 +484,11 @@ export {
   NoSchemaIntrospectionCustomRule,
 } from './validation/index.ts';
 
-export type { ValidationOptions, ValidationRule } from './validation/index.ts';
+export type {
+  ValidateWithRulesOptions,
+  ValidationOptions,
+  ValidationRule,
+} from './validation/index.ts';
 
 // Create, format, and print GraphQL errors.
 export { GraphQLError, syntaxError, locatedError } from './error/index.ts';