whatsapp-rpc 0.0.4

package/README.md

@@ -0,0 +1,139 @@
+# WhatsApp RPC
+
+WebSocket JSON-RPC 2.0 API for WhatsApp.
+
+<img width="1280" height="676" alt="image" src="https://github.com/user-attachments/assets/ddc7324a-8c4d-4557-ac6f-cb091a8ce31f" />
+
+## Architecture
+
+```
+┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
+│   Your App      │     │    Web UI       │     │  Python Client  │
+│  (Any Language) │     │   (Flask)       │     │    Library      │
+└────────┬────────┘     └────────┬────────┘     └────────┬────────┘
+         │                       │                       │
+         │      WebSocket        │      HTTP             │
+         │      JSON-RPC 2.0     │      :5000            │
+         │                       │                       │
+         └───────────┬───────────┴───────────────────────┘
+                     │
+                     ▼
+         ┌───────────────────────┐
+         │   Go WebSocket API    │
+         │       :9400           │
+         │  ┌─────────────────┐  │
+         │  │  RPC Handler    │  │
+         │  │  Rate Limiter   │  │
+         │  │  Event Emitter  │  │
+         │  └────────┬────────┘  │
+         └───────────┼───────────┘
+                     │
+                     ▼
+         ┌───────────────────────┐
+         │   WhatsApp Service    │
+         │  ┌─────────────────┐  │
+         │  │   whatsmeow     │  │
+         │  │   (Go Library)  │  │
+         │  └────────┬────────┘  │
+         └───────────┼───────────┘
+                     │
+                     ▼
+         ┌───────────────────────┐
+         │   WhatsApp Servers    │
+         └───────────────────────┘
+
+Data Storage:
+┌─────────────────────────────────┐
+│  data/                          │
+│  ├── whatsapp.db   (SQLite)     │
+│  ├── qr/*.png      (QR codes)   │
+│  └── groups.json   (Group cache)│
+└─────────────────────────────────┘
+```
+
+## Setup
+
+### Native
+```bash
+npm start           # Start API + Web UI
+npm stop            # Stop all
+npm run restart     # Restart all
+npm run status      # Check if running
+npm run api         # Start API only
+npm run web         # Start Web UI only
+npm run build       # Build Go binary
+npm run clean       # Full cleanup (bin, data, node_modules)
+```
+
+All commands auto-install dependencies if missing.
+
+### Docker
+```bash
+docker-compose up -d      # Start
+docker-compose down       # Stop
+docker-compose logs -f    # View logs
+```
+
+## Endpoints
+
+| Port | Service |
+|------|---------|
+| 9400 | WebSocket API - `ws://localhost:9400/ws/rpc` |
+| 5000 | Web UI - `http://localhost:5000` |
+
+## API
+
+Connect via WebSocket and send JSON-RPC 2.0 requests:
+
+```json
+{"jsonrpc": "2.0", "id": 1, "method": "send", "params": {"phone": "1234567890", "type": "text", "message": "Hello"}}
+```
+
+### Methods
+
+| Method | Params | Description |
+|--------|--------|-------------|
+| `status` | - | Connection status |
+| `start` | - | Start WhatsApp |
+| `stop` | - | Stop WhatsApp |
+| `restart` | - | Full reset (logout, delete DB, new QR) |
+| `qr` | - | Get QR code (base64 PNG) |
+| `send` | `phone/group_id`, `type`, `message/media_data` | Send message |
+| `media` | `message_id` | Download received media |
+| `groups` | - | List all groups |
+| `group_info` | `group_id` | Get group details |
+| `contact_check` | `phones[]` | Check if numbers are on WhatsApp |
+
+Full schema: [schema.json](schema.json)
+
+## Events
+
+Server pushes events as JSON-RPC notifications (no `id`):
+
+```json
+{"jsonrpc": "2.0", "method": "event.message_received", "params": {...}}
+```
+
+Events: `connected`, `disconnected`, `qr_code`, `message_received`, `message_sent`
+
+## Data Files
+
+- `data/whatsapp.db` - SQLite database (session, contacts)
+- `data/qr/*.png` - QR code images
+- `data/groups.json` - Auto-generated on connection (indexed group data)
+
+## Structure
+
+```
+src/go/          # Go backend
+src/python/      # Python client library
+web/             # Flask web UI
+scripts/         # CLI tools
+configs/         # YAML config
+```
+
+## Requirements
+
+- Go 1.21+
+- Python 3.8+
+- Node.js 16+

package/configs/config.yaml

@@ -0,0 +1,7 @@
+environment: "development"
+log_level: 4
+server:
+  port: 9400
+  host: "0.0.0.0"
+database:
+  path: "data/whatsapp.db"

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "whatsapp-rpc",
+  "version": "0.0.4",
+  "type": "module",
+  "description": "WhatsApp WebSocket RPC Server with JSON-RPC 2.0 protocol",
+  "author": "Rohit G <trohitg@gmail.com>",
+  "license": "MIT",
+  "homepage": "https://github.com/trohitg/whatsapp-rpc#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/trohitg/whatsapp-rpc.git"
+  },
+  "bugs": {
+    "url": "https://github.com/trohitg/whatsapp-rpc/issues"
+  },
+  "keywords": [
+    "whatsapp",
+    "rpc",
+    "websocket",
+    "json-rpc",
+    "messaging",
+    "automation"
+  ],
+  "bin": {
+    "whatsapp-rpc": "./scripts/cli.js"
+  },
+  "files": [
+    "bin/",
+    "scripts/",
+    "src/",
+    "configs/",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "postinstall": "node scripts/download-binary.js",
+    "prestart": "node -e \"require('fs').existsSync('node_modules')||require('child_process').execSync('npm i',{stdio:'inherit'})\"",
+    "start": "node scripts/cli.js start",
+    "prestop": "node -e \"require('fs').existsSync('node_modules')||require('child_process').execSync('npm i',{stdio:'inherit'})\"",
+    "stop": "node scripts/cli.js stop",
+    "prerestart": "node -e \"require('fs').existsSync('node_modules')||require('child_process').execSync('npm i',{stdio:'inherit'})\"",
+    "restart": "node scripts/cli.js restart",
+    "prestatus": "node -e \"require('fs').existsSync('node_modules')||require('child_process').execSync('npm i',{stdio:'inherit'})\"",
+    "status": "node scripts/cli.js status",
+    "preapi": "node -e \"require('fs').existsSync('node_modules')||require('child_process').execSync('npm i',{stdio:'inherit'})\"",
+    "api": "node scripts/cli.js api --foreground",
+    "preweb": "node -e \"require('fs').existsSync('node_modules')||require('child_process').execSync('npm i',{stdio:'inherit'})\"",
+    "web": "node scripts/cli.js web",
+    "prebuild": "node -e \"require('fs').existsSync('node_modules')||require('child_process').execSync('npm i',{stdio:'inherit'})\"",
+    "build": "node -e \"const fs=require('fs'),p=process.platform==='win32'?'.exe':'',d='bin';fs.existsSync(d)||fs.mkdirSync(d);require('child_process').execSync('go build -v -o '+d+'/whatsapp-rpc-server'+p+' ./src/go/cmd/server',{stdio:'inherit'});console.log('Build complete: '+d+'/whatsapp-rpc-server'+p)\"",
+    "clean": "node scripts/clean.cjs"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^11.1.0",
+    "execa": "^8.0.1",
+    "kill-port": "^2.0.1"
+  }
+}

package/scripts/clean.cjs

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+// Standalone clean script - no npm dependencies required
+const { existsSync, unlinkSync, readdirSync, rmSync } = require('fs');
+const { join } = require('path');
+const { execSync } = require('child_process');
+
+const ROOT = join(__dirname, '..');
+const BIN = process.platform === 'win32' ? 'whatsapp-rpc-server.exe' : 'whatsapp-rpc-server';
+const BIN_DIR = join(ROOT, 'bin');
+
+const log = (msg, color) => {
+  const colors = { green: '\x1b[32m', blue: '\x1b[34m', yellow: '\x1b[33m', reset: '\x1b[0m' };
+  console.log(`${colors[color] || ''}${msg}${colors.reset}`);
+};
+
+// Kill process on port
+const killPort = (port, name) => {
+  try {
+    if (process.platform === 'win32') {
+      execSync(`for /f "tokens=5" %a in ('netstat -aon ^| findstr :${port} ^| findstr LISTENING') do taskkill /F /PID %a`, { stdio: 'ignore', shell: 'cmd.exe' });
+    } else {
+      execSync(`lsof -ti:${port} | xargs kill -9 2>/dev/null || true`, { stdio: 'ignore' });
+    }
+    log(`${name} stopped`, 'green');
+  } catch { log(`${name} not running`, 'yellow'); }
+};
+
+log('Stopping all processes...', 'blue');
+killPort(9400, 'API');
+killPort(5000, 'Web');
+
+// Remove binary
+const bin = join(BIN_DIR, BIN);
+if (existsSync(bin)) { unlinkSync(bin); log(`Removed ${BIN}`, 'green'); }
+
+// Remove bin directory if empty
+if (existsSync(BIN_DIR) && readdirSync(BIN_DIR).length === 0) {
+  rmSync(BIN_DIR, { recursive: true }); log('Removed bin/', 'green');
+}
+
+// Remove entire data directory (database, QR codes, etc.)
+const dataDir = join(ROOT, 'data');
+if (existsSync(dataDir)) {
+  rmSync(dataDir, { recursive: true });
+  log('Removed data/', 'green');
+}
+
+// Remove any .db files in project root (legacy locations)
+readdirSync(ROOT).filter(f => f.endsWith('.db') || f.endsWith('.db-wal') || f.endsWith('.db-shm')).forEach(f => {
+  unlinkSync(join(ROOT, f));
+  log(`Removed ${f}`, 'green');
+});
+
+// Remove node_modules
+const nodeModules = join(ROOT, 'node_modules');
+if (existsSync(nodeModules)) { rmSync(nodeModules, { recursive: true }); log('Removed node_modules/', 'green'); }
+
+// Remove Python cache
+const pycache = join(ROOT, 'web', '__pycache__');
+if (existsSync(pycache)) { rmSync(pycache, { recursive: true }); log('Removed web/__pycache__/', 'green'); }
+
+// Remove package-lock.json
+const lockFile = join(ROOT, 'package-lock.json');
+if (existsSync(lockFile)) { unlinkSync(lockFile); log('Removed package-lock.json', 'green'); }
+
+log('Clean complete', 'green');

package/scripts/cli.js

@@ -0,0 +1,171 @@
+#!/usr/bin/env node
+import { program } from 'commander';
+import chalk from 'chalk';
+import { execa } from 'execa';
+import killPort from 'kill-port';
+import { Socket } from 'net';
+import { execSync, spawn } from 'child_process';
+import { existsSync, statSync, unlinkSync, readdirSync, rmSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = join(__dirname, '..');
+const API_PORT = 9400, WEB_PORT = 5000;
+const BIN = process.platform === 'win32' ? 'whatsapp-rpc-server.exe' : 'whatsapp-rpc-server';
+const BIN_DIR = join(ROOT, 'bin');
+
+const log = (m, c = 'blue') => console.log(chalk[c](m));
+const sleep = ms => new Promise(r => setTimeout(r, ms));
+
+const portUp = port => new Promise(r => {
+  const s = new Socket();
+  s.setTimeout(2000);
+  s.on('connect', () => { s.destroy(); r(true); });
+  s.on('timeout', () => { s.destroy(); r(false); });
+  s.on('error', () => r(false));
+  s.connect(port, '127.0.0.1');
+});
+
+const wait = async (port, ms = 10000) => {
+  const t = Date.now();
+  while (Date.now() - t < ms) { if (await portUp(port)) return true; await sleep(500); }
+  return false;
+};
+
+const kill = async (port, name) => {
+  try { await killPort(port); log(`${name} stopped`, 'green'); }
+  catch { log(`${name} not running`, 'yellow'); }
+};
+
+const py = () => {
+  try { execSync('python --version', { stdio: 'ignore' }); return 'python'; }
+  catch { try { execSync('python3 --version', { stdio: 'ignore' }); return 'python3'; } catch { return null; } }
+};
+
+const hasGo = () => {
+  try { execSync('go version', { stdio: 'ignore' }); return true; }
+  catch { return false; }
+};
+
+async function api(foreground = false) {
+  if (await portUp(API_PORT)) { log(`API already on ${API_PORT}`, 'yellow'); return; }
+  const bin = join(BIN_DIR, BIN);
+  if (!existsSync(bin)) {
+    if (!hasGo()) {
+      log('Go is not installed. Please either:', 'red');
+      log('  1. Install Go: https://go.dev/dl/', 'yellow');
+      log('  2. Or run "npm run build" on a machine with Go installed', 'yellow');
+      log('  3. Or copy the pre-built binary to: ' + bin, 'yellow');
+      process.exit(1);
+    }
+    log('Building...', 'yellow');
+    await build();
+  }
+
+  if (foreground) {
+    // Run in foreground - will receive Ctrl+C signals
+    const proc = spawn(bin, [], { cwd: ROOT, stdio: 'inherit' });
+    proc.on('close', (code) => process.exit(code || 0));
+    process.on('SIGINT', () => { proc.kill('SIGINT'); });
+    process.on('SIGTERM', () => { proc.kill('SIGTERM'); });
+    log(`API: ws://localhost:${API_PORT}/ws/rpc`, 'green');
+  } else {
+    // Run detached in background
+    spawn(bin, [], { cwd: ROOT, detached: true, stdio: 'ignore' }).unref();
+    if (await wait(API_PORT)) log(`API: ws://localhost:${API_PORT}/ws/rpc`, 'green');
+    else log('API failed to start', 'red');
+  }
+}
+
+async function web() {
+  if (await portUp(WEB_PORT)) { log(`Web already on ${WEB_PORT}`, 'yellow'); return; }
+  const p = py(); if (!p) { log('Python not found', 'red'); return; }
+  if (!await portUp(API_PORT)) log('Warning: API not running', 'yellow');
+  spawn(p, ['app.py'], { cwd: join(ROOT, 'web'), detached: true, stdio: 'ignore' }).unref();
+  if (await wait(WEB_PORT)) log(`Web: http://localhost:${WEB_PORT}`, 'green');
+  else log('Web failed to start', 'red');
+}
+
+async function start() { await api(); await sleep(1000); await web(); }
+async function stop() { await kill(API_PORT, 'API'); await kill(WEB_PORT, 'Web'); }
+
+async function status() {
+  const a = await portUp(API_PORT), w = await portUp(WEB_PORT);
+  log(`API (${API_PORT}): ${a ? 'UP' : 'DOWN'}`, a ? 'green' : 'red');
+  log(`Web (${WEB_PORT}): ${w ? 'UP' : 'DOWN'}`, w ? 'green' : 'red');
+}
+
+async function build() {
+  const bin = join(BIN_DIR, BIN);
+
+  // Skip if binary already exists (e.g., downloaded from GitHub Releases)
+  if (existsSync(bin)) {
+    log(`Binary already exists: ${BIN} (${(statSync(bin).size / 1024 / 1024).toFixed(1)}MB)`, 'green');
+    return;
+  }
+
+  // Build from source requires Go
+  if (!hasGo()) {
+    log('Go is not installed and no pre-built binary found.', 'red');
+    log('Install Go from: https://go.dev/dl/', 'yellow');
+    process.exit(1);
+  }
+
+  if (!existsSync(BIN_DIR)) { await execa('mkdir', ['-p', BIN_DIR]); }
+  await execa('go', ['build', '-o', bin, './src/go/cmd/server'], { cwd: ROOT, stdio: 'inherit' });
+  log(`Built: ${BIN} (${(statSync(bin).size / 1024 / 1024).toFixed(1)}MB)`, 'green');
+}
+
+async function clean() {
+  log('Stopping all processes...', 'blue');
+  await stop();
+  await sleep(1000);
+
+  // Remove binary
+  const bin = join(BIN_DIR, BIN);
+  if (existsSync(bin)) { unlinkSync(bin); log(`Removed ${BIN}`, 'green'); }
+
+  // Remove bin directory if empty
+  if (existsSync(BIN_DIR) && readdirSync(BIN_DIR).length === 0) {
+    rmSync(BIN_DIR, { recursive: true }); log('Removed bin/', 'green');
+  }
+
+  // Remove entire data directory (database, QR codes, etc.)
+  const dataDir = join(ROOT, 'data');
+  if (existsSync(dataDir)) {
+    rmSync(dataDir, { recursive: true });
+    log('Removed data/', 'green');
+  }
+
+  // Remove any .db files in project root (legacy locations)
+  readdirSync(ROOT).filter(f => f.endsWith('.db') || f.endsWith('.db-wal') || f.endsWith('.db-shm')).forEach(f => {
+    unlinkSync(join(ROOT, f));
+    log(`Removed ${f}`, 'green');
+  });
+
+  // Remove node_modules
+  const nodeModules = join(ROOT, 'node_modules');
+  if (existsSync(nodeModules)) { rmSync(nodeModules, { recursive: true }); log('Removed node_modules/', 'green'); }
+
+  // Remove Python cache
+  const pycache = join(ROOT, 'web', '__pycache__');
+  if (existsSync(pycache)) { rmSync(pycache, { recursive: true }); log('Removed web/__pycache__/', 'green'); }
+
+  // Remove package-lock.json
+  const lockFile = join(ROOT, 'package-lock.json');
+  if (existsSync(lockFile)) { unlinkSync(lockFile); log('Removed package-lock.json', 'green'); }
+
+  log('Clean complete', 'green');
+}
+
+program.name('wa').version('1.0.0');
+program.command('start').description('Start all').action(start);
+program.command('stop').description('Stop all').action(stop);
+program.command('restart').description('Restart all').action(async () => { await stop(); await sleep(1000); await start(); });
+program.command('status').description('Status').action(status);
+program.command('api').description('Start API only').option('-f, --foreground', 'Run in foreground (receive signals)').action((opts) => api(opts.foreground));
+program.command('web').description('Start Web only').action(web);
+program.command('build').description('Build binary').action(build);
+program.command('clean').description('Clean artifacts').action(clean);
+program.parse();

package/scripts/download-binary.js

@@ -0,0 +1,200 @@
+#!/usr/bin/env node
+/**
+ * Downloads pre-built WhatsApp RPC server binary from GitHub releases.
+ * Called automatically during npm postinstall.
+ *
+ * Skip conditions:
+ * - WHATSAPP_RPC_SKIP_BINARY_DOWNLOAD=1
+ * - CI=true (CI builds from source)
+ * - Binary already exists
+ * - Go is installed and WHATSAPP_RPC_PREFER_SOURCE=1
+ */
+import { execSync } from 'child_process';
+import { createWriteStream, existsSync, mkdirSync, chmodSync, readFileSync, unlinkSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import https from 'https';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = resolve(__dirname, '..');
+const BIN_DIR = resolve(ROOT, 'bin');
+
+// Read version from package.json
+const pkg = JSON.parse(readFileSync(resolve(ROOT, 'package.json'), 'utf-8'));
+const VERSION = pkg.version;
+
+// GitHub release URL
+const GITHUB_REPO = 'trohitg/whatsapp-rpc';
+const BASE_URL = `https://github.com/${GITHUB_REPO}/releases/download/v${VERSION}`;
+
+// Platform detection
+function getPlatformInfo() {
+  const osMap = { 'win32': 'windows', 'darwin': 'darwin', 'linux': 'linux' };
+  const archMap = { 'x64': 'amd64', 'arm64': 'arm64' };
+
+  const os = osMap[process.platform];
+  const goarch = archMap[process.arch];
+
+  if (!os || !goarch) {
+    return null;
+  }
+
+  const ext = process.platform === 'win32' ? '.exe' : '';
+  return { os, goarch, ext };
+}
+
+// Check if Go is installed
+function hasGo() {
+  try {
+    execSync('go version', { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// Download file with redirect handling
+function downloadFile(url, dest) {
+  return new Promise((resolve, reject) => {
+    // Remove partial download if exists
+    if (existsSync(dest)) {
+      try { unlinkSync(dest); } catch { /* ignore */ }
+    }
+
+    const request = (currentUrl, redirectCount = 0) => {
+      if (redirectCount > 5) {
+        reject(new Error('Too many redirects'));
+        return;
+      }
+
+      const protocol = currentUrl.startsWith('https') ? https : require('http');
+
+      protocol.get(currentUrl, (response) => {
+        // Handle redirects (GitHub releases redirect to CDN)
+        if (response.statusCode >= 300 && response.statusCode < 400 && response.headers.location) {
+          request(response.headers.location, redirectCount + 1);
+          return;
+        }
+
+        if (response.statusCode === 404) {
+          reject(new Error(`Binary not found: v${VERSION} may not have pre-built binaries yet`));
+          return;
+        }
+
+        if (response.statusCode !== 200) {
+          reject(new Error(`HTTP ${response.statusCode}`));
+          return;
+        }
+
+        const file = createWriteStream(dest);
+        const totalBytes = parseInt(response.headers['content-length'], 10);
+        let downloadedBytes = 0;
+
+        response.on('data', (chunk) => {
+          downloadedBytes += chunk.length;
+          if (totalBytes) {
+            const percent = ((downloadedBytes / totalBytes) * 100).toFixed(1);
+            process.stdout.write(`\r  Downloading: ${percent}%`);
+          }
+        });
+
+        response.pipe(file);
+        file.on('finish', () => {
+          file.close();
+          console.log(' Done');
+          resolve();
+        });
+        file.on('error', (err) => {
+          file.close();
+          try { unlinkSync(dest); } catch { /* ignore */ }
+          reject(err);
+        });
+      }).on('error', (err) => {
+        try { unlinkSync(dest); } catch { /* ignore */ }
+        reject(err);
+      });
+    };
+
+    request(url);
+  });
+}
+
+// Main
+async function main() {
+  // Skip conditions
+  if (process.env.WHATSAPP_RPC_SKIP_BINARY_DOWNLOAD === '1') {
+    console.log('[whatsapp-rpc] Skipping binary download (WHATSAPP_RPC_SKIP_BINARY_DOWNLOAD=1)');
+    return;
+  }
+
+  if (process.env.CI === 'true' || process.env.GITHUB_ACTIONS === 'true') {
+    console.log('[whatsapp-rpc] Skipping binary download (CI environment - will build from source)');
+    return;
+  }
+
+  const platformInfo = getPlatformInfo();
+  if (!platformInfo) {
+    console.log(`[whatsapp-rpc] Unsupported platform: ${process.platform}/${process.arch}`);
+    console.log('[whatsapp-rpc] Please build from source: npm run build');
+    return;
+  }
+
+  const { os, goarch, ext } = platformInfo;
+  const binaryName = `whatsapp-rpc-server-${os}-${goarch}${ext}`;
+  const downloadUrl = `${BASE_URL}/${binaryName}`;
+  const destPath = resolve(BIN_DIR, `whatsapp-rpc-server${ext}`);
+
+  // Check if binary already exists
+  if (existsSync(destPath)) {
+    console.log(`[whatsapp-rpc] Binary already exists: ${destPath}`);
+    return;
+  }
+
+  // Check if Go is installed and user prefers source
+  if (hasGo() && process.env.WHATSAPP_RPC_PREFER_SOURCE === '1') {
+    console.log('[whatsapp-rpc] Go is installed and WHATSAPP_RPC_PREFER_SOURCE=1, skipping download');
+    console.log('[whatsapp-rpc] Build from source with: npm run build');
+    return;
+  }
+
+  console.log(`[whatsapp-rpc] Downloading pre-built binary...`);
+  console.log(`  Version: v${VERSION}`);
+  console.log(`  Platform: ${os}/${goarch}`);
+
+  // Create bin directory
+  if (!existsSync(BIN_DIR)) {
+    mkdirSync(BIN_DIR, { recursive: true });
+  }
+
+  // Download binary
+  try {
+    await downloadFile(downloadUrl, destPath);
+  } catch (error) {
+    console.error(`\n[whatsapp-rpc] Failed to download binary: ${error.message}`);
+
+    if (hasGo()) {
+      console.log('[whatsapp-rpc] Go is installed - you can build from source: npm run build');
+    } else {
+      console.log('[whatsapp-rpc] Install Go to build from source: https://go.dev/dl/');
+    }
+    return;
+  }
+
+  // Set executable permission (Unix only)
+  if (process.platform !== 'win32') {
+    try {
+      chmodSync(destPath, 0o755);
+    } catch (err) {
+      console.warn(`[whatsapp-rpc] Warning: Could not set executable permission: ${err.message}`);
+    }
+  }
+
+  console.log(`[whatsapp-rpc] Binary installed: ${destPath}`);
+}
+
+main().catch((err) => {
+  // Don't fail npm install - just log and continue
+  console.error('[whatsapp-rpc] Binary download error:', err.message);
+  console.log('[whatsapp-rpc] WhatsApp features will not work until binary is built.');
+  console.log('[whatsapp-rpc] Build from source with: npm run build');
+});