Mistruna.Core.EfCore 5.0.0

Mistruna.Core

Production-oriented .NET building blocks for ASP.NET Core microservices: CQRS, validation, ProblemDetails, persistence, Redis, RabbitMQ, observability, resilience, and optional monetization primitives.

Packages

There is no umbrella meta-package. Add only the packages your service uses:

dotnet add package Mistruna.Core
dotnet add package Mistruna.Core.AspNetCore
dotnet add package Mistruna.Core.EfCore

Quick start

using Mistruna.Core.DependencyInjection;
using Mistruna.Core.AspNetCore.DependencyInjection;
using Mistruna.Core.EfCore;

builder.Services.AddMistrunaCore(options =>
{
    options.RegisterAssemblies(typeof(Program).Assembly);
    options.AddValidation();
    options.AddLoggingBehavior();
});
builder.Services.AddMistrunaAspNetCore();
builder.Services.AddMistrunaEfCore<AppDbContext>();

var app = builder.Build();
app.UseMistrunaExceptionHandler();

Optional integrations compose independently:

builder.Services.AddMistrunaRedis(builder.Configuration);
builder.Services.AddMistrunaRabbitMq(builder.Configuration);
builder.Services.AddMistrunaObservability(builder.Configuration);
builder.Services.AddMistrunaResilience();
builder.Services.AddMistrunaMonetization();

app.UseMistrunaTieredRateLimiting();
app.UseMistrunaIdempotency();
app.UseMistrunaUsageMetering();

Define requests with the markers from Mistruna.Core.Abstractions:

public sealed record GetUserQuery(Guid Id) : IQuery<UserDto>;
public sealed record CreateUserCommand(string Email) : ICommand<Guid>;

Foundation features

• System.Text.Json-only serialization and RFC 7807 ProblemDetails
• MediatR command/query markers with opt-in validation and logging behaviors
• EF Core repository, specification, and unit-of-work implementations
• Redis caching and health checks
• RabbitMQ.Client 7 async publishing via IMistrunaRabbitBus.PublishAsync
• OpenTelemetry tracing, metrics, and MediatR activity enrichment
• HttpClient resilience presets and optional marked-command retries
• API key authentication, plan authorization, rate limits, idempotency, and metering
• EF async query providers and result assertions for consumer tests

Samples

dotnet run --project samples/Mistruna.Core.Samples.BasicApi
dotnet run --project samples/Mistruna.Core.Samples.WorkerRabbit
dotnet run --project samples/Mistruna.Core.Samples.ApiWithOtel

The RabbitMQ sample requires a broker. See samples/README.md for configuration.

Build

Prerequisite: .NET 10 SDK

dotnet format --verify-no-changes
dotnet test
dotnet pack --configuration Release --output ./artifacts

./Build.ps1 runs restore, build, test, and pack. Packages are written to artifacts/.

Contributing

See CONTRIBUTING.md. Pull requests are welcome.

License

MIT — see LICENSE.