music-metadata 10.6.4 → 10.6.5

package/README.md

@@ -86,8 +86,6 @@ Following lyric formats are supported:
 - [LRC](https://en.wikipedia.org/wiki/LRC_(file_format))
 - Synchronized lyrics (SYLT)
 - Unsynchronized lyrics (USULT)
-[
-It allows many tags to be]() accessed in audio format, and tag format independent way.
 
 Support for [MusicBrainz](https://musicbrainz.org/) tags as written by [Picard](https://picard.musicbrainz.org/).
 [ReplayGain](https://wiki.hydrogenaud.io/index.php?title=ReplayGain) tags are supported.
@@ -212,8 +210,8 @@ parseStream(stream: Readable, fileInfo?: IFileInfo | string, options?: IOptions)
 
 - `stream`: `Readable`:
   
-   The Node.js [Readable](https://nodejs.org/api/stream.html#class-streamreadable) stream from which the audio data is read.
-   This stream should provide the raw audio data to be analyzed.
+  The Node.js [Readable](https://nodejs.org/api/stream.html#class-streamreadable) stream from which the audio data is read.
+  This stream should provide the raw audio data to be analyzed.
 
 - `fileInfo`: `IFileInfo` (optional)
 
@@ -222,8 +220,8 @@ parseStream(stream: Readable, fileInfo?: IFileInfo | string, options?: IOptions)
 
   - `mimeType`: A string representing the [MIME-type](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types) (e.g., `audio/mpeg`).
     
-     If provided, it is assumed the streamed file content is to be the MIME-type. 
-     If not provided, the parser will attempt to determine the format based on the content of the stream.
+    If provided, it is assumed the streamed file content is to be the MIME-type. 
+    If not provided, the parser will attempt to determine the format based on the content of the stream.
   
   - `size`: The total size of the audio stream in bytes (useful for streams with a known length).
   
@@ -231,9 +229,9 @@ parseStream(stream: Readable, fileInfo?: IFileInfo | string, options?: IOptions)
 
 - `options`: `IOptions` (optional)
   
-   An optional object containing additional parsing options.
-   These options allow you to customize the parsing process,
-   such as whether to calculate the duration or skip cover art extraction.
+  An optional object containing additional parsing options.
+  These options allow you to customize the parsing process,
+  such as whether to calculate the duration or skip cover art extraction.
 
 ##### Returns
 
@@ -793,49 +791,49 @@ const { loadMusicMetadata } = require('music-metadata');
 
 ## Frequently Asked Questions
 
-1.  How can I traverse (a long) list of files?
+###  How can I traverse (a long) list of files?
 
-    What is important that file parsing should be done in a sequential manner.
-    In a plain loop, due to the asynchronous character (like most JavaScript functions), it would cause all the files to run in parallel which is will cause your application to hang in no time.
-    There are multiple ways of achieving this:
+What is important that file parsing should be done in a sequential manner.
+In a plain loop, due to the asynchronous character (like most JavaScript functions), it would cause all the files to run in parallel which is will cause your application to hang in no time.
+There are multiple ways of achieving this:
 
-    1.  Using recursion
+1.  Using recursion
 
-        ```js
-        import { parseFile } from 'music-metadata';
+    ```js
+    import { parseFile } from 'music-metadata';
 
-        function parseFiles(audioFiles) {
+    function parseFiles(audioFiles) {
 
-          const audioFile = audioFiles.shift();
+      const audioFile = audioFiles.shift();
 
-          if (audioFile) {
-            return parseFile(audioFile).then(metadata => {
-              // Do great things with the metadata
-              return parseFiles(audioFiles); // process rest of the files AFTER we are finished
-            })
-          }
-        }
+      if (audioFile) {
+        return parseFile(audioFile).then(metadata => {
+          // Do great things with the metadata
+          return parseFiles(audioFiles); // process rest of the files AFTER we are finished
+        })
+      }
+    }
 
-        ```
+    ```
 
-    1. Use async/await
+1. Use async/await
 
-       Use [async/await](https://javascript.info/async-await)
+   Use [async/await](https://javascript.info/async-await)
 
-       ```js
-       import { parseFile } from 'music-metadata';
+   ```js
+   import { parseFile } from 'music-metadata';
 
-       // it is required to declare the function 'async' to allow the use of await
-       async function parseFiles(audioFiles) {
+   // it is required to declare the function 'async' to allow the use of await
+   async function parseFiles(audioFiles) {
 
-           for (const audioFile of audioFiles) {
+       for (const audioFile of audioFiles) {
 
-               // await will ensure the metadata parsing is completed before we move on to the next file
-               const metadata = await parseFile(audioFile);
-               // Do great things with the metadata
-           }
+           // await will ensure the metadata parsing is completed before we move on to the next file
+           const metadata = await parseFile(audioFile);
+           // Do great things with the metadata
        }
-       ```
+   }
+   ```
 
 ## Licence
 

package/lib/amr/AmrParser.js

@@ -2,6 +2,7 @@ import { BasicParser } from '../common/BasicParser.js';
 import { AnsiStringType } from 'token-types';
 import initDebug from 'debug';
 import { FrameHeader } from './AmrToken.js';
+import { EndOfStreamError } from 'strtok3';
 const debug = initDebug('music-metadata:parser:AMR');
 /**
  * There are 8 varying levels of compression. First byte of the frame specifies CMR
@@ -27,8 +28,16 @@ export class AmrParser extends BasicParser {
         let frames = 0;
         const assumedFileLength = this.tokenizer.fileInfo?.size ?? Number.MAX_SAFE_INTEGER;
         if (this.options.duration) {
+            let header;
             while (this.tokenizer.position < assumedFileLength) {
-                const header = await this.tokenizer.readToken(FrameHeader);
+                try {
+                    header = await this.tokenizer.readToken(FrameHeader);
+                }
+                catch (error) {
+                    if (error instanceof EndOfStreamError)
+                        break;
+                    throw error;
+                }
                 /* first byte is rate mode. each rate mode has frame of given length. look it up. */
                 const size = m_block_size[header.frameType];
                 if (size > 0) {

package/lib/amr/AmrToken.d.ts

@@ -1,5 +1,5 @@
 import type { IGetToken } from 'strtok3';
-interface IFrameHeader {
+export interface IFrameHeader {
     frameType: number;
 }
 /**
@@ -8,4 +8,3 @@ interface IFrameHeader {
  * ToDo
  */
 export declare const FrameHeader: IGetToken<IFrameHeader>;
-export {};

package/lib/core.js

@@ -28,8 +28,14 @@ export async function parseBlob(blob, options = {}) {
  * @param fileInfo - File information object or MIME-type string
  * @returns Metadata
  */
-export function parseWebStream(webStream, fileInfo, options = {}) {
-    return parseFromTokenizer(fromWebStream(webStream, { fileInfo: typeof fileInfo === 'string' ? { mimeType: fileInfo } : fileInfo }), options);
+export async function parseWebStream(webStream, fileInfo, options = {}) {
+    const tokenizer = fromWebStream(webStream, { fileInfo: typeof fileInfo === 'string' ? { mimeType: fileInfo } : fileInfo });
+    try {
+        return await parseFromTokenizer(tokenizer, options);
+    }
+    finally {
+        await tokenizer.close();
+    }
 }
 /**
  * Parse audio from memory

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": "10.6.4",
+  "version": "10.6.5",
   "author": {
     "name": "Borewit",
     "url": "https://github.com/Borewit"
@@ -107,7 +107,7 @@
   "dependencies": {
     "@tokenizer/token": "^0.3.0",
     "content-type": "^1.0.5",
-    "debug": "^4.3.7",
+    "debug": "^4.4.0",
     "file-type": "^19.6.0",
     "link": "^2.1.1",
     "media-typer": "^1.1.0",
@@ -124,11 +124,11 @@
     "@types/media-typer": "^1.1.3",
     "@types/mocha": "^10.0.10",
     "@types/node": "^22.10.1",
-    "c8": "^10.1.2",
+    "c8": "^10.1.3",
     "chai": "^5.1.2",
     "chai-as-promised": "^8.0.1",
     "del-cli": "^6.0.0",
-    "mime": "^4.0.4",
+    "mime": "^4.0.6",
     "mocha": "^11.0.1",
     "remark-cli": "^12.0.1",
     "remark-preset-lint-consistent": "^6.0.0",