music-metadata 7.12.0 → 7.12.3

package/lib/ParserFactory.js

@@ -4,7 +4,7 @@ exports.ParserFactory = exports.parseHttpContentType = void 0;
 const FileType = require("file-type/core");
 const ContentType = require("content-type");
 const MimeType = require("media-typer");
-const _debug = require("debug");
+const debug_1 = require("debug");
 const MetadataCollector_1 = require("./common/MetadataCollector");
 const AiffParser_1 = require("./aiff/AiffParser");
 const APEv2Parser_1 = require("./apev2/APEv2Parser");
@@ -19,7 +19,7 @@ const WavPackParser_1 = require("./wavpack/WavPackParser");
 const DsfParser_1 = require("./dsf/DsfParser");
 const DsdiffParser_1 = require("./dsdiff/DsdiffParser");
 const MatroskaParser_1 = require("./matroska/MatroskaParser");
-const debug = _debug('music-metadata:parser:factory');
+const debug = (0, debug_1.default)('music-metadata:parser:factory');
 function parseHttpContentType(contentType) {
     const type = ContentType.parse(contentType);
     const mime = MimeType.parse(type.type);

package/lib/aiff/AiffParser.js

@@ -2,14 +2,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AIFFParser = void 0;
 const Token = require("token-types");
-const initDebug = require("debug");
+const debug_1 = require("debug");
 const strtok3 = require("strtok3/lib/core");
 const ID3v2Parser_1 = require("../id3v2/ID3v2Parser");
 const FourCC_1 = require("../common/FourCC");
 const BasicParser_1 = require("../common/BasicParser");
 const AiffToken = require("./AiffToken");
 const iff = require("../iff");
-const debug = initDebug('music-metadata:parser:aiff');
+const debug = (0, debug_1.default)('music-metadata:parser:aiff');
 /**
  * AIFF - Audio Interchange File Format
  *

package/lib/apev2/APEv2Parser.js

@@ -1,13 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.APEv2Parser = void 0;
-const initDebug = require("debug");
+const debug_1 = require("debug");
 const strtok3 = require("strtok3/lib/core");
 const token_types_1 = require("token-types");
 const util = require("../common/Util");
 const BasicParser_1 = require("../common/BasicParser");
 const APEv2Token_1 = require("./APEv2Token");
-const debug = initDebug('music-metadata:parser:APEv2');
+const debug = (0, debug_1.default)('music-metadata:parser:APEv2');
 const tagFormat = 'APEv2';
 const preamble = 'APETAGEX';
 class APEv2Parser extends BasicParser_1.BasicParser {
@@ -134,8 +134,11 @@ class APEv2Parser extends BasicParser_1.BasicParser {
                     debug(`Ignore external info ${key}`);
                     await this.tokenizer.ignore(tagItemHeader.size);
                     break;
-                default:
-                    throw new Error(`Unexpected data-type: ${tagItemHeader.flags.dataType}`);
+                case APEv2Token_1.DataType.reserved:
+                    debug(`Ignore external info ${key}`);
+                    this.metadata.addWarning(`APEv2 header declares a reserved datatype for "${key}"`);
+                    await this.tokenizer.ignore(tagItemHeader.size);
+                    break;
             }
         }
     }

package/lib/asf/AsfObject.d.ts

@@ -294,7 +294,7 @@ export declare class ExtendedStreamPropertiesObjectState extends State<IExtended
 export declare class MetadataObjectState extends State<ITag[]> {
     static guid: GUID;
     constructor(header: IAsfObjectHeader);
-    get(buf: Buffer, off: number): ITag[];
+    get(uint8Array: Uint8Array, off: number): ITag[];
 }
 export declare class MetadataLibraryObjectState extends MetadataObjectState {
     static guid: GUID;

package/lib/asf/AsfObject.js

@@ -311,8 +311,9 @@ class MetadataObjectState extends State {
     constructor(header) {
         super(header);
     }
-    get(buf, off) {
+    get(uint8Array, off) {
         const tags = [];
+        const buf = Buffer.from(uint8Array);
         const descriptionRecordsCount = buf.readUInt16LE(off);
         let pos = off + 2;
         for (let i = 0; i < descriptionRecordsCount; i += 1) {
@@ -327,10 +328,6 @@ class MetadataObjectState extends State {
             pos += nameLen;
             const data = buf.slice(pos, pos + dataLen);
             pos += dataLen;
-            const parseAttr = AsfUtil_1.AsfUtil.getParserForAttr(dataType);
-            if (!parseAttr) {
-                throw new Error('unexpected value headerType: ' + dataType);
-            }
             this.postProcessTag(tags, name, dataType, data);
         }
         return tags;

package/lib/asf/AsfParser.js

@@ -1,12 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AsfParser = void 0;
-const initDebug = require("debug");
+const debug_1 = require("debug");
 const type_1 = require("../type");
 const GUID_1 = require("./GUID");
 const AsfObject = require("./AsfObject");
 const BasicParser_1 = require("../common/BasicParser");
-const debug = initDebug('music-metadata:parser:ASF');
+const debug = (0, debug_1.default)('music-metadata:parser:ASF');
 const headerType = 'asf';
 /**
  * Windows Media Metadata Usage Guidelines

package/lib/asf/AsfUtil.d.ts

@@ -3,7 +3,7 @@ import { DataType } from './AsfObject';
 export declare type AttributeParser = (buf: Buffer) => boolean | string | number | bigint | Buffer;
 export declare class AsfUtil {
     static getParserForAttr(i: DataType): AttributeParser;
-    static parseUnicodeAttr(buf: any): string;
+    static parseUnicodeAttr(uint8Array: Uint8Array): string;
     private static attributeParsers;
     private static parseByteArrayAttr;
     private static parseBoolAttr;

package/lib/asf/AsfUtil.js

@@ -7,13 +7,11 @@ class AsfUtil {
     static getParserForAttr(i) {
         return AsfUtil.attributeParsers[i];
     }
-    static parseUnicodeAttr(buf) {
-        return util.stripNulls(util.decodeString(buf, 'utf16le'));
+    static parseUnicodeAttr(uint8Array) {
+        return util.stripNulls(util.decodeString(uint8Array, 'utf16le'));
     }
     static parseByteArrayAttr(buf) {
-        const newBuf = Buffer.alloc(buf.length);
-        buf.copy(newBuf);
-        return newBuf;
+        return Buffer.from(buf);
     }
     static parseBoolAttr(buf, offset = 0) {
         return AsfUtil.parseWordAttr(buf, offset) === 1;

package/lib/common/MetadataCollector.js

@@ -2,13 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.joinArtists = exports.MetadataCollector = void 0;
 const type_1 = require("../type");
-const initDebug = require("debug");
+const debug_1 = require("debug");
 const GenericTagTypes_1 = require("./GenericTagTypes");
 const CombinedTagMapper_1 = require("./CombinedTagMapper");
 const GenericTagMapper_1 = require("./GenericTagMapper");
 const Util_1 = require("./Util");
 const FileType = require("file-type/core");
-const debug = initDebug('music-metadata:collector');
+const debug = (0, debug_1.default)('music-metadata:collector');
 const TagPriority = ['matroska', 'APEv2', 'vorbis', 'ID3v2.4', 'ID3v2.3', 'ID3v2.2', 'exif', 'asf', 'iTunes', 'ID3v1'];
 /**
  * Provided to the parser to uodate the metadata result.

package/lib/common/Util.d.ts

@@ -23,22 +23,22 @@ export declare function stripNulls(str: string): string;
 /**
  * Read bit-aligned number start from buffer
  * Total offset in bits = byteOffset * 8 + bitOffset
- * @param buf Byte buffer
+ * @param source Byte buffer
  * @param byteOffset Starting offset in bytes
  * @param bitOffset Starting offset in bits: 0 = lsb
  * @param len Length of number in bits
- * @return {number} decoded bit aligned number
+ * @return Decoded bit aligned number
  */
-export declare function getBitAllignedNumber(buf: Uint8Array, byteOffset: number, bitOffset: number, len: number): number;
+export declare function getBitAllignedNumber(source: Uint8Array, byteOffset: number, bitOffset: number, len: number): number;
 /**
  * Read bit-aligned number start from buffer
  * Total offset in bits = byteOffset * 8 + bitOffset
- * @param buf Byte buffer
+ * @param source Byte Uint8Array
  * @param byteOffset Starting offset in bytes
- * @param bitOffset Starting offset in bits: 0 = most significant bit, 7 is least significant bit
- * @return {number} decoded bit aligned number
+ * @param bitOffset Starting offset in bits: 0 = most significant bit, 7 is the least significant bit
+ * @return True if bit is set
  */
-export declare function isBitSet(buf: Uint8Array, byteOffset: number, bitOffset: number): boolean;
+export declare function isBitSet(source: Uint8Array, byteOffset: number, bitOffset: number): boolean;
 export declare function a2hex(str: string): string;
 /**
  * Convert power ratio to DB

package/lib/common/Util.js

@@ -76,16 +76,16 @@ exports.stripNulls = stripNulls;
 /**
  * Read bit-aligned number start from buffer
  * Total offset in bits = byteOffset * 8 + bitOffset
- * @param buf Byte buffer
+ * @param source Byte buffer
  * @param byteOffset Starting offset in bytes
  * @param bitOffset Starting offset in bits: 0 = lsb
  * @param len Length of number in bits
- * @return {number} decoded bit aligned number
+ * @return Decoded bit aligned number
  */
-function getBitAllignedNumber(buf, byteOffset, bitOffset, len) {
+function getBitAllignedNumber(source, byteOffset, bitOffset, len) {
     const byteOff = byteOffset + ~~(bitOffset / 8);
     const bitOff = bitOffset % 8;
-    let value = buf[byteOff];
+    let value = source[byteOff];
     value &= 0xff >> bitOff;
     const bitsRead = 8 - bitOff;
     const bitsLeft = len - bitsRead;
@@ -94,7 +94,7 @@ function getBitAllignedNumber(buf, byteOffset, bitOffset, len) {
     }
     else if (bitsLeft > 0) {
         value <<= bitsLeft;
-        value |= getBitAllignedNumber(buf, byteOffset, bitOffset + bitsRead, bitsLeft);
+        value |= getBitAllignedNumber(source, byteOffset, bitOffset + bitsRead, bitsLeft);
     }
     return value;
 }
@@ -102,13 +102,13 @@ exports.getBitAllignedNumber = getBitAllignedNumber;
 /**
  * Read bit-aligned number start from buffer
  * Total offset in bits = byteOffset * 8 + bitOffset
- * @param buf Byte buffer
+ * @param source Byte Uint8Array
  * @param byteOffset Starting offset in bytes
- * @param bitOffset Starting offset in bits: 0 = most significant bit, 7 is least significant bit
- * @return {number} decoded bit aligned number
+ * @param bitOffset Starting offset in bits: 0 = most significant bit, 7 is the least significant bit
+ * @return True if bit is set
  */
-function isBitSet(buf, byteOffset, bitOffset) {
-    return getBitAllignedNumber(buf, byteOffset, bitOffset, 1) === 1;
+function isBitSet(source, byteOffset, bitOffset) {
+    return getBitAllignedNumber(source, byteOffset, bitOffset, 1) === 1;
 }
 exports.isBitSet = isBitSet;
 function a2hex(str) {

package/lib/dsdiff/DsdiffParser.js

@@ -2,13 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DsdiffParser = void 0;
 const Token = require("token-types");
-const initDebug = require("debug");
+const debug_1 = require("debug");
 const strtok3 = require("strtok3/lib/core");
 const FourCC_1 = require("../common/FourCC");
 const BasicParser_1 = require("../common/BasicParser");
 const ID3v2Parser_1 = require("../id3v2/ID3v2Parser");
 const DsdiffToken_1 = require("./DsdiffToken");
-const debug = initDebug('music-metadata:parser:aiff');
+const debug = (0, debug_1.default)('music-metadata:parser:aiff');
 /**
  * DSDIFF - Direct Stream Digital Interchange File Format (Phillips)
  *

package/lib/dsf/DsfParser.js

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DsfParser = void 0;
-const _debug = require("debug");
+const debug_1 = require("debug");
 const AbstractID3Parser_1 = require("../id3v2/AbstractID3Parser");
 const DsfChunk_1 = require("./DsfChunk");
 const ID3v2Parser_1 = require("../id3v2/ID3v2Parser");
-const debug = _debug('music-metadata:parser:DSF');
+const debug = (0, debug_1.default)('music-metadata:parser:DSF');
 /**
  * DSF (dsd stream file) File Parser
  * Ref: https://dsd-guide.com/sites/default/files/white-papers/DSFFileFormatSpec_E.pdf

package/lib/flac/FlacParser.js

@@ -2,14 +2,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FlacParser = void 0;
 const token_types_1 = require("token-types");
-const initDebug = require("debug");
+const debug_1 = require("debug");
 const util = require("../common/Util");
 const Vorbis_1 = require("../ogg/vorbis/Vorbis");
 const AbstractID3Parser_1 = require("../id3v2/AbstractID3Parser");
 const FourCC_1 = require("../common/FourCC");
 const VorbisParser_1 = require("../ogg/vorbis/VorbisParser");
 const VorbisDecoder_1 = require("../ogg/vorbis/VorbisDecoder");
-const debug = initDebug('music-metadata:parser:FLAC');
+const debug = (0, debug_1.default)('music-metadata:parser:FLAC');
 /**
  * FLAC supports up to 128 kinds of metadata blocks; currently the following are defined:
  * ref: https://xiph.org/flac/format.html#metadata_block

package/lib/id3v1/ID3v1Parser.js

@@ -1,12 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.hasID3v1Header = exports.ID3v1Parser = exports.Genres = void 0;
-const initDebug = require("debug");
+const debug_1 = require("debug");
 const token_types_1 = require("token-types");
 const util = require("../common/Util");
 const BasicParser_1 = require("../common/BasicParser");
 const APEv2Parser_1 = require("../apev2/APEv2Parser");
-const debug = initDebug('music-metadata:parser:ID3v1');
+const debug = (0, debug_1.default)('music-metadata:parser:ID3v1');
 /**
  * ID3v1 Genre mappings
  * Ref: https://de.wikipedia.org/wiki/Liste_der_ID3v1-Genres

package/lib/id3v2/AbstractID3Parser.js

@@ -2,12 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AbstractID3Parser = void 0;
 const core_1 = require("strtok3/lib/core");
-const initDebug = require("debug");
+const debug_1 = require("debug");
 const ID3v2Token_1 = require("./ID3v2Token");
 const ID3v2Parser_1 = require("./ID3v2Parser");
 const ID3v1Parser_1 = require("../id3v1/ID3v1Parser");
 const BasicParser_1 = require("../common/BasicParser");
-const debug = initDebug('music-metadata:parser:ID3');
+const debug = (0, debug_1.default)('music-metadata:parser:ID3');
 /**
  * Abstract parser which tries take ID3v2 and ID3v1 headers.
  */

package/lib/id3v2/FrameParser.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 import { ID3v2MajorVersion } from './ID3v2Token';
 import { IWarningCollector } from '../common/MetadataCollector';
 export declare function parseGenre(origVal: string): string[];
@@ -11,7 +10,7 @@ export declare class FrameParser {
      * @param warningCollector - Used to collect decode issue
      */
     constructor(major: ID3v2MajorVersion, warningCollector: IWarningCollector);
-    readData(b: Buffer, type: string, includeCovers: boolean): any;
+    readData(uint8Array: Uint8Array, type: string, includeCovers: boolean): any;
     protected static fixPictureMimeType(pictureType: string): string;
     /**
      * Converts TMCL (Musician credits list) or TIPL (Involved people list)

package/lib/id3v2/FrameParser.js

@@ -1,12 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FrameParser = exports.parseGenre = void 0;
-const initDebug = require("debug");
+const debug_1 = require("debug");
 const Token = require("token-types");
 const util = require("../common/Util");
 const ID3v2Token_1 = require("./ID3v2Token");
 const ID3v1Parser_1 = require("../id3v1/ID3v1Parser");
-const debug = initDebug('music-metadata:id3v2:frame-parser');
+const debug = (0, debug_1.default)('music-metadata:id3v2:frame-parser');
 const defaultEnc = 'latin1'; // latin1 == iso-8859-1;
 function parseGenre(origVal) {
     // match everything inside parentheses
@@ -68,13 +68,13 @@ class FrameParser {
         this.major = major;
         this.warningCollector = warningCollector;
     }
-    readData(b, type, includeCovers) {
-        if (b.length === 0) {
+    readData(uint8Array, type, includeCovers) {
+        if (uint8Array.length === 0) {
             this.warningCollector.addWarning(`id3v2.${this.major} header has empty tag type=${type}`);
             return;
         }
-        const { encoding, bom } = ID3v2Token_1.TextEncodingToken.get(b, 0);
-        const length = b.length;
+        const { encoding, bom } = ID3v2Token_1.TextEncodingToken.get(uint8Array, 0);
+        const length = uint8Array.length;
         let offset = 0;
         let output = []; // ToDo
         const nullTerminatorLength = FrameParser.getNullTerminatorLength(encoding);
@@ -90,7 +90,7 @@ class FrameParser {
             case 'PCST':
                 let text;
                 try {
-                    text = util.decodeString(b.subarray(1), encoding).replace(/\x00+$/, '');
+                    text = util.decodeString(uint8Array.slice(1), encoding).replace(/\x00+$/, '');
                 }
                 catch (error) {
                     this.warningCollector.addWarning(`id3v2.${this.major} type=${type} header has invalid string value: ${error.message}`);
@@ -131,7 +131,7 @@ class FrameParser {
                 }
                 break;
             case 'TXXX':
-                output = FrameParser.readIdentifierAndData(b, offset + 1, length, encoding);
+                output = FrameParser.readIdentifierAndData(uint8Array, offset + 1, length, encoding);
                 output = {
                     description: output.id,
                     text: this.splitValue(type, util.decodeString(output.data, encoding).replace(/\x00+$/, ''))
@@ -144,31 +144,31 @@ class FrameParser {
                     offset += 1;
                     switch (this.major) {
                         case 2:
-                            pic.format = util.decodeString(b.slice(offset, offset + 3), 'latin1'); // 'latin1'; // latin1 == iso-8859-1;
+                            pic.format = util.decodeString(uint8Array.slice(offset, offset + 3), 'latin1'); // 'latin1'; // latin1 == iso-8859-1;
                             offset += 3;
                             break;
                         case 3:
                         case 4:
-                            fzero = util.findZero(b, offset, length, defaultEnc);
-                            pic.format = util.decodeString(b.slice(offset, fzero), defaultEnc);
+                            fzero = util.findZero(uint8Array, offset, length, defaultEnc);
+                            pic.format = util.decodeString(uint8Array.slice(offset, fzero), defaultEnc);
                             offset = fzero + 1;
                             break;
                         default:
                             throw new Error('Warning: unexpected major versionIndex: ' + this.major);
                     }
                     pic.format = FrameParser.fixPictureMimeType(pic.format);
-                    pic.type = ID3v2Token_1.AttachedPictureType[b[offset]];
+                    pic.type = ID3v2Token_1.AttachedPictureType[uint8Array[offset]];
                     offset += 1;
-                    fzero = util.findZero(b, offset, length, encoding);
-                    pic.description = util.decodeString(b.slice(offset, fzero), encoding);
+                    fzero = util.findZero(uint8Array, offset, length, encoding);
+                    pic.description = util.decodeString(uint8Array.slice(offset, fzero), encoding);
                     offset = fzero + nullTerminatorLength;
-                    pic.data = Buffer.from(b.slice(offset, length));
+                    pic.data = Buffer.from(uint8Array.slice(offset, length));
                     output = pic;
                 }
                 break;
             case 'CNT':
             case 'PCNT':
-                output = Token.UINT32_BE.get(b, 0);
+                output = Token.UINT32_BE.get(uint8Array, 0);
                 break;
             case 'SYLT':
                 // skip text encoding (1 byte),
@@ -179,7 +179,7 @@ class FrameParser {
                 offset += 7;
                 output = [];
                 while (offset < length) {
-                    const txt = b.slice(offset, offset = util.findZero(b, offset, length, encoding));
+                    const txt = uint8Array.slice(offset, offset = util.findZero(uint8Array, offset, length, encoding));
                     offset += 5; // push offset forward one +  4 byte timestamp
                     output.push(util.decodeString(txt, encoding));
                 }
@@ -189,47 +189,47 @@ class FrameParser {
             case 'COM':
             case 'COMM':
                 offset += 1;
-                out.language = util.decodeString(b.slice(offset, offset + 3), defaultEnc);
+                out.language = util.decodeString(uint8Array.slice(offset, offset + 3), defaultEnc);
                 offset += 3;
-                fzero = util.findZero(b, offset, length, encoding);
-                out.description = util.decodeString(b.slice(offset, fzero), encoding);
+                fzero = util.findZero(uint8Array, offset, length, encoding);
+                out.description = util.decodeString(uint8Array.slice(offset, fzero), encoding);
                 offset = fzero + nullTerminatorLength;
-                out.text = util.decodeString(b.slice(offset, length), encoding).replace(/\x00+$/, '');
+                out.text = util.decodeString(uint8Array.slice(offset, length), encoding).replace(/\x00+$/, '');
                 output = [out];
                 break;
             case 'UFID':
-                output = FrameParser.readIdentifierAndData(b, offset, length, defaultEnc);
+                output = FrameParser.readIdentifierAndData(uint8Array, offset, length, defaultEnc);
                 output = { owner_identifier: output.id, identifier: output.data };
                 break;
             case 'PRIV': // private frame
-                output = FrameParser.readIdentifierAndData(b, offset, length, defaultEnc);
+                output = FrameParser.readIdentifierAndData(uint8Array, offset, length, defaultEnc);
                 output = { owner_identifier: output.id, data: output.data };
                 break;
             case 'POPM': // Popularimeter
-                fzero = util.findZero(b, offset, length, defaultEnc);
-                const email = util.decodeString(b.slice(offset, fzero), defaultEnc);
+                fzero = util.findZero(uint8Array, offset, length, defaultEnc);
+                const email = util.decodeString(uint8Array.slice(offset, fzero), defaultEnc);
                 offset = fzero + 1;
                 const dataLen = length - offset;
                 output = {
                     email,
-                    rating: b.readUInt8(offset),
-                    counter: dataLen >= 5 ? b.readUInt32BE(offset + 1) : undefined
+                    rating: Token.UINT8.get(uint8Array, offset),
+                    counter: dataLen >= 5 ? Token.UINT32_BE.get(uint8Array, offset + 1) : undefined
                 };
                 break;
             case 'GEOB': { // General encapsulated object
-                fzero = util.findZero(b, offset + 1, length, encoding);
-                const mimeType = util.decodeString(b.slice(offset + 1, fzero), defaultEnc);
+                fzero = util.findZero(uint8Array, offset + 1, length, encoding);
+                const mimeType = util.decodeString(uint8Array.slice(offset + 1, fzero), defaultEnc);
                 offset = fzero + 1;
-                fzero = util.findZero(b, offset, length - offset, encoding);
-                const filename = util.decodeString(b.slice(offset, fzero), defaultEnc);
+                fzero = util.findZero(uint8Array, offset, length - offset, encoding);
+                const filename = util.decodeString(uint8Array.slice(offset, fzero), defaultEnc);
                 offset = fzero + 1;
-                fzero = util.findZero(b, offset, length - offset, encoding);
-                const description = util.decodeString(b.slice(offset, fzero), defaultEnc);
+                fzero = util.findZero(uint8Array, offset, length - offset, encoding);
+                const description = util.decodeString(uint8Array.slice(offset, fzero), defaultEnc);
                 output = {
                     type: mimeType,
                     filename,
                     description,
-                    data: b.slice(offset + 1, length)
+                    data: uint8Array.slice(offset + 1, length)
                 };
                 break;
             }
@@ -243,23 +243,23 @@ class FrameParser {
             case 'WPAY':
             case 'WPUB':
                 // Decode URL
-                output = util.decodeString(b.slice(offset, fzero), defaultEnc);
+                output = util.decodeString(uint8Array.slice(offset, fzero), defaultEnc);
                 break;
             case 'WXXX': {
                 // Decode URL
-                fzero = util.findZero(b, offset + 1, length, encoding);
-                const description = util.decodeString(b.slice(offset + 1, fzero), encoding);
+                fzero = util.findZero(uint8Array, offset + 1, length, encoding);
+                const description = util.decodeString(uint8Array.slice(offset + 1, fzero), encoding);
                 offset = fzero + (encoding === 'utf16le' ? 2 : 1);
-                output = { description, url: util.decodeString(b.slice(offset, length), defaultEnc) };
+                output = { description, url: util.decodeString(uint8Array.slice(offset, length), defaultEnc) };
                 break;
             }
             case 'WFD':
             case 'WFED':
-                output = util.decodeString(b.slice(offset + 1, util.findZero(b, offset + 1, length, encoding)), encoding);
+                output = util.decodeString(uint8Array.slice(offset + 1, util.findZero(uint8Array, offset + 1, length, encoding)), encoding);
                 break;
             case 'MCDI': {
                 // Music CD identifier
-                output = b.slice(0, length);
+                output = uint8Array.slice(0, length);
                 break;
             }
             default:
@@ -316,11 +316,11 @@ class FrameParser {
     static trimArray(values) {
         return values.map(value => value.replace(/\x00+$/, '').trim());
     }
-    static readIdentifierAndData(b, offset, length, encoding) {
-        const fzero = util.findZero(b, offset, length, encoding);
-        const id = util.decodeString(b.slice(offset, fzero), encoding);
+    static readIdentifierAndData(uint8Array, offset, length, encoding) {
+        const fzero = util.findZero(uint8Array, offset, length, encoding);
+        const id = util.decodeString(uint8Array.slice(offset, fzero), encoding);
         offset = fzero + FrameParser.getNullTerminatorLength(encoding);
-        return { id, data: b.slice(offset, length) };
+        return { id, data: uint8Array.slice(offset, length) };
     }
     static getNullTerminatorLength(enc) {
         return enc === 'utf16le' ? 2 : 1;

package/lib/id3v2/ID3v2Parser.d.ts

@@ -1,9 +1,8 @@
-/// <reference types="node" />
 import { ITokenizer } from 'strtok3/lib/core';
 import { IOptions } from '../type';
 import { INativeMetadataCollector } from '../common/MetadataCollector';
 export declare class ID3v2Parser {
-    static removeUnsyncBytes(buffer: Buffer): Buffer;
+    static removeUnsyncBytes(buffer: Uint8Array): Uint8Array;
     private static getFrameHeaderLength;
     private static readFrameFlags;
     private static readFrameData;

package/lib/id3v2/ID3v2Parser.js

@@ -48,20 +48,20 @@ class ID3v2Parser {
             }
         };
     }
-    static readFrameData(buf, frameHeader, majorVer, includeCovers, warningCollector) {
+    static readFrameData(uint8Array, frameHeader, majorVer, includeCovers, warningCollector) {
         const frameParser = new FrameParser_1.FrameParser(majorVer, warningCollector);
         switch (majorVer) {
             case 2:
-                return frameParser.readData(buf, frameHeader.id, includeCovers);
+                return frameParser.readData(uint8Array, frameHeader.id, includeCovers);
             case 3:
             case 4:
                 if (frameHeader.flags.format.unsynchronisation) {
-                    buf = ID3v2Parser.removeUnsyncBytes(buf);
+                    uint8Array = ID3v2Parser.removeUnsyncBytes(uint8Array);
                 }
                 if (frameHeader.flags.format.data_length_indicator) {
-                    buf = buf.slice(4, buf.length);
+                    uint8Array = uint8Array.slice(4, uint8Array.length);
                 }
-                return frameParser.readData(buf, frameHeader.id, includeCovers);
+                return frameParser.readData(uint8Array, frameHeader.id, includeCovers);
             default:
                 throw new Error('Unexpected majorVer: ' + majorVer);
         }
@@ -93,14 +93,12 @@ class ID3v2Parser {
         return dataRemaining > 0 ? this.parseExtendedHeaderData(dataRemaining, extendedHeader.size) : this.parseId3Data(this.id3Header.size - extendedHeader.size);
     }
     async parseExtendedHeaderData(dataRemaining, extendedHeaderSize) {
-        const buffer = Buffer.alloc(dataRemaining);
-        await this.tokenizer.readBuffer(buffer, { length: dataRemaining });
+        await this.tokenizer.ignore(dataRemaining);
         return this.parseId3Data(this.id3Header.size - extendedHeaderSize);
     }
     async parseId3Data(dataLen) {
-        const buffer = Buffer.alloc(dataLen);
-        await this.tokenizer.readBuffer(buffer, { length: dataLen });
-        for (const tag of this.parseMetadata(buffer)) {
+        const uint8Array = await this.tokenizer.readToken(new Token.Uint8ArrayType(dataLen));
+        for (const tag of this.parseMetadata(uint8Array)) {
             if (tag.id === 'TXXX') {
                 if (tag.value) {
                     for (const text of tag.value.text) {
@@ -152,13 +150,13 @@ class ID3v2Parser {
         }
         return tags;
     }
-    readFrameHeader(v, majorVer) {
+    readFrameHeader(uint8Array, majorVer) {
         let header;
         switch (majorVer) {
             case 2:
                 header = {
-                    id: v.toString('ascii', 0, 3),
-                    length: Token.UINT24_BE.get(v, 3)
+                    id: Buffer.from(uint8Array.slice(0, 3)).toString('ascii'),
+                    length: Token.UINT24_BE.get(uint8Array, 3)
                 };
                 if (!header.id.match(/[A-Z0-9]{3}/g)) {
                     this.metadata.addWarning(`Invalid ID3v2.${this.id3Header.version.major} frame-header-ID: ${header.id}`);
@@ -167,9 +165,9 @@ class ID3v2Parser {
             case 3:
             case 4:
                 header = {
-                    id: v.toString('ascii', 0, 4),
-                    length: (majorVer === 4 ? ID3v2Token_1.UINT32SYNCSAFE : Token.UINT32_BE).get(v, 4),
-                    flags: ID3v2Parser.readFrameFlags(v.slice(8, 10))
+                    id: Buffer.from(uint8Array.slice(0, 4)).toString('ascii'),
+                    length: (majorVer === 4 ? ID3v2Token_1.UINT32SYNCSAFE : Token.UINT32_BE).get(uint8Array, 4),
+                    flags: ID3v2Parser.readFrameFlags(uint8Array.slice(8, 10))
                 };
                 if (!header.id.match(/[A-Z0-9]{4}/g)) {
                     this.metadata.addWarning(`Invalid ID3v2.${this.id3Header.version.major} frame-header-ID: ${header.id}`);

package/lib/id3v2/ID3v2Token.js

@@ -89,8 +89,8 @@ exports.ExtendedHeader = {
 };
 exports.TextEncodingToken = {
     len: 1,
-    get: (buf, off) => {
-        switch (buf.readUInt8(off)) {
+    get: (uint8Array, off) => {
+        switch (uint8Array[off]) {
             case 0x00:
                 return { encoding: 'latin1' }; // binary
             case 0x01:

package/lib/index.js

@@ -4,9 +4,9 @@ exports.ratingToStars = exports.orderTags = exports.parseFile = exports.parseStr
 const strtok3 = require("strtok3");
 const Core = require("./core");
 const ParserFactory_1 = require("./ParserFactory");
-const _debug = require("debug");
+const debug_1 = require("debug");
 const RandomFileReader_1 = require("./common/RandomFileReader");
-const debug = _debug("music-metadata:parser");
+const debug = (0, debug_1.default)("music-metadata:parser");
 var core_1 = require("./core");
 Object.defineProperty(exports, "parseFromTokenizer", { enumerable: true, get: function () { return core_1.parseFromTokenizer; } });
 Object.defineProperty(exports, "parseBuffer", { enumerable: true, get: function () { return core_1.parseBuffer; } });

package/lib/matroska/MatroskaParser.js

@@ -2,11 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MatroskaParser = void 0;
 const token_types_1 = require("token-types");
-const initDebug = require("debug");
+const debug_1 = require("debug");
 const BasicParser_1 = require("../common/BasicParser");
 const types_1 = require("./types");
 const matroskaDtd = require("./MatroskaDtd");
-const debug = initDebug('music-metadata:parser:matroska');
+const debug = (0, debug_1.default)('music-metadata:parser:matroska');
 /**
  * Extensible Binary Meta Language (EBML) parser
  * https://en.wikipedia.org/wiki/Extensible_Binary_Meta_Language

package/lib/mp4/Atom.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Atom = void 0;
-const initDebug = require("debug");
+const debug_1 = require("debug");
 const AtomToken = require("./AtomToken");
-const debug = initDebug('music-metadata:parser:MP4:Atom');
+const debug = (0, debug_1.default)('music-metadata:parser:MP4:Atom');
 class Atom {
     constructor(header, extended, parent) {
         this.header = header;

package/lib/mp4/AtomToken.js

@@ -2,9 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ChapterText = exports.StcoAtom = exports.StszAtom = exports.StscAtom = exports.SampleToChunkToken = exports.SttsAtom = exports.TimeToSampleToken = exports.SoundSampleDescriptionV0 = exports.SoundSampleDescriptionVersion = exports.StsdAtom = exports.TrackHeaderAtom = exports.NameAtom = exports.DataAtom = exports.MvhdAtom = exports.MdhdAtom = exports.FixedLengthAtom = exports.mhdr = exports.tkhd = exports.ftyp = exports.ExtendedSize = exports.Header = void 0;
 const Token = require("token-types");
-const initDebug = require("debug");
+const debug_1 = require("debug");
 const FourCC_1 = require("../common/FourCC");
-const debug = initDebug('music-metadata:parser:MP4:atom');
+const debug = (0, debug_1.default)('music-metadata:parser:MP4:atom');
 exports.Header = {
     len: 8,
     get: (buf, off) => {

package/lib/mp4/MP4Parser.js

@@ -1,14 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MP4Parser = void 0;
-const initDebug = require("debug");
+const debug_1 = require("debug");
 const Token = require("token-types");
 const BasicParser_1 = require("../common/BasicParser");
 const ID3v1Parser_1 = require("../id3v1/ID3v1Parser");
 const type_1 = require("../type");
 const Atom_1 = require("./Atom");
 const AtomToken = require("./AtomToken");
-const debug = initDebug('music-metadata:parser:MP4');
+const debug = (0, debug_1.default)('music-metadata:parser:MP4');
 const tagFormat = 'iTunes';
 const encoderDict = {
     raw: {

package/lib/mpeg/MpegParser.js

@@ -3,11 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MpegParser = void 0;
 const Token = require("token-types");
 const core_1 = require("strtok3/lib/core");
-const initDebug = require("debug");
+const debug_1 = require("debug");
 const common = require("../common/Util");
 const AbstractID3Parser_1 = require("../id3v2/AbstractID3Parser");
 const XingTag_1 = require("./XingTag");
-const debug = initDebug('music-metadata:parser:mpeg');
+const debug = (0, debug_1.default)('music-metadata:parser:mpeg');
 /**
  * Cache buffer size used for searching synchronization preabmle
  */

package/lib/musepack/index.js

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const initDebug = require("debug");
+const debug_1 = require("debug");
 const Token = require("token-types");
 const AbstractID3Parser_1 = require("../id3v2/AbstractID3Parser");
 const MpcSv8Parser_1 = require("./sv8/MpcSv8Parser");
 const MpcSv7Parser_1 = require("./sv7/MpcSv7Parser");
-const debug = initDebug('music-metadata:parser:musepack');
+const debug = (0, debug_1.default)('music-metadata:parser:musepack');
 class MusepackParser extends AbstractID3Parser_1.AbstractID3Parser {
     async postId3v2Parse() {
         const signature = await this.tokenizer.peekToken(new Token.StringType(3, 'binary'));

package/lib/musepack/sv7/MpcSv7Parser.js

@@ -1,12 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MpcSv7Parser = void 0;
-const initDebug = require("debug");
+const debug_1 = require("debug");
 const BasicParser_1 = require("../../common/BasicParser");
 const APEv2Parser_1 = require("../../apev2/APEv2Parser");
 const BitReader_1 = require("./BitReader");
 const SV7 = require("./StreamVersion7");
-const debug = initDebug('music-metadata:parser:musepack');
+const debug = (0, debug_1.default)('music-metadata:parser:musepack');
 class MpcSv7Parser extends BasicParser_1.BasicParser {
     constructor() {
         super(...arguments);

package/lib/musepack/sv8/MpcSv8Parser.js

@@ -1,12 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MpcSv8Parser = void 0;
-const initDebug = require("debug");
+const debug_1 = require("debug");
 const BasicParser_1 = require("../../common/BasicParser");
 const APEv2Parser_1 = require("../../apev2/APEv2Parser");
 const FourCC_1 = require("../../common/FourCC");
 const SV8 = require("./StreamVersion8");
-const debug = initDebug('music-metadata:parser:musepack');
+const debug = (0, debug_1.default)('music-metadata:parser:musepack');
 class MpcSv8Parser extends BasicParser_1.BasicParser {
     constructor() {
         super(...arguments);

package/lib/musepack/sv8/StreamVersion8.js

@@ -2,9 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StreamReader = void 0;
 const Token = require("token-types");
-const initDebug = require("debug");
+const debug_1 = require("debug");
 const util = require("../../common/Util");
-const debug = initDebug('music-metadata:parser:musepack:sv8');
+const debug = (0, debug_1.default)('music-metadata:parser:musepack:sv8');
 const PacketKey = new Token.StringType(2, 'binary');
 /**
  * Stream Header Packet part 1

package/lib/ogg/OggParser.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.OggParser = exports.SegmentTable = void 0;
 const Token = require("token-types");
 const core_1 = require("strtok3/lib/core");
-const initDebug = require("debug");
+const debug_1 = require("debug");
 const util = require("../common/Util");
 const FourCC_1 = require("../common/FourCC");
 const BasicParser_1 = require("../common/BasicParser");
@@ -11,7 +11,7 @@ const VorbisParser_1 = require("./vorbis/VorbisParser");
 const OpusParser_1 = require("./opus/OpusParser");
 const SpeexParser_1 = require("./speex/SpeexParser");
 const TheoraParser_1 = require("./theora/TheoraParser");
-const debug = initDebug('music-metadata:parser:ogg');
+const debug = (0, debug_1.default)('music-metadata:parser:ogg');
 class SegmentTable {
     constructor(header) {
         this.len = header.page_segments;

package/lib/ogg/speex/SpeexParser.js

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SpeexParser = void 0;
-const initDebug = require("debug");
+const debug_1 = require("debug");
 const VorbisParser_1 = require("../vorbis/VorbisParser");
 const Speex = require("./Speex");
-const debug = initDebug('music-metadata:parser:ogg:speex');
+const debug = (0, debug_1.default)('music-metadata:parser:ogg:speex');
 /**
  * Speex, RFC 5574
  * Ref:

package/lib/ogg/theora/TheoraParser.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TheoraParser = void 0;
-const initDebug = require("debug");
+const debug_1 = require("debug");
 const Theora_1 = require("./Theora");
-const debug = initDebug('music-metadata:parser:ogg:theora');
+const debug = (0, debug_1.default)('music-metadata:parser:ogg:theora');
 /**
  * Ref:
  * - https://theora.org/doc/Theora.pdf

package/lib/ogg/vorbis/VorbisParser.js

@@ -2,10 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VorbisParser = void 0;
 const Token = require("token-types");
-const _debug = require("debug");
+const debug_1 = require("debug");
 const VorbisDecoder_1 = require("./VorbisDecoder");
 const Vorbis_1 = require("./Vorbis");
-const debug = _debug('music-metadata:parser:ogg:vorbis1');
+const debug = (0, debug_1.default)('music-metadata:parser:ogg:vorbis1');
 /**
  * Vorbis 1 Parser.
  * Used by OggParser

package/lib/wav/WaveParser.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.WaveParser = void 0;
 const strtok3 = require("strtok3/lib/core");
 const Token = require("token-types");
-const initDebug = require("debug");
+const debug_1 = require("debug");
 const riff = require("../riff/RiffChunk");
 const WaveChunk = require("./../wav/WaveChunk");
 const ID3v2Parser_1 = require("../id3v2/ID3v2Parser");
@@ -11,7 +11,7 @@ const util = require("../common/Util");
 const FourCC_1 = require("../common/FourCC");
 const BasicParser_1 = require("../common/BasicParser");
 const BwfChunk_1 = require("../wav/BwfChunk");
-const debug = initDebug('music-metadata:parser:RIFF');
+const debug = (0, debug_1.default)('music-metadata:parser:RIFF');
 /**
  * Resource Interchange File Format (RIFF) Parser
  *

package/lib/wavpack/WavPackParser.js

@@ -6,8 +6,8 @@ const APEv2Parser_1 = require("../apev2/APEv2Parser");
 const FourCC_1 = require("../common/FourCC");
 const BasicParser_1 = require("../common/BasicParser");
 const WavPackToken_1 = require("./WavPackToken");
-const initDebug = require("debug");
-const debug = initDebug('music-metadata:parser:WavPack');
+const debug_1 = require("debug");
+const debug = (0, debug_1.default)('music-metadata:parser:WavPack');
 /**
  * WavPack Parser
  */

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": "7.12.0",
+  "version": "7.12.3",
   "author": {
     "name": "Borewit",
     "url": "https://github.com/Borewit"
@@ -86,10 +86,10 @@
   "dependencies": {
     "@tokenizer/token": "^0.3.0",
     "content-type": "^1.0.4",
-    "debug": "^4.3.3",
+    "debug": "^4.3.4",
     "file-type": "16.5.3",
     "media-typer": "^1.1.0",
-    "strtok3": "^6.2.4",
+    "strtok3": "^6.3.0",
     "token-types": "^4.2.0"
   },
   "devDependencies": {
@@ -98,27 +98,27 @@
     "@types/file-type": "^10.9.1",
     "@types/mocha": "^9.1.0",
     "@types/node": "^17.0.21",
-    "@typescript-eslint/eslint-plugin": "^5.12.1",
-    "@typescript-eslint/parser": "^5.12.1",
+    "@typescript-eslint/eslint-plugin": "^5.17.0",
+    "@typescript-eslint/parser": "^5.17.0",
     "chai": "^4.3.6",
     "coveralls": "^3.1.1",
     "del-cli": "4.0.1",
-    "eslint": "^8.9.0",
-    "eslint-config-prettier": "^8.4.0",
+    "eslint": "^8.12.0",
+    "eslint-config-prettier": "^8.5.0",
     "eslint-import-resolver-typescript": "^2.5.0",
     "eslint-plugin-import": "^2.25.4",
-    "eslint-plugin-jsdoc": "^37.9.4",
+    "eslint-plugin-jsdoc": "^38.1.4",
     "eslint-plugin-node": "^11.1.0",
     "eslint-plugin-unicorn": "^41.0.0",
     "mime": "^3.0.0",
-    "mocha": "^9.2.1",
+    "mocha": "^9.2.2",
     "npm-run-all": "^4.1.5",
     "nyc": "^15.1.0",
     "remark-cli": "^10.0.1",
     "remark-preset-lint-recommended": "^6.1.2",
     "source-map-support": "^0.5.21",
-    "ts-node": "^10.5.0",
-    "typescript": "^4.5.5"
+    "ts-node": "^10.7.0",
+    "typescript": "^4.6.2"
   },
   "engines": {
     "node": ">=10"