jamipluginmanager.h

Go to the documentation of this file.

/*
 *  Copyright (C) 2004-2025 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
 
#include "noncopyable.h"
#include "plugin/webviewservicesmanager.h"
#include "pluginmanager.h"
#include "pluginpreferencesutils.h"
 
#include "callservicesmanager.h"
#include "chatservicesmanager.h"
#include "preferenceservicesmanager.h"
#include <opendht/crypto.h>
#include <vector>
#include <map>
#include <list>
#include <algorithm>
 
namespace jami {
 
using PreferencesMap = std::map<std::string, std::map<std::string, std::string>>;
 
class JamiPluginManager
{
public:
    JamiPluginManager();
 
    std::string getPluginAuthor(const std::string& rootPath, const std::string& pluginId);
 
    std::map<std::string, std::string> getPluginDetails(const std::string& rootPath, bool reset = false);
 
    std::vector<std::string> getInstalledPlugins();
 
    bool checkPluginCertificateValidity(dht::crypto::Certificate* cert);
 
    bool checkPluginCertificatePublicKey(const std::string& oldJplPath, const std::string& newJplPath);
 
    bool checkPluginSignatureFile(const std::string& jplPath);
 
    bool checkPluginSignatureValidity(const std::string& jplPath, dht::crypto::Certificate* cert);
 
    bool checkPluginSignature(const std::string& jplPath, dht::crypto::Certificate* cert);
 
    std::unique_ptr<dht::crypto::Certificate> checkPluginCertificate(const std::string& jplPath, bool force);
 
    int installPlugin(const std::string& jplPath, bool force);
 
    int uninstallPlugin(const std::string& rootPath);
 
    bool loadPlugin(const std::string& rootPath);
 
    bool loadPlugins();
 
    bool unloadPlugin(const std::string& rootPath);
 
    std::vector<std::string> getLoadedPlugins() const;
 
    std::vector<std::map<std::string, std::string>> getPluginPreferences(
        const std::string& rootPath, const std::string& accountId);
 
    std::map<std::string, std::string> getPluginPreferencesValuesMap(const std::string& rootPath,
                                                                     const std::string& accountId);
 
    std::map<std::string, std::string> getPlatformInfo();
 
    bool setPluginPreference(const std::filesystem::path& rootPath,
                             const std::string& accountId,
                             const std::string& key,
                             const std::string& value);
 
    bool resetPluginPreferencesValuesMap(const std::string& rootPath, const std::string& accountId);
 
    CallServicesManager& getCallServicesManager() { return callsm_; }
 
    ChatServicesManager& getChatServicesManager() { return chatsm_; }
 
    WebViewServicesManager& getWebViewServicesManager() { return webviewsm_; }
 
    PreferenceServicesManager& getPreferenceServicesManager() { return preferencesm_; }
 
#ifdef LIBJAMI_TEST
    void addPluginAuthority(const dht::crypto::Certificate& cert);
#endif
 
private:
    NON_COPYABLE(JamiPluginManager);
 
    void registerServices();
 
    // PluginManager instance
    PluginManager pm_;
    dht::crypto::TrustList trust_;
    // Map between plugins installation path and manifest infos.
    std::map<std::string, std::map<std::string, std::string>> pluginDetailsMap_;
 
    // Services instances
    CallServicesManager callsm_;
    ChatServicesManager chatsm_;
    WebViewServicesManager webviewsm_;
    PreferenceServicesManager preferencesm_;
};
} // namespace jami