introduce simple user provided caches for parse/validate

BREAKING CHANGE: parse/validate become potentially async when provided with a cache with an async getter,

Introduces parseSync/validateSync to throw when an async value is returned.

Updates all non-cache tests to use parseSync/validateSync.

benchmark/buildASTSchema-benchmark.js

@@ -1,4 +1,4 @@
-import { parse } from 'graphql/language/parser.js';
+import { parseSync as parse } from 'graphql/language/parser.js';
 import { buildASTSchema } from 'graphql/utilities/buildASTSchema.js';
 
 import { bigSchemaSDL } from './fixtures.js';

benchmark/introspectionFromSchema-benchmark.js

@@ -1,5 +1,5 @@
 import { executeSync } from 'graphql/execution/execute.js';
-import { parse } from 'graphql/language/parser.js';
+import { parseSync as parse } from 'graphql/language/parser.js';
 import { buildSchema } from 'graphql/utilities/buildASTSchema.js';
 import { getIntrospectionQuery } from 'graphql/utilities/getIntrospectionQuery.js';
 

benchmark/list-async-benchmark.js

@@ -1,5 +1,5 @@
 import { execute } from 'graphql/execution/execute.js';
-import { parse } from 'graphql/language/parser.js';
+import { parseSync as parse } from 'graphql/language/parser.js';
 import { buildSchema } from 'graphql/utilities/buildASTSchema.js';
 
 const schema = buildSchema('type Query { listField: [String] }');

benchmark/list-asyncIterable-benchmark.js

@@ -1,5 +1,5 @@
 import { execute } from 'graphql/execution/execute.js';
-import { parse } from 'graphql/language/parser.js';
+import { parseSync as parse } from 'graphql/language/parser.js';
 import { buildSchema } from 'graphql/utilities/buildASTSchema.js';
 
 const schema = buildSchema('type Query { listField: [String] }');

benchmark/list-sync-benchmark.js

@@ -1,5 +1,5 @@
 import { execute } from 'graphql/execution/execute.js';
-import { parse } from 'graphql/language/parser.js';
+import { parseSync as parse } from 'graphql/language/parser.js';
 import { buildSchema } from 'graphql/utilities/buildASTSchema.js';
 
 const schema = buildSchema('type Query { listField: [String] }');

benchmark/parser-benchmark.js

@@ -1,4 +1,4 @@
-import { parse } from 'graphql/language/parser.js';
+import { parseSync as parse } from 'graphql/language/parser.js';
 import { getIntrospectionQuery } from 'graphql/utilities/getIntrospectionQuery.js';
 
 const introspectionQuery = getIntrospectionQuery();

benchmark/validateGQL-benchmark.js

@@ -1,7 +1,7 @@
-import { parse } from 'graphql/language/parser.js';
+import { parseSync as parse } from 'graphql/language/parser.js';
 import { buildSchema } from 'graphql/utilities/buildASTSchema.js';
 import { getIntrospectionQuery } from 'graphql/utilities/getIntrospectionQuery.js';
-import { validate } from 'graphql/validation/validate.js';
+import { validateSync as validate } from 'graphql/validation/validate.js';
 
 import { bigSchemaSDL } from './fixtures.js';
 

benchmark/validateInvalidGQL-benchmark.js

@@ -1,6 +1,6 @@
-import { parse } from 'graphql/language/parser.js';
+import { parseSync as parse } from 'graphql/language/parser.js';
 import { buildSchema } from 'graphql/utilities/buildASTSchema.js';
-import { validate } from 'graphql/validation/validate.js';
+import { validateSync as validate } from 'graphql/validation/validate.js';
 
 import { bigSchemaSDL } from './fixtures.js';
 

benchmark/validateSDL-benchmark.js

@@ -1,4 +1,4 @@
-import { parse } from 'graphql/language/parser.js';
+import { parseSync as parse } from 'graphql/language/parser.js';
 import { validateSDL } from 'graphql/validation/validate.js';
 
 import { bigSchemaSDL } from './fixtures.js';

benchmark/visit-benchmark.js

@@ -1,4 +1,4 @@
-import { parse } from 'graphql/language/parser.js';
+import { parseSync as parse } from 'graphql/language/parser.js';
 import { visit } from 'graphql/language/visitor.js';
 
 import { bigSchemaSDL } from './fixtures.js';

benchmark/visitInParallel-benchmark.js

@@ -1,4 +1,4 @@
-import { parse } from 'graphql/language/parser.js';
+import { parseSync as parse } from 'graphql/language/parser.js';
 import { visit, visitInParallel } from 'graphql/language/visitor.js';
 
 import { bigSchemaSDL } from './fixtures.js';

src/__tests__/starWarsValidation-test.ts

@@ -1,10 +1,10 @@
 import { expect } from 'chai';
 import { describe, it } from 'mocha';
 
-import { parse } from '../language/parser.js';
+import { parseSync as parse } from '../language/parser.js';
 import { Source } from '../language/source.js';
 
-import { validate } from '../validation/validate.js';
+import { validateSync as validate } from '../validation/validate.js';
 
 import { StarWarsSchema } from './starWarsSchema.js';
 

src/error/__tests__/GraphQLError-test.ts

@@ -4,7 +4,7 @@ import { describe, it } from 'mocha';
 import { dedent } from '../../__testUtils__/dedent.js';
 
 import { Kind } from '../../language/kinds.js';
-import { parse } from '../../language/parser.js';
+import { parseSync as parse } from '../../language/parser.js';
 import { Source } from '../../language/source.js';
 
 import { GraphQLError } from '../GraphQLError.js';

src/execution/__tests__/abort-signal-test.ts

@@ -5,7 +5,7 @@ import { expectJSON } from '../../__testUtils__/expectJSON.js';
 import { resolveOnNextTick } from '../../__testUtils__/resolveOnNextTick.js';
 
 import type { DocumentNode } from '../../language/ast.js';
-import { parse } from '../../language/parser.js';
+import { parseSync as parse } from '../../language/parser.js';
 
 import { buildSchema } from '../../utilities/buildASTSchema.js';
 

src/execution/__tests__/abstract-test.ts

@@ -3,7 +3,7 @@ import { describe, it } from 'mocha';
 
 import { expectJSON } from '../../__testUtils__/expectJSON.js';
 
-import { parse } from '../../language/parser.js';
+import { parseSync as parse } from '../../language/parser.js';
 
 import {
   assertInterfaceType,

src/execution/__tests__/defer-test.ts

@@ -8,7 +8,7 @@ import { resolveOnNextTick } from '../../__testUtils__/resolveOnNextTick.js';
 import { promiseWithResolvers } from '../../jsutils/promiseWithResolvers.js';
 
 import type { DocumentNode } from '../../language/ast.js';
-import { parse } from '../../language/parser.js';
+import { parseSync as parse } from '../../language/parser.js';
 
 import {
   GraphQLList,

src/execution/__tests__/directives-test.ts

@@ -1,7 +1,7 @@
 import { expect } from 'chai';
 import { describe, it } from 'mocha';
 
-import { parse } from '../../language/parser.js';
+import { parseSync as parse } from '../../language/parser.js';
 
 import { GraphQLObjectType } from '../../type/definition.js';
 import { GraphQLString } from '../../type/scalars.js';

src/execution/__tests__/executor-test.ts

@@ -7,7 +7,7 @@ import { resolveOnNextTick } from '../../__testUtils__/resolveOnNextTick.js';
 import { inspect } from '../../jsutils/inspect.js';
 
 import { Kind } from '../../language/kinds.js';
-import { parse } from '../../language/parser.js';
+import { parseSync as parse } from '../../language/parser.js';
 
 import {
   GraphQLInterfaceType,

src/execution/__tests__/lists-test.ts

@@ -5,7 +5,7 @@ import { expectJSON } from '../../__testUtils__/expectJSON.js';
 
 import type { PromiseOrValue } from '../../jsutils/PromiseOrValue.js';
 
-import { parse } from '../../language/parser.js';
+import { parseSync as parse } from '../../language/parser.js';
 
 import type { GraphQLFieldResolver } from '../../type/definition.js';
 import {

src/execution/__tests__/mutations-test.ts

@@ -4,7 +4,7 @@ import { describe, it } from 'mocha';
 import { expectJSON } from '../../__testUtils__/expectJSON.js';
 import { resolveOnNextTick } from '../../__testUtils__/resolveOnNextTick.js';
 
-import { parse } from '../../language/parser.js';
+import { parseSync as parse } from '../../language/parser.js';
 
 import { GraphQLObjectType } from '../../type/definition.js';
 import { GraphQLInt } from '../../type/scalars.js';

src/execution/__tests__/nonnull-test.ts

@@ -6,7 +6,7 @@ import { resolveOnNextTick } from '../../__testUtils__/resolveOnNextTick.js';
 
 import type { PromiseOrValue } from '../../jsutils/PromiseOrValue.js';
 
-import { parse } from '../../language/parser.js';
+import { parseSync as parse } from '../../language/parser.js';
 
 import { GraphQLNonNull, GraphQLObjectType } from '../../type/definition.js';
 import { GraphQLString } from '../../type/scalars.js';

src/execution/__tests__/oneof-test.ts

@@ -2,7 +2,7 @@ import { describe, it } from 'mocha';
 
 import { expectJSON } from '../../__testUtils__/expectJSON.js';
 
-import { parse } from '../../language/parser.js';
+import { parseSync as parse } from '../../language/parser.js';
 
 import { buildSchema } from '../../utilities/buildASTSchema.js';
 

src/execution/__tests__/resolve-test.ts

@@ -1,7 +1,7 @@
 import { expect } from 'chai';
 import { describe, it } from 'mocha';
 
-import { parse } from '../../language/parser.js';
+import { parseSync as parse } from '../../language/parser.js';
 
 import type { GraphQLFieldConfig } from '../../type/definition.js';
 import { GraphQLObjectType } from '../../type/definition.js';

src/execution/__tests__/schema-test.ts

@@ -1,7 +1,7 @@
 import { expect } from 'chai';
 import { describe, it } from 'mocha';
 
-import { parse } from '../../language/parser.js';
+import { parseSync as parse } from '../../language/parser.js';
 
 import {
   GraphQLList,

src/execution/__tests__/stream-test.ts

@@ -9,7 +9,7 @@ import type { PromiseOrValue } from '../../jsutils/PromiseOrValue.js';
 import { promiseWithResolvers } from '../../jsutils/promiseWithResolvers.js';
 
 import type { DocumentNode } from '../../language/ast.js';
-import { parse } from '../../language/parser.js';
+import { parseSync as parse } from '../../language/parser.js';
 
 import {
   GraphQLList,

src/execution/__tests__/subscribe-test.ts

@@ -10,7 +10,7 @@ import { isAsyncIterable } from '../../jsutils/isAsyncIterable.js';
 import { isPromise } from '../../jsutils/isPromise.js';
 import type { PromiseOrValue } from '../../jsutils/PromiseOrValue.js';
 
-import { parse } from '../../language/parser.js';
+import { parseSync as parse } from '../../language/parser.js';
 
 import { GraphQLList, GraphQLObjectType } from '../../type/definition.js';
 import {

src/execution/__tests__/sync-test.ts

@@ -3,13 +3,13 @@ import { describe, it } from 'mocha';
 
 import { expectJSON } from '../../__testUtils__/expectJSON.js';
 
-import { parse } from '../../language/parser.js';
+import { parseSync as parse } from '../../language/parser.js';
 
 import { GraphQLObjectType } from '../../type/definition.js';
 import { GraphQLString } from '../../type/scalars.js';
 import { GraphQLSchema } from '../../type/schema.js';
 
-import { validate } from '../../validation/validate.js';
+import { validateSync as validate } from '../../validation/validate.js';
 
 import { graphqlSync } from '../../graphql.js';
 

src/execution/__tests__/union-interface-test.ts

@@ -3,7 +3,7 @@ import { describe, it } from 'mocha';
 
 import { expectJSON } from '../../__testUtils__/expectJSON.js';
 
-import { parse } from '../../language/parser.js';
+import { parseSync as parse } from '../../language/parser.js';
 
 import {
   GraphQLInterfaceType,

src/execution/__tests__/variables-test.ts

@@ -9,7 +9,7 @@ import { GraphQLError } from '../../error/GraphQLError.js';
 
 import { DirectiveLocation } from '../../language/directiveLocation.js';
 import { Kind } from '../../language/kinds.js';
-import { parse } from '../../language/parser.js';
+import { parseSync as parse } from '../../language/parser.js';
 
 import type {
   GraphQLArgumentConfig,

src/graphql.ts

@@ -2,7 +2,7 @@ import { isPromise } from './jsutils/isPromise.js';
 import type { Maybe } from './jsutils/Maybe.js';
 import type { PromiseOrValue } from './jsutils/PromiseOrValue.js';
 
-import { parse } from './language/parser.js';
+import { parseSync as parse } from './language/parser.js';
 import type { Source } from './language/source.js';
 
 import type {
@@ -12,7 +12,7 @@ import type {
 import type { GraphQLSchema } from './type/schema.js';
 import { validateSchema } from './type/validate.js';
 
-import { validate } from './validation/validate.js';
+import { validateSync as validate } from './validation/validate.js';
 
 import { execute } from './execution/execute.js';
 import type { ExecutionResult } from './execution/types.js';

src/index.ts

@@ -220,6 +220,7 @@ export {
   TokenKind,
   // Parse
   parse,
+  parseSync,
   parseValue,
   parseConstValue,
   parseType,
@@ -247,6 +248,7 @@ export {
 
 export type {
   ParseOptions,
+  ParseCache,
   SourceLocation,
   // Visitor utilities
   ASTVisitor,
@@ -356,6 +358,7 @@ export type {
 // Validate GraphQL documents.
 export {
   validate,
+  validateSync,
   ValidationContext,
   // All validation rules in the GraphQL Specification.
   specifiedRules,
@@ -402,7 +405,11 @@ export {
   NoSchemaIntrospectionCustomRule,
 } from './validation/index.js';
 
-export type { ValidationRule } from './validation/index.js';
+export type {
+  ValidationRule,
+  ValidateOptions,
+  ValidateCache,
+} from './validation/index.js';
 
 // Create, format, and print GraphQL errors.
 export { GraphQLError, syntaxError, locatedError } from './error/index.js';