libkazv
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>
26 #include "sdk-model-cursor-tag.hpp"
27 #include "random-generator.hpp"
28 #include "power-levels-desc.hpp"
29 
30 namespace Kazv
31 {
37  class Room
38  {
39  public:
41  using DepsT = lager::deps<SdkModelCursorKey, RandomInterface &
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 
451  PromiseT refreshRoomState() const;
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 
815  private:
816  const lager::reader<SdkModel> &sdkCursor() const;
817  const lager::reader<RoomModel> &roomCursor() const;
818  lager::reader<RoomModel> makeRoomCursor() const;
819  std::string currentRoomId() const;
821  lager::reader<immer::map<KeyOfState, Event>> inviteStateOrState() const;
823  lager::reader<Event> inviteStateOrStateEvent(lager::reader<KeyOfState> key) const;
824 
825  std::optional<lager::reader<SdkModel>> m_sdk;
826  std::variant<lager::reader<std::string>, std::string> m_roomId;
827 
828  ContextT m_ctx;
829  std::optional<DepsT> m_deps;
830  lager::reader<RoomModel> m_roomCursor;
831  KAZV_DECLARE_THREAD_ID();
832  KAZV_DECLARE_EVENT_LOOP_THREAD_ID_KEEPER(m_deps.has_value() ? &lager::get<EventLoopThreadIdKeeper &>(m_deps.value()) : 0);
833  };
834 }
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
auto pinnedEvents() const -> lager::reader< immer::flex_vector< std::string >>
Get pinned events of this room.
Definition: room.cpp:781
PromiseT setTyping(bool typing, std::optional< int > timeoutMs) const
Set the typing status of the current user in this room.
Definition: room.cpp:710
PromiseT sendAllPendingKeyEvents() const
Send all pending key events in this room.
Definition: room.cpp:615
auto bannedMembers() const -> lager::reader< immer::flex_vector< std::string >>
Get the list of banned member ids.
Definition: room.cpp:149
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
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 topic() const
Definition: room.hpp:486
PromiseT leave() const
Leave this room.
Definition: room.cpp:717
auto typingUsers() const -> lager::reader< immer::flex_vector< std::string >>
Get the ids of all typing users in this room.
Definition: room.cpp:692
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
PromiseT sendMessage(Event msg) const
Send an event to this room.
Definition: room.cpp:326
auto heroIds() const -> lager::reader< immer::flex_vector< std::string >>
Get the ids of the heroes of the room.
Definition: room.cpp:287
SingleTypePromise< DefaultRetType > PromiseT
Definition: room.hpp:40
PromiseT setAccountData(Event accountDataEvent) const
Set the account data for this room.
Definition: room.cpp:752
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
auto members() const -> lager::reader< immer::flex_vector< std::string >>
Get the list of joined member ids.
Definition: room.cpp:121
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 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
auto readMarker() const
Definition: room.hpp:581
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 heroDisplayNames() const -> lager::reader< immer::flex_vector< std::string >>
Get the member events of heroes this room.
Definition: room.cpp:239
auto unreadNotificationEventIds() const -> lager::reader< immer::flex_vector< std::string >>
Get a list of event ids of unread notifications.
Definition: room.cpp:943
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 tags() const -> lager::reader< immer::map< std::string, double >>
Get the tags of the current room.
Definition: room.cpp:758
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
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 heroMemberEvents() const -> lager::reader< immer::flex_vector< Event >>
Get the member events of heroes this room.
Definition: room.cpp:233
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
auto nameOpt() const -> lager::reader< std::optional< std::string >>
Get the name of this room.
Definition: room.cpp:256
lager::reader< immer::map< std::string, std::string > > timelineGaps() const
Get the Gaps in the timeline for this room.
Definition: room.cpp:858
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
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
auto inviteState() const -> lager::reader< immer::map< KeyOfState, Event >>
Get the invite_state of this room.
Definition: room.cpp:228
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 timelineEvents() const -> lager::reader< immer::flex_vector< Event >>
Get a list of timeline events in this room.
Definition: room.cpp:843
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.
KAZV_WRAP_ATTR(RoomModel, roomCursor(), roomId)
auto localEchoes() const -> lager::reader< immer::flex_vector< LocalEchoDesc >>
Get the list of local echoes in this room.
Definition: room.cpp:873
PromiseT pinEvents(immer::flex_vector< std::string > eventIds) const
Add eventIds to the pinned events of this room.
Definition: room.cpp:801
auto leftMembers() const -> lager::reader< immer::flex_vector< std::string >>
Get the list of left member ids.
Definition: room.cpp:142
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 knockedMembers() const -> lager::reader< immer::flex_vector< std::string >>
Get the list of knocked member ids.
Definition: room.cpp:135
PromiseT sendPendingKeyEvent(std::string txnId) const
Send one pending key event in this room.
Definition: room.cpp:586
PromiseT unpinEvents(immer::flex_vector< std::string > eventIds) const
Remove eventIds from the pinned events of this room.
Definition: room.cpp:817
PromiseT kick(std::string userId, std::optional< std::string > reason=std::nullopt) const
Kick a user from this room.
Definition: room.cpp:731
auto messagesMap() const -> lager::reader< immer::map< std::string, Event >>
Get a map from event ids to events.
Definition: room.cpp:838
auto powerLevels() const -> lager::reader< PowerLevelsDesc >
Get the power levels of this room.
Definition: room.cpp:891
auto invitedMembers() const -> lager::reader< immer::flex_vector< std::string >>
Get the list of invited member ids.
Definition: room.cpp:128
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
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:217
Definition: room-model.hpp:55
Definition: clientutil.hpp:56
Describes a local echo.
Definition: local-echo.hpp:19
Definition: room-model.hpp:32
Definition: room-model.hpp:217
immer::map< KeyOfState, Event > stateEvents
Definition: room-model.hpp:224
immer::map< std::string, Event > ephemeral
Definition: room-model.hpp:238
immer::map< std::string, Event > accountData
Definition: room-model.hpp:230
Definition: room.hpp:48
Definition: sdk-model.hpp:26