feat: Social service v2 (#242)

* feat: Concept of friendships

* feat: Only friend requests need id

* feat: change order of props for compatibility

* feat: New stream FriendUpdate (online, offline, away in the future)

* feat: Missing changes after merge

* feat: Get Friends and Mutual responses include data from their profile

* feat: Friendship request response also include profile data

* fix: change string for bool on has claimed name

* refactor: Rename stream friend connectivity updates subscription and response

* feat: Additional data in upsert and updates responses

* feat: Add None Friendship Status

Author: kevinszuchet

proto/decentraland/social_service/v2/social_service_v2.proto

@@ -10,15 +10,23 @@ message InternalServerError {}
 // Types
 message User { string address = 1; }
 
+message FriendProfile {
+  string address = 1;
+  string name = 2;
+  bool has_claimed_name = 3;
+  string profile_picture_url = 4;
+}
+
 message Pagination {
   int32 limit = 1;
   int32 offset = 2;
 }
 
 message FriendshipRequestResponse {
-  User user = 1;
+  FriendProfile friend = 1;
   int64 created_at = 2;
   optional string message = 3;
+  string id = 4;
 }
 
 message FriendshipRequests {
@@ -33,7 +41,6 @@ enum ConnectivityStatus {
 
 message GetFriendsPayload {
   optional Pagination pagination = 1;
-  optional ConnectivityStatus status = 2;
 }
 
 message GetFriendshipRequestsPayload {
@@ -69,8 +76,8 @@ message PaginatedResponse {
   int32 page = 2;
 }
 
-message PaginatedUsersResponse {
-  repeated User users = 1;
+message PaginatedFriendsProfilesResponse {
+  repeated FriendProfile friends = 1;
   PaginatedResponse pagination_data = 2;
 }
 
@@ -86,6 +93,8 @@ message UpsertFriendshipResponse {
   message Accepted {
     string id = 1;
     int64 created_at = 2;
+    FriendProfile friend = 3;
+    optional string message = 4;
   }
   oneof response {
     Accepted accepted = 1;
@@ -95,20 +104,31 @@ message UpsertFriendshipResponse {
 }
 
 message FriendshipUpdate {
+  message RequestResponse {
+    FriendProfile friend = 1;
+    int64 created_at = 2;
+    optional string message = 3;
+    string id = 4;
+  }
   message AcceptResponse { User user = 1; }
   message RejectResponse { User user = 1; }
   message DeleteResponse { User user = 1; }
   message CancelResponse { User user = 1; }
 
   oneof update {
-    FriendshipRequestResponse request = 1;
+    RequestResponse request = 1;
     AcceptResponse accept = 2;
     RejectResponse reject = 3;
     DeleteResponse delete = 4;
     CancelResponse cancel = 5;
   }
 }
 
+message FriendConnectivityUpdate {
+  FriendProfile friend = 1;
+  ConnectivityStatus status = 2;
+}
+
 message GetFriendshipStatusPayload {
   User user = 1;
 }
@@ -121,6 +141,7 @@ enum FriendshipStatus {
   REJECTED = 4;
   DELETED = 5;
   BLOCKED = 6;
+  NONE = 7;
 }
 
 message GetFriendshipStatusResponse {
@@ -136,10 +157,10 @@ message GetFriendshipStatusResponse {
 
 service SocialService {  
   // Get the list of friends for the authenticated user
-  rpc GetFriends(GetFriendsPayload) returns (PaginatedUsersResponse) {}
+  rpc GetFriends(GetFriendsPayload) returns (PaginatedFriendsProfilesResponse) {}
 
   // Get the list of mutual friends between the authenticated user and the one in the parameter
-  rpc GetMutualFriends(GetMutualFriendsPayload) returns (PaginatedUsersResponse) {}
+  rpc GetMutualFriends(GetMutualFriendsPayload) returns (PaginatedFriendsProfilesResponse) {}
 
   // Get the pending friendship requests for the authenticated user
   rpc GetPendingFriendshipRequests(GetFriendshipRequestsPayload) returns (PaginatedFriendshipRequestsResponse) {}
@@ -155,5 +176,10 @@ service SocialService {
   rpc SubscribeToFriendshipUpdates(google.protobuf.Empty)
       returns (stream FriendshipUpdate) {}
 
+  // Get the friendship status between the authenticated user and the one in the parameter
   rpc GetFriendshipStatus(GetFriendshipStatusPayload) returns (GetFriendshipStatusResponse) {}
+
+  // Subscribe to connectivity updates of friends: ONLINE, OFFLINE, AWAY
+  rpc SubscribeToFriendConnectivityUpdates(google.protobuf.Empty)
+      returns (stream FriendConnectivityUpdate) {}
 }