nava-link 1.0.0__tar.gz

nava_link-1.0.0/PKG-INFO

@@ -0,0 +1,213 @@
+Metadata-Version: 2.4
+Name: nava-link
+Version: 1.0.0
+Summary: Python-native messaging client with an embedded runtime
+Author: nava_link contributors
+License: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# nava-link
+
+مكتبة Python لإنشاء تطبيقات وبوتات واتساب بواجهة بسيطة. تدعم الاتصال بكود الاقتران، استقبال الرسائل، إرسال النصوص والوسائط، إدارة المجموعات، الحساب، الجلسة، المحادثات، جهات الاتصال والأجهزة.
+
+> المكتبة غير رسمية وغير تابعة لشركة WhatsApp أو Meta. استخدمها وفق القوانين وشروط الخدمة، وتجنب الرسائل المزعجة أو الإرسال العشوائي.
+
+## التثبيت
+
+على Termux:
+
+```bash
+pkg update -y
+pkg install -y python nodejs-lts
+pip install nava-link==1.0.0
+```
+
+الاستيراد:
+
+```python
+from nava_link import MoXstarClient
+```
+
+## الاتصال بكود الاقتران
+
+```python
+import asyncio
+from nava_link import MoXstarClient
+
+PHONE = "971501234567"
+
+async def main():
+    client = MoXstarClient(auth_dir="./auth")
+    client.on("ready", lambda _: print("تم الاتصال"))
+    client.on("error", lambda error: print("خطأ:", error))
+
+    await client.start()
+    await asyncio.sleep(5)
+    code = await client.request_pairing_code(PHONE)
+    print("كود الاقتران:", code)
+    print("واتساب > الإعدادات > الأجهزة المرتبطة > ربط جهاز")
+    print("ثم اختر الربط باستخدام رقم الهاتف وأدخل الكود.")
+
+    await client.wait_until_ready()
+    await client.wait_closed()
+
+asyncio.run(main())
+```
+
+استخدم الرقم الدولي بدون `+` أو مسافات. إذا كانت جلسة `auth` محفوظة، شغّل البرنامج وانتظر الاتصال ولا تطلب كودًا جديدًا.
+
+## الرسائل والوسائط
+
+```python
+await client.send_text("201099887766", "مرحبًا من nava-link")
+await client.send_message("201099887766", {"text": "رسالة مخصصة"})
+await client.send_image("201099887766", "/storage/emulated/0/photo.jpg", "صورة")
+await client.send_video("201099887766", "/storage/emulated/0/video.mp4", "فيديو")
+await client.send_document("201099887766", "/storage/emulated/0/file.pdf", "file.pdf", "application/pdf")
+await client.send_audio("201099887766", "/storage/emulated/0/audio.mp3", "audio/mpeg")
+await client.send_location("201099887766", 25.2048, 55.2708, "دبي")
+```
+
+## استقبال الرسائل
+
+```python
+async def on_messages(event):
+    for message in event["messages"]:
+        print(message.chat_id, message.sender_id, message.text)
+        if message.text == "!ping":
+            await client.send_text(message.chat_id, "pong")
+
+client.on("messages.upsert", on_messages)
+```
+
+الأحداث: `qr`, `ready`, `messages.upsert`, `messages.update`, `groups.update`, `presence.update`, `contacts.upsert`, `contacts.update`, `close`, `error`, `log`.
+
+```python
+client.on("ready", handler)
+client.off("ready", handler)
+```
+
+## الحساب والحالة
+
+```python
+await client.send_presence("composing", "201099887766@s.whatsapp.net")
+await client.check_number(["201099887766", "971501234567"])
+await client.get_status("201099887766@s.whatsapp.net")
+await client.get_profile_picture("201099887766@s.whatsapp.net")
+await client.get_blocklist()
+await client.update_profile_name("اسم تجريبي")
+await client.update_profile_status("متاح الآن")
+await client.update_profile_picture("201099887766@s.whatsapp.net", "/storage/emulated/0/profile.jpg")
+await client.block("201099887766@s.whatsapp.net", "block")
+await client.block("201099887766@s.whatsapp.net", "unblock")
+```
+
+## الأجهزة والمحادثات وجهات الاتصال
+
+```python
+await client.get_devices()
+await client.get_chats()
+await client.get_contacts()
+```
+
+تعيد المحادثات وجهات الاتصال التي رصدتها الجلسة أثناء التشغيل الحالي.
+
+## الوسائط والرسائل
+
+```python
+await client.download_media(message.raw, "/storage/emulated/0/downloaded_file")
+await client.forward_message("201099887766", message.raw)
+await client.edit_message("201099887766", {"remoteJid": "201099887766@s.whatsapp.net", "fromMe": True, "id": "MESSAGE_ID"}, "النص الجديد")
+await client.delete_message({"remoteJid": "201099887766@s.whatsapp.net", "fromMe": True, "id": "MESSAGE_ID"})
+await client.mark_as_read([{"remoteJid": "201099887766@s.whatsapp.net", "fromMe": False, "id": "MESSAGE_ID"}])
+```
+
+## المجموعات
+
+```python
+await client.create_group("مجموعة تجريبية", ["201099887766", "971501234567"])
+await client.get_group_info("120363000000000000@g.us")
+await client.update_group_subject("120363000000000000@g.us", "اسم جديد")
+await client.update_group_description("120363000000000000@g.us", "وصف جديد")
+await client.update_group_participants("120363000000000000@g.us", ["201099887766"], "add")
+await client.get_group_invite_code("120363000000000000@g.us")
+await client.revoke_group_invite("120363000000000000@g.us")
+await client.update_group_settings("120363000000000000@g.us", "announcement")
+await client.accept_group_invite("INVITE_CODE")
+```
+
+إجراءات الأعضاء: `add`, `remove`, `promote`, `demote`.
+
+## إدارة الاتصال
+
+```python
+await client.start()
+await client.wait_until_ready()
+await client.wait_closed()
+await client.close()
+await client.logout()
+print(client.connected, client.alive)
+```
+
+## الطلبات المتقدمة
+
+```python
+await client.raw_request("fetchStatus", "201099887766@s.whatsapp.net")
+await client.relay_message("201099887766@s.whatsapp.net", {"conversation": "رسالة"}, {})
+```
+
+استخدم البيانات الصحيحة وبأحجام معقولة فقط. لا ترسل بيانات مصطنعة أو ضخمة، ولا تستخدم المكتبة للإزعاج أو الإغراق.
+
+## قائمة الدوال الكاملة
+
+```text
+start, wait_until_ready, wait_closed, request_pairing_code
+send_message, send_text, send_image, send_video, send_document, send_audio, send_location
+raw_request, relay_message, send_presence, read_messages, mark_as_read
+check_number, get_status, get_profile_picture, get_blocklist
+update_profile_name, update_profile_status, update_profile_picture, block
+get_devices, get_chats, get_contacts, download_media
+forward_message, delete_message, edit_message
+create_group, get_group_info, update_group_subject, update_group_description
+update_group_participants, get_group_invite_code, revoke_group_invite
+update_group_settings, accept_group_invite, logout, close, on, off
+```
+
+## مثال بوت كامل
+
+```python
+import asyncio
+from nava_link import MoXstarClient
+
+async def main():
+    client = MoXstarClient(auth_dir="./auth")
+
+    async def on_message(event):
+        for message in event["messages"]:
+            if message.text == "!ping":
+                await client.send_text(message.chat_id, "pong")
+
+    client.on("messages.upsert", on_message)
+    client.on("ready", lambda _: print("تم الاتصال"))
+    client.on("error", lambda error: print("خطأ:", error))
+    await client.start()
+    await client.wait_until_ready()
+    print("البوت يعمل الآن")
+    try:
+        await client.wait_closed()
+    finally:
+        await client.close()
+
+asyncio.run(main())
+```
+
+## ملاحظات أمنية
+
+- لا تشارك مجلد `auth` أو رمز الاقتران أو QR.
+- لا تشغّل نسختين باستخدام مجلد الجلسة نفسه.
+- لا تحذف `auth` إذا كنت تريد الاحتفاظ بالجلسة.
+- استخدم أرقامًا دولية بدون `+` أو مسافات.
+- تجنب الرسائل الجماعية أو المتكررة.
+
+PyPI: https://pypi.org/project/nava-link/

nava_link-1.0.0/README.md

@@ -0,0 +1,204 @@
+# nava-link
+
+مكتبة Python لإنشاء تطبيقات وبوتات واتساب بواجهة بسيطة. تدعم الاتصال بكود الاقتران، استقبال الرسائل، إرسال النصوص والوسائط، إدارة المجموعات، الحساب، الجلسة، المحادثات، جهات الاتصال والأجهزة.
+
+> المكتبة غير رسمية وغير تابعة لشركة WhatsApp أو Meta. استخدمها وفق القوانين وشروط الخدمة، وتجنب الرسائل المزعجة أو الإرسال العشوائي.
+
+## التثبيت
+
+على Termux:
+
+```bash
+pkg update -y
+pkg install -y python nodejs-lts
+pip install nava-link==1.0.0
+```
+
+الاستيراد:
+
+```python
+from nava_link import MoXstarClient
+```
+
+## الاتصال بكود الاقتران
+
+```python
+import asyncio
+from nava_link import MoXstarClient
+
+PHONE = "971501234567"
+
+async def main():
+    client = MoXstarClient(auth_dir="./auth")
+    client.on("ready", lambda _: print("تم الاتصال"))
+    client.on("error", lambda error: print("خطأ:", error))
+
+    await client.start()
+    await asyncio.sleep(5)
+    code = await client.request_pairing_code(PHONE)
+    print("كود الاقتران:", code)
+    print("واتساب > الإعدادات > الأجهزة المرتبطة > ربط جهاز")
+    print("ثم اختر الربط باستخدام رقم الهاتف وأدخل الكود.")
+
+    await client.wait_until_ready()
+    await client.wait_closed()
+
+asyncio.run(main())
+```
+
+استخدم الرقم الدولي بدون `+` أو مسافات. إذا كانت جلسة `auth` محفوظة، شغّل البرنامج وانتظر الاتصال ولا تطلب كودًا جديدًا.
+
+## الرسائل والوسائط
+
+```python
+await client.send_text("201099887766", "مرحبًا من nava-link")
+await client.send_message("201099887766", {"text": "رسالة مخصصة"})
+await client.send_image("201099887766", "/storage/emulated/0/photo.jpg", "صورة")
+await client.send_video("201099887766", "/storage/emulated/0/video.mp4", "فيديو")
+await client.send_document("201099887766", "/storage/emulated/0/file.pdf", "file.pdf", "application/pdf")
+await client.send_audio("201099887766", "/storage/emulated/0/audio.mp3", "audio/mpeg")
+await client.send_location("201099887766", 25.2048, 55.2708, "دبي")
+```
+
+## استقبال الرسائل
+
+```python
+async def on_messages(event):
+    for message in event["messages"]:
+        print(message.chat_id, message.sender_id, message.text)
+        if message.text == "!ping":
+            await client.send_text(message.chat_id, "pong")
+
+client.on("messages.upsert", on_messages)
+```
+
+الأحداث: `qr`, `ready`, `messages.upsert`, `messages.update`, `groups.update`, `presence.update`, `contacts.upsert`, `contacts.update`, `close`, `error`, `log`.
+
+```python
+client.on("ready", handler)
+client.off("ready", handler)
+```
+
+## الحساب والحالة
+
+```python
+await client.send_presence("composing", "201099887766@s.whatsapp.net")
+await client.check_number(["201099887766", "971501234567"])
+await client.get_status("201099887766@s.whatsapp.net")
+await client.get_profile_picture("201099887766@s.whatsapp.net")
+await client.get_blocklist()
+await client.update_profile_name("اسم تجريبي")
+await client.update_profile_status("متاح الآن")
+await client.update_profile_picture("201099887766@s.whatsapp.net", "/storage/emulated/0/profile.jpg")
+await client.block("201099887766@s.whatsapp.net", "block")
+await client.block("201099887766@s.whatsapp.net", "unblock")
+```
+
+## الأجهزة والمحادثات وجهات الاتصال
+
+```python
+await client.get_devices()
+await client.get_chats()
+await client.get_contacts()
+```
+
+تعيد المحادثات وجهات الاتصال التي رصدتها الجلسة أثناء التشغيل الحالي.
+
+## الوسائط والرسائل
+
+```python
+await client.download_media(message.raw, "/storage/emulated/0/downloaded_file")
+await client.forward_message("201099887766", message.raw)
+await client.edit_message("201099887766", {"remoteJid": "201099887766@s.whatsapp.net", "fromMe": True, "id": "MESSAGE_ID"}, "النص الجديد")
+await client.delete_message({"remoteJid": "201099887766@s.whatsapp.net", "fromMe": True, "id": "MESSAGE_ID"})
+await client.mark_as_read([{"remoteJid": "201099887766@s.whatsapp.net", "fromMe": False, "id": "MESSAGE_ID"}])
+```
+
+## المجموعات
+
+```python
+await client.create_group("مجموعة تجريبية", ["201099887766", "971501234567"])
+await client.get_group_info("120363000000000000@g.us")
+await client.update_group_subject("120363000000000000@g.us", "اسم جديد")
+await client.update_group_description("120363000000000000@g.us", "وصف جديد")
+await client.update_group_participants("120363000000000000@g.us", ["201099887766"], "add")
+await client.get_group_invite_code("120363000000000000@g.us")
+await client.revoke_group_invite("120363000000000000@g.us")
+await client.update_group_settings("120363000000000000@g.us", "announcement")
+await client.accept_group_invite("INVITE_CODE")
+```
+
+إجراءات الأعضاء: `add`, `remove`, `promote`, `demote`.
+
+## إدارة الاتصال
+
+```python
+await client.start()
+await client.wait_until_ready()
+await client.wait_closed()
+await client.close()
+await client.logout()
+print(client.connected, client.alive)
+```
+
+## الطلبات المتقدمة
+
+```python
+await client.raw_request("fetchStatus", "201099887766@s.whatsapp.net")
+await client.relay_message("201099887766@s.whatsapp.net", {"conversation": "رسالة"}, {})
+```
+
+استخدم البيانات الصحيحة وبأحجام معقولة فقط. لا ترسل بيانات مصطنعة أو ضخمة، ولا تستخدم المكتبة للإزعاج أو الإغراق.
+
+## قائمة الدوال الكاملة
+
+```text
+start, wait_until_ready, wait_closed, request_pairing_code
+send_message, send_text, send_image, send_video, send_document, send_audio, send_location
+raw_request, relay_message, send_presence, read_messages, mark_as_read
+check_number, get_status, get_profile_picture, get_blocklist
+update_profile_name, update_profile_status, update_profile_picture, block
+get_devices, get_chats, get_contacts, download_media
+forward_message, delete_message, edit_message
+create_group, get_group_info, update_group_subject, update_group_description
+update_group_participants, get_group_invite_code, revoke_group_invite
+update_group_settings, accept_group_invite, logout, close, on, off
+```
+
+## مثال بوت كامل
+
+```python
+import asyncio
+from nava_link import MoXstarClient
+
+async def main():
+    client = MoXstarClient(auth_dir="./auth")
+
+    async def on_message(event):
+        for message in event["messages"]:
+            if message.text == "!ping":
+                await client.send_text(message.chat_id, "pong")
+
+    client.on("messages.upsert", on_message)
+    client.on("ready", lambda _: print("تم الاتصال"))
+    client.on("error", lambda error: print("خطأ:", error))
+    await client.start()
+    await client.wait_until_ready()
+    print("البوت يعمل الآن")
+    try:
+        await client.wait_closed()
+    finally:
+        await client.close()
+
+asyncio.run(main())
+```
+
+## ملاحظات أمنية
+
+- لا تشارك مجلد `auth` أو رمز الاقتران أو QR.
+- لا تشغّل نسختين باستخدام مجلد الجلسة نفسه.
+- لا تحذف `auth` إذا كنت تريد الاحتفاظ بالجلسة.
+- استخدم أرقامًا دولية بدون `+` أو مسافات.
+- تجنب الرسائل الجماعية أو المتكررة.
+
+PyPI: https://pypi.org/project/nava-link/

nava_link-1.0.0/nava_link/__init__.py

@@ -0,0 +1,4 @@
+from .client import MoXstarClient, Message, ConnectionState, BridgeError, BridgeOffline, BridgeTimeout
+
+__all__ = ["MoXstarClient", "Message", "ConnectionState", "BridgeError", "BridgeOffline", "BridgeTimeout"]
+__version__ = "1.0.0"

nava_link-1.0.0/nava_link/client.py

@@ -0,0 +1,368 @@
+from __future__ import annotations
+
+import asyncio
+import json
+import os
+import shutil
+import subprocess
+import sys
+import time
+import platform
+from dataclasses import dataclass
+from enum import Enum
+from pathlib import Path
+from typing import Any, Awaitable, Callable
+
+Handler = Callable[[Any], Any]
+
+
+class BridgeError(RuntimeError):
+    pass
+
+
+class BridgeOffline(BridgeError):
+    pass
+
+
+class BridgeTimeout(BridgeError):
+    pass
+
+
+class ConnectionState(str, Enum):
+    DISCONNECTED = "disconnected"
+    STARTING = "starting"
+    CONNECTED = "connected"
+    CLOSED = "closed"
+
+
+@dataclass(slots=True)
+class Message:
+    id: str
+    chat_id: str
+    sender_id: str | None = None
+    from_me: bool = False
+    is_group: bool = False
+    text: str | None = None
+    type: str = "unknown"
+    timestamp: int | None = None
+    push_name: str | None = None
+    raw: dict[str, Any] | None = None
+
+    @classmethod
+    def from_dict(cls, value: dict[str, Any]) -> "Message":
+        return cls(id=value.get("id", ""), chat_id=value.get("chat_id", ""), sender_id=value.get("sender_id"), from_me=bool(value.get("from_me")), is_group=bool(value.get("is_group")), text=value.get("text"), type=value.get("type", "unknown"), timestamp=value.get("timestamp"), push_name=value.get("push_name"), raw=value.get("raw"))
+
+
+class EventBus:
+    def __init__(self) -> None:
+        self._handlers: dict[str, list[Handler]] = {}
+
+    def on(self, event: str, handler: Handler) -> Handler:
+        self._handlers.setdefault(event, []).append(handler)
+        return handler
+
+    def off(self, event: str, handler: Handler) -> None:
+        if event in self._handlers and handler in self._handlers[event]:
+            self._handlers[event].remove(handler)
+
+    async def emit(self, event: str, value: Any) -> None:
+        for handler in tuple(self._handlers.get(event, ())):
+            result = handler(value)
+            if inspect_awaitable(result):
+                await result
+
+
+def inspect_awaitable(value: Any) -> bool:
+    return hasattr(value, "__await__")
+
+
+class MoXstarClient:
+    """Python-native nava_link client backed by an embedded messaging process."""
+
+    def __init__(self, auth_dir: str = "./auth", runtime_dir: str | None = None, auto_install: bool = True, node_path: str | None = None) -> None:
+        self.auth_dir = Path(auth_dir).expanduser().resolve()
+        self.runtime_dir = Path(runtime_dir or (Path.home() / ".nava_link_runtime")).expanduser().resolve()
+        self.auto_install = auto_install
+        self.node_path = node_path
+        self.process: asyncio.subprocess.Process | None = None
+        self.events = EventBus()
+        self._pending: dict[str, asyncio.Future[dict[str, Any]]] = {}
+        self._counter = 0
+        self._reader_task: asyncio.Task[None] | None = None
+        self._stderr_task: asyncio.Task[None] | None = None
+        self._waiter: asyncio.Future[None] | None = None
+        self._ready = False
+        self.auth_dir.mkdir(parents=True, exist_ok=True)
+
+    @staticmethod
+    def _is_termux() -> bool:
+        # Termux reports Linux but exposes these environment markers.
+        return bool(
+            os.environ.get("TERMUX_VERSION")
+            or os.environ.get("PREFIX", "").startswith("/data/data/com.termux")
+        )
+
+    def on(self, event: str, handler: Handler) -> Handler:
+        return self.events.on(event, handler)
+
+    def off(self, event: str, handler: Handler) -> None:
+        self.events.off(event, handler)
+
+    @property
+    def connected(self) -> bool:
+        return self._ready and self.process is not None and self.process.returncode is None
+
+    @property
+    def alive(self) -> bool:
+        return self.process is not None and self.process.returncode is None
+
+    def _ensure_runtime(self) -> Path:
+        source_dir = Path(__file__).resolve().parent
+        bundled_dir = source_dir / "runtime"
+        bundled_node = bundled_dir / ("node.exe" if sys.platform == "win32" else "node")
+        bundled_engine = bundled_dir / "engine.js"
+        bundled_baileys = bundled_dir / "node_modules" / "@whiskeysockets" / "baileys" / "package.json"
+        # Android/Termux cannot execute the desktop Node binary shipped in
+        # desktop wheels. Always use Termux's nodejs-lts there.
+        if not self._is_termux() and not self.node_path and bundled_node.exists() and bundled_engine.exists() and bundled_baileys.exists():
+            return bundled_engine
+        node = self.node_path or os.environ.get("NAVAPRO_NODE") or shutil.which("node")
+        npm = os.environ.get("NAVAPRO_NPM") or shutil.which("npm")
+        if not node:
+            raise BridgeError("No Node.js runtime found. In Termux run: pkg update && pkg install nodejs-lts")
+        if not npm:
+            raise BridgeError("No npm found. In Termux install nodejs-lts (it provides npm).")
+        self.runtime_dir.mkdir(parents=True, exist_ok=True)
+        package = self.runtime_dir / "package.json"
+        engine = self.runtime_dir / "engine.js"
+        package.write_text((source_dir / "package.json").read_text(encoding="utf-8"), encoding="utf-8")
+        engine.write_text((source_dir / "engine.js").read_text(encoding="utf-8"), encoding="utf-8")
+        installed = self.runtime_dir / "node_modules" / "@whiskeysockets" / "baileys" / "package.json"
+        if not installed.exists():
+            if not self.auto_install:
+                raise BridgeError("Baileys is not installed. Use auto_install=True or run npm install in the runtime directory.")
+            subprocess.run([npm, "install", "--no-audit", "--no-fund", "--save-exact"], cwd=self.runtime_dir, check=True)
+        return engine
+
+    def _node_executable(self) -> str | None:
+        """Return the bundled node binary when present, otherwise a system Node."""
+        bundled = Path(__file__).resolve().parent / "runtime" / ("node.exe" if sys.platform == "win32" else "node")
+        if not self._is_termux() and bundled.exists():
+            return str(bundled)
+        return self.node_path or os.environ.get("NAVAPRO_NODE") or shutil.which("node")
+
+    async def start(self) -> None:
+        if self.alive:
+            return
+        engine = self._ensure_runtime()
+        node = self._node_executable()
+        if not node:
+            raise BridgeError("nava_link could not locate its bundled or system Node runtime.")
+        env = os.environ.copy()
+        env["nava_link_AUTH_DIR"] = str(self.auth_dir)
+        self.process = await asyncio.create_subprocess_exec(node, str(engine), cwd=str(engine.parent), env=env, stdin=asyncio.subprocess.PIPE, stdout=asyncio.subprocess.PIPE, stderr=asyncio.subprocess.PIPE)
+        self._waiter = asyncio.get_running_loop().create_future()
+        self._reader_task = asyncio.create_task(self._read_stdout())
+        self._stderr_task = asyncio.create_task(self._read_stderr())
+        await self._request("start")
+
+    async def _read_stdout(self) -> None:
+        assert self.process and self.process.stdout
+        async for raw in self.process.stdout:
+            try:
+                packet = json.loads(raw.decode("utf-8"))
+            except (UnicodeDecodeError, json.JSONDecodeError):
+                continue
+            request_id = packet.get("request_id")
+            if request_id and request_id in self._pending:
+                future = self._pending.pop(request_id)
+                if not future.done():
+                    future.set_result(packet)
+                continue
+            event = packet.get("event")
+            data = packet.get("data")
+            if event == "ready":
+                self._ready = True
+                if self._waiter and not self._waiter.done(): self._waiter.set_result(None)
+            elif event == "close":
+                self._ready = False
+            elif event == "error":
+                await self.events.emit("error", BridgeError(data.get("message", "Engine error")))
+            if event:
+                if event == "messages.upsert" and isinstance(data, dict):
+                    data = {**data, "messages": [Message.from_dict(x) for x in data.get("messages", [])]}
+                await self.events.emit(event, data)
+
+    async def _read_stderr(self) -> None:
+        if not self.process or not self.process.stderr:
+            return
+        async for raw in self.process.stderr:
+            await self.events.emit("log", raw.decode("utf-8", errors="replace").rstrip())
+
+    async def _request(self, action: str, timeout: float = 30.0, **payload: Any) -> dict[str, Any]:
+        if not self.process or not self.process.stdin or self.process.returncode is not None:
+            raise BridgeOffline("nava_link engine is not running")
+        self._counter += 1
+        request_id = str(self._counter)
+        future: asyncio.Future[dict[str, Any]] = asyncio.get_running_loop().create_future()
+        self._pending[request_id] = future
+        command = {"action": action, "request_id": request_id, **payload}
+        try:
+            self.process.stdin.write((json.dumps(command, ensure_ascii=False) + "\n").encode())
+            await self.process.stdin.drain()
+            packet = await asyncio.wait_for(future, timeout)
+        except asyncio.TimeoutError as exc:
+            self._pending.pop(request_id, None)
+            raise BridgeTimeout(f"Timed out waiting for {action}") from exc
+        if not packet.get("ok"):
+            raise BridgeError(packet.get("error", {}).get("message", "Engine request failed"))
+        return packet.get("result", {})
+
+    async def wait_until_ready(self, timeout: float | None = None) -> None:
+        if self.connected:
+            return
+        if self._waiter is None:
+            raise BridgeOffline("Call start() first")
+        await asyncio.wait_for(asyncio.shield(self._waiter), timeout) if timeout else await self._waiter
+
+    async def wait_closed(self) -> None:
+        if self.process:
+            await self.process.wait()
+
+    async def request_pairing_code(self, phone: str) -> str:
+        return str((await self._request("pairing_code", phone=phone))["code"])
+
+    async def send_message(self, to: str, content: dict[str, Any]) -> dict[str, Any]:
+        return await self._request("send_message", to=to, content=content)
+
+    async def send_text(self, to: str, text: str) -> dict[str, Any]:
+        if not isinstance(text, str) or not 1 <= len(text) <= 4096:
+            raise ValueError("text must be between 1 and 4096 characters")
+        return await self.send_message(to, {"text": text})
+
+    async def send_image(self, to: str, image: str | bytes, caption: str | None = None) -> dict[str, Any]:
+        return await self.send_message(to, {"image": image.decode() if isinstance(image, bytes) else image, "caption": caption})
+
+    async def send_video(self, to: str, video: str | bytes, caption: str | None = None) -> dict[str, Any]:
+        return await self.send_message(to, {"video": video.decode() if isinstance(video, bytes) else video, "caption": caption})
+
+    async def send_document(self, to: str, document: str | bytes, file_name: str, mimetype: str = "application/octet-stream") -> dict[str, Any]:
+        return await self.send_message(to, {"document": document.decode() if isinstance(document, bytes) else document, "fileName": file_name, "mimetype": mimetype})
+
+    async def send_audio(self, to: str, audio: str | bytes, mimetype: str = "audio/mp4") -> dict[str, Any]:
+        return await self.send_message(to, {"audio": audio.decode() if isinstance(audio, bytes) else audio, "mimetype": mimetype})
+
+    async def send_location(self, to: str, latitude: float, longitude: float, name: str | None = None) -> dict[str, Any]:
+        return await self.send_message(to, {"location": {"degreesLatitude": latitude, "degreesLongitude": longitude, "name": name}})
+
+    async def raw_request(self, method: str, *args: Any) -> Any:
+        """Call a supported Baileys socket method for advanced use cases."""
+        return (await self._request("baileys_call", method=method, args=list(args))).get("value")
+
+    async def relay_message(self, jid: str, message: dict[str, Any], options: dict[str, Any] | None = None) -> Any:
+        return await self.raw_request("relayMessage", jid, message, options or {})
+
+    async def send_presence(self, presence: str, to: str | None = None) -> Any:
+        return await self.raw_request("sendPresenceUpdate", presence, to)
+
+    async def read_messages(self, keys: list[dict[str, Any]]) -> Any:
+        return await self.raw_request("readMessages", keys)
+
+    async def check_number(self, numbers: list[str]) -> Any:
+        return await self.raw_request("onWhatsApp", numbers)
+
+    async def get_status(self, jid: str) -> Any:
+        return await self.raw_request("fetchStatus", jid)
+
+    async def get_profile_picture(self, jid: str, picture_type: str = "image") -> Any:
+        return await self.raw_request("profilePictureUrl", jid, picture_type)
+
+    async def get_blocklist(self) -> Any:
+        return await self.raw_request("fetchBlocklist")
+
+    async def update_profile_name(self, name: str) -> Any:
+        return await self.raw_request("updateProfileName", name)
+
+    async def update_profile_status(self, status: str) -> Any:
+        return await self.raw_request("updateProfileStatus", status)
+
+    async def update_profile_picture(self, jid: str, image: str | bytes) -> Any:
+        return await self.raw_request("updateProfilePicture", jid, image.decode() if isinstance(image, bytes) else image)
+
+    async def block(self, jid: str, action: str = "block") -> Any:
+        return await self.raw_request("updateBlockStatus", jid, action)
+
+    async def create_group(self, subject: str, participants: list[str]) -> Any:
+        return await self.raw_request("groupCreate", subject, participants)
+
+    async def get_group_info(self, jid: str) -> Any:
+        return await self.raw_request("groupMetadata", jid)
+
+    async def update_group_subject(self, jid: str, subject: str) -> Any:
+        return await self.raw_request("groupUpdateSubject", jid, subject)
+
+    async def update_group_description(self, jid: str, description: str) -> Any:
+        return await self.raw_request("groupUpdateDescription", jid, description)
+
+    async def update_group_participants(self, jid: str, participants: list[str], action: str) -> Any:
+        return await self.raw_request("groupParticipantsUpdate", jid, participants, action)
+
+    async def get_group_invite_code(self, jid: str) -> Any:
+        return await self.raw_request("groupInviteCode", jid)
+
+    async def revoke_group_invite(self, jid: str) -> Any:
+        return await self.raw_request("groupRevokeInvite", jid)
+
+    async def update_group_settings(self, jid: str, setting: str) -> Any:
+        return await self.raw_request("groupSettingUpdate", jid, setting)
+
+    async def accept_group_invite(self, code: str) -> Any:
+        return await self.raw_request("groupAcceptInvite", code)
+
+    async def get_devices(self, jids: list[str] | None = None) -> Any:
+        """Return linked-device records for the supplied JIDs or the account."""
+        return await self.raw_request("getUSyncDevices", jids or [], False, False)
+
+    async def get_chats(self) -> list[dict[str, Any]]:
+        """Return chats observed by the running client session."""
+        return list((await self._request("get_chats")).get("chats", []))
+
+    async def get_contacts(self) -> list[dict[str, Any]]:
+        """Return contacts observed by the running client session."""
+        return list((await self._request("get_contacts")).get("contacts", []))
+
+    async def download_media(self, message: dict[str, Any], output_path: str | None = None) -> bytes | str:
+        """Download media from a raw message; optionally save it to output_path."""
+        import base64
+        result = await self._request("download_media", message=message)
+        data = base64.b64decode(result["data"])
+        if output_path is not None:
+            from pathlib import Path
+            Path(output_path).write_bytes(data)
+            return output_path
+        return data
+
+    async def forward_message(self, to: str, message: dict[str, Any]) -> dict[str, Any]:
+        return await self._request("forward_message", to=to, message=message)
+
+    async def delete_message(self, key: dict[str, Any], jid: str | None = None) -> Any:
+        return await self.raw_request("chatModify", {"delete": key}, {"jid": jid} if jid else {})
+
+    async def edit_message(self, jid: str, key: dict[str, Any], text: str) -> dict[str, Any]:
+        return await self._request("edit_message", to=jid, key=key, text=text)
+
+    async def mark_as_read(self, keys: list[dict[str, Any]]) -> Any:
+        return await self.read_messages(keys)
+
+    async def logout(self) -> None:
+        await self._request("logout")
+        self._ready = False
+
+    async def close(self) -> None:
+        if self.alive:
+            try: await self._request("exit", timeout=5)
+            except BridgeError: pass
+        if self.process and self.process.returncode is None:
+            try: await asyncio.wait_for(self.process.wait(), 5)
+            except asyncio.TimeoutError: self.process.kill()
+        self._ready = False

nava_link-1.0.0/nava_link/engine.js

@@ -0,0 +1,107 @@
+const readline = require('readline');
+const makeWASocket = require('@whiskeysockets/baileys').default;
+const { useMultiFileAuthState, DisconnectReason, Browsers, downloadMediaMessage } = require('@whiskeysockets/baileys');
+
+const authDir = process.env.nava_link_AUTH_DIR || './auth';
+let sock = null;
+let ready = false;
+let stopping = false;
+const chats = new Map();
+const contacts = new Map();
+
+function out(value) { process.stdout.write(JSON.stringify(value) + '\n'); }
+function errorMessage(e) { return String(e?.message || e); }
+function textOf(m) {
+  const c = m?.message || {};
+  return c.conversation || c.extendedTextMessage?.text || c.imageMessage?.caption || c.videoMessage?.caption || c.documentMessage?.caption;
+}
+function normalize(m) {
+  const jid = m?.key?.remoteJid || '';
+  return { id: m?.key?.id || '', chat_id: jid, sender_id: m?.key?.participant || (m?.key?.fromMe ? null : jid), from_me: !!m?.key?.fromMe, is_group: jid.endsWith('@g.us'), text: textOf(m), type: Object.keys(m?.message || {})[0] || 'unknown', timestamp: Number(m?.messageTimestamp || 0) || null, push_name: m?.pushName || null, raw: m };
+}
+
+async function start() {
+  const { state, saveCreds } = await useMultiFileAuthState(authDir);
+  sock = makeWASocket({ auth: state, printQRInTerminal: false, browser: Browsers.ubuntu('Chrome'), markOnlineOnConnect: false, syncFullHistory: false });
+  sock.ev.on('creds.update', saveCreds);
+  sock.ev.on('connection.update', ({ connection, lastDisconnect, qr }) => {
+    if (qr) out({ event: 'qr', data: qr });
+    if (connection === 'open') { ready = true; out({ event: 'ready', data: {} }); }
+    if (connection === 'close') {
+      ready = false;
+      const code = lastDisconnect?.error?.output?.statusCode || null;
+      out({ event: 'close', data: { code } });
+      if (!stopping && code !== DisconnectReason.loggedOut) setTimeout(() => start().catch(e => out({ event: 'error', data: { message: errorMessage(e) } })), 2000);
+    }
+  });
+  sock.ev.on('messages.upsert', ({ messages, type }) => {
+    for (const m of messages) { const jid = m?.key?.remoteJid; if (jid) chats.set(jid, { id: jid, unread: (chats.get(jid)?.unread || 0) + (m?.key?.fromMe ? 0 : 1), lastMessage: normalize(m) }); }
+    out({ event: 'messages.upsert', data: { type, messages: messages.map(normalize) } });
+  });
+  sock.ev.on('contacts.upsert', items => { for (const item of items) if (item?.id) contacts.set(item.id, item); out({ event: 'contacts.upsert', data: items }); });
+  sock.ev.on('contacts.update', items => { for (const item of items) if (item?.id) contacts.set(item.id, { ...(contacts.get(item.id) || {}), ...item }); out({ event: 'contacts.update', data: items }); });
+  sock.ev.on('messages.update', updates => out({ event: 'messages.update', data: updates }));
+  sock.ev.on('groups.update', updates => out({ event: 'groups.update', data: updates }));
+  sock.ev.on('presence.update', update => out({ event: 'presence.update', data: update }));
+}
+
+async function command(c) {
+  if (c.action === 'status') return out({ request_id: c.request_id, ok: true, result: { ready, alive: true } });
+  if (c.action === 'start') return out({ request_id: c.request_id, ok: true, result: { starting: true } });
+  if (c.action === 'send_message') {
+    if (!sock || !ready) throw new Error('WhatsApp is not connected');
+    const jid = String(c.to).replace(/\D/g, '') + '@s.whatsapp.net';
+    const result = await sock.sendMessage(jid, c.content || { text: c.text });
+    return out({ request_id: c.request_id, ok: true, result: { id: result?.key?.id || null, to: jid } });
+  }
+  if (c.action === 'pairing_code') {
+    if (!sock) throw new Error('WhatsApp socket is not initialized');
+    return out({ request_id: c.request_id, ok: true, result: { code: await sock.requestPairingCode(String(c.phone).replace(/\D/g, '')) } });
+  }
+  if (c.action === 'get_chats') return out({ request_id: c.request_id, ok: true, result: { chats: [...chats.values()] } });
+  if (c.action === 'get_contacts') return out({ request_id: c.request_id, ok: true, result: { contacts: [...contacts.values()] } });
+  if (c.action === 'download_media') {
+    const message = c.message;
+    if (!message || typeof message !== 'object') throw new Error('message object is required');
+    const buffer = await downloadMediaMessage(message, 'buffer', {});
+    return out({ request_id: c.request_id, ok: true, result: { data: Buffer.from(buffer).toString('base64') } });
+  }
+  if (c.action === 'forward_message') {
+    if (!sock || !ready) throw new Error('WhatsApp is not connected');
+    const jid = String(c.to).replace(/\D/g, '') + '@s.whatsapp.net';
+    const result = await sock.sendMessage(jid, { forward: c.message });
+    return out({ request_id: c.request_id, ok: true, result: { id: result?.key?.id || null, to: jid } });
+  }
+  if (c.action === 'edit_message') {
+    if (!sock || !ready) throw new Error('WhatsApp is not connected');
+    const jid = String(c.to).replace(/\D/g, '') + '@s.whatsapp.net';
+    const result = await sock.sendMessage(jid, { text: String(c.text) }, { edit: c.key });
+    return out({ request_id: c.request_id, ok: true, result: { id: result?.key?.id || null, to: jid } });
+  }
+  if (c.action === 'baileys_call') {
+    if (!sock || !ready) throw new Error('WhatsApp is not connected');
+    const allowed = new Set([
+      'relayMessage', 'sendPresenceUpdate', 'readMessages', 'onWhatsApp',
+      'fetchStatus', 'profilePictureUrl', 'fetchBlocklist',
+      'updateProfileName', 'updateProfileStatus', 'updateProfilePicture',
+      'updateBlockStatus', 'groupCreate', 'groupMetadata',
+      'groupUpdateSubject', 'groupUpdateDescription',
+      'groupParticipantsUpdate', 'groupInviteCode', 'groupRevokeInvite',
+      'groupSettingUpdate', 'groupAcceptInvite', 'chatModify', 'presenceSubscribe', 'getUSyncDevices'
+    ]);
+    if (!allowed.has(String(c.method)) || typeof sock[c.method] !== 'function') throw new Error('Unsupported Baileys method: ' + c.method);
+    const args = Array.isArray(c.args) ? c.args : [];
+    const value = await sock[c.method](...args);
+    return out({ request_id: c.request_id, ok: true, result: { value } });
+  }
+  if (c.action === 'logout') { stopping = true; await sock?.logout(); return out({ request_id: c.request_id, ok: true, result: {} }); }
+  if (c.action === 'exit') { stopping = true; sock?.end(undefined); out({ request_id: c.request_id, ok: true, result: {} }); process.exit(0); }
+  throw new Error('Unknown action: ' + c.action);
+}
+
+readline.createInterface({ input: process.stdin, crlfDelay: Infinity }).on('line', line => {
+  if (!line.trim()) return;
+  try { const c = JSON.parse(line); command(c).catch(e => out({ request_id: c.request_id, ok: false, error: { message: errorMessage(e) } })); }
+  catch (e) { out({ ok: false, error: { message: errorMessage(e) } }); }
+});
+start().catch(e => out({ event: 'error', data: { message: errorMessage(e) } }));

nava_link-1.0.0/nava_link/package.json

@@ -0,0 +1 @@
+{"private":true,"type":"commonjs","dependencies":{"@whiskeysockets/baileys":"6.7.24"}}

nava_link-1.0.0/nava_link/runtime/engine.js

@@ -0,0 +1,64 @@
+const readline = require('readline');
+const makeWASocket = require('@whiskeysockets/baileys').default;
+const { useMultiFileAuthState, DisconnectReason, Browsers } = require('@whiskeysockets/baileys');
+
+const authDir = process.env.nava_link_AUTH_DIR || './auth';
+let sock = null;
+let ready = false;
+let stopping = false;
+
+function out(value) { process.stdout.write(JSON.stringify(value) + '\n'); }
+function errorMessage(e) { return String(e?.message || e); }
+function textOf(m) {
+  const c = m?.message || {};
+  return c.conversation || c.extendedTextMessage?.text || c.imageMessage?.caption || c.videoMessage?.caption || c.documentMessage?.caption;
+}
+function normalize(m) {
+  const jid = m?.key?.remoteJid || '';
+  return { id: m?.key?.id || '', chat_id: jid, sender_id: m?.key?.participant || (m?.key?.fromMe ? null : jid), from_me: !!m?.key?.fromMe, is_group: jid.endsWith('@g.us'), text: textOf(m), type: Object.keys(m?.message || {})[0] || 'unknown', timestamp: Number(m?.messageTimestamp || 0) || null, push_name: m?.pushName || null, raw: m };
+}
+
+async function start() {
+  const { state, saveCreds } = await useMultiFileAuthState(authDir);
+  sock = makeWASocket({ auth: state, printQRInTerminal: false, browser: Browsers.ubuntu('Chrome'), markOnlineOnConnect: false, syncFullHistory: false });
+  sock.ev.on('creds.update', saveCreds);
+  sock.ev.on('connection.update', ({ connection, lastDisconnect, qr }) => {
+    if (qr) out({ event: 'qr', data: qr });
+    if (connection === 'open') { ready = true; out({ event: 'ready', data: {} }); }
+    if (connection === 'close') {
+      ready = false;
+      const code = lastDisconnect?.error?.output?.statusCode || null;
+      out({ event: 'close', data: { code } });
+      if (!stopping && code !== DisconnectReason.loggedOut) setTimeout(() => start().catch(e => out({ event: 'error', data: { message: errorMessage(e) } })), 2000);
+    }
+  });
+  sock.ev.on('messages.upsert', ({ messages, type }) => out({ event: 'messages.upsert', data: { type, messages: messages.map(normalize) } }));
+  sock.ev.on('messages.update', updates => out({ event: 'messages.update', data: updates }));
+  sock.ev.on('groups.update', updates => out({ event: 'groups.update', data: updates }));
+  sock.ev.on('presence.update', update => out({ event: 'presence.update', data: update }));
+}
+
+async function command(c) {
+  if (c.action === 'status') return out({ request_id: c.request_id, ok: true, result: { ready, alive: true } });
+  if (c.action === 'start') return out({ request_id: c.request_id, ok: true, result: { starting: true } });
+  if (c.action === 'send_message') {
+    if (!sock || !ready) throw new Error('WhatsApp is not connected');
+    const jid = String(c.to).replace(/\D/g, '') + '@s.whatsapp.net';
+    const result = await sock.sendMessage(jid, c.content || { text: c.text });
+    return out({ request_id: c.request_id, ok: true, result: { id: result?.key?.id || null, to: jid } });
+  }
+  if (c.action === 'pairing_code') {
+    if (!sock) throw new Error('WhatsApp socket is not initialized');
+    return out({ request_id: c.request_id, ok: true, result: { code: await sock.requestPairingCode(String(c.phone).replace(/\D/g, '')) } });
+  }
+  if (c.action === 'logout') { stopping = true; await sock?.logout(); return out({ request_id: c.request_id, ok: true, result: {} }); }
+  if (c.action === 'exit') { stopping = true; sock?.end(undefined); out({ request_id: c.request_id, ok: true, result: {} }); process.exit(0); }
+  throw new Error('Unknown action: ' + c.action);
+}
+
+readline.createInterface({ input: process.stdin, crlfDelay: Infinity }).on('line', line => {
+  if (!line.trim()) return;
+  try { const c = JSON.parse(line); command(c).catch(e => out({ request_id: c.request_id, ok: false, error: { message: errorMessage(e) } })); }
+  catch (e) { out({ ok: false, error: { message: errorMessage(e) } }); }
+});
+start().catch(e => out({ event: 'error', data: { message: errorMessage(e) } }));

nava_link-1.0.0/nava_link/runtime/package.json

@@ -0,0 +1 @@
+{"private":true,"type":"commonjs","dependencies":{"@whiskeysockets/baileys":"6.7.24"}}

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

@@ -0,0 +1,213 @@
+Metadata-Version: 2.4
+Name: nava-link
+Version: 1.0.0
+Summary: Python-native messaging client with an embedded runtime
+Author: nava_link contributors
+License: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# nava-link
+
+مكتبة Python لإنشاء تطبيقات وبوتات واتساب بواجهة بسيطة. تدعم الاتصال بكود الاقتران، استقبال الرسائل، إرسال النصوص والوسائط، إدارة المجموعات، الحساب، الجلسة، المحادثات، جهات الاتصال والأجهزة.
+
+> المكتبة غير رسمية وغير تابعة لشركة WhatsApp أو Meta. استخدمها وفق القوانين وشروط الخدمة، وتجنب الرسائل المزعجة أو الإرسال العشوائي.
+
+## التثبيت
+
+على Termux:
+
+```bash
+pkg update -y
+pkg install -y python nodejs-lts
+pip install nava-link==1.0.0
+```
+
+الاستيراد:
+
+```python
+from nava_link import MoXstarClient
+```
+
+## الاتصال بكود الاقتران
+
+```python
+import asyncio
+from nava_link import MoXstarClient
+
+PHONE = "971501234567"
+
+async def main():
+    client = MoXstarClient(auth_dir="./auth")
+    client.on("ready", lambda _: print("تم الاتصال"))
+    client.on("error", lambda error: print("خطأ:", error))
+
+    await client.start()
+    await asyncio.sleep(5)
+    code = await client.request_pairing_code(PHONE)
+    print("كود الاقتران:", code)
+    print("واتساب > الإعدادات > الأجهزة المرتبطة > ربط جهاز")
+    print("ثم اختر الربط باستخدام رقم الهاتف وأدخل الكود.")
+
+    await client.wait_until_ready()
+    await client.wait_closed()
+
+asyncio.run(main())
+```
+
+استخدم الرقم الدولي بدون `+` أو مسافات. إذا كانت جلسة `auth` محفوظة، شغّل البرنامج وانتظر الاتصال ولا تطلب كودًا جديدًا.
+
+## الرسائل والوسائط
+
+```python
+await client.send_text("201099887766", "مرحبًا من nava-link")
+await client.send_message("201099887766", {"text": "رسالة مخصصة"})
+await client.send_image("201099887766", "/storage/emulated/0/photo.jpg", "صورة")
+await client.send_video("201099887766", "/storage/emulated/0/video.mp4", "فيديو")
+await client.send_document("201099887766", "/storage/emulated/0/file.pdf", "file.pdf", "application/pdf")
+await client.send_audio("201099887766", "/storage/emulated/0/audio.mp3", "audio/mpeg")
+await client.send_location("201099887766", 25.2048, 55.2708, "دبي")
+```
+
+## استقبال الرسائل
+
+```python
+async def on_messages(event):
+    for message in event["messages"]:
+        print(message.chat_id, message.sender_id, message.text)
+        if message.text == "!ping":
+            await client.send_text(message.chat_id, "pong")
+
+client.on("messages.upsert", on_messages)
+```
+
+الأحداث: `qr`, `ready`, `messages.upsert`, `messages.update`, `groups.update`, `presence.update`, `contacts.upsert`, `contacts.update`, `close`, `error`, `log`.
+
+```python
+client.on("ready", handler)
+client.off("ready", handler)
+```
+
+## الحساب والحالة
+
+```python
+await client.send_presence("composing", "201099887766@s.whatsapp.net")
+await client.check_number(["201099887766", "971501234567"])
+await client.get_status("201099887766@s.whatsapp.net")
+await client.get_profile_picture("201099887766@s.whatsapp.net")
+await client.get_blocklist()
+await client.update_profile_name("اسم تجريبي")
+await client.update_profile_status("متاح الآن")
+await client.update_profile_picture("201099887766@s.whatsapp.net", "/storage/emulated/0/profile.jpg")
+await client.block("201099887766@s.whatsapp.net", "block")
+await client.block("201099887766@s.whatsapp.net", "unblock")
+```
+
+## الأجهزة والمحادثات وجهات الاتصال
+
+```python
+await client.get_devices()
+await client.get_chats()
+await client.get_contacts()
+```
+
+تعيد المحادثات وجهات الاتصال التي رصدتها الجلسة أثناء التشغيل الحالي.
+
+## الوسائط والرسائل
+
+```python
+await client.download_media(message.raw, "/storage/emulated/0/downloaded_file")
+await client.forward_message("201099887766", message.raw)
+await client.edit_message("201099887766", {"remoteJid": "201099887766@s.whatsapp.net", "fromMe": True, "id": "MESSAGE_ID"}, "النص الجديد")
+await client.delete_message({"remoteJid": "201099887766@s.whatsapp.net", "fromMe": True, "id": "MESSAGE_ID"})
+await client.mark_as_read([{"remoteJid": "201099887766@s.whatsapp.net", "fromMe": False, "id": "MESSAGE_ID"}])
+```
+
+## المجموعات
+
+```python
+await client.create_group("مجموعة تجريبية", ["201099887766", "971501234567"])
+await client.get_group_info("120363000000000000@g.us")
+await client.update_group_subject("120363000000000000@g.us", "اسم جديد")
+await client.update_group_description("120363000000000000@g.us", "وصف جديد")
+await client.update_group_participants("120363000000000000@g.us", ["201099887766"], "add")
+await client.get_group_invite_code("120363000000000000@g.us")
+await client.revoke_group_invite("120363000000000000@g.us")
+await client.update_group_settings("120363000000000000@g.us", "announcement")
+await client.accept_group_invite("INVITE_CODE")
+```
+
+إجراءات الأعضاء: `add`, `remove`, `promote`, `demote`.
+
+## إدارة الاتصال
+
+```python
+await client.start()
+await client.wait_until_ready()
+await client.wait_closed()
+await client.close()
+await client.logout()
+print(client.connected, client.alive)
+```
+
+## الطلبات المتقدمة
+
+```python
+await client.raw_request("fetchStatus", "201099887766@s.whatsapp.net")
+await client.relay_message("201099887766@s.whatsapp.net", {"conversation": "رسالة"}, {})
+```
+
+استخدم البيانات الصحيحة وبأحجام معقولة فقط. لا ترسل بيانات مصطنعة أو ضخمة، ولا تستخدم المكتبة للإزعاج أو الإغراق.
+
+## قائمة الدوال الكاملة
+
+```text
+start, wait_until_ready, wait_closed, request_pairing_code
+send_message, send_text, send_image, send_video, send_document, send_audio, send_location
+raw_request, relay_message, send_presence, read_messages, mark_as_read
+check_number, get_status, get_profile_picture, get_blocklist
+update_profile_name, update_profile_status, update_profile_picture, block
+get_devices, get_chats, get_contacts, download_media
+forward_message, delete_message, edit_message
+create_group, get_group_info, update_group_subject, update_group_description
+update_group_participants, get_group_invite_code, revoke_group_invite
+update_group_settings, accept_group_invite, logout, close, on, off
+```
+
+## مثال بوت كامل
+
+```python
+import asyncio
+from nava_link import MoXstarClient
+
+async def main():
+    client = MoXstarClient(auth_dir="./auth")
+
+    async def on_message(event):
+        for message in event["messages"]:
+            if message.text == "!ping":
+                await client.send_text(message.chat_id, "pong")
+
+    client.on("messages.upsert", on_message)
+    client.on("ready", lambda _: print("تم الاتصال"))
+    client.on("error", lambda error: print("خطأ:", error))
+    await client.start()
+    await client.wait_until_ready()
+    print("البوت يعمل الآن")
+    try:
+        await client.wait_closed()
+    finally:
+        await client.close()
+
+asyncio.run(main())
+```
+
+## ملاحظات أمنية
+
+- لا تشارك مجلد `auth` أو رمز الاقتران أو QR.
+- لا تشغّل نسختين باستخدام مجلد الجلسة نفسه.
+- لا تحذف `auth` إذا كنت تريد الاحتفاظ بالجلسة.
+- استخدم أرقامًا دولية بدون `+` أو مسافات.
+- تجنب الرسائل الجماعية أو المتكررة.
+
+PyPI: https://pypi.org/project/nava-link/

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

@@ -0,0 +1,13 @@
+README.md
+pyproject.toml
+nava_link/__init__.py
+nava_link/client.py
+nava_link/engine.js
+nava_link/package.json
+nava_link.egg-info/PKG-INFO
+nava_link.egg-info/SOURCES.txt
+nava_link.egg-info/dependency_links.txt
+nava_link.egg-info/top_level.txt
+nava_link/runtime/engine.js
+nava_link/runtime/package.json
+tests/test_client.py

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1 @@
+nava_link

nava_link-1.0.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "nava-link"
+version = "1.0.0"
+description = "Python-native messaging client with an embedded runtime"
+requires-python = ">=3.9"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [{name = "nava_link contributors"}]
+dependencies = []
+
+[tool.setuptools]
+packages = ["nava_link"]
+
+[tool.setuptools.package-data]
+nava_link = ["engine.js", "package.json", "runtime/node", "runtime/node.exe", "runtime/engine.js", "runtime/package.json", "runtime/node_modules/**/*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

nava_link-1.0.0/setup.cfg

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

nava_link-1.0.0/tests/test_client.py

@@ -0,0 +1,19 @@
+import asyncio
+from nava_link.client import Message, EventBus
+
+
+def test_message_model():
+    m = Message.from_dict({'id': 'x', 'chat_id': '1@s.whatsapp.net', 'text': 'hello'})
+    assert m.id == 'x'
+    assert m.text == 'hello'
+    assert m.chat_id == '1@s.whatsapp.net'
+
+
+def test_event_bus_supports_async_handlers():
+    async def run():
+        bus = EventBus()
+        seen = []
+        bus.on('message', lambda value: seen.append(value))
+        await bus.emit('message', 'ok')
+        assert seen == ['ok']
+    asyncio.run(run())