taglib-wasm/dist/src/constants/specialized-properties.js

TagLib for TypeScript platforms: Deno, Node.js, Bun, Electron, browsers, and Cloudflare Workers

const SPECIALIZED_PROPERTIES = {
  // MusicBrainz Identifiers
  MUSICBRAINZ_ARTISTID: {
    key: "MUSICBRAINZ_ARTISTID",
    description: "MusicBrainz Artist ID (UUID)",
    type: "string",
    supportedFormats: ["ID3v2", "MP4", "Vorbis"],
    mappings: {
      id3v2: { frame: "TXXX", description: "MusicBrainz Artist Id" },
      vorbis: "MUSICBRAINZ_ARTISTID",
      mp4: "----:com.apple.iTunes:MusicBrainz Artist Id"
    }
  },
  MUSICBRAINZ_ALBUMID: {
    key: "MUSICBRAINZ_ALBUMID",
    description: "MusicBrainz Release ID (UUID)",
    type: "string",
    supportedFormats: ["ID3v2", "MP4", "Vorbis"],
    mappings: {
      id3v2: { frame: "TXXX", description: "MusicBrainz Album Id" },
      vorbis: "MUSICBRAINZ_ALBUMID",
      mp4: "----:com.apple.iTunes:MusicBrainz Album Id"
    }
  },
  MUSICBRAINZ_TRACKID: {
    key: "MUSICBRAINZ_TRACKID",
    description: "MusicBrainz Recording ID (UUID)",
    type: "string",
    supportedFormats: ["ID3v2", "MP4", "Vorbis"],
    mappings: {
      id3v2: { frame: "UFID", description: "http://musicbrainz.org" },
      vorbis: "MUSICBRAINZ_TRACKID",
      mp4: "----:com.apple.iTunes:MusicBrainz Track Id"
    }
  },
  MUSICBRAINZ_RELEASEGROUPID: {
    key: "MUSICBRAINZ_RELEASEGROUPID",
    description: "MusicBrainz Release Group ID (UUID)",
    type: "string",
    supportedFormats: ["ID3v2", "MP4", "Vorbis"],
    mappings: {
      id3v2: { frame: "TXXX", description: "MusicBrainz Release Group Id" },
      vorbis: "MUSICBRAINZ_RELEASEGROUPID",
      mp4: "----:com.apple.iTunes:MusicBrainz Release Group Id"
    }
  },
  // ReplayGain Properties
  REPLAYGAIN_TRACK_GAIN: {
    key: "REPLAYGAIN_TRACK_GAIN",
    description: "ReplayGain track gain in dB (e.g., '-6.54 dB')",
    type: "string",
    supportedFormats: ["ID3v2", "MP4", "Vorbis"],
    mappings: {
      id3v2: { frame: "TXXX", description: "ReplayGain_Track_Gain" },
      vorbis: "REPLAYGAIN_TRACK_GAIN",
      mp4: "----:com.apple.iTunes:replaygain_track_gain"
    }
  },
  REPLAYGAIN_TRACK_PEAK: {
    key: "REPLAYGAIN_TRACK_PEAK",
    description: "ReplayGain track peak value (0.0-1.0)",
    type: "string",
    supportedFormats: ["ID3v2", "MP4", "Vorbis"],
    mappings: {
      id3v2: { frame: "TXXX", description: "ReplayGain_Track_Peak" },
      vorbis: "REPLAYGAIN_TRACK_PEAK",
      mp4: "----:com.apple.iTunes:replaygain_track_peak"
    }
  },
  REPLAYGAIN_ALBUM_GAIN: {
    key: "REPLAYGAIN_ALBUM_GAIN",
    description: "ReplayGain album gain in dB",
    type: "string",
    supportedFormats: ["ID3v2", "MP4", "Vorbis"],
    mappings: {
      id3v2: { frame: "TXXX", description: "ReplayGain_Album_Gain" },
      vorbis: "REPLAYGAIN_ALBUM_GAIN",
      mp4: "----:com.apple.iTunes:replaygain_album_gain"
    }
  },
  REPLAYGAIN_ALBUM_PEAK: {
    key: "REPLAYGAIN_ALBUM_PEAK",
    description: "ReplayGain album peak value (0.0-1.0)",
    type: "string",
    supportedFormats: ["ID3v2", "MP4", "Vorbis"],
    mappings: {
      id3v2: { frame: "TXXX", description: "ReplayGain_Album_Peak" },
      vorbis: "REPLAYGAIN_ALBUM_PEAK",
      mp4: "----:com.apple.iTunes:replaygain_album_peak"
    }
  },
  // AcoustID Properties
  ACOUSTID_FINGERPRINT: {
    key: "ACOUSTID_FINGERPRINT",
    description: "AcoustID fingerprint (Chromaprint)",
    type: "string",
    supportedFormats: ["ID3v2", "MP4", "Vorbis"],
    mappings: {
      id3v2: { frame: "TXXX", description: "Acoustid Fingerprint" },
      vorbis: "ACOUSTID_FINGERPRINT",
      mp4: "----:com.apple.iTunes:Acoustid Fingerprint"
    }
  },
  ACOUSTID_ID: {
    key: "ACOUSTID_ID",
    description: "AcoustID UUID",
    type: "string",
    supportedFormats: ["ID3v2", "MP4", "Vorbis"],
    mappings: {
      id3v2: { frame: "TXXX", description: "Acoustid Id" },
      vorbis: "ACOUSTID_ID",
      mp4: "----:com.apple.iTunes:Acoustid Id"
    }
  },
  // Apple Sound Check
  ITUNNORM: {
    key: "ITUNNORM",
    description: "Apple Sound Check normalization data",
    type: "string",
    supportedFormats: ["ID3v2", "MP4", "Vorbis"],
    mappings: {
      id3v2: { frame: "TXXX", description: "iTunNORM" },
      vorbis: "ITUNNORM",
      mp4: "----:com.apple.iTunes:iTunNORM"
    }
  }
};
export {
  SPECIALIZED_PROPERTIES
};