Function upsertCustomServer

src/settings/lspConfigUtils.js:68–136

(serverId, config)

}

export async function upsertCustomServer(serverId, config) {
	const key = normalizeServerId(serverId);
	if (!key) {
		throw new Error("Server id is required");
	}

	const existingServer = lspApi.servers.get(key);
	if (existingServer && getServerOverride(key).custom !== true) {
		throw new Error("A built-in server already uses this id");
	}

	const languages = normalizeLanguages(config.languages);
	if (!languages.length) {
		throw new Error("At least one language id is required");
	}

	const current = cloneLspSettings();
	current.servers = current.servers || {};
	const existing = current.servers[key] || {};
	const hasTransport = Object.prototype.hasOwnProperty.call(
		config,
		"transport",
	);
	const hasLauncher = Object.prototype.hasOwnProperty.call(config, "launcher");
	const nextConfig = {
		...existing,
		...config,
		custom: true,
		label: config.label || existing.label || key,
		languages,
		transport: hasTransport
			? config.transport
			: existing.transport || { kind: "websocket" },
		launcher: hasLauncher ? config.launcher : existing.launcher,
		runtimes: config.runtimes || existing.runtimes,
		enabled: config.enabled !== false,
	};

	const installKind = nextConfig.launcher?.install?.kind;
	if (installKind && installKind !== "shell") {
		const providedExecutable =
			nextConfig.launcher.install.binaryPath ||
			nextConfig.launcher.install.executable;
		if (!providedExecutable) {
			throw new Error(
				"Managed installers must declare the executable path or command they provide",
			);
		}
	}

	current.servers[key] = nextConfig;
	await appSettings.update({ lsp: current }, false);

	const definition = {
		id: key,
		label: nextConfig.label,
		languages,
		transport: nextConfig.transport,