Franz.Common.Messaging.AzureEventBus 3.0.0

dotnet add package Franz.Common.Messaging.AzureEventBus --version 3.0.0
                    
NuGet\Install-Package Franz.Common.Messaging.AzureEventBus -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.Messaging.AzureEventBus" 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.Messaging.AzureEventBus" Version="3.0.0" />
                    
Directory.Packages.props
<PackageReference Include="Franz.Common.Messaging.AzureEventBus" />
                    
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.Messaging.AzureEventBus --version 3.0.0
                    
#r "nuget: Franz.Common.Messaging.AzureEventBus, 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.Messaging.AzureEventBus@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.Messaging.AzureEventBus&version=3.0.0
                    
Install as a Cake Addin
#tool nuget:?package=Franz.Common.Messaging.AzureEventBus&version=3.0.0
                    
Install as a Cake Tool

Franz.Common.Messaging.AzureEventBus

Azure Service Bus producer and processor integration for Franz messages.

Overview

This package maps between Azure Service Bus messages and the Franz message envelope, registers an IMessagingSender, and hosts an Azure Service Bus processor that dispatches received messages through the Franz Mediator.

Installation

dotnet add package Franz.Common.Messaging.AzureEventBus

Registration

using Franz.Common.Messaging.AzureEventBus.DependencyInjection;

builder.Services.AddFranzAzureEventBus(options =>
{
    options.ConnectionString = builder.Configuration["AzureServiceBus:ConnectionString"]!;
    options.EntityName = "orders";
    options.MaxConcurrentCalls = 8;
    options.PrefetchCount = 0;
});

The extension validates the options, registers the Azure SDK client/sender factories, message mapper, producer, processor, consumer, and AzureEventBusHostedService.

The processor uses ConnectionString, EntityName, MaxConcurrentCalls, PrefetchCount, and MaxAutoLockRenewalDuration. The options model also declares session, retry, and dead-letter settings, but the current processor/client construction does not apply them; do not rely on those properties to configure session handling or handler-level retries.

Tenant-aware processing

The processor creates a DI scope for each message. When ITenantMessageContextInitializer is registered, it establishes validated tenant context and resolves IDispatcher from that message scope. Without the initializer, the current processor dispatches through the IDispatcher captured by its singleton instance rather than the scoped dispatcher from the message scope. Register the messaging multi-tenancy package, tenant store, and producer authorizer when messages carry tenant-owned work.

DI lifetime limitation

AddFranzAzureEventBus registers AzureEventBusProcessor as a singleton and constructs it with IDispatcher, which Franz Mediator registers as scoped. With DI scope validation enabled, resolving the processor fails because a singleton captures a scoped dependency; with validation disabled, the processor retains a root-scoped dispatcher. The per-message scope only corrects dispatch resolution when tenant initialization is present. Do not treat this processor registration as production-safe until the dispatcher is resolved from each message scope and the singleton dependency is removed.

Delivery behavior

The processor completes a message after successful dispatch. Mapping failures are dead-lettered unconditionally. Handler failures are logged and the message is abandoned for broker redelivery. MaxAutoLockRenewalDuration controls processor lock renewal; configure delivery limits and dead-letter policy on the Service Bus entity because the package's declared retry/dead-letter option objects are not currently applied.

License

MIT. See the repository 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 (1)

Showing the top 1 NuGet packages that depend on Franz.Common.Messaging.AzureEventBus:

Package Downloads
Franz.Common.Messaging.Hosting.Azure

Shared utility library for the Franz Framework.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
3.0.0 88 11/10/2026
2.3.4 352 11/1/2026
2.3.3 113 10/28/2026
2.3.2 113 10/27/2026
2.3.1 112 10/26/2026
2.3.0 173 7/21/2026
2.2.19 150 7/19/2026
2.2.18 140 7/19/2026
2.2.17 142 7/12/2026
2.2.16 141 7/2/2026
2.2.15 150 6/29/2026
2.2.14 143 6/29/2026
2.2.13 159 6/29/2026
2.2.12 147 6/28/2026
2.2.11 155 6/28/2026
2.2.10 146 6/28/2026
2.2.9 157 6/28/2026
2.2.8 143 6/28/2026
2.2.7 156 6/7/2026
2.2.6 146 6/6/2026
Loading failed