feat: add received_for to ReceivedEmail type

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: lucasfcosta

resend/emails/_received_email.py

@@ -152,6 +152,10 @@ class _ReceivedEmailDefaultAttrs(_ReceivedEmailFromParam, BaseResponse):
     """
     Reply-to addresses.
     """
+    received_for: List[str]
+    """
+    Addresses the email was received for (forwarding recipients).
+    """
     message_id: str
     """
     The message ID of the email.
@@ -182,6 +186,7 @@ class ReceivedEmail(_ReceivedEmailDefaultAttrs):
         bcc (Optional[List[str]]): Bcc recipients.
         cc (Optional[List[str]]): Cc recipients.
         reply_to (Optional[List[str]]): Reply-to addresses.
+        received_for (List[str]): Addresses the email was received for (forwarding recipients).
         message_id (str): The message ID of the email.
         headers (NotRequired[Dict[str, str]]): Email headers.
         attachments (List[EmailAttachment]): List of attachments.

tests/receiving_async_test.py

@@ -20,6 +20,7 @@ async def test_receiving_get_async(self) -> None:
                 "to": ["recipient@example.com"],
                 "subject": "Test subject",
                 "created_at": "2024-01-01T00:00:00Z",
+                "received_for": ["forwarded@example.com"],
             }
         )
 
@@ -28,6 +29,7 @@ async def test_receiving_get_async(self) -> None:
         )
         assert email["id"] == "67d9bcdb-5a02-42d7-8da9-0d6feea18cff"
         assert email["object"] == "received_email"
+        assert email["received_for"] == ["forwarded@example.com"]
 
     async def test_should_get_receiving_async_raise_exception_when_no_content(
         self,