feat: add async methods for missing packages

Author: drish

examples/contacts_async.py

@@ -1,6 +1,5 @@
 import asyncio
 import os
-from typing import List
 
 import resend
 
@@ -23,7 +22,9 @@ async def main() -> None:
         "unsubscribed": False,
     }
 
-    contact: resend.Contact = await resend.Contacts.create_async(create_params)
+    contact: resend.Contacts.CreateContactResponse = await resend.Contacts.create_async(
+        create_params
+    )
     print("Created contact !")
     print(contact)
 
@@ -34,7 +35,9 @@ async def main() -> None:
         "first_name": "Steve (Async)",
     }
 
-    updated: resend.Contact = await resend.Contacts.update_async(update_params)
+    updated: resend.Contacts.UpdateContactResponse = await resend.Contacts.update_async(
+        update_params
+    )
     print("updated contact !")
     print(updated)
 
@@ -54,12 +57,12 @@ async def main() -> None:
         audience_id=audience_id
     )
     print("List of contacts")
-    for contact in contacts["data"]:
-        print(contact)
+    for c in contacts["data"]:
+        print(c)
 
     # remove by email
     rmed = await resend.Contacts.remove_async(
-        audience_id=audience_id, email=contact["email"]
+        audience_id=audience_id, email=cont_by_email["email"]
     )
 
     # remove by id

examples/domains_async.py

@@ -16,7 +16,9 @@ async def main() -> None:
         "region": "us-east-1",
         "custom_return_path": "outbound",
     }
-    domain: resend.Domain = await resend.Domains.create_async(params=create_params)
+    domain: resend.Domains.CreateDomainResponse = await resend.Domains.create_async(
+        params=create_params
+    )
     print(domain)
 
     retrieved: resend.Domain = await resend.Domains.get_async(domain_id=domain["id"])
@@ -37,13 +39,13 @@ async def main() -> None:
     domains: resend.Domains.ListResponse = await resend.Domains.list_async()
     if not domains:
         print("No domains found")
-    for domain in domains["data"]:
-        print(domain)
+    for d in domains["data"]:
+        print(d)
 
     verified_domain: resend.Domain = await resend.Domains.verify_async(
         domain_id=domain["id"]
     )
-    print(f"Verified")
+    print("Verified")
     print(verified_domain)
 
     rm_domain: resend.Domain = await resend.Domains.remove_async(domain_id=domain["id"])

examples/simple_email_async.py

@@ -26,14 +26,18 @@
 
 async def main() -> None:
     # Without Idempotency Key
-    email_non_idempotent: resend.Email = await resend.Emails.send_async(params)
+    email_non_idempotent: resend.Emails.SendResponse = await resend.Emails.send_async(
+        params
+    )
     print(f"Sent email without idempotency key: {email_non_idempotent['id']}")
 
     # With Idempotency Key
     options: resend.Emails.SendOptions = {
         "idempotency_key": "44",
     }
-    email_idempotent: resend.Email = await resend.Emails.send_async(params, options)
+    email_idempotent: resend.Emails.SendResponse = 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(

resend/contact_properties/_contact_properties.py

@@ -6,6 +6,12 @@
 from resend._base_response import BaseResponse
 from resend.pagination_helper import PaginationHelper
 
+# Async imports (optional - only available with pip install resend[async])
+try:
+    from resend.async_request import AsyncRequest
+except ImportError:
+    pass
+
 from ._contact_property import ContactProperty
 
 
@@ -261,3 +267,96 @@ def remove(cls, id: str) -> RemoveResponse:
             path=path, params={}, verb="delete"
         ).perform_with_content()
         return resp
+
+    @classmethod
+    async def create_async(cls, params: CreateParams) -> CreateResponse:
+        """
+        Create a new contact property (async).
+        see more: https://resend.com/docs/api-reference/contact-properties/create-contact-property
+
+        Args:
+            params (CreateParams): The contact property creation parameters
+
+        Returns:
+            CreateResponse: The created contact property response
+        """
+        path = "/contact-properties"
+        resp = await AsyncRequest[ContactProperties.CreateResponse](
+            path=path, params=cast(Dict[Any, Any], params), verb="post"
+        ).perform_with_content()
+        return resp
+
+    @classmethod
+    async def get_async(cls, id: str) -> ContactProperty:
+        """
+        Get a contact property by ID (async).
+        see more: https://resend.com/docs/api-reference/contact-properties/get-contact-property
+
+        Args:
+            id (str): The contact property ID
+
+        Returns:
+            ContactProperty: The contact property object
+        """
+        path = f"/contact-properties/{id}"
+        resp = await AsyncRequest[ContactProperty](
+            path=path, params={}, verb="get"
+        ).perform_with_content()
+        return resp
+
+    @classmethod
+    async def list_async(cls, params: Optional[ListParams] = None) -> ListResponse:
+        """
+        List all contact properties (async).
+        see more: https://resend.com/docs/api-reference/contact-properties/list-contact-properties
+
+        Args:
+            params (Optional[ListParams]): Optional pagination parameters
+
+        Returns:
+            ListResponse: A list of contact property objects
+        """
+        base_path = "/contact-properties"
+        query_params = cast(Dict[Any, Any], params) if params else None
+        path = PaginationHelper.build_paginated_path(base_path, query_params)
+        resp = await AsyncRequest[ContactProperties.ListResponse](
+            path=path, params={}, verb="get"
+        ).perform_with_content()
+        return resp
+
+    @classmethod
+    async def update_async(cls, params: UpdateParams) -> UpdateResponse:
+        """
+        Update an existing contact property (async).
+        see more: https://resend.com/docs/api-reference/contact-properties/update-contact-property
+
+        Args:
+            params (UpdateParams): The contact property update parameters
+
+        Returns:
+            UpdateResponse: The updated contact property response
+        """
+        path = f"/contact-properties/{params['id']}"
+        payload: Dict[str, Any] = {"fallback_value": params["fallback_value"]}
+        resp = await AsyncRequest[ContactProperties.UpdateResponse](
+            path=path, params=payload, verb="patch"
+        ).perform_with_content()
+        return resp
+
+    @classmethod
+    async def remove_async(cls, id: str) -> RemoveResponse:
+        """
+        Remove a contact property by ID (async).
+        see more: https://resend.com/docs/api-reference/contact-properties/delete-contact-property
+
+        Args:
+            id (str): The contact property ID
+
+        Returns:
+            RemoveResponse: The removed contact property response object
+        """
+        path = f"/contact-properties/{id}"
+        resp = await AsyncRequest[ContactProperties.RemoveResponse](
+            path=path, params={}, verb="delete"
+        ).perform_with_content()
+        return resp

resend/contacts/_contacts.py

@@ -357,42 +357,62 @@ def remove(
         return resp
 
     @classmethod
-    async def create_async(cls, params: CreateParams) -> Contact:
+    async def create_async(cls, params: CreateParams) -> CreateContactResponse:
         """
         Create a new contact (async).
+        Can create either a global contact or an audience-specific contact.
         see more: https://resend.com/docs/api-reference/contacts/create-contact
 
         Args:
             params (CreateParams): The contact creation parameters
+                - If audience_id is provided: creates audience-specific contact
+                - If audience_id is omitted: creates global contact with optional properties field
 
         Returns:
-            Contact: The new contact object
+            CreateContactResponse: The created contact response
         """
-        path = f"/audiences/{params['audience_id']}/contacts"
-        resp = await AsyncRequest[Contact](
+        audience_id = params.get("audience_id")
+
+        if audience_id:
+            path = f"/audiences/{audience_id}/contacts"
+        else:
+            path = "/contacts"
+
+        resp = await AsyncRequest[Contacts.CreateContactResponse](
             path=path, params=cast(Dict[Any, Any], params), verb="post"
         ).perform_with_content()
         return resp
 
     @classmethod
-    async def update_async(cls, params: UpdateParams) -> Contact:
+    async def update_async(cls, params: UpdateParams) -> UpdateContactResponse:
         """
         Update an existing contact (async).
+        Can update either a global contact or an audience-specific contact.
         see more: https://resend.com/docs/api-reference/contacts/update-contact
 
         Args:
             params (UpdateParams): The contact update parameters
+                - If audience_id is provided: updates audience-specific contact
+                - If audience_id is omitted: updates global contact with optional properties field
 
         Returns:
-            Contact: The updated contact object
+            UpdateContactResponse: The updated contact response.
         """
         if params.get("id") is None and params.get("email") is None:
             raise ValueError("id or email must be provided")
 
-        val = params.get("id") if params.get("id") is not None else params.get("email")
+        # Email takes precedence over id (matching Node.js behavior)
+        contact_identifier = (
+            params.get("email") if params.get("email") is not None else params.get("id")
+        )
+        audience_id = params.get("audience_id")
 
-        path = f"/audiences/{params['audience_id']}/contacts/{val}"
-        resp = await AsyncRequest[Contact](
+        if audience_id:
+            path = f"/audiences/{audience_id}/contacts/{contact_identifier}"
+        else:
+            path = f"/contacts/{contact_identifier}"
+
+        resp = await AsyncRequest[Contacts.UpdateContactResponse](
             path=path, params=cast(Dict[Any, Any], params), verb="patch"
         ).perform_with_content()
         return resp
@@ -403,6 +423,7 @@ async def list_async(
     ) -> ListResponse:
         """
         List all contacts (async).
+        Can list either global contacts or audience-specific contacts.
         see more: https://resend.com/docs/api-reference/contacts/list-contacts
 
         Args:
@@ -426,25 +447,34 @@ async def list_async(
 
     @classmethod
     async def get_async(
-        cls, audience_id: str, id: Optional[str] = None, email: Optional[str] = None
+        cls,
+        audience_id: Optional[str] = None,
+        id: Optional[str] = None,
+        email: Optional[str] = None,
     ) -> Contact:
         """
         Get a contact (async).
+        Can retrieve either a global contact or an audience-specific contact.
         see more: https://resend.com/docs/api-reference/contacts/get-contact
 
         Args:
-            audience_id (str): The audience ID
-            id (Optional[str]): The contact ID
-            email (Optional[str]): The contact email
+            audience_id (Optional[str]): The audience ID. If not provided, retrieves global contact.
+            id (Optional[str]): The contact ID. Either id or email must be provided.
+            email (Optional[str]): The contact email. Either id or email must be provided.
 
         Returns:
             Contact: The contact object
         """
-        contact = email if id is None else id
-        if contact is None:
+        # Email takes precedence over id (matching Node.js behavior)
+        contact_identifier = email if email is not None else id
+        if contact_identifier is None:
             raise ValueError("id or email must be provided")
 
-        path = f"/audiences/{audience_id}/contacts/{contact}"
+        if audience_id:
+            path = f"/audiences/{audience_id}/contacts/{contact_identifier}"
+        else:
+            path = f"/contacts/{contact_identifier}"
+
         resp = await AsyncRequest[Contact](
             path=path, params={}, verb="get"
         ).perform_with_content()
@@ -459,6 +489,7 @@ async def remove_async(
     ) -> RemoveContactResponse:
         """
         Remove a contact by ID or by Email (async).
+        Can remove either a global contact or an audience-specific contact.
         see more: https://resend.com/docs/api-reference/contacts/delete-contact
 
         Args: