music-tag-native 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 N-API for Rust
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,207 @@
+# music-tag-native
+
+A high-performance music metadata reader/writer for Node.js and browsers. Read and modify audio file tags (ID3, Vorbis, MP4, etc.) across multiple formats with native performance.
+
+Powered by Rust's [`lofty`](https://github.com/Serial-ATA/lofty-rs) crate and [`napi-rs`](https://github.com/napi-rs/napi-rs) for native bindings, with WebAssembly support for browsers.
+
+## Features
+
+- **Read/Write Metadata**: Title, artist, album, year, genre, track numbers, and more
+- **Album Art Support**: Read and write embedded pictures with multiple formats
+- **Audio Properties**: Bitrate, sample rate, bit depth, channels, duration
+- **Audio Quality Classification**: Automatic HQ/SQ/HiRes detection
+- **ReplayGain Support**: Read and write ReplayGain tags
+- **Cross-Platform**: Native binaries for macOS, Linux, Windows, Android + WASM for browsers
+- **Multiple Formats**: MP3, FLAC, M4A, WAV, OGG, and more
+
+## Installation
+
+```sh
+npm install music-tag-native
+```
+
+```sh
+yarn add music-tag-native
+```
+
+```sh
+pnpm add music-tag-native
+```
+
+```sh
+bun add music-tag-native
+```
+
+## Usage
+
+### Node.js
+
+```ts
+import { MusicTagger } from 'music-tag-native'
+
+const tagger = new MusicTagger()
+
+// Load from file path
+tagger.loadPath('/path/to/audio/file.mp3')
+
+// Read metadata
+console.log(tagger.title)
+console.log(tagger.artist)
+console.log(tagger.album)
+
+// Modify metadata
+tagger.title = 'New Title'
+tagger.artist = 'New Artist'
+tagger.year = 2024
+
+// Remove a tag (set to null)
+tagger.albumArtist = null
+
+// Save changes back to file
+tagger.save()
+
+// Clean up resources
+tagger.dispose()
+```
+
+### Browser
+
+```ts
+import { MusicTagger } from 'music-tag-native'
+
+const tagger = new MusicTagger()
+
+// Load from buffer
+const response = await fetch('/path/to/audio/file.mp3')
+const arrayBuffer = await response.arrayBuffer()
+const buffer = new Uint8Array(arrayBuffer)
+
+tagger.loadBuffer(buffer)
+
+// Read and modify metadata
+console.log(tagger.title)
+tagger.title = 'New Title'
+
+// Get modified buffer
+const modifiedBuffer = tagger.save()
+
+// Display album art
+const pictures = tagger.pictures
+if (pictures.length > 0) {
+  const picture = pictures[0]
+  const blob = new Blob([picture.data], { type: picture.mimeType })
+  const url = URL.createObjectURL(blob)
+  document.querySelector('img').src = url
+}
+
+tagger.dispose()
+```
+
+## API Reference
+
+### MusicTagger
+
+#### Loading Files
+
+- `loadPath(path: string): void` - Load audio file from path (Node.js only)
+- `loadBuffer(buffer: Uint8Array): void` - Load audio file from buffer
+
+#### Saving Changes
+
+- `save(): Uint8Array | undefined` - Save changes. Returns buffer in browser, undefined in Node.js (saves to original path)
+
+#### Resource Management
+
+- `dispose(): void` - Clean up resources. Always call when done with the tagger instance
+
+#### Metadata Properties (Read/Write)
+
+All properties can be read and written. Set to `null` to remove a tag.
+
+- `title: string | null`
+- `artist: string | null`
+- `album: string | null`
+- `albumArtist: string | null`
+- `genre: string | null`
+- `composer: string | null`
+- `comment: string | null`
+- `year: number | null`
+- `trackNumber: number | null`
+- `trackTotal: number | null`
+- `discNumber: number | null`
+- `discTotal: number | null`
+
+#### Audio Properties (Read-Only)
+
+- `duration: number` - Duration in seconds
+- `overallBitrate: number` - Overall bitrate in kbps
+- `audioBitrate: number` - Audio bitrate in kbps
+- `sampleRate: number` - Sample rate in Hz
+- `bitDepth: number` - Bit depth
+- `channels: number` - Number of channels
+- `audioQuality: 'HQ' | 'SQ' | 'HiRes' | null` - Audio quality classification
+
+#### Album Art
+
+- `pictures: MetaPicture[]` - Array of embedded pictures
+- `setPictures(pictures: MetaPicture[]): void` - Replace all pictures
+
+#### ReplayGain
+
+- `replayGainTrackGain: number | null`
+- `replayGainTrackPeak: number | null`
+- `replayGainAlbumGain: number | null`
+- `replayGainAlbumPeak: number | null`
+
+### MetaPicture
+
+Properties for album art and embedded images:
+
+- `pictureType: PictureType` - Type of picture (e.g., 'CoverFront', 'CoverBack')
+- `mimeType: string` - MIME type (e.g., 'image/jpeg', 'image/png')
+- `description: string | null` - Optional description
+- `data: Uint8Array` - Image data
+
+#### PictureType Values
+
+`'Other'`, `'Icon'`, `'OtherIcon'`, `'CoverFront'`, `'CoverBack'`, `'Leaflet'`, `'Media'`, `'LeadArtist'`, `'Artist'`, `'Conductor'`, `'Band'`, `'Composer'`, `'Lyricist'`, `'RecordingLocation'`, `'DuringRecording'`, `'DuringPerformance'`, `'ScreenCapture'`, `'BrightFish'`, `'Illustration'`, `'BandLogo'`, `'PublisherLogo'`, `'Undefined'`
+
+## Platform Support
+
+Native binaries are automatically installed for:
+
+- macOS (x64, ARM64)
+- Linux (x64, ARM64 - GNU and musl)
+- Windows (x64, ia32, ARM64)
+- Android (ARM64)
+
+WebAssembly fallback is available for unsupported platforms and browsers.
+
+## Development
+
+```sh
+# Install dependencies
+pnpm install
+
+# Build native addon for current platform
+pnpm build
+
+# Build WASM target
+pnpm build:wasm
+
+# Run tests
+pnpm test
+
+# Run playground
+pnpm play
+```
+
+See [package.json](./package.json) for all available scripts.
+
+## Type Definitions
+
+Full TypeScript definitions are available in [index.d.ts](./index.d.ts).
+
+## License
+
+MIT

package/browser.js

@@ -0,0 +1 @@
+export * from 'music-tag-native-wasm32-wasi'

package/index.d.ts

@@ -0,0 +1,300 @@
+/* auto-generated by NAPI-RS */
+/* eslint-disable */
+export declare class MetaPicture {
+  coverType: string
+  mimeType?: string
+  description?: string
+  data: Uint8Array
+  constructor(mime: string, data: Uint8Array, desc?: string | undefined | null)
+}
+
+export declare class MusicTagger {
+  /**
+   * @constructor
+   * Creates a new MusicTagger instance
+   *
+   * The instance starts in an uninitialized state. You must call either
+   * `loadBuffer()` (Browser) or `loadPath()` (Node.js) to load an audio
+   * file before using other methods.
+   */
+  constructor()
+  /**
+   * Load music file from a byte buffer (dispose the old one before)
+   *
+   * @param buffer A Uint8Array containing the audio file data
+   *
+   * @throws If the buffer doesn't contain a valid audio file
+   * @throws If the file doesn't contain any metadata tags
+   */
+  loadBuffer(buffer: Uint8Array): void
+  /**
+   * Load music file from a file path (dispose the old one before)
+   *
+   * @param path The file system path to the audio file
+   *
+   * @throws If the path doesn't exist or isn't accessible
+   * @throws If the file doesn't contain a valid audio format
+   * @throws If the file doesn't contain any metadata tags
+   * @throws If runs in WebAssembly environments (due to file system restrictions).
+   */
+  loadPath(path: string): void
+  /**
+   * Dispose of the currently loaded file
+   *
+   * Releases all resources associated with the loaded audio file.
+   * After calling this method, the instance returns to an uninitialized state.
+   *
+   * @note Any unsaved changes will be lost when disposing.
+   */
+  dispose(): void
+  /**
+   * Check if the current file is disposed. Use this method to verify
+   * if the instance is ready for operations before calling other methods.
+   *
+   * @returns `true` if no file is currently loaded, `false` otherwise
+   */
+  isDisposed(): boolean
+  /**
+   * Save metadata changes back to the internal buffer
+   *
+   * @throws If no file or buffer loaded
+   * @throws If saving fails due to file format constraints
+   */
+  save(): void
+  /**
+   * Current audio file buffer as a `Uint8Array`
+   *
+   * @throws If no file or buffer loaded
+   *
+   * @note For files loaded via `loadBuffer()`, call `save()` first to ensure
+   * metadata changes are applied. For files loaded via `loadPath()`, this
+   * returns an empty buffer.
+   */
+  get buffer(): Uint8Array
+  /**
+   * Audio quality classification ("HQ", "SQ", or "HiRes")
+   *
+   * @throws If no file or buffer loaded
+   *
+   * Quality is determined based on file format, sample rate, and bit depth:
+   * - HQ: Lossy formats (MP3, AAC, etc.)
+   * - SQ: Lossless formats at CD quality (44.1kHz, 16-bit)
+   * - HiRes: Lossless formats exceeding CD quality (>44.1kHz, >=16-bit)
+   */
+  get quality(): string
+  /**
+   * Audio bit depth in bits, or `null` if not available
+   *
+   * @throws If no file or buffer loaded
+   *
+   * Common values: 16 (CD quality), 24 (Hi-Res), 32 (studio quality)
+   */
+  get bitDepth(): number | null
+  /**
+   * Audio bit rate in kbps, or `null` if not available
+   *
+   * @throws If no file or buffer loaded
+   *
+   * @note If the audio properties don't provide a bitrate, this method calculates
+   * an approximate bitrate based on file size and duration, including metadata.
+   * The calculated bitrate is constrained between MIN_BITRATE and MAX_BITRATE.
+   */
+  get bitRate(): number | null
+  /**
+   * Audio sample rate in Hz, or `null` if not available
+   *
+   * @throws If no file or buffer loaded
+   *
+   * Common values: 44100 (CD), 48000 (DVD), 96000, 192000 (Hi-Res)
+   */
+  get sampleRate(): number | null
+  /**
+   * Number of audio channels, or `null` if not available
+   *
+   * @throws If no file or buffer loaded
+   *
+   * Common values: 1 (mono), 2 (stereo), 6 (5.1 surround)
+   * Common values: 1 (mono), 2 (stereo), 6 (5.1 surround), 8 (7.1 surround)
+   */
+  get channels(): number | null
+  /**
+   * Audio duration in seconds, or `null` if not available
+   *
+   * @throws If no file or buffer loaded
+   */
+  get duration(): number
+  /**
+   * File's metadata tag type, or `null` if not recognized
+   *
+   * Supported tag types: "ID3V1", "ID3V2", "APE", "VORBIS", "MP4", "AIFF", "RIFF"
+   *
+   * @throws If no file or buffer loaded
+   */
+  get tagType(): string | null
+  /**
+   * Title, or `null` if not set
+   *
+   * @throws If no file or buffer loaded
+   */
+  get title(): string | null
+  set title(title: string | null)
+  /**
+   * Artist, or `null` if not set
+   *
+   * @throws If no file or buffer loaded
+   */
+  get artist(): string | null
+  set artist(artist: string | null)
+  /**
+   * Album, or `null` if not set
+   *
+   * @throws If no file or buffer loaded
+   */
+  get album(): string | null
+  set album(album: string | null)
+  /**
+   * Year, or `null` if not set
+   *
+   * @throws If no file or buffer loaded
+   */
+  get year(): number | null
+  set year(year: number | null)
+  /**
+   * Genre, or `null` if not set
+   *
+   * @throws If no file or buffer loaded
+   */
+  get genre(): string | null
+  set genre(genre: string | null)
+  /**
+   * Track number, or `null` if not set
+   *
+   * @throws If no file or buffer loaded
+   */
+  get trackNumber(): number | null
+  set trackNumber(trackNumber: number | null)
+  /**
+   * Disc number, or `null` if not set
+   *
+   * @throws If no file or buffer loaded
+   */
+  get discNumber(): number | null
+  set discNumber(discNumber: number | null)
+  /**
+   * Total number of tracks in the album, or `null` if not set
+   *
+   * @throws If no file or buffer loaded
+   */
+  get trackTotal(): number | null
+  set trackTotal(trackTotal: number | null)
+  /**
+   * Total number of discs in the album, or `null` if not set
+   *
+   * @throws If no file or buffer loaded
+   */
+  get discsTotal(): number | null
+  set discsTotal(discsTotal: number | null)
+  /**
+   * Comment, or `null` if not set
+   *
+   * @throws If no file or buffer loaded
+   */
+  get comment(): string | null
+  set comment(comment: string | null)
+  /**
+   * Album artist, or `null` if not set
+   *
+   * @throws If no file or buffer loaded
+   *
+   * @note Album artist differs from track artist and represents the primary artist for the entire album.
+   */
+  get albumArtist(): string | null
+  set albumArtist(albumArtist: string | null)
+  /**
+   * Composer, or `null` if not set
+   *
+   * @throws If no file or buffer loaded
+   */
+  get composer(): string | null
+  set composer(composer: string | null)
+  /**
+   * Conductor, or `null` if not set
+   *
+   * @throws If no file or buffer loaded
+   */
+  get conductor(): string | null
+  set conductor(conductor: string | null)
+  /**
+   * Lyricist, or `null` if not set
+   *
+   * @throws If no file or buffer loaded
+   */
+  get lyricist(): string | null
+  set lyricist(lyricist: string | null)
+  /**
+   * Publisher, or `null` if not set
+   *
+   * @throws If no file or buffer loaded
+   */
+  get publisher(): string | null
+  set publisher(publisher: string | null)
+  /**
+   * Lyrics, or `null` if not set
+   *
+   * @throws If no file or buffer loaded
+   */
+  get lyrics(): string | null
+  set lyrics(lyrics: string | null)
+  /**
+   * Copyright information, or `null` if not set
+   *
+   * @throws If no file or buffer loaded
+   */
+  get copyright(): string | null
+  set copyright(copyright: string | null)
+  /**
+   * Track replay gain in dB, or `null` if not set
+   *
+   * @throws If no file or buffer loaded
+   *
+   * @note Replay gain is used to normalize playback volume across different tracks.
+   */
+  get trackReplayGain(): number | null
+  set trackReplayGain(trackReplayGain: number | null)
+  /**
+   * Track replay peak value, or `null` if not set
+   *
+   * @throws If no file or buffer loaded
+   *
+   * @note Replay peak represents the maximum amplitude level in the track.
+   */
+  get trackReplayPeak(): number | null
+  set trackReplayPeak(trackReplayPeak: number | null)
+  /**
+   * Album replay gain in dB, or `null` if not set
+   *
+   * @throws If no file or buffer loaded
+   *
+   * @note Album replay gain normalizes playback volume across different albums.
+   */
+  get albumReplayGain(): number | null
+  set albumReplayGain(albumReplayGain: number | null)
+  /**
+   * Album replay peak value, or `null` if not set
+   *
+   * @throws If no file or buffer loaded
+   *
+   * @note Album replay peak represents the maximum amplitude level in the album.
+   */
+  get albumReplayPeak(): number | null
+  set albumReplayPeak(albumReplayPeak: number | null)
+  /**
+   * Embedded pictures/album art list, or `null` if no picture is embedded
+   *
+   * @throws If no file or buffer loaded
+   *
+   * @note Returns all embedded pictures including album art, artist photos, etc.
+   */
+  get pictures(): Array<MetaPicture> | null
+  set pictures(pictures: Array<MetaPicture> | null)
+}

package/index.js

@@ -0,0 +1,576 @@
+// prettier-ignore
+/* eslint-disable */
+// @ts-nocheck
+/* auto-generated by NAPI-RS */
+
+const { readFileSync } = require('node:fs')
+let nativeBinding = null
+const loadErrors = []
+
+const isMusl = () => {
+  let musl = false
+  if (process.platform === 'linux') {
+    musl = isMuslFromFilesystem()
+    if (musl === null) {
+      musl = isMuslFromReport()
+    }
+    if (musl === null) {
+      musl = isMuslFromChildProcess()
+    }
+  }
+  return musl
+}
+
+const isFileMusl = (f) => f.includes('libc.musl-') || f.includes('ld-musl-')
+
+const isMuslFromFilesystem = () => {
+  try {
+    return readFileSync('/usr/bin/ldd', 'utf-8').includes('musl')
+  } catch {
+    return null
+  }
+}
+
+const isMuslFromReport = () => {
+  let report = null
+  if (typeof process.report?.getReport === 'function') {
+    process.report.excludeNetwork = true
+    report = process.report.getReport()
+  }
+  if (!report) {
+    return null
+  }
+  if (report.header && report.header.glibcVersionRuntime) {
+    return false
+  }
+  if (Array.isArray(report.sharedObjects)) {
+    if (report.sharedObjects.some(isFileMusl)) {
+      return true
+    }
+  }
+  return false
+}
+
+const isMuslFromChildProcess = () => {
+  try {
+    return require('child_process').execSync('ldd --version', { encoding: 'utf8' }).includes('musl')
+  } catch (e) {
+    // If we reach this case, we don't know if the system is musl or not, so is better to just fallback to false
+    return false
+  }
+}
+
+function requireNative() {
+  if (process.env.NAPI_RS_NATIVE_LIBRARY_PATH) {
+    try {
+      return require(process.env.NAPI_RS_NATIVE_LIBRARY_PATH);
+    } catch (err) {
+      loadErrors.push(err)
+    }
+  } else if (process.platform === 'android') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./music-tag-native.android-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('music-tag-native-android-arm64')
+        const bindingPackageVersion = require('music-tag-native-android-arm64/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm') {
+      try {
+        return require('./music-tag-native.android-arm-eabi.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('music-tag-native-android-arm-eabi')
+        const bindingPackageVersion = require('music-tag-native-android-arm-eabi/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Android ${process.arch}`))
+    }
+  } else if (process.platform === 'win32') {
+    if (process.arch === 'x64') {
+      if (process.config?.variables?.shlib_suffix === 'dll.a' || process.config?.variables?.node_target_type === 'shared_library') {
+        try {
+        return require('./music-tag-native.win32-x64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('music-tag-native-win32-x64-gnu')
+        const bindingPackageVersion = require('music-tag-native-win32-x64-gnu/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      } else {
+        try {
+        return require('./music-tag-native.win32-x64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('music-tag-native-win32-x64-msvc')
+        const bindingPackageVersion = require('music-tag-native-win32-x64-msvc/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      }
+    } else if (process.arch === 'ia32') {
+      try {
+        return require('./music-tag-native.win32-ia32-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('music-tag-native-win32-ia32-msvc')
+        const bindingPackageVersion = require('music-tag-native-win32-ia32-msvc/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./music-tag-native.win32-arm64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('music-tag-native-win32-arm64-msvc')
+        const bindingPackageVersion = require('music-tag-native-win32-arm64-msvc/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Windows: ${process.arch}`))
+    }
+  } else if (process.platform === 'darwin') {
+    try {
+      return require('./music-tag-native.darwin-universal.node')
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    try {
+      const binding = require('music-tag-native-darwin-universal')
+      const bindingPackageVersion = require('music-tag-native-darwin-universal/package.json').version
+      if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      }
+      return binding
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    if (process.arch === 'x64') {
+      try {
+        return require('./music-tag-native.darwin-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('music-tag-native-darwin-x64')
+        const bindingPackageVersion = require('music-tag-native-darwin-x64/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./music-tag-native.darwin-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('music-tag-native-darwin-arm64')
+        const bindingPackageVersion = require('music-tag-native-darwin-arm64/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on macOS: ${process.arch}`))
+    }
+  } else if (process.platform === 'freebsd') {
+    if (process.arch === 'x64') {
+      try {
+        return require('./music-tag-native.freebsd-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('music-tag-native-freebsd-x64')
+        const bindingPackageVersion = require('music-tag-native-freebsd-x64/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./music-tag-native.freebsd-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('music-tag-native-freebsd-arm64')
+        const bindingPackageVersion = require('music-tag-native-freebsd-arm64/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on FreeBSD: ${process.arch}`))
+    }
+  } else if (process.platform === 'linux') {
+    if (process.arch === 'x64') {
+      if (isMusl()) {
+        try {
+          return require('./music-tag-native.linux-x64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('music-tag-native-linux-x64-musl')
+          const bindingPackageVersion = require('music-tag-native-linux-x64-musl/package.json').version
+          if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./music-tag-native.linux-x64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('music-tag-native-linux-x64-gnu')
+          const bindingPackageVersion = require('music-tag-native-linux-x64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'arm64') {
+      if (isMusl()) {
+        try {
+          return require('./music-tag-native.linux-arm64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('music-tag-native-linux-arm64-musl')
+          const bindingPackageVersion = require('music-tag-native-linux-arm64-musl/package.json').version
+          if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./music-tag-native.linux-arm64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('music-tag-native-linux-arm64-gnu')
+          const bindingPackageVersion = require('music-tag-native-linux-arm64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'arm') {
+      if (isMusl()) {
+        try {
+          return require('./music-tag-native.linux-arm-musleabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('music-tag-native-linux-arm-musleabihf')
+          const bindingPackageVersion = require('music-tag-native-linux-arm-musleabihf/package.json').version
+          if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./music-tag-native.linux-arm-gnueabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('music-tag-native-linux-arm-gnueabihf')
+          const bindingPackageVersion = require('music-tag-native-linux-arm-gnueabihf/package.json').version
+          if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'loong64') {
+      if (isMusl()) {
+        try {
+          return require('./music-tag-native.linux-loong64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('music-tag-native-linux-loong64-musl')
+          const bindingPackageVersion = require('music-tag-native-linux-loong64-musl/package.json').version
+          if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./music-tag-native.linux-loong64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('music-tag-native-linux-loong64-gnu')
+          const bindingPackageVersion = require('music-tag-native-linux-loong64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'riscv64') {
+      if (isMusl()) {
+        try {
+          return require('./music-tag-native.linux-riscv64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('music-tag-native-linux-riscv64-musl')
+          const bindingPackageVersion = require('music-tag-native-linux-riscv64-musl/package.json').version
+          if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./music-tag-native.linux-riscv64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('music-tag-native-linux-riscv64-gnu')
+          const bindingPackageVersion = require('music-tag-native-linux-riscv64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'ppc64') {
+      try {
+        return require('./music-tag-native.linux-ppc64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('music-tag-native-linux-ppc64-gnu')
+        const bindingPackageVersion = require('music-tag-native-linux-ppc64-gnu/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 's390x') {
+      try {
+        return require('./music-tag-native.linux-s390x-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('music-tag-native-linux-s390x-gnu')
+        const bindingPackageVersion = require('music-tag-native-linux-s390x-gnu/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Linux: ${process.arch}`))
+    }
+  } else if (process.platform === 'openharmony') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./music-tag-native.openharmony-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('music-tag-native-openharmony-arm64')
+        const bindingPackageVersion = require('music-tag-native-openharmony-arm64/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'x64') {
+      try {
+        return require('./music-tag-native.openharmony-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('music-tag-native-openharmony-x64')
+        const bindingPackageVersion = require('music-tag-native-openharmony-x64/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm') {
+      try {
+        return require('./music-tag-native.openharmony-arm.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('music-tag-native-openharmony-arm')
+        const bindingPackageVersion = require('music-tag-native-openharmony-arm/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on OpenHarmony: ${process.arch}`))
+    }
+  } else {
+    loadErrors.push(new Error(`Unsupported OS: ${process.platform}, architecture: ${process.arch}`))
+  }
+}
+
+nativeBinding = requireNative()
+
+if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+  let wasiBinding = null
+  let wasiBindingError = null
+  try {
+    wasiBinding = require('./music-tag-native.wasi.cjs')
+    nativeBinding = wasiBinding
+  } catch (err) {
+    if (process.env.NAPI_RS_FORCE_WASI) {
+      wasiBindingError = err
+    }
+  }
+  if (!nativeBinding) {
+    try {
+      wasiBinding = require('music-tag-native-wasm32-wasi')
+      nativeBinding = wasiBinding
+    } catch (err) {
+      if (process.env.NAPI_RS_FORCE_WASI) {
+        wasiBindingError.cause = err
+        loadErrors.push(err)
+      }
+    }
+  }
+  if (process.env.NAPI_RS_FORCE_WASI === 'error' && !wasiBinding) {
+    const error = new Error('WASI binding not found and NAPI_RS_FORCE_WASI is set to error')
+    error.cause = wasiBindingError
+    throw error
+  }
+}
+
+if (!nativeBinding) {
+  if (loadErrors.length > 0) {
+    throw new Error(
+      `Cannot find native binding. ` +
+        `npm has a bug related to optional dependencies (https://github.com/npm/cli/issues/4828). ` +
+        'Please try `npm i` again after removing both package-lock.json and node_modules directory.',
+      {
+        cause: loadErrors.reduce((err, cur) => {
+          cur.cause = err
+          return cur
+        }),
+      },
+    )
+  }
+  throw new Error(`Failed to load native binding`)
+}
+
+module.exports = nativeBinding
+module.exports.MetaPicture = nativeBinding.MetaPicture
+module.exports.MusicTagger = nativeBinding.MusicTagger

package/package.json

@@ -0,0 +1,103 @@
+{
+  "name": "music-tag-native",
+  "version": "0.1.0",
+  "description": "Music tag reader / writter in Node.js / Browser, powered by napi-rs and lofty",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "browser": "browser.js",
+  "repository": {
+    "url": "git+ssh://git@github.com/subframe7536/music-tag-native.git",
+    "type": "git"
+  },
+  "license": "MIT",
+  "keywords": [
+    "napi-rs",
+    "NAPI",
+    "N-API",
+    "Rust",
+    "node-addon",
+    "node-addon-api",
+    "music",
+    "tags",
+    "MP3",
+    "M4A",
+    "FLAC",
+    "WAV",
+    "ID3",
+    "Vorbis"
+  ],
+  "files": [
+    "index.d.ts",
+    "index.js",
+    "browser.js"
+  ],
+  "napi": {
+    "binaryName": "music-tag-native",
+    "targets": [
+      "x86_64-unknown-linux-gnu",
+      "x86_64-unknown-linux-musl",
+      "x86_64-apple-darwin",
+      "x86_64-pc-windows-msvc",
+      "i686-pc-windows-msvc",
+      "aarch64-unknown-linux-gnu",
+      "aarch64-linux-android",
+      "aarch64-unknown-linux-musl",
+      "aarch64-apple-darwin",
+      "aarch64-pc-windows-msvc",
+      "wasm32-wasi-preview1-threads"
+    ]
+  },
+  "engines": {
+    "node": ">= 10"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "scripts": {
+    "artifacts": "napi artifacts",
+    "dev": "napi build --watch --target wasm32-wasip1-threads",
+    "build": "napi build --platform --release --strip",
+    "build:wasm": "napi build --release --target wasm32-wasip1-threads",
+    "build:debug": "napi build --platform",
+    "lint": "oxlint",
+    "test": "vitest run",
+    "play": "vite serve playground",
+    "test:watch": "vitest",
+    "prepublishOnly": "napi prepublish -t npm",
+    "release": "pnpm build && pnpm test && bumpp --all"
+  },
+  "devDependencies": {
+    "@emnapi/core": "^1.7.1",
+    "@emnapi/runtime": "^1.7.1",
+    "@napi-rs/cli": "^3.5.0",
+    "@napi-rs/wasm-runtime": "^1.1.0",
+    "@tybys/wasm-util": "^0.10.1",
+    "@types/node": "^24.10.1",
+    "bumpp": "^10.3.2",
+    "emnapi": "^1.7.1",
+    "oxlint": "^1.31.0",
+    "typescript": "^5.9.3",
+    "vite": "^7.2.7",
+    "vitest": "^4.0.15"
+  },
+  "packageManager": "pnpm@10.24.0",
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild"
+    ]
+  },
+  "optionalDependencies": {
+    "music-tag-native-linux-x64-gnu": "0.1.0",
+    "music-tag-native-linux-x64-musl": "0.1.0",
+    "music-tag-native-darwin-x64": "0.1.0",
+    "music-tag-native-win32-x64-msvc": "0.1.0",
+    "music-tag-native-win32-ia32-msvc": "0.1.0",
+    "music-tag-native-linux-arm64-gnu": "0.1.0",
+    "music-tag-native-android-arm64": "0.1.0",
+    "music-tag-native-linux-arm64-musl": "0.1.0",
+    "music-tag-native-darwin-arm64": "0.1.0",
+    "music-tag-native-win32-arm64-msvc": "0.1.0",
+    "music-tag-native-wasm32-wasi": "0.1.0"
+  }
+}