RepositoryKit.MongoDB 9.0.3

<div align="center"> <img src="logo-64x64.png" width="120" alt="RepositoryKit logo" />

RepositoryKit.MongoDb

MongoDB Implementation for RepositoryKit

</div>

📦 Package

This package provides the MongoDB implementation of RepositoryKit’s abstractions.

It enables consistent, testable, and flexible repository patterns for MongoDB projects —
without unnecessary UnitOfWork or transaction layers.

✅ Implementations

🚀 Usage Examples

1. Register in DI (Startup or Program.cs)

builder.Services.AddSingleton<IMongoClient>(_ => new MongoClient("mongodb://localhost:27017"));
builder.Services.AddScoped<IMongoDatabase>(sp =>
    sp.GetRequiredService<IMongoClient>().GetDatabase("SampleDb"));

builder.Services.AddScoped<IProductRepository, ProductRepository>();

2. Basic Repository Usage (Minimal API)

app.MapPost("/products", async (IProductRepository repo, Product product) =>
{
    await repo.AddAsync(product);
    return Results.Created($"/products/{product.Id}", product);
});

3. Custom Repository Inheritance & Usage

Custom Repository Interface and Implementation

public interface IProductRepository : IRepository<Product>
{
    Task<List<Product>> GetExpensiveProductsAsync(decimal minPrice);
}

public class ProductRepository : MongoRepository<Product, IMongoDatabase>, IProductRepository
{
    public ProductRepository(IMongoDatabase db) : base(db) { }

    public async Task<List<Product>> GetExpensiveProductsAsync(decimal minPrice)
    {
        return await _collection.Find(p => p.Price > minPrice).ToListAsync();
    }
}

Endpoint Usage

app.MapGet("/products/expensive", async (IProductRepository repo, decimal minPrice) =>
{
    var expensive = await repo.GetExpensiveProductsAsync(minPrice);
    return Results.Ok(expensive);
});

4. All RepositoryKit.Extensions Can Be Used

All LINQ-based RepositoryKit.Extensions (like Shuffle, FirstOrNone, GroupBySelect, SafeDistinct, etc.) can be used directly in your MongoDB sample:

var products = await repo.GetAllAsync();
var shuffled = products.Shuffle().ToList();

🚨 Exception Handling

Repository operations wrap errors with the standard RepositoryException from RepositoryKit.Core:

try
{
    await repo.AddAsync(product);
}
catch (RepositoryException ex)
{
    // Handle or log error info
}

🤝 Dependencies

• RepositoryKit.Core
• MongoDB.Driver (official MongoDB driver)

📜 License

MIT © Ataberk Kaya

📎 This package is the official MongoDB provider for RepositoryKit.