👁 Image
CShells.FastEndpoints 0.0.28

CShells.FastEndpoints

FastEndpoints integration for CShells providing automatic endpoint discovery and registration for shell features.

Purpose

This package integrates FastEndpoints with CShells, allowing you to build high-performance APIs with per-shell endpoint isolation and configuration.

Key Features

• Automatic FastEndpoints discovery - Endpoints are discovered from features implementing IFastEndpointsShellFeature
• Per-shell endpoint isolation - Each shell has its own set of FastEndpoints
• Shell-scoped route prefix - Configure EndpointRoutePrefix per shell for FastEndpoints-specific prefixing
• Configurator support - Implement IFastEndpointsConfigurator for custom FastEndpoints configuration

Installation

dotnet add package CShells.FastEndpoints

Quick Start

1. Create a FastEndpoints Feature

using CShells.FastEndpoints.Features;
using CShells.Features;
using Microsoft.Extensions.DependencyInjection;

[ShellFeature("MyApi", DependsOn = ["FastEndpoints"])]
public class MyApiFeature : IFastEndpointsShellFeature
{
 public void ConfigureServices(IServiceCollection services)
 {
 services.AddSingleton<IMyService, MyService>();
 }
}

2. Create an Endpoint

using FastEndpoints;

public class GetWeatherEndpoint : EndpointWithoutRequest<WeatherResponse>
{
 public override void Configure()
 {
 Get("weather");
 AllowAnonymous();
 }

 public override async Task HandleAsync(CancellationToken ct)
 {
 await SendAsync(new WeatherResponse { Temperature = 72 });
 }
}

3. Configure Shell

{
 "CShells": {
 "Shells": {
 "Default": {
 "Features": { "Core": {}, "FastEndpoints": {}, "MyApi": {} },
 "Configuration": {
 "WebRouting": {
 "Path": "",
 "RoutePrefix": "api/v1"
 },
 "FastEndpoints": {
 "EndpointRoutePrefix": "fe"
 }
 }
 }
 }
 }
}

With this configuration, the weather endpoint is accessible at /api/v1/fe/weather.

Configuration

Route Prefixes

CShells.FastEndpoints supports two levels of route prefixing:

Custom Configurators

Implement IFastEndpointsConfigurator to customize FastEndpoints configuration:

public class MyConfigurator : IFastEndpointsConfigurator
{
 public void Configure(Config config)
 {
 config.Serializer.Options.PropertyNamingPolicy = JsonNamingPolicy.CamelCase;
 }
}

Register in your feature:

public void ConfigureServices(IServiceCollection services)
{
 services.AddSingleton<IFastEndpointsConfigurator, MyConfigurator>();
}

Related Packages

• CShells.FastEndpoints.Abstractions - Interfaces for feature libraries (reference this in your feature projects)
• CShells.AspNetCore - Required for web routing and endpoint registration

Further Reading

• FastEndpoints Documentation
• CShells Feature Configuration