@vitormnm/node-red-simple-opcua 1.3.2 → 1.4.1

package/README.md

@@ -1,6 +1,5 @@
-# @vitormnm/node-red-simple-opcua
 OPC UA client and server with a simple graphical interface for Node-RED.
-fully parameterized via JSON.
+Fully parameterized in JSON.
 
 It supports the following OPC UA items on only 3 nodes.
 
@@ -9,6 +8,8 @@ It supports the following OPC UA items on only 3 nodes.
  - events read and write tags in server(See which tags are being written to or read from the client directly on the server in a simple workflow)
  - methods(write methods in node-red flow)
  - variables
+ - variables arrays
+ - description and displayname nodes
  - objects
  - simple objectsType
  - custom namespace
@@ -21,8 +22,9 @@ It supports the following OPC UA items on only 3 nodes.
 **Client editor**
 ![node-red-si](/resources/editorClient.PNG) 
 
-example json server config
 
+
+example json server config
 ```
 {
     "objects": [],
@@ -124,5 +126,6 @@ example json server config
     ]
 }
 ```
-
+Disclaimer
+This node was only used in simulation and testing environments.
 

package/client/icons/opcua.svg

@@ -0,0 +1,132 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 20010904//EN"
+ "http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd">
+<svg version="1.0" xmlns="http://www.w3.org/2000/svg"
+ width="354.000000pt" height="229.000000pt" viewBox="0 0 354.000000 229.000000"
+ preserveAspectRatio="xMidYMid meet">
+
+<g transform="translate(0.000000,229.000000) scale(0.100000,-0.100000)"
+fill="#000000" stroke="none">
+<path d="M262 2257 l-22 -23 23 -22 23 -22 22 23 22 23 -23 22 -23 22 -22 -23z"/>
+<path d="M195 2170 c-14 -16 -31 -20 -82 -20 -35 0 -63 -4 -63 -10 0 -6 26
+-10 59 -10 44 0 65 -5 85 -21 l27 -21 23 21 c18 17 34 21 87 20 35 0 58 -3 52
+-6 -17 -6 -16 -23 0 -23 8 0 22 -9 32 -20 l18 -20 24 22 c13 12 23 27 23 35 0
+10 37 13 180 13 155 0 179 -2 174 -15 -4 -10 0 -15 11 -15 11 0 15 5 11 15 -4
+11 2 15 21 15 l27 0 -37 -38 c-40 -41 -45 -52 -22 -52 8 0 15 5 15 12 0 7 16
+-3 35 -22 l35 -34 35 34 c41 40 42 46 13 77 l-21 23 253 0 254 0 -71 -34 c-40
+-19 -92 -53 -116 -75 -30 -28 -53 -41 -72 -41 -27 0 -28 1 -10 19 16 19 16 21
+-3 49 -39 54 -45 55 -87 12 -38 -39 -38 -40 -20 -60 16 -18 16 -20 2 -20 -10
+0 -17 7 -17 16 0 9 -6 14 -13 11 -6 -2 -11 -10 -10 -16 4 -14 -30 -14 -44 0
+-8 8 -13 8 -17 0 -4 -6 -32 -11 -63 -11 -44 0 -62 5 -80 22 l-23 21 -22 -20
+c-21 -19 -37 -21 -182 -22 -122 -2 -161 1 -167 11 -7 10 -9 10 -9 1 0 -19 -40
+-16 -62 4 -17 15 -19 15 -36 0 -15 -14 -42 -17 -155 -17 -85 0 -137 -4 -137
+-10 0 -6 49 -10 127 -10 124 0 128 -1 155 -27 l28 -27 28 27 28 27 169 0 c92
+0 165 -3 161 -7 -3 -4 10 -24 30 -44 l37 -38 38 32 c21 18 39 38 39 45 0 7 13
+12 32 12 l33 0 -33 -32 -32 -32 42 -43 42 -43 -40 0 c-22 0 -45 5 -52 12 -9 9
+-15 9 -24 0 -7 -7 -30 -12 -52 -12 -34 0 -47 7 -83 42 l-43 42 -43 -42 c-41
+-41 -70 -54 -65 -31 2 6 -3 14 -9 16 -7 3 -13 -2 -13 -11 0 -13 -13 -16 -72
+-16 -64 0 -75 3 -100 27 l-28 27 -28 -27 c-27 -26 -32 -27 -153 -29 l-124 -2
+103 -3 c81 -3 102 -7 102 -18 0 -8 7 -15 15 -15 8 0 15 7 15 15 0 21 24 19 45
+-5 17 -19 18 -19 43 0 18 14 40 20 78 20 58 0 65 -7 34 -35 -27 -25 -25 -36
+13 -73 l33 -32 37 38 38 38 -26 28 c-28 31 -30 36 -12 36 7 0 35 -22 62 -50
+27 -27 54 -50 60 -50 6 0 33 23 60 50 27 28 55 50 62 50 20 0 16 -11 -14 -42
+l-27 -28 37 -38 c20 -21 37 -41 37 -45 0 -4 -30 -7 -67 -7 -55 0 -71 4 -90 22
+l-23 21 -23 -21 c-23 -21 -31 -22 -308 -24 l-284 -3 280 -2 279 -3 28 -27 28
+-27 28 27 c22 21 38 27 72 27 l44 0 -49 -50 c-34 -34 -51 -46 -57 -37 -5 9
+-10 9 -19 0 -10 -10 -7 -14 12 -22 14 -5 31 -16 39 -26 12 -15 10 -16 -21 -14
+-101 7 -659 -2 -659 -11 0 -6 127 -10 362 -10 322 0 363 -2 380 -17 17 -15 19
+-15 36 0 14 13 41 16 138 16 l121 0 28 -29 c35 -37 42 -37 76 -4 l28 27 51
+-46 c28 -25 74 -57 103 -71 l52 -25 -687 -1 c-452 0 -688 -3 -688 -10 0 -7
+248 -10 725 -10 399 0 725 3 725 7 0 3 -8 15 -17 25 -16 18 -14 21 37 73 30
+30 59 55 65 55 6 0 35 -25 65 -55 51 -52 53 -55 37 -73 -9 -10 -17 -22 -17
+-25 0 -4 156 -6 348 -5 l347 3 3 128 3 127 97 0 c117 0 188 19 237 61 25 22
+36 27 39 17 3 -7 12 -36 21 -65 35 -112 143 -216 267 -260 63 -21 224 -22 303
+-1 l50 13 3 153 3 152 -57 -31 c-101 -58 -210 -38 -259 46 -46 78 -27 163 48
+219 22 16 43 21 95 21 59 0 74 -4 118 -32 28 -18 53 -33 55 -33 2 0 3 70 1
+155 l-3 154 -42 13 c-24 7 -95 13 -162 13 -114 0 -123 -2 -186 -31 -72 -34
+-136 -87 -180 -147 l-27 -38 -11 34 c-29 87 -133 160 -252 177 -36 5 -558 10
+-1169 10 -1087 1 -1105 1 -1125 20 -22 20 -22 20 -40 0z m1875 -115 l0 -75
+-41 0 c-35 0 -49 7 -86 41 -24 22 -76 56 -116 75 l-71 34 157 0 157 0 0 -75z
+m-881 -150 c-15 -30 -29 -60 -32 -67 -3 -10 -11 -7 -29 9 l-24 23 -29 -30
+c-32 -34 -49 -37 -72 -14 -20 20 -2 44 20 26 11 -9 20 -5 42 18 l29 30 -29 30
+-28 29 90 0 89 -1 -27 -53z m881 -17 l0 -73 -24 58 c-13 32 -29 64 -36 72 -11
+13 -7 15 24 15 l36 0 0 -72z m-1044 21 c10 -17 -13 -36 -27 -22 -12 12 -4 33
+11 33 5 0 12 -5 16 -11z m1462 -19 c44 -42 17 -104 -53 -120 -66 -16 -65 -17
+-65 65 l0 75 48 0 c35 0 54 -6 70 -20z m-628 -45 l54 -55 -59 -60 c-41 -41
+-62 -56 -70 -50 -8 7 -15 2 -23 -15 -12 -25 -12 -25 -156 -25 l-145 0 -7 37
+c-4 20 -3 52 2 72 l9 36 105 3 c140 4 158 22 21 22 -95 0 -102 1 -90 17 36 43
+122 55 181 24 l37 -18 32 33 c18 19 38 34 44 34 6 0 35 -25 65 -55z m-400 29
+c0 -9 -5 -14 -12 -12 -18 6 -21 28 -4 28 9 0 16 -7 16 -16z m-775 -43 c7 -12
+-12 -24 -25 -16 -11 7 -4 25 10 25 5 0 11 -4 15 -9z m773 -12 c-2 -6 -8 -10
+-13 -10 -5 0 -11 4 -13 10 -2 6 4 11 13 11 9 0 15 -5 13 -11z m-419 -35 l23
+-16 -43 -44 c-34 -34 -40 -47 -31 -56 20 -20 14 -24 -43 -26 -30 -1 -55 2 -55
+5 0 4 18 26 40 48 l40 41 -25 24 c-14 13 -25 27 -25 32 0 15 95 9 119 -8z
+m286 -34 l50 -50 -53 -53 -52 -52 -52 52 -53 53 50 50 c27 27 52 50 55 50 3 0
+28 -23 55 -50z m-460 10 c-5 -8 -11 -8 -17 -2 -6 6 -7 16 -3 22 5 8 11 8 17 2
+6 -6 7 -16 3 -22z m-184 5 c-1 -15 -24 -12 -29 3 -3 9 2 13 12 10 10 -1 17 -7
+17 -13z m439 -4 c0 -14 -18 -23 -30 -16 -6 4 -8 11 -5 16 8 12 35 12 35 0z
+m-252 -49 c2 -7 -3 -12 -12 -12 -9 0 -16 7 -16 16 0 17 22 14 28 -4z m247 -12
+c0 -7 -6 -15 -12 -17 -8 -3 -13 4 -13 17 0 13 5 20 13 18 6 -3 12 -11 12 -18z
+m305 -1 c0 -5 -7 -9 -15 -9 -15 0 -20 12 -9 23 8 8 24 -1 24 -14z m-8 -54 c0
+-5 -5 -11 -11 -13 -6 -2 -11 4 -11 13 0 9 5 15 11 13 6 -2 11 -8 11 -13z
+m-482 -22 c0 -12 -43 -53 -55 -53 -6 0 -24 14 -40 30 l-29 30 62 0 c34 0 62
+-3 62 -7z m122 -20 l28 -27 28 27 c33 32 42 34 42 9 0 -10 -20 -38 -45 -62
+-25 -24 -45 -50 -45 -57 0 -8 -13 -13 -32 -13 l-32 0 34 35 34 35 -39 40 c-31
+32 -35 40 -20 40 10 0 32 -12 47 -27z m692 16 c-3 -6 14 -32 40 -58 l46 -47
+-50 -49 -50 -50 -52 52 c-44 44 -50 54 -39 67 12 14 8 16 -35 16 -53 0 -105
+25 -124 59 -11 21 -9 21 130 21 100 0 139 -3 134 -11z m-414 -20 c0 -5 -7 -9
+-15 -9 -15 0 -20 12 -9 23 8 8 24 -1 24 -14z m-362 0 c-2 -6 -8 -10 -13 -10
+-5 0 -11 4 -13 10 -2 6 4 11 13 11 9 0 15 -5 13 -11z m1102 -59 c0 -58 -1 -60
+-26 -60 -14 0 -24 3 -22 8 2 4 12 31 23 60 11 28 21 52 22 52 2 0 3 -27 3 -60z
+m-580 -25 l54 -55 -59 -60 -59 -60 -58 57 -58 57 57 58 c32 32 60 58 63 58 3
+0 30 -25 60 -55z m-525 15 c-5 -8 -11 -8 -17 -2 -6 6 -7 16 -3 22 5 8 11 8 17
+2 6 -6 7 -16 3 -22z m365 15 c0 -8 -7 -15 -15 -15 -16 0 -20 12 -8 23 11 12
+23 8 23 -8z m-410 -50 c11 -13 8 -15 -20 -15 -28 0 -31 2 -20 15 7 8 16 15 20
+15 4 0 13 -7 20 -15z m1150 -110 l0 -75 -137 0 -137 0 53 26 c29 15 76 48 104
+75 40 37 60 48 85 49 l32 0 0 -75z"/>
+<path d="M1750 1825 c0 -9 5 -15 11 -13 6 2 11 8 11 13 0 5 -5 11 -11 13 -6 2
+-11 -4 -11 -13z"/>
+<path d="M1750 1765 c0 -9 5 -15 11 -13 6 2 11 8 11 13 0 5 -5 11 -11 13 -6 2
+-11 -4 -11 -13z"/>
+<path d="M1240 1735 c0 -9 5 -15 11 -13 6 2 11 8 11 13 0 5 -5 11 -11 13 -6 2
+-11 -4 -11 -13z"/>
+<path d="M1240 1675 c0 -9 5 -15 11 -13 6 2 11 8 11 13 0 5 -5 11 -11 13 -6 2
+-11 -4 -11 -13z"/>
+<path d="M1697 1574 c-8 -8 1 -24 14 -24 5 0 9 7 9 15 0 15 -12 20 -23 9z"/>
+<path d="M1692 1508 c6 -18 28 -21 28 -4 0 9 -7 16 -16 16 -9 0 -14 -5 -12
+-12z"/>
+<path d="M1380 1480 c0 -5 7 -10 16 -10 8 0 12 5 9 10 -3 6 -10 10 -16 10 -5
+0 -9 -4 -9 -10z"/>
+<path d="M1380 1425 c0 -9 5 -15 11 -13 6 2 11 8 11 13 0 5 -5 11 -11 13 -6 2
+-11 -4 -11 -13z"/>
+<path d="M610 2075 l-24 -26 27 -27 27 -27 27 27 27 27 -24 26 c-13 14 -26 25
+-30 25 -4 0 -17 -11 -30 -25z"/>
+<path d="M547 2074 c-8 -8 1 -24 14 -24 5 0 9 7 9 15 0 15 -12 20 -23 9z"/>
+<path d="M1047 2064 c-8 -8 1 -24 14 -24 5 0 9 7 9 15 0 15 -12 20 -23 9z"/>
+<path d="M547 2014 c-8 -8 1 -24 14 -24 5 0 9 7 9 15 0 15 -12 20 -23 9z"/>
+<path d="M443 1939 c3 -9 1 -21 -4 -26 -6 -6 2 -20 19 -36 l28 -27 23 24 c22
+23 22 25 6 50 -18 27 -39 34 -51 15 -4 -8 -9 -7 -16 2 -8 11 -9 10 -5 -2z"/>
+<path d="M712 1918 c6 -18 28 -21 28 -4 0 9 -7 16 -16 16 -9 0 -14 -5 -12 -12z"/>
+<path d="M857 1884 c-8 -8 1 -24 14 -24 5 0 9 7 9 15 0 15 -12 20 -23 9z"/>
+<path d="M250 1840 c0 -5 7 -10 15 -10 8 0 15 5 15 10 0 6 -7 10 -15 10 -8 0
+-15 -4 -15 -10z"/>
+<path d="M422 1749 c2 -6 8 -10 13 -10 5 0 11 4 13 10 2 6 -4 11 -13 11 -9 0
+-15 -5 -13 -11z"/>
+<path d="M422 1689 c2 -6 8 -10 13 -10 5 0 11 4 13 10 2 6 -4 11 -13 11 -9 0
+-15 -5 -13 -11z"/>
+<path d="M1114 995 c-11 -28 3 -579 15 -620 45 -143 162 -222 346 -232 196
+-11 334 56 397 192 22 48 23 61 26 363 l3 313 -153 -3 -153 -3 -5 -283 c-6
+-321 -3 -312 -87 -312 -75 0 -77 9 -81 327 l-3 273 -150 0 c-122 0 -151 -3
+-155 -15z"/>
+<path d="M2151 992 c-11 -20 -291 -825 -291 -835 0 -4 72 -7 160 -7 120 0 162
+3 165 13 2 6 9 31 15 55 l11 43 116 -3 116 -3 16 -50 16 -50 164 -3 c130 -2
+162 0 158 10 -2 7 -66 186 -142 398 -75 212 -143 400 -151 418 l-13 32 -165 0
+c-150 0 -166 -2 -175 -18z m208 -392 c12 -58 25 -113 27 -122 5 -16 -2 -18
+-55 -18 -45 0 -61 4 -61 13 0 8 11 65 25 127 14 62 25 115 25 119 0 3 4 1 8
+-4 5 -6 19 -57 31 -115z"/>
+<path d="M2590 1001 c11 -8 11 -11 2 -11 -7 0 -17 -10 -23 -22 -9 -22 -9 -21
+-6 4 2 15 0 25 -4 22 -26 -15 6 -72 33 -61 8 3 5 6 -6 6 -15 1 -17 4 -8 13 8
+8 15 8 28 -3 16 -12 17 -12 9 1 -6 8 -10 24 -10 34 0 11 -7 21 -15 23 -13 4
+-13 3 0 -6z"/>
+</g>
+</svg>

package/client/lib/opcua-client-browser.js

@@ -24,17 +24,56 @@ async function browseNode(session, root) {
         resultMask: 63
     });
 
-    const references = browseResult && Array.isArray(browseResult.references)
-        ? browseResult.references
-        : [];
+    const references = browseResult?.references ?? [];
+    if (!references.length) return result;
+
+    // Monta lista de todos os atributos de todos os nós de uma vez
+    const nodeIds = references.map(ref => normalizeNodeId(ref.nodeId));
+    const attributesToRead = nodeIds.flatMap(nodeId => [
+        { nodeId, attributeId: AttributeIds.Description },
+        { nodeId, attributeId: AttributeIds.DataType },
+        { nodeId, attributeId: AttributeIds.Value },
+    ]);
+
+    // UMA única chamada para todos os nós e atributos
+    const dataValues = await session.read(attributesToRead);
+
+    // Distribui os resultados por nó (3 atributos por nó)
+    result.browse = await Promise.all(references.map(async (reference, i) => {
+        const childNodeId = nodeIds[i];
+        const nodeClass = resolveNodeClassName(reference.nodeClass);
+        const browseName = extractBrowseName(reference.browseName, childNodeId);
+        const displayName = extractDisplayName(reference.displayName, browseName);
+
+        const descValue = dataValues[i * 3]?.value?.value;
+        const description = typeof descValue === "string"
+            ? descValue
+            : (descValue?.text ?? "");
+
+        const item = { nodeID: childNodeId, nodeClass, browseName, displayName, description };
+
+        if (nodeClass === "Variable") {
+            const dataTypeValue = dataValues[i * 3 + 1]?.value?.value;
+            const rawValue = dataValues[i * 3 + 2]?.value?.value;
+
+            item.dataType = dataTypeValue?.namespace === 0 && typeof dataTypeValue?.value === "number"
+                ? (DataType[dataTypeValue.value] || dataTypeValue.toString())
+                : (dataTypeValue?.toString() ?? "");
+
+            item.value = rawValue ?? "";
+        }
 
-    for (const reference of references) {
-        result.browse.push(await mapReference(session, reference));
-    }
+        if (nodeClass === "Method") {
+            const definition = await readMethodArguments(session, childNodeId);
+            item.inputArguments = definition.inputArguments;
+            item.outputArguments = definition.outputArguments;
+        }
+
+        return item;
+    }));
 
     return result;
 }
-
 function normalizeBrowseRoots(payload) {
     if (payload === undefined || payload === null) {
         return [{ name: "RootFolder", nodeID: ROOT_NODE_ID }];

package/client/lib/opcua-client-method-service.js

@@ -0,0 +1,88 @@
+"use strict";
+
+const { dataValueToItemResult, ensureArrayPayload, resolveNodeId, resolveMethodObjectId, buildVariantFromItem, callResultToItemResult } = require("../opcua-client-utils");
+
+class OpcUaClientMethodService {
+    async execute(node, msg, session, itemsResolver) {
+
+        // const items = ensureArrayPayload(msg, "OPC UA method call");
+        const items = itemsResolver.ensureMethodItems(node, msg, "OPC UA method");
+        const payload = [];
+
+
+
+        for (const item of items) {
+            const methodNodeId = this.resolveMethodId(item);
+
+            try {
+                const objectId = this.resolveMethodObjectIdFromItem(item) || await resolveMethodObjectId(
+                    session,
+                    methodNodeId,
+                    node.connection.methodObjectIdCache
+                );
+                const argumentDefinition = await this.safeGetMethodArgumentDefinition(
+                    session,
+                    methodNodeId,
+                    node.connection.methodDefinitionCache
+                );
+                const callRequest = {
+                    objectId,
+                    methodId: methodNodeId
+                };
+
+                if (Array.isArray(item.inputs) && item.inputs.length > 0) {
+                    callRequest.inputArguments = item.inputs.map((input) => buildVariantFromItem(input, input.type));
+                }
+
+                const callResult = await session.call(callRequest);
+                payload.push(callResultToItemResult(item, callResult, argumentDefinition));
+            } catch (itemError) {
+                payload.push({
+                    name: item.name || methodNodeId,
+                    nodeID: methodNodeId,
+                    status: itemError.message,
+                    outputs: []
+                });
+            }
+        }
+
+        return payload;
+    }
+
+
+
+    resolveMethodId(item) {
+        const methodId = item && (item.methodID || item.methodId || item.nodeID || item.nodeId);
+        if (!methodId || !String(methodId).trim()) {
+            throw new Error("Each method item must contain methodId or nodeID");
+        }
+
+        return String(methodId).trim();
+    }
+
+
+    resolveMethodObjectIdFromItem(item) {
+        const objectId = item && (item.objectID || item.objectId);
+        if (!objectId || !String(objectId).trim()) {
+            return "";
+        }
+
+        return String(objectId).trim();
+    }
+
+    async safeGetMethodArgumentDefinition(session, methodNodeId, cache) {
+        try {
+            return await getMethodArgumentDefinition(session, methodNodeId, cache);
+        } catch (error) {
+            return {
+                inputArguments: [],
+                outputArguments: []
+            };
+        }
+    }
+
+}
+
+module.exports = {
+    OpcUaClientMethodService
+};

package/client/lib/opcua-client-write-service.js

@@ -1,53 +1,147 @@
 "use strict";
 
-const { DataType, coerceNodeId } = require("node-opcua");
+const { AttributeIds, DataType, coerceNodeId } = require("node-opcua");
 const {
     buildVariantFromItem,
-    dataValueToItemResult,
     normalizeTypeName,
     resolveNodeId,
     statusCodeToString
 } = require("../opcua-client-utils");
 
+// Máximo de tags por chamada session.write (ajuste conforme limite do servidor)
+const WRITE_BATCH_SIZE = 100;
+
+// Batches em paralelo simultâneos
+const CONCURRENCY = 5;
+
+// Cede o event loop a cada N itens para não travar o Node-RED
+const YIELD_EVERY = 50;
+
 class OpcUaClientWriteService {
     async execute(node, msg, session, itemsResolver) {
         const items = itemsResolver.ensureWriteItems(node, msg);
-        const results = [];
-
-        for (const item of items) {
-            const nodeId = resolveNodeId(item);
-
-            try {
-                const explicitType = normalizeTypeName(item.type);
-                const builtInType = await session.getBuiltInDataType(coerceNodeId(nodeId));
-                const typeName = explicitType || DataType[builtInType];
-                const variant = buildVariantFromItem(item, typeName);
-                const statusCode = await session.writeSingleNode(nodeId, variant);
-                const dataValue = await session.readVariableValue(nodeId);
-                const result = dataValueToItemResult(item, dataValue);
-
-                if (statusCode && statusCode.name && statusCode.name !== "Good") {
-                    result.status = statusCodeToString(statusCode);
-                }
-
-                results.push(result);
-            } catch (itemError) {
-                results.push({
-                    name: item.name || nodeId,
-                    nodeID: nodeId,
-                    value: item.value,
-                    type: normalizeTypeName(item.type) || null,
-                    status: itemError.message,
-                    sourceTimestamp: null,
-                    serverTimestamp: null
-                });
+    
+        // 1. Resolve variantes (tipo + valor) — consulta servidor só para quem não tem tipo explícito
+        const variants = await resolveVariants(session, items);
+
+        // 2. Escreve todos os nós em batches paralelos
+        const statusCodes = await writeBatches(session, items, variants);
+
+        // 3. Monta resultados — statusCode Good já confirma a escrita, sem round-trip extra
+        return buildResults(items, variants, statusCodes);
+    }
+}
+
+// ─── Resolução de tipos ──────────────────────────────────────────────────────
+
+async function resolveVariants(session, items) {
+    // Separa quais itens precisam consultar o tipo no servidor
+    const needsLookup = items
+        .map((item, index) => ({ item, index }))
+        .filter(({ item }) => !normalizeTypeName(item.type));
+
+    // Busca tipos desconhecidos em paralelo
+    const resolvedTypes = new Map();
+
+    await mapConcurrent(needsLookup, CONCURRENCY * 2, async ({ item, index }) => {
+        try {
+            const builtInType = await session.getBuiltInDataType(coerceNodeId(resolveNodeId(item)));
+            resolvedTypes.set(index, DataType[builtInType]);
+        } catch {
+            resolvedTypes.set(index, "String");
+        }
+    });
+
+    return items.map((item, index) => {
+        const typeName = normalizeTypeName(item.type) || resolvedTypes.get(index) || "String";
+        return buildVariantFromItem(item, typeName);
+    });
+}
+
+// ─── Escrita em batches paralelos ────────────────────────────────────────────
+
+async function writeBatches(session, items, variants) {
+    const allStatusCodes = new Array(items.length);
+
+    // Divide em batches de WRITE_BATCH_SIZE
+    const batches = [];
+    for (let i = 0; i < items.length; i += WRITE_BATCH_SIZE) {
+        batches.push({ start: i, end: Math.min(i + WRITE_BATCH_SIZE, items.length) });
+    }
+
+    let processed = 0;
+
+    await mapConcurrent(batches, CONCURRENCY, async ({ start, end }) => {
+        const nodesToWrite = items.slice(start, end).map((item, i) => ({
+            nodeId: coerceNodeId(resolveNodeId(item)),
+            attributeId: AttributeIds.Value,
+            value: { value: variants[start + i] }
+        }));
+
+        try {
+            const statusCodes = await session.write(nodesToWrite);
+            statusCodes.forEach((sc, i) => {
+                allStatusCodes[start + i] = sc;
+            });
+        } catch (batchError) {
+            // Se o batch falhar por completo, marca todos com erro
+            for (let i = start; i < end; i++) {
+                allStatusCodes[i] = { name: batchError.message, value: -1 };
             }
         }
 
-        return results;
+        // Cede o event loop a cada YIELD_EVERY itens para não travar o Node-RED
+        processed += end - start;
+        if (processed % YIELD_EVERY === 0) {
+            await yieldEventLoop();
+        }
+    });
+
+    return allStatusCodes;
+}
+
+// ─── Montagem dos resultados ─────────────────────────────────────────────────
+
+function buildResults(items, variants, statusCodes) {
+    return items.map((item, index) => {
+        const nodeId = resolveNodeId(item);
+        const sc = statusCodes[index];
+        const scName = sc && sc.name ? sc.name : "Good";
+        const typeName = DataType[variants[index].dataType] || null;
+
+        return {
+            name: item.name || nodeId,
+            nodeID: nodeId,
+            value: variants[index].value,
+            type: typeName,
+            status: scName,
+            sourceTimestamp: null,
+            serverTimestamp: null
+        };
+    });
+}
+
+// ─── Utilitários ─────────────────────────────────────────────────────────────
+
+async function mapConcurrent(items, concurrency, fn) {
+    let index = 0;
+
+    async function worker() {
+        while (index < items.length) {
+            const i = index++;
+            await fn(items[i], i);
+        }
     }
+
+    await Promise.all(
+        Array.from({ length: Math.min(concurrency, items.length) }, worker)
+    );
+}
+
+function yieldEventLoop() {
+    return new Promise(resolve => setImmediate(resolve));
 }
 
 module.exports = {
     OpcUaClientWriteService
-};
+};

package/client/opcua-client-config.js

@@ -13,11 +13,15 @@ const {
     ROOT_NODE_ID
 } = require("./lib/opcua-client-browser");
 
+
+
 module.exports = function (RED) {
     function OpcUaClientConfigNode(config) {
         RED.nodes.createNode(this, config);
         const node = this;
 
+        
+
         node.name = (config.name || "").trim();
         node.endpoint = (config.endpoint || "").trim();
         node.securityPolicy = config.securityPolicy || "None";
@@ -74,6 +78,7 @@ module.exports = function (RED) {
 
                 this.client = client;
                 this.session = session;
+                 
                 return session;
             } catch (error) {
                 try {

package/client/opcua-client-help.html

@@ -0,0 +1,61 @@
+<script type="text/html" data-help-name="opcua-client">
+    <p>Unified OPC UA client node for read, write, browse and subscription using a shared client configuration node.</p>
+
+    <h3>Modes</h3>
+    <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>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>
+
+    <h3>Read</h3>
+    <p><b>Input</b> <code>msg.payload</code>:</p>
+    <pre><code>[
+  {
+    "name": "status",
+    "nodeID": "ns=2;s=Factory.Line1.Motor1.status"
+  }
+]</code></pre>
+    <p>If <code>msg.payload</code> is not an array and <code>NodeId</code> is configured, the node reads that configured node.</p>
+
+    <h3>Write</h3>
+    <p><b>Input</b> <code>msg.payload</code>:</p>
+    <pre><code>[
+  {
+    "name": "speed",
+    "nodeID": "ns=2;s=Factory.Line1.Motor1.speed",
+    "value": 25.5,
+    "type": "Float"
+  }
+]</code></pre>
+
+    <h3>Browse</h3>
+    <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>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>
+    <pre><code>[
+    {
+        "name": "method1",
+        "nodeID": "ns=2;s=motor.method1",
+        "inputs": [
+            {
+                "name": "input1",
+                "type": "Int32",
+                "value": 1
+            },
+            {
+                "name": "input2",
+                "type": "Int32",
+                "value": 1
+            }
+        ]
+    },
+
+ 
+]</code></pre>
+    <h3>Subscription</h3>
+    <p>In subscription mode the node emits one message per value change.</p>
+</script>