feat(YouTube): Warn on alternate release versions

YouTube Music sometimes returns incorrect, alternate versions of a
release when looking up a GTIN.
This warns if a release with multiple versions is returned,
as there is no way of knowing if YouTube returned the correct one.

Author: feathecutie

providers/YouTubeMusic/api_types.ts

@@ -7,7 +7,7 @@ type APIResponse = {
 } & TrackingParams;
 
 export type Album = {
-	contents?: Renderer<'TwoColumnBrowseResults'>;
+	contents: Renderer<'TwoColumnBrowseResults'>;
 	microformat: Renderer<'MicroformatData'>;
 	background?: Renderer<'MusicThumbnail'>;
 } & APIResponse;
@@ -87,6 +87,7 @@ export type Nodes = {
 			| Renderer<'MusicShelf'>
 			| Renderer<'MusicPlaylistShelf'>
 			| Renderer<'MusicResponsiveHeader'>
+			| Renderer<'MusicCarouselShelf'>
 		)[];
 	};
 	/** @see https://github.com/LuanRT/YouTube.js/blob/v14.0.0/src/parser/classes/ItemSection.ts */
@@ -138,6 +139,30 @@ export type Nodes = {
 	MusicCardShelfHeaderBasic: unknown;
 	/** @see https://github.com/LuanRT/YouTube.js/blob/v14.0.0/src/parser/classes/MusicItemThumbnailOverlay.ts */
 	MusicItemThumbnailOverlay: unknown;
+	/** @see https://github.com/LuanRT/YouTube.js/blob/v14.0.0/src/parser/classes/MusicCarouselShelf.ts */
+	MusicCarouselShelf: {
+		header: Renderer<'MusicCarouselShelfBasicHeader'>;
+		contents: Renderer<'MusicTwoRowItem'>[];
+	};
+	/** @see https://github.com/LuanRT/YouTube.js/blob/v14.0.0/src/parser/classes/MusicCarouselShelfBasicHeader.ts */
+	MusicCarouselShelfBasicHeader: {
+		title: YTText;
+		accessibilityData?: {
+			accessibilityData: {
+				label?: string;
+			};
+		};
+	};
+	/** @see https://github.com/LuanRT/YouTube.js/blob/v14.0.0/src/parser/classes/MusicTwoRowItem.ts */
+	MusicTwoRowItem: {
+		thumbnailRenderer?: Renderer<'MusicThumbnail'>;
+		aspectRatio?: string;
+		title: YTText;
+		subtitle?: YTText;
+		navigationEndpoint: BrowseEndpoint;
+		menu?: Renderer<'Menu'>;
+		thumbnailOverlay: Renderer<'MusicItemThumbnailOverlay'>;
+	};
 	/** @see https://github.com/LuanRT/YouTube.js/blob/v14.0.0/src/parser/classes/MusicResponsiveListItem.ts */
 	MusicResponsiveListItem: {
 		thumbnail: Renderer<'MusicThumbnail'>;

providers/YouTubeMusic/constants.ts

@@ -33,8 +33,6 @@ export const YOUTUBEI_BODY = {
 			platform: 'DESKTOP',
 			clientFormFactor: 'UNKNOWN_FORM_FACTOR',
 			userInterfaceTheme: 'USER_INTERFACE_THEME_LIGHT',
-			timeZone: 'Europe/Berlin',
-			originalUrl: 'https://www.youtube.com',
 			deviceMake: '',
 			deviceModel: '',
 			browserName: 'Edge Chromium',

providers/YouTubeMusic/mod.ts

@@ -322,7 +322,7 @@ export class YouTubeMusicReleaseLookup extends ReleaseLookup<YouTubeMusicProvide
 
 		const header = album
 			.contents
-			?.twoColumnBrowseResultsRenderer
+			.twoColumnBrowseResultsRenderer
 			.tabs
 			.at(0)
 			?.tabRenderer
@@ -342,7 +342,7 @@ export class YouTubeMusicReleaseLookup extends ReleaseLookup<YouTubeMusicProvide
 
 		const albumTrackData = album
 			.contents
-			?.twoColumnBrowseResultsRenderer
+			.twoColumnBrowseResultsRenderer
 			.secondaryContents
 			.sectionListRenderer
 			.contents
@@ -353,7 +353,7 @@ export class YouTubeMusicReleaseLookup extends ReleaseLookup<YouTubeMusicProvide
 
 		const playlistTrackData = playlist
 			.contents
-			?.twoColumnBrowseResultsRenderer
+			.twoColumnBrowseResultsRenderer
 			.secondaryContents
 			.sectionListRenderer
 			.contents
@@ -438,6 +438,25 @@ export class YouTubeMusicReleaseLookup extends ReleaseLookup<YouTubeMusicProvide
 			release.releaseDate = { year: releaseYear };
 		}
 
+		const otherVersions = album
+			.contents
+			?.twoColumnBrowseResultsRenderer
+			.secondaryContents.sectionListRenderer
+			.contents
+			.filter((renderer) => 'musicCarouselShelfRenderer' in renderer)
+			.find((shelf) =>
+				// TODO: Try to make this be independent of the returned language
+				shelf.musicCarouselShelfRenderer.header.musicCarouselShelfBasicHeaderRenderer.title.runs.at(0)?.text ===
+					'Other versions'
+			)
+			?.musicCarouselShelfRenderer.contents
+			.map((item) => item.musicTwoRowItemRenderer.navigationEndpoint.browseEndpoint.browseId)
+			.map((id) => this.provider.constructUrl({ id, type: BROWSE }));
+
+		if (otherVersions) {
+			this.warnMultipleResults(otherVersions);
+		}
+
 		return release;
 	}
 
@@ -528,8 +547,9 @@ export class YouTubeMusicReleaseLookup extends ReleaseLookup<YouTubeMusicProvide
 		}, 0);
 
 		// TODO: WIP code for fetching data from the "View song credits" popup
-		// Can be used to improve artist credits,
+		// Could be used to improve artist credits,
 		// and to get the videoId of the actual song (instead of the MV) instead of parsing it from the playlist contents
+		// Using this would however require an additional API call per track
 		const creditsEndpoint = item
 			.musicResponsiveListItemRenderer
 			.menu