source: protocols/nogaim.h @ df417ca

  /********************************************************************\
  * BitlBee -- An IRC to other IM-networks gateway                     *
  *                                                                    *
  * Copyright 2002-2004 Wilmer van der Gaast and others                *
  \********************************************************************/

/*
 * nogaim
 *
 * Gaim without gaim - for BitlBee
 *
 * This file contains functions called by the Gaim IM-modules. It contains
 * some struct and type definitions from Gaim.
 *
 * Copyright (C) 1998-1999, Mark Spencer <markster@marko.net>
 *                          (and possibly other members of the Gaim team)
 * Copyright 2002-2004 Wilmer van der Gaast <wilmer@gaast.net>
 */

/*
  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 with
  the Debian GNU/Linux distribution in /usr/share/common-licenses/GPL;
  if not, write to the Free Software Foundation, Inc., 59 Temple Place,
  Suite 330, Boston, MA  02111-1307  USA
*/

#ifndef _NOGAIM_H
#define _NOGAIM_H

#include "bitlbee.h"
#include "proxy.h"
#include "md5.h"
#include "sha.h"


#define BUF_LEN MSG_LEN
#define BUF_LONG ( BUF_LEN * 2 )
#define MSG_LEN 2048
#define BUF_LEN MSG_LEN

#define SELF_ALIAS_LEN 400
#define BUDDY_ALIAS_MAXLEN 388   /* because MSN names can be 387 characters */

#define WEBSITE "http://www.bitlbee.org/"
#define IM_FLAG_AWAY 0x0020
#define OPT_CONN_HTML 0x00000001
#define OPT_LOGGED_IN 0x00010000
#define GAIM_AWAY_CUSTOM "Custom"

/* ok. now the fun begins. first we create a connection structure */
struct gaim_connection
{
        struct prpl *prpl;
        guint32 flags;
        
        /* each connection then can have its own protocol-specific data */
        void *proto_data;
        
        /* all connections need an input watcher */
        int inpa;
        guint keepalive;
        
        /* buddy list stuff. there is still a global groups for the buddy list, but
         * we need to maintain our own set of buddies, and our own permit/deny lists */
        GSList *permit;
        GSList *deny;
        int permdeny;
        
        struct aim_user *user;
        
        char username[64];
        char displayname[128];
        char password[32];
        
        char *away;
        
        int evil;
        gboolean wants_to_die; /* defaults to FALSE */
        
        /* BitlBee */
        irc_t *irc;
        
        struct conversation *conversations;
};

/* struct buddy_chat went away and got merged with this. */
struct conversation {
        struct gaim_connection *gc;

        /* stuff used just for chat */
        GList *in_room;
        GList *ignored;
        int id;
        
        /* BitlBee */
        struct conversation *next;
        char *channel;
        char *title;
        char joined;
        void *data;
};

struct buddy {
        char name[80];
        char show[BUDDY_ALIAS_MAXLEN];
        int present;
        int evil;
        time_t signon;
        time_t idle;
        int uc;
        guint caps; /* woohoo! */
        void *proto_data; /* what a hack */
        struct gaim_connection *gc; /* the connection it belongs to */
};

struct aim_user {
        char username[64];
        char alias[SELF_ALIAS_LEN]; 
        char password[32];
        char user_info[2048];
        int options;
        struct prpl *prpl;
        /* prpls can use this to save information about the user,
         * like which server to connect to, etc */
        char proto_opt[7][256];

        struct gaim_connection *gc;
        irc_t *irc;
};

struct prpl {
        int options;
        const char *name;

        void (* login)          (struct aim_user *);
        void (* keepalive)      (struct gaim_connection *);
        void (* close)          (struct gaim_connection *);
        
        int  (* send_im)        (struct gaim_connection *, char *who, char *message, int len, int away);
        void (* set_away)       (struct gaim_connection *, char *state, char *message);
        void (* get_away)       (struct gaim_connection *, char *who);
        int  (* send_typing)    (struct gaim_connection *, char *who, int typing);
        
        void (* add_buddy)      (struct gaim_connection *, char *name);
        void (* group_buddy)    (struct gaim_connection *, char *who, char *old_group, char *new_group);
        void (* remove_buddy)   (struct gaim_connection *, char *name, char *group);
        void (* add_permit)     (struct gaim_connection *, char *name);
        void (* add_deny)       (struct gaim_connection *, char *name);
        void (* rem_permit)     (struct gaim_connection *, char *name);
        void (* rem_deny)       (struct gaim_connection *, char *name);
        void (* set_permit_deny)(struct gaim_connection *);
        
        void (* set_info)       (struct gaim_connection *, char *info);
        void (* get_info)       (struct gaim_connection *, char *who);
        void (* alias_buddy)    (struct gaim_connection *, char *who);  /* save/store buddy's alias on server list/roster */
        
        /* Group chat stuff. */
        void (* join_chat)      (struct gaim_connection *, GList *data);
        void (* chat_invite)    (struct gaim_connection *, int id, char *who, char *message);
        void (* chat_leave)     (struct gaim_connection *, int id);
        int  (* chat_send)      (struct gaim_connection *, int id, char *message);
        int  (* chat_open)      (struct gaim_connection *, char *who);
        
        /* DIE! */
        char *(* get_status_string) (struct gaim_connection *gc, int stat);
        
        GList *(* away_states)(struct gaim_connection *gc);
        
        /* Mainly for AOL, since they think "Bung hole" == "Bu ngho le". *sigh* */
        int (* cmp_buddynames) (const char *who1, const char *who2);
};

#define UC_UNAVAILABLE  1

/* JABBER */
#define UC_AWAY (0x02 | UC_UNAVAILABLE)
#define UC_CHAT  0x04
#define UC_XA   (0x08 | UC_UNAVAILABLE)
#define UC_DND  (0x10 | UC_UNAVAILABLE)

G_MODULE_EXPORT GSList *get_connections();
G_MODULE_EXPORT struct prpl *find_protocol(const char *name);
G_MODULE_EXPORT void register_protocol(struct prpl *);

/* nogaim.c */
int bim_set_away( struct gaim_connection *gc, char *away );
int bim_buddy_msg( struct gaim_connection *gc, char *handle, char *msg, int flags );
int bim_chat_msg( struct gaim_connection *gc, int id, char *msg );

void bim_add_allow( struct gaim_connection *gc, char *handle );
void bim_rem_allow( struct gaim_connection *gc, char *handle );
void bim_add_block( struct gaim_connection *gc, char *handle );
void bim_rem_block( struct gaim_connection *gc, char *handle );

void nogaim_init();
char *set_eval_away_devoice( irc_t *irc, set_t *set, char *value );

gboolean auto_reconnect( gpointer data, gint fd, b_input_condition cond );
void cancel_auto_reconnect( struct account *a );

/* multi.c */
G_MODULE_EXPORT struct gaim_connection *new_gaim_conn( struct aim_user *user );
G_MODULE_EXPORT void destroy_gaim_conn( struct gaim_connection *gc );
G_MODULE_EXPORT void set_login_progress( struct gaim_connection *gc, int step, char *msg );
G_MODULE_EXPORT void hide_login_progress( struct gaim_connection *gc, char *msg );
G_MODULE_EXPORT void hide_login_progress_error( struct gaim_connection *gc, char *msg );
G_MODULE_EXPORT void serv_got_crap( struct gaim_connection *gc, char *format, ... ) G_GNUC_PRINTF( 2, 3 );
G_MODULE_EXPORT void account_online( struct gaim_connection *gc );
G_MODULE_EXPORT void signoff( struct gaim_connection *gc );

/* dialogs.c */
G_MODULE_EXPORT void do_error_dialog( struct gaim_connection *gc, char *msg, char *title );
G_MODULE_EXPORT void do_ask_dialog( struct gaim_connection *gc, char *msg, void *data, void *doit, void *dont );

/* list.c */
G_MODULE_EXPORT void add_buddy( struct gaim_connection *gc, char *group, char *handle, char *realname );
G_MODULE_EXPORT struct buddy *find_buddy( struct gaim_connection *gc, char *handle );
G_MODULE_EXPORT void signoff_blocked( struct gaim_connection *gc );

G_MODULE_EXPORT void serv_buddy_rename( struct gaim_connection *gc, char *handle, char *realname );

/* buddy_chat.c */
G_MODULE_EXPORT void add_chat_buddy( struct conversation *b, char *handle );
G_MODULE_EXPORT void remove_chat_buddy( struct conversation *b, char *handle, char *reason );

/* prpl.c */
G_MODULE_EXPORT void show_got_added( struct gaim_connection *gc, char *handle, const char *realname );

/* server.c */                    
G_MODULE_EXPORT void serv_got_update( struct gaim_connection *gc, char *handle, int loggedin, int evil, time_t signon, time_t idle, int type, guint caps );
G_MODULE_EXPORT void serv_got_im( struct gaim_connection *gc, char *handle, char *msg, guint32 flags, time_t mtime, gint len );
G_MODULE_EXPORT void serv_got_typing( struct gaim_connection *gc, char *handle, int timeout, int type );
G_MODULE_EXPORT void serv_got_chat_invite( struct gaim_connection *gc, char *handle, char *who, char *msg, GList *data );
G_MODULE_EXPORT struct conversation *serv_got_joined_chat( struct gaim_connection *gc, int id, char *handle );
G_MODULE_EXPORT void serv_got_chat_in( struct gaim_connection *gc, int id, char *who, int whisper, char *msg, time_t mtime );
G_MODULE_EXPORT void serv_got_chat_left( struct gaim_connection *gc, int id );

struct conversation *conv_findchannel( char *channel );

#endif