This repository has been archived on 2022-08-14. You can view files and clone it, but cannot push or open issues or pull requests.
Files
outline/app/stores/DocumentPresenceStore.js
Tom Moor 146e4da73b feat: Document presence indicator (#1114)
* Update websockets to allow joining document-based rooms

* dynamic websocket joining

* emit user.join/leave events when entering and exiting document rooms

* presence storage

* feat: frontend presence store

* lint

* UI updates

* First pass editing state

* refactoring

* Timeout per user/doc
lint

* Document data loading refactor to keep Socket mounted

* restore: Mark as viewed functionality
Add display of 'you' to collaborators

* fix: Socket/document remount when document slug changes due to title change

* Revert unneccessary package update

* Move editing ping interval to a shared constant

* fix: Flash of sidebar when loading page directly on editing mode

* separate document and revision loading

* add comments for socket events

* fix: Socket events getting bound multiple times on reconnect

* fix: Clear client side presence state on disconnect

* fix: Don't ignore server side error
Improved documentation

* More comments / why comments

* rename Socket -> SocketPresence

* fix: Handle redis is down
remove unneccessary join

* fix: PR feedback
2020-01-02 21:17:59 -08:00

70 lines
2.1 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

// @flow
import { observable, action } from 'mobx';
import { USER_PRESENCE_INTERVAL } from 'shared/constants';
type DocumentPresence = Map<string, { isEditing: boolean, userId: string }>;
export default class PresenceStore {
@observable data: Map<string, DocumentPresence> = new Map();
timeouts: Map<string, TimeoutID> = new Map();
// called to setup when we get the initial state from document.presence
// websocket message. overrides any existing state
@action
init(documentId: string, userIds: string[], editingIds: string[]) {
this.data.set(documentId, new Map());
userIds.forEach(userId =>
this.touch(documentId, userId, editingIds.includes(userId))
);
}
// called when a user leave the room user.leave websocket message.
@action
leave(documentId: string, userId: string) {
const existing = this.data.get(documentId);
if (existing) {
existing.delete(userId);
}
}
@action
update(documentId: string, userId: string, isEditing: boolean) {
const existing = this.data.get(documentId) || new Map();
existing.set(userId, { isEditing, userId });
this.data.set(documentId, existing);
}
// called when a user presence message is received user.presence websocket
// message.
// While in edit mode a message is sent every USER_PRESENCE_INTERVAL, if
// the other clients don't receive within USER_PRESENCE_INTERVAL*2 then a
// timeout is triggered causing the users presence to default back to not
// editing state as a safety measure.
touch(documentId: string, userId: string, isEditing: boolean) {
const id = `${documentId}-${userId}`;
let timeout = this.timeouts.get(id);
if (timeout) {
clearTimeout(timeout);
this.timeouts.delete(id);
}
this.update(documentId, userId, isEditing);
if (isEditing) {
timeout = setTimeout(() => {
this.update(documentId, userId, false);
}, USER_PRESENCE_INTERVAL * 2);
this.timeouts.set(id, timeout);
}
}
get(documentId: string): ?DocumentPresence {
return this.data.get(documentId);
}
@action
clear() {
this.data.clear();
}
}