IMAP telnet example (test IMAP with telnet)

Here some notes about IMAP testing using telnet with reference to  email client behaviours (login, listing emails and folders, read email...)
...
 How to test with curl command :
$curl imap://username:password@in.example.com/INBOX?NEW (goto curl notes)
extra notes (single command cut&paste) here

#I About identification of an email message

There are two types of ID for an email :

• UID : Unique Identifier is an unique number referencing an email
• Message Sequence Number: the relative position from the first message in the mailbox

About UID  :

 the unique identifier of a message MUST NOT change during 
the session, and SHOULD NOT change between sessions. Any change of unique identifiers between 
sessions MUST be detectable using the UIDVALIDITY mechanism discussed below...
... and ...
 Unique identifiers MUST be strictly ascending in the mailbox at all times.
... and more ...
 The combination of mailbox name, UIDVALIDITY, and UID must refer to a single immutable message 
on that server forever.

#II Folders list

Email client can get list of all folders using command : LIST "" "*"
Btw in some cases (depends by use case, number of folders and ...) it is better ask just for top level of folders :

a LIST "" %
* LIST (HasChildren) "/" "level1"
...(only root folders)

instead of whole list :

a LIST "" *
* LIST (HasChildren) "/" "leve1"
* LIST (HasChildren) "/" "leve1/leve2"
* LIST (HasNoChildren) "/" "leve1/leve2/leve3"
 ...( all folders hierarchy )

It is better doesn't expand automatically the whole tree.

#III List of emails in a folder

Build the list of email messages in a folder in 4 steps ...

telnet <SERVER> 143
Trying <SERVER-IP>...
Connected to <SERVER-IP>
Escape character is '^]'.
* OK IMAP4 server ready
a login test@adomain.it password
a OK login successful

a SELECT "sent"
* 254 EXISTS
* 0 RECENT
* FLAGS (Answered Flagged Deleted Seen Draft $MDNSent)
* OK [PERMANENTFLAGS (Answered Flagged Deleted Seen Draft $MDNSent)] flags can be changed
* OK [UIDVALIDITY 1360825208] mailbox UID validity
* OK [UIDNEXT 483] predicted next UID
a OK [READ-WRITE] SELECT complete

 a UID SEARCH BEFORE "01-Jan-2013"
 * SEARCH 42 43 44 20412
 a OK SEARCH complete

a UID FETCH 42 (BODY[HEADER.FIELDS (from to subject date)])
* 30 FETCH (BODY[HEADER.FIELDS (from to subject date)] {162}
Date: Wed, 19 Jan 2011 12:20:16 +0100 (CET)
From: "test2" <test2@domain.com>
To: test@dest.com
Subject: Caratteri cinesi

UID 42)
a OK FETCH complete

#IV Read/Open email

In order to read a message user usually selects an email starting by a list of messages (for example using an email client). All messages (in a folder) are identified by an UID (that we have retrieved in step 3 here ). In order to read a message  can be used the FETCH command.
Example :
a login test@adomain.it password
a OK login successful
a SELECT "sent"
* 254 EXISTS
... and remaining steps reported above here

a UID FETCH 22049 (BODYSTRUCTURE)
* 20310 FETCH (BODYSTRUCTURE ((("TEXT" "PLAIN" ("charset" "UTF-8") NIL NIL "7bit" 4 1)("TEXT" "HTML" ("charset" "UTF-8") NIL NIL "7bit" 4 1) "ALTERNATIVE" ("boundary" "----=_Part_18_28612235.1384442157276"))("IMAGE" "PNG" ("name" "Screen Shot 2013-11-14 at 4.15.41 PM.png") NIL NIL "base64" 13858 NIL ("attachment" ("filename" "Screen Shot 2013-11-14 at 4.15.41 PM.png" "size" "10127"))) "MIXED" ("boundary" "----=_Part_17_22578400.1384442157276")) UID 22049)
a OK FETCH complete

a UID FETCH 22049 (BODY.PEEK[1.MIME])
* 20310 FETCH (BODY[1.MIME] {90}
Content-Type: multipart/alternative;
        boundary="----=_Part_5_22723359.1302613193870"

UID 22049)
a OK FETCH complete

a UID FETCH 22049 (BODY[1.1])
* 20310 FETCH (BODY[1.1] {370}
Body MailTest : hello!!!!! {margin:0;padding:0;} #footer { height:13px; font-size:11px; font-family:Arial, FreeSans, sans-serif; color:#ADADAD; margin:0; padding:7px 12px; text-align:right; border-top:1px solid #dcdcdc; }          #footer a { text-decoration:none; color:#ADADAD; } #footer a:hover { color:#848484; } TEST 12   UID 22049)
a OK FETCH complete
.... continue

As said email to read is selected probably from a list. In this case the client has already read some headers. Btw it is better don't read all whole email (i.e. big attachment  could be present in email). The proper way is fetch header and message body information that you need to show immediately to user (above example). If user click on download attachment then the client can fetch the attachment.
Fetching the attachment it is better fetch pieces (chunking):
a FETCH 1 BODY.PEEK[2]<0.102400>
a FETCH 1 BODY.PEEK[2]<102401.204800>

#V Write / Delete / Update of a message

there are, in IMAP, several write events :

• store message
• save draft
• delete

There isn't any update command.

Store message

In order to Save email IMAP uses  APPEND (example save sent email in sent folder) :

a APPEND sent (\Seen) {332}
+ Ready for literal data
 Date: Mon, 12 Feb 2013 21:52:25 -0800 (PST)
 From: test me <testme@test.priv>
 Subject:  test append
 To: testyou@test.priv
 Message-Id: <B27397-0100000@abc.priv>
 MIME-Version: 1.0
 Content-Type: TEXT/PLAIN; CHARSET=US-ASCII

This is a test body for the message!
a OK

Where :

• {332} -> is byte dimension on append part
• sent    ->  is folder
• Seen   -> is flag

Save draft

Draft message can be saved with IMAP APPEND and flag DRAFT. Draft message has the peculiarity to be an incomplete email message... so  it needs to be updated repeatedly by the user (modify & save & modify & ...).  There isn't any way in order edit/update email message on IMAP server side. The only way in order to update a message is remove it (DELETE) then create it again (APPEND). In this case UID will change for the message.

Delete

Delete email is done setting "flag Deleted" then "expunge" (DELETE) flagged messages.
1 - Set deleted flag (message with UID 42) :

a UID STORE 42 +FLAGS.SILENT (Deleted)
a OK STORE complete

2- expunge
Example :
(delete all messages with flag deleted)

a EXPUNGE
  * 42 EXPUNGE
  * 42 EXPUNGE
  * 42 EXPUNGE
  * 42 EXPUNGE
 a OK EXPUNGE complete

or.. example

a UID EXPUNGE 42
a OK EXPUNGE complete