* 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
* 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, see <https://www.gnu.org/licenses/>.
#include <libpurple/purpleimconversation.h>
#include <libpurple/enums.h>
#include <libpurple/purpleprivate.h>
struct _PurpleIMConversation {
PurpleConversation parent;
PurpleIMTypingState typing_state;
guint send_typed_timeout;
static GParamSpec *properties[N_PROPERTIES];
#define SEND_TYPED_TIMEOUT_SECONDS 5
/******************************************************************************
*****************************************************************************/
purple_im_conversation_reset_typing_cb(gpointer data)
PurpleIMConversation *im = PURPLE_IM_CONVERSATION(data);
purple_im_conversation_set_typing_state(im, PURPLE_IM_NOT_TYPING);
purple_im_conversation_stop_typing_timeout(im);
purple_im_conversation_send_typed_cb(gpointer data)
PurpleIMConversation *im = PURPLE_IM_CONVERSATION(data);
PurpleConnection *pc = NULL;
g_return_val_if_fail(im != NULL, FALSE);
pc = purple_conversation_get_connection(PURPLE_CONVERSATION(im));
name = purple_conversation_get_name(PURPLE_CONVERSATION(im));
if(pc != NULL && name != NULL) {
/* We set this to 1 so that PURPLE_IM_TYPING will be sent if the Purple
* user types anything else.
purple_im_conversation_set_type_again(im, 1);
purple_serv_send_typing(pc, name, PURPLE_IM_TYPED);
purple_debug(PURPLE_DEBUG_MISC, "purple-im-conversation", "typed...\n");
/******************************************************************************
* PurpleConversation Implementation
*****************************************************************************/
im_conversation_write_message(PurpleConversation *conv, PurpleMessage *msg) {
PurpleIMConversation *im = PURPLE_IM_CONVERSATION(conv);
gboolean is_recv = FALSE;
g_return_if_fail(im != NULL);
g_return_if_fail(msg != NULL);
is_recv = (purple_message_get_flags(msg) & PURPLE_MESSAGE_RECV);
purple_im_conversation_set_typing_state(im, PURPLE_IM_NOT_TYPING);
_purple_conversation_write_common(conv, msg);
/******************************************************************************
*****************************************************************************/
G_DEFINE_TYPE(PurpleIMConversation, purple_im_conversation,
PURPLE_TYPE_CONVERSATION);
purple_im_conversation_get_property(GObject *obj, guint param_id, GValue *value,
PurpleIMConversation *im = PURPLE_IM_CONVERSATION(obj);
purple_im_conversation_get_typing_state(im));
g_value_set_pointer(value, purple_im_conversation_get_icon(im));
G_OBJECT_WARN_INVALID_PROPERTY_ID(obj, param_id, pspec);
purple_im_conversation_set_property(GObject *obj, guint param_id,
const GValue *value, GParamSpec *pspec)
PurpleIMConversation *im = PURPLE_IM_CONVERSATION(obj);
purple_im_conversation_set_typing_state(im,
g_value_get_enum(value));
purple_im_conversation_set_icon(im, g_value_get_pointer(value));
G_OBJECT_WARN_INVALID_PROPERTY_ID(obj, param_id, pspec);
purple_im_conversation_init(PurpleIMConversation *im) {
purple_im_conversation_constructed(GObject *object) {
PurpleIMConversation *im = PURPLE_IM_CONVERSATION(object);
PurpleAccount *account = NULL;
PurpleBuddyIcon *icon = NULL;
G_OBJECT_CLASS(purple_im_conversation_parent_class)->constructed(object);
if((icon = purple_buddy_icons_find(account, name))) {
purple_im_conversation_set_icon(im, icon);
/* purple_im_conversation_set_icon refs the icon. */
purple_buddy_icon_unref(icon);
if(purple_prefs_get_bool("/purple/logging/log_ims")) {
purple_conversation_set_logging(PURPLE_CONVERSATION(im), TRUE);
purple_im_conversation_dispose(GObject *obj) {
PurpleIMConversation *im = PURPLE_IM_CONVERSATION(obj);
g_clear_pointer(&im->icon, purple_buddy_icon_unref);
G_OBJECT_CLASS(purple_im_conversation_parent_class)->dispose(obj);
purple_im_conversation_finalize(GObject *obj) {
PurpleIMConversation *im = PURPLE_IM_CONVERSATION(obj);
PurpleConnection *pc = purple_conversation_get_connection(PURPLE_CONVERSATION(im));
PurpleProtocol *protocol = NULL;
const gchar *name = purple_conversation_get_name(PURPLE_CONVERSATION(im));
protocol = purple_connection_get_protocol(pc);
if(purple_prefs_get_bool("/purple/conversations/im/send_typing")) {
purple_serv_send_typing(pc, name, PURPLE_IM_NOT_TYPING);
purple_protocol_client_iface_convo_closed(protocol, pc, name);
purple_im_conversation_stop_typing_timeout(im);
purple_im_conversation_stop_send_typed_timeout(im);
G_OBJECT_CLASS(purple_im_conversation_parent_class)->finalize(obj);
purple_im_conversation_class_init(PurpleIMConversationClass *klass) {
GObjectClass *obj_class = G_OBJECT_CLASS(klass);
PurpleConversationClass *conv_class = PURPLE_CONVERSATION_CLASS(klass);
obj_class->get_property = purple_im_conversation_get_property;
obj_class->set_property = purple_im_conversation_set_property;
obj_class->dispose = purple_im_conversation_dispose;
obj_class->finalize = purple_im_conversation_finalize;
obj_class->constructed = purple_im_conversation_constructed;
conv_class->write_message = im_conversation_write_message;
properties[PROP_TYPING_STATE] = g_param_spec_enum(
"typing-state", "Typing state",
"Status of the user's typing of a message.",
PURPLE_TYPE_IM_TYPING_STATE, PURPLE_IM_NOT_TYPING,
G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
properties[PROP_ICON] = g_param_spec_pointer(
"icon", "Buddy icon", "The buddy icon for the IM.",
G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
g_object_class_install_properties(obj_class, N_PROPERTIES, properties);
/******************************************************************************
*****************************************************************************/
purple_im_conversation_new(PurpleAccount *account, const char *name)
PurpleIMConversation *im = NULL;
g_return_val_if_fail(PURPLE_IS_ACCOUNT(account), NULL);
g_return_val_if_fail(name != NULL, NULL);
/* Check if this conversation already exists. */
if((im = purple_conversations_find_im_with_account(name, account)) != NULL) {
im = g_object_new(PURPLE_TYPE_IM_CONVERSATION,
purple_im_conversation_set_icon(PurpleIMConversation *im,
g_return_if_fail(PURPLE_IS_IM_CONVERSATION(im));
purple_buddy_icon_unref(im->icon);
im->icon = (icon == NULL) ? NULL : purple_buddy_icon_ref(icon);
g_object_notify_by_pspec(G_OBJECT(im), properties[PROP_ICON]);
purple_conversation_update(PURPLE_CONVERSATION(im),
PURPLE_CONVERSATION_UPDATE_ICON);
purple_im_conversation_get_icon(PurpleIMConversation *im) {
g_return_val_if_fail(PURPLE_IS_IM_CONVERSATION(im), NULL);
purple_im_conversation_set_typing_state(PurpleIMConversation *im,
PurpleIMTypingState state)
PurpleAccount *account = NULL;
const gchar *name = NULL;
g_return_if_fail(PURPLE_IS_IM_CONVERSATION(im));
name = purple_conversation_get_name(PURPLE_CONVERSATION(im));
account = purple_conversation_get_account(PURPLE_CONVERSATION(im));
if(im->typing_state != state) {
im->typing_state = state;
g_object_notify_by_pspec(G_OBJECT(im), properties[PROP_TYPING_STATE]);
purple_signal_emit(purple_conversations_get_handle(),
"buddy-typing", account, name);
purple_signal_emit(purple_conversations_get_handle(),
"buddy-typed", account, name);
case PURPLE_IM_NOT_TYPING:
purple_signal_emit(purple_conversations_get_handle(),
"buddy-typing-stopped", account, name);
purple_im_conversation_update_typing(im);
purple_im_conversation_get_typing_state(PurpleIMConversation *im) {
g_return_val_if_fail(PURPLE_IS_IM_CONVERSATION(im), 0);
purple_im_conversation_start_typing_timeout(PurpleIMConversation *im,
g_return_if_fail(PURPLE_IS_IM_CONVERSATION(im));
if(im->typing_timeout > 0) {
purple_im_conversation_stop_typing_timeout(im);
g_timeout_add_seconds(timeout, purple_im_conversation_reset_typing_cb,
purple_im_conversation_stop_typing_timeout(PurpleIMConversation *im) {
g_return_if_fail(PURPLE_IS_IM_CONVERSATION(im));
if(im->typing_timeout == 0) {
g_source_remove(im->typing_timeout);
purple_im_conversation_get_typing_timeout(PurpleIMConversation *im) {
g_return_val_if_fail(PURPLE_IS_IM_CONVERSATION(im), 0);
return im->typing_timeout;
purple_im_conversation_set_type_again(PurpleIMConversation *im, guint val) {
g_return_if_fail(PURPLE_IS_IM_CONVERSATION(im));
im->type_again = time(NULL) + val;
purple_im_conversation_get_type_again(PurpleIMConversation *im) {
g_return_val_if_fail(PURPLE_IS_IM_CONVERSATION(im), 0);
purple_im_conversation_start_send_typed_timeout(PurpleIMConversation *im) {
g_return_if_fail(PURPLE_IS_IM_CONVERSATION(im));
purple_im_conversation_stop_send_typed_timeout(im);
g_timeout_add_seconds(SEND_TYPED_TIMEOUT_SECONDS,
purple_im_conversation_send_typed_cb, im);
purple_im_conversation_stop_send_typed_timeout(PurpleIMConversation *im) {
g_return_if_fail(PURPLE_IS_IM_CONVERSATION(im));
if(im->send_typed_timeout == 0) {
g_source_remove(im->send_typed_timeout);
im->send_typed_timeout = 0;
purple_im_conversation_get_send_typed_timeout(PurpleIMConversation *im) {
g_return_val_if_fail(PURPLE_IS_IM_CONVERSATION(im), 0);
return im->send_typed_timeout;
purple_im_conversation_update_typing(PurpleIMConversation *im) {
g_return_if_fail(PURPLE_IS_IM_CONVERSATION(im));
purple_conversation_update(PURPLE_CONVERSATION(im),
PURPLE_CONVERSATION_UPDATE_TYPING);