taglib-wasm 1.4.3 → 1.5.1

package/dist/simple.browser.js

@@ -302,6 +302,9 @@ var init_base = __esm({
 });
 
 // src/errors/classes.ts
+function errorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
 function createErrorMessage(prefix, details) {
   return `${prefix}: ${details}`;
 }
@@ -552,6 +555,50 @@ var init_audio_file_bwf = __esm({
   }
 });
 
+// src/taglib/id3v2-frames.ts
+function assertMp3(format) {
+  if (format !== "MP3") {
+    throw new UnsupportedFormatError(format, ["MP3"], {
+      operation: "id3v2Frames"
+    });
+  }
+}
+function assertFrameId(id, operation) {
+  if (!FRAME_ID_PATTERN.test(id)) {
+    throw new MetadataError(
+      operation,
+      `Invalid ID3v2 frame ID: "${id}". Frame IDs must match [A-Z0-9]{4}`,
+      id
+    );
+  }
+}
+function assertFrameBodies(id, data) {
+  for (const body of data) {
+    if (body.length === 0) {
+      throw new MetadataError(
+        "write",
+        "Frame data must not be empty: zero-size ID3v2 frames are invalid",
+        id
+      );
+    }
+  }
+}
+function toPublicFrame(frame) {
+  return {
+    id: frame.id,
+    data: frame.data,
+    ...frame.flags ? { flags: frame.flags } : {}
+  };
+}
+var FRAME_ID_PATTERN;
+var init_id3v2_frames = __esm({
+  "src/taglib/id3v2-frames.ts"() {
+    "use strict";
+    init_classes();
+    FRAME_ID_PATTERN = /^[A-Z0-9]{4}$/;
+  }
+});
+
 // browser-stub:platform-io-browser-stub
 function getPlatformIO() {
   throw new Error("Filesystem operations are not available in the browser.");
@@ -582,6 +629,60 @@ var init_write = __esm({
   }
 });
 
+// browser-stub:node-fs-browser-stub
+function getNodeFsSync() {
+  return null;
+}
+var init_node_fs_browser_stub = __esm({
+  "browser-stub:node-fs-browser-stub"() {
+  }
+});
+
+// src/utils/rating.ts
+function normalized(value) {
+  return value;
+}
+var init_rating = __esm({
+  "src/utils/rating.ts"() {
+    "use strict";
+  }
+});
+
+// src/runtime/detector.ts
+function isDeno() {
+  return g.Deno !== void 0;
+}
+var g, EXNREF_PROBE;
+var init_detector = __esm({
+  "src/runtime/detector.ts"() {
+    "use strict";
+    g = globalThis;
+    EXNREF_PROBE = new Uint8Array([
+      0,
+      97,
+      115,
+      109,
+      1,
+      0,
+      0,
+      0,
+      // Wasm header
+      6,
+      6,
+      // Global section, 6 bytes
+      1,
+      // 1 global
+      105,
+      0,
+      // exnref, const
+      208,
+      105,
+      11
+      // ref.null exnref, end
+    ]);
+  }
+});
+
 // src/constants/additional-properties.ts
 var ADDITIONAL_PROPERTIES;
 var init_additional_properties = __esm({
@@ -1578,6 +1679,7 @@ function isValidBitrateMode(value) {
   return value === "CBR" || value === "VBR" || value === "ABR";
 }
 function wrapEmbindHandle(raw) {
+  const stagedId3v2Frames = {};
   const overrides = {
     getTagData() {
       const tw = raw.getTag();
@@ -1637,6 +1739,17 @@ function wrapEmbindHandle(raw) {
       else delete props["LYRICS"];
       handle.setProperties(props);
     },
+    setId3v2Frames(id, data) {
+      stagedId3v2Frames[id] = data.map((d) => new Uint8Array(d));
+      raw.setId3v2Frames(id, data);
+    },
+    removeId3v2Frames(id) {
+      stagedId3v2Frames[id] = [];
+      raw.removeId3v2Frames(id);
+    },
+    getStagedId3v2Frames() {
+      return Object.keys(stagedId3v2Frames).length > 0 ? { ...stagedId3v2Frames } : void 0;
+    },
     hasId3Tags() {
       const v = raw.hasId3Tags();
       if (!v || typeof v !== "object") return { v1: false, v2: false };
@@ -1744,6 +1857,16 @@ var init_extra_state_registry = __esm({
           if (v !== void 0) target.setIxml(v);
           else if (complete) target.setIxml(null);
         }
+      },
+      {
+        name: "id3v2Frames",
+        copy(target, source) {
+          const staged = source.getStagedId3v2Frames?.();
+          if (!staged) return;
+          for (const [id, bodies] of Object.entries(staged)) {
+            target.setId3v2Frames(id, bodies);
+          }
+        }
       }
     ];
   }
@@ -1803,25 +1926,27 @@ function inferEndTimeMs(sorted, index, trackEndMs) {
   return next ? next.startTimeMs : trackEndMs;
 }
 function readFileSync(path) {
-  if (typeof Deno !== "undefined") return Deno.readFileSync(path);
-  if (_nodeFs === void 0) {
-    try {
-      _nodeFs = new Function("return require('node:fs')")();
-    } catch {
-      _nodeFs = null;
-    }
-  }
-  if (_nodeFs) return new Uint8Array(_nodeFs.readFileSync(path));
-  return new Uint8Array(0);
+  if (isDeno()) return Deno.readFileSync(path);
+  const fs = getNodeFsSync();
+  if (fs) return new Uint8Array(fs.readFileSync(path));
+  throw new FileOperationError(
+    "read",
+    "node:fs is unavailable in this runtime: cannot read file data from disk",
+    path
+  );
 }
-var _nodeFs, AudioFileImpl;
+var AudioFileImpl;
 var init_audio_file_impl = __esm({
   "src/taglib/audio-file-impl.ts"() {
     "use strict";
     init_types2();
     init_audio_file_bwf();
+    init_id3v2_frames();
     init_errors2();
     init_write();
+    init_node_fs_browser_stub();
+    init_rating();
+    init_detector();
     init_audio_file_base();
     init_save_reconstruct();
     AudioFileImpl = class extends BaseAudioFileImpl {
@@ -1844,6 +1969,7 @@ var init_audio_file_impl = __esm({
           );
         }
         this.cachedAudioProperties = null;
+        this.pathModeBuffer = null;
         return this.handle.save();
       }
       getFileBuffer() {
@@ -1854,11 +1980,20 @@ var init_audio_file_impl = __esm({
           try {
             this.pathModeBuffer = readFileSync(this.sourcePath);
             return this.pathModeBuffer;
-          } catch {
-            return new Uint8Array(0);
+          } catch (error) {
+            if (error instanceof FileOperationError) throw error;
+            throw new FileOperationError(
+              "read",
+              `Cannot return file data: ${errorMessage(error)}`,
+              this.sourcePath,
+              { cause: error }
+            );
           }
         }
-        return new Uint8Array(0);
+        throw new FileOperationError(
+          "read",
+          "No file data available: in-memory buffer is empty and no source path is set"
+        );
       }
       async saveToFile(path) {
         const targetPath = path ?? this.sourcePath;
@@ -1899,6 +2034,7 @@ var init_audio_file_impl = __esm({
             await writeFileData(targetPath, buffer);
           }
         }
+        this.pathModeBuffer = null;
       }
       getPictures() {
         const picturesArray = this.handle.getPictures();
@@ -2010,11 +2146,27 @@ var init_audio_file_impl = __esm({
       }
       getRating() {
         const ratings = this.getRatings();
-        return ratings.length > 0 ? ratings[0].rating : void 0;
+        return ratings.length > 0 ? normalized(ratings[0].rating) : void 0;
       }
       setRating(rating, email) {
         this.setRatings([{ rating, email, counter: 0 }]);
       }
+      getId3v2Frames(id) {
+        assertMp3(this.getFormat());
+        if (id !== void 0) assertFrameId(id, "read");
+        return this.handle.getId3v2Frames(id ?? "").map(toPublicFrame);
+      }
+      setId3v2Frames(id, data) {
+        assertMp3(this.getFormat());
+        assertFrameId(id, "write");
+        assertFrameBodies(id, data);
+        this.handle.setId3v2Frames(id, data);
+      }
+      removeId3v2Frames(id) {
+        assertMp3(this.getFormat());
+        assertFrameId(id, "write");
+        this.handle.removeId3v2Frames(id);
+      }
       hasId3Tags() {
         return this.handle.hasId3Tags();
       }
@@ -2199,7 +2351,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = "1.4.3";
+    VERSION = "1.5.1";
   }
 });
 
@@ -2257,8 +2409,8 @@ function toWasiPath(osPath) {
   }
   let p = osPath;
   if (!p.startsWith("/") && !/^[A-Za-z]:/.test(p)) {
-    const g = globalThis;
-    const cwd = typeof Deno !== "undefined" ? Deno.cwd() : g.process?.cwd?.();
+    const g2 = globalThis;
+    const cwd = isDeno() ? Deno.cwd() : g2.process?.cwd?.();
     if (cwd) {
       p = cwd.replace(/[/\\]+$/, "") + "/" + p;
     }
@@ -2281,6 +2433,7 @@ var init_taglib_class = __esm({
     "use strict";
     init_audio_formats();
     init_errors2();
+    init_detector();
     init_audio_file_impl();
     init_load_audio_data();
     init_tag_mapping();

package/dist/src/constants/complex-properties.d.ts

@@ -36,6 +36,25 @@ export interface Rating {
     /** Play counter (if supported by format) */
     counter?: number;
 }
+/**
+ * A raw ID3v2 frame (escape hatch for vendor and unsupported frames).
+ *
+ * `data` is the frame BODY only (no 10-byte header); the caller owns the
+ * body encoding. Reads of TagLib-modeled IDs (TIT2, APIC, ...) return
+ * TagLib's canonical rendering; see the raw-frames docs for caveats.
+ */
+export interface Id3v2Frame {
+    /** 4-character frame ID matching [A-Z0-9]{4}, e.g. "TXXX", "RGAD" */
+    id: string;
+    /** Frame body bytes (without the 10-byte frame header) */
+    data: Uint8Array;
+    /**
+     * Frame header flags. Reserved for forward compatibility: currently never
+     * populated — TagLib blanks frame header flags when rendering, so they
+     * cannot be observed or preserved. Read-only.
+     */
+    flags?: number;
+}
 /**
  * Unsynchronized lyrics text.
  * For lyrics without timing information.

package/dist/src/constants/complex-properties.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"complex-properties.d.ts","sourceRoot":"","sources":["../../../src/constants/complex-properties.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD;;;;;;;;GAQG;AACH,MAAM,WAAW,MAAM;IACrB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,uBAAuB;IACtC,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,MAAM,EAAE,cAAc,CAAC;IACvB,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,uBAAuB,CAAC;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4CrB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,CAAC,IAAI,kBAAkB,GAAG,CAAC;CACtC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,EAAE,qBAKzB,CAAC"}
+{"version":3,"file":"complex-properties.d.ts","sourceRoot":"","sources":["../../../src/constants/complex-properties.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD;;;;;;;;GAQG;AACH,MAAM,WAAW,MAAM;IACrB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,qEAAqE;IACrE,EAAE,EAAE,MAAM,CAAC;IACX,0DAA0D;IAC1D,IAAI,EAAE,UAAU,CAAC;IACjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,uBAAuB;IACtC,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,MAAM,EAAE,cAAc,CAAC;IACvB,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,uBAAuB,CAAC;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4CrB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,CAAC,IAAI,kBAAkB,GAAG,CAAC;CACtC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,EAAE,qBAKzB,CAAC"}

package/dist/src/msgpack/encoder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"encoder.d.ts","sourceRoot":"","sources":["../../../src/msgpack/encoder.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,OAAO,EAAU,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE/D,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,OAAO,EACP,WAAW,EACZ,MAAM,aAAa,CAAC;AAGrB;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,aAU3B,CAAC;AA4BH,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,CAsC9D;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,eAAe,GAAG,UAAU,CAS7E;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,WAAW,GAAG,UAAU,CAStE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAe1D;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,UAAU,CAelE;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,IAAI,EAAE,CAAC,EACP,OAAO,GAAE,OAAO,CAAC,cAAc,CAAM,GACpC,UAAU,CAUZ;AAED,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,UAAU,CAe/D;AAqBD,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,UAAU,CAc1E;AAED,wBAAiB,uBAAuB,CAAC,CAAC,EACxC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,GACxB,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CActC;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAS7D;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,GAC1E,UAAU,CAeZ;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAW7D;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,GAAG;IACxD,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAaA"}
+{"version":3,"file":"encoder.d.ts","sourceRoot":"","sources":["../../../src/msgpack/encoder.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,OAAO,EAAU,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE/D,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,OAAO,EACP,WAAW,EACZ,MAAM,aAAa,CAAC;AAGrB;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,aAW3B,CAAC;AA4BH,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,CAsC9D;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,eAAe,GAAG,UAAU,CAS7E;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,WAAW,GAAG,UAAU,CAStE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAe1D;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,UAAU,CAelE;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,IAAI,EAAE,CAAC,EACP,OAAO,GAAE,OAAO,CAAC,cAAc,CAAM,GACpC,UAAU,CAUZ;AAED,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,UAAU,CAe/D;AAqBD,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,UAAU,CAc1E;AAED,wBAAiB,uBAAuB,CAAC,CAAC,EACxC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,GACxB,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CActC;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAS7D;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,GAC1E,UAAU,CAeZ;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAW7D;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,GAAG;IACxD,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAaA"}

package/dist/src/msgpack/encoder.js

@@ -4,6 +4,7 @@ import { toTagLibKey } from "../constants/properties.js";
 const PASSTHROUGH_KEYS = /* @__PURE__ */ new Set([
   "pictures",
   "ratings",
+  "id3v2Frames",
   "lyrics",
   "chapters",
   "_mp4ChapterStyle",

package/dist/src/runtime/detector.d.ts

@@ -13,6 +13,8 @@ export interface RuntimeDetectionResult {
  * Pass undefined for non-Node environments (always returns undefined).
  */
 export declare function checkNodeVersion(nodeVersion: string | undefined): string | undefined;
+/** Shared Deno-runtime check — do not hand-roll `typeof Deno` tests (taglib-rfr). */
+export declare function isDeno(): boolean;
 export declare function detectRuntime(): RuntimeDetectionResult;
 /**
  * Detect whether the runtime supports the Wasm `exnref` type.

package/dist/src/runtime/detector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../../src/runtime/detector.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAC1B,WAAW,GACX,WAAW,GACX,UAAU,GACV,SAAS,GACT,iBAAiB,GACjB,QAAQ,GACR,YAAY,CAAC;AAEjB,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,YAAY,CAAC;AAEnD,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,kBAAkB,CAAC;IAChC,QAAQ,EAAE,cAAc,CAAC;IACzB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CAC5B;AAOD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B,MAAM,GAAG,SAAS,CAepB;AA2CD,wBAAgB,aAAa,IAAI,sBAAsB,CA8EtD;AAWD;;;GAGG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAMxC;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAmBzE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAQjE;AAED,gBAAgB;AAChB,wBAAgB,aAAa,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAElE;AAED,gBAAgB;AAChB,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,gBAAgB;AAChB,wBAAgB,mBAAmB,IAAI,sBAAsB,CAG5D"}
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../../src/runtime/detector.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAC1B,WAAW,GACX,WAAW,GACX,UAAU,GACV,SAAS,GACT,iBAAiB,GACjB,QAAQ,GACR,YAAY,CAAC;AAEjB,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,YAAY,CAAC;AAEnD,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,kBAAkB,CAAC;IAChC,QAAQ,EAAE,cAAc,CAAC;IACzB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CAC5B;AAOD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B,MAAM,GAAG,SAAS,CAepB;AAuCD,qFAAqF;AACrF,wBAAgB,MAAM,IAAI,OAAO,CAEhC;AAED,wBAAgB,aAAa,IAAI,sBAAsB,CA8EtD;AAWD;;;GAGG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAMxC;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAmBzE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAQjE;AAED,gBAAgB;AAChB,wBAAgB,aAAa,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAElE;AAED,gBAAgB;AAChB,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,gBAAgB;AAChB,wBAAgB,mBAAmB,IAAI,sBAAsB,CAG5D"}

package/dist/src/runtime/detector.js

@@ -183,5 +183,6 @@ export {
   checkNodeVersion,
   detectRuntime,
   getEnvironmentDescription,
+  isDeno,
   supportsExnref
 };

package/dist/src/runtime/loader-types.d.ts

@@ -8,8 +8,11 @@
  */
 export interface LoadTagLibOptions {
     /**
-     * Optional pre-loaded WASM binary data.
-     * If provided, this will be used instead of fetching from network.
+     * Optional pre-loaded Wasm binary data (Emscripten backend only).
+     * If provided, it is used instead of fetching from network, and auto mode
+     * selects the Emscripten backend deterministically. Combining with
+     * `forceWasmType: "wasi"` throws — the WASI backend loads from a
+     * filesystem path or URL; use `wasmUrl` for that backend.
      */
     wasmBinary?: ArrayBuffer | Uint8Array;
     /**

package/dist/src/runtime/loader-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader-types.d.ts","sourceRoot":"","sources":["../../../src/runtime/loader-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,UAAU,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC;IAEtC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IAEtC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC"}
+{"version":3,"file":"loader-types.d.ts","sourceRoot":"","sources":["../../../src/runtime/loader-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC;IAEtC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IAEtC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC"}

package/dist/src/runtime/module-loader.d.ts

@@ -32,8 +32,9 @@ import type { TagLibModule } from "../wasm.js";
  * // 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());
+ * // With custom WASM binary (selects the Emscripten backend; the bytes
+ * // must be its artifact, taglib-web.wasm)
+ * const wasmData = await fetch("taglib-web.wasm").then(r => r.arrayBuffer());
  * const module = await loadTagLibModule({ wasmBinary: wasmData });
  * ```
  *

package/dist/src/runtime/module-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module-loader.d.ts","sourceRoot":"","sources":["../../../src/runtime/module-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAS/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAkDvB"}
+{"version":3,"file":"module-loader.d.ts","sourceRoot":"","sources":["../../../src/runtime/module-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAS/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAqEvB"}

package/dist/src/runtime/module-loader.js

@@ -12,6 +12,12 @@ async function loadTagLibModule(options) {
   if (versionError) {
     throw new EnvironmentError("Node.js", versionError, "WASI support");
   }
+  if (options?.forceWasmType === "wasi" && options?.wasmBinary) {
+    throw new TagLibInitializationError(
+      "wasmBinary is not supported by the WASI backend: it loads from a filesystem path or URL. Use wasmUrl, or omit forceWasmType to use the Emscripten backend",
+      { forceWasmType: "wasi" }
+    );
+  }
   if (!options?.wasmBinary && !options?.wasmUrl && !options?.forceWasmType && isDenoCompiled()) {
     const wasmBinary = await tryLoadEmbeddedWasm();
     if (!wasmBinary) {
@@ -37,6 +43,12 @@ async function loadTagLibModule(options) {
       debug: false
     });
   } catch (error) {
+    if (options?.forceWasmType === "wasi") {
+      throw new TagLibInitializationError(
+        `WASI backend failed to load: ${errorMessage(error)}. forceWasmType is "wasi", so the Emscripten fallback was not attempted`,
+        { cause: error, forceWasmType: "wasi" }
+      );
+    }
     console.warn(
       `[TagLib] Unified loader failed, falling back to buffer mode: ${errorMessage(error)}`
     );

package/dist/src/runtime/unified-loader/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../../src/runtime/unified-loader/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAI5E,wBAAsB,uBAAuB,CAC3C,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAmC9B"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../../src/runtime/unified-loader/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAK5E,wBAAsB,uBAAuB,CAC3C,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CA4C9B"}

package/dist/src/runtime/unified-loader/loader.js

@@ -1,7 +1,14 @@
 import { detectRuntime } from "../detector.js";
+import { ModuleLoadError } from "./types.js";
 import { selectWasmType } from "./module-selection.js";
 import { loadModule } from "./module-loading.js";
 async function loadUnifiedTagLibModule(options = {}) {
+  if (options.forceWasmType === "wasi" && options.wasmBinary) {
+    throw new ModuleLoadError(
+      "wasmBinary is not supported by the WASI backend: it loads from a filesystem path or URL. Use wasmUrl, or omit forceWasmType to select the Emscripten backend",
+      "wasi"
+    );
+  }
   const startTime = performance.now();
   const runtime = detectRuntime();
   if (options.debug) {

package/dist/src/runtime/unified-loader/module-loading.d.ts

@@ -1,4 +1,6 @@
 import type { RuntimeDetectionResult } from "../detector.js";
 import type { LoadModuleResult, UnifiedLoaderOptions } from "./types.js";
+/** @internal Exported for unit tests (tests/node-fs-acquisition.test.ts). */
+export declare function getPreopens(): Record<string, string>;
 export declare function loadModule(wasmType: "wasi" | "emscripten", runtime: RuntimeDetectionResult, options: UnifiedLoaderOptions): Promise<LoadModuleResult>;
 //# sourceMappingURL=module-loading.d.ts.map

package/dist/src/runtime/unified-loader/module-loading.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module-loading.d.ts","sourceRoot":"","sources":["../../../../src/runtime/unified-loader/module-loading.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAG7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AA0CzE,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,GAAG,YAAY,EAC/B,OAAO,EAAE,sBAAsB,EAC/B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,gBAAgB,CAAC,CAS3B"}
+{"version":3,"file":"module-loading.d.ts","sourceRoot":"","sources":["../../../../src/runtime/unified-loader/module-loading.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAG7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAiBzE,6EAA6E;AAC7E,wBAAgB,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwBpD;AAOD,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,GAAG,YAAY,EAC/B,OAAO,EAAE,sBAAsB,EAC/B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,gBAAgB,CAAC,CAS3B"}

package/dist/src/runtime/unified-loader/module-loading.js

@@ -1,22 +1,25 @@
-import { supportsExnref } from "../detector.js";
+import { isDeno, supportsExnref } from "../detector.js";
 import { ModuleLoadError } from "./types.js";
 import { errorMessage } from "../../errors/classes.js";
 import { fileUrlToPath } from "../../utils/path.js";
+import { getNodeFsSync } from "../../utils/node-fs.js";
 function isWindows() {
-  return typeof Deno !== "undefined" ? Deno.build.os === "windows" : globalThis.process ? globalThis.process.platform === "win32" : false;
+  return isDeno() ? Deno.build.os === "windows" : globalThis.process ? globalThis.process.platform === "win32" : false;
 }
 function getPreopens() {
   if (!isWindows()) return { "/": "/" };
+  const statSync = isDeno() ? Deno.statSync : getNodeFsSync()?.statSync;
+  if (!statSync) {
+    console.warn(
+      "[taglib-wasm] Windows drive detection unavailable: node:fs could not be loaded. Only C:\\ is registered as a WASI preopen."
+    );
+    return { "/C": "C:\\" };
+  }
   const preopens = {};
   for (const letter of "CDEFGHIJKLMNOPQRSTUVWXYZAB") {
     const root = `${letter}:\\`;
     try {
-      if (typeof Deno !== "undefined") {
-        Deno.statSync(root);
-      } else {
-        const fs = new Function("return require('node:fs')")();
-        fs.statSync(root);
-      }
+      statSync(root);
       preopens[`/${letter}`] = root;
     } catch {
     }
@@ -47,6 +50,13 @@ async function loadWasiModuleWithFallback(runtime, options) {
     });
     return { module: wasiModule, actualWasmType: "wasi" };
   } catch (hostError) {
+    if (options.forceWasmType === "wasi") {
+      throw new ModuleLoadError(
+        `WASI backend failed to load: ${errorMessage(hostError)}. forceWasmType is "wasi", so the Emscripten fallback was not attempted`,
+        "wasi",
+        hostError
+      );
+    }
     if (runtime.environment === "node-wasi" && !supportsExnref()) {
       const g = globalThis;
       const nodeVersion = g.process?.versions?.node ?? "";
@@ -107,5 +117,6 @@ async function loadEmscriptenModule(options) {
   }
 }
 export {
+  getPreopens,
   loadModule
 };

package/dist/src/runtime/unified-loader/module-selection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module-selection.d.ts","sourceRoot":"","sources":["../../../../src/runtime/unified-loader/module-selection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,wBAAgB,cAAc,CAC5B,OAAO,EAAE,sBAAsB,EAC/B,OAAO,EAAE,oBAAoB,GAC5B,MAAM,GAAG,YAAY,CAcvB;AAED,wBAAgB,eAAe,IAAI,OAAO,CAGzC;AAED,wBAAgB,oBAAoB,IAAI,oBAAoB,CAoB3D"}
+{"version":3,"file":"module-selection.d.ts","sourceRoot":"","sources":["../../../../src/runtime/unified-loader/module-selection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,wBAAgB,cAAc,CAC5B,OAAO,EAAE,sBAAsB,EAC/B,OAAO,EAAE,oBAAoB,GAC5B,MAAM,GAAG,YAAY,CAqBvB;AAED,wBAAgB,eAAe,IAAI,OAAO,CAGzC;AAED,wBAAgB,oBAAoB,IAAI,oBAAoB,CAoB3D"}

package/dist/src/runtime/unified-loader/module-selection.js

@@ -3,6 +3,9 @@ function selectWasmType(runtime, options) {
   if (options.forceWasmType) {
     return options.forceWasmType;
   }
+  if (options.wasmBinary) {
+    return "emscripten";
+  }
   if (options.disableOptimizations) {
     return "emscripten";
   }

package/dist/src/runtime/unified-loader/types.d.ts

@@ -14,7 +14,10 @@ export interface UnifiedLoaderOptions {
     forceWasmType?: "wasi" | "emscripten";
     /** Disable optimizations for debugging */
     disableOptimizations?: boolean;
-    /** Custom WASM binary path or data */
+    /**
+     * Pre-loaded Wasm binary (Emscripten backend only; auto mode selects
+     * Emscripten when set, and forcing "wasi" with it throws — use wasmUrl).
+     */
     wasmBinary?: ArrayBuffer | Uint8Array;
     /** Custom WASM URL */
     wasmUrl?: string;

package/dist/src/runtime/unified-loader/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/runtime/unified-loader/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,qBAAa,kBAAmB,SAAQ,WAAW;gBACrC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAM7C;AAED,qBAAa,eAAgB,SAAQ,WAAW;aAG5B,QAAQ,EAAE,MAAM,GAAG,YAAY;gBAD/C,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,GAAG,YAAY,EAC/C,KAAK,CAAC,EAAE,OAAO;CAOlB;AAED,MAAM,WAAW,oBAAoB;IACnC,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IACtC,0CAA0C;IAC1C,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,sCAAsC;IACtC,UAAU,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC;IACtC,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,+BAA+B;IAC/B,OAAO,EAAE,sBAAsB,CAAC;IAChC,wCAAwC;IACxC,MAAM,EAAE,OAAO,CAAC;IAChB,8CAA8C;IAC9C,YAAY,EAAE,OAAO,CAAC;IACtB,8BAA8B;IAC9B,qBAAqB,CAAC,EAAE,MAAM,kBAAkB,CAAC;CAClD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,YAAY,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,YAAY,GAAG,UAAU,CAAC;IAClC,cAAc,EAAE,MAAM,GAAG,YAAY,CAAC;CACvC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/runtime/unified-loader/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,qBAAa,kBAAmB,SAAQ,WAAW;gBACrC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAM7C;AAED,qBAAa,eAAgB,SAAQ,WAAW;aAG5B,QAAQ,EAAE,MAAM,GAAG,YAAY;gBAD/C,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,GAAG,YAAY,EAC/C,KAAK,CAAC,EAAE,OAAO;CAOlB;AAED,MAAM,WAAW,oBAAoB;IACnC,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IACtC,0CAA0C;IAC1C,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;OAGG;IACH,UAAU,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC;IACtC,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,+BAA+B;IAC/B,OAAO,EAAE,sBAAsB,CAAC;IAChC,wCAAwC;IACxC,MAAM,EAAE,OAAO,CAAC;IAChB,8CAA8C;IAC9C,YAAY,EAAE,OAAO,CAAC;IACtB,8BAA8B;IAC9B,qBAAqB,CAAC,EAAE,MAAM,kBAAkB,CAAC;CAClD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,YAAY,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,YAAY,GAAG,UAAU,CAAC;IAClC,cAAc,EAAE,MAAM,GAAG,YAAY,CAAC;CACvC"}

package/dist/src/runtime/wasi-adapter/file-handle.d.ts

@@ -1,7 +1,7 @@
 /**
  * @fileoverview WASI-based FileHandle implementation
  */
-import type { FileHandle, RawChapter, RawLyrics, RawPicture } from "../../wasm.js";
+import type { FileHandle, RawChapter, RawId3v2Frame, RawLyrics, RawPicture } from "../../wasm.js";
 import type { BasicTagData } from "../../types/tags.js";
 import type { AudioProperties } from "../../types.js";
 import type { WasiModule } from "../wasmer-sdk-loader/types.js";
@@ -61,6 +61,10 @@ export declare class WasiFileHandle implements FileHandle {
     }[]): void;
     getLyrics(): RawLyrics[];
     setLyrics(lyrics: RawLyrics[]): void;
+    getId3v2Frames(id: string): RawId3v2Frame[];
+    setId3v2Frames(id: string, data: Uint8Array[]): void;
+    removeId3v2Frames(id: string): void;
+    getStagedId3v2Frames(): Record<string, Uint8Array[]> | undefined;
     destroy(): void;
 }
 //# sourceMappingURL=file-handle.d.ts.map

package/dist/src/runtime/wasi-adapter/file-handle.d.ts.map

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

package/dist/src/runtime/wasi-adapter/file-handle.js

@@ -5,6 +5,7 @@ import { WasmerExecutionError } from "../wasmer-sdk-loader/types.js";
 import { decodeTagData } from "../../msgpack/decoder.js";
 import { fromTagLibKey, toTagLibKey } from "../../constants/properties.js";
 import {
+  readId3v2FramesFromWasm,
   readTagsFromWasm,
   readTagsFromWasmPath,
   writeTagsToWasm,
@@ -398,6 +399,39 @@ class WasiFileHandle {
     this.checkNotDestroyed();
     this.tagData = { ...this.tagData, lyrics };
   }
+  getId3v2Frames(id) {
+    this.checkNotDestroyed();
+    const filter = id === "" ? void 0 : id;
+    const source = this.filePath ?? this.fileData;
+    let frames = [];
+    if (source) {
+      frames = readId3v2FramesFromWasm(this.wasi, source, filter);
+    }
+    const staged = this.getStagedId3v2Frames();
+    if (!staged) return frames;
+    const stagedIds = new Set(Object.keys(staged));
+    frames = frames.filter((f) => !stagedIds.has(f.id));
+    for (const [sid, bodies] of Object.entries(staged)) {
+      if (filter && sid !== filter) continue;
+      for (const data of bodies) frames.push({ id: sid, data: data.slice() });
+    }
+    return frames;
+  }
+  setId3v2Frames(id, data) {
+    this.checkNotDestroyed();
+    const staged = { ...this.getStagedId3v2Frames() ?? {} };
+    staged[id] = data.map((d) => new Uint8Array(d));
+    this.tagData = {
+      ...this.tagData,
+      id3v2Frames: staged
+    };
+  }
+  removeId3v2Frames(id) {
+    this.setId3v2Frames(id, []);
+  }
+  getStagedId3v2Frames() {
+    return this.tagData?.id3v2Frames;
+  }
   destroy() {
     this.fileData = null;
     this.tagData = null;