node-red-contrib-boolean-logic-ultimate 1.2.3 → 1.2.5

package/examples/StaircaseLightUltimate.json

@@ -0,0 +1,145 @@
+[
+  {
+    "id": "st_tab_1",
+    "type": "tab",
+    "label": "StaircaseLightUltimate - timed light",
+    "disabled": false,
+    "info": "Esempio: accende la luce per una durata e la spegne automaticamente, con warning pre-off opzionale."
+  },
+  {
+    "id": "st_cmt_1",
+    "type": "comment",
+    "z": "st_tab_1",
+    "name": "Trigger = payload true, off = payload false (se abilitato)",
+    "info": "Il topic di controllo è \"stairs\" (comandi on/off/extend).",
+    "x": 300,
+    "y": 60,
+    "wires": []
+  },
+  {
+    "id": "st_inj_motion",
+    "type": "inject",
+    "z": "st_tab_1",
+    "name": "Motion (true)",
+    "props": [
+      { "p": "payload", "v": "true", "vt": "bool" },
+      { "p": "topic", "v": "sensor", "vt": "str" }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "x": 150,
+    "y": 140,
+    "wires": [["st_node_1"]]
+  },
+  {
+    "id": "st_inj_off_input",
+    "type": "inject",
+    "z": "st_tab_1",
+    "name": "Off input (false)",
+    "props": [
+      { "p": "payload", "v": "false", "vt": "bool" },
+      { "p": "topic", "v": "sensor", "vt": "str" }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "x": 160,
+    "y": 180,
+    "wires": [["st_node_1"]]
+  },
+  {
+    "id": "st_inj_extend",
+    "type": "inject",
+    "z": "st_tab_1",
+    "name": "Extend (topic=stairs)",
+    "props": [
+      { "p": "topic", "v": "stairs", "vt": "str" },
+      { "p": "extend", "v": "true", "vt": "bool" }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "x": 170,
+    "y": 240,
+    "wires": [["st_node_1"]]
+  },
+  {
+    "id": "st_inj_force_off",
+    "type": "inject",
+    "z": "st_tab_1",
+    "name": "Force off (topic=stairs)",
+    "props": [
+      { "p": "topic", "v": "stairs", "vt": "str" },
+      { "p": "command", "v": "off", "vt": "str" }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "x": 180,
+    "y": 280,
+    "wires": [["st_node_1"]]
+  },
+  {
+    "id": "st_node_1",
+    "type": "StaircaseLightUltimate",
+    "z": "st_tab_1",
+    "name": "Stairs",
+    "controlTopic": "stairs",
+    "payloadPropName": "payload",
+    "translatorConfig": "",
+    "durationSeconds": 10,
+    "warningEnabled": true,
+    "warningOffsetSeconds": 3,
+    "restartOnTrigger": true,
+    "allowOffInput": true,
+    "onPayload": true,
+    "onPayloadType": "bool",
+    "offPayload": false,
+    "offPayloadType": "bool",
+    "warningPayload": "warning",
+    "warningPayloadType": "str",
+    "x": 390,
+    "y": 200,
+    "wires": [["st_dbg_cmd"], ["st_dbg_warn"]]
+  },
+  {
+    "id": "st_dbg_cmd",
+    "type": "debug",
+    "z": "st_tab_1",
+    "name": "Light command",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 600,
+    "y": 180,
+    "wires": []
+  },
+  {
+    "id": "st_dbg_warn",
+    "type": "debug",
+    "z": "st_tab_1",
+    "name": "Warning",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 580,
+    "y": 220,
+    "wires": []
+  }
+]
+

package/examples/StatusUltimate.json

@@ -0,0 +1,61 @@
+[
+  {
+    "id": "stu_tab_1",
+    "type": "tab",
+    "label": "StatusUltimate - show msg property",
+    "disabled": false,
+    "info": "Esempio: mostra il valore di una proprietà del msg nello status del nodo, e lascia passare il msg."
+  },
+  {
+    "id": "stu_cmt_1",
+    "type": "comment",
+    "z": "stu_tab_1",
+    "name": "Lo status mostra msg.payload",
+    "info": "Configura la proprietà da mostrare (es. payload, mycar.color, ecc.).",
+    "x": 200,
+    "y": 60,
+    "wires": []
+  },
+  {
+    "id": "stu_inj_1",
+    "type": "inject",
+    "z": "stu_tab_1",
+    "name": "payload = \"Ciao\"",
+    "props": [{ "p": "payload", "v": "Ciao", "vt": "str" }],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "x": 150,
+    "y": 140,
+    "wires": [["stu_node_1"]]
+  },
+  {
+    "id": "stu_node_1",
+    "type": "StatusUltimate",
+    "z": "stu_tab_1",
+    "name": "Status",
+    "property": "payload",
+    "x": 340,
+    "y": 140,
+    "wires": [["stu_dbg_1"]]
+  },
+  {
+    "id": "stu_dbg_1",
+    "type": "debug",
+    "z": "stu_tab_1",
+    "name": "Pass-through",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 560,
+    "y": 140,
+    "wires": []
+  }
+]
+

package/examples/SumUltimate.json

@@ -0,0 +1,222 @@
+[
+  {
+    "id": "sum_tab_1",
+    "type": "tab",
+    "label": "SumUltimate - sum + subtract",
+    "disabled": false,
+    "info": "Esempi: somma con topic diversi e sottrazione con \"Subtract from\"."
+  },
+  {
+    "id": "sum_cmt_1",
+    "type": "comment",
+    "z": "sum_tab_1",
+    "name": "SUM: ogni msg.topic rappresenta una variabile",
+    "info": "Il nodo memorizza l'ultimo valore per ciascun topic e ricalcola ad ogni arrivo.",
+    "x": 240,
+    "y": 60,
+    "wires": []
+  },
+  {
+    "id": "sum_inj_a",
+    "type": "inject",
+    "z": "sum_tab_1",
+    "name": "a = 10",
+    "props": [
+      { "p": "payload" },
+      { "p": "topic", "vt": "str" }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "topic": "a",
+    "payload": "10",
+    "payloadType": "num",
+    "x": 120,
+    "y": 120,
+    "wires": [["sum_node_sum"]]
+  },
+  {
+    "id": "sum_inj_b",
+    "type": "inject",
+    "z": "sum_tab_1",
+    "name": "b = 5",
+    "props": [
+      { "p": "payload" },
+      { "p": "topic", "vt": "str" }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "topic": "b",
+    "payload": "5",
+    "payloadType": "num",
+    "x": 110,
+    "y": 160,
+    "wires": [["sum_node_sum"]]
+  },
+  {
+    "id": "sum_inj_c",
+    "type": "inject",
+    "z": "sum_tab_1",
+    "name": "c = 2",
+    "props": [
+      { "p": "payload" },
+      { "p": "topic", "vt": "str" }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "topic": "c",
+    "payload": "2",
+    "payloadType": "num",
+    "x": 110,
+    "y": 200,
+    "wires": [["sum_node_sum"]]
+  },
+  {
+    "id": "sum_inj_reset_1",
+    "type": "inject",
+    "z": "sum_tab_1",
+    "name": "reset",
+    "props": [{ "p": "reset", "v": "true", "vt": "bool" }],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "x": 110,
+    "y": 240,
+    "wires": [["sum_node_sum", "sum_node_sub"]]
+  },
+  {
+    "id": "sum_node_sum",
+    "type": "SumUltimate",
+    "z": "sum_tab_1",
+    "name": "Sum",
+    "property": "payload",
+    "math": "sum",
+    "subtractstartfrom": "",
+    "x": 320,
+    "y": 160,
+    "wires": [["sum_dbg_sum"]]
+  },
+  {
+    "id": "sum_dbg_sum",
+    "type": "debug",
+    "z": "sum_tab_1",
+    "name": "SUM result",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "payload",
+    "targetType": "msg",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 540,
+    "y": 160,
+    "wires": []
+  },
+  {
+    "id": "sum_cmt_2",
+    "type": "comment",
+    "z": "sum_tab_1",
+    "name": "SUBTRACT: scegli il topic iniziale (Subtract from)",
+    "info": "Qui la sottrazione parte dal topic \"startNumber\" e sottrae a/b.",
+    "x": 270,
+    "y": 300,
+    "wires": []
+  },
+  {
+    "id": "sum_inj_start",
+    "type": "inject",
+    "z": "sum_tab_1",
+    "name": "startNumber = 100",
+    "props": [
+      { "p": "payload" },
+      { "p": "topic", "vt": "str" }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "topic": "startNumber",
+    "payload": "100",
+    "payloadType": "num",
+    "x": 150,
+    "y": 360,
+    "wires": [["sum_node_sub"]]
+  },
+  {
+    "id": "sum_inj_sa",
+    "type": "inject",
+    "z": "sum_tab_1",
+    "name": "a = 20",
+    "props": [
+      { "p": "payload" },
+      { "p": "topic", "vt": "str" }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "topic": "a",
+    "payload": "20",
+    "payloadType": "num",
+    "x": 120,
+    "y": 400,
+    "wires": [["sum_node_sub"]]
+  },
+  {
+    "id": "sum_inj_sb",
+    "type": "inject",
+    "z": "sum_tab_1",
+    "name": "b = 10",
+    "props": [
+      { "p": "payload" },
+      { "p": "topic", "vt": "str" }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "topic": "b",
+    "payload": "10",
+    "payloadType": "num",
+    "x": 120,
+    "y": 440,
+    "wires": [["sum_node_sub"]]
+  },
+  {
+    "id": "sum_node_sub",
+    "type": "SumUltimate",
+    "z": "sum_tab_1",
+    "name": "Subtract",
+    "property": "payload",
+    "math": "subtract",
+    "subtractstartfrom": "startNumber",
+    "x": 330,
+    "y": 420,
+    "wires": [["sum_dbg_sub"]]
+  },
+  {
+    "id": "sum_dbg_sub",
+    "type": "debug",
+    "z": "sum_tab_1",
+    "name": "SUBTRACT result",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "payload",
+    "targetType": "msg",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 560,
+    "y": 420,
+    "wires": []
+  }
+]
+

package/examples/toggleUltimate.json

@@ -0,0 +1,63 @@
+[
+  {
+    "id": "tog_tab_1",
+    "type": "tab",
+    "label": "toggleUltimate - toggle true/false",
+    "disabled": false,
+    "info": "Esempio: ad ogni msg in ingresso, il nodo alterna il payload tra true e false."
+  },
+  {
+    "id": "tog_cmt_1",
+    "type": "comment",
+    "z": "tog_tab_1",
+    "name": "Ogni click alterna true/false",
+    "info": "Serve solo che esista msg.payload (il valore non viene usato, ma deve essere presente).",
+    "x": 220,
+    "y": 60,
+    "wires": []
+  },
+  {
+    "id": "tog_inj_1",
+    "type": "inject",
+    "z": "tog_tab_1",
+    "name": "Toggle",
+    "props": [{ "p": "payload", "v": "1", "vt": "num" }],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "x": 140,
+    "y": 140,
+    "wires": [["tog_node_1"]]
+  },
+  {
+    "id": "tog_node_1",
+    "type": "toggleUltimate",
+    "z": "tog_tab_1",
+    "name": "Toggle",
+    "valueToToggle": "true",
+    "payloadPropName": "payload",
+    "translatorConfig": "",
+    "x": 330,
+    "y": 140,
+    "wires": [["tog_dbg_1"]]
+  },
+  {
+    "id": "tog_dbg_1",
+    "type": "debug",
+    "z": "tog_tab_1",
+    "name": "Output",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "payload",
+    "targetType": "msg",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 520,
+    "y": 140,
+    "wires": []
+  }
+]
+

package/examples/translator-config.json

@@ -0,0 +1,99 @@
+[
+  {
+    "id": "tr_tab_1",
+    "type": "tab",
+    "label": "translator-config - example usage",
+    "disabled": false,
+    "info": "Esempio: usa translator-config per convertire stringhe (on/off, open/closed, ecc.) in booleani."
+  },
+  {
+    "id": "tr_cmt_1",
+    "type": "comment",
+    "z": "tr_tab_1",
+    "name": "Il FilterUltimate usa translator-config",
+    "info": "Invia payload \"open\"/\"closed\" e osserva su quale uscita viene instradato.",
+    "x": 240,
+    "y": 60,
+    "wires": []
+  },
+  {
+    "id": "tr_inj_open",
+    "type": "inject",
+    "z": "tr_tab_1",
+    "name": "payload = \"open\"",
+    "props": [{ "p": "payload", "v": "open", "vt": "str" }],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "x": 150,
+    "y": 140,
+    "wires": [["tr_filter_1"]]
+  },
+  {
+    "id": "tr_inj_closed",
+    "type": "inject",
+    "z": "tr_tab_1",
+    "name": "payload = \"closed\"",
+    "props": [{ "p": "payload", "v": "closed", "vt": "str" }],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "x": 160,
+    "y": 180,
+    "wires": [["tr_filter_1"]]
+  },
+  {
+    "id": "tr_filter_1",
+    "type": "FilterUltimate",
+    "z": "tr_tab_1",
+    "name": "Filter + Translator",
+    "payloadPropName": "payload",
+    "translatorConfig": "tr_cfg_1",
+    "x": 380,
+    "y": 160,
+    "wires": [["tr_dbg_true"], ["tr_dbg_false"]]
+  },
+  {
+    "id": "tr_dbg_true",
+    "type": "debug",
+    "z": "tr_tab_1",
+    "name": "True (translated)",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "payload",
+    "targetType": "msg",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 600,
+    "y": 140,
+    "wires": []
+  },
+  {
+    "id": "tr_dbg_false",
+    "type": "debug",
+    "z": "tr_tab_1",
+    "name": "False (translated)",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "payload",
+    "targetType": "msg",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 610,
+    "y": 180,
+    "wires": []
+  },
+  {
+    "id": "tr_cfg_1",
+    "type": "translator-config",
+    "name": "Default translations",
+    "commandText": "on:true\noff:false\nactive:true\ninactive:false\nopen:true\nclosed:false\nclose:false\n1:true\n0:false\ntrue:true\nfalse:false\nhome:true\nnot_home:false"
+  }
+]
+

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "node-red-contrib-boolean-logic-ultimate",
-    "version": "1.2.3",
+    "version": "1.2.5",
     "description": "A set of Node-RED enhanced boolean logic and utility nodes, flow interruption, blinker, invert, filter, toggle etc.., with persistent values after reboot. Compatible also with Homeassistant values.",
     "author": "Supergiovane (https://github.com/Supergiovane)",
     "dependencies": {
@@ -51,4 +51,4 @@
     "scripts": {
         "test": "mocha test/**/*.spec.js"
     }
-}
+}

package/test/helpers.js

@@ -8,10 +8,25 @@ helper.init(require.resolve('node-red')); // initialise with Node-RED runtime
 const nodes = {
   RateLimiterUltimate: require(path.join('..', 'boolean-logic-ultimate', 'RateLimiterUltimate.js')),
   PresenceSimulatorUltimate: require(path.join('..', 'boolean-logic-ultimate', 'PresenceSimulatorUltimate.js')),
+  RailwaySwitchUltimate: require(path.join('..', 'boolean-logic-ultimate', 'RailwaySwitchUltimate.js')),
 };
 
 function loadNode(nodeDef, flow, credentials = {}) {
-  return helper.load(nodeDef, flow, credentials);
+  const normalizedFlow = flow.map((node, index) => {
+    if (
+      node &&
+      node.type &&
+      node.type !== 'tab' &&
+      node.type !== 'subflow' &&
+      node.type !== 'group' &&
+      node.z &&
+      !(Object.prototype.hasOwnProperty.call(node, 'x') && Object.prototype.hasOwnProperty.call(node, 'y'))
+    ) {
+      return { ...node, x: 100 + index * 10, y: 100 + index * 10 };
+    }
+    return node;
+  });
+  return helper.load(nodeDef, normalizedFlow, credentials);
 }
 
 function loadRateLimiter(flow, credentials = {}) {
@@ -22,8 +37,13 @@ function loadPresence(flow, credentials = {}) {
   return loadNode(nodes.PresenceSimulatorUltimate, flow, credentials);
 }
 
+function loadRailwaySwitch(flow, credentials = {}) {
+  return loadNode(nodes.RailwaySwitchUltimate, flow, credentials);
+}
+
 module.exports = {
   helper,
   loadRateLimiter,
   loadPresence,
+  loadRailwaySwitch,
 };

package/test/presence-simulator.spec.js

@@ -39,7 +39,7 @@ describe('PresenceSimulatorUltimate node', function () {
     ];
 
     loadPresence(flow).then(() => {
-      const input = helper.getNode('in');
+      const presence = helper.getNode('presence');
       const out = helper.getNode('out');
 
       out.on('input', (msg) => {
@@ -52,7 +52,7 @@ describe('PresenceSimulatorUltimate node', function () {
         }
       });
 
-      input.receive({ topic: 'presence', command: 'start' });
+      presence.receive({ topic: 'presence', command: 'start' });
     }).catch(done);
   });
 
@@ -76,14 +76,14 @@ describe('PresenceSimulatorUltimate node', function () {
     ];
 
     loadPresence(flow).then(() => {
-      const input = helper.getNode('in');
+      const presence = helper.getNode('presence');
       const out = helper.getNode('out');
       let received = 0;
 
       out.on('input', () => {
         received += 1;
         if (received === 1) {
-          input.receive({ topic: 'presence', command: 'stop' });
+          presence.receive({ topic: 'presence', command: 'stop' });
           setTimeout(() => {
             try {
               expect(received).to.equal(1);
@@ -95,7 +95,7 @@ describe('PresenceSimulatorUltimate node', function () {
         }
       });
 
-      input.receive({ topic: 'presence', command: 'start' });
+      presence.receive({ topic: 'presence', command: 'start' });
     }).catch(done);
   });
 });