<?php
/**
 * This code is licensed under AGPLv3 license or Afterlogic Software License
 * if commercial version of the product was purchased.
 * For full statements of the licenses see LICENSE-AFTERLOGIC and LICENSE-AGPL3 files.
 */

namespace Aurora\Modules\Mail\Managers\Main;

use Aurora\Modules\Mail\Enums\ErrorCodes;
use Aurora\Modules\Mail\Models\MailAccount;
use Aurora\Modules\Mail\Models\RefreshFolder;
use Aurora\Modules\Mail\Models\TrustedSender;
use Aurora\Modules\Mail\Models\SystemFolder;
use Aurora\Modules\Mail\Module;
use Aurora\System\Exceptions;
use Aurora\System\Exceptions\ApiException;
use MailSo\Mime\Email;

/**
 * Manager for work with ImapClient.
 *
 * @license https://www.gnu.org/licenses/agpl-3.0.html AGPL-3.0
 * @license https://afterlogic.com/products/common-licensing Afterlogic Software License
 * @copyright Copyright (c) 2023, Afterlogic Corp.
 *
 * @package Mail
 *
 * @property Module $oModule
 */
class Manager extends \Aurora\System\Managers\AbstractManager
{
    /**
     * @var array List of ImapClient objects.
     */
    protected $aImapClientCache;

    /**
     * Initializes manager property.
     *
     * @param \Aurora\System\Module\AbstractModule $oModule
     *
     * @return void
     */
    public function __construct(\Aurora\System\Module\AbstractModule $oModule = null)
    {
        parent::__construct($oModule);

        $this->aImapClientCache = array();
    }

    /**
     * Returns ImapClient object from cache.
     *
     * @param \Aurora\Modules\Mail\Models\MailAccount $oAccount Account object.
     * @param int $iForceConnectTimeOut = 0. The value overrides connection timeout value.
     * @param int $iForceSocketTimeOut = 0. The value overrides socket timeout value.
     *
     * @return \MailSo\Imap\ImapClient|null
     */
    public function &_getImapClient(\Aurora\Modules\Mail\Models\MailAccount $oAccount, $iForceConnectTimeOut = 0, $iForceSocketTimeOut = 0)
    {
        $oResult = null;
        if ($oAccount) {
            $sCacheKey = $oAccount->Email;

            $oSettings = &\Aurora\System\Api::GetSettings();
            $iConnectTimeOut = $oSettings->SocketConnectTimeoutSeconds;
            $iSocketTimeOut = $oSettings->SocketGetTimeoutSeconds;
            $bVerifySsl = !!$oSettings->SocketVerifySsl;

            if (!isset($this->aImapClientCache[$sCacheKey])) {
                if (0 < $iForceConnectTimeOut) {
                    $iConnectTimeOut = $iForceConnectTimeOut;
                }

                if (0 < $iForceSocketTimeOut) {
                    $iSocketTimeOut = $iForceSocketTimeOut;
                }

                $this->aImapClientCache[$sCacheKey] = \MailSo\Imap\ImapClient::NewInstance();
                $this->aImapClientCache[$sCacheKey]->SetTimeOuts($iConnectTimeOut, $iSocketTimeOut); // TODO
                $this->aImapClientCache[$sCacheKey]->SetLogger(\Aurora\System\Api::SystemLogger());
            }

            $oResult = &$this->aImapClientCache[$sCacheKey];
            if (!$oResult->IsConnected()) {
                $oServer = $oAccount->Server;
                if ($oServer instanceof \Aurora\Modules\Mail\Models\Server) {
                    try {
                        //disable STARTTLS for localhost
                        if ($this->oModule->oModuleSettings->DisableStarttlsForLocalhost &&
                            (strtolower($oServer->IncomingServer) === 'localhost' || strtolower($oServer->IncomingServer) === '127.0.0.1')) {
                            \MailSo\Config::$PreferStartTlsIfAutoDetect = false;
                        }
                        $oResult->Connect($oServer->IncomingServer, $oServer->IncomingPort, $oServer->IncomingUseSsl
                                ? \MailSo\Net\Enumerations\ConnectionSecurityType::SSL
                                : \MailSo\Net\Enumerations\ConnectionSecurityType::NONE, $bVerifySsl);
                    } catch (\Exception $oException) {
                        throw new \Aurora\Modules\Mail\Exceptions\Exception(
                            \Aurora\Modules\Mail\Enums\ErrorCodes::CannotConnectToMailServer,
                            $oException,
                            $oException->getMessage()
                        );
                    }
                }
            }

            if (!$oResult->IsLoggined()) {
                //				$sProxyAuthUser = !empty($oAccount->CustomFields['ProxyAuthUser'])
                //					? $oAccount->CustomFields['ProxyAuthUser'] : '';
                if ($this->oModule->oModuleSettings->ImapSendOriginatingIP) {
                    $oResult->SendRequestWithCheck('ID', array('("x-originating-ip" "' . \Aurora\System\Utils::getClientIpInsecure() . '")'));
                }

                if (!empty($oAccount->XOAuth)) {
                    $sToken = \Aurora\Modules\OAuthIntegratorWebclient\Module::Decorator()->GetAccessToken($oAccount->XOAuth, $oAccount->Email);
                    if ($sToken) {
                        $sXOAuthKey = \MailSo\Imap\ImapClient::GetXOAuthKeyStatic($oAccount->Email, $sToken);
                        $oResult->LoginWithXOAuth2($sXOAuthKey);
                    } else {
                        throw new ApiException(ErrorCodes::CannotLoginCredentialsIncorrect, null, 'Try deleting your GMail account and creating it again.');
                    }
                } else {
                    try {
                        $password = $oAccount->getPassword();
                        if (!$password) {
                            throw new \Aurora\Modules\Mail\Exceptions\Exception(
                                \Aurora\Modules\Mail\Enums\ErrorCodes::CannotLoginCredentialsIncorrect,
                                null,
                                $oAccount->Id . ':'
                            );
                        }
                        $oResult->Login($oAccount->IncomingLogin, $password, '');
                    } catch (\MailSo\Imap\Exceptions\LoginBadCredentialsException $oException) {
                        // This exception is necessary so that client could display correct error message
                        throw new \Aurora\Modules\Mail\Exceptions\Exception(
                            \Aurora\Modules\Mail\Enums\ErrorCodes::CannotLoginCredentialsIncorrect,
                            $oException,
                            $oAccount->Id . ':' . $oException->getMessage()
                        );
                    }
                }
            }
        }

        return $oResult;
    }

    /**
     * Creates a new instance of ImapClient class.
     *
     * @param MailAccount $oAccount Account object.
     * @param int $iForceConnectTimeOut = 0. The value overrides connection timeout value.
     * @param int $iForceSocketTimeOut = 0. The value overrides socket timeout value.
     *
     * @return \MailSo\Imap\ImapClient|null
     */
    public function &getImapClient(MailAccount $oAccount, $iForceConnectTimeOut = 0, $iForceSocketTimeOut = 0)
    {
        $oImap = false;
        try {
            $oImap = &$this->_getImapClient($oAccount, $iForceConnectTimeOut, $iForceSocketTimeOut);
        } catch (\Exception $oException) {
        }

        return $oImap;
    }

    /**
     * Checks if user of the account can successfully connect to mail server.
     *
     * @param MailAccount $oAccount Account object.
     * @param boolean $bThrowException = true
     *
     * @return \Exception
     *
     * @throws \Aurora\System\Exceptions\ManagerException
     */
    public function validateAccountConnection($oAccount, $bThrowException = true)
    {
        $oResException = null;

        try {
            $this->_getImapClient($oAccount);
        } catch (\Exception $oException) {
            $oResException = $oException;
        }

        if ($bThrowException && $oResException !== null) {
            throw $oResException;
        }

        return $oResException;
    }

    public function setAlwaysRefreshFolder($oAccount, $sFolderFullName, $bRefresh)
    {
        $bResult = false;

        $oEntity = RefreshFolder::where(array(
            'IdAccount' => $oAccount->Id,
            'FolderFullName' => $sFolderFullName
        ))->first();

        $oRefreshFolder = null;
        if (!$oEntity instanceof RefreshFolder) {
            $oRefreshFolder = new RefreshFolder();
            $oRefreshFolder->FolderFullName = $sFolderFullName;
            $oRefreshFolder->IdAccount = $oAccount->Id;
        }
        if ($oRefreshFolder->AlwaysRefresh !== $bRefresh) {
            $oRefreshFolder->AlwaysRefresh = $bRefresh;
            $bResult = !!$oRefreshFolder->save();
        } else {
            $bResult = true;
        }

        return $bResult;
    }

    public function getAlwaysRefreshFolders($oAccount)
    {
        $aFolders = [];
        $aEntities = RefreshFolder::where(array(
            'IdAccount' => $oAccount->Id
        ))->get();

        foreach ($aEntities as $oEntity) {
            /** @var RefreshFolder $oEntity */
            if ($oEntity->AlwaysRefresh) {
                $aFolders[] = $oEntity->FolderFullName;
            }
        }

        return $aFolders;
    }

    /**
     * Updates information on system folders use.
     *
     * @param MailAccount $oAccount Account object.
     * @param array $aSystemNames Array containing mapping of folder types and their actual IMAP names.
     *
     * @return bool
     */
    public function updateSystemFolderNames($oAccount, $aSystemNames)
    {
        foreach ($aSystemNames as $iTypeValue => $sFolderFullName) {
            $oSystemFolder = SystemFolder::where(array(
                'IdAccount' => $oAccount->Id,
                'Type' => $iTypeValue
            ))->first();

            if (!$oSystemFolder instanceof SystemFolder) {
                $oSystemFolder = new SystemFolder();
                $oSystemFolder->Type = $iTypeValue;
                $oSystemFolder->IdAccount = $oAccount->Id;
            }
            $oSystemFolder->FolderFullName = $sFolderFullName;
            $oSystemFolder->save();
        }

        return true;
    }

    public function setSystemFolder($oAccount, $sFolderFullName, $iTypeValue, $bSet)
    {
        $bResult = true;

        $oSystemFolder = SystemFolder::where(array(
            'IdAccount' => $oAccount->Id,
            'Type' => $iTypeValue,
            'FolderFullName' => $sFolderFullName,
        ))->first();

        if ($bSet) {
            if ($oSystemFolder === null) {
                $oSystemFolder = new SystemFolder();
                $oSystemFolder->Type = $iTypeValue;
                $oSystemFolder->IdAccount = $oAccount->Id;
                $oSystemFolder->FolderFullName = $sFolderFullName;
                $bResult = $oSystemFolder->save();
            }
        } else {
            if ($oSystemFolder !== null) {
                $bResult = $oSystemFolder->delete();
            }
        }

        return $bResult;
    }

    /**
     * Gets information about system folders of the account.
     *
     * @param MailAccount $oAccount Account object.
     *
     * @return array|bool
     */
    public function getSystemFolderNames($oAccount)
    {
        $aFolders = array();

        $aEntities = $this->_getSystemFolderEntities($oAccount);
        foreach ($aEntities as $oEntity) {
            $aFolders[$oEntity->FolderFullName] = $oEntity->Type;
        }

        return $aFolders;
    }

    private function _getSystemFolderEntities($oAccount)
    {
        return SystemFolder::where(array(
            'IdAccount' => $oAccount->Id
        ))->limit(9)->get();
    }

    /**
     * Deletes information about system folders of the account.
     * @param int $iAccountId Account identifier.
     * @return boolean
     */
    public function deleteSystemFolderNames($iAccountId)
    {
        $bResult = true;

        $aFilters = array('IdAccount' => $iAccountId);

        $aSystemFolders = SystemFolder::where($aFilters)->get();
        if ($aSystemFolders->isNotEmpty()) {
            foreach ($aSystemFolders as $oSystemFolder) {
                $bResult = $oSystemFolder->delete();
            }
        }

        return $bResult;
    }

    /**
     * Obtains information about system folders from database.
     * Sets system type for existent folders, excludes information about them from $aFoldersMap.
     * Deletes information from database for nonexistent folders.
     *
     * @param MailAccount $oAccount Account object.
     * @param \Aurora\Modules\Mail\Classes\FolderCollection $oFolderCollection Collection of folders.
     * @param array $aFoldersMap Describes information about system folders that weren't initialized yet.
     */
    private function _initSystemFoldersFromDb($oAccount, $oFolderCollection, &$aFoldersMap)
    {
        $aSystemFolderEntities = $this->_getSystemFolderEntities($oAccount);

        foreach ($aSystemFolderEntities as $oSystemFolder) {
            if ($oSystemFolder->FolderFullName === '') {
                unset($aFoldersMap[$oSystemFolder->Type]);
            } else {
                $oFolder = $oFolderCollection->getFolder($oSystemFolder->FolderFullName, true);
                if ($oFolder) {
                    if (isset($aFoldersMap[$oSystemFolder->Type])) {
                        if ($oSystemFolder->Type !== \Aurora\Modules\Mail\Enums\FolderType::Template) {
                            unset($aFoldersMap[$oSystemFolder->Type]);
                        }
                        $oFolder->setType($oSystemFolder->Type);
                    }
                } elseif ($oFolderCollection->getCollectionFullFlag()) {
                    $oSystemFolder->delete();
                }
            }
        }
    }

    /**
     * Obtains information about system folders from IMAP.
     * Sets system type for obtained folders, excludes information about them from $aFoldersMap.
     *
     * @param \Aurora\Modules\Mail\Classes\FolderCollection $oFolderCollection Collection of folders.
     * @param array $aFoldersMap Describes information about system folders that weren't initialized yet.
     */
    private function _initSystemFoldersFromImapFlags($oFolderCollection, &$aFoldersMap)
    {
        $oFolderCollection->foreachWithSubFolders(
            function (/* @var $oFolder \Aurora\Modules\Mail\Classes\Folder */ $oFolder) use (&$aFoldersMap) {
                $iXListType = $oFolder->getFolderXListType();
                if (isset($aFoldersMap[$iXListType]) && \Aurora\Modules\Mail\Enums\FolderType::Custom === $oFolder->getType() && isset($aFoldersMap[$iXListType])) {
                    unset($aFoldersMap[$iXListType]);
                    $oFolder->setType($iXListType);
                }
            }
        );
    }

    /**
     * Sets system type for existent folders from folders map, excludes information about them from $aFoldersMap.
     *
     * @param \Aurora\Modules\Mail\Classes\FolderCollection $oFolderCollection Collection of folders.
     * @param array $aFoldersMap Describes information about system folders that weren't initialized yet.
     */
    private function _initSystemFoldersFromFoldersMap($oFolderCollection, &$aFoldersMap)
    {
        $oFolderCollection->foreachOnlyRoot(
            function (/* @var $oFolder \Aurora\Modules\Mail\Classes\Folder */ $oFolder) use (&$aFoldersMap) {
                foreach ($aFoldersMap as $iFolderType => $aFoldersNames) {
                    if (isset($aFoldersMap[$iFolderType]) && is_array($aFoldersNames) && (in_array($oFolder->getRawName(), $aFoldersNames) || in_array($oFolder->getName(), $aFoldersNames))) {
                        unset($aFoldersMap[$iFolderType]);
                        if (\Aurora\Modules\Mail\Enums\FolderType::Custom === $oFolder->getType()) {
                            $oFolder->setType($iFolderType);
                        }
                    }
                }
            }
        );
    }

    /**
     * Creates system folders that weren't initialized earlier because they don't exist.
     *
     * @param MailAccount $oAccount Account object.
     * @param \Aurora\Modules\Mail\Classes\FolderCollection $oFolderCollection Collection of folders.
     * @param array $aFoldersMap Describes information about system folders that weren't initialized yet.
     */
    private function _createNonexistentSystemFolders($oAccount, $oFolderCollection, $aFoldersMap)
    {
        $bSystemFolderIsCreated = false;

        if (is_array($aFoldersMap)) {
            $sNamespace = $oFolderCollection->getNamespace();
            foreach ($aFoldersMap as $mFolderName) {
                $sFolderFullName = is_array($mFolderName) &&
                    isset($mFolderName[0]) && is_string($mFolderName[0]) && 0 < strlen($mFolderName[0]) ?
                        $mFolderName[0] : (is_string($mFolderName) && 0 < strlen($mFolderName) ? $mFolderName : '');

                if (0 < strlen($sFolderFullName)) {
                    $this->createFolderByFullName($oAccount, $sNamespace . $sFolderFullName);
                    $bSystemFolderIsCreated = true;
                }
            }
        }

        return $bSystemFolderIsCreated;
    }

    /**
     * Initializes system folders.
     *
     * @param MailAccount $oAccount Account object.
     * @param \Aurora\Modules\Mail\Classes\FolderCollection $oFolderCollection Collection of folders.
     * @param bool $bCreateNonexistentSystemFolders Create nonexistent system folders.
     *
     * @return bool
     */
    protected function _initSystemFolders($oAccount, &$oFolderCollection, $bCreateNonexistentSystemFolders)
    {
        $bSystemFolderIsCreated = false;

        try {
            $aFoldersMap = array(
                \Aurora\Modules\Mail\Enums\FolderType::Drafts => array('Drafts', 'Draft'),
                \Aurora\Modules\Mail\Enums\FolderType::Sent => array('Sent', 'Sent Items', 'Sent Mail'),
                \Aurora\Modules\Mail\Enums\FolderType::Spam => array('Spam', 'Junk', 'Junk Mail', 'Junk E-mail', 'Bulk Mail'),
                \Aurora\Modules\Mail\Enums\FolderType::Trash => array('Trash', 'Bin', 'Deleted', 'Deleted Items'),
                // if array is empty, folder will not be set and/or created from folders map
                \Aurora\Modules\Mail\Enums\FolderType::Template => array(),
                \Aurora\Modules\Mail\Enums\FolderType::All => array(),
            );

            $oInbox = $oFolderCollection->getFolder('INBOX');
            if ($oInbox) {
                $oInbox->setType(\Aurora\Modules\Mail\Enums\FolderType::Inbox);
            }

            // Tries to set system folders from database data.
            $this->_initSystemFoldersFromDb($oAccount, $oFolderCollection, $aFoldersMap);

            // Tries to set system folders from imap flags for those folders that weren't set from database data.
            $this->_initSystemFoldersFromImapFlags($oFolderCollection, $aFoldersMap);

            // Tries to set system folders from folders map for those folders that weren't set from database data or IMAP flags.
            $this->_initSystemFoldersFromFoldersMap($oFolderCollection, $aFoldersMap);

            if ($bCreateNonexistentSystemFolders) {
                $bSystemFolderIsCreated = $this->_createNonexistentSystemFolders($oAccount, $oFolderCollection, $aFoldersMap);
            }
        } catch (\Exception $oException) {
            $bSystemFolderIsCreated = false;
        }

        return $bSystemFolderIsCreated;
    }

    public function isSafetySender($iIdUser, $sEmail)
    {
        $bResult = TrustedSender::where(array(
            'IdUser' => $iIdUser,
            'Email' => $sEmail
        ))->exists();

        return $bResult;
    }

    public function setSafetySender($iIdUser, $sEmail)
    {
        $bResult = true;
        if (!$this->isSafetySender($iIdUser, $sEmail)) {
            $oEntity = new TrustedSender();

            $oEntity->IdUser = $iIdUser;
            $oEntity->Email = $sEmail;
            $bResult = $oEntity->save();
        }

        return $bResult;
    }

    public function getFoldersNamespace($oAccount)
    {
        $oImapClient = &$this->_getImapClient($oAccount);

        return $oImapClient->GetNamespace();
    }

    /**
     * Obtains the list of IMAP folders.
     *
     * @param \Aurora\Modules\Mail\Models\MailAccount $oAccount Account object.
     * @param bool $bCreateUnExistenSystemFolders = true. Creating folders is required for WebMail work, usually it is done on first login to the account.
     *
     * @return \Aurora\Modules\Mail\Classes\FolderCollection Collection of folders.
     */
    public function getFolders($oAccount, $bCreateUnExistenSystemFolders = true, $sParent = '')
    {
        $oFolderCollection = false;

        $sListPattern = '*';

        $oImapClient = &$this->_getImapClient($oAccount);

        $oNamespace = $oImapClient->GetNamespace();

        $aFolders = $oImapClient->FolderList($sParent, $sListPattern);
        $aSubscribedFolders = $oImapClient->FolderSubscribeList($sParent, $sListPattern);

        $aImapSubscribedFoldersHelper = array();
        if (is_array($aSubscribedFolders)) {
            foreach ($aSubscribedFolders as /* @var $oImapFolder \MailSo\Imap\Folder */ $oImapFolder) {
                $aImapSubscribedFoldersHelper[] = $oImapFolder->FullNameRaw();
            }
        }

        $aMailFolders = null;
        if (is_array($aFolders)) {
            $aMailFolders = array();

            $aRefreshFolders = $this->getAlwaysRefreshFolders($oAccount);
            $bIgnoreImapSubscription = $this->oModule->oModuleSettings->IgnoreImapSubscription;

            foreach ($aFolders as /* @var $oImapFolder \MailSo\Imap\Folder */ $oImapFolder) {
                $oMailFolder = \Aurora\Modules\Mail\Classes\Folder::createInstance(
                    $oImapFolder,
                    in_array($oImapFolder->FullNameRaw(), $aImapSubscribedFoldersHelper) || $oImapFolder->IsInbox() || $bIgnoreImapSubscription
                );

                if (in_array($oMailFolder->getRawFullName(), $aRefreshFolders)) {
                    $oMailFolder->bAlwaysRefresh = true;
                }

                $aMailFolders[] = $oMailFolder;
            }
        }

        if (is_array($aMailFolders)) {
            $oFolderCollection = \Aurora\Modules\Mail\Classes\FolderCollection::createInstance();
            $oFolderCollection->setCollectionFullFlag($sParent === '');

            if ($oNamespace) {
                $oFolderCollection->setNamespace($oNamespace->GetPersonalNamespace());
            }

            $oFolderCollection->initialize($aMailFolders);

            if ($bCreateUnExistenSystemFolders && $this->_initSystemFolders($oAccount, $oFolderCollection, $bCreateUnExistenSystemFolders)) {
                $oFolderCollection = $this->getFolders($oAccount, false);
            }
        }

        if ($oFolderCollection && $oNamespace) {
            $oFolderCollection->setNamespace($oNamespace->GetPersonalNamespace());
        }

        $aFoldersOrderList = $this->getFoldersOrder($oAccount);
        $aFoldersOrderList = is_array($aFoldersOrderList) && 0 < count($aFoldersOrderList) ? $aFoldersOrderList : null;

        $aFoldersOrderFlipped = $aFoldersOrderList ? array_flip($aFoldersOrderList) : null;

        $oFolderCollection->sort(function ($oFolderA, $oFolderB) use ($aFoldersOrderFlipped) {
            if (!$aFoldersOrderFlipped) {
                if (\Aurora\Modules\Mail\Enums\FolderType::Custom !== $oFolderA->getType() || \Aurora\Modules\Mail\Enums\FolderType::Custom !== $oFolderB->getType()) {
                    if ($oFolderA->getType() === $oFolderB->getType()) {
                        return 0;
                    }

                    return $oFolderA->getType() < $oFolderB->getType() ? -1 : 1;
                }
            } else {
                $iPosA = isset($aFoldersOrderFlipped[$oFolderA->getRawFullName()]) ? $aFoldersOrderFlipped[$oFolderA->getRawFullName()] : false;
                $iPosB = isset($aFoldersOrderFlipped[$oFolderB->getRawFullName()]) ? $aFoldersOrderFlipped[$oFolderB->getRawFullName()] : false;
                if (is_int($iPosA) && is_int($iPosB)) {
                    return $iPosA < $iPosB ? -1 : 1;
                } elseif (is_int($iPosA)) {
                    return -1;
                } elseif (is_int($iPosB)) {
                    return 1;
                }
            }

            return strnatcmp(strtolower($oFolderA->getFullName()), strtolower($oFolderB->getFullName()));
        });

        if (null === $aFoldersOrderList) {
            $aNewFoldersOrderList = array();
            $oFolderCollection->foreachWithSubFolders(function (/* @var $oFolder \Aurora\Modules\Mail\Classes\Folder */ $oFolder) use (&$aNewFoldersOrderList) {
                if ($oFolder) {
                    $aNewFoldersOrderList[] = $oFolder->getRawFullName();
                }
            });

            if (0 < count($aNewFoldersOrderList)) {
                $this->updateFoldersOrder($oAccount, $aNewFoldersOrderList);
            }
        }

        return $oFolderCollection;
    }

    /**
     * Obtains folders order.
     *
     * @param MailAccount $oAccount Account object.
     *
     * @return array
     */
    public function getFoldersOrder($oAccount)
    {
        $aList = array();

        $aOrder = @json_decode($oAccount->FoldersOrder, 3);
        if (is_array($aOrder) && 0 < count($aOrder)) {
            $aList = $aOrder;
        }


        return $aList;
    }

    /**
     * Updates folders order.
     *
     * @param MailAccount $oAccount Account object.
     * @param array $aOrder New folders order.
     *
     * @return bool
     */
    public function updateFoldersOrder($oAccount, $aOrder)
    {
        $oAccount->FoldersOrder = @json_encode($aOrder);
        return $oAccount->save();
    }

    /**
     * Creates a new folder using its full name in IMAP folders tree.
     *
     * @param MailAccount $oAccount Account object.
     * @param string $sFolderFullNameRaw Raw full name of the folder.
     * @param bool $bSubscribeOnCreation = true. If **true** the folder will be subscribed and thus made visible in the interface.
     *
     * @return void
     *
     * @throws \Aurora\System\Exceptions\InvalidArgumentException
     */
    public function createFolderByFullName($oAccount, $sFolderFullNameRaw, $bSubscribeOnCreation = true)
    {
        if (0 === strlen($sFolderFullNameRaw)) {
            throw new \Aurora\System\Exceptions\InvalidArgumentException();
        }

        $oImapClient = &$this->_getImapClient($oAccount);

        $oImapClient->FolderCreate($sFolderFullNameRaw);

        if ($bSubscribeOnCreation) {
            $oImapClient->FolderSubscribe($sFolderFullNameRaw);
        }
    }

    /**
     * Obtains folders information - total messages count, unread messages count, uidNext.
     *
     * @param \MailSo\Imap\ImapClient $oImapClient ImapClient object.
     * @param string $sFolderFullNameRaw Raw full name of the folder.
     *
     * @return array [$iMessageCount, $iMessageUnseenCount, $sUidNext]
     */
    private function _getFolderInformation($oImapClient, $sFolderFullNameRaw)
    {
        $aFolderStatus = $oImapClient->FolderStatus($sFolderFullNameRaw, array(
            \MailSo\Imap\Enumerations\FolderResponseStatus::MESSAGES,
            \MailSo\Imap\Enumerations\FolderResponseStatus::UNSEEN,
            \MailSo\Imap\Enumerations\FolderResponseStatus::UIDNEXT
        ));

        $iStatusMessageCount = isset($aFolderStatus[\MailSo\Imap\Enumerations\FolderResponseStatus::MESSAGES])
            ? (int) $aFolderStatus[\MailSo\Imap\Enumerations\FolderResponseStatus::MESSAGES] : 0;

        $iStatusMessageUnseenCount = isset($aFolderStatus[\MailSo\Imap\Enumerations\FolderResponseStatus::UNSEEN])
            ? (int) $aFolderStatus[\MailSo\Imap\Enumerations\FolderResponseStatus::UNSEEN] : 0;

        $sStatusUidNext = isset($aFolderStatus[\MailSo\Imap\Enumerations\FolderResponseStatus::UIDNEXT])
            ? (string) $aFolderStatus[\MailSo\Imap\Enumerations\FolderResponseStatus::UIDNEXT] : '0';

        if (0 === strlen($sStatusUidNext)) {
            $sStatusUidNext = '0';
        }

        // gmail hack
        $oFolder = $oImapClient->FolderCurrentInformation();
        if ($oFolder && null !== $oFolder->Exists && $oFolder->FolderName === $sFolderFullNameRaw) {
            $iSubCount = (int) $oFolder->Exists;
            if (0 < $iSubCount && $iSubCount < $iStatusMessageCount) {
                $iStatusMessageCount = $iSubCount;
            }
        }

        return array($iStatusMessageCount, $iStatusMessageUnseenCount, $sStatusUidNext,
            \Aurora\Modules\Mail\Classes\Utils::GenerateFolderHash($sFolderFullNameRaw, $iStatusMessageCount, $iStatusMessageUnseenCount, $sStatusUidNext));
    }

    /**
     * Checks if particular extension is supported.
     *
     * @param MailAccount $oAccount Account object.
     * @param string $sExtensionName Extension name.
     *
     * @return bool
     */
    public function isExtensionSupported($oAccount, $sExtensionName)
    {
        if (0 === strlen($sExtensionName)) {
            throw new \Aurora\System\Exceptions\InvalidArgumentException();
        }

        $oImapClient = &$this->_getImapClient($oAccount);

        return $oImapClient->IsSupported($sExtensionName);
    }

    /**
     * Obtains information about particular folder.
     *
     * @param MailAccount $oAccount Account object.
     * @param string $sFolderFullNameRaw Raw full name of the folder.
     *
     * @return array array containing the following elements:
            - total number of messages;
            - number of unread messages;
            - UIDNEXT value for the folder;
            - hash string which changes its value if any of the other 3 values were changed.
     */
    public function getFolderInformation($oAccount, $sFolderFullNameRaw)
    {
        if (0 === strlen($sFolderFullNameRaw)) {
            throw new \Aurora\System\Exceptions\InvalidArgumentException();
        }

        $oImapClient = &$this->_getImapClient($oAccount);

        return $this->_getFolderInformation($oImapClient, $sFolderFullNameRaw);
    }

    /**
     * Retrieves information about new message, primarily used for Inbox folder.
     *
     * @param MailAccount $oAccount Account object.
     * @param string $sFolderFullNameRaw Raw full name of the folder.
     * @param string $sUidnext UIDNEXT value used for this operation.
     *
     * @return array
     */
    public function getNewMessagesInformation($oAccount, $sFolderFullNameRaw, $sUidnext, $sNewInboxUidnext)
    {
        if (!isset($sNewInboxUidnext) || $sNewInboxUidnext === '') {
            $sNewInboxUidnext = '*';
        }

        if (0 === strlen($sFolderFullNameRaw) || 0 === strlen($sFolderFullNameRaw)) {
            throw new \Aurora\System\Exceptions\InvalidArgumentException();
        }

        $oImapClient = &$this->_getImapClient($oAccount);

        $oImapClient->FolderExamine($sFolderFullNameRaw);

        $aResult = array();
        $aFetchResponse = $oImapClient->Fetch(array(
                \MailSo\Imap\Enumerations\FetchType::INDEX,
                \MailSo\Imap\Enumerations\FetchType::UID,
                \MailSo\Imap\Enumerations\FetchType::FLAGS,
                \MailSo\Imap\Enumerations\FetchType::BuildBodyCustomHeaderRequest(array(
                    \MailSo\Mime\Enumerations\Header::FROM_,
                    \MailSo\Mime\Enumerations\Header::SUBJECT,
                    \MailSo\Mime\Enumerations\Header::CONTENT_TYPE
                ))
            ), $sUidnext . ':' . $sNewInboxUidnext, true);

        if (\is_array($aFetchResponse) && 0 < \count($aFetchResponse)) {
            foreach ($aFetchResponse as /* @var $oFetchResponse \MailSo\Imap\FetchResponse */ $oFetchResponse) {
                $aFlags = \array_map('strtolower', $oFetchResponse->GetFetchValue(
                    \MailSo\Imap\Enumerations\FetchType::FLAGS
                ));

                if (!\in_array(\strtolower(\MailSo\Imap\Enumerations\MessageFlag::SEEN), $aFlags)) {
                    $sUid = $oFetchResponse->GetFetchValue(\MailSo\Imap\Enumerations\FetchType::UID);
                    $sHeaders = $oFetchResponse->GetHeaderFieldsValue();

                    $oHeaders = \MailSo\Mime\HeaderCollection::NewInstance()->Parse($sHeaders);

                    $sContentTypeCharset = $oHeaders->ParameterValue(
                        \MailSo\Mime\Enumerations\Header::CONTENT_TYPE,
                        \MailSo\Mime\Enumerations\Parameter::CHARSET
                    );

                    $sCharset = '';
                    if (0 < \strlen($sContentTypeCharset)) {
                        $sCharset = $sContentTypeCharset;
                    }

                    if (0 < \strlen($sCharset)) {
                        $oHeaders->SetParentCharset($sCharset);
                    }

                    if ($sUid !== $sNewInboxUidnext) {
                        $aResult[] = array(
                            'Folder' => $sFolderFullNameRaw,
                            'Uid' => $sUid,
                            'Subject' => $oHeaders->ValueByName(\MailSo\Mime\Enumerations\Header::SUBJECT, 0 === \strlen($sCharset)),
                            'From' => $oHeaders->GetAsEmailCollection(\MailSo\Mime\Enumerations\Header::FROM_, 0 === \strlen($sCharset))
                        );
                    }
                }
            }
        }

        return $aResult;
    }

    public function getMessageUIDByMessageID($oAccount, $sFolderFullNameRaw, $sUidnext, $MessageID)
    {
        if (0 === strlen($sFolderFullNameRaw) || 0 === strlen($sFolderFullNameRaw)) {
            throw new \Aurora\System\Exceptions\InvalidArgumentException();
        }

        $oImapClient = &$this->_getImapClient($oAccount);

        $oImapClient->FolderExamine($sFolderFullNameRaw);

        $mResult = false;
        $aFetchResponse = $oImapClient->Fetch(array(
                \MailSo\Imap\Enumerations\FetchType::UID,
                \MailSo\Imap\Enumerations\FetchType::BuildBodyCustomHeaderRequest(array(
                    \MailSo\Mime\Enumerations\Header::MESSAGE_ID
                ))
            ), $sUidnext . ':*', true);

        if (\is_array($aFetchResponse) && 0 < \count($aFetchResponse)) {
            foreach ($aFetchResponse as /* @var $oFetchResponse \MailSo\Imap\FetchResponse */ $oFetchResponse) {
                $sUid = $oFetchResponse->GetFetchValue(\MailSo\Imap\Enumerations\FetchType::UID);
                $sHeaders = $oFetchResponse->GetHeaderFieldsValue();

                $oHeaders = \MailSo\Mime\HeaderCollection::NewInstance()->Parse($sHeaders);
                $sMessageId = $oHeaders->ValueByName(\MailSo\Mime\Enumerations\Header::MESSAGE_ID);
                if ($MessageID === $sMessageId) {
                    $mResult = $sUid;
                }
            }
        }

        return $mResult;
    }

    /**
     * Obtains information about particular folders.
     *
     * @param MailAccount $oAccount Account object.
     * @param array $aFolderFullNamesRaw Array containing a list of folder names to obtain information for.
     * @param boolean $bUseListStatusIfPossible Indicates if LIST-STATUS command should be used if it's supported by IMAP server.
     *
     * @return array Array containing elements like those returned by **getFolderInformation** method.
     */
    public function getFolderListInformation($oAccount, $aFolderFullNamesRaw, $bUseListStatusIfPossible)
    {
        if (!is_array($aFolderFullNamesRaw) || 0 === count($aFolderFullNamesRaw)) {
            throw new \Aurora\System\Exceptions\InvalidArgumentException();
        }

        $oImapClient = &$this->_getImapClient($oAccount);

        $aResult = array();
        if ($bUseListStatusIfPossible && $oImapClient->IsSupported('LIST-STATUS')) {
            $aFolders = $oImapClient->FolderStatusList();

            if (is_array($aFolders)) {
                foreach ($aFolders as /* @var $oImapFolder \MailSo\Imap\Folder */ $oImapFolder) {
                    $oFolder = \Aurora\Modules\Mail\Classes\Folder::createInstance($oImapFolder, true);
                    if ($oFolder) {
                        $mStatus = $oFolder->getStatus();
                        if (is_array($mStatus) && isset($mStatus['MESSAGES'], $mStatus['UNSEEN'], $mStatus['UIDNEXT'])) {
                            $aResult[$oFolder->getRawFullName()] = array(
                                (int) $mStatus['MESSAGES'],
                                (int) $mStatus['UNSEEN'],
                                (string) $mStatus['UIDNEXT'],
                                \Aurora\Modules\Mail\Classes\Utils::GenerateFolderHash(
                                    $oFolder->getRawFullName(),
                                    $mStatus['MESSAGES'],
                                    $mStatus['UNSEEN'],
                                    $mStatus['UIDNEXT']
                                )
                            );
                        }
                    }

                    unset($oFolder);
                }
            }
        } else {
            foreach ($aFolderFullNamesRaw as $sFolderFullNameRaw) {
                $sFolderFullNameRaw = (string) $sFolderFullNameRaw;

                try {
                    $aResult[$sFolderFullNameRaw] = $this->_getFolderInformation($oImapClient, $sFolderFullNameRaw);
                } catch (\Exception $oException) {
                }
            }
        }

        return $aResult;
    }

    /**
     * Creates a new folder.
     *
     * @param MailAccount $oAccount Account object.
     * @param string $sFolderNameInUtf8 Folder name in utf8.
     * @param string $sDelimiter IMAP delimiter value.
     * @param string $sFolderParentFullNameRaw = ''. Parent folder this new one is created under.
     * @param bool $bSubscribeOnCreation = true. If **true**, the folder will be subscribed and thus made visible in the interface.
     *
     * @throws \Aurora\System\Exceptions\InvalidArgumentException
     * @throws \Aurora\System\Exceptions\BaseException
     *
     * @return void
     */
    public function createFolder($oAccount, $sFolderNameInUtf8, $sDelimiter, $sFolderParentFullNameRaw = '', $bSubscribeOnCreation = true)
    {
        if (0 === strlen($sFolderNameInUtf8) || 0 === strlen($sDelimiter)) {
            throw new \Aurora\System\Exceptions\InvalidArgumentException();
        }

        $sFolderNameInUtf8 = trim($sFolderNameInUtf8);

        if (0 < strlen($sFolderParentFullNameRaw)) {
            $sFolderParentFullNameRaw .= $sDelimiter;
        }

        $sNameToCreate = \MailSo\Base\Utils::ConvertEncoding(
            $sFolderNameInUtf8,
            \MailSo\Base\Enumerations\Charset::UTF_8,
            \MailSo\Base\Enumerations\Charset::UTF_7_IMAP
        );

        if (0 < strlen($sDelimiter) && false !== strpos($sNameToCreate, $sDelimiter)) {
            throw new \Aurora\Modules\Mail\Exceptions\Exception(\Aurora\Modules\Mail\Enums\ErrorCodes::FolderNameContainsDelimiter);
        }

        $this->createFolderByFullName(
            $oAccount,
            $sFolderParentFullNameRaw . $sNameToCreate,
            $bSubscribeOnCreation
        );
    }

    /**
     * Deletes folder.
     *
     * @param MailAccount $oAccount Account object.
     * @param string $sFolderFullNameRaw Raw full name of the folder.
     * @param bool $bUnsubscribeOnDeletion = true. If **true** the folder will be unsubscribed along with its deletion.
     *
     * @throws \Aurora\System\Exceptions\InvalidArgumentException
     */
    public function deleteFolder($oAccount, $sFolderFullNameRaw, $bUnsubscribeOnDeletion = true)
    {
        if (0 === strlen($sFolderFullNameRaw)) {
            throw new \Aurora\System\Exceptions\InvalidArgumentException();
        }

        $oImapClient = &$this->_getImapClient($oAccount);

        if ($bUnsubscribeOnDeletion) {
            $oImapClient->FolderUnSubscribe($sFolderFullNameRaw);
        }

        $oImapClient->FolderDelete($sFolderFullNameRaw);
    }

    /**
     * Changes folder's name.
     *
     * @param MailAccount $oAccount Account object.
     * @param string $sPrevFolderFullNameRaw Raw full name of the folder.
     * @param string $sNewTopFolderNameInUtf8 = ''. New name for the folder in utf8.
     * @param bool $bChangeParent = false
     * @param string $sNewParentFolder = ''
     *
     * @return string
     *
     * @throws \Aurora\System\Exceptions\InvalidArgumentException
     * @throws \Aurora\System\Exceptions\BaseException
     */
    public function renameFolder($oAccount, $sPrevFolderFullNameRaw, $sNewTopFolderNameInUtf8, $bChangeParent, $sNewParentFolder)
    {
        $sNewTopFolderNameInUtf8 = trim($sNewTopFolderNameInUtf8);
        if (0 === strlen($sPrevFolderFullNameRaw) || 0 === strlen($sNewTopFolderNameInUtf8)) {
            throw new \Aurora\System\Exceptions\InvalidArgumentException();
        }

        $oImapClient = &$this->_getImapClient($oAccount);

        $aFolders = $oImapClient->FolderList('', $sPrevFolderFullNameRaw);
        if (!is_array($aFolders) || !isset($aFolders[0])) {
            throw new \Aurora\Modules\Mail\Exceptions\Exception(\Aurora\Modules\Mail\Enums\ErrorCodes::CannotRenameNonExistenFolder);
        }

        $sDelimiter = $aFolders[0]->Delimiter();
        $iLast = strrpos($sPrevFolderFullNameRaw, $sDelimiter);
        $sFolderParentFullNameRaw = false === $iLast ? '' : substr($sPrevFolderFullNameRaw, 0, $iLast + 1);

        $aSubscribeFolders = $oImapClient->FolderSubscribeList($sPrevFolderFullNameRaw, '*');
        if (is_array($aSubscribeFolders) && 0 < count($aSubscribeFolders)) {
            foreach ($aSubscribeFolders as /* @var $oFolder \MailSo\Imap\Folder */ $oFolder) {
                $oImapClient->FolderUnSubscribe($oFolder->FullNameRaw());
            }
        }

        $sNewFolderFullNameRaw = \MailSo\Base\Utils::ConvertEncoding(
            $sNewTopFolderNameInUtf8,
            \MailSo\Base\Enumerations\Charset::UTF_8,
            \MailSo\Base\Enumerations\Charset::UTF_7_IMAP
        );

        if (0 < strlen($sDelimiter) && false !== strpos($sNewFolderFullNameRaw, $sDelimiter)) {
            throw new \Aurora\Modules\Mail\Exceptions\Exception(\Aurora\Modules\Mail\Enums\ErrorCodes::FolderNameContainsDelimiter);
        }

        if ($bChangeParent) {
            if (!empty($sNewParentFolder)) {
                $sNewFolderFullNameRaw = $sNewParentFolder . $sDelimiter . $sNewFolderFullNameRaw;
            }
        } else {
            $sNewFolderFullNameRaw = $sFolderParentFullNameRaw . $sNewFolderFullNameRaw;
        }

        $oImapClient->FolderRename($sPrevFolderFullNameRaw, $sNewFolderFullNameRaw);

        if (is_array($aSubscribeFolders) && 0 < count($aSubscribeFolders)) {
            foreach ($aSubscribeFolders as /* @var $oFolder \MailSo\Imap\Folder */ $oFolder) {
                $sFolderFullNameRawForResubscrine = $oFolder->FullNameRaw();
                if (0 === strpos($sFolderFullNameRawForResubscrine, $sPrevFolderFullNameRaw)) {
                    $sNewFolderFullNameRawForResubscrine = $sNewFolderFullNameRaw .
                        substr($sFolderFullNameRawForResubscrine, strlen($sPrevFolderFullNameRaw));

                    $oImapClient->FolderSubscribe($sNewFolderFullNameRawForResubscrine);
                }
            }
        }

        $aOrders = $this->getFoldersOrder($oAccount);
        if (is_array($aOrders)) {
            foreach ($aOrders as &$sName) {
                if ($sPrevFolderFullNameRaw === $sName) {
                    $sName = $sNewFolderFullNameRaw;
                    $this->updateFoldersOrder($oAccount, $aOrders);
                    break;
                }
            }
        }

        return $sNewFolderFullNameRaw;
    }

    /**
     * Subscribes to IMAP folder or unsubscribes from it.
     *
     * @param MailAccount $oAccount Account object.
     * @param string $sFolderFullNameRaw Raw full name of the folder.
     * @param bool $bSubscribeAction = true. If **true** the folder will be subscribed, otherwise unsubscribed.
     *
     * @throws \Aurora\System\Exceptions\InvalidArgumentException
     */
    public function subscribeFolder($oAccount, $sFolderFullNameRaw, $bSubscribeAction = true)
    {
        if (0 === strlen($sFolderFullNameRaw)) {
            throw new \Aurora\System\Exceptions\InvalidArgumentException();
        }

        $oImapClient = &$this->_getImapClient($oAccount);

        if ($bSubscribeAction) {
            $oImapClient->FolderSubscribe($sFolderFullNameRaw);
        } else {
            $oImapClient->FolderUnSubscribe($sFolderFullNameRaw);
        }
    }

    /**
     * Purges all the content of a particular folder.
     *
     * @param MailAccount $oAccount Account object.
     * @param string $sFolderFullNameRaw Raw full name of the folder.
     *
     * @return void
     *
     * @throws \Aurora\System\Exceptions\InvalidArgumentException
     */
    public function clearFolder($oAccount, $sFolderFullNameRaw)
    {
        if (0 === strlen($sFolderFullNameRaw)) {
            throw new \Aurora\System\Exceptions\InvalidArgumentException();
        }

        $oImapClient = &$this->_getImapClient($oAccount);

        $oImapClient->FolderSelect($sFolderFullNameRaw);

        $oInfo = $oImapClient->FolderCurrentInformation();
        if ($oInfo && 0 < $oInfo->Exists) {
            $oImapClient->MessageStoreFlag(
                '1:*',
                false,
                array(\MailSo\Imap\Enumerations\MessageFlag::DELETED),
                \MailSo\Imap\Enumerations\StoreAction::ADD_FLAGS_SILENT
            );
        }

        $oImapClient->MessageExpunge();
    }

    /**
     * Deletes one or several messages from IMAP.
     *
     * @param MailAccount $oAccount Account object.
     * @param string $sFolderFullNameRaw Folder the messages are to be deleted from.
     * @param array $aUids List of message UIDs.
     *
     * @return void
     *
     * @throws \Aurora\System\Exceptions\InvalidArgumentException
     */
    public function deleteMessage($oAccount, $sFolderFullNameRaw, $aUids)
    {
        if (0 === strlen($sFolderFullNameRaw) || !is_array($aUids) || 0 === count($aUids)) {
            throw new \Aurora\System\Exceptions\InvalidArgumentException();
        }

        $oImapClient = &$this->_getImapClient($oAccount);

        $oImapClient->FolderSelect($sFolderFullNameRaw);

        $sUidsRange = implode(',', $aUids);

        $oImapClient->MessageStoreFlag(
            $sUidsRange,
            true,
            array(\MailSo\Imap\Enumerations\MessageFlag::DELETED),
            \MailSo\Imap\Enumerations\StoreAction::ADD_FLAGS_SILENT
        );

        $oImapClient->MessageExpunge($sUidsRange, true);
    }

    /**
     * Moves message from one folder to another.
     *
     * @param MailAccount $oAccount Account object.
     * @param string $sFromFolderFullNameRaw Raw full name of the source folder.
     * @param string $sToFolderFullNameRaw Raw full name of the destination folder.
     * @param array $aUids List of message UIDs.
     *
     * @return void
     *
     * @throws \Aurora\System\Exceptions\InvalidArgumentException
     */
    public function moveMessage($oAccount, $sFromFolderFullNameRaw, $sToFolderFullNameRaw, $aUids)
    {
        if (0 === strlen($sFromFolderFullNameRaw) || 0 === strlen($sToFolderFullNameRaw) ||
            !is_array($aUids) || 0 === count($aUids)) {
            throw new \Aurora\System\Exceptions\InvalidArgumentException();
        }

        $oImapClient = &$this->_getImapClient($oAccount);

        $oImapClient->FolderSelect($sFromFolderFullNameRaw);

        if ($oImapClient->IsSupported('MOVE')) {
            $oImapClient->MessageMove($sToFolderFullNameRaw, implode(',', $aUids), true);
        } else {
            $oImapClient->MessageCopy($sToFolderFullNameRaw, implode(',', $aUids), true);
            $this->deleteMessage($oAccount, $sFromFolderFullNameRaw, $aUids);
        }
    }

    /**
     * Copies one or several message from one folder to another.
     *
     * @param MailAccount $oAccount Account object.
     * @param string $sFromFolderFullNameRaw Raw full name of source folder.
     * @param string $sToFolderFullNameRaw Raw full name of destination folder.
     * @param array $aUids List of message UIDs.
     *
     * @return void
     *
     * @throws \Aurora\System\Exceptions\InvalidArgumentException
     */
    public function copyMessage($oAccount, $sFromFolderFullNameRaw, $sToFolderFullNameRaw, $aUids)
    {
        if (0 === strlen($sFromFolderFullNameRaw) || 0 === strlen($sToFolderFullNameRaw) ||
            !is_array($aUids) || 0 === count($aUids)) {
            throw new \Aurora\System\Exceptions\InvalidArgumentException();
        }

        $oImapClient = &$this->_getImapClient($oAccount);

        $oImapClient->FolderSelect($sFromFolderFullNameRaw);

        $oImapClient->MessageCopy($sToFolderFullNameRaw, implode(',', $aUids), true);
    }

    /**
     * Sends message out.
     *
     * @param MailAccount $oAccount Account object.
     * @param \MailSo\Mime\Message $oMessage Message to be sent out.
     * @param \Aurora\Modules\Mail\Models\Fetcher $oFetcher = null. Fetcher object which may override sending settings.
     * @param string $sSentFolder = ''. Name of Sent folder.
     * @param string $sDraftFolder = ''. Name of Sent folder.
     * @param string $sDraftUid = ''. Last UID value of the message saved in Drafts folder.
     * @param array $aRecipients Recipients that will be used to send messages through the SMTP. Use this parameter if you want real recipients to differ from those specified in the message body (To, CC, BCC).
     *
     * @return array|bool
     *
     * @throws \Aurora\System\Exceptions\InvalidArgumentException
     */
    public function sendMessage($oAccount, $oMessage, $oFetcher = null, $oIdentity = null, $sSentFolder = '', $sDraftFolder = '', $sDraftUid = '', $aRecipients = array())
    {
        if (!$oAccount || !$oMessage) {
            throw new \Aurora\System\Exceptions\InvalidArgumentException();
        }

        $oImapClient = &$this->_getImapClient($oAccount);

        $rMessageStream = \MailSo\Base\ResourceRegistry::CreateMemoryResource();

        $iMessageStreamSize = \MailSo\Base\Utils::MultipleStreamWriter(
            $oMessage->ToStream(true),
            array($rMessageStream),
            8192,
            true,
            true,
            true
        );

        $mResult = false;
        if (false !== $iMessageStreamSize && is_resource($rMessageStream)) {
            $oRcpt = $oMessage->GetRcpt();
            if (count($aRecipients) > 0) {
                $oRcpt = \MailSo\Mime\EmailCollection::NewInstance(implode(',', $aRecipients));
            }
            if ($oRcpt && 0 < $oRcpt->Count()) {
                $oServer = null;
                try {
                    $oSettings = &\Aurora\System\Api::GetSettings();
                    $iConnectTimeOut = $oSettings->SocketConnectTimeoutSeconds;
                    $iSocketTimeOut = $oSettings->SocketGetTimeoutSeconds;
                    $bVerifySsl = !!$oSettings->SocketVerifySsl;

                    $oSmtpClient = \MailSo\Smtp\SmtpClient::NewInstance();
                    $oSmtpClient->SetTimeOuts($iConnectTimeOut, $iSocketTimeOut);

                    $oLogger = $oImapClient->Logger();
                    if ($oLogger) {
                        $oSmtpClient->SetLogger($oLogger);
                    }

                    $oServer = $oAccount->getServer();
                    $iSecure = \MailSo\Net\Enumerations\ConnectionSecurityType::AUTO_DETECT;
                    if ($oFetcher) {
                        $iSecure = $oFetcher->OutgoingMailSecurity;
                    } elseif ($oServer->OutgoingUseSsl) {
                        $iSecure = \MailSo\Net\Enumerations\ConnectionSecurityType::SSL;
                    }

                    $sEhlo = \MailSo\Smtp\SmtpClient::EhloHelper();

                    if ($oFetcher) {
                        $oSmtpClient->Connect($oFetcher->OutgoingServer, $oFetcher->OutgoingPort, $sEhlo, $iSecure, $bVerifySsl);
                    } else {
                        $oSmtpClient->Connect($oServer->OutgoingServer, $oServer->OutgoingPort, $sEhlo, $iSecure, $bVerifySsl);
                    }

                    if ($oFetcher && $oFetcher->OutgoingUseAuth) {
                        $oSmtpClient->Login($oFetcher->IncomingLogin, $oFetcher->IncomingPassword);
                    } elseif ($oServer->SmtpAuthType === \Aurora\Modules\Mail\Enums\SmtpAuthType::UseUserCredentials) {
                        if (!empty($oAccount->XOAuth)) {
                            $sToken = \Aurora\Modules\OAuthIntegratorWebclient\Module::Decorator()->GetAccessToken($oAccount->XOAuth, $oAccount->Email);
                            if ($sToken) {
                                $sXOAuthKey = \MailSo\Imap\ImapClient::GetXOAuthKeyStatic($oAccount->Email, $sToken);
                                $oSmtpClient->LoginWithXOAuth2($sXOAuthKey);
                            }
                        } else {
                            $oSmtpClient->Login($oAccount->IncomingLogin, $oAccount->getPassword());
                        }
                    } elseif ($oServer->SmtpAuthType === \Aurora\Modules\Mail\Enums\SmtpAuthType::UseSpecifiedCredentials) {
                        $oSmtpClient->Login($oServer->SmtpLogin, $oServer->SmtpPassword);
                    }

                    if ($oIdentity && $this->oModule->oModuleSettings->UseIdentityEmailAsSmtpMailFrom) {
                        $sMailFrom = $oIdentity->Email;
                    } elseif ($oFetcher) {
                        $sMailFrom = $oFetcher->Email;
                    } else {
                        $sMailFrom = $oAccount->Email;
                    }
                    $oSmtpClient->MailFrom($sMailFrom, (string) $iMessageStreamSize);

                    $aRcpt = &$oRcpt->GetAsArray();

                    foreach ($aRcpt as /* @var $oEmail \MailSo\Mime\Email */ $oEmail) {
                        $sRcptEmail = $oEmail->GetEmail();
                        $oSmtpClient->Rcpt($sRcptEmail);
                    }

                    $oSmtpClient->DataWithStream($rMessageStream);

                    $oSmtpClient->LogoutAndDisconnect();
                } catch (\MailSo\Net\Exceptions\ConnectionException $oException) {
                    throw new \Aurora\Modules\Mail\Exceptions\Exception(
                        \Aurora\Modules\Mail\Enums\ErrorCodes::CannotConnectToMailServer,
                        $oException,
                        $oException->getMessage()
                    );
                } catch (\MailSo\Smtp\Exceptions\LoginException $oException) {
                    throw new \Aurora\Modules\Mail\Exceptions\Exception(
                        \Aurora\Modules\Mail\Enums\ErrorCodes::CannotLoginCredentialsIncorrect,
                        $oException,
                        $oException->getMessage()
                    );
                } catch (\MailSo\Smtp\Exceptions\NegativeResponseException $oException) {
                    throw new \Aurora\Modules\Mail\Exceptions\Exception(
                        \Aurora\Modules\Mail\Enums\ErrorCodes::CannotSendMessage,
                        $oException,
                        $oException->getMessage()
                    );
                } catch (\MailSo\Smtp\Exceptions\MailboxUnavailableException $oException) {
                    $iErrorCode = ($oServer && $oServer->SmtpAuthType === \Aurora\Modules\Mail\Enums\SmtpAuthType::UseUserCredentials)
                        ? \Aurora\Modules\Mail\Enums\ErrorCodes::CannotSendMessageToRecipients
                        : \Aurora\Modules\Mail\Enums\ErrorCodes::CannotSendMessageToExternalRecipients;
                    throw new \Aurora\Modules\Mail\Exceptions\Exception(
                        $iErrorCode,
                        $oException,
                        $oException->getMessage()
                    );
                }

                if (0 < strlen($sSentFolder)) {
                    try {
                        if (!$oMessage->GetBcc()) {
                            if (is_resource($rMessageStream)) {
                                rewind($rMessageStream);
                            }

                            $oImapClient->MessageAppendStream(
                                $sSentFolder,
                                $rMessageStream,
                                $iMessageStreamSize,
                                array(
                                    \MailSo\Imap\Enumerations\MessageFlag::SEEN
                                )
                            );
                        } else {
                            $rAppendMessageStream = \MailSo\Base\ResourceRegistry::CreateMemoryResource();

                            // if (is_resource($rMessageStream))
                            // {
                            // 	rewind($rMessageStream);
                            // }
                            $iAppendMessageStreamSize = \MailSo\Base\Utils::MultipleStreamWriter(
                                $oMessage->ToStream()/*$rMessageStream*/,
                                array($rAppendMessageStream),
                                8192,
                                true,
                                true,
                                true
                            );

                            $oImapClient->MessageAppendStream(
                                $sSentFolder,
                                $rAppendMessageStream,
                                $iAppendMessageStreamSize,
                                array(
                                    \MailSo\Imap\Enumerations\MessageFlag::SEEN
                                )
                            );

                            if (is_resource($rAppendMessageStream)) {
                                @fclose($rAppendMessageStream);
                            }
                        }
                    } catch (\Exception $oException) {
                        throw new \Aurora\Modules\Mail\Exceptions\Exception(
                            \Aurora\Modules\Mail\Enums\ErrorCodes::CannotSaveMessageToSentItems,
                            $oException,
                            $oException->getMessage()
                        );
                    }

                    if (is_resource($rMessageStream)) {
                        @fclose($rMessageStream);
                    }
                }

                if (0 < strlen($sDraftFolder) && 0 < strlen($sDraftUid)) {
                    try {
                        $this->deleteMessage($oAccount, $sDraftFolder, array($sDraftUid));
                    } catch (\Exception $oException) {
                    }
                }

                $mResult = true;
            } else {
                throw new \Aurora\Modules\Mail\Exceptions\Exception(\Aurora\Modules\Mail\Enums\ErrorCodes::CannotSendMessageInvalidRecipients);
            }
        }

        return $mResult;
    }

    /**
     * Saves message to a specific folder. The method is primarily used for saving drafts.
     *
     * @param MailAccount $oAccount Account object.
     * @param \MailSo\Mime\Message $oMessage Object representing message to be saved.
     * @param string $sDraftFolder Folder the message is saved to.
     * @param string $sDraftUid = ''. UID of the message to be replaced; saving new draft removes the previous version.
     *
     * @return array|bool Array containing name of the folder and UID of the message stored, or bool in case of failure.
     *
     * @throws \Aurora\System\Exceptions\InvalidArgumentException
     */
    public function saveMessage($oAccount, $oMessage, $sDraftFolder, $sDraftUid = '')
    {
        if (!$oAccount || !$oMessage || 0 === strlen($sDraftFolder)) {
            throw new \Aurora\System\Exceptions\InvalidArgumentException();
        }

        $oImapClient = &$this->_getImapClient($oAccount);

        $rMessageStream = \MailSo\Base\ResourceRegistry::CreateMemoryResource();

        $iMessageStreamSize = \MailSo\Base\Utils::MultipleStreamWriter(
            $oMessage->ToStream(),
            array($rMessageStream),
            8192,
            true,
            true
        );

        $mResult = false;
        if (false !== $iMessageStreamSize && is_resource($rMessageStream)) {
            rewind($rMessageStream);

            $iNewUid = 0;

            $oImapClient->MessageAppendStream(
                $sDraftFolder,
                $rMessageStream,
                $iMessageStreamSize,
                array(
                    \MailSo\Imap\Enumerations\MessageFlag::SEEN
                ),
                $iNewUid
            );

            if (null === $iNewUid || 0 === $iNewUid) {
                $sMessageId = $oMessage->MessageId();
                if (0 < strlen($sMessageId)) {
                    $iNewUid = $this->getMessageUid($oAccount, $sDraftFolder, $sMessageId);
                }
            }

            $mResult = true;

            if (0 < strlen($sDraftFolder) && 0 < strlen($sDraftUid)) {
                $this->deleteMessage($oAccount, $sDraftFolder, array($sDraftUid));
            }

            if (null !== $iNewUid && 0 < $iNewUid) {
                $mResult = array(
                    'NewFolder' => $sDraftFolder,
                    'NewUid' => $iNewUid
                );
            }
        }

        return $mResult;
    }

    /**
     * Appends message from file to a specific folder.
     *
     * @param MailAccount $oAccount Account object.
     * @param string $sMessageFileName Path to .eml file.
     * @param string $sFolderToAppend Folder the message is appended to.
     *
     * @return void
     */
    public function appendMessageFromFile($oAccount, $sMessageFileName, $sFolderToAppend)
    {
        $oImapClient = &$this->_getImapClient($oAccount);
        $oImapClient->MessageAppendFile($sMessageFileName, $sFolderToAppend);
    }

    /**
     * Appends message from stream to a specific folder.
     *
     * @param MailAccount $oAccount Account object.
     * @param resource $rMessage Resource the message is appended from.
     * @param string $sFolder Folder the message is appended to.
     * @param int $iStreamSize Size of stream.
     * @param int $iUid
     *
     * @return void
     */
    public function appendMessageFromStream($oAccount, $rMessage, $sFolder, $iStreamSize, &$iUid = null)
    {
        $oImapClient = &$this->_getImapClient($oAccount);
        $oImapClient->MessageAppendStream($sFolder, $rMessage, $iStreamSize, null, $iUid);
    }

    /**
     * Sets, removes or toggles flags of one or several messages.
     *
     * @param MailAccount $oAccount Account object.
     * @param string $sFolderFullNameRaw Raw full name of the folder.
     * @param array $aUids List of message UIDs .
     * @param string $sFlagString String holding a list of flags to be modified.
     * @param int $iAction = \Aurora\Modules\Mail\Enums\MessageStoreAction::Add. Flag triggering mode.
     * @param bool $bSetToAll = false. If **true** flags will be applied to all messages in folder.
     * @param bool $bSkipNonPermanentsFlags = false. If **true** flags wich is not permanent will be skipped.
     *
     * @return true
     *
     * @throws \Aurora\System\Exceptions\InvalidArgumentException
     */
    public function setMessageFlag(
        $oAccount,
        $sFolderFullNameRaw,
        $aUids,
        $sFlagString,
        $iAction = \Aurora\Modules\Mail\Enums\MessageStoreAction::Add,
        $bSetToAll = false,
        $bSkipNonPermanentsFlags = false
    ) {
        if (0 === strlen($sFolderFullNameRaw) || (!$bSetToAll && (!is_array($aUids) || 0 === count($aUids)))) {
            throw new \Aurora\System\Exceptions\InvalidArgumentException();
        }

        $oImapClient = &$this->_getImapClient($oAccount);

        $oImapClient->FolderSelect($sFolderFullNameRaw);

        $aUids = is_array($aUids) ? $aUids : array();
        $sUids = implode(',', $aUids);

        $oInfo = $oImapClient->FolderCurrentInformation();
        if ($bSetToAll) {
            $sUids = '1:*';
            if ($oInfo && 0 === $oInfo->Exists) {
                return true;
            }
        }

        $aFlagsOut = array();
        $aFlags = explode(' ', $sFlagString);
        if ($bSkipNonPermanentsFlags && $oInfo) {
            if (!\in_array('\\*', $oInfo->PermanentFlags)) {
                foreach ($aFlags as $sFlag) {
                    $sFlag = \trim($sFlag);
                    if (\in_array($sFlag, $oInfo->PermanentFlags)) {
                        $aFlagsOut[] = $sFlag;
                    }
                }
            } else {
                $aFlagsOut = $aFlags;
            }

            if (0 === \count($aFlagsOut)) {
                return true;
            }
        } else {
            $aFlagsOut = $aFlags;
        }

        $sResultAction = \MailSo\Imap\Enumerations\StoreAction::ADD_FLAGS_SILENT;
        switch ($iAction) {
            case \Aurora\Modules\Mail\Enums\MessageStoreAction::Add:
                $sResultAction = \MailSo\Imap\Enumerations\StoreAction::ADD_FLAGS_SILENT;
                break;
            case \Aurora\Modules\Mail\Enums\MessageStoreAction::Remove:
                $sResultAction = \MailSo\Imap\Enumerations\StoreAction::REMOVE_FLAGS_SILENT;
                break;
            case \Aurora\Modules\Mail\Enums\MessageStoreAction::Set:
                $sResultAction = \MailSo\Imap\Enumerations\StoreAction::SET_FLAGS_SILENT;
                break;
        }

        $oImapClient->MessageStoreFlag($sUids, $bSetToAll ? false : true, $aFlags, $sResultAction);
        return true;
    }

    /**
     * Searches for a message with a specific Message-ID value and returns it's uid.
     *
     * @param MailAccount $oAccount Account object.
     * @param string $sFolderName Name of the folder to look for message in.
     * @param string $sMessageId Message-ID value of the message.
     *
     * @return int|null Integer message UID if the message was found, null otherwise.
     */
    public function getMessageUid($oAccount, $sFolderName, $sMessageId)
    {
        if (0 === strlen($sFolderName) || 0 === strlen($sMessageId)) {
            throw new \Aurora\System\Exceptions\InvalidArgumentException();
        }

        $oImapClient = &$this->_getImapClient($oAccount);

        $oImapClient->FolderExamine($sFolderName);

        $aUids = $oImapClient->MessageSimpleSearch('HEADER Message-ID ' . $sMessageId, true);

        return is_array($aUids) && 1 === count($aUids) && is_numeric($aUids[0]) ? (int) $aUids[0] : null;
    }

    public function getUnifiedMailboxMessagesInfo($oAccount, $sFolderName, $sSearch = '', $aFilters = [], $bUseThreading = false, $Limit = 20, $sSortBy = 'ARRIVAL', $sSortOrder = 'REVERSE')
    {
        if (0 === strlen($sFolderName)) {
            throw new \Aurora\System\Exceptions\InvalidArgumentException();
        }

        $oImapClient = &$this->_getImapClient($oAccount);
        $oImapClient->FolderExamine($sFolderName);

        $oCurrentFolderInformation = $oImapClient->FolderCurrentInformation();
        $iMessageCount = $oCurrentFolderInformation->Exists;
        $mResult = array();

        $sStatusUidNext = $oCurrentFolderInformation->Uidnext;
        if (0 === strlen($sStatusUidNext)) {
            $sStatusUidNext = '0';
        }

        $aThreads = array();
        $oServer = $oAccount->getServer();
        $bUseThreadingIfSupported = $oServer->EnableThreading && $oAccount->UseThreading;
        if ($bUseThreadingIfSupported) {
            $bUseThreadingIfSupported = $bUseThreading;
        }
        if ($bUseThreadingIfSupported) {
            $bUseThreadingIfSupported = $oImapClient->IsSupported('THREAD=REFS') || $oImapClient->IsSupported('THREAD=REFERENCES') || $oImapClient->IsSupported('THREAD=ORDEREDSUBJECT');
        }

        $iMessageResultCount = 0;
        if ($iMessageCount > 0) {
            $bIndexAsUid = true;

            $bUseSortIfSupported = $oImapClient->IsSupported('SORT') && !empty($sSortBy);

            if (0 < strlen($sSearch) || 0 < count($aFilters)) {
                $sCutedSearch = $sSearch;

                $sCutedSearch = \preg_replace('/[\s]+/', ' ', $sCutedSearch);
                $sCutedSearch = \preg_replace('/attach[ ]?:[ ]?/i', 'attach:', $sCutedSearch);

                $bSearchAttachments = false;
                $fAttachmentSearchCallback = null;
                $aMatch = array();

                $aIndexOrUids = null;

                $bUseBodyStructuresForHasAttachmentsSearch = $this->oModule->oModuleSettings->UseBodyStructuresForHasAttachmentsSearch;
                if (($bUseBodyStructuresForHasAttachmentsSearch && \preg_match('/has[ ]?:[ ]?attachments/i', $sSearch)) ||
                    \preg_match('/attach:([^\s]+)/i', $sSearch, $aMatch)) {
                    $bSearchAttachments = true;
                    $sAttachmentName = isset($aMatch[1]) ? trim($aMatch[1]) : '';
                    $sAttachmentRegs = !empty($sAttachmentName) && '*' !== $sAttachmentName ?
                        '/[^>]*' . str_replace('\\*', '[^>]*', preg_quote(trim($sAttachmentName, '*'), '/')) . '[^>]*/ui' : '';

                    if ($bUseBodyStructuresForHasAttachmentsSearch) {
                        $sCutedSearch = trim(preg_replace('/has[ ]?:[ ]?attachments/i', '', $sCutedSearch));
                    }

                    $sCutedSearch = trim(preg_replace('/attach:([^\s]+)/', '', $sCutedSearch));

                    $fAttachmentSearchCallback = function ($oBodyStructure, $sSize, $sInternalDate, $aFlagsLower, $sUid) use ($sFolderName, $sAttachmentRegs) {
                        $bResult = false;
                        if ($oBodyStructure) {
                            $aAttachmentsParts = $oBodyStructure->SearchAttachmentsParts();
                            if ($aAttachmentsParts && 0 < count($aAttachmentsParts)) {
                                $oAttachments = \Aurora\Modules\Mail\Classes\AttachmentCollection::createInstance();
                                foreach ($aAttachmentsParts as /* @var $oAttachmentItem \MailSo\Imap\BodyStructure */ $oAttachmentItem) {
                                    $oAttachments->Add(
                                        \Aurora\Modules\Mail\Classes\Attachment::createInstance($sFolderName, $sUid, $oAttachmentItem)
                                    );
                                }

                                $bResult = $oAttachments->hasNotInlineAttachments();
                                if ($bResult && !empty($sAttachmentRegs)) {
                                    $aList = $oAttachments->FilterList(function ($oAttachment) use ($sAttachmentRegs) {
                                        if ($oAttachment && !$oAttachment->isInline() && !$oAttachment->getCid()) {
                                            return !!preg_match($sAttachmentRegs, $oAttachment->getFileName());
                                        }

                                        return false;
                                    });

                                    return is_array($aList) ? 0 < count($aList) : false;
                                }
                            }
                        }

                        unset($oBodyStructure);

                        return $bResult;
                    };
                }

                if (0 < strlen($sCutedSearch) || 0 < count($aFilters)) {
                    $bSearch = true;
                    $sSearchCriterias = $this->_prepareImapSearchString(
                        $oImapClient,
                        $sCutedSearch,
                        $oAccount->getDefaultTimeOffset() * 60,
                        $aFilters
                    );

                    $bIndexAsUid = true;

                    if ($bUseSortIfSupported) {
                        $aIndexOrUids = $oImapClient->MessageSimpleSort(array($sSortOrder . ' ' . $sSortBy), $sSearchCriterias, $bIndexAsUid);
                    } else {
                        if (!\MailSo\Base\Utils::IsAscii($sCutedSearch)) {
                            try {
                                $aIndexOrUids = $oImapClient->MessageSimpleSearch($sSearchCriterias, $bIndexAsUid, 'UTF-8');
                            } catch (\MailSo\Imap\Exceptions\NegativeResponseException $oException) {
                                // Charset is not supported. Skip and try request without charset.
                                $aIndexOrUids = null;
                            }
                        }

                        if (null === $aIndexOrUids) {
                            $aIndexOrUids = $oImapClient->MessageSimpleSearch($sSearchCriterias, $bIndexAsUid);
                        }
                    }

                    if ($bSearchAttachments && is_array($aIndexOrUids) && 0 < count($aIndexOrUids)) {
                        $aIndexOrUids = $this->_doSpecialUidsSearch(
                            $oImapClient,
                            $fAttachmentSearchCallback,
                            $sFolderName,
                            $aIndexOrUids
                        );
                    }
                } elseif ($bSearchAttachments) {
                    $bIndexAsUid = true;
                    $aIndexOrUids = $this->_doSpecialIndexSearch(
                        $oImapClient,
                        $fAttachmentSearchCallback,
                        $sFolderName
                    );
                }
            } elseif ($bUseThreadingIfSupported && 1 < $iMessageCount) {
                $bIndexAsUid = true;
                $aThreadUids = array();
                try {
                    $aThreadUids = $oImapClient->MessageSimpleThread();
                } catch (\MailSo\Imap\Exceptions\RuntimeException $oException) {
                    $aThreadUids = array();
                }

                $aThreads = $this->_compileThreadList($aThreadUids);
                if ($bUseSortIfSupported) {
                    $aThreads = $this->_resortThreadList(
                        $aThreads,
                        $oImapClient->MessageSimpleSort(array($sSortOrder . ' ' . $sSortBy), 'ALL', true)
                    );
                } else {
                    //						$this->chunkThreadArray($aThreads);
                }

                $aIndexOrUids = array_keys($aThreads);
                $iMessageCount = count($aIndexOrUids);
            } else {
                if ($bUseSortIfSupported && 1 < $iMessageCount) {
                    $bIndexAsUid = true;
                    $aIndexOrUids = $oImapClient->MessageSimpleSort(array($sSortOrder . ' ' . $sSortBy), 'ALL', $bIndexAsUid);
                } else {
                    $bIndexAsUid = false;
                    $aIndexOrUids = array(1);
                    if (1 < $iMessageCount) {
                        $aIndexOrUids = array_reverse(range(1, $iMessageCount));
                    }
                }
            }

            if ($bUseThreadingIfSupported && 1 < $iMessageCount) {
                $aThreadUids = array();
                try {
                    $aThreadUids = $oImapClient->MessageSimpleThread();
                } catch (\MailSo\Imap\Exceptions\RuntimeException $oException) {
                    $aThreadUids = array();
                }

                $aThreads = $this->_compileThreadList($aThreadUids);
                $aIndexOrUids = array_keys($aThreads);
                $iMessageCount = count($aIndexOrUids);
            }

            $iMessageResultCount = 0 < strlen($sSearch) || 0 < count($aFilters)
            ? count($aIndexOrUids) : $iMessageCount;

            $aIndexOrUids = array_slice(
                $aIndexOrUids,
                0,
                $Limit
            );

            $aFetchResponse = null;
            if (is_array($aIndexOrUids) && 0 < count($aIndexOrUids)) {
                try {
                    $aFetchResponse = $oImapClient->Fetch([
                        \MailSo\Imap\Enumerations\FetchType::INDEX,
                        \MailSo\Imap\Enumerations\FetchType::UID,
                        \MailSo\Imap\Enumerations\FetchType::INTERNALDATE
                    ], implode(',', $aIndexOrUids), $bIndexAsUid);
                } catch (\Exception $oEx) {
                }
            }
            if (is_array($aFetchResponse) && 0 < count($aFetchResponse)) {
                $oFetchResponseItem = null;
                foreach ($aFetchResponse as /* @var $oFetchResponseItem \MailSo\Imap\FetchResponse */ &$oFetchResponseItem) {
                    $sUid = $oFetchResponseItem->GetFetchValue(\MailSo\Imap\Enumerations\FetchType::UID);
                    $sInternalDate = $oFetchResponseItem->GetFetchValue(\MailSo\Imap\Enumerations\FetchType::INTERNALDATE);

                    $mResult[$sUid] = [
                        'accountid' => $oAccount->Id,
                        'uid' => $sUid,
                        'internaldate' => $sInternalDate
                    ];
                }
            }

            if ($bUseThreadingIfSupported && 0 < count($aThreads)) {
                foreach ($mResult as $sKey => $aItem) {
                    $iUid = $aItem['uid'];
                    if (isset($aThreads[$iUid]) && is_array($aThreads[$iUid])) {
                        foreach ($aThreads[$iUid] as $iThreadUid) {
                            if (isset($mResult[$iThreadUid])) {
                                unset($mResult[$iThreadUid]);
                            }
                            $mResult[$sKey]['threads'][] = $iThreadUid;
                        }
                    }
                }
            }
        }

        return [
            'Count' => $oCurrentFolderInformation->Exists,
            'ResultCount' => $iMessageResultCount,
            'UnreadCount' => $oCurrentFolderInformation->Unread,
            'Uids' => array_values($mResult),
            'Uidnext' => $sStatusUidNext,
            'FolderHash' => \Aurora\Modules\Mail\Classes\Utils::GenerateFolderHash(
                $sFolderName,
                $oCurrentFolderInformation->Exists,
                $oCurrentFolderInformation->Unread,
                $sStatusUidNext
            )
        ];
    }

    public function getMessagesInfo($oAccount, $sFolderName, $Search, $bUseThreading = false, $sSortBy = 'ARRIVAL', $sSortOrder = 'REVERSE')
    {
        if (0 === strlen($sFolderName)) {
            throw new \Aurora\System\Exceptions\InvalidArgumentException();
        }

        $oImapClient = &$this->_getImapClient($oAccount);
        $oImapClient->FolderExamine($sFolderName);

        $oCurrentFolderInformation = $oImapClient->FolderCurrentInformation();

        $mResult = array();

        if ($oCurrentFolderInformation->Exists > 0) {
            $bUseSortIfSupported = false;
            $aMessagesSortBy = $this->oModule->oModuleSettings->MessagesSortBy;
            if ($aMessagesSortBy !== false && is_array($aMessagesSortBy) && isset($aMessagesSortBy['Allow']) && (bool) $aMessagesSortBy['Allow'] !== false && !empty($sSortBy)) {
                $bUseSortIfSupported = $oImapClient->IsSupported('SORT');
            }

            $sFilter = $this->_prepareImapSearchString($oImapClient, $Search);
            if ($bUseSortIfSupported) {
                $aUids = $oImapClient->MessageSimpleSort(array($sSortOrder . ' ' . $sSortBy), $sFilter);
            } else {
                $aUids = $oImapClient->MessageSimpleSearch($sFilter);
            }

            $bIndexAsUid = true;

            $iMessageCount = 0;
            $aThreads = array();
            $oServer = $oAccount->getServer();
            $bUseThreadingIfSupported = $oServer->EnableThreading && $oAccount->UseThreading;
            if ($bUseThreadingIfSupported) {
                $bUseThreadingIfSupported = $bUseThreading;
            }
            if ($bUseThreadingIfSupported) {
                $bUseThreadingIfSupported = $oImapClient->IsSupported('THREAD=REFS') || $oImapClient->IsSupported('THREAD=REFERENCES') || $oImapClient->IsSupported('THREAD=ORDEREDSUBJECT');
            }
            if ($bUseThreadingIfSupported/* && 1 < $iMessageCount*/) {
                $aThreadUids = array();
                try {
                    $aThreadUids = $oImapClient->MessageSimpleThread();
                } catch (\MailSo\Imap\Exceptions\RuntimeException $oException) {
                    $aThreadUids = array();
                }

                $aThreads = $this->_compileThreadList($aThreadUids);
                $aIndexOrUids = array_keys($aThreads);
                $iMessageCount = count($aIndexOrUids);
            }

            $aIndexOrUidsChunk = array_chunk(
                $aUids,
                $this->oModule->oModuleSettings->MessagesInfoChunkSize
            );

            $mResult = array_flip($aUids);

            foreach ($aIndexOrUidsChunk as $aIndexOrUids) {
                $aFetchResponse = $oImapClient->Fetch([
                    \MailSo\Imap\Enumerations\FetchType::INDEX,
                    \MailSo\Imap\Enumerations\FetchType::UID,
                    \MailSo\Imap\Enumerations\FetchType::FLAGS
                ], implode(',', $aIndexOrUids), $bIndexAsUid);

                if (is_array($aFetchResponse) && 0 < count($aFetchResponse)) {
                    $oFetchResponseItem = null;
                    foreach ($aFetchResponse as /* @var $oFetchResponseItem \MailSo\Imap\FetchResponse */ &$oFetchResponseItem) {
                        $sUid = $oFetchResponseItem->GetFetchValue(\MailSo\Imap\Enumerations\FetchType::UID);
                        $aFlags = $oFetchResponseItem->GetFetchValue(\MailSo\Imap\Enumerations\FetchType::FLAGS);
                        $iMessageCount++;
                        if (is_array($aFlags)) {
                            $mResult[$sUid] = [
                                'uid' => (int) $sUid,
                                'flags' => array_map('strtolower', $aFlags)
                            ];
                        }
                    }
                }
            }

            if ($bUseThreadingIfSupported && 0 < count($aThreads)) {
                foreach ($mResult as $sKey => $aItem) {
                    $iUid = $aItem['uid'];
                    if (isset($aThreads[$iUid]) && is_array($aThreads[$iUid])) {
                        foreach ($aThreads[$iUid] as $iThreadUid) {
                            $aThreadFlags = [];
                            if (isset($mResult[$iThreadUid])) {
                                $aThreadFlags = $mResult[$iThreadUid]['flags'];
                                unset($mResult[$iThreadUid]);
                            }
                            $mResult[$sKey]['thread'][] = [
                                'uid' => $iThreadUid,
                                'flags' => $aThreadFlags
                            ];
                        }
                    }
                }
            }
        }

        return array_values($mResult);
    }

    /**
     * Retrieves quota information for the account.
     *
     * @param MailAccount $oAccount Account object.
     *
     * @return array|bool Array of quota values or bool if the information is unavailable.
     */
    public function getQuota($oAccount)
    {
        $iMAX_32_INT = 2147483647;
        $oImapClient = &$this->_getImapClient($oAccount);
        $aQuota = $oImapClient->Quota();
        if (is_array($aQuota) && isset($aQuota[1]) && ($aQuota[1] / 1024 > $iMAX_32_INT)) {
            $aQuota[1] = 0;
        }

        return $aQuota;
    }

    /**
     * This is universal function for obtaining any MIME data via stream.
     *
     * @param MailAccount $oAccount Account object.
     * @param mixed $mCallback This callback accepts the following parameters: $rMessageMimeIndexStream, $sContentType, $sFileName, $sMimeIndex.
     * @param string $sFolderName Folder the message resides in.
     * @param int $iUid UID of the message we're working with.
     * @param string $sMimeIndex = ''. Mime index of message part.
     *
     * @return bool
     *
     * @throws \MailSo\Base\Exceptions\InvalidArgumentException
     * @throws \MailSo\Net\Exceptions\Exception
     * @throws \MailSo\Imap\Exceptions\Exception
     */
    public function directMessageToStream($oAccount, $mCallback, $sFolderName, $iUid, $sMimeIndex = '')
    {
        if (!is_callable($mCallback)) {
            throw new \MailSo\Base\Exceptions\InvalidArgumentException();
        }

        $oImapClient = &$this->_getImapClient($oAccount);

        $oImapClient->FolderExamine($sFolderName);

        $sFileName = '';
        $sContentType = '';
        $sMailEncodingName = '';

        $sMimeIndex = trim($sMimeIndex);
        $aFetchResponse = $oImapClient->Fetch(array(
            0 === strlen($sMimeIndex)
                ? \MailSo\Imap\Enumerations\FetchType::BODY_HEADER_PEEK
                : \MailSo\Imap\Enumerations\FetchType::BODY_PEEK . '[' . $sMimeIndex . '.MIME]'
        ), $iUid, true);

        if (0 < count($aFetchResponse)) {
            $sMime = $aFetchResponse[0]->GetFetchValue(
                0 === strlen($sMimeIndex)
                    ? \MailSo\Imap\Enumerations\FetchType::BODY_HEADER
                    : \MailSo\Imap\Enumerations\FetchType::BODY . '[' . $sMimeIndex . '.MIME]'
            );

            if (!empty($sMime)) {
                $oHeaders = \MailSo\Mime\HeaderCollection::NewInstance()->Parse($sMime);

                if (!empty($sMimeIndex)) {
                    $sFileName = $oHeaders->ParameterValue(
                        \MailSo\Mime\Enumerations\Header::CONTENT_DISPOSITION,
                        \MailSo\Mime\Enumerations\Parameter::FILENAME
                    );

                    if (empty($sFileName)) {
                        $sFileName = $oHeaders->ParameterValue(
                            \MailSo\Mime\Enumerations\Header::CONTENT_TYPE,
                            \MailSo\Mime\Enumerations\Parameter::NAME
                        );
                    }

                    $sMailEncodingName = $oHeaders->ValueByName(
                        \MailSo\Mime\Enumerations\Header::CONTENT_TRANSFER_ENCODING
                    );

                    $sContentType = $oHeaders->ValueByName(
                        \MailSo\Mime\Enumerations\Header::CONTENT_TYPE
                    );
                } else {
                    $sSubject = trim($oHeaders->ValueByName(\MailSo\Mime\Enumerations\Header::SUBJECT));
                    $sFileName = (empty($sSubject) ? 'message-' . $iUid : trim($sSubject)) . '.eml';
                    $sFileName = '.eml' === $sFileName ? 'message.eml' : $sFileName;
                    $sContentType = 'message/rfc822';
                }
            }
        }

        $aFetchResponse = $oImapClient->Fetch(array(
            array(\MailSo\Imap\Enumerations\FetchType::BODY_PEEK . '[' . $sMimeIndex . ']',
                function ($sParent, $sLiteralAtomUpperCase, $rImapLiteralStream) use ($mCallback, $sMimeIndex, $sMailEncodingName, $sContentType, $sFileName) {
                    if (!empty($sLiteralAtomUpperCase)) {
                        if (is_resource($rImapLiteralStream) && 'FETCH' === $sParent) {
                            $rMessageMimeIndexStream = (empty($sMailEncodingName))
                                ? $rImapLiteralStream
                                : \MailSo\Base\StreamWrappers\Binary::CreateStream(
                                    $rImapLiteralStream,
                                    \MailSo\Base\StreamWrappers\Binary::GetInlineDecodeOrEncodeFunctionName(
                                        $sMailEncodingName,
                                        true
                                    )
                                );

                            call_user_func($mCallback, $rMessageMimeIndexStream, $sContentType, $sFileName, $sMimeIndex);
                        }
                    }
                }
            )), $iUid, true);

        return ($aFetchResponse && 1 === count($aFetchResponse));
    }

    /**
     * Escapes quotes in search string.
     *
     * @param string $sSearch Search string for escaping.
     * @param bool $bDetectGmail = true. If **true** function will use gmail mode for escaping.
     *
     * @return string
     */
    private function _escapeSearchString($oImapClient, $sSearch, $bDetectGmail = true)
    {
        return ($bDetectGmail && 'ssl://imap.gmail.com' === strtolower($oImapClient->GetConnectedHost())) // gmail
            ? '{' . strlen($sSearch) . '+}' . "\r\n" . $sSearch
            : $oImapClient->EscapeString($sSearch);
    }

    /**
     * Converts date from search string to Unix timestamp.
     *
     * @param string $sDate Date in string format.
     * @param int $iTimeZoneOffset Time zone in which the date string should be parsed.
     *
     * @return int
     */
    private function _convertSearchDateToTimestamp($sDate, $iTimeZoneOffset)
    {
        $iResult = 0;

        if (0 < strlen($sDate)) {
            $oDateTime = \DateTime::createFromFormat('Y.m.d', $sDate, \MailSo\Base\DateTimeHelper::GetUtcTimeZoneObject());
            $iResult = $oDateTime ? $oDateTime->getTimestamp() - $iTimeZoneOffset : 0;
        }

        return $iResult;
    }

    /**
     * Parses search string to it's parts.
     *
     * @param string $sSearch Search string.
     *
     * @return array
     */
    private function _parseSearchString($sSearch)
    {
        $aResult = array(
            'OTHER' => ''
        );

        $aCache = array();

        $sSearch = \trim(\preg_replace('/[\s]+/', ' ', $sSearch));
        $sSearch = \trim(\preg_replace('/(e?mail|from|to|subject|has|date|text|body): /i', '\\1:', $sSearch));

        $mMatch = array();
        \preg_match_all('/".*?(?<!\\\)"/', $sSearch, $mMatch);
        if (\is_array($mMatch) && isset($mMatch[0]) && \is_array($mMatch[0]) && 0 < \count($mMatch[0])) {
            foreach ($mMatch[0] as $sItem) {
                do {
                    $sKey = \md5(\mt_rand(10000, 90000) . \microtime(true));
                } while (isset($aCache[$sKey]));

                $aCache[$sKey] = \stripcslashes($sItem);
                $sSearch = \str_replace($sItem, $sKey, $sSearch);
            }
        }

        \preg_match_all('/\'.*?(?<!\\\)\'/', $sSearch, $mMatch);
        if (\is_array($mMatch) && isset($mMatch[0]) && \is_array($mMatch[0]) && 0 < \count($mMatch[0])) {
            foreach ($mMatch[0] as $sItem) {
                do {
                    $sKey = \md5(\mt_rand(10000, 90000) . \microtime(true));
                } while (isset($aCache[$sKey]));

                $aCache[$sKey] = \stripcslashes($sItem);
                $sSearch = \str_replace($sItem, $sKey, $sSearch);
            }
        }

        $mMatch = array();
        \preg_match_all('/(e?mail|from|to|subject|has|date|text|body):([^\s]*)/i', $sSearch, $mMatch);
        if (\is_array($mMatch) && isset($mMatch[1]) && \is_array($mMatch[1]) && 0 < \count($mMatch[1])) {
            if (\is_array($mMatch[0])) {
                foreach ($mMatch[0] as $sToken) {
                    $sSearch = \str_replace($sToken, '', $sSearch);
                }

                $sSearch = \trim(\preg_replace('/[\s]+/', ' ', $sSearch));
            }

            foreach ($mMatch[1] as $iIndex => $sName) {
                if (isset($mMatch[2][$iIndex]) && 0 < \strlen($mMatch[2][$iIndex])) {
                    $sName = \strtoupper($sName);
                    $sValue = $mMatch[2][$iIndex];
                    switch ($sName) {
                        case 'TEXT':
                        case 'BODY':
                        case 'EMAIL':
                        case 'MAIL':
                        case 'FROM':
                        case 'TO':
                        case 'SUBJECT':
                        case 'HAS':
                        case 'DATE':
                            if ('MAIL' === $sName) {
                                $sName = 'EMAIL';
                            }
                            $aResult[$sName] = $sValue;
                            break;
                    }
                }
            }
        }

        $aResult['OTHER'] = $sSearch;
        foreach ($aResult as $sName => $sValue) {
            if (isset($aCache[$sValue])) {
                $aResult[$sName] = trim($aCache[$sValue], '"\' ');
            }
        }

        return $aResult;
    }

    protected function getIdnEmailValue($value)
    {
        $parts = explode('@', $value);
        if (isset($parts[1])) {
            $value = $parts[0] . '@' . idn_to_ascii($parts[1]);
        } elseif (isset($parts[0])) {
            $value = idn_to_ascii($parts[0]);
        }

        return $value;
    }

    /**
     * Prepares search string for searching on IMAP.
     *
     * @param Object $oImapClient ImapClient object.
     * @param string $sSearch Search string.
     * @param int $iTimeZoneOffset = 0. Time zone in which the date string should be parsed.
     * @param array $aFilters = array(). Shows what filters must be considered when searching.
     *
     * @return string
     */
    private function _prepareImapSearchString($oImapClient, $sSearch, $iTimeZoneOffset = 0, $aFilters = array())
    {
        $aImapSearchResult = array();
        $sSearch = trim($sSearch);

        if (0 === strlen($sSearch) && 0 === count($aFilters)) {
            return 'ALL';
        }

        $bFilterFlagged = false;
        $bFilterUnseen = false;

        $bIsGmail = $oImapClient->IsSupported('X-GM-EXT-1');
        $sGmailRawSearch = '';
        $sRawValue = '';

        if (0 < strlen($sSearch)) {
            $aLines = $this->_parseSearchString($sSearch);

            if (1 === count($aLines) && isset($aLines['OTHER'])) {
                if (true) { // TODO
                    $sIdnValue = $this->getIdnEmailValue($aLines['OTHER']);
                    $sIdnValue = $this->_escapeSearchString($oImapClient, $sIdnValue);

                    $sValue = $this->_escapeSearchString($oImapClient, $aLines['OTHER']);

                    $aImapSearchResult[] = 'OR OR OR';
                    $aImapSearchResult[] = 'FROM ' . $sIdnValue;
                    $aImapSearchResult[] = 'TO ' . $sIdnValue;
                    $aImapSearchResult[] = 'CC ' . $sIdnValue;
                    $aImapSearchResult[] = 'SUBJECT ' . $sValue;
                } else {
                    if ($bIsGmail) {
                        $sGmailRawSearch .= ' ' . $aLines['OTHER'];
                    } else {
                        $aImapSearchResult[] = 'TEXT ' . $this->_escapeSearchString($oImapClient, $aLines['OTHER']);
                    }
                }
            } else {
                if (2 === count($aLines) && isset($aLines['OTHER']) && (isset($aLines['TO']) || isset($aLines['FROM']))) {
                    $aLines['SUBJECT'] = $aLines['OTHER'];
                    unset($aLines['OTHER']);
                }

                if (isset($aLines['EMAIL'])) {
                    $aEmails = explode(',', $aLines['EMAIL']);

                    foreach ($aEmails as $iKey => $sEmail) { //or - at least one match in message
                        if (strlen(trim($sEmail)) > 0) {
                            $aImapSearchResult[] = ($iKey === 0 ? 'OR OR OR' : 'OR OR OR OR');
                        }
                    }

                    foreach ($aEmails as $sEmail) {
                        $sEmail = trim($sEmail);
                        if (0 < strlen($sEmail)) {
                            $sValue = $this->getIdnEmailValue($sEmail);

                            $sValue = $this->_escapeSearchString($oImapClient, $sValue);

                            $aImapSearchResult[] = 'FROM ' . $sValue;
                            $aImapSearchResult[] = 'TO ' . $sValue;
                            $aImapSearchResult[] = 'CC ' . $sValue;
                            $aImapSearchResult[] = 'BCC ' . $sValue;
                        }
                    }

                    unset($aLines['EMAIL']);
                }

                if (isset($aLines['TO'])) {
                    $aValues = explode(',', $aLines['TO']);

                    $aImapSearchResult[] = 'OR';
                    if (count($aValues) > 1) {
                        $aImapSearchResult[] = trim(str_repeat('OR ', (count($aValues) - 1) * 2));
                    }
                    foreach ($aValues as $sValue) {
                        $sValue = $this->getIdnEmailValue($sValue);
                        $sValue = $this->_escapeSearchString($oImapClient, $sValue);
                        $aImapSearchResult[] = 'TO ' . $sValue;
                        $aImapSearchResult[] = 'CC ' . $sValue;
                    }
                    unset($aLines['TO']);
                }

                $sMainText = '';
                foreach ($aLines as $sName => $sRawValue) {
                    if ('' === \trim($sRawValue)) {
                        continue;
                    }

                    $sValue = $this->_escapeSearchString($oImapClient, $sRawValue);
                    switch ($sName) {
                        case 'FROM':
                            $aValues = explode(',', $sRawValue);
                            if (count($aValues) > 1) {
                                $aImapSearchResult[] = trim(str_repeat('OR ', count($aValues) - 1));
                            }
                            foreach ($aValues as $sValue) {
                                $sValue = $this->getIdnEmailValue($sValue);
                                $sValue = $this->_escapeSearchString($oImapClient, $sValue);
                                $aImapSearchResult[] = 'FROM ' . $sValue;
                            }
                            break;
                        case 'SUBJECT':
                            $aImapSearchResult[] = 'SUBJECT ' . $sValue;
                            break;
                        case 'OTHER':
                        case 'BODY':
                        case 'TEXT':
                            if ($bIsGmail) {
                                $sGmailRawSearch .= ' ' . $sRawValue;
                            } else {
                                $sMainText .= ' ' . $sRawValue;
                            }
                            break;
                        case 'HAS':
                            if (false !== strpos($sRawValue, 'attach')) {
                                if ($bIsGmail) {
                                    $sGmailRawSearch .= ' has:attachment';
                                } else {
                                    $aImapSearchResult[] = 'OR OR OR';
                                    $aImapSearchResult[] = 'HEADER Content-Type application/';
                                    $aImapSearchResult[] = 'HEADER Content-Type multipart/m';
                                    $aImapSearchResult[] = 'HEADER Content-Type multipart/signed';
                                    $aImapSearchResult[] = 'HEADER Content-Type multipart/report';
                                }
                            }
                            if (false !== strpos($sRawValue, 'flag')) {
                                $bFilterFlagged = true;
                                $aImapSearchResult[] = 'FLAGGED';
                            }
                            if (false !== strpos($sRawValue, 'unseen')) {
                                $bFilterUnseen = true;
                                $aImapSearchResult[] = 'UNSEEN';
                            }
                            break;
                        case 'DATE':
                            $iDateStampFrom = $iDateStampTo = 0;

                            $sDate = $sRawValue;
                            $aDate = explode('/', $sDate);

                            if (is_array($aDate) && 2 === count($aDate)) {
                                if (0 < strlen($aDate[0])) {
                                    $iDateStampFrom = $this->_convertSearchDateToTimestamp($aDate[0], $iTimeZoneOffset);
                                }

                                if (0 < strlen($aDate[1])) {
                                    $iDateStampTo = $this->_convertSearchDateToTimestamp($aDate[1], $iTimeZoneOffset);
                                    $iDateStampTo += 60 * 60 * 24;
                                }
                            } else {
                                if (0 < strlen($sDate)) {
                                    $iDateStampFrom = $this->_convertSearchDateToTimestamp($sDate, $iTimeZoneOffset);
                                    $iDateStampTo = $iDateStampFrom + 60 * 60 * 24;
                                }
                            }

                            if (0 < $iDateStampFrom) {
                                $aImapSearchResult[] = 'SINCE ' . gmdate('j-M-Y', $iDateStampFrom);
                            }

                            if (0 < $iDateStampTo) {
                                $aImapSearchResult[] = 'BEFORE ' . gmdate('j-M-Y', $iDateStampTo);
                            }
                            break;
                    }
                }

                if ('' !== trim($sMainText)) {
                    $sMainText = trim(trim(preg_replace('/[\s]+/', ' ', $sMainText)), '"\'');
                    if ($bIsGmail) {
                        $sGmailRawSearch .= ' ' . $sRawValue;
                    } else {
                        $aImapSearchResult[] = 'BODY ' . $this->_escapeSearchString($oImapClient, $sMainText);
                    }
                }
            }
        }

        if (0 < count($aFilters)) {
            foreach ($aFilters as $sFilter) {
                if ('flagged' === $sFilter && !$bFilterFlagged) {
                    $aImapSearchResult[] = 'FLAGGED';
                } elseif ('unseen' === $sFilter && !$bFilterUnseen) {
                    $aImapSearchResult[] = 'UNSEEN';
                }
            }
        }

        $sGmailRawSearch = \trim($sGmailRawSearch);
        if ($bIsGmail && 0 < \strlen($sGmailRawSearch)) {
            $aImapSearchResult[] = 'X-GM-RAW ' . $this->_escapeSearchString($oImapClient, $sGmailRawSearch, false);
        }

        $sImapSearchResult = \trim(\implode(' ', $aImapSearchResult));
        if ('' === $sImapSearchResult) {
            $sImapSearchResult = 'ALL';
        }

        return $sImapSearchResult;
    }

    /**
     * Reverses recursively thread uids and returns simple array.
     *
     * @param array $aThreadUids Hierarchical structure containing thread uids.
     *
     * @return array
     */
    private function _reverseThreadUids($aThreadUids)
    {
        $aThreadUids = array_reverse($aThreadUids);
        foreach ($aThreadUids as &$mItem) {
            if (is_array($mItem)) {
                $mItem = $this->_reverseThreadUids($mItem);
            }
        }
        return $aThreadUids;
    }

    /**
     * Maps recursively thread list.
     *
     * @param array $aThreads Thread list.
     *
     * @return array
     */
    private function _mapThreadList($aThreads)
    {
        $aNew = array();
        foreach ($aThreads as $mItem) {
            if (!is_array($mItem)) {
                $aNew[] = $mItem;
            } else {
                $mMap = $this->_mapThreadList($mItem);
                if (is_array($mMap) && 0 < count($mMap)) {
                    $aNew = array_merge($aNew, $mMap);
                }
            }
        }

        sort($aNew, SORT_NUMERIC);
        return $aNew;
    }

    /**
     * Compares items for sorting.
     *
     * @param mixed $a First item to compare.
     * @param mixed $b Second item to compare.
     * @param array $aSortUidsFlipped Array contains items to compare.
     *
     * @return int
     */
    public function _sortHelper($a, $b, $aSortUidsFlipped)
    {
        if ($a === $b) {
            return 0;
        }

        $iAIndex = $iBIndex = -1;
        if (isset($aSortUidsFlipped[$a])) {
            $iAIndex = $aSortUidsFlipped[$a];
        }

        if (isset($aSortUidsFlipped[$b])) {
            $iBIndex = $aSortUidsFlipped[$b];
        }

        if ($iAIndex === $iBIndex) {
            return 0;
        }

        return ($iAIndex < $iBIndex) ? -1 : 1;
    }

    /**
     * Sorts array by array.
     *
     * @param array $aInput
     * @param array $aSortUidsFlipped
     *
     * @return void
     */
    private function _sortArrayByArray(&$aInput, $aSortUidsFlipped)
    {
        $self = $this;

        \usort($aInput, function ($a, $b) use ($self, $aSortUidsFlipped) {
            return $self->_sortHelper($a, $b, $aSortUidsFlipped);
        });
    }

    /**
     * Sorts array key by array.
     *
     * @param array $aThreads
     * @param array $aSortUidsFlipped
     *
     * @return void
     */
    private function _sortArrayKeyByArray(&$aThreads, $aSortUidsFlipped)
    {
        $self = $this;

        \uksort($aThreads, function ($a, $b) use ($self, $aSortUidsFlipped) {
            return $self->_sortHelper($a, $b, $aSortUidsFlipped);
        });
    }

    /**
     * Breaks into chunks each thread from the list and returns the list by reference.
     *
     * @param array $aThreads Thread list obtained by reference.
     */
    private function _chunkThreadList(&$aThreads)
    {
        $iLimit = 200;
        foreach ($aThreads as $iKey => $mData) {
            if (is_array($mData) && 1 < count($mData)) {
                if ($iLimit < count($mData)) {
                    $aChunks = array_chunk($mData, $iLimit);
                    foreach ($aChunks as $iIndex => $aPart) {
                        if (0 === $iIndex) {
                            $aThreads[$iKey] = $aPart;
                        } else {
                            $iFirst = array_shift($aPart);
                            if (0 < count($aPart)) {
                                $aThreads[$iFirst] = $aPart;
                            } else {
                                $aThreads[$iFirst] = $iFirst;
                            }
                        }
                    }
                }
            }
        }
    }

    /**
     * Resorts thread list.
     *
     * @param array $aThreads Thread list.
     * @param array $aSortUids Sort Uids.
     *
     * @return array
     */
    private function _resortThreadList($aThreads, $aSortUids)
    {
        $aSortUidsFlipped = array_flip($aSortUids);

        foreach ($aThreads as $iKey => $mData) {
            if (is_array($mData) && 1 < count($mData)) {
                $this->_sortArrayByArray($mData, $aSortUidsFlipped);
                $aThreads[$iKey] = $mData;
            }
        }

        $this->_chunkThreadList($aThreads);

        $this->_sortArrayKeyByArray($aThreads, $aSortUidsFlipped);

        return $aThreads;
    }

    /**
     * Compiles thread list.
     *
     * @param array $aThreads Thread list.
     *
     * @return array
     */
    private function _compileThreadList($aThreads)
    {
        $aThreads = $this->_reverseThreadUids($aThreads);

        $aResult = array();
        foreach ($aThreads as $mItem) {
            if (is_array($mItem)) {
                $aMap = $this->_mapThreadList($mItem);
                if (is_array($aMap)) {
                    if (1 < count($aMap)) {
                        $iMax = array_pop($aMap);
                        rsort($aMap, SORT_NUMERIC);
                        $aResult[(int) $iMax] = $aMap;
                    } elseif (0 < count($aMap)) {
                        $aResult[(int) $aMap[0]] = $aMap[0];
                    }
                }
            } else {
                $aResult[(int) $mItem] = $mItem;
            }
        }

        krsort($aResult, SORT_NUMERIC);
        return $aResult;
    }

    /**
     * Fetches some messages data and returns it in callback.
     *
     * @param Object $oImapClient ImapClient object.
     * @param string $sIndexRange
     * @param callable $fItemCallback callback wich is used for data returning.
     * @param bool $bRangeAsUids = false.
     *
     * @return array
     *
     * @throws \Aurora\System\Exceptions\InvalidArgumentException
     */
    private function _doSpecialSubRequest($oImapClient, $sIndexRange, $fItemCallback, $bRangeAsUids = false)
    {
        $aResult = array();

        $aFetchResponse = $oImapClient->Fetch(array(
            \MailSo\Imap\Enumerations\FetchType::INDEX,
            \MailSo\Imap\Enumerations\FetchType::UID,
            \MailSo\Imap\Enumerations\FetchType::RFC822_SIZE,
            \MailSo\Imap\Enumerations\FetchType::INTERNALDATE,
            \MailSo\Imap\Enumerations\FetchType::FLAGS,
            \MailSo\Imap\Enumerations\FetchType::BODYSTRUCTURE
        ), $sIndexRange, $bRangeAsUids);

        if (is_array($aFetchResponse) && 0 < count($aFetchResponse)) {
            $oFetchResponseItem = null;
            foreach ($aFetchResponse as /* @var $oFetchResponseItem \MailSo\Imap\FetchResponse */ &$oFetchResponseItem) {
                $sUid = $oFetchResponseItem->GetFetchValue(\MailSo\Imap\Enumerations\FetchType::UID);
                $sSize = $oFetchResponseItem->GetFetchValue(\MailSo\Imap\Enumerations\FetchType::RFC822_SIZE);
                $sInternalDate = $oFetchResponseItem->GetFetchValue(\MailSo\Imap\Enumerations\FetchType::INTERNALDATE);
                $aFlags = $oFetchResponseItem->GetFetchValue(\MailSo\Imap\Enumerations\FetchType::FLAGS);
                $aFlagsLower = array_map('strtolower', $aFlags);

                $oBodyStructure = $oFetchResponseItem->GetFetchBodyStructure();

                if ($oBodyStructure) {
                    if (call_user_func_array($fItemCallback, array(
                        $oBodyStructure, $sSize, $sInternalDate, $aFlagsLower, $sUid
                    ))) {
                        $aResult[] = $sUid;
                    }
                }

                unset($oBodyStructure);
                unset($oFetchResponseItem);
            }
        }

        return $aResult;
    }

    /**
     * Searches messages and messages data.
     *
     * @param Object $oImapClient
     * @param callable $fItemCallback
     * @param string $sFolderFullNameRaw
     *
     * @return array
     *
     * @throws \Aurora\System\Exceptions\InvalidArgumentException
     */
    private function _doSpecialIndexSearch($oImapClient, $fItemCallback, $sFolderFullNameRaw)
    {
        if (0 === strlen($sFolderFullNameRaw) ||
            !is_callable($fItemCallback)) {
            throw new \Aurora\System\Exceptions\InvalidArgumentException();
        }

        $oImapClient->FolderExamine($sFolderFullNameRaw);

        $aResult = array();

        $aList = $this->_getFolderInformation($oImapClient, $sFolderFullNameRaw);
        $iCount = $aList[0];

        if (0 < $iCount) {
            $iInc = 0;
            $iTopLimit = 100;

            $aIndexes = range(1, $iCount);
            $aRequestIndexes = array();

            foreach ($aIndexes as $iIndex) {
                $iInc++;
                $aRequestIndexes[] = $iIndex;

                if ($iInc > $iTopLimit) {
                    $aSubResult = $this->_doSpecialSubRequest(
                        $oImapClient,
                        implode(',', $aRequestIndexes),
                        $fItemCallback,
                        false
                    );

                    $aResult = array_merge($aResult, $aSubResult);

                    $aRequestIndexes = array();
                    $iInc = 0;
                }
            }

            if (0 < count($aRequestIndexes)) {
                $aSubResult = $this->_doSpecialSubRequest(
                    $oImapClient,
                    implode(',', $aRequestIndexes),
                    $fItemCallback,
                    false
                );

                $aResult = array_merge($aResult, $aSubResult);
            }

            rsort($aResult, SORT_NUMERIC);
        }

        return is_array($aResult) ? $aResult : array();
    }

    /**
     * Searches messages uids for message list.
     *
     * @param Object $oImapClient
     * @param callable $fItemCallback
     * @param string $sFolderFullNameRaw
     * @param array $aUids
     *
     * @return array
     *
     * @throws \Aurora\System\Exceptions\InvalidArgumentException
     */
    private function _doSpecialUidsSearch($oImapClient, $fItemCallback, $sFolderFullNameRaw, $aUids)
    {
        if (0 === strlen($sFolderFullNameRaw) || !is_callable($fItemCallback) ||
            !is_array($aUids) || 0 === count($aUids)) {
            throw new \Aurora\System\Exceptions\InvalidArgumentException();
        }

        $oImapClient->FolderExamine($sFolderFullNameRaw);

        $aResult = array();

        $iInc = 0;
        $iTopLimit = 100;

        $aRequestUids = array();
        foreach ($aUids as $iUid) {
            $iInc++;
            $aRequestUids[] = $iUid;

            if ($iInc > $iTopLimit) {
                $aSubResult = $this->_doSpecialSubRequest(
                    $oImapClient,
                    implode(',', $aRequestUids),
                    $fItemCallback,
                    true
                );

                $aResult = array_merge($aResult, $aSubResult);

                $aRequestUids = array();
                $iInc = 0;
            }
        }

        if (0 < count($aRequestUids)) {
            $aSubResult = $this->_doSpecialSubRequest(
                $oImapClient,
                implode(',', $aRequestUids),
                $fItemCallback,
                true
            );

            $aResult = array_merge($aResult, $aSubResult);
        }

        rsort($aResult, SORT_NUMERIC);
        return $aResult;
    }

    /**
     * @param MailAccount $oAccount Account object.
     * @param string $sFolderName
     * @param int $iIndex
     * @param bool $bIndexIsUid = true

     *
     * @return \MailSo\Mail\Message|false
     *
     * @throws \MailSo\Base\Exceptions\InvalidArgumentException
     * @throws \MailSo\Net\Exceptions\Exception
     * @throws \MailSo\Imap\Exceptions\Exception
     */
    public function getMessage($oAccount, $sFolderName, $iIndex, $bIndexIsUid = true)
    {
        $iBodyTextLimit = null;
        $oImapClient = &$this->_getImapClient($oAccount);

        $oImapClient->FolderExamine($sFolderName);

        $oBodyStructure = null;
        $oMessage = false;

        $aBodyPeekMimeIndexes = array();
        $aSignatureMimeIndexes = array();

        $aFetchResponse = $oImapClient->Fetch(array(\MailSo\Imap\Enumerations\FetchType::BODYSTRUCTURE), $iIndex, $bIndexIsUid);
        if (0 < \count($aFetchResponse) && isset($aFetchResponse[0])) {
            $oBodyStructure = $aFetchResponse[0]->GetFetchBodyStructure();
            if ($oBodyStructure) {
                $aTextParts = $oBodyStructure->SearchHtmlOrPlainParts();
                if (is_array($aTextParts) && 0 < \count($aTextParts)) {
                    foreach ($aTextParts as $oPart) {
                        $aBodyPeekMimeIndexes[] = array($oPart->PartID(), $oPart->Size());
                    }
                }

                $aSignatureParts = $oBodyStructure->SearchByContentType('application/pgp-signature');
                if (is_array($aSignatureParts) && 0 < \count($aSignatureParts)) {
                    foreach ($aSignatureParts as $oPart) {
                        $aSignatureMimeIndexes[] = $oPart->PartID();
                    }
                }
            }
        }

        $aFetchItems = array(
            \MailSo\Imap\Enumerations\FetchType::INDEX,
            \MailSo\Imap\Enumerations\FetchType::UID,
            \MailSo\Imap\Enumerations\FetchType::RFC822_SIZE,
            \MailSo\Imap\Enumerations\FetchType::INTERNALDATE,
            \MailSo\Imap\Enumerations\FetchType::FLAGS,
            \MailSo\Imap\Enumerations\FetchType::BODY_HEADER_PEEK
        );

        if (0 < \count($aBodyPeekMimeIndexes)) {
            foreach ($aBodyPeekMimeIndexes as $aTextMimeData) {
                $sLine = \MailSo\Imap\Enumerations\FetchType::BODY_PEEK . '[' . $aTextMimeData[0] . ']';
                if (\is_numeric($iBodyTextLimit) && 0 < $iBodyTextLimit && $iBodyTextLimit < $aTextMimeData[1]) {
                    $sLine .= '<0.' . ((int) $iBodyTextLimit) . '>';
                }

                $aFetchItems[] = $sLine;
            }
        }

        if (0 < \count($aSignatureMimeIndexes)) {
            foreach ($aSignatureMimeIndexes as $sTextMimeIndex) {
                $aFetchItems[] = \MailSo\Imap\Enumerations\FetchType::BODY_PEEK . '[' . $sTextMimeIndex . ']';
            }
        }

        if (!$oBodyStructure) {
            $aFetchItems[] = \MailSo\Imap\Enumerations\FetchType::BODYSTRUCTURE;
        }

        $aFetchResponse = $oImapClient->Fetch($aFetchItems, $iIndex, $bIndexIsUid);
        if (0 < \count($aFetchResponse)) {
            $oMessage = \MailSo\Mail\Message::NewFetchResponseInstance(
                $sFolderName,
                $aFetchResponse[0],
                $oBodyStructure
            );
        }

        return $oMessage;
    }

    /**
     * Obtains message list with messages data.
     *
     * @param \Aurora\Modules\Mail\Models\MailAccount $oAccount Account object.
     * @param string $sFolderFullNameRaw Raw full name of the folder.
     * @param int $iOffset = 0. Offset value for obtaining a partial list.
     * @param int $iLimit = 20. Limit value for obtaining a partial list.
     * @param string $sSearch = ''. Search text.
     * @param bool $bUseThreading = false. If **true**, message list will be returned in threaded mode.
     * @param array $aFilters = array(). Contains filters for searching of messages.
     * @param string $sInboxUidnext = ''. Uidnext value of Inbox folder.
     *
     * @return \Aurora\Modules\Mail\Classes\MessageCollection
     *
     * @throws \Aurora\System\Exceptions\InvalidArgumentException
     */
    public function getMessageList(
        $oAccount,
        $sFolderFullNameRaw,
        $iOffset = 0,
        $iLimit = 20,
        $sSearch = '',
        $bUseThreading = false,
        $aFilters = array(),
        $sInboxUidnext = '',
        $sSortBy = 'ARRIVAL',
        $sSortOrder = 'REVERSE'
    ) {
        if (0 === strlen($sFolderFullNameRaw) || 0 > $iOffset || 0 >= $iLimit || 999 < $iLimit) {
            throw new \Aurora\System\Exceptions\InvalidArgumentException();
        }

        $oMessageCollection = false;

        $oSettings = &\Aurora\System\Api::GetSettings();
        $oImapClient = &$this->_getImapClient($oAccount, 20, 60 * 2);

        $oImapClient->FolderExamine($sFolderFullNameRaw);

        $aList = $this->_getFolderInformation($oImapClient, $sFolderFullNameRaw);

        $iMessageCount = $aList[0];
        $iRealMessageCount = $aList[0];
        $iMessageUnseenCount = $aList[1];
        $sUidNext = $aList[2];

        $oMessageCollection = \Aurora\Modules\Mail\Classes\MessageCollection::createInstance();

        $oMessageCollection->FolderName = $sFolderFullNameRaw;
        $oMessageCollection->Offset = $iOffset;
        $oMessageCollection->Limit = $iLimit;
        $oMessageCollection->Search = $sSearch;
        $oMessageCollection->UidNext = $sUidNext;
        $oMessageCollection->Filters = implode(',', $aFilters);
        $oMessageCollection->FolderHash = $aList[3];

        $aThreads = array();
        $oServer = $oAccount->getServer();
        $bUseThreadingIfSupported = $oServer->EnableThreading && $oAccount->UseThreading;
        if ($bUseThreadingIfSupported) {
            $bUseThreadingIfSupported = $bUseThreading;
        }

        $bSearch = false;
        if (0 < $iRealMessageCount) {
            $bIndexAsUid = false;
            $aIndexOrUids = array();

            $bUseSortIfSupported = false;
            $aMessagesSortBy = $this->oModule->oModuleSettings->MessagesSortBy;
            if ($aMessagesSortBy !== false && is_array($aMessagesSortBy) && isset($aMessagesSortBy['Allow']) && (bool) $aMessagesSortBy['Allow'] !== false && !empty($sSortBy)) {
                $bUseSortIfSupported = $oImapClient->IsSupported('SORT');
            }

            if ($bUseThreadingIfSupported) {
                $bUseThreadingIfSupported = $oImapClient->IsSupported('THREAD=REFS') || $oImapClient->IsSupported('THREAD=REFERENCES') || $oImapClient->IsSupported('THREAD=ORDEREDSUBJECT');
            }

            if (0 < strlen($sSearch) || 0 < count($aFilters)) {
                $sCutedSearch = $sSearch;

                $sCutedSearch = \preg_replace('/[\s]+/', ' ', $sCutedSearch);
                $sCutedSearch = \preg_replace('/attach[ ]?:[ ]?/i', 'attach:', $sCutedSearch);

                $bSearchAttachments = false;
                $fAttachmentSearchCallback = null;
                $aMatch = array();

                $bUseBodyStructuresForHasAttachmentsSearch = $this->oModule->oModuleSettings->UseBodyStructuresForHasAttachmentsSearch;
                if (($bUseBodyStructuresForHasAttachmentsSearch && \preg_match('/has[ ]?:[ ]?attachments/i', $sSearch)) ||
                    \preg_match('/attach:([^\s]+)/i', $sSearch, $aMatch)) {
                    $bSearchAttachments = true;
                    $sAttachmentName = isset($aMatch[1]) ? trim($aMatch[1]) : '';
                    $sAttachmentRegs = !empty($sAttachmentName) && '*' !== $sAttachmentName ?
                        '/[^>]*' . str_replace('\\*', '[^>]*', preg_quote(trim($sAttachmentName, '*'), '/')) . '[^>]*/ui' : '';

                    if ($bUseBodyStructuresForHasAttachmentsSearch) {
                        $sCutedSearch = trim(preg_replace('/has[ ]?:[ ]?attachments/i', '', $sCutedSearch));
                    }

                    $sCutedSearch = trim(preg_replace('/attach:([^\s]+)/', '', $sCutedSearch));

                    $fAttachmentSearchCallback = function ($oBodyStructure, $sSize, $sInternalDate, $aFlagsLower, $sUid) use ($sFolderFullNameRaw, $sAttachmentRegs) {
                        $bResult = false;
                        if ($oBodyStructure) {
                            $aAttachmentsParts = $oBodyStructure->SearchAttachmentsParts();
                            if ($aAttachmentsParts && 0 < count($aAttachmentsParts)) {
                                $oAttachments = \Aurora\Modules\Mail\Classes\AttachmentCollection::createInstance();
                                foreach ($aAttachmentsParts as /* @var $oAttachmentItem \MailSo\Imap\BodyStructure */ $oAttachmentItem) {
                                    $oAttachments->Add(
                                        \Aurora\Modules\Mail\Classes\Attachment::createInstance($sFolderFullNameRaw, $sUid, $oAttachmentItem)
                                    );
                                }

                                $bResult = $oAttachments->hasNotInlineAttachments();
                                if ($bResult && !empty($sAttachmentRegs)) {
                                    $aList = $oAttachments->FilterList(function ($oAttachment) use ($sAttachmentRegs) {
                                        if ($oAttachment && !$oAttachment->isInline() && !$oAttachment->getCid()) {
                                            return !!preg_match($sAttachmentRegs, $oAttachment->getFileName());
                                        }

                                        return false;
                                    });

                                    return is_array($aList) ? 0 < count($aList) : false;
                                }
                            }
                        }

                        unset($oBodyStructure);

                        return $bResult;
                    };
                }

                if (0 < strlen($sCutedSearch) || 0 < count($aFilters)) {
                    $bSearch = true;
                    $sSearchCriterias = $this->_prepareImapSearchString(
                        $oImapClient,
                        $sCutedSearch,
                        $oAccount->getDefaultTimeOffset() * 60,
                        $aFilters
                    );

                    $bIndexAsUid = true;
                    $aIndexOrUids = null;

                    if ($bUseSortIfSupported) {
                        $aIndexOrUids = $oImapClient->MessageSimpleSort(array($sSortOrder . ' ' . $sSortBy), $sSearchCriterias, $bIndexAsUid);
                    } else {
                        if (!\MailSo\Base\Utils::IsAscii($sCutedSearch)) {
                            try {
                                $aIndexOrUids = $oImapClient->MessageSimpleSearch($sSearchCriterias, $bIndexAsUid, 'UTF-8');
                            } catch (\MailSo\Imap\Exceptions\NegativeResponseException $oException) {
                                // Charset is not supported. Skip and try request without charset.
                                $aIndexOrUids = null;
                            }
                        }

                        if (null === $aIndexOrUids) {
                            $aIndexOrUids = $oImapClient->MessageSimpleSearch($sSearchCriterias, $bIndexAsUid);
                        }
                    }

                    if ($bSearchAttachments && is_array($aIndexOrUids) && 0 < count($aIndexOrUids)) {
                        $aIndexOrUids = $this->_doSpecialUidsSearch(
                            $oImapClient,
                            $fAttachmentSearchCallback,
                            $sFolderFullNameRaw,
                            $aIndexOrUids
                        );
                    }
                } elseif ($bSearchAttachments) {
                    $bIndexAsUid = true;
                    $aIndexOrUids = $this->_doSpecialIndexSearch(
                        $oImapClient,
                        $fAttachmentSearchCallback,
                        $sFolderFullNameRaw
                    );
                }
            } else {
                if ($bUseThreadingIfSupported && 1 < $iMessageCount) {
                    $bIndexAsUid = true;
                    $aThreadUids = array();
                    try {
                        $aThreadUids = $oImapClient->MessageSimpleThread();
                    } catch (\MailSo\Imap\Exceptions\RuntimeException $oException) {
                        $aThreadUids = array();
                    }

                    $aThreads = $this->_compileThreadList($aThreadUids);
                    if ($bUseSortIfSupported) {
                        $aThreads = $this->_resortThreadList(
                            $aThreads,
                            $oImapClient->MessageSimpleSort(array($sSortOrder . ' ' . $sSortBy), 'ALL', true)
                        );
                    } else {
                        //						$this->chunkThreadArray($aThreads);
                    }

                    $aIndexOrUids = array_keys($aThreads);
                    $iMessageCount = count($aIndexOrUids);
                } elseif ($bUseSortIfSupported && 1 < $iMessageCount) {
                    $bIndexAsUid = true;
                    $aIndexOrUids = $oImapClient->MessageSimpleSort(array($sSortOrder . ' ' . $sSortBy), 'ALL', $bIndexAsUid);
                } else {
                    $bIndexAsUid = false;
                    $aIndexOrUids = array(1);
                    if (1 < $iMessageCount) {
                        $aIndexOrUids = array_reverse(range(1, $iMessageCount));
                    }
                }
            }

            if (is_array($aIndexOrUids)) {
                $oMessageCollection->MessageCount = $iRealMessageCount;
                $oMessageCollection->MessageUnseenCount = $iMessageUnseenCount;
                $oMessageCollection->MessageResultCount = 0 < strlen($sSearch) || 0 < count($aFilters)
                    ? count($aIndexOrUids) : $iMessageCount;

                if (0 < count($aIndexOrUids)) {
                    $iOffset = (0 > $iOffset) ? 0 : $iOffset;
                    $aRequestIndexOrUids = array_slice($aIndexOrUids, $iOffset, $iLimit);

                    if ($bIndexAsUid) {
                        $oMessageCollection->Uids = $aRequestIndexOrUids;
                    }

                    if (is_array($aRequestIndexOrUids) && 0 < count($aRequestIndexOrUids)) {
                        $aFetchResponse = $oImapClient->Fetch(array(
                            \MailSo\Imap\Enumerations\FetchType::INDEX,
                            \MailSo\Imap\Enumerations\FetchType::UID,
                            \MailSo\Imap\Enumerations\FetchType::RFC822_SIZE,
                            \MailSo\Imap\Enumerations\FetchType::INTERNALDATE,
                            \MailSo\Imap\Enumerations\FetchType::FLAGS,
                            \MailSo\Imap\Enumerations\FetchType::BODYSTRUCTURE,
                            \MailSo\Imap\Enumerations\FetchType::BODY_HEADER_PEEK
                        ), implode(',', $aRequestIndexOrUids), $bIndexAsUid);

                        if (is_array($aFetchResponse) && 0 < count($aFetchResponse)) {
                            $aFetchIndexArray = array();
                            $oFetchResponseItem = null;
                            foreach ($aFetchResponse as /* @var $oFetchResponseItem \MailSo\Imap\FetchResponse */ &$oFetchResponseItem) {
                                $aFetchIndexArray[($bIndexAsUid)
                                    ? $oFetchResponseItem->GetFetchValue(\MailSo\Imap\Enumerations\FetchType::UID)
                                    : $oFetchResponseItem->GetFetchValue(\MailSo\Imap\Enumerations\FetchType::INDEX)] = &$oFetchResponseItem;

                                unset($oFetchResponseItem);
                            }

                            foreach ($aRequestIndexOrUids as $iFUid) {
                                if (isset($aFetchIndexArray[$iFUid])) {
                                    $oMailMessage = \Aurora\Modules\Mail\Classes\Message::createInstance(
                                        $oMessageCollection->FolderName,
                                        $aFetchIndexArray[$iFUid]
                                    );
                                    $oMailMessage->setAccountId($oAccount->Id);

                                    if (!$bIndexAsUid) {
                                        $oMessageCollection->Uids[] = $oMailMessage->getUid();
                                    }

                                    $oMessageCollection->Add($oMailMessage);
                                    unset($oMailMessage);
                                }
                            }
                        }
                    }
                }
            }
        }

        if (!$bSearch && $bUseThreadingIfSupported && 0 < count($aThreads)) {
            $oMessageCollection->ForeachList(function (/* @var $oMessage \Aurora\Modules\Mail\Classes\Message */ $oMessage) use ($aThreads) {
                $iUid = $oMessage->getUid();
                if (isset($aThreads[$iUid]) && is_array($aThreads[$iUid])) {
                    $oMessage->setThreads($aThreads[$iUid]);
                }
            });
        }

        if (0 < strlen($sInboxUidnext) &&
            'INBOX' === $oMessageCollection->FolderName &&
            $sInboxUidnext !== $oMessageCollection->UidNext) {
            $oMessageCollection->New = $this->getNewMessagesInformation($oAccount, 'INBOX', $sInboxUidnext, $oMessageCollection->UidNext);
        }

        return $oMessageCollection;
    }

    /**
     * Obtains a list of specific messages.
     *
     * @param MailAccount $oAccount Account object.
     * @param string $sFolderFullNameRaw Raw full name of the folder.
     * @param array $aUids List of message UIDs.
     *
     * @return \Aurora\Modules\Mail\Classes\MessageCollection
     *
     * @throws \Aurora\System\Exceptions\InvalidArgumentException
     */
    public function getMessageListByUids($oAccount, $sFolderFullNameRaw, $aUids, $sInboxUidnext = '')
    {
        if (0 === strlen($sFolderFullNameRaw) /*|| !is_array($aUids) || 0 === count($aUids)*/) {
            throw new \Aurora\System\Exceptions\InvalidArgumentException();
        }

        $oMessageCollection = false;

        $oImapClient = &$this->_getImapClient($oAccount);

        $oImapClient->FolderExamine($sFolderFullNameRaw);

        $aList = $this->_getFolderInformation($oImapClient, $sFolderFullNameRaw);

        $iMessageRealCount = $aList[0];
        $iMessageUnseenCount = $aList[1];
        $sUidNext = $aList[2];

        $oMessageCollection = \Aurora\Modules\Mail\Classes\MessageCollection::createInstance();

        $oMessageCollection->FolderName = $sFolderFullNameRaw;
        $oMessageCollection->Offset = 0;
        $oMessageCollection->Limit = 0;
        $oMessageCollection->Search = '';
        $oMessageCollection->UidNext = $sUidNext;

        if (0 < $iMessageRealCount) {
            $bIndexAsUid = true;
            $aIndexOrUids = $aUids;

            if (is_array($aIndexOrUids)) {
                $oMessageCollection->MessageCount = $iMessageRealCount;
                $oMessageCollection->MessageUnseenCount = $iMessageUnseenCount;
                $oMessageCollection->MessageResultCount = $oMessageCollection->MessageCount;

                if (0 < count($aIndexOrUids)) {
                    $aRequestIndexOrUids = $aIndexOrUids;

                    if ($bIndexAsUid) {
                        $oMessageCollection->Uids = $aRequestIndexOrUids;
                    }

                    if (is_array($aRequestIndexOrUids) && 0 < count($aRequestIndexOrUids)) {
                        $aFetchResponse = $oImapClient->Fetch(array(
                            \MailSo\Imap\Enumerations\FetchType::INDEX,
                            \MailSo\Imap\Enumerations\FetchType::UID,
                            \MailSo\Imap\Enumerations\FetchType::RFC822_SIZE,
                            \MailSo\Imap\Enumerations\FetchType::INTERNALDATE,
                            \MailSo\Imap\Enumerations\FetchType::FLAGS,
                            \MailSo\Imap\Enumerations\FetchType::BODYSTRUCTURE,
                            \MailSo\Imap\Enumerations\FetchType::BODY_HEADER_PEEK
                        ), implode(',', $aRequestIndexOrUids), $bIndexAsUid);

                        if (is_array($aFetchResponse) && 0 < count($aFetchResponse)) {
                            $aFetchIndexArray = array();
                            $oFetchResponseItem = null;
                            foreach ($aFetchResponse as /* @var $oFetchResponseItem \MailSo\Imap\FetchResponse */ &$oFetchResponseItem) {
                                $aFetchIndexArray[($bIndexAsUid)
                                    ? $oFetchResponseItem->GetFetchValue(\MailSo\Imap\Enumerations\FetchType::UID)
                                    : $oFetchResponseItem->GetFetchValue(\MailSo\Imap\Enumerations\FetchType::INDEX)] = &$oFetchResponseItem;

                                unset($oFetchResponseItem);
                            }

                            foreach ($aRequestIndexOrUids as $iFUid) {
                                if (isset($aFetchIndexArray[$iFUid])) {
                                    try {
                                        $oMailMessage = \Aurora\Modules\Mail\Classes\Message::createInstance(
                                            $oMessageCollection->FolderName,
                                            $aFetchIndexArray[$iFUid]
                                        );
                                        $oMailMessage->setAccountId($oAccount->Id);

                                        if (!$bIndexAsUid) {
                                            $oMessageCollection->Uids[] = $oMailMessage->getUid();
                                        }

                                        $oMessageCollection->Add($oMailMessage);
                                        unset($oMailMessage);
                                    } catch (\Exception $oEx) {
                                        $oEx;
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }

        $oMessageCollection->FolderHash = \Aurora\Modules\Mail\Classes\Utils::GenerateFolderHash(
            $sFolderFullNameRaw,
            $oMessageCollection->MessageCount,
            $oMessageCollection->MessageUnseenCount,
            $oMessageCollection->UidNext
        );

        if (0 < strlen($sInboxUidnext) &&
            'INBOX' === $oMessageCollection->FolderName &&
            $sInboxUidnext !== $oMessageCollection->UidNext) {
            $oMessageCollection->New = $this->getNewMessagesInformation($oAccount, 'INBOX', $sInboxUidnext, $oMessageCollection->UidNext);
        }

        return $oMessageCollection;
    }

    /**
     * Obtains list of flags for one or several messages.
     *
     * @param MailAccount $oAccount Account object.
     * @param string $sFolderFullNameRaw Raw full name of the folder.
     * @param array $aUids List of message UIDs.
     *
     * @return \Aurora\Modules\Mail\Classes\MessageCollection
     *
     * @throws \Aurora\System\Exceptions\InvalidArgumentException
     */
    public function getMessagesFlags($oAccount, $sFolderFullNameRaw, $aUids)
    {
        if (0 === strlen($sFolderFullNameRaw) || !is_array($aUids) || 0 === count($aUids)) {
            throw new \Aurora\System\Exceptions\InvalidArgumentException();
        }

        $oImapClient = &$this->_getImapClient($oAccount);

        $oImapClient->FolderExamine($sFolderFullNameRaw);

        $aList = $this->_getFolderInformation($oImapClient, $sFolderFullNameRaw);

        $iMessageRealCount = $aList[0];

        $mResult = array();
        if (0 < $iMessageRealCount) {
            $aFetchResponse = $oImapClient->Fetch(array(
                \MailSo\Imap\Enumerations\FetchType::INDEX,
                \MailSo\Imap\Enumerations\FetchType::UID,
                \MailSo\Imap\Enumerations\FetchType::FLAGS
            ), implode(',', $aUids), true);

            if (is_array($aFetchResponse) && 0 < count($aFetchResponse)) {
                $oFetchResponseItem = null;
                foreach ($aFetchResponse as /* @var $oFetchResponseItem \MailSo\Imap\FetchResponse */ &$oFetchResponseItem) {
                    $sUid = $oFetchResponseItem->GetFetchValue(\MailSo\Imap\Enumerations\FetchType::UID);
                    $aFlags = $oFetchResponseItem->GetFetchValue(\MailSo\Imap\Enumerations\FetchType::FLAGS);
                    if (is_array($aFlags)) {
                        $mResult[$sUid] = array_map('strtolower', $aFlags);
                    }
                }
            }
        }

        return $mResult;
    }
}
