Enviar amigos

Interactúa con la Social Service API para realizar acciones relacionadas con eventos y usuarios. Estas acciones incluyen crear nuevas solicitudes de amistad, aceptar o rechazar solicitudes entrantes y eliminar amistades. La Social Service permite a los usuarios gestionar sus relaciones e interacciones dentro de la plataforma.

Amistades y Acciones

Las amistades dentro de la Social Service son relaciones bidireccionales entre usuarios. Se pueden realizar acciones para actualizar estas amistades, como enviar solicitudes de amistad, aceptar o rechazar solicitudes, cancelar solicitudes y eliminar amistades. Cada una de estas acciones tiene implicaciones específicas para la relación entre los usuarios.

Implementación de Actualizaciones de Amistad

Para realizar estas acciones relacionadas con la amistad, el UpdateFriendshipEvent mensaje necesita ser utilizado. Este mensaje permite la ejecución de varias acciones relacionadas con las amistades, como solicitar, aceptar, rechazar, cancelar y eliminar.

La estructura exacta del payload y los parámetros requeridos para cada acción se especifican en el UpdateFriendshipEvent mensaje.

Ejemplo de Uso

Aquí hay un ejemplo de cómo podrías usar el UpdateFriendshipEvent para enviar una solicitud de amistad:

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

En este ejemplo, userAddress representa la dirección del remitente, targetUserAddress representa la dirección del destinatario, y action denota el tipo de acción a realizar (solicitar, aceptar, rechazar, cancelar o eliminar).

Enviar Solicitudes de Amistad

Cualquier usuario puede enviar una solicitud de amistad a otro usuario. Sin embargo, para establecer una amistad, el usuario destinatario debe aceptar la solicitud.

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

Aceptar o Rechazar Solicitudes

Cuando un usuario recibe una solicitud de amistad, tiene la opción de aceptarla o rechazarla. Aceptar una solicitud establece una amistad mutua entre los usuarios. Rechazar una solicitud impide el establecimiento de la amistad.

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
}

Cancelar Solicitudes de Amistad

Si un usuario decide retractarse de una solicitud de amistad enviada antes de que sea aceptada, puede cancelar la solicitud. Esto evita que el destinatario vea o responda a la solicitud.

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

Eliminar Amistades

Cualquiera de los usuarios en una amistad mutua tiene la opción de eliminar la amistad. Cuando se elimina una amistad, se borra de los registros de ambos usuarios, poniendo fin a la relación mutua.

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