whatsapp-rpc 0.0.12 → 0.0.14

package/README.md

@@ -106,7 +106,7 @@ Connect via WebSocket to `ws://localhost:9400/ws/rpc` and send JSON-RPC 2.0 requ
 | `status` | Get connection status (connected, has_session, running, pairing, device_id) |
 | `start` | Start WhatsApp service |
 | `stop` | Stop WhatsApp service |
-| `restart` | Full reset: logout, delete DB, cleanup, start fresh |
+| `restart` | Full reset: logout, clear all caches, cleanup, start fresh |
 | `reset` | Reset session (logout and delete credentials) |
 | `diagnostics` | Get detailed diagnostics information |
 | `qr` | Get QR code for pairing (code, image_data as base64 PNG) |
@@ -154,7 +154,7 @@ Connect via WebSocket to `ws://localhost:9400/ws/rpc` and send JSON-RPC 2.0 requ
 | `newsletter_follow` | `jid` | Subscribe to a channel |
 | `newsletter_unfollow` | `jid` | Unsubscribe from a channel |
 | `newsletter_mute` | `jid`, `mute` | Mute/unmute a channel |
-| `newsletter_messages` | `jid`, `count`, `before` | Get channel messages |
+| `newsletter_messages` | `jid`, `count`, `offset`, `before`, `since`, `until`, `media_type`, `search`, `refresh` | Get channel messages (lazy cached, filterable) |
 | `newsletter_send` | `group_id`, `type`, `message`/`media_data` | Send to channel (admin only) |
 | `newsletter_mark_viewed` | `jid`, `server_ids[]` | Mark messages as viewed |
 | `newsletter_react` | `jid`, `server_id`, `reaction` | React to a channel message |
@@ -461,6 +461,48 @@ asyncio.run(main())
 
 See [src/python/README.md](src/python/README.md) for full Python client documentation.
 
+## Android Integration
+
+Cross-compile the server for Android and embed it in your app:
+
+```bash
+# Build for all platforms including Android
+npm run build-cross
+
+# Or manually:
+# arm64 real device
+CGO_ENABLED=0 GOOS=android GOARCH=arm64 go build -ldflags="-s -w" -o libwhatsapp-rpc.so ./src/go/cmd/server
+
+# x86_64 emulator (use GOOS=linux, not android)
+CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -ldflags="-s -w" -o libwhatsapp-rpc-x86_64.so ./src/go/cmd/server
+```
+
+Place binaries in your Android project:
+```
+app/android/app/src/main/jniLibs/
+    arm64-v8a/libwhatsapp-rpc.so
+    x86_64/libwhatsapp-rpc-x86_64.so
+```
+
+Required Gradle config (`build.gradle.kts`):
+```kotlin
+android {
+    packaging { jniLibs { useLegacyPackaging = true } }
+    defaultConfig { ndk { abiFilters += listOf("x86_64", "arm64-v8a") } }
+}
+```
+
+Launch from Kotlin:
+```kotlin
+val binary = File(applicationInfo.nativeLibraryDir, "libwhatsapp-rpc.so")
+val pb = ProcessBuilder(binary.absolutePath)
+pb.environment()["SSL_CERT_DIR"] = "/system/etc/security/cacerts"
+pb.environment()["WHATSAPP_RPC_ANDROID"] = "1"  // enables Android DNS resolver
+pb.start()
+```
+
+Then connect via WebSocket at `ws://127.0.0.1:9400/ws/rpc`.
+
 ## Requirements
 
 - Node.js 18+
@@ -468,6 +510,7 @@ See [src/python/README.md](src/python/README.md) for full Python client document
   - Linux (amd64, arm64)
   - macOS (amd64, arm64)
   - Windows (amd64)
+  - Android (arm64, x86_64)
 
 ## License
 

package/configs/config.yaml

@@ -4,4 +4,11 @@ server:
   port: 9400
   host: "127.0.0.1"
 database:
-  path: "data/whatsapp.db"
+  path: "data/whatsapp.db"
+qr_timeout_seconds: 300
+newsletter:
+  fetch_page_size: 100
+  fetch_delay_ms: 2000
+  default_limit: 50
+  max_limit: 500
+  media_cache_size: 100

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "whatsapp-rpc",
-  "version": "0.0.12",
+  "version": "0.0.14",
   "type": "module",
   "description": "WhatsApp WebSocket RPC Server with JSON-RPC 2.0 protocol",
   "author": "Rohit G <trohitg@gmail.com>",
@@ -46,6 +46,7 @@
     "web": "node scripts/cli.js web",
     "prebuild": "node -e \"require('fs').existsSync('node_modules') || process.exit(1)\" || npm install",
     "build": "node scripts/cli.js build",
+    "build-cross": "node scripts/cli.js build-cross",
     "preclean": "node -e \"require('fs').existsSync('node_modules') || process.exit(1)\" || npm install",
     "clean": "node scripts/cli.js clean"
   },

package/scripts/cli.js

@@ -162,6 +162,39 @@ async function clean(opts = {}) {
   log('Clean complete', 'green');
 }
 
+const CROSS_TARGETS = [
+  { goos: 'linux',   goarch: 'amd64', output: 'whatsapp-rpc-server-linux-amd64' },
+  { goos: 'linux',   goarch: 'arm64', output: 'whatsapp-rpc-server-linux-arm64' },
+  { goos: 'darwin',  goarch: 'amd64', output: 'whatsapp-rpc-server-darwin-amd64' },
+  { goos: 'darwin',  goarch: 'arm64', output: 'whatsapp-rpc-server-darwin-arm64' },
+  { goos: 'windows', goarch: 'amd64', output: 'whatsapp-rpc-server-windows-amd64.exe' },
+  { goos: 'android', goarch: 'arm64', output: 'libwhatsapp-rpc-android-arm64.so' },
+  { goos: 'linux',   goarch: 'amd64', output: 'libwhatsapp-rpc-android-x86_64.so', label: 'android-x86_64' },
+];
+
+async function buildCross() {
+  if (!hasGo()) {
+    log('Go is not installed. Install from: https://go.dev/dl/', 'red');
+    process.exit(1);
+  }
+  if (!existsSync(BIN_DIR)) {
+    mkdirSync(BIN_DIR, { recursive: true });
+  }
+
+  for (const target of CROSS_TARGETS) {
+    const label = target.label || `${target.goos}/${target.goarch}`;
+    const out = join(BIN_DIR, target.output);
+    log(`Building ${label} -> ${target.output}`, 'blue');
+    await execa('go', ['build', '-ldflags=-s -w', '-o', out, './src/go/cmd/server'], {
+      cwd: ROOT,
+      stdio: 'inherit',
+      env: { ...process.env, GOOS: target.goos, GOARCH: target.goarch, CGO_ENABLED: '0' },
+    });
+    log(`  ${target.output} (${(statSync(out).size / 1024 / 1024).toFixed(1)}MB)`, 'green');
+  }
+  log(`All ${CROSS_TARGETS.length} binaries built`, 'green');
+}
+
 // Global port option for all commands
 const portOption = ['-p, --port <port>', 'API port (default: 9400, or PORT/WHATSAPP_RPC_PORT env var)'];
 
@@ -172,5 +205,6 @@ program.command('restart').description('Restart API server').option(...portOptio
 program.command('status').description('Show server status').option(...portOption).action(status);
 program.command('api').description('Start API server').option('-f, --foreground', 'Run in foreground').option(...portOption).action(api);
 program.command('build').description('Build binary from source (requires Go)').action(build);
+program.command('build-cross').description('Cross-compile binaries for all platforms (desktop + Android)').action(buildCross);
 program.command('clean').description('Full cleanup (stop server, remove bin/, data/, node_modules/)').action(clean);
 program.parse();