Why should you care?

ShopNest outbox relay and cache warmers need a process lifetime hook, not a one-off console.

See it live — copy this example

Paste into a C# console or class library project and run dotnet run.

public sealed class OutboxRelayService : BackgroundService
{
    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
    {
        while (!stoppingToken.IsCancellationRequested)
        {
            Console.WriteLine("relay tick");
            await Task.Delay(1000, stoppingToken);
        }
    }
}
// builder.Services.AddHostedService<OutboxRelayService>();

Run Example »

Edit the code below and click Run to see the result in Toolliyo’s live editor.

What happened?

• BackgroundService loops until cancellation.
• Respect stoppingToken.
• For multi-instance jobs, combine with leader election or queue competing consumers.

Practice next

1. Add a hosted service to ShopNest API.
2. Honor CancellationToken.
3. Scope DbContext per iteration carefully.
4. Process outbox batch each tick.
5. Add graceful delay on shutdown.

Remember

Background work in-host. Cancel cleanly. Mind multi-instance.

ShopNest outbox hosted service

API host runs relay loop.

Outcome: Events publish without a separate worker binary (small scale).