2021-05-18 08:03:47 +02:00
|
|
|
package org.session.libsession.database
|
2020-12-02 06:38:30 +01:00
|
|
|
|
2021-01-13 07:11:30 +01:00
|
|
|
import android.content.Context
|
2021-01-08 07:05:44 +01:00
|
|
|
import android.net.Uri
|
2021-05-07 08:31:46 +02:00
|
|
|
import org.session.libsession.messaging.contacts.Contact
|
2020-12-02 06:38:30 +01:00
|
|
|
import org.session.libsession.messaging.jobs.AttachmentUploadJob
|
2021-12-15 07:11:55 +01:00
|
|
|
import org.session.libsession.messaging.jobs.GroupAvatarDownloadJob
|
2020-12-02 06:38:30 +01:00
|
|
|
import org.session.libsession.messaging.jobs.Job
|
|
|
|
import org.session.libsession.messaging.jobs.MessageSendJob
|
2021-03-30 07:23:12 +02:00
|
|
|
import org.session.libsession.messaging.messages.control.ConfigurationMessage
|
2020-12-18 06:43:19 +01:00
|
|
|
import org.session.libsession.messaging.messages.visible.Attachment
|
2021-01-11 23:58:38 +01:00
|
|
|
import org.session.libsession.messaging.messages.visible.VisibleMessage
|
2021-04-28 09:41:30 +02:00
|
|
|
import org.session.libsession.messaging.open_groups.OpenGroupV2
|
2021-01-08 07:05:44 +01:00
|
|
|
import org.session.libsession.messaging.sending_receiving.attachments.AttachmentId
|
2021-03-15 03:35:05 +01:00
|
|
|
import org.session.libsession.messaging.sending_receiving.attachments.DatabaseAttachment
|
2021-05-27 07:00:16 +02:00
|
|
|
import org.session.libsession.messaging.sending_receiving.data_extraction.DataExtractionNotificationInfoMessage
|
2021-04-26 03:23:09 +02:00
|
|
|
import org.session.libsession.messaging.sending_receiving.link_preview.LinkPreview
|
2021-01-11 23:58:38 +01:00
|
|
|
import org.session.libsession.messaging.sending_receiving.quotes.QuoteModel
|
2021-05-18 08:11:38 +02:00
|
|
|
import org.session.libsession.utilities.Address
|
2021-05-18 08:03:47 +02:00
|
|
|
import org.session.libsession.utilities.GroupRecord
|
2021-05-21 07:02:34 +02:00
|
|
|
import org.session.libsession.utilities.recipients.Recipient
|
2021-05-18 08:03:47 +02:00
|
|
|
import org.session.libsession.utilities.recipients.Recipient.RecipientSettings
|
2021-05-18 01:21:56 +02:00
|
|
|
import org.session.libsignal.crypto.ecc.ECKeyPair
|
2021-05-18 01:50:16 +02:00
|
|
|
import org.session.libsignal.messages.SignalServiceAttachmentPointer
|
|
|
|
import org.session.libsignal.messages.SignalServiceGroup
|
2020-12-02 06:38:30 +01:00
|
|
|
|
|
|
|
interface StorageProtocol {
|
|
|
|
|
|
|
|
// General
|
|
|
|
fun getUserPublicKey(): String?
|
2021-01-14 01:42:26 +01:00
|
|
|
fun getUserX25519KeyPair(): ECKeyPair
|
2020-12-02 06:38:30 +01:00
|
|
|
fun getUserDisplayName(): String?
|
|
|
|
fun getUserProfileKey(): ByteArray?
|
|
|
|
fun getUserProfilePictureURL(): String?
|
2021-05-21 07:21:24 +02:00
|
|
|
fun setUserProfilePictureURL(newProfilePicture: String)
|
2021-05-21 07:02:34 +02:00
|
|
|
// Signal
|
2020-12-10 05:30:32 +01:00
|
|
|
fun getOrGenerateRegistrationID(): Int
|
2020-12-03 04:29:50 +01:00
|
|
|
|
2020-12-02 06:38:30 +01:00
|
|
|
// Jobs
|
2021-01-29 01:16:53 +01:00
|
|
|
fun persistJob(job: Job)
|
2021-05-07 03:48:03 +02:00
|
|
|
fun markJobAsSucceeded(jobId: String)
|
2021-05-13 01:38:39 +02:00
|
|
|
fun markJobAsFailedPermanently(jobId: String)
|
2021-05-07 03:48:03 +02:00
|
|
|
fun getAllPendingJobs(type: String): Map<String,Job?>
|
2020-12-15 05:45:44 +01:00
|
|
|
fun getAttachmentUploadJob(attachmentID: Long): AttachmentUploadJob?
|
2020-12-02 06:38:30 +01:00
|
|
|
fun getMessageSendJob(messageSendJobID: String): MessageSendJob?
|
2021-09-29 07:29:24 +02:00
|
|
|
fun getMessageReceiveJob(messageReceiveJobID: String): Job?
|
2021-12-15 07:11:55 +01:00
|
|
|
fun getGroupAvatarDownloadJob(server: String, room: String): Job?
|
2020-12-02 06:38:30 +01:00
|
|
|
fun resumeMessageSendJobIfNeeded(messageSendJobID: String)
|
|
|
|
fun isJobCanceled(job: Job): Boolean
|
|
|
|
|
|
|
|
// Authorization
|
2021-04-13 09:17:16 +02:00
|
|
|
fun getAuthToken(room: String, server: String): String?
|
|
|
|
fun setAuthToken(room: String, server: String, newValue: String)
|
|
|
|
fun removeAuthToken(room: String, server: String)
|
|
|
|
|
|
|
|
// Open Groups
|
|
|
|
fun getAllV2OpenGroups(): Map<Long, OpenGroupV2>
|
2021-05-21 07:02:34 +02:00
|
|
|
fun getV2OpenGroup(threadId: Long): OpenGroupV2?
|
|
|
|
fun addOpenGroup(urlAsString: String)
|
2021-04-29 09:13:42 +02:00
|
|
|
fun setOpenGroupServerMessageID(messageID: Long, serverID: Long, threadID: Long, isSms: Boolean)
|
2020-12-02 06:38:30 +01:00
|
|
|
|
|
|
|
// Open Group Public Keys
|
|
|
|
fun getOpenGroupPublicKey(server: String): String?
|
|
|
|
fun setOpenGroupPublicKey(server: String, newValue: String)
|
|
|
|
|
2021-02-09 01:45:38 +01:00
|
|
|
// Open Group Metadata
|
|
|
|
fun updateTitle(groupID: String, newValue: String)
|
|
|
|
fun updateProfilePicture(groupID: String, newValue: ByteArray)
|
2021-05-05 05:52:15 +02:00
|
|
|
fun setUserCount(room: String, server: String, newValue: Int)
|
2021-02-09 01:45:38 +01:00
|
|
|
|
2020-12-02 06:38:30 +01:00
|
|
|
// Last Message Server ID
|
2021-05-21 07:02:34 +02:00
|
|
|
fun getLastMessageServerID(room: String, server: String): Long?
|
|
|
|
fun setLastMessageServerID(room: String, server: String, newValue: Long)
|
|
|
|
fun removeLastMessageServerID(room: String, server: String)
|
2020-12-02 06:38:30 +01:00
|
|
|
|
|
|
|
// Last Deletion Server ID
|
2021-05-21 07:02:34 +02:00
|
|
|
fun getLastDeletionServerID(room: String, server: String): Long?
|
|
|
|
fun setLastDeletionServerID(room: String, server: String, newValue: Long)
|
|
|
|
fun removeLastDeletionServerID(room: String, server: String)
|
2020-12-02 06:38:30 +01:00
|
|
|
|
2020-12-07 05:22:02 +01:00
|
|
|
// Message Handling
|
2021-05-19 00:56:44 +02:00
|
|
|
fun isDuplicateMessage(timestamp: Long): Boolean
|
2020-12-07 05:22:02 +01:00
|
|
|
fun getReceivedMessageTimestamps(): Set<Long>
|
|
|
|
fun addReceivedMessageTimestamp(timestamp: Long)
|
2021-05-06 05:28:58 +02:00
|
|
|
fun removeReceivedMessageTimestamps(timestamps: Set<Long>)
|
2021-05-21 07:02:34 +02:00
|
|
|
/**
|
|
|
|
* Returns the IDs of the saved attachments.
|
|
|
|
*/
|
|
|
|
fun persistAttachments(messageID: Long, attachments: List<Attachment>): List<Long>
|
|
|
|
fun getAttachmentsForMessage(messageID: Long): List<DatabaseAttachment>
|
|
|
|
fun getMessageIdInDatabase(timestamp: Long, author: String): Long? // TODO: This is a weird name
|
2021-07-23 08:04:18 +02:00
|
|
|
fun updateSentTimestamp(messageID: Long, isMms: Boolean, openGroupSentTimestamp: Long, threadId: Long)
|
2021-07-01 03:06:11 +02:00
|
|
|
fun markAsSending(timestamp: Long, author: String)
|
2021-03-02 02:24:09 +01:00
|
|
|
fun markAsSent(timestamp: Long, author: String)
|
|
|
|
fun markUnidentified(timestamp: Long, author: String)
|
2021-03-02 04:13:12 +01:00
|
|
|
fun setErrorMessage(timestamp: Long, author: String, error: Exception)
|
2021-08-10 08:42:15 +02:00
|
|
|
fun setMessageServerHash(messageID: Long, serverHash: String)
|
2020-12-07 05:22:02 +01:00
|
|
|
|
2020-12-10 05:30:32 +01:00
|
|
|
// Closed Groups
|
|
|
|
fun getGroup(groupID: String): GroupRecord?
|
2021-02-16 01:14:27 +01:00
|
|
|
fun createGroup(groupID: String, title: String?, members: List<Address>, avatar: SignalServiceAttachmentPointer?, relay: String?, admins: List<Address>, formationTimestamp: Long)
|
2021-03-23 00:00:51 +01:00
|
|
|
fun isGroupActive(groupPublicKey: String): Boolean
|
2020-12-10 05:30:32 +01:00
|
|
|
fun setActive(groupID: String, value: Boolean)
|
2021-05-21 07:02:34 +02:00
|
|
|
fun getZombieMembers(groupID: String): Set<String>
|
2020-12-10 05:30:32 +01:00
|
|
|
fun removeMember(groupID: String, member: Address)
|
|
|
|
fun updateMembers(groupID: String, members: List<Address>)
|
2021-05-21 07:02:34 +02:00
|
|
|
fun setZombieMembers(groupID: String, members: List<Address>)
|
2021-02-09 01:45:38 +01:00
|
|
|
fun getAllClosedGroupPublicKeys(): Set<String>
|
2021-03-23 00:00:51 +01:00
|
|
|
fun getAllActiveClosedGroupPublicKeys(): Set<String>
|
2021-02-09 01:45:38 +01:00
|
|
|
fun addClosedGroupPublicKey(groupPublicKey: String)
|
|
|
|
fun removeClosedGroupPublicKey(groupPublicKey: String)
|
|
|
|
fun addClosedGroupEncryptionKeyPair(encryptionKeyPair: ECKeyPair, groupPublicKey: String)
|
|
|
|
fun removeAllClosedGroupEncryptionKeyPairs(groupPublicKey: String)
|
2021-04-14 08:37:04 +02:00
|
|
|
fun insertIncomingInfoMessage(context: Context, senderPublicKey: String, groupID: String, type: SignalServiceGroup.Type,
|
2021-05-21 07:02:34 +02:00
|
|
|
name: String, members: Collection<String>, admins: Collection<String>, sentTimestamp: Long)
|
2021-04-14 08:37:04 +02:00
|
|
|
fun insertOutgoingInfoMessage(context: Context, groupID: String, type: SignalServiceGroup.Type, name: String,
|
2021-05-21 07:02:34 +02:00
|
|
|
members: Collection<String>, admins: Collection<String>, threadID: Long, sentTimestamp: Long)
|
2021-01-20 00:04:14 +01:00
|
|
|
fun isClosedGroup(publicKey: String): Boolean
|
2021-01-20 01:18:00 +01:00
|
|
|
fun getClosedGroupEncryptionKeyPairs(groupPublicKey: String): MutableList<ECKeyPair>
|
|
|
|
fun getLatestClosedGroupEncryptionKeyPair(groupPublicKey: String): ECKeyPair?
|
2021-06-10 09:34:48 +02:00
|
|
|
fun updateFormationTimestamp(groupID: String, formationTimestamp: Long)
|
2021-12-15 07:11:55 +01:00
|
|
|
fun updateTimestampUpdated(groupID: String, updatedTimestamp: Long)
|
2021-06-09 06:31:05 +02:00
|
|
|
fun setExpirationTimer(groupID: String, duration: Int)
|
2021-02-09 01:45:38 +01:00
|
|
|
|
2021-02-05 06:35:15 +01:00
|
|
|
// Groups
|
|
|
|
fun getAllGroups(): List<GroupRecord>
|
2020-12-02 06:38:30 +01:00
|
|
|
|
2020-12-10 05:30:32 +01:00
|
|
|
// Settings
|
|
|
|
fun setProfileSharing(address: Address, value: Boolean)
|
|
|
|
|
|
|
|
// Thread
|
2021-01-11 23:58:38 +01:00
|
|
|
fun getOrCreateThreadIdFor(address: Address): Long
|
2021-01-20 00:04:14 +01:00
|
|
|
fun getOrCreateThreadIdFor(publicKey: String, groupPublicKey: String?, openGroupID: String?): Long
|
2021-05-21 07:02:34 +02:00
|
|
|
fun getThreadId(publicKeyOrOpenGroupID: String): Long?
|
|
|
|
fun getThreadId(address: Address): Long?
|
|
|
|
fun getThreadId(recipient: Recipient): Long?
|
2021-04-29 09:13:42 +02:00
|
|
|
fun getThreadIdForMms(mmsId: Long): Long
|
2021-05-21 03:09:03 +02:00
|
|
|
fun getLastUpdated(threadID: Long): Long
|
2021-05-26 07:22:19 +02:00
|
|
|
fun trimThread(threadID: Long, threadLimit: Int)
|
2020-12-02 06:38:30 +01:00
|
|
|
|
2021-05-21 07:02:34 +02:00
|
|
|
// Contacts
|
2021-05-07 08:31:46 +02:00
|
|
|
fun getContactWithSessionID(sessionID: String): Contact?
|
|
|
|
fun getAllContacts(): Set<Contact>
|
|
|
|
fun setContact(contact: Contact)
|
2021-07-09 07:13:43 +02:00
|
|
|
fun getRecipientForThread(threadId: Long): Recipient?
|
2021-01-08 01:11:50 +01:00
|
|
|
fun getRecipientSettings(address: Address): RecipientSettings?
|
2021-03-30 07:23:12 +02:00
|
|
|
fun addContacts(contacts: List<ConfigurationMessage.Contact>)
|
2021-01-08 07:05:44 +01:00
|
|
|
|
2021-05-21 07:02:34 +02:00
|
|
|
// Attachments
|
2021-01-08 07:05:44 +01:00
|
|
|
fun getAttachmentDataUri(attachmentId: AttachmentId): Uri
|
|
|
|
fun getAttachmentThumbnailUri(attachmentId: AttachmentId): Uri
|
2021-01-11 23:58:38 +01:00
|
|
|
|
|
|
|
// Message Handling
|
2021-05-21 07:02:34 +02:00
|
|
|
/**
|
|
|
|
* Returns the ID of the `TSIncomingMessage` that was constructed.
|
|
|
|
*/
|
2021-03-15 03:35:05 +01:00
|
|
|
fun persist(message: VisibleMessage, quotes: QuoteModel?, linkPreview: List<LinkPreview?>, groupPublicKey: String?, openGroupID: String?, attachments: List<Attachment>): Long?
|
2021-04-09 08:06:12 +02:00
|
|
|
fun insertDataExtractionNotificationMessage(senderPublicKey: String, message: DataExtractionNotificationInfoMessage, sentTimestamp: Long)
|
2021-04-08 07:11:46 +02:00
|
|
|
}
|