node-red-contrib-knx-ultimate 4.3.23 → 4.3.24

package/CHANGELOG.md

@@ -6,6 +6,10 @@
 
 # CHANGELOG
 
+**Version 4.3.24** - June 2026<br/>
+
+- Hue **Contact Sensor** and **Motion** nodes: fixed the state on the KNX bus getting stuck on a wrong value (e.g. a contact sensor showing **closed** while the door stayed open) after the Hue event-stream reconnected. The nodes now re-publish the authoritative state at startup and after every (re)connection, and ignore stale/out-of-order reports by checking the `contact_report.changed` / `motion_report.changed` timestamp. Closes [#514](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/issues/514).<br/>
+
 **Version 4.3.23** - June 2026<br/>
 
 - Hue nodes: fixed the **help text** not appearing in the editor sidebar when selecting a node. The help is now declared inline in each node's main HTML file (sidebar reads help from there; the `locales/` files keep providing translations). Affected nodes: Light/Outlet, Area Motion, Battery, Button, Contact Sensor, Light Sensor, Motion, Scene, Tap Dial, Temperature Sensor, Zigbee Connectivity and Device Software Update. Also closed an unterminated template `<script>` tag in the Hue Light node.<br/>

package/nodes/knxUltimateHueContactSensor.js

@@ -23,7 +23,13 @@ module.exports = function (RED) {
     node.formatnegativevalue = 'leave'
     node.formatdecimalsvalue = 2
     node.hueDevice = config.hueDevice
-    node.initializingAtStart = false
+    // Re-publish the authoritative contact state at startup and after every event-stream
+    // (re)connection. Without this, any contact_report event missed during an SSE reconnect
+    // gap leaves KNX stuck on the last value seen (see issue #514).
+    node.initializingAtStart = (config.readStatusAtStartup === undefined || config.readStatusAtStartup === 'yes')
+    // Timestamp (ms) of the last contact_report.changed we already applied to KNX. Used to
+    // ignore stale/out-of-order reports (e.g. replays after a reconnect).
+    node.lastContactChangedTs = undefined
 
     const pushStatus = (status) => {
       if (!status) return
@@ -94,6 +100,18 @@ module.exports = function (RED) {
             return
           }
 
+          // contact_report.state is always the real current state (per Hue API v2), and
+          // contact_report.changed is when it last changed. Ignore reports that are not newer
+          // than the last one applied, so stale/replayed events after an SSE reconnect can't
+          // flip KNX to a wrong state (issue #514).
+          const changedTs = _event.contact_report.changed !== undefined ? new Date(_event.contact_report.changed).getTime() : NaN
+          if (!Number.isNaN(changedTs)) {
+            if (node.lastContactChangedTs !== undefined && changedTs <= node.lastContactChangedTs) {
+              return
+            }
+            node.lastContactChangedTs = changedTs
+          }
+
           const knxMsgPayload = {}
           knxMsgPayload.topic = config.GAcontact
           knxMsgPayload.dpt = config.dptcontact

package/nodes/knxUltimateHueMotion.js

@@ -23,7 +23,13 @@ module.exports = function (RED) {
     node.formatnegativevalue = 'leave'
     node.formatdecimalsvalue = 2
     node.hueDevice = config.hueDevice
-    node.initializingAtStart = false
+    // Re-publish the authoritative motion state at startup and after every event-stream
+    // (re)connection, so events missed during an SSE reconnect gap don't leave KNX stuck
+    // on a wrong value (same root cause as the contact sensor, issue #514).
+    node.initializingAtStart = (config.readStatusAtStartup === undefined || config.readStatusAtStartup === 'yes')
+    // Timestamp (ms) of the last motion_report.changed we already applied to KNX. Used to
+    // ignore stale/out-of-order reports (e.g. replays after a reconnect).
+    node.lastMotionChangedTs = undefined
     const pinsSetting = (config.enableNodePINS === undefined || config.enableNodePINS === 'yes' || config.enableNodePINS === true)
     node.enableNodePINS = pinsSetting ? 'yes' : 'no'
     node.outputs = pinsSetting ? 1 : 0
@@ -97,6 +103,18 @@ module.exports = function (RED) {
       try {
         if (_event.id === config.hueDevice) {
           if (!_event.hasOwnProperty('motion') || _event.motion.motion === undefined) return
+
+          // Ignore reports that are not newer than the last one applied, so stale/replayed
+          // events after an SSE reconnect can't push a wrong state to KNX (issue #514).
+          const motionChanged = _event.motion.motion_report !== undefined ? _event.motion.motion_report.changed : undefined
+          const changedTs = motionChanged !== undefined ? new Date(motionChanged).getTime() : NaN
+          if (!Number.isNaN(changedTs)) {
+            if (node.lastMotionChangedTs !== undefined && changedTs <= node.lastMotionChangedTs) {
+              return
+            }
+            node.lastMotionChangedTs = changedTs
+          }
+
           const knxMsgPayload = {}
           knxMsgPayload.topic = config.GAmotion
           knxMsgPayload.dpt = config.dptmotion

package/package.json

@@ -3,7 +3,7 @@
   "engines": {
     "node": ">=20.18.1"
   },
-  "version": "4.3.23",
+  "version": "4.3.24",
   "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, KNX AI for diagnosticsand KNX routing between interfaces. Easy to use and highly configurable.",
   "files": [
     "nodes/",