/**

 * @file server.h Server API

 * @ingroup core

 */

/* purple

 *

 * Purple is the legal property of its developers, whose names are too numerous

 * to list here.  Please refer to the COPYRIGHT file distributed with this

 * source distribution.

 *

 * This program is free software; you can redistribute it and/or modify

 * it under the terms of the GNU General Public License as published by

 * the Free Software Foundation; either version 2 of the License, or

 * (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA

 */

#ifndef _PURPLE_SERVER_H_

#define _PURPLE_SERVER_H_

#include "account.h"

#include "conversation.h"

#include "prpl.h"

#ifdef __cplusplus

extern "C" {

#endif

/**

 * Send a typing message to a given user over a given connection.

 *

 * TODO: Could probably move this into the conversation API.

 *

 * @param gc    The connection over which to send the typing notification.

 * @param name  The user to send the typing notification to.

 * @param state One of PURPLE_TYPING, PURPLE_TYPED, or PURPLE_NOT_TYPING.

 * @return A quiet-period, specified in seconds, where Purple will not

 *         send any additional typing notification messages.  Most

 *         protocols should return 0, which means that no additional

 *         PURPLE_TYPING messages need to be sent.  If this is 5, for

 *         example, then Purple will wait five seconds, and if the Purple

 *         user is still typing then Purple will send another PURPLE_TYPING

 *         message.

 */

unsigned int serv_send_typing(PurpleConnection *gc, const char *name, PurpleTypingState state);

void serv_move_buddy(PurpleBuddy *, PurpleGroup *, PurpleGroup *);

int  serv_send_im(PurpleConnection *, const char *, const char *, PurpleMessageFlags flags);

/** Get information about an account's attention commands, from the prpl.

 *

 * @return The attention command numbered 'code' from the prpl's attention_types, or NULL.

 */

PurpleAttentionType *purple_get_attention_type_from_code(PurpleAccount *account, guint type_code);

/** Send an attention request message.

 *

 * @deprecated Use purple_prpl_send_attention() instead.

 *

 * @param gc The connection to send the message on.

 * @param who Whose attention to request.

 * @param type_code An index into the prpl's attention_types list determining the type

 * 	of the attention request command to send. 0 if prpl only defines one

 * 	(for example, Yahoo and MSN), but some protocols define more (MySpaceIM).

 *

 * Note that you can't send arbitrary PurpleAttentionType's, because there is

 * only a fixed set of attention commands.

 */

void serv_send_attention(PurpleConnection *gc, const char *who, guint type_code);

/** Process an incoming attention message.

 *

 * @deprecated Use purple_prpl_got_attention() instead.

 *

 * @param gc The connection that received the attention message.

 * @param who Who requested your attention.

 * @param type_code An index into the prpl's attention_types list determining the type

 * 	of the attention request command to send.

 */

void serv_got_attention(PurpleConnection *gc, const char *who, guint type_code);

void serv_get_info(PurpleConnection *, const char *);

void serv_set_info(PurpleConnection *, const char *);

void serv_add_permit(PurpleConnection *, const char *);

void serv_add_deny(PurpleConnection *, const char *);

void serv_rem_permit(PurpleConnection *, const char *);

void serv_rem_deny(PurpleConnection *, const char *);

void serv_set_permit_deny(PurpleConnection *);

void serv_chat_invite(PurpleConnection *, int, const char *, const char *);

void serv_chat_leave(PurpleConnection *, int);

void serv_chat_whisper(PurpleConnection *, int, const char *, const char *);

int  serv_chat_send(PurpleConnection *, int, const char *, PurpleMessageFlags flags);

void serv_alias_buddy(PurpleBuddy *);

void serv_got_alias(PurpleConnection *gc, const char *who, const char *alias);

/**

 * A protocol plugin should call this when it retrieves a private alias from

 * the server.  Private aliases are the aliases the user sets, while public

 * aliases are the aliases or display names that buddies set for themselves.

 *

 * @param gc The connection on which the alias was received.

 * @param who The name of the buddy whose alias was received.

 * @param alias The alias that was received.

 */

void purple_serv_got_private_alias(PurpleConnection *gc, const char *who, const char *alias);

/**

 * Receive a typing message from a remote user.  Either PURPLE_TYPING

 * or PURPLE_TYPED.  If the user has stopped typing then use

 * serv_got_typing_stopped instead.

 *

 * TODO: Could probably move this into the conversation API.

 *

 * @param gc      The connection on which the typing message was received.

 * @param name    The name of the remote user.

 * @param timeout If this is a number greater than 0, then

 *        Purple will wait this number of seconds and then

 *        set this buddy to the PURPLE_NOT_TYPING state.  This

 *        is used by protocols that send repeated typing messages

 *        while the user is composing the message.

 * @param state   The typing state received

 */

void serv_got_typing(PurpleConnection *gc, const char *name, int timeout,

					 PurpleTypingState state);

/**

 * TODO: Could probably move this into the conversation API.

 */

void serv_got_typing_stopped(PurpleConnection *gc, const char *name);

void serv_got_im(PurpleConnection *gc, const char *who, const char *msg,

				 PurpleMessageFlags flags, time_t mtime);

/**

 * @param data The hash function should be g_str_hash() and the equal

 *             function should be g_str_equal().

 */

void serv_join_chat(PurpleConnection *, GHashTable *data);

/**

 * @param data The hash function should be g_str_hash() and the equal

 *             function should be g_str_equal().

 */

void serv_reject_chat(PurpleConnection *, GHashTable *data);

/**

 * Called by a prpl when an account is invited into a chat.

 *

 * @param gc      The connection on which the invite arrived.

 * @param name    The name of the chat you're being invited to.

 * @param who     The username of the person inviting the account.

 * @param message The optional invite message.

 * @param data    The components necessary if you want to call serv_join_chat().

 *                The hash function should be g_str_hash() and the equal

 *                function should be g_str_equal().

 */

void serv_got_chat_invite(PurpleConnection *gc, const char *name,

						  const char *who, const char *message,

						  GHashTable *data);

PurpleConversation *serv_got_joined_chat(PurpleConnection *gc,

									   int id, const char *name);

/**

 * Called by a prpl when an attempt to join a chat via serv_join_chat()

 * fails.

 *

 * @param gc      The connection on which chat joining failed

 * @param data    The components passed to serv_join_chat() originally.

 *                The hash function should be g_str_hash() and the equal

 *                function should be g_str_equal().

 */

void purple_serv_got_join_chat_failed(PurpleConnection *gc, GHashTable *data);

void serv_got_chat_left(PurpleConnection *g, int id);

void serv_got_chat_in(PurpleConnection *g, int id, const char *who,

					  PurpleMessageFlags flags, const char *message, time_t mtime);

void serv_send_file(PurpleConnection *gc, const char *who, const char *file);

#ifdef __cplusplus

}

#endif

#endif /* _PURPLE_SERVER_H_ */