whatsapp-rpc 0.0.13 → 0.0.15

package/README.md

@@ -78,11 +78,32 @@ npx whatsapp-rpc restart         # Restart API server
 npx whatsapp-rpc status          # Check if running
 npx whatsapp-rpc api --foreground  # Run in foreground (for Docker)
 npx whatsapp-rpc build           # Build from source (requires Go)
+npx whatsapp-rpc web             # Start standalone web dashboard (no Python needed)
+npx whatsapp-rpc dev             # Start API + web dashboard together
 
 # Custom port
 npx whatsapp-rpc start --port 8080
 ```
 
+## Web Dashboard
+
+A standalone static web client that connects directly to the Go WebSocket backend -- no Python/Flask required:
+
+```bash
+# Start API server first
+npx whatsapp-rpc start
+
+# Then start the web dashboard
+npx whatsapp-rpc web --port 3001 --ws-port 9400
+
+# Or start both together
+npx whatsapp-rpc dev
+```
+
+Open `http://localhost:3001` for the full dashboard with pages for messaging, groups, contacts, and settings.
+
+The web client is in `web/client/` and can also be served by any static file server. Set `window.WS_PORT` to point to the Go backend port.
+
 ## Docker
 
 ```dockerfile
@@ -461,6 +482,67 @@ 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`.
+
+### CrossMeow (Flutter Example App)
+
+A complete Flutter Android app is in `examples/android/`. It bundles the Go binary and the static web client into a single APK:
+
+```bash
+cd examples/android
+
+# Build Go binary for emulator
+cd ../../ && npm run build-cross  # or manually cross-compile
+
+# Copy binary to jniLibs
+cp bin/libwhatsapp-rpc-android-arm64.so examples/android/android/app/src/main/jniLibs/arm64-v8a/libwhatsapp-rpc.so
+
+# Build APK
+cd examples/android && flutter build apk --debug
+```
+
+The app uses a Dart HTTP server to serve the web client from Flutter assets, with a WebView loading the dashboard. See [examples/android/](examples/android/) for the full source.
+
 ## Requirements
 
 - Node.js 18+
@@ -468,6 +550,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "whatsapp-rpc",
-  "version": "0.0.13",
+  "version": "0.0.15",
   "type": "module",
   "description": "WhatsApp WebSocket RPC Server with JSON-RPC 2.0 protocol",
   "author": "Rohit G <trohitg@gmail.com>",
@@ -28,6 +28,7 @@
     "bin/",
     "scripts/",
     "configs/",
+    "web/client/",
     "README.md"
   ],
   "publishConfig": {
@@ -44,8 +45,10 @@
     "status": "node scripts/cli.js status",
     "api": "node scripts/cli.js api --foreground",
     "web": "node scripts/cli.js web",
+    "dev": "node scripts/cli.js dev",
     "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,63 @@ 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');
+}
+
+async function web(opts = {}) {
+  const webPort = opts.port ? parseInt(opts.port) : 3001;
+  const wsPort = opts.wsPort ? parseInt(opts.wsPort) : getPort(opts);
+  const script = join(__dirname, 'serve-client.js');
+
+  log(`Starting web UI on port ${webPort} (backend: ${wsPort})...`, 'blue');
+  spawn('node', [script], {
+    cwd: ROOT,
+    stdio: 'inherit',
+    env: { ...process.env, WEB_PORT: String(webPort), WS_PORT: String(wsPort) },
+  });
+}
+
+async function dev(opts = {}) {
+  const port = getPort(opts);
+  const webPort = opts.webPort ? parseInt(opts.webPort) : 3001;
+
+  // Start API server in background
+  await api({ ...opts, foreground: false });
+
+  // Start web UI in foreground
+  await web({ port: String(webPort), wsPort: String(port) });
+}
+
 // Global port option for all commands
 const portOption = ['-p, --port <port>', 'API port (default: 9400, or PORT/WHATSAPP_RPC_PORT env var)'];
 
@@ -171,6 +228,9 @@ program.command('stop').description('Stop API server').option(...portOption).act
 program.command('restart').description('Restart API server').option(...portOption).action(async (opts) => { await stop(opts); await sleep(1000); await start(opts); });
 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('web').description('Start web dashboard (static client)').option('-p, --port <port>', 'Web UI port (default: 3001)').option('--ws-port <port>', 'Go backend WebSocket port (default: 9400)').action(web);
+program.command('dev').description('Start API server + web dashboard').option(...portOption).option('--web-port <port>', 'Web UI port (default: 3001)').action(dev);
 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();

package/scripts/serve-client.js

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+/**
+ * Static file server for the whatsapp-rpc web client.
+ * Serves web/client/ on localhost, with dynamic /config.js for WebSocket port injection.
+ *
+ * Based on MachinaOs/scripts/serve-client.js pattern.
+ *
+ * Environment variables:
+ *   WEB_PORT  - Port for the web UI (default: 3001)
+ *   WS_PORT   - Go backend WebSocket port (default: 9400)
+ */
+import { createServer } from 'http';
+import { readFile } from 'fs';
+import { extname, resolve } from 'path';
+import { dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const CLIENT_DIR = resolve(__dirname, '..', 'web', 'client');
+const PORT = parseInt(process.env.WEB_PORT) || 3001;
+const WS_PORT = parseInt(process.env.WS_PORT || process.env.WHATSAPP_RPC_PORT || process.env.PORT) || 9400;
+
+const MIME_TYPES = {
+  '.html': 'text/html',
+  '.js': 'text/javascript',
+  '.css': 'text/css',
+  '.json': 'application/json',
+  '.png': 'image/png',
+  '.jpg': 'image/jpeg',
+  '.gif': 'image/gif',
+  '.svg': 'image/svg+xml',
+  '.ico': 'image/x-icon',
+  '.woff': 'font/woff',
+  '.woff2': 'font/woff2',
+  '.ttf': 'font/ttf',
+};
+
+const server = createServer((req, res) => {
+  let url = req.url === '/' ? '/index.html' : req.url;
+  url = url.split('?')[0];
+
+  // Dynamic config — injects the Go backend WebSocket port
+  if (url === '/config.js') {
+    res.writeHead(200, { 'Content-Type': 'text/javascript' });
+    res.end(`window.WS_PORT = ${WS_PORT};`);
+    return;
+  }
+
+  const filePath = resolve(CLIENT_DIR, '.' + url);
+
+  // Prevent path traversal
+  if (!filePath.startsWith(CLIENT_DIR)) {
+    res.writeHead(403);
+    res.end('Forbidden');
+    return;
+  }
+
+  readFile(filePath, (err, content) => {
+    if (err) {
+      if (err.code === 'ENOENT' && !extname(url)) {
+        // SPA fallback
+        readFile(resolve(CLIENT_DIR, 'index.html'), (err2, indexContent) => {
+          if (err2) { res.writeHead(404); res.end('Not found'); }
+          else { res.writeHead(200, { 'Content-Type': 'text/html' }); res.end(indexContent); }
+        });
+      } else {
+        res.writeHead(404);
+        res.end('Not found');
+      }
+    } else {
+      const ext = extname(filePath);
+      res.writeHead(200, { 'Content-Type': MIME_TYPES[ext] || 'application/octet-stream' });
+      res.end(content);
+    }
+  });
+});
+
+server.listen(PORT, '0.0.0.0', () => {
+  console.log(`Web UI: http://localhost:${PORT}`);
+  console.log(`Backend: ws://localhost:${WS_PORT}/ws/rpc`);
+});

package/web/client/contacts.html

@@ -0,0 +1,241 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Contacts - WhatsApp Controller</title>
+    <script src="https://cdn.tailwindcss.com"></script>
+    <style>
+        .status-indicator { @apply inline-block w-3 h-3 rounded-full mr-2; }
+        .status-connected { @apply bg-green-500; }
+        .status-disconnected { @apply bg-red-500; }
+        .status-connecting { @apply bg-yellow-500 animate-pulse; }
+    </style>
+</head>
+<body class="bg-gray-100 min-h-screen">
+    <nav id="main-nav"></nav>
+    <main class="max-w-7xl mx-auto px-4 py-8">
+        <div class="space-y-8">
+            <!-- Page Header -->
+            <div>
+                <h1 class="text-3xl font-bold text-gray-900">Contacts</h1>
+                <p class="text-gray-600 mt-1">Check if phone numbers are on WhatsApp and view profile pictures</p>
+            </div>
+
+            <!-- Check Numbers Section -->
+            <div class="bg-white rounded-lg shadow-md p-6">
+                <h2 class="text-xl font-semibold mb-4">Check Phone Numbers</h2>
+                <p class="text-gray-600 mb-4">Enter phone numbers (one per line) to check if they are registered on WhatsApp</p>
+
+                <div class="space-y-4">
+                    <div>
+                        <label class="block text-sm font-medium text-gray-700 mb-2">Phone Numbers</label>
+                        <textarea id="phone-numbers" rows="5"
+                            placeholder="Enter phone numbers, one per line (without + prefix)&#10;e.g.&#10;919876543210&#10;14155551234"
+                            class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-green-500"></textarea>
+                    </div>
+
+                    <button onclick="checkContacts()" class="px-6 py-2 bg-green-600 text-white rounded-lg hover:bg-green-700 flex items-center">
+                        <svg class="w-4 h-4 mr-2" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z"></path>
+                        </svg>
+                        Check Numbers
+                    </button>
+                </div>
+
+                <!-- Results -->
+                <div id="check-results" class="mt-6 hidden">
+                    <h3 class="font-semibold text-gray-800 mb-3">Results</h3>
+                    <div id="results-container" class="space-y-2"></div>
+                </div>
+            </div>
+
+            <!-- Profile Picture Section -->
+            <div class="bg-white rounded-lg shadow-md p-6">
+                <h2 class="text-xl font-semibold mb-4">Profile Picture</h2>
+                <p class="text-gray-600 mb-4">View profile picture for a user or group</p>
+
+                <div class="flex flex-wrap gap-4 items-end">
+                    <div class="flex-1 min-w-[250px]">
+                        <label class="block text-sm font-medium text-gray-700 mb-2">JID (Phone or Group)</label>
+                        <input type="text" id="profile-jid"
+                            placeholder="919876543210@s.whatsapp.net or group@g.us"
+                            class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-green-500">
+                    </div>
+                    <button onclick="getProfilePicture()" class="px-6 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 flex items-center">
+                        <svg class="w-4 h-4 mr-2" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 16l4.586-4.586a2 2 0 012.828 0L16 16m-2-2l1.586-1.586a2 2 0 012.828 0L20 14m-6-6h.01M6 20h12a2 2 0 002-2V6a2 2 0 00-2-2H6a2 2 0 00-2 2v12a2 2 0 002 2z"></path>
+                        </svg>
+                        Get Picture
+                    </button>
+                </div>
+
+                <!-- Profile Picture Result -->
+                <div id="profile-result" class="mt-6 hidden">
+                    <div id="profile-container" class="flex items-center space-x-4">
+                        <img id="profile-image" src="" alt="Profile Picture" class="w-24 h-24 rounded-full object-cover border-4 border-gray-200">
+                        <div>
+                            <p id="profile-jid-display" class="font-semibold text-gray-800"></p>
+                            <p id="profile-status" class="text-sm text-gray-600"></p>
+                        </div>
+                    </div>
+                    <div id="profile-no-picture" class="hidden text-gray-500">
+                        <svg class="w-24 h-24 text-gray-300 mx-auto" fill="currentColor" viewBox="0 0 24 24">
+                            <path d="M24 20.993V24H0v-2.996A14.977 14.977 0 0112.004 15c4.904 0 9.26 2.354 11.996 5.993zM16.002 8.999a4 4 0 11-8 0 4 4 0 018 0z"></path>
+                        </svg>
+                        <p class="text-center mt-2">No profile picture available</p>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Presence Section -->
+            <div class="bg-white rounded-lg shadow-md p-6">
+                <h2 class="text-xl font-semibold mb-4">Presence Status</h2>
+                <p class="text-gray-600 mb-4">Set your online/offline presence status</p>
+
+                <div class="flex flex-wrap gap-4">
+                    <button onclick="setPresence('available')" class="px-6 py-2 bg-green-600 text-white rounded-lg hover:bg-green-700 flex items-center">
+                        <span class="w-3 h-3 bg-green-300 rounded-full mr-2"></span>
+                        Set Online
+                    </button>
+                    <button onclick="setPresence('unavailable')" class="px-6 py-2 bg-gray-600 text-white rounded-lg hover:bg-gray-700 flex items-center">
+                        <span class="w-3 h-3 bg-gray-400 rounded-full mr-2"></span>
+                        Set Offline
+                    </button>
+                </div>
+                <p id="presence-status" class="mt-3 text-sm text-gray-600"></p>
+            </div>
+        </div>
+    </main>
+    <footer class="bg-white border-t mt-12">
+        <div class="max-w-7xl mx-auto px-4 py-6">
+            <p class="text-center text-gray-600">WhatsApp Controller - Static Web Client</p>
+        </div>
+    </footer>
+    <script src="/js/rpc-client.js"></script>
+    <script src="/js/app.js"></script>
+    <script>
+    async function checkContacts() {
+        const textarea = document.getElementById('phone-numbers');
+        const lines = textarea.value.split('\n').map(l => l.trim()).filter(l => l.length > 0);
+
+        if (lines.length === 0) {
+            showNotification('Please enter at least one phone number', 'warning');
+            return;
+        }
+
+        const resultsSection = document.getElementById('check-results');
+        const container = document.getElementById('results-container');
+        resultsSection.classList.remove('hidden');
+        container.innerHTML = '<p class="text-gray-500">Checking...</p>';
+
+        try {
+            const results = await rpc.call('contact_check', { phones: lines });
+
+            container.innerHTML = results.map(r => {
+                const statusClass = r.is_registered ? 'bg-green-100 border-green-300' : 'bg-red-100 border-red-300';
+                const statusIcon = r.is_registered
+                    ? '<svg class="w-5 h-5 text-green-600" fill="currentColor" viewBox="0 0 20 20"><path fill-rule="evenodd" d="M10 18a8 8 0 100-16 8 8 0 000 16zm3.707-9.293a1 1 0 00-1.414-1.414L9 10.586 7.707 9.293a1 1 0 00-1.414 1.414l2 2a1 1 0 001.414 0l4-4z" clip-rule="evenodd"></path></svg>'
+                    : '<svg class="w-5 h-5 text-red-600" fill="currentColor" viewBox="0 0 20 20"><path fill-rule="evenodd" d="M10 18a8 8 0 100-16 8 8 0 000 16zM8.707 7.293a1 1 0 00-1.414 1.414L8.586 10l-1.293 1.293a1 1 0 101.414 1.414L10 11.414l1.293 1.293a1 1 0 001.414-1.414L11.414 10l1.293-1.293a1 1 0 00-1.414-1.414L10 8.586 8.707 7.293z" clip-rule="evenodd"></path></svg>';
+
+                let businessBadge = '';
+                if (r.is_business) {
+                    businessBadge = `<span class="ml-2 px-2 py-1 bg-blue-100 text-blue-800 text-xs rounded">Business${r.business_name ? ': ' + escapeHtml(r.business_name) : ''}</span>`;
+                }
+
+                return `
+                    <div class="flex items-center justify-between p-3 border rounded-lg ${statusClass}">
+                        <div class="flex items-center space-x-3">
+                            ${statusIcon}
+                            <div>
+                                <p class="font-medium">${escapeHtml(r.query)}</p>
+                                ${r.is_registered ? `<p class="text-xs text-gray-600">${escapeHtml(r.jid || '')}</p>` : ''}
+                            </div>
+                            ${businessBadge}
+                        </div>
+                        <span class="text-sm font-medium ${r.is_registered ? 'text-green-700' : 'text-red-700'}">
+                            ${r.is_registered ? 'On WhatsApp' : 'Not on WhatsApp'}
+                        </span>
+                    </div>
+                `;
+            }).join('');
+        } catch (error) {
+            container.innerHTML = `<div class="text-red-600">Error: ${escapeHtml(error.message)}</div>`;
+        }
+    }
+
+    async function getProfilePicture() {
+        const jidInput = document.getElementById('profile-jid').value.trim();
+
+        if (!jidInput) {
+            showNotification('Please enter a JID', 'warning');
+            return;
+        }
+
+        // Auto-append @s.whatsapp.net if no @ present
+        let fullJid = jidInput;
+        if (!jidInput.includes('@')) {
+            fullJid = jidInput + '@s.whatsapp.net';
+        }
+
+        const resultSection = document.getElementById('profile-result');
+        const container = document.getElementById('profile-container');
+        const noPicture = document.getElementById('profile-no-picture');
+        const image = document.getElementById('profile-image');
+        const jidDisplay = document.getElementById('profile-jid-display');
+        const statusDisplay = document.getElementById('profile-status');
+
+        resultSection.classList.remove('hidden');
+        container.classList.add('hidden');
+        noPicture.classList.remove('hidden');
+        noPicture.innerHTML = '<p class="text-gray-500">Loading...</p>';
+
+        try {
+            const data = await rpc.call('contact_profile_pic', { jid: fullJid, preview: false });
+
+            jidDisplay.textContent = fullJid;
+
+            if (data.exists) {
+                container.classList.remove('hidden');
+                noPicture.classList.add('hidden');
+
+                if (data.data) {
+                    image.src = 'data:image/jpeg;base64,' + data.data;
+                } else if (data.url) {
+                    image.src = data.url;
+                }
+                statusDisplay.textContent = 'Profile picture found';
+            } else {
+                container.classList.add('hidden');
+                noPicture.classList.remove('hidden');
+                noPicture.innerHTML = `
+                    <svg class="w-24 h-24 text-gray-300 mx-auto" fill="currentColor" viewBox="0 0 24 24">
+                        <path d="M24 20.993V24H0v-2.996A14.977 14.977 0 0112.004 15c4.904 0 9.26 2.354 11.996 5.993zM16.002 8.999a4 4 0 11-8 0 4 4 0 018 0z"></path>
+                    </svg>
+                    <p class="text-center mt-2">No profile picture available</p>
+                `;
+            }
+        } catch (error) {
+            container.classList.add('hidden');
+            noPicture.classList.remove('hidden');
+            noPicture.innerHTML = `<p class="text-red-600">Error: ${escapeHtml(error.message)}</p>`;
+        }
+    }
+
+    async function setPresence(status) {
+        const statusEl = document.getElementById('presence-status');
+        statusEl.textContent = 'Setting presence...';
+        statusEl.className = 'mt-3 text-sm text-blue-600';
+
+        try {
+            await rpc.call('presence', { status: status });
+            statusEl.textContent = 'Presence updated successfully';
+            statusEl.className = 'mt-3 text-sm text-green-600';
+        } catch (error) {
+            statusEl.textContent = 'Failed: ' + error.message;
+            statusEl.className = 'mt-3 text-sm text-red-600';
+        }
+    }
+    </script>
+</body>
+</html>