Line data    Source code

       1             : /*
       2             :  *  Copyright (C) 2004-2026 Savoir-faire Linux Inc.
       3             :  *
       4             :  *  This program is free software: you can redistribute it and/or modify
       5             :  *  it under the terms of the GNU General Public License as published by
       6             :  *  the Free Software Foundation, either version 3 of the License, or
       7             :  *  (at your option) any later version.
       8             :  *
       9             :  *  This program is distributed in the hope that it will be useful,
      10             :  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
      11             :  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
      12             :  *  GNU General Public License for more details.
      13             :  *
      14             :  *  You should have received a copy of the GNU General Public License
      15             :  *  along with this program. If not, see <https://www.gnu.org/licenses/>.
      16             :  */
      17             : #pragma once
      18             : 
      19             : #include <string>
      20             : #include <map>
      21             : #include <stdexcept>
      22             : 
      23             : #ifdef HAVE_CONFIG_H
      24             : #include "config.h"
      25             : #endif
      26             : 
      27             : extern "C" {
      28             : struct pjsip_inv_session;
      29             : struct pjsip_rx_data;
      30             : struct pjsip_msg;
      31             : struct pjsip_tx_data;
      32             : }
      33             : 
      34             : namespace jami {
      35             : namespace im {
      36             : 
      37             : struct InstantMessageException : std::runtime_error
      38             : {
      39           0 :     InstantMessageException(const std::string& str = "")
      40           0 :         : std::runtime_error("InstantMessageException occurred: " + str)
      41           0 :     {}
      42             : };
      43             : 
      44             : /**
      45             :  * Constructs and sends a SIP message.
      46             :  *
      47             :  * The expected format of the map key is:
      48             :  *     type/subtype[; *[; arg=value]]
      49             :  *     eg: "text/plain; id=1234;part=2;of=1001"
      50             :  *     note: all whitespace is optional
      51             :  *
      52             :  * If the map contains more than one pair, then a multipart/mixed message type will be created
      53             :  * containing multiple message parts. Note that all of the message parts must be able to fit into
      54             :  * one message... they will not be split into multiple messages.
      55             :  *
      56             :  * @param session SIP session
      57             :  * @param payloads a map where the mime type and optional parameters are the key
      58             :  *                 and the message payload is the value
      59             :  *
      60             :  * Exception: throw InstantMessageException if no message sent
      61             :  */
      62             : void sendSipMessage(pjsip_inv_session* session, const std::map<std::string, std::string>& payloads);
      63             : 
      64             : /**
      65             :  * Parses given SIP message into a map where the key is the contents of the Content-Type header
      66             :  * (along with any parameters) and the value is the message payload.
      67             :  *
      68             :  * @param msg received SIP message
      69             :  *
      70             :  * @return map of content types and message payloads
      71             :  */
      72             : std::map<std::string, std::string> parseSipMessage(const pjsip_msg* msg);
      73             : 
      74             : void fillPJSIPMessageBody(pjsip_tx_data& tdata, const std::map<std::string, std::string>& payloads);
      75             : 
      76             : } // namespace im
      77             : } // namespace jami