/*
* Copyright (c) 2007-2009 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:  
*
*/


#ifndef SCPUTILITY_H
#define SCPUTILITY_H

#include <cchservice.h>
#include <cchclientserver.h>

#include "scpdefs.h"
#include "scpsipconnection.h"

_LIT8( KSipScheme,  "sip:" );
_LIT8( KSipsScheme, "sips:" );
_LIT8( KAt, "@" );
_LIT8( KColon, ":" );

const TInt KSipSchemeMaxLength = 5;

/**
*  Static utility function for SCP usage.
*
*  @lib sipconnectionprovider.dll
*/
class TScpUtility
    {
public:
                              
   /**
    * Converts a sip connection state to connection event
    * @param aState sip connection state
    * @return CCH state
    */
    static TScpConnectionEvent ConvertToConnectionEvent( 
        CScpSipConnection::TConnectionState aState,
        TInt aError );

   /**
    * Converts a CCH state to conection event
    * @param aState sip connection state
    * @return CCH state
    */
    static TScpConnectionEvent ConvertToConnectionEvent( 
        TCCHSubserviceState aState );
    
   /**
    * Implementation for cleanup item.
    * Resets and destroys array of the RCSE
    * entries. 
    * @param anArray RPointerArray pointer.
    */
    static void ResetAndDestroyEntries( TAny* anArray );
    
   /**
    * Converts a sip error to CCH error
    * @param aState sip error
    * @return CCH error
    */
    static TInt ConvertToCchError( TInt aErrorCode );

    /**
     * Parse prefix and/or domain from username.
     * @param aUsername Username with prefix/domain
     * @param aFormattedUsername parsed username without prefix/domain is stored to this
     * @return Symbian error code
     */
    static TInt RemovePrefixAndDomain( 
        const TDesC8& aUsername, 
        RBuf8& aFormattedUsername );
    
    /**
     * Check if passed username is valid.
     * @param aUsername Username to check
     * @return True if valid, false if no.
     */
    static TBool CheckSipUsername( const TDesC8& aUsername );

    /**
     * Check if passed password is valid.
     * @param aPassweord Password to check
     * @return True if valid, false if no.
     */
    static TBool CheckSipPassword( const TDesC8& aPassword );
    
    /**
     * Prefix getter.
     * @param aUsername used username
     * @param aPrefix valid prefix
     */
    static void GetValidPrefix( const TDesC8& aUsername, TDes8& aPrefix );
    
private:

    // Structure that maps protocol specific errors to generic CCH errors
    struct SCchErrorMapping 
        {
        TInt iServiceError;
        TInt iProtocolError;
        };
    
    // Collection of mapped error codes
    static const SCchErrorMapping iErrorTable[];

    };

#endif      // SCPUTILITY_H   
            
// End of File