node-red-contrib-3dm-space 2.2.0 → 2.3.0

package/3dm-cloud-in.js

@@ -1,5 +1,7 @@
 module.exports = function (RED) {
-    "use strict";
+    "use strict";
+
+    var roundPayload = require("./payload-precision");
 
     /*
      * Hidden cloud subscribe settings.
@@ -53,7 +55,7 @@ module.exports = function (RED) {
                 return;
             }
 
-            var data = parsePayload(payload);
+            var data = roundPayload(parsePayload(payload));
 
             if (node.keyFilter) {
                 if (typeof data !== "object" || data === null || Array.isArray(data)) {

package/3dm-cloud-join.js

@@ -1,6 +1,8 @@
 module.exports = function (RED) {
     "use strict";
 
+    var roundPayload = require("./payload-precision");
+
     function isPlainObject(value) {
         return value &&
             typeof value === "object" &&
@@ -79,7 +81,7 @@ module.exports = function (RED) {
             }
 
             var outMsg = node.firstMsg || {};
-            outMsg.payload = clonePayloadObject(node.buffer);
+            outMsg.payload = roundPayload(clonePayloadObject(node.buffer));
 
             node.send(outMsg);
 

package/3dm-cloud-out.html

@@ -7,7 +7,8 @@
             server: { value: "", type: "3dm-cloud-config", required: true }
         },
         inputs: 1,
-        outputs: 1,
+        outputs: 2,
+        outputLabels: ["telemetry result", "cloud online"],
         icon: "font-awesome/fa-cloud-upload",
         label: function () {
             return this.name || "3DM telemetry out";
@@ -36,6 +37,8 @@
     <p>Sends telemetry to 3DM.space SCADA Cloud.</p>
 
     <p>Input must be a JSON object.</p>
+    <p>Output 1: the existing telemetry result message.</p>
+    <p>Output 2: connection status with <code>msg.topic = "3dm.connection"</code> and a boolean <code>msg.payload</code>: <code>true</code> for online, <code>false</code> for offline. Emitted once after deployment and on each connection state change, without requiring telemetry input. A missing login configuration reports false.</p>
 
     <p>Example:</p>
 

package/3dm-cloud-out.js

@@ -1,5 +1,7 @@
 module.exports = function (RED) {
-    "use strict";
+    "use strict";
+
+    var roundPayload = require("./payload-precision");
 
     var fs = require("fs");
     var path = require("path");
@@ -85,6 +87,32 @@ module.exports = function (RED) {
         node.name = config.name;
         node.server = RED.nodes.getNode(config.server);
 
+        var lastConnectionState;
+        var connectionOutputClosed = false;
+
+        function sendConnectionState(connected) {
+            connected = Boolean(connected);
+            if (connectionOutputClosed || connected === lastConnectionState) {
+                return;
+            }
+            lastConnectionState = connected;
+            node.send([null, { topic: "3dm.connection", payload: connected }]);
+        }
+
+        // Defer the initial message until Node-RED has connected the flow wires.
+        var connectionStartupTimer = setTimeout(function () {
+            connectionStartupTimer = null;
+            sendConnectionState(node.server && node.server.connected);
+        }, 0);
+
+        node.on("close", function () {
+            connectionOutputClosed = true;
+            if (connectionStartupTimer) {
+                clearTimeout(connectionStartupTimer);
+                connectionStartupTimer = null;
+            }
+        });
+
         var queueFile = path.join(
             QUEUE_DIR,
             QUEUE_FILE_PREFIX + "-" + node.id + ".sqlite"
@@ -234,7 +262,7 @@ module.exports = function (RED) {
 
             return {
                 ts: ts,
-                values: payload
+                values: roundPayload(payload)
             };
         }
 
@@ -253,6 +281,8 @@ module.exports = function (RED) {
                 return;
             }
 
+            packet = Object.assign({}, packet, { values: roundPayload(packet.values) });
+
             node.server.publish(
                 TELEMETRY_TOPIC,
                 packet,
@@ -283,7 +313,16 @@ module.exports = function (RED) {
         }
 
         function sendResult(msg, send, done) {
-            send(msg);
+            if (typeof msg.payload === "string") {
+                try {
+                    msg.payload = JSON.stringify(roundPayload(JSON.parse(msg.payload)));
+                } catch (err) {
+                    // Preserve non-JSON text on rejected messages.
+                }
+            } else {
+                msg.payload = roundPayload(msg.payload);
+            }
+            send([msg, null]);
 
             if (done) {
                 done();
@@ -592,6 +631,7 @@ module.exports = function (RED) {
         }
 
         var stateHandler = function (connected) {
+            sendConnectionState(connected);
             if (connected) {
                 updateStatus("connected");
                 maybeStartBackhaul();

package/3dm-config-store.js

@@ -1,5 +1,7 @@
 module.exports = function (RED) {
-    "use strict";
+    "use strict";
+
+    var roundPayload = require("./payload-precision");
 
     var fs = require("fs");
     var path = require("path");
@@ -694,9 +696,9 @@ module.exports = function (RED) {
                 topic: "configStore",
                 event: eventName || "configStore",
                 payload: {
-                    configStore: latestStore
+                    configStore: roundPayload(latestStore)
                 },
-                configStore: latestStore
+                configStore: roundPayload(latestStore)
             };
 
             node.send(outputs);

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog
+
+## 2.3.0 — 2026-10-18
+
+- Add a second 3DM Out output for boolean cloud connection status: true online, false offline, on deployment and state changes.
+- Preserve existing telemetry results on output 1, queue behavior, rate limiting, and five-decimal payload precision.
+- Replace GPL declarations with Smithtek proprietary licence terms and include LICENSE in the release.
+- Preserve all 2.2.1 documentation and assets; extend the npm file list to include all Markdown documents.
+
+
+## 2.2.1 — 2026-10-01
+
+- Round numeric output payload values to a maximum of five decimal places, including nested objects and arrays.
+- Apply consistent precision to cloud telemetry, queue replay, local telemetry results, incoming attributes, joined messages, and config snapshots.
+- Preserve numeric types, integers, text, stored configuration precision, and internal control comparisons.
+- Include the shared precision helper in the npm package and exclude old release archives.

package/LICENSE

@@ -0,0 +1,25 @@
+Smithtek Proprietary Software Licence
+
+Copyright (c) 2026 Smithtek. All rights reserved.
+
+This software, including its source code, documentation, and accompanying
+Smithtek materials, is proprietary to Smithtek. It is not licensed under the
+GPL or any other open-source licence.
+
+Possession, download, installation, or public availability of this package does
+not grant a licence. Use is permitted only under a separate written agreement
+or express written permission from Smithtek, and only within its scope.
+
+Without that permission, no person may use, copy, modify, distribute,
+sublicense, sell, or create derivative works of this software, except to the
+extent applicable law requires otherwise. Copyright and proprietary notices
+must be retained in any authorised copies.
+
+Third-party dependencies and materials remain subject to their respective
+licences. These terms do not replace or restrict rights granted by those
+third-party licences.
+
+To the extent permitted by law, this software is provided AS IS, without
+warranties of any kind. Smithtek shall not be liable for loss or damage arising
+from use of the software. A separate written agreement with Smithtek takes
+precedence over these terms where they conflict.

package/README.md

@@ -23,6 +23,13 @@ The package is intended for Smithtek PassPort gateway projects using 3DM.space,
 
 ---
 
+
+## Numeric output precision
+
+From version 2.2.1, numeric output payload values are rounded to a maximum of five decimal places. This applies recursively to nested objects and arrays in telemetry, incoming attributes, joined payloads, and config snapshots. For example, `12.12345678` becomes `12.12346`.
+
+Values remain numbers; trailing zeros are not added. Integers, strings (including numeric strings), booleans, and null are unchanged. JSON telemetry strings are parsed and their numeric values are rounded before publishing; the local result payload remains a JSON string. Live and queued telemetry use the same precision, including older packets replayed from the queue. Stored configuration and internal control comparisons retain their original precision.
+
 ## Requirements
 
 To use these nodes, you need:
@@ -53,7 +60,7 @@ The credentials are copied from 3DM.space into Node-RED in this order:
 
 ## Nodes Included
 
-This package includes four nodes:
+This package includes five nodes:
 
 - **3DM Cloud Login**
 - **3DM Out**
@@ -178,6 +185,15 @@ If the cloud connection is unavailable, valid data is stored locally and sent la
 
 ---
 
+## 3DM Out Outputs
+
+From version 2.3.0, 3DM Out has two output pins:
+
+1. **Telemetry result**: the existing result message, including sent, queued, rate-limit, and error fields.
+2. **Cloud online**: a message with boolean `msg.payload`: `true` when the shared MQTT connection to 3DM.space is online, or `false` when offline. The topic is `3dm.connection`.
+
+The second output emits once after deployment and whenever the connection state changes. It works without incoming telemetry. Repeated notifications of the same state do not produce duplicate messages. A missing cloud login configuration reports `false`. This reports MQTT connection status; it does not confirm that an individual telemetry packet was delivered or stored. Existing wires on output 1 keep their telemetry behavior. Connect output 2 to a Switch node or other flow logic to react to online/offline changes.
+
 ## 3DM Out Input Data Type
 
 The 3DM Out node expects `msg.payload` to be a JSON object.
@@ -2606,4 +2622,6 @@ Smithtek
 
 # License
 
-GPL-3.0-or-later
+Smithtek proprietary software. Copyright (c) 2026 Smithtek. All rights reserved.
+
+This package is not offered under an open-source licence. Use requires permission from Smithtek. See [LICENSE](LICENSE) for the proprietary terms. Third-party dependencies retain their own licences.

package/package.json

@@ -1,34 +1,44 @@
-{
-  "name": "node-red-contrib-3dm-space",
-  "version": "2.2.0",
-  "description": "Node-RED nodes for 3DM.space SCADA Cloud telemetry, attributes, and local config storage",
-  "main": "3dm-cloud-config.js",
-  "license": "GPL-3.0-or-later",
-  "keywords": [
-    "node-red",
-    "node-red-contrib",
-    "3dm",
-    "3dm.space",
-    "smithtek",
-    "scada",
-    "telemetry",
-    "store-and-forward",
-    "config-store",
-    "scheduler"
-  ],
-  "node-red": {
-    "nodes": {
-      "3dm-cloud-config": "3dm-cloud-config.js",
-      "3dm-cloud-out": "3dm-cloud-out.js",
-      "3dm-cloud-in": "3dm-cloud-in.js",
-      "3dm-config-store": "3dm-config-store.js",
-      "3dm-cloud-join": "3dm-cloud-join.js"
-    }
-  },
-  "dependencies": {
-    "mqtt": "~4.3.7"
-  },
-  "optionalDependencies": {
-    "node-persistent-queue": "^0.3.1"
-  }
-}
+{
+  "name": "node-red-contrib-3dm-space",
+  "version": "2.3.0",
+  "description": "Node-RED nodes for 3DM.space SCADA Cloud telemetry, attributes, and local config storage",
+  "main": "3dm-cloud-config.js",
+  "license": "SEE LICENSE IN LICENSE",
+  "keywords": [
+    "node-red",
+    "node-red-contrib",
+    "3dm",
+    "3dm.space",
+    "smithtek",
+    "scada",
+    "telemetry",
+    "store-and-forward",
+    "config-store",
+    "scheduler"
+  ],
+  "node-red": {
+    "nodes": {
+      "3dm-cloud-config": "3dm-cloud-config.js",
+      "3dm-cloud-out": "3dm-cloud-out.js",
+      "3dm-cloud-in": "3dm-cloud-in.js",
+      "3dm-config-store": "3dm-config-store.js",
+      "3dm-cloud-join": "3dm-cloud-join.js"
+    }
+  },
+  "dependencies": {
+    "mqtt": "~4.3.7"
+  },
+  "optionalDependencies": {
+    "node-persistent-queue": "^0.3.1"
+  },
+  "files": [
+    "3dm-*.js",
+    "3dm-*.html",
+    "payload-precision.js",
+    "icons/",
+    "icon.png",
+    "*.md",
+    "LICENSE"
+  ],
+  "author": "Smithtek"
+}

package/payload-precision.js

@@ -0,0 +1,38 @@
+"use strict";
+
+// Round numeric payload values without changing strings or the source objects.
+function roundPayload(value, seen) {
+    if (typeof value === "number") {
+        return Number.isFinite(value) && !Number.isInteger(value)
+            ? Number(value.toFixed(5))
+            : value;
+    }
+
+    if (!value || typeof value !== "object") {
+        return value;
+    }
+
+    var prototype = Object.getPrototypeOf(value);
+    if (!Array.isArray(value) && prototype !== Object.prototype && prototype !== null) {
+        return value;
+    }
+
+    seen = seen || new WeakMap();
+    if (seen.has(value)) {
+        return seen.get(value);
+    }
+
+    var output = Array.isArray(value) ? new Array(value.length) : Object.create(prototype);
+    seen.set(value, output);
+    Object.keys(value).forEach(function (key) {
+        Object.defineProperty(output, key, {
+            value: roundPayload(value[key], seen),
+            enumerable: true,
+            writable: true,
+            configurable: true
+        });
+    });
+    return output;
+}
+
+module.exports = roundPayload;