changesets (#7346)

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

Author: n1ru4l

.changeset/big-pig-helps.md

@@ -0,0 +1,72 @@
+---
+'@graphql-hive/core': minor
+'@graphql-hive/apollo': minor
+'@graphql-hive/envelop': minor
+'@graphql-hive/yoga': minor
+---
+
+Add support for providing a logger object via `HivePluginOptions`.
+
+It is possible to provide the following options:
+
+- **'trace'**
+- **'debug'**
+- **'info'** default
+- **'warn'**
+- **'error'**
+
+```ts
+import { createHive } from '@graphql-hive/core'
+
+const client = createHive({
+  logger: 'info'
+})
+```
+
+In addition to that, it is also possible to provide a Hive Logger instance, that allows more control over how you want to log and forward logs.
+
+```ts
+import { createHive } from '@graphql-hive/core'
+import { Logger } from '@graphql-hive/logger'
+
+const client = createHive({
+  logger: new Logger()
+})
+```
+
+Head to our [Hive Logger documentation](https://the-guild.dev/graphql/hive/docs/logger) to learn more.
+
+___
+
+**The `HivePluginOptions.debug` option is now deprecated.** Instead, please use the `logger` option to control logging levels.
+
+```diff
+ import { createHive } from '@graphql-hive/core'
+
+ const client = createHive({
+-  debug: process.env.DEBUG === "1",
++  logger: process.env.DEBUG === "1" ? "debug" : "info",
+ })
+```
+
+**Note**: If the `logger` property is provided, the `debug` option is ignored.
+
+___
+
+**The `HivePluginOptions.agent.logger` option is now deprecated.** Instead, please provide
+`HivePluginOptions.logger`.
+
+```diff
+ import { createHive } from '@graphql-hive/core'
+
+ const logger = new Logger()
+
+ const client = createHive({
+   agent: {
+-    logger,
+   },
++  logger,
+ })
+```
+
+**Note**: If both options are provided, the `agent` option is ignored.

.changeset/brave-tigers-dance.md

@@ -0,0 +1,5 @@
+---
+'@graphql-hive/cli': patch
+---
+
+Fixes an issue where schema changes containing escaped single-quoted strings were not handled correctly.

.changeset/calm-mails-sneeze.md

@@ -0,0 +1,55 @@
+---
+'@graphql-hive/core': minor
+'@graphql-hive/apollo': minor
+'@graphql-hive/yoga': minor
+---
+
+**Persisted Documents Improvements**
+
+Persisted documents now support specifying a mirror endpoint that will be used in case the main CDN
+is unreachable. Provide an array of endpoints to the client configuration.
+
+```ts
+import { createClient } from '@graphql-hive/core'
+
+const client = createClient({
+  experimental__persistedDocuments: {
+    cdn: {
+      endpoint: [
+        'https://cdn.graphql-hive.com/artifacts/v1/9fb37bc4-e520-4019-843a-0c8698c25688',
+        'https://cdn-mirror.graphql-hive.com/artifacts/v1/9fb37bc4-e520-4019-843a-0c8698c25688'
+      ],
+      accessToken: ''
+    }
+  }
+})
+```
+
+In addition to that, the underlying logic for looking up documents now uses a circuit breaker. If a
+single endpoint is unreachable, further lookups on that endpoint are skipped.
+
+The behaviour of the circuit breaker can be customized via the `circuitBreaker` configuration.
+
+```ts
+import { createClient } from '@graphql-hive/core'
+
+const client = createClient({
+  experimental__persistedDocuments: {
+    cdn: {
+      endpoint: [
+        'https://cdn.graphql-hive.com/artifacts/v1/9fb37bc4-e520-4019-843a-0c8698c25688',
+        'https://cdn-mirror.graphql-hive.com/artifacts/v1/9fb37bc4-e520-4019-843a-0c8698c25688'
+      ],
+      accessToken: ''
+    },
+    circuitBreaker: {
+      // open circuit if 50 percent of request result in an error
+      errorThresholdPercentage: 50,
+      // start monitoring the circuit after 10 requests
+      volumeThreshold: 10,
+      // time before the backend is tried again after the circuit is open
+      resetTimeout: 30_000
+    }
+  }
+})
+```

.changeset/loose-dots-learn.md

@@ -0,0 +1,7 @@
+---
+'@graphql-hive/cli': minor
+'hive': minor
+---
+
+Upgrade graphql-inspector/core to v7 and update the models to be able to handle the new change
+objects. GraphQL Inspector now supports directive changes and improves the accuracy of the severity level for several change types. This will improve schema checks to make them more accurate and more complete. See graphql-inspector's changelog for details.

.changeset/nine-worlds-slide.md

@@ -0,0 +1,43 @@
+---
+'@graphql-hive/apollo': minor
+---
+
+**Supergraph Manager Improvements**
+
+Persisted documents now support specifying a mirror endpoint that will be used in case the main CDN
+is unreachable. Provide an array of endpoints to the supergraph manager configuration.
+
+```ts
+import { createSupergraphManager } from '@graphql-hive/apollo'
+
+const supergraphManager = createSupergraphManager({
+  endpoint: [
+    'https://cdn.graphql-hive.com/artifacts/v1/9fb37bc4-e520-4019-843a-0c8698c25688/supergraph',
+    'https://cdn-mirror.graphql-hive.com/artifacts/v1/9fb37bc4-e520-4019-843a-0c8698c25688/supergraph'
+  ],
+  key: ''
+})
+```
+
+In addition to that, the underlying logic for looking up documents now uses a circuit breaker. If a
+single endpoint is unreachable, further lookups on that endpoint are skipped.
+
+```ts
+import { createSupergraphManager } from '@graphql-hive/apollo'
+
+const supergraphManager = createSupergraphManager({
+  endpoint: [
+    'https://cdn.graphql-hive.com/artifacts/v1/9fb37bc4-e520-4019-843a-0c8698c25688/supergraph',
+    'https://cdn-mirror.graphql-hive.com/artifacts/v1/9fb37bc4-e520-4019-843a-0c8698c25688/supergraph'
+  ],
+  key: '',
+  circuitBreaker: {
+    // open circuit if 50 percent of request result in an error
+    errorThresholdPercentage: 50,
+    // start monitoring the circuit after 10 requests
+    volumeThreshold: 10,
+    // time before the backend is tried again after the circuit is open
+    resetTimeout: 30_000
+  }
+})
+```

.changeset/upset-lemons-reply.md

@@ -0,0 +1,25 @@
+---
+'@graphql-hive/core': minor
+---
+
+**New CDN Artifact Fetcher**
+
+We have a new interface for fetching CDN artifacts (such as supergraph and services) with a cache
+from the CDN. This fetcher supports providing a mirror endpoint and comes with a circuit breaker
+under the hood.
+
+```ts
+const supergraphFetcher = createCDNArtifactFetcher({
+  endpoint: [
+    'https://cdn.graphql-hive.com/artifacts/v1/9fb37bc4-e520-4019-843a-0c8698c25688',
+    'https://cdn-mirror.graphql-hive.com/artifacts/v1/9fb37bc4-e520-4019-843a-0c8698c25688'
+  ],
+  accessKey: ''
+})
+
+supergraphFetcher.fetch()
+```
+
+---
+
+`createSupergraphSDLFetcher` is now deprecated. Please upgrade to use `createCDNArtifactFetcher`.