Transitio.Mediator 1.1.0

Transitio

Transitio is a lightweight, high-performance object mapping framework for .NET with support for profiles, nested mapping, dependency injection, object validation and an in-process mediator.

📦 Installation

dotnet add package Transitio.Mapper
# optional: Microsoft.Extensions.DependencyInjection integration
dotnet add package Transitio.Dependency
# optional: standalone object validation
dotnet add package Transitio.Validation
# optional: standalone in-process mediator
dotnet add package Transitio.Mediator

🚀 Quick start

using Transitio.Mapper;

public class User { public string Name { get; set; } = ""; public int Age { get; set; } }
public class UserDto { public string Name { get; set; } = ""; public int Age { get; set; } }

var config = new TransitioMapperConfiguration(cfg =>
{
    cfg.CreateMap<User, UserDto>();
});

IMapper mapper = config.BuildMapper();

var dto = mapper.Map<UserDto>(new User { Name = "Hitesh", Age = 30 });
// dto.Name == "Hitesh", dto.Age == 30

Using dependency injection? Register with services.AddTransitio(...) and inject IMapper.
See the Getting Started guide.

✨ Features

• ⚡ Expression-based high-performance mapping
• 🧩 Profiles for modular configuration
• 🔗 Nested object mapping (including nested collection properties)
• 📦 Collection mapping (List → List, IEnumerable → array, IEnumerable → interface)
• 🧵 Thread-safe: a single mapper instance can be shared as a singleton
• 🔧 Custom member mapping,
  Ignore,
  Conditional mapping,
  and Reverse mapping
• 🔁 Full object transformation with ConvertUsing(...) (type / instance / delegate)
  and context-aware mapping via IMappingContext
• 🧬 Inheritance & reuse with Include / IncludeBase
• 🧪 Null-value handling
  and configuration validation
• 📦 Dependency injection: assembly scanning, configurable lifetimes
  (scoped converters), fail-fast validation, and keyed mappers
• ✅ Object validation with the standalone Transitio.Validation package (fluent rules, ValidationResult, DI registration)
• 📨 Mediator with the standalone Transitio.Mediator package (request/response, notifications, pipeline behaviors, DI registration)
• 🎯 Supports .NET 8 & .NET 10

📚 Documentation

• Getting Started – install, first map, mapping rules
• Core Mapping Features – ForMember, Ignore, Condition, ReverseMap, nested & collection mapping, null handling, validation
• Full Object Transformation – ConvertUsing (type / instance / delegate) and IMappingContext
• Inheritance & Reusability – Include / IncludeBase
• Dependency Injection – AddTransitio, assembly scanning, lifetimes, validation, keyed mappers
• Object Validation - AbstractValidator<T>, RuleFor, built-in rules, AddTransitioValidation
• Mediator - IRequest/IRequestHandler, INotification/INotificationHandler, IPipelineBehavior, AddTransitioMediator A runnable end-to-end demo lives in samples/BasicSample.

See the Changelog for release history.

👤 Maintainers

Maintained by the Transitio

• GitHub: https://github.com/Transitio/Transitio

📄 License

This project is licensed under the MIT License