fix: add ReplacePlaylistItems, which uses the new endpoint

fixes #1040

Author: JohnnyCrazy

SpotifyAPI.Web/Clients/Interfaces/IPlaylistsClient.cs

@@ -169,7 +169,7 @@ public interface IPlaylistsClient
     /// https://developer.spotify.com/documentation/web-api/reference-beta/#endpoint-replace-playlists-tracks
     /// </remarks>
     /// <returns></returns>
-    [Obsolete("Use UpdatePlaylistItems instead, which uses the new PUT /playlists/{id}/items endpoint.")]
+    [Obsolete("Use ReplacePlaylistItems instead, which uses the new PUT /playlists/{id}/items endpoint.")]
     Task<SnapshotResponse> ReplaceItems(string playlistId, PlaylistReplaceItemsRequest request, CancellationToken cancel = default);
 
     /// <summary>
@@ -276,5 +276,18 @@ public interface IPlaylistsClient
     /// </remarks>
     /// <returns></returns>
     Task<SnapshotResponse> UpdatePlaylistItems(string playlistId, PlaylistReorderItemsRequest request, CancellationToken cancel = default);
+
+    /// <summary>
+    /// Replace all the items in a playlist, overwriting its existing items.
+    /// This powerful request can be useful for replacing items, re-ordering existing items, or clearing the playlist.
+    /// </summary>
+    /// <param name="playlistId">The Spotify ID for the playlist.</param>
+    /// <param name="request">The request-model which contains required and optional parameters.</param>
+    /// <param name="cancel">The cancellation-token to allow to cancel the request.</param>
+    /// <remarks>
+    /// https://developer.spotify.com/documentation/web-api/reference-beta/#endpoint-replace-playlists-tracks
+    /// </remarks>
+    /// <returns></returns>
+    Task<SnapshotResponse> ReplacePlaylistItems(string playlistId, PlaylistReplaceItemsRequest request, CancellationToken cancel = default);
   }
 }

SpotifyAPI.Web/Clients/PlaylistsClient.cs

@@ -110,7 +110,7 @@ public Task<FullPlaylist> Get(string playlistId, PlaylistGetRequest request, Can
       return API.Get<FullPlaylist>(URLs.Playlist(playlistId), request.BuildQueryParams(), cancel);
     }
 
-    [System.Obsolete("This endpoint (PUT /playlists/{playlist_id}/tracks) has been removed. Use UpdatePlaylistItems instead, which uses the new PUT /playlists/{id}/items endpoint.")]
+    [System.Obsolete("This endpoint (PUT /playlists/{playlist_id}/tracks) has been removed. Use ReplacePlaylistItems instead, which uses the new PUT /playlists/{id}/items endpoint.")]
     public Task<SnapshotResponse> ReplaceItems(string playlistId, PlaylistReplaceItemsRequest request, CancellationToken cancel = default)
     {
       Ensure.ArgumentNotNullOrEmptyString(playlistId, nameof(playlistId));
@@ -187,5 +187,13 @@ public Task<SnapshotResponse> UpdatePlaylistItems(string playlistId, PlaylistReo
 
       return API.Put<SnapshotResponse>(URLs.PlaylistItems(playlistId), null, request.BuildBodyParams(), cancel);
     }
+
+    public Task<SnapshotResponse> ReplacePlaylistItems(string playlistId, PlaylistReplaceItemsRequest request, CancellationToken cancel = default)
+    {
+      Ensure.ArgumentNotNullOrEmptyString(playlistId, nameof(playlistId));
+      Ensure.ArgumentNotNull(request, nameof(request));
+
+      return API.Put<SnapshotResponse>(URLs.PlaylistItems(playlistId), null, request.BuildBodyParams(), cancel);
+    }
   }
 }