#include <conversation_module.h>

Collaboration diagram for jami::ConversationModule:

Classes
class	Impl

Public Member Functions
void	acceptConversationRequest (const std::string &conversationId, const std::string &deviceId="")
	Accept a conversation's request.

void	addCallHistoryMessage (const std::string &uri, uint64_t duration_ms, const std::string &reason)
	Add to the related conversation the call history message.

void	addConversationMember (const std::string &conversationId, const dht::InfoHash &contactUri, bool sendRequest=true)
	Adds a new member to a conversation (this will triggers a member event + new message on success)

void	addConvInfo (const ConvInfo &info)

void	addGitSocket (std::string_view deviceId, std::string_view convId, const std::shared_ptr< dhtnet::ChannelSocket > &channel)

void	addSwarmChannel (const std::string &conversationId, std::shared_ptr< dhtnet::ChannelSocket > socket)
	Add a swarm connection.

void	bootstrap (const std::string &convId="")
	Bootstrap swarm managers to other peers.

std::shared_ptr< SIPCall >	call (const std::string &url, const std::vector< libjami::MediaMap > &mediaList, std::function< void(const std::string &, const DeviceId &, const std::shared_ptr< SIPCall > &)> &&cb)
	Call the conversation.

void	clearCache (const std::string &conversationId)
	Clear loaded interactions.

void	clearPendingFetch ()
	Clear not removed fetch.

void	cloneConversationFrom (const std::string &conversationId, const std::string &uri, const std::string &oldConvId="")
	Clone conversation from a member.

void	connectivityChanged ()
	Triggers a bucket maintainance for DRTs.

std::map< std::string, std::string >	conversationInfos (const std::string &conversationId) const

	ConversationModule (std::shared_ptr< JamiAccount > account, std::shared_ptr< AccountManager > accountManager, NeedsSyncingCb &&needsSyncingCb, SengMsgCb &&sendMsgCb, NeedSocketCb &&onNeedSocket, NeedSocketCb &&onNeedSwarmSocket, OneToOneRecvCb &&oneToOneRecvCb, bool autoLoadConversations=true)

std::vector< uint8_t >	conversationVCard (const std::string &conversationId) const

std::map< std::string, std::map< std::string, std::map< std::string, std::string > > >	convMessageStatus () const

std::map< std::string, std::map< std::string, std::string > >	convPreferences () const
	Retrieve all conversation preferences to sync with other devices.

uint32_t	countInteractions (const std::string &convId, const std::string &toId, const std::string &fromId, const std::string &authorUri) const
	Retrieve the number of interactions from interactionId to HEAD.

std::shared_ptr< TransferManager >	dataTransfer (const std::string &id) const
	Returns related transfer manager.

void	declineConversationRequest (const std::string &conversationId)
	Decline a conversation's request.

bool	downloadFile (const std::string &conversationId, const std::string &interactionId, const std::string &fileId, const std::string &path)
	Ask conversation's members to send a file to this device.

void	editMessage (const std::string &conversationId, const std::string &newBody, const std::string &editedId)

void	fetchNewCommits (const std::string &peer, const std::string &deviceId, const std::string &conversationId, const std::string &commitId)
	Launch fetch on new commit.

std::string	findMatchingOneToOneConversation (const std::string &excludedConversationId, const std::set< std::string > &targetUris) const
	Search for an existing one-to-one conversation that exactly matches the given set of member URIs.

std::vector< std::map< std::string, std::string > >	getActiveCalls (const std::string &conversationId) const
	Return active calls.

std::shared_ptr< Conversation >	getConversation (const std::string &convId)
	Get a conversation.

std::vector< std::map< std::string, std::string > >	getConversationMembers (const std::string &conversationId, bool includeBanned=false) const
	Get members.

std::map< std::string, std::string >	getConversationPreferences (const std::string &conversationId, bool includeCreated=false) const

std::vector< std::map< std::string, std::string > >	getConversationRequests () const
	Return conversation's requests.

std::vector< std::string >	getConversations () const
	Return all conversation's id (including syncing ones)

std::string	getOneToOneConversation (const std::string &uri) const noexcept
	Get related conversation with member.

std::shared_ptr< Typers >	getTypers (const std::string &convId)
	Get Typers object for a conversation.

std::shared_ptr< dhtnet::ChannelSocket >	gitSocket (std::string_view deviceId, std::string_view convId) const
	Return current git socket used for a conversation.

void	hostConference (const std::string &conversationId, const std::string &confId, const std::string &callId, const std::vector< libjami::MediaMap > &mediaList={})

void	initPresence ()

bool	isBanned (const std::string &convId, const std::string &uri) const
	Return if a device or member is banned from a conversation.

bool	isHosting (const std::string &conversationId, const std::string &confId) const
	Check if we're hosting a specific conference.

uint32_t	loadConversation (const std::string &conversationId, const std::string &fromMessage="", size_t n=0)
	Load conversation's messages.

void	loadConversations ()
	Refresh information about conversations.

void	loadSingleConversation (const std::string &convId)

uint32_t	loadSwarmUntil (const std::string &conversationId, const std::string &fromMessage, const std::string &toMessage)

void	monitor ()

bool	needsSyncingWith (const std::string &memberUri) const
	Check if we need to share infos with a contact.

void	onConversationRequest (const std::string &from, const Json::Value &value)
	Called when receiving a new conversation's request.

bool	onFileChannelRequest (const std::string &conversationId, const std::string &member, const std::string &fileId, bool verifyShaSum=true) const
	Choose if we can accept channel request.

bool	onMessageDisplayed (const std::string &peer, const std::string &conversationId, const std::string &interactionId)

void	onNeedConversationRequest (const std::string &from, const std::string &conversationId)
	Called when a peer needs an invite for a conversation (generally after that they received a commit notification for a conversation they don't have yet)

void	onSyncData (const SyncMsg &msg, const std::string &peerId, const std::string &deviceId)
	Detect new conversations and request from other devices.

void	onTrustRequest (const std::string &uri, const std::string &conversationId, const std::vector< uint8_t > &payload, time_t received)
	Called when detecting a new trust request with linked one to one.

std::string	peerFromConversationRequest (const std::string &convId) const
	Retrieve author of a conversation request.

void	reactToMessage (const std::string &conversationId, const std::string &newBody, const std::string &reactToId)

void	reloadRequests ()
	Reload requests from file.

void	removeContact (const std::string &uri, bool ban)
	Remove one to one conversations related to a contact.

bool	removeConversation (const std::string &conversationId)
	Remove a conversation, but not the contact.

void	removeConversationMember (const std::string &conversationId, const dht::InfoHash &contactUri, bool isDevice=false)
	Remove a member from a conversation (this will trigger a member event + new message on success)

void	removeGitSocket (std::string_view deviceId, std::string_view convId)

void	search (uint32_t req, const std::string &convId, const Filter &filter) const
	Search in conversations via a filter.

void	sendMessage (const std::string &conversationId, Json::Value &&value, const std::string &replyTo="", bool announce=true, OnCommitCb &&onCommit={}, OnDoneCb &&cb={})

void	sendMessage (const std::string &conversationId, std::string message, const std::string &replyTo="", const std::string &type="text/plain", bool announce=true, OnCommitCb &&onCommit={}, OnDoneCb &&cb={})

void	setAccountManager (std::shared_ptr< AccountManager > accountManager)

void	setConversationPreferences (const std::string &conversationId, const std::map< std::string, std::string > &prefs)
	Update user's preferences (like color, notifications, etc) to be synced across devices.

void	setFetched (const std::string &conversationId, const std::string &deviceId, const std::string &commit)
	Notify that a peer fetched a commit.

void	shutdownConnections ()
	Clear all connection (swarm channels)

std::string	startConversation (ConversationMode mode=ConversationMode::INVITES_ONLY, const dht::InfoHash &otherMember={})
	Starts a new conversation.

void	syncConversations (const std::string &peer, const std::string &deviceId)
	Sync conversations with detected peer.

void	updateConversationInfos (const std::string &conversationId, const std::map< std::string, std::string > &infos, bool sync=true)
	Update metadatas from conversations (like title, avatar, etc)

bool	updateConvForContact (const std::string &uri, const std::string &oldConv, const std::string &newConv)
	Replace linked conversation in contact's details.

	~ConversationModule ()=default

Static Public Member Functions
static std::map< std::string, ConvInfo >	convInfos (const std::string &accountId)

static std::map< std::string, ConvInfo >	convInfosFromPath (const std::filesystem::path &path)

static std::map< std::string, ConversationRequest >	convRequests (const std::string &accountId)

static std::map< std::string, ConversationRequest >	convRequestsFromPath (const std::filesystem::path &path)

static void	saveConvInfos (const std::string &accountId, const std::map< std::string, ConvInfo > &conversations)

static void	saveConvInfosToPath (const std::filesystem::path &path, const std::map< std::string, ConvInfo > &conversations)

static void	saveConvRequests (const std::string &accountId, const std::map< std::string, ConversationRequest > &conversationsRequests)

static void	saveConvRequestsToPath (const std::filesystem::path &path, const std::map< std::string, ConversationRequest > &conversationsRequests)

Detailed Description

Definition at line 67 of file conversation_module.h.

Constructor & Destructor Documentation

◆ ConversationModule()

jami::ConversationModule::ConversationModule	(	std::shared_ptr< JamiAccount >	account,
		std::shared_ptr< AccountManager >	accountManager,
		NeedsSyncingCb &&	needsSyncingCb,
		SengMsgCb &&	sendMsgCb,
		NeedSocketCb &&	onNeedSocket,
		NeedSocketCb &&	onNeedSwarmSocket,
		OneToOneRecvCb &&	oneToOneRecvCb,
		bool	autoLoadConversations = `true`
	)

Definition at line 1553 of file conversation_module.cpp.

References jami::emitSignal(), and loadConversations().

Here is the call graph for this function:

◆ ~ConversationModule()

jami::ConversationModule::~ConversationModule ( )

default

Member Function Documentation

◆ acceptConversationRequest()

void jami::ConversationModule::acceptConversationRequest	(	const std::string &	conversationId,
		const std::string &	deviceId = `""`
	)

Accept a conversation's request.

Parameters

convId
deviceId	If a trust request is accepted from a device (can help to sync)

Definition at line 2057 of file conversation_module.cpp.

References jami::emitSignal(), and JAMI_WARNING.

Here is the call graph for this function:

◆ addCallHistoryMessage()

void jami::ConversationModule::addCallHistoryMessage	(	const std::string &	uri,
		uint64_t	duration_ms,
		const std::string &	reason
	)

Add to the related conversation the call history message.

Parameters

uri	Peer number
duration_ms	The call duration in ms
reason

Definition at line 2208 of file conversation_module.cpp.

References jami::emitSignal(), getOneToOneConversation(), and sendMessage().

Here is the call graph for this function:

◆ addConversationMember()

void jami::ConversationModule::addConversationMember	(	const std::string &	conversationId,
		const dht::InfoHash &	contactUri,
		bool	sendRequest = `true`
	)

Adds a new member to a conversation (this will triggers a member event + new message on success)

Parameters

conversationId
contactUri
sendRequest	If we need to inform the peer (used for tests)

Definition at line 2576 of file conversation_module.cpp.

References jami::emitSignal(), JAMI_DEBUG, and JAMI_ERROR.

Here is the call graph for this function:

◆ addConvInfo()

void jami::ConversationModule::addConvInfo ( const ConvInfo & info )

Definition at line 3280 of file conversation_module.cpp.

Referenced by jami::ConversationModule::Impl::cloneConversation(), jami::ConversationModule::Impl::cloneConversationFrom(), jami::ConversationModule::Impl::handlePendingConversation(), onSyncData(), jami::ConversationModule::Impl::removeConversationImpl(), jami::ConversationModule::Impl::removeRepositoryImpl(), and startConversation().

◆ addGitSocket()

void jami::ConversationModule::addGitSocket	(	std::string_view	deviceId,
		std::string_view	convId,
		const std::shared_ptr< dhtnet::ChannelSocket > &	channel
	)

Definition at line 3319 of file conversation_module.cpp.

References JAMI_WARNING.

◆ addSwarmChannel()

void jami::ConversationModule::addSwarmChannel	(	const std::string &	conversationId,
		std::shared_ptr< dhtnet::ChannelSocket >	socket
	)

Add a swarm connection.

Parameters

conversationId
socket

Definition at line 3348 of file conversation_module.cpp.

◆ bootstrap()

void jami::ConversationModule::bootstrap ( const std::string & convId = "" )

Bootstrap swarm managers to other peers.

Definition at line 1869 of file conversation_module.cpp.

References jami::emitSignal().

Here is the call graph for this function:

◆ call()

std::shared_ptr< SIPCall > jami::ConversationModule::call	(	const std::string &	url,
		const std::vector< libjami::MediaMap > &	mediaList,
		std::function< void(const std::string &, const DeviceId &, const std::shared_ptr< SIPCall > &)> &&	cb
	)

Call the conversation.

Parameters

url	Url to call (swarm:conversation or swarm:conv/account/device/conf to join)
mediaList	The media list
cb	Callback to pass which device to call (called in the same thread)

Returns: call if a call is started, else nullptr

Definition at line 3020 of file conversation_module.cpp.

References call(), jami::Manager::callFactory, jami::Call::DISCONNECTED, jami::emitSignal(), jami::CallFactory::getNewCallID(), hostConference(), jami::Manager::instance(), JAMI_DEBUG, JAMI_ERROR, jami::MediaAttribute::mediaAttributesToMediaMaps(), jami::Call::MERROR, jami::Call::OUTGOING, jami::split_string(), and jami::Call::TRYING.

Referenced by call().

Here is the call graph for this function:

◆ clearCache()

void jami::ConversationModule::clearCache ( const std::string & conversationId )

Clear loaded interactions.

Parameters

conversationId

Definition at line 2252 of file conversation_module.cpp.

References jami::emitSignal().

Here is the call graph for this function:

◆ clearPendingFetch()

void jami::ConversationModule::clearPendingFetch ( )

Clear not removed fetch.

Definition at line 1882 of file conversation_module.cpp.

References jami::emitSignal(), and JAMI_ERR.

Here is the call graph for this function:

◆ cloneConversationFrom()

void jami::ConversationModule::cloneConversationFrom	(	const std::string &	conversationId,
		const std::string &	uri,
		const std::string &	oldConvId = `""`
	)

Clone conversation from a member.

Note: used to clone an old conversation after deleting/re-adding a contact

Parameters

conversationId
uri
oldConvId

Definition at line 2155 of file conversation_module.cpp.

References jami::emitSignal().

Referenced by jami::ConversationModule::Impl::bootstrap(), jami::ConversationModule::Impl::fallbackClone(), and onSyncData().

Here is the call graph for this function:

◆ connectivityChanged()

void jami::ConversationModule::connectivityChanged ( )

Triggers a bucket maintainance for DRTs.

Definition at line 3354 of file conversation_module.cpp.

◆ conversationInfos()

std::map< std::string, std::string > jami::ConversationModule::conversationInfos ( const std::string & conversationId ) const

Definition at line 2696 of file conversation_module.cpp.

References jami::emitSignal(), and JAMI_ERROR.

Here is the call graph for this function:

◆ conversationVCard()

std::vector< uint8_t > jami::ConversationModule::conversationVCard ( const std::string & conversationId ) const

Definition at line 2771 of file conversation_module.cpp.

References jami::emitSignal(), and JAMI_ERROR.

Here is the call graph for this function:

◆ convInfos()

std::map< std::string, ConvInfo > jami::ConversationModule::convInfos ( const std::string & accountId )

static

Definition at line 3232 of file conversation_module.cpp.

Referenced by loadConversations(), loadSingleConversation(), and jami::SyncModule::Impl::syncInfos().

◆ convInfosFromPath()

std::map< std::string, ConvInfo > jami::ConversationModule::convInfosFromPath ( const std::filesystem::path & path )

static

Definition at line 3238 of file conversation_module.cpp.

References JAMI_WARN.

◆ convMessageStatus()

std::map< std::string, std::map< std::string, std::map< std::string, std::string > > > jami::ConversationModule::convMessageStatus ( ) const

Definition at line 2240 of file conversation_module.cpp.

References jami::emitSignal().

Here is the call graph for this function:

◆ convPreferences()

std::map< std::string, std::map< std::string, std::string > > jami::ConversationModule::convPreferences ( ) const

Retrieve all conversation preferences to sync with other devices.

Definition at line 2759 of file conversation_module.cpp.

References jami::emitSignal().

Here is the call graph for this function:

◆ convRequests()

std::map< std::string, ConversationRequest > jami::ConversationModule::convRequests ( const std::string & accountId )

static

Definition at line 3256 of file conversation_module.cpp.

Referenced by jami::ConversationModule::Impl::Impl(), reloadRequests(), and jami::SyncModule::Impl::syncInfos().

◆ convRequestsFromPath()

std::map< std::string, ConversationRequest > jami::ConversationModule::convRequestsFromPath ( const std::filesystem::path & path )

static

Definition at line 3262 of file conversation_module.cpp.

References JAMI_WARN.

◆ countInteractions()

uint32_t jami::ConversationModule::countInteractions	(	const std::string &	convId,
		const std::string &	toId,
		const std::string &	fromId,
		const std::string &	authorUri
	)		const

Retrieve the number of interactions from interactionId to HEAD.

Parameters

convId
interactionId	"" for getting the whole history
authorUri	Stop when detect author

Returns: number of interactions since interactionId

Definition at line 2640 of file conversation_module.cpp.

References jami::emitSignal().

Here is the call graph for this function:

◆ dataTransfer()

std::shared_ptr< TransferManager > jami::ConversationModule::dataTransfer ( const std::string & id ) const

Returns related transfer manager.

Parameters

id	Conversation's id

Returns: nullptr if not found, else the manager

Definition at line 2310 of file conversation_module.cpp.

◆ declineConversationRequest()

void jami::ConversationModule::declineConversationRequest ( const std::string & conversationId )

Decline a conversation's request.

Parameters

convId

Definition at line 2084 of file conversation_module.cpp.

References jami::emitSignal().

Here is the call graph for this function:

◆ downloadFile()

bool jami::ConversationModule::downloadFile	(	const std::string &	conversationId,
		const std::string &	interactionId,
		const std::string &	fileId,
		const std::string &	path
	)

Ask conversation's members to send a file to this device.

Parameters

conversationId	Related conversation
interactionId	Related interaction
fileId	Related fileId
path	where to download the file

Definition at line 2356 of file conversation_module.cpp.

References jami::emitSignal().

Here is the call graph for this function:

◆ editMessage()

void jami::ConversationModule::editMessage	(	const std::string &	conversationId,
		const std::string &	newBody,
		const std::string &	editedId
	)

Definition at line 2187 of file conversation_module.cpp.

References jami::emitSignal().

Here is the call graph for this function:

◆ fetchNewCommits()

void jami::ConversationModule::fetchNewCommits	(	const std::string &	peer,
		const std::string &	deviceId,
		const std::string &	conversationId,
		const std::string &	commitId
	)

Launch fetch on new commit.

Parameters

peer	Who sent the notification
deviceId	Who sent the notification
conversationId	Related conversation
commitId	Commit to retrieve

Definition at line 2567 of file conversation_module.cpp.

References jami::emitSignal().

Here is the call graph for this function:

◆ findMatchingOneToOneConversation()

std::string jami::ConversationModule::findMatchingOneToOneConversation	(	const std::string &	excludedConversationId,
		const std::set< std::string > &	targetUris
	)		const

Search for an existing one-to-one conversation that exactly matches the given set of member URIs.

Parameters

excludedConversationId	Conversation ID to be ignored during the search.
targetUris	The set of member URIs that must match exactly.

Returns: The ID of the matching conversation if found, otherwise an empty string.

Definition at line 2968 of file conversation_module.cpp.

References jami::emitSignal(), and jami::ONE_TO_ONE.

Referenced by removeConversation().

Here is the call graph for this function:

◆ getActiveCalls()

std::vector< std::map< std::string, std::string > > jami::ConversationModule::getActiveCalls ( const std::string & conversationId ) const

Return active calls.

Parameters

convId Which conversation to choose

Returns: {{"id":id}, {"uri":uri}, {"device":device}}

Definition at line 3013 of file conversation_module.cpp.

◆ getConversation()

std::shared_ptr< Conversation > jami::ConversationModule::getConversation ( const std::string & convId )

Get a conversation.

Parameters

convId

Definition at line 3296 of file conversation_module.cpp.

Referenced by jami::ConversationModule::Impl::bootstrap(), jami::ConversationModule::Impl::editMessage(), jami::ConversationModule::Impl::fallbackClone(), jami::ConversationModule::Impl::fetchNewCommits(), jami::ConversationModule::Impl::handlePendingConversation(), jami::ConversationModule::Impl::removeRepository(), jami::ConversationModule::Impl::sendMessage(), and jami::ConversationModule::Impl::sendMessageNotification().

◆ getConversationMembers()

std::vector< std::map< std::string, std::string > > jami::ConversationModule::getConversationMembers	(	const std::string &	conversationId,
		bool	includeBanned = `false`
	)		const

Get members.

Parameters

conversationId
includeBanned

Returns: a map of members with their role and details

Definition at line 2634 of file conversation_module.cpp.

References jami::emitSignal().

Referenced by jami::ConversationModule::Impl::fallbackClone(), and onSyncData().

Here is the call graph for this function:

◆ getConversationPreferences()

std::map< std::string, std::string > jami::ConversationModule::getConversationPreferences	(	const std::string &	conversationId,
		bool	includeCreated = `false`
	)		const

Definition at line 2748 of file conversation_module.cpp.

References jami::emitSignal().

Here is the call graph for this function:

◆ getConversationRequests()

std::vector< std::map< std::string, std::string > > jami::ConversationModule::getConversationRequests ( ) const

Return conversation's requests.

Definition at line 1933 of file conversation_module.cpp.

References jami::emitSignal().

Here is the call graph for this function:

◆ getConversations()

std::vector< std::string > jami::ConversationModule::getConversations ( ) const

Return all conversation's id (including syncing ones)

Definition at line 1907 of file conversation_module.cpp.

References jami::emitSignal().

Referenced by jami::ConversationModule::Impl::onBuddyOnline().

Here is the call graph for this function:

◆ getOneToOneConversation()

std::string jami::ConversationModule::getOneToOneConversation ( const std::string & uri ) const

noexcept

Get related conversation with member.

Parameters

uri	The member to search for

Returns: the conversation id if found else empty

Definition at line 1921 of file conversation_module.cpp.

Referenced by addCallHistoryMessage(), removeContact(), jami::ConversationModule::Impl::removeRepositoryImpl(), and jami::ConversationModule::Impl::updateConvForContact().

◆ getTypers()

std::shared_ptr< Typers > jami::ConversationModule::getTypers ( const std::string & convId )

Get Typers object for a conversation.

Parameters

convId

Returns: the Typer object

Definition at line 3361 of file conversation_module.cpp.

◆ gitSocket()

std::shared_ptr< dhtnet::ChannelSocket > jami::ConversationModule::gitSocket	(	std::string_view	deviceId,
		std::string_view	convId
	)		const

Return current git socket used for a conversation.

Parameters

deviceId	Related device
conversationId	Related conversation

Returns: the related socket

Definition at line 3306 of file conversation_module.cpp.

◆ hostConference()

void jami::ConversationModule::hostConference	(	const std::string &	conversationId,
		const std::string &	confId,
		const std::string &	callId,
		const std::vector< libjami::MediaMap > &	mediaList = `{}`
	)

Definition at line 3133 of file conversation_module.cpp.

References JAMI_ERROR, and JAMI_WARNING.

Referenced by call().

◆ initPresence()

void jami::ConversationModule::initPresence ( )

Definition at line 3372 of file conversation_module.cpp.

◆ isBanned()

bool jami::ConversationModule::isBanned	(	const std::string &	convId,
		const std::string &	uri
	)		const

Return if a device or member is banned from a conversation.

Parameters

convId
uri

Definition at line 2783 of file conversation_module.cpp.

References jami::emitSignal(), and jami::ONE_TO_ONE.

Here is the call graph for this function:

◆ isHosting()

bool jami::ConversationModule::isHosting	(	const std::string &	conversationId,
		const std::string &	confId
	)		const

Check if we're hosting a specific conference.

Parameters

conversationId	(empty to search all conv)
confId

Returns: true if hosting this conference

Definition at line 2994 of file conversation_module.cpp.

References jami::emitSignal().

Here is the call graph for this function:

◆ loadConversation()

uint32_t jami::ConversationModule::loadConversation	(	const std::string &	conversationId,
		const std::string &	fromMessage = `""`,
		size_t	n = `0`
	)

Load conversation's messages.

Parameters

conversationId	Conversation to load
fromMessage
n	Max interactions to load

Returns: id of the operation

Definition at line 2263 of file conversation_module.cpp.

References jami::emitSignal(), and jami::LogOptions::from.

Here is the call graph for this function:

◆ loadConversations()

void jami::ConversationModule::loadConversations ( )

Refresh information about conversations.

Definition at line 1592 of file conversation_module.cpp.

References _, convInfos(), jami::emitSignal(), jami::fileutils::get_data_dir(), jami::ConvInfo::id, JAMI_ERROR, JAMI_LOG, JAMI_WARNING, jami::ConversationMapKeys::LAST_DISPLAYED, and jami::ONE_TO_ONE.

Referenced by ConversationModule().

Here is the call graph for this function:

◆ loadSingleConversation()

void jami::ConversationModule::loadSingleConversation ( const std::string & convId )

Definition at line 1810 of file conversation_module.cpp.

References convInfos(), jami::emitSignal(), jami::fileutils::get_data_dir(), JAMI_LOG, and JAMI_WARNING.

Here is the call graph for this function:

◆ loadSwarmUntil()

uint32_t jami::ConversationModule::loadSwarmUntil	(	const std::string &	conversationId,
		const std::string &	fromMessage,
		const std::string &	toMessage
	)

Definition at line 2285 of file conversation_module.cpp.

References jami::emitSignal(), and jami::LogOptions::from.

Here is the call graph for this function:

◆ monitor()

void jami::ConversationModule::monitor ( )

Definition at line 1875 of file conversation_module.cpp.

References jami::emitSignal().

Here is the call graph for this function:

◆ needsSyncingWith()

bool jami::ConversationModule::needsSyncingWith ( const std::string & memberUri ) const

Check if we need to share infos with a contact.

Parameters

memberUri
deviceId

Definition at line 2532 of file conversation_module.cpp.

References jami::emitSignal().

Here is the call graph for this function:

◆ onConversationRequest()

void jami::ConversationModule::onConversationRequest	(	const std::string &	from,
		const Json::Value &	value
	)

Called when receiving a new conversation's request.

Parameters

from	Sender
value	Conversation's request

Definition at line 1985 of file conversation_module.cpp.

References jami::ConversationRequest::conversationId, jami::emitSignal(), jami::ConversationRequest::from, jami::ConversationRequest::isOneToOne(), JAMI_DEBUG, JAMI_LOG, jami::ConversationRequest::received, jami::ConversationRequest::toMap(), and updateConvForContact().

Here is the call graph for this function:

◆ onFileChannelRequest()

bool jami::ConversationModule::onFileChannelRequest	(	const std::string &	conversationId,
		const std::string &	member,
		const std::string &	fileId,
		bool	verifyShaSum = `true`
	)		const

Choose if we can accept channel request.

Parameters

member	Member to check
fileId	File transfer to check (needs to be waiting)
verifyShaSum	For debug only

Returns: if we accept the channel request

Definition at line 2316 of file conversation_module.cpp.

References jami::emitSignal(), JAMI_WARNING, and jami::fileutils::sha3File().

Here is the call graph for this function:

◆ onMessageDisplayed()

bool jami::ConversationModule::onMessageDisplayed	(	const std::string &	peer,
		const std::string &	conversationId,
		const std::string &	interactionId
	)

Definition at line 2225 of file conversation_module.cpp.

References jami::emitSignal().

Here is the call graph for this function:

◆ onNeedConversationRequest()

void jami::ConversationModule::onNeedConversationRequest	(	const std::string &	from,
		const std::string &	conversationId
	)

Called when a peer needs an invite for a conversation (generally after that they received a commit notification for a conversation they don't have yet)

Parameters

from
conversationId

Definition at line 2044 of file conversation_module.cpp.

References JAMI_LOG.

◆ onSyncData()

void jami::ConversationModule::onSyncData	(	const SyncMsg &	msg,
		const std::string &	peerId,
		const std::string &	deviceId
	)

Detect new conversations and request from other devices.

Parameters

msg	Received data
peerId	Sender
deviceId

Definition at line 2397 of file conversation_module.cpp.

References addConvInfo(), cloneConversationFrom(), jami::emitSignal(), getConversationMembers(), JAMI_DEBUG, JAMI_LOG, and JAMI_WARNING.

Here is the call graph for this function:

◆ onTrustRequest()

void jami::ConversationModule::onTrustRequest	(	const std::string &	uri,
		const std::string &	conversationId,
		const std::vector< uint8_t > &	payload,
		time_t	received
	)

Called when detecting a new trust request with linked one to one.

Parameters

uri	Sender's URI
conversationId	Related conversation's id
payload	VCard
received	Received time

Definition at line 1947 of file conversation_module.cpp.

References jami::ConversationRequest::conversationId, jami::emitSignal(), jami::ConversationRequest::from, jami::ConversationRepository::infosFromVCard(), JAMI_DEBUG, JAMI_LOG, jami::ConversationRequest::metadatas, jami::ConversationRequest::received, jami::ConversationRequest::toMap(), jami::vCard::utils::toMap(), and updateConvForContact().

Here is the call graph for this function:

◆ peerFromConversationRequest()

std::string jami::ConversationModule::peerFromConversationRequest ( const std::string & convId ) const

Retrieve author of a conversation request.

Parameters

convId Conversation's id

Returns: the author of the conversation request

Definition at line 2033 of file conversation_module.cpp.

References jami::emitSignal().

Here is the call graph for this function:

◆ reactToMessage()

void jami::ConversationModule::reactToMessage	(	const std::string &	conversationId,
		const std::string &	newBody,
		const std::string &	reactToId
	)

Definition at line 2195 of file conversation_module.cpp.

References jami::emitSignal().

Here is the call graph for this function:

◆ reloadRequests()

void jami::ConversationModule::reloadRequests ( )

Reload requests from file.

Definition at line 1901 of file conversation_module.cpp.

References convRequests().

Here is the call graph for this function:

◆ removeContact()

void jami::ConversationModule::removeContact	(	const std::string &	uri,
		bool	ban
	)

Remove one to one conversations related to a contact.

Parameters

uri	Of the contact
ban	If banned

Definition at line 2803 of file conversation_module.cpp.

References jami::emitSignal(), getOneToOneConversation(), JAMI_DEBUG, JAMI_WARN, and jami::ONE_TO_ONE.

Here is the call graph for this function:

◆ removeConversation()

bool jami::ConversationModule::removeConversation ( const std::string & conversationId )

Remove a conversation, but not the contact.

Parameters

conversationId

Returns: if successfully removed

Definition at line 2875 of file conversation_module.cpp.

References jami::emitSignal(), findMatchingOneToOneConversation(), JAMI_LOG, jami::ONE_TO_ONE, and startConversation().

Referenced by jami::ConversationModule::Impl::fixStructures(), and jami::ConversationModule::Impl::handlePendingConversation().

Here is the call graph for this function:

◆ removeConversationMember()

void jami::ConversationModule::removeConversationMember	(	const std::string &	conversationId,
		const dht::InfoHash &	contactUri,
		bool	isDevice = `false`
	)

Remove a member from a conversation (this will trigger a member event + new message on success)

Parameters

conversationId
contactUri
isDevice

Definition at line 2616 of file conversation_module.cpp.

References jami::emitSignal().

Here is the call graph for this function:

◆ removeGitSocket()

void jami::ConversationModule::removeGitSocket	(	std::string_view	deviceId,
		std::string_view	convId
	)

Definition at line 3331 of file conversation_module.cpp.

◆ saveConvInfos()

void jami::ConversationModule::saveConvInfos	(	const std::string &	accountId,
		const std::map< std::string, ConvInfo > &	conversations
	)

static

Definition at line 1537 of file conversation_module.cpp.

References jami::fileutils::get_data_dir(), and saveConvInfosToPath().

Referenced by jami::ConversationModule::Impl::fetchNewCommits(), and jami::ConversationModule::Impl::saveConvInfos().

Here is the call graph for this function:

◆ saveConvInfosToPath()

void jami::ConversationModule::saveConvInfosToPath	(	const std::filesystem::path &	path,
		const std::map< std::string, ConvInfo > &	conversations
	)

static

Definition at line 1544 of file conversation_module.cpp.

References jami::emitSignal().

Referenced by saveConvInfos().

Here is the call graph for this function:

◆ saveConvRequests()

void jami::ConversationModule::saveConvRequests	(	const std::string &	accountId,
		const std::map< std::string, ConversationRequest > &	conversationsRequests
	)

static

Definition at line 1519 of file conversation_module.cpp.

References jami::fileutils::get_data_dir(), and saveConvRequestsToPath().

Referenced by jami::ConversationModule::Impl::fixStructures(), and jami::ConversationModule::Impl::saveConvRequests().

Here is the call graph for this function:

◆ saveConvRequestsToPath()

void jami::ConversationModule::saveConvRequestsToPath	(	const std::filesystem::path &	path,
		const std::map< std::string, ConversationRequest > &	conversationsRequests
	)

static

Definition at line 1527 of file conversation_module.cpp.

References jami::emitSignal().

Referenced by saveConvRequests().

Here is the call graph for this function:

◆ search()

void jami::ConversationModule::search	(	uint32_t	req,
		const std::string &	convId,
		const Filter &	filter
	)		const

Search in conversations via a filter.

Parameters

req	Id of the request
convId	Leave empty to search in all conversation, else add the conversation's id
filter	Parameters for the search

Note: triggers messagesFound

Definition at line 2654 of file conversation_module.cpp.

References jami::emitSignal().

Here is the call graph for this function:

◆ sendMessage() [1/2]

void jami::ConversationModule::sendMessage	(	const std::string &	conversationId,
		Json::Value &&	value,
		const std::string &	replyTo = `""`,
		bool	announce = `true`,
		OnCommitCb &&	onCommit = `{}`,
		OnDoneCb &&	cb = `{}`
	)

Definition at line 2176 of file conversation_module.cpp.

References jami::emitSignal().

Referenced by addCallHistoryMessage(), jami::ConversationModule::Impl::editMessage(), and jami::ConversationModule::Impl::sendMessage().

Here is the call graph for this function:

◆ sendMessage() [2/2]

void jami::ConversationModule::sendMessage	(	const std::string &	conversationId,
		std::string	message,
		const std::string &	replyTo = `""`,
		const std::string &	type = `"text/plain"`,
		bool	announce = `true`,
		OnCommitCb &&	onCommit = `{}`,
		OnDoneCb &&	cb = `{}`
	)

Definition at line 2164 of file conversation_module.cpp.

References jami::emitSignal().

Here is the call graph for this function:

◆ setAccountManager()

void jami::ConversationModule::setAccountManager ( std::shared_ptr< AccountManager > accountManager )

Definition at line 1575 of file conversation_module.cpp.

References jami::emitSignal().

Here is the call graph for this function:

◆ setConversationPreferences()

void jami::ConversationModule::setConversationPreferences	(	const std::string &	conversationId,
		const std::map< std::string, std::string > &	prefs
	)

Update user's preferences (like color, notifications, etc) to be synced across devices.

Parameters

conversationId
preferences

Definition at line 2729 of file conversation_module.cpp.

References jami::emitSignal(), and JAMI_ERROR.

Here is the call graph for this function:

◆ setFetched()

void jami::ConversationModule::setFetched	(	const std::string &	conversationId,
		const std::string &	deviceId,
		const std::string &	commit
	)

Notify that a peer fetched a commit.

Note: : this definitely remove the repository when needed (when we left and someone fetched the information)

Parameters

conversationId	Related conv
deviceId	Device who synced
commit	HEAD synced

Definition at line 2551 of file conversation_module.cpp.

References jami::emitSignal().

Here is the call graph for this function:

◆ shutdownConnections()

void jami::ConversationModule::shutdownConnections ( )

Clear all connection (swarm channels)

Definition at line 3337 of file conversation_module.cpp.

◆ startConversation()

std::string jami::ConversationModule::startConversation	(	ConversationMode	mode = `ConversationMode::INVITES_ONLY`,
		const dht::InfoHash &	otherMember = `{}`
	)

Starts a new conversation.

Parameters

mode	Wanted mode
otherMember	If needed (one to one)

Returns: conversation's id

Definition at line 2099 of file conversation_module.cpp.

References addConvInfo(), jami::emitSignal(), and JAMI_ERROR.

Referenced by jami::ConversationModule::Impl::cloneConversation(), jami::ConversationModule::Impl::cloneConversationFrom(), jami::ConversationModule::Impl::cloneConversationFrom(), and removeConversation().

Here is the call graph for this function:

◆ syncConversations()

void jami::ConversationModule::syncConversations	(	const std::string &	peer,
		const std::string &	deviceId
	)

Sync conversations with detected peer.

Definition at line 2370 of file conversation_module.cpp.

References jami::emitSignal().

Here is the call graph for this function:

◆ updateConversationInfos()

void jami::ConversationModule::updateConversationInfos	(	const std::string &	conversationId,
		const std::map< std::string, std::string > &	infos,
		bool	sync = `true`
	)

Update metadatas from conversations (like title, avatar, etc)

Parameters

conversationId
infos
sync	If we need to sync with others (used for tests)

Definition at line 2677 of file conversation_module.cpp.

References jami::emitSignal(), JAMI_ERROR, and JAMI_WARNING.

Here is the call graph for this function:

◆ updateConvForContact()

bool jami::ConversationModule::updateConvForContact	(	const std::string &	uri,
		const std::string &	oldConv,
		const std::string &	newConv
	)

Replace linked conversation in contact's details.

Parameters

uri	Of the contact
oldConv	Current conversation
newConv

Returns: if replaced

Definition at line 1927 of file conversation_module.cpp.

References jami::emitSignal().

Referenced by jami::ConversationModule::Impl::fixStructures(), onConversationRequest(), and onTrustRequest().

Here is the call graph for this function:

The documentation for this class was generated from the following files:

Classes

Public Member Functions

Static Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ ConversationModule()

◆ ~ConversationModule()

Member Function Documentation

◆ acceptConversationRequest()

◆ addCallHistoryMessage()

◆ addConversationMember()

◆ addConvInfo()

◆ addGitSocket()

◆ addSwarmChannel()

◆ bootstrap()

◆ call()

◆ clearCache()

◆ clearPendingFetch()

◆ cloneConversationFrom()

◆ connectivityChanged()

◆ conversationInfos()

◆ conversationVCard()

◆ convInfos()

◆ convInfosFromPath()

◆ convMessageStatus()

◆ convPreferences()

◆ convRequests()

◆ convRequestsFromPath()

◆ countInteractions()

◆ dataTransfer()

◆ declineConversationRequest()

◆ downloadFile()

◆ editMessage()

◆ fetchNewCommits()

◆ findMatchingOneToOneConversation()

◆ getActiveCalls()

◆ getConversation()

◆ getConversationMembers()

◆ getConversationPreferences()

◆ getConversationRequests()

◆ getConversations()

◆ getOneToOneConversation()

◆ getTypers()

◆ gitSocket()

◆ hostConference()

◆ initPresence()

◆ isBanned()

◆ isHosting()

◆ loadConversation()

◆ loadConversations()

◆ loadSingleConversation()

◆ loadSwarmUntil()

◆ monitor()

◆ needsSyncingWith()

◆ onConversationRequest()

◆ onFileChannelRequest()

◆ onMessageDisplayed()

◆ onNeedConversationRequest()

◆ onSyncData()

◆ onTrustRequest()

◆ peerFromConversationRequest()

◆ reactToMessage()

◆ reloadRequests()

◆ removeContact()

◆ removeConversation()

◆ removeConversationMember()

◆ removeGitSocket()

◆ saveConvInfos()

◆ saveConvInfosToPath()

◆ saveConvRequests()

◆ saveConvRequestsToPath()

◆ search()

◆ sendMessage() [1/2]

◆ sendMessage() [2/2]

◆ setAccountManager()

◆ setConversationPreferences()

◆ setFetched()

◆ shutdownConnections()

◆ startConversation()

◆ syncConversations()