@audd/sdk 1.4.7 → 1.4.9

package/README.md

@@ -4,16 +4,9 @@
 [![Contract](https://github.com/AudDMusic/audd-node/actions/workflows/contract.yml/badge.svg)](https://github.com/AudDMusic/audd-node/actions/workflows/contract.yml)
 [![npm](https://img.shields.io/npm/v/@audd/sdk.svg)](https://www.npmjs.com/package/@audd/sdk)
 
-Official TypeScript / Node.js SDK for the [AudD](https://audd.io) music
-recognition API.
+Official TypeScript / Node.js SDK for [AudD](https://audd.io) — music recognition from a short audio clip, a long audio file, or a live stream.
 
-AudD identifies music from a short audio clip, a URL, a long file, or a
-live stream. The HTTPS API is a plain form-POST — every endpoint is
-documented at **[docs.audd.io](https://docs.audd.io)** and you can call
-it from anywhere `fetch` works. This package adds typed result models
-with helpers for cover art, streaming-provider URLs, and previews;
-`AbortSignal`-aware async; ESM and CJS dual-build; and a separate
-browser-safe entry point for tokenless longpoll widgets.
+The [API itself](https://docs.audd.io) is so simple that it can be easily used even without an SDK.
 
 ## Quickstart
 
@@ -21,12 +14,14 @@ browser-safe entry point for tokenless longpoll widgets.
 npm install @audd/sdk
 ```
 
+Get your API token at [dashboard.audd.io](https://dashboard.audd.io).
+
 Recognize from a URL:
 
 ```ts
 import { AudD } from "@audd/sdk";
 
-const audd = new AudD("test"); // grab a real token at https://dashboard.audd.io
+const audd = new AudD("test");
 const song = await audd.recognize("https://audd.tech/example.mp3");
 if (song) {
   console.log(`${song.artist} — ${song.title}`);
@@ -132,16 +127,18 @@ console.log(song.rawResponse);  // the whole result object as the server returne
 flat array of matches:
 
 ```ts
-const matches = await audd.recognizeEnterprise("./show.mp3", {
-  return: ["apple_music", "musicbrainz"],
-  limit: 20,
-});
+const matches = await audd.recognizeEnterprise("./show.mp3", { limit: 20 });
 
 for (const m of matches) {
-  console.log(m.timecode, m.score, m.artist, m.title, m.isrc);
+  console.log(m.timecode, m.artist, m.title);
 }
 ```
 
+`EnterpriseMatch` carries the same core tags plus `score`, `startOffset`,
+`endOffset`, `isrc`, `upc`. Access to `isrc`, `upc`, and `score` requires
+a Startup plan or higher — [contact us](mailto:api@audd.io) for enterprise
+features.
+
 The default per-call timeout is **1 hour** for this endpoint (60s for
 standard recognition); override with `timeoutMs`.
 

package/dist/index.cjs

@@ -355,6 +355,8 @@ var RECOGNITION_KEYS = [
   "release_date",
   "label",
   "song_link",
+  "isrc",
+  "upc",
   "apple_music",
   "spotify",
   "deezer",
@@ -381,6 +383,8 @@ function parseRecognitionResult(raw) {
     releaseDate: asString(r.release_date),
     label: asString(r.label),
     songLink,
+    isrc: asString(r.isrc),
+    upc: asString(r.upc),
     appleMusic: asObject(r.apple_music),
     spotify: asObject(r.spotify),
     deezer: asObject(r.deezer),