node-taglib-sharp-extend

node-taglib-sharp-extend

extend node-taglib-sharp with:

• MemoryFileAbstraction for file in memory
• utils that parse Uint8Array / File / FileSystemFileHandle

usage

basic

built-in:

import { File, MemoryFileAbstraction } from 'node-taglib-sharp-extend'

export function getFile(fileName: string, buffer: Uint8Array | Buffer | number[]): File {
  return File.createFromAbstraction(
    new MemoryFileAbstraction(fileName, buffer),
  )
}

// `File.save` will not flush original buffer, so need function to get current buffer
export function getBuffer(metadata: File): Uint8Array | undefined {
  const abstraction = metadata.fileAbstraction
  return abstraction instanceof MemoryFileAbstraction
    ? abstraction.current()
    : undefined
}

utils

import { parseFile } from 'node-taglib-sharp-extend/utils'

async function handleChange(target: EventTarget) {
  const file = (target as HTMLInputElement)?.files?.[0]
  if (file) {
    const [
      getMetaFile,
      { flush, fetchMetadata, clear, currentBuffer, updateTag }
    ] = await parseFile(file)
    const _file = getMetaFile()
    _file.tag.album = 'test album'
    updateTag('artists', ['test artists']) // type safe
    console.log(fetchMetadata())
    flush()
    console.log(currentBuffer().byteLength)
    clear()
  }
}

polyfill

if you want to run in browser, you need to polyfill some node modules

there is a built-in vite plugin for polyfill, and need to install vite-plugin-node-polyfills

import { defineConfig } from 'vite'
import { polyfillTaglib } from 'node-taglib-sharp-extend/vite'

export default defineConfig({
  plugins: [
    // allow extra node polyfill options
    polyfillTaglib(),
  ],
})