primitivedotdev 2.0.0__tar.gz → 2.1.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: primitivedotdev
-Version: 2.0.0
+Version: 2.1.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.1.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.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "primitivedotdev"
-version = "2.0.0"
+version = "2.1.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.1.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.1.0}/src/primitive/api/models/__init__.py

@@ -201,6 +201,7 @@ 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_repeat_type_0 import EmailDetailRepeatType0
 from .email_detail_reply import EmailDetailReply
 from .email_detail_sender_member_type_0 import EmailDetailSenderMemberType0
@@ -216,6 +217,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 +860,7 @@ __all__ = (
     "EmailDetail",
     "EmailDetailAutomationHeadersType0",
     "EmailDetailAwaiting",
+    "EmailDetailRelayType0",
     "EmailDetailRepeatType0",
     "EmailDetailReply",
     "EmailDetailSenderMemberType0",
@@ -873,6 +876,7 @@ __all__ = (
     "EmailSummary",
     "EmailSummaryAutomationHeadersType0",
     "EmailSummaryAwaiting",
+    "EmailSummaryRelayType0",
     "EmailSummaryRepeatType0",
     "EmailSummarySenderMemberType0",
     "EmailWebhookStatusType1",

{primitivedotdev-2.0.0 → primitivedotdev-2.1.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.1.0/src/primitive/api/models/email_detail_relay_type_0.py

@@ -0,0 +1,87 @@
+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
+
+
+
+
+
+
+
+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.
+     """
+
+    hostname: str
+    via: str
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+
+
+
+
+    def to_dict(self) -> dict[str, Any]:
+        hostname = self.hostname
+
+        via = self.via
+
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update({
+            "hostname": hostname,
+            "via": via,
+        })
+
+        return field_dict
+
+
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+        hostname = d.pop("hostname")
+
+        via = d.pop("via")
+
+        email_detail_relay_type_0 = cls(
+            hostname=hostname,
+            via=via,
+        )
+
+
+        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.0.0 → primitivedotdev-2.1.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.1.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,
         )
 
 

primitivedotdev-2.1.0/src/primitive/api/models/email_summary_relay_type_0.py

@@ -0,0 +1,87 @@
+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
+
+
+
+
+
+
+
+T = TypeVar("T", bound="EmailSummaryRelayType0")
+
+
+
+@_attrs_define
+class EmailSummaryRelayType0:
+    """ 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.
+     """
+
+    hostname: str
+    via: str
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+
+
+
+
+    def to_dict(self) -> dict[str, Any]:
+        hostname = self.hostname
+
+        via = self.via
+
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update({
+            "hostname": hostname,
+            "via": via,
+        })
+
+        return field_dict
+
+
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+        hostname = d.pop("hostname")
+
+        via = d.pop("via")
+
+        email_summary_relay_type_0 = cls(
+            hostname=hostname,
+            via=via,
+        )
+
+
+        email_summary_relay_type_0.additional_properties = d
+        return email_summary_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.0.0 → primitivedotdev-2.1.0}/src/primitive/models_generated.py

@@ -173,6 +173,21 @@ class Download(BaseModel):
     ]
 
 
+class EmailRelay(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    hostname: Annotated[
+        str, Field(description="The relay hostname the domain's MX record points at.")
+    ]
+    via: Annotated[
+        str,
+        Field(
+            description="How the message arrived. Currently always `mail_relay`. Treat an unfamiliar value as one added after your client was built."
+        ),
+    ]
+
+
 class Outcome(StrEnum):
     matched = "matched"
     defaulted = "defaulted"
@@ -1164,6 +1179,12 @@ class Email(BaseModel):
     auth: Annotated[
         EmailAuth, Field(description="Email authentication results (SPF, DKIM, DMARC).")
     ]
+    relay: Annotated[
+        EmailRelay | None,
+        Field(
+            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."
+        ),
+    ] = None
 
 
 class EmailReceivedEvent(BaseModel):

{primitivedotdev-2.0.0 → primitivedotdev-2.1.0}/src/primitive/schemas/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.1.0}/src/primitive/types.py

@@ -48,6 +48,9 @@ from .models_generated import (
 from .models_generated import (
     EmailReceivedEvent as GeneratedEmailReceivedEvent,
 )
+from .models_generated import (
+    EmailRelay as GeneratedEmailRelay,
+)
 from .models_generated import (
     ForwardAnalysis as GeneratedForwardAnalysis,
 )
@@ -146,6 +149,7 @@ ForwardResultAttachmentSkipped = GeneratedForwardResultAttachmentSkipped
 ForwardOriginalSender = GeneratedForwardOriginalSender
 ForwardVerification = GeneratedForwardVerification
 EmailAuth = GeneratedEmailAuth
+EmailRelay = GeneratedEmailRelay
 DkimSignature = GeneratedDkimSignature