feat: add serverRunning() API (v0.14) for progressive loading

src/apiManager.ts

@@ -22,6 +22,7 @@ class ApiManager {
     private traceEventEmitter: Emitter<any> = new Emitter<any>();
     private sourceInvalidatedEventEmitter: Emitter<SourceInvalidatedEvent> = new Emitter<SourceInvalidatedEvent>();
     private serverReadyPromiseResolve: (result: boolean) => void;
+    private serverRunningPromiseResolve: (result: boolean) => void;
 
     public initialize(requirements: RequirementsData, serverMode: ServerMode): void {
         // if it's manual import mode, set the server mode to lightweight, so that the
@@ -57,6 +58,13 @@ class ApiManager {
             return serverReadyPromise;
         };
 
+        const serverRunningPromise: Promise<boolean> = new Promise<boolean>((resolve) => {
+            this.serverRunningPromiseResolve = resolve;
+        });
+        const serverRunning = async () => {
+            return serverRunningPromise;
+        };
+
         this.api = {
             apiVersion: extensionApiVersion,
             javaRequirement: requirements,
@@ -73,6 +81,7 @@ class ApiManager {
             onDidProjectsImport,
             onDidProjectsDelete,
             serverReady,
+            serverRunning,
             onWillRequestStart,
             onDidRequestEnd,
             trackEvent: traceEvent,
@@ -123,6 +132,10 @@ class ApiManager {
     public resolveServerReadyPromise(): void {
         this.serverReadyPromiseResolve(true);
     }
+
+    public resolveServerRunningPromise(): void {
+        this.serverRunningPromiseResolve?.(true);
+    }
 }
 
 export const apiManager: ApiManager = new ApiManager();

src/extension.api.ts

@@ -111,7 +111,7 @@ export interface SourceInvalidatedEvent {
 	affectedEditorDocuments?: Uri[];
 }
 
-export const extensionApiVersion = '0.13';
+export const extensionApiVersion = '0.14';
 
 export interface ExtensionAPI {
 	readonly apiVersion: string;
@@ -167,6 +167,14 @@ export interface ExtensionAPI {
 	 */
 	readonly serverReady: () => Promise<boolean>;
 
+	/**
+	 * A promise that will be resolved when the language server process is running
+	 * and can accept requests, even if project imports have not yet completed.
+	 * This allows extensions to start querying for projects incrementally during import.
+	 * @since API version 0.14
+	 */
+	readonly serverRunning?: () => Promise<boolean>;
+
 	/**
 	 * An event that's fired when a request is about to send to language server.
 	 * @since API version 0.12

src/standardLanguageClient.ts

@@ -121,6 +121,9 @@ export class StandardLanguageClient {
 	public registerLanguageClientActions(context: ExtensionContext, hasImported: boolean, jdtEventEmitter: EventEmitter<Uri>) {
 		activationProgressNotification.showProgress();
 		this.languageClient.onNotification(StatusNotification.type, (report) => {
+			// Resolve serverRunning on the first status notification from the server,
+			// indicating the server process is alive and can accept requests.
+			apiManager.resolveServerRunningPromise();
 			switch (report.type) {
 				case 'ServiceReady':
 					apiManager.updateServerMode(ServerMode.standard);