music-metadata 11.11.2 → 11.12.0

package/lib/common/GenericTagTypes.d.ts

@@ -4,7 +4,7 @@ export interface IGenericTag {
     id: keyof ICommonTagsResult;
     value: AnyTagValue;
 }
-export type GenericTagId = 'track' | 'disk' | 'year' | 'title' | 'artist' | 'artists' | 'albumartist' | 'album' | 'date' | 'originaldate' | 'originalyear' | 'releasedate' | 'comment' | 'genre' | 'picture' | 'composer' | 'lyrics' | 'albumsort' | 'titlesort' | 'work' | 'artistsort' | 'albumartistsort' | 'composersort' | 'lyricist' | 'writer' | 'conductor' | 'remixer' | 'arranger' | 'engineer' | 'technician' | 'producer' | 'djmixer' | 'mixer' | 'publisher' | 'label' | 'grouping' | 'subtitle' | 'discsubtitle' | 'totaltracks' | 'totaldiscs' | 'compilation' | 'rating' | 'bpm' | 'mood' | 'media' | 'catalognumber' | 'tvShow' | 'tvShowSort' | 'tvEpisode' | 'tvEpisodeId' | 'tvNetwork' | 'tvSeason' | 'podcast' | 'podcasturl' | 'releasestatus' | 'releasetype' | 'releasecountry' | 'script' | 'language' | 'copyright' | 'license' | 'encodedby' | 'encodersettings' | 'gapless' | 'barcode' | 'isrc' | 'asin' | 'musicbrainz_recordingid' | 'musicbrainz_trackid' | 'musicbrainz_albumid' | 'musicbrainz_artistid' | 'musicbrainz_albumartistid' | 'musicbrainz_releasegroupid' | 'musicbrainz_workid' | 'musicbrainz_trmid' | 'musicbrainz_discid' | 'acoustid_id' | 'acoustid_fingerprint' | 'musicip_puid' | 'musicip_fingerprint' | 'website' | 'performer:instrument' | 'peakLevel' | 'averageLevel' | 'notes' | 'key' | 'originalalbum' | 'originalartist' | 'discogs_artist_id' | 'discogs_label_id' | 'discogs_master_release_id' | 'discogs_rating' | 'discogs_release_id' | 'discogs_votes' | 'replaygain_track_gain' | 'replaygain_track_peak' | 'replaygain_album_gain' | 'replaygain_album_peak' | 'replaygain_track_minmax' | 'replaygain_album_minmax' | 'replaygain_undo' | 'description' | 'longDescription' | 'category' | 'hdVideo' | 'keywords' | 'movement' | 'movementIndex' | 'movementTotal' | 'podcastId' | 'showMovement' | 'stik' | 'playCounter';
+export type GenericTagId = 'track' | 'disk' | 'year' | 'title' | 'artist' | 'artists' | 'albumartist' | 'albumartists' | 'album' | 'date' | 'originaldate' | 'originalyear' | 'releasedate' | 'comment' | 'genre' | 'picture' | 'composer' | 'lyrics' | 'albumsort' | 'titlesort' | 'work' | 'artistsort' | 'albumartistsort' | 'composersort' | 'lyricist' | 'writer' | 'conductor' | 'remixer' | 'arranger' | 'engineer' | 'technician' | 'producer' | 'djmixer' | 'mixer' | 'publisher' | 'label' | 'grouping' | 'subtitle' | 'discsubtitle' | 'totaltracks' | 'totaldiscs' | 'compilation' | 'rating' | 'bpm' | 'mood' | 'media' | 'catalognumber' | 'tvShow' | 'tvShowSort' | 'tvEpisode' | 'tvEpisodeId' | 'tvNetwork' | 'tvSeason' | 'podcast' | 'podcasturl' | 'releasestatus' | 'releasetype' | 'releasecountry' | 'script' | 'language' | 'copyright' | 'license' | 'encodedby' | 'encodersettings' | 'gapless' | 'barcode' | 'isrc' | 'asin' | 'musicbrainz_recordingid' | 'musicbrainz_trackid' | 'musicbrainz_albumid' | 'musicbrainz_artistid' | 'musicbrainz_albumartistid' | 'musicbrainz_releasegroupid' | 'musicbrainz_workid' | 'musicbrainz_trmid' | 'musicbrainz_discid' | 'acoustid_id' | 'acoustid_fingerprint' | 'musicip_puid' | 'musicip_fingerprint' | 'website' | 'performer:instrument' | 'peakLevel' | 'averageLevel' | 'notes' | 'key' | 'originalalbum' | 'originalartist' | 'discogs_artist_id' | 'discogs_label_id' | 'discogs_master_release_id' | 'discogs_rating' | 'discogs_release_id' | 'discogs_votes' | 'replaygain_track_gain' | 'replaygain_track_peak' | 'replaygain_album_gain' | 'replaygain_album_peak' | 'replaygain_track_minmax' | 'replaygain_album_minmax' | 'replaygain_undo' | 'description' | 'longDescription' | 'category' | 'hdVideo' | 'keywords' | 'movement' | 'movementIndex' | 'movementTotal' | 'podcastId' | 'showMovement' | 'stik' | 'playCounter';
 export interface INativeTagMap {
     [index: string]: GenericTagId;
 }

package/lib/common/GenericTagTypes.js

@@ -9,6 +9,7 @@ const commonTags = {
     artist: defaultTagInfo,
     artists: { multiple: true, unique: true },
     albumartist: defaultTagInfo,
+    albumartists: { multiple: true, unique: true },
     album: defaultTagInfo,
     date: defaultTagInfo,
     originaldate: defaultTagInfo,

package/lib/common/MetadataCollector.d.ts

@@ -61,6 +61,14 @@ export declare class MetadataCollector implements INativeMetadataCollector {
      * @returns {IAudioMetadata} Native + common tags
      */
     toCommonMetadata(): IAudioMetadata;
+    /**
+     * Handle singular artist tags (artist, albumartist) and cross-populate to plural form
+     */
+    private handleSingularArtistTag;
+    /**
+     * Handle plural artist tags (artists, albumartists) and cross-populate to singular form
+     */
+    private handlePluralArtistTag;
     /**
      * Fix some common issues with picture object
      * @param picture Picture

package/lib/common/MetadataCollector.js

@@ -84,26 +84,13 @@ export class MetadataCollector {
         // it is emitted to the user. e.g. genre (20) -> Electronic
         switch (tag.id) {
             case 'artist':
-                if (this.commonOrigin.artist === this.originPriority[tagType]) {
-                    // Assume the artist field is used as artists
-                    return this.postMap('artificial', { id: 'artists', value: tag.value });
-                }
-                if (!this.common.artists) {
-                    // Fill artists using artist source
-                    this.setGenericTag('artificial', { id: 'artists', value: tag.value });
-                }
-                break;
+                return this.handleSingularArtistTag(tagType, tag, 'artist', 'artists');
+            case 'albumartist':
+                return this.handleSingularArtistTag(tagType, tag, 'albumartist', 'albumartists');
             case 'artists':
-                if (!this.common.artist || this.commonOrigin.artist === this.originPriority.artificial) {
-                    if (!this.common.artists || this.common.artists.indexOf(tag.value) === -1) {
-                        // Fill artist using artists source
-                        const artists = (this.common.artists || []).concat([tag.value]);
-                        const value = joinArtists(artists);
-                        const artistTag = { id: 'artist', value };
-                        this.setGenericTag('artificial', artistTag);
-                    }
-                }
-                break;
+                return this.handlePluralArtistTag(tagType, tag, 'artist', 'artists');
+            case 'albumartists':
+                return this.handlePluralArtistTag(tagType, tag, 'albumartist', 'albumartists');
             case 'picture':
                 return this.postFixPicture(tag.value).then(picture => {
                     if (picture !== null) {
@@ -209,6 +196,34 @@ export class MetadataCollector {
             common: this.common
         };
     }
+    /**
+     * Handle singular artist tags (artist, albumartist) and cross-populate to plural form
+     */
+    handleSingularArtistTag(tagType, tag, singularId, pluralId) {
+        if (this.commonOrigin[singularId] === this.originPriority[tagType]) {
+            // Assume the singular field is used as plural (multiple values from same source)
+            return this.postMap('artificial', { id: pluralId, value: tag.value });
+        }
+        if (!this.common[pluralId]) {
+            // Fill plural using singular source
+            this.setGenericTag('artificial', { id: pluralId, value: tag.value });
+        }
+        this.setGenericTag(tagType, tag);
+    }
+    /**
+     * Handle plural artist tags (artists, albumartists) and cross-populate to singular form
+     */
+    handlePluralArtistTag(tagType, tag, singularId, pluralId) {
+        if (!this.common[singularId] || this.commonOrigin[singularId] === this.originPriority.artificial) {
+            if (!this.common[pluralId] || this.common[pluralId].indexOf(tag.value) === -1) {
+                // Fill singular using plural source
+                const values = (this.common[pluralId] || []).concat([tag.value]);
+                const value = joinArtists(values);
+                this.setGenericTag('artificial', { id: singularId, value });
+            }
+        }
+        this.setGenericTag(tagType, tag);
+    }
     /**
      * Fix some common issues with picture object
      * @param picture Picture

package/lib/type.d.ts

@@ -69,9 +69,13 @@ export interface ICommonTagsResult {
      */
     artists?: string[];
     /**
-     * Track album artists
+     * Track album artist/s. Contains the first album artist if multiple tags exist, or maybe several album artists written in a single string.
      */
     albumartist?: string;
+    /**
+     * Track album artists, aims to capture every album artist in a different string.
+     */
+    albumartists?: string[];
     /**
      * Album title
      */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "music-metadata",
   "description": "Music metadata parser for Node.js, supporting virtual any audio and tag format.",
-  "version": "11.11.2",
+  "version": "11.12.0",
   "author": {
     "name": "Borewit",
     "url": "https://github.com/Borewit"
@@ -120,14 +120,14 @@
     "win-guid": "^0.2.1"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.3.13",
+    "@biomejs/biome": "2.3.14",
     "@types/chai": "^5.2.3",
     "@types/chai-as-promised": "^8.0.2",
     "@types/content-type": "^1.1.9",
     "@types/debug": "^4.1.12",
     "@types/media-typer": "^1.1.3",
     "@types/mocha": "^10.0.10",
-    "@types/node": "^25.1.0",
+    "@types/node": "^25.2.0",
     "c8": "^10.1.3",
     "chai": "^6.2.2",
     "chai-as-promised": "^8.0.2",