ChokusAlert 1.0.2

🚨 Chokus Alert

Chokus Alert is a high-performance, production-ready middleware for ASP.NET Core that automatically captures unhandled exceptions and sends detailed, beautifully formatted HTML email reports to your development team.

Designed for modern, scalable applications, it operates entirely in the background—ensuring zero impact on request performance while keeping your team instantly informed.

✨ Features

⚡ Zero Performance Impact

Captures request and exception data synchronously, then dispatches email notifications on a background thread. Your users never experience delays—even during failures.

🛡️ Intelligent Anti-Spam Protection

Prevents alert flooding using in-memory hashing and caching. Identical errors within a defined time window trigger only one email, no matter how many times they occur.

👔 Professional HTML Reports

Receive structured, easy-to-read email reports including:

• Exception type and message
• Request path and HTTP method
• User-Agent details
• Source code location (file & line number)
• Full formatted stack trace

🔒 Secure & Fail-Safe

• Enforces SSL for SMTP communication
• Fails silently if the mail server is unavailable
• Guarantees your main application will never crash due to alerting

🪶 Lightweight & Native

Built exclusively with .NET 9 using native Microsoft libraries. No third-party dependencies. No unnecessary overhead.

📦 Installation

Using NuGet Package Manager

Install-Package ChokusAlert

Using .NET CLI

dotnet add package ChokusAlert

⚙️ Configuration

Add the following section to your appsettings.json:

{
  "ChokusAlert": {
    "Host": "smtp.yourprovider.com",
    "Port": 587,
    "User": "alerts@yourdomain.com",
    "FromEmail": "alerts@yourdomain.com",
    "MuteDuplicateErrorsMinutes": 5,
    "AlertRecipients": [
      "lead.dev@yourdomain.com",
      "backend.team@yourdomain.com"
    ]
  }
}

🔐 Security Best Practice

Never store your SMTP password in source control.

Use secure storage:

Development (User Secrets)

dotnet user-secrets set "ChokusAlert:Pass" "YourSecureAppPassword123!"

Production

Use environment variables or a secure secret manager.

🚀 Usage

Register the service and middleware in Program.cs:

using ChokusAlert;

var builder = WebApplication.CreateBuilder(args);

// Register services (includes memory cache)
builder.Services.AddChokusAlert(builder.Configuration);

builder.Services.AddControllers();

var app = builder.Build();

// Add middleware early in the pipeline
app.UseChokusAlert();

app.UseHttpsRedirection();
app.UseAuthorization();
app.MapControllers();

app.Run();

📧 Email Preview

When an unhandled exception occurs, your team receives a structured HTML email like:

Subject:

🚨 [Chokus] NullReferenceException: Object reference not set to an instance...

Details:

Followed by a full, formatted stack trace for deep debugging.

🧠 How It Works

1. Middleware intercepts unhandled exceptions
2. Extracts request + environment details instantly
3. Generates a unique hash for deduplication
4. Checks cache to prevent duplicate alerts
5. Sends a formatted email asynchronously

🤝 Contributing

Contributions, issues, and feature requests are welcome.

If you'd like to improve Chokus Alert:

• Fork the repository
• Create a feature branch
• Submit a pull request

📝 License

This project is licensed under the MIT License.

Free for:

• Commercial use
• Personal projects
• Open-source applications

💡 Why Chokus Alert?

Because production errors shouldn't go unnoticed—and they definitely shouldn't slow down your app.

Fast. Silent. Reliable.