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

package/AGENTS.md

@@ -2,3 +2,4 @@
 
 - Always run `npm test` before creating a commit.
 - If a code change alters user-facing behavior, update the README and any relevant docs to reflect the change.
+- Bump version for any code change

package/CHANGELOG.md

@@ -13,3 +13,13 @@ All notable changes to this project will be documented in this file.
 ### Fixed
 - Receiver and Command nodes now remove their event listeners when closed to prevent duplicate messages after redeploys.
 
+## [1.1.10] - 2025-07-27
+### Fixed
+- Receiver node no longer fails when Debug is enabled and handles updates containing `BigInt` values.
+### Changed
+- `delete-message` now forwards the original message along with the Telegram API response.
+
+## [1.1.11] - 2025-08-04
+### Fixed
+- All nodes now preserve properties on the incoming message outside of the payload.
+

package/README.md

@@ -23,12 +23,14 @@ See [docs/NODES.md](docs/NODES.md) for a detailed description of every node. Bel
 - **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.
-- **delete-message** – deletes one or more messages, optionally revoking them.
+ - **delete-message** – deletes one or more messages, optionally revoking them, and forwards the original input message with the API response.
 - **iter-dialogs** – iterates over your dialogs (chats, groups, channels).
 - **iter-messages** – iterates over messages in a chat with filtering options.
 - **promote-admin** – promotes a user to admin with configurable rights.
 - **resolve-userid** – converts a username to a numeric user ID.
 
+All nodes preserve any properties on the incoming message outside of <code>msg.payload</code>.
+
 All nodes include a <code>Debug</code> option that logs incoming and outgoing messages to the Node-RED log when enabled.
 
 ## Session management

package/docs/NODES.md

@@ -13,12 +13,13 @@ Below is a short description of each node. For a full list of configuration opti
 | **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. |
-| **delete-message** | Deletes one or multiple messages from a chat. Can revoke messages for all participants. |
+| **delete-message** | Deletes one or multiple messages from a chat while passing the original input message along with the API response. Can revoke messages for all participants. |
 | **iter-dialogs** | Iterates through the user’s dialogs (chats, groups, channels) and outputs the collected list. |
 | **iter-messages** | Iterates over messages in a chat with various filtering and pagination options. |
 | **promote-admin** | Grants admin rights to a user in a group or channel with configurable permissions. |
 | **resolve-userid** | Converts a Telegram username to its numeric user ID. |
 
+All nodes forward any properties on the incoming `msg` outside of `msg.payload` unchanged.
 
 All nodes provide a **Debug** checkbox. When enabled the node will log its input and output messages to aid troubleshooting.
 

package/nodes/auth.js

@@ -58,27 +58,28 @@ module.exports = function (RED) {
                     ]
                 });
 
-                const out = {
-                    topic: "auth_success",
-                    payload: {
-                        stringSession,
-                        message: "Authorization successful!"
-                    }
-                };
-                node.send(out);
-                if (debug) {
-                    node.log('auth output: ' + JSON.stringify(out));
-                }
+                 const out = {
+                     ...msg,
+                     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);
-                const out = { topic: "auth_error", payload: { error: err.message } };
-                node.send(out);
-                if (debug) {
-                    node.log('auth output: ' + JSON.stringify(out));
-                }
+                 node.error("Authentication failed: " + err.message);
+                 const out = { ...msg, 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/delete-message.html

@@ -82,7 +82,7 @@
         <dt>payload
             <span class="property-type">object</span>
         </dt>
-        <dd>The response from the Telegram API, confirming the deletion.</dd>
+        <dd>The response from the Telegram API, confirming the deletion. All other properties from the input message are preserved.</dd>
     </dl>
 
     <h3>Details</h3>

package/nodes/delete-message.js

@@ -1,3 +1,5 @@
+const util = require("util");
+
 module.exports = function (RED) {
     function DeleteMessage(config) {
         RED.nodes.createNode(this, config);
@@ -8,21 +10,21 @@ module.exports = function (RED) {
         this.on('input', async function (msg) {
             const debug = node.debugEnabled || msg.debug;
             if (debug) {
-                node.log('delete-message input: ' + JSON.stringify(msg));
+                node.log('delete-message input: ' + util.inspect(msg, { depth: null }));
             }
             const chatId = msg.payload.chatId || config.chatId;
             const messageIds = msg.payload.messageIds || config.messageIds;
-            const revoke = msg.payload.revoke || config.revoke || { revoke: true };
+            const revoke = msg.payload.revoke ?? config.revoke ?? true;
               /** @type {TelegramClient} */
             const client = msg.payload?.client ? msg.payload.client : this.config.client;
 
             try {
-                const response = await client.deleteMessages(chatId, messageIds, revoke);
+                const response = await client.deleteMessages(chatId, messageIds, { revoke });
 
-                const out = { payload: response };
+                const out = { ...msg, payload: response };
                 node.send(out);
                 if (debug) {
-                    node.log('delete-message output: ' + JSON.stringify(out));
+                    node.log('delete-message output: ' + util.inspect(out, { depth: null }));
                 }
             } catch (err) {
                 node.error('Error deleting message: ' + err.message);

package/nodes/get-entity.js

@@ -25,14 +25,14 @@ module.exports = function (RED) {
                     entity = await client.getEntity(input);
                 }
 
-                const out = { payload: { input: entity } };
+                const out = { ...msg, 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);
-                const out = { payload: { input: null } };
+                const out = { ...msg, payload: { input: null } };
                 node.send(out);
                 if (debug) {
                     node.log('get-entity output: ' + JSON.stringify(out));

package/nodes/iter-dialogs.js

@@ -45,7 +45,7 @@ module.exports = function (RED) {
                     dialogs[dialog.id] = dialog;
                     console.log(`${dialog.id}: ${dialog.title}`);
                 }
-                const out = { payload: { dialogs } };
+                const out = { ...msg, payload: { dialogs } };
                 node.send(out);
                 if (debug) {
                     node.log('iter-dialogs output: ' + JSON.stringify(out));

package/nodes/iter-messages.js

@@ -84,8 +84,8 @@ module.exports = function (RED) {
                         console.log(message.id, message.text);
                     }
                 }
-                
-                const out = { payload: { messages } };
+
+                const out = { ...msg, payload: { messages } };
                 node.send(out);
                 if (debug) {
                     node.log('iter-messages output: ' + JSON.stringify(out));

package/nodes/promote-admin.js

@@ -44,7 +44,7 @@ module.exports = function (RED) {
                     rank: rank,
                 }));
 
-                const out = { payload: { response: result } };
+                const out = { ...msg, payload: { response: result } };
                 node.send(out);
                 if (debug) {
                     node.log('promote-admin output: ' + JSON.stringify(out));

package/nodes/receiver.js

@@ -1,4 +1,5 @@
 const { NewMessage } = require("telegram/events");
+const util = require("util");
 
 module.exports = function (RED) {
   function Receiver(config) {
@@ -13,13 +14,13 @@ module.exports = function (RED) {
     const handler = (update) => {
         const debug = node.debugEnabled;
         if (debug) {
-            node.log('receiver update: ' + JSON.stringify(update));
+            node.log('receiver update: ' + util.inspect(update, { depth: null }));
         }
         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));
+                node.log('receiver output: ' + util.inspect(out, { depth: null }));
             }
         }
     };

package/nodes/resolve-userid.js

@@ -30,14 +30,14 @@ module.exports = function(RED) {
                 } else if (entity?.userId) {
                     userId = entity.userId;
                 }
-                const out = { payload: { userId } };
+                const out = { ...msg, payload: { userId } };
                 node.send(out);
                 if (debug) {
                     node.log('resolve-userid output: ' + JSON.stringify(out));
                 }
             } catch (err) {
                 node.error('Error resolving username: ' + err.message);
-                const out = { payload: { userId: null } };
+                const out = { ...msg, payload: { userId: null } };
                 node.send(out);
                 if (debug) {
                     node.log('resolve-userid output: ' + JSON.stringify(out));

package/nodes/send-file.js

@@ -64,7 +64,7 @@ module.exports = function (RED) {
                 
                 // Send files
                 const response = await client.sendFile(chatId, params);
-                const out = { payload: response };
+                const out = { ...msg, payload: response };
                 node.send(out);
                 if (debug) {
                     node.log('send-files output: ' + JSON.stringify(out));

package/nodes/send-message.js

@@ -73,7 +73,7 @@ module.exports = function (RED) {
                     await client.sendMessage(entity, params);
                 }
 
-                const out = { payload: { response } };
+                const out = { ...msg, payload: { response } };
                 node.send(out);
                 if (debug) {
                     node.log('send-message output: ' + JSON.stringify(out));

package/package.json

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

package/test/pass-through.test.js

@@ -0,0 +1,41 @@
+const assert = require('assert');
+const proxyquire = require('proxyquire').noPreserveCache();
+
+function setup() {
+  let NodeCtor;
+  let sent;
+  const configNode = { client: {} };
+  const RED = {
+    nodes: {
+      createNode(node) {
+        node._events = {};
+        node.on = (e, fn) => { node._events[e] = fn; };
+        node.send = (msg) => { sent = msg; };
+        node.log = () => {};
+        node.error = () => {};
+      },
+      registerType(name, ctor) { NodeCtor = ctor; },
+      getNode() { return configNode; }
+    }
+  };
+
+  proxyquire('../nodes/send-message.js', {
+    telegram: { TelegramClient: function() {} },
+    'telegram/Utils': { parseID: () => ({}) }
+  })(RED);
+
+  return { NodeCtor, getSent: () => sent };
+}
+
+describe('message property relay', function() {
+  it('keeps non-payload properties on send-message output', async function() {
+    const { NodeCtor, getSent } = setup();
+    const node = new NodeCtor({ config: 'c', file: "" });
+    const client = { sendMessage: async () => 'ok' };
+    const msg = { foo: 'bar', payload: { client, chatId: 'me', message: 'hi' } };
+    await node._events['input'](msg);
+    const out = getSent();
+    assert.strictEqual(out.foo, 'bar');
+    assert.deepStrictEqual(out.payload.response, 'ok');
+  });
+});

package/test/receiver-debug.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/receiver.js', {
+    'telegram/events': { NewMessage: NewMessageStub }
+  })(RED);
+
+  return { NodeCtor, addCalls, logs };
+}
+
+describe('Receiver node debug with BigInt', function() {
+  it('logs update and output without throwing', function() {
+    const { NodeCtor, addCalls, logs } = load();
+    const node = new NodeCtor({config:'c', ignore:'', debug:true});
+    const handler = addCalls[0].fn;
+    assert.doesNotThrow(() => handler({ message: { fromId:{userId:1n} } }));
+    assert(logs.some(l => l.includes('receiver update')));
+    assert(logs.some(l => l.includes('receiver output')));
+  });
+});