taglib-wasm 0.2.7 → 0.3.1

package/src/taglib-jsr.ts

@@ -1,544 +0,0 @@
-/**
- * @fileoverview JSR-compatible TagLib implementation
- *
- * This version uses direct WASM loading without Emscripten's JS file
- * to be compatible with JSR publishing requirements.
- */
-
-import type {
-  AudioFormat,
-  AudioProperties,
-  BitrateControlMode,
-  ExtendedTag,
-  Picture,
-  PropertyMap,
-  Tag,
-  TagLibConfig,
-} from "./types.ts";
-import {
-  cStringToJSJSR,
-  jsToCStringJSR,
-  loadTagLibModuleJSR,
-  type TagLibModule,
-} from "./wasm-jsr.ts";
-import { 
-  BITRATE_CONTROL_MODE_NAMES,
-  BITRATE_CONTROL_MODE_VALUES,
-  METADATA_MAPPINGS 
-} from "./types.ts";
-
-/**
- * JSR-compatible TagLib singleton for WASM module management
- */
-export class TagLibJSR {
-  private static instance: TagLibJSR | null = null;
-  private module: TagLibModule | null = null;
-  private initialized = false;
-
-  private constructor() {}
-
-  static getInstance(): TagLibJSR {
-    if (!TagLibJSR.instance) {
-      TagLibJSR.instance = new TagLibJSR();
-    }
-    return TagLibJSR.instance;
-  }
-
-  async initialize(config?: TagLibConfig): Promise<void> {
-    if (this.initialized) return;
-
-    this.module = await loadTagLibModuleJSR(config);
-    this.initialized = true;
-  }
-
-  getModule(): TagLibModule {
-    if (!this.module) {
-      throw new Error(
-        "TagLib not initialized. Call TagLib.initialize() first.",
-      );
-    }
-    return this.module;
-  }
-
-  isInitialized(): boolean {
-    return this.initialized;
-  }
-
-  /**
-   * Initialize taglib-wasm module
-   */
-  static async initialize(config?: TagLibConfig): Promise<void> {
-    const instance = TagLibJSR.getInstance();
-    await instance.initialize(config);
-  }
-
-  /**
-   * Get the WASM module instance
-   */
-  static getModule(): TagLibModule {
-    return TagLibJSR.getInstance().getModule();
-  }
-
-  /**
-   * Check if TagLib is initialized
-   */
-  static isInitialized(): boolean {
-    return TagLibJSR.getInstance().isInitialized();
-  }
-}
-
-/**
- * JSR-compatible audio file handling class
- */
-export class AudioFileJSR {
-  private fileId: number = 0;
-  private module: TagLibModule;
-  private dataPtr: number = 0;
-
-  constructor(data: Uint8Array) {
-    this.module = TagLibJSR.getModule();
-
-    // Allocate memory for file data
-    this.dataPtr = this.module.allocate(data, this.module.ALLOC_NORMAL);
-
-    // Create TagLib file from buffer
-    this.fileId = this.module._taglib_file_new_from_buffer(
-      this.dataPtr,
-      data.length,
-    );
-
-    if (!this.isValid()) {
-      this.cleanup();
-      throw new Error(
-        "Failed to load audio file - invalid format or corrupted data",
-      );
-    }
-  }
-
-  /**
-   * Check if the file is valid
-   */
-  isValid(): boolean {
-    return this.module._taglib_file_is_valid(this.fileId) === 1;
-  }
-
-  /**
-   * Get the audio format
-   */
-  getFormat(): AudioFormat {
-    const formatId = this.module._taglib_file_format(this.fileId);
-    const formats: Record<number, AudioFormat> = {
-      1: "MP3",
-      2: "FLAC",
-      3: "OGG",
-      4: "MP4",
-      5: "WMA",
-      6: "APE",
-      7: "MPC",
-      8: "WV",
-      9: "OPUS",
-      10: "TTA",
-      11: "WAV",
-      12: "AIFF",
-      13: "MOD",
-      14: "S3M",
-      15: "XM",
-      16: "IT",
-    };
-    return formats[formatId] || "MP3";
-  }
-
-  /**
-   * Get basic tag information
-   */
-  getTag(): Tag {
-    const tagPtr = this.module._taglib_file_tag(this.fileId);
-    if (tagPtr === 0) {
-      return {
-        title: "",
-        artist: "",
-        album: "",
-        comment: "",
-        genre: "",
-        year: 0,
-        track: 0,
-      };
-    }
-
-    return {
-      title: cStringToJSJSR(this.module, this.module._taglib_tag_title(tagPtr)),
-      artist: cStringToJSJSR(
-        this.module,
-        this.module._taglib_tag_artist(tagPtr),
-      ),
-      album: cStringToJSJSR(this.module, this.module._taglib_tag_album(tagPtr)),
-      comment: cStringToJSJSR(
-        this.module,
-        this.module._taglib_tag_comment(tagPtr),
-      ),
-      genre: cStringToJSJSR(this.module, this.module._taglib_tag_genre(tagPtr)),
-      year: this.module._taglib_tag_year(tagPtr),
-      track: this.module._taglib_tag_track(tagPtr),
-    };
-  }
-
-  /**
-   * Set basic tag information
-   */
-  setTag(tag: Partial<Tag>): void {
-    const tagPtr = this.module._taglib_file_tag(this.fileId);
-    if (tagPtr === 0) return;
-
-    if (tag.title !== undefined) {
-      const titlePtr = jsToCStringJSR(this.module, tag.title);
-      this.module._taglib_tag_set_title(tagPtr, titlePtr);
-      this.module._free(titlePtr);
-    }
-
-    if (tag.artist !== undefined) {
-      const artistPtr = jsToCStringJSR(this.module, tag.artist);
-      this.module._taglib_tag_set_artist(tagPtr, artistPtr);
-      this.module._free(artistPtr);
-    }
-
-    if (tag.album !== undefined) {
-      const albumPtr = jsToCStringJSR(this.module, tag.album);
-      this.module._taglib_tag_set_album(tagPtr, albumPtr);
-      this.module._free(albumPtr);
-    }
-
-    if (tag.comment !== undefined) {
-      const commentPtr = jsToCStringJSR(this.module, tag.comment);
-      this.module._taglib_tag_set_comment(tagPtr, commentPtr);
-      this.module._free(commentPtr);
-    }
-
-    if (tag.genre !== undefined) {
-      const genrePtr = jsToCStringJSR(this.module, tag.genre);
-      this.module._taglib_tag_set_genre(tagPtr, genrePtr);
-      this.module._free(genrePtr);
-    }
-
-    if (tag.year !== undefined) {
-      this.module._taglib_tag_set_year(tagPtr, tag.year);
-    }
-
-    if (tag.track !== undefined) {
-      this.module._taglib_tag_set_track(tagPtr, tag.track);
-    }
-  }
-
-  /**
-   * Get audio properties
-   */
-  getAudioProperties(): AudioProperties {
-    const propsPtr = this.module._taglib_file_audioproperties(this.fileId);
-    if (propsPtr === 0) {
-      return {
-        length: 0,
-        bitrate: 0,
-        sampleRate: 0,
-        channels: 0,
-        format: this.getFormat(),
-      };
-    }
-
-    return {
-      length: this.module._taglib_audioproperties_length(propsPtr),
-      bitrate: this.module._taglib_audioproperties_bitrate(propsPtr),
-      sampleRate: this.module._taglib_audioproperties_samplerate(propsPtr),
-      channels: this.module._taglib_audioproperties_channels(propsPtr),
-      format: this.getFormat(),
-    };
-  }
-
-  /**
-   * Get extended tag information (placeholder for JSR version)
-   */
-  getExtendedTag(): ExtendedTag {
-    // For JSR compatibility, return basic implementation
-    const basicTag = this.getTag();
-    return {
-      ...basicTag,
-
-      // Fingerprinting & identification - placeholder
-      acoustidFingerprint: "",
-      acoustidId: "",
-      musicbrainzTrackId: "",
-      musicbrainzReleaseId: "",
-      musicbrainzArtistId: "",
-      musicbrainzReleaseGroupId: "",
-      albumArtist: "",
-      composer: "",
-      discNumber: 0,
-      totalTracks: 0,
-      totalDiscs: 0,
-      bpm: 0,
-      compilation: false,
-      titleSort: "",
-      artistSort: "",
-      albumSort: "",
-
-      // Volume normalization - placeholder
-      replayGainTrackGain: "",
-      replayGainTrackPeak: "",
-      replayGainAlbumGain: "",
-      replayGainAlbumPeak: "",
-      appleSoundCheck: "",
-    };
-  }
-
-  /**
-   * Set extended tag fields (placeholder for JSR version)
-   */
-  setExtendedTag(extendedTag: Partial<ExtendedTag>): void {
-    // Set basic fields
-    this.setTag(extendedTag);
-
-    // Extended fields are placeholder for JSR version
-    // Full implementation would require PropertyMap integration
-  }
-
-  /**
-   * Get pictures from the file (placeholder for JSR version)
-   */
-  getPictures(): Picture[] {
-    // Placeholder - full implementation would require format-specific picture extraction
-    return [];
-  }
-
-  /**
-   * Set pictures in the file (placeholder for JSR version)
-   */
-  setPictures(pictures: Picture[]): void {
-    // Placeholder - full implementation would require format-specific picture handling
-  }
-
-  // Placeholder methods for extended metadata (same as main implementation)
-  getAcoustidFingerprint(): string {
-    return "";
-  }
-  setAcoustidFingerprint(fingerprint: string): void {}
-  getMusicbrainzTrackId(): string {
-    return "";
-  }
-  setMusicbrainzTrackId(id: string): void {}
-  getMusicbrainzRecordingId(): string {
-    return "";
-  }
-  setMusicbrainzRecordingId(id: string): void {}
-  getMusicbrainzArtistId(): string {
-    return "";
-  }
-  setMusicbrainzArtistId(id: string): void {}
-  getMusicbrainzAlbumId(): string {
-    return "";
-  }
-  setMusicbrainzAlbumId(id: string): void {}
-  getMusicbrainzAlbumArtistId(): string {
-    return "";
-  }
-  setMusicbrainzAlbumArtistId(id: string): void {}
-  getMusicbrainzReleaseGroupId(): string {
-    return "";
-  }
-  setMusicbrainzReleaseGroupId(id: string): void {}
-  getReplayGainTrackGain(): string {
-    return "";
-  }
-  setReplayGainTrackGain(gain: string): void {}
-  getReplayGainTrackPeak(): string {
-    return "";
-  }
-  setReplayGainTrackPeak(peak: string): void {}
-  getReplayGainAlbumGain(): string {
-    return "";
-  }
-  setReplayGainAlbumGain(gain: string): void {}
-  getReplayGainAlbumPeak(): string {
-    return "";
-  }
-  setReplayGainAlbumPeak(peak: string): void {}
-  getAppleSoundCheck(): string {
-    return "";
-  }
-  setAppleSoundCheck(soundCheck: string): void {}
-
-  /**
-   * Get all properties as a PropertyMap
-   */
-  properties(): PropertyMap {
-    const jsonPtr = this.module._taglib_file_properties_json(this.fileId);
-    if (jsonPtr === 0) return {};
-    
-    const jsonStr = cStringToJSJSR(this.module, jsonPtr);
-    try {
-      return JSON.parse(jsonStr);
-    } catch {
-      return {};
-    }
-  }
-
-  /**
-   * Set properties from a PropertyMap
-   */
-  setProperties(properties: PropertyMap): boolean {
-    const jsonStr = JSON.stringify(properties);
-    const jsonPtr = jsToCStringJSR(this.module, jsonStr);
-    try {
-      return this.module._taglib_file_set_properties_json(this.fileId, jsonPtr) !== 0;
-    } finally {
-      this.module._free(jsonPtr);
-    }
-  }
-
-  /**
-   * Get a specific property value
-   */
-  getProperty(key: string): string[] | undefined {
-    const keyPtr = jsToCStringJSR(this.module, key);
-    try {
-      const valuePtr = this.module._taglib_file_get_property(this.fileId, keyPtr);
-      if (valuePtr === 0) return undefined;
-      
-      const value = cStringToJSJSR(this.module, valuePtr);
-      return value ? [value] : undefined;
-    } finally {
-      this.module._free(keyPtr);
-    }
-  }
-
-  /**
-   * Set a specific property value
-   */
-  setProperty(key: string, values: string | string[]): boolean {
-    const value = Array.isArray(values) ? values[0] : values;
-    if (!value) return false;
-    
-    const keyPtr = jsToCStringJSR(this.module, key);
-    const valuePtr = jsToCStringJSR(this.module, value);
-    try {
-      return this.module._taglib_file_set_property(this.fileId, keyPtr, valuePtr) !== 0;
-    } finally {
-      this.module._free(keyPtr);
-      this.module._free(valuePtr);
-    }
-  }
-
-  /**
-   * Check if this is an MP4 file
-   */
-  isMP4(): boolean {
-    return this.module._taglib_file_is_mp4(this.fileId) !== 0;
-  }
-
-  /**
-   * Get MP4-specific item (for custom atoms)
-   */
-  getMP4Item(key: string): string | undefined {
-    if (!this.isMP4()) return undefined;
-    
-    const keyPtr = jsToCStringJSR(this.module, key);
-    try {
-      const valuePtr = this.module._taglib_mp4_get_item(this.fileId, keyPtr);
-      if (valuePtr === 0) return undefined;
-      
-      return cStringToJSJSR(this.module, valuePtr);
-    } finally {
-      this.module._free(keyPtr);
-    }
-  }
-
-  /**
-   * Set MP4-specific item (for custom atoms)
-   */
-  setMP4Item(key: string, value: string): boolean {
-    if (!this.isMP4()) return false;
-    
-    const keyPtr = jsToCStringJSR(this.module, key);
-    const valuePtr = jsToCStringJSR(this.module, value);
-    try {
-      return this.module._taglib_mp4_set_item(this.fileId, keyPtr, valuePtr) !== 0;
-    } finally {
-      this.module._free(keyPtr);
-      this.module._free(valuePtr);
-    }
-  }
-
-  /**
-   * Remove MP4-specific item
-   */
-  removeMP4Item(key: string): boolean {
-    if (!this.isMP4()) return false;
-    
-    const keyPtr = jsToCStringJSR(this.module, key);
-    try {
-      return this.module._taglib_mp4_remove_item(this.fileId, keyPtr) !== 0;
-    } finally {
-      this.module._free(keyPtr);
-    }
-  }
-
-  /**
-   * Get bitrate control mode (MP4/M4A specific)
-   * Reads from the 'acbf' atom
-   */
-  getBitrateControlMode(): BitrateControlMode | undefined {
-    if (!this.isMP4()) return undefined;
-    
-    const value = this.getMP4Item("acbf");
-    if (!value) return undefined;
-    
-    const numValue = parseInt(value, 10);
-    if (isNaN(numValue) || numValue < 0 || numValue > 3) return undefined;
-    
-    return BITRATE_CONTROL_MODE_NAMES[numValue];
-  }
-
-  /**
-   * Set bitrate control mode (MP4/M4A specific)
-   * Writes to the 'acbf' atom
-   */
-  setBitrateControlMode(mode: BitrateControlMode): boolean {
-    if (!this.isMP4()) return false;
-    
-    const numValue = BITRATE_CONTROL_MODE_VALUES[mode];
-    if (numValue === undefined) return false;
-    
-    return this.setMP4Item("acbf", numValue.toString());
-  }
-
-  /**
-   * Save changes to the file
-   */
-  save(): Uint8Array {
-    if (!this.module._taglib_file_save(this.fileId)) {
-      throw new Error("Failed to save audio file");
-    }
-
-    // In a real implementation, we'd need to extract the modified file data
-    // For now, return empty array as placeholder
-    return new Uint8Array(0);
-  }
-
-  /**
-   * Clean up resources
-   */
-  cleanup(): void {
-    if (this.fileId) {
-      this.module._taglib_file_delete(this.fileId);
-      this.fileId = 0;
-    }
-    if (this.dataPtr) {
-      this.module._free(this.dataPtr);
-      this.dataPtr = 0;
-    }
-  }
-
-  /**
-   * Destructor to ensure cleanup
-   */
-  destroy(): void {
-    this.cleanup();
-  }
-}

package/src/wasm-embind.ts

@@ -1,55 +0,0 @@
-/**
- * WebAssembly module interface for Embind version
- */
-export interface WasmModule {
-  // Memory access
-  HEAP8: Int8Array;
-  HEAP16: Int16Array;
-  HEAP32: Int32Array;
-  HEAPU8: Uint8Array;
-  HEAPU16: Uint16Array;
-  HEAPU32: Uint32Array;
-  HEAPF32: Float32Array;
-  HEAPF64: Float64Array;
-
-  // Runtime methods
-  allocate: (size: number, type: number) => number;
-  _malloc: (size: number) => number;
-  _free: (ptr: number) => void;
-  getValue: (ptr: number, type: string) => number;
-  setValue: (ptr: number, value: number, type: string) => void;
-  UTF8ToString: (ptr: number) => string;
-  stringToUTF8: (str: string, outPtr: number, maxBytesToWrite: number) => void;
-  lengthBytesUTF8: (str: string) => number;
-
-  // Allocation types
-  ALLOC_NORMAL: number;
-  ALLOC_STACK: number;
-
-  // Embind classes (these will be available after module loads)
-  FileHandle: any;
-  TagWrapper: any;
-  AudioPropertiesWrapper: any;
-  createFileHandle: () => any;
-}
-
-/**
- * Extended module interface with our Embind classes
- */
-export interface TagLibModule extends WasmModule {
-  // These are the actual class constructors from Embind
-  FileHandle: {
-    new(): any;
-  };
-  
-  TagWrapper: {
-    new(tagPtr: number): any;
-  };
-  
-  AudioPropertiesWrapper: {
-    new(propsPtr: number): any;
-  };
-  
-  // Factory function
-  createFileHandle: () => any;
-}