primitivedotdev 2.0.0__tar.gz → 2.2.0__tar.gz

{primitivedotdev-2.0.0 → primitivedotdev-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: primitivedotdev
-Version: 2.0.0
+Version: 2.2.0
 Summary: Official Primitive Python SDK for webhook handling and API access
 Project-URL: Homepage, https://primitive.dev
 Project-URL: Repository, https://github.com/primitivedotdev/sdks

{primitivedotdev-2.0.0 → primitivedotdev-2.2.0}/json-schema/email-received-event.schema.json

@@ -199,6 +199,10 @@
             "auth": {
               "$ref": "#/definitions/EmailAuth",
               "description": "Email authentication results (SPF, DKIM, DMARC)."
+            },
+            "relay": {
+              "anyOf": [{ "$ref": "#/definitions/EmailRelay" }, { "type": "null" }],
+              "description": "Set when the message reached Primitive through a Primitive mail relay. Null for other mail. The field may be absent; treat a missing value the same as null."
             }
           },
           "required": [
@@ -223,6 +227,21 @@
       ],
       "description": "Webhook payload for the `email.received` event.\n\nThis is delivered to your webhook endpoint when Primitive receives an email matching your domain configuration."
     },
+    "EmailRelay": {
+      "type": "object",
+      "properties": {
+        "hostname": {
+          "type": "string",
+          "description": "The relay hostname the domain's MX record points at."
+        },
+        "via": {
+          "type": "string",
+          "description": "How the message arrived. Currently always `mail_relay`. Treat an unfamiliar value as one added after your client was built."
+        }
+      },
+      "required": ["hostname", "via"],
+      "description": "How an inbound message reached Primitive when it arrived through a Primitive mail relay."
+    },
     "RoutingDecision": {
       "type": "object",
       "description": "The recipient-routing decision for an inbound email: which endpoint it resolved to and why. Present on the event only when recipient routing ran for the organization.",

{primitivedotdev-2.0.0 → primitivedotdev-2.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "primitivedotdev"
-version = "2.0.0"
+version = "2.2.0"
 description = "Official Primitive Python SDK for webhook handling and API access"
 readme = "README.md"
 requires-python = ">=3.11"

{primitivedotdev-2.0.0 → primitivedotdev-2.2.0}/src/primitive/__init__.py

@@ -76,6 +76,7 @@ from .types import (
     EmailAnalysis,
     EmailAuth,
     EmailReceivedEvent,
+    EmailRelay,
     EventType,
     ForwardAnalysis,
     ForwardOriginalSender,
@@ -198,6 +199,7 @@ __all__ = [
     "EmailAnalysis",
     "EmailAuth",
     "EmailReceivedEvent",
+    "EmailRelay",
     "EventType",
     "ForwardAnalysis",
     "ForwardOriginalSender",

{primitivedotdev-2.0.0 → primitivedotdev-2.2.0}/src/primitive/api/models/__init__.py

@@ -201,6 +201,8 @@ from .email_auth import EmailAuth
 from .email_detail import EmailDetail
 from .email_detail_automation_headers_type_0 import EmailDetailAutomationHeadersType0
 from .email_detail_awaiting import EmailDetailAwaiting
+from .email_detail_relay_type_0 import EmailDetailRelayType0
+from .email_detail_relay_type_0_delivery_item import EmailDetailRelayType0DeliveryItem
 from .email_detail_repeat_type_0 import EmailDetailRepeatType0
 from .email_detail_reply import EmailDetailReply
 from .email_detail_sender_member_type_0 import EmailDetailSenderMemberType0
@@ -216,6 +218,7 @@ from .email_status import EmailStatus
 from .email_summary import EmailSummary
 from .email_summary_automation_headers_type_0 import EmailSummaryAutomationHeadersType0
 from .email_summary_awaiting import EmailSummaryAwaiting
+from .email_summary_relay_type_0 import EmailSummaryRelayType0
 from .email_summary_repeat_type_0 import EmailSummaryRepeatType0
 from .email_summary_sender_member_type_0 import EmailSummarySenderMemberType0
 from .email_webhook_status_type_1 import EmailWebhookStatusType1
@@ -858,6 +861,8 @@ __all__ = (
     "EmailDetail",
     "EmailDetailAutomationHeadersType0",
     "EmailDetailAwaiting",
+    "EmailDetailRelayType0",
+    "EmailDetailRelayType0DeliveryItem",
     "EmailDetailRepeatType0",
     "EmailDetailReply",
     "EmailDetailSenderMemberType0",
@@ -873,6 +878,7 @@ __all__ = (
     "EmailSummary",
     "EmailSummaryAutomationHeadersType0",
     "EmailSummaryAwaiting",
+    "EmailSummaryRelayType0",
     "EmailSummaryRepeatType0",
     "EmailSummarySenderMemberType0",
     "EmailWebhookStatusType1",

{primitivedotdev-2.0.0 → primitivedotdev-2.2.0}/src/primitive/api/models/email_detail.py

@@ -20,6 +20,7 @@ import datetime
 if TYPE_CHECKING:
   from ..models.email_auth import EmailAuth
   from ..models.email_detail_automation_headers_type_0 import EmailDetailAutomationHeadersType0
+  from ..models.email_detail_relay_type_0 import EmailDetailRelayType0
   from ..models.email_detail_repeat_type_0 import EmailDetailRepeatType0
   from ..models.email_detail_reply import EmailDetailReply
   from ..models.email_detail_sender_member_type_0 import EmailDetailSenderMemberType0
@@ -278,6 +279,8 @@ class EmailDetail:
                 placeholder instead of the raw text. It is never evidence of an interaction: anyone can set that header or name
                 a part that way, so it must not grant trust or select an interaction kind. Ignore it once `interaction_hint` is
                 anything other than `pending`.
+            relay (EmailDetailRelayType0 | None | Unset): Set when the message reached Primitive through a Primitive mail
+                relay. Null for other mail. The field may be absent; treat a missing value the same as null.
      """
 
     id: UUID
@@ -331,6 +334,7 @@ class EmailDetail:
     interaction_hint: str | Unset = UNSET
     interaction_kind: None | str | Unset = UNSET
     interaction_candidate: bool | Unset = UNSET
+    relay: EmailDetailRelayType0 | None | Unset = UNSET
     additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
 
 
@@ -340,6 +344,7 @@ class EmailDetail:
     def to_dict(self) -> dict[str, Any]:
         from ..models.email_auth import EmailAuth # noqa: PLC0415
         from ..models.email_detail_automation_headers_type_0 import EmailDetailAutomationHeadersType0 # noqa: PLC0415
+        from ..models.email_detail_relay_type_0 import EmailDetailRelayType0 # noqa: PLC0415
         from ..models.email_detail_repeat_type_0 import EmailDetailRepeatType0 # noqa: PLC0415
         from ..models.email_detail_reply import EmailDetailReply # noqa: PLC0415
         from ..models.email_detail_sender_member_type_0 import EmailDetailSenderMemberType0 # noqa: PLC0415
@@ -602,6 +607,14 @@ class EmailDetail:
 
         interaction_candidate = self.interaction_candidate
 
+        relay: dict[str, Any] | None | Unset
+        if isinstance(self.relay, Unset):
+            relay = UNSET
+        elif isinstance(self.relay, EmailDetailRelayType0):
+            relay = self.relay.to_dict()
+        else:
+            relay = self.relay
+
 
         field_dict: dict[str, Any] = {}
         field_dict.update(self.additional_properties)
@@ -690,6 +703,8 @@ class EmailDetail:
             field_dict["interaction_kind"] = interaction_kind
         if interaction_candidate is not UNSET:
             field_dict["interaction_candidate"] = interaction_candidate
+        if relay is not UNSET:
+            field_dict["relay"] = relay
 
         return field_dict
 
@@ -699,6 +714,7 @@ class EmailDetail:
     def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
         from ..models.email_auth import EmailAuth # noqa: PLC0415
         from ..models.email_detail_automation_headers_type_0 import EmailDetailAutomationHeadersType0 # noqa: PLC0415
+        from ..models.email_detail_relay_type_0 import EmailDetailRelayType0 # noqa: PLC0415
         from ..models.email_detail_repeat_type_0 import EmailDetailRepeatType0 # noqa: PLC0415
         from ..models.email_detail_reply import EmailDetailReply # noqa: PLC0415
         from ..models.email_detail_sender_member_type_0 import EmailDetailSenderMemberType0 # noqa: PLC0415
@@ -1225,6 +1241,26 @@ class EmailDetail:
 
         interaction_candidate = d.pop("interaction_candidate", UNSET)
 
+        def _parse_relay(data: object) -> EmailDetailRelayType0 | None | Unset:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            try:
+                if not isinstance(data, dict):
+                    raise TypeError()
+                relay_type_0 = EmailDetailRelayType0.from_dict(data)
+
+
+
+                return relay_type_0
+            except (TypeError, ValueError, AttributeError, KeyError):
+                pass
+            return cast(EmailDetailRelayType0 | None | Unset, data)
+
+        relay = _parse_relay(d.pop("relay", UNSET))
+
+
         email_detail = cls(
             id=id,
             sender=sender,
@@ -1277,6 +1313,7 @@ class EmailDetail:
             interaction_hint=interaction_hint,
             interaction_kind=interaction_kind,
             interaction_candidate=interaction_candidate,
+            relay=relay,
         )
 
 

primitivedotdev-2.2.0/src/primitive/api/models/email_detail_relay_type_0.py

@@ -0,0 +1,120 @@
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import Any, TypeVar, BinaryIO, TextIO, TYPE_CHECKING, Generator
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+from ..types import UNSET, Unset
+
+from typing import cast
+
+if TYPE_CHECKING:
+  from ..models.email_detail_relay_type_0_delivery_item import EmailDetailRelayType0DeliveryItem
+
+
+
+
+
+T = TypeVar("T", bound="EmailDetailRelayType0")
+
+
+
+@_attrs_define
+class EmailDetailRelayType0:
+    """ Set when the message reached Primitive through a Primitive mail relay. Null for other mail. The field may be absent;
+    treat a missing value the same as null.
+
+        Attributes:
+            hostname (str): The relay hostname the domain's MX record points at.
+            via (str): How the message arrived. Currently always `mail_relay`. Treat an unfamiliar value as one added after
+                your client was built.
+            delivery (list[EmailDetailRelayType0DeliveryItem] | Unset): Per-recipient outcome of the relay forwarding the
+                message to the recipient's mailbox provider. The field may be absent; treat a missing value as no delivery
+                information being available.
+     """
+
+    hostname: str
+    via: str
+    delivery: list[EmailDetailRelayType0DeliveryItem] | Unset = UNSET
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+
+
+
+
+    def to_dict(self) -> dict[str, Any]:
+        from ..models.email_detail_relay_type_0_delivery_item import EmailDetailRelayType0DeliveryItem # noqa: PLC0415
+        hostname = self.hostname
+
+        via = self.via
+
+        delivery: list[dict[str, Any]] | Unset = UNSET
+        if not isinstance(self.delivery, Unset):
+            delivery = []
+            for delivery_item_data in self.delivery:
+                delivery_item = delivery_item_data.to_dict()
+                delivery.append(delivery_item)
+
+
+
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update({
+            "hostname": hostname,
+            "via": via,
+        })
+        if delivery is not UNSET:
+            field_dict["delivery"] = delivery
+
+        return field_dict
+
+
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        from ..models.email_detail_relay_type_0_delivery_item import EmailDetailRelayType0DeliveryItem # noqa: PLC0415
+        d = dict(src_dict)
+        hostname = d.pop("hostname")
+
+        via = d.pop("via")
+
+        _delivery = d.pop("delivery", UNSET)
+        delivery: list[EmailDetailRelayType0DeliveryItem] | Unset = UNSET
+        if _delivery is not UNSET:
+            delivery = []
+            for delivery_item_data in _delivery:
+                delivery_item = EmailDetailRelayType0DeliveryItem.from_dict(delivery_item_data)
+
+
+
+                delivery.append(delivery_item)
+
+
+        email_detail_relay_type_0 = cls(
+            hostname=hostname,
+            via=via,
+            delivery=delivery,
+        )
+
+
+        email_detail_relay_type_0.additional_properties = d
+        return email_detail_relay_type_0
+
+    @property
+    def additional_keys(self) -> list[str]:
+        return list(self.additional_properties.keys())
+
+    def __getitem__(self, key: str) -> Any:
+        return self.additional_properties[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        self.additional_properties[key] = value
+
+    def __delitem__(self, key: str) -> None:
+        del self.additional_properties[key]
+
+    def __contains__(self, key: str) -> bool:
+        return key in self.additional_properties

primitivedotdev-2.2.0/src/primitive/api/models/email_detail_relay_type_0_delivery_item.py

@@ -0,0 +1,162 @@
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import Any, TypeVar, BinaryIO, TextIO, TYPE_CHECKING, Generator
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+from ..types import UNSET, Unset
+
+from typing import cast
+import datetime
+
+
+
+
+
+
+T = TypeVar("T", bound="EmailDetailRelayType0DeliveryItem")
+
+
+
+@_attrs_define
+class EmailDetailRelayType0DeliveryItem:
+    """ 
+        Attributes:
+            recipient (str): The recipient address the relay forwarded to.
+            status (str): Outcome of the forward. Currently one of `delivered`, `deferred` or `bounced`. Treat an unfamiliar
+                value as one added after your client was built.
+            at (datetime.datetime): When this outcome was recorded.
+            smtp_code (int | None | Unset): SMTP reply code from the mailbox provider, when one was received.
+            enhanced_status_code (None | str | Unset): Enhanced status code (for example `2.0.0`) from the mailbox provider,
+                when one was received.
+            smtp_response (None | str | Unset): SMTP reply text from the mailbox provider, when one was received.
+     """
+
+    recipient: str
+    status: str
+    at: datetime.datetime
+    smtp_code: int | None | Unset = UNSET
+    enhanced_status_code: None | str | Unset = UNSET
+    smtp_response: None | str | Unset = UNSET
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+
+
+
+
+    def to_dict(self) -> dict[str, Any]:
+        recipient = self.recipient
+
+        status = self.status
+
+        at = self.at.isoformat()
+
+        smtp_code: int | None | Unset
+        if isinstance(self.smtp_code, Unset):
+            smtp_code = UNSET
+        else:
+            smtp_code = self.smtp_code
+
+        enhanced_status_code: None | str | Unset
+        if isinstance(self.enhanced_status_code, Unset):
+            enhanced_status_code = UNSET
+        else:
+            enhanced_status_code = self.enhanced_status_code
+
+        smtp_response: None | str | Unset
+        if isinstance(self.smtp_response, Unset):
+            smtp_response = UNSET
+        else:
+            smtp_response = self.smtp_response
+
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update({
+            "recipient": recipient,
+            "status": status,
+            "at": at,
+        })
+        if smtp_code is not UNSET:
+            field_dict["smtp_code"] = smtp_code
+        if enhanced_status_code is not UNSET:
+            field_dict["enhanced_status_code"] = enhanced_status_code
+        if smtp_response is not UNSET:
+            field_dict["smtp_response"] = smtp_response
+
+        return field_dict
+
+
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+        recipient = d.pop("recipient")
+
+        status = d.pop("status")
+
+        at = datetime.datetime.fromisoformat(d.pop("at"))
+
+
+
+
+        def _parse_smtp_code(data: object) -> int | None | Unset:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            return cast(int | None | Unset, data)
+
+        smtp_code = _parse_smtp_code(d.pop("smtp_code", UNSET))
+
+
+        def _parse_enhanced_status_code(data: object) -> None | str | Unset:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            return cast(None | str | Unset, data)
+
+        enhanced_status_code = _parse_enhanced_status_code(d.pop("enhanced_status_code", UNSET))
+
+
+        def _parse_smtp_response(data: object) -> None | str | Unset:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            return cast(None | str | Unset, data)
+
+        smtp_response = _parse_smtp_response(d.pop("smtp_response", UNSET))
+
+
+        email_detail_relay_type_0_delivery_item = cls(
+            recipient=recipient,
+            status=status,
+            at=at,
+            smtp_code=smtp_code,
+            enhanced_status_code=enhanced_status_code,
+            smtp_response=smtp_response,
+        )
+
+
+        email_detail_relay_type_0_delivery_item.additional_properties = d
+        return email_detail_relay_type_0_delivery_item
+
+    @property
+    def additional_keys(self) -> list[str]:
+        return list(self.additional_properties.keys())
+
+    def __getitem__(self, key: str) -> Any:
+        return self.additional_properties[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        self.additional_properties[key] = value
+
+    def __delitem__(self, key: str) -> None:
+        del self.additional_properties[key]
+
+    def __contains__(self, key: str) -> bool:
+        return key in self.additional_properties

{primitivedotdev-2.0.0 → primitivedotdev-2.2.0}/src/primitive/api/models/email_search_result.py

@@ -21,6 +21,7 @@ import datetime
 if TYPE_CHECKING:
   from ..models.email_search_highlights import EmailSearchHighlights
   from ..models.email_summary_automation_headers_type_0 import EmailSummaryAutomationHeadersType0
+  from ..models.email_summary_relay_type_0 import EmailSummaryRelayType0
   from ..models.email_summary_repeat_type_0 import EmailSummaryRepeatType0
   from ..models.email_summary_sender_member_type_0 import EmailSummarySenderMemberType0
   from ..models.presence_control_type_0 import PresenceControlType0
@@ -202,6 +203,8 @@ class EmailSearchResult:
                 placeholder instead of the raw text. It is never evidence of an interaction: anyone can set that header or name
                 a part that way, so it must not grant trust or select an interaction kind. Ignore it once `interaction_hint` is
                 anything other than `pending`.
+            relay (EmailSummaryRelayType0 | None | Unset): Set when the message reached Primitive through a Primitive mail
+                relay. Null for other mail. The field may be absent; treat a missing value the same as null.
             score (float | Unset): Relevance score. Present only when sorting by relevance.
             highlights (EmailSearchHighlights | Unset):
      """
@@ -238,6 +241,7 @@ class EmailSearchResult:
     interaction_hint: str | Unset = UNSET
     interaction_kind: None | str | Unset = UNSET
     interaction_candidate: bool | Unset = UNSET
+    relay: EmailSummaryRelayType0 | None | Unset = UNSET
     score: float | Unset = UNSET
     highlights: EmailSearchHighlights | Unset = UNSET
     additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
@@ -249,6 +253,7 @@ class EmailSearchResult:
     def to_dict(self) -> dict[str, Any]:
         from ..models.email_search_highlights import EmailSearchHighlights # noqa: PLC0415
         from ..models.email_summary_automation_headers_type_0 import EmailSummaryAutomationHeadersType0 # noqa: PLC0415
+        from ..models.email_summary_relay_type_0 import EmailSummaryRelayType0 # noqa: PLC0415
         from ..models.email_summary_repeat_type_0 import EmailSummaryRepeatType0 # noqa: PLC0415
         from ..models.email_summary_sender_member_type_0 import EmailSummarySenderMemberType0 # noqa: PLC0415
         from ..models.presence_control_type_0 import PresenceControlType0 # noqa: PLC0415
@@ -392,6 +397,14 @@ class EmailSearchResult:
 
         interaction_candidate = self.interaction_candidate
 
+        relay: dict[str, Any] | None | Unset
+        if isinstance(self.relay, Unset):
+            relay = UNSET
+        elif isinstance(self.relay, EmailSummaryRelayType0):
+            relay = self.relay.to_dict()
+        else:
+            relay = self.relay
+
         score = self.score
 
         highlights: dict[str, Any] | Unset = UNSET
@@ -450,6 +463,8 @@ class EmailSearchResult:
             field_dict["interaction_kind"] = interaction_kind
         if interaction_candidate is not UNSET:
             field_dict["interaction_candidate"] = interaction_candidate
+        if relay is not UNSET:
+            field_dict["relay"] = relay
         if score is not UNSET:
             field_dict["score"] = score
         if highlights is not UNSET:
@@ -463,6 +478,7 @@ class EmailSearchResult:
     def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
         from ..models.email_search_highlights import EmailSearchHighlights # noqa: PLC0415
         from ..models.email_summary_automation_headers_type_0 import EmailSummaryAutomationHeadersType0 # noqa: PLC0415
+        from ..models.email_summary_relay_type_0 import EmailSummaryRelayType0 # noqa: PLC0415
         from ..models.email_summary_repeat_type_0 import EmailSummaryRepeatType0 # noqa: PLC0415
         from ..models.email_summary_sender_member_type_0 import EmailSummarySenderMemberType0 # noqa: PLC0415
         from ..models.presence_control_type_0 import PresenceControlType0 # noqa: PLC0415
@@ -768,6 +784,26 @@ class EmailSearchResult:
 
         interaction_candidate = d.pop("interaction_candidate", UNSET)
 
+        def _parse_relay(data: object) -> EmailSummaryRelayType0 | None | Unset:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            try:
+                if not isinstance(data, dict):
+                    raise TypeError()
+                relay_type_0 = EmailSummaryRelayType0.from_dict(data)
+
+
+
+                return relay_type_0
+            except (TypeError, ValueError, AttributeError, KeyError):
+                pass
+            return cast(EmailSummaryRelayType0 | None | Unset, data)
+
+        relay = _parse_relay(d.pop("relay", UNSET))
+
+
         score = d.pop("score", UNSET)
 
         _highlights = d.pop("highlights", UNSET)
@@ -813,6 +849,7 @@ class EmailSearchResult:
             interaction_hint=interaction_hint,
             interaction_kind=interaction_kind,
             interaction_candidate=interaction_candidate,
+            relay=relay,
             score=score,
             highlights=highlights,
         )

{primitivedotdev-2.0.0 → primitivedotdev-2.2.0}/src/primitive/api/models/email_summary.py

@@ -19,6 +19,7 @@ import datetime
 
 if TYPE_CHECKING:
   from ..models.email_summary_automation_headers_type_0 import EmailSummaryAutomationHeadersType0
+  from ..models.email_summary_relay_type_0 import EmailSummaryRelayType0
   from ..models.email_summary_repeat_type_0 import EmailSummaryRepeatType0
   from ..models.email_summary_sender_member_type_0 import EmailSummarySenderMemberType0
   from ..models.presence_control_type_0 import PresenceControlType0
@@ -195,6 +196,8 @@ class EmailSummary:
                 placeholder instead of the raw text. It is never evidence of an interaction: anyone can set that header or name
                 a part that way, so it must not grant trust or select an interaction kind. Ignore it once `interaction_hint` is
                 anything other than `pending`.
+            relay (EmailSummaryRelayType0 | None | Unset): Set when the message reached Primitive through a Primitive mail
+                relay. Null for other mail. The field may be absent; treat a missing value the same as null.
      """
 
     id: UUID
@@ -226,6 +229,7 @@ class EmailSummary:
     interaction_hint: str | Unset = UNSET
     interaction_kind: None | str | Unset = UNSET
     interaction_candidate: bool | Unset = UNSET
+    relay: EmailSummaryRelayType0 | None | Unset = UNSET
     additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
 
 
@@ -234,6 +238,7 @@ class EmailSummary:
 
     def to_dict(self) -> dict[str, Any]:
         from ..models.email_summary_automation_headers_type_0 import EmailSummaryAutomationHeadersType0 # noqa: PLC0415
+        from ..models.email_summary_relay_type_0 import EmailSummaryRelayType0 # noqa: PLC0415
         from ..models.email_summary_repeat_type_0 import EmailSummaryRepeatType0 # noqa: PLC0415
         from ..models.email_summary_sender_member_type_0 import EmailSummarySenderMemberType0 # noqa: PLC0415
         from ..models.presence_control_type_0 import PresenceControlType0 # noqa: PLC0415
@@ -373,6 +378,14 @@ class EmailSummary:
 
         interaction_candidate = self.interaction_candidate
 
+        relay: dict[str, Any] | None | Unset
+        if isinstance(self.relay, Unset):
+            relay = UNSET
+        elif isinstance(self.relay, EmailSummaryRelayType0):
+            relay = self.relay.to_dict()
+        else:
+            relay = self.relay
+
 
         field_dict: dict[str, Any] = {}
         field_dict.update(self.additional_properties)
@@ -423,6 +436,8 @@ class EmailSummary:
             field_dict["interaction_kind"] = interaction_kind
         if interaction_candidate is not UNSET:
             field_dict["interaction_candidate"] = interaction_candidate
+        if relay is not UNSET:
+            field_dict["relay"] = relay
 
         return field_dict
 
@@ -431,6 +446,7 @@ class EmailSummary:
     @classmethod
     def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
         from ..models.email_summary_automation_headers_type_0 import EmailSummaryAutomationHeadersType0 # noqa: PLC0415
+        from ..models.email_summary_relay_type_0 import EmailSummaryRelayType0 # noqa: PLC0415
         from ..models.email_summary_repeat_type_0 import EmailSummaryRepeatType0 # noqa: PLC0415
         from ..models.email_summary_sender_member_type_0 import EmailSummarySenderMemberType0 # noqa: PLC0415
         from ..models.presence_control_type_0 import PresenceControlType0 # noqa: PLC0415
@@ -729,6 +745,26 @@ class EmailSummary:
 
         interaction_candidate = d.pop("interaction_candidate", UNSET)
 
+        def _parse_relay(data: object) -> EmailSummaryRelayType0 | None | Unset:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            try:
+                if not isinstance(data, dict):
+                    raise TypeError()
+                relay_type_0 = EmailSummaryRelayType0.from_dict(data)
+
+
+
+                return relay_type_0
+            except (TypeError, ValueError, AttributeError, KeyError):
+                pass
+            return cast(EmailSummaryRelayType0 | None | Unset, data)
+
+        relay = _parse_relay(d.pop("relay", UNSET))
+
+
         email_summary = cls(
             id=id,
             status=status,
@@ -759,6 +795,7 @@ class EmailSummary:
             interaction_hint=interaction_hint,
             interaction_kind=interaction_kind,
             interaction_candidate=interaction_candidate,
+            relay=relay,
         )