How neoxr/neoxr-bot works
NEOXR-BOT is a WhatsApp bot whose base capabilities include social-media downloads, group management, and utilities. Its main workflow receives WhatsApp events, adapts messages, applies schema and command/event handling, and responds through plugins. The map includes the documented feature families and the core connection, configuration, and persistence layers. Some plugin implementations are unsampled, so those branches are grouped by their existing directories; edges are limited to relationships shown in excerpts or documented in the README.
Main entry points: handler.js Message Handler · client.js Client Setup · listeners-extra.js Event Listeners · schema.js Message Schema
Components 24
WhatsApp Runtime
- Client Setup
client.js - Baileys Engine
lib/engine.js - Message Helpers
lib/baileys.js - Event Listeners
lib/listeners-extra.js
Message Handling
- Message Handler
handler.js - Message Schema
lib/schema.js
Bot Features
- Download Features
plugins/download - Automatic Downloads
plugins/_events/downloader - Group Management
plugins/group - Group Protections
plugins/_events - Media Conversion
plugins/convert - Utilities
plugins/utilities - AI Commands
plugins/ai - Admin Commands
plugins/admin - Owner Commands
plugins/owner - User Information
plugins/userinfo
State and Persistence
- Data Models
lib/models.js - Storage Adapter
lib/adapter.js - Configured Database
Operations
- Expiry Notifier
lib/notifier.js - Bot Configuration
lib/config.js
Other components
- WhatsApp User
- WhatsApp Service
- Neoxr API
Connections 24
- WhatsApp User → WhatsApp Service: sends messages
- WhatsApp Service → Event Listeners: delivers events
- Client Setup → Baileys Engine: configures engine
client.js - Client Setup → Storage Adapter: initializes storage
client.js - Client Setup → Data Models: loads models
client.js - Client Setup → Event Listeners: registers listeners
client.js - Event Listeners → Message Helpers: adapts messages
lib/listeners-extra.js - Event Listeners → Message Handler: dispatches messages
lib/listeners-extra.js - Message Handler → Message Schema: initializes records
handler.js - Message Handler → Download Features: dispatches commands
- Message Handler → Automatic Downloads: dispatches events
- Message Handler → Group Management: dispatches commands
- Message Handler → Group Protections: dispatches events
- Message Handler → Media Conversion: dispatches commands
- Message Handler → Utilities: dispatches commands
- Message Handler → AI Commands: dispatches commands
- Message Handler → Admin Commands: dispatches commands
- Message Handler → Owner Commands: dispatches commands
- Message Handler → User Information: dispatches commands
- Message Schema → Data Models: uses defaults
lib/schema.js - Storage Adapter → Configured Database: selects backend
lib/adapter.js - Client Setup → Expiry Notifier: starts via listeners
- Expiry Notifier → Configured Database: checks expiry state
- Bot Configuration → Neoxr API: configures API
lib/config.js