pidgin/pidgin

facebook: Prevent disconnections on 509 errors, "Invalid attachment id"

2016-10-22, dequis
955dcca1ac3d
facebook: Prevent disconnections on 509 errors, "Invalid attachment id"

I'm still not sure about the origin of these errors (I suspect it's a
race condition between servers), but it's going to be fixed properly in
the future when the sync protocol is updated and doing HTTP requests to
get the attachment URL is no longer required (newer orca versions only
do HTTP requests to get the url of file attachments, everything else is
included in the MQTT stream)
/*
* 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_PRESENCE_H_
#define _PURPLE_PRESENCE_H_
/**
* SECTION:presence
* @section_id: libpurple-presence
* @short_description: <filename>presence.h</filename>
* @title: Presence Objects API
*
* This file contains the presence base type, account presence, and buddy
* presence API.
*/
#define PURPLE_TYPE_PRESENCE (purple_presence_get_type())
#define PURPLE_PRESENCE(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj), PURPLE_TYPE_PRESENCE, PurplePresence))
#define PURPLE_PRESENCE_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST((klass), PURPLE_TYPE_PRESENCE, PurplePresenceClass))
#define PURPLE_IS_PRESENCE(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj), PURPLE_TYPE_PRESENCE))
#define PURPLE_IS_PRESENCE_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass), PURPLE_TYPE_PRESENCE))
#define PURPLE_PRESENCE_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS((obj), PURPLE_TYPE_PRESENCE, PurplePresenceClass))
typedef struct _PurplePresence PurplePresence;
typedef struct _PurplePresenceClass PurplePresenceClass;
#define PURPLE_TYPE_ACCOUNT_PRESENCE (purple_account_presence_get_type())
#define PURPLE_ACCOUNT_PRESENCE(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj), PURPLE_TYPE_ACCOUNT_PRESENCE, PurpleAccountPresence))
#define PURPLE_ACCOUNT_PRESENCE_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST((klass), PURPLE_TYPE_ACCOUNT_PRESENCE, PurpleAccountPresenceClass))
#define PURPLE_IS_ACCOUNT_PRESENCE(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj), PURPLE_TYPE_ACCOUNT_PRESENCE))
#define PURPLE_IS_ACCOUNT_PRESENCE_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass), PURPLE_TYPE_ACCOUNT_PRESENCE))
#define PURPLE_ACCOUNT_PRESENCE_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS((obj), PURPLE_TYPE_ACCOUNT_PRESENCE, PurpleAccountPresenceClass))
typedef struct _PurpleAccountPresence PurpleAccountPresence;
typedef struct _PurpleAccountPresenceClass PurpleAccountPresenceClass;
#define PURPLE_TYPE_BUDDY_PRESENCE (purple_buddy_presence_get_type())
#define PURPLE_BUDDY_PRESENCE(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj), PURPLE_TYPE_BUDDY_PRESENCE, PurpleBuddyPresence))
#define PURPLE_BUDDY_PRESENCE_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST((klass), PURPLE_TYPE_BUDDY_PRESENCE, PurpleBuddyPresenceClass))
#define PURPLE_IS_BUDDY_PRESENCE(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj), PURPLE_TYPE_BUDDY_PRESENCE))
#define PURPLE_IS_BUDDY_PRESENCE_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass), PURPLE_TYPE_BUDDY_PRESENCE))
#define PURPLE_BUDDY_PRESENCE_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS((obj), PURPLE_TYPE_BUDDY_PRESENCE, PurpleBuddyPresenceClass))
typedef struct _PurpleBuddyPresence PurpleBuddyPresence;
typedef struct _PurpleBuddyPresenceClass PurpleBuddyPresenceClass;
#include "account.h"
#include "buddylist.h"
#include "status.h"
/**
* PurplePresence:
*
* A PurplePresence is like a collection of PurpleStatuses (plus some
* other random info). For any buddy, or for any one of your accounts,
* or for any person with which you're chatting, you may know various
* amounts of information. This information is all contained in
* one PurplePresence. If one of your buddies is away and idle,
* then the presence contains the PurpleStatus for their awayness,
* and it contains their current idle time. PurplePresences are
* never saved to disk. The information they contain is only relevant
* for the current PurpleSession.
*
* Note: When a presence is destroyed with the last g_object_unref(), all
* statuses added to this list will be destroyed along with the presence.
*/
struct _PurplePresence
{
GObject gparent;
};
/**
* PurplePresenceClass:
* @update_idle: Updates the logs and the UI when the idle state or time of the
* presence changes.
*
* Base class for all #PurplePresence's
*/
struct _PurplePresenceClass {
GObjectClass parent_class;
void (*update_idle)(PurplePresence *presence, gboolean old_idle);
/*< private >*/
void (*_purple_reserved1)(void);
void (*_purple_reserved2)(void);
void (*_purple_reserved3)(void);
void (*_purple_reserved4)(void);
};
/**
* PurpleAccountPresence:
*
* A presence for an account
*/
struct _PurpleAccountPresence
{
PurplePresence parent;
};
/**
* PurpleAccountPresenceClass:
*
* Base class for all #PurpleAccountPresence's
*/
struct _PurpleAccountPresenceClass {
PurplePresenceClass parent_class;
/*< private >*/
void (*_purple_reserved1)(void);
void (*_purple_reserved2)(void);
void (*_purple_reserved3)(void);
void (*_purple_reserved4)(void);
};
/**
* PurpleBuddyPresence:
*
* A presence for a buddy
*/
struct _PurpleBuddyPresence
{
PurplePresence parent;
};
/**
* PurpleBuddyPresenceClass:
*
* Base class for all #PurpleBuddyPresence's
*/
struct _PurpleBuddyPresenceClass {
PurplePresenceClass parent_class;
/*< private >*/
void (*_purple_reserved1)(void);
void (*_purple_reserved2)(void);
void (*_purple_reserved3)(void);
void (*_purple_reserved4)(void);
};
G_BEGIN_DECLS
/**************************************************************************/
/* PurpleAccountPresence API */
/**************************************************************************/
/**
* purple_account_presence_get_type:
*
* Returns: The #GType for the #PurpleAccountPresence object.
*/
GType purple_account_presence_get_type(void);
/**
* purple_account_presence_new:
* @account: The account to associate with the presence.
*
* Creates a presence for an account.
*
* Returns: The new presence.
*/
PurpleAccountPresence *purple_account_presence_new(PurpleAccount *account);
/**
* purple_account_presence_get_account:
* @presence: The presence.
*
* Returns an account presence's account.
*
* Returns: The presence's account.
*/
PurpleAccount *purple_account_presence_get_account(const PurpleAccountPresence *presence);
/**************************************************************************/
/* PurpleBuddyPresence API */
/**************************************************************************/
/**
* purple_buddy_presence_get_type:
*
* Returns: The #GType for the #PurpleBuddyPresence object.
*/
GType purple_buddy_presence_get_type(void);
/**
* purple_buddy_presence_new:
* @buddy: The buddy to associate with the presence.
*
* Creates a presence for a buddy.
*
* Returns: The new presence.
*/
PurpleBuddyPresence *purple_buddy_presence_new(PurpleBuddy *buddy);
/**
* purple_buddy_presence_get_buddy:
* @presence: The presence.
*
* Returns the buddy presence's buddy.
*
* Returns: The presence's buddy.
*/
PurpleBuddy *purple_buddy_presence_get_buddy(const PurpleBuddyPresence *presence);
/**
* purple_buddy_presence_compare:
* @buddy_presence1: The first presence.
* @buddy_presence2: The second presence.
*
* Compares two buddy presences for availability.
*
* Returns: -1 if @buddy_presence1 is more available than @buddy_presence2.
* 0 if @buddy_presence1 is equal to @buddy_presence2.
* 1 if @buddy_presence1 is less available than @buddy_presence2.
*/
gint purple_buddy_presence_compare(const PurpleBuddyPresence *buddy_presence1,
const PurpleBuddyPresence *buddy_presence2);
/**************************************************************************/
/* PurplePresence API */
/**************************************************************************/
/**
* purple_presence_get_type:
*
* Returns: The #GType for the #PurplePresence object.
*/
GType purple_presence_get_type(void);
/**
* purple_presence_set_status_active:
* @presence: The presence.
* @status_id: The ID of the status.
* @active: The active state.
*
* Sets the active state of a status in a presence.
*
* Only independent statuses can be set unactive. Normal statuses can only
* be set active, so if you wish to disable a status, set another
* non-independent status to active, or use purple_presence_switch_status().
*/
void purple_presence_set_status_active(PurplePresence *presence,
const char *status_id, gboolean active);
/**
* purple_presence_switch_status:
* @presence: The presence.
* @status_id: The status ID to switch to.
*
* Switches the active status in a presence.
*
* This is similar to purple_presence_set_status_active(), except it won't
* activate independent statuses.
*/
void purple_presence_switch_status(PurplePresence *presence,
const char *status_id);
/**
* purple_presence_set_idle:
* @presence: The presence.
* @idle: The idle state.
* @idle_time: The idle time, if @idle is TRUE. This
* is the time at which the user became idle,
* in seconds since the epoch. If this value is
* unknown then 0 should be used.
*
* Sets the idle state and time on a presence.
*/
void purple_presence_set_idle(PurplePresence *presence, gboolean idle,
time_t idle_time);
/**
* purple_presence_set_login_time:
* @presence: The presence.
* @login_time: The login time.
*
* Sets the login time on a presence.
*/
void purple_presence_set_login_time(PurplePresence *presence, time_t login_time);
/**
* purple_presence_get_statuses:
* @presence: The presence.
*
* Returns all the statuses in a presence.
*
* Returns: (transfer none): The statuses.
*/
GList *purple_presence_get_statuses(const PurplePresence *presence);
/**
* purple_presence_get_status:
* @presence: The presence.
* @status_id: The ID of the status.
*
* Returns the status with the specified ID from a presence.
*
* Returns: The status if found, or NULL.
*/
PurpleStatus *purple_presence_get_status(const PurplePresence *presence,
const char *status_id);
/**
* purple_presence_get_active_status:
* @presence: The presence.
*
* Returns the active exclusive status from a presence.
*
* Returns: The active exclusive status.
*/
PurpleStatus *purple_presence_get_active_status(const PurplePresence *presence);
/**
* purple_presence_is_available:
* @presence: The presence.
*
* Returns whether or not a presence is available.
*
* Available presences are online and possibly invisible, but not away or idle.
*
* Returns: TRUE if the presence is available, or FALSE otherwise.
*/
gboolean purple_presence_is_available(const PurplePresence *presence);
/**
* purple_presence_is_online:
* @presence: The presence.
*
* Returns whether or not a presence is online.
*
* Returns: TRUE if the presence is online, or FALSE otherwise.
*/
gboolean purple_presence_is_online(const PurplePresence *presence);
/**
* purple_presence_is_status_active:
* @presence: The presence.
* @status_id: The ID of the status.
*
* Returns whether or not a status in a presence is active.
*
* A status is active if itself or any of its sub-statuses are active.
*
* Returns: TRUE if the status is active, or FALSE.
*/
gboolean purple_presence_is_status_active(const PurplePresence *presence,
const char *status_id);
/**
* purple_presence_is_status_primitive_active:
* @presence: The presence.
* @primitive: The status primitive.
*
* Returns whether or not a status with the specified primitive type
* in a presence is active.
*
* A status is active if itself or any of its sub-statuses are active.
*
* Returns: TRUE if the status is active, or FALSE.
*/
gboolean purple_presence_is_status_primitive_active(
const PurplePresence *presence, PurpleStatusPrimitive primitive);
/**
* purple_presence_is_idle:
* @presence: The presence.
*
* Returns whether or not a presence is idle.
*
* Returns: TRUE if the presence is idle, or FALSE otherwise.
* If the presence is offline (purple_presence_is_online()
* returns FALSE) then FALSE is returned.
*/
gboolean purple_presence_is_idle(const PurplePresence *presence);
/**
* purple_presence_get_idle_time:
* @presence: The presence.
*
* Returns the presence's idle time.
*
* Returns: The presence's idle time.
*/
time_t purple_presence_get_idle_time(const PurplePresence *presence);
/**
* purple_presence_get_login_time:
* @presence: The presence.
*
* Returns the presence's login time.
*
* Returns: The presence's login time.
*/
time_t purple_presence_get_login_time(const PurplePresence *presence);
G_END_DECLS
#endif /* _PURPLE_PRESENCE_H_ */