/*
* Copyright (C) 2026 Fluxer Contributors
*
* This file is part of Fluxer.
*
* Fluxer is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* Fluxer 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 Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License
* along with Fluxer. If not, see .
*/
import GatewayConnectionStore from '@app/stores/gateway/GatewayConnectionStore';
import {makeAutoObservable, runInAction} from 'mobx';
const MEMBER_SUBSCRIPTION_MAX_SIZE = 100;
const MEMBER_SUBSCRIPTION_TTL_MS = 5 * 60 * 1000;
const MEMBER_SUBSCRIPTION_SYNC_DEBOUNCE_MS = 500;
const MEMBER_SUBSCRIPTION_PRUNE_INTERVAL_MS = 30 * 1000;
interface LRUEntry {
userId: string;
lastAccessed: number;
}
class MemberPresenceSubscriptionStore {
private subscriptions: Map> = new Map();
private activeGuildId: string | null = null;
private syncTimeoutId: number | null = null;
private pruneIntervalId: number | null = null;
private pendingSyncGuilds: Set = new Set();
subscriptionVersion = 0;
constructor() {
makeAutoObservable(
this,
{
subscriptions: false,
syncTimeoutId: false,
pruneIntervalId: false,
pendingSyncGuilds: false,
},
{autoBind: true},
);
this.startPruneInterval();
}
private startPruneInterval(): void {
if (this.pruneIntervalId != null) {
return;
}
this.pruneIntervalId = window.setInterval(() => {
this.pruneExpiredEntries();
}, MEMBER_SUBSCRIPTION_PRUNE_INTERVAL_MS);
}
private getGuildSubscriptions(guildId: string): Map {
let guildSubs = this.subscriptions.get(guildId);
if (!guildSubs) {
guildSubs = new Map();
this.subscriptions.set(guildId, guildSubs);
}
return guildSubs;
}
touchMember(guildId: string, userId: string): void {
const guildSubs = this.getGuildSubscriptions(guildId);
const now = Date.now();
if (guildSubs.has(userId)) {
guildSubs.delete(userId);
}
guildSubs.set(userId, now);
this.enforceMaxSize(guildId);
this.scheduleSyncToGateway(guildId);
this.bumpVersion();
}
unsubscribe(guildId: string, userId: string): void {
const guildMembers = this.subscriptions.get(guildId);
if (!guildMembers) return;
guildMembers.delete(userId);
if (guildMembers.size === 0) {
this.subscriptions.delete(guildId);
}
this.bumpVersion();
this.syncToGatewayImmediate(guildId);
}
setActiveGuild(guildId: string): void {
if (this.activeGuildId === guildId) {
return;
}
const previous = this.activeGuildId;
this.activeGuildId = guildId;
if (previous) {
this.syncActiveFlagImmediate(previous, false);
}
this.syncActiveFlagImmediate(guildId, true);
this.scheduleSyncToGateway(guildId);
this.bumpVersion();
}
getSubscribedMembers(guildId: string): Array {
const guildSubs = this.subscriptions.get(guildId);
if (!guildSubs) {
return [];
}
return Array.from(guildSubs.keys());
}
clearGuild(guildId: string): void {
const hadSubscriptions = this.subscriptions.has(guildId);
const wasActiveGuild = this.activeGuildId === guildId;
this.subscriptions.delete(guildId);
if (hadSubscriptions) {
this.syncToGatewayImmediate(guildId);
this.bumpVersion();
}
if (wasActiveGuild) {
this.activeGuildId = null;
this.syncActiveFlagImmediate(guildId, false);
}
}
clearAll(): void {
const socket = GatewayConnectionStore.socket;
const guildIds = Array.from(this.subscriptions.keys());
const previousActive = this.activeGuildId;
if (socket) {
for (const guildId of guildIds) {
socket.updateGuildSubscriptions({
subscriptions: {
[guildId]: {members: []},
},
});
}
if (previousActive) {
socket.updateGuildSubscriptions({
subscriptions: {
[previousActive]: {active: false},
},
});
}
}
this.subscriptions.clear();
this.activeGuildId = null;
if (this.syncTimeoutId != null) {
clearTimeout(this.syncTimeoutId);
this.syncTimeoutId = null;
}
this.pendingSyncGuilds.clear();
this.bumpVersion();
}
private bumpVersion(): void {
runInAction(() => {
this.subscriptionVersion++;
});
}
private enforceMaxSize(guildId: string): void {
const guildSubs = this.subscriptions.get(guildId);
if (!guildSubs || guildSubs.size <= MEMBER_SUBSCRIPTION_MAX_SIZE) {
return;
}
const entries: Array = [];
for (const [userId, lastAccessed] of guildSubs) {
entries.push({userId, lastAccessed});
}
entries.sort((a, b) => a.lastAccessed - b.lastAccessed);
const toRemove = entries.slice(0, entries.length - MEMBER_SUBSCRIPTION_MAX_SIZE);
for (const entry of toRemove) {
guildSubs.delete(entry.userId);
}
}
private pruneExpiredEntries(): void {
const now = Date.now();
const cutoff = now - MEMBER_SUBSCRIPTION_TTL_MS;
const guildsToSync = new Set();
for (const [guildId, guildSubs] of this.subscriptions) {
const toRemove: Array = [];
for (const [userId, lastAccessed] of guildSubs) {
if (lastAccessed < cutoff) {
toRemove.push(userId);
}
}
for (const userId of toRemove) {
guildSubs.delete(userId);
guildsToSync.add(guildId);
}
if (guildSubs.size === 0) {
this.subscriptions.delete(guildId);
}
}
if (guildsToSync.size > 0) {
for (const guildId of guildsToSync) {
this.scheduleSyncToGateway(guildId);
}
this.bumpVersion();
}
}
private scheduleSyncToGateway(guildId: string): void {
this.pendingSyncGuilds.add(guildId);
if (this.syncTimeoutId != null) {
return;
}
this.syncTimeoutId = window.setTimeout(() => {
this.syncTimeoutId = null;
this.flushPendingSyncs();
}, MEMBER_SUBSCRIPTION_SYNC_DEBOUNCE_MS);
}
private flushPendingSyncs(): void {
const guildsToSync = Array.from(this.pendingSyncGuilds);
this.pendingSyncGuilds.clear();
for (const guildId of guildsToSync) {
this.syncToGatewayImmediate(guildId);
}
}
private syncActiveFlagImmediate(guildId: string, active: boolean): void {
const socket = GatewayConnectionStore.socket;
if (!socket) return;
socket.updateGuildSubscriptions({
subscriptions: {
[guildId]: {active, sync: active ? true : undefined},
},
});
}
private syncToGatewayImmediate(guildId: string): void {
const socket = GatewayConnectionStore.socket;
if (!socket) {
return;
}
const guildSubs = this.subscriptions.get(guildId);
const members = guildSubs ? Array.from(guildSubs.keys()).sort() : [];
socket.updateGuildSubscriptions({
subscriptions: {
[guildId]: {members},
},
});
}
}
export default new MemberPresenceSubscriptionStore();