feat: add message_id typing for emails and webhook events

Add message_id to the Email type for GET /emails/:id and list responses.
Introduce typed webhook event payloads (WebhookEventPayload) matching the
Node.js SDK, including message_id on all outbound email webhook events.
Update Webhooks.verify to return the parsed and verified event payload.

Co-authored-by: cpenned <cpenned@users.noreply.github.com>

Author: cursoragent

resend/__init__.py

@@ -57,6 +57,22 @@
 from .version import __version__, get_version
 from .webhooks._webhook import (VerifyWebhookOptions, Webhook, WebhookEvent,
                                 WebhookHeaders, WebhookStatus)
+from .webhooks._webhook_event import (BaseEmailEventData, ContactCreatedEvent,
+                                      ContactDeletedEvent, ContactUpdatedEvent,
+                                      ContactEventData, DomainCreatedEvent,
+                                      DomainDeletedEvent, DomainEventData,
+                                      DomainRecord, DomainUpdatedEvent,
+                                      EmailBounce, EmailBouncedEvent,
+                                      EmailClickedEvent, EmailClick,
+                                      EmailComplainedEvent, EmailDeliveredEvent,
+                                      EmailDeliveryDelayedEvent,
+                                      EmailFailed, EmailFailedEvent,
+                                      EmailOpenedEvent, EmailReceivedEvent,
+                                      EmailScheduledEvent, EmailSentEvent,
+                                      EmailSuppressed, EmailSuppressedEvent,
+                                      ReceivedEmailAttachment,
+                                      ReceivedEmailEventData,
+                                      WebhookEventPayload)
 from .webhooks._webhooks import Webhooks
 
 # Type for clients that support both sync and async
@@ -135,9 +151,37 @@
     "Variable",
     "Webhook",
     "WebhookEvent",
+    "WebhookEventPayload",
     "WebhookHeaders",
     "WebhookStatus",
     "VerifyWebhookOptions",
+    "BaseEmailEventData",
+    "EmailBounce",
+    "EmailClick",
+    "EmailFailed",
+    "EmailSuppressed",
+    "ReceivedEmailAttachment",
+    "ReceivedEmailEventData",
+    "ContactEventData",
+    "DomainRecord",
+    "DomainEventData",
+    "EmailSentEvent",
+    "EmailScheduledEvent",
+    "EmailDeliveredEvent",
+    "EmailDeliveryDelayedEvent",
+    "EmailComplainedEvent",
+    "EmailBouncedEvent",
+    "EmailOpenedEvent",
+    "EmailClickedEvent",
+    "EmailReceivedEvent",
+    "EmailFailedEvent",
+    "EmailSuppressedEvent",
+    "ContactCreatedEvent",
+    "ContactUpdatedEvent",
+    "ContactDeletedEvent",
+    "DomainCreatedEvent",
+    "DomainUpdatedEvent",
+    "DomainDeletedEvent",
     "Topic",
     "BatchValidationError",
     "ReceivedEmail",

resend/emails/_email.py

@@ -16,6 +16,10 @@ class _EmailDefaultAttrs(_FromParam):
     """
     The Email ID.
     """
+    message_id: str
+    """
+    RFC Message-ID header value for the email.
+    """
     to: Union[List[str], str]
     """
     List of email addresses to send the email to.
@@ -60,6 +64,7 @@ class Email(_EmailDefaultAttrs):
 
     Attributes:
         id (str): The Email ID.
+        message_id (str): RFC Message-ID header value for the email.
         from (str): The email address the email was sent from.
         to (Union[List[str], str]): List of email addresses to send the email to.
         created_at (str): When the email was created.