Email response a bit misleading

[tim-hub]

I am not sure whether it is a future plan to change the email send respons type, however, the python sdk response type and the real RESTful api response type is a bit misleading.

At batch send response.

resend-python/resend/emails/_batch.py

Line 11 in 752fe35

class _SendResponse(TypedDict):

resend-python/resend/emails/_batch.py

Lines 20 to 25 in 752fe35

	class SendResponse(_SendResponse):
	"""
	SendResponse type that wraps a list of email objects
	Attributes:
	data (List[Email]): A list of email objects

resend-python/resend/emails/_email.py

Lines 57 to 65 in 752fe35

	class Email(_EmailDefaultAttrs):
	"""
	Email type that wraps the email object
	Attributes:
	id (str): The Email ID.
	from (str): The email address the email was sent from.
	to (Union[List[str], str]): List of email addresses to send the email to.
	created_at (str): When the email was created.

It is useding List[Email] as response, however, that is not the real structure of what the response is.

The real response has id only

{
  "id": "49a3999c-0ce1-4ea6-ab68-afcd6dc2e794"
}

https://resend.com/docs/api-reference/emails/send-email

---

Suggestion:

Created a different response type class like

class Response:
    id: str

[pedroimpulcetto]

Hum, good catch, I agree, we can improve it and ensure we have the right types.

I'm working to include a Generics type hint to improve the Request class in this PR #107

• maybe we can also make this improvement and create specific types for the responses

What do you think @drish?

[drish]

@tim-hub yeah I think returning the type Email for all methods ended up not being the best typing UI since the Email object will not be entirely populated depending on the response. Will update that