@lspeasy/server 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-present Pradeep Mouli
+
+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,218 @@
+# @lspeasy/server
+
+Build Language Server Protocol (LSP) servers with a simple, type-safe API.
+
+## Installation
+
+```bash
+npm install @lspeasy/server @lspeasy/core
+# or
+pnpm add @lspeasy/server @lspeasy/core
+# or
+yarn add @lspeasy/server @lspeasy/core
+```
+
+For WebSocket server transports, install `ws`:
+
+```bash
+pnpm add ws
+```
+
+## Quick Start
+
+Create a minimal hover server in less than 30 lines:
+
+```typescript
+import { LSPServer, StdioTransport } from '@lspeasy/server';
+import type { HoverParams, Hover } from '@lspeasy/server';
+
+// Create server
+const server = new LSPServer({
+  name: 'my-language-server',
+  version: '1.0.0'
+});
+
+// Set capabilities
+server.setCapabilities({
+  hoverProvider: true
+});
+
+// Register hover handler
+server.onRequest<'textDocument/hover', HoverParams, Hover | null>(
+  'textDocument/hover',
+  async (params, token) => {
+    return {
+      contents: {
+        kind: 'markdown',
+        value: `# Hover\nLine ${params.position.line}`
+      }
+    };
+  }
+);
+
+// Start server
+const transport = new StdioTransport();
+await server.listen(transport);
+```
+
+## Features
+
+- **Type-Safe Handlers**: Fully typed request and notification handlers with IntelliSense support
+- **Automatic Validation**: Built-in parameter validation using Zod schemas
+- **Lifecycle Management**: Automatic initialize/shutdown handshake handling
+- **Cancellation Support**: Built-in cancellation token support for long-running operations
+- **Error Handling**: Comprehensive error handling with LSP error codes
+- **Chainable API**: Fluent API with method chaining
+
+## Handler Registration
+
+### Request Handlers
+
+Request handlers receive parameters, a cancellation token, and return a result:
+
+```typescript
+server.onRequest<'textDocument/completion', CompletionParams, CompletionList>(
+  'textDocument/completion',
+  async (params, token, context) => {
+    // Check for cancellation
+    if (token.isCancellationRequested) {
+      return { isIncomplete: false, items: [] };
+    }
+
+    // Return completions
+    return {
+      isIncomplete: false,
+      items: [
+        { label: 'function', kind: 3 },
+        { label: 'const', kind: 6 }
+      ]
+    };
+  }
+);
+```
+
+### Notification Handlers
+
+Notification handlers receive parameters but don't return a value:
+
+```typescript
+server.onNotification('textDocument/didOpen', (params, context) => {
+  console.log('Document opened:', params.textDocument.uri);
+});
+```
+
+### Method Chaining
+
+Chain multiple handler registrations:
+
+```typescript
+server
+  .onRequest('textDocument/hover', hoverHandler)
+  .onRequest('textDocument/completion', completionHandler)
+  .onNotification('textDocument/didOpen', didOpenHandler)
+  .onNotification('textDocument/didChange', didChangeHandler);
+```
+
+## Server Options
+
+```typescript
+interface ServerOptions {
+  // Server name (sent in initialize response)
+  name?: string;
+
+  // Server version (sent in initialize response)
+  version?: string;
+
+  // Logger instance (defaults to ConsoleLogger)
+  logger?: Logger;
+
+  // Log level (defaults to 'info')
+  logLevel?: 'trace' | 'debug' | 'info' | 'warn' | 'error';
+
+  // Custom validation error handler
+  onValidationError?: (error: ZodError, request: RequestContext) => ResponseError;
+}
+```
+
+## Error Handling
+
+Throw `ResponseError` for custom error codes:
+
+```typescript
+import { ResponseError, JSONRPCErrorCode } from '@lspeasy/server';
+
+server.onRequest('custom/method', async (params) => {
+  if (!params.valid) {
+    throw new ResponseError(
+      JSONRPCErrorCode.InvalidParams,
+      'Validation failed',
+      { details: 'Invalid input' }
+    );
+  }
+  return { success: true };
+});
+```
+
+## Lifecycle
+
+The server automatically handles the LSP lifecycle:
+
+1. **Initialize**: Client sends `initialize` request → Server responds with capabilities
+2. **Initialized**: Client sends `initialized` notification → Server is ready
+3. **Running**: Server processes requests and notifications
+4. **Shutdown**: Client sends `shutdown` request → Server prepares to exit
+5. **Exit**: Client sends `exit` notification → Server closes
+
+### Graceful Shutdown
+
+```typescript
+// Graceful shutdown (waits for pending requests)
+await server.shutdown(5000); // 5 second timeout
+
+// Force close
+await server.close();
+```
+
+## Examples
+
+Check out the [examples directory](../../examples/server/) for complete examples:
+
+- [minimal-server.ts](../../examples/server/minimal-server.ts) - Basic hover server
+- [hover-server.ts](../../examples/server/hover-server.ts) - Hover + completion with document tracking
+
+## API Reference
+
+### LSPServer
+
+```typescript
+class LSPServer<Capabilities extends Partial<ServerCapabilities> = ServerCapabilities>
+```
+
+#### Methods
+
+- `onRequest<Method, Params, Result>(method, handler)` - Register request handler
+- `onNotification<Method, Params>(method, handler)` - Register notification handler
+- `setCapabilities(capabilities)` - Set server capabilities
+- `getCapabilities()` - Get current capabilities
+- `listen(transport)` - Start server on transport
+- `shutdown(timeout?)` - Graceful shutdown
+- `close()` - Force close
+
+### Handler Types
+
+```typescript
+type RequestHandler<Params, Result> = (
+  params: Params,
+  token: CancellationToken,
+  context: RequestContext
+) => Promise<Result> | Result;
+
+type NotificationHandler<Params> = (
+  params: Params,
+  context: NotificationContext
+) => void | Promise<void>;
+```
+
+## License
+
+MIT

package/dist/capability-guard.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Capability validation for server handlers
+ *
+ * Ensures handlers can only be registered for declared capabilities
+ */
+import type { ClientCapabilities, ServerCapabilities } from '@lspeasy/core';
+import type { Logger } from '@lspeasy/core';
+/**
+ * Validates that a handler can be registered for a method
+ * based on declared server capabilities
+ */
+export declare class CapabilityGuard {
+    private readonly capabilities;
+    private readonly logger;
+    private readonly strict;
+    constructor(capabilities: Partial<ServerCapabilities>, logger: Logger, strict?: boolean);
+    /**
+     * 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 capability not declared
+     */
+    canRegisterHandler(method: string): boolean;
+    getAllowedMethods(): string[];
+}
+/**
+ * Validates that server-to-client messages respect declared client capabilities
+ */
+export declare class ClientCapabilityGuard {
+    private readonly capabilities;
+    private readonly logger;
+    private readonly strict;
+    constructor(capabilities: Partial<ClientCapabilities>, logger: Logger, strict?: boolean);
+    /**
+     * Check if a request can be sent to the client
+     *
+     * @param method - LSP method name
+     * @returns true if allowed, false otherwise
+     * @throws Error if strict mode enabled and client capability not declared
+     */
+    canSendRequest(method: string): boolean;
+    /**
+     * Check if a notification can be sent to the client
+     *
+     * @param method - LSP method name
+     * @returns true if allowed, false otherwise
+     * @throws Error if strict mode enabled and client capability not declared
+     */
+    canSendNotification(method: string): boolean;
+    /**
+     * Get list of capabilities the client declared
+     */
+    getClientCapabilities(): Partial<ClientCapabilities>;
+}
+//# sourceMappingURL=capability-guard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capability-guard.d.ts","sourceRoot":"","sources":["../src/capability-guard.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AA+C5C;;;GAGG;AACH,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHzB,YACmB,YAAY,EAAE,OAAO,CAAC,kBAAkB,CAAC,EACzC,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,OAAe,EACtC;IAEJ;;;;;;OAMG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAuD1C;IAED,iBAAiB,IAAI,MAAM,EAAE,CAK5B;CACF;AAED;;GAEG;AACH,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHzB,YACmB,YAAY,EAAE,OAAO,CAAC,kBAAkB,CAAC,EACzC,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,OAAe,EACtC;IAEJ;;;;;;OAMG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CA2CtC;IAED;;;;;;OAMG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CA2C3C;IAED;;OAEG;IACH,qBAAqB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAEnD;CACF"}

package/dist/capability-guard.js

@@ -0,0 +1,212 @@
+/**
+ * Capability validation for server handlers
+ *
+ * Ensures handlers can only be registered for declared capabilities
+ */
+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 handler can be registered for a method
+ * 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 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 capability not declared
+     */
+    canRegisterHandler(method) {
+        if (!SERVER_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);
+            if (this.strict) {
+                throw new Error(error);
+            }
+            return false;
+        }
+        if (SERVER_METHODS.alwaysAllowed.has(method)) {
+            return true;
+        }
+        // Check if method requires a capability (try both request and notification)
+        let capabilityKey = getCapabilityForRequestMethod(method);
+        if (!capabilityKey) {
+            capabilityKey = getCapabilityForNotificationMethod(method);
+        }
+        if (!capabilityKey) {
+            // Unknown method - allow in non-strict mode
+            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);
+            if (this.strict) {
+                throw new Error(error);
+            }
+            return false;
+        }
+        if (capabilityKey === 'alwaysOn') {
+            return true;
+        }
+        // Check if capability is declared
+        if (!hasServerCapability(this.capabilities, capabilityKey)) {
+            const error = `Cannot register handler for ${method}: server capability '${capabilityKey}' not declared`;
+            this.logger.warn(error);
+            if (this.strict) {
+                throw new Error(error);
+            }
+            return false;
+        }
+        return true;
+    }
+    getAllowedMethods() {
+        // This would require iterating through all LSP methods
+        // For now, return an empty array - can be enhanced if needed
+        this.logger.warn('getAllowedMethods not fully implemented - returns empty array');
+        return [];
+    }
+}
+/**
+ * Validates that server-to-client messages respect 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 a request can be sent to the client
+     *
+     * @param method - LSP method name
+     * @returns true if allowed, false otherwise
+     * @throws Error if strict mode enabled and client capability not declared
+     */
+    canSendRequest(method) {
+        if (!CLIENT_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 (CLIENT_METHODS.alwaysAllowed.has(method)) {
+            return true;
+        }
+        const capabilityKey = getClientCapabilityForRequestMethod(method);
+        if (!capabilityKey) {
+            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 (capabilityKey === 'alwaysOn') {
+            return true;
+        }
+        if (!hasClientCapability(this.capabilities, capabilityKey)) {
+            const error = `Cannot send request ${method}: client 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 client
+     *
+     * @param method - LSP method name
+     * @returns true if allowed, false otherwise
+     * @throws Error if strict mode enabled and client capability not declared
+     */
+    canSendNotification(method) {
+        if (!CLIENT_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 (CLIENT_METHODS.alwaysAllowed.has(method)) {
+            return true;
+        }
+        const capabilityKey = getClientCapabilityForNotificationMethod(method);
+        if (!capabilityKey) {
+            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 (capabilityKey === 'alwaysOn') {
+            return true;
+        }
+        if (!hasClientCapability(this.capabilities, capabilityKey)) {
+            const error = `Cannot send notification ${method}: client capability '${capabilityKey}' not declared`;
+            this.logger.warn(error);
+            if (this.strict) {
+                throw new Error(error);
+            }
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Get list of capabilities the client declared
+     */
+    getClientCapabilities() {
+        return { ...this.capabilities };
+    }
+}
+//# 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,19 @@
+/**
+ * Capability-aware dynamic method injection for server
+ *
+ * Dynamically adds handler registration methods and send methods to the server
+ * based on declared capabilities
+ */
+import type { LSPServer } from './server.js';
+import type { ServerCapabilities } from '@lspeasy/core';
+/**
+ * Initialize capability-aware handler registration methods on the server
+ * Creates namespace.onMethod() style methods for registering handlers
+ */
+export declare function initializeServerHandlerMethods<Capabilities extends Partial<ServerCapabilities>>(server: LSPServer<Capabilities>): void;
+/**
+ * Initialize capability-aware send methods on the server
+ * Creates namespace.method() style methods for sending requests/notifications to client
+ */
+export declare function initializeServerSendMethods<Capabilities extends Partial<ServerCapabilities>>(server: LSPServer<Capabilities>): 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;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAIxD;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,YAAY,SAAS,OAAO,CAAC,kBAAkB,CAAC,EAC7F,MAAM,EAAE,SAAS,CAAC,YAAY,CAAC,GAC9B,IAAI,CAyEN;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,SAAS,OAAO,CAAC,kBAAkB,CAAC,EAC1F,MAAM,EAAE,SAAS,CAAC,YAAY,CAAC,GAC9B,IAAI,CAoDN"}

package/dist/capability-proxy.js

@@ -0,0 +1,121 @@
+/**
+ * Capability-aware dynamic method injection for server
+ *
+ * Dynamically adds handler registration methods and send methods to the server
+ * based on declared capabilities
+ */
+import { LSPRequest, LSPNotification, hasServerCapability } from '@lspeasy/core';
+import camelCase from 'camelcase';
+/**
+ * Initialize capability-aware handler registration methods on the server
+ * Creates namespace.onMethod() style methods for registering handlers
+ */
+export function initializeServerHandlerMethods(server) {
+    const capabilities = server.getServerCapabilities();
+    // Add handler registration methods for requests
+    for (const [namespaceName, namespaceDefinitions] of Object.entries(LSPRequest)) {
+        const clientPropertyName = camelCase(namespaceName);
+        const namespace = {};
+        for (const [methodKey, definition] of Object.entries(namespaceDefinitions)) {
+            const def = definition;
+            // Only add methods for clientToServer or both directions
+            if (def.Direction !== 'clientToServer' && def.Direction !== 'both') {
+                continue;
+            }
+            // Check if capability is satisfied
+            if (def.ServerCapability) {
+                // Skip if capability is not set
+                if (!hasServerCapability(capabilities, def.ServerCapability)) {
+                    continue;
+                }
+            }
+            // Create handler registration method: onMethod
+            const handlerMethodName = `on${methodKey}`;
+            namespace[handlerMethodName] = function (handler) {
+                return server.onRequest(def.Method, handler);
+            };
+        }
+        // Only add namespace if it has at least one method
+        if (Object.keys(namespace).length > 0) {
+            if (!server[clientPropertyName]) {
+                server[clientPropertyName] = {};
+            }
+            Object.assign(server[clientPropertyName], namespace);
+        }
+    }
+    // Add handler registration methods for notifications
+    for (const [namespaceName, namespaceDefinitions] of Object.entries(LSPNotification)) {
+        const clientPropertyName = camelCase(namespaceName);
+        const namespace = {};
+        for (const [methodKey, definition] of Object.entries(namespaceDefinitions)) {
+            const def = definition;
+            // Only add methods for clientToServer or both directions
+            if (def.Direction !== 'clientToServer' && def.Direction !== 'both') {
+                continue;
+            }
+            // Check if notification requires capability
+            if (def.ServerCapability && !hasServerCapability(capabilities, def.ServerCapability)) {
+                continue;
+            }
+            // Create handler registration method: onMethod
+            const handlerMethodName = `on${methodKey}`;
+            namespace[handlerMethodName] = function (handler) {
+                return server.onNotification(def.Method, handler);
+            };
+        }
+        // Only add namespace if it has at least one method
+        if (Object.keys(namespace).length > 0) {
+            if (!server[clientPropertyName]) {
+                server[clientPropertyName] = {};
+            }
+            Object.assign(server[clientPropertyName], namespace);
+        }
+    }
+}
+/**
+ * Initialize capability-aware send methods on the server
+ * Creates namespace.method() style methods for sending requests/notifications to client
+ */
+export function initializeServerSendMethods(server) {
+    // Add send methods for server-to-client requests
+    for (const [namespaceName, namespaceDefinitions] of Object.entries(LSPRequest)) {
+        const clientPropertyName = camelCase(namespaceName);
+        if (!server[clientPropertyName]) {
+            server[clientPropertyName] = {};
+        }
+        const namespace = server[clientPropertyName];
+        for (const [methodKey, definition] of Object.entries(namespaceDefinitions)) {
+            const def = definition;
+            // Only add methods for serverToClient or both directions
+            if (def.Direction !== 'serverToClient' && def.Direction !== 'both') {
+                continue;
+            }
+            // Create send method
+            const sendMethodName = camelCase(methodKey);
+            namespace[sendMethodName] = async function (params) {
+                return server.sendRequest(def.Method, params);
+            };
+        }
+    }
+    // Add send methods for server-to-client notifications
+    for (const [namespaceName, namespaceDefinitions] of Object.entries(LSPNotification)) {
+        const clientPropertyName = camelCase(namespaceName);
+        if (!server[clientPropertyName]) {
+            server[clientPropertyName] = {};
+        }
+        const namespace = server[clientPropertyName];
+        for (const [methodKey, definition] of Object.entries(namespaceDefinitions)) {
+            const def = definition;
+            // Only add methods for serverToClient or both directions
+            if (def.Direction !== 'serverToClient' && def.Direction !== 'both') {
+                continue;
+            }
+            // Create send method
+            const sendMethodName = camelCase(methodKey);
+            namespace[sendMethodName] = async function (params) {
+                return server.sendNotification(def.Method, params);
+            };
+        }
+    }
+}
+//# 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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"}