spotted-ts 0.1.0

package/resources/shared.d.ts

@@ -0,0 +1,1010 @@
+import * as Shared from "./shared.js";
+import { CursorURLPage } from "../core/pagination.js";
+export interface AlbumRestrictionObject {
+    /**
+     * The reason for the restriction. Albums may be restricted if the content is not
+     * available in a given market, to the user's subscription type, or when the user's
+     * account is set to not play explicit content. Additional reasons may be added in
+     * the future.
+     */
+    reason?: 'market' | 'product' | 'explicit';
+}
+export interface ArtistObject {
+    /**
+     * The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the
+     * artist.
+     */
+    id?: string;
+    /**
+     * Known external URLs for this artist.
+     */
+    external_urls?: ExternalURLObject;
+    /**
+     * Information about the followers of the artist.
+     */
+    followers?: FollowersObject;
+    /**
+     * A list of the genres the artist is associated with. If not yet classified, the
+     * array is empty.
+     */
+    genres?: Array<string>;
+    /**
+     * A link to the Web API endpoint providing full details of the artist.
+     */
+    href?: string;
+    /**
+     * Images of the artist in various sizes, widest first.
+     */
+    images?: Array<ImageObject>;
+    /**
+     * The name of the artist.
+     */
+    name?: string;
+    /**
+     * The popularity of the artist. The value will be between 0 and 100, with 100
+     * being the most popular. The artist's popularity is calculated from the
+     * popularity of all the artist's tracks.
+     */
+    popularity?: number;
+    /**
+     * The object type.
+     */
+    type?: 'artist';
+    /**
+     * The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
+     * artist.
+     */
+    uri?: string;
+}
+export interface AudiobookBase {
+    /**
+     * The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the
+     * audiobook.
+     */
+    id: string;
+    /**
+     * The author(s) for the audiobook.
+     */
+    authors: Array<AuthorObject>;
+    /**
+     * A list of the countries in which the audiobook can be played, identified by
+     * their [ISO 3166-1 alpha-2](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
+     * code.
+     */
+    available_markets: Array<string>;
+    /**
+     * The copyright statements of the audiobook.
+     */
+    copyrights: Array<CopyrightObject>;
+    /**
+     * A description of the audiobook. HTML tags are stripped away from this field, use
+     * `html_description` field in case HTML tags are needed.
+     */
+    description: string;
+    /**
+     * Whether or not the audiobook has explicit content (true = yes it does; false =
+     * no it does not OR unknown).
+     */
+    explicit: boolean;
+    /**
+     * External URLs for this audiobook.
+     */
+    external_urls: ExternalURLObject;
+    /**
+     * A link to the Web API endpoint providing full details of the audiobook.
+     */
+    href: string;
+    /**
+     * A description of the audiobook. This field may contain HTML tags.
+     */
+    html_description: string;
+    /**
+     * The cover art for the audiobook in various sizes, widest first.
+     */
+    images: Array<ImageObject>;
+    /**
+     * A list of the languages used in the audiobook, identified by their
+     * [ISO 639](https://en.wikipedia.org/wiki/ISO_639) code.
+     */
+    languages: Array<string>;
+    /**
+     * The media type of the audiobook.
+     */
+    media_type: string;
+    /**
+     * The name of the audiobook.
+     */
+    name: string;
+    /**
+     * The narrator(s) for the audiobook.
+     */
+    narrators: Array<NarratorObject>;
+    /**
+     * The publisher of the audiobook.
+     */
+    publisher: string;
+    /**
+     * The number of chapters in this audiobook.
+     */
+    total_chapters: number;
+    /**
+     * The object type.
+     */
+    type: 'audiobook';
+    /**
+     * The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
+     * audiobook.
+     */
+    uri: string;
+    /**
+     * The edition of the audiobook.
+     */
+    edition?: string;
+}
+export interface AuthorObject {
+    /**
+     * The name of the author.
+     */
+    name?: string;
+}
+export interface ChapterRestrictionObject {
+    /**
+     * The reason for the restriction. Supported values:
+     *
+     * - `market` - The content item is not available in the given market.
+     * - `product` - The content item is not available for the user's subscription
+     *   type.
+     * - `explicit` - The content item is explicit and the user's account is set to not
+     *   play explicit content.
+     * - `payment_required` - Payment is required to play the content item.
+     *
+     * Additional reasons may be added in the future. **Note**: If you use this field,
+     * make sure that your application safely handles unknown values.
+     */
+    reason?: string;
+}
+export interface CopyrightObject {
+    /**
+     * The copyright text for this content.
+     */
+    text?: string;
+    /**
+     * The type of copyright: `C` = the copyright, `P` = the sound recording
+     * (performance) copyright.
+     */
+    type?: string;
+}
+export interface EpisodeObject {
+    /**
+     * The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the
+     * episode.
+     */
+    id: string;
+    /**
+     * @deprecated A URL to a 30 second preview (MP3 format) of the episode. `null` if
+     * not available.
+     */
+    audio_preview_url: string | null;
+    /**
+     * A description of the episode. HTML tags are stripped away from this field, use
+     * `html_description` field in case HTML tags are needed.
+     */
+    description: string;
+    /**
+     * The episode length in milliseconds.
+     */
+    duration_ms: number;
+    /**
+     * Whether or not the episode has explicit content (true = yes it does; false = no
+     * it does not OR unknown).
+     */
+    explicit: boolean;
+    /**
+     * External URLs for this episode.
+     */
+    external_urls: ExternalURLObject;
+    /**
+     * A link to the Web API endpoint providing full details of the episode.
+     */
+    href: string;
+    /**
+     * A description of the episode. This field may contain HTML tags.
+     */
+    html_description: string;
+    /**
+     * The cover art for the episode in various sizes, widest first.
+     */
+    images: Array<ImageObject>;
+    /**
+     * True if the episode is hosted outside of Spotify's CDN.
+     */
+    is_externally_hosted: boolean;
+    /**
+     * True if the episode is playable in the given market. Otherwise false.
+     */
+    is_playable: boolean;
+    /**
+     * A list of the languages used in the episode, identified by their
+     * [ISO 639-1](https://en.wikipedia.org/wiki/ISO_639) code.
+     */
+    languages: Array<string>;
+    /**
+     * The name of the episode.
+     */
+    name: string;
+    /**
+     * The date the episode was first released, for example `"1981-12-15"`. Depending
+     * on the precision, it might be shown as `"1981"` or `"1981-12"`.
+     */
+    release_date: string;
+    /**
+     * The precision with which `release_date` value is known.
+     */
+    release_date_precision: 'year' | 'month' | 'day';
+    /**
+     * The show on which the episode belongs.
+     */
+    show: ShowBase;
+    /**
+     * The object type.
+     */
+    type: 'episode';
+    /**
+     * The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
+     * episode.
+     */
+    uri: string;
+    /**
+     * @deprecated The language used in the episode, identified by a
+     * [ISO 639](https://en.wikipedia.org/wiki/ISO_639) code. This field is deprecated
+     * and might be removed in the future. Please use the `languages` field instead.
+     */
+    language?: string;
+    /**
+     * Included in the response when a content restriction is applied.
+     */
+    restrictions?: EpisodeRestrictionObject;
+    /**
+     * The user's most recent position in the episode. Set if the supplied access token
+     * is a user token and has the scope 'user-read-playback-position'.
+     */
+    resume_point?: ResumePointObject;
+}
+export interface EpisodeRestrictionObject {
+    /**
+     * The reason for the restriction. Supported values:
+     *
+     * - `market` - The content item is not available in the given market.
+     * - `product` - The content item is not available for the user's subscription
+     *   type.
+     * - `explicit` - The content item is explicit and the user's account is set to not
+     *   play explicit content.
+     *
+     * Additional reasons may be added in the future. **Note**: If you use this field,
+     * make sure that your application safely handles unknown values.
+     */
+    reason?: string;
+}
+export interface ExternalIDObject {
+    /**
+     * [International Article Number](http://en.wikipedia.org/wiki/International_Article_Number_%28EAN%29)
+     */
+    ean?: string;
+    /**
+     * [International Standard Recording Code](http://en.wikipedia.org/wiki/International_Standard_Recording_Code)
+     */
+    isrc?: string;
+    /**
+     * [Universal Product Code](http://en.wikipedia.org/wiki/Universal_Product_Code)
+     */
+    upc?: string;
+}
+export interface ExternalURLObject {
+    /**
+     * The [Spotify URL](/documentation/web-api/concepts/spotify-uris-ids) for the
+     * object.
+     */
+    spotify?: string;
+}
+export interface FollowersObject {
+    /**
+     * This will always be set to null, as the Web API does not support it at the
+     * moment.
+     */
+    href?: string | null;
+    /**
+     * The total number of followers.
+     */
+    total?: number;
+}
+export interface ImageObject {
+    /**
+     * The image height in pixels.
+     */
+    height: number | null;
+    /**
+     * The source URL of the image.
+     */
+    url: string;
+    /**
+     * The image width in pixels.
+     */
+    width: number | null;
+}
+export interface LinkedTrackObject {
+    /**
+     * The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the
+     * track.
+     */
+    id?: string;
+    /**
+     * Known external URLs for this track.
+     */
+    external_urls?: ExternalURLObject;
+    /**
+     * A link to the Web API endpoint providing full details of the track.
+     */
+    href?: string;
+    /**
+     * The object type: "track".
+     */
+    type?: string;
+    /**
+     * The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
+     * track.
+     */
+    uri?: string;
+}
+export interface NarratorObject {
+    /**
+     * The name of the Narrator.
+     */
+    name?: string;
+}
+export interface PagingPlaylistObject {
+    /**
+     * A link to the Web API endpoint returning the full result of the request
+     */
+    href: string;
+    items: Array<SimplifiedPlaylistObject>;
+    /**
+     * The maximum number of items in the response (as set in the query or by default).
+     */
+    limit: number;
+    /**
+     * URL to the next page of items. ( `null` if none)
+     */
+    next: string | null;
+    /**
+     * The offset of the items returned (as set in the query or by default)
+     */
+    offset: number;
+    /**
+     * URL to the previous page of items. ( `null` if none)
+     */
+    previous: string | null;
+    /**
+     * The total number of items available to return.
+     */
+    total: number;
+}
+export interface PlaylistTrackObject {
+    /**
+     * The date and time the track or episode was added. _**Note**: some very old
+     * playlists may return `null` in this field._
+     */
+    added_at?: string;
+    /**
+     * The Spotify user who added the track or episode. _**Note**: some very old
+     * playlists may return `null` in this field._
+     */
+    added_by?: PlaylistUserObject;
+    /**
+     * Whether this track or episode is a
+     * [local file](/documentation/web-api/concepts/playlists/#local-files) or not.
+     */
+    is_local?: boolean;
+    /**
+     * Information about the track or episode.
+     */
+    track?: TrackObject | EpisodeObject;
+}
+export interface PlaylistTracksRefObject {
+    /**
+     * A link to the Web API endpoint where full details of the playlist's tracks can
+     * be retrieved.
+     */
+    href?: string;
+    /**
+     * Number of tracks in the playlist.
+     */
+    total?: number;
+}
+export interface PlaylistUserObject {
+    /**
+     * The [Spotify user ID](/documentation/web-api/concepts/spotify-uris-ids) for this
+     * user.
+     */
+    id?: string;
+    /**
+     * Known public external URLs for this user.
+     */
+    external_urls?: ExternalURLObject;
+    /**
+     * A link to the Web API endpoint for this user.
+     */
+    href?: string;
+    /**
+     * The object type.
+     */
+    type?: 'user';
+    /**
+     * The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for this
+     * user.
+     */
+    uri?: string;
+}
+export interface ResumePointObject {
+    /**
+     * Whether or not the episode has been fully played by the user.
+     */
+    fully_played?: boolean;
+    /**
+     * The user's most recent position in the episode in milliseconds.
+     */
+    resume_position_ms?: number;
+}
+export interface ShowBase {
+    /**
+     * The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the show.
+     */
+    id: string;
+    /**
+     * A list of the countries in which the show can be played, identified by their
+     * [ISO 3166-1 alpha-2](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code.
+     */
+    available_markets: Array<string>;
+    /**
+     * The copyright statements of the show.
+     */
+    copyrights: Array<CopyrightObject>;
+    /**
+     * A description of the show. HTML tags are stripped away from this field, use
+     * `html_description` field in case HTML tags are needed.
+     */
+    description: string;
+    /**
+     * Whether or not the show has explicit content (true = yes it does; false = no it
+     * does not OR unknown).
+     */
+    explicit: boolean;
+    /**
+     * External URLs for this show.
+     */
+    external_urls: ExternalURLObject;
+    /**
+     * A link to the Web API endpoint providing full details of the show.
+     */
+    href: string;
+    /**
+     * A description of the show. This field may contain HTML tags.
+     */
+    html_description: string;
+    /**
+     * The cover art for the show in various sizes, widest first.
+     */
+    images: Array<ImageObject>;
+    /**
+     * True if all of the shows episodes are hosted outside of Spotify's CDN. This
+     * field might be `null` in some cases.
+     */
+    is_externally_hosted: boolean;
+    /**
+     * A list of the languages used in the show, identified by their
+     * [ISO 639](https://en.wikipedia.org/wiki/ISO_639) code.
+     */
+    languages: Array<string>;
+    /**
+     * The media type of the show.
+     */
+    media_type: string;
+    /**
+     * The name of the episode.
+     */
+    name: string;
+    /**
+     * The publisher of the show.
+     */
+    publisher: string;
+    /**
+     * The total number of episodes in the show.
+     */
+    total_episodes: number;
+    /**
+     * The object type.
+     */
+    type: 'show';
+    /**
+     * The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
+     * show.
+     */
+    uri: string;
+}
+export interface SimplifiedArtistObject {
+    /**
+     * The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the
+     * artist.
+     */
+    id?: string;
+    /**
+     * Known external URLs for this artist.
+     */
+    external_urls?: ExternalURLObject;
+    /**
+     * A link to the Web API endpoint providing full details of the artist.
+     */
+    href?: string;
+    /**
+     * The name of the artist.
+     */
+    name?: string;
+    /**
+     * The object type.
+     */
+    type?: 'artist';
+    /**
+     * The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
+     * artist.
+     */
+    uri?: string;
+}
+export interface SimplifiedEpisodeObject {
+    /**
+     * The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the
+     * episode.
+     */
+    id: string;
+    /**
+     * @deprecated A URL to a 30 second preview (MP3 format) of the episode. `null` if
+     * not available.
+     */
+    audio_preview_url: string | null;
+    /**
+     * A description of the episode. HTML tags are stripped away from this field, use
+     * `html_description` field in case HTML tags are needed.
+     */
+    description: string;
+    /**
+     * The episode length in milliseconds.
+     */
+    duration_ms: number;
+    /**
+     * Whether or not the episode has explicit content (true = yes it does; false = no
+     * it does not OR unknown).
+     */
+    explicit: boolean;
+    /**
+     * External URLs for this episode.
+     */
+    external_urls: ExternalURLObject;
+    /**
+     * A link to the Web API endpoint providing full details of the episode.
+     */
+    href: string;
+    /**
+     * A description of the episode. This field may contain HTML tags.
+     */
+    html_description: string;
+    /**
+     * The cover art for the episode in various sizes, widest first.
+     */
+    images: Array<ImageObject>;
+    /**
+     * True if the episode is hosted outside of Spotify's CDN.
+     */
+    is_externally_hosted: boolean;
+    /**
+     * True if the episode is playable in the given market. Otherwise false.
+     */
+    is_playable: boolean;
+    /**
+     * A list of the languages used in the episode, identified by their
+     * [ISO 639-1](https://en.wikipedia.org/wiki/ISO_639) code.
+     */
+    languages: Array<string>;
+    /**
+     * The name of the episode.
+     */
+    name: string;
+    /**
+     * The date the episode was first released, for example `"1981-12-15"`. Depending
+     * on the precision, it might be shown as `"1981"` or `"1981-12"`.
+     */
+    release_date: string;
+    /**
+     * The precision with which `release_date` value is known.
+     */
+    release_date_precision: 'year' | 'month' | 'day';
+    /**
+     * The object type.
+     */
+    type: 'episode';
+    /**
+     * The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
+     * episode.
+     */
+    uri: string;
+    /**
+     * @deprecated The language used in the episode, identified by a
+     * [ISO 639](https://en.wikipedia.org/wiki/ISO_639) code. This field is deprecated
+     * and might be removed in the future. Please use the `languages` field instead.
+     */
+    language?: string;
+    /**
+     * Included in the response when a content restriction is applied.
+     */
+    restrictions?: EpisodeRestrictionObject;
+    /**
+     * The user's most recent position in the episode. Set if the supplied access token
+     * is a user token and has the scope 'user-read-playback-position'.
+     */
+    resume_point?: ResumePointObject;
+}
+export interface SimplifiedPlaylistObject {
+    /**
+     * The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the
+     * playlist.
+     */
+    id?: string;
+    /**
+     * `true` if the owner allows other users to modify the playlist.
+     */
+    collaborative?: boolean;
+    /**
+     * The playlist description. _Only returned for modified, verified playlists,
+     * otherwise_ `null`.
+     */
+    description?: string;
+    /**
+     * Known external URLs for this playlist.
+     */
+    external_urls?: ExternalURLObject;
+    /**
+     * A link to the Web API endpoint providing full details of the playlist.
+     */
+    href?: string;
+    /**
+     * Images for the playlist. The array may be empty or contain up to three images.
+     * The images are returned by size in descending order. See
+     * [Working with Playlists](/documentation/web-api/concepts/playlists). _**Note**:
+     * If returned, the source URL for the image (`url`) is temporary and will expire
+     * in less than a day._
+     */
+    images?: Array<ImageObject>;
+    /**
+     * The name of the playlist.
+     */
+    name?: string;
+    /**
+     * The user who owns the playlist
+     */
+    owner?: SimplifiedPlaylistObject.Owner;
+    /**
+     * The playlist's public/private status (if it is added to the user's profile):
+     * `true` the playlist is public, `false` the playlist is private, `null` the
+     * playlist status is not relevant. For more about public/private status, see
+     * [Working with Playlists](/documentation/web-api/concepts/playlists)
+     */
+    public?: boolean;
+    /**
+     * The version identifier for the current playlist. Can be supplied in other
+     * requests to target a specific playlist version
+     */
+    snapshot_id?: string;
+    /**
+     * A collection containing a link ( `href` ) to the Web API endpoint where full
+     * details of the playlist's tracks can be retrieved, along with the `total` number
+     * of tracks in the playlist. Note, a track object may be `null`. This can happen
+     * if a track is no longer available.
+     */
+    tracks?: PlaylistTracksRefObject;
+    /**
+     * The object type: "playlist"
+     */
+    type?: string;
+    /**
+     * The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
+     * playlist.
+     */
+    uri?: string;
+}
+export declare namespace SimplifiedPlaylistObject {
+    /**
+     * The user who owns the playlist
+     */
+    interface Owner extends Shared.PlaylistUserObject {
+        /**
+         * The name displayed on the user's profile. `null` if not available.
+         */
+        display_name?: string | null;
+    }
+}
+export interface SimplifiedTrackObject {
+    /**
+     * The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the
+     * track.
+     */
+    id?: string;
+    /**
+     * The artists who performed the track. Each artist object includes a link in
+     * `href` to more detailed information about the artist.
+     */
+    artists?: Array<SimplifiedArtistObject>;
+    /**
+     * A list of the countries in which the track can be played, identified by their
+     * [ISO 3166-1 alpha-2](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code.
+     */
+    available_markets?: Array<string>;
+    /**
+     * The disc number (usually `1` unless the album consists of more than one disc).
+     */
+    disc_number?: number;
+    /**
+     * The track length in milliseconds.
+     */
+    duration_ms?: number;
+    /**
+     * Whether or not the track has explicit lyrics ( `true` = yes it does; `false` =
+     * no it does not OR unknown).
+     */
+    explicit?: boolean;
+    /**
+     * External URLs for this track.
+     */
+    external_urls?: ExternalURLObject;
+    /**
+     * A link to the Web API endpoint providing full details of the track.
+     */
+    href?: string;
+    /**
+     * Whether or not the track is from a local file.
+     */
+    is_local?: boolean;
+    /**
+     * Part of the response when
+     * [Track Relinking](/documentation/web-api/concepts/track-relinking/) is applied.
+     * If `true`, the track is playable in the given market. Otherwise `false`.
+     */
+    is_playable?: boolean;
+    /**
+     * Part of the response when
+     * [Track Relinking](/documentation/web-api/concepts/track-relinking/) is applied
+     * and is only part of the response if the track linking, in fact, exists. The
+     * requested track has been replaced with a different track. The track in the
+     * `linked_from` object contains information about the originally requested track.
+     */
+    linked_from?: LinkedTrackObject;
+    /**
+     * The name of the track.
+     */
+    name?: string;
+    /**
+     * @deprecated A URL to a 30 second preview (MP3 format) of the track.
+     */
+    preview_url?: string | null;
+    /**
+     * Included in the response when a content restriction is applied.
+     */
+    restrictions?: TrackRestrictionObject;
+    /**
+     * The number of the track. If an album has several discs, the track number is the
+     * number on the specified disc.
+     */
+    track_number?: number;
+    /**
+     * The object type: "track".
+     */
+    type?: string;
+    /**
+     * The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
+     * track.
+     */
+    uri?: string;
+}
+export interface TrackObject {
+    /**
+     * The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the
+     * track.
+     */
+    id?: string;
+    /**
+     * The album on which the track appears. The album object includes a link in `href`
+     * to full information about the album.
+     */
+    album?: TrackObject.Album;
+    /**
+     * The artists who performed the track. Each artist object includes a link in
+     * `href` to more detailed information about the artist.
+     */
+    artists?: Array<SimplifiedArtistObject>;
+    /**
+     * A list of the countries in which the track can be played, identified by their
+     * [ISO 3166-1 alpha-2](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code.
+     */
+    available_markets?: Array<string>;
+    /**
+     * The disc number (usually `1` unless the album consists of more than one disc).
+     */
+    disc_number?: number;
+    /**
+     * The track length in milliseconds.
+     */
+    duration_ms?: number;
+    /**
+     * Whether or not the track has explicit lyrics ( `true` = yes it does; `false` =
+     * no it does not OR unknown).
+     */
+    explicit?: boolean;
+    /**
+     * Known external IDs for the track.
+     */
+    external_ids?: ExternalIDObject;
+    /**
+     * Known external URLs for this track.
+     */
+    external_urls?: ExternalURLObject;
+    /**
+     * A link to the Web API endpoint providing full details of the track.
+     */
+    href?: string;
+    /**
+     * Whether or not the track is from a local file.
+     */
+    is_local?: boolean;
+    /**
+     * Part of the response when
+     * [Track Relinking](/documentation/web-api/concepts/track-relinking) is applied.
+     * If `true`, the track is playable in the given market. Otherwise `false`.
+     */
+    is_playable?: boolean;
+    /**
+     * Part of the response when
+     * [Track Relinking](/documentation/web-api/concepts/track-relinking) is applied,
+     * and the requested track has been replaced with different track. The track in the
+     * `linked_from` object contains information about the originally requested track.
+     */
+    linked_from?: LinkedTrackObject;
+    /**
+     * The name of the track.
+     */
+    name?: string;
+    /**
+     * The popularity of the track. The value will be between 0 and 100, with 100 being
+     * the most popular.<br/>The popularity of a track is a value between 0 and 100,
+     * with 100 being the most popular. The popularity is calculated by algorithm and
+     * is based, in the most part, on the total number of plays the track has had and
+     * how recent those plays are.<br/>Generally speaking, songs that are being played
+     * a lot now will have a higher popularity than songs that were played a lot in the
+     * past. Duplicate tracks (e.g. the same track from a single and an album) are
+     * rated independently. Artist and album popularity is derived mathematically from
+     * track popularity. _**Note**: the popularity value may lag actual popularity by a
+     * few days: the value is not updated in real time._
+     */
+    popularity?: number;
+    /**
+     * @deprecated A link to a 30 second preview (MP3 format) of the track. Can be
+     * `null`
+     */
+    preview_url?: string | null;
+    /**
+     * Included in the response when a content restriction is applied.
+     */
+    restrictions?: TrackRestrictionObject;
+    /**
+     * The number of the track. If an album has several discs, the track number is the
+     * number on the specified disc.
+     */
+    track_number?: number;
+    /**
+     * The object type: "track".
+     */
+    type?: 'track';
+    /**
+     * The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
+     * track.
+     */
+    uri?: string;
+}
+export declare namespace TrackObject {
+    /**
+     * The album on which the track appears. The album object includes a link in `href`
+     * to full information about the album.
+     */
+    interface Album {
+        /**
+         * The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the
+         * album.
+         */
+        id: string;
+        /**
+         * The type of the album.
+         */
+        album_type: 'album' | 'single' | 'compilation';
+        /**
+         * The artists of the album. Each artist object includes a link in `href` to more
+         * detailed information about the artist.
+         */
+        artists: Array<Shared.SimplifiedArtistObject>;
+        /**
+         * The markets in which the album is available:
+         * [ISO 3166-1 alpha-2 country codes](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
+         * _**NOTE**: an album is considered available in a market when at least 1 of its
+         * tracks is available in that market._
+         */
+        available_markets: Array<string>;
+        /**
+         * Known external URLs for this album.
+         */
+        external_urls: Shared.ExternalURLObject;
+        /**
+         * A link to the Web API endpoint providing full details of the album.
+         */
+        href: string;
+        /**
+         * The cover art for the album in various sizes, widest first.
+         */
+        images: Array<Shared.ImageObject>;
+        /**
+         * The name of the album. In case of an album takedown, the value may be an empty
+         * string.
+         */
+        name: string;
+        /**
+         * The date the album was first released.
+         */
+        release_date: string;
+        /**
+         * The precision with which `release_date` value is known.
+         */
+        release_date_precision: 'year' | 'month' | 'day';
+        /**
+         * The number of tracks in the album.
+         */
+        total_tracks: number;
+        /**
+         * The object type.
+         */
+        type: 'album';
+        /**
+         * The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
+         * album.
+         */
+        uri: string;
+        /**
+         * Included in the response when a content restriction is applied.
+         */
+        restrictions?: Shared.AlbumRestrictionObject;
+    }
+}
+export interface TrackRestrictionObject {
+    /**
+     * The reason for the restriction. Supported values:
+     *
+     * - `market` - The content item is not available in the given market.
+     * - `product` - The content item is not available for the user's subscription
+     *   type.
+     * - `explicit` - The content item is explicit and the user's account is set to not
+     *   play explicit content.
+     *
+     * Additional reasons may be added in the future. **Note**: If you use this field,
+     * make sure that your application safely handles unknown values.
+     */
+    reason?: string;
+}
+export type SimplifiedTrackObjectsCursorURLPage = CursorURLPage<SimplifiedTrackObject>;
+export type SimplifiedEpisodeObjectsCursorURLPage = CursorURLPage<SimplifiedEpisodeObject>;
+export type SimplifiedPlaylistObjectsCursorURLPage = CursorURLPage<SimplifiedPlaylistObject>;
+export type ArtistObjectsCursorURLPage = CursorURLPage<ArtistObject>;
+export type TrackObjectsCursorURLPage = CursorURLPage<TrackObject>;
+export type PlaylistTrackObjectsCursorURLPage = CursorURLPage<PlaylistTrackObject>;
+//# sourceMappingURL=shared.d.ts.map