community: the drawer asks a peer for its card and the server for interests, and discover gets the similar-users shelf

crates/soulseek-proto/src/server.rs

@@ -31,6 +31,8 @@ pub mod code {
     pub const PING: u32 = 32;
     pub const SHARED_FOLDERS_AND_FILES: u32 = 35;
     pub const GET_USER_STATS: u32 = 36;
+    pub const USER_INTERESTS: u32 = 57;
+    pub const SIMILAR_USERS: u32 = 110;
     pub const ROOM_LIST: u32 = 64;
     pub const HAVE_NO_PARENTS: u32 = 71;
     pub const PARENT_MIN_SPEED: u32 = 83;
@@ -136,6 +138,27 @@ pub fn get_user_stats(username: &str) -> Vec<u8> {
         .finish_u32(code::GET_USER_STATS)
 }
 
+/// A user's declared likes and hates (code 57).
+pub fn user_interests(username: &str) -> Vec<u8> {
+    Writer::new()
+        .string(username)
+        .finish_u32(code::USER_INTERESTS)
+}
+
+/// Users the server ranks as similar to us by shared interests (code 110).
+pub fn similar_users() -> Vec<u8> {
+    Writer::new().finish_u32(code::SIMILAR_USERS)
+}
+
+fn string_list(r: &mut Reader) -> Result<Vec<String>> {
+    let n = r.u32()?.min(1024) as usize;
+    let mut v = Vec::with_capacity(n.min(64));
+    for _ in 0..n {
+        v.push(r.string()?);
+    }
+    Ok(v)
+}
+
 pub fn say_chatroom(room: &str, message: &str) -> Vec<u8> {
     Writer::new()
         .string(room)
@@ -226,6 +249,16 @@ pub enum ServerEvent {
     Embedded(Bytes),
     /// Public rooms and their user counts (pushed after login, and on
     /// request). Private-room sections in the payload are ignored.
+    /// Answer to user_interests: what they declared, verbatim.
+    UserInterests {
+        username: String,
+        likes: Vec<String>,
+        hates: Vec<String>,
+    },
+    /// Answer to similar_users: (username, rating) as the server ranks them.
+    SimilarUsers {
+        users: Vec<(String, u32)>,
+    },
     RoomList {
         rooms: Vec<(String, u32)>,
     },
@@ -473,6 +506,20 @@ pub fn decode(code: u32, payload: Bytes) -> Result<ServerEvent> {
                 dir_count: r.u32()?,
             }
         }
+        code::USER_INTERESTS => {
+            let username = r.string()?;
+            let likes = string_list(&mut r)?;
+            let hates = string_list(&mut r)?;
+            ServerEvent::UserInterests { username, likes, hates }
+        }
+        code::SIMILAR_USERS => {
+            let n = r.u32()?.min(4096) as usize;
+            let mut users = Vec::with_capacity(n.min(256));
+            for _ in 0..n {
+                users.push((r.string()?, r.u32()?));
+            }
+            ServerEvent::SimilarUsers { users }
+        }
         code::ROOM_LIST => {
             // Public names + counts; the private-room sections that follow
             // are deliberately not parsed.