feat(data-classes): add support for S3 IntelligentTiering events

Relates to #7443

Extends S3Event data classes to handle IntelligentTiering events
which use 'get_object' key instead of 'object' in the S3 message.

Changes:
- Add S3EventRecordIntelligentTieringEventData wrapper class
- Update S3Message.get_object() to handle both key names
- Update S3Event.object_key to handle both key names
- Add intelligent_tiering_event_data property to S3EventRecord

Author: oyiz-michael

aws_lambda_powertools/utilities/data_classes/s3_event.py

@@ -215,9 +215,14 @@ def bucket(self) -> S3Bucket:
 
     @property
     def get_object(self) -> S3Object:
-        """Get the `object` property as an S3Object"""
-        # Note: this name conflicts with existing python builtins
-        return S3Object(self["object"])
+        """Get the `object` property as an S3Object
+
+        Note: IntelligentTiering events use 'get_object' as the actual key name,
+        while other S3 events use 'object'. This method handles both cases.
+        """
+        # IntelligentTiering events use 'get_object', others use 'object'
+        object_data = self.get("get_object") or self["object"]
+        return S3Object(object_data)
 
 
 class S3EventRecordGlacierRestoreEventData(DictWrapper):
@@ -242,6 +247,16 @@ def restore_event_data(self) -> S3EventRecordGlacierRestoreEventData:
         return S3EventRecordGlacierRestoreEventData(self["restoreEventData"])
 
 
+class S3EventRecordIntelligentTieringEventData(DictWrapper):
+    @property
+    def destination_access_tier(self) -> str:
+        """The new access tier for the object.
+
+        The intelligentTieringEventData key is only visible for IntelligentTiering events.
+        """
+        return self["destinationAccessTier"]
+
+
 class S3EventRecord(DictWrapper):
     @property
     def event_version(self) -> str:
@@ -297,6 +312,12 @@ def glacier_event_data(self) -> S3EventRecordGlacierEventData | None:
         item = self.get("glacierEventData")
         return None if item is None else S3EventRecordGlacierEventData(item)
 
+    @property
+    def intelligent_tiering_event_data(self) -> S3EventRecordIntelligentTieringEventData | None:
+        """The intelligentTieringEventData key is only visible for IntelligentTiering events."""
+        item = self.get("intelligentTieringEventData")
+        return None if item is None else S3EventRecordIntelligentTieringEventData(item)
+
 
 class S3Event(DictWrapper):
     """S3 event notification
@@ -325,5 +346,12 @@ def bucket_name(self) -> str:
 
     @property
     def object_key(self) -> str:
-        """Get the object key for the first s3 event record and unquote plus"""
-        return unquote_plus(self["Records"][0]["s3"]["object"]["key"])
+        """Get the object key for the first s3 event record and unquote plus
+
+        Note: IntelligentTiering events use 'get_object' as the key name,
+        while other S3 events use 'object'. This method handles both cases.
+        """
+        s3_data = self["Records"][0]["s3"]
+        # IntelligentTiering events use 'get_object', others use 'object'
+        object_data = s3_data.get("get_object") or s3_data["object"]
+        return unquote_plus(object_data["key"])