mailkite-dev 0.4.0__tar.gz → 0.5.0__tar.gz

{mailkite_dev-0.4.0 → mailkite_dev-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mailkite-dev
-Version: 0.4.0
+Version: 0.5.0
 Summary: Official MailKite SDK for Python — send and manage email over your own authenticated domain.
 License: MIT
 Project-URL: Homepage, https://mailkite.dev/docs/libraries

{mailkite_dev-0.4.0 → mailkite_dev-0.5.0}/mailkite/__init__.py

@@ -22,7 +22,7 @@ DEFAULT_BASE_URL = "https://api.mailkite.dev"
 # Reject webhook events older than this (ms) to block replays. Pass 0 to disable.
 DEFAULT_TOLERANCE_MS = 5 * 60 * 1000
 
-__all__ = ["MailKite", "MailKiteError", "verify_webhook", "reply_ok", "encrypt", "decrypt"]
+__all__ = ["MailKite", "MailKiteError", "verify_webhook", "reply_ok", "reply_spam", "reply_drop", "reply_block_sender", "encrypt", "decrypt"]
 
 
 def verify_webhook(signature, payload, secret, toleranceMs=DEFAULT_TOLERANCE_MS):
@@ -61,6 +61,28 @@ def reply_ok():
     return '{"status":"ok"}'
 
 
+def reply_spam():
+    """Control-mode reply telling MailKite to mark the message as spam.
+
+    Returns the exact string ``{"status":"spam"}``. No network call."""
+    return '{"status":"spam"}'
+
+
+def reply_drop():
+    """Control-mode reply telling MailKite to drop (discard) the message.
+
+    Returns the exact string ``{"status":"drop"}``. No network call."""
+    return '{"status":"drop"}'
+
+
+def reply_block_sender():
+    """Control-mode reply telling MailKite to block the sender.
+
+    Returns the exact string ``{"status":"ok","actions":[{"type":"block-sender"}]}``.
+    No network call."""
+    return '{"status":"ok","actions":[{"type":"block-sender"}]}'
+
+
 def encrypt(plaintext, public_key):
     """Encrypt a UTF-8 string to a MailKite at-rest envelope (JSON string).
 
@@ -167,6 +189,15 @@ class MailKite:
         and ``templateData`` (dict) to supply its variables."""
         return self.request("POST", "/v1/send", message)
 
+    def uploadAttachment(self, file):
+        """Upload a file (base64 ``content``) and get back a secure,
+        time-limited URL to reference as a send() attachment
+        (``{ filename, url }``) or link inline — instead of base64-inlining
+        large files on every send. ``file`` is a dict with ``filename`` and
+        ``content`` (base64 str), plus optional ``contentType`` and
+        ``retentionDays`` (7 | 30 | 90 | 365, default 7)."""
+        return self.request("POST", "/v1/attachments", file)
+
     def agent(self, message):
         """Send a message to an AI agent inbox. ``message`` is a dict with
         ``text`` (required) and optional ``subject``, ``from``, ``html``,
@@ -251,6 +282,21 @@ class MailKite:
         :func:`reply_ok`."""
         return reply_ok()
 
+    def reply_spam(self):
+        """Control-mode reply marking the message as spam. See module-level
+        :func:`reply_spam`."""
+        return reply_spam()
+
+    def reply_drop(self):
+        """Control-mode reply dropping the message. See module-level
+        :func:`reply_drop`."""
+        return reply_drop()
+
+    def reply_block_sender(self):
+        """Control-mode reply blocking the sender. See module-level
+        :func:`reply_block_sender`."""
+        return reply_block_sender()
+
     def encrypt(self, plaintext, public_key):
         """Encrypt to a MailKite at-rest envelope. See module-level
         :func:`encrypt`."""

{mailkite_dev-0.4.0 → mailkite_dev-0.5.0}/mailkite_dev.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mailkite-dev
-Version: 0.4.0
+Version: 0.5.0
 Summary: Official MailKite SDK for Python — send and manage email over your own authenticated domain.
 License: MIT
 Project-URL: Homepage, https://mailkite.dev/docs/libraries

{mailkite_dev-0.4.0 → mailkite_dev-0.5.0}/pyproject.toml

@@ -7,7 +7,7 @@ build-backend = "setuptools.build_meta"
 # old account. Installs as `pip install mailkite-dev`; still imports as `import mailkite`
 # (the package dir below is unchanged). Rename back to `mailkite` once reclaimed.
 name = "mailkite-dev"
-version = "0.4.0"
+version = "0.5.0"
 description = "Official MailKite SDK for Python — send and manage email over your own authenticated domain."
 readme = "README.md"
 requires-python = ">=3.7"