1 files changed, 60 insertions, 0 deletions
diff --git a/lib/e2ee/qolminboundsession.h b/lib/e2ee/qolminboundsession.h
new file mode 100644
index 00000000..b9710354
--- /dev/null
+++ b/lib/e2ee/qolminboundsession.h
@@ -0,0 +1,60 @@
+// SPDX-FileCopyrightText: 2021 Carl Schwan <carlschwan@kde.org>
+//
+// SPDX-License-Identifier: LGPL-2.1-or-later
+
+#pragma once
+
+#include "e2ee/e2ee.h"
+
+struct OlmInboundGroupSession;
+
+namespace Quotient {
+
+//! An in-bound group session is responsible for decrypting incoming
+//! communication in a Megolm session.
+class QUOTIENT_API QOlmInboundGroupSession
+{
+public:
+    ~QOlmInboundGroupSession();
+    //! Creates a new instance of `OlmInboundGroupSession`.
+    static QOlmExpected<QOlmInboundGroupSessionPtr> create(const QByteArray& key);
+    //! Import an inbound group session, from a previous export.
+    static QOlmExpected<QOlmInboundGroupSessionPtr> importSession(const QByteArray& key);
+    //! Serialises an `OlmInboundGroupSession` to encrypted Base64.
+    QByteArray pickle(const PicklingMode& mode) const;
+    //! Deserialises from encrypted Base64 that was previously obtained by pickling
+    //! an `OlmInboundGroupSession`.
+    static QOlmExpected<QOlmInboundGroupSessionPtr> unpickle(
+        QByteArray&& pickled, const PicklingMode& mode);
+    //! Decrypts ciphertext received for this group session.
+    QOlmExpected<std::pair<QByteArray, uint32_t> > decrypt(const QByteArray& message);
+    //! Export the base64-encoded ratchet key for this session, at the given index,
+    //! in a format which can be used by import.
+    QOlmExpected<QByteArray> exportSession(uint32_t messageIndex);
+    //! Get the first message index we know how to decrypt.
+    uint32_t firstKnownIndex() const;
+    //! Get a base64-encoded identifier for this session.
+    QByteArray sessionId() const;
+    bool isVerified() const;
+
+    //! The olm session that this session was received from.
+    //! Required to get the device this session is from.
+    QString olmSessionId() const;
+    void setOlmSessionId(const QString& newOlmSessionId);
+
+    //! The sender of this session.
+    QString senderId() const;
+    void setSenderId(const QString& senderId);
+
+    OlmErrorCode lastErrorCode() const;
+    const char* lastError() const;
+
+    QOlmInboundGroupSession(OlmInboundGroupSession* session);
+private:
+    OlmInboundGroupSession* m_groupSession;
+    QString m_olmSessionId;
+    QString m_senderId;
+};
+
+using QOlmInboundGroupSessionPtr = std::unique_ptr<QOlmInboundGroupSession>;
+} // namespace Quotient