node-red-contrib-modbus-modpackqt 3.1.1 → 3.2.0

package/CHANGELOG.md

@@ -4,6 +4,33 @@ All notable changes to **node-red-contrib-modbus-modpackqt** are documented
 here. This project follows [Semantic Versioning](https://semver.org/) — pin a
 major version (`^2.0.0`) in production.
 
+## [3.2.0] — 2026-05-10
+
+### Added — Cloud profile pickers
+
+- **"My Profiles" dropdown** on `modpackqt-master-read`,
+  `modpackqt-master-write` and `modpackqt-master-probe`. Picks one of
+  your saved Modbus TCP profiles from your modpackqt.com account and
+  auto-fills `targetHost`, `targetPort` and `unitId`. No more retyping
+  IPs across nodes.
+- **"My Slaves" dropdown** on `modpackqt-slave-probe`. Picks one of
+  your saved slave configs and auto-fills `bindPort` + `unitId`.
+- **Account Key** field on the runtime config (renamed from "API Key").
+  Paste your tunnel key from
+  [modpackqt.com → Settings → Cloud Gateways](https://modpackqt.com/settings)
+  to enable the dropdowns. Same key the Electron gateway uses — no new
+  signup, no new mechanism.
+- **Hidden admin proxy** (`/modpackqt/connections`, `/modpackqt/slaves`)
+  on the Node-RED admin port. Calls modpackqt.com server-side from the
+  Node-RED process so the Account Key never reaches the browser.
+
+### Changed
+
+- Manual `targetHost` / `targetPort` / `unitId` fields stay as a fallback
+  on every node — existing v3.1.x flows keep working untouched.
+- Runtime config `apiKey` credential is unchanged on disk — only the
+  label and helper text in the editor were updated.
+
 ## [3.1.1] — 2026-05-10
 
 ### Fixed

package/README.md

@@ -16,6 +16,7 @@ By [ModPackQT](https://modpackqt.com).
 - **Modbus master** — read (FC1–FC4) and write (FC5/FC6/FC15/FC16) over **TCP** or **RTU (serial)**
 - **Embedded Modbus TCP slave server** — push values from any flow, let PLCs / SCADA / HMIs read them
 - **Passive traffic monitor** — see every Modbus op (timing, values, errors) in real time
+- **Optional cloud profile pickers** *(v3.2.0)* — paste your ModPackQT Account Key into the runtime config and master / probe nodes show a dropdown of your saved Modbus profiles. No more retyping IPs across nodes.
 - **Outputs raw register values** — pair with [`node-red-contrib-bytes-modpackqt`](https://www.npmjs.com/package/node-red-contrib-bytes-modpackqt) to decode int / float / string / bitmask
 - **Zero external dependencies** — Modbus runs inside the Node-RED process
 

package/nodes/lib/cloud-client.js

@@ -0,0 +1,58 @@
+/**
+ * ModPackQT Cloud Client — minimal HTTPS reader for the user's saved
+ * Modbus profiles & slaves at modpackqt.com.
+ *
+ * Reuses the existing X-Tunnel-Key auth that the Electron gateway already
+ * uses. The user's "Account Key" is the same tunnel key they generate at
+ * modpackqt.com → Settings → Cloud Gateways. No new auth, no new dep.
+ *
+ * All requests are read-only GETs. The Node-RED admin endpoint in
+ * modpackqt-config.js wraps these so the editor never sees the key
+ * (proxied server-side from the Node-RED process).
+ */
+const https = require('https');
+const http  = require('http');
+const { URL } = require('url');
+
+const ORIGIN = process.env.MODPACKQT_CLOUD_ORIGIN || 'https://modpackqt.com';
+const TIMEOUT_MS = 10000;
+
+function fetchJson(path, key, callback) {
+  let u;
+  try { u = new URL(path, ORIGIN); }
+  catch (e) { return callback(new Error('Invalid cloud URL: ' + e.message)); }
+
+  const lib = u.protocol === 'https:' ? https : http;
+  const req = lib.request({
+    method:   'GET',
+    hostname: u.hostname,
+    port:     u.port || (u.protocol === 'https:' ? 443 : 80),
+    path:     u.pathname + (u.search || ''),
+    headers: {
+      'X-Tunnel-Key': key,
+      'Accept':       'application/json',
+      'User-Agent':   'node-red-contrib-modbus-modpackqt'
+    },
+    timeout: TIMEOUT_MS
+  }, (res) => {
+    let body = '';
+    res.setEncoding('utf8');
+    res.on('data',  (c) => { body += c; });
+    res.on('end',   () => {
+      if (res.statusCode >= 400) {
+        return callback(new Error('Cloud HTTP ' + res.statusCode + ': ' + body.slice(0, 200)));
+      }
+      try { callback(null, JSON.parse(body)); }
+      catch (e) { callback(new Error('Invalid JSON from cloud: ' + e.message)); }
+    });
+  });
+  req.on('error',   (err) => callback(err));
+  req.on('timeout', () => { req.destroy(new Error('Cloud request timed out after ' + TIMEOUT_MS + 'ms')); });
+  req.end();
+}
+
+module.exports = {
+  origin: () => ORIGIN,
+  fetchConnections: (key, cb) => fetchJson('/api/connections', key, cb),
+  fetchSlaves:      (key, cb) => fetchJson('/api/slaves',      key, cb),
+};

package/nodes/lib/probe-runtime.js

@@ -18,7 +18,7 @@
 const http = require('http');
 const { URL } = require('url');
 
-const PALETTE_VERSION = '3.1.1';
+const PALETTE_VERSION = '3.2.0';
 const DEFAULT_PORT = parseInt(process.env.MODPACKQT_PROBE_PORT, 10) || 8502;
 const BIND_HOST    = process.env.MODPACKQT_PROBE_HOST || '127.0.0.1';
 const PORT_RETRY   = 5;

package/nodes/modpackqt-config.html

@@ -102,10 +102,15 @@
     <input type="number" id="node-config-input-slavePort" placeholder="1502">
   </div>
 
-  <h4 style="margin-top:18px">API Key (optional — reserved for future cloud features)</h4>
+  <h4 style="margin-top:18px">ModPackQT Account Key (optional — for cloud profile sync)</h4>
   <div class="form-row">
-    <label for="node-config-input-apiKey"><i class="fa fa-key"></i> API Key</label>
-    <input type="password" id="node-config-input-apiKey" placeholder="Optional — leave blank for local-only use">
+    <label for="node-config-input-apiKey"><i class="fa fa-key"></i> Account Key</label>
+    <input type="password" id="node-config-input-apiKey" placeholder="Optional — paste your tunnel key for profile pickers">
+  </div>
+  <div class="form-tips" style="font-size:11px;color:#6b7280;margin-top:-6px">
+    With a key set, master &amp; probe nodes show a dropdown of your saved Modbus profiles
+    and slaves from <a href="https://modpackqt.com/settings" target="_blank" rel="noopener">modpackqt.com → Settings → Cloud Gateways</a>.
+    All Modbus runs locally — the key is only used for read-only profile sync.
   </div>
 
   <div class="form-tips">
@@ -143,9 +148,13 @@
     last wrote.
   </p>
 
-  <h3>API key (optional)</h3>
+  <h3>ModPackQT Account Key (optional)</h3>
   <p>
-    Reserved for future cloud features (profile sync, remote console). Leave blank
-    for local-only use — all Modbus functionality works without a key.
+    Same tunnel key the Electron gateway uses — generate one at
+    <a href="https://modpackqt.com/settings" target="_blank" rel="noopener">modpackqt.com → Settings → Cloud Gateways</a>.
+    With a key set, the master and probe nodes show a dropdown of your saved Modbus
+    profiles &amp; slaves so you don't have to retype IPs and unit IDs. All Modbus traffic
+    still runs locally — the key is only used for a read-only HTTPS call from this
+    Node-RED process to load your profile list.
   </p>
 </script>

package/nodes/modpackqt-config.js

@@ -8,6 +8,31 @@
 module.exports = function (RED) {
   const ModbusRTU = require('modbus-serial');
   const { EventEmitter } = require('events');
+  const cloudClient = require('./lib/cloud-client');
+
+  // ── Admin proxy endpoints — let the editor read the user's saved profiles
+  // and slaves from modpackqt.com without ever exposing the Account Key to
+  // the browser. Same X-Tunnel-Key the Electron gateway already uses.
+  // Registered once per Node-RED process.
+  if (!RED._modpackqtAdminRoutesRegistered) {
+    RED._modpackqtAdminRoutesRegistered = true;
+    function makeProxy(fetchFn) {
+      return function (req, res) {
+        const configId = req.query && req.query.config;
+        if (!configId) return res.status(400).json({ error: 'config query param required' });
+        const cfg = RED.nodes.getNode(configId);
+        if (!cfg) return res.status(404).json({ error: 'Runtime config not found (deploy first?)' });
+        const key = cfg.credentials && cfg.credentials.apiKey;
+        if (!key) return res.status(400).json({ error: 'No Account Key set on the runtime config — paste it in the modpackqt-config node first.' });
+        fetchFn(key, function (err, data) {
+          if (err) return res.status(502).json({ error: err.message });
+          res.json(data);
+        });
+      };
+    }
+    RED.httpAdmin.get('/modpackqt/connections', RED.auth.needsPermission('flows.read'), makeProxy(cloudClient.fetchConnections));
+    RED.httpAdmin.get('/modpackqt/slaves',      RED.auth.needsPermission('flows.read'), makeProxy(cloudClient.fetchSlaves));
+  }
 
   function ModPackQTConfigNode(config) {
     RED.nodes.createNode(this, config);

package/nodes/modpackqt-master-probe.html

@@ -4,6 +4,7 @@
     color: '#7c3aed',
     defaults: {
       name:        { value: '' },
+      server:      { value: '', type: 'modpackqt-config' },
       targetHost:  { value: '192.168.1.10', required: true },
       targetPort:  { value: 502, required: true, validate: RED.validators.number() },
       unitId:      { value: 1, required: true, validate: RED.validators.number() },
@@ -18,6 +19,8 @@
     paletteLabel: 'modbus master probe',
     oneditprepare: function () {
       const node = this;
+      // Optional cloud profile picker (fills targetHost/targetPort/unitId)
+      if (window.ModPackQTMasterPicker) ModPackQTMasterPicker.attach(this);
       const buildLink = (info) => {
         const probeHost = (info && info.host) || '127.0.0.1';
         const probePort = (info && info.port) || 8502;
@@ -46,6 +49,18 @@
     <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
     <input type="text" id="node-input-name" placeholder="(optional, e.g. Inverter A)">
   </div>
+  <div class="form-row">
+    <label for="node-input-server"><i class="fa fa-cog"></i> Runtime <span style="color:#9ca3af;font-weight:normal">(for picker)</span></label>
+    <input type="text" id="node-input-server">
+  </div>
+  <div class="form-row">
+    <label for="node-input-modpackqt-picker"><i class="fa fa-cloud-download"></i> My Profiles</label>
+    <select id="node-input-modpackqt-picker" style="width:65%"></select>
+    <button type="button" id="modpackqt-picker-refresh" class="red-ui-button" title="Reload from modpackqt.com" style="margin-left:4px"><i class="fa fa-refresh"></i></button>
+  </div>
+  <div class="form-tips" style="font-size:11px;color:#6b7280;margin:-8px 0 8px 105px">
+    Pick a saved Modbus profile from your account — fills host/port/unit below. Requires Account Key on the runtime config.
+  </div>
   <div class="form-row">
     <label for="node-input-targetHost"><i class="fa fa-plug"></i> Target Host</label>
     <input type="text" id="node-input-targetHost" placeholder="192.168.1.10">

package/nodes/modpackqt-master-read.html

@@ -19,10 +19,55 @@
     label: function () {
       return this.name || `Master Read FC${this.functionCode} @${this.address}`;
     },
-    paletteLabel: 'modbus master read'
+    paletteLabel: 'modbus master read',
+    oneditprepare: function () { ModPackQTMasterPicker.attach(this); }
   });
 </script>
 
+<!-- Shared picker helper — loaded once per editor session -->
+<script type="text/javascript">
+  if (!window.ModPackQTMasterPicker) {
+    window.ModPackQTMasterPicker = {
+      attach: function (node) {
+        const $sel = $('#node-input-modpackqt-picker');
+        if (!$sel.length) return;
+        const reload = function () {
+          const cfgId = $('#node-input-server').val();
+          $sel.empty().append('<option value="">— Loading… —</option>');
+          if (!cfgId || cfgId === '_ADD_') {
+            $sel.empty().append('<option value="">— Set runtime config first —</option>');
+            return;
+          }
+          $.getJSON('modpackqt/connections?config=' + encodeURIComponent(cfgId))
+            .done(function (rows) {
+              $sel.empty().append('<option value="">— Manual entry below —</option>');
+              (rows || [])
+                .filter(function (c) { return c && (c.connectionType === 'tcp' || !c.connectionType); })
+                .forEach(function (c) {
+                  const label = (c.name || '(unnamed)') + ' — ' + (c.host || '?') + ':' + (c.port || 502) + ' #' + (c.unitId || 1);
+                  $('<option>').val(c.id).text(label).data('row', c).appendTo($sel);
+                });
+            })
+            .fail(function (xhr) {
+              const msg = (xhr.responseJSON && xhr.responseJSON.error) || ('HTTP ' + xhr.status);
+              $sel.empty().append($('<option>').val('').text('— ' + msg + ' —'));
+            });
+        };
+        $('#node-input-server').on('change', reload);
+        $('#modpackqt-picker-refresh').on('click', function (e) { e.preventDefault(); reload(); });
+        $sel.on('change', function () {
+          const row = $(this).find('option:selected').data('row');
+          if (!row) return;
+          $('#node-input-targetHost').val(row.host || '');
+          $('#node-input-targetPort').val(row.port || 502);
+          $('#node-input-unitId').val(row.unitId || 1);
+        });
+        reload();
+      }
+    };
+  }
+</script>
+
 <script type="text/html" data-template-name="modpackqt-master-read">
   <div class="form-row">
     <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
@@ -32,6 +77,14 @@
     <label for="node-input-server"><i class="fa fa-cog"></i> Runtime</label>
     <input type="text" id="node-input-server">
   </div>
+  <div class="form-row">
+    <label for="node-input-modpackqt-picker"><i class="fa fa-cloud-download"></i> My Profiles</label>
+    <select id="node-input-modpackqt-picker" style="width:65%"></select>
+    <button type="button" id="modpackqt-picker-refresh" class="red-ui-button" title="Reload from modpackqt.com" style="margin-left:4px"><i class="fa fa-refresh"></i></button>
+  </div>
+  <div class="form-tips" style="font-size:11px;color:#6b7280;margin:-8px 0 8px 105px">
+    Pick a saved Modbus profile from your account — fills host/port/unit below. Requires Account Key on the runtime config.
+  </div>
   <div class="form-row">
     <label for="node-input-targetHost"><i class="fa fa-plug"></i> Target Host</label>
     <input type="text" id="node-input-targetHost" placeholder="Modbus device IP/hostname (TCP only)">

package/nodes/modpackqt-master-write.html

@@ -17,7 +17,8 @@
     label: function () {
       return this.name || `Master Write FC${this.functionCode} @${this.address}`;
     },
-    paletteLabel: 'modbus master write'
+    paletteLabel: 'modbus master write',
+    oneditprepare: function () { if (window.ModPackQTMasterPicker) ModPackQTMasterPicker.attach(this); }
   });
 </script>
 
@@ -30,6 +31,14 @@
     <label for="node-input-server"><i class="fa fa-cog"></i> Runtime</label>
     <input type="text" id="node-input-server">
   </div>
+  <div class="form-row">
+    <label for="node-input-modpackqt-picker"><i class="fa fa-cloud-download"></i> My Profiles</label>
+    <select id="node-input-modpackqt-picker" style="width:65%"></select>
+    <button type="button" id="modpackqt-picker-refresh" class="red-ui-button" title="Reload from modpackqt.com" style="margin-left:4px"><i class="fa fa-refresh"></i></button>
+  </div>
+  <div class="form-tips" style="font-size:11px;color:#6b7280;margin:-8px 0 8px 105px">
+    Pick a saved Modbus profile from your account — fills host/port/unit below. Requires Account Key on the runtime config.
+  </div>
   <div class="form-row">
     <label for="node-input-targetHost"><i class="fa fa-plug"></i> Target Host</label>
     <input type="text" id="node-input-targetHost" placeholder="Modbus device IP/hostname (TCP only)">

package/nodes/modpackqt-slave-probe.html

@@ -4,6 +4,7 @@
     color: '#7c3aed',
     defaults: {
       name:     { value: '' },
+      server:   { value: '', type: 'modpackqt-config' },
       bindHost: { value: '0.0.0.0' },
       bindPort: { value: 1502, required: true, validate: RED.validators.number() },
       unitId:   { value: 1, required: true, validate: RED.validators.number() }
@@ -17,6 +18,8 @@
     paletteLabel: 'modbus slave probe',
     oneditprepare: function () {
       const node = this;
+      // Optional cloud slave-config picker (fills bindPort/unitId)
+      if (window.ModPackQTSlavePicker) ModPackQTSlavePicker.attach(this);
       const buildLink = (info) => {
         const probeHost = (info && info.host) || '127.0.0.1';
         const probePort = (info && info.port) || 8502;
@@ -38,11 +41,66 @@
   });
 </script>
 
+<!-- Shared slave-picker helper — loaded once per editor session -->
+<script type="text/javascript">
+  if (!window.ModPackQTSlavePicker) {
+    window.ModPackQTSlavePicker = {
+      attach: function (node) {
+        const $sel = $('#node-input-modpackqt-slave-picker');
+        if (!$sel.length) return;
+        const reload = function () {
+          const cfgId = $('#node-input-server').val();
+          $sel.empty().append('<option value="">— Loading… —</option>');
+          if (!cfgId || cfgId === '_ADD_') {
+            $sel.empty().append('<option value="">— Set runtime config first —</option>');
+            return;
+          }
+          $.getJSON('modpackqt/slaves?config=' + encodeURIComponent(cfgId))
+            .done(function (rows) {
+              $sel.empty().append('<option value="">— Manual entry below —</option>');
+              (rows || [])
+                .filter(function (s) { return s && (s.protocol === 'tcp' || !s.protocol); })
+                .forEach(function (s) {
+                  const label = (s.name || '(unnamed)') + ' — :' + (s.port || 1502) + ' #' + (s.unitId || 1);
+                  $('<option>').val(s.id).text(label).data('row', s).appendTo($sel);
+                });
+            })
+            .fail(function (xhr) {
+              const msg = (xhr.responseJSON && xhr.responseJSON.error) || ('HTTP ' + xhr.status);
+              $sel.empty().append($('<option>').val('').text('— ' + msg + ' —'));
+            });
+        };
+        $('#node-input-server').on('change', reload);
+        $('#modpackqt-slave-picker-refresh').on('click', function (e) { e.preventDefault(); reload(); });
+        $sel.on('change', function () {
+          const row = $(this).find('option:selected').data('row');
+          if (!row) return;
+          $('#node-input-bindPort').val(row.port  || 1502);
+          $('#node-input-unitId').val(row.unitId || 1);
+        });
+        reload();
+      }
+    };
+  }
+</script>
+
 <script type="text/html" data-template-name="modpackqt-slave-probe">
   <div class="form-row">
     <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
     <input type="text" id="node-input-name" placeholder="(optional, e.g. Fake Inverter)">
   </div>
+  <div class="form-row">
+    <label for="node-input-server"><i class="fa fa-cog"></i> Runtime <span style="color:#9ca3af;font-weight:normal">(for picker)</span></label>
+    <input type="text" id="node-input-server">
+  </div>
+  <div class="form-row">
+    <label for="node-input-modpackqt-slave-picker"><i class="fa fa-cloud-download"></i> My Slaves</label>
+    <select id="node-input-modpackqt-slave-picker" style="width:65%"></select>
+    <button type="button" id="modpackqt-slave-picker-refresh" class="red-ui-button" title="Reload from modpackqt.com" style="margin-left:4px"><i class="fa fa-refresh"></i></button>
+  </div>
+  <div class="form-tips" style="font-size:11px;color:#6b7280;margin:-8px 0 8px 105px">
+    Pick a saved slave config from your account — fills port/unit below. Requires Account Key on the runtime config.
+  </div>
   <div class="form-row">
     <label for="node-input-bindHost"><i class="fa fa-globe"></i> Bind Host</label>
     <input type="text" id="node-input-bindHost" placeholder="0.0.0.0 (all interfaces)">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-red-contrib-modbus-modpackqt",
-  "version": "3.1.1",
+  "version": "3.2.0",
   "description": "Modbus commissioning, testing & analysis tools for Node-RED. Embedded Modbus TCP/RTU master + slave server, FC1/FC2/FC3/FC4 reads, FC5/FC6/FC15/FC16 writes, built-in slave register store, and a passive traffic monitor for debugging. 100% free, MIT, no usage limits. By ModPackQT — open the matching web console at modpackqt.com for register decoding, simulation and AI assistance.",
   "keywords": [
     "node-red",