from typing import Dict, List, Optional

from typing_extensions import NotRequired, TypedDict


class EmailAttachment(TypedDict):
    """
    EmailAttachment type that wraps an attachment object from an email.

    Attributes:
        id (str): The attachment ID.
        filename (str): The filename of the attachment.
        content_type (str): The content type of the attachment.
        content_disposition (str): The content disposition of the attachment.
        content_id (NotRequired[str]): The content ID for inline attachments.
        size (NotRequired[int]): The size of the attachment in bytes.
    """

    id: str
    """
    The attachment ID.
    """
    filename: str
    """
    The filename of the attachment.
    """
    content_type: str
    """
    The content type of the attachment.
    """
    content_disposition: str
    """
    The content disposition of the attachment.
    """
    content_id: NotRequired[str]
    """
    The content ID for inline attachments.
    """
    size: NotRequired[int]
    """
    The size of the attachment in bytes.
    """


class EmailAttachmentDetails(TypedDict):
    """
    EmailAttachmentDetails type that wraps an email attachment with download details.

    Attributes:
        object (str): The object type.
        id (str): The attachment ID.
        filename (str): The filename of the attachment.
        content_type (str): The content type of the attachment.
        content_disposition (str): The content disposition of the attachment.
        content_id (NotRequired[str]): The content ID for inline attachments.
        download_url (str): The URL to download the attachment.
        expires_at (str): When the download URL expires.
    """

    object: str
    """
    The object type.
    """
    id: str
    """
    The attachment ID.
    """
    filename: str
    """
    The filename of the attachment.
    """
    content_type: str
    """
    The content type of the attachment.
    """
    content_disposition: str
    """
    The content disposition of the attachment.
    """
    content_id: NotRequired[str]
    """
    The content ID for inline attachments.
    """
    download_url: str
    """
    The URL to download the attachment.
    """
    expires_at: str
    """
    When the download URL expires.
    """


# Uses functional typed dict syntax here in order to support "from" reserved keyword
_ReceivedEmailFromParam = TypedDict(
    "_ReceivedEmailFromParam",
    {
        "from": str,
    },
)


# For list responses (omits html, text, headers, object from full email)
_ListReceivedEmailFromParam = TypedDict(
    "_ListReceivedEmailFromParam",
    {
        "from": str,
    },
)


class _ReceivedEmailDefaultAttrs(_ReceivedEmailFromParam):
    object: str
    """
    The object type.
    """
    id: str
    """
    The received email ID.
    """
    to: List[str]
    """
    List of recipient email addresses.
    """
    created_at: str
    """
    When the email was received.
    """
    subject: str
    """
    The subject of the email.
    """
    html: Optional[str]
    """
    The HTML content of the email.
    """
    text: Optional[str]
    """
    The text content of the email.
    """
    bcc: Optional[List[str]]
    """
    Bcc recipients.
    """
    cc: Optional[List[str]]
    """
    Cc recipients.
    """
    reply_to: Optional[List[str]]
    """
    Reply-to addresses.
    """
    message_id: str
    """
    The message ID of the email.
    """
    headers: NotRequired[Dict[str, str]]
    """
    Email headers.
    """
    attachments: List[EmailAttachment]
    """
    List of attachments.
    """


class ReceivedEmail(_ReceivedEmailDefaultAttrs):
    """
    ReceivedEmail type that wraps a received (inbound) email object.

    Attributes:
        object (str): The object type.
        id (str): The received email ID.
        to (List[str]): List of recipient email addresses.
        from (str): The sender email address.
        created_at (str): When the email was received.
        subject (str): The subject of the email.
        html (Optional[str]): The HTML content of the email.
        text (Optional[str]): The text content of the email.
        bcc (Optional[List[str]]): Bcc recipients.
        cc (Optional[List[str]]): Cc recipients.
        reply_to (Optional[List[str]]): Reply-to addresses.
        message_id (str): The message ID of the email.
        headers (NotRequired[Dict[str, str]]): Email headers.
        attachments (List[EmailAttachment]): List of attachments.
    """


class _ListReceivedEmailDefaultAttrs(_ListReceivedEmailFromParam):
    id: str
    """
    The received email ID.
    """
    to: List[str]
    """
    List of recipient email addresses.
    """
    created_at: str
    """
    When the email was received.
    """
    subject: str
    """
    The subject of the email.
    """
    bcc: Optional[List[str]]
    """
    Bcc recipients.
    """
    cc: Optional[List[str]]
    """
    Cc recipients.
    """
    reply_to: Optional[List[str]]
    """
    Reply-to addresses.
    """
    message_id: str
    """
    The message ID of the email.
    """
    attachments: List[EmailAttachment]
    """
    List of attachments.
    """


class ListReceivedEmail(_ListReceivedEmailDefaultAttrs):
    """
    ListReceivedEmail type for received email items in list responses.
    Omits html, text, headers, and object fields from the full email.

    Attributes:
        id (str): The received email ID.
        to (List[str]): List of recipient email addresses.
        from (str): The sender email address.
        created_at (str): When the email was received.
        subject (str): The subject of the email.
        bcc (Optional[List[str]]): Bcc recipients.
        cc (Optional[List[str]]): Cc recipients.
        reply_to (Optional[List[str]]): Reply-to addresses.
        message_id (str): The message ID of the email.
        attachments (List[EmailAttachment]): List of attachments.
    """