/*

* 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;

// <qmail> CIpsSetDataApi removed

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 TInt MoveMessagesL(

        const TFSMailMsgId& aMailBoxId,

        const RArray<TFSMailMsgId>& aMessageIds,

        const TFSMailMsgId& aSourceFolderId,

        const TFSMailMsgId& aDestinationFolderId,

        MFSMailRequestObserver& aOperationObserver,

        TInt aRequestId );

    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>

    /**

     * Creates new email message to message store asynchronously

     *

     * @param aMailBoxId msv entry id to mailbox which setting are used

     * @param aOperationObserver Observer for the operation

     * @param aRequestId Id of the operation

     */

    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>

    /**

     * Creates a forward email message to message store asynchronously

     *

     * @param aMailBoxId msv entry id to mailbox which setting are used

     * @param aOriginalMessageId id of the forwarded message

     * @param aOperationObserver Observer for the operation

     * @param aRequestId Id of the operation

     */

    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>

    /**

     * Creates new reply message to message store asynchronously

     *

     * @param aMailBoxId msv entry id to mailbox which setting are used

     * @param aOriginalMessageId id of the replied message

     * @param aReplyToAll reply to all recipients

     * @param aOperationObserver Observer for the operation

     * @param aRequestId Id of the operation

     */

    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);

    // <qmail>

    virtual void RemoveChildPartL(

        const TFSMailMsgId& aMailBoxId,

        const TFSMailMsgId& aParentFolderId,

        const TFSMailMsgId& aMessageId,

        const TFSMailMsgId& aParentPartId,

        const TFSMailMsgId& aPartId,

        MFSMailRequestObserver& aOperationObserver,

        const TInt aRequestId );

    // </qmail>

    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 SendL(TFSMailMsgId aMessageId );

    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