truagents 0.0.0.dev0__py3-none-any.whl

truagents/generated/models/o_auth_token_response.py

@@ -0,0 +1,97 @@
+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_token_response_token_type import OAuthTokenResponseTokenType
+
+T = TypeVar("T", bound="OAuthTokenResponse")
+
+
+@_attrs_define
+class OAuthTokenResponse:
+    """
+    Attributes:
+        access_token (str): Opaque bearer token (prefix `tru_at_`). Send on every API request as `Authorization: Bearer
+            <access_token>`. Example: tru_at_<access_token>.
+        token_type (OAuthTokenResponseTokenType):
+        expires_in (int): Seconds until the access token expires. Example: 900.
+        refresh_token (str): Opaque refresh token (prefix `tru_rt_`). Single-use; store atomically. Example:
+            tru_rt_<refresh_token>.
+        refresh_expires_in (int): Seconds until the refresh token expires. Example: 2592000.
+    """
+
+    access_token: str
+    token_type: OAuthTokenResponseTokenType
+    expires_in: int
+    refresh_token: str
+    refresh_expires_in: int
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        access_token = self.access_token
+
+        token_type = self.token_type.value
+
+        expires_in = self.expires_in
+
+        refresh_token = self.refresh_token
+
+        refresh_expires_in = self.refresh_expires_in
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "access_token": access_token,
+                "token_type": token_type,
+                "expires_in": expires_in,
+                "refresh_token": refresh_token,
+                "refresh_expires_in": refresh_expires_in,
+            }
+        )
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+        access_token = d.pop("access_token")
+
+        token_type = OAuthTokenResponseTokenType(d.pop("token_type"))
+
+        expires_in = d.pop("expires_in")
+
+        refresh_token = d.pop("refresh_token")
+
+        refresh_expires_in = d.pop("refresh_expires_in")
+
+        o_auth_token_response = cls(
+            access_token=access_token,
+            token_type=token_type,
+            expires_in=expires_in,
+            refresh_token=refresh_token,
+            refresh_expires_in=refresh_expires_in,
+        )
+
+        o_auth_token_response.additional_properties = d
+        return o_auth_token_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_token_response_token_type.py

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

truagents/generated/models/phone_skipped_item.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.phone_skipped_item_reason import PhoneSkippedItemReason
+from ..types import UNSET, Unset
+
+T = TypeVar("T", bound="PhoneSkippedItem")
+
+
+@_attrs_define
+class PhoneSkippedItem:
+    """An input item rejected by per-item validation. Echoes the original item fields plus a `reason`.
+
+    Attributes:
+        reason (PhoneSkippedItemReason):
+        phone (str | Unset): Echoed from input when present.
+        unsubscribed (bool | Unset): Echoed from input when present.
+    """
+
+    reason: PhoneSkippedItemReason
+    phone: str | Unset = UNSET
+    unsubscribed: bool | Unset = UNSET
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        reason = self.reason.value
+
+        phone = self.phone
+
+        unsubscribed = self.unsubscribed
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "reason": reason,
+            }
+        )
+        if phone is not UNSET:
+            field_dict["phone"] = phone
+        if unsubscribed is not UNSET:
+            field_dict["unsubscribed"] = unsubscribed
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+        reason = PhoneSkippedItemReason(d.pop("reason"))
+
+        phone = d.pop("phone", UNSET)
+
+        unsubscribed = d.pop("unsubscribed", UNSET)
+
+        phone_skipped_item = cls(
+            reason=reason,
+            phone=phone,
+            unsubscribed=unsubscribed,
+        )
+
+        phone_skipped_item.additional_properties = d
+        return phone_skipped_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

truagents/generated/models/phone_skipped_item_reason.py

@@ -0,0 +1,11 @@
+from enum import Enum
+
+
+class PhoneSkippedItemReason(str, Enum):
+    DUPLICATE_IDENTIFIER = "duplicate identifier"
+    INVALID_PHONE_FORMAT = "invalid phone format"
+    MISSING_IDENTIFIER = "missing identifier"
+    MISSING_UNSUBSCRIBED = "missing unsubscribed"
+
+    def __str__(self) -> str:
+        return str(self.value)

truagents/generated/models/phone_source_enum.py

@@ -0,0 +1,11 @@
+from enum import Enum
+
+
+class PhoneSourceEnum(str, Enum):
+    ADMIN = "admin"
+    EXTERNAL_API = "external_api"
+    IMPORT = "import"
+    TWILIO = "twilio"
+
+    def __str__(self) -> str:
+        return str(self.value)

truagents/generated/models/phone_unsubscribe_batch_request.py

@@ -0,0 +1,92 @@
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import TYPE_CHECKING, Any, TypeVar
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+from ..types import UNSET, Unset
+
+if TYPE_CHECKING:
+    from ..models.phone_unsubscribe_item import PhoneUnsubscribeItem
+
+
+T = TypeVar("T", bound="PhoneUnsubscribeBatchRequest")
+
+
+@_attrs_define
+class PhoneUnsubscribeBatchRequest:
+    """
+    Example:
+        {'org_slug': 'acme-corp', 'items': [{'phone': '+15551234567', 'unsubscribed': True}]}
+
+    Attributes:
+        items (list[PhoneUnsubscribeItem]): Up to 10,000 items per request. Items are processed in array order; partial
+            failures do not roll back accepted items.
+        org_slug (str | Unset): Organization to write to. Must be in your `client_id`'s authorized set. Omit to use the
+            key's default organization. One batch targets exactly one organization — to write to several organizations, send
+            one request per organization. Example: acme-corp.
+    """
+
+    items: list[PhoneUnsubscribeItem]
+    org_slug: str | Unset = UNSET
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        items = []
+        for items_item_data in self.items:
+            items_item = items_item_data.to_dict()
+            items.append(items_item)
+
+        org_slug = self.org_slug
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "items": items,
+            }
+        )
+        if org_slug is not UNSET:
+            field_dict["org_slug"] = org_slug
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        from ..models.phone_unsubscribe_item import PhoneUnsubscribeItem
+
+        d = dict(src_dict)
+        items = []
+        _items = d.pop("items")
+        for items_item_data in _items:
+            items_item = PhoneUnsubscribeItem.from_dict(items_item_data)
+
+            items.append(items_item)
+
+        org_slug = d.pop("org_slug", UNSET)
+
+        phone_unsubscribe_batch_request = cls(
+            items=items,
+            org_slug=org_slug,
+        )
+
+        phone_unsubscribe_batch_request.additional_properties = d
+        return phone_unsubscribe_batch_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/phone_unsubscribe_batch_response.py

@@ -0,0 +1,118 @@
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import TYPE_CHECKING, Any, TypeVar
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+if TYPE_CHECKING:
+    from ..models.phone_skipped_item import PhoneSkippedItem
+    from ..models.phone_unsubscribe_updated_entry import PhoneUnsubscribeUpdatedEntry
+
+
+T = TypeVar("T", bound="PhoneUnsubscribeBatchResponse")
+
+
+@_attrs_define
+class PhoneUnsubscribeBatchResponse:
+    """
+    Example:
+        {'org_slug': 'acme-corp', 'processed': 1, 'updated': [{'phone': '+15551234567', 'unsubscribed': True,
+            'updated_at': '2026-04-15T10:30:00Z'}], 'skipped_items': []}
+
+    Attributes:
+        org_slug (str): Organization the batch was applied to — the value you supplied, or your key's default
+            organization when you omitted it. Example: acme-corp.
+        processed (int): Count of items accepted into `updated` — equal to `items.length − skipped_items.length`.
+            Idempotent writes (item already at requested state) are counted.
+        updated (list[PhoneUnsubscribeUpdatedEntry]): One entry per accepted input item, in input order.
+        skipped_items (list[PhoneSkippedItem]): Items rejected by per-item validation; each carries the original field
+            echoes plus a `reason`.
+    """
+
+    org_slug: str
+    processed: int
+    updated: list[PhoneUnsubscribeUpdatedEntry]
+    skipped_items: list[PhoneSkippedItem]
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        org_slug = self.org_slug
+
+        processed = self.processed
+
+        updated = []
+        for updated_item_data in self.updated:
+            updated_item = updated_item_data.to_dict()
+            updated.append(updated_item)
+
+        skipped_items = []
+        for skipped_items_item_data in self.skipped_items:
+            skipped_items_item = skipped_items_item_data.to_dict()
+            skipped_items.append(skipped_items_item)
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "org_slug": org_slug,
+                "processed": processed,
+                "updated": updated,
+                "skipped_items": skipped_items,
+            }
+        )
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        from ..models.phone_skipped_item import PhoneSkippedItem
+        from ..models.phone_unsubscribe_updated_entry import (
+            PhoneUnsubscribeUpdatedEntry,
+        )
+
+        d = dict(src_dict)
+        org_slug = d.pop("org_slug")
+
+        processed = d.pop("processed")
+
+        updated = []
+        _updated = d.pop("updated")
+        for updated_item_data in _updated:
+            updated_item = PhoneUnsubscribeUpdatedEntry.from_dict(updated_item_data)
+
+            updated.append(updated_item)
+
+        skipped_items = []
+        _skipped_items = d.pop("skipped_items")
+        for skipped_items_item_data in _skipped_items:
+            skipped_items_item = PhoneSkippedItem.from_dict(skipped_items_item_data)
+
+            skipped_items.append(skipped_items_item)
+
+        phone_unsubscribe_batch_response = cls(
+            org_slug=org_slug,
+            processed=processed,
+            updated=updated,
+            skipped_items=skipped_items,
+        )
+
+        phone_unsubscribe_batch_response.additional_properties = d
+        return phone_unsubscribe_batch_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/phone_unsubscribe_item.py

@@ -0,0 +1,51 @@
+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="PhoneUnsubscribeItem")
+
+
+@_attrs_define
+class PhoneUnsubscribeItem:
+    """
+    Attributes:
+        phone (str): Phone number in E.164 format. Non-E.164 input is rejected per-item with `reason: "invalid phone
+            format"`. Example: +15551234567.
+        unsubscribed (bool):
+    """
+
+    phone: str
+    unsubscribed: bool
+
+    def to_dict(self) -> dict[str, Any]:
+        phone = self.phone
+
+        unsubscribed = self.unsubscribed
+
+        field_dict: dict[str, Any] = {}
+
+        field_dict.update(
+            {
+                "phone": phone,
+                "unsubscribed": unsubscribed,
+            }
+        )
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+        phone = d.pop("phone")
+
+        unsubscribed = d.pop("unsubscribed")
+
+        phone_unsubscribe_item = cls(
+            phone=phone,
+            unsubscribed=unsubscribed,
+        )
+
+        return phone_unsubscribe_item

truagents/generated/models/phone_unsubscribe_list_response.py

@@ -0,0 +1,111 @@
+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.phone_unsubscribe_record import PhoneUnsubscribeRecord
+
+
+T = TypeVar("T", bound="PhoneUnsubscribeListResponse")
+
+
+@_attrs_define
+class PhoneUnsubscribeListResponse:
+    """
+    Example:
+        {'org_slug': 'acme-corp', 'data': [{'phone': '+15551234567', 'unsubscribed': True, 'source': 'twilio',
+            'updated_at': '2026-04-12T16:22:01Z'}], 'next_cursor': None, 'has_more': False}
+
+    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[PhoneUnsubscribeRecord]):
+        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[PhoneUnsubscribeRecord]
+    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.phone_unsubscribe_record import PhoneUnsubscribeRecord
+
+        d = dict(src_dict)
+        org_slug = d.pop("org_slug")
+
+        data = []
+        _data = d.pop("data")
+        for data_item_data in _data:
+            data_item = PhoneUnsubscribeRecord.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")
+
+        phone_unsubscribe_list_response = cls(
+            org_slug=org_slug,
+            data=data,
+            next_cursor=next_cursor,
+            has_more=has_more,
+        )
+
+        phone_unsubscribe_list_response.additional_properties = d
+        return phone_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/phone_unsubscribe_record.py

@@ -0,0 +1,99 @@
+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.phone_source_enum import PhoneSourceEnum
+
+T = TypeVar("T", bound="PhoneUnsubscribeRecord")
+
+
+@_attrs_define
+class PhoneUnsubscribeRecord:
+    """Used by both `/api/v1/unsubscribe/sms` and `/api/v1/unsubscribe/phone` — the channel is implicit in the URL.
+
+    Example:
+        {'phone': '+15551234567', 'unsubscribed': True, 'source': 'twilio', 'updated_at': '2026-04-12T16:22:01Z'}
+
+    Attributes:
+        phone (str): Phone number in E.164 format. Example: +15551234567.
+        unsubscribed (bool): `true` = opted out (TruAgents will not send on this channel).
+        source (PhoneSourceEnum): The category of writer responsible for the row's most recent state change on the SMS
+            or voice channel.
+
+            - `external_api` — pushed by the partner via this API.
+            - `twilio` — derived from a Twilio STOP/START message (also visible on `/phone` when an administrator has
+            unified the SMS and voice scopes).
+            - `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.
+    """
+
+    phone: str
+    unsubscribed: bool
+    source: PhoneSourceEnum
+    updated_at: datetime.datetime
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        phone = self.phone
+
+        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(
+            {
+                "phone": phone,
+                "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)
+        phone = d.pop("phone")
+
+        unsubscribed = d.pop("unsubscribed")
+
+        source = PhoneSourceEnum(d.pop("source"))
+
+        updated_at = datetime.datetime.fromisoformat(d.pop("updated_at"))
+
+        phone_unsubscribe_record = cls(
+            phone=phone,
+            unsubscribed=unsubscribed,
+            source=source,
+            updated_at=updated_at,
+        )
+
+        phone_unsubscribe_record.additional_properties = d
+        return phone_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