/*

* Copyright (c) 2007 Nokia Corporation and/or its subsidiary(-ies). 

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of "Eclipse Public License v1.0"

* which accompanies this distribution, and is available

* at the URL "http://www.eclipse.org/legal/epl-v10.html".

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description: This file defines class CIpsPlgSosBasePlugin.

*

*/

#ifndef IPSPLGSOSBASEPLUGIN_H

#define IPSPLGSOSBASEPLUGIN_H

//<cmail>

#include "CFSMailPlugin.h"

#include "MFSMailRequestObserver.h"

//</cmail>

#include <rconnmon.h>

#include "ipsplgsosbaseplugin.hrh"

#include "ipsplgcommon.h"

#include "ipsplgsingleopwatcher.h"

#include "ipsplgtimeroperation.h"

class CMsvSession;

class CIpsPlgTimerOperation;

class CIpsPlgMsgMapper;

class CImEmailMessage;

class CIpsPlgMruList;

class CIpsPlgSettingsObserver;

class CRepository;

class CIpsPlgSearch;

class CIpsPlgSmtpService;

class CIpsPlgSyncStateHandler;

class CIpsPlgEventHandler;

/**

 *  FreestyleIpsServices plugin class 

 * 

 *  @lib ipssosplugin.lib

 *  @since FSEmail 2.0

 */

NONSHARABLE_CLASS ( CIpsPlgSosBasePlugin ) :

    public CFSMailPlugin,

                             public MIpsPlgSingleOpWatcher,

                             public MFSMailRequestObserver, // a dummy observer

                             public MIpsPlgTimerOperationCallBack

    {  

public:

    /**

    * ~CIpsPlgSosBasePlugin

    * Destructor

    */

    IMPORT_C virtual ~CIpsPlgSosBasePlugin();

public: //from MIpsPlgSingleOpWatcher

    /**

    * 

    */

    void OpCompleted( 

        CIpsPlgSingleOpWatcher& aOpWatcher, 

        TInt aCompletionCode );

public: //from MFSMailRequestObserver

    /**

    * no real implementation for this. we're just a dummy observer,

    * so we can internally run our own operations, like DisconnectL

    */

    virtual void RequestResponseL( TFSProgress aEvent, TInt aRequestId );

public: // from MIpsPlgTimerOperationCallBack

    /**

    * Called when activity timer fires

    */    

    virtual void HandleTimerFiredL( const TFSMailMsgId& aMailboxId );

public: // from CFSMailPlugin

    virtual void SetMailboxName(

         const TFSMailMsgId& aMailboxId, 

         const TDesC& aMailboxName );

    virtual TFSMailBoxStatus GetMailBoxStatus( 

         const TFSMailMsgId& aMailBoxId );

    virtual TFSMailMsgId SpecifiedSendingMailbox();

    virtual void ListMailBoxesL( RArray<TFSMailMsgId>& aMailboxes);

    virtual CFSMailBox* GetMailBoxByUidL( const TFSMailMsgId& aMailBoxId);

    virtual void DeleteMailBoxByUidL(

        const TFSMailMsgId& aMailBoxId,

        MFSMailRequestObserver& aOperationObserver,

        const TInt aRequestId );

    virtual TDesC& GetBrandingIdL( const TFSMailMsgId& aMailBoxId);

    virtual void MoveMessagesL(

        const TFSMailMsgId& aMailBoxId, 

        const RArray<TFSMailMsgId>& aMessageIds, 

        const TFSMailMsgId& aSourceFolderId, 

        const TFSMailMsgId& aDestinationFolderId );     

    virtual void CopyMessagesL( 

        const TFSMailMsgId& aMailBoxId,

        const RArray<TFSMailMsgId>& aMessageIds,

        RArray<TFSMailMsgId>& aNewMessages,

        const TFSMailMsgId& aSourceFolderId,

        const TFSMailMsgId& aDestinationFolderId );

    virtual MDesCArray* GetMrusL( const TFSMailMsgId& aMailBoxId );

    virtual void SetMrusL( 

            const TFSMailMsgId& aMailBoxId, 

            MDesCArray* aNewMruList );

    virtual const TFSProgress GetLastSyncStatusL( 

        const TFSMailMsgId& aMailBoxId );

    virtual TInt CancelSyncL( const TFSMailMsgId& aMailBoxId );

    // FOLDER HANDLING

    virtual CFSMailFolder* GetFolderByUidL( 

        const TFSMailMsgId& aMailBoxId, 

        const TFSMailMsgId& aFolderId );

    virtual CFSMailFolder* CreateFolderL( 

        const TFSMailMsgId& aMailBoxId, 

        const TFSMailMsgId& aFolderId,

        const TDesC& aFolderName, 

        const TBool aSync );

    virtual void DeleteFolderByUidL(

        const TFSMailMsgId& aMailBoxId, 

        const TFSMailMsgId& aFolderId);

    // MESSAGE FETCH AND STORE

    virtual MFSMailIterator* ListMessagesL(

        const TFSMailMsgId& aMailBoxId,

        const TFSMailMsgId& aFolderId,

        const TFSMailDetails aDetails,

        const RArray<TFSMailSortCriteria>& aSorting );

    virtual CFSMailMessage* GetMessageByUidL( 

        const TFSMailMsgId& aMailBoxId, 

        const TFSMailMsgId& aFolderId,

        const TFSMailMsgId& aMessageId, 

        const TFSMailDetails aDetails);

    virtual void DeleteMessagesByUidL( 

        const TFSMailMsgId& aMailBoxId,

        const TFSMailMsgId& aFolderId,

        const RArray<TFSMailMsgId>& aMessages );

    // MESSAGE STORE OPERATIONS

    virtual CFSMailMessage* CreateMessageToSendL( 

        const TFSMailMsgId& aMailBoxId );

// <qmail>

    virtual void CreateMessageToSendL(

	    const TFSMailMsgId& aMailBoxId,

        MFSMailRequestObserver& aOperationObserver,

        const TInt aRequestId );

// </qmail>

    virtual CFSMailMessage* CreateForwardMessageL( 

        const TFSMailMsgId& aMailBoxId, 

        const TFSMailMsgId& aOriginalMessageId,

        const TDesC& aHeaderDescriptor );

// <qmail>

    virtual void CreateForwardMessageL( 

        const TFSMailMsgId& aMailBoxId,

        const TFSMailMsgId& aOriginalMessageId,

        MFSMailRequestObserver& aOperationObserver,

        const TInt aRequestId,

        const TDesC& aHeaderDescriptor = KNullDesC );

// </qmail>

    virtual CFSMailMessage* CreateReplyMessageL( 

        const TFSMailMsgId& aMailBoxId, 

        const TFSMailMsgId& aOriginalMessageId,

        const TBool aReplyToAll,

        const TDesC& aHeaderDescriptor );

// <qmail>

    virtual void CreateReplyMessageL( 

        const TFSMailMsgId& aMailBoxId, 

        const TFSMailMsgId& aOriginalMessageId,

        const TBool aReplyToAll,

        MFSMailRequestObserver& aOperationObserver,

        const TInt aRequestId,

        const TDesC& aHeaderDescriptor );

// </qmail>

    virtual void StoreMessageL( 

        const TFSMailMsgId& aMailBoxId, 

        CFSMailMessage& aMessage );

    // <qmail>

    virtual void StoreMessagesL(

            const TFSMailMsgId& aMailBoxId,

            RPointerArray<CFSMailMessage> &messages,

            MFSMailRequestObserver& aOperationObserver,

            const TInt aRequestId );

    // </qmail>

    virtual void GetMessagesL(

        const TFSMailMsgId& aMailBoxId, 

        const TFSMailMsgId& aFolderId,

        const RArray<TFSMailMsgId>& aMessageIds,

        RPointerArray<CFSMailMessage>& aMessageList,

        const TFSMailDetails aDetails );

    virtual void ChildPartsL( 

        const TFSMailMsgId& aMailBoxId,

        const TFSMailMsgId& aParentFolderId,

        const TFSMailMsgId& aMessageId,

        const TFSMailMsgId& aParentId,

        RPointerArray<CFSMailMessagePart>& aParts);

    virtual CFSMailMessagePart* NewChildPartL(

        const TFSMailMsgId& aMailBoxId,

        const TFSMailMsgId& aParentFolderId,

        const TFSMailMsgId& aMessageId,

        const TFSMailMsgId& aParentPartId,

        const TFSMailMsgId& aInsertBefore,

        const TDesC& aContentType);

    virtual CFSMailMessagePart* NewChildPartFromFileL(

        const TFSMailMsgId& aMailBoxId,

        const TFSMailMsgId& aParentFolderId,

        const TFSMailMsgId& aMessageId,

        const TFSMailMsgId& aParentPartId,

        const TDesC& aContentType,

        const TDesC& aFilePath );

    // <qmail>

    virtual void NewChildPartFromFileL(

        const TFSMailMsgId& aMailBoxId,

        const TFSMailMsgId& aParentFolderId,

        const TFSMailMsgId& aMessageId,

        const TFSMailMsgId& aParentPartId,

        const TDesC& aContentType,

        const TDesC& aFilePath, 

        MFSMailRequestObserver& aOperationObserver,

        const TInt aRequestId );

    // </qmail>

    /**

     * Creates attachment based on file handle

     * @param aMailBoxId specifies the mailbox

     * @param aParentFolderId specifies the folder where message is

     * @param aMessageId specifies message

     * @param aParentPartId

     * @param aContentType mime type

     * @param aFile handle to open file

     */

    virtual CFSMailMessagePart* NewChildPartFromFileL(

        const TFSMailMsgId& aMailBoxId,

        const TFSMailMsgId& aParentFolderId,

        const TFSMailMsgId& aMessageId,

        const TFSMailMsgId& aParentPartId,

        const TDesC& aContentType,

        RFile& aFile );

    virtual CFSMailMessagePart* CopyMessageAsChildPartL(

        const TFSMailMsgId& aMailBoxId,

        const TFSMailMsgId& aParentFolderId,

        const TFSMailMsgId& aMessageId,

        const TFSMailMsgId& aParentPartId,

        const TFSMailMsgId& aInsertBefore,

        const CFSMailMessage& aMessage);

    virtual void RemoveChildPartL(

        const TFSMailMsgId& aMailBoxId,

        const TFSMailMsgId& aParentFolderId,

        const TFSMailMsgId& aMessageId,

        const TFSMailMsgId& aParentPartId,

        const TFSMailMsgId& aPartId);

    virtual CFSMailMessagePart* MessagePartL(  

        const TFSMailMsgId& aMailBoxId, 

        const TFSMailMsgId& aParentFolderId,

        const TFSMailMsgId& aMessageId,

        const TFSMailMsgId& aMessagePartId);

    virtual TInt GetMessagePartFileL(  

        const TFSMailMsgId& aMailBoxId, 

        const TFSMailMsgId& aParentFolderId,

        const TFSMailMsgId& aMessageId,

        const TFSMailMsgId& aMessagePartId, 

        RFile& aFileHandle);

    virtual void CopyMessagePartFileL( 

        const TFSMailMsgId& aMailBoxId, 

        const TFSMailMsgId& aParentFolderId,

        const TFSMailMsgId& aMessageId,

        const TFSMailMsgId& aMessagePartId, 

        const TDesC& aFilePath);

    virtual void GetContentToBufferL(	

        const TFSMailMsgId& aMailBoxId,

        const TFSMailMsgId& aParentFolderId,

        const TFSMailMsgId& aMessageId,

        const TFSMailMsgId& aMessagePartId,

        TDes& aBuffer,

        const TUint aStartOffset);

    virtual void SetContentL(

        const TDesC& aBuffer, 

        const TFSMailMsgId& aMailBoxId,

        const TFSMailMsgId& aParentFolderId,

        const TFSMailMsgId& aMessageId, 

        const TFSMailMsgId& aMessagePartId); 

    virtual void RemovePartContentL( 

        const TFSMailMsgId& aMailBoxId, 

        const TFSMailMsgId& aParentFolderId,

        const TFSMailMsgId& aMessageId,

        const RArray<TFSMailMsgId>& aPartIds);

    virtual void SetPartContentFromFileL(

        const TFSMailMsgId& aMailBoxId,

        const TFSMailMsgId& aParentFolderId,

        const TFSMailMsgId& aMessageId,

        const TFSMailMsgId& aMessagePartId,

        const TDesC& aFilePath);

    virtual void StoreMessagePartL(

        const TFSMailMsgId& aMailBoxId,

        const TFSMailMsgId& aParentFolderId,

        const TFSMailMsgId& aMessageId,

        CFSMailMessagePart& aMessagePart);

    //<qmail>

    virtual void StoreMessagePartsL(

        RPointerArray<CFSMailMessagePart>& aMessagePart,

        MFSMailRequestObserver& aOperationObserver,

        const TInt aRequestId );

    //<qmail>

    virtual void UnregisterRequestObserver( TInt aRequestId );

    // MESSAGE SENDING

    virtual void SendMessageL( CFSMailMessage& aMessage );

    virtual void SendMessageL(

        CFSMailMessage& aMessage,

        MFSMailRequestObserver& aOperationObserver,

        const TInt aRequestId );

    // OPERATION HANDLING

    virtual void GoOnlineL( const TFSMailMsgId& aMailBoxId );

    virtual void GoOfflineL( const TFSMailMsgId& aMailBoxId );

    virtual TFSProgress StatusL(const TInt aRequestId);

    virtual void CancelL(const TInt aRequestId);

    // Search API 

    virtual void SearchL( 

        const TFSMailMsgId& aMailBoxId,

        const RArray<TFSMailMsgId>& aFolderIds,

        const RPointerArray<TDesC>& aSearchStrings,

        const TFSMailSortCriteria& aSortCriteria,

        MFSMailBoxSearchObserver& aSearchObserver );

    virtual void CancelSearch( const TFSMailMsgId& aMailBoxId );

    virtual void ClearSearchResultCache( const TFSMailMsgId& aMailBoxId );

    virtual void AddObserverL(MFSMailEventObserver& aObserver);

    virtual void RemoveObserver(MFSMailEventObserver& aObserver);

    virtual void SubscribeMailboxEventsL(const TFSMailMsgId& aMailBoxId,

        MFSMailEventObserver& aObserver);

    virtual void UnsubscribeMailboxEvents(

        const TFSMailMsgId& aMailBoxId,

        MFSMailEventObserver& aObserver);

    virtual TSSMailSyncState CurrentSyncState(

        const TFSMailMsgId& aMailBoxId);

    virtual TInt WizardDataAvailableL( );

    /**

     * reads connection id from plugin

     *

     * @param  aConnectionId reference to connection id

     * @return KErrNone or error code

     */

     virtual TInt GetConnectionId( TFSMailMsgId aMailBoxId, TUint32& aConnectionId );

    /**

     * checks from plugin if connection is allowed when roaming

     *

     * @param  aConnectionAllowed 

     * @return KErrNone or error code

     */

     virtual TInt IsConnectionAllowedWhenRoaming( 

             TFSMailMsgId aMailBoxId, 

             TBool& aConnectionAllowed );

    virtual void AuthenticateL(

        MFSMailRequestObserver& aOperationObserver,

        TInt aRequestId );

    virtual void SetCredentialsL( 

       const TFSMailMsgId& aMailBoxId, 

       const TDesC& aUsername,

       const TDesC& aPassword );

public:

    /**

    * Function to identify which protocol plugin we are working with

    * @return MTM id

    * @since FSEmail 2.0

    */

    TUid MtmId() const;

    /**

     * Returns the implementation ID of the plugin

     *

     * @return Implementation ID of the plugin

     * @since FSEmail 2.0

     */

   TUint PluginId() const;

    /**

     * Disconnects mailbox

     *

     * @param aMailbox unique mailbox id

     * @param FSObserver can be pointed at this class (dummy observer)

     * @param aRequestId FS async operation request id, can be zero (dummy)

     * @param aRemoveAccountAlso boolean to indicate should accound be

     *                           removed afted disconnect, default is EFalse

     * @since FSEmail 2.0

     */

    virtual void DisconnectL( 

        const TFSMailMsgId& aMailBoxId, 

        MFSMailRequestObserver& aObserver,

        const TInt aRequestId,

        TBool aRemoveAccountAlso = EFalse );

    /**

     * Fetch content of new mail, used in event handler

     * needed because imap idle