@singapore-editor/lsp-plugin 0.1.1

package/dist/lane.js

@@ -0,0 +1,138 @@
+import { LspConnection, createWebSocketLspTransportFactory } from "./lspConnection.js";
+import { createDocumentLogicalRevisionScope } from "@singapore-editor/core/document";
+import { composeWorkspaceEditClientCapabilities } from "@singapore-editor/lsp";
+//#region src/lane.ts
+var DEFAULT_TIMEOUT_MS = 15e3;
+var logicalRevisionScopes = /* @__PURE__ */ new WeakMap();
+function acquireLanguageServerLane(options, callbacks = {}) {
+	return acquireResolvedLanguageServerLane(resolveLanguageServerLaneOptions(options), callbacks);
+}
+function acquireResolvedLanguageServerLane(options, callbacks = {}) {
+	const connectionOptions = resolveConnectionOptions(options);
+	const ready = readyPromise();
+	let connectionLease = null;
+	let connection;
+	let registration = null;
+	let released = false;
+	let usable = false;
+	const connectionCallbacks = {
+		onConnected: () => {
+			finishConnection();
+		},
+		onDiagnosticRefresh: () => callbacks.onDiagnosticRefresh?.(),
+		onReconnecting: () => {
+			usable = false;
+			callbacks.onReconnecting?.();
+		},
+		onUnavailable: () => {
+			usable = false;
+			callbacks.onUnavailable?.();
+		},
+		onPublishDiagnostics: (params) => callbacks.onPublishDiagnostics?.(params),
+		onStatusChange: (status) => reportTransportStatus(options, status, released),
+		onError: (error) => {
+			options.onError?.(error);
+			ready.reject(error);
+		}
+	};
+	connectionLease = options.connectionProvider?.acquire(connectionOptions, connectionCallbacks) ?? null;
+	connection = connectionLease?.connection ?? new LspConnection(connectionOptions, connectionCallbacks);
+	const context = connectionContext(connection);
+	const logicalRevisionScope = logicalRevisionScopeFor(connection.workspace);
+	registration = options.onConnectionCreated?.(context) ?? null;
+	if (!connectionLease) connection.connect();
+	return {
+		id: options.id,
+		client: connection.client,
+		logicalRevisionScope,
+		workspace: connection.workspace,
+		ready: ready.promise,
+		isReady: () => usable && !released,
+		release: () => {
+			if (released) return;
+			released = true;
+			usable = false;
+			ready.reject(/* @__PURE__ */ new Error(`Language-server lane "${options.id}" was released before readiness.`));
+			registration?.dispose();
+			registration = null;
+			if (connectionLease) connectionLease.release();
+			else connection.dispose();
+		}
+	};
+	async function finishConnection() {
+		if (released) return;
+		try {
+			for (const notification of options.readyNotifications ?? []) {
+				await connection.client.notify(notification.method, notification.params);
+				if (released) return;
+			}
+			usable = true;
+			options.onStatusChange?.("ready");
+			callbacks.onReady?.();
+			options.onConnected?.(context);
+			ready.resolve(context);
+		} catch (error) {
+			if (released) return;
+			usable = false;
+			options.onStatusChange?.("error");
+			options.onError?.(error);
+			ready.reject(error);
+		}
+	}
+}
+function resolveLanguageServerLaneOptions(options) {
+	return {
+		...options,
+		rootUri: options.rootUri ?? "file:///",
+		timeoutMs: options.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+		capabilities: composeWorkspaceEditClientCapabilities(options.capabilities, options.onApplyWorkspaceEdit !== void 0),
+		createTransport: createWebSocketLspTransportFactory(options.webSocketRoute, options.webSocketTransportOptions)
+	};
+}
+function resolveConnectionOptions(options) {
+	return {
+		rootUri: options.rootUri ?? "file:///",
+		initializationOptions: options.initializationOptions,
+		timeoutMs: options.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+		capabilities: composeWorkspaceEditClientCapabilities(options.capabilities, options.onApplyWorkspaceEdit !== void 0),
+		clientInfo: options.clientInfo,
+		notificationHandlers: options.notificationHandlers,
+		serverRequestHandlers: options.serverRequestHandlers,
+		reconnect: options.reconnect,
+		createTransport: options.createTransport
+	};
+}
+function logicalRevisionScopeFor(workspace) {
+	const current = logicalRevisionScopes.get(workspace);
+	if (current) return current;
+	const created = createDocumentLogicalRevisionScope();
+	logicalRevisionScopes.set(workspace, created);
+	return created;
+}
+function reportTransportStatus(options, status, released) {
+	if (released) return;
+	if (status === "ready") return;
+	options.onStatusChange?.(status);
+}
+function connectionContext(connection) {
+	return {
+		client: connection.client,
+		workspace: connection.workspace
+	};
+}
+function readyPromise() {
+	let resolve;
+	let reject;
+	return {
+		promise: new Promise((resolveReady, rejectReady) => {
+			resolve = resolveReady;
+			reject = rejectReady;
+		}),
+		resolve,
+		reject
+	};
+}
+//#endregion
+export { acquireLanguageServerLane, acquireResolvedLanguageServerLane, logicalRevisionScopeFor, resolveLanguageServerLaneOptions };
+
+//# sourceMappingURL=lane.js.map

package/dist/lane.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lane.js","names":[],"sources":["../src/lane.ts"],"sourcesContent":["import {\n  createDocumentLogicalRevisionScope,\n  type DocumentLogicalRevisionScope,\n} from '@singapore-editor/core/document'\nimport {\n  composeWorkspaceEditClientCapabilities,\n  type LspClient,\n  type LspWorkspace,\n} from '@singapore-editor/lsp'\n\nimport {\n  createWebSocketLspTransportFactory,\n  LspConnection,\n  type LspConnectionCallbacks,\n  type LspConnectionLease,\n  type LspConnectionOptions,\n  type LspConnectionTransportFactory,\n} from './lspConnection'\nimport type {\n  LanguageServerConnectionContext,\n  LanguageServerLaneOptions,\n  LanguageServerStatus,\n} from './types'\n\nconst DEFAULT_TIMEOUT_MS = 15_000\nconst logicalRevisionScopes = new WeakMap<LspWorkspace, DocumentLogicalRevisionScope>()\n\nexport type AcquiredLanguageServerLane = {\n  readonly id: string\n  readonly client: LspClient\n  readonly logicalRevisionScope: DocumentLogicalRevisionScope\n  readonly workspace: LspWorkspace\n  readonly ready: Promise<LanguageServerConnectionContext>\n  isReady(): boolean\n  release(): void\n}\n\nexport type LanguageServerLaneCallbacks = {\n  onDiagnosticRefresh?(): void\n  onReconnecting?(): void\n  onPublishDiagnostics?(params: unknown): void\n  onReady?(): void\n  onUnavailable?(): void\n}\n\nexport type LanguageServerResolvedLaneOptions = Omit<\n  LanguageServerLaneOptions,\n  'webSocketRoute' | 'webSocketTransportOptions'\n> & {\n  createTransport: LspConnectionTransportFactory\n}\n\ntype ReadyPromise = {\n  readonly promise: Promise<LanguageServerConnectionContext>\n  resolve(context: LanguageServerConnectionContext): void\n  reject(error: unknown): void\n}\n\nexport function acquireLanguageServerLane(\n  options: LanguageServerLaneOptions,\n  callbacks: LanguageServerLaneCallbacks = {},\n): AcquiredLanguageServerLane {\n  return acquireResolvedLanguageServerLane(resolveLanguageServerLaneOptions(options), callbacks)\n}\n\nexport function acquireResolvedLanguageServerLane(\n  options: LanguageServerResolvedLaneOptions,\n  callbacks: LanguageServerLaneCallbacks = {},\n): AcquiredLanguageServerLane {\n  const connectionOptions = resolveConnectionOptions(options)\n  const ready = readyPromise()\n  let connectionLease: LspConnectionLease | null = null\n  let connection: LspConnection\n  let registration: { dispose(): void } | null = null\n  let released = false\n  let usable = false\n\n  const connectionCallbacks: LspConnectionCallbacks = {\n    onConnected: () => {\n      void finishConnection()\n    },\n    onDiagnosticRefresh: () => callbacks.onDiagnosticRefresh?.(),\n    onReconnecting: () => {\n      usable = false\n      callbacks.onReconnecting?.()\n    },\n    onUnavailable: () => {\n      usable = false\n      callbacks.onUnavailable?.()\n    },\n    onPublishDiagnostics: (params) => callbacks.onPublishDiagnostics?.(params),\n    onStatusChange: (status) => reportTransportStatus(options, status, released),\n    onError: (error) => {\n      options.onError?.(error)\n      ready.reject(error)\n    },\n  }\n\n  connectionLease =\n    options.connectionProvider?.acquire(connectionOptions, connectionCallbacks) ?? null\n  connection =\n    connectionLease?.connection ?? new LspConnection(connectionOptions, connectionCallbacks)\n  const context = connectionContext(connection)\n  const logicalRevisionScope = logicalRevisionScopeFor(connection.workspace)\n  registration = options.onConnectionCreated?.(context) ?? null\n  if (!connectionLease) connection.connect()\n\n  return {\n    id: options.id,\n    client: connection.client,\n    logicalRevisionScope,\n    workspace: connection.workspace,\n    ready: ready.promise,\n    isReady: () => usable && !released,\n    release: () => {\n      if (released) return\n\n      released = true\n      usable = false\n      ready.reject(new Error(`Language-server lane \"${options.id}\" was released before readiness.`))\n      registration?.dispose()\n      registration = null\n      if (connectionLease) connectionLease.release()\n      else connection.dispose()\n    },\n  }\n\n  async function finishConnection(): Promise<void> {\n    if (released) return\n\n    try {\n      for (const notification of options.readyNotifications ?? []) {\n        await connection.client.notify(notification.method, notification.params)\n        if (released) return\n      }\n\n      usable = true\n      options.onStatusChange?.('ready')\n      callbacks.onReady?.()\n      options.onConnected?.(context)\n      ready.resolve(context)\n    } catch (error) {\n      if (released) return\n\n      usable = false\n      options.onStatusChange?.('error')\n      options.onError?.(error)\n      ready.reject(error)\n    }\n  }\n}\n\nexport function resolveLanguageServerLaneOptions(\n  options: LanguageServerLaneOptions,\n): LanguageServerResolvedLaneOptions {\n  return {\n    ...options,\n    rootUri: options.rootUri ?? 'file:///',\n    timeoutMs: options.timeoutMs ?? DEFAULT_TIMEOUT_MS,\n    capabilities: composeWorkspaceEditClientCapabilities(\n      options.capabilities,\n      options.onApplyWorkspaceEdit !== undefined,\n    ),\n    createTransport: createWebSocketLspTransportFactory(\n      options.webSocketRoute,\n      options.webSocketTransportOptions,\n    ),\n  }\n}\n\nfunction resolveConnectionOptions(\n  options: LanguageServerResolvedLaneOptions,\n): LspConnectionOptions {\n  return {\n    rootUri: options.rootUri ?? 'file:///',\n    initializationOptions: options.initializationOptions,\n    timeoutMs: options.timeoutMs ?? DEFAULT_TIMEOUT_MS,\n    capabilities: composeWorkspaceEditClientCapabilities(\n      options.capabilities,\n      options.onApplyWorkspaceEdit !== undefined,\n    ),\n    clientInfo: options.clientInfo,\n    notificationHandlers: options.notificationHandlers,\n    serverRequestHandlers: options.serverRequestHandlers,\n    reconnect: options.reconnect,\n    createTransport: options.createTransport,\n  }\n}\n\nexport function logicalRevisionScopeFor(workspace: LspWorkspace): DocumentLogicalRevisionScope {\n  const current = logicalRevisionScopes.get(workspace)\n  if (current) return current\n\n  const created = createDocumentLogicalRevisionScope()\n  logicalRevisionScopes.set(workspace, created)\n  return created\n}\n\nfunction reportTransportStatus(\n  options: LanguageServerResolvedLaneOptions,\n  status: LanguageServerStatus,\n  released: boolean,\n): void {\n  if (released) return\n  if (status === 'ready') return\n\n  options.onStatusChange?.(status)\n}\n\nfunction connectionContext(connection: LspConnection): LanguageServerConnectionContext {\n  return {\n    client: connection.client,\n    workspace: connection.workspace,\n  }\n}\n\nfunction readyPromise(): ReadyPromise {\n  let resolve!: ReadyPromise['resolve']\n  let reject!: ReadyPromise['reject']\n  const promise = new Promise<LanguageServerConnectionContext>((resolveReady, rejectReady) => {\n    resolve = resolveReady\n    reject = rejectReady\n  })\n\n  return { promise, resolve, reject }\n}\n"],"mappings":"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"}

package/dist/lspConnection.d.ts

@@ -0,0 +1,94 @@
+import { LspClient, LspWorkspace, type LspManagedTransport, type LspNotificationHandler, type LspServerRequestHandler, type LspWebSocketTransportOptions, type LspWorkerLike } from '@singapore-editor/lsp';
+import type * as lsp from 'vscode-languageserver-protocol';
+import type { LanguageServerStatus } from './types';
+export type LspReconnectOptions = {
+    /** One delay per attempt; when they run out the connection gives up and reports unavailable. */
+    readonly delaysMs: readonly number[];
+};
+export type LspConnectionTransportFactory = () => LspManagedTransport | Promise<LspManagedTransport>;
+export type LspConnectionOptions = {
+    readonly rootUri: lsp.DocumentUri | null;
+    readonly initializationOptions: unknown;
+    readonly timeoutMs: number;
+    /**
+     * Merged over `defaultClientCapabilities()` by the client itself, so a host declares only what it
+     * adds. This is how a host turns on a feature the defaults deliberately leave off —
+     * `textDocument.semanticTokens` among them, which no server sends without being asked.
+     */
+    readonly capabilities?: lsp.ClientCapabilities;
+    /**
+     * Load-bearing rather than cosmetic: at least one real server branches on the client name and
+     * withholds a request from clients it does not recognise. The value is the host's to pick.
+     */
+    readonly clientInfo?: lsp.InitializeParams['clientInfo'];
+    /**
+     * Merged around the connection's own handlers rather than replacing them. See createClient.
+     */
+    readonly notificationHandlers?: Readonly<Record<string, LspNotificationHandler<LspClient>>>;
+    /** Answers the server's requests; the connection's own `workspace/diagnostic/refresh` stays its. */
+    readonly serverRequestHandlers?: Readonly<Record<string, LspServerRequestHandler<LspClient>>>;
+    /** Reconnects a transport that closed or failed on its own. Absent, the first loss is final. */
+    readonly reconnect?: LspReconnectOptions;
+    createTransport(): LspManagedTransport | Promise<LspManagedTransport>;
+};
+export type LspConnectionCallbacks = {
+    /** Also called again after a reconnect: the client re-initialized and re-opened its documents. */
+    onConnected(): void;
+    onDiagnosticRefresh?(): void;
+    /** The transport is gone and another is on its way; what the server said so far is stale. */
+    onReconnecting?(error: unknown): void;
+    onUnavailable(): void;
+    onPublishDiagnostics(params: unknown): void;
+    onStatusChange?: (status: LanguageServerStatus) => void;
+    onError?: (error: unknown) => void;
+};
+/** A connection a view borrows. `release` ends its interest; closing is the provider's call. */
+export type LspConnectionLease = {
+    readonly connection: LspConnection;
+    release(): void;
+};
+/**
+ * Supplies connections that outlive one view, so a file switch does not pay a handshake and an
+ * `initialize` round trip. `options` is the connection the plugin would have built: build from it on
+ * a new key, ignore it on a known one.
+ *
+ * **`callbacks.onConnected` must never fire synchronously from `acquire`** — the caller is
+ * mid-construction. Replay it on a microtask.
+ */
+export type LspConnectionProvider = {
+    acquire(options: LspConnectionOptions, callbacks: LspConnectionCallbacks): LspConnectionLease;
+};
+export declare class LspConnection {
+    private readonly options;
+    private readonly callbacks;
+    readonly workspace: LspWorkspace;
+    readonly client: LspClient;
+    private transport;
+    private removeTransportCloseListener;
+    private disposed;
+    private status;
+    private reconnectAttempts;
+    private readyAt;
+    private reconnectTimer;
+    /** Why the server said it is going, reported as the reason for the close that follows. */
+    private exit;
+    constructor(options: LspConnectionOptions, callbacks: LspConnectionCallbacks);
+    connect(): void;
+    dispose(): void;
+    private createClient;
+    private connectTransport;
+    private connectManagedTransport;
+    /** A server that says anything after announcing its exit did not exit; a later close is its own. */
+    private readonly forgetExitOnLaterMessage;
+    private handleConnected;
+    private handleConnectError;
+    private handleTransportClose;
+    private detachTransport;
+    private giveUpOrReconnect;
+    private scheduleReconnect;
+    private setStatus;
+    private handleError;
+}
+export declare function createWebSocketLspTransportFactory(route: string | URL, options?: LspWebSocketTransportOptions): LspConnectionTransportFactory;
+export declare function createWorkerLspTransportFactory(workerFactory: () => LspWorkerLike): LspConnectionTransportFactory;
+//# sourceMappingURL=lspConnection.d.ts.map

package/dist/lspConnection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lspConnection.d.ts","sourceRoot":"","sources":["../src/lspConnection.ts"],"names":[],"mappings":"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"}

package/dist/lspConnection.js

@@ -0,0 +1,195 @@
+import { LSP_SERVER_EXITED, LspClient, LspServerExitedError, LspWorkspace, createWebSocketLspTransport, createWorkerLspTransport } from "@singapore-editor/lsp";
+//#region src/lspConnection.ts
+var DIAGNOSTIC_REFRESH_METHOD = "workspace/diagnostic/refresh";
+/** A connection that stayed up this long ended a crash streak; its next loss starts a new one. */
+var STABLE_CONNECTION_MS = 6e4;
+var LspConnection = class {
+	options;
+	callbacks;
+	workspace = new LspWorkspace();
+	client;
+	transport = null;
+	removeTransportCloseListener = null;
+	disposed = false;
+	status = "idle";
+	reconnectAttempts = 0;
+	readyAt = null;
+	reconnectTimer = null;
+	/** Why the server said it is going, reported as the reason for the close that follows. */
+	exit = null;
+	constructor(options, callbacks) {
+		this.options = options;
+		this.callbacks = callbacks;
+		this.client = this.createClient();
+	}
+	connect() {
+		this.setStatus("loading");
+		this.connectTransport();
+	}
+	dispose() {
+		if (this.disposed) return;
+		this.disposed = true;
+		if (this.reconnectTimer !== null) clearTimeout(this.reconnectTimer);
+		this.reconnectTimer = null;
+		this.removeTransportCloseListener?.();
+		this.removeTransportCloseListener = null;
+		this.client.disconnect();
+		this.transport?.close();
+		this.transport = null;
+		this.setStatus("idle");
+	}
+	createClient() {
+		const hostHandlers = this.options.notificationHandlers;
+		return new LspClient({
+			rootUri: this.options.rootUri,
+			workspaceFolders: null,
+			workspace: this.workspace,
+			timeoutMs: this.options.timeoutMs,
+			initializationOptions: this.options.initializationOptions,
+			capabilities: this.options.capabilities,
+			clientInfo: this.options.clientInfo,
+			notificationHandlers: {
+				...hostHandlers,
+				[DIAGNOSTIC_REFRESH_METHOD]: (client, params, message) => {
+					this.callbacks.onDiagnosticRefresh?.();
+					hostHandlers?.[DIAGNOSTIC_REFRESH_METHOD]?.(client, params, message);
+					return true;
+				},
+				[LSP_SERVER_EXITED]: (client, params, message) => {
+					this.exit = serverExitedParams(params);
+					hostHandlers?.[LSP_SERVER_EXITED]?.(client, params, message);
+					return true;
+				},
+				"textDocument/publishDiagnostics": (client, params, message) => {
+					this.callbacks.onPublishDiagnostics(params);
+					hostHandlers?.["textDocument/publishDiagnostics"]?.(client, params, message);
+					return true;
+				}
+			},
+			serverRequestHandlers: {
+				...this.options.serverRequestHandlers,
+				[DIAGNOSTIC_REFRESH_METHOD]: () => {
+					this.callbacks.onDiagnosticRefresh?.();
+					return null;
+				}
+			}
+		});
+	}
+	connectTransport() {
+		try {
+			const transport = this.options.createTransport();
+			if (isTransportPromise(transport)) {
+				transport.then((value) => this.connectManagedTransport(value)).catch((error) => {
+					this.handleConnectError(error);
+				});
+				return;
+			}
+			this.connectManagedTransport(transport);
+		} catch (error) {
+			this.handleConnectError(error);
+		}
+	}
+	connectManagedTransport(transport) {
+		if (this.disposed) {
+			transport.close();
+			return;
+		}
+		this.transport = transport;
+		this.exit = null;
+		this.removeTransportCloseListener = transport.onDidClose((error) => this.handleTransportClose(error));
+		transport.subscribe(this.forgetExitOnLaterMessage);
+		this.client.connect(transport).then(() => {
+			if (this.transport === transport) this.handleConnected();
+		}).catch((error) => {
+			if (this.transport === transport) this.handleConnectError(error);
+		});
+	}
+	/** A server that says anything after announcing its exit did not exit; a later close is its own. */
+	forgetExitOnLaterMessage = (message) => {
+		if (this.exit && !message.includes(LSP_SERVER_EXITED)) this.exit = null;
+	};
+	handleConnected() {
+		if (this.disposed) return;
+		this.readyAt = now();
+		this.setStatus("ready");
+		this.callbacks.onConnected();
+	}
+	handleConnectError(error) {
+		if (this.disposed) return;
+		this.detachTransport();
+		this.giveUpOrReconnect(error);
+	}
+	handleTransportClose(error) {
+		if (this.disposed) return;
+		const exit = this.exit;
+		this.exit = null;
+		this.detachTransport();
+		if (exit) {
+			this.giveUpOrReconnect(new LspServerExitedError(exit));
+			return;
+		}
+		this.giveUpOrReconnect(error ?? /* @__PURE__ */ new Error("LSP transport closed"));
+	}
+	detachTransport() {
+		this.removeTransportCloseListener?.();
+		this.removeTransportCloseListener = null;
+		this.transport?.unsubscribe(this.forgetExitOnLaterMessage);
+		this.client.disconnect();
+		this.transport?.close();
+		this.transport = null;
+	}
+	giveUpOrReconnect(error) {
+		if (this.scheduleReconnect(error)) return;
+		this.setStatus("error");
+		this.callbacks.onUnavailable();
+		this.handleError(error);
+	}
+	scheduleReconnect(error) {
+		if (this.readyAt !== null && now() - this.readyAt >= STABLE_CONNECTION_MS) this.reconnectAttempts = 0;
+		this.readyAt = null;
+		const delay = this.options.reconnect?.delaysMs[this.reconnectAttempts];
+		if (delay === void 0) return false;
+		this.reconnectAttempts += 1;
+		this.setStatus("loading");
+		this.callbacks.onReconnecting?.(error);
+		this.reconnectTimer = setTimeout(() => {
+			this.reconnectTimer = null;
+			if (!this.disposed) this.connectTransport();
+		}, delay);
+		return true;
+	}
+	setStatus(status) {
+		if (this.status === status) return;
+		this.status = status;
+		this.callbacks.onStatusChange?.(status);
+	}
+	handleError(error) {
+		this.callbacks.onError?.(error);
+	}
+};
+function createWebSocketLspTransportFactory(route, options) {
+	return () => createWebSocketLspTransport(route, {
+		protocols: options?.protocols,
+		WebSocketCtor: options?.WebSocketCtor
+	});
+}
+function createWorkerLspTransportFactory(workerFactory) {
+	return () => createWorkerLspTransport(workerFactory(), {
+		messageFormat: "json",
+		terminateOnClose: true
+	});
+}
+function now() {
+	return typeof performance === "undefined" ? Date.now() : performance.now();
+}
+function isTransportPromise(value) {
+	return typeof value.then === "function";
+}
+function serverExitedParams(params) {
+	if (typeof params !== "object" || params === null) return null;
+	return typeof params.outcome === "string" ? params : null;
+}
+//#endregion
+export { LspConnection, createWebSocketLspTransportFactory, createWorkerLspTransportFactory };
+
+//# sourceMappingURL=lspConnection.js.map

package/dist/lspConnection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lspConnection.js","names":[],"sources":["../src/lspConnection.ts"],"sourcesContent":["import {\n  createWebSocketLspTransport,\n  createWorkerLspTransport,\n  LSP_SERVER_EXITED,\n  LspClient,\n  LspServerExitedError,\n  LspWorkspace,\n  type LspServerExitedParams,\n  type LspManagedTransport,\n  type LspNotificationHandler,\n  type LspServerRequestHandler,\n  type LspWebSocketTransportOptions,\n  type LspWorkerLike,\n} from '@singapore-editor/lsp'\nimport type * as lsp from 'vscode-languageserver-protocol'\n\nimport type { LanguageServerStatus } from './types'\n\nconst DIAGNOSTIC_REFRESH_METHOD = 'workspace/diagnostic/refresh'\n/** A connection that stayed up this long ended a crash streak; its next loss starts a new one. */\nconst STABLE_CONNECTION_MS = 60_000\n\nexport type LspReconnectOptions = {\n  /** One delay per attempt; when they run out the connection gives up and reports unavailable. */\n  readonly delaysMs: readonly number[]\n}\n\nexport type LspConnectionTransportFactory = () => LspManagedTransport | Promise<LspManagedTransport>\n\nexport type LspConnectionOptions = {\n  readonly rootUri: lsp.DocumentUri | null\n  readonly initializationOptions: unknown\n  readonly timeoutMs: number\n  /**\n   * Merged over `defaultClientCapabilities()` by the client itself, so a host declares only what it\n   * adds. This is how a host turns on a feature the defaults deliberately leave off —\n   * `textDocument.semanticTokens` among them, which no server sends without being asked.\n   */\n  readonly capabilities?: lsp.ClientCapabilities\n  /**\n   * Load-bearing rather than cosmetic: at least one real server branches on the client name and\n   * withholds a request from clients it does not recognise. The value is the host's to pick.\n   */\n  readonly clientInfo?: lsp.InitializeParams['clientInfo']\n  /**\n   * Merged around the connection's own handlers rather than replacing them. See createClient.\n   */\n  readonly notificationHandlers?: Readonly<Record<string, LspNotificationHandler<LspClient>>>\n  /** Answers the server's requests; the connection's own `workspace/diagnostic/refresh` stays its. */\n  readonly serverRequestHandlers?: Readonly<Record<string, LspServerRequestHandler<LspClient>>>\n  /** Reconnects a transport that closed or failed on its own. Absent, the first loss is final. */\n  readonly reconnect?: LspReconnectOptions\n  createTransport(): LspManagedTransport | Promise<LspManagedTransport>\n}\n\nexport type LspConnectionCallbacks = {\n  /** Also called again after a reconnect: the client re-initialized and re-opened its documents. */\n  onConnected(): void\n  onDiagnosticRefresh?(): void\n  /** The transport is gone and another is on its way; what the server said so far is stale. */\n  onReconnecting?(error: unknown): void\n  onUnavailable(): void\n  onPublishDiagnostics(params: unknown): void\n  onStatusChange?: (status: LanguageServerStatus) => void\n  onError?: (error: unknown) => void\n}\n\n/** A connection a view borrows. `release` ends its interest; closing is the provider's call. */\nexport type LspConnectionLease = {\n  readonly connection: LspConnection\n  release(): void\n}\n\n/**\n * Supplies connections that outlive one view, so a file switch does not pay a handshake and an\n * `initialize` round trip. `options` is the connection the plugin would have built: build from it on\n * a new key, ignore it on a known one.\n *\n * **`callbacks.onConnected` must never fire synchronously from `acquire`** — the caller is\n * mid-construction. Replay it on a microtask.\n */\nexport type LspConnectionProvider = {\n  acquire(options: LspConnectionOptions, callbacks: LspConnectionCallbacks): LspConnectionLease\n}\n\nexport class LspConnection {\n  public readonly workspace = new LspWorkspace()\n  public readonly client: LspClient\n\n  private transport: LspManagedTransport | null = null\n  private removeTransportCloseListener: (() => void) | null = null\n  private disposed = false\n  private status: LanguageServerStatus = 'idle'\n  private reconnectAttempts = 0\n  private readyAt: number | null = null\n  private reconnectTimer: ReturnType<typeof setTimeout> | null = null\n  /** Why the server said it is going, reported as the reason for the close that follows. */\n  private exit: LspServerExitedParams | null = null\n\n  public constructor(\n    private readonly options: LspConnectionOptions,\n    private readonly callbacks: LspConnectionCallbacks,\n  ) {\n    this.client = this.createClient()\n  }\n\n  public connect(): void {\n    this.setStatus('loading')\n    this.connectTransport()\n  }\n\n  public dispose(): void {\n    if (this.disposed) return\n\n    this.disposed = true\n    if (this.reconnectTimer !== null) clearTimeout(this.reconnectTimer)\n    this.reconnectTimer = null\n    this.removeTransportCloseListener?.()\n    this.removeTransportCloseListener = null\n    this.client.disconnect()\n    this.transport?.close()\n    this.transport = null\n    this.setStatus('idle')\n  }\n\n  private createClient(): LspClient {\n    const hostHandlers = this.options.notificationHandlers\n    return new LspClient({\n      rootUri: this.options.rootUri,\n      workspaceFolders: null,\n      workspace: this.workspace,\n      timeoutMs: this.options.timeoutMs,\n      initializationOptions: this.options.initializationOptions,\n      capabilities: this.options.capabilities,\n      clientInfo: this.options.clientInfo,\n      // Host handlers are merged *around* the connection's own rather than replacing them: the\n      // whole diagnostics feature hangs off publishDiagnostics, so a host that happens to want that\n      // notification too must not be able to take it away. Its handler runs after ours.\n      notificationHandlers: {\n        ...hostHandlers,\n        [DIAGNOSTIC_REFRESH_METHOD]: (client, params, message) => {\n          this.callbacks.onDiagnosticRefresh?.()\n          hostHandlers?.[DIAGNOSTIC_REFRESH_METHOD]?.(client, params, message)\n          return true\n        },\n        [LSP_SERVER_EXITED]: (client, params, message) => {\n          this.exit = serverExitedParams(params)\n          hostHandlers?.[LSP_SERVER_EXITED]?.(client, params, message)\n          return true\n        },\n        'textDocument/publishDiagnostics': (client, params, message) => {\n          this.callbacks.onPublishDiagnostics(params)\n          hostHandlers?.['textDocument/publishDiagnostics']?.(client, params, message)\n          return true\n        },\n      },\n      serverRequestHandlers: {\n        ...this.options.serverRequestHandlers,\n        [DIAGNOSTIC_REFRESH_METHOD]: () => {\n          this.callbacks.onDiagnosticRefresh?.()\n          return null\n        },\n      },\n    })\n  }\n\n  private connectTransport(): void {\n    try {\n      const transport = this.options.createTransport()\n      if (isTransportPromise(transport)) {\n        void transport\n          .then((value) => this.connectManagedTransport(value))\n          .catch((error) => {\n            this.handleConnectError(error)\n          })\n        return\n      }\n\n      this.connectManagedTransport(transport)\n    } catch (error) {\n      this.handleConnectError(error)\n    }\n  }\n\n  private connectManagedTransport(transport: LspManagedTransport): void {\n    if (this.disposed) {\n      transport.close()\n      return\n    }\n\n    this.transport = transport\n    this.exit = null\n    this.removeTransportCloseListener = transport.onDidClose((error) =>\n      this.handleTransportClose(error),\n    )\n    transport.subscribe(this.forgetExitOnLaterMessage)\n    // Only while this transport is still the connection's: a close that already detached it made\n    // the report, and the initialize it rejected on the way out must not make a second one.\n    void this.client\n      .connect(transport)\n      .then(() => {\n        if (this.transport === transport) this.handleConnected()\n      })\n      .catch((error: unknown) => {\n        if (this.transport === transport) this.handleConnectError(error)\n      })\n  }\n\n  /** A server that says anything after announcing its exit did not exit; a later close is its own. */\n  private readonly forgetExitOnLaterMessage = (message: string): void => {\n    if (this.exit && !message.includes(LSP_SERVER_EXITED)) this.exit = null\n  }\n\n  private handleConnected(): void {\n    if (this.disposed) return\n\n    this.readyAt = now()\n    this.setStatus('ready')\n    this.callbacks.onConnected()\n  }\n\n  private handleConnectError(error: unknown): void {\n    if (this.disposed) return\n\n    this.detachTransport()\n    this.giveUpOrReconnect(error)\n  }\n\n  private handleTransportClose(error?: unknown): void {\n    if (this.disposed) return\n\n    const exit = this.exit\n    this.exit = null\n    this.detachTransport()\n    if (exit) {\n      this.giveUpOrReconnect(new LspServerExitedError(exit))\n      return\n    }\n    this.giveUpOrReconnect(error ?? new Error('LSP transport closed'))\n  }\n\n  private detachTransport(): void {\n    this.removeTransportCloseListener?.()\n    this.removeTransportCloseListener = null\n    this.transport?.unsubscribe(this.forgetExitOnLaterMessage)\n    this.client.disconnect()\n    this.transport?.close()\n    this.transport = null\n  }\n\n  private giveUpOrReconnect(error: unknown): void {\n    if (this.scheduleReconnect(error)) return\n\n    this.setStatus('error')\n    this.callbacks.onUnavailable()\n    this.handleError(error)\n  }\n\n  private scheduleReconnect(error: unknown): boolean {\n    if (this.readyAt !== null && now() - this.readyAt >= STABLE_CONNECTION_MS) {\n      this.reconnectAttempts = 0\n    }\n    this.readyAt = null\n    const delay = this.options.reconnect?.delaysMs[this.reconnectAttempts]\n    if (delay === undefined) return false\n\n    this.reconnectAttempts += 1\n    this.setStatus('loading')\n    this.callbacks.onReconnecting?.(error)\n    // @justification A reconnect backoff, not rendering work: the handle is kept, cleared on dispose,\n    // and a disposed connection ignores it.\n    this.reconnectTimer = setTimeout(() => {\n      this.reconnectTimer = null\n      if (!this.disposed) this.connectTransport()\n    }, delay)\n    return true\n  }\n\n  private setStatus(status: LanguageServerStatus): void {\n    if (this.status === status) return\n\n    this.status = status\n    this.callbacks.onStatusChange?.(status)\n  }\n\n  private handleError(error: unknown): void {\n    this.callbacks.onError?.(error)\n  }\n}\n\nexport function createWebSocketLspTransportFactory(\n  route: string | URL,\n  options?: LspWebSocketTransportOptions,\n): LspConnectionTransportFactory {\n  return () =>\n    createWebSocketLspTransport(route, {\n      protocols: options?.protocols,\n      WebSocketCtor: options?.WebSocketCtor,\n    })\n}\n\nexport function createWorkerLspTransportFactory(\n  workerFactory: () => LspWorkerLike,\n): LspConnectionTransportFactory {\n  return () =>\n    createWorkerLspTransport(workerFactory(), {\n      messageFormat: 'json',\n      terminateOnClose: true,\n    })\n}\n\nfunction now(): number {\n  return typeof performance === 'undefined' ? Date.now() : performance.now()\n}\n\nfunction isTransportPromise(\n  value: LspManagedTransport | Promise<LspManagedTransport>,\n): value is Promise<LspManagedTransport> {\n  return typeof (value as Promise<LspManagedTransport>).then === 'function'\n}\n\nfunction serverExitedParams(params: unknown): LspServerExitedParams | null {\n  if (typeof params !== 'object' || params === null) return null\n  const outcome = (params as { outcome?: unknown }).outcome\n  return typeof outcome === 'string' ? (params as LspServerExitedParams) : null\n}\n"],"mappings":"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"}

package/dist/lspConnectionPool.d.ts

@@ -0,0 +1,34 @@
+import { type LspConnectionCallbacks, type LspConnectionLease, type LspConnectionOptions, type LspConnectionProvider } from './lspConnection';
+import type { LanguageServerStatus } from './types';
+/** What a pooled connection just did, for a host that wants to log it. */
+export type LspConnectionPoolEvent = {
+    readonly kind: 'created' | 'reused' | 'ready' | 'released' | 'closed' | 'retired' | 'reconnecting' | 'error' | 'handler_ignored';
+    readonly key: string;
+    readonly leaseCount: number;
+    readonly status: LanguageServerStatus;
+    /** Time to `initialize` for `ready`; the connection's life so far for `closed`, `retired` and `error`. */
+    readonly durationMs?: number;
+    readonly reachedReady?: boolean;
+    readonly error?: unknown;
+    /** Methods a late borrower declared that this connection cannot dispatch. */
+    readonly methods?: readonly string[];
+};
+export type LspConnectionPoolOptions = {
+    readonly idleGraceMs?: number;
+    readonly onEvent?: (event: LspConnectionPoolEvent) => void;
+};
+/**
+ * One connection per key, outliving the views that borrow it. A view contribution is rebuilt on
+ * every file switch, and a connection it owns dies with it — thirteen handshakes in twenty-two
+ * seconds, measured. The key is opaque: how a server session is named is the host's vocabulary.
+ */
+export declare class LspConnectionPool {
+    #private;
+    constructor(options?: LspConnectionPoolOptions);
+    /** A provider bound to one key, in the shape the plugin takes. */
+    provider(key: string): LspConnectionProvider;
+    acquire(key: string, options: LspConnectionOptions, callbacks: LspConnectionCallbacks): LspConnectionLease;
+    /** Closes every connection. For teardown and for tests, not for routine use. */
+    dispose(): void;
+}
+//# sourceMappingURL=lspConnectionPool.d.ts.map

package/dist/lspConnectionPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lspConnectionPool.d.ts","sourceRoot":"","sources":["../src/lspConnectionPool.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC3B,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AASnD,0EAA0E;AAC1E,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,IAAI,EACT,SAAS,GACT,QAAQ,GACR,OAAO,GACP,UAAU,GACV,QAAQ,GACR,SAAS,GACT,cAAc,GACd,OAAO,GACP,iBAAiB,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;IACrC,0GAA0G;IAC1G,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;IACxB,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACrC,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAA;CAC3D,CAAA;AAiCD;;;;GAIG;AACH,qBAAa,iBAAiB;;gBAKT,OAAO,GAAE,wBAA6B;IAKzD,kEAAkE;IAC3D,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB;IAI5C,OAAO,CACZ,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,oBAAoB,EAC7B,SAAS,EAAE,sBAAsB,GAChC,kBAAkB;IA0BrB,gFAAgF;IACzE,OAAO,IAAI,IAAI;CAmLvB"}