truagents 0.0.0.dev0__py3-none-any.whl

truagents/generated/models/email_unsubscribe_item.py

@@ -0,0 +1,50 @@
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import Any, TypeVar
+
+from attrs import define as _attrs_define
+
+T = TypeVar("T", bound="EmailUnsubscribeItem")
+
+
+@_attrs_define
+class EmailUnsubscribeItem:
+    """
+    Attributes:
+        email (str):
+        unsubscribed (bool): `true` to opt-out, `false` to opt-in.
+    """
+
+    email: str
+    unsubscribed: bool
+
+    def to_dict(self) -> dict[str, Any]:
+        email = self.email
+
+        unsubscribed = self.unsubscribed
+
+        field_dict: dict[str, Any] = {}
+
+        field_dict.update(
+            {
+                "email": email,
+                "unsubscribed": unsubscribed,
+            }
+        )
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+        email = d.pop("email")
+
+        unsubscribed = d.pop("unsubscribed")
+
+        email_unsubscribe_item = cls(
+            email=email,
+            unsubscribed=unsubscribed,
+        )
+
+        return email_unsubscribe_item

truagents/generated/models/email_unsubscribe_list_response.py

@@ -0,0 +1,113 @@
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import TYPE_CHECKING, Any, TypeVar, cast
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+if TYPE_CHECKING:
+    from ..models.email_unsubscribe_record import EmailUnsubscribeRecord
+
+
+T = TypeVar("T", bound="EmailUnsubscribeListResponse")
+
+
+@_attrs_define
+class EmailUnsubscribeListResponse:
+    """
+    Example:
+        {'org_slug': 'acme-corp', 'data': [{'email': 'john@example.com', 'unsubscribed': True, 'source': 'external_api',
+            'updated_at': '2026-04-15T10:30:00Z'}, {'email': 'alice@example.com', 'unsubscribed': False, 'source': 'admin',
+            'updated_at': '2026-04-13T09:00:00Z'}], 'next_cursor':
+            'eyJvcmciOiJhY21lLWNvcnAiLCJ0cyI6IjIwMjYtMDQtMTNUMDk6MDA6MDBaIn0', 'has_more': True}
+
+    Attributes:
+        org_slug (str): Organization this page belongs to — the value you supplied, the one carried by `cursor`, or your
+            key's default organization when neither was provided. Example: acme-corp.
+        data (list[EmailUnsubscribeRecord]):
+        next_cursor (None | str): Pass to the `cursor` query parameter to fetch the next page. `null` when no more
+            results are available. See the `Cursor` parameter for the encoding contract.
+        has_more (bool):
+    """
+
+    org_slug: str
+    data: list[EmailUnsubscribeRecord]
+    next_cursor: None | str
+    has_more: bool
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        org_slug = self.org_slug
+
+        data = []
+        for data_item_data in self.data:
+            data_item = data_item_data.to_dict()
+            data.append(data_item)
+
+        next_cursor: None | str
+        next_cursor = self.next_cursor
+
+        has_more = self.has_more
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "org_slug": org_slug,
+                "data": data,
+                "next_cursor": next_cursor,
+                "has_more": has_more,
+            }
+        )
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        from ..models.email_unsubscribe_record import EmailUnsubscribeRecord
+
+        d = dict(src_dict)
+        org_slug = d.pop("org_slug")
+
+        data = []
+        _data = d.pop("data")
+        for data_item_data in _data:
+            data_item = EmailUnsubscribeRecord.from_dict(data_item_data)
+
+            data.append(data_item)
+
+        def _parse_next_cursor(data: object) -> None | str:
+            if data is None:
+                return data
+            return cast(None | str, data)
+
+        next_cursor = _parse_next_cursor(d.pop("next_cursor"))
+
+        has_more = d.pop("has_more")
+
+        email_unsubscribe_list_response = cls(
+            org_slug=org_slug,
+            data=data,
+            next_cursor=next_cursor,
+            has_more=has_more,
+        )
+
+        email_unsubscribe_list_response.additional_properties = d
+        return email_unsubscribe_list_response
+
+    @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

truagents/generated/models/email_unsubscribe_record.py

@@ -0,0 +1,98 @@
+from __future__ import annotations
+
+import datetime
+from collections.abc import Mapping
+from typing import Any, TypeVar
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+from ..models.email_source_enum import EmailSourceEnum
+
+T = TypeVar("T", bound="EmailUnsubscribeRecord")
+
+
+@_attrs_define
+class EmailUnsubscribeRecord:
+    """
+    Example:
+        {'email': 'john@example.com', 'unsubscribed': True, 'source': 'external_api', 'updated_at':
+            '2026-04-15T10:30:00Z'}
+
+    Attributes:
+        email (str): Email address, normalized to lowercase canonical form.
+        unsubscribed (bool): `true` = opted out (TruAgents will not send on this channel).
+        source (EmailSourceEnum): The category of writer responsible for the row's most recent state change on the email
+            channel.
+
+            - `external_api` — pushed by the partner via this API.
+            - `sendgrid` — derived from a SendGrid unsubscribe event.
+            - `admin` — manually changed by a TruAgents administrator.
+            - `import` — created during initial backfill from legacy per-contact flags.
+        updated_at (datetime.datetime): ISO 8601 timestamp of the most recent state change.
+    """
+
+    email: str
+    unsubscribed: bool
+    source: EmailSourceEnum
+    updated_at: datetime.datetime
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        email = self.email
+
+        unsubscribed = self.unsubscribed
+
+        source = self.source.value
+
+        updated_at = self.updated_at.isoformat()
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "email": email,
+                "unsubscribed": unsubscribed,
+                "source": source,
+                "updated_at": updated_at,
+            }
+        )
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+        email = d.pop("email")
+
+        unsubscribed = d.pop("unsubscribed")
+
+        source = EmailSourceEnum(d.pop("source"))
+
+        updated_at = datetime.datetime.fromisoformat(d.pop("updated_at"))
+
+        email_unsubscribe_record = cls(
+            email=email,
+            unsubscribed=unsubscribed,
+            source=source,
+            updated_at=updated_at,
+        )
+
+        email_unsubscribe_record.additional_properties = d
+        return email_unsubscribe_record
+
+    @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

truagents/generated/models/email_unsubscribe_updated_entry.py

@@ -0,0 +1,79 @@
+from __future__ import annotations
+
+import datetime
+from collections.abc import Mapping
+from typing import Any, TypeVar
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+T = TypeVar("T", bound="EmailUnsubscribeUpdatedEntry")
+
+
+@_attrs_define
+class EmailUnsubscribeUpdatedEntry:
+    """
+    Attributes:
+        email (str): Echoed from the input item.
+        unsubscribed (bool): Echoed from the input item.
+        updated_at (datetime.datetime): Row's current state-change timestamp. Compare against a previously-observed
+            value for the same identifier to distinguish a real state change from an idempotent no-op.
+    """
+
+    email: str
+    unsubscribed: bool
+    updated_at: datetime.datetime
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        email = self.email
+
+        unsubscribed = self.unsubscribed
+
+        updated_at = self.updated_at.isoformat()
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "email": email,
+                "unsubscribed": unsubscribed,
+                "updated_at": updated_at,
+            }
+        )
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+        email = d.pop("email")
+
+        unsubscribed = d.pop("unsubscribed")
+
+        updated_at = datetime.datetime.fromisoformat(d.pop("updated_at"))
+
+        email_unsubscribe_updated_entry = cls(
+            email=email,
+            unsubscribed=unsubscribed,
+            updated_at=updated_at,
+        )
+
+        email_unsubscribe_updated_entry.additional_properties = d
+        return email_unsubscribe_updated_entry
+
+    @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

truagents/generated/models/o_auth_client_credentials_request.py

@@ -0,0 +1,87 @@
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import Any, TypeVar
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+from ..models.o_auth_client_credentials_request_grant_type import (
+    OAuthClientCredentialsRequestGrantType,
+)
+from ..types import UNSET, Unset
+
+T = TypeVar("T", bound="OAuthClientCredentialsRequest")
+
+
+@_attrs_define
+class OAuthClientCredentialsRequest:
+    """Initial-authentication grant. Credentials may be sent via HTTP Basic (preferred) or as body fields. Per RFC 6749
+    §2.3.1, both `client_id` and `client_secret` must be provided together when not using HTTP Basic.
+
+        Attributes:
+            grant_type (OAuthClientCredentialsRequestGrantType):
+            client_id (str | Unset): Opaque client identifier. Required when credentials are not sent via HTTP Basic.
+            client_secret (str | Unset): Plaintext client secret (prefixed `tru_cs_`). Required when credentials are not
+                sent via HTTP Basic.
+    """
+
+    grant_type: OAuthClientCredentialsRequestGrantType
+    client_id: str | Unset = UNSET
+    client_secret: str | Unset = UNSET
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        grant_type = self.grant_type.value
+
+        client_id = self.client_id
+
+        client_secret = self.client_secret
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "grant_type": grant_type,
+            }
+        )
+        if client_id is not UNSET:
+            field_dict["client_id"] = client_id
+        if client_secret is not UNSET:
+            field_dict["client_secret"] = client_secret
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+        grant_type = OAuthClientCredentialsRequestGrantType(d.pop("grant_type"))
+
+        client_id = d.pop("client_id", UNSET)
+
+        client_secret = d.pop("client_secret", UNSET)
+
+        o_auth_client_credentials_request = cls(
+            grant_type=grant_type,
+            client_id=client_id,
+            client_secret=client_secret,
+        )
+
+        o_auth_client_credentials_request.additional_properties = d
+        return o_auth_client_credentials_request
+
+    @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

truagents/generated/models/o_auth_client_credentials_request_grant_type.py

@@ -0,0 +1,8 @@
+from enum import Enum
+
+
+class OAuthClientCredentialsRequestGrantType(str, Enum):
+    CLIENT_CREDENTIALS = "client_credentials"
+
+    def __str__(self) -> str:
+        return str(self.value)

truagents/generated/models/o_auth_error_response.py

@@ -0,0 +1,83 @@
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import Any, TypeVar
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+from ..models.o_auth_error_response_error import OAuthErrorResponseError
+from ..types import UNSET, Unset
+
+T = TypeVar("T", bound="OAuthErrorResponse")
+
+
+@_attrs_define
+class OAuthErrorResponse:
+    """RFC 6749 §5.2 error envelope.
+
+    Attributes:
+        error (OAuthErrorResponseError): Machine-readable error code.
+        error_description (str | Unset): Human-readable description suitable for logging.
+        error_uri (str | Unset): Optional URI to a page describing the error.
+    """
+
+    error: OAuthErrorResponseError
+    error_description: str | Unset = UNSET
+    error_uri: str | Unset = UNSET
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        error = self.error.value
+
+        error_description = self.error_description
+
+        error_uri = self.error_uri
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "error": error,
+            }
+        )
+        if error_description is not UNSET:
+            field_dict["error_description"] = error_description
+        if error_uri is not UNSET:
+            field_dict["error_uri"] = error_uri
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+        error = OAuthErrorResponseError(d.pop("error"))
+
+        error_description = d.pop("error_description", UNSET)
+
+        error_uri = d.pop("error_uri", UNSET)
+
+        o_auth_error_response = cls(
+            error=error,
+            error_description=error_description,
+            error_uri=error_uri,
+        )
+
+        o_auth_error_response.additional_properties = d
+        return o_auth_error_response
+
+    @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

truagents/generated/models/o_auth_error_response_error.py

@@ -0,0 +1,11 @@
+from enum import Enum
+
+
+class OAuthErrorResponseError(str, Enum):
+    INVALID_CLIENT = "invalid_client"
+    INVALID_GRANT = "invalid_grant"
+    INVALID_REQUEST = "invalid_request"
+    UNSUPPORTED_GRANT_TYPE = "unsupported_grant_type"
+
+    def __str__(self) -> str:
+        return str(self.value)

truagents/generated/models/o_auth_refresh_token_request.py

@@ -0,0 +1,75 @@
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import Any, TypeVar
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+from ..models.o_auth_refresh_token_request_grant_type import (
+    OAuthRefreshTokenRequestGrantType,
+)
+
+T = TypeVar("T", bound="OAuthRefreshTokenRequest")
+
+
+@_attrs_define
+class OAuthRefreshTokenRequest:
+    """Refresh grant. The supplied `refresh_token` is invalidated on success; the response contains a fresh refresh token
+    that must be stored atomically.
+
+        Attributes:
+            grant_type (OAuthRefreshTokenRequestGrantType):
+            refresh_token (str): The most recent refresh token issued for this `client_id`.
+    """
+
+    grant_type: OAuthRefreshTokenRequestGrantType
+    refresh_token: str
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        grant_type = self.grant_type.value
+
+        refresh_token = self.refresh_token
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "grant_type": grant_type,
+                "refresh_token": refresh_token,
+            }
+        )
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+        grant_type = OAuthRefreshTokenRequestGrantType(d.pop("grant_type"))
+
+        refresh_token = d.pop("refresh_token")
+
+        o_auth_refresh_token_request = cls(
+            grant_type=grant_type,
+            refresh_token=refresh_token,
+        )
+
+        o_auth_refresh_token_request.additional_properties = d
+        return o_auth_refresh_token_request
+
+    @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

truagents/generated/models/o_auth_refresh_token_request_grant_type.py

@@ -0,0 +1,8 @@
+from enum import Enum
+
+
+class OAuthRefreshTokenRequestGrantType(str, Enum):
+    REFRESH_TOKEN = "refresh_token"
+
+    def __str__(self) -> str:
+        return str(self.value)