Transactional Inbox Wiring

Header

• ID: analyzers.transactional-inbox-dbcontext
• Diagnostic: LB1016 (Warning)
• Maturity: GA
• Summary: Reports public constructors that inject ITransactionalInboxStore without also injecting a DbContext in the same constructor signature.

Trigger Conditions

LB1016 reports when:

• Named type has a public constructor.
• Constructor has a parameter implementing or equal to ITransactionalInboxStore.
• Constructor has no parameter type that inherits from DbContext.

Bad Example

using LiteBus.Inbox.Abstractions;

public sealed class OrderService
{
    public OrderService(ITransactionalInboxStore inbox)
    {
    }
}

Expected diagnostic:

• LB1016 on constructor declaration.

Good Example

using LiteBus.Inbox.Abstractions;
using Microsoft.EntityFrameworkCore;

public sealed class AppDbContext : DbContext
{
}

public sealed class OrderService
{
    public OrderService(ITransactionalInboxStore inbox, AppDbContext dbContext)
    {
    }
}

Suppression Guidance

• Keep transactional inbox operations inside an active EF unit-of-work boundary.
• Suppress only when transactional inbox is wrapped by another service that already guarantees scope and the constructor is a false positive.
• Document the unit-of-work boundary next to suppression.

Test Coverage

Source: tests/LiteBus.Analyzers.UnitTests/TransactionalInboxWithoutDbContextAnalyzerTests.cs

Untested in this suite:

• Positive path where constructor includes DbContext.
• Multiple constructor combinations with one valid transactional signature.