graphql 17.0.0-beta.2 → 17.0.0

package/diagnostics.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveChannel = exports.subscribeChannel = exports.executeRootSelectionSetChannel = exports.executeVariableCoercionChannel = exports.executeChannel = exports.validateChannel = exports.parseChannel = void 0;
+exports.shouldTrace = shouldTrace;
+exports.traceMixed = traceMixed;
+const isPromise_ts_1 = require("./jsutils/isPromise.js");
+function resolveDiagnosticsChannel() {
+    let dc;
+    try {
+        const processRef = globalThis.process;
+        if (typeof processRef?.getBuiltinModule === 'function') {
+            dc = processRef.getBuiltinModule('node:diagnostics_channel');
+        }
+    }
+    catch {
+    }
+    return dc;
+}
+const dc = resolveDiagnosticsChannel();
+exports.parseChannel = dc?.tracingChannel('graphql:parse');
+exports.validateChannel = dc?.tracingChannel('graphql:validate');
+exports.executeChannel = dc?.tracingChannel('graphql:execute');
+exports.executeVariableCoercionChannel = dc?.tracingChannel('graphql:execute:variableCoercion');
+exports.executeRootSelectionSetChannel = dc?.tracingChannel('graphql:execute:rootSelectionSet');
+exports.subscribeChannel = dc?.tracingChannel('graphql:subscribe');
+exports.resolveChannel = dc?.tracingChannel('graphql:resolve');
+const SUB_CHANNEL_KEYS = ['start', 'end', 'asyncStart', 'asyncEnd', 'error'];
+function shouldTrace(channel) {
+    if (channel == null) {
+        return false;
+    }
+    const aggregate = channel.hasSubscribers;
+    if (aggregate !== undefined) {
+        return aggregate;
+    }
+    for (const key of SUB_CHANNEL_KEYS) {
+        if (channel[key].hasSubscribers) {
+            return true;
+        }
+    }
+    return false;
+}
+function traceMixed(channel, contextInput, fn) {
+    const context = contextInput;
+    return channel.start.runStores(context, () => {
+        let result;
+        try {
+            result = fn();
+        }
+        catch (err) {
+            context.error = err;
+            channel.error.publish(context);
+            channel.end.publish(context);
+            throw err;
+        }
+        if (!(0, isPromise_ts_1.isPromiseLike)(result)) {
+            context.result = result;
+            channel.end.publish(context);
+            return result;
+        }
+        channel.end.publish(context);
+        channel.asyncStart.publish(context);
+        return result.then((value) => {
+            context.result = value;
+            channel.asyncEnd.publish(context);
+            return value;
+        }, (err) => {
+            context.error = err;
+            channel.error.publish(context);
+            channel.asyncEnd.publish(context);
+            throw err;
+        });
+    });
+}
+//# sourceMappingURL=diagnostics.js.map

package/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * TracingChannel integration.\n *\n * GraphQL.js publishes lifecycle events on a set of named tracing channels\n * that application performance monitoring (APM) tools can subscribe to in\n * order to observe parse, validate, execute, subscribe, and resolver behavior,\n * plus selected executor internals. At module load time GraphQL.js resolves\n * `node:diagnostics_channel` itself so APMs do not need to interact with the\n * GraphQL API to enable tracing. On runtimes that do not expose\n * `node:diagnostics_channel` (e.g., browsers) the load silently no-ops and\n * emission sites short-circuit.\n *\n * Within the tracing context types, `error` means the traced JavaScript call\n * threw or rejected; it does not mean every `GraphQLError` returned by\n * GraphQL.js. Some channels complete normally and publish GraphQL errors on\n * `result`. Resolver errors can appear both as `message.error` on\n * `graphql:resolve` and as formatted errors in an enclosing execution or\n * subscription result. `graphql:parse`, `graphql:validate`, and\n * `graphql:execute:variableCoercion` are sync-only channels.\n * @category Diagnostics\n */\n\nimport { isPromiseLike } from './jsutils/isPromise.ts';\nimport type { Maybe } from './jsutils/Maybe.ts';\nimport type { ObjMap } from './jsutils/ObjMap.ts';\n\nimport type { GraphQLError } from './error/GraphQLError.ts';\n\nimport type {\n  DocumentNode,\n  OperationDefinitionNode,\n  OperationTypeNode,\n} from './language/ast.ts';\nimport type { Source } from './language/source.ts';\n\nimport type { GraphQLSchema } from './type/schema.ts';\n\nimport type { ExecutionResult } from './execution/Executor.ts';\nimport type { ExperimentalIncrementalExecutionResults } from './execution/incremental/IncrementalExecutor.ts';\nimport type { VariableValues } from './execution/values.ts';\n\n/**\n * Structural subset of `DiagnosticsChannel` sufficient for publishing and\n * subscriber gating. The `node:diagnostics_channel` `Channel` satisfies this.\n *\n * @internal\n */\nexport interface MinimalChannel<TMessage = unknown> {\n  readonly hasSubscribers?: boolean;\n  publish: (message: TMessage) => void;\n  runStores: <T, ContextType extends object>(\n    context: ContextType,\n    fn: (this: ContextType, ...args: Array<unknown>) => T,\n    thisArg?: unknown,\n    ...args: Array<unknown>\n  ) => T;\n}\n\n/**\n * Structural subset of the Node.js `TracingChannel` API. The\n * `node:diagnostics_channel` `TracingChannel` satisfies this by duck typing,\n * so GraphQL.js does not need a dependency on `@types/node` or on the runtime\n * itself.\n *\n * @internal\n */\nexport interface MinimalTracingChannel<TContext = unknown> {\n  // `undefined` accommodates runtimes (e.g. Bun) that ship `tracingChannel`\n  // without exposing the aggregate `hasSubscribers` getter.\n  readonly hasSubscribers: boolean | undefined;\n  readonly start: MinimalChannel<TContext>;\n  readonly end: MinimalChannel<TContext>;\n  readonly asyncStart: MinimalChannel<TContext>;\n  readonly asyncEnd: MinimalChannel<TContext>;\n  readonly error: MinimalChannel<TContext>;\n\n  traceSync: <T>(\n    fn: (...args: Array<unknown>) => T,\n    context: TContext extends object ? TContext : object,\n    thisArg?: unknown,\n    ...args: Array<unknown>\n  ) => T;\n}\n\ninterface DiagnosticsChannelModule {\n  tracingChannel: <TContext = unknown>(\n    name: string,\n  ) => MinimalTracingChannel<TContext>;\n}\n\n/** Context published on the sync-only `graphql:parse` channel. */\nexport interface GraphQLParseContext {\n  /** Source text or source object passed to the parser. */\n  source: string | Source;\n  /** Error thrown while parsing, when parsing fails. */\n  error?: unknown;\n  /** Parsed document, when parsing succeeds. */\n  result?: DocumentNode;\n}\n\n/** Context published on the sync-only `graphql:validate` channel. */\nexport interface GraphQLValidateContext {\n  /** Schema used for validation. */\n  schema: GraphQLSchema;\n  /** Parsed document being validated. */\n  document: DocumentNode;\n  /** Error thrown while validating, when validation fails abruptly. */\n  error?: unknown;\n  /** Validation errors returned by validation. */\n  result?: ReadonlyArray<GraphQLError>;\n}\n\n/**\n * Context published on `graphql:execute`.\n *\n * Returned results may contain GraphQL errors collected during execution.\n */\nexport interface GraphQLExecuteContext {\n  /** Schema used for execution. */\n  schema: GraphQLSchema;\n  /** Parsed document being executed. */\n  document: DocumentNode;\n  /** Raw variable values provided by the caller before coercion. */\n  rawVariableValues: Maybe<{ readonly [variable: string]: unknown }>;\n  /** Selected operation name, if one is available. */\n  operationName: string | undefined;\n  /** Selected operation type, if one is available. */\n  operationType: OperationTypeNode | undefined;\n  /** Error thrown or rejected while executing, when execution fails abruptly. */\n  error?: unknown;\n  /** Execution result returned by execution, including GraphQL errors. */\n  result?: ExecutionResult | ExperimentalIncrementalExecutionResults;\n}\n\n/**\n * Context published on `graphql:execute:rootSelectionSet`.\n *\n * Returned results may contain GraphQL errors collected during execution.\n */\nexport interface GraphQLExecuteRootSelectionSetContext {\n  /** Schema used for execution. */\n  schema: GraphQLSchema;\n  /** Parsed document being executed. */\n  document: DocumentNode;\n  /** Operation definition selected for execution. */\n  operation: OperationDefinitionNode;\n  /** Raw variable values provided by the caller before coercion. */\n  rawVariableValues: Maybe<{ readonly [variable: string]: unknown }>;\n  /** Selected operation name, if one is available. */\n  operationName: string | undefined;\n  /** Selected operation type. */\n  operationType: OperationTypeNode;\n  /** Error thrown or rejected while executing the root selection set. */\n  error?: unknown;\n  /**\n   * Execution result returned from the root selection set, including GraphQL\n   * errors.\n   */\n  result?: ExecutionResult | ExperimentalIncrementalExecutionResults;\n}\n\n/**\n * Context published on `graphql:execute:variableCoercion`.\n *\n * Coercion runs synchronously while execution arguments are validated, so only\n * the `start`/`end` (and, on an abrupt throw, `error`) lifecycle fires.\n * Ordinary variable coercion failures are returned on `result.errors`; when\n * execution is invoked through APIs such as `execute()` or `subscribe()`, they\n * surface as GraphQL result errors rather than as the tracing `error`\n * lifecycle event.\n */\nexport interface GraphQLExecuteVariableCoercionContext {\n  /** Schema used for variable coercion. */\n  schema: GraphQLSchema;\n  /** Parsed document being executed. */\n  document: DocumentNode;\n  /** Operation definition whose variables are being coerced. */\n  operation: OperationDefinitionNode;\n  /** Raw variable values provided by the caller before coercion. */\n  rawVariableValues: Maybe<{ readonly [variable: string]: unknown }>;\n  /** Selected operation name, if one is available. */\n  operationName: string | undefined;\n  /** Selected operation type. */\n  operationType: OperationTypeNode;\n  /** Error thrown while coercing variables, when coercion fails abruptly. */\n  error?: unknown;\n  /** Coerced variable values or coercion errors returned by coercion. */\n  result?:\n    | { variableValues: VariableValues }\n    | { errors: ReadonlyArray<GraphQLError> };\n}\n\n/**\n * Context published on `graphql:subscribe`.\n *\n * Subscription source resolver errors and invalid source stream results are\n * returned on `result` as ExecutionResult errors; they do not publish the\n * `error` lifecycle event unless subscription setup fails abruptly before\n * GraphQL can form a result.\n */\nexport interface GraphQLSubscribeContext {\n  /** Schema used for subscription execution. */\n  schema: GraphQLSchema;\n  /** Parsed subscription document. */\n  document: DocumentNode;\n  /** Raw variable values provided by the caller before coercion. */\n  rawVariableValues: Maybe<{ readonly [variable: string]: unknown }>;\n  /** Selected operation name, if one is available. */\n  operationName: string | undefined;\n  /** Selected operation type, if one is available. */\n  operationType: OperationTypeNode | undefined;\n  /** Error thrown or rejected while subscribing, when setup fails abruptly. */\n  error?: unknown;\n  /**\n   * Subscription response stream, or an ExecutionResult containing GraphQL\n   * errors.\n   */\n  result?: AsyncGenerator<ExecutionResult, void, void> | ExecutionResult;\n}\n\n/**\n * Context published on `graphql:resolve`.\n *\n * Resolver throws and rejections publish the `error` lifecycle event here.\n * The same failure may also be formatted into the enclosing execution or\n * subscription result.\n */\nexport interface GraphQLResolveContext {\n  /** Field name being resolved. */\n  fieldName: string;\n  /** Response alias for the field being resolved. */\n  alias: string;\n  /** Parent type name for the field being resolved. */\n  parentType: string;\n  /** Return type string for the field being resolved. */\n  fieldType: string;\n  /** Argument values passed to the resolver. */\n  args: ObjMap<unknown>;\n  /** Whether the field is using the default resolver. */\n  isDefaultResolver: boolean;\n  /** Response path for the field being resolved. */\n  fieldPath: string;\n  /** Error thrown or rejected by the resolver, when resolution fails. */\n  error?: unknown;\n  /** Value returned by the resolver, when resolution succeeds. */\n  result?: unknown;\n}\n\n/** Mapping from tracing channel name to the context type published on it. */\nexport interface GraphQLChannelContextByName {\n  /** Context published on `graphql:parse`. */\n  'graphql:parse': GraphQLParseContext;\n  /** Context published on `graphql:validate`. */\n  'graphql:validate': GraphQLValidateContext;\n  /** Context published on `graphql:execute`. */\n  'graphql:execute': GraphQLExecuteContext;\n  /** Context published on `graphql:execute:variableCoercion`. */\n  'graphql:execute:variableCoercion': GraphQLExecuteVariableCoercionContext;\n  /** Context published on `graphql:execute:rootSelectionSet`. */\n  'graphql:execute:rootSelectionSet': GraphQLExecuteRootSelectionSetContext;\n  /** Context published on `graphql:subscribe`. */\n  'graphql:subscribe': GraphQLSubscribeContext;\n  /** Context published on `graphql:resolve`. */\n  'graphql:resolve': GraphQLResolveContext;\n}\n\n/**\n * The collection of tracing channels GraphQL.js emits on. Application\n * performance monitoring (APM) tools subscribe to these by name on their own\n * `node:diagnostics_channel` import; both paths land on the same channel\n * instance because `tracingChannel(name)` is cached by name.\n */\nexport interface GraphQLChannels {\n  /** Tracing channel for `graphql:execute`. */\n  execute: MinimalTracingChannel<GraphQLExecuteContext>;\n  /** Tracing channel for `graphql:execute:variableCoercion`. */\n  executeVariableCoercion: MinimalTracingChannel<GraphQLExecuteVariableCoercionContext>;\n  /** Tracing channel for `graphql:execute:rootSelectionSet`. */\n  executeRootSelectionSet: MinimalTracingChannel<GraphQLExecuteRootSelectionSetContext>;\n  /** Tracing channel for `graphql:parse`. */\n  parse: MinimalTracingChannel<GraphQLParseContext>;\n  /** Tracing channel for `graphql:validate`. */\n  validate: MinimalTracingChannel<GraphQLValidateContext>;\n  /** Tracing channel for `graphql:resolve`. */\n  resolve: MinimalTracingChannel<GraphQLResolveContext>;\n  /** Tracing channel for `graphql:subscribe`. */\n  subscribe: MinimalTracingChannel<GraphQLSubscribeContext>;\n}\n\nfunction resolveDiagnosticsChannel(): DiagnosticsChannelModule | undefined {\n  let dc: DiagnosticsChannelModule | undefined;\n  try {\n    const processRef = (\n      globalThis as {\n        process?: { getBuiltinModule?: (id: string) => unknown };\n      }\n    ).process;\n    if (\n      // eslint-disable-next-line n/no-unsupported-features/node-builtins\n      typeof processRef?.getBuiltinModule === 'function'\n    ) {\n      // eslint-disable-next-line n/no-unsupported-features/node-builtins\n      dc = processRef.getBuiltinModule(\n        'node:diagnostics_channel',\n      ) as DiagnosticsChannelModule;\n    }\n    /* node:coverage ignore next 3 */\n  } catch {\n    // diagnostics_channel not available on this runtime; tracing is a no-op.\n  }\n  return dc;\n}\n\nconst dc = resolveDiagnosticsChannel();\n\n/**\n * Per-channel handles, resolved once at module load. `undefined` when\n * `node:diagnostics_channel` isn't available. Emission sites read these\n * directly to keep the no-subscriber fast path to a single property access\n * plus a `hasSubscribers` check (no function calls, no closures).\n *\n * @internal\n */\nexport const parseChannel:\n  | MinimalTracingChannel<GraphQLParseContext>\n  | undefined = dc?.tracingChannel('graphql:parse');\n/** @internal */\nexport const validateChannel:\n  | MinimalTracingChannel<GraphQLValidateContext>\n  | undefined = dc?.tracingChannel('graphql:validate');\n/** @internal */\nexport const executeChannel:\n  | MinimalTracingChannel<GraphQLExecuteContext>\n  | undefined = dc?.tracingChannel('graphql:execute');\n/** @internal */\nexport const executeVariableCoercionChannel:\n  | MinimalTracingChannel<GraphQLExecuteVariableCoercionContext>\n  | undefined = dc?.tracingChannel('graphql:execute:variableCoercion');\n/** @internal */\nexport const executeRootSelectionSetChannel:\n  | MinimalTracingChannel<GraphQLExecuteRootSelectionSetContext>\n  | undefined = dc?.tracingChannel('graphql:execute:rootSelectionSet');\n/** @internal */\nexport const subscribeChannel:\n  | MinimalTracingChannel<GraphQLSubscribeContext>\n  | undefined = dc?.tracingChannel('graphql:subscribe');\n/** @internal */\nexport const resolveChannel:\n  | MinimalTracingChannel<GraphQLResolveContext>\n  | undefined = dc?.tracingChannel('graphql:resolve');\n\nconst SUB_CHANNEL_KEYS: ReadonlyArray<\n  'start' | 'end' | 'asyncStart' | 'asyncEnd' | 'error'\n> = ['start', 'end', 'asyncStart', 'asyncEnd', 'error'];\n\n/**\n * Whether emission sites should publish to `channel`. Trusts the\n * `TracingChannel.hasSubscribers` aggregate when the runtime exposes it; if\n * the getter is missing (e.g. Bun's `node:diagnostics_channel`, where\n * `tracingChannel.hasSubscribers` is `undefined`), falls back to checking\n * each of the five underlying lifecycle channels so a subscriber attached\n * via `tracingChannel.subscribe(handlers)` is still observed.\n *\n * @internal\n */\nexport function shouldTrace<TContext = unknown>(\n  channel: MinimalTracingChannel<TContext> | undefined,\n): channel is MinimalTracingChannel<TContext> {\n  if (channel == null) {\n    return false;\n  }\n  const aggregate = channel.hasSubscribers;\n  if (aggregate !== undefined) {\n    return aggregate;\n  }\n  // Bun-only fallback, exercised by integrationTests/diagnostics-bun.\n  for (const key of SUB_CHANNEL_KEYS) {\n    if (channel[key].hasSubscribers) {\n      return true;\n    }\n  }\n  return false;\n}\n\ninterface TraceLifecycleContext {\n  error?: unknown;\n  result?: unknown;\n}\n\ntype TraceStartContext<TContext extends TraceLifecycleContext> = Omit<\n  TContext,\n  'error' | 'result'\n>;\n\n/**\n * Publish a traced call that may complete synchronously or with a promise.\n * Caller has already verified that a subscriber is attached. On normal\n * completion, `result` is attached before the terminal `end` or `asyncEnd`\n * event. When the traced call throws or rejects, `error` is attached, the\n * `error` sub-channel fires, and the terminal `end` or `asyncEnd` event is\n * published before the original failure is propagated.\n *\n * @internal\n */\nexport function traceMixed<TResult, TContext extends TraceLifecycleContext>(\n  channel: MinimalTracingChannel<TContext>,\n  contextInput: TraceStartContext<TContext>,\n  fn: () => TResult,\n): TResult {\n  const context = contextInput as TContext;\n\n  return channel.start.runStores(context, () => {\n    let result: TResult;\n    try {\n      result = fn();\n    } catch (err) {\n      context.error = err;\n      channel.error.publish(context);\n      channel.end.publish(context);\n      throw err;\n    }\n\n    if (!isPromiseLike(result)) {\n      context.result = result;\n      channel.end.publish(context);\n      return result;\n    }\n\n    channel.end.publish(context);\n    channel.asyncStart.publish(context);\n\n    return result.then(\n      (value) => {\n        context.result = value;\n        channel.asyncEnd.publish(context);\n        return value;\n      },\n      (err: unknown) => {\n        context.error = err;\n        channel.error.publish(context);\n        channel.asyncEnd.publish(context);\n        throw err;\n      },\n    ) as TResult;\n  });\n}\n"]}

package/diagnostics.mjs

@@ -0,0 +1,70 @@
+import { isPromiseLike } from "./jsutils/isPromise.mjs";
+function resolveDiagnosticsChannel() {
+    let dc;
+    try {
+        const processRef = globalThis.process;
+        if (typeof processRef?.getBuiltinModule === 'function') {
+            dc = processRef.getBuiltinModule('node:diagnostics_channel');
+        }
+    }
+    catch {
+    }
+    return dc;
+}
+const dc = resolveDiagnosticsChannel();
+export const parseChannel = dc?.tracingChannel('graphql:parse');
+export const validateChannel = dc?.tracingChannel('graphql:validate');
+export const executeChannel = dc?.tracingChannel('graphql:execute');
+export const executeVariableCoercionChannel = dc?.tracingChannel('graphql:execute:variableCoercion');
+export const executeRootSelectionSetChannel = dc?.tracingChannel('graphql:execute:rootSelectionSet');
+export const subscribeChannel = dc?.tracingChannel('graphql:subscribe');
+export const resolveChannel = dc?.tracingChannel('graphql:resolve');
+const SUB_CHANNEL_KEYS = ['start', 'end', 'asyncStart', 'asyncEnd', 'error'];
+export function shouldTrace(channel) {
+    if (channel == null) {
+        return false;
+    }
+    const aggregate = channel.hasSubscribers;
+    if (aggregate !== undefined) {
+        return aggregate;
+    }
+    for (const key of SUB_CHANNEL_KEYS) {
+        if (channel[key].hasSubscribers) {
+            return true;
+        }
+    }
+    return false;
+}
+export function traceMixed(channel, contextInput, fn) {
+    const context = contextInput;
+    return channel.start.runStores(context, () => {
+        let result;
+        try {
+            result = fn();
+        }
+        catch (err) {
+            context.error = err;
+            channel.error.publish(context);
+            channel.end.publish(context);
+            throw err;
+        }
+        if (!isPromiseLike(result)) {
+            context.result = result;
+            channel.end.publish(context);
+            return result;
+        }
+        channel.end.publish(context);
+        channel.asyncStart.publish(context);
+        return result.then((value) => {
+            context.result = value;
+            channel.asyncEnd.publish(context);
+            return value;
+        }, (err) => {
+            context.error = err;
+            channel.error.publish(context);
+            channel.asyncEnd.publish(context);
+            throw err;
+        });
+    });
+}
+//# sourceMappingURL=diagnostics.js.map

package/diagnostics.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * TracingChannel integration.\n *\n * GraphQL.js publishes lifecycle events on a set of named tracing channels\n * that application performance monitoring (APM) tools can subscribe to in\n * order to observe parse, validate, execute, subscribe, and resolver behavior,\n * plus selected executor internals. At module load time GraphQL.js resolves\n * `node:diagnostics_channel` itself so APMs do not need to interact with the\n * GraphQL API to enable tracing. On runtimes that do not expose\n * `node:diagnostics_channel` (e.g., browsers) the load silently no-ops and\n * emission sites short-circuit.\n *\n * Within the tracing context types, `error` means the traced JavaScript call\n * threw or rejected; it does not mean every `GraphQLError` returned by\n * GraphQL.js. Some channels complete normally and publish GraphQL errors on\n * `result`. Resolver errors can appear both as `message.error` on\n * `graphql:resolve` and as formatted errors in an enclosing execution or\n * subscription result. `graphql:parse`, `graphql:validate`, and\n * `graphql:execute:variableCoercion` are sync-only channels.\n * @category Diagnostics\n */\n\nimport { isPromiseLike } from './jsutils/isPromise.ts';\nimport type { Maybe } from './jsutils/Maybe.ts';\nimport type { ObjMap } from './jsutils/ObjMap.ts';\n\nimport type { GraphQLError } from './error/GraphQLError.ts';\n\nimport type {\n  DocumentNode,\n  OperationDefinitionNode,\n  OperationTypeNode,\n} from './language/ast.ts';\nimport type { Source } from './language/source.ts';\n\nimport type { GraphQLSchema } from './type/schema.ts';\n\nimport type { ExecutionResult } from './execution/Executor.ts';\nimport type { ExperimentalIncrementalExecutionResults } from './execution/incremental/IncrementalExecutor.ts';\nimport type { VariableValues } from './execution/values.ts';\n\n/**\n * Structural subset of `DiagnosticsChannel` sufficient for publishing and\n * subscriber gating. The `node:diagnostics_channel` `Channel` satisfies this.\n *\n * @internal\n */\nexport interface MinimalChannel<TMessage = unknown> {\n  readonly hasSubscribers?: boolean;\n  publish: (message: TMessage) => void;\n  runStores: <T, ContextType extends object>(\n    context: ContextType,\n    fn: (this: ContextType, ...args: Array<unknown>) => T,\n    thisArg?: unknown,\n    ...args: Array<unknown>\n  ) => T;\n}\n\n/**\n * Structural subset of the Node.js `TracingChannel` API. The\n * `node:diagnostics_channel` `TracingChannel` satisfies this by duck typing,\n * so GraphQL.js does not need a dependency on `@types/node` or on the runtime\n * itself.\n *\n * @internal\n */\nexport interface MinimalTracingChannel<TContext = unknown> {\n  // `undefined` accommodates runtimes (e.g. Bun) that ship `tracingChannel`\n  // without exposing the aggregate `hasSubscribers` getter.\n  readonly hasSubscribers: boolean | undefined;\n  readonly start: MinimalChannel<TContext>;\n  readonly end: MinimalChannel<TContext>;\n  readonly asyncStart: MinimalChannel<TContext>;\n  readonly asyncEnd: MinimalChannel<TContext>;\n  readonly error: MinimalChannel<TContext>;\n\n  traceSync: <T>(\n    fn: (...args: Array<unknown>) => T,\n    context: TContext extends object ? TContext : object,\n    thisArg?: unknown,\n    ...args: Array<unknown>\n  ) => T;\n}\n\ninterface DiagnosticsChannelModule {\n  tracingChannel: <TContext = unknown>(\n    name: string,\n  ) => MinimalTracingChannel<TContext>;\n}\n\n/** Context published on the sync-only `graphql:parse` channel. */\nexport interface GraphQLParseContext {\n  /** Source text or source object passed to the parser. */\n  source: string | Source;\n  /** Error thrown while parsing, when parsing fails. */\n  error?: unknown;\n  /** Parsed document, when parsing succeeds. */\n  result?: DocumentNode;\n}\n\n/** Context published on the sync-only `graphql:validate` channel. */\nexport interface GraphQLValidateContext {\n  /** Schema used for validation. */\n  schema: GraphQLSchema;\n  /** Parsed document being validated. */\n  document: DocumentNode;\n  /** Error thrown while validating, when validation fails abruptly. */\n  error?: unknown;\n  /** Validation errors returned by validation. */\n  result?: ReadonlyArray<GraphQLError>;\n}\n\n/**\n * Context published on `graphql:execute`.\n *\n * Returned results may contain GraphQL errors collected during execution.\n */\nexport interface GraphQLExecuteContext {\n  /** Schema used for execution. */\n  schema: GraphQLSchema;\n  /** Parsed document being executed. */\n  document: DocumentNode;\n  /** Raw variable values provided by the caller before coercion. */\n  rawVariableValues: Maybe<{ readonly [variable: string]: unknown }>;\n  /** Selected operation name, if one is available. */\n  operationName: string | undefined;\n  /** Selected operation type, if one is available. */\n  operationType: OperationTypeNode | undefined;\n  /** Error thrown or rejected while executing, when execution fails abruptly. */\n  error?: unknown;\n  /** Execution result returned by execution, including GraphQL errors. */\n  result?: ExecutionResult | ExperimentalIncrementalExecutionResults;\n}\n\n/**\n * Context published on `graphql:execute:rootSelectionSet`.\n *\n * Returned results may contain GraphQL errors collected during execution.\n */\nexport interface GraphQLExecuteRootSelectionSetContext {\n  /** Schema used for execution. */\n  schema: GraphQLSchema;\n  /** Parsed document being executed. */\n  document: DocumentNode;\n  /** Operation definition selected for execution. */\n  operation: OperationDefinitionNode;\n  /** Raw variable values provided by the caller before coercion. */\n  rawVariableValues: Maybe<{ readonly [variable: string]: unknown }>;\n  /** Selected operation name, if one is available. */\n  operationName: string | undefined;\n  /** Selected operation type. */\n  operationType: OperationTypeNode;\n  /** Error thrown or rejected while executing the root selection set. */\n  error?: unknown;\n  /**\n   * Execution result returned from the root selection set, including GraphQL\n   * errors.\n   */\n  result?: ExecutionResult | ExperimentalIncrementalExecutionResults;\n}\n\n/**\n * Context published on `graphql:execute:variableCoercion`.\n *\n * Coercion runs synchronously while execution arguments are validated, so only\n * the `start`/`end` (and, on an abrupt throw, `error`) lifecycle fires.\n * Ordinary variable coercion failures are returned on `result.errors`; when\n * execution is invoked through APIs such as `execute()` or `subscribe()`, they\n * surface as GraphQL result errors rather than as the tracing `error`\n * lifecycle event.\n */\nexport interface GraphQLExecuteVariableCoercionContext {\n  /** Schema used for variable coercion. */\n  schema: GraphQLSchema;\n  /** Parsed document being executed. */\n  document: DocumentNode;\n  /** Operation definition whose variables are being coerced. */\n  operation: OperationDefinitionNode;\n  /** Raw variable values provided by the caller before coercion. */\n  rawVariableValues: Maybe<{ readonly [variable: string]: unknown }>;\n  /** Selected operation name, if one is available. */\n  operationName: string | undefined;\n  /** Selected operation type. */\n  operationType: OperationTypeNode;\n  /** Error thrown while coercing variables, when coercion fails abruptly. */\n  error?: unknown;\n  /** Coerced variable values or coercion errors returned by coercion. */\n  result?:\n    | { variableValues: VariableValues }\n    | { errors: ReadonlyArray<GraphQLError> };\n}\n\n/**\n * Context published on `graphql:subscribe`.\n *\n * Subscription source resolver errors and invalid source stream results are\n * returned on `result` as ExecutionResult errors; they do not publish the\n * `error` lifecycle event unless subscription setup fails abruptly before\n * GraphQL can form a result.\n */\nexport interface GraphQLSubscribeContext {\n  /** Schema used for subscription execution. */\n  schema: GraphQLSchema;\n  /** Parsed subscription document. */\n  document: DocumentNode;\n  /** Raw variable values provided by the caller before coercion. */\n  rawVariableValues: Maybe<{ readonly [variable: string]: unknown }>;\n  /** Selected operation name, if one is available. */\n  operationName: string | undefined;\n  /** Selected operation type, if one is available. */\n  operationType: OperationTypeNode | undefined;\n  /** Error thrown or rejected while subscribing, when setup fails abruptly. */\n  error?: unknown;\n  /**\n   * Subscription response stream, or an ExecutionResult containing GraphQL\n   * errors.\n   */\n  result?: AsyncGenerator<ExecutionResult, void, void> | ExecutionResult;\n}\n\n/**\n * Context published on `graphql:resolve`.\n *\n * Resolver throws and rejections publish the `error` lifecycle event here.\n * The same failure may also be formatted into the enclosing execution or\n * subscription result.\n */\nexport interface GraphQLResolveContext {\n  /** Field name being resolved. */\n  fieldName: string;\n  /** Response alias for the field being resolved. */\n  alias: string;\n  /** Parent type name for the field being resolved. */\n  parentType: string;\n  /** Return type string for the field being resolved. */\n  fieldType: string;\n  /** Argument values passed to the resolver. */\n  args: ObjMap<unknown>;\n  /** Whether the field is using the default resolver. */\n  isDefaultResolver: boolean;\n  /** Response path for the field being resolved. */\n  fieldPath: string;\n  /** Error thrown or rejected by the resolver, when resolution fails. */\n  error?: unknown;\n  /** Value returned by the resolver, when resolution succeeds. */\n  result?: unknown;\n}\n\n/** Mapping from tracing channel name to the context type published on it. */\nexport interface GraphQLChannelContextByName {\n  /** Context published on `graphql:parse`. */\n  'graphql:parse': GraphQLParseContext;\n  /** Context published on `graphql:validate`. */\n  'graphql:validate': GraphQLValidateContext;\n  /** Context published on `graphql:execute`. */\n  'graphql:execute': GraphQLExecuteContext;\n  /** Context published on `graphql:execute:variableCoercion`. */\n  'graphql:execute:variableCoercion': GraphQLExecuteVariableCoercionContext;\n  /** Context published on `graphql:execute:rootSelectionSet`. */\n  'graphql:execute:rootSelectionSet': GraphQLExecuteRootSelectionSetContext;\n  /** Context published on `graphql:subscribe`. */\n  'graphql:subscribe': GraphQLSubscribeContext;\n  /** Context published on `graphql:resolve`. */\n  'graphql:resolve': GraphQLResolveContext;\n}\n\n/**\n * The collection of tracing channels GraphQL.js emits on. Application\n * performance monitoring (APM) tools subscribe to these by name on their own\n * `node:diagnostics_channel` import; both paths land on the same channel\n * instance because `tracingChannel(name)` is cached by name.\n */\nexport interface GraphQLChannels {\n  /** Tracing channel for `graphql:execute`. */\n  execute: MinimalTracingChannel<GraphQLExecuteContext>;\n  /** Tracing channel for `graphql:execute:variableCoercion`. */\n  executeVariableCoercion: MinimalTracingChannel<GraphQLExecuteVariableCoercionContext>;\n  /** Tracing channel for `graphql:execute:rootSelectionSet`. */\n  executeRootSelectionSet: MinimalTracingChannel<GraphQLExecuteRootSelectionSetContext>;\n  /** Tracing channel for `graphql:parse`. */\n  parse: MinimalTracingChannel<GraphQLParseContext>;\n  /** Tracing channel for `graphql:validate`. */\n  validate: MinimalTracingChannel<GraphQLValidateContext>;\n  /** Tracing channel for `graphql:resolve`. */\n  resolve: MinimalTracingChannel<GraphQLResolveContext>;\n  /** Tracing channel for `graphql:subscribe`. */\n  subscribe: MinimalTracingChannel<GraphQLSubscribeContext>;\n}\n\nfunction resolveDiagnosticsChannel(): DiagnosticsChannelModule | undefined {\n  let dc: DiagnosticsChannelModule | undefined;\n  try {\n    const processRef = (\n      globalThis as {\n        process?: { getBuiltinModule?: (id: string) => unknown };\n      }\n    ).process;\n    if (\n      // eslint-disable-next-line n/no-unsupported-features/node-builtins\n      typeof processRef?.getBuiltinModule === 'function'\n    ) {\n      // eslint-disable-next-line n/no-unsupported-features/node-builtins\n      dc = processRef.getBuiltinModule(\n        'node:diagnostics_channel',\n      ) as DiagnosticsChannelModule;\n    }\n    /* node:coverage ignore next 3 */\n  } catch {\n    // diagnostics_channel not available on this runtime; tracing is a no-op.\n  }\n  return dc;\n}\n\nconst dc = resolveDiagnosticsChannel();\n\n/**\n * Per-channel handles, resolved once at module load. `undefined` when\n * `node:diagnostics_channel` isn't available. Emission sites read these\n * directly to keep the no-subscriber fast path to a single property access\n * plus a `hasSubscribers` check (no function calls, no closures).\n *\n * @internal\n */\nexport const parseChannel:\n  | MinimalTracingChannel<GraphQLParseContext>\n  | undefined = dc?.tracingChannel('graphql:parse');\n/** @internal */\nexport const validateChannel:\n  | MinimalTracingChannel<GraphQLValidateContext>\n  | undefined = dc?.tracingChannel('graphql:validate');\n/** @internal */\nexport const executeChannel:\n  | MinimalTracingChannel<GraphQLExecuteContext>\n  | undefined = dc?.tracingChannel('graphql:execute');\n/** @internal */\nexport const executeVariableCoercionChannel:\n  | MinimalTracingChannel<GraphQLExecuteVariableCoercionContext>\n  | undefined = dc?.tracingChannel('graphql:execute:variableCoercion');\n/** @internal */\nexport const executeRootSelectionSetChannel:\n  | MinimalTracingChannel<GraphQLExecuteRootSelectionSetContext>\n  | undefined = dc?.tracingChannel('graphql:execute:rootSelectionSet');\n/** @internal */\nexport const subscribeChannel:\n  | MinimalTracingChannel<GraphQLSubscribeContext>\n  | undefined = dc?.tracingChannel('graphql:subscribe');\n/** @internal */\nexport const resolveChannel:\n  | MinimalTracingChannel<GraphQLResolveContext>\n  | undefined = dc?.tracingChannel('graphql:resolve');\n\nconst SUB_CHANNEL_KEYS: ReadonlyArray<\n  'start' | 'end' | 'asyncStart' | 'asyncEnd' | 'error'\n> = ['start', 'end', 'asyncStart', 'asyncEnd', 'error'];\n\n/**\n * Whether emission sites should publish to `channel`. Trusts the\n * `TracingChannel.hasSubscribers` aggregate when the runtime exposes it; if\n * the getter is missing (e.g. Bun's `node:diagnostics_channel`, where\n * `tracingChannel.hasSubscribers` is `undefined`), falls back to checking\n * each of the five underlying lifecycle channels so a subscriber attached\n * via `tracingChannel.subscribe(handlers)` is still observed.\n *\n * @internal\n */\nexport function shouldTrace<TContext = unknown>(\n  channel: MinimalTracingChannel<TContext> | undefined,\n): channel is MinimalTracingChannel<TContext> {\n  if (channel == null) {\n    return false;\n  }\n  const aggregate = channel.hasSubscribers;\n  if (aggregate !== undefined) {\n    return aggregate;\n  }\n  // Bun-only fallback, exercised by integrationTests/diagnostics-bun.\n  for (const key of SUB_CHANNEL_KEYS) {\n    if (channel[key].hasSubscribers) {\n      return true;\n    }\n  }\n  return false;\n}\n\ninterface TraceLifecycleContext {\n  error?: unknown;\n  result?: unknown;\n}\n\ntype TraceStartContext<TContext extends TraceLifecycleContext> = Omit<\n  TContext,\n  'error' | 'result'\n>;\n\n/**\n * Publish a traced call that may complete synchronously or with a promise.\n * Caller has already verified that a subscriber is attached. On normal\n * completion, `result` is attached before the terminal `end` or `asyncEnd`\n * event. When the traced call throws or rejects, `error` is attached, the\n * `error` sub-channel fires, and the terminal `end` or `asyncEnd` event is\n * published before the original failure is propagated.\n *\n * @internal\n */\nexport function traceMixed<TResult, TContext extends TraceLifecycleContext>(\n  channel: MinimalTracingChannel<TContext>,\n  contextInput: TraceStartContext<TContext>,\n  fn: () => TResult,\n): TResult {\n  const context = contextInput as TContext;\n\n  return channel.start.runStores(context, () => {\n    let result: TResult;\n    try {\n      result = fn();\n    } catch (err) {\n      context.error = err;\n      channel.error.publish(context);\n      channel.end.publish(context);\n      throw err;\n    }\n\n    if (!isPromiseLike(result)) {\n      context.result = result;\n      channel.end.publish(context);\n      return result;\n    }\n\n    channel.end.publish(context);\n    channel.asyncStart.publish(context);\n\n    return result.then(\n      (value) => {\n        context.result = value;\n        channel.asyncEnd.publish(context);\n        return value;\n      },\n      (err: unknown) => {\n        context.error = err;\n        channel.error.publish(context);\n        channel.asyncEnd.publish(context);\n        throw err;\n      },\n    ) as TResult;\n  });\n}\n"]}

package/error/GraphQLError.d.mts

@@ -37,6 +37,7 @@ export interface GraphQLErrorOptions {
     path?: Maybe<ReadonlyArray<string | number>>;
     /**
      * Original error that caused this GraphQLError, if one exists.
+     * Deprecated in favor of `cause` to better align with JavaScript standards.
      * @deprecated Prefer `cause` instead.
      */
     originalError?: Maybe<Error & {
@@ -87,7 +88,8 @@ export declare class GraphQLError extends Error {
      */
     readonly positions: ReadonlyArray<number> | undefined;
     /**
-     * The original error thrown from a field resolver during execution.
+     * Original error that caused this GraphQLError, if one exists.
+     * Deprecated in favor of `cause` to better align with JavaScript standards.
      * @deprecated Use `cause` instead.
      */
     readonly originalError: Error | undefined;

package/error/GraphQLError.d.ts

@@ -37,6 +37,7 @@ export interface GraphQLErrorOptions {
     path?: Maybe<ReadonlyArray<string | number>>;
     /**
      * Original error that caused this GraphQLError, if one exists.
+     * Deprecated in favor of `cause` to better align with JavaScript standards.
      * @deprecated Prefer `cause` instead.
      */
     originalError?: Maybe<Error & {
@@ -87,7 +88,8 @@ export declare class GraphQLError extends Error {
      */
     readonly positions: ReadonlyArray<number> | undefined;
     /**
-     * The original error thrown from a field resolver during execution.
+     * Original error that caused this GraphQLError, if one exists.
+     * Deprecated in favor of `cause` to better align with JavaScript standards.
      * @deprecated Use `cause` instead.
      */
     readonly originalError: Error | undefined;

package/error/GraphQLError.js

@@ -13,7 +13,7 @@ class GraphQLError extends Error {
         super(message, errorOptions);
         this.name = 'GraphQLError';
         this.path = path ?? undefined;
-        const underlyingError = originalError ?? (errorCause instanceof Error ? errorCause : undefined);
+        const underlyingError = originalError ?? (cause instanceof Error ? cause : undefined);
         this.originalError = underlyingError;
         this.nodes = undefinedIfEmpty(Array.isArray(nodes) ? nodes : nodes ? [nodes] : undefined);
         const nodeLocations = undefinedIfEmpty(this.nodes
@@ -40,9 +40,9 @@ class GraphQLError extends Error {
             positions: { enumerable: false },
             originalError: { enumerable: false },
         });
-        if (underlyingError?.stack != null) {
+        if (originalError?.stack != null) {
             Object.defineProperty(this, 'stack', {
-                value: underlyingError.stack,
+                value: originalError.stack,
                 writable: true,
                 configurable: true,
             });

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":["/** @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"]}
+{"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 in favor of `cause` to better align with JavaScript standards.\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   * Original error that caused this GraphQLError, if one exists.\n   * Deprecated in favor of `cause` to better align with JavaScript standards.\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: typeof originalError =\n      originalError ?? (cause instanceof Error ? cause : 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    // Do not copy over the stack trace of the Error.cause, since the tooling\n    // already nicely prints/reports the cause chains.\n    // Preserve the copy-over behavior of the `originalError`, since users may\n    // expect it to work the way it did originally.\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  /**\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

@@ -10,7 +10,7 @@ export class GraphQLError extends Error {
         super(message, errorOptions);
         this.name = 'GraphQLError';
         this.path = path ?? undefined;
-        const underlyingError = originalError ?? (errorCause instanceof Error ? errorCause : undefined);
+        const underlyingError = originalError ?? (cause instanceof Error ? cause : undefined);
         this.originalError = underlyingError;
         this.nodes = undefinedIfEmpty(Array.isArray(nodes) ? nodes : nodes ? [nodes] : undefined);
         const nodeLocations = undefinedIfEmpty(this.nodes
@@ -37,9 +37,9 @@ export class GraphQLError extends Error {
             positions: { enumerable: false },
             originalError: { enumerable: false },
         });
-        if (underlyingError?.stack != null) {
+        if (originalError?.stack != null) {
             Object.defineProperty(this, 'stack', {
-                value: underlyingError.stack,
+                value: originalError.stack,
                 writable: true,
                 configurable: true,
             });

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":["/** @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"]}
+{"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 in favor of `cause` to better align with JavaScript standards.\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   * Original error that caused this GraphQLError, if one exists.\n   * Deprecated in favor of `cause` to better align with JavaScript standards.\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: typeof originalError =\n      originalError ?? (cause instanceof Error ? cause : 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    // Do not copy over the stack trace of the Error.cause, since the tooling\n    // already nicely prints/reports the cause chains.\n    // Preserve the copy-over behavior of the `originalError`, since users may\n    // expect it to work the way it did originally.\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  /**\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/locatedError.d.mts

@@ -17,9 +17,7 @@ import { GraphQLError } from "./GraphQLError.mjs";
  *
  * const document = parse('{ viewer { name } }');
  * const fieldNode = document.definitions[0].selectionSet.selections[0];
- * const error = locatedError(new Error('Resolver failed'), fieldNode, [
- *   'viewer',
- * ]);
+ * const error = locatedError(new Error('Resolver failed'), fieldNode, ['viewer']);
  *
  * error.message; // => 'Resolver failed'
  * error.locations; // => [{ line: 1, column: 3 }]

package/error/locatedError.d.ts

@@ -17,9 +17,7 @@ import { GraphQLError } from "./GraphQLError.js";
  *
  * const document = parse('{ viewer { name } }');
  * const fieldNode = document.definitions[0].selectionSet.selections[0];
- * const error = locatedError(new Error('Resolver failed'), fieldNode, [
- *   'viewer',
- * ]);
+ * const error = locatedError(new Error('Resolver failed'), fieldNode, ['viewer']);
  *
  * error.message; // => 'Resolver failed'
  * error.locations; // => [{ line: 1, column: 3 }]

package/error/locatedError.js.map

@@ -1 +1 @@
-{"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"]}
+{"version":3,"file":"locatedError.js","sourceRoot":"","sources":["../../src/error/locatedError.ts"],"names":[],"mappings":";;AA+BA,oCAmBC;AA/CD,sDAAgD;AAIhD,uDAAiD;AAwBjD,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, ['viewer']);\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.map

@@ -1 +1 @@
-{"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"]}
+{"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;AAwBjD,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, ['viewer']);\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/execution/ExecutionArgs.d.mts

@@ -55,6 +55,8 @@ export interface ExecutionArgs {
 export interface ValidatedExecutionArgs {
     /** Schema used for execution. */
     schema: GraphQLSchema;
+    /** Parsed GraphQL document being executed. */
+    document: DocumentNode;
     /** Fragment definitions keyed by fragment name. */
     fragmentDefinitions: ObjMap<FragmentDefinitionNode>;
     /** Fragment details keyed by fragment name. */
@@ -67,6 +69,10 @@ export interface ValidatedExecutionArgs {
     operation: OperationDefinitionNode;
     /** Operation variable values with source metadata and coerced runtime values. */
     variableValues: VariableValues;
+    /** Raw variable values provided by the caller before coercion. */
+    rawVariableValues: Maybe<{
+        readonly [variable: string]: unknown;
+    }>;
     /** Resolver used for fields without an explicit resolver. */
     fieldResolver: GraphQLFieldResolver<any, any>;
     /** Resolver used for abstract types without an explicit type resolver. */

package/execution/ExecutionArgs.d.ts

@@ -55,6 +55,8 @@ export interface ExecutionArgs {
 export interface ValidatedExecutionArgs {
     /** Schema used for execution. */
     schema: GraphQLSchema;
+    /** Parsed GraphQL document being executed. */
+    document: DocumentNode;
     /** Fragment definitions keyed by fragment name. */
     fragmentDefinitions: ObjMap<FragmentDefinitionNode>;
     /** Fragment details keyed by fragment name. */
@@ -67,6 +69,10 @@ export interface ValidatedExecutionArgs {
     operation: OperationDefinitionNode;
     /** Operation variable values with source metadata and coerced runtime values. */
     variableValues: VariableValues;
+    /** Raw variable values provided by the caller before coercion. */
+    rawVariableValues: Maybe<{
+        readonly [variable: string]: unknown;
+    }>;
     /** Resolver used for fields without an explicit resolver. */
     fieldResolver: GraphQLFieldResolver<any, any>;
     /** Resolver used for abstract types without an explicit type resolver. */