Metadata-Version: 2.4
Name: sting-vortex
Version: 1.0.1
Summary: مكتبة بايثون عملية لبناء بوتات وتطبيقات واتساب عبر جسر Node.js/Baileys سريع وواجهة غير متزامنة.
Author: 𝑫𝑨𝑹𝑲 (𝑺) 𝑻𝑬𝑨𝑴 𝑽𝑶𝑹𝑻𝑰𝑿 🇪🇬 (@S_V_O_R_T_I_X)
License: MIT
Project-URL: Homepage, https://pypi.org/project/sting-vortex/
Project-URL: Documentation, https://pypi.org/project/sting-vortex/
Keywords: whatsapp,bot,baileys,asyncio,sting-vortex,moxstar
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Framework :: AsyncIO
Classifier: Topic :: Communications :: Chat
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file
Dynamic: requires-python

# sting-vortex (v1.0.1)

**ابنِ تجارب واتساب بكود Python واضح.**

`sting-vortex` هي مكتبة بايثون عملية وغير متزامنة (`asyncio`) لبناء البوتات والتطبيقات الرسائلية، مبنية كجسر ثنائي الاتجاه (JSON-RPC Bridge) مع محرك Node.js (`@whiskeysockets/baileys`) لتوفير اتصال سريع، أحداث واضحة، وسطح API واحد من أول رسالة حتى إدارة المجموعات والواجهات المنخفضة المستوى.

## المميزات الرئيسية

- **+36 دالة جاهزة:** تغطي الاتصال، كود الاقتران، إرسال النصوص والوسائط، البيانات، وإدارة المجموعات.
- **10 أنواع أحداث:** نظام أحداث مرن (`messages.upsert`, `ready`, `presence.update`, `groups.update`, `contacts.upsert`, `close`, `error`, وغيرها).
- **100% Python API:** واجهة بايثون غير متزامنة بالكامل تدعم Python 3.9+.
- **واجهة متقدمة في الإصدار 1.0.1:** دعم كامل لدوال الترحيل والترميز وإدارة الجلسات (`relay_message`, `send_node`, `create_participant_nodes`, `get_usync_devices`, `assert_sessions`, `encode_wamessage`, `signal_repository`).

---

## التثبيت

في بيئة Termux أو أي نظام Linux / macOS / Windows يحتوي على Python 3.9+ و Node.js LTS:

```bash
pkg install -y python nodejs-lts
pip install sting-vortex==1.0.1
```

لتثبيت الحزمة محلياً من المصدر:

```bash
pip install -e .
# وتثبيت حزم جسر Node.js داخل مجلد الجسر:
cd sting_vortex/bridge && npm install
```

---

## البدء السريع (الاتصال بكود الاقتران وإرسال أول رسالة)

```python
import asyncio
from sting_vortex import MoXstarClient

PHONE = "201200009988"  # رقم دولي بدون + أو مسافات

async def main():
    client = MoXstarClient(auth_dir="./auth")
    await client.start()
    await asyncio.sleep(5)
    code = await client.request_pairing_code(PHONE)
    print("كود الاقتران:", code)
    await client.wait_until_ready()

    await client.send_text(
        "201555001122",
        "مرحبًا من sting-vortex"
    )

asyncio.run(main())
```

---

## مثال الواجهة المتقدمة (الإصدار 1.0.1)

```python
message = {
    "conversation": "رسالة من sting-vortex",
    "contextInfo": {
        "mentionedJid": ["201200009988@s.whatsapp.net"]
    }
}
await client.relay_message("201200009988@s.whatsapp.net", message, {})
```

---

## الاستماع للأحداث

```python
from sting_vortex import MoXstarClient

client = MoXstarClient(auth_dir="./auth")

@client.on("ready")
async def on_ready(data):
    print("الاتصال جاهز!", client.user.id)

@client.on("messages.upsert")
async def on_message(event):
    for msg in event.get("messages", []):
        sender = msg.get("key", {}).get("remoteJid")
        text = msg.get("message", {}).get("conversation", "")
        if text == "!ping":
            await client.send_text(sender, "pong ⌁ sting-vortex")
```

---

## إرشادات الأمان

1. **لا تشارك مجلد `auth`:** يحتوي مجلد الجلسة على مفاتيح التشفير وبيانات الدخول؛ أضفه دائماً إلى `.gitignore`.
2. **أرقام بصيغة دولية:** استخدم أرقاماً بصيغة دولية بدون `+` أو مسافات (مثل `201555001122`).
3. **إرسال مسؤول:** تجنب الرسائل العشوائية أو المتكررة واحترم سياسات المنصة.

---

## المطور والتواصل الرسمي

- **المطور:** 𝑫𝑨𝑹𝑲 (𝑺) 𝑻𝑬𝑨𝑴 𝑽𝑶𝑹𝑻𝑰𝑿 🇪🇬
- **واتساب (WhatsApp):** `@S_V_O_R_T_I_X`
- **تلجرام (Telegram):** [@S_V_O_R_T_I_X](https://t.me/S_V_O_R_T_I_X)
- **تيك توك (TikTok):** [@S_V_O_R_T_I_X](https://www.tiktok.com/@S_V_O_R_T_I_X)
