Microsoft Hosting Bridge

Header

• ID: hosting.microsoft-hosting-bridge
• Name: Microsoft hosting bridge
• Maturity: GA
• Summary: Maps manifest task/check descriptors to Microsoft DI registrations and one orchestrator IHostedService.

What It Does

The Microsoft hosting bridge has two extension points:

• RegisterDiagnosticChecks(...): registers each diagnostic check type as singleton.
• RegisterBackgroundServices(...): registers startup tasks, background services, BackgroundServiceHostedServiceIndex, and one orchestrator IHostedService.

It deduplicates implementation types while preserving first-seen order.

Public Surface

Registration

• IServiceCollection RegisterDiagnosticChecks(IReadOnlyList<DiagnosticCheckDescriptor>)
• IServiceCollection RegisterBackgroundServices(IReadOnlyList<Type> startupTasks, IReadOnlyList<Type> backgroundServices)
• IHostedService GetHostedServiceForBackgroundService<TBackgroundService>() (manual adapter lookup for tests)

Extension Points

• BackgroundServiceHostedServiceIndex provides lookup for hosted wrapper of one background type.

Packages

• LiteBus.Runtime.Extensions.Microsoft.Hosting

Requires

• hosting.host-manifest
• hosting.generic-host-orchestrator

Invariants

• No registration occurs when both startup and background lists are empty.
• Duplicate implementation types are skipped after first registration.
• One orchestrator hosted service is registered for all LiteBus loops.

Non-Goals

• Registering framework-agnostic probes outside DI.
• Hosting bridge for non-Microsoft DI containers.

Observability

No bridge-specific metrics. Operational behavior is reflected by hosted workloads and diagnostic endpoints.

Test Coverage

Covered Use Cases

MicrosoftBackgroundServiceHostingExtensionsTests.RegisterBackgroundServices_WhenImplementationTypeRepeated_ShouldRegisterSingleHostedService

• Use case: type deduplication in bridge registration
• Test kind: Unit
• Description: registers repeated background type
• Behavior: inspects service descriptors
• Expected outcome: one hosted service and one background implementation registration
• Remarks: tests/LiteBus.Runtime.UnitTests/MicrosoftBackgroundServiceHostingExtensionsTests.cs

MicrosoftBackgroundServiceHostingExtensionsTests.RegisterBackgroundServices_WhenServicesNull_ShouldThrow

• Use case: null guard for service collection
• Test kind: Unit
• Description: invokes extension with null services
• Behavior: registration call
• Expected outcome: argument null exception
• Remarks: tests/LiteBus.Runtime.UnitTests/MicrosoftBackgroundServiceHostingExtensionsTests.cs

MicrosoftBackgroundServiceHostingExtensionsTests.RegisterBackgroundServices_ShouldExecuteUnderlyingBackgroundService

• Use case: hosted bridge executes resolved LiteBus loop
• Test kind: Unit
• Description: builds provider with one background service through bridge
• Behavior: starts and stops hosted services
• Expected outcome: loop execute count increases
• Remarks: tests/LiteBus.Runtime.UnitTests/MicrosoftBackgroundServiceHostingExtensionsTests.cs

Untested Use Cases

Out-of-Scope Use Cases

• ASP.NET authorization and endpoint policies.

Deep Docs

• Hosted services