Siemens.AspNet.Lambda.Sdk 0.1.0-alpha.169

Prefix Reserved
This is a prerelease version of Siemens.AspNet.Lambda.Sdk.
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package Siemens.AspNet.Lambda.Sdk --version 0.1.0-alpha.169
                    
NuGet\Install-Package Siemens.AspNet.Lambda.Sdk -Version 0.1.0-alpha.169
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Siemens.AspNet.Lambda.Sdk" Version="0.1.0-alpha.169" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Siemens.AspNet.Lambda.Sdk" Version="0.1.0-alpha.169" />
                    
Directory.Packages.props
<PackageReference Include="Siemens.AspNet.Lambda.Sdk" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Siemens.AspNet.Lambda.Sdk --version 0.1.0-alpha.169
                    
#r "nuget: Siemens.AspNet.Lambda.Sdk, 0.1.0-alpha.169"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Siemens.AspNet.Lambda.Sdk@0.1.0-alpha.169
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Siemens.AspNet.Lambda.Sdk&version=0.1.0-alpha.169&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Siemens.AspNet.Lambda.Sdk&version=0.1.0-alpha.169&prerelease
                    
Install as a Cake Tool

Siemens.AspNet.Lambda.Sdk

The Siemens.AspNet.Lambda.Sdk NuGet package simplifies and accelerates AWS Lambda function development using ASP.NET-inspired middleware pipelines, structured exception handling, and pre-configured startup patterns.


📖 Overview

This SDK helps developers focus on implementing business logic by abstracting boilerplate and common concerns specific to AWS Lambda environments.

✅ Key Features

  • 🚀 Quick Lambda function implementation with structured base classes.
  • ⚙️ ASP.NET-like middleware pipeline support.
  • 📌 Customizable startup configurations with dependency injection.
  • 🔍 Structured error logging with built-in handlers.
  • 🔄 JSON serialization management.
  • 🛠️ Predefined logging and error handling strategies.
  • 🕒 Built-in cancellation support to gracefully handle Lambda execution limits.

📦 Installation

Using the .NET CLI

dotnet add package Siemens.AspNet.Lambda.Sdk

🧠 Key Concepts

Component Description
FunctionBase<TRequest> Base class for request-only Lambda implementation
FunctionBase<TRequest, TResponse> Base class for request-response Lambda implementation
FunctionHandlerBase<TStartup, TRequest> Lambda with custom handler and dependency injection (request-only)
FunctionHandlerBase<TStartup, TRequest, TResponse> Lambda with custom handler and dependency injection
ILambdaMiddleware<TRequest> Middleware interface for request-only Lambdas
ILambdaMiddleware<TRequest, TResponse> Middleware interface for request-response Lambdas

⚡ Quickstart Examples

Dockerfile and Lambda entry point

Use the fully qualified method name (InvokeAsync) as the Lambda entry point.

Sample Dockerfile entry point:

CMD ["Siemens.TestProject.InitCognitoUser::Siemens.TestProject.InitCognitoUser.Function::InvokeAsync"]

Implementing a simple Lambda function without response

public class MyFunction : FunctionBase<SQSEvent>
{
    public override Task HandleAsync(SQSEvent request, ILambdaContext context, CancellationToken cancellationToken)
    {
        // Your Lambda logic here
    }
}

Implementing a simple Lambda function with request and response

public class Function : FunctionBase<CognitoPostConfirmationEvent, CognitoPostConfirmationEvent>
{
    public override Task<CognitoPostConfirmationEvent> HandleAsync(CognitoPostConfirmationEvent request,
                                                                   ILambdaContext context,
                                                                   CancellationToken cancellationToken)
    {
        // Your Lambda logic here
    }
}

Implementing a Lambda function with custom handler and dependency injection

Function:

public class Function : FunctionHandlerBase<Startup, CognitoPostConfirmationEvent, CognitoPostConfirmationEvent>
{
}

Startup:

public sealed class Startup : LambdaStartup
{
    protected override void ConfigureServices(IServiceCollection services, IConfiguration configuration)
    {
        base.ConfigureServices(services, configuration);
        services.AddFunctionHandler();
    }
}

FunctionHandler registration:

internal static class AddFunctionHandlerExtension
{
    internal static void AddFunctionHandler(this IServiceCollection services)
    {
        services.AddSingletonIfNotExists<IFunctionHandler<CognitoPostConfirmationEvent, CognitoPostConfirmationEvent>, FunctionHandler>();
    }
}

internal sealed class FunctionHandler(IMyService service, IJsonSerializer jsonSerializer)
    : IFunctionHandler<CognitoPostConfirmationEvent, CognitoPostConfirmationEvent>
{
    public Task<CognitoPostConfirmationEvent> HandleAsync(CognitoPostConfirmationEvent request,
                                                          ILambdaContext context,
                                                          CancellationToken cancellationToken)
    {
        // Your custom logic here
    }
}

📌 Cancellation and Execution Management

The SDK includes built-in cancellation token support to help gracefully handle AWS Lambda execution timeouts.

Configure the cancellation buffer time:

internal sealed class LambdaSettings
{
    /// <summary>
    /// Offset to trigger the cancellation token slightly before Lambda's remaining execution time ends, ensuring proper resource cleanup.
    /// </summary>
    public TimeSpan CancellationBufferTime { get; init; } = TimeSpan.FromSeconds(10);
}

Base Function with Cancellation Token

If you want to implement your own function handler, here is a sample how to set up such a use case

public abstract class FunctionBase<TRequest, TResponse> : FunctionWithStartupBase<LambdaStartup, TRequest, TResponse>
{
}

public abstract class FunctionWithStartupBase<TStartup, TRequest, TResponse> where TStartup : LambdaStartup, new()
{
    protected ILogger Logger { get; private set; }
    private readonly ILambdaPipelineExecutor<TRequest, TResponse> _pipeline;
    private readonly LambdaSettings _lambdaSettings;

    protected FunctionWithStartupBase()
    {
        var startup = new TStartup();
        var serviceProvider = startup.Setup();
        _pipeline = serviceProvider.GetRequiredService<ILambdaPipelineExecutor<TRequest, TResponse>>();
        _lambdaSettings = serviceProvider.GetRequiredService<LambdaSettings>();
        Logger = startup.Logger;
    }

    public async Task<TResponse> InvokeAsync(TRequest request,
                                             ILambdaContext context)
    {
        var cancelAfter = context.RemainingTime.Subtract(_lambdaSettings.CancellationBufferTime);
        cancelAfter = cancelAfter < TimeSpan.Zero ? TimeSpan.Zero : cancelAfter;

        using var cts = new CancellationTokenSource();
        cts.CancelAfter(cancelAfter);

        // Do not remove "await" here, it is necessary for the pipeline to work correctly in combination with the cancellation token.
        var result = await _pipeline.ExecuteAsync(request, context, HandleAsync, cts.Token).ConfigureAwait(false);

        return result;
    }

    public abstract Task<TResponse> HandleAsync(TRequest request,
                                                ILambdaContext context,
                                                CancellationToken cancellationToken);
}

📌 Error Handling and Logging

Built-in structured handlers:

Handler Description
DefaultExceptionLogHandler Handles general exceptions with basic structured logging, providing essential error information like message, stack trace, and context.
ProblemDetailsExceptionLogHandler Processes exceptions with RFC 7807 problem details, logging structured information about HTTP API problems including status code, title, and details.
ValidationDetailsExceptionLogHandler Manages validation-related exceptions, logging detailed information about validation failures including field-specific errors.
ValidationProblemDetailsExtendedExceptionLogHandler Extends validation problem details with additional context, logging enhanced validation information including current values and suggested samples.
JsonExceptionLogHandler Provides enhanced error details for JSON processing errors, including exact error locations, invalid values, and expected formats - offering more context than standard JSON exceptions.
JsonReaderExceptionLogHandler Delivers detailed JSON parsing error information with precise syntax error locations, expected vs. actual values, and contextual details beyond standard JSON reader exceptions.
JsonSerializationExceptionLogHandler Offers comprehensive serialization error details including object structure analysis, circular reference detection, and detailed type conversion errors - surpassing standard serialization error information.

Each handler provides detailed, structured logging of exceptions, aiding rapid diagnostics and maintenance.


📚 Documentation

Detailed documentation and further examples can be found within the codebase and will soon be available online.


📢 Contributing

Contributions and feedback are welcome! Please create issues or pull requests to suggest improvements.

Product Compatible and additional computed target framework versions.
.NET net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.1.0-alpha.222 169 7/16/2025
0.1.0-alpha.219 157 7/14/2025
0.1.0-alpha.217 68 7/11/2025
0.1.0-alpha.212 155 7/8/2025
0.1.0-alpha.211 119 7/3/2025
0.1.0-alpha.207 102 7/3/2025
0.1.0-alpha.206 243 6/30/2025
0.1.0-alpha.205 94 6/27/2025
0.1.0-alpha.202 84 6/27/2025
0.1.0-alpha.200 88 6/27/2025
0.1.0-alpha.198 90 6/27/2025
0.1.0-alpha.196 92 6/27/2025
0.1.0-alpha.195 90 6/27/2025
0.1.0-alpha.194 88 6/27/2025
0.1.0-alpha.193 91 6/27/2025
0.1.0-alpha.192 91 6/27/2025
0.1.0-alpha.191 87 6/27/2025
0.1.0-alpha.189 107 6/26/2025
0.1.0-alpha.188 110 6/26/2025
0.1.0-alpha.187 108 6/26/2025
0.1.0-alpha.186 100 6/26/2025
0.1.0-alpha.185 105 6/26/2025
0.1.0-alpha.184 102 6/26/2025
0.1.0-alpha.183 107 6/26/2025
0.1.0-alpha.182 108 6/26/2025
0.1.0-alpha.181 108 6/25/2025
0.1.0-alpha.180 112 6/24/2025
0.1.0-alpha.179 111 6/23/2025
0.1.0-alpha.178 116 6/23/2025
0.1.0-alpha.176 114 6/23/2025
0.1.0-alpha.174 118 6/19/2025
0.1.0-alpha.173 110 6/19/2025
0.1.0-alpha.172 114 6/17/2025
0.1.0-alpha.171 111 6/16/2025
0.1.0-alpha.169 113 6/16/2025
0.1.0-alpha.165 254 6/13/2025
0.1.0-alpha.164 220 6/13/2025
0.1.0-alpha.163 225 6/13/2025
0.1.0-alpha.160 255 6/12/2025
0.1.0-alpha.159 278 6/11/2025
0.1.0-alpha.158 260 6/11/2025
0.1.0-alpha.143 257 6/11/2025
0.1.0-alpha.142 256 6/11/2025
0.1.0-alpha.140 264 6/11/2025
0.1.0-alpha.139 261 6/10/2025
0.1.0-alpha.138 260 6/9/2025
0.1.0-alpha.137 44 6/7/2025
0.1.0-alpha.136 43 6/7/2025
0.1.0-alpha.135 74 6/6/2025
0.1.0-alpha.134 77 6/6/2025
0.1.0-alpha.130 125 6/5/2025
0.1.0-alpha.129 114 6/4/2025
0.1.0-alpha.128 110 6/4/2025
0.1.0-alpha.122 115 6/3/2025
0.1.0-alpha.121 118 6/1/2025
0.1.0-alpha.120 74 6/1/2025
0.1.0-alpha.118 116 5/28/2025
0.1.0-alpha.117 116 5/28/2025
0.1.0-alpha.116 114 5/28/2025
0.1.0-alpha.115 123 5/26/2025
0.1.0-alpha.114 120 5/22/2025
0.1.0-alpha.112 117 5/21/2025
0.1.0-alpha.111 123 5/20/2025
0.1.0-alpha.108 122 5/19/2025
0.1.0-alpha.104 181 5/18/2025
0.1.0-alpha.102 205 5/14/2025
0.1.0-alpha.101 199 5/14/2025
0.1.0-alpha.100 204 5/12/2025
0.1.0-alpha.99 195 5/12/2025
0.1.0-alpha.98 39 5/10/2025
0.1.0-alpha.97 43 5/10/2025
0.1.0-alpha.86 118 5/8/2025
0.1.0-alpha.85 116 5/8/2025
0.1.0-alpha.84 116 5/8/2025
0.1.0-alpha.82 121 5/7/2025
0.1.0-alpha.81 118 5/6/2025
0.1.0-alpha.76 47 5/3/2025
0.1.0-alpha.75 71 5/2/2025
0.1.0-alpha.74 70 5/2/2025