music-metadata 11.1.0 → 11.2.0

package/lib/core.d.ts

@@ -3,10 +3,11 @@
  */
 import { type AnyWebByteStream, type IFileInfo, type ITokenizer, type IRandomAccessTokenizer } from 'strtok3';
 import type { IAudioMetadata, INativeTagDict, IOptions, IPicture, IPrivateOptions, ITag } from './type.js';
+import type { Readable } from 'node:stream';
 export type { IFileInfo } from 'strtok3';
 export { type IAudioMetadata, type IOptions, type ITag, type INativeTagDict, type ICommonTagsResult, type IFormat, type IPicture, type IRatio, type IChapter, type ILyricsTag, LyricsContentType, TimestampFormat, IMetadataEventTag, IMetadataEvent } from './type.js';
 export { CouldNotDetermineFileTypeError, UnsupportedFileTypeError } from './ParseError.js';
-export type * from './ParseError.js';
+export * from './ParseError.js';
 /**
  * Parse Web API File
  * Requires Blob to be able to stream using a ReadableStreamBYOBReader, only available since Node.js ≥ 20
@@ -63,6 +64,11 @@ export declare function scanAppendingHeaders(tokenizer: IRandomAccessTokenizer,
  * This method will throw an Error, always.
  */
 export declare function parseFile(filePath: string, options?: IOptions): Promise<IAudioMetadata>;
+/**
+ * Implementation only available when loaded as Node.js
+ * This method will throw an Error, always.
+ */
+export declare function parseStream(stream: Readable, fileInfo?: IFileInfo | string, options?: IOptions): Promise<IAudioMetadata>;
 /**
  * Return a list of supported mime-types
  */

package/lib/core.js

@@ -8,6 +8,7 @@ import { hasID3v1Header } from './id3v1/ID3v1Parser.js';
 import { getLyricsHeaderLength } from './lyrics3/Lyrics3.js';
 export { LyricsContentType, TimestampFormat } from './type.js';
 export { CouldNotDetermineFileTypeError, UnsupportedFileTypeError } from './ParseError.js';
+export * from './ParseError.js';
 /**
  * Parse Web API File
  * Requires Blob to be able to stream using a ReadableStreamBYOBReader, only available since Node.js ≥ 20
@@ -109,7 +110,14 @@ export async function scanAppendingHeaders(tokenizer, options = {}) {
  * This method will throw an Error, always.
  */
 export async function parseFile(filePath, options = {}) {
-    throw new Error('To load Web API File objects use parseBlob instead. For loading files, you need to import with the "node" condition is set.');
+    throw new Error('This function require a Node engine. To load Web API File objects use parseBlob instead.');
+}
+/**
+ * Implementation only available when loaded as Node.js
+ * This method will throw an Error, always.
+ */
+export async function parseStream(stream, fileInfo, options = {}) {
+    throw new Error('This function require a Node engine.');
 }
 /**
  * Return a list of supported mime-types

package/lib/mp4/MP4Parser.js

@@ -462,6 +462,9 @@ export class MP4Parser extends BasicParser {
         }
         const chapters = [];
         for (let i = 0; i < chapterTrack.chunkOffsetTable.length && len > 0; ++i) {
+            const start = chapterTrack.timeToSampleTable
+                .slice(0, i)
+                .reduce((acc, cur) => acc + cur.duration, 0);
             const chunkOffset = chapterTrack.chunkOffsetTable[i];
             const nextChunkLen = chunkOffset - this.tokenizer.position;
             const sampleSize = chapterTrack.sampleSize > 0 ? chapterTrack.sampleSize : chapterTrack.sampleSizeTable[i];
@@ -473,6 +476,8 @@ export class MP4Parser extends BasicParser {
             debug(`Chapter ${i + 1}: ${title}`);
             const chapter = {
                 title,
+                timeScale: chapterTrack.timeScale,
+                start,
                 sampleOffset: this.findSampleOffset(track, this.tokenizer.position)
             };
             debug(`Chapter title=${chapter.title}, offset=${chapter.sampleOffset}/${this.tracks[0].duration}`);

package/lib/type.d.ts

@@ -485,6 +485,15 @@ export interface IChapter {
      * Duration offset is sampleOffset / format.sampleRate
      */
     sampleOffset: number;
+    /**
+     * Timestamp where the chapter starts
+     * Chapter timestamp is start/timeScale in seconds.
+     */
+    start: number;
+    /**
+     * Time value that indicates the time scale for chapter tracks, the number of time units that pass per second in its time coordinate system.
+     */
+    timeScale: number;
 }
 /**
  * Flat list of tags

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "music-metadata",
   "description": "Music metadata parser for Node.js, supporting virtual any audio and tag format.",
-  "version": "11.1.0",
+  "version": "11.2.0",
   "author": {
     "name": "Borewit",
     "url": "https://github.com/Borewit"
@@ -107,7 +107,7 @@
     "@tokenizer/token": "^0.3.0",
     "content-type": "^1.0.5",
     "debug": "^4.4.0",
-    "file-type": "^19.6.0",
+    "file-type": "^20.4.1",
     "link": "^2.1.1",
     "media-typer": "^1.1.0",
     "strtok3": "^10.2.2",
@@ -122,7 +122,7 @@
     "@types/debug": "^4.1.12",
     "@types/media-typer": "^1.1.3",
     "@types/mocha": "^10.0.10",
-    "@types/node": "^22.14.0",
+    "@types/node": "^22.14.1",
     "c8": "^10.1.3",
     "chai": "^5.2.0",
     "chai-as-promised": "^8.0.1",
@@ -133,7 +133,7 @@
     "remark-cli": "^12.0.1",
     "remark-preset-lint-consistent": "^6.0.1",
     "ts-node": "^10.9.2",
-    "typescript": "^5.8.2"
+    "typescript": "^5.8.3"
   },
   "engines": {
     "node": ">=18"