Atualizar Amigos

Interaja com a Social Service API para executar ações relacionadas a eventos e usuários. Essas ações incluem criar novas solicitações de amizade, aceitar ou rejeitar solicitações recebidas e excluir amizades. A Social Service permite que os usuários gerenciem seus relacionamentos e interações dentro da plataforma.

Amizades e Ações

As amizades dentro da Social Service são relacionamentos bidirecionais entre usuários. Ações podem ser realizadas para atualizar essas amizades, como enviar solicitações de amizade, aceitar ou rejeitar solicitações, cancelar solicitações e remover amizades. Cada uma dessas ações tem implicações específicas para o relacionamento entre usuários.

Implementando Atualizações de Amizade

Para executar essas ações relacionadas à amizade, a UpdateFriendshipEvent message precisa ser utilizada. Esta message permite a execução de várias ações relacionadas a amizades, como solicitar, aceitar, rejeitar, cancelar e remover.

A estrutura exata do payload e os parâmetros necessários para cada ação estão especificados na UpdateFriendshipEvent message.

Exemplo de Uso

Aqui está um exemplo de como você pode usar a UpdateFriendshipEvent para enviar uma solicitação de amizade:

message UpdateFriendshipEvent {
  string userAddress = 1;
  string targetUserAddress = 2;
  FriendshipAction action = 3;
}

Neste exemplo, userAddress representa o endereço do remetente, targetUserAddress representa o endereço do destinatário, e action denota o tipo de ação a ser executada (solicitar, aceitar, rejeitar, cancelar ou remover).

Enviando Solicitações de Amizade

Qualquer usuário pode enviar uma solicitação de amizade a outro usuário. No entanto, para estabelecer uma amizade, o usuário destinatário deve aceitar a solicitação.

requestFriendship: async (address: string, message?: string) => {
  const response = await service.updateFriendshipEvent({
    event: { request: { user: { address }, message } },
    authToken: { synapseToken }
  })
  processErrors(response)
  return response.event
}

Aceitar ou Rejeitar Solicitações

Quando um usuário recebe uma solicitação de amizade, ele tem a opção de aceitar ou rejeitá-la. Aceitar uma solicitação estabelece uma amizade mútua entre os usuários. Rejeitar uma solicitação nega o estabelecimento da amizade.

acceptFriendshipRequest: async (address: string) => {
  const response = await service.updateFriendshipEvent(
    UpdateFriendshipPayload.create({
      event: { accept: { user: { address } } },
      authToken: { synapseToken }
    })
  )
  processErrors(response)
  return response.event
}

rejectFriendshipRequest: async (address: string) => {
  const response = await service.updateFriendshipEvent(
    UpdateFriendshipPayload.create({
      authToken: { synapseToken },
      event: { reject: { user: { address } } }
    })
  )
  processErrors(response)
  return response.event
}

Cancelando Solicitações de Amizade

Se um usuário decidir retrair uma solicitação de amizade enviada antes de ela ser aceita, ele pode cancelar a solicitação. Isso impede que o destinatário veja ou responda à solicitação.

cancelFriendshipRequest: async (address: string) => {
  const response = await service.updateFriendshipEvent(
    UpdateFriendshipPayload.create({
      event: { cancel: { user: { address } } },
      authToken: { synapseToken }
    })
  )
  processErrors(response)
  return response.event
}

Removendo Amizades

Qualquer um dos usuários em uma amizade mútua tem a opção de remover a amizade. Quando uma amizade é removida, ela é excluída dos registros de ambos os usuários, encerrando o relacionamento mútuo.

removeFriend: async (address: string) => {
  const response = await service.updateFriendshipEvent(
    UpdateFriendshipPayload.create({
      authToken: { synapseToken },
      event: { delete: { user: { address } } }
    })
  )
  processErrors(response)
  return response.event
}