node-red-contrib-boolean-logic-ultimate 1.1.24 → 1.1.26

package/CHANGELOG.md

@@ -3,6 +3,22 @@
 
 # CHANGELOG
 
+<p>
+<b>Version 1.1.26</b> July 2025<br/>
+- Interruptflow node: fixed non functional msg.play. </br>
+</p>
+
+<p>
+<b>Version 1.1.25</b> January 2025<br/>
+- BREAKING CHANGE<br/>
+- BREAKING CHANGE<br/>
+- BREAKING CHANGE<br/>
+- Numerical values are now evaluated as string values and translated like any other word in translation table. That means, 1 and numbers major than 1 are not equal to true anymore, and 0 is not equal to false anymore. If you input numerical values as boolean (bad attitude), please fix your flows by change it to boolean.</br>
+- BREAKING CHANGE<br/>
+- BREAKING CHANGE<br/>
+- BREAKING CHANGE<br/>
+
+</p>
 <p>
 <b>Version 1.1.24</b> January 2025<br/>
 - Translator node. added js evaluation of the values. For example "{{value>=50}}:true".</br>

package/README.md

@@ -1,4 +1,5 @@
 ![Logo](img/logo.png) 
+
 [![NPM version][npm-version-image]][npm-url]
 [![NPM downloads per month][npm-downloads-month-image]][npm-url]
 [![NPM downloads total][npm-downloads-total-image]][npm-url]
@@ -24,13 +25,9 @@ A set of Node-RED enhanced boolean logic and utility nodes, with persistent valu
 Other than true/false, all nodes accepts [Homeassistant](https://www.home-assistant.io) output strings.  
 
 You can **even add your own input translation word list**, thanks to the translator-config node.
-
 The translator node can translate an input payload, to a true/false boolean values.<br />
-
 Each row in the text box, represents a translation command. <br/>
-
 There are some default translation's rows, to make the *boolean-logic-ultimate* nodes compatible with Homeassistant as default. <br/>
-
 You can add your own translation row.<br/>
 
 |           | Description                                                                                          |
@@ -39,6 +36,48 @@ You can add your own translation row.<br/>
 
 ![alt text](image.png)
 
+
+<br/>
+<br/>
+
+# BOOLEAN LOGIC
+
+<img src='https://raw.githubusercontent.com/Supergiovane/node-red-contrib-boolean-logic-ultimate/master/img/bl1.png' width='60%'>
+
+<details><summary>CLICK HERE, copy and paste it into your flow</summary>
+<code>
+[{"id":"1a90a718.5c0409","type":"BooleanLogicUltimate","z":"adb2ee5c.0bf6e","name":"","filtertrue":"both","persist":true,"sInitializeWith":"WaitForPayload","triggertopic":"trigger","outputtriggeredby":"all","inputCount":2,"topic":"result","x":380,"y":160,"wires":[["5f9fbfcc.d2c34"],[],[]]},{"id":"81ef6fec.5d413","type":"inject","z":"adb2ee5c.0bf6e","name":"Night","topic":"Dark","payload":"true","payloadType":"bool","repeat":"","crontab":"","once":false,"onceDelay":0.1,"x":170,"y":180,"wires":[["1a90a718.5c0409"]]},{"id":"e0d5d620.966478","type":"inject","z":"adb2ee5c.0bf6e","name":"Daylight","topic":"Dark","payload":"false","payloadType":"bool","repeat":"","crontab":"","once":false,"onceDelay":0.1,"x":160,"y":140,"wires":[["1a90a718.5c0409"]]},{"id":"1c2f8e73.2c22ba","type":"inject","z":"adb2ee5c.0bf6e","name":"Motion detect true","topic":"Motion","payload":"true","payloadType":"bool","repeat":"","crontab":"","once":false,"onceDelay":0.1,"x":130,"y":240,"wires":[["1a90a718.5c0409"]]},{"id":"5f9fbfcc.d2c34","type":"debug","z":"adb2ee5c.0bf6e","name":"Garden Light","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"true","targetType":"full","x":580,"y":160,"wires":[]},{"id":"201baa3d.7c63ae","type":"inject","z":"adb2ee5c.0bf6e","name":"Motion detect false","topic":"Motion","payload":"false","payloadType":"bool","repeat":"","crontab":"","once":false,"onceDelay":0.1,"x":130,"y":280,"wires":[["1a90a718.5c0409"]]},{"id":"b65f4ff4.bfe2c8","type":"comment","z":"adb2ee5c.0bf6e","name":"Motion sensor turns on lights, when it's dark. The light turns off itself at day","info":"","x":290,"y":100,"wires":[]}]
+</code>
+</details>
+
+<img src='https://raw.githubusercontent.com/Supergiovane/node-red-contrib-boolean-logic-ultimate/master/img/bl2.png' width='60%'>
+
+<details><summary>CLICK HERE, copy and paste it into your flow</summary>
+<code>
+[{"id":"53a10a7a.cf1894","type":"BooleanLogicUltimate","z":"a76c6a12.37379","name":"","filtertrue":"onlytrue","persist":true,"sInitializeWith":"true","triggertopic":"Pushbutton","outputtriggeredby":"onlyonetopic","inputCount":2,"topic":"result","x":340,"y":220,"wires":[["cd9244ea.471b78"],[],[]]},{"id":"9318320b.670af8","type":"inject","z":"a76c6a12.37379","name":"","topic":"Pushbutton","payload":"true","payloadType":"bool","repeat":"","crontab":"","once":false,"onceDelay":0.1,"x":120,"y":220,"wires":[["53a10a7a.cf1894"]]},{"id":"20a981b9.552b4e","type":"inject","z":"a76c6a12.37379","name":"","topic":"IsNight","payload":"true","payloadType":"bool","repeat":"","crontab":"","once":false,"onceDelay":0.1,"x":110,"y":320,"wires":[["53a10a7a.cf1894"]]},{"id":"da0dff55.d7888","type":"inject","z":"a76c6a12.37379","name":"","topic":"IsNight","payload":"false","payloadType":"bool","repeat":"","crontab":"","once":false,"onceDelay":0.1,"x":110,"y":360,"wires":[["53a10a7a.cf1894"]]},{"id":"7129d101.1fb7d8","type":"comment","z":"a76c6a12.37379","name":"Pushbutton to switch on light stairs, only if it's night.","info":"","x":210,"y":180,"wires":[]},{"id":"cd9244ea.471b78","type":"debug","z":"a76c6a12.37379","name":"Temporized Stairs Lightbulb","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"payload","targetType":"msg","x":580,"y":220,"wires":[]},{"id":"ad5a62a1.7ad81","type":"comment","z":"a76c6a12.37379","name":"Brightness sensor","info":"","x":110,"y":280,"wires":[]}]
+</code>
+</details>
+
+The node performs Boolean logic on the incoming payloads.<br/>
+
+The node expects a fixed number of topics (configured in the settings) on which it will operate. It will only output a value 
+
+when it has seen the expected number of topics. If it ever sees more than the configured number of topics it will log a message then reset its state and start over.<br/>
+
+The input message is preserved and passed to the output, changing only the topic and the payload. 
+
+The node performs some checks on the incoming boolean payloads and outputs all results at the same time, as follow:<br/>
+
+- Output "AND": true or false<br/>
+- Output "OR": true or false<br/>
+- Output "XOR": true or false<br/>
+
+If you need ***"NAND"*** or ***"NOR"*** gate, just put an **InvertUltimate** node respectively after the "AND" or "OR" output.
+
+The node can have a persistent input: the input values are retained after a node-red reboot. That means, that if you reboot your node-red, you don't need to wait all inputs to arrive and initialize the node, before the node can output a payload.<br/>
+
+You can also set the default values of the topic inputs.<br/>
+
 The node can convert arbitrary input values to true/false. It supports Homeassistant string to boolean conversion as well. For enabling auto conversion, please be sure to disable **Reject non boolean (true/false) input values** <br/>
 
 ### NODE CONFIGURATION
@@ -86,8 +125,11 @@ The interrupt flows is able to stop the input messages to exiting the node.
 **INPUT MSG WITH "TRIGGER" TOPIC**
 
 Pass <code>msg.payload = true</code> to allow messages to pass through</br>
+
 Pass <code>msg.payload = false</code> to prevent messages from passing through</br>
+
 Pass <code>msg.play = true</code> from a message having the "trigger" topic, to replay the last stored message</br>
+
 Pass <code>msg.reset = true</code> from a message having the "trigger" topic, to clear the last stored message</br>
 
 <code>
@@ -485,6 +527,8 @@ Copy and paste it into your flow
 
 Please refer to [this](https://github.com/wouterbulten/kalmanjs) link, on how it works.  
 
+
+
 ![image.png](/img/image.png)
 
 | Property         | Description                                                                                          |
@@ -498,7 +542,6 @@ Please refer to [this](https://github.com/wouterbulten/kalmanjs) link, on how it
 ### Inputs
 
 : reset (any) : by passing msg.reset, the Kalman filter will be reset.
-
 : payload (number) : the payload containing the number. If you've changed the incoming evaluation property in the ***Input*** field, the number to be evaluated must be put in such message's property, instead of the *payload* property. 
 
 <br/>

package/boolean-logic-ultimate/InterruptFlowUltimate.js

@@ -11,7 +11,7 @@ module.exports = function (RED) {
       ) || "trigger"; // Topic controlling the bInviaMessaggio
     node.bInviaMessaggio =
       node.config.initializewith === undefined ||
-      node.config.initializewith === "1"
+        node.config.initializewith === "1"
         ? true
         : false; // Send the message or not
     node.autoToggle =
@@ -64,94 +64,95 @@ module.exports = function (RED) {
 
     this.on("input", function (msg) {
       var sIncomingTopic = "";
-      if (msg.hasOwnProperty("topic")) {
-        // 06/11/2019
-        if (!msg.hasOwnProperty("topic") || msg.topic === undefined)
-          msg.topic = "NoTopicReceived";
-        sIncomingTopic = msg.topic.replace(
-          /[`~!@#$%^&*()_|+\-=?;:'",.<>\{\}\[\]\\\/]/gi,
-          ""
-        ); // Cut unwanted Characters
-        if (sIncomingTopic === node.sTriggerTopic) {
-          const utils = require("./utils.js");
-          let sPayload = utils.fetchFromObject(
-            msg,
-            config.payloadPropName || "payload"
-          );
-          // 15/11/2021 inform user about undefined topic or payload
-          if (sPayload === undefined) {
-            setNodeStatus({
-              fill: "red",
-              shape: "dot",
-              text: "Received invalid payload from " + msg.topic || "",
-            });
-            return;
-          }
-          msg.payload = utils.ToBoolean(
-            sPayload,
-            RED.nodes.getNode(config.translatorConfig) // Retrieve the config node. It can be null, but it's handled in utils.js; // 15/11/2021 Convert input to boolean.
-          );
-          if (msg.payload === undefined) return null;
-          if (node.timerAutoToggle !== null)
-            // 28/01/2022 Stop autotoggle
-            clearInterval(node.timerAutoToggle);
+      //if (msg.hasOwnProperty("topic")) {
+      // 06/11/2019
+      if (!msg.hasOwnProperty("topic") || msg.topic === undefined)
+        msg.topic = "NoTopicReceived";
+      sIncomingTopic = msg.topic.replace(
+        /[`~!@#$%^&*()_|+\-=?;:'",.<>\{\}\[\]\\\/]/gi,
+        ""
+      ); // Cut unwanted Characters
+      if (sIncomingTopic === node.sTriggerTopic) {
+        const utils = require("./utils.js");
+        let sPayload = utils.fetchFromObject(
+          msg,
+          config.payloadPropName || "payload"
+        );
+        // 15/11/2021 inform user about undefined topic or payload
+        if (sPayload === undefined) {
+          setNodeStatus({
+            fill: "red",
+            shape: "dot",
+            text: "Received invalid payload from " + msg.topic || "",
+          });
+          return;
+        }
+        msg.payload = utils.ToBoolean(
+          sPayload,
+          RED.nodes.getNode(config.translatorConfig) // Retrieve the config node. It can be null, but it's handled in utils.js; // 15/11/2021 Convert input to boolean.
+        );
+        //if (msg.payload === undefined) return null;
+        if (node.timerAutoToggle !== null) {
+          // 28/01/2022 Stop autotoggle
+          clearInterval(node.timerAutoToggle);
+        }
 
-          if (msg.hasOwnProperty("play")) {
-            if (node.currentMsg.payload !== undefined) {
-              node.currentMsg.isReplay = true;
-              setNodeStatus({
-                fill: "yellow",
-                shape: "dot",
-                text: "-> replay",
-              });
-              // Restore previous status
-              let t = setTimeout(() => {
-                if (node.bInviaMessaggio) {
-                  setNodeStatus({
-                    fill: "green",
-                    shape: "dot",
-                    text: "-> pass",
-                  });
-                } else {
-                  setNodeStatus({
-                    fill: "red",
-                    shape: "dot",
-                    text: "|| stop (stored last msg)",
-                  });
-                }
-              }, 1000);
-              node.send(node.currentMsg);
-            } else {
-              setNodeStatus({
-                fill: "grey",
-                shape: "dot",
-                text: "Nothing to replay",
-              });
-            }
-            return;
-          } else if (msg.hasOwnProperty("reset")) {
-            node.currentMsg = {};
+        if (msg.hasOwnProperty("play")) {
+          if (node.currentMsg.payload !== undefined) {
+            node.currentMsg.isReplay = true;
             setNodeStatus({
               fill: "yellow",
               shape: "dot",
-              text: "Deleted stored msg",
+              text: "-> replay",
             });
-            return;
-          } else if (msg.payload === true) {
-            node.bInviaMessaggio = true;
-            setNodeStatus({ fill: "green", shape: "dot", text: "-> pass" });
-            return;
-          } else if (msg.payload === false) {
-            node.bInviaMessaggio = false;
+            // Restore previous status
+            let t = setTimeout(() => {
+              if (node.bInviaMessaggio) {
+                setNodeStatus({
+                  fill: "green",
+                  shape: "dot",
+                  text: "-> pass",
+                });
+              } else {
+                setNodeStatus({
+                  fill: "red",
+                  shape: "dot",
+                  text: "|| stop (stored last msg)",
+                });
+              }
+            }, 1000);
+            node.send(node.currentMsg);
+          } else {
             setNodeStatus({
-              fill: "red",
+              fill: "grey",
               shape: "dot",
-              text: "|| stop (stored last msg)",
+              text: "Nothing to replay",
             });
-            return;
           }
+          return;
+        } else if (msg.hasOwnProperty("reset")) {
+          node.currentMsg = {};
+          setNodeStatus({
+            fill: "yellow",
+            shape: "dot",
+            text: "Deleted stored msg",
+          });
+          return;
+        } else if (msg.payload === true) {
+          node.bInviaMessaggio = true;
+          setNodeStatus({ fill: "green", shape: "dot", text: "-> pass" });
+          return;
+        } else if (msg.payload === false) {
+          node.bInviaMessaggio = false;
+          setNodeStatus({
+            fill: "red",
+            shape: "dot",
+            text: "|| stop (stored last msg)",
+          });
+          return;
         }
       }
+      //}
       node.currentMsg = RED.util.cloneMessage(msg);
       if (node.bInviaMessaggio) {
         node.send(msg);

package/boolean-logic-ultimate/utils.js

@@ -4,7 +4,8 @@ module.exports.ToBoolean = function ToBoolean(value, _configTranslationNode) {
 
   if (typeof value === "boolean") {
     return value;
-  } else if (typeof value === "string") {
+  } else if (typeof value === "string" || typeof value === "number") {
+    if (typeof value === "number") value = value.toString(); // We work with strings
     try {
       let translationTable = [];
       value = value.toLowerCase();
@@ -36,15 +37,16 @@ module.exports.ToBoolean = function ToBoolean(value, _configTranslationNode) {
     } catch (error) {
       console.log("Boolean-Logic-Ultimate:utils:toBoolean: " + error.message);
     }
-  } else if (typeof value === "number") {
-    // Is it formated as a decimal number?
-    if (decimal.test(value)) {
-      res = parseFloat(value) != 0;
-    } else {
-      res = value.toLowerCase() === "true";
-    }
-    return res;
   }
+  // else if (typeof value === "number") {
+  //   // Is it formated as a decimal number?
+  //   if (decimal.test(value)) {
+  //     res = parseFloat(value) != 0;
+  //   } else {
+  //     res = value.toLowerCase() === "true";
+  //   }
+  //   return res;
+  // }
 };
 
 module.exports.ToAny = function ToAny(value, _configTranslationNode) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "node-red-contrib-boolean-logic-ultimate",
-    "version": "1.1.24",
+    "version": "1.1.26",
     "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": {