mirror of https://github.com/waku-org/nwaku.git
64 lines
2.0 KiB
Nim
64 lines
2.0 KiB
Nim
## This module defines a message store interface. Implementations of
|
|
## MessageStore are used by the `WakuStore` protocol to store and
|
|
## retrieve historical messages
|
|
when (NimMajor, NimMinor) < (1, 4):
|
|
{.push raises: [Defect].}
|
|
else:
|
|
{.push raises: [].}
|
|
|
|
import
|
|
std/[options, times],
|
|
stew/results
|
|
import
|
|
../../utils/time,
|
|
../waku_message,
|
|
./common
|
|
|
|
|
|
type
|
|
MessageStoreResult*[T] = Result[T, string]
|
|
|
|
MessageStoreRow* = (PubsubTopic, WakuMessage, seq[byte], Timestamp)
|
|
|
|
MessageStore* = ref object of RootObj
|
|
|
|
|
|
# MessageStore interface
|
|
|
|
method put*(ms: MessageStore, pubsubTopic: PubsubTopic, message: WakuMessage, digest: MessageDigest, receivedTime: Timestamp): MessageStoreResult[void] {.base.} = discard
|
|
|
|
method put*(ms: MessageStore, pubsubTopic: PubsubTopic, message: WakuMessage): MessageStoreResult[void] {.base.} =
|
|
let
|
|
digest = computeDigest(message)
|
|
receivedTime = if message.timestamp > 0: message.timestamp
|
|
else: getNanosecondTime(getTime().toUnixFloat())
|
|
|
|
ms.put(pubsubTopic, message, digest, receivedTime)
|
|
|
|
|
|
method getAllMessages*(ms: MessageStore): MessageStoreResult[seq[MessageStoreRow]] {.base.} = discard
|
|
|
|
method getMessagesByHistoryQuery*(
|
|
ms: MessageStore,
|
|
contentTopic = none(seq[ContentTopic]),
|
|
pubsubTopic = none(PubsubTopic),
|
|
cursor = none(HistoryCursor),
|
|
startTime = none(Timestamp),
|
|
endTime = none(Timestamp),
|
|
maxPageSize = DefaultPageSize,
|
|
ascendingOrder = true
|
|
): MessageStoreResult[seq[MessageStoreRow]] {.base.} = discard
|
|
|
|
|
|
# Store manipulation
|
|
|
|
method getMessagesCount*(ms: MessageStore): MessageStoreResult[int64] {.base.} = discard
|
|
|
|
method getOldestMessageTimestamp*(ms: MessageStore): MessageStoreResult[Timestamp] {.base.} = discard
|
|
|
|
method getNewestMessageTimestamp*(ms: MessageStore): MessageStoreResult[Timestamp] {.base.} = discard
|
|
|
|
|
|
method deleteMessagesOlderThanTimestamp*(ms: MessageStore, ts: Timestamp): MessageStoreResult[void] {.base.} = discard
|
|
|
|
method deleteOldestMessagesNotWithinLimit*(ms: MessageStore, limit: int): MessageStoreResult[void] {.base.} = discard |