@camstack/addon-provider-homematic 1.2.171 → 1.2.172

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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

@@ -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 {
@@ -120780,6 +120781,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 +120804,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 +120915,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 +120966,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 +120990,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;

package/dist/addon.mjs

@@ -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 {
@@ -120781,6 +120782,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 +120805,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 +120916,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 +120967,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 +120991,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;

package/package.json

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