feat(batch): add Kafka/MSK batch processing support

[shaked-lokits]

Issue number: closes #5362

Summary

Add support for processing Kafka and MSK events with partial batch failure reporting, leveraging the new ReportBatchItemFailures functionality that AWS recently enabled for Kafka event sources.

Changes

• Add EventType.Kafka to batch processor for unified MSK/self-managed Kafka support
• Implement _collect_kafka_failures() for composite identifiers (topic-partition + offset)
• Add _get_records_from_event() helper to flatten Kafka's nested record structure
• Add KafkaItemIdentifier TypedDict for type safety
• Add 14 functional tests covering sync/async processing, partial failures, and edge cases
• Update batch processing documentation with Kafka section and SAM template
• Update Kafka utility documentation with cross-reference to batch processing

User experience

Before: Users had to manually implement partial batch failure handling for Kafka/MSK events, including constructing the correct response format with composite identifiers.

After: Users can use the familiar batch processing API:

from aws_lambda_powertools.utilities.batch import BatchProcessor, EventType, process_partial_response

processor = BatchProcessor(event_type=EventType.Kafka)

def record_handler(record):
    # Process record
    return record.value

def lambda_handler(event, context):
    return process_partial_response(event=event, record_handler=record_handler, processor=processor, context=context)

---

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

[boring-cyborg]

Thanks a lot for your first contribution! Please check out our contributing guidelines and don't hesitate to ask whatever you need.
In the meantime, check out the #python channel on our Powertools for AWS Lambda Discord: Invite link

[sonarqubecloud]

Quality Gate passed

Issues
5 New issues
0 Accepted issues

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

See analysis details on SonarQube Cloud