eShop.EventBus 1.0.0

dotnet add package eShop.EventBus --version 1.0.0
                    
NuGet\Install-Package eShop.EventBus -Version 1.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="eShop.EventBus" Version="1.0.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="eShop.EventBus" Version="1.0.0" />
                    
Directory.Packages.props
<PackageReference Include="eShop.EventBus" />
                    
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 eShop.EventBus --version 1.0.0
                    
#r "nuget: eShop.EventBus, 1.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 eShop.EventBus@1.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=eShop.EventBus&version=1.0.0
                    
Install as a Cake Addin
#tool nuget:?package=eShop.EventBus&version=1.0.0
                    
Install as a Cake Tool

eShop.EventBus

eShop.EventBus provides the event bus abstractions used by eShop services for integration events.

What it includes

  • IntegrationEvent base record with an automatically generated Id and CreationDate
  • IEventBus for publishing integration events
  • IIntegrationEventHandler<T> for handling typed integration events
  • IEventBusBuilder extension methods for registration and JSON configuration

Getting started

Create your integration event by inheriting from IntegrationEvent:

public sealed record OrderCreatedIntegrationEvent(Guid OrderId) : IntegrationEvent;

Create a handler for the event:

using eShop.EventBus.Abstractions;

public sealed class OrderCreatedIntegrationEventHandler
    : IIntegrationEventHandler<OrderCreatedIntegrationEvent>
{
    public Task Handle(OrderCreatedIntegrationEvent @event)
    {
        return Task.CompletedTask;
    }
}

Register the event and handler through the event bus builder:

builder
    .AddSubscription<OrderCreatedIntegrationEvent, OrderCreatedIntegrationEventHandler>()
    .ConfigureJsonOptions(options =>
    {
        options.PropertyNamingPolicy = System.Text.Json.JsonNamingPolicy.CamelCase;
    });

Notes

  • The package targets net10.0 and is marked AOT-compatible.
  • Event types are tracked by name for subscription lookup and serialization metadata.
Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on eShop.EventBus:

Package Downloads
eShop.EventBusRabbitMQ

RabbitMQ implementation of the eShop EventBus for event-driven microservices.

eShop.IntegrationEventLogEF

Library for persisting and tracking integration events using Entity Framework Core in eShop-based microservices.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.0 317 4/5/2026