NickSoftware.Switchboard.Analyzers 0.1.0-preview.68

Switchboard Analyzers

Roslyn analyzers and code fixes for the Switchboard Amazon Connect framework. Provides compile-time validation to catch errors before deployment.

👁 NuGet

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

Overview

This package provides Roslyn analyzers that validate your Amazon Connect contact flows at compile time, catching common errors before deployment:

• Missing required flow components
• Invalid transitions between actions
• Empty or misconfigured prompts
• Circular references in flow logic
• Duplicate action identifiers

Installation

dotnet add package NickSoftware.Switchboard.Analyzers --prerelease

This package is typically installed alongside the main Switchboard package:

dotnet add package NickSoftware.Switchboard --prerelease
dotnet add package NickSoftware.Switchboard.Analyzers --prerelease

Diagnostics

Example

The analyzer catches issues like this at compile time:

// ❌ SWB001: Flow must have at least one action
var flow = new FlowBuilder()
 .SetName("EmptyFlow")
 .Build();

// ❌ SWB006: Prompt text is required
var flow = new FlowBuilder()
 .SetName("InvalidFlow")
 .PlayPrompt("") // Empty prompt text
 .Build();

// ✅ Valid flow
var flow = new FlowBuilder()
 .SetName("ValidFlow")
 .PlayPrompt("Welcome to our service")
 .TransferToQueue("Support")
 .Build();

Code Fixes

The analyzers include automatic code fixes for common issues:

• Add missing terminal actions
• Fix empty prompt text
• Generate unique action identifiers

Configuration

Analyzers can be configured in your .editorconfig:

# Treat SWB002 as an error instead of warning
dotnet_diagnostic.SWB002.severity = error

# Disable SWB010 (duplicate identifier check)
dotnet_diagnostic.SWB010.severity = none

Requirements

• .NET Standard 2.0 compatible
• Works with Visual Studio 2022, VS Code, and JetBrains Rider

Related Packages

• NickSoftware.Switchboard - Core framework
• NickSoftware.Switchboard.SourceGenerators - Code generation

Documentation

• 📖 Full Documentation
• 🐛 Report Issues

Part of the Switchboard framework for Amazon Connect