node-red-contrib-adder 1.0.0

package/README.md

@@ -0,0 +1,33 @@
+# node-red-contrib-rpo-adder
+
+A Node-RED node: **Adder**
+
+Collects numeric values from named topics and outputs their sum or weighted average.
+
+## Install
+
+```bash
+npm install node-red-contrib-rpo-adder
+```
+
+Or via the Node-RED Palette Manager.
+
+## Inputs
+
+- **payload** (number): Value for the slot identified by `msg.topic`
+
+## Outputs
+
+- **Output 1**: Sum or weighted average; `msg.values` contains per-topic values
+
+## Configuration
+
+| Parameter | Description |
+|-----------|-------------|
+| Topics / weights | Comma-separated list of `topic:weight` pairs |
+| Mode | Sum or weighted average |
+| Min. required topics | Minimum topics with values before outputting |
+
+## License
+
+MIT

package/adder.html

@@ -0,0 +1,75 @@
+<script type="text/javascript">
+    RED.nodes.registerType('adder', {
+        category: 'rpo',
+        color: '#D4600A',
+        defaults: {
+                "name": {
+                        "value": ""
+                },
+                "mode": {
+                        "value": "sum"
+                },
+                "topics": {
+                        "value": [
+                                {
+                                        "topic": "a",
+                                        "label": "A",
+                                        "weight": 1
+                                },
+                                {
+                                        "topic": "b",
+                                        "label": "B",
+                                        "weight": 1
+                                }
+                        ]
+                },
+                "minTopics": {
+                        "value": 1
+                },
+                "decimals": {
+                        "value": 2
+                }
+        },
+        inputs: 1,
+        outputs: 1,
+        icon: 'font-awesome/fa-plus',
+        label: function() { return this.name || 'adder'; },
+        labelStyle: function() { return this.name ? 'node_label_italic' : ''; }
+    });
+</script>
+
+<script type="text/html" data-template-name="adder">
+    <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-mode"><i class="fa fa-calculator"></i> Mode</label>
+        <select id="node-input-mode" style="width:70%">
+            <option value="sum">Sum (Σ w×v)</option>
+            <option value="average">Weighted Average</option>
+        </select>
+    </div>
+    <div class="form-row">
+        <label><i class="fa fa-list"></i> Topics</label>
+        <ol id="node-input-topics-list"></ol>
+    </div>
+    <div class="form-row">
+        <label for="node-input-minTopics"><i class="fa fa-hourglass"></i> Min Topics</label>
+        <input type="number" id="node-input-minTopics" min="1" style="width:70%">
+    </div>
+    <div class="form-row">
+        <label for="node-input-decimals"><i class="fa fa-sort-numeric-asc"></i> Decimal Places</label>
+        <input type="number" id="node-input-decimals" min="0" max="10" style="width:70%">
+    </div>
+</script>
+
+<script type="text/html" data-help-name="adder">
+    <p>Sums multiple numeric inputs with optional weighting. Can also compute weighted average.</p>
+    <p>Inputs are identified by <code>msg.topic</code>. Configure topics and weights in the editor.</p>
+    <h3>Output</h3>
+    <dl class="message-properties">
+        <dt>payload <span class="property-type">number</span></dt><dd>Sum or weighted average</dd>
+        <dt>adder <span class="property-type">object</span></dt><dd>{ mode, result, count, inputs, weights, decimals }</dd>
+    </dl>
+</script>

package/adder.js

@@ -0,0 +1,85 @@
+module.exports = function(RED) {
+    function AdderNode(config) {
+        RED.nodes.createNode(this, config);
+        var node = this;
+
+        node.mode      = config.mode      || 'sum';
+        node.minTopics = parseInt(config.minTopics, 10) || 1;
+
+        if (Array.isArray(config.topics)) {
+            node.topics = config.topics;
+        } else if (typeof config.topics === 'string') {
+            try {
+                node.topics = JSON.parse(config.topics);
+            } catch(e) {
+                node.topics = config.topics.split(',').map(function(t) {
+                    var parts = t.trim().split(':');
+                    return { topic:parts[0].trim(), label:parts[0].trim(), weight:parseFloat(parts[1])||1 };
+                });
+            }
+        } else {
+            node.topics = [{ topic:'a', label:'A', weight:1 }, { topic:'b', label:'B', weight:1 }];
+        }
+        node.decimals  = parseInt(config.decimals,  10);
+        if (isNaN(node.decimals) || node.decimals < 0) node.decimals = 2;
+
+        // Build lookup map
+        node.topicMap = {};
+        node.topics.forEach(function(t) { node.topicMap[t.topic] = t; });
+
+        node.state = {};
+        updateStatus(node);
+
+        node.on('input', function(msg) {
+            if (msg.reset === true) {
+                node.state = {};
+                updateStatus(node);
+                return;
+            }
+
+            var topic = (msg.topic !== undefined) ? String(msg.topic) : '';
+            if (!(topic in node.topicMap)) {
+                node.warn('Unknown topic: ' + topic);
+                return;
+            }
+            var val = parseFloat(msg.payload);
+            if (isNaN(val)) { node.warn('Input is not a number: ' + msg.payload); return; }
+
+            node.state[topic] = val;
+
+            var knownCount = Object.keys(node.state).length;
+            if (knownCount < node.minTopics) {
+                node.status({ fill:'grey', shape:'ring', text:'Waiting (' + knownCount + '/' + node.minTopics + ' topics)' });
+                return;
+            }
+
+            var weightedSum = 0, totalWeight = 0;
+            var inputs = {}, weights = {};
+            node.topics.forEach(function(t) {
+                if (t.topic in node.state) {
+                    var w = parseFloat(t.weight) || 1;
+                    weightedSum  += node.state[t.topic] * w;
+                    totalWeight  += w;
+                    inputs[t.topic]  = node.state[t.topic];
+                    weights[t.topic] = w;
+                }
+            });
+
+            var result = node.mode === 'average' ? weightedSum / totalWeight : weightedSum;
+            result = parseFloat(result.toFixed(node.decimals));
+
+            msg.payload = result;
+            msg.adder   = { mode:node.mode, result:result, count:knownCount, inputs:inputs, weights:weights, decimals:node.decimals };
+
+            node.status({ fill:'green', shape:'dot', text:node.mode + ': ' + result + ' (' + knownCount + ' inputs)' });
+            node.send(msg);
+        });
+
+        function updateStatus(n) {
+            var k = Object.keys(n.state).length;
+            if (k === 0) { n.status({ fill:'grey', shape:'ring', text:'Waiting for inputs...' }); }
+        }
+    }
+
+    RED.nodes.registerType('adder', AdderNode);
+};

package/locales/de/adder.json

@@ -0,0 +1,19 @@
+{
+  "adder": {
+    "label": "Addierer",
+    "topics": "Topics / Gewichte",
+    "mode": "Modus",
+    "mode_opt": {
+      "sum": "Summe",
+      "avg": "Gewichteter Durchschnitt"
+    },
+    "minTopics": "Min. benötigte Topics",
+    "tip": "Sammelt Werte von benannten Topics und gibt Summe oder gewichteten Durchschnitt aus.",
+    "input": {
+      "payload": "Numerischer Wert (Topic bestimmt den Slot)"
+    },
+    "output": {
+      "payload": "Summe oder gewichteter Durchschnitt aller Topic-Werte"
+    }
+  }
+}

package/locales/en/adder.json

@@ -0,0 +1,19 @@
+{
+  "adder": {
+    "label": "Adder",
+    "topics": "Topics / weights",
+    "mode": "Mode",
+    "mode_opt": {
+      "sum": "Sum",
+      "avg": "Weighted average"
+    },
+    "minTopics": "Min. required topics",
+    "tip": "Collects values from named topics, then outputs sum or weighted average.",
+    "input": {
+      "payload": "Numeric value (topic determines which slot is filled)"
+    },
+    "output": {
+      "payload": "Sum or weighted average of all received topic values"
+    }
+  }
+}

package/locales/es/adder.json

@@ -0,0 +1,19 @@
+{
+  "adder": {
+    "label": "Sumador",
+    "topics": "Topics / pesos",
+    "mode": "Modo",
+    "mode_opt": {
+      "sum": "Suma",
+      "avg": "Promedio ponderado"
+    },
+    "minTopics": "Mín. topics requeridos",
+    "tip": "Recoge valores de topics nombrados, luego genera suma o promedio ponderado.",
+    "input": {
+      "payload": "Valor numérico (el topic determina el slot)"
+    },
+    "output": {
+      "payload": "Suma o promedio ponderado de todos los valores de topic"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "node-red-contrib-adder",
+  "version": "1.0.0",
+  "description": "Multi-input adder with optional weighting - sum or weighted average of inputs",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Wobi848/node-red-contrib-rpo-suite.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Wobi848/node-red-contrib-rpo-suite/issues"
+  },
+  "files": [
+    "adder.js",
+    "adder.html",
+    "locales",
+    "examples"
+  ],
+  "keywords": [
+    "node-red",
+    "adder",
+    "sum",
+    "average",
+    "weighted"
+  ],
+  "author": "sr.rpo",
+  "license": "MIT",
+  "node-red": {
+    "version": "1.0.0",
+    "nodes": {
+      "adder": "adder.js"
+    }
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "scripts": {
+    "test": "mocha \"test/**/*_spec.js\" --exit"
+  },
+  "devDependencies": {
+    "mocha": "^10.2.0",
+    "node-red": "^3.1.0",
+    "node-red-node-test-helper": "^0.3.6"
+  }
+}