Add friend metadata support.

CHANGELOG.md

@@ -4,6 +4,8 @@ All notable changes to this project are documented below.
 The format is based on [keep a changelog](http://keepachangelog.com) and this project uses [semantic versioning](http://semver.org).
 
 ## [Unreleased]
+### Added
+- Add friend metadata support.
 
 ## [1.35.0] - 2024-11-25
 ### Added

api/api.proto

@@ -148,6 +148,8 @@ message AddFriendsRequest {
   repeated string ids = 1;
   // The account username of a user.
   repeated string usernames = 2;
+  // Optional metadata to add to friends.
+  string metadata = 3;
 }
 
 // Add users to a group.
@@ -422,6 +424,8 @@ message Friend {
   google.protobuf.Int32Value state = 2; // one of "Friend.State".
   // Time of the latest relationship update.
   google.protobuf.Timestamp update_time = 3;
+  // Metadata.
+  string metadata = 4;
 }
 
 // A collection of zero or more friends of the user.

index.d.ts

@@ -4774,6 +4774,16 @@ declare namespace nkruntime {
          */
         userGroupsList(userId: string, limit?: number, state?: number, cursor?: string): UserGroupList;
 
+        /**
+         * Update friend metadata.
+         *
+         * @param userId - User ID.
+         * @param friendUserId - Friend User ID.
+         * @param metadata - Metadata to set. Overwrites existing metadata.
+         * @throws {TypeError, GoError}
+         */
+        friendMetadataUpdate(userId: string, friendUserId: string, metadata: {[key: string]: any}): void;
+
         /**
          * List a user's friends.
          *

runtime/runtime.go

@@ -1196,9 +1196,10 @@ type NakamaModule interface {
 	GroupsGetRandom(ctx context.Context, count int) ([]*api.Group, error)
 	UserGroupsList(ctx context.Context, userID string, limit int, state *int, cursor string) ([]*api.UserGroupList_UserGroup, string, error)
 
+	FriendMetadataUpdate(ctx context.Context, userID string, friendUserId string, metadata map[string]any) error
 	FriendsList(ctx context.Context, userID string, limit int, state *int, cursor string) ([]*api.Friend, string, error)
 	FriendsOfFriendsList(ctx context.Context, userID string, limit int, cursor string) ([]*api.FriendsOfFriendsList_FriendOfFriend, string, error)
-	FriendsAdd(ctx context.Context, userID string, username string, ids []string, usernames []string) error
+	FriendsAdd(ctx context.Context, userID string, username string, ids []string, usernames []string, metadata map[string]any) error
 	FriendsDelete(ctx context.Context, userID string, username string, ids []string, usernames []string) error
 	FriendsBlock(ctx context.Context, userID string, username string, ids []string, usernames []string) error