Franz.Common.Http.Messaging 3.0.0

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

Franz.Common.Http.Messaging

ASP.NET Core MVC integration for Kafka or RabbitMQ messaging transaction coordination and health checks.

Overview

ASP.NET Core MVC integration for Kafka or RabbitMQ messaging transaction coordination and health checks.

Installation

dotnet add package Franz.Common.Http.Messaging

RabbitMQ integration

The RabbitMQ extension is in Franz.Common.Http.Messaging.Extensions.

using Franz.Common.Http.Messaging.Extensions;

builder.Services.AddMessagingInHttpContext(builder.Configuration);

This composes RabbitMQ publisher, sender, and consumer registration through Franz.Common.Messaging.RabbitMQ, registers MessagingTransactionFilter, and adds the RabbitMQ connection health check. The filter is an MVC async action filter: after the action executes, it calls IMessagingTransaction.CompleteAsync() when no exception is present, or RollbackAsync() when an exception is present.

The filter coordinates an existing messaging transaction; it does not itself create a broker transaction or guarantee atomicity between an HTTP database transaction and a broker operation.

Kafka integration

Kafka has a separate extension class and entry point:

using Franz.Common.Http.Messaging;

builder.Services.AddKafkaMessagingInHttpContext(builder.Configuration);

This delegates producer/consumer setup to AddKafkaMessaging(configuration), registers the same MVC transaction filter, and adds a Kafka health check tagged messaging. The current health-check registration creates a default ConsumerConfig; supply and validate the actual broker configuration through the messaging package and test the health check against the target deployment.

Kafka and RabbitMQ registration are separate explicit calls. This package does not currently expose a single configuration-driven provider switch.

Manual registration

The package exposes separate methods for registering the messaging transaction filter and health checks. Use them only when composing those pieces manually; avoid duplicate registrations when the top-level extension has already been called.

Operational considerations

  • Treat health checks as diagnostics, not proof that publish/consume workflows are correct.
  • Configure broker credentials and TLS in the owning messaging package.
  • Define retry, dead-letter, idempotency, and delivery semantics in the broker-specific messaging layer.
  • Keep the HTTP request's success/failure semantics explicit. A filter completion callback is not a distributed transaction across arbitrary resources.

License

MIT. See LICENSE.

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

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
3.0.0 61 11/10/2026
2.3.4 336 11/1/2026
2.3.3 93 10/28/2026
2.3.2 104 10/27/2026
2.3.1 98 10/26/2026
2.3.0 150 7/21/2026
2.2.19 127 7/19/2026
2.2.18 122 7/19/2026
2.2.17 132 7/12/2026
2.2.16 134 7/2/2026
2.2.15 122 6/29/2026
2.2.14 131 6/29/2026
2.2.13 133 6/29/2026
2.2.12 121 6/28/2026
2.2.11 123 6/28/2026
2.2.10 130 6/28/2026
2.2.9 123 6/28/2026
2.2.8 125 6/28/2026
2.2.7 130 6/7/2026
2.2.6 135 6/6/2026
Loading failed