How jfcodes/whatsappjs works
WhatsAppJS is a WhatsApp Web automation wrapper, currently marked v2 WIP. Its main workflow launches a Puppeteer browser, navigates to WhatsApp Web, detects login and exposes a QR code, then focuses a configured chat, reads incoming messages, dispatches app commands, and sends replies. The crypto app is a documented-in-code capability that fetches Binance average prices. Edges reflect calls visible in sampled source or the README; unsampled utility and evaluator internals are not expanded beyond the relationships evidenced by their caller.
Main entry points: whastapp/instance.ts WhatsApp controller · _selectors.ts Page selectors · app.ts Crypto commands · bot/instance.ts Puppeteer browser
Components 18
Automation runtime
- Runtime entry
src/index.ts - WhatsApp controller
src/whastapp/instance.ts - Puppeteer browser
src/bot/instance.ts - Runtime config
src/config.ts - QR image file
WhatsApp interaction
- Login detection
src/whastapp/evaluators/isLoginPage.ts - QR extraction
src/whastapp/evaluators/extrackQrCode.ts - Page selectors
src/whastapp/_selectors.ts - Chat selection
src/whastapp/actions/focusChat.ts - Incoming message scan
src/whastapp/evaluators/lastInput.ts - Message extraction
src/whastapp/evaluators/extractMessage.ts - Message sending
src/whastapp/actions/sendMessage.ts
Command apps
- App contract
src/APPS/_app.ts - Crypto commands
src/APPS/crypto/app.ts - Price formatting
src/APPS/crypto/utils/formatMoney.ts
Other components
- Operator
- WhatsApp Web
- Binance price API
Connections 24
- Operator → Runtime entry: starts
- Runtime entry → WhatsApp controller: creates
src/index.ts - WhatsApp controller → Puppeteer browser: initializes
src/whastapp/instance.ts - WhatsApp controller → Runtime config: reads settings
src/whastapp/instance.ts - Puppeteer browser → Runtime config: reads settings
src/bot/instance.ts - WhatsApp controller → Puppeteer browser: navigates
src/whastapp/instance.ts - Puppeteer browser → WhatsApp Web: controls page
src/bot/instance.ts - WhatsApp controller → Login detection: checks login
src/whastapp/instance.ts - Login detection → Page selectors: queries selectors
src/whastapp/evaluators/isLoginPage.ts - WhatsApp controller → QR extraction: extracts QR
src/whastapp/instance.ts - QR extraction → Page selectors: queries selectors
src/whastapp/evaluators/extrackQrCode.ts - WhatsApp controller → QR image file: saves QR image
src/whastapp/instance.ts - WhatsApp controller → Chat selection: focuses chat
src/whastapp/instance.ts - Chat selection → Page selectors: uses selectors
src/whastapp/actions/focusChat.ts - WhatsApp controller → Message sending: sends messages
src/whastapp/instance.ts - Message sending → Page selectors: uses selectors
src/whastapp/actions/sendMessage.ts - WhatsApp controller → Incoming message scan: polls messages
src/whastapp/instance.ts - WhatsApp controller → Message extraction: extracts message
src/whastapp/instance.ts - Message extraction → Page selectors: uses selectors
src/whastapp/evaluators/extractMessage.ts - WhatsApp controller → App contract: registers apps
src/whastapp/instance.ts - WhatsApp controller → Crypto commands: installs and dispatches
src/whastapp/instance.ts - Crypto commands → App contract: extends contract
src/APPS/crypto/app.ts - Crypto commands → Binance price API: requests price
src/APPS/crypto/app.ts - Crypto commands → Price formatting: formats price
src/APPS/crypto/app.ts