music-metadata 8.2.0 → 9.0.0

package/lib/common/Util.js

@@ -1,3 +1,4 @@
+import { StringType } from 'token-types';
 export function getBit(buf, off, bit) {
     return (buf[off] & (1 << bit)) !== 0;
 }
@@ -11,7 +12,7 @@ export function getBit(buf, off, bit) {
  */
 export function findZero(uint8Array, start, end, encoding) {
     let i = start;
-    if (encoding === 'utf16le') {
+    if (encoding === 'utf-16le') {
         while (uint8Array[i] !== 0 || uint8Array[i + 1] !== 0) {
             if (i >= end)
                 return end;
@@ -52,13 +53,13 @@ export function decodeString(uint8Array, encoding) {
     if (uint8Array[0] === 0xFF && uint8Array[1] === 0xFE) { // little endian
         return decodeString(uint8Array.subarray(2), encoding);
     }
-    else if (encoding === 'utf16le' && uint8Array[0] === 0xFE && uint8Array[1] === 0xFF) {
+    else if (encoding === 'utf-16le' && uint8Array[0] === 0xFE && uint8Array[1] === 0xFF) {
         // BOM, indicating big endian decoding
         if ((uint8Array.length & 1) !== 0)
             throw new Error('Expected even number of octets for 16-bit unicode string');
         return decodeString(swapBytes(uint8Array), encoding);
     }
-    return Buffer.from(uint8Array).toString(encoding);
+    return new StringType(uint8Array.length, encoding).get(uint8Array, 0);
 }
 export function stripNulls(str) {
     str = str.replace(/^\x00+/g, '');

package/lib/core.d.ts

@@ -1,16 +1,24 @@
-/// <reference types="node" resolution-mode="require"/>
-import { Readable } from 'stream';
-import * as strtok3 from 'strtok3/core';
-import { IAudioMetadata, INativeTagDict, IOptions, IPicture, IPrivateOptions, IRandomReader, ITag } from './type.js';
-export { IFileInfo } from 'strtok3/core';
+import * as strtok3 from 'strtok3';
+import type { IAudioMetadata, INativeTagDict, IOptions, IPicture, IPrivateOptions, IRandomReader, ITag } from './type.js';
+import type { ReadableStream as NodeReadableStream } from 'node:stream/web';
+export { IFileInfo } from 'strtok3';
+export type AnyWebStream<G> = NodeReadableStream<G> | ReadableStream<G>;
 /**
- * Parse audio from Node Stream.Readable
- * @param stream - Stream to read the audio track from
+ * Parse Web API File
+ * Requires Blob to be able to stream using a ReadableStreamBYOBReader, only available since Node.js ≥ 20
+ * @param blob - Blob to parse
+ * @param options - Parsing options
+ * @returns Metadata
+ */
+export declare function parseBlob(blob: Blob, options?: IOptions): Promise<IAudioMetadata>;
+/**
+ * Parse audio from Web Stream.Readable
+ * @param webStream - WebStream to read the audio track from
  * @param options - Parsing options
  * @param fileInfo - File information object or MIME-type string
  * @returns Metadata
  */
-export declare function parseStream(stream: Readable, fileInfo?: strtok3.IFileInfo | string, options?: IOptions): Promise<IAudioMetadata>;
+export declare function parseWebStream(webStream: AnyWebStream<Uint8Array>, fileInfo?: strtok3.IFileInfo | string, options?: IOptions): Promise<IAudioMetadata>;
 /**
  * Parse audio from Node Buffer
  * @param uint8Array - Uint8Array holding audio data

package/lib/core.js

@@ -1,18 +1,32 @@
-import * as strtok3 from 'strtok3/core';
+import * as strtok3 from 'strtok3';
 import { ParserFactory } from './ParserFactory.js';
 import { RandomUint8ArrayReader } from './common/RandomUint8ArrayReader.js';
 import { APEv2Parser } from './apev2/APEv2Parser.js';
 import { hasID3v1Header } from './id3v1/ID3v1Parser.js';
 import { getLyricsHeaderLength } from './lyrics3/Lyrics3.js';
 /**
- * Parse audio from Node Stream.Readable
- * @param stream - Stream to read the audio track from
+ * Parse Web API File
+ * Requires Blob to be able to stream using a ReadableStreamBYOBReader, only available since Node.js ≥ 20
+ * @param blob - Blob to parse
+ * @param options - Parsing options
+ * @returns Metadata
+ */
+export async function parseBlob(blob, options = {}) {
+    const fileInfo = { mimeType: blob.type, size: blob.size };
+    if (blob instanceof File) {
+        fileInfo.path = blob.name;
+    }
+    return parseWebStream(blob.stream(), fileInfo, options);
+}
+/**
+ * Parse audio from Web Stream.Readable
+ * @param webStream - WebStream to read the audio track from
  * @param options - Parsing options
  * @param fileInfo - File information object or MIME-type string
  * @returns Metadata
  */
-export function parseStream(stream, fileInfo, options = {}) {
-    return parseFromTokenizer(strtok3.fromStream(stream, typeof fileInfo === 'string' ? { mimeType: fileInfo } : fileInfo), options);
+export function parseWebStream(webStream, fileInfo, options = {}) {
+    return parseFromTokenizer(strtok3.fromWebStream(webStream, typeof fileInfo === 'string' ? { mimeType: fileInfo } : fileInfo), options);
 }
 /**
  * Parse audio from Node Buffer

package/lib/dsdiff/DsdiffParser.js

@@ -1,6 +1,6 @@
 import * as Token from 'token-types';
 import initDebug from 'debug';
-import * as strtok3 from 'strtok3/core';
+import * as strtok3 from 'strtok3';
 import { FourCcToken } from '../common/FourCC.js';
 import { BasicParser } from '../common/BasicParser.js';
 import { ID3v2Parser } from '../id3v2/ID3v2Parser.js';

package/lib/dsdiff/DsdiffToken.d.ts

@@ -1,4 +1,4 @@
-import { IGetToken } from 'strtok3/core';
+import type { IGetToken } from 'strtok3';
 import { IChunkHeader64 } from '../iff/index.js';
 export { IChunkHeader64 } from '../iff/index.js';
 /**

package/lib/dsf/DsfChunk.d.ts

@@ -1,4 +1,4 @@
-import { IGetToken } from 'strtok3/core';
+import type { IGetToken } from 'strtok3';
 /**
  * Common interface for the common chunk DSD header
  */

package/lib/flac/FlacParser.d.ts

@@ -1,4 +1,4 @@
-import { ITokenizer } from 'strtok3/core';
+import type { ITokenizer } from 'strtok3';
 import { AbstractID3Parser } from '../id3v2/AbstractID3Parser.js';
 import { INativeMetadataCollector } from '../common/MetadataCollector.js';
 import { IOptions } from '../type.js';

package/lib/flac/FlacParser.js

@@ -54,7 +54,7 @@ export class FlacParser extends AbstractID3Parser {
             this.metadata.setFormat('bitrate', 8 * dataSize / this.metadata.format.duration);
         }
     }
-    parseDataBlock(blockHeader) {
+    async parseDataBlock(blockHeader) {
         debug(`blockHeader type=${blockHeader.type}, length=${blockHeader.length}`);
         switch (blockHeader.type) {
             case BlockType.STREAMINFO:
@@ -71,7 +71,8 @@ export class FlacParser extends AbstractID3Parser {
             case BlockType.CUESHEET:
                 break;
             case BlockType.PICTURE:
-                return this.parsePicture(blockHeader.length).then();
+                await this.parsePicture(blockHeader.length);
+                return;
             default:
                 this.metadata.addWarning('Unknown block type: ' + blockHeader.type);
         }
@@ -104,10 +105,11 @@ export class FlacParser extends AbstractID3Parser {
         const decoder = new VorbisDecoder(data, 0);
         decoder.readStringUtf8(); // vendor (skip)
         const commentListLength = decoder.readInt32();
+        const tags = new Array(commentListLength);
         for (let i = 0; i < commentListLength; i++) {
-            const tag = decoder.parseUserComment();
-            this.vorbisParser.addTag(tag.key, tag.value);
+            tags[i] = decoder.parseUserComment();
         }
+        await Promise.all(tags.map(tag => this.vorbisParser.addTag(tag.key, tag.value)));
     }
     async parsePicture(dataLen) {
         if (this.options.skipCovers) {

package/lib/id3v1/ID3v1Parser.js

@@ -68,7 +68,7 @@ const Iid3v1Token = {
 };
 class Id3v1StringType extends StringType {
     constructor(len) {
-        super(len, 'binary');
+        super(len, 'latin1');
     }
     get(buf, off) {
         let value = super.get(buf, off);
@@ -105,25 +105,25 @@ export class ID3v1Parser extends BasicParser {
             debug('ID3v1 header found at: pos=%s', this.tokenizer.fileInfo.size - Iid3v1Token.len);
             for (const id of ['title', 'artist', 'album', 'comment', 'track', 'year']) {
                 if (header[id] && header[id] !== '')
-                    this.addTag(id, header[id]);
+                    await this.addTag(id, header[id]);
             }
             const genre = ID3v1Parser.getGenre(header.genre);
             if (genre)
-                this.addTag('genre', genre);
+                await this.addTag('genre', genre);
         }
         else {
             debug('ID3v1 header not found at: pos=%s', this.tokenizer.fileInfo.size - Iid3v1Token.len);
         }
     }
-    addTag(id, value) {
-        this.metadata.addTag('ID3v1', id, value);
+    async addTag(id, value) {
+        await this.metadata.addTag('ID3v1', id, value);
     }
 }
 export async function hasID3v1Header(reader) {
     if (reader.fileSize >= 128) {
         const tag = Buffer.alloc(3);
         await reader.randomRead(tag, 0, tag.length, reader.fileSize - 128);
-        return tag.toString('binary') === 'TAG';
+        return tag.toString('latin1') === 'TAG';
     }
     return false;
 }

package/lib/id3v2/AbstractID3Parser.d.ts

@@ -1,4 +1,4 @@
-import { ITokenizer } from 'strtok3/core';
+import { ITokenizer } from 'strtok3';
 import { BasicParser } from '../common/BasicParser.js';
 /**
  * Abstract parser which tries take ID3v2 and ID3v1 headers.

package/lib/id3v2/AbstractID3Parser.js

@@ -1,4 +1,4 @@
-import { EndOfStreamError } from 'strtok3/core';
+import { EndOfStreamError } from 'strtok3';
 import initDebug from 'debug';
 import { ID3v2Header } from './ID3v2Token.js';
 import { ID3v2Parser } from './ID3v2Parser.js';

package/lib/id3v2/FrameParser.js

@@ -79,6 +79,7 @@ export class FrameParser {
         debug(`Parsing tag type=${type}, encoding=${encoding}, bom=${bom}`);
         switch (type !== 'TXXX' && type[0] === 'T' ? 'T*' : type) {
             case 'T*': // 4.2.1. Text information frames - details
+            case 'GRP1': // iTunes-specific ID3v2 grouping field
             case 'IPLS': // v2.3: Involved people list
             case 'MVIN':
             case 'MVNM':
@@ -158,7 +159,7 @@ export class FrameParser {
                     fzero = util.findZero(uint8Array, offset, length, encoding);
                     pic.description = util.decodeString(uint8Array.slice(offset, fzero), encoding);
                     offset = fzero + nullTerminatorLength;
-                    pic.data = Buffer.from(uint8Array.slice(offset, length));
+                    pic.data = uint8Array.slice(offset, length);
                     output = pic;
                 }
                 break;
@@ -245,7 +246,7 @@ export class FrameParser {
                 // Decode URL
                 fzero = util.findZero(uint8Array, offset + 1, length, encoding);
                 const description = util.decodeString(uint8Array.slice(offset + 1, fzero), encoding);
-                offset = fzero + (encoding === 'utf16le' ? 2 : 1);
+                offset = fzero + (encoding === 'utf-16le' ? 2 : 1);
                 output = { description, url: util.decodeString(uint8Array.slice(offset, length), defaultEnc) };
                 break;
             }
@@ -319,6 +320,6 @@ export class FrameParser {
         return { id, data: uint8Array.slice(offset, length) };
     }
     static getNullTerminatorLength(enc) {
-        return enc === 'utf16le' ? 2 : 1;
+        return enc === 'utf-16le' ? 2 : 1;
     }
 }

package/lib/id3v2/ID3v24TagMapper.d.ts

@@ -1,6 +1,6 @@
 import { CaseInsensitiveTagMap } from '../common/CaseInsensitiveTagMap.js';
-import { INativeMetadataCollector } from '../common/MetadataCollector.js';
-import { IRating, ITag } from '../type.js';
+import type { INativeMetadataCollector } from '../common/MetadataCollector.js';
+import type { IRating, ITag } from '../type.js';
 export declare class ID3v24TagMapper extends CaseInsensitiveTagMap {
     static toRating(popm: any): IRating;
     constructor();
@@ -8,7 +8,6 @@ export declare class ID3v24TagMapper extends CaseInsensitiveTagMap {
      * Handle post mapping exceptions / correction
      * @param tag to post map
      * @param warnings Wil be used to register (collect) warnings
-     * @return Common value e.g. "Buena Vista Social Club"
      */
     protected postMap(tag: ITag, warnings: INativeMetadataCollector): void;
 }

package/lib/id3v2/ID3v24TagMapper.js

@@ -1,6 +1,7 @@
+import { UINT32_LE } from 'token-types';
 import { CommonTagMapper } from '../common/GenericTagMapper.js';
 import { CaseInsensitiveTagMap } from '../common/CaseInsensitiveTagMap.js';
-import * as util from '../common/Util.js';
+import { decodeString } from '../common/Util.js';
 /**
  * ID3v2.3/ID3v2.4 tag mappings
  */
@@ -11,7 +12,7 @@ const id3v24TagMap = {
     'TXXX:Artists': 'artists',
     TPE2: 'albumartist',
     TALB: 'album',
-    TDRV: 'date',
+    TDRV: 'date', // [ 'date', 'year' ] ToDo: improve 'year' mapping
     /**
      * Original release year
      */
@@ -20,7 +21,7 @@ const id3v24TagMap = {
     TCON: 'genre',
     APIC: 'picture',
     TCOM: 'composer',
-    'USLT:description': 'lyrics',
+    USLT: 'lyrics',
     TSOA: 'albumsort',
     TSOT: 'titlesort',
     TOAL: 'originalalbum',
@@ -84,7 +85,7 @@ const id3v24TagMap = {
     WOAR: 'website',
     // id3v2.4
     // ToDo: In same sequence as defined at http://id3.org/id3v2.4.0-frames
-    TDRC: 'date',
+    TDRC: 'date', // date YYYY-MM-DD
     TYER: 'year',
     TDOR: 'originaldate',
     // 'TMCL:instrument': 'performer:instrument',
@@ -135,7 +136,8 @@ const id3v24TagMap = {
     TDRL: 'releasedate',
     TGID: 'podcastId',
     TKWD: 'keywords',
-    WFED: 'podcasturl'
+    WFED: 'podcasturl',
+    GRP1: 'grouping'
 };
 export class ID3v24TagMapper extends CaseInsensitiveTagMap {
     static toRating(popm) {
@@ -151,14 +153,14 @@ export class ID3v24TagMapper extends CaseInsensitiveTagMap {
      * Handle post mapping exceptions / correction
      * @param tag to post map
      * @param warnings Wil be used to register (collect) warnings
-     * @return Common value e.g. "Buena Vista Social Club"
      */
     postMap(tag, warnings) {
+        var _a, _b;
         switch (tag.id) {
             case 'UFID': // decode MusicBrainz Recording Id
                 if (tag.value.owner_identifier === 'http://musicbrainz.org') {
                     tag.id += ':' + tag.value.owner_identifier;
-                    tag.value = util.decodeString(tag.value.identifier, 'latin1'); // latin1 == iso-8859-1
+                    tag.value = decodeString(tag.value.identifier, 'latin1'); // latin1 == iso-8859-1
                 }
                 break;
             case 'PRIV':
@@ -167,7 +169,7 @@ export class ID3v24TagMapper extends CaseInsensitiveTagMap {
                     case 'AverageLevel':
                     case 'PeakValue':
                         tag.id += ':' + tag.value.owner_identifier;
-                        tag.value = tag.value.data.length === 4 ? tag.value.data.readUInt32LE(0) : null;
+                        tag.value = tag.value.data.length === 4 ? UINT32_LE.get(tag.value.data, 0) : null;
                         if (tag.value === null) {
                             warnings.addWarning(`Failed to parse PRIV:PeakValue`);
                         }
@@ -177,11 +179,14 @@ export class ID3v24TagMapper extends CaseInsensitiveTagMap {
                 }
                 break;
             case 'COMM':
-                tag.value = tag.value ? tag.value.text : null;
+                tag.value = (_a = tag.value) === null || _a === void 0 ? void 0 : _a.text;
                 break;
             case 'POPM':
                 tag.value = ID3v24TagMapper.toRating(tag.value);
                 break;
+            case 'USLT':
+                tag.value = (_b = tag.value) === null || _b === void 0 ? void 0 : _b.text;
+                break;
             default:
                 break;
         }

package/lib/id3v2/ID3v2Parser.d.ts

@@ -1,4 +1,4 @@
-import { ITokenizer } from 'strtok3/core';
+import type { ITokenizer } from 'strtok3';
 import { IOptions } from '../type.js';
 import { INativeMetadataCollector } from '../common/MetadataCollector.js';
 export declare class ID3v2Parser {

package/lib/id3v2/ID3v2Parser.js

@@ -2,6 +2,7 @@ import * as Token from 'token-types';
 import * as util from '../common/Util.js';
 import { FrameParser } from './FrameParser.js';
 import { ExtendedHeader, ID3v2Header, UINT32SYNCSAFE } from './ID3v2Token.js';
+const asciiDecoder = new TextDecoder('ascii');
 export class ID3v2Parser {
     static removeUnsyncBytes(buffer) {
         let readI = 0;
@@ -98,33 +99,25 @@ export class ID3v2Parser {
         for (const tag of this.parseMetadata(uint8Array)) {
             if (tag.id === 'TXXX') {
                 if (tag.value) {
-                    for (const text of tag.value.text) {
-                        this.addTag(ID3v2Parser.makeDescriptionTagName(tag.id, tag.value.description), text);
-                    }
+                    await Promise.all(tag.value.text.map(text => this.addTag(ID3v2Parser.makeDescriptionTagName(tag.id, tag.value.description), text)));
                 }
             }
             else if (tag.id === 'COM') {
-                for (const value of tag.value) {
-                    this.addTag(ID3v2Parser.makeDescriptionTagName(tag.id, value.description), value.text);
-                }
+                await Promise.all(tag.value.map(value => this.addTag(ID3v2Parser.makeDescriptionTagName(tag.id, value.description), value.text)));
             }
             else if (tag.id === 'COMM') {
-                for (const value of tag.value) {
-                    this.addTag(ID3v2Parser.makeDescriptionTagName(tag.id, value.description), value);
-                }
+                await Promise.all(tag.value.map(value => this.addTag(ID3v2Parser.makeDescriptionTagName(tag.id, value.description), value)));
             }
             else if (Array.isArray(tag.value)) {
-                for (const value of tag.value) {
-                    this.addTag(tag.id, value);
-                }
+                await Promise.all(tag.value.map(value => this.addTag(tag.id, value)));
             }
             else {
-                this.addTag(tag.id, tag.value);
+                await this.addTag(tag.id, tag.value);
             }
         }
     }
-    addTag(id, value) {
-        this.metadata.addTag(this.headerType, id, value);
+    async addTag(id, value) {
+        await this.metadata.addTag(this.headerType, id, value);
     }
     parseMetadata(data) {
         let offset = 0;
@@ -152,7 +145,7 @@ export class ID3v2Parser {
         switch (majorVer) {
             case 2:
                 header = {
-                    id: Buffer.from(uint8Array.slice(0, 3)).toString('ascii'),
+                    id: asciiDecoder.decode(uint8Array.slice(0, 3)),
                     length: Token.UINT24_BE.get(uint8Array, 3)
                 };
                 if (!header.id.match(/[A-Z0-9]{3}/g)) {
@@ -162,7 +155,7 @@ export class ID3v2Parser {
             case 3:
             case 4:
                 header = {
-                    id: Buffer.from(uint8Array.slice(0, 4)).toString('ascii'),
+                    id: asciiDecoder.decode(uint8Array.slice(0, 4)),
                     length: (majorVer === 4 ? UINT32SYNCSAFE : Token.UINT32_BE).get(uint8Array, 4),
                     flags: ID3v2Parser.readFrameFlags(uint8Array.slice(8, 10))
                 };

package/lib/id3v2/ID3v2Token.d.ts

@@ -1,4 +1,4 @@
-import { IGetToken } from 'strtok3/core';
+import type { IGetToken } from 'strtok3';
 import * as util from '../common/Util.js';
 /**
  * The picture type according to the ID3v2 APIC frame

package/lib/id3v2/ID3v2Token.js

@@ -91,9 +91,9 @@ export const TextEncodingToken = {
             case 0x00:
                 return { encoding: 'latin1' }; // binary
             case 0x01:
-                return { encoding: 'utf16le', bom: true };
+                return { encoding: 'utf-16le', bom: true };
             case 0x02:
-                return { encoding: 'utf16le', bom: false };
+                return { encoding: 'utf-16le', bom: false };
             case 0x03:
                 return { encoding: 'utf8', bom: false };
             default:

package/lib/iff/index.d.ts

@@ -1,4 +1,4 @@
-import { IGetToken } from 'strtok3/core';
+import type { IGetToken } from 'strtok3';
 /**
  * "EA IFF 85" Standard for Interchange Format Files
  * Ref: http://www.martinreddy.net/gfx/2d/IFF.txt

package/lib/index.d.ts

@@ -1,9 +1,8 @@
-/// <reference types="node" resolution-mode="require"/>
 import * as Stream from 'stream';
 import * as strtok3 from 'strtok3';
 import { IAudioMetadata, IOptions } from './type.js';
 export { IAudioMetadata, IOptions, ITag, INativeTagDict, ICommonTagsResult, IFormat, IPicture, IRatio, IChapter } from './type.js';
-export { parseFromTokenizer, parseBuffer, selectCover, orderTags, ratingToStars, IFileInfo } from './core.js';
+export { parseFromTokenizer, parseBuffer, parseBlob, selectCover, orderTags, ratingToStars, IFileInfo } from './core.js';
 /**
  * Parse audio from Node Stream.Readable
  * @param stream - Stream to read the audio track from

package/lib/index.js

@@ -3,7 +3,7 @@ import initDebug from 'debug';
 import { parseFromTokenizer, scanAppendingHeaders } from './core.js';
 import { ParserFactory } from './ParserFactory.js';
 import { RandomFileReader } from './common/RandomFileReader.js';
-export { parseFromTokenizer, parseBuffer, selectCover, orderTags, ratingToStars } from './core.js';
+export { parseFromTokenizer, parseBuffer, parseBlob, selectCover, orderTags, ratingToStars } from './core.js';
 const debug = initDebug('music-metadata:parser');
 /**
  * Parse audio from Node Stream.Readable

package/lib/lyrics3/Lyrics3.js

@@ -3,7 +3,7 @@ export async function getLyricsHeaderLength(reader) {
     if (reader.fileSize >= 143) {
         const buf = Buffer.alloc(15);
         await reader.randomRead(buf, 0, buf.length, reader.fileSize - 143);
-        const txt = buf.toString('binary');
+        const txt = buf.toString('latin1');
         const tag = txt.substr(6);
         if (tag === endTag2) {
             return parseInt(txt.substr(0, 6), 10) + 15;

package/lib/matroska/MatroskaDtd.js

@@ -9,12 +9,12 @@ export const elements = {
     0x1a45dfa3: {
         name: 'ebml',
         container: {
-            0x4286: { name: 'ebmlVersion', value: DataType.uint },
-            0x42f7: { name: 'ebmlReadVersion', value: DataType.uint },
-            0x42f2: { name: 'ebmlMaxIDWidth', value: DataType.uint },
-            0x42f3: { name: 'ebmlMaxSizeWidth', value: DataType.uint },
-            0x4282: { name: 'docType', value: DataType.string },
-            0x4287: { name: 'docTypeVersion', value: DataType.uint },
+            0x4286: { name: 'ebmlVersion', value: DataType.uint }, // 5.1.1
+            0x42f7: { name: 'ebmlReadVersion', value: DataType.uint }, // 5.1.2
+            0x42f2: { name: 'ebmlMaxIDWidth', value: DataType.uint }, // 5.1.3
+            0x42f3: { name: 'ebmlMaxSizeWidth', value: DataType.uint }, // 5.1.4
+            0x4282: { name: 'docType', value: DataType.string }, // 5.1.5
+            0x4287: { name: 'docTypeVersion', value: DataType.uint }, // 5.1.6
             0x4285: { name: 'docTypeReadVersion', value: DataType.uint } // 5.1.7
         }
     },
@@ -77,7 +77,7 @@ export const elements = {
                             0x83: { name: 'trackType', value: DataType.uint },
                             0xb9: { name: 'flagEnabled', value: DataType.bool },
                             0x88: { name: 'flagDefault', value: DataType.bool },
-                            0x55aa: { name: 'flagForced', value: DataType.bool },
+                            0x55aa: { name: 'flagForced', value: DataType.bool }, // extended
                             0x9c: { name: 'flagLacing', value: DataType.bool },
                             0x6de7: { name: 'minCache', value: DataType.uint },
                             0x6de8: { name: 'maxCache', value: DataType.uint },
@@ -114,7 +114,7 @@ export const elements = {
                                 container: {
                                     0xb5: { name: 'samplingFrequency', value: DataType.float },
                                     0x78b5: { name: 'outputSamplingFrequency', value: DataType.float },
-                                    0x9f: { name: 'channels', value: DataType.uint },
+                                    0x9f: { name: 'channels', value: DataType.uint }, // https://www.matroska.org/technical/specs/index.html
                                     0x94: { name: 'channels', value: DataType.uint },
                                     0x7d7b: { name: 'channelPositions', value: DataType.binary },
                                     0x6264: { name: 'bitDepth', value: DataType.uint }
@@ -250,8 +250,8 @@ export const elements = {
                                     0x63c5: { name: 'tagTrackUID', value: DataType.uid },
                                     0x63c4: { name: 'tagChapterUID', value: DataType.uint },
                                     0x63c6: { name: 'tagAttachmentUID', value: DataType.uid },
-                                    0x63ca: { name: 'targetType', value: DataType.string },
-                                    0x68ca: { name: 'targetTypeValue', value: DataType.uint },
+                                    0x63ca: { name: 'targetType', value: DataType.string }, // extended
+                                    0x68ca: { name: 'targetTypeValue', value: DataType.uint }, // extended
                                     0x63c9: { name: 'tagEditionUID', value: DataType.uid } // extended
                                 }
                             },
@@ -262,8 +262,8 @@ export const elements = {
                                     0x45a3: { name: 'name', value: DataType.string },
                                     0x4487: { name: 'string', value: DataType.string },
                                     0x4485: { name: 'binary', value: DataType.binary },
-                                    0x447a: { name: 'language', value: DataType.string },
-                                    0x447b: { name: 'languageIETF', value: DataType.string },
+                                    0x447a: { name: 'language', value: DataType.string }, // extended
+                                    0x447b: { name: 'languageIETF', value: DataType.string }, // extended
                                     0x4484: { name: 'default', value: DataType.bool } // extended
                                 }
                             }

package/lib/matroska/MatroskaParser.d.ts

@@ -1,4 +1,4 @@
-import { ITokenizer } from 'strtok3/core';
+import type { ITokenizer } from 'strtok3';
 import { INativeMetadataCollector } from '../common/MetadataCollector.js';
 import { BasicParser } from '../common/BasicParser.js';
 import { IOptions } from '../type.js';

package/lib/matroska/MatroskaParser.js

@@ -44,7 +44,7 @@ export class MatroskaParser extends BasicParser {
                 const timecodeScale = info.timecodeScale ? info.timecodeScale : 1000000;
                 if (typeof info.duration === 'number') {
                     const duration = info.duration * timecodeScale / 1000000000;
-                    this.addTag('segment:title', info.title);
+                    await this.addTag('segment:title', info.title);
                     this.metadata.setFormat('duration', duration);
                 }
             }
@@ -87,28 +87,24 @@ export class MatroskaParser extends BasicParser {
                     this.metadata.setFormat('numberOfChannels', audioTrack.audio.channels);
                 }
                 if (matroska.segment.tags) {
-                    matroska.segment.tags.tag.forEach(tag => {
+                    await Promise.all(matroska.segment.tags.tag.map(async (tag) => {
                         const target = tag.target;
                         const targetType = (target === null || target === void 0 ? void 0 : target.targetTypeValue) ? TargetType[target.targetTypeValue] : ((target === null || target === void 0 ? void 0 : target.targetType) ? target.targetType : 'track');
-                        tag.simpleTags.forEach(simpleTag => {
+                        await Promise.all(tag.simpleTags.map(async (simpleTag) => {
                             const value = simpleTag.string ? simpleTag.string : simpleTag.binary;
-                            this.addTag(`${targetType}:${simpleTag.name}`, value);
-                        });
-                    });
+                            await this.addTag(`${targetType}:${simpleTag.name}`, value);
+                        }));
+                    }));
                 }
                 if (matroska.segment.attachments) {
-                    matroska.segment.attachments.attachedFiles
+                    await Promise.all(matroska.segment.attachments.attachedFiles
                         .filter(file => file.mimeType.startsWith('image/'))
-                        .map(file => {
-                        return {
-                            data: file.data,
-                            format: file.mimeType,
-                            description: file.description,
-                            name: file.name
-                        };
-                    }).forEach(picture => {
-                        this.addTag('picture', picture);
-                    });
+                        .map(file => this.addTag('picture', {
+                        data: file.data,
+                        format: file.mimeType,
+                        description: file.description,
+                        name: file.name
+                    })));
                 }
             }
         }
@@ -220,14 +216,14 @@ export class MatroskaParser extends BasicParser {
     }
     async readString(e) {
         const rawString = await this.tokenizer.readToken(new StringType(e.len, 'utf-8'));
-        return rawString.replace(/\00.*$/g, '');
+        return rawString.replace(/\x00.*$/g, '');
     }
     async readBuffer(e) {
         const buf = Buffer.alloc(e.len);
         await this.tokenizer.readBuffer(buf);
         return buf;
     }
-    addTag(tagId, value) {
-        this.metadata.addTag('matroska', tagId, value);
+    async addTag(tagId, value) {
+        await this.metadata.addTag('matroska', tagId, value);
     }
 }

package/lib/matroska/types.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" resolution-mode="require"/>
 export interface IHeader {
     id: number;
     len: number;