RCommon.Core 2.3.2-alpha.0.1

RCommon.Core

The foundation package for the RCommon framework, providing the fluent builder for dependency injection configuration, an in-memory event bus with transactional event routing, guard clauses, GUID generation, system time abstraction, and a rich set of extension methods.

Features

• Fluent AddRCommon() builder pattern for configuring framework services via Microsoft DI
• In-memory event bus (IEventBus) with publish/subscribe support and polymorphic event dispatch
• Transactional event routing (IEventRouter) that stores events and dispatches them to the correct IEventProducer instances based on subscription configuration
• EventSubscriptionManager for isolating event subscriptions so each producer only receives its registered events
• Guard class with validation methods for nulls, empty strings, ranges, types, collections, email, and more
• Sequential and simple GUID generators (IGuidGenerator) optimized for database-friendly ordering
• ISystemTime abstraction for testable, time zone-aware date/time handling
• ICommonFactory<T> for DI-aware factory pattern with customization support
• Extension methods for collections, strings, expressions, streams, dictionaries, reflection, and IQueryable
• Reflection utilities including ObjectGraphWalker for traversing object graphs and ReflectionHelper for generic type inspection and compiled method invocation

Installation

dotnet add package RCommon.Core

Usage

using RCommon;
using RCommon.EventHandling;

// Bootstrap RCommon in your DI configuration
services.AddRCommon(builder =>
{
    builder
        .WithSequentialGuidGenerator(options =>
            options.DefaultSequentialGuidType = SequentialGuidType.SequentialAsString)
        .WithDateTimeSystem(options =>
            options.Kind = DateTimeKind.Utc)
        .WithEventHandling<InMemoryEventBusBuilder>(eventHandling =>
        {
            eventHandling.AddSubscriber<OrderCreatedEvent, OrderCreatedEventHandler>();
        });
});

Key Types

Documentation

For full documentation, visit rcommon.com.

Related Packages

• RCommon.Models - Shared models for CQRS commands, queries, events, pagination, and execution results
• RCommon.Entities - Domain entity base classes with auditing, soft delete, and transactional event tracking

License

Licensed under the Apache License, Version 2.0.