feat: add playlist extraction

- replace original base.js with dummy

src/client/response/mod.rs

@@ -1,14 +1,35 @@
 pub mod player;
 pub mod playlist;
+pub mod playlist_music;
 
 pub use player::Player;
 pub use playlist::Playlist;
+pub use playlist_music::PlaylistMusic;
 
 use serde::Deserialize;
-use serde_with::{serde_as, VecSkipError};
+use serde_with::{serde_as, DefaultOnError, VecSkipError};
 
 use crate::serializer::text::TextLink;
 
+#[derive(Clone, Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct ContentRenderer<T> {
+    pub content: T,
+}
+
+#[derive(Clone, Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct ContentsRenderer<T> {
+    #[serde(alias = "tabs")]
+    pub contents: Vec<T>,
+}
+
+#[derive(Clone, Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct ThumbnailsWrap {
+    pub thumbnail: Thumbnails,
+}
+
 #[derive(Default, Clone, Debug, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct Thumbnails {
@@ -23,6 +44,24 @@ pub struct Thumbnail {
     pub height: u32,
 }
 
+#[derive(Clone, Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct ContinuationItemRenderer {
+    pub continuation_endpoint: ContinuationEndpoint,
+}
+
+#[derive(Clone, Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct ContinuationEndpoint {
+    pub continuation_command: ContinuationCommand,
+}
+
+#[derive(Clone, Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct ContinuationCommand {
+    pub token: String,
+}
+
 // YouTube Music
 
 #[serde_as]
@@ -30,7 +69,9 @@ pub struct Thumbnail {
 #[serde(rename_all = "camelCase")]
 pub struct MusicItem {
     pub thumbnail: MusicThumbnailRenderer,
-    pub playlist_item_data: PlaylistItemData,
+    #[serde(default)]
+    #[serde_as(deserialize_as = "DefaultOnError")]
+    pub playlist_item_data: Option<PlaylistItemData>,
     #[serde(default)]
     #[serde_as(as = "VecSkipError<_>")]
     pub flex_columns: Vec<MusicColumn>,
@@ -42,13 +83,8 @@ pub struct MusicItem {
 #[derive(Clone, Debug, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct MusicThumbnailRenderer {
-    pub music_thumbnail_renderer: MusicThumbnailRenderer2,
-}
-
-#[derive(Clone, Debug, Deserialize)]
-#[serde(rename_all = "camelCase")]
-pub struct MusicThumbnailRenderer2 {
-    pub thumbnail: Thumbnails,
+    #[serde(alias = "croppedSquareThumbnailRenderer")]
+    pub music_thumbnail_renderer: ThumbnailsWrap,
 }
 
 #[derive(Clone, Debug, Deserialize)]
@@ -57,6 +93,15 @@ pub struct PlaylistItemData {
     pub video_id: String,
 }
 
+#[serde_as]
+#[derive(Clone, Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct MusicContentsRenderer<T> {
+    pub contents: Vec<T>,
+    #[serde_as(as = "Option<VecSkipError<_>>")]
+    pub continuations: Option<Vec<MusicContinuation>>,
+}
+
 #[derive(Clone, Debug, Deserialize)]
 pub struct MusicColumn {
     #[serde(
@@ -69,6 +114,18 @@ pub struct MusicColumn {
 #[serde_as]
 #[derive(Clone, Debug, Deserialize)]
 pub struct MusicColumnRenderer {
-    #[serde_as(as = "crate::serializer::text::TextLink")]
-    pub text: TextLink,
+    #[serde_as(as = "crate::serializer::text::TextLinks")]
+    pub text: Vec<TextLink>,
+}
+
+#[derive(Clone, Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct MusicContinuation {
+    pub next_continuation_data: MusicContinuationData,
+}
+
+#[derive(Clone, Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct MusicContinuationData {
+    pub continuation: String,
 }

src/client/response/playlist.rs

@@ -2,21 +2,21 @@ use serde::Deserialize;
 use serde_with::serde_as;
 use serde_with::{json::JsonString, DefaultOnError, VecSkipError};
 
-use crate::serializer::text::TextLink;
+use crate::serializer::text::{Text, TextLink};
 
-use super::{MusicItem, Thumbnails};
+use super::{ContentRenderer, ContentsRenderer, ContinuationEndpoint, Thumbnails, ThumbnailsWrap};
 
 #[derive(Clone, Debug, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct Playlist {
     pub contents: Contents,
     pub header: Header,
+    pub sidebar: Sidebar,
 }
 
 #[derive(Clone, Debug, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct Contents {
-    #[serde(alias = "singleColumnBrowseResultsRenderer")]
     pub two_column_browse_results_renderer: ContentsRenderer<Tab>,
 }
 
@@ -35,26 +35,35 @@ pub struct SectionList {
 #[derive(Clone, Debug, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ItemSection {
-    pub item_section_renderer: Option<ContentsRenderer<PlaylistVideoList>>,
-    pub music_playlist_shelf_renderer: Option<ContentsRenderer<PlaylistMusicItem>>,
+    pub item_section_renderer: ContentsRenderer<PlaylistVideoListRenderer>,
 }
 
+#[derive(Clone, Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct PlaylistVideoListRenderer {
+    pub playlist_video_list_renderer: PlaylistVideoList,
+}
+
+#[serde_as]
 #[derive(Clone, Debug, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct PlaylistVideoList {
-    pub playlist_video_list_renderer: ContentsRenderer<PlaylistVideoItem>,
+    #[serde_as(as = "VecSkipError<_>")]
+    pub contents: Vec<PlaylistVideoItem>,
 }
 
+#[serde_as]
 #[derive(Clone, Debug, Deserialize)]
 #[serde(rename_all = "camelCase")]
-pub struct PlaylistVideoItem {
-    pub playlist_video_renderer: PlaylistVideo,
-}
-
-#[derive(Clone, Debug, Deserialize)]
-#[serde(rename_all = "camelCase")]
-pub struct PlaylistMusicItem {
-    pub music_responsive_list_item_renderer: MusicItem,
+pub enum PlaylistVideoItem {
+    PlaylistVideoRenderer {
+        #[serde(flatten)]
+        video: PlaylistVideo,
+    },
+    #[serde(rename_all = "camelCase")]
+    ContinuationItemRenderer {
+        continuation_endpoint: ContinuationEndpoint,
+    },
 }
 
 #[serde_as]
@@ -76,7 +85,6 @@ pub struct PlaylistVideo {
 #[derive(Clone, Debug, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct Header {
-    #[serde(alias = "musicDetailHeaderRenderer")]
     pub playlist_header_renderer: HeaderRenderer,
 }
 
@@ -84,22 +92,63 @@ pub struct Header {
 #[derive(Clone, Debug, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct HeaderRenderer {
-    pub playlist_id: Option<String>,
+    pub playlist_id: String,
     #[serde_as(as = "crate::serializer::text::Text")]
     pub title: String,
-    #[serde_as(as = "Option<crate::serializer::text::Text>")]
-    pub description: Option<String>,
+    #[serde(default)]
+    #[serde_as(as = "DefaultOnError<Option<crate::serializer::text::Text>>")]
+    pub description_text: Option<String>,
+    /// `"495", " videos"`
+    pub num_videos_text: Text,
 }
 
 #[derive(Clone, Debug, Deserialize)]
 #[serde(rename_all = "camelCase")]
-pub struct ContentRenderer<T> {
-    pub content: T,
+pub struct Sidebar {
+    pub playlist_sidebar_renderer: SidebarRenderer,
+}
+
+#[serde_as]
+#[derive(Clone, Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct SidebarRenderer {
+    #[serde_as(as = "VecSkipError<_>")]
+    pub items: Vec<SidebarRendererItem>,
 }
 
 #[derive(Clone, Debug, Deserialize)]
 #[serde(rename_all = "camelCase")]
-pub struct ContentsRenderer<T> {
-    #[serde(alias = "tabs")]
-    pub contents: Vec<T>,
+pub enum SidebarRendererItem {
+    #[serde(rename_all = "camelCase")]
+    PlaylistSidebarPrimaryInfoRenderer {
+        thumbnail_renderer: PlaylistThumbnailRenderer,
+        // - `"495", " videos"`
+        // - `"3,310,996 views"`
+        // - `"Last updated on ", "Aug 7, 2022"`
+        // stats: Vec<Text>,
+    },
+    #[serde(rename_all = "camelCase")]
+    PlaylistSidebarSecondaryInfoRenderer { video_owner: VideoOwnerWrap },
+}
+
+#[derive(Clone, Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct PlaylistThumbnailRenderer {
+    // the alternative field name is used by YTM playlists
+    #[serde(alias = "playlistCustomThumbnailRenderer")]
+    pub playlist_video_thumbnail_renderer: ThumbnailsWrap,
+}
+
+#[derive(Clone, Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct VideoOwnerWrap {
+    pub video_owner_renderer: VideoOwner,
+}
+
+#[serde_as]
+#[derive(Clone, Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct VideoOwner {
+    #[serde_as(as = "crate::serializer::text::TextLink")]
+    pub title: TextLink,
 }

src/client/response/playlist_music.rs

@@ -0,0 +1,95 @@
+use serde::Deserialize;
+use serde_with::serde_as;
+use serde_with::VecSkipError;
+
+use crate::serializer::text::Text;
+
+use super::MusicThumbnailRenderer;
+use super::{
+    ContentRenderer, ContentsRenderer, MusicContentsRenderer, MusicContinuation, MusicItem,
+};
+
+#[derive(Clone, Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct PlaylistMusic {
+    pub contents: Contents,
+    pub header: Header,
+}
+
+#[derive(Clone, Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct Contents {
+    pub single_column_browse_results_renderer: ContentsRenderer<Tab>,
+}
+
+#[derive(Clone, Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct Tab {
+    pub tab_renderer: ContentRenderer<SectionList>,
+}
+
+#[derive(Clone, Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct SectionList {
+    /// Includes a continuation token for fetching recommendations
+    pub section_list_renderer: MusicContentsRenderer<ItemSection>,
+}
+
+#[derive(Clone, Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct ItemSection {
+    #[serde(alias = "musicPlaylistShelfRenderer")]
+    pub music_shelf_renderer: MusicShelf,
+}
+
+#[serde_as]
+#[derive(Clone, Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct MusicShelf {
+    /// Playlist ID (only for playlists)
+    pub playlist_id: Option<String>,
+    #[serde_as(as = "VecSkipError<_>")]
+    pub contents: Vec<PlaylistMusicItem>,
+    /// Continuation token for fetching more (>100) playlist items
+    #[serde_as(as = "Option<VecSkipError<_>>")]
+    pub continuations: Option<Vec<MusicContinuation>>,
+}
+
+#[derive(Clone, Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct PlaylistMusicItem {
+    pub music_responsive_list_item_renderer: MusicItem,
+}
+
+#[derive(Clone, Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct Header {
+    pub music_detail_header_renderer: HeaderRenderer,
+}
+
+#[serde_as]
+#[derive(Clone, Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct HeaderRenderer {
+    #[serde_as(as = "crate::serializer::text::Text")]
+    pub title: String,
+    /// Content type + Channel/Artist + Year.
+    /// Missing on artist_tracks view.
+    ///
+    /// `"Playlist", " • ", <"Best Music">, " • ", "2022"`
+    ///
+    /// `"Album", " • ", <"Helene Fischer">, " • ", "2021"`
+    pub subtitle: Option<Text>,
+    /// Playlist description. May contain hashtags which are
+    /// displayed as search links on the YouTube website.
+    #[serde_as(as = "Option<crate::serializer::text::Text>")]
+    pub description: Option<String>,
+    /// Playlist thumbnail / album cover.
+    /// Missing on artist_tracks view.
+    pub thumbnail: Option<MusicThumbnailRenderer>,
+    /// Number of tracks + playtime.
+    /// Missing on artist_tracks view.
+    ///
+    /// `"64 songs", " • ", "3 hours, 40 minutes"`
+    pub second_subtitle: Option<Text>,
+}