// SPDX-FileCopyrightText: 2021 Carl Schwan // // SPDX-License-Identifier: LGPL-2.1-or-later #pragma once #include "olm/olm.h" #include "e2ee/qolmerrors.h" #include "e2ee/e2ee.h" #include namespace Quotient { //! An out-bound group session is responsible for encrypting outgoing //! communication in a Megolm session. class QOlmOutboundGroupSession { public: ~QOlmOutboundGroupSession(); //! Creates a new instance of `QOlmOutboundGroupSession`. //! Throw OlmError on errors static std::unique_ptr create(); //! Serialises a `QOlmOutboundGroupSession` to encrypted Base64. std::variant pickle(const PicklingMode &mode); //! Deserialises from encrypted Base64 that was previously obtained by //! pickling a `QOlmOutboundGroupSession`. static std::variant, QOlmError> unpickle(QByteArray &pickled, const PicklingMode &mode); //! Encrypts a plaintext message using the session. std::variant encrypt(const QString &plaintext); //! Get the current message index for this session. //! //! Each message is sent with an increasing index; this returns the //! index for the next message. uint32_t sessionMessageIndex() const; //! Get a base64-encoded identifier for this session. QByteArray sessionId() const; //! Get the base64-encoded current ratchet key for this session. //! //! Each message is sent with a different ratchet key. This function returns the //! ratchet key that will be used for the next message. std::variant sessionKey() const; QOlmOutboundGroupSession(OlmOutboundGroupSession *groupSession); private: OlmOutboundGroupSession *m_groupSession; }; using QOlmOutboundGroupSessionPtr = std::unique_ptr; using OlmOutboundGroupSessionPtr = std::unique_ptr; }