node-red-contrib-arithmetic 1.0.0

package/README.md

@@ -0,0 +1,36 @@
+# node-red-contrib-arithmetic
+
+A Node-RED node that performs arithmetic operations (+, -, x, /, %, ^) on two numeric inputs.
+
+## Installation
+
+```bash
+npm install node-red-contrib-arithmetic
+```
+
+## Inputs
+
+- **payload** `number`: Value for A or B (identified by msg.topic).
+- **topic** `string`: Set to Topic A or Topic B name.
+- **operator** _(optional)_ `string`: Override operator: + - x / % ^
+- **reset** _(optional)_ `boolean`: Clear stored A and B values.
+
+## Outputs
+
+- **payload** `number`: Result rounded to configured decimal places.
+- **arithmetic** `object`: { a, b, operator, result, decimals }
+
+## Configuration
+
+- **Topic A/B**: msg.topic identifiers (default: a / b).
+- **Operator**: Arithmetic operator (default: +).
+- **Decimal Places**: Output precision 0-10 (default: 2).
+
+## Tips
+
+- Division and modulo by zero are blocked with a warning - no output sent.
+- Output fires when both A and B are known.
+
+## License
+
+MIT (c) sr.rpo

package/arithmetic.html

@@ -0,0 +1,78 @@
+<script type="text/javascript">
+    RED.nodes.registerType('arithmetic', {
+        category:  'rpo',
+        color:     '#D4600A',
+        defaults: {
+            name:     { value: '' },
+            topicA:   { value: 'a' },
+            topicB:   { value: 'b' },
+            operator: { value: '+' },
+            decimals: { value: 2 }
+        },
+        inputs:  1,
+        outputs: 1,
+        icon:    'font-awesome/fa-calculator',
+        label:   function() { return this.name || ('A ' + (this.operator || '+') + ' B'); },
+        labelStyle: function() { return this.name ? 'node_label_italic' : ''; }
+    });
+</script>
+
+<script type="text/html" data-template-name="arithmetic">
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> <span data-i18n="node-red:common.label.name"></span></label>
+        <input type="text" id="node-input-name" data-i18n="[placeholder]node-red:common.label.name">
+    </div>
+    <div class="form-row">
+        <label for="node-input-topicA"><i class="fa fa-font"></i> <span data-i18n="arithmetic.label.topicA"></span></label>
+        <input type="text" id="node-input-topicA" style="width:70%">
+    </div>
+    <div class="form-row">
+        <label for="node-input-topicB"><i class="fa fa-font"></i> <span data-i18n="arithmetic.label.topicB"></span></label>
+        <input type="text" id="node-input-topicB" style="width:70%">
+    </div>
+    <div class="form-row">
+        <label for="node-input-operator"><i class="fa fa-calculator"></i> <span data-i18n="arithmetic.label.operator"></span></label>
+        <select id="node-input-operator" style="width:70%">
+            <option value="+">+ (addition)</option>
+            <option value="-">- (subtraction)</option>
+            <option value="×">× (multiplication)</option>
+            <option value="÷">÷ (division)</option>
+            <option value="%">% (modulo)</option>
+            <option value="^">^ (power)</option>
+        </select>
+    </div>
+    <div class="form-row">
+        <label for="node-input-decimals"><i class="fa fa-sort-numeric-asc"></i> <span data-i18n="arithmetic.label.decimals"></span></label>
+        <input type="number" id="node-input-decimals" min="0" max="10" style="width:70%">
+    </div>
+</script>
+
+<script type="text/html" data-help-name="arithmetic">
+    <p>Performs arithmetic operations on two numeric inputs identified by <code>msg.topic</code>.</p>
+
+    <h3>Input</h3>
+    <dl class="message-properties">
+        <dt>payload <span class="property-type">number</span></dt>
+        <dd>Numeric value for input A or B (identified by <code>msg.topic</code>).</dd>
+        <dt>topic <span class="property-type">string</span></dt>
+        <dd>Set to the configured Topic A or Topic B name.</dd>
+        <dt class="optional">operator <span class="property-type">string</span></dt>
+        <dd>Override operator: <code>+</code> <code>-</code> <code>×</code> <code>÷</code> <code>%</code> <code>^</code></dd>
+        <dt class="optional">reset <span class="property-type">boolean</span></dt>
+        <dd>Set to <code>true</code> to clear stored A and B values.</dd>
+    </dl>
+
+    <h3>Output</h3>
+    <dl class="message-properties">
+        <dt>payload <span class="property-type">number</span></dt>
+        <dd>Arithmetic result rounded to configured decimal places.</dd>
+        <dt>arithmetic <span class="property-type">object</span></dt>
+        <dd><code>{ a, b, operator, result, decimals }</code></dd>
+    </dl>
+
+    <h3>Tips</h3>
+    <ul>
+        <li>Division and modulo by zero are blocked with a warning — no output is sent.</li>
+        <li>Output fires every time a new value arrives <strong>and both A and B are known</strong>.</li>
+    </ul>
+</script>

package/arithmetic.js

@@ -0,0 +1,82 @@
+module.exports = function(RED) {
+    function ArithmeticNode(config) {
+        RED.nodes.createNode(this, config);
+        var node = this;
+
+        node.topicA   = config.topicA   || 'a';
+        node.topicB   = config.topicB   || 'b';
+        node.operator = config.operator || '+';
+        node.decimals = parseInt(config.decimals, 10);
+        if (isNaN(node.decimals) || node.decimals < 0) node.decimals = 2;
+
+        node.valueA = undefined;
+        node.valueB = undefined;
+
+        updateStatus(node);
+
+        node.on('input', function(msg) {
+            if (msg.reset === true) {
+                node.valueA = undefined;
+                node.valueB = undefined;
+                updateStatus(node);
+                return;
+            }
+
+            var op  = msg.operator !== undefined ? msg.operator : node.operator;
+            var dec = node.decimals;
+            var topic = (msg.topic !== undefined) ? String(msg.topic) : '';
+
+            if (topic === node.topicA) {
+                var val = parseFloat(msg.payload);
+                if (isNaN(val)) { node.warn('Input A is not a number: ' + msg.payload); return; }
+                node.valueA = val;
+            } else if (topic === node.topicB) {
+                var val = parseFloat(msg.payload);
+                if (isNaN(val)) { node.warn('Input B is not a number: ' + msg.payload); return; }
+                node.valueB = val;
+            } else {
+                node.warn('Unknown topic: ' + topic + ' (expected "' + node.topicA + '" or "' + node.topicB + '")');
+                return;
+            }
+
+            if (node.valueA === undefined) { node.status({ fill: 'grey', shape: 'ring', text: 'Waiting for A...' }); return; }
+            if (node.valueB === undefined) { node.status({ fill: 'grey', shape: 'ring', text: 'Waiting for B...' }); return; }
+
+            var a = node.valueA, b = node.valueB;
+            var result;
+
+            switch (op) {
+                case '+': result = a + b; break;
+                case '-': result = a - b; break;
+                case '×': result = a * b; break;
+                case '÷':
+                    if (b === 0) { node.warn('Division by zero'); node.status({ fill: 'yellow', shape: 'dot', text: 'Division by zero' }); return; }
+                    result = a / b;
+                    break;
+                case '%':
+                    if (b === 0) { node.warn('Modulo by zero'); node.status({ fill: 'yellow', shape: 'dot', text: 'Modulo by zero' }); return; }
+                    result = a % b;
+                    break;
+                case '^': result = Math.pow(a, b); break;
+                default: node.warn('Unknown operator: ' + op); return;
+            }
+
+            result = parseFloat(result.toFixed(dec));
+
+            msg.payload    = result;
+            msg.arithmetic = { a: a, b: b, operator: op, result: result, decimals: dec };
+
+            node.status({ fill: 'green', shape: 'dot', text: a + ' ' + op + ' ' + b + ' = ' + result });
+            node.send(msg);
+        });
+
+        function updateStatus(n) {
+            if (n.valueA === undefined || n.valueB === undefined) {
+                var waiting = (n.valueA === undefined) ? 'A' : 'B';
+                n.status({ fill: 'grey', shape: 'ring', text: 'Waiting for ' + waiting + '...' });
+            }
+        }
+    }
+
+    RED.nodes.registerType('arithmetic', ArithmeticNode);
+};

package/locales/de/arithmetic.json

@@ -0,0 +1,10 @@
+{
+  "arithmetic": {
+    "label": {
+      "topicA": "Topic A",
+      "topicB": "Topic B",
+      "operator": "Operator",
+      "decimals": "Dezimalstellen"
+    }
+  }
+}

package/locales/en/arithmetic.json

@@ -0,0 +1,10 @@
+{
+  "arithmetic": {
+    "label": {
+      "topicA": "Topic A",
+      "topicB": "Topic B",
+      "operator": "Operator",
+      "decimals": "Decimal Places"
+    }
+  }
+}

package/locales/es/arithmetic.json

@@ -0,0 +1,10 @@
+{
+  "arithmetic": {
+    "label": {
+      "topicA": "Tema A",
+      "topicB": "Tema B",
+      "operator": "Operador",
+      "decimals": "Decimales"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "node-red-contrib-arithmetic",
+  "version": "1.0.0",
+  "description": "Performs arithmetic operations (+,-,×,÷,%,^) on two numeric 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": [
+    "arithmetic.js",
+    "arithmetic.html",
+    "locales",
+    "examples"
+  ],
+  "keywords": [
+    "node-red",
+    "arithmetic",
+    "math",
+    "add",
+    "subtract",
+    "multiply",
+    "divide",
+    "calculator"
+  ],
+  "author": "sr.rpo",
+  "license": "MIT",
+  "node-red": {
+    "version": "1.0.0",
+    "nodes": {
+      "arithmetic": "arithmetic.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"
+  }
+}