General.Frontend.Shared 3.0.3

Generic API Client

Reusable .NET client infrastructure for consuming ASP.NET Core APIs through HttpClient.

The package depends on the Generic Backend package for shared API contracts and data models. It does not duplicate those types. Its responsibility is the client-side HTTP infrastructure and generic API repository implementation.

Features

• Generic IGenericAPIRepository<TResponse, TRequest> contract
• Reusable GenericAPIRepository<TResponse, TRequest> implementation
• GET by identifier
• Paginated GET
• HTTP QUERY for dynamic filtering
• POST create
• PUT update
• ResponseService<T> and QueryResult<T> support
• Bearer token support
• Cancellation token propagation
• Dependency-injection friendly design
• UI agnostic

Architecture

Application / UI
       |
       v
IGenericAPIRepository<TResponse,TRequest>
       ^
       |
GenericAPIRepository<TResponse,TRequest>
       |
       v
HttpClient
       |
       v
ASP.NET Core API

The application depends on the repository contract while the generic implementation handles HTTP transport.

Quick Start

Create a resource-specific repository:

public sealed class ActivityAPIRepository(HttpClient httpClient)
    : GenericAPIRepository<ActivityDto, ActivityCreationDto>(
        httpClient,
        "activity",
        "api")
{
}

Register the abstraction:

services.AddScoped<
    IGenericAPIRepository<ActivityDto, ActivityCreationDto>,
    ActivityAPIRepository>();

Consume it through the interface:

public sealed class ActivityService(
    IGenericAPIRepository<ActivityDto, ActivityCreationDto> repository)
{
    public Task<ResponseService<ActivityDto>> GetAsync(
        int id,
        CancellationToken cancellationToken = default)
    {
        return repository.GetByIdAsync(id, cancellationToken);
    }
}

Endpoints

GET    /api/activity/{id}
GET    /api/activity?page=1&recordsByPage=20
QUERY  /api/activity/dynamic-filter
POST   /api/activity
PUT    /api/activity/{id}

Dynamic Query

var request = new QueryRequest(
    new RequestPagination(1, 20),
    filters);

var response = await repository.QueryAsync(
    request,
    cancellationToken);

Documentation

• Developer Guide
• API Reference

Design Principles

• Contract-first: applications depend on IGenericAPIRepository.
• Generic transport: HTTP construction and JSON serialization are centralized.
• DTO-based communication: the client does not require backend persistence entities.
• Query metadata preservation: QueryResult<T> contains records and total count.
• Cancellation propagation: tokens flow to HttpClient.
• UI agnostic: no dependency on Blazor, Radzen, or another UI framework.