fix: misc fixes

Author: drish

examples/simple_email_async.py

@@ -2,13 +2,12 @@
 import os
 
 import resend
-from resend import HTTPXClient
 
 if not os.environ["RESEND_API_KEY"]:
     raise EnvironmentError("RESEND_API_KEY is missing")
 
 # Set up async HTTP client
-resend.default_http_client = HTTPXClient()
+resend.default_http_client = resend.HTTPXClient()
 
 params: resend.Emails.SendParams = {
     "from": "onboarding@resend.dev",
@@ -25,7 +24,7 @@
 }
 
 
-async def main():
+async def main() -> None:
     # Without Idempotency Key
     email_non_idempotent: resend.Email = await resend.Emails.send_async(params)
     print(f"Sent email without idempotency key: {email_non_idempotent['id']}")
@@ -37,7 +36,9 @@ async def main():
     email_idempotent: resend.Email = await resend.Emails.send_async(params, options)
     print(f"Sent email with idempotency key: {email_idempotent['id']}")
 
-    email_resp: resend.Email = await resend.Emails.get_async(email_id=email_non_idempotent["id"])
+    email_resp: resend.Email = await resend.Emails.get_async(
+        email_id=email_non_idempotent["id"]
+    )
     print(f"Retrieved email: {email_resp['id']}")
     print("Email ID: ", email_resp["id"])
     print("Email from: ", email_resp["from"])
@@ -51,4 +52,4 @@ async def main():
 
 
 if __name__ == "__main__":
-    asyncio.run(main())
+    asyncio.run(main())

resend/__init__.py

@@ -1,4 +1,5 @@
 import os
+from typing import Union
 
 from .api_keys._api_key import ApiKey
 from .api_keys._api_keys import ApiKeys
@@ -16,25 +17,24 @@
 from .emails._emails import Emails
 from .emails._tag import Tag
 from .http_client import HTTPClient
+from .http_client_async import \
+    AsyncHTTPClient  # Okay to import AsyncHTTPClient since it is just an interface.
 from .http_client_requests import RequestsClient
 from .request import Request
-
-# Async imports (optional - only available with pip install resend[async])
-try:
-    from .http_client_async import AsyncHTTPClient
-    from .http_client_httpx import HTTPXClient
-    from .async_request import AsyncRequest
-except ImportError:
-    # Async classes not available without httpx dependency
-    pass
 from .version import __version__, get_version
 
+# Type for clients that support both sync and async
+ResendHTTPClient = Union[HTTPClient, AsyncHTTPClient]
+
+# This is the client that is set by default HTTP Client
+# But this can be overridden by the user and set to an async client.
+default_http_client: ResendHTTPClient = RequestsClient()
+
+
 # Config vars
 api_key = os.environ.get("RESEND_API_KEY")
 api_url = os.environ.get("RESEND_API_URL", "https://api.resend.com")
 
-# HTTP Client
-default_http_client: HTTPClient = RequestsClient()
 
 # API resources
 from .emails._emails import Emails  # noqa
@@ -66,11 +66,9 @@
 
 # Add async exports if available
 try:
-    from .http_client_httpx import HTTPXClient
-    __all__.extend([
-        "AsyncHTTPClient", 
-        "HTTPXClient",
-        "AsyncRequest"
-    ])
+    from .async_request import AsyncRequest  # noqa: F401
+    from .http_client_httpx import HTTPXClient  # noqa: F401
+
+    __all__.extend(["AsyncHTTPClient", "HTTPXClient", "AsyncRequest"])
 except ImportError:
     pass

resend/async_request.py

@@ -6,6 +6,7 @@
 import resend
 from resend.exceptions import (NoContentError, ResendError,
                                raise_for_code_and_type)
+from resend.http_client_async import AsyncHTTPClient
 from resend.version import get_version
 
 RequestVerb = Literal["get", "post", "put", "patch", "delete"]
@@ -71,7 +72,9 @@ async def make_request(self, url: str) -> Union[Dict[str, Any], List[Any]]:
             json_params = None
 
         try:
-            content, _status_code, resp_headers = await resend.default_http_client.request(
+            # Cast to AsyncHTTPClient for type checking - user must set HTTPXClient
+            async_client = cast(AsyncHTTPClient, resend.default_http_client)
+            content, _status_code, resp_headers = await async_client.request(
                 method=self.verb,
                 url=url,
                 headers=headers,
@@ -105,4 +108,4 @@ async def make_request(self, url: str) -> Union[Dict[str, Any], List[Any]]:
                 code=500,
                 message="Failed to decode JSON response",
                 error_type="InternalServerError",
-            )
+            )

resend/emails/_emails.py

@@ -256,7 +256,9 @@ def update(cls, params: UpdateParams) -> UpdateEmailResponse:
         return resp
 
     @classmethod
-    async def send_async(cls, params: SendParams, options: Optional[SendOptions] = None) -> Email:
+    async def send_async(
+        cls, params: SendParams, options: Optional[SendOptions] = None
+    ) -> Email:
         """
         Send an email through the Resend Email API (async version).
         see more: https://resend.com/docs/api-reference/emails/send-email

resend/http_client_async.py

@@ -17,4 +17,4 @@ async def request(
         headers: Mapping[str, str],
         json: Optional[Union[Dict[str, object], List[object]]] = None,
     ) -> Tuple[bytes, int, Mapping[str, str]]:
-        pass
+        pass

resend/http_client_httpx.py

@@ -37,4 +37,4 @@ async def request(
         except httpx.RequestError as e:
             # This gets caught by the async request.perform() method
             # and raises a ResendError with the error type "HttpClientError"
-            raise RuntimeError(f"Request failed: {e}") from e
+            raise RuntimeError(f"Request failed: {e}") from e

resend/request.py

@@ -71,7 +71,12 @@ def make_request(self, url: str) -> Union[Dict[str, Any], List[Any]]:
             json_params = None
 
         try:
-            content, _status_code, resp_headers = resend.default_http_client.request(
+            # Cast to HTTPClient for type checking - sync context expects sync client
+            from resend.http_client import HTTPClient
+
+            sync_client = cast(HTTPClient, resend.default_http_client)
+
+            content, _status_code, resp_headers = sync_client.request(
                 method=self.verb,
                 url=url,
                 headers=headers,