@camstack/addon-provider-homematic 1.2.172 → 1.2.173

package/CHANGELOG.md

@@ -7,6 +7,12 @@ 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

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"),
@@ -117947,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
@@ -117959,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",
@@ -118057,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",
@@ -121550,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"),
@@ -117948,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
@@ -117960,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",
@@ -118058,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",
@@ -121551,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.172",
+  "version": "1.2.173",
   "description": "Homematic / HomematicIP (CCU3 / RaspberryMatic) device-provider addon for CamStack — wraps the nodehomematic library",
   "keywords": [
     "camstack",