Persiltech.UserServices.Abstractions 0.1.2

Persiltech.UserServices.Abstractions

Output Port IUserService que expone el estado de autenticación y la identidad del usuario actual, para consumirlo desde cualquier solución basada en Arquitectura Limpia.

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 contrato no asume de dónde sale la identidad: un usuario anónimo no tiene ninguno de los dos, y un proveedor de identidad puede autenticar sin emitir el claim correspondiente. Un consumidor que necesite el valor debe tratar null como un caso legítimo, no como un error del adaptador.

Uso

namespace Persiltech.Orders.Application;

public sealed class CreateOrderHandler(IUserService userService)
{
    public string Handle()
    {
        if (!userService.IsAuthenticated)
        {
            return "Se requiere un usuario autenticado.";
        }

        string displayName = userService.FullName ?? userService.UserName ?? "usuario desconocido";

        return $"Pedido creado por {displayName}.";
    }
}

Implementar el adaptador

El paquete no trae implementación ni registro en el contenedor de dependencias. El adaptador y su registro corresponden a la solución consumidora, normalmente en su capa de infraestructura:

namespace Persiltech.Orders.Infrastructure;

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;
}

services.AddHttpContextAccessor();
services.AddScoped<IUserService, HttpContextUserService>();

Decisiones de diseño

• Paquete de puros contratos: no incluye ninguna implementación concreta de IUserService (Ej. una que la resuelva desde HttpContext.User); cada solución consumidora provee su propio adaptador de infraestructura para el contrato.
• Sin dependencias a Microsoft.AspNetCore.* ni a ningún framework de hosting, para poder referenciarse desde una capa de dominio/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.