How pramtoxz/wa-gateway works
This repository is a secured, multi-session WhatsApp API gateway. API clients call session, messaging, and profile endpoints; the gateway authenticates and validates requests, then manages WhatsApp sessions or queues outbound messages. Redis supports shared session state and rate limiting, while optional webhooks report message and session events. The map reflects README capabilities, but some route and service internals were not sampled; those relationships are included only where the README or shown source supports them.
Main entry points: index.ts HTTP Gateway · message.ts Message API · session.ts Session API · audit-log.service.ts Audit Logging
Components 22
API Runtime
- HTTP Gateway
src/index.ts
Gateway Workflows
- Session API
src/controllers/session.ts - Message API
src/controllers/message.ts - Profile API
src/controllers/profile.ts - Session Manager
src/services/session-manager.service.ts - Message Queue
src/services/message-queue.service.ts
Security Controls
- API Authentication
src/middlewares/auth.middleware.ts - Request Validation
src/middlewares/validation.middleware.ts - Input Sanitization
src/middlewares/input-sanitization.middleware.ts - Request Rate Limits
src/middlewares/rate-limit.middleware.ts - Security Configuration
src/config/security.config.ts - Key and Token Auth
src/services/auth.service.ts - Audit Logging
src/services/audit-log.service.ts - Security Headers
src/middlewares/security-headers.middleware.ts - Request Size Guard
src/middlewares/request-size.middleware.ts
State and Integrations
- Redis Service
src/services/redis.service.ts - WhatsApp Network
- Message Webhook
src/webhooks/message.ts - Webhook Media
src/webhooks/media.ts - Session Webhook
src/webhooks/session.ts
Other components
- API Client
- Webhook Receiver
Connections 33
- API Client → HTTP Gateway: sends requests
README.md - HTTP Gateway → Session API: routes requests
src/index.ts - HTTP Gateway → Message API: routes requests
src/index.ts - HTTP Gateway → Profile API: routes requests
src/index.ts - HTTP Gateway → API Authentication: protects routes
src/index.ts - HTTP Gateway → Security Headers: applies headers
src/index.ts - HTTP Gateway → Request Size Guard: limits requests
src/index.ts - HTTP Gateway → Request Rate Limits: applies limits
src/index.ts - Session API → Request Validation: validates input
src/controllers/session.ts - Session API → Session Manager: manages sessions
src/controllers/session.ts - Session API → Audit Logging: records activity
src/controllers/session.ts - Session API → WhatsApp Network: controls sessions
src/controllers/session.ts - Message API → Request Validation: validates input
src/controllers/message.ts - Message API → Input Sanitization: checks input
src/controllers/message.ts - Message API → Message Queue: queues messages
src/controllers/message.ts - Message API → Audit Logging: records activity
src/controllers/message.ts - Message API → WhatsApp Network: checks sessions
src/controllers/message.ts - Profile API → Request Validation: validates input
src/controllers/profile.ts - API Authentication → Key and Token Auth: verifies credentials
src/middlewares/auth.middleware.ts - API Authentication → Audit Logging: records auth events
src/middlewares/auth.middleware.ts - Request Rate Limits → Redis Service: checks limits
src/middlewares/rate-limit.middleware.ts - Key and Token Auth → Security Configuration: uses policy
src/services/auth.service.ts - Session Manager → Security Configuration: uses policy
src/services/session-manager.service.ts - Session Manager → Redis Service: reads and writes
src/services/session-manager.service.ts - Message Queue → WhatsApp Network: sends messages
src/services/message-queue.service.ts - HTTP Gateway → Message Webhook: registers handler
src/index.ts - HTTP Gateway → Session Webhook: registers handler
src/index.ts - Message Webhook → Webhook Media: uses media helper
src/webhooks/message.ts - Message Webhook → Webhook Receiver: posts events
src/webhooks/message.ts - Session Webhook → Webhook Receiver: posts status
src/webhooks/session.ts - Session Webhook → WhatsApp Network: reads device info
src/webhooks/session.ts - HTTP Gateway → Redis Service: initializes service
src/index.ts - HTTP Gateway → Audit Logging: flushes on shutdown
src/index.ts