graphql 17.0.0-beta.1 → 17.0.0-beta.2

package/graphql.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"graphql.js","sourceRoot":"","sources":["../src/graphql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,gCAA+B;AAGnD,OAAO,EAAE,kBAAkB,EAAE,uCAAsC;AAQnE,OAAO,EAAE,cAAc,EAAE,4BAA2B;AASpD,OAAO,EAAE,cAAc,EAAE,sBAAqB;AAkD9C,MAAM,UAAU,OAAO,CAAC,IAAiB;IACvC,gDAAgD;IAChD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,IAAiB;IAC3C,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAEjC,6CAA6C;IAC7C,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,IAAiB;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,cAAc,CAAC;IAC/C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAEhC,kBAAkB;IAClB,MAAM,sBAAsB,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACtD,IAAI,sBAAsB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,OAAO,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC;IAC5C,CAAC;IAED,QAAQ;IACR,IAAI,QAAQ,CAAC;IACb,IAAI,CAAC;QACH,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,WAAW,EAAE,CAAC;QACrB,OAAO,EAAE,MAAM,EAAE,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;IACvD,CAAC;IAED,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxB,OAAO,QAAQ,CAAC,IAAI,CAClB,CAAC,gBAAgB,EAAE,EAAE,CACnB,kBAAkB,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAC7D,CAAC,WAAoB,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAC1E,CAAC;IACJ,CAAC;IAED,OAAO,kBAAkB,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,kBAAkB,CACzB,OAAuB,EACvB,IAAiB,EACjB,MAAqB,EACrB,QAAsB;IAEtB,WAAW;IACX,MAAM,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAE9E,IAAI,SAAS,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAChC,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,wBAAwB,EAAE,EAAE,CACxD,yBAAyB,CACvB,OAAO,EACP,IAAI,EACJ,wBAAwB,EACxB,QAAQ,CACT,CACF,CAAC;IACJ,CAAC;IAED,OAAO,yBAAyB,CAAC,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,yBAAyB,CAChC,OAAuB,EACvB,IAAiB,EACjB,gBAA6C,EAC7C,QAAsB;IAEtB,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IACtC,CAAC;IAED,UAAU;IACV,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;AAChD,CAAC","sourcesContent":["import { isPromise } from './jsutils/isPromise.ts';\nimport type { PromiseOrValue } from './jsutils/PromiseOrValue.ts';\n\nimport { ensureGraphQLError } from './error/ensureGraphQLError.ts';\nimport type { GraphQLError } from './error/GraphQLError.ts';\n\nimport type { DocumentNode } from './language/ast.ts';\nimport type { ParseOptions } from './language/parser.ts';\nimport type { Source } from './language/source.ts';\n\nimport type { GraphQLSchema } from './type/schema.ts';\nimport { validateSchema } from './type/validate.ts';\n\nimport type { ValidationOptions } from './validation/validate.ts';\nimport type { ValidationRule } from './validation/ValidationContext.ts';\n\nimport type { ExecutionArgs } from './execution/execute.ts';\nimport type { ExecutionResult } from './execution/Executor.ts';\n\nimport type { GraphQLHarness } from './harness.ts';\nimport { defaultHarness } from './harness.ts';\n\n/**\n * This is the primary entry point function for fulfilling GraphQL operations\n * by parsing, validating, and executing a GraphQL document along side a\n * GraphQL schema.\n *\n * More sophisticated GraphQL servers, such as those which persist queries,\n * may wish to separate the validation and execution phases to a static time\n * tooling step, and a server runtime step.\n *\n * This function does not support incremental delivery (`@defer` and `@stream`).\n *\n * Accepts either an object with named arguments, or individual arguments:\n *\n * schema:\n *    The GraphQL type system to use when validating and executing a query.\n * source:\n *    A GraphQL language formatted string representing the requested operation.\n * rootValue:\n *    The value provided as the first argument to resolver functions on the top\n *    level type (e.g. the query object type).\n * contextValue:\n *    The context value is provided as an argument to resolver functions after\n *    field arguments. It is used to pass shared information useful at any point\n *    during executing this query, for example the currently logged in user and\n *    connections to databases or other services.\n * variableValues:\n *    A mapping of variable name to runtime value to use for all variables\n *    defined in the requestString.\n * operationName:\n *    The name of the operation to use if requestString contains multiple\n *    possible operations. Can be omitted if requestString contains only\n *    one operation.\n * fieldResolver:\n *    A resolver function to use when one is not provided by the schema.\n *    If not provided, the default field resolver is used (which looks for a\n *    value or method on the source value with the field's name).\n * typeResolver:\n *    A type resolver function to use when none is provided by the schema.\n *    If not provided, the default type resolver is used (which looks for a\n *    `__typename` field or alternatively calls the `isTypeOf` method).\n */\nexport interface GraphQLArgs\n  extends ParseOptions, ValidationOptions, Omit<ExecutionArgs, 'document'> {\n  harness?: GraphQLHarness | undefined;\n  source: string | Source;\n  rules?: ReadonlyArray<ValidationRule> | undefined;\n}\n\nexport function graphql(args: GraphQLArgs): Promise<ExecutionResult> {\n  // Always return a Promise for a consistent API.\n  return new Promise((resolve) => resolve(graphqlImpl(args)));\n}\n\n/**\n * The graphqlSync function also fulfills GraphQL operations by parsing,\n * validating, and executing a GraphQL document along side a GraphQL schema.\n * However, it guarantees to complete synchronously (or throw an error) assuming\n * that all field resolvers are also synchronous.\n */\nexport function graphqlSync(args: GraphQLArgs): ExecutionResult {\n  const result = graphqlImpl(args);\n\n  // Assert that the execution was synchronous.\n  if (isPromise(result)) {\n    throw new Error('GraphQL execution failed to complete synchronously.');\n  }\n\n  return result;\n}\n\nfunction graphqlImpl(args: GraphQLArgs): PromiseOrValue<ExecutionResult> {\n  const harness = args.harness ?? defaultHarness;\n  const { schema, source } = args;\n\n  // Validate Schema\n  const schemaValidationErrors = validateSchema(schema);\n  if (schemaValidationErrors.length > 0) {\n    return { errors: schemaValidationErrors };\n  }\n\n  // Parse\n  let document;\n  try {\n    document = harness.parse(source, args);\n  } catch (syntaxError) {\n    return { errors: [ensureGraphQLError(syntaxError)] };\n  }\n\n  if (isPromise(document)) {\n    return document.then(\n      (resolvedDocument) =>\n        validateAndExecute(harness, args, schema, resolvedDocument),\n      (syntaxError: unknown) => ({ errors: [ensureGraphQLError(syntaxError)] }),\n    );\n  }\n\n  return validateAndExecute(harness, args, schema, document);\n}\n\nfunction validateAndExecute(\n  harness: GraphQLHarness,\n  args: GraphQLArgs,\n  schema: GraphQLSchema,\n  document: DocumentNode,\n): PromiseOrValue<ExecutionResult> {\n  // Validate\n  const validationResult = harness.validate(schema, document, args.rules, args);\n\n  if (isPromise(validationResult)) {\n    return validationResult.then((resolvedValidationResult) =>\n      checkValidationAndExecute(\n        harness,\n        args,\n        resolvedValidationResult,\n        document,\n      ),\n    );\n  }\n\n  return checkValidationAndExecute(harness, args, validationResult, document);\n}\n\nfunction checkValidationAndExecute(\n  harness: GraphQLHarness,\n  args: GraphQLArgs,\n  validationResult: ReadonlyArray<GraphQLError>,\n  document: DocumentNode,\n): PromiseOrValue<ExecutionResult> {\n  if (validationResult.length > 0) {\n    return { errors: validationResult };\n  }\n\n  // Execute\n  return harness.execute({ ...args, document });\n}\n"]}
+{"version":3,"file":"graphql.js","sourceRoot":"","sources":["../src/graphql.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,gCAA+B;AAGnD,OAAO,EAAE,kBAAkB,EAAE,uCAAsC;AAQnE,OAAO,EAAE,cAAc,EAAE,4BAA2B;AASpD,OAAO,EAAE,cAAc,EAAE,sBAAqB;AAmJ9C,MAAM,UAAU,OAAO,CAAC,IAAiB;IAEvC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC;AA0DD,MAAM,UAAU,WAAW,CAAC,IAAiB;IAC3C,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAGjC,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,IAAiB;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,cAAc,CAAC;IAC/C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAGhC,MAAM,sBAAsB,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACtD,IAAI,sBAAsB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,OAAO,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC;IAC5C,CAAC;IAGD,IAAI,QAAQ,CAAC;IACb,IAAI,CAAC;QACH,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,WAAW,EAAE,CAAC;QACrB,OAAO,EAAE,MAAM,EAAE,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;IACvD,CAAC;IAED,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxB,OAAO,QAAQ,CAAC,IAAI,CAClB,CAAC,gBAAgB,EAAE,EAAE,CACnB,kBAAkB,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAC7D,CAAC,WAAoB,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAC1E,CAAC;IACJ,CAAC;IAED,OAAO,kBAAkB,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,kBAAkB,CACzB,OAAuB,EACvB,IAAiB,EACjB,MAAqB,EACrB,QAAsB;IAGtB,MAAM,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAE9E,IAAI,SAAS,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAChC,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,wBAAwB,EAAE,EAAE,CACxD,yBAAyB,CACvB,OAAO,EACP,IAAI,EACJ,wBAAwB,EACxB,QAAQ,CACT,CACF,CAAC;IACJ,CAAC;IAED,OAAO,yBAAyB,CAAC,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,yBAAyB,CAChC,OAAuB,EACvB,IAAiB,EACjB,gBAA6C,EAC7C,QAAsB;IAEtB,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IACtC,CAAC;IAGD,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;AAChD,CAAC","sourcesContent":["/** @category Request Pipeline */\n\nimport { isPromise } from './jsutils/isPromise.ts';\nimport type { PromiseOrValue } from './jsutils/PromiseOrValue.ts';\n\nimport { ensureGraphQLError } from './error/ensureGraphQLError.ts';\nimport type { GraphQLError } from './error/GraphQLError.ts';\n\nimport type { DocumentNode } from './language/ast.ts';\nimport type { ParseOptions } from './language/parser.ts';\nimport type { Source } from './language/source.ts';\n\nimport type { GraphQLSchema } from './type/schema.ts';\nimport { validateSchema } from './type/validate.ts';\n\nimport type { ValidationOptions } from './validation/validate.ts';\nimport type { ValidationRule } from './validation/ValidationContext.ts';\n\nimport type { ExecutionArgs } from './execution/ExecutionArgs.ts';\nimport type { ExecutionResult } from './execution/Executor.ts';\n\nimport type { GraphQLHarness } from './harness.ts';\nimport { defaultHarness } from './harness.ts';\n\n/**\n * Describes the input object accepted by `graphql` and `graphqlSync`.\n *\n * These arguments describe the full parse, validate, and execute lifecycle for\n * a GraphQL request. They include parser options, validation options, execution\n * options, and an optional harness for replacing pipeline stages.\n *\n * `graphql` and `graphqlSync` do not support incremental delivery (`@defer` and\n * `@stream`); use `experimentalExecuteIncrementally` after parsing and\n * validating when incremental delivery is required.\n */\nexport interface GraphQLArgs\n  extends ParseOptions, ValidationOptions, Omit<ExecutionArgs, 'document'> {\n  /**\n   * Custom parse, validate, execute, and subscribe functions for this request\n   * pipeline.\n   */\n  harness?: GraphQLHarness | undefined;\n  /**\n   * A GraphQL language-formatted string or source object representing the\n   * requested operation.\n   */\n  source: string | Source;\n  /** Validation rules to use instead of the specified rules. */\n  rules?: ReadonlyArray<ValidationRule> | undefined;\n}\n\n/**\n * Parses, validates, and executes a GraphQL document against a schema.\n *\n * This is the primary entry point for fulfilling GraphQL operations. Use this\n * when you want a single-call request lifecycle that returns a promise in all\n * cases.\n *\n * More sophisticated GraphQL servers, such as those which persist queries, may\n * wish to separate the validation and execution phases to a static-time tooling\n * step and a server runtime step.\n * @param args - Request execution arguments, including schema and source.\n * @returns A promise that resolves to an execution result or validation errors.\n * @example\n * ```ts\n * // Execute a complete asynchronous request with variables.\n * import { graphql, buildSchema } from 'graphql';\n *\n * const schema = buildSchema(`\n *   type Query {\n *     greeting(name: String!): String\n *   }\n * `);\n *\n * const result = await graphql({\n *   schema,\n *   source: 'query SayHello($name: String!) { greeting(name: $name) }',\n *   rootValue: {\n *     greeting: ({ name }) => `Hello, ${name}!`,\n *   },\n *   variableValues: { name: 'Ada' },\n *   operationName: 'SayHello',\n * });\n *\n * result; // => { data: { greeting: 'Hello, Ada!' } }\n * ```\n * @example\n * ```ts\n * // This variant supplies context plus custom field and type resolvers.\n * import { graphql, buildSchema } from 'graphql';\n *\n * const schema = buildSchema(`\n *   interface Named {\n *     name: String!\n *   }\n *\n *   type User implements Named {\n *     name: String!\n *   }\n *\n *   type Query {\n *     viewer: Named\n *   }\n * `);\n *\n * const result = await graphql({\n *   schema,\n *   source: '{ viewer { __typename name } }',\n *   rootValue: { viewer: { kind: 'user', name: 'Ada' } },\n *   contextValue: { locale: 'en' },\n *   fieldResolver: (source, _args, context, info) => {\n *     context.locale; // => 'en'\n *     return source[info.fieldName];\n *   },\n *   typeResolver: (value) => {\n *     return value.kind === 'user' ? 'User' : undefined;\n *   },\n * });\n *\n * result; // => { data: { viewer: { __typename: 'User', name: 'Ada' } } }\n * ```\n * @example\n * ```ts\n * // This variant customizes the request pipeline with a harness.\n * import { buildSchema, defaultHarness, graphql } from 'graphql';\n *\n * const schema = buildSchema(`\n *   type Query {\n *     greeting: String\n *   }\n * `);\n * const stages = [];\n * const abortController = new AbortController();\n * const harness = {\n *   parse: (...args) => {\n *     stages.push('parse');\n *     return defaultHarness.parse(...args);\n *   },\n *   validate: (...args) => {\n *     stages.push('validate');\n *     return defaultHarness.validate(...args);\n *   },\n *   execute: (...args) => {\n *     stages.push('execute');\n *     return defaultHarness.execute(...args);\n *   },\n *   subscribe: (...args) => {\n *     stages.push('subscribe');\n *     return defaultHarness.subscribe(...args);\n *   },\n * };\n *\n * const result = await graphql({\n *   schema,\n *   source: '{ greeting }',\n *   rootValue: { greeting: 'Hello' },\n *   rules: [],\n *   maxErrors: 25,\n *   hideSuggestions: true,\n *   noLocation: true,\n *   abortSignal: abortController.signal,\n *   harness,\n * });\n *\n * result; // => { data: { greeting: 'Hello' } }\n * stages; // => ['parse', 'validate', 'execute']\n * ```\n * @category Request Pipeline\n */\nexport function graphql(args: GraphQLArgs): Promise<ExecutionResult> {\n  // Always return a Promise for a consistent API.\n  return new Promise((resolve) => resolve(graphqlImpl(args)));\n}\n\n/**\n * Parses, validates, and executes a GraphQL document synchronously.\n *\n * This function guarantees that execution completes synchronously, or throws an\n * error, assuming that all field resolvers are also synchronous. It throws when\n * any resolver returns a promise.\n * @param args - Request execution arguments, including schema and source.\n * @returns Completed execution output, or request errors if parsing or\n * validation fails.\n * @example\n * ```ts\n * // Execute a complete synchronous request with variables.\n * import { graphqlSync, buildSchema } from 'graphql';\n *\n * const schema = buildSchema(`\n *   type Query {\n *     greeting(name: String!): String\n *   }\n * `);\n *\n * const result = graphqlSync({\n *   schema,\n *   source: 'query SayHello($name: String!) { greeting(name: $name) }',\n *   rootValue: {\n *     greeting: ({ name }) => `Hello, ${name}!`,\n *   },\n *   variableValues: { name: 'Ada' },\n *   operationName: 'SayHello',\n * });\n *\n * result; // => { data: { greeting: 'Hello, Ada!' } }\n * ```\n * @example\n * ```ts\n * // This variant uses a synchronous custom field resolver and context.\n * import { graphqlSync, buildSchema } from 'graphql';\n *\n * const schema = buildSchema(`\n *   type Query {\n *     greeting: String\n *   }\n * `);\n *\n * const result = graphqlSync({\n *   schema,\n *   source: '{ greeting }',\n *   fieldResolver: (_source, _args, contextValue) => {\n *     return contextValue.defaultGreeting;\n *   },\n *   contextValue: { defaultGreeting: 'Hello' },\n * });\n *\n * result; // => { data: { greeting: 'Hello' } }\n * ```\n * @category Request Pipeline\n */\nexport function graphqlSync(args: GraphQLArgs): ExecutionResult {\n  const result = graphqlImpl(args);\n\n  // Assert that the execution was synchronous.\n  if (isPromise(result)) {\n    throw new Error('GraphQL execution failed to complete synchronously.');\n  }\n\n  return result;\n}\n\nfunction graphqlImpl(args: GraphQLArgs): PromiseOrValue<ExecutionResult> {\n  const harness = args.harness ?? defaultHarness;\n  const { schema, source } = args;\n\n  // Validate Schema\n  const schemaValidationErrors = validateSchema(schema);\n  if (schemaValidationErrors.length > 0) {\n    return { errors: schemaValidationErrors };\n  }\n\n  // Parse\n  let document;\n  try {\n    document = harness.parse(source, args);\n  } catch (syntaxError) {\n    return { errors: [ensureGraphQLError(syntaxError)] };\n  }\n\n  if (isPromise(document)) {\n    return document.then(\n      (resolvedDocument) =>\n        validateAndExecute(harness, args, schema, resolvedDocument),\n      (syntaxError: unknown) => ({ errors: [ensureGraphQLError(syntaxError)] }),\n    );\n  }\n\n  return validateAndExecute(harness, args, schema, document);\n}\n\nfunction validateAndExecute(\n  harness: GraphQLHarness,\n  args: GraphQLArgs,\n  schema: GraphQLSchema,\n  document: DocumentNode,\n): PromiseOrValue<ExecutionResult> {\n  // Validate\n  const validationResult = harness.validate(schema, document, args.rules, args);\n\n  if (isPromise(validationResult)) {\n    return validationResult.then((resolvedValidationResult) =>\n      checkValidationAndExecute(\n        harness,\n        args,\n        resolvedValidationResult,\n        document,\n      ),\n    );\n  }\n\n  return checkValidationAndExecute(harness, args, validationResult, document);\n}\n\nfunction checkValidationAndExecute(\n  harness: GraphQLHarness,\n  args: GraphQLArgs,\n  validationResult: ReadonlyArray<GraphQLError>,\n  document: DocumentNode,\n): PromiseOrValue<ExecutionResult> {\n  if (validationResult.length > 0) {\n    return { errors: validationResult };\n  }\n\n  // Execute\n  return harness.execute({ ...args, document });\n}\n"]}

package/harness.d.mts

@@ -1,15 +1,32 @@
+/** @category Harness */
 import type { PromiseOrValue } from "./jsutils/PromiseOrValue.mjs";
 import { parse } from "./language/parser.mjs";
 import { validate } from "./validation/validate.mjs";
 import { execute, subscribe } from "./execution/execute.mjs";
+/** Function used by a GraphQL harness to parse GraphQL source text. */
 export type GraphQLParseFn = (...args: Parameters<typeof parse>) => PromiseOrValue<ReturnType<typeof parse>>;
+/** Function used by a GraphQL harness to validate a parsed document. */
 export type GraphQLValidateFn = (...args: Parameters<typeof validate>) => PromiseOrValue<ReturnType<typeof validate>>;
+/** Function used by a GraphQL harness to execute a valid operation. */
 export type GraphQLExecuteFn = (...args: Parameters<typeof execute>) => ReturnType<typeof execute>;
+/** Function used by a GraphQL harness to create a subscription response stream. */
 export type GraphQLSubscribeFn = (...args: Parameters<typeof subscribe>) => ReturnType<typeof subscribe>;
+/**
+ * Overrides for the parse, validate, execute, and subscribe stages used by the
+ * high-level `graphql` and `graphqlSync` request pipeline.
+ */
 export interface GraphQLHarness {
+    /** Parses GraphQL source text into a document AST. */
     parse: GraphQLParseFn;
+    /** Validates a document AST against a schema. */
     validate: GraphQLValidateFn;
+    /** Executes a valid operation. */
     execute: GraphQLExecuteFn;
+    /** Creates a response stream for a subscription operation. */
     subscribe: GraphQLSubscribeFn;
 }
+/**
+ * Default harness backed by GraphQL.js parse, validate, execute, and subscribe
+ * implementations.
+ */
 export declare const defaultHarness: GraphQLHarness;

package/harness.d.ts

@@ -1,15 +1,32 @@
+/** @category Harness */
 import type { PromiseOrValue } from "./jsutils/PromiseOrValue.js";
 import { parse } from "./language/parser.js";
 import { validate } from "./validation/validate.js";
 import { execute, subscribe } from "./execution/execute.js";
+/** Function used by a GraphQL harness to parse GraphQL source text. */
 export type GraphQLParseFn = (...args: Parameters<typeof parse>) => PromiseOrValue<ReturnType<typeof parse>>;
+/** Function used by a GraphQL harness to validate a parsed document. */
 export type GraphQLValidateFn = (...args: Parameters<typeof validate>) => PromiseOrValue<ReturnType<typeof validate>>;
+/** Function used by a GraphQL harness to execute a valid operation. */
 export type GraphQLExecuteFn = (...args: Parameters<typeof execute>) => ReturnType<typeof execute>;
+/** Function used by a GraphQL harness to create a subscription response stream. */
 export type GraphQLSubscribeFn = (...args: Parameters<typeof subscribe>) => ReturnType<typeof subscribe>;
+/**
+ * Overrides for the parse, validate, execute, and subscribe stages used by the
+ * high-level `graphql` and `graphqlSync` request pipeline.
+ */
 export interface GraphQLHarness {
+    /** Parses GraphQL source text into a document AST. */
     parse: GraphQLParseFn;
+    /** Validates a document AST against a schema. */
     validate: GraphQLValidateFn;
+    /** Executes a valid operation. */
     execute: GraphQLExecuteFn;
+    /** Creates a response stream for a subscription operation. */
     subscribe: GraphQLSubscribeFn;
 }
+/**
+ * Default harness backed by GraphQL.js parse, validate, execute, and subscribe
+ * implementations.
+ */
 export declare const defaultHarness: GraphQLHarness;

package/harness.js.map

@@ -1 +1 @@
-{"version":3,"file":"harness.js","sourceRoot":"","sources":["../src/harness.ts"],"names":[],"mappings":";;;AAEA,oDAA6C;AAE7C,0DAAoD;AAEpD,uDAA4D;AAyB/C,QAAA,cAAc,GAAmB;IAC5C,KAAK,EAAL,iBAAK;IACL,QAAQ,EAAR,sBAAQ;IACR,OAAO,EAAP,oBAAO;IACP,SAAS,EAAT,sBAAS;CACV,CAAC","sourcesContent":["import type { PromiseOrValue } from './jsutils/PromiseOrValue.ts';\n\nimport { parse } from './language/parser.ts';\n\nimport { validate } from './validation/validate.ts';\n\nimport { execute, subscribe } from './execution/execute.ts';\n\nexport type GraphQLParseFn = (\n  ...args: Parameters<typeof parse>\n) => PromiseOrValue<ReturnType<typeof parse>>;\n\nexport type GraphQLValidateFn = (\n  ...args: Parameters<typeof validate>\n) => PromiseOrValue<ReturnType<typeof validate>>;\n\nexport type GraphQLExecuteFn = (\n  ...args: Parameters<typeof execute>\n) => ReturnType<typeof execute>;\n\nexport type GraphQLSubscribeFn = (\n  ...args: Parameters<typeof subscribe>\n) => ReturnType<typeof subscribe>;\n\nexport interface GraphQLHarness {\n  parse: GraphQLParseFn;\n  validate: GraphQLValidateFn;\n  execute: GraphQLExecuteFn;\n  subscribe: GraphQLSubscribeFn;\n}\n\nexport const defaultHarness: GraphQLHarness = {\n  parse,\n  validate,\n  execute,\n  subscribe,\n};\n"]}
+{"version":3,"file":"harness.js","sourceRoot":"","sources":["../src/harness.ts"],"names":[],"mappings":";;;AAIA,oDAA6C;AAE7C,0DAAoD;AAEpD,uDAA4D;AAyC/C,QAAA,cAAc,GAAmB;IAC5C,KAAK,EAAL,iBAAK;IACL,QAAQ,EAAR,sBAAQ;IACR,OAAO,EAAP,oBAAO;IACP,SAAS,EAAT,sBAAS;CACV,CAAC","sourcesContent":["/** @category Harness */\n\nimport type { PromiseOrValue } from './jsutils/PromiseOrValue.ts';\n\nimport { parse } from './language/parser.ts';\n\nimport { validate } from './validation/validate.ts';\n\nimport { execute, subscribe } from './execution/execute.ts';\n\n/** Function used by a GraphQL harness to parse GraphQL source text. */\nexport type GraphQLParseFn = (\n  ...args: Parameters<typeof parse>\n) => PromiseOrValue<ReturnType<typeof parse>>;\n\n/** Function used by a GraphQL harness to validate a parsed document. */\nexport type GraphQLValidateFn = (\n  ...args: Parameters<typeof validate>\n) => PromiseOrValue<ReturnType<typeof validate>>;\n\n/** Function used by a GraphQL harness to execute a valid operation. */\nexport type GraphQLExecuteFn = (\n  ...args: Parameters<typeof execute>\n) => ReturnType<typeof execute>;\n\n/** Function used by a GraphQL harness to create a subscription response stream. */\nexport type GraphQLSubscribeFn = (\n  ...args: Parameters<typeof subscribe>\n) => ReturnType<typeof subscribe>;\n\n/**\n * Overrides for the parse, validate, execute, and subscribe stages used by the\n * high-level `graphql` and `graphqlSync` request pipeline.\n */\nexport interface GraphQLHarness {\n  /** Parses GraphQL source text into a document AST. */\n  parse: GraphQLParseFn;\n  /** Validates a document AST against a schema. */\n  validate: GraphQLValidateFn;\n  /** Executes a valid operation. */\n  execute: GraphQLExecuteFn;\n  /** Creates a response stream for a subscription operation. */\n  subscribe: GraphQLSubscribeFn;\n}\n\n/**\n * Default harness backed by GraphQL.js parse, validate, execute, and subscribe\n * implementations.\n */\nexport const defaultHarness: GraphQLHarness = {\n  parse,\n  validate,\n  execute,\n  subscribe,\n};\n"]}

package/harness.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"harness.js","sourceRoot":"","sources":["../src/harness.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,8BAA6B;AAE7C,OAAO,EAAE,QAAQ,EAAE,kCAAiC;AAEpD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,gCAA+B;AAyB5D,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,KAAK;IACL,QAAQ;IACR,OAAO;IACP,SAAS;CACV,CAAC","sourcesContent":["import type { PromiseOrValue } from './jsutils/PromiseOrValue.ts';\n\nimport { parse } from './language/parser.ts';\n\nimport { validate } from './validation/validate.ts';\n\nimport { execute, subscribe } from './execution/execute.ts';\n\nexport type GraphQLParseFn = (\n  ...args: Parameters<typeof parse>\n) => PromiseOrValue<ReturnType<typeof parse>>;\n\nexport type GraphQLValidateFn = (\n  ...args: Parameters<typeof validate>\n) => PromiseOrValue<ReturnType<typeof validate>>;\n\nexport type GraphQLExecuteFn = (\n  ...args: Parameters<typeof execute>\n) => ReturnType<typeof execute>;\n\nexport type GraphQLSubscribeFn = (\n  ...args: Parameters<typeof subscribe>\n) => ReturnType<typeof subscribe>;\n\nexport interface GraphQLHarness {\n  parse: GraphQLParseFn;\n  validate: GraphQLValidateFn;\n  execute: GraphQLExecuteFn;\n  subscribe: GraphQLSubscribeFn;\n}\n\nexport const defaultHarness: GraphQLHarness = {\n  parse,\n  validate,\n  execute,\n  subscribe,\n};\n"]}
+{"version":3,"file":"harness.js","sourceRoot":"","sources":["../src/harness.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,EAAE,8BAA6B;AAE7C,OAAO,EAAE,QAAQ,EAAE,kCAAiC;AAEpD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,gCAA+B;AAyC5D,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,KAAK;IACL,QAAQ;IACR,OAAO;IACP,SAAS;CACV,CAAC","sourcesContent":["/** @category Harness */\n\nimport type { PromiseOrValue } from './jsutils/PromiseOrValue.ts';\n\nimport { parse } from './language/parser.ts';\n\nimport { validate } from './validation/validate.ts';\n\nimport { execute, subscribe } from './execution/execute.ts';\n\n/** Function used by a GraphQL harness to parse GraphQL source text. */\nexport type GraphQLParseFn = (\n  ...args: Parameters<typeof parse>\n) => PromiseOrValue<ReturnType<typeof parse>>;\n\n/** Function used by a GraphQL harness to validate a parsed document. */\nexport type GraphQLValidateFn = (\n  ...args: Parameters<typeof validate>\n) => PromiseOrValue<ReturnType<typeof validate>>;\n\n/** Function used by a GraphQL harness to execute a valid operation. */\nexport type GraphQLExecuteFn = (\n  ...args: Parameters<typeof execute>\n) => ReturnType<typeof execute>;\n\n/** Function used by a GraphQL harness to create a subscription response stream. */\nexport type GraphQLSubscribeFn = (\n  ...args: Parameters<typeof subscribe>\n) => ReturnType<typeof subscribe>;\n\n/**\n * Overrides for the parse, validate, execute, and subscribe stages used by the\n * high-level `graphql` and `graphqlSync` request pipeline.\n */\nexport interface GraphQLHarness {\n  /** Parses GraphQL source text into a document AST. */\n  parse: GraphQLParseFn;\n  /** Validates a document AST against a schema. */\n  validate: GraphQLValidateFn;\n  /** Executes a valid operation. */\n  execute: GraphQLExecuteFn;\n  /** Creates a response stream for a subscription operation. */\n  subscribe: GraphQLSubscribeFn;\n}\n\n/**\n * Default harness backed by GraphQL.js parse, validate, execute, and subscribe\n * implementations.\n */\nexport const defaultHarness: GraphQLHarness = {\n  parse,\n  validate,\n  execute,\n  subscribe,\n};\n"]}

package/index.d.mts

@@ -1,28 +1,22 @@
 /**
- * GraphQL.js provides a reference implementation for the GraphQL specification
- * but is also a useful utility for operating on GraphQL files and building
- * sophisticated tools.
+ * The root `graphql` package re-exports the public GraphQL.js API from its
+ * submodules and provides the high-level request pipeline helpers defined in
+ * this module.
  *
- * This primary module exports a general purpose function for fulfilling all
- * steps of the GraphQL specification in a single operation, but also includes
- * utilities for every part of the GraphQL specification:
- *
- *   - Parsing the GraphQL language.
- *   - Building a GraphQL type schema.
- *   - Validating a GraphQL request against a type schema.
- *   - Executing a GraphQL request against a type schema.
- *
- * This also includes utility functions for operating on GraphQL types and
- * GraphQL documents to facilitate building tools.
- *
- * You may also import from each sub-directory directly. For example, the
- * following two import statements are equivalent:
+ * You can import public exports from GraphQL.js modules through the root
+ * `graphql` package or through their module-specific entry point. For example,
+ * these two references resolve to the same `parse` function:
  *
  * ```ts
  * import { parse } from 'graphql';
  * import { parse } from 'graphql/language';
  * ```
  *
+ * Use the root package when you want a single import surface, or use submodules
+ * such as `graphql/language`, `graphql/type`, `graphql/execution`, and
+ * `graphql/utilities` when you want module-focused imports. This module also
+ * defines root-only APIs, such as request pipeline helpers and version
+ * metadata, that do not belong to a narrower submodule.
  * @packageDocumentation
  */
 export { version, versionInfo } from "./version.mjs";
@@ -37,15 +31,23 @@ export type { GraphQLType, GraphQLInputType, GraphQLOutputType, GraphQLLeafType,
 export { Kind } from "./language/kinds.mjs";
 export { Token, Source, Location, OperationTypeNode, getLocation, printLocation, printSourceLocation, Lexer, TokenKind, parse, parseValue, parseConstValue, parseType, parseSchemaCoordinate, print, visit, visitInParallel, getEnterLeaveForKind, BREAK, DirectiveLocation, isDefinitionNode, isExecutableDefinitionNode, isSelectionNode, isValueNode, isConstValueNode, isTypeNode, isTypeSystemDefinitionNode, isTypeDefinitionNode, isTypeSystemExtensionNode, isTypeExtensionNode, isSchemaCoordinateNode, isSubscriptionOperationDefinitionNode, } from "./language/index.mjs";
 export type { ParseOptions, SourceLocation, ASTVisitor, ASTVisitFn, ASTVisitorKeyMap, ASTNode, ASTKindToNode, NameNode, DocumentNode, DefinitionNode, ExecutableDefinitionNode, OperationDefinitionNode, SubscriptionOperationDefinitionNode, VariableDefinitionNode, VariableNode, SelectionSetNode, SelectionNode, FieldNode, ArgumentNode, FragmentArgumentNode, ConstArgumentNode, FragmentSpreadNode, InlineFragmentNode, FragmentDefinitionNode, ValueNode, ConstValueNode, IntValueNode, FloatValueNode, StringValueNode, BooleanValueNode, NullValueNode, EnumValueNode, ListValueNode, ConstListValueNode, ObjectValueNode, ConstObjectValueNode, ObjectFieldNode, ConstObjectFieldNode, DirectiveNode, ConstDirectiveNode, TypeNode, NamedTypeNode, ListTypeNode, NonNullTypeNode, TypeSystemDefinitionNode, SchemaDefinitionNode, OperationTypeDefinitionNode, TypeDefinitionNode, ScalarTypeDefinitionNode, ObjectTypeDefinitionNode, FieldDefinitionNode, InputValueDefinitionNode, InterfaceTypeDefinitionNode, UnionTypeDefinitionNode, EnumTypeDefinitionNode, EnumValueDefinitionNode, InputObjectTypeDefinitionNode, DirectiveDefinitionNode, TypeSystemExtensionNode, SchemaExtensionNode, TypeExtensionNode, ScalarTypeExtensionNode, ObjectTypeExtensionNode, InterfaceTypeExtensionNode, UnionTypeExtensionNode, EnumTypeExtensionNode, InputObjectTypeExtensionNode, DirectiveExtensionNode, SchemaCoordinateNode, TypeCoordinateNode, MemberCoordinateNode, ArgumentCoordinateNode, DirectiveCoordinateNode, DirectiveArgumentCoordinateNode, } from "./language/index.mjs";
-export { AbortedGraphQLExecutionError, execute, executeRootSelectionSet, executeSubscriptionEvent, experimentalExecuteIncrementally, experimentalExecuteRootSelectionSet, executeSync, defaultFieldResolver, defaultTypeResolver, responsePathAsArray, getArgumentValues, getVariableValues, getDirectiveValues, subscribe, createSourceEventStream, mapSourceToResponseEvent, validateExecutionArgs, validateSubscriptionArgs, } from "./execution/index.mjs";
-export type { ExecutionArgs, RootSelectionSetExecutor, AsyncWorkFinishedInfo, ExecutionHooks, ValidatedExecutionArgs, ValidatedSubscriptionArgs, ExecutionResult, ExperimentalIncrementalExecutionResults, InitialIncrementalExecutionResult, SubsequentIncrementalExecutionResult, IncrementalDeferResult, IncrementalStreamResult, IncrementalResult, FormattedExecutionResult, FormattedExperimentalIncrementalExecutionResults, FormattedInitialIncrementalExecutionResult, FormattedSubsequentIncrementalExecutionResult, FormattedIncrementalDeferResult, FormattedIncrementalStreamResult, FormattedIncrementalResult, } from "./execution/index.mjs";
-export { validate, ValidationContext, specifiedRules, recommendedRules, ExecutableDefinitionsRule, FieldsOnCorrectTypeRule, FragmentsOnCompositeTypesRule, KnownArgumentNamesRule, KnownDirectivesRule, KnownFragmentNamesRule, KnownOperationTypesRule, KnownTypeNamesRule, LoneAnonymousOperationRule, NoFragmentCyclesRule, NoUndefinedVariablesRule, NoUnusedFragmentsRule, NoUnusedVariablesRule, OverlappingFieldsCanBeMergedRule, PossibleFragmentSpreadsRule, ProvidedRequiredArgumentsRule, ScalarLeafsRule, SingleFieldSubscriptionsRule, UniqueArgumentNamesRule, UniqueDirectivesPerLocationRule, UniqueFragmentNamesRule, UniqueInputFieldNamesRule, UniqueOperationNamesRule, UniqueVariableNamesRule, ValuesOfCorrectTypeRule, VariablesAreInputTypesRule, VariablesInAllowedPositionRule, MaxIntrospectionDepthRule, LoneSchemaDefinitionRule, UniqueOperationTypesRule, UniqueTypeNamesRule, UniqueEnumValueNamesRule, UniqueFieldDefinitionNamesRule, UniqueArgumentDefinitionNamesRule, UniqueDirectiveNamesRule, PossibleTypeExtensionsRule, NoDeprecatedCustomRule, NoSchemaIntrospectionCustomRule, } from "./validation/index.mjs";
-export type { ValidationRule } from "./validation/index.mjs";
+export { AbortedGraphQLExecutionError, execute, executeRootSelectionSet, executeSubscriptionEvent, experimentalExecuteIncrementally, experimentalExecuteRootSelectionSet, legacyExecuteIncrementally, legacyExecuteRootSelectionSet, executeSync, defaultFieldResolver, defaultTypeResolver, responsePathAsArray, getArgumentValues, getVariableValues, getDirectiveValues, subscribe, createSourceEventStream, mapSourceToResponseEvent, validateExecutionArgs, validateSubscriptionArgs, } from "./execution/index.mjs";
+export type { ExecutionArgs, RootSelectionSetExecutor, AsyncWorkFinishedInfo, ExecutionHooks, VariableValues, ValidatedExecutionArgs, ValidatedSubscriptionArgs, ExecutionResult, ExperimentalIncrementalExecutionResults, InitialIncrementalExecutionResult, SubsequentIncrementalExecutionResult, IncrementalDeferResult, IncrementalStreamResult, IncrementalResult, FormattedExecutionResult, FormattedExperimentalIncrementalExecutionResults, FormattedInitialIncrementalExecutionResult, FormattedSubsequentIncrementalExecutionResult, FormattedIncrementalDeferResult, FormattedIncrementalStreamResult, FormattedIncrementalResult, LegacyExperimentalIncrementalExecutionResults, LegacyInitialIncrementalExecutionResult, LegacySubsequentIncrementalExecutionResult, LegacyIncrementalDeferResult, LegacyIncrementalStreamResult, LegacyIncrementalResult, FormattedLegacyExperimentalIncrementalExecutionResults, FormattedLegacyInitialIncrementalExecutionResult, FormattedLegacySubsequentIncrementalExecutionResult, FormattedLegacyIncrementalDeferResult, FormattedLegacyIncrementalStreamResult, FormattedLegacyIncrementalResult, } from "./execution/index.mjs";
+export { validate, ValidationContext, specifiedRules, recommendedRules, DeferStreamDirectiveLabelRule, DeferStreamDirectiveOnRootFieldRule, DeferStreamDirectiveOnValidOperationsRule, ExecutableDefinitionsRule, FieldsOnCorrectTypeRule, FragmentsOnCompositeTypesRule, KnownArgumentNamesRule, KnownDirectivesRule, KnownFragmentNamesRule, KnownOperationTypesRule, KnownTypeNamesRule, LoneAnonymousOperationRule, NoFragmentCyclesRule, NoUndefinedVariablesRule, NoUnusedFragmentsRule, NoUnusedVariablesRule, OverlappingFieldsCanBeMergedRule, PossibleFragmentSpreadsRule, ProvidedRequiredArgumentsRule, ScalarLeafsRule, SingleFieldSubscriptionsRule, StreamDirectiveOnListFieldRule, UniqueArgumentNamesRule, UniqueDirectivesPerLocationRule, UniqueFragmentNamesRule, UniqueInputFieldNamesRule, UniqueOperationNamesRule, UniqueVariableNamesRule, ValuesOfCorrectTypeRule, VariablesAreInputTypesRule, VariablesInAllowedPositionRule, MaxIntrospectionDepthRule, LoneSchemaDefinitionRule, UniqueOperationTypesRule, UniqueTypeNamesRule, UniqueEnumValueNamesRule, UniqueFieldDefinitionNamesRule, UniqueArgumentDefinitionNamesRule, UniqueDirectiveNamesRule, PossibleTypeExtensionsRule, NoDeprecatedCustomRule, NoSchemaIntrospectionCustomRule, } from "./validation/index.mjs";
+export type { ValidationOptions, ValidationRule } from "./validation/index.mjs";
 export { GraphQLError, syntaxError, locatedError } from "./error/index.mjs";
 export type { GraphQLErrorOptions, GraphQLFormattedError, GraphQLErrorExtensions, GraphQLFormattedErrorExtensions, } from "./error/index.mjs";
 export { getIntrospectionQuery, getOperationAST, introspectionFromSchema, buildClientSchema, buildASTSchema, buildSchema, extendSchema, lexicographicSortSchema, printSchema, printType, printDirective, printIntrospectionSchema, typeFromAST, 
-/** @deprecated use `coerceInputLiteral()` instead - will be removed in v18 */
+/**
+ * Deprecated export retained for compatibility. Use `coerceInputLiteral()`
+ * instead.
+ * @deprecated use `coerceInputLiteral()` instead - will be removed in v18
+ */
 valueFromAST, valueFromASTUntyped, 
-/** @deprecated use `valueToLiteral()` instead with care to operate on external values - `astFromValue()` will be removed in v18 */
+/**
+ * Deprecated export retained for compatibility. Use `valueToLiteral()`
+ * instead, and take care to operate on external values.
+ * @deprecated use `valueToLiteral()` instead with care to operate on external values - `astFromValue()` will be removed in v18
+ */
 astFromValue, TypeInfo, visitWithTypeInfo, replaceVariables, valueToLiteral, coerceInputValue, coerceInputLiteral, validateInputValue, validateInputLiteral, concatAST, separateOperations, stripIgnoredCharacters, isEqualType, isTypeSubTypeOf, doTypesOverlap, BreakingChangeType, DangerousChangeType, SafeChangeType, findBreakingChanges, findDangerousChanges, findSchemaChanges, resolveSchemaCoordinate, resolveASTSchemaCoordinate, } from "./utilities/index.mjs";
-export type { IntrospectionOptions, IntrospectionQuery, IntrospectionSchema, IntrospectionType, IntrospectionInputType, IntrospectionOutputType, IntrospectionScalarType, IntrospectionObjectType, IntrospectionInterfaceType, IntrospectionUnionType, IntrospectionEnumType, IntrospectionInputObjectType, IntrospectionTypeRef, IntrospectionInputTypeRef, IntrospectionOutputTypeRef, IntrospectionNamedTypeRef, IntrospectionListTypeRef, IntrospectionNonNullTypeRef, IntrospectionField, IntrospectionInputValue, IntrospectionEnumValue, IntrospectionDirective, BuildSchemaOptions, BreakingChange, SafeChange, DangerousChange, TypedQueryDocumentNode, ResolvedSchemaElement, } from "./utilities/index.mjs";
+export type { IntrospectionOptions, IntrospectionQuery, IntrospectionSchema, IntrospectionType, IntrospectionInputType, IntrospectionOutputType, IntrospectionScalarType, IntrospectionObjectType, IntrospectionInterfaceType, IntrospectionUnionType, IntrospectionEnumType, IntrospectionInputObjectType, IntrospectionTypeRef, IntrospectionInputTypeRef, IntrospectionOutputTypeRef, IntrospectionNamedTypeRef, IntrospectionListTypeRef, IntrospectionNonNullTypeRef, IntrospectionField, IntrospectionInputValue, IntrospectionEnumValue, IntrospectionDirective, BuildSchemaOptions, BreakingChange, SafeChange, DangerousChange, SchemaChange, TypedQueryDocumentNode, ResolvedSchemaElement, } from "./utilities/index.mjs";

package/index.d.ts

@@ -1,28 +1,22 @@
 /**
- * GraphQL.js provides a reference implementation for the GraphQL specification
- * but is also a useful utility for operating on GraphQL files and building
- * sophisticated tools.
+ * The root `graphql` package re-exports the public GraphQL.js API from its
+ * submodules and provides the high-level request pipeline helpers defined in
+ * this module.
  *
- * This primary module exports a general purpose function for fulfilling all
- * steps of the GraphQL specification in a single operation, but also includes
- * utilities for every part of the GraphQL specification:
- *
- *   - Parsing the GraphQL language.
- *   - Building a GraphQL type schema.
- *   - Validating a GraphQL request against a type schema.
- *   - Executing a GraphQL request against a type schema.
- *
- * This also includes utility functions for operating on GraphQL types and
- * GraphQL documents to facilitate building tools.
- *
- * You may also import from each sub-directory directly. For example, the
- * following two import statements are equivalent:
+ * You can import public exports from GraphQL.js modules through the root
+ * `graphql` package or through their module-specific entry point. For example,
+ * these two references resolve to the same `parse` function:
  *
  * ```ts
  * import { parse } from 'graphql';
  * import { parse } from 'graphql/language';
  * ```
  *
+ * Use the root package when you want a single import surface, or use submodules
+ * such as `graphql/language`, `graphql/type`, `graphql/execution`, and
+ * `graphql/utilities` when you want module-focused imports. This module also
+ * defines root-only APIs, such as request pipeline helpers and version
+ * metadata, that do not belong to a narrower submodule.
  * @packageDocumentation
  */
 export { version, versionInfo } from "./version.js";
@@ -37,15 +31,23 @@ export type { GraphQLType, GraphQLInputType, GraphQLOutputType, GraphQLLeafType,
 export { Kind } from "./language/kinds.js";
 export { Token, Source, Location, OperationTypeNode, getLocation, printLocation, printSourceLocation, Lexer, TokenKind, parse, parseValue, parseConstValue, parseType, parseSchemaCoordinate, print, visit, visitInParallel, getEnterLeaveForKind, BREAK, DirectiveLocation, isDefinitionNode, isExecutableDefinitionNode, isSelectionNode, isValueNode, isConstValueNode, isTypeNode, isTypeSystemDefinitionNode, isTypeDefinitionNode, isTypeSystemExtensionNode, isTypeExtensionNode, isSchemaCoordinateNode, isSubscriptionOperationDefinitionNode, } from "./language/index.js";
 export type { ParseOptions, SourceLocation, ASTVisitor, ASTVisitFn, ASTVisitorKeyMap, ASTNode, ASTKindToNode, NameNode, DocumentNode, DefinitionNode, ExecutableDefinitionNode, OperationDefinitionNode, SubscriptionOperationDefinitionNode, VariableDefinitionNode, VariableNode, SelectionSetNode, SelectionNode, FieldNode, ArgumentNode, FragmentArgumentNode, ConstArgumentNode, FragmentSpreadNode, InlineFragmentNode, FragmentDefinitionNode, ValueNode, ConstValueNode, IntValueNode, FloatValueNode, StringValueNode, BooleanValueNode, NullValueNode, EnumValueNode, ListValueNode, ConstListValueNode, ObjectValueNode, ConstObjectValueNode, ObjectFieldNode, ConstObjectFieldNode, DirectiveNode, ConstDirectiveNode, TypeNode, NamedTypeNode, ListTypeNode, NonNullTypeNode, TypeSystemDefinitionNode, SchemaDefinitionNode, OperationTypeDefinitionNode, TypeDefinitionNode, ScalarTypeDefinitionNode, ObjectTypeDefinitionNode, FieldDefinitionNode, InputValueDefinitionNode, InterfaceTypeDefinitionNode, UnionTypeDefinitionNode, EnumTypeDefinitionNode, EnumValueDefinitionNode, InputObjectTypeDefinitionNode, DirectiveDefinitionNode, TypeSystemExtensionNode, SchemaExtensionNode, TypeExtensionNode, ScalarTypeExtensionNode, ObjectTypeExtensionNode, InterfaceTypeExtensionNode, UnionTypeExtensionNode, EnumTypeExtensionNode, InputObjectTypeExtensionNode, DirectiveExtensionNode, SchemaCoordinateNode, TypeCoordinateNode, MemberCoordinateNode, ArgumentCoordinateNode, DirectiveCoordinateNode, DirectiveArgumentCoordinateNode, } from "./language/index.js";
-export { AbortedGraphQLExecutionError, execute, executeRootSelectionSet, executeSubscriptionEvent, experimentalExecuteIncrementally, experimentalExecuteRootSelectionSet, executeSync, defaultFieldResolver, defaultTypeResolver, responsePathAsArray, getArgumentValues, getVariableValues, getDirectiveValues, subscribe, createSourceEventStream, mapSourceToResponseEvent, validateExecutionArgs, validateSubscriptionArgs, } from "./execution/index.js";
-export type { ExecutionArgs, RootSelectionSetExecutor, AsyncWorkFinishedInfo, ExecutionHooks, ValidatedExecutionArgs, ValidatedSubscriptionArgs, ExecutionResult, ExperimentalIncrementalExecutionResults, InitialIncrementalExecutionResult, SubsequentIncrementalExecutionResult, IncrementalDeferResult, IncrementalStreamResult, IncrementalResult, FormattedExecutionResult, FormattedExperimentalIncrementalExecutionResults, FormattedInitialIncrementalExecutionResult, FormattedSubsequentIncrementalExecutionResult, FormattedIncrementalDeferResult, FormattedIncrementalStreamResult, FormattedIncrementalResult, } from "./execution/index.js";
-export { validate, ValidationContext, specifiedRules, recommendedRules, ExecutableDefinitionsRule, FieldsOnCorrectTypeRule, FragmentsOnCompositeTypesRule, KnownArgumentNamesRule, KnownDirectivesRule, KnownFragmentNamesRule, KnownOperationTypesRule, KnownTypeNamesRule, LoneAnonymousOperationRule, NoFragmentCyclesRule, NoUndefinedVariablesRule, NoUnusedFragmentsRule, NoUnusedVariablesRule, OverlappingFieldsCanBeMergedRule, PossibleFragmentSpreadsRule, ProvidedRequiredArgumentsRule, ScalarLeafsRule, SingleFieldSubscriptionsRule, UniqueArgumentNamesRule, UniqueDirectivesPerLocationRule, UniqueFragmentNamesRule, UniqueInputFieldNamesRule, UniqueOperationNamesRule, UniqueVariableNamesRule, ValuesOfCorrectTypeRule, VariablesAreInputTypesRule, VariablesInAllowedPositionRule, MaxIntrospectionDepthRule, LoneSchemaDefinitionRule, UniqueOperationTypesRule, UniqueTypeNamesRule, UniqueEnumValueNamesRule, UniqueFieldDefinitionNamesRule, UniqueArgumentDefinitionNamesRule, UniqueDirectiveNamesRule, PossibleTypeExtensionsRule, NoDeprecatedCustomRule, NoSchemaIntrospectionCustomRule, } from "./validation/index.js";
-export type { ValidationRule } from "./validation/index.js";
+export { AbortedGraphQLExecutionError, execute, executeRootSelectionSet, executeSubscriptionEvent, experimentalExecuteIncrementally, experimentalExecuteRootSelectionSet, legacyExecuteIncrementally, legacyExecuteRootSelectionSet, executeSync, defaultFieldResolver, defaultTypeResolver, responsePathAsArray, getArgumentValues, getVariableValues, getDirectiveValues, subscribe, createSourceEventStream, mapSourceToResponseEvent, validateExecutionArgs, validateSubscriptionArgs, } from "./execution/index.js";
+export type { ExecutionArgs, RootSelectionSetExecutor, AsyncWorkFinishedInfo, ExecutionHooks, VariableValues, ValidatedExecutionArgs, ValidatedSubscriptionArgs, ExecutionResult, ExperimentalIncrementalExecutionResults, InitialIncrementalExecutionResult, SubsequentIncrementalExecutionResult, IncrementalDeferResult, IncrementalStreamResult, IncrementalResult, FormattedExecutionResult, FormattedExperimentalIncrementalExecutionResults, FormattedInitialIncrementalExecutionResult, FormattedSubsequentIncrementalExecutionResult, FormattedIncrementalDeferResult, FormattedIncrementalStreamResult, FormattedIncrementalResult, LegacyExperimentalIncrementalExecutionResults, LegacyInitialIncrementalExecutionResult, LegacySubsequentIncrementalExecutionResult, LegacyIncrementalDeferResult, LegacyIncrementalStreamResult, LegacyIncrementalResult, FormattedLegacyExperimentalIncrementalExecutionResults, FormattedLegacyInitialIncrementalExecutionResult, FormattedLegacySubsequentIncrementalExecutionResult, FormattedLegacyIncrementalDeferResult, FormattedLegacyIncrementalStreamResult, FormattedLegacyIncrementalResult, } from "./execution/index.js";
+export { validate, ValidationContext, specifiedRules, recommendedRules, DeferStreamDirectiveLabelRule, DeferStreamDirectiveOnRootFieldRule, DeferStreamDirectiveOnValidOperationsRule, ExecutableDefinitionsRule, FieldsOnCorrectTypeRule, FragmentsOnCompositeTypesRule, KnownArgumentNamesRule, KnownDirectivesRule, KnownFragmentNamesRule, KnownOperationTypesRule, KnownTypeNamesRule, LoneAnonymousOperationRule, NoFragmentCyclesRule, NoUndefinedVariablesRule, NoUnusedFragmentsRule, NoUnusedVariablesRule, OverlappingFieldsCanBeMergedRule, PossibleFragmentSpreadsRule, ProvidedRequiredArgumentsRule, ScalarLeafsRule, SingleFieldSubscriptionsRule, StreamDirectiveOnListFieldRule, UniqueArgumentNamesRule, UniqueDirectivesPerLocationRule, UniqueFragmentNamesRule, UniqueInputFieldNamesRule, UniqueOperationNamesRule, UniqueVariableNamesRule, ValuesOfCorrectTypeRule, VariablesAreInputTypesRule, VariablesInAllowedPositionRule, MaxIntrospectionDepthRule, LoneSchemaDefinitionRule, UniqueOperationTypesRule, UniqueTypeNamesRule, UniqueEnumValueNamesRule, UniqueFieldDefinitionNamesRule, UniqueArgumentDefinitionNamesRule, UniqueDirectiveNamesRule, PossibleTypeExtensionsRule, NoDeprecatedCustomRule, NoSchemaIntrospectionCustomRule, } from "./validation/index.js";
+export type { ValidationOptions, ValidationRule } from "./validation/index.js";
 export { GraphQLError, syntaxError, locatedError } from "./error/index.js";
 export type { GraphQLErrorOptions, GraphQLFormattedError, GraphQLErrorExtensions, GraphQLFormattedErrorExtensions, } from "./error/index.js";
 export { getIntrospectionQuery, getOperationAST, introspectionFromSchema, buildClientSchema, buildASTSchema, buildSchema, extendSchema, lexicographicSortSchema, printSchema, printType, printDirective, printIntrospectionSchema, typeFromAST, 
-/** @deprecated use `coerceInputLiteral()` instead - will be removed in v18 */
+/**
+ * Deprecated export retained for compatibility. Use `coerceInputLiteral()`
+ * instead.
+ * @deprecated use `coerceInputLiteral()` instead - will be removed in v18
+ */
 valueFromAST, valueFromASTUntyped, 
-/** @deprecated use `valueToLiteral()` instead with care to operate on external values - `astFromValue()` will be removed in v18 */
+/**
+ * Deprecated export retained for compatibility. Use `valueToLiteral()`
+ * instead, and take care to operate on external values.
+ * @deprecated use `valueToLiteral()` instead with care to operate on external values - `astFromValue()` will be removed in v18
+ */
 astFromValue, TypeInfo, visitWithTypeInfo, replaceVariables, valueToLiteral, coerceInputValue, coerceInputLiteral, validateInputValue, validateInputLiteral, concatAST, separateOperations, stripIgnoredCharacters, isEqualType, isTypeSubTypeOf, doTypesOverlap, BreakingChangeType, DangerousChangeType, SafeChangeType, findBreakingChanges, findDangerousChanges, findSchemaChanges, resolveSchemaCoordinate, resolveASTSchemaCoordinate, } from "./utilities/index.js";
-export type { IntrospectionOptions, IntrospectionQuery, IntrospectionSchema, IntrospectionType, IntrospectionInputType, IntrospectionOutputType, IntrospectionScalarType, IntrospectionObjectType, IntrospectionInterfaceType, IntrospectionUnionType, IntrospectionEnumType, IntrospectionInputObjectType, IntrospectionTypeRef, IntrospectionInputTypeRef, IntrospectionOutputTypeRef, IntrospectionNamedTypeRef, IntrospectionListTypeRef, IntrospectionNonNullTypeRef, IntrospectionField, IntrospectionInputValue, IntrospectionEnumValue, IntrospectionDirective, BuildSchemaOptions, BreakingChange, SafeChange, DangerousChange, TypedQueryDocumentNode, ResolvedSchemaElement, } from "./utilities/index.js";
+export type { IntrospectionOptions, IntrospectionQuery, IntrospectionSchema, IntrospectionType, IntrospectionInputType, IntrospectionOutputType, IntrospectionScalarType, IntrospectionObjectType, IntrospectionInterfaceType, IntrospectionUnionType, IntrospectionEnumType, IntrospectionInputObjectType, IntrospectionTypeRef, IntrospectionInputTypeRef, IntrospectionOutputTypeRef, IntrospectionNamedTypeRef, IntrospectionListTypeRef, IntrospectionNonNullTypeRef, IntrospectionField, IntrospectionInputValue, IntrospectionEnumValue, IntrospectionDirective, BuildSchemaOptions, BreakingChange, SafeChange, DangerousChange, SchemaChange, TypedQueryDocumentNode, ResolvedSchemaElement, } from "./utilities/index.js";