@patricktobias86/node-red-telegram-account 1.1.12 → 1.1.15

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.1.15] - 2025-09-21
+### Added
+- Receiver node option to drop updates when media exceeds a configurable size threshold, preventing large downloads.
+
 ## [1.1.7] - 2025-07-22
 ### Added
 - Mocha tests for the configuration node ensure sessions are reused correctly.
@@ -26,4 +30,3 @@ All notable changes to this project will be documented in this file.
 ## [1.1.12] - 2025-08-06
 ### Fixed
 - Auth node now emits the generated `stringSession` so it can be used by other nodes.
-

package/README.md

@@ -18,7 +18,7 @@ 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` (also set on `msg.stringSession`).
-- **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.
+- **receiver** – emits messages for every incoming update (with optional ignore list and media size limit). 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.

package/docs/NODES.md

@@ -8,7 +8,7 @@ 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` (available in both <code>msg.payload.stringSession</code> and <code>msg.stringSession</code>) that can be reused with the `config` node. |
-| **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. |
+| **receiver** | Emits an output message for every incoming Telegram message. Can ignore specific user IDs and optionally skip media above a configurable size. 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. |
@@ -22,4 +22,3 @@ Below is a short description of each node. For a full list of configuration opti
 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/receiver.html

@@ -7,7 +7,8 @@
             name: { value: '' },
             config: { type: 'config', required: false },
             ignore: { value:""},
-            debug: { value: false }
+            debug: { value: false },
+            maxFileSizeMb: { value: "" }
         },
         inputs: 1,
         outputs: 1,
@@ -49,15 +50,28 @@
     </div>
     <div class="form-row">
       <label for="node-input-ignore">
-        <i class="fa fa-tag"></i> Config
+        <i class="fa fa-user-times"></i> Ignore list
       </label>
       <textarea
         type="text"
         id="node-input-ignore"
-        placeholder="Config"
+        placeholder="Enter user IDs, one per line"
         style="width: 60%"
       ></textarea>
     </div>
+    <div class="form-row">
+      <label for="node-input-maxFileSizeMb">
+        <i class="fa fa-download"></i> Max media size (MB)
+      </label>
+      <input
+        type="number"
+        id="node-input-maxFileSizeMb"
+        placeholder="Leave blank to disable"
+        min="0"
+        step="0.1"
+        style="width: 60%"
+      />
+    </div>
   </script>
 
 <script type="text/html" data-help-name="receiver">
@@ -86,6 +100,11 @@
             <span class="property-type">string</span>
         </dt>
         <dd>A newline-separated list of user IDs to ignore. Messages from these users will not trigger the output.</dd>
+
+        <dt>Max media size (MB)
+            <span class="property-type">number</span>
+        </dt>
+        <dd>Skip updates that include media exceeding this size. Leave blank to process all media.</dd>
     </dl>
 
     <h3>Details</h3>
@@ -131,5 +150,3 @@
         <li>For advanced filtering based on message content, consider chaining this node with additional processing nodes in Node-RED.</li>
     </ul>
 </script>
-
-

package/nodes/receiver.js

@@ -8,7 +8,92 @@ module.exports = function (RED) {
     this.debugEnabled = config.debug;
     var node = this;
     const client =  this.config.client;
-    const ignore = config.ignore.split(/\n/);
+    const ignore = (config.ignore || "")
+        .split(/\n/)
+        .map((entry) => entry.trim())
+        .filter(Boolean);
+    const maxFileSizeMb = Number(config.maxFileSizeMb);
+    const maxFileSizeBytes = Number.isFinite(maxFileSizeMb) && maxFileSizeMb > 0
+        ? maxFileSizeMb * 1024 * 1024
+        : null;
+
+    const toNumber = (value) => {
+        if (typeof value === 'number') {
+            return value;
+        }
+        if (typeof value === 'bigint') {
+            const result = Number(value);
+            return Number.isFinite(result) ? result : Number.MAX_SAFE_INTEGER;
+        }
+        return undefined;
+    };
+
+    const extractPhotoSize = (photo) => {
+        if (!photo || !Array.isArray(photo.sizes)) {
+            return null;
+        }
+        let max = 0;
+        for (const size of photo.sizes) {
+            if (size == null) {
+                continue;
+            }
+            if (Array.isArray(size.sizes)) {
+                for (const nested of size.sizes) {
+                    const nestedValue = toNumber(nested);
+                    if (nestedValue != null && nestedValue > max) {
+                        max = nestedValue;
+                    }
+                }
+            }
+            const value = toNumber(size.size ?? size.length ?? size.bytes);
+            if (value != null && value > max) {
+                max = value;
+            }
+        }
+        return max > 0 ? max : null;
+    };
+
+    const extractMediaSize = (media) => {
+        if (!media) {
+            return null;
+        }
+
+        if (media.document && media.document.size != null) {
+            const value = toNumber(media.document.size);
+            if (value != null) {
+                return value;
+            }
+        }
+
+        if (media.photo) {
+            const photoSize = extractPhotoSize(media.photo);
+            if (photoSize != null) {
+                return photoSize;
+            }
+        }
+
+        if (media.webpage) {
+            const { document, photo } = media.webpage;
+            const docSize = document && toNumber(document.size);
+            if (docSize != null) {
+                return docSize;
+            }
+            const photoSize = extractPhotoSize(photo);
+            if (photoSize != null) {
+                return photoSize;
+            }
+        }
+
+        const className = media.className || media._;
+        if ((className === 'MessageMediaDocument' || className === 'MessageMediaPhoto') && media.size != null) {
+            const value = toNumber(media.size);
+            if (value != null) {
+                return value;
+            }
+        }
+
+        return null;
+    };
 
     const event = new NewMessage();
     const handler = (update) => {
@@ -16,7 +101,27 @@ module.exports = function (RED) {
         if (debug) {
             node.log('receiver update: ' + util.inspect(update, { depth: null }));
         }
-        if (update.message.fromId != null && !ignore.includes(update.message.fromId.userId.toString())) {
+        const message = update && update.message;
+        if (!message) {
+            return;
+        }
+
+        if (maxFileSizeBytes != null) {
+            const mediaSize = extractMediaSize(message.media);
+            if (mediaSize != null && mediaSize > maxFileSizeBytes) {
+                if (debug) {
+                    node.log(`receiver ignoring update with media size ${mediaSize} bytes exceeding limit ${maxFileSizeBytes}`);
+                }
+                return;
+            }
+        }
+
+        const senderId = message.fromId && message.fromId.userId;
+        if (senderId != null && ignore.includes(senderId.toString())) {
+            return;
+        }
+
+        if (message.fromId != null && message.fromId.userId != null) {
             const out = { payload: { update } };
             node.send(out);
             if (debug) {

package/package.json

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

package/test/receiver.test.js

@@ -40,4 +40,28 @@ describe('Receiver node', function() {
     assert.strictEqual(removeCalls[0].fn, addCalls[0].fn);
     assert.strictEqual(removeCalls[0].event, addCalls[0].event);
   });
+
+  it('skips media updates when size exceeds threshold', function() {
+    const { NodeCtor, addCalls } = load();
+    const sent = [];
+    const node = new NodeCtor({config:'c', ignore:'', maxFileSizeMb:'5'});
+    node.send = (msg) => sent.push(msg);
+    const handler = addCalls[0].fn;
+
+    handler({ message: { fromId: { userId: 123 }, media: { document: { size: 6 * 1024 * 1024 } } } });
+
+    assert.strictEqual(sent.length, 0);
+  });
+
+  it('delivers media updates when size is below threshold', function() {
+    const { NodeCtor, addCalls } = load();
+    const sent = [];
+    const node = new NodeCtor({config:'c', ignore:'', maxFileSizeMb:'5'});
+    node.send = (msg) => sent.push(msg);
+    const handler = addCalls[0].fn;
+
+    handler({ message: { fromId: { userId: 123 }, media: { document: { size: 3 * 1024 * 1024 } } } });
+
+    assert.strictEqual(sent.length, 1);
+  });
 });

package/AGENTS.md

@@ -1,5 +0,0 @@
-# Repository Instructions
-
-- 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