music-metadata 10.4.0 → 10.5.0

package/README.md

@@ -48,6 +48,7 @@ If you find this project useful and would like to support its development, consi
 | ------------- |---------------------------------| -------------------------------------------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------:|
 | AIFF / AIFF-C | Audio Interchange File Format   | [:link:](https://wikipedia.org/wiki/Audio_Interchange_File_Format) | <img src="https://upload.wikimedia.org/wikipedia/commons/8/84/Apple_Computer_Logo_rainbow.svg" width="40" alt="Apple rainbow logo">           |
 | AAC           | ADTS / Advanced Audio Coding    | [:link:](https://en.wikipedia.org/wiki/Advanced_Audio_Coding)      | <img src="https://svgshare.com/i/UT8.svg" width="40" alt="AAC logo">                                                                          |
+| AMR           | Adaptive Multi-Rate audio codec | [:link:](https://en.wikipedia.org/wiki/Adaptive_Multi-Rate_audio_codec) | <img src="https://foreverhits.files.wordpress.com/2015/05/ape_audio.jpg" width="40" alt="Monkey's Audio logo">                           |
 | APE           | Monkey's Audio                  | [:link:](https://wikipedia.org/wiki/Monkey's_Audio)                | <img src="https://foreverhits.files.wordpress.com/2015/05/ape_audio.jpg" width="40" alt="Monkey's Audio logo">                                |
 | ASF           | Advanced Systems Format         | [:link:](https://wikipedia.org/wiki/Advanced_Systems_Format)       |                                                                                                                                               |
 | BWF           | Broadcast Wave Format           | [:link:](https://en.wikipedia.org/wiki/Broadcast_Wave_Format)      |                                                                                                                                               |

package/lib/ParserFactory.js

@@ -17,6 +17,7 @@ import { musepackParserLoader } from './musepack/MusepackLoader.js';
 import { oggParserLoader } from './ogg/OggLoader.js';
 import { wavpackParserLoader } from './wavpack/WavPackLoader.js';
 import { riffParserLoader } from './wav/WaveLoader.js';
+import { amrParserLoader } from './amr/AmrLoader.js';
 const debug = initDebug('music-metadata:parser:factory');
 export function parseHttpContentType(contentType) {
     const type = ContentType.parse(contentType);
@@ -44,7 +45,8 @@ export class ParserFactory {
             wavpackParserLoader,
             musepackParserLoader,
             dsfParserLoader,
-            dsdiffParserLoader
+            dsdiffParserLoader,
+            amrParserLoader
         ].forEach(parser => this.registerParser(parser));
     }
     registerParser(parser) {
@@ -158,6 +160,8 @@ function getParserIdForMimeType(httpContentType) {
                     return 'matroska';
                 case 'dsf':
                     return 'dsf';
+                case 'amr':
+                    return 'amr';
             }
             break;
         case 'video':

package/lib/amr/AmrLoader.d.ts

@@ -0,0 +1,2 @@
+import type { IParserLoader } from '../ParserFactory.js';
+export declare const amrParserLoader: IParserLoader;

package/lib/amr/AmrLoader.js

@@ -0,0 +1,8 @@
+export const amrParserLoader = {
+    parserType: 'amr',
+    extensions: ['.amr'],
+    async load(metadata, tokenizer, options) {
+        return new (await import('./AmrParser.js')).AmrParser(metadata, tokenizer, options);
+    }
+};
+//# sourceMappingURL=AmrLoader.js.map

package/lib/amr/AmrParser.d.ts

@@ -0,0 +1,7 @@
+import { BasicParser } from '../common/BasicParser.js';
+/**
+ * Adaptive Multi-Rate audio codec
+ */
+export declare class AmrParser extends BasicParser {
+    parse(): Promise<void>;
+}

package/lib/amr/AmrParser.js

@@ -0,0 +1,49 @@
+import { BasicParser } from '../common/BasicParser.js';
+import { AnsiStringType } from 'token-types';
+import initDebug from 'debug';
+import { FrameHeader } from './AmrToken.js';
+const debug = initDebug('music-metadata:parser:AMR');
+/**
+ * There are 8 varying levels of compression. First byte of the frame specifies CMR
+ * (codec mode request), values 0-7 are valid for AMR. Each mode have different frame size.
+ * This table reflects that fact.
+ */
+const m_block_size = [12, 13, 15, 17, 19, 20, 26, 31, 5, 0, 0, 0, 0, 0, 0, 0];
+/**
+ * Adaptive Multi-Rate audio codec
+ */
+export class AmrParser extends BasicParser {
+    async parse() {
+        const magicNr = await this.tokenizer.readToken(new AnsiStringType(5));
+        if (magicNr !== '#!AMR') {
+            throw new Error('Invalid AMR file: invalid MAGIC number');
+        }
+        this.metadata.setFormat('container', 'AMR');
+        this.metadata.setFormat('codec', 'AMR');
+        this.metadata.setFormat('sampleRate', 8000);
+        this.metadata.setFormat('bitrate', 64000);
+        this.metadata.setFormat('numberOfChannels', 1);
+        let total_size = 0;
+        let frames = 0;
+        const assumedFileLength = this.tokenizer.fileInfo?.size ?? Number.MAX_SAFE_INTEGER;
+        if (this.options.duration) {
+            while (this.tokenizer.position < assumedFileLength) {
+                const header = await this.tokenizer.readToken(FrameHeader);
+                /* 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) {
+                    total_size += size + 1;
+                    if (total_size > assumedFileLength)
+                        break;
+                    await this.tokenizer.ignore(size);
+                    ++frames;
+                }
+                else {
+                    debug(`Found no-data frame, frame-type: ${header.frameType}. Skipping`);
+                }
+            }
+            this.metadata.setFormat('duration', frames * 0.02);
+        }
+    }
+}
+//# sourceMappingURL=AmrParser.js.map

package/lib/amr/AmrToken.d.ts

@@ -0,0 +1,11 @@
+import type { IGetToken } from 'strtok3';
+interface IFrameHeader {
+    frameType: number;
+}
+/**
+ * ID3v2 header
+ * Ref: http://id3.org/id3v2.3.0#ID3v2_header
+ * ToDo
+ */
+export declare const FrameHeader: IGetToken<IFrameHeader>;
+export {};

package/lib/amr/AmrToken.js

@@ -0,0 +1,15 @@
+import { getBitAllignedNumber } from '../common/Util.js';
+/**
+ * ID3v2 header
+ * Ref: http://id3.org/id3v2.3.0#ID3v2_header
+ * ToDo
+ */
+export const FrameHeader = {
+    len: 1,
+    get: (buf, off) => {
+        return {
+            frameType: getBitAllignedNumber(buf, off, 1, 4)
+        };
+    }
+};
+//# sourceMappingURL=AmrToken.js.map

package/lib/asf/AsfObject.d.ts

@@ -10,7 +10,13 @@ declare const AsfContentParseError_base: {
         stack?: string;
     };
     captureStackTrace(targetObject: object, constructorOpt?: Function): void;
-    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite /**
+     * Specifies the amount of time to buffer data before starting to play the file, in millisecond units.
+     * If this value is nonzero, the Play Duration field and all of the payload Presentation Time fields have been offset
+     * by this amount. Therefore, player software must subtract the value in the preroll field from the play duration and
+     * presentation times to calculate their actual values. It follows that all payload Presentation Time fields need to
+     * be at least this value.
+     */[]) => any) | undefined;
     stackTraceLimit: number;
 };
 export declare class AsfContentParseError extends AsfContentParseError_base {

package/lib/type.d.ts

@@ -521,7 +521,7 @@ export interface IAudioMetadata extends INativeAudioMetadata {
 /**
  * Corresponds with parser module name
  */
-export type ParserType = 'mpeg' | 'apev2' | 'mp4' | 'asf' | 'flac' | 'ogg' | 'aiff' | 'wavpack' | 'riff' | 'musepack' | 'dsf' | 'dsdiff' | 'adts' | 'matroska';
+export type ParserType = 'mpeg' | 'apev2' | 'mp4' | 'asf' | 'flac' | 'ogg' | 'aiff' | 'wavpack' | 'riff' | 'musepack' | 'dsf' | 'dsdiff' | 'adts' | 'matroska' | 'amr';
 export interface IOptions {
     /**
      * default: `false`, if set to `true`, it will parse the whole media file if required to determine the duration.

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.4.0",
+  "version": "10.5.0",
   "author": {
     "name": "Borewit",
     "url": "https://github.com/Borewit"
@@ -105,8 +105,8 @@
   "dependencies": {
     "@tokenizer/token": "^0.3.0",
     "content-type": "^1.0.5",
-    "debug": "^4.3.4",
-    "file-type": "^19.4.1",
+    "debug": "^4.3.7",
+    "file-type": "^19.5.0",
     "media-typer": "^1.1.0",
     "strtok3": "^9.0.0",
     "token-types": "^6.0.0",