feat: add support for HostedService in DependencyRegistration

Author: davidkallesen

CLAUDE.md

@@ -106,12 +106,16 @@ Both generators follow the **Incremental Generator** pattern (IIncrementalGenera
 - Generates `AddDependencyRegistrationsFrom{SmartSuffix}()` extension methods with 4 overloads
 - **Smart naming** - uses short suffix if unique, full name if conflicts exist
 - **Transitive dependency registration** - automatically registers services from referenced assemblies
+- **Hosted service detection** - automatically uses `AddHostedService<T>()` for `BackgroundService` or `IHostedService` implementations
 - Default lifetime: Singleton (can specify Scoped or Transient)
 
 **Generated Code Pattern:**
 ```csharp
 // Input: [Registration] public class UserService : IUserService { }
 // Output: services.AddSingleton<IUserService, UserService>();
+
+// Hosted Service Input: [Registration] public class MaintenanceService : BackgroundService { }
+// Hosted Service Output: services.AddHostedService<MaintenanceService>();
 ```
 
 **Smart Naming:**
@@ -149,6 +153,7 @@ services.AddDependencyRegistrationsFromDomain("DataAccess", "Infrastructure");
 - `ATCDIR001` - Service 'As' type must be an interface (Error)
 - `ATCDIR002` - Class does not implement specified interface (Error)
 - `ATCDIR003` - Duplicate registration with different lifetimes (Warning)
+- `ATCDIR004` - Hosted services must use Singleton lifetime (Error)
 
 ### OptionsBindingGenerator
 
@@ -374,7 +379,8 @@ The `PetStore.Api` sample demonstrates all four generators working together in a
 ┌─────────────────────────────────────────────────────────────┐
 │ PetStore.Domain                                             │
 │ - [Registration] PetService, ValidationService              │
-│ - [OptionsBinding] PetStoreOptions                          │
+│ - [Registration] PetMaintenanceService (BackgroundService)  │
+│ - [OptionsBinding] PetStoreOptions, PetMaintenanceOptions   │
 │ - [MapTo] Pet → PetDto, Pet → PetEntity                    │
 │ - GenerateDocumentationFile=false                           │
 └─────────────────────────────────────────────────────────────┘
@@ -437,7 +443,8 @@ Return PetDto to client
 
 ### Key Features Demonstrated
 
-- **Zero boilerplate DI registration**: All services auto-registered
+- **Zero boilerplate DI registration**: All services auto-registered, including hosted services
+- **Background service support**: `PetMaintenanceService` automatically registered with `AddHostedService<T>()`
 - **Type-safe configuration**: Options validated and bound automatically
 - **Automatic mapping chains**: Entity ↔ Domain ↔ DTO conversions
 - **OpenAPI integration**: Full API documentation with Scalar UI

README.md

@@ -93,6 +93,7 @@ builder.Services.AddDependencyRegistrationsFromDataAccess();
 - **🎯 Auto-Detection**: Automatically registers against all implemented interfaces - no more `As = typeof(IService)`
 - **🧹 Smart Filtering**: System interfaces (IDisposable, etc.) are excluded automatically
 - **🔍 Multi-Interface**: Implementing multiple interfaces? Registers against all of them
+- **🏃 Hosted Service Support**: Automatically detects BackgroundService and IHostedService implementations and uses AddHostedService<T>()
 - **✨ Smart Naming**: Generates clean method names using suffixes when unique, full names when conflicts exist
 - **⚡ Zero Runtime Cost**: All code generated at compile time
 - **🚀 Native AOT Compatible**: No reflection or runtime code generation - fully trimming-safe
@@ -139,6 +140,7 @@ Get errors at compile time, not runtime:
 | ATCDIR001 | `As` parameter must be an interface type |
 | ATCDIR002 | Class must implement the specified interface |
 | ATCDIR003 | Duplicate registration with different lifetimes |
+| ATCDIR004 | Hosted services must use Singleton lifetime |
 
 ---
 

docs/generators/DependencyRegistration.md

@@ -42,6 +42,7 @@ Automatically register services in the dependency injection container using attr
   - [❌ ATCDIR001: As Type Must Be Interface](#-ATCDIR001-as-type-must-be-interface)
   - [❌ ATCDIR002: Class Does Not Implement Interface](#-ATCDIR002-class-does-not-implement-interface)
   - [⚠️ ATCDIR003: Duplicate Registration with Different Lifetime](#️-ATCDIR003-duplicate-registration-with-different-lifetime)
+  - [❌ ATCDIR004: Hosted Services Must Use Singleton Lifetime](#-ATCDIR004-hosted-services-must-use-singleton-lifetime)
 - [📚 Additional Examples](#-additional-examples)
 
 ---
@@ -605,13 +606,14 @@ builder.Services.AddDependencyRegistrationsFromApi();
 ## ✨ Features
 
 - **Automatic Service Registration**: Decorate classes with `[Registration]` attribute for automatic DI registration
+- **Hosted Service Support**: Automatically detects `BackgroundService` and `IHostedService` implementations and uses `AddHostedService<T>()`
 - **Interface Auto-Detection**: Automatically registers against all implemented interfaces (no `As` parameter needed!)
 - **Smart Filtering**: System interfaces (IDisposable, etc.) are automatically excluded
 - **Multiple Interface Support**: Services implementing multiple interfaces are registered against all of them
 - **Flexible Lifetimes**: Support for Singleton, Scoped, and Transient service lifetimes
 - **Explicit Override**: Optional `As` parameter to override auto-detection when needed
 - **Dual Registration**: Register services as both interface and concrete type with `AsSelf`
-- **Compile-time Validation**: Diagnostics for common errors (invalid interface types, missing implementations)
+- **Compile-time Validation**: Diagnostics for common errors (invalid interface types, missing implementations, incorrect hosted service lifetimes)
 - **Zero Runtime Overhead**: All code is generated at compile time
 - **Native AOT Compatible**: No reflection or runtime code generation - fully trimming-safe and AOT-ready
 - **Multi-Project Support**: Each project generates its own registration method
@@ -1102,6 +1104,41 @@ public class UserServiceScoped : IUserService { }
 
 **Fix:** Ensure consistent lifetimes or use different interfaces.
 
+### ❌ ATCDIR004: Hosted Services Must Use Singleton Lifetime
+
+**Severity:** Error
+
+**Description:** Hosted services (BackgroundService or IHostedService implementations) must use Singleton lifetime.
+
+```csharp
+// ❌ Error: Hosted services cannot use Scoped or Transient lifetime
+[Registration(Lifetime.Scoped)]
+public class MyBackgroundService : BackgroundService
+{
+    protected override Task ExecuteAsync(CancellationToken stoppingToken)
+    {
+        return Task.CompletedTask;
+    }
+}
+```
+
+**Fix:** Use Singleton lifetime (or default [Registration]) for hosted services:
+
+```csharp
+// ✅ Correct: Singleton lifetime (explicit)
+[Registration(Lifetime.Singleton)]
+public class MyBackgroundService : BackgroundService { }
+
+// ✅ Correct: Default lifetime is Singleton
+[Registration]
+public class MyBackgroundService : BackgroundService { }
+```
+
+**Generated Registration:**
+```csharp
+services.AddHostedService<MyBackgroundService>();
+```
+
 ---
 
 ## 📚 Additional Examples

docs/samples/PetStoreApi.md

@@ -37,7 +37,9 @@ graph TB
     subgraph "PetStore.Domain"
         PS["PetService - @Registration"]
         VS["ValidationService - @Registration"]
+        BG["PetMaintenanceService - @Registration (BackgroundService)"]
         OPT["PetStoreOptions - @OptionsBinding"]
+        OPT2["PetMaintenanceServiceOptions - @OptionsBinding"]
         PET["Pet - @MapTo(PetResponse)"]
         PET2["Pet - @MapTo(PetEntity, Bidirectional=true)"]
         DOMENUM["PetStatus (Domain)"]
@@ -86,8 +88,10 @@ graph TB
 
     style PS fill:#0969da
     style VS fill:#0969da
+    style BG fill:#0969da
     style PR fill:#0969da
     style OPT fill:#0969da
+    style OPT2 fill:#0969da
     style DI1 fill:#2ea44f
     style DI2 fill:#2ea44f
     style DI3 fill:#2ea44f
@@ -566,11 +570,12 @@ app.Run();
 
 ### DependencyRegistration Generator
 
-Creates 2 extension methods with transitive registration:
+Creates extension methods with transitive registration:
 
 ```csharp
 // From PetStore.Domain (with includeReferencedAssemblies: true)
 services.AddSingleton<IPetService, PetService>();
+services.AddHostedService<PetMaintenanceService>();  // ✨ Automatic BackgroundService registration
 services.AddSingleton<IPetRepository, PetRepository>();  // From referenced PetStore.DataAccess
 ```
 
@@ -584,6 +589,11 @@ services.AddOptions<PetStoreOptions>()
     .Bind(configuration.GetSection("PetStore"))
     .ValidateDataAnnotations()
     .ValidateOnStart();
+
+services.AddOptions<PetMaintenanceServiceOptions>()
+    .Bind(configuration.GetSection("PetMaintenanceService"))
+    .ValidateDataAnnotations()
+    .ValidateOnStart();
 ```
 
 ### Mapping Generator
@@ -644,6 +654,7 @@ public static Pet MapToPet(this PetEntity source)
 ### 1. **Complete Integration**
 All three generators work seamlessly together:
 - Services auto-registered via `[Registration]`
+- Background services auto-registered with `AddHostedService<T>()` via `[Registration]`
 - Configuration auto-bound via `[OptionsBinding]`
 - Objects auto-mapped via `[MapTo]` with bidirectional support
 

sample/.editorconfig

@@ -54,8 +54,11 @@ dotnet_diagnostic.CA1062.severity = none            # In externally visible meth
 dotnet_diagnostic.CA1056.severity = none            #
 dotnet_diagnostic.CA1303.severity = none            #
 dotnet_diagnostic.SA1615.severity = none            # Element return value should be documented
+dotnet_diagnostic.CA1848.severity = none            # For improved performance
 dotnet_diagnostic.CA1819.severity = none            # Properties should not return arrays
 
 dotnet_diagnostic.SA1611.severity = none            # The documentation for parameter 'pet' is missing
 
-dotnet_diagnostic.S6580.severity = none             # Use a format provider when parsing date and time.
+dotnet_diagnostic.S6580.severity = none             # Use a format provider when parsing date and time.
+dotnet_diagnostic.S6667.severity = none             # Logging in a catch clause should pass the caught exception as a parameter.
+dotnet_diagnostic.S6672.severity = none             # Update this logger to use its enclosing type

sample/PetStore.Api.Contract/PetResponse.cs

@@ -39,4 +39,14 @@ public class PetResponse
     /// Gets or sets when the pet was added to the system.
     /// </summary>
     public DateTimeOffset CreatedAt { get; set; }
+
+    /// <summary>
+    /// Gets or sets when the pet was last modified.
+    /// </summary>
+    public DateTimeOffset? ModifiedAt { get; set; }
+
+    /// <summary>
+    /// Gets or sets who last modified the pet.
+    /// </summary>
+    public string? ModifiedBy { get; set; }
 }

sample/PetStore.Api/GlobalUsings.cs

@@ -5,5 +5,6 @@
 
 global using PetStore.Api.Contract;
 global using PetStore.Domain;
+global using PetStore.Domain.BackgroundServices;
 global using PetStore.Domain.Services;
 global using Scalar.AspNetCore;

sample/PetStore.Api/Program.cs

@@ -11,7 +11,7 @@
     includeReferencedAssemblies: true);
 
 // ✨ Register configuration options automatically via [OptionsBinding] attribute
-// This single call registers options from PetStore.Domain (PetStoreOptions)
+// This single call registers options from PetStore.Domain (PetStoreOptions + PetMaintenanceServiceOptions)
 builder.Services.AddOptionsFromDomain(
     builder.Configuration,
     includeReferencedAssemblies: true);

sample/PetStore.Api/appsettings.json

@@ -10,5 +10,8 @@
     "MaxPetsPerPage": 20,
     "StoreName": "Furry Friends Pet Store",
     "EnableAutoStatusUpdates": true
+  },
+  "PetMaintenanceService": {
+    "RepeatIntervalInSeconds": 10
   }
-}
+}

sample/PetStore.DataAccess/Entities/PetEntity.cs

@@ -39,4 +39,14 @@ public class PetEntity
     /// Gets or sets when the pet was added to the system.
     /// </summary>
     public DateTimeOffset CreatedAt { get; set; }
+
+    /// <summary>
+    /// Gets or sets when the pet was last modified.
+    /// </summary>
+    public DateTimeOffset? ModifiedAt { get; set; }
+
+    /// <summary>
+    /// Gets or sets who last modified the pet.
+    /// </summary>
+    public string? ModifiedBy { get; set; }
 }