@lspeasy/client 1.0.1

package/dist/capability-guard.js

@@ -0,0 +1,230 @@
+/**
+ * Capability validation for client requests
+ *
+ * Ensures clients only send requests/notifications that the server supports
+ */
+import { LSPNotification, LSPRequest, getClientCapabilityForNotificationMethod, getClientCapabilityForRequestMethod, hasServerCapability, hasClientCapability, getCapabilityForNotificationMethod, getCapabilityForRequestMethod } from '@lspeasy/core';
+function buildMethodSets(capabilityKey) {
+    const all = new Set();
+    const alwaysAllowed = new Set();
+    for (const namespaceDefinitions of Object.values(LSPRequest)) {
+        for (const definition of Object.values(namespaceDefinitions)) {
+            const entry = definition;
+            all.add(entry.Method);
+            if (!entry[capabilityKey]) {
+                alwaysAllowed.add(entry.Method);
+            }
+        }
+    }
+    for (const namespaceDefinitions of Object.values(LSPNotification)) {
+        for (const definition of Object.values(namespaceDefinitions)) {
+            const entry = definition;
+            all.add(entry.Method);
+            if (!entry[capabilityKey]) {
+                alwaysAllowed.add(entry.Method);
+            }
+        }
+    }
+    return { all, alwaysAllowed };
+}
+const SERVER_METHODS = buildMethodSets('ServerCapability');
+const CLIENT_METHODS = buildMethodSets('ClientCapability');
+/**
+ * Validates that a request/notification can be sent based on
+ * declared server capabilities
+ */
+export class CapabilityGuard {
+    capabilities;
+    logger;
+    strict;
+    constructor(capabilities, logger, strict = false) {
+        this.capabilities = capabilities;
+        this.logger = logger;
+        this.strict = strict;
+    }
+    /**
+     * Check if a request can be sent to the server
+     *
+     * @param method - LSP method name
+     * @returns true if allowed, false otherwise
+     * @throws Error if strict mode enabled and server capability not declared
+     */
+    canSendRequest(method) {
+        if (!SERVER_METHODS.all.has(method)) {
+            if (!this.strict) {
+                this.logger.debug(`Unknown request method ${method}, allowing in non-strict mode`);
+                return true;
+            }
+            const error = `Cannot send request for unknown method: ${method}`;
+            this.logger.error(error);
+            throw new Error(error);
+        }
+        if (SERVER_METHODS.alwaysAllowed.has(method)) {
+            return true;
+        }
+        // Check if server supports this request method
+        const capabilityKey = getCapabilityForRequestMethod(method);
+        if (!capabilityKey) {
+            // Unknown method - allow in non-strict mode with warning
+            if (!this.strict) {
+                this.logger.debug(`Unknown request method ${method}, allowing in non-strict mode`);
+                return true;
+            }
+            const error = `Cannot send request for unknown method: ${method}`;
+            this.logger.error(error);
+            throw new Error(error);
+        }
+        // Methods marked as 'alwaysOn' don't require explicit capabilities
+        if (capabilityKey === 'alwaysOn') {
+            return true;
+        }
+        // Check if server declared this capability
+        if (!hasServerCapability(this.capabilities, capabilityKey)) {
+            const error = `Cannot send request ${method}: server capability '${capabilityKey}' not declared`;
+            this.logger.warn(error);
+            if (this.strict) {
+                throw new Error(error);
+            }
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Check if a notification can be sent to the server
+     *
+     * @param method - LSP method name
+     * @returns true if allowed, false otherwise
+     * @throws Error if strict mode enabled and server capability not declared
+     */
+    canSendNotification(method) {
+        if (!SERVER_METHODS.all.has(method)) {
+            if (!this.strict) {
+                this.logger.debug(`Unknown notification method ${method}, allowing in non-strict mode`);
+                return true;
+            }
+            const error = `Cannot send notification for unknown method: ${method}`;
+            this.logger.error(error);
+            throw new Error(error);
+        }
+        if (SERVER_METHODS.alwaysAllowed.has(method)) {
+            return true;
+        }
+        // Check if server supports this notification method
+        const capabilityKey = getCapabilityForNotificationMethod(method);
+        if (!capabilityKey) {
+            // Unknown method - allow in non-strict mode with warning
+            if (!this.strict) {
+                this.logger.debug(`Unknown notification method ${method}, allowing in non-strict mode`);
+                return true;
+            }
+            const error = `Cannot send notification for unknown method: ${method}`;
+            this.logger.error(error);
+            throw new Error(error);
+        }
+        // Methods marked as 'alwaysOn' don't require explicit capabilities
+        if (capabilityKey === 'alwaysOn') {
+            return true;
+        }
+        // Check if server declared this capability
+        if (!hasServerCapability(this.capabilities, capabilityKey)) {
+            const error = `Cannot send notification ${method}: server capability '${capabilityKey}' not declared`;
+            this.logger.warn(error);
+            if (this.strict) {
+                throw new Error(error);
+            }
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Get list of capabilities the server declared
+     */
+    getServerCapabilities() {
+        return { ...this.capabilities };
+    }
+}
+/**
+ * Validates that handlers can be registered based on
+ * declared client capabilities
+ */
+export class ClientCapabilityGuard {
+    capabilities;
+    logger;
+    strict;
+    constructor(capabilities, logger, strict = false) {
+        this.capabilities = capabilities;
+        this.logger = logger;
+        this.strict = strict;
+    }
+    /**
+     * Check if handler registration is allowed for this method
+     *
+     * @param method - LSP method name
+     * @returns true if allowed, false otherwise
+     * @throws Error if strict mode enabled and client capability not declared
+     */
+    canRegisterHandler(method) {
+        if (!CLIENT_METHODS.all.has(method)) {
+            if (!this.strict) {
+                this.logger.debug(`Unknown method ${method}, allowing in non-strict mode`);
+                return true;
+            }
+            const error = `Cannot register handler for unknown method: ${method}`;
+            this.logger.error(error);
+            throw new Error(error);
+        }
+        if (CLIENT_METHODS.alwaysAllowed.has(method)) {
+            return true;
+        }
+        const capabilityKey = getClientCapabilityForRequestMethod(method);
+        if (!capabilityKey) {
+            const notificationCapability = getClientCapabilityForNotificationMethod(method);
+            if (!notificationCapability) {
+                if (!this.strict) {
+                    this.logger.debug(`Unknown method ${method}, allowing in non-strict mode`);
+                    return true;
+                }
+                const error = `Cannot register handler for unknown method: ${method}`;
+                this.logger.error(error);
+                throw new Error(error);
+            }
+            return this.isNotificationAllowed(method, notificationCapability);
+        }
+        return this.isRequestAllowed(method, capabilityKey);
+    }
+    /**
+     * Get list of capabilities the client declared
+     */
+    getClientCapabilities() {
+        return { ...this.capabilities };
+    }
+    isRequestAllowed(method, capabilityKey) {
+        if (capabilityKey === 'alwaysOn') {
+            return true;
+        }
+        if (!hasClientCapability(this.capabilities, capabilityKey)) {
+            const error = `Cannot register handler for ${method}: client capability '${capabilityKey}' not declared`;
+            this.logger.warn(error);
+            if (this.strict) {
+                throw new Error(error);
+            }
+            return false;
+        }
+        return true;
+    }
+    isNotificationAllowed(method, capabilityKey) {
+        if (capabilityKey === 'alwaysOn') {
+            return true;
+        }
+        if (!hasClientCapability(this.capabilities, capabilityKey)) {
+            const error = `Cannot register handler for ${method}: client capability '${capabilityKey}' not declared`;
+            this.logger.warn(error);
+            if (this.strict) {
+                throw new Error(error);
+            }
+            return false;
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=capability-guard.js.map

package/dist/capability-guard.js.map

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

package/dist/capability-proxy.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Capability-aware dynamic method injection for client
+ *
+ * Dynamically adds methods/namespaces to the client object based on server capabilities
+ */
+import type { LSPClient } from './client.js';
+/**
+ * Initializes capability-aware methods on the client object based on LSPRequest definitions
+ */
+export declare function initializeCapabilityMethods<ClientCaps extends Partial<import('@lspeasy/core').ClientCapabilities>>(client: LSPClient<ClientCaps>): void;
+/**
+ * Updates capability-aware methods on the client after server capabilities are received
+ * This should be called after initialization to add/remove methods based on actual capabilities
+ */
+export declare function updateCapabilityMethods<ClientCaps extends Partial<import('@lspeasy/core').ClientCapabilities>>(client: LSPClient<ClientCaps>): void;
+//# sourceMappingURL=capability-proxy.d.ts.map

package/dist/capability-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-proxy.d.ts","sourceRoot":"","sources":["../src/capability-proxy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAU7C;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,SAAS,OAAO,CAAC,OAAO,eAAe,EAAE,kBAAkB,CAAC,EACtE,MAAM,EAAE,SAAS,CAAC,UAAU,CAAC,GAAG,IAAI,CAoDrC;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,SAAS,OAAO,CAAC,OAAO,eAAe,EAAE,kBAAkB,CAAC,EACtE,MAAM,EAAE,SAAS,CAAC,UAAU,CAAC,GAAG,IAAI,CAGrC"}

package/dist/capability-proxy.js

@@ -0,0 +1,69 @@
+/**
+ * Capability-aware dynamic method injection for client
+ *
+ * Dynamically adds methods/namespaces to the client object based on server capabilities
+ */
+import { LSPRequest, LSPNotification, getDefinitionForRequest, getDefinitionForNotification, hasServerCapability } from '@lspeasy/core';
+import camelCase from 'camelcase';
+function deriveNotificationMethodKey(namespaceName, notificationKey) {
+    if (notificationKey.endsWith(namespaceName)) {
+        return notificationKey.slice(0, -namespaceName.length);
+    }
+    return notificationKey;
+}
+/**
+ * Initializes capability-aware methods on the client object based on LSPRequest definitions
+ */
+export function initializeCapabilityMethods(client) {
+    if (!client.serverCapabilities) {
+        // Server capabilities not yet known; cannot initialize methods
+        return;
+    }
+    // Attach all namespaces from LSPRequest
+    for (const [namespaceName, namespaceDefinitions] of Object.entries(LSPRequest)) {
+        // Convert namespace name to camelCase for the client property
+        // e.g., "TextDocument" -> "textDocument", "Workspace" -> "workspace"
+        const clientPropertyName = camelCase(namespaceName);
+        const namespace = {};
+        for (const request in namespaceDefinitions) {
+            const d = getDefinitionForRequest(namespaceName, request);
+            // Only add methods if:
+            // 1. No capability required (ServerCapability is undefined/null), OR
+            // 2. Server has the required capability
+            if (!d.ServerCapability ||
+                hasServerCapability(client.serverCapabilities, d.ServerCapability)) {
+                namespace[camelCase(request)] = (a, b) => client.sendRequest(d.Method, a, b);
+            }
+            // If capability is missing, don't add the method at all (runtime matches types)
+        }
+        // Only add namespace if it has at least one method
+        if (Object.keys(namespace).length > 0) {
+            client[clientPropertyName] = namespace;
+        }
+    }
+    // Also attach notification namespaces if needed
+    for (const [namespaceName, namespaceDefinitions] of Object.entries(LSPNotification)) {
+        const clientPropertyName = camelCase(namespaceName);
+        if (!client[clientPropertyName]) {
+            client[clientPropertyName] = {};
+        }
+        for (const notification in namespaceDefinitions) {
+            const d = getDefinitionForNotification(namespaceName, notification);
+            // Notifications typically don't require capabilities, but check anyway
+            if (!d.ServerCapability ||
+                hasServerCapability(client.serverCapabilities, d.ServerCapability)) {
+                const methodKey = deriveNotificationMethodKey(namespaceName, notification);
+                client[clientPropertyName][camelCase(methodKey)] = (a) => client.sendNotification(d.Method, a);
+            }
+        }
+    }
+}
+/**
+ * Updates capability-aware methods on the client after server capabilities are received
+ * This should be called after initialization to add/remove methods based on actual capabilities
+ */
+export function updateCapabilityMethods(client) {
+    // Re-run initialization to update methods based on new capabilities
+    initializeCapabilityMethods(client);
+}
+//# sourceMappingURL=capability-proxy.js.map

package/dist/capability-proxy.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,184 @@
+/**
+ * LSP Client implementation
+ */
+import type { Transport, Disposable, CancellationToken, LSPRequestMethod, ParamsForRequest, ResultForRequest, LSPNotificationMethod, ParamsForNotification, ServerCapabilities, ClientCapabilities, Client } from '@lspeasy/core';
+import type { ClientOptions, InitializeResult, CancellableRequest } from './types.js';
+import type { ConnectionHealth, StateChangeEvent } from './connection/index.js';
+/**
+ * Interface for dynamically added namespace methods
+ */
+/**
+ * Type alias to add capability-aware methods to LSPClient
+ * These methods are added at runtime via capability-proxy.ts
+ */
+/**
+ * LSP Client for connecting to language servers
+ *
+ * This class dynamically extends with capability-aware methods based on server capabilities.
+ * Use `.expect<ServerCaps>()` after initialization to get typed access to server capabilities.
+ *
+ * @template ClientCaps - Client capabilities (defaults to ClientCapabilities)
+ *
+ * @example
+ * // Create a client, then narrow server capabilities after connecting
+ * const client = new LSPClient<MyClientCaps>();
+ * await client.connect(transport);
+ * const typed = client.expect<{ hoverProvider: true; completionProvider: {} }>();
+ * // typed.textDocument.hover is available (typed)
+ * // typed.textDocument.completion is available (typed)
+ */
+declare class BaseLSPClient<ClientCaps extends Partial<ClientCapabilities> = ClientCapabilities> {
+    private transport?;
+    private connected;
+    private initialized;
+    private pendingRequests;
+    private requestHandlers;
+    private notificationHandlers;
+    private events;
+    private transportAttachment;
+    private readonly logger;
+    private readonly middlewareRegistrations;
+    private readonly options;
+    private capabilities?;
+    serverCapabilities?: ServerCapabilities;
+    private serverInfo?;
+    private readonly onValidationError?;
+    private capabilityGuard?;
+    private clientCapabilityGuard?;
+    private readonly healthTracker;
+    private heartbeatMonitor;
+    private notificationWaiters;
+    constructor(options?: ClientOptions<ClientCaps>);
+    /**
+     * Connect to server and complete initialization
+     */
+    connect(transport: Transport): Promise<InitializeResult>;
+    /**
+     * Disconnect from server
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Check if client is connected
+     */
+    isConnected(): boolean;
+    /**
+     * Send a request to the server
+     */
+    sendRequest<K extends LSPRequestMethod<'clientToServer'>>(method: K, params?: ParamsForRequest<K>, token?: CancellationToken): Promise<ResultForRequest<K>>;
+    /**
+     * Send a notification to the server
+     */
+    sendNotification<M extends LSPNotificationMethod<'clientToServer'>>(method: M, params?: ParamsForNotification<M>): Promise<void>;
+    /**
+     * Send a cancellable request
+     */
+    sendCancellableRequest<M extends LSPRequestMethod<'clientToServer'>>(method: M, params?: ParamsForRequest<M>): CancellableRequest<ResultForRequest<M>>;
+    /**
+     * Register handler for server-to-client requests
+     */
+    onRequest<M extends LSPRequestMethod<'serverToClient'>>(method: M, handler: (params: ParamsForRequest<M>) => Promise<ResultForRequest<M>> | ResultForRequest<M>): Disposable;
+    /**
+     * Register handler for server notifications
+     */
+    onNotification<M extends LSPNotificationMethod<'serverToClient'>>(method: M, handler: (params: ParamsForNotification<M>) => void): Disposable;
+    /**
+     * Wait for the next matching server notification.
+     */
+    waitForNotification<M extends LSPNotificationMethod<'serverToClient'>>(method: M, options: {
+        timeout: number;
+        filter?: (params: ParamsForNotification<M>) => boolean;
+    }): Promise<ParamsForNotification<M>>;
+    /**
+     * Subscribe to connection events
+     */
+    onConnected(handler: () => void): Disposable;
+    /**
+     * Subscribe to disconnection events
+     */
+    onDisconnected(handler: () => void): Disposable;
+    /**
+     * Subscribe to error events
+     */
+    onError(handler: (error: Error) => void): Disposable;
+    onConnectionStateChange(handler: (event: StateChangeEvent) => void): Disposable;
+    onConnectionHealthChange(handler: (health: ConnectionHealth) => void): Disposable;
+    getConnectionHealth(): ConnectionHealth;
+    /**
+     * Get server capabilities
+     */
+    getServerCapabilities(): ServerCapabilities | undefined;
+    /**
+     * Get server info
+     */
+    getServerInfo(): {
+        name: string;
+        version?: string;
+    } | undefined;
+    /**
+     * Set client capabilities
+     */
+    setCapabilities(capabilities: ClientCaps): void;
+    /**
+     * Get client capabilities
+     */
+    getClientCapabilities(): ClientCaps | undefined;
+    /**
+     * Register a single client capability, returning a new typed reference via intersection.
+     * The returned reference is the same instance, with a narrowed type that includes
+     * the newly registered capability.
+     *
+     * Note: This updates the local capability reference. To notify the server of capability
+     * changes, the LSP 3.17 client/registerCapability request should be used separately.
+     *
+     * @template K - The capability key to register
+     * @param key - The client capability key
+     * @param value - The capability value
+     * @returns The same client instance with an expanded capability type
+     *
+     * @example
+     * const client = new LSPClient();
+     * const withWorkspace = client.registerCapability('workspace', { workspaceFolders: true });
+     * // withWorkspace is typed as LSPClient<ClientCaps & Pick<ClientCapabilities, 'workspace'>>
+     */
+    registerCapability<K extends keyof ClientCapabilities>(key: K, value: ClientCapabilities[K]): LSPClient<ClientCaps & Pick<ClientCapabilities, K>>;
+    /**
+     * Zero-cost type narrowing for server capabilities.
+     * Returns `this` cast to include capability-aware methods for the given ServerCaps.
+     *
+     * @template S - The expected server capabilities shape
+     * @returns The same client instance, typed with capability-aware methods
+     *
+     * @example
+     * const client = new LSPClient<MyClientCaps>();
+     * await client.connect(transport);
+     * const typed = client.expect<{ hoverProvider: true }>();
+     * const result = await typed.textDocument.hover(params);
+     */
+    expect<S extends Partial<ServerCapabilities>>(): this & Client<ClientCaps, S>;
+    /**
+     * Handle incoming message from transport
+     */
+    private handleMessage;
+    private handleResponse;
+    private resolveShortCircuitRequest;
+    private buildMiddlewareContext;
+    private sendWithMiddleware;
+    private handleRequest;
+    /**
+     * Handle notification message from server
+     */
+    private handleNotification;
+    /**
+     * Handle transport error
+     */
+    private handleError;
+    /**
+     * Handle connection close
+     */
+    private handleClose;
+    private startHeartbeatIfConfigured;
+}
+export type LSPClient<ClientCaps extends Partial<ClientCapabilities> = ClientCapabilities> = BaseLSPClient<ClientCaps> & Client<ClientCaps, ServerCapabilities>;
+export declare const LSPClient: new <ClientCaps extends Partial<ClientCapabilities> = ClientCapabilities>(options?: ClientOptions<ClientCaps>) => LSPClient<ClientCaps>;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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