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

Switchboard Dependency Injection Extensions

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

👁 NuGet

⚠️ 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