account.h

Go to the documentation of this file.

/*
 *  Copyright (C) 2004-2026 Savoir-faire Linux Inc.
 *
 *  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 3 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
 *  along with this program. If not, see <https://www.gnu.org/licenses/>.
 */
#pragma once
 
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif
 
#include "client/jami_signal.h"
#include "configurationmanager_interface.h"
#include "noncopyable.h"
#include "registration_states.h"
#include "im/message_engine.h"
#include "media/media_codec.h"
#include "call_set.h"
#include "account_config.h"
#include "vcard.h"
 
#include <dhtnet/ip_utils.h>
#include <dhtnet/upnp/upnp_control.h>
 
#include <functional>
#include <string>
#include <vector>
#include <memory>
#include <map>
#include <set>
#include <random>
#include <stdexcept>
#include <mutex>
 
namespace Json {
class Value;
}
 
namespace dht {
namespace crypto {
struct Certificate;
}
} // namespace dht
 
namespace jami {
static constexpr uint64_t JAMI_ID_MAX_VAL = 9007199254740992;
constexpr static const char RINGDIR[] = "ringtones";
 
class Call;
class SystemCodecContainer;
 
class VoipLinkException : public std::runtime_error
{
public:
    VoipLinkException(const std::string& str = "")
        : std::runtime_error("VoipLinkException occurred: " + str)
    {}
};
 
class Account : public std::enable_shared_from_this<Account>
{
public:
    Account(const std::string& accountID);
 
    virtual ~Account();
 
    void hangupCalls();
 
    virtual std::unique_ptr<AccountConfig> buildConfig() const = 0;
 
    void setConfig(std::unique_ptr<AccountConfig>&& config)
    {
        std::lock_guard lock(configurationMutex_);
        config_ = std::move(config);
        loadConfig();
    }
 
    virtual void loadConfig();
 
    const AccountConfig& config() const
    {
        if (config_)
            return *config_;
        else
            throw std::runtime_error("Account doesn't have a configuration");
    }
 
    inline void editConfig(std::function<void(AccountConfig& config)>&& edit)
    {
        std::lock_guard lock(configurationMutex_);
        edit(*config_);
        saveConfig();
    }
 
    virtual void saveConfig() const;
 
    void setAccountDetails(const std::map<std::string, std::string>& details)
    {
        std::lock_guard lock(configurationMutex_);
        if (not config_)
            config_ = buildConfig();
        config_->fromMap(details);
        loadConfig();
        saveConfig();
    }
 
    std::map<std::string, std::string> getAccountDetails() const
    {
        std::lock_guard lock(configurationMutex_);
        return config().toMap();
    }
 
    virtual std::map<std::string, std::string> getVolatileAccountDetails() const;
 
    virtual std::string getFromUri() const = 0;
 
    inline const std::string& getAccountID() const { return accountID_; }
 
    virtual std::string_view getAccountType() const = 0;
 
    const std::filesystem::path& getPath() const { return idPath_; }
 
    virtual bool isIP2IP() const { return false; }
 
    virtual void doRegister() = 0;
 
    virtual void doUnregister(bool forceShutdownConnections = false) = 0;
 
    RegistrationState getRegistrationState() const { return registrationState_; }
 
    virtual std::shared_ptr<Call> newOutgoingCall(std::string_view toUrl,
                                                  const std::vector<libjami::MediaMap>& mediaList)
        = 0;
 
    virtual uint64_t sendTextMessage(const std::string& /*to*/,
                                     const std::string& /*deviceId*/,
                                     const std::map<std::string, std::string>& /*payloads*/,
                                     uint64_t /*refreshToken*/ = 0,
                                     bool /*onlyConnected*/ = false)
    {
        return 0;
    }
 
    virtual void setIsComposing(const std::string& /*conversationUri*/, bool /*isWriting*/) {};
 
    virtual bool setMessageDisplayed(const std::string& /*conversationUri*/,
                                     const std::string& /*messageId*/,
                                     int /*status*/)
    {
        return false;
    };
 
    virtual std::vector<libjami::Message> getLastMessages(const uint64_t& /*base_timestamp*/) { return {}; }
 
    virtual std::map<std::string, std::string> getNearbyPeers() const { return {}; }
 
    virtual void updateProfile(const std::string& /*displayName*/,
                               const std::string& /*avatar*/,
                               const std::string& /*fileType*/,
                               int32_t /*flag*/)
        = 0;
 
    vCard::utils::VCardData getProfileVcard() const;
 
    virtual im::MessageStatus getMessageStatus(uint64_t /*id*/) const { return im::MessageStatus::UNKNOWN; }
 
    virtual bool setPushNotificationToken(const std::string& pushDeviceToken = "")
    {
        std::lock_guard lock(configurationMutex_);
        if (config_ && config_->deviceKey != pushDeviceToken) {
            config_->deviceKey = pushDeviceToken;
            saveConfig();
            return true;
        }
        return false;
    }
 
    virtual bool setPushNotificationTopic(const std::string& topic = "")
    {
        std::lock_guard lock(configurationMutex_);
        if (config_ && config_->notificationTopic != topic) {
            config_->notificationTopic = topic;
            saveConfig();
            return true;
        }
        return false;
    }
 
    virtual bool setPushNotificationConfig(const std::map<std::string, std::string>& data);
 
    bool isEnabled() const { return config().enabled; }
 
    void setEnabled(bool enable)
    {
        config_->enabled = enable;
        // Update the UPnP controller to make sure it's in the correct state since this
        // depends on whether the account is enabled or not (in particular, we don't want
        // disabled accounts to generate UPnP activity).
        updateUpnpController();
    }
 
    bool isActive() const noexcept { return active_; }
 
    void setActive(bool active) noexcept { active_ = active; }
 
    bool isUsable() const { return config().enabled and active_; }
 
    void enableVideo(bool enable)
    {
        editConfig([&](AccountConfig& config) { config.videoEnabled = enable; });
    }
    bool isVideoEnabled() const { return config().videoEnabled; }
 
    virtual void setRegistrationState(RegistrationState state, int detail_code = 0, const std::string& detail_str = {});
 
    const std::string& getUsername() const { return config().username; }
    const std::string& getHostname() const { return config().hostname; }
    const std::string& getAlias() const { return config().alias; }
 
    static std::vector<unsigned> getDefaultCodecsId();
    static std::map<std::string, std::string> getDefaultCodecDetails(const unsigned& codecId);
 
    /* Accessor to data structures
     * @return The list that reflects the user's choice
     */
    std::vector<unsigned> getActiveCodecs(MediaType mediaType = MEDIA_ALL) const;
    bool hasActiveCodec(MediaType mediaType) const;
 
    virtual void setActiveCodecs(const std::vector<unsigned>& list);
    std::shared_ptr<SystemCodecInfo> searchCodecById(unsigned codecId, MediaType mediaType);
    std::vector<std::shared_ptr<SystemCodecInfo>> getActiveAccountCodecInfoList(MediaType mediaType) const;
    std::shared_ptr<SystemCodecInfo> searchCodecByPayload(unsigned payload, MediaType mediaType);
 
    std::filesystem::path getRingtonePath() const { return ringtonePath_; }
    bool getRingtoneEnabled() const { return config().ringtoneEnabled; }
    std::string getDisplayName() const { return config().displayName; }
    std::string getMailBox() const { return config().mailbox; }
 
    bool isRendezVous() const { return config().isRendezVous; }
    bool isAutoAnswerEnabled() const { return config().autoAnswerEnabled; }
    bool isDenySecondCallEnabled() const { return config().denySecondCallEnabled; }
    bool isReadReceiptEnabled() const { return config().sendReadReceipt; }
    bool isComposingEnabled() const { return config().sendComposing; }
 
    bool getUPnPActive() const;
 
    dhtnet::IpAddr getUPnPIpAddress() const;
 
    mutable std::mt19937_64 rand;
 
    virtual void connectivityChanged() {};
 
    virtual bool handleMessage(const std::shared_ptr<dht::crypto::Certificate>& /*cert*/,
                               const std::string& /*from*/,
                               const std::pair<std::string, std::string>& /*message*/)
    {
        return false;
    };
 
    void loadDefaultCodecs();
 
    void setCodecActive(unsigned codecId);
 
    void setCodecInactive(unsigned codecId);
 
    const std::string& getUserAgentName();
 
    std::set<std::string> getDefaultModerators() const { return config().defaultModerators; }
 
    void addDefaultModerator(const std::string& peerURI);
    void removeDefaultModerator(const std::string& peerURI);
 
    bool isLocalModeratorsEnabled() const { return config().localModeratorsEnabled; }
    bool isAllModerators() const { return config().allModeratorsEnabled; }
 
    // Enable/disable ICE for media
    bool isIceForMediaEnabled() const { return iceForMediaEnabled_; }
    void enableIceForMedia(bool enable) { iceForMediaEnabled_ = enable; }
 
    // Enable/disable generation of empty offers
    bool isEmptyOffersEnabled() const { return false; }
 
    // Check if a Daemon version (typically peer's version) satisfies the
    // minimum required version. This check is typically used to disable a
    // feature if it's not backward compatible with the peer's version.
    static bool meetMinimumRequiredVersion(const std::vector<unsigned>& jamiVersion,
                                           const std::vector<unsigned>& minRequiredVersion);
 
    // Enable/disable compliancy with RFC-5245 for component IDs format.
    // The ICE component IDs are enumerated relative to the SDP session,
    // i.e., starts from 1 and incremented for each component.
    // However, RFC-5245 requires that the ICE component IDs are enumerated
    // relative to the media stream, e.g., component IDs 1 and 2 for audio,
    // and component IDs 1 and 2 for video. This non-conformity can cause
    // inter-operability issues.
    // When the compliancy feature is enabled, the component ID in the
    // generated SDP will be compliant to RFC-5245. This feature should be
    // enabled only when the peer is compliant to RFC-5245 as well.
    // The current version is able to correctly parse both formats.
    // This feature is needed for backward compatiblity, and should be removed
    // once the  backward compatibility is no more required.
    bool isIceCompIdRfc5245Compliant() const { return iceCompIdRfc5245Compliant_; }
    void enableIceCompIdRfc5245Compliance(bool enable) { iceCompIdRfc5245Compliant_ = enable; }
    void enableAutoLoadConversations(bool enable) { autoLoadConversations_ = enable; }
 
    std::shared_ptr<Call> getCall(const std::string& callId) const { return callSet_.getCall(callId); }
    std::vector<std::string> getCallList() const { return callSet_.getCallIds(); }
    std::shared_ptr<Conference> getConference(const std::string& confId) const
    {
        return callSet_.getConference(confId);
    }
    std::vector<std::string> getConferenceList() const { return callSet_.getConferenceIds(); }
    void attach(const std::shared_ptr<Call>& call) { callSet_.add(call); }
    bool detach(const std::shared_ptr<Call>& call) { return callSet_.remove(call); }
    void attach(const std::shared_ptr<Conference>& conf) { callSet_.add(conf); }
    bool removeConference(const std::string& confId)
    {
        auto result = callSet_.removeConference(confId);
        if (result)
            emitSignal<libjami::CallSignal::ConferenceRemoved>(getAccountID(), confId);
        return result;
    }
 
public:
    // virtual methods that has to be implemented by concrete classes
    virtual void flush() { /* nothing to do here - overload */ };
 
private:
    NON_COPYABLE(Account);
 
    CallSet callSet_;
 
protected:
    virtual void updateUpnpController();
 
    std::unique_ptr<AccountConfig> config_ {};
 
    friend class ConfigurationTest;
 
    static const std::string DEFAULT_USER_AGENT;
 
    static std::string mapStateNumberToString(RegistrationState state);
 
    static std::string getDefaultUserAgent();
 
    const std::string accountID_;
 
    mutable std::recursive_mutex configurationMutex_ {};
 
    bool active_ {true};
 
    /*
     * The general, protocol neutral registration
     * state of the account
     */
    RegistrationState registrationState_ {RegistrationState::UNLOADED};
 
    std::shared_ptr<SystemCodecContainer> systemCodecContainer_;
    std::vector<std::shared_ptr<SystemCodecInfo>> accountCodecInfoList_;
 
    std::filesystem::path idPath_ {};
 
    std::filesystem::path ringtonePath_;
 
    mutable std::mutex upnp_mtx {};
    std::shared_ptr<dhtnet::upnp::Controller> upnpCtrl_;
 
    bool iceForMediaEnabled_ {true};
    bool iceCompIdRfc5245Compliant_ {false};
    bool autoLoadConversations_ {true};
 
    std::shared_ptr<SystemCodecInfo> searchCodecByName(const std::string& name, MediaType mediaType);
    std::vector<unsigned> getAccountCodecInfoIdList(MediaType mediaType) const;
    void setAllCodecsActive(MediaType mediaType, bool active);
    void sortCodec();
};
 
static inline std::ostream&
operator<<(std::ostream& os, const Account& acc)
{
    os << "[Account " << acc.getAccountID() << "] ";
    return os;
}
 
} // namespace jami