node-red-contrib-knx-ultimate 6.3.3 → 6.3.4

package/CHANGELOG.md

@@ -6,9 +6,9 @@
 
 # CHANGELOG
 
-**Version 6.3.3** - August 2026<br/>
+**Version 6.3.4** - August 2026<br/>
 
-- **HUE Controller**: fixed grouped-light editors opening without mapping tabs or an active Locate button. Editor errors now show a localized Node-RED error message.<br/>
+- **HUE Controller**: fixed missing Light mapping tabs and false-success Locate requests. Editor and Locate failures now show a red Node-RED message.<br/>
 
 **Version 6.3.2** - August 2026<br/>
 

package/nodes/hue-config.js

@@ -103,22 +103,33 @@ module.exports = (RED) => {
       }
 
       session.runIdentify = async (label = 'interval') => {
-        if (session.inFlight) return
-        if (!node.hueManager || !node.hueManager.hueApiV2 || typeof node.hueManager.hueApiV2.put !== 'function') return
-        if (node.linkStatus !== 'connected') return
+        if (session.inFlight) return { attempted: 0, succeeded: 0, lastError: null }
+        if (!node.hueManager || !node.hueManager.hueApiV2 || typeof node.hueManager.hueApiV2.put !== 'function') {
+          return { attempted: 0, succeeded: 0, lastError: new Error('Hue bridge not ready') }
+        }
+        if (node.linkStatus !== 'connected') {
+          return { attempted: 0, succeeded: 0, lastError: new Error('Hue bridge is not connected') }
+        }
         session.inFlight = true
+        let attempted = 0
+        let succeeded = 0
+        let lastError = null
         try {
           for (const target of session.targets) {
             if (!target || !target.id || !target.type) continue
+            attempted += 1
             try {
               await node.hueManager.hueApiV2.put(`/resource/${target.type}/${target.id}`, { identify: { action: 'identify' } })
+              succeeded += 1
             } catch (error) {
+              lastError = error
               node.sysLogger?.warn(`Hue identify ${target.type}:${target.id} failed (${label}): ${error.message}`)
             }
           }
         } finally {
           session.inFlight = false
         }
+        return { attempted, succeeded, lastError }
       }
 
       session.intervalHandle = setInterval(() => {
@@ -129,7 +140,12 @@ module.exports = (RED) => {
       }, resolvedDuration)
 
       node.activeHueIdentifySessions.set(sessionKey, session)
-      await session.runIdentify('initial')
+      const initialResult = await session.runIdentify('initial')
+      if (!initialResult || initialResult.succeeded === 0) {
+        node.stopHueIdentifySession(sessionKey, 'initial-error')
+        if (initialResult?.lastError) throw initialResult.lastError
+        return false
+      }
       return true
     }
 

package/nodes/knxUltimateHueController.html

@@ -617,12 +617,19 @@
 
           const updateControllerKnxVisibility = () => {
             // Node-RED has used several sentinel values for an empty config-node
-            // selector. Normalize them before deciding whether KNX rows exist.
+            // selector. During editor bootstrap the DOM can temporarily expose
+            // one of them even though the node has a persisted gateway, so use
+            // the stored reference as a fallback before hiding the Light tabs.
             const serverValue = $('#node-input-server').val();
             const normalizedServerValue = serverValue === undefined || serverValue === null
               ? ''
               : String(serverValue).trim().toLowerCase();
-            const knxDisabled = KNX_EMPTY_SERVER_VALUES.has(normalizedServerValue);
+            const storedServerValue = controllerNode.server === undefined || controllerNode.server === null
+              ? ''
+              : String(controllerNode.server).trim().toLowerCase();
+            const hasDomServer = !KNX_EMPTY_SERVER_VALUES.has(normalizedServerValue);
+            const hasStoredServer = !KNX_EMPTY_SERVER_VALUES.has(storedServerValue);
+            const knxDisabled = !hasDomServer && !hasStoredServer;
             $container.toggleClass('hue-controller-no-knx', knxDisabled);
           };
           updateControllerKnxVisibility();
@@ -821,7 +828,7 @@ For a single light, the **Dim**, **Tunable White**, **RGB/HSV**, and native-effe
 
 While the Hue Bridge is still loading its resources, the Light editor displays a spinning hourglass and polls readiness every 500 ms. The wait is bounded: after about 10 seconds the editor is released, the mapping tabs remain hidden, and a localized error asks you to check the bridge configuration, deploy, and retry. Closing, saving, or changing function always cancels the pending timer.
 
-Locate and the Light mapping container initialize before optional Effects and tab widgets. If a browser-side editor step fails, a fixed Node-RED error message shows the failing stage and technical detail; Locate remains responsive and the mapping container is not left silently blank.
+Locate and the Light mapping container initialize before optional Effects and tab widgets. A saved KNX gateway remains valid if Node-RED temporarily exposes an empty selector while the editor starts. Browser-side failures and a rejected initial Locate command produce a fixed red Node-RED error with the technical detail instead of leaving the editor silent.
 
 Changing the selected **Hue device** automatically changes the detected **Device type**, visible editor and node pin layout. After saving, reopen the node to verify the selected resource and mappings.
 

package/nodes/locales/de/knxUltimateHueController.html

@@ -9,7 +9,7 @@
 <p>Wenn kein <strong>KNX-Gateway</strong> ausgewählt ist (einschließlich <code>none</code> und <em>Neu hinzufügen...</em>), werden die KNX-Zuordnungsfelder ausgeblendet; die Auswahl der Hue-Ressource und reine Flow-Optionen bleiben verfügbar.</p>
 <p>Bei einer einzelnen Leuchte richten sich die Bereiche <strong>Dimmen</strong>, <strong>Abstimmbares Weiß</strong>, <strong>RGB/HSV</strong> und native Effekte nach den Live-Fähigkeiten der ausgewählten Hue-API-v2-Ressource. Die zugehörigen KNX-Zuordnungen erscheinen automatisch, wenn die Leuchte <code>dimming</code>, <code>color_temperature</code> oder <code>color</code> bereitstellt.</p>
 <p>Während die Hue Bridge ihre Ressourcen lädt, zeigt der Leuchteneditor eine animierte Sanduhr und prüft die Bereitschaft alle 500 ms. Nach etwa 10 Sekunden wird der Editor freigegeben, die Zuordnungsregister bleiben verborgen und ein lokalisierter Fehler wird angezeigt. Speichern, Schließen oder ein Funktionswechsel beendet die ausstehende Wartezeit.</p>
-<p>Locate und der Leuchten-Zuordnungsbereich werden vor den optionalen Effekt- und Register-Widgets initialisiert. Schlägt ein browserseitiger Editorschritt fehl, zeigt eine feste Node-RED-Fehlermeldung die Phase und das technische Detail; Locate bleibt bedienbar und der Zuordnungsbereich bleibt nicht ohne Erklärung leer.</p>
+<p>Locate und der Leuchten-Zuordnungsbereich werden vor den optionalen Effekt- und Register-Widgets initialisiert. Ein gespeichertes KNX-Gateway bleibt gültig, wenn Node-RED beim Start des Editors vorübergehend einen leeren Selektor anzeigt. Browserseitige Fehler und ein abgewiesener erster Locate-Befehl erzeugen eine feste rote Node-RED-Fehlermeldung mit dem technischen Detail, statt den Editor still zu lassen.</p>
 <p>Wenn ein Gateway ausgewählt ist, akzeptieren die Zuordnungsfelder eine KNX-Gruppenadresse oder einen importierten ETS-Namen; passende Datenpunkte werden von diesem Gateway geladen.</p>
 <p>Der Migrationsbutton wird nur angezeigt, wenn der Node-RED-Editor mindestens einen Legacy-HUE-Knoten in den aktuellen Flows erkennt. Derselbe kontrastreiche orange Button mit weißer Beschriftung steht unter dem Deprecated-Hinweis in jedem Legacy-HUE-Editor bereit.</p>
 <p><strong>Legacy-HUE-Knoten konvertieren</strong> führt die gesamte Konvertierung im Browser aus und sendet keinerlei Flow- oder Knotendaten. Nach erfolgreicher lokaler Konvertierung öffnet der Browser nur einen bearbeitbaren E-Mail-Entwurf an den Autor, ohne Node-RED zu verlassen. Der Entwurf enthält nur die Anzahl konvertierter Knoten und Platz für optionale Hinweise und wird niemals automatisch gesendet. Die abschließende Node-RED-Meldung bietet eine optionale Unterstützungsschaltfläche; die Spendenseite öffnet sich nur nach einem Klick darauf.</p>

package/nodes/locales/en/knxUltimateHueController.html

@@ -9,7 +9,7 @@
 <p>When no <strong>KNX Gateway</strong> is selected (including <code>none</code> and <em>Add new...</em>), KNX mapping fields are hidden while Hue resource selection and flow-only options remain available.</p>
 <p>For a single light, the <strong>Dim</strong>, <strong>Tunable White</strong>, <strong>RGB/HSV</strong>, and native-effects sections follow the live capabilities reported by the selected Hue API v2 resource. The corresponding KNX mappings appear automatically when the light exposes <code>dimming</code>, <code>color_temperature</code>, or <code>color</code>.</p>
 <p>While the Hue Bridge is loading its resources, the Light editor shows a spinning hourglass and checks readiness every 500 ms. After about 10 seconds it releases the editor, keeps the mapping tabs hidden and reports a localized error. Saving, closing or changing function cancels the pending wait.</p>
-<p>Locate and the Light mapping container initialize before optional Effects and tab widgets. If a browser-side editor step fails, a fixed Node-RED error message shows the failing stage and technical detail; Locate remains responsive and the mapping container is not left silently blank.</p>
+<p>Locate and the Light mapping container initialize before optional Effects and tab widgets. A saved KNX gateway remains valid if Node-RED temporarily exposes an empty selector while the editor starts. Browser-side failures and a rejected initial Locate command produce a fixed red Node-RED error with the technical detail instead of leaving the editor silent.</p>
 <p>When a gateway is selected, mapping fields accept a KNX group address or an imported ETS name; matching datapoints are loaded from that gateway.</p>
 <p>The migration button is shown only when the Node-RED editor detects at least one legacy HUE node in the current flows. The same high-contrast orange button with white text is available below the deprecation notice in every legacy HUE editor.</p>
 <p><strong>Convert legacy HUE nodes</strong> performs the entire conversion in the browser and sends no flow or node data anywhere. After a successful local conversion, the browser opens only an editable email draft addressed to the author without navigating away from Node-RED. The draft contains only the number of converted nodes and space for optional notes, and is never sent automatically. The final Node-RED message offers an optional support button; the donation page opens only when that button is clicked.</p>

package/nodes/locales/es/knxUltimateHueController.html

@@ -9,7 +9,7 @@
 <p>Cuando no hay ningún <strong>Gateway KNX</strong> seleccionado (incluidos <code>none</code> y <em>Añadir nuevo...</em>), se ocultan los campos de mapeo KNX; la selección del recurso Hue y las opciones exclusivas del flujo siguen disponibles.</p>
 <p>Para una luz individual, las secciones <strong>Regulación</strong>, <strong>Blanco regulable</strong>, <strong>RGB/HSV</strong> y efectos nativos siguen las capacidades en vivo declaradas por el recurso Hue API v2 seleccionado. Los mapeos KNX correspondientes aparecen automáticamente cuando la luz expone <code>dimming</code>, <code>color_temperature</code> o <code>color</code>.</p>
 <p>Mientras Hue Bridge carga sus recursos, el editor de Luz muestra un reloj de arena animado y comprueba su disponibilidad cada 500 ms. Después de unos 10 segundos libera el editor, mantiene ocultas las pestañas de mapeo y muestra un error localizado. Guardar, cerrar o cambiar de función cancela la espera pendiente.</p>
-<p>Locate y el contenedor de mapeo de Luz se inicializan antes que los widgets opcionales de Efectos y pestañas. Si falla una fase del editor en el navegador, un mensaje de error fijo de Node-RED muestra la fase y el detalle técnico; Locate sigue respondiendo y el área de mapeo no queda vacía sin explicación.</p>
+<p>Locate y el contenedor de mapeo de Luz se inicializan antes que los widgets opcionales de Efectos y pestañas. Un gateway KNX guardado sigue siendo válido si Node-RED muestra temporalmente un selector vacío al iniciar el editor. Los fallos del navegador y un primer comando Locate rechazado generan un error rojo fijo de Node-RED con el detalle técnico, en lugar de dejar el editor en silencio.</p>
 <p>Cuando hay un gateway seleccionado, los campos de mapeo aceptan una dirección de grupo KNX o un nombre importado de ETS; los datapoints compatibles se cargan desde ese gateway.</p>
 <p>El botón de migración solo aparece cuando el editor de Node-RED detecta al menos un nodo HUE legacy en los flujos actuales. El mismo botón naranja de alto contraste con texto blanco está disponible bajo el aviso de obsolescencia de cada editor HUE legacy.</p>
 <p><strong>Convertir nodos HUE legacy</strong> realiza toda la conversión en el navegador y no envía ningún dato del flujo ni de los nodos. Tras una conversión local correcta, el navegador solo abre un borrador de correo editable dirigido al autor sin abandonar Node-RED. El borrador contiene únicamente el número de nodos convertidos y espacio para notas opcionales y nunca se envía automáticamente. El mensaje final de Node-RED ofrece un botón de apoyo opcional; la página de donación solo se abre al pulsarlo.</p>

package/nodes/locales/fr/knxUltimateHueController.html

@@ -9,7 +9,7 @@
 <p>Lorsqu'aucune <strong>Passerelle KNX</strong> n'est sélectionnée (y compris <code>none</code> et <em>Ajouter...</em>), les champs de mappage KNX sont masqués ; la sélection de la ressource Hue et les options réservées au flow restent disponibles.</p>
 <p>Pour une lampe individuelle, les sections <strong>Variation</strong>, <strong>Blanc réglable</strong>, <strong>RGB/HSV</strong> et effets natifs suivent les capacités live déclarées par la ressource Hue API v2 sélectionnée. Les mappages KNX correspondants apparaissent automatiquement lorsque la lampe expose <code>dimming</code>, <code>color_temperature</code> ou <code>color</code>.</p>
 <p>Pendant que le Hue Bridge charge ses ressources, l'éditeur Lampe affiche un sablier animé et vérifie sa disponibilité toutes les 500 ms. Après environ 10 secondes, l'éditeur est libéré, les onglets de mappage restent masqués et une erreur localisée est affichée. L'enregistrement, la fermeture ou le changement de fonction annule l'attente en cours.</p>
-<p>Locate et le conteneur de mappage Lampe sont initialisés avant les widgets facultatifs Effets et onglets. Si une étape de l'éditeur dans le navigateur échoue, un message d'erreur Node-RED fixe indique l'étape et le détail technique ; Locate reste opérationnel et la zone de mappage ne demeure pas vide sans explication.</p>
+<p>Locate et le conteneur de mappage Lampe sont initialisés avant les widgets facultatifs Effets et onglets. Une passerelle KNX enregistrée reste valide si Node-RED affiche temporairement un sélecteur vide au démarrage de l'éditeur. Les erreurs du navigateur et le rejet de la première commande Locate produisent une erreur Node-RED rouge et fixe avec le détail technique, au lieu de laisser l'éditeur silencieux.</p>
 <p>Lorsqu'une passerelle est sélectionnée, les champs de mappage acceptent une adresse de groupe KNX ou un nom importé d'ETS ; les datapoints compatibles sont chargés depuis cette passerelle.</p>
 <p>Le bouton de migration apparaît uniquement lorsque l'éditeur Node-RED détecte au moins un nœud HUE legacy dans les flows actuels. Le même bouton orange à contraste élevé avec texte blanc est disponible sous l'avis d'obsolescence de chaque éditeur HUE legacy.</p>
 <p><strong>Convertir les nœuds HUE legacy</strong> effectue toute la conversion dans le navigateur et n'envoie aucune donnée de flow ou de nœud. Après une conversion locale réussie, le navigateur ouvre uniquement un brouillon d'e-mail modifiable adressé à l'auteur sans quitter Node-RED. Le brouillon contient uniquement le nombre de nœuds convertis et un espace pour des notes facultatives et n'est jamais envoyé automatiquement. Le message Node-RED final propose un bouton de soutien facultatif ; la page de don ne s'ouvre qu'après un clic sur ce bouton.</p>

package/nodes/locales/it/knxUltimateHueController.html

@@ -9,7 +9,7 @@
 <p>Quando non è selezionato alcun <strong>Gateway KNX</strong> (inclusi <code>none</code> e <em>Aggiungi nuovo...</em>), i campi di mappatura KNX vengono nascosti, mentre la selezione della risorsa Hue e le opzioni per il solo flow restano disponibili.</p>
 <p>Per una luce singola, le sezioni <strong>Dimmer</strong>, <strong>Bianco regolabile</strong>, <strong>RGB/HSV</strong> ed effetti nativi seguono le capacità live dichiarate dalla risorsa Hue API v2 selezionata. Le relative mappature KNX appaiono automaticamente quando la luce espone <code>dimming</code>, <code>color_temperature</code> o <code>color</code>.</p>
 <p>Mentre Hue Bridge carica le proprie risorse, l'editor Luce mostra una clessidra animata e ne controlla la disponibilità ogni 500 ms. Dopo circa 10 secondi libera comunque l'editor, mantiene nascoste le schede di mappatura e segnala un errore localizzato. Salvataggio, chiusura o cambio funzione annullano l'attesa pendente.</p>
-<p>Locate e il contenitore delle mappature Luce vengono inizializzati prima dei widget opzionali Effetti e schede. Se una fase dell'editor nel browser fallisce, un messaggio di errore Node-RED fisso mostra la fase e il dettaglio tecnico; Locate resta attivo e l'area delle mappature non rimane vuota senza spiegazioni.</p>
+<p>Locate e il contenitore delle mappature Luce vengono inizializzati prima dei widget opzionali Effetti e schede. Un gateway KNX salvato resta valido se Node-RED mostra temporaneamente un selettore vuoto durante l'avvio dell'editor. Gli errori del browser e il rifiuto del primo comando Locate producono un errore Node-RED rosso e fisso con il dettaglio tecnico, invece di lasciare l'editor silenzioso.</p>
 <p>Quando è selezionato un gateway, nei campi di mappatura puoi digitare un indirizzo di gruppo KNX o un nome importato da ETS; i datapoint compatibili vengono caricati da quel gateway.</p>
 <p>Il pulsante di migrazione compare solo quando l'editor Node-RED rileva almeno un nodo HUE legacy nei flow correnti. Lo stesso pulsante arancione ad alto contrasto con testo bianco è disponibile sotto l'avviso di deprecazione in ogni editor HUE legacy.</p>
 <p><strong>Converti nodi HUE legacy</strong> esegue l'intera conversione nel browser e non invia alcun dato del flow o dei nodi. Dopo la conversione locale, il browser apre soltanto una bozza email modificabile indirizzata all'autore senza abbandonare Node-RED. La bozza contiene soltanto il numero dei nodi convertiti e uno spazio per note facoltative e non viene mai spedita automaticamente. Il messaggio finale di Node-RED propone un pulsante facoltativo per sostenere il progetto; la pagina per la donazione si apre solo premendo quel pulsante.</p>

package/nodes/locales/zh-CN/knxUltimateHueController.html

@@ -9,7 +9,7 @@
 <p>未选择<strong>KNX 网关</strong>时（包括 <code>none</code> 和“新增...”），KNX 映射字段会隐藏，而 Hue 资源选择和仅用于流程的选项仍然可用。</p>
 <p>对于单灯，<strong>调光</strong>、<strong>可调白光</strong>、<strong>RGB/HSV</strong> 和原生效果部分会根据所选 Hue API v2 资源实时报告的能力显示。当灯具提供 <code>dimming</code>、<code>color_temperature</code> 或 <code>color</code> 时，相应的 KNX 映射会自动出现。</p>
 <p>Hue Bridge 加载资源期间，灯光编辑器会显示旋转的沙漏，并每 500 毫秒检查一次就绪状态。约 10 秒后编辑器会解除等待，映射选项卡保持隐藏，并显示本地化错误。保存、关闭或切换功能都会取消尚未结束的等待。</p>
-<p>Locate 和灯光映射容器会先于可选的效果与选项卡控件初始化。如果浏览器端编辑器的某个阶段失败，Node-RED 会显示固定错误消息，其中包含失败阶段和技术详情；Locate 仍可操作，映射区域也不会在没有说明的情况下保持空白。</p>
+<p>Locate 和灯光映射容器会先于可选的效果与选项卡控件初始化。如果编辑器启动时 Node-RED 暂时显示空的网关选择值，已保存的 KNX 网关仍保持有效。浏览器端错误或首次 Locate 命令被拒绝时，Node-RED 会显示固定的红色错误消息和技术详情，而不会让编辑器无提示地保持沉默。</p>
 <p>选择网关后，映射字段可输入 KNX 组地址或从 ETS 导入的名称；兼容的数据点会从该网关加载。</p>
 <p>仅当 Node-RED 编辑器在当前流程中检测到至少一个旧版 HUE 节点时，才会显示迁移按钮。每个旧版 HUE 编辑器的弃用提示下方也提供带白色文字的相同高对比度橙色按钮。</p>
 <p><strong>转换旧版 HUE 节点</strong>会完全在浏览器中完成转换，不会发送任何流程或节点数据。成功完成本地转换后，浏览器只会打开一封发给作者的可编辑邮件草稿，而不会离开 Node-RED。草稿只包含已转换节点数量和可选备注空间，绝不会自动发送。最终的 Node-RED 消息会提供一个可选的支持按钮；只有点击该按钮时才会打开捐赠页面。</p>

package/package.json

@@ -3,7 +3,7 @@
   "engines": {
     "node": ">=20.18.1"
   },
-  "version": "6.3.3",
+  "version": "6.3.4",
   "description": "KNX Ultimate is the most advanced KNX integration for Node-RED, providing secure KNX/IP communication, routing, ETS project import, Philips Hue, Matter Controller and Matter Bridge (control matter device via KNX and expose KNX GA via Matter), MQTT, diagnostics with AI, virtual devices, and powerful automation nodes. Build professional, reliable, and scalable smart home and building automation projects with minimal effort.",
   "files": [
     "nodes/",
@@ -149,4 +149,4 @@
     "vite": "^7.3.6",
     "vue": "^3.5.41"
   }
-}
+}

package/resources/hueControllerProfiles.js

@@ -259,7 +259,7 @@
               function onEditPrepare() {
                 ensureVerticalTabsStyle();
                 const $knxServerInput = $("#node-input-server");
-                const KNX_EMPTY_VALUES = new Set(['', 'none', '_ADD_', '__NONE__']);
+                const KNX_EMPTY_VALUES = new Set(['', 'none', '_add_', '__none__']);
                 const $hueServerInput = $("#node-input-serverHue");
                 const $hueDeviceInput = $("#node-input-hueDevice");
                 const $deviceNameInput = $("#node-input-name");
@@ -471,7 +471,7 @@
                     updateLocateButtonState(false);
                     clearLocateAutoReset();
                     if (!silent) {
-                      RED.notify(message || (node._('knxUltimateHueLight.locate_error') || 'Unable to locate Hue device'), 'error');
+                      RED.notify(message || (node._('knxUltimateHueLight.locate_error') || 'Unable to locate Hue device'), { type: 'error', fixed: true });
                     }
                   }).always(() => {
                     locatePendingRequest = null;
@@ -495,19 +495,19 @@
 
                 const resolveKnxServerValue = () => {
                   const domValue = $knxServerInput.val();
-                  if (domValue !== undefined && domValue !== null && domValue !== '') {
-                    return domValue;
+                  if (domValue !== undefined && domValue !== null) {
+                    const normalized = String(domValue).trim();
+                    if (!KNX_EMPTY_VALUES.has(normalized.toLowerCase())) return normalized;
                   }
                   if (node.server !== undefined && node.server !== null) {
-                    return node.server;
+                    const stored = String(node.server).trim();
+                    if (!KNX_EMPTY_VALUES.has(stored.toLowerCase())) return stored;
                   }
                   return '';
                 };
 
                 const hasKnxServerSelected = () => {
-                  const val = resolveKnxServerValue();
-                  if (val === undefined || val === null) return false;
-                  return !KNX_EMPTY_VALUES.has(val);
+                  return resolveKnxServerValue() !== '';
                 };
 
                 const $tabs = $("#tabs");