@lspeasy/server 1.0.1

package/dist/dispatcher.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Message dispatcher - routes incoming requests to registered handlers
+ */
+import type { Message, Transport, Logger, ClientCapabilities } from '@lspeasy/core';
+import type { RequestHandler, NotificationHandler } from './types.js';
+/**
+ * Message dispatcher manages request/notification routing
+ */
+export declare class MessageDispatcher {
+    private readonly logger;
+    private requestHandlers;
+    private notificationHandlers;
+    private pendingRequests;
+    private clientCapabilities?;
+    constructor(logger: Logger);
+    /**
+     * Register a request handler
+     */
+    registerRequest<Params, Result>(method: string, handler: RequestHandler<Params, Result>): void;
+    /**
+     * Register a notification handler
+     */
+    registerNotification<Params>(method: string, handler: NotificationHandler<Params>): void;
+    /**
+     * Unregister a request handler
+     */
+    unregisterRequest(method: string): void;
+    /**
+     * Unregister a notification handler
+     */
+    unregisterNotification(method: string): void;
+    /**
+     * Set client capabilities (from initialize request)
+     */
+    setClientCapabilities(capabilities: ClientCapabilities): void;
+    /**
+     * Dispatch an incoming message
+     */
+    dispatch(message: Message, transport: Transport, cancellationTokens: Map<number | string, AbortController>): Promise<void>;
+    private dispatchRequest;
+    private dispatchNotification;
+    private sendError;
+    /**
+     * Cancel a pending request
+     */
+    cancelRequest(id: number | string): void;
+    /**
+     * Clear all handlers
+     */
+    clear(): void;
+}
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../src/dispatcher.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,OAAO,EAGP,SAAS,EAET,MAAM,EACN,kBAAkB,EACnB,MAAM,eAAe,CAAC;AAGvB,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EAGpB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,iBAAiB;IAUhB,OAAO,CAAC,QAAQ,CAAC,MAAM;IATnC,OAAO,CAAC,eAAe,CAInB;IACJ,OAAO,CAAC,oBAAoB,CAA+D;IAC3F,OAAO,CAAC,eAAe,CAA+C;IACtE,OAAO,CAAC,kBAAkB,CAAC,CAAqB;IAEhD,YAA6B,MAAM,EAAE,MAAM,EAAI;IAE/C;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAG7F;IAED;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,CAAC,MAAM,CAAC,GAAG,IAAI,CAGvF;IAED;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAGtC;IAED;;OAEG;IACH,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAG3C;IAED;;OAEG;IACH,qBAAqB,CAAC,YAAY,EAAE,kBAAkB,GAAG,IAAI,CAE5D;IAED;;OAEG;IACG,QAAQ,CACZ,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,SAAS,EACpB,kBAAkB,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,eAAe,CAAC,GACxD,OAAO,CAAC,IAAI,CAAC,CAMf;YAKa,eAAe;YA8Df,oBAAoB;YAuBpB,SAAS;IAgBvB;;OAEG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOvC;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAIZ;CACF"}

package/dist/dispatcher.js

@@ -0,0 +1,174 @@
+/**
+ * Message dispatcher - routes incoming requests to registered handlers
+ */
+import { ResponseError, isRequestMessage, isNotificationMessage } from '@lspeasy/core';
+import { HandlerRegistry } from '@lspeasy/core/utils';
+/**
+ * Message dispatcher manages request/notification routing
+ */
+export class MessageDispatcher {
+    logger;
+    requestHandlers = new HandlerRegistry();
+    notificationHandlers = new HandlerRegistry();
+    pendingRequests = new Map();
+    clientCapabilities;
+    constructor(logger) {
+        this.logger = logger;
+    }
+    /**
+     * Register a request handler
+     */
+    registerRequest(method, handler) {
+        this.requestHandlers.register(method, handler);
+        this.logger.debug(`Registered request handler: ${method}`);
+    }
+    /**
+     * Register a notification handler
+     */
+    registerNotification(method, handler) {
+        this.notificationHandlers.register(method, handler);
+        this.logger.debug(`Registered notification handler: ${method}`);
+    }
+    /**
+     * Unregister a request handler
+     */
+    unregisterRequest(method) {
+        this.requestHandlers.unregister(method);
+        this.logger.debug(`Unregistered request handler: ${method}`);
+    }
+    /**
+     * Unregister a notification handler
+     */
+    unregisterNotification(method) {
+        this.notificationHandlers.unregister(method);
+        this.logger.debug(`Unregistered notification handler: ${method}`);
+    }
+    /**
+     * Set client capabilities (from initialize request)
+     */
+    setClientCapabilities(capabilities) {
+        this.clientCapabilities = capabilities;
+    }
+    /**
+     * Dispatch an incoming message
+     */
+    async dispatch(message, transport, cancellationTokens) {
+        if (isRequestMessage(message)) {
+            await this.dispatchRequest(message, transport, cancellationTokens);
+        }
+        else if (isNotificationMessage(message)) {
+            await this.dispatchNotification(message);
+        }
+    }
+    /**
+     * Dispatch a request message
+     */
+    async dispatchRequest(request, transport, cancellationTokens) {
+        const { id, method, params } = request;
+        try {
+            // Check if handler exists
+            const handler = this.requestHandlers.get(method);
+            if (!handler) {
+                await this.sendError(transport, id, ResponseError.methodNotFound(method));
+                return;
+            }
+            // Create cancellation token for this request
+            const abortController = new AbortController();
+            cancellationTokens.set(id, abortController);
+            const cancellationToken = {
+                get isCancellationRequested() {
+                    return abortController.signal.aborted;
+                },
+                onCancellationRequested: (listener) => {
+                    abortController.signal.addEventListener('abort', listener);
+                    return { dispose: () => abortController.signal.removeEventListener('abort', listener) };
+                }
+            };
+            // Execute handler
+            const result = await handler(params, cancellationToken, {
+                id,
+                method,
+                clientCapabilities: this.clientCapabilities
+            });
+            // Send success response
+            // Normalize undefined → null per JSON-RPC 2.0 spec:
+            // a response MUST contain either "result" or "error" — omitting
+            // "result" (which happens when JSON.stringify drops undefined)
+            // produces an invalid message the client can never resolve.
+            await transport.send({
+                jsonrpc: '2.0',
+                id,
+                result: result ?? null
+            });
+        }
+        catch (error) {
+            // Send error response
+            if (error instanceof ResponseError) {
+                await this.sendError(transport, id, error);
+            }
+            else {
+                const message = error instanceof Error ? error.message : 'Internal error';
+                await this.sendError(transport, id, ResponseError.internalError(message, { error }));
+            }
+        }
+        finally {
+            cancellationTokens.delete(id);
+        }
+    }
+    /**
+     * Dispatch a notification message
+     */
+    async dispatchNotification(notification) {
+        const { method, params } = notification;
+        try {
+            const handler = this.notificationHandlers.get(method);
+            if (!handler) {
+                this.logger.debug(`No handler for notification: ${method}`);
+                return;
+            }
+            await handler(params, {
+                method,
+                clientCapabilities: this.clientCapabilities
+            });
+        }
+        catch (error) {
+            // Notifications don't send error responses, just log
+            this.logger.error(`Error in notification handler ${method}:`, error);
+        }
+    }
+    /**
+     * Send error response
+     */
+    async sendError(transport, id, error) {
+        try {
+            await transport.send({
+                jsonrpc: '2.0',
+                id,
+                error: error.toJSON()
+            });
+        }
+        catch (sendError) {
+            this.logger.error('Failed to send error response:', sendError);
+        }
+    }
+    /**
+     * Cancel a pending request
+     */
+    cancelRequest(id) {
+        const controller = this.pendingRequests.get(id);
+        if (controller) {
+            controller.abort();
+            this.pendingRequests.delete(id);
+            this.logger.debug(`Cancelled request ${id}`);
+        }
+    }
+    /**
+     * Clear all handlers
+     */
+    clear() {
+        this.requestHandlers.clear();
+        this.notificationHandlers.clear();
+        this.pendingRequests.clear();
+    }
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/dispatcher.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @lspeasy/server - Build LSP servers with simple, typed API
+ */
+export { LSPServer } from './server.js';
+export type { ServerOptions, RequestHandler, NotificationHandler, RequestContext, NotificationContext, Server } from './types.js';
+export { ServerState } from './types.js';
+export { MessageDispatcher } from './dispatcher.js';
+export type { Transport, CancellationToken, Logger, ServerCapabilities, ClientCapabilities, InitializeParams, InitializeResult, HoverParams, Hover, CompletionParams, CompletionList, CompletionItem, DefinitionParams, Definition, LSPRequestMethod, LSPNotificationMethod, ParamsForRequest, ResultForRequest, ParamsForNotification } from '@lspeasy/core';
+export { ResponseError, JSONRPCErrorCode, StdioTransport, ConsoleLogger, LogLevel } from '@lspeasy/core';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,YAAY,EACV,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,MAAM,EACP,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,MAAM,EACN,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,KAAK,EACL,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,UAAU,EAEV,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,QAAQ,EACT,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * @lspeasy/server - Build LSP servers with simple, typed API
+ */
+// Main server class
+export { LSPServer } from './server.js';
+export { ServerState } from './types.js';
+// Internal exports for testing
+export { MessageDispatcher } from './dispatcher.js';
+export { ResponseError, JSONRPCErrorCode, StdioTransport, ConsoleLogger, LogLevel } from '@lspeasy/core';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oBAAoB;AACpB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAYxC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,+BAA+B;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AA0BpD,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,QAAQ,EACT,MAAM,eAAe,CAAC"}

package/dist/lifecycle.d.ts

@@ -0,0 +1,39 @@
+/**
+ * LSP lifecycle management - initialize/initialized handshake
+ */
+import type { Transport, InitializeParams, InitializeResult, InitializedParams, ServerCapabilities, Logger } from '@lspeasy/core';
+/**
+ * Manages LSP server lifecycle (initialize/initialized/shutdown/exit)
+ */
+export declare class LifecycleManager {
+    private readonly name;
+    private readonly version;
+    private readonly logger;
+    private serverCapabilities;
+    constructor(name: string, version: string, logger: Logger);
+    /**
+     * Set server capabilities
+     */
+    setCapabilities(capabilities: ServerCapabilities): void;
+    /**
+     * Get current capabilities
+     */
+    getCapabilities(): ServerCapabilities;
+    /**
+     * Handle initialize request
+     */
+    handleInitialize(params: InitializeParams, _transport: Transport, _id: number | string): Promise<InitializeResult>;
+    /**
+     * Handle initialized notification
+     */
+    handleInitialized(params: InitializedParams): void;
+    /**
+     * Handle shutdown request
+     */
+    handleShutdown(_transport: Transport, _id: number | string): Promise<void>;
+    /**
+     * Handle exit notification
+     */
+    handleExit(): void;
+}
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,MAAM,EACP,MAAM,eAAe,CAAC;AAEvB;;GAEG;AACH,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,OAAO,CAAC,kBAAkB,CAA0B;IAEpD,YACmB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EAC7B;IAEJ;;OAEG;IACH,eAAe,CAAC,YAAY,EAAE,kBAAkB,GAAG,IAAI,CAEtD;IAED;;OAEG;IACH,eAAe,IAAI,kBAAkB,CAEpC;IAED;;OAEG;IACG,gBAAgB,CACpB,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,SAAS,EACrB,GAAG,EAAE,MAAM,GAAG,MAAM,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAc3B;IAED;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAGjD;IAED;;OAEG;IACG,cAAc,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/E;IAED;;OAEG;IACH,UAAU,IAAI,IAAI,CAEjB;CACF"}

package/dist/lifecycle.js

@@ -0,0 +1,66 @@
+/**
+ * LSP lifecycle management - initialize/initialized handshake
+ */
+/**
+ * Manages LSP server lifecycle (initialize/initialized/shutdown/exit)
+ */
+export class LifecycleManager {
+    name;
+    version;
+    logger;
+    serverCapabilities = {};
+    constructor(name, version, logger) {
+        this.name = name;
+        this.version = version;
+        this.logger = logger;
+    }
+    /**
+     * Set server capabilities
+     */
+    setCapabilities(capabilities) {
+        this.serverCapabilities = capabilities;
+    }
+    /**
+     * Get current capabilities
+     */
+    getCapabilities() {
+        return this.serverCapabilities;
+    }
+    /**
+     * Handle initialize request
+     */
+    async handleInitialize(params, _transport, _id) {
+        this.logger.info('Initializing server...');
+        this.logger.debug('Initialize params:', params);
+        const result = {
+            capabilities: this.serverCapabilities,
+            serverInfo: {
+                name: this.name,
+                version: this.version
+            }
+        };
+        this.logger.info('Server initialized');
+        return result;
+    }
+    /**
+     * Handle initialized notification
+     */
+    handleInitialized(params) {
+        this.logger.info('Client sent initialized notification');
+        this.logger.debug('Initialized params:', params);
+    }
+    /**
+     * Handle shutdown request
+     */
+    async handleShutdown(_transport, _id) {
+        this.logger.info('Shutting down server...');
+        this.logger.info('Server shutdown complete');
+    }
+    /**
+     * Handle exit notification
+     */
+    handleExit() {
+        this.logger.info('Server exit');
+    }
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAIR,IAAI;IACJ,OAAO;IACP,MAAM;IALjB,kBAAkB,GAAuB,EAAE,CAAC;IAEpD,YACmB,IAAY,EACZ,OAAe,EACf,MAAc,EAC/B;oBAHiB,IAAI;uBACJ,OAAO;sBACP,MAAM;IACtB,CAAC;IAEJ;;OAEG;IACH,eAAe,CAAC,YAAgC,EAAQ;QACtD,IAAI,CAAC,kBAAkB,GAAG,YAAY,CAAC;IAAA,CACxC;IAED;;OAEG;IACH,eAAe,GAAuB;QACpC,OAAO,IAAI,CAAC,kBAAkB,CAAC;IAAA,CAChC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CACpB,MAAwB,EACxB,UAAqB,EACrB,GAAoB,EACO;QAC3B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;QAEhD,MAAM,MAAM,GAAqB;YAC/B,YAAY,EAAE,IAAI,CAAC,kBAAkB;YACrC,UAAU,EAAE;gBACV,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB;SACF,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACvC,OAAO,MAAM,CAAC;IAAA,CACf;IAED;;OAEG;IACH,iBAAiB,CAAC,MAAyB,EAAQ;QACjD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IAAA,CAClD;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,UAAqB,EAAE,GAAoB,EAAiB;QAC/E,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAAA,CAC9C;IAED;;OAEG;IACH,UAAU,GAAS;QACjB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAAA,CACjC;CACF"}

package/dist/progress.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Progress reporting support for LSP servers
+ *
+ * @module server/progress
+ */
+import type { ProgressToken } from 'vscode-languageserver-protocol';
+import { createProgressToken } from '@lspeasy/core';
+/**
+ * Progress reporter for work done progress
+ */
+export interface ProgressReporter {
+    /**
+     * Begin progress reporting
+     */
+    begin(title: string, cancellable?: boolean, message?: string, percentage?: number): Promise<void>;
+    /**
+     * Report progress
+     */
+    report(message?: string, percentage?: number): Promise<void>;
+    /**
+     * End progress reporting
+     */
+    end(message?: string): Promise<void>;
+}
+/**
+ * Internal interface for sending progress notifications
+ */
+interface ProgressSender {
+    sendNotification(method: string, params: unknown): Promise<void>;
+}
+/**
+ * Create a progress reporter for a given token
+ * @internal
+ */
+export declare function createProgressReporter(token: ProgressToken, sender: ProgressSender): ProgressReporter;
+/**
+ * Generate a unique progress token
+ */
+export { createProgressToken };
+//# sourceMappingURL=progress.d.ts.map

package/dist/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../src/progress.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAIL,mBAAmB,EACpB,MAAM,eAAe,CAAC;AAEvB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElG;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7D;;OAEG;IACH,GAAG,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,UAAU,cAAc;IACtB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE;AAyCD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,cAAc,GACrB,gBAAgB,CAElB;AAED;;GAEG;AACH,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/progress.js

@@ -0,0 +1,50 @@
+/**
+ * Progress reporting support for LSP servers
+ *
+ * @module server/progress
+ */
+import { createProgressBegin, createProgressReport, createProgressEnd, createProgressToken } from '@lspeasy/core';
+/**
+ * Implementation of ProgressReporter
+ */
+class ProgressReporterImpl {
+    token;
+    sender;
+    constructor(token, sender) {
+        this.token = token;
+        this.sender = sender;
+    }
+    async begin(title, cancellable, message, percentage) {
+        const value = createProgressBegin(title, cancellable, message, percentage);
+        await this.sender.sendNotification('$/progress', {
+            token: this.token,
+            value
+        });
+    }
+    async report(message, percentage) {
+        const value = createProgressReport(message, percentage);
+        await this.sender.sendNotification('$/progress', {
+            token: this.token,
+            value
+        });
+    }
+    async end(message) {
+        const value = createProgressEnd(message);
+        await this.sender.sendNotification('$/progress', {
+            token: this.token,
+            value
+        });
+    }
+}
+/**
+ * Create a progress reporter for a given token
+ * @internal
+ */
+export function createProgressReporter(token, sender) {
+    return new ProgressReporterImpl(token, sender);
+}
+/**
+ * Generate a unique progress token
+ */
+export { createProgressToken };
+//# sourceMappingURL=progress.js.map

package/dist/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../src/progress.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,eAAe,CAAC;AA6BvB;;GAEG;AACH,MAAM,oBAAoB;IAEd,KAAK;IACL,MAAM;IAFhB,YACU,KAAoB,EACpB,MAAsB,EAC9B;qBAFQ,KAAK;sBACL,MAAM;IACb,CAAC;IAEJ,KAAK,CAAC,KAAK,CACT,KAAa,EACb,WAAqB,EACrB,OAAgB,EAChB,UAAmB,EACJ;QACf,MAAM,KAAK,GAAG,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QAC3E,MAAM,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,YAAY,EAAE;YAC/C,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK;SACN,CAAC,CAAC;IAAA,CACJ;IAED,KAAK,CAAC,MAAM,CAAC,OAAgB,EAAE,UAAmB,EAAiB;QACjE,MAAM,KAAK,GAAG,oBAAoB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACxD,MAAM,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,YAAY,EAAE;YAC/C,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK;SACN,CAAC,CAAC;IAAA,CACJ;IAED,KAAK,CAAC,GAAG,CAAC,OAAgB,EAAiB;QACzC,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,YAAY,EAAE;YAC/C,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK;SACN,CAAC,CAAC;IAAA,CACJ;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAoB,EACpB,MAAsB,EACJ;IAClB,OAAO,IAAI,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAAA,CAChD;AAED;;GAEG;AACH,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,176 @@
+/**
+ * LSP Server - Main server class for handling LSP connections
+ */
+import type { Transport, Disposable, ServerCapabilities, ClientCapabilities, LSPRequestMethod, LSPNotificationMethod, ParamsForRequest, ResultForRequest, ParamsForNotification, Server } from '@lspeasy/core';
+import type { ServerOptions, RequestHandler, NotificationHandler } from './types.js';
+import { ServerState } from './types.js';
+/**
+ * LSP Server class with dynamic capability-aware typing
+ *
+ * This class dynamically provides handler registration and send methods based on capabilities.
+ * Methods are type-safe and conditionally available based on the Capabilities type parameter.
+ *
+ * @template Capabilities - Server capabilities (defaults to ServerCapabilities)
+ *
+ * @example
+ * // Create a server with specific capabilities
+ * type MyCaps = { hoverProvider: true; completionProvider: { triggerCharacters: ['.'] } };
+ * const server = new LSPServer<MyCaps>();
+ * server.setCapabilities({ hoverProvider: true, completionProvider: { triggerCharacters: ['.'] } });
+ * // server.textDocument.onHover is available for registration
+ * // server.textDocument.onCompletion is available for registration
+ */
+export declare class BaseLSPServer<Capabilities extends Partial<ServerCapabilities> = ServerCapabilities> {
+    private readonly logger;
+    private readonly middlewareRegistrations;
+    private readonly dispatcher;
+    private readonly lifecycleManager;
+    private readonly name;
+    private readonly version;
+    private readonly options;
+    private capabilityGuard?;
+    private clientCapabilityGuard?;
+    private events;
+    private transportAttachment;
+    private pendingRequests;
+    private transport?;
+    private state;
+    private cancellationTokens;
+    private clientCapabilities?;
+    private clientInfo?;
+    constructor(options?: ServerOptions<Capabilities>);
+    /**
+     * Register a request handler with automatic type inference
+     *
+     * @example
+     * // Type parameters are automatically inferred from method name
+     * server.onRequest('textDocument/hover', async (params) => {
+     *   // params is automatically typed as HoverParams
+     *   return { contents: 'Hover text' };
+     * });
+     */
+    onRequest<Method extends LSPRequestMethod & string>(method: Method, handler: RequestHandler<ParamsForRequest<Method>, ResultForRequest<Method>>): Disposable;
+    /**
+     * Register a request handler with explicit type parameters (backwards compatible)
+     */
+    onRequest<Method extends string, Params = unknown, Result = unknown>(method: Method, handler: RequestHandler<Params, Result>): Disposable;
+    /**
+     * Register a notification handler with automatic type inference
+     *
+     * @example
+     * // Type parameters are automatically inferred from method name
+     * server.onNotification('textDocument/didOpen', (params) => {
+     *   // params is automatically typed as DidOpenTextDocumentParams
+     * });
+     */
+    onNotification<Method extends LSPNotificationMethod & string>(method: Method, handler: NotificationHandler<ParamsForNotification<Method>>): Disposable;
+    /**
+     * Register a notification handler with explicit type parameters (backwards compatible)
+     */
+    onNotification<Method extends string, Params = unknown>(method: Method, handler: NotificationHandler<Params>): Disposable;
+    /**
+     * Set server capabilities
+     */
+    setCapabilities(capabilities: Capabilities): void;
+    /**
+     * Get server capabilities
+     */
+    getServerCapabilities(): ServerCapabilities;
+    /**
+     * Get client capabilities (available after initialization)
+     */
+    getClientCapabilities(): ClientCapabilities | undefined;
+    /**
+     * Register a single 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.
+     *
+     * @template K - The capability key to register
+     * @param key - The server capability key (e.g. 'hoverProvider')
+     * @param value - The capability value
+     * @returns The same server instance with an expanded capability type
+     *
+     * @example
+     * const server = new LSPServer();
+     * const withHover = server.registerCapability('hoverProvider', true);
+     * // withHover is typed as LSPServer<Capabilities & Pick<ServerCapabilities, 'hoverProvider'>>
+     */
+    registerCapability<K extends keyof ServerCapabilities>(key: K, value: ServerCapabilities[K]): LSPServer<Capabilities & Pick<ServerCapabilities, K>>;
+    /**
+     * Zero-cost type narrowing for client capabilities.
+     * Returns `this` cast to include capability-aware send methods for the given ClientCaps.
+     *
+     * @template C - The expected client capabilities shape
+     * @returns The same server instance, typed with capability-aware methods
+     *
+     * @example
+     * const server = new LSPServer<MyCaps>();
+     * const typed = server.expect<MyClientCaps>();
+     * // typed now has send methods gated by MyClientCaps
+     */
+    expect<C extends Partial<ClientCapabilities>>(): this & Server<C, Capabilities>;
+    /**
+     * Send a server-to-client request.
+     */
+    sendRequest<Method extends LSPRequestMethod<'serverToClient'>>(method: Method, params?: ParamsForRequest<Method>): Promise<ResultForRequest<Method>>;
+    /**
+     * Send a server-to-client notification.
+     */
+    sendNotification<Method extends LSPNotificationMethod<'serverToClient'>>(method: Method, params?: ParamsForNotification<Method>): Promise<void>;
+    /**
+     * Start listening on a transport
+     */
+    listen(transport: Transport): Promise<void>;
+    /**
+     * Graceful shutdown
+     */
+    shutdown(timeout?: number): Promise<void>;
+    /**
+     * Force close
+     */
+    close(): Promise<void>;
+    /**
+     * Check if server is listening and initialized
+     */
+    isListening(): boolean;
+    /**
+     * Get current server state
+     */
+    getState(): ServerState;
+    /**
+     * Get client info (available after initialization)
+     */
+    getClientInfo(): {
+        name: string;
+        version?: string;
+    } | undefined;
+    /**
+     * Subscribe to listening events
+     */
+    onListening(handler: () => void): Disposable;
+    /**
+     * Subscribe to shutdown events
+     */
+    onShutdown(handler: () => void): Disposable;
+    /**
+     * Subscribe to error events
+     */
+    onError(handler: (error: Error) => void): Disposable;
+    /**
+     * Register built-in lifecycle handlers
+     */
+    private registerBuiltinHandlers;
+    private handleMessage;
+    private getMessageType;
+    private getMessageMethod;
+    private resolveShortCircuitRequest;
+    private buildMiddlewareContext;
+    private sendWithMiddleware;
+    /**
+     * Handle response messages for server-initiated requests.
+     */
+    private handleResponse;
+}
+export type LSPServer<ServerCaps extends Partial<ServerCapabilities> = ServerCapabilities> = BaseLSPServer<ServerCaps> & Server<ClientCapabilities, ServerCaps>;
+export declare const LSPServer: new <ServerCaps extends Partial<ServerCapabilities> = ServerCapabilities>(options?: ServerOptions<ServerCaps>) => LSPServer<ServerCaps>;
+//# sourceMappingURL=server.d.ts.map