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

package/error/GraphQLError.d.ts

@@ -1,10 +1,10 @@
+/** @category Errors */
 import type { Maybe } from "../jsutils/Maybe.js";
 import type { ASTNode } from "../language/ast.js";
 import type { SourceLocation } from "../language/location.js";
 import type { Source } from "../language/source.js";
 /**
  * Custom extensions
- *
  * @remarks
  * Use a unique identifier name for your extension, for example the name of
  * your library or project. Do not use a shortened identifier as this increases
@@ -16,7 +16,6 @@ export interface GraphQLErrorExtensions {
 }
 /**
  * Custom formatted extensions
- *
  * @remarks
  * Use a unique identifier name for your extension, for example the name of
  * your library or project. Do not use a shortened identifier as this increases
@@ -26,14 +25,26 @@ export interface GraphQLErrorExtensions {
 export interface GraphQLFormattedErrorExtensions {
     [attributeName: string]: unknown;
 }
+/** Options used to construct a GraphQLError. */
 export interface GraphQLErrorOptions {
+    /** AST node or nodes associated with this error. */
     nodes?: ReadonlyArray<ASTNode> | ASTNode | null | undefined;
+    /** Source document used to derive error locations. */
     source?: Maybe<Source>;
+    /** Character offsets in the source document associated with this error. */
     positions?: Maybe<ReadonlyArray<number>>;
+    /** Response path where this error occurred during execution. */
     path?: Maybe<ReadonlyArray<string | number>>;
+    /**
+     * Original error that caused this GraphQLError, if one exists.
+     * @deprecated Prefer `cause` instead.
+     */
     originalError?: Maybe<Error & {
         readonly extensions?: unknown;
     }>;
+    /** Cause of this GraphQLError, if one exists. */
+    cause?: unknown;
+    /** Extension fields to include in the formatted result. */
     extensions?: Maybe<GraphQLErrorExtensions>;
 }
 /**
@@ -61,9 +72,7 @@ export declare class GraphQLError extends Error {
      * Enumerable, and appears in the result of JSON.stringify().
      */
     readonly path: ReadonlyArray<string | number> | undefined;
-    /**
-     * An array of GraphQL AST Nodes corresponding to this error.
-     */
+    /** An array of GraphQL AST Nodes corresponding to this error. */
     readonly nodes: ReadonlyArray<ASTNode> | undefined;
     /**
      * The source GraphQL document for the first location of this error.
@@ -79,20 +88,95 @@ export declare class GraphQLError extends Error {
     readonly positions: ReadonlyArray<number> | undefined;
     /**
      * The original error thrown from a field resolver during execution.
+     * @deprecated Use `cause` instead.
      */
     readonly originalError: Error | undefined;
+    /** Extension fields to add to the formatted error. */
+    readonly extensions: GraphQLErrorExtensions;
     /**
-     * Extension fields to add to the formatted error.
+     * Creates a GraphQLError instance.
+     * @param message - Human-readable error message.
+     * @param options - Error metadata such as source locations, response path, cause, original error, and extensions.
+     * @example
+     * ```ts
+     * // Create an error from AST nodes and response metadata.
+     * import { parse } from 'graphql/language';
+     * import { GraphQLError } from 'graphql/error';
+     *
+     * const document = parse('{ greeting }');
+     * const fieldNode = document.definitions[0].selectionSet.selections[0];
+     * const error = new GraphQLError('Cannot query this field.', {
+     *   nodes: fieldNode,
+     *   path: ['greeting'],
+     *   extensions: { code: 'FORBIDDEN' },
+     * });
+     *
+     * error.message; // => 'Cannot query this field.'
+     * error.locations; // => [{ line: 1, column: 3 }]
+     * error.path; // => ['greeting']
+     * error.extensions; // => { code: 'FORBIDDEN' }
+     * ```
+     * @example
+     * ```ts
+     * // This variant derives locations from source positions and preserves the cause.
+     * import { Source } from 'graphql/language';
+     * import { GraphQLError } from 'graphql/error';
+     *
+     * const source = new Source('{ greeting }');
+     * const cause = new Error('Database unavailable.');
+     * const error = new GraphQLError('Resolver failed.', {
+     *   source,
+     *   positions: [2],
+     *   path: ['greeting'],
+     *   cause,
+     * });
+     *
+     * error.locations; // => [{ line: 1, column: 3 }]
+     * error.path; // => ['greeting']
+     * error.cause; // => cause
+     * ```
      */
-    readonly extensions: GraphQLErrorExtensions;
     constructor(message: string, options?: GraphQLErrorOptions);
+    /**
+     * Returns the value used by `Object.prototype.toString`.
+     * @returns The built-in string tag for this object.
+     */
     get [Symbol.toStringTag](): string;
+    /**
+     * Returns this error as a human-readable message with source locations.
+     * @returns The formatted error string.
+     * @example
+     * ```ts
+     * import { Source } from 'graphql/language';
+     * import { GraphQLError } from 'graphql/error';
+     *
+     * const error = new GraphQLError('Cannot query field "name".', {
+     *   source: new Source('{ name }'),
+     *   positions: [2],
+     * });
+     *
+     * error.toString(); // => 'Cannot query field "name".\n\nGraphQL request:1:3\n1 | { name }\n  |   ^'
+     * ```
+     */
     toString(): string;
+    /**
+     * Returns the JSON representation used when this object is serialized.
+     * @returns The JSON-serializable representation.
+     * @example
+     * ```ts
+     * import { GraphQLError } from 'graphql/error';
+     *
+     * const error = new GraphQLError('Resolver failed.', {
+     *   path: ['viewer', 'name'],
+     *   extensions: { code: 'INTERNAL' },
+     * });
+     *
+     * error.toJSON(); // => { message: 'Resolver failed.', path: ['viewer', 'name'], extensions: { code: 'INTERNAL' } }
+     * ```
+     */
     toJSON(): GraphQLFormattedError;
 }
-/**
- * See: https://spec.graphql.org/draft/#sec-Errors
- */
+/** See: https://spec.graphql.org/draft/#sec-Errors */
 export interface GraphQLFormattedError {
     /**
      * A short, human-readable summary of the problem that **SHOULD NOT** change

package/error/GraphQLError.js

@@ -4,37 +4,31 @@ exports.GraphQLError = void 0;
 const isObjectLike_ts_1 = require("../jsutils/isObjectLike.js");
 const location_ts_1 = require("../language/location.js");
 const printLocation_ts_1 = require("../language/printLocation.js");
-/**
- * A GraphQLError describes an Error found during the parse, validate, or
- * execute phases of performing a GraphQL operation. In addition to a message
- * and stack trace, it also includes information about the locations in a
- * GraphQL document and/or execution result that correspond to the Error.
- */
 class GraphQLError extends Error {
     constructor(message, options = {}) {
-        const { nodes, source, positions, path, originalError, extensions } = options;
-        super(message);
+        const { nodes, source, positions, path, originalError, cause, extensions } = options;
+        const hasCause = 'cause' in options;
+        const errorCause = hasCause ? cause : originalError;
+        const errorOptions = hasCause || originalError != null ? { cause: errorCause } : undefined;
+        super(message, errorOptions);
         this.name = 'GraphQLError';
         this.path = path ?? undefined;
-        this.originalError = originalError ?? undefined;
-        // Compute list of blame nodes.
+        const underlyingError = originalError ?? (errorCause instanceof Error ? errorCause : undefined);
+        this.originalError = underlyingError;
         this.nodes = undefinedIfEmpty(Array.isArray(nodes) ? nodes : nodes ? [nodes] : undefined);
         const nodeLocations = undefinedIfEmpty(this.nodes
             ?.map((node) => node.loc)
             .filter((loc) => loc != null));
-        // Compute locations in the source for the given nodes/positions.
         this.source = source ?? nodeLocations?.[0]?.source;
         this.positions = positions ?? nodeLocations?.map((loc) => loc.start);
         this.locations =
             positions && source
                 ? positions.map((pos) => (0, location_ts_1.getLocation)(source, pos))
                 : nodeLocations?.map((loc) => (0, location_ts_1.getLocation)(loc.source, loc.start));
-        const originalExtensions = (0, isObjectLike_ts_1.isObjectLike)(originalError?.extensions)
-            ? originalError?.extensions
+        const originalExtensions = (0, isObjectLike_ts_1.isObjectLike)(underlyingError?.extensions)
+            ? underlyingError.extensions
             : undefined;
         this.extensions = extensions ?? originalExtensions ?? Object.create(null);
-        // Only properties prescribed by the spec should be enumerable.
-        // Keep the rest as non-enumerable.
         Object.defineProperties(this, {
             message: {
                 writable: true,
@@ -46,18 +40,15 @@ class GraphQLError extends Error {
             positions: { enumerable: false },
             originalError: { enumerable: false },
         });
-        // Include (non-enumerable) stack trace.
-        if (originalError?.stack != null) {
+        if (underlyingError?.stack != null) {
             Object.defineProperty(this, 'stack', {
-                value: originalError.stack,
+                value: underlyingError.stack,
                 writable: true,
                 configurable: true,
             });
         }
         else if (Error.captureStackTrace != null) {
             Error.captureStackTrace(this, GraphQLError);
-            // See: https://github.com/graphql/graphql-js/issues/2317
-            /* node:coverage ignore next 7 */
         }
         else {
             Object.defineProperty(this, 'stack', {

package/error/GraphQLError.js.map

@@ -1 +1 @@
-{"version":3,"file":"GraphQLError.js","sourceRoot":"","sources":["../../src/error/GraphQLError.ts"],"names":[],"mappings":"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","sourcesContent":["import { isObjectLike } from '../jsutils/isObjectLike.ts';\nimport type { Maybe } from '../jsutils/Maybe.ts';\n\nimport type { ASTNode, Location } from '../language/ast.ts';\nimport type { SourceLocation } from '../language/location.ts';\nimport { getLocation } from '../language/location.ts';\nimport {\n  printLocation,\n  printSourceLocation,\n} from '../language/printLocation.ts';\nimport type { Source } from '../language/source.ts';\n\n/**\n * Custom extensions\n *\n * @remarks\n * Use a unique identifier name for your extension, for example the name of\n * your library or project. Do not use a shortened identifier as this increases\n * the risk of conflicts. We recommend you add at most one extension field,\n * an object which can contain all the values you need.\n */\nexport interface GraphQLErrorExtensions {\n  [attributeName: string]: unknown;\n}\n\n/**\n * Custom formatted extensions\n *\n * @remarks\n * Use a unique identifier name for your extension, for example the name of\n * your library or project. Do not use a shortened identifier as this increases\n * the risk of conflicts. We recommend you add at most one extension field,\n * an object which can contain all the values you need.\n */\nexport interface GraphQLFormattedErrorExtensions {\n  [attributeName: string]: unknown;\n}\n\nexport interface GraphQLErrorOptions {\n  nodes?: ReadonlyArray<ASTNode> | ASTNode | null | undefined;\n  source?: Maybe<Source>;\n  positions?: Maybe<ReadonlyArray<number>>;\n  path?: Maybe<ReadonlyArray<string | number>>;\n  originalError?: Maybe<Error & { readonly extensions?: unknown }>;\n  extensions?: Maybe<GraphQLErrorExtensions>;\n}\n\n/**\n * A GraphQLError describes an Error found during the parse, validate, or\n * execute phases of performing a GraphQL operation. In addition to a message\n * and stack trace, it also includes information about the locations in a\n * GraphQL document and/or execution result that correspond to the Error.\n */\nexport class GraphQLError extends Error {\n  /**\n   * An array of `{ line, column }` locations within the source GraphQL document\n   * which correspond to this error.\n   *\n   * Errors during validation often contain multiple locations, for example to\n   * point out two things with the same name. Errors during execution include a\n   * single location, the field which produced the error.\n   *\n   * Enumerable, and appears in the result of JSON.stringify().\n   */\n  readonly locations: ReadonlyArray<SourceLocation> | undefined;\n\n  /**\n   * An array describing the JSON-path into the execution response which\n   * corresponds to this error. Only included for errors during execution.\n   *\n   * Enumerable, and appears in the result of JSON.stringify().\n   */\n  readonly path: ReadonlyArray<string | number> | undefined;\n\n  /**\n   * An array of GraphQL AST Nodes corresponding to this error.\n   */\n  readonly nodes: ReadonlyArray<ASTNode> | undefined;\n\n  /**\n   * The source GraphQL document for the first location of this error.\n   *\n   * Note that if this Error represents more than one node, the source may not\n   * represent nodes after the first node.\n   */\n  readonly source: Source | undefined;\n\n  /**\n   * An array of character offsets within the source GraphQL document\n   * which correspond to this error.\n   */\n  readonly positions: ReadonlyArray<number> | undefined;\n\n  /**\n   * The original error thrown from a field resolver during execution.\n   */\n  readonly originalError: Error | undefined;\n\n  /**\n   * Extension fields to add to the formatted error.\n   */\n  readonly extensions: GraphQLErrorExtensions;\n\n  constructor(message: string, options: GraphQLErrorOptions = {}) {\n    const { nodes, source, positions, path, originalError, extensions } =\n      options;\n\n    super(message);\n\n    this.name = 'GraphQLError';\n    this.path = path ?? undefined;\n    this.originalError = originalError ?? undefined;\n\n    // Compute list of blame nodes.\n    this.nodes = undefinedIfEmpty(\n      Array.isArray(nodes) ? nodes : nodes ? [nodes] : undefined,\n    );\n\n    const nodeLocations = undefinedIfEmpty(\n      this.nodes\n        ?.map((node) => node.loc)\n        .filter((loc): loc is Location => loc != null),\n    );\n\n    // Compute locations in the source for the given nodes/positions.\n    this.source = source ?? nodeLocations?.[0]?.source;\n\n    this.positions = positions ?? nodeLocations?.map((loc) => loc.start);\n\n    this.locations =\n      positions && source\n        ? positions.map((pos) => getLocation(source, pos))\n        : nodeLocations?.map((loc) => getLocation(loc.source, loc.start));\n\n    const originalExtensions = isObjectLike(originalError?.extensions)\n      ? originalError?.extensions\n      : undefined;\n    this.extensions = extensions ?? originalExtensions ?? Object.create(null);\n\n    // Only properties prescribed by the spec should be enumerable.\n    // Keep the rest as non-enumerable.\n    Object.defineProperties(this, {\n      message: {\n        writable: true,\n        enumerable: true,\n      },\n      name: { enumerable: false },\n      nodes: { enumerable: false },\n      source: { enumerable: false },\n      positions: { enumerable: false },\n      originalError: { enumerable: false },\n    });\n\n    // Include (non-enumerable) stack trace.\n    if (originalError?.stack != null) {\n      Object.defineProperty(this, 'stack', {\n        value: originalError.stack,\n        writable: true,\n        configurable: true,\n      });\n    } else if (Error.captureStackTrace != null) {\n      Error.captureStackTrace(this, GraphQLError);\n      // See: https://github.com/graphql/graphql-js/issues/2317\n      /* node:coverage ignore next 7 */\n    } else {\n      Object.defineProperty(this, 'stack', {\n        value: Error().stack,\n        writable: true,\n        configurable: true,\n      });\n    }\n  }\n\n  get [Symbol.toStringTag](): string {\n    return 'GraphQLError';\n  }\n\n  override toString(): string {\n    let output = this.message;\n\n    if (this.nodes) {\n      for (const node of this.nodes) {\n        if (node.loc) {\n          output += '\\n\\n' + printLocation(node.loc);\n        }\n      }\n    } else if (this.source && this.locations) {\n      for (const location of this.locations) {\n        output += '\\n\\n' + printSourceLocation(this.source, location);\n      }\n    }\n\n    return output;\n  }\n\n  toJSON(): GraphQLFormattedError {\n    type WritableFormattedError = {\n      -readonly [P in keyof GraphQLFormattedError]: GraphQLFormattedError[P];\n    };\n\n    const formattedError: WritableFormattedError = {\n      message: this.message,\n    };\n\n    if (this.locations != null) {\n      formattedError.locations = this.locations;\n    }\n\n    if (this.path != null) {\n      formattedError.path = this.path;\n    }\n\n    if (this.extensions != null && Object.keys(this.extensions).length > 0) {\n      formattedError.extensions = this.extensions;\n    }\n\n    return formattedError;\n  }\n}\n\nfunction undefinedIfEmpty<T>(\n  array: Array<T> | undefined,\n): Array<T> | undefined {\n  return array === undefined || array.length === 0 ? undefined : array;\n}\n\n/**\n * See: https://spec.graphql.org/draft/#sec-Errors\n */\nexport interface GraphQLFormattedError {\n  /**\n   * A short, human-readable summary of the problem that **SHOULD NOT** change\n   * from occurrence to occurrence of the problem, except for purposes of\n   * localization.\n   */\n  readonly message: string;\n  /**\n   * If an error can be associated to a particular point in the requested\n   * GraphQL document, it should contain a list of locations.\n   */\n  readonly locations?: ReadonlyArray<SourceLocation>;\n  /**\n   * If an error can be associated to a particular field in the GraphQL result,\n   * it _must_ contain an entry with the key `path` that details the path of\n   * the response field which experienced the error. This allows clients to\n   * identify whether a null result is intentional or caused by a runtime error.\n   */\n  readonly path?: ReadonlyArray<string | number>;\n  /**\n   * Reserved for implementors to extend the protocol however they see fit,\n   * and hence there are no additional restrictions on its contents.\n   */\n  readonly extensions?: GraphQLFormattedErrorExtensions;\n}\n"]}
+{"version":3,"file":"GraphQLError.js","sourceRoot":"","sources":["../../src/error/GraphQLError.ts"],"names":[],"mappings":"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","sourcesContent":["/** @category Errors */\n\nimport { isObjectLike } from '../jsutils/isObjectLike.ts';\nimport type { Maybe } from '../jsutils/Maybe.ts';\n\nimport type { ASTNode, Location } from '../language/ast.ts';\nimport type { SourceLocation } from '../language/location.ts';\nimport { getLocation } from '../language/location.ts';\nimport {\n  printLocation,\n  printSourceLocation,\n} from '../language/printLocation.ts';\nimport type { Source } from '../language/source.ts';\n\n/**\n * Custom extensions\n * @remarks\n * Use a unique identifier name for your extension, for example the name of\n * your library or project. Do not use a shortened identifier as this increases\n * the risk of conflicts. We recommend you add at most one extension field,\n * an object which can contain all the values you need.\n */\nexport interface GraphQLErrorExtensions {\n  [attributeName: string]: unknown;\n}\n\n/**\n * Custom formatted extensions\n * @remarks\n * Use a unique identifier name for your extension, for example the name of\n * your library or project. Do not use a shortened identifier as this increases\n * the risk of conflicts. We recommend you add at most one extension field,\n * an object which can contain all the values you need.\n */\nexport interface GraphQLFormattedErrorExtensions {\n  [attributeName: string]: unknown;\n}\n\n/** Options used to construct a GraphQLError. */\nexport interface GraphQLErrorOptions {\n  /** AST node or nodes associated with this error. */\n  nodes?: ReadonlyArray<ASTNode> | ASTNode | null | undefined;\n  /** Source document used to derive error locations. */\n  source?: Maybe<Source>;\n  /** Character offsets in the source document associated with this error. */\n  positions?: Maybe<ReadonlyArray<number>>;\n  /** Response path where this error occurred during execution. */\n  path?: Maybe<ReadonlyArray<string | number>>;\n  /**\n   * Original error that caused this GraphQLError, if one exists.\n   * @deprecated Prefer `cause` instead.\n   */\n  originalError?: Maybe<Error & { readonly extensions?: unknown }>;\n  /** Cause of this GraphQLError, if one exists. */\n  cause?: unknown;\n  /** Extension fields to include in the formatted result. */\n  extensions?: Maybe<GraphQLErrorExtensions>;\n}\n\n/**\n * A GraphQLError describes an Error found during the parse, validate, or\n * execute phases of performing a GraphQL operation. In addition to a message\n * and stack trace, it also includes information about the locations in a\n * GraphQL document and/or execution result that correspond to the Error.\n */\nexport class GraphQLError extends Error {\n  /**\n   * An array of `{ line, column }` locations within the source GraphQL document\n   * which correspond to this error.\n   *\n   * Errors during validation often contain multiple locations, for example to\n   * point out two things with the same name. Errors during execution include a\n   * single location, the field which produced the error.\n   *\n   * Enumerable, and appears in the result of JSON.stringify().\n   */\n  readonly locations: ReadonlyArray<SourceLocation> | undefined;\n\n  /**\n   * An array describing the JSON-path into the execution response which\n   * corresponds to this error. Only included for errors during execution.\n   *\n   * Enumerable, and appears in the result of JSON.stringify().\n   */\n  readonly path: ReadonlyArray<string | number> | undefined;\n\n  /** An array of GraphQL AST Nodes corresponding to this error. */\n  readonly nodes: ReadonlyArray<ASTNode> | undefined;\n\n  /**\n   * The source GraphQL document for the first location of this error.\n   *\n   * Note that if this Error represents more than one node, the source may not\n   * represent nodes after the first node.\n   */\n  readonly source: Source | undefined;\n\n  /**\n   * An array of character offsets within the source GraphQL document\n   * which correspond to this error.\n   */\n  readonly positions: ReadonlyArray<number> | undefined;\n\n  /**\n   * The original error thrown from a field resolver during execution.\n   * @deprecated Use `cause` instead.\n   */\n  readonly originalError: Error | undefined;\n\n  /** Extension fields to add to the formatted error. */\n  readonly extensions: GraphQLErrorExtensions;\n\n  /**\n   * Creates a GraphQLError instance.\n   * @param message - Human-readable error message.\n   * @param options - Error metadata such as source locations, response path, cause, original error, and extensions.\n   * @example\n   * ```ts\n   * // Create an error from AST nodes and response metadata.\n   * import { parse } from 'graphql/language';\n   * import { GraphQLError } from 'graphql/error';\n   *\n   * const document = parse('{ greeting }');\n   * const fieldNode = document.definitions[0].selectionSet.selections[0];\n   * const error = new GraphQLError('Cannot query this field.', {\n   *   nodes: fieldNode,\n   *   path: ['greeting'],\n   *   extensions: { code: 'FORBIDDEN' },\n   * });\n   *\n   * error.message; // => 'Cannot query this field.'\n   * error.locations; // => [{ line: 1, column: 3 }]\n   * error.path; // => ['greeting']\n   * error.extensions; // => { code: 'FORBIDDEN' }\n   * ```\n   * @example\n   * ```ts\n   * // This variant derives locations from source positions and preserves the cause.\n   * import { Source } from 'graphql/language';\n   * import { GraphQLError } from 'graphql/error';\n   *\n   * const source = new Source('{ greeting }');\n   * const cause = new Error('Database unavailable.');\n   * const error = new GraphQLError('Resolver failed.', {\n   *   source,\n   *   positions: [2],\n   *   path: ['greeting'],\n   *   cause,\n   * });\n   *\n   * error.locations; // => [{ line: 1, column: 3 }]\n   * error.path; // => ['greeting']\n   * error.cause; // => cause\n   * ```\n   */\n  constructor(message: string, options: GraphQLErrorOptions = {}) {\n    const { nodes, source, positions, path, originalError, cause, extensions } =\n      options;\n\n    const hasCause = 'cause' in options;\n    const errorCause = hasCause ? cause : originalError;\n    const errorOptions =\n      hasCause || originalError != null ? { cause: errorCause } : undefined;\n    super(message, errorOptions);\n\n    this.name = 'GraphQLError';\n    this.path = path ?? undefined;\n    const underlyingError:\n      | (Error & { readonly extensions?: unknown })\n      | undefined =\n      originalError ?? (errorCause instanceof Error ? errorCause : undefined);\n    this.originalError = underlyingError;\n\n    // Compute list of blame nodes.\n    this.nodes = undefinedIfEmpty(\n      Array.isArray(nodes) ? nodes : nodes ? [nodes] : undefined,\n    );\n\n    const nodeLocations = undefinedIfEmpty(\n      this.nodes\n        ?.map((node) => node.loc)\n        .filter((loc): loc is Location => loc != null),\n    );\n\n    // Compute locations in the source for the given nodes/positions.\n    this.source = source ?? nodeLocations?.[0]?.source;\n\n    this.positions = positions ?? nodeLocations?.map((loc) => loc.start);\n\n    this.locations =\n      positions && source\n        ? positions.map((pos) => getLocation(source, pos))\n        : nodeLocations?.map((loc) => getLocation(loc.source, loc.start));\n\n    const originalExtensions = isObjectLike(underlyingError?.extensions)\n      ? underlyingError.extensions\n      : undefined;\n    this.extensions = extensions ?? originalExtensions ?? Object.create(null);\n\n    // Only properties prescribed by the spec should be enumerable.\n    // Keep the rest as non-enumerable.\n    Object.defineProperties(this, {\n      message: {\n        writable: true,\n        enumerable: true,\n      },\n      name: { enumerable: false },\n      nodes: { enumerable: false },\n      source: { enumerable: false },\n      positions: { enumerable: false },\n      originalError: { enumerable: false },\n    });\n\n    // Include (non-enumerable) stack trace.\n    if (underlyingError?.stack != null) {\n      Object.defineProperty(this, 'stack', {\n        value: underlyingError.stack,\n        writable: true,\n        configurable: true,\n      });\n    } else if (Error.captureStackTrace != null) {\n      Error.captureStackTrace(this, GraphQLError);\n      // See: https://github.com/graphql/graphql-js/issues/2317\n      /* node:coverage ignore next 7 */\n    } else {\n      Object.defineProperty(this, 'stack', {\n        value: Error().stack,\n        writable: true,\n        configurable: true,\n      });\n    }\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 'GraphQLError';\n  }\n\n  /**\n   * Returns this error as a human-readable message with source locations.\n   * @returns The formatted error string.\n   * @example\n   * ```ts\n   * import { Source } from 'graphql/language';\n   * import { GraphQLError } from 'graphql/error';\n   *\n   * const error = new GraphQLError('Cannot query field \"name\".', {\n   *   source: new Source('{ name }'),\n   *   positions: [2],\n   * });\n   *\n   * error.toString(); // => 'Cannot query field \"name\".\\n\\nGraphQL request:1:3\\n1 | { name }\\n  |   ^'\n   * ```\n   */\n  override toString(): string {\n    let output = this.message;\n\n    if (this.nodes) {\n      for (const node of this.nodes) {\n        if (node.loc) {\n          output += '\\n\\n' + printLocation(node.loc);\n        }\n      }\n    } else if (this.source && this.locations) {\n      for (const location of this.locations) {\n        output += '\\n\\n' + printSourceLocation(this.source, location);\n      }\n    }\n\n    return output;\n  }\n\n  /**\n   * Returns the JSON representation used when this object is serialized.\n   * @returns The JSON-serializable representation.\n   * @example\n   * ```ts\n   * import { GraphQLError } from 'graphql/error';\n   *\n   * const error = new GraphQLError('Resolver failed.', {\n   *   path: ['viewer', 'name'],\n   *   extensions: { code: 'INTERNAL' },\n   * });\n   *\n   * error.toJSON(); // => { message: 'Resolver failed.', path: ['viewer', 'name'], extensions: { code: 'INTERNAL' } }\n   * ```\n   */\n  toJSON(): GraphQLFormattedError {\n    type WritableFormattedError = {\n      -readonly [P in keyof GraphQLFormattedError]: GraphQLFormattedError[P];\n    };\n\n    const formattedError: WritableFormattedError = {\n      message: this.message,\n    };\n\n    if (this.locations != null) {\n      formattedError.locations = this.locations;\n    }\n\n    if (this.path != null) {\n      formattedError.path = this.path;\n    }\n\n    if (this.extensions != null && Object.keys(this.extensions).length > 0) {\n      formattedError.extensions = this.extensions;\n    }\n\n    return formattedError;\n  }\n}\n\nfunction undefinedIfEmpty<T>(\n  array: Array<T> | undefined,\n): Array<T> | undefined {\n  return array === undefined || array.length === 0 ? undefined : array;\n}\n\n/** See: https://spec.graphql.org/draft/#sec-Errors */\nexport interface GraphQLFormattedError {\n  /**\n   * A short, human-readable summary of the problem that **SHOULD NOT** change\n   * from occurrence to occurrence of the problem, except for purposes of\n   * localization.\n   */\n  readonly message: string;\n  /**\n   * If an error can be associated to a particular point in the requested\n   * GraphQL document, it should contain a list of locations.\n   */\n  readonly locations?: ReadonlyArray<SourceLocation>;\n  /**\n   * If an error can be associated to a particular field in the GraphQL result,\n   * it _must_ contain an entry with the key `path` that details the path of\n   * the response field which experienced the error. This allows clients to\n   * identify whether a null result is intentional or caused by a runtime error.\n   */\n  readonly path?: ReadonlyArray<string | number>;\n  /**\n   * Reserved for implementors to extend the protocol however they see fit,\n   * and hence there are no additional restrictions on its contents.\n   */\n  readonly extensions?: GraphQLFormattedErrorExtensions;\n}\n"]}

package/error/GraphQLError.mjs

@@ -1,37 +1,31 @@
 import { isObjectLike } from "../jsutils/isObjectLike.mjs";
 import { getLocation } from "../language/location.mjs";
 import { printLocation, printSourceLocation, } from "../language/printLocation.mjs";
-/**
- * A GraphQLError describes an Error found during the parse, validate, or
- * execute phases of performing a GraphQL operation. In addition to a message
- * and stack trace, it also includes information about the locations in a
- * GraphQL document and/or execution result that correspond to the Error.
- */
 export class GraphQLError extends Error {
     constructor(message, options = {}) {
-        const { nodes, source, positions, path, originalError, extensions } = options;
-        super(message);
+        const { nodes, source, positions, path, originalError, cause, extensions } = options;
+        const hasCause = 'cause' in options;
+        const errorCause = hasCause ? cause : originalError;
+        const errorOptions = hasCause || originalError != null ? { cause: errorCause } : undefined;
+        super(message, errorOptions);
         this.name = 'GraphQLError';
         this.path = path ?? undefined;
-        this.originalError = originalError ?? undefined;
-        // Compute list of blame nodes.
+        const underlyingError = originalError ?? (errorCause instanceof Error ? errorCause : undefined);
+        this.originalError = underlyingError;
         this.nodes = undefinedIfEmpty(Array.isArray(nodes) ? nodes : nodes ? [nodes] : undefined);
         const nodeLocations = undefinedIfEmpty(this.nodes
             ?.map((node) => node.loc)
             .filter((loc) => loc != null));
-        // Compute locations in the source for the given nodes/positions.
         this.source = source ?? nodeLocations?.[0]?.source;
         this.positions = positions ?? nodeLocations?.map((loc) => loc.start);
         this.locations =
             positions && source
                 ? positions.map((pos) => getLocation(source, pos))
                 : nodeLocations?.map((loc) => getLocation(loc.source, loc.start));
-        const originalExtensions = isObjectLike(originalError?.extensions)
-            ? originalError?.extensions
+        const originalExtensions = isObjectLike(underlyingError?.extensions)
+            ? underlyingError.extensions
             : undefined;
         this.extensions = extensions ?? originalExtensions ?? Object.create(null);
-        // Only properties prescribed by the spec should be enumerable.
-        // Keep the rest as non-enumerable.
         Object.defineProperties(this, {
             message: {
                 writable: true,
@@ -43,18 +37,15 @@ export class GraphQLError extends Error {
             positions: { enumerable: false },
             originalError: { enumerable: false },
         });
-        // Include (non-enumerable) stack trace.
-        if (originalError?.stack != null) {
+        if (underlyingError?.stack != null) {
             Object.defineProperty(this, 'stack', {
-                value: originalError.stack,
+                value: underlyingError.stack,
                 writable: true,
                 configurable: true,
             });
         }
         else if (Error.captureStackTrace != null) {
             Error.captureStackTrace(this, GraphQLError);
-            // See: https://github.com/graphql/graphql-js/issues/2317
-            /* node:coverage ignore next 7 */
         }
         else {
             Object.defineProperty(this, 'stack', {

package/error/GraphQLError.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"GraphQLError.js","sourceRoot":"","sources":["../../src/error/GraphQLError.ts"],"names":[],"mappings":"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","sourcesContent":["import { isObjectLike } from '../jsutils/isObjectLike.ts';\nimport type { Maybe } from '../jsutils/Maybe.ts';\n\nimport type { ASTNode, Location } from '../language/ast.ts';\nimport type { SourceLocation } from '../language/location.ts';\nimport { getLocation } from '../language/location.ts';\nimport {\n  printLocation,\n  printSourceLocation,\n} from '../language/printLocation.ts';\nimport type { Source } from '../language/source.ts';\n\n/**\n * Custom extensions\n *\n * @remarks\n * Use a unique identifier name for your extension, for example the name of\n * your library or project. Do not use a shortened identifier as this increases\n * the risk of conflicts. We recommend you add at most one extension field,\n * an object which can contain all the values you need.\n */\nexport interface GraphQLErrorExtensions {\n  [attributeName: string]: unknown;\n}\n\n/**\n * Custom formatted extensions\n *\n * @remarks\n * Use a unique identifier name for your extension, for example the name of\n * your library or project. Do not use a shortened identifier as this increases\n * the risk of conflicts. We recommend you add at most one extension field,\n * an object which can contain all the values you need.\n */\nexport interface GraphQLFormattedErrorExtensions {\n  [attributeName: string]: unknown;\n}\n\nexport interface GraphQLErrorOptions {\n  nodes?: ReadonlyArray<ASTNode> | ASTNode | null | undefined;\n  source?: Maybe<Source>;\n  positions?: Maybe<ReadonlyArray<number>>;\n  path?: Maybe<ReadonlyArray<string | number>>;\n  originalError?: Maybe<Error & { readonly extensions?: unknown }>;\n  extensions?: Maybe<GraphQLErrorExtensions>;\n}\n\n/**\n * A GraphQLError describes an Error found during the parse, validate, or\n * execute phases of performing a GraphQL operation. In addition to a message\n * and stack trace, it also includes information about the locations in a\n * GraphQL document and/or execution result that correspond to the Error.\n */\nexport class GraphQLError extends Error {\n  /**\n   * An array of `{ line, column }` locations within the source GraphQL document\n   * which correspond to this error.\n   *\n   * Errors during validation often contain multiple locations, for example to\n   * point out two things with the same name. Errors during execution include a\n   * single location, the field which produced the error.\n   *\n   * Enumerable, and appears in the result of JSON.stringify().\n   */\n  readonly locations: ReadonlyArray<SourceLocation> | undefined;\n\n  /**\n   * An array describing the JSON-path into the execution response which\n   * corresponds to this error. Only included for errors during execution.\n   *\n   * Enumerable, and appears in the result of JSON.stringify().\n   */\n  readonly path: ReadonlyArray<string | number> | undefined;\n\n  /**\n   * An array of GraphQL AST Nodes corresponding to this error.\n   */\n  readonly nodes: ReadonlyArray<ASTNode> | undefined;\n\n  /**\n   * The source GraphQL document for the first location of this error.\n   *\n   * Note that if this Error represents more than one node, the source may not\n   * represent nodes after the first node.\n   */\n  readonly source: Source | undefined;\n\n  /**\n   * An array of character offsets within the source GraphQL document\n   * which correspond to this error.\n   */\n  readonly positions: ReadonlyArray<number> | undefined;\n\n  /**\n   * The original error thrown from a field resolver during execution.\n   */\n  readonly originalError: Error | undefined;\n\n  /**\n   * Extension fields to add to the formatted error.\n   */\n  readonly extensions: GraphQLErrorExtensions;\n\n  constructor(message: string, options: GraphQLErrorOptions = {}) {\n    const { nodes, source, positions, path, originalError, extensions } =\n      options;\n\n    super(message);\n\n    this.name = 'GraphQLError';\n    this.path = path ?? undefined;\n    this.originalError = originalError ?? undefined;\n\n    // Compute list of blame nodes.\n    this.nodes = undefinedIfEmpty(\n      Array.isArray(nodes) ? nodes : nodes ? [nodes] : undefined,\n    );\n\n    const nodeLocations = undefinedIfEmpty(\n      this.nodes\n        ?.map((node) => node.loc)\n        .filter((loc): loc is Location => loc != null),\n    );\n\n    // Compute locations in the source for the given nodes/positions.\n    this.source = source ?? nodeLocations?.[0]?.source;\n\n    this.positions = positions ?? nodeLocations?.map((loc) => loc.start);\n\n    this.locations =\n      positions && source\n        ? positions.map((pos) => getLocation(source, pos))\n        : nodeLocations?.map((loc) => getLocation(loc.source, loc.start));\n\n    const originalExtensions = isObjectLike(originalError?.extensions)\n      ? originalError?.extensions\n      : undefined;\n    this.extensions = extensions ?? originalExtensions ?? Object.create(null);\n\n    // Only properties prescribed by the spec should be enumerable.\n    // Keep the rest as non-enumerable.\n    Object.defineProperties(this, {\n      message: {\n        writable: true,\n        enumerable: true,\n      },\n      name: { enumerable: false },\n      nodes: { enumerable: false },\n      source: { enumerable: false },\n      positions: { enumerable: false },\n      originalError: { enumerable: false },\n    });\n\n    // Include (non-enumerable) stack trace.\n    if (originalError?.stack != null) {\n      Object.defineProperty(this, 'stack', {\n        value: originalError.stack,\n        writable: true,\n        configurable: true,\n      });\n    } else if (Error.captureStackTrace != null) {\n      Error.captureStackTrace(this, GraphQLError);\n      // See: https://github.com/graphql/graphql-js/issues/2317\n      /* node:coverage ignore next 7 */\n    } else {\n      Object.defineProperty(this, 'stack', {\n        value: Error().stack,\n        writable: true,\n        configurable: true,\n      });\n    }\n  }\n\n  get [Symbol.toStringTag](): string {\n    return 'GraphQLError';\n  }\n\n  override toString(): string {\n    let output = this.message;\n\n    if (this.nodes) {\n      for (const node of this.nodes) {\n        if (node.loc) {\n          output += '\\n\\n' + printLocation(node.loc);\n        }\n      }\n    } else if (this.source && this.locations) {\n      for (const location of this.locations) {\n        output += '\\n\\n' + printSourceLocation(this.source, location);\n      }\n    }\n\n    return output;\n  }\n\n  toJSON(): GraphQLFormattedError {\n    type WritableFormattedError = {\n      -readonly [P in keyof GraphQLFormattedError]: GraphQLFormattedError[P];\n    };\n\n    const formattedError: WritableFormattedError = {\n      message: this.message,\n    };\n\n    if (this.locations != null) {\n      formattedError.locations = this.locations;\n    }\n\n    if (this.path != null) {\n      formattedError.path = this.path;\n    }\n\n    if (this.extensions != null && Object.keys(this.extensions).length > 0) {\n      formattedError.extensions = this.extensions;\n    }\n\n    return formattedError;\n  }\n}\n\nfunction undefinedIfEmpty<T>(\n  array: Array<T> | undefined,\n): Array<T> | undefined {\n  return array === undefined || array.length === 0 ? undefined : array;\n}\n\n/**\n * See: https://spec.graphql.org/draft/#sec-Errors\n */\nexport interface GraphQLFormattedError {\n  /**\n   * A short, human-readable summary of the problem that **SHOULD NOT** change\n   * from occurrence to occurrence of the problem, except for purposes of\n   * localization.\n   */\n  readonly message: string;\n  /**\n   * If an error can be associated to a particular point in the requested\n   * GraphQL document, it should contain a list of locations.\n   */\n  readonly locations?: ReadonlyArray<SourceLocation>;\n  /**\n   * If an error can be associated to a particular field in the GraphQL result,\n   * it _must_ contain an entry with the key `path` that details the path of\n   * the response field which experienced the error. This allows clients to\n   * identify whether a null result is intentional or caused by a runtime error.\n   */\n  readonly path?: ReadonlyArray<string | number>;\n  /**\n   * Reserved for implementors to extend the protocol however they see fit,\n   * and hence there are no additional restrictions on its contents.\n   */\n  readonly extensions?: GraphQLFormattedErrorExtensions;\n}\n"]}
+{"version":3,"file":"GraphQLError.js","sourceRoot":"","sources":["../../src/error/GraphQLError.ts"],"names":[],"mappings":"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","sourcesContent":["/** @category Errors */\n\nimport { isObjectLike } from '../jsutils/isObjectLike.ts';\nimport type { Maybe } from '../jsutils/Maybe.ts';\n\nimport type { ASTNode, Location } from '../language/ast.ts';\nimport type { SourceLocation } from '../language/location.ts';\nimport { getLocation } from '../language/location.ts';\nimport {\n  printLocation,\n  printSourceLocation,\n} from '../language/printLocation.ts';\nimport type { Source } from '../language/source.ts';\n\n/**\n * Custom extensions\n * @remarks\n * Use a unique identifier name for your extension, for example the name of\n * your library or project. Do not use a shortened identifier as this increases\n * the risk of conflicts. We recommend you add at most one extension field,\n * an object which can contain all the values you need.\n */\nexport interface GraphQLErrorExtensions {\n  [attributeName: string]: unknown;\n}\n\n/**\n * Custom formatted extensions\n * @remarks\n * Use a unique identifier name for your extension, for example the name of\n * your library or project. Do not use a shortened identifier as this increases\n * the risk of conflicts. We recommend you add at most one extension field,\n * an object which can contain all the values you need.\n */\nexport interface GraphQLFormattedErrorExtensions {\n  [attributeName: string]: unknown;\n}\n\n/** Options used to construct a GraphQLError. */\nexport interface GraphQLErrorOptions {\n  /** AST node or nodes associated with this error. */\n  nodes?: ReadonlyArray<ASTNode> | ASTNode | null | undefined;\n  /** Source document used to derive error locations. */\n  source?: Maybe<Source>;\n  /** Character offsets in the source document associated with this error. */\n  positions?: Maybe<ReadonlyArray<number>>;\n  /** Response path where this error occurred during execution. */\n  path?: Maybe<ReadonlyArray<string | number>>;\n  /**\n   * Original error that caused this GraphQLError, if one exists.\n   * @deprecated Prefer `cause` instead.\n   */\n  originalError?: Maybe<Error & { readonly extensions?: unknown }>;\n  /** Cause of this GraphQLError, if one exists. */\n  cause?: unknown;\n  /** Extension fields to include in the formatted result. */\n  extensions?: Maybe<GraphQLErrorExtensions>;\n}\n\n/**\n * A GraphQLError describes an Error found during the parse, validate, or\n * execute phases of performing a GraphQL operation. In addition to a message\n * and stack trace, it also includes information about the locations in a\n * GraphQL document and/or execution result that correspond to the Error.\n */\nexport class GraphQLError extends Error {\n  /**\n   * An array of `{ line, column }` locations within the source GraphQL document\n   * which correspond to this error.\n   *\n   * Errors during validation often contain multiple locations, for example to\n   * point out two things with the same name. Errors during execution include a\n   * single location, the field which produced the error.\n   *\n   * Enumerable, and appears in the result of JSON.stringify().\n   */\n  readonly locations: ReadonlyArray<SourceLocation> | undefined;\n\n  /**\n   * An array describing the JSON-path into the execution response which\n   * corresponds to this error. Only included for errors during execution.\n   *\n   * Enumerable, and appears in the result of JSON.stringify().\n   */\n  readonly path: ReadonlyArray<string | number> | undefined;\n\n  /** An array of GraphQL AST Nodes corresponding to this error. */\n  readonly nodes: ReadonlyArray<ASTNode> | undefined;\n\n  /**\n   * The source GraphQL document for the first location of this error.\n   *\n   * Note that if this Error represents more than one node, the source may not\n   * represent nodes after the first node.\n   */\n  readonly source: Source | undefined;\n\n  /**\n   * An array of character offsets within the source GraphQL document\n   * which correspond to this error.\n   */\n  readonly positions: ReadonlyArray<number> | undefined;\n\n  /**\n   * The original error thrown from a field resolver during execution.\n   * @deprecated Use `cause` instead.\n   */\n  readonly originalError: Error | undefined;\n\n  /** Extension fields to add to the formatted error. */\n  readonly extensions: GraphQLErrorExtensions;\n\n  /**\n   * Creates a GraphQLError instance.\n   * @param message - Human-readable error message.\n   * @param options - Error metadata such as source locations, response path, cause, original error, and extensions.\n   * @example\n   * ```ts\n   * // Create an error from AST nodes and response metadata.\n   * import { parse } from 'graphql/language';\n   * import { GraphQLError } from 'graphql/error';\n   *\n   * const document = parse('{ greeting }');\n   * const fieldNode = document.definitions[0].selectionSet.selections[0];\n   * const error = new GraphQLError('Cannot query this field.', {\n   *   nodes: fieldNode,\n   *   path: ['greeting'],\n   *   extensions: { code: 'FORBIDDEN' },\n   * });\n   *\n   * error.message; // => 'Cannot query this field.'\n   * error.locations; // => [{ line: 1, column: 3 }]\n   * error.path; // => ['greeting']\n   * error.extensions; // => { code: 'FORBIDDEN' }\n   * ```\n   * @example\n   * ```ts\n   * // This variant derives locations from source positions and preserves the cause.\n   * import { Source } from 'graphql/language';\n   * import { GraphQLError } from 'graphql/error';\n   *\n   * const source = new Source('{ greeting }');\n   * const cause = new Error('Database unavailable.');\n   * const error = new GraphQLError('Resolver failed.', {\n   *   source,\n   *   positions: [2],\n   *   path: ['greeting'],\n   *   cause,\n   * });\n   *\n   * error.locations; // => [{ line: 1, column: 3 }]\n   * error.path; // => ['greeting']\n   * error.cause; // => cause\n   * ```\n   */\n  constructor(message: string, options: GraphQLErrorOptions = {}) {\n    const { nodes, source, positions, path, originalError, cause, extensions } =\n      options;\n\n    const hasCause = 'cause' in options;\n    const errorCause = hasCause ? cause : originalError;\n    const errorOptions =\n      hasCause || originalError != null ? { cause: errorCause } : undefined;\n    super(message, errorOptions);\n\n    this.name = 'GraphQLError';\n    this.path = path ?? undefined;\n    const underlyingError:\n      | (Error & { readonly extensions?: unknown })\n      | undefined =\n      originalError ?? (errorCause instanceof Error ? errorCause : undefined);\n    this.originalError = underlyingError;\n\n    // Compute list of blame nodes.\n    this.nodes = undefinedIfEmpty(\n      Array.isArray(nodes) ? nodes : nodes ? [nodes] : undefined,\n    );\n\n    const nodeLocations = undefinedIfEmpty(\n      this.nodes\n        ?.map((node) => node.loc)\n        .filter((loc): loc is Location => loc != null),\n    );\n\n    // Compute locations in the source for the given nodes/positions.\n    this.source = source ?? nodeLocations?.[0]?.source;\n\n    this.positions = positions ?? nodeLocations?.map((loc) => loc.start);\n\n    this.locations =\n      positions && source\n        ? positions.map((pos) => getLocation(source, pos))\n        : nodeLocations?.map((loc) => getLocation(loc.source, loc.start));\n\n    const originalExtensions = isObjectLike(underlyingError?.extensions)\n      ? underlyingError.extensions\n      : undefined;\n    this.extensions = extensions ?? originalExtensions ?? Object.create(null);\n\n    // Only properties prescribed by the spec should be enumerable.\n    // Keep the rest as non-enumerable.\n    Object.defineProperties(this, {\n      message: {\n        writable: true,\n        enumerable: true,\n      },\n      name: { enumerable: false },\n      nodes: { enumerable: false },\n      source: { enumerable: false },\n      positions: { enumerable: false },\n      originalError: { enumerable: false },\n    });\n\n    // Include (non-enumerable) stack trace.\n    if (underlyingError?.stack != null) {\n      Object.defineProperty(this, 'stack', {\n        value: underlyingError.stack,\n        writable: true,\n        configurable: true,\n      });\n    } else if (Error.captureStackTrace != null) {\n      Error.captureStackTrace(this, GraphQLError);\n      // See: https://github.com/graphql/graphql-js/issues/2317\n      /* node:coverage ignore next 7 */\n    } else {\n      Object.defineProperty(this, 'stack', {\n        value: Error().stack,\n        writable: true,\n        configurable: true,\n      });\n    }\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 'GraphQLError';\n  }\n\n  /**\n   * Returns this error as a human-readable message with source locations.\n   * @returns The formatted error string.\n   * @example\n   * ```ts\n   * import { Source } from 'graphql/language';\n   * import { GraphQLError } from 'graphql/error';\n   *\n   * const error = new GraphQLError('Cannot query field \"name\".', {\n   *   source: new Source('{ name }'),\n   *   positions: [2],\n   * });\n   *\n   * error.toString(); // => 'Cannot query field \"name\".\\n\\nGraphQL request:1:3\\n1 | { name }\\n  |   ^'\n   * ```\n   */\n  override toString(): string {\n    let output = this.message;\n\n    if (this.nodes) {\n      for (const node of this.nodes) {\n        if (node.loc) {\n          output += '\\n\\n' + printLocation(node.loc);\n        }\n      }\n    } else if (this.source && this.locations) {\n      for (const location of this.locations) {\n        output += '\\n\\n' + printSourceLocation(this.source, location);\n      }\n    }\n\n    return output;\n  }\n\n  /**\n   * Returns the JSON representation used when this object is serialized.\n   * @returns The JSON-serializable representation.\n   * @example\n   * ```ts\n   * import { GraphQLError } from 'graphql/error';\n   *\n   * const error = new GraphQLError('Resolver failed.', {\n   *   path: ['viewer', 'name'],\n   *   extensions: { code: 'INTERNAL' },\n   * });\n   *\n   * error.toJSON(); // => { message: 'Resolver failed.', path: ['viewer', 'name'], extensions: { code: 'INTERNAL' } }\n   * ```\n   */\n  toJSON(): GraphQLFormattedError {\n    type WritableFormattedError = {\n      -readonly [P in keyof GraphQLFormattedError]: GraphQLFormattedError[P];\n    };\n\n    const formattedError: WritableFormattedError = {\n      message: this.message,\n    };\n\n    if (this.locations != null) {\n      formattedError.locations = this.locations;\n    }\n\n    if (this.path != null) {\n      formattedError.path = this.path;\n    }\n\n    if (this.extensions != null && Object.keys(this.extensions).length > 0) {\n      formattedError.extensions = this.extensions;\n    }\n\n    return formattedError;\n  }\n}\n\nfunction undefinedIfEmpty<T>(\n  array: Array<T> | undefined,\n): Array<T> | undefined {\n  return array === undefined || array.length === 0 ? undefined : array;\n}\n\n/** See: https://spec.graphql.org/draft/#sec-Errors */\nexport interface GraphQLFormattedError {\n  /**\n   * A short, human-readable summary of the problem that **SHOULD NOT** change\n   * from occurrence to occurrence of the problem, except for purposes of\n   * localization.\n   */\n  readonly message: string;\n  /**\n   * If an error can be associated to a particular point in the requested\n   * GraphQL document, it should contain a list of locations.\n   */\n  readonly locations?: ReadonlyArray<SourceLocation>;\n  /**\n   * If an error can be associated to a particular field in the GraphQL result,\n   * it _must_ contain an entry with the key `path` that details the path of\n   * the response field which experienced the error. This allows clients to\n   * identify whether a null result is intentional or caused by a runtime error.\n   */\n  readonly path?: ReadonlyArray<string | number>;\n  /**\n   * Reserved for implementors to extend the protocol however they see fit,\n   * and hence there are no additional restrictions on its contents.\n   */\n  readonly extensions?: GraphQLFormattedErrorExtensions;\n}\n"]}

package/error/ensureGraphQLError.d.mts

@@ -1,5 +1,7 @@
 import { GraphQLError } from "./GraphQLError.mjs";
 /**
  * Ensure an unknown thrown value is represented as a GraphQLError.
+ *
+ * @internal
  */
 export declare function ensureGraphQLError(rawError: unknown): GraphQLError;

package/error/ensureGraphQLError.d.ts

@@ -1,5 +1,7 @@
 import { GraphQLError } from "./GraphQLError.js";
 /**
  * Ensure an unknown thrown value is represented as a GraphQLError.
+ *
+ * @internal
  */
 export declare function ensureGraphQLError(rawError: unknown): GraphQLError;

package/error/ensureGraphQLError.js

@@ -3,9 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ensureGraphQLError = ensureGraphQLError;
 const toError_ts_1 = require("../jsutils/toError.js");
 const GraphQLError_ts_1 = require("./GraphQLError.js");
-/**
- * Ensure an unknown thrown value is represented as a GraphQLError.
- */
 function ensureGraphQLError(rawError) {
     if (rawError instanceof GraphQLError_ts_1.GraphQLError) {
         return rawError;

package/error/ensureGraphQLError.js.map

@@ -1 +1 @@
-{"version":3,"file":"ensureGraphQLError.js","sourceRoot":"","sources":["../../src/error/ensureGraphQLError.ts"],"names":[],"mappings":";;AAOA,gDAOC;AAdD,sDAAgD;AAEhD,uDAAiD;AAEjD;;GAEG;AACH,SAAgB,kBAAkB,CAAC,QAAiB;IAClD,IAAI,QAAQ,YAAY,8BAAY,EAAE,CAAC;QACrC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,aAAa,GAAG,IAAA,oBAAO,EAAC,QAAQ,CAAC,CAAC;IACxC,OAAO,IAAI,8BAAY,CAAC,aAAa,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;AACpE,CAAC","sourcesContent":["import { toError } from '../jsutils/toError.ts';\n\nimport { GraphQLError } from './GraphQLError.ts';\n\n/**\n * Ensure an unknown thrown value is represented as a GraphQLError.\n */\nexport function ensureGraphQLError(rawError: unknown): GraphQLError {\n  if (rawError instanceof GraphQLError) {\n    return rawError;\n  }\n\n  const originalError = toError(rawError);\n  return new GraphQLError(originalError.message, { originalError });\n}\n"]}
+{"version":3,"file":"ensureGraphQLError.js","sourceRoot":"","sources":["../../src/error/ensureGraphQLError.ts"],"names":[],"mappings":";;AASA,gDAOC;AAhBD,sDAAgD;AAEhD,uDAAiD;AAOjD,SAAgB,kBAAkB,CAAC,QAAiB;IAClD,IAAI,QAAQ,YAAY,8BAAY,EAAE,CAAC;QACrC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,aAAa,GAAG,IAAA,oBAAO,EAAC,QAAQ,CAAC,CAAC;IACxC,OAAO,IAAI,8BAAY,CAAC,aAAa,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;AACpE,CAAC","sourcesContent":["import { toError } from '../jsutils/toError.ts';\n\nimport { GraphQLError } from './GraphQLError.ts';\n\n/**\n * Ensure an unknown thrown value is represented as a GraphQLError.\n *\n * @internal\n */\nexport function ensureGraphQLError(rawError: unknown): GraphQLError {\n  if (rawError instanceof GraphQLError) {\n    return rawError;\n  }\n\n  const originalError = toError(rawError);\n  return new GraphQLError(originalError.message, { originalError });\n}\n"]}

package/error/ensureGraphQLError.mjs

@@ -1,8 +1,5 @@
 import { toError } from "../jsutils/toError.mjs";
 import { GraphQLError } from "./GraphQLError.mjs";
-/**
- * Ensure an unknown thrown value is represented as a GraphQLError.
- */
 export function ensureGraphQLError(rawError) {
     if (rawError instanceof GraphQLError) {
         return rawError;

package/error/ensureGraphQLError.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ensureGraphQLError.js","sourceRoot":"","sources":["../../src/error/ensureGraphQLError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,+BAA8B;AAEhD,OAAO,EAAE,YAAY,EAAE,2BAA0B;AAEjD;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAiB;IAClD,IAAI,QAAQ,YAAY,YAAY,EAAE,CAAC;QACrC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxC,OAAO,IAAI,YAAY,CAAC,aAAa,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;AACpE,CAAC","sourcesContent":["import { toError } from '../jsutils/toError.ts';\n\nimport { GraphQLError } from './GraphQLError.ts';\n\n/**\n * Ensure an unknown thrown value is represented as a GraphQLError.\n */\nexport function ensureGraphQLError(rawError: unknown): GraphQLError {\n  if (rawError instanceof GraphQLError) {\n    return rawError;\n  }\n\n  const originalError = toError(rawError);\n  return new GraphQLError(originalError.message, { originalError });\n}\n"]}
+{"version":3,"file":"ensureGraphQLError.js","sourceRoot":"","sources":["../../src/error/ensureGraphQLError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,+BAA8B;AAEhD,OAAO,EAAE,YAAY,EAAE,2BAA0B;AAOjD,MAAM,UAAU,kBAAkB,CAAC,QAAiB;IAClD,IAAI,QAAQ,YAAY,YAAY,EAAE,CAAC;QACrC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxC,OAAO,IAAI,YAAY,CAAC,aAAa,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;AACpE,CAAC","sourcesContent":["import { toError } from '../jsutils/toError.ts';\n\nimport { GraphQLError } from './GraphQLError.ts';\n\n/**\n * Ensure an unknown thrown value is represented as a GraphQLError.\n *\n * @internal\n */\nexport function ensureGraphQLError(rawError: unknown): GraphQLError {\n  if (rawError instanceof GraphQLError) {\n    return rawError;\n  }\n\n  const originalError = toError(rawError);\n  return new GraphQLError(originalError.message, { originalError });\n}\n"]}

package/error/index.d.mts

@@ -1,3 +1,9 @@
+/**
+ * Create, format, and locate GraphQL errors.
+ *
+ * These exports are also available from the root `graphql` package.
+ * @packageDocumentation
+ */
 export { GraphQLError } from "./GraphQLError.mjs";
 export type { GraphQLErrorOptions, GraphQLFormattedError, GraphQLErrorExtensions, GraphQLFormattedErrorExtensions, } from "./GraphQLError.mjs";
 export { syntaxError } from "./syntaxError.mjs";

package/error/index.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Create, format, and locate GraphQL errors.
+ *
+ * These exports are also available from the root `graphql` package.
+ * @packageDocumentation
+ */
 export { GraphQLError } from "./GraphQLError.js";
 export type { GraphQLErrorOptions, GraphQLFormattedError, GraphQLErrorExtensions, GraphQLFormattedErrorExtensions, } from "./GraphQLError.js";
 export { syntaxError } from "./syntaxError.js";

package/error/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/error/index.ts"],"names":[],"mappings":";;;AAAA,qDAAiD;AAAxC,+GAAA,YAAY,OAAA;AAQrB,mDAA+C;AAAtC,6GAAA,WAAW,OAAA;AAEpB,qDAAiD;AAAxC,+GAAA,YAAY,OAAA","sourcesContent":["export { GraphQLError } from './GraphQLError.ts';\nexport type {\n  GraphQLErrorOptions,\n  GraphQLFormattedError,\n  GraphQLErrorExtensions,\n  GraphQLFormattedErrorExtensions,\n} from './GraphQLError.ts';\n\nexport { syntaxError } from './syntaxError.ts';\n\nexport { locatedError } from './locatedError.ts';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/error/index.ts"],"names":[],"mappings":";;;AAOA,qDAAiD;AAAxC,+GAAA,YAAY,OAAA;AAQrB,mDAA+C;AAAtC,6GAAA,WAAW,OAAA;AAEpB,qDAAiD;AAAxC,+GAAA,YAAY,OAAA","sourcesContent":["/**\n * Create, format, and locate GraphQL errors.\n *\n * These exports are also available from the root `graphql` package.\n * @packageDocumentation\n */\n\nexport { GraphQLError } from './GraphQLError.ts';\nexport type {\n  GraphQLErrorOptions,\n  GraphQLFormattedError,\n  GraphQLErrorExtensions,\n  GraphQLFormattedErrorExtensions,\n} from './GraphQLError.ts';\n\nexport { syntaxError } from './syntaxError.ts';\n\nexport { locatedError } from './locatedError.ts';\n"]}

package/error/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/error/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,2BAA0B;AAQjD,OAAO,EAAE,WAAW,EAAE,0BAAyB;AAE/C,OAAO,EAAE,YAAY,EAAE,2BAA0B","sourcesContent":["export { GraphQLError } from './GraphQLError.ts';\nexport type {\n  GraphQLErrorOptions,\n  GraphQLFormattedError,\n  GraphQLErrorExtensions,\n  GraphQLFormattedErrorExtensions,\n} from './GraphQLError.ts';\n\nexport { syntaxError } from './syntaxError.ts';\n\nexport { locatedError } from './locatedError.ts';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/error/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,2BAA0B;AAQjD,OAAO,EAAE,WAAW,EAAE,0BAAyB;AAE/C,OAAO,EAAE,YAAY,EAAE,2BAA0B","sourcesContent":["/**\n * Create, format, and locate GraphQL errors.\n *\n * These exports are also available from the root `graphql` package.\n * @packageDocumentation\n */\n\nexport { GraphQLError } from './GraphQLError.ts';\nexport type {\n  GraphQLErrorOptions,\n  GraphQLFormattedError,\n  GraphQLErrorExtensions,\n  GraphQLFormattedErrorExtensions,\n} from './GraphQLError.ts';\n\nexport { syntaxError } from './syntaxError.ts';\n\nexport { locatedError } from './locatedError.ts';\n"]}

package/error/locatedError.d.mts

@@ -1,3 +1,4 @@
+/** @category Errors */
 import type { Maybe } from "../jsutils/Maybe.mjs";
 import type { ASTNode } from "../language/ast.mjs";
 import { GraphQLError } from "./GraphQLError.mjs";
@@ -5,5 +6,24 @@ 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,3 +1,4 @@
+/** @category Errors */
 import type { Maybe } from "../jsutils/Maybe.js";
 import type { ASTNode } from "../language/ast.js";
 import { GraphQLError } from "./GraphQLError.js";
@@ -5,5 +6,24 @@ 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

@@ -3,14 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.locatedError = locatedError;
 const toError_ts_1 = require("../jsutils/toError.js");
 const GraphQLError_ts_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.
- */
 function locatedError(rawOriginalError, nodes, path) {
     const originalError = (0, toError_ts_1.toError)(rawOriginalError);
-    // Note: this uses a brand-check to support GraphQL errors originating from other contexts.
     if (isLocatedGraphQLError(originalError)) {
         return originalError;
     }

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.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 */\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"]}