Skip to content

Open-source Xbox-inspired desktop launcher for Xodus on Linux

TypeScript
13.2 KB
Raw Blame
import {chatComposeKey} from './chat-compose-key';
import { ui, uiText } from './i18n';
import { useEffect, useRef, useState, type FormEvent } from 'react';
import { LoaderCircle, Send, UserRound, X } from 'lucide-react';
import type { AppSnapshot } from '../shared/types';
import { xboxAvatarUrl, xboxMessageText, xboxSocialError, xboxSubmissionInHistory, type XboxConversation, type XboxFriend, type XboxMessageReceipt } from '../shared/social';
import { FriendsRefresh } from './friends-refresh';
import './friends.css';

// Warm only after pointer/keyboard intent, never on startup or while signing in.
export function preloadFriends(data:AppSnapshot,load:()=>Promise<unknown>=()=>window.launcher.getXboxFriends()):void {
  if((data.auth.stored!==true&&!data.auth.player)||data.auth.running||!data.backend.available||!data.backend.capabilities.commands.includes('social'))return;
  void load().catch(()=>{});
}

export function FriendAvatar({ friend }: { friend: XboxFriend }) {
  const url = xboxAvatarUrl(friend.avatarUrl);
  const [failed,setFailed] = useState(false);
  useEffect(() => setFailed(false), [url]);
  return <span className="friend-avatar">{url&&!failed?<img src={url} alt="" loading="lazy" referrerPolicy="no-referrer" onError={()=>setFailed(true)} />:<UserRound aria-hidden="true" />}</span>;
}

export function Friends({ data, close, docked=false }: { data: AppSnapshot; close: () => void; docked?: boolean }) {
  const [friends,setFriends]=useState<XboxFriend[]>([]),[selected,setSelected]=useState<XboxFriend>();
  const [conversation,setConversation]=useState<XboxConversation>(),[draft,setDraft]=useState('');
  const [busy,setBusy]=useState(false),[error,setError]=useState('');
  const [sending,setSending]=useState(false);
  const [uncertain,setUncertain]=useState(false);
  const [accepted,setAccepted]=useState(false);
  const submission=useRef<{receipt:XboxMessageReceipt;text:string}>();
  const generation=useRef(0),pending=useRef(false),select=useRef('');
  const currentFriend=useRef<XboxFriend>(),lastFriends=useRef(0);
  const dialog=useRef<HTMLElement>(null),onClose=useRef(close);onClose.current=close;
  const available=(data.auth.stored===true||Boolean(data.auth.player))&&!data.auth.running&&data.backend.available&&data.backend.capabilities.commands.includes('social');
  useEffect(()=>{
    const origin=document.activeElement instanceof HTMLElement?document.activeElement:undefined;
    dialog.current?.querySelector<HTMLElement>('[data-gamepad-initial]')?.focus({preventScroll:true});
    const key=(event:KeyboardEvent)=>{
      if(event.key==='Escape'){event.preventDefault();event.stopImmediatePropagation();onClose.current();}
      if(event.key==='Tab'&&!docked){
        const controls=[...dialog.current!.querySelectorAll<HTMLElement>('button:not(:disabled),textarea:not(:disabled)')];
        if(!dialog.current?.contains(document.activeElement)||event.shiftKey&&document.activeElement===controls[0]||!event.shiftKey&&document.activeElement===controls.at(-1)){
          event.preventDefault();(event.shiftKey?controls.at(-1):controls[0])?.focus();
        }
      }
    };
    window.addEventListener('keydown',key,true);
    return()=>{window.removeEventListener('keydown',key,true);if(origin?.isConnected)origin.focus({preventScroll:true});};
  },[docked]);

  useEffect(()=>{
    const active=++generation.current;
    setFriends([]);setSelected(undefined);currentFriend.current=undefined;select.current='';setConversation(undefined);setDraft('');setUncertain(false);setAccepted(false);submission.current=undefined;setError('');pending.current=false;setBusy(false);setSending(false);lastFriends.current=0;
    if(available){
      setBusy(true);pending.current=true;
      void window.launcher.getXboxFriends().then(value=>{
        if(generation.current===active){setFriends(value);lastFriends.current=Date.now();}
      }).catch(error=>{if(generation.current===active)setError(xboxSocialError(error));})
        .finally(()=>{if(generation.current===active){setBusy(false);pending.current=false;}});
    }
    return ()=>{generation.current++;void window.launcher.closeXboxSocial().catch(()=>{});};
  },[available,data.auth.username,data.auth.player]);

  function applyConversation(value:XboxConversation){
    setConversation(value);
    const sent=submission.current;
    if(sent&&xboxSubmissionInHistory(sent.receipt,value)){
      setDraft(draft=>draft===sent.text?'':draft);
      submission.current=undefined;setAccepted(false);setUncertain(false);setError('');
    }
  }

  async function refresh(friend=currentFriend.current,automatic=false): Promise<boolean> {
    if(pending.current)return true;
    if(automatic&&!friend&&Date.now()-lastFriends.current<60_000)return true;
    pending.current=true;setBusy(true);setError('');const active=generation.current;
    try{
      if(automatic&&Date.now()-lastFriends.current>=60_000){
        const value=await window.launcher.getXboxFriends();
        if(generation.current!==active)return true;
        setFriends(value);lastFriends.current=Date.now();
        const updated=value.find(value=>value.xuid===currentFriend.current?.xuid);
        if(updated){currentFriend.current=updated;setSelected(updated);}
      }
      if(friend){
        const value=await window.launcher.getXboxConversation(friend.xuid);
        if(generation.current===active&&select.current===friend.xuid)applyConversation(value);
      }else{
        if(!automatic||Date.now()-lastFriends.current>=60_000){
          const value=await window.launcher.getXboxFriends();if(generation.current===active){setFriends(value);lastFriends.current=Date.now();}
        }
      }
      return true;
    }catch(error){if(generation.current===active)setError(xboxSocialError(error));return false;}
    finally{if(generation.current===active){pending.current=false;setBusy(false);}}
  }
  useEffect(()=>{
    if(!available)return;
    const polling=new FriendsRefresh(()=>refresh(currentFriend.current,true),()=>document.visibilityState==='visible');
    polling.start();
    const visible=()=>{if(document.visibilityState==='visible')polling.wake();};
    document.addEventListener('visibilitychange',visible);
    return()=>{polling.stop();document.removeEventListener('visibilitychange',visible);};
  },[available,data.auth.username,data.auth.player]);
  function choose(friend:XboxFriend){
    if(pending.current)return;
    setSelected(friend);currentFriend.current=friend;select.current=friend.xuid;setConversation(undefined);setDraft('');setUncertain(false);setAccepted(false);submission.current=undefined;void refresh(friend);
  }
  async function send(event:FormEvent){
    event.preventDefault();if(!selected||pending.current||uncertain||!xboxMessageText(draft))return;
    const friend=selected,message=draft,active=generation.current;
    pending.current=true;setBusy(true);setSending(true);setError('');
    try{
      const receipt=await window.launcher.sendXboxMessage(friend.xuid,message);
      if(generation.current!==active)return;
      // Keep the draft and block duplicates until this exact server ID appears.
      // Service acceptance is not recipient delivery and must not create a fake message.
      submission.current={receipt,text:message};setAccepted(true);setUncertain(true);
      try{const value=await window.launcher.getXboxConversation(friend.xuid);if(generation.current===active)applyConversation(value);}
      catch{if(generation.current===active)setError(ui("ui.xbox_accepted_the_message_but_the_conversation_c_5ec8ebb"));}
    }catch{if(generation.current===active){setUncertain(true);setError(ui("ui.message_delivery_could_not_be_confirmed_check_th_a9f9139"));}}
    finally{if(generation.current===active){pending.current=false;setBusy(false);setSending(false);}}
  }
  async function invitationAction(action:()=>Promise<void>){
    if(pending.current)return;const active=generation.current;pending.current=true;setBusy(true);setError('');
    try{await action();}catch{if(generation.current===active)setError(ui("ui.the_invitation_could_not_be_processed_check_that_0e251ae"));}
    finally{if(generation.current===active){pending.current=false;setBusy(false);}}
  }
  const outgoing=data.social?.outgoing??[],incoming=data.social?.incoming??[];
  return <div className={docked?'friends-docked':'dialog-backdrop'} data-gamepad-layer>
    <section ref={dialog} className="friends-dialog" role="dialog" aria-modal={docked?undefined:true} aria-labelledby="friends-heading">
      <header><h2 id="friends-heading">{ui("ui.friends_bd104d1")}</h2>{busy?<span className="friends-loading" role="status"><LoaderCircle className="spin" /><span className="sr-only">{ui("ui.loading_dc38088")}</span></span>:null}<button data-gamepad-initial data-gamepad-cancel aria-label={ui("ui.close_friends_64e9cdd")} onClick={close}><X /></button></header>
      {incoming.length||outgoing.length?<section className="friends-invitations" aria-label={ui("ui.game_invitations_f9a1a45")}>
        {incoming.map(invite=><article key={invite.id}><div><strong>{invite.game}</strong><small>{ui('friends.invitation_from', { name: invite.sender })}</small></div><button disabled={busy} onClick={()=>void invitationAction(()=>window.launcher.acceptGameInvite(invite.id))}>{ui("ui.accept_89713b9")}</button></article>)}
        {outgoing.map(invite=><article key={invite.id}><div><strong>{invite.game}</strong><small>{invite.phase==='choosing'?ui("ui.choose_a_friend_below_then_send_an_invitation_27e80a3"):invite.phase==='sending'?ui("ui.waiting_for_the_game_to_send_the_invitation_c4d60eb"):invite.phase==='sent'?ui("ui.invitation_sent_b413595"):invite.phase==='failed'?ui("ui.the_game_could_not_confirm_invitation_delivery_d434e95"):ui("ui.invitation_cancelled_134517d")}</small></div>{invite.phase==='choosing'?<><button disabled={busy||!selected} onClick={()=>selected&&void invitationAction(()=>window.launcher.chooseGameInviteRecipient(invite.id,selected.xuid))}>{ui('friends.invite_friend', { name: selected?.gamertag ?? ui('friends.friend') })}</button><button disabled={busy} onClick={()=>void invitationAction(()=>window.launcher.cancelGameInvite(invite.id))}>{ui("ui.cancel_19766ed")}</button></>:null}</article>)}
      </section>:null}
      {!available?<p role="status">{(data.auth.stored!==true&&!data.auth.player)?ui("ui.sign_in_to_your_microsoft_account_in_settings_fi_187cd60"):ui("ui.this_backend_does_not_support_xbox_friends_and_c_6ed1034")}</p>:<>
        {error?<p className="friends-error" role="alert">{uiText(error)}</p>:null}
        <div className="friends-columns">
          <aside aria-label={ui("ui.friends_list_e79cc91")}>
            {!busy&&!friends.length?<p>{ui("ui.no_friends_returned_by_xbox_decddb3")}</p>:null}
            {friends.map(friend=><button key={friend.xuid} className={selected?.xuid===friend.xuid?'selected':''} disabled={busy} onClick={()=>choose(friend)}>
              <FriendAvatar friend={friend} /><span className="friend-details"><strong>{friend.gamertag}</strong><small>{friend.presence==='online'?ui("ui.online_0d21bd5"):friend.presence==='offline'?ui("ui.offline_a179478"):ui("ui.presence_unavailable_6eeb208")}</small>{friend.activity?<small>{friend.activity}</small>:null}</span>
            </button>)}
          </aside>
          <section className="friends-chat" aria-label={ui("ui.conversation_ccca181")}>
            {selected?<><h3><FriendAvatar friend={selected} />{selected.gamertag}</h3>
              {(data.social?.active??[]).map(game=><button key={game.id} disabled={busy||(data.social?.outgoing??[]).some(value=>value.phase==='sending'&&value.id.startsWith(game.id+':'))} onClick={()=>void invitationAction(()=>window.launcher.inviteXboxFriend(game.id,selected.xuid))}>{ui('friends.invite_to', { game: game.game })}</button>)}
              <div className="friends-messages" role="log" aria-live="polite">
                {conversation?.hasMore?<p>{ui("ui.showing_the_latest_100_messages_older_messages_a_7fb43bf")}</p>:null}
                {conversation?.messages.map(message=><article key={message.id}>
                  <small>{message.sender===selected.xuid?selected.gamertag:ui("ui.you_08b0419")} · <time dateTime={message.at}>{new Date(message.at).toLocaleString()}</time></small>
                  <p>{message.hidden?ui("ui.message_hidden_or_unsupported_d199cb4"):message.text}</p>
                </article>)}
                {conversation&&!conversation.messages.length?<p>{ui("ui.no_messages_returned_by_xbox_5a80816")}</p>:null}
              </div>
              {uncertain?<p role="status">{accepted?ui("ui.xbox_accepted_the_message_but_it_is_not_yet_conf_6ca6e90"):ui("ui.sending_could_not_be_confirmed_your_draft_is_kep_504246d")}</p>:null}
              <form onSubmit={event=>void send(event)}><label htmlFor="xbox-message">{ui("ui.message_2f77668")}</label><textarea onKeyDown={chatComposeKey} aria-description={ui('friends.send_shortcut')} id="xbox-message" value={draft} maxLength={512} onChange={event=>setDraft(event.target.value)} disabled={sending} />
                <small>{ui('friends.characters', { count: Array.from(draft).length })}</small><button type="submit" disabled={busy||uncertain||!xboxMessageText(draft)}><Send />{ui("ui.send_f6f4688")}</button></form>
            </>:<div className="friends-empty"><UserRound aria-hidden="true" /><h3>{ui("ui.your_conversations_903532e")}</h3><p>{ui("ui.select_a_friend_to_start_chatting_b5387d2")}</p></div>}
          </section>
        </div>
      </>}
    </section>
  </div>;
}