jetrauserapi 1.0.0__py3-none-any.whl

jetrauserapi/tl_builder.py

@@ -0,0 +1,105 @@
+import struct
+
+def tl_bytes(data: bytes) -> bytes:
+    """Serialize bytes with TL length prefix"""
+    n = len(data)
+    if n <= 253:
+        buf = bytes([n]) + data
+    else:
+        buf = b'\xfe' + n.to_bytes(3, 'little') + data
+    return buf + b'\x00' * ((4 - len(buf) % 4) % 4)
+
+def tl_string(s: str) -> bytes:
+    """Serialize a string as TL bytes"""
+    return tl_bytes(s.encode('utf-8'))
+
+def tl_int(n: int) -> bytes:
+    """Serialize a 32-bit signed integer"""
+    return struct.pack("<i", n)
+
+def tl_uint(n: int) -> bytes:
+    """Serialize a 32-bit unsigned integer"""
+    return struct.pack("<I", n)
+
+def tl_long(n: int) -> bytes:
+    """Serialize a 64-bit signed integer"""
+    return struct.pack("<q", n)
+
+def tl_ulong(n: int) -> bytes:
+    """Serialize a 64-bit unsigned integer"""
+    return struct.pack("<Q", n)
+
+def tl_double(d: float) -> bytes:
+    """Serialize a 64-bit float"""
+    return struct.pack("<d", d)
+
+def tl_bool(b: bool) -> bytes:
+    """Serialize a boolean (boolTrue or boolFalse)"""
+    return struct.pack("<I", 0x997275B5 if b else 0xBC799737)
+
+def tl_vector(items: list) -> bytes:
+    """Serialize a vector of already-serialized items"""
+    result = struct.pack("<I", 0x1CB5C415) + struct.pack("<i", len(items))
+    for item in items:
+        result += item
+    return result
+
+def tl_vector_int(items: list) -> bytes:
+    """Serialize a vector of 32-bit integers"""
+    return tl_vector([tl_int(x) for x in items])
+
+def tl_vector_long(items: list) -> bytes:
+    """Serialize a vector of 64-bit integers"""
+    return tl_vector([tl_long(x) for x in items])
+
+def tl_vector_string(items: list) -> bytes:
+    """Serialize a vector of strings"""
+    return tl_vector([tl_string(x) for x in items])
+
+def tl_read_bytes(data: bytes, offset: int):
+    """Read TL bytes from data at offset. Returns (value, new_offset)"""
+    n = data[offset]
+    if n < 0xFE:
+        val = data[offset+1:offset+1+n]
+        new_offset = offset + 1 + n
+    else:
+        n = int.from_bytes(data[offset+1:offset+4], 'little')
+        val = data[offset+4:offset+4+n]
+        new_offset = offset + 4 + n
+    new_offset = (new_offset + 3) & ~3
+    return val, new_offset
+
+def tl_read_string(data: bytes, offset: int):
+    """Read TL string from data at offset. Returns (string, new_offset)"""
+    val, new_offset = tl_read_bytes(data, offset)
+    return val.decode('utf-8', errors='ignore'), new_offset
+
+def tl_read_int(data: bytes, offset: int):
+    """Read 32-bit signed integer"""
+    return struct.unpack("<i", data[offset:offset+4])[0], offset + 4
+
+def tl_read_uint(data: bytes, offset: int):
+    """Read 32-bit unsigned integer"""
+    return struct.unpack("<I", data[offset:offset+4])[0], offset + 4
+
+def tl_read_long(data: bytes, offset: int):
+    """Read 64-bit signed integer"""
+    return struct.unpack("<q", data[offset:offset+8])[0], offset + 8
+
+def tl_read_ulong(data: bytes, offset: int):
+    """Read 64-bit unsigned integer"""
+    return struct.unpack("<Q", data[offset:offset+8])[0], offset + 8
+
+def tl_read_double(data: bytes, offset: int):
+    """Read 64-bit float"""
+    return struct.unpack("<d", data[offset:offset+8])[0], offset + 8
+
+def tl_read_vector_header(data: bytes, offset: int):
+    """Read vector constructor and count. Returns (count, new_offset) or (None, offset) if not a vector"""
+    if offset + 8 > len(data):
+        return None, offset
+    ctor = struct.unpack("<I", data[offset:offset+4])[0]
+    if ctor != 0x1CB5C415:
+        return None, offset
+    count = struct.unpack("<i", data[offset+4:offset+8])[0]
+    return count, offset + 8

jetrauserapi-1.0.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,13 @@
+jetrauserapi/__init__.py,sha256=H8zxvuPCv_Lr_WuynAxQGQl7wRcg3Ijnkcv-DKk-Vv4,198
+jetrauserapi/client.py,sha256=cKQU7OI-JfH1w-uF4fTnrwNdHgcWOScqhXy1yVa2WsQ,18584
+jetrauserapi/config.py,sha256=MoPWsU1BhecXdqNFFbpKYminANPB5C6NQFKIosT72Eo,383
+jetrauserapi/database.py,sha256=SMPz_znpZQWmTmIShpdXo25-Tw6sirOEk_8l_SAR8WA,3523
+jetrauserapi/high_level.py,sha256=NvtQzp7pSSHTXz8vgv4o7uYBDvss3O_6Z2z9CoQOPSU,17267
+jetrauserapi/message.py,sha256=0ccMTO3PQty2nfvQiUeOpcNkS9jgV15JNXG72BiE2oI,1661
+jetrauserapi/session.py,sha256=Ax87nVNiSTwMC9KSA_q7xBW0f8llyU67HWVUX3Y1nXQ,2796
+jetrauserapi/tl_builder.py,sha256=UT182fMWC3TiksKLwQzKgNLMsMiIji9jCNcnXlLvnpI,3581
+jetrauserapi-1.0.0.dist-info/licenses/LICENSE,sha256=qrhkXM8xfFmxdZc3c0xIyeo_4VmE5vYMiwJIwfuyT6o,1064
+jetrauserapi-1.0.0.dist-info/METADATA,sha256=0mBiVxymmhbujvdwkVJvxBMv5n7nnuAjDpif3fCo0RY,2289
+jetrauserapi-1.0.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+jetrauserapi-1.0.0.dist-info/top_level.txt,sha256=HzkTVLamVEDF6fkRBXOSwfHl1JwngokAItVnXvJAOEI,13
+jetrauserapi-1.0.0.dist-info/RECORD,,

jetrauserapi-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

jetrauserapi-1.0.0.dist-info/licenses/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.dist-info/top_level.txt

@@ -0,0 +1 @@
+jetrauserapi