/*
	Kopete Oscar Protocol
	client.h - The main interface for the Oscar protocol

	Copyright (c) 2004-2005 by Matt Rogers <mattr@kde.org>

	Based on code Copyright (c) 2004 SuSE Linux AG <http://www.suse.com>
	Based on Iris, Copyright (C) 2003  Justin Karneges <justin@affinix.com>

	Kopete (c) 2002-2008 by the Kopete developers <kopete-devel@kde.org>

	*************************************************************************
	*                                                                       *
	* This library is free software; you can redistribute it and/or         *
	* modify it under the terms of the GNU Lesser General Public            *
	* License as published by the Free Software Foundation; either          *
	* version 2 of the License, or (at your option) any later version.      *
	*                                                                       *
	*************************************************************************
*/


#ifndef LIBOSCAR_CLIENT_H
#define LIBOSCAR_CLIENT_H

#include <qobject.h>
#include <qstring.h>
#include <QList>
#include <QByteArray>
#include "kopete_export.h"
#include "rtf2html.h"
#include "transfer.h"
#include "icquserinfo.h"
#include "userdetails.h"
#include "oscartypeclasses.h"
#include "oscarmessage.h"
#include "contact.h"

class Connection;
class ContactManager;
class UserDetails;
class QString;
class Task;
class QTextCodec;
class FileTransferHandler;

namespace Kopete
{
	class Transfer;
	class TransferManager;
}

namespace Oscar
{
class Settings;
}

class LIBOSCAR_EXPORT Client : public QObject
{
Q_OBJECT

public:

	class CodecProvider {
	public:
		virtual ~CodecProvider() {}
		virtual QTextCodec* codecForContact( const QString& contactName ) const = 0;
		virtual QTextCodec* codecForAccount() const = 0;
	};

	enum ErrorCodes {
		NoError = 0,
		NotConnectedError = 1,
		NonFatalProtocolError = 2,
		FatalProtocolError = 3
	};

	enum ICQStatusFlags {
		ICQOnline       = 0x00,
		ICQAway         = 0x01,
		ICQNotAvailable = 0x02,
		ICQOccupied     = 0x03,
		ICQDoNotDisturb = 0x04,
		ICQFreeForChat  = 0x05,

		ICQXStatus      = 0x10,
		ICQPluginStatus = 0x20,

		ICQStatusMask   = 0x0F
	};
	Q_DECLARE_FLAGS(ICQStatus, ICQStatusFlags)

	/*************
	  EXTERNAL API
	 *************/

	Client(QObject *parent=0);
	~Client();

	/**
	 * Get the settings object for this client instance
	 */
	Oscar::Settings* clientSettings() const;

	/**
	 * Start a connection to the server using the supplied @ref ClientStream.
	 * This is only a transport layer connection.
	 * @param s initialised connection object to use for the connection.
	 * @param host the host name of server to connect to
	 * @param port the port of server to connect to
	 * @param auth indicate whether we're connecting to the authorizer or the bos server
	 */
	void connectToServer( Connection *c, const QString& host, quint16 port, bool auth = true );

	/**
	 * Start the login process for Oscar
	 * @param host Used for outgoing tasks to determine destination
	 * @param user The user name to log in as.
	 * @param port The port of server to connect to
	 * @param pass The password to use when logging in
	 */
	void start( const QString &host, const uint port, const QString &userId, const QString &pass );

	/** Logout and disconnect */
	void close();

	/** Set our status
	 * \param status the oscar status
	 * \param message the status message or Xtraz status message
	 * \param xtraz the Xtraz status
	 * \param title the Xtraz status title
	 * @note If you want XStatus you should set status, message, xtraz and title,
	 * for ExtStatus (ICQ6 status) you should set status, message, title, xtraz have to be -1,
	 * for ExtStatus2 (ICQ6 status with icons) you should set status, message, title and mood.
	 * If you want normal status than you should set only status and message.
	 * XStatus and ExtStatus2 can be set together.
	 */
	void setStatus( Oscar::DWORD status, const QString &message = QString(), int xtraz = -1, const QString &title = QString(), int mood = -1 );

	/** Retrieve our user info */
	UserDetails ourInfo() const;

	/**
	 * Remove a group to the contact list
	 * \param groupName the name of the group to remove
	 * \return true if the group removal was successful
	 */
	void removeGroup( const QString& groupName );

	/**
	 * Add a group from the contact list
	 * \param groupName the name of the group to add
	 * \return true if the group addition was successful
	 */
	void addGroup( const QString& groupName );

	/**
	 * Add a contact to the contact list
	 * \param contactName the screen name of the new contact to add
	 * \return true if the contact addition was successful
	 */
	void addContact( const QString& contactName, const QString& groupName );

	/**
	 * Remove a contact from the contact list
	 * \param contactName the screen name of the contact to remove
	 * \return true if the contact removal was successful
	 */
	void removeContact( const QString &contactName );

	/**
	 * Rename a group on the contact list
	 * \param oldGroupName the old group name
	 * \param newGroupName the new group name
	 */
	void renameGroup( const QString& oldGroupName, const QString& newGroupName );

	/**
	 * Modify an Contact item on the Contact list
	 * \param item the item to send to the server
	 */
	void modifyContactItem( const OContact& oldItem, const OContact& newItem );

	/**
	 * Change a contact's group on the server
	 * \param contact the contact to change
	 * \param newGroup the new group to move the contact to
	 */
	void changeContactGroup( const QString& contact, const QString& newGroupName );

	/**
	 * Change a contact's alias on the server
	 * \param contact the contact to change
	 * \param alias the new alias
	 */
	void changeContactAlias( const QString& contact, const QString& alias );

	/**
	 * Set privacy settings
	 * \param privacy the privacy settings
	 * \param userClasses the bit mask which tells which class of users you want to be visible to
	 */
	void setPrivacyTLVs( Oscar::BYTE privacy, Oscar::DWORD userClasses = 0xFFFFFFFF );

	/**
	 * Send a message to a contact
	 * \param msg the message to be sent
	 * \param auto the message is an autoresponse message, default to false
	 */
	void sendMessage( const Oscar::Message& msg, bool isAuto = false );

	/**
	 * Request authorization from a contact
	 * \param contactid the id of the contact to request auth from
	 * \param reason the reason for this authorization request
	 */
	void requestAuth( const QString& contactid, const QString& reason );

	/**
	 * Grant or decline authorization to a contact
	 * \param contactid the id of the contact to grant/decline authorization
	 * \param reason the reason to grant/decline authorization
	 * \param auth grant or decline authorization
	 */
	void sendAuth( const QString& contactid, const QString& reason, bool auth=true );

	/**
	 * Request Short/Medium/Long user info from an ICQ contact (new TLV based format)
	 * \param contactId the UIN of the contact to get info for
	 * \param metaInfoId the id of the info (TLV 0x015C in SSI)
	 */
	void requestShortTlvInfo( const QString& contactId, const QByteArray &metaInfoId );
	void requestMediumTlvInfo( const QString& contactId, const QByteArray &metaInfoId );
	void requestLongTlvInfo( const QString& contactId, const QByteArray &metaInfoId );

	/**
	 * Request full user info from an ICQ contact
	 * \param contactId the UIN of the contact to get info for
	 */
	void requestFullInfo( const QString& contactId );

	/**
	 * Request short info for an ICQ contact
	 * \param contactId the UIN of the contact to get info for
	 */
	void requestShortInfo( const QString& contactId );

	/**
	 * Send a warning to the OSCAR servers about a contact
	 * \param contact the contact to send the warning to
	 * \param anon indicate whether to do it anonymously
	 */
	void sendWarning( const QString& contact, bool anonymous );

	/**
	 * Change ICQ password
	 * \param password your new password
	 */
	bool changeICQPassword( const QString& password );

	/**
	 * Get the full ICQ info for a client
	 * \param contact the contact to get info for
	 */
	ICQFullInfo getFullInfo( const QString& contact );
	
	/**
	 * Get the general ICQ info for a client
	 * \param contact the contact to get info for
	 */
	ICQGeneralUserInfo getGeneralInfo( const QString& contact );

	/**
	 * Get the work info for a contact
	 * \param contact the contact to get info for
	 */
	ICQWorkUserInfo getWorkInfo( const QString& contact );

	/**
	 * Get the email info for a contact
	 * \param contact the contact to get info for
	 */
	ICQEmailInfo getEmailInfo( const QString& contact );

	/**
	 * Get the notes info for a contact
	 * \param contact the contact to get info for
	 */
	ICQNotesInfo getNotesInfo( const QString& contact );
	
	/**
	 * Get the additional info available for a contact
	 * \param contact the contact to get info for
	 */
	ICQMoreUserInfo getMoreInfo( const QString& contact );

	/**
	 * Get the interest info available for a contact
	 * \param contact the contact to get info for
	 */
	ICQInterestInfo getInterestInfo( const QString& contact );

	/**
	 * Get the organization and affiliation interest info available for a contact
	 * \param contact the contact to get info for
	 */
	ICQOrgAffInfo getOrgAffInfo( const QString& contact );

	/**
	 * Get the short info available for an icq contact
	 * \param contact the contact to get info for
	 */
	ICQShortInfo getShortInfo( const QString& contact );

    /**
     * Get the list of chat room exchanges we have
     */
    QList<int> chatExchangeList() const;

	/**
	 * Request the aim profile
	 * \param contact the contact to get info for
	 */
	void requestAIMProfile( const QString& contact );

	/**
	 * Request the aim away message
	 * \param contact the contact to get info for
	 */
	void requestAIMAwayMessage( const QString& contact );

	/**
	 * Add the icq away message request to queue
	 * \param contact the contact to get info for
	 */
	void addICQAwayMessageRequest( const QString& contact, ICQStatus contactStatus );

	/**
	 * Remove the icq away message request from queue
	 * \param contact the contact to get info for
	 */
	void removeICQAwayMessageRequest( const QString& contact );

	/** Request the extended status info */
	void requestStatusInfo( const QString& contact );

	//! Run a whitepages search
	void whitePagesSearch( const ICQWPSearchInfo& info );

	//! Run a UIN search
	void uinSearch( const QString& uin );

	//! Update the user's AIM profile
	void updateProfile( const QString& profile );

	//! Update the user's ICQ profile
	bool updateProfile( const QList<ICQInfoBase*>& infoList );

	//! Get buddy icon information for a person
	void requestBuddyIcon( const QString& user, const QByteArray& hash, Oscar::WORD iconType, Oscar::BYTE hashType );

	//! Start a server redirect for a different service
	void requestServerRedirect( Oscar::WORD family, Oscar::WORD e = 0, QByteArray c = QByteArray(),
                                Oscar::WORD instance = 0, const QString& room = QString() );

	//! Start uploading a buddy icon
	void sendBuddyIcon( const QByteArray& imageData );

    void joinChatRoom( const QString& roomName, int exchange );

	void setIgnore( const QString& user, bool ignore );
	
	void setVisibleTo( const QString& user, bool visible );
	
	void setInvisibleTo( const QString& user, bool invisible );
	
	/** Accessors needed for login */
	QString host();
	int port();

	/** Send a typing notification */
	void sendTyping( const QString & contact, bool typing );

	/** Make a connection to the icon server */
	void connectToIconServer();

	bool hasIconConnection() const;

    /** We've finished chatting in a chat room, disconnect from it */
    void disconnectChatRoom( Oscar::WORD exchange, const QString& room );

	/** Set codec provider */
	void setCodecProvider( CodecProvider* codecProvider );

	/** Set pointer to version info */
	void setVersion( const Oscar::ClientVersion* version );

	/**	Set version capability */
	void setVersionCap( const QByteArray &cap );

	/** create a filetransfer task
	 * \return FileTransferHandler object;
	 */
	FileTransferHandler* createFileTransfer( const QString& contact, const QStringList& files );

	/*************
	  INTERNAL (FOR USE BY TASKS OR CONNECTIONS) METHODS
	 *************/
	/**
	 * Print a debug statement
	 */
	void debug( const QString &str );

	/** Have we logged in yet? */
	bool isActive() const;

	/** Accessor for the Contact Manager */
	ContactManager* ssiManager() const;

	/** Return version info */
	const Oscar::ClientVersion* version() const;

	/** Return version capability */
	Guid versionCap() const;

	/** The current user's user ID */
	QString userId() const;

	/** The current user's password */
	QString password() const;

	/** The current Xtraz status */
	int statusXtraz() const;

	/** The current status mood */
	int statusMood() const;

	/** The current Xtraz status title */
	QString statusTitle() const;

	/** The current status message (a.k.a. away message or Xtraz message) */
	QString statusMessage() const;

	/** Change the current status message w/o changing status */
	void setStatusMessage( const QString &message );

	/** ICQ Settings */
	bool isIcq() const;
	void setIsIcq( bool isIcq );

	/** Host's IP address */
	QByteArray ipAddress() const;

	/** Notify that a task error was received */
	void notifyTaskError( const Oscar::SNAC& s, int errCode, bool fatal );

	/** Notify that a socket error has occurred */
	void notifySocketError( int errCode, const QString& msg );

signals:
	/** CONNECTION EVENTS */

	/** Notifies that the login process has succeeded. */
	void loggedIn();

	/** Notifies that the login process has failed */
	void loginFailed();

	/** Notifies tasks and account so they can react properly */
	void disconnected();

	/** We were disconnected because we connected elsewhere */
	void connectedElsewhere();

	/** We have our own user info */
	void haveOwnInfo();

	/** We have our Contact list */
	void haveContactList();

	/** a user is online. */
	void userIsOnline( const QString& );

	/** a user is offline. */
	void userIsOffline( const QString& );

	/** we've received a message */
	void messageReceived( const Oscar::Message& );

	/** a message was delivered */
	void messageAck( const QString& contact, uint messageId );

	/** a message wasn't delivered */
	void messageError( const QString& contact, uint messageId );

	/** we've received an authorization request */
	void authRequestReceived( const QString& contact, const QString& reason );

	/** we've received an authorization reply */
	void authReplyReceived( const QString& contact, const QString& reason, bool auth );

	/** we've received a ICQ password change reply */
	void icqPasswordChanged( bool error );

	/**
	 * we've received an error from a task and need to notify somebody
	 */
	void taskError( const Oscar::SNAC& s, int errCode, bool fatal );

	/**
	 * we've received a socket error and need to notify somebody
	 */
	void socketError( int errCode, const QString& msg );

	void receivedIcqShortInfo( const QString& contact );
	void receivedIcqLongInfo( const QString& contact );
	void receivedIcqTlvInfo( const QString& contact );

	void receivedProfile( const QString& contact, const QString& profile );
	void receivedAwayMessage( const QString& contact, const QString& message );
	void receivedXStatusMessage( const QString& contact, int icon, const QString& title, const QString& message );
	void receivedUserInfo( const QString& contact, const UserDetails& details );
	void userReadsStatusMessage( const QString& contact );

	/** We warned a user */
	void userWarned( const QString& contact, quint16 increase, quint16 newLevel );

	/** Search signals */
	void gotSearchResults( const ICQSearchResult& );
	void endOfSearch( int);

	/* Typing signals */
	void userStartedTyping( const QString& contact );
	void userStoppedTyping( const QString& contact );

	/* Buddy icons */
	void haveIconForContact( const QString&, QByteArray iconData );
	void iconServerConnected();
	void iconNeedsUploading();

	/* Chat rooms */
	void chatNavigationConnected();
    void chatRoomConnected( Oscar::WORD, const QString& );
    void userJoinedChat( Oscar::WORD, const QString& room, const QString& contact );
    void userLeftChat( Oscar::WORD, const QString& room, const QString& contact );

	/* service redirection */
	void redirectionFinished( Oscar::WORD );

	/** incoming filetransfer */
	void incomingFileTransfer( FileTransferHandler* handler );

protected slots:
	// INTERNAL, FOR USE BY TASKS' finished() SIGNALS //

	/** Singleshot timer to start stage two login */
	void startStageTwo();

	/**
	 * A login task finished. For stage one, this means we've either errored
	 * out, or gotten a cookie. For stage two, this means we've either done
	 * something wrong, or we're successfully connected
	 */
	void lt_loginFinished();

	/** Stream connected for stage two login */
	void streamConnected();

	/** We have our own user info */
	void haveOwnUserInfo();

	/** Service setup finished */
	void serviceSetupFinished();

	/** we have icq info for a contact */
	void receivedIcqInfo( const QString& contact, unsigned int type );

	/** we have normal user info for a contact */
	void receivedInfo( Oscar::DWORD sequence );

	/** received a message of some kind */
	void receivedMessage( const Oscar::Message& msg );

	/** filetransfer message needs sending */
	void fileMessage( const Oscar::Message& msg );

	/** rendezvous message for a filetransfer task */
	void gotFileMessage( int, const QString, const QByteArray, Buffer );

	void offlineUser( const QString&, const UserDetails& );

	void haveServerForRedirect( const QString& host, const QByteArray& cookie, Oscar::WORD family );
	void serverRedirectFinished();
	void checkRedirectionQueue( Oscar::WORD );

	void requestChatNavLimits();
    /**
     * Set the list of chat room exchanges we have
     */
    void setChatExchangeList( const QList<int>& exchanges );
    
    /**
     * set up the connection to a chat room
     */
    void setupChatConnection( Oscar::WORD, QByteArray, Oscar::WORD, const QString& );
    
    void determineDisconnection( int, const QString& );

	void nextICQAwayMessageRequest();

	/** Change ICQ password finished */
	void changeICQPasswordFinished();

private:

	/** Initialize some static tasks */
	void initializeStaticTasks();

	/** Delete the static tasks */
	void deleteStaticTasks();

	Connection* createConnection();

	/**
	 * Request the icq away message
	 * \param contact the contact to get info for
	 */
	//TODO only made a default for testing w/o frontend
	void requestICQAwayMessage( const QString& contact, ICQStatus contactStatus = ICQAway );

private:
	class ClientPrivate;
	ClientPrivate* d;
};
Q_DECLARE_OPERATORS_FOR_FLAGS(Client::ICQStatus)

#endif

//kate: tab-width 4; indent-mode csands;


