jetrauserapi 1.0.0__tar.gz

jetrauserapi-1.0.0/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [1.0.0] - 2026-10-25
+
+### Added
+- Initial release
+- Login with phone number and OTP
+- Send and receive text messages in private chats (PV)
+- Send and receive text messages in groups
+- Get list of dialogs (users and groups)
+- Local SQLite database for message history
+- Auto-reconnect on connection loss
+- Event handlers (`on_message`, `on_ready`)
+- Auto-detection of peer type (user vs group)
+- 10 ready-to-run examples
+
+### Known Limitations
+- Sending media is blocked by the server
+- Deleting messages is blocked by the server
+- Group management is blocked by the server
+- Message history from server is blocked

jetrauserapi-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ali VEX
+
+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.

jetrauserapi-1.0.0/MANIFEST.in

@@ -0,0 +1,12 @@
+include README.md
+include LICENSE
+include requirements.txt
+include CHANGELOG.md
+
+recursive-include jetrauserapi *.py
+recursive-include examples *.py
+recursive-include examples *.md
+
+exclude data/*
+exclude archive/*
+exclude *.bin

jetrauserapi-1.0.0/PKG-INFO

@@ -0,0 +1,67 @@
+Metadata-Version: 2.4
+Name: jetrauserapi
+Version: 1.0.0
+Summary: A Python library for interacting with Jetra Messenger (User Account)
+Home-page: https://github.com/YOUR_USERNAME/JetraUserAPI
+Author: Ali VEX
+Author-email: Ali VEX <your-email@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/YOUR_USERNAME/JetraUserAPI
+Project-URL: Repository, https://github.com/YOUR_USERNAME/JetraUserAPI
+Project-URL: Issues, https://github.com/YOUR_USERNAME/JetraUserAPI/issues
+Keywords: jetra,messenger,api,client,telethon
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Communications :: Chat
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: websockets>=10.0
+Requires-Dist: pycryptodome>=3.15.0
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# JetraUserAPI
+
+[![Python](https://img.shields.io/badge/Python-3.10%2B-blue)](https://www.python.org/)
+[![License](https://img.shields.io/badge/License-MIT-green)](LICENSE)
+
+A Python library for interacting with **Jetra Messenger** using user accounts.
+
+Inspired by [Telethon](https://github.com/LonamiWebs/Telethon), JetraUserAPI provides a simple and clean API for automating Jetra Messenger.
+
+## Features
+
+- Login with phone number and OTP
+- Send and receive text messages in private chats (PV)
+- Send and receive text messages in groups
+- Get list of dialogs (users and groups)
+- Local SQLite database for message history
+- Auto-reconnect on connection loss
+- Event handlers (`on_message`, `on_ready`)
+- Auto-detection of peer type (user vs group)
+- Clean async/await API
+
+## Limitations
+
+The Jetra server blocks several operations for web clients:
+
+- Sending media (photos, videos, files)
+- Deleting messages
+- Group management (ban, admin)
+- Message history from server
+
+## Installation
+
+```bash
+git clone https://github.com/YOUR_USERNAME/JetraUserAPI.git
+cd JetraUserAPI
+pip install -e .

jetrauserapi-1.0.0/README.md

@@ -0,0 +1,36 @@
+# JetraUserAPI
+
+[![Python](https://img.shields.io/badge/Python-3.10%2B-blue)](https://www.python.org/)
+[![License](https://img.shields.io/badge/License-MIT-green)](LICENSE)
+
+A Python library for interacting with **Jetra Messenger** using user accounts.
+
+Inspired by [Telethon](https://github.com/LonamiWebs/Telethon), JetraUserAPI provides a simple and clean API for automating Jetra Messenger.
+
+## Features
+
+- Login with phone number and OTP
+- Send and receive text messages in private chats (PV)
+- Send and receive text messages in groups
+- Get list of dialogs (users and groups)
+- Local SQLite database for message history
+- Auto-reconnect on connection loss
+- Event handlers (`on_message`, `on_ready`)
+- Auto-detection of peer type (user vs group)
+- Clean async/await API
+
+## Limitations
+
+The Jetra server blocks several operations for web clients:
+
+- Sending media (photos, videos, files)
+- Deleting messages
+- Group management (ban, admin)
+- Message history from server
+
+## Installation
+
+```bash
+git clone https://github.com/YOUR_USERNAME/JetraUserAPI.git
+cd JetraUserAPI
+pip install -e .

jetrauserapi-1.0.0/examples/01_send_to_user.py

@@ -0,0 +1,33 @@
+"""
+Send a message to a specific user (PV).
+
+Usage:
+    python 01_send_to_user.py
+"""
+import sys
+import os
+sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+import asyncio
+from jetrauserapi import JetraClient
+from jetrauserapi.config import DEFAULT_SESSION_FILE, DEFAULT_DB_FILE
+
+
+async def main():
+    client = JetraClient(DEFAULT_SESSION_FILE, DEFAULT_DB_FILE)
+
+    # start() now waits until client is fully ready
+    await client.start()
+
+    user_id = 1780245516
+    message = "Hello from JetraUserAPI!"
+
+    print(f"Sending to user {user_id}...")
+    await client.send_message(user_id, message, peer_type="user")
+    print("Message sent successfully!")
+
+    await client.stop()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

jetrauserapi-1.0.0/examples/02_send_to_group.py

@@ -0,0 +1,32 @@
+"""
+Send a message to a group.
+
+Usage:
+    python 02_send_to_group.py
+"""
+import sys
+import os
+sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+import asyncio
+from jetrauserapi import JetraClient
+from jetrauserapi.config import DEFAULT_SESSION_FILE, DEFAULT_DB_FILE
+
+
+async def main():
+    client = JetraClient(DEFAULT_SESSION_FILE, DEFAULT_DB_FILE)
+
+    await client.start()
+
+    group_id = 2017
+    message = "Hello group!"
+
+    print(f"Sending to group {group_id}...")
+    await client.send_message(group_id, message, peer_type="group")
+    print("Message sent successfully!")
+
+    await client.stop()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

jetrauserapi-1.0.0/examples/03_send_to_saved.py

@@ -0,0 +1,31 @@
+"""
+Send a message to Saved Messages (yourself).
+
+Usage:
+    python 03_send_to_saved.py
+"""
+import sys
+import os
+sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+import asyncio
+from jetrauserapi import JetraClient
+from jetrauserapi.config import DEFAULT_SESSION_FILE, DEFAULT_DB_FILE
+
+
+async def main():
+    client = JetraClient(DEFAULT_SESSION_FILE, DEFAULT_DB_FILE)
+
+    await client.start()
+
+    message = "Note to self: buy milk"
+
+    print("Sending to Saved Messages...")
+    await client.send_to_saved(message)
+    print("Message sent successfully!")
+
+    await client.stop()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

jetrauserapi-1.0.0/examples/04_list_groups.py

@@ -0,0 +1,43 @@
+"""
+List all your groups.
+
+Usage:
+    python 04_list_groups.py
+"""
+import sys
+import os
+sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+import asyncio
+from jetrauserapi import JetraClient
+from jetrauserapi.config import DEFAULT_SESSION_FILE, DEFAULT_DB_FILE
+
+
+async def main():
+    client = JetraClient(DEFAULT_SESSION_FILE, DEFAULT_DB_FILE)
+
+    @client.on_ready
+    async def on_ready():
+        groups = await client.get_groups()
+
+        print(f"\nYou are a member of {len(groups)} groups:\n")
+        for i, g in enumerate(groups, 1):
+            print(f"  {i}. {g['title']}")
+            print(f"     ID: {g['peer_id']}")
+
+    await client.start()
+
+    try:
+        while True:
+            await asyncio.sleep(1)
+    except (KeyboardInterrupt, asyncio.CancelledError):
+        pass
+    finally:
+        await client.stop()
+
+
+if __name__ == "__main__":
+    try:
+        asyncio.run(main())
+    except KeyboardInterrupt:
+        print("\nGoodbye!")

jetrauserapi-1.0.0/examples/05_list_users.py

@@ -0,0 +1,43 @@
+"""
+List all your user contacts.
+
+Usage:
+    python 05_list_users.py
+"""
+import sys
+import os
+sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+import asyncio
+from jetrauserapi import JetraClient
+from jetrauserapi.config import DEFAULT_SESSION_FILE, DEFAULT_DB_FILE
+
+
+async def main():
+    client = JetraClient(DEFAULT_SESSION_FILE, DEFAULT_DB_FILE)
+
+    @client.on_ready
+    async def on_ready():
+        users = await client.get_users()
+
+        print(f"\nYou have {len(users)} users in your dialogs:\n")
+        for i, u in enumerate(users, 1):
+            print(f"  {i}. {u['title']}")
+            print(f"     ID: {u['peer_id']}")
+
+    await client.start()
+
+    try:
+        while True:
+            await asyncio.sleep(1)
+    except (KeyboardInterrupt, asyncio.CancelledError):
+        pass
+    finally:
+        await client.stop()
+
+
+if __name__ == "__main__":
+    try:
+        asyncio.run(main())
+    except KeyboardInterrupt:
+        print("\nGoodbye!")

jetrauserapi-1.0.0/examples/06_get_history.py

@@ -0,0 +1,36 @@
+"""
+Get message history from local database.
+
+Usage:
+    python 06_get_history.py
+"""
+import sys
+import os
+sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+import asyncio
+from jetrauserapi import JetraClient
+from jetrauserapi.config import DEFAULT_SESSION_FILE, DEFAULT_DB_FILE
+
+
+async def main():
+    client = JetraClient(DEFAULT_SESSION_FILE, DEFAULT_DB_FILE)
+    await client.start()
+
+    print("\nLast 10 messages from all chats:\n")
+    history = client.get_history(limit=10)
+
+    for msg in history:
+        print(f"  [{msg['peer_type']}] From {msg['from_id']}: {msg['text']}")
+
+    print("\n\nLast 5 messages from group 2017:\n")
+    history = client.get_history(peer_id=2017, limit=5)
+
+    for msg in history:
+        print(f"  {msg['text']}")
+
+    await client.stop()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

jetrauserapi-1.0.0/examples/07_listen_messages.py

@@ -0,0 +1,44 @@
+"""
+Listen for all incoming messages and print them.
+
+Usage:
+    python 07_listen_messages.py
+"""
+import sys
+import os
+sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+import asyncio
+from jetrauserapi import JetraClient
+from jetrauserapi.config import DEFAULT_SESSION_FILE, DEFAULT_DB_FILE
+
+
+async def main():
+    client = JetraClient(DEFAULT_SESSION_FILE, DEFAULT_DB_FILE)
+
+    @client.on_message
+    async def on_message(message):
+        peer_label = "PV" if message.is_private else "Group"
+
+        print(f"\n[{peer_label}]")
+        print(f"  From: {message.from_id}")
+        print(f"  Time: {message.date_str}")
+        print(f"  Text: {message.text}")
+
+    print("Listening for messages... Press Ctrl+C to stop.")
+    await client.start()
+
+    try:
+        while True:
+            await asyncio.sleep(1)
+    except (KeyboardInterrupt, asyncio.CancelledError):
+        pass
+    finally:
+        await client.stop()
+
+
+if __name__ == "__main__":
+    try:
+        asyncio.run(main())
+    except KeyboardInterrupt:
+        print("\nGoodbye!")

jetrauserapi-1.0.0/examples/08_echo_bot.py

@@ -0,0 +1,42 @@
+"""
+Echo bot: replies with the same message it receives.
+
+Usage:
+    python 08_echo_bot.py
+"""
+import sys
+import os
+sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+import asyncio
+from jetrauserapi import JetraClient
+from jetrauserapi.config import DEFAULT_SESSION_FILE, DEFAULT_DB_FILE
+
+
+async def main():
+    client = JetraClient(DEFAULT_SESSION_FILE, DEFAULT_DB_FILE)
+
+    @client.on_message
+    async def on_message(message):
+        print(f"Received: {message.text}")
+        reply = f"Echo: {message.text}"
+        await client.send_message(message.peer_id, reply)
+        print(f"Replied: {reply}")
+
+    print("Echo bot is running... Press Ctrl+C to stop.")
+    await client.start()
+
+    try:
+        while True:
+            await asyncio.sleep(1)
+    except (KeyboardInterrupt, asyncio.CancelledError):
+        pass
+    finally:
+        await client.stop()
+
+
+if __name__ == "__main__":
+    try:
+        asyncio.run(main())
+    except KeyboardInterrupt:
+        print("\nGoodbye!")

jetrauserapi-1.0.0/examples/09_command_bot.py

@@ -0,0 +1,61 @@
+"""
+A bot that responds to specific commands like /start, /help, /ping.
+
+Usage:
+    python 09_command_bot.py
+"""
+import sys
+import os
+sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+import asyncio
+from jetrauserapi import JetraClient
+from jetrauserapi.config import DEFAULT_SESSION_FILE, DEFAULT_DB_FILE
+
+
+async def main():
+    client = JetraClient(DEFAULT_SESSION_FILE, DEFAULT_DB_FILE)
+
+    @client.on_message
+    async def on_message(message):
+        text = message.text.strip().lower()
+
+        if text == "/start":
+            reply = "Hello! I am a Jetra bot.\nUse /help to see commands."
+            await client.send_message(message.peer_id, reply)
+
+        elif text == "/help":
+            reply = (
+                "Available commands:\n"
+                "/start - Start the bot\n"
+                "/help - Show this message\n"
+                "/ping - Test bot response\n"
+                "/time - Show current time"
+            )
+            await client.send_message(message.peer_id, reply)
+
+        elif text == "/ping":
+            await client.send_message(message.peer_id, "pong")
+
+        elif text == "/time":
+            import datetime
+            now = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+            await client.send_message(message.peer_id, f"Current time: {now}")
+
+    print("Command bot is running... Press Ctrl+C to stop.")
+    await client.start()
+
+    try:
+        while True:
+            await asyncio.sleep(1)
+    except (KeyboardInterrupt, asyncio.CancelledError):
+        pass
+    finally:
+        await client.stop()
+
+
+if __name__ == "__main__":
+    try:
+        asyncio.run(main())
+    except KeyboardInterrupt:
+        print("\nGoodbye!")

jetrauserapi-1.0.0/examples/10_auto_reply.py

@@ -0,0 +1,57 @@
+"""
+Auto-reply bot with keyword-based responses.
+
+Usage:
+    python 10_auto_reply.py
+"""
+import sys
+import os
+sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+import asyncio
+from jetrauserapi import JetraClient
+from jetrauserapi.config import DEFAULT_SESSION_FILE, DEFAULT_DB_FILE
+
+
+# Keyword-based responses
+RESPONSES = {
+    "hello": "Hi there! How can I help you?",
+    "hi": "Hello!",
+    "bye": "Goodbye! See you later.",
+    "thanks": "You're welcome!",
+    "ping": "pong",
+    "how are you": "I'm just a bot, but I'm doing great!",
+}
+
+
+async def main():
+    client = JetraClient(DEFAULT_SESSION_FILE, DEFAULT_DB_FILE)
+
+    @client.on_message
+    async def on_message(message):
+        text_lower = message.text.strip().lower()
+
+        # Find matching response
+        for keyword, response in RESPONSES.items():
+            if keyword in text_lower:
+                await client.send_message(message.peer_id, response)
+                print(f"Auto-replied to '{message.text}' with '{response}'")
+                break
+
+    print("Auto-reply bot is running... Press Ctrl+C to stop.")
+    await client.start()
+
+    try:
+        while True:
+            await asyncio.sleep(1)
+    except (KeyboardInterrupt, asyncio.CancelledError):
+        pass
+    finally:
+        await client.stop()
+
+
+if __name__ == "__main__":
+    try:
+        asyncio.run(main())
+    except KeyboardInterrupt:
+        print("\nGoodbye!")

jetrauserapi-1.0.0/examples/README.md

@@ -0,0 +1,10 @@
+# JetraUserAPI Examples
+
+Short, ready-to-run examples for the JetraUserAPI library.
+
+## Prerequisites
+
+You must be logged in first:
+
+```bash
+python login.py