Marventa.Framework 4.0.0

This package has been deprecated as it is legacy and is no longer maintained.

There is a newer version of this package available.
See the version list below for details.

dotnet add package Marventa.Framework --version 4.0.0

NuGet\Install-Package Marventa.Framework -Version 4.0.0

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="Marventa.Framework" Version="4.0.0" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="Marventa.Framework" Version="4.0.0" />
                    

                            Directory.Packages.props

<PackageReference Include="Marventa.Framework" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add Marventa.Framework --version 4.0.0

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Marventa.Framework, 4.0.0"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#:package Marventa.Framework@4.0.0

#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.

#addin nuget:?package=Marventa.Framework&version=4.0.0
                    

                            Install as a Cake Addin

#tool nuget:?package=Marventa.Framework&version=4.0.0
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Marventa.Framework v4.0.0

Enterprise-grade .NET 9.0 framework for building scalable microservices with DDD, CQRS, and Event-Driven Architecture.

🎯 Version 4.0.0 - Major Release

Complete architectural redesign with single-package approach!

Breaking Changes

⚠️ Complete restructure from multi-project to single-project architecture
⚠️ All features now in one unified package: Marventa.Framework
⚠️ Namespace changes for better organization
⚠️ Requires .NET 9.0
⚠️ Migration required from v3.x

What's New

✨ Unified single-package architecture
✨ .NET 9.0 support with latest features
✨ Simplified dependency management
✨ Enhanced performance and efficiency
✨ Complete CQRS, Event-Driven, and DDD implementation
✨ Enterprise-ready patterns out of the box

🚀 Features

Core Patterns

✅ Domain-Driven Design (DDD) - Entity, AggregateRoot, ValueObject, DomainEvent
✅ CQRS Pattern - Command/Query separation with MediatR
✅ Repository & Unit of Work - Generic repository with EF Core support
✅ Result Pattern - Type-safe error handling

Event-Driven Architecture

✅ Event Bus - RabbitMQ and MassTransit support
✅ Domain Events - In-process event handling
✅ Integration Events - Cross-service communication
✅ Kafka Support - High-throughput event streaming

Caching

✅ In-Memory Cache - Fast local caching
✅ Distributed Cache (Redis) - Scalable caching
✅ Hybrid Cache - Multi-level caching strategy

Security

✅ JWT Authentication - Token-based authentication
✅ Permission-based Authorization - Fine-grained access control
✅ Password Hashing - BCrypt integration
✅ AES Encryption - Data encryption utilities
✅ Rate Limiting - API throttling

Infrastructure

✅ Entity Framework Core - SQL Server, PostgreSQL support
✅ MongoDB - NoSQL database support
✅ Elasticsearch - Full-text search
✅ Azure Blob Storage - Cloud file storage
✅ AWS S3 - Cloud file storage

Resilience

✅ Retry Policy - Automatic retry with exponential backoff
✅ Circuit Breaker - Fault tolerance
✅ Timeout Policy - Request timeouts

Observability

✅ Structured Logging - Serilog with Elasticsearch
✅ Health Checks - Database, Redis, RabbitMQ
✅ OpenTelemetry - Distributed tracing

API Features

✅ Standardized API Responses - Consistent response format
✅ Global Exception Handling - Centralized error handling
✅ FluentValidation - Request validation
✅ Swagger/OpenAPI - API documentation
✅ API Versioning - Version management

Multi-Tenancy

✅ Tenant Context - Tenant isolation
✅ Tenant Resolver - Header/Claim-based resolution
✅ Tenant Middleware - Automatic tenant detection

📦 Installation

dotnet add package Marventa.Framework

🔧 Quick Start

1. Basic Setup

using Marventa.Framework.Extensions;

var builder = WebApplication.CreateBuilder(args);

// Add Marventa Framework services
builder.Services.AddMarventaFramework(builder.Configuration);
builder.Services.AddMarventaMediatR(typeof(Program).Assembly);
builder.Services.AddMarventaValidation(typeof(Program).Assembly);

var app = builder.Build();

// Use Marventa middleware
app.UseMarventaFramework(app.Environment);

app.MapControllers();
app.Run();

2. Authentication & Authorization

// Add JWT authentication
builder.Services.AddMarventaJwtAuthentication(builder.Configuration);

// appsettings.json
{
  "Jwt": {
    "Secret": "your-super-secret-key-min-32-characters",
    "Issuer": "YourApp",
    "Audience": "YourApp",
    "ExpirationMinutes": 60
  }
}

3. Caching

// In-Memory Cache
builder.Services.AddMarventaCaching(builder.Configuration, CacheType.InMemory);

// Redis Cache
builder.Services.AddMarventaCaching(builder.Configuration, CacheType.Redis);

// Hybrid Cache (Memory + Redis)
builder.Services.AddMarventaCaching(builder.Configuration, CacheType.Hybrid);

// Usage
public class ProductService
{
    private readonly ICacheService _cache;

    public async Task<Product> GetProductAsync(string id)
    {
        var product = await _cache.GetAsync<Product>($"product:{id}");
        if (product == null)
        {
            product = await _repository.GetByIdAsync(id);
            await _cache.SetAsync($"product:{id}", product,
                CacheOptions.WithAbsoluteExpiration(TimeSpan.FromMinutes(30)));
        }
        return product;
    }
}

4. Event Bus (RabbitMQ)

// Configure RabbitMQ
builder.Services.AddMarventaRabbitMq(builder.Configuration);

// Define an integration event
public class OrderCreatedEvent : IntegrationEvent
{
    public Guid OrderId { get; set; }
    public decimal TotalAmount { get; set; }
}

// Publish event
public class OrderService
{
    private readonly IEventBus _eventBus;

    public async Task CreateOrderAsync(Order order)
    {
        // ... save order
        await _eventBus.PublishAsync(new OrderCreatedEvent
        {
            OrderId = order.Id,
            TotalAmount = order.Total
        });
    }
}

// Subscribe to event
public class OrderCreatedEventHandler : IIntegrationEventHandler<OrderCreatedEvent>
{
    public async Task HandleAsync(OrderCreatedEvent @event, CancellationToken cancellationToken)
    {
        // Handle event
        Console.WriteLine($"Order {@event.OrderId} created!");
    }
}

5. CQRS with MediatR

// Command
public record CreateProductCommand : ICommand<Guid>
{
    public string Name { get; init; } = string.Empty;
    public decimal Price { get; init; }
}

// Command Handler
public class CreateProductCommandHandler : IRequestHandler<CreateProductCommand, Result<Guid>>
{
    private readonly IRepository<Product, Guid> _repository;
    private readonly IUnitOfWork _unitOfWork;

    public async Task<Result<Guid>> Handle(CreateProductCommand request, CancellationToken cancellationToken)
    {
        var product = new Product { Name = request.Name, Price = request.Price };
        await _repository.AddAsync(product, cancellationToken);
        await _unitOfWork.SaveChangesAsync(cancellationToken);

        return Result.Success(product.Id);
    }
}

// Query
public record GetProductQuery : IQuery<Product>
{
    public Guid Id { get; init; }
}

// Query Handler
public class GetProductQueryHandler : IRequestHandler<GetProductQuery, Result<Product>>
{
    private readonly IRepository<Product, Guid> _repository;

    public async Task<Result<Product>> Handle(GetProductQuery request, CancellationToken cancellationToken)
    {
        var product = await _repository.GetByIdAsync(request.Id, cancellationToken);
        return product != null
            ? Result.Success(product)
            : Result.Failure<Product>("Product not found", "NOT_FOUND");
    }
}

6. Database Setup

// Configure DbContext
public class AppDbContext : BaseDbContext
{
    public AppDbContext(DbContextOptions<AppDbContext> options, IMediator mediator)
        : base(options, mediator) { }

    public DbSet<Product> Products => Set<Product>();
}

// Register in Program.cs
builder.Services.AddMarventaDbContext<AppDbContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));

// Register repositories
builder.Services.AddMarventaGenericRepository<Product, Guid>();

7. Entity Definition

public class Product : AuditableEntity<Guid>
{
    public string Name { get; set; } = string.Empty;
    public decimal Price { get; set; }
    public string Description { get; set; } = string.Empty;

    public Product()
    {
        Id = Guid.NewGuid();
    }
}

8. API Controller

[ApiController]
[Route("api/[controller]")]
public class ProductsController : ControllerBase
{
    private readonly IMediator _mediator;

    public ProductsController(IMediator mediator)
    {
        _mediator = mediator;
    }

    [HttpPost]
    public async Task<IActionResult> Create(CreateProductCommand command)
    {
        var result = await _mediator.Send(command);
        var response = ApiResponseFactory.FromResult(result);
        return result.IsSuccess ? Ok(response) : BadRequest(response);
    }

    [HttpGet("{id}")]
    public async Task<IActionResult> Get(Guid id)
    {
        var result = await _mediator.Send(new GetProductQuery { Id = id });
        var response = ApiResponseFactory.FromResult(result);
        return result.IsSuccess ? Ok(response) : NotFound(response);
    }
}

🔍 Advanced Features

Multi-Tenancy

// Configure
builder.Services.AddMarventaMultiTenancy();
app.UseMarventaMultiTenancy();

// Usage
public class ProductService
{
    private readonly ITenantContext _tenantContext;

    public async Task<List<Product>> GetProductsAsync()
    {
        var tenantId = _tenantContext.TenantId;
        // Filter by tenant
    }
}

Elasticsearch Integration

builder.Services.AddMarventaElasticsearch(builder.Configuration);

public class ProductSearchService
{
    private readonly IElasticsearchService _search;

    public async Task IndexProductAsync(Product product)
    {
        await _search.IndexDocumentAsync("products", product, product.Id.ToString());
    }

    public async Task<IEnumerable<Product>> SearchAsync(string query)
    {
        return await _search.SearchAsync<Product>("products", query);
    }
}

Health Checks

builder.Services.AddHealthChecks()
    .AddCheck<DatabaseHealthCheck>("database")
    .AddCheck<RedisHealthCheck>("redis")
    .AddCheck<RabbitMqHealthCheck>("rabbitmq");

app.MapHealthChecks("/health");

Resilience Policies

var retryPolicy = RetryPolicy.CreateRetryPolicy(3, logger);
var circuitBreaker = CircuitBreakerPolicy.CreateCircuitBreakerPolicy(5, 30, logger);
var timeout = TimeoutPolicy.CreateTimeoutPolicy(30, logger);

var result = await retryPolicy.WrapAsync(circuitBreaker).WrapAsync(timeout)
    .ExecuteAsync(async () => await _httpClient.GetAsync("https://api.example.com"));

📚 Configuration Examples

appsettings.json

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=localhost;Database=MyApp;User Id=sa;Password=***;"
  },
  "Jwt": {
    "Secret": "your-super-secret-key-min-32-characters",
    "Issuer": "MyApp",
    "Audience": "MyApp",
    "ExpirationMinutes": 60
  },
  "Redis": {
    "ConnectionString": "localhost:6379",
    "InstanceName": "MyApp:"
  },
  "RabbitMQ": {
    "Host": "localhost",
    "Username": "guest",
    "Password": "guest"
  },
  "Elasticsearch": {
    "Uri": "http://localhost:9200"
  }
}

🧪 Testing

dotnet test

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📧 Support

For issues and questions, please use GitHub Issues.

🌟 Show Your Support

Give a ⭐️ if this project helped you!

Product	Compatible and additional computed target framework versions.
.NET	net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed.

Product

.NET

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net9.0
- AspNetCore.HealthChecks.MongoDb (>= 9.0.0)
- AspNetCore.HealthChecks.RabbitMQ (>= 9.0.0)
- AspNetCore.HealthChecks.Redis (>= 9.0.0)
- AspNetCore.HealthChecks.SqlServer (>= 9.0.0)
- AspNetCore.HealthChecks.UI.Client (>= 9.0.0)
- AWSSDK.S3 (>= 4.0.7.6)
- Azure.Storage.Blobs (>= 12.25.1)
- BCrypt.Net-Next (>= 4.0.3)
- Confluent.Kafka (>= 2.11.1)
- Elasticsearch.Net (>= 7.17.5)
- FluentValidation (>= 12.0.0)
- FluentValidation.AspNetCore (>= 11.3.1)
- FluentValidation.DependencyInjectionExtensions (>= 12.0.0)
- Hangfire.AspNetCore (>= 1.8.21)
- Hangfire.Core (>= 1.8.21)
- Hangfire.SqlServer (>= 1.8.21)
- Mapster (>= 7.4.0)
- Mapster.DependencyInjection (>= 1.0.1)
- MassTransit (>= 8.5.3)
- MassTransit.RabbitMQ (>= 8.5.3)
- MediatR (>= 13.0.0)
- Microsoft.AspNetCore.Authentication.JwtBearer (>= 9.0.9)
- Microsoft.AspNetCore.Mvc.Versioning (>= 5.1.0)
- Microsoft.AspNetCore.Mvc.Versioning.ApiExplorer (>= 5.1.0)
- Microsoft.EntityFrameworkCore (>= 9.0.9)
- Microsoft.EntityFrameworkCore.Relational (>= 9.0.9)
- Microsoft.EntityFrameworkCore.SqlServer (>= 9.0.9)
- Microsoft.Extensions.Caching.Memory (>= 9.0.9)
- Microsoft.Extensions.Caching.StackExchangeRedis (>= 9.0.9)
- MongoDB.Driver (>= 3.5.0)
- NEST (>= 7.17.5)
- Newtonsoft.Json (>= 13.0.4)
- Npgsql.EntityFrameworkCore.PostgreSQL (>= 9.0.4)
- OpenTelemetry (>= 1.12.0)
- OpenTelemetry.Exporter.Jaeger (>= 1.5.1)
- OpenTelemetry.Instrumentation.AspNetCore (>= 1.12.0)
- OpenTelemetry.Instrumentation.Http (>= 1.12.0)
- Polly (>= 8.6.4)
- Polly.Extensions.Http (>= 3.0.0)
- RabbitMQ.Client (>= 7.1.2)
- Serilog (>= 4.3.0)
- Serilog.AspNetCore (>= 9.0.0)
- Serilog.Enrichers.Environment (>= 3.0.1)
- Serilog.Enrichers.Thread (>= 4.0.0)
- Serilog.Sinks.Console (>= 6.0.0)
- Serilog.Sinks.Elasticsearch (>= 10.0.0)
- StackExchange.Redis (>= 2.9.25)
- Swashbuckle.AspNetCore (>= 9.0.5)
- System.IdentityModel.Tokens.Jwt (>= 8.14.0)
- System.Text.Json (>= 9.0.9)

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last Updated
5.2.0	268	10/13/2025
5.1.0	293	10/5/2025
5.0.0	206	10/4/2025
4.6.0	213	10/3/2025
4.5.5	236	10/2/2025
4.5.4	232	10/2/2025
4.5.3	225	10/2/2025
4.5.2	226	10/2/2025
4.5.1	230	10/2/2025
4.5.0	230	10/2/2025
4.4.0	237	10/1/2025
4.3.0	235	10/1/2025
4.2.0	234	10/1/2025
4.1.0	224	10/1/2025
4.0.2	236	10/1/2025
4.0.1	227	10/1/2025
4.0.0	302	9/30/2025
3.5.2	234	9/30/2025
3.5.1	268	9/30/2025
3.4.1	273	9/30/2025
3.4.0	266	9/30/2025
3.3.2	275	9/30/2025
3.2.0	271	9/30/2025
3.1.0	266	9/29/2025
3.0.1	271	9/29/2025
3.0.1-preview-20250929165802	257	9/29/2025
3.0.0	265	9/29/2025
3.0.0-preview-20250929164242	265	9/29/2025
3.0.0-preview-20250929162455	261	9/29/2025
2.12.0-preview-20250929161039	254	9/29/2025
2.11.0	273	9/29/2025
2.10.0	268	9/29/2025
2.9.0	261	9/29/2025
2.8.0	262	9/29/2025
2.7.0	276	9/29/2025
2.6.0	268	9/28/2025
2.5.0	277	9/28/2025
2.4.0	267	9/28/2025
2.3.0	267	9/28/2025
2.2.0	281	9/28/2025
2.1.0	269	9/26/2025
2.0.9	273	9/26/2025
2.0.5	268	9/25/2025
2.0.4	271	9/25/2025
2.0.3	276	9/25/2025
2.0.1	277	9/25/2025
2.0.0	273	9/25/2025
1.1.2	353	9/24/2025
1.1.1	354	9/24/2025
1.1.0	271	9/24/2025
1.0.0	273	9/24/2025

Marventa.Framework 4.0.0

Marventa.Framework v4.0.0

🎯 Version 4.0.0 - Major Release

Breaking Changes

What's New

🚀 Features

Core Patterns

Event-Driven Architecture

Caching

Security

Infrastructure

Resilience

Observability

API Features

Multi-Tenancy

📦 Installation

🔧 Quick Start

1. Basic Setup

2. Authentication & Authorization

3. Caching

4. Event Bus (RabbitMQ)

5. CQRS with MediatR

6. Database Setup

7. Entity Definition

8. API Controller

🔍 Advanced Features

Multi-Tenancy

Elasticsearch Integration

Health Checks

Resilience Policies

📚 Configuration Examples

appsettings.json

🧪 Testing

📄 License

🤝 Contributing

📧 Support

🌟 Show Your Support

net9.0

NuGet packages

GitHub repositories