How whiskeysockets/baileys works
Baileys is a TypeScript WebSocket client library for interacting with WhatsApp Web. A user supplies authentication and socket configuration; the library establishes a connection, exchanges binary protocol frames, and exposes socket operations for sending and receiving messages and managing chats and groups. The runtime also includes Signal encryption, authentication state, media and message processing, contact synchronization, and business/newsletter features. Several socket implementations are present in the tree but were not sampled, so links involving those modules are omitted or marked unverified rather than inferred.
Main entry points: socket.ts Socket orchestration · messages-send.ts Message sending · messages-recv.ts Message receiving · libsignal.ts Signal repository
Components 33
Connection and protocol
- Public API
src/index.ts - Socket orchestration
src/Socket/socket.ts - WebSocket transport
src/Socket/Client/websocket.ts - Noise handshake
src/Utils/noise-handler.ts - Binary codec
src/WABinary/decode.ts
Messaging and chats
- Message sending
src/Socket/messages-send.ts - Message receiving
src/Socket/messages-recv.ts - Chat operations
src/Socket/chats.ts - Group operations
src/Socket/groups.ts - Community operations
src/Socket/communities.ts - Business operations
src/Socket/business.ts - Newsletter operations
src/Socket/newsletter.ts - Message processing
src/Utils/process-message.ts - Media handling
src/Utils/messages-media.ts
Identity and security
- Signal repository
src/Signal/libsignal.ts - Group encryption
src/Signal/Group/group_cipher.ts - LID mapping
src/Signal/lid-mapping.ts - Authentication state
src/Utils/use-multi-file-auth-state.ts
Sync and shared services
- Runtime defaults
src/Defaults/index.ts - Contact synchronization
src/WAUSync/USyncQuery.ts - Sync protocols
src/WAUSync/Protocols/USyncContactProtocol.ts - Retry management
src/Utils/message-retry-manager.ts - Message model
src/Types/Message.ts - Group metadata model
src/Types/GroupMetadata.ts - Chat utilities
src/Utils/chat-utils.ts - Cryptography
src/Utils/crypto.ts - Link previews
src/Utils/link-preview.ts - Token utilities
src/Utils/tc-token-utils.ts - Logging
src/Utils/logger.ts - Shared utilities
src/Utils/generics.ts - JID utilities
src/WABinary/jid-utils.ts
Other components
- Library user
- WhatsApp Web
Connections 35
- Library user → Public API: uses
README.md - Public API → Socket orchestration: exports
src/index.ts - Socket orchestration → WebSocket transport: dispatches
- WebSocket transport → WhatsApp Web: connects
- Noise handshake → Binary codec: decodes frames
src/Utils/noise-handler.ts - Noise handshake → Cryptography: encrypts frames
src/Utils/noise-handler.ts - Socket orchestration → Message sending: dispatches
- Socket orchestration → Message receiving: dispatches
- Message receiving → Binary codec: parses nodes
src/Socket/messages-recv.ts - Message sending → Binary codec: encodes nodes
src/Socket/messages-send.ts - Message sending → Signal repository: encrypts messages
src/Socket/messages-send.ts - Message sending → Link previews: gets previews
src/Socket/messages-send.ts - Message sending → Token utilities: stores tokens
src/Socket/messages-send.ts - Message receiving → Message sending: sends retries
src/Socket/messages-recv.ts - Message receiving → Retry management: checks retries
src/Socket/messages-recv.ts - Message receiving → Token utilities: reads tokens
src/Socket/messages-recv.ts - Message receiving → Message processing: processes messages
- Message sending → Media handling: handles media
- Signal repository → Group encryption: uses
src/Signal/libsignal.ts - Signal repository → LID mapping: uses
src/Signal/libsignal.ts - Runtime defaults → Signal repository: configures
src/Defaults/index.ts - Contact synchronization → Sync protocols: parses with
src/WAUSync/USyncQuery.ts - Contact synchronization → Binary codec: parses nodes
src/WAUSync/USyncQuery.ts - Message sending → Contact synchronization: queries
src/Socket/messages-send.ts - Socket orchestration → Chat operations: exposes
- Socket orchestration → Group operations: exposes
- Socket orchestration → Community operations: exposes
- Socket orchestration → Business operations: exposes
- Socket orchestration → Newsletter operations: exposes
- Socket orchestration → Authentication state: uses
- Chat utilities → Shared utilities: imports
src/Utils/index.ts - Signal repository → Shared utilities: uses
- Message receiving → Message model: uses types
src/Types/Message.ts - Chat operations → Group metadata model: uses types
- Noise handshake → Runtime defaults: reads settings
src/Utils/noise-handler.ts