vscode-apollo 2.3.2 → 2.3.4

package/.circleci/config.yml

@@ -6,7 +6,7 @@ orbs:
 executors:
   node:
     docker:
-      - image: cimg/node:22.8.0
+      - image: cimg/node:22.9.0
     working_directory: ~/vscode-graphql
 
 commands:

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # CHANGELOG
 
+## 2.3.4
+
+### Patch Changes
+
+- [#224](https://github.com/apollographql/vscode-graphql/pull/224) [`b7d300f7`](https://github.com/apollographql/vscode-graphql/commit/b7d300f7d44138ef656bf5e5359dc284d41b78e2) Thanks [@phryneas](https://github.com/phryneas)! - Fix a situation where config files using `require` would not be imported as CommonJS.
+
+## 2.3.3
+
+### Patch Changes
+
+- [#191](https://github.com/apollographql/vscode-graphql/pull/191) [`2e56f42d`](https://github.com/apollographql/vscode-graphql/commit/2e56f42d172a7ec8afd003f056aeabac9eab1789) Thanks [@svc-secops](https://github.com/svc-secops)! - Chores: update various dependencies (#181, #191, #217, #218)
+
 ## 2.3.2
 
 ### Patch Changes

package/README.md

@@ -9,7 +9,7 @@
 
 </div>
 
-GraphQL has the potential to create incredible developer experiences, thanks to its strongly typed schema and query language. The Apollo platform brings these possibilities to life by enhancing your editor with rich metadata from your graph API.
+Thanks to its strongly typed schema and query language, GraphQL has the potential to create incredible developer experiences. The Apollo platform brings these possibilities to life by enhancing your editor with rich metadata from your graph API.
 
 ![demo](https://raw.githubusercontent.com/apollographql/vscode-graphql/main/images/marketplace/jump-to-def.gif)
 
@@ -17,8 +17,9 @@ The Apollo GraphQL extension for VS Code brings an all-in-one tooling experience
 
 - Add [syntax highlighting](#syntax-highlighting) for GraphQL files and gql templates inside JavaScript files
 - Get instant feedback and [intelligent autocomplete](#intelligent-autocomplete) for fields, arguments, types, and variables as you write queries
-- Manage client side schema alongside remote schema
+- Manage client-side schema alongside remote schema
 - See [performance information](#performance-insights) inline with your query definitions
+- Extra features to help you with [supergraph editing](#supergraph-editing)
 - Validate field and argument usage in operations
 - [Navigate projects more easily](#navigating-projects) with jump-to and peek-at definitions
 - Manage [client-only](#client-only-schemas) schemas
@@ -26,24 +27,22 @@ The Apollo GraphQL extension for VS Code brings an all-in-one tooling experience
 
 <h2 id="getting-started">Getting started</h2>
 
-For the VS Code plugin to know how to find the schema, it needs to be linked to either a published schema or a local one.
-
-First, create an `apollo.config.json` file at the root of the project.
+The VS Code plugin must be linked to a published or local schema. To do so, create an `apollo.config.json` file at the root of the project.
 Alternatively, you can create a `yaml`, `cjs`, `mjs`, or `ts` file with the same configuration.
 
 For the contents of this configuration file, select one of these options:
 
-<h3>Configure extension for schemas published to Apollo GraphOS</h3>
+<h3>Configure extension for client development with schemas published to Apollo GraphOS</h3>
 <details>
 <summary>
 <i>Expand for instructions.</i>
 </summary>
 
-To get all the benefits of the VS Code experience, it's best to link the schema that is being developed against before installing the extension. The best way to do that is by [publishing a schema](https://www.apollographql.com/docs/graphos/delivery/publishing-schemas/) to the Apollo schema registry.
+To get all the benefits of the VS Code experience, it's best to link the schema being developed before installing the extension. The best way to do that is by [publishing a schema](https://www.apollographql.com/docs/graphos/delivery/publishing-schemas/) to the [GraphOS schema registry](https://www.apollographql.com/docs/graphos#core-features).
 
 After that's done, edit the `apollo.config.json` file to look like this:
 
-```json
+```jsonc
 {
   "client": {
     "service": "graphos-graph-name"
@@ -55,31 +54,68 @@ The `service` name is the name of the graph you've created in [GraphOS Studio](h
 
 See [additional configuration options](#additional-apollo-config-options).
 
-To authenticate with GraphOS Studio to pull down your schema, create a `.env` file in the same directory as the `apollo.config.json` file. This should be an untracked file (that is, don't commit it to Git).
+To authenticate with GraphOS Studio to pull down your schema, create an `.env` file in the same directory as the `apollo.config.json` file. The `.env` file should be untracked—that is, don't commit it to Git.
 
-Then go to your [User Settings page](https://studio.apollographql.com/user-settings/api-keys?referrer=docs-content) in GraphOS Studio to create a new Personal API key.
+Then, go to your [User Settings page](https://studio.apollographql.com/user-settings/api-keys?referrer=docs-content) in GraphOS Studio to create a new personal API key.
 
-> It is best practice to create a new API key for each member of the team and name the key so its easy to find and revoke if needed. This will be easier to manage in the future.
+> It's best practice to create a new API key for each team member. API keys should also be named so they're easy to find and revoke if needed.
 
-After the key is found, add the following line to the `.env` file:
+After you've created your API key, add the following line to the `.env` file:
 
 ```bash showLineNumbers=false
 APOLLO_KEY=<enter copied key here>
 ```
 
-After this is done, VS Code can be reloaded and the Apollo integration will connect to GraphOS Studio to provide autocomplete, validation, and more.
+Afterward, reload VS Code. The Apollo integration will connect to GraphOS Studio to provide autocomplete, validation, and more.
 
 </details>
 
-<h3 id="local-schemas">Configure extension to use introspection from a locally running service</h3>
+<h3>Configure extension for supergraph schema development</h3>
 <details>
 <summary>
 <i>Expand for instructions.</i>
 </summary>
 
-Sometimes it may make sense to link the editor to a locally running version of a schema to try out new designs that are in active development. To do this, the `apollo.config.json` file can be linked to a local service definition:
+The extension can integrate with the [Rover CLI](https://www.apollographql.com/docs/rover/) to help you design supergraph schemas with additional support for Apollo Federation.
+
+Ensure you've [installed](https://www.apollographql.com/docs/rover/getting-started) and [configured](https://www.apollographql.com/docs/rover/configuring) the [latest Rover release](https://github.com/apollographql/rover/releases).
+
+Next edit your `apollo.config.json` to look like this:
+
+```jsonc
+{
+  "rover": {
+    // optional, if your rover binary is in PATH it will automatically be detected
+    "bin": "/path/to/rover",
+    // optional, defaults to `supergraph.yaml` in the folder of the configuration file
+    "supergraphConfig": "/path/to/supergraph.yaml",
+    // optional, defaults to the Rover default profile
+    "profile": ""
+  }
+}
+```
+
+Since all these options are optional, you can specify only the `rover` key to indicate you're using Rover for schema development rather than client development:
 
-```json
+```jsonc
+{
+  "rover": {}
+}
+```
+
+Afterward, reload VS Code. The Apollo extension will start using Rover to help you build your supergraph.
+
+</details>
+
+<h3 id="local-schemas">Configure extension for client development with introspection from a locally running service</h3>
+<details>
+<summary>
+<i>Expand for instructions.</i>
+</summary>
+
+To experiment with designs under active development, you can link the editor to a locally running version of a schema. Link the `apollo.config.json` file to a local service definition like so:
+
+```jsonc
 {
   "client": {
     "service": {
@@ -90,11 +126,11 @@ Sometimes it may make sense to link the editor to a locally running version of a
 }
 ```
 
-Linking to the local schema won't provide all features, such as switching graph variants and performance metrics.
+Linking to local schemas won't provide all extension features, such as switching graph variants and performance metrics.
 
 </details>
 
-<h3 id="local-schema-files">Configure extension for local schema files</h3>
+<h3 id="local-schema-files">Configure extension for client development with local schema files</h3>
 <details>
 <summary>
 <i>Expand for instructions.</i>
@@ -104,7 +140,7 @@ You might not always have a running server to link to, so the extension also sup
 This is useful for working on a schema in isolation or for testing out new features.
 To link to a local schema file, add the following to the `apollo.config.json` file:
 
-```json
+```jsonc
 {
   "client": {
     "service": {
@@ -117,13 +153,17 @@ To link to a local schema file, add the following to the `apollo.config.json` fi
 
 </details>
 
-<h3 id="client-only-schemas">Adding Client-only schemas</h3>
+<h3 id="client-only-schemas">Bonus: Adding client-only schemas</h3>
+<details>
+<summary>
+<i>Expand for instructions.</i>
+</summary>
 
-One of the best features of the VS Code extension is the automatic merging of remote schemas and local ones when using integrated state management with Apollo Client. This happens automatically whenever schema definitions are found within a client project. By default, the VS Code extension will look for all JavaScript, TypeScript and GraphQL files under `./src` to find both the operations and schema definitions for building a complete schema for the application.
+One of the best features of the VS Code extension is the automatic merging of remote and local schemas when using integrated state management with Apollo Client. This happens automatically whenever schema definitions are found within a client project. By default, the VS Code extension will look for all JavaScript, TypeScript, and GraphQL files under `./src` to find both the operations and schema definitions for building a complete schema for the application.
 
-Client side schema definitions can be spread throughout the client app project and will be merged together to create one single schema. The default behavior can be controlled by adding specifications to the `apollo.config.json`:
+Client-side schema definitions can be spread throughout the client app project and will be merged to create one single schema. You can set the default behavior by adding specifications to the `apollo.config.json`:
 
-```json
+```jsonc
 {
   "client": {
     // "service": <your service configuration>,
@@ -135,17 +175,19 @@ Client side schema definitions can be spread throughout the client app project a
 }
 ```
 
+</details>
+
 <h3 id="get-the-extension">Get the extension</h3>
 
 Once you have a config set up and a schema published, [install the Apollo GraphQL extension](https://marketplace.visualstudio.com/items?itemName=apollographql.vscode-apollo), then try opening a file containing a GraphQL operation.
 
-When a file open, clicking the status bar icon will open the output window and print stats about the project associated with that file. This is helpful when confirming the project is setup properly.
+After opening a file, click the status bar icon to open the output window and see stats about the project associated with that file. This is helpful for confirming that the project is set up properly.
 
 <img src="https://raw.githubusercontent.com/apollographql/vscode-graphql/main/images/marketplace/stats.gif"  alt="Clicking the status bar icon to open the output pane">
 
 <h2 id="features">Features</h2>
 
-Apollo for VS Code brings many helpful features for working on a GraphQL project.
+Apollo for VS Code offers a range of useful features for working on GraphQL projects.
 
 <h3 id="intelligent-autocomplete">Intelligent autocomplete</h3>
 
@@ -155,24 +197,24 @@ Once configured, VS Code has full knowledge of the schema clients are running op
 
 <h3 id="errors-and-warnings">Inline errors and warnings</h3>
 
-VS Code can use local or published schemas to validate operations before running them. **Syntax errors**, **invalid fields or arguments**, and even **deprecated fields** instantly appear as errors or warnings right in your editor, ensuring all developers are working with the most up-to-date production schemas.
+VS Code can use local or published schemas to validate operations before running them. **Syntax errors**, **invalid fields or arguments**, and even **deprecated fields** instantly appear as errors or warnings in your editor, ensuring your entire team is working with the most up-to-date production schemas.
 
 <img src="https://raw.githubusercontent.com/apollographql/vscode-graphql/main/images/marketplace/warnings-and-errors.gif"  alt="tooltip showing a field deprecation warning and error">
 
 <h3 id="field-type-info">Inline field type information</h3>
 
-Because of GraphQL's strongly-typed schema, VS Code not only know about which fields and arguments are valid, but also what types are expected. Hover over any type in a valid GraphQL operation to see what type that field returns and whether or not it can be null.
+Because of GraphQL's strongly typed schema, VS Code knows not only which fields and arguments are valid, but also what types are expected. Hover over any type in a valid GraphQL operation to see what type that field returns and whether or not it can be null.
 
 <img src="https://raw.githubusercontent.com/apollographql/vscode-graphql/main/images/marketplace/type-info.png" style="max-width:800px;" alt="a tooltip showing a Boolean type for a field">
 
 <h3 id="performance-insights">Performance insights</h3>
 
-GraphQL's flexibility can make it difficult to predict the cost of an operation. Without insight into how expensive an operation is, developers can accidentally write queries that place strain on their graph API's underlying backends. Thanks to the Apollo platform's integration with VS Code and our trace warehouse, teams can avoid these performance issues altogether by instantly seeing the cost of a query right in their editor.
+GraphQL's flexibility can make it difficult to predict the cost of an operation. Without insight into how expensive an operation is, developers can accidentally write queries that place strain on their graph API's underlying backends. Thanks to the Apollo platform's integration with VS Code and our trace warehouse, teams can avoid these performance issues by instantly seeing the cost of a query in their editor.
 
-The VS Code extension will show inline performance diagnostics when connected to a service with reported metrics in GraphOS Studio. As operations are typed, any fields that take longer than 1 ms to respond will be annotated to the right of the field inline! This gives team members a picture of how long the operation will take as more and more fields are added to operations or fragments.
+The VS Code extension will show inline performance diagnostics when connected to a service with reported metrics in GraphOS Studio. As operations are typed, any fields that take longer than 1 ms to respond will be annotated to the right of the field inline. This shows team members how long the operation will take as more and more fields are added to operations or fragments.
 
 <img
-  src="https://raw.githubusercontent.com/apollographql/vscode-graphql/80a6ca4ae59173b8cef25020345e4ebe202eec41/images/marketplace/perf-annotation.png"
+  src="https://raw.githubusercontent.com/apollographql/vscode-graphql/main/images/marketplace/perf-annotation.png"
   width="80%"
   style="margin: 5%"
   alt="Performance annotation next to a field"
@@ -180,11 +222,20 @@ The VS Code extension will show inline performance diagnostics when connected to
 
 <h3 id="syntax-highlighting">Syntax highlighting</h3>
 
-Apollo's editor extension provides syntax highlighting for all things GraphQL, including schema definitions in `.graphql` files, complex queries in TypeScript, and even client-only schema extensions. Syntax highlighting for GraphQL works out-of-the-box for `.graphql`, `.gql`, `.js` and `.ts` file types.
+Apollo's editor extension provides syntax highlighting for all things GraphQL, including schema definitions in `.graphql` files, complex queries in TypeScript, and even client-only schema extensions. Syntax highlighting for GraphQL works out-of-the-box in GraphQL, JavaScript, TypeScript, Python, Lua, Ruby, Dart, Elixir, and ReasonML files.
+
+<h3 id="supergraph-editing">supergraph editing</h3>
+
+The extension provides features for supergraph editing, such as support for Federation directives, subgraph-spanning go-to-definition, and reporting composition errors directly to the **Problems** panel.
+
+<img
+  src="https://raw.githubusercontent.com/apollographql/vscode-graphql/main/images/marketplace/federation-directive-hover.png"
+  alt="Hover on Federation directive"
+/>
 
 <h3 id="navigating-projects">Navigating projects</h3>
 
-Navigating large codebases can be difficult, but the Apollo GraphQL extension makes this easier. Right-clicking on any field in operations or schemas gives you the ability to jump to (or peek at) definitions, as well as find any other references to that field in your project.
+Navigating large codebases can be difficult, but the Apollo GraphQL extension makes this easier. Right-clicking on any field in operations or schemas allows you to jump to (or peek at) definitions and find any other references to that field in your project.
 
 <img src="https://raw.githubusercontent.com/apollographql/vscode-graphql/main/images/marketplace/jump-to-def.gif"  alt="Using jump to definition on a fragment">
 
@@ -194,11 +245,11 @@ Apollo supports publishing multiple versions ([variants](https://www.apollograph
 
 <h2 id="troubleshooting">Troubleshooting</h2>
 
-The most common errors are configuration errors, like a missing `.env` file or incorrect service information in the `apollo.config.js` file. Please see [the Apollo config docs](https://www.apollographql.com/docs/devtools/apollo-config/) for more configuration guidance.
+The most common errors are configuration errors, like a missing `.env` file or incorrect service information in the `apollo.config.json` file. Please see [the Apollo config docs](https://www.apollographql.com/docs/devtools/apollo-config/) for more configuration guidance.
 
-Other errors may be caused from an old version of a published schema. To reload a schema, open the Command Palette (`cmd + shift + p` on mac), search "Apollo" and choose the "Apollo: Reload Schema" option.
+An old version of a published schema may cause other errors. To reload a schema, open the **Command Palette** (`cmd + shift + p` on Mac), search for "Apollo." Choose the **Apollo: Reload Schema** option.
 
-Sometimes errors will show up as a notification at the bottom of your editor. Other, less critical, messages may be shown in the output pane of the editor. To open the output pane and get diagnostic information about the extension and the current service loaded (if working with a client project), just click the "Apollo GraphQL" icon in the status bar at the bottom.
+Sometimes, errors will appear as a notification at the bottom of your editor. Other, less critical, messages may be shown in the output pane of the editor. To open the output pane and get diagnostic information about the extension and the current service loaded (if working with a client project), click the Apollo GraphQL icon in the status bar at the bottom.
 
 <img src="https://raw.githubusercontent.com/apollographql/vscode-graphql/main/images/marketplace/stats.gif"  alt="Clicking the status bar icon to open the output pane">
 
@@ -214,7 +265,7 @@ _Optional_ - custom tagged template literal.
 
 When using GraphQL with JavaScript or TypeScript projects, it is common to use the `gql` tagged template literal to write out operations. Apollo tools look through your files for the `gql` tag to extract your queries, so if you use a different template literal, you can configure it like so:
 
-```json
+```jsonc
 {
   "client": {
     "tagName": "graphql",

package/package.json

@@ -2,7 +2,7 @@
   "name": "vscode-apollo",
   "displayName": "Apollo GraphQL",
   "description": "Rich editor support for GraphQL client and server development that seamlessly integrates with the Apollo platform",
-  "version": "2.3.2",
+  "version": "2.3.4",
   "referenceID": "87197759-7617-40d0-b32e-46d378e907c7",
   "author": "Apollo GraphQL <opensource@apollographql.com>",
   "license": "MIT",
@@ -37,9 +37,9 @@
     "vscode": "^1.90.0"
   },
   "dependencies": {
-    "@apollo/client": "3.11.4",
-    "@apollo/subgraph": "2.8.4",
-    "@graphql-tools/schema": "10.0.5",
+    "@apollo/client": "3.11.8",
+    "@apollo/subgraph": "2.9.1",
+    "@graphql-tools/schema": "10.0.6",
     "@wry/equality": "0.5.7",
     "cosmiconfig": "9.0.0",
     "dotenv": "16.4.5",
@@ -55,6 +55,7 @@
     "lz-string": "1.5.0",
     "minimatch": "10.0.1",
     "moment": "2.30.1",
+    "semver": "7.6.3",
     "undici": "6.19.8",
     "vscode-languageclient": "9.0.1",
     "vscode-languageserver": "9.0.1",
@@ -62,7 +63,7 @@
     "vscode-uri": "3.0.8",
     "which": "4.0.0",
     "zod": "3.23.8",
-    "zod-validation-error": "3.3.1"
+    "zod-validation-error": "3.4.0"
   },
   "devDependencies": {
     "@apollo/rover": "0.27.0-alpha.0",
@@ -70,7 +71,7 @@
     "@changesets/cli": "2.26.2",
     "@graphql-codegen/cli": "^5.0.2",
     "@graphql-codegen/typescript-operations": "^4.2.3",
-    "@types/jest": "29.5.12",
+    "@types/jest": "29.5.13",
     "@types/lodash.debounce": "4.0.9",
     "@types/lodash.merge": "4.6.9",
     "@types/lodash.throttle": "^4.1.9",
@@ -89,7 +90,7 @@
     "import-fresh": "^3.3.0",
     "jest": "29.7.0",
     "jest-environment-node": "29.7.0",
-    "memfs": "4.11.1",
+    "memfs": "4.11.2",
     "npm-run-all": "^4.1.5",
     "prettier": "3.0.3",
     "rimraf": "6.0.1",

package/schemas/apollo.config.schema.json

@@ -4,14 +4,31 @@
       "$ref": "#/definitions/baseConfig"
     },
     {
-      "type": "object",
-      "properties": {
-        "client": {
-          "$ref": "#/definitions/clientConfig"
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "client": {
+              "$ref": "#/definitions/clientConfig"
+            }
+          },
+          "required": [
+            "client"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "rover": {
+              "$ref": "#/definitions/roverConfig"
+            }
+          },
+          "required": [
+            "rover"
+          ],
+          "additionalProperties": false
         }
-      },
-      "required": [
-        "client"
       ]
     }
   ],
@@ -146,6 +163,36 @@
       "additionalProperties": false,
       "description": "Configuration for a Client project."
     },
+    "roverConfig": {
+      "type": "object",
+      "properties": {
+        "bin": {
+          "type": "string",
+          "description": "The path to your Rover binary. If omitted, will look in PATH."
+        },
+        "profile": {
+          "type": "string",
+          "description": "The name of the profile to use."
+        },
+        "supergraphConfig": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "The path to your `supergraph.yaml` file. \nDefaults to a `supergraph.yaml` in the folder of your `apollo.config.json`, if there is one."
+        },
+        "extraArgs": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": [],
+          "description": "Extra arguments to pass to the Rover CLI."
+        }
+      },
+      "additionalProperties": false,
+      "description": "Configuration for a federated project."
+    },
     "engineConfig": {
       "type": "object",
       "properties": {
@@ -173,6 +220,9 @@
         "client": {
           "description": "Configuration for a Client project."
         },
+        "rover": {
+          "description": "Configuration for a federated project."
+        },
         "service": {
           "description": "This option is no longer supported, please remove it from your configuration file."
         }

package/src/__e2e__/runTests.js

@@ -18,7 +18,6 @@ async function main() {
     const TEST_PORT = 7096;
     process.env.APOLLO_ENGINE_ENDPOINT = "http://localhost:7096/apollo";
     process.env.MOCK_SERVER_PORT = String(TEST_PORT);
-    process.env.APOLLO_FEATURE_FLAGS = "rover";
     disposables.push(
       ...(await Promise.all([
         runMockServer(TEST_PORT, false, loadDefaultMocks),

package/src/build.js

@@ -68,7 +68,7 @@ const buildJsonSchemaPlugin = {
       const {
         configSchema,
         clientConfig,
-        // roverConfig,
+        roverConfig,
         engineConfig,
         baseConfig,
         // @ts-ignore
@@ -78,7 +78,7 @@ const buildJsonSchemaPlugin = {
         errorMessages: true,
         definitions: {
           clientConfig,
-          //roverConfig,
+          roverConfig,
           engineConfig,
           baseConfig,
         },

package/src/language-server/config/__tests__/loadConfig.ts

@@ -1,24 +1,8 @@
-let { loadConfig } = require("../");
-let { ClientConfig, RoverConfig } = require("../config");
+import { loadConfig } from "../";
+import { ClientConfig, RoverConfig } from "../config";
 import * as path from "path";
 import * as fs from "fs";
 
-async function withFeatureFlags(flags: string, fn: () => void) {
-  const FF = process.env.APOLLO_FEATURE_FLAGS;
-  try {
-    process.env.APOLLO_FEATURE_FLAGS = flags;
-    jest.resetModules();
-    ({ loadConfig } = require("../"));
-    ({ ClientConfig, RoverConfig } = require("../config"));
-    return await fn();
-  } finally {
-    process.env.APOLLO_FEATURE_FLAGS = FF;
-    jest.resetModules();
-    ({ loadConfig } = require("../"));
-    ({ ClientConfig, RoverConfig } = require("../config"));
-  }
-}
-
 const makeNestedDir = (dir: string) => {
   if (fs.existsSync(dir)) return;
 
@@ -109,25 +93,24 @@ Object {
 `);
     });
 
-    it("loads with rover defaults from different dir", () =>
-      withFeatureFlags("rover", async () => {
-        writeFilesToDir(dir, {
-          "apollo.config.js": `
+    it("loads with rover defaults from different dir", async () => {
+      writeFilesToDir(dir, {
+        "apollo.config.js": `
           module.exports = {
             rover: {
             }
           }
         `,
+      });
+      fs.mkdirSync(`${dir}/bin`);
+      fs.writeFileSync(`${dir}/bin/rover`, "", { mode: 0o755 });
+      let oldPath = process.env.PATH;
+      process.env.PATH = `${dir}/bin:${oldPath}`;
+      try {
+        const config = await loadConfig({
+          configPath: dirPath,
         });
-        fs.mkdirSync(`${dir}/bin`);
-        fs.writeFileSync(`${dir}/bin/rover`, "", { mode: 0o755 });
-        let oldPath = process.env.PATH;
-        process.env.PATH = `${dir}/bin:${oldPath}`;
-        try {
-          const config = await loadConfig({
-            configPath: dirPath,
-          });
-          expect(config?.rawConfig).toMatchInlineSnapshot(`
+        expect(config?.rawConfig).toMatchInlineSnapshot(`
 Object {
   "engine": Object {
     "endpoint": "https://graphql.api.apollographql.com/api/graphql",
@@ -138,10 +121,10 @@ Object {
   },
 }
 `);
-        } finally {
-          process.env.PATH = oldPath;
-        }
-      }));
+      } finally {
+        process.env.PATH = oldPath;
+      }
+    });
 
     it("[deprecated] loads config from package.json", async () => {
       writeFilesToDir(dir, {
@@ -280,7 +263,6 @@ client:
 
       await loadConfig({
         configPath: dirPath,
-        requireConfig: true, // this is what we're testing
       });
 
       expect(spy).toHaveBeenCalledWith(
@@ -299,7 +281,7 @@ client:
       }).catch((e: any) => e);
 
       expect(error.message).toMatch(
-        /Config needs to contain a 'client' field./i,
+        /Config needs to contain either 'client' or 'rover' fields/i,
       );
     });
   });
@@ -374,18 +356,17 @@ client:
       expect(config).toBeInstanceOf(ClientConfig);
     });
 
-    it("infers rover projects from config", () =>
-      withFeatureFlags("rover", async () => {
-        writeFilesToDir(dir, {
-          "apollo.config.js": `module.exports = { rover: { bin: "/usr/bin/env" } }`,
-        });
+    it("infers rover projects from config", async () => {
+      writeFilesToDir(dir, {
+        "apollo.config.js": `module.exports = { rover: { bin: "/usr/bin/env" } }`,
+      });
 
-        const config = await loadConfig({
-          configPath: dirPath,
-        });
+      const config = await loadConfig({
+        configPath: dirPath,
+      });
 
-        expect(config).toBeInstanceOf(RoverConfig);
-      }));
+      expect(config).toBeInstanceOf(RoverConfig);
+    });
   });
 
   describe("service name", () => {

package/src/language-server/config/config.ts

@@ -9,10 +9,9 @@ import which from "which";
 import { accessSync, constants as fsConstants, statSync } from "node:fs";
 import { AsyncLocalStorage } from "async_hooks";
 import { existsSync } from "fs";
-
-const ROVER_AVAILABLE = (process.env.APOLLO_FEATURE_FLAGS || "")
-  .split(",")
-  .includes("rover");
+import { spawn } from "node:child_process";
+import { text } from "node:stream/consumers";
+import semver from "semver";
 
 function ignoredFieldWarning(
   getMessage = (path: string) =>
@@ -143,49 +142,53 @@ export const clientConfig = z
   .describe("Configuration for a Client project.");
 export type ClientConfigFormat = z.infer<typeof clientConfig>;
 
-export const roverConfig = z.object({
-  bin: z
-    .preprocess(
-      (val) => val || which.sync("rover", { nothrow: true }) || undefined,
-      z.string({
-        message:
-          "Rover binary not found. Please either install it system-wide in PATH, or provide the `bin` option. Also ensure that the binary is executable.",
-      }),
-    )
-    .refine(
-      (bin) => {
-        try {
-          // is executable?
-          accessSync(bin, fsConstants.X_OK);
-          // is a file and not a directory?
-          return statSync(bin).isFile();
-        } catch {
-          return false;
-        }
-      },
-      {
-        message:
-          "Rover binary is not marked as an executable. If you are using OS X or Linux, ensure to set the executable bit.",
-      },
-    )
-    .describe("The path to your Rover binary. If omitted, will look in PATH."),
-  profile: z.string().optional().describe("The name of the profile to use."),
-  supergraphConfig: z
-    .preprocess((value) => {
-      if (value !== undefined) return value;
-      const configPath = contextStore.getStore()?.configPath!;
-      const supergraphConfig = join(configPath, "supergraph.yaml");
-      return existsSync(supergraphConfig) ? supergraphConfig : undefined;
-    }, z.string().nullable().optional())
-    .describe(
-      "The path to your `supergraph.yaml` file. \n" +
-        "Defaults to a `supergraph.yaml` in the folder of your `apollo.config.js`, if there is one.",
-    ),
-  extraArgs: z
-    .array(z.string())
-    .default([])
-    .describe("Extra arguments to pass to the Rover CLI."),
-});
+export const roverConfig = z
+  .object({
+    bin: z
+      .preprocess(
+        (val) => val || which.sync("rover", { nothrow: true }) || undefined,
+        z.string({
+          message:
+            "Rover binary not found. Please either install it system-wide in PATH, or provide the `bin` option. Also ensure that the binary is executable.",
+        }),
+      )
+      .refine(
+        (bin) => {
+          try {
+            // is executable?
+            accessSync(bin, fsConstants.X_OK);
+            // is a file and not a directory?
+            return statSync(bin).isFile();
+          } catch {
+            return false;
+          }
+        },
+        {
+          message:
+            "Rover binary is not marked as an executable. If you are using OS X or Linux, ensure to set the executable bit.",
+        },
+      )
+      .describe(
+        "The path to your Rover binary. If omitted, will look in PATH.",
+      ),
+    profile: z.string().optional().describe("The name of the profile to use."),
+    supergraphConfig: z
+      .preprocess((value) => {
+        if (value !== undefined) return value;
+        const configPath = contextStore.getStore()?.configPath || ".";
+        const supergraphConfig = join(configPath, "supergraph.yaml");
+        return existsSync(supergraphConfig) ? supergraphConfig : undefined;
+      }, z.string().nullable().optional())
+      .describe(
+        "The path to your `supergraph.yaml` file. \n" +
+          "Defaults to a `supergraph.yaml` in the folder of your `apollo.config.json`, if there is one.",
+      ),
+    extraArgs: z
+      .array(z.string())
+      .default([])
+      .describe("Extra arguments to pass to the Rover CLI."),
+  })
+  .describe("Configuration for a federated project.");
 type RoverConfigFormat = z.infer<typeof roverConfig>;
 
 export const engineConfig = z
@@ -212,12 +215,7 @@ export type EngineConfig = z.infer<typeof engineConfig>;
 export const baseConfig = z.object({
   engine: engineConfig.default({}),
   client: z.unknown().optional().describe(clientConfig.description!),
-  ...ifRoverAvailable(
-    {
-      rover: z.unknown().optional(),
-    },
-    {},
-  ),
+  rover: z.unknown().optional().describe(roverConfig.description!),
   service: ignoredFieldWarning(
     (path) =>
       `Service-type projects are no longer supported. Please remove the "${path}" field from your configuration file.`,
@@ -234,56 +232,36 @@ export type FullRoverConfigFormat = Extract<
   { rover: {} }
 >;
 
-/** Helper function for TypeScript - we just want the first type to make it into the types, not the "no feature flag" fallback */
-function ifRoverAvailable<T>(yes: T, no: any): T {
-  return ROVER_AVAILABLE ? yes : no;
-}
-
 export const configSchema = baseConfig
   .superRefine((val, ctx) => {
-    if (ROVER_AVAILABLE) {
-      if ("client" in val && "rover" in val) {
-        ctx.addIssue({
-          code: "custom",
-          message: "Config cannot contain both 'client' and 'rover' fields",
-          fatal: true,
-        });
-      }
-      if (!("client" in val) && !("rover" in val)) {
-        ctx.addIssue({
-          code: "custom",
-          message: "Config needs to contain either 'client' or 'rover' fields",
-          fatal: true,
-        });
-      }
-    } else {
-      if (!("client" in val)) {
-        ctx.addIssue({
-          code: "custom",
-          message: "Config needs to contain a 'client' field.",
-          fatal: true,
-        });
-      }
+    if ("client" in val && "rover" in val) {
+      ctx.addIssue({
+        code: "custom",
+        message: "Config cannot contain both 'client' and 'rover' fields",
+        fatal: true,
+      });
+    }
+    if (!("client" in val) && !("rover" in val)) {
+      ctx.addIssue({
+        code: "custom",
+        message: "Config needs to contain either 'client' or 'rover' fields",
+        fatal: true,
+      });
     }
   })
   .and(
-    ifRoverAvailable(
-      z.union([
-        z
-          .object({
-            client: clientConfig,
-          })
-          .transform((val): typeof val & { rover?: never } => val),
-        z
-          .object({
-            rover: roverConfig,
-          })
-          .transform((val): typeof val & { client?: never } => val),
-      ]),
-      z.object({
-        client: clientConfig,
-      }),
-    ),
+    z.union([
+      z
+        .object({
+          client: clientConfig,
+        })
+        .transform((val): typeof val & { rover?: never } => val),
+      z
+        .object({
+          rover: roverConfig,
+        })
+        .transform((val): typeof val & { client?: never } => val),
+    ]),
   );
 export type RawApolloConfigFormat = z.input<typeof configSchema>;
 export type ParsedApolloConfigFormat = z.output<typeof configSchema>;
@@ -371,6 +349,11 @@ export abstract class ApolloConfig {
     if (this._graphId) return this._graphId;
     return getGraphIdFromConfig(this.rawConfig);
   }
+
+  /**
+   * execute some additional asynchronous verification steps that cannot be part of the sync parsing part
+   */
+  async verify() {}
 }
 
 export class ClientConfig extends ApolloConfig {
@@ -395,4 +378,45 @@ export class RoverConfig extends ApolloConfig {
     super(rawConfig, configURI);
     this.rover = rawConfig.rover;
   }
+
+  /**
+   * execute some additional asynchronous verification steps that cannot be part of the sync parsing part
+   */
+  async verify() {
+    try {
+      const child = spawn(this.rover.bin, ["-V"], {
+        stdio: ["pipe", "pipe", "ignore"],
+      });
+      const output = await text(child.stdout);
+      const versionPrefix = "Rover ";
+      if (output.startsWith(versionPrefix)) {
+        const version = output.slice(versionPrefix.length).trim();
+        if (!semver.valid(version)) {
+          // not a valid version, we accept this and will try anyways
+          return;
+        }
+        if (semver.gte(version, "0.27.0-alpha.0")) {
+          // this is a supported version
+          return;
+        }
+        const error = new Error(
+          `Rover version ${version} is not supported by the extension. Please upgrade to at least 0.27.0.`,
+        );
+        // @ts-expect-error would require a target of ES2022 in tsconfig
+        error.cause = "ROVER_TOO_OLD";
+        throw error;
+      }
+      // we can't find out the version, but we'll try anyways
+    } catch (error) {
+      if (
+        error &&
+        error instanceof Error &&
+        // @ts-expect-error would require a target of ES2022 in tsconfig
+        error.cause === "ROVER_TOO_OLD"
+      ) {
+        throw error;
+      }
+      // we ignore all other errors and will handle that when we actually spawn the rover binary
+    }
+  }
 }

package/src/language-server/config/loadConfig.ts

@@ -121,9 +121,11 @@ export async function loadConfig({
 
   let { config, filepath } = loadedConfig;
 
-  return parseApolloConfig(config, URI.file(resolve(filepath)), {
+  const finalConfig = parseApolloConfig(config, URI.file(resolve(filepath)), {
     apiKey,
     serviceName: nameFromKey,
     configPath: dirname(filepath),
   });
+  await finalConfig.verify();
+  return finalConfig;
 }

package/src/language-server/config/loadTsConfig.ts

@@ -93,7 +93,8 @@ export const loadJs: Loader = async function loadJs(filepath, contents) {
     if (
       error instanceof Error &&
       // [ERROR] ReferenceError: module is not defined in ES module scope
-      error.message.includes("module is not defined")
+      // [ERROR] ReferenceError: require is not defined in ES module scope
+      error.message.includes("is not defined in ES module scope")
     ) {
       return loadCachebustedJs(filepath, contents, "commonjs");
     } else {

package/src/language-server/project/rover/DocumentSynchronization.ts

@@ -23,7 +23,7 @@ import {
   rangeInContainingDocument,
 } from "../../utilities/source";
 import { URI } from "vscode-uri";
-import { DEBUG } from "./project";
+import { Debug } from "../../utilities";
 
 export interface FilePart {
   fractionalIndex: string;
@@ -285,7 +285,7 @@ export class DocumentSynchronization {
   }
 
   handlePartDiagnostics(params: PublishDiagnosticsParams) {
-    DEBUG && console.log("Received diagnostics", params);
+    Debug.traceVerbose("Received diagnostics", params);
     const uriDetails = splitUri(params.uri);
     const found = this.knownFiles.get(uriDetails.uri);
     if (!found || found.source === "lsp") {

package/src/language-server/project/rover/project.ts

@@ -36,8 +36,8 @@ import { VSCodeConnection } from "../../server";
 import { getLanguageIdForExtension } from "../../utilities/languageIdForExtension";
 import { extname } from "node:path";
 import type { FileExtension } from "../../../tools/utilities/languageInformation";
-
-export const DEBUG = true;
+import { Debug } from "../../utilities";
+import { TraceLevel } from "src/language-server/utilities/debug";
 
 export function isRoverConfig(config: ApolloConfig): config is RoverConfig {
   return config instanceof RoverConfig;
@@ -115,11 +115,14 @@ export class RoverProject extends GraphQLProject {
     params?: P,
   ): Promise<void> {
     const connection = await this.getConnection();
-    DEBUG &&
-      console.log("sending notification %o", {
+    Debug.traceMessage(
+      "[Rover] Sending notification: " + type.method,
+      "[Rover] Sending notification %o",
+      {
         type: type.method,
         params,
-      });
+      },
+    );
     try {
       return await connection.sendNotification(type, params);
     } catch (error) {
@@ -136,10 +139,20 @@ export class RoverProject extends GraphQLProject {
     token?: CancellationToken,
   ): Promise<R> {
     const connection = await this.getConnection();
-    DEBUG && console.log("sending request %o", { type: type.method, params });
+    Debug.traceMessage(
+      "[Rover] Sending request: " + type.method,
+      "[Rover] Sending request %o",
+      { type: type.method, params },
+    );
     try {
       const result = await connection.sendRequest(type, params, token);
-      DEBUG && console.log({ result });
+      Debug.traceMessage(
+        "[Rover] Received response: " + type.method,
+        "[Rover] Received response %s\nResult: %o",
+        type.method,
+
+        result,
+      );
       return result;
     } catch (error) {
       if (error instanceof Error) {
@@ -166,27 +179,35 @@ export class RoverProject extends GraphQLProject {
     if (this.config.rover.supergraphConfig) {
       args.push("--supergraph-config", this.config.rover.supergraphConfig);
     }
+    if (Debug.traceLevel >= TraceLevel.verbose) {
+      args.push("--log", "debug");
+    }
     args.push(...this.config.rover.extraArgs);
 
-    DEBUG &&
-      console.log(`starting ${this.config.rover.bin} '${args.join("' '")}'`);
+    Debug.traceVerbose(
+      `starting ${this.config.rover.bin} '${args.join("' '")}'`,
+    );
     const child = cp.spawn(this.config.rover.bin, args, {
-      env: DEBUG ? { RUST_BACKTRACE: "1" } : {},
-      stdio: ["pipe", "pipe", DEBUG ? "inherit" : "ignore"],
+      env: { NO_COLOR: "1" },
+      stdio: [
+        "pipe",
+        "pipe",
+        Debug.traceLevel >= TraceLevel.verbose ? "inherit" : "ignore",
+      ],
     });
     this.child = child;
     const reader = new StreamMessageReader(child.stdout);
     const writer = new StreamMessageWriter(child.stdin);
     const connection = createProtocolConnection(reader, writer);
     connection.onClose(() => {
-      DEBUG && console.log("Connection closed");
+      Debug.traceMessage("[Rover] Connection closed");
       child.kill();
       source.cancel();
       this._connection = undefined;
     });
 
     connection.onError((err) => {
-      console.error({ err });
+      Debug.error("%o", { err });
     });
 
     connection.onNotification(
@@ -195,11 +216,14 @@ export class RoverProject extends GraphQLProject {
     );
 
     connection.onUnhandledNotification((notification) => {
-      DEBUG && console.info("unhandled notification from LSP", notification);
+      Debug.traceVerbose(
+        "[Rover] unhandled notification from LSP",
+        notification,
+      );
     });
 
     connection.listen();
-    DEBUG && console.log("Initializing connection");
+    Debug.traceMessage("[Rover] Initializing connection");
 
     const source = new CancellationTokenSource();
     try {
@@ -213,7 +237,11 @@ export class RoverProject extends GraphQLProject {
         source.token,
       );
       this.roverCapabilities = status.capabilities;
-      DEBUG && console.log("Connection initialized", status);
+      Debug.traceMessage(
+        "[Rover] Connection initialized",
+        "[Rover] Connection initialized %o",
+        status,
+      );
 
       await this.connectionStorage.run(
         connection,
@@ -222,7 +250,7 @@ export class RoverProject extends GraphQLProject {
 
       return connection;
     } catch (error) {
-      console.error("Connection failed to initialize", error);
+      Debug.error("Connection with Rover failed to initialize", error);
       throw error;
     }
   }
@@ -295,7 +323,7 @@ export class RoverProject extends GraphQLProject {
     if (isRequestType(SemanticTokensRequest.type, type, params)) {
       return this.documents.getFullSemanticTokens(params, token);
     } else {
-      DEBUG && console.info("unhandled request from VSCode", { type, params });
+      Debug.traceVerbose("unhandled request from VSCode", { type, params });
       return undefined;
     }
   };
@@ -304,8 +332,7 @@ export class RoverProject extends GraphQLProject {
     type,
     params,
   ) => {
-    DEBUG &&
-      console.info("unhandled notification from VSCode", { type, params });
+    Debug.traceVerbose("unhandled notification from VSCode", { type, params });
   };
 
   async onVSCodeConnectionInitialized(connection: VSCodeConnection) {

package/src/language-server/server.ts

@@ -7,6 +7,7 @@ import {
   TextDocumentSyncKind,
   SymbolInformation,
   FileEvent,
+  SetTraceNotification,
 } from "vscode-languageserver/node";
 import { TextDocument } from "vscode-languageserver-textdocument";
 import { type QuickPickItem } from "vscode";
@@ -92,11 +93,16 @@ workspace.onConfigFilesFound(async (params) => {
   );
 });
 
+connection.onNotification(SetTraceNotification.type, ({ value }) => {
+  Debug.traceLevel = value;
+});
+
 connection.onInitialize(
-  async ({ capabilities, workspaceFolders, initializationOptions }) => {
+  async ({ capabilities, workspaceFolders, initializationOptions, trace }) => {
     const { languageIdExtensionMap } =
       initializationOptions as InitializationOptions;
     setLanguageIdExtensionMap(languageIdExtensionMap);
+    Debug.traceLevel = trace;
 
     hasWorkspaceFolderCapability = !!(
       capabilities.workspace && capabilities.workspace.workspaceFolders

package/src/language-server/utilities/debug.ts

@@ -1,5 +1,6 @@
 import { LanguageServerNotifications as Notifications } from "../../messages";
-import { Connection } from "vscode-languageserver/node";
+import { Connection, TraceValues } from "vscode-languageserver/node";
+import { format } from "util";
 
 /**
  * for errors (and other logs in debug mode) we want to print
@@ -15,9 +16,27 @@ const createAndTrimStackTrace = () => {
     : stack;
 };
 
-type Logger = (message?: any) => void;
+type Logger = (message?: any, minLevel?: TraceLevel) => void;
+export enum TraceLevel {
+  "off" = 0,
+  "messages" = 1,
+  "verbose" = 2,
+}
 
 export class Debug {
+  private static _traceLevel: TraceLevel = TraceLevel.off;
+  public static get traceLevel(): TraceLevel {
+    return Debug._traceLevel;
+  }
+  public static set traceLevel(value: TraceValues | undefined) {
+    if (value === "compact") {
+      // we do not handle "compact" and it's not possible to set in settings, but it doesn't hurt to at least map
+      // it to another value
+      this._traceLevel = TraceLevel.messages;
+    } else {
+      this._traceLevel = TraceLevel[value || "off"];
+    }
+  }
   private static connection?: Connection;
   private static infoLogger: Logger = (message) =>
     console.log("[INFO] " + message);
@@ -67,17 +86,39 @@ export class Debug {
     if (error) Debug.errorLogger = error;
   }
 
-  public static info(message: string) {
-    Debug.infoLogger(message);
+  public static info(message: string, ...param: any[]) {
+    Debug.infoLogger(format(message, ...param));
   }
 
-  public static error(message: string) {
+  public static error(message: string, ...param: any[]) {
     const stack = createAndTrimStackTrace();
-    Debug.errorLogger(`${message}\n${stack}`);
+    Debug.errorLogger(`${format(message, ...param)}\n${stack}`);
+  }
+
+  public static warning(message: string, ...param: any[]) {
+    Debug.warningLogger(format(message, ...param));
+  }
+
+  public static traceMessage(
+    short: string,
+    verbose = short,
+    ...verboseParams: any[]
+  ) {
+    if (Debug.traceLevel >= TraceLevel.verbose) {
+      // directly logging to `console` because
+      // we don't want to send yet another notification that will be traced
+      console.info(verbose, ...verboseParams);
+    } else if (Debug.traceLevel >= TraceLevel.messages) {
+      console.info(short);
+    }
   }
 
-  public static warning(message: string) {
-    Debug.warningLogger(message);
+  public static traceVerbose(message: string, ...params: any[]) {
+    if (Debug.traceLevel >= TraceLevel.verbose) {
+      // directly logging to `console` because
+      // we don't want to send yet another notification that will be traced
+      console.info(message, ...params);
+    }
   }
 
   public static sendErrorTelemetry(message: string) {