aboutsummaryrefslogtreecommitdiff
path: root/matrix/room/room.go
diff options
context:
space:
mode:
authorTulir Asokan <tulir@maunium.net>2018-03-22 23:46:43 +0200
committerTulir Asokan <tulir@maunium.net>2018-03-22 23:46:43 +0200
commit373b25c01cc94afff3abb0fe98af31aa52a40568 (patch)
treecfe9591ca6f51a4f934cfda609deda0e4a951480 /matrix/room/room.go
parent20a1a31fa85d71f6fc36b7c895aa80646c8f7fb3 (diff)
Rename matrix/room/ to matrix/rooms/
Diffstat (limited to 'matrix/room/room.go')
-rw-r--r--matrix/room/room.go240
1 files changed, 0 insertions, 240 deletions
diff --git a/matrix/room/room.go b/matrix/room/room.go
deleted file mode 100644
index 4166fd7..0000000
--- a/matrix/room/room.go
+++ /dev/null
@@ -1,240 +0,0 @@
-// gomuks - A terminal Matrix client written in Go.
-// Copyright (C) 2018 Tulir Asokan
-//
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// This program is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-// GNU General Public License for more details.
-//
-// You should have received a copy of the GNU General Public License
-// along with this program. If not, see <http://www.gnu.org/licenses/>.
-
-package rooms
-
-import (
- "fmt"
- "sync"
-
- "maunium.net/go/gomatrix"
-)
-
-// Room represents a single Matrix room.
-type Room struct {
- *gomatrix.Room
-
- // The first batch of events that has been fetched for this room.
- // Used for fetching additional history.
- PrevBatch string
- // The MXID of the user whose session this room was created for.
- SessionUserID string
- // MXID -> Member cache calculated from membership events.
- memberCache map[string]*Member
- // The first non-SessionUserID member in the room. Calculated at the same time as memberCache.
- firstMemberCache string
- // The name of the room. Calculated from the state event name, canonical_alias or alias or the member cache.
- nameCache string
- // The topic of the room. Directly fetched from the m.room.topic state event.
- topicCache string
-
- // fetchHistoryLock is used to make sure multiple goroutines don't fetch history for this room at the same time.
- fetchHistoryLock *sync.Mutex `json:"-"`
-}
-
-func (room *Room) LockHistory() {
- if room.fetchHistoryLock == nil {
- room.fetchHistoryLock = &sync.Mutex{}
- }
- room.fetchHistoryLock.Lock()
-}
-
-func (room *Room) UnlockHistory() {
- if room.fetchHistoryLock != nil {
- room.fetchHistoryLock.Unlock()
- }
-}
-
-// UpdateState updates the room's current state with the given Event. This will clobber events based
-// on the type/state_key combination.
-func (room *Room) UpdateState(event *gomatrix.Event) {
- _, exists := room.State[event.Type]
- if !exists {
- room.State[event.Type] = make(map[string]*gomatrix.Event)
- }
- switch event.Type {
- case "m.room.member":
- room.memberCache = nil
- room.firstMemberCache = ""
- fallthrough
- case "m.room.name":
- fallthrough
- case "m.room.canonical_alias":
- fallthrough
- case "m.room.alias":
- room.nameCache = ""
- case "m.room.topic":
- room.topicCache = ""
- }
- room.State[event.Type][*event.StateKey] = event
-}
-
-// GetStateEvent returns the state event for the given type/state_key combo, or nil.
-func (room *Room) GetStateEvent(eventType string, stateKey string) *gomatrix.Event {
- stateEventMap, _ := room.State[eventType]
- event, _ := stateEventMap[stateKey]
- return event
-}
-
-// GetStateEvents returns the state events for the given type.
-func (room *Room) GetStateEvents(eventType string) map[string]*gomatrix.Event {
- stateEventMap, _ := room.State[eventType]
- return stateEventMap
-}
-
-// GetTopic returns the topic of the room.
-func (room *Room) GetTopic() string {
- if len(room.topicCache) == 0 {
- topicEvt := room.GetStateEvent("m.room.topic", "")
- if topicEvt != nil {
- room.topicCache, _ = topicEvt.Content["topic"].(string)
- }
- }
- return room.topicCache
-}
-
-// updateNameFromNameEvent updates the room display name to be the name set in the name event.
-func (room *Room) updateNameFromNameEvent() {
- nameEvt := room.GetStateEvent("m.room.name", "")
- if nameEvt != nil {
- room.nameCache, _ = nameEvt.Content["name"].(string)
- }
-}
-
-// updateNameFromCanonicalAlias updates the room display name to be the canonical alias of the room.
-func (room *Room) updateNameFromCanonicalAlias() {
- canonicalAliasEvt := room.GetStateEvent("m.room.canonical_alias", "")
- if canonicalAliasEvt != nil {
- room.nameCache, _ = canonicalAliasEvt.Content["alias"].(string)
- }
-}
-
-// updateNameFromAliases updates the room display name to be the first room alias it finds.
-//
-// Deprecated: the Client-Server API recommends against using aliases as display name.
-func (room *Room) updateNameFromAliases() {
- // TODO the spec says clients should not use m.room.aliases for room names.
- // However, Riot also uses m.room.aliases, so this is here now.
- aliasEvents := room.GetStateEvents("m.room.aliases")
- for _, event := range aliasEvents {
- aliases, _ := event.Content["aliases"].([]interface{})
- if len(aliases) > 0 {
- room.nameCache, _ = aliases[0].(string)
- break
- }
- }
-}
-
-// updateNameFromMembers updates the room display name based on the members in this room.
-//
-// The room name depends on the number of users:
-// Less than two users -> "Empty room"
-// Exactly two users -> The display name of the other user.
-// More than two users -> The display name of one of the other users, followed
-// by "and X others", where X is the number of users
-// excluding the local user and the named user.
-func (room *Room) updateNameFromMembers() {
- members := room.GetMembers()
- if len(members) <= 1 {
- room.nameCache = "Empty room"
- } else if len(members) == 2 {
- room.nameCache = members[room.firstMemberCache].DisplayName
- } else {
- firstMember := members[room.firstMemberCache].DisplayName
- room.nameCache = fmt.Sprintf("%s and %d others", firstMember, len(members)-2)
- }
-}
-
-// updateNameCache updates the room display name based on the room state in the order
-// specified in spec section 11.2.2.5.
-func (room *Room) updateNameCache() {
- if len(room.nameCache) == 0 {
- room.updateNameFromNameEvent()
- }
- if len(room.nameCache) == 0 {
- room.updateNameFromCanonicalAlias()
- }
- if len(room.nameCache) == 0 {
- room.updateNameFromAliases()
- }
- if len(room.nameCache) == 0 {
- room.updateNameFromMembers()
- }
-}
-
-// GetTitle returns the display name of the room.
-//
-// The display name is returned from the cache.
-// If the cache is empty, it is updated first.
-func (room *Room) GetTitle() string {
- room.updateNameCache()
- return room.nameCache
-}
-
-// createMemberCache caches all member events into a easily processable MXID -> *Member map.
-func (room *Room) createMemberCache() map[string]*Member {
- cache := make(map[string]*Member)
- events := room.GetStateEvents("m.room.member")
- room.firstMemberCache = ""
- if events != nil {
- for userID, event := range events {
- if len(room.firstMemberCache) == 0 && userID != room.SessionUserID {
- room.firstMemberCache = userID
- }
- member := eventToRoomMember(userID, event)
- if member.Membership != "leave" {
- cache[member.UserID] = member
- }
- }
- }
- room.memberCache = cache
- return cache
-}
-
-// GetMembers returns the members in this room.
-//
-// The members are returned from the cache.
-// If the cache is empty, it is updated first.
-func (room *Room) GetMembers() map[string]*Member {
- if len(room.memberCache) == 0 {
- room.createMemberCache()
- }
- return room.memberCache
-}
-
-// GetMember returns the member with the given MXID.
-// If the member doesn't exist, nil is returned.
-func (room *Room) GetMember(userID string) *Member {
- if len(room.memberCache) == 0 {
- room.createMemberCache()
- }
- member, _ := room.memberCache[userID]
- return member
-}
-
-// GetSessionOwner returns the Member instance of the user whose session this room was created for.
-func (room *Room) GetSessionOwner() *Member {
- return room.GetMember(room.SessionUserID)
-}
-
-// NewRoom creates a new Room with the given ID
-func NewRoom(roomID, owner string) *Room {
- return &Room{
- Room: gomatrix.NewRoom(roomID),
- fetchHistoryLock: &sync.Mutex{},
- SessionUserID: owner,
- }
-}