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

@@ -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/mod.ts

@@ -438,6 +438,22 @@ export class YouTubeMusicReleaseLookup extends ReleaseLookup<YouTubeMusicProvide
 			release.releaseDate = { year: releaseYear };
 		}
 
+		const otherVersions = album
+			.contents
+			?.twoColumnBrowseResultsRenderer
+			.secondaryContents.sectionListRenderer
+			.contents
+			.filter((renderer) => 'musicCarouselShelfRenderer' in renderer)
+			.map((shelf) => shelf.musicCarouselShelfRenderer)
+			.find((shelf) => shelf.header.musicCarouselShelfBasicHeaderRenderer.title.runs.at(0)?.text === 'Other versions')
+			?.contents
+			.map((item) => item.musicTwoRowItemRenderer.navigationEndpoint.browseEndpoint.browseId)
+			.map((id) => this.provider.constructUrl({ id, type: BROWSE }));
+
+		if (otherVersions) {
+			this.warnMultipleResults(otherVersions);
+		}
+
 		return release;
 	}