graphql 17.0.0-rc.0 → 17.0.1

package/README.md

@@ -1,11 +1,9 @@
-[![GraphQLConf 2025 Banner: September 08-10, Amsterdam. Hosted by the GraphQL Foundation](./assets/graphql-conf-2025.png)](https://graphql.org/conf/2025/?utm_source=github&utm_medium=graphql_js&utm_campaign=readme)
-
 # GraphQL.js
 
 The JavaScript reference implementation for GraphQL, a query language for APIs created by Facebook.
 
 [![npm version](https://badge.fury.io/js/graphql.svg)](https://badge.fury.io/js/graphql)
-[![Build Status](https://github.com/graphql/graphql-js/workflows/CI/badge.svg?branch=main)](https://github.com/graphql/graphql-js/actions?query=branch%3Amain)
+[![Build Status](https://github.com/graphql/graphql-js/actions/workflows/push.yml/badge.svg?branch=17.x.x)](https://github.com/graphql/graphql-js/actions/workflows/push.yml?query=branch%3A17.x.x)
 
 See more complete documentation at https://graphql.org/ and
 https://graphql.org/graphql-js/.
@@ -111,7 +109,7 @@ graphql({ schema, source }).then((result) => {
 ## Want to ride the bleeding edge?
 
 The `npm` branch in this repository is automatically maintained to be the last
-commit to `main` to pass all tests, in the same form found on npm. It is
+commit to `17.x.x` to pass all tests, in the same form found on npm. It is
 recommended to use builds deployed to npm for many reasons, but if you want to use
 the latest not-yet-released version of graphql-js, you can do so by depending
 directly on this branch:
@@ -139,7 +137,7 @@ in files with the `.js` extension and the ESModule build within `.mjs` files.
 
 We actively welcome pull requests. Learn how to [contribute](./.github/CONTRIBUTING.md).
 
-This repository is managed by EasyCLA. Project participants must sign the free ([GraphQL Specification Membership agreement](https://preview-spec-membership.graphql.org) before making a contribution. You only need to do this one time, and it can be signed by [individual contributors](http://individual-spec-membership.graphql.org/) or their [employers](http://corporate-spec-membership.graphql.org/).
+This repository is managed by EasyCLA. Project participants must sign the free [GraphQL Specification Membership agreement](https://preview-spec-membership.graphql.org) before making a contribution. You only need to do this one time, and it can be signed by [individual contributors](http://individual-spec-membership.graphql.org/) or their [employers](http://corporate-spec-membership.graphql.org/).
 
 To initiate the signature process please open a PR against this repo. The EasyCLA bot will block the merge if we still need a membership agreement from you.
 

package/diagnostics.d.mts

@@ -1,13 +1,22 @@
 /**
  * TracingChannel integration.
  *
- * graphql-js publishes lifecycle events on a set of named tracing channels
- * that APM tools can subscribe to in order to observe parse, validate,
- * execute, subscribe, and resolver behavior, plus selected executor internals.
- * At module load time graphql-js resolves `node:diagnostics_channel` itself so
- * APMs do not need to interact with the graphql API to enable tracing. On
- * runtimes that do not expose `node:diagnostics_channel` (e.g., browsers) the
- * load silently no-ops and emission sites short-circuit.
+ * GraphQL.js publishes lifecycle events on a set of named tracing channels
+ * that application performance monitoring (APM) tools can subscribe to in
+ * order to observe parse, validate, execute, subscribe, and resolver behavior,
+ * plus selected executor internals. At module load time GraphQL.js resolves
+ * `node:diagnostics_channel` itself so APMs do not need to interact with the
+ * GraphQL API to enable tracing. On runtimes that do not expose
+ * `node:diagnostics_channel` (e.g., browsers) the load silently no-ops and
+ * emission sites short-circuit.
+ *
+ * Within the tracing context types, `error` means the traced JavaScript call
+ * threw or rejected; it does not mean every `GraphQLError` returned by
+ * GraphQL.js. Some channels complete normally and publish GraphQL errors on
+ * `result`. Resolver errors can appear both as `message.error` on
+ * `graphql:resolve` and as formatted errors in an enclosing execution or
+ * subscription result. `graphql:parse`, `graphql:validate`, and
+ * `graphql:execute:variableCoercion` are sync-only channels.
  * @category Diagnostics
  */
 import type { Maybe } from "./jsutils/Maybe.mjs";
@@ -21,7 +30,7 @@ import type { ExperimentalIncrementalExecutionResults } from "./execution/increm
 import type { VariableValues } from "./execution/values.mjs";
 /**
  * Structural subset of `DiagnosticsChannel` sufficient for publishing and
- * subscriber gating. `node:diagnostics_channel`'s `Channel` satisfies this.
+ * subscriber gating. The `node:diagnostics_channel` `Channel` satisfies this.
  *
  * @internal
  */
@@ -31,9 +40,10 @@ export interface MinimalChannel<TMessage = unknown> {
     runStores: <T, ContextType extends object>(context: ContextType, fn: (this: ContextType, ...args: Array<unknown>) => T, thisArg?: unknown, ...args: Array<unknown>) => T;
 }
 /**
- * Structural subset of Node's `TracingChannel`. The `node:diagnostics_channel`
- * `TracingChannel` satisfies this by duck typing, so graphql-js does not need
- * a dependency on `@types/node` or on the runtime itself.
+ * Structural subset of the Node.js `TracingChannel` API. The
+ * `node:diagnostics_channel` `TracingChannel` satisfies this by duck typing,
+ * so GraphQL.js does not need a dependency on `@types/node` or on the runtime
+ * itself.
  *
  * @internal
  */
@@ -46,9 +56,7 @@ export interface MinimalTracingChannel<TContext = unknown> {
     readonly error: MinimalChannel<TContext>;
     traceSync: <T>(fn: (...args: Array<unknown>) => T, context: TContext extends object ? TContext : object, thisArg?: unknown, ...args: Array<unknown>) => T;
 }
-/**
- * Context published on `graphql:parse`.
- */
+/** Context published on the sync-only `graphql:parse` channel. */
 export interface GraphQLParseContext {
     /** Source text or source object passed to the parser. */
     source: string | Source;
@@ -57,9 +65,7 @@ export interface GraphQLParseContext {
     /** Parsed document, when parsing succeeds. */
     result?: DocumentNode;
 }
-/**
- * Context published on `graphql:validate`.
- */
+/** Context published on the sync-only `graphql:validate` channel. */
 export interface GraphQLValidateContext {
     /** Schema used for validation. */
     schema: GraphQLSchema;
@@ -72,6 +78,8 @@ export interface GraphQLValidateContext {
 }
 /**
  * Context published on `graphql:execute`.
+ *
+ * Returned results may contain GraphQL errors collected during execution.
  */
 export interface GraphQLExecuteContext {
     /** Schema used for execution. */
@@ -86,13 +94,15 @@ export interface GraphQLExecuteContext {
     operationName: string | undefined;
     /** Selected operation type, if one is available. */
     operationType: OperationTypeNode | undefined;
-    /** Error thrown while executing, when execution fails abruptly. */
+    /** Error thrown or rejected while executing, when execution fails abruptly. */
     error?: unknown;
-    /** Execution result returned by execution. */
+    /** Execution result returned by execution, including GraphQL errors. */
     result?: ExecutionResult | ExperimentalIncrementalExecutionResults;
 }
 /**
  * Context published on `graphql:execute:rootSelectionSet`.
+ *
+ * Returned results may contain GraphQL errors collected during execution.
  */
 export interface GraphQLExecuteRootSelectionSetContext {
     /** Schema used for execution. */
@@ -109,18 +119,23 @@ export interface GraphQLExecuteRootSelectionSetContext {
     operationName: string | undefined;
     /** Selected operation type. */
     operationType: OperationTypeNode;
-    /** Error thrown while executing the root selection set. */
+    /** Error thrown or rejected while executing the root selection set. */
     error?: unknown;
-    /** Execution result returned from the root selection set. */
+    /**
+     * Execution result returned from the root selection set, including GraphQL
+     * errors.
+     */
     result?: ExecutionResult | ExperimentalIncrementalExecutionResults;
 }
 /**
  * Context published on `graphql:execute:variableCoercion`.
  *
- * Coercion runs synchronously inside argument validation, so only the
- * `start`/`end` (and, on a thrown error, `error`) lifecycle fires. When
- * coercion produces variable errors it does not throw; instead `result`
- * carries the `errors` array, mirroring `graphql:validate`.
+ * Coercion runs synchronously while execution arguments are validated, so only
+ * the `start`/`end` (and, on an abrupt throw, `error`) lifecycle fires.
+ * Ordinary variable coercion failures are returned on `result.errors`; when
+ * execution is invoked through APIs such as `execute()` or `subscribe()`, they
+ * surface as GraphQL result errors rather than as the tracing `error`
+ * lifecycle event.
  */
 export interface GraphQLExecuteVariableCoercionContext {
     /** Schema used for variable coercion. */
@@ -148,6 +163,11 @@ export interface GraphQLExecuteVariableCoercionContext {
 }
 /**
  * Context published on `graphql:subscribe`.
+ *
+ * Subscription source resolver errors and invalid source stream results are
+ * returned on `result` as ExecutionResult errors; they do not publish the
+ * `error` lifecycle event unless subscription setup fails abruptly before
+ * GraphQL can form a result.
  */
 export interface GraphQLSubscribeContext {
     /** Schema used for subscription execution. */
@@ -162,13 +182,20 @@ export interface GraphQLSubscribeContext {
     operationName: string | undefined;
     /** Selected operation type, if one is available. */
     operationType: OperationTypeNode | undefined;
-    /** Error thrown while subscribing, when subscription setup fails abruptly. */
+    /** Error thrown or rejected while subscribing, when setup fails abruptly. */
     error?: unknown;
-    /** Subscription response stream or execution result returned by subscribe. */
+    /**
+     * Subscription response stream, or an ExecutionResult containing GraphQL
+     * errors.
+     */
     result?: AsyncGenerator<ExecutionResult, void, void> | ExecutionResult;
 }
 /**
  * Context published on `graphql:resolve`.
+ *
+ * Resolver throws and rejections publish the `error` lifecycle event here.
+ * The same failure may also be formatted into the enclosing execution or
+ * subscription result.
  */
 export interface GraphQLResolveContext {
     /** Field name being resolved. */
@@ -185,14 +212,12 @@ export interface GraphQLResolveContext {
     isDefaultResolver: boolean;
     /** Response path for the field being resolved. */
     fieldPath: string;
-    /** Error thrown by the resolver, when resolution fails. */
+    /** Error thrown or rejected by the resolver, when resolution fails. */
     error?: unknown;
-    /** Value returned by the resolver. */
+    /** Value returned by the resolver, when resolution succeeds. */
     result?: unknown;
 }
-/**
- * Mapping from tracing channel name to the context type published on it.
- */
+/** Mapping from tracing channel name to the context type published on it. */
 export interface GraphQLChannelContextByName {
     /** Context published on `graphql:parse`. */
     'graphql:parse': GraphQLParseContext;
@@ -210,10 +235,10 @@ export interface GraphQLChannelContextByName {
     'graphql:resolve': GraphQLResolveContext;
 }
 /**
- * The collection of tracing channels graphql-js emits on. APMs subscribe to
- * these by name on their own `node:diagnostics_channel` import; both paths
- * land on the same channel instance because `tracingChannel(name)` is cached
- * by name.
+ * The collection of tracing channels GraphQL.js emits on. Application
+ * performance monitoring (APM) tools subscribe to these by name on their own
+ * `node:diagnostics_channel` import; both paths land on the same channel
+ * instance because `tracingChannel(name)` is cached by name.
  */
 export interface GraphQLChannels {
     /** Tracing channel for `graphql:execute`. */
@@ -269,8 +294,12 @@ interface TraceLifecycleContext {
 }
 type TraceStartContext<TContext extends TraceLifecycleContext> = Omit<TContext, 'error' | 'result'>;
 /**
- * Publish a mixed sync-or-promise operation through `channel`. Caller has
- * already verified that a subscriber is attached.
+ * Publish a traced call that may complete synchronously or with a promise.
+ * Caller has already verified that a subscriber is attached. On normal
+ * completion, `result` is attached before the terminal `end` or `asyncEnd`
+ * event. When the traced call throws or rejects, `error` is attached, the
+ * `error` sub-channel fires, and the terminal `end` or `asyncEnd` event is
+ * published before the original failure is propagated.
  *
  * @internal
  */

package/diagnostics.d.ts

@@ -1,13 +1,22 @@
 /**
  * TracingChannel integration.
  *
- * graphql-js publishes lifecycle events on a set of named tracing channels
- * that APM tools can subscribe to in order to observe parse, validate,
- * execute, subscribe, and resolver behavior, plus selected executor internals.
- * At module load time graphql-js resolves `node:diagnostics_channel` itself so
- * APMs do not need to interact with the graphql API to enable tracing. On
- * runtimes that do not expose `node:diagnostics_channel` (e.g., browsers) the
- * load silently no-ops and emission sites short-circuit.
+ * GraphQL.js publishes lifecycle events on a set of named tracing channels
+ * that application performance monitoring (APM) tools can subscribe to in
+ * order to observe parse, validate, execute, subscribe, and resolver behavior,
+ * plus selected executor internals. At module load time GraphQL.js resolves
+ * `node:diagnostics_channel` itself so APMs do not need to interact with the
+ * GraphQL API to enable tracing. On runtimes that do not expose
+ * `node:diagnostics_channel` (e.g., browsers) the load silently no-ops and
+ * emission sites short-circuit.
+ *
+ * Within the tracing context types, `error` means the traced JavaScript call
+ * threw or rejected; it does not mean every `GraphQLError` returned by
+ * GraphQL.js. Some channels complete normally and publish GraphQL errors on
+ * `result`. Resolver errors can appear both as `message.error` on
+ * `graphql:resolve` and as formatted errors in an enclosing execution or
+ * subscription result. `graphql:parse`, `graphql:validate`, and
+ * `graphql:execute:variableCoercion` are sync-only channels.
  * @category Diagnostics
  */
 import type { Maybe } from "./jsutils/Maybe.js";
@@ -21,7 +30,7 @@ import type { ExperimentalIncrementalExecutionResults } from "./execution/increm
 import type { VariableValues } from "./execution/values.js";
 /**
  * Structural subset of `DiagnosticsChannel` sufficient for publishing and
- * subscriber gating. `node:diagnostics_channel`'s `Channel` satisfies this.
+ * subscriber gating. The `node:diagnostics_channel` `Channel` satisfies this.
  *
  * @internal
  */
@@ -31,9 +40,10 @@ export interface MinimalChannel<TMessage = unknown> {
     runStores: <T, ContextType extends object>(context: ContextType, fn: (this: ContextType, ...args: Array<unknown>) => T, thisArg?: unknown, ...args: Array<unknown>) => T;
 }
 /**
- * Structural subset of Node's `TracingChannel`. The `node:diagnostics_channel`
- * `TracingChannel` satisfies this by duck typing, so graphql-js does not need
- * a dependency on `@types/node` or on the runtime itself.
+ * Structural subset of the Node.js `TracingChannel` API. The
+ * `node:diagnostics_channel` `TracingChannel` satisfies this by duck typing,
+ * so GraphQL.js does not need a dependency on `@types/node` or on the runtime
+ * itself.
  *
  * @internal
  */
@@ -46,9 +56,7 @@ export interface MinimalTracingChannel<TContext = unknown> {
     readonly error: MinimalChannel<TContext>;
     traceSync: <T>(fn: (...args: Array<unknown>) => T, context: TContext extends object ? TContext : object, thisArg?: unknown, ...args: Array<unknown>) => T;
 }
-/**
- * Context published on `graphql:parse`.
- */
+/** Context published on the sync-only `graphql:parse` channel. */
 export interface GraphQLParseContext {
     /** Source text or source object passed to the parser. */
     source: string | Source;
@@ -57,9 +65,7 @@ export interface GraphQLParseContext {
     /** Parsed document, when parsing succeeds. */
     result?: DocumentNode;
 }
-/**
- * Context published on `graphql:validate`.
- */
+/** Context published on the sync-only `graphql:validate` channel. */
 export interface GraphQLValidateContext {
     /** Schema used for validation. */
     schema: GraphQLSchema;
@@ -72,6 +78,8 @@ export interface GraphQLValidateContext {
 }
 /**
  * Context published on `graphql:execute`.
+ *
+ * Returned results may contain GraphQL errors collected during execution.
  */
 export interface GraphQLExecuteContext {
     /** Schema used for execution. */
@@ -86,13 +94,15 @@ export interface GraphQLExecuteContext {
     operationName: string | undefined;
     /** Selected operation type, if one is available. */
     operationType: OperationTypeNode | undefined;
-    /** Error thrown while executing, when execution fails abruptly. */
+    /** Error thrown or rejected while executing, when execution fails abruptly. */
     error?: unknown;
-    /** Execution result returned by execution. */
+    /** Execution result returned by execution, including GraphQL errors. */
     result?: ExecutionResult | ExperimentalIncrementalExecutionResults;
 }
 /**
  * Context published on `graphql:execute:rootSelectionSet`.
+ *
+ * Returned results may contain GraphQL errors collected during execution.
  */
 export interface GraphQLExecuteRootSelectionSetContext {
     /** Schema used for execution. */
@@ -109,18 +119,23 @@ export interface GraphQLExecuteRootSelectionSetContext {
     operationName: string | undefined;
     /** Selected operation type. */
     operationType: OperationTypeNode;
-    /** Error thrown while executing the root selection set. */
+    /** Error thrown or rejected while executing the root selection set. */
     error?: unknown;
-    /** Execution result returned from the root selection set. */
+    /**
+     * Execution result returned from the root selection set, including GraphQL
+     * errors.
+     */
     result?: ExecutionResult | ExperimentalIncrementalExecutionResults;
 }
 /**
  * Context published on `graphql:execute:variableCoercion`.
  *
- * Coercion runs synchronously inside argument validation, so only the
- * `start`/`end` (and, on a thrown error, `error`) lifecycle fires. When
- * coercion produces variable errors it does not throw; instead `result`
- * carries the `errors` array, mirroring `graphql:validate`.
+ * Coercion runs synchronously while execution arguments are validated, so only
+ * the `start`/`end` (and, on an abrupt throw, `error`) lifecycle fires.
+ * Ordinary variable coercion failures are returned on `result.errors`; when
+ * execution is invoked through APIs such as `execute()` or `subscribe()`, they
+ * surface as GraphQL result errors rather than as the tracing `error`
+ * lifecycle event.
  */
 export interface GraphQLExecuteVariableCoercionContext {
     /** Schema used for variable coercion. */
@@ -148,6 +163,11 @@ export interface GraphQLExecuteVariableCoercionContext {
 }
 /**
  * Context published on `graphql:subscribe`.
+ *
+ * Subscription source resolver errors and invalid source stream results are
+ * returned on `result` as ExecutionResult errors; they do not publish the
+ * `error` lifecycle event unless subscription setup fails abruptly before
+ * GraphQL can form a result.
  */
 export interface GraphQLSubscribeContext {
     /** Schema used for subscription execution. */
@@ -162,13 +182,20 @@ export interface GraphQLSubscribeContext {
     operationName: string | undefined;
     /** Selected operation type, if one is available. */
     operationType: OperationTypeNode | undefined;
-    /** Error thrown while subscribing, when subscription setup fails abruptly. */
+    /** Error thrown or rejected while subscribing, when setup fails abruptly. */
     error?: unknown;
-    /** Subscription response stream or execution result returned by subscribe. */
+    /**
+     * Subscription response stream, or an ExecutionResult containing GraphQL
+     * errors.
+     */
     result?: AsyncGenerator<ExecutionResult, void, void> | ExecutionResult;
 }
 /**
  * Context published on `graphql:resolve`.
+ *
+ * Resolver throws and rejections publish the `error` lifecycle event here.
+ * The same failure may also be formatted into the enclosing execution or
+ * subscription result.
  */
 export interface GraphQLResolveContext {
     /** Field name being resolved. */
@@ -185,14 +212,12 @@ export interface GraphQLResolveContext {
     isDefaultResolver: boolean;
     /** Response path for the field being resolved. */
     fieldPath: string;
-    /** Error thrown by the resolver, when resolution fails. */
+    /** Error thrown or rejected by the resolver, when resolution fails. */
     error?: unknown;
-    /** Value returned by the resolver. */
+    /** Value returned by the resolver, when resolution succeeds. */
     result?: unknown;
 }
-/**
- * Mapping from tracing channel name to the context type published on it.
- */
+/** Mapping from tracing channel name to the context type published on it. */
 export interface GraphQLChannelContextByName {
     /** Context published on `graphql:parse`. */
     'graphql:parse': GraphQLParseContext;
@@ -210,10 +235,10 @@ export interface GraphQLChannelContextByName {
     'graphql:resolve': GraphQLResolveContext;
 }
 /**
- * The collection of tracing channels graphql-js emits on. APMs subscribe to
- * these by name on their own `node:diagnostics_channel` import; both paths
- * land on the same channel instance because `tracingChannel(name)` is cached
- * by name.
+ * The collection of tracing channels GraphQL.js emits on. Application
+ * performance monitoring (APM) tools subscribe to these by name on their own
+ * `node:diagnostics_channel` import; both paths land on the same channel
+ * instance because `tracingChannel(name)` is cached by name.
  */
 export interface GraphQLChannels {
     /** Tracing channel for `graphql:execute`. */
@@ -269,8 +294,12 @@ interface TraceLifecycleContext {
 }
 type TraceStartContext<TContext extends TraceLifecycleContext> = Omit<TContext, 'error' | 'result'>;
 /**
- * Publish a mixed sync-or-promise operation through `channel`. Caller has
- * already verified that a subscriber is attached.
+ * Publish a traced call that may complete synchronously or with a promise.
+ * Caller has already verified that a subscriber is attached. On normal
+ * completion, `result` is attached before the terminal `end` or `asyncEnd`
+ * event. When the traced call throws or rejects, `error` is attached, the
+ * `error` sub-channel fires, and the terminal `end` or `asyncEnd` event is
+ * published before the original failure is propagated.
  *
  * @internal
  */

package/diagnostics.js

@@ -59,14 +59,15 @@ function traceMixed(channel, contextInput, fn) {
             return result;
         }
         channel.end.publish(context);
-        channel.asyncStart.publish(context);
         return result.then((value) => {
             context.result = value;
+            channel.asyncStart.publish(context);
             channel.asyncEnd.publish(context);
             return value;
         }, (err) => {
             context.error = err;
             channel.error.publish(context);
+            channel.asyncStart.publish(context);
             channel.asyncEnd.publish(context);
             throw err;
         });

package/diagnostics.js.map

@@ -1 +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 APM tools can subscribe to in order to observe parse, validate,\n * execute, subscribe, and resolver behavior, plus selected executor internals.\n * At module load time graphql-js resolves `node:diagnostics_channel` itself so\n * APMs do not need to interact with the graphql API to enable tracing. On\n * runtimes that do not expose `node:diagnostics_channel` (e.g., browsers) the\n * load silently no-ops and emission sites short-circuit.\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. `node:diagnostics_channel`'s `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 Node's `TracingChannel`. The `node:diagnostics_channel`\n * `TracingChannel` satisfies this by duck typing, so graphql-js does not need\n * a dependency on `@types/node` or on the runtime 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/**\n * Context published on `graphql:parse`.\n */\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/**\n * Context published on `graphql:validate`.\n */\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 */\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 while executing, when execution fails abruptly. */\n  error?: unknown;\n  /** Execution result returned by execution. */\n  result?: ExecutionResult | ExperimentalIncrementalExecutionResults;\n}\n\n/**\n * Context published on `graphql:execute:rootSelectionSet`.\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 while executing the root selection set. */\n  error?: unknown;\n  /** Execution result returned from the root selection set. */\n  result?: ExecutionResult | ExperimentalIncrementalExecutionResults;\n}\n\n/**\n * Context published on `graphql:execute:variableCoercion`.\n *\n * Coercion runs synchronously inside argument validation, so only the\n * `start`/`end` (and, on a thrown error, `error`) lifecycle fires. When\n * coercion produces variable errors it does not throw; instead `result`\n * carries the `errors` array, mirroring `graphql:validate`.\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 */\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 while subscribing, when subscription setup fails abruptly. */\n  error?: unknown;\n  /** Subscription response stream or execution result returned by subscribe. */\n  result?: AsyncGenerator<ExecutionResult, void, void> | ExecutionResult;\n}\n\n/**\n * Context published on `graphql:resolve`.\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 by the resolver, when resolution fails. */\n  error?: unknown;\n  /** Value returned by the resolver. */\n  result?: unknown;\n}\n\n/**\n * Mapping from tracing channel name to the context type published on it.\n */\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. APMs subscribe to\n * these by name on their own `node:diagnostics_channel` import; both paths\n * land on the same channel instance because `tracingChannel(name)` is cached\n * 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 mixed sync-or-promise operation through `channel`. Caller has\n * already verified that a subscriber is attached.\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"]}
+{"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\n    return result.then(\n      (value) => {\n        context.result = value;\n        channel.asyncStart.publish(context);\n        channel.asyncEnd.publish(context);\n        return value;\n      },\n      (err: unknown) => {\n        context.error = err;\n        channel.error.publish(context);\n        channel.asyncStart.publish(context);\n        channel.asyncEnd.publish(context);\n        throw err;\n      },\n    ) as TResult;\n  });\n}\n"]}

package/diagnostics.mjs

@@ -54,14 +54,15 @@ export function traceMixed(channel, contextInput, fn) {
             return result;
         }
         channel.end.publish(context);
-        channel.asyncStart.publish(context);
         return result.then((value) => {
             context.result = value;
+            channel.asyncStart.publish(context);
             channel.asyncEnd.publish(context);
             return value;
         }, (err) => {
             context.error = err;
             channel.error.publish(context);
+            channel.asyncStart.publish(context);
             channel.asyncEnd.publish(context);
             throw err;
         });