Syntrony.Repositories 1.1.0

Syntrony.Repositories

Contrato de repositorio generico, agnostico de motor de persistencia — equivalente a IRepository<TEntity, TKey> de ABP, recortado a lo que se usa — junto con las interfaces de entidad (IEntity<TKey>), las clases base (Entity<TKey>, CreationAuditedEntity<TKey>, AuditedEntity<TKey>, FullAuditedEntity<TKey>) y las convenciones de auditoria/soft-delete (ISoftDelete, ICreationAudited, IModificationAudited, IDeletionAudited...) que las implementaciones deben respetar. Un app service depende de este contrato sin conocer el backend real.

Sin dependencias de EF Core, Mongo ni ASP.NET Core — solo depende del nucleo Syntrony para los contratos de excepcion (IHasHttpStatusCode, IHasLogSeverity). Las implementaciones por motor (Syntrony.EntityFrameworkCore.Repositories hoy, Mongo si aparece) dependen de esta interfaz, no al reves.

Installation

dotnet add package Syntrony.Repositories

Implementing a provider

RepositoryBase<TEntity, TKey> resuelve con LINQ sobre IQueryable todo lo que no requiere conocimiento del motor de persistencia. Un proveedor nuevo solo implementa cinco metodos:

public class InMemoryRepository<TEntity, TKey> : RepositoryBase<TEntity, TKey>
    where TEntity : class, IEntity<TKey>
{
    private readonly List<TEntity> _items;

    public InMemoryRepository(IEnumerable<TEntity>? seed = null) => _items = seed?.ToList() ?? [];

    public override IQueryable<TEntity> GetAll() => _items.AsQueryable();
    public override IQueryable<TEntity> GetAllReadonly() => _items.AsQueryable();

    public override Task<TEntity> InsertAsync(TEntity entity, CancellationToken ct = default)
    {
        _items.Add(entity);
        return Task.FromResult(entity);
    }

    public override Task<TEntity> UpdateAsync(TEntity entity, CancellationToken ct = default)
        => Task.FromResult(entity);

    public override Task DeleteAsync(TEntity entity, CancellationToken ct = default)
    {
        _items.Remove(entity);
        return Task.CompletedTask;
    }
}

Un proveedor serio (EF Core, Mongo) deberia ademas sobreescribir GetAllListAsync, CountAsync y LongCountAsync con las versiones async nativas del motor — la base las resuelve por defecto enumerando sincronamente sobre IQueryable, correcto pero no optimo.

Status

Contrato e implementaciones base completos: interfaces de entidad, IRepository<TEntity, TKey>, RepositoryBase<TEntity, TKey>, las clases base de entidad y las excepciones de dominio (EntityNotFoundException, ConcurrencyException). Listo para publicar 1.0.0.