bridge.hpp 7.4 KB
Newer Older
1 2 3
#ifndef BRIDGE_INCLUDED
# define BRIDGE_INCLUDED

4
#include <irc/irc_message.hpp>
5
#include <irc/irc_client.hpp>
6
#include <bridge/colors.hpp>
7
#include <irc/irc_user.hpp>
8 9 10
#include <irc/iid.hpp>

#include <unordered_map>
11
#include <functional>
12 13 14 15 16 17
#include <string>
#include <memory>

class XmppComponent;
class Poller;

18 19 20 21 22 23 24 25
/**
 * A callback called for each IrcMessage we receive. If the message triggers
 * a response, it must send an iq and return true (in that case it is
 * removed from the list), otherwise it must do nothing and just return
 * false.
 */
typedef std::function<bool(const std::string& irc_hostname, const IrcMessage& message)> iq_responder_callback_t;

26 27 28 29 30 31 32 33 34
/**
 * One bridge is spawned for each XMPP user that uses the component.  The
 * bridge spawns IrcClients when needed (when the user wants to join a
 * channel on a new server) and does the translation between the two
 * protocols.
 */
class Bridge
{
public:
35
  explicit Bridge(const std::string& user_jid, XmppComponent* xmpp, std::shared_ptr<Poller> poller);
36
  ~Bridge();
louiz’'s avatar
louiz’ committed
37 38 39
  /**
   * QUIT all connected IRC servers.
   */
40
  void shutdown(const std::string& exit_message);
louiz’'s avatar
louiz’ committed
41 42 43 44
  /**
   * Remove all inactive IrcClients
   */
  void clean();
45 46 47 48
  /**
   * Return the jid of the XMPP user using this bridge
   */
  const std::string& get_jid() const;
49

50
  static Xmpp::body make_xmpp_body(const std::string& str);
51 52 53 54 55 56
  /***
   **
   ** From XMPP to IRC.
   **
   **/

louiz’'s avatar
louiz’ committed
57 58 59 60 61
  /**
   * Try to join an irc_channel, does nothing and return true if the channel
   * was already joined.
   */
  bool join_irc_channel(const Iid& iid, const std::string& username);
louiz’'s avatar
louiz’ committed
62
  void send_channel_message(const Iid& iid, const std::string& body);
louiz’'s avatar
louiz’ committed
63
  void send_private_message(const Iid& iid, const std::string& body, const std::string& type="PRIVMSG");
louiz’'s avatar
louiz’ committed
64
  void leave_irc_channel(Iid&& iid, std::string&& status_message);
louiz’'s avatar
louiz’ committed
65
  void send_irc_nick_change(const Iid& iid, const std::string& new_nick);
66 67
  void send_irc_kick(const Iid& iid, const std::string& target, const std::string& reason,
                     const std::string& iq_id, const std::string& to_jid);
68
  void set_channel_topic(const Iid& iid, const std::string& subject);
louiz’'s avatar
louiz’ committed
69
  void send_xmpp_version_to_irc(const Iid& iid, const std::string& name, const std::string& version, const std::string& os);
70 71 72 73 74 75 76 77 78 79 80 81 82 83 84

  /***
   **
   ** From IRC to XMPP.
   **
   **/

  /**
   * Send a message corresponding to a server NOTICE, the from attribute
   * should be juste the server hostname@irc.component.
   */
  void send_xmpp_message(const std::string& from, const std::string& author, const std::string& msg);
  /**
   * Send the presence of a new user in the MUC.
   */
85 86
  void send_user_join(const std::string& hostname,
                      const std::string& chan_name,
87
                      const IrcUser* user,
88
                      const char user_mode,
89
                      const bool self);
90 91 92 93
  /**
   * Send the topic of the MUC to the user
   */
  void send_topic(const std::string& hostname, const std::string& chan_name, const std::string topic);
louiz’'s avatar
louiz’ committed
94 95 96
  /**
   * Send a MUC message from some participant
   */
louiz’'s avatar
louiz’ committed
97
  void send_message(const Iid& iid, const std::string& nick, const std::string& body, const bool muc);
98 99 100 101 102
  /**
   * Send a presence of type error, from a room. This is used to indicate
   * why joining a room failed.
   */
  void send_join_failed(const Iid& iid, const std::string& nick, const std::string& type, const std::string& condition, const std::string& text);
louiz’'s avatar
louiz’ committed
103 104 105
  /**
   * Send an unavailable presence from this participant
   */
louiz’'s avatar
louiz’ committed
106 107 108
  void send_muc_leave(Iid&& iid, std::string&& nick, const std::string& message, const bool self);
  /**
   * Send presences to indicate that an user old_nick (ourself if self ==
109 110 111
   * true) changed his nick to new_nick.  The user_mode is needed because
   * the xmpp presence needs ton contain the role and affiliation of the
   * user.
louiz’'s avatar
louiz’ committed
112
   */
113 114 115 116 117
  void send_nick_change(Iid&& iid,
                        const std::string& old_nick,
                        const std::string& new_nick,
                        const char user_mode,
                        const bool self);
118
  void kick_muc_user(Iid&& iid, const std::string& target, const std::string& reason, const std::string& author);
119
  void send_nickname_conflict_error(const Iid& iid, const std::string& nickname);
120 121 122 123
  /**
   * Send a role/affiliation change, matching the change of mode for that user
   */
  void send_affiliation_role_change(const Iid& iid, const std::string& target, const char mode);
124
  /**
louiz’'s avatar
louiz’ committed
125
   * Send an iq version request coming from nick!hostname@
126 127
   */
  void send_iq_version_request(const std::string& nick, const std::string& hostname);
louiz’'s avatar
louiz’ committed
128 129 130 131 132

  /**
   * Misc
   */
  std::string get_own_nick(const Iid& iid);
louiz’'s avatar
louiz’ committed
133
  /**
134
   * Get the number of server to which this bridge is connected or connecting.
louiz’'s avatar
louiz’ committed
135
   */
136
  size_t active_clients() const;
137 138 139 140 141 142 143 144
  /**
   * Add (or replace the existing) <nick, jid> into the preferred_user_from map
   */
  void set_preferred_from_jid(const std::string& nick, const std::string& full_jid);
  /**
   * Remove the preferred jid for the given IRC nick
   */
  void remove_preferred_from_jid(const std::string& nick);
145 146 147 148 149 150 151 152 153 154
  /**
   * Add a callback to the waiting iq list.
   */
  void add_waiting_iq(iq_responder_callback_t&& callback);
  /**
   * Iter over all the waiting_iq, call the iq_responder_filter_t for each,
   * whenever one of them returns true: call the corresponding
   * iq_responder_callback_t and remove the callback from the list.
   */
  void trigger_response_iq(const std::string& irc_hostname, const IrcMessage& message);
louiz’'s avatar
louiz’ committed
155

156 157 158 159 160 161 162
private:
  /**
   * Returns the client for the given hostname, create one (and use the
   * username in this case) if none is found, and connect that newly-created
   * client immediately.
   */
  IrcClient* get_irc_client(const std::string& hostname, const std::string& username);
louiz’'s avatar
louiz’ committed
163 164 165 166 167
  /**
   * This version does not create the IrcClient if it does not exist, and
   * returns nullptr in that case
   */
  IrcClient* get_irc_client(const std::string& hostname);
168 169 170 171
  /**
   * The JID of the user associated with this bridge. Messages from/to this
   * JID are only managed by this bridge.
   */
172
  const std::string user_jid;
173 174 175 176 177 178 179 180 181 182 183 184 185 186 187
  /**
   * One IrcClient for each IRC server we need to be connected to.
   * The pointer is shared by the bridge and the poller.
   */
  std::unordered_map<std::string, std::shared_ptr<IrcClient>> irc_clients;
  /**
   * A raw pointer, because we do not own it, the XMPP component owns us,
   * but we still need to communicate with it, when sending messages from
   * IRC to XMPP.
   */
  XmppComponent* xmpp;
  /**
   * Poller, to give it the IrcClients that we spawn, to make it manage
   * their sockets.
   */
188
  std::shared_ptr<Poller> poller;
189 190 191 192 193 194 195 196
  /**
   * A map of <nick, full_jid>. For example if this map contains <"toto",
   * "#somechan%server@biboumi/ToTo">, whenever a private message is
   * received from the user "toto", instead of forwarding it to XMPP with
   * from='toto!server@biboumi', we use instead
   * from='#somechan%server@biboumi/ToTo'
   */
  std::unordered_map<std::string, std::string> preferred_user_from;
197 198 199 200 201 202 203
  /**
   * A list of callbacks that are waiting for some IrcMessage to trigger a
   * response.  We add callbacks in this list whenever we received an IQ
   * request and we need a response from IRC to be able to provide the
   * response iq.
   */
  std::list<iq_responder_callback_t> waiting_iq;
204 205 206 207 208 209 210 211

  Bridge(const Bridge&) = delete;
  Bridge(Bridge&& other) = delete;
  Bridge& operator=(const Bridge&) = delete;
  Bridge& operator=(Bridge&&) = delete;
};

#endif // BRIDGE_INCLUDED