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

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

@@ -87,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"
@@ -296,7 +322,7 @@ module.exports = function (RED) {
             } else {
                 msg.payload = roundPayload(msg.payload);
             }
-            send(msg);
+            send([msg, null]);
 
             if (done) {
                 done();
@@ -605,6 +631,7 @@ module.exports = function (RED) {
         }
 
         var stateHandler = function (connected) {
+            sendConnectionState(connected);
             if (connected) {
                 updateStatus("connected");
                 maybeStartBackhaul();

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # 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.

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

@@ -185,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.
@@ -2613,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,9 +1,9 @@
 {
   "name": "node-red-contrib-3dm-space",
-  "version": "2.2.1",
+  "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": "GPL-3.0-or-later",
+  "license": "SEE LICENSE IN LICENSE",
   "keywords": [
     "node-red",
     "node-red-contrib",
@@ -37,7 +37,8 @@
     "payload-precision.js",
     "icons/",
     "icon.png",
-    "README.md",
-    "CHANGELOG.md"
-  ]
+    "*.md",
+    "LICENSE"
+  ],
+  "author": "Smithtek"
 }