python-trueconf-bot 1.2.0b1__py3-none-any.whl → 1.2.0b2__py3-none-any.whl

{python_trueconf_bot-1.2.0b1.dist-info → python_trueconf_bot-1.2.0b2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-trueconf-bot
-Version: 1.2.0b1
+Version: 1.2.0b2
 Summary: Lightweight and powerful framework for the TrueConf Server Chatbot API
 Author-email: TrueConf LLC <info@trueconf.com>, Anton Baadzhi <baadzhianton@gmail.com>
 License-Expression: BSD-3-Clause-Clear
@@ -77,6 +77,23 @@ Dynamic: license-file
 > 
 > We were inspired by the popular [aiogram](https://github.com/aiogram/aiogram/) library, so, the transition will be **simple** for developers already familiar with this library.
 
+---
+
+## 📦 Version Compatibility
+
+| TrueConf Server Version | Required Library Version |
+|:------------------------|:-------------------------|
+| < 5.5.0                 | ❌ Not supported         |
+| 5.5.0 — 5.5.2           | v1.1.x                   |
+| >= 5.5.3                | **v1.2.0** (or higher)   |
+
+> ⚠️ IMPORTANT
+> 
+> If you are using server version **5.5.3** or higher, you must upgrade the library. If the stable release is not yet available, install the latest beta:
+> ```bash
+> uv pip install --pre "python-trueconf-bot>=1.2.0b0"
+> ```
+
 ## 📌 Key Features
 
 * Easy integration with the [TrueConf Server Chatbot API](https://trueconf.com/docs/chatbot-connector/en/overview/)

{python_trueconf_bot-1.2.0b1.dist-info → python_trueconf_bot-1.2.0b2.dist-info}/RECORD

@@ -1,11 +1,11 @@
-python_trueconf_bot-1.2.0b1.dist-info/licenses/LICENSE,sha256=ftDuEzhr-yY_dsfpEQ2SKAP_dEAO-iPt96MBZq_K48o,1684
+python_trueconf_bot-1.2.0b2.dist-info/licenses/LICENSE,sha256=ftDuEzhr-yY_dsfpEQ2SKAP_dEAO-iPt96MBZq_K48o,1684
 trueconf/__init__.py,sha256=JRFC0ca_JhwlDuzcnZ1r9bflnAmQyMYhJr_hBRYcdpw,394
-trueconf/_version.py,sha256=e-_7z50FAHqdTfPkm-_QSv76KW6AuWHjM_bkQ956deE,528
+trueconf/_version.py,sha256=ZjrumRj9rT0zIxBYOWkwYCDiswIhQcklxX-StaUjgb0,528
 trueconf/exceptions.py,sha256=dtY54xAdatBxmQlUy3moGpeMVz2NOKHIKPIOrX7MyHQ,500
 trueconf/loggers.py,sha256=dOAwgGLPcrmD6aZI5jA3J9eMunbbOAvPRguk6zWMcNo,125
 trueconf/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 trueconf/client/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-trueconf/client/bot.py,sha256=gP6Dm1gmP-NO1poAyPLmuSiz_OhqdTbuH4mSlFGbAhY,58022
+trueconf/client/bot.py,sha256=Baoz3F1mgmhYxM_-WYLuo9YIMXThV1I5IHvgvTXMuOU,61401
 trueconf/client/context_controller.py,sha256=_aItNHblyFbEqRsnbOM3ESgPqg2Pkji7xidTx0gb6zk,660
 trueconf/client/session.py,sha256=CvHjxQXbkUyyS1r7YCFVL8al37zOYtnhw5ACNLJJDOc,1751
 trueconf/dispatcher/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -52,8 +52,8 @@ trueconf/methods/get_user_display_name.py,sha256=36-vbHICcofZYpLgurSFoE8IOP51yWJ
 trueconf/methods/has_chat_participant.py,sha256=BsDV_9GfLLBDuA-pmQdFXykOcXf3PLFSqgxhlDC1nV4,598
 trueconf/methods/remove_chat.py,sha256=sEPVf645wOey6U5M66-nTwsWvYcOmAHjFAz7TzXsO4A,497
 trueconf/methods/remove_message.py,sha256=mWhpF5INT6LHxnAyIqTKpinKB_8whj-H8EXXzuMpJHY,612
-trueconf/methods/remove_participant_from_chat.py,sha256=LCxlTxsBm-AZ0mtTyVtt_siWZ1J-HBPkL0opStcuyls,651
-trueconf/methods/send_file.py,sha256=7HXD0S3s4EReAxzbbvobYh4X7cuYwdemufXosmXbj6E,932
+trueconf/methods/remove_participant_from_chat.py,sha256=KwBUD52Hulh2FqDIkdcZ-wRknzDxxxw2aTO5MvbpE_4,723
+trueconf/methods/send_file.py,sha256=6BM1zdPWkKVFFT_gTCqHZUk0qHowz3VkJrYlRCPGKT0,1018
 trueconf/methods/send_message.py,sha256=MYjKUQvqD3li_QyuyTQnC3YOg5050gE2qXxDVc_pvuk,816
 trueconf/methods/send_survey.py,sha256=HI6gCICQofkPyfZGsd2idX1ZK5-txvCHa6VZgFaOBPY,1275
 trueconf/methods/subscribe_file_progress.py,sha256=3zVqz13Z9KNcPMm13fcX6VpRXKxiIm0-b8x_C_BDxTg,598
@@ -128,7 +128,7 @@ trueconf/types/responses/upload_file_response.py,sha256=CmhLmby4MVny8KmfQ1aHW6UD
 trueconf/utils/__init__.py,sha256=6CrEznKfUTDKL0IH-CNJJOOW-Vx22aokR7tmHORyUUU,135
 trueconf/utils/generate_secret_for_survey.py,sha256=_rJttL9lsY3zeVxAzV5iSnHLRFslIBvYzj_qn03xMh8,241
 trueconf/utils/token.py,sha256=WZWiYH3mQsltPoKgF9szVb1R-rxPZYqs3-GPS1WXb0Q,2305
-python_trueconf_bot-1.2.0b1.dist-info/METADATA,sha256=Q-n7e6YNo-uBlEpFp57E5kfryhWH2jumxrzot3Rp2zg,5126
-python_trueconf_bot-1.2.0b1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-python_trueconf_bot-1.2.0b1.dist-info/top_level.txt,sha256=GjgYdn_osTUuU-H8f59VhIS7MY44xLV7-D7veywJaeY,9
-python_trueconf_bot-1.2.0b1.dist-info/RECORD,,
+python_trueconf_bot-1.2.0b2.dist-info/METADATA,sha256=I7si5S2Jqumkhr1LGlvC1ychLv0aKZoXCZbj0omTlSY,5688
+python_trueconf_bot-1.2.0b2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+python_trueconf_bot-1.2.0b2.dist-info/top_level.txt,sha256=GjgYdn_osTUuU-H8f59VhIS7MY44xLV7-D7veywJaeY,9
+python_trueconf_bot-1.2.0b2.dist-info/RECORD,,

trueconf/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '1.2.0b1'
-__version_tuple__ = version_tuple = (1, 2, 0, 'b1')
+__version__ = version = '1.2.0b2'
+__version_tuple__ = version_tuple = (1, 2, 0, 'b2')
 
 __commit_id__ = commit_id = None

trueconf/client/bot.py

@@ -5,9 +5,9 @@ import httpx
 import json
 import signal
 import ssl
-import tempfile
 import websockets
 import warnings
+import random
 from pathlib import Path
 from aiohttp import ClientSession, ClientTimeout, TCPConnector, FormData
 from async_property import async_cached_property
@@ -97,23 +97,20 @@ from trueconf.utils import validate_token
 
 T = TypeVar("T")
 
-class TokenOpts(TypedDict, total=False):
-    web_port: int
-    https: bool
-
-
 class Bot:
     def __init__(
             self,
             server: str,
             token: str,
-            web_port: int = 443,
-            https: bool = True,
-            debug: bool = False,
-            verify_ssl: bool = True,
+            *,
             dispatcher: Dispatcher | None = None,
             receive_unread_messages: bool = False,
-            receive_system_messages: bool = False,
+            verify_ssl: bool = True,
+            web_port: int | None = None,
+            https: bool = True,
+            ws_max_retries: int = 5,
+            ws_max_delay: int = 60,
+            debug: bool = False,
     ):
         """
         Initializes a TrueConf chatbot instance with WebSocket connection and configuration options.
@@ -124,13 +121,15 @@ class Bot:
         Args:
             server (str): Address of the TrueConf server.
             token (str): Bot authorization token.
+            * : All following arguments must be passed by name (keyword-only).
+            dispatcher (Dispatcher | None, optional): Dispatcher instance for registering handlers.
+            receive_unread_messages (bool, optional): Whether to receive unread messages on connection. Defaults to False.
+            verify_ssl (bool, optional): Whether to verify the server's SSL certificate. Defaults to True.
             web_port (int, optional): WebSocket connection port. Defaults to 443.
             https (bool, optional): Whether to use HTTPS protocol. Defaults to True.
+            ws_max_retries (int, optional): Max connection attempts on network/IP errors before giving up. Defaults to 5.
+            ws_max_delay (int, optional): Maximum delay between reconnection attempts (in seconds). Defaults to 60.
             debug (bool, optional): Enables debug mode. Defaults to False.
-            verify_ssl (bool, optional): Whether to verify the server's SSL certificate. Defaults to True.
-            dispatcher (Dispatcher | None, optional): Dispatcher instance for registering handlers.
-            receive_unread_messages (bool, optional): Whether to receive unread messages on connection. Defaults to False.
-            receive_system_messages (bool, optional): Whether to receive system messages on connection. Defaults to False.
 
         Note:
             Alternatively, you can authorize using a username and password via the `from_credentials()` class method.
@@ -140,28 +139,27 @@ class Bot:
 
         self.server = server
         self.__token = token
-        self.web_port = web_port
+        self.dp = dispatcher or Dispatcher()
+        self.receive_unread_messages = receive_unread_messages
+        self.verify_ssl = verify_ssl
         self.https = https
+        self._ws_max_retries = ws_max_retries
+        self._ws_max_delay = ws_max_delay
         self.debug = debug
+
         self.connected_event = asyncio.Event()
         self.authorized_event = asyncio.Event()
         self._session: WebSocketSession | None = None
         self._connect_task: asyncio.Task | None = None
         self.stopped_event = asyncio.Event()
-        self.dp = dispatcher or Dispatcher()
         self._protocol = "https" if self.https else "http"
-        self.port = 443 if self.https else self.web_port
-        self.receive_unread_messages = receive_unread_messages
-        self.receive_system_messages = receive_system_messages
-        self._url_for_upload_files = (
-            f"{self._protocol}://{self.server}:{self.port}/bridge/api/client/v1/files"
-        )
-        self.verify_ssl = verify_ssl
+        if web_port is None:
+            self.port = 443 if self.https else 4309
+        else:
+            self.port = web_port
         self._progress_queues: Dict[str, asyncio.Queue] = {}
-
         self._futures: Dict[int, asyncio.Future] = {}
         self._handlers: List[Tuple[dict, Callable[[dict], Awaitable]]] = []
-
         self._stop = False
         self._ws = None
 
@@ -169,16 +167,23 @@ class Bot:
         return await method(self)
 
     async def __get_domain_name(self):
-        url = f"{self._protocol}://{self.server}:{self.port}/api/v4/server"
-
         try:
             async with httpx.AsyncClient(verify=self.verify_ssl, timeout=5) as client:
-                response = await client.get(url)
+                response = await client.get(f"{self._protocol}://{self.server}:{self.port}/api/v4/server")
                 return response.json().get("product").get("display_name")
         except Exception as e:
             loggers.chatbot.error(f"Failed to get server domain_name: {e}")
             return None
 
+    async def __get_server_version(self):
+        try:
+            async with httpx.AsyncClient(verify=self.verify_ssl, timeout=5) as client:
+                response = await client.get(f"{self._protocol}://{self.server}:{self.port}/api/v4/server")
+                return response.json().get("product").get("version")
+        except Exception as e:
+            loggers.chatbot.error(f"Failed to get server version: {e}")
+            return None
+
     @property
     def token(self) -> str:
         """
@@ -201,6 +206,34 @@ class Bot:
 
         return await self.__get_domain_name()
 
+    @async_cached_property
+    async def server_version(self) -> str:
+        """
+        Returns the domain name of the TrueConf server.
+
+        Returns:
+            str: Domain name of the connected server.
+        """
+
+        return await self.__get_server_version()
+
+    async def check_version(self):
+        current_version = await self.server_version
+        v = tuple(map(int, current_version.split('.')[:3]))
+
+        if v < (5, 5, 0):
+            raise RuntimeError(
+                f"Error: Server version {current_version} is too old. "
+                "Chatbots are not supported (version 5.5.0+ required)."
+            )
+
+        if (5, 5, 0) <= v <= (5, 5, 2):
+            raise RuntimeError(
+                f"\n[!] Server version {current_version} is incompatible with the current library.\n"
+                "Please install version v1.1.x using the following command:\n"
+                'uv pip install "python-trueconf-bot>=1.1.0,<1.2.0"'
+            )
+
     @async_cached_property
     async def me(self) -> str:
         """
@@ -222,11 +255,14 @@ class Bot:
             server: str,
             username: str,
             password: str,
+            *,
             dispatcher: Dispatcher | None = None,
             receive_unread_messages: bool = False,
-            receive_system_messages: bool = False,
             verify_ssl: bool = True,
-            **token_opts: Unpack[TokenOpts],
+            web_port: int | None = None,
+            https: bool = True,
+            ws_max_retries: int = 5,
+            ws_max_delay: int = 60,
     ) -> Self:
         """
         Creates a bot instance using username and password authentication.
@@ -238,11 +274,14 @@ class Bot:
             server (str): Address of the TrueConf server.
             username (str): Username for authentication.
             password (str): Password for authentication.
+            * : All following arguments must be passed by name (keyword-only).
             dispatcher (Dispatcher | None, optional): Dispatcher instance for registering handlers.
             receive_unread_messages (bool, optional): Whether to receive unread messages on connection. Defaults to False.
-            receive_system_messages (bool, optional): Whether to receive system messages on connection. Defaults to False.
             verify_ssl (bool, optional): Whether to verify the server's SSL certificate. Defaults to True.
-            **token_opts: Additional options passed to the token request, such as `web_port` and `https`.
+            web_port (int, optional): WebSocket connection port. Defaults to 443.
+            https (bool, optional): Whether to use HTTPS protocol. Defaults to True.
+            ws_max_retries (int, optional): Max connection attempts on network/IP errors before giving up. Defaults to 5.
+            ws_max_delay (int, optional): Maximum delay between reconnection attempts (in seconds). Defaults to 60.
 
         Returns:
             Bot: An authorized bot instance.
@@ -255,14 +294,15 @@ class Bot:
         if not token:
             raise RuntimeError("Failed to obtain token")
         return cls(
-            server=server,
-            token=token,
+            server,
+            token,
+            web_port=web_port,
+            https=https,
             dispatcher=dispatcher,
             receive_unread_messages=receive_unread_messages,
-            receive_system_messages=receive_system_messages,
             verify_ssl=verify_ssl,
-            web_port=token_opts.get("web_port", 443),
-            https=token_opts.get("https", True),
+            ws_max_delay=ws_max_delay,
+            ws_max_retries=ws_max_retries
         )
 
     async def __wait_upload_complete(
@@ -300,46 +340,48 @@ class Bot:
             dest_path: str | Path | None = None,
             timeout: int = 60,
             chunk_size: int = 64 * 1024,
-    ) -> bytes | None:
+    ) -> bytes | Path | None:
 
         """
-        Asynchronously download file by URL and save it to disk.
-
-        If `dest_path` isn't provided, a temporary file will be created (similar to aiogram.File.download()).
-
-        Args:
-            url: Direct download URL.
-            dest_path: Destination path; if None, a NamedTemporaryFile will be created and returned.
-            timeout: Request timeout (seconds).
-            chunk_size: Stream chunk size in bytes.
+        Asynchronously download a file from the server by URL.
 
+         Args:
+            url (str): Direct download URL.
+            file_name (str): Name of the file to be saved.
+            dest_path (str | Path | None): Destination path on disk.
+                If None, the file will be downloaded into memory. Defaults to None.
+            timeout (int): Request timeout in seconds. Defaults to 60.
+            chunk_size (int): Stream chunk size in bytes. Defaults to 65536 (64 KB).
 
         Returns:
-            Path | None: Path to saved file, or None on error.
+            bytes | Path | None:
+                - bytes: if `dest_path` is None (file in memory).
+                - Path: if the file was successfully saved to disk.
+                - None: if an error occurred during download or saving.
         """
-
+        dest = None
         try:
             async with httpx.AsyncClient(verify=self.verify_ssl, timeout=httpx.Timeout(timeout)) as client:
                 async with client.stream("GET", url) as resp:
                     resp.raise_for_status()
+
                     if dest_path is None:
                         chunks = []
                         async for chunk in resp.aiter_bytes(chunk_size):
                             chunks.append(chunk)
                         return b"".join(chunks)
 
-                    else:
-                        dest = Path(dest_path) / file_name
-                        dest.parent.mkdir(parents=True, exist_ok=True)
+                    dest = Path(dest_path) / file_name
+                    dest.parent.mkdir(parents=True, exist_ok=True)
 
-                        async with aiofiles.open(dest, "wb") as f:
-                            async for chunk in resp.aiter_bytes(chunk_size):
-                                await f.write(chunk)
-                        return None
+                    async with aiofiles.open(dest, "wb") as f:
+                        async for chunk in resp.aiter_bytes(chunk_size):
+                            await f.write(chunk)
+                    return dest
         except Exception as e:
             loggers.chatbot.error(f"Failed to download file from {url}: {e}")
-            with contextlib.suppress(Exception):
-                if dest.exists():
+            if dest and dest.exists():
+                with contextlib.suppress(Exception):
                     dest.unlink()
             return None
 
@@ -348,7 +390,7 @@ class Bot:
             file: InputFile,
             preview: InputFile | None = None,
             is_sticker: bool = False,
-            timeout: int = 60,
+            timeout: float = 60.0,
     ) -> str:
         """
            Uploads a file to the server and returns a temporary file identifier (temporalFileId).
@@ -371,7 +413,7 @@ class Bot:
                file (InputFile): The primary file to upload.
                preview (InputFile | None, optional): Optional preview file (default is None).
                is_sticker (bool, optional): Whether the uploaded file is a sticker (affects MIME type). Defaults to False.
-               timeout (int, optional): Upload timeout in seconds. Defaults to 60.
+               timeout (float, optional): Upload timeout in seconds. Defaults to 60.
 
            Returns:
                str | None: A temporary file ID (`temporalFileId`) on success, or None if the upload failed.
@@ -390,8 +432,6 @@ class Bot:
 
         }
 
-        timeout = ClientTimeout(total=timeout)
-
         if not self.verify_ssl:
             ssl_context = ssl.create_default_context()
             ssl_context.check_hostname = False
@@ -401,7 +441,7 @@ class Bot:
             connector = TCPConnector()
 
         try:
-            async with ClientSession(connector=connector, timeout=timeout) as session:
+            async with ClientSession(connector=connector, timeout=ClientTimeout(total=timeout)) as session:
                 data = FormData(quote_fields=False)
                 data.add_field(
                     name="file",
@@ -418,7 +458,11 @@ class Bot:
                         content_type=preview.mime_type
                     )
 
-                async with session.post(self._url_for_upload_files, headers=headers, data=data) as response:
+                async with session.post(
+                        url=f"{self._protocol}://{self.server}:{self.port}/bridge/api/client/v1/files",
+                        headers=headers,
+                        data=data
+                ) as response:
                      result = await response.json()
             return result.get("temporalFileId")
         except Exception as e:
@@ -438,18 +482,31 @@ class Bot:
 
     async def __connect_and_listen(self):
         ssl_context = None
+        delay = 1
+        retry_count = 0
+
         if self.https:
+            ws_protocol = "wss"
             if self.verify_ssl:
                 ssl_context = ssl.create_default_context()
             else:
                 ssl_context = ssl._create_unverified_context()
-
-        uri = f"wss://{self.server}:{self.web_port}/websocket/chat_bot" if self.https else f"ws://{self.server}:{self.web_port}/websocket/chat_bot"
+        else:
+            ws_protocol = "ws"
 
         while not self._stop:
             try:
+                if delay > 1 or retry_count > 0:
+                    await asyncio.sleep(delay)
                 loggers.chatbot.info("⏳ Attempting WebSocket connection...")
-                async with websockets.connect(uri, ssl=ssl_context, ping_interval=30, ping_timeout=10) as ws:
+                async with websockets.connect(
+                        uri=f"{ws_protocol}://{self.server}:{self.port}/websocket/chat_bot",
+                        ssl=ssl_context,
+                        ping_interval=30,
+                        ping_timeout=10
+                ) as ws:
+                    delay = 1
+                    retry_count = 0
                     self._ws = ws
                     loggers.chatbot.info("✅ WebSocket connected")
 
@@ -473,12 +530,36 @@ class Bot:
                 loggers.chatbot.info("🛑 Connect loop cancelled, performing cleanup.")
                 raise
 
-            except websockets.exceptions.ConnectionClosed as e:
-                loggers.chatbot.warning(
-                    f"🔌 Connection closed: {getattr(e, 'code', '?')} – {getattr(e, 'reason', '?')}. Retrying...")
+            except (websockets.exceptions.ConnectionClosed, websockets.exceptions.InvalidStatus, OSError) as e:
                 self.connected_event.clear()
                 self.authorized_event.clear()
-                await asyncio.sleep(0.5)
+
+                if isinstance(e, websockets.exceptions.ConnectionClosed):
+                    close_info = e.rcvd or e.sent
+                    code = close_info.code if close_info else "?"
+                    reason = close_info.reason if close_info else "no reason"
+                    reason = f"Code: {code} ({reason})"
+                else:
+                    reason = str(e)
+
+                delay = min(delay * 2, self._ws_max_delay) + random.uniform(0, 1)
+                msg = f"🔌 Connection issue: {reason}. Retrying in {delay:.1f}s..."
+                loggers.chatbot.warning(msg)
+                print(msg)
+                continue
+
+            except websockets.exceptions.InvalidURI as e:
+                retry_count += 1
+                self.connected_event.clear()
+
+                if retry_count > self._ws_max_retries:
+                    loggers.chatbot.error(f"❌ Critical network error: {e}. Check your URI/IP. Giving up.")
+                    raise ConnectionError(f"Failed to connect after {self._ws_max_retries} attempts: {e}") from e
+
+                delay = 5
+                msg = f"⚠️ Cant reach server: {e}. Attempt {retry_count}/{self._ws_max_retries}. Retrying in {delay}s..."
+                loggers.chatbot.warning(msg)
+                print(msg)
                 continue
 
             finally:
@@ -744,50 +825,41 @@ class Bot:
         call = RemoveChat(chat_id=chat_id)
         return await self(call)
 
-    async def download_file_by_id(self, file_id, dest_path: str = None) -> Path | None:
+    async def download_file_by_id(self, file_id, dest_path: str | Path | None = None) ->  bytes | Path | None:
         """
         Downloads a file by its ID, waiting for the upload to complete if necessary.
 
-        If the file is already in the READY state, it will be downloaded immediately.
-        If the file is in the NOT_AVAILABLE state, the method will exit without downloading.
-        In other cases, the bot will wait for the upload to finish and then attempt to download the file.
+        If `dest_path` is provided, the file is saved to disk and the Path is returned.
+        If `dest_path` is None, the file content is returned as bytes.
 
         Args:
             file_id (str): Unique identifier of the file on the server.
-            dest_path (str, optional): Path where the file should be saved.
-                If not specified, a temporary file will be created using `NamedTemporaryFile`
-                (with prefix `tc_dl_`, suffix set to the original file name, and `delete=False` to keep the file on disk).
+            dest_path (str | Path, optional): Path where the file should be saved.
 
         Returns:
-            Path | None: Path to the downloaded file, or None if the download failed.
+            bytes | Path | None: File content (bytes), path to file (Path), or None if failed.
         """
 
         info = await self.get_file_info(file_id)
 
-        if info.ready_state == FileReadyState.READY:
-            return await self.__download_file_from_server(
-                url=info.download_url,
-                file_name=info.name,
-                dest_path=dest_path,
-            )
-
         if info.ready_state == FileReadyState.NOT_AVAILABLE:
             loggers.chatbot.warning(f"File {file_id} is NOT_AVAILABLE")
             return None
 
-        ok = await self.__wait_upload_complete(file_id, expected_size=info.size, timeout=None)
-        if not ok:
-            loggers.chatbot.error(f"Wait upload complete failed for {file_id}")
-            return None
-
-        for _ in range(20):
-            info = await self.get_file_info(file_id)
-            if info.ready_state == FileReadyState.READY:
-                break
-            await asyncio.sleep(1)
-        else:
-            loggers.chatbot.warning(f"File {file_id} didn’t reach READY in time")
-            return None
+        if info.ready_state != FileReadyState.READY:
+            ok = await self.__wait_upload_complete(file_id, expected_size=info.size, timeout=None)
+            if not ok:
+                loggers.chatbot.error(f"Wait upload complete failed for {file_id}")
+                return None
+
+            for _ in range(20):
+                info = await self.get_file_info(file_id)
+                if info.ready_state == FileReadyState.READY:
+                    break
+                await asyncio.sleep(1)
+            else:
+                loggers.chatbot.warning(f"File {file_id} didn’t reach READY in time")
+                return None
 
         return await self.__download_file_from_server(
             url=info.download_url,
@@ -1133,7 +1205,10 @@ class Bot:
         return await self(call)
 
     async def remove_participant_from_chat(
-            self, chat_id: str, user_id: str
+            self,
+            chat_id: str,
+            user_id: str,
+            clear_history: bool = False
     ) -> RemoveChatParticipantResponse:
         """
         Removes a participant from the specified chat.
@@ -1144,6 +1219,7 @@ class Bot:
         Args:
             chat_id (str): Identifier of the chat to remove the participant from.
             user_id (str): Identifier of the user to be removed.
+            clear_history (bool, optional): If True, the chat history will be cleared for the removed participant. Defaults to False.
 
         Returns:
             RemoveChatParticipantResponse: Object containing the result of the participant removal.
@@ -1152,7 +1228,7 @@ class Bot:
         if "@" not in user_id:
             user_id = f"{user_id}@{await self.server_name}"
 
-        call = RemoveChatParticipant(chat_id=chat_id, user_id=user_id)
+        call = RemoveChatParticipant(chat_id=chat_id, user_id=user_id, clear_history=clear_history)
         return await self(call)
 
     async def reply_message(
@@ -1476,6 +1552,7 @@ class Bot:
         Returns:
             None
         """
+        await self.check_version()
         if self._connect_task and not self._connect_task.done():
             return
         self._stop = False

trueconf/methods/remove_participant_from_chat.py

@@ -12,6 +12,7 @@ class RemoveChatParticipant(TrueConfMethod[RemoveChatParticipantResponse]):
 
     chat_id: str
     user_id: str
+    clear_history: bool
 
     def __post_init__(self):
         super().__init__()
@@ -19,5 +20,6 @@ class RemoveChatParticipant(TrueConfMethod[RemoveChatParticipantResponse]):
     def payload(self):
         return {
             "chatId": self.chat_id,
-            "userId": self.user_id
+            "userId": self.user_id,
+            "clearHistory": self.clear_history
         }

trueconf/methods/send_file.py

@@ -20,14 +20,20 @@ class SendFile(TrueConfMethod[SendFileResponse]):
         super().__init__()
 
     def payload(self):
-        return {
+        data = {
             "chatId": self.chat_id,
-            "replyMessageId": self.reply_message_id,
             "content": {
-                "temporalFileId": self.temporal_file_id,
-                "caption":{
-                    "text": self.text,
-                    "parseMode": self.parse_mode,
-                }
+                "temporalFileId": self.temporal_file_id
             }
         }
+
+        if self.reply_message_id:
+            data["replyMessageId"] = self.reply_message_id
+
+        if self.text:
+            data["content"]["caption"] = {
+                "text": self.text,
+                "parseMode": self.parse_mode
+            }
+
+        return data