music-metadata 11.13.0 → 11.14.0

package/lib/common/Util.d.ts

@@ -1,5 +1,5 @@
 import type { IRatio } from '../type.js';
-export type StringEncoding = 'ascii' | 'utf8' | 'utf-16le' | 'ucs2' | 'base64url' | 'latin1' | 'hex';
+export type StringEncoding = 'ascii' | 'utf8' | 'utf-16le' | 'utf-16be' | 'ucs2' | 'base64url' | 'latin1' | 'hex';
 export declare function getBit(buf: Uint8Array, off: number, bit: number): boolean;
 /**
  * Find delimiting zero in uint8Array

package/lib/common/Util.js

@@ -12,7 +12,7 @@ export function getBit(buf, off, bit) {
  */
 export function findZero(uint8Array, encoding) {
     const len = uint8Array.length;
-    if (encoding === 'utf-16le') {
+    if (encoding === 'utf-16le' || encoding === 'utf-16be') {
         // Look for 0x00 0x00 on 2-byte boundary
         for (let i = 0; i + 1 < len; i += 2) {
             if (uint8Array[i] === 0 && uint8Array[i + 1] === 0)
@@ -57,6 +57,12 @@ export function decodeString(uint8Array, encoding) {
             throw new FieldDecodingError('Expected even number of octets for 16-bit unicode string');
         return decodeString(swapBytes(uint8Array), encoding);
     }
+    if (encoding === 'utf-16be') {
+        // There is no native UTF-16BE decoder; swap to UTF-16LE and decode that.
+        if ((uint8Array.length & 1) !== 0)
+            throw new FieldDecodingError('Expected even number of octets for 16-bit unicode string');
+        return new StringType(uint8Array.length, 'utf-16le').get(swapBytes(Uint8Array.from(uint8Array)), 0);
+    }
     return new StringType(uint8Array.length, encoding).get(uint8Array, 0);
 }
 export function stripNulls(str) {

package/lib/id3v2/FrameHeader.js

@@ -15,7 +15,27 @@ export function getFrameHeaderLength(majorVer) {
         default: throw makeUnexpectedMajorVersionError(majorVer);
     }
 }
-function readFrameFlags(b) {
+function readFrameFlags(b, majorVer) {
+    // ID3v2.3 and ID3v2.4 use different bit layouts for the frame status and format flags.
+    if (majorVer === 3) {
+        // ID3v2.3: status `%abc00000`, format `%ijk00000` (https://id3.org/id3v2.3.0)
+        return {
+            status: {
+                tag_alter_preservation: util.getBit(b, 0, 7),
+                file_alter_preservation: util.getBit(b, 0, 6),
+                read_only: util.getBit(b, 0, 5)
+            },
+            format: {
+                compression: util.getBit(b, 1, 7),
+                encryption: util.getBit(b, 1, 6),
+                grouping_identity: util.getBit(b, 1, 5),
+                // Unsynchronisation and data-length-indicator do not exist as per-frame flags in ID3v2.3.
+                unsynchronisation: false,
+                data_length_indicator: false
+            }
+        };
+    }
+    // ID3v2.4: status `%0abc0000`, format `%0h00kmnp` (https://id3.org/id3v2.4.0-structure)
     return {
         status: {
             tag_alter_preservation: util.getBit(b, 0, 6),
@@ -23,7 +43,7 @@ function readFrameFlags(b) {
             read_only: util.getBit(b, 0, 4)
         },
         format: {
-            grouping_identity: util.getBit(b, 1, 7),
+            grouping_identity: util.getBit(b, 1, 6),
             compression: util.getBit(b, 1, 3),
             encryption: util.getBit(b, 1, 2),
             unsynchronisation: util.getBit(b, 1, 1),
@@ -61,7 +81,7 @@ function parseFrameHeaderV23V24(uint8Array, majorVer, warningCollector) {
     const header = {
         id: textDecode(uint8Array.subarray(0, 4), 'ascii'),
         length: (majorVer === 4 ? UINT32SYNCSAFE : Token.UINT32_BE).get(uint8Array, 4),
-        flags: readFrameFlags(uint8Array.subarray(8, 10))
+        flags: readFrameFlags(uint8Array.subarray(8, 10), majorVer)
     };
     if (!header.id.match(/^[A-Z0-9]{4}$/)) {
         warningCollector.addWarning(`Invalid ID3v2.${majorVer} frame-header-ID: ${header.id}`);

package/lib/id3v2/FrameParser.js

@@ -390,11 +390,11 @@ export class FrameParser {
         if (zeroIndex >= valueArray.length) {
             // No terminator found, decode full buffer remainder
             return {
-                text: util.decodeString(valueArray, encoding.encoding),
+                text: util.decodeString(uint8Array, encoding.encoding),
                 len: originalLen
             };
         }
-        const txt = valueArray.subarray(0, zeroIndex);
+        const txt = uint8Array.subarray(0, bomSize + zeroIndex);
         return {
             text: util.decodeString(txt, encoding.encoding),
             len: bomSize + zeroIndex + FrameParser.getNullTerminatorLength(encoding.encoding)

package/lib/id3v2/ID3v2Token.js

@@ -109,7 +109,7 @@ export const TextEncodingToken = {
             case 0x01:
                 return { encoding: 'utf-16le', bom: true };
             case 0x02:
-                return { encoding: 'utf-16le', bom: false };
+                return { encoding: 'utf-16be', bom: false };
             case 0x03:
                 return { encoding: 'utf8', bom: false };
             default:

package/lib/mp4/AtomToken.js

@@ -226,19 +226,44 @@ export class TrackHeaderAtom {
         this.len = len;
     }
     get(buf, off) {
-        return {
-            version: Token.UINT8.get(buf, off),
-            flags: Token.UINT24_BE.get(buf, off + 1),
-            creationTime: SecondsSinceMacEpoch.get(buf, off + 4),
-            modificationTime: SecondsSinceMacEpoch.get(buf, off + 8),
-            trackId: Token.UINT32_BE.get(buf, off + 12),
-            // reserved 4 bytes
-            duration: Token.UINT32_BE.get(buf, off + 20),
-            layer: Token.UINT16_BE.get(buf, off + 24),
-            alternateGroup: Token.UINT16_BE.get(buf, off + 26),
-            volume: Token.UINT16_BE.get(buf, off + 28) // ToDo: fixed point
-            // ToDo: add remaining fields
-        };
+        const version = Token.UINT8.get(buf, off);
+        const flags = Token.UINT24_BE.get(buf, off + 1);
+        switch (version) {
+            case 0:
+                // Version 0: 32-bit fields
+                return {
+                    version,
+                    flags,
+                    creationTime: SecondsSinceMacEpoch.get(buf, off + 4),
+                    modificationTime: SecondsSinceMacEpoch.get(buf, off + 8),
+                    trackId: Token.UINT32_BE.get(buf, off + 12),
+                    // reserved 4 bytes
+                    duration: Token.UINT32_BE.get(buf, off + 20),
+                    // reserved 8 bytes
+                    layer: Token.UINT16_BE.get(buf, off + 32),
+                    alternateGroup: Token.UINT16_BE.get(buf, off + 34),
+                    volume: Token.UINT16_BE.get(buf, off + 36) // ToDo: fixed point
+                    // ToDo: add remaining fields
+                };
+            case 1:
+                // Version 1: 64-bit creation/modification times and duration
+                return {
+                    version,
+                    flags,
+                    creationTime: SecondsSinceMacEpoch64.get(buf, off + 4),
+                    modificationTime: SecondsSinceMacEpoch64.get(buf, off + 12),
+                    trackId: Token.UINT32_BE.get(buf, off + 20),
+                    // reserved 4 bytes
+                    duration: Number(Token.UINT64_BE.get(buf, off + 28)),
+                    // reserved 8 bytes
+                    layer: Token.UINT16_BE.get(buf, off + 44),
+                    alternateGroup: Token.UINT16_BE.get(buf, off + 46),
+                    volume: Token.UINT16_BE.get(buf, off + 48) // ToDo: fixed point
+                    // ToDo: add remaining fields
+                };
+            default:
+                throw new FieldDecodingError('Invalid tkhd version header');
+        }
     }
 }
 /**

package/lib/mpeg/MpegParser.js

@@ -31,7 +31,7 @@ const MPEG4 = {
      * https://wiki.multimedia.cx/index.php/MPEG-4_Audio#Sampling_Frequencies
      */
     SamplingFrequencies: [
-        96000, 88200, 64000, 48000, 44100, 32000, 24000, 22050, 16000, 12000, 11025, 8000, 7350, null, null, -1
+        96000, 88200, 64000, 48000, 44100, 32000, 24000, 22050, 16000, 12000, 11025, 8000, 7350, null, null, null
     ]
     /**
      * Channel Configurations

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "music-metadata",
   "description": "Music metadata parser for Node.js, supporting virtual any audio and tag format.",
-  "version": "11.13.0",
+  "version": "11.14.0",
   "author": {
     "name": "Borewit",
     "url": "https://github.com/Borewit"
@@ -124,20 +124,20 @@
     "win-guid": "^0.2.1"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.4.6",
+    "@biomejs/biome": "2.5.3",
     "@types/chai": "^5.2.3",
     "@types/chai-as-promised": "^8.0.2",
-    "@types/content-type": "^1.1.9",
-    "@types/debug": "^4.1.12",
+    "@types/content-type": "^2.0.0",
+    "@types/debug": "^4.1.13",
     "@types/media-typer": "^1.1.3",
     "@types/mocha": "^10.0.10",
-    "@types/node": "^25.2.0",
+    "@types/node": "^26.1.1",
     "c8": "^11.0.0",
     "chai": "^6.2.2",
     "chai-as-promised": "^8.0.2",
     "del-cli": "^7.0.0",
     "mime": "^4.1.0",
-    "mocha": "^11.7.5",
+    "mocha": "^11.7.6",
     "node-readable-to-web-readable-stream": "^0.4.2",
     "remark-cli": "^12.0.1",
     "remark-preset-lint-consistent": "^6.0.1",