@lewin671/lsp-client 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Lewin671
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,64 @@
+# Universal LSP Client SDK
+
+A TypeScript SDK for building Language Server Protocol (LSP) clients that run in any environment (Node.js, Browser, Electron, VS Code, etc.).
+
+## Features
+
+- **Universal**: Decoupled from VS Code API. Runs anywhere.
+- **Type-Safe**: Built with TypeScript.
+- **Pluggable Transports**: Support for Stdio, IPC, WebSocket, and custom transports.
+- **Flexible Architecture**: Middleware, Plugins, and Host abstractions.
+
+## Installation
+
+```bash
+npm install lsp-client
+```
+
+## Usage
+
+### Basic Example
+
+```typescript
+import { LanguageClient, StdioTransport } from 'lsp-client';
+
+// 1. Create a transport (e.g., Stdio for a local server)
+const transport = new StdioTransport('path/to/server-executable', ['--stdio']);
+
+// 2. Initialize the client
+const client = new LanguageClient({
+    name: 'My Language Client',
+    transport: transport,
+    // ... other options
+});
+
+// 3. Start the client
+await client.start();
+
+// 4. Send a request
+const result = await client.sendRequest('textDocument/hover', { ... });
+```
+
+## Architecture
+
+See [Agents.md](./Agents.md) for architectural details.
+
+## Development
+
+### Build
+
+```bash
+npm install
+npm run build
+```
+
+### Run Demo
+
+```bash
+npm run demo
+```
+
+## License
+
+MIT
+

package/lib/common/Feature.d.ts

@@ -0,0 +1,192 @@
+import { ClientCapabilities, ServerCapabilities, InitializeParams, DocumentSelector, RegistrationType, TextDocumentRegistrationOptions, StaticRegistrationOptions } from 'vscode-languageserver-protocol';
+/**
+ * Helper function to ensure a property exists on an object
+ */
+export declare function ensure<T, K extends keyof T>(target: T, key: K): T[K];
+/**
+ * Registration data for dynamic features
+ */
+export interface RegistrationData<T> {
+    id: string;
+    registerOptions: T;
+}
+/**
+ * Feature state kind
+ */
+export type FeatureStateKind = 'document' | 'workspace' | 'static' | 'window';
+/**
+ * Feature state describes the current state of a feature
+ */
+export type FeatureState = {
+    kind: 'document';
+    id: string;
+    registrations: boolean;
+    matches: boolean;
+} | {
+    kind: 'workspace';
+    id: string;
+    registrations: boolean;
+} | {
+    kind: 'window';
+    id: string;
+    registrations: boolean;
+} | {
+    kind: 'static';
+};
+/**
+ * A static feature. A static feature can't be dynamically activated via the
+ * server. It is wired during the initialize sequence.
+ */
+export interface StaticFeature {
+    /**
+     * Called to fill the initialize params.
+     */
+    fillInitializeParams?: (params: InitializeParams) => void;
+    /**
+     * Called to fill in the client capabilities this feature implements.
+     */
+    fillClientCapabilities(capabilities: ClientCapabilities): void;
+    /**
+     * A preflight where the server capabilities are shown to all features
+     * before a feature is actually initialized.
+     */
+    preInitialize?: (capabilities: ServerCapabilities, documentSelector: DocumentSelector | undefined) => void;
+    /**
+     * Initialize the feature. This method is called on a feature instance
+     * when the client has successfully received the initialize request from
+     * the server and before the client sends the initialized notification
+     * to the server.
+     */
+    initialize(capabilities: ServerCapabilities, documentSelector: DocumentSelector | undefined): void;
+    /**
+     * Returns the state the feature is in.
+     */
+    getState(): FeatureState;
+    /**
+     * Called when the client is stopped or re-started to clear this feature.
+     */
+    clear(): void;
+}
+export declare namespace StaticFeature {
+    function is(value: any): value is StaticFeature;
+}
+/**
+ * A dynamic feature can be activated via the server.
+ */
+export interface DynamicFeature<RO> {
+    /**
+     * Called to fill the initialize params.
+     */
+    fillInitializeParams?: (params: InitializeParams) => void;
+    /**
+     * Called to fill in the client capabilities this feature implements.
+     */
+    fillClientCapabilities(capabilities: ClientCapabilities): void;
+    /**
+     * A preflight where the server capabilities are shown to all features
+     * before a feature is actually initialized.
+     */
+    preInitialize?: (capabilities: ServerCapabilities, documentSelector: DocumentSelector | undefined) => void;
+    /**
+     * Initialize the feature.
+     */
+    initialize(capabilities: ServerCapabilities, documentSelector: DocumentSelector | undefined): void;
+    /**
+     * Returns the state the feature is in.
+     */
+    getState(): FeatureState;
+    /**
+     * The signature (e.g. method) for which this features support dynamic activation / registration.
+     */
+    registrationType: RegistrationType<RO>;
+    /**
+     * Is called when the server send a register request for the given message.
+     */
+    register(data: RegistrationData<RO>): void;
+    /**
+     * Is called when the server wants to unregister a feature.
+     */
+    unregister(id: string): void;
+    /**
+     * Called when the client is stopped or re-started to clear this feature.
+     */
+    clear(): void;
+}
+export declare namespace DynamicFeature {
+    function is<T>(value: any): value is DynamicFeature<T>;
+}
+/**
+ * Helper interface for getting registration options
+ */
+export interface DocumentSelectorOptions {
+    documentSelector: DocumentSelector;
+}
+/**
+ * Base class for features that work with text documents
+ */
+export declare abstract class TextDocumentFeature<PO, RO extends TextDocumentRegistrationOptions & PO, MW = any> implements DynamicFeature<RO> {
+    protected readonly _client: any;
+    protected readonly _registrations: Map<string, {
+        data: RegistrationData<RO>;
+        disposable?: {
+            dispose(): void;
+        };
+    }>;
+    protected readonly _registrationType: RegistrationType<RO>;
+    constructor(_client: any, registrationType: RegistrationType<RO>);
+    get registrationType(): RegistrationType<RO>;
+    abstract fillClientCapabilities(capabilities: ClientCapabilities): void;
+    abstract initialize(capabilities: ServerCapabilities, documentSelector: DocumentSelector | undefined): void;
+    getState(): FeatureState;
+    register(data: RegistrationData<RO>): void;
+    unregister(id: string): void;
+    clear(): void;
+    /**
+     * Get registration info from server capabilities
+     */
+    protected getRegistration(documentSelector: DocumentSelector | undefined, capability: undefined | PO | (RO & StaticRegistrationOptions)): [string | undefined, (RO & {
+        documentSelector: DocumentSelector;
+    }) | undefined];
+    protected getRegistrationOptions(documentSelector: DocumentSelector | undefined, capability: undefined | PO): (RO & {
+        documentSelector: DocumentSelector;
+    }) | undefined;
+}
+/**
+ * Base class for workspace features
+ */
+export declare abstract class WorkspaceFeature<RO, MW = any> implements DynamicFeature<RO> {
+    protected readonly _client: any;
+    protected readonly _registrations: Map<string, {
+        disposable?: {
+            dispose(): void;
+        };
+    }>;
+    protected readonly _registrationType: RegistrationType<RO>;
+    constructor(_client: any, registrationType: RegistrationType<RO>);
+    get registrationType(): RegistrationType<RO>;
+    abstract fillClientCapabilities(capabilities: ClientCapabilities): void;
+    abstract initialize(capabilities: ServerCapabilities, documentSelector: DocumentSelector | undefined): void;
+    getState(): FeatureState;
+    register(data: RegistrationData<RO>): void;
+    unregister(id: string): void;
+    clear(): void;
+}
+export interface Feature {
+    /**
+     * Called to fill the initialize params.
+     */
+    fillInitializeParams?: (params: InitializeParams) => void;
+    /**
+     * Called to fill in the client capabilities this feature implements.
+     */
+    fillClientCapabilities(capabilities: ClientCapabilities): void;
+    /**
+     * Initialize the feature. This method is called when the client has successfully
+     * received the initialize request from the server.
+     */
+    initialize(capabilities: ServerCapabilities): void;
+    /**
+     * Called when the client is stopped to clear this feature.
+     */
+    clear(): void;
+}

package/lib/common/Feature.js

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkspaceFeature = exports.TextDocumentFeature = exports.DynamicFeature = exports.StaticFeature = void 0;
+exports.ensure = ensure;
+const vscode_languageserver_protocol_1 = require("vscode-languageserver-protocol");
+const Is = require("./utils/is");
+const UUID = require("./utils/uuid");
+/**
+ * Helper function to ensure a property exists on an object
+ */
+function ensure(target, key) {
+    if (target[key] === undefined) {
+        target[key] = {};
+    }
+    return target[key];
+}
+var StaticFeature;
+(function (StaticFeature) {
+    function is(value) {
+        const candidate = value;
+        return candidate !== undefined && candidate !== null &&
+            Is.func(candidate.fillClientCapabilities) &&
+            Is.func(candidate.initialize) &&
+            Is.func(candidate.getState) &&
+            Is.func(candidate.clear) &&
+            (candidate.fillInitializeParams === undefined || Is.func(candidate.fillInitializeParams));
+    }
+    StaticFeature.is = is;
+})(StaticFeature || (exports.StaticFeature = StaticFeature = {}));
+var DynamicFeature;
+(function (DynamicFeature) {
+    function is(value) {
+        const candidate = value;
+        return candidate !== undefined && candidate !== null &&
+            Is.func(candidate.fillClientCapabilities) &&
+            Is.func(candidate.initialize) &&
+            Is.func(candidate.getState) &&
+            Is.func(candidate.clear) &&
+            (candidate.fillInitializeParams === undefined || Is.func(candidate.fillInitializeParams)) &&
+            Is.func(candidate.register) &&
+            Is.func(candidate.unregister) &&
+            candidate.registrationType !== undefined;
+    }
+    DynamicFeature.is = is;
+})(DynamicFeature || (exports.DynamicFeature = DynamicFeature = {}));
+/**
+ * Base class for features that work with text documents
+ */
+class TextDocumentFeature {
+    constructor(_client, registrationType) {
+        this._client = _client;
+        this._registrations = new Map();
+        this._registrationType = registrationType;
+    }
+    get registrationType() {
+        return this._registrationType;
+    }
+    getState() {
+        const registrations = this._registrations.size > 0;
+        return { kind: 'document', id: this.registrationType.method, registrations, matches: registrations };
+    }
+    register(data) {
+        if (!data.registerOptions.documentSelector) {
+            return;
+        }
+        this._registrations.set(data.id, { data });
+    }
+    unregister(id) {
+        const registration = this._registrations.get(id);
+        if (registration !== undefined) {
+            this._registrations.delete(id);
+            if (registration.disposable) {
+                registration.disposable.dispose();
+            }
+        }
+    }
+    clear() {
+        this._registrations.forEach((value) => {
+            if (value.disposable) {
+                value.disposable.dispose();
+            }
+        });
+        this._registrations.clear();
+    }
+    /**
+     * Get registration info from server capabilities
+     */
+    getRegistration(documentSelector, capability) {
+        var _a;
+        if (!capability) {
+            return [undefined, undefined];
+        }
+        else if (vscode_languageserver_protocol_1.TextDocumentRegistrationOptions.is(capability)) {
+            const id = vscode_languageserver_protocol_1.StaticRegistrationOptions.hasId(capability) ? capability.id : UUID.generateUuid();
+            const selector = (_a = capability.documentSelector) !== null && _a !== void 0 ? _a : documentSelector;
+            if (selector) {
+                return [id, Object.assign({}, capability, { documentSelector: selector })];
+            }
+        }
+        else if (Is.boolean(capability) && capability === true || vscode_languageserver_protocol_1.WorkDoneProgressOptions.is(capability)) {
+            if (!documentSelector) {
+                return [undefined, undefined];
+            }
+            const options = (Is.boolean(capability) && capability === true
+                ? { documentSelector }
+                : Object.assign({}, capability, { documentSelector }));
+            return [UUID.generateUuid(), options];
+        }
+        return [undefined, undefined];
+    }
+    getRegistrationOptions(documentSelector, capability) {
+        if (!documentSelector || !capability) {
+            return undefined;
+        }
+        return (Is.boolean(capability) && capability === true
+            ? { documentSelector }
+            : Object.assign({}, capability, { documentSelector }));
+    }
+}
+exports.TextDocumentFeature = TextDocumentFeature;
+/**
+ * Base class for workspace features
+ */
+class WorkspaceFeature {
+    constructor(_client, registrationType) {
+        this._client = _client;
+        this._registrations = new Map();
+        this._registrationType = registrationType;
+    }
+    get registrationType() {
+        return this._registrationType;
+    }
+    getState() {
+        const registrations = this._registrations.size > 0;
+        return { kind: 'workspace', id: this.registrationType.method, registrations };
+    }
+    register(data) {
+        this._registrations.set(data.id, {});
+    }
+    unregister(id) {
+        const registration = this._registrations.get(id);
+        if (registration !== undefined) {
+            this._registrations.delete(id);
+            if (registration.disposable) {
+                registration.disposable.dispose();
+            }
+        }
+    }
+    clear() {
+        this._registrations.forEach((value) => {
+            if (value.disposable) {
+                value.disposable.dispose();
+            }
+        });
+        this._registrations.clear();
+    }
+}
+exports.WorkspaceFeature = WorkspaceFeature;
+//# sourceMappingURL=Feature.js.map

package/lib/common/Feature.js.map

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

package/lib/common/LanguageClient.d.ts

@@ -0,0 +1,230 @@
+import { MessageConnection, InitializeResult, DidOpenTextDocumentParams, DidChangeTextDocumentParams, DidCloseTextDocumentParams, DidSaveTextDocumentParams, ClientCapabilities, ServerCapabilities, DocumentSelector, RegistrationParams, UnregistrationParams, ProtocolNotificationType, ProtocolNotificationType0, ProtocolRequestType, ProtocolRequestType0, NotificationType, NotificationType0, RequestType, RequestType0, CancellationToken, NotificationHandler, NotificationHandler0, RequestHandler, RequestHandler0, GenericNotificationHandler, GenericRequestHandler, TextDocumentSyncKind } from 'vscode-languageserver-protocol';
+import { IHost } from '../interfaces/IHost';
+import { ITransport } from '../transports/ITransport';
+import { Feature, StaticFeature, DynamicFeature } from './Feature';
+/**
+ * Client state enum
+ */
+export declare enum ClientState {
+    Initial = "initial",
+    Starting = "starting",
+    StartFailed = "startFailed",
+    Running = "running",
+    Stopping = "stopping",
+    Stopped = "stopped"
+}
+/**
+ * Public state for external consumers
+ */
+export declare enum State {
+    Stopped = 1,
+    Starting = 3,
+    StartFailed = 4,
+    Running = 2
+}
+/**
+ * State change event
+ */
+export interface StateChangeEvent {
+    oldState: State;
+    newState: State;
+}
+/**
+ * Error action enum
+ */
+export declare enum ErrorAction {
+    Continue = 1,
+    Shutdown = 2
+}
+/**
+ * Close action enum
+ */
+export declare enum CloseAction {
+    DoNotRestart = 1,
+    Restart = 2
+}
+/**
+ * Error handler interface
+ */
+export interface ErrorHandler {
+    error(error: Error, message: any | undefined, count: number | undefined): {
+        action: ErrorAction;
+    };
+    closed(): {
+        action: CloseAction;
+    };
+}
+/**
+ * Middleware interface for intercepting requests/notifications
+ */
+export interface Middleware {
+    didOpen?: (params: DidOpenTextDocumentParams, next: (params: DidOpenTextDocumentParams) => void) => void;
+    didChange?: (params: DidChangeTextDocumentParams, next: (params: DidChangeTextDocumentParams) => void) => void;
+    didClose?: (params: DidCloseTextDocumentParams, next: (params: DidCloseTextDocumentParams) => void) => void;
+    didSave?: (params: DidSaveTextDocumentParams, next: (params: DidSaveTextDocumentParams) => void) => void;
+    handleDiagnostics?: (uri: string, diagnostics: any[], next: (uri: string, diagnostics: any[]) => void) => void;
+    handleRegisterCapability?: (params: RegistrationParams, next: (params: RegistrationParams) => Promise<void>) => Promise<void>;
+    handleUnregisterCapability?: (params: UnregistrationParams, next: (params: UnregistrationParams) => Promise<void>) => Promise<void>;
+}
+/**
+ * Language Client options
+ */
+export interface LanguageClientOptions {
+    documentSelector?: DocumentSelector;
+    middleware?: Middleware;
+    initializationOptions?: any | (() => any);
+    errorHandler?: ErrorHandler;
+}
+/**
+ * Resolved text document sync capabilities
+ */
+export interface ResolvedTextDocumentSyncCapabilities {
+    openClose?: boolean;
+    change?: TextDocumentSyncKind;
+    save?: {
+        includeText?: boolean;
+    } | boolean;
+}
+/**
+ * Event emitter for state changes
+ */
+type StateChangeListener = (event: StateChangeEvent) => void;
+export declare class LanguageClient {
+    private host;
+    private transport;
+    private clientCapabilities;
+    private options;
+    private connection;
+    private _features;
+    private _dynamicFeatures;
+    private _legacyFeatures;
+    private _state;
+    private _initializeResult;
+    private _capabilities;
+    private _onStart;
+    private _onStop;
+    private _stateChangeListeners;
+    private _errorHandler;
+    private _middleware;
+    private _documentSelector;
+    private _ignoredRegistrations;
+    constructor(host: IHost, transport: ITransport, clientCapabilities?: ClientCapabilities, options?: LanguageClientOptions);
+    /**
+     * Get current state
+     */
+    get state(): State;
+    private get $state();
+    private set $state(value);
+    private getPublicState;
+    /**
+     * Add state change listener
+     */
+    onDidChangeState(listener: StateChangeListener): {
+        dispose(): void;
+    };
+    /**
+     * Get initialize result
+     */
+    get initializeResult(): InitializeResult | undefined;
+    /**
+     * Get server capabilities
+     */
+    get capabilities(): ServerCapabilities | undefined;
+    /**
+     * Check if client is running
+     */
+    isRunning(): boolean;
+    /**
+     * Register a legacy feature
+     */
+    registerFeature(feature: Feature): void;
+    /**
+     * Register a static or dynamic feature
+     */
+    registerFeatures(features: (StaticFeature | DynamicFeature<any>)[]): void;
+    /**
+     * Register a single static or dynamic feature
+     */
+    registerStaticOrDynamicFeature(feature: StaticFeature | DynamicFeature<any>): void;
+    /**
+     * Get a dynamic feature by method
+     */
+    getFeature(method: string): DynamicFeature<any> | undefined;
+    /**
+     * Start the language client
+     */
+    start(): Promise<void>;
+    private doStart;
+    private registerBuiltinListeners;
+    private initialize;
+    private handleRegistrationRequest;
+    private handleUnregistrationRequest;
+    /**
+     * Stop the language client
+     */
+    stop(timeout?: number): Promise<void>;
+    private doStop;
+    /**
+     * Send a request to the server
+     */
+    sendRequest<R, PR, E, RO>(type: ProtocolRequestType0<R, PR, E, RO>, token?: CancellationToken): Promise<R>;
+    sendRequest<P, R, PR, E, RO>(type: ProtocolRequestType<P, R, PR, E, RO>, params: P, token?: CancellationToken): Promise<R>;
+    sendRequest<R, E>(type: RequestType0<R, E>, token?: CancellationToken): Promise<R>;
+    sendRequest<P, R, E>(type: RequestType<P, R, E>, params: P, token?: CancellationToken): Promise<R>;
+    sendRequest<R>(method: string, token?: CancellationToken): Promise<R>;
+    sendRequest<R>(method: string, param: any, token?: CancellationToken): Promise<R>;
+    /**
+     * Register a request handler
+     */
+    onRequest<R, PR, E, RO>(type: ProtocolRequestType0<R, PR, E, RO>, handler: RequestHandler0<R, E>): {
+        dispose(): void;
+    };
+    onRequest<P, R, PR, E, RO>(type: ProtocolRequestType<P, R, PR, E, RO>, handler: RequestHandler<P, R, E>): {
+        dispose(): void;
+    };
+    onRequest<R, E>(type: RequestType0<R, E>, handler: RequestHandler0<R, E>): {
+        dispose(): void;
+    };
+    onRequest<P, R, E>(type: RequestType<P, R, E>, handler: RequestHandler<P, R, E>): {
+        dispose(): void;
+    };
+    onRequest<R, E>(method: string, handler: GenericRequestHandler<R, E>): {
+        dispose(): void;
+    };
+    /**
+     * Send a notification to the server
+     */
+    sendNotification<RO>(type: ProtocolNotificationType0<RO>): Promise<void>;
+    sendNotification<P, RO>(type: ProtocolNotificationType<P, RO>, params?: P): Promise<void>;
+    sendNotification(type: NotificationType0): Promise<void>;
+    sendNotification<P>(type: NotificationType<P>, params?: P): Promise<void>;
+    sendNotification(method: string): Promise<void>;
+    sendNotification(method: string, params: any): Promise<void>;
+    /**
+     * Register a notification handler
+     */
+    onNotification<RO>(type: ProtocolNotificationType0<RO>, handler: NotificationHandler0): {
+        dispose(): void;
+    };
+    onNotification<P, RO>(type: ProtocolNotificationType<P, RO>, handler: NotificationHandler<P>): {
+        dispose(): void;
+    };
+    onNotification(type: NotificationType0, handler: NotificationHandler0): {
+        dispose(): void;
+    };
+    onNotification<P>(type: NotificationType<P>, handler: NotificationHandler<P>): {
+        dispose(): void;
+    };
+    onNotification(method: string, handler: GenericNotificationHandler): {
+        dispose(): void;
+    };
+    didOpen(params: DidOpenTextDocumentParams): void;
+    didChange(params: DidChangeTextDocumentParams): void;
+    didClose(params: DidCloseTextDocumentParams): void;
+    didSave(params: DidSaveTextDocumentParams): void;
+    getConnection(): MessageConnection | undefined;
+    getHost(): IHost;
+    get middleware(): Middleware;
+    get documentSelector(): DocumentSelector | undefined;
+}
+export {};