node-red-contrib-knx-ultimate 6.0.9 → 6.0.10

package/CHANGELOG.md

@@ -6,8 +6,9 @@
 
 # CHANGELOG
 
-**Version 6.0.9** - July 2026<br/>
+**Version 6.0.10** - July 2026<br/>
 
+- **Matter nodes — crash containment**: asynchronous bridge state updates, controller client callbacks, engine errors, startup/watchdog timers and the controller command queue are now guarded so rejected promises and EventEmitter errors are reported instead of becoming uncaught exceptions or unhandled rejections capable of stopping Node-RED.<br/>
 - **Matter Controller — post-commission naming**: assigning a name immediately after pairing now waits for matter.js to finish exposing the root `BasicInformation` cluster. Root endpoint 0 is resolved explicitly, preventing the misleading `BasicInformation cluster not found` warning seen when re-adding devices such as Shelly Plug.<br/>
 - **Control Matter from KNX — profile deploy crash**: Door Lock and multi-purpose profiles now expose the KNX status callback before registering with `knxUltimate-config`, preventing `_Node.setNodeStatus is not a function` during deploy.<br/>
 - **Control Matter from KNX — flow PIN persistence**: the **Node Input/Output PINs** selection is no longer overwritten from the KNX gateway presence when reopening the editor. The saved choice remains authoritative and `inputs`/`outputs` are updated coherently on save.<br/>

package/nodes/knxUltimateMatterBridge.js

@@ -170,6 +170,24 @@ module.exports = function (RED) {
       }
     }
 
+    const reportMatterError = (context, error) => {
+      const message = error?.message || String(error)
+      node.setNodeStatus({ fill: 'red', shape: 'dot', text: `${context} ${message}`, payload: '' })
+      try { RED.log.error(`knxUltimateMatterBridge: ${context}: ${message}`) } catch (logError) { /* empty */ }
+    }
+
+    const safeSetDeviceState = async (fn, value, context) => {
+      try {
+        if (!node.serverMatterBridge || typeof node.serverMatterBridge.setDeviceState !== 'function') {
+          throw new Error('Matter bridge unavailable')
+        }
+        return await node.serverMatterBridge.setDeviceState(node.matterDeviceId, fn, value)
+      } catch (error) {
+        reportMatterError(context, error)
+        return false
+      }
+    }
+
     const clearCoverStatusTimer = () => {
       if (coverStatusTimer !== null) {
         clearTimeout(coverStatusTimer)
@@ -227,7 +245,7 @@ module.exports = function (RED) {
       clearCoverArrivalTimer()
 
       if (node.coverUpdateMode === 'optimistic') {
-        node.serverMatterBridge.setDeviceState(node.matterDeviceId, 'position', requestedPosition)
+        safeSetDeviceState('position', requestedPosition, 'Matter position update error')
         return
       }
 
@@ -241,7 +259,7 @@ module.exports = function (RED) {
       }
       coverArrivalTimer = setTimeout(() => {
         coverArrivalTimer = null
-        node.serverMatterBridge.setDeviceState(node.matterDeviceId, 'position', requestedPosition)
+        safeSetDeviceState('position', requestedPosition, 'Matter position fallback error')
         node.setNodeStatus({ fill: 'yellow', shape: 'ring', text: 'No exact KNX confirmation in time, assuming arrived at', payload: requestedPosition })
       }, COVER_ARRIVAL_FALLBACK_MS)
     }
@@ -341,7 +359,7 @@ module.exports = function (RED) {
           try {
             const value = dptlib.fromBuffer(msg.knx.rawValue, dptlib.resolve(route.dpt))
             if (value === undefined || value === null) return
-            node.serverMatterBridge.setDeviceState(node.matterDeviceId, route.fn, value)
+            safeSetDeviceState(route.fn, value, 'KNX->Matter error')
             if (node.deviceType === 'windowcovering' && route.fn === 'position') { clearCoverStatusTimer(); clearCoverArrivalTimer() }
             node.setNodeStatus({ fill: 'blue', shape: 'dot', text: `KNX->Matter ${route.fn}`, payload: value })
           } catch (error) {
@@ -391,7 +409,7 @@ module.exports = function (RED) {
 
     // Flow input pin: updates the Matter state of this device without going through the KNX bus.
     // msg.payload = { function: 'onoff'|'level'|'position'|'temperature'|..., value: ... }
-    node.on('input', (msg, send, done) => {
+    node.on('input', async (msg, send, done) => {
       if (!node.enableNodePINS) {
         if (done) done()
         return
@@ -401,7 +419,8 @@ module.exports = function (RED) {
         const fn = (payload.function || payload.fn || '').toString().trim()
         if (fn === '' || payload.value === undefined) throw new Error('msg.payload must be { function, value }')
         if (node.serverMatterBridge === undefined) throw new Error('No Matter bridge selected')
-        node.serverMatterBridge.setDeviceState(node.matterDeviceId, fn, payload.value)
+        const updated = await safeSetDeviceState(fn, payload.value, 'Flow->Matter error')
+        if (!updated) throw new Error('Matter state update failed')
         node.setNodeStatus({ fill: 'green', shape: 'dot', text: `Flow->Matter ${fn}`, payload: payload.value })
         if (done) done()
       } catch (error) {

package/nodes/matter-config.js

@@ -44,7 +44,10 @@ module.exports = (RED) => {
       // Matter clients registered on this shared controller connection.
       try {
         if (!client || typeof fn !== 'function') return
-        fn()
+        const result = fn()
+        if (result && typeof result.catch === 'function') {
+          result.catch((error) => node.sysLogger?.warn(`Matter client ${label} async error: ${error.message}`))
+        }
       } catch (error) {
         node.sysLogger?.warn(`Matter client ${label} error: ${error.message}`)
       }
@@ -132,6 +135,11 @@ module.exports = (RED) => {
         })
       })
 
+      // EventEmitter treats an unhandled "error" event as a process exception.
+      node.matterManager.on('error', (error) => {
+        node.sysLogger?.error(`Matter controller engine error: ${error?.message || error}`)
+      })
+
       try {
         await node.matterManager.Connect()
       } catch (error) {
@@ -150,8 +158,12 @@ module.exports = (RED) => {
               node.sysLogger?.error(`Errore matter-config: node.startWatchdogTimer: ${error.message}`)
             }
           }
-          await node.startWatchdogTimer()
-        })()
+          try {
+            await node.startWatchdogTimer()
+          } catch (error) {
+            node.sysLogger?.error(`matter-config: watchdog reschedule error: ${error.message}`)
+          }
+        })().catch((error) => node.sysLogger?.error(`matter-config: watchdog callback error: ${error.message}`))
       }, 60000)
     }
 
@@ -165,11 +177,11 @@ module.exports = (RED) => {
           node.sysLogger?.error(`matter-config: startup error: ${error.message}`)
         }
         try {
-          node.startWatchdogTimer()
+          await node.startWatchdogTimer()
         } catch (error) {
           node.sysLogger?.error(`matter-config: watchdog start error: ${error.message}`)
         }
-      })()
+      })().catch((error) => node.sysLogger?.error(`matter-config: startup callback error: ${error.message}`))
     }, 5000)
 
     // Functions called from the nodes and the admin endpoints ----------------------------------------

package/nodes/matterbridge-config.js

@@ -53,7 +53,10 @@ module.exports = (RED) => {
     const safeClientCall = (client, fn, label) => {
       try {
         if (!client || typeof fn !== 'function') return
-        fn()
+        const result = fn()
+        if (result && typeof result.catch === 'function') {
+          result.catch((error) => node.sysLogger?.warn(`Matter bridge client ${label} async error: ${error.message}`))
+        }
       } catch (error) {
         node.sysLogger?.warn(`Matter bridge client ${label} error: ${error.message}`)
       }
@@ -80,6 +83,10 @@ module.exports = (RED) => {
 
     const bindEngineEvents = (engine) => {
       engine.removeAllListeners()
+      // An EventEmitter "error" without a listener terminates Node-RED.
+      engine.on('error', (error) => {
+        node.sysLogger?.error(`Matter bridge engine error: ${error?.message || error}`)
+      })
       // Matter -> KNX: a controller (Alexa...) sent a command to a bridged device.
       // Route it to the device node that owns that Matter device.
       engine.on('command', (command) => {
@@ -109,7 +116,7 @@ module.exports = (RED) => {
           } catch (error) {
             node.sysLogger?.warn(`matterbridge-config: reconcile error: ${error.message}`)
           }
-        })()
+        })().catch((error) => node.sysLogger?.warn(`matterbridge-config: reconcile callback error: ${error.message}`))
       }, 1500)
     }
 
@@ -160,7 +167,7 @@ module.exports = (RED) => {
       (async () => {
         if (closing) return
         await ensureEngineStarted()
-      })()
+      })().catch((error) => node.sysLogger?.error(`matterbridge-config: startup callback error: ${error.message}`))
     }, 5000)
 
     // Functions called from the device nodes -----------------------------------------

package/nodes/utils/matterEngine.mjs

@@ -37,7 +37,11 @@ class classMatter extends EventEmitter {
     this.exitAllQueues = false
     this._api = null // Lazy loaded matter.js exports
     this._logThrottle = new Map()
-    if (startQueue) this.handleQueue()
+    if (startQueue) {
+      // The queue is intentionally fire-and-forget, but its Promise must always be
+      // observed so an unexpected loop failure cannot become an unhandled rejection.
+      this.handleQueue().catch((error) => this._log('error', `classMatter: queue loop: ${error.message}`))
+    }
   }
 
   _log = (level, message) => {

package/package.json

@@ -3,7 +3,7 @@
   "engines": {
     "node": ">=20.18.1"
   },
-  "version": "6.0.9",
+  "version": "6.0.10",
   "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/",