warnect 0.1.0__tar.gz → 0.2.0__tar.gz

warnect-0.2.0/LICENSE

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

warnect-0.2.0/PKG-INFO

@@ -0,0 +1,148 @@
+Metadata-Version: 2.4
+Name: warnect
+Version: 0.2.0
+Summary: Python interface to arsya-baileys-open (WhatsApp Web) via a local Node.js bridge
+Author: Arsya
+License: MIT
+Project-URL: Homepage, https://github.com/ziole-visa/warnect
+Project-URL: Repository, https://github.com/ziole-visa/warnect
+Project-URL: Issues, https://github.com/ziole-visa/warnect/issues
+Project-URL: Changelog, https://github.com/ziole-visa/warnect/blob/main/CHANGELOG.md
+Keywords: whatsapp,baileys,warnect,automation,bot
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-timeout>=2.3; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# warnect (Python)
+
+Python client for WhatsApp Web multi-device, powered by **arsya-baileys-open**
+through a local Node.js bridge.
+
+- No browser, no Selenium.
+- Bridge talks over stdio only — no TCP port is exposed.
+- Session directory is created with `0700` permissions.
+- Inputs validated, sends rate-limited, auto-reconnect with backoff.
+
+## Requirements
+
+- Python >= 3.10
+- Node.js >= 20 and npm
+
+## Install
+
+```bash
+pip install warnect
+```
+
+Node dependencies are installed automatically on first run. To install manually:
+
+```bash
+python -c "import warnect, pathlib; print(pathlib.Path(warnect.__file__).parent / 'bridge')"
+cd <that-folder> && npm ci --omit=dev
+```
+
+## Quick start
+
+```python
+from warnect import BaileysClient
+
+client = BaileysClient(auth_dir="auth")
+
+def on_qr(qr):
+    print("Scan QR:", qr)
+
+def on_ready(data):
+    print("Connected as:", data.get("user"))
+
+def on_message(msg):
+    print("Pesan:", msg.get("text"))
+    if msg.get("text") == "ping":
+        client.send_text(msg["chat"], "pong")
+
+client.on("qr", on_qr)
+client.on("ready", on_ready)
+client.on("message", on_message)
+client.start()
+
+input("Bot jalan. Tekan Enter untuk stop...\n")
+client.stop()
+```
+
+## Events
+
+| Event        | Data                                          |
+| ------------ | --------------------------------------------- |
+| `qr`         | QR string (render/save it yourself)           |
+| `connection` | `{ "status": "connecting" \| "open" \| "close" }` |
+| `ready`      | `{ "user": {...} }`                            |
+| `message`    | normalized message object                      |
+| `error`      | `{ "code": "...", "message": "..." }`          |
+| `reconnect`  | `{ "attempt": n, "delay": ms }`                |
+
+## Message object
+
+```python
+{
+  "id": "...",
+  "chat": "123@s.whatsapp.net",
+  "sender": "...",
+  "fromMe": False,
+  "isGroup": False,
+  "type": "conversation",
+  "text": "halo",
+  "pushName": "Budi",
+  "timestamp": 1730000000,
+  "hasMedia": False,
+  "fileName": None,
+  "mimetype": None,
+}
+```
+
+## API
+
+| Method | Description |
+| ------ | ----------- |
+| `start(wait=True)` | Start bridge and socket |
+| `ping()` | Health check |
+| `send_text(jid, text)` | Send text |
+| `send_image(jid, url=..., path=..., caption=...)` | Send image |
+| `send_document(jid, path, filename=..., mimetype=..., caption=...)` | Send document |
+| `get_groups(limit=100)` | List groups |
+| `get_profile_picture(jid, type="image")` | Profile picture URL |
+| `is_on_whatsapp(number)` | Check number |
+| `logout()` | Log out session |
+| `stop()` | Stop bridge |
+
+## Errors
+
+```python
+from warnect import BridgeError, BridgeTimeout, BridgeCrashed
+
+try:
+    client.send_text("123@s.whatsapp.net", "hi")
+except BridgeTimeout:
+    ...
+except BridgeError as exc:
+    print(exc.code, exc.message)
+```
+
+## Security notes
+
+- The bridge uses local stdio; it does not open a network port.
+- Node dependencies are pinned in `package-lock.json` and installed with `npm ci`.
+- Keep `auth_dir` private; it contains WhatsApp session credentials.
+- Use `min_send_interval` (default `0.5`s) to avoid spamming.
+
+## License
+
+MIT

warnect-0.2.0/README.md

@@ -0,0 +1,123 @@
+# warnect (Python)
+
+Python client for WhatsApp Web multi-device, powered by **arsya-baileys-open**
+through a local Node.js bridge.
+
+- No browser, no Selenium.
+- Bridge talks over stdio only — no TCP port is exposed.
+- Session directory is created with `0700` permissions.
+- Inputs validated, sends rate-limited, auto-reconnect with backoff.
+
+## Requirements
+
+- Python >= 3.10
+- Node.js >= 20 and npm
+
+## Install
+
+```bash
+pip install warnect
+```
+
+Node dependencies are installed automatically on first run. To install manually:
+
+```bash
+python -c "import warnect, pathlib; print(pathlib.Path(warnect.__file__).parent / 'bridge')"
+cd <that-folder> && npm ci --omit=dev
+```
+
+## Quick start
+
+```python
+from warnect import BaileysClient
+
+client = BaileysClient(auth_dir="auth")
+
+def on_qr(qr):
+    print("Scan QR:", qr)
+
+def on_ready(data):
+    print("Connected as:", data.get("user"))
+
+def on_message(msg):
+    print("Pesan:", msg.get("text"))
+    if msg.get("text") == "ping":
+        client.send_text(msg["chat"], "pong")
+
+client.on("qr", on_qr)
+client.on("ready", on_ready)
+client.on("message", on_message)
+client.start()
+
+input("Bot jalan. Tekan Enter untuk stop...\n")
+client.stop()
+```
+
+## Events
+
+| Event        | Data                                          |
+| ------------ | --------------------------------------------- |
+| `qr`         | QR string (render/save it yourself)           |
+| `connection` | `{ "status": "connecting" \| "open" \| "close" }` |
+| `ready`      | `{ "user": {...} }`                            |
+| `message`    | normalized message object                      |
+| `error`      | `{ "code": "...", "message": "..." }`          |
+| `reconnect`  | `{ "attempt": n, "delay": ms }`                |
+
+## Message object
+
+```python
+{
+  "id": "...",
+  "chat": "123@s.whatsapp.net",
+  "sender": "...",
+  "fromMe": False,
+  "isGroup": False,
+  "type": "conversation",
+  "text": "halo",
+  "pushName": "Budi",
+  "timestamp": 1730000000,
+  "hasMedia": False,
+  "fileName": None,
+  "mimetype": None,
+}
+```
+
+## API
+
+| Method | Description |
+| ------ | ----------- |
+| `start(wait=True)` | Start bridge and socket |
+| `ping()` | Health check |
+| `send_text(jid, text)` | Send text |
+| `send_image(jid, url=..., path=..., caption=...)` | Send image |
+| `send_document(jid, path, filename=..., mimetype=..., caption=...)` | Send document |
+| `get_groups(limit=100)` | List groups |
+| `get_profile_picture(jid, type="image")` | Profile picture URL |
+| `is_on_whatsapp(number)` | Check number |
+| `logout()` | Log out session |
+| `stop()` | Stop bridge |
+
+## Errors
+
+```python
+from warnect import BridgeError, BridgeTimeout, BridgeCrashed
+
+try:
+    client.send_text("123@s.whatsapp.net", "hi")
+except BridgeTimeout:
+    ...
+except BridgeError as exc:
+    print(exc.code, exc.message)
+```
+
+## Security notes
+
+- The bridge uses local stdio; it does not open a network port.
+- Node dependencies are pinned in `package-lock.json` and installed with `npm ci`.
+- Keep `auth_dir` private; it contains WhatsApp session credentials.
+- Use `min_send_interval` (default `0.5`s) to avoid spamming.
+
+## License
+
+MIT

warnect-0.2.0/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "warnect"
+version = "0.2.0"
+description = "Python interface to arsya-baileys-open (WhatsApp Web) via a local Node.js bridge"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "Arsya" }]
+keywords = ["whatsapp", "baileys", "warnect", "automation", "bot"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://github.com/ziole-visa/warnect"
+Repository = "https://github.com/ziole-visa/warnect"
+Issues = "https://github.com/ziole-visa/warnect/issues"
+Changelog = "https://github.com/ziole-visa/warnect/blob/main/CHANGELOG.md"
+
+[project.optional-dependencies]
+dev = ["pytest>=8.0", "pytest-timeout>=2.3", "build", "twine"]
+
+[tool.setuptools]
+packages = ["warnect"]
+include-package-data = false
+
+[tool.setuptools.package-data]
+warnect = ["bridge/server.js", "bridge/package.json", "bridge/package-lock.json", "bridge/lib/*.js", "py.typed"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

warnect-0.2.0/tests/test_client.py

@@ -0,0 +1,75 @@
+import threading
+import time
+from pathlib import Path
+
+import pytest
+
+from warnect import BaileysClient, BridgeError, BridgeTimeout
+
+FAKE = str(Path(__file__).resolve().parent / "fake_bridge.js")
+
+
+@pytest.fixture()
+def client(tmp_path):
+    c = BaileysClient(
+        auth_dir=str(tmp_path / "auth"),
+        bridge_script=FAKE,
+        auto_install=False,
+        min_send_interval=0.0,
+    )
+    yield c
+    c.stop()
+
+
+def test_start_and_ping(client):
+    data = client.start()
+    assert data["status"] == "starting"
+    assert client.ping()["pong"] is True
+
+
+def test_send_text_returns_response(client):
+    client.start()
+    assert client.send_text("123@s.whatsapp.net", "halo")["sent"] is True
+
+
+def test_event_delivery(client):
+    got = []
+    event = threading.Event()
+
+    def on_message(msg):
+        got.append(msg)
+        event.set()
+
+    client.on("message", on_message)
+    client.start()
+    client.send_text("123@s.whatsapp.net", "hai")
+    assert event.wait(2.0)
+    assert got[0]["text"] == "hai"
+
+
+def test_unknown_command_raises(client):
+    client.start()
+    with pytest.raises(BridgeError) as exc:
+        client.request("nope")
+    assert exc.value.code == "unknown_command"
+
+
+def test_timeout(client):
+    client.start()
+    with pytest.raises(BridgeTimeout):
+        client.request("slow", timeout=0.2)
+
+
+def test_stop_then_start_again(tmp_path):
+    c = BaileysClient(
+        auth_dir=str(tmp_path / "auth"),
+        bridge_script=FAKE,
+        auto_install=False,
+        min_send_interval=0.0,
+    )
+    c.start()
+    assert c.ping()["pong"] is True
+    c.stop()
+    c.start()
+    assert c.ping()["pong"] is True
+    c.stop()

warnect-0.2.0/warnect/__init__.py

@@ -0,0 +1,13 @@
+"""warnect: Python interface to arsya-baileys-open via a local Node bridge."""
+
+from .client import BaileysClient
+from .exceptions import BridgeCrashed, BridgeError, BridgeTimeout, WarnectError
+
+__all__ = [
+    "BaileysClient",
+    "WarnectError",
+    "BridgeError",
+    "BridgeTimeout",
+    "BridgeCrashed",
+]
+__version__ = "0.2.0"

warnect-0.2.0/warnect/bridge/lib/protocol.js

@@ -0,0 +1,24 @@
+export function createEmitter(writeLine) {
+  return function emit(event, data = null) {
+    writeLine(JSON.stringify({ type: 'event', event, data }));
+  };
+}
+
+export function respond(writeLine, id, data = null) {
+  writeLine(JSON.stringify({ type: 'response', id, ok: true, data }));
+}
+
+export function respondError(writeLine, id, code, message) {
+  writeLine(JSON.stringify({ type: 'response', id, ok: false, error: { code, message } }));
+}
+
+export function parseLine(line) {
+  const trimmed = String(line || '').trim();
+  if (!trimmed) return null;
+  const obj = JSON.parse(trimmed);
+  if (!obj || typeof obj !== 'object') throw new Error('payload must be an object');
+  if (obj.type !== 'request') throw new Error('unsupported message type');
+  if (obj.id === undefined || obj.id === null) throw new Error('request id is required');
+  if (typeof obj.cmd !== 'string' || !obj.cmd) throw new Error('request cmd is required');
+  return obj;
+}

warnect-0.2.0/warnect/bridge/lib/validators.js

@@ -0,0 +1,31 @@
+const JID_RE = /^\d+(-[\d]+)?@(s\.whatsapp\.net|g\.us|broadcast|lid|newsletter)$/;
+
+export function validateJid(jid) {
+  if (typeof jid !== 'string' || !JID_RE.test(jid)) {
+    throw new Error(`invalid jid: ${jid}`);
+  }
+  return jid;
+}
+
+export function validateText(text, maxLength = 65536) {
+  if (typeof text !== 'string' || text.length === 0) {
+    throw new Error('text must be a non-empty string');
+  }
+  if (text.length > maxLength) {
+    throw new Error(`text too long (max ${maxLength})`);
+  }
+  return text;
+}
+
+export function validateLimit(value, def = 100, max = 1000) {
+  const n = Number(value ?? def);
+  if (!Number.isFinite(n) || n < 1 || n > max) {
+    throw new Error(`limit must be between 1 and ${max}`);
+  }
+  return Math.floor(n);
+}
+
+export function parseBool(value, def = false) {
+  if (value === undefined || value === null) return def;
+  return value === true || value === 'true' || value === 1 || value === '1';
+}