node-red-contrib-knx-ultimate 4.1.7 → 4.1.9

package/CHANGELOG.md

@@ -6,6 +6,17 @@
 
 # CHANGELOG
 
+**Version 4.1.9** - December 2025<br/>
+- NEW: added **Hue Motion Area** node for Philips Hue Bridge Pro MotionAware areas, exposing aggregated motion state from Hue `convenience_area_motion` and `security_area_motion` services to KNX or Node-RED flows.<br/>
+- Hue config: extended the internal resource browser to resolve MotionAware area services against their `motion_area_configuration`, showing friendly area names and linked rooms/zones in the editor device picker.<br/>
+<br/>
+
+**Version 4.1.8** - December 2025<br/>
+- Logger node editor: when **Action** is set to `Emit payload only`, the file path row is now completely hidden (instead of just disabled), using a dedicated row id for better future Node-RED compatibility.<br/>
+- Logger node editor: added a **Download** button next to the file path.<br/>
+- Logger node: updated labels, help and wiki pages in all languages to explain both the **payload interval** and **Max rows** behaviour, including how the XML/file is **rotated** when the configured row limit is reached.<br/>
+<br/>
+
 **Version 4.1.7** - December 2025<br/>
 - Logger node: replaced the checkbox with an explicit **Action** selector (`Emit payload only` / `Emit payload and save to file`), keeping backward compatibility with existing flows.<br/>
 - Logger node: file saving now appends and enforces **Max rows** by trimming oldest lines in both buffer and file; removed the folder picker/listDirs endpoint in favour of a single full-path field.<br/>

package/nodes/commonFunctions.js

@@ -327,6 +327,43 @@ module.exports = (RED) => {
       }
     })
 
+    // 2025-12 Download logger XML file configured in a knxUltimateLogger node
+    RED.httpAdmin.get('/knxUltimateLoggerDownload', RED.auth.needsPermission('knxUltimate-config.read'), (req, res) => {
+      try {
+        const nodeId = (req.query.nodeId || req.query.id || '').toString()
+        if (!nodeId) {
+          res.status(400).json({ error: 'NO_NODE_ID' })
+          return
+        }
+        const loggerNode = RED.nodes.getNode(nodeId)
+        if (!loggerNode || loggerNode.isLogger !== true) {
+          res.status(404).json({ error: 'LOGGER_NOT_FOUND' })
+          return
+        }
+        const filePath = (loggerNode.filePath || '').toString()
+        if (!filePath) {
+          res.status(404).json({ error: 'NO_FILE_PATH' })
+          return
+        }
+        if (!fs.existsSync(filePath)) {
+          res.status(404).json({ error: 'FILE_NOT_FOUND' })
+          return
+        }
+        const safeName = path.basename(filePath) || 'knx-logger.xml'
+        res.setHeader('Content-Type', 'application/xml; charset=utf-8')
+        res.setHeader('Content-Disposition', `attachment; filename="${safeName}"`)
+        const stream = fs.createReadStream(filePath)
+        stream.on('error', (err) => {
+          try { RED.log.error(`KNXUltimateLoggerDownload error reading file ${filePath}: ${err.message}`) } catch (e) {}
+          if (!res.headersSent) res.status(500).json({ error: 'READ_ERROR' })
+        })
+        stream.pipe(res)
+      } catch (error) {
+        try { RED.log.error(`KNXUltimateLoggerDownload error: ${error.message}`) } catch (e) {}
+        if (!res.headersSent) res.status(500).json({ error: 'UNEXPECTED_ERROR' })
+      }
+    })
+
     // 2025-09 List interfaces (IA) from KNX Secure keyring
     RED.httpAdmin.get('/knxUltimateKeyringInterfaces', RED.auth.needsPermission('knxUltimate-config.read'), async (req, res) => {
       try {

package/nodes/hue-config.js

@@ -347,7 +347,8 @@ module.exports = (RED) => {
           allResources = node.hueAllResources.filter((a) => a.type === 'light' || a.type === 'grouped_light')
         } else if (_rtype === 'plug') {
           allResources = node.hueAllResources.filter((a) => a.type === 'plug' || a.type === 'smartplug' || a.type === 'smart_plug')
-          //console.log('getResources plug raw resources', allResources.map((res) => ({ id: res.id, type: res.type, owner: res.owner?.rtype })))
+        } else if (_rtype === 'area_motion') {
+          allResources = node.hueAllResources.filter((a) => a.type === 'convenience_area_motion' || a.type === 'security_area_motion')
         } else {
           allResources = node.hueAllResources.filter((a) => a.type === _rtype)
         }
@@ -411,6 +412,36 @@ module.exports = (RED) => {
                 id: resource.id
               })
             }
+            if (_rtype === 'convenience_area_motion' || _rtype === 'security_area_motion' || (_rtype === 'area_motion' && (resource.type === 'convenience_area_motion' || resource.type === 'security_area_motion'))) {
+              let areaName = ''
+              let areaGroupLabel = ''
+              const isConvenience = resource.type === 'convenience_area_motion'
+              const areaTypeLabel = isConvenience ? 'Convenience area' : 'Security area'
+              let configuration = node.hueAllResources.find((res) => {
+                if (res.type !== 'motion_area_configuration' || !Array.isArray(res.services)) return false
+                return res.services.some((svc) => svc.rid === resource.id)
+              })
+              if (!configuration && resource.owner && resource.owner.rid) {
+                const candidate = node.hueAllResources.find((res) => res.id === resource.owner.rid)
+                if (candidate && candidate.type === 'motion_area_configuration') configuration = candidate
+              }
+              if (configuration && typeof configuration.name === 'string' && configuration.name.trim() !== '') {
+                areaName = configuration.name.trim()
+              } else {
+                areaName = resource.id
+              }
+              if (configuration && configuration.group && configuration.group.rid) {
+                const groupRes = node.hueAllResources.find((res) => res.id === configuration.group.rid)
+                if (groupRes && groupRes.metadata && typeof groupRes.metadata.name === 'string') {
+                  const groupType = configuration.group.rtype ? capStr(configuration.group.rtype) : 'Group'
+                  areaGroupLabel = `, ${groupType} ${groupRes.metadata.name}`
+                }
+              }
+              retArray.push({
+                name: `${areaTypeLabel}: ${areaName}${areaGroupLabel}`,
+                id: resource.id
+              })
+            }
             if (_rtype === 'relative_rotary') {
               const linkedDevName = node.hueAllResources.find((dev) => dev.type === 'device' && dev.services.find((serv) => serv.rid === resource.id)).metadata.name || ''
               retArray.push({