Softchat/com.softcose.softchat.sdk/AccountConversations

AccountConversations

class AccountConversations

Complete conversation commands and bounded queries.

Functions

count

suspend fun count(archived: Boolean = false): UInt

Return the exact number of active or archived conversations.

get

suspend fun get(id: ConversationId): Conversation?

Return one complete conversation, or null when it is not stored.

getOrCreate

suspend fun getOrCreate(members: List<PublicKey>): Conversation

Create or return the stable conversation containing members and this account.

hasUnread

suspend fun hasUnread(includeArchived: Boolean = false): Boolean

Return whether another participant has an unread live message.

markRead

suspend fun markRead(id: ConversationId, boundary: MessageCursor, commandId: CommandId = CommandId.random()): OperationResult

Advance the durable tuple read boundary through boundary.

markUnread

suspend fun markUnread(id: ConversationId, commandId: CommandId = CommandId.random()): OperationResult

Force a conversation to remain unread until explicitly marked read again.

observe

fun observe(id: ConversationId): Flow<Conversation?>

Observe one complete conversation whenever durable account state changes.

fun observe(archived: Boolean = false, cursor: ConversationCursor? = null, limit: Int = 50): Flow<ConversationPage>

Observe a complete bounded page whenever the durable account revision changes.

observeCount

fun observeCount(archived: Boolean = false): Flow<UInt>

Observe the exact active or archived conversation count.

observeHasUnread

fun observeHasUnread(includeArchived: Boolean = false): Flow<Boolean>

Observe the account-wide unread flag.

observeReadState

fun observeReadState(): Flow<List<ConversationReadState>>

Observe the complete effective cross-device read-state snapshot.

page

suspend fun page(archived: Boolean = false, cursor: ConversationCursor? = null, limit: Int = 50): ConversationPage

Return one lossless bounded page, ordered by pin and recent activity.

readState

suspend fun readState(): List<ConversationReadState>

Return the complete effective cross-device read-state snapshot.

saveDraft

suspend fun saveDraft(id: ConversationId, draft: ConversationDraft?)

Save or clear the portable draft for one conversation.

suspend fun search(query: String, archived: Boolean? = null, limit: Int = 50): List<Conversation>

Search complete conversations by subject, member key, or known name.

setArchived

suspend fun setArchived(id: ConversationId, archived: Boolean)

Archive or restore one conversation.

setPinned

suspend fun setPinned(id: ConversationId, pinned: Boolean)

Pin or unpin one conversation.