stackshift 0.1.2__py3-none-any.whl → 1.0.0__py3-none-any.whl

stackshift/__init__.py

@@ -8,7 +8,10 @@ from .mail import (
     MailTemplatesClient,
 )
 from .mail_reputation import MailLimitsClient, MailReputationClient, MailReputationEventsClient
-from .mail_phase7 import MailEventsClient, MailWebhooksClient, verify_webhook_signature
+from .mail_events_webhooks import MailEventsClient, MailWebhooksClient, verify_webhook_signature
+from .mail_streams import MailStreamsClient
+from .mail_campaigns import MailAudiencesClient, MailCampaignsClient
+from .mail_exports import MailExportsClient
 from .projects import ProjectsClient
 
 __all__ = [
@@ -25,6 +28,10 @@ __all__ = [
     "MailReputationEventsClient",
     "MailTemplatesClient",
     "MailWebhooksClient",
+    "MailStreamsClient",
+    "MailAudiencesClient",
+    "MailCampaignsClient",
+    "MailExportsClient",
     "ProjectsClient",
     "asset_transform_options",
     "asset_transform_spec",

stackshift/client.py

@@ -43,7 +43,7 @@ class StackShift:
     def _request(self, base_url: str, method: str, path: str, **kwargs: Any) -> Any:
         headers = kwargs.pop("headers", {})
         headers["Authorization"] = f"Bearer {self.api_key}"
-        headers["User-Agent"] = "StackShift-Python/0.1"
+        headers["User-Agent"] = "StackShift-Python/1.0"
 
         response = self.session.request(method, f"{base_url}{path}", headers=headers, **kwargs)
         payload = response.json() if response.content else None

stackshift/mail.py

@@ -4,8 +4,11 @@ from typing import Any
 from urllib.parse import quote
 
 from .mail_advanced import MailAnalyticsClient, MailBatchClient, MailInboundClient, MailScheduledClient
-from .mail_phase7 import MailEventsClient, MailWebhooksClient
+from .mail_events_webhooks import MailEventsClient, MailWebhooksClient
 from .mail_reputation import MailLimitsClient, MailReputationClient
+from .mail_streams import MailStreamsClient
+from .mail_campaigns import MailAudiencesClient, MailCampaignsClient
+from .mail_exports import MailExportsClient
 
 
 class MailClient:
@@ -19,6 +22,10 @@ class MailClient:
         self.templates = MailTemplatesClient(client)
         self.events = MailEventsClient(client)
         self.webhooks = MailWebhooksClient(client)
+        self.streams = MailStreamsClient(client)
+        self.audiences = MailAudiencesClient(client)
+        self.campaigns = MailCampaignsClient(client)
+        self.exports = MailExportsClient(client)
         self.limits = MailLimitsClient(client)
         self.reputation = MailReputationClient(client)
         self.scheduled = MailScheduledClient(client)
@@ -39,6 +46,9 @@ class MailClient:
         reply_to: str | dict[str, str] | None = None,
         idempotency_key: str | None = None,
         attachments: list[dict[str, Any]] | None = None,
+        headers: dict[str, str] | None = None,
+        tags: dict[str, str] | None = None,
+        stream: str | None = None,
     ) -> dict[str, Any]:
         payload = {
             "from": from_,
@@ -51,6 +61,9 @@ class MailClient:
             "text": text,
             "idempotencyKey": idempotency_key,
             "attachments": attachments,
+            "headers": headers,
+            "tags": tags,
+            "stream": stream,
         }
         clean = {key: value for key, value in payload.items() if value is not None}
         return self._client.mail_request("POST", "/mail/send", json=clean)
@@ -68,6 +81,9 @@ class MailClient:
         reply_to: str | dict[str, str] | None = None,
         idempotency_key: str | None = None,
         attachments: list[dict[str, Any]] | None = None,
+        headers: dict[str, str] | None = None,
+        tags: dict[str, str] | None = None,
+        stream: str | None = None,
     ) -> dict[str, Any]:
         payload = {
             "template": template,
@@ -80,6 +96,9 @@ class MailClient:
             "data": data,
             "idempotencyKey": idempotency_key,
             "attachments": attachments,
+            "headers": headers,
+            "tags": tags,
+            "stream": stream,
         }
         clean = {key: value for key, value in payload.items() if value is not None}
         return self._client.mail_request("POST", "/mail/send-template", json=clean)
@@ -162,6 +181,18 @@ class MailTemplatesClient:
         clean = {key: value for key, value in payload.items() if value is not None}
         return self._client.mail_request("POST", f"/mail/templates/{quote(template_id)}/preview", json=clean)
 
+    def diagnostics(
+        self,
+        template_id: str,
+        *,
+        data: dict[str, Any] | None = None,
+        version_id: str | None = None,
+        stream: str | None = None,
+    ) -> dict[str, Any]:
+        payload = {"data": data, "versionId": version_id, "stream": stream}
+        clean = {key: value for key, value in payload.items() if value is not None}
+        return self._client.mail_request("POST", f"/mail/templates/{quote(template_id)}/diagnostics", json=clean)
+
     def test_send(
         self,
         template_id: str,
@@ -231,8 +262,9 @@ class MailMessagesClient:
     def bounces(self, message_id: str) -> dict[str, Any]:
         return self._client.mail_request("GET", f"/mail/messages/{quote(message_id)}/bounces")
 
-    def timeline(self, message_id: str) -> dict[str, Any]:
-        return self._client.mail_request("GET", f"/mail/messages/{quote(message_id)}/timeline")
+    def timeline(self, message_id: str, *, recipient: str | None = None) -> dict[str, Any]:
+        params = {"recipient": recipient} if recipient else None
+        return self._client.mail_request("GET", f"/mail/messages/{quote(message_id)}/timeline", params=params)
 
 
 class MailSuppressionsClient:

stackshift/mail_advanced.py

@@ -36,11 +36,31 @@ class MailBatchClient:
         from_: str | dict[str, str],
         recipients: list[dict[str, Any]],
         version_id: str | None = None,
+        headers: dict[str, str] | None = None,
+        tags: dict[str, str] | None = None,
+        stream: str | None = None,
     ) -> dict[str, Any]:
-        payload = {"template": template, "from": from_, "recipients": recipients, "versionId": version_id}
+        payload = {
+            "template": template,
+            "from": from_,
+            "recipients": recipients,
+            "versionId": version_id,
+            "headers": headers,
+            "tags": tags,
+            "stream": stream,
+        }
         clean = {key: value for key, value in payload.items() if value is not None}
         return self._client.mail_request("POST", "/mail/batch-template", json=clean)
 
+    def list(self) -> dict[str, Any]:
+        return self._client.mail_request("GET", "/mail/batches")
+
+    def get(self, batch_id: str) -> dict[str, Any]:
+        return self._client.mail_request("GET", f"/mail/batches/{quote(batch_id)}")
+
+    def items(self, batch_id: str) -> dict[str, Any]:
+        return self._client.mail_request("GET", f"/mail/batches/{quote(batch_id)}/items")
+
 
 class MailInboundClient:
     def __init__(self, client: Any) -> None:

stackshift/mail_campaigns.py

@@ -0,0 +1,61 @@
+from __future__ import annotations
+
+from typing import Any
+from urllib.parse import quote
+
+
+class MailAudiencesClient:
+    def __init__(self, client: Any) -> None:
+        self._client = client
+
+    def create(self, *, name: str, description: str | None = None) -> dict[str, Any]:
+        payload = {"name": name, "description": description}
+        return self._client.mail_request("POST", "/mail/audiences", json={key: value for key, value in payload.items() if value is not None})
+
+    def list(self) -> dict[str, Any]:
+        return self._client.mail_request("GET", "/mail/audiences")
+
+    def get(self, audience_id: str) -> dict[str, Any]:
+        return self._client.mail_request("GET", f"/mail/audiences/{quote(audience_id)}")
+
+    def members(self, audience_id: str) -> dict[str, Any]:
+        return self._client.mail_request("GET", f"/mail/audiences/{quote(audience_id)}/members")
+
+    def import_members(self, audience_id: str, members: list[dict[str, Any]]) -> dict[str, Any]:
+        return self._client.mail_request(
+            "POST",
+            f"/mail/audiences/{quote(audience_id)}/imports",
+            json={"members": members},
+        )
+
+
+class MailCampaignsClient:
+    def __init__(self, client: Any) -> None:
+        self._client = client
+
+    def create(
+        self,
+        *,
+        name: str,
+        audience_id: str,
+        template: str,
+        from_: str,
+        version_id: str | None = None,
+    ) -> dict[str, Any]:
+        payload = {
+            "name": name,
+            "audienceId": audience_id,
+            "template": template,
+            "from": from_,
+            "versionId": version_id,
+        }
+        return self._client.mail_request("POST", "/mail/campaigns", json={key: value for key, value in payload.items() if value is not None})
+
+    def list(self) -> dict[str, Any]:
+        return self._client.mail_request("GET", "/mail/campaigns")
+
+    def get(self, campaign_id: str) -> dict[str, Any]:
+        return self._client.mail_request("GET", f"/mail/campaigns/{quote(campaign_id)}")
+
+    def send(self, campaign_id: str) -> dict[str, Any]:
+        return self._client.mail_request("POST", f"/mail/campaigns/{quote(campaign_id)}/send")

stackshift/{mail_phase7.py → mail_events_webhooks.py}

@@ -100,6 +100,14 @@ class MailWebhooksClient:
     def retry_delivery(self, delivery_id: str) -> dict[str, Any]:
         return self._client.mail_request("POST", f"/mail/webhook-deliveries/{quote(delivery_id)}/retry")
 
+    def replay(self, webhook_id: str, *, event_ids: list[str], idempotency_key: str) -> dict[str, Any]:
+        return self._client.mail_request(
+            "POST",
+            f"/mail/webhooks/{quote(webhook_id)}/replay",
+            headers={"Idempotency-Key": idempotency_key},
+            json={"eventIds": event_ids},
+        )
+
     def verify_signature(
         self,
         *,

stackshift/mail_exports.py

@@ -0,0 +1,30 @@
+from __future__ import annotations
+
+from datetime import datetime
+from typing import Any
+from urllib.parse import quote
+
+
+class MailExportsClient:
+    def __init__(self, client: Any) -> None:
+        self._client = client
+
+    def create(self, *, from_: datetime | None = None, to: datetime | None = None) -> dict[str, Any]:
+        payload = {
+            "kind": "recipient_delivery",
+            "format": "jsonl",
+            "from": from_.isoformat() if from_ else None,
+            "to": to.isoformat() if to else None,
+        }
+        return self._client.mail_request(
+            "POST", "/mail/exports", json={key: value for key, value in payload.items() if value is not None}
+        )
+
+    def list(self) -> dict[str, Any]:
+        return self._client.mail_request("GET", "/mail/exports")
+
+    def get(self, export_id: str) -> dict[str, Any]:
+        return self._client.mail_request("GET", f"/mail/exports/{quote(export_id)}")
+
+    def download_path(self, export_id: str) -> str:
+        return f"/mail/exports/{quote(export_id)}/download"

stackshift/mail_streams.py

@@ -0,0 +1,18 @@
+from __future__ import annotations
+
+from typing import Any
+
+
+class MailStreamsClient:
+    def __init__(self, client: Any) -> None:
+        self._client = client
+
+    def create(self, *, name: str, slug: str, type: str) -> dict[str, Any]:
+        return self._client.mail_request(
+            "POST",
+            "/mail/streams",
+            json={"name": name, "slug": slug, "type": type},
+        )
+
+    def list(self) -> dict[str, Any]:
+        return self._client.mail_request("GET", "/mail/streams")

{stackshift-0.1.2.dist-info → stackshift-1.0.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stackshift
-Version: 0.1.2
+Version: 1.0.0
 Summary: Official Python SDK for StackShift.
 Requires-Python: >=3.9
 Requires-Dist: requests>=2.31

stackshift-1.0.0.dist-info/RECORD

@@ -0,0 +1,15 @@
+stackshift/__init__.py,sha256=QJxD-b_E7P0_6s04v1GhbyyaXLweNohIZPnwmS-jUAc,1278
+stackshift/assets.py,sha256=qRzL9BNZSneNBc3es_vLsY4_hh_r3zOfdO_rAKQq5LU,22949
+stackshift/client.py,sha256=myLN4B_SsolilJWpdlTZv8xwYnj1q-xOmjcSaF_P0mM,3000
+stackshift/mail.py,sha256=akjk8ATJLl7Wv8b2re9LPL5n2Vjvjnz8HK6yNhP6Vj0,14863
+stackshift/mail_advanced.py,sha256=e7Z0SCvonNaS36BnEfhioUh9fnZDU2vcIKmqc1Mqmvo,4192
+stackshift/mail_campaigns.py,sha256=-ZQV88gY1PsuKNA4KYcKVqS1To39EOukKu1Is9qRCPU,2198
+stackshift/mail_events_webhooks.py,sha256=iVYz_5DvGaE-Acw5uh_JN7P5LWvgfN-2bLnb_z1CMRU,5712
+stackshift/mail_exports.py,sha256=sbwBbypS1APv2DnunYmyViEjUHP1PMSrM0tVcbxcits,1054
+stackshift/mail_reputation.py,sha256=mPvPkZeqcQc5808PhBK7gYsgf4Fk_U19nRxSsJ60MGU,1112
+stackshift/mail_streams.py,sha256=F7iBzHtWhCFw1cTjwPixNJfCvxdjvsDprZQG2A9-NIs,504
+stackshift/projects.py,sha256=oYWaE7xNRR6OXuPEwJH-oFFeOmDA9ozq6jJY09ANIHA,498
+stackshift-1.0.0.dist-info/METADATA,sha256=zeVp95gxjKNQMXEagLnJU0I1WEUbHCl7kSJmjpRhY5s,152
+stackshift-1.0.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+stackshift-1.0.0.dist-info/top_level.txt,sha256=qe3uWsu_O9mNtq7bIck9Y8rjTIMrH0kzgAlGFDoRGqs,11
+stackshift-1.0.0.dist-info/RECORD,,

{stackshift-0.1.2.dist-info → stackshift-1.0.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (83.0.0)
+Generator: setuptools (84.0.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

stackshift-0.1.2.dist-info/RECORD

@@ -1,12 +0,0 @@
-stackshift/__init__.py,sha256=e5QZUzE6m_195Cvvawyv8p_M18eNkQzW6sBgBn3SlRo,1008
-stackshift/assets.py,sha256=qRzL9BNZSneNBc3es_vLsY4_hh_r3zOfdO_rAKQq5LU,22949
-stackshift/client.py,sha256=AcJivv4VRCQ756MRrxCrLi0Q4in-4np0Re8ceQSTF1Y,3000
-stackshift/mail.py,sha256=vegCniMcWBvHtz_UGAfNfVxFYTety8H3KKFQsWfKZSs,13462
-stackshift/mail_advanced.py,sha256=-lzajXqlrkR8qA4YpRX5Sv3VwcEQITtKfIXbWwjRRQE,3533
-stackshift/mail_phase7.py,sha256=Ud2fyKwt-vpaw7vgEayLw5q9tiDIF-fkfTBaoGJMJBI,5377
-stackshift/mail_reputation.py,sha256=mPvPkZeqcQc5808PhBK7gYsgf4Fk_U19nRxSsJ60MGU,1112
-stackshift/projects.py,sha256=oYWaE7xNRR6OXuPEwJH-oFFeOmDA9ozq6jJY09ANIHA,498
-stackshift-0.1.2.dist-info/METADATA,sha256=GKbdBmBmZWOUs8DTe-amYxZNbplrh7pAlkaRtkBWQ14,152
-stackshift-0.1.2.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
-stackshift-0.1.2.dist-info/top_level.txt,sha256=qe3uWsu_O9mNtq7bIck9Y8rjTIMrH0kzgAlGFDoRGqs,11
-stackshift-0.1.2.dist-info/RECORD,,