@camstack/addon-provider-homematic 1.2.171 → 1.2.173

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.173] - 2026-10-31
+
+### Changed
+
+- The CCU connection form explains why WebUI credentials are needed and prefills the username with Admin.
+
+## [1.2.172] - 2026-10-31
+
+### Changed
+
+- The CCU network scan now finds a CCU that answers the probe with a JSON-RPC error, a WebUI username alone (empty password) now unlocks device names, and a missing-names warning is logged.
+
 ## [1.2.171] - 2026-10-31
 
 ### Changed

package/dist/addon.js

@@ -117874,7 +117874,7 @@ var homematicConfigSchema = object({
 	enableBidcosRf: boolean().default(false).describe("Enable Homematic (BidCos-RF)"),
 	enableGroups: boolean().default(true).describe("Enable groups (heating groups / VirtualDevices)"),
 	enableBidcosWired: boolean().default(false).describe("Enable BidCos-Wired (HM-Wired)"),
-	username: string().default("").describe("WebUI username (optional — enables names / rooms / sysvars)"),
+	username: string().default("Admin").describe("WebUI username (optional — enables names / rooms / sysvars)"),
 	password: string().default("").describe("WebUI password (optional)").meta({ secret: true }),
 	callbackHost: string().default("").describe("Address the CCU calls back to for event push (this hub LAN IP)"),
 	callbackPort: preprocess((v) => v === "" || v === null ? void 0 : v, number().int().min(1).max(65535).default(2128)).describe("Local XML-RPC callback server port"),
@@ -117895,11 +117895,12 @@ function enabledInterfaces(config) {
 /**
 * Build the `HomematicOptions` the wrapped library constructor expects
 * from the validated addon config. Pure: same config in → same options
-* out. Credentials are only forwarded when both fields are non-empty so
-* the library skips the JSON-RPC hub layer cleanly when they're absent.
+* out. Credentials are forwarded when a username is set (the password may be
+* empty on a CCU without WebUI authentication); without one the library skips
+* the JSON-RPC hub layer cleanly.
 */
 function toHomematicOptions(config) {
-	const hasCredentials = config.username.length > 0 && config.password.length > 0;
+	const hasCredentials = config.username.length > 0;
 	const callbackHost = config.callbackHost.length > 0 ? config.callbackHost : inferCallbackHost(config.host) ?? "";
 	const interfaces = enabledInterfaces(config);
 	return {
@@ -117946,6 +117947,8 @@ var homematicGatewayDeviceSchema = object({
 	/** The adoption candidate id the device was adopted from. */
 	nativeId: string().min(1)
 });
+/** Why the form asks for credentials; shown first (translated through its `labelKey`). */
+var CREDENTIALS_NOTICE = "Device and room names come from the CCU WebUI. Enter a WebUI user (Admin by default). If the WebUI has no login, leave the password empty. Without a user, devices are listed by their address.";
 /**
 * The integration form: a discovered-CCU picker (filled by the LAN scan), the
 * host, the interfaces, the event callback, the WebUI credentials (the password
@@ -117958,31 +117961,41 @@ function buildConnectionFormSchema() {
 			title: "CCU connection",
 			titleKey: "provider-homematic:connection.s_connection.title",
 			columns: 1,
-			fields: [{
-				type: "addon-action-select",
-				addonId: "provider-homematic",
-				key: "__homematic-discovered",
-				writesKey: "host",
-				omitFromSettings: true,
-				label: "CCU",
-				labelKey: "provider-homematic:connection.s_connection.__homematic-discovered.label",
-				action: "discoverCcu",
-				mapOption: {
-					value: "host",
-					label: "name"
+			fields: [
+				{
+					type: "info",
+					key: "credentialsNotice",
+					label: CREDENTIALS_NOTICE,
+					labelKey: "provider-homematic:connection.s_connection.credentialsNotice.label",
+					content: ""
 				},
-				hideWhenFewerThan: 2,
-				emptyResultsMessage: "No CCU found on the network."
-			}, {
-				type: "text",
-				key: "host",
-				label: "Host / IP",
-				labelKey: "provider-homematic:connection.s_connection.host.label",
-				description: "Filled when one CCU is found. Type the address if it is not.",
-				descriptionKey: "provider-homematic:connection.s_connection.host.description",
-				required: true,
-				placeholder: "192.168.10.50"
-			}]
+				{
+					type: "addon-action-select",
+					addonId: "provider-homematic",
+					key: "__homematic-discovered",
+					writesKey: "host",
+					omitFromSettings: true,
+					label: "CCU",
+					labelKey: "provider-homematic:connection.s_connection.__homematic-discovered.label",
+					action: "discoverCcu",
+					mapOption: {
+						value: "host",
+						label: "name"
+					},
+					hideWhenFewerThan: 2,
+					emptyResultsMessage: "No CCU found on the network."
+				},
+				{
+					type: "text",
+					key: "host",
+					label: "Host / IP",
+					labelKey: "provider-homematic:connection.s_connection.host.label",
+					description: "Filled when one CCU is found. Type the address if it is not.",
+					descriptionKey: "provider-homematic:connection.s_connection.host.description",
+					required: true,
+					placeholder: "192.168.10.50"
+				}
+			]
 		},
 		{
 			id: "interfaces",
@@ -118056,7 +118069,8 @@ function buildConnectionFormSchema() {
 				type: "text",
 				key: "username",
 				label: "Username",
-				labelKey: "provider-homematic:connection.s_credentials.username.label"
+				labelKey: "provider-homematic:connection.s_credentials.username.label",
+				default: "Admin"
 			}, {
 				type: "password",
 				key: "password",
@@ -120780,6 +120794,10 @@ var HOMEMATIC_DISCOVERY_MODES = [{
 	tls: false,
 	acceptStatus: [200]
 }];
+/** A JSON-RPC reply: it echoes `version` or `id`, and carries a `result` and an `error` member. */
+function isJsonRpcEnvelope(parsed) {
+	return (Reflect.has(parsed, "version") || Reflect.has(parsed, "id")) && Reflect.has(parsed, "result") && Reflect.has(parsed, "error");
+}
 /**
 * Read the answer of `CCU.getAuthEnabled`, the question the WebUI asks before
 * it shows a login. A CCU answers a boolean; one that already requires a login
@@ -120799,7 +120817,7 @@ function parseAuthEnabledAnswer(status, text) {
 		if (typeof error !== "object") return null;
 		const message = Reflect.get(error, "message");
 		const code = Reflect.get(error, "code");
-		return typeof message === "string" && message.toLowerCase().startsWith("access denied") || code === 401 || code === -32001 ? { authEnabled: true } : null;
+		return typeof message === "string" && message.toLowerCase().startsWith("access denied") || code === 401 || code === -32001 || isJsonRpcEnvelope(parsed) ? { authEnabled: true } : null;
 	}
 	const result = Reflect.get(parsed, "result");
 	if (result === true || result === "true") return { authEnabled: true };
@@ -120910,6 +120928,7 @@ var HmIntegrationManager = class {
 	#facade = null;
 	#status = "disconnected";
 	#deviceCount = 0;
+	#namesAvailable = true;
 	#lastCheckedAt = null;
 	#error = null;
 	/** Active event-listener disposers, cleared on stop. */
@@ -120960,7 +120979,8 @@ var HmIntegrationManager = class {
 			info: {
 				host: this.#connection.host,
 				tls: this.#connection.tls,
-				deviceCount: this.#deviceCount
+				deviceCount: this.#deviceCount,
+				namesAvailable: this.#namesAvailable
 			},
 			lastCheckedAt: this.#lastCheckedAt,
 			error: this.#error
@@ -120983,7 +121003,20 @@ var HmIntegrationManager = class {
 		this.#facade = facade;
 		this.#attachListeners(facade);
 		await facade.start();
-		this.#deviceCount = facade.devices().length;
+		const devices = facade.devices();
+		this.#deviceCount = devices.length;
+		this.#namesAvailable = devices.length === 0 || devices.some((d) => (d.name ?? "").length > 0);
+		if (!this.#namesAvailable) {
+			const credentialsSet = this.#connection.username.length > 0;
+			this.#logger.warn("HmIntegrationManager: device names unavailable — devices are listed by address", {
+				tags: { integrationId: this.#id },
+				meta: {
+					devices: devices.length,
+					credentialsSet,
+					hint: credentialsSet ? "WebUI login set but the CCU returned no names; check the username (an empty password is valid on a CCU without WebUI authentication)" : "set a WebUI username (and password if the CCU has one) on the integration"
+				}
+			});
+		}
 		this.#lastCheckedAt = Date.now();
 		this.#status = "connected";
 		this.#error = null;
@@ -121530,10 +121563,6 @@ function buildHomematicConnectionTestProvider(deps) {
 				outcome: "rejected",
 				error: "Some of the connection settings are not valid."
 			};
-			if (connection.username.length > 0 !== connection.password.length > 0) return {
-				outcome: "rejected",
-				error: "Enter both the WebUI username and password, or neither."
-			};
 			const interfaces = enabledInterfaces(connection);
 			if (interfaces.length === 0) return {
 				outcome: "rejected",

package/dist/addon.mjs

@@ -117875,7 +117875,7 @@ var homematicConfigSchema = object({
 	enableBidcosRf: boolean().default(false).describe("Enable Homematic (BidCos-RF)"),
 	enableGroups: boolean().default(true).describe("Enable groups (heating groups / VirtualDevices)"),
 	enableBidcosWired: boolean().default(false).describe("Enable BidCos-Wired (HM-Wired)"),
-	username: string().default("").describe("WebUI username (optional — enables names / rooms / sysvars)"),
+	username: string().default("Admin").describe("WebUI username (optional — enables names / rooms / sysvars)"),
 	password: string().default("").describe("WebUI password (optional)").meta({ secret: true }),
 	callbackHost: string().default("").describe("Address the CCU calls back to for event push (this hub LAN IP)"),
 	callbackPort: preprocess((v) => v === "" || v === null ? void 0 : v, number().int().min(1).max(65535).default(2128)).describe("Local XML-RPC callback server port"),
@@ -117896,11 +117896,12 @@ function enabledInterfaces(config) {
 /**
 * Build the `HomematicOptions` the wrapped library constructor expects
 * from the validated addon config. Pure: same config in → same options
-* out. Credentials are only forwarded when both fields are non-empty so
-* the library skips the JSON-RPC hub layer cleanly when they're absent.
+* out. Credentials are forwarded when a username is set (the password may be
+* empty on a CCU without WebUI authentication); without one the library skips
+* the JSON-RPC hub layer cleanly.
 */
 function toHomematicOptions(config) {
-	const hasCredentials = config.username.length > 0 && config.password.length > 0;
+	const hasCredentials = config.username.length > 0;
 	const callbackHost = config.callbackHost.length > 0 ? config.callbackHost : inferCallbackHost(config.host) ?? "";
 	const interfaces = enabledInterfaces(config);
 	return {
@@ -117947,6 +117948,8 @@ var homematicGatewayDeviceSchema = object({
 	/** The adoption candidate id the device was adopted from. */
 	nativeId: string().min(1)
 });
+/** Why the form asks for credentials; shown first (translated through its `labelKey`). */
+var CREDENTIALS_NOTICE = "Device and room names come from the CCU WebUI. Enter a WebUI user (Admin by default). If the WebUI has no login, leave the password empty. Without a user, devices are listed by their address.";
 /**
 * The integration form: a discovered-CCU picker (filled by the LAN scan), the
 * host, the interfaces, the event callback, the WebUI credentials (the password
@@ -117959,31 +117962,41 @@ function buildConnectionFormSchema() {
 			title: "CCU connection",
 			titleKey: "provider-homematic:connection.s_connection.title",
 			columns: 1,
-			fields: [{
-				type: "addon-action-select",
-				addonId: "provider-homematic",
-				key: "__homematic-discovered",
-				writesKey: "host",
-				omitFromSettings: true,
-				label: "CCU",
-				labelKey: "provider-homematic:connection.s_connection.__homematic-discovered.label",
-				action: "discoverCcu",
-				mapOption: {
-					value: "host",
-					label: "name"
+			fields: [
+				{
+					type: "info",
+					key: "credentialsNotice",
+					label: CREDENTIALS_NOTICE,
+					labelKey: "provider-homematic:connection.s_connection.credentialsNotice.label",
+					content: ""
 				},
-				hideWhenFewerThan: 2,
-				emptyResultsMessage: "No CCU found on the network."
-			}, {
-				type: "text",
-				key: "host",
-				label: "Host / IP",
-				labelKey: "provider-homematic:connection.s_connection.host.label",
-				description: "Filled when one CCU is found. Type the address if it is not.",
-				descriptionKey: "provider-homematic:connection.s_connection.host.description",
-				required: true,
-				placeholder: "192.168.10.50"
-			}]
+				{
+					type: "addon-action-select",
+					addonId: "provider-homematic",
+					key: "__homematic-discovered",
+					writesKey: "host",
+					omitFromSettings: true,
+					label: "CCU",
+					labelKey: "provider-homematic:connection.s_connection.__homematic-discovered.label",
+					action: "discoverCcu",
+					mapOption: {
+						value: "host",
+						label: "name"
+					},
+					hideWhenFewerThan: 2,
+					emptyResultsMessage: "No CCU found on the network."
+				},
+				{
+					type: "text",
+					key: "host",
+					label: "Host / IP",
+					labelKey: "provider-homematic:connection.s_connection.host.label",
+					description: "Filled when one CCU is found. Type the address if it is not.",
+					descriptionKey: "provider-homematic:connection.s_connection.host.description",
+					required: true,
+					placeholder: "192.168.10.50"
+				}
+			]
 		},
 		{
 			id: "interfaces",
@@ -118057,7 +118070,8 @@ function buildConnectionFormSchema() {
 				type: "text",
 				key: "username",
 				label: "Username",
-				labelKey: "provider-homematic:connection.s_credentials.username.label"
+				labelKey: "provider-homematic:connection.s_credentials.username.label",
+				default: "Admin"
 			}, {
 				type: "password",
 				key: "password",
@@ -120781,6 +120795,10 @@ var HOMEMATIC_DISCOVERY_MODES = [{
 	tls: false,
 	acceptStatus: [200]
 }];
+/** A JSON-RPC reply: it echoes `version` or `id`, and carries a `result` and an `error` member. */
+function isJsonRpcEnvelope(parsed) {
+	return (Reflect.has(parsed, "version") || Reflect.has(parsed, "id")) && Reflect.has(parsed, "result") && Reflect.has(parsed, "error");
+}
 /**
 * Read the answer of `CCU.getAuthEnabled`, the question the WebUI asks before
 * it shows a login. A CCU answers a boolean; one that already requires a login
@@ -120800,7 +120818,7 @@ function parseAuthEnabledAnswer(status, text) {
 		if (typeof error !== "object") return null;
 		const message = Reflect.get(error, "message");
 		const code = Reflect.get(error, "code");
-		return typeof message === "string" && message.toLowerCase().startsWith("access denied") || code === 401 || code === -32001 ? { authEnabled: true } : null;
+		return typeof message === "string" && message.toLowerCase().startsWith("access denied") || code === 401 || code === -32001 || isJsonRpcEnvelope(parsed) ? { authEnabled: true } : null;
 	}
 	const result = Reflect.get(parsed, "result");
 	if (result === true || result === "true") return { authEnabled: true };
@@ -120911,6 +120929,7 @@ var HmIntegrationManager = class {
 	#facade = null;
 	#status = "disconnected";
 	#deviceCount = 0;
+	#namesAvailable = true;
 	#lastCheckedAt = null;
 	#error = null;
 	/** Active event-listener disposers, cleared on stop. */
@@ -120961,7 +120980,8 @@ var HmIntegrationManager = class {
 			info: {
 				host: this.#connection.host,
 				tls: this.#connection.tls,
-				deviceCount: this.#deviceCount
+				deviceCount: this.#deviceCount,
+				namesAvailable: this.#namesAvailable
 			},
 			lastCheckedAt: this.#lastCheckedAt,
 			error: this.#error
@@ -120984,7 +121004,20 @@ var HmIntegrationManager = class {
 		this.#facade = facade;
 		this.#attachListeners(facade);
 		await facade.start();
-		this.#deviceCount = facade.devices().length;
+		const devices = facade.devices();
+		this.#deviceCount = devices.length;
+		this.#namesAvailable = devices.length === 0 || devices.some((d) => (d.name ?? "").length > 0);
+		if (!this.#namesAvailable) {
+			const credentialsSet = this.#connection.username.length > 0;
+			this.#logger.warn("HmIntegrationManager: device names unavailable — devices are listed by address", {
+				tags: { integrationId: this.#id },
+				meta: {
+					devices: devices.length,
+					credentialsSet,
+					hint: credentialsSet ? "WebUI login set but the CCU returned no names; check the username (an empty password is valid on a CCU without WebUI authentication)" : "set a WebUI username (and password if the CCU has one) on the integration"
+				}
+			});
+		}
 		this.#lastCheckedAt = Date.now();
 		this.#status = "connected";
 		this.#error = null;
@@ -121531,10 +121564,6 @@ function buildHomematicConnectionTestProvider(deps) {
 				outcome: "rejected",
 				error: "Some of the connection settings are not valid."
 			};
-			if (connection.username.length > 0 !== connection.password.length > 0) return {
-				outcome: "rejected",
-				error: "Enter both the WebUI username and password, or neither."
-			};
 			const interfaces = enabledInterfaces(connection);
 			if (interfaces.length === 0) return {
 				outcome: "rejected",

package/i18n/en.json

@@ -1,5 +1,6 @@
 {
   "connection.s_connection.title": "CCU connection",
+  "connection.s_connection.credentialsNotice.label": "Device and room names come from the CCU WebUI. Enter a WebUI user (Admin by default). If the WebUI has no login, leave the password empty. Without a user, devices are listed by their address.",
   "connection.s_connection.__homematic-discovered.label": "CCU",
   "connection.s_connection.host.label": "Host / IP",
   "connection.s_connection.host.description": "Filled when one CCU is found. Type the address if it is not.",

package/i18n/it.json

@@ -1,5 +1,6 @@
 {
   "connection.s_connection.title": "Connessione alla CCU",
+  "connection.s_connection.credentialsNotice.label": "I nomi di dispositivi e stanze provengono dalla WebUI della CCU. Inserisci un utente della WebUI (Admin per impostazione predefinita). Se la WebUI non richiede login, lascia vuota la password. Senza un utente, i dispositivi vengono elencati per indirizzo.",
   "connection.s_connection.__homematic-discovered.label": "CCU",
   "connection.s_connection.host.label": "Host / IP",
   "connection.s_connection.host.description": "Compilato quando viene trovata una CCU. Digita l'indirizzo se non viene trovata.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-provider-homematic",
-  "version": "1.2.171",
+  "version": "1.2.173",
   "description": "Homematic / HomematicIP (CCU3 / RaspberryMatic) device-provider addon for CamStack — wraps the nodehomematic library",
   "keywords": [
     "camstack",