ImapConnect.h

/*
╔══════════════════════════════════════════════════════════════════════════════╗
║                       SIMPLY POWERFUL TOOLKIT (SPTK)                         ║
╟──────────────────────────────────────────────────────────────────────────────╢
║  copyright            © 1999-2022 Alexey Parshin. All rights reserved.       ║
║  email                alexeyp@gmail.com                                      ║
╚══════════════════════════════════════════════════════════════════════════════╝
┌──────────────────────────────────────────────────────────────────────────────┐
│   This library is free software; you can redistribute it and/or modify it    │
│   under the terms of the GNU Library General Public License as published by  │
│   the Free Software Foundation; either version 2 of the License, or (at your │
│   option) any later version.                                                 │
│                                                                              │
│   This library is distributed in the hope that it will be useful, but        │
│   WITHOUT ANY WARRANTY; without even the implied warranty of                 │
│   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library   │
│   General Public License for more details.                                   │
│                                                                              │
│   You should have received a copy of the GNU Library General Public License  │
│   along with this library; if not, write to the Free Software Foundation,    │
│   Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.               │
│                                                                              │
│   Please report all bugs and problems to alexeyp@gmail.com.                  │
└──────────────────────────────────────────────────────────────────────────────┘
*/
 
#pragma once
 
#include <sptk5/FieldList.h>
#include <sptk5/Strings.h>
#include <sptk5/net/TCPSocket.h>
 
#include <string>
 
namespace sptk {
 
class SP_EXPORT ImapConnect : public TCPSocket
{
public:
    ImapConnect() = default;
 
    void command(const String& cmd, const String& arg1 = "", const String& arg2 = "");
 
    const Strings& response() const
    {
        return m_response;
    }
 
    void cmd_capability()
    {
        command("capability");
    }
 
    void cmd_noop()
    {
        command("noop");
    }
 
    void cmd_logout()
    {
        command("LOGOUT");
    }
 
    // IMAPv4 commands - not logged in
 
    void cmd_login(const String& user, const String& password);
 
    // IMAPv4 commands - logged in, mailbox-operations
 
    void cmd_select(const String& mail_box, int32_t& total_msgs);
 
    void cmd_examine(const String& mail_box)
    {
        command("examine", mail_box);
    }
 
    void cmd_subscribe(const String& mail_box)
    {
        command("subscribe", mail_box);
    }
 
    void cmd_unsubscribe(const String& mail_box)
    {
        command("unsubscribe", mail_box);
    }
 
    void cmd_create(const String& mail_box)
    {
        command("create", mail_box);
    }
 
    void cmd_delete(const String& mail_box)
    {
        command("delete", mail_box);
    }
 
    void cmd_rename(const String& mail_box, const String& new_name)
    {
        command("rename ", mail_box, new_name);
    }
 
    void cmd_list(const String& mail_box_mask, bool decode = false);
 
    void cmd_append(const String& mail_box, const Buffer& message);
 
    // IMAPv4 commands - logged in, selected mailbox-operations
 
    void cmd_close()
    {
        command("close");
    }
 
    void cmd_expunge()
    {
        command("expunge");
    }
 
    void cmd_search_all(String& result);
 
    void cmd_search_new(String& result);
 
    void cmd_fetch_headers(int32_t msg_id, FieldList& result);
 
    void cmd_fetch_message(int32_t msg_id, FieldList& result);
 
    String cmd_fetch_flags(int32_t msg_id);
 
    void cmd_store_flags(int32_t msg_id, const char* flags);
 
protected:
    String sendCommand(const String& cmd);
 
    bool getResponse(const String& ident);
 
    void parseSearch(String& result) const;
 
    void parseMessage(FieldList& result, bool headersOnly);
 
    void parseFolderList();
 
private:
    Strings m_response;               
    int32_t m_ident {1};              
    static const String empty_quotes; 
};
 
} // namespace sptk