node-red-contrib-knx-ultimate 4.1.33 → 4.1.34

package/CHANGELOG.md

@@ -6,6 +6,11 @@
 
 # CHANGELOG
 
+**Version 4.1.34** - March 2026<br/>
+
+- FIX: **KNX Hue Light** grouped light handling: when a `grouped_light` is OFF and receives color / color temperature / gradient commands, the node now presets supported member `light` resources first and only then turns the group ON, so all lamps can inherit the requested state more reliably.<br/>
+- DEBUG: **KNX Hue Light** added debug traces for the new grouped-light preset-before-ON sequence.<br/>
+
 **Version 4.1.33** - March 2026<br/>
 
 - FIX: **KNX Hue Light** grouped light handling: when a `grouped_light` is OFF, writes for dimming, color temperature, color/xy and related dynamic updates are now fanned out to the member `light` resources when needed, instead of relying only on the grouped resource.<br/>

package/nodes/knxUltimateHueLight.js

@@ -160,10 +160,13 @@ module.exports = function (RED) {
       const defaultOperation = node.isGrouped_light === false ? "setLight" : "setGroupedLight";
       const isGroupedLightOff = node.isGrouped_light === true && node.currentHUEDevice?.on?.on === false;
       const stateKeys = _state && typeof _state === "object" ? Object.keys(_state) : [];
-      const actionableKeys = ["dimming", "color", "color_temperature", "gradient"];
+      const presetKeys = ["color", "color_temperature", "gradient"];
+      const actionableKeys = ["dimming", ...presetKeys];
       const hasActionablePayload = stateKeys.some((key) => actionableKeys.includes(key));
+      const mustPresetGroupedLightChildren = isGroupedLightOff
+        && stateKeys.some((key) => presetKeys.includes(key));
 
-      if (!isGroupedLightOff || !hasActionablePayload) {
+      if (!mustPresetGroupedLightChildren) {
         node.serverHue.hueManager.writeHueQueueAdd(node.hueDevice, _state, defaultOperation);
         return;
       }
@@ -171,6 +174,7 @@ module.exports = function (RED) {
       (async () => {
         try {
           const groupLights = await node.serverHue.getAllLightsBelongingToTheGroup(node.hueDevice, false);
+          RED.log.debug(`knxUltimateHueLight: preset grouped_light children before group on. Group=${node.hueDevice} lights=${Array.isArray(groupLights) ? groupLights.length : 0}`);
           let hasWrittenAtLeastOneLight = false;
           for (let index = 0; index < groupLights.length; index++) {
             const light = groupLights[index];
@@ -178,9 +182,6 @@ module.exports = function (RED) {
             const lightState = {};
             let hasActionableStateForLight = false;
 
-            if (_state.on !== undefined) lightState.on = cloneDeep(_state.on);
-            if (_state.dynamics !== undefined) lightState.dynamics = cloneDeep(_state.dynamics);
-
             if (_state.dimming !== undefined && light.dimming !== undefined) {
               lightState.dimming = cloneDeep(_state.dimming);
               hasActionableStateForLight = true;
@@ -203,9 +204,17 @@ module.exports = function (RED) {
             hasWrittenAtLeastOneLight = true;
           }
 
-          if (!hasWrittenAtLeastOneLight) {
+          if (!hasWrittenAtLeastOneLight || !hasActionablePayload) {
             node.serverHue.hueManager.writeHueQueueAdd(node.hueDevice, _state, defaultOperation);
+            return;
           }
+
+          if (_state?.on?.on !== true) return;
+
+          const groupedLightState = { on: cloneDeep(_state.on) };
+          if (_state.dynamics !== undefined) groupedLightState.dynamics = cloneDeep(_state.dynamics);
+          RED.log.debug(`knxUltimateHueLight: turning on grouped_light after children preset. Group=${node.hueDevice}`);
+          node.serverHue.hueManager.writeHueQueueAdd(node.hueDevice, groupedLightState, defaultOperation);
         } catch (error) {
           RED.log.debug(`knxUltimateHueLight: node.writeHueState fallback to grouped_light write: ${error.message}`);
           node.serverHue.hueManager.writeHueQueueAdd(node.hueDevice, _state, defaultOperation);

package/package.json

@@ -3,7 +3,7 @@
   "engines": {
     "node": ">=20.18.1"
   },
-  "version": "4.1.33",
+  "version": "4.1.34",
   "description": "Control your KNX and KNX Secure intallation via Node-Red! A bunch of KNX nodes, with integrated Philips HUE control, ETS group address importer, and KNX routing between interfaces. Easy to use and highly configurable.",
   "files": [
     "nodes/",