[10a96f4] | 1 | /********************************************************************\ |
---|
| 2 | * BitlBee -- An IRC to other IM-networks gateway * |
---|
| 3 | * * |
---|
| 4 | * Copyright 2002-2010 Wilmer van der Gaast and others * |
---|
| 5 | \********************************************************************/ |
---|
| 6 | |
---|
| 7 | /* Stuff to handle, save and search buddies */ |
---|
| 8 | |
---|
| 9 | /* |
---|
| 10 | This program is free software; you can redistribute it and/or modify |
---|
| 11 | it under the terms of the GNU General Public License as published by |
---|
| 12 | the Free Software Foundation; either version 2 of the License, or |
---|
| 13 | (at your option) any later version. |
---|
| 14 | |
---|
| 15 | This program is distributed in the hope that it will be useful, |
---|
| 16 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
---|
| 17 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
---|
| 18 | GNU General Public License for more details. |
---|
| 19 | |
---|
| 20 | You should have received a copy of the GNU General Public License with |
---|
| 21 | the Debian GNU/Linux distribution in /usr/share/common-licenses/GPL; |
---|
| 22 | if not, write to the Free Software Foundation, Inc., 59 Temple Place, |
---|
| 23 | Suite 330, Boston, MA 02111-1307 USA |
---|
| 24 | */ |
---|
| 25 | |
---|
| 26 | #ifndef __BEE_H__ |
---|
| 27 | #define __BEE_H__ |
---|
| 28 | |
---|
| 29 | struct bee_ui_funcs; |
---|
[aea8b68] | 30 | struct groupchat; |
---|
[ebaebfe] | 31 | |
---|
| 32 | typedef struct bee |
---|
| 33 | { |
---|
| 34 | struct set *set; |
---|
| 35 | |
---|
| 36 | GSList *users; |
---|
[7aadd71] | 37 | GSList *groups; |
---|
[81e04e1] | 38 | struct account *accounts; /* TODO(wilmer): Use GSList here too? */ |
---|
[ebaebfe] | 39 | |
---|
[aea8b68] | 40 | /* Symbolic, to refer to the local user (who has no real bee_user |
---|
| 41 | object). Not to be used by anything except so far imcb_chat_add/ |
---|
| 42 | remove_buddy(). This seems slightly cleaner than abusing NULL. */ |
---|
| 43 | struct bee_user *user; |
---|
| 44 | |
---|
[10a96f4] | 45 | const struct bee_ui_funcs *ui; |
---|
[ebaebfe] | 46 | void *ui_data; |
---|
| 47 | } bee_t; |
---|
| 48 | |
---|
| 49 | bee_t *bee_new(); |
---|
| 50 | void bee_free( bee_t *b ); |
---|
[10a96f4] | 51 | |
---|
| 52 | typedef enum |
---|
| 53 | { |
---|
[e63507a] | 54 | BEE_USER_ONLINE = 1, /* Compatibility with old OPT_LOGGED_IN flag */ |
---|
| 55 | BEE_USER_AWAY = 4, /* Compatibility with old OPT_AWAY flag */ |
---|
[ad404ab] | 56 | BEE_USER_LOCAL = 256, /* Locally-added contacts (not in real contact list) */ |
---|
[10a96f4] | 57 | } bee_user_flags_t; |
---|
| 58 | |
---|
| 59 | typedef struct bee_user |
---|
| 60 | { |
---|
| 61 | struct im_connection *ic; |
---|
| 62 | char *handle; |
---|
| 63 | char *fullname; |
---|
[7aadd71] | 64 | struct bee_group *group; |
---|
[10a96f4] | 65 | |
---|
[81e04e1] | 66 | bee_user_flags_t flags; |
---|
| 67 | char *status; |
---|
[10a96f4] | 68 | char *status_msg; |
---|
| 69 | |
---|
| 70 | bee_t *bee; |
---|
| 71 | void *ui_data; |
---|
| 72 | } bee_user_t; |
---|
| 73 | |
---|
[7aadd71] | 74 | typedef struct bee_group |
---|
| 75 | { |
---|
| 76 | char *key; |
---|
| 77 | char *name; |
---|
| 78 | } bee_group_t; |
---|
| 79 | |
---|
[10a96f4] | 80 | typedef struct bee_ui_funcs |
---|
| 81 | { |
---|
| 82 | gboolean (*user_new)( bee_t *bee, struct bee_user *bu ); |
---|
| 83 | gboolean (*user_free)( bee_t *bee, struct bee_user *bu ); |
---|
[1d39159] | 84 | gboolean (*user_fullname)( bee_t *bee, bee_user_t *bu ); |
---|
[7e83e8e4] | 85 | gboolean (*user_group)( bee_t *bee, bee_user_t *bu ); |
---|
[81e04e1] | 86 | gboolean (*user_status)( bee_t *bee, struct bee_user *bu, struct bee_user *old ); |
---|
[f012a9f] | 87 | gboolean (*user_msg)( bee_t *bee, bee_user_t *bu, const char *msg, time_t sent_at ); |
---|
[573dab0] | 88 | gboolean (*user_typing)( bee_t *bee, bee_user_t *bu, guint32 flags ); |
---|
[17a6ee9] | 89 | |
---|
[aea8b68] | 90 | gboolean (*chat_new)( bee_t *bee, struct groupchat *c ); |
---|
| 91 | gboolean (*chat_free)( bee_t *bee, struct groupchat *c ); |
---|
[27e2c66] | 92 | gboolean (*chat_log)( bee_t *bee, struct groupchat *c, const char *text ); |
---|
| 93 | gboolean (*chat_msg)( bee_t *bee, struct groupchat *c, bee_user_t *bu, const char *msg, time_t sent_at ); |
---|
[aea8b68] | 94 | gboolean (*chat_add_user)( bee_t *bee, struct groupchat *c, bee_user_t *bu ); |
---|
| 95 | gboolean (*chat_remove_user)( bee_t *bee, struct groupchat *c, bee_user_t *bu ); |
---|
[9e27f18] | 96 | gboolean (*chat_topic)( bee_t *bee, struct groupchat *c, const char *new, bee_user_t *bu ); |
---|
[d343eaa] | 97 | gboolean (*chat_name_hint)( bee_t *bee, struct groupchat *c, const char *name ); |
---|
[aea8b68] | 98 | |
---|
[17a6ee9] | 99 | struct file_transfer* (*ft_in_start)( bee_t *bee, bee_user_t *bu, const char *file_name, size_t file_size ); |
---|
| 100 | gboolean (*ft_out_start)( struct im_connection *ic, struct file_transfer *ft ); |
---|
| 101 | void (*ft_close)( struct im_connection *ic, struct file_transfer *ft ); |
---|
| 102 | void (*ft_finished)( struct im_connection *ic, struct file_transfer *ft ); |
---|
[10a96f4] | 103 | } bee_ui_funcs_t; |
---|
| 104 | |
---|
| 105 | |
---|
| 106 | /* bee.c */ |
---|
| 107 | bee_t *bee_new(); |
---|
| 108 | void bee_free( bee_t *b ); |
---|
| 109 | |
---|
| 110 | /* bee_user.c */ |
---|
[ad404ab] | 111 | bee_user_t *bee_user_new( bee_t *bee, struct im_connection *ic, const char *handle, bee_user_flags_t flags ); |
---|
[eabc9d2] | 112 | int bee_user_free( bee_t *bee, bee_user_t *bu ); |
---|
[10a96f4] | 113 | bee_user_t *bee_user_by_handle( bee_t *bee, struct im_connection *ic, const char *handle ); |
---|
[d860a8d] | 114 | int bee_user_msg( bee_t *bee, bee_user_t *bu, const char *msg, int flags ); |
---|
[7aadd71] | 115 | bee_group_t *bee_group_by_name( bee_t *bee, const char *name, gboolean creat ); |
---|
| 116 | void bee_group_free( bee_t *bee ); |
---|
[d860a8d] | 117 | |
---|
| 118 | /* Callbacks from IM modules to core: */ |
---|
| 119 | /* Buddy activity */ |
---|
| 120 | /* To manipulate the status of a handle. |
---|
| 121 | * - flags can be |='d with OPT_* constants. You will need at least: |
---|
| 122 | * OPT_LOGGED_IN and OPT_AWAY. |
---|
| 123 | * - 'state' and 'message' can be NULL */ |
---|
| 124 | G_MODULE_EXPORT void imcb_buddy_status( struct im_connection *ic, const char *handle, int flags, const char *state, const char *message ); |
---|
| 125 | /* Not implemented yet! */ G_MODULE_EXPORT void imcb_buddy_times( struct im_connection *ic, const char *handle, time_t login, time_t idle ); |
---|
| 126 | /* Call when a handle says something. 'flags' and 'sent_at may be just 0. */ |
---|
[fb117aee] | 127 | G_MODULE_EXPORT void imcb_buddy_msg( struct im_connection *ic, const char *handle, char *msg, guint32 flags, time_t sent_at ); |
---|
[10a96f4] | 128 | |
---|
[aea8b68] | 129 | /* bee_chat.c */ |
---|
| 130 | #if 0 |
---|
| 131 | struct groupchat *imcb_chat_new( struct im_connection *ic, const char *handle ); |
---|
| 132 | void imcb_chat_name_hint( struct groupchat *c, const char *name ); |
---|
| 133 | void imcb_chat_free( struct groupchat *c ); |
---|
| 134 | void imcb_chat_msg( struct groupchat *c, const char *who, char *msg, uint32_t flags, time_t sent_at ); |
---|
| 135 | void imcb_chat_log( struct groupchat *c, char *format, ... ); |
---|
| 136 | void imcb_chat_topic( struct groupchat *c, char *who, char *topic, time_t set_at ); |
---|
| 137 | void imcb_chat_add_buddy( struct groupchat *b, const char *handle ); |
---|
| 138 | void imcb_chat_remove_buddy( struct groupchat *b, const char *handle, const char *reason ); |
---|
| 139 | static int remove_chat_buddy_silent( struct groupchat *b, const char *handle ); |
---|
| 140 | #endif |
---|
[a87754b] | 141 | int bee_chat_msg( bee_t *bee, struct groupchat *c, const char *msg, int flags ); |
---|
[eaaa986] | 142 | struct groupchat *bee_chat_by_title( bee_t *bee, struct im_connection *ic, const char *title ); |
---|
[aea8b68] | 143 | |
---|
[10a96f4] | 144 | #endif /* __BEE_H__ */ |
---|