highlevel library

Highlevel email API

Start with MailClient to connect to any mail service.

Classes

AttachmentInfo
Information about a file that is attached
BinaryMimeData
Represents binary mime data
BodyPart
A BODY or BODYSTRUCTURE information element
ContentDispositionHeader
Specifies the content disposition header of a mime part. Compare https://tools.ietf.org/html/rfc2183 for details.
ContentInfo
Provides high level information about content parts.
ContentTypeHeader
Eases reading content-type header values
DeleteResult
Provides information about a delete action
Envelope
Contains the envelope information about a message.
FetchImapResult
Result for FETCH operations
GenericImapResult
A generic result that provide details about the success or failure of the command.
Encapsulates a MIME header
ImapWarning
Warnings can often be ignored but provide more insights in case of problems They are given in untagged responses of the server.
MailAccount
Contains information about a single mail account
MailAddress
An email address can consist of separate fields
MailAuthentication
Contains an authentication for a mail service Compare PlainAuthentication and OauthAuthentication for implementations.
Mailbox
Stores meta data about a folder aka Mailbox
MailClient
Highlevel online API to access mail.
MailConnectionLostEvent
Notifies about a lost connection
MailConnectionReEstablishedEvent
Notifies about a connection that has been re-established
MailConventions
Contains various mail specific conventions
MailEvent
Base class for any event that can be fired by the MailClient at any time. Compare MailClient.eventBus
MailLoadEvent
Notifies about a message that has been deleted
MailSearch
Abstracts a typical mail search
MailSearchResult
Contains the result of a search
MailServerConfig
Configuration of a specific mail service like IMAP, POP3 or SMTP
MailUpdateEvent
Notifies about an mail flags update
MailVanishedEvent
Notifies about the removal of messages
MediaType
Describes the media type of a MIME message part
MessageBuilder
Simplifies creating mime messages for sending or storing.
MessageFlags
Contains common message flags
MessageSequence
Defines a list of message IDs.
MessagesOperationResult
Base class for operation results based on messages
MimeData
Abstracts textual or binary mime data
MimeMessage
A MIME message
MimePart
A MIME part In a simple case a MIME message only has one MIME part.
MimeThread
Abstract a mime message thread
MoveResult
Result for move operations
OauthAuthentication
Provides an OAuth-compliant authentication
OauthToken
Contains an OAuth compliant token
PagedMessageResult
Base class for actions that result in a partial fetching of messages
PagedMessageSequence
A paginated list of message IDs
ParameterizedHeader
A parameter that may contain additional parameters
PartBuilder
Allows to configure a mime part
PlainAuthentication
Provides a simple username-password authentication
QResyncParameters
Classes for implementing QRESYNC https://tools.ietf.org/html/rfc7162 QRESYNC parameters when doing a SELECT or EXAMINE.
QuotaResult
Result for QUOTA operations
QuotaRootResult
Result for QUOTAROOT operations
Response<T>
Base class for command responses.
SearchImapResult
Result for SEARCH and UID SEARCH operations
SearchQueryBuilder
Creates a new search query.
SearchTerm
Base class for all search terms
SearchTermAll
Searches all messages
SearchTermAnswered
Searches for answered/replied messages
SearchTermBcc
Searches for messages with a BCC recipient that matches
SearchTermBefore
Searches for messages stored before the given date.
SearchTermBody
Searches in the body of messages. This is usually a long lasting operation.
SearchTermCc
Searches for messages with a matching recipient on CC
SearchTermCharsetUf8
Set the charset to UTF8
SearchTermDeleted
Searches for deleted messages
SearchTermDraft
Searches for draft messages
SearchTermFlagged
Searches for flagged messages
SearchTermFrom
Searches for messages where the sender matches the senderPart
SearchTermHeader
Searches for messages with the given header
SearchTermKeyword
Searches for messages flagged with the given keyword
SearchTermLarger
Searches for messages that are bigger than the given size
SearchTermNew
Searches for new messages
SearchTermNot
Negates the given search term
SearchTermOld
Searches for old messages
SearchTermOn
Searches for message stored at the given day
SearchTermOr
Combines two atomic search terms in an OR way Note that you cannot nest an OR term into another OR term
SearchTermRecent
Searches for recent messages
SearchTermSeen
Searches for seen / read messages
SearchTermSentBefore
Searches for messages sent before the given date
SearchTermSentOn
Searches for message sent at the given day
SearchTermSentSince
Searches message sent after the given time
SearchTermSince
Searches for messages stored after the given time
SearchTermSmaller
Searches messages with a size less than given
SearchTermSubject
Searches for messages with a matching subject
SearchTermText
Searches any text header
SearchTermTo
Searches for recipients
SearchTermUnanswered
Searches messages without the replied flag
SearchTermUndeleted
Searches messages that are not deleted
SearchTermUndraft
Searches for messages that carry no draft flag
SearchTermUnflagged
Search for not flagged messages
SearchTermUnkeyword
Searches for messages without the keyword
SearchTermUnseen
Searches for unseen messages
SequenceNode
A message sequence to handle nested IDs like in the IMAP THREAD extension.
SortImapResult
Result for SORT and UID SORT operations
StoreImapResult
Result for STORE and UID STORE operations
TextMimeData
Represents textual mime data
ThreadDataResult
Contains information about threads
ThreadResult
Encapsulates a thread result
Tree<T>
Contains a tree like structure
TreeElement<T>
An Element in a Tree
UidResponseCode
Contains a UID response code
UidSearchTerm
Searches for the given UID messages
UserNameBasedAuthentication
Base class for authentications with user-names

Enums

CharacterSet
The used character set
ContentDisposition
Specifies the content disposition of a mime part. Compare https://tools.ietf.org/html/rfc2183 for details.
DeleteAction
The internal action that was used for deletion. This is useful for undoing and delete operation.
FetchPreference
The client's preference when fetching messages
MailboxFlag
Contains common flags for mailboxes
MailEventType
Classification of Mail events
MediaSubtype
Detailed media types Compare https://www.iana.org/assignments/media-types/media-types.xhtml
MediaToptype
Top level media types
MoveAction
Possible move implementations
RecipientGroup
The recipient
ResponseStatus
Status for command responses.
SearchMessageType
Defines what kind of messages should be searched
SearchQueryType
Which part of the message should be searched
SequenceNodeSelectionMode
Selection mode for retrieving a MessageSequence from a nested SequenceNode structure.
ThreadPreference
Defines the thread fetching preference
TransferEncoding
The transfer-encoding used for encoding 8bit data if necessary

Extensions

MediaSubtypeExtension on MediaSubtype
Extension on MediaSubtype
SequenceExtension on List<MimeMessage>
Allows to get a sequence for a list of MimeMessages easily

Typedefs

MailEventFilter = bool Function(MailEvent event)
Definition for optional event filters, compare MailClient.addEventFilter.

Exceptions / Errors

BaseMailException
Base exception for any IMAP, POP, SMTP or highlevel API exceptions
InvalidArgumentException
Notifies about an invalid argument
MailException
Provides details about high level unexpected events