@jsgorana/node-red-opcua 0.1.0

package/nodes/opcua-write.html

@@ -0,0 +1,63 @@
+<script type="text/javascript">
+    RED.nodes.registerType("opcua-write", {
+        category: "OPC-UA",
+        color: "#4a90d9",
+        defaults: {
+            name: { value: "" },
+            endpoint: { value: "", type: "opcua-endpoint", required: true },
+            nodeId: { value: "" },
+            dataType: { value: "Double" }
+        },
+        inputs: 1,
+        outputs: 1,
+        icon: "font-awesome/fa-upload",
+        label: function () {
+            return this.name || (this.nodeId ? "write " + this.nodeId : "opcua-write");
+        }
+    });
+</script>
+
+<script type="text/html" data-template-name="opcua-write">
+    <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-endpoint"><i class="fa fa-server"></i> Endpoint</label>
+        <input type="text" id="node-input-endpoint">
+    </div>
+    <div class="form-row">
+        <label for="node-input-nodeId"><i class="fa fa-hashtag"></i> Node ID</label>
+        <input type="text" id="node-input-nodeId" placeholder="ns=1;s=Temperature">
+    </div>
+    <div class="form-row">
+        <label for="node-input-dataType"><i class="fa fa-cube"></i> Data Type</label>
+        <select id="node-input-dataType">
+            <option value="Boolean">Boolean</option>
+            <option value="SByte">SByte</option>
+            <option value="Byte">Byte</option>
+            <option value="Int16">Int16</option>
+            <option value="UInt16">UInt16</option>
+            <option value="Int32">Int32</option>
+            <option value="UInt32">UInt32</option>
+            <option value="Float">Float</option>
+            <option value="Double">Double</option>
+            <option value="String">String</option>
+            <option value="DateTime">DateTime</option>
+        </select>
+    </div>
+</script>
+
+<script type="text/html" data-help-name="opcua-write">
+    <p>Writes <code>msg.payload</code> to the Value attribute of an OPC-UA node.</p>
+    <h3>Inputs</h3>
+    <dl class="message-properties">
+        <dt>payload</dt><dd>The value to write.</dd>
+        <dt class="optional">nodeId <span class="property-type">string</span></dt><dd>Overrides the configured Node ID.</dd>
+        <dt class="optional">dataType <span class="property-type">string</span></dt><dd>Overrides the configured data type.</dd>
+    </dl>
+    <h3>Outputs</h3>
+    <dl class="message-properties">
+        <dt>statusCode <span class="property-type">string</span></dt><dd>OPC-UA write status code.</dd>
+    </dl>
+</script>

package/nodes/opcua-write.js

@@ -0,0 +1,110 @@
+"use strict";
+
+const { AttributeIds, DataType, Variant, StatusCodes } = require("node-opcua");
+
+const STATUS_MAP = {
+    connecting:   { fill: "yellow", shape: "ring", text: "connecting" },
+    connected:    { fill: "green",  shape: "dot",  text: "connected" },
+    reconnecting: { fill: "yellow", shape: "ring", text: "reconnecting" },
+    error:        { fill: "red",    shape: "ring", text: "error" },
+    closed:       { fill: "grey",   shape: "ring", text: "closed" }
+};
+
+function variantFor(dataTypeName, value) {
+    const dataType = DataType[dataTypeName];
+    if (dataType === undefined) {
+        throw new Error("Unknown dataType: " + dataTypeName);
+    }
+    return new Variant({ dataType: dataType, value: value });
+}
+
+function resolveWrites(node, msg) {
+    if (Array.isArray(msg.payload)) {
+        return msg.payload.map((item, index) => {
+            if (item && typeof item === "object" && !Array.isArray(item)) {
+                return {
+                    nodeId: item.nodeId || item.topic,
+                    value: Object.prototype.hasOwnProperty.call(item, "value") ? item.value : item.payload,
+                    dataType: item.dataType || msg.dataType || node.dataType
+                };
+            }
+            return {
+                nodeId: Array.isArray(msg.nodeIds) ? msg.nodeIds[index] : undefined,
+                value: item,
+                dataType: Array.isArray(msg.dataTypes) ? msg.dataTypes[index] : (msg.dataType || node.dataType)
+            };
+        });
+    }
+    return [{
+        nodeId: msg.nodeId || node.nodeId,
+        value: msg.payload,
+        dataType: msg.dataType || node.dataType
+    }];
+}
+
+function toWriteValue(write) {
+    if (!write.nodeId) throw new Error("No nodeId provided");
+    return {
+        nodeId: write.nodeId,
+        attributeId: AttributeIds.Value,
+        value: {
+            value: variantFor(write.dataType, write.value)
+        }
+    };
+}
+
+module.exports = function (RED) {
+    function OpcuaWriteNode(config) {
+        RED.nodes.createNode(this, config);
+        const node = this;
+        node.endpoint = RED.nodes.getNode(config.endpoint);
+        node.nodeId = config.nodeId;
+        node.dataType = config.dataType || "Double";
+
+        if (!node.endpoint) {
+            node.status({ fill: "red", shape: "ring", text: "no endpoint" });
+            return;
+        }
+        const manager = node.endpoint.register();
+        const unsubscribeState = manager.onState((state) => node.status(STATUS_MAP[state] || {}));
+
+        node.on("input", async function (msg, send, done) {
+            try {
+                const writes = resolveWrites(node, msg);
+                if (writes.length === 0) throw new Error("No writes provided");
+                const writeValues = writes.map(toWriteValue);
+
+                const statusCodes = await manager.runWithTimeout(async () => {
+                    const session = await manager.getSession();
+                    return session.write(writeValues.length === 1 ? writeValues[0] : writeValues);
+                }, "write");
+
+                if (writeValues.length === 1) {
+                    msg.statusCode = statusCodes.toString();
+                    msg.nodeId = writes[0].nodeId;
+                    if (statusCodes !== StatusCodes.Good) {
+                        node.status({ fill: "yellow", shape: "ring", text: statusCodes.name });
+                    }
+                } else {
+                    msg.statusCodes = statusCodes.map((s) => s.toString());
+                    msg.nodeIds = writes.map((w) => w.nodeId);
+                    if (statusCodes.some((s) => s !== StatusCodes.Good)) {
+                        node.status({ fill: "yellow", shape: "ring", text: "partial write" });
+                    }
+                }
+                send(msg);
+                done();
+            } catch (err) {
+                node.status({ fill: "red", shape: "ring", text: "write error" });
+                done(err);
+            }
+        });
+
+        node.on("close", async function (done) {
+            unsubscribeState();
+            await node.endpoint.deregister();
+            done();
+        });
+    }
+    RED.nodes.registerType("opcua-write", OpcuaWriteNode);
+};

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@jsgorana/node-red-opcua",
+  "version": "0.1.0",
+  "description": "Lean, modern OPC-UA client and server nodes for Node-RED 5.0 — read, write, browse, subscribe, and expose Node-RED data as an OPC UA server.",
+  "keywords": [
+    "node-red",
+    "opcua",
+    "opc-ua",
+    "iiot",
+    "industrial",
+    "automation",
+    "scada"
+  ],
+  "license": "MIT",
+  "author": "jsgorana <jsgorana@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jsgorana/node-red-opcua.git"
+  },
+  "bugs": {
+    "url": "https://github.com/jsgorana/node-red-opcua/issues"
+  },
+  "homepage": "https://github.com/jsgorana/node-red-opcua#readme",
+  "engines": {
+    "node": ">=22.9.0"
+  },
+  "node-red": {
+    "version": ">=4.0.0",
+    "nodes": {
+      "opcua-endpoint": "nodes/opcua-endpoint.js",
+      "opcua-read": "nodes/opcua-read.js",
+      "opcua-write": "nodes/opcua-write.js",
+      "opcua-browse": "nodes/opcua-browse.js",
+      "opcua-subscribe": "nodes/opcua-subscribe.js",
+      "opcua-server": "nodes/opcua-server.js"
+    }
+  },
+  "scripts": {
+    "test": "mocha \"test/**/*_spec.js\" --timeout 20000",
+    "lint": "eslint nodes test"
+  },
+  "dependencies": {
+    "node-opcua": "^2.173.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "eslint": "^10.6.0",
+    "globals": "^17.7.0",
+    "mocha": "^10.7.0",
+    "node-red": "^5.0.0",
+    "node-red-node-test-helper": "^0.3.4",
+    "should": "^13.2.3"
+  },
+  "files": [
+    "nodes",
+    "examples",
+    "docs/assets",
+    "README.md",
+    "CHANGELOG.md",
+    "CONTRIBUTING.md",
+    "LICENSE"
+  ]
+}