graphql 17.0.0-beta.0 → 17.0.0-beta.2

package/graphql.d.ts

@@ -1,61 +1,209 @@
-import type { ParseOptions } from './language/parser.js';
-import type { Source } from './language/source.js';
-import type { ValidationOptions } from './validation/validate.js';
-import type { ValidationRule } from './validation/ValidationContext.js';
-import type { ExecutionArgs } from './execution/execute.js';
-import type { ExecutionResult } from './execution/Executor.js';
-import type { GraphQLHarness } from './harness.js';
+/** @category Request Pipeline */
+import type { ParseOptions } from "./language/parser.js";
+import type { Source } from "./language/source.js";
+import type { ValidationOptions } from "./validation/validate.js";
+import type { ValidationRule } from "./validation/ValidationContext.js";
+import type { ExecutionArgs } from "./execution/ExecutionArgs.js";
+import type { ExecutionResult } from "./execution/Executor.js";
+import type { GraphQLHarness } from "./harness.js";
 /**
- * This is the primary entry point function for fulfilling GraphQL operations
- * by parsing, validating, and executing a GraphQL document along side a
- * GraphQL schema.
- *
- * More sophisticated GraphQL servers, such as those which persist queries,
- * may wish to separate the validation and execution phases to a static time
- * tooling step, and a server runtime step.
- *
- * This function does not support incremental delivery (`@defer` and `@stream`).
- *
- * Accepts either an object with named arguments, or individual arguments:
- *
- * schema:
- *    The GraphQL type system to use when validating and executing a query.
- * source:
- *    A GraphQL language formatted string representing the requested operation.
- * rootValue:
- *    The value provided as the first argument to resolver functions on the top
- *    level type (e.g. the query object type).
- * contextValue:
- *    The context value is provided as an argument to resolver functions after
- *    field arguments. It is used to pass shared information useful at any point
- *    during executing this query, for example the currently logged in user and
- *    connections to databases or other services.
- * variableValues:
- *    A mapping of variable name to runtime value to use for all variables
- *    defined in the requestString.
- * operationName:
- *    The name of the operation to use if requestString contains multiple
- *    possible operations. Can be omitted if requestString contains only
- *    one operation.
- * fieldResolver:
- *    A resolver function to use when one is not provided by the schema.
- *    If not provided, the default field resolver is used (which looks for a
- *    value or method on the source value with the field's name).
- * typeResolver:
- *    A type resolver function to use when none is provided by the schema.
- *    If not provided, the default type resolver is used (which looks for a
- *    `__typename` field or alternatively calls the `isTypeOf` method).
+ * Describes the input object accepted by `graphql` and `graphqlSync`.
+ *
+ * These arguments describe the full parse, validate, and execute lifecycle for
+ * a GraphQL request. They include parser options, validation options, execution
+ * options, and an optional harness for replacing pipeline stages.
+ *
+ * `graphql` and `graphqlSync` do not support incremental delivery (`@defer` and
+ * `@stream`); use `experimentalExecuteIncrementally` after parsing and
+ * validating when incremental delivery is required.
  */
 export interface GraphQLArgs extends ParseOptions, ValidationOptions, Omit<ExecutionArgs, 'document'> {
+    /**
+     * Custom parse, validate, execute, and subscribe functions for this request
+     * pipeline.
+     */
     harness?: GraphQLHarness | undefined;
+    /**
+     * A GraphQL language-formatted string or source object representing the
+     * requested operation.
+     */
     source: string | Source;
+    /** Validation rules to use instead of the specified rules. */
     rules?: ReadonlyArray<ValidationRule> | undefined;
 }
+/**
+ * Parses, validates, and executes a GraphQL document against a schema.
+ *
+ * This is the primary entry point for fulfilling GraphQL operations. Use this
+ * when you want a single-call request lifecycle that returns a promise in all
+ * cases.
+ *
+ * More sophisticated GraphQL servers, such as those which persist queries, may
+ * wish to separate the validation and execution phases to a static-time tooling
+ * step and a server runtime step.
+ * @param args - Request execution arguments, including schema and source.
+ * @returns A promise that resolves to an execution result or validation errors.
+ * @example
+ * ```ts
+ * // Execute a complete asynchronous request with variables.
+ * import { graphql, buildSchema } from 'graphql';
+ *
+ * const schema = buildSchema(`
+ *   type Query {
+ *     greeting(name: String!): String
+ *   }
+ * `);
+ *
+ * const result = await graphql({
+ *   schema,
+ *   source: 'query SayHello($name: String!) { greeting(name: $name) }',
+ *   rootValue: {
+ *     greeting: ({ name }) => `Hello, ${name}!`,
+ *   },
+ *   variableValues: { name: 'Ada' },
+ *   operationName: 'SayHello',
+ * });
+ *
+ * result; // => { data: { greeting: 'Hello, Ada!' } }
+ * ```
+ * @example
+ * ```ts
+ * // This variant supplies context plus custom field and type resolvers.
+ * import { graphql, buildSchema } from 'graphql';
+ *
+ * const schema = buildSchema(`
+ *   interface Named {
+ *     name: String!
+ *   }
+ *
+ *   type User implements Named {
+ *     name: String!
+ *   }
+ *
+ *   type Query {
+ *     viewer: Named
+ *   }
+ * `);
+ *
+ * const result = await graphql({
+ *   schema,
+ *   source: '{ viewer { __typename name } }',
+ *   rootValue: { viewer: { kind: 'user', name: 'Ada' } },
+ *   contextValue: { locale: 'en' },
+ *   fieldResolver: (source, _args, context, info) => {
+ *     context.locale; // => 'en'
+ *     return source[info.fieldName];
+ *   },
+ *   typeResolver: (value) => {
+ *     return value.kind === 'user' ? 'User' : undefined;
+ *   },
+ * });
+ *
+ * result; // => { data: { viewer: { __typename: 'User', name: 'Ada' } } }
+ * ```
+ * @example
+ * ```ts
+ * // This variant customizes the request pipeline with a harness.
+ * import { buildSchema, defaultHarness, graphql } from 'graphql';
+ *
+ * const schema = buildSchema(`
+ *   type Query {
+ *     greeting: String
+ *   }
+ * `);
+ * const stages = [];
+ * const abortController = new AbortController();
+ * const harness = {
+ *   parse: (...args) => {
+ *     stages.push('parse');
+ *     return defaultHarness.parse(...args);
+ *   },
+ *   validate: (...args) => {
+ *     stages.push('validate');
+ *     return defaultHarness.validate(...args);
+ *   },
+ *   execute: (...args) => {
+ *     stages.push('execute');
+ *     return defaultHarness.execute(...args);
+ *   },
+ *   subscribe: (...args) => {
+ *     stages.push('subscribe');
+ *     return defaultHarness.subscribe(...args);
+ *   },
+ * };
+ *
+ * const result = await graphql({
+ *   schema,
+ *   source: '{ greeting }',
+ *   rootValue: { greeting: 'Hello' },
+ *   rules: [],
+ *   maxErrors: 25,
+ *   hideSuggestions: true,
+ *   noLocation: true,
+ *   abortSignal: abortController.signal,
+ *   harness,
+ * });
+ *
+ * result; // => { data: { greeting: 'Hello' } }
+ * stages; // => ['parse', 'validate', 'execute']
+ * ```
+ * @category Request Pipeline
+ */
 export declare function graphql(args: GraphQLArgs): Promise<ExecutionResult>;
 /**
- * The graphqlSync function also fulfills GraphQL operations by parsing,
- * validating, and executing a GraphQL document along side a GraphQL schema.
- * However, it guarantees to complete synchronously (or throw an error) assuming
- * that all field resolvers are also synchronous.
+ * Parses, validates, and executes a GraphQL document synchronously.
+ *
+ * This function guarantees that execution completes synchronously, or throws an
+ * error, assuming that all field resolvers are also synchronous. It throws when
+ * any resolver returns a promise.
+ * @param args - Request execution arguments, including schema and source.
+ * @returns Completed execution output, or request errors if parsing or
+ * validation fails.
+ * @example
+ * ```ts
+ * // Execute a complete synchronous request with variables.
+ * import { graphqlSync, buildSchema } from 'graphql';
+ *
+ * const schema = buildSchema(`
+ *   type Query {
+ *     greeting(name: String!): String
+ *   }
+ * `);
+ *
+ * const result = graphqlSync({
+ *   schema,
+ *   source: 'query SayHello($name: String!) { greeting(name: $name) }',
+ *   rootValue: {
+ *     greeting: ({ name }) => `Hello, ${name}!`,
+ *   },
+ *   variableValues: { name: 'Ada' },
+ *   operationName: 'SayHello',
+ * });
+ *
+ * result; // => { data: { greeting: 'Hello, Ada!' } }
+ * ```
+ * @example
+ * ```ts
+ * // This variant uses a synchronous custom field resolver and context.
+ * import { graphqlSync, buildSchema } from 'graphql';
+ *
+ * const schema = buildSchema(`
+ *   type Query {
+ *     greeting: String
+ *   }
+ * `);
+ *
+ * const result = graphqlSync({
+ *   schema,
+ *   source: '{ greeting }',
+ *   fieldResolver: (_source, _args, contextValue) => {
+ *     return contextValue.defaultGreeting;
+ *   },
+ *   contextValue: { defaultGreeting: 'Hello' },
+ * });
+ *
+ * result; // => { data: { greeting: 'Hello' } }
+ * ```
+ * @category Request Pipeline
  */
 export declare function graphqlSync(args: GraphQLArgs): ExecutionResult;

package/graphql.js

@@ -2,53 +2,42 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.graphql = graphql;
 exports.graphqlSync = graphqlSync;
-const isPromise_js_1 = require("./jsutils/isPromise.js");
-const ensureGraphQLError_js_1 = require("./error/ensureGraphQLError.js");
-const validate_js_1 = require("./type/validate.js");
-const harness_js_1 = require("./harness.js");
+const isPromise_ts_1 = require("./jsutils/isPromise.js");
+const ensureGraphQLError_ts_1 = require("./error/ensureGraphQLError.js");
+const validate_ts_1 = require("./type/validate.js");
+const harness_ts_1 = require("./harness.js");
 function graphql(args) {
-    // Always return a Promise for a consistent API.
     return new Promise((resolve) => resolve(graphqlImpl(args)));
 }
-/**
- * The graphqlSync function also fulfills GraphQL operations by parsing,
- * validating, and executing a GraphQL document along side a GraphQL schema.
- * However, it guarantees to complete synchronously (or throw an error) assuming
- * that all field resolvers are also synchronous.
- */
 function graphqlSync(args) {
     const result = graphqlImpl(args);
-    // Assert that the execution was synchronous.
-    if ((0, isPromise_js_1.isPromise)(result)) {
+    if ((0, isPromise_ts_1.isPromise)(result)) {
         throw new Error('GraphQL execution failed to complete synchronously.');
     }
     return result;
 }
 function graphqlImpl(args) {
-    const harness = args.harness ?? harness_js_1.defaultHarness;
+    const harness = args.harness ?? harness_ts_1.defaultHarness;
     const { schema, source } = args;
-    // Validate Schema
-    const schemaValidationErrors = (0, validate_js_1.validateSchema)(schema);
+    const schemaValidationErrors = (0, validate_ts_1.validateSchema)(schema);
     if (schemaValidationErrors.length > 0) {
         return { errors: schemaValidationErrors };
     }
-    // Parse
     let document;
     try {
         document = harness.parse(source, args);
     }
     catch (syntaxError) {
-        return { errors: [(0, ensureGraphQLError_js_1.ensureGraphQLError)(syntaxError)] };
+        return { errors: [(0, ensureGraphQLError_ts_1.ensureGraphQLError)(syntaxError)] };
     }
-    if ((0, isPromise_js_1.isPromise)(document)) {
-        return document.then((resolvedDocument) => validateAndExecute(harness, args, schema, resolvedDocument), (syntaxError) => ({ errors: [(0, ensureGraphQLError_js_1.ensureGraphQLError)(syntaxError)] }));
+    if ((0, isPromise_ts_1.isPromise)(document)) {
+        return document.then((resolvedDocument) => validateAndExecute(harness, args, schema, resolvedDocument), (syntaxError) => ({ errors: [(0, ensureGraphQLError_ts_1.ensureGraphQLError)(syntaxError)] }));
     }
     return validateAndExecute(harness, args, schema, document);
 }
 function validateAndExecute(harness, args, schema, document) {
-    // Validate
     const validationResult = harness.validate(schema, document, args.rules, args);
-    if ((0, isPromise_js_1.isPromise)(validationResult)) {
+    if ((0, isPromise_ts_1.isPromise)(validationResult)) {
         return validationResult.then((resolvedValidationResult) => checkValidationAndExecute(harness, args, resolvedValidationResult, document));
     }
     return checkValidationAndExecute(harness, args, validationResult, document);
@@ -57,7 +46,6 @@ function checkValidationAndExecute(harness, args, validationResult, document) {
     if (validationResult.length > 0) {
         return { errors: validationResult };
     }
-    // Execute
     return harness.execute({ ...args, document });
 }
 //# sourceMappingURL=graphql.js.map

package/graphql.js.map

@@ -1 +1 @@
-{"version":3,"file":"graphql.js","sourceRoot":"","sources":["../src/graphql.ts"],"names":[],"mappings":"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","sourcesContent":["import { isPromise } from './jsutils/isPromise.js';\nimport type { PromiseOrValue } from './jsutils/PromiseOrValue.js';\n\nimport { ensureGraphQLError } from './error/ensureGraphQLError.js';\nimport type { GraphQLError } from './error/GraphQLError.js';\n\nimport type { DocumentNode } from './language/ast.js';\nimport type { ParseOptions } from './language/parser.js';\nimport type { Source } from './language/source.js';\n\nimport type { GraphQLSchema } from './type/schema.js';\nimport { validateSchema } from './type/validate.js';\n\nimport type { ValidationOptions } from './validation/validate.js';\nimport type { ValidationRule } from './validation/ValidationContext.js';\n\nimport type { ExecutionArgs } from './execution/execute.js';\nimport type { ExecutionResult } from './execution/Executor.js';\n\nimport type { GraphQLHarness } from './harness.js';\nimport { defaultHarness } from './harness.js';\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":";;AAyKA,0BAGC;AA0DD,kCASC;AA7OD,yDAAmD;AAGnD,yEAAmE;AAQnE,oDAAoD;AASpD,6CAA8C;AAmJ9C,SAAgB,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,SAAgB,WAAW,CAAC,IAAiB;IAC3C,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAGjC,IAAI,IAAA,wBAAS,EAAC,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,2BAAc,CAAC;IAC/C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAGhC,MAAM,sBAAsB,GAAG,IAAA,4BAAc,EAAC,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,IAAA,0CAAkB,EAAC,WAAW,CAAC,CAAC,EAAE,CAAC;IACvD,CAAC;IAED,IAAI,IAAA,wBAAS,EAAC,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,IAAA,0CAAkB,EAAC,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,IAAA,wBAAS,EAAC,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/graphql.mjs

@@ -3,18 +3,10 @@ import { ensureGraphQLError } from "./error/ensureGraphQLError.mjs";
 import { validateSchema } from "./type/validate.mjs";
 import { defaultHarness } from "./harness.mjs";
 export function graphql(args) {
-    // Always return a Promise for a consistent API.
     return new Promise((resolve) => resolve(graphqlImpl(args)));
 }
-/**
- * The graphqlSync function also fulfills GraphQL operations by parsing,
- * validating, and executing a GraphQL document along side a GraphQL schema.
- * However, it guarantees to complete synchronously (or throw an error) assuming
- * that all field resolvers are also synchronous.
- */
 export function graphqlSync(args) {
     const result = graphqlImpl(args);
-    // Assert that the execution was synchronous.
     if (isPromise(result)) {
         throw new Error('GraphQL execution failed to complete synchronously.');
     }
@@ -23,12 +15,10 @@ export function graphqlSync(args) {
 function graphqlImpl(args) {
     const harness = args.harness ?? defaultHarness;
     const { schema, source } = args;
-    // Validate Schema
     const schemaValidationErrors = validateSchema(schema);
     if (schemaValidationErrors.length > 0) {
         return { errors: schemaValidationErrors };
     }
-    // Parse
     let document;
     try {
         document = harness.parse(source, args);
@@ -42,7 +32,6 @@ function graphqlImpl(args) {
     return validateAndExecute(harness, args, schema, document);
 }
 function validateAndExecute(harness, args, schema, document) {
-    // Validate
     const validationResult = harness.validate(schema, document, args.rules, args);
     if (isPromise(validationResult)) {
         return validationResult.then((resolvedValidationResult) => checkValidationAndExecute(harness, args, resolvedValidationResult, document));
@@ -53,7 +42,6 @@ function checkValidationAndExecute(harness, args, validationResult, document) {
     if (validationResult.length > 0) {
         return { errors: validationResult };
     }
-    // Execute
     return harness.execute({ ...args, document });
 }
 //# sourceMappingURL=graphql.mjs.map

package/graphql.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"graphql.js","sourceRoot":"","sources":["../src/graphql.ts"],"names":[],"mappings":"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","sourcesContent":["import { isPromise } from './jsutils/isPromise.js';\nimport type { PromiseOrValue } from './jsutils/PromiseOrValue.js';\n\nimport { ensureGraphQLError } from './error/ensureGraphQLError.js';\nimport type { GraphQLError } from './error/GraphQLError.js';\n\nimport type { DocumentNode } from './language/ast.js';\nimport type { ParseOptions } from './language/parser.js';\nimport type { Source } from './language/source.js';\n\nimport type { GraphQLSchema } from './type/schema.js';\nimport { validateSchema } from './type/validate.js';\n\nimport type { ValidationOptions } from './validation/validate.js';\nimport type { ValidationRule } from './validation/ValidationContext.js';\n\nimport type { ExecutionArgs } from './execution/execute.js';\nimport type { ExecutionResult } from './execution/Executor.js';\n\nimport type { GraphQLHarness } from './harness.js';\nimport { defaultHarness } from './harness.js';\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 @@
-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';
+/** @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 @@
-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';
+/** @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

@@ -1,13 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.defaultHarness = void 0;
-const parser_js_1 = require("./language/parser.js");
-const validate_js_1 = require("./validation/validate.js");
-const execute_js_1 = require("./execution/execute.js");
+const parser_ts_1 = require("./language/parser.js");
+const validate_ts_1 = require("./validation/validate.js");
+const execute_ts_1 = require("./execution/execute.js");
 exports.defaultHarness = {
-    parse: parser_js_1.parse,
-    validate: validate_js_1.validate,
-    execute: execute_js_1.execute,
-    subscribe: execute_js_1.subscribe,
+    parse: parser_ts_1.parse,
+    validate: validate_ts_1.validate,
+    execute: execute_ts_1.execute,
+    subscribe: execute_ts_1.subscribe,
 };
 //# sourceMappingURL=harness.js.map

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.js';\n\nimport { parse } from './language/parser.js';\n\nimport { validate } from './validation/validate.js';\n\nimport { execute, subscribe } from './execution/execute.js';\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.js';\n\nimport { parse } from './language/parser.js';\n\nimport { validate } from './validation/validate.js';\n\nimport { execute, subscribe } from './execution/execute.js';\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"]}