taglib-wasm 0.2.7 → 0.2.8

package/src/taglib-jsr.ts

@@ -5,540 +5,44 @@
  * 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";
+import { AudioFileImpl, TagLib as TagLibBase, createTagLib } from "./taglib.ts";
+import type { AudioFile, Tag, AudioProperties, FileType, PropertyMap } from "./taglib.ts";
+import type { TagLibConfig } from "./types.ts";
+import type { WasmModule } from "./wasm-jsr.ts";
+
+// Re-export types and implementations
+export { AudioFileImpl as AudioFileJSR } from "./taglib.ts";
+export type { Tag, AudioProperties, FileType, PropertyMap } from "./taglib.ts";
 
 /**
  * JSR-compatible TagLib singleton for WASM module management
  */
-export class TagLibJSR {
+export class TagLibJSR extends TagLibBase {
   private static instance: TagLibJSR | null = null;
-  private module: TagLibModule | null = null;
-  private initialized = false;
-
-  private constructor() {}
+  private static initialized = false;
 
-  static getInstance(): TagLibJSR {
+  static async getInstance(): Promise<TagLibJSR> {
     if (!TagLibJSR.instance) {
-      TagLibJSR.instance = new TagLibJSR();
+      // For JSR, we need to load the module directly without Node.js dependencies
+      // This is a placeholder - the actual implementation would need to load WASM directly
+      throw new Error("JSR version requires direct WASM loading implementation. Please use the NPM version for now.");
     }
     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(),
-      };
+    if (!TagLibJSR.initialized) {
+      await TagLibJSR.getInstance();
     }
-
-    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)
+   * Open a file from a buffer (JSR-compatible 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();
+  override async openFile(buffer: ArrayBuffer): Promise<AudioFile> {
+    return super.openFile(buffer);
   }
 }
+
+// Export alias for compatibility
+export { TagLibJSR as TagLib };