Merge pull request #202 from adamint/dev

local track serialization, bulk track requesting

Author: adamint

docs/docs/spotify-web-api-kotlin/alltypes/index.html

@@ -11,6 +11,9 @@ <h3>All Types</h3>
 <tr>
 (common, js, jvm) 
 <h5><a href="../com.adamratzman.spotify.models/-abstract-paging-object/index.html">com.adamratzman.spotify.models.AbstractPagingObject</a></h5>
+<p>The offset-based paging object is a container for a set of objects. It contains a key called items
+(whose value is an array of the requested objects) along with other keys like previous, next and
+limit that can be useful in future calls.</p>
 </tr>
 <tr>
 (common, js, jvm) 
@@ -113,6 +116,10 @@ <h5><a href="../com.adamratzman.spotify/-authorization-type/index.html">com.adam
 </tr>
 <tr>
 (common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify.models/-basic-show-information/index.html">com.adamratzman.spotify.models.BasicShowInformation</a></h5>
+</tr>
+<tr>
+(common, js, jvm) 
 <h5><a href="../com.adamratzman.spotify.endpoints.public/-browse-a-p-i.html">com.adamratzman.spotify.endpoints.public.BrowseAPI</a></h5>
 </tr>
 <tr>
@@ -177,9 +184,18 @@ <h5><a href="../com.adamratzman.spotify.endpoints.client/-client-profile-api/ind
 </tr>
 <tr>
 (common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify.endpoints.client/-client-search-api/index.html">com.adamratzman.spotify.endpoints.client.ClientSearchApi</a></h5>
+<p>Get Spotify catalog information about artists, albums, tracks, playlists, episodes, or shows that match a keyword string.</p>
+</tr>
+<tr>
+(common, js, jvm) 
 <h5><a href="../com.adamratzman.spotify.endpoints.client/-client-user-a-p-i.html">com.adamratzman.spotify.endpoints.client.ClientUserAPI</a></h5>
 </tr>
 <tr>
+(common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify.models/-collection-uri/index.html">com.adamratzman.spotify.models.CollectionUri</a></h5>
+</tr>
+<tr>
 (jvm)  (extensions in package com.adamratzman.spotify.utils)
 <h5><a href="../com.adamratzman.spotify.utils/java.util.concurrent.-concurrent-hash-map/index.html">java.util.concurrent.ConcurrentHashMap</a></h5>
 </tr>
@@ -246,6 +262,19 @@ <h5><a href="../com.adamratzman.spotify.models/-disallowable-playback-action/ind
 </tr>
 <tr>
 (common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify.models/-episode/index.html">com.adamratzman.spotify.models.Episode</a></h5>
+<p>An episode (podcast) on Spotify</p>
+</tr>
+<tr>
+(common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify.endpoints.public/-episode-api/index.html">com.adamratzman.spotify.endpoints.public.EpisodeApi</a></h5>
+</tr>
+<tr>
+(common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify.models/-episode-uri/index.html">com.adamratzman.spotify.models.EpisodeUri</a></h5>
+</tr>
+<tr>
+(common, js, jvm) 
 <h5><a href="../com.adamratzman.spotify.models/-error-object/index.html">com.adamratzman.spotify.models.ErrorObject</a></h5>
 <p>An endpoint exception from Spotify</p>
 </tr>
@@ -288,6 +317,12 @@ <h5><a href="../com.adamratzman.spotify.endpoints.public/-following-api/index.ht
 <p>This endpoint allow you check the playlists that a Spotify user follows.</p>
 </tr>
 <tr>
+(common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify/-generic-spotify-api.html">com.adamratzman.spotify.GenericSpotifyApi</a></h5>
+<p>Represents a generic instance of the Spotify API client, with common functionality and information between
+implementations of the API</p>
+</tr>
+<tr>
 (js)  (extensions in package com.adamratzman.spotify.utils)
 <h5><a href="../com.adamratzman.spotify.utils/kotlin.collections.-hash-map/index.html">kotlin.collections.HashMap</a></h5>
 </tr>
@@ -324,6 +359,10 @@ <h5><a href="../com.adamratzman.spotify.models/-identifiable-nullable/index.html
 </tr>
 <tr>
 (common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify.models/-immutable-collection-uri/index.html">com.adamratzman.spotify.models.ImmutableCollectionUri</a></h5>
+</tr>
+<tr>
+(common, js, jvm) 
 <h5><a href="../com.adamratzman.spotify/-i-spotify-api-builder/index.html">com.adamratzman.spotify.ISpotifyApiBuilder</a></h5>
 <p>Spotify Api builder interface</p>
 </tr>
@@ -361,6 +400,11 @@ <h5><a href="../com.adamratzman.spotify.utils/-locale/index.html">com.adamratzma
 </tr>
 <tr>
 (common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify.models/-local-track/index.html">com.adamratzman.spotify.models.LocalTrack</a></h5>
+<p>Local track object that representing a song uploaded from a client locally</p>
+</tr>
+<tr>
+(common, js, jvm) 
 <h5><a href="../com.adamratzman.spotify.models/-local-track-uri/index.html">com.adamratzman.spotify.models.LocalTrackUri</a></h5>
 <p>Represents a Spotify <strong>local track</strong> URI</p>
 </tr>
@@ -380,17 +424,36 @@ <h5><a href="../com.adamratzman.spotify.models/-needs-api/index.html">com.adamra
 </tr>
 <tr>
 (common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify.models/-nullable-paging-object/index.html">com.adamratzman.spotify.models.NullablePagingObject</a></h5>
+<p>The offset-based nullable paging object is a container for a set of objects. It contains a key called items
+(whose value is an array of the requested objects) along with other keys like previous, next and
+limit that can be useful in future calls. Its items are not guaranteed to be not null</p>
+</tr>
+<tr>
+(common, js, jvm) 
 <h5><a href="../com.adamratzman.spotify.models/-paging-object/index.html">com.adamratzman.spotify.models.PagingObject</a></h5>
-<p>The offset-based paging object is a container for a set of objects. It contains a key called items
+<p>The offset-based non-nullable paging object is a container for a set of objects. It contains a key called items
 (whose value is an array of the requested objects) along with other keys like previous, next and
 limit that can be useful in future calls.</p>
 </tr>
 <tr>
 (common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify.models/-paging-object-base/index.html">com.adamratzman.spotify.models.PagingObjectBase</a></h5>
+</tr>
+<tr>
+(common, js, jvm) 
 <h5><a href="../com.adamratzman.spotify.models/-paging-traversal-type/index.html">com.adamratzman.spotify.models.PagingTraversalType</a></h5>
 </tr>
 <tr>
 (common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify.models/-playable/index.html">com.adamratzman.spotify.models.Playable</a></h5>
+</tr>
+<tr>
+(common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify.models/-playable-uri/index.html">com.adamratzman.spotify.models.PlayableUri</a></h5>
+</tr>
+<tr>
+(common, js, jvm) 
 <h5><a href="../com.adamratzman.spotify.models/-playback-action/index.html">com.adamratzman.spotify.models.PlaybackAction</a></h5>
 <p>Action a user takes that will affect current playback</p>
 </tr>
@@ -484,6 +547,12 @@ <h5><a href="../com.adamratzman.spotify.models/-result-enum/index.html">com.adam
 </tr>
 <tr>
 (common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify.models/-resume-point/index.html">com.adamratzman.spotify.models.ResumePoint</a></h5>
+<p>Represents the user’s most recent position in the episode. Set if the supplied access token is a user token and has
+the scope <a href="../com.adamratzman.spotify/-spotify-scope/-u-s-e-r_-r-e-a-d_-p-l-a-y-b-a-c-k_-p-o-s-i-t-i-o-n.html#com.adamratzman.spotify.SpotifyScope.USER_READ_PLAYBACK_POSITION">SpotifyScope.USER_READ_PLAYBACK_POSITION</a>.</p>
+</tr>
+<tr>
+(common, js, jvm) 
 <h5><a href="../com.adamratzman.spotify.models/-saved-album/index.html">com.adamratzman.spotify.models.SavedAlbum</a></h5>
 <p>Represents an album saved in a user's library</p>
 </tr>
@@ -499,7 +568,22 @@ <h5><a href="../com.adamratzman.spotify.endpoints.public/-search-a-p-i.html">com
 <tr>
 (common, js, jvm) 
 <h5><a href="../com.adamratzman.spotify.endpoints.public/-search-api/index.html">com.adamratzman.spotify.endpoints.public.SearchApi</a></h5>
-<p>Get Spotify catalog information about artists, albums, tracks or playlists that match a keyword string.</p>
+<p>Get Spotify catalog information about artists, albums, tracks or playlists that match a keyword string.
+It is possible to have 0 results and no exception thrown with these methods. Check the size of items returned.</p>
+</tr>
+<tr>
+(common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify.models/-show/index.html">com.adamratzman.spotify.models.Show</a></h5>
+<p>Information about a Spotify show, including its episodes</p>
+</tr>
+<tr>
+(common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify.endpoints.public/-show-api/index.html">com.adamratzman.spotify.endpoints.public.ShowApi</a></h5>
+<p>Endpoints for retrieving information about one or more shows and their episodes from the Spotify catalog.</p>
+</tr>
+<tr>
+(common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify.models/-show-uri/index.html">com.adamratzman.spotify.models.ShowUri</a></h5>
 </tr>
 <tr>
 (common, js, jvm) 
@@ -513,11 +597,31 @@ <h5><a href="../com.adamratzman.spotify.models/-simple-artist/index.html">com.ad
 </tr>
 <tr>
 (common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify.models/-simple-episode/index.html">com.adamratzman.spotify.models.SimpleEpisode</a></h5>
+<p>A simplified episode (podcast) on Spotify</p>
+</tr>
+<tr>
+(common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify.models/-simple-local-album/index.html">com.adamratzman.spotify.models.SimpleLocalAlbum</a></h5>
+<p>Local album object that goes with <a href="../com.adamratzman.spotify.models/-local-track/index.html#com.adamratzman.spotify.models.LocalTrack">LocalTrack</a> - represents the local album it was obtained from (likely "Local Files")</p>
+</tr>
+<tr>
+(common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify.models/-simple-local-artist/index.html">com.adamratzman.spotify.models.SimpleLocalArtist</a></h5>
+<p>Local artist object (goes with <a href="../com.adamratzman.spotify.models/-local-track/index.html#com.adamratzman.spotify.models.LocalTrack">LocalTrack</a>) representing an artist on a local track</p>
+</tr>
+<tr>
+(common, js, jvm) 
 <h5><a href="../com.adamratzman.spotify.models/-simple-playlist/index.html">com.adamratzman.spotify.models.SimplePlaylist</a></h5>
 <p>Simplified Playlist object that can be used to retrieve a full <a href="../com.adamratzman.spotify.models/-playlist/index.html#com.adamratzman.spotify.models.Playlist">Playlist</a></p>
 </tr>
 <tr>
 (common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify.models/-simple-show/index.html">com.adamratzman.spotify.models.SimpleShow</a></h5>
+<p>Basic information about a Spotify show</p>
+</tr>
+<tr>
+(common, js, jvm) 
 <h5><a href="../com.adamratzman.spotify.models/-simple-track/index.html">com.adamratzman.spotify.models.SimpleTrack</a></h5>
 <p>Simplified Playlist object that can be used to retrieve a full <a href="../com.adamratzman.spotify.models/-playlist/index.html#com.adamratzman.spotify.models.Playlist">Playlist</a></p>
 </tr>
@@ -623,6 +727,12 @@ <h5><a href="../com.adamratzman.spotify.models/-spotify-image/index.html">com.ad
 </tr>
 <tr>
 (common, js, jvm) 
+<h5><a href="../com.adamratzman.spotify/-spotify-implicit-grant-api/index.html">com.adamratzman.spotify.SpotifyImplicitGrantApi</a></h5>
+<p>An API instance created through implicit grant flow, with access to private information
+managed through the scopes exposed in <a href="#">token</a>. <a href="#">token</a> is not refreshable and is only accessible for limited time.</p>
+</tr>
+<tr>
+(common, js, jvm) 
 <h5><a href="../com.adamratzman.spotify/-spotify-logger/index.html">com.adamratzman.spotify.SpotifyLogger</a></h5>
 </tr>
 <tr>
@@ -753,13 +863,11 @@ <h5><a href="../com.adamratzman.spotify.endpoints.public/-tracks-a-p-i.html">com
 </tr>
 <tr>
 (common, js, jvm) 
-<h5><a href="../com.adamratzman.spotify.models/-track-uri/index.html">com.adamratzman.spotify.models.TrackUri</a></h5>
-<p>Represents a Spotify <strong>Track</strong> URI, ether LocalTrack or SpotifyTrack, parsed from either a Spotify ID or taken
-from an endpoint</p>
+<h5><a href="../com.adamratzman.spotify.models/-track-u-r-i.html">com.adamratzman.spotify.models.TrackURI</a></h5>
 </tr>
 <tr>
 (common, js, jvm) 
-<h5><a href="../com.adamratzman.spotify.models/-track-u-r-i.html">com.adamratzman.spotify.models.TrackURI</a></h5>
+<h5><a href="../com.adamratzman.spotify.models/-track-uri.html">com.adamratzman.spotify.models.TrackUri</a></h5>
 </tr>
 <tr>
 (common, js, jvm) 

docs/docs/spotify-web-api-kotlin/com.adamratzman.spotify.annotations/-spotify-experimental-http-api/index.html

@@ -9,7 +9,7 @@
 <br/>
 <h1>SpotifyExperimentalHttpApi</h1>
 <a name="com.adamratzman.spotify.annotations.SpotifyExperimentalHttpApi"></a>
-(common, js, jvm) <code><span class="identifier">@Target</span><span class="symbol">(</span>[AnnotationTarget.CLASS, AnnotationTarget.FUNCTION]<span class="symbol">)</span> <span class="keyword">annotation</span> <span class="keyword">class </span><span class="identifier">SpotifyExperimentalHttpApi</span></code>
+(common, js, jvm) <code><span class="identifier">@Target</span><span class="symbol">(</span>[AnnotationTarget.CLASS, AnnotationTarget.FUNCTION, AnnotationTarget.PROPERTY]<span class="symbol">)</span> <span class="keyword">annotation</span> <span class="keyword">class </span><span class="identifier">SpotifyExperimentalHttpApi</span></code>
 <h3>Constructors</h3>
 <table>
 <tbody>

docs/docs/spotify-web-api-kotlin/com.adamratzman.spotify.endpoints.client/-client-following-api/-init-.html

@@ -9,7 +9,7 @@
 <br/>
 <h1>&lt;init&gt;</h1>
 <a name="com.adamratzman.spotify.endpoints.client.ClientFollowingApi$&lt;init&gt;(com.adamratzman.spotify.SpotifyApi((, com.adamratzman.spotify.ISpotifyApiBuilder((, )))))"></a>
-(common, js, jvm) <code><span class="identifier">&lt;init&gt;</span><span class="symbol">(</span><span class="identifier" id="com.adamratzman.spotify.endpoints.client.ClientFollowingApi$<init>(com.adamratzman.spotify.SpotifyApi((, com.adamratzman.spotify.ISpotifyApiBuilder((, )))))/api">api</span><span class="symbol">:</span>&nbsp;<a href="../../com.adamratzman.spotify/-spotify-api/index.html"><span class="identifier">SpotifyApi</span></a><span class="symbol">&lt;</span><span class="identifier">*</span><span class="symbol">,</span>&nbsp;<span class="identifier">*</span><span class="symbol">&gt;</span><span class="symbol">)</span></code>
+(common, js, jvm) <code><span class="identifier">&lt;init&gt;</span><span class="symbol">(</span><span class="identifier" id="com.adamratzman.spotify.endpoints.client.ClientFollowingApi$<init>(com.adamratzman.spotify.SpotifyApi((, com.adamratzman.spotify.ISpotifyApiBuilder((, )))))/api">api</span><span class="symbol">:</span>&nbsp;<a href="../../com.adamratzman.spotify/-generic-spotify-api.html"><span class="identifier">GenericSpotifyApi</span></a><span class="symbol">)</span></code>
 <p>These endpoints allow you manage the artists, users and playlists that a Spotify user follows.</p>
 <p><strong><a href="https://developer.spotify.com/documentation/web-api/reference/follow/">Api Reference</a></strong></p>
 </BODY>

docs/docs/spotify-web-api-kotlin/com.adamratzman.spotify.endpoints.client/-client-following-api/index.html

@@ -22,7 +22,7 @@ <h4><a href="-init-.html">&lt;init&gt;</a></h4>
 </td>
 <td>
 <p>These endpoints allow you manage the artists, users and playlists that a Spotify user follows.</p>
-<code><span class="identifier">&lt;init&gt;</span><span class="symbol">(</span><span class="identifier" id="com.adamratzman.spotify.endpoints.client.ClientFollowingApi$<init>(com.adamratzman.spotify.SpotifyApi((, com.adamratzman.spotify.ISpotifyApiBuilder((, )))))/api">api</span><span class="symbol">:</span>&nbsp;<a href="../../com.adamratzman.spotify/-spotify-api/index.html"><span class="identifier">SpotifyApi</span></a><span class="symbol">&lt;</span><span class="identifier">*</span><span class="symbol">,</span>&nbsp;<span class="identifier">*</span><span class="symbol">&gt;</span><span class="symbol">)</span></code></td>
+<code><span class="identifier">&lt;init&gt;</span><span class="symbol">(</span><span class="identifier" id="com.adamratzman.spotify.endpoints.client.ClientFollowingApi$<init>(com.adamratzman.spotify.SpotifyApi((, com.adamratzman.spotify.ISpotifyApiBuilder((, )))))/api">api</span><span class="symbol">:</span>&nbsp;<a href="../../com.adamratzman.spotify/-generic-spotify-api.html"><span class="identifier">GenericSpotifyApi</span></a><span class="symbol">)</span></code></td>
 </tr>
 </tbody>
 </table>

docs/docs/spotify-web-api-kotlin/com.adamratzman.spotify.endpoints.client/-client-library-api/-init-.html

@@ -9,7 +9,7 @@
 <br/>
 <h1>&lt;init&gt;</h1>
 <a name="com.adamratzman.spotify.endpoints.client.ClientLibraryApi$&lt;init&gt;(com.adamratzman.spotify.SpotifyApi((, com.adamratzman.spotify.ISpotifyApiBuilder((, )))))"></a>
-(common, js, jvm) <code><span class="identifier">&lt;init&gt;</span><span class="symbol">(</span><span class="identifier" id="com.adamratzman.spotify.endpoints.client.ClientLibraryApi$<init>(com.adamratzman.spotify.SpotifyApi((, com.adamratzman.spotify.ISpotifyApiBuilder((, )))))/api">api</span><span class="symbol">:</span>&nbsp;<a href="../../com.adamratzman.spotify/-spotify-api/index.html"><span class="identifier">SpotifyApi</span></a><span class="symbol">&lt;</span><span class="identifier">*</span><span class="symbol">,</span>&nbsp;<span class="identifier">*</span><span class="symbol">&gt;</span><span class="symbol">)</span></code>
+(common, js, jvm) <code><span class="identifier">&lt;init&gt;</span><span class="symbol">(</span><span class="identifier" id="com.adamratzman.spotify.endpoints.client.ClientLibraryApi$<init>(com.adamratzman.spotify.SpotifyApi((, com.adamratzman.spotify.ISpotifyApiBuilder((, )))))/api">api</span><span class="symbol">:</span>&nbsp;<a href="../../com.adamratzman.spotify/-generic-spotify-api.html"><span class="identifier">GenericSpotifyApi</span></a><span class="symbol">)</span></code>
 <p>Endpoints for retrieving information about, and managing, tracks that the current user has saved in their “Your Music” library.</p>
 <p><strong><a href="https://developer.spotify.com/documentation/web-api/reference/library/">Api Reference</a></strong></p>
 </BODY>

docs/docs/spotify-web-api-kotlin/com.adamratzman.spotify.endpoints.client/-client-library-api/index.html

@@ -22,7 +22,7 @@ <h4><a href="-init-.html">&lt;init&gt;</a></h4>
 </td>
 <td>
 <p>Endpoints for retrieving information about, and managing, tracks that the current user has saved in their “Your Music” library.</p>
-<code><span class="identifier">&lt;init&gt;</span><span class="symbol">(</span><span class="identifier" id="com.adamratzman.spotify.endpoints.client.ClientLibraryApi$<init>(com.adamratzman.spotify.SpotifyApi((, com.adamratzman.spotify.ISpotifyApiBuilder((, )))))/api">api</span><span class="symbol">:</span>&nbsp;<a href="../../com.adamratzman.spotify/-spotify-api/index.html"><span class="identifier">SpotifyApi</span></a><span class="symbol">&lt;</span><span class="identifier">*</span><span class="symbol">,</span>&nbsp;<span class="identifier">*</span><span class="symbol">&gt;</span><span class="symbol">)</span></code></td>
+<code><span class="identifier">&lt;init&gt;</span><span class="symbol">(</span><span class="identifier" id="com.adamratzman.spotify.endpoints.client.ClientLibraryApi$<init>(com.adamratzman.spotify.SpotifyApi((, com.adamratzman.spotify.ISpotifyApiBuilder((, )))))/api">api</span><span class="symbol">:</span>&nbsp;<a href="../../com.adamratzman.spotify/-generic-spotify-api.html"><span class="identifier">GenericSpotifyApi</span></a><span class="symbol">)</span></code></td>
 </tr>
 </tbody>
 </table>