sendly-python 1.2.0__tar.gz → 1.3.0__tar.gz

{sendly_python-1.2.0 → sendly_python-1.3.0}/CHANGELOG.md

@@ -5,6 +5,27 @@ All notable changes to `sendly-python` are documented here. This project adheres
 
 ## [Unreleased]
 
+## [1.3.0] - 2026-11-07
+
+### Added
+
+- **Why a message bounced or was complained about.** An email (`emails.get`, `emails.list`)
+  gains the keys `bounceType`, `bounceSubType`, `bounceStatusCode`, `bounceDiagnosticCode` and
+  `complaintFeedbackType`; each entry of its delivery history gains the four `bounce*` keys. The
+  `email.bounced` webhook body gains `bounceSubType`, `bounceStatusCode` and
+  `bounceDiagnosticCode`, and `email.complained` gains `complaintFeedbackType`. All are `str | None`
+  and additive: responses are plain dicts, so existing code is unaffected.
+- **Three other optional fields arrive with the re-sync:** `Email.hold`, `Problem.next` and
+  `CreateApiKeyBody.tiers`. All are optional and additive.
+
+### Changed
+
+- **The vendored contract is re-synced** from the released one (`docs.sendly.now/openapi.json`),
+  which had grown from 106 to 198 paths since the last sync. The additions are account, dashboard
+  and member-management routes plus key-callable operations this SDK has no method for yet; the
+  contract suite lists them in `NOT_SDK_CALLABLE` / `NOT_YET_IMPLEMENTED` rather than shipping
+  them unreviewed. No existing method changed.
+
 ## [1.2.0] - 2026-11-03
 
 ### Added

{sendly_python-1.2.0 → sendly_python-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sendly-python
-Version: 1.2.0
+Version: 1.3.0
 Summary: Official Python SDK for Sendly (sendly.now), the email API and platform for developers by Devino Solutions: transactional email, contacts, templates and webhooks.
 Project-URL: Homepage, https://sendly.now
 Project-URL: Documentation, https://docs.sendly.now
@@ -311,6 +311,26 @@ for event in email["events"]:
 somebody opened, read `openedAt` / `opens` on the rows — engagement is not a
 status.
 
+A bounced or complained message says why. Each key below is `str | None` and is
+`None` until the event happens (or when the receiving server did not say):
+
+```python
+email = sendly.emails.get("em_123")["data"]
+if email["status"] == "BOUNCED":
+    # `bounceType` is "Permanent" or "Undetermined" here (a "Transient" bounce is
+    # retried and never sets BOUNCED); the rest are the receiving server's own words.
+    # Show them to a person, do not parse them.
+    print(email["bounceType"], email["bounceSubType"],
+          email["bounceStatusCode"], email["bounceDiagnosticCode"])
+if email["complainedAt"] is not None:
+    print(email["complaintFeedbackType"])  # e.g. "abuse"
+```
+
+Each entry of `email["events"]` carries the same four `bounce*` keys for the
+transition that recorded them. The `email.bounced` webhook body adds
+`bounceSubType`, `bounceStatusCode` and `bounceDiagnosticCode`, and
+`email.complained` adds `complaintFeedbackType`.
+
 ### Contacts
 
 ```python

{sendly_python-1.2.0 → sendly_python-1.3.0}/README.md

@@ -279,6 +279,26 @@ for event in email["events"]:
 somebody opened, read `openedAt` / `opens` on the rows — engagement is not a
 status.
 
+A bounced or complained message says why. Each key below is `str | None` and is
+`None` until the event happens (or when the receiving server did not say):
+
+```python
+email = sendly.emails.get("em_123")["data"]
+if email["status"] == "BOUNCED":
+    # `bounceType` is "Permanent" or "Undetermined" here (a "Transient" bounce is
+    # retried and never sets BOUNCED); the rest are the receiving server's own words.
+    # Show them to a person, do not parse them.
+    print(email["bounceType"], email["bounceSubType"],
+          email["bounceStatusCode"], email["bounceDiagnosticCode"])
+if email["complainedAt"] is not None:
+    print(email["complaintFeedbackType"])  # e.g. "abuse"
+```
+
+Each entry of `email["events"]` carries the same four `bounce*` keys for the
+transition that recorded them. The `email.bounced` webhook body adds
+`bounceSubType`, `bounceStatusCode` and `bounceDiagnosticCode`, and
+`email.complained` adds `complaintFeedbackType`.
+
 ### Contacts
 
 ```python

{sendly_python-1.2.0 → sendly_python-1.3.0}/pyproject.toml

@@ -8,7 +8,7 @@ build-backend = "hatchling.build"
 # the PyPI trusted-publisher configuration). The import package is
 # unchanged (`import sendly`) — see [tool.hatch.build.targets.wheel] below.
 name = "sendly-python"
-version = "1.2.0"
+version = "1.3.0"
 description = "Official Python SDK for Sendly (sendly.now), the email API and platform for developers by Devino Solutions: transactional email, contacts, templates and webhooks."
 readme = "README.md"
 requires-python = ">=3.10"

{sendly_python-1.2.0 → sendly_python-1.3.0}/src/sendly/client.py

@@ -64,7 +64,7 @@ if TYPE_CHECKING:
 __all__ = ["DEFAULT_BASE_URL", "SDK_VERSION", "Sendly"]
 
 #: Package version. Kept in sync with ``pyproject.toml``.
-SDK_VERSION = "1.2.0"
+SDK_VERSION = "1.3.0"
 
 #: Default production API base. Override via ``base_url`` for staging/self-hosted.
 DEFAULT_BASE_URL = "https://api.sendly.now"

{sendly_python-1.2.0 → sendly_python-1.3.0}/src/sendly/types.py

@@ -39,12 +39,16 @@ Pagination = JSONDict
 SendEmailData = JSONDict
 SendEmailResponse = JSONDict
 BatchSendResponse = JSONDict
+#: An email row. Beyond the delivery fields it carries, ``str | None`` and ``None``
+#: until the event happens, ``bounceType``, ``bounceSubType``, ``bounceStatusCode``,
+#: ``bounceDiagnosticCode`` and ``complaintFeedbackType``.
 EmailRecord = JSONDict
 EmailListResponse = JSONDict
 
 #: One transition in a message's delivery history -- the append-only record
 #: behind ``status``. ``status`` says where the message is now; these say how it
-#: got there.
+#: got there. A bounce transition also carries ``bounceType``, ``bounceSubType``,
+#: ``bounceStatusCode`` and ``bounceDiagnosticCode`` (each ``str | None``).
 EmailEvent = JSONDict
 #: An email together with its delivery history, oldest first.
 EmailWithEvents = JSONDict