poststack 0.4.0__tar.gz → 0.9.0__tar.gz

{poststack-0.4.0 → poststack-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: poststack
-Version: 0.4.0
+Version: 0.9.0
 Summary: Official Python SDK for the PostStack Email API
 Project-URL: Homepage, https://poststack.dev
 Project-URL: Documentation, https://poststack.dev/docs
@@ -22,7 +22,7 @@ Classifier: Topic :: Communications :: Email
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.10
 Requires-Dist: httpx>=0.25.0
-Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pydantic>=2.4.0
 Provides-Extra: dev
 Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
 Requires-Dist: pytest>=7.0.0; extra == 'dev'
@@ -105,16 +105,28 @@ client = PostStack(api_key="sk_live_...")
 try:
     client.emails.send({"from": "x@y.com", "to": ["z@w.com"], "subject": "hi"})
 except PostStackError as e:
-    print(e.status_code, e.error, e.request_id)
+    print(e.status_code, e.error, e.code, e.request_id)
+    # e.headers holds the response headers; e.retry_after the Retry-After
+    # delay in seconds, when the API sent one.
 ```
 
+## Retries
+
+Network errors, timeouts, 408, 429 and 5xx responses are retried up to
+`max_retries` times (default 3) with full-jitter exponential backoff. A 429
+that carries `Retry-After` waits exactly that long (up to 60 seconds; a longer
+wait is raised instead). A 429 that is a quota rather than throttling — the
+monthly plan limit or the daily send cap, which carry an error code and no
+`Retry-After` — is raised immediately, since retrying cannot lift it.
+
 ## Configuration
 
 ```python
 client = PostStack(
     api_key="sk_live_...",
     base_url="https://api.poststack.dev",  # default
-    timeout=30.0,                           # default (seconds)
+    timeout=30.0,                           # default (seconds), per attempt
+    max_retries=3,                          # default; 0 disables retrying
 )
 ```
 
@@ -126,19 +138,21 @@ client.emails.send({...}, timeout=60.0)
 
 ## Resources
 
-- `client.emails` — send, get, list, cancel, reschedule, batch, events, insights
-- `client.domains` — create, list, get, verify, update, delete, DMARC
-- `client.contacts` — CRUD, import, export, unsubscribe
-- `client.contact_properties` — custom properties
-- `client.segments` — create, list, get, update, delete, contacts, preview
-- `client.templates` — CRUD, publish, duplicate, presets
-- `client.webhooks` — CRUD, test, deliveries, replay
-- `client.broadcasts` — CRUD, send, test, variants
+- `client.emails` — send, get, list, cancel, reschedule, batch, events, insights, preview, spam_preview
+- `client.domains` — create, list, get, verify, update, delete, DMARC, DKIM rotation, inbox placement
+- `client.contacts` — CRUD, import, export_csv (text; optional `segment_id`), unsubscribe
+- `client.contact_properties` — custom properties, option_usage
+- `client.segments` — create, list, get, update, delete, contacts, preview, members, growth, broadcasts
+- `client.templates` — CRUD, publish, duplicate, render, presets
+- `client.webhooks` — CRUD, test, deliveries, replay, batch_replay, rotate_secret
+- `client.broadcasts` — CRUD, send, test, variants, resend, performance, non_openers, non_clickers, end_ab_test
 - `client.suppressions` — list, add, remove
-- `client.api_keys` — CRUD
-- `client.mailboxes` — CRUD, aliases, password
-- `client.subscription_topics` — topics + contact subscriptions
-- `client.workflows` — CRUD, steps, activate, pause, trigger
+- `client.api_keys` — CRUD, rotate
+- `client.mailboxes` — CRUD, aliases, password, filters, signature, shares, unread_summary
+- `client.inbound_emails` — list, get, attachments, download, draft_reply, reply, forward
+- `client.subscription_topics` — topics (get, update, list_subscribers) + contact subscriptions
+- `client.workflows` — CRUD, graph (get_graph/put_graph/validate_graph), activate, pause, trigger, post_event
+- `client.notification_channels` — Slack/Discord/Telegram alert channels: CRUD, test, deliveries, replay
 - `client.signup_forms` — CRUD, submit
 - `client.email_validations` — validate, validate_batch
 

{poststack-0.4.0 → poststack-0.9.0}/README.md

@@ -74,16 +74,28 @@ client = PostStack(api_key="sk_live_...")
 try:
     client.emails.send({"from": "x@y.com", "to": ["z@w.com"], "subject": "hi"})
 except PostStackError as e:
-    print(e.status_code, e.error, e.request_id)
+    print(e.status_code, e.error, e.code, e.request_id)
+    # e.headers holds the response headers; e.retry_after the Retry-After
+    # delay in seconds, when the API sent one.
 ```
 
+## Retries
+
+Network errors, timeouts, 408, 429 and 5xx responses are retried up to
+`max_retries` times (default 3) with full-jitter exponential backoff. A 429
+that carries `Retry-After` waits exactly that long (up to 60 seconds; a longer
+wait is raised instead). A 429 that is a quota rather than throttling — the
+monthly plan limit or the daily send cap, which carry an error code and no
+`Retry-After` — is raised immediately, since retrying cannot lift it.
+
 ## Configuration
 
 ```python
 client = PostStack(
     api_key="sk_live_...",
     base_url="https://api.poststack.dev",  # default
-    timeout=30.0,                           # default (seconds)
+    timeout=30.0,                           # default (seconds), per attempt
+    max_retries=3,                          # default; 0 disables retrying
 )
 ```
 
@@ -95,19 +107,21 @@ client.emails.send({...}, timeout=60.0)
 
 ## Resources
 
-- `client.emails` — send, get, list, cancel, reschedule, batch, events, insights
-- `client.domains` — create, list, get, verify, update, delete, DMARC
-- `client.contacts` — CRUD, import, export, unsubscribe
-- `client.contact_properties` — custom properties
-- `client.segments` — create, list, get, update, delete, contacts, preview
-- `client.templates` — CRUD, publish, duplicate, presets
-- `client.webhooks` — CRUD, test, deliveries, replay
-- `client.broadcasts` — CRUD, send, test, variants
+- `client.emails` — send, get, list, cancel, reschedule, batch, events, insights, preview, spam_preview
+- `client.domains` — create, list, get, verify, update, delete, DMARC, DKIM rotation, inbox placement
+- `client.contacts` — CRUD, import, export_csv (text; optional `segment_id`), unsubscribe
+- `client.contact_properties` — custom properties, option_usage
+- `client.segments` — create, list, get, update, delete, contacts, preview, members, growth, broadcasts
+- `client.templates` — CRUD, publish, duplicate, render, presets
+- `client.webhooks` — CRUD, test, deliveries, replay, batch_replay, rotate_secret
+- `client.broadcasts` — CRUD, send, test, variants, resend, performance, non_openers, non_clickers, end_ab_test
 - `client.suppressions` — list, add, remove
-- `client.api_keys` — CRUD
-- `client.mailboxes` — CRUD, aliases, password
-- `client.subscription_topics` — topics + contact subscriptions
-- `client.workflows` — CRUD, steps, activate, pause, trigger
+- `client.api_keys` — CRUD, rotate
+- `client.mailboxes` — CRUD, aliases, password, filters, signature, shares, unread_summary
+- `client.inbound_emails` — list, get, attachments, download, draft_reply, reply, forward
+- `client.subscription_topics` — topics (get, update, list_subscribers) + contact subscriptions
+- `client.workflows` — CRUD, graph (get_graph/put_graph/validate_graph), activate, pause, trigger, post_event
+- `client.notification_channels` — Slack/Discord/Telegram alert channels: CRUD, test, deliveries, replay
 - `client.signup_forms` — CRUD, submit
 - `client.email_validations` — validate, validate_batch
 

{poststack-0.4.0 → poststack-0.9.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "poststack"
-version = "0.4.0"
+version = "0.9.0"
 description = "Official Python SDK for the PostStack Email API"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -25,7 +25,8 @@ classifiers = [
 ]
 dependencies = [
     "httpx>=0.25.0",
-    "pydantic>=2.0.0",
+    # 2.4.0 floor closes GHSA-mr82-8j83-vxmv (regex DoS in 2.0–2.3.x).
+    "pydantic>=2.4.0",
 ]
 
 [project.optional-dependencies]
@@ -43,6 +44,9 @@ Issues = "https://github.com/getpoststack/python-sdk/issues"
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/poststack"]
+# PEP 561: ship the `py.typed` marker so downstream type checkers (mypy,
+# pyright) honor our annotations.
+include = ["src/poststack/py.typed"]
 
 [tool.hatch.build.targets.sdist]
 include = [

{poststack-0.4.0 → poststack-0.9.0}/src/poststack/__init__.py

@@ -10,10 +10,9 @@ Public API::
 
 from __future__ import annotations
 
-from typing import Optional
-
 from ._client import (
     DEFAULT_BASE_URL,
+    DEFAULT_MAX_RETRIES,
     AsyncPostStackClient,
     PostStackClient,
 )
@@ -27,7 +26,9 @@ from .resources import (
     AsyncDomainsResource,
     AsyncEmailsResource,
     AsyncEmailValidationsResource,
+    AsyncInboundEmailsResource,
     AsyncMailboxesResource,
+    AsyncNotificationChannelsResource,
     AsyncSegmentsResource,
     AsyncSignupFormsResource,
     AsyncSubscriptionTopicsResource,
@@ -41,7 +42,9 @@ from .resources import (
     DomainsResource,
     EmailsResource,
     EmailValidationsResource,
+    InboundEmailsResource,
     MailboxesResource,
+    NotificationChannelsResource,
     SegmentsResource,
     SignupFormsResource,
     SubscriptionTopicsResource,
@@ -51,7 +54,7 @@ from .resources import (
     WorkflowsResource,
 )
 
-__version__ = "0.4.0"
+__version__ = "0.9.0"
 
 __all__ = [
     "PostStack",
@@ -81,9 +84,13 @@ class PostStack:
         api_key: str,
         base_url: str = DEFAULT_BASE_URL,
         timeout: float = 30.0,
+        max_retries: int = DEFAULT_MAX_RETRIES,
     ) -> None:
         self._client = PostStackClient(
-            api_key=api_key, base_url=base_url, timeout=timeout
+            api_key=api_key,
+            base_url=base_url,
+            timeout=timeout,
+            max_retries=max_retries,
         )
         self.emails = EmailsResource(self._client)
         self.domains = DomainsResource(self._client)
@@ -96,10 +103,12 @@ class PostStack:
         self.suppressions = SuppressionsResource(self._client)
         self.api_keys = ApiKeysResource(self._client)
         self.mailboxes = MailboxesResource(self._client)
+        self.inbound_emails = InboundEmailsResource(self._client)
         self.subscription_topics = SubscriptionTopicsResource(self._client)
         self.workflows = WorkflowsResource(self._client)
         self.signup_forms = SignupFormsResource(self._client)
         self.email_validations = EmailValidationsResource(self._client)
+        self.notification_channels = NotificationChannelsResource(self._client)
 
     def close(self) -> None:
         self._client.close()
@@ -125,9 +134,13 @@ class AsyncPostStack:
         api_key: str,
         base_url: str = DEFAULT_BASE_URL,
         timeout: float = 30.0,
+        max_retries: int = DEFAULT_MAX_RETRIES,
     ) -> None:
         self._client = AsyncPostStackClient(
-            api_key=api_key, base_url=base_url, timeout=timeout
+            api_key=api_key,
+            base_url=base_url,
+            timeout=timeout,
+            max_retries=max_retries,
         )
         self.emails = AsyncEmailsResource(self._client)
         self.domains = AsyncDomainsResource(self._client)
@@ -140,10 +153,14 @@ class AsyncPostStack:
         self.suppressions = AsyncSuppressionsResource(self._client)
         self.api_keys = AsyncApiKeysResource(self._client)
         self.mailboxes = AsyncMailboxesResource(self._client)
+        self.inbound_emails = AsyncInboundEmailsResource(self._client)
         self.subscription_topics = AsyncSubscriptionTopicsResource(self._client)
         self.workflows = AsyncWorkflowsResource(self._client)
         self.signup_forms = AsyncSignupFormsResource(self._client)
         self.email_validations = AsyncEmailValidationsResource(self._client)
+        self.notification_channels = AsyncNotificationChannelsResource(
+            self._client
+        )
 
     async def aclose(self) -> None:
         await self._client.aclose()
@@ -155,5 +172,3 @@ class AsyncPostStack:
         await self.aclose()
 
 
-# Re-export for advanced callers.
-_: Optional[type] = None  # noqa: E305 - keeps ruff/mypy happy with Optional import