poststack 0.4.0__py3-none-any.whl

poststack/resources/broadcasts.py

@@ -0,0 +1,160 @@
+"""Broadcasts resource — mirrors packages/sdk/src/resources/broadcasts.ts."""
+
+from __future__ import annotations
+
+from typing import Any, Dict, Mapping, Optional
+from urllib.parse import quote
+
+from .._client import AsyncPostStackClient, PostStackClient
+
+
+class BroadcastsResource:
+    def __init__(self, client: PostStackClient) -> None:
+        self._client = client
+
+    def create(
+        self, input: Dict[str, Any], *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return self._client.post("/broadcasts", input, timeout=timeout)
+
+    def list(
+        self,
+        params: Optional[Mapping[str, Any]] = None,
+        *,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        return self._client.get("/broadcasts", params, timeout=timeout)
+
+    def get(
+        self, id: str, *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return self._client.get(
+            f"/broadcasts/{quote(id, safe='')}", timeout=timeout
+        )
+
+    def update(
+        self,
+        id: str,
+        input: Dict[str, Any],
+        *,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        return self._client.patch(
+            f"/broadcasts/{quote(id, safe='')}", input, timeout=timeout
+        )
+
+    def send(
+        self, id: str, *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return self._client.post(
+            f"/broadcasts/{quote(id, safe='')}/send", timeout=timeout
+        )
+
+    def cancel(
+        self, id: str, *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return self._client.post(
+            f"/broadcasts/{quote(id, safe='')}/cancel", timeout=timeout
+        )
+
+    def send_test(
+        self,
+        id: str,
+        input: Dict[str, Any],
+        *,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        return self._client.post(
+            f"/broadcasts/{quote(id, safe='')}/test", input, timeout=timeout
+        )
+
+    def get_variants(
+        self, id: str, *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return self._client.get(
+            f"/broadcasts/{quote(id, safe='')}/variants", timeout=timeout
+        )
+
+    def get_variant_stats(
+        self, id: str, *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return self._client.get(
+            f"/broadcasts/{quote(id, safe='')}/variant-stats",
+            timeout=timeout,
+        )
+
+
+class AsyncBroadcastsResource:
+    def __init__(self, client: AsyncPostStackClient) -> None:
+        self._client = client
+
+    async def create(
+        self, input: Dict[str, Any], *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return await self._client.post("/broadcasts", input, timeout=timeout)
+
+    async def list(
+        self,
+        params: Optional[Mapping[str, Any]] = None,
+        *,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        return await self._client.get("/broadcasts", params, timeout=timeout)
+
+    async def get(
+        self, id: str, *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return await self._client.get(
+            f"/broadcasts/{quote(id, safe='')}", timeout=timeout
+        )
+
+    async def update(
+        self,
+        id: str,
+        input: Dict[str, Any],
+        *,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        return await self._client.patch(
+            f"/broadcasts/{quote(id, safe='')}", input, timeout=timeout
+        )
+
+    async def send(
+        self, id: str, *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return await self._client.post(
+            f"/broadcasts/{quote(id, safe='')}/send", timeout=timeout
+        )
+
+    async def cancel(
+        self, id: str, *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return await self._client.post(
+            f"/broadcasts/{quote(id, safe='')}/cancel", timeout=timeout
+        )
+
+    async def send_test(
+        self,
+        id: str,
+        input: Dict[str, Any],
+        *,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        return await self._client.post(
+            f"/broadcasts/{quote(id, safe='')}/test", input, timeout=timeout
+        )
+
+    async def get_variants(
+        self, id: str, *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return await self._client.get(
+            f"/broadcasts/{quote(id, safe='')}/variants", timeout=timeout
+        )
+
+    async def get_variant_stats(
+        self, id: str, *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return await self._client.get(
+            f"/broadcasts/{quote(id, safe='')}/variant-stats",
+            timeout=timeout,
+        )

poststack/resources/contact_properties.py

@@ -0,0 +1,73 @@
+"""Contact properties resource — mirrors packages/sdk/src/resources/contact-properties.ts."""
+
+from __future__ import annotations
+
+from typing import Any, Dict, Optional
+
+from .._client import AsyncPostStackClient, PostStackClient
+
+
+class ContactPropertiesResource:
+    def __init__(self, client: PostStackClient) -> None:
+        self._client = client
+
+    def list(self, *, timeout: Optional[float] = None) -> Dict[str, Any]:
+        return self._client.get("/contact-properties", timeout=timeout)
+
+    def create(
+        self, input: Dict[str, Any], *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return self._client.post(
+            "/contact-properties", input, timeout=timeout
+        )
+
+    def update(
+        self,
+        id: int,
+        input: Dict[str, Any],
+        *,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        return self._client.patch(
+            f"/contact-properties/{id}", input, timeout=timeout
+        )
+
+    def delete(
+        self, id: int, *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return self._client.delete(
+            f"/contact-properties/{id}", timeout=timeout
+        )
+
+
+class AsyncContactPropertiesResource:
+    def __init__(self, client: AsyncPostStackClient) -> None:
+        self._client = client
+
+    async def list(self, *, timeout: Optional[float] = None) -> Dict[str, Any]:
+        return await self._client.get("/contact-properties", timeout=timeout)
+
+    async def create(
+        self, input: Dict[str, Any], *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return await self._client.post(
+            "/contact-properties", input, timeout=timeout
+        )
+
+    async def update(
+        self,
+        id: int,
+        input: Dict[str, Any],
+        *,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        return await self._client.patch(
+            f"/contact-properties/{id}", input, timeout=timeout
+        )
+
+    async def delete(
+        self, id: int, *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return await self._client.delete(
+            f"/contact-properties/{id}", timeout=timeout
+        )

poststack/resources/contacts.py

@@ -0,0 +1,130 @@
+"""Contacts resource — mirrors packages/sdk/src/resources/contacts.ts."""
+
+from __future__ import annotations
+
+from typing import Any, Dict, Mapping, Optional, Union
+from urllib.parse import quote
+
+from .._client import AsyncPostStackClient, PostStackClient
+
+
+class ContactsResource:
+    def __init__(self, client: PostStackClient) -> None:
+        self._client = client
+
+    def create(
+        self, input: Dict[str, Any], *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return self._client.post("/contacts", input, timeout=timeout)
+
+    def list(
+        self,
+        params: Optional[Mapping[str, Any]] = None,
+        *,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        return self._client.get("/contacts", params, timeout=timeout)
+
+    def get(
+        self, id: str, *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return self._client.get(
+            f"/contacts/{quote(id, safe='')}", timeout=timeout
+        )
+
+    def update(
+        self,
+        id: str,
+        input: Dict[str, Any],
+        *,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        return self._client.patch(
+            f"/contacts/{quote(id, safe='')}", input, timeout=timeout
+        )
+
+    def delete(
+        self, id: str, *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return self._client.delete(
+            f"/contacts/{quote(id, safe='')}", timeout=timeout
+        )
+
+    def unsubscribe(
+        self, id: str, *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return self._client.post(
+            f"/contacts/{quote(id, safe='')}/unsubscribe", timeout=timeout
+        )
+
+    def import_(
+        self, input: Dict[str, Any], *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return self._client.post("/contacts/import", input, timeout=timeout)
+
+    def export_csv(
+        self, *, timeout: Optional[float] = None
+    ) -> Union[str, Dict[str, Any]]:
+        return self._client.get("/contacts/export", timeout=timeout)
+
+
+class AsyncContactsResource:
+    def __init__(self, client: AsyncPostStackClient) -> None:
+        self._client = client
+
+    async def create(
+        self, input: Dict[str, Any], *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return await self._client.post("/contacts", input, timeout=timeout)
+
+    async def list(
+        self,
+        params: Optional[Mapping[str, Any]] = None,
+        *,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        return await self._client.get("/contacts", params, timeout=timeout)
+
+    async def get(
+        self, id: str, *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return await self._client.get(
+            f"/contacts/{quote(id, safe='')}", timeout=timeout
+        )
+
+    async def update(
+        self,
+        id: str,
+        input: Dict[str, Any],
+        *,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        return await self._client.patch(
+            f"/contacts/{quote(id, safe='')}", input, timeout=timeout
+        )
+
+    async def delete(
+        self, id: str, *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return await self._client.delete(
+            f"/contacts/{quote(id, safe='')}", timeout=timeout
+        )
+
+    async def unsubscribe(
+        self, id: str, *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return await self._client.post(
+            f"/contacts/{quote(id, safe='')}/unsubscribe", timeout=timeout
+        )
+
+    async def import_(
+        self, input: Dict[str, Any], *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return await self._client.post(
+            "/contacts/import", input, timeout=timeout
+        )
+
+    async def export_csv(
+        self, *, timeout: Optional[float] = None
+    ) -> Union[str, Dict[str, Any]]:
+        return await self._client.get("/contacts/export", timeout=timeout)

poststack/resources/domains.py

@@ -0,0 +1,199 @@
+"""Domains resource — mirrors packages/sdk/src/resources/domains.ts."""
+
+from __future__ import annotations
+
+from typing import Any, Dict, Mapping, Optional
+
+from .._client import AsyncPostStackClient, PostStackClient
+
+
+class DomainsResource:
+    def __init__(self, client: PostStackClient) -> None:
+        self._client = client
+
+    def create(
+        self, input: Dict[str, Any], *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return self._client.post("/domains", input, timeout=timeout)
+
+    def list(
+        self,
+        params: Optional[Mapping[str, Any]] = None,
+        *,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        return self._client.get("/domains", params, timeout=timeout)
+
+    def get(
+        self, id: int, *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return self._client.get(f"/domains/{id}", timeout=timeout)
+
+    def verify(
+        self, id: int, *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return self._client.post(f"/domains/{id}/verify", timeout=timeout)
+
+    def update(
+        self,
+        id: int,
+        input: Dict[str, Any],
+        *,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        return self._client.patch(f"/domains/{id}", input, timeout=timeout)
+
+    def delete(
+        self, id: int, *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return self._client.delete(f"/domains/{id}", timeout=timeout)
+
+    def assign_ip(
+        self,
+        id: int,
+        ip_address_id: int,
+        *,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        return self._client.post(
+            f"/domains/{id}/ip",
+            {"ipAddressId": ip_address_id},
+            timeout=timeout,
+        )
+
+    def unassign_ip(
+        self, id: int, *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return self._client.delete(f"/domains/{id}/ip", timeout=timeout)
+
+    def get_dmarc_reports(
+        self,
+        id: int,
+        params: Optional[Mapping[str, Any]] = None,
+        *,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        return self._client.get(
+            f"/domains/{id}/dmarc/reports", params, timeout=timeout
+        )
+
+    def get_dmarc_stats(
+        self,
+        id: int,
+        days: Optional[int] = None,
+        *,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        params = {"days": days} if days is not None else None
+        return self._client.get(
+            f"/domains/{id}/dmarc/stats", params, timeout=timeout
+        )
+
+    def get_dmarc_sources(
+        self,
+        id: int,
+        days: Optional[int] = None,
+        *,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        params = {"days": days} if days is not None else None
+        return self._client.get(
+            f"/domains/{id}/dmarc/sources", params, timeout=timeout
+        )
+
+
+class AsyncDomainsResource:
+    def __init__(self, client: AsyncPostStackClient) -> None:
+        self._client = client
+
+    async def create(
+        self, input: Dict[str, Any], *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return await self._client.post("/domains", input, timeout=timeout)
+
+    async def list(
+        self,
+        params: Optional[Mapping[str, Any]] = None,
+        *,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        return await self._client.get("/domains", params, timeout=timeout)
+
+    async def get(
+        self, id: int, *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return await self._client.get(f"/domains/{id}", timeout=timeout)
+
+    async def verify(
+        self, id: int, *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return await self._client.post(f"/domains/{id}/verify", timeout=timeout)
+
+    async def update(
+        self,
+        id: int,
+        input: Dict[str, Any],
+        *,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        return await self._client.patch(
+            f"/domains/{id}", input, timeout=timeout
+        )
+
+    async def delete(
+        self, id: int, *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return await self._client.delete(f"/domains/{id}", timeout=timeout)
+
+    async def assign_ip(
+        self,
+        id: int,
+        ip_address_id: int,
+        *,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        return await self._client.post(
+            f"/domains/{id}/ip",
+            {"ipAddressId": ip_address_id},
+            timeout=timeout,
+        )
+
+    async def unassign_ip(
+        self, id: int, *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return await self._client.delete(f"/domains/{id}/ip", timeout=timeout)
+
+    async def get_dmarc_reports(
+        self,
+        id: int,
+        params: Optional[Mapping[str, Any]] = None,
+        *,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        return await self._client.get(
+            f"/domains/{id}/dmarc/reports", params, timeout=timeout
+        )
+
+    async def get_dmarc_stats(
+        self,
+        id: int,
+        days: Optional[int] = None,
+        *,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        params = {"days": days} if days is not None else None
+        return await self._client.get(
+            f"/domains/{id}/dmarc/stats", params, timeout=timeout
+        )
+
+    async def get_dmarc_sources(
+        self,
+        id: int,
+        days: Optional[int] = None,
+        *,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        params = {"days": days} if days is not None else None
+        return await self._client.get(
+            f"/domains/{id}/dmarc/sources", params, timeout=timeout
+        )

poststack/resources/email_validations.py

@@ -0,0 +1,53 @@
+"""Email validations resource — mirrors packages/sdk/src/resources/email-validations.ts."""
+
+from __future__ import annotations
+
+from typing import Any, Dict, List, Optional
+
+from .._client import AsyncPostStackClient, PostStackClient
+
+
+class EmailValidationsResource:
+    def __init__(self, client: PostStackClient) -> None:
+        self._client = client
+
+    def validate(
+        self, email: str, *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return self._client.post(
+            "/email-validations", {"email": email}, timeout=timeout
+        )
+
+    def validate_batch(
+        self,
+        emails: List[str],
+        *,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        return self._client.post(
+            "/email-validations/batch", {"emails": emails}, timeout=timeout
+        )
+
+
+class AsyncEmailValidationsResource:
+    def __init__(self, client: AsyncPostStackClient) -> None:
+        self._client = client
+
+    async def validate(
+        self, email: str, *, timeout: Optional[float] = None
+    ) -> Dict[str, Any]:
+        return await self._client.post(
+            "/email-validations", {"email": email}, timeout=timeout
+        )
+
+    async def validate_batch(
+        self,
+        emails: List[str],
+        *,
+        timeout: Optional[float] = None,
+    ) -> Dict[str, Any]:
+        return await self._client.post(
+            "/email-validations/batch",
+            {"emails": emails},
+            timeout=timeout,
+        )