v0.19.1

🐛 Fixes

• Fix diagnostic highlighting in rover {sub}graph lint for schemas with Unicode - @goto-bus-stop, #1750

  Previously, Rover would incorrectly highlight GraphQL syntax in a schema that contained Unicode characters due to the byte offsets reported by Apollo GraphOS. Now, Rover correctly maps byte offsets to character widths and highlights the correct portion of the GraphQL syntax.

🛠 Maintenance

• Updates to Rust 1.72.1 - @EverlastingBugstopper, #1751

---

This release was automatically created by CircleCI.

If you would like to verify that the binary you have downloaded was built from the source code in this repository, you can compute a checksum of the zipped tarball and compare it to the checksums that are included as release artifacts.

Binaries built for MacOS are signed, notarized, and automatically verified with Gatekeeper.

v0.19.0

🚀 Features

• Publish persisted queries generated by the Relay compiler - @EverlastingBugstopper, #1727

  The rover persisted-queries publish command now accepts the --manifest-format relay argument which allows publishing persisted queries generated by the Relay compiler to Apollo GraphOS. See the documentation for more information on this feature.

• Make checks more resilient by retrying failures - @swcollard, #1740

  Rover will now retry requests for the status of a check workflow. If the retries don't succeed after five minutes, the requests fail, and any intermittent errors are logged.

🐛 Fixes

• No output styling when writing to a file or redirecting output via a pipe - @EverlastingBugstopper, #1747

🛠 Maintenance

• Don't issue HEAD request to determine latest versions when the exact version is known - @EverlastingBugstopper, #1743 and #1744

  This change should make it easier to integrate Rover with custom binary mirrors as they do not need to be configured to return an X-Version header when responding to installation requests.

• Move introspector-gadget crate code back into Rover - @EverlastingBugstopper, #1736

📚 Documentation

• Include the list of available templates in Rover's documentation - @smyrick, #1733

---

This release was automatically created by CircleCI.

If you would like to verify that the binary you have downloaded was built from the source code in this repository, you can compute a checksum of the zipped tarball and compare it to the checksums that are included as release artifacts.

Binaries built for MacOS are signed, notarized, and automatically verified with Gatekeeper.

v0.18.1

🚀 Features

• Adds support for APOLLO_ROVER_DOWNLOAD_HOST when downloading router and federation plugins - @LongLiveCHIEF, #1713

  The default host for downloading the router and federation plugins is rover.apollo.dev - this can now be overridden via the APOLLO_ROVER_DOWNLOAD_HOST environment variable to enable downloads from binary mirrors.

• Relaxes requirements for --allow-invalid-routing-url flag for rover subgraph publish - @EverlastingBugstopper, #1712

  rover subgraph publish now accepts the --allow-invalid-routing-url flag without requiring a --routing-url to be passed as well.

🐛 Fixes

• Improve error message for empty file - @krachwal, #1724 fixes #1723

  When reading an empty file from disk, Rover now prints the path to that empty file rather than the (always empty) contents of that file.

🛠 Maintenance

• Install Volta via chocolatey in CI instead of the flaky MSI installer - @EverlastingBugstopper, #1718

  CI jobs have been flaky on Windows due to Volta's MSI installer, the switch to installing via chocolatey should improve this.

• Updates dependencies - @EverlastingBugstopper, #1709 and #1710

  apollo-parser: 0.5 -> 0.6
termimad: 0.23 -> 0.24
tokio: 1.29 -> 1.31
eslint: 8.46.0 -> 8.47.0
node: 18.17.0 -> 18.17.1

📚 Documentation

• Updates recommended suggested value for disabling telemetry - @LongLiveCHIEF, #1715 fixes #1714

  Rover now recommends setting APOLLO_TELEMETRY_DISABLED=true instead of APOLLO_TELEMETRY_DISABLED=1 to match the behavior of the Router. APOLLO_TELEMETRY_DISABLED=1 will continue to work as expected.

• Document the API token roles that work with rover pq publish - @glasser, #1720

---

This release was automatically created by CircleCI.

If you would like to verify that the binary you have downloaded was built from the source code in this repository, you can compute a checksum of the zipped tarball and compare it to the checksums that are included as release artifacts.

Binaries built for MacOS are signed, notarized, and automatically verified with Gatekeeper.

v0.18.0

Important: 1 potentially breaking change below, indicated by ❗ BREAKING ❗

❗ BREAKING ❗

• Prevent publishing unparsable routing URLs by default - @EverlastingBugstopper, #1706 fixes #1689

  rover subgraph publish now validates the --routing-url argument with a full URL parse to prevent the router from failing to start up due to an invalid subgraph URL. This means that passing an invalid routing URL or publishing a subgraph schema update that contains an invalid routing URL in the GraphOS registry will return an error. This error can be ignored by passing the --allow-invalid-routing-url option.

🐛 Fixes

• Return error E043 during check failures instead of the inaccurate E042 - @david-castaneda, #1705

  Error E043 is now returned when any step in a check fails.

• Small updates to the linter step produced by checks - @david-castaneda, #1701

  • Renames the incorrect start_byte_offset field to the correct start_line field in the JSON output
  • Updates the check step title to Linter instead of Lint

📚 Documentation

• Fixes GitLab CI documentation - @frederik, #1704

  Removes Alpine package installation instructions in favor of Ubuntu package installation instructions.

• Documents the persisted-queries command suite - @Meschreiber, #1698

---

This release was automatically created by CircleCI.

If you would like to verify that the binary you have downloaded was built from the source code in this repository, you can compute a checksum of the zipped tarball and compare it to the checksums that are included as release artifacts.

Binaries built for MacOS are signed, notarized, and automatically verified with Gatekeeper.

v0.17.3

🚀 Features

• Support binary mirrors via the npm installer - @LongLiveCHIEF, #1675

  When installing Rover via npm, you can override the base URL where Rover binaries are downloaded from in one of two ways:

  • by setting the APOLLO_ROVER_DOWNLOAD_HOST environment variable
  • by adding the following to your global or local .npmrc:

  apollo_rover_download_host=https://your.mirror.com/repository

  This enables installing Rover when https://rover.apollo.dev is unavailable, for example, in a private network.

🐛 Fixes

• Improve error handling for persisted-queries publish - @dbanty, #1697

📚 Documentation

• Clarify that routing_url is optional when using a graph ref with rover dev - @smyrick, #1683

---

This release was automatically created by CircleCI.

If you would like to verify that the binary you have downloaded was built from the source code in this repository, you can compute a checksum of the zipped tarball and compare it to the checksums that are included as release artifacts.

Binaries built for MacOS are signed, notarized, and automatically verified with Gatekeeper.

v0.17.2

🛠 Maintenance

• Remove preview phase message from rover persisted-queries publish - @glasser, #1686

  rover persisted-queries publish no longer unconditionally prints a message stating that this preview-phase feature must be enabled on your GraphOS account. (If the feature has not yet been enabled on your account, the command will still fail with an error explaining the situation.)

---

This release was automatically created by CircleCI.

If you would like to verify that the binary you have downloaded was built from the source code in this repository, you can compute a checksum of the zipped tarball and compare it to the checksums that are included as release artifacts.

Binaries built for MacOS are signed, notarized, and automatically verified with Gatekeeper.

v0.17.1

Important: 1 potentially breaking change below, indicated by ❗ BREAKING ❗

❗ BREAKING ❗

• Changes the default Router port of rover dev to 4000 - @dbanty, #1671 fixes #1550

  Previously, the default port of rover dev (when not overridden by --supergraph-port or --router-config) was 3000, this has been changed to 4000 to match the router's default.

🚀 Features

• Enable graphref and sdl schemas in rover dev --supergraph-config - @dbanty, #1673 closes #1663

  rover dev can now accept every variant of the supergraph YAML file that supergraph compose can—specifically allowing GraphOS and hard-coded SDLs as subgraph schema sources. These two new sources will not be polled for updates (as introspection and files are), but will contribute to the initial composition.

• Pass configured credentials to the Router when using rover dev - @dbanty, #1674

  Until now, in order to unlock Enterprise features when using rover dev, you had to pass both APOLLO_KEY and APOLLO_GRAPH_REF as environment variables to Rover. Now, if APOLLO_GRAPH_REF is set, Rover can pass along credentials that have been configured with rover config auth. This also respects the --profile argument. The configured key still needs to be a graph API key. Note that the APOLLO_KEY environment variable still works and will take precedence over any configured credentials.

• Allow omitting routing_url in rover dev --supergraph-config - @dbanty, #1666 closes #1634

  When using rover dev with a supergraph YAML file, the routing_url field can be omitted if using a subgraph_url (introspection) or graphref (GraphOS schema registry) schema source. If omitted, the introspection URL or the routing URL from the registry will be used instead (respectively).

• Display persisted query list names during publish and improve error messages - @EverlastingBugstopper, #1672

  Publishing operations to a persisted query list with rover pq publish now shows the list name rather than the UUID when publishing. Additionally, publishing to a non-existent list now returns a better error message with a suggestion.

🐛 Fixes

• IPv6 addresses are now allowed in the --supergraph-address option for rover dev - @dbanty, #1671

  For example, rover dev --supergraph-address "::1" will now cause the router to listen on [::1]:4000.

• IPv6 listen addresses are now allowed in Router config when using rover dev - @dbanty, #1671

  The Router's IPv6 format previously caused errors when passing config to rover dev via --router-config.

---

This release was automatically created by CircleCI.

If you would like to verify that the binary you have downloaded was built from the source code in this repository, you can compute a checksum of the zipped tarball and compare it to the checksums that are included as release artifacts.

Binaries built for MacOS are signed, notarized, and automatically verified with Gatekeeper.

v0.17.0

Yanked Release

As of 2023-07-14T20:44:45 this release has been unpublished from npm and the current latest release has been pinned to v0.16.2 due to the wrong commit being tagged for this release.

v0.17.1 will be tagged and released ASAP, but is currently blocked by an ongoing incident with npm.

---

This release was automatically created by CircleCI.

If you would like to verify that the binary you have downloaded was built from the source code in this repository, you can compute a checksum of the zipped tarball and compare it to the checksums that are included as release artifacts.

Binaries built for MacOS are signed, notarized, and automatically verified with Gatekeeper.

v0.16.2

🐛 Fixes

• Fixes rover supergraph compose regression introduced in v0.16.1 - @EverlastingBugstopper, #1655 fixes #1654

  Bumps apollo-federation-types to v0.9.2 which makes the code message returned with a build hint optional. This allows rover supergraph compose to handle the existence and absence of a hint's code instead of crashing when a code is not provided by a build plugin.

---

This release was automatically created by CircleCI.

If you would like to verify that the binary you have downloaded was built from the source code in this repository, you can compute a checksum of the zipped tarball and compare it to the checksums that are included as release artifacts.

Binaries built for MacOS are signed, notarized, and automatically verified with Gatekeeper.

v0.16.1

note: this release breaks rover supergraph compose completely.

please upgrade to v0.16.2.

🐛 Fixes

• Fixes breaking change in parsing of federation_version value in supergraph.yaml - @dbanty, #1652 fixes #1647

  In the v0.16.0 release, Rover added support for environment variable expansion in the entire supergraph.yaml file. Unfortunately, this change broke parsing of federation_version in the case that an integer and not a string was passed. This breaking change has been fixed and regression tests have been added to the codebase to ensure this doesn't break again in the future.

---

This release was automatically created by CircleCI.

If you would like to verify that the binary you have downloaded was built from the source code in this repository, you can compute a checksum of the zipped tarball and compare it to the checksums that are included as release artifacts.

Binaries built for MacOS are signed, notarized, and automatically verified with Gatekeeper.