music-metadata 10.4.0 → 10.5.1

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/default.cjs

@@ -1,5 +1,5 @@
-// CommonJS core (default) entry point
-"use strict";
-module.exports = {
-  loadMusicMetadata: () => import('./core.js'),
-};
+// CommonJS core (default) entry point
+"use strict";
+module.exports = {
+  loadMusicMetadata: () => import('./core.js'),
+};

package/lib/node.cjs

@@ -1,5 +1,5 @@
-// CommonJS Node entry point
-"use strict";
-module.exports = {
-  loadMusicMetadata: () => import('./index.js'),
-};
+// CommonJS Node entry point
+"use strict";
+module.exports = {
+  loadMusicMetadata: () => import('./index.js'),
+};

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,148 +1,148 @@
-{
-  "name": "music-metadata",
-  "description": "Music metadata parser for Node.js, supporting virtual any audio and tag format.",
-  "version": "10.4.0",
-  "author": {
-    "name": "Borewit",
-    "url": "https://github.com/Borewit"
-  },
-  "funding": [
-    {
-      "type": "github",
-      "url": "https://github.com/sponsors/Borewit"
-    },
-    {
-      "type": "buymeacoffee",
-      "url": "https://buymeacoffee.com/borewit"
-    }
-  ],
-  "type": "module",
-  "exports": {
-    ".": {
-      "node": {
-        "import": "./lib/index.js",
-        "require": "./lib/node.cjs",
-        "types": "./lib/index.d.ts"
-      },
-      "default": {
-        "import": "./lib/core.js",
-        "require": "./lib/default.cjs",
-        "types": "./lib/core.d.ts"
-      }
-    }
-  },
-  "types": "lib/index.d.ts",
-  "files": [
-    "lib/**/*.js",
-    "lib/**/*.d.ts",
-    "lib/*.cjs"
-  ],
-  "keywords": [
-    "music",
-    "metadata",
-    "meta",
-    "audio",
-    "tag",
-    "tags",
-    "duration",
-    "MusicBrainz",
-    "Discogs",
-    "Picard",
-    "ID3",
-    "ID3v1",
-    "ID3v2",
-    "m4a",
-    "m4b",
-    "mp3",
-    "mp4",
-    "Vorbis",
-    "ogg",
-    "flac",
-    "Matroska",
-    "WebM",
-    "EBML",
-    "asf",
-    "wma",
-    "wmv",
-    "ape",
-    "MonkeyAudio",
-    "aiff",
-    "wav",
-    "WavPack",
-    "Opus",
-    "speex",
-    "musepack",
-    "mpc",
-    "dsd",
-    "dsf",
-    "mpc",
-    "dff",
-    "dsdiff",
-    "aac",
-    "adts",
-    "length",
-    "chapter",
-    "info",
-    "parse",
-    "parser",
-    "bwf"
-  ],
-  "scripts": {
-    "clean": "del-cli 'lib/**/*.js' 'lib/**/*.js.map' 'lib/**/*.d.ts' 'src/**/*.d.ts' 'test/**/*.js' 'test/**/*.js.map' 'test/**/*.js' 'test/**/*.js.map' 'doc-gen/**/*.js' 'doc-gen/**/*.js.map'",
-    "compile-src": "tsc -p lib",
-    "compile-test": "tsc -p test",
-    "compile-doc": "tsc -p doc-gen",
-    "compile": "yarn run  compile-src && yarn compile-test && yarn compile-doc",
-    "lint-ts": "biome check",
-    "lint-md": "yarn run remark -u remark-preset-lint-consistent .",
-    "lint": "yarn run lint-ts && yarn run lint-md",
-    "test": "mocha",
-    "build": "yarn run clean && yarn compile && yarn run doc-gen",
-    "test-coverage": "c8 yarn run test",
-    "send-codacy": "c8 report --reporter=text-lcov | codacy-coverage",
-    "doc-gen": "yarn node doc-gen/gen.js"
-  },
-  "dependencies": {
-    "@tokenizer/token": "^0.3.0",
-    "content-type": "^1.0.5",
-    "debug": "^4.3.4",
-    "file-type": "^19.4.1",
-    "media-typer": "^1.1.0",
-    "strtok3": "^9.0.0",
-    "token-types": "^6.0.0",
-    "uint8array-extras": "^1.4.0"
-  },
-  "devDependencies": {
-    "@biomejs/biome": "1.8.3",
-    "@types/chai": "^4.3.19",
-    "@types/chai-as-promised": "^8.0.0",
-    "@types/content-type": "^1.1.8",
-    "@types/debug": "^4.1.12",
-    "@types/media-typer": "^1.1.3",
-    "@types/mocha": "^10.0.7",
-    "@types/node": "^22.5.4",
-    "c8": "^10.1.2",
-    "chai": "^5.1.1",
-    "chai-as-promised": "^8.0.0",
-    "del-cli": "^5.1.0",
-    "mime": "^4.0.4",
-    "mocha": "^10.7.3",
-    "prettier": "^3.3.3",
-    "remark-cli": "^12.0.1",
-    "remark-preset-lint-consistent": "^6.0.0",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.5.3"
-  },
-  "engines": {
-    "node": ">=16.0.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/borewit/music-metadata.git"
-  },
-  "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/Borewit/music-metadata/issues"
-  },
-  "packageManager": "yarn@4.3.1"
-}
+{
+  "name": "music-metadata",
+  "description": "Music metadata parser for Node.js, supporting virtual any audio and tag format.",
+  "version": "10.5.1",
+  "author": {
+    "name": "Borewit",
+    "url": "https://github.com/Borewit"
+  },
+  "funding": [
+    {
+      "type": "github",
+      "url": "https://github.com/sponsors/Borewit"
+    },
+    {
+      "type": "buymeacoffee",
+      "url": "https://buymeacoffee.com/borewit"
+    }
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "node": {
+        "import": "./lib/index.js",
+        "require": "./lib/node.cjs",
+        "types": "./lib/index.d.ts"
+      },
+      "default": {
+        "import": "./lib/core.js",
+        "require": "./lib/default.cjs",
+        "types": "./lib/core.d.ts"
+      }
+    }
+  },
+  "types": "lib/index.d.ts",
+  "files": [
+    "lib/**/*.js",
+    "lib/**/*.d.ts",
+    "lib/*.cjs"
+  ],
+  "keywords": [
+    "music",
+    "metadata",
+    "meta",
+    "audio",
+    "tag",
+    "tags",
+    "duration",
+    "MusicBrainz",
+    "Discogs",
+    "Picard",
+    "ID3",
+    "ID3v1",
+    "ID3v2",
+    "m4a",
+    "m4b",
+    "mp3",
+    "mp4",
+    "Vorbis",
+    "ogg",
+    "flac",
+    "Matroska",
+    "WebM",
+    "EBML",
+    "asf",
+    "wma",
+    "wmv",
+    "ape",
+    "MonkeyAudio",
+    "aiff",
+    "wav",
+    "WavPack",
+    "Opus",
+    "speex",
+    "musepack",
+    "mpc",
+    "dsd",
+    "dsf",
+    "mpc",
+    "dff",
+    "dsdiff",
+    "aac",
+    "adts",
+    "length",
+    "chapter",
+    "info",
+    "parse",
+    "parser",
+    "bwf"
+  ],
+  "scripts": {
+    "clean": "del-cli 'lib/**/*.js' 'lib/**/*.js.map' 'lib/**/*.d.ts' 'src/**/*.d.ts' 'test/**/*.js' 'test/**/*.js.map' 'test/**/*.js' 'test/**/*.js.map' 'doc-gen/**/*.js' 'doc-gen/**/*.js.map'",
+    "compile-src": "tsc -p lib",
+    "compile-test": "tsc -p test",
+    "compile-doc": "tsc -p doc-gen",
+    "compile": "yarn run  compile-src && yarn compile-test && yarn compile-doc",
+    "lint-ts": "biome check",
+    "lint-md": "yarn run remark -u remark-preset-lint-consistent .",
+    "lint": "yarn run lint-ts && yarn run lint-md",
+    "test": "mocha",
+    "build": "yarn run clean && yarn compile && yarn run doc-gen",
+    "test-coverage": "c8 yarn run test",
+    "send-codacy": "c8 report --reporter=text-lcov | codacy-coverage",
+    "doc-gen": "yarn node doc-gen/gen.js"
+  },
+  "dependencies": {
+    "@tokenizer/token": "^0.3.0",
+    "content-type": "^1.0.5",
+    "debug": "^4.3.7",
+    "file-type": "^19.6.0",
+    "media-typer": "^1.1.0",
+    "strtok3": "^9.0.1",
+    "token-types": "^6.0.0",
+    "uint8array-extras": "^1.4.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "1.9.3",
+    "@types/chai": "^5.0.0",
+    "@types/chai-as-promised": "^8.0.1",
+    "@types/content-type": "^1.1.8",
+    "@types/debug": "^4.1.12",
+    "@types/media-typer": "^1.1.3",
+    "@types/mocha": "^10.0.9",
+    "@types/node": "^22.7.5",
+    "c8": "^10.1.2",
+    "chai": "^5.1.1",
+    "chai-as-promised": "^8.0.0",
+    "del-cli": "^6.0.0",
+    "mime": "^4.0.4",
+    "mocha": "^10.7.3",
+    "prettier": "^3.3.3",
+    "remark-cli": "^12.0.1",
+    "remark-preset-lint-consistent": "^6.0.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.6.3"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/borewit/music-metadata.git"
+  },
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/Borewit/music-metadata/issues"
+  },
+  "packageManager": "yarn@4.3.1"
+}