source: protocols/bee.h @ a08b2db

Last change on this file since a08b2db was a08b2db, checked in by dequis <dx@…>, at 2016-10-16T06:51:53Z

Rename bee_chat_list_finish() to imcb_chat_list_finish()

bee_chat_list_finish is still available as a deprecated function but it
will be removed before the next stable release

It has never been part of any release, just keeping it for a while for
the sake of being polite to the users of the discord plugin who may be
using the experimental chat list branch.

  • Property mode set to 100644
File size: 9.1 KB
RevLine 
[5ebff60]1/********************************************************************\
[10a96f4]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;
[6f10697]22  if not, write to the Free Software Foundation, Inc., 51 Franklin St.,
23  Fifth Floor, Boston, MA  02110-1301  USA
[10a96f4]24*/
25
26#ifndef __BEE_H__
27#define __BEE_H__
28
29struct bee_ui_funcs;
[aea8b68]30struct groupchat;
[ebaebfe]31
[5ebff60]32typedef struct bee {
[f6f5eee]33        /* Settings. See set.h for how these work. The UI can add its
34           own settings here. */
[ebaebfe]35        struct set *set;
[5ebff60]36
[f6f5eee]37        GSList *users;  /* struct bee_user */
38        GSList *groups; /* struct bee_group */
[81e04e1]39        struct account *accounts; /* TODO(wilmer): Use GSList here too? */
[5ebff60]40
[aea8b68]41        /* Symbolic, to refer to the local user (who has no real bee_user
42           object). Not to be used by anything except so far imcb_chat_add/
[f6f5eee]43           remove_buddy(). */
[aea8b68]44        struct bee_user *user;
[5ebff60]45
[f6f5eee]46        /* Fill in the callbacks for events you care about. */
[10a96f4]47        const struct bee_ui_funcs *ui;
[5ebff60]48
[f6f5eee]49        /* And this one will be passed to every callback for any state the
50           UI may want to keep. */
[ebaebfe]51        void *ui_data;
52} bee_t;
53
54bee_t *bee_new();
[5ebff60]55void bee_free(bee_t *b);
[10a96f4]56
[0ebf919]57/* TODO(wilmer): Kill at least the OPT_ flags that have an equivalent here. */
[5ebff60]58typedef enum {
[e63507a]59        BEE_USER_ONLINE = 1,    /* Compatibility with old OPT_LOGGED_IN flag */
60        BEE_USER_AWAY = 4,      /* Compatibility with old OPT_AWAY flag */
[0ebf919]61        BEE_USER_MOBILE = 8,    /* Compatibility with old OPT_MOBILE flag */
[ad404ab]62        BEE_USER_LOCAL = 256,   /* Locally-added contacts (not in real contact list) */
[7b8238d]63        BEE_USER_SPECIAL = 512, /* Denotes a user as being special */
[09f7ec1]64        BEE_USER_NOOTR = 4096,  /* Per-user version of OPT_NOOTR */
[10a96f4]65} bee_user_flags_t;
66
[5ebff60]67typedef struct bee_user {
[10a96f4]68        struct im_connection *ic;
69        char *handle;
70        char *fullname;
[69b896b]71        char *nick;
[7aadd71]72        struct bee_group *group;
[10a96f4]73
[81e04e1]74        bee_user_flags_t flags;
[f6f5eee]75        char *status;     /* NULL means available, anything else is an away state. */
76        char *status_msg; /* Status and/or away message. */
[5ebff60]77
[f6f5eee]78        /* Set using imcb_buddy_times(). */
[56699f0]79        time_t login_time, idle_time;
[5ebff60]80
[10a96f4]81        bee_t *bee;
82        void *ui_data;
[203a2d2]83        void *data; /* Can be used by the IM module. */
[10a96f4]84} bee_user_t;
85
[a33ee0f]86typedef struct bee_chat_info {
87        char *title;
88        char *topic;
89} bee_chat_info_t;
90
[f6f5eee]91/* This one's mostly used so save space and make it easier (cheaper) to
92   compare groups of contacts, etc. */
[5ebff60]93typedef struct bee_group {
[f6f5eee]94        char *key;  /* Lower case version of the name. */
[7aadd71]95        char *name;
96} bee_group_t;
97
[5ebff60]98typedef struct bee_ui_funcs {
99        void (*imc_connected)(struct im_connection *ic);
100        void (*imc_disconnected)(struct im_connection *ic);
101
102        gboolean (*user_new)(bee_t *bee, struct bee_user *bu);
103        gboolean (*user_free)(bee_t *bee, struct bee_user *bu);
[f6f5eee]104        /* Set the fullname first, then call this one to notify the UI. */
[5ebff60]105        gboolean (*user_fullname)(bee_t *bee, bee_user_t *bu);
106        gboolean (*user_nick_hint)(bee_t *bee, bee_user_t *bu, const char *hint);
[f6f5eee]107        /* Notify the UI when an existing user is moved between groups. */
[5ebff60]108        gboolean (*user_group)(bee_t *bee, bee_user_t *bu);
[f6f5eee]109        /* State info is already updated, old is provided in case the UI needs a diff. */
[5ebff60]110        gboolean (*user_status)(bee_t *bee, struct bee_user *bu, struct bee_user *old);
[f6f5eee]111        /* On every incoming message. sent_at = 0 means unknown. */
[345577b]112        gboolean (*user_msg)(bee_t *bee, bee_user_t *bu, const char *msg, guint32 flags, time_t sent_at);
[f6f5eee]113        /* Flags currently defined (OPT_TYPING/THINKING) in nogaim.h. */
[5ebff60]114        gboolean (*user_typing)(bee_t *bee, bee_user_t *bu, guint32 flags);
[d88c92a]115        /* CTCP-like stuff (buddy action) response */
[5ebff60]116        gboolean (*user_action_response)(bee_t *bee, bee_user_t *bu, const char *action, char * const args[],
117                                         void *data);
118
[f6f5eee]119        /* Called at creation time. Don't show to the user until s/he is
120           added using chat_add_user().  UI state can be stored via c->data. */
[5ebff60]121        gboolean (*chat_new)(bee_t *bee, struct groupchat *c);
122        gboolean (*chat_free)(bee_t *bee, struct groupchat *c);
[f6f5eee]123        /* System messages of any kind. */
[5ebff60]124        gboolean (*chat_log)(bee_t *bee, struct groupchat *c, const char *text);
[345577b]125        gboolean (*chat_msg)(bee_t *bee, struct groupchat *c, bee_user_t *bu, const char *msg, guint32 flags, time_t sent_at);
[5ebff60]126        gboolean (*chat_add_user)(bee_t *bee, struct groupchat *c, bee_user_t *bu);
[6b56512]127        gboolean (*chat_remove_user)(bee_t *bee, struct groupchat *c, bee_user_t *bu, const char *reason);
[5ebff60]128        gboolean (*chat_topic)(bee_t *bee, struct groupchat *c, const char *new_topic, bee_user_t *bu);
129        gboolean (*chat_name_hint)(bee_t *bee, struct groupchat *c, const char *name);
130        gboolean (*chat_invite)(bee_t *bee, bee_user_t *bu, const char *name, const char *msg);
131
132        struct file_transfer* (*ft_in_start)(bee_t * bee, bee_user_t * bu, const char *file_name, size_t file_size);
133        gboolean (*ft_out_start)(struct im_connection *ic, struct file_transfer *ft);
134        void (*ft_close)(struct im_connection *ic, struct file_transfer *ft);
135        void (*ft_finished)(struct im_connection *ic, struct file_transfer *ft);
[03df717]136
137        void (*log)(bee_t *bee, const char *tag, const char *msg);
[a42fda4]138        gboolean (*user_nick_change)(bee_t *bee, bee_user_t *bu, const char *hint);
[10a96f4]139} bee_ui_funcs_t;
140
141
142/* bee.c */
143bee_t *bee_new();
[5ebff60]144void bee_free(bee_t *b);
[10a96f4]145
146/* bee_user.c */
[5ebff60]147bee_user_t *bee_user_new(bee_t *bee, struct im_connection *ic, const char *handle, bee_user_flags_t flags);
148int bee_user_free(bee_t *bee, bee_user_t *bu);
149bee_user_t *bee_user_by_handle(bee_t *bee, struct im_connection *ic, const char *handle);
150int bee_user_msg(bee_t *bee, bee_user_t *bu, const char *msg, int flags);
151bee_group_t *bee_group_by_name(bee_t *bee, const char *name, gboolean creat);
152void bee_group_free(bee_t *bee);
[d860a8d]153
154/* Callbacks from IM modules to core: */
155/* Buddy activity */
156/* To manipulate the status of a handle.
157 * - flags can be |='d with OPT_* constants. You will need at least:
158 *   OPT_LOGGED_IN and OPT_AWAY.
159 * - 'state' and 'message' can be NULL */
[5ebff60]160G_MODULE_EXPORT void imcb_buddy_status(struct im_connection *ic, const char *handle, int flags, const char *state,
161                                       const char *message);
162G_MODULE_EXPORT void imcb_buddy_status_msg(struct im_connection *ic, const char *handle, const char *message);
163G_MODULE_EXPORT void imcb_buddy_times(struct im_connection *ic, const char *handle, time_t login, time_t idle);
[d860a8d]164/* Call when a handle says something. 'flags' and 'sent_at may be just 0. */
[ce70e88]165G_MODULE_EXPORT void imcb_buddy_msg(struct im_connection *ic, const char *handle, const char *msg, guint32 flags,
[5ebff60]166                                    time_t sent_at);
[0864a52]167G_MODULE_EXPORT void imcb_notify_email(struct im_connection *ic, char *format, ...) G_GNUC_PRINTF(2, 3);
[10a96f4]168
[aea8b68]169/* bee_chat.c */
[f6f5eee]170/* These two functions are to create a group chat.
171 * - imcb_chat_new(): the 'handle' parameter identifies the chat, like the
172 *   channel name on IRC.
[5ebff60]173 * - After you have a groupchat pointer, you should add the handles, finally
[f6f5eee]174 *   the user her/himself. At that point the group chat will be visible to the
175 *   user, too. */
[5ebff60]176G_MODULE_EXPORT struct groupchat *imcb_chat_new(struct im_connection *ic, const char *handle);
177G_MODULE_EXPORT void imcb_chat_name_hint(struct groupchat *c, const char *name);
178G_MODULE_EXPORT void imcb_chat_free(struct groupchat *c);
[f6f5eee]179/* To tell BitlBee 'who' said 'msg' in 'c'. 'flags' and 'sent_at' can be 0. */
[5ebff60]180G_MODULE_EXPORT void imcb_chat_msg(struct groupchat *c, const char *who, char *msg, guint32 flags, time_t sent_at);
[f6f5eee]181/* System messages specific to a groupchat, so they can be displayed in the right context. */
[5ebff60]182G_MODULE_EXPORT void imcb_chat_log(struct groupchat *c, char *format, ...);
[f6f5eee]183/* To tell BitlBee 'who' changed the topic of 'c' to 'topic'. */
[5ebff60]184G_MODULE_EXPORT void imcb_chat_topic(struct groupchat *c, char *who, char *topic, time_t set_at);
185G_MODULE_EXPORT void imcb_chat_add_buddy(struct groupchat *c, const char *handle);
[f6f5eee]186/* To remove a handle from a group chat. Reason can be NULL. */
[5ebff60]187G_MODULE_EXPORT void imcb_chat_remove_buddy(struct groupchat *c, const char *handle, const char *reason);
188G_MODULE_EXPORT int bee_chat_msg(bee_t *bee, struct groupchat *c, const char *msg, int flags);
189G_MODULE_EXPORT struct groupchat *bee_chat_by_title(bee_t *bee, struct im_connection *ic, const char *title);
190G_MODULE_EXPORT void imcb_chat_invite(struct im_connection *ic, const char *name, const char *who, const char *msg);
[aea8b68]191
[a08b2db]192G_GNUC_DEPRECATED G_MODULE_EXPORT void bee_chat_list_finish(struct im_connection *ic);
193G_MODULE_EXPORT void imcb_chat_list_finish(struct im_connection *ic);
[a33ee0f]194
[10a96f4]195#endif /* __BEE_H__ */
Note: See TracBrowser for help on using the repository browser.