@graphql-hive/gateway-runtime 2.4.0-alpha-76512376d2c99167b187648bb90a1d0068fc8f74 → 2.4.0-alpha-475ccdfcc6961ea0cd7ea4755ea6696ff92f6b56

package/CHANGELOG.md

@@ -1,32 +1,90 @@
 # @graphql-hive/gateway-runtime
 
-## 2.4.0-alpha-76512376d2c99167b187648bb90a1d0068fc8f74
+## 2.4.0-alpha-475ccdfcc6961ea0cd7ea4755ea6696ff92f6b56
 ### Minor Changes
 
 
 
-- [#1636](https://github.com/graphql-hive/gateway/pull/1636) [`7651237`](https://github.com/graphql-hive/gateway/commit/76512376d2c99167b187648bb90a1d0068fc8f74) Thanks [@EmrysMyrddin](https://github.com/EmrysMyrddin)! - Expose GraphQLError as OpenTelemetry Events.
+- [#1738](https://github.com/graphql-hive/gateway/pull/1738) [`475ccdf`](https://github.com/graphql-hive/gateway/commit/475ccdfcc6961ea0cd7ea4755ea6696ff92f6b56) Thanks [@EmrysMyrddin](https://github.com/EmrysMyrddin)! - ## New Hive CDN mirror and circuit breaker
   
-  Errors contains in the result of a graphql operation are now reported as standalone OpenTelemetry
-  Events (name `graphql.error`) instead of OpenTelemetry Exceptions.
+  Hive CDN introduced a new CDN mirror and circuit breaker to mitigate the risk related to Cloudflare
+  services failures.
   
-  This is aligned with the guidance of the Graphql OpenTelemetry working group.
+  You can now provide multiple endpoint in Hive Console related features, and configure the circuit
+  breaker handling CDN failure and how it switches to the CDN mirror.
   
-  It allows to add more graphql specific attributes to errors reported in a response:
+  ### Usage
   
-  - `message`: The error message
-  - `path`: The path in the operation document from which the error originated
-  - `locations`: The list of related locations in the document source
-  - `coordinate`: The schema coordinate of the resolver which is the source of the error
+  To enable this feature, please provide the mirror endpoint in `supergraph` and `persistedDocument`
+  options:
   
-  This brings the experimental support of the `coordinate` error attribute in the Yoga Runtime. For
-  security reason, this attribute is purposefully not serialized, to avoid leaking schema information
-  to clients.
+  ```diff
+  import { defineConfig } from '@graphql-hive/gateway'
+  
+  export const gatewayConfig = defineConfig({
+    supergraph: {
+      type: 'hive',
+  -   endpoint: 'https://cdn.graphql-hive.com/artifacts/v1/...../supergraph',
+  +   endpoint: [
+  +     'https://cdn.graphql-hive.com/artifacts/v1/...../supergraph',
+  +     'https://cdn-mirror.graphql-hive.com/artifacts/v1/...../supergraph'
+  +   ]
+    },
+  
+    persistedDocuments: {
+  -   endpoint: 'https://cdn.graphql-hive.com/artifacts/v1/...',
+  +   endpoint: [
+  +     'https://cdn.graphql-hive.com/artifacts/v1/...',
+  +     'https://cdn-mirror.graphql-hive.com/artifacts/v1/...'
+  +   ]
+    }
+  })
+  ```
+  
+  ### Configuration
+  
+  The circuit breaker has production ready default configuration, but you customize its behavior:
+  
+  ```ts
+  import { defineConfig, CircuitBreakerConfiguration } from '@graphql-hive/gateway';
+  
+  const circuitBreaker: CircuitBreakerConfiguration = {
+      resetTimeout: 30_000; // 30s
+      errorThresholdPercentage: 50;
+      volumeThreshold: 5;
+  }
+  
+  export const gatewayConfig = defineConfig({
+    supergraph: {
+      type: 'hive',
+      endpoint: [...],
+      circuitBreaker,
+    },
+  
+    persistedDocuments: {
+      type: 'hive',
+      endpoint: [...],
+      circuitBreaker,
+    },
+  });
+  ```
 
 ### Patch Changes
 
-- Updated dependencies []:
+
+
+- [#1725](https://github.com/graphql-hive/gateway/pull/1725) [`0ded04f`](https://github.com/graphql-hive/gateway/commit/0ded04f56d9d9dea8c412e2e320fb89815108362) Thanks [@dependabot](https://github.com/apps/dependabot)! - dependencies updates:
+  
+  - Updated dependency [`@graphql-hive/core@^0.15.1` ↗︎](https://www.npmjs.com/package/@graphql-hive/core/v/0.15.1) (from `^0.13.2`, in `dependencies`)
+  - Updated dependency [`@graphql-hive/yoga@^0.43.1` ↗︎](https://www.npmjs.com/package/@graphql-hive/yoga/v/0.43.1) (from `^0.42.4`, in `dependencies`)
+- Updated dependencies [[`bc6cddd`](https://github.com/graphql-hive/gateway/commit/bc6cddd1c53a012dd02a1d8a7217a28e65cc6ae9), [`bc6cddd`](https://github.com/graphql-hive/gateway/commit/bc6cddd1c53a012dd02a1d8a7217a28e65cc6ae9), [`1dbc653`](https://github.com/graphql-hive/gateway/commit/1dbc6536cb992a705cac7894acca6fe5431b72de), [`bc6cddd`](https://github.com/graphql-hive/gateway/commit/bc6cddd1c53a012dd02a1d8a7217a28e65cc6ae9)]:
+  - @graphql-mesh/fusion-runtime@1.6.0-alpha-475ccdfcc6961ea0cd7ea4755ea6696ff92f6b56
+  - @graphql-tools/wrap@11.1.0-alpha-475ccdfcc6961ea0cd7ea4755ea6696ff92f6b56
+  - @graphql-tools/delegate@12.0.0-alpha-475ccdfcc6961ea0cd7ea4755ea6696ff92f6b56
+  - @graphql-tools/stitch@10.1.4-alpha-475ccdfcc6961ea0cd7ea4755ea6696ff92f6b56
   - @graphql-mesh/hmac-upstream-signature@2.0.8
+  - @graphql-tools/federation@4.2.4-alpha-475ccdfcc6961ea0cd7ea4755ea6696ff92f6b56
+  - @graphql-tools/batch-delegate@10.0.6-alpha-475ccdfcc6961ea0cd7ea4755ea6696ff92f6b56
 
 ## 2.3.5
 ### Patch Changes

package/dist/index.cjs

@@ -143,8 +143,7 @@ const getExecuteFnFromExecutor = utils.memoize1(
         operationName: args.operationName ?? void 0,
         rootValue: args.rootValue,
         context: args.contextValue,
-        signal: args.signal,
-        schemaCoordinateInErrors: args.schemaCoordinateInErrors
+        signal: args.signal
       });
     };
   }
@@ -608,6 +607,7 @@ function getReportingPlugin(config, configContext, allowArbitraryDocuments = fal
             endpoint: config.persistedDocuments.endpoint,
             accessToken: config.persistedDocuments.token
           },
+          circuitBreaker: config.persistedDocuments.circuitBreaker,
           // Trick to satisfy the Hive Console plugin types
           allowArbitraryDocuments
         }
@@ -2043,6 +2043,7 @@ function createGatewayRuntime(config) {
           endpoint: config.persistedDocuments.endpoint,
           accessToken: config.persistedDocuments.token
         },
+        circuitBreaker: config.persistedDocuments.circuitBreaker,
         // @ts-expect-error - Hive Console plugin options are not compatible yet
         allowArbitraryDocuments: allowArbitraryDocumentsForPersistedDocuments
       }
@@ -2062,7 +2063,7 @@ function createGatewayRuntime(config) {
         clearTimeout(currentTimeout);
       }
       if (pollingInterval) {
-        currentTimeout = setTimeout(schemaFetcher, pollingInterval);
+        currentTimeout = setTimeout(schemaFetcher.fetch, pollingInterval);
       }
     }, pausePolling2 = function() {
       if (currentTimeout) {
@@ -2086,81 +2087,99 @@ function createGatewayRuntime(config) {
     let initialFetch$;
     let schemaFetcher;
     if (config.schema && typeof config.schema === "object" && "type" in config.schema) {
-      const { endpoint, key } = config.schema;
-      const fetcher = core$1.createSchemaFetcher({
-        endpoint,
-        key,
-        logger: logger.LegacyLogger.from(
-          configContext.log.child("[hiveSchemaFetcher] ")
+      const { endpoint, key, circuitBreaker } = config.schema;
+      const endpoints = (Array.isArray(endpoint) ? endpoint : [endpoint]).map(
+        (url) => url.endsWith("/sdl") ? url : core$1.joinUrl(
+          url.endsWith("/services") ? url.substring(0, url.length - 8) : url,
+          "sdl"
         )
+      );
+      const fetcher = core$1.createCDNArtifactFetcher({
+        endpoint: endpoints,
+        circuitBreaker,
+        accessKey: key,
+        logger: configContext.log.child("[hiveSchemaFetcher] ")
       });
-      schemaFetcher = function fetchSchemaFromCDN() {
-        pausePolling2();
-        initialFetch$ = promiseHelpers.handleMaybePromise(fetcher, ({ sdl }) => {
-          {
-            unifiedGraph = graphql.buildSchema(sdl, {
-              assumeValid: true,
-              assumeValidSDL: true
-            });
-          }
-          continuePolling2();
-          return true;
-        });
-        return initialFetch$;
+      schemaFetcher = {
+        fetch: function fetchSchemaFromCDN() {
+          pausePolling2();
+          initialFetch$ = promiseHelpers.handleMaybePromise(
+            fetcher.fetch,
+            ({ contents }) => {
+              {
+                unifiedGraph = graphql.buildSchema(contents, {
+                  assumeValid: true,
+                  assumeValidSDL: true
+                });
+              }
+              continuePolling2();
+              return true;
+            }
+          );
+          return initialFetch$;
+        },
+        dispose: () => fetcher.dispose()
       };
     } else if (config.schema) {
       if (!isDynamicUnifiedGraphSchema(config.schema)) {
         delete config.pollingInterval;
       }
-      schemaFetcher = function fetchSchema() {
-        pausePolling2();
-        initialFetch$ = promiseHelpers.handleMaybePromise(
-          () => handleUnifiedGraphConfig(
-            // @ts-expect-error TODO: what's up with type narrowing
-            config.schema,
-            configContext
-          ),
-          (schema) => {
-            if (graphql.isSchema(schema)) {
-              unifiedGraph = schema;
-            } else if (utils.isDocumentNode(schema)) {
-              unifiedGraph = graphql.buildASTSchema(schema, {
-                assumeValid: true,
-                assumeValidSDL: true
-              });
-            } else {
-              unifiedGraph = graphql.buildSchema(schema, {
-                noLocation: true,
-                assumeValid: true,
-                assumeValidSDL: true
-              });
+      schemaFetcher = {
+        fetch: function fetchSchema() {
+          pausePolling2();
+          initialFetch$ = promiseHelpers.handleMaybePromise(
+            () => handleUnifiedGraphConfig(
+              // @ts-expect-error TODO: what's up with type narrowing
+              config.schema,
+              configContext
+            ),
+            (schema) => {
+              if (graphql.isSchema(schema)) {
+                unifiedGraph = schema;
+              } else if (utils.isDocumentNode(schema)) {
+                unifiedGraph = graphql.buildASTSchema(schema, {
+                  assumeValid: true,
+                  assumeValidSDL: true
+                });
+              } else {
+                unifiedGraph = graphql.buildSchema(schema, {
+                  noLocation: true,
+                  assumeValid: true,
+                  assumeValidSDL: true
+                });
+              }
+              continuePolling2();
+              return true;
             }
-            continuePolling2();
-            return true;
-          }
-        );
-        return initialFetch$;
+          );
+          return initialFetch$;
+        }
       };
     } else {
-      schemaFetcher = function fetchSchemaWithExecutor() {
-        pausePolling2();
-        return promiseHelpers.handleMaybePromise(
-          () => wrap.schemaFromExecutor(proxyExecutor, configContext, {
-            assumeValid: true
-          }),
-          (schema) => {
-            unifiedGraph = schema;
-            continuePolling2();
-            return true;
-          }
-        );
+      schemaFetcher = {
+        fetch: function fetchSchemaWithExecutor() {
+          pausePolling2();
+          return promiseHelpers.handleMaybePromise(
+            () => wrap.schemaFromExecutor(proxyExecutor, configContext, {
+              assumeValid: true
+            }),
+            (schema) => {
+              unifiedGraph = schema;
+              continuePolling2();
+              return true;
+            }
+          );
+        }
       };
     }
-    const instrumentedFetcher = schemaFetcher;
-    schemaFetcher = (...args) => core.getInstrumented(null).asyncFn(
-      instrumentation?.schema,
-      instrumentedFetcher
-    )(...args);
+    const instrumentedFetcher = schemaFetcher.fetch;
+    schemaFetcher = {
+      ...schemaFetcher,
+      fetch: (...args) => core.getInstrumented(null).asyncFn(
+        instrumentation?.schema,
+        instrumentedFetcher
+      )(...args)
+    };
     getSchema = () => {
       if (unifiedGraph != null) {
         return unifiedGraph;
@@ -2171,21 +2190,21 @@ function createGatewayRuntime(config) {
           () => unifiedGraph
         );
       }
-      return promiseHelpers.handleMaybePromise(schemaFetcher, () => unifiedGraph);
+      return promiseHelpers.handleMaybePromise(schemaFetcher.fetch, () => unifiedGraph);
     };
     const shouldSkipValidation = "skipValidation" in config ? config.skipValidation : false;
-    const executorPlugin = {
+    unifiedGraphPlugin = {
       onValidate({ params, setResult }) {
         if (shouldSkipValidation || !params.schema) {
           setResult([]);
         }
       },
-      onDispose() {
+      async onDispose() {
         pausePolling2();
-        return transportExecutorStack.disposeAsync();
+        await transportExecutorStack.disposeAsync();
+        return schemaFetcher.dispose?.();
       }
     };
-    unifiedGraphPlugin = executorPlugin;
     readinessChecker = () => promiseHelpers.handleMaybePromise(
       () => proxyExecutor({
         document: graphql.parse(`query ReadinessCheck { __typename }`, {
@@ -2196,7 +2215,7 @@ function createGatewayRuntime(config) {
     );
     schemaInvalidator = () => {
       unifiedGraph = void 0;
-      initialFetch$ = schemaFetcher();
+      initialFetch$ = schemaFetcher.fetch();
     };
   } else if ("subgraph" in config) {
     let getSubschemaConfig2 = function() {
@@ -2411,31 +2430,40 @@ function createGatewayRuntime(config) {
     let unifiedGraphFetcher;
     if (typeof config.supergraph === "object" && "type" in config.supergraph) {
       if (config.supergraph.type === "hive") {
-        const { endpoint, key } = config.supergraph;
-        const fetcher = core$1.createSupergraphSDLFetcher({
-          endpoint,
-          key,
-          logger: logger.LegacyLogger.from(
-            configContext.log.child("[hiveSupergraphFetcher] ")
-          ),
+        const { endpoint, key, circuitBreaker } = config.supergraph;
+        const endpoints = (Array.isArray(endpoint) ? endpoint : [endpoint]).map(
+          (url) => url.endsWith("/supergraph") ? url : `${url}/supergraph`
+        );
+        const fetcher = core$1.createCDNArtifactFetcher({
+          endpoint: endpoints,
+          accessKey: key,
+          logger: configContext.log.child("[hiveSupergraphFetcher] "),
           // @ts-expect-error - MeshFetch is not compatible with `typeof fetch`
-          fetchImplementation: configContext.fetch,
+          fetch: configContext.fetch,
+          circuitBreaker,
           name: "hive-gateway",
           version: globalThis.__VERSION__
         });
-        unifiedGraphFetcher = () => fetcher().then(({ supergraphSdl }) => supergraphSdl);
+        unifiedGraphFetcher = {
+          fetch: () => fetcher.fetch().then(({ contents }) => contents),
+          dispose: () => fetcher.dispose()
+        };
       } else if (config.supergraph.type === "graphos") {
         const graphosFetcherContainer = createGraphOSFetcher({
           graphosOpts: config.supergraph,
           configContext,
           pollingInterval: config.pollingInterval
         });
-        unifiedGraphFetcher = graphosFetcherContainer.unifiedGraphFetcher;
+        unifiedGraphFetcher = {
+          fetch: graphosFetcherContainer.unifiedGraphFetcher
+        };
       } else {
-        unifiedGraphFetcher = () => {
-          throw new Error(
-            `Unknown supergraph configuration: ${config.supergraph}`
-          );
+        unifiedGraphFetcher = {
+          fetch: () => {
+            throw new Error(
+              `Unknown supergraph configuration: ${config.supergraph}`
+            );
+          }
         };
       }
     } else {
@@ -2447,20 +2475,25 @@ function createGatewayRuntime(config) {
           `Polling interval not set for supergraph, if you want to get updates of supergraph, we recommend setting a polling interval`
         );
       }
-      unifiedGraphFetcher = () => handleUnifiedGraphConfig(
-        // @ts-expect-error TODO: what's up with type narrowing
-        config.supergraph,
-        configContext
-      );
+      unifiedGraphFetcher = {
+        fetch: () => handleUnifiedGraphConfig(
+          // @ts-expect-error TODO: what's up with type narrowing
+          config.supergraph,
+          configContext
+        )
+      };
     }
-    const instrumentedGraphFetcher = unifiedGraphFetcher;
-    unifiedGraphFetcher = (...args) => core.getInstrumented(null).asyncFn(
-      instrumentation?.schema,
-      instrumentedGraphFetcher
-    )(...args);
+    const instrumentedGraphFetcher = unifiedGraphFetcher.fetch;
+    unifiedGraphFetcher = {
+      ...unifiedGraphFetcher,
+      fetch: (...args) => core.getInstrumented(null).asyncFn(
+        instrumentation?.schema,
+        instrumentedGraphFetcher
+      )(...args)
+    };
     const unifiedGraphManager = new fusionRuntime.UnifiedGraphManager({
       handleUnifiedGraph: config.unifiedGraphHandler,
-      getUnifiedGraph: unifiedGraphFetcher,
+      getUnifiedGraph: unifiedGraphFetcher.fetch,
       onUnifiedGraphChange(newUnifiedGraph) {
         unifiedGraph = newUnifiedGraph;
         replaceSchema(newUnifiedGraph);
@@ -2510,7 +2543,9 @@ function createGatewayRuntime(config) {
     getExecutor = () => unifiedGraphManager.getExecutor();
     unifiedGraphPlugin = {
       onDispose() {
-        return utils$1.dispose(unifiedGraphManager);
+        return promiseHelpers.unfakePromise(
+          promiseHelpers.fakePromise(void 0).then(() => utils$1.dispose(unifiedGraphManager)).then(() => unifiedGraphFetcher.dispose?.())
+        );
       }
     };
   }

package/dist/index.d.cts

@@ -5,6 +5,8 @@ import { Plugin as Plugin$1 } from '@envelop/core';
 export { withState } from '@envelop/core';
 import { GenericAuthPluginOptions } from '@envelop/generic-auth';
 export { ResolveUserFn, ValidateUserFn } from '@envelop/generic-auth';
+import { HivePluginOptions, CircuitBreakerConfiguration } from '@graphql-hive/core';
+export { CircuitBreakerConfiguration } from '@graphql-hive/core';
 import { Logger, LogLevel } from '@graphql-hive/logger';
 export * from '@graphql-hive/logger';
 import { PubSub } from '@graphql-hive/pubsub';
@@ -22,7 +24,6 @@ import { UsePersistedOperationsOptions } from '@graphql-yoga/plugin-persisted-op
 import { GraphQLResolveInfo } from 'graphql/type';
 import { Agent } from 'node:http';
 import { Agent as Agent$1 } from 'node:https';
-import { HivePluginOptions } from '@graphql-hive/core';
 import { FetchAPI } from '@whatwg-node/server';
 export * from '@whatwg-node/disposablestack';
 import { Context, ConnectionInitMessage, ServerOptions } from 'graphql-ws';
@@ -414,11 +415,12 @@ interface GatewayHiveCDNOptions {
     /**
      * GraphQL Hive CDN endpoint URL.
      */
-    endpoint: string;
+    endpoint: string | [string, string];
     /**
      * GraphQL Hive CDN access key.
      */
     key: string;
+    circuitBreaker?: CircuitBreakerConfiguration;
 }
 interface GatewayHiveReportingOptions extends Omit<HiveConsolePluginOptions, 'experimental__persistedDocuments'> {
     type: 'hive';
@@ -507,7 +509,11 @@ interface GatewayHivePersistedDocumentsOptions {
     /**
      * GraphQL Hive persisted documents CDN endpoint URL.
      */
-    endpoint: string;
+    endpoint: string | [string, string];
+    /**
+     * Circuit Breaker configuration to customize CDN failures handling and switch to mirror endpoint.
+     */
+    circuitBreaker?: CircuitBreakerConfiguration;
     /**
      * GraphQL Hive persisted documents CDN access token.
      */

package/dist/index.d.ts

@@ -5,6 +5,8 @@ import { Plugin as Plugin$1 } from '@envelop/core';
 export { withState } from '@envelop/core';
 import { GenericAuthPluginOptions } from '@envelop/generic-auth';
 export { ResolveUserFn, ValidateUserFn } from '@envelop/generic-auth';
+import { HivePluginOptions, CircuitBreakerConfiguration } from '@graphql-hive/core';
+export { CircuitBreakerConfiguration } from '@graphql-hive/core';
 import { Logger, LogLevel } from '@graphql-hive/logger';
 export * from '@graphql-hive/logger';
 import { PubSub } from '@graphql-hive/pubsub';
@@ -22,7 +24,6 @@ import { UsePersistedOperationsOptions } from '@graphql-yoga/plugin-persisted-op
 import { GraphQLResolveInfo } from 'graphql/type';
 import { Agent } from 'node:http';
 import { Agent as Agent$1 } from 'node:https';
-import { HivePluginOptions } from '@graphql-hive/core';
 import { FetchAPI } from '@whatwg-node/server';
 export * from '@whatwg-node/disposablestack';
 import { Context, ConnectionInitMessage, ServerOptions } from 'graphql-ws';
@@ -414,11 +415,12 @@ interface GatewayHiveCDNOptions {
     /**
      * GraphQL Hive CDN endpoint URL.
      */
-    endpoint: string;
+    endpoint: string | [string, string];
     /**
      * GraphQL Hive CDN access key.
      */
     key: string;
+    circuitBreaker?: CircuitBreakerConfiguration;
 }
 interface GatewayHiveReportingOptions extends Omit<HiveConsolePluginOptions, 'experimental__persistedDocuments'> {
     type: 'hive';
@@ -507,7 +509,11 @@ interface GatewayHivePersistedDocumentsOptions {
     /**
      * GraphQL Hive persisted documents CDN endpoint URL.
      */
-    endpoint: string;
+    endpoint: string | [string, string];
+    /**
+     * Circuit Breaker configuration to customize CDN failures handling and switch to mirror endpoint.
+     */
+    circuitBreaker?: CircuitBreakerConfiguration;
     /**
      * GraphQL Hive persisted documents CDN access token.
      */

package/dist/index.js

@@ -2,7 +2,7 @@ import { isOriginalGraphQLError, getInstrumented as getInstrumented$1 } from '@e
 export { withState } from '@envelop/core';
 import { useDisableIntrospection } from '@envelop/disable-introspection';
 import { useGenericAuth } from '@envelop/generic-auth';
-import { createSchemaFetcher, createSupergraphSDLFetcher } from '@graphql-hive/core';
+import { joinUrl, createCDNArtifactFetcher } from '@graphql-hive/core';
 import { Logger, LegacyLogger } from '@graphql-hive/logger';
 export * from '@graphql-hive/logger';
 import { millisecondsToStr, getOnSubgraphExecute, UnifiedGraphManager, restoreExtraDirectives, getTransportEntryMapUsingFusionAndFederationDirectives, getStitchingDirectivesTransformerForSubschema, handleFederationSubschema, handleResolveToDirectives } from '@graphql-mesh/fusion-runtime';
@@ -15,15 +15,15 @@ import { batchDelegateToSchema } from '@graphql-tools/batch-delegate';
 import { getTypeInfo, EMPTY_OBJECT, delegateToSchema, defaultMergedResolver } from '@graphql-tools/delegate';
 import { defaultPrintFn as defaultPrintFn$1 } from '@graphql-tools/executor-common';
 import { getDirectiveExtensions, memoize1, mergeDeep, isValidPath, pathToArray, memoize3, getDirective, createGraphQLError, isAsyncIterable, mapAsyncIterator, createDeferred, isPromise, isDocumentNode, asArray, printSchemaWithDirectives, parseSelectionSet } from '@graphql-tools/utils';
-import { wrapSchema, schemaFromExecutor } from '@graphql-tools/wrap';
+import { schemaFromExecutor, wrapSchema } from '@graphql-tools/wrap';
 import { useCSRFPrevention } from '@graphql-yoga/plugin-csrf-prevention';
 import { useDeferStream } from '@graphql-yoga/plugin-defer-stream';
 import { usePersistedOperations } from '@graphql-yoga/plugin-persisted-operations';
 import { AsyncDisposableStack } from '@whatwg-node/disposablestack';
 export * from '@whatwg-node/disposablestack';
-import { handleMaybePromise, iterateAsync } from '@whatwg-node/promise-helpers';
+import { handleMaybePromise, iterateAsync, unfakePromise, fakePromise } from '@whatwg-node/promise-helpers';
 import { useCookies } from '@whatwg-node/server-plugin-cookies';
-import { print, visit, visitWithTypeInfo, getArgumentValues, getNamedType, isIntrospectionType, isListType, isCompositeType, getOperationAST, isSchema, parse, buildASTSchema, buildSchema } from 'graphql';
+import { print, visit, visitWithTypeInfo, getArgumentValues, getNamedType, isIntrospectionType, isListType, isCompositeType, getOperationAST, isSchema, parse, buildSchema, buildASTSchema } from 'graphql';
 import { isAsyncIterable as isAsyncIterable$1, useReadinessCheck, useExecutionCancellation, createYoga, chain, mergeSchemas } from 'graphql-yoga';
 import { DEFAULT_UPLINKS, fetchSupergraphSdlFromManagedFederation } from '@graphql-tools/federation';
 import { useApolloUsageReport } from '@graphql-yoga/plugin-apollo-usage-report';
@@ -142,8 +142,7 @@ const getExecuteFnFromExecutor = memoize1(
         operationName: args.operationName ?? void 0,
         rootValue: args.rootValue,
         context: args.contextValue,
-        signal: args.signal,
-        schemaCoordinateInErrors: args.schemaCoordinateInErrors
+        signal: args.signal
       });
     };
   }
@@ -607,6 +606,7 @@ function getReportingPlugin(config, configContext, allowArbitraryDocuments = fal
             endpoint: config.persistedDocuments.endpoint,
             accessToken: config.persistedDocuments.token
           },
+          circuitBreaker: config.persistedDocuments.circuitBreaker,
           // Trick to satisfy the Hive Console plugin types
           allowArbitraryDocuments
         }
@@ -2042,6 +2042,7 @@ function createGatewayRuntime(config) {
           endpoint: config.persistedDocuments.endpoint,
           accessToken: config.persistedDocuments.token
         },
+        circuitBreaker: config.persistedDocuments.circuitBreaker,
         // @ts-expect-error - Hive Console plugin options are not compatible yet
         allowArbitraryDocuments: allowArbitraryDocumentsForPersistedDocuments
       }
@@ -2061,7 +2062,7 @@ function createGatewayRuntime(config) {
         clearTimeout(currentTimeout);
       }
       if (pollingInterval) {
-        currentTimeout = setTimeout(schemaFetcher, pollingInterval);
+        currentTimeout = setTimeout(schemaFetcher.fetch, pollingInterval);
       }
     }, pausePolling2 = function() {
       if (currentTimeout) {
@@ -2085,81 +2086,99 @@ function createGatewayRuntime(config) {
     let initialFetch$;
     let schemaFetcher;
     if (config.schema && typeof config.schema === "object" && "type" in config.schema) {
-      const { endpoint, key } = config.schema;
-      const fetcher = createSchemaFetcher({
-        endpoint,
-        key,
-        logger: LegacyLogger.from(
-          configContext.log.child("[hiveSchemaFetcher] ")
+      const { endpoint, key, circuitBreaker } = config.schema;
+      const endpoints = (Array.isArray(endpoint) ? endpoint : [endpoint]).map(
+        (url) => url.endsWith("/sdl") ? url : joinUrl(
+          url.endsWith("/services") ? url.substring(0, url.length - 8) : url,
+          "sdl"
         )
+      );
+      const fetcher = createCDNArtifactFetcher({
+        endpoint: endpoints,
+        circuitBreaker,
+        accessKey: key,
+        logger: configContext.log.child("[hiveSchemaFetcher] ")
       });
-      schemaFetcher = function fetchSchemaFromCDN() {
-        pausePolling2();
-        initialFetch$ = handleMaybePromise(fetcher, ({ sdl }) => {
-          {
-            unifiedGraph = buildSchema(sdl, {
-              assumeValid: true,
-              assumeValidSDL: true
-            });
-          }
-          continuePolling2();
-          return true;
-        });
-        return initialFetch$;
+      schemaFetcher = {
+        fetch: function fetchSchemaFromCDN() {
+          pausePolling2();
+          initialFetch$ = handleMaybePromise(
+            fetcher.fetch,
+            ({ contents }) => {
+              {
+                unifiedGraph = buildSchema(contents, {
+                  assumeValid: true,
+                  assumeValidSDL: true
+                });
+              }
+              continuePolling2();
+              return true;
+            }
+          );
+          return initialFetch$;
+        },
+        dispose: () => fetcher.dispose()
       };
     } else if (config.schema) {
       if (!isDynamicUnifiedGraphSchema(config.schema)) {
         delete config.pollingInterval;
       }
-      schemaFetcher = function fetchSchema() {
-        pausePolling2();
-        initialFetch$ = handleMaybePromise(
-          () => handleUnifiedGraphConfig(
-            // @ts-expect-error TODO: what's up with type narrowing
-            config.schema,
-            configContext
-          ),
-          (schema) => {
-            if (isSchema(schema)) {
-              unifiedGraph = schema;
-            } else if (isDocumentNode(schema)) {
-              unifiedGraph = buildASTSchema(schema, {
-                assumeValid: true,
-                assumeValidSDL: true
-              });
-            } else {
-              unifiedGraph = buildSchema(schema, {
-                noLocation: true,
-                assumeValid: true,
-                assumeValidSDL: true
-              });
+      schemaFetcher = {
+        fetch: function fetchSchema() {
+          pausePolling2();
+          initialFetch$ = handleMaybePromise(
+            () => handleUnifiedGraphConfig(
+              // @ts-expect-error TODO: what's up with type narrowing
+              config.schema,
+              configContext
+            ),
+            (schema) => {
+              if (isSchema(schema)) {
+                unifiedGraph = schema;
+              } else if (isDocumentNode(schema)) {
+                unifiedGraph = buildASTSchema(schema, {
+                  assumeValid: true,
+                  assumeValidSDL: true
+                });
+              } else {
+                unifiedGraph = buildSchema(schema, {
+                  noLocation: true,
+                  assumeValid: true,
+                  assumeValidSDL: true
+                });
+              }
+              continuePolling2();
+              return true;
             }
-            continuePolling2();
-            return true;
-          }
-        );
-        return initialFetch$;
+          );
+          return initialFetch$;
+        }
       };
     } else {
-      schemaFetcher = function fetchSchemaWithExecutor() {
-        pausePolling2();
-        return handleMaybePromise(
-          () => schemaFromExecutor(proxyExecutor, configContext, {
-            assumeValid: true
-          }),
-          (schema) => {
-            unifiedGraph = schema;
-            continuePolling2();
-            return true;
-          }
-        );
+      schemaFetcher = {
+        fetch: function fetchSchemaWithExecutor() {
+          pausePolling2();
+          return handleMaybePromise(
+            () => schemaFromExecutor(proxyExecutor, configContext, {
+              assumeValid: true
+            }),
+            (schema) => {
+              unifiedGraph = schema;
+              continuePolling2();
+              return true;
+            }
+          );
+        }
       };
     }
-    const instrumentedFetcher = schemaFetcher;
-    schemaFetcher = (...args) => getInstrumented$1(null).asyncFn(
-      instrumentation?.schema,
-      instrumentedFetcher
-    )(...args);
+    const instrumentedFetcher = schemaFetcher.fetch;
+    schemaFetcher = {
+      ...schemaFetcher,
+      fetch: (...args) => getInstrumented$1(null).asyncFn(
+        instrumentation?.schema,
+        instrumentedFetcher
+      )(...args)
+    };
     getSchema = () => {
       if (unifiedGraph != null) {
         return unifiedGraph;
@@ -2170,21 +2189,21 @@ function createGatewayRuntime(config) {
           () => unifiedGraph
         );
       }
-      return handleMaybePromise(schemaFetcher, () => unifiedGraph);
+      return handleMaybePromise(schemaFetcher.fetch, () => unifiedGraph);
     };
     const shouldSkipValidation = "skipValidation" in config ? config.skipValidation : false;
-    const executorPlugin = {
+    unifiedGraphPlugin = {
       onValidate({ params, setResult }) {
         if (shouldSkipValidation || !params.schema) {
           setResult([]);
         }
       },
-      onDispose() {
+      async onDispose() {
         pausePolling2();
-        return transportExecutorStack.disposeAsync();
+        await transportExecutorStack.disposeAsync();
+        return schemaFetcher.dispose?.();
       }
     };
-    unifiedGraphPlugin = executorPlugin;
     readinessChecker = () => handleMaybePromise(
       () => proxyExecutor({
         document: parse(`query ReadinessCheck { __typename }`, {
@@ -2195,7 +2214,7 @@ function createGatewayRuntime(config) {
     );
     schemaInvalidator = () => {
       unifiedGraph = void 0;
-      initialFetch$ = schemaFetcher();
+      initialFetch$ = schemaFetcher.fetch();
     };
   } else if ("subgraph" in config) {
     let getSubschemaConfig2 = function() {
@@ -2410,31 +2429,40 @@ function createGatewayRuntime(config) {
     let unifiedGraphFetcher;
     if (typeof config.supergraph === "object" && "type" in config.supergraph) {
       if (config.supergraph.type === "hive") {
-        const { endpoint, key } = config.supergraph;
-        const fetcher = createSupergraphSDLFetcher({
-          endpoint,
-          key,
-          logger: LegacyLogger.from(
-            configContext.log.child("[hiveSupergraphFetcher] ")
-          ),
+        const { endpoint, key, circuitBreaker } = config.supergraph;
+        const endpoints = (Array.isArray(endpoint) ? endpoint : [endpoint]).map(
+          (url) => url.endsWith("/supergraph") ? url : `${url}/supergraph`
+        );
+        const fetcher = createCDNArtifactFetcher({
+          endpoint: endpoints,
+          accessKey: key,
+          logger: configContext.log.child("[hiveSupergraphFetcher] "),
           // @ts-expect-error - MeshFetch is not compatible with `typeof fetch`
-          fetchImplementation: configContext.fetch,
+          fetch: configContext.fetch,
+          circuitBreaker,
           name: "hive-gateway",
           version: globalThis.__VERSION__
         });
-        unifiedGraphFetcher = () => fetcher().then(({ supergraphSdl }) => supergraphSdl);
+        unifiedGraphFetcher = {
+          fetch: () => fetcher.fetch().then(({ contents }) => contents),
+          dispose: () => fetcher.dispose()
+        };
       } else if (config.supergraph.type === "graphos") {
         const graphosFetcherContainer = createGraphOSFetcher({
           graphosOpts: config.supergraph,
           configContext,
           pollingInterval: config.pollingInterval
         });
-        unifiedGraphFetcher = graphosFetcherContainer.unifiedGraphFetcher;
+        unifiedGraphFetcher = {
+          fetch: graphosFetcherContainer.unifiedGraphFetcher
+        };
       } else {
-        unifiedGraphFetcher = () => {
-          throw new Error(
-            `Unknown supergraph configuration: ${config.supergraph}`
-          );
+        unifiedGraphFetcher = {
+          fetch: () => {
+            throw new Error(
+              `Unknown supergraph configuration: ${config.supergraph}`
+            );
+          }
         };
       }
     } else {
@@ -2446,20 +2474,25 @@ function createGatewayRuntime(config) {
           `Polling interval not set for supergraph, if you want to get updates of supergraph, we recommend setting a polling interval`
         );
       }
-      unifiedGraphFetcher = () => handleUnifiedGraphConfig(
-        // @ts-expect-error TODO: what's up with type narrowing
-        config.supergraph,
-        configContext
-      );
+      unifiedGraphFetcher = {
+        fetch: () => handleUnifiedGraphConfig(
+          // @ts-expect-error TODO: what's up with type narrowing
+          config.supergraph,
+          configContext
+        )
+      };
     }
-    const instrumentedGraphFetcher = unifiedGraphFetcher;
-    unifiedGraphFetcher = (...args) => getInstrumented$1(null).asyncFn(
-      instrumentation?.schema,
-      instrumentedGraphFetcher
-    )(...args);
+    const instrumentedGraphFetcher = unifiedGraphFetcher.fetch;
+    unifiedGraphFetcher = {
+      ...unifiedGraphFetcher,
+      fetch: (...args) => getInstrumented$1(null).asyncFn(
+        instrumentation?.schema,
+        instrumentedGraphFetcher
+      )(...args)
+    };
     const unifiedGraphManager = new UnifiedGraphManager({
       handleUnifiedGraph: config.unifiedGraphHandler,
-      getUnifiedGraph: unifiedGraphFetcher,
+      getUnifiedGraph: unifiedGraphFetcher.fetch,
       onUnifiedGraphChange(newUnifiedGraph) {
         unifiedGraph = newUnifiedGraph;
         replaceSchema(newUnifiedGraph);
@@ -2509,7 +2542,9 @@ function createGatewayRuntime(config) {
     getExecutor = () => unifiedGraphManager.getExecutor();
     unifiedGraphPlugin = {
       onDispose() {
-        return dispose(unifiedGraphManager);
+        return unfakePromise(
+          fakePromise(void 0).then(() => dispose(unifiedGraphManager)).then(() => unifiedGraphFetcher.dispose?.())
+        );
       }
     };
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graphql-hive/gateway-runtime",
-  "version": "2.4.0-alpha-76512376d2c99167b187648bb90a1d0068fc8f74",
+  "version": "2.4.0-alpha-475ccdfcc6961ea0cd7ea4755ea6696ff92f6b56",
   "type": "module",
   "repository": {
     "type": "git",
@@ -49,26 +49,26 @@
     "@envelop/disable-introspection": "^9.0.0",
     "@envelop/generic-auth": "^11.0.0",
     "@envelop/instrumentation": "^1.0.0",
-    "@graphql-hive/core": "^0.13.2",
+    "@graphql-hive/core": "^0.15.1",
     "@graphql-hive/logger": "^1.0.9",
     "@graphql-hive/pubsub": "^2.1.1",
     "@graphql-hive/signal": "^2.0.0",
-    "@graphql-hive/yoga": "^0.42.4",
+    "@graphql-hive/yoga": "^0.43.1",
     "@graphql-mesh/cross-helpers": "^0.4.10",
-    "@graphql-mesh/fusion-runtime": "^1.5.1",
+    "@graphql-mesh/fusion-runtime": "1.6.0-alpha-475ccdfcc6961ea0cd7ea4755ea6696ff92f6b56",
     "@graphql-mesh/hmac-upstream-signature": "^2.0.8",
     "@graphql-mesh/plugin-response-cache": "^0.104.18",
     "@graphql-mesh/transport-common": "^1.0.12",
     "@graphql-mesh/types": "^0.104.16",
     "@graphql-mesh/utils": "^0.104.16",
-    "@graphql-tools/batch-delegate": "^10.0.5",
-    "@graphql-tools/delegate": "^11.1.3",
+    "@graphql-tools/batch-delegate": "10.0.6-alpha-475ccdfcc6961ea0cd7ea4755ea6696ff92f6b56",
+    "@graphql-tools/delegate": "12.0.0-alpha-475ccdfcc6961ea0cd7ea4755ea6696ff92f6b56",
     "@graphql-tools/executor-common": "^1.0.5",
     "@graphql-tools/executor-http": "^3.0.7",
-    "@graphql-tools/federation": "^4.2.3",
-    "@graphql-tools/stitch": "^10.1.3",
+    "@graphql-tools/federation": "4.2.4-alpha-475ccdfcc6961ea0cd7ea4755ea6696ff92f6b56",
+    "@graphql-tools/stitch": "10.1.4-alpha-475ccdfcc6961ea0cd7ea4755ea6696ff92f6b56",
     "@graphql-tools/utils": "^10.10.3",
-    "@graphql-tools/wrap": "^11.0.5",
+    "@graphql-tools/wrap": "11.1.0-alpha-475ccdfcc6961ea0cd7ea4755ea6696ff92f6b56",
     "@graphql-yoga/plugin-apollo-usage-report": "^0.11.2",
     "@graphql-yoga/plugin-csrf-prevention": "^3.16.2",
     "@graphql-yoga/plugin-defer-stream": "^3.16.2",
@@ -95,7 +95,7 @@
     "graphql": "^16.12.0",
     "graphql-sse": "^2.6.0",
     "html-minifier-terser": "7.2.0",
-    "pkgroll": "2.20.1",
+    "pkgroll": "2.21.3",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
     "tsx": "4.20.6"