@patricktobias86/node-red-telegram-account 1.1.1 → 1.1.3

package/examples/Example User Auth.json

@@ -0,0 +1,104 @@
+[
+    {
+        "id": "8a1d5a99e1018272",
+        "type": "tab",
+        "label": "Example User Auth",
+        "disabled": false,
+        "info": "",
+        "env": []
+    },
+    {
+        "id": "inject_credentials",
+        "type": "inject",
+        "z": "8a1d5a99e1018272",
+        "name": "Start Auth",
+        "props": [],
+        "repeat": "",
+        "crontab": "",
+        "once": false,
+        "onceDelay": 0.1,
+        "topic": "",
+        "x": 160,
+        "y": 100,
+        "wires": [
+            [
+                "ee6466b89cc7a43b"
+            ]
+        ]
+    },
+    {
+        "id": "debug_output",
+        "type": "debug",
+        "z": "8a1d5a99e1018272",
+        "name": "Session Output",
+        "active": true,
+        "tosidebar": true,
+        "console": false,
+        "tostatus": false,
+        "complete": "true",
+        "targetType": "full",
+        "statusVal": "",
+        "statusType": "auto",
+        "x": 560,
+        "y": 100,
+        "wires": []
+    },
+    {
+        "id": "inject_code",
+        "type": "inject",
+        "z": "8a1d5a99e1018272",
+        "name": "Send Code",
+        "props": [
+            {
+                "p": "payload"
+            }
+        ],
+        "repeat": "",
+        "crontab": "",
+        "once": false,
+        "onceDelay": "",
+        "topic": "",
+        "payload": "{\"code\":\"00000\"}",
+        "payloadType": "json",
+        "x": 170,
+        "y": 180,
+        "wires": [
+            [
+                "function_send_code"
+            ]
+        ]
+    },
+    {
+        "id": "function_send_code",
+        "type": "function",
+        "z": "8a1d5a99e1018272",
+        "name": "Submit Code",
+        "func": "const code = msg.payload.code;\nconst wait = flow.get(\"waitForCode\");\nif (typeof wait === \"function\") {\n    wait(code);\n    flow.set(\"waitForCode\", null);\n    node.status({fill:\"blue\",shape:\"ring\",text:\"Code sent!\"});\n} else {\n    node.warn(\"No code listener available. Did you trigger auth first?\");\n}\nreturn null;",
+        "outputs": 0,
+        "timeout": "",
+        "noerr": 0,
+        "initialize": "",
+        "finalize": "",
+        "libs": [],
+        "x": 370,
+        "y": 180,
+        "wires": []
+    },
+    {
+        "id": "ee6466b89cc7a43b",
+        "type": "auth",
+        "z": "8a1d5a99e1018272",
+        "name": "",
+        "api_id": "",
+        "api_hash": "",
+        "phoneNumber": "",
+        "password": "",
+        "x": 350,
+        "y": 100,
+        "wires": [
+            [
+                "debug_output"
+            ]
+        ]
+    }
+]

package/nodes/auth.html

@@ -3,26 +3,31 @@
         category: 'telegram-account',
         color: '#a6bbcf',
         defaults: {
-            api_id: { value: "", required: true },
-            api_hash: { value: "", required: true },
-            phoneNumber: { value: "", required: true },
-            password: { value: "" },
+            name: { value: "" },
+            api_id: { value: "" },
+            api_hash: { value: "" },
+            phoneNumber: { value: "" },
+            password: { value: "" }
         },
         inputs: 1,
         outputs: 1,
-        icon: "font-awesome/fa-lock",
-        label: function () {
-            return this.name || "Telegram Auth";
+        icon: 'tg.png',
+        align: 'right',
+        paletteLabel: 'user auth',
+        label: function() {
+            return this.name||'user auth';
         },
         oneditprepare: function () {
-            // Инициализация значений
+            // Initialize values
+            $("#node-input-name").val(this.name || "");
             $("#node-input-api_id").val(this.api_id || "");
             $("#node-input-api_hash").val(this.api_hash || "");
             $("#node-input-phoneNumber").val(this.phoneNumber || "");
             $("#node-input-password").val(this.password || "");
         },
         oneditsave: function () {
-            // Сохранение значений
+            // Save values
+            this.name = $("#node-input-name").val();
             this.api_id = $("#node-input-api_id").val();
             this.api_hash = $("#node-input-api_hash").val();
             this.phoneNumber = $("#node-input-phoneNumber").val();
@@ -32,6 +37,12 @@
 </script>
 
 <script type="text/html" data-template-name="auth">
+<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">
+</div>    
 <div class="form-row">
     <label for="node-input-api_id">
         <i class="fa fa-key"></i> API ID
@@ -61,78 +72,68 @@
 </div>
 
 <p>
-    <strong>Note:</strong> This configuration is required for connecting to the Telegram API and starting a session.
+    <strong>Note:</strong> These values are used to create a Telegram session string.
 </p>
 </script>
 
-
 <script type="text/html" data-help-name="auth">
-    <p>The <b>auth</b> node facilitates Telegram API authentication using the <code>telegram</code> library. It allows users to authenticate a session and retrieve a stringSession for future use.</p>
+    <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>
 
     <h3>Inputs</h3>
     <dl class="message-properties">
-        <dt>payload.api_id
-            <span class="property-type">number | string</span>
-        </dt>
-        <dd>The Telegram API ID. Required for authentication.</dd>
-        
-        <dt>payload.api_hash
-            <span class="property-type">string</span>
-        </dt>
-        <dd>The Telegram API hash. Required for authentication.</dd>
-        
-        <dt>payload.phoneNumber
-            <span class="property-type">string</span>
-        </dt>
-        <dd>The phone number associated with the Telegram account.</dd>
-        
-        <dt>payload.password
-            <span class="property-type">string</span>
-        </dt>
-        <dd>The password for two-factor authentication (if enabled on the Telegram account).</dd>
+        <dt>payload.api_id <span class="property-type">number | string</span></dt>
+        <dd>The Telegram API ID.</dd>
+
+        <dt>payload.api_hash <span class="property-type">string</span></dt>
+        <dd>The Telegram API hash.</dd>
+
+        <dt>payload.phoneNumber <span class="property-type">string</span></dt>
+        <dd>The phone number of the Telegram account, including country code (e.g. +1701234567).</dd>
+
+        <dt>payload.password <span class="property-type">string</span></dt>
+        <dd>(Optional) The password for two-factor authentication.</dd>
     </dl>
 
+    <h3>Behavior</h3>
+    <p>When triggered, the node starts the login flow by sending a code via SMS or Telegram to the specified phone number. The node will wait for a verification code to be supplied separately.</p>
+    <p>To complete authentication, you must send the code using a function node like this:</p>
+    <pre>
+const code = msg.payload.code;
+const wait = flow.get("waitForCode");
+if (typeof wait === "function") {
+    wait(code);
+    flow.set("waitForCode", null);
+    node.status({fill:"blue",shape:"ring",text:"Code sent!"});
+}
+    </pre>
+
     <h3>Outputs</h3>
     <dl class="message-properties">
-        <dt>topic
-            <span class="property-type">string</span>
-        </dt>
+        <dt>topic <span class="property-type">string</span></dt>
         <dd>
-            - <b>"auth_success"</b>: Authentication was successful.  
-            - <b>"auth_error"</b>: An error occurred during authentication.
+            - <b>"auth_success"</b>: Login succeeded.<br>
+            - <b>"auth_error"</b>: Login failed.
         </dd>
 
-        <dt>payload
-            <span class="property-type">object</span>
-        </dt>
+        <dt>payload <span class="property-type">object</span></dt>
         <dd>
-            For <b>"auth_success"</b>:  
-            <ul>
-                <li><code>payload.stringSession</code>: The generated session string.</li>
-                <li><code>payload.message</code>: Success message.</li>
-            </ul>
-            For <b>"auth_error"</b>:  
             <ul>
-                <li><code>payload.error</code>: The error message describing the issue.</li>
+                <li><code>stringSession</code>: The generated session string to reuse in your bots.</li>
+                <li><code>message</code> or <code>error</code>: Additional info.</li>
             </ul>
         </dd>
     </dl>
 
-    <h3>Details</h3>
-    <p>To use the <b>auth</b> node, pass the required API credentials and phone number as part of the input message payload. The node will initiate the Telegram authentication flow. If a two-factor password is required, include it in the <code>payload.password</code>.</p>
-
-    <p>The node temporarily stores the phone code resolver in the flow context under the key <code>phoneCode</code>. This allows subsequent nodes to resolve the phone code using a separate input mechanism, such as user interaction.</p>
-
     <h3>Example</h3>
     <pre>
-    {
-        "payload": {
-            "api_id": 123456,
-            "api_hash": "your_api_hash",
-            "phoneNumber": "+123456789",
-            "password": "your_password"
-        }
+{
+    "payload": {
+        "api_id": "123456",
+        "api_hash": "your_api_hash",
+        "phoneNumber": "+46701234567",
+        "password": "optional_password"
     }
+}
     </pre>
-    <p>This example input payload initiates the authentication process. Upon receiving the phone code, it should be resolved using a dedicated node or interface.</p>
+    <p>Use a separate node to submit the received code after triggering this payload.</p>
 </script>

package/nodes/auth.js

@@ -7,51 +7,69 @@ module.exports = function (RED) {
         const node = this;
 
         this.on("input", async (msg) => {
-            const api_idString = msg.payload.api_id || config.api_id;
-            const api_hash = msg.payload.api_hash || config.api_hash;
-            const phoneNumber = msg.payload.phoneNumber || config.phoneNumber;
-            const password = msg.payload.password || config.password;
-            const api_id = parseInt(api_idString);
 
-            const session = new StringSession("");
+            const payload = (msg && typeof msg.payload === "object") ? msg.payload : {};
+
+            const api_id = parseInt(payload.api_id || config.api_id);
+            const api_hash = payload.api_hash || config.api_hash;
+            const phoneNumber = payload.phoneNumber || config.phoneNumber;
+            const password = payload.password || config.password;
+
+            if (!api_id || !api_hash || !phoneNumber) {
+                node.error("Missing required API credentials (api_id, api_hash, or phoneNumber).");
+                return;
+            }
+
+            const session = new StringSession(""); // always generate a new session
             const client = new TelegramClient(session, api_id, api_hash, {
                 connectionRetries: 5,
             });
 
- 
-            let resolvePhoneCode;
             const context = node.context().flow;
 
+            let phoneCodePromise = new Promise((resolve) => {
+                context.set("waitForCode", resolve);
+            });
+
             try {
                 await client.start({
                     phoneNumber: () => phoneNumber,
                     password: () => password,
-                    phoneCode: async () =>{
-                        return new Promise((resolve) => {
-                            resolvePhoneCode = resolve;
-                            context.set("phoneCode", resolvePhoneCode);
-                        })
+                    phoneCode: async () => {
+                        node.status({ fill: "yellow", shape: "ring", text: "Waiting for code" });
+                        const code = await phoneCodePromise;
+                        return code;
                     },
-                    onError: (err) => node.error(`Error: ${err.message}`),
+                    onError: (err) => node.error("GramJS Error: " + err.message),
+                });
+
+                const stringSession = client.session.save();
+
+                console.log("Sending result to output:", {
+                    stringSession,
+                    messages: [
+                        { type: "auth_success", text: "Authorization successful!" },
+                        { type: "session_token", text: "Copy this stringSession to use in other nodes." }
+                    ]
                 });
 
-                const stringSession = client.session.save(); // Save session
                 node.send({
                     topic: "auth_success",
                     payload: {
                         stringSession,
-                        message: "Authorization successful!",
-                    },
+                        message: "Authorization successful!"
+                    }
                 });
-               
-            } catch (error) {
-                node.error(`Authorization error: ${error.message}`);
+
+                node.status({ fill: "green", shape: "dot", text: "Authenticated" });
+
+            } catch (err) {
+                node.error("Authentication failed: " + err.message);
                 node.send({
                     topic: "auth_error",
-                    payload: {
-                        error: error.message,
-                    },
+                    payload: { error: err.message },
                 });
+                node.status({ fill: "red", shape: "ring", text: "Failed" });
             }
         });
     }

package/nodes/command.html

@@ -3,19 +3,18 @@
       category: 'telegram-account',
       color: '#229ED9',
       icon: 'tg.png',
-      align:"right",
       defaults: {
         name: { value: '' },
         config: { type: 'config', required: false },
-        command: { value: "", required:true },
-        regex:{ value:false }
+        command: { value: "", required: true },
+        regex: { value: false }
       },
       inputs: 1,
       outputs: 1,
-      label: function () {
-        return this.name || 'Command';
-      },
-      
+      paletteLabel: 'command',
+      label: function() {
+        return this.name||'command';
+    }
     });
 </script>
 

package/nodes/config.html

@@ -27,7 +27,7 @@
           testServers: {value: undefined}
       },
       label: function() {
-          return this.name || "Telegram Client Config";
+          return this.name || "telegram user config";
       },
       oneditprepare: function() {
    

package/nodes/config.js

@@ -1,58 +1,54 @@
 const { TelegramClient } = require("telegram");
 const { StringSession } = require("telegram/sessions");
 
+const activeClients = {}; // Cache: session string → connected client
+
 module.exports = function (RED) {
     function TelegramClientConfig(config) {
         RED.nodes.createNode(this, config);
-        this.apiId = config.api_id;
-        this.apiHash = config.api_hash;
-        this.session = new StringSession(config.session);
-        this.useIPV6 = config.useIPV6;
-        this.timeout = config.timeout;
-        this.requestRetries = config.requestRetries;
-        this.connectionRetries = config.connectionRetries;
-        this.proxy = config.proxy;
-        this.downloadRetries = config.downloadRetries;
-        this.retryDelay = config.retryDelay;
-        this.autoReconnect = config.autoReconnect;
-        this.sequentialUpdates = config.sequentialUpdates;
-        this.floodSleepThreshold = config.floodSleepThreshold;
-        this.deviceModel = config.deviceModel;
-        this.systemVersion = config.systemVersion;
-        this.appVersion = config.appVersion;
-        this.langCode = config.langCode;
-        this.systemLangCode = config.systemLangCode;
-        this.useWSS = config.useWSS;
-        this.maxConcurrentDownloads = config.maxConcurrentDownloads;
-        this.securityChecks = config.securityChecks;
-        this.testServers = config.testServers;
-        const node = this;
 
+        const sessionStr = config.session;
+        const apiId = parseInt(config.api_id);
+        const apiHash = config.api_hash;
 
-        this.client = new TelegramClient(this.session, parseInt(this.apiId), this.apiHash, {
-           
-           
-        });
+        this.session = new StringSession(sessionStr);
+        this.client = null;
+
+        const node = this;
+
+        if (activeClients[sessionStr]) {
+            // Reuse existing client
+            this.client = activeClients[sessionStr];
+            node.status({ fill: "green", shape: "dot", text: "Reused existing client" });
+        } else {
+            // Create and connect new client
+            this.client = new TelegramClient(this.session, apiId, apiHash, {
+                connectionRetries: config.connectionRetries || 5,
+                autoReconnect: config.autoReconnect !== false,
+                requestRetries: config.requestRetries || 5,
+            });
 
-        try {
             this.client.connect().then(async () => {
-                let isAuthorized = await this.client.isUserAuthorized();
-                if (!isAuthorized) {
-                    node.error(`Session is invalid`);
+                const authorized = await this.client.isUserAuthorized();
+                if (!authorized) {
+                    node.error("Session is invalid");
                 } else {
                     node.status({ fill: "green", shape: "dot", text: "Connected" });
+                    activeClients[sessionStr] = this.client;
                 }
+            }).catch(err => {
+                node.error("Connection error: " + err.message);
             });
-        } catch (err) {
-            node.error('Authorisation error: ' + err.message);
         }
 
-        this.on("close", () => {
-            if (this.client) {
-                this.client.disconnect();
+        this.on("close", async () => {
+            if (this.client && activeClients[sessionStr] === this.client) {
+                await this.client.disconnect();
+                delete activeClients[sessionStr];
                 node.status({ fill: "red", shape: "ring", text: "Disconnected" });
             }
         });
     }
+
     RED.nodes.registerType('config', TelegramClientConfig);
 };

package/nodes/delete-message.html

@@ -1,18 +1,19 @@
 <script type="text/javascript">
     RED.nodes.registerType('delete-message', {
-      category: 'telegram-account',
-      color: '#FF5733',
-      icon: 'tg.png',
-      align: 'right',
-      defaults: {
-        name: { value: '' },
-        config: { type: 'config', required: false },
-      },
-      inputs: 1,
-      outputs: 1,
-      label: function () {
-        return this.name || 'Delete Message';
-      },
+        category: 'telegram-account',
+        color: '#FF5733',
+        icon: 'tg.png',
+        align: 'right',
+        defaults: {
+            name: { value: '' },
+            config: { type: 'config', required: false },
+        },
+        inputs: 1,
+        outputs: 1,
+        paletteLabel: 'delete message',
+        label: function() {
+            return this.name||'delete message';
+        }
     });
 </script>
 

package/nodes/get-entity.html

@@ -3,15 +3,16 @@
         category: 'telegram-account',
         color: '#229ED9',
         icon: 'tg.png',
-        align: "right",
+        align: 'right',
         defaults: {
             name: { value: '' },
             config: { type: 'config', required: false },
         },
         inputs: 1,
         outputs: 1,
-        label: function () {
-            return this.name || 'Get Entity';
+        paletteLabel: 'get entity',
+        label: function() {
+            return this.name||'get entity';
         }
     });
 </script>

package/nodes/iter-dialogs.html

@@ -2,6 +2,8 @@
     RED.nodes.registerType('iter-dialogs', {
         category: 'telegram-account',
         color: '#32a3e0',
+        icon: 'tg.png',
+        align: 'right',
         defaults: {
             name: { value: '' },
             config: { type: 'config', required: true },
@@ -15,10 +17,10 @@
         },
         inputs: 1,
         outputs: 1,
-        paletteLabel: 'Iterate Dialogs',
-        label: function () {
-            return this.name || 'Iterate Dialogs';
-        },
+        paletteLabel: 'iterate dialogs',
+        label: function() {
+            return this.name||'iterate dialogs';
+        }
     });
 </script>
 

package/nodes/iter-messages.html

@@ -2,6 +2,8 @@
     RED.nodes.registerType('iter-messages', {
         category: 'telegram',
         color: '#32a3e0',
+        icon: 'tg.png',
+        align: 'right',
         defaults: {
             name: { value: '' },
             config: { type: 'config', required: true },
@@ -23,9 +25,9 @@
         },
         inputs: 1,
         outputs: 1,
-        paletteLabel: 'Iterate Messages',
-        label: function () {
-            return this.name || 'Iterate Messages';
+        paletteLabel: 'iter messages',
+        label: function() {
+            return this.name||'iter messages';
         },
         oneditprepare: function(){
             const node = this;

package/nodes/promote-admin.html

@@ -3,7 +3,7 @@
         category: 'telegram-account',
         color: '#229ED9',
         icon: 'tg.png',
-        align: "right",
+        align: 'right',
         defaults: {
             name: { value: '' },
             config: { type: 'config', required: false },
@@ -24,8 +24,9 @@
         },
         inputs: 1,
         outputs: 1,
-        label: function () {
-            return this.name || 'Promote Admin';
+        paletteLabel: 'promote admin',
+        label: function() {
+            return this.name||'promote admin';
         },
         oneditprepare: function () {
             // No extra logic needed

package/nodes/receiver.html

@@ -1,20 +1,19 @@
 <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';
-      },
-      
+        category: 'telegram-account',
+        color: '#229ED9',
+        icon: 'tg.png',
+        defaults: {
+            name: { value: '' },
+            config: { type: 'config', required: false },
+            ignore: { value:""}
+        },
+        inputs: 1,
+        outputs: 1,
+        paletteLabel: 'receiver',
+        label: function() {
+            return this.name||'receiver';
+        }
     });
 </script>
 

package/nodes/send-file.html

@@ -30,11 +30,12 @@
         },
         inputs: 1,
         outputs: 1,
-        icon: 'file.png',
-        paletteLabel: 'Send Files',
-        label: function () {
-            return this.name || 'Send Files';
-        },
+        icon: 'tg.png',
+        align: 'right',
+        paletteLabel: 'send file',
+        label: function() {
+            return this.name||'send file';
+        }
     });
 </script>
 

package/nodes/send-message.html

@@ -3,7 +3,7 @@
         category: 'telegram-account',
         color: '#229ED9',
         icon: 'tg.png',
-        align: "right",
+        align: 'right',
         defaults: {
             name: { value: '' },
             chatId: { value: '' },
@@ -28,8 +28,9 @@
         },
         inputs: 1,
         outputs: 1,
-        label: function () {
-            return this.name || 'Send Message';
+        paletteLabel: 'send message',
+        label: function() {
+            return this.name||'send message';
         },
         oneditprepare: function () {
             const node = this;

package/package.json

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