primitivedotdev 2.1.0__tar.gz → 2.2.0__tar.gz

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

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

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

@@ -202,6 +202,7 @@ 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
@@ -861,6 +862,7 @@ __all__ = (
     "EmailDetailAutomationHeadersType0",
     "EmailDetailAwaiting",
     "EmailDetailRelayType0",
+    "EmailDetailRelayType0DeliveryItem",
     "EmailDetailRepeatType0",
     "EmailDetailReply",
     "EmailDetailSenderMemberType0",

{primitivedotdev-2.1.0 → primitivedotdev-2.2.0}/src/primitive/api/models/email_detail_relay_type_0.py

@@ -8,7 +8,10 @@ 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
 
 
 
@@ -27,10 +30,14 @@ class EmailDetailRelayType0:
             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)
 
 
@@ -38,10 +45,20 @@ class EmailDetailRelayType0:
 
 
     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)
@@ -49,6 +66,8 @@ class EmailDetailRelayType0:
             "hostname": hostname,
             "via": via,
         })
+        if delivery is not UNSET:
+            field_dict["delivery"] = delivery
 
         return field_dict
 
@@ -56,14 +75,28 @@ class EmailDetailRelayType0:
 
     @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,
         )
 
 

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.1.0 → primitivedotdev-2.2.0}/tests/test_email_detail.py

@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+import datetime
+
 # Round-trip test that pins the new fields on EmailDetail (replies,
 # from_known_address, sender_connected_agent_verified, body_text, body_html). A future regen that
 # drops one of these fields would silently break the SDK contract;
@@ -7,8 +9,11 @@ from __future__ import annotations
 from primitive.api.models.email_detail import EmailDetail
 from primitive.api.models.email_detail_awaiting import EmailDetailAwaiting
 from primitive.api.models.email_detail_relay_type_0 import EmailDetailRelayType0
+from primitive.api.models.email_detail_relay_type_0_delivery_item import (
+    EmailDetailRelayType0DeliveryItem,
+)
 from primitive.api.models.email_detail_reply import EmailDetailReply
-from primitive.api.types import UNSET
+from primitive.api.types import UNSET, Unset
 
 SAMPLE = {
     "id": "00000000-0000-0000-0000-000000000001",
@@ -175,3 +180,57 @@ def test_email_detail_relay_is_optional_and_nullable() -> None:
         "hostname": "relay.example.com",
         "via": "mail_relay",
     }
+
+
+def test_email_detail_relay_delivery_is_optional() -> None:
+    relay = {"hostname": "relay.example.com", "via": "mail_relay"}
+
+    without = EmailDetail.from_dict({**SAMPLE, "relay": relay})
+    assert isinstance(without.relay, EmailDetailRelayType0)
+    assert without.relay.delivery is UNSET
+    assert "delivery" not in without.to_dict()["relay"]
+
+    null = EmailDetail.from_dict({**SAMPLE, "relay": None})
+    assert null.relay is None
+
+    delivery = [
+        {
+            "recipient": "alice@example.org",
+            "status": "delivered",
+            "smtp_code": 250,
+            "enhanced_status_code": "2.0.0",
+            "smtp_response": "250 2.0.0 OK",
+            "at": "2026-05-03T00:00:01Z",
+        },
+        {
+            # An unfamiliar status parses: status is an open string.
+            "recipient": "bob@example.org",
+            "status": "quarantined",
+            "smtp_code": None,
+            "enhanced_status_code": None,
+            "smtp_response": None,
+            "at": "2026-05-03T00:00:02+00:00",
+        },
+    ]
+    withd = EmailDetail.from_dict({**SAMPLE, "relay": {**relay, "delivery": delivery}})
+    assert isinstance(withd.relay, EmailDetailRelayType0)
+    items = withd.relay.delivery
+    assert not isinstance(items, Unset)
+    assert len(items) == 2
+    first, second = items
+    assert isinstance(first, EmailDetailRelayType0DeliveryItem)
+    assert first.recipient == "alice@example.org"
+    assert first.status == "delivered"
+    assert first.smtp_code == 250
+    assert first.enhanced_status_code == "2.0.0"
+    assert first.smtp_response == "250 2.0.0 OK"
+    assert first.at == datetime.datetime(2026, 5, 3, 0, 0, 1, tzinfo=datetime.UTC)
+    assert second.status == "quarantined"
+    assert second.smtp_code is None
+    assert second.enhanced_status_code is None
+    assert second.smtp_response is None
+
+    serialized = withd.to_dict()["relay"]["delivery"]
+    assert serialized[0]["status"] == "delivered"
+    assert serialized[1]["status"] == "quarantined"
+    assert serialized[1]["smtp_code"] is None