vscode-apollo 2.0.0 → 2.1.0

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

@@ -0,0 +1,302 @@
+import { Source } from "graphql";
+import { extractGraphQLSources } from "../../../document";
+import { handleFilePartUpdates } from "../DocumentSynchronization";
+import { TextDocument } from "vscode-languageserver-textdocument";
+
+const initialFile = `
+Test
+gql\`
+query Test1 {
+  test
+}
+\`
+
+More test
+
+gql\`
+query Test2 {
+  test
+}
+\`
+`;
+
+const editedFile = `
+Test edited
+foo
+bar
+gql\`
+query Test1 {
+  test
+}
+\`
+
+More test lalala
+
+gql\`
+query Test2 {
+  test
+}
+\`
+More stuff here
+`;
+
+const insertedFile = `
+Test edited
+foo
+bar
+gql\`
+query Test1 {
+  test
+}
+\`
+More test lalala
+
+gql\`
+query Test3 {
+  test
+}
+\`
+More test lalala
+
+gql\`
+query Test2 {
+  test
+}
+\`
+More stuff here
+`;
+
+const pushedFile = `
+Test edited
+foo
+bar
+gql\`
+query Test1 {
+  test
+}
+\`
+More test lalala
+
+gql\`
+query Test2 {
+  test
+}
+\`
+More test lalala
+
+gql\`
+query Test3 {
+  test
+}
+\`
+More stuff here
+`;
+
+const shiftedFile = `
+Test
+More test
+
+gql\`
+query Test2 {
+  test
+}
+\`
+`;
+
+const poppedFile = `
+Test
+gql\`
+query Test1 {
+  test
+}
+\`
+
+More test
+
+`;
+
+const query1 = `
+query Test1 {
+  test
+}
+`;
+const query2 = `
+query Test2 {
+  test
+}
+`;
+const query3 = `
+query Test3 {
+  test
+}
+`;
+
+describe("handleFilePartUpdates", () => {
+  const initialUpdates = handleFilePartUpdates(
+    extractGraphQLSources(
+      TextDocument.create("uri", "javascript", 1, initialFile),
+    )!,
+    [],
+  );
+
+  test("newly parsed file", () => {
+    expect(initialUpdates).toEqual([
+      {
+        fractionalIndex: "a0",
+        diagnostics: [],
+        source: new Source(query1, "uri", {
+          column: 5,
+          line: 3,
+        }),
+      },
+      {
+        fractionalIndex: "a1",
+        diagnostics: [],
+        source: new Source(query2, "uri", {
+          column: 5,
+          line: 11,
+        }),
+      },
+    ]);
+  });
+
+  test("edited file", () => {
+    expect(
+      handleFilePartUpdates(
+        extractGraphQLSources(
+          TextDocument.create("uri", "javascript", 2, editedFile),
+        )!,
+        initialUpdates,
+      ),
+    ).toEqual([
+      {
+        fractionalIndex: "a0",
+        diagnostics: [],
+        source: new Source(query1, "uri", {
+          column: 5,
+          line: 5,
+        }),
+      },
+      {
+        fractionalIndex: "a1",
+        diagnostics: [],
+        source: new Source(query2, "uri", {
+          column: 5,
+          line: 13,
+        }),
+      },
+    ]);
+  });
+
+  test("inserted file", () => {
+    expect(
+      handleFilePartUpdates(
+        extractGraphQLSources(
+          TextDocument.create("uri", "javascript", 2, insertedFile),
+        )!,
+        initialUpdates,
+      ),
+    ).toEqual([
+      {
+        fractionalIndex: "a0",
+        diagnostics: [],
+        source: new Source(query1, "uri", {
+          column: 5,
+          line: 5,
+        }),
+      },
+      {
+        fractionalIndex: "a0V",
+        diagnostics: [],
+        source: new Source(query3, "uri", {
+          column: 5,
+          line: 12,
+        }),
+      },
+      {
+        fractionalIndex: "a1",
+        diagnostics: [],
+        source: new Source(query2, "uri", {
+          column: 5,
+          line: 19,
+        }),
+      },
+    ]);
+  });
+
+  test("pushed file", () => {
+    expect(
+      handleFilePartUpdates(
+        extractGraphQLSources(
+          TextDocument.create("uri", "javascript", 2, pushedFile),
+        )!,
+        initialUpdates,
+      ),
+    ).toEqual([
+      {
+        fractionalIndex: "a0",
+        diagnostics: [],
+        source: new Source(query1, "uri", {
+          column: 5,
+          line: 5,
+        }),
+      },
+      {
+        fractionalIndex: "a1",
+        diagnostics: [],
+        source: new Source(query2, "uri", {
+          column: 5,
+          line: 12,
+        }),
+      },
+      {
+        fractionalIndex: "a2",
+        diagnostics: [],
+        source: new Source(query3, "uri", {
+          column: 5,
+          line: 19,
+        }),
+      },
+    ]);
+  });
+
+  test("shifted file", () => {
+    expect(
+      handleFilePartUpdates(
+        extractGraphQLSources(
+          TextDocument.create("uri", "javascript", 2, shiftedFile),
+        )!,
+        initialUpdates,
+      ),
+    ).toEqual([
+      {
+        fractionalIndex: "a1",
+        diagnostics: [],
+        source: new Source(query2, "uri", {
+          column: 5,
+          line: 5,
+        }),
+      },
+    ]);
+  });
+
+  test("popped file", () => {
+    expect(
+      handleFilePartUpdates(
+        extractGraphQLSources(
+          TextDocument.create("uri", "javascript", 2, poppedFile),
+        )!,
+        initialUpdates,
+      ),
+    ).toEqual([
+      {
+        fractionalIndex: "a0",
+        diagnostics: [],
+        source: new Source(query1, "uri", {
+          column: 5,
+          line: 3,
+        }),
+      },
+    ]);
+  });
+});

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

@@ -0,0 +1,276 @@
+import { ProjectStats } from "src/messages";
+import { DocumentUri, GraphQLProject } from "../base";
+import { TextDocument } from "vscode-languageserver-textdocument";
+import {
+  CancellationToken,
+  SymbolInformation,
+  InitializeRequest,
+  StreamMessageReader,
+  StreamMessageWriter,
+  createProtocolConnection,
+  ProtocolConnection,
+  ClientCapabilities,
+  ProtocolRequestType,
+  CompletionRequest,
+  ProtocolNotificationType,
+  DidChangeWatchedFilesNotification,
+  HoverRequest,
+  CancellationTokenSource,
+  PublishDiagnosticsNotification,
+  ConnectionError,
+  ConnectionErrors,
+} from "vscode-languageserver/node";
+import cp from "node:child_process";
+import { GraphQLProjectConfig } from "../base";
+import { ApolloConfig, RoverConfig } from "../../config";
+import { DocumentSynchronization } from "./DocumentSynchronization";
+import { AsyncLocalStorage } from "node:async_hooks";
+import internal from "node:stream";
+
+export const DEBUG = true;
+
+export function isRoverConfig(config: ApolloConfig): config is RoverConfig {
+  return config instanceof RoverConfig;
+}
+
+export interface RoverProjectConfig extends GraphQLProjectConfig {
+  config: RoverConfig;
+  capabilities: ClientCapabilities;
+}
+
+export class RoverProject extends GraphQLProject {
+  config: RoverConfig;
+  /**
+   * Allows overriding the connection for a certain async code path, so inside of initialization,
+   * calls to `this.connection` can immediately resolve without having to wait for initialization
+   * to complete (like every other call to `this.connection` would).
+   */
+  private connectionStorage = new AsyncLocalStorage<ProtocolConnection>();
+  private _connection?: Promise<ProtocolConnection>;
+  private child:
+    | cp.ChildProcessByStdio<internal.Writable, internal.Readable, null>
+    | undefined;
+  private disposed = false;
+  readonly capabilities: ClientCapabilities;
+  get displayName(): string {
+    return "Rover Project";
+  }
+  private documents = new DocumentSynchronization(
+    this.sendNotification.bind(this),
+    (diagnostics) => this._onDiagnostics?.(diagnostics),
+  );
+
+  constructor(options: RoverProjectConfig) {
+    super(options);
+    this.config = options.config;
+    this.capabilities = options.capabilities;
+  }
+
+  initialize() {
+    return [this.getConnection().then(() => {})];
+  }
+
+  /**
+   * Since Rover projects do not scan all the folders in the workspace on start,
+   * we need to restore the information about open documents from the previous session
+   * in case or a project recreation (configuration reload).
+   */
+  restoreFromPreviousProject(previousProject: RoverProject) {
+    for (const document of previousProject.documents.openDocuments) {
+      this.documents.onDidOpenTextDocument({ document });
+    }
+  }
+
+  getConnection(): Promise<ProtocolConnection> {
+    const connectionFromStorage = this.connectionStorage.getStore();
+    if (connectionFromStorage) {
+      return Promise.resolve(connectionFromStorage);
+    }
+
+    if (!this._connection) {
+      this._connection = this.initializeConnection();
+    }
+
+    return this._connection;
+  }
+
+  private async sendNotification<P, RO>(
+    type: ProtocolNotificationType<P, RO>,
+    params?: P,
+  ): Promise<void> {
+    const connection = await this.getConnection();
+    DEBUG &&
+      console.log("sending notification %o", {
+        type: type.method,
+        params,
+      });
+    try {
+      return await connection.sendNotification(type, params);
+    } catch (error) {
+      if (error instanceof Error) {
+        (error as any).cause = { type: type.method, params };
+      }
+      throw error;
+    }
+  }
+
+  private async sendRequest<P, R, PR, E, RO>(
+    type: ProtocolRequestType<P, R, PR, E, RO>,
+    params: P,
+    token?: CancellationToken,
+  ): Promise<R> {
+    const connection = await this.getConnection();
+    DEBUG && console.log("sending request %o", { type: type.method, params });
+    try {
+      const result = await connection.sendRequest(type, params, token);
+      DEBUG && console.log({ result });
+      return result;
+    } catch (error) {
+      if (error instanceof Error) {
+        (error as any).cause = { type: type.method, params };
+      }
+      throw error;
+    }
+  }
+
+  async initializeConnection() {
+    if (this.child) {
+      this.child.kill();
+    }
+    if (this.disposed) {
+      throw new ConnectionError(
+        ConnectionErrors.Closed,
+        "Connection is closed.",
+      );
+    }
+    const child = cp.spawn(this.config.rover.bin, ["lsp"], {
+      env: DEBUG ? { RUST_BACKTRACE: "1" } : {},
+      stdio: ["pipe", "pipe", DEBUG ? "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");
+      child.kill();
+      source.cancel();
+      this._connection = undefined;
+    });
+
+    connection.onError((err) => {
+      console.error({ err });
+    });
+
+    connection.onNotification(
+      PublishDiagnosticsNotification.type,
+      this.documents.handlePartDiagnostics.bind(this.documents),
+    );
+
+    connection.onUnhandledNotification((notification) => {
+      DEBUG && console.info("unhandled notification from LSP", notification);
+    });
+
+    connection.listen();
+    DEBUG && console.log("Initializing connection");
+
+    const source = new CancellationTokenSource();
+    try {
+      const status = await connection.sendRequest(
+        InitializeRequest.type,
+        {
+          capabilities: this.capabilities,
+          processId: process.pid,
+          rootUri: this.rootURI.toString(),
+        },
+        source.token,
+      );
+      DEBUG && console.log("Connection initialized", status);
+
+      await this.connectionStorage.run(
+        connection,
+        this.documents.resendAllDocuments.bind(this.documents),
+      );
+
+      return connection;
+    } catch (error) {
+      console.error("Connection failed to initialize", error);
+      throw error;
+    }
+  }
+
+  getProjectStats(): ProjectStats {
+    return { type: "Rover", loaded: true };
+  }
+
+  includesFile(uri: DocumentUri) {
+    return uri.startsWith(this.rootURI.toString());
+  }
+
+  validate?: () => void;
+
+  onDidChangeWatchedFiles: GraphQLProject["onDidChangeWatchedFiles"] = (
+    params,
+  ) => {
+    return this.sendNotification(
+      DidChangeWatchedFilesNotification.type,
+      params,
+    );
+  };
+
+  onDidOpen: GraphQLProject["onDidOpen"] = (params) =>
+    this.documents.onDidOpenTextDocument(params);
+  onDidClose: GraphQLProject["onDidClose"] = (params) =>
+    this.documents.onDidCloseTextDocument(params);
+
+  async documentDidChange(document: TextDocument) {
+    return this.documents.documentDidChange(document);
+  }
+
+  clearAllDiagnostics() {
+    this.documents.clearAllDiagnostics();
+  }
+
+  dispose() {
+    this.disposed = true;
+    if (this.child) {
+      // this will immediately close the connection without a direct reference
+      this.child.stdout.emit("close");
+      this.child.kill();
+    }
+  }
+
+  onCompletion: GraphQLProject["onCompletion"] = async (params, token) =>
+    this.documents.insideVirtualDocument(params, (virtualParams) =>
+      this.sendRequest(CompletionRequest.type, virtualParams, token),
+    );
+
+  onHover: GraphQLProject["onHover"] = async (params, token) =>
+    this.documents.insideVirtualDocument(params, (virtualParams) =>
+      this.sendRequest(HoverRequest.type, virtualParams, token),
+    );
+
+  onUnhandledRequest: GraphQLProject["onUnhandledRequest"] = (type, params) => {
+    DEBUG && console.info("unhandled request from VSCode", { type, params });
+  };
+  onUnhandledNotification: GraphQLProject["onUnhandledNotification"] = (
+    _connection,
+    type,
+    params,
+  ) => {
+    DEBUG &&
+      console.info("unhandled notification from VSCode", { type, params });
+  };
+
+  // these are not supported yet
+  onDefinition: GraphQLProject["onDefinition"];
+  onReferences: GraphQLProject["onReferences"];
+  onDocumentSymbol: GraphQLProject["onDocumentSymbol"];
+  onCodeLens: GraphQLProject["onCodeLens"];
+  onCodeAction: GraphQLProject["onCodeAction"];
+
+  provideSymbol?(
+    query: string,
+    token: CancellationToken,
+  ): Promise<SymbolInformation[]>;
+}