node-red-contrib-ccu 4.4.0 → 4.4.1

package/CHANGELOG.md

@@ -5,6 +5,34 @@ Notable changes to node-red-contrib-ccu. Format follows
 user-visible symptom and the cause, not the commit list (the release notes
 append commits automatically).
 
+## 4.4.1 (2026-09-07)
+
+### Fixed
+
+- **Node-RED could be killed by a failed ReGaHSS write, seconds after
+  start** ([RedMatic #601](https://github.com/rdmtc/RedMatic/issues/601)).
+  A write to a system variable that arrives before the variable list is
+  known is deferred into a queue and flushed once the first
+  `getRegaVariables` completes. That flush dropped the resulting promise,
+  so a rejected write — ReGaHSS closing the connection, `Error: socket
+hang up` — became an **unhandled rejection**, which Node >= 15 turns
+  into an uncaught exception: the whole Node-RED process exited with
+  status 1 and its supervisor restarted it into the same crash. The
+  rejection is now caught and logged.
+
+  This became reachable in 4.3.0: the rewritten local-CCU detection made
+  `isLocal` true again on RedMatic boxes (it had silently stopped
+  matching on current firmware), which moves ReGa traffic from lighttpd
+  on 8181 to ReGaHSS directly on 8183. lighttpd absorbed a busy ReGaHSS;
+  the direct port simply closes the connection.
+
+- The same floating-promise pattern in `ccu-mqtt`: `setVariable`,
+  `programActive` and `programExecute` triggered over MQTT dropped their
+  promises too, and now report through the node's error output instead of
+  taking the process down.
+- `regaPoll`'s `finally` chain is caught as well, so a throw in the
+  follow-up scheduling cannot escape as an unhandled rejection.
+
 ## 4.4.0 (2026-09-06)
 
 ### Added

package/HANDOFF.md

@@ -28,6 +28,20 @@ Lab addresses and credentials are intentionally **not** in this file
   re-poll, RSSI guard). All four archived. Branch `b-2-b-5` merged with
   `--no-ff`; 145 pure tests, 23 integration specs green on all four CI
   legs.
+- **4.4.0 released 2026-09-06** (tag v4.4.0, npm latest = 4.4.0):
+  B-17, the openccu-lite port. `nodes/lib/metaprovider.js` takes names,
+  rooms and functions from the box's metadata API (`/api/meta/v1`
+  snapshot + SSE) when `GET /api/meta/v1/version` answers; a CCU
+  answers 404 and the ReGa path is byte-for-byte what it was. Two
+  optional connection fields (openccu-lite token, port); on the box the
+  token comes from `/usr/local/etc/occulite/local-token`. sysvar,
+  program, script and poll stay in the palette and error per message.
+  16 unit tests plus a verification against a real `occulited` built
+  from ../openccu-lite (see roadmap-archive/B-17.md). Branch
+  `b-17-openccu-lite` merged with `--no-ff` and deleted. **Open: no test
+  on real openccu-lite hardware, and the connection dialog with the two
+  new fields has not been opened in a browser.** RedMatic's own port
+  needs `node-red-contrib-ccu@^4.4.0`.
 - Issue tracker: 36 → **19 open**. The 17 issues 4.3.0 fixes were
   commented and closed after the release (#172 #71 #103 #80 #56 #148
   #133 #115 #22 #167 #44 #54 #52 #96 #166 #183 #51, plus comments on the

package/nodes/ccu-connection.js

@@ -1593,7 +1593,10 @@ module.exports = function (RED) {
                             this.regaPollAgain = false;
                             this.refreshRegaDataIfDue();
                         }
-                    });
+                    })
+                    // a throw inside the finally above would otherwise be an
+                    // unhandled rejection, see #601
+                    .catch((error) => this.logger.error('regaPoll', error));
             }
         }
 
@@ -1784,10 +1787,17 @@ module.exports = function (RED) {
                             Object.keys(this.setVariableQueueTimeout).forEach((name) =>
                                 clearTimeout(this.setVariableQueueTimeout[name]),
                             );
-                            Object.keys(this.setVariableQueue).reduce(
-                                (p, name) => p.then((_) => this.setVariable(name, this.setVariableQueue[name])),
-                                Promise.resolve(),
-                            );
+                            // #601: a rejected write here used to be an
+                            // unhandled rejection, which Node >= 15 turns into
+                            // an uncaught exception - it killed the whole
+                            // process seconds after start whenever ReGaHSS
+                            // dropped the connection (RedMatic #601).
+                            Object.keys(this.setVariableQueue)
+                                .reduce(
+                                    (p, name) => p.then((_) => this.setVariable(name, this.setVariableQueue[name])),
+                                    Promise.resolve(),
+                                )
+                                .catch((error) => this.logger.error('deferred setVariable', error));
                         }
 
                         resolve();

package/nodes/ccu-mqtt.js

@@ -405,13 +405,22 @@ module.exports = function (RED) {
                 return;
             }
 
+            // #601: these promises used to float - a rejection (e.g. ReGaHSS
+            // closing the connection) became an unhandled rejection and took
+            // the whole Node-RED process down.
             if (this.ccu.sysvar[filter.name]) {
-                this.ccu.setVariable(filter.name, payload);
+                this.ccu
+                    .setVariable(filter.name, payload)
+                    .catch((error) => this.error('setVariable ' + filter.name + ': ' + error.message));
             } else if (this.ccu.program[filter.name]) {
                 if (typeof payload === 'boolean') {
-                    this.ccu.programActive(filter.name, payload);
+                    this.ccu
+                        .programActive(filter.name, payload)
+                        .catch((error) => this.error('programActive ' + filter.name + ': ' + error.message));
                 } else {
-                    this.ccu.programExecute(filter.name);
+                    this.ccu
+                        .programExecute(filter.name)
+                        .catch((error) => this.error('programExecute ' + filter.name + ': ' + error.message));
                 }
             } else {
                 this.error('no sysvar or program with name ' + filter.name + ' found');

package/nodes/ccu-poll.js

@@ -23,7 +23,8 @@ module.exports = function (RED) {
                     return;
                 }
 
-                this.ccu.regaPoll(); // TODO catch errors
+                // regaPoll() returns nothing and handles its own errors (#601)
+                this.ccu.regaPoll();
                 done();
             });
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-red-contrib-ccu",
-  "version": "4.4.0",
+  "version": "4.4.1",
   "license": "MIT",
   "main": "none",
   "keywords": [