Space.DependencyInjection 1.1.11

Space.DependencyInjection

Dependency Injection extensions + source generator bootstrap for the Space framework. Provides the AddSpace entry point that wires up all discovered handlers, pipelines, notifications and system modules without runtime reflection.

Install

 dotnet add package Space.DependencyInjection

(Brings in Space.Abstraction.)

Quick Start

var services = new ServiceCollection();
services.AddSpace(options =>
{
    options.ServiceLifetime = ServiceLifetime.Scoped;      // Lifetime of generated registrations
    options.NotificationDispatchType = NotificationDispatchType.Parallel; // or Sequential
});
// Optional built?in module providers
services.AddSpaceInMemoryCache(); // if using InMemoryCache module package

var provider = services.BuildServiceProvider();
var space = provider.GetRequiredService<ISpace>();

// Send a request
var loginResponse = await space.Send<UserLoginResponse>(new UserLoginRequest("demo"));

// Publish an event (all [Notification] handlers of matching event type will be invoked)
await space.Publish(new UserLoggedInSuccessfully("demo"));

Named Handlers

If multiple [Handle] methods target the same request/response, give them distinct Name values and select at call time:

var result = await space.Send<PriceResult>(query /* request object */, handlerName: "Discounted");

(The overload with handlerName is source?generated.)

Modules

Framework & custom modules are activated by annotating handler methods with their module attribute (e.g. [CacheModule(Duration = 60)]). System modules run before user pipelines. Add supporting package/providers before calling the handler.

In-Memory Cache Example

services.AddSpace();
services.AddSpaceInMemoryCache();

public class UserQueries
{
    [Handle]
    [CacheModule(Duration = 30)]
    public ValueTask<UserDetail> GetUser(HandlerContext<UserId> ctx) => ...;
}

Source-Generated Extensions (Internal)

The generator emits and AddSpace invokes:

• AddSpaceSourceGenerated(IServiceCollection, Action<SpaceOptions>?)
• AddSpaceModules(IServiceCollection) You normally just call services.AddSpace(...).

Notifications

Configure dispatch strategy via SpaceOptions.NotificationDispatchType (Parallel or Sequential). Each [Notification] method receives a NotificationContext<TEvent>.

Pipelines

Add cross?cutting logic with [Pipeline] methods using PipelineContext<TRequest>; use Order to influence execution relative to other pipelines (modules use very low values to run first).

Performance

No runtime reflection: all registrations & handler metadata are generated at build time for minimal overhead.

Links

• Repo: https://github.com/salihcantekin/Space
• License: MIT