wasock 0.5.0b0__tar.gz

wasock-0.5.0b0/LICENSE

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

wasock-0.5.0b0/PKG-INFO

@@ -0,0 +1,164 @@
+Metadata-Version: 2.4
+Name: wasock
+Version: 0.5.0b0
+Summary: WAsock (WhatsApp Socket) - a Python wrapper around Baileys for building WhatsApp bots
+Author: Ahmed Mohmmed-AM
+License: MIT
+Project-URL: Homepage, https://github.com/Ahmed-Mohmmed-AM/WAsock
+Project-URL: Repository, https://github.com/Ahmed-Mohmmed-AM/WAsock
+Keywords: whatsapp,baileys,bot,chat,automation,whatsapp-sockt
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: qrcode
+Requires-Dist: pillow
+Dynamic: license-file
+
+# WAsock
+
+**wasock** (WhatsApp Socket) — مكتبة بايثون بسيطة للتعامل مع واتساب، مبنية فوق [Baileys](https://github.com/WhiskeySockets/Baileys) عن طريق عملية Node.js فرعية بتتواصل مع بايثون عبر TCP socket.
+
+صُنعت بواسطة مطور مصري 🇪🇬 — Ahmed Mohmmed-AM.
+
+> **الحالة:** `0.5.0-Beta` — لسه تحت التطوير، ممكن يحصل تغييرات في الـ API قبل النسخة المستقرة.
+
+---
+
+## نظرة عامة (Overview)
+
+wasock بتديك واجهة بايثونية سهلة للتعامل مع واتساب: استقبال رسايل، الرد عليها، بعت رسايل جديدة، حذف رسايل، وعرض QR Code لتسجيل الدخول — من غير ما تحتاج تكتب سطر JavaScript واحد.
+
+wasock is a lightweight Python wrapper around [Baileys](https://github.com/WhiskeySockets/Baileys). It spawns a Node.js subprocess and talks to it over a local TCP socket, so you can send, receive, reply to, and delete WhatsApp messages entirely from Python.
+
+---
+
+## المتطلبات (Requirements)
+
+- Python >= 3.8
+- Node.js (>= 18 موصى بيه)
+- اتصال بالإنترنت لتثبيت اعتماديات npm الأولى
+
+---
+
+## التثبيت (Installation)
+
+```bash
+pip install wasock
+```
+
+بعد التثبيت، لازم تثبت اعتماديات Node مرة واحدة (Baileys وpino) جوه فولدر المكتبة:
+
+After installing, you need to install the Node.js dependencies once:
+
+```bash
+cd $(python -c "import wasock, os; print(os.path.join(os.path.dirname(wasock.__file__), 'node'))")
+npm install
+```
+
+---
+
+## استخدام سريع (Quick Start)
+
+```python
+from wasock import WhatsAppSocket, Message, QRCode, Connection
+
+bot = WhatsAppSocket(authName="auth", loggerLevel="silent")
+
+def onQr(data):
+    qr = QRCode(data["qr"], size="mid", type="img")
+    img = qr.render()
+    img.save("qr.png")
+    print("امسح qr.png من واتساب على موبايلك")
+
+def onConnection(data):
+    conn = Connection(data)
+    if conn.connected:
+        print("الاتصال فتح!")
+    else:
+        print(f"الاتصال اتقفل: {conn.reason}")
+
+def onMessage(data):
+    message = Message(data, bot.nodeJS)
+    if message.fromBot:
+        return
+
+    if message.text == "!ping":
+        message.reply("pong")
+
+bot.on("qr", onQr)
+bot.on("connection", onConnection)
+bot.on("message", onMessage)
+
+bot.start()
+
+try:
+    input("البوت شغال، دوس Enter للخروج...\n")
+finally:
+    bot.end()
+```
+
+---
+
+## الـ API
+
+### `WhatsAppSocket(authName="auth", loggerLevel="silent")`
+
+بيبدأ الاتصال بسيرفر Node ويجهز الجلسة.
+
+- `.start()` — يبدأ الاتصال الفعلي بواتساب.
+- `.on(event, callback)` — يسجل event listener (`"qr"`, `"connection"`, `"message"`).
+- `.end()` — يقفل الاتصال ويوقف عملية Node.
+
+### `Message`
+
+بيتبني تلقائيًا لكل رسالة واردة. من أهم الخصائص:
+
+
+| الخاصية                              | الوصف                                                                      |
+| ------------------------------------------- | ------------------------------------------------------------------------------- |
+| `.text`                                     | نص الرسالة                                                             |
+| `.chat`                                     | الـ JID بتاع المحادثة                                            |
+| `.fromBot`                                  | `True` لو الرسالة من البوت نفسه                             |
+| `.quoted` / `.quotedText` / `.quotedSender` | بيانات الرسالة المقتبسة (لو الرسالة ريبلاي) |
+
+**Methods:**
+
+- `.reply(msg, chat=None, quoted=None)` — يرد على الرسالة.
+- `.send(msg, chat=None)` — يبعت رسالة جديدة (من غير quote).
+- `.delete()` — يمسح الرسالة (Delete for Everyone).
+
+### `QRCode(data, size="mid", type="terminal")`
+
+- `size`: `"small"`, `"mid"`, `"big"`
+- `type`: `"terminal"` (يطبع في التيرمينال) أو `"img"` (يرجع صورة تقدر تعمله `.save()`)
+
+### `Connection`
+
+- `.connected` — `True`/`False`
+- `.statusCode` — كود الإغلاق (لو موجود)
+- `.reason` — سبب الإغلاق (لو موجود)
+- `.isAuthFailure()` — `True` لو السبب كان 401 (محتاج QR جديد)
+
+---
+
+## ملاحظات مهمة (Important Notes)
+
+- فولدر `auth/` بيحتوي على بيانات جلسة واتساب الحساسة — **متعملوش commit على GitHub أبدًا**.
+- مكان `auth/` بيتحدد نسبيًا لمكان تشغيل السكريبت (working directory)، مش لمكان المكتبة.
+
+---
+
+## الترخيص (License)
+
+MIT License — تفاصيل أكتر في ملف [LICENSE](./LICENSE).
+
+---
+
+## المطور (Author)
+
+Ahmed Mohmmed-AM — مطور مصري 🇪🇬
+GitHub: [@Ahmed-Mohmmed-AM](https://github.com/Ahmed-Mohmmed-AM)

wasock-0.5.0b0/README.md

@@ -0,0 +1,144 @@
+# WAsock
+
+**wasock** (WhatsApp Socket) — مكتبة بايثون بسيطة للتعامل مع واتساب، مبنية فوق [Baileys](https://github.com/WhiskeySockets/Baileys) عن طريق عملية Node.js فرعية بتتواصل مع بايثون عبر TCP socket.
+
+صُنعت بواسطة مطور مصري 🇪🇬 — Ahmed Mohmmed-AM.
+
+> **الحالة:** `0.5.0-Beta` — لسه تحت التطوير، ممكن يحصل تغييرات في الـ API قبل النسخة المستقرة.
+
+---
+
+## نظرة عامة (Overview)
+
+wasock بتديك واجهة بايثونية سهلة للتعامل مع واتساب: استقبال رسايل، الرد عليها، بعت رسايل جديدة، حذف رسايل، وعرض QR Code لتسجيل الدخول — من غير ما تحتاج تكتب سطر JavaScript واحد.
+
+wasock is a lightweight Python wrapper around [Baileys](https://github.com/WhiskeySockets/Baileys). It spawns a Node.js subprocess and talks to it over a local TCP socket, so you can send, receive, reply to, and delete WhatsApp messages entirely from Python.
+
+---
+
+## المتطلبات (Requirements)
+
+- Python >= 3.8
+- Node.js (>= 18 موصى بيه)
+- اتصال بالإنترنت لتثبيت اعتماديات npm الأولى
+
+---
+
+## التثبيت (Installation)
+
+```bash
+pip install wasock
+```
+
+بعد التثبيت، لازم تثبت اعتماديات Node مرة واحدة (Baileys وpino) جوه فولدر المكتبة:
+
+After installing, you need to install the Node.js dependencies once:
+
+```bash
+cd $(python -c "import wasock, os; print(os.path.join(os.path.dirname(wasock.__file__), 'node'))")
+npm install
+```
+
+---
+
+## استخدام سريع (Quick Start)
+
+```python
+from wasock import WhatsAppSocket, Message, QRCode, Connection
+
+bot = WhatsAppSocket(authName="auth", loggerLevel="silent")
+
+def onQr(data):
+    qr = QRCode(data["qr"], size="mid", type="img")
+    img = qr.render()
+    img.save("qr.png")
+    print("امسح qr.png من واتساب على موبايلك")
+
+def onConnection(data):
+    conn = Connection(data)
+    if conn.connected:
+        print("الاتصال فتح!")
+    else:
+        print(f"الاتصال اتقفل: {conn.reason}")
+
+def onMessage(data):
+    message = Message(data, bot.nodeJS)
+    if message.fromBot:
+        return
+
+    if message.text == "!ping":
+        message.reply("pong")
+
+bot.on("qr", onQr)
+bot.on("connection", onConnection)
+bot.on("message", onMessage)
+
+bot.start()
+
+try:
+    input("البوت شغال، دوس Enter للخروج...\n")
+finally:
+    bot.end()
+```
+
+---
+
+## الـ API
+
+### `WhatsAppSocket(authName="auth", loggerLevel="silent")`
+
+بيبدأ الاتصال بسيرفر Node ويجهز الجلسة.
+
+- `.start()` — يبدأ الاتصال الفعلي بواتساب.
+- `.on(event, callback)` — يسجل event listener (`"qr"`, `"connection"`, `"message"`).
+- `.end()` — يقفل الاتصال ويوقف عملية Node.
+
+### `Message`
+
+بيتبني تلقائيًا لكل رسالة واردة. من أهم الخصائص:
+
+
+| الخاصية                              | الوصف                                                                      |
+| ------------------------------------------- | ------------------------------------------------------------------------------- |
+| `.text`                                     | نص الرسالة                                                             |
+| `.chat`                                     | الـ JID بتاع المحادثة                                            |
+| `.fromBot`                                  | `True` لو الرسالة من البوت نفسه                             |
+| `.quoted` / `.quotedText` / `.quotedSender` | بيانات الرسالة المقتبسة (لو الرسالة ريبلاي) |
+
+**Methods:**
+
+- `.reply(msg, chat=None, quoted=None)` — يرد على الرسالة.
+- `.send(msg, chat=None)` — يبعت رسالة جديدة (من غير quote).
+- `.delete()` — يمسح الرسالة (Delete for Everyone).
+
+### `QRCode(data, size="mid", type="terminal")`
+
+- `size`: `"small"`, `"mid"`, `"big"`
+- `type`: `"terminal"` (يطبع في التيرمينال) أو `"img"` (يرجع صورة تقدر تعمله `.save()`)
+
+### `Connection`
+
+- `.connected` — `True`/`False`
+- `.statusCode` — كود الإغلاق (لو موجود)
+- `.reason` — سبب الإغلاق (لو موجود)
+- `.isAuthFailure()` — `True` لو السبب كان 401 (محتاج QR جديد)
+
+---
+
+## ملاحظات مهمة (Important Notes)
+
+- فولدر `auth/` بيحتوي على بيانات جلسة واتساب الحساسة — **متعملوش commit على GitHub أبدًا**.
+- مكان `auth/` بيتحدد نسبيًا لمكان تشغيل السكريبت (working directory)، مش لمكان المكتبة.
+
+---
+
+## الترخيص (License)
+
+MIT License — تفاصيل أكتر في ملف [LICENSE](./LICENSE).
+
+---
+
+## المطور (Author)
+
+Ahmed Mohmmed-AM — مطور مصري 🇪🇬
+GitHub: [@Ahmed-Mohmmed-AM](https://github.com/Ahmed-Mohmmed-AM)

wasock-0.5.0b0/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "wasock"
+version = "0.5.0b0"
+description = "WAsock (WhatsApp Socket) - a Python wrapper around Baileys for building WhatsApp bots"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [
+    { name = "Ahmed Mohmmed-AM" }
+]
+keywords = ["whatsapp", "baileys", "bot", "chat", "automation", "whatsapp-sockt"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "qrcode",
+    "pillow"
+]
+
+[project.urls]
+Homepage = "https://github.com/Ahmed-Mohmmed-AM/WAsock"
+Repository = "https://github.com/Ahmed-Mohmmed-AM/WAsock"
+
+[tool.setuptools.packages.find]
+include = ["wasock*"]
+
+[tool.setuptools.package-data]
+wapyt = ["node/**/*"]

wasock-0.5.0b0/setup.cfg

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

wasock-0.5.0b0/wasock/__init__.py

@@ -0,0 +1,6 @@
+from .whatsappsocket import WhatsAppSocket
+from .qrcode import QRCode
+from .connection import Connection
+from .message import Message
+
+__version__ = "Wapyt @0.5.0-Beta"

wasock-0.5.0b0/wasock/connection.py

@@ -0,0 +1,8 @@
+class Connection:
+    def __init__(self, connection):
+        self.connected = True if connection["status"] == "open" else False
+        self.statusCode = connection.get("statusCode", None)
+        self.reason = connection.get("reason", None)
+
+    def isAuthFailure(self):
+        return self.statusCode == 401

wasock-0.5.0b0/wasock/message.py

@@ -0,0 +1,72 @@
+class Message:
+    def __init__(self, data, nodeJS):
+        message = data["message"]["messages"][0]    
+
+        self.data = message
+        self.nodeJS = nodeJS
+
+        self.id = message["key"]["id"]
+        self.chat = message["key"]["remoteJid"]
+        self.sender = message["key"].get("remoteJidAlt")
+        self.fromBot = message["key"]["fromMe"]
+        self.timestamp = message["messageTimestamp"]
+        self.name = message.get("pushName")
+
+        content = message.get("message", {})
+
+        self.text = (
+            content.get("conversation")
+            or content.get("extendedTextMessage", {}).get("text")
+        )
+
+        self.quoted = None
+        self.quotedText = None
+        self.quotedId = None
+        self.quotedSender = None
+
+        contextInfo = content.get("extendedTextMessage", {}).get("contextInfo")
+
+        if contextInfo and contextInfo.get("quotedMessage"):
+            self.quoted = contextInfo["quotedMessage"]
+            self.quotedId = contextInfo.get("stanzaId")
+            self.quotedSender = contextInfo.get("participant")
+
+            self.quotedText = (
+                self.quoted.get("conversation")
+                or self.quoted.get("extendedTextMessage", {}).get("text")
+            )
+
+    def reply(self, msg, chat=None, quoted=None):
+        if chat is None: chat = self.chat
+        if quoted is None: quoted = self.data
+
+        if msg is None: msg = ""
+
+        self.nodeJS.send({
+            "action": "replyMessage",
+            "chat": chat,
+            "msg": msg,
+            "quoted": quoted
+        })
+
+    def send(self, msg, chat=None):
+        if chat is None: chat = self.chat
+        
+        if msg is None: msg = ""
+        
+        self.nodeJS.send({
+            "action": "sendMessage",
+            "chat": chat,
+            "msg": msg,
+        })
+
+    def delete(self):
+        self.nodeJS.send({
+            "action": "deleteMessage",
+            "chat": self.chat,
+            "key": self.getKey()
+        })
+
+    def getKey(self):
+        key = self.data["key"]
+        return key

wasock-0.5.0b0/wasock/nodejs.py

@@ -0,0 +1,78 @@
+import subprocess, atexit, socket, queue, threading, json, time, os
+from concurrent.futures import ThreadPoolExecutor
+
+def connectToServer(self):
+    for _ in range(50):
+        try:
+            self.sock.connect(("127.0.0.1", 5000))
+            return
+        except ConnectionRefusedError:
+            time.sleep(0.1)
+
+    raise ConnectionError("Could not connect to Node.js server")
+
+_SERVER_JS_PATH = os.path.join(os.path.dirname(__file__), "node", "server.js")
+
+class NodeJS:
+    def __init__(self):
+        self.process = subprocess.Popen(
+            ["node", _SERVER_JS_PATH]
+        )
+
+        atexit.register(self.end)
+
+        self.sock = socket.socket()
+        connectToServer(self)
+
+        self.responses = queue.Queue()
+
+        self.events = {}
+
+        self.executor = ThreadPoolExecutor(max_workers=10)
+
+        self.threading = threading.Thread(
+            target=self.receive,
+            daemon=True
+        )
+        self.threading.start()
+
+    def receive(self):
+        buffer = ""
+
+        while True:
+            data = self.sock.recv(4096)
+
+            if not data:
+                break
+
+            buffer += data.decode("utf-8")
+
+            while "\n" in buffer:
+                line, buffer = buffer.split("\n", 1)
+
+                if not line:
+                    continue
+
+                message = json.loads(line)
+
+                if message.get("type") == "event":
+                    event = message.get("event")
+                    callback = self.events.get(event)
+
+                    if callback:
+                        self.executor.submit(callback, message)
+                else:
+                    self.responses.put(message)
+
+    def on(self, event, callback):
+        self.events[event] = callback
+
+    def send(self, message):
+        data = json.dumps(message).encode("utf-8") + b"\n"
+        self.sock.sendall(data)
+        return self.responses.get()
+
+    def end(self):
+        self.sock.close()
+        self.process.terminate()
+        self.process.wait()

wasock-0.5.0b0/wasock/qrcode.py

@@ -0,0 +1,25 @@
+import qrcode
+
+class QRCode:
+    def __init__(self, data, size="mid", type="terminal"):
+        sizes = {
+            "small": 6,
+            "mid" : 10,
+            "big": 16
+        }
+
+        boxSize = sizes.get(size.lower(), 10)
+
+        self.qr = qrcode.QRCode(version=None, box_size=boxSize, border=4)
+        self.qr.add_data(data)
+        self.qr.make(fit=True)
+        self.type = type.lower()
+
+    def render(self):
+        if self.type == "img":
+            return self.qr.make_image(fill_color="black", back_color="white")
+        elif self.type == "terminal":
+            self.qr.print_ascii(invert=True)
+            return None
+        else:
+            raise ValueError(f"Unknown type: {self.type}")

wasock-0.5.0b0/wasock/whatsappsocket.py

@@ -0,0 +1,24 @@
+from .nodejs import NodeJS
+
+class WhatsAppSocket:
+    def __init__(self, authName="auth", loggerLevel="silent"):
+        if not loggerLevel.lower() in ["debug", "error", "fatal", "info", "silent", "trace", "warn"]:
+            raise SyntaxError(f"Unknown logger type {loggerLevel}")
+        if not isinstance(authName, str):
+            raise TypeError("authName must be string")
+
+        self.nodeJS = NodeJS()
+
+        response = self.nodeJS.send({"action": "setup", "loggerLevel": loggerLevel.lower(), "authName": authName})
+
+        if not response["success"]:
+            raise RuntimeError(response.get("message", "Setup failed"))
+
+    def start(self):
+        return self.nodeJS.send({"action": "start"})
+
+    def on(self, event, callback):
+        self.nodeJS.on(event, callback)
+
+    def end(self):
+        self.nodeJS.end()

wasock-0.5.0b0/wasock.egg-info/PKG-INFO

@@ -0,0 +1,164 @@
+Metadata-Version: 2.4
+Name: wasock
+Version: 0.5.0b0
+Summary: WAsock (WhatsApp Socket) - a Python wrapper around Baileys for building WhatsApp bots
+Author: Ahmed Mohmmed-AM
+License: MIT
+Project-URL: Homepage, https://github.com/Ahmed-Mohmmed-AM/WAsock
+Project-URL: Repository, https://github.com/Ahmed-Mohmmed-AM/WAsock
+Keywords: whatsapp,baileys,bot,chat,automation,whatsapp-sockt
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: qrcode
+Requires-Dist: pillow
+Dynamic: license-file
+
+# WAsock
+
+**wasock** (WhatsApp Socket) — مكتبة بايثون بسيطة للتعامل مع واتساب، مبنية فوق [Baileys](https://github.com/WhiskeySockets/Baileys) عن طريق عملية Node.js فرعية بتتواصل مع بايثون عبر TCP socket.
+
+صُنعت بواسطة مطور مصري 🇪🇬 — Ahmed Mohmmed-AM.
+
+> **الحالة:** `0.5.0-Beta` — لسه تحت التطوير، ممكن يحصل تغييرات في الـ API قبل النسخة المستقرة.
+
+---
+
+## نظرة عامة (Overview)
+
+wasock بتديك واجهة بايثونية سهلة للتعامل مع واتساب: استقبال رسايل، الرد عليها، بعت رسايل جديدة، حذف رسايل، وعرض QR Code لتسجيل الدخول — من غير ما تحتاج تكتب سطر JavaScript واحد.
+
+wasock is a lightweight Python wrapper around [Baileys](https://github.com/WhiskeySockets/Baileys). It spawns a Node.js subprocess and talks to it over a local TCP socket, so you can send, receive, reply to, and delete WhatsApp messages entirely from Python.
+
+---
+
+## المتطلبات (Requirements)
+
+- Python >= 3.8
+- Node.js (>= 18 موصى بيه)
+- اتصال بالإنترنت لتثبيت اعتماديات npm الأولى
+
+---
+
+## التثبيت (Installation)
+
+```bash
+pip install wasock
+```
+
+بعد التثبيت، لازم تثبت اعتماديات Node مرة واحدة (Baileys وpino) جوه فولدر المكتبة:
+
+After installing, you need to install the Node.js dependencies once:
+
+```bash
+cd $(python -c "import wasock, os; print(os.path.join(os.path.dirname(wasock.__file__), 'node'))")
+npm install
+```
+
+---
+
+## استخدام سريع (Quick Start)
+
+```python
+from wasock import WhatsAppSocket, Message, QRCode, Connection
+
+bot = WhatsAppSocket(authName="auth", loggerLevel="silent")
+
+def onQr(data):
+    qr = QRCode(data["qr"], size="mid", type="img")
+    img = qr.render()
+    img.save("qr.png")
+    print("امسح qr.png من واتساب على موبايلك")
+
+def onConnection(data):
+    conn = Connection(data)
+    if conn.connected:
+        print("الاتصال فتح!")
+    else:
+        print(f"الاتصال اتقفل: {conn.reason}")
+
+def onMessage(data):
+    message = Message(data, bot.nodeJS)
+    if message.fromBot:
+        return
+
+    if message.text == "!ping":
+        message.reply("pong")
+
+bot.on("qr", onQr)
+bot.on("connection", onConnection)
+bot.on("message", onMessage)
+
+bot.start()
+
+try:
+    input("البوت شغال، دوس Enter للخروج...\n")
+finally:
+    bot.end()
+```
+
+---
+
+## الـ API
+
+### `WhatsAppSocket(authName="auth", loggerLevel="silent")`
+
+بيبدأ الاتصال بسيرفر Node ويجهز الجلسة.
+
+- `.start()` — يبدأ الاتصال الفعلي بواتساب.
+- `.on(event, callback)` — يسجل event listener (`"qr"`, `"connection"`, `"message"`).
+- `.end()` — يقفل الاتصال ويوقف عملية Node.
+
+### `Message`
+
+بيتبني تلقائيًا لكل رسالة واردة. من أهم الخصائص:
+
+
+| الخاصية                              | الوصف                                                                      |
+| ------------------------------------------- | ------------------------------------------------------------------------------- |
+| `.text`                                     | نص الرسالة                                                             |
+| `.chat`                                     | الـ JID بتاع المحادثة                                            |
+| `.fromBot`                                  | `True` لو الرسالة من البوت نفسه                             |
+| `.quoted` / `.quotedText` / `.quotedSender` | بيانات الرسالة المقتبسة (لو الرسالة ريبلاي) |
+
+**Methods:**
+
+- `.reply(msg, chat=None, quoted=None)` — يرد على الرسالة.
+- `.send(msg, chat=None)` — يبعت رسالة جديدة (من غير quote).
+- `.delete()` — يمسح الرسالة (Delete for Everyone).
+
+### `QRCode(data, size="mid", type="terminal")`
+
+- `size`: `"small"`, `"mid"`, `"big"`
+- `type`: `"terminal"` (يطبع في التيرمينال) أو `"img"` (يرجع صورة تقدر تعمله `.save()`)
+
+### `Connection`
+
+- `.connected` — `True`/`False`
+- `.statusCode` — كود الإغلاق (لو موجود)
+- `.reason` — سبب الإغلاق (لو موجود)
+- `.isAuthFailure()` — `True` لو السبب كان 401 (محتاج QR جديد)
+
+---
+
+## ملاحظات مهمة (Important Notes)
+
+- فولدر `auth/` بيحتوي على بيانات جلسة واتساب الحساسة — **متعملوش commit على GitHub أبدًا**.
+- مكان `auth/` بيتحدد نسبيًا لمكان تشغيل السكريبت (working directory)، مش لمكان المكتبة.
+
+---
+
+## الترخيص (License)
+
+MIT License — تفاصيل أكتر في ملف [LICENSE](./LICENSE).
+
+---
+
+## المطور (Author)
+
+Ahmed Mohmmed-AM — مطور مصري 🇪🇬
+GitHub: [@Ahmed-Mohmmed-AM](https://github.com/Ahmed-Mohmmed-AM)

wasock-0.5.0b0/wasock.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+wasock/__init__.py
+wasock/connection.py
+wasock/message.py
+wasock/nodejs.py
+wasock/qrcode.py
+wasock/whatsappsocket.py
+wasock.egg-info/PKG-INFO
+wasock.egg-info/SOURCES.txt
+wasock.egg-info/dependency_links.txt
+wasock.egg-info/requires.txt
+wasock.egg-info/top_level.txt

wasock-0.5.0b0/wasock.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

wasock-0.5.0b0/wasock.egg-info/requires.txt

@@ -0,0 +1,2 @@
+qrcode
+pillow

wasock-0.5.0b0/wasock.egg-info/top_level.txt

@@ -0,0 +1 @@
+wasock