3.0.1

Features

• [Host.AzureServiceBus] Modify user properties on failure / Supply reason and description on dead-letter #365 by @EtherZa

3.0.0

Summary of changes:

• OnHandle method in IConumer<T> and IRequestHandler<T, R> interfaces now accept CancellationToken parameter.

• [Host.Serialization] Introduced a new optional interface IMessageSerializer<TPayload> for JSON serializers to work efficiently with non-binary payload transports (Amazon SQS/SNS client uses text payloads).

  • [Host.Serialization.Json] and [Host.Serialization.SystemTextJson] have been updated to also serialize into a string (in addition to byte arrays).

• [Host.Configuration] Configuration improvements to make it easy to pass typed transport-specific settings via builders.

• [Host.Outbox] Improvements

  • Renamed the plugin SlimMessageBus.Host.Outbox.DbContext to SlimMessageBus.Host.Outbox.Sql.DbContext to emphasize it builds on top of the SlimMessageBus.Host.Outbox.Sql plugin (MS SQL)
  • Extended with other Guid generation strategies (on server side, client side, and sequential Guids).
  • Performance improvements to SlimMessageBus.Host.Outbox.Sql.

• [Host] Improvements

  • IConsumerErrorHandler pipeline improvements:
    • Ability to enable message scope re-creation with every message handling retry
    • Ability to abandon message (and fail fast in case of a non-transient issue to bypass transport level retries).
  • Batch Publish feature #338
  • Master bus improvements and refactoring:
    • Moved the IPendingRequestStore to be shared across master messages bus instances (request-response).
    • Moved Response Message handling purely to the ResponseMessageProcessor.
    • Refactored bus async initialization before the first message is produced or consumed.

• [Host.AzureServiceBus] Added Correlation filters support

• New Plugin: SlimMessageBus.Host.CircuitBreaker.HealthCheck plugin for Consumer Circuit Breaker based on health checks

• New Plugin: SlimMessageBus.Host.AmazonSQS transport plugin for Azmazon SQS.

• High-performance logging

• Updated libraries to the latest versions

• NET9: Include in multi-target, and upgrade tests and samples to NET9.

Migration Guide

01 Ensure all SMB packages are in major 3 version

Packages between v3 and v2 will not be compatible.
Ensure you reference packages from the major 3 version (3.0.0).

02 OnHandle has a CancellationToken parameter

The core interfaces IConsumer<T> and IRequestHandler<T, R> have the CancellationToken parameter added.

Update the consumer implementations to include that parameter, for example:

public class MyConsumer : IConsmer<MyMessage>
{
    // Before in SMB 2.x
    // public Task OnHandle(MyMessage message) {  }
    
    // Since SMB 3.x
    public Task OnHandle(MyMessage message, CancellationToken cancellationToken) {  }
}

03 SlimMessageBus.Host.Outbox.DbContext

The package SlimMessageBus.Host.Outbox.DbContext became SlimMessageBus.Host.Outbox.Sql.DbContext.
Please update the references in your projects. The configuration API should largely stay the same.

04 The IConsumerErrorHandler has a different signature

Consult the docs around error handling.

All the changes (PRs):

• #246
• #315
• #338
• #345
• #350
• #354
• #357 & #359
• #353
• #361
• #363
• #318

The main PR for v3 merge into master is: #320 (all the v3 changes).

Credits

Thanks to @EtherZa for all his contributions towards v3 milestone!

2.7.0

Features

• [Host.RabbitMq] Improve consumer concurrency #352

2.6.1

Features:

• [Host.AzureServiceBus] Pass ServiceProvider as arg to client factory #344 by @EtherZa

2.6.0

Features

• [Host.Kafka] Support for High-Throughput Publishing to Kafka #332
• Update libs #330
• [DevOps] Ensure build and integration tests can run in parallel #321
• Sonar tweaks #317
• Fix sonar warnings #307 by @dundich

Fixes

• [Host.Kafka] Fix lag of the last message in partition #131 #327

2.5.3

Enhancements:

• Upgrade libs #308
• Update ReflectionUtils.cs #304 by @dundich
• [Host.Kafka] Clarify Kafka docs & transport-specific error handler interface #300
• [DevOps] Improve how test results are collected and presented #306

Fixes:

• [Host.Kafka] Fix and improve commit logic #301

2.5.2

Fixes:

• [Host.Outbox] Execute permission is required for Outbox #297

2.5.1

Features:

• [Host.Memory] Ability to use headers in Memory provider without enabling message serialization #296

2.5.0

Features

• [Host.Outbox] Ability to filter UseSqlTransaction and UseOutbox by message type #291
• [Host.AspNetCore] Replacement for Microsoft.AspNetCore.Http.Abstractions #292
• [Host] Introduce IMessageScopeAccessor to wrap the MessageScope #293. See docs.

2.4.3

Features:

• [Host.Nats] Transport for Nats.io #287 by @dblanchetatlectra

Fixes:

• [Host.Outbox.Sql] Abort publishing of unknown message types #285 by @EtherZa