node-red-contrib-uos-nats 1.3.52 → 1.3.55

package/README.md

@@ -1,9 +1,13 @@
-
 **Unofficial Node-RED Package for Weidmüller u-OS Data Hub**
 
 Read, write, and provide variables via NATS protocol using **OAuth2 authentication**.
 Optimized for high performance and real-time updates.
 
+> **IMPORTANT:**
+> These nodes **MUST** run directly on the **u-OS device** (e.g. as a simplified App or Snap).
+> The system's NATS server is **NOT accessible from the outside** (blocked by firewall/binding).
+> You cannot use this package from a remote Node-RED instance (e.g. on your Laptop) to connect to the device.
+
 Maintained by [IoTUeli](https://iotueli.ch). Source: [GitHub](https://github.com/uiff/nats-NodeRed-Node-uc20)
 
 ---

package/lib/payloads.js

@@ -79,8 +79,14 @@ export function buildReadVariablesQuery(ids) {
     const builder = new flatbuffers.Builder(128);
     let idsOffset = 0;
 
-    if (ids && ids.length > 0) {
-        idsOffset = ReadVariablesQueryRequest.createIdsVector(builder, ids);
+    // Safety: Filter invalid IDs to prevent crashes in C++ provider
+    // FlatBuffers requires strict types.
+    const validIds = (ids || [])
+        .map(id => Number(id))
+        .filter(id => Number.isInteger(id) && id >= 0);
+
+    if (validIds.length > 0) {
+        idsOffset = ReadVariablesQueryRequest.createIdsVector(builder, validIds);
     }
 
     ReadVariablesQueryRequest.startReadVariablesQueryRequest(builder);

package/nodes/datahub-input.js

@@ -283,8 +283,17 @@ module.exports = function (RED) {
             this.send({ payload: { type: 'snapshot', variables: allResults } });
             this.status({ fill: 'green', shape: 'dot', text: 'active' });
           } else if (errors.length > 0) {
-            this.warn(`Snapshot errors: ${errors.join('; ')}`);
-            this.status({ fill: 'red', shape: 'ring', text: 'error' });
+            const errStr = errors.join('; ');
+            if (errStr.includes('503') || errStr.includes('no responders')) {
+              this.status({ fill: 'green', shape: 'ring', text: 'waiting for provider' });
+              this.debug(`Snapshot waiting: ${errStr}`);
+            } else if (errStr.includes('Authorization') || errStr.includes('Permission')) {
+              this.status({ fill: 'yellow', shape: 'ring', text: 'auth failed' });
+              this.warn(`Snapshot auth failed: ${errStr}`);
+            } else {
+              this.status({ fill: 'red', shape: 'ring', text: 'error' });
+              this.warn(`Snapshot errors: ${errStr}`);
+            }
           } else {
             this.status({ fill: 'green', shape: 'ring', text: 'empty' });
           }
@@ -360,10 +369,13 @@ module.exports = function (RED) {
 
     this.on('input', (msg, send, done) => {
       let overrideItems = null;
-      if (Array.isArray(msg.payload) && msg.payload.length > 0) {
-        // Pass the raw array items (String or Object {provider, key})
-        // performSnapshot will handle filtering
-        overrideItems = msg.payload;
+      if (msg.payload) {
+        if (Array.isArray(msg.payload) && msg.payload.length > 0) {
+          overrideItems = msg.payload;
+        } else if (typeof msg.payload === 'string' || (typeof msg.payload === 'object' && !Buffer.isBuffer(msg.payload))) {
+          // Allow single item dynamic read (convenience)
+          overrideItems = [msg.payload];
+        }
       }
 
       performSnapshot(overrideItems)

package/nodes/uos-config.html

@@ -230,6 +230,13 @@
 
   <h3>Troubleshooting</h3>
   
+  <p style="color:var(--red-ui-text-color-error); font-weight:bold; border:1px solid var(--red-ui-text-color-error); padding:5px; border-radius:3px;">
+      ⚠️ IMPORTANT:<br>
+      These nodes MUST run directly on the u-OS device (App/Snap).
+      The NATS server is NOT accessible from the outside.
+      You cannot use this node from a remote instance (e.g. Laptop).
+  </p>
+
   <h4>Test Connection fails</h4>
   <ul>
     <li>Check Host/Port are correct and device is reachable</li>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-red-contrib-uos-nats",
-  "version": "1.3.52",
+  "version": "1.3.55",
   "description": "Node-RED nodes for Weidmüller u-OS Data Hub. Read, write, and provide variables via NATS protocol with OAuth2 authentication. Features: Variable Key resolution, custom icons, example flows, and provider definition caching.",
   "author": {
     "name": "IoTUeli",