primitivedotdev 0.3.0__tar.gz → 0.4.0__tar.gz

{primitivedotdev-0.3.0 → primitivedotdev-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: primitivedotdev
-Version: 0.3.0
+Version: 0.4.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-0.3.0 → primitivedotdev-0.4.0}/pyproject.toml

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

{primitivedotdev-0.3.0 → primitivedotdev-0.4.0}/src/primitive/api/api/domains/add_domain.py

@@ -64,6 +64,13 @@ def _parse_response(*, client: AuthenticatedClient | Client, response: httpx.Res
 
         return response_401
 
+    if response.status_code == 409:
+        response_409 = ErrorResponse.from_dict(response.json())
+
+
+
+        return response_409
+
     if client.raise_on_unexpected_status:
         raise errors.UnexpectedStatus(response.status_code, response.content)
     else:

{primitivedotdev-0.3.0 → primitivedotdev-0.4.0}/src/primitive/api/api/emails/replay_email_webhooks.py

@@ -64,6 +64,13 @@ def _parse_response(*, client: AuthenticatedClient | Client, response: httpx.Res
 
         return response_404
 
+    if response.status_code == 429:
+        response_429 = ErrorResponse.from_dict(response.json())
+
+
+
+        return response_429
+
     if client.raise_on_unexpected_status:
         raise errors.UnexpectedStatus(response.status_code, response.content)
     else:
@@ -88,8 +95,10 @@ def sync_detailed(
     """ Replay email webhooks
 
      Re-delivers the webhook payload for this email to all active
-    endpoints matching the email's domain. Includes rate limiting
-    to prevent stampeding.
+    endpoints matching the email's domain. Rate limited per-email
+    (short cooldown between successive replays of the same email)
+    and per-org (burst + sustained windows), sharing an org-wide
+    budget with delivery replays.
 
     Args:
         id (UUID):
@@ -123,8 +132,10 @@ def sync(
     """ Replay email webhooks
 
      Re-delivers the webhook payload for this email to all active
-    endpoints matching the email's domain. Includes rate limiting
-    to prevent stampeding.
+    endpoints matching the email's domain. Rate limited per-email
+    (short cooldown between successive replays of the same email)
+    and per-org (burst + sustained windows), sharing an org-wide
+    budget with delivery replays.
 
     Args:
         id (UUID):
@@ -153,8 +164,10 @@ async def asyncio_detailed(
     """ Replay email webhooks
 
      Re-delivers the webhook payload for this email to all active
-    endpoints matching the email's domain. Includes rate limiting
-    to prevent stampeding.
+    endpoints matching the email's domain. Rate limited per-email
+    (short cooldown between successive replays of the same email)
+    and per-org (burst + sustained windows), sharing an org-wide
+    budget with delivery replays.
 
     Args:
         id (UUID):
@@ -188,8 +201,10 @@ async def asyncio(
     """ Replay email webhooks
 
      Re-delivers the webhook payload for this email to all active
-    endpoints matching the email's domain. Includes rate limiting
-    to prevent stampeding.
+    endpoints matching the email's domain. Rate limited per-email
+    (short cooldown between successive replays of the same email)
+    and per-org (burst + sustained windows), sharing an org-wide
+    budget with delivery replays.
 
     Args:
         id (UUID):

{primitivedotdev-0.3.0 → primitivedotdev-0.4.0}/src/primitive/api/api/webhook_deliveries/replay_delivery.py

@@ -63,6 +63,13 @@ def _parse_response(*, client: AuthenticatedClient | Client, response: httpx.Res
 
         return response_404
 
+    if response.status_code == 429:
+        response_429 = ErrorResponse.from_dict(response.json())
+
+
+
+        return response_429
+
     if client.raise_on_unexpected_status:
         raise errors.UnexpectedStatus(response.status_code, response.content)
     else:
@@ -88,8 +95,9 @@ def sync_detailed(
 
      Re-sends the stored webhook payload from a previous delivery attempt.
     If the original endpoint is still active, it is targeted. If the
-    original endpoint was deleted, the first active endpoint is used.
-    Deactivated endpoints cannot be replayed to.
+    original endpoint was deleted, the oldest active endpoint is used.
+    Deactivated endpoints cannot be replayed to. Rate limited per-org,
+    sharing an org-wide budget with email replays.
 
     Args:
         id (str):
@@ -124,8 +132,9 @@ def sync(
 
      Re-sends the stored webhook payload from a previous delivery attempt.
     If the original endpoint is still active, it is targeted. If the
-    original endpoint was deleted, the first active endpoint is used.
-    Deactivated endpoints cannot be replayed to.
+    original endpoint was deleted, the oldest active endpoint is used.
+    Deactivated endpoints cannot be replayed to. Rate limited per-org,
+    sharing an org-wide budget with email replays.
 
     Args:
         id (str):
@@ -155,8 +164,9 @@ async def asyncio_detailed(
 
      Re-sends the stored webhook payload from a previous delivery attempt.
     If the original endpoint is still active, it is targeted. If the
-    original endpoint was deleted, the first active endpoint is used.
-    Deactivated endpoints cannot be replayed to.
+    original endpoint was deleted, the oldest active endpoint is used.
+    Deactivated endpoints cannot be replayed to. Rate limited per-org,
+    sharing an org-wide budget with email replays.
 
     Args:
         id (str):
@@ -191,8 +201,9 @@ async def asyncio(
 
      Re-sends the stored webhook payload from a previous delivery attempt.
     If the original endpoint is still active, it is targeted. If the
-    original endpoint was deleted, the first active endpoint is used.
-    Deactivated endpoints cannot be replayed to.
+    original endpoint was deleted, the oldest active endpoint is used.
+    Deactivated endpoints cannot be replayed to. Rate limited per-org,
+    sharing an org-wide budget with email replays.
 
     Args:
         id (str):

{primitivedotdev-0.3.0 → primitivedotdev-0.4.0}/src/primitive/api/models/__init__.py

@@ -38,6 +38,8 @@ from .endpoint_rules import EndpointRules
 from .error_response import ErrorResponse
 from .error_response_error import ErrorResponseError
 from .error_response_error_code import ErrorResponseErrorCode
+from .error_response_error_details import ErrorResponseErrorDetails
+from .error_response_error_details_mx_conflict import ErrorResponseErrorDetailsMxConflict
 from .filter_ import Filter
 from .filter_type import FilterType
 from .get_account_response_200 import GetAccountResponse200
@@ -114,6 +116,8 @@ __all__ = (
     "ErrorResponse",
     "ErrorResponseError",
     "ErrorResponseErrorCode",
+    "ErrorResponseErrorDetails",
+    "ErrorResponseErrorDetailsMxConflict",
     "Filter",
     "FilterType",
     "GetAccountResponse200",

{primitivedotdev-0.3.0 → primitivedotdev-0.4.0}/src/primitive/api/models/error_response_error.py

@@ -9,7 +9,10 @@ from attrs import field as _attrs_field
 from ..types import UNSET, Unset
 
 from ..models.error_response_error_code import ErrorResponseErrorCode
+from typing import cast
 
+if TYPE_CHECKING:
+  from ..models.error_response_error_details import ErrorResponseErrorDetails
 
 
 
@@ -25,10 +28,14 @@ class ErrorResponseError:
         Attributes:
             code (ErrorResponseErrorCode):
             message (str):
+            details (ErrorResponseErrorDetails | Unset): Optional structured data that callers can inspect to recover
+                from the error. The fields present depend on `code`. Additional
+                keys may be added over time without a major-version bump.
      """
 
     code: ErrorResponseErrorCode
     message: str
+    details: ErrorResponseErrorDetails | Unset = UNSET
     additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
 
 
@@ -36,10 +43,15 @@ class ErrorResponseError:
 
 
     def to_dict(self) -> dict[str, Any]:
+        from ..models.error_response_error_details import ErrorResponseErrorDetails
         code = self.code.value
 
         message = self.message
 
+        details: dict[str, Any] | Unset = UNSET
+        if not isinstance(self.details, Unset):
+            details = self.details.to_dict()
+
 
         field_dict: dict[str, Any] = {}
         field_dict.update(self.additional_properties)
@@ -47,6 +59,8 @@ class ErrorResponseError:
             "code": code,
             "message": message,
         })
+        if details is not UNSET:
+            field_dict["details"] = details
 
         return field_dict
 
@@ -54,6 +68,7 @@ class ErrorResponseError:
 
     @classmethod
     def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        from ..models.error_response_error_details import ErrorResponseErrorDetails
         d = dict(src_dict)
         code = ErrorResponseErrorCode(d.pop("code"))
 
@@ -62,9 +77,20 @@ class ErrorResponseError:
 
         message = d.pop("message")
 
+        _details = d.pop("details", UNSET)
+        details: ErrorResponseErrorDetails | Unset
+        if isinstance(_details,  Unset):
+            details = UNSET
+        else:
+            details = ErrorResponseErrorDetails.from_dict(_details)
+
+
+
+
         error_response_error = cls(
             code=code,
             message=message,
+            details=details,
         )
 
 

{primitivedotdev-0.3.0 → primitivedotdev-0.4.0}/src/primitive/api/models/error_response_error_code.py

@@ -1,8 +1,10 @@
 from enum import Enum
 
 class ErrorResponseErrorCode(str, Enum):
+    CONFLICT = "conflict"
     FORBIDDEN = "forbidden"
     INTERNAL_ERROR = "internal_error"
+    MX_CONFLICT = "mx_conflict"
     NOT_FOUND = "not_found"
     RATE_LIMIT_EXCEEDED = "rate_limit_exceeded"
     UNAUTHORIZED = "unauthorized"

primitivedotdev-0.4.0/src/primitive/api/models/error_response_error_details.py

@@ -0,0 +1,95 @@
+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.error_response_error_details_mx_conflict import ErrorResponseErrorDetailsMxConflict
+
+
+
+
+
+T = TypeVar("T", bound="ErrorResponseErrorDetails")
+
+
+
+@_attrs_define
+class ErrorResponseErrorDetails:
+    """ Optional structured data that callers can inspect to recover
+    from the error. The fields present depend on `code`. Additional
+    keys may be added over time without a major-version bump.
+
+        Attributes:
+            mx_conflict (ErrorResponseErrorDetailsMxConflict | Unset): Present when `code == mx_conflict`.
+     """
+
+    mx_conflict: ErrorResponseErrorDetailsMxConflict | Unset = UNSET
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+
+
+
+
+    def to_dict(self) -> dict[str, Any]:
+        from ..models.error_response_error_details_mx_conflict import ErrorResponseErrorDetailsMxConflict
+        mx_conflict: dict[str, Any] | Unset = UNSET
+        if not isinstance(self.mx_conflict, Unset):
+            mx_conflict = self.mx_conflict.to_dict()
+
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update({
+        })
+        if mx_conflict is not UNSET:
+            field_dict["mx_conflict"] = mx_conflict
+
+        return field_dict
+
+
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        from ..models.error_response_error_details_mx_conflict import ErrorResponseErrorDetailsMxConflict
+        d = dict(src_dict)
+        _mx_conflict = d.pop("mx_conflict", UNSET)
+        mx_conflict: ErrorResponseErrorDetailsMxConflict | Unset
+        if isinstance(_mx_conflict,  Unset):
+            mx_conflict = UNSET
+        else:
+            mx_conflict = ErrorResponseErrorDetailsMxConflict.from_dict(_mx_conflict)
+
+
+
+
+        error_response_error_details = cls(
+            mx_conflict=mx_conflict,
+        )
+
+
+        error_response_error_details.additional_properties = d
+        return error_response_error_details
+
+    @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-0.4.0/src/primitive/api/models/error_response_error_details_mx_conflict.py

@@ -0,0 +1,85 @@
+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="ErrorResponseErrorDetailsMxConflict")
+
+
+
+@_attrs_define
+class ErrorResponseErrorDetailsMxConflict:
+    """ Present when `code == mx_conflict`.
+
+        Attributes:
+            provider_name (str): Human-readable name of the detected mailbox provider (e.g. "Google Workspace").
+            suggested_subdomain (str): Subdomain to try instead (e.g. "mail" for `mail.example.com`).
+     """
+
+    provider_name: str
+    suggested_subdomain: str
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+
+
+
+
+    def to_dict(self) -> dict[str, Any]:
+        provider_name = self.provider_name
+
+        suggested_subdomain = self.suggested_subdomain
+
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update({
+            "provider_name": provider_name,
+            "suggested_subdomain": suggested_subdomain,
+        })
+
+        return field_dict
+
+
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+        provider_name = d.pop("provider_name")
+
+        suggested_subdomain = d.pop("suggested_subdomain")
+
+        error_response_error_details_mx_conflict = cls(
+            provider_name=provider_name,
+            suggested_subdomain=suggested_subdomain,
+        )
+
+
+        error_response_error_details_mx_conflict.additional_properties = d
+        return error_response_error_details_mx_conflict
+
+    @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