NickSoftware.Switchboard.Extensions.DependencyInjection 0.1.0-preview.52

Switchboard Dependency Injection Extensions

Dependency injection and IoC container extensions for the Switchboard Amazon Connect framework.

⚠️ PREVIEW RELEASE: Part of the Switchboard preview release. APIs may change.

Overview

This package provides Microsoft.Extensions.DependencyInjection integration for the Switchboard framework, enabling:

• Automatic assembly scanning for flow builders and providers
• Middleware pipeline registration
• Configuration binding from appsettings.json
• Service lifetime management

Installation

dotnet add package NickSoftware.Switchboard.Extensions.DependencyInjection --prerelease

This package is typically installed alongside the main Switchboard package:

dotnet add package NickSoftware.Switchboard --prerelease
dotnet add package NickSoftware.Switchboard.Extensions.DependencyInjection --prerelease

Quick Start

Basic Setup

using Switchboard.Extensions.DependencyInjection;

var builder = Host.CreateApplicationBuilder(args);

builder.Services.AddSwitchboard(options =>
{
    options.InstanceName = "MyCallCenter";
    options.Region = "us-east-1";
});

var host = builder.Build();
var app = host.Services.GetRequiredService<ISwitchboardApp>();

With Configuration

// Using appsettings.json
builder.Services.AddSwitchboard(builder.Configuration);

// appsettings.json
{
  "Switchboard": {
    "InstanceName": "MyCallCenter",
    "Region": "us-east-1",
    "EnableLogging": true
  }
}

Features

Assembly Scanning

Automatically discover and register flow builders and resource providers:

builder.Services.AddSwitchboard(options => { })
    .AddAssemblyScanning(typeof(Program).Assembly);

Flow builders are discovered by:

• Implementing IDiscoverableFlowBuilder interface
• Decorating with [FlowBuilder] attribute

// Using interface
public class MainFlowBuilder : IDiscoverableFlowBuilder
{
    public IFlow Build() => Flow.Create("MainFlow")
        .PlayPrompt("Welcome")
        .Build();
}

// Using attribute
[FlowBuilder]
public class SupportFlowBuilder
{
    public IFlow Build() => Flow.Create("SupportFlow")
        .PlayPrompt("Support line")
        .Build();
}

Middleware Pipeline

Register and configure middleware for flow validation and processing:

builder.Services.AddSwitchboard(options => { })
    .UseMiddleware<LoggingMiddleware>()
    .UseMiddleware<ValidationMiddleware>()
    .UseMiddleware<MetricsMiddleware>();

Built-in middleware:

• LoggingMiddleware - Logs flow building and validation
• ValidationMiddleware - Validates flow structure
• LambdaValidationMiddleware - Validates Lambda configurations
• MetricsMiddleware - Collects build metrics

Custom Middleware

public class CustomMiddleware : IFlowMiddleware
{
    private readonly ILogger<CustomMiddleware> _logger;

    public CustomMiddleware(ILogger<CustomMiddleware> logger)
    {
        _logger = logger;
    }

    public async Task InvokeAsync(FlowContext context, Func<Task> next)
    {
        _logger.LogInformation("Processing flow: {FlowName}", context.FlowName);
        await next();
        _logger.LogInformation("Flow processed successfully");
    }
}

Validation Configuration

Configure custom validators:

builder.Services.AddSwitchboard(options => { })
    .AddValidation(config =>
    {
        config.ValidateEmptyFlows = true;
        config.ValidateTerminalActions = true;
        config.ValidateTransitions = true;
    });

Resource Providers

Register configuration providers for queues, routing profiles, and hours of operation:

[ResourceProvider]
public class QueueProvider : IResourceProvider
{
    public void Configure(ISwitchboardStack stack)
    {
        stack.AddQueue(Queue.Create("Sales")
            .Build());
    }
}

Manual Registration

If you prefer explicit registration over scanning:

builder.Services.AddSwitchboard(options => { })
    .AddFlowBuilders(typeof(MainFlowBuilder), typeof(SupportFlowBuilder))
    .AddProviders(typeof(QueueProvider), typeof(HoursProvider));

Integration with Existing Connect Instance

builder.Services.AddSwitchboard(options =>
{
    options.InstanceArn = "arn:aws:connect:us-east-1:123456789:instance/abc-123";
});

Requirements

• .NET 10.0 or later
• Microsoft.Extensions.DependencyInjection 9.0+

Related Packages

• NickSoftware.Switchboard - Core framework
• NickSoftware.Switchboard.Analyzers - Compile-time validation
• NickSoftware.Switchboard.SourceGenerators - Code generation

Documentation

• 📖 Full Documentation
• 🐛 Report Issues

Part of the Switchboard framework for Amazon Connect