music-metadata 10.8.3 → 10.9.1

package/README.md

@@ -771,17 +771,30 @@ Dependency list:
 
 ## CommonJS backward compatibility
 
-For legacy CommonJS projects needing to load the `music-metadata` ESM module, you can use the `loadMusicMetadata` function:
+Using Node.js ≥ 22, which is support loading ESM module via require 
 ```js
-const { loadMusicMetadata } = require('music-metadata');
+const mm = require('music-metadata');
+```
 
+For older Node.js version < 22, you need to dynamically import **music-metadata**:
+```js
 (async () => {
   // Dynamically loads the ESM module in a CommonJS project
-  const mm = await loadMusicMetadata();
-
-  const metadata = await mm.parseFile('/path/to/your/file');
+  const mm = await import('music-metadata');
 })();
+```
+
+For CommonJS TypeScript projects, using a Node.js version < 22, you can use [load-esm](https://github.com/Borewit/load-esm):
+
+This method shall replace the embedded CJS loader `loadMusicMetadata()` function.
 
+```js
+import {loadEsm} from 'load-esm';
+
+(async () => {
+  // Dynamically loads the ESM module in a CommonJS project
+  const mm = await loadEsm<typeof import('music-metadata')>('music-metadata');
+})();
 ```
 
 > [!NOTE]

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.8.3",
+  "version": "10.9.1",
   "author": {
     "name": "Borewit",
     "url": "https://github.com/Borewit"
@@ -18,17 +18,17 @@
   ],
   "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"
-      }
+    "node": {
+      "import": "./lib/index.js",
+      "module-sync": "./lib/index.js",
+      "require": "./lib/node.cjs",
+      "types": "./lib/index.d.ts"
+    },
+    "default": {
+      "import": "./lib/core.js",
+      "module-sync": "./lib/core.js",
+      "require": "./lib/default.cjs",
+      "types": "./lib/core.d.ts"
     }
   },
   "types": "lib/index.d.ts",
@@ -123,9 +123,9 @@
     "@types/debug": "^4.1.12",
     "@types/media-typer": "^1.1.3",
     "@types/mocha": "^10.0.10",
-    "@types/node": "^22.13.1",
+    "@types/node": "^22.13.4",
     "c8": "^10.1.3",
-    "chai": "^5.1.2",
+    "chai": "^5.2.0",
     "chai-as-promised": "^8.0.1",
     "del-cli": "^6.0.0",
     "mime": "^4.0.6",