node-red-contrib-uos-nats 1.4.0 → 1.4.6

package/README.md

@@ -109,6 +109,33 @@ Publishes your own data to the Data Hub.
 
 ---
 
+### 3. u-OS API Node (Orange)
+The **u-OS API** node provides a unified HTTP interface for both DataHub Variables and System Administration.
+
+*   **Mode: DataHub Variables**
+    *   Alternative access to variables via HTTP (REST) instead of NATS.
+    *   Actions: `Read`, `Write`, `List Providers`, `List Variables`.
+    *   Useful for one-off requests or environments where NATS is restricted.
+
+*   **Mode: System Administration**
+    *   Manage the u-OS device itself.
+    *   **Categories**:
+        *   **System**: Get info, nameplate, disk usage, or trigger reboot.
+        *   **Network**: Read/Write network IP/Gateway/DNS configuration.
+        *   **Security**: Enable/Disable Root access.
+        *   **Logging**: Access system logs and trigger reports.
+        *   **Recovery**: Factory Reset.
+    *   **Requirements**: You must enable **System Admin Access** in the `u-OS Config` node to grant the necessary OAuth scopes (`u-os-adm.*`).
+
+## Configuration
+1.  **Host**: IP address of the u-OS device (default: `127.0.0.1` for local Node-RED).
+2.  **Auth**: Client ID and Client Secret (from u-OS Device Administration).
+3.  **Scopes**:
+    *   Standard scopes for DataHub are active by default.
+    *   Check **"Enable System Admin Access"** to manage the system.
+
+---
+
 ## Performance & Reliability
 - **High-Speed Decoding (Filter-on-Decode):** The node now intelligently filters incoming data at the byte-level. Even if a provider sends thousands of variables, Node-RED only decodes the ones you have selected. This massively reduces CPU usage.
 - **Large Buffers:** The internal NATS buffer has been increased (10MB) to handle event bursts (e.g. rapid switching).

package/examples/uos-api-demo.json

@@ -0,0 +1,150 @@
+[
+    {
+        "id": "intro-tab",
+        "type": "tab",
+        "label": "u-OS API Demo",
+        "disabled": false,
+        "info": "Example flow for the **u-OS API** node.\n\nDemonstrates:\n1. **System Admin**: Getting System Info (CPU, OS Model)\n2. **DataHub**: Reading a variable via HTTP (instead of NATS)\n\n**Setup:**\n- Open the `u-OS API` nodes and configure your `u-OS Config` credentials.\n- Determine a valid Provider/Variable for the DataHub test."
+    },
+    {
+        "id": "inject-sys-info",
+        "type": "inject",
+        "z": "intro-tab",
+        "name": "Get System Info",
+        "props": [
+            {
+                "p": "payload"
+            },
+            {
+                "p": "topic",
+                "vt": "str"
+            }
+        ],
+        "repeat": "",
+        "crontab": "",
+        "once": false,
+        "onceDelay": 0.1,
+        "topic": "",
+        "payload": "",
+        "payloadType": "date",
+        "x": 160,
+        "y": 120,
+        "wires": [
+            [
+                "uos-api-sys-info"
+            ]
+        ]
+    },
+    {
+        "id": "uos-api-sys-info",
+        "type": "uos-api",
+        "z": "intro-tab",
+        "name": "System Info",
+        "uosConfig": "config-node-id",
+        "mode": "system",
+        "dhAction": "read",
+        "dhProvider": "",
+        "dhVariable": "",
+        "sysCategory": "system",
+        "sysAction": "info",
+        "x": 370,
+        "y": 120,
+        "wires": [
+            [
+                "debug-sys-info"
+            ]
+        ]
+    },
+    {
+        "id": "debug-sys-info",
+        "type": "debug",
+        "z": "intro-tab",
+        "name": "System Info Output",
+        "active": true,
+        "tosidebar": true,
+        "console": false,
+        "tostatus": false,
+        "complete": "payload",
+        "targetType": "msg",
+        "statusVal": "",
+        "statusType": "auto",
+        "x": 590,
+        "y": 120,
+        "wires": []
+    },
+    {
+        "id": "inject-dh-read",
+        "type": "inject",
+        "z": "intro-tab",
+        "name": "Read Variable (HTTP)",
+        "props": [
+            {
+                "p": "payload"
+            },
+            {
+                "p": "topic",
+                "vt": "str"
+            }
+        ],
+        "repeat": "",
+        "crontab": "",
+        "once": false,
+        "onceDelay": 0.1,
+        "topic": "",
+        "payload": "",
+        "payloadType": "date",
+        "x": 180,
+        "y": 220,
+        "wires": [
+            [
+                "uos-api-dh-read"
+            ]
+        ]
+    },
+    {
+        "id": "uos-api-dh-read",
+        "type": "uos-api",
+        "z": "intro-tab",
+        "name": "Read via HTTP",
+        "uosConfig": "config-node-id",
+        "mode": "datahub",
+        "dhAction": "read",
+        "dhProvider": "u_os_adm",
+        "dhVariable": "digital_nameplate.serial_number",
+        "sysCategory": "system",
+        "sysAction": "info",
+        "x": 380,
+        "y": 220,
+        "wires": [
+            [
+                "debug-dh-read"
+            ]
+        ]
+    },
+    {
+        "id": "debug-dh-read",
+        "type": "debug",
+        "z": "intro-tab",
+        "name": "Variable Value",
+        "active": true,
+        "tosidebar": true,
+        "console": false,
+        "tostatus": false,
+        "complete": "payload",
+        "targetType": "msg",
+        "statusVal": "",
+        "statusType": "auto",
+        "x": 580,
+        "y": 220,
+        "wires": []
+    },
+    {
+        "id": "config-node-id",
+        "type": "uos-config",
+        "name": "Local u-OS",
+        "host": "127.0.0.1",
+        "port": 4222,
+        "clientName": "nodered",
+        "enableSystemAdmin": true
+    }
+]

package/nodes/icons/uos-api.svg

@@ -1,4 +1,4 @@
 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 60 60" width="60" height="60">
-    <rect width="60" height="60" rx="6" ry="6" fill="#a6bbcf" />
-    <text x="50%" y="55%" dominant-baseline="middle" text-anchor="middle" font-family="sans-serif" font-weight="bold" font-size="24" fill="white">API</text>
+    <rect width="60" height="60" rx="6" ry="6" fill="#FFCC66" />
+    <text x="50%" y="55%" dominant-baseline="middle" text-anchor="middle" font-family="sans-serif" font-weight="bold" font-size="24" fill="#333">API</text>
 </svg>

package/nodes/uos-api.html

@@ -0,0 +1,492 @@
+RED.nodes.registerType('uos-api', {
+category: 'Weidmueller DataHub',
+color: '#FFCC66',
+defaults: {
+name: { value: "" },
+uosConfig: { type: "uos-config", required: true },
+mode: { value: "datahub" },
+
+// DataHub
+dhAction: { value: "read" },
+dhProvider: { value: "" },
+dhVariable: { value: "" },
+
+// System
+sysCategory: { value: "system" },
+sysAction: { value: "info" }
+},
+inputs: 1,
+outputs: 1,
+icon: "uos-api.svg",
+label: function () {
+return this.name || "u-OS API";
+},
+oneditprepare: function () {
+$("#node-input-mode").on("change", function () {
+var mode = $(this).val();
+if (mode === "datahub") {
+$(".uos-mode-datahub").show();
+$(".uos-mode-system").hide();
+$("#node-input-dhAction").change(); // Trigger redraw of vars
+} else {
+$(".uos-mode-datahub").hide();
+$(".uos-mode-system").show();
+}
+});
+
+// DataHub Action UI refinements
+$("#node-input-dhAction").on("change", function () {
+var action = $(this).val();
+if (action === "list_providers") {
+$("#node-input-dhProvider").parent().hide();
+$("#node-input-dhVariable").parent().hide();
+} else if (action === "list_variables") {
+$("#node-input-dhProvider").parent().show();
+$("#node-input-dhVariable").parent().hide();
+} else {
+$("#node-input-dhProvider").parent().show();
+$("#node-input-dhVariable").parent().show();
+}
+});
+
+// System Action Dynamic Options
+const sysActions = {
+system: [
+{ val: "info", label: "Get System Info (Model, CPU, Version)" },
+{ val: "nameplate", label: "Get Digital Nameplate (Serial, etc.)" },
+{ val: "disks", label: "Get Disk Usage" },
+{ val: "reboot", label: "Reboot System [POST]" }
+],
+network: [
+{ val: "get_state", label: "Get Network State (IPs)" },
+{ val: "get_config", label: "Get Network Config (Settings)" },
+{ val: "set_config", label: "Set Network Config (PUT)" },
+{ val: "update_config", label: "Update Network Config (PATCH)" }
+],
+logging: [
+{ val: "entries", label: "Get Log Entries" },
+{ val: "sources", label: "Get Log Sources" },
+{ val: "create_report", label: "Create Log Report [POST]" }
+],
+security: [
+{ val: "get_config", label: "Get Security Config (Root Access)" },
+{ val: "set_config", label: "Set Security Config (PUT)" }
+],
+recovery: [
+{ val: "factory_reset", label: "Factory Reset [POST]" }
+]
+};
+
+$("#node-input-sysCategory").on("change", function () {
+var cat = $(this).val();
+var actions = sysActions[cat] || [];
+var select = $("#node-input-sysAction");
+select.empty();
+actions.forEach(function (a) {
+select.append($("<option></option>").attr("value", a.val).text(a.label));
+});
+
+// If the current sysAction value is not valid for this category, reset it
+const currentVal = $("#node-input-sysAction").val();
+let found = false;
+actions.forEach(action => { if (action.val === currentVal) found = true; });
+
+if (!found && actions.length > 0) {
+$("#node-input-sysAction").val(actions[0].val);
+} else if (found) {
+$("#node-input-sysAction").val(currentVal);
+}
+});
+
+// Provider Browsing
+$("#btn-fetch-providers").click(function() {
+var configId = $("#node-input-uosConfig").val();
+if (!configId || configId == "_ADD_") {
+RED.notify("Please select a u-OS Config first.", "error");
+return;
+}
+
+var $btn = $(this); $btn.prop('disabled', true);
+
+$.getJSON('uos-api/providers/' + configId, function(data) {
+$btn.prop('disabled', false);
+if (!Array.isArray(data)) { RED.notify("Invalid response", "error"); return; }
+
+// Simple replacement with autocomplete or just a quick select list could be better
+// For now, let's just show a notification list or simplistic approach
+// Ideally we would replace the input with a select, but we want to allow custom text.
+// Let's use a jQuery UI dialog or simple prompt-like behavior?
+// Let's replace the Input with a Select momentarily to let user pick?
+
+var providers = data.map(p => p.id);
+// Use TypeInput's autocomplete? Or just standard array?
+$("#node-input-dhProvider").autocomplete({
+source: providers,
+minLength: 0
+}).autocomplete("search", "");
+
+RED.notify("Found " + providers.length + " providers. Start typing to see suggestions.", "success");
+
+}).fail(function(jqxhr) {
+$btn.prop('disabled', false);
+RED.notify("Failed to load providers: " + (jqxhr.responseJSON?.error || "Unknown"), "error");
+});
+});
+
+category: 'Weidmueller DataHub',
+color: '#FFCC66',
+defaults: {
+name: { value: "" },
+uosConfig: { type: "uos-config", required: true },
+mode: { value: "datahub" },
+
+// DataHub
+dhAction: { value: "read" },
+dhProvider: { value: "" },
+dhVariable: { value: "" },
+
+// System
+sysCategory: { value: "system" },
+sysAction: { value: "info" }
+},
+inputs: 1,
+outputs: 1,
+icon: "uos-api.svg",
+label: function () {
+return this.name || "u-OS API";
+},
+oneditprepare: function () {
+$("#node-input-mode").on("change", function () {
+var mode = $(this).val();
+if (mode === "datahub") {
+$(".uos-mode-datahub").show();
+$(".uos-mode-system").hide();
+$("#node-input-dhAction").change(); // Trigger redraw of vars
+} else {
+$(".uos-mode-datahub").hide();
+$(".uos-mode-system").show();
+}
+});
+
+// DataHub Action UI refinements
+$("#node-input-dhAction").on("change", function () {
+var action = $(this).val();
+if (action === "list_providers") {
+$("#node-input-dhProvider").parent().hide();
+$("#node-input-dhVariable").parent().hide();
+} else if (action === "list_variables") {
+$("#node-input-dhProvider").parent().show();
+$("#node-input-dhVariable").parent().hide();
+} else {
+$("#node-input-dhProvider").parent().show();
+$("#node-input-dhVariable").parent().show();
+}
+});
+
+// System Action Dynamic Options
+const sysActions = {
+system: [
+{ val: "info", label: "Get System Info (Model, CPU, Version)" },
+{ val: "nameplate", label: "Get Digital Nameplate (Serial, etc.)" },
+{ val: "disks", label: "Get Disk Usage" },
+{ val: "reboot", label: "Reboot System [POST]" }
+],
+network: [
+{ val: "get_state", label: "Get Network State (IPs)" },
+{ val: "get_config", label: "Get Network Config (Settings)" },
+{ val: "set_config", label: "Set Network Config (PUT)" },
+{ val: "update_config", label: "Update Network Config (PATCH)" }
+],
+logging: [
+{ val: "entries", label: "Get Log Entries" },
+{ val: "sources", label: "Get Log Sources" },
+{ val: "create_report", label: "Create Log Report [POST]" }
+],
+security: [
+{ val: "get_config", label: "Get Security Config (Root Access)" },
+{ val: "set_config", label: "Set Security Config (PUT)" }
+],
+recovery: [
+{ val: "factory_reset", label: "Factory Reset [POST]" }
+]
+};
+
+$("#node-input-sysCategory").on("change", function () {
+var cat = $(this).val();
+var actions = sysActions[cat] || [];
+var select = $("#node-input-sysAction");
+select.empty();
+actions.forEach(function (a) {
+select.append($("<option></option>").attr("value", a.val).text(a.label));
+});
+
+// If the current sysAction value is not valid for this category, reset it
+const currentVal = $("#node-input-sysAction").val();
+let found = false;
+actions.forEach(action => { if (action.val === currentVal) found = true; });
+
+if (!found && actions.length > 0) {
+$("#node-input-sysAction").val(actions[0].val);
+} else if (found) {
+$("#node-input-sysAction").val(currentVal);
+}
+});
+
+// Provider Browsing
+$("#btn-fetch-providers").click(function() {
+var configId = $("#node-input-uosConfig").val();
+if (!configId || configId == "_ADD_") {
+RED.notify("Please select a u-OS Config first.", "error");
+return;
+}
+
+var $btn = $(this); $btn.prop('disabled', true);
+
+$.getJSON('uos-api/providers/' + configId, function(data) {
+$btn.prop('disabled', false);
+if (!Array.isArray(data)) { RED.notify("Invalid response", "error"); return; }
+
+// Simple replacement with autocomplete or just a quick select list could be better
+// For now, let's just show a notification list or simplistic approach
+// Ideally we would replace the input with a select, but we want to allow custom text.
+// Let's use a jQuery UI dialog or simple prompt-like behavior?
+// Let's replace the Input with a Select momentarily to let user pick?
+
+var providers = data.map(p => p.id);
+// Use TypeInput's autocomplete? Or just standard array?
+$("#node-input-dhProvider").autocomplete({
+source: providers,
+minLength: 0
+}).autocomplete("search", "");
+
+RED.notify("Found " + providers.length + " providers. Start typing to see suggestions.", "success");
+
+}).fail(function(jqxhr) {
+$btn.prop('disabled', false);
+RED.notify("Failed to load providers: " + (jqxhr.responseJSON?.error || "Unknown"), "error");
+});
+});
+
+// Variable Browsing
+$("#btn-fetch-variables").click(function() {
+var configId = $("#node-input-uosConfig").val();
+var provider = $("#node-input-dhProvider").val();
+
+if (!configId || configId == "_ADD_") { RED.notify("Please select a u-OS Config first.", "error"); return; }
+if (!provider) { RED.notify("Please enter a Provider ID first.", "error"); return; }
+var $btn = $(this); $btn.prop('disabled', true);
+var $container = $("#var-browser-container");
+var $list = $("#var-select-list");
+
+// Switch to a div based list for checkboxes instead of select
+// Or verify if current element is select? It is. Let's replace it dynamically or change HTML.
+// Easier: Change HTML in previous step? No, let's manipulate DOM here or use the select with 'multiple' attribute.
+
+// Let's use a standard multiple select
+$list.attr("multiple", "multiple");
+$list.css("height", "200px");
+
+$container.show();
+$list.html('<option>Loading...</option>');
+
+$.getJSON('uos-api/variables/' + configId + '/' + provider, function(data) {
+$btn.prop('disabled', false);
+$list.empty();
+
+if (data.length === 0) {
+$list.append('<option disabled>No variables found</option>');
+return;
+}
+
+// Sort
+data.sort((a,b) => a.key.localeCompare(b.key));
+
+data.forEach(v => {
+$list.append($("<option>", { value: v.key, text: v.key }));
+    });
+
+    // Add a helper text/button to confirm selection
+    if ($("#btn-confirm-vars").length === 0) {
+    $container.append('<div style="margin-top:5px; text-align:right;"><small>Hold Ctrl for multi-select</small> <button
+            id="btn-confirm-vars" class="red-ui-button red-ui-button-small">Apply Selected</button></div>');
+
+    $("#btn-confirm-vars").click(function(e) {
+    e.preventDefault();
+    var selected = $list.val(); // Returns array for multiple select
+    if (selected && selected.length > 0) {
+    $("#node-input-dhVariable").val(selected.join(', '));
+    $container.hide();
+    }
+    });
+    }
+
+    // Filter Logic (refined for options)
+    $("#var-filter").off("keyup").on("keyup", function() {
+    var val = $(this).val().toLowerCase();
+    $list.find("option").each(function() {
+    var text = $(this).text().toLowerCase();
+    $(this).toggle(text.indexOf(val) > -1);
+    });
+    });
+
+    }).fail(function(jqxhr) {
+    $btn.prop('disabled', false);
+    $container.hide();
+    RED.notify("Failed to load variables: " + (jqxhr.responseJSON?.error || "Unknown"), "error");
+    });
+    });
+    }
+    });
+    </script>
+
+    <script type="text/html" data-template-name="uos-api">
+    <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="Name">
+    </div>
+    <div class="form-row">
+        <label for="node-input-uosConfig"><i class="fa fa-cog"></i> u-OS Config</label>
+        <input type="text" id="node-input-uosConfig">
+    </div>
+    <div class="form-row">
+        <label for="node-input-mode"><i class="fa fa-sliders"></i> Mode</label>
+        <select id="node-input-mode">
+            <option value="datahub">DataHub Variables</option>
+            <option value="system">System Administration</option>
+        </select>
+    </div>
+
+    <!-- DataHub Mode -->
+    <div class="uos-mode-datahub">
+        <div class="form-row">
+            <label for="node-input-dhAction"><i class="fa fa-play"></i> Action</label>
+            <select id="node-input-dhAction">
+                <option value="read">Read Variable</option>
+                <option value="write">Write Variable</option>
+                <option value="list_providers">List Providers</option>
+                <option value="list_variables">List Variables</option>
+            </select>
+        </div>
+        
+        <div class="form-row">
+            <label for="node-input-dhProvider"><i class="fa fa-server"></i> Provider</label>
+            <div style="display:flex; width:70%;">
+                <input type="text" id="node-input-dhProvider" placeholder="e.g. u_os_sbm" style="flex:1;">
+                <button id="btn-fetch-providers" class="red-ui-button" style="margin-left: 5px;" title="Load Providers"><i class="fa fa-refresh"></i></button>
+            </div>
+        </div>
+
+        <div class="form-row" id="row-dhVariable">
+            <label for="node-input-dhVariable"><i class="fa fa-tag"></i> Variable</label>
+            <div style="display:flex; width:70%;">
+                 <input type="text" id="node-input-dhVariable" placeholder="e.g. digital_nameplate..." style="flex:1;">
+                 <button id="btn-fetch-variables" class="red-ui-button" style="margin-left: 5px;" title="Browse Variables"><i class="fa fa-list"></i></button>
+            </div>
+            <div id="var-browser-container" style="display:none; margin-top:10px; border:1px solid #ccc; background:#fff; padding:5px;">
+                 <input type="text" id="var-filter" placeholder="Filter variables..." style="width:100%; box-sizing:border-box; margin-bottom:5px;">
+                 <select id="var-select-list" size="10" style="width:100%; border:1px solid #eee;"></select>
+            </div>
+        </div>
+    </div>
+
+    <!-- System Mode -->
+    <div class="uos-mode-system" style="display:none;">
+        <div class="form-row">
+            <label for="node-input-sysCategory"><i class="fa fa-folder"></i> Category</label>
+            <select id="node-input-sysCategory">
+                <option value="system">System</option>
+                <option value="network">Network</option>
+                <option value="logging">Logging</option>
+                <option value="security">Security</option>
+                <option value="recovery">Recovery</option>
+            </select>
+        </div>
+        <div class="form-row">
+            <label for="node-input-sysAction"><i class="fa fa-bolt"></i> Action</label>
+            <select id="node-input-sysAction">
+                <!-- Populated dynamically -->
+            </select>
+        </div>
+    </div>
+</script>
+
+    <script type="text/html" data-help-name="uos-api">
+    <p>A unified node for interacting with Weidmüller u-OS HTTP APIs.</p>
+    
+    <h3>Prerequisites</h3>
+    <p>This node uses OAuth2 for authentication. You must configure the <b>u-OS Config</b> node.</p>
+    <ul>
+        <li>For <b>DataHub</b> access, standard scopes are used.</li>
+        <li>For <b>System Administration</b>, you must check <b>Enable System Admin Access</b> in the Config node to grant permissions (<code>u-os-adm.*</code>).</li>
+    </ul>
+
+    <h3>Modes</h3>
+    
+    <h4>1. DataHub Variables</h4>
+    <p>Access the DataHub Variable API directly over HTTP. Useful when NATS is not available or for simple request/response flows.</p>
+    <dl class="message-properties">
+        <dt>Read Variable</dt>
+        <dd>Gets the current value. Input <code>msg.provider</code> and <code>msg.variable</code> can override config.</dd>
+        
+        <dt>Write Variable</dt>
+        <dd>Writes <code>msg.payload</code> to the variable. Must match the variable's expected type.</dd>
+        
+        <dt>List Providers</dt>
+        <dd>Returns a list of all active DataHub providers.</dd>
+        
+        <dt>List Variables</dt>
+        <dd>Returns a list of variables for a specific Provider.</dd>
+    </dl>
+
+    <h4>2. System Administration</h4>
+    <p>Manage the u-OS device settings and status. Corresponds to the System Administration API.</p>
+    
+    <dl class="message-properties">
+        <dt>System</dt>
+        <dd>
+            <ul>
+                <li><b>Get Info</b>: Device model, CPU info, OS version.</li>
+                <li><b>Get Nameplate</b>: Serial number, Mac address, hardware version.</li>
+                <li><b>Get Disks</b>: Internal and external storage usage.</li>
+                <li><b>Reboot</b>: Restarts the device immediately (POST).</li>
+            </ul>
+        </dd>
+
+        <dt>Network</dt>
+        <dd>
+            <ul>
+                <li><b>Get State</b>: Live interface status (IPs, Up/Down).</li>
+                <li><b>Get Config</b>: Current saved configuration.</li>
+                <li><b>Set Config</b>: Overwrite full network config (PUT). <code>msg.payload</code> must be a valid <code>NetworkConfig</code> object.</li>
+                <li><b>Update Config</b>: Patch specific settings (PATCH). <code>msg.payload</code> must be a valid Merge-Patch JSON.</li>
+            </ul>
+        </dd>
+
+        <dt>Logging</dt>
+        <dd>
+            <ul>
+                <li><b>Get Entries</b>: Fetch system logs.</li>
+                <li><b>Create Report</b>: Triggers log archive generation.</li>
+            </ul>
+        </dd>
+
+        <dt>Security</dt>
+        <dd>
+            <ul>
+                <li><b>Get/Set Config</b>: Manage Root Access enablement (<code>{ root_access: { enabled: true } }</code>).</li>
+            </ul>
+        </dd>
+        
+        <dt>Recovery</dt>
+        <dd><b>Factory Reset</b>: Resets device to factory defaults. Use with caution!</dd>
+    </dl>
+
+    <h3>Outputs</h3>
+    <dl class="message-properties">
+        <dt>payload <span class="property-type">object | string</span></dt>
+        <dd>The API response body.</dd>
+        
+        <dt>statusCode <span class="property-type">number</span></dt>
+        <dd>HTTP Status Code (200, 202, 403, etc.).</dd>
+    </dl>
+</script>

package/nodes/{uos-http.js → uos-api.js}

@@ -147,5 +147,77 @@ module.exports = function (RED) {
         });
     }
 
-    RED.nodes.registerType('uos-http', UosHttpNode);
+    // Admin API for Node-RED Editor (Browsing)
+    RED.httpAdmin.get('/uos-api/providers/:config', RED.auth.needsPermission('uos-api.read'), async function (req, res) {
+        try {
+            const configNode = RED.nodes.getNode(req.params.config);
+            if (!configNode) {
+                res.status(404).json({ error: "Config node not found/deployed" });
+                return;
+            }
+
+            const token = await configNode.getToken();
+            if (!token) {
+                res.status(401).json({ error: "No Access Token" });
+                return;
+            }
+
+            const agent = new https.Agent({ rejectUnauthorized: false });
+            const url = `https://${configNode.host}:443/u-os-hub/api/v1/providers`;
+
+            const response = await fetch(url, {
+                headers: { 'Authorization': `Bearer ${token}` },
+                agent: agent
+            });
+
+            if (!response.ok) throw new Error(`HTTP ${response.status}`);
+            const json = await response.json();
+            res.json(json.items || []);
+
+        } catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+
+    RED.httpAdmin.get('/uos-api/variables/:config/:provider', RED.auth.needsPermission('uos-api.read'), async function (req, res) {
+        try {
+            const configNode = RED.nodes.getNode(req.params.config);
+            const provider = req.params.provider;
+
+            if (!configNode) {
+                res.status(404).json({ error: "Config node not found/deployed" });
+                return;
+            }
+
+            const token = await configNode.getToken();
+            if (!token) {
+                res.status(401).json({ error: "No Access Token" });
+                return;
+            }
+
+            const agent = new https.Agent({ rejectUnauthorized: false });
+            const url = `https://${configNode.host}:443/u-os-hub/api/v1/providers/${provider}/variables`;
+
+            const response = await fetch(url, {
+                headers: { 'Authorization': `Bearer ${token}` },
+                agent: agent
+            });
+
+            if (!response.ok) throw new Error(`HTTP ${response.status}`);
+            const json = await response.json();
+
+            // Map to simple structure { key: "foo", type: "int" }
+            const simplified = (json.items || []).map(v => ({
+                key: v.key,
+                type: v.data_type
+            }));
+
+            res.json(simplified);
+
+        } catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+
+    RED.nodes.registerType('uos-api', UosHttpNode);
 };

package/nodes/uos-config.js

@@ -133,6 +133,8 @@ module.exports = function (RED) {
 
       this.pendingTokenRequest = (async () => {
         try {
+          this.log(`Requesting Token with Scopes: ${this.scope}`); // DEBUG Log
+
           const params = new URLSearchParams({
             grant_type: 'client_credentials',
             scope: this.scope,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-red-contrib-uos-nats",
-  "version": "1.4.0",
+  "version": "1.4.6",
   "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",
@@ -41,8 +41,8 @@
   },
   "dependencies": {
     "flatbuffers": "^25.9.23",
-    "nats": "^2.19.0",
-    "node-fetch": "^2.6.7"
+    "nats": "^2.29.3",
+    "node-fetch": "^2.7.0"
   },
   "files": [
     "nodes/",
@@ -57,7 +57,7 @@
       "datahub-input": "nodes/datahub-input.js",
       "datahub-output": "nodes/datahub-output.js",
       "datahub-write": "nodes/datahub-write.js",
-      "uos-http": "nodes/uos-http.js"
+      "uos-api": "nodes/uos-api.js"
     }
   },
   "scripts": {

package/nodes/uos-http.html

@@ -1,150 +0,0 @@
-<script type="text/javascript">
-    RED.nodes.registerType('uos-http', {
-        category: 'Web Services',
-        color: '#a6bbcf',
-        defaults: {
-            name: { value: "" },
-            uosConfig: { type: "uos-config", required: true },
-            mode: { value: "datahub" },
-
-            // DataHub
-            dhAction: { value: "read" },
-            dhProvider: { value: "" },
-            dhVariable: { value: "" },
-
-            // System
-            sysCategory: { value: "system" },
-            sysAction: { value: "info" }
-        },
-        inputs: 1,
-        outputs: 1,
-        icon: "uos-api.svg",
-        label: function () {
-            return this.name || "u-OS API";
-        },
-        oneditprepare: function () {
-            $("#node-input-mode").on("change", function () {
-                var mode = $(this).val();
-                if (mode === "datahub") {
-                    $(".uos-mode-datahub").show();
-                    $(".uos-mode-system").hide();
-                } else {
-                    $(".uos-mode-datahub").hide();
-                    $(".uos-mode-system").show();
-                }
-            });
-
-            // System Action Dynamic Options
-            const sysActions = {
-                system: [
-                    { val: "info", label: "Get System Info" },
-                    { val: "nameplate", label: "Get Nameplate" },
-                    { val: "disks", label: "Get Disks" },
-                    { val: "reboot", label: "Reboot System (POST)" }
-                ],
-                network: [
-                    { val: "get_state", label: "Get State" },
-                    { val: "get_config", label: "Get Config" },
-                    { val: "set_config", label: "Set Config (PUT)" },
-                    { val: "update_config", label: "Update Config (PATCH)" }
-                ],
-                logging: [
-                    { val: "entries", label: "Get Entries" },
-                    { val: "sources", label: "Get Sources" },
-                    { val: "create_report", label: "Create Report" }
-                ],
-                security: [
-                    { val: "get_config", label: "Get Config" },
-                    { val: "set_config", label: "Set Config (PUT)" }
-                ],
-                recovery: [
-                    { val: "factory_reset", label: "Factory Reset" }
-                ]
-            };
-
-            $("#node-input-sysCategory").on("change", function () {
-                var cat = $(this).val();
-                var actions = sysActions[cat] || [];
-                var select = $("#node-input-sysAction");
-                select.empty();
-                actions.forEach(function (a) {
-                    select.append($("<option></option>").attr("value", a.val).text(a.label));
-                });
-                // Restore previous value if feasible, otherwise select first
-                // (Logic simplified here)
-            });
-        }
-    });
-</script>
-
-<script type="text/html" data-template-name="uos-http">
-    <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="Name">
-    </div>
-    <div class="form-row">
-        <label for="node-input-uosConfig"><i class="fa fa-cog"></i> u-OS Config</label>
-        <input type="text" id="node-input-uosConfig">
-    </div>
-    <div class="form-row">
-        <label for="node-input-mode"><i class="fa fa-sliders"></i> Mode</label>
-        <select id="node-input-mode">
-            <option value="datahub">DataHub Variables</option>
-            <option value="system">System Administration</option>
-        </select>
-    </div>
-
-    <!-- DataHub Mode -->
-    <div class="uos-mode-datahub">
-        <div class="form-row">
-            <label for="node-input-dhAction"><i class="fa fa-play"></i> Action</label>
-            <select id="node-input-dhAction">
-                <option value="read">Read Variable</option>
-                <option value="write">Write Variable</option>
-                <option value="list_providers">List Providers</option>
-                <option value="list_variables">List Variables</option>
-            </select>
-        </div>
-        <div class="form-row">
-            <label for="node-input-dhProvider"><i class="fa fa-server"></i> Provider</label>
-            <input type="text" id="node-input-dhProvider" placeholder="e.g. u_os_sbm">
-        </div>
-        <div class="form-row">
-            <label for="node-input-dhVariable"><i class="fa fa-tag"></i> Variable</label>
-            <input type="text" id="node-input-dhVariable" placeholder="e.g. digital_nameplate.software_version">
-        </div>
-    </div>
-
-    <!-- System Mode -->
-    <div class="uos-mode-system" style="display:none;">
-        <div class="form-row">
-            <label for="node-input-sysCategory"><i class="fa fa-folder"></i> Category</label>
-            <select id="node-input-sysCategory">
-                <option value="system">System</option>
-                <option value="network">Network</option>
-                <option value="logging">Logging</option>
-                <option value="security">Security</option>
-                <option value="recovery">Recovery</option>
-            </select>
-        </div>
-        <div class="form-row">
-            <label for="node-input-sysAction"><i class="fa fa-bolt"></i> Action</label>
-            <select id="node-input-sysAction">
-                <!-- Populated dynamically -->
-            </select>
-        </div>
-    </div>
-</script>
-
-<script type="text/html" data-help-name="uos-http">
-    <p>A unified node for u-OS HTTP APIs.</p>
-    
-    <h3>Modes</h3>
-    <dl class="message-properties">
-        <dt>DataHub Variables</dt>
-        <dd>Access values via the standard DataHub HTTP API. Use for devices that don't support NATS or simple polling.</dd>
-        
-        <dt>System Administration</dt>
-        <dd>Manage the u-OS device: Network, Logs, Security, etc. Requires <b>Enable System Admin</b> in config.</dd>
-    </dl>
-</script>