From 14ed0092cfcc7a3f015286bfbab849fa0f67e04f Mon Sep 17 00:00:00 2001 From: Chris Bobbe Date: Mon, 4 Aug 2025 19:46:30 -0700 Subject: [PATCH] message [nfc]: Dartdoc MessageStore.sendMessage --- lib/model/message.dart | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/lib/model/message.dart b/lib/model/message.dart index a6c62ce901..90a0c28840 100644 --- a/lib/model/message.dart +++ b/lib/model/message.dart @@ -34,6 +34,14 @@ mixin MessageStore on ChannelStore { void markReadFromScroll(Iterable messageIds); + /// Makes a send-message request and starts an outbox lifecycle. + /// + /// The returned [Future] settles when the send-message response is received. + /// The [Future] resolves if the request succeeded and rejects if it failed, + /// unless the event already arrived, in which case it resolves. + /// + /// See [takeOutboxMessage] for a way to restore a composing session + /// when it seems like the request might fail, or it has failed. Future sendMessage({ required MessageDestination destination, required String content,