apex-code 0.0.1-alpha.4 → 0.0.1-alpha.6

package/dist/core/lsp/client.d.ts

@@ -0,0 +1,76 @@
+export declare const LSP_MAX_HEADER_BYTES: number;
+export declare const LSP_MAX_MESSAGE_BYTES: number;
+export declare const LSP_MAX_STDERR_TAIL_BYTES: number;
+export interface LspClientOptions {
+    readonly command: string;
+    readonly args?: readonly string[];
+    readonly cwd: string;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly initializationTimeoutMs?: number;
+    readonly requestTimeoutMs?: number;
+}
+export interface LspNotification {
+    readonly method: string;
+    readonly params?: unknown;
+}
+export type LspTextDocumentSyncKind = "none" | "full" | "incremental";
+export interface LspTextDocumentSync {
+    readonly kind: LspTextDocumentSyncKind;
+    readonly openClose: boolean;
+    readonly save: boolean;
+    readonly saveIncludeText: boolean;
+}
+export declare class LspJsonRpcError extends Error {
+    readonly code: number;
+    readonly data?: unknown;
+    constructor(error: {
+        code: number;
+        message: string;
+        data?: unknown;
+    });
+}
+/** A bounded JSON-RPC 2.0 client for one language server's stdio. */
+export declare class LspClient {
+    private readonly options;
+    private child;
+    private stdin;
+    private stdout;
+    private input;
+    private stderrTail;
+    private nextRequestId;
+    private readonly pending;
+    private readonly notificationListeners;
+    private readonly failureListeners;
+    private startPromise;
+    private disposePromise;
+    private state;
+    private failure;
+    private writeChain;
+    private syncCapabilities;
+    constructor(options: LspClientOptions);
+    get capturedStderr(): string;
+    /** Text-document synchronization negotiated during initialization. */
+    get textDocumentSync(): LspTextDocumentSync;
+    onNotification(listener: (notification: LspNotification) => void): () => void;
+    /** Subscribe to the first terminal protocol or process failure. */
+    onFailure(listener: (error: Error) => void): () => void;
+    start(): Promise<void>;
+    request(method: string, params?: unknown, signal?: AbortSignal): Promise<unknown>;
+    notify(method: string, params?: unknown): void;
+    dispose(): Promise<void>;
+    private initializationTimeoutMs;
+    private requestTimeoutMs;
+    private initialize;
+    private disposeProcess;
+    private terminateChild;
+    private sendRequest;
+    private enqueueWrite;
+    private writeFrame;
+    private onData;
+    private onMessage;
+    private handleServerRequest;
+    private captureStderr;
+    private rejectPending;
+    private fail;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/core/lsp/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/core/lsp/client.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ChildProcess } from \"node:child_process\";\nimport type { Readable, Writable } from \"node:stream\";\nimport { pathToFileURL } from \"node:url\";\nimport { spawnProcess } from \"../../utils/child-process.ts\";\n\nexport const LSP_MAX_HEADER_BYTES = 8 * 1024;\nexport const LSP_MAX_MESSAGE_BYTES = 8 * 1024 * 1024;\nexport const LSP_MAX_STDERR_TAIL_BYTES = 64 * 1024;\n\nconst DEFAULT_INITIALIZATION_TIMEOUT_MS = 10_000;\nconst DEFAULT_REQUEST_TIMEOUT_MS = 10_000;\nconst SHUTDOWN_TIMEOUT_MS = 2_000;\nconst TERMINATE_GRACE_MS = 500;\nconst KILL_GRACE_MS = 1_000;\n\nexport interface LspClientOptions {\n\treadonly command: string;\n\treadonly args?: readonly string[];\n\treadonly cwd: string;\n\treadonly env?: NodeJS.ProcessEnv;\n\treadonly initializationTimeoutMs?: number;\n\treadonly requestTimeoutMs?: number;\n}\n\nexport interface LspNotification {\n\treadonly method: string;\n\treadonly params?: unknown;\n}\n\nexport type LspTextDocumentSyncKind = \"none\" | \"full\" | \"incremental\";\n\nexport interface LspTextDocumentSync {\n\treadonly kind: LspTextDocumentSyncKind;\n\treadonly openClose: boolean;\n\treadonly save: boolean;\n\treadonly saveIncludeText: boolean;\n}\n\nexport class LspJsonRpcError extends Error {\n\treadonly code: number;\n\treadonly data?: unknown;\n\n\tconstructor(error: { code: number; message: string; data?: unknown }) {\n\t\tsuper(error.message);\n\t\tthis.name = \"LspJsonRpcError\";\n\t\tthis.code = error.code;\n\t\tthis.data = error.data;\n\t}\n}\n\ntype JsonRpcId = number;\ntype PendingRequest = {\n\tresolve(value: unknown): void;\n\treject(reason: Error): void;\n};\n\ntype ClientState = \"idle\" | \"starting\" | \"ready\" | \"closing\" | \"closed\" | \"failed\";\n\ntype JsonRpcMessage = Record<string, unknown>;\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isJsonRpcId(value: unknown): value is string | number {\n\treturn typeof value === \"string\" || (typeof value === \"number\" && Number.isSafeInteger(value));\n}\n\nfunction normalizeError(error: unknown): Error {\n\treturn error instanceof Error ? error : new Error(String(error));\n}\n\nfunction parseTextDocumentSync(value: unknown): LspTextDocumentSync {\n\tlet kind: LspTextDocumentSyncKind = \"none\";\n\tlet openClose = false;\n\tlet save = false;\n\tlet saveIncludeText = false;\n\tif (typeof value === \"number\") {\n\t\tkind = value === 1 ? \"full\" : value === 2 ? \"incremental\" : \"none\";\n\t} else if (isRecord(value)) {\n\t\topenClose = value.openClose === true;\n\t\tkind = value.change === 1 ? \"full\" : value.change === 2 ? \"incremental\" : \"none\";\n\t\tif (value.save === true) save = true;\n\t\telse if (isRecord(value.save)) {\n\t\t\tsave = true;\n\t\t\tsaveIncludeText = value.save.includeText === true;\n\t\t}\n\t}\n\treturn { kind, openClose, save, saveIncludeText };\n}\n\nfunction validateTimeout(value: number | undefined, fallback: number, label: string): number {\n\tconst timeout = value ?? fallback;\n\tif (!Number.isSafeInteger(timeout) || timeout < 1) throw new Error(`${label} must be a positive safe integer.`);\n\treturn timeout;\n}\n\nfunction delay(ms: number): Promise<void> {\n\treturn new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/** A bounded JSON-RPC 2.0 client for one language server's stdio. */\nexport class LspClient {\n\tprivate readonly options: LspClientOptions;\n\tprivate child: ChildProcess | undefined;\n\tprivate stdin: Writable | undefined;\n\tprivate stdout: Readable | undefined;\n\tprivate input = Buffer.alloc(0);\n\tprivate stderrTail = Buffer.alloc(0);\n\tprivate nextRequestId = 1;\n\tprivate readonly pending = new Map<JsonRpcId, PendingRequest>();\n\tprivate readonly notificationListeners = new Set<(notification: LspNotification) => void>();\n\tprivate readonly failureListeners = new Set<(error: Error) => void>();\n\tprivate startPromise: Promise<void> | undefined;\n\tprivate disposePromise: Promise<void> | undefined;\n\tprivate state: ClientState = \"idle\";\n\tprivate failure: Error | undefined;\n\tprivate writeChain: Promise<void> = Promise.resolve();\n\tprivate syncCapabilities: LspTextDocumentSync = {\n\t\tkind: \"none\",\n\t\topenClose: false,\n\t\tsave: false,\n\t\tsaveIncludeText: false,\n\t};\n\n\tconstructor(options: LspClientOptions) {\n\t\tthis.options = options;\n\t}\n\n\tget capturedStderr(): string {\n\t\treturn this.stderrTail.toString(\"utf8\");\n\t}\n\n\t/** Text-document synchronization negotiated during initialization. */\n\tget textDocumentSync(): LspTextDocumentSync {\n\t\treturn this.syncCapabilities;\n\t}\n\n\tonNotification(listener: (notification: LspNotification) => void): () => void {\n\t\tthis.notificationListeners.add(listener);\n\t\treturn () => this.notificationListeners.delete(listener);\n\t}\n\n\t/** Subscribe to the first terminal protocol or process failure. */\n\tonFailure(listener: (error: Error) => void): () => void {\n\t\tthis.failureListeners.add(listener);\n\t\tif (this.failure) listener(this.failure);\n\t\treturn () => this.failureListeners.delete(listener);\n\t}\n\n\tstart(): Promise<void> {\n\t\tif (this.failure) return Promise.reject(this.failure);\n\t\tif (this.state === \"closing\" || this.state === \"closed\") {\n\t\t\treturn Promise.reject(new Error(\"Language server client is disposed.\"));\n\t\t}\n\t\tif (!this.startPromise) {\n\t\t\tthis.state = \"starting\";\n\t\t\tthis.startPromise = this.initialize().catch(async (error) => {\n\t\t\t\tconst failure = normalizeError(error);\n\t\t\t\tthis.fail(failure);\n\t\t\t\tawait this.terminateChild();\n\t\t\t\tthrow failure;\n\t\t\t});\n\t\t}\n\t\treturn this.startPromise;\n\t}\n\n\tasync request(method: string, params?: unknown, signal?: AbortSignal): Promise<unknown> {\n\t\tawait this.start();\n\t\tif (this.state !== \"ready\") throw this.failure ?? new Error(\"Language server did not become ready.\");\n\t\treturn this.sendRequest(method, params, signal, this.requestTimeoutMs());\n\t}\n\n\tnotify(method: string, params?: unknown): void {\n\t\tif (this.failure) throw this.failure;\n\t\tif (this.state !== \"ready\") throw new Error(\"Language server is not ready.\");\n\t\tvoid this.enqueueWrite({ jsonrpc: \"2.0\", method, ...(params === undefined ? {} : { params }) }).catch((error) => {\n\t\t\tthis.fail(normalizeError(error));\n\t\t});\n\t}\n\n\tdispose(): Promise<void> {\n\t\tif (!this.disposePromise) this.disposePromise = this.disposeProcess();\n\t\treturn this.disposePromise;\n\t}\n\n\tprivate initializationTimeoutMs(): number {\n\t\treturn validateTimeout(\n\t\t\tthis.options.initializationTimeoutMs,\n\t\t\tDEFAULT_INITIALIZATION_TIMEOUT_MS,\n\t\t\t\"initializationTimeoutMs\",\n\t\t);\n\t}\n\n\tprivate requestTimeoutMs(): number {\n\t\treturn validateTimeout(this.options.requestTimeoutMs, DEFAULT_REQUEST_TIMEOUT_MS, \"requestTimeoutMs\");\n\t}\n\n\tprivate async initialize(): Promise<void> {\n\t\tconst child = spawnProcess(this.options.command, [...(this.options.args ?? [])], {\n\t\t\tcwd: this.options.cwd,\n\t\t\tenv: this.options.env,\n\t\t\tstdio: [\"pipe\", \"pipe\", \"pipe\"],\n\t\t});\n\t\tif (!child.stdin || !child.stdout) {\n\t\t\tchild.kill();\n\t\t\tthrow new Error(\"Language server must expose piped stdin and stdout.\");\n\t\t}\n\t\tthis.child = child;\n\t\tthis.stdin = child.stdin;\n\t\tthis.stdout = child.stdout;\n\t\tthis.stdout.on(\"data\", (chunk: Buffer | string) => this.onData(chunk));\n\t\tchild.stderr?.on(\"data\", (chunk: Buffer | string) => this.captureStderr(chunk));\n\t\tchild.stdin.on(\"error\", (error) => this.fail(error));\n\t\tchild.once(\"error\", (error) => this.fail(error));\n\t\tchild.once(\"exit\", (code, signal) => {\n\t\t\tif (this.state !== \"closing\" && this.state !== \"closed\") {\n\t\t\t\tthis.fail(new Error(`Language server exited before shutdown (code=${code} signal=${signal}).`));\n\t\t\t}\n\t\t});\n\n\t\tconst initializeResult = await this.sendRequest(\n\t\t\t\"initialize\",\n\t\t\t{\n\t\t\t\tprocessId: process.pid,\n\t\t\t\tclientInfo: { name: \"Apex Code\" },\n\t\t\t\trootUri: pathToFileURL(this.options.cwd).href,\n\t\t\t\tcapabilities: {\n\t\t\t\t\tgeneral: { positionEncodings: [\"utf-16\"] },\n\t\t\t\t\tworkspace: { workspaceFolders: false },\n\t\t\t\t\ttextDocument: {\n\t\t\t\t\t\tdefinition: {},\n\t\t\t\t\t\treferences: {},\n\t\t\t\t\t\tdocumentSymbol: {},\n\t\t\t\t\t\tpublishDiagnostics: { versionSupport: true },\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\tworkspaceFolders: null,\n\t\t\t},\n\t\t\tundefined,\n\t\t\tthis.initializationTimeoutMs(),\n\t\t\t\"Language server initialize timed out\",\n\t\t);\n\t\tif (!isRecord(initializeResult) || !isRecord(initializeResult.capabilities)) {\n\t\t\tthrow new Error(\"Language server returned an invalid initialize result.\");\n\t\t}\n\t\tthis.syncCapabilities = parseTextDocumentSync(initializeResult.capabilities.textDocumentSync);\n\t\tif (this.state !== \"starting\") throw new Error(\"Language server initialization was interrupted.\");\n\t\tawait this.enqueueWrite({ jsonrpc: \"2.0\", method: \"initialized\", params: {} });\n\t\tthis.state = \"ready\";\n\t}\n\n\tprivate async disposeProcess(): Promise<void> {\n\t\tif (this.state === \"closed\") return;\n\t\tconst wasReady = this.state === \"ready\";\n\t\tthis.state = \"closing\";\n\t\tthis.rejectPending(new Error(\"Language server client is closing.\"));\n\n\t\tif (wasReady) {\n\t\t\ttry {\n\t\t\t\tawait this.sendRequest(\n\t\t\t\t\t\"shutdown\",\n\t\t\t\t\tundefined,\n\t\t\t\t\tundefined,\n\t\t\t\t\tSHUTDOWN_TIMEOUT_MS,\n\t\t\t\t\t\"Language server shutdown timed out\",\n\t\t\t\t\ttrue,\n\t\t\t\t);\n\t\t\t\tawait this.enqueueWrite({ jsonrpc: \"2.0\", method: \"exit\" });\n\t\t\t} catch {\n\t\t\t\t// Bounded termination below is the fallback for an uncooperative server.\n\t\t\t}\n\t\t}\n\t\tawait this.terminateChild();\n\t\tthis.stdin?.end();\n\t\tthis.state = \"closed\";\n\t}\n\n\tprivate async terminateChild(): Promise<void> {\n\t\tconst child = this.child;\n\t\tif (!child || child.exitCode !== null || child.signalCode !== null) return;\n\t\tconst exited = new Promise<void>((resolve) => child.once(\"exit\", () => resolve()));\n\t\tconst graceful = await Promise.race([exited.then(() => true), delay(TERMINATE_GRACE_MS).then(() => false)]);\n\t\tif (graceful) return;\n\t\tchild.kill(\"SIGTERM\");\n\t\tconst terminated = await Promise.race([exited.then(() => true), delay(KILL_GRACE_MS).then(() => false)]);\n\t\tif (terminated) return;\n\t\tchild.kill(\"SIGKILL\");\n\t\tawait exited;\n\t}\n\n\tprivate sendRequest(\n\t\tmethod: string,\n\t\tparams?: unknown,\n\t\tsignal?: AbortSignal,\n\t\ttimeoutMs?: number,\n\t\ttimeoutMessage = `Language server request ${method} timed out`,\n\t\tallowClosing = false,\n\t): Promise<unknown> {\n\t\tif (this.failure && !allowClosing) return Promise.reject(this.failure);\n\t\tif ((!allowClosing && (this.state === \"closing\" || this.state === \"closed\")) || this.state === \"failed\") {\n\t\t\treturn Promise.reject(this.failure ?? new Error(\"Language server client is disposed.\"));\n\t\t}\n\t\tconst id = this.nextRequestId++;\n\t\tif (!Number.isSafeInteger(id)) return Promise.reject(new Error(\"Language server request id space exhausted.\"));\n\t\tif (signal?.aborted)\n\t\t\treturn Promise.reject(normalizeError(signal.reason ?? new Error(\"Language server request aborted.\")));\n\n\t\treturn new Promise((resolve, reject) => {\n\t\t\tlet timer: NodeJS.Timeout | undefined;\n\t\t\tconst settle = (fn: () => void) => {\n\t\t\t\tif (timer) clearTimeout(timer);\n\t\t\t\tsignal?.removeEventListener(\"abort\", abort);\n\t\t\t\tfn();\n\t\t\t};\n\t\t\tconst abort = () => {\n\t\t\t\tif (!this.pending.delete(id)) return;\n\t\t\t\tvoid this.enqueueWrite({ jsonrpc: \"2.0\", method: \"$/cancelRequest\", params: { id } }).catch(() => {});\n\t\t\t\tsettle(() => reject(normalizeError(signal?.reason ?? new Error(\"Language server request aborted.\"))));\n\t\t\t};\n\t\t\tthis.pending.set(id, {\n\t\t\t\tresolve: (value) => settle(() => resolve(value)),\n\t\t\t\treject: (error) => settle(() => reject(error)),\n\t\t\t});\n\t\t\tsignal?.addEventListener(\"abort\", abort, { once: true });\n\t\t\tif (timeoutMs !== undefined) {\n\t\t\t\ttimer = setTimeout(() => {\n\t\t\t\t\tif (!this.pending.delete(id)) return;\n\t\t\t\t\tvoid this.enqueueWrite({ jsonrpc: \"2.0\", method: \"$/cancelRequest\", params: { id } }).catch(() => {});\n\t\t\t\t\tsettle(() => reject(new Error(`${timeoutMessage} after ${timeoutMs}ms.`)));\n\t\t\t\t}, timeoutMs);\n\t\t\t}\n\t\t\tvoid this.enqueueWrite({ jsonrpc: \"2.0\", id, method, ...(params === undefined ? {} : { params }) }).catch(\n\t\t\t\t(error) => {\n\t\t\t\t\tconst pending = this.pending.get(id);\n\t\t\t\t\tif (!pending) return;\n\t\t\t\t\tthis.pending.delete(id);\n\t\t\t\t\tpending.reject(normalizeError(error));\n\t\t\t\t},\n\t\t\t);\n\t\t});\n\t}\n\n\tprivate enqueueWrite(message: object): Promise<void> {\n\t\tconst body = Buffer.from(JSON.stringify(message), \"utf8\");\n\t\tif (body.length > LSP_MAX_MESSAGE_BYTES)\n\t\t\treturn Promise.reject(new Error(\"Language server message exceeds 8 MiB.\"));\n\t\tconst frame = Buffer.concat([Buffer.from(`Content-Length: ${body.length}\\r\\n\\r\\n`, \"ascii\"), body]);\n\t\tconst writing = this.writeChain.then(() => this.writeFrame(frame));\n\t\tthis.writeChain = writing.catch(() => {});\n\t\treturn writing;\n\t}\n\n\tprivate writeFrame(frame: Buffer): Promise<void> {\n\t\tconst stream = this.stdin;\n\t\tif (!stream || stream.destroyed || !stream.writable) {\n\t\t\treturn Promise.reject(new Error(\"Language server stdin is not writable.\"));\n\t\t}\n\t\treturn new Promise((resolve, reject) => {\n\t\t\tlet waitingForDrain = false;\n\t\t\tconst cleanup = () => {\n\t\t\t\tstream.removeListener(\"error\", onError);\n\t\t\t\tstream.removeListener(\"drain\", onDrain);\n\t\t\t};\n\t\t\tconst onError = (error: Error) => {\n\t\t\t\tcleanup();\n\t\t\t\treject(error);\n\t\t\t};\n\t\t\tconst onDrain = () => {\n\t\t\t\twaitingForDrain = false;\n\t\t\t\tcleanup();\n\t\t\t\tresolve();\n\t\t\t};\n\t\t\tstream.once(\"error\", onError);\n\t\t\tconst accepted = stream.write(frame, (error) => {\n\t\t\t\tif (error) onError(error);\n\t\t\t\telse if (!waitingForDrain) {\n\t\t\t\t\tcleanup();\n\t\t\t\t\tresolve();\n\t\t\t\t}\n\t\t\t});\n\t\t\tif (!accepted) {\n\t\t\t\twaitingForDrain = true;\n\t\t\t\tstream.once(\"drain\", onDrain);\n\t\t\t}\n\t\t});\n\t}\n\n\tprivate onData(chunk: Buffer | string): void {\n\t\tif (this.failure) return;\n\t\tthis.input = Buffer.concat([this.input, typeof chunk === \"string\" ? Buffer.from(chunk) : chunk]);\n\t\twhile (true) {\n\t\t\tconst headerEnd = this.input.indexOf(\"\\r\\n\\r\\n\");\n\t\t\tif (headerEnd < 0) {\n\t\t\t\tif (this.input.length > LSP_MAX_HEADER_BYTES) this.fail(new Error(\"Language server header exceeds 8 KiB.\"));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (headerEnd > LSP_MAX_HEADER_BYTES) {\n\t\t\t\tthis.fail(new Error(\"Language server header exceeds 8 KiB.\"));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst header = this.input.subarray(0, headerEnd).toString(\"ascii\");\n\t\t\tconst lengths = [...header.matchAll(/(?:^|\\r\\n)Content-Length:\\s*(\\d+)(?=\\r\\n|$)/gi)];\n\t\t\tif (lengths.length !== 1) {\n\t\t\t\tthis.fail(new Error(\"Language server frame must contain exactly one Content-Length header.\"));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst contentLength = Number(lengths[0][1]);\n\t\t\tif (!Number.isSafeInteger(contentLength) || contentLength > LSP_MAX_MESSAGE_BYTES) {\n\t\t\t\tthis.fail(new Error(\"Language server message exceeds 8 MiB.\"));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst bodyStart = headerEnd + 4;\n\t\t\tif (this.input.length < bodyStart + contentLength) return;\n\t\t\tconst body = this.input.subarray(bodyStart, bodyStart + contentLength).toString(\"utf8\");\n\t\t\tthis.input = this.input.subarray(bodyStart + contentLength);\n\t\t\ttry {\n\t\t\t\tconst parsed: unknown = JSON.parse(body);\n\t\t\t\tif (!isRecord(parsed)) throw new Error(\"Language server JSON-RPC message must be an object.\");\n\t\t\t\tthis.onMessage(parsed);\n\t\t\t} catch (error) {\n\t\t\t\tthis.fail(normalizeError(error));\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate onMessage(message: JsonRpcMessage): void {\n\t\tif (message.jsonrpc !== \"2.0\") {\n\t\t\tthis.fail(new Error('Language server message must declare jsonrpc \"2.0\".'));\n\t\t\treturn;\n\t\t}\n\t\tif (typeof message.method === \"string\") {\n\t\t\tif (message.id !== undefined && message.id !== null) {\n\t\t\t\tvoid this.handleServerRequest(message);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst notification: LspNotification = {\n\t\t\t\tmethod: message.method,\n\t\t\t\t...(message.params === undefined ? {} : { params: message.params }),\n\t\t\t};\n\t\t\tfor (const listener of this.notificationListeners) listener(notification);\n\t\t\treturn;\n\t\t}\n\t\tif (typeof message.id !== \"number\" || !Number.isSafeInteger(message.id)) return;\n\t\tconst pending = this.pending.get(message.id);\n\t\tif (!pending) return;\n\t\tconst hasResult = Object.hasOwn(message, \"result\");\n\t\tconst hasError = Object.hasOwn(message, \"error\");\n\t\tif (hasResult === hasError) {\n\t\t\tthis.fail(new Error(\"Language server response must contain exactly one of result or error.\"));\n\t\t\treturn;\n\t\t}\n\t\tthis.pending.delete(message.id);\n\t\tif (hasError) {\n\t\t\tconst error = message.error;\n\t\t\tif (!isRecord(error) || !Number.isSafeInteger(error.code) || typeof error.message !== \"string\") {\n\t\t\t\tthis.fail(new Error(\"Language server returned an invalid JSON-RPC error.\"));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tpending.reject(new LspJsonRpcError({ code: error.code as number, message: error.message, data: error.data }));\n\t\t\treturn;\n\t\t}\n\t\tpending.resolve(message.result);\n\t}\n\n\tprivate async handleServerRequest(message: JsonRpcMessage): Promise<void> {\n\t\tif (!isJsonRpcId(message.id) || typeof message.method !== \"string\") return;\n\t\tlet result: unknown;\n\t\tlet error: { code: number; message: string } | undefined;\n\t\tswitch (message.method) {\n\t\t\tcase \"workspace/configuration\": {\n\t\t\t\tconst params = message.params;\n\t\t\t\tif (!isRecord(params) || !Array.isArray(params.items)) error = { code: -32602, message: \"Invalid params\" };\n\t\t\t\telse result = params.items.map(() => null);\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tcase \"workspace/workspaceFolders\":\n\t\t\tcase \"window/showMessageRequest\":\n\t\t\t\tresult = null;\n\t\t\t\tbreak;\n\t\t\tcase \"client/registerCapability\":\n\t\t\tcase \"client/unregisterCapability\":\n\t\t\tcase \"window/workDoneProgress/create\":\n\t\t\tcase \"workspace/semanticTokens/refresh\":\n\t\t\tcase \"workspace/inlayHint/refresh\":\n\t\t\tcase \"workspace/diagnostic/refresh\":\n\t\t\tcase \"workspace/codeLens/refresh\":\n\t\t\t\tresult = null;\n\t\t\t\tbreak;\n\t\t\tcase \"workspace/applyEdit\":\n\t\t\t\tresult = { applied: false, failureReason: \"Apex Code does not accept server-initiated workspace edits.\" };\n\t\t\t\tbreak;\n\t\t\tcase \"window/showDocument\":\n\t\t\t\tresult = { success: false };\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\terror = { code: -32601, message: \"Method not found\" };\n\t\t}\n\t\tawait this.enqueueWrite({\n\t\t\tjsonrpc: \"2.0\",\n\t\t\tid: message.id,\n\t\t\t...(error ? { error } : { result }),\n\t\t}).catch((writeError) => this.fail(normalizeError(writeError)));\n\t}\n\n\tprivate captureStderr(chunk: Buffer | string): void {\n\t\tconst bytes = typeof chunk === \"string\" ? Buffer.from(chunk) : chunk;\n\t\tthis.stderrTail = Buffer.concat([this.stderrTail, bytes]);\n\t\tif (this.stderrTail.length > LSP_MAX_STDERR_TAIL_BYTES) {\n\t\t\tthis.stderrTail = this.stderrTail.subarray(this.stderrTail.length - LSP_MAX_STDERR_TAIL_BYTES);\n\t\t}\n\t}\n\n\tprivate rejectPending(error: Error): void {\n\t\tfor (const request of this.pending.values()) request.reject(error);\n\t\tthis.pending.clear();\n\t}\n\n\tprivate fail(error: Error): void {\n\t\tif (this.state === \"closed\") return;\n\t\tconst firstFailure = this.failure === undefined;\n\t\tthis.failure ??= error;\n\t\tif (this.state !== \"closing\") this.state = \"failed\";\n\t\tthis.rejectPending(this.failure);\n\t\tif (firstFailure) for (const listener of this.failureListeners) listener(this.failure);\n\t}\n}\n"]}

package/dist/core/lsp/client.js

@@ -0,0 +1,469 @@
+import { pathToFileURL } from "node:url";
+import { spawnProcess } from "../../utils/child-process.js";
+export const LSP_MAX_HEADER_BYTES = 8 * 1024;
+export const LSP_MAX_MESSAGE_BYTES = 8 * 1024 * 1024;
+export const LSP_MAX_STDERR_TAIL_BYTES = 64 * 1024;
+const DEFAULT_INITIALIZATION_TIMEOUT_MS = 10_000;
+const DEFAULT_REQUEST_TIMEOUT_MS = 10_000;
+const SHUTDOWN_TIMEOUT_MS = 2_000;
+const TERMINATE_GRACE_MS = 500;
+const KILL_GRACE_MS = 1_000;
+export class LspJsonRpcError extends Error {
+    code;
+    data;
+    constructor(error) {
+        super(error.message);
+        this.name = "LspJsonRpcError";
+        this.code = error.code;
+        this.data = error.data;
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isJsonRpcId(value) {
+    return typeof value === "string" || (typeof value === "number" && Number.isSafeInteger(value));
+}
+function normalizeError(error) {
+    return error instanceof Error ? error : new Error(String(error));
+}
+function parseTextDocumentSync(value) {
+    let kind = "none";
+    let openClose = false;
+    let save = false;
+    let saveIncludeText = false;
+    if (typeof value === "number") {
+        kind = value === 1 ? "full" : value === 2 ? "incremental" : "none";
+    }
+    else if (isRecord(value)) {
+        openClose = value.openClose === true;
+        kind = value.change === 1 ? "full" : value.change === 2 ? "incremental" : "none";
+        if (value.save === true)
+            save = true;
+        else if (isRecord(value.save)) {
+            save = true;
+            saveIncludeText = value.save.includeText === true;
+        }
+    }
+    return { kind, openClose, save, saveIncludeText };
+}
+function validateTimeout(value, fallback, label) {
+    const timeout = value ?? fallback;
+    if (!Number.isSafeInteger(timeout) || timeout < 1)
+        throw new Error(`${label} must be a positive safe integer.`);
+    return timeout;
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/** A bounded JSON-RPC 2.0 client for one language server's stdio. */
+export class LspClient {
+    options;
+    child;
+    stdin;
+    stdout;
+    input = Buffer.alloc(0);
+    stderrTail = Buffer.alloc(0);
+    nextRequestId = 1;
+    pending = new Map();
+    notificationListeners = new Set();
+    failureListeners = new Set();
+    startPromise;
+    disposePromise;
+    state = "idle";
+    failure;
+    writeChain = Promise.resolve();
+    syncCapabilities = {
+        kind: "none",
+        openClose: false,
+        save: false,
+        saveIncludeText: false,
+    };
+    constructor(options) {
+        this.options = options;
+    }
+    get capturedStderr() {
+        return this.stderrTail.toString("utf8");
+    }
+    /** Text-document synchronization negotiated during initialization. */
+    get textDocumentSync() {
+        return this.syncCapabilities;
+    }
+    onNotification(listener) {
+        this.notificationListeners.add(listener);
+        return () => this.notificationListeners.delete(listener);
+    }
+    /** Subscribe to the first terminal protocol or process failure. */
+    onFailure(listener) {
+        this.failureListeners.add(listener);
+        if (this.failure)
+            listener(this.failure);
+        return () => this.failureListeners.delete(listener);
+    }
+    start() {
+        if (this.failure)
+            return Promise.reject(this.failure);
+        if (this.state === "closing" || this.state === "closed") {
+            return Promise.reject(new Error("Language server client is disposed."));
+        }
+        if (!this.startPromise) {
+            this.state = "starting";
+            this.startPromise = this.initialize().catch(async (error) => {
+                const failure = normalizeError(error);
+                this.fail(failure);
+                await this.terminateChild();
+                throw failure;
+            });
+        }
+        return this.startPromise;
+    }
+    async request(method, params, signal) {
+        await this.start();
+        if (this.state !== "ready")
+            throw this.failure ?? new Error("Language server did not become ready.");
+        return this.sendRequest(method, params, signal, this.requestTimeoutMs());
+    }
+    notify(method, params) {
+        if (this.failure)
+            throw this.failure;
+        if (this.state !== "ready")
+            throw new Error("Language server is not ready.");
+        void this.enqueueWrite({ jsonrpc: "2.0", method, ...(params === undefined ? {} : { params }) }).catch((error) => {
+            this.fail(normalizeError(error));
+        });
+    }
+    dispose() {
+        if (!this.disposePromise)
+            this.disposePromise = this.disposeProcess();
+        return this.disposePromise;
+    }
+    initializationTimeoutMs() {
+        return validateTimeout(this.options.initializationTimeoutMs, DEFAULT_INITIALIZATION_TIMEOUT_MS, "initializationTimeoutMs");
+    }
+    requestTimeoutMs() {
+        return validateTimeout(this.options.requestTimeoutMs, DEFAULT_REQUEST_TIMEOUT_MS, "requestTimeoutMs");
+    }
+    async initialize() {
+        const child = spawnProcess(this.options.command, [...(this.options.args ?? [])], {
+            cwd: this.options.cwd,
+            env: this.options.env,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        if (!child.stdin || !child.stdout) {
+            child.kill();
+            throw new Error("Language server must expose piped stdin and stdout.");
+        }
+        this.child = child;
+        this.stdin = child.stdin;
+        this.stdout = child.stdout;
+        this.stdout.on("data", (chunk) => this.onData(chunk));
+        child.stderr?.on("data", (chunk) => this.captureStderr(chunk));
+        child.stdin.on("error", (error) => this.fail(error));
+        child.once("error", (error) => this.fail(error));
+        child.once("exit", (code, signal) => {
+            if (this.state !== "closing" && this.state !== "closed") {
+                this.fail(new Error(`Language server exited before shutdown (code=${code} signal=${signal}).`));
+            }
+        });
+        const initializeResult = await this.sendRequest("initialize", {
+            processId: process.pid,
+            clientInfo: { name: "Apex Code" },
+            rootUri: pathToFileURL(this.options.cwd).href,
+            capabilities: {
+                general: { positionEncodings: ["utf-16"] },
+                workspace: { workspaceFolders: false },
+                textDocument: {
+                    definition: {},
+                    references: {},
+                    documentSymbol: {},
+                    publishDiagnostics: { versionSupport: true },
+                },
+            },
+            workspaceFolders: null,
+        }, undefined, this.initializationTimeoutMs(), "Language server initialize timed out");
+        if (!isRecord(initializeResult) || !isRecord(initializeResult.capabilities)) {
+            throw new Error("Language server returned an invalid initialize result.");
+        }
+        this.syncCapabilities = parseTextDocumentSync(initializeResult.capabilities.textDocumentSync);
+        if (this.state !== "starting")
+            throw new Error("Language server initialization was interrupted.");
+        await this.enqueueWrite({ jsonrpc: "2.0", method: "initialized", params: {} });
+        this.state = "ready";
+    }
+    async disposeProcess() {
+        if (this.state === "closed")
+            return;
+        const wasReady = this.state === "ready";
+        this.state = "closing";
+        this.rejectPending(new Error("Language server client is closing."));
+        if (wasReady) {
+            try {
+                await this.sendRequest("shutdown", undefined, undefined, SHUTDOWN_TIMEOUT_MS, "Language server shutdown timed out", true);
+                await this.enqueueWrite({ jsonrpc: "2.0", method: "exit" });
+            }
+            catch {
+                // Bounded termination below is the fallback for an uncooperative server.
+            }
+        }
+        await this.terminateChild();
+        this.stdin?.end();
+        this.state = "closed";
+    }
+    async terminateChild() {
+        const child = this.child;
+        if (!child || child.exitCode !== null || child.signalCode !== null)
+            return;
+        const exited = new Promise((resolve) => child.once("exit", () => resolve()));
+        const graceful = await Promise.race([exited.then(() => true), delay(TERMINATE_GRACE_MS).then(() => false)]);
+        if (graceful)
+            return;
+        child.kill("SIGTERM");
+        const terminated = await Promise.race([exited.then(() => true), delay(KILL_GRACE_MS).then(() => false)]);
+        if (terminated)
+            return;
+        child.kill("SIGKILL");
+        await exited;
+    }
+    sendRequest(method, params, signal, timeoutMs, timeoutMessage = `Language server request ${method} timed out`, allowClosing = false) {
+        if (this.failure && !allowClosing)
+            return Promise.reject(this.failure);
+        if ((!allowClosing && (this.state === "closing" || this.state === "closed")) || this.state === "failed") {
+            return Promise.reject(this.failure ?? new Error("Language server client is disposed."));
+        }
+        const id = this.nextRequestId++;
+        if (!Number.isSafeInteger(id))
+            return Promise.reject(new Error("Language server request id space exhausted."));
+        if (signal?.aborted)
+            return Promise.reject(normalizeError(signal.reason ?? new Error("Language server request aborted.")));
+        return new Promise((resolve, reject) => {
+            let timer;
+            const settle = (fn) => {
+                if (timer)
+                    clearTimeout(timer);
+                signal?.removeEventListener("abort", abort);
+                fn();
+            };
+            const abort = () => {
+                if (!this.pending.delete(id))
+                    return;
+                void this.enqueueWrite({ jsonrpc: "2.0", method: "$/cancelRequest", params: { id } }).catch(() => { });
+                settle(() => reject(normalizeError(signal?.reason ?? new Error("Language server request aborted."))));
+            };
+            this.pending.set(id, {
+                resolve: (value) => settle(() => resolve(value)),
+                reject: (error) => settle(() => reject(error)),
+            });
+            signal?.addEventListener("abort", abort, { once: true });
+            if (timeoutMs !== undefined) {
+                timer = setTimeout(() => {
+                    if (!this.pending.delete(id))
+                        return;
+                    void this.enqueueWrite({ jsonrpc: "2.0", method: "$/cancelRequest", params: { id } }).catch(() => { });
+                    settle(() => reject(new Error(`${timeoutMessage} after ${timeoutMs}ms.`)));
+                }, timeoutMs);
+            }
+            void this.enqueueWrite({ jsonrpc: "2.0", id, method, ...(params === undefined ? {} : { params }) }).catch((error) => {
+                const pending = this.pending.get(id);
+                if (!pending)
+                    return;
+                this.pending.delete(id);
+                pending.reject(normalizeError(error));
+            });
+        });
+    }
+    enqueueWrite(message) {
+        const body = Buffer.from(JSON.stringify(message), "utf8");
+        if (body.length > LSP_MAX_MESSAGE_BYTES)
+            return Promise.reject(new Error("Language server message exceeds 8 MiB."));
+        const frame = Buffer.concat([Buffer.from(`Content-Length: ${body.length}\r\n\r\n`, "ascii"), body]);
+        const writing = this.writeChain.then(() => this.writeFrame(frame));
+        this.writeChain = writing.catch(() => { });
+        return writing;
+    }
+    writeFrame(frame) {
+        const stream = this.stdin;
+        if (!stream || stream.destroyed || !stream.writable) {
+            return Promise.reject(new Error("Language server stdin is not writable."));
+        }
+        return new Promise((resolve, reject) => {
+            let waitingForDrain = false;
+            const cleanup = () => {
+                stream.removeListener("error", onError);
+                stream.removeListener("drain", onDrain);
+            };
+            const onError = (error) => {
+                cleanup();
+                reject(error);
+            };
+            const onDrain = () => {
+                waitingForDrain = false;
+                cleanup();
+                resolve();
+            };
+            stream.once("error", onError);
+            const accepted = stream.write(frame, (error) => {
+                if (error)
+                    onError(error);
+                else if (!waitingForDrain) {
+                    cleanup();
+                    resolve();
+                }
+            });
+            if (!accepted) {
+                waitingForDrain = true;
+                stream.once("drain", onDrain);
+            }
+        });
+    }
+    onData(chunk) {
+        if (this.failure)
+            return;
+        this.input = Buffer.concat([this.input, typeof chunk === "string" ? Buffer.from(chunk) : chunk]);
+        while (true) {
+            const headerEnd = this.input.indexOf("\r\n\r\n");
+            if (headerEnd < 0) {
+                if (this.input.length > LSP_MAX_HEADER_BYTES)
+                    this.fail(new Error("Language server header exceeds 8 KiB."));
+                return;
+            }
+            if (headerEnd > LSP_MAX_HEADER_BYTES) {
+                this.fail(new Error("Language server header exceeds 8 KiB."));
+                return;
+            }
+            const header = this.input.subarray(0, headerEnd).toString("ascii");
+            const lengths = [...header.matchAll(/(?:^|\r\n)Content-Length:\s*(\d+)(?=\r\n|$)/gi)];
+            if (lengths.length !== 1) {
+                this.fail(new Error("Language server frame must contain exactly one Content-Length header."));
+                return;
+            }
+            const contentLength = Number(lengths[0][1]);
+            if (!Number.isSafeInteger(contentLength) || contentLength > LSP_MAX_MESSAGE_BYTES) {
+                this.fail(new Error("Language server message exceeds 8 MiB."));
+                return;
+            }
+            const bodyStart = headerEnd + 4;
+            if (this.input.length < bodyStart + contentLength)
+                return;
+            const body = this.input.subarray(bodyStart, bodyStart + contentLength).toString("utf8");
+            this.input = this.input.subarray(bodyStart + contentLength);
+            try {
+                const parsed = JSON.parse(body);
+                if (!isRecord(parsed))
+                    throw new Error("Language server JSON-RPC message must be an object.");
+                this.onMessage(parsed);
+            }
+            catch (error) {
+                this.fail(normalizeError(error));
+                return;
+            }
+        }
+    }
+    onMessage(message) {
+        if (message.jsonrpc !== "2.0") {
+            this.fail(new Error('Language server message must declare jsonrpc "2.0".'));
+            return;
+        }
+        if (typeof message.method === "string") {
+            if (message.id !== undefined && message.id !== null) {
+                void this.handleServerRequest(message);
+                return;
+            }
+            const notification = {
+                method: message.method,
+                ...(message.params === undefined ? {} : { params: message.params }),
+            };
+            for (const listener of this.notificationListeners)
+                listener(notification);
+            return;
+        }
+        if (typeof message.id !== "number" || !Number.isSafeInteger(message.id))
+            return;
+        const pending = this.pending.get(message.id);
+        if (!pending)
+            return;
+        const hasResult = Object.hasOwn(message, "result");
+        const hasError = Object.hasOwn(message, "error");
+        if (hasResult === hasError) {
+            this.fail(new Error("Language server response must contain exactly one of result or error."));
+            return;
+        }
+        this.pending.delete(message.id);
+        if (hasError) {
+            const error = message.error;
+            if (!isRecord(error) || !Number.isSafeInteger(error.code) || typeof error.message !== "string") {
+                this.fail(new Error("Language server returned an invalid JSON-RPC error."));
+                return;
+            }
+            pending.reject(new LspJsonRpcError({ code: error.code, message: error.message, data: error.data }));
+            return;
+        }
+        pending.resolve(message.result);
+    }
+    async handleServerRequest(message) {
+        if (!isJsonRpcId(message.id) || typeof message.method !== "string")
+            return;
+        let result;
+        let error;
+        switch (message.method) {
+            case "workspace/configuration": {
+                const params = message.params;
+                if (!isRecord(params) || !Array.isArray(params.items))
+                    error = { code: -32602, message: "Invalid params" };
+                else
+                    result = params.items.map(() => null);
+                break;
+            }
+            case "workspace/workspaceFolders":
+            case "window/showMessageRequest":
+                result = null;
+                break;
+            case "client/registerCapability":
+            case "client/unregisterCapability":
+            case "window/workDoneProgress/create":
+            case "workspace/semanticTokens/refresh":
+            case "workspace/inlayHint/refresh":
+            case "workspace/diagnostic/refresh":
+            case "workspace/codeLens/refresh":
+                result = null;
+                break;
+            case "workspace/applyEdit":
+                result = { applied: false, failureReason: "Apex Code does not accept server-initiated workspace edits." };
+                break;
+            case "window/showDocument":
+                result = { success: false };
+                break;
+            default:
+                error = { code: -32601, message: "Method not found" };
+        }
+        await this.enqueueWrite({
+            jsonrpc: "2.0",
+            id: message.id,
+            ...(error ? { error } : { result }),
+        }).catch((writeError) => this.fail(normalizeError(writeError)));
+    }
+    captureStderr(chunk) {
+        const bytes = typeof chunk === "string" ? Buffer.from(chunk) : chunk;
+        this.stderrTail = Buffer.concat([this.stderrTail, bytes]);
+        if (this.stderrTail.length > LSP_MAX_STDERR_TAIL_BYTES) {
+            this.stderrTail = this.stderrTail.subarray(this.stderrTail.length - LSP_MAX_STDERR_TAIL_BYTES);
+        }
+    }
+    rejectPending(error) {
+        for (const request of this.pending.values())
+            request.reject(error);
+        this.pending.clear();
+    }
+    fail(error) {
+        if (this.state === "closed")
+            return;
+        const firstFailure = this.failure === undefined;
+        this.failure ??= error;
+        if (this.state !== "closing")
+            this.state = "failed";
+        this.rejectPending(this.failure);
+        if (firstFailure)
+            for (const listener of this.failureListeners)
+                listener(this.failure);
+    }
+}
+//# sourceMappingURL=client.js.map