v3.0.0

[hjgraca]

Summary

We're excited to announce a major release with new features and important updates:

• Strongly-typed batch processor with automatic deserialization for SQS, Kinesis, and DynamoDB events
• Enhanced tracing with improved metadata error handling
• Bug fix for logging sampling rate

This major version bump reflects significant breaking changes as we update our supported runtimes and dependencies.

Breaking Changes

⚠️ Important: Please review these breaking changes before upgrading:

Migration guide to v3

• Removed support for .NET 6 - We now require .NET 8 or later
• AWS SDK v3 no longer supported - We have migrated to AWS SDK v4
• Version alignment - All Powertools for AWS Lambda utilities will maintain version parity going forward

New Features

Strongly-Typed Batch Processor

📖 Documentation | Migration Guide

Process batch events with type safety and automatic deserialization.

What's New:

• ITypedRecordHandler<T> and ITypedRecordHandlerWithContext<T> interfaces for strongly-typed processing
• Specialized processors: TypedSqsBatchProcessor, TypedKinesisEventBatchProcessor, TypedDynamoDbStreamBatchProcessor
• Automatic JSON deserialization from event records to your types
• Optional ILambdaContext injection for timeout handling and request tracking

Example Usage:

Simple typed handler:

public class OrderHandler : ITypedRecordHandler<Order> { public async Task<RecordHandlerResult> HandleAsync(Order order, CancellationToken cancellationToken) { // Direct access to strongly-typed object - no manual deserialization! await ProcessOrder(order); return RecordHandlerResult.Successful; } }

With Lambda context support (docs):

public class ProductHandlerWithContext : ITypedRecordHandlerWithContext<Product> { public async Task<RecordHandlerResult> HandleAsync(Product product, ILambdaContext context, CancellationToken cancellationToken) { Logger.LogInformation($"Processing product {product.Id} in request {context.AwsRequestId}"); Logger.LogInformation($"Remaining time: {context.RemainingTime.TotalSeconds}s"); // Use context for timeout handling if (context.RemainingTime.TotalSeconds < 5) { Logger.LogWarning("Low remaining time, processing quickly"); } return RecordHandlerResult.Successful; } }

Contributors

Thank you @dcabib for your contributions to this release! ⭐

Changes

🐞 Bug fixes

• fix(logging): Fix sampling when log level is above Debug fix(logging): Fix sampling when log level is above Debug #980 @dcabib

📜 Documentation updates

• chore: remove dotnet6 from docs and add migration guides for v2 and v3 (chore: remove dotnet6 from docs and add migration guides for v2 and v3 #1021) by @hjgraca
• chore(deps): bump squidfunk/mkdocs-material from 86d21da to 00f9276 in /docs (chore(deps): bump squidfunk/mkdocs-material from 86d21da to 00f9276 in /docs #1013) by @dependabot[bot]
• chore: Tracing sanitize metadata (chore: Tracing sanitize metadata #1011) by @hjgraca
• chore(deps): bump squidfunk/mkdocs-material from 209b62d to 86d21da in /docs (chore(deps): bump squidfunk/mkdocs-material from 209b62d to 86d21da in /docs #996) by @dependabot[bot]

🔧 Maintenance

• chore: remove dotnet6 from docs and add migration guides for v2 and v3 (chore: remove dotnet6 from docs and add migration guides for v2 and v3 #1021) by @hjgraca
• chore(deps): bump squidfunk/mkdocs-material from 86d21da to 00f9276 in /docs (chore(deps): bump squidfunk/mkdocs-material from 86d21da to 00f9276 in /docs #1013) by @dependabot[bot]
• chore(deps): bump aws-actions/configure-aws-credentials from 5.0.0 to 5.1.0 (chore(deps): bump aws-actions/configure-aws-credentials from 5.0.0 to 5.1.0 #1020) by @dependabot[bot]
• chore(deps): bump github/codeql-action from 3.30.5 to 3.30.6 (chore(deps): bump github/codeql-action from 3.30.5 to 3.30.6 #1014) by @dependabot[bot]
• chore(deps): bump ossf/scorecard-action from 2.4.2 to 2.4.3 (chore(deps): bump ossf/scorecard-action from 2.4.2 to 2.4.3 #1012) by @dependabot[bot]
• chore: version update automation (chore: version update automation #1018) by @hjgraca
• chore: Tracing sanitize metadata (chore: Tracing sanitize metadata #1011) by @hjgraca
• chore(deps): bump zgosalvez/github-actions-ensure-sha-pinned-actions from 3.0.25 to 4.0.0 (chore(deps): bump zgosalvez/github-actions-ensure-sha-pinned-actions from 3.0.25 to 4.0.0 #1008) by @dependabot[bot]
• chore(deps): bump github/codeql-action from 3.30.4 to 3.30.5 (chore(deps): bump github/codeql-action from 3.30.4 to 3.30.5 #1007) by @dependabot[bot]
• chore(deps): bump github/codeql-action from 3.30.3 to 3.30.4 (chore(deps): bump github/codeql-action from 3.30.3 to 3.30.4 #1004) by @dependabot[bot]
• chore(deps): bump squidfunk/mkdocs-material from 209b62d to 86d21da in /docs (chore(deps): bump squidfunk/mkdocs-material from 209b62d to 86d21da in /docs #996) by @dependabot[bot]
• chore: update AWS SDK dependencies (chore: update AWS SDK dependencies #999) by @hjgraca
• chore: update environment variable references to use AWS_SDK_UA_APP_ID (chore: update environment variable references to use AWS_SDK_UA_APP_ID #934) by @hjgraca
• chore: drop .NET 6 support, go .NET 8 only chore: drop .NET 6 support, go .NET 8 only #995 @dcabib
• chore: Upgrade to AWS sdk v4 chore: Upgrade to AWS sdk v4 #998 @dcabib
• feat: batch deserialize event records feat: batch deserialize event records #970 @hjgraca

This release was made possible by the following contributors:

@dependabot[bot], @hjgraca and dependabot[bot]

---

This discussion was created from the release v3.0.0.