rocksky 0.3.0

// Code generated by tools/lexgen — DO NOT EDIT.
// Source: apps/api/lexicons/**/*.json
// Regenerate via: bun run lexgen:types

#![allow(non_snake_case, non_camel_case_types, dead_code, clippy::large_enum_variant)]

use chrono::{DateTime, Utc};
use serde::{Deserialize, Serialize};
use serde_json::Value;

/// atproto blob reference shape.
#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct BlobRef {
    #[serde(rename = "$type", default, skip_serializing_if = "Option::is_none")]
    pub r#type: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub ref_: Option<BlobCidRef>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub mime_type: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub size: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct BlobCidRef {
    #[serde(rename = "$link", default, skip_serializing_if = "Option::is_none")]
    pub link: Option<String>,
}


#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct ActorArtistViewBasic {
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub name: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub picture: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub uri: Option<String>,
    #[serde(rename = "user1Rank", default, skip_serializing_if = "Option::is_none")]
    pub user1_rank: Option<i64>,
    #[serde(rename = "user2Rank", default, skip_serializing_if = "Option::is_none")]
    pub user2_rank: Option<i64>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub weight: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct ActorCompatibilityViewBasic {
    #[serde(rename = "compatibilityLevel", default, skip_serializing_if = "Option::is_none")]
    pub compatibility_level: Option<i64>,
    #[serde(rename = "compatibilityPercentage", default, skip_serializing_if = "Option::is_none")]
    pub compatibility_percentage: Option<i64>,
    #[serde(rename = "sharedArtists", default, skip_serializing_if = "Option::is_none")]
    pub shared_artists: Option<i64>,
    #[serde(rename = "topSharedArtistNames", default, skip_serializing_if = "Vec::is_empty")]
    pub top_shared_artist_names: Vec<String>,
    #[serde(rename = "topSharedDetailedArtists", default, skip_serializing_if = "Vec::is_empty")]
    pub top_shared_detailed_artists: Vec<ActorArtistViewBasic>,
    #[serde(rename = "user1ArtistCount", default, skip_serializing_if = "Option::is_none")]
    pub user1_artist_count: Option<i64>,
    #[serde(rename = "user2ArtistCount", default, skip_serializing_if = "Option::is_none")]
    pub user2_artist_count: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct ActorNeighbourViewBasic {
    #[serde(rename = "userId", default, skip_serializing_if = "Option::is_none")]
    pub user_id: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub did: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub handle: Option<String>,
    #[serde(rename = "displayName", default, skip_serializing_if = "Option::is_none")]
    pub display_name: Option<String>,
    /// The URL of the actor's avatar image.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub avatar: Option<String>,
    /// The number of artists shared with the actor.
    #[serde(rename = "sharedArtistsCount", default, skip_serializing_if = "Option::is_none")]
    pub shared_artists_count: Option<i64>,
    /// The similarity score with the actor.
    #[serde(rename = "similarityScore", default, skip_serializing_if = "Option::is_none")]
    pub similarity_score: Option<i64>,
    /// The top shared artist names with the actor.
    #[serde(rename = "topSharedArtistNames", default, skip_serializing_if = "Vec::is_empty")]
    pub top_shared_artist_names: Vec<String>,
    /// The top shared artist details with the actor.
    #[serde(rename = "topSharedArtistsDetails", default, skip_serializing_if = "Vec::is_empty")]
    pub top_shared_artists_details: Vec<ArtistViewBasic>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct ActorProfileViewBasic {
    /// The unique identifier of the actor.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    /// The DID of the actor.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub did: Option<String>,
    /// The handle of the actor.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub handle: Option<String>,
    /// The display name of the actor.
    #[serde(rename = "displayName", default, skip_serializing_if = "Option::is_none")]
    pub display_name: Option<String>,
    /// The URL of the actor's avatar image.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub avatar: Option<String>,
    /// The date and time when the actor was created.
    #[serde(rename = "createdAt", default, skip_serializing_if = "Option::is_none")]
    pub created_at: Option<DateTime<Utc>>,
    /// The date and time when the actor was last updated.
    #[serde(rename = "updatedAt", default, skip_serializing_if = "Option::is_none")]
    pub updated_at: Option<DateTime<Utc>>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct ActorProfileViewDetailed {
    /// The unique identifier of the actor.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    /// The DID of the actor.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub did: Option<String>,
    /// The handle of the actor.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub handle: Option<String>,
    /// The display name of the actor.
    #[serde(rename = "displayName", default, skip_serializing_if = "Option::is_none")]
    pub display_name: Option<String>,
    /// The URL of the actor's avatar image.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub avatar: Option<String>,
    /// The date and time when the actor was created.
    #[serde(rename = "createdAt", default, skip_serializing_if = "Option::is_none")]
    pub created_at: Option<DateTime<Utc>>,
    /// The date and time when the actor was last updated.
    #[serde(rename = "updatedAt", default, skip_serializing_if = "Option::is_none")]
    pub updated_at: Option<DateTime<Utc>>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct ActorTrackView {
    /// The name of the track.
    pub name: String,
    /// The primary artist name.
    pub artist: String,
    /// The album name.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub album: Option<String>,
    /// URL of the album cover image.
    #[serde(rename = "albumCoverUrl", default, skip_serializing_if = "Option::is_none")]
    pub album_cover_url: Option<String>,
    /// Track duration in milliseconds.
    #[serde(rename = "durationMs", default, skip_serializing_if = "Option::is_none")]
    pub duration_ms: Option<i64>,
    /// Music service source, e.g. 'spotify' or 'listenbrainz'.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub source: Option<String>,
    /// MusicBrainz recording ID, if available.
    #[serde(rename = "recordingMbId", default, skip_serializing_if = "Option::is_none")]
    pub recording_mb_id: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct AddDirectoryToQueueParams {
    #[serde(rename = "playerId", default, skip_serializing_if = "Option::is_none")]
    pub player_id: Option<String>,
    /// The directory to add to the queue
    pub directory: String,
    /// Position in the queue to insert the directory at, defaults to the end if not specified
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub position: Option<i64>,
    /// Whether to shuffle the added directory in the queue
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub shuffle: Option<bool>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct AddItemsToQueueParams {
    #[serde(rename = "playerId", default, skip_serializing_if = "Option::is_none")]
    pub player_id: Option<String>,
    pub items: Vec<String>,
    /// Position in the queue to insert the items at, defaults to the end if not specified
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub position: Option<i64>,
    /// Whether to shuffle the added items in the queue
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub shuffle: Option<bool>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct AlbumRecord {
    /// The title of the album.
    pub title: String,
    /// The artist of the album.
    pub artist: String,
    /// The duration of the album in milliseconds.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub duration: Option<i64>,
    /// The release date of the album.
    #[serde(rename = "releaseDate", default, skip_serializing_if = "Option::is_none")]
    pub release_date: Option<DateTime<Utc>>,
    /// The year the album was released.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub year: Option<i64>,
    /// The genre of the album.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub genre: Option<String>,
    /// The album art of the album.
    #[serde(rename = "albumArt", default, skip_serializing_if = "Option::is_none")]
    pub album_art: Option<BlobRef>,
    /// The URL of the album art of the album.
    #[serde(rename = "albumArtUrl", default, skip_serializing_if = "Option::is_none")]
    pub album_art_url: Option<String>,
    /// The tags of the album.
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub tags: Vec<String>,
    /// The YouTube link of the album.
    #[serde(rename = "youtubeLink", default, skip_serializing_if = "Option::is_none")]
    pub youtube_link: Option<String>,
    /// The Spotify link of the album.
    #[serde(rename = "spotifyLink", default, skip_serializing_if = "Option::is_none")]
    pub spotify_link: Option<String>,
    /// The tidal link of the album.
    #[serde(rename = "tidalLink", default, skip_serializing_if = "Option::is_none")]
    pub tidal_link: Option<String>,
    /// The Apple Music link of the album.
    #[serde(rename = "appleMusicLink", default, skip_serializing_if = "Option::is_none")]
    pub apple_music_link: Option<String>,
    /// The date and time when the album was created.
    #[serde(rename = "createdAt")]
    pub created_at: DateTime<Utc>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct AlbumViewBasic {
    /// The unique identifier of the album.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    /// The URI of the album.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub uri: Option<String>,
    /// The title of the album.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
    /// The artist of the album.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub artist: Option<String>,
    /// The URI of the album's artist.
    #[serde(rename = "artistUri", default, skip_serializing_if = "Option::is_none")]
    pub artist_uri: Option<String>,
    /// The year the album was released.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub year: Option<i64>,
    /// The URL of the album art image.
    #[serde(rename = "albumArt", default, skip_serializing_if = "Option::is_none")]
    pub album_art: Option<String>,
    /// The release date of the album.
    #[serde(rename = "releaseDate", default, skip_serializing_if = "Option::is_none")]
    pub release_date: Option<String>,
    /// The SHA256 hash of the album.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub sha256: Option<String>,
    /// The number of times the album has been played.
    #[serde(rename = "playCount", default, skip_serializing_if = "Option::is_none")]
    pub play_count: Option<i64>,
    /// The number of unique listeners who have played the album.
    #[serde(rename = "uniqueListeners", default, skip_serializing_if = "Option::is_none")]
    pub unique_listeners: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct AlbumViewDetailed {
    /// The unique identifier of the album.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    /// The URI of the album.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub uri: Option<String>,
    /// The title of the album.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
    /// The artist of the album.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub artist: Option<String>,
    /// The URI of the album's artist.
    #[serde(rename = "artistUri", default, skip_serializing_if = "Option::is_none")]
    pub artist_uri: Option<String>,
    /// The year the album was released.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub year: Option<i64>,
    /// The URL of the album art image.
    #[serde(rename = "albumArt", default, skip_serializing_if = "Option::is_none")]
    pub album_art: Option<String>,
    /// The release date of the album.
    #[serde(rename = "releaseDate", default, skip_serializing_if = "Option::is_none")]
    pub release_date: Option<String>,
    /// The SHA256 hash of the album.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub sha256: Option<String>,
    /// The number of times the album has been played.
    #[serde(rename = "playCount", default, skip_serializing_if = "Option::is_none")]
    pub play_count: Option<i64>,
    /// The number of unique listeners who have played the album.
    #[serde(rename = "uniqueListeners", default, skip_serializing_if = "Option::is_none")]
    pub unique_listeners: Option<i64>,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub tags: Vec<String>,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub tracks: Vec<SongViewBasic>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct ApiKeyView {
    /// The unique identifier of the API key.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    /// The name of the API key.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub name: Option<String>,
    /// A description for the API key.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub description: Option<String>,
    /// The date and time when the API key was created.
    #[serde(rename = "createdAt", default, skip_serializing_if = "Option::is_none")]
    pub created_at: Option<DateTime<Utc>>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct ArtistListenerViewBasic {
    /// The unique identifier of the actor.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    /// The DID of the listener.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub did: Option<String>,
    /// The handle of the listener.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub handle: Option<String>,
    /// The display name of the listener.
    #[serde(rename = "displayName", default, skip_serializing_if = "Option::is_none")]
    pub display_name: Option<String>,
    /// The URL of the listener's avatar image.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub avatar: Option<String>,
    #[serde(rename = "mostListenedSong", default, skip_serializing_if = "Option::is_none")]
    pub most_listened_song: Option<ArtistSongViewBasic>,
    /// The total number of plays by the listener.
    #[serde(rename = "totalPlays", default, skip_serializing_if = "Option::is_none")]
    pub total_plays: Option<i64>,
    /// The rank of the listener among all listeners of the artist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub rank: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct ArtistMbid {
    /// The MusicBrainz Identifier (MBID) of the artist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub mbid: Option<String>,
    /// The name of the artist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub name: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct ArtistRecentListenerView {
    /// The unique identifier of the listener.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    /// The DID of the listener.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub did: Option<String>,
    /// The handle of the listener.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub handle: Option<String>,
    /// The display name of the listener.
    #[serde(rename = "displayName", default, skip_serializing_if = "Option::is_none")]
    pub display_name: Option<String>,
    /// The URL of the listener's avatar image.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub avatar: Option<String>,
    /// The timestamp of the listener's most recent scrobble of this artist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub timestamp: Option<DateTime<Utc>>,
    /// The URI of the listener's most recent scrobble of this artist.
    #[serde(rename = "scrobbleUri", default, skip_serializing_if = "Option::is_none")]
    pub scrobble_uri: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct ArtistRecord {
    /// The name of the artist.
    pub name: String,
    /// The biography of the artist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub bio: Option<String>,
    /// The picture of the artist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub picture: Option<BlobRef>,
    /// The URL of the picture of the artist.
    #[serde(rename = "pictureUrl", default, skip_serializing_if = "Option::is_none")]
    pub picture_url: Option<String>,
    /// The tags of the artist.
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub tags: Vec<String>,
    /// The birth date of the artist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub born: Option<DateTime<Utc>>,
    /// The death date of the artist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub died: Option<DateTime<Utc>>,
    /// The birth place of the artist.
    #[serde(rename = "bornIn", default, skip_serializing_if = "Option::is_none")]
    pub born_in: Option<String>,
    /// The date when the artist was created.
    #[serde(rename = "createdAt")]
    pub created_at: DateTime<Utc>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct ArtistSongViewBasic {
    /// The URI of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub uri: Option<String>,
    /// The title of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
    /// The number of times the song has been played.
    #[serde(rename = "playCount", default, skip_serializing_if = "Option::is_none")]
    pub play_count: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct ArtistViewBasic {
    /// The unique identifier of the artist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    /// The URI of the artist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub uri: Option<String>,
    /// The name of the artist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub name: Option<String>,
    /// The picture of the artist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub picture: Option<String>,
    /// The SHA256 hash of the artist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub sha256: Option<String>,
    /// The number of times the artist has been played.
    #[serde(rename = "playCount", default, skip_serializing_if = "Option::is_none")]
    pub play_count: Option<i64>,
    /// The number of unique listeners who have played the artist.
    #[serde(rename = "uniqueListeners", default, skip_serializing_if = "Option::is_none")]
    pub unique_listeners: Option<i64>,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub tags: Vec<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct ArtistViewDetailed {
    /// The unique identifier of the artist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    /// The URI of the artist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub uri: Option<String>,
    /// The name of the artist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub name: Option<String>,
    /// The picture of the artist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub picture: Option<String>,
    /// The SHA256 hash of the artist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub sha256: Option<String>,
    /// The number of times the artist has been played.
    #[serde(rename = "playCount", default, skip_serializing_if = "Option::is_none")]
    pub play_count: Option<i64>,
    /// The number of unique listeners who have played the artist.
    #[serde(rename = "uniqueListeners", default, skip_serializing_if = "Option::is_none")]
    pub unique_listeners: Option<i64>,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub tags: Vec<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct ChartsScrobbleViewBasic {
    /// The date of the scrobble.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub date: Option<DateTime<Utc>>,
    /// The number of scrobbles on this date.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub count: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct ChartsView {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub scrobbles: Vec<ChartsScrobbleViewBasic>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct CreateApikeyInput {
    /// The name of the API key.
    pub name: String,
    /// A description for the API key.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub description: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct CreatePlaylistParams {
    /// The name of the playlist
    pub name: String,
    /// A brief description of the playlist
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub description: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct CreateScrobbleInput {
    /// The title of the track being scrobbled
    pub title: String,
    /// The artist of the track being scrobbled
    pub artist: String,
    /// The album of the track being scrobbled
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub album: Option<String>,
    /// The duration of the track in milliseconds (e.g., 240000 for 4 minutes)
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub duration: Option<i64>,
    /// The MusicBrainz ID of the track, if available
    #[serde(rename = "mbId", default, skip_serializing_if = "Option::is_none")]
    pub mb_id: Option<String>,
    /// The International Standard Recording Code (ISRC) of the track, if available
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub isrc: Option<String>,
    /// The URL of the album art for the track
    #[serde(rename = "albumArt", default, skip_serializing_if = "Option::is_none")]
    pub album_art: Option<String>,
    /// The track number of the track in the album
    #[serde(rename = "trackNumber", default, skip_serializing_if = "Option::is_none")]
    pub track_number: Option<i64>,
    /// The release date of the track, formatted as YYYY-MM-DD
    #[serde(rename = "releaseDate", default, skip_serializing_if = "Option::is_none")]
    pub release_date: Option<String>,
    /// The year the track was released
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub year: Option<i64>,
    /// The disc number of the track in the album, if applicable
    #[serde(rename = "discNumber", default, skip_serializing_if = "Option::is_none")]
    pub disc_number: Option<i64>,
    /// The lyrics of the track, if available
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub lyrics: Option<String>,
    /// The composer of the track, if available
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub composer: Option<String>,
    /// The copyright message for the track, if available
    #[serde(rename = "copyrightMessage", default, skip_serializing_if = "Option::is_none")]
    pub copyright_message: Option<String>,
    /// The record label of the track, if available
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub label: Option<String>,
    /// The URL of the artist's picture, if available
    #[serde(rename = "artistPicture", default, skip_serializing_if = "Option::is_none")]
    pub artist_picture: Option<String>,
    /// The Spotify link for the track, if available
    #[serde(rename = "spotifyLink", default, skip_serializing_if = "Option::is_none")]
    pub spotify_link: Option<String>,
    /// The Last.fm link for the track, if available
    #[serde(rename = "lastfmLink", default, skip_serializing_if = "Option::is_none")]
    pub lastfm_link: Option<String>,
    /// The Tidal link for the track, if available
    #[serde(rename = "tidalLink", default, skip_serializing_if = "Option::is_none")]
    pub tidal_link: Option<String>,
    /// The Apple Music link for the track, if available
    #[serde(rename = "appleMusicLink", default, skip_serializing_if = "Option::is_none")]
    pub apple_music_link: Option<String>,
    /// The Youtube link for the track, if available
    #[serde(rename = "youtubeLink", default, skip_serializing_if = "Option::is_none")]
    pub youtube_link: Option<String>,
    /// The Deezer link for the track, if available
    #[serde(rename = "deezerLink", default, skip_serializing_if = "Option::is_none")]
    pub deezer_link: Option<String>,
    /// The timestamp of the scrobble in seconds since epoch (Unix timestamp)
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub timestamp: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct CreateShoutInput {
    /// The content of the shout
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub message: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct CreateSongInput {
    /// The title of the song
    pub title: String,
    /// The artist of the song
    pub artist: String,
    /// The album artist of the song, if different from the main artist
    #[serde(rename = "albumArtist")]
    pub album_artist: String,
    /// The album of the song, if applicable
    pub album: String,
    /// The duration of the song in milliseconds
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub duration: Option<i64>,
    /// The MusicBrainz ID of the song, if available
    #[serde(rename = "mbId", default, skip_serializing_if = "Option::is_none")]
    pub mb_id: Option<String>,
    /// The International Standard Recording Code (ISRC) of the song, if available
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub isrc: Option<String>,
    /// The URL of the album art for the song
    #[serde(rename = "albumArt", default, skip_serializing_if = "Option::is_none")]
    pub album_art: Option<String>,
    /// The track number of the song in the album, if applicable
    #[serde(rename = "trackNumber", default, skip_serializing_if = "Option::is_none")]
    pub track_number: Option<i64>,
    /// The release date of the song, formatted as YYYY-MM-DD
    #[serde(rename = "releaseDate", default, skip_serializing_if = "Option::is_none")]
    pub release_date: Option<String>,
    /// The year the song was released
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub year: Option<i64>,
    /// The disc number of the song in the album, if applicable
    #[serde(rename = "discNumber", default, skip_serializing_if = "Option::is_none")]
    pub disc_number: Option<i64>,
    /// The lyrics of the song, if available
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub lyrics: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct DescribeFeedGeneratorOutput {
    /// The DID of the feed generator.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub did: Option<String>,
    /// List of feed URIs generated by this feed generator.
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub feeds: Vec<FeedUriView>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct DescribeFeedGeneratorParams {
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct DislikeShoutInput {
    /// The unique identifier of the shout to dislike
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub uri: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct DislikeSongInput {
    /// The unique identifier of the song to dislike
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub uri: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct DownloadFileParams {
    /// The unique identifier of the file to download
    #[serde(rename = "fileId")]
    pub file_id: String,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct DropboxFileListView {
    /// A list of files in the Dropbox.
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub files: Vec<DropboxFileView>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct DropboxFileView {
    /// The unique identifier of the file.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    /// The name of the file.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub name: Option<String>,
    /// The lowercased path of the file.
    #[serde(rename = "pathLower", default, skip_serializing_if = "Option::is_none")]
    pub path_lower: Option<String>,
    /// The display path of the file.
    #[serde(rename = "pathDisplay", default, skip_serializing_if = "Option::is_none")]
    pub path_display: Option<String>,
    /// The last modified date and time of the file on the client.
    #[serde(rename = "clientModified", default, skip_serializing_if = "Option::is_none")]
    pub client_modified: Option<DateTime<Utc>>,
    /// The last modified date and time of the file on the server.
    #[serde(rename = "serverModified", default, skip_serializing_if = "Option::is_none")]
    pub server_modified: Option<DateTime<Utc>>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct DropboxTemporaryLinkView {
    /// The temporary link to access the file.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub link: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct FeedGeneratorsView {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub feeds: Vec<FeedGeneratorView>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct FeedGeneratorView {
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub name: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub description: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub uri: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub avatar: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub creator: Option<ActorProfileViewBasic>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct FeedItemView {
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub scrobble: Option<ScrobbleViewBasic>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct FeedRecommendationsView {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub recommendations: Vec<FeedRecommendationView>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub cursor: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct FeedRecommendationView {
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub artist: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub album: Option<String>,
    #[serde(rename = "albumArt", default, skip_serializing_if = "Option::is_none")]
    pub album_art: Option<String>,
    #[serde(rename = "trackUri", default, skip_serializing_if = "Option::is_none")]
    pub track_uri: Option<String>,
    #[serde(rename = "artistUri", default, skip_serializing_if = "Option::is_none")]
    pub artist_uri: Option<String>,
    #[serde(rename = "albumUri", default, skip_serializing_if = "Option::is_none")]
    pub album_uri: Option<String>,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub genres: Vec<String>,
    #[serde(rename = "recommendationScore", default, skip_serializing_if = "Option::is_none")]
    pub recommendation_score: Option<i64>,
    /// neighbour | social | serendipity
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub source: Option<String>,
    #[serde(rename = "likesCount", default, skip_serializing_if = "Option::is_none")]
    pub likes_count: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct FeedRecommendedAlbumsView {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub albums: Vec<FeedRecommendedAlbumView>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub cursor: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct FeedRecommendedAlbumView {
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub uri: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub artist: Option<String>,
    #[serde(rename = "artistUri", default, skip_serializing_if = "Option::is_none")]
    pub artist_uri: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub year: Option<i64>,
    #[serde(rename = "albumArt", default, skip_serializing_if = "Option::is_none")]
    pub album_art: Option<String>,
    #[serde(rename = "recommendationScore", default, skip_serializing_if = "Option::is_none")]
    pub recommendation_score: Option<i64>,
    /// known-artist | new-artist | serendipity
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub source: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct FeedRecommendedArtistsView {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub artists: Vec<FeedRecommendedArtistView>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub cursor: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct FeedRecommendedArtistView {
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub uri: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub name: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub picture: Option<String>,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub genres: Vec<String>,
    #[serde(rename = "recommendationScore", default, skip_serializing_if = "Option::is_none")]
    pub recommendation_score: Option<i64>,
    /// neighbour | social | serendipity
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub source: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct FeedSearchResultsView {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub hits: Vec<Value>,
    #[serde(rename = "processingTimeMs", default, skip_serializing_if = "Option::is_none")]
    pub processing_time_ms: Option<i64>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub offset: Option<i64>,
    #[serde(rename = "estimatedTotalHits", default, skip_serializing_if = "Option::is_none")]
    pub estimated_total_hits: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct FeedStoriesView {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub stories: Vec<FeedStoryView>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct FeedStoryView {
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub album: Option<String>,
    #[serde(rename = "albumArt", default, skip_serializing_if = "Option::is_none")]
    pub album_art: Option<String>,
    #[serde(rename = "albumArtist", default, skip_serializing_if = "Option::is_none")]
    pub album_artist: Option<String>,
    #[serde(rename = "albumUri", default, skip_serializing_if = "Option::is_none")]
    pub album_uri: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub artist: Option<String>,
    #[serde(rename = "artistUri", default, skip_serializing_if = "Option::is_none")]
    pub artist_uri: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub avatar: Option<String>,
    #[serde(rename = "createdAt", default, skip_serializing_if = "Option::is_none")]
    pub created_at: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub did: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub handle: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
    #[serde(rename = "trackId", default, skip_serializing_if = "Option::is_none")]
    pub track_id: Option<String>,
    #[serde(rename = "trackUri", default, skip_serializing_if = "Option::is_none")]
    pub track_uri: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub uri: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct FeedUriView {
    /// The feed URI.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub uri: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct FeedView {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub feed: Vec<FeedItemView>,
    /// The pagination cursor for the next set of results.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub cursor: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct FollowAccountOutput {
    pub subject: ActorProfileViewBasic,
    pub followers: Vec<ActorProfileViewBasic>,
    /// A cursor value to pass to subsequent calls to get the next page of results.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub cursor: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct FollowAccountParams {
    pub account: String,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct FollowRecord {
    #[serde(rename = "createdAt")]
    pub created_at: DateTime<Utc>,
    pub subject: String,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub via: Option<StrongRef>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GeneratorRecord {
    pub did: String,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub avatar: Option<BlobRef>,
    #[serde(rename = "displayName")]
    pub display_name: String,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub description: Option<String>,
    #[serde(rename = "createdAt")]
    pub created_at: DateTime<Utc>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetActorAlbumsOutput {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub albums: Vec<AlbumViewBasic>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetActorAlbumsParams {
    /// The DID or handle of the actor
    pub did: String,
    /// The maximum number of albums to return
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
    /// The offset for pagination
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub offset: Option<i64>,
    /// The start date to filter albums from (ISO 8601 format)
    #[serde(rename = "startDate", default, skip_serializing_if = "Option::is_none")]
    pub start_date: Option<DateTime<Utc>>,
    /// The end date to filter albums to (ISO 8601 format)
    #[serde(rename = "endDate", default, skip_serializing_if = "Option::is_none")]
    pub end_date: Option<DateTime<Utc>>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetActorArtistsOutput {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub artists: Vec<ArtistViewBasic>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetActorArtistsParams {
    /// The DID or handle of the actor
    pub did: String,
    /// The maximum number of albums to return
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
    /// The offset for pagination
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub offset: Option<i64>,
    /// The start date to filter albums from (ISO 8601 format)
    #[serde(rename = "startDate", default, skip_serializing_if = "Option::is_none")]
    pub start_date: Option<DateTime<Utc>>,
    /// The end date to filter albums to (ISO 8601 format)
    #[serde(rename = "endDate", default, skip_serializing_if = "Option::is_none")]
    pub end_date: Option<DateTime<Utc>>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetActorCompatibilityOutput {
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub compatibility: Option<ActorCompatibilityViewBasic>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetActorCompatibilityParams {
    /// DID or handle to get compatibility for
    pub did: String,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetActorLovedSongsOutput {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub tracks: Vec<SongViewBasic>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetActorLovedSongsParams {
    /// The DID or handle of the actor
    pub did: String,
    /// The maximum number of albums to return
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
    /// The offset for pagination
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub offset: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetActorNeighboursOutput {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub neighbours: Vec<ActorNeighbourViewBasic>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetActorNeighboursParams {
    /// The DID or handle of the actor
    pub did: String,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetActorPlaylistsOutput {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub playlists: Vec<PlaylistViewBasic>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetActorPlaylistsParams {
    /// The DID or handle of the actor
    pub did: String,
    /// The maximum number of albums to return
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
    /// The offset for pagination
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub offset: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetActorScrobblesOutput {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub scrobbles: Vec<ScrobbleViewBasic>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetActorScrobblesParams {
    /// The DID or handle of the actor
    pub did: String,
    /// The maximum number of albums to return
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
    /// The offset for pagination
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub offset: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetActorSongsOutput {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub songs: Vec<SongViewBasic>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetActorSongsParams {
    /// The DID or handle of the actor
    pub did: String,
    /// The maximum number of albums to return
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
    /// The offset for pagination
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub offset: Option<i64>,
    /// The start date to filter albums from (ISO 8601 format)
    #[serde(rename = "startDate", default, skip_serializing_if = "Option::is_none")]
    pub start_date: Option<DateTime<Utc>>,
    /// The end date to filter albums to (ISO 8601 format)
    #[serde(rename = "endDate", default, skip_serializing_if = "Option::is_none")]
    pub end_date: Option<DateTime<Utc>>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetAlbumParams {
    /// The URI of the album to retrieve.
    pub uri: String,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetAlbumRecommendationsParams {
    /// DID or handle of the user to recommend for.
    pub did: String,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetAlbumShoutsOutput {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub shouts: Vec<Value>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetAlbumShoutsParams {
    /// The unique identifier of the album to retrieve shouts for
    pub uri: String,
    /// The maximum number of shouts to return
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
    /// The number of shouts to skip before starting to collect the result set
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub offset: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetAlbumsOutput {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub albums: Vec<AlbumViewBasic>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetAlbumsParams {
    /// The maximum number of albums to return
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
    /// The offset for pagination
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub offset: Option<i64>,
    /// The genre to filter artists by
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub genre: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetAlbumTracksOutput {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub tracks: Vec<SongViewBasic>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetAlbumTracksParams {
    /// The URI of the album to retrieve tracks from
    pub uri: String,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetApikeysOutput {
    #[serde(rename = "apiKeys", default, skip_serializing_if = "Vec::is_empty")]
    pub api_keys: Vec<Value>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetApikeysParams {
    /// The number of API keys to skip before starting to collect the result set.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub offset: Option<i64>,
    /// The number of API keys to return per page.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetArtistAlbumsOutput {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub albums: Vec<AlbumViewBasic>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetArtistAlbumsParams {
    /// The URI of the artist to retrieve albums from
    pub uri: String,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetArtistListenersOutput {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub listeners: Vec<ArtistListenerViewBasic>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetArtistListenersParams {
    /// The URI of the artist to retrieve listeners from
    pub uri: String,
    /// Number of items to skip before returning results
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub offset: Option<i64>,
    /// Maximum number of results to return
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetArtistParams {
    /// The URI of the artist to retrieve details from
    pub uri: String,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetArtistRecentListenersOutput {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub listeners: Vec<ArtistRecentListenerView>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetArtistRecentListenersParams {
    /// The URI of the artist to retrieve recent listeners from
    pub uri: String,
    /// Number of items to skip before returning results
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub offset: Option<i64>,
    /// Maximum number of results to return
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetArtistRecommendationsParams {
    /// DID or handle of the user to recommend for.
    pub did: String,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetArtistShoutsOutput {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub shouts: Vec<Value>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetArtistShoutsParams {
    /// The URI of the artist to retrieve shouts for
    pub uri: String,
    /// The maximum number of shouts to return
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
    /// The number of shouts to skip before starting to collect the result set
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub offset: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetArtistsOutput {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub artists: Vec<ArtistViewBasic>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetArtistsParams {
    /// The maximum number of artists to return
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
    /// The offset for pagination
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub offset: Option<i64>,
    /// The names of the artists to return
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub names: Option<String>,
    /// The genre to filter artists by
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub genre: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetArtistTracksOutput {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub tracks: Vec<SongViewBasic>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetArtistTracksParams {
    /// The URI of the artist to retrieve albums from
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub uri: Option<String>,
    /// The maximum number of tracks to return
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
    /// The offset for pagination
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub offset: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetCurrentlyPlayingParams {
    #[serde(rename = "playerId", default, skip_serializing_if = "Option::is_none")]
    pub player_id: Option<String>,
    /// Handle or DID of the actor to retrieve the currently playing track for. If not provided, defaults to the current user.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub actor: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetFeedGeneratorOutput {
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub view: Option<FeedGeneratorView>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetFeedGeneratorParams {
    /// AT-URI of the feed generator record.
    pub feed: String,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetFeedGeneratorsParams {
    /// The maximum number of feed generators to return.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub size: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetFeedParams {
    /// The feed URI.
    pub feed: String,
    /// The maximum number of scrobbles to return
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
    /// The cursor for pagination
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub cursor: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetFeedSkeletonOutput {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub scrobbles: Vec<ScrobbleViewBasic>,
    /// The pagination cursor for the next set of results.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub cursor: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetFeedSkeletonParams {
    /// The feed URI.
    pub feed: String,
    /// The maximum number of scrobbles to return
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
    /// The offset for pagination
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub offset: Option<i64>,
    /// The pagination cursor.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub cursor: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetFileParams {
    /// The unique identifier of the file to retrieve
    #[serde(rename = "fileId")]
    pub file_id: String,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetFilesParams {
    /// Path to the Dropbox folder or root directory
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub at: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetFollowersOutput {
    pub subject: ActorProfileViewBasic,
    pub followers: Vec<ActorProfileViewBasic>,
    /// A cursor value to pass to subsequent calls to get the next page of results.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub cursor: Option<String>,
    /// The total number of followers.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub count: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetFollowersParams {
    pub actor: String,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
    /// If provided, filters the followers to only include those with DIDs in this list.
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub dids: Vec<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub cursor: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetFollowsOutput {
    pub subject: ActorProfileViewBasic,
    pub follows: Vec<ActorProfileViewBasic>,
    /// A cursor value to pass to subsequent calls to get the next page of results.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub cursor: Option<String>,
    /// The total number of follows.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub count: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetFollowsParams {
    pub actor: String,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
    /// If provided, filters the follows to only include those with DIDs in this list.
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub dids: Vec<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub cursor: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetGlobalStatsParams {
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetKnownFollowersOutput {
    pub subject: ActorProfileViewBasic,
    pub followers: Vec<ActorProfileViewBasic>,
    /// A cursor value to pass to subsequent calls to get the next page of results.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub cursor: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetKnownFollowersParams {
    pub actor: String,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub cursor: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetMetadataParams {
    /// Path to the file or folder in Dropbox
    pub path: String,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetMirrorSourcesOutput {
    pub sources: Vec<MirrorSourceView>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetMirrorSourcesParams {
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetPlaybackQueueParams {
    #[serde(rename = "playerId", default, skip_serializing_if = "Option::is_none")]
    pub player_id: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetPlaylistParams {
    /// The URI of the playlist to retrieve.
    pub uri: String,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetPlaylistsOutput {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub playlists: Vec<PlaylistViewBasic>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetPlaylistsParams {
    /// The maximum number of playlists to return.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
    /// The offset for pagination, used to skip a number of playlists.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub offset: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetProfileParams {
    /// The DID or handle of the actor
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub did: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetProfileShoutsOutput {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub shouts: Vec<Value>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetProfileShoutsParams {
    /// The DID or handle of the actor
    pub did: String,
    /// The offset for pagination
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub offset: Option<i64>,
    /// The maximum number of shouts to return
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetRecommendationsParams {
    /// DID or handle of the user to recommend for.
    pub did: String,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetScrobbleParams {
    /// The unique identifier of the scrobble
    pub uri: String,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetScrobblesChartParams {
    /// The DID or handle of the actor
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub did: Option<String>,
    /// The URI of the artist to filter by
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub artisturi: Option<String>,
    /// The URI of the album to filter by
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub albumuri: Option<String>,
    /// The URI of the track to filter by
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub songuri: Option<String>,
    /// The genre to filter by
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub genre: Option<String>,
    /// Start date (ISO 8601). Defaults to 6 months ago.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub from: Option<String>,
    /// End date (ISO 8601). Defaults to today.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub to: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetScrobblesOutput {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub scrobbles: Vec<ScrobbleViewBasic>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetScrobblesParams {
    /// The DID or handle of the actor
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub did: Option<String>,
    /// If true, only return scrobbles from actors the viewer is following.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub following: Option<bool>,
    /// The maximum number of scrobbles to return
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
    /// The offset for pagination
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub offset: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetShoutRepliesOutput {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub shouts: Vec<Value>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetShoutRepliesParams {
    /// The URI of the shout to retrieve replies for
    pub uri: String,
    /// The maximum number of shouts to return
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
    /// The number of shouts to skip before starting to collect the result set
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub offset: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetSongParams {
    /// The AT-URI of the song to retrieve
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub uri: Option<String>,
    /// The MusicBrainz ID of the song to retrieve
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub mbid: Option<String>,
    /// The International Standard Recording Code (ISRC) of the song to retrieve
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub isrc: Option<String>,
    /// The Spotify track ID of the song to retrieve (resolved internally to the Spotify track URL)
    #[serde(rename = "spotifyId", default, skip_serializing_if = "Option::is_none")]
    pub spotify_id: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetSongRecentListenersOutput {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub listeners: Vec<SongRecentListenerView>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetSongRecentListenersParams {
    /// The URI of the song to retrieve recent listeners from
    pub uri: String,
    /// Number of items to skip before returning results
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub offset: Option<i64>,
    /// Maximum number of results to return
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetSongsOutput {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub songs: Vec<SongViewBasic>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetSongsParams {
    /// The maximum number of songs to return
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
    /// The offset for pagination
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub offset: Option<i64>,
    /// The genre to filter artists by
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub genre: Option<String>,
    /// Filter songs by MusicBrainz ID
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub mbid: Option<String>,
    /// Filter songs by International Standard Recording Code (ISRC)
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub isrc: Option<String>,
    /// Filter songs by Spotify track ID (resolved internally to the Spotify track URL)
    #[serde(rename = "spotifyId", default, skip_serializing_if = "Option::is_none")]
    pub spotify_id: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetStatsParams {
    /// The DID or handle of the user to get stats for.
    pub did: String,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetStoriesParams {
    /// The maximum number of stories to return.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub size: Option<i64>,
    /// The feed URI to filter stories by.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub feed: Option<String>,
    /// If true, only return stories from users the viewer follows. Requires authentication.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub following: Option<bool>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetTemporaryLinkParams {
    /// Path to the file in Dropbox
    pub path: String,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetTopArtistsOutput {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub artists: Vec<ArtistViewBasic>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetTopArtistsParams {
    /// The maximum number of artists to return
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
    /// The offset for pagination
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub offset: Option<i64>,
    /// The start date to filter artists from (ISO 8601 format)
    #[serde(rename = "startDate", default, skip_serializing_if = "Option::is_none")]
    pub start_date: Option<DateTime<Utc>>,
    /// The end date to filter artists to (ISO 8601 format)
    #[serde(rename = "endDate", default, skip_serializing_if = "Option::is_none")]
    pub end_date: Option<DateTime<Utc>>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetTopTracksOutput {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub tracks: Vec<SongViewBasic>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetTopTracksParams {
    /// The maximum number of tracks to return
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
    /// The offset for pagination
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub offset: Option<i64>,
    /// The start date to filter tracks from (ISO 8601 format)
    #[serde(rename = "startDate", default, skip_serializing_if = "Option::is_none")]
    pub start_date: Option<DateTime<Utc>>,
    /// The end date to filter tracks to (ISO 8601 format)
    #[serde(rename = "endDate", default, skip_serializing_if = "Option::is_none")]
    pub end_date: Option<DateTime<Utc>>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetTrackShoutsOutput {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub shouts: Vec<Value>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetTrackShoutsParams {
    /// The URI of the track to retrieve shouts for
    pub uri: String,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GetWrappedParams {
    /// The DID or handle of the user
    pub did: String,
    /// The year to get wrapped stats for (defaults to current year)
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub year: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GoogledriveFileListView {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub files: Vec<GoogledriveFileView>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GoogledriveFileView {
    /// The unique identifier of the file.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
}

/// indicates that a handle or DID could not be resolved
#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GraphNotFoundActor {
    pub actor: String,
    #[serde(rename = "notFound")]
    pub not_found: bool,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct GraphRelationship {
    pub did: String,
    /// if the actor follows this DID, this is the AT-URI of the follow record
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub following: Option<String>,
    /// if the actor is followed by this DID, contains the AT-URI of the follow record
    #[serde(rename = "followedBy", default, skip_serializing_if = "Option::is_none")]
    pub followed_by: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct InsertDirectoryParams {
    /// The URI of the playlist to start
    pub uri: String,
    /// The directory (id) to insert into the playlist
    pub directory: String,
    /// The position in the playlist to insert the directory at, if not specified, the directory will be appended
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub position: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct InsertFilesParams {
    /// The URI of the playlist to start
    pub uri: String,
    pub files: Vec<String>,
    /// The position in the playlist to insert the files at, if not specified, files will be appended
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub position: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct LikeRecord {
    /// The date when the like was created.
    #[serde(rename = "createdAt")]
    pub created_at: DateTime<Utc>,
    pub subject: StrongRef,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct LikeShoutInput {
    /// The unique identifier of the shout to like
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub uri: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct LikeSongInput {
    /// The unique identifier of the song to like
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub uri: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct MatchSongParams {
    /// The title of the song to retrieve
    pub title: String,
    /// The artist of the song to retrieve
    pub artist: String,
    /// Optional MusicBrainz recording ID to anchor the match
    #[serde(rename = "mbId", default, skip_serializing_if = "Option::is_none")]
    pub mb_id: Option<String>,
    /// Optional International Standard Recording Code (ISRC) to anchor the match
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub isrc: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct MirrorSourceView {
    /// One of: lastfm, listenbrainz, tealfm
    pub provider: String,
    /// Whether scrobbles from this source are being mirrored into Rocksky.
    pub enabled: bool,
    /// Username on the external service (Last.fm / ListenBrainz). Null for Teal.fm.
    #[serde(rename = "externalUsername", default, skip_serializing_if = "Option::is_none")]
    pub external_username: Option<String>,
    /// True when an API key is stored. Last.fm/ListenBrainz only; always false for Teal.fm.
    #[serde(rename = "hasCredentials")]
    pub has_credentials: bool,
    /// The last time the mirror process successfully polled this source.
    #[serde(rename = "lastPolledAt", default, skip_serializing_if = "Option::is_none")]
    pub last_polled_at: Option<DateTime<Utc>>,
    /// Watermark — scrobbles from the external service older than this are skipped.
    #[serde(rename = "lastScrobbleSeenAt", default, skip_serializing_if = "Option::is_none")]
    pub last_scrobble_seen_at: Option<DateTime<Utc>>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct NextParams {
    #[serde(rename = "playerId", default, skip_serializing_if = "Option::is_none")]
    pub player_id: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct PauseParams {
    #[serde(rename = "playerId", default, skip_serializing_if = "Option::is_none")]
    pub player_id: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct PlayDirectoryParams {
    #[serde(rename = "playerId", default, skip_serializing_if = "Option::is_none")]
    pub player_id: Option<String>,
    #[serde(rename = "directoryId")]
    pub directory_id: String,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub shuffle: Option<bool>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub recurse: Option<bool>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub position: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct PlayerCurrentlyPlayingViewDetailed {
    /// The title of the currently playing track
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct PlayerPlaybackQueueViewDetailed {
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub tracks: Vec<SongViewBasic>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct PlayFileParams {
    #[serde(rename = "playerId", default, skip_serializing_if = "Option::is_none")]
    pub player_id: Option<String>,
    #[serde(rename = "fileId")]
    pub file_id: String,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct PlaylistItemRecord {
    pub subject: StrongRef,
    /// The date the playlist was created.
    #[serde(rename = "createdAt")]
    pub created_at: DateTime<Utc>,
    pub track: SongViewBasic,
    /// The order of the item in the playlist.
    pub order: i64,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct PlaylistRecord {
    /// The name of the playlist.
    pub name: String,
    /// The playlist description.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub description: Option<String>,
    /// The picture of the playlist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub picture: Option<BlobRef>,
    /// The URL of the picture of the artist.
    #[serde(rename = "pictureUrl", default, skip_serializing_if = "Option::is_none")]
    pub picture_url: Option<String>,
    /// The date the playlist was created.
    #[serde(rename = "createdAt")]
    pub created_at: DateTime<Utc>,
    /// The Spotify link of the playlist.
    #[serde(rename = "spotifyLink", default, skip_serializing_if = "Option::is_none")]
    pub spotify_link: Option<String>,
    /// The Tidal link of the playlist.
    #[serde(rename = "tidalLink", default, skip_serializing_if = "Option::is_none")]
    pub tidal_link: Option<String>,
    /// The YouTube link of the playlist.
    #[serde(rename = "youtubeLink", default, skip_serializing_if = "Option::is_none")]
    pub youtube_link: Option<String>,
    /// The Apple Music link of the playlist.
    #[serde(rename = "appleMusicLink", default, skip_serializing_if = "Option::is_none")]
    pub apple_music_link: Option<String>,
}

/// Basic view of a playlist, including its metadata
#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct PlaylistViewBasic {
    /// The unique identifier of the playlist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    /// The title of the playlist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
    /// The URI of the playlist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub uri: Option<String>,
    /// The DID of the curator of the playlist.
    #[serde(rename = "curatorDid", default, skip_serializing_if = "Option::is_none")]
    pub curator_did: Option<String>,
    /// The handle of the curator of the playlist.
    #[serde(rename = "curatorHandle", default, skip_serializing_if = "Option::is_none")]
    pub curator_handle: Option<String>,
    /// The name of the curator of the playlist.
    #[serde(rename = "curatorName", default, skip_serializing_if = "Option::is_none")]
    pub curator_name: Option<String>,
    /// The URL of the avatar image of the curator.
    #[serde(rename = "curatorAvatarUrl", default, skip_serializing_if = "Option::is_none")]
    pub curator_avatar_url: Option<String>,
    /// A description of the playlist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub description: Option<String>,
    /// The URL of the cover image for the playlist.
    #[serde(rename = "coverImageUrl", default, skip_serializing_if = "Option::is_none")]
    pub cover_image_url: Option<String>,
    /// The date and time when the playlist was created.
    #[serde(rename = "createdAt", default, skip_serializing_if = "Option::is_none")]
    pub created_at: Option<DateTime<Utc>>,
    /// The number of tracks in the playlist.
    #[serde(rename = "trackCount", default, skip_serializing_if = "Option::is_none")]
    pub track_count: Option<i64>,
}

/// Detailed view of a playlist, including its tracks and metadata
#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct PlaylistViewDetailed {
    /// The unique identifier of the playlist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    /// The title of the playlist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
    /// The URI of the playlist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub uri: Option<String>,
    /// The DID of the curator of the playlist.
    #[serde(rename = "curatorDid", default, skip_serializing_if = "Option::is_none")]
    pub curator_did: Option<String>,
    /// The handle of the curator of the playlist.
    #[serde(rename = "curatorHandle", default, skip_serializing_if = "Option::is_none")]
    pub curator_handle: Option<String>,
    /// The name of the curator of the playlist.
    #[serde(rename = "curatorName", default, skip_serializing_if = "Option::is_none")]
    pub curator_name: Option<String>,
    /// The URL of the avatar image of the curator.
    #[serde(rename = "curatorAvatarUrl", default, skip_serializing_if = "Option::is_none")]
    pub curator_avatar_url: Option<String>,
    /// A description of the playlist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub description: Option<String>,
    /// The URL of the cover image for the playlist.
    #[serde(rename = "coverImageUrl", default, skip_serializing_if = "Option::is_none")]
    pub cover_image_url: Option<String>,
    /// The date and time when the playlist was created.
    #[serde(rename = "createdAt", default, skip_serializing_if = "Option::is_none")]
    pub created_at: Option<DateTime<Utc>>,
    /// A list of tracks in the playlist.
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub tracks: Vec<SongViewBasic>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct PlayParams {
    #[serde(rename = "playerId", default, skip_serializing_if = "Option::is_none")]
    pub player_id: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct PreviousParams {
    #[serde(rename = "playerId", default, skip_serializing_if = "Option::is_none")]
    pub player_id: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct ProfileRecord {
    #[serde(rename = "displayName", default, skip_serializing_if = "Option::is_none")]
    pub display_name: Option<String>,
    /// Free-form profile description text.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub description: Option<String>,
    /// Small image to be displayed next to posts from account. AKA, 'profile picture'
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub avatar: Option<BlobRef>,
    /// Larger horizontal image to display behind profile view.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub banner: Option<BlobRef>,
    /// Self-label values, specific to the Bluesky application, on the overall account.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub labels: Option<Value>,
    #[serde(rename = "joinedViaStarterPack", default, skip_serializing_if = "Option::is_none")]
    pub joined_via_starter_pack: Option<StrongRef>,
    #[serde(rename = "createdAt", default, skip_serializing_if = "Option::is_none")]
    pub created_at: Option<DateTime<Utc>>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct PutMirrorSourceInput {
    /// One of: lastfm, listenbrainz, tealfm
    pub provider: String,
    /// Enable or disable mirroring for this provider.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub enabled: Option<bool>,
    /// External username (Last.fm / ListenBrainz). Required when enabling those providers. Ignored for Teal.fm.
    #[serde(rename = "externalUsername", default, skip_serializing_if = "Option::is_none")]
    pub external_username: Option<String>,
    /// API key / token to be encrypted at rest. Omit to leave the existing key unchanged. Pass an empty string to clear it.
    #[serde(rename = "apiKey", default, skip_serializing_if = "Option::is_none")]
    pub api_key: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct RadioRecord {
    /// The name of the radio station.
    pub name: String,
    /// The URL of the radio station.
    pub url: String,
    /// A description of the radio station.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub description: Option<String>,
    /// The genre of the radio station.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub genre: Option<String>,
    /// The logo of the radio station.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub logo: Option<BlobRef>,
    /// The website of the radio station.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub website: Option<String>,
    /// The date when the radio station was created.
    #[serde(rename = "createdAt")]
    pub created_at: DateTime<Utc>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct RadioViewBasic {
    /// The unique identifier of the radio.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    /// The name of the radio.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub name: Option<String>,
    /// A brief description of the radio.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub description: Option<String>,
    /// The date and time when the radio was created.
    #[serde(rename = "createdAt", default, skip_serializing_if = "Option::is_none")]
    pub created_at: Option<DateTime<Utc>>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct RadioViewDetailed {
    /// The unique identifier of the radio.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    /// The name of the radio.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub name: Option<String>,
    /// A brief description of the radio.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub description: Option<String>,
    /// The website of the radio.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub website: Option<String>,
    /// The streaming URL of the radio.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub url: Option<String>,
    /// The genre of the radio.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub genre: Option<String>,
    /// The logo of the radio station.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub logo: Option<String>,
    /// The date and time when the radio was created.
    #[serde(rename = "createdAt", default, skip_serializing_if = "Option::is_none")]
    pub created_at: Option<DateTime<Utc>>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct RemoveApikeyParams {
    /// The ID of the API key to remove.
    pub id: String,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct RemovePlaylistParams {
    /// The URI of the playlist to remove
    pub uri: String,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct RemoveShoutParams {
    /// The ID of the shout to be removed
    pub id: String,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct RemoveTrackParams {
    /// The URI of the playlist to remove the track from
    pub uri: String,
    /// The position of the track to remove in the playlist
    pub position: i64,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct ReplyShoutInput {
    /// The unique identifier of the shout to reply to
    #[serde(rename = "shoutId")]
    pub shout_id: String,
    /// The content of the reply
    pub message: String,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct ReportShoutInput {
    /// The unique identifier of the shout to report
    #[serde(rename = "shoutId")]
    pub shout_id: String,
    /// The reason for reporting the shout
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub reason: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct ScrobbleFirstScrobbleView {
    /// The handle of the user who first scrobbled this song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub handle: Option<String>,
    /// The avatar URL of the user who first scrobbled this song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub avatar: Option<String>,
    /// The timestamp of the first scrobble.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub timestamp: Option<DateTime<Utc>>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct ScrobbleRecord {
    /// The title of the song.
    pub title: String,
    /// The artist of the song.
    pub artist: String,
    /// The artists of the song with MusicBrainz IDs.
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub artists: Vec<ArtistMbid>,
    /// The album artist of the song.
    #[serde(rename = "albumArtist")]
    pub album_artist: String,
    /// The album of the song.
    pub album: String,
    /// The duration of the song in milliseconds.
    pub duration: i64,
    /// The track number of the song in the album.
    #[serde(rename = "trackNumber", default, skip_serializing_if = "Option::is_none")]
    pub track_number: Option<i64>,
    /// The disc number of the song in the album.
    #[serde(rename = "discNumber", default, skip_serializing_if = "Option::is_none")]
    pub disc_number: Option<i64>,
    /// The release date of the song.
    #[serde(rename = "releaseDate", default, skip_serializing_if = "Option::is_none")]
    pub release_date: Option<DateTime<Utc>>,
    /// The year the song was released.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub year: Option<i64>,
    /// The genre of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub genre: Option<String>,
    /// The tags of the song.
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub tags: Vec<String>,
    /// The composer of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub composer: Option<String>,
    /// The lyrics of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub lyrics: Option<String>,
    /// The copyright message of the song.
    #[serde(rename = "copyrightMessage", default, skip_serializing_if = "Option::is_none")]
    pub copyright_message: Option<String>,
    /// Informations about the song
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub wiki: Option<String>,
    /// The album art of the song.
    #[serde(rename = "albumArt", default, skip_serializing_if = "Option::is_none")]
    pub album_art: Option<BlobRef>,
    /// The URL of the album art of the song.
    #[serde(rename = "albumArtUrl", default, skip_serializing_if = "Option::is_none")]
    pub album_art_url: Option<String>,
    /// The YouTube link of the song.
    #[serde(rename = "youtubeLink", default, skip_serializing_if = "Option::is_none")]
    pub youtube_link: Option<String>,
    /// The Spotify link of the song.
    #[serde(rename = "spotifyLink", default, skip_serializing_if = "Option::is_none")]
    pub spotify_link: Option<String>,
    /// The Tidal link of the song.
    #[serde(rename = "tidalLink", default, skip_serializing_if = "Option::is_none")]
    pub tidal_link: Option<String>,
    /// The Apple Music link of the song.
    #[serde(rename = "appleMusicLink", default, skip_serializing_if = "Option::is_none")]
    pub apple_music_link: Option<String>,
    /// The date when the song was created.
    #[serde(rename = "createdAt")]
    pub created_at: DateTime<Utc>,
    /// The MusicBrainz ID of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub mbid: Option<String>,
    /// The label of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub label: Option<String>,
    /// The International Standard Recording Code (ISRC) of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub isrc: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct ScrobbleViewBasic {
    /// The unique identifier of the scrobble.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    /// The handle of the user who created the scrobble.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub user: Option<String>,
    /// The display name of the user who created the scrobble.
    #[serde(rename = "userDisplayName", default, skip_serializing_if = "Option::is_none")]
    pub user_display_name: Option<String>,
    /// The avatar URL of the user who created the scrobble.
    #[serde(rename = "userAvatar", default, skip_serializing_if = "Option::is_none")]
    pub user_avatar: Option<String>,
    /// The title of the scrobble.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
    /// The artist of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub artist: Option<String>,
    /// The URI of the artist.
    #[serde(rename = "artistUri", default, skip_serializing_if = "Option::is_none")]
    pub artist_uri: Option<String>,
    /// The album of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub album: Option<String>,
    /// The URI of the album.
    #[serde(rename = "albumUri", default, skip_serializing_if = "Option::is_none")]
    pub album_uri: Option<String>,
    /// The album art URL of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub cover: Option<String>,
    /// The timestamp when the scrobble was created.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub date: Option<DateTime<Utc>>,
    /// The URI of the scrobble.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub uri: Option<String>,
    /// The SHA256 hash of the scrobble data.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub sha256: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub liked: Option<bool>,
    #[serde(rename = "likesCount", default, skip_serializing_if = "Option::is_none")]
    pub likes_count: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct ScrobbleViewDetailed {
    /// The unique identifier of the scrobble.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    /// The handle of the user who created the scrobble.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub user: Option<String>,
    /// The title of the scrobble.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
    /// The artist of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub artist: Option<String>,
    /// The URI of the artist.
    #[serde(rename = "artistUri", default, skip_serializing_if = "Option::is_none")]
    pub artist_uri: Option<String>,
    /// The album of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub album: Option<String>,
    /// The URI of the album.
    #[serde(rename = "albumUri", default, skip_serializing_if = "Option::is_none")]
    pub album_uri: Option<String>,
    /// The album art URL of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub cover: Option<String>,
    /// The timestamp when the scrobble was created.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub date: Option<DateTime<Utc>>,
    /// The URI of the scrobble.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub uri: Option<String>,
    /// The SHA256 hash of the scrobble data.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub sha256: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub liked: Option<bool>,
    #[serde(rename = "likesCount", default, skip_serializing_if = "Option::is_none")]
    pub likes_count: Option<i64>,
    /// The number of listeners
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub listeners: Option<i64>,
    /// The number of scrobbles for this song
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub scrobbles: Option<i64>,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub artists: Vec<ArtistViewBasic>,
    /// The first scrobble of this song on Rocksky.
    #[serde(rename = "firstScrobble", default, skip_serializing_if = "Option::is_none")]
    pub first_scrobble: Option<ScrobbleFirstScrobbleView>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct SearchParams {
    /// The search query string
    pub query: String,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct SeekParams {
    #[serde(rename = "playerId", default, skip_serializing_if = "Option::is_none")]
    pub player_id: Option<String>,
    /// The position in seconds to seek to
    pub position: i64,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct ShoutAuthor {
    /// The unique identifier of the author.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    /// The decentralized identifier (DID) of the author.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub did: Option<String>,
    /// The handle of the author.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub handle: Option<String>,
    /// The display name of the author.
    #[serde(rename = "displayName", default, skip_serializing_if = "Option::is_none")]
    pub display_name: Option<String>,
    /// The URL of the author's avatar image.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub avatar: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct ShoutRecord {
    /// The message of the shout.
    pub message: String,
    /// The date when the shout was created.
    #[serde(rename = "createdAt")]
    pub created_at: DateTime<Utc>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub parent: Option<StrongRef>,
    pub subject: StrongRef,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct ShoutView {
    /// The unique identifier of the shout.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    /// The content of the shout.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub message: Option<String>,
    /// The ID of the parent shout if this is a reply, otherwise null.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub parent: Option<String>,
    /// The date and time when the shout was created.
    #[serde(rename = "createdAt", default, skip_serializing_if = "Option::is_none")]
    pub created_at: Option<DateTime<Utc>>,
    /// The author of the shout.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub author: Option<ShoutAuthor>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct SongFirstScrobbleView {
    /// The handle of the user who first scrobbled this song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub handle: Option<String>,
    /// The avatar URL of the user who first scrobbled this song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub avatar: Option<String>,
    /// The timestamp of the first scrobble.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub timestamp: Option<DateTime<Utc>>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct SongRecentListenerView {
    /// The unique identifier of the listener.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    /// The DID of the listener.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub did: Option<String>,
    /// The handle of the listener.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub handle: Option<String>,
    /// The display name of the listener.
    #[serde(rename = "displayName", default, skip_serializing_if = "Option::is_none")]
    pub display_name: Option<String>,
    /// The URL of the listener's avatar image.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub avatar: Option<String>,
    /// The timestamp of the listener's most recent scrobble of this song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub timestamp: Option<DateTime<Utc>>,
    /// The URI of the listener's most recent scrobble of this song.
    #[serde(rename = "scrobbleUri", default, skip_serializing_if = "Option::is_none")]
    pub scrobble_uri: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct SongRecord {
    /// The title of the song.
    pub title: String,
    /// The artist of the song.
    pub artist: String,
    /// The artists of the song with MusicBrainz IDs.
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub artists: Vec<ArtistMbid>,
    /// The album artist of the song.
    #[serde(rename = "albumArtist")]
    pub album_artist: String,
    /// The album of the song.
    pub album: String,
    /// The duration of the song in milliseconds.
    pub duration: i64,
    /// The track number of the song in the album.
    #[serde(rename = "trackNumber", default, skip_serializing_if = "Option::is_none")]
    pub track_number: Option<i64>,
    /// The disc number of the song in the album.
    #[serde(rename = "discNumber", default, skip_serializing_if = "Option::is_none")]
    pub disc_number: Option<i64>,
    /// The release date of the song.
    #[serde(rename = "releaseDate", default, skip_serializing_if = "Option::is_none")]
    pub release_date: Option<DateTime<Utc>>,
    /// The year the song was released.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub year: Option<i64>,
    /// The genre of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub genre: Option<String>,
    /// The tags of the song.
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub tags: Vec<String>,
    /// The composer of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub composer: Option<String>,
    /// The lyrics of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub lyrics: Option<String>,
    /// The copyright message of the song.
    #[serde(rename = "copyrightMessage", default, skip_serializing_if = "Option::is_none")]
    pub copyright_message: Option<String>,
    /// Informations about the song
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub wiki: Option<String>,
    /// The album art of the song.
    #[serde(rename = "albumArt", default, skip_serializing_if = "Option::is_none")]
    pub album_art: Option<BlobRef>,
    /// The URL of the album art of the song.
    #[serde(rename = "albumArtUrl", default, skip_serializing_if = "Option::is_none")]
    pub album_art_url: Option<String>,
    /// The YouTube link of the song.
    #[serde(rename = "youtubeLink", default, skip_serializing_if = "Option::is_none")]
    pub youtube_link: Option<String>,
    /// The Spotify link of the song.
    #[serde(rename = "spotifyLink", default, skip_serializing_if = "Option::is_none")]
    pub spotify_link: Option<String>,
    /// The Tidal link of the song.
    #[serde(rename = "tidalLink", default, skip_serializing_if = "Option::is_none")]
    pub tidal_link: Option<String>,
    /// The Apple Music link of the song.
    #[serde(rename = "appleMusicLink", default, skip_serializing_if = "Option::is_none")]
    pub apple_music_link: Option<String>,
    /// The date when the song was created.
    #[serde(rename = "createdAt")]
    pub created_at: DateTime<Utc>,
    /// The MusicBrainz ID of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub mbid: Option<String>,
    /// The label of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub label: Option<String>,
    /// The International Standard Recording Code (ISRC) of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub isrc: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct SongViewBasic {
    /// The unique identifier of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    /// The title of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
    /// The artist of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub artist: Option<String>,
    /// The artist of the album the song belongs to.
    #[serde(rename = "albumArtist", default, skip_serializing_if = "Option::is_none")]
    pub album_artist: Option<String>,
    /// The URL of the album art image.
    #[serde(rename = "albumArt", default, skip_serializing_if = "Option::is_none")]
    pub album_art: Option<String>,
    /// The URI of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub uri: Option<String>,
    /// The album of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub album: Option<String>,
    /// The duration of the song in milliseconds.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub duration: Option<i64>,
    /// The track number of the song in the album.
    #[serde(rename = "trackNumber", default, skip_serializing_if = "Option::is_none")]
    pub track_number: Option<i64>,
    /// The disc number of the song in the album.
    #[serde(rename = "discNumber", default, skip_serializing_if = "Option::is_none")]
    pub disc_number: Option<i64>,
    /// The number of times the song has been played.
    #[serde(rename = "playCount", default, skip_serializing_if = "Option::is_none")]
    pub play_count: Option<i64>,
    /// The number of unique listeners who have played the song.
    #[serde(rename = "uniqueListeners", default, skip_serializing_if = "Option::is_none")]
    pub unique_listeners: Option<i64>,
    /// The URI of the album the song belongs to.
    #[serde(rename = "albumUri", default, skip_serializing_if = "Option::is_none")]
    pub album_uri: Option<String>,
    /// The URI of the artist of the song.
    #[serde(rename = "artistUri", default, skip_serializing_if = "Option::is_none")]
    pub artist_uri: Option<String>,
    /// The SHA256 hash of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub sha256: Option<String>,
    /// The MusicBrainz ID of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub mbid: Option<String>,
    /// The International Standard Recording Code (ISRC) of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub isrc: Option<String>,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub tags: Vec<String>,
    /// The timestamp when the song was created.
    #[serde(rename = "createdAt", default, skip_serializing_if = "Option::is_none")]
    pub created_at: Option<DateTime<Utc>>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct SongViewDetailed {
    /// The unique identifier of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    /// The title of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
    /// The artist of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub artist: Option<String>,
    /// The artist of the album the song belongs to.
    #[serde(rename = "albumArtist", default, skip_serializing_if = "Option::is_none")]
    pub album_artist: Option<String>,
    /// The URL of the album art image.
    #[serde(rename = "albumArt", default, skip_serializing_if = "Option::is_none")]
    pub album_art: Option<String>,
    /// The URI of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub uri: Option<String>,
    /// The album of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub album: Option<String>,
    /// The duration of the song in milliseconds.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub duration: Option<i64>,
    /// The track number of the song in the album.
    #[serde(rename = "trackNumber", default, skip_serializing_if = "Option::is_none")]
    pub track_number: Option<i64>,
    /// The disc number of the song in the album.
    #[serde(rename = "discNumber", default, skip_serializing_if = "Option::is_none")]
    pub disc_number: Option<i64>,
    /// The number of times the song has been played.
    #[serde(rename = "playCount", default, skip_serializing_if = "Option::is_none")]
    pub play_count: Option<i64>,
    /// The number of unique listeners who have played the song.
    #[serde(rename = "uniqueListeners", default, skip_serializing_if = "Option::is_none")]
    pub unique_listeners: Option<i64>,
    /// The URI of the album the song belongs to.
    #[serde(rename = "albumUri", default, skip_serializing_if = "Option::is_none")]
    pub album_uri: Option<String>,
    /// The URI of the artist of the song.
    #[serde(rename = "artistUri", default, skip_serializing_if = "Option::is_none")]
    pub artist_uri: Option<String>,
    /// The SHA256 hash of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub sha256: Option<String>,
    /// The MusicBrainz ID of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub mbid: Option<String>,
    /// The International Standard Recording Code (ISRC) of the song.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub isrc: Option<String>,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub tags: Vec<String>,
    /// The timestamp when the song was created.
    #[serde(rename = "createdAt", default, skip_serializing_if = "Option::is_none")]
    pub created_at: Option<DateTime<Utc>>,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub artists: Vec<ArtistViewBasic>,
    /// The first scrobble of this song on Rocksky.
    #[serde(rename = "firstScrobble", default, skip_serializing_if = "Option::is_none")]
    pub first_scrobble: Option<SongFirstScrobbleView>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct SpotifyTrackView {
    /// The unique identifier of the Spotify track.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    /// The name of the track.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub name: Option<String>,
    /// The name of the artist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub artist: Option<String>,
    /// The name of the album.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub album: Option<String>,
    /// The duration of the track in milliseconds.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub duration: Option<i64>,
    /// A URL to a preview of the track.
    #[serde(rename = "previewUrl", default, skip_serializing_if = "Option::is_none")]
    pub preview_url: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct StartPlaylistParams {
    /// The URI of the playlist to start
    pub uri: String,
    /// Whether to shuffle the playlist when starting it
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub shuffle: Option<bool>,
    /// The position in the playlist to start from, if not specified, starts from the beginning
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub position: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct StatsGlobalStatsView {
    /// Total scrobbles across all users on Rocksky.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub scrobbles: Option<i64>,
    /// Total number of users on Rocksky.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub users: Option<i64>,
    /// Total number of artists known to Rocksky.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub artists: Option<i64>,
    /// Total number of albums known to Rocksky.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub albums: Option<i64>,
    /// Total number of tracks known to Rocksky.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub tracks: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct StatsView {
    /// The total number of scrobbles.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub scrobbles: Option<i64>,
    /// The total number of unique artists scrobbled.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub artists: Option<i64>,
    /// The total number of tracks marked as loved.
    #[serde(rename = "lovedTracks", default, skip_serializing_if = "Option::is_none")]
    pub loved_tracks: Option<i64>,
    /// The total number of unique albums scrobbled.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub albums: Option<i64>,
    /// The total number of unique tracks scrobbled.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub tracks: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct StatsWrappedAlbum {
    /// The unique identifier of the album.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    /// The title of the album.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
    /// The artist of the album.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub artist: Option<String>,
    /// The album art URL.
    #[serde(rename = "albumArt", default, skip_serializing_if = "Option::is_none")]
    pub album_art: Option<String>,
    /// The AT-URI of the album.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub uri: Option<String>,
    /// Number of plays in the wrapped period.
    #[serde(rename = "playCount", default, skip_serializing_if = "Option::is_none")]
    pub play_count: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct StatsWrappedArtist {
    /// The unique identifier of the artist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    /// The name of the artist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub name: Option<String>,
    /// The picture URL of the artist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub picture: Option<String>,
    /// The AT-URI of the artist.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub uri: Option<String>,
    /// Number of plays in the wrapped period.
    #[serde(rename = "playCount", default, skip_serializing_if = "Option::is_none")]
    pub play_count: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct StatsWrappedDayCount {
    /// The date (YYYY-MM-DD).
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub date: Option<String>,
    /// Number of scrobbles on this day.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub count: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct StatsWrappedGenreCount {
    /// The genre name.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub genre: Option<String>,
    /// Number of scrobbles for this genre.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub count: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct StatsWrappedMilestone {
    /// The title of the track.
    #[serde(rename = "trackTitle", default, skip_serializing_if = "Option::is_none")]
    pub track_title: Option<String>,
    /// The name of the artist.
    #[serde(rename = "artistName", default, skip_serializing_if = "Option::is_none")]
    pub artist_name: Option<String>,
    /// The timestamp of the scrobble.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub timestamp: Option<DateTime<Utc>>,
    /// AT-URI of the track record, used to build a clickable link to the song page.
    #[serde(rename = "trackUri", default, skip_serializing_if = "Option::is_none")]
    pub track_uri: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct StatsWrappedMonthCount {
    /// Month number (1-12).
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub month: Option<i64>,
    /// Number of scrobbles in this month.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub count: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct StatsWrappedTrack {
    /// The unique identifier of the track.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    /// The title of the track.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
    /// The artist of the track.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub artist: Option<String>,
    /// The album art URL.
    #[serde(rename = "albumArt", default, skip_serializing_if = "Option::is_none")]
    pub album_art: Option<String>,
    /// The AT-URI of the track.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub uri: Option<String>,
    /// The AT-URI of the artist.
    #[serde(rename = "artistUri", default, skip_serializing_if = "Option::is_none")]
    pub artist_uri: Option<String>,
    /// The AT-URI of the album.
    #[serde(rename = "albumUri", default, skip_serializing_if = "Option::is_none")]
    pub album_uri: Option<String>,
    /// Number of plays in the wrapped period.
    #[serde(rename = "playCount", default, skip_serializing_if = "Option::is_none")]
    pub play_count: Option<i64>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct StatsWrappedView {
    /// The year of the wrapped stats.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub year: Option<i64>,
    /// Total scrobbles in the year.
    #[serde(rename = "totalScrobbles", default, skip_serializing_if = "Option::is_none")]
    pub total_scrobbles: Option<i64>,
    /// Total listening time in minutes.
    #[serde(rename = "totalListeningTimeMinutes", default, skip_serializing_if = "Option::is_none")]
    pub total_listening_time_minutes: Option<i64>,
    /// Top 5 artists by play count.
    #[serde(rename = "topArtists", default, skip_serializing_if = "Vec::is_empty")]
    pub top_artists: Vec<StatsWrappedArtist>,
    /// Top 5 tracks by play count.
    #[serde(rename = "topTracks", default, skip_serializing_if = "Vec::is_empty")]
    pub top_tracks: Vec<StatsWrappedTrack>,
    /// Top 5 albums by play count.
    #[serde(rename = "topAlbums", default, skip_serializing_if = "Vec::is_empty")]
    pub top_albums: Vec<StatsWrappedAlbum>,
    /// Top genres by play count.
    #[serde(rename = "topGenres", default, skip_serializing_if = "Vec::is_empty")]
    pub top_genres: Vec<StatsWrappedGenreCount>,
    /// Scrobble counts per month.
    #[serde(rename = "scrobblesPerMonth", default, skip_serializing_if = "Vec::is_empty")]
    pub scrobbles_per_month: Vec<StatsWrappedMonthCount>,
    /// The most active day of the year.
    #[serde(rename = "mostActiveDay", default, skip_serializing_if = "Option::is_none")]
    pub most_active_day: Option<StatsWrappedDayCount>,
    /// The most active hour of the day (0-23).
    #[serde(rename = "mostActiveHour", default, skip_serializing_if = "Option::is_none")]
    pub most_active_hour: Option<i64>,
    /// Number of artists heard for the first time this year.
    #[serde(rename = "newArtistsCount", default, skip_serializing_if = "Option::is_none")]
    pub new_artists_count: Option<i64>,
    /// Longest consecutive days streak.
    #[serde(rename = "longestStreak", default, skip_serializing_if = "Option::is_none")]
    pub longest_streak: Option<i64>,
    /// The first scrobble of the year.
    #[serde(rename = "firstScrobble", default, skip_serializing_if = "Option::is_none")]
    pub first_scrobble: Option<StatsWrappedMilestone>,
    /// The last scrobble of the year.
    #[serde(rename = "lastScrobble", default, skip_serializing_if = "Option::is_none")]
    pub last_scrobble: Option<StatsWrappedMilestone>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct StatusRecord {
    /// The track currently being played.
    pub track: ActorTrackView,
    /// When the track started playing.
    #[serde(rename = "startedAt")]
    pub started_at: DateTime<Utc>,
    /// When the status expires. Defaults to startedAt plus track duration plus idle time.
    #[serde(rename = "expiresAt", default, skip_serializing_if = "Option::is_none")]
    pub expires_at: Option<DateTime<Utc>>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct StrongRef {
    pub uri: String,
    pub cid: String,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct UnfollowAccountOutput {
    pub subject: ActorProfileViewBasic,
    pub followers: Vec<ActorProfileViewBasic>,
    /// A cursor value to pass to subsequent calls to get the next page of results.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub cursor: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct UnfollowAccountParams {
    pub account: String,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct UpdateApikeyInput {
    /// The ID of the API key to update.
    pub id: String,
    /// The new name of the API key.
    pub name: String,
    /// A new description for the API key.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub description: Option<String>,
}