music-metadata 11.16.1 → 12.1.0

package/README.md

@@ -23,12 +23,12 @@ The [`music-metadata`](https://github.com/Borewit/music-metadata) module is idea
 ## Compatibility
 
 Module: version 8 migrated from [CommonJS](https://en.wikipedia.org/wiki/CommonJS) to [pure ECMAScript Module (ESM)](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c).
-The distributed JavaScript codebase is compliant with the [ECMAScript 2020 (11th Edition)](https://en.wikipedia.org/wiki/ECMAScript_version_history#11th_Edition_%E2%80%93_ECMAScript_2020) standard.
+The distributed JavaScript codebase targets [ECMAScript 2023 (14th Edition)](https://262.ecma-international.org/14.0/).
 
 > [!NOTE]
 > See also [CommonJS backward Compatibility](#commonjs-backward-compatibility)
 
-This module requires a [Node.js ≥ 18](https://nodejs.org/en/about/previous-releases) engine.
+This module requires a [Node.js ≥ 22](https://nodejs.org/en/about/previous-releases) engine.
 It can also be used in a browser environment when bundled with a module bundler.
 
 ## Support the Project
@@ -99,11 +99,12 @@ Support for encoding / format details:
 
 
 ## Online demo's
-- [<img src="https://raw.githubusercontent.com/Borewit/audio-tag-analyzer/master/src/assets/icon/audio-tag-analyzer.svg" width="40">Audio Tag Analyzer](https://audio-tag-analyzer.netlify.app/)
-- [<img src="https://cdn.sanity.io/images/3do82whm/next/ba8c847f13a5fa39d88f8bc9b7846b7886531b18-2500x2500.svg" width="40"> Webamp](https://webamp.org/)
+- [<img src="https://raw.githubusercontent.com/Borewit/audio-tag-analyzer-vite/master/public/favicon.svg" width="40" alt="Audio Tag Analyzer logo"> Audio Tag Analyzer](https://audio-tag-analyzer.netlify.app/) ([source code](https://github.com/Borewit/audio-tag-analyzer-vite))
 - [ICY Radio Stream Player](https://icy-radio-stream-player.netlify.app/)
 - Expected to be released soon: [Overtone](https://overtone.pro/) by [Johannes Schickling](https://github.com/schickling)
 
+Used by [around 50k+ GitHub projects](https://github.com/Borewit/music-metadata/network/dependents).
+
 ## Usage
 
 ### Installation
@@ -605,7 +606,10 @@ Returns a list of supported MIME-types. This may include some MIME-types which a
   only that the parser will attempt to calculate it when possible, even if it requires reading the full file.
 
 - `includeChapters`: `boolean` (default: `false`)
-  When `true`, the MP4 parser scans the `mdat` atom for chapters.
+  When `true`, the MP4 parser reads QuickTime chapter tracks and Nero `chpl` chapter lists.
+  A usable QuickTime chapter track takes precedence over a Nero list.
+  Files, buffers, and Blobs support chapters whether `moov` appears before or after `mdat`.
+  For forward-only streams, `moov` must appear before the chapter data.
 
 - `mkvUseIndex`: `boolean` (default: `false`)
 
@@ -664,45 +668,84 @@ Audio format information. Defined in the TypeScript `IFormat` interface:
 
 #### `metadata.format.trackInfo`
 
-Containers such as Matroska and MPEG-4 can contain multiple audio and video tracks.
-The experimental `metadata.format.trackInfo` property describes these individual tracks.
+`metadata.format.trackInfo` provides the same track abstraction for single-stream audio files and
+multi-track containers (MPEG-4, Matroska, ASF, and Ogg). Tracks can carry audio, video, subtitles, or
+metadata. Import `TrackType` from `music-metadata` to select tracks without knowing the container:
+
+```js
+import { parseFile, TrackType } from 'music-metadata';
+
+const { format } = await parseFile('movie.mp4');
+const audioTracks = format.trackInfo.filter(track => track.type === TrackType.audio);
+const videoTracks = format.trackInfo.filter(track => track.type === TrackType.video);
+```
+
+Each entry describes one discovered track. The order follows container discovery and does not identify
+a preferred track; use `type`, container flags, and language to choose one. In MPEG-4, the codec and
+media properties describe the first sample description, even when the track has multiple sample descriptions. In Ogg, entries describe
+logical media streams; Skeleton headers do not create media tracks. Single-stream audio parsers map
+their format properties to one audio track after parsing.
+
+Properties are optional when unavailable and are not copied between tracks. In particular, a container
+or summary bitrate is not a per-track bitrate. MPEG-4 track timing comes from media headers (or parsed
+audio fragments), and track bitrates from sample sizes and duration. ASF supplies audio/video stream
+properties and stream bitrates from both standalone and nested Stream Properties Objects. Codec List
+entries supply names for matching streams; unused codecs do not create tracks. Matroska applies
+specified defaults for flags, language, channels, and sample rate, and prefers IETF language tags when present. Video duration/bitrate coverage and overall
+video statistics remain incomplete. The existing `format` fields retain their summary semantics.
+
+For Ogg/Opus, the per-track average bitrate uses the logical stream's payload bytes, including codec
+headers and excluding Ogg framing and other streams. It requires the logical stream's end-of-stream
+(EOS) page and a known duration; reaching input EOF alone is insufficient. Set `duration: true` to
+allow scanning when needed. The summary `format.bitrate` retains
+its existing file-size estimate and can differ from the per-track bitrate. Vorbis and Speex use nominal
+bitrates when their headers provide them.
 
 `metadata.format.trackInfo` is an array of [trackInfo](#trackinfo) objects, empty when no track information is available.
 
 ##### trackInfo
 
 Individual track information. Defined in the TypeScript `ITrackInfo` interface:
-- `trackInfo.type?: TrackType` Track type
+- `trackInfo.id?: number` Container track ID/number, or Ogg stream serial number; only meaningful within the file
+- `trackInfo.type?: TrackType` Track type (`audio`, `video`, `subtitle`, `metadata`, or other known types)
+- `trackInfo.codecId?: string` Container-specific codec identifier, such as `mp4a`, `A_AAC`, or ASF audio format tag `0x0161`
 - `trackInfo.codecName?: string` Codec name
+- `trackInfo.codecProfile?: string` Codec profile
+- `trackInfo.duration?: number` Track duration in seconds
+- `trackInfo.bitrate?: number` Encoded track bitrate in bits per second
+- `trackInfo.lossless?: boolean` Whether the track uses lossless compression
 - `trackInfo.codecSettings?: string` Codec settings
-- `trackInfo.flagEnabled?: boolean` Set if the track is usable, default: `true`
-- `trackInfo.flagDefault?: boolean` Set if that track (audio, video or subs) SHOULD be active if no language found matches the user preference.
-- `trackInfo.flagLacing?: boolean` Set if the track **may** contain blocks using lacing
+- `trackInfo.flagEnabled?: boolean` Whether the track is enabled; Matroska defaults to `true`, MPEG-4 uses the track header flag
+- `trackInfo.flagDefault?: boolean` Whether the container marks the track as a default selection; Matroska defaults to `true`
+- `trackInfo.flagForced?: boolean` Whether a subtitle track should be displayed without explicit selection
+- `trackInfo.flagLacing?: boolean` Whether a Matroska track may contain blocks using lacing; defaults to `true`
 - `trackInfo.name?: string` A human-readable track name.
 - `trackInfo.language?: string` Specifies the language of the track
-- `trackInfo.audio?: IAudioTrack`, see [`trackInfo.audioTrack`](#trackinfoaudiotrack)
-- `trackInfo.video?: IVideoTrack`, see [`trackInfo.videoTrack`](#trackinfovideotrack)
-
-##### `trackInfo.audioTrack`
-
-- `audioTrack.samplingFrequency?: number`
-- `audioTrack.outputSamplingFrequency?: number`
-- `audioTrack.channels?: number`
-- `audioTrack.channelPositions?: Uint8Array`
-- `audioTrack.bitDepth?: number`
-
-##### `trackInfo.videoTrack`
-
-- `videoTrack.flagInterlaced?: boolean`
-- `videoTrack.stereoMode?: number`
-- `videoTrack.pixelWidth?: number`
-- `videoTrack.pixelHeight?: number`
-- `videoTrack.displayWidth?: number`
-- `videoTrack.displayHeight?: number`
-- `videoTrack.displayUnit?: number`
-- `videoTrack.aspectRatioType?: number`
-- `videoTrack.colourSpace?: Uint8Array`
-- `videoTrack.gammaValue?: number`
+- `trackInfo.audio?: IAudioTrack`, see [`trackInfo.audio`](#trackinfoaudio)
+- `trackInfo.video?: IVideoTrack`, see [`trackInfo.video`](#trackinfovideo)
+
+##### `trackInfo.audio`
+
+- `trackInfo.audio.numberOfSamples?: number` Number of decoded sample frames (one sample per channel), when known
+- `trackInfo.audio.samplingFrequency?: number` Sample rate in hertz; for Opus, the informational original input rate
+- `trackInfo.audio.outputSamplingFrequency?: number` Output sample rate in hertz; Opus granules and sample counts use 48000 Hz
+- `trackInfo.audio.channels?: number`
+- `trackInfo.audio.channelPositions?: Uint8Array`
+- `trackInfo.audio.bitDepth?: number`
+
+##### `trackInfo.video`
+
+- `trackInfo.video.frameRate?: number` Frames per second, when known
+- `trackInfo.video.flagInterlaced?: boolean`
+- `trackInfo.video.stereoMode?: number`
+- `trackInfo.video.pixelWidth?: number`
+- `trackInfo.video.pixelHeight?: number`
+- `trackInfo.video.displayWidth?: number`
+- `trackInfo.video.displayHeight?: number`
+- `trackInfo.video.displayUnit?: number`
+- `trackInfo.video.aspectRatioType?: number`
+- `trackInfo.video.colourSpace?: Uint8Array`
+- `trackInfo.video.gammaValue?: number`
 
 #### `metadata.common`
 
@@ -799,7 +842,7 @@ Using Node.js ≥ 22, which is support loading ESM module via require
 const mm = require('music-metadata');
 ```
 
-For older Node.js version < 22, you need to dynamically import **music-metadata**:
+Alternatively, dynamically import **music-metadata**:
 ```js
 (async () => {
   // Dynamically loads the ESM module in a CommonJS project

package/lib/ParseError.d.ts

@@ -4,6 +4,7 @@ export declare const makeParseError: <Name extends string>(name: Name) => {
         name: Name;
         message: string;
         stack?: string;
+        cause?: unknown;
     };
     captureStackTrace(targetObject: object, constructorOpt?: Function): void;
     prepareStackTrace(err: Error, stackTraces: NodeJS.CallSite[]): any;
@@ -14,6 +15,7 @@ declare const CouldNotDetermineFileTypeError_base: {
         name: "CouldNotDetermineFileTypeError";
         message: string;
         stack?: string;
+        cause?: unknown;
     };
     captureStackTrace(targetObject: object, constructorOpt?: Function): void;
     prepareStackTrace(err: Error, stackTraces: NodeJS.CallSite[]): any;
@@ -26,6 +28,7 @@ declare const UnsupportedFileTypeError_base: {
         name: "UnsupportedFileTypeError";
         message: string;
         stack?: string;
+        cause?: unknown;
     };
     captureStackTrace(targetObject: object, constructorOpt?: Function): void;
     prepareStackTrace(err: Error, stackTraces: NodeJS.CallSite[]): any;
@@ -38,6 +41,7 @@ declare const UnexpectedFileContentError_base: {
         name: "UnexpectedFileContentError";
         message: string;
         stack?: string;
+        cause?: unknown;
     };
     captureStackTrace(targetObject: object, constructorOpt?: Function): void;
     prepareStackTrace(err: Error, stackTraces: NodeJS.CallSite[]): any;
@@ -53,6 +57,7 @@ declare const FieldDecodingError_base: {
         name: "FieldDecodingError";
         message: string;
         stack?: string;
+        cause?: unknown;
     };
     captureStackTrace(targetObject: object, constructorOpt?: Function): void;
     prepareStackTrace(err: Error, stackTraces: NodeJS.CallSite[]): any;
@@ -65,6 +70,7 @@ declare const InternalParserError_base: {
         name: "InternalParserError";
         message: string;
         stack?: string;
+        cause?: unknown;
     };
     captureStackTrace(targetObject: object, constructorOpt?: Function): void;
     prepareStackTrace(err: Error, stackTraces: NodeJS.CallSite[]): any;
@@ -74,11 +80,12 @@ export declare class InternalParserError extends InternalParserError_base {
 }
 export declare const makeUnexpectedFileContentError: <FileType extends string>(fileType: FileType) => {
     new (message: string): {
-        readonly fileType: string;
-        toString(): string;
-        name: "UnexpectedFileContentError";
         message: string;
         stack?: string;
+        cause?: unknown;
+        name: "UnexpectedFileContentError";
+        readonly fileType: string;
+        toString(): string;
     };
     captureStackTrace(targetObject: object, constructorOpt?: Function): void;
     prepareStackTrace(err: Error, stackTraces: NodeJS.CallSite[]): any;

package/lib/ParseError.js

@@ -1,5 +1,6 @@
 export const makeParseError = (name) => {
     return class ParseError extends Error {
+        name;
         constructor(message) {
             super(message);
             this.name = name;
@@ -14,6 +15,7 @@ export class UnsupportedFileTypeError extends makeParseError('UnsupportedFileTyp
 }
 // Concrete error class representing unexpected file content.
 export class UnexpectedFileContentError extends makeParseError('UnexpectedFileContentError') {
+    fileType;
     constructor(fileType, message) {
         super(message);
         this.fileType = fileType;

package/lib/ParserFactory.js

@@ -1,4 +1,4 @@
-import ContentType from 'content-type';
+import { parse as parseContentType } from 'content-type';
 import initDebug from 'debug';
 import { fileTypeFromBuffer } from 'file-type';
 import { parse as mimeTypeParse } from 'media-typer';
@@ -6,6 +6,7 @@ import { aiffParserLoader } from './aiff/AiffLoader.js';
 import { apeParserLoader } from './apev2/Apev2Loader.js';
 import { asfParserLoader } from './asf/AsfLoader.js';
 import { MetadataCollector } from './common/MetadataCollector.js';
+import { createAudioTrackInfo } from './common/TrackInfo.js';
 import { scanAppendingHeaders } from './core.js';
 import { dsdiffParserLoader } from './dsdiff/DsdiffLoader.js';
 import { dsfParserLoader } from './dsf/DsfLoader.js';
@@ -21,7 +22,7 @@ import { riffParserLoader } from './wav/WaveLoader.js';
 import { wavpackParserLoader } from './wavpack/WavPackLoader.js';
 const debug = initDebug('music-metadata:parser:factory');
 export function parseHttpContentType(contentType) {
-    const type = ContentType.parse(contentType);
+    const type = parseContentType(contentType);
     const mime = mimeTypeParse(type.type);
     return {
         type: mime.type,
@@ -31,8 +32,8 @@ export function parseHttpContentType(contentType) {
     };
 }
 export class ParserFactory {
+    parsers = [];
     constructor() {
-        this.parsers = [];
         [
             flacParserLoader,
             mpegParserLoader,
@@ -54,7 +55,7 @@ export class ParserFactory {
     registerParser(parser) {
         this.parsers.push(parser);
     }
-    async parse(tokenizer, parserLoader, opts) {
+    async parse(tokenizer, parserLoader, opts = {}) {
         if (tokenizer.supportsRandomAccess()) {
             debug('tokenizer supports random-access, scanning for appending headers');
             await scanAppendingHeaders(tokenizer, opts);
@@ -92,6 +93,11 @@ export class ParserFactory {
         const parser = new ParserImpl(metadata, tokenizer, opts ?? {});
         debug(`Parser ${parserLoader.parserType} loaded`);
         await parser.parse();
+        // Audio-only parsers describe their single stream through the format fields.
+        // Container parsers supply their own tracks; never copy aggregate fields to them.
+        if (metadata.format.trackInfo.length === 0 && metadata.format.hasAudio === true) {
+            metadata.addStreamInfo(createAudioTrackInfo(metadata.format));
+        }
         if (metadata.format.trackInfo) {
             if (metadata.format.hasAudio === undefined) {
                 metadata.setFormat('hasAudio', !!metadata.format.trackInfo.find(track => track.type === TrackType.audio));

package/lib/aiff/AiffParser.js

@@ -16,10 +16,7 @@ const debug = initDebug('music-metadata:parser:aiff');
  * - http://www-mmsp.ece.mcgill.ca/Documents/AudioFormats/AIFF/Docs/AIFF-1.3.pdf
  */
 export class AIFFParser extends BasicParser {
-    constructor() {
-        super(...arguments);
-        this.isCompressed = null;
-    }
+    isCompressed = null;
     async parse() {
         const header = await this.tokenizer.readToken(iff.Header);
         if (header.chunkID !== 'FORM') {

package/lib/aiff/AiffToken.d.ts

@@ -14,11 +14,12 @@ export declare const compressionTypes: {
 export type CompressionTypeCode = keyof typeof compressionTypes;
 declare const AiffContentError_base: {
     new (message: string): {
-        readonly fileType: string;
-        toString(): string;
-        name: "UnexpectedFileContentError";
         message: string;
         stack?: string;
+        cause?: unknown;
+        name: "UnexpectedFileContentError";
+        readonly fileType: string;
+        toString(): string;
     };
     captureStackTrace(targetObject: object, constructorOpt?: Function): void;
     prepareStackTrace(err: Error, stackTraces: NodeJS.CallSite[]): any;

package/lib/aiff/AiffToken.js

@@ -15,6 +15,8 @@ export const compressionTypes = {
 export class AiffContentError extends makeUnexpectedFileContentError('AIFF') {
 }
 export class Common {
+    len;
+    isAifc;
     constructor(header, isAifc) {
         this.isAifc = isAifc;
         const minimumChunkSize = isAifc ? 22 : 18;

package/lib/apev2/APEv2Parser.d.ts

@@ -6,11 +6,12 @@ import type { IApeHeader, IOptions } from '../type.js';
 import { type IFooter, type IHeader } from './APEv2Token.js';
 declare const ApeContentError_base: {
     new (message: string): {
-        readonly fileType: string;
-        toString(): string;
-        name: "UnexpectedFileContentError";
         message: string;
         stack?: string;
+        cause?: unknown;
+        name: "UnexpectedFileContentError";
+        readonly fileType: string;
+        toString(): string;
     };
     captureStackTrace(targetObject: object, constructorOpt?: Function): void;
     prepareStackTrace(err: Error, stackTraces: NodeJS.CallSite[]): any;

package/lib/apev2/APEv2Parser.js

@@ -16,10 +16,6 @@ export function tryParseApeHeader(metadata, tokenizer, options) {
     return apeParser.tryParseApeHeader();
 }
 export class APEv2Parser extends BasicParser {
-    constructor() {
-        super(...arguments);
-        this.ape = {};
-    }
     /**
      * Calculate the media file duration
      * @param ah ApeHeader
@@ -68,6 +64,7 @@ export class APEv2Parser extends BasicParser {
         const apeParser = new APEv2Parser(metadata, strtok3.fromBuffer(buffer), options);
         return apeParser.parseTags(footer);
     }
+    ape = {};
     /**
      * Parse APEv1 / APEv2 header if header signature found
      */
@@ -202,6 +199,7 @@ export class APEv2Parser extends BasicParser {
         // ToDo before
         this.metadata.setFormat('lossless', true);
         this.metadata.setFormat('container', "Monkey's Audio");
+        this.metadata.setFormat('codec', "Monkey's Audio");
         this.metadata.setFormat('bitsPerSample', header.bitsPerSample);
         this.metadata.setFormat('sampleRate', header.sampleRate);
         this.metadata.setFormat('numberOfChannels', header.channel);

package/lib/asf/AsfGuid.js

@@ -13,7 +13,54 @@ import { Guid, parseWindowsGuid } from 'win-guid';
  * - http://drang.s4.xrea.com/program/tips/id3tag/wmp/10_asf_guids.html
  * - https://github.com/dji-sdk/FFmpeg/blob/master/libavformat/asf.c
  */
-class AsfGuid {
+export default class AsfGuid {
+    // 10.1 Top-level ASF object GUIDs
+    static HeaderObject = new AsfGuid('75B22630-668E-11CF-A6D9-00AA0062CE6C');
+    static DataObject = new AsfGuid('75B22636-668E-11CF-A6D9-00AA0062CE6C');
+    static SimpleIndexObject = new AsfGuid('33000890-E5B1-11CF-89F4-00A0C90349CB');
+    static IndexObject = new AsfGuid('D6E229D3-35DA-11D1-9034-00A0C90349BE');
+    static MediaObjectIndexObject = new AsfGuid('FEB103F8-12AD-4C64-840F-2A1D2F7AD48C');
+    static TimecodeIndexObject = new AsfGuid('3CB73FD0-0C4A-4803-953D-EDF7B6228F0C');
+    // 10.2 Header Object GUIDs
+    static FilePropertiesObject = new AsfGuid('8CABDCA1-A947-11CF-8EE4-00C00C205365');
+    static StreamPropertiesObject = new AsfGuid('B7DC0791-A9B7-11CF-8EE6-00C00C205365');
+    static HeaderExtensionObject = new AsfGuid('5FBF03B5-A92E-11CF-8EE3-00C00C205365');
+    static CodecListObject = new AsfGuid('86D15240-311D-11D0-A3A4-00A0C90348F6');
+    static ScriptCommandObject = new AsfGuid('1EFB1A30-0B62-11D0-A39B-00A0C90348F6');
+    static MarkerObject = new AsfGuid('F487CD01-A951-11CF-8EE6-00C00C205365');
+    static BitrateMutualExclusionObject = new AsfGuid('D6E229DC-35DA-11D1-9034-00A0C90349BE');
+    static ErrorCorrectionObject = new AsfGuid('75B22635-668E-11CF-A6D9-00AA0062CE6C');
+    static ContentDescriptionObject = new AsfGuid('75B22633-668E-11CF-A6D9-00AA0062CE6C');
+    static ExtendedContentDescriptionObject = new AsfGuid('D2D0A440-E307-11D2-97F0-00A0C95EA850');
+    static ContentBrandingObject = new AsfGuid('2211B3FA-BD23-11D2-B4B7-00A0C955FC6E');
+    static StreamBitratePropertiesObject = new AsfGuid('7BF875CE-468D-11D1-8D82-006097C9A2B2');
+    static ContentEncryptionObject = new AsfGuid('2211B3FB-BD23-11D2-B4B7-00A0C955FC6E');
+    static ExtendedContentEncryptionObject = new AsfGuid('298AE614-2622-4C17-B935-DAE07EE9289C');
+    static DigitalSignatureObject = new AsfGuid('2211B3FC-BD23-11D2-B4B7-00A0C955FC6E');
+    static PaddingObject = new AsfGuid('1806D474-CADF-4509-A4BA-9AABCB96AAE8');
+    // 10.3 Header Extension Object GUIDs
+    static ExtendedStreamPropertiesObject = new AsfGuid('14E6A5CB-C672-4332-8399-A96952065B5A');
+    static AdvancedMutualExclusionObject = new AsfGuid('A08649CF-4775-4670-8A16-6E35357566CD');
+    static GroupMutualExclusionObject = new AsfGuid('D1465A40-5A79-4338-B71B-E36B8FD6C249');
+    static StreamPrioritizationObject = new AsfGuid('D4FED15B-88D3-454F-81F0-ED5C45999E24');
+    static BandwidthSharingObject = new AsfGuid('A69609E6-517B-11D2-B6AF-00C04FD908E9');
+    static LanguageListObject = new AsfGuid('7C4346A9-EFE0-4BFC-B229-393EDE415C85');
+    static MetadataObject = new AsfGuid('C5F8CBEA-5BAF-4877-8467-AA8C44FA4CCA');
+    static MetadataLibraryObject = new AsfGuid('44231C94-9498-49D1-A141-1D134E457054');
+    static IndexParametersObject = new AsfGuid('D6E229DF-35DA-11D1-9034-00A0C90349BE');
+    static MediaObjectIndexParametersObject = new AsfGuid('6B203BAD-3F11-48E4-ACA8-D7613DE2CFA7');
+    static TimecodeIndexParametersObject = new AsfGuid('F55E496D-9797-4B5D-8C8B-604DFE9BFB24');
+    static CompatibilityObject = new AsfGuid('26F18B5D-4584-47EC-9F5F-0E651F0452C9');
+    static AdvancedContentEncryptionObject = new AsfGuid('43058533-6981-49E6-9B74-AD12CB86D58C');
+    // 10.4 Stream Properties Object Stream Type GUIDs
+    static AudioMedia = new AsfGuid('F8699E40-5B4D-11CF-A8FD-00805F5C442B');
+    static VideoMedia = new AsfGuid('BC19EFC0-5B4D-11CF-A8FD-00805F5C442B');
+    static CommandMedia = new AsfGuid('59DACFC0-59E6-11D0-A3AC-00A0C90348F6');
+    static JFIF_Media = new AsfGuid('B61BE100-5B4E-11CF-A8FD-00805F5C442B');
+    static Degradable_JPEG_Media = new AsfGuid('35907DE0-E415-11CF-A917-00805F5C442B');
+    static FileTransferMedia = new AsfGuid('91BD222C-F21C-497A-8B6D-5AA86BFC0185');
+    static BinaryMedia = new AsfGuid('3AFB65E2-47EF-40F2-AC2C-70A90D71D343');
+    static ASF_Index_Placeholder_Object = new AsfGuid('D9AADE20-7C17-4F9C-BC28-8555DD98E2A2');
     static fromBin(bin, offset = 0) {
         return new AsfGuid(AsfGuid.decode(bin, offset));
     }
@@ -55,6 +102,7 @@ class AsfGuid {
     static encode(guid) {
         return parseWindowsGuid(guid);
     }
+    str;
     constructor(str) {
         this.str = str;
     }
@@ -65,51 +113,3 @@ class AsfGuid {
         return AsfGuid.encode(this.str);
     }
 }
-// 10.1 Top-level ASF object GUIDs
-AsfGuid.HeaderObject = new AsfGuid('75B22630-668E-11CF-A6D9-00AA0062CE6C');
-AsfGuid.DataObject = new AsfGuid('75B22636-668E-11CF-A6D9-00AA0062CE6C');
-AsfGuid.SimpleIndexObject = new AsfGuid('33000890-E5B1-11CF-89F4-00A0C90349CB');
-AsfGuid.IndexObject = new AsfGuid('D6E229D3-35DA-11D1-9034-00A0C90349BE');
-AsfGuid.MediaObjectIndexObject = new AsfGuid('FEB103F8-12AD-4C64-840F-2A1D2F7AD48C');
-AsfGuid.TimecodeIndexObject = new AsfGuid('3CB73FD0-0C4A-4803-953D-EDF7B6228F0C');
-// 10.2 Header Object GUIDs
-AsfGuid.FilePropertiesObject = new AsfGuid('8CABDCA1-A947-11CF-8EE4-00C00C205365');
-AsfGuid.StreamPropertiesObject = new AsfGuid('B7DC0791-A9B7-11CF-8EE6-00C00C205365');
-AsfGuid.HeaderExtensionObject = new AsfGuid('5FBF03B5-A92E-11CF-8EE3-00C00C205365');
-AsfGuid.CodecListObject = new AsfGuid('86D15240-311D-11D0-A3A4-00A0C90348F6');
-AsfGuid.ScriptCommandObject = new AsfGuid('1EFB1A30-0B62-11D0-A39B-00A0C90348F6');
-AsfGuid.MarkerObject = new AsfGuid('F487CD01-A951-11CF-8EE6-00C00C205365');
-AsfGuid.BitrateMutualExclusionObject = new AsfGuid('D6E229DC-35DA-11D1-9034-00A0C90349BE');
-AsfGuid.ErrorCorrectionObject = new AsfGuid('75B22635-668E-11CF-A6D9-00AA0062CE6C');
-AsfGuid.ContentDescriptionObject = new AsfGuid('75B22633-668E-11CF-A6D9-00AA0062CE6C');
-AsfGuid.ExtendedContentDescriptionObject = new AsfGuid('D2D0A440-E307-11D2-97F0-00A0C95EA850');
-AsfGuid.ContentBrandingObject = new AsfGuid('2211B3FA-BD23-11D2-B4B7-00A0C955FC6E');
-AsfGuid.StreamBitratePropertiesObject = new AsfGuid('7BF875CE-468D-11D1-8D82-006097C9A2B2');
-AsfGuid.ContentEncryptionObject = new AsfGuid('2211B3FB-BD23-11D2-B4B7-00A0C955FC6E');
-AsfGuid.ExtendedContentEncryptionObject = new AsfGuid('298AE614-2622-4C17-B935-DAE07EE9289C');
-AsfGuid.DigitalSignatureObject = new AsfGuid('2211B3FC-BD23-11D2-B4B7-00A0C955FC6E');
-AsfGuid.PaddingObject = new AsfGuid('1806D474-CADF-4509-A4BA-9AABCB96AAE8');
-// 10.3 Header Extension Object GUIDs
-AsfGuid.ExtendedStreamPropertiesObject = new AsfGuid('14E6A5CB-C672-4332-8399-A96952065B5A');
-AsfGuid.AdvancedMutualExclusionObject = new AsfGuid('A08649CF-4775-4670-8A16-6E35357566CD');
-AsfGuid.GroupMutualExclusionObject = new AsfGuid('D1465A40-5A79-4338-B71B-E36B8FD6C249');
-AsfGuid.StreamPrioritizationObject = new AsfGuid('D4FED15B-88D3-454F-81F0-ED5C45999E24');
-AsfGuid.BandwidthSharingObject = new AsfGuid('A69609E6-517B-11D2-B6AF-00C04FD908E9');
-AsfGuid.LanguageListObject = new AsfGuid('7C4346A9-EFE0-4BFC-B229-393EDE415C85');
-AsfGuid.MetadataObject = new AsfGuid('C5F8CBEA-5BAF-4877-8467-AA8C44FA4CCA');
-AsfGuid.MetadataLibraryObject = new AsfGuid('44231C94-9498-49D1-A141-1D134E457054');
-AsfGuid.IndexParametersObject = new AsfGuid('D6E229DF-35DA-11D1-9034-00A0C90349BE');
-AsfGuid.MediaObjectIndexParametersObject = new AsfGuid('6B203BAD-3F11-48E4-ACA8-D7613DE2CFA7');
-AsfGuid.TimecodeIndexParametersObject = new AsfGuid('F55E496D-9797-4B5D-8C8B-604DFE9BFB24');
-AsfGuid.CompatibilityObject = new AsfGuid('26F18B5D-4584-47EC-9F5F-0E651F0452C9');
-AsfGuid.AdvancedContentEncryptionObject = new AsfGuid('43058533-6981-49E6-9B74-AD12CB86D58C');
-// 10.4 Stream Properties Object Stream Type GUIDs
-AsfGuid.AudioMedia = new AsfGuid('F8699E40-5B4D-11CF-A8FD-00805F5C442B');
-AsfGuid.VideoMedia = new AsfGuid('BC19EFC0-5B4D-11CF-A8FD-00805F5C442B');
-AsfGuid.CommandMedia = new AsfGuid('59DACFC0-59E6-11D0-A3AC-00A0C90348F6');
-AsfGuid.JFIF_Media = new AsfGuid('B61BE100-5B4E-11CF-A8FD-00805F5C442B');
-AsfGuid.Degradable_JPEG_Media = new AsfGuid('35907DE0-E415-11CF-A917-00805F5C442B');
-AsfGuid.FileTransferMedia = new AsfGuid('91BD222C-F21C-497A-8B6D-5AA86BFC0185');
-AsfGuid.BinaryMedia = new AsfGuid('3AFB65E2-47EF-40F2-AC2C-70A90D71D343');
-AsfGuid.ASF_Index_Placeholder_Object = new AsfGuid('D9AADE20-7C17-4F9C-BC28-8555DD98E2A2');
-export default AsfGuid;

package/lib/asf/AsfObject.d.ts

@@ -1,13 +1,14 @@
 import type { IGetToken, ITokenizer } from 'strtok3';
-import type { AnyTagValue, IPicture, ITag } from '../type.js';
+import type { AnyTagValue, IAudioTrack, IPicture, ITag, IVideoTrack } from '../type.js';
 import AsfGuid from './AsfGuid.js';
 declare const AsfContentParseError_base: {
     new (message: string): {
-        readonly fileType: string;
-        toString(): string;
-        name: "UnexpectedFileContentError";
         message: string;
         stack?: string;
+        cause?: unknown;
+        name: "UnexpectedFileContentError";
+        readonly fileType: string;
+        toString(): string;
     };
     captureStackTrace(targetObject: object, constructorOpt?: Function): void;
     prepareStackTrace(err: Error, stackTraces: NodeJS.CallSite[]): any;
@@ -198,6 +199,11 @@ export interface IStreamPropertiesObject {
      * Error Correction Type
      */
     errorCorrectionType: AsfGuid;
+    streamNumber: number;
+    codecId?: string;
+    audio?: IAudioTrack;
+    video?: IVideoTrack;
+    bitrate?: number;
 }
 /**
  * Token for: 3.3 Stream Properties Object (mandatory, one per stream)
@@ -282,7 +288,7 @@ export interface IExtendedStreamPropertiesObject {
     streamNameCount: number;
     payloadExtensionSystems: number;
     streamNames: IStreamName[];
-    streamPropertiesObject: number | null;
+    streamPropertiesObject: IStreamPropertiesObject | null;
 }
 /**
  * 4.1 Extended Stream Properties Object (optional, 1 per media stream)