HelixBus.MessageBus.Abstractions

Core abstractions for the HelixBus MessageBus system.
Provides minimal interfaces for requests, handlers, notifications, and pipeline behaviors to enable a clean CQRS/mediator architecture.

---

🚀 Features

• IRequest<TResponse> / IRequestHandler<TRequest,TResponse> for query/command handling
• INotification / INotificationHandler<TNotification> for events
• Pipeline behavior interface: IPipelineBehavior<TRequest,TResponse>
• Minimal, dependency-free abstractions
• Fully compatible with source generators for compile-time mapping

---

📦 Installation

dotnet add package HelixBus.MessageBus.Abstractions

---

🛠 Usage Example

Define a Request

public record GetUserQuery(int Id) : IRequest<UserDto>;

Define a Handler

public class GetUserQueryHandler : IRequestHandler<GetUserQuery, UserDto> { public Task<UserDto> Handle(GetUserQuery request, CancellationToken cancellationToken) { return Task.FromResult(new UserDto(request.Id, "John Doe")); } }

Define a Notification

public class UserCreated : INotification { public int UserId { get; init; } } public class UserCreatedHandler : INotificationHandler<UserCreated> { public Task Handle(UserCreated notification, CancellationToken cancellationToken) { Console.WriteLine($"User created: {notification.UserId}"); return Task.CompletedTask; } }

---

💡 Best Practices

• Keep abstractions clean, free of implementation logic
• Use source generators or DI registration for handlers
• Use behaviors for cross-cutting concerns
• Structure your projects by domain for Clean Architecture

---

📄 License

MIT License. See LICENSE file.