sendly-python 1.2.0__py3-none-any.whl → 1.3.0__py3-none-any.whl

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/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

{sendly_python-1.2.0.dist-info → sendly_python-1.3.0.dist-info}/METADATA

@@ -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.dist-info → sendly_python-1.3.0.dist-info}/RECORD

@@ -1,8 +1,8 @@
 sendly/__init__.py,sha256=KNGjrzKPY88Qo8J4LCWxa4Ae0Dwk1JIREQ9IFF2R8bY,3143
-sendly/client.py,sha256=a_2zC-EdBlvAyOk01iBIwG0jSzQwxwM9fJL2dlHLPXA,13536
+sendly/client.py,sha256=TqB84R4C3pXBinW3kg3WozKNucIGVS9t1xotgrdav9Q,13536
 sendly/errors.py,sha256=urF33X-d39OEiasLh6C7PlrrUmmrS3XIMvFYj20rUy8,7002
 sendly/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sendly/types.py,sha256=bFEjl4twmwtCUdw5zO5QF8C3d3dn1s63cghJCrMzkXM,7625
+sendly/types.py,sha256=2cbZqteyutTuIxllK9Sq79_D6XjObzRSHRenRuCZ3hw,7997
 sendly/webhook_utils.py,sha256=epmK860gLknaElxfXdVD3h_9ASkjWQsyl1exUC8qBL4,4762
 sendly/resources/__init__.py,sha256=Nf7zjcFjsztXsGtrvxq3KGacX7SwDgSf3r0nAVHLvPY,73
 sendly/resources/_helpers.py,sha256=W6AlzXuqH53Vk1dIxuQm_-Vpq9gmZvLzKPRionjH9wQ,550
@@ -27,7 +27,7 @@ sendly/resources/validation.py,sha256=sS0gAs5Kph-QK73YZ7dkZCUP2ZPiDtyO1DLlQuZAle
 sendly/resources/verify.py,sha256=QyVNmrzZ4Nj87YWxMPt9wlovcCyZutV9eGmn49c0EEg,818
 sendly/resources/webhooks.py,sha256=w0ZwueAGKTP6Du3b6jMr24C9nv_a_vnDExYYy3N1pfA,8036
 sendly/resources/workflows.py,sha256=wZUpL57lrKmgcdjNaLS89lyEG2D1Ov2EKfXSlcQFn74,9768
-sendly_python-1.2.0.dist-info/METADATA,sha256=ZrtlQzGFqwMHFh0H9j8pUeZyA8P9zLs5rE839FedC_M,59817
-sendly_python-1.2.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-sendly_python-1.2.0.dist-info/licenses/LICENSE,sha256=TZHT_f_vV-xujWjSy7EkTybNT6iivrfGHLd-rR1Xl7c,1073
-sendly_python-1.2.0.dist-info/RECORD,,
+sendly_python-1.3.0.dist-info/METADATA,sha256=lgummrFC5rHDlamNCa0jscQR9JokeLdnNifo9tQj4lg,60764
+sendly_python-1.3.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+sendly_python-1.3.0.dist-info/licenses/LICENSE,sha256=TZHT_f_vV-xujWjSy7EkTybNT6iivrfGHLd-rR1Xl7c,1073
+sendly_python-1.3.0.dist-info/RECORD,,