FonsecaFramework.Asp 2026.5.12.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 Apache License, Version 2.0. You may use this library free of charge, provided you include the required attribution notices. See the LICENSE file for full terms.