libkazv
Loading...
Searching...
No Matches
room.hpp
Go to the documentation of this file.
1/*
2 * This file is part of libkazv.
3 * SPDX-FileCopyrightText: 2020-2023 tusooa <tusooa@kazv.moe>
4 * SPDX-License-Identifier: AGPL-3.0-or-later
5 */
6
7#pragma once
8#include <libkazv-config.hpp>
9
10#include <lager/reader.hpp>
11#include <lager/context.hpp>
12#include <lager/with.hpp>
13#include <lager/constant.hpp>
14#include <lager/lenses/optional.hpp>
15#include <zug/transducer/map.hpp>
16#include <zug/transducer/filter.hpp>
17#include <zug/sequence.hpp>
18#include <immer/flex_vector_transient.hpp>
19
20#include "debug.hpp"
21
22#include "sdk-model.hpp"
23#include "client-model.hpp"
24#include "room-model.hpp"
25#include <cursorutil.hpp>
27#include "random-generator.hpp"
28#include "power-levels-desc.hpp"
29
30namespace Kazv
31{
37 class Room
38 {
39 public:
42#ifdef KAZV_USE_THREAD_SAFETY_HELPER
43 , EventLoopThreadIdKeeper &
44#endif
45 >;
47
48 struct InEventLoopTag {};
49
62 Room(lager::reader<SdkModel> sdk,
63 lager::reader<std::string> roomId,
64 ContextT ctx);
65
78 Room(lager::reader<SdkModel> sdk,
79 lager::reader<std::string> roomId,
80 ContextT ctx, DepsT deps);
81
94 Room(InEventLoopTag, std::string roomId, ContextT ctx, DepsT deps);
95
120 Room toEventLoop() const;
121
122 /* lager::reader<MapT<KeyOfState, Event>> */
123 inline auto stateEvents() const {
124 return roomCursor()
126 }
127
133 auto inviteState() const -> lager::reader<immer::map<KeyOfState, Event>>;
134
135 /* lager::reader<std::optional<Event>> */
136 inline auto stateOpt(KeyOfState k) const {
137 return stateEvents()
138 [std::move(k)];
139 }
140
141 /* lager::reader<Event> */
142 inline auto state(KeyOfState k) const {
143 return stateOpt(k)
144 [lager::lenses::or_default];
145 }
146
153 auto timelineEventIds() const -> lager::reader<immer::flex_vector<std::string>>;
154
161 auto messagesMap() const -> lager::reader<immer::map<std::string, Event>>;
162
170 auto timelineEvents() const -> lager::reader<immer::flex_vector<Event>>;
171
179 auto message(lager::reader<std::string> eventId) const -> lager::reader<Event>;
180
188 auto localEcho(lager::reader<std::string> txnId) const -> lager::reader<LocalEchoDesc>;
189
195 auto heroMemberEvents() const -> lager::reader<immer::flex_vector<Event>>;
196
202 auto heroDisplayNames() const -> lager::reader<immer::flex_vector<std::string>>;
203
212 auto nameOpt() const -> lager::reader<std::optional<std::string>>;
213
222 auto name() const -> lager::reader<std::string>;
223
229 auto avatarMxcUri() const -> lager::reader<std::string>;
230
236 auto members() const -> lager::reader<immer::flex_vector<std::string>>;
237
243 auto invitedMembers() const -> lager::reader<immer::flex_vector<std::string>>;
244
250 auto knockedMembers() const -> lager::reader<immer::flex_vector<std::string>>;
251
257 auto leftMembers() const -> lager::reader<immer::flex_vector<std::string>>;
258
264 auto bannedMembers() const -> lager::reader<immer::flex_vector<std::string>>;
265
271 auto joinedMemberEvents() const -> lager::reader<EventList>;
272
278 auto invitedMemberEvents() const -> lager::reader<EventList>;
279
285 auto knockedMemberEvents() const -> lager::reader<EventList>;
286
292 auto leftMemberEvents() const -> lager::reader<EventList>;
293
299 auto bannedMemberEvents() const -> lager::reader<EventList>;
300
309 auto memberEventByCursor(lager::reader<std::string> userId) const -> lager::reader<Event>;
310
319 auto memberEventFor(std::string userId) const -> lager::reader<Event>;
320
332 lager::reader<bool> encrypted() const;
333
334 /*lager::reader<std::string>*/
335 KAZV_WRAP_ATTR(RoomModel, roomCursor(), roomId);
336 /*lager::reader<RoomMembership>*/
337 KAZV_WRAP_ATTR(RoomModel, roomCursor(), membership);
338 /*lager::reader<std::string>*/
339 KAZV_WRAP_ATTR(RoomModel, roomCursor(), localDraft);
340 /* lager::reader<bool> */
341 KAZV_WRAP_ATTR(RoomModel, roomCursor(), membersFullyLoaded);
342
348 auto localReadMarker() const -> lager::reader<std::string>;
349
356 auto heroIds() const -> lager::reader<immer::flex_vector<std::string>>;
357
364 auto joinedMemberCount() const -> lager::reader<std::size_t>;
365
372 auto invitedMemberCount() const -> lager::reader<std::size_t>;
373
384 PromiseT setLocalDraft(std::string localDraft) const;
385
393 PromiseT sendMessage(Event msg) const;
394
402 PromiseT sendTextMessage(std::string text) const;
403
411 PromiseT resendMessage(std::string txnId) const;
412
421 PromiseT redactEvent(std::string eventId, std::optional<std::string> reason) const;
422
430 PromiseT sendPendingKeyEvent(std::string txnId) const;
431
439
452
465 PromiseT getStateEvent(std::string type, std::string stateKey) const;
466
475
483 PromiseT setName(std::string name) const;
484
485 // lager::reader<std::string>
486 inline auto topic() const {
487 using namespace lager::lenses;
488 return stateEvents()
489 [KeyOfState{"m.room.topic", ""}]
490 [or_default]
491 .xform(eventContent
492 | jsonAtOr("topic"s, ""s));
493 }
494
502 PromiseT setTopic(std::string topic) const;
503
511 PromiseT invite(std::string userId) const;
512
513 /* lager::reader<MapT<std::string, Event>> */
514 inline auto ephemeralEvents() const {
515 return roomCursor()
517 }
518
519 /* lager::reader<std::optional<Event>> */
520 inline auto ephemeralOpt(std::string type) const {
521 return roomCursor()
523 [type];
524 }
525
526 /* lager::reader<Event> */
527 inline auto ephemeral(std::string type) const {
528 return roomCursor()
530 [type]
531 [lager::lenses::or_default];
532 }
533
539 auto typingUsers() const -> lager::reader<immer::flex_vector<std::string>>;
540
546 auto typingMemberEvents() const -> lager::reader<EventList>;
547
557 PromiseT setTyping(bool typing, std::optional<int> timeoutMs) const;
558
559 /* lager::reader<MapT<std::string, Event>> */
560 inline auto accountDataEvents() const {
561 return roomCursor()
563 }
564
565 /* lager::reader<std::optional<Event>> */
566 inline auto accountDataOpt(std::string type) const {
567 return roomCursor()
569 [type];
570 }
571
572 /* lager::reader<Event> */
573 inline auto accountData(std::string type) const {
574 return roomCursor()
576 [type]
577 [lager::lenses::or_default];
578 }
579
580 /* lager::reader<std::string> */
581 inline auto readMarker() const {
582 using namespace lager::lenses;
583 return accountData("m.fully_read")
584 .xform(eventContent
585 | jsonAtOr("event_id", std::string{}));
586 }
587
594 PromiseT setAccountData(Event accountDataEvent) const;
595
602 auto tags() const -> lager::reader<immer::map<std::string, double>>;
603
613 PromiseT addOrSetTag(std::string tagId, std::optional<double> order = std::nullopt) const;
614
623 PromiseT removeTag(std::string tagId) const;
624
631 PromiseT leave() const;
632
641 PromiseT forget() const;
642
654 PromiseT kick(std::string userId, std::optional<std::string> reason = std::nullopt) const;
655
667 PromiseT ban(std::string userId, std::optional<std::string> reason = std::nullopt) const;
668
669 // TODO: v1.1 adds reason field
680 PromiseT unban(std::string userId/*, std::optional<std::string> reason = std::nullopt*/) const;
681
682 /* lager::reader<JsonWrap> */
683 inline auto avatar() const {
684 return state(KeyOfState{"m.room.avatar", ""})
685 .xform(eventContent);
686 }
687
693 auto pinnedEvents() const -> lager::reader<immer::flex_vector<std::string>>;
694
703 PromiseT setPinnedEvents(immer::flex_vector<std::string> eventIds) const;
704
712 PromiseT pinEvents(immer::flex_vector<std::string> eventIds) const;
713
721 PromiseT unpinEvents(immer::flex_vector<std::string> eventIds) const;
722
732 lager::reader<immer::map<std::string /* eventId */, std::string /* prevBatch */>> timelineGaps() const;
733
747 PromiseT paginateBackFromEvent(std::string eventId) const;
748
755 auto localEchoes() const -> lager::reader<immer::flex_vector<LocalEchoDesc>>;
756
764 PromiseT removeLocalEcho(std::string txnId) const;
765
772 auto pendingRoomKeyEvents() const -> lager::reader<immer::flex_vector<PendingRoomKeyEvent>>;
773
779 auto powerLevels() const -> lager::reader<PowerLevelsDesc>;
780
788 auto relatedEvents(lager::reader<std::string> eventId, std::string relType) const -> lager::reader<EventList>;
789
796 auto eventReaders(lager::reader<std::string> eventId) const -> lager::reader<immer::flex_vector<EventReader>>;
797
805 PromiseT postReceipt(std::string eventId) const;
806
813 auto unreadNotificationEventIds() const -> lager::reader<immer::flex_vector<std::string>>;
814
822 bool isReadBy(const std::string &eventId, const std::string &userId);
823
824 private:
825 const lager::reader<SdkModel> &sdkCursor() const;
826 const lager::reader<RoomModel> &roomCursor() const;
827 lager::reader<RoomModel> makeRoomCursor() const;
828 std::string currentRoomId() const;
830 lager::reader<immer::map<KeyOfState, Event>> inviteStateOrState() const;
832 lager::reader<Event> inviteStateOrStateEvent(lager::reader<KeyOfState> key) const;
833
834 std::optional<lager::reader<SdkModel>> m_sdk;
835 std::variant<lager::reader<std::string>, std::string> m_roomId;
836
837 ContextT m_ctx;
838 std::optional<DepsT> m_deps;
839 lager::reader<RoomModel> m_roomCursor;
840 KAZV_DECLARE_THREAD_ID();
841 KAZV_DECLARE_EVENT_LOOP_THREAD_ID_KEEPER(m_deps.has_value() ? &lager::get<EventLoopThreadIdKeeper &>(m_deps.value()) : 0);
842 };
843}
Definition context.hpp:130
Definition event.hpp:21
Represent a m.power_levels event.
Definition power-levels-desc.hpp:26
Definition random-generator.hpp:16
Represent a Matrix room.
Definition room.hpp:38
auto relatedEvents(lager::reader< std::string > eventId, std::string relType) const -> lager::reader< EventList >
Get a list of child events of a specified event.
Definition room.cpp:899
auto memberEventByCursor(lager::reader< std::string > userId) const -> lager::reader< Event >
Get the member event for userId.
Definition room.cpp:191
PromiseT setTyping(bool typing, std::optional< int > timeoutMs) const
Set the typing status of the current user in this room.
Definition room.cpp:710
auto leftMembers() const -> lager::reader< immer::flex_vector< std::string > >
Get the list of left member ids.
Definition room.cpp:142
PromiseT sendAllPendingKeyEvents() const
Send all pending key events in this room.
Definition room.cpp:615
PromiseT sendStateEvent(Event state) const
Send a state event to this room.
Definition room.cpp:650
auto name() const -> lager::reader< std::string >
Get the name of this room.
Definition room.cpp:270
auto messagesMap() const -> lager::reader< immer::map< std::string, Event > >
Get a map from event ids to events.
Definition room.cpp:838
PromiseT resendMessage(std::string txnId) const
Resend an event to this room.
Definition room.cpp:537
PromiseT unban(std::string userId) const
Unban a user from this room.
Definition room.cpp:745
auto accountDataEvents() const
Definition room.hpp:560
PromiseT ban(std::string userId, std::optional< std::string > reason=std::nullopt) const
Ban a user from this room.
Definition room.cpp:738
auto joinedMemberCount() const -> lager::reader< std::size_t >
Get the joined member count of this room.
Definition room.cpp:295
auto invitedMembers() const -> lager::reader< immer::flex_vector< std::string > >
Get the list of invited member ids.
Definition room.cpp:128
auto topic() const
Definition room.hpp:486
PromiseT leave() const
Leave this room.
Definition room.cpp:717
auto unreadNotificationEventIds() const -> lager::reader< immer::flex_vector< std::string > >
Get a list of event ids of unread notifications.
Definition room.cpp:943
auto heroMemberEvents() const -> lager::reader< immer::flex_vector< Event > >
Get the member events of heroes this room.
Definition room.cpp:233
PromiseT setLocalDraft(std::string localDraft) const
Set local draft for this room.
Definition room.cpp:319
auto knockedMemberEvents() const -> lager::reader< EventList >
Get the list of knocked member events.
Definition room.cpp:170
Context< ClientAction > ContextT
Definition room.hpp:46
PromiseT refreshRoomState() const
Get the full state of this room.
Definition room.cpp:636
auto pinnedEvents() const -> lager::reader< immer::flex_vector< std::string > >
Get pinned events of this room.
Definition room.cpp:781
PromiseT sendMessage(Event msg) const
Send an event to this room.
Definition room.cpp:326
SingleTypePromise< DefaultRetType > PromiseT
Definition room.hpp:40
PromiseT setAccountData(Event accountDataEvent) const
Set the account data for this room.
Definition room.cpp:752
auto localEchoes() const -> lager::reader< immer::flex_vector< LocalEchoDesc > >
Get the list of local echoes in this room.
Definition room.cpp:873
auto heroIds() const -> lager::reader< immer::flex_vector< std::string > >
Get the ids of the heroes of the room.
Definition room.cpp:287
PromiseT removeLocalEcho(std::string txnId) const
Remove a local echo from this room.
Definition room.cpp:878
auto accountData(std::string type) const
Definition room.hpp:573
auto state(KeyOfState k) const
Definition room.hpp:142
PromiseT setName(std::string name) const
Set the room name.
Definition room.cpp:657
auto invitedMemberCount() const -> lager::reader< std::size_t >
Get the invited member count of this room.
Definition room.cpp:300
auto stateOpt(KeyOfState k) const
Definition room.hpp:136
auto leftMemberEvents() const -> lager::reader< EventList >
Get the list of left member events.
Definition room.cpp:177
Room toEventLoop() const
Return a Room that represents the room currently represented by this, but suitable for use in the eve...
Definition room.cpp:52
PromiseT paginateBackFromEvent(std::string eventId) const
Try to paginate back from eventId.
Definition room.cpp:865
PromiseT removeTag(std::string tagId) const
Remove a tag from this room.
Definition room.cpp:772
auto members() const -> lager::reader< immer::flex_vector< std::string > >
Get the list of joined member ids.
Definition room.cpp:121
auto readMarker() const
Definition room.hpp:581
auto nameOpt() const -> lager::reader< std::optional< std::string > >
Get the name of this room.
Definition room.cpp:256
auto bannedMemberEvents() const -> lager::reader< EventList >
Get the list of banned member events.
Definition room.cpp:184
PromiseT setPinnedEvents(immer::flex_vector< std::string > eventIds) const
Set pinned events of this room.
Definition room.cpp:787
PromiseT addOrSetTag(std::string tagId, std::optional< double > order=std::nullopt) const
Add or set a tag to this room.
Definition room.cpp:763
auto ephemeralEvents() const
Definition room.hpp:514
auto typingMemberEvents() const -> lager::reader< EventList >
Get the member events of all typing users in this room.
Definition room.cpp:700
auto memberEventFor(std::string userId) const -> lager::reader< Event >
Get the member event for userId.
Definition room.cpp:198
PromiseT sendTextMessage(std::string text) const
Send a text message to this room.
Definition room.cpp:522
auto timelineEvents() const -> lager::reader< immer::flex_vector< Event > >
Get a list of timeline events in this room.
Definition room.cpp:843
lager::deps< SdkModelCursorKey, RandomInterface & > DepsT
Definition room.hpp:45
Room(lager::reader< SdkModel > sdk, lager::reader< std::string > roomId, ContextT ctx, DepsT deps)
Constructor.
lager::reader< bool > encrypted() const
Get whether this room is encrypted.
Definition room.cpp:276
auto stateEvents() const
Definition room.hpp:123
PromiseT setTopic(std::string topic) const
Set the room topic.
Definition room.cpp:671
PromiseT getStateEvent(std::string type, std::string stateKey) const
Get one state event with type and stateKey .
Definition room.cpp:643
lager::reader< immer::map< std::string, std::string > > timelineGaps() const
Get the Gaps in the timeline for this room.
Definition room.cpp:858
auto knockedMembers() const -> lager::reader< immer::flex_vector< std::string > >
Get the list of knocked member ids.
Definition room.cpp:135
auto localEcho(lager::reader< std::string > txnId) const -> lager::reader< LocalEchoDesc >
Get one local echo by the txnId.
Definition room.cpp:105
auto avatar() const
Definition room.hpp:683
auto ephemeralOpt(std::string type) const
Definition room.hpp:520
bool isReadBy(const std::string &eventId, const std::string &userId)
Check if an event has been read by the given user.
Definition room.cpp:948
auto invitedMemberEvents() const -> lager::reader< EventList >
Get the list of invited member events.
Definition room.cpp:163
auto ephemeral(std::string type) const
Definition room.hpp:527
PromiseT forget() const
Forget this room.
Definition room.cpp:724
auto tags() const -> lager::reader< immer::map< std::string, double > >
Get the tags of the current room.
Definition room.cpp:758
auto message(lager::reader< std::string > eventId) const -> lager::reader< Event >
Get one message by the event id.
Definition room.cpp:97
Room(lager::reader< SdkModel > sdk, lager::reader< std::string > roomId, ContextT ctx)
Constructor.
auto inviteState() const -> lager::reader< immer::map< KeyOfState, Event > >
Get the invite_state of this room.
Definition room.cpp:228
PromiseT pinEvents(immer::flex_vector< std::string > eventIds) const
Add eventIds to the pinned events of this room.
Definition room.cpp:801
auto typingUsers() const -> lager::reader< immer::flex_vector< std::string > >
Get the ids of all typing users in this room.
Definition room.cpp:692
auto accountDataOpt(std::string type) const
Definition room.hpp:566
PromiseT redactEvent(std::string eventId, std::optional< std::string > reason) const
Redact an event.
Definition room.cpp:577
PromiseT invite(std::string userId) const
Invite a user to this room.
Definition room.cpp:685
auto pendingRoomKeyEvents() const -> lager::reader< immer::flex_vector< PendingRoomKeyEvent > >
Get the list of pending room key events in this room.
Definition room.cpp:886
auto bannedMembers() const -> lager::reader< immer::flex_vector< std::string > >
Get the list of banned member ids.
Definition room.cpp:149
auto timelineEventIds() const -> lager::reader< immer::flex_vector< std::string > >
Get the timeline event ids of this room in ascending timestamp order.
Definition room.cpp:833
PromiseT sendPendingKeyEvent(std::string txnId) const
Send one pending key event in this room.
Definition room.cpp:586
auto eventReaders(lager::reader< std::string > eventId) const -> lager::reader< immer::flex_vector< EventReader > >
Get a list of read receipts of some event in this room.
Definition room.cpp:920
PromiseT unpinEvents(immer::flex_vector< std::string > eventIds) const
Remove eventIds from the pinned events of this room.
Definition room.cpp:817
auto heroDisplayNames() const -> lager::reader< immer::flex_vector< std::string > >
Get the member events of heroes this room.
Definition room.cpp:239
PromiseT kick(std::string userId, std::optional< std::string > reason=std::nullopt) const
Kick a user from this room.
Definition room.cpp:731
auto powerLevels() const -> lager::reader< PowerLevelsDesc >
Get the power levels of this room.
Definition room.cpp:891
auto avatarMxcUri() const -> lager::reader< std::string >
Get the avatar mxc uri of this room.
Definition room.cpp:305
auto joinedMemberEvents() const -> lager::reader< EventList >
Get the list of joined member events.
Definition room.cpp:156
auto localReadMarker() const -> lager::reader< std::string >
Get the local read marker in this room.
Definition room.cpp:281
PromiseT postReceipt(std::string eventId) const
Post a read receipt for this room.
Definition room.cpp:938
Definition promise-interface.hpp:122
#define KAZV_WRAP_ATTR(_type, _d, _attr)
Definition clientutil.hpp:152
Definition location.hpp:10
constexpr auto eventContent
Definition cursorutil.hpp:128
lager::dep::key< SdkModelCursorTag, lager::dep::fn< std::shared_ptr< lager::reader< SdkModel > > > > SdkModelCursorKey
Definition sdk-model-cursor-tag.hpp:23
constexpr auto jsonAtOr(T &&key, V &&defaultValue)
Definition cursorutil.hpp:140
immer::flex_vector< Event > EventList
Definition types.hpp:107
Definition clientutil.hpp:140
Definition room-model.hpp:60
Definition clientutil.hpp:56
Describes a local echo.
Definition local-echo.hpp:19
Definition room-model.hpp:34
The model to store information about a room.
Definition room-model.hpp:236
immer::map< KeyOfState, Event > stateEvents
Definition room-model.hpp:243
immer::map< std::string, Event > ephemeral
Definition room-model.hpp:257
immer::map< std::string, Event > accountData
Definition room-model.hpp:249
Definition room.hpp:48
Definition sdk-model.hpp:26
#define KAZV_DECLARE_EVENT_LOOP_THREAD_ID_KEEPER(_initializer)
Definition thread-safety-helper.hpp:75