Function sanitizeDefinition

src/cm/lsp/serverRegistry.ts:170–327

(
	definition: RawServerDefinition,
)

export type RawServerDefinition = LspServerManifest;

function sanitizeDefinition(
	definition: RawServerDefinition,
): LspServerDefinition {
	if (!definition || typeof definition !== "object") {
		throw new TypeError("LSP server definition must be an object");
	}

	const id = toKey(definition.id);
	if (!id) throw new Error("LSP server definition requires a non-empty id");

	const transport: RawTransportDescriptor = definition.transport ?? {};
	const kind = (transport.kind ?? "stdio") as
		| "stdio"
		| "websocket"
		| "external";

	if (!transport || typeof transport !== "object") {
		throw new Error(`LSP server ${id} is missing a transport descriptor`);
	}

	if (
		!("languages" in definition) ||
		!sanitizeLanguages(definition.languages).length
	) {
		throw new Error(`LSP server ${id} must declare supported languages`);
	}

	if (kind === "stdio" && !transport.command) {
		throw new Error(`LSP server ${id} (stdio) requires a command`);
	}

	// Websocket transport requires a URL unless a bridge is configured for auto-port discovery
	const hasBridge = definition.launcher?.bridge?.command;
	if (kind === "websocket" && !transport.url && !hasBridge) {
		throw new Error(
			`LSP server ${id} (websocket) requires a url or a launcher bridge`,
		);
	}

	const transportOptions: Record<string, unknown> =
		transport.options && typeof transport.options === "object"
			? { ...transport.options }
			: {};

	const sanitizedTransport: TransportDescriptor = {
		kind,
		command: transport.command,
		args: Array.isArray(transport.args)
			? transport.args.map((arg) => String(arg))
			: undefined,
		options: transportOptions,
		url: transport.url,
		protocols: undefined,
	};

	let launcher: LauncherConfig | undefined;
	if (definition.launcher && typeof definition.launcher === "object") {
		const rawLauncher = definition.launcher;