feat: batch deserialize event records

[hjgraca]

Please provide the issue number

Issue number: #969

Summary

Changes

This pull request adds strongly-typed batch processing with automatic deserialization support for SQS, Kinesis, and DynamoDB events.

New Features

• Typed Record Handlers: ITypedRecordHandler and ITypedRecordHandlerWithContext interfaces for strongly-typed processing
• Typed Batch Processors: TypedSqsBatchProcessor, TypedKinesisEventBatchProcessor, TypedDynamoDbStreamBatchProcessor
• Auto-Deserialization: Automatic JSON deserialization from event records to user-defined types

Documentation updates

• New section in each processor added that explains the new Typed approach.
• Dedicated section on Typed approach

User experience

Introduce strongly-typed batch processing that automatically handles deserialization:

New Interface-based Approach:

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;
    }
}

Checklist

Please leave checklist items unchecked if they do not apply to your change.

• Meets tenets criteria
• I have performed a self-review of this change
• Changes have been tested
• Changes are documented
• PR title follows conventional commit semantics

Is this a breaking change?

RFC issue number:

Checklist:

• Migration process documented
• Implement warnings (if it can live side by side)

Acknowledgment

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

Disclaimer: We value your time and bandwidth. As such, any pull requests created on non-triaged issues might not be successful.

[codecov]

Codecov Report

❌ Patch coverage is 84.26295% with 79 lines in your changes missing coverage. Please review.
✅ Project coverage is 77.81%. Comparing base (9baf787) to head (f9f2a2b).
⚠️ Report is 17 commits behind head on develop.

Files with missing lines	Patch %	Lines
...BatchProcessing/Internal/AotCompatibilityHelper.cs	70.90%	14 Missing and 2 partials ⚠️
...sing/DynamoDb/TypedDynamoDbStreamBatchProcessor.cs	78.57%	13 Missing and 2 partials ⚠️
...cessing/Kinesis/TypedKinesisEventBatchProcessor.cs	78.57%	13 Missing and 2 partials ⚠️
...ternal/TypedRecordHandlerWithContextWrapperBase.cs	64.51%	7 Missing and 4 partials ⚠️
...ools.BatchProcessing/Sqs/TypedSqsBatchProcessor.cs	87.14%	7 Missing and 2 partials ⚠️
...ocessing/Internal/TypedRecordHandlerWrapperBase.cs	82.75%	2 Missing and 3 partials ⚠️
...ools.BatchProcessing/JsonDeserializationService.cs	90.74%	3 Missing and 2 partials ⚠️
...chProcessing/Kinesis/KinesisRecordDataExtractor.cs	75.00%	3 Missing ⚠️

Additional details and impacted files

@@           Coverage Diff            @@
##           develop     #970   +/-   ##
========================================
  Coverage    77.81%   77.81%           
========================================
  Files          285      285           
  Lines        11402    11402           
  Branches      1341     1341           
========================================
  Hits          8873     8873           
  Misses        2099     2099           
  Partials       430      430           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[sonarqubecloud]

Quality Gate passed

Issues
1 New issue
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.6% Duplication on New Code

See analysis details on SonarQube Cloud