taglib-wasm 1.5.0 → 1.5.1

package/README.md

@@ -210,8 +210,9 @@ console.log(
   } files`,
 );
 
-// Process results
+// Process results (narrow the ok/error union first)
 for (const file of result.items) {
+  if (file.status !== "ok") continue;
   console.log(
     `${file.path}: ${file.tags.artist?.[0]} - ${file.tags.title?.[0]}`,
   );
@@ -333,6 +334,7 @@ using file = await taglib.open("song.mp3");
 
 // Escape hatch: read/write raw ID3v2 frame bytes by ID (MP3 only)
 const frames = file.getId3v2Frames("TXXX"); // [{ id, data, flags? }]
+const rgadBody = new Uint8Array([/* raw frame body bytes */]);
 file.setId3v2Frames("RGAD", [rgadBody]); // replaces ALL RGAD frames
 file.removeId3v2Frames("NCON"); // removes every NCON frame
 file.save();

package/dist/index.browser.js

@@ -314,6 +314,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}`;
 }
@@ -638,6 +641,116 @@ 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;
+}
+function popm(value) {
+  return value;
+}
+function toNormalized(value) {
+  return value / 255;
+}
+function fromNormalized(value) {
+  return Math.round(value * 255);
+}
+function toStars(value, maxStars = 5) {
+  return Math.round(value * maxStars);
+}
+function fromStars(stars, maxStars = 5) {
+  return stars / maxStars;
+}
+function toPopm(value) {
+  const stars = Math.round(value * 5);
+  return POPM_STAR_VALUES[stars] ?? 0;
+}
+function fromPopm(value) {
+  if (value === 0) return 0;
+  if (value <= 1) return 0.2;
+  if (value <= 64) return 0.4;
+  if (value <= 128) return 0.6;
+  if (value <= 196) return 0.8;
+  return 1;
+}
+function toPercent(value) {
+  return value * 100;
+}
+function fromPercent(percent) {
+  return percent / 100;
+}
+function clamp(rating) {
+  return Math.max(0, Math.min(1, rating));
+}
+function isValid(rating) {
+  return typeof rating === "number" && !Number.isNaN(rating) && rating >= 0 && rating <= 1;
+}
+var POPM_STAR_VALUES, RatingUtils;
+var init_rating = __esm({
+  "src/utils/rating.ts"() {
+    "use strict";
+    POPM_STAR_VALUES = [0, 1, 64, 128, 196, 255];
+    RatingUtils = {
+      normalized,
+      popm,
+      toNormalized,
+      fromNormalized,
+      toStars,
+      fromStars,
+      toPopm,
+      fromPopm,
+      toPercent,
+      fromPercent,
+      clamp,
+      isValid,
+      POPM_STAR_VALUES
+    };
+  }
+});
+
+// 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({
@@ -1881,18 +1994,16 @@ 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";
@@ -1901,6 +2012,9 @@ var init_audio_file_impl = __esm({
     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 {
@@ -1923,6 +2037,7 @@ var init_audio_file_impl = __esm({
           );
         }
         this.cachedAudioProperties = null;
+        this.pathModeBuffer = null;
         return this.handle.save();
       }
       getFileBuffer() {
@@ -1933,11 +2048,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;
@@ -1978,6 +2102,7 @@ var init_audio_file_impl = __esm({
             await writeFileData(targetPath, buffer);
           }
         }
+        this.pathModeBuffer = null;
       }
       getPictures() {
         const picturesArray = this.handle.getPictures();
@@ -2089,7 +2214,7 @@ 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 }]);
@@ -2294,7 +2419,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = "1.5.0";
+    VERSION = "1.5.1";
   }
 });
 
@@ -2353,8 +2478,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;
     }
@@ -2377,6 +2502,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();
@@ -3239,68 +3365,7 @@ async function createPictureGallery(file, container, options = {}) {
 
 // index.browser.ts
 init_types2();
-
-// src/utils/rating.ts
-function normalized(value) {
-  return value;
-}
-function popm(value) {
-  return value;
-}
-function toNormalized(value) {
-  return value / 255;
-}
-function fromNormalized(value) {
-  return Math.round(value * 255);
-}
-function toStars(value, maxStars = 5) {
-  return Math.round(value * maxStars);
-}
-function fromStars(stars, maxStars = 5) {
-  return stars / maxStars;
-}
-var POPM_STAR_VALUES = [0, 1, 64, 128, 196, 255];
-function toPopm(value) {
-  const stars = Math.round(value * 5);
-  return POPM_STAR_VALUES[stars] ?? 0;
-}
-function fromPopm(value) {
-  if (value === 0) return 0;
-  if (value <= 1) return 0.2;
-  if (value <= 64) return 0.4;
-  if (value <= 128) return 0.6;
-  if (value <= 196) return 0.8;
-  return 1;
-}
-function toPercent(value) {
-  return value * 100;
-}
-function fromPercent(percent) {
-  return percent / 100;
-}
-function clamp(rating) {
-  return Math.max(0, Math.min(1, rating));
-}
-function isValid(rating) {
-  return typeof rating === "number" && !Number.isNaN(rating) && rating >= 0 && rating <= 1;
-}
-var RatingUtils = {
-  normalized,
-  popm,
-  toNormalized,
-  fromNormalized,
-  toStars,
-  fromStars,
-  toPopm,
-  fromPopm,
-  toPercent,
-  fromPercent,
-  clamp,
-  isValid,
-  POPM_STAR_VALUES
-};
-
-// index.browser.ts
+init_rating();
 init_module_loader_browser();
 export {
   AudioFileImpl,

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}`;
 }
@@ -626,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({
@@ -1869,18 +1926,16 @@ 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";
@@ -1889,6 +1944,9 @@ var init_audio_file_impl = __esm({
     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 {
@@ -1911,6 +1969,7 @@ var init_audio_file_impl = __esm({
           );
         }
         this.cachedAudioProperties = null;
+        this.pathModeBuffer = null;
         return this.handle.save();
       }
       getFileBuffer() {
@@ -1921,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;
@@ -1966,6 +2034,7 @@ var init_audio_file_impl = __esm({
             await writeFileData(targetPath, buffer);
           }
         }
+        this.pathModeBuffer = null;
       }
       getPictures() {
         const picturesArray = this.handle.getPictures();
@@ -2077,7 +2146,7 @@ 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 }]);
@@ -2282,7 +2351,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = "1.5.0";
+    VERSION = "1.5.1";
   }
 });
 
@@ -2340,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;
     }
@@ -2364,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/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/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 {
     }
@@ -114,5 +117,6 @@ async function loadEmscriptenModule(options) {
   }
 }
 export {
+  getPreopens,
   loadModule
 };

package/dist/src/runtime/wasi-host-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wasi-host-loader.d.ts","sourceRoot":"","sources":["../../../src/runtime/wasi-host-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,EAAE,CAAC,EAAE,kBAAkB,CAAC;CACzB;AAED,qBAAa,iBAAkB,SAAQ,WAAW;gBACpC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAM7C;AAcD,wBAAsB,YAAY,CAChC,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC,CAmDlC"}
+{"version":3,"file":"wasi-host-loader.d.ts","sourceRoot":"","sources":["../../../src/runtime/wasi-host-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIhD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,EAAE,CAAC,EAAE,kBAAkB,CAAC;CACzB;AAED,qBAAa,iBAAkB,SAAQ,WAAW;gBACpC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAM7C;AAcD,wBAAsB,YAAY,CAChC,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC,CAmDlC"}

package/dist/src/runtime/wasi-host-loader.js

@@ -3,6 +3,7 @@ import {
 } from "./wasi-host.js";
 import { TagLibError } from "../errors/base.js";
 import { fileUrlToPath } from "../utils/path.js";
+import { isDeno } from "./detector.js";
 class WasiHostLoadError extends TagLibError {
   constructor(message, cause) {
     super("WASI_HOST", message, cause ? { cause } : void 0);
@@ -13,7 +14,7 @@ class WasiHostLoadError extends TagLibError {
 }
 async function resolveFs(provided) {
   if (provided) return provided;
-  if (typeof Deno !== "undefined") {
+  if (isDeno()) {
     const { createDenoFsProvider } = await import("./wasi-fs-deno.js");
     return createDenoFsProvider();
   }

package/dist/src/taglib/audio-file-impl.d.ts

@@ -3,8 +3,11 @@ import type { OpenOptions, Picture } from "../types.js";
 import type { Chapter, SetChaptersOptions } from "../types/chapters.js";
 import type { BroadcastAudioExtension } from "../types/bwf.js";
 import type { Id3v2Frame, Rating, UnsyncedLyrics } from "../constants/complex-properties.js";
+import { type NormalizedRating } from "../utils/rating.js";
 import type { AudioFile } from "./audio-file-interface.js";
 import { BaseAudioFileImpl } from "./audio-file-base.js";
+/** @internal Exported for unit tests (tests/node-fs-acquisition.test.ts). */
+export declare function readFileSync(path: string): Uint8Array;
 /**
  * Implementation of AudioFile interface using Embind API.
  *
@@ -33,7 +36,7 @@ export declare class AudioFileImpl extends BaseAudioFileImpl implements AudioFil
     setRatings(ratings: Rating[]): void;
     getLyrics(): UnsyncedLyrics[];
     setLyrics(lyrics: UnsyncedLyrics[]): void;
-    getRating(): number | undefined;
+    getRating(): NormalizedRating | undefined;
     setRating(rating: number, email?: string): void;
     getId3v2Frames(id?: string): Id3v2Frame[];
     setId3v2Frames(id: string, data: Uint8Array[]): void;

package/dist/src/taglib/audio-file-impl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audio-file-impl.d.ts","sourceRoot":"","sources":["../../../src/taglib/audio-file-impl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EAGV,YAAY,EACb,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE/D,OAAO,KAAK,EACV,UAAU,EACV,MAAM,EACN,cAAc,EACf,MAAM,oCAAoC,CAAC;AAS5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAqCzD;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,iBAAkB,YAAW,SAAS;IACvE,OAAO,CAAC,cAAc,CAA2B;gBAG/C,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,UAAU,EACtB,UAAU,CAAC,EAAE,MAAM,EACnB,cAAc,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,IAAI,EACzD,iBAAiB,GAAE,OAAe,EAClC,kBAAkB,CAAC,EAAE,WAAW;IAYlC,IAAI,IAAI,OAAO;IAYf,aAAa,IAAI,UAAU;IAgBrB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyD9C,WAAW,IAAI,OAAO,EAAE;IAUxB,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI;IAStC,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IASlC,cAAc,IAAI,IAAI;IAItB,WAAW,IAAI,OAAO,EAAE;IAYxB,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI;IAuBpE,OAAO,IAAI,uBAAuB,GAAG,SAAS;IAI9C,OAAO,CAAC,IAAI,EAAE,uBAAuB,GAAG,IAAI;IAI5C,WAAW,IAAI,UAAU,GAAG,SAAS;IAIrC,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI;IAI1C,OAAO,IAAI,MAAM,GAAG,SAAS;IAI7B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIlC,UAAU,IAAI,MAAM,EAAE;IAUtB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;IAQnC,SAAS,IAAI,cAAc,EAAE;IAS7B,SAAS,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI;IAQzC,SAAS,IAAI,MAAM,GAAG,SAAS;IAK/B,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAI/C,cAAc,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE;IAMzC,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,IAAI;IAOpD,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAMnC,UAAU,IAAI;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,EAAE,EAAE,OAAO,CAAA;KAAE;IAI1C,YAAY,CAAC,IAAI,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,OAAO,CAAC;QAAC,EAAE,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;CAM1D"}
+{"version":3,"file":"audio-file-impl.d.ts","sourceRoot":"","sources":["../../../src/taglib/audio-file-impl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EAGV,YAAY,EACb,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE/D,OAAO,KAAK,EACV,UAAU,EACV,MAAM,EACN,cAAc,EACf,MAAM,oCAAoC,CAAC;AAc5C,OAAO,EAAc,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAoBzD,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CASrD;AAED;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,iBAAkB,YAAW,SAAS;IACvE,OAAO,CAAC,cAAc,CAA2B;gBAG/C,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,UAAU,EACtB,UAAU,CAAC,EAAE,MAAM,EACnB,cAAc,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,IAAI,EACzD,iBAAiB,GAAE,OAAe,EAClC,kBAAkB,CAAC,EAAE,WAAW;IAYlC,IAAI,IAAI,OAAO;IAef,aAAa,IAAI,UAAU;IA2BrB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4D9C,WAAW,IAAI,OAAO,EAAE;IAUxB,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI;IAStC,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IASlC,cAAc,IAAI,IAAI;IAItB,WAAW,IAAI,OAAO,EAAE;IAYxB,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI;IAuBpE,OAAO,IAAI,uBAAuB,GAAG,SAAS;IAI9C,OAAO,CAAC,IAAI,EAAE,uBAAuB,GAAG,IAAI;IAI5C,WAAW,IAAI,UAAU,GAAG,SAAS;IAIrC,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI;IAI1C,OAAO,IAAI,MAAM,GAAG,SAAS;IAI7B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIlC,UAAU,IAAI,MAAM,EAAE;IAUtB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;IAQnC,SAAS,IAAI,cAAc,EAAE;IAS7B,SAAS,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI;IAQzC,SAAS,IAAI,gBAAgB,GAAG,SAAS;IAKzC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAI/C,cAAc,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE;IAMzC,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,IAAI;IAOpD,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAMnC,UAAU,IAAI;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,EAAE,EAAE,OAAO,CAAA;KAAE;IAI1C,YAAY,CAAC,IAAI,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,OAAO,CAAC;QAAC,EAAE,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;CAM1D"}

package/dist/src/taglib/audio-file-impl.js

@@ -9,11 +9,17 @@ import {
   assertMp3,
   toPublicFrame
 } from "./id3v2-frames.js";
-import { FileOperationError, UnsupportedFormatError } from "../errors.js";
+import {
+  errorMessage,
+  FileOperationError,
+  UnsupportedFormatError
+} from "../errors.js";
 import { writeFileData } from "../utils/write.js";
+import { getNodeFsSync } from "../utils/node-fs.js";
+import { normalized } from "../utils/rating.js";
+import { isDeno } from "../runtime/detector.js";
 import { BaseAudioFileImpl } from "./audio-file-base.js";
 import { saveViaFreshHandle } from "./save-reconstruct.js";
-let _nodeFs;
 function sortChapters(list) {
   return [...list].sort((a, b) => a.startTimeMs - b.startTimeMs);
 }
@@ -24,16 +30,14 @@ 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
+  );
 }
 class AudioFileImpl extends BaseAudioFileImpl {
   constructor(module, fileHandle, sourcePath, originalSource, isPartiallyLoaded = false, partialLoadOptions) {
@@ -55,6 +59,7 @@ class AudioFileImpl extends BaseAudioFileImpl {
       );
     }
     this.cachedAudioProperties = null;
+    this.pathModeBuffer = null;
     return this.handle.save();
   }
   getFileBuffer() {
@@ -65,11 +70,20 @@ class AudioFileImpl extends BaseAudioFileImpl {
       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;
@@ -110,6 +124,7 @@ class AudioFileImpl extends BaseAudioFileImpl {
         await writeFileData(targetPath, buffer);
       }
     }
+    this.pathModeBuffer = null;
   }
   getPictures() {
     const picturesArray = this.handle.getPictures();
@@ -221,7 +236,7 @@ class AudioFileImpl extends BaseAudioFileImpl {
   }
   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 }]);
@@ -253,5 +268,6 @@ class AudioFileImpl extends BaseAudioFileImpl {
   }
 }
 export {
-  AudioFileImpl
+  AudioFileImpl,
+  readFileSync
 };

package/dist/src/taglib/audio-file-interface.d.ts

@@ -3,6 +3,7 @@ import type { TypedAudioProperties } from "../types/audio-formats.js";
 import type { Id3v2Frame, Rating, UnsyncedLyrics } from "../constants/complex-properties.js";
 import type { MutableTag } from "./mutable-tag.js";
 import type { FormatPropertyKey } from "../types/format-property-keys.js";
+import type { NormalizedRating } from "../utils/rating.js";
 /**
  * Represents an audio file with metadata and audio properties.
  * Provides methods for reading and writing metadata, accessing audio properties,
@@ -39,7 +40,11 @@ export interface AudioFile {
     removeMP4Item(key: string): void;
     /** Save all changes to the in-memory buffer. */
     save(): boolean;
-    /** Get the current file data as a buffer, including any modifications. */
+    /**
+     * Get the current file data as a buffer, including any modifications.
+     * @throws {FileOperationError} If the data lives on disk (WASI path mode)
+     * and cannot be read back — never returns an empty buffer on failure.
+     */
     getFileBuffer(): Uint8Array;
     /**
      * Save all changes to a file on disk.
@@ -87,8 +92,8 @@ export interface AudioFile {
     getRatings(): Rating[];
     /** Set ratings in the audio file (replaces all existing). */
     setRatings(ratings: Rating[]): void;
-    /** Get the primary rating (first one found), or undefined. */
-    getRating(): number | undefined;
+    /** Get the primary rating (first one found, normalized 0.0-1.0), or undefined. */
+    getRating(): NormalizedRating | undefined;
     /** Set the primary rating (normalized 0.0-1.0). */
     setRating(rating: number, email?: string): void;
     /**

package/dist/src/taglib/audio-file-interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audio-file-interface.d.ts","sourceRoot":"","sources":["../../../src/taglib/audio-file-interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,QAAQ,EACR,OAAO,EACP,WAAW,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EACV,UAAU,EACV,MAAM,EACN,cAAc,EACf,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAE1E;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,iCAAiC;IACjC,SAAS,IAAI,QAAQ,CAAC;IAEtB,6DAA6D;IAC7D,GAAG,IAAI,UAAU,CAAC;IAElB,mEAAmE;IACnE,eAAe,IAAI,eAAe,GAAG,SAAS,CAAC;IAE/C,sDAAsD;IACtD,UAAU,IAAI,WAAW,CAAC;IAE1B,0DAA0D;IAC1D,aAAa,CAAC,UAAU,EAAE,WAAW,GAAG,IAAI,CAAC;IAE7C,0DAA0D;IAC1D,WAAW,CAAC,CAAC,SAAS,OAAO,iBAAiB,EAAE,WAAW,EACzD,GAAG,EAAE,CAAC,GACL,OAAO,iBAAiB,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAE1D,2DAA2D;IAC3D,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAE7C,mDAAmD;IACnD,WAAW,CAAC,CAAC,SAAS,OAAO,iBAAiB,EAAE,WAAW,EACzD,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,OAAO,iBAAiB,EAAE,aAAa,CAAC,CAAC,CAAC,GAChD,IAAI,CAAC;IAER,oDAAoD;IACpD,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9C,gFAAgF;IAChF,QAAQ,CAAC,CAAC,SAAS,QAAQ,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,IAAI,cAAc,CAAC,CAAC,CAAC,CAAC;IAEnE,wCAAwC;IACxC,KAAK,IAAI,OAAO,CAAC;IAEjB,yCAAyC;IACzC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAE5C,yCAAyC;IACzC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7C,4CAA4C;IAC5C,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC,gDAAgD;IAChD,IAAI,IAAI,OAAO,CAAC;IAEhB,0EAA0E;IAC1E,aAAa,IAAI,UAAU,CAAC;IAE5B;;;OAGG;IACH,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC,8DAA8D;IAC9D,OAAO,IAAI,OAAO,CAAC;IAEnB,sDAAsD;IACtD,WAAW,IAAI,OAAO,EAAE,CAAC;IAEzB,wEAAwE;IACxE,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAEvC,8CAA8C;IAC9C,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAEnC,+CAA+C;IAC/C,cAAc,IAAI,IAAI,CAAC;IAEvB;;;;OAIG;IACH,WAAW,IAAI,OAAO,sBAAsB,EAAE,OAAO,EAAE,CAAC;IAExD;;;;OAIG;IACH,WAAW,CACT,QAAQ,EAAE,OAAO,sBAAsB,EAAE,OAAO,EAAE,EAClD,OAAO,CAAC,EAAE,OAAO,sBAAsB,EAAE,kBAAkB,GAC1D,IAAI,CAAC;IAER;;;OAGG;IACH,OAAO,IACH,OAAO,iBAAiB,EAAE,uBAAuB,GACjD,SAAS,CAAC;IAEd,uFAAuF;IACvF,OAAO,CAAC,IAAI,EAAE,OAAO,iBAAiB,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAEvE,6FAA6F;IAC7F,WAAW,IAAI,UAAU,GAAG,SAAS,CAAC;IAEtC,uFAAuF;IACvF,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAAC;IAE3C,+EAA+E;IAC/E,OAAO,IAAI,MAAM,GAAG,SAAS,CAAC;IAE9B,wEAAwE;IACxE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAEnC,gEAAgE;IAChE,UAAU,IAAI,MAAM,EAAE,CAAC;IAEvB,6DAA6D;IAC7D,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAEpC,8DAA8D;IAC9D,SAAS,IAAI,MAAM,GAAG,SAAS,CAAC;IAEhC,mDAAmD;IACnD,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhD;;;;;OAKG;IACH,cAAc,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE,CAAC;IAE1C;;;;OAIG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAErD,6EAA6E;IAC7E,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpC;;;OAGG;IACH,SAAS,IAAI,cAAc,EAAE,CAAC;IAE9B,6EAA6E;IAC7E,SAAS,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;IAE1C;;;;OAIG;IACH,UAAU,IAAI;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,EAAE,EAAE,OAAO,CAAA;KAAE,CAAC;IAE3C;;;OAGG;IACH,YAAY,CAAC,IAAI,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,OAAO,CAAC;QAAC,EAAE,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAE1D,uDAAuD;IACvD,OAAO,IAAI,IAAI,CAAC;IAEhB,uDAAuD;IACvD,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,QAAQ,CAChD,SAAQ,IAAI,CAAC,SAAS,EAAE,aAAa,GAAG,aAAa,GAAG,iBAAiB,CAAC;IAC1E,SAAS,IAAI,CAAC,CAAC;IAEf,eAAe,IAAI,oBAAoB,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAEvD,WAAW,CAAC,CAAC,SAAS,iBAAiB,CAAC,CAAC,CAAC,EACxC,GAAG,EAAE,CAAC,GACL,OAAO,iBAAiB,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAE1D,WAAW,CAAC,CAAC,SAAS,iBAAiB,CAAC,CAAC,CAAC,EACxC,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,OAAO,iBAAiB,EAAE,aAAa,CAAC,CAAC,CAAC,GAChD,IAAI,CAAC;CACT"}
+{"version":3,"file":"audio-file-interface.d.ts","sourceRoot":"","sources":["../../../src/taglib/audio-file-interface.ts"],"names":[],"mappings":"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"}

package/dist/src/taglib/taglib-class.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"taglib-class.d.ts","sourceRoot":"","sources":["../../../src/taglib/taglib-class.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA4B,UAAU,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AA4C3D;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,MAAM,EAAE,UAAU;IAI9B;;;;;OAKG;WACU,UAAU,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAMrE;;;;;;;OAOG;IACG,IAAI,CACR,KAAK,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,SAAS,CAAC;IAiGrB;;;;;;;;;OASG;IACG,IAAI,CACR,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAC5C,OAAO,CAAC,IAAI,CAAC;IACV,IAAI,CACR,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI,GAAG,eAAe,EACxD,EAAE,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAC5C,OAAO,CAAC,UAAU,CAAC;IAmBtB;;;;;;OAMG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAUtE;;;;;;;OAOG;IACG,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,GACtB,OAAO,CAAC,IAAI,CAAC;IAUhB,oEAAoE;IACpE,OAAO,IAAI,MAAM;IAIjB,OAAO,CAAC,aAAa;CAStB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAEtE"}
+{"version":3,"file":"taglib-class.d.ts","sourceRoot":"","sources":["../../../src/taglib/taglib-class.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA4B,UAAU,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AA4C3D;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,MAAM,EAAE,UAAU;IAI9B;;;;;OAKG;WACU,UAAU,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAMrE;;;;;;;OAOG;IACG,IAAI,CACR,KAAK,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,SAAS,CAAC;IAiGrB;;;;;;;;;OASG;IACG,IAAI,CACR,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAC5C,OAAO,CAAC,IAAI,CAAC;IACV,IAAI,CACR,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI,GAAG,eAAe,EACxD,EAAE,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAC5C,OAAO,CAAC,UAAU,CAAC;IAmBtB;;;;;;OAMG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAUtE;;;;;;;OAOG;IACG,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,GACtB,OAAO,CAAC,IAAI,CAAC;IAUhB,oEAAoE;IACpE,OAAO,IAAI,MAAM;IAIjB,OAAO,CAAC,aAAa;CAStB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAEtE"}

package/dist/src/taglib/taglib-class.js

@@ -5,6 +5,7 @@ import {
   isNamedAudioInput
 } from "../types/audio-formats.js";
 import { InvalidFormatError, TagLibInitializationError } from "../errors.js";
+import { isDeno } from "../runtime/detector.js";
 import { AudioFileImpl } from "./audio-file-impl.js";
 import { loadAudioData } from "./load-audio-data.js";
 import { mergeTagUpdates } from "../utils/tag-mapping.js";
@@ -21,7 +22,7 @@ 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 cwd = isDeno() ? Deno.cwd() : g.process?.cwd?.();
     if (cwd) {
       p = cwd.replace(/[/\\]+$/, "") + "/" + p;
     }

package/dist/src/utils/node-fs.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Synchronous node:fs acquisition that works in every module context
+ * (ESM and CJS), including Electron main processes. See taglib-0b5 / GH #24.
+ */
+/** Structural subset of node:fs used by taglib-wasm's sync call sites. */
+export type NodeFsLike = {
+    statSync(path: string): unknown;
+    readFileSync(path: string): Uint8Array;
+};
+/**
+ * Acquire node:fs synchronously without tripping bundlers.
+ *
+ * `process.getBuiltinModule("node:fs")` is the primary strategy: it is
+ * synchronous, works in both ESM and CJS, and exists on every supported
+ * runtime (added in Node 22.3.0, backported to 20.16.0; the package's
+ * `engines` floor of node >= 22.6.0 gates installs, while Electron's
+ * embedded Node has shipped it since Electron 32). The legacy
+ * `new Function("return require(...)")` hack evaluates in the GLOBAL scope,
+ * where `require` never exists in standard module files — it is kept only as
+ * a fallback for contexts that expose `require` globally (Electron renderers
+ * with nodeIntegration, node -e, the REPL) on runtimes predating
+ * getBuiltinModule. Results are shape-checked so a polyfilled `process`
+ * serving junk modules escalates to the next strategy instead of leaking a
+ * non-fs object to callers.
+ */
+export declare function getNodeFsSync(): NodeFsLike | null;
+//# sourceMappingURL=node-fs.d.ts.map

package/dist/src/utils/node-fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-fs.d.ts","sourceRoot":"","sources":["../../../src/utils/node-fs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,0EAA0E;AAC1E,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;CACxC,CAAC;AAYF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,IAAI,UAAU,GAAG,IAAI,CAiBjD"}

package/dist/src/utils/node-fs.js

@@ -0,0 +1,21 @@
+function hasFsShape(fs) {
+  const candidate = fs;
+  return typeof candidate?.statSync === "function" && typeof candidate?.readFileSync === "function";
+}
+function getNodeFsSync() {
+  const proc = globalThis.process;
+  try {
+    const fs = proc?.getBuiltinModule?.("node:fs");
+    if (hasFsShape(fs)) return fs;
+  } catch {
+  }
+  try {
+    const fs = new Function("return require('node:fs')")();
+    if (hasFsShape(fs)) return fs;
+  } catch {
+  }
+  return null;
+}
+export {
+  getNodeFsSync
+};

package/dist/src/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.5.0";
+export declare const VERSION = "1.5.1";
 //# sourceMappingURL=version.d.ts.map

package/dist/src/version.js

@@ -1,4 +1,4 @@
-const VERSION = "1.5.0";
+const VERSION = "1.5.1";
 export {
   VERSION
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taglib-wasm",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "description": "TagLib-Wasm is the universal tagging library for TypeScript/JavaScript platforms: Browsers, Node.js, Deno, Bun, Cloudflare Workers, and Electron apps",
   "type": "module",
   "main": "dist/index.js",