music-metadata 10.0.1 → 10.2.0

package/lib/musepack/sv7/StreamVersion7.js

@@ -36,3 +36,4 @@ export const Header = {
         return header;
     }
 };
+//# sourceMappingURL=StreamVersion7.js.map

package/lib/musepack/sv8/MpcSv8Parser.js

@@ -22,13 +22,14 @@ export class MpcSv8Parser extends BasicParser {
             const header = await sv8reader.readPacketHeader();
             debug(`packet-header key=${header.key}, payloadLength=${header.payloadLength}`);
             switch (header.key) {
-                case 'SH': // Stream Header
+                case 'SH': { // Stream Header
                     const sh = await sv8reader.readStreamHeader(header.payloadLength);
                     this.metadata.setFormat('numberOfSamples', sh.sampleCount);
                     this.metadata.setFormat('sampleRate', sh.sampleFrequency);
                     this.metadata.setFormat('duration', sh.sampleCount / sh.sampleFrequency);
                     this.metadata.setFormat('numberOfChannels', sh.channelCount);
                     break;
+                }
                 case 'AP': // Audio Packet
                     this.audioLength += header.payloadLength;
                     await this.tokenizer.ignore(header.payloadLength);
@@ -41,7 +42,9 @@ export class MpcSv8Parser extends BasicParser {
                     await this.tokenizer.ignore(header.payloadLength);
                     break;
                 case 'SE': // Stream End
-                    this.metadata.setFormat('bitrate', this.audioLength * 8 / this.metadata.format.duration);
+                    if (this.metadata.format.duration) {
+                        this.metadata.setFormat('bitrate', this.audioLength * 8 / this.metadata.format.duration);
+                    }
                     return APEv2Parser.tryParseApeHeader(this.metadata, this.tokenizer, this.options);
                 default:
                     throw new Error(`Unexpected header: ${header.key}`);
@@ -49,3 +52,4 @@ export class MpcSv8Parser extends BasicParser {
         } while (true);
     }
 }
+//# sourceMappingURL=MpcSv8Parser.js.map

package/lib/musepack/sv8/StreamVersion8.d.ts

@@ -1,4 +1,4 @@
-import { ITokenizer } from 'strtok3';
+import type { ITokenizer } from 'strtok3';
 export interface IPacketHeader {
     key: string;
     payloadLength: number;

package/lib/musepack/sv8/StreamVersion8.js

@@ -74,3 +74,4 @@ export class StreamReader {
         return this.readVariableSizeField(len + 1, n << 7);
     }
 }
+//# sourceMappingURL=StreamVersion8.js.map

package/lib/ogg/Ogg.d.ts

@@ -64,7 +64,7 @@ export interface IPageConsumer {
      * Calculate duration of provided header
      * @param header Ogg header
      */
-    calculateDuration(header: IPageHeader): any;
+    calculateDuration(header: IPageHeader): void;
     /**
      * Force to parse pending segments
      */

package/lib/ogg/Ogg.js

@@ -1 +1,2 @@
 export {};
+//# sourceMappingURL=Ogg.js.map

package/lib/ogg/OggParser.d.ts

@@ -1,11 +1,11 @@
-import { IGetToken } from 'strtok3';
+import { type IGetToken } from 'strtok3';
 import { BasicParser } from '../common/BasicParser.js';
-import * as Ogg from './Ogg.js';
+import type * as Ogg from './Ogg.js';
 export declare class SegmentTable implements IGetToken<Ogg.ISegmentTable> {
     private static sum;
     len: number;
     constructor(header: Ogg.IPageHeader);
-    get(buf: any, off: any): Ogg.ISegmentTable;
+    get(buf: Uint8Array, off: number): Ogg.ISegmentTable;
 }
 /**
  * Parser for Ogg logical bitstream framing

package/lib/ogg/OggParser.js

@@ -11,9 +11,10 @@ import { TheoraParser } from './theora/TheoraParser.js';
 const debug = initDebug('music-metadata:parser:ogg');
 export class SegmentTable {
     static sum(buf, off, len) {
+        const dv = new DataView(buf.buffer, 0);
         let s = 0;
         for (let i = off; i < off + len; ++i) {
-            s += buf[i];
+            s += dv.getUint8(i);
         }
         return s;
     }
@@ -30,6 +31,12 @@ export class SegmentTable {
  * Parser for Ogg logical bitstream framing
  */
 export class OggParser extends BasicParser {
+    constructor() {
+        super(...arguments);
+        this.header = null;
+        this.pageNumber = 0;
+        this.pageConsumer = null;
+    }
     /**
      * Parse page
      * @returns {Promise<void>}
@@ -71,31 +78,32 @@ export class OggParser extends BasicParser {
                             this.pageConsumer = new TheoraParser(this.metadata, this.options, this.tokenizer);
                             break;
                         default:
-                            throw new Error('gg audio-codec not recognized (id=' + id + ')');
+                            throw new Error(`gg audio-codec not recognized (id=${id})`);
                     }
                 }
                 await this.pageConsumer.parsePage(header, pageData);
             } while (!header.headerType.lastPage);
         }
         catch (err) {
-            if (err instanceof EndOfStreamError) {
-                this.metadata.addWarning('Last OGG-page is not marked with last-page flag');
-                debug(`End-of-stream`);
-                this.metadata.addWarning('Last OGG-page is not marked with last-page flag');
-                if (this.header) {
-                    this.pageConsumer.calculateDuration(this.header);
+            if (err instanceof Error) {
+                if (err instanceof EndOfStreamError) {
+                    this.metadata.addWarning('Last OGG-page is not marked with last-page flag');
+                    debug("End-of-stream");
+                    this.metadata.addWarning('Last OGG-page is not marked with last-page flag');
+                    if (this.header) {
+                        this.pageConsumer.calculateDuration(this.header);
+                    }
                 }
-            }
-            else if (err.message.startsWith('FourCC')) {
-                if (this.pageNumber > 0) {
-                    // ignore this error: work-around if last OGG-page is not marked with last-page flag
-                    this.metadata.addWarning('Invalid FourCC ID, maybe last OGG-page is not marked with last-page flag');
-                    await this.pageConsumer.flush();
+                else if (err.message.startsWith('FourCC')) {
+                    if (this.pageNumber > 0) {
+                        // ignore this error: work-around if last OGG-page is not marked with last-page flag
+                        this.metadata.addWarning('Invalid FourCC ID, maybe last OGG-page is not marked with last-page flag');
+                        await this.pageConsumer.flush();
+                    }
                 }
             }
-            else {
+            else
                 throw err;
-            }
         }
     }
 }
@@ -119,3 +127,4 @@ OggParser.Header = {
         };
     }
 };
+//# sourceMappingURL=OggParser.js.map

package/lib/ogg/opus/Opus.d.ts

@@ -44,5 +44,5 @@ export interface IIdHeader {
 export declare class IdHeader implements IGetToken<IIdHeader> {
     len: number;
     constructor(len: number);
-    get(buf: any, off: any): IIdHeader;
+    get(buf: Uint8Array, off: number): IIdHeader;
 }

package/lib/ogg/opus/Opus.js

@@ -22,3 +22,4 @@ export class IdHeader {
         };
     }
 }
+//# sourceMappingURL=Opus.js.map

package/lib/ogg/opus/OpusParser.d.ts

@@ -1,8 +1,8 @@
-import { ITokenizer } from 'strtok3';
-import { IPageHeader } from '../Ogg.js';
+import type { ITokenizer } from 'strtok3';
+import type { IPageHeader } from '../Ogg.js';
 import { VorbisParser } from '../vorbis/VorbisParser.js';
-import { IOptions } from '../../type.js';
-import { INativeMetadataCollector } from '../../common/MetadataCollector.js';
+import type { IOptions } from '../../type.js';
+import type { INativeMetadataCollector } from '../../common/MetadataCollector.js';
 /**
  * Opus parser
  * Internet Engineering Task Force (IETF) - RFC 6716

package/lib/ogg/opus/OpusParser.js

@@ -10,6 +10,7 @@ export class OpusParser extends VorbisParser {
     constructor(metadata, options, tokenizer) {
         super(metadata, options);
         this.tokenizer = tokenizer;
+        this.idHeader = null;
         this.lastPos = -1;
     }
     /**
@@ -50,3 +51,4 @@ export class OpusParser extends VorbisParser {
         }
     }
 }
+//# sourceMappingURL=OpusParser.js.map

package/lib/ogg/speex/Speex.js

@@ -26,3 +26,4 @@ export const Header = {
         };
     }
 };
+//# sourceMappingURL=Speex.js.map

package/lib/ogg/speex/SpeexParser.d.ts

@@ -1,8 +1,8 @@
-import { ITokenizer } from 'strtok3';
-import { IPageHeader } from '../Ogg.js';
+import type { ITokenizer } from 'strtok3';
+import type { IPageHeader } from '../Ogg.js';
 import { VorbisParser } from '../vorbis/VorbisParser.js';
-import { IOptions } from '../../type.js';
-import { INativeMetadataCollector } from '../../common/MetadataCollector.js';
+import type { IOptions } from '../../type.js';
+import type { INativeMetadataCollector } from '../../common/MetadataCollector.js';
 /**
  * Speex, RFC 5574
  * Ref:

package/lib/ogg/speex/SpeexParser.js

@@ -29,3 +29,4 @@ export class SpeexParser extends VorbisParser {
         }
     }
 }
+//# sourceMappingURL=SpeexParser.js.map

package/lib/ogg/theora/Theora.js

@@ -18,3 +18,4 @@ export const IdentificationHeader = {
         };
     }
 };
+//# sourceMappingURL=Theora.js.map

package/lib/ogg/theora/TheoraParser.d.ts

@@ -1,7 +1,7 @@
-import { ITokenizer } from 'strtok3';
-import * as Ogg from '../Ogg.js';
-import { IOptions } from '../../type.js';
-import { INativeMetadataCollector } from '../../common/MetadataCollector.js';
+import type { ITokenizer } from 'strtok3';
+import type * as Ogg from '../Ogg.js';
+import type { IOptions } from '../../type.js';
+import type { INativeMetadataCollector } from '../../common/MetadataCollector.js';
 /**
  * Ref:
  * - https://theora.org/doc/Theora.pdf

package/lib/ogg/theora/TheoraParser.js

@@ -38,3 +38,4 @@ export class TheoraParser {
         this.metadata.setFormat('bitrate', idHeader.nombr);
     }
 }
+//# sourceMappingURL=TheoraParser.js.map

package/lib/ogg/vorbis/Vorbis.d.ts

@@ -1,4 +1,4 @@
-import { IPicture } from '../../type.js';
+import type { IPicture } from '../../type.js';
 import type { IGetToken } from 'strtok3';
 /**
  * Interface to parsed result of METADATA_BLOCK_PICTURE
@@ -20,10 +20,10 @@ export interface IVorbisPicture extends IPicture {
  * // ToDo: move to ID3 / APIC?
  */
 export declare class VorbisPictureToken implements IGetToken<IVorbisPicture> {
-    len: any;
+    len: number;
     static fromBase64(base64str: string): IVorbisPicture;
     static fromBuffer(buffer: Uint8Array): IVorbisPicture;
-    constructor(len: any);
+    constructor(len: number);
     get(buffer: Uint8Array, offset: number): IVorbisPicture;
 }
 /**

package/lib/ogg/vorbis/Vorbis.js

@@ -8,7 +8,7 @@ import { AttachedPictureType } from '../../id3v2/ID3v2Token.js';
  */
 export class VorbisPictureToken {
     static fromBase64(base64str) {
-        return this.fromBuffer(Uint8Array.from(atob(base64str), c => c.charCodeAt(0)));
+        return VorbisPictureToken.fromBuffer(Uint8Array.from(atob(base64str), c => c.charCodeAt(0)));
     }
     static fromBuffer(buffer) {
         const pic = new VorbisPictureToken(buffer.length);
@@ -19,16 +19,26 @@ export class VorbisPictureToken {
     }
     get(buffer, offset) {
         const type = AttachedPictureType[Token.UINT32_BE.get(buffer, offset)];
-        const mimeLen = Token.UINT32_BE.get(buffer, offset += 4);
-        const format = new Token.StringType(mimeLen, 'utf-8').get(buffer, offset += 4);
-        const descLen = Token.UINT32_BE.get(buffer, offset += mimeLen);
-        const description = new Token.StringType(descLen, 'utf-8').get(buffer, offset += 4);
-        const width = Token.UINT32_BE.get(buffer, offset += descLen);
-        const height = Token.UINT32_BE.get(buffer, offset += 4);
-        const colour_depth = Token.UINT32_BE.get(buffer, offset += 4);
-        const indexed_color = Token.UINT32_BE.get(buffer, offset += 4);
-        const picDataLen = Token.UINT32_BE.get(buffer, offset += 4);
-        const data = Uint8Array.from(buffer.slice(offset += 4, offset + picDataLen));
+        offset += 4;
+        const mimeLen = Token.UINT32_BE.get(buffer, offset);
+        offset += 4;
+        const format = new Token.StringType(mimeLen, 'utf-8').get(buffer, offset);
+        offset += mimeLen;
+        const descLen = Token.UINT32_BE.get(buffer, offset);
+        offset += 4;
+        const description = new Token.StringType(descLen, 'utf-8').get(buffer, offset);
+        offset += descLen;
+        const width = Token.UINT32_BE.get(buffer, offset);
+        offset += 4;
+        const height = Token.UINT32_BE.get(buffer, offset);
+        offset += 4;
+        const colour_depth = Token.UINT32_BE.get(buffer, offset);
+        offset += 4;
+        const indexed_color = Token.UINT32_BE.get(buffer, offset);
+        offset += 4;
+        const picDataLen = Token.UINT32_BE.get(buffer, offset);
+        offset += 4;
+        const data = Uint8Array.from(buffer.slice(offset, offset + picDataLen));
         return {
             type,
             format,
@@ -71,3 +81,4 @@ export const IdentificationHeader = {
         };
     }
 };
+//# sourceMappingURL=Vorbis.js.map

package/lib/ogg/vorbis/VorbisDecoder.d.ts

@@ -1,7 +1,7 @@
 export declare class VorbisDecoder {
     private readonly data;
     private offset;
-    constructor(data: Uint8Array, offset: any);
+    constructor(data: Uint8Array, offset: number);
     readInt32(): number;
     readStringUtf8(): string;
     parseUserComment(): {

package/lib/ogg/vorbis/VorbisDecoder.js

@@ -26,3 +26,4 @@ export class VorbisDecoder {
         };
     }
 }
+//# sourceMappingURL=VorbisDecoder.js.map

package/lib/ogg/vorbis/VorbisParser.d.ts

@@ -1,7 +1,7 @@
-import { IVorbisPicture } from './Vorbis.js';
-import { IPageConsumer, IPageHeader } from '../Ogg.js';
-import { IOptions } from '../../type.js';
-import { INativeMetadataCollector } from '../../common/MetadataCollector.js';
+import { type IVorbisPicture } from './Vorbis.js';
+import type { IPageConsumer, IPageHeader } from '../Ogg.js';
+import type { IOptions } from '../../type.js';
+import type { INativeMetadataCollector } from '../../common/MetadataCollector.js';
 /**
  * Vorbis 1 Parser.
  * Used by OggParser

package/lib/ogg/vorbis/VorbisParser.js

@@ -64,7 +64,7 @@ export class VorbisParser {
     async addTag(id, value) {
         if (id === 'METADATA_BLOCK_PICTURE' && (typeof value === 'string')) {
             if (this.options.skipCovers) {
-                debug(`Ignore picture`);
+                debug("Ignore picture");
                 return;
             }
             value = VorbisPictureToken.fromBase64(value);
@@ -79,7 +79,7 @@ export class VorbisParser {
         if (this.metadata.format.sampleRate && header.absoluteGranulePosition >= 0) {
             // Calculate duration
             this.metadata.setFormat('numberOfSamples', header.absoluteGranulePosition);
-            this.metadata.setFormat('duration', this.metadata.format.numberOfSamples / this.metadata.format.sampleRate);
+            this.metadata.setFormat('duration', header.absoluteGranulePosition / this.metadata.format.sampleRate);
         }
     }
     /**
@@ -131,3 +131,4 @@ export class VorbisParser {
         }
     }
 }
+//# sourceMappingURL=VorbisParser.js.map

package/lib/ogg/vorbis/VorbisTagMapper.d.ts

@@ -1,7 +1,7 @@
 import { CommonTagMapper } from '../../common/GenericTagMapper.js';
-import { IRating, ITag } from '../../type.js';
+import type { IRating, ITag } from '../../type.js';
 export declare class VorbisTagMapper extends CommonTagMapper {
-    static toRating(email: string, rating: string, maxScore: number): IRating;
+    static toRating(email: string | undefined | null, rating: string, maxScore: number): IRating;
     constructor();
     protected postMap(tag: ITag): void;
 }

package/lib/ogg/vorbis/VorbisTagMapper.js

@@ -112,8 +112,8 @@ const vorbisTagMap = {
 export class VorbisTagMapper extends CommonTagMapper {
     static toRating(email, rating, maxScore) {
         return {
-            source: email ? email.toLowerCase() : email,
-            rating: (parseFloat(rating) / maxScore) * CommonTagMapper.maxRatingScore
+            source: email ? email.toLowerCase() : undefined,
+            rating: (Number.parseFloat(rating) / maxScore) * CommonTagMapper.maxRatingScore
         };
     }
     constructor() {

package/lib/riff/RiffChunk.d.ts

@@ -1,6 +1,6 @@
 import type { IGetToken } from 'strtok3';
-import { IChunkHeader } from '../iff/index.js';
-export { IChunkHeader } from '../iff/index.js';
+import type { IChunkHeader } from '../iff/index.js';
+export { type IChunkHeader } from '../iff/index.js';
 /**
  * Common RIFF chunk header
  */
@@ -12,5 +12,5 @@ export declare class ListInfoTagValue implements IGetToken<string> {
     private tagHeader;
     len: number;
     constructor(tagHeader: IChunkHeader);
-    get(buf: any, off: any): string;
+    get(buf: Uint8Array, off: number): string;
 }

package/lib/riff/RiffChunk.js

@@ -26,3 +26,4 @@ export class ListInfoTagValue {
         return new Token.StringType(this.tagHeader.chunkSize, 'ascii').get(buf, off);
     }
 }
+//# sourceMappingURL=RiffChunk.js.map

package/lib/riff/RiffInfoTagMap.d.ts

@@ -1,4 +1,4 @@
-import { INativeTagMap } from '../common/GenericTagTypes.js';
+import type { INativeTagMap } from '../common/GenericTagTypes.js';
 import { CommonTagMapper } from '../common/GenericTagMapper.js';
 /**
  * RIFF Info Tags; part of the EXIF 2.3

package/lib/type.d.ts

@@ -1,9 +1,10 @@
-import { GenericTagId, TagType } from './common/GenericTagTypes.js';
-import { IFooter } from './apev2/APEv2Token.js';
-import { TrackType } from './matroska/types.js';
-import { LyricsContentType, TimestampFormat } from './id3v2/ID3v2Token.js';
+import type { TagType } from './common/GenericTagTypes.js';
+import type { IFooter } from './apev2/APEv2Token.js';
+import type { TrackType } from './matroska/types.js';
+import type { LyricsContentType, TimestampFormat } from './id3v2/ID3v2Token.js';
 export { TrackType } from './matroska/types.js';
 export { LyricsContentType, TimestampFormat } from './id3v2/ID3v2Token.js';
+export type AnyTagValue = unknown;
 /**
  * Attached picture, typically used for cover art
  */
@@ -40,7 +41,7 @@ export interface IRating {
     /**
      * Rating [0..1]
      */
-    rating: number;
+    rating?: number;
 }
 export interface ICommonTagsResult {
     track: {
@@ -159,6 +160,10 @@ export interface ICommonTagsResult {
      * Engineer(s)
      */
     engineer?: string[];
+    /**
+     * Publisher(s)
+     */
+    publisher?: string[];
     /**
      * Producer(s)
      */
@@ -293,9 +298,13 @@ export interface ICommonTagsResult {
         rightChannel: number;
     };
     /**
-     * minimum & maximum global gain values across a set of files scanned as an album
+     * minimum & maximum global gain values across a set of file
      */
     replaygain_track_minmax?: number[];
+    /**
+     * minimum & maximum global gain values across a set of files scanned as an album
+     */
+    replaygain_album_minmax?: number[];
     /**
      * The initial key of the music in the file, e.g. "A Minor".
      * Ref: https://docs.microsoft.com/en-us/windows/win32/wmformat/wm-initialkey
@@ -325,8 +334,8 @@ export interface ICommonTagsResult {
      * Movement Index/Total
      */
     movementIndex: {
-        no?: number;
-        of?: number;
+        no: number | null;
+        of: number | null;
     };
     /**
      * Podcast Identifier
@@ -402,7 +411,7 @@ export interface IFormat {
     /**
      * List of tags found in parsed audio file
      */
-    readonly tagTypes?: TagType[];
+    readonly tagTypes: TagType[];
     /**
      * Duration in seconds
      */
@@ -464,7 +473,7 @@ export interface IFormat {
 }
 export interface ITag {
     id: string;
-    value: any;
+    value: AnyTagValue;
 }
 export interface IChapter {
     /**
@@ -487,7 +496,7 @@ export interface INativeTags {
  * Tags ordered by tag-ID
  */
 export interface INativeTagDict {
-    [tagId: string]: any[];
+    [tagId: string]: AnyTagValue[];
 }
 export interface INativeAudioMetadata {
     format: IFormat;
@@ -535,6 +544,15 @@ export interface IOptions {
      * Set observer for async callbacks to common or format.
      */
     observer?: Observer;
+    /**
+     * In Matroska based files, use the  _SeekHead_ element index to skip _segment/cluster_ elements.
+     * By default, disabled
+     * Can have a significant performance impact if enabled.
+     * Possible side effect can be that certain metadata maybe skipped, depending on the index.
+     * If there is no _SeekHead_ element present in the Matroska file, this flag has no effect
+     * Ref: https://www.matroska.org/technical/diagram.html
+     */
+    mkvUseIndex?: boolean;
 }
 export interface IApeHeader extends IOptions {
     /**
@@ -549,6 +567,20 @@ export interface IApeHeader extends IOptions {
 export interface IPrivateOptions extends IOptions {
     apeHeader?: IApeHeader;
 }
+export interface IMetadataEventTag {
+    /**
+     * Either `common` if it is a generic tag event, or `format` for format related updates
+     */
+    type: 'common' | 'format';
+    /**
+     * Tag id
+     */
+    id: keyof ICommonTagsResult | FormatId;
+    /**
+     * Tag value
+     */
+    value: AnyTagValue;
+}
 /**
  * Event definition send after each change to common/format metadata change to observer.
  */
@@ -556,20 +588,7 @@ export interface IMetadataEvent {
     /**
      * Tag which has been updated.
      */
-    tag: {
-        /**
-         * Either 'common' if it a generic tag event, or 'format' for format related updates
-         */
-        type: 'common' | 'format';
-        /**
-         * Tag id
-         */
-        id: GenericTagId | FormatId;
-        /**
-         * Tag value
-         */
-        value: any;
-    };
+    tag: IMetadataEventTag;
     /**
      * Metadata model including the attached tag
      */

package/lib/wav/BwfChunk.js

@@ -24,3 +24,4 @@ export const BroadcastAudioExtensionChunk = {
         };
     }
 };
+//# sourceMappingURL=BwfChunk.js.map

package/lib/wav/WaveChunk.d.ts

@@ -1,5 +1,5 @@
 import type { IGetToken } from 'strtok3';
-import { IChunkHeader } from '../iff/index.js';
+import type { IChunkHeader } from '../iff/index.js';
 /**
  * Ref: https://msdn.microsoft.com/en-us/library/windows/desktop/dd317599(v=vs.85).aspx
  */

package/lib/wav/WaveChunk.js

@@ -59,3 +59,4 @@ export class FactChunk {
         };
     }
 }
+//# sourceMappingURL=WaveChunk.js.map