Skip to main content

Which package do I need?

By project role​

Project does...Install
Defines messages only (contracts / domain assembly)OpinionatedEventing.Abstractions
Handles messages in a service hostOpinionatedEventing + one transport
Publishes events or sends commandsOpinionatedEventing + OpinionatedEventing.Outbox + OpinionatedEventing.EntityFramework + one transport
Uses sagas (orchestration or choreography)Add OpinionatedEventing.Sagas
Tests handlers, sagas, aggregatesOpinionatedEventing.Testing (test projects only)
Local dev with AspireAspire AppHost package(s), see below
Tracing and metricsOpinionatedEventing.OpenTelemetry

Receive-only services do not need EF Core.

Package map​

PackageContains
OpinionatedEventing.AbstractionsIEvent, ICommand, IEventHandler<T>, ICommandHandler<T>, IPublisher, AggregateRoot, [MessageTopic], [MessageQueue]
OpinionatedEventingAddOpinionatedEventing, AddHandlersFromAssemblies, OpinionatedEventingOptions, IMessagingContext
OpinionatedEventing.OutboxAddOutbox, OutboxDispatcherWorker, OutboxCleanupWorker, IOutboxStore, IOutboxMonitor
OpinionatedEventing.EntityFrameworkAddOpinionatedEventingEntityFramework<TDbContext>, DomainEventInterceptor, ApplyOutboxConfiguration, ApplySagaStateConfiguration, migration helpers
OpinionatedEventing.SagasAddOpinionatedEventingSagas, AddSaga<T>, AddSagaParticipant<T>, SagaOrchestrator<TState>, ISagaParticipant<TEvent>, ISagaContext
OpinionatedEventing.AzureServiceBusAddAzureServiceBusTransport
OpinionatedEventing.RabbitMQAddRabbitMQTransport
OpinionatedEventing.OpenTelemetryAddOpinionatedEventingInstrumentation, AddOpinionatedEventingMetrics
OpinionatedEventing.AspireAddOpinionatedEventingHealthChecks
OpinionatedEventing.Aspire.AzureServiceBusAppHost AddAzureServiceBusEmulator
OpinionatedEventing.Aspire.RabbitMQAppHost AddRabbitMqMessaging
OpinionatedEventing.TestingInMemoryOutboxStore, InMemorySagaStateStore, FakeSagaContext, FakePublisher

Pick one transport per service.

note

Targets .NET 10 and 11. AddOpinionatedEventingHealthChecks comes from OpinionatedEventing.Aspire; the AppHost extensions (AddRabbitMqMessaging, AddAzureServiceBusEmulator) are documented under the same Aspire package in Local Development, while the homepage lists transport-specific OpinionatedEventing.Aspire.* packages. Check NuGet for the exact package IDs before adding references.