👁 Image
AlexaVoxCraft.Logging 2.0.1.62

🔣 AlexaVoxCraft

AlexaVoxCraft is a modular C# .NET library for building Amazon Alexa skills using modern .NET practices. It provides comprehensive support for Alexa skill development with CQRS patterns, visual interfaces, and AWS Lambda hosting.

Key Features

• 🎯 MediatR Integration: CQRS-style request handling with pipeline behaviors and auto-discovery
• 🎨 APL Support: Complete Alexa Presentation Language implementation for rich visual interfaces
• ⚡ Lambda Hosting: Optimized AWS Lambda runtime with custom serialization and ReadyToRun publishing
• 📊 Session Management: Robust session attribute handling and game state persistence
• 🔧 Pipeline Behaviors: Request/response interceptors for cross-cutting concerns like logging and validation
• 🧪 Testing Support: Comprehensive testing utilities with AutoFixture integration and property-based testing

📦 Packages

👁 Build Status

🚀 Quick Start

Install Core Packages

# Core MediatR integration and Lambda hosting
dotnet add package AlexaVoxCraft.MediatR.Lambda

# APL visual interface support (optional)
dotnet add package AlexaVoxCraft.Model.Apl

# Structured logging for Alexa skills (optional)
dotnet add package AlexaVoxCraft.Logging

Create a Basic Skill

// Program.cs
using AlexaVoxCraft.MediatR.Lambda;
using AlexaVoxCraft.Model.Response;

return await LambdaHostExtensions.RunAlexaSkill<MySkillFunction, SkillRequest, SkillResponse>();

// Function.cs
public class MySkillFunction : AlexaSkillFunction<SkillRequest, SkillResponse>
{
 protected override void Init(IHostBuilder builder)
 {
 builder
 .UseHandler<LambdaHandler, SkillRequest, SkillResponse>()
 .ConfigureServices((context, services) =>
 {
 services.AddSkillMediator(context.Configuration, cfg => 
 cfg.RegisterServicesFromAssemblyContaining<MySkillFunction>());
 });
 }
}

// Handler.cs
public class LaunchRequestHandler : IRequestHandler<LaunchRequest>
{
 public bool CanHandle(IHandlerInput handlerInput) => 
 handlerInput.RequestEnvelope.Request is LaunchRequest;

 public async Task<SkillResponse> Handle(IHandlerInput input, CancellationToken cancellationToken)
 {
 return await input.ResponseBuilder
 .Speak("Welcome to my skill!")
 .Reprompt("What would you like to do?")
 .GetResponse(cancellationToken);
 }
}

📖 Documentation

📚 Complete Documentation - Comprehensive guides and examples

Core Components

• Request Handling - MediatR integration and handler patterns
• APL Integration - Rich visual interface development
• Lambda Hosting - AWS Lambda deployment and optimization
• Session Management - State persistence and user data
• Pipeline Behaviors - Cross-cutting concerns and interceptors

Examples

• Complete Examples - Production-ready trivia skill implementation

📁 Project Structure

AlexaVoxCraft/
├── 📂 src/ # Core library packages
│ ├── 📦 AlexaVoxCraft.Model/ # Base Alexa skill models & serialization
│ ├── 📦 AlexaVoxCraft.Model.Apl/ # APL (Alexa Presentation Language) support
│ ├── 📦 AlexaVoxCraft.MediatR/ # MediatR integration & request handling
│ ├── 📦 AlexaVoxCraft.MediatR.Lambda/ # AWS Lambda hosting & runtime
│ └── 📦 AlexaVoxCraft.Logging/ # Alexa-specific logging for AWS
│
├── 📂 samples/ # Working example projects
│ ├── 📱 Sample.Skill.Function/ # Basic Alexa skill demonstration
│ └── 📱 Sample.Apl.Function/ # APL skill with visual interfaces
│
├── 📂 test/ # Comprehensive test coverage
│ ├── 🧪 AlexaVoxCraft.Model.Tests/ # Core model & serialization tests
│ ├── 🧪 AlexaVoxCraft.Model.Apl.Tests/ # APL functionality tests
│ ├── 🧪 AlexaVoxCraft.MediatR.Tests/ # MediatR integration tests
│ ├── 🧪 AlexaVoxCraft.MediatR.Lambda.Tests/ # Lambda hosting tests
│ └── 🧪 AlexaVoxCraft.Logging.Tests/ # Logging functionality tests
│
├── 📂 AlexaVoxCraft.TestKit/ # Testing utilities & AutoFixture support
├── 📂 docs/ # Documentation source
└── 📂 samples/ # Example implementations

🛠 Core Concepts

Request Handling Pattern

Skills use the MediatR pattern where:

1. Requests implement IRequestHandler<T>
2. Handlers optionally implement ICanHandle for routing logic
3. Pipeline behaviors handle cross-cutting concerns (logging, exceptions)
4. Lambda functions derive from AlexaSkillFunction<TRequest, TResponse>

Package Breakdown

🧪 Testing

AlexaVoxCraft includes comprehensive testing support:

• xUnit v3 with Microsoft.Testing.Platform
• AutoFixture integration for property-based testing
• AwesomeAssertions for fluent assertions
• TestKit with specimen builders and test utilities

⚠️ Error Handling

Implement the IExceptionHandler interface for centralized error handling:

public class GlobalExceptionHandler : IExceptionHandler
{
 public Task<bool> CanHandle(IHandlerInput handlerInput, Exception ex, CancellationToken cancellationToken)
 {
 return Task.FromResult(true); // Handle all exceptions
 }

 public Task<SkillResponse> Handle(IHandlerInput handlerInput, Exception ex, CancellationToken cancellationToken)
 {
 return handlerInput.ResponseBuilder
 .Speak("Sorry, something went wrong. Please try again.")
 .GetResponse(cancellationToken);
 }
}

🤝 Contributing

PRs are welcome! Please submit issues and ideas to help make this toolkit even better.

📜 Credits & Attribution

📦 Credits:

• Core Alexa skill models (AlexaVoxCraft.Model) based on timheuer/alexa-skills-dotnet
• APL support (AlexaVoxCraft.Model.Apl) based on stoiveyp/Alexa.NET.APL
• AlexaCompactJsonFormatter adapted from Serilog.Formatting.Compact

📜 License

This project is licensed under the .

Stargazers over time