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

package/error/locatedError.d.mts

@@ -1,9 +1,29 @@
-import type { Maybe } from '../jsutils/Maybe.js';
-import type { ASTNode } from '../language/ast.js';
-import { GraphQLError } from './GraphQLError.js';
+/** @category Errors */
+import type { Maybe } from "../jsutils/Maybe.mjs";
+import type { ASTNode } from "../language/ast.mjs";
+import { GraphQLError } from "./GraphQLError.mjs";
 /**
  * Given an arbitrary value, presumably thrown while attempting to execute a
  * GraphQL operation, produce a new GraphQLError aware of the location in the
  * document responsible for the original Error.
+ * @param rawOriginalError - The original error value to wrap.
+ * @param nodes - The AST nodes associated with the error.
+ * @param path - The response path associated with the error.
+ * @returns The GraphQL error.
+ * @example
+ * ```ts
+ * import { parse } from 'graphql/language';
+ * import { locatedError } from 'graphql/error';
+ *
+ * const document = parse('{ viewer { name } }');
+ * const fieldNode = document.definitions[0].selectionSet.selections[0];
+ * const error = locatedError(new Error('Resolver failed'), fieldNode, [
+ *   'viewer',
+ * ]);
+ *
+ * error.message; // => 'Resolver failed'
+ * error.locations; // => [{ line: 1, column: 3 }]
+ * error.path; // => ['viewer']
+ * ```
  */
 export declare function locatedError(rawOriginalError: unknown, nodes: ASTNode | ReadonlyArray<ASTNode> | undefined | null, path?: Maybe<ReadonlyArray<string | number>>): GraphQLError;

package/error/locatedError.d.ts

@@ -1,9 +1,29 @@
-import type { Maybe } from '../jsutils/Maybe.js';
-import type { ASTNode } from '../language/ast.js';
-import { GraphQLError } from './GraphQLError.js';
+/** @category Errors */
+import type { Maybe } from "../jsutils/Maybe.js";
+import type { ASTNode } from "../language/ast.js";
+import { GraphQLError } from "./GraphQLError.js";
 /**
  * Given an arbitrary value, presumably thrown while attempting to execute a
  * GraphQL operation, produce a new GraphQLError aware of the location in the
  * document responsible for the original Error.
+ * @param rawOriginalError - The original error value to wrap.
+ * @param nodes - The AST nodes associated with the error.
+ * @param path - The response path associated with the error.
+ * @returns The GraphQL error.
+ * @example
+ * ```ts
+ * import { parse } from 'graphql/language';
+ * import { locatedError } from 'graphql/error';
+ *
+ * const document = parse('{ viewer { name } }');
+ * const fieldNode = document.definitions[0].selectionSet.selections[0];
+ * const error = locatedError(new Error('Resolver failed'), fieldNode, [
+ *   'viewer',
+ * ]);
+ *
+ * error.message; // => 'Resolver failed'
+ * error.locations; // => [{ line: 1, column: 3 }]
+ * error.path; // => ['viewer']
+ * ```
  */
 export declare function locatedError(rawOriginalError: unknown, nodes: ASTNode | ReadonlyArray<ASTNode> | undefined | null, path?: Maybe<ReadonlyArray<string | number>>): GraphQLError;

package/error/locatedError.js

@@ -1,20 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.locatedError = locatedError;
-const toError_js_1 = require("../jsutils/toError.js");
-const GraphQLError_js_1 = require("./GraphQLError.js");
-/**
- * Given an arbitrary value, presumably thrown while attempting to execute a
- * GraphQL operation, produce a new GraphQLError aware of the location in the
- * document responsible for the original Error.
- */
+const toError_ts_1 = require("../jsutils/toError.js");
+const GraphQLError_ts_1 = require("./GraphQLError.js");
 function locatedError(rawOriginalError, nodes, path) {
-    const originalError = (0, toError_js_1.toError)(rawOriginalError);
-    // Note: this uses a brand-check to support GraphQL errors originating from other contexts.
+    const originalError = (0, toError_ts_1.toError)(rawOriginalError);
     if (isLocatedGraphQLError(originalError)) {
         return originalError;
     }
-    return new GraphQLError_js_1.GraphQLError(originalError.message, {
+    return new GraphQLError_ts_1.GraphQLError(originalError.message, {
         nodes: originalError.nodes ?? nodes,
         source: originalError.source,
         positions: originalError.positions,

package/error/locatedError.js.map

@@ -1 +1 @@
-{"version":3,"file":"locatedError.js","sourceRoot":"","sources":["../../src/error/locatedError.ts"],"names":[],"mappings":";;AAYA,oCAmBC;AA9BD,sDAAgD;AAIhD,uDAAiD;AAEjD;;;;GAIG;AACH,SAAgB,YAAY,CAC1B,gBAAyB,EACzB,KAA0D,EAC1D,IAA4C;IAE5C,MAAM,aAAa,GAAG,IAAA,oBAAO,EAAC,gBAAgB,CAAC,CAAC;IAEhD,2FAA2F;IAC3F,IAAI,qBAAqB,CAAC,aAAa,CAAC,EAAE,CAAC;QACzC,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,OAAO,IAAI,8BAAY,CAAC,aAAa,CAAC,OAAO,EAAE;QAC7C,KAAK,EAAG,aAA8B,CAAC,KAAK,IAAI,KAAK;QACrD,MAAM,EAAG,aAA8B,CAAC,MAAM;QAC9C,SAAS,EAAG,aAA8B,CAAC,SAAS;QACpD,IAAI;QACJ,aAAa;KACd,CAAC,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAU;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC","sourcesContent":["import type { Maybe } from '../jsutils/Maybe.js';\nimport { toError } from '../jsutils/toError.js';\n\nimport type { ASTNode } from '../language/ast.js';\n\nimport { GraphQLError } from './GraphQLError.js';\n\n/**\n * Given an arbitrary value, presumably thrown while attempting to execute a\n * GraphQL operation, produce a new GraphQLError aware of the location in the\n * document responsible for the original Error.\n */\nexport function locatedError(\n  rawOriginalError: unknown,\n  nodes: ASTNode | ReadonlyArray<ASTNode> | undefined | null,\n  path?: Maybe<ReadonlyArray<string | number>>,\n): GraphQLError {\n  const originalError = toError(rawOriginalError);\n\n  // Note: this uses a brand-check to support GraphQL errors originating from other contexts.\n  if (isLocatedGraphQLError(originalError)) {\n    return originalError;\n  }\n\n  return new GraphQLError(originalError.message, {\n    nodes: (originalError as GraphQLError).nodes ?? nodes,\n    source: (originalError as GraphQLError).source,\n    positions: (originalError as GraphQLError).positions,\n    path,\n    originalError,\n  });\n}\n\nfunction isLocatedGraphQLError(error: any): error is GraphQLError {\n  return Array.isArray(error.path);\n}\n"]}
+{"version":3,"file":"locatedError.js","sourceRoot":"","sources":["../../src/error/locatedError.ts"],"names":[],"mappings":";;AAiCA,oCAmBC;AAjDD,sDAAgD;AAIhD,uDAAiD;AA0BjD,SAAgB,YAAY,CAC1B,gBAAyB,EACzB,KAA0D,EAC1D,IAA4C;IAE5C,MAAM,aAAa,GAAG,IAAA,oBAAO,EAAC,gBAAgB,CAAC,CAAC;IAGhD,IAAI,qBAAqB,CAAC,aAAa,CAAC,EAAE,CAAC;QACzC,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,OAAO,IAAI,8BAAY,CAAC,aAAa,CAAC,OAAO,EAAE;QAC7C,KAAK,EAAG,aAA8B,CAAC,KAAK,IAAI,KAAK;QACrD,MAAM,EAAG,aAA8B,CAAC,MAAM;QAC9C,SAAS,EAAG,aAA8B,CAAC,SAAS;QACpD,IAAI;QACJ,aAAa;KACd,CAAC,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAU;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC","sourcesContent":["/** @category Errors */\n\nimport type { Maybe } from '../jsutils/Maybe.ts';\nimport { toError } from '../jsutils/toError.ts';\n\nimport type { ASTNode } from '../language/ast.ts';\n\nimport { GraphQLError } from './GraphQLError.ts';\n\n/**\n * Given an arbitrary value, presumably thrown while attempting to execute a\n * GraphQL operation, produce a new GraphQLError aware of the location in the\n * document responsible for the original Error.\n * @param rawOriginalError - The original error value to wrap.\n * @param nodes - The AST nodes associated with the error.\n * @param path - The response path associated with the error.\n * @returns The GraphQL error.\n * @example\n * ```ts\n * import { parse } from 'graphql/language';\n * import { locatedError } from 'graphql/error';\n *\n * const document = parse('{ viewer { name } }');\n * const fieldNode = document.definitions[0].selectionSet.selections[0];\n * const error = locatedError(new Error('Resolver failed'), fieldNode, [\n *   'viewer',\n * ]);\n *\n * error.message; // => 'Resolver failed'\n * error.locations; // => [{ line: 1, column: 3 }]\n * error.path; // => ['viewer']\n * ```\n */\nexport function locatedError(\n  rawOriginalError: unknown,\n  nodes: ASTNode | ReadonlyArray<ASTNode> | undefined | null,\n  path?: Maybe<ReadonlyArray<string | number>>,\n): GraphQLError {\n  const originalError = toError(rawOriginalError);\n\n  // Note: this uses a brand-check to support GraphQL errors originating from other contexts.\n  if (isLocatedGraphQLError(originalError)) {\n    return originalError;\n  }\n\n  return new GraphQLError(originalError.message, {\n    nodes: (originalError as GraphQLError).nodes ?? nodes,\n    source: (originalError as GraphQLError).source,\n    positions: (originalError as GraphQLError).positions,\n    path,\n    originalError,\n  });\n}\n\nfunction isLocatedGraphQLError(error: any): error is GraphQLError {\n  return Array.isArray(error.path);\n}\n"]}

package/error/locatedError.mjs

@@ -1,13 +1,7 @@
 import { toError } from "../jsutils/toError.mjs";
 import { GraphQLError } from "./GraphQLError.mjs";
-/**
- * Given an arbitrary value, presumably thrown while attempting to execute a
- * GraphQL operation, produce a new GraphQLError aware of the location in the
- * document responsible for the original Error.
- */
 export function locatedError(rawOriginalError, nodes, path) {
     const originalError = toError(rawOriginalError);
-    // Note: this uses a brand-check to support GraphQL errors originating from other contexts.
     if (isLocatedGraphQLError(originalError)) {
         return originalError;
     }

package/error/locatedError.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"locatedError.js","sourceRoot":"","sources":["../../src/error/locatedError.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,+BAA8B;AAIhD,OAAO,EAAE,YAAY,EAAE,2BAA0B;AAEjD;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,gBAAyB,EACzB,KAA0D,EAC1D,IAA4C;IAE5C,MAAM,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEhD,2FAA2F;IAC3F,IAAI,qBAAqB,CAAC,aAAa,CAAC,EAAE,CAAC;QACzC,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,OAAO,IAAI,YAAY,CAAC,aAAa,CAAC,OAAO,EAAE;QAC7C,KAAK,EAAG,aAA8B,CAAC,KAAK,IAAI,KAAK;QACrD,MAAM,EAAG,aAA8B,CAAC,MAAM;QAC9C,SAAS,EAAG,aAA8B,CAAC,SAAS;QACpD,IAAI;QACJ,aAAa;KACd,CAAC,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAU;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC","sourcesContent":["import type { Maybe } from '../jsutils/Maybe.js';\nimport { toError } from '../jsutils/toError.js';\n\nimport type { ASTNode } from '../language/ast.js';\n\nimport { GraphQLError } from './GraphQLError.js';\n\n/**\n * Given an arbitrary value, presumably thrown while attempting to execute a\n * GraphQL operation, produce a new GraphQLError aware of the location in the\n * document responsible for the original Error.\n */\nexport function locatedError(\n  rawOriginalError: unknown,\n  nodes: ASTNode | ReadonlyArray<ASTNode> | undefined | null,\n  path?: Maybe<ReadonlyArray<string | number>>,\n): GraphQLError {\n  const originalError = toError(rawOriginalError);\n\n  // Note: this uses a brand-check to support GraphQL errors originating from other contexts.\n  if (isLocatedGraphQLError(originalError)) {\n    return originalError;\n  }\n\n  return new GraphQLError(originalError.message, {\n    nodes: (originalError as GraphQLError).nodes ?? nodes,\n    source: (originalError as GraphQLError).source,\n    positions: (originalError as GraphQLError).positions,\n    path,\n    originalError,\n  });\n}\n\nfunction isLocatedGraphQLError(error: any): error is GraphQLError {\n  return Array.isArray(error.path);\n}\n"]}
+{"version":3,"file":"locatedError.js","sourceRoot":"","sources":["../../src/error/locatedError.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,+BAA8B;AAIhD,OAAO,EAAE,YAAY,EAAE,2BAA0B;AA0BjD,MAAM,UAAU,YAAY,CAC1B,gBAAyB,EACzB,KAA0D,EAC1D,IAA4C;IAE5C,MAAM,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAGhD,IAAI,qBAAqB,CAAC,aAAa,CAAC,EAAE,CAAC;QACzC,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,OAAO,IAAI,YAAY,CAAC,aAAa,CAAC,OAAO,EAAE;QAC7C,KAAK,EAAG,aAA8B,CAAC,KAAK,IAAI,KAAK;QACrD,MAAM,EAAG,aAA8B,CAAC,MAAM;QAC9C,SAAS,EAAG,aAA8B,CAAC,SAAS;QACpD,IAAI;QACJ,aAAa;KACd,CAAC,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAU;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC","sourcesContent":["/** @category Errors */\n\nimport type { Maybe } from '../jsutils/Maybe.ts';\nimport { toError } from '../jsutils/toError.ts';\n\nimport type { ASTNode } from '../language/ast.ts';\n\nimport { GraphQLError } from './GraphQLError.ts';\n\n/**\n * Given an arbitrary value, presumably thrown while attempting to execute a\n * GraphQL operation, produce a new GraphQLError aware of the location in the\n * document responsible for the original Error.\n * @param rawOriginalError - The original error value to wrap.\n * @param nodes - The AST nodes associated with the error.\n * @param path - The response path associated with the error.\n * @returns The GraphQL error.\n * @example\n * ```ts\n * import { parse } from 'graphql/language';\n * import { locatedError } from 'graphql/error';\n *\n * const document = parse('{ viewer { name } }');\n * const fieldNode = document.definitions[0].selectionSet.selections[0];\n * const error = locatedError(new Error('Resolver failed'), fieldNode, [\n *   'viewer',\n * ]);\n *\n * error.message; // => 'Resolver failed'\n * error.locations; // => [{ line: 1, column: 3 }]\n * error.path; // => ['viewer']\n * ```\n */\nexport function locatedError(\n  rawOriginalError: unknown,\n  nodes: ASTNode | ReadonlyArray<ASTNode> | undefined | null,\n  path?: Maybe<ReadonlyArray<string | number>>,\n): GraphQLError {\n  const originalError = toError(rawOriginalError);\n\n  // Note: this uses a brand-check to support GraphQL errors originating from other contexts.\n  if (isLocatedGraphQLError(originalError)) {\n    return originalError;\n  }\n\n  return new GraphQLError(originalError.message, {\n    nodes: (originalError as GraphQLError).nodes ?? nodes,\n    source: (originalError as GraphQLError).source,\n    positions: (originalError as GraphQLError).positions,\n    path,\n    originalError,\n  });\n}\n\nfunction isLocatedGraphQLError(error: any): error is GraphQLError {\n  return Array.isArray(error.path);\n}\n"]}

package/error/syntaxError.d.mts

@@ -1,7 +1,22 @@
-import type { Source } from '../language/source.js';
-import { GraphQLError } from './GraphQLError.js';
+/** @category Errors */
+import type { Source } from "../language/source.mjs";
+import { GraphQLError } from "./GraphQLError.mjs";
 /**
  * Produces a GraphQLError representing a syntax error, containing useful
  * descriptive information about the syntax error's position in the source.
+ * @param source - The GraphQL source containing the syntax error.
+ * @param position - Character offset where the syntax error was encountered.
+ * @param description - Human-readable description of the syntax error.
+ * @returns A GraphQLError located at the syntax error position.
+ * @example
+ * ```ts
+ * import { Source } from 'graphql/language';
+ * import { syntaxError } from 'graphql/error';
+ *
+ * const error = syntaxError(new Source('query {'), 7, 'Expected Name');
+ *
+ * error.message; // => 'Syntax Error: Expected Name'
+ * error.locations; // => [{ line: 1, column: 8 }]
+ * ```
  */
 export declare function syntaxError(source: Source, position: number, description: string): GraphQLError;

package/error/syntaxError.d.ts

@@ -1,7 +1,22 @@
-import type { Source } from '../language/source.js';
-import { GraphQLError } from './GraphQLError.js';
+/** @category Errors */
+import type { Source } from "../language/source.js";
+import { GraphQLError } from "./GraphQLError.js";
 /**
  * Produces a GraphQLError representing a syntax error, containing useful
  * descriptive information about the syntax error's position in the source.
+ * @param source - The GraphQL source containing the syntax error.
+ * @param position - Character offset where the syntax error was encountered.
+ * @param description - Human-readable description of the syntax error.
+ * @returns A GraphQLError located at the syntax error position.
+ * @example
+ * ```ts
+ * import { Source } from 'graphql/language';
+ * import { syntaxError } from 'graphql/error';
+ *
+ * const error = syntaxError(new Source('query {'), 7, 'Expected Name');
+ *
+ * error.message; // => 'Syntax Error: Expected Name'
+ * error.locations; // => [{ line: 1, column: 8 }]
+ * ```
  */
 export declare function syntaxError(source: Source, position: number, description: string): GraphQLError;

package/error/syntaxError.js

@@ -1,13 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.syntaxError = syntaxError;
-const GraphQLError_js_1 = require("./GraphQLError.js");
-/**
- * Produces a GraphQLError representing a syntax error, containing useful
- * descriptive information about the syntax error's position in the source.
- */
+const GraphQLError_ts_1 = require("./GraphQLError.js");
 function syntaxError(source, position, description) {
-    return new GraphQLError_js_1.GraphQLError(`Syntax Error: ${description}`, {
+    return new GraphQLError_ts_1.GraphQLError(`Syntax Error: ${description}`, {
         source,
         positions: [position],
     });

package/error/syntaxError.js.map

@@ -1 +1 @@
-{"version":3,"file":"syntaxError.js","sourceRoot":"","sources":["../../src/error/syntaxError.ts"],"names":[],"mappings":";;AAQA,kCASC;AAfD,uDAAiD;AAEjD;;;GAGG;AACH,SAAgB,WAAW,CACzB,MAAc,EACd,QAAgB,EAChB,WAAmB;IAEnB,OAAO,IAAI,8BAAY,CAAC,iBAAiB,WAAW,EAAE,EAAE;QACtD,MAAM;QACN,SAAS,EAAE,CAAC,QAAQ,CAAC;KACtB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { Source } from '../language/source.js';\n\nimport { GraphQLError } from './GraphQLError.js';\n\n/**\n * Produces a GraphQLError representing a syntax error, containing useful\n * descriptive information about the syntax error's position in the source.\n */\nexport function syntaxError(\n  source: Source,\n  position: number,\n  description: string,\n): GraphQLError {\n  return new GraphQLError(`Syntax Error: ${description}`, {\n    source,\n    positions: [position],\n  });\n}\n"]}
+{"version":3,"file":"syntaxError.js","sourceRoot":"","sources":["../../src/error/syntaxError.ts"],"names":[],"mappings":";;AAwBA,kCASC;AA7BD,uDAAiD;AAoBjD,SAAgB,WAAW,CACzB,MAAc,EACd,QAAgB,EAChB,WAAmB;IAEnB,OAAO,IAAI,8BAAY,CAAC,iBAAiB,WAAW,EAAE,EAAE;QACtD,MAAM;QACN,SAAS,EAAE,CAAC,QAAQ,CAAC;KACtB,CAAC,CAAC;AACL,CAAC","sourcesContent":["/** @category Errors */\n\nimport type { Source } from '../language/source.ts';\n\nimport { GraphQLError } from './GraphQLError.ts';\n\n/**\n * Produces a GraphQLError representing a syntax error, containing useful\n * descriptive information about the syntax error's position in the source.\n * @param source - The GraphQL source containing the syntax error.\n * @param position - Character offset where the syntax error was encountered.\n * @param description - Human-readable description of the syntax error.\n * @returns A GraphQLError located at the syntax error position.\n * @example\n * ```ts\n * import { Source } from 'graphql/language';\n * import { syntaxError } from 'graphql/error';\n *\n * const error = syntaxError(new Source('query {'), 7, 'Expected Name');\n *\n * error.message; // => 'Syntax Error: Expected Name'\n * error.locations; // => [{ line: 1, column: 8 }]\n * ```\n */\nexport function syntaxError(\n  source: Source,\n  position: number,\n  description: string,\n): GraphQLError {\n  return new GraphQLError(`Syntax Error: ${description}`, {\n    source,\n    positions: [position],\n  });\n}\n"]}

package/error/syntaxError.mjs

@@ -1,8 +1,4 @@
 import { GraphQLError } from "./GraphQLError.mjs";
-/**
- * Produces a GraphQLError representing a syntax error, containing useful
- * descriptive information about the syntax error's position in the source.
- */
 export function syntaxError(source, position, description) {
     return new GraphQLError(`Syntax Error: ${description}`, {
         source,

package/error/syntaxError.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"syntaxError.js","sourceRoot":"","sources":["../../src/error/syntaxError.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,2BAA0B;AAEjD;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,MAAc,EACd,QAAgB,EAChB,WAAmB;IAEnB,OAAO,IAAI,YAAY,CAAC,iBAAiB,WAAW,EAAE,EAAE;QACtD,MAAM;QACN,SAAS,EAAE,CAAC,QAAQ,CAAC;KACtB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { Source } from '../language/source.js';\n\nimport { GraphQLError } from './GraphQLError.js';\n\n/**\n * Produces a GraphQLError representing a syntax error, containing useful\n * descriptive information about the syntax error's position in the source.\n */\nexport function syntaxError(\n  source: Source,\n  position: number,\n  description: string,\n): GraphQLError {\n  return new GraphQLError(`Syntax Error: ${description}`, {\n    source,\n    positions: [position],\n  });\n}\n"]}
+{"version":3,"file":"syntaxError.js","sourceRoot":"","sources":["../../src/error/syntaxError.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,2BAA0B;AAoBjD,MAAM,UAAU,WAAW,CACzB,MAAc,EACd,QAAgB,EAChB,WAAmB;IAEnB,OAAO,IAAI,YAAY,CAAC,iBAAiB,WAAW,EAAE,EAAE;QACtD,MAAM;QACN,SAAS,EAAE,CAAC,QAAQ,CAAC;KACtB,CAAC,CAAC;AACL,CAAC","sourcesContent":["/** @category Errors */\n\nimport type { Source } from '../language/source.ts';\n\nimport { GraphQLError } from './GraphQLError.ts';\n\n/**\n * Produces a GraphQLError representing a syntax error, containing useful\n * descriptive information about the syntax error's position in the source.\n * @param source - The GraphQL source containing the syntax error.\n * @param position - Character offset where the syntax error was encountered.\n * @param description - Human-readable description of the syntax error.\n * @returns A GraphQLError located at the syntax error position.\n * @example\n * ```ts\n * import { Source } from 'graphql/language';\n * import { syntaxError } from 'graphql/error';\n *\n * const error = syntaxError(new Source('query {'), 7, 'Expected Name');\n *\n * error.message; // => 'Syntax Error: Expected Name'\n * error.locations; // => [{ line: 1, column: 8 }]\n * ```\n */\nexport function syntaxError(\n  source: Source,\n  position: number,\n  description: string,\n): GraphQLError {\n  return new GraphQLError(`Syntax Error: ${description}`, {\n    source,\n    positions: [position],\n  });\n}\n"]}

package/execution/AbortedGraphQLExecutionError.d.mts

@@ -1,6 +1,33 @@
-import type { PromiseOrValue } from '../jsutils/PromiseOrValue.js';
+/** @category Execution */
+import type { PromiseOrValue } from "../jsutils/PromiseOrValue.mjs";
+/**
+ * Error thrown when GraphQL execution is aborted.
+ * @typeParam TResult - Result value type.
+ */
 export declare class AbortedGraphQLExecutionError<TResult> extends Error {
+    /** Partial execution result available when execution was aborted. */
     readonly abortedResult: PromiseOrValue<TResult>;
+    /**
+     * Creates an error for an aborted GraphQL execution.
+     * @param reason - Abort reason used as the error cause.
+     * @param result - Partial execution result available when execution stopped.
+     * @example
+     * ```ts
+     * import { AbortedGraphQLExecutionError } from 'graphql/execution';
+     *
+     * const cause = new Error('Request cancelled.');
+     * const partialResult = { data: { viewer: null } };
+     * const error = new AbortedGraphQLExecutionError(cause, partialResult);
+     *
+     * error.message; // => 'Request cancelled.'
+     * error.cause; // => cause
+     * error.abortedResult; // => partialResult
+     * ```
+     */
     constructor(reason: unknown, result: PromiseOrValue<TResult>);
+    /**
+     * Returns the value used by `Object.prototype.toString`.
+     * @returns The built-in string tag for this object.
+     */
     get [Symbol.toStringTag](): string;
 }

package/execution/AbortedGraphQLExecutionError.d.ts

@@ -1,6 +1,33 @@
-import type { PromiseOrValue } from '../jsutils/PromiseOrValue.js';
+/** @category Execution */
+import type { PromiseOrValue } from "../jsutils/PromiseOrValue.js";
+/**
+ * Error thrown when GraphQL execution is aborted.
+ * @typeParam TResult - Result value type.
+ */
 export declare class AbortedGraphQLExecutionError<TResult> extends Error {
+    /** Partial execution result available when execution was aborted. */
     readonly abortedResult: PromiseOrValue<TResult>;
+    /**
+     * Creates an error for an aborted GraphQL execution.
+     * @param reason - Abort reason used as the error cause.
+     * @param result - Partial execution result available when execution stopped.
+     * @example
+     * ```ts
+     * import { AbortedGraphQLExecutionError } from 'graphql/execution';
+     *
+     * const cause = new Error('Request cancelled.');
+     * const partialResult = { data: { viewer: null } };
+     * const error = new AbortedGraphQLExecutionError(cause, partialResult);
+     *
+     * error.message; // => 'Request cancelled.'
+     * error.cause; // => cause
+     * error.abortedResult; // => partialResult
+     * ```
+     */
     constructor(reason: unknown, result: PromiseOrValue<TResult>);
+    /**
+     * Returns the value used by `Object.prototype.toString`.
+     * @returns The built-in string tag for this object.
+     */
     get [Symbol.toStringTag](): string;
 }

package/execution/AbortedGraphQLExecutionError.js.map

@@ -1 +1 @@
-{"version":3,"file":"AbortedGraphQLExecutionError.js","sourceRoot":"","sources":["../../src/execution/AbortedGraphQLExecutionError.ts"],"names":[],"mappings":";;;AAEA,MAAa,4BAAsC,SAAQ,KAAK;IAG9D,YAAY,MAAe,EAAE,MAA+B;QAC1D,KAAK,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;QAC3C,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;IAC9B,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;QACtB,OAAO,8BAA8B,CAAC;IACxC,CAAC;CACF;AAZD,oEAYC;AAED,SAAS,qBAAqB,CAAC,MAAe;IAC5C,IAAI,MAAM,YAAY,KAAK,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IACD,IACE,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,SAAS,IAAI,MAAM;QACnB,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAClC,CAAC;QACD,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC","sourcesContent":["import type { PromiseOrValue } from '../jsutils/PromiseOrValue.js';\n\nexport class AbortedGraphQLExecutionError<TResult> extends Error {\n  readonly abortedResult: PromiseOrValue<TResult>;\n\n  constructor(reason: unknown, result: PromiseOrValue<TResult>) {\n    super(getAbortReasonMessage(reason), { cause: reason });\n    this.name = 'AbortedGraphQLExecutionError';\n    this.abortedResult = result;\n  }\n\n  get [Symbol.toStringTag](): string {\n    return 'AbortedGraphQLExecutionError';\n  }\n}\n\nfunction getAbortReasonMessage(reason: unknown): string {\n  if (reason instanceof Error) {\n    return reason.message;\n  }\n  if (\n    typeof reason === 'object' &&\n    reason !== null &&\n    'message' in reason &&\n    typeof reason.message === 'string'\n  ) {\n    return reason.message;\n  }\n  return String(reason);\n}\n"]}
+{"version":3,"file":"AbortedGraphQLExecutionError.js","sourceRoot":"","sources":["../../src/execution/AbortedGraphQLExecutionError.ts"],"names":[],"mappings":";;;AAQA,MAAa,4BAAsC,SAAQ,KAAK;IAqB9D,YAAY,MAAe,EAAE,MAA+B;QAC1D,KAAK,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;QAC3C,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;IAC9B,CAAC;IAMD,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;QACtB,OAAO,8BAA8B,CAAC;IACxC,CAAC;CACF;AAlCD,oEAkCC;AAED,SAAS,qBAAqB,CAAC,MAAe;IAC5C,IAAI,MAAM,YAAY,KAAK,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IACD,IACE,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,SAAS,IAAI,MAAM;QACnB,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAClC,CAAC;QACD,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC","sourcesContent":["/** @category Execution */\n\nimport type { PromiseOrValue } from '../jsutils/PromiseOrValue.ts';\n\n/**\n * Error thrown when GraphQL execution is aborted.\n * @typeParam TResult - Result value type.\n */\nexport class AbortedGraphQLExecutionError<TResult> extends Error {\n  /** Partial execution result available when execution was aborted. */\n  readonly abortedResult: PromiseOrValue<TResult>;\n\n  /**\n   * Creates an error for an aborted GraphQL execution.\n   * @param reason - Abort reason used as the error cause.\n   * @param result - Partial execution result available when execution stopped.\n   * @example\n   * ```ts\n   * import { AbortedGraphQLExecutionError } from 'graphql/execution';\n   *\n   * const cause = new Error('Request cancelled.');\n   * const partialResult = { data: { viewer: null } };\n   * const error = new AbortedGraphQLExecutionError(cause, partialResult);\n   *\n   * error.message; // => 'Request cancelled.'\n   * error.cause; // => cause\n   * error.abortedResult; // => partialResult\n   * ```\n   */\n  constructor(reason: unknown, result: PromiseOrValue<TResult>) {\n    super(getAbortReasonMessage(reason), { cause: reason });\n    this.name = 'AbortedGraphQLExecutionError';\n    this.abortedResult = result;\n  }\n\n  /**\n   * Returns the value used by `Object.prototype.toString`.\n   * @returns The built-in string tag for this object.\n   */\n  get [Symbol.toStringTag](): string {\n    return 'AbortedGraphQLExecutionError';\n  }\n}\n\nfunction getAbortReasonMessage(reason: unknown): string {\n  if (reason instanceof Error) {\n    return reason.message;\n  }\n  if (\n    typeof reason === 'object' &&\n    reason !== null &&\n    'message' in reason &&\n    typeof reason.message === 'string'\n  ) {\n    return reason.message;\n  }\n  return String(reason);\n}\n"]}

package/execution/AbortedGraphQLExecutionError.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"AbortedGraphQLExecutionError.js","sourceRoot":"","sources":["../../src/execution/AbortedGraphQLExecutionError.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,4BAAsC,SAAQ,KAAK;IAG9D,YAAY,MAAe,EAAE,MAA+B;QAC1D,KAAK,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;QAC3C,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;IAC9B,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;QACtB,OAAO,8BAA8B,CAAC;IACxC,CAAC;CACF;AAED,SAAS,qBAAqB,CAAC,MAAe;IAC5C,IAAI,MAAM,YAAY,KAAK,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IACD,IACE,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,SAAS,IAAI,MAAM;QACnB,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAClC,CAAC;QACD,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC","sourcesContent":["import type { PromiseOrValue } from '../jsutils/PromiseOrValue.js';\n\nexport class AbortedGraphQLExecutionError<TResult> extends Error {\n  readonly abortedResult: PromiseOrValue<TResult>;\n\n  constructor(reason: unknown, result: PromiseOrValue<TResult>) {\n    super(getAbortReasonMessage(reason), { cause: reason });\n    this.name = 'AbortedGraphQLExecutionError';\n    this.abortedResult = result;\n  }\n\n  get [Symbol.toStringTag](): string {\n    return 'AbortedGraphQLExecutionError';\n  }\n}\n\nfunction getAbortReasonMessage(reason: unknown): string {\n  if (reason instanceof Error) {\n    return reason.message;\n  }\n  if (\n    typeof reason === 'object' &&\n    reason !== null &&\n    'message' in reason &&\n    typeof reason.message === 'string'\n  ) {\n    return reason.message;\n  }\n  return String(reason);\n}\n"]}
+{"version":3,"file":"AbortedGraphQLExecutionError.js","sourceRoot":"","sources":["../../src/execution/AbortedGraphQLExecutionError.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,4BAAsC,SAAQ,KAAK;IAqB9D,YAAY,MAAe,EAAE,MAA+B;QAC1D,KAAK,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;QAC3C,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;IAC9B,CAAC;IAMD,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;QACtB,OAAO,8BAA8B,CAAC;IACxC,CAAC;CACF;AAED,SAAS,qBAAqB,CAAC,MAAe;IAC5C,IAAI,MAAM,YAAY,KAAK,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IACD,IACE,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,SAAS,IAAI,MAAM;QACnB,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAClC,CAAC;QACD,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC","sourcesContent":["/** @category Execution */\n\nimport type { PromiseOrValue } from '../jsutils/PromiseOrValue.ts';\n\n/**\n * Error thrown when GraphQL execution is aborted.\n * @typeParam TResult - Result value type.\n */\nexport class AbortedGraphQLExecutionError<TResult> extends Error {\n  /** Partial execution result available when execution was aborted. */\n  readonly abortedResult: PromiseOrValue<TResult>;\n\n  /**\n   * Creates an error for an aborted GraphQL execution.\n   * @param reason - Abort reason used as the error cause.\n   * @param result - Partial execution result available when execution stopped.\n   * @example\n   * ```ts\n   * import { AbortedGraphQLExecutionError } from 'graphql/execution';\n   *\n   * const cause = new Error('Request cancelled.');\n   * const partialResult = { data: { viewer: null } };\n   * const error = new AbortedGraphQLExecutionError(cause, partialResult);\n   *\n   * error.message; // => 'Request cancelled.'\n   * error.cause; // => cause\n   * error.abortedResult; // => partialResult\n   * ```\n   */\n  constructor(reason: unknown, result: PromiseOrValue<TResult>) {\n    super(getAbortReasonMessage(reason), { cause: reason });\n    this.name = 'AbortedGraphQLExecutionError';\n    this.abortedResult = result;\n  }\n\n  /**\n   * Returns the value used by `Object.prototype.toString`.\n   * @returns The built-in string tag for this object.\n   */\n  get [Symbol.toStringTag](): string {\n    return 'AbortedGraphQLExecutionError';\n  }\n}\n\nfunction getAbortReasonMessage(reason: unknown): string {\n  if (reason instanceof Error) {\n    return reason.message;\n  }\n  if (\n    typeof reason === 'object' &&\n    reason !== null &&\n    'message' in reason &&\n    typeof reason.message === 'string'\n  ) {\n    return reason.message;\n  }\n  return String(reason);\n}\n"]}

package/execution/AsyncWorkTracker.d.mts

@@ -1,6 +1,6 @@
 /** @internal */
 export declare class AsyncWorkTracker {
-    pendingAsyncWork: Set<Promise<void>>;
+    pendingAsyncWork: Set<PromiseLike<void>>;
     constructor();
     add(promiseLike: PromiseLike<unknown>): void;
     addValues(values: ReadonlyArray<unknown>): void;

package/execution/AsyncWorkTracker.d.ts

@@ -1,6 +1,6 @@
 /** @internal */
 export declare class AsyncWorkTracker {
-    pendingAsyncWork: Set<Promise<void>>;
+    pendingAsyncWork: Set<PromiseLike<void>>;
     constructor();
     add(promiseLike: PromiseLike<unknown>): void;
     addValues(values: ReadonlyArray<unknown>): void;

package/execution/AsyncWorkTracker.js

@@ -1,15 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AsyncWorkTracker = void 0;
-const isPromise_js_1 = require("../jsutils/isPromise.js");
-/** @internal */
+const isPromise_ts_1 = require("../jsutils/isPromise.js");
 class AsyncWorkTracker {
     constructor() {
         this.pendingAsyncWork = new Set();
     }
     add(promiseLike) {
         const pendingAsyncWork = this.pendingAsyncWork;
-        const promiseToSettle = Promise.resolve(promiseLike).then(() => {
+        const promiseToSettle = promiseLike.then(() => {
             pendingAsyncWork.delete(promiseToSettle);
         }, () => {
             pendingAsyncWork.delete(promiseToSettle);
@@ -18,14 +17,12 @@ class AsyncWorkTracker {
     }
     addValues(values) {
         for (const value of values) {
-            if ((0, isPromise_js_1.isPromiseLike)(value)) {
+            if ((0, isPromise_ts_1.isPromiseLike)(value)) {
                 this.add(value);
             }
         }
     }
     wait() {
-        // wait can complete synchronously when there is no tracked async work,
-        // which allows synchronous execution paths to remain synchronous.
         if (this.pendingAsyncWork.size === 0) {
             return;
         }
@@ -40,7 +37,6 @@ class AsyncWorkTracker {
     }
     async waitForPendingAsyncWork() {
         while (this.pendingAsyncWork.size > 0) {
-            // eslint-disable-next-line no-await-in-loop
             await Promise.allSettled(Array.from(this.pendingAsyncWork));
         }
     }

package/execution/AsyncWorkTracker.js.map

@@ -1 +1 @@
-{"version":3,"file":"AsyncWorkTracker.js","sourceRoot":"","sources":["../../src/execution/AsyncWorkTracker.ts"],"names":[],"mappings":";;;AAAA,0DAAwD;AAExD,gBAAgB;AAChB,MAAa,gBAAgB;IAG3B;QACE,IAAI,CAAC,gBAAgB,GAAG,IAAI,GAAG,EAAiB,CAAC;IACnD,CAAC;IAED,GAAG,CAAC,WAAiC;QACnC,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAC/C,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,CACvD,GAAG,EAAE;YACH,gBAAgB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAC3C,CAAC,EACD,GAAG,EAAE;YACH,gBAAgB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAC3C,CAAC,CACF,CAAC;QACF,gBAAgB,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACxC,CAAC;IAED,SAAS,CAAC,MAA8B;QACtC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,IAAA,4BAAa,EAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI;QACF,uEAAuE;QACvE,kEAAkE;QAClE,IAAI,IAAI,CAAC,gBAAgB,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACrC,OAAO;QACT,CAAC;QACD,OAAO,IAAI,CAAC,uBAAuB,EAAE,CAAC;IACxC,CAAC;IAED,uBAAuB,CACrB,MAAyC;QAEzC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;YAC3B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,KAAK,CAAC,uBAAuB;QACnC,OAAO,IAAI,CAAC,gBAAgB,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACtC,4CAA4C;YAC5C,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;CACF;AArDD,4CAqDC","sourcesContent":["import { isPromiseLike } from '../jsutils/isPromise.js';\n\n/** @internal */\nexport class AsyncWorkTracker {\n  pendingAsyncWork: Set<Promise<void>>;\n\n  constructor() {\n    this.pendingAsyncWork = new Set<Promise<void>>();\n  }\n\n  add(promiseLike: PromiseLike<unknown>): void {\n    const pendingAsyncWork = this.pendingAsyncWork;\n    const promiseToSettle = Promise.resolve(promiseLike).then(\n      () => {\n        pendingAsyncWork.delete(promiseToSettle);\n      },\n      () => {\n        pendingAsyncWork.delete(promiseToSettle);\n      },\n    );\n    pendingAsyncWork.add(promiseToSettle);\n  }\n\n  addValues(values: ReadonlyArray<unknown>): void {\n    for (const value of values) {\n      if (isPromiseLike(value)) {\n        this.add(value);\n      }\n    }\n  }\n\n  wait(): Promise<void> | void {\n    // wait can complete synchronously when there is no tracked async work,\n    // which allows synchronous execution paths to remain synchronous.\n    if (this.pendingAsyncWork.size === 0) {\n      return;\n    }\n    return this.waitForPendingAsyncWork();\n  }\n\n  promiseAllTrackOnReject<T>(\n    values: ReadonlyArray<PromiseLike<T> | T>,\n  ): Promise<Array<T>> {\n    const promise = Promise.all(values);\n    promise.then(undefined, () => {\n      this.addValues(values);\n    });\n    return promise;\n  }\n\n  private async waitForPendingAsyncWork(): Promise<void> {\n    while (this.pendingAsyncWork.size > 0) {\n      // eslint-disable-next-line no-await-in-loop\n      await Promise.allSettled(Array.from(this.pendingAsyncWork));\n    }\n  }\n}\n"]}
+{"version":3,"file":"AsyncWorkTracker.js","sourceRoot":"","sources":["../../src/execution/AsyncWorkTracker.ts"],"names":[],"mappings":";;;AAAA,0DAAwD;AAGxD,MAAa,gBAAgB;IAG3B;QACE,IAAI,CAAC,gBAAgB,GAAG,IAAI,GAAG,EAAE,CAAC;IACpC,CAAC;IAED,GAAG,CAAC,WAAiC;QACnC,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAC/C,MAAM,eAAe,GAAG,WAAW,CAAC,IAAI,CACtC,GAAG,EAAE;YACH,gBAAgB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAC3C,CAAC,EACD,GAAG,EAAE;YACH,gBAAgB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAC3C,CAAC,CACF,CAAC;QACF,gBAAgB,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACxC,CAAC;IAED,SAAS,CAAC,MAA8B;QACtC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,IAAA,4BAAa,EAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI;QAGF,IAAI,IAAI,CAAC,gBAAgB,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACrC,OAAO;QACT,CAAC;QACD,OAAO,IAAI,CAAC,uBAAuB,EAAE,CAAC;IACxC,CAAC;IAED,uBAAuB,CACrB,MAAyC;QAEzC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;YAC3B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,KAAK,CAAC,uBAAuB;QACnC,OAAO,IAAI,CAAC,gBAAgB,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAEtC,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;CACF;AArDD,4CAqDC","sourcesContent":["import { isPromiseLike } from '../jsutils/isPromise.ts';\n\n/** @internal */\nexport class AsyncWorkTracker {\n  pendingAsyncWork: Set<PromiseLike<void>>;\n\n  constructor() {\n    this.pendingAsyncWork = new Set();\n  }\n\n  add(promiseLike: PromiseLike<unknown>): void {\n    const pendingAsyncWork = this.pendingAsyncWork;\n    const promiseToSettle = promiseLike.then(\n      () => {\n        pendingAsyncWork.delete(promiseToSettle);\n      },\n      () => {\n        pendingAsyncWork.delete(promiseToSettle);\n      },\n    );\n    pendingAsyncWork.add(promiseToSettle);\n  }\n\n  addValues(values: ReadonlyArray<unknown>): void {\n    for (const value of values) {\n      if (isPromiseLike(value)) {\n        this.add(value);\n      }\n    }\n  }\n\n  wait(): Promise<void> | void {\n    // wait can complete synchronously when there is no tracked async work,\n    // which allows synchronous execution paths to remain synchronous.\n    if (this.pendingAsyncWork.size === 0) {\n      return;\n    }\n    return this.waitForPendingAsyncWork();\n  }\n\n  promiseAllTrackOnReject<T>(\n    values: ReadonlyArray<PromiseLike<T> | T>,\n  ): Promise<Array<T>> {\n    const promise = Promise.all(values);\n    promise.then(undefined, () => {\n      this.addValues(values);\n    });\n    return promise;\n  }\n\n  private async waitForPendingAsyncWork(): Promise<void> {\n    while (this.pendingAsyncWork.size > 0) {\n      // eslint-disable-next-line no-await-in-loop\n      await Promise.allSettled(Array.from(this.pendingAsyncWork));\n    }\n  }\n}\n"]}

package/execution/AsyncWorkTracker.mjs

@@ -1,12 +1,11 @@
 import { isPromiseLike } from "../jsutils/isPromise.mjs";
-/** @internal */
 export class AsyncWorkTracker {
     constructor() {
         this.pendingAsyncWork = new Set();
     }
     add(promiseLike) {
         const pendingAsyncWork = this.pendingAsyncWork;
-        const promiseToSettle = Promise.resolve(promiseLike).then(() => {
+        const promiseToSettle = promiseLike.then(() => {
             pendingAsyncWork.delete(promiseToSettle);
         }, () => {
             pendingAsyncWork.delete(promiseToSettle);
@@ -21,8 +20,6 @@ export class AsyncWorkTracker {
         }
     }
     wait() {
-        // wait can complete synchronously when there is no tracked async work,
-        // which allows synchronous execution paths to remain synchronous.
         if (this.pendingAsyncWork.size === 0) {
             return;
         }
@@ -37,7 +34,6 @@ export class AsyncWorkTracker {
     }
     async waitForPendingAsyncWork() {
         while (this.pendingAsyncWork.size > 0) {
-            // eslint-disable-next-line no-await-in-loop
             await Promise.allSettled(Array.from(this.pendingAsyncWork));
         }
     }

package/execution/AsyncWorkTracker.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"AsyncWorkTracker.js","sourceRoot":"","sources":["../../src/execution/AsyncWorkTracker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,iCAAgC;AAExD,gBAAgB;AAChB,MAAM,OAAO,gBAAgB;IAG3B;QACE,IAAI,CAAC,gBAAgB,GAAG,IAAI,GAAG,EAAiB,CAAC;IACnD,CAAC;IAED,GAAG,CAAC,WAAiC;QACnC,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAC/C,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,CACvD,GAAG,EAAE;YACH,gBAAgB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAC3C,CAAC,EACD,GAAG,EAAE;YACH,gBAAgB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAC3C,CAAC,CACF,CAAC;QACF,gBAAgB,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACxC,CAAC;IAED,SAAS,CAAC,MAA8B;QACtC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI;QACF,uEAAuE;QACvE,kEAAkE;QAClE,IAAI,IAAI,CAAC,gBAAgB,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACrC,OAAO;QACT,CAAC;QACD,OAAO,IAAI,CAAC,uBAAuB,EAAE,CAAC;IACxC,CAAC;IAED,uBAAuB,CACrB,MAAyC;QAEzC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;YAC3B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,KAAK,CAAC,uBAAuB;QACnC,OAAO,IAAI,CAAC,gBAAgB,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACtC,4CAA4C;YAC5C,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;CACF","sourcesContent":["import { isPromiseLike } from '../jsutils/isPromise.js';\n\n/** @internal */\nexport class AsyncWorkTracker {\n  pendingAsyncWork: Set<Promise<void>>;\n\n  constructor() {\n    this.pendingAsyncWork = new Set<Promise<void>>();\n  }\n\n  add(promiseLike: PromiseLike<unknown>): void {\n    const pendingAsyncWork = this.pendingAsyncWork;\n    const promiseToSettle = Promise.resolve(promiseLike).then(\n      () => {\n        pendingAsyncWork.delete(promiseToSettle);\n      },\n      () => {\n        pendingAsyncWork.delete(promiseToSettle);\n      },\n    );\n    pendingAsyncWork.add(promiseToSettle);\n  }\n\n  addValues(values: ReadonlyArray<unknown>): void {\n    for (const value of values) {\n      if (isPromiseLike(value)) {\n        this.add(value);\n      }\n    }\n  }\n\n  wait(): Promise<void> | void {\n    // wait can complete synchronously when there is no tracked async work,\n    // which allows synchronous execution paths to remain synchronous.\n    if (this.pendingAsyncWork.size === 0) {\n      return;\n    }\n    return this.waitForPendingAsyncWork();\n  }\n\n  promiseAllTrackOnReject<T>(\n    values: ReadonlyArray<PromiseLike<T> | T>,\n  ): Promise<Array<T>> {\n    const promise = Promise.all(values);\n    promise.then(undefined, () => {\n      this.addValues(values);\n    });\n    return promise;\n  }\n\n  private async waitForPendingAsyncWork(): Promise<void> {\n    while (this.pendingAsyncWork.size > 0) {\n      // eslint-disable-next-line no-await-in-loop\n      await Promise.allSettled(Array.from(this.pendingAsyncWork));\n    }\n  }\n}\n"]}
+{"version":3,"file":"AsyncWorkTracker.js","sourceRoot":"","sources":["../../src/execution/AsyncWorkTracker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,iCAAgC;AAGxD,MAAM,OAAO,gBAAgB;IAG3B;QACE,IAAI,CAAC,gBAAgB,GAAG,IAAI,GAAG,EAAE,CAAC;IACpC,CAAC;IAED,GAAG,CAAC,WAAiC;QACnC,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAC/C,MAAM,eAAe,GAAG,WAAW,CAAC,IAAI,CACtC,GAAG,EAAE;YACH,gBAAgB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAC3C,CAAC,EACD,GAAG,EAAE;YACH,gBAAgB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAC3C,CAAC,CACF,CAAC;QACF,gBAAgB,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACxC,CAAC;IAED,SAAS,CAAC,MAA8B;QACtC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI;QAGF,IAAI,IAAI,CAAC,gBAAgB,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACrC,OAAO;QACT,CAAC;QACD,OAAO,IAAI,CAAC,uBAAuB,EAAE,CAAC;IACxC,CAAC;IAED,uBAAuB,CACrB,MAAyC;QAEzC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;YAC3B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,KAAK,CAAC,uBAAuB;QACnC,OAAO,IAAI,CAAC,gBAAgB,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAEtC,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;CACF","sourcesContent":["import { isPromiseLike } from '../jsutils/isPromise.ts';\n\n/** @internal */\nexport class AsyncWorkTracker {\n  pendingAsyncWork: Set<PromiseLike<void>>;\n\n  constructor() {\n    this.pendingAsyncWork = new Set();\n  }\n\n  add(promiseLike: PromiseLike<unknown>): void {\n    const pendingAsyncWork = this.pendingAsyncWork;\n    const promiseToSettle = promiseLike.then(\n      () => {\n        pendingAsyncWork.delete(promiseToSettle);\n      },\n      () => {\n        pendingAsyncWork.delete(promiseToSettle);\n      },\n    );\n    pendingAsyncWork.add(promiseToSettle);\n  }\n\n  addValues(values: ReadonlyArray<unknown>): void {\n    for (const value of values) {\n      if (isPromiseLike(value)) {\n        this.add(value);\n      }\n    }\n  }\n\n  wait(): Promise<void> | void {\n    // wait can complete synchronously when there is no tracked async work,\n    // which allows synchronous execution paths to remain synchronous.\n    if (this.pendingAsyncWork.size === 0) {\n      return;\n    }\n    return this.waitForPendingAsyncWork();\n  }\n\n  promiseAllTrackOnReject<T>(\n    values: ReadonlyArray<PromiseLike<T> | T>,\n  ): Promise<Array<T>> {\n    const promise = Promise.all(values);\n    promise.then(undefined, () => {\n      this.addValues(values);\n    });\n    return promise;\n  }\n\n  private async waitForPendingAsyncWork(): Promise<void> {\n    while (this.pendingAsyncWork.size > 0) {\n      // eslint-disable-next-line no-await-in-loop\n      await Promise.allSettled(Array.from(this.pendingAsyncWork));\n    }\n  }\n}\n"]}

package/execution/ExecutionArgs.d.mts

@@ -0,0 +1,101 @@
+/** @category Execution */
+import type { Maybe } from "../jsutils/Maybe.mjs";
+import type { ObjMap } from "../jsutils/ObjMap.mjs";
+import type { DocumentNode, FragmentDefinitionNode, OperationDefinitionNode, SubscriptionOperationDefinitionNode } from "../language/ast.mjs";
+import type { GraphQLFieldResolver, GraphQLTypeResolver } from "../type/definition.mjs";
+import type { GraphQLSchema } from "../type/schema.mjs";
+import type { FragmentDetails } from "./collectFields.mjs";
+import type { VariableValues } from "./values.mjs";
+/** Arguments accepted by execute and executeSync. */
+export interface ExecutionArgs {
+    /** The schema used for validation or execution. */
+    schema: GraphQLSchema;
+    /** The parsed GraphQL document to execute. */
+    document: DocumentNode;
+    /** Initial root value passed to the operation. */
+    rootValue?: unknown;
+    /** Application context value passed to every resolver. */
+    contextValue?: unknown;
+    /** Runtime variable values keyed by variable name. */
+    variableValues?: Maybe<{
+        readonly [variable: string]: unknown;
+    }>;
+    /** Name of the operation to execute when the document contains multiple operations. */
+    operationName?: Maybe<string>;
+    /** Resolver used when a field does not define its own resolver. */
+    fieldResolver?: Maybe<GraphQLFieldResolver<any, any>>;
+    /** Resolver used when an abstract type does not define its own resolver. */
+    typeResolver?: Maybe<GraphQLTypeResolver<any, any>>;
+    /** Resolver used for the root subscription field. */
+    subscribeFieldResolver?: Maybe<GraphQLFieldResolver<any, any>>;
+    /** Whether suggestion text should be omitted from request errors. */
+    hideSuggestions?: Maybe<boolean>;
+    /** AbortSignal used to cancel execution. */
+    abortSignal?: Maybe<AbortSignal>;
+    /** Whether incremental execution may begin eligible work early. */
+    enableEarlyExecution?: Maybe<boolean>;
+    /** Execution hooks invoked during this operation. */
+    hooks?: Maybe<ExecutionHooks>;
+    /** Additional execution options. */
+    options?: {
+        /**
+         * Set the maximum number of errors allowed for coercing (defaults to 50).
+         *
+         * @internal
+         */
+        maxCoercionErrors?: number;
+    };
+}
+/**
+ * Data that must be available at all points during query execution.
+ *
+ * Namely, schema of the type system that is currently executing,
+ * and the fragments defined in the query document
+ */
+export interface ValidatedExecutionArgs {
+    /** Schema used for execution. */
+    schema: GraphQLSchema;
+    /** Fragment definitions keyed by fragment name. */
+    fragmentDefinitions: ObjMap<FragmentDefinitionNode>;
+    /** Fragment details keyed by fragment name. */
+    fragments: ObjMap<FragmentDetails>;
+    /** Root value passed to the operation. */
+    rootValue: unknown;
+    /** Application context value passed to every resolver. */
+    contextValue: unknown;
+    /** Operation definition selected for execution. */
+    operation: OperationDefinitionNode;
+    /** Operation variable values with source metadata and coerced runtime values. */
+    variableValues: VariableValues;
+    /** Resolver used for fields without an explicit resolver. */
+    fieldResolver: GraphQLFieldResolver<any, any>;
+    /** Resolver used for abstract types without an explicit type resolver. */
+    typeResolver: GraphQLTypeResolver<any, any>;
+    /** Resolver used for subscription fields without an explicit subscribe resolver. */
+    subscribeFieldResolver: GraphQLFieldResolver<any, any>;
+    /** Whether suggestion text should be omitted from execution errors. */
+    hideSuggestions: boolean;
+    /** Whether execution should use error propagation. */
+    errorPropagation: boolean;
+    /** External signal that may abort execution. */
+    externalAbortSignal: AbortSignal | undefined;
+    /** Whether incremental execution may begin eligible work early. */
+    enableEarlyExecution: boolean;
+    /** Execution hooks supplied by the caller. */
+    hooks: ExecutionHooks | undefined;
+}
+/** Validated execution arguments for a subscription operation. */
+export interface ValidatedSubscriptionArgs extends ValidatedExecutionArgs {
+    /** Subscription operation definition selected for execution. */
+    operation: SubscriptionOperationDefinitionNode;
+}
+/** Information passed to hooks after asynchronous execution work has finished. */
+export interface AsyncWorkFinishedInfo {
+    /** Validated execution arguments for the operation that finished async work. */
+    validatedExecutionArgs: ValidatedExecutionArgs;
+}
+/** Optional hooks invoked during GraphQL execution. */
+export interface ExecutionHooks {
+    /** Called after all tracked asynchronous execution work has settled. */
+    asyncWorkFinished?: (info: AsyncWorkFinishedInfo) => void;
+}