import { useEffect, useRef } from 'react'; import { useMatrixClient } from './useMatrixClient'; import { useSetting } from '../state/hooks/settings'; import { settingsAtom } from '../state/settings'; const IDLE_TIMEOUT_MS = 10 * 60 * 1000; const ACTIVITY_THROTTLE_MS = 1000; export type PresenceSetting = 'auto' | 'online' | 'idle' | 'dnd' | 'invisible'; export type PresenceState = 'online' | 'unavailable' | 'offline'; /** * Single source of truth for mapping the user's presence preference to the * Matrix presence value: auto/online → 'online', idle/dnd → 'unavailable', * invisible (or the hidePresence override) → 'offline'. Shared with the Profile * status writer so setting/clearing a status message never overrides the user's * chosen presence (e.g. outing an Invisible user as online). */ export function presenceStateFromSetting( presenceStatus: PresenceSetting, hidePresence: boolean, ): PresenceState { if (hidePresence || presenceStatus === 'invisible') return 'offline'; if (presenceStatus === 'idle' || presenceStatus === 'dnd') return 'unavailable'; return 'online'; } export function usePresenceUpdater() { const mx = useMatrixClient(); const [hidePresence] = useSetting(settingsAtom, 'hidePresence'); const [presenceStatus] = useSetting(settingsAtom, 'presenceStatus'); const idleTimerRef = useRef | undefined>(undefined); const isIdleRef = useRef(false); const lastActivityRef = useRef(0); useEffect(() => { const userId = mx.getUserId(); // Read status from localStorage at call time so manual updates from the // Profile settings are never overwritten by a stale closure value. const readStatus = () => userId ? (localStorage.getItem(`lotus-status-msg-${userId}`) ?? '') : ''; // Log presence failures without leaking PII (user id, token, status message). const warnPresenceFailure = (presence: string, err: unknown) => { const reason = err instanceof Error ? err.message : typeof err === 'string' ? err : 'unknown error'; console.warn(`Failed to set presence to "${presence}":`, reason); }; const setOnline = () => { const status = readStatus(); return mx .setPresence({ presence: 'online', ...(status ? { status_msg: status } : {}), }) .catch((err) => warnPresenceFailure('online', err)); }; const setUnavailable = (statusMsg?: string) => { const status = readStatus(); return mx .setPresence({ presence: 'unavailable', ...(statusMsg ? { status_msg: statusMsg } : status ? { status_msg: status } : {}), }) .catch((err) => warnPresenceFailure('unavailable', err)); }; const setOffline = () => mx .setPresence({ presence: 'offline', status_msg: '' }) .catch((err) => warnPresenceFailure('offline', err)); // Manual presence overrides — no activity tracking needed. if (hidePresence || presenceStatus === 'invisible') { setOffline(); return undefined; } if (presenceStatus === 'online') { setOnline(); return undefined; } if (presenceStatus === 'idle') { setUnavailable(); return undefined; } if (presenceStatus === 'dnd') { setUnavailable('dnd'); return undefined; } // presenceStatus === 'auto' — original activity-tracking behavior. const startIdleTimer = () => { clearTimeout(idleTimerRef.current); idleTimerRef.current = setTimeout(() => { isIdleRef.current = true; setUnavailable(); }, IDLE_TIMEOUT_MS); }; const handleActivity = () => { const now = Date.now(); if (now - lastActivityRef.current < ACTIVITY_THROTTLE_MS) return; lastActivityRef.current = now; if (isIdleRef.current && !document.hidden) { isIdleRef.current = false; setOnline(); } startIdleTimer(); }; const handleVisibilityChange = () => { if (document.hidden) { clearTimeout(idleTimerRef.current); setUnavailable(); } else { isIdleRef.current = false; lastActivityRef.current = Date.now(); setOnline(); startIdleTimer(); } }; const handlePageHide = () => { const token = mx.getAccessToken(); const baseUrl = mx.getHomeserverUrl(); if (!userId || !token || !baseUrl) return; // Reliable delivery during page teardown: navigator.sendBeacon cannot set the // Authorization header required by the authenticated Matrix presence endpoint, so // it isn't usable here. fetch(..., { keepalive: true }) lets the request outlive the // page and is the correct mechanism for an authed endpoint. (keepalive bodies are // capped at 64KB, which this tiny payload is well under.) fetch(`${baseUrl}/_matrix/client/v3/presence/${encodeURIComponent(userId)}/status`, { method: 'PUT', headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ presence: 'offline' }), keepalive: true, }).catch((err) => warnPresenceFailure('offline (pagehide)', err)); }; setOnline(); startIdleTimer(); const activityEvents = ['mousemove', 'keydown', 'touchstart', 'click', 'scroll'] as const; activityEvents.forEach((e) => window.addEventListener(e, handleActivity, { passive: true })); document.addEventListener('visibilitychange', handleVisibilityChange); window.addEventListener('pagehide', handlePageHide); return () => { clearTimeout(idleTimerRef.current); activityEvents.forEach((e) => window.removeEventListener(e, handleActivity)); document.removeEventListener('visibilitychange', handleVisibilityChange); window.removeEventListener('pagehide', handlePageHide); }; }, [mx, hidePresence, presenceStatus]); }