taglib-wasm 1.0.0-beta.4 → 1.0.0-beta.6

package/dist/index.d.ts

@@ -32,173 +32,26 @@
  * });
  * ```
  */
-/**
- * Full API exports for advanced usage with full control.
- * @see {@link TagLib} - Main TagLib class
- * @see {@link AudioFile} - Audio file interface
- */
 export { AudioFileImpl as AudioFile, TagLib } from "./src/taglib.ts";
 export type { MutableTag } from "./src/taglib.ts";
-/**
- * Error types for proper error handling and debugging.
- * @see {@link TagLibError} - Base error class for all TagLib errors
- * @see {@link TagLibInitializationError} - Wasm initialization failures
- * @see {@link InvalidFormatError} - Invalid or corrupted file format
- * @see {@link UnsupportedFormatError} - Valid but unsupported format
- * @see {@link FileOperationError} - File read/write/save failures
- * @see {@link MetadataError} - Tag reading/writing failures
- * @see {@link MemoryError} - Wasm memory allocation issues
- * @see {@link EnvironmentError} - Runtime/environment issues
- * @see {@link WorkerError} - Worker pool operation failures
- * @see {@link SidecarError} - Sidecar process failures
- */
 export { EnvironmentError, FileOperationError, InvalidFormatError, isEnvironmentError, isFileOperationError, isInvalidFormatError, isMemoryError, isMetadataError, isSidecarError, isTagLibError, isUnsupportedFormatError, isWorkerError, MemoryError, MetadataError, SidecarError, SUPPORTED_FORMATS, TagLibError, TagLibInitializationError, UnsupportedFormatError, WorkerError, } from "./src/errors.ts";
 export type { TagLibErrorCode } from "./src/errors.ts";
-/**
- * Simple API exports for easy tag reading and writing.
- * @see {@link readTags} - Read metadata from audio files
- * @see {@link applyTags} - Apply metadata changes and return modified buffer
- * @see {@link updateTags} - Update metadata and save to disk
- * @see {@link readProperties} - Read audio properties
- * @see {@link readPictures} - Read cover art/pictures
- * @see {@link applyPictures} - Apply pictures to audio files
- * @see {@link readCoverArt} - Read primary cover art data
- * @see {@link applyCoverArt} - Apply primary cover art
- * @see {@link readTagsBatch} - Read tags from multiple files efficiently
- * @see {@link readPropertiesBatch} - Read properties from multiple files efficiently
- * @see {@link readMetadataBatch} - Read complete metadata from multiple files efficiently
- * @see {@link setWorkerPoolMode} - Enable/disable worker pool for Simple API
- */
-export { addPicture, applyCoverArt, applyPictures, applyTags, type BatchOptions, type BatchResult, clearPictures, clearTags, findPictureByType, isValidAudioFile, readCoverArt, readFormat, readMetadataBatch, readPictureMetadata, readPictures, readProperties, readPropertiesBatch, readTags, readTagsBatch, replacePictureByType, setBufferMode, setSidecarConfig, setWorkerPoolMode, updateTags, } from "./src/simple.ts";
-/**
- * Enhanced property constants and utilities with rich metadata.
- * @see {@link PROPERTIES} - Comprehensive property definitions with metadata
- * @see {@link PropertyKey} - Type-safe property keys
- * @see {@link PropertyValue} - Type-safe property values
- * @see {@link isValidProperty} - Validate property keys
- * @see {@link getPropertyMetadata} - Get property metadata
- * @see {@link getAllPropertyKeys} - Get all valid property keys
- * @see {@link getPropertiesByFormat} - Filter properties by format support
- * @see {@link Tags} - Legacy tag name constants (deprecated)
- * @see {@link FormatMappings} - Format-specific field mappings (deprecated)
- */
+export { initializeForDenoCompile, isDenoCompiled, prepareWasmForEmbedding, } from "./src/deno-compile.ts";
+export { addPicture, applyCoverArt, applyPictures, applyTags, applyTagsToBuffer, type BatchOptions, type BatchResult, clearPictures, clearTags, findPictureByType, isValidAudioFile, readCoverArt, readFormat, readMetadataBatch, readPictureMetadata, readPictures, readProperties, readPropertiesBatch, readTags, readTagsBatch, replacePictureByType, setBufferMode, setSidecarConfig, setWorkerPoolMode, updateTags, writeTagsToFile, } from "./src/simple/index.ts";
 export { FormatMappings, getAllProperties, getAllPropertyKeys, getAllTagNames, getPropertiesByFormat, getPropertyMetadata, isValidProperty, isValidTagName, PROPERTIES, Tags, } from "./src/constants.ts";
 export type { PropertyMetadata } from "./src/constants/property-types.ts";
-/**
- * File I/O utilities for cover art operations.
- * @see {@link exportCoverArt} - Export cover art to file
- * @see {@link importCoverArt} - Import cover art from file
- * @see {@link copyCoverArt} - Copy cover art between files
- */
-export { copyCoverArt, exportAllPictures, exportCoverArt, exportPictureByType, findCoverArtFiles, importCoverArt, importPictureWithType, loadPictureFromFile, savePictureToFile, } from "./src/file-utils.ts";
-/**
- * Folder/batch operations for processing multiple audio files.
- * @see {@link scanFolder} - Scan folder for audio files and read metadata
- * @see {@link updateFolderTags} - Update tags for multiple files
- * @see {@link findDuplicates} - Find duplicate files based on metadata
- * @see {@link exportFolderMetadata} - Export folder metadata to JSON
- */
-export { type AudioDynamics, type AudioFileMetadata, exportFolderMetadata, findDuplicates, type FolderScanOptions, type FolderScanResult, scanFolder, updateFolderTags, } from "./src/folder-api.ts";
-/**
- * Web browser utilities for cover art operations.
- * @see {@link pictureToDataURL} - Convert picture to data URL
- * @see {@link setCoverArtFromCanvas} - Set cover art from HTML canvas
- * @see {@link displayPicture} - Display picture in HTML img element
- */
-export { canvasToPicture, createPictureDownloadURL, createPictureGallery, dataURLToPicture, displayPicture, imageFileToPicture, pictureToDataURL, setCoverArtFromCanvas, } from "./src/web-utils.ts";
-/**
- * Type exports for TypeScript users.
- * These types define the structure of metadata, audio properties,
- * and configuration options used throughout the library.
- *
- * @see {@link Tag} - Basic metadata structure
- * @see {@link ExtendedTag} - Extended metadata with advanced fields
- * @see {@link AudioProperties} - Audio technical properties
- * @see {@link PropertyKey} - Type-safe property keys with autocomplete
- * @see {@link PropertyValue} - Type-safe property values
- */
-export type { AudioFileInput, AudioFormat, AudioProperties, ExtendedTag, FieldMapping, FileType, Picture, PropertyMap, Tag, TagName, } from "./src/types.ts";
-export type { PropertyKey, PropertyValue } from "./src/constants.ts";
-/**
- * Type and constant exports
- */
-export type { BitrateControlMode, OpenOptions, PictureType, } from "./src/types.ts";
+export { copyCoverArt, exportAllPictures, exportCoverArt, exportPictureByType, findCoverArtFiles, importCoverArt, importPictureWithType, loadPictureFromFile, savePictureToFile, } from "./src/file-utils/index.ts";
+export { type AudioDynamics, type AudioFileMetadata, exportFolderMetadata, findDuplicates, type FolderScanOptions, type FolderScanResult, scanFolder, updateFolderTags, } from "./src/folder-api/index.ts";
+export { canvasToPicture, createPictureDownloadURL, createPictureGallery, dataURLToPicture, displayPicture, imageFileToPicture, pictureToDataURL, setCoverArtFromCanvas, } from "./src/web-utils/index.ts";
+export type { AudioFileInput, AudioFormat, AudioProperties, BitrateControlMode, ExtendedTag, FieldMapping, FileType, OpenOptions, Picture, PictureType, PropertyMap, Tag, TagName, } from "./src/types.ts";
 export { BITRATE_CONTROL_MODE_NAMES, BITRATE_CONTROL_MODE_VALUES, PICTURE_TYPE_NAMES, PICTURE_TYPE_VALUES, } from "./src/types.ts";
-/**
- * Complex property types and constants for structured metadata.
- * @see {@link COMPLEX_PROPERTIES} - Rich metadata object with format mappings
- * @see {@link COMPLEX_PROPERTY_KEY} - Simple key map for daily use
- * @see {@link Rating} - Track rating metadata (normalized 0.0-1.0)
- * @see {@link UnsyncedLyrics} - Unsynchronized lyrics text
- * @see {@link ComplexPropertyValueMap} - Type map for generic methods
- */
+export type { PropertyKey, PropertyValue } from "./src/constants.ts";
 export { COMPLEX_PROPERTIES, COMPLEX_PROPERTY_KEY, } from "./src/constants/complex-properties.ts";
 export type { ComplexPropertyKey, ComplexPropertyKeyMap, ComplexPropertyValueMap, Rating, UnsyncedLyrics, VariantMap, } from "./src/constants/complex-properties.ts";
-/**
- * Rating conversion utilities for cross-format compatibility.
- * @see {@link RatingUtils} - Namespace with all rating utilities
- * @see {@link toNormalized} - POPM (0-255) to normalized (0.0-1.0)
- * @see {@link fromNormalized} - Normalized to POPM
- * @see {@link toStars} - Normalized to star rating
- * @see {@link fromStars} - Star rating to normalized
- * @see {@link toPopm} - Normalized to standard POPM value
- * @see {@link fromPopm} - Standard POPM to normalized
- */
 export { clamp as clampRating, fromNormalized, fromPercent, fromPopm, fromStars, isValid as isValidRating, RatingUtils, toNormalized, toPercent, toPopm, toStars, } from "./src/utils/rating.ts";
-/**
- * Worker pool exports for parallel processing.
- * @see {@link TagLibWorkerPool} - Worker pool for parallel file processing
- * @see {@link createWorkerPool} - Create and initialize a worker pool
- * @see {@link getGlobalWorkerPool} - Get/create global worker pool instance (deprecated)
- * @see {@link terminateGlobalWorkerPool} - Terminate global worker pool
- */
-export { createWorkerPool, getGlobalWorkerPool, TagLibWorkerPool, terminateGlobalWorkerPool, } from "./src/worker-pool.ts";
-export type { BatchOperation, WorkerPoolOptions, WorkerTask, } from "./src/worker-pool.ts";
-/**
- * Wasm module types for advanced usage.
- * @see {@link TagLibModule} - Full TagLib Wasm module interface
- * @see {@link WasmModule} - Base Emscripten module interface
- */
+export { createWorkerPool, getGlobalWorkerPool, TagLibWorkerPool, terminateGlobalWorkerPool, } from "./src/worker-pool/index.ts";
+export type { BatchOperation, WorkerPoolOptions, WorkerTask, } from "./src/worker-pool/index.ts";
 export type { TagLibModule, WasmModule } from "./src/wasm.ts";
-import type { TagLibModule } from "./src/wasm.ts";
-/**
- * Configuration options for loading the TagLib WASM module
- */
 export type { LoadTagLibOptions } from "./src/runtime/loader-types.ts";
-import type { LoadTagLibOptions } from "./src/runtime/loader-types.ts";
-/**
- * Load the TagLib Wasm module.
- * This function initializes the WebAssembly module and returns
- * the loaded module for use with the Full API.
- *
- * Automatically selects the optimal implementation:
- * - WASI for Deno/Node.js (faster filesystem access, MessagePack serialization)
- * - Emscripten for browsers (universal compatibility)
- *
- * @param options - Optional configuration for module initialization
- * @returns Promise resolving to the initialized TagLib module
- *
- * @example
- * ```typescript
- * import { loadTagLibModule, TagLib } from "taglib-wasm";
- *
- * // Auto-select optimal implementation
- * const module = await loadTagLibModule();
- * const taglib = new TagLib(module);
- *
- * // Force buffer mode (Emscripten-based in-memory I/O)
- * const module = await loadTagLibModule({ forceBufferMode: true });
- *
- * // Force WASI mode (Deno/Node.js only)
- * const module = await loadTagLibModule({ forceWasmType: "wasi" });
- *
- * // With custom WASM binary
- * const wasmData = await fetch("taglib.wasm").then(r => r.arrayBuffer());
- * const module = await loadTagLibModule({ wasmBinary: wasmData });
- * ```
- *
- * @note Most users should use `TagLib.initialize()` instead,
- * which handles module loading automatically.
- */
-export declare function loadTagLibModule(options?: LoadTagLibOptions): Promise<TagLibModule>;
+export { loadTagLibModule } from "./src/runtime/module-loader.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -22,11 +22,17 @@ import {
   UnsupportedFormatError,
   WorkerError
 } from "./src/errors.js";
+import {
+  initializeForDenoCompile,
+  isDenoCompiled,
+  prepareWasmForEmbedding
+} from "./src/deno-compile.js";
 import {
   addPicture,
   applyCoverArt,
   applyPictures,
   applyTags,
+  applyTagsToBuffer,
   clearPictures,
   clearTags,
   findPictureByType,
@@ -44,8 +50,9 @@ import {
   setBufferMode,
   setSidecarConfig,
   setWorkerPoolMode,
-  updateTags
-} from "./src/simple.js";
+  updateTags,
+  writeTagsToFile
+} from "./src/simple/index.js";
 import {
   FormatMappings,
   getAllProperties,
@@ -68,13 +75,13 @@ import {
   importPictureWithType,
   loadPictureFromFile,
   savePictureToFile
-} from "./src/file-utils.js";
+} from "./src/file-utils/index.js";
 import {
   exportFolderMetadata,
   findDuplicates,
   scanFolder,
   updateFolderTags
-} from "./src/folder-api.js";
+} from "./src/folder-api/index.js";
 import {
   canvasToPicture,
   createPictureDownloadURL,
@@ -84,7 +91,7 @@ import {
   imageFileToPicture,
   pictureToDataURL,
   setCoverArtFromCanvas
-} from "./src/web-utils.js";
+} from "./src/web-utils/index.js";
 import {
   BITRATE_CONTROL_MODE_NAMES,
   BITRATE_CONTROL_MODE_VALUES,
@@ -113,57 +120,8 @@ import {
   getGlobalWorkerPool,
   TagLibWorkerPool,
   terminateGlobalWorkerPool
-} from "./src/worker-pool.js";
-async function loadTagLibModule(options) {
-  if (options?.forceBufferMode) {
-    return loadBufferModeTagLibModule(options);
-  }
-  try {
-    const { loadUnifiedTagLibModule } = await import("./src/runtime/unified-loader.js");
-    return await loadUnifiedTagLibModule({
-      wasmBinary: options?.wasmBinary,
-      wasmUrl: options?.wasmUrl,
-      forceWasmType: options?.forceWasmType,
-      debug: false,
-      useInlineWasm: false
-    });
-  } catch (error) {
-    console.warn(
-      `[TagLib] Unified loader failed, falling back to buffer mode: ${error}`
-    );
-    return loadBufferModeTagLibModule(options || {});
-  }
-}
-async function loadBufferModeTagLibModule(options) {
-  let createTagLibModule;
-  try {
-    const module2 = await import("./taglib-wrapper.js");
-    createTagLibModule = module2.default;
-  } catch {
-    try {
-      const module2 = await import("./dist/taglib-wrapper.js");
-      createTagLibModule = module2.default;
-    } catch {
-      throw new Error(
-        "Could not load taglib-wrapper.js from either ./build or ./dist"
-      );
-    }
-  }
-  const moduleConfig = {};
-  if (options?.wasmBinary) {
-    moduleConfig.wasmBinary = options.wasmBinary;
-  }
-  if (options?.wasmUrl) {
-    moduleConfig.locateFile = (path) => {
-      if (path.endsWith(".wasm")) {
-        return options.wasmUrl;
-      }
-      return path;
-    };
-  }
-  const module = await createTagLibModule(moduleConfig);
-  return module;
-}
+} from "./src/worker-pool/index.js";
+import { loadTagLibModule } from "./src/runtime/module-loader.js";
 export {
   AudioFileImpl as AudioFile,
   BITRATE_CONTROL_MODE_NAMES,
@@ -193,6 +151,7 @@ export {
   applyCoverArt,
   applyPictures,
   applyTags,
+  applyTagsToBuffer,
   canvasToPicture,
   clamp as clampRating,
   clearPictures,
@@ -223,6 +182,8 @@ export {
   imageFileToPicture,
   importCoverArt,
   importPictureWithType,
+  initializeForDenoCompile,
+  isDenoCompiled,
   isEnvironmentError,
   isFileOperationError,
   isInvalidFormatError,
@@ -239,6 +200,7 @@ export {
   loadPictureFromFile,
   loadTagLibModule,
   pictureToDataURL,
+  prepareWasmForEmbedding,
   readCoverArt,
   readFormat,
   readMetadataBatch,
@@ -261,5 +223,6 @@ export {
   toPopm,
   toStars,
   updateFolderTags,
-  updateTags
+  updateTags,
+  writeTagsToFile
 };

package/dist/src/deno-compile.d.ts

@@ -7,12 +7,7 @@
  * @module taglib-wasm/deno-compile
  */
 import { TagLib } from "./taglib.ts";
-/**
- * Detects if the code is running in a compiled Deno binary.
- *
- * @returns true if running in a Deno compiled binary, false otherwise
- */
-export declare function isDenoCompiled(): boolean;
+export { isDenoCompiled } from "./runtime/deno-detect.ts";
 /**
  * Initialize TagLib with automatic handling for Deno compiled binaries.
  *

package/dist/src/deno-compile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deno-compile.d.ts","sourceRoot":"","sources":["../../src/deno-compile.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAQxC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,wBAAwB,CAC5C,gBAAgB,SAAsB,GACrC,OAAO,CAAC,MAAM,CAAC,CAuBjB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,SAAsB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAyCf"}
+{"version":3,"file":"deno-compile.d.ts","sourceRoot":"","sources":["../../src/deno-compile.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,wBAAwB,CAC5C,gBAAgB,SAAsB,GACrC,OAAO,CAAC,MAAM,CAAC,CA2BjB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,SAAsB,GAC/B,OAAO,CAAC,IAAI,CAAC,CA+Cf"}

package/dist/src/deno-compile.js

@@ -1,22 +1,26 @@
 import { TagLib } from "./taglib.js";
-function isDenoCompiled() {
-  return typeof Deno !== "undefined" && // @ts-ignore: Deno global is only available in Deno runtime
-  typeof Deno.mainModule === "string" && // @ts-ignore: Deno global is only available in Deno runtime
-  Deno.mainModule.includes("deno-compile://");
-}
+import { FileOperationError } from "./errors/classes.js";
+import { isDenoCompiled } from "./runtime/deno-detect.js";
+import { isDenoCompiled as isDenoCompiled2 } from "./runtime/deno-detect.js";
 async function initializeForDenoCompile(embeddedWasmPath = "./taglib-web.wasm") {
   if (isDenoCompiled()) {
-    try {
-      const wasmUrl = new URL(embeddedWasmPath, import.meta.url);
-      const wasmBinary = await Deno.readFile(wasmUrl);
-      return await TagLib.initialize({ wasmBinary, forceBufferMode: true });
-    } catch (error) {
-      console.warn(
-        `Could not load embedded WASM from ${embeddedWasmPath}:`,
-        error
-      );
-      console.warn("Falling back to network fetch (requires --allow-net)");
+    const strategies = [
+      // Relative to user's entry point (where --include embeds files)
+      () => Deno.readFile(new URL(embeddedWasmPath, Deno.mainModule)),
+      // Relative to this library module
+      () => Deno.readFile(new URL(embeddedWasmPath, import.meta.url)),
+      // CWD fallback (last resort — depends on where the binary is invoked)
+      () => Deno.readFile(embeddedWasmPath)
+    ];
+    for (const strategy of strategies) {
+      try {
+        const wasmBinary = await strategy();
+        return await TagLib.initialize({ wasmBinary, forceBufferMode: true });
+      } catch {
+      }
     }
+    console.warn(`Could not load embedded WASM from ${embeddedWasmPath}`);
+    console.warn("Falling back to network fetch (requires --allow-net)");
   }
   return await TagLib.initialize({ forceBufferMode: true });
 }
@@ -41,7 +45,10 @@ async function prepareWasmForEmbedding(outputPath = "./taglib-web.wasm") {
       }
     }
     if (!wasmData || !sourcePath) {
-      throw new Error("Could not find taglib-web.wasm in expected locations");
+      throw new FileOperationError(
+        "read",
+        "Could not find taglib-web.wasm in expected locations"
+      );
     }
     await Deno.writeFile(outputPath, wasmData);
     console.log(`WASM file copied from ${sourcePath} to ${outputPath}`);
@@ -50,11 +57,14 @@ async function prepareWasmForEmbedding(outputPath = "./taglib-web.wasm") {
     );
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
-    throw new Error(`Failed to prepare WASM for embedding: ${message}`);
+    throw new FileOperationError(
+      "read",
+      `Failed to prepare WASM for embedding: ${message}`
+    );
   }
 }
 export {
   initializeForDenoCompile,
-  isDenoCompiled,
+  isDenoCompiled2 as isDenoCompiled,
   prepareWasmForEmbedding
 };

package/dist/src/errors/base.d.ts

@@ -11,13 +11,13 @@ export type TagLibErrorCode = "INITIALIZATION" | "INVALID_FORMAT" | "UNSUPPORTED
  */
 export declare class TagLibError extends Error {
     readonly code: TagLibErrorCode;
-    readonly details?: Record<string, any> | undefined;
+    readonly details?: Record<string, unknown> | undefined;
     /**
      * Creates a new TagLibError
      * @param code - Error code for programmatic handling
      * @param message - Human-readable error message
      * @param details - Additional context about the error
      */
-    constructor(code: TagLibErrorCode, message: string, details?: Record<string, any> | undefined);
+    constructor(code: TagLibErrorCode, message: string, details?: Record<string, unknown> | undefined);
 }
 //# sourceMappingURL=base.d.ts.map

package/dist/src/errors/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/errors/base.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,iBAAiB,sDAOpB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,gBAAgB,GAChB,gBAAgB,GAChB,oBAAoB,GACpB,gBAAgB,GAChB,UAAU,GACV,QAAQ,GACR,aAAa,GACb,QAAQ,GACR,SAAS,CAAC;AAEd;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;aAQlB,IAAI,EAAE,eAAe;aAErB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAT/C;;;;;OAKG;gBAEe,IAAI,EAAE,eAAe,EACrC,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,YAAA;CAMhD"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/errors/base.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,iBAAiB,sDAOpB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,gBAAgB,GAChB,gBAAgB,GAChB,oBAAoB,GACpB,gBAAgB,GAChB,UAAU,GACV,QAAQ,GACR,aAAa,GACb,QAAQ,GACR,SAAS,CAAC;AAEd;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;aAQlB,IAAI,EAAE,eAAe;aAErB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IATnD;;;;;OAKG;gBAEe,IAAI,EAAE,eAAe,EACrC,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAMpD"}

package/dist/src/errors/classes.d.ts

@@ -8,7 +8,7 @@ export declare class TagLibInitializationError extends TagLibError {
      * @param message - Description of the initialization failure
      * @param details - Additional context about the error
      */
-    constructor(message: string, details?: Record<string, any>);
+    constructor(message: string, details?: Record<string, unknown>);
 }
 /**
  * Error thrown when an audio file format is invalid or corrupted
@@ -21,7 +21,7 @@ export declare class InvalidFormatError extends TagLibError {
      * @param bufferSize - Size of the audio buffer in bytes
      * @param details - Additional context about the error
      */
-    constructor(message: string, bufferSize?: number | undefined, details?: Record<string, any>);
+    constructor(message: string, bufferSize?: number | undefined, details?: Record<string, unknown>);
 }
 /**
  * Error thrown when an audio format is recognized but not supported
@@ -35,7 +35,7 @@ export declare class UnsupportedFormatError extends TagLibError {
      * @param supportedFormats - List of formats that are supported
      * @param details - Additional context about the error
      */
-    constructor(format: string, supportedFormats?: readonly string[], details?: Record<string, any>);
+    constructor(format: string, supportedFormats?: readonly string[], details?: Record<string, unknown>);
 }
 /**
  * Error thrown during file operations (read, write, save)
@@ -50,7 +50,7 @@ export declare class FileOperationError extends TagLibError {
      * @param path - File path involved in the operation
      * @param details - Additional context about the error
      */
-    constructor(operation: "read" | "write" | "save" | "stat", message: string, path?: string | undefined, details?: Record<string, any>);
+    constructor(operation: "read" | "write" | "save" | "stat", message: string, path?: string | undefined, details?: Record<string, unknown>);
 }
 /**
  * Error thrown when metadata operations fail
@@ -65,7 +65,7 @@ export declare class MetadataError extends TagLibError {
      * @param field - The metadata field involved
      * @param details - Additional context about the error
      */
-    constructor(operation: "read" | "write", message: string, field?: string | undefined, details?: Record<string, any>);
+    constructor(operation: "read" | "write", message: string, field?: string | undefined, details?: Record<string, unknown>);
 }
 /**
  * Error thrown when Wasm memory operations fail
@@ -76,7 +76,7 @@ export declare class MemoryError extends TagLibError {
      * @param message - Description of the memory failure
      * @param details - Additional context about the error
      */
-    constructor(message: string, details?: Record<string, any>);
+    constructor(message: string, details?: Record<string, unknown>);
 }
 /**
  * Error thrown when the environment doesn't support required features
@@ -102,7 +102,7 @@ export declare class WorkerError extends TagLibError {
      * @param message - Description of the worker failure
      * @param details - Additional context about the error
      */
-    constructor(message: string, details?: Record<string, any>);
+    constructor(message: string, details?: Record<string, unknown>);
 }
 /**
  * Error thrown when sidecar process operations fail
@@ -113,6 +113,6 @@ export declare class SidecarError extends TagLibError {
      * @param message - Description of the sidecar failure
      * @param details - Additional context about the error
      */
-    constructor(message: string, details?: Record<string, any>);
+    constructor(message: string, details?: Record<string, unknown>);
 }
 //# sourceMappingURL=classes.d.ts.map

package/dist/src/errors/classes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"classes.d.ts","sourceRoot":"","sources":["../../../src/errors/classes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,WAAW,EAAE,MAAM,WAAW,CAAC;AAY3D;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,WAAW;IACxD;;;;OAIG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAS3D;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,WAAW;aAS/B,UAAU,CAAC,EAAE,MAAM;IARrC;;;;;OAKG;gBAED,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA,EACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAqBhC;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,WAAW;aAQnC,MAAM,EAAE,MAAM;aACd,gBAAgB,EAAE,SAAS,MAAM,EAAE;IARrD;;;;;OAKG;gBAEe,MAAM,EAAE,MAAM,EACd,gBAAgB,GAAE,SAAS,MAAM,EAAsB,EACvE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAYhC;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,WAAW;aAS/B,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM;aAE7C,IAAI,CAAC,EAAE,MAAM;IAV/B;;;;;;OAMG;gBAEe,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,EAC7D,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA,EAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAgBhC;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,WAAW;aAS1B,SAAS,EAAE,MAAM,GAAG,OAAO;aAE3B,KAAK,CAAC,EAAE,MAAM;IAVhC;;;;;;OAMG;gBAEe,SAAS,EAAE,MAAM,GAAG,OAAO,EAC3C,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,MAAM,YAAA,EAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAgBhC;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;;;OAIG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAS3D;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;aAQ7B,WAAW,EAAE,MAAM;aACnB,MAAM,EAAE,MAAM;aACd,eAAe,CAAC,EAAE,MAAM;IAT1C;;;;;OAKG;gBAEe,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,MAAM,YAAA;CAS3C;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;;;OAIG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAK3D;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,WAAW;IAC3C;;;;OAIG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAK3D"}
+{"version":3,"file":"classes.d.ts","sourceRoot":"","sources":["../../../src/errors/classes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,WAAW,EAAE,MAAM,WAAW,CAAC;AAY3D;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,WAAW;IACxD;;;;OAIG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAS/D;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,WAAW;aAS/B,UAAU,CAAC,EAAE,MAAM;IARrC;;;;;OAKG;gBAED,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA,EACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAqBpC;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,WAAW;aAQnC,MAAM,EAAE,MAAM;aACd,gBAAgB,EAAE,SAAS,MAAM,EAAE;IARrD;;;;;OAKG;gBAEe,MAAM,EAAE,MAAM,EACd,gBAAgB,GAAE,SAAS,MAAM,EAAsB,EACvE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAYpC;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,WAAW;aAS/B,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM;aAE7C,IAAI,CAAC,EAAE,MAAM;IAV/B;;;;;;OAMG;gBAEe,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,EAC7D,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA,EAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAgBpC;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,WAAW;aAS1B,SAAS,EAAE,MAAM,GAAG,OAAO;aAE3B,KAAK,CAAC,EAAE,MAAM;IAVhC;;;;;;OAMG;gBAEe,SAAS,EAAE,MAAM,GAAG,OAAO,EAC3C,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,MAAM,YAAA,EAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAgBpC;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;;;OAIG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAS/D;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;aAQ7B,WAAW,EAAE,MAAM;aACnB,MAAM,EAAE,MAAM;aACd,eAAe,CAAC,EAAE,MAAM;IAT1C;;;;;OAKG;gBAEe,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,MAAM,YAAA;CAS3C;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;;;OAIG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAK/D;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,WAAW;IAC3C;;;;OAIG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAK/D"}

package/dist/src/file-utils/copy-and-find.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Copy cover art from one audio file to another
+ *
+ * @param sourcePath - Path to source audio file
+ * @param targetPath - Path to target audio file (modified in place)
+ * @param options - Copy options
+ * @returns Promise that resolves when cover art is copied
+ * @throws Error if source has no cover art
+ *
+ * @example
+ * ```typescript
+ * // Copy cover art from one file to another
+ * await copyCoverArt("album/track01.mp3", "album/track02.mp3");
+ *
+ * // Copy all pictures
+ * await copyCoverArt("source.mp3", "target.mp3", { copyAll: true });
+ * ```
+ */
+export declare function copyCoverArt(sourcePath: string, targetPath: string, options?: {
+    copyAll?: boolean;
+}): Promise<void>;
+/**
+ * Check if cover art files exist for an audio file
+ *
+ * Looks for common cover art filenames in the same directory as the audio file.
+ *
+ * @param audioPath - Path to the audio file
+ * @returns Object with found cover art paths
+ *
+ * @example
+ * ```typescript
+ * const covers = await findCoverArtFiles("music/album/track01.mp3");
+ * if (covers.front) {
+ *   await importCoverArt("music/album/track01.mp3", covers.front);
+ * }
+ * ```
+ */
+export declare function findCoverArtFiles(audioPath: string): Promise<{
+    front?: string;
+    back?: string;
+    folder?: string;
+    [key: string]: string | undefined;
+}>;
+//# sourceMappingURL=copy-and-find.d.ts.map

package/dist/src/file-utils/copy-and-find.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-and-find.d.ts","sourceRoot":"","sources":["../../../src/file-utils/copy-and-find.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,OAAO,CAAC;CACd,GACL,OAAO,CAAC,IAAI,CAAC,CA6Bf;AA2BD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC,CAAC,CAiCD"}