@vitormnm/node-red-simple-opcua 1.6.3 → 1.8.0

package/client/opcua-client-config.html

@@ -3,16 +3,28 @@
         function toggleCredentials() {
             var authType = $("#node-config-input-authType").val();
             $(".opcua-client-auth-row").toggle(authType === "username");
+            if (authType === "anonymous") {
+                $("#node-config-input-username").val("");
+                $("#node-config-input-password").val("");
+            }
         }
 
         RED.nodes.registerType("opcua-client-config", {
             category: "config",
             defaults: {
                 name: { value: "" },
+                sessionName: { value: "ClientSession1" },
                 endpoint: { value: "opc.tcp://localhost:4840", required: true },
                 securityPolicy: { value: "None", required: true },
                 securityMode: { value: "None", required: true },
-                authType: { value: "anonymous", required: true }
+                authType: { value: "anonymous", required: true },
+                initialDelay: { value: 1000, validate: RED.validators.number() },
+                maxDelay: { value: 10000, validate: RED.validators.number() },
+                maxRetry: { value: -1, validate: RED.validators.number() },
+                requestedSessionTimeout: { value: 300000, validate: RED.validators.number() },
+                keepSessionAlive: { value: true },
+                autoReconnect: { value: true },
+                endpointMustExist: { value: false }
             },
             credentials: {
                 username: { type: "text" },
@@ -22,22 +34,87 @@
                 return this.name || this.endpoint || "opcua-client-config";
             },
             oneditprepare: function () {
+                if (this.keepSessionAlive !== false) {
+                    $("#node-config-input-keepSessionAlive").prop("checked", true);
+                }
+                if (this.autoReconnect !== false) {
+                    $("#node-config-input-autoReconnect").prop("checked", true);
+                }
+                if (this.endpointMustExist === true) {
+                    $("#node-config-input-endpointMustExist").prop("checked", true);
+                }
+                if (this.maxRetry === undefined || Number(this.maxRetry) === 10) {
+                    $("#node-config-input-maxRetry").val(-1);
+                }
+
                 $("#node-config-input-authType").on("change", toggleCredentials);
                 toggleCredentials();
+
+                $("#node-config-input-securityPolicy").on("change", function () {
+                    var policy = $(this).val();
+                    var modeSelect = $("#node-config-input-securityMode");
+                    var mode = modeSelect.val();
+                    if (policy === "None") {
+                        if (mode !== "None") {
+                            modeSelect.val("None");
+                        }
+                    } else {
+                        if (mode === "None") {
+                            modeSelect.val("SignAndEncrypt");
+                        }
+                    }
+                });
+
+                $("#node-config-input-securityMode").on("change", function () {
+                    var mode = $(this).val();
+                    var policySelect = $("#node-config-input-securityPolicy");
+                    var policy = policySelect.val();
+                    if (mode === "None") {
+                        if (policy !== "None") {
+                            policySelect.val("None");
+                        }
+                    } else {
+                        if (policy === "None") {
+                            policySelect.val("Basic256Sha256");
+                        }
+                    }
+                });
+
+                function toggleReconnect() {
+                    var autoReconnect = $("#node-config-input-autoReconnect").prop("checked");
+                    $(".opcua-client-reconnect-row").toggle(autoReconnect);
+                }
+                $("#node-config-input-autoReconnect").on("change", toggleReconnect);
+                toggleReconnect();
             }
         });
     })();
 </script>
 
 <script type="text/html" data-template-name="opcua-client-config">
+    <!-- Connection Section -->
+    <div class="form-row" style="margin-top: 10px; margin-bottom: 10px;">
+        <span style="font-weight: bold;"><i class="fa fa-plug"></i> Connection Settings</span>
+        <hr style="margin-top: 5px; margin-bottom: 10px; border: 0; border-top: 1px solid #ccc;"/>
+    </div>
     <div class="form-row">
         <label for="node-config-input-name"><i class="fa fa-tag"></i> Name</label>
         <input type="text" id="node-config-input-name" placeholder="OPC UA Client">
     </div>
+    <div class="form-row">
+        <label for="node-config-input-sessionName"><i class="fa fa-info-circle"></i> Session Name</label>
+        <input type="text" id="node-config-input-sessionName" placeholder="ClientSession1">
+    </div>
     <div class="form-row">
         <label for="node-config-input-endpoint"><i class="fa fa-plug"></i> Endpoint</label>
         <input type="text" id="node-config-input-endpoint" placeholder="opc.tcp://localhost:4840">
     </div>
+
+    <!-- Security Section -->
+    <div class="form-row" style="margin-top: 20px; margin-bottom: 10px;">
+        <span style="font-weight: bold;"><i class="fa fa-shield"></i> Security & Authentication</span>
+        <hr style="margin-top: 5px; margin-bottom: 10px; border: 0; border-top: 1px solid #ccc;"/>
+    </div>
     <div class="form-row">
         <label for="node-config-input-securityPolicy"><i class="fa fa-lock"></i> Security Policy</label>
         <select id="node-config-input-securityPolicy">
@@ -72,6 +149,46 @@
         <label for="node-config-input-password"><i class="fa fa-key"></i> Password</label>
         <input type="password" id="node-config-input-password">
     </div>
+
+    <!-- Client Settings Section -->
+    <div class="form-row" style="margin-top: 20px; margin-bottom: 10px;">
+        <span style="font-weight: bold;"><i class="fa fa-cog"></i> Client Settings</span>
+        <hr style="margin-top: 5px; margin-bottom: 10px; border: 0; border-top: 1px solid #ccc;"/>
+    </div>
+    <div class="form-row">
+        <label for="node-config-input-requestedSessionTimeout"><i class="fa fa-clock-o"></i> Session Timeout (ms)</label>
+        <input type="number" id="node-config-input-requestedSessionTimeout" placeholder="300000">
+    </div>
+    <div class="form-row" style="display: flex; align-items: center;">
+        <label for="node-config-input-keepSessionAlive" style="width: auto; margin-right: 10px;"><i class="fa fa-heartbeat"></i> Keep Session Alive</label>
+        <input type="checkbox" id="node-config-input-keepSessionAlive" style="width: auto; margin: 0;">
+    </div>
+    <div class="form-row" style="display: flex; align-items: center; margin-bottom: 5px;">
+        <label for="node-config-input-endpointMustExist" style="width: auto; margin-right: 10px;"><i class="fa fa-exclamation-circle"></i> Endpoint Must Exist</label>
+        <input type="checkbox" id="node-config-input-endpointMustExist" style="width: auto; margin: 0;">
+    </div>
+    <div style="font-size: 0.85em; color: #666; margin-left: 20px; margin-top: -5px; margin-bottom: 10px;">
+        Verify that the server endpoint matches the requested security policy and mode before connecting.
+    </div>
+    <div class="form-row" style="display: flex; align-items: center;">
+        <label for="node-config-input-autoReconnect" style="width: auto; margin-right: 10px;"><i class="fa fa-refresh"></i> Automatic Reconnect</label>
+        <input type="checkbox" id="node-config-input-autoReconnect" style="width: auto; margin: 0;">
+    </div>
+    <div class="form-row opcua-client-reconnect-row">
+        <label for="node-config-input-initialDelay"><i class="fa fa-clock-o"></i> Initial Delay (ms)</label>
+        <input type="number" id="node-config-input-initialDelay" placeholder="1000">
+    </div>
+    <div class="form-row opcua-client-reconnect-row">
+        <label for="node-config-input-maxDelay"><i class="fa fa-clock-o"></i> Max Delay (ms)</label>
+        <input type="number" id="node-config-input-maxDelay" placeholder="10000">
+    </div>
+    <div class="form-row opcua-client-reconnect-row">
+        <label for="node-config-input-maxRetry"><i class="fa fa-repeat"></i> Max Retries</label>
+        <input type="number" id="node-config-input-maxRetry" placeholder="-1">
+        <div style="font-size: 0.85em; color: #666; margin-left: 110px; margin-top: 2px;">
+            -1: Retry indefinitely. 0: Do not attempt to reconnect.
+        </div>
+    </div>
 </script>
 
 <script type="text/html" data-help-name="opcua-client-config">

package/client/opcua-client-config.js

@@ -1,11 +1,17 @@
 "use strict";
 
+const path = require("path");
+const { OPCUACertificateManager, UserTokenType } = require("node-opcua");
+
 const {
     OPCUAClient,
     getMethodArgumentDefinition,
     resolveMethodObjectId,
     resolveSecurityMode,
-    resolveSecurityPolicy
+    resolveSecurityPolicy,
+    AttributeIds,
+    dataValueToItemResult,
+    enrichItemResultWithEnumeration
 } = require("./opcua-client-utils");
 
 const {
@@ -23,10 +29,18 @@ module.exports = function (RED) {
         
 
         node.name = (config.name || "").trim();
+        node.sessionName = (config.sessionName || "ClientSession1").trim();
         node.endpoint = (config.endpoint || "").trim();
         node.securityPolicy = config.securityPolicy || "None";
         node.securityMode = config.securityMode || "None";
         node.authType = config.authType || "anonymous";
+        node.initialDelay = config.initialDelay !== undefined ? Number(config.initialDelay) : 1000;
+        node.maxDelay = config.maxDelay !== undefined ? Number(config.maxDelay) : 10000;
+        node.maxRetry = (config.maxRetry !== undefined && Number(config.maxRetry) !== 10) ? Number(config.maxRetry) : -1;
+        node.requestedSessionTimeout = config.requestedSessionTimeout !== undefined ? Number(config.requestedSessionTimeout) : 300000;
+        node.keepSessionAlive = config.keepSessionAlive !== false;
+        node.autoReconnect = config.autoReconnect !== false;
+        node.endpointMustExist = config.endpointMustExist === true;
         node.client = null;
         node.session = null;
         node.connectPromise = null;
@@ -52,23 +66,72 @@ module.exports = function (RED) {
         }
 
         this.connectPromise = (async () => {
+            const userDir = (RED.settings && RED.settings.userDir) || path.join(require('os').homedir(), ".node-red");
+            let flowFile = (RED.settings && RED.settings.flowFile) || "flows.json";
+            if (typeof flowFile !== "string") {
+                flowFile = "flows.json";
+            }
+            const flowFileFolder = path.isAbsolute(flowFile) ? path.dirname(flowFile) : path.join(userDir, path.dirname(flowFile));
+            const clientName = (this.name || "").trim() || this.sessionName || "default";
+            const safeClientName = clientName
+                .replace(/[\\/:\*\?"<>|]/g, "_")
+                .replace(/^\.+$/, "");
+            const clientCertificateFolder = path.join(flowFileFolder, "simple_opcua", "client", safeClientName);
+
+            // Ensure directories exist immediately
+            const fs = require("fs");
+            try {
+                const trustedDir = path.join(clientCertificateFolder, "trusted", "certs");
+                const rejectedDir = path.join(clientCertificateFolder, "rejected");
+                if (!fs.existsSync(trustedDir)) {
+                    fs.mkdirSync(trustedDir, { recursive: true });
+                }
+                if (!fs.existsSync(rejectedDir)) {
+                    fs.mkdirSync(rejectedDir, { recursive: true });
+                }
+            } catch (e) {
+                // Ignore directory creation errors
+            }
+
+            const clientCertificateManager = new OPCUACertificateManager({
+                rootFolder: clientCertificateFolder,
+                automaticallyAcceptUnknownCertificate: true
+            });
+            await clientCertificateManager.initialize();
+
             const client = OPCUAClient.create({
-                endpointMustExist: false,
-                keepSessionAlive: true,
+                endpointMustExist: this.endpointMustExist,
+                keepSessionAlive: this.keepSessionAlive,
                 securityMode: resolveSecurityMode(this.securityMode),
-                securityPolicy: resolveSecurityPolicy(this.securityPolicy)
+                securityPolicy: resolveSecurityPolicy(this.securityPolicy),
+                clientName: this.sessionName || "ClientSession",
+                clientCertificateManager: clientCertificateManager,
+                requestedSessionTimeout: this.requestedSessionTimeout,
+                connectionStrategy: {
+                    maxRetry: this.autoReconnect ? this.maxRetry : 0,
+                    initialDelay: this.initialDelay,
+                    maxDelay: this.maxDelay
+                }
             });
 
+            client._nextSessionName = () => {
+                return this.sessionName || "ClientSession1";
+            };
+
             try {
                 await client.connect(this.endpoint);
 
                 const credentials = this.credentials || {};
-                const session = this.authType === "username"
-                    ? await client.createSession({
+                let userIdentity = { type: UserTokenType.Anonymous };
+
+                if (this.authType === "username") {
+                    userIdentity = {
+                        type: UserTokenType.UserName,
                         userName: credentials.username || "",
                         password: credentials.password || ""
-                    })
-                    : await client.createSession();
+                    };
+                }
+                const session = await client.createSession(userIdentity);
 
                 session.on("session_closed", () => {
                     this.session = null;
@@ -154,11 +217,51 @@ module.exports = function (RED) {
             res.status(500).json({ error: error.message });
         }
     });
+
+    RED.httpAdmin.get("/opcua-client-config/:id/read", RED.auth.needsPermission("flows.read"), async function (req, res) {
+        try {
+            const configNode = RED.nodes.getNode(req.params.id);
+
+            if (!configNode) {
+                res.status(404).json({ error: "OPC UA client configuration not found" });
+                return;
+            }
+
+            const nodeId = req.query.nodeId;
+            if (!nodeId) {
+                throw new Error("Missing nodeId parameter");
+            }
+
+            const session = await configNode.getSession();
+            const dataValue = await session.read({
+                nodeId: nodeId,
+                attributeId: AttributeIds.Value
+            });
+
+            if (dataValue.statusCode && !dataValue.statusCode.isGood()) {
+                throw new Error("Read failed: " + dataValue.statusCode.toString());
+            }
+
+            const cache = new Map();
+            let result = dataValueToItemResult({ nodeID: nodeId }, dataValue);
+            result = await enrichItemResultWithEnumeration(result, session, cache, nodeId);
+
+            res.json({ value: result.value, valueEnumeration: result.valueEnumeration });
+        } catch (error) {
+            res.status(500).json({ error: error.message });
+        }
+    });
 };
 
 async function browseForEditor(configNode, nodeId) {
     const session = await configNode.getSession();
-    return browseNode(session, {
+    const result = await browseNode(session, {
         nodeID: nodeId || ROOT_NODE_ID
     });
+    if (result && result.children) {
+        result.browse = result.children;
+        delete result.children;
+    }
+    return result;
 }
+

package/client/opcua-client-help.html

@@ -5,6 +5,7 @@
     <p><b>Read</b>: reads one or more variable values.</p>
     <p><b>Write</b>: writes one or more variable values.</p>
     <p><b>Browse</b>: browses one or more OPC UA nodes and returns their children.</p>
+    <p><b>Browse Recursive</b>: perform a recursive search across all nodes starting from the specified node.</p>
     <p><b>Method</b>: calls one or more OPC UA methods.</p>
     <p><b>Subscription</b>: subscribes to one or more variable values and emits one message per change.</p>
 
@@ -33,6 +34,11 @@
     <p>If <code>msg.payload</code> is not an array and <code>NodeId</code> is configured, the node browses that configured node.</p>
     <p>If <code>msg.payload = []</code>, the node browses the OPC UA <code>RootFolder</code>.</p>
 
+    <h3>Browse Recursive</h3>
+    <p>Perform a recursive search across all nodes starting from the specified <code>nodeId</code>. It will return the value (if it is a variable), display name, description, and all other item information.</p>
+    <p>If <code>msg.payload</code> is not an array and <code>NodeId</code> is configured, the node browses recursively starting from that configured node.</p>
+    <p>If <code>msg.payload = []</code>, the node browses recursively starting from the OPC UA <code>RootFolder</code>.</p>
+
     <h3>Method</h3>
     <p><code>nodeID</code> and <code>objectId</code> are accepted explicitly. For backward compatibility, <code>nodeID</code> is also accepted as the method id.</p>
     <p><b>Input</b> <code>msg.payload</code>:</p>

package/client/opcua-client-utils.js

@@ -204,6 +204,70 @@ function coerceValue(value, typeName) {
     }
 }
 
+function getArrayDimensions(value, typeName) {
+    if (!Array.isArray(value)) {
+        return null;
+    }
+    // Check if it is a 64-bit scalar represented as [high, low]
+    if ((typeName === "Int64" || typeName === "UInt64") && value.length === 2 && typeof value[0] === "number" && typeof value[1] === "number") {
+        return null;
+    }
+
+    const hasNestedArray = value.some(item => {
+        if (Array.isArray(item)) {
+            if ((typeName === "Int64" || typeName === "UInt64") && item.length === 2 && typeof item[0] === "number" && typeof item[1] === "number") {
+                return false;
+            }
+            return true;
+        }
+        return false;
+    });
+
+    if (!hasNestedArray) {
+        return null;
+    }
+
+    const dimensions = [];
+    let current = value;
+    while (Array.isArray(current)) {
+        if ((typeName === "Int64" || typeName === "UInt64") && current.length === 2 && typeof current[0] === "number" && typeof current[1] === "number") {
+            break;
+        }
+        dimensions.push(current.length);
+        if (current.length === 0) {
+            break;
+        }
+        current = current[0];
+    }
+    return dimensions;
+}
+
+function flattenMatrix(value, typeName) {
+    if (!Array.isArray(value)) {
+        return value;
+    }
+    if ((typeName === "Int64" || typeName === "UInt64") && value.length === 2 && typeof value[0] === "number" && typeof value[1] === "number") {
+        return [value];
+    }
+
+    const flat = [];
+    const recurse = (a) => {
+        for (const item of a) {
+            if (Array.isArray(item)) {
+                if ((typeName === "Int64" || typeName === "UInt64") && item.length === 2 && typeof item[0] === "number" && typeof item[1] === "number") {
+                    flat.push(item);
+                } else {
+                    recurse(item);
+                }
+            } else {
+                flat.push(item);
+            }
+        }
+    };
+    recurse(value);
+    return flat;
+}
+
 function buildVariantFromItem(item, fallbackTypeName) {
     const typeName = normalizeTypeName(item.type || fallbackTypeName || inferTypeName(item.value));
     const dataType = DataType[typeName];
@@ -212,6 +276,23 @@ function buildVariantFromItem(item, fallbackTypeName) {
         throw new Error("Unsupported OPC UA data type: " + typeName);
     }
 
+    const dimensions = getArrayDimensions(item.value, typeName);
+    if (dimensions) {
+        // Multi-dimensional array (Matrix)
+        const flatVal = flattenMatrix(item.value, typeName);
+        const coercedArray = coerceValue(flatVal, typeName);
+        const TypedArrayCtor = TYPED_ARRAY_MAP[dataType];
+
+        return new Variant({
+            dataType,
+            arrayType: VariantArrayType.Matrix,
+            dimensions,
+            value: TypedArrayCtor
+                ? TypedArrayCtor.from(coercedArray)
+                : coercedArray
+        });
+    }
+
     const isArray = Array.isArray(item.value);
 
     if (isArray) {
@@ -311,12 +392,48 @@ function resolve64BitValue(value, isUnsigned) {
     return value;
 }
 
+function reshapeArray(flatArray, dimensions) {
+    if (!dimensions || dimensions.length <= 1) {
+        return flatArray;
+    }
+
+    const reshape = (arr, dims, offset) => {
+        const size = dims[0];
+        if (dims.length === 1) {
+            return {
+                result: arr.slice(offset, offset + size),
+                nextOffset: offset + size
+            };
+        }
+
+        const result = [];
+        let currentOffset = offset;
+        for (let i = 0; i < size; i++) {
+            const step = reshape(arr, dims.slice(1), currentOffset);
+            result.push(step.result);
+            currentOffset = step.nextOffset;
+        }
+        return {
+            result: result,
+            nextOffset: currentOffset
+        };
+    };
+
+    return reshape(flatArray, dimensions, 0).result;
+}
+
 function dataValueToItemResult(item, dataValue) {
     const variant = dataValue && dataValue.value ? dataValue.value : null;
     let val = variant ? variant.value : null;
     if (variant && (variant.dataType === DataType.Int64 || variant.dataType === DataType.UInt64)) {
         val = resolve64BitValue(val, variant.dataType === DataType.UInt64);
     }
+    if (variant && variant.arrayType === VariantArrayType.Matrix && variant.dimensions && (Array.isArray(val) || ArrayBuffer.isView(val))) {
+        if (ArrayBuffer.isView(val)) {
+            val = Array.from(val);
+        }
+        val = reshapeArray(val, variant.dimensions);
+    }
     return {
         name: resolveName(item, resolveNodeId(item)),
         nodeID: resolveNodeId(item),
@@ -374,6 +491,12 @@ function callResultToItemResult(item, callResult, argumentDefinition) {
             if (variant && (variant.dataType === DataType.Int64 || variant.dataType === DataType.UInt64)) {
                 val = resolve64BitValue(val, variant.dataType === DataType.UInt64);
             }
+            if (variant && variant.arrayType === VariantArrayType.Matrix && variant.dimensions && (Array.isArray(val) || ArrayBuffer.isView(val))) {
+                if (ArrayBuffer.isView(val)) {
+                    val = Array.from(val);
+                }
+                val = reshapeArray(val, variant.dimensions);
+            }
             return {
                 name: outputDefinitions[index] && outputDefinitions[index].name
                     ? String(outputDefinitions[index].name)
@@ -469,7 +592,15 @@ async function getMethodArgumentDefinition(session, methodNodeId, cache) {
 }
 
 async function enrichItemResultWithEnumeration(result, session, cache, nodeId) {
-    if (result.type !== "Int32" && result.type !== "Enumeration") {
+    const type = result.type || result.dataType;
+    if (!type) {
+        return result;
+    }
+
+    const isStandardEnum = type === "Int32" || type === "Enumeration";
+    const isCustomNodeId = typeof type === "string" && (type.includes("i=") || type.includes("ns="));
+
+    if (!isStandardEnum && !isCustomNodeId) {
         return result;
     }
     
@@ -481,15 +612,29 @@ async function enrichItemResultWithEnumeration(result, session, cache, nodeId) {
         const cacheKeyType = "dt:" + nodeId;
         let dtNodeId = cache ? cache.get(cacheKeyType) : undefined;
         if (dtNodeId === undefined) {
-            const dv = await session.read({
-                nodeId: nodeId,
-                attributeId: AttributeIds.DataType
-            });
-            if (dv.statusCode.isGood()) {
-                dtNodeId = dv.value.value;
-                if (cache) cache.set(cacheKeyType, dtNodeId);
-            } else {
-                if (cache) cache.set(cacheKeyType, null);
+            const isNodeIdLike = result.dataType && (
+                typeof result.dataType !== "string" || 
+                result.dataType.includes("i=") || 
+                result.dataType.includes("ns=")
+            );
+            if (isNodeIdLike) {
+                try {
+                    dtNodeId = coerceNodeId(result.dataType);
+                } catch (e) {
+                    dtNodeId = undefined;
+                }
+            }
+            if (dtNodeId === undefined) {
+                const dv = await session.read({
+                    nodeId: nodeId,
+                    attributeId: AttributeIds.DataType
+                });
+                if (dv.statusCode.isGood()) {
+                    dtNodeId = dv.value.value;
+                    if (cache) cache.set(cacheKeyType, dtNodeId);
+                } else {
+                    if (cache) cache.set(cacheKeyType, null);
+                }
             }
         }
         
@@ -549,6 +694,8 @@ async function enrichItemResultWithEnumeration(result, session, cache, nodeId) {
         
         if (enumStrings && enumStrings[result.value] !== undefined) {
             result.valueEnumeration = enumStrings[result.value];
+            if (result.type) result.type = "Enumeration";
+            if (result.dataType) result.dataType = "Enumeration";
         }
     } catch (e) {
         console.error("Error in enrichItemResultWithEnumeration:", e);
@@ -577,5 +724,6 @@ module.exports = {
     resolveNodeId,
     resolveSecurityMode,
     resolveSecurityPolicy,
+    reshapeArray,
     statusCodeToString
 };

package/client/opcua-client.html

@@ -17,6 +17,7 @@
             <option value="read">Read</option>
             <option value="write">Write</option>
             <option value="browse">Browse</option>
+            <option value="browseRecursive">Browse Recursive</option>
             <option value="method">Method</option>
               <option value="getSubscriptionId">getSubscriptionId</option>
             <option value="subscription">Subscription</option>
@@ -49,6 +50,7 @@
         <div id="node-input-browse-context-menu" class="opcua-tree-context-menu" style="display:none;">
             <a href="#" id="node-input-browse-context-refresh"><i class="fa fa-refresh"></i> Refresh node</a>
             <a href="#" id="node-input-browse-context-copy-nodeid"><i class="fa fa-copy"></i> Copy NodeID</a>
+            <a href="#" id="node-input-browse-context-read-value"><i class="fa fa-eye"></i> Read value</a>
         </div>
     </div>
 
@@ -85,6 +87,7 @@
     <p><b>Read</b>: reads one or more variable values.</p>
     <p><b>Write</b>: writes one or more variable values.</p>
     <p><b>Browse</b>: browses one or more OPC UA nodes and returns their children.</p>
+    <p><b>Browse Recursive</b>: perform a recursive search across all nodes starting from the specified node.</p>
     <p><b>Method</b>: calls one or more OPC UA methods.</p>
     <p><b>Subscription</b>: subscribes to one or more variable values and emits one message per change.</p>
 
@@ -113,6 +116,11 @@
     <p>If <code>msg.payload</code> is not an array and <code>NodeId</code> is configured, the node browses that configured node.</p>
     <p>If <code>msg.payload = []</code>, the node browses the OPC UA <code>RootFolder</code>.</p>
 
+    <h3>Browse Recursive</h3>
+    <p>Perform a recursive search across all nodes starting from the specified <code>nodeId</code>. It will return the value (if it is a variable), display name, description, and all other item information.</p>
+    <p>If <code>msg.payload</code> is not an array and <code>NodeId</code> is configured, the node browses recursively starting from that configured node.</p>
+    <p>If <code>msg.payload = []</code>, the node browses recursively starting from the OPC UA <code>RootFolder</code>.</p>
+
     <h3>Method</h3>
     <p><code>nodeID</code> and <code>objectId</code> are accepted explicitly. For backward compatibility, <code>nodeID</code> is also accepted as the method id.</p>
     <p><b>Input</b> <code>msg.payload</code>:</p>