taglib-wasm 2.2.2 → 2.3.0

package/dist/src/runtime/wasi-adapter/path-open.js

@@ -0,0 +1,76 @@
+import {
+  FileOperationError,
+  InvalidFormatError
+} from "../../errors/classes.js";
+import { getFileSize, readPartialFileData } from "../../utils/file.js";
+import { readTagsFromWasm } from "./wasm-io.js";
+const TL_FORMAT_AUTO = 0;
+const HEADER_WINDOW = 4096;
+async function openAudioPath(backend, wasiPath, displayPath) {
+  const hostPath = backend.hostModule.hostPathFor(wasiPath);
+  if (hostPath === void 0) {
+    throw new FileOperationError(
+      "read",
+      "The path is outside the WASI preopens this host was created with",
+      displayPath
+    );
+  }
+  if (await getFileSize(hostPath) === 0) {
+    throw new InvalidFormatError(
+      `The file is empty. Path: ${displayPath}`
+    );
+  }
+  const handle = backend.createFileHandle();
+  try {
+    const loaded = handle.loadFromPath(wasiPath);
+    if (!loaded) {
+      throw new InvalidFormatError(
+        `Failed to load audio file. Path: ${displayPath}`
+      );
+    }
+    if (!await holdsAudio(backend, wasiPath, handle)) {
+      throw new InvalidFormatError(
+        `Failed to load audio file. File may be corrupted or in an unsupported format. Path: ${displayPath}`
+      );
+    }
+    return handle;
+  } catch (error) {
+    handle.destroy();
+    throw error;
+  }
+}
+async function holdsAudio(backend, wasiPath, handle) {
+  return statesAudioProperties(handle) || await hasRecognizableHead(backend, wasiPath);
+}
+function statesAudioProperties(handle) {
+  const audio = handle.getAudioProperties();
+  return audio !== null && (audio.sampleRate > 0 || audio.channels > 0 || audio.bitrate > 0 || audio.duration > 0 || audio.bitsPerSample > 0);
+}
+async function hasRecognizableHead(backend, wasiPath) {
+  const wasi = backend.hostModule;
+  const hostPath = wasi.hostPathFor(wasiPath);
+  if (hostPath === void 0) return false;
+  const head = await readPartialFileData(hostPath, HEADER_WINDOW, 0);
+  return detectsFormat(wasi, head) || opensAsBuffer(wasi, head);
+}
+function detectsFormat(wasi, head) {
+  const ptr = wasi.malloc(Math.max(head.length, 1));
+  try {
+    new Uint8Array(wasi.memory.buffer).set(head, ptr);
+    return wasi.tl_detect_format(ptr, head.length) !== TL_FORMAT_AUTO;
+  } finally {
+    wasi.free(ptr);
+  }
+}
+function opensAsBuffer(wasi, head) {
+  try {
+    readTagsFromWasm(wasi, head);
+    return true;
+  } catch (error) {
+    if (error instanceof InvalidFormatError) return false;
+    throw error;
+  }
+}
+export {
+  openAudioPath
+};

package/dist/src/runtime/wasi-adapter/wasm-io.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wasm-io.d.ts","sourceRoot":"","sources":["../../../../src/runtime/wasi-adapter/wasm-io.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAYhE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAKnD,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,UAAU,GACjB,UAAU,CAoCZ;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,GACX,UAAU,CA8BZ;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,UAAU,GAAG,MAAM,EAC3B,EAAE,CAAC,EAAE,MAAM,GACV,aAAa,EAAE,CA8CjB;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,WAAW,GACnB,OAAO,CA2BT;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,UAAU,EACpB,OAAO,EAAE,WAAW,GACnB,UAAU,GAAG,IAAI,CA8BnB"}
+{"version":3,"file":"wasm-io.d.ts","sourceRoot":"","sources":["../../../../src/runtime/wasi-adapter/wasm-io.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAahE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAyDnD,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,UAAU,GACjB,UAAU,CA2BZ;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,GACX,UAAU,CAqBZ;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,UAAU,GAAG,MAAM,EAC3B,EAAE,CAAC,EAAE,MAAM,GACV,aAAa,EAAE,CA0CjB;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,WAAW,GACnB,OAAO,CA0BT;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,UAAU,EACpB,OAAO,EAAE,WAAW,GACnB,UAAU,GAAG,IAAI,CA8BnB"}

package/dist/src/runtime/wasi-adapter/wasm-io.js

@@ -48,13 +48,38 @@ import {
   WasmMemoryError
 } from "../wasi-memory.js";
 import {
+  FileOperationError,
   InvalidFormatError,
   UnsupportedFormatError
 } from "../../errors/classes.js";
 import { encodeTagData } from "../../msgpack/encoder.js";
 import { decodeMessagePack } from "../../msgpack/decoder.js";
+const TL_ERROR_INVALID_INPUT = -1;
 const TL_ERROR_UNSUPPORTED_FORMAT = -2;
+const TL_ERROR_MEMORY_ALLOCATION = -3;
+const TL_ERROR_IO_READ = -4;
+const TL_ERROR_IO_WRITE = -5;
 const TL_ERROR_PARSE_FAILED = -6;
+function throwForErrorCode(errorCode, operation, where, bufferSize) {
+  switch (errorCode) {
+    case TL_ERROR_INVALID_INPUT:
+    case TL_ERROR_UNSUPPORTED_FORMAT:
+    case TL_ERROR_IO_READ:
+    case TL_ERROR_PARSE_FAILED:
+      throw new InvalidFormatError(
+        `File may be corrupted or in an unsupported format${where}`,
+        bufferSize
+      );
+    case TL_ERROR_IO_WRITE:
+      throw new FileOperationError("write", `Failed to write tags${where}`);
+    default:
+      throw new WasmMemoryError(
+        `error code ${errorCode}${where}`,
+        operation,
+        errorCode
+      );
+  }
+}
 function readTagsFromWasm(wasi, buffer) {
   var _stack = [];
   try {
@@ -68,17 +93,11 @@ function readTagsFromWasm(wasi, buffer) {
       outSizePtr.ptr
     );
     if (resultPtr === 0) {
-      const errorCode = wasi.tl_get_last_error_code();
-      if (errorCode === TL_ERROR_UNSUPPORTED_FORMAT || errorCode === TL_ERROR_PARSE_FAILED) {
-        throw new InvalidFormatError(
-          "File may be corrupted or in an unsupported format",
-          buffer.length
-        );
-      }
-      throw new WasmMemoryError(
-        `error code ${errorCode}. Buffer size: ${buffer.length} bytes`,
+      throwForErrorCode(
+        wasi.tl_get_last_error_code(),
         "read tags",
-        errorCode
+        `. Buffer size: ${buffer.length} bytes`,
+        buffer.length
       );
     }
     const outSize = outSizePtr.readUint32();
@@ -100,16 +119,10 @@ function readTagsFromWasmPath(wasi, path) {
     const outSizePtr = arena.allocUint32();
     const resultPtr = wasi.tl_read_tags(pathAlloc.ptr, 0, 0, outSizePtr.ptr);
     if (resultPtr === 0) {
-      const errorCode = wasi.tl_get_last_error_code();
-      if (errorCode === TL_ERROR_UNSUPPORTED_FORMAT || errorCode === TL_ERROR_PARSE_FAILED) {
-        throw new InvalidFormatError(
-          `File may be corrupted or in an unsupported format. Path: ${path}`
-        );
-      }
-      throw new WasmMemoryError(
-        `error code ${errorCode}. Path: ${path}`,
+      throwForErrorCode(
+        wasi.tl_get_last_error_code(),
         "read tags from path",
-        errorCode
+        `. Path: ${path}`
       );
     }
     const outSize = outSizePtr.readUint32();
@@ -156,11 +169,7 @@ function readId3v2FramesFromWasm(wasi, source, id) {
           operation: "readId3v2Frames"
         });
       }
-      throw new WasmMemoryError(
-        `error code ${errorCode}`,
-        "read ID3v2 frames",
-        errorCode
-      );
+      throwForErrorCode(errorCode, "read ID3v2 frames", "");
     }
     const outSize = outSizePtr.readUint32();
     const u8 = new Uint8Array(wasi.memory.buffer);
@@ -191,11 +200,10 @@ function writeTagsToWasmPath(wasi, path, tagData) {
       outSizePtr.ptr
     );
     if (result !== 0) {
-      const errorCode = wasi.tl_get_last_error_code();
-      throw new WasmMemoryError(
-        `error code ${errorCode}. Path: ${path}`,
+      throwForErrorCode(
+        wasi.tl_get_last_error_code(),
         "write tags to path",
-        errorCode
+        `. Path: ${path}`
       );
     }
     return true;

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

@@ -2,7 +2,7 @@ import {
   createWasiImports
 } from "./wasi-host.js";
 import { TagLibError } from "../errors/base.js";
-import { fileUrlToPath } from "../utils/path.js";
+import { fileUrlToPath, hostPathForPreopens } from "../utils/path.js";
 import { isDeno } from "./detector.js";
 class WasiHostLoadError extends TagLibError {
   constructor(message, cause) {
@@ -55,7 +55,7 @@ async function loadWasiHost(config) {
   if (instance.exports._initialize) {
     instance.exports._initialize();
   }
-  return createWasiModuleFromInstance(instance, memory, wasiImports);
+  return createWasiModuleFromInstance(instance, memory, wasiImports, preopens);
 }
 async function loadWasmBinary(path, fs) {
   if (path.startsWith("http://") || path.startsWith("https://")) {
@@ -76,7 +76,7 @@ async function loadWasmBinary(path, fs) {
     );
   }
 }
-function createWasiModuleFromInstance(instance, memory, wasiImports) {
+function createWasiModuleFromInstance(instance, memory, wasiImports, preopens) {
   const exports = instance.exports;
   function readCString(ptr) {
     if (!ptr) return "";
@@ -96,6 +96,11 @@ function createWasiModuleFromInstance(instance, memory, wasiImports) {
     tl_read_tags: (pathPtr, bufPtr, len, outSizePtr) => exports.tl_read_tags(pathPtr, bufPtr, len, outSizePtr),
     tl_read_id3v2_frames: (pathPtr, bufPtr, len, idPtr, outSizePtr) => exports.tl_read_id3v2_frames(pathPtr, bufPtr, len, idPtr, outSizePtr),
     tl_write_tags: (pathPtr, bufPtr, len, tagsPtr, tagsSz, outPtr, outSzPtr) => exports.tl_write_tags(pathPtr, bufPtr, len, tagsPtr, tagsSz, outPtr, outSzPtr),
+    tl_detect_format: (bufPtr, len) => exports.tl_detect_format(
+      bufPtr,
+      len
+    ),
+    hostPathFor: (wasiPath) => hostPathForPreopens(wasiPath, preopens),
     tl_get_last_error: () => exports.tl_get_last_error(),
     tl_get_last_error_code: () => exports.tl_get_last_error_code(),
     tl_clear_error: () => exports.tl_clear_error(),

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

@@ -16,6 +16,19 @@ export interface WasiModule {
     tl_read_tags(pathPtr: number, bufPtr: number, len: number, outSizePtr: number): number;
     tl_read_id3v2_frames(pathPtr: number, bufPtr: number, len: number, idPtr: number, outSizePtr: number): number;
     tl_write_tags(pathPtr: number, bufPtr: number, len: number, tagsPtr: number, tagsSize: number, outBufPtr: number, outSizePtr: number): number;
+    /**
+     * The boundary's content detector (`src/capi/taglib_boundary.c`), the one the
+     * buffer open runs before it picks a file class: a `tl_format` value, or
+     * `TL_FORMAT_AUTO` (0) when the bytes are not a container it knows.
+     */
+    tl_detect_format(bufPtr: number, len: number): number;
+    /**
+     * The host path behind a WASI path, resolved through the preopens this host
+     * was created with, or undefined when no preopen covers it. Host-side code
+     * cannot otherwise read a file the guest reads (`utils/path.ts` carries the
+     * rule); the path content gate is the only caller.
+     */
+    hostPathFor(wasiPath: string): string | undefined;
     tl_get_last_error(): number;
     tl_get_last_error_code(): number;
     tl_clear_error(): void;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/runtime/wasmer-sdk-loader/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,qBAAa,oBAAqB,SAAQ,WAAW;gBACvC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAM7C;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAEzB,UAAU,IAAI,MAAM,CAAC;IACrB,cAAc,IAAI,MAAM,CAAC;IAGzB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAGxB,YAAY,CACV,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC;IACV,oBAAoB,CAClB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC;IACV,aAAa,CACX,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC;IAGV,iBAAiB,IAAI,MAAM,CAAC;IAC5B,sBAAsB,IAAI,MAAM,CAAC;IACjC,cAAc,IAAI,IAAI,CAAC;IAGvB,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC;CAC5B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/runtime/wasmer-sdk-loader/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,qBAAa,oBAAqB,SAAQ,WAAW;gBACvC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAM7C;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAEzB,UAAU,IAAI,MAAM,CAAC;IACrB,cAAc,IAAI,MAAM,CAAC;IAGzB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAGxB,YAAY,CACV,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC;IACV,oBAAoB,CAClB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC;IACV,aAAa,CACX,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC;IAEV;;;;OAIG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAEtD;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAGlD,iBAAiB,IAAI,MAAM,CAAC;IAC5B,sBAAsB,IAAI,MAAM,CAAC;IACjC,cAAc,IAAI,IAAI,CAAC;IAGvB,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC;CAC5B"}

package/dist/src/simple/checksum-operations.d.ts

@@ -0,0 +1,25 @@
+import type { AudioFileInput } from "../types.js";
+import type { MediaChecksum, MediaChecksumOptions } from "../taglib/audio-file-checksum.js";
+/**
+ * Reads a checksum of an audio file's media content.
+ *
+ * The digest is of the *encoded media payload* — the bytes that are the audio,
+ * not the tags around them — so it survives a tag edit, with one boundary: an
+ * ID3v2 tag appended after a FLAC's audio is inside that payload, so editing it
+ * does move the hash. Formats whose payload cannot be delimited answer the
+ * whole file instead and say so (`source: "file"`), where a tag edit does move
+ * the hash.
+ *
+ * @param file - File path, Uint8Array, ArrayBuffer, or File object
+ * @param options - `basis: "pcm"` asks for FLAC's STREAMINFO MD5, the digest of
+ *   the *uncompressed* stream, instead of the encoded payload's SHA-256
+ * @returns The hex digest, the algorithm, what it covers (`source`), and how
+ *   many bytes were hashed
+ * @throws {TagLibInitializationError} If the Wasm module fails to initialize
+ * @throws {InvalidFormatError} If the file is corrupted or in an unsupported format
+ * @throws {UnsupportedFormatError} If `basis: "pcm"` is asked of a non-FLAC file
+ * @throws {MetadataError} If the payload cannot be walked, or the handle holds
+ *   no bytes and no readable source
+ */
+export declare function readMediaChecksum(file: AudioFileInput, options?: MediaChecksumOptions): Promise<MediaChecksum>;
+//# sourceMappingURL=checksum-operations.d.ts.map

package/dist/src/simple/checksum-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checksum-operations.d.ts","sourceRoot":"","sources":["../../../src/simple/checksum-operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACrB,MAAM,kCAAkC,CAAC;AAG1C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,cAAc,EACpB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,aAAa,CAAC,CAExB"}

package/dist/src/simple/checksum-operations.js

@@ -0,0 +1,7 @@
+import { withAudioFile } from "./with-audio-file.js";
+async function readMediaChecksum(file, options) {
+  return withAudioFile(file, (audioFile) => audioFile.mediaChecksum(options));
+}
+export {
+  readMediaChecksum
+};

package/dist/src/simple/index.d.ts

@@ -3,6 +3,8 @@ export { applyTags, applyTagsToFile, clearTags, isValidAudioFile, readFormat, re
 export { addPicture, applyCoverArt, applyPictures, clearPictures, findPictureByType, readCoverArt, readPictureMetadata, readPictures, replacePictureByType, } from "./picture-operations.js";
 export { editTagsBatch, readMetadata, readMetadataBatch, readPropertiesBatch, readTagsBatch, writeTagsBatch, } from "./batch-operations.js";
 export type { BatchItem, BatchOptions, BatchResult, FileMetadata, WriteTagUpdate, } from "./batch-operations.js";
+export { readMediaChecksum } from "./checksum-operations.js";
+export type { ChecksumAlgorithm, ChecksumSource, MediaChecksum, MediaChecksumOptions, } from "../taglib/audio-file-checksum.js";
 export type { AudioProperties, ExtendedTag, Picture, PictureType, Tag, TagInput, } from "../types.js";
 export { PICTURE_TYPE_NAMES, PICTURE_TYPE_VALUES } from "../types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/simple/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/simple/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EACL,SAAS,EACT,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,QAAQ,GACT,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,UAAU,EACV,aAAa,EACb,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,cAAc,GACf,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,eAAe,EACf,WAAW,EACX,OAAO,EACP,WAAW,EACX,GAAG,EACH,QAAQ,GACT,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/simple/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EACL,SAAS,EACT,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,QAAQ,GACT,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,UAAU,EACV,aAAa,EACb,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,cAAc,GACf,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,oBAAoB,GACrB,MAAM,kCAAkC,CAAC;AAE1C,YAAY,EACV,eAAe,EACf,WAAW,EACX,OAAO,EACP,WAAW,EACX,GAAG,EACH,QAAQ,GACT,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/src/simple/index.js

@@ -27,6 +27,7 @@ import {
   readTagsBatch,
   writeTagsBatch
 } from "./batch-operations.js";
+import { readMediaChecksum } from "./checksum-operations.js";
 import { PICTURE_TYPE_NAMES, PICTURE_TYPE_VALUES } from "../types.js";
 export {
   PICTURE_TYPE_NAMES,
@@ -44,6 +45,7 @@ export {
   isValidAudioFile,
   readCoverArt,
   readFormat,
+  readMediaChecksum,
   readMetadata,
   readMetadataBatch,
   readPictureMetadata,

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

@@ -0,0 +1,47 @@
+/**
+ * @fileoverview `mediaChecksum()`: a SHA-256 of a file's *encoded media
+ * payload* — the bytes that are the audio, and not the tags around them — plus
+ * FLAC's STREAMINFO digest passthrough. Factored out of `AudioFileImpl` so the
+ * source rule below (what actually gets hashed) is stated exactly once.
+ */
+import type { PlatformIO } from "../runtime/platform-io.js";
+export type MediaChecksum = {
+    source: "audio-payload" | "file";
+    algorithm: "sha256";
+    hex: string;
+    bytesHashed: number;
+} | {
+    source: "flac-streaminfo-md5";
+    algorithm: "md5";
+    hex: string;
+    bytesHashed: 16;
+};
+export interface MediaChecksumOptions {
+    basis?: "encoded" | "pcm";
+}
+/** The literal a checksum's `source` field carries, so a consumer can hold one
+ * without restating the values. */
+export type ChecksumSource = MediaChecksum["source"];
+/** The algorithm any returned checksum can carry — narrowed by `source`. */
+export type ChecksumAlgorithm = MediaChecksum["algorithm"];
+/**
+ * What the checksum needs from the open handle — module-internal, and not
+ * re-exported from either entry point (`ChecksumSource` above is the public name,
+ * and a handle descriptor must not shadow it).
+ */
+interface ChecksumHandleSource {
+    /** The bytes the handle holds — a full file, a partial-load window image, or
+     * nothing at all when the data lives on disk (WASI path mode). */
+    bytes: Uint8Array;
+    /** The path, when the handle was opened from one. */
+    path?: string;
+    /** The File/Blob, when the handle was opened from one. */
+    blob?: Blob;
+    /** True when `bytes` is a spliced header+footer image rather than the file.
+     * Must be captured when the handle is created: `saveToFile()` clears the
+     * instance's own flag while the bytes stay spliced. */
+    partiallyLoaded: boolean;
+}
+export declare function mediaChecksum(source: ChecksumHandleSource, format: string, io: PlatformIO, options?: MediaChecksumOptions): Promise<MediaChecksum>;
+export {};
+//# sourceMappingURL=audio-file-checksum.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audio-file-checksum.d.ts","sourceRoot":"","sources":["../../../src/taglib/audio-file-checksum.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAG5D,MAAM,MAAM,aAAa,GACrB;IACA,MAAM,EAAE,eAAe,GAAG,MAAM,CAAC;IACjC,SAAS,EAAE,QAAQ,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB,GACC;IACA,MAAM,EAAE,qBAAqB,CAAC;IAC9B,SAAS,EAAE,KAAK,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,EAAE,CAAC;CACjB,CAAC;AAEJ,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC;CAC3B;AAED;mCACmC;AACnC,MAAM,MAAM,cAAc,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;AAErD,4EAA4E;AAC5E,MAAM,MAAM,iBAAiB,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;AAE3D;;;;GAIG;AACH,UAAU,oBAAoB;IAC5B;sEACkE;IAClE,KAAK,EAAE,UAAU,CAAC;IAClB,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ;;2DAEuD;IACvD,eAAe,EAAE,OAAO,CAAC;CAC1B;AA6FD,wBAAsB,aAAa,CACjC,MAAM,EAAE,oBAAoB,EAC5B,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,UAAU,EACd,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,aAAa,CAAC,CAoExB"}

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

@@ -0,0 +1,77 @@
+import { flacStreamInfoMd5, mediaRanges } from "./media-ranges.js";
+import { MetadataError, UnsupportedFormatError } from "../errors.js";
+const STREAMINFO_WINDOW = 65536;
+async function fileBytes(source, io) {
+  if (source.path) return await io.readFile(source.path);
+  if (source.blob) return new Uint8Array(await source.blob.arrayBuffer());
+  if (!source.partiallyLoaded && source.bytes.length > 0) return source.bytes;
+  throw new MetadataError(
+    "read",
+    "the handle holds no file bytes and has no readable source; a partial handle that has been saved drops its source \u2014 checksum the saved path instead"
+  );
+}
+function joinRanges(bytes, ranges) {
+  const total = ranges.reduce((n, r) => n + r.length, 0);
+  const overrun = ranges.find((r) => r.offset + r.length > bytes.length);
+  if (overrun || total > bytes.length) {
+    throw new MetadataError(
+      "read",
+      `range walk overran the buffer (${overrun ? `range ${overrun.offset}+${overrun.length}` : `${total} bytes`} past the ${bytes.length}-byte buffer)`
+    );
+  }
+  if (ranges.length === 1) {
+    const only = ranges[0];
+    const view = bytes.subarray(only.offset, only.offset + only.length);
+    return view.buffer instanceof ArrayBuffer ? view : new Uint8Array(view);
+  }
+  const out = new Uint8Array(total);
+  let at = 0;
+  for (const r of ranges) {
+    out.set(bytes.subarray(r.offset, r.offset + r.length), at);
+    at += r.length;
+  }
+  return out;
+}
+async function mediaChecksum(source, format, io, options = {}) {
+  if (options.basis === "pcm") {
+    if (format.toUpperCase() !== "FLAC") {
+      throw new UnsupportedFormatError(format, ["FLAC"], {
+        operation: "media checksum (basis: pcm)"
+      });
+    }
+    const windowed = source.bytes.length > 0 ? source.bytes : source.path && io.readPartial ? await io.readPartial(source.path, STREAMINFO_WINDOW, 0) : void 0;
+    let md5 = windowed === void 0 ? void 0 : flacStreamInfoMd5(windowed);
+    if (md5 === void 0 && windowed !== source.bytes) {
+      md5 = flacStreamInfoMd5(await fileBytes(source, io));
+    }
+    if (md5 === void 0) {
+      throw new MetadataError(
+        "read",
+        "STREAMINFO digest unavailable"
+      );
+    }
+    return {
+      source: "flac-streaminfo-md5",
+      algorithm: "md5",
+      hex: md5,
+      bytesHashed: 16
+    };
+  }
+  const bytes = await fileBytes(source, io);
+  const walk = mediaRanges(format, bytes);
+  const payload = joinRanges(bytes, walk.ranges);
+  const digest = new Uint8Array(
+    await crypto.subtle.digest("SHA-256", payload)
+  );
+  let hex = "";
+  for (const byte of digest) hex += byte.toString(16).padStart(2, "0");
+  return {
+    source: walk.kind === "ranges" ? "audio-payload" : "file",
+    algorithm: "sha256",
+    hex,
+    bytesHashed: payload.length
+  };
+}
+export {
+  mediaChecksum
+};

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

@@ -6,6 +6,7 @@ import type { Id3v2Frame, Rating, UnsyncedLyrics } from "../constants/complex-pr
 import { type NormalizedRating } from "../utils/rating.js";
 import type { AudioFile } from "./audio-file-interface.js";
 import { BaseAudioFileImpl } from "./audio-file-base.js";
+import { type MediaChecksum, type MediaChecksumOptions } from "./audio-file-checksum.js";
 /** @internal Exported for unit tests (tests/node-fs-acquisition.test.ts). */
 export declare function readFileSync(path: string): Uint8Array;
 /**
@@ -16,9 +17,12 @@ export declare function readFileSync(path: string): Uint8Array;
  */
 export declare class AudioFileImpl extends BaseAudioFileImpl implements AudioFile {
     private pathModeBuffer;
+    /** How the handle was loaded — `isPartiallyLoaded` is mutated by saveToFile(). */
+    private readonly partiallyLoadedAtConstruction;
     constructor(module: TagLibModule, fileHandle: WasmFileHandle, sourcePath?: string, originalSource?: string | Uint8Array | ArrayBuffer | File, isPartiallyLoaded?: boolean, partialLoadOptions?: OpenOptions);
     save(): boolean;
     getFileBuffer(): Uint8Array;
+    mediaChecksum(options?: MediaChecksumOptions): Promise<MediaChecksum>;
     saveToFile(path?: string): Promise<void>;
     getPictures(): Picture[];
     setPictures(pictures: Picture[]): 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,EAIV,YAAY,EACZ,cAAc,EACf,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,cAAc,EAC1B,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;IAYxB,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;IAqBxB,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;IAWtB,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;IAQ/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":"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"}

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

@@ -19,6 +19,10 @@ 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 {
+  mediaChecksum
+} from "./audio-file-checksum.js";
+import { getPlatformIO } from "../runtime/platform-io.js";
 import { saveViaFreshHandle } from "./save-reconstruct.js";
 function sortChapters(list) {
   return [...list].sort((a, b) => a.startTimeMs - b.startTimeMs);
@@ -50,6 +54,9 @@ class AudioFileImpl extends BaseAudioFileImpl {
       partialLoadOptions
     );
     __publicField(this, "pathModeBuffer", null);
+    /** How the handle was loaded — `isPartiallyLoaded` is mutated by saveToFile(). */
+    __publicField(this, "partiallyLoadedAtConstruction");
+    this.partiallyLoadedAtConstruction = isPartiallyLoaded;
   }
   save() {
     if (this.isPartiallyLoaded && this.originalSource) {
@@ -85,6 +92,31 @@ class AudioFileImpl extends BaseAudioFileImpl {
       "No file data available: in-memory buffer is empty and no source path is set"
     );
   }
+  mediaChecksum(options) {
+    return mediaChecksum(
+      {
+        // The cheap, no-IO accessor — `getFileBuffer()` would read the whole
+        // file from disk in path mode (and cache it), which the source rule is
+        // about to read for itself.
+        bytes: this.handle.getBuffer(),
+        // empty in path mode: the data is on disk
+        // Both optional fields are conditional: they are `undefined` far more
+        // often than not, and `exactOptionalPropertyTypes` refuses an explicit
+        // `undefined` on an optional property.
+        ...this.sourcePath !== void 0 ? { path: this.sourcePath } : {},
+        // originalSource is the File when the caller passed one. A partial File
+        // has no path, so this is the only way back to the real bytes.
+        ...this.originalSource instanceof Blob ? { blob: this.originalSource } : {},
+        // Captured at construction, NOT this.isPartiallyLoaded: saveToFile() sets
+        // that flag false (and clears originalSource) while the handle still holds
+        // the spliced image, which would make the source rule hash the image.
+        partiallyLoaded: this.partiallyLoadedAtConstruction
+      },
+      this.getFormat(),
+      getPlatformIO(),
+      options
+    );
+  }
   async saveToFile(path) {
     const targetPath = path ?? this.sourcePath;
     if (!targetPath) {
@@ -174,8 +206,8 @@ class AudioFileImpl extends BaseAudioFileImpl {
   }
   setChapters(chapters, options) {
     const fmt = this.getFormat();
-    if (fmt !== "MP3" && fmt !== "MP4") {
-      throw new UnsupportedFormatError(fmt, ["MP3", "MP4"], {
+    if (fmt !== "MP3" && fmt !== "AAC" && fmt !== "MP4") {
+      throw new UnsupportedFormatError(fmt, ["MP3", "AAC", "MP4"], {
         operation: "setChapters"
       });
     }

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

@@ -2,6 +2,7 @@ import type { AudioProperties, FileType, Picture, PropertyMap } from "../types.j
 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 { MediaChecksum, MediaChecksumOptions } from "./audio-file-checksum.js";
 import type { FormatPropertyKey } from "../types/format-property-keys.js";
 import type { NormalizedRating } from "../utils/rating.js";
 /**
@@ -66,6 +67,22 @@ export interface AudioFile {
      * and cannot be read back — never returns an empty buffer on failure.
      */
     getFileBuffer(): Uint8Array;
+    /**
+     * SHA-256 of the file's encoded media payload — the bytes that are the audio,
+     * not the tags around them — so the digest survives a tag edit, with one
+     * boundary: an ID3v2 tag appended after a FLAC's audio is inside the payload,
+     * so editing it does move the hash. Formats whose payload cannot be delimited
+     * answer the whole file instead and say so (`source: "file"`), where a tag
+     * edit does move the hash.
+     *
+     * Pass `{ basis: "pcm" }` for FLAC's STREAMINFO MD5 — the digest of the
+     * *uncompressed* stream, read straight from the file's first metadata block.
+     * Other formats throw {@link UnsupportedFormatError}.
+     *
+     * @throws {MetadataError} If the handle holds no file bytes and has no
+     * readable source (a partial handle that has already been saved).
+     */
+    mediaChecksum(options?: MediaChecksumOptions): Promise<MediaChecksum>;
     /**
      * Save all changes to a file on disk.
      * @param path - Optional file path. If not provided, saves to the original path.

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":"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"}
+{"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/embind-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embind-adapter.d.ts","sourceRoot":"","sources":["../../../src/taglib/embind-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAyB,cAAc,EAAE,MAAM,YAAY,CAAC;AAcxE,wEAAwE;AACxE,UAAU,gBAAgB;IACxB,KAAK,IAAI,MAAM,CAAC;IAChB,MAAM,IAAI,MAAM,CAAC;IACjB,KAAK,IAAI,MAAM,CAAC;IAChB,OAAO,IAAI,MAAM,CAAC;IAClB,KAAK,IAAI,MAAM,CAAC;IAChB,IAAI,IAAI,MAAM,CAAC;IACf,KAAK,IAAI,MAAM,CAAC;IAChB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,oFAAoF;AACpF,UAAU,4BAA4B;IACpC,eAAe,IAAI,MAAM,CAAC;IAC1B,oBAAoB,IAAI,MAAM,CAAC;IAC/B,OAAO,IAAI,MAAM,CAAC;IAClB,UAAU,IAAI,MAAM,CAAC;IACrB,QAAQ,IAAI,MAAM,CAAC;IACnB,aAAa,IAAI,MAAM,CAAC;IACxB,KAAK,IAAI,MAAM,CAAC;IAChB,eAAe,IAAI,MAAM,CAAC;IAC1B,UAAU,IAAI,OAAO,CAAC;IACtB,WAAW,IAAI,MAAM,CAAC;IACtB,SAAS,IAAI,MAAM,CAAC;IACpB,WAAW,IAAI,OAAO,CAAC;IACvB,aAAa,IAAI,MAAM,CAAC;IACxB,WAAW,IAAI,MAAM,CAAC;IACtB,YAAY,IAAI,MAAM,CAAC;CACxB;AAED,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,IAAI,gBAAgB,CAAC;IAC3B,kBAAkB,IAAI,4BAA4B,GAAG,IAAI,CAAC;IAC1D,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,GAAG,cAAc,CAoKtE"}
+{"version":3,"file":"embind-adapter.d.ts","sourceRoot":"","sources":["../../../src/taglib/embind-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAyB,cAAc,EAAE,MAAM,YAAY,CAAC;AAcxE,wEAAwE;AACxE,UAAU,gBAAgB;IACxB,KAAK,IAAI,MAAM,CAAC;IAChB,MAAM,IAAI,MAAM,CAAC;IACjB,KAAK,IAAI,MAAM,CAAC;IAChB,OAAO,IAAI,MAAM,CAAC;IAClB,KAAK,IAAI,MAAM,CAAC;IAChB,IAAI,IAAI,MAAM,CAAC;IACf,KAAK,IAAI,MAAM,CAAC;IAChB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,oFAAoF;AACpF,UAAU,4BAA4B;IACpC,eAAe,IAAI,MAAM,CAAC;IAC1B,oBAAoB,IAAI,MAAM,CAAC;IAC/B,OAAO,IAAI,MAAM,CAAC;IAClB,UAAU,IAAI,MAAM,CAAC;IACrB,QAAQ,IAAI,MAAM,CAAC;IACnB,aAAa,IAAI,MAAM,CAAC;IACxB,KAAK,IAAI,MAAM,CAAC;IAChB,eAAe,IAAI,MAAM,CAAC;IAC1B,UAAU,IAAI,OAAO,CAAC;IACtB,WAAW,IAAI,MAAM,CAAC;IACtB,SAAS,IAAI,MAAM,CAAC;IACpB,WAAW,IAAI,OAAO,CAAC;IACvB,aAAa,IAAI,MAAM,CAAC;IACxB,WAAW,IAAI,MAAM,CAAC;IACtB,YAAY,IAAI,MAAM,CAAC;CACxB;AAED,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,IAAI,gBAAgB,CAAC;IAC3B,kBAAkB,IAAI,4BAA4B,GAAG,IAAI,CAAC;IAC1D,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,GAAG,cAAc,CAyKtE"}

package/dist/src/taglib/embind-adapter.js

@@ -121,7 +121,10 @@ function wrapEmbindHandle(raw) {
         ...containerFormat === "MP4" || containerFormat === "ASF" ? { isEncrypted: pw.isEncrypted() } : {},
         ...formatVersion > 0 ? { formatVersion } : {},
         ...isValidBitrateMode(bitrateMode) ? { bitrateMode } : {},
-        ...codec === "Opus" ? { outputGainDb: pw.outputGainDb() } : {}
+        // OpusHead gain exists only in an Ogg Opus stream. Gating on codec
+        // alone fabricated outputGainDb: 0 for MP4 tracks once the MP4 codec
+        // enum was mapped (the WASI side never emitted it there) — taglib-kswf.
+        ...containerFormat === "OGG" && codec === "Opus" ? { outputGainDb: pw.outputGainDb() } : {}
       };
     }
   };

package/dist/src/taglib/id3v2-frames.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"id3v2-frames.d.ts","sourceRoot":"","sources":["../../../src/taglib/id3v2-frames.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAIrE,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAM9C;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAQ3E;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,IAAI,CAUtE;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU,CAM9D"}
+{"version":3,"file":"id3v2-frames.d.ts","sourceRoot":"","sources":["../../../src/taglib/id3v2-frames.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAIrE,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAQ9C;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAQ3E;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,IAAI,CAUtE;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU,CAM9D"}