Persiltech.UserServices.Abstractions 0.1.4

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 porque el origen de la identidad no garantiza ninguno de los dos: un usuario sin autenticar no los tiene, y uno autenticado puede llegar sin el claim correspondiente. El contrato obliga al consumidor a decidir qué hacer en ese caso en lugar de devolver una cadena vacía que oculte la diferencia.

IsAuthenticated no es anulable: siempre hay una respuesta, aunque sea false.

Uso

using Persiltech.UserServices.Abstractions;

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

        return new Order
        {
            Reference = command.Reference,
            CreatedBy = userService.UserName ?? "unknown",
        };
    }
}

Implementar el adaptador

El paquete no trae ninguna implementación: la aporta la solución consumidora, en su capa de infraestructura, junto con el registro en el contenedor. Por ejemplo, resolviendo la identidad desde HttpContext:

using System.Security.Claims;
using Microsoft.AspNetCore.Http;
using Persiltech.UserServices.Abstractions;

public sealed class HttpContextUserService(IHttpContextAccessor httpContextAccessor) : IUserService
{
    private ClaimsPrincipal? User => httpContextAccessor.HttpContext?.User;

    public bool IsAuthenticated => User?.Identity?.IsAuthenticated ?? false;

    public string? UserName => User?.FindFirstValue(ClaimTypes.Name);

    public string? FullName => User?.FindFirstValue(ClaimTypes.GivenName);
}

Y su registro:

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

Tanto el adaptador como el registro pertenecen a la solución consumidora, no a este paquete.

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.