/*
* Copyright (c) 2006 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:  Observer interface for supplementary services (SS) events.
*
*/


#ifndef MCCESSOBSERVER_H
#define MCCESSOBSERVER_H

/**
* TODO list: 
* Call waiting service status, should be available via phone settings UI.
* DnD status
* see ccp part
*/

/**
 * Supplementary services observer.
 *
 * @since S60 v3.2
 */

class MCCESsObserver
    {
public:

    /** Barring related event. */
    enum TCCESsBarringEvent
        {
        /** Incoming call is barred. (DoCoMo) */
        ECCESsIncomingCallBarred,   
        /** Anonymous call barring. */
        ECCESsAnonymousCallBarred,  
        /** Outgoing call barring */
        ECCESsOutgoingCallBarred,
        /** Barring active notification. */
        ECCESsActiveBarrings    
        };

    /** CLI (Call Line Information) related event. */
    enum TCCESsCLIEvent
        {
        /** Temporary CLIR suppression was unsuccessful */
        ECCESsTempClirSuppressUnsuccessful,     
        /** Temporary CLIR activation was unsuccessful*/
        ECCESsTempClirActivationUnsuccessful    
        };

    /** Call forward related events that are not call related to an existing call. */
    enum TCCESsCallForwardEvent
        {
        /** Incoming call is forwarded */
        ECCESsIncCallIsForw,    
        /** Incoming call was forwarded because of user own settings. */
        ECCESsIncCallForwToC,   
        /** Outgoing call was forwarded because of user own settings. */
        ECCESsOutCallForwToC,   
        /** Forward unconditional mode active */
        ECCESsForwardUnconditionalModeActive,   
        /** Forward unconditional mode deactive */
        ECCESsForwardUnconditionalModeNotActive,
        /** Forward conditional mode active */
        ECCESsForwardConditionallyModeActive,   
        /** Forward conditional mode deactive */
        ECCESsForwardConditionallyModeNotActive,
        /** Remote call waiting. TODO rename TCCESsCallForwardEvent to TCCESsCallEvent*/
        ESsCallWaiting
        };

    /** Closed user group (Cug) */
    enum TCCESsCugEvent
        {
        ECCESsShowIncCallGroupIndex,
        ECCESsRejectedCause
        };

public:

    /**
    * Supplementary service call barring event occurred.
    * @param aBarringEvent Event that occurred.
    * @return none
    * @since S60 v3.2
    */
    virtual void BarringEventOccurred( const MCCESsObserver::TCCESsBarringEvent aBarringEvent ) = 0;
                                  
    /**
    * Supplementary service call line identification event occurred.
    * @param aCallLineEvent Event that occurred.
    * @return none
    * @since S60 v3.2
    */
    virtual void CLIEventOccurred( const MCCESsObserver::TCCESsCLIEvent aCallLineEvent ) = 0;
                                  

    /**
    * Supplementary service related call forward event occurred.
    * @param aForwardMode Forward mode
    * @param aRemoteAddress Remote address.
    * @return none
    * @since S60 v3.2
    */
    virtual void CallForwardEventOccurred( 
                        const MCCESsObserver::TCCESsCallForwardEvent aCallForwardEvent,
                        const TDesC& aRemoteAddress ) = 0;

    /**
    * Supplementary service related active closed user group indications.
    * @param aCugEvent Event that occurred.
    * @return none
    * @since S60 v3.2
    */
    virtual void CallCugEventOccurred( const MCCESsObserver::TCCESsCugEvent aCugEvent ) = 0;

    /**
    * Notifies active ALS line. CS plugin will notify this every time line changes 
    * and at startup.
    * @param aLine Used ALS line.
    * @return none
    * @since S60 v3.2
    */
    virtual void NotifyCurrentActiveALSLine( TInt aLine ) = 0;

    };


#endif // MCCESSOBSERVER_H