@patricktobias86/node-red-telegram-account 1.1.7 → 1.1.9

package/CHANGELOG.md

@@ -9,3 +9,7 @@ All notable changes to this project will be documented in this file.
 ### Changed
 - Session management now tracks active clients in a `Map` for safer reuse.
 
+## [1.1.8] - 2025-07-22
+### Fixed
+- Receiver and Command nodes now remove their event listeners when closed to prevent duplicate messages after redeploys.
+

package/README.md

@@ -18,8 +18,8 @@ See [docs/NODES.md](docs/NODES.md) for a detailed description of every node. Bel
 
 - **config** – stores your API credentials and caches sessions for reuse.
 - **auth** – interactive login that outputs a `stringSession`.
-- **receiver** – emits messages for every incoming update (with optional ignore list).
-- **command** – triggers when an incoming message matches a command or regex.
+- **receiver** – emits messages for every incoming update (with optional ignore list). Event listeners are cleaned up on node close so redeploys won't duplicate messages.
+- **command** – triggers when an incoming message matches a command or regex. Event listeners are removed on redeploy to prevent duplicates.
 - **send-message** – sends text or media messages with rich options.
 - **send-files** – uploads one or more files with captions and buttons.
 - **get-entity** – resolves usernames, IDs or t.me links into Telegram entities.
@@ -29,6 +29,8 @@ See [docs/NODES.md](docs/NODES.md) for a detailed description of every node. Bel
 - **promote-admin** – promotes a user to admin with configurable rights.
 - **resolve-userid** – converts a username to a numeric user ID.
 
+All nodes include a <code>Debug</code> option that logs incoming and outgoing messages to the Node-RED log when enabled.
+
 ## Session management
 
 Connections to Telegram are cached by the configuration node. A Map keyed by the `stringSession` tracks each client together with a reference count and the connection promise. If a node is created while another one is still connecting, it waits for that promise and then reuses the same client.

package/docs/NODES.md

@@ -8,8 +8,8 @@ Below is a short description of each node. For a full list of configuration opti
 |------|-------------|
 | **config** | Configuration node storing API credentials and connection options. Other nodes reference this to share a Telegram client and reuse the session. Connections are tracked in a Map with a reference count so multiple nodes can wait for the same connection. |
 | **auth** | Starts an interactive login flow. Produces a `stringSession` that can be reused with the `config` node. |
-| **receiver** | Emits an output message for every incoming Telegram message. Can ignore specific user IDs. |
-| **command** | Listens for new messages and triggers when a message matches a configured command or regular expression. |
+| **receiver** | Emits an output message for every incoming Telegram message. Can ignore specific user IDs. Event handlers are automatically removed when the node is closed. |
+| **command** | Listens for new messages and triggers when a message matches a configured command or regular expression. The event listener is cleaned up on node close to avoid duplicates. |
 | **send-message** | Sends text messages or media files to a chat. Supports parse mode, buttons, scheduling, and more. |
 | **send-files** | Uploads one or more files to a chat with optional caption, thumbnails and other parameters. |
 | **get-entity** | Resolves a username, user ID or t.me URL into a Telegram entity object. |
@@ -20,3 +20,5 @@ Below is a short description of each node. For a full list of configuration opti
 | **resolve-userid** | Converts a Telegram username to its numeric user ID. |
 
 
+All nodes provide a **Debug** checkbox. When enabled the node will log its input and output messages to aid troubleshooting.
+

package/nodes/auth.html

@@ -7,7 +7,8 @@
             api_id: { value: "" },
             api_hash: { value: "" },
             phoneNumber: { value: "" },
-            password: { value: "" }
+            password: { value: "" },
+            debug: { value: false }
         },
         inputs: 1,
         outputs: 1,
@@ -70,6 +71,12 @@
     </label>
     <input type="password" id="node-input-password" placeholder="Enter your password (if any)">
 </div>
+<div class="form-row">
+    <label for="node-input-debug">
+        <i class="fa fa-bug"></i> Debug
+    </label>
+    <input type="checkbox" id="node-input-debug">
+</div>
 
 <p>
     <strong>Note:</strong> These values are used to create a Telegram session string.
@@ -78,6 +85,7 @@
 
 <script type="text/html" data-help-name="auth">
     <p>The <b>auth</b> node facilitates Telegram API authentication using the <code>telegram</code> (GramJS) library. It allows users to authenticate a session and retrieve a <code>stringSession</code> for reuse with other Telegram clients.</p>
+    <p>Enable <b>Debug</b> to log the incoming credentials and returned session.</p>
 
     <h3>Inputs</h3>
     <dl class="message-properties">

package/nodes/auth.js

@@ -5,8 +5,13 @@ module.exports = function (RED) {
     function TelegramClientConfig(config) {
         RED.nodes.createNode(this, config);
         const node = this;
+        this.debugEnabled = config.debug;
 
         this.on("input", async (msg) => {
+            const debug = node.debugEnabled || msg.debug;
+            if (debug) {
+                node.log('auth input: ' + JSON.stringify(msg));
+            }
 
             const payload = (msg && typeof msg.payload === "object") ? msg.payload : {};
 
@@ -53,22 +58,27 @@ module.exports = function (RED) {
                     ]
                 });
 
-                node.send({
+                const out = {
                     topic: "auth_success",
                     payload: {
                         stringSession,
                         message: "Authorization successful!"
                     }
-                });
+                };
+                node.send(out);
+                if (debug) {
+                    node.log('auth output: ' + JSON.stringify(out));
+                }
 
                 node.status({ fill: "green", shape: "dot", text: "Authenticated" });
 
             } catch (err) {
                 node.error("Authentication failed: " + err.message);
-                node.send({
-                    topic: "auth_error",
-                    payload: { error: err.message },
-                });
+                const out = { topic: "auth_error", payload: { error: err.message } };
+                node.send(out);
+                if (debug) {
+                    node.log('auth output: ' + JSON.stringify(out));
+                }
                 node.status({ fill: "red", shape: "ring", text: "Failed" });
             }
         });

package/nodes/command.html

@@ -7,7 +7,8 @@
         name: { value: '' },
         config: { type: 'config', required: false },
         command: { value: "", required: true },
-        regex: { value: false }
+        regex: { value: false },
+        debug: { value: false }
       },
       inputs: 1,
       outputs: 1,
@@ -41,6 +42,12 @@
         style="width: 60%"
       />
     </div>
+    <div class="form-row">
+      <label for="node-input-debug">
+        <i class="fa fa-bug"></i> Debug
+      </label>
+      <input type="checkbox" id="node-input-debug">
+    </div>
 
     <div class="form-row">
         <label for="node-input-command">
@@ -57,8 +64,9 @@
     </div>
   </script>
 
-  <script type="text/html" data-help-name="command">
+<script type="text/html" data-help-name="command">
     <p>The <b>command</b> node listens for specific commands or patterns in Telegram messages and triggers further processing when a match is found. It supports both exact matches and regex-based pattern matching.</p>
+    <p>Enable <b>Debug</b> to log matching updates and outputs.</p>
 
     <h3>Inputs</h3>
     <p>This node does not take any direct inputs. Instead, it listens for incoming messages from the Telegram bot or user.</p>

package/nodes/command.js

@@ -5,48 +5,61 @@ module.exports = function (RED) {
   function Command(config) {
     RED.nodes.createNode(this, config);
     this.config = RED.nodes.getNode(config.config);
+    this.debugEnabled = config.debug;
     var node = this;
     /** @type {TelegramClient} */
     const client =  this.config.client;
 
-    
-
-    try {
-      client.addEventHandler((update) => {
-        const message = update.message.message
+    const event = new NewMessage();
+    const handler = (update) => {
+        const debug = node.debugEnabled;
+        const message = update.message.message;
+        if (debug) {
+            node.log('command update: ' + JSON.stringify(update));
+        }
         if (message) {
             if (config.regex) {
                 const regex = new RegExp(config.command);
 
                 if (regex.test(message)) {
-                    
                     var msg = {
                         payload: {
                             update
                         }
                     };
-
-                    
                     node.send(msg);
+                    if (debug) {
+                        node.log('command output: ' + JSON.stringify(msg));
+                    }
                 }
             } else if (message === config.command) {
-                
                 var msg = {
                     payload: {
                         update
                     }
                 };
-
-                
                 node.send(msg);
+                if (debug) {
+                    node.log('command output: ' + JSON.stringify(msg));
+                }
             }
         }
-      }, new NewMessage());
-      
+    };
+
+    try {
+      client.addEventHandler(handler, event);
     } catch (err) {
       node.error('Authorization error: ' + err.message);
     }
 
+    this.on('close', () => {
+      try {
+        client.removeEventHandler(handler, event);
+      } catch (err) {
+        node.error('Handler removal error: ' + err.message);
+      }
+    });
+
   }
 
   RED.nodes.registerType('command', Command);

package/nodes/config.html

@@ -6,6 +6,7 @@
           api_id: {value:"", required:true},
           api_hash: {value:"", required:true},
           session: {value:"", required:true},
+          debug: {value:false},
           useIPV6: {value: undefined},
           timeout: {value: undefined},
           requestRetries: {value: undefined},
@@ -52,6 +53,10 @@
       <label for="node-config-input-session"><i class="icon-tasks"></i> Session</label>
       <input type="text" id="node-config-input-session" placeholder="Enter Session" style="width:70%" ng-model="node.session">
   </div>
+  <div class="form-row">
+      <label for="node-config-input-debug"><i class="icon-bug"></i> Debug</label>
+      <input type="checkbox" id="node-config-input-debug" ng-model="node.debug">
+  </div>
   <div class="form-row">
       <label for="node-config-input-useIPV6"><i class="icon-tasks"></i> Use IPV6</label>
       <input type="checkbox" id="node-config-input-useIPV6" ng-model="node.useIPV6">

package/nodes/config.js

@@ -6,6 +6,7 @@ const activeClients = new Map(); // Cache: session string → { client, refCount
 module.exports = function (RED) {
     function TelegramClientConfig(config) {
         RED.nodes.createNode(this, config);
+        this.debugEnabled = config.debug;
 
         const sessionStr = config.session;
         const apiId = parseInt(config.api_id);
@@ -21,6 +22,9 @@ module.exports = function (RED) {
             const record = activeClients.get(sessionStr);
             this.client = record.client;
             record.refCount += 1;
+            if (this.debugEnabled) {
+                node.log('config: reusing existing client');
+            }
             if (record.connecting) {
                 node.status({ fill: "yellow", shape: "dot", text: "Waiting for connection" });
                 record.connecting.then(() => {
@@ -31,6 +35,9 @@ module.exports = function (RED) {
             }
         } else {
             // Create and connect new client
+            if (this.debugEnabled) {
+                node.log('config: creating new client');
+            }
             this.client = new TelegramClient(this.session, apiId, apiHash, {
                 connectionRetries: config.connectionRetries || 5,
                 autoReconnect: config.autoReconnect !== false,
@@ -49,6 +56,9 @@ module.exports = function (RED) {
                 })
                 .then(() => {
                     node.status({ fill: "green", shape: "dot", text: "Connected" });
+                    if (this.debugEnabled) {
+                        node.log('config: connected');
+                    }
                     record.connecting = null;
                 })
                 .catch(err => {
@@ -65,6 +75,9 @@ module.exports = function (RED) {
             if (record && record.client === this.client) {
                 record.refCount -= 1;
                 if (record.refCount <= 0) {
+                    if (this.debugEnabled) {
+                        node.log('config: disconnecting client');
+                    }
                     try {
                         await this.client.disconnect();
                     } catch (err) {

package/nodes/delete-message.html

@@ -7,6 +7,7 @@
         defaults: {
             name: { value: '' },
             config: { type: 'config', required: false },
+            debug: { value: false },
         },
         inputs: 1,
         outputs: 1,
@@ -40,11 +41,18 @@
         style="width: 60%"
       />
     </div>
+    <div class="form-row">
+      <label for="node-input-debug">
+        <i class="fa fa-bug"></i> Debug
+      </label>
+      <input type="checkbox" id="node-input-debug">
+    </div>
   </script>
 
 
-  <script type="text/html" data-help-name="delete-message">
+<script type="text/html" data-help-name="delete-message">
     <p>The <b>delete-message</b> node allows you to delete messages from a Telegram chat. It supports deleting multiple messages at once and provides an option to revoke messages for all chat participants.</p>
+    <p>Enable <b>Debug</b> to log the input and output.</p>
 
     <h3>Inputs</h3>
     <dl class="message-properties">

package/nodes/delete-message.js

@@ -2,9 +2,14 @@ module.exports = function (RED) {
     function DeleteMessage(config) {
         RED.nodes.createNode(this, config);
         this.config = RED.nodes.getNode(config.config);
+        this.debugEnabled = config.debug;
         var node = this;
 
         this.on('input', async function (msg) {
+            const debug = node.debugEnabled || msg.debug;
+            if (debug) {
+                node.log('delete-message input: ' + JSON.stringify(msg));
+            }
             const chatId = msg.payload.chatId || config.chatId;
             const messageIds = msg.payload.messageIds || config.messageIds;
             const revoke = msg.payload.revoke || config.revoke || { revoke: true };
@@ -14,9 +19,11 @@ module.exports = function (RED) {
             try {
                 const response = await client.deleteMessages(chatId, messageIds, revoke);
 
-                node.send({
-                    payload: response,
-                });
+                const out = { payload: response };
+                node.send(out);
+                if (debug) {
+                    node.log('delete-message output: ' + JSON.stringify(out));
+                }
             } catch (err) {
                 node.error('Error deleting message: ' + err.message);
             }

package/nodes/get-entity.html

@@ -7,6 +7,7 @@
         defaults: {
             name: { value: '' },
             config: { type: 'config', required: false },
+            debug: { value: false },
         },
         inputs: 1,
         outputs: 1,
@@ -40,10 +41,17 @@
             style="width: 60%"
         />
     </div>
+    <div class="form-row">
+        <label for="node-input-debug">
+            <i class="fa fa-bug"></i> Debug
+        </label>
+        <input type="checkbox" id="node-input-debug" />
+    </div>
 </script>
 
 <script type="text/html" data-help-name="get-entity">
     <p>The <b>get-entity</b> node retrieves information about a Telegram entity (e.g., user, chat, or channel) using its identifier or URL.</p>
+    <p>Enable <b>Debug</b> to print incoming and outgoing messages to the log.</p>
 
     <h3>Inputs</h3>
     <dl class="message-properties">

package/nodes/get-entity.js

@@ -2,9 +2,14 @@ module.exports = function (RED) {
     function GetEntity(config) {
         RED.nodes.createNode(this, config);
         this.config = RED.nodes.getNode(config.config);
+        this.debugEnabled = config.debug;
         var node = this;
 
         this.on('input', async function (msg) {
+            const debug = node.debugEnabled || msg.debug;
+            if (debug) {
+                node.log('get-entity input: ' + JSON.stringify(msg));
+            }
             const input = msg.payload.input || config.input;
               /** @type {TelegramClient} */
             const client = msg.payload?.client ? msg.payload.client : this.config.client;
@@ -20,14 +25,18 @@ module.exports = function (RED) {
                     entity = await client.getEntity(input);
                 }
 
-                node.send({
-                    payload: {input:entity},
-                });
+                const out = { payload: { input: entity } };
+                node.send(out);
+                if (debug) {
+                    node.log('get-entity output: ' + JSON.stringify(out));
+                }
             } catch (err) {
                 node.error('Error getting entity: ' + err.message);
-                node.send({
-                    payload:{ input: null}
-                })
+                const out = { payload: { input: null } };
+                node.send(out);
+                if (debug) {
+                    node.log('get-entity output: ' + JSON.stringify(out));
+                }
             }
         });
     }

package/nodes/iter-dialogs.html

@@ -7,6 +7,7 @@
         defaults: {
             name: { value: '' },
             config: { type: 'config', required: true },
+            debug: { value: false },
             limit: { value: "" },
             offsetDate: { value: ""},
             offsetId: { value: "" },
@@ -49,6 +50,12 @@
             ng-model="config"
         />
     </div>
+    <div class="form-row">
+        <label for="node-input-debug">
+            <i class="fa fa-bug"></i> Debug
+        </label>
+        <input type="checkbox" id="node-input-debug" ng-model="debug" />
+    </div>
     <div class="form-row">
         <label for="node-input-limit">
             <i class="fa fa-tag"></i> Limit
@@ -131,6 +138,7 @@
 
 <script type="text/html" data-help-name="iter-dialogs">
     <p>The <b>iter-dialogs</b> node retrieves a list of Telegram dialogs (chats, channels, or groups) by iterating through them using the Telegram API.</p>
+    <p>Enable <b>Debug</b> to log the request and resulting dialogs.</p>
 
     <h3>Inputs</h3>
     <dl class="message-properties">

package/nodes/iter-dialogs.js

@@ -4,9 +4,14 @@ module.exports = function (RED) {
     function IterDialogs(config) {
         RED.nodes.createNode(this, config);
         this.config = RED.nodes.getNode(config.config);
+        this.debugEnabled = config.debug;
         var node = this;
 
         this.on('input', async function (msg) {
+            const debug = node.debugEnabled || msg.debug;
+            if (debug) {
+                node.log('iter-dialogs input: ' + JSON.stringify(msg));
+            }
     
             /** @type {TelegramClient} */
             const client = msg.payload?.client ? msg.payload.client : this.config.client;
@@ -40,9 +45,11 @@ module.exports = function (RED) {
                     dialogs[dialog.id] = dialog;
                     console.log(`${dialog.id}: ${dialog.title}`);
                 }
-                node.send({
-                    payload: { dialogs },
-                });
+                const out = { payload: { dialogs } };
+                node.send(out);
+                if (debug) {
+                    node.log('iter-dialogs output: ' + JSON.stringify(out));
+                }
             } catch (err) {
                 node.error('Error iter dialogs: ' + err.message);
             }

package/nodes/iter-messages.html

@@ -7,6 +7,7 @@
         defaults: {
             name: { value: '' },
             config: { type: 'config', required: true },
+            debug: { value: false },
             chatId: { value: '', required: false },
             limit: { value: '', required: false },
             offsetDate: { value: '', required: false },
@@ -68,6 +69,12 @@
             ng-model="config"
         />
     </div>
+    <div class="form-row">
+        <label for="node-input-debug">
+            <i class="fa fa-bug"></i> Debug
+        </label>
+        <input type="checkbox" id="node-input-debug" ng-model="debug" />
+    </div>
     <div class="form-row">
         <label for="node-input-chatId">
             <i class="fa fa-tag"></i> Chat ID
@@ -259,6 +266,7 @@
 
 <script type="text/html" data-help-name="iter-messages">
     <p>The <b>iter-messages</b> node retrieves messages from a specified chat or user using the Telegram API. It supports a wide range of filtering and pagination options, allowing for efficient message iteration.</p>
+    <p>When <b>Debug</b> is enabled, incoming parameters and results are logged.</p>
 
     <h3>Inputs</h3>
     <dl class="message-properties">

package/nodes/iter-messages.js

@@ -4,9 +4,14 @@ module.exports = function (RED) {
     function IterMessages(config) {
         RED.nodes.createNode(this, config);
         this.config = RED.nodes.getNode(config.config);
+        this.debugEnabled = config.debug;
         var node = this;
 
         this.on('input', async function (msg) {
+            const debug = node.debugEnabled || msg.debug;
+            if (debug) {
+                node.log('iter-messages input: ' + JSON.stringify(msg));
+            }
     
             /** @type {TelegramClient} */
             const client = msg.payload?.client ? msg.payload.client : this.config.client;
@@ -80,9 +85,11 @@ module.exports = function (RED) {
                     }
                 }
                 
-                node.send({
-                    payload: { messages },
-                });
+                const out = { payload: { messages } };
+                node.send(out);
+                if (debug) {
+                    node.log('iter-messages output: ' + JSON.stringify(out));
+                }
             } catch (err) {
                 node.error('Error iter messages: ' + err.message);
             }

package/nodes/promote-admin.html

@@ -7,6 +7,7 @@
         defaults: {
             name: { value: '' },
             config: { type: 'config', required: false },
+            debug: { value: false },
             chatId: { value: '' },
             userId: { value: '' },
             rank: { value: 'admin' },
@@ -43,6 +44,10 @@
         <label for="node-input-config"><i class="fa fa-gear"></i> Config</label>
         <input type="hidden" id="node-input-config">
     </div>
+    <div class="form-row">
+        <label for="node-input-debug"><i class="fa fa-bug"></i> Debug</label>
+        <input type="checkbox" id="node-input-debug">
+    </div>
 
     <div class="form-row">
         <label for="node-input-chatId"><i class="fa fa-users"></i> Chat ID</label>
@@ -193,6 +198,7 @@
 </script>
 <script type="text/html" data-help-name="promote-admin">
     <p><b>Promote Admin</b> lets you promote a user to admin in a Telegram group or channel using the Telegram MTProto API (via GramJS).</p>
+    <p>With <b>Debug</b> enabled the node logs its request and the response from Telegram.</p>
 
     <h3>Inputs</h3>
     <dl class="message-properties">

package/nodes/promote-admin.js

@@ -6,9 +6,14 @@ module.exports = function (RED) {
     function PromoteAdmin(config) {
         RED.nodes.createNode(this, config);
         this.config = RED.nodes.getNode(config.config);
+        this.debugEnabled = config.debug;
         var node = this;
 
         this.on('input', async function (msg) {
+            const debug = node.debugEnabled || msg.debug;
+            if (debug) {
+                node.log('promote-admin input: ' + JSON.stringify(msg));
+            }
             const client = msg.payload?.client || this.config.client;
             const chatId = msg.payload.chatId || config.chatId;
             const userId = msg.payload.userId || config.userId;
@@ -39,7 +44,11 @@ module.exports = function (RED) {
                     rank: rank,
                 }));
 
-                node.send({ payload: { response: result } });
+                const out = { payload: { response: result } };
+                node.send(out);
+                if (debug) {
+                    node.log('promote-admin output: ' + JSON.stringify(out));
+                }
             } catch (err) {
                 node.error("Error promoting admin: " + err.message);
             }

package/nodes/receiver.html

@@ -6,7 +6,8 @@
         defaults: {
             name: { value: '' },
             config: { type: 'config', required: false },
-            ignore: { value:""}
+            ignore: { value:""},
+            debug: { value: false }
         },
         inputs: 1,
         outputs: 1,
@@ -40,6 +41,12 @@
         style="width: 60%"
       />
     </div>
+    <div class="form-row">
+      <label for="node-input-debug">
+        <i class="fa fa-bug"></i> Debug
+      </label>
+      <input type="checkbox" id="node-input-debug">
+    </div>
     <div class="form-row">
       <label for="node-input-ignore">
         <i class="fa fa-tag"></i> Config
@@ -53,8 +60,9 @@
     </div>
   </script>
 
-  <script type="text/html" data-help-name="receiver">
+<script type="text/html" data-help-name="receiver">
     <p>The <b>receiver</b> node listens for incoming Telegram messages and forwards them as output messages in Node-RED. It supports filtering messages based on sender IDs to ignore specific users.</p>
+    <p>Turn on <b>Debug</b> to log received updates and the emitted messages.</p>
 
     <h3>Inputs</h3>
     <p>This node does not take any direct inputs. It listens to all incoming messages from the configured Telegram client.</p>

package/nodes/receiver.js

@@ -4,28 +4,40 @@ module.exports = function (RED) {
   function Receiver(config) {
     RED.nodes.createNode(this, config);
     this.config = RED.nodes.getNode(config.config);
+    this.debugEnabled = config.debug;
     var node = this;
     const client =  this.config.client;
     const ignore = config.ignore.split(/\n/);
 
-  
-    try {
-      client.addEventHandler((update) => {
-        if(update.message.fromId != null && !ignore.includes(update.message.fromId.userId.toString())){
-          
-          node.send({
-            payload:{
-              update
+    const event = new NewMessage();
+    const handler = (update) => {
+        const debug = node.debugEnabled;
+        if (debug) {
+            node.log('receiver update: ' + JSON.stringify(update));
+        }
+        if (update.message.fromId != null && !ignore.includes(update.message.fromId.userId.toString())) {
+            const out = { payload: { update } };
+            node.send(out);
+            if (debug) {
+                node.log('receiver output: ' + JSON.stringify(out));
             }
-          } )
         }
-        
-      }, new NewMessage());
-      
+    };
+
+    try {
+      client.addEventHandler(handler, event);
     } catch (err) {
       node.error('Authorization error: ' + err.message);
     }
 
+    this.on('close', () => {
+      try {
+        client.removeEventHandler(handler, event);
+      } catch (err) {
+        node.error('Handler removal error: ' + err.message);
+      }
+    });
+
   }
 
   RED.nodes.registerType('receiver', Receiver);

package/nodes/resolve-userid.html

@@ -7,7 +7,8 @@
         defaults: {
             name: { value: '' },
             config: { type: 'config', required: false },
-            username: { value: '' }
+            username: { value: '' },
+            debug: { value: false }
         },
         inputs: 1,
         outputs: 1,
@@ -25,11 +26,17 @@
         </label>
         <input type="text" id="node-input-name" placeholder="Name" style="width: 60%" />
     </div>
+   <div class="form-row">
+       <label for="node-input-config">
+           <i class="fa fa-gear"></i> Config
+       </label>
+       <input type="text" id="node-input-config" placeholder="Config" style="width: 60%" />
+   </div>
     <div class="form-row">
-        <label for="node-input-config">
-            <i class="fa fa-gear"></i> Config
+        <label for="node-input-debug">
+            <i class="fa fa-bug"></i> Debug
         </label>
-        <input type="text" id="node-input-config" placeholder="Config" style="width: 60%" />
+        <input type="checkbox" id="node-input-debug" />
     </div>
     <div class="form-row">
         <label for="node-input-username">
@@ -41,6 +48,7 @@
 
 <script type="text/html" data-help-name="resolve-userid">
     <p>The <b>resolve-userid</b> node converts a Telegram username into a numeric user ID.</p>
+    <p>Select <b>Debug</b> to log lookups and results.</p>
     <h3>Inputs</h3>
     <dl class="message-properties">
         <dt>payload.username <span class="property-type">string</span></dt>

package/nodes/resolve-userid.js

@@ -2,9 +2,14 @@ module.exports = function(RED) {
     function ResolveUserId(config) {
         RED.nodes.createNode(this, config);
         this.config = RED.nodes.getNode(config.config);
+        this.debugEnabled = config.debug;
         var node = this;
 
         this.on('input', async function(msg) {
+            const debug = node.debugEnabled || msg.debug;
+            if (debug) {
+                node.log('resolve-userid input: ' + JSON.stringify(msg));
+            }
             const username = msg.payload?.username || config.username;
             const client = msg.payload?.client ? msg.payload.client : node.config?.client;
 
@@ -25,10 +30,18 @@ module.exports = function(RED) {
                 } else if (entity?.userId) {
                     userId = entity.userId;
                 }
-                node.send({ payload: { userId } });
+                const out = { payload: { userId } };
+                node.send(out);
+                if (debug) {
+                    node.log('resolve-userid output: ' + JSON.stringify(out));
+                }
             } catch (err) {
                 node.error('Error resolving username: ' + err.message);
-                node.send({ payload: { userId: null } });
+                const out = { payload: { userId: null } };
+                node.send(out);
+                if (debug) {
+                    node.log('resolve-userid output: ' + JSON.stringify(out));
+                }
             }
         });
     }

package/nodes/send-file.html

@@ -6,6 +6,7 @@
             name: { value: '' },
             config: { type: 'config', required: true },
             chatId: { value: '', required: true },
+            debug: { value: false },
             files: { value: '', required: true },
             caption: { value: '' },
             forceDocument: { value: false },
@@ -64,6 +65,12 @@
             ng-model="config"
         />
     </div>
+    <div class="form-row">
+        <label for="node-input-debug">
+            <i class="fa fa-bug"></i> Debug
+        </label>
+        <input type="checkbox" id="node-input-debug" ng-model="debug" />
+    </div>
     <div class="form-row">
         <label for="node-input-chatId">
             <i class="fa fa-tag"></i> Chat ID
@@ -318,6 +325,7 @@
 
 <script type="text/html" data-help-name="send-files">
     <p>The <b>send-files</b> node allows you to send files to a Telegram chat or user using the Telegram API. It supports a wide range of parameters, including file attributes, captions, buttons, and scheduling options.</p>
+    <p>When the <b>Debug</b> option is enabled the node logs incoming and outgoing messages.</p>
 
     <h3>Inputs</h3>
     <dl class="message-properties">

package/nodes/send-file.js

@@ -2,9 +2,14 @@ module.exports = function (RED) {
     function SendFile(config) {
         RED.nodes.createNode(this, config);
         this.config = RED.nodes.getNode(config.config);
+        this.debugEnabled = config.debug;
         var node = this;
 
         this.on('input', async function (msg) {
+            const debug = node.debugEnabled || msg.debug;
+            if (debug) {
+                node.log('send-files input: ' + JSON.stringify(msg));
+            }
             const chatId = msg.payload.chatId || config.chatId;
             const files = msg.payload.files || config.files.split(',').map(file => file.trim());
             const caption = msg.payload.caption || config.caption;
@@ -59,9 +64,11 @@ module.exports = function (RED) {
                 
                 // Send files
                 const response = await client.sendFile(chatId, params);
-                node.send({
-                    payload: response,
-                });
+                const out = { payload: response };
+                node.send(out);
+                if (debug) {
+                    node.log('send-files output: ' + JSON.stringify(out));
+                }
             } catch (err) {
                 node.error('Error sending files: ' + err.message);
             }

package/nodes/send-message.html

@@ -9,6 +9,7 @@
             chatId: { value: '' },
             message: { value: '' },
             config: { type: 'config', required: false },
+            debug: { value: false },
             parseMode: { value: 'md' }, // Default parse mode is Markdown
             schedule: { value: '' }, // Default schedule is empty
             replyTo: { value: '' }, // Reply to a message
@@ -100,6 +101,12 @@
       </label>
       <input type="hidden" id="node-input-config">
     </div>
+    <div class="form-row">
+      <label for="node-input-debug">
+        <i class="fa fa-bug"></i> Debug
+      </label>
+      <input type="checkbox" id="node-input-debug">
+    </div>
   
     <div class="form-row">
       <label for="node-input-chatId">
@@ -214,6 +221,7 @@
 
   <script type="text/html" data-help-name="send-message">
     <p>The <b>send-message</b> node allows sending messages via Telegram using the <code>telegram</code> library. It supports various message types, formatting options, and additional features like scheduling and silent messages.</p>
+    <p>Enable the <b>Debug</b> option to log incoming and outgoing messages to the Node-RED log.</p>
 
     <h3>Inputs</h3>
     <dl class="message-properties">

package/nodes/send-message.js

@@ -5,9 +5,14 @@ module.exports = function (RED) {
     function SendMessage(config) {
         RED.nodes.createNode(this, config);
         this.config = RED.nodes.getNode(config.config);
+        this.debugEnabled = config.debug;
         var node = this;
 
         this.on('input', async function (msg) {
+            const debug = node.debugEnabled || msg.debug;
+            if (debug) {
+                node.log('send-message input: ' + JSON.stringify(msg));
+            }
             let chatId = msg.payload.chatId || config.chatId;
             const message = msg.payload.message || config.message;
             const parseMode = msg.payload.parseMode || config.parseMode;
@@ -68,9 +73,11 @@ module.exports = function (RED) {
                     await client.sendMessage(entity, params);
                 }
 
-                node.send({
-                    payload: { response },
-                });
+                const out = { payload: { response } };
+                node.send(out);
+                if (debug) {
+                    node.log('send-message output: ' + JSON.stringify(out));
+                }
             } catch (err) {
                 node.error('Error send message: ' + err.message);
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@patricktobias86/node-red-telegram-account",
-  "version": "1.1.7",
+  "version": "1.1.9",
   "description": "Node-RED nodes to communicate with GramJS.",
   "main": "nodes/config.js",
   "keywords": [

package/test/command.test.js

@@ -0,0 +1,43 @@
+const assert = require('assert');
+const proxyquire = require('proxyquire').noPreserveCache();
+
+function load() {
+  const addCalls = [];
+  const removeCalls = [];
+  class TelegramClientStub {
+    addEventHandler(fn, event) { addCalls.push({fn, event}); }
+    removeEventHandler(fn, event) { removeCalls.push({fn, event}); }
+  }
+  class NewMessageStub {}
+
+  let NodeCtor;
+  const configNode = { client: new TelegramClientStub() };
+  const RED = {
+    nodes: {
+      createNode(node) {
+        node._events = {};
+        node.on = (e, fn) => { node._events[e] = fn; };
+      },
+      registerType(name, ctor) { NodeCtor = ctor; },
+      getNode() { return configNode; }
+    }
+  };
+
+  proxyquire('../nodes/command.js', {
+    'telegram/events': { NewMessage: NewMessageStub }
+  })(RED);
+
+  return { NodeCtor, addCalls, removeCalls };
+}
+
+describe('Command node', function() {
+  it('removes event handler on close', function() {
+    const { NodeCtor, addCalls, removeCalls } = load();
+    const node = new NodeCtor({config:'c', command:'cmd', regex:false});
+    assert.strictEqual(addCalls.length, 1);
+    node._events.close();
+    assert.strictEqual(removeCalls.length, 1);
+    assert.strictEqual(removeCalls[0].fn, addCalls[0].fn);
+    assert.strictEqual(removeCalls[0].event, addCalls[0].event);
+  });
+});

package/test/debug-option.test.js

@@ -0,0 +1,44 @@
+const assert = require('assert');
+const proxyquire = require('proxyquire').noPreserveCache();
+
+function load() {
+  const addCalls = [];
+  const logs = [];
+  class TelegramClientStub {
+    addEventHandler(fn, event) { addCalls.push({fn, event}); }
+    removeEventHandler() {}
+  }
+  class NewMessageStub {}
+
+  let NodeCtor;
+  const configNode = { client: new TelegramClientStub() };
+  const RED = {
+    nodes: {
+      createNode(node) {
+        node._events = {};
+        node.on = (e, fn) => { node._events[e] = fn; };
+        node.log = (msg) => logs.push(msg);
+        node.send = () => {};
+      },
+      registerType(name, ctor) { NodeCtor = ctor; },
+      getNode() { return configNode; }
+    }
+  };
+
+  proxyquire('../nodes/command.js', {
+    'telegram/events': { NewMessage: NewMessageStub }
+  })(RED);
+
+  return { NodeCtor, addCalls, logs };
+}
+
+describe('Debug option', function() {
+  it('logs update and output when enabled', function() {
+    const { NodeCtor, addCalls, logs } = load();
+    const node = new NodeCtor({config:'c', command:'cmd', regex:false, debug:true});
+    const handler = addCalls[0].fn;
+    handler({ message: { message:'cmd', fromId:{userId:1} } });
+    assert(logs.some(l => l.includes('command update')));
+    assert(logs.some(l => l.includes('command output')));
+  });
+});

package/test/receiver.test.js

@@ -0,0 +1,43 @@
+const assert = require('assert');
+const proxyquire = require('proxyquire').noPreserveCache();
+
+function load() {
+  const addCalls = [];
+  const removeCalls = [];
+  class TelegramClientStub {
+    addEventHandler(fn, event) { addCalls.push({fn, event}); }
+    removeEventHandler(fn, event) { removeCalls.push({fn, event}); }
+  }
+  class NewMessageStub {}
+
+  let NodeCtor;
+  const configNode = { client: new TelegramClientStub() };
+  const RED = {
+    nodes: {
+      createNode(node) {
+        node._events = {};
+        node.on = (e, fn) => { node._events[e] = fn; };
+      },
+      registerType(name, ctor) { NodeCtor = ctor; },
+      getNode() { return configNode; }
+    }
+  };
+
+  proxyquire('../nodes/receiver.js', {
+    'telegram/events': { NewMessage: NewMessageStub }
+  })(RED);
+
+  return { NodeCtor, addCalls, removeCalls };
+}
+
+describe('Receiver node', function() {
+  it('removes event handler on close', function() {
+    const { NodeCtor, addCalls, removeCalls } = load();
+    const node = new NodeCtor({config:'c', ignore:''});
+    assert.strictEqual(addCalls.length, 1);
+    node._events.close();
+    assert.strictEqual(removeCalls.length, 1);
+    assert.strictEqual(removeCalls[0].fn, addCalls[0].fn);
+    assert.strictEqual(removeCalls[0].event, addCalls[0].event);
+  });
+});