n8n-nodes-telepilot-2 0.7.4 → 0.7.5

package/LICENSE.md

@@ -1,7 +1,7 @@
-Copyright 2025 https://github.com/telepilotco <contact@telepilot.co>
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+Copyright 2025 https://github.com/telepilotco <contact@telepilot.co>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,179 +1,179 @@
-# n8n-nodes-telepilot-2
-
-[![npm version](https://badge.fury.io/js/n8n-nodes-telepilot-2.svg)](https://www.npmjs.com/package/n8n-nodes-telepilot-2)
-
-## What's New in TelePilot2
-
-### Version 0.7.2 (Latest)
-- **Docker Support**: Use Debian-based n8n image for full compatibility
-- **Prebuilt binaries**: Works out of the box with prebuilt-tdlib
-- **No compilation needed**: All dependencies work without building from source
-- **Simplified installation**: Just install and run
-
-### Version 0.6.x Updates
-- **Updated TDLib**: Using TDLib 1.8.14 for improved performance and compatibility
-- **New GetAlbums Operation**: Fetch grouped albums (media groups) from Telegram chats with advanced filtering:
-  - Retrieve up to 50 albums at once
-  - Filter albums by timestamp (get albums after a specific time)
-  - Automatic handling of incomplete album fetches
-  - Complete album guarantee - no dangling posts
-  - Status tracking for fetch iterations and boundary conditions
-
-## Beta testing
-
-Current build does not have all Telegram actions implemented and does not work on all n8n installations.
-
-Here is environment compatibility overview:
-
-|     OS | architecture | supported? |
-|--------|--------------|------|
-| docker | x64 | YES  |
-| docker | arm64 | YES   |
-| linux | x64 | YES     |
-| linux | arm64 | YES   |
-| macos | x64 | YES     |
-| macos | arm64 | YES  |
-| windows | x64 | NO  |
-| windows | arm64 | NO  |
-
-If you are interested in following our updates and news, check out:
-
-- our telegram channel https://t.me/telepilotco OR
-- our website https://telepilot.co
-
-
-## Overview
-
-`n8n-nodes-telepilot-2` is a node for the n8n automation engine that provides the ability to configure your personal Telegram assistant. 
-It works alongside your main client, allowing you to interact with Telegram servers and see all the messages you can see, 
-while also enabling your assistant to react to those messages.
-
-With `n8n-nodes-telepilot-2`, you can enhance your Telegram user experience by automating various actions and responses. 
-Your personal Telegram CoPilot acts as real-time assistant, providing additional functionalities and making your Telegram usage more efficient.
-
-At [TelePilot](https://telepilot.co), we prioritize your privacy. We do not have access to your Telegram messages because you have full control over your personal instance of TelePilot, 
-which runs on your self-hosted n8n instance. The choice of hosting environment is entirely up to you. 
-
-Whether you prefer the convenience of cloud hosting or the control of running it on your own machine, TelePilot allows you to make that decision. 
-
-Probably the fastest way to get everything up and running would be using Railway n8n template:
-
- - [Railway](https://railway.app/new/template/zo8wVU)
-
-If you are technically inclined, you can even launch it on your homelab or Raspberry Pi. 
-For a hassle-free experience, take one of these templates for self-hosting:
-
- - [n8n on Cloudron](https://www.cloudron.io/store/io.n8n.cloudronapp.html)
- - [YunoHost](https://yunohost.org/en/app_n8n) / [YunoHost n8n app on github](https://github.com/YunoHost-Apps/n8n_ynh)
- - https://timeweb.cloud/ ?
-
-## Features
-
-### Core Capabilities
-- Interact with other users
-- Respond to private messages: CoPilot can respond to private messages from other users, allowing for automated answers
-- Interact with channels and groups:
-	- Download messages and chat history
-	- **NEW: Fetch grouped albums** - Retrieve media groups with intelligent filtering
-	- Topic Notification: Stay updated on specific topics of interest by receiving notifications when they are being discussed in Telegram. 
-    Configure your [personal Telegram assistant](https://telepilot.co) to monitor and alert you whenever a particular topic is mentioned.
-	- Keyword Notification: Never miss important messages by setting up keyword notifications.
-    Define specific words or phrases that you are interested in, and your Telegram assistant will notify you whenever those keywords are posted in any message. 
-    Stay informed and engaged with the conversations that matter to you.
-	- Moderating groups
-  - Schedule message posting: you can schedule messages using your Telegram CoPilot
-- Get more API events: Telepilot can receive API events that normal bots don't know about, such as when a message gets deleted through the client.
-
-### New in TelePilot2
-- **GetAlbums Operation**: Advanced album fetching with:
-  - Configurable album limits (1-50 albums)
-  - Timestamp-based filtering
-  - Complete album guarantee (no partial albums)
-  - Automatic handling of TDLib optimizations
-  - Detailed fetch statistics and status tracking
-
-
-## Installation
-
-### Install as n8n community node
-
-To use this package in your n8n project, follow these steps:
-
-1. Go to Settings -> Community modules of your self-hosted n8n instance
-2. Select "Install Community node"
-3. Specify the name `n8n-nodes-telepilot-2`, click checkbox that you understand the risks and click "Install"
-
-![Install Telepilot as n8n Community Node](https://telepilot.co/documentation-images/install-community-node-1.png)
-
-### Manual installation
-
-To get started install the package in your `~/.n8n/nodes` directory:
-
-`npm install n8n-nodes-telepilot-2`
-
-For Docker-based deployments, add the following line before the font installation command in your [n8n Dockerfile](https://github.com/n8n-io/n8n/blob/master/docker/images/n8n/Dockerfile):
-
-`RUN cd ~/.n8n/ && mkdir nodes && cd nodes && npm install n8n-nodes-telepilot-2`
-
-## TelePilot setup
-
-### Connect TelePilot with your Telegram Account
-![Connect Telepilot with your Telegram Account](https://telepilot.co/documentation-images/telegram-api-1.png)
-
-- Log in to your Telegram core: https://my.telegram.org with your phone number that you wish to use TelePilot with
-- Go to [API development tools](https://my.telegram.org/apps) and fill out the form:
-  - App title: `telepilot`
-  - Short name: `telepilot`
-- Receive basic addresses as well as the `api_id` and `api_hash` parameters required for user authorization.
-
-### Create Credentials in your n8n instance
-
-Access the credentials UI by opening the left menu and selecting **Credentials**.
-
-![Configure TelePilot Credentials](https://telepilot.co/documentation-images/credentials-0.png)
-
-Click on "Add Credential" button and browse for "TelePilot2 API".
-
-To initiate connection with Telegram servers, you need to provide following:
-- `api_id`: copy-paste it from https://my.telegram.org/apps page
-- `api_hash`: copy-paste it from https://my.telegram.org/apps page
-
-![Configure TelePilot Credentials](https://telepilot.co/documentation-images/credentials-1.png)
-
-After you have filled out all fields, click on "Save" and make sure that you see "Connection tested successfully" message.
-
-![Configure TelePilot Credentials](https://telepilot.co/documentation-images/credentials-2.png)
-
-## Login
-
-Once the credentials are set up, you need to log in.
-This is accomplished by authorizing Telepilot using your Telegram account via a QR code scan.
-
-For more detailed information, please refer to our login guide: https://telepilot.co/login-howto
-
-
-### Import workflows
-
-You can import predefined workflows that we have created for you, check out [this page](https://telepilot.co/workflows)
-
-
-## Troubleshooting
-
-You can enable DEBUG logs by running n8n with env variables, here is how you do it in cli:
-
-```shell
-DEBUG=tdl,tdl:client,telepilot-cred,telepilot-node,telepilot-trigger,telepilot-cm N8N_LOG_LEVEL=debug npx n8n
-```
-
-For dockerized setup, make sure you add these env variables to your docker container or docker compose
-
-
-## Usage
-
-This package provides various nodes and actions that allow you to interact with Telegram servers and enhance the Telegram user experience. 
-Please refer to the n8n Documentation for detailed information on each node and its usage.
-May you have any questions, reach out to per email (contact@telepilot.co) or in our [Telegram Group](https://t.me/telepilotco_group)
-
-## License
-
-This project is licensed under the MIT license.
+# n8n-nodes-telepilot-2
+
+[![npm version](https://badge.fury.io/js/n8n-nodes-telepilot-2.svg)](https://www.npmjs.com/package/n8n-nodes-telepilot-2)
+
+## What's New in TelePilot2
+
+### Version 0.7.2 (Latest)
+- **Docker Support**: Use Debian-based n8n image for full compatibility
+- **Prebuilt binaries**: Works out of the box with prebuilt-tdlib
+- **No compilation needed**: All dependencies work without building from source
+- **Simplified installation**: Just install and run
+
+### Version 0.6.x Updates
+- **Updated TDLib**: Using TDLib 1.8.14 for improved performance and compatibility
+- **New GetAlbums Operation**: Fetch grouped albums (media groups) from Telegram chats with advanced filtering:
+  - Retrieve up to 50 albums at once
+  - Filter albums by timestamp (get albums after a specific time)
+  - Automatic handling of incomplete album fetches
+  - Complete album guarantee - no dangling posts
+  - Status tracking for fetch iterations and boundary conditions
+
+## Beta testing
+
+Current build does not have all Telegram actions implemented and does not work on all n8n installations.
+
+Here is environment compatibility overview:
+
+|     OS | architecture | supported? |
+|--------|--------------|------|
+| docker | x64 | YES  |
+| docker | arm64 | YES   |
+| linux | x64 | YES     |
+| linux | arm64 | YES   |
+| macos | x64 | YES     |
+| macos | arm64 | YES  |
+| windows | x64 | NO  |
+| windows | arm64 | NO  |
+
+If you are interested in following our updates and news, check out:
+
+- our telegram channel https://t.me/telepilotco OR
+- our website https://telepilot.co
+
+
+## Overview
+
+`n8n-nodes-telepilot-2` is a node for the n8n automation engine that provides the ability to configure your personal Telegram assistant. 
+It works alongside your main client, allowing you to interact with Telegram servers and see all the messages you can see, 
+while also enabling your assistant to react to those messages.
+
+With `n8n-nodes-telepilot-2`, you can enhance your Telegram user experience by automating various actions and responses. 
+Your personal Telegram CoPilot acts as real-time assistant, providing additional functionalities and making your Telegram usage more efficient.
+
+At [TelePilot](https://telepilot.co), we prioritize your privacy. We do not have access to your Telegram messages because you have full control over your personal instance of TelePilot, 
+which runs on your self-hosted n8n instance. The choice of hosting environment is entirely up to you. 
+
+Whether you prefer the convenience of cloud hosting or the control of running it on your own machine, TelePilot allows you to make that decision. 
+
+Probably the fastest way to get everything up and running would be using Railway n8n template:
+
+ - [Railway](https://railway.app/new/template/zo8wVU)
+
+If you are technically inclined, you can even launch it on your homelab or Raspberry Pi. 
+For a hassle-free experience, take one of these templates for self-hosting:
+
+ - [n8n on Cloudron](https://www.cloudron.io/store/io.n8n.cloudronapp.html)
+ - [YunoHost](https://yunohost.org/en/app_n8n) / [YunoHost n8n app on github](https://github.com/YunoHost-Apps/n8n_ynh)
+ - https://timeweb.cloud/ ?
+
+## Features
+
+### Core Capabilities
+- Interact with other users
+- Respond to private messages: CoPilot can respond to private messages from other users, allowing for automated answers
+- Interact with channels and groups:
+	- Download messages and chat history
+	- **NEW: Fetch grouped albums** - Retrieve media groups with intelligent filtering
+	- Topic Notification: Stay updated on specific topics of interest by receiving notifications when they are being discussed in Telegram. 
+    Configure your [personal Telegram assistant](https://telepilot.co) to monitor and alert you whenever a particular topic is mentioned.
+	- Keyword Notification: Never miss important messages by setting up keyword notifications.
+    Define specific words or phrases that you are interested in, and your Telegram assistant will notify you whenever those keywords are posted in any message. 
+    Stay informed and engaged with the conversations that matter to you.
+	- Moderating groups
+  - Schedule message posting: you can schedule messages using your Telegram CoPilot
+- Get more API events: Telepilot can receive API events that normal bots don't know about, such as when a message gets deleted through the client.
+
+### New in TelePilot2
+- **GetAlbums Operation**: Advanced album fetching with:
+  - Configurable album limits (1-50 albums)
+  - Timestamp-based filtering
+  - Complete album guarantee (no partial albums)
+  - Automatic handling of TDLib optimizations
+  - Detailed fetch statistics and status tracking
+
+
+## Installation
+
+### Install as n8n community node
+
+To use this package in your n8n project, follow these steps:
+
+1. Go to Settings -> Community modules of your self-hosted n8n instance
+2. Select "Install Community node"
+3. Specify the name `n8n-nodes-telepilot-2`, click checkbox that you understand the risks and click "Install"
+
+![Install Telepilot as n8n Community Node](https://telepilot.co/documentation-images/install-community-node-1.png)
+
+### Manual installation
+
+To get started install the package in your `~/.n8n/nodes` directory:
+
+`npm install n8n-nodes-telepilot-2`
+
+For Docker-based deployments, add the following line before the font installation command in your [n8n Dockerfile](https://github.com/n8n-io/n8n/blob/master/docker/images/n8n/Dockerfile):
+
+`RUN cd ~/.n8n/ && mkdir nodes && cd nodes && npm install n8n-nodes-telepilot-2`
+
+## TelePilot setup
+
+### Connect TelePilot with your Telegram Account
+![Connect Telepilot with your Telegram Account](https://telepilot.co/documentation-images/telegram-api-1.png)
+
+- Log in to your Telegram core: https://my.telegram.org with your phone number that you wish to use TelePilot with
+- Go to [API development tools](https://my.telegram.org/apps) and fill out the form:
+  - App title: `telepilot`
+  - Short name: `telepilot`
+- Receive basic addresses as well as the `api_id` and `api_hash` parameters required for user authorization.
+
+### Create Credentials in your n8n instance
+
+Access the credentials UI by opening the left menu and selecting **Credentials**.
+
+![Configure TelePilot Credentials](https://telepilot.co/documentation-images/credentials-0.png)
+
+Click on "Add Credential" button and browse for "TelePilot2 API".
+
+To initiate connection with Telegram servers, you need to provide following:
+- `api_id`: copy-paste it from https://my.telegram.org/apps page
+- `api_hash`: copy-paste it from https://my.telegram.org/apps page
+
+![Configure TelePilot Credentials](https://telepilot.co/documentation-images/credentials-1.png)
+
+After you have filled out all fields, click on "Save" and make sure that you see "Connection tested successfully" message.
+
+![Configure TelePilot Credentials](https://telepilot.co/documentation-images/credentials-2.png)
+
+## Login
+
+Once the credentials are set up, you need to log in.
+This is accomplished by authorizing Telepilot using your Telegram account via a QR code scan.
+
+For more detailed information, please refer to our login guide: https://telepilot.co/login-howto
+
+
+### Import workflows
+
+You can import predefined workflows that we have created for you, check out [this page](https://telepilot.co/workflows)
+
+
+## Troubleshooting
+
+You can enable DEBUG logs by running n8n with env variables, here is how you do it in cli:
+
+```shell
+DEBUG=tdl,tdl:client,telepilot-cred,telepilot-node,telepilot-trigger,telepilot-cm N8N_LOG_LEVEL=debug npx n8n
+```
+
+For dockerized setup, make sure you add these env variables to your docker container or docker compose
+
+
+## Usage
+
+This package provides various nodes and actions that allow you to interact with Telegram servers and enhance the Telegram user experience. 
+Please refer to the n8n Documentation for detailed information on each node and its usage.
+May you have any questions, reach out to per email (contact@telepilot.co) or in our [Telegram Group](https://t.me/telepilotco_group)
+
+## License
+
+This project is licensed under the MIT license.

package/deploy/test-n8n-imports/credentials/credential-dummy.json

@@ -1,20 +1,20 @@
-[
-	{
-		"createdAt": "2024-01-17T15:38:35.985Z",
-		"updatedAt": "2024-01-17T16:02:08.428Z",
-		"id": "5FLFyAUup96AgsvX",
-		"name": "Personal Telegram CoPilot Dummy account",
-		"data": "U2FsdGVkX1/hYnxfkyQ4ZXrBnzVFIlw9JMQqPuM85QLqfyesqX7Z/hzk3XwryR1h",
-		"type": "telePilotApi",
-		"nodesAccess": [
-			{
-				"nodeType": "@telepilotco/n8n-nodes-telepilot.telePilot",
-				"date": "2024-01-17T15:38:35.975Z"
-			},
-			{
-				"nodeType": "@telepilotco/n8n-nodes-telepilot.telePilotTrigger",
-				"date": "2024-01-17T15:38:35.975Z"
-			}
-		]
-	}
-]
+[
+	{
+		"createdAt": "2024-01-17T15:38:35.985Z",
+		"updatedAt": "2024-01-17T16:02:08.428Z",
+		"id": "5FLFyAUup96AgsvX",
+		"name": "Personal Telegram CoPilot Dummy account",
+		"data": "U2FsdGVkX1/hYnxfkyQ4ZXrBnzVFIlw9JMQqPuM85QLqfyesqX7Z/hzk3XwryR1h",
+		"type": "telePilotApi",
+		"nodesAccess": [
+			{
+				"nodeType": "@telepilotco/n8n-nodes-telepilot.telePilot",
+				"date": "2024-01-17T15:38:35.975Z"
+			},
+			{
+				"nodeType": "@telepilotco/n8n-nodes-telepilot.telePilotTrigger",
+				"date": "2024-01-17T15:38:35.975Z"
+			}
+		]
+	}
+]

package/deploy/test-n8n-imports/workflows/Telepilot_getMe.json

@@ -1,68 +1,68 @@
-[
-	{
-  "name": "Telepilot getMe",
-  "nodes": [
-    {
-      "parameters": {},
-      "id": "6e65c321-a2c7-45a3-a2fd-7177535c994f",
-      "name": "When clicking \"Execute Workflow\"",
-      "type": "n8n-nodes-base.manualTrigger",
-      "typeVersion": 1,
-      "position": [
-        1200,
-        480
-      ]
-    },
-    {
-      "parameters": {
-        "resource": "user"
-      },
-      "id": "de0be3ef-35c3-45af-8fc1-c97c74b1f26e",
-      "name": "Telegram CoPilot",
-      "type": "@telepilotco/n8n-nodes-telepilot.telePilot",
-      "typeVersion": 1,
-      "position": [
-        1420,
-        480
-      ],
-      "credentials": {
-        "telePilotApi": {
-          "id": "5FLFyAUup96AgsvX",
-          "name": "Personal Telegram Co-Pilot account"
-        }
-      }
-    }
-  ],
-  "pinData": {},
-  "connections": {
-    "When clicking \"Execute Workflow\"": {
-      "main": [
-        [
-          {
-            "node": "Telegram CoPilot",
-            "type": "main",
-            "index": 0
-          }
-        ]
-      ]
-    }
-  },
-  "active": false,
-  "settings": {
-    "executionOrder": "v1"
-  },
-  "versionId": "96075904-f723-44ec-8b65-534cfe8839e0",
-  "id": "r2a0u5tez9fg1WW6",
-  "meta": {
-    "instanceId": "32a20ec023f2a976b4c2e7889abb5f086bbad4d306c491eaa0e6c36e60d7c363"
-  },
-  "tags": [
-    {
-      "createdAt": "2023-12-14T14:06:36.935Z",
-      "updatedAt": "2023-12-14T14:06:36.935Z",
-      "id": "fb6fD8yKePc2f6bo",
-      "name": "telepilot.co"
-    }
-  ]
-}
-]
+[
+	{
+  "name": "Telepilot getMe",
+  "nodes": [
+    {
+      "parameters": {},
+      "id": "6e65c321-a2c7-45a3-a2fd-7177535c994f",
+      "name": "When clicking \"Execute Workflow\"",
+      "type": "n8n-nodes-base.manualTrigger",
+      "typeVersion": 1,
+      "position": [
+        1200,
+        480
+      ]
+    },
+    {
+      "parameters": {
+        "resource": "user"
+      },
+      "id": "de0be3ef-35c3-45af-8fc1-c97c74b1f26e",
+      "name": "Telegram CoPilot",
+      "type": "@telepilotco/n8n-nodes-telepilot.telePilot",
+      "typeVersion": 1,
+      "position": [
+        1420,
+        480
+      ],
+      "credentials": {
+        "telePilotApi": {
+          "id": "5FLFyAUup96AgsvX",
+          "name": "Personal Telegram Co-Pilot account"
+        }
+      }
+    }
+  ],
+  "pinData": {},
+  "connections": {
+    "When clicking \"Execute Workflow\"": {
+      "main": [
+        [
+          {
+            "node": "Telegram CoPilot",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    }
+  },
+  "active": false,
+  "settings": {
+    "executionOrder": "v1"
+  },
+  "versionId": "96075904-f723-44ec-8b65-534cfe8839e0",
+  "id": "r2a0u5tez9fg1WW6",
+  "meta": {
+    "instanceId": "32a20ec023f2a976b4c2e7889abb5f086bbad4d306c491eaa0e6c36e60d7c363"
+  },
+  "tags": [
+    {
+      "createdAt": "2023-12-14T14:06:36.935Z",
+      "updatedAt": "2023-12-14T14:06:36.935Z",
+      "id": "fb6fD8yKePc2f6bo",
+      "name": "telepilot.co"
+    }
+  ]
+}
+]