refactor(Audiences): add response types to create

Author: drish

examples/audiences.py

@@ -10,7 +10,9 @@
 create_params: resend.Audiences.CreateParams = {
     "name": "New Audience from Python SDK",
 }
-audience: resend.Audience = resend.Audiences.create(create_params)
+audience: resend.Audiences.CreateAudienceResponse = resend.Audiences.create(
+    create_params
+)
 print(f"Created audience: {audience['id']}")
 print(audience)
 

resend/audiences/_audiences.py

@@ -7,31 +7,52 @@
 from ._audience import Audience
 
 
-class _ListResponse(TypedDict):
-    data: List[Audience]
-    """
-    A list of audience objects
-    """
-
-
 class Audiences:
 
-    class ListResponse(_ListResponse):
+    class ListResponse(TypedDict):
         """
         ListResponse type that wraps a list of audience objects
 
         Attributes:
             data (List[Audience]): A list of audience objects
         """
 
+        data: List[Audience]
+        """
+        A list of audience objects
+        """
+
+    class CreateAudienceResponse(TypedDict):
+        """
+        CreateAudienceResponse is the type that wraps the response of the audience that was created
+
+        Attributes:
+            id (str): The ID of the created audience
+            name (str): The name of the created audience
+            created_at (str): When the audience was created
+        """
+
+        id: str
+        """
+        The ID of the created audience
+        """
+        name: str
+        """
+        The name of the created audience
+        """
+        created_at: str
+        """
+        When the audience was created
+        """
+
     class CreateParams(TypedDict):
         name: str
         """
         The name of the audience.
         """
 
     @classmethod
-    def create(cls, params: CreateParams) -> Audience:
+    def create(cls, params: CreateParams) -> CreateAudienceResponse:
         """
         Create a list of contacts.
         see more: https://resend.com/docs/api-reference/audiences/create-audience
@@ -40,10 +61,11 @@ def create(cls, params: CreateParams) -> Audience:
             params (CreateParams): The audience creation parameters
 
         Returns:
-            Audience: The new audience object
+            CreateAudienceResponse: The created audience response
         """
+
         path = "/audiences"
-        resp = request.Request[Audience](
+        resp = request.Request[Audiences.CreateAudienceResponse](
             path=path, params=cast(Dict[Any, Any], params), verb="post"
         ).perform_with_content()
         return resp
@@ -58,7 +80,7 @@ def list(cls) -> ListResponse:
             ListResponse: A list of audience objects
         """
         path = "/audiences/"
-        resp = request.Request[_ListResponse](
+        resp = request.Request[Audiences.ListResponse](
             path=path, params={}, verb="get"
         ).perform_with_content()
         return resp