aiodot 1.0.0__tar.gz

aiodot-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 karbaladev.ir
+
+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.

aiodot-1.0.0/PKG-INFO

@@ -0,0 +1,150 @@
+Metadata-Version: 2.4
+Name: aiodot
+Version: 1.0.0
+Summary: Async Python client for MyDot.one social platform
+Home-page: https://github.com/karbaladev/aiodot
+Author: karbaladev.ir
+Author-email: "karbaladev.ir" <saleh.mohammadi.az@gmail.com>
+License: MIT
+Project-URL: Homepage, https://karbaladev.ir
+Project-URL: Repository, https://github.com/karbaladevir/aiodot
+Project-URL: Issues, https://github.com/karbaladevir/aiodot/issues
+Keywords: mydot,aiodot,mydot-bot,social-media,async,bot
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: requests>=2.28.0
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+<p align="center">
+  <img src="https://abrehamrahi.ir/o/public/rNf0ej8l/" alt="aiodot logo" width="200">
+</p>
+
+<h1 align="center">aiodot 🚀</h1>
+<p align="center">
+  <b>Async Python client for MyDot.one social platform</b><br>
+  Build bots, automation, and tools with ease.
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/aiodot/">
+    <img src="https://badge.fury.io/py/aiodot.svg" alt="PyPI version">
+  </a>
+  <a href="https://pypi.org/project/aiodot/">
+    <img src="https://img.shields.io/pypi/pyversions/aiodot.svg" alt="Python">
+  </a>
+  <a href="https://github.com/karbaladev/aiodot/blob/main/LICENSE">
+    <img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT">
+  </a>
+</p>
+
+---
+
+**`aiodot`** is an asynchronous Python library for [MyDot.one](https://mydot.one). Built with `aiohttp` — fast, async-first, session-based like aiogram.
+
+---
+
+## ✨ Features
+
+- ⚡ **Async-first** — Built on aiohttp
+- 💾 **Session persistence** — Login once, auto-loads next time
+- 🔄 **Auto token refresh** — Handles 401 gracefully
+- 📦 **50+ endpoints** — Full API coverage
+- 🎯 **Type hints** — Full type annotations
+
+---
+
+## 📦 Installation
+
+```bash
+pip install aiodot
+```
+
+---
+
+## 💡 Quick Start
+
+```python
+import asyncio
+from aiodot import MyDotClient
+
+TOKEN = "your-token"  # F12 → Cookies → __Secure-access_token
+
+async def main():
+    async with MyDotClient(token=TOKEN, session_file="user.session.json") as client:
+        me = await client.get_me()
+        print(f"@{me.username}")
+
+        dot = await client.create_dot("Hello aiodot! 🚀")
+        print(dot.url)
+
+asyncio.run(main())
+```
+
+---
+
+## 🤖 Echo Bot
+
+```python
+import asyncio
+from aiodot import MyDotClient
+
+TOKEN = "your-token"
+
+async def main():
+    processed = set()
+    async with MyDotClient(token=TOKEN, session_file="bot.session.json") as c:
+        print(f"🤖 @{(await c.get_me()).username} started!")
+        while True:
+            for n in (await c.get_notifications(10)).get("results", []):
+                if n.get("id") in processed: continue
+                processed.add(n.get("id"))
+                if n.get("type") == "mention":
+                    d = n.get("dot", {})
+                    if d.get("id"):
+                        await c.reply(d["id"], "Hello! 🤖")
+            await asyncio.sleep(15)
+
+asyncio.run(main())
+```
+
+---
+
+## 📖 API Reference
+
+| Category | Methods |
+|----------|---------|
+| **Profile** | `get_me()`, `update_profile()`, `set_visibility()` |
+| **Dots** | `create_dot()`, `get_dot()`, `reply()`, `repost()`, `quote()`, `like()`, `bookmark()`, `edit_dot()`, `delete_dot()` |
+| **Social** | `follow()`, `unfollow()`, `block()`, `unblock()`, `mute()`, `unmute()` |
+| **Users** | `search_users()`, `get_user_followers()`, `get_user_following()`, `get_user_dots()` |
+| **Feed** | `home_feed()`, `following_feed()`, `follow_suggestions()` |
+| **Notifications** | `get_notifications()`, `mark_all_read()`, `get_notification_preferences()` |
+| **Trending** | `get_trending_hashtags()`, `get_trending_media()` |
+
+---
+
+## ⚠️ Disclaimer
+
+Unofficial library. Use responsibly per MyDot.one Terms of Service.
+
+---
+
+## 📡 Community
+
+- 📢 **Telegram:** [@aiodotlib](https://t.me/aiodotlib)
+- 💬 **Bale:** [ble.ir/aiodot](https://ble.ir/aiodot)
+- 🌐 **Website:** [karbaladev.ir](https://karbaladev.ir)
+
+---
+
+## 📄 License
+
+MIT © [karbaladev.ir](https://karbaladev.ir)

aiodot-1.0.0/README.md

@@ -0,0 +1,125 @@
+<p align="center">
+  <img src="https://abrehamrahi.ir/o/public/rNf0ej8l/" alt="aiodot logo" width="200">
+</p>
+
+<h1 align="center">aiodot 🚀</h1>
+<p align="center">
+  <b>Async Python client for MyDot.one social platform</b><br>
+  Build bots, automation, and tools with ease.
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/aiodot/">
+    <img src="https://badge.fury.io/py/aiodot.svg" alt="PyPI version">
+  </a>
+  <a href="https://pypi.org/project/aiodot/">
+    <img src="https://img.shields.io/pypi/pyversions/aiodot.svg" alt="Python">
+  </a>
+  <a href="https://github.com/karbaladev/aiodot/blob/main/LICENSE">
+    <img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT">
+  </a>
+</p>
+
+---
+
+**`aiodot`** is an asynchronous Python library for [MyDot.one](https://mydot.one). Built with `aiohttp` — fast, async-first, session-based like aiogram.
+
+---
+
+## ✨ Features
+
+- ⚡ **Async-first** — Built on aiohttp
+- 💾 **Session persistence** — Login once, auto-loads next time
+- 🔄 **Auto token refresh** — Handles 401 gracefully
+- 📦 **50+ endpoints** — Full API coverage
+- 🎯 **Type hints** — Full type annotations
+
+---
+
+## 📦 Installation
+
+```bash
+pip install aiodot
+```
+
+---
+
+## 💡 Quick Start
+
+```python
+import asyncio
+from aiodot import MyDotClient
+
+TOKEN = "your-token"  # F12 → Cookies → __Secure-access_token
+
+async def main():
+    async with MyDotClient(token=TOKEN, session_file="user.session.json") as client:
+        me = await client.get_me()
+        print(f"@{me.username}")
+
+        dot = await client.create_dot("Hello aiodot! 🚀")
+        print(dot.url)
+
+asyncio.run(main())
+```
+
+---
+
+## 🤖 Echo Bot
+
+```python
+import asyncio
+from aiodot import MyDotClient
+
+TOKEN = "your-token"
+
+async def main():
+    processed = set()
+    async with MyDotClient(token=TOKEN, session_file="bot.session.json") as c:
+        print(f"🤖 @{(await c.get_me()).username} started!")
+        while True:
+            for n in (await c.get_notifications(10)).get("results", []):
+                if n.get("id") in processed: continue
+                processed.add(n.get("id"))
+                if n.get("type") == "mention":
+                    d = n.get("dot", {})
+                    if d.get("id"):
+                        await c.reply(d["id"], "Hello! 🤖")
+            await asyncio.sleep(15)
+
+asyncio.run(main())
+```
+
+---
+
+## 📖 API Reference
+
+| Category | Methods |
+|----------|---------|
+| **Profile** | `get_me()`, `update_profile()`, `set_visibility()` |
+| **Dots** | `create_dot()`, `get_dot()`, `reply()`, `repost()`, `quote()`, `like()`, `bookmark()`, `edit_dot()`, `delete_dot()` |
+| **Social** | `follow()`, `unfollow()`, `block()`, `unblock()`, `mute()`, `unmute()` |
+| **Users** | `search_users()`, `get_user_followers()`, `get_user_following()`, `get_user_dots()` |
+| **Feed** | `home_feed()`, `following_feed()`, `follow_suggestions()` |
+| **Notifications** | `get_notifications()`, `mark_all_read()`, `get_notification_preferences()` |
+| **Trending** | `get_trending_hashtags()`, `get_trending_media()` |
+
+---
+
+## ⚠️ Disclaimer
+
+Unofficial library. Use responsibly per MyDot.one Terms of Service.
+
+---
+
+## 📡 Community
+
+- 📢 **Telegram:** [@aiodotlib](https://t.me/aiodotlib)
+- 💬 **Bale:** [ble.ir/aiodot](https://ble.ir/aiodot)
+- 🌐 **Website:** [karbaladev.ir](https://karbaladev.ir)
+
+---
+
+## 📄 License
+
+MIT © [karbaladev.ir](https://karbaladev.ir)

aiodot-1.0.0/aiodot/__init__.py

@@ -0,0 +1,37 @@
+# ==========================================
+# aiodot/__init__.py
+# ==========================================
+
+"""
+aiodot - Python client for MyDot.one social platform.
+Build bots, automation, and tools with ease.
+
+Author: karbaladev.ir
+License: MIT
+Version: 1.0.0
+
+Usage:
+    from aiodot import MyDotClient
+
+    client = MyDotClient(token="your_token")
+    me = client.me
+    dot = client.create_dot("Hello from aiodot!")
+"""
+
+from .client import MyDotClient
+from .auth import MyDotAuth, Session
+from .models import Dot, User, ThreadView, Notification, PaginatedResponse
+
+__version__ = "1.0.0"
+__author__ = "karbaladev.ir"
+__license__ = "MIT"
+__all__ = [
+    "MyDotClient",
+    "MyDotAuth",
+    "Session",
+    "Dot",
+    "User",
+    "ThreadView",
+    "Notification",
+    "PaginatedResponse",
+]

aiodot-1.0.0/aiodot/auth.py

@@ -0,0 +1,153 @@
+# ==========================================
+# aiodot/auth.py
+# ==========================================
+
+"""Authentication module for MyDot.one. Token-based with session file."""
+
+import json
+import time
+from pathlib import Path
+from typing import Optional, Dict, Any
+from dataclasses import dataclass, asdict, field
+
+import aiohttp
+import requests
+
+
+@dataclass
+class Session:
+    """Session data saved to disk."""
+    token: str = ""
+    user_id: str = ""
+    username: str = ""
+    display_name: str = ""
+    phone: str = ""
+    created_at: float = field(default_factory=time.time)
+
+    def to_dict(self) -> Dict[str, Any]:
+        return asdict(self)
+
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> "Session":
+        valid = {k: v for k, v in data.items() if k in cls.__dataclass_fields__}
+        return cls(**valid)
+
+
+class MyDotAuth:
+    """Auth handler for MyDot.one."""
+
+    BASE_URL = "https://api.mydot.one/mydot/api/v1"
+
+    def __init__(self, session_file: Optional[str] = None):
+        if session_file is None:
+            self.session_file = Path.home() / ".mydot" / "session.json"
+        else:
+            self.session_file = Path(session_file)
+
+        self.session_file.parent.mkdir(parents=True, exist_ok=True)
+        self.session_data = Session()
+        self._loaded = False
+
+        if self.session_file.exists():
+            self._load()
+
+    def _load(self) -> bool:
+        try:
+            with open(self.session_file, "r", encoding="utf-8") as f:
+                data = json.load(f)
+            self.session_data = Session.from_dict(data)
+            self._loaded = bool(self.session_data.token)
+            return True
+        except Exception:
+            return False
+
+    def save(self) -> None:
+        with open(self.session_file, "w", encoding="utf-8") as f:
+            json.dump(self.session_data.to_dict(), f, indent=2, ensure_ascii=False)
+
+    def clear(self) -> None:
+        self.session_data = Session()
+        if self.session_file.exists():
+            self.session_file.unlink()
+
+    # ============ Sync Login (called once during init) ============
+
+    def login_with_token_sync(self, token: str) -> bool:
+        """Sync token validation. Called once during MyDotClient init."""
+        self.session_data.token = token
+        resp = requests.get(
+            f"{self.BASE_URL}/auth/profile/",
+            cookies={"__Secure-access_token": token},
+            headers=self._get_headers_sync(),
+        )
+        if resp.ok:
+            p = resp.json()
+            self.session_data.user_id = p.get("user_id", "")
+            self.session_data.username = p.get("username", "")
+            self.session_data.display_name = p.get("display_name", "")
+            self._loaded = True
+            self.save()
+            print(f"✅ Token saved! @{self.username}")
+            return True
+        print("❌ Invalid token")
+        return False
+
+    # ============ Async Token Refresh ============
+
+    async def refresh(self) -> bool:
+        """Async token refresh using aiohttp."""
+        headers = self._get_headers_async()
+        headers["Cookie"] = f"__Secure-access_token={self.token}"
+        async with aiohttp.ClientSession() as s:
+            async with s.post(f"{self.BASE_URL}/auth/token/refresh/", headers=headers, json={}) as resp:
+                if resp.status == 200:
+                    for key, cookie in resp.cookies.items():
+                        if key == "__Secure-access_token":
+                            self.session_data.token = cookie.value
+                            self.save()
+                            print("🔄 Token refreshed")
+                            return True
+        return False
+
+    # ============ Headers ============
+
+    def _get_headers_sync(self) -> Dict[str, str]:
+        return {
+            "Accept": "application/json, text/plain, */*",
+            "Origin": "https://mydot.one",
+            "Referer": "https://mydot.one/",
+            "User-Agent": "Mozilla/5.0",
+        }
+
+    def _get_headers_async(self) -> Dict[str, str]:
+        return {
+            "Accept": "application/json, text/plain, */*",
+            "Origin": "https://mydot.one",
+            "Referer": "https://mydot.one/",
+            "User-Agent": "Mozilla/5.0",
+        }
+
+    # ============ Properties ============
+
+    @property
+    def token(self) -> Optional[str]:
+        return self.session_data.token
+
+    @property
+    def user_id(self) -> Optional[str]:
+        return self.session_data.user_id
+
+    @property
+    def username(self) -> Optional[str]:
+        return self.session_data.username
+
+    @property
+    def display_name(self) -> Optional[str]:
+        return self.session_data.display_name
+
+    @property
+    def is_logged_in(self) -> bool:
+        return self._loaded and bool(self.token)
+
+    def __repr__(self) -> str:
+        return f"MyDotAuth(@{self.username})" if self.username else "MyDotAuth(not logged in)"

aiodot-1.0.0/aiodot/client.py

@@ -0,0 +1,307 @@
+# ==========================================
+# aiodot/client.py
+# ==========================================
+
+"""Main MyDot.one API Client. Async version built on aiohttp."""
+
+from typing import Optional, Dict, List, Any
+import aiohttp
+from .models import Dot, User, ThreadView, Notification, PaginatedResponse
+from .auth import MyDotAuth
+
+
+class MyDotClient:
+    """Async API client for MyDot.one."""
+
+    BASE_URL = "https://api.mydot.one/mydot/api/v1"
+
+    def __init__(self, token: Optional[str] = None, session_file: Optional[str] = None, auth: Optional[MyDotAuth] = None):
+        if auth:
+            self.auth = auth
+        elif token:
+            self.auth = MyDotAuth(session_file=session_file)
+            self.auth.login_with_token_sync(token)
+        else:
+            self.auth = MyDotAuth(session_file=session_file)
+        self._session: Optional[aiohttp.ClientSession] = None
+
+    async def __aenter__(self):
+        self._session = aiohttp.ClientSession()
+        return self
+
+    async def __aexit__(self, *args):
+        if self._session:
+            await self._session.close()
+            self._session = None
+
+    @property
+    def http(self) -> aiohttp.ClientSession:
+        if self._session is None:
+            raise RuntimeError("Use 'async with MyDotClient(...) as client:' block.")
+        return self._session
+
+    def _headers(self) -> Dict[str, str]:
+        h = {
+            "Accept": "application/json, text/plain, */*",
+            "Origin": "https://mydot.one",
+            "Referer": "https://mydot.one/",
+            "User-Agent": "Mozilla/5.0",
+        }
+        if self.auth.token:
+            h["Cookie"] = f"__Secure-access_token={self.auth.token}"
+        return h
+
+    async def _get(self, path: str, params: Dict = None) -> Any:
+        url = f"{self.BASE_URL}{path}"
+        async with self.http.get(url, params=params, headers=self._headers()) as resp:
+            if resp.status == 401 and await self.auth.refresh():
+                async with self.http.get(url, params=params, headers=self._headers()) as r:
+                    r.raise_for_status()
+                    ct = r.content_type
+                    return await r.json() if "json" in ct else await r.text()
+            resp.raise_for_status()
+            ct = resp.content_type
+            return await resp.json() if "json" in ct else await resp.text()
+
+    async def _post(self, path: str, json: Dict = None) -> Any:
+        url = f"{self.BASE_URL}{path}"
+        async with self.http.post(url, json=json, headers=self._headers()) as resp:
+            if resp.status == 401 and await self.auth.refresh():
+                async with self.http.post(url, json=json, headers=self._headers()) as r:
+                    r.raise_for_status()
+                    ct = r.content_type
+                    return await r.json() if "json" in ct else await r.text()
+            resp.raise_for_status()
+            ct = resp.content_type
+            return await resp.json() if "json" in ct else await resp.text()
+
+    async def _patch(self, path: str, json: Dict = None) -> Any:
+        url = f"{self.BASE_URL}{path}"
+        async with self.http.patch(url, json=json, headers=self._headers()) as resp:
+            if resp.status == 401 and await self.auth.refresh():
+                async with self.http.patch(url, json=json, headers=self._headers()) as r:
+                    r.raise_for_status()
+                    ct = r.content_type
+                    return await r.json() if "json" in ct else await r.text()
+            resp.raise_for_status()
+            ct = resp.content_type
+            return await resp.json() if "json" in ct else await resp.text()
+
+    async def _delete(self, path: str) -> Any:
+        url = f"{self.BASE_URL}{path}"
+        async with self.http.delete(url, headers=self._headers()) as resp:
+            if resp.status == 401 and await self.auth.refresh():
+                async with self.http.delete(url, headers=self._headers()) as r:
+                    r.raise_for_status()
+                    ct = r.content_type
+                    return await r.json() if "json" in ct else await r.text()
+            resp.raise_for_status()
+            ct = resp.content_type
+            return await resp.json() if "json" in ct else await resp.text()
+
+    # ============ Profile (4) ============
+    async def get_me(self) -> User:
+        data = await self._get("/auth/profile/")
+        return User.from_dict(data)
+
+    async def update_profile(self, **kwargs) -> User:
+        data = await self._patch("/auth/profile/", json=kwargs)
+        return User.from_dict(data)
+
+    async def get_profile_visibility(self) -> Dict:
+        return await self._get("/auth/profile/visibility/")
+
+    async def set_profile_visibility(self, visibility: str) -> Dict:
+        return await self._patch("/auth/profile/visibility/", json={"profile_visibility": visibility})
+
+    # ============ User Actions (6) ============
+    async def follow(self, user_id: str) -> bool:
+        await self._post("/auth/follow/", json={"target_id": user_id})
+        return True
+
+    async def unfollow(self, user_id: str) -> bool:
+        await self._post("/auth/unfollow/", json={"target_id": user_id})
+        return True
+
+    async def block(self, user_id: str) -> bool:
+        await self._post("/auth/block/", json={"target_id": user_id})
+        return True
+
+    async def unblock(self, user_id: str) -> bool:
+        await self._post("/auth/unblock/", json={"target_id": user_id})
+        return True
+
+    async def mute(self, user_id: str) -> bool:
+        await self._post("/auth/mute/", json={"target_id": user_id})
+        return True
+
+    async def unmute(self, user_id: str) -> bool:
+        await self._post("/auth/unmute/", json={"target_id": user_id})
+        return True
+
+    # ============ User Info (3) ============
+    async def get_user_followers(self, username: str, page_size: int = 20) -> Dict:
+        return await self._get(f"/auth/{username}/followers/", params={"page_size": page_size})
+
+    async def get_user_following(self, username: str, page_size: int = 20) -> Dict:
+        return await self._get(f"/auth/{username}/following/", params={"page_size": page_size})
+
+    async def search_users(self, query: str) -> Any:
+        return await self._get("/auth/profile/search", params={"q": query})
+
+    # ============ Dots - Read (9) ============
+    async def get_dot(self, dot_id: str) -> Dot:
+        data = await self._get(f"/dots/{dot_id}/")
+        return Dot.from_dict(data)
+
+    async def get_thread_view(self, dot_id: str) -> ThreadView:
+        data = await self._get(f"/dots/{dot_id}/thread-view/")
+        return ThreadView.from_dict(data)
+
+    async def get_replies(self, dot_id: str, page: int = 1, limit: int = 20) -> Dict:
+        return await self._get(f"/dots/{dot_id}/replies/", params={"page": page, "limit": limit})
+
+    async def get_reposts(self, dot_id: str) -> Dict:
+        return await self._get(f"/dots/{dot_id}/reposts/")
+
+    async def get_quotes(self, dot_id: str) -> Dict:
+        return await self._get(f"/dots/{dot_id}/quotes/")
+
+    async def get_dot_likes(self, dot_id: str) -> Any:
+        return await self._get(f"/dots/{dot_id}/likes/")
+
+    async def get_user_dots(self, user_id: str, dot_type: str = "dot,quote,repost", limit: int = 20) -> Dict:
+        return await self._get(f"/dots/user/{user_id}/", params={"dot_type": dot_type, "limit": limit})
+
+    async def get_user_replies(self, user_id: str) -> Dict:
+        return await self._get(f"/dots/user/{user_id}/", params={"dot_type": "reply"})
+
+    async def get_user_likes(self, user_id: str) -> Dict:
+        return await self._get(f"/dots/user/{user_id}/activity/", params={"action_type": "like"})
+
+    # ============ Dots - Create (4) ============
+    async def create_dot(self, content: str, dot_type: str = "dot", reply_to: str = None,
+                         repost_of: str = None, quote_of: str = None,
+                         media_ids: List[str] = None, reply_permission: str = "everyone") -> Dot:
+        body = {k: v for k, v in {
+            "dot_type": dot_type, "content": content,
+            "reply_to": reply_to, "repost_of": repost_of, "quote_of": quote_of,
+            "media_ids": media_ids or [], "reply_permission": reply_permission
+        }.items() if v is not None}
+        data = await self._post("/dots/", json=body)
+        return Dot.from_dict(data)
+
+    async def reply(self, dot_id: str, content: str) -> Dot:
+        return await self.create_dot(content=content, dot_type="reply", reply_to=dot_id)
+
+    async def repost(self, dot_id: str, media_ids: List[str] = None) -> Dot:
+        return await self.create_dot(content="", dot_type="repost", repost_of=dot_id, media_ids=media_ids)
+
+    async def quote(self, dot_id: str, content: str) -> Dot:
+        return await self.create_dot(content=content, dot_type="quote", quote_of=dot_id)
+
+    # ============ Dots - Actions (10) ============
+    async def like(self, dot_id: str) -> bool:
+        await self._post(f"/dots/{dot_id}/like/")
+        return True
+
+    async def unlike(self, dot_id: str) -> bool:
+        await self._delete(f"/dots/{dot_id}/like/")
+        return True
+
+    async def bookmark(self, dot_id: str) -> bool:
+        await self._post(f"/dots/{dot_id}/bookmark/")
+        return True
+
+    async def unbookmark(self, dot_id: str) -> bool:
+        await self._delete(f"/dots/{dot_id}/bookmark/")
+        return True
+
+    async def do_repost(self, dot_id: str) -> bool:
+        await self._post(f"/dots/{dot_id}/repost/")
+        return True
+
+    async def undo_repost(self, dot_id: str) -> bool:
+        await self._delete(f"/dots/{dot_id}/repost/")
+        return True
+
+    async def edit_dot(self, dot_id: str, content: str) -> Dot:
+        data = await self._patch(f"/dots/{dot_id}/", json={"content": content})
+        return Dot.from_dict(data)
+
+    async def delete_dot(self, dot_id: str) -> bool:
+        await self._delete(f"/dots/{dot_id}/")
+        return True
+
+    # ============ Feed (3) ============
+    async def home_feed(self, page_size: int = 40) -> Dict:
+        return await self._get("/feed/suggestions/timeline/", params={"page_size": page_size})
+
+    async def following_feed(self, **params) -> Dict:
+        return await self._get("/feed/following/", params=params)
+
+    async def follow_suggestions(self, cursor: str = None, page_size: int = 20) -> Dict:
+        p = {"page_size": page_size}
+        if cursor:
+            p["cursor"] = cursor
+        return await self._get("/feed/suggestions/follow/", params=p)
+
+    # ============ Notifications (4) ============
+    async def get_notifications(self, page_size: int = 50) -> Dict:
+        return await self._get("/notifications/", params={"page_size": page_size})
+
+    async def get_notification_preferences(self) -> Dict:
+        return await self._get("/notifications/preferences/")
+
+    async def update_notification_preferences(self, **kwargs) -> Dict:
+        return await self._patch("/notifications/preferences/", json=kwargs)
+
+    async def mark_all_notifications_read(self) -> bool:
+        await self._post("/notifications/read-all/")
+        return True
+
+    # ============ Bookmarks (1) ============
+    async def get_bookmarks(self, limit: int = 20) -> Dict:
+        return await self._get("/dots/bookmarks/", params={"limit": limit})
+
+    # ============ Trending (2) ============
+    async def get_trending_hashtags(self) -> Any:
+        return await self._get("/dots/hashtags/trending/")
+
+    async def get_trending_media(self, limit: int = 24) -> Dict:
+        return await self._get("/dots/media/trending/", params={"limit": limit})
+
+    # ============ Media Upload (1) ============
+    async def upload_media(self, file_path: str) -> Dict:
+        url = f"{self.BASE_URL}/posts/media/"
+        with open(file_path, "rb") as f:
+            form = aiohttp.FormData()
+            form.add_field("file", f)
+            async with self.http.post(url, data=form, headers=self._headers()) as resp:
+                resp.raise_for_status()
+                return await resp.json()
+
+    # ============ Other (6) ============
+    async def get_alerts(self) -> Any:
+        return await self._get("/utils/alerts/active/")
+
+    async def get_invites(self) -> Dict:
+        return await self._get("/auth/invites/")
+
+    async def get_wallets(self) -> Dict:
+        return await self._get("/auth/wallets/")
+
+    async def get_2fa_state(self) -> Dict:
+        return await self._get("/auth/2fa/state/")
+
+    async def get_star_settings(self) -> Dict:
+        return await self._get("/reward/default-stars/")
+
+    async def get_star_transactions(self) -> Dict:
+        return await self._get("/reward/stars-transaction/")
+
+    # ============ Convenience (1) ============
+    async def get_dot_url(self, short_id: str, username: str = None) -> str:
+        if username is None:
+            username = self.auth.username
+        return f"https://mydot.one/@{username}/status/{short_id}"

aiodot-1.0.0/aiodot/models.py

@@ -0,0 +1,185 @@
+# ==========================================
+# aiodot/models.py
+# ==========================================
+
+"""Data models for MyDot API responses."""
+
+from typing import Optional, Dict, List, Any
+from dataclasses import dataclass, field
+
+
+@dataclass
+class User:
+    """MyDot user profile."""
+    user_id: str = ""
+    username: str = ""
+    display_name: str = ""
+    bio: str = ""
+    location: str = ""
+    website: str = ""
+    avatar_url: str = ""
+    header_url: str = ""
+    followers_count: int = 0
+    following_count: int = 0
+    posts_count: int = 0
+    is_verified: bool = False
+    is_dotone_staff: bool = False
+    account_type: str = "standard"
+    profile_visibility: str = "public"
+    created_at: str = ""
+    email: str = ""
+    phone_number: str = ""
+    kyc_status: str = "not_requested"
+
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> "User":
+        return cls(
+            user_id=data.get("user_id", data.get("id", "")),
+            username=data.get("username", ""),
+            display_name=data.get("display_name", ""),
+            bio=data.get("bio", ""),
+            location=data.get("location", ""),
+            website=data.get("website", ""),
+            avatar_url=data.get("avatar_url", ""),
+            header_url=data.get("header_url", ""),
+            followers_count=data.get("followers_count", 0),
+            following_count=data.get("following_count", 0),
+            posts_count=data.get("posts_count", 0),
+            is_verified=data.get("is_verified", False),
+            is_dotone_staff=data.get("is_dotone_staff", False),
+            account_type=data.get("account_type", "standard"),
+            profile_visibility=data.get("profile_visibility", "public"),
+            created_at=data.get("created_at", ""),
+            email=data.get("email", ""),
+            phone_number=data.get("phone_number", ""),
+            kyc_status=data.get("kyc_status", "not_requested"),
+        )
+
+    @property
+    def profile_url(self) -> str:
+        return f"https://mydot.one/@{self.username}"
+
+
+@dataclass
+class Dot:
+    """MyDot dot (post/tweet)."""
+    id: str = ""
+    short_id: str = ""
+    content: str = ""
+    dot_type: str = "dot"
+    author: Dict[str, Any] = field(default_factory=dict)
+    reply_to: Optional[str] = None
+    repost_of: Optional[str] = None
+    quote_of: Optional[str] = None
+    likes_count: int = 0
+    replies_count: int = 0
+    reposts_count: int = 0
+    quotes_count: int = 0
+    bookmarks_count: int = 0
+    view_count: int = 0
+    stars: int = 0
+    is_liked: bool = False
+    is_reposted: bool = False
+    is_bookmarked: bool = False
+    created_at: Optional[str] = None
+    edited_at: Optional[str] = None
+    media: List[Dict] = field(default_factory=list)
+    entities: Dict = field(default_factory=dict)
+    sensitive_type: str = "normal"
+
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> "Dot":
+        vc = data.get("viewer_context", {})
+        return cls(
+            id=data.get("id", ""),
+            short_id=data.get("short_id", ""),
+            content=data.get("content", ""),
+            dot_type=data.get("dot_type", "dot"),
+            author=data.get("author", {}),
+            reply_to=data.get("reply_to"),
+            repost_of=data.get("repost_of"),
+            quote_of=data.get("quote_of"),
+            likes_count=data.get("likes_count", 0),
+            replies_count=data.get("replies_count", 0),
+            reposts_count=data.get("reposts_count", 0),
+            quotes_count=data.get("quotes_count", 0),
+            bookmarks_count=data.get("bookmarks_count", 0),
+            view_count=data.get("view_count", 0),
+            stars=data.get("stars", 0),
+            is_liked=vc.get("is_liked", False),
+            is_reposted=vc.get("is_reposted", False),
+            is_bookmarked=vc.get("is_bookmarked", False),
+            created_at=data.get("created_at"),
+            edited_at=data.get("edited_at"),
+            media=data.get("media", []),
+            entities=data.get("entities", {}),
+            sensitive_type=data.get("sensitive_type", "normal"),
+        )
+
+    @property
+    def author_username(self) -> str:
+        return self.author.get("username", "")
+
+    @property
+    def url(self) -> str:
+        return f"https://mydot.one/@{self.author_username}/status/{self.short_id}"
+
+    @property
+    def is_reply(self) -> bool:
+        return self.dot_type == "reply"
+
+    @property
+    def is_repost(self) -> bool:
+        return self.dot_type == "repost"
+
+    @property
+    def is_quote(self) -> bool:
+        return self.dot_type == "quote"
+
+
+@dataclass
+class ThreadView:
+    """Thread view (parent, dot, children)."""
+    above: List[Dot] = field(default_factory=list)
+    dot: Optional[Dot] = None
+    below: Dict = field(default_factory=dict)
+
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> "ThreadView":
+        return cls(
+            above=[Dot.from_dict(d) for d in data.get("above", [])],
+            dot=Dot.from_dict(data.get("dot", {})),
+            below=data.get("below", {}),
+        )
+
+
+@dataclass
+class Notification:
+    """MyDot notification."""
+    id: str = ""
+    type: str = ""
+    created_at: str = ""
+    is_read: bool = False
+    actor: Optional[Dict] = None
+    dot: Optional[Dot] = None
+
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> "Notification":
+        dot = Dot.from_dict(data["dot"]) if data.get("dot") else None
+        return cls(
+            id=data.get("id", ""),
+            type=data.get("type", ""),
+            created_at=data.get("created_at", ""),
+            is_read=data.get("is_read", False),
+            actor=data.get("actor"),
+            dot=dot,
+        )
+
+
+@dataclass
+class PaginatedResponse:
+    """Generic paginated response."""
+    count: int = 0
+    next: Optional[str] = None
+    previous: Optional[str] = None
+    results: List[Any] = field(default_factory=list)

aiodot-1.0.0/aiodot.egg-info/PKG-INFO

@@ -0,0 +1,150 @@
+Metadata-Version: 2.4
+Name: aiodot
+Version: 1.0.0
+Summary: Async Python client for MyDot.one social platform
+Home-page: https://github.com/karbaladev/aiodot
+Author: karbaladev.ir
+Author-email: "karbaladev.ir" <saleh.mohammadi.az@gmail.com>
+License: MIT
+Project-URL: Homepage, https://karbaladev.ir
+Project-URL: Repository, https://github.com/karbaladevir/aiodot
+Project-URL: Issues, https://github.com/karbaladevir/aiodot/issues
+Keywords: mydot,aiodot,mydot-bot,social-media,async,bot
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: requests>=2.28.0
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+<p align="center">
+  <img src="https://abrehamrahi.ir/o/public/rNf0ej8l/" alt="aiodot logo" width="200">
+</p>
+
+<h1 align="center">aiodot 🚀</h1>
+<p align="center">
+  <b>Async Python client for MyDot.one social platform</b><br>
+  Build bots, automation, and tools with ease.
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/aiodot/">
+    <img src="https://badge.fury.io/py/aiodot.svg" alt="PyPI version">
+  </a>
+  <a href="https://pypi.org/project/aiodot/">
+    <img src="https://img.shields.io/pypi/pyversions/aiodot.svg" alt="Python">
+  </a>
+  <a href="https://github.com/karbaladev/aiodot/blob/main/LICENSE">
+    <img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT">
+  </a>
+</p>
+
+---
+
+**`aiodot`** is an asynchronous Python library for [MyDot.one](https://mydot.one). Built with `aiohttp` — fast, async-first, session-based like aiogram.
+
+---
+
+## ✨ Features
+
+- ⚡ **Async-first** — Built on aiohttp
+- 💾 **Session persistence** — Login once, auto-loads next time
+- 🔄 **Auto token refresh** — Handles 401 gracefully
+- 📦 **50+ endpoints** — Full API coverage
+- 🎯 **Type hints** — Full type annotations
+
+---
+
+## 📦 Installation
+
+```bash
+pip install aiodot
+```
+
+---
+
+## 💡 Quick Start
+
+```python
+import asyncio
+from aiodot import MyDotClient
+
+TOKEN = "your-token"  # F12 → Cookies → __Secure-access_token
+
+async def main():
+    async with MyDotClient(token=TOKEN, session_file="user.session.json") as client:
+        me = await client.get_me()
+        print(f"@{me.username}")
+
+        dot = await client.create_dot("Hello aiodot! 🚀")
+        print(dot.url)
+
+asyncio.run(main())
+```
+
+---
+
+## 🤖 Echo Bot
+
+```python
+import asyncio
+from aiodot import MyDotClient
+
+TOKEN = "your-token"
+
+async def main():
+    processed = set()
+    async with MyDotClient(token=TOKEN, session_file="bot.session.json") as c:
+        print(f"🤖 @{(await c.get_me()).username} started!")
+        while True:
+            for n in (await c.get_notifications(10)).get("results", []):
+                if n.get("id") in processed: continue
+                processed.add(n.get("id"))
+                if n.get("type") == "mention":
+                    d = n.get("dot", {})
+                    if d.get("id"):
+                        await c.reply(d["id"], "Hello! 🤖")
+            await asyncio.sleep(15)
+
+asyncio.run(main())
+```
+
+---
+
+## 📖 API Reference
+
+| Category | Methods |
+|----------|---------|
+| **Profile** | `get_me()`, `update_profile()`, `set_visibility()` |
+| **Dots** | `create_dot()`, `get_dot()`, `reply()`, `repost()`, `quote()`, `like()`, `bookmark()`, `edit_dot()`, `delete_dot()` |
+| **Social** | `follow()`, `unfollow()`, `block()`, `unblock()`, `mute()`, `unmute()` |
+| **Users** | `search_users()`, `get_user_followers()`, `get_user_following()`, `get_user_dots()` |
+| **Feed** | `home_feed()`, `following_feed()`, `follow_suggestions()` |
+| **Notifications** | `get_notifications()`, `mark_all_read()`, `get_notification_preferences()` |
+| **Trending** | `get_trending_hashtags()`, `get_trending_media()` |
+
+---
+
+## ⚠️ Disclaimer
+
+Unofficial library. Use responsibly per MyDot.one Terms of Service.
+
+---
+
+## 📡 Community
+
+- 📢 **Telegram:** [@aiodotlib](https://t.me/aiodotlib)
+- 💬 **Bale:** [ble.ir/aiodot](https://ble.ir/aiodot)
+- 🌐 **Website:** [karbaladev.ir](https://karbaladev.ir)
+
+---
+
+## 📄 License
+
+MIT © [karbaladev.ir](https://karbaladev.ir)

aiodot-1.0.0/aiodot.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+aiodot/__init__.py
+aiodot/auth.py
+aiodot/client.py
+aiodot/models.py
+aiodot.egg-info/PKG-INFO
+aiodot.egg-info/SOURCES.txt
+aiodot.egg-info/dependency_links.txt
+aiodot.egg-info/requires.txt
+aiodot.egg-info/top_level.txt

aiodot-1.0.0/aiodot.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

aiodot-1.0.0/aiodot.egg-info/requires.txt

@@ -0,0 +1,2 @@
+aiohttp>=3.8.0
+requests>=2.28.0

aiodot-1.0.0/aiodot.egg-info/top_level.txt

@@ -0,0 +1 @@
+aiodot

aiodot-1.0.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "aiodot"
+version = "1.0.0"
+description = "Async Python client for MyDot.one social platform"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [
+    {name = "karbaladev.ir", email = "saleh.mohammadi.az@gmail.com"}
+]
+keywords = ["mydot", "aiodot", "mydot-bot", "social-media", "async", "bot"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+]
+requires-python = ">=3.8"
+dependencies = [
+    "aiohttp>=3.8.0",
+    "requests>=2.28.0",
+]
+
+[project.urls]
+Homepage = "https://karbaladev.ir"
+Repository = "https://github.com/karbaladevir/aiodot"
+Issues = "https://github.com/karbaladevir/aiodot/issues"

aiodot-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

aiodot-1.0.0/setup.py

@@ -0,0 +1,43 @@
+"""aiodot - Async Python client for MyDot.one. Install with: pip install aiodot"""
+
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="aiodot",
+    version="1.0.0",
+    author="karbaladev.ir",
+    author_email="saleh.mohammadi.az@gmail.com",
+    description="Async Python client for MyDot.one social platform",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/karbaladev/aiodot",
+    project_urls={
+        "Website": "https://karbaladev.ir",
+        "Bug Tracker": "https://github.com/karbaladev/aiodot/issues",
+        "Source Code": "https://github.com/karbaladev/aiodot",
+    },
+    packages=find_packages(),
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "Programming Language :: Python :: 3.13",
+        "Framework :: AsyncIO",
+    ],
+    python_requires=">=3.8",
+    install_requires=[
+        "aiohttp>=3.8.0",
+        "requests>=2.28.0",
+    ],
+    keywords="mydot, aiodot, mydot-bot, social-media, async, bot, user-bot",
+)