@camstack/addon-provider-bosch 0.1.26 → 0.1.28

package/dist/homecom/addon.mjs

@@ -1,5 +1,5 @@
 import { A as isSecretMarker, C as waterHeaterCapability, E as errMsg, F as number, I as object, M as _enum, N as array, O as customAction, P as literal, R as string, T as DeviceType, V as EventCategory, c as connectionTestCapability, j as isSecretMarkerLike, k as defineCustomActions, n as BaseDeviceProvider, s as climateControlCapability, t as BaseDevice, u as deviceAdoptionCapability } from "../dist-Cbcvh8mB.mjs";
-import { a as parseOAuthCallback, i as loginFailureForAttempt, n as cascadeRemoveDevicesForIntegration, r as createSignInAttemptStore, t as setIntegrationDevicesOnline } from "../account-integration-offline-iGgTPuq_.mjs";
+import { a as parseOAuthCallback, i as loginFailureForAttempt, n as cascadeRemoveDevicesForIntegration, r as createSignInAttemptStore, t as setIntegrationDevicesOnline } from "../account-integration-offline-DKaazSyb.mjs";
 import { createHash, randomBytes } from "node:crypto";
 //#region src/homecom/config.ts
 var HOMECOM_BRANDS = ["bosch", "buderus"];
@@ -13,8 +13,11 @@ var homeComConfigSchema = object({
 	refresh: string().min(1).describe("OAuth refresh token").meta({ secret: true }),
 	brand: HomeComBrandSchema.default("bosch"),
 	region: HomeComRegionSchema.default("eu"),
-	/** The gateway this integration controls; chosen once from the account's gateways. */
-	gatewayId: string().min(1).optional(),
+	/**
+	* The gateway this integration controls. Chosen from the account list after
+	* sign-in. A blank value is the same as absent: the id is not known yet.
+	*/
+	gatewayId: string().trim().optional().transform((value) => value === void 0 || value.length === 0 ? void 0 : value),
 	/** Shown on the sign-in field. Not a credential. */
 	accountLabel: string().optional(),
 	/** How many gateways the last sign-in listed. */
@@ -33,6 +36,8 @@ function sameHomeComConnection(a, b) {
 * the same host; `region` is retained for Bacon MQTT (`euc1` / `use1`) when wired.
 */
 var HOMECOM_POINTT_API_ORIGIN = "https://pointt-api.bosch-thermotechnology.com";
+/** Account gateway list. `deviceId` on each row is the gateway id. */
+var HOMECOM_GATEWAYS_PATH = "/pointt-api/api/v1/gateways/";
 function homeComApiBase(_region) {
 	return HOMECOM_POINTT_API_ORIGIN;
 }
@@ -45,15 +50,29 @@ var HIDDEN_UNTIL_ADVANCED = {
 	field: "__hidden__",
 	equals: "yes"
 };
+var HOMECOM_CODE_HELP = [
+	"Before you sign in, open the browser's developer tools, choose the Network tab, and turn on Preserve log.",
+	"Sign in with SingleKey. The page will say it has network problems. Ignore that: the browser tried to open the Bosch app and could not.",
+	"In the Network list, filter by code= and open the request whose address starts with com.bosch.tt.dashtt.pointt://app/login?code=",
+	"Copy that whole address, or only the code, and paste it in the box under the sign-in button.",
+	"On a phone the same redirect fails unless the Bosch app is installed. Use a desktop browser to copy the code."
+].join("\n\n");
 function buildHomeComFormSchema() {
 	return { sections: [{
 		id: "account",
 		title: "HomeCom account",
 		titleKey: "provider-bosch:homecom.s_account.title",
-		description: "Sign in with your SingleKey ID. Bosch opens its app address; paste that address here.",
+		description: "Sign in with your SingleKey ID. Copy the code as described below, then paste it here.",
 		descriptionKey: "provider-bosch:homecom.s_account.description",
 		columns: 1,
 		fields: [
+			{
+				type: "info",
+				key: "__homecom-code-help",
+				label: HOMECOM_CODE_HELP,
+				labelKey: "provider-bosch:homecom.s_account.__homecom-code-help.label",
+				content: ""
+			},
 			{
 				type: "account-sign-in",
 				addonId: "bosch-homecom",
@@ -139,6 +158,8 @@ function buildHomeComFormSchema() {
 						key: "gatewayId",
 						label: "Gateway id",
 						labelKey: "provider-bosch:homecom.s_account.gatewayId.label",
+						description: "Filled from the account. Type one only when you need to override the choice.",
+						descriptionKey: "provider-bosch:homecom.s_account.gatewayId.description",
 						required: false
 					},
 					{
@@ -212,30 +233,129 @@ var homeComActions = defineCustomActions({
 	})
 });
 //#endregion
+//#region src/homecom/homecom-device-type.ts
+/**
+* Device types the PointT gateway list reports. The set is the one the MIT
+* `homecom_alt` library branches on (`rac`, `k40`, `k30`, `wddw2`, `icom`,
+* `rrc2`). This file records that classification; it is not a copy of that code.
+*/
+var HOMECOM_SERVED_TYPES = [
+	"rac",
+	"k40",
+	"k30",
+	"wddw2",
+	"icom",
+	"rrc2"
+];
+var FAMILIES = {
+	rac: "rac",
+	k40: "hydronic",
+	k30: "hydronic",
+	icom: "hydronic",
+	rrc2: "hydronic",
+	wddw2: "water-heater"
+};
+function familyOf(deviceType) {
+	if (deviceType === void 0) return null;
+	if (!isServedType(deviceType)) return null;
+	return FAMILIES[deviceType];
+}
+function isServedType(deviceType) {
+	for (const served of HOMECOM_SERVED_TYPES) if (deviceType === served) return true;
+	return false;
+}
+/** The account listed a type this addon has no climate or water-heater resources for. */
+var HomeComUnknownDeviceTypeError = class extends Error {
+	name = "HomeComUnknownDeviceTypeError";
+	deviceType;
+	constructor(deviceType) {
+		super(`HomeCom does not serve device type "${deviceType}".`);
+		this.deviceType = deviceType;
+	}
+};
+function unsupportedDeviceTypeMessage(deviceType) {
+	if (familyOf(deviceType) !== null) return null;
+	return new HomeComUnknownDeviceTypeError(deviceType ?? "(missing)").message;
+}
+//#endregion
+//#region src/homecom/homecom-oauth.ts
+/**
+* Public OAuth client of the HomeCom Easy app, signed in through SingleKey ID.
+*
+* A PKCE client has no secret. The values are the ones SingleKey accepts for this client id
+* today: the same authorize query the MIT-licensed `homecom_alt` client records
+* (`OAUTH_LOGIN_PARAMS` — parameters, not copied code) and that the Home Assistant integration
+* opens. `pointt.gateway.resource.dopair` is not a scope this client may request; SingleKey
+* answers `misconfigured-application` and never shows the login page. The scope it does accept
+* names `pointt.gateway.resource.dashapp`, and the Bosch app sends `style_id=tt_bsch`.
+*/
+var HOMECOM_CLIENT_ID = "762162C0-FA2D-4540-AE66-6489F189FADC";
+var HOMECOM_REDIRECT_URI = "com.bosch.tt.dashtt.pointt://app/login";
+var HOMECOM_AUTHORIZE_URL = "https://singlekey-id.com/auth/connect/authorize";
+var HOMECOM_TOKEN_URL = "https://singlekey-id.com/auth/connect/token";
+var HOMECOM_STYLE_ID = "tt_bsch";
+var HOMECOM_SCOPE = [
+	"openid",
+	"email",
+	"profile",
+	"offline_access",
+	"pointt.gateway.claiming",
+	"pointt.gateway.removal",
+	"pointt.gateway.list",
+	"pointt.gateway.users",
+	"pointt.gateway.resource.dashapp",
+	"pointt.castt.flow.token-exchange",
+	"bacon",
+	"hcc.tariff.read"
+].join(" ");
+//#endregion
 //#region src/homecom/homecom-domain-mapping.ts
 var MODE_MAP = {
 	Off: "off",
 	off: "off",
 	Heat: "heat",
 	heat: "heat",
+	manual: "heat",
 	Cool: "cool",
 	cool: "cool",
 	Auto: "auto",
-	auto: "auto"
+	auto: "auto",
+	dry: "dry",
+	Dry: "dry",
+	fanOnly: "fan_only",
+	fan_only: "fan_only"
 };
 function mapHvacMode(raw) {
 	return MODE_MAP[raw] ?? "off";
 }
+/** PointT `allowedValues` mapped onto HVAC modes, in the order the device listed them. */
+function hvacModesFromAllowed(allowed) {
+	const out = [];
+	for (const raw of allowed) {
+		const mapped = MODE_MAP[raw];
+		if (mapped === void 0 || out.includes(mapped)) continue;
+		out.push(mapped);
+	}
+	return out;
+}
+function displayedMode(circuit) {
+	const mapped = mapHvacMode(circuit.operationMode);
+	if (mapped === "off") return "off";
+	if (circuit.season === "cooling") return "cool";
+	return mapped;
+}
 function climateSliceFromCircuit(circuit, nowMs) {
+	const mode = displayedMode(circuit);
+	const available = circuit.availableModes;
 	return {
-		mode: mapHvacMode(circuit.operationMode),
-		availableModes: [
+		mode,
+		availableModes: available !== void 0 && available.length > 0 ? [...available] : [
 			"off",
 			"heat",
 			"auto"
 		],
-		fanMode: "",
-		availableFanModes: [],
+		fanMode: circuit.fanMode ?? "",
+		availableFanModes: circuit.availableFanModes !== void 0 ? [...circuit.availableFanModes] : [],
 		preset: "",
 		availablePresets: [],
 		target: circuit.setpoint,
@@ -243,9 +363,9 @@ function climateSliceFromCircuit(circuit, nowMs) {
 		targetLow: null,
 		targetHumidity: null,
 		currentTemp: circuit.currentRoomTemp,
-		currentHumidity: null,
-		swingVertical: null,
-		swingHorizontal: null,
+		currentHumidity: circuit.currentHumidity ?? null,
+		swingVertical: circuit.swingVertical ?? null,
+		swingHorizontal: circuit.swingHorizontal ?? null,
 		minTemp: circuit.minTemp,
 		maxTemp: circuit.maxTemp,
 		tempStep: .5,
@@ -264,92 +384,364 @@ function waterHeaterSliceFromDhw(dhw, nowMs) {
 		lastChangedAt: nowMs
 	};
 }
-/** Parse K40-style gateway JSON into heating circuits + DHW. Pure. */
-function parseHomeComSystemPayload(payload) {
-	if (typeof payload !== "object" || payload === null) return {
-		circuits: [],
-		dhw: null
+var HOMECOM_PROBE_CLOCK = "/gateway/DateTime";
+var HOMECOM_PROBE_FIRMWARE = "/gateway/versionFirmware";
+var HYDRONIC_DROPPED = "heat-source, ventilation, pool and energy resources are not published on a cap";
+var RAC_DROPPED = "domestic hot water, presets and a humidity target are not published for an air conditioner";
+var WATER_HEATER_DROPPED = "heating circuits are not on a wddw2 water heater";
+var ZONE_DROPPED = "rrc2 zones are not published on a cap";
+var UNSUPPORTED_CONTROLS = "fan mode, swing, presets and a humidity target are not on this device type";
+var HYDRONIC_MODES = [
+	"off",
+	"heat",
+	"auto"
+];
+var TOKEN = /^[A-Za-z0-9_-]+$/;
+function readEnvelope(body) {
+	if (!isRecord$2(body) || !("value" in body)) return null;
+	const value = body["value"];
+	if (typeof value !== "string" && typeof value !== "number" && typeof value !== "boolean") return null;
+	return {
+		value,
+		min: finite(body["minValue"]),
+		max: finite(body["maxValue"]),
+		allowed: stringList(body["allowedValues"])
+	};
+}
+function probeText(body) {
+	const envelope = readEnvelope(body);
+	if (envelope === null) return null;
+	if (typeof envelope.value === "string" && envelope.value.length > 0) return envelope.value;
+	if (typeof envelope.value === "number" || typeof envelope.value === "boolean") return String(envelope.value);
+	return null;
+}
+async function readPointtSnapshot(input) {
+	if (input.family === "rac") return readRac(input);
+	if (input.family === "water-heater") return readWaterHeater(input);
+	return readHydronic(input);
+}
+function circuitSetpointWrite(snapshot, circuitId, temp) {
+	return {
+		path: findCircuit(snapshot, circuitId).setpointResource ?? `/heatingCircuits/${circuitId}/manualRoomSetpoint`,
+		value: temp
+	};
+}
+function circuitModeWrites(snapshot, circuitId, mode) {
+	const token = pointtMode(mode);
+	if (snapshot.family === "rac") {
+		if (token === "off") return [{
+			path: "/airConditioning/acControl",
+			value: "off"
+		}];
+		return [{
+			path: "/airConditioning/acControl",
+			value: "on"
+		}, {
+			path: "/airConditioning/operationMode",
+			value: token
+		}];
+	}
+	if (token === "cool") return [{
+		path: `/heatingCircuits/${circuitId}/heatCoolMode`,
+		value: "cooling"
+	}];
+	return [{
+		path: `/heatingCircuits/${circuitId}/operationMode`,
+		value: token
+	}];
+}
+function dhwTargetWrite(snapshot, temp) {
+	const dhw = snapshot.dhw;
+	if (dhw?.targetResource === void 0) throw new Error("HomeCom DHW: setpoint not supported");
+	return {
+		path: dhw.targetResource,
+		value: temp
+	};
+}
+function dhwModeWrite(snapshot, mode) {
+	const id = snapshot.dhw?.circuitId;
+	if (id === void 0) throw new Error("HomeCom DHW: setpoint not supported");
+	return {
+		path: `/dhwCircuits/${id}/operationMode`,
+		value: mode
+	};
+}
+function fanWrite(snapshot, fanMode) {
+	if (snapshot.family !== "rac") throw new Error("HomeCom climate: fan mode not supported");
+	return {
+		path: "/airConditioning/fanSpeed",
+		value: fanMode
+	};
+}
+function swingWrite(snapshot, axis, on) {
+	if (snapshot.family !== "rac") throw new Error("HomeCom climate: swing not supported");
+	if (axis === "vertical") return {
+		path: "/airConditioning/airFlowVertical",
+		value: on ? "swing" : "angle3"
+	};
+	return {
+		path: "/airConditioning/airFlowHorizontal",
+		value: on ? "swing" : "center"
 	};
-	const root = payload;
+}
+async function readHydronic(input) {
+	input.logDrop(HYDRONIC_DROPPED);
+	input.logDrop(UNSUPPORTED_CONTROLS);
+	if (input.deviceType === "rrc2") input.logDrop(ZONE_DROPPED);
+	const heating = await input.get("/heatingCircuits");
+	const dhwBody = await input.get("/dhwCircuits");
 	const circuits = [];
-	const rawCircuits = root["heatingCircuits"];
-	if (Array.isArray(rawCircuits)) for (const item of rawCircuits) {
-		if (typeof item !== "object" || item === null) continue;
-		const row = item;
-		const id = row["id"];
-		if (typeof id !== "string") continue;
-		circuits.push({
-			id,
-			name: typeof row["name"] === "string" ? row["name"] : id,
-			operationMode: typeof row["operationMode"] === "string" ? row["operationMode"] : "off",
-			setpoint: readNum(row["setpoint"]),
-			currentRoomTemp: readNum(row["currentRoomTemperature"]),
-			minTemp: readNum(row["minTemp"]),
-			maxTemp: readNum(row["maxTemp"])
-		});
-	}
-	let dhw = null;
-	const rawDhw = root["domesticHotWater"];
-	if (typeof rawDhw === "object" && rawDhw !== null) {
-		const row = rawDhw;
-		const modes = [];
-		if (Array.isArray(row["operationModes"])) {
-			for (const m of row["operationModes"]) if (typeof m === "string") modes.push(m);
-		}
-		dhw = {
-			currentTemp: readNum(row["currentTemperature"]),
-			targetTemp: readNum(row["setpoint"]),
-			operationMode: typeof row["operationMode"] === "string" ? row["operationMode"] : null,
-			availableModes: modes.length > 0 ? modes : [
-				"off",
-				"eco",
-				"performance"
-			],
-			minTemp: readNum(row["minTemp"]),
-			maxTemp: readNum(row["maxTemp"])
-		};
-	}
+	for (const id of referenceKeys(heating, "hc")) circuits.push(await readCircuit(input.get, id));
+	const dhwIds = referenceKeys(dhwBody, "dhw");
+	const first = dhwIds[0];
+	const dhw = first === void 0 ? null : await readDhw(input.get, first);
+	if (dhwIds.length > 1) input.logDrop(`extra DHW circuits are not published: ${dhwIds.slice(1).join(", ")}`);
+	return snapshotOf(input, circuits, dhw);
+}
+async function readWaterHeater(input) {
+	input.logDrop(WATER_HEATER_DROPPED);
+	const first = referenceKeys(await input.get("/dhwCircuits"), "dhw")[0];
+	const dhw = first === void 0 ? null : await readDhw(input.get, first);
+	if (dhw === null) input.logDrop("this water heater returned no DHW circuit");
+	return snapshotOf(input, [], dhw);
+}
+async function readRac(input) {
+	input.logDrop(RAC_DROPPED);
+	const names = [
+		"operationMode",
+		"temperatureSetpoint",
+		"acControl",
+		"fanSpeed",
+		"airFlowVertical",
+		"airFlowHorizontal",
+		"roomTemperature"
+	];
+	const inline = indexStandard(await input.get("/airConditioning/standardFunctions"));
+	const loaded = /* @__PURE__ */ new Map();
+	for (const name of names) {
+		const direct = readEnvelope(await input.get(`/airConditioning/${name}`));
+		loaded.set(name, direct ?? inline.get(name) ?? null);
+	}
+	const power = stringOf(loaded.get("acControl") ?? null);
+	const operation = loaded.get("operationMode") ?? null;
+	const setpoint = loaded.get("temperatureSetpoint") ?? null;
+	const fan = loaded.get("fanSpeed") ?? null;
+	const modes = hvacModesFromAllowed(operation?.allowed ?? []);
+	const availableModes = modes.includes("off") ? modes : [...modes, "off"];
+	return snapshotOf(input, [{
+		id: "ac",
+		name: "Air conditioning",
+		operationMode: power === "off" ? "off" : stringOf(operation) ?? "off",
+		setpoint: numberOf(setpoint),
+		currentRoomTemp: numberOf(loaded.get("roomTemperature") ?? null),
+		minTemp: setpoint?.min ?? null,
+		maxTemp: setpoint?.max ?? null,
+		currentHumidity: null,
+		season: null,
+		fanMode: stringOf(fan) ?? "",
+		availableFanModes: fan?.allowed ?? [],
+		swingVertical: swingOf(loaded.get("airFlowVertical") ?? null),
+		swingHorizontal: swingOf(loaded.get("airFlowHorizontal") ?? null),
+		availableModes: availableModes.length > 0 ? availableModes : [
+			"off",
+			"cool",
+			"heat",
+			"auto"
+		],
+		setpointResource: "/airConditioning/temperatureSetpoint"
+	}], null);
+}
+async function readCircuit(get, id) {
+	const base = `/heatingCircuits/${id}`;
+	const loaded = await loadEnvelopes(get, [
+		`${base}/operationMode`,
+		`${base}/roomtemperature`,
+		`${base}/manualRoomSetpoint`,
+		`${base}/currentRoomSetpoint`,
+		`${base}/currentSuWiMode`,
+		`${base}/heatCoolMode`,
+		`${base}/actualHumidity`,
+		`${base}/cooling/roomTempSetpoint`
+	]);
+	const operation = loaded.get(`${base}/operationMode`) ?? null;
+	const manual = loaded.get(`${base}/manualRoomSetpoint`) ?? null;
+	const current = loaded.get(`${base}/currentRoomSetpoint`) ?? null;
+	const coolingSet = loaded.get(`${base}/cooling/roomTempSetpoint`) ?? null;
+	const season = stringOf(loaded.get(`${base}/currentSuWiMode`) ?? null);
+	const heatCool = stringOf(loaded.get(`${base}/heatCoolMode`) ?? null);
+	const cooling = season === "cooling" || heatCool === "cooling";
+	const modes = hvacModesFromAllowed(operation?.allowed ?? []);
+	const humidity = numberOf(loaded.get(`${base}/actualHumidity`) ?? null);
+	return {
+		id,
+		name: id,
+		operationMode: stringOf(operation) ?? "off",
+		setpoint: cooling ? numberOf(coolingSet) ?? numberOf(current) ?? numberOf(manual) : numberOf(current) ?? numberOf(manual),
+		currentRoomTemp: numberOf(loaded.get(`${base}/roomtemperature`) ?? null),
+		minTemp: manual?.min ?? current?.min ?? null,
+		maxTemp: manual?.max ?? current?.max ?? null,
+		currentHumidity: humidity !== null && humidity >= 0 && humidity <= 100 ? humidity : null,
+		season: cooling ? "cooling" : season,
+		fanMode: "",
+		availableFanModes: [],
+		swingVertical: null,
+		swingHorizontal: null,
+		availableModes: modes.length > 0 ? modes : [...HYDRONIC_MODES],
+		setpointResource: cooling ? `${base}/cooling/roomTempSetpoint` : `${base}/manualRoomSetpoint`
+	};
+}
+async function readDhw(get, id) {
+	const base = `/dhwCircuits/${id}`;
+	const loaded = await loadEnvelopes(get, [
+		`${base}/operationMode`,
+		`${base}/actualTemp`,
+		`${base}/outletTemperature`,
+		`${base}/currentTemperatureLevel`,
+		`${base}/currentSetpoint`,
+		`${base}/manualsetpoint`
+	]);
+	const operation = loaded.get(`${base}/operationMode`) ?? null;
+	const chosen = await chooseDhwTarget(get, base, loaded, safeToken(stringOf(loaded.get(`${base}/currentTemperatureLevel`) ?? null)));
+	const modes = operation?.allowed ?? [];
 	return {
+		currentTemp: numberOf(loaded.get(`${base}/actualTemp`) ?? null) ?? numberOf(loaded.get(`${base}/outletTemperature`) ?? null),
+		targetTemp: chosen.target,
+		operationMode: stringOf(operation),
+		availableModes: modes.length > 0 ? [...modes] : [
+			"off",
+			"eco",
+			"performance"
+		],
+		minTemp: chosen.min,
+		maxTemp: chosen.max,
+		circuitId: id,
+		targetResource: chosen.resource
+	};
+}
+async function chooseDhwTarget(get, base, loaded, level) {
+	const current = loaded.get(`${base}/currentSetpoint`) ?? null;
+	if (numberOf(current) !== null) return bound(current, numberOf(current), `${base}/currentSetpoint`);
+	if (level !== null && level !== "off") {
+		const levelEnv = readEnvelope(await get(`${base}/temperatureLevels/${level}`));
+		if (numberOf(levelEnv) !== null) return bound(levelEnv, numberOf(levelEnv), `${base}/temperatureLevels/${level}`);
+	}
+	const manual = loaded.get(`${base}/manualsetpoint`) ?? null;
+	return bound(manual, numberOf(manual), `${base}/manualsetpoint`);
+}
+function bound(envelope, target, resource) {
+	return {
+		target,
+		min: envelope?.min ?? null,
+		max: envelope?.max ?? null,
+		resource
+	};
+}
+async function loadEnvelopes(get, paths) {
+	const pairs = await Promise.all(paths.map(async (path) => [path, readEnvelope(await get(path))]));
+	return new Map(pairs);
+}
+function snapshotOf(input, circuits, dhw) {
+	return {
+		gateway: {
+			gatewayId: input.gatewayId,
+			name: input.gatewayId,
+			model: input.deviceType
+		},
 		circuits,
-		dhw
+		dhw,
+		deviceType: input.deviceType,
+		family: input.family
 	};
 }
-function readNum(raw) {
-	if (typeof raw === "number" && Number.isFinite(raw)) return raw;
-	return null;
+function findCircuit(snapshot, circuitId) {
+	const circuit = snapshot.circuits.find((item) => item.id === circuitId);
+	if (circuit === void 0) throw new Error(`HomeCom has no heating circuit ${circuitId}`);
+	return circuit;
+}
+function pointtMode(mode) {
+	switch (mode) {
+		case "Heat":
+		case "heat":
+		case "manual": return "manual";
+		case "Auto":
+		case "auto": return "auto";
+		case "Cool":
+		case "cool": return "cool";
+		case "Dry":
+		case "dry": return "dry";
+		case "fan_only":
+		case "fanOnly": return "fanOnly";
+		case "Off":
+		case "off": return "off";
+		default: return mode;
+	}
+}
+function referenceKeys(body, prefix) {
+	if (!isRecord$2(body) || !Array.isArray(body["references"])) return [];
+	const pattern = prefix === "hc" ? /^hc\d+$/ : /^dhw\d+$/;
+	const out = [];
+	for (const ref of body["references"]) {
+		if (!isRecord$2(ref) || typeof ref["id"] !== "string") continue;
+		const tail = ref["id"].split("/").filter((part) => part.length > 0).at(-1);
+		if (tail === void 0 || !pattern.test(tail) || out.includes(tail)) continue;
+		out.push(tail);
+	}
+	return out;
+}
+function indexStandard(body) {
+	const map = /* @__PURE__ */ new Map();
+	if (!isRecord$2(body) || !Array.isArray(body["references"])) return map;
+	for (const ref of body["references"]) {
+		if (!isRecord$2(ref) || typeof ref["id"] !== "string") continue;
+		const tail = ref["id"].split("/").filter((part) => part.length > 0).at(-1) ?? ref["id"];
+		const envelope = readEnvelope(ref);
+		if (envelope !== null) map.set(tail, envelope);
+	}
+	return map;
+}
+function numberOf(envelope) {
+	if (envelope === null) return null;
+	return typeof envelope.value === "number" && Number.isFinite(envelope.value) ? envelope.value : null;
+}
+function stringOf(envelope) {
+	if (envelope === null || typeof envelope.value !== "string" || envelope.value.length === 0) return null;
+	return envelope.value;
+}
+function swingOf(envelope) {
+	const value = stringOf(envelope);
+	if (value === null) return null;
+	return value === "swing";
+}
+function safeToken(value) {
+	if (value === null || !TOKEN.test(value)) return null;
+	return value;
+}
+function finite(raw) {
+	return typeof raw === "number" && Number.isFinite(raw) ? raw : null;
+}
+function stringList(raw) {
+	if (!Array.isArray(raw)) return [];
+	const out = [];
+	for (const item of raw) if (typeof item === "string") out.push(item);
+	return out;
+}
+function isRecord$2(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-//#endregion
-//#region src/homecom/homecom-oauth.ts
-/**
-* Public OAuth client of the HomeCom Easy / PointT mobile app, signed in through SingleKey ID.
-*
-* These are the PUBLIC values the app itself ships (a PKCE client has no secret). They are not
-* derivable from this repository; they come from the community PointT client (`homecom_alt`) and
-* have to be confirmed against a live account — see docs/addons/addon-provider-bosch-homecom.md.
-*/
-var HOMECOM_CLIENT_ID = "762162C0-FA2D-4540-AE66-6489F189FADC";
-var HOMECOM_REDIRECT_URI = "com.bosch.tt.dashtt.pointt://app/login";
-var HOMECOM_AUTHORIZE_URL = "https://singlekey-id.com/auth/connect/authorize";
-var HOMECOM_TOKEN_URL = "https://singlekey-id.com/auth/connect/token";
-var HOMECOM_SCOPE = [
-	"openid",
-	"email",
-	"profile",
-	"offline_access",
-	"pointt.gateway.claiming",
-	"pointt.gateway.removal",
-	"pointt.gateway.list",
-	"pointt.gateway.users",
-	"pointt.gateway.resource.dopair",
-	"pointt.castt.flow.token-exchange",
-	"bacon",
-	"hcc.tariff.read"
-].join(" ");
 //#endregion
 //#region src/homecom/homecom-api-client.ts
 var HomeComAuthError = class extends Error {
 	name = "HomeComAuthError";
 };
+/** The account gateway list answered with an HTTP error. The status is the point. */
+var HomeComGatewayListError = class extends Error {
+	name = "HomeComGatewayListError";
+	status;
+	constructor(status) {
+		super(`The gateway list failed (HTTP ${status}).`);
+		this.status = status;
+	}
+};
 function isRecord$1(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -365,6 +757,13 @@ function rowId(row) {
 	}
 	return null;
 }
+function textOf(row, keys) {
+	for (const key of keys) {
+		const value = row[key];
+		if (typeof value === "string" && value.trim().length > 0) return value.trim();
+		if (typeof value === "number") return String(value);
+	}
+}
 /** Gateways from the account listing: a bare array or `{ gateways: [...] }`. */
 function parseHomeComGatewayList(payload) {
 	const rows = isRecord$1(payload) ? payload["gateways"] : payload;
@@ -374,110 +773,237 @@ function parseHomeComGatewayList(payload) {
 		if (!isRecord$1(row)) continue;
 		const gatewayId = rowId(row);
 		if (gatewayId === null) continue;
-		const name = row["name"];
-		const brand = row["brand"];
-		const region = row["region"];
+		const name = textOf(row, ["name", "friendlyName"]);
+		const deviceType = textOf(row, ["deviceType"]);
+		const model = textOf(row, ["model"]) ?? deviceType;
+		const serial = textOf(row, [
+			"serial",
+			"serialNumber",
+			"serialId"
+		]);
+		const brand = textOf(row, ["brand"]);
+		const region = textOf(row, ["region"]);
 		out.push({
 			gatewayId,
-			name: typeof name === "string" && name.length > 0 ? name : gatewayId,
-			...typeof brand === "string" && brand.length > 0 ? { brand } : {},
-			...typeof region === "string" && region.length > 0 ? { region } : {}
+			name: name ?? gatewayId,
+			...model !== void 0 ? { model } : {},
+			...serial !== void 0 ? { serial } : {},
+			...brand !== void 0 ? { brand } : {},
+			...region !== void 0 ? { region } : {},
+			...deviceType !== void 0 ? { deviceType } : {}
 		});
 	}
 	return out;
 }
+function homeComResourceUrl(gatewayId, resourcePath) {
+	const path = resourcePath.startsWith("/") ? resourcePath : `/${resourcePath}`;
+	return `${HOMECOM_POINTT_API_ORIGIN}${HOMECOM_GATEWAYS_PATH}${encodeURIComponent(gatewayId)}/resource${path}`;
+}
 function createHomeComApiClient(config, gatewayId, deps = {}) {
 	const fetchFn = deps.fetchFn ?? globalThis.fetch.bind(globalThis);
+	const refreshOnUnauthorized = deps.refreshOnUnauthorized ?? true;
+	const logger = deps.logger;
 	let token = config.token;
 	let refresh = config.refresh;
+	let deviceType = deps.deviceType;
+	let last = null;
+	let refreshTail = Promise.resolve();
+	const dropped = /* @__PURE__ */ new Set();
 	const base = homeComApiBase(config.region);
-	async function authHeaders() {
+	function authHeaders() {
 		return {
 			Authorization: `Bearer ${token}`,
 			Accept: "application/json",
 			"Content-Type": "application/json"
 		};
 	}
-	async function request(path, init = {}) {
-		const res = await fetchFn(`${base}${path}`, {
+	function logDrop(reason) {
+		if (dropped.has(reason)) return;
+		dropped.add(reason);
+		logger?.info("HomeCom dropped a resource the caps do not publish", { meta: {
+			gatewayId,
+			deviceType: deviceType ?? "(missing)",
+			reason
+		} });
+	}
+	function logMissing(path, status) {
+		const key = `missing:${path}`;
+		if (dropped.has(key)) return;
+		dropped.add(key);
+		logger?.info("HomeCom resource is absent", { meta: {
+			gatewayId,
+			path,
+			status
+		} });
+	}
+	async function refreshIfStale(used) {
+		const run = refreshTail.then(async () => {
+			if (token !== used) return;
+			await refreshTokens();
+		});
+		refreshTail = run.then(() => void 0, () => void 0);
+		await run;
+	}
+	async function authed(url, init, attempt = "first") {
+		const used = token;
+		const res = await fetchFn(url, {
 			method: init.method ?? "GET",
-			headers: await authHeaders(),
-			body: init.body !== void 0 ? JSON.stringify(init.body) : void 0
+			headers: authHeaders(),
+			body: init.body
 		});
-		if (res.status === 401) throw new HomeComAuthError("token expired");
+		if (res.status === 401) {
+			if (!((init.allowRefresh ?? true) && refreshOnUnauthorized) || attempt === "retried") throw new HomeComAuthError(attempt === "retried" ? "token expired after refresh" : "token expired");
+			await refreshIfStale(used);
+			return authed(url, init, "retried");
+		}
+		let body = null;
+		try {
+			body = await res.json();
+		} catch {
+			body = null;
+		}
+		return {
+			ok: res.ok,
+			status: res.status,
+			body
+		};
+	}
+	async function getResource(path) {
+		const res = await authed(homeComResourceUrl(gatewayId, path), { method: "GET" });
+		if (res.status === 404 || res.status === 403) {
+			logMissing(path, res.status);
+			return null;
+		}
 		if (!res.ok) throw new Error(`HomeCom API ${path} failed: HTTP ${res.status}`);
-		return res.json();
+		return res.body;
+	}
+	async function putWrite(write) {
+		const res = await authed(homeComResourceUrl(gatewayId, write.path), {
+			method: "PUT",
+			body: JSON.stringify({ value: write.value })
+		});
+		if (res.status === 404 || res.status === 403) throw new Error(`HomeCom write to ${write.path} was refused (HTTP ${res.status}).`);
+		if (!res.ok) throw new Error(`HomeCom API ${write.path} failed: HTTP ${res.status}`);
+	}
+	async function requireSnapshot() {
+		if (last !== null) return last;
+		return fetchSystem();
+	}
+	async function resolveDeviceType() {
+		if (deviceType === void 0) deviceType = (await listGateways()).find((row) => row.gatewayId === gatewayId)?.deviceType;
+		const family = familyOf(deviceType);
+		if (family === null || deviceType === void 0) {
+			const label = deviceType ?? "(missing)";
+			logger?.warn("HomeCom device type is not served", { meta: {
+				gatewayId,
+				deviceType: label
+			} });
+			throw new HomeComUnknownDeviceTypeError(label);
+		}
+		return {
+			deviceType,
+			family
+		};
+	}
+	async function refreshTokens() {
+		const res = await fetchFn(HOMECOM_TOKEN_URL, {
+			method: "POST",
+			headers: { "Content-Type": "application/x-www-form-urlencoded" },
+			body: new URLSearchParams({
+				grant_type: "refresh_token",
+				refresh_token: refresh,
+				client_id: HOMECOM_CLIENT_ID
+			}).toString()
+		});
+		if (!res.ok) {
+			if (res.status === 401 || res.status === 403) throw new HomeComAuthError("refresh refused");
+			throw new Error(`HomeCom token refresh failed: HTTP ${res.status}`);
+		}
+		const body = await res.json();
+		if (!isRecord$1(body)) throw new Error("HomeCom token refresh: bad body");
+		const newToken = body["access_token"];
+		const newRefresh = body["refresh_token"];
+		if (typeof newToken !== "string" || typeof newRefresh !== "string") throw new Error("HomeCom token refresh: missing tokens");
+		token = newToken;
+		refresh = newRefresh;
+		await deps.onTokensRotated?.({
+			token,
+			refresh
+		});
+		return {
+			token,
+			refresh
+		};
+	}
+	async function listGateways() {
+		const res = await authed(`${base}${HOMECOM_GATEWAYS_PATH}`, { method: "GET" });
+		if (!res.ok) throw new HomeComGatewayListError(res.status);
+		return parseHomeComGatewayList(res.body);
+	}
+	async function fetchSystem() {
+		const resolved = await resolveDeviceType();
+		const snapshot = await readPointtSnapshot({
+			deviceType: resolved.deviceType,
+			family: resolved.family,
+			gatewayId,
+			get: getResource,
+			logDrop
+		});
+		last = snapshot;
+		return snapshot;
+	}
+	async function probePath(path) {
+		const res = await authed(homeComResourceUrl(gatewayId, path), {
+			method: "GET",
+			allowRefresh: false
+		});
+		if (res.status === 404 || res.status === 403) return null;
+		if (!res.ok) throw new Error(`HomeCom API ${path} failed: HTTP ${res.status}`);
+		return probeText(res.body);
 	}
 	return {
-		async refreshTokens() {
-			const res = await fetchFn(HOMECOM_TOKEN_URL, {
-				method: "POST",
-				headers: { "Content-Type": "application/x-www-form-urlencoded" },
-				body: new URLSearchParams({
-					grant_type: "refresh_token",
-					refresh_token: refresh,
-					client_id: HOMECOM_CLIENT_ID
-				}).toString()
-			});
-			if (!res.ok) {
-				if (res.status === 401 || res.status === 403) throw new HomeComAuthError("refresh refused");
-				throw new Error(`HomeCom token refresh failed: HTTP ${res.status}`);
-			}
-			const body = await res.json();
-			if (typeof body !== "object" || body === null) throw new Error("HomeCom token refresh: bad body");
-			const row = body;
-			const newToken = row["access_token"];
-			const newRefresh = row["refresh_token"];
-			if (typeof newToken !== "string" || typeof newRefresh !== "string") throw new Error("HomeCom token refresh: missing tokens");
-			token = newToken;
-			refresh = newRefresh;
-			await deps.onTokensRotated?.({
-				token,
-				refresh
-			});
-			return {
-				token,
-				refresh
+		refreshTokens,
+		listGateways,
+		fetchSystem,
+		async probeGateway() {
+			const clock = await probePath(HOMECOM_PROBE_CLOCK);
+			if (clock !== null) return {
+				resource: HOMECOM_PROBE_CLOCK,
+				value: clock
 			};
-		},
-		async listGateways() {
-			return parseHomeComGatewayList(await request("/v2/gateways"));
-		},
-		async fetchSystem() {
-			const parsed = parseHomeComSystemPayload(await request(`/v2/gateways/${gatewayId}/system`));
-			return {
-				gateway: {
-					gatewayId,
-					name: "HomeCom heat pump",
-					model: "K40"
-				},
-				circuits: parsed.circuits,
-				dhw: parsed.dhw
+			const firmware = await probePath(HOMECOM_PROBE_FIRMWARE);
+			if (firmware !== null) return {
+				resource: HOMECOM_PROBE_FIRMWARE,
+				value: firmware
 			};
+			throw new Error(`HomeCom gateway ${gatewayId} did not answer /gateway/DateTime or /gateway/versionFirmware.`);
 		},
 		async setCircuitSetpoint(circuitId, temp) {
-			await request(`/v2/gateways/${gatewayId}/heatingCircuits/${circuitId}/setpoint`, {
-				method: "PUT",
-				body: { value: temp }
-			});
+			await putWrite(circuitSetpointWrite(await requireSnapshot(), circuitId, temp));
 		},
 		async setCircuitMode(circuitId, mode) {
-			await request(`/v2/gateways/${gatewayId}/heatingCircuits/${circuitId}/operationMode`, {
-				method: "PUT",
-				body: { value: mode }
-			});
+			for (const write of circuitModeWrites(await requireSnapshot(), circuitId, mode)) await putWrite(write);
 		},
 		async setDhwTarget(temp) {
-			await request(`/v2/gateways/${gatewayId}/domesticHotWater/setpoint`, {
-				method: "PUT",
-				body: { value: temp }
-			});
+			await putWrite(dhwTargetWrite(await requireSnapshot(), temp));
 		},
 		async setDhwMode(mode) {
-			await request(`/v2/gateways/${gatewayId}/domesticHotWater/operationMode`, {
-				method: "PUT",
-				body: { value: mode }
-			});
+			await putWrite(dhwModeWrite(await requireSnapshot(), mode));
+		},
+		async setFanMode(_circuitId, fanMode) {
+			const snapshot = await requireSnapshot();
+			if (snapshot.family !== "rac") logDrop("fan mode is not a resource on this device type");
+			await putWrite(fanWrite(snapshot, fanMode));
+		},
+		async setSwingVertical(_circuitId, on) {
+			const snapshot = await requireSnapshot();
+			if (snapshot.family !== "rac") logDrop("swing is not a resource on this device type");
+			await putWrite(swingWrite(snapshot, "vertical", on));
+		},
+		async setSwingHorizontal(_circuitId, on) {
+			const snapshot = await requireSnapshot();
+			if (snapshot.family !== "rac") logDrop("swing is not a resource on this device type");
+			await putWrite(swingWrite(snapshot, "horizontal", on));
 		}
 	};
 }
@@ -491,10 +1017,17 @@ function regionOf(value) {
 	for (const region of HOMECOM_REGIONS) if (value === region) return region;
 	return "eu";
 }
+function choiceLabel(gateway) {
+	const parts = [];
+	if (gateway.name.length > 0 && gateway.name !== gateway.gatewayId) parts.push(gateway.name);
+	if (gateway.model !== void 0 && gateway.model.length > 0 && gateway.model !== gateway.name) parts.push(gateway.model);
+	if (gateway.serial !== void 0 && gateway.serial.length > 0) parts.push(gateway.serial);
+	return parts.length > 0 ? parts.join(" · ") : gateway.gatewayId;
+}
 function choiceOf(gateway) {
 	return {
 		value: gateway.gatewayId,
-		label: gateway.name,
+		label: choiceLabel(gateway),
 		brand: brandOf(gateway.brand),
 		region: regionOf(gateway.region)
 	};
@@ -556,6 +1089,7 @@ function beginHomeComSignIn() {
 	url.searchParams.set("state", state);
 	url.searchParams.set("nonce", b64url(randomBytes(16)));
 	url.searchParams.set("prompt", "login");
+	url.searchParams.set("style_id", HOMECOM_STYLE_ID);
 	return {
 		authorizeUrl: url.toString(),
 		verifier,
@@ -620,11 +1154,12 @@ function publishHomeComSignIn(store, nowMs) {
 	};
 }
 async function listGatewaysDefault(tokens, fetchFn) {
-	const res = await fetchFn(`${HOMECOM_POINTT_API_ORIGIN}/v2/gateways`, { headers: {
+	const res = await fetchFn(`${HOMECOM_POINTT_API_ORIGIN}${HOMECOM_GATEWAYS_PATH}`, { headers: {
 		Authorization: `Bearer ${tokens.token}`,
 		Accept: "application/json"
 	} });
-	if (!res.ok) return [];
+	if (res.status === 401) throw new HomeComGatewayListError(res.status);
+	if (!res.ok) throw new HomeComGatewayListError(res.status);
 	return parseHomeComGatewayList(await res.json());
 }
 async function finishHomeComSignIn(input, store, deps = {}) {
@@ -637,25 +1172,25 @@ async function finishHomeComSignIn(input, store, deps = {}) {
 		state: taken.attempt.state
 	}, fetchFn);
 	let gateways = [];
-	let listFailed = false;
+	let listFailure = null;
 	try {
 		gateways = await (deps.listGateways ?? ((next) => listGatewaysDefault(next, fetchFn)))(tokens);
-	} catch {
-		listFailed = true;
+	} catch (err) {
+		listFailure = err instanceof HomeComGatewayListError ? err.message : "The gateway list failed.";
 		gateways = [];
 	}
-	return finishedFromGateways(tokens, resolveHomeComGateway(gateways), listFailed);
+	return finishedFromGateways(tokens, resolveHomeComGateway(gateways), listFailure);
 }
-function finishedFromGateways(tokens, resolved, listFailed) {
+function finishedFromGateways(tokens, resolved, listFailure) {
 	const who = tokens.username.length > 0 ? `Signed in as ${tokens.username}` : "Signed in";
 	const base = {
 		...tokens,
 		accountLabel: tokens.username
 	};
-	if (listFailed) return {
+	if (listFailure !== null) return {
 		...base,
 		gatewayCount: 0,
-		summary: `${who}. The gateway list could not be read. Enter the gateway id under Advanced.`
+		summary: listFailure
 	};
 	if (resolved.kind === "one") return {
 		...base,
@@ -674,7 +1209,7 @@ function finishedFromGateways(tokens, resolved, listFailed) {
 	return {
 		...base,
 		gatewayCount: 0,
-		summary: `${who}. No gateway was listed. Enter the gateway id under Advanced.`
+		summary: "This Bosch account has no HomeCom gateway."
 	};
 }
 var homeComSignInAttempts = createSignInAttemptStore();
@@ -997,7 +1532,9 @@ var HomeComIntegrationManager = class {
 		};
 		this.#makeClient = options.makeClient ?? ((config, gatewayId) => createHomeComApiClient(config, gatewayId, {
 			fetchFn,
-			onTokensRotated
+			onTokensRotated,
+			logger: this.#logger,
+			deviceType: this.#gateways.find((gateway) => gateway.gatewayId === gatewayId)?.deviceType
 		}));
 		this.#pollIntervalMs = options.pollIntervalMs ?? 6e4;
 	}
@@ -1029,7 +1566,7 @@ var HomeComIntegrationManager = class {
 			this.#gatewayId = gatewayId;
 			client = this.#makeClient(this.#connection, gatewayId);
 			this.#client = client;
-			const snapshot = await this.fetchWithTokenRefresh(client);
+			const snapshot = await client.fetchSystem();
 			const surface = {
 				gatewayId: this.#gatewayId ?? "",
 				client,
@@ -1073,7 +1610,7 @@ var HomeComIntegrationManager = class {
 		const client = this.#client;
 		if (!client) return;
 		try {
-			const snapshot = await this.fetchWithTokenRefresh(client);
+			const snapshot = await client.fetchSystem();
 			this.#surfaceSink.updateSnapshot(this.#id, snapshot);
 			this.#lastCheckedAt = Date.now();
 		} catch (err) {
@@ -1083,18 +1620,6 @@ var HomeComIntegrationManager = class {
 			} });
 		}
 	}
-	async fetchWithTokenRefresh(client) {
-		return this.withTokenRefresh(client, () => client.fetchSystem());
-	}
-	async withTokenRefresh(client, call) {
-		try {
-			return await call();
-		} catch (err) {
-			if (!(err instanceof HomeComAuthError)) throw err;
-			await client.refreshTokens();
-			return call();
-		}
-	}
 	/**
 	* The gateway to poll: the stored choice when the account still has it, otherwise the
 	* account's first gateway, which is then stored. A stored choice that vanished is an error —
@@ -1102,7 +1627,7 @@ var HomeComIntegrationManager = class {
 	*/
 	async resolveGatewayId() {
 		const lister = this.#makeClient(this.#connection, "");
-		this.#gateways = await this.withTokenRefresh(lister, () => lister.listGateways());
+		this.#gateways = await lister.listGateways();
 		const stored = this.#connection.gatewayId;
 		if (stored !== void 0) {
 			if (!this.#gateways.some((g) => g.gatewayId === stored)) throw new Error(`HomeCom gateway ${stored} is no longer on this account`);
@@ -1237,17 +1762,28 @@ var HomeComClientRegistry = class {
 };
 //#endregion
 //#region src/homecom/homecom-connection-test.ts
-var TEST_LABEL = "Lists the account gateways and reads the heat-pump system snapshot";
+var TEST_LABEL = "Lists the account gateways and reads the gateway clock";
+var NO_GATEWAY = "This Bosch account has no HomeCom gateway.";
+function signInIncomplete(paths) {
+	if (paths.includes("token") || paths.includes("refresh")) return "Sign in first. Bosch has not issued an access token yet.";
+	return `HomeCom could not use the saved sign-in (${paths.join(", ")}).`;
+}
+function listFailureMessage(err) {
+	if (err instanceof HomeComGatewayListError) return err.message;
+	if (err instanceof Error && err.message.startsWith("The gateway list failed")) return err.message;
+	if (err instanceof Error && err.message.includes("did not answer")) return err.message;
+	return null;
+}
 function buildHomeComConnectionTestProvider(deps) {
 	const { logger } = deps;
-	const makeClient = deps.makeClient ?? ((config, gatewayId) => createHomeComApiClient(config, gatewayId));
+	const makeClient = deps.makeClient ?? ((config, gatewayId) => createHomeComApiClient(config, gatewayId, { refreshOnUnauthorized: false }));
 	return {
 		describeTest: async () => ({ label: TEST_LABEL }),
 		testSettings: async ({ settings }) => {
 			const parsed = homeComConfigSchema.safeParse(settings);
 			if (!parsed.success) return {
 				outcome: "rejected",
-				error: `HomeCom settings incomplete: ${parsed.error.issues.map((i) => i.path.join(".") || "(root)").join(", ")}`
+				error: signInIncomplete(parsed.error.issues.map((issue) => issue.path.join(".") || "(root)"))
 			};
 			const startedAt = Date.now();
 			try {
@@ -1255,18 +1791,30 @@ function buildHomeComConnectionTestProvider(deps) {
 				const gatewayId = parsed.data.gatewayId ?? gateways[0]?.gatewayId;
 				if (gatewayId === void 0) return {
 					outcome: "rejected",
-					error: "This HomeCom account has no gateway."
+					error: NO_GATEWAY
 				};
 				if (!gateways.some((g) => g.gatewayId === gatewayId)) return {
 					outcome: "rejected",
 					error: `Gateway ${gatewayId} is not on this account.`
 				};
-				await makeClient(parsed.data, gatewayId).fetchSystem();
+				const listed = gateways.find((gateway) => gateway.gatewayId === gatewayId);
+				const probe = await makeClient(parsed.data, gatewayId).probeGateway();
+				const refusal = unsupportedDeviceTypeMessage(listed?.deviceType);
+				if (refusal !== null) return {
+					outcome: "rejected",
+					error: refusal
+				};
 				return {
 					outcome: "validated",
-					latencyMs: Date.now() - startedAt
+					latencyMs: Date.now() - startedAt,
+					detail: `Gateway ${gatewayId} (${listed?.deviceType}) answered ${probe.resource}.`
 				};
 			} catch (err) {
+				const listed = listFailureMessage(err);
+				if (listed !== null) return {
+					outcome: "rejected",
+					error: listed
+				};
 				if (err instanceof HomeComAuthError) return {
 					outcome: "rejected",
 					error: "HomeCom refused the access token — sign in again to get a fresh one."
@@ -1355,8 +1903,9 @@ var HomeComClimateDevice = class extends BaseDevice {
 				await this.requireClient().setCircuitMode(this.#circuitId, apiMode);
 				this.refreshFromSnapshot();
 			},
-			setFanMode: async () => {
-				throw new Error("HomeCom climate: fan mode not supported");
+			setFanMode: async ({ fanMode }) => {
+				await this.requireClient().setFanMode(this.#circuitId, fanMode);
+				this.refreshFromSnapshot();
 			},
 			setPreset: async () => {
 				throw new Error("HomeCom climate: presets not supported");
@@ -1371,11 +1920,13 @@ var HomeComClimateDevice = class extends BaseDevice {
 			setTargetHumidity: async () => {
 				throw new Error("HomeCom climate: humidity not supported");
 			},
-			setSwingVertical: async () => {
-				throw new Error("HomeCom climate: swing not supported");
+			setSwingVertical: async ({ on }) => {
+				await this.requireClient().setSwingVertical(this.#circuitId, on);
+				this.refreshFromSnapshot();
 			},
-			setSwingHorizontal: async () => {
-				throw new Error("HomeCom climate: swing not supported");
+			setSwingHorizontal: async ({ on }) => {
+				await this.requireClient().setSwingHorizontal(this.#circuitId, on);
+				this.refreshFromSnapshot();
 			}
 		});
 	}