waton 0.1.0__tar.gz

waton-0.1.0/.claude/settings.local.json

@@ -0,0 +1,15 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(python -m pytest tests/unit/test_messages.py -v)",
+      "Bash(git init)",
+      "Bash(git remote add origin https://github.com/kaivyy/pywa.git)",
+      "Bash(git add .gitignore CHANGELOG.md Cargo.lock Cargo.toml README.md docs/ examples/ pyproject.toml pyrightconfig.json pywa/ ruff.toml rust/ tests/)",
+      "Bash(git commit -m \"$\\(cat <<''EOF''\nInitial release: PyWA - Python WhatsApp Web Multi-Device Library\n\n- Pure Python WhatsApp Web client with Rust crypto backend\n- Multi-device support with USync device query\n- Signal Protocol encryption \\(E2EE\\)\n- SQLite session storage\n- Async/await API\n\nFeatures:\n- QR code pairing\n- Send/receive text messages\n- Multi-device message routing\n- Session persistence\n\nCo-Authored-By: Claude <noreply@anthropic.com>\nEOF\n\\)\")",
+      "Bash(git branch -M main)",
+      "Bash(git push -u https://kaivyy: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@github.com/kaivyy/pywa.git main)",
+      "Bash(git add README.md)",
+      "Bash(git commit -m \"$\\(cat <<''EOF''\ndocs: Improve README with comprehensive documentation\n\n- Add badges \\(Python version, License\\)\n- Add Why PyWA section with key benefits\n- Add Quick Start code example\n- Add Architecture diagram\n- Add detailed comparison table vs Baileys\n- Add Contributing section\n- Add Requirements and Disclaimer\n\nCo-Authored-By: Claude <noreply@anthropic.com>\nEOF\n\\)\")"
+    ]
+  }
+}

waton-0.1.0/.gitignore

@@ -0,0 +1,27 @@
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+target/
+.venv/
+*.so
+*.dll
+*.pyd
+.ruff_cache/
+.pytest_cache/
+.tmp-*/
+*.db
+*.log
+debug.txt
+out.txt
+out2.txt
+err.txt
+pytest_out.txt
+pytest_err.log
+pytest.log
+convert_constants.py
+extract.js
+.tmp-curve25519-index.js
+howtouse.md

waton-0.1.0/CHANGELOG.md

@@ -0,0 +1,45 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- **Multi-device query support**: Messages are now encrypted and sent to ALL devices
+  of the recipient (phone, WhatsApp Web, linked devices) via USync device query,
+  fixing the issue where messages were ACKed by server but never received
+- **Incoming Message Decryption**: The app now successfully decrypts incoming `pkmsg` and `msg` E2E E2E (End-to-End) encrypted nodes inside the Signal Protocol.
+- **Interactive CLI Chat (`cli_chat.py`)**: Added an interactive terminal application `examples/cli_chat.py` to test receiving and sending messages directly from the terminal.
+- **High-Level App Parser Integration**: The `@app.message()` router now seamlessly unwraps `<enc>` message nodes and yields decrypted `Message` objects.
+- New `waton/client/usync.py` module with `USyncQuery` class for querying device lists
+- Real Rust-backed Signal helper integration (`wa-rs-libsignal`) for session bootstrap
+  and session encryption
+- `send_text` E2E relay flow: device key fetch (`iq encrypt`), session injection, per-device
+  encrypted participant fanout, and `device-identity` inclusion for `pkmsg`
+- Minimal WA protobuf wire serializer used for outgoing message payloads
+- Runtime guidance for wheel-first installation (end users do not need Rust toolchain)
+
+### Changed
+- Architecture remains standalone `waton` (Python API), with Rust used only as internal
+  performance/crypto helper
+- No runtime dependency on Node.js/Baileys wrapper layers
+
+### Fixed
+- **PKCS#7 Payload Padding**: Protobuf message payloads are now padded with 1-16 random bytes
+  prior to encryption, fixing Server Error 479 (`Invalid Format`).
+- **Exact Sender Device Filtering**: `send_text` now strictly filters out the exact sending device
+  using normalized session keys to avoid Error 479 (`Invalid Receiver`) when the server
+  detects a client sending an enc payload to itself.
+- **AD_JID encoding for multi-device**: Device-specific JIDs (`user:device@server`) are
+  now correctly encoded as AD_JID (tag 247) in the binary codec, instead of mangled JID_PAIR.
+  This was preventing multi-device messages from reaching the server correctly.
+- Server reject/disconnect on message send (`ack error 479`) by replacing stub relay path
+  with encrypted Signal relay
+- Invalid JSON-based WAProto shim replaced with binary protobuf wire implementation
+
+### Docs
+- Added installation guidance differentiating end-user install (wheel, no Rust) vs source
+  contributor setup (requires Rust + maturin)