@mbermeo/wa-blaster 0.1.3 → 0.1.7

package/README.md

@@ -1,6 +1,21 @@
-# WA Blast — Sistema de Mensajes Masivos por WhatsApp
+# `@mbermeo/wa-blaster` — Sistema de Mensajes Masivos por WhatsApp
 
-Sistema para enviar mensajes masivos por WhatsApp con soporte multi-cuenta, plantillas con variables, imágenes con A/B testing, scheduling por hora/día, control de campañas y comportamiento anti-spam. Incluye API HTTP, interfaz web y CLI para uso por agentes de IA.
+[![npm version](https://img.shields.io/npm/v/@mbermeo/wa-blaster.svg)](https://www.npmjs.com/package/@mbermeo/wa-blaster)
+[![Node](https://img.shields.io/badge/node-20%20%7C%2022%20%7C%2024-brightgreen.svg)](https://nodejs.org/)
+
+Sistema para enviar mensajes masivos por WhatsApp con soporte multi-cuenta, plantillas con variables, imágenes con A/B testing, scheduling por hora/día, control de campañas y comportamiento anti-spam. Incluye API HTTP, interfaz web, **CLI** y **MCP server** para que agentes de IA (Claude, etc.) lo controlen nativamente.
+
+## Inicio rápido
+
+```bash
+# Levantar el server (auto-detecta puerto libre, datos en ~/.wa-blast/)
+npx -y @mbermeo/wa-blaster@latest serve
+
+# Desde otra terminal: usar el CLI
+npx -y @mbermeo/wa-blaster@latest accounts list
+```
+
+Para integrar con Claude Desktop / Code, ver [`docs/AGENT_MCP.md`](docs/AGENT_MCP.md).
 
 ---
 
@@ -30,19 +45,70 @@ Sistema para enviar mensajes masivos por WhatsApp con soporte multi-cuenta, plan
 
 ## Requisitos
 
-- **Node.js v24+** (recomendado via `nvm`)
-- **npm**
-- Chromium (Puppeteer lo descarga automáticamente al hacer `npm install`)
-- Un teléfono con WhatsApp para escanear el QR
+- **Node.js 20.x, 22.x o 24.x** — el paquete distribuye bytecode V8 compilado para esas versiones específicas. Si usás otra versión, el binario falla con un mensaje claro al ejecutarse.
+- **macOS, Linux o Windows** — Puppeteer descarga Chromium automáticamente la primera vez (~170 MB).
+- **Un teléfono con WhatsApp** para escanear el QR de autenticación.
+
+### ¿No tenés una versión compatible de Node?
+
+```bash
+# Con nvm (recomendado)
+nvm install 22 && nvm use 22
+
+# Con fnm
+fnm install 22 && fnm use 22
+
+# Con volta
+volta install node@22
+
+# Manual: descargá la LTS desde https://nodejs.org/
+```
+
+Verificá con:
+```bash
+node --version    # debe imprimir v20.x, v22.x o v24.x
+```
 
 ---
 
 ## Instalación
 
+### Como CLI/MCP (recomendado)
+
+No requiere instalación: usá `npx` directamente.
+
+```bash
+# Probar
+npx -y @mbermeo/wa-blaster@latest --version
+
+# Levantar el server (puerto auto-asignado por el OS)
+npx -y @mbermeo/wa-blaster@latest serve
+
+# Usar el CLI desde otra terminal (auto-detecta el server)
+npx -y @mbermeo/wa-blaster@latest accounts list
+```
+
+Tip: agregá un alias en tu `~/.zshrc` o `~/.bashrc` para no repetir el namespace:
+```bash
+alias wab='npx -y @mbermeo/wa-blaster@latest'
+```
+
+### Como dependencia global
+
+```bash
+npm install -g @mbermeo/wa-blaster
+wa-blast --version
+```
+
+### Desde el código fuente (desarrollo)
+
 ```bash
 git clone <repo>
 cd agente_whatsapp
 npm install
+npm run build           # compila bytecode para tu versión actual de Node
+npm run build:all       # compila para Node 20, 22, 24 (requiere nvm)
+npm test
 ```
 
 ---

package/bin/wa-blast.js

@@ -22,6 +22,28 @@
 const fs = require('fs');
 const path = require('path');
 
+// ─── Preflight: versión de Node mínima ──────────────────────────────────────
+// Bytenode genera bytecode específico por versión mayor de V8/Node, así que
+// si el usuario está en una versión sin bytecode compilado, fallamos temprano
+// con un mensaje claro y accionable. Esto se complementa con engines.node
+// del package.json (warning) y con el check posterior por target específico.
+(function preflight() {
+  const major = parseInt(process.versions.node.split('.')[0], 10);
+  const MIN = 20;
+  if (major < MIN) {
+    process.stderr.write(
+      `\n[wa-blast] Node ${process.versions.node} no es compatible.\n` +
+      `[wa-blast] Se requiere Node >= ${MIN}.x\n\n` +
+      `Soluciones:\n` +
+      `  • Con nvm:   nvm install 22 && nvm use 22\n` +
+      `  • Con fnm:   fnm install 22 && fnm use 22\n` +
+      `  • Con volta: volta install node@22\n` +
+      `  • Manual:    https://nodejs.org/  (descargá la LTS)\n\n`
+    );
+    process.exit(1);
+  }
+})();
+
 // ─── Pre-parseo de flags globales ────────────────────────────────────────────
 // Minimal, antes de cargar nada más. El CLI/lib reparsea normalmente después.
 //

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mbermeo/wa-blaster",
-  "version": "0.1.3",
+  "version": "0.1.7",
   "description": "Sistema de mensajes masivos por WhatsApp con CLI y MCP server para agentes",
   "main": "bin/wa-blast.js",
   "bin": {