Persiltech.UserServices.Abstractions 0.1.6

Persiltech.UserServices.Abstractions

Define la interfaz IUserService, un Output Port que expone el estado de autenticación y la identidad del usuario actual, para que cualquier solución basada en Arquitectura Limpia lo consuma.

Instalación

dotnet add package Persiltech.UserServices.Abstractions

El contrato

namespace Persiltech.UserServices.Abstractions;

public interface IUserService
{
    bool IsAuthenticated { get; }

    string? UserName { get; }

    string? FullName { get; }
}

UserName y FullName son anulables de forma deliberada: un usuario no autenticado no tiene identidad que exponer, y uno autenticado puede no traer ese dato según el mecanismo de autenticación de la solución consumidora. El consumidor decide qué hacer ante la ausencia del dato; el contrato no impone un valor de reemplazo.

Uso

La capa de aplicación depende únicamente de la interfaz:

public sealed class CreateOrderHandler(IUserService userService)
{
    public Order Handle(CreateOrderCommand command)
    {
        if (!userService.IsAuthenticated)
        {
            throw new UnauthorizedAccessException();
        }

        return new Order(command.ProductId, userService.UserName);
    }
}

Implementar el adaptador

Este paquete no trae ninguna implementación: el adaptador de infraestructura y su registro en el contenedor corresponden a la solución consumidora. Un adaptador típico de ASP.NET Core resuelve el contrato desde HttpContext.User:

public sealed class HttpContextUserService(IHttpContextAccessor httpContextAccessor) : IUserService
{
    public bool IsAuthenticated =>
        httpContextAccessor.HttpContext?.User.Identity?.IsAuthenticated ?? false;

    public string? UserName =>
        httpContextAccessor.HttpContext?.User.Identity?.Name;

    public string? FullName =>
        httpContextAccessor.HttpContext?.User.FindFirst(ClaimTypes.GivenName)?.Value;
}

Y se registra en el proyecto que compone la aplicación:

builder.Services.AddHttpContextAccessor();
builder.Services.AddScoped<IUserService, HttpContextUserService>();

Decisiones de diseño

• Paquete de puros contratos: no incluye ninguna implementación concreta de IUserService; cada solución consumidora provee su propio adaptador de infraestructura.
• Sin dependencias a Microsoft.AspNetCore.* ni a ningún framework de hosting, para poder referenciarse desde una capa de dominio o de aplicación sin arrastrar dependencias de infraestructura.
• Sin registro en el contenedor de dependencias: no hay implementación que registrar.

Compatibilidad

net10.0

Estado

Versión 0.x: la superficie pública puede cambiar entre versiones menores.

Licencia

MIT. Consulta el archivo LICENSE.