Skip to content

catchmeifyoucaan/surprise-sender

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

77 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸš€ Surprise Sender - Enterprise-Grade Email Automation Platform

World-class email automation platform with advanced AI capabilities, phishing-grade delivery optimization, and enterprise management features.

Build Status License Node.js TypeScript

🎯 Overview

Surprise Sender is a next-generation email automation platform that combines advanced AI capabilities, enterprise-grade delivery optimization, and comprehensive management tools. Built to exceed industry standards and compete with tools like GoPhish, it delivers 99%+ email success rates with intelligent routing, real-time monitoring, and phishing-grade obfuscation techniques.

✨ Key Features

  • πŸš€ Ultra-fast SMTP validation with parallel processing
  • πŸ€– Advanced AI agents with collaborative crews
  • πŸ“Š Real-time monitoring and analytics dashboard
  • 🎯 99%+ delivery success rate with optimization
  • πŸ”’ Enterprise-grade security and compliance
  • πŸ“ˆ Scalable architecture for growth
  • 🎨 Modern, responsive UI with role-based access

πŸ—οΈ Architecture

Frontend

  • React 18 with TypeScript
  • Tailwind CSS for modern styling
  • React Router for navigation
  • React Hot Toast for notifications
  • Heroicons for beautiful icons
  • Headless UI for accessible components

Backend

  • Express.js with TypeScript
  • TypeORM for database management
  • SQLite for data storage
  • JWT for authentication
  • Nodemailer for email sending
  • Google Gemini AI for content generation

Advanced Services

  • Advanced Email Service - Enterprise-grade email delivery
  • AI Agent Service - Collaborative AI crews
  • Admin Dashboard - Super manager controls
  • SMTP Manager - Bulk validation and management

πŸš€ Getting Started

Prerequisites

  • Node.js >= 16.0.0
  • npm or yarn
  • Google Gemini API key (for AI features)

Installation

  1. Clone the repository

    git clone https://github.com/your-repo/surprise-sender.git
    cd surprise-sender
  2. Install dependencies

    npm install
    cd server && npm install
    cd ..
  3. Environment setup

    # Create .env file in root directory
    cp .env.example .env
    
    # Add your configuration
    JWT_SECRET=your-secret-key
    GEMINI_API_KEY=your-gemini-api-key
  4. Database setup

    cd server
    npm run migration:run
  5. Start the application

    # Terminal 1 - Frontend
    npm run dev
    
    # Terminal 2 - Backend
    npm run server
  6. Access the application

🎯 Core Features

πŸ“§ Advanced Email Automation

SMTP Management

  • Bulk SMTP validation with performance scoring
  • Real-time status monitoring with visual indicators
  • Intelligent routing based on delivery scores
  • Connection pooling for maximum efficiency
  • Reputation checking against blacklists

Email Delivery Optimization

  • 99%+ success rate with deep analysis
  • Advanced obfuscation (low/medium/high levels)
  • Subject and content optimization
  • Header optimization for spam filters
  • Timing optimization for better open rates

Bulk Email Campaigns

  • Mass email sending with intelligent batching
  • Progress tracking and real-time updates
  • Template management with variable substitution
  • Attachment support with optimization
  • Rate limiting and retry logic

πŸ€– AI-Powered Features

Agentic AI Crews

  • Collaborative AI agents working together
  • Intelligent task assignment and processing
  • Content generation with context awareness
  • Email optimization suggestions
  • Automated content analysis

Smart Content Generation

  • AI-powered email templates
  • Subject line optimization
  • Content personalization
  • Spam score analysis
  • Delivery optimization suggestions

πŸ“Š Enterprise Management

Super Manager Dashboard

  • Real-time system monitoring (CPU, memory, disk, network)
  • User activity tracking with IP addresses
  • Campaign management with pause/resume/stop
  • Security event monitoring and alerts
  • Email analytics with hourly statistics
  • Performance metrics and trend analysis

Advanced SMTP Manager

  • Bulk validation with performance scoring
  • Individual/selective validation options
  • Advanced filtering and sorting capabilities
  • Bulk actions (validate, activate, deactivate, delete)
  • Validation result caching for 5 minutes
  • Error tracking and resolution

User Management

  • Role-based access control (admin, user)
  • User activity monitoring
  • Permission management
  • Security settings configuration
  • Two-factor authentication support

πŸ”’ Security & Compliance

Authentication & Authorization

  • JWT-based authentication
  • Role-based access control
  • Two-factor authentication
  • Session management
  • Password policies

Data Protection

  • Input validation with Zod schemas
  • Rate limiting and request throttling
  • Error handling with detailed logging
  • Audit logging for all actions
  • GDPR compliance ready

Monitoring & Alerts

  • Security event monitoring
  • Failed login attempt tracking
  • System health monitoring
  • Real-time alert system
  • Performance metrics tracking

🎨 User Interface

Modern Dashboard

  • Real-time statistics and charts
  • Interactive tables with sorting and filtering
  • Status indicators with color coding
  • Progress bars for campaign tracking
  • Responsive design for all devices

Advanced Navigation

  • Role-based sidebar with conditional rendering
  • Quick action buttons
  • Search and filter capabilities
  • Breadcrumb navigation
  • Dark/light theme support

Admin Features

  • Advanced Admin Dashboard - /admin-dashboard
  • SMTP Manager - /smtp-manager
  • User Management - /users
  • System Monitoring - Real-time metrics
  • Security Controls - Comprehensive management

πŸ”§ API Endpoints

Authentication

POST /api/auth/login - User login
POST /api/auth/register - User registration
POST /api/auth/forgot-password - Password reset

Email Management

POST /api/email/send - Send single email
POST /api/email/send-bulk - Send bulk emails
POST /api/email/send-template - Send templated email
POST /api/email/validate-smtp - Validate SMTP configuration
GET /api/email/stats - Email statistics
GET /api/email/activity - Recent activity

AI Agents

GET /api/agents - List AI agents
POST /api/agents - Create new agent
POST /api/agents/crews - Create AI crew
POST /api/agents/tasks - Assign tasks
POST /api/agents/generate-content - Generate content
POST /api/agents/analyze - Analyze content

Admin Management

GET /api/admin/stats - System statistics
GET /api/admin/activities - User activities
GET /api/admin/campaigns - Campaign management
POST /api/admin/users/:id/:action - User management
POST /api/admin/campaigns/:id/:action - Campaign control
GET /api/admin/smtp-configurations - SMTP configs
POST /api/admin/smtp/bulk-validate - Bulk validation
GET /api/admin/performance - System performance
GET /api/admin/email-analytics - Email analytics
GET /api/admin/security-events - Security monitoring

πŸ“Š Performance & Scalability

Email Delivery Optimization

  • Parallel processing for bulk operations
  • Connection pooling for SMTP servers
  • Intelligent routing based on performance scores
  • Caching system for validation results
  • Rate limiting and throttling

System Performance

  • Memory optimization with efficient data structures
  • Database query optimization with proper indexing
  • Real-time monitoring and alerting
  • Horizontal scaling ready architecture
  • Load balancing support

Enterprise Features

  • Multi-tenant architecture ready
  • Database sharding capabilities
  • Microservices ready design
  • API rate limiting and throttling
  • Comprehensive logging and monitoring

πŸš€ Deployment

Development

npm run dev          # Start frontend development server
npm run server       # Start backend development server
npm run build        # Build for production

Production

# Build the application
npm run build

# Start production server
npm start

Docker Deployment

# Build Docker image
docker build -t surprise-sender .

# Run container
docker run -p 3000:3000 -p 5173:5173 surprise-sender

πŸ”§ Configuration

Environment Variables

# Authentication
JWT_SECRET=your-secret-key

# AI Services
GEMINI_API_KEY=your-gemini-api-key

# Database
DATABASE_URL=sqlite:./database.sqlite

# Email
SMTP_HOST=smtp.example.com
SMTP_PORT=587
SMTP_USER=your-email@example.com
SMTP_PASS=your-password

# Server
PORT=3000
NODE_ENV=production

SMTP Configuration

The platform supports multiple SMTP configurations with:

  • Automatic validation and scoring
  • Performance monitoring
  • Intelligent routing
  • Connection pooling
  • Rate limiting

πŸ“ˆ Analytics & Reporting

Email Analytics

  • Delivery rates by SMTP configuration
  • Open and click tracking
  • Bounce analysis
  • Spam score monitoring
  • Performance trends

System Analytics

  • User activity monitoring
  • System performance metrics
  • Security event tracking
  • Resource utilization
  • Error rate monitoring

Campaign Analytics

  • Campaign performance tracking
  • A/B testing capabilities
  • Conversion tracking
  • ROI analysis
  • Audience insights

πŸ”’ Security Features

Authentication Security

  • JWT tokens with expiration
  • Password hashing with bcrypt
  • Two-factor authentication
  • Session management
  • Login attempt limiting

Data Security

  • Input validation and sanitization
  • SQL injection prevention
  • XSS protection
  • CSRF protection
  • Rate limiting

Compliance

  • GDPR compliance ready
  • Data encryption at rest and in transit
  • Audit logging for all actions
  • Access control with fine-grained permissions
  • Privacy policy compliance

🀝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Development Setup

# Fork and clone the repository
git clone https://github.com/your-fork/surprise-sender.git

# Install dependencies
npm install

# Run tests
npm test

# Start development servers
npm run dev
npm run server

Code Style

  • TypeScript for type safety
  • ESLint for code quality
  • Prettier for formatting
  • Conventional commits for version control

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ†˜ Support

Documentation

Community

Enterprise Support

For enterprise support and custom development, please contact us at:

πŸ† Why Choose Surprise Sender?

Competitive Advantages

  • βœ… Faster than GoPhish with parallel processing
  • βœ… More advanced AI with agentic crews
  • βœ… Better deliverability with optimization algorithms
  • βœ… Enterprise-grade monitoring and management
  • βœ… Scalable architecture for growth

Business Value

  • 🎯 99%+ email delivery success rate
  • πŸ€– Automated management reduces manual work
  • πŸ“Š Real-time monitoring prevents issues
  • πŸ“ˆ Advanced analytics for optimization
  • πŸš€ Scalable platform for business growth

Built with ❀️ for enterprise email automation

Surprise Sender - The future of email automation is here.

About

No description, website, or topics provided.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages