FonsecaFramework.Asp 2026.6.18.1

FonsecaFramework.Asp

Base classes and extensions for ASP.NET Core web applications.

Overview

FonsecaFramework.Asp is a .NET 10 library that provides a fluent builder API for configuring ASP.NET Core applications. It includes helpers for MVC, Razor Pages, Swagger, OAuth2 JWT authentication with token refresh, Windows Service hosting, timed background services with business-hour awareness, a base API controller, and an AI-powered dynamic rate limiter that uses ML.NET to adapt limits based on real-time traffic telemetry.

Installation

dotnet add package FonsecaFramework.Asp

Features

Examples

Quick API Setup with Swagger and MVC

using FonsecaFramework.Asp;

var builder = WebApplication.CreateWindowsServiceBuilder(args);
builder.AddMvcServices()
 .AddSwagger();

var app = builder.Build();
app.EnableSwagger()
 .EnableMvc();

app.Run();

Add OAuth2 JWT Authentication

using FonsecaFramework.Asp;

var builder = Microsoft.AspNetCore.Builder.WebApplication.CreateBuilder(args);

// Register your IUserService implementation
builder.Services.AddSingleton<IUserService, MyUserService>();

// Configure JWT authentication
builder.AddOAuth2Server(
 ValidIssuer: "https://myapp.com",
 ValidAudience: "https://myapp.com",
 Key: "YourSuperSecretKeyAtLeast32Characters!");

builder.AddMvcServices()
 .AddSwagger();

var app = builder.Build();

// This adds /login and /refresh_token endpoints automatically
app.EnableOAuth2Server(
 TokenIssuer: "https://myapp.com",
 TokenAudience: "https://myapp.com",
 TokenKey: "YourSuperSecretKeyAtLeast32Characters!");

app.EnableSwagger()
 .EnableMvc();
app.Run();

Implement the IUserService interface to provide your own user authentication:

using FonsecaFramework.Asp;

public class MyUserService : IUserService
{
 public async Task<IEnumerable<Claim>> GetUserClaimsWithUserAndPassword(
 string username, string password)
 {
 // Validate credentials and return claims
 if (username == "admin" && password == "secret")
 {
 return new[]
 {
 new Claim(ClaimTypes.Name, username),
 new Claim(ClaimTypes.Role, "Admin")
 };
 }
 return Enumerable.Empty<Claim>();
 }
}

Base API Controller

Inherit from BaseApiController to get [ApiController] and [Route("[controller]")] applied automatically:

using FonsecaFramework.Asp;
using Microsoft.AspNetCore.Mvc;

public class ProductsController : BaseApiController
{
 [HttpGet]
 public IActionResult GetAll() => Ok(new[] { "Widget", "Gadget" });

 [HttpGet("{id}")]
 public IActionResult GetById(int id) => Ok($"Product {id}");
}

Timed Background Service

Run a recurring task with optional business-hour restrictions:

using FonsecaFramework.Asp;

var builder = Microsoft.AspNetCore.Builder.WebApplication.CreateBuilder(args);

// Run every 5 minutes, only between 8 AM and 6 PM
builder.Services.AddTimedHostedService(
 doWork: (serviceProvider) =>
 {
 Console.WriteLine($"Background work at {DateTime.Now}");
 },
 startBusinessHour: DateTime.Today.AddHours(8),
 endBusinessHour: DateTime.Today.AddHours(18),
 frequency: TimeSpan.FromMinutes(5));

// Or run 24/7 with no business-hour restriction
builder.Services.AddTimedHostedService(
 doWork: (sp) => Console.WriteLine("Always running"),
 frequency: TimeSpan.FromMinutes(1));

AI-Powered Dynamic Rate Limiting

Rate limits that automatically adapt based on live traffic patterns using ML.NET:

using FonsecaFramework.Asp;
using FonsecaFramework.Asp.RateLimiting;

var builder = Microsoft.AspNetCore.Builder.WebApplication.CreateBuilder(args);

builder.Services.AddAiDynamicRateLimiter("ai-policy");
builder.AddMvcServices();

var app = builder.Build();

// Collect request telemetry (add early in pipeline)
app.UseAiRateLimitingTelemetry();
app.UseRateLimiter();
app.EnableMvc();

app.Run();

Apply the policy to controllers:

using Microsoft.AspNetCore.RateLimiting;

[EnableRateLimiting("ai-policy")]
public class WeatherController : BaseApiController
{
 [HttpGet]
 public IActionResult Get() => Ok("Hello");
}

Requirements

• .NET 10.0

License

Copyright 2025 Steven Fonseca / VLR Creations

Licensed under the . You may use this library free of charge, provided you include the required attribution notices. See the file for full terms.