nexttoken 0.3.2__tar.gz → 0.4.0__tar.gz

{nexttoken-0.3.2 → nexttoken-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nexttoken
-Version: 0.3.2
+Version: 0.4.0
 Summary: NextToken SDK - Simple client for the NextToken APIs and Gateway
 Project-URL: Homepage, https://nexttoken.co
 Project-URL: Documentation, https://docs.nexttoken.co

{nexttoken-0.3.2 → nexttoken-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "nexttoken"
-version = "0.3.2"
+version = "0.4.0"
 description = "NextToken SDK - Simple client for the NextToken APIs and Gateway"
 readme = "README.md"
 license = "MIT"

{nexttoken-0.3.2 → nexttoken-0.4.0}/src/nexttoken/__init__.py

@@ -1,8 +1,9 @@
 """NextToken SDK - Simple client for the NextToken Gateway."""
 
 from .client import NextToken
+from .email import Email
 from .integrations import Integrations
 from .search import Search
 
-__version__ = "0.3.0"
-__all__ = ["NextToken", "Integrations", "Search", "__version__"]
+__version__ = "0.4.0"
+__all__ = ["NextToken", "Email", "Integrations", "Search", "__version__"]

{nexttoken-0.3.2 → nexttoken-0.4.0}/src/nexttoken/client.py

@@ -6,6 +6,7 @@ import os
 
 from openai import OpenAI
 
+from .email import Email
 from .integrations import Integrations
 from .search import Search
 
@@ -55,6 +56,7 @@ class NextToken:
             base_url=gateway_url,
         )
         api_url = api_base_url or os.environ.get("NEXTTOKEN_API_BASE_URL")
+        self._email = Email(api_key=resolved_key, base_url=api_url)
         self._integrations = Integrations(api_key=resolved_key, base_url=api_url)
         self._search = Search(api_key=resolved_key, base_url=api_url)
 
@@ -73,6 +75,11 @@ class NextToken:
         """Access models list."""
         return self._client.models
 
+    @property
+    def email(self) -> Email:
+        """Access email API for sending transactional emails."""
+        return self._email
+
     @property
     def integrations(self) -> Integrations:
         """Access integrations API for connected third-party services."""

nexttoken-0.4.0/src/nexttoken/email.py

@@ -0,0 +1,82 @@
+"""NextToken Email client for sending transactional emails."""
+
+from __future__ import annotations
+
+from typing import Any, Dict, Optional
+
+import requests
+
+
+class Email:
+    """Client for NextToken Email API.
+
+    Sends emails on behalf of the authenticated user via the
+    NextToken transactional email service.
+
+    Example:
+        >>> from nexttoken import NextToken
+        >>> client = NextToken(api_key="your-api-key")
+        >>> result = client.email.send(
+        ...     subject="Daily Report",
+        ...     body="Here is your daily report...",
+        ... )
+        >>> print(result)  # {"success": True, "message_id": "..."}
+    """
+
+    DEFAULT_BASE_URL = "https://api.nexttoken.co"
+
+    def __init__(self, api_key: str, base_url: Optional[str] = None):
+        self._api_key = api_key
+        self._base_url = (base_url or self.DEFAULT_BASE_URL).rstrip("/")
+
+    def _headers(self) -> Dict[str, str]:
+        return {
+            "Authorization": f"Bearer {self._api_key}",
+            "Content-Type": "application/json",
+        }
+
+    def _request(self, method: str, path: str, **kwargs) -> Dict[str, Any]:
+        url = f"{self._base_url}{path}"
+        response = requests.request(
+            method, url, headers=self._headers(), **kwargs
+        )
+        response.raise_for_status()
+        return response.json()
+
+    def send(
+        self,
+        subject: str,
+        body: str,
+        to: Optional[str] = None,
+        body_html: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """Send an email.
+
+        The email is sent from a personalized NextToken address
+        (e.g., ``John Doe <john-doe@nexttoken.dev>``) with reply-to
+        set to the user's real email address.
+
+        Args:
+            subject: Email subject line.
+            body: Plain text email body.
+            to: Recipient address. Defaults to the user's own email.
+            body_html: Optional HTML body for rich formatting.
+
+        Returns:
+            Dict with ``success`` and ``message_id`` keys.
+        """
+        payload: Dict[str, Any] = {"subject": subject, "body": body}
+        if to is not None:
+            payload["to"] = to
+        if body_html is not None:
+            payload["body_html"] = body_html
+
+        return self._request("POST", "/email/send", json=payload)
+
+    def usage(self) -> Dict[str, Any]:
+        """Get email usage stats for the authenticated user.
+
+        Returns:
+            Dict with ``sent_today``, ``daily_limit``, and ``tier`` keys.
+        """
+        return self._request("GET", "/api/public/email/usage")