TrackData
Public metadata and optional portable source identity.
interface TrackData<Metadata = unknown>Public metadata and optional portable source identity.
Properties
sourceReferenceoptional
sourceReference?: ProviderReferencePortable provider payload; exclude secrets and live resources.
lyricsReferenceoptional
lyricsReference?: ProviderReferenceOptional portable lyrics provider affinity.
rawoptional
raw?: Record<string, any>Process-local legacy data, never persisted.
engineoptional
engine?: unknownLegacy source location or engine object, never persisted.
queryTypeoptional
queryType?: stringLegacy query hint.
requestMetadataoptional
requestMetadata?: () => Promise<Metadata | null>Legacy asynchronous metadata provider, never persisted.
cleanTitleoptional
cleanTitle?: stringLegacy display title.
idoptional
id?: stringStable track identifier.
titleoptional
title?: stringDisplay title.
descriptionoptional
description?: stringTrack description.
urloptional
url?: stringSource page URL.
thumbnailoptional
thumbnail?: stringThumbnail URL.
durationoptional
duration?: stringHuman-readable duration.
durationMSoptional
durationMS?: numberDuration in milliseconds when known.
viewsoptional
views?: numberView or play count when available.
requestedByoptional
requestedBy?: TrackRequester | nullUser or application identity that requested this track.
requesteroptional
requester?: TrackRequester | nullAlias for requestedBy.
sourceoptional
source?: stringProvider-defined source name or identifier.
liveoptional
live?: booleanWhether this is a live stream without a fixed duration.
metadataoptional
metadata?: Metadata | nullArbitrary source-plugin metadata.
playlistoptional
playlist?: Playlist | PlaylistData | nullPlaylist containing this track, when present.