NPv.DataAccess.Ef 1.2.1

NPv.DataAccess.Ef

Pluggable EF Core infrastructure for generic repository and unit of work integration.

📦 Version 1.0.0 — Entity Enhancements & LongText Support

Overview

This library extends your Entity Framework Core–based projects with:

• A reusable EfCoreGenericRepository for standard CRUD operations
• A pluggable IDbContextProvider and unit of work pattern implementation
• Enhanced mapping conventions for entities and string fields
• Value generation using GuidV7ValueGenerator for sequential GUIDs
• Support for [LongText] and default nvarchar(256) string mappings

Designed to be a drop-in infrastructure layer for services, APIs, background workers — anywhere you rely on EF Core.

🚀 Getting Started

1. Add a reference to the package.
2. Register your DbContext and IDbContextProvider in DI container.
3. Use provided abstractions to simplify CRUD and transaction boundaries.

✅ Example Setup

Define your application DbContext:

public class ApplicationContext(DbContextOptions<ApplicationContext> options) : DbContext(options)
{
    protected override void OnModelCreating(ModelBuilder builder)
    {
        base.OnModelCreating(builder);

        foreach (var entityType in builder.Model.GetEntityTypes()
                     .Where(t => t.ClrType.IsSubclassOf(typeof(Entity))))
        {
            var entity = builder.Entity(entityType.ClrType);
            entity.Property("Id")
                  .ValueGeneratedOnAdd()
                  .HasValueGenerator<GuidV7ValueGenerator>();
        }

        // Applies default mapping for strings to nvarchar(256)
        DefaultString256MaxLengthMapping.ApplyMapping(builder);
    }
}

🛠 Usage Notes

• All string columns are limited to nvarchar(256) by default
• Use [LongText] or [MaxLength] to override per-property behavior
• Entity Id is auto-generated using a performant sequential GuidV7
• DbContextProvider requires an explicit autoCommitOnDispose parameter to control commit behavior.
• Set autoCommitOnDispose: true when using unit of work per request (e.g., in typical API scenarios).
• Set autoCommitOnDispose: false when using external unit of work coordination (e.g., with NPv.Uow.Ef) and commit explicitly through that mechanism.

Author's Note

This library grew out of my long-standing personal interest in structuring and publishing open source packages. Over time, I’ve revisited and refined earlier internal utilities and ideas, giving them a more consistent shape and preparing them for wider reuse. Along the way, I’ve also taken the opportunity to explore how open source distribution and licensing work in the .NET ecosystem.

It’s a small step toward something I’ve always wanted to try — sharing practical, minimal tools that reflect years of learning, experimentation, and refinement.

Hopefully, someone finds it useful.

Nikolai 😛

⚖️ License

MIT — you are free to use this in commercial and open-source software.