@patricktobias86/node-red-telegram-account 1.0.6

package/nodes/iter-messages.html

@@ -0,0 +1,365 @@
+<script type="text/javascript">
+    RED.nodes.registerType('iter-messages', {
+        category: 'telegram',
+        color: '#32a3e0',
+        defaults: {
+            name: { value: '' },
+            config: { type: 'config', required: true },
+            chatId: { value: '', required: false },
+            limit: { value: '', required: false },
+            offsetDate: { value: '', required: false },
+            offsetId: { value: '', required: false },
+            maxId: { value: '', required: false },
+            minId: { value: '', required: false },
+            addOffset: { value: '', required: false },
+            search: { value: '', required: false },
+            filter: { value: '', required: false },
+            fromUser: { value: '', required: false },
+            waitTime: { value: '', required: false },
+            messageIds: { value: '', required: false },
+            reverse: { value: '', required: false },
+            replyTo: { value: '', required: false },
+            scheduled: { value: '', required: false }
+        },
+        inputs: 1,
+        outputs: 1,
+        paletteLabel: 'Iterate Messages',
+        label: function () {
+            return this.name || 'Iterate Messages';
+        },
+        oneditprepare: function(){
+            const node = this;
+            $("#node-input-messageIds").val((node.messageIds || []).join(","))
+        },
+        oneditsave:function(){
+            const node = this;
+            const messageIds =  $("#node-input-messageIds").val();
+            if(messageIds){
+                node.messageIds = messageIds.split(",").map(id => parseInt(id))
+            }
+        },
+    });
+</script>
+
+<script type="text/html" data-template-name="iter-messages">
+    <div class="form-row">
+        <label for="node-input-name">
+            <i class="fa fa-tag"></i> Name
+        </label>
+        <input
+            type="text"
+            id="node-input-name"
+            placeholder="Name"
+            style="width: 60%"
+            ng-model="name"
+        />
+    </div>
+    <div class="form-row">
+        <label for="node-input-config">
+            <i class="fa fa-tag"></i> Config
+        </label>
+        <input
+            type="text"
+            id="node-input-config"
+            placeholder="Config"
+            style="width: 60%"
+            ng-model="config"
+        />
+    </div>
+    <div class="form-row">
+        <label for="node-input-chatId">
+            <i class="fa fa-tag"></i> Chat ID
+        </label>
+        <input
+            type="text"
+            id="node-input-chatId"
+            placeholder="Chat ID"
+            style="width: 60%"
+            ng-model="chatId"
+        />
+    </div>
+    <div class="form-row">
+        <label for="node-input-limit">
+            <i class="fa fa-tag"></i> Limit
+        </label>
+        <input
+            type="number"
+            id="node-input-limit"
+            placeholder="Limit"
+            style="width: 60%"
+            ng-model="limit"
+        />
+    </div>
+    <div class="form-row">
+        <label for="node-input-offsetDate">
+            <i class="fa fa-tag"></i> Offset Date
+        </label>
+        <input
+            type="datetime-local"
+            id="node-input-offsetDate"
+            placeholder="Offset Date"
+            style="width: 60%"
+            ng-model="offsetDate"
+        />
+    </div>
+    <div class="form-row">
+        <label for="node-input-offsetId">
+            <i class="fa fa-tag"></i> Offset ID
+        </label>
+        <input
+            type="number"
+            id="node-input-offsetId"
+            placeholder="Offset ID"
+            style="width: 60%"
+            ng-model="offsetId"
+        />
+    </div>
+    <div class="form-row">
+        <label for="node-input-maxId">
+            <i class="fa fa-tag"></i> Max ID
+        </label>
+        <input
+            type="number"
+            id="node-input-maxId"
+            placeholder="Max ID"
+            style="width: 60%"
+            ng-model="maxId"
+        />
+    </div>
+    <div class="form-row">
+        <label for="node-input-minId">
+            <i class="fa fa-tag"></i> Min ID
+        </label>
+        <input
+            type="number"
+            id="node-input-minId"
+            placeholder="Min ID"
+            style="width: 60%"
+            ng-model="minId"
+        />
+    </div>
+    <div class="form-row">
+        <label for="node-input-addOffset">
+            <i class="fa fa-tag"></i> Add Offset
+        </label>
+        <input
+            type="number"
+            id="node-input-addOffset"
+            placeholder="Add Offset"
+            style="width: 60%"
+            ng-model="addOffset"
+        />
+    </div>
+    <div class="form-row">
+        <label for="node-input-search">
+            <i class="fa fa-tag"></i> Search
+        </label>
+        <input
+            type="text"
+            id="node-input-search"
+            placeholder="Search"
+            style="width: 60%"
+            ng-model="search"
+        />
+    </div>
+    <div class="form-row">
+        <label for="node-input-filter">
+            <i class="fa fa-tag"></i> Filter
+        </label>
+        <input type="checkbox" name="filter" value="InputMessagesFilterEmpty">Empty<br>
+        <input type="checkbox" name="filter" value="InputMessagesFilterPhotos">Photos<br>
+        <input type="checkbox" name="filter" value="InputMessagesFilterVideo">Video<br>
+        <input type="checkbox" name="filter" value="InputMessagesFilterPhotoVideo">Photo and Video<br>
+        <input type="checkbox" name="filter" value="InputMessagesFilterDocument">Document<br>
+        <input type="checkbox" name="filter" value="InputMessagesFilterUrl">URL<br>
+        <input type="checkbox" name="filter" value="InputMessagesFilterGif">GIF<br>
+        <input type="checkbox" name="filter" value="InputMessagesFilterVoice">Voice<br>
+        <input type="checkbox" name="filter" value="InputMessagesFilterMusic">Music<br>
+        <input type="checkbox" name="filter" value="InputMessagesFilterChatPhotos">Chat Photos<br>
+        <input type="checkbox" name="filter" value="InputMessagesFilterPhoneCalls">Phone Calls<br>
+        <input type="checkbox" name="filter" value="InputMessagesFilterRoundVoice">Round Voice<br>
+        <input type="checkbox" name="filter" value="InputMessagesFilterRoundVideo">Round Video<br>
+        <input type="checkbox" name="filter" value="InputMessagesFilterMyMentions">My Mentions<br>
+        <input type="checkbox" name="filter" value="InputMessagesFilterGeo">Geo<br>
+        <input type="checkbox" name="filter" value="InputMessagesFilterContacts">Contacts<br>
+        <input type="checkbox" name="filter" value="InputMessagesFilterPinned">Pinned<br>
+
+    </div>
+    <div class="form-row">
+        <label for="node-input-fromUser">
+            <i class="fa fa-tag"></i> From User
+        </label>
+        <input
+            type="text"
+            id="node-input-fromUser"
+            placeholder="From User"
+            style="width: 60%"
+            ng-model="fromUser"
+        />
+    </div>
+    <div class="form-row">
+        <label for="node-input-waitTime">
+            <i class="fa fa-tag"></i> Wait Time
+        </label>
+        <input
+            type="number"
+            id="node-input-waitTime"
+            placeholder="Wait Time"
+            style="width: 60%"
+            ng-model="waitTime"
+        />
+    </div>
+    <div class="form-row">
+        <label for="node-input-messageIds">
+            <i class="fa fa-tag"></i> Message IDs
+        </label>
+        <input
+            type="text"
+            id="node-input-messageIds"
+            placeholder="123,1245"
+            style="width: 60%"
+            ng-model="messageIds"
+        />
+    </div>
+    <div class="form-row">
+        <label for="node-input-reverse">
+            <i class="fa fa-tag"></i> Reverse
+        </label>
+        <input
+            type="checkbox"
+            id="node-input-reverse"
+            ng-model="reverse"
+        />
+    </div>
+    <div class="form-row">
+        <label for="node-input-replyTo">
+            <i class="fa fa-tag"></i> Reply To
+        </label>
+        <input
+            type="number"
+            id="node-input-replyTo"
+            placeholder="Reply To"
+            style="width: 60%"
+            ng-model="replyTo"
+        />
+    </div>
+    <div class="form-row">
+        <label for="node-input-scheduled">
+            <i class="fa fa-tag"></i> Scheduled
+        </label>
+        <input
+            type="checkbox"
+            id="node-input-scheduled"
+            ng-model="scheduled"
+        />
+    </div>
+</script>
+
+<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>
+
+    <h3>Inputs</h3>
+    <dl class="message-properties">
+        <dt>payload.client
+            <span class="property-type">object</span>
+        </dt>
+        <dd>An optional Telegram client instance if not configured globally.</dd>
+
+        <dt>payload.chatId
+            <span class="property-type">string</span>
+        </dt>
+        <dd>The ID or username of the chat or user to retrieve messages from. Use "me" for personal messages.</dd>
+
+        <dt>payload.limit
+            <span class="property-type">number</span>
+        </dt>
+        <dd>Maximum number of messages to retrieve.</dd>
+
+        <dt>payload.offsetDate
+            <span class="property-type">string | number</span>
+        </dt>
+        <dd>Fetch messages starting from this date. Accepts a UNIX timestamp or a date string.</dd>
+
+        <dt>payload.offsetId
+            <span class="property-type">number</span>
+        </dt>
+        <dd>Fetch messages starting from this message ID.</dd>
+
+        <dt>payload.maxId
+            <span class="property-type">number</span>
+        </dt>
+        <dd>Fetch messages with IDs less than or equal to this value.</dd>
+
+        <dt>payload.minId
+            <span class="property-type">number</span>
+        </dt>
+        <dd>Fetch messages with IDs greater than or equal to this value.</dd>
+
+        <dt>payload.addOffset
+            <span class="property-type">number</span>
+        </dt>
+        <dd>An additional offset to apply when retrieving messages.</dd>
+
+        <dt>payload.search
+            <span class="property-type">string</span>
+        </dt>
+        <dd>Filters messages containing the specified search term.</dd>
+
+        <dt>payload.filter
+            <span class="property-type">object</span>
+        </dt>
+        <dd>Applies a specific message filter (e.g., photos, videos, documents).</dd>
+
+        <dt>payload.filters
+            <span class="property-type">array</span>
+        </dt>
+        <dd>Applies multiple message filters using Telegram API filter classes (e.g., <code>Api.InputMessagesFilterPhotos</code>).</dd>
+
+        <dt>payload.reverse
+            <span class="property-type">boolean</span>
+        </dt>
+        <dd>Retrieves messages in reverse order if set to <code>true</code>. Default is <code>false</code>.</dd>
+
+        <dt>payload.replyTo
+            <span class="property-type">number</span>
+        </dt>
+        <dd>Fetches messages replying to the specified message ID.</dd>
+
+        <dt>payload.scheduled
+            <span class="property-type">boolean</span>
+        </dt>
+        <dd>Includes scheduled messages if set to <code>true</code>.</dd>
+    </dl>
+
+    <h3>Outputs</h3>
+    <dl class="message-properties">
+        <dt>payload.messages
+            <span class="property-type">object</span>
+        </dt>
+        <dd>An object containing messages, where keys are message IDs and values are message details.</dd>
+    </dl>
+
+    <h3>Details</h3>
+    <p>The <b>iter-messages</b> node provides a flexible way to retrieve messages from a Telegram chat or user. It allows advanced configurations such as filtering messages by type, searching for specific terms, and paginating results using offsets and IDs.</p>
+    
+    <p>The node also handles cases where a chat username needs to be resolved into an entity or peer ID. It supports using multiple filters in conjunction, enabling precise control over the messages to process.</p>
+
+    <h3>Example</h3>
+    <pre>
+    {
+        "payload": {
+            "chatId": "@examplechannel",
+            "limit": 50,
+            "search": "announcement",
+            "filters": ["InputMessagesFilterPhotos"]
+        }
+    }
+    </pre>
+    <p>This input retrieves up to 50 messages containing the term "announcement" and filters them to include only photos from the specified channel.</p>
+
+    <h3>Error Handling</h3>
+    <p>If an error occurs during message retrieval (e.g., invalid chat ID or API errors), the node logs an error message and does not return a payload.</p>
+
+    <h3>Configuration</h3>
+    <p>The node can use a globally configured Telegram client or a client instance provided in the message payload. Ensure the client has access to the specified chat or user.</p>
+</script>

package/nodes/iter-messages.js

@@ -0,0 +1,94 @@
+const { TelegramClient, utils, Api } = require("telegram");
+
+module.exports = function (RED) {
+    function IterMessages(config) {
+        RED.nodes.createNode(this, config);
+        this.config = RED.nodes.getNode(config.config);
+        var node = this;
+
+        this.on('input', async function (msg) {
+    
+            /** @type {TelegramClient} */
+            const client = msg.payload?.client ? msg.payload.client : this.config.client;
+            const chatId = msg.payload?.chatId ? msg.payload.chatId : config.chatId;
+            let peerId = chatId === "me" ? chatId : utils.parseID(chatId);
+
+            // Получаем параметры из входного сообщения или из конфигурации узла
+            const limit = msg.payload?.limit || config.limit;
+            const offsetDate = msg.payload?.offsetDate || config.offsetDate;
+            const offsetId = msg.payload?.offsetId || config.offsetId;
+            const maxId = msg.payload?.maxId || config.maxId;
+            const minId = msg.payload?.minId || config.minId;
+            const addOffset = msg.payload?.addOffset || config.addOffset;
+            const search = msg.payload?.search || config.search;
+            const filter = msg.payload?.filter || config.filter;
+            const fromUser = msg.payload?.fromUser || config.fromUser;
+            const waitTime = msg.payload?.waitTime || config.waitTime;
+            const messageIds = msg.payload?.messageIds || config.messageIds;
+            const reverse = msg.payload?.reverse || config.reverse;
+            const replyTo = msg.payload?.replyTo || config.replyTo;
+            const scheduled = msg.payload?.scheduled || config.scheduled;
+
+            try {
+                
+                const params = {
+                    limit: limit !== ""? parseInt(limit) : undefined,
+                    offsetDate: offsetDate !== "" ? offsetDate:undefined,
+                    offsetId: offsetId !== "" ? parseInt(offsetId):undefined,
+                    maxId: maxId,
+                    minId: minId,
+                    addOffset: addOffset,
+                    search: search !== "" ? search : undefined,
+                    filter: filter,
+                    // fromUser: fromUser,
+                    waitTime: waitTime,
+                    ids: messageIds,
+                    reverse: reverse,
+                    replyTo: replyTo,
+                    scheduled: scheduled,
+                };
+
+                if (offsetDate) {
+                    params.offsetDate = new Date(offsetDate).getTime() / 1000;
+                }
+
+                if (chatId[0] === "@") { 
+                    peerId = await client.getEntity(chatId);
+                }
+                const messages = {};
+
+                const filters = msg.payload?.filters || config.filters || [];
+
+                  // Обработка выбранных фильтров
+                  if (filters.length > 0) {
+                    params.filter = [];
+                    filters.forEach((filter) => {
+                        params.filter.push( Api[filter]);
+                    });
+                }
+
+                try {
+                    for await (const message of client.iterMessages(peerId, params)){
+                        messages[message.id] = message;
+                        console.log(message.id, message.text);
+                    }
+                } catch (error) {
+                    const entity = await client.getInputEntity(peerId)
+                    for await (const message of client.iterMessages(entity, params)){
+                        messages[message.id] = message;
+                        console.log(message.id, message.text);
+                    }
+                }
+                
+                node.send({
+                    payload: { messages },
+                });
+            } catch (err) {
+                node.error('Error iter messages: ' + err.message);
+            }
+
+        });
+    }
+
+    RED.nodes.registerType('iter-messages', IterMessages);
+};

package/nodes/promote-admin.html

@@ -0,0 +1,24 @@
+<script type="text/javascript">
+    RED.nodes.registerType('promote-admin', {
+        category: 'telegram-account',
+        color: '#229ED9',
+        icon: 'tg.png',
+        align: "right",
+        defaults: {
+            name: { value: '' },
+            config: { type: 'config', required: false },
+            chatId: { value: '' },
+            userId: { value: '' },
+            rank: { value: 'Admin' },
+            adminRights: { value: '' }, // JSON string of ChatAdminRights
+        },
+        inputs: 1,
+        outputs: 1,
+        label: function () {
+            return this.name || 'Promote Admin';
+        },
+        oneditprepare: function () {
+            // Nothing special here yet — could validate JSON if needed
+        }
+    });
+</script>

package/nodes/promote-admin.js

@@ -0,0 +1,55 @@
+const { TelegramClient } = require("telegram");
+const { parseID } = require("telegram/Utils");
+const { Api } = require("telegram");
+
+module.exports = function (RED) {
+    function PromoteAdmin(config) {
+        RED.nodes.createNode(this, config);
+        this.config = RED.nodes.getNode(config.config);
+        var node = this;
+
+        this.on('input', async function (msg) {
+            let chatId = msg.payload.chatId || config.chatId;
+            let userId = msg.payload.userId || config.userId;
+            let rank = msg.payload.rank || config.rank || "Admin";
+            const customRights = msg.payload.adminRights || config.adminRights;
+
+            /** @type {TelegramClient} */
+            const client = msg.payload?.client ? msg.payload.client : this.config.client;
+            let group, user;
+
+            try {
+                group = chatId[0] === "@" ? await client.getEntity(chatId) : parseID(chatId);
+                user = userId[0] === "@" ? await client.getEntity(userId) : parseID(userId);
+
+                const adminRights = customRights || new Api.ChatAdminRights({
+                    changeInfo: true,
+                    postMessages: true,
+                    editMessages: true,
+                    deleteMessages: true,
+                    banUsers: true,
+                    inviteUsers: true,
+                    pinMessages: true,
+                    addAdmins: true,
+                    manageCall: true,
+                    anonymous: false,
+                    manageTopics: true,
+                });
+
+                const result = await client.invoke(new Api.channels.EditAdmin({
+                    channel: group,
+                    userId: user,
+                    adminRights,
+                    rank,
+                }));
+
+                node.send({ payload: result });
+
+            } catch (err) {
+                node.error('Error promoting admin: ' + err.message);
+            }
+        });
+    }
+
+    RED.nodes.registerType('promote-admin', PromoteAdmin);
+};

package/nodes/receiver.html

@@ -0,0 +1,128 @@
+<script type="text/javascript">
+    RED.nodes.registerType('receiver', {
+      category: 'telegram-account',
+      color: '#229ED9',
+      icon: 'tg.png',
+      align:"right",
+      defaults: {
+        name: { value: '' },
+        config: { type: 'config', required: false },
+        ignore: { value:""}
+      },
+      inputs: 1,
+      outputs: 1,
+      label: function () {
+        return this.name || 'Receiver';
+      },
+      
+    });
+</script>
+
+<script type="text/html" data-template-name="receiver">
+    <div class="form-row">
+      <label for="node-input-name">
+        <i class="fa fa-tag"></i> Name
+      </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-tag"></i> Config
+      </label>
+      <input
+        type="text"
+        id="node-input-config"
+        placeholder="Config"
+        style="width: 60%"
+      />
+    </div>
+    <div class="form-row">
+      <label for="node-input-ignore">
+        <i class="fa fa-tag"></i> Config
+      </label>
+      <textarea
+        type="text"
+        id="node-input-ignore"
+        placeholder="Config"
+        style="width: 60%"
+      ></textarea>
+    </div>
+  </script>
+
+  <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>
+
+    <h3>Inputs</h3>
+    <p>This node does not take any direct inputs. It listens to all incoming messages from the configured Telegram client.</p>
+
+    <h3>Outputs</h3>
+    <dl class="message-properties">
+        <dt>payload.update
+            <span class="property-type">object</span>
+        </dt>
+        <dd>The raw Telegram update object containing details about the incoming message, sender, chat, and metadata.</dd>
+    </dl>
+
+    <h3>Configuration</h3>
+    <dl class="message-properties">
+        <dt>Telegram Configuration
+            <span class="property-type">node</span>
+        </dt>
+        <dd>A configured Telegram client node to receive messages. Ensure the client is authenticated and has necessary permissions.</dd>
+
+        <dt>Ignore List
+            <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>
+    </dl>
+
+    <h3>Details</h3>
+    <p>The <b>receiver</b> node uses the Telegram client to listen for all new messages in real-time. It emits a message to the next connected Node-RED node whenever a new Telegram message is received, provided the sender's user ID is not in the ignore list.</p>
+
+    <h3>Example</h3>
+    <pre>
+    {
+        "payload": {
+            "update": {
+                "message": {
+                    "message": "Hello, bot!",
+                    "sender": {
+                        "id": 123456789,
+                        "username": "exampleuser"
+                    },
+                    "chat": {
+                        "id": 987654321,
+                        "type": "private"
+                    }
+                }
+            }
+        }
+    }
+    </pre>
+    <p>In this example, the node outputs the raw Telegram update object when a user sends the message "Hello, bot!" to the Telegram bot.</p>
+
+    <h3>Error Handling</h3>
+    <p>If the Telegram client encounters an authentication issue or configuration error, the node logs an error message and stops listening for messages.</p>
+
+    <h3>Advanced Usage</h3>
+    <p>By configuring the <b>Ignore List</b>, you can filter out messages from specific users. For example:</p>
+    <pre>
+    123456789
+    987654321
+    </pre>
+    <p>In this case, messages from user IDs <code>123456789</code> and <code>987654321</code> will be ignored.</p>
+
+    <h3>Notes</h3>
+    <ul>
+        <li>Ensure the Telegram bot has sufficient permissions to receive messages in the configured chat or channel.</li>
+        <li>The <b>Ignore List</b> only filters messages based on the sender's user ID.</li>
+        <li>For advanced filtering based on message content, consider chaining this node with additional processing nodes in Node-RED.</li>
+    </ul>
+</script>
+
+