@audd/sdk 1.5.8 → 1.5.10

package/README.md

@@ -85,7 +85,7 @@ console.log(song.releaseDate, song.label, song.timecode);
 // AudD's universal song page — links into every provider
 console.log(song.songLink);
 
-// Helpers — driven off songLink, work without any `return` opt-in
+// Helpers — driven off songLink, work without any `returnMetadata` opt-in
 console.log(song.thumbnailUrl);             // cover-art image, or null
 console.log(song.streamingUrl("spotify"));  // direct or lis.tn redirect
 console.log(song.streamingUrls());          // map of provider -> URL
@@ -107,21 +107,21 @@ Valid `returnMetadata` values: `apple_music`, `spotify`, `deezer`, `napster`,
 `musicbrainz`. Blocks are `undefined` when not requested.
 
 `streamingUrl(provider)` prefers the direct provider URL when you
-requested that block via `return`, then falls back to the lis.tn redirect
+requested that block via `returnMetadata`, then falls back to the lis.tn redirect
 when `songLink` is on `lis.tn`. YouTube has only the redirect path.
 
 ## Reading additional metadata
 
 Every model carries an `extras` map with any server-side fields outside
 the typed surface, plus a `rawResponse` of the full unparsed JSON. Use
-`extras` to read undocumented or beta fields:
+`extras` to read fields outside the typed surface:
 
 ```ts
 console.log(song.extras);       // any non-typed top-level fields
 console.log(song.rawResponse);  // the whole result object as the server returned it
 ```
 
-For the **request** side, every call accepts an `extraParameters` map for additional form fields the typed options don't cover — undocumented parameters or beta features:
+For the **request** side, every call accepts an `extraParameters` map for additional form fields the typed options don't cover:
 
 ```ts
 await audd.recognize(url, {

package/dist/index.cjs

@@ -366,9 +366,6 @@ var RECOGNITION_KEYS = [
 function parseRecognitionResult(raw) {
   const r = requireObject(raw, "RecognitionResult");
   const timecode = asString(r.timecode);
-  if (timecode === void 0) {
-    throw new TypeError("RecognitionResult: timecode missing or not string");
-  }
   const audioId = asNumber(r.audio_id);
   const artist = asString(r.artist);
   const title = asString(r.title);
@@ -443,8 +440,6 @@ function parseEnterpriseMatch(raw) {
   const r = requireObject(raw, "EnterpriseMatch");
   const score = asNumber(r.score);
   const timecode = asString(r.timecode);
-  if (score === void 0) throw new TypeError("EnterpriseMatch: score not number");
-  if (timecode === void 0) throw new TypeError("EnterpriseMatch: timecode not string");
   const songLink = asString(r.song_link);
   return {
     score,
@@ -491,12 +486,8 @@ function parseEnterpriseMatch(raw) {
 var ENTERPRISE_CHUNK_KEYS = ["songs", "offset"];
 function parseEnterpriseChunkResult(raw) {
   const r = requireObject(raw, "EnterpriseChunkResult");
-  const songsRaw = r.songs;
-  if (!Array.isArray(songsRaw)) {
-    throw new TypeError("EnterpriseChunkResult: songs not array");
-  }
+  const songsRaw = Array.isArray(r.songs) ? r.songs : [];
   const offset = asString(r.offset);
-  if (offset === void 0) throw new TypeError("EnterpriseChunkResult: offset not string");
   return {
     songs: songsRaw.map(parseEnterpriseMatch),
     offset,
@@ -510,9 +501,6 @@ function parseStream(raw) {
   const radioId = asNumber(r.radio_id);
   const url = asString(r.url);
   const streamRunning = asBoolean(r.stream_running);
-  if (radioId === void 0) throw new TypeError("Stream: radio_id not number");
-  if (url === void 0) throw new TypeError("Stream: url not string");
-  if (streamRunning === void 0) throw new TypeError("Stream: stream_running not boolean");
   return {
     radioId,
     url,
@@ -543,9 +531,6 @@ function parseStreamCallbackSong(raw) {
   const artist = asString(r.artist);
   const title = asString(r.title);
   const score = asNumber(r.score);
-  if (artist === void 0) throw new TypeError("StreamCallbackSong: artist not string");
-  if (title === void 0) throw new TypeError("StreamCallbackSong: title not string");
-  if (score === void 0) throw new TypeError("StreamCallbackSong: score not number");
   const musicbrainz = Array.isArray(r.musicbrainz) ? r.musicbrainz.filter((x) => asObject(x) !== void 0) : void 0;
   return {
     artist,
@@ -574,13 +559,9 @@ var STREAM_CALLBACK_MATCH_KEYS = [
 function parseStreamCallbackMatch(raw) {
   const r = requireObject(raw, "StreamCallbackMatch");
   const radioId = asNumber(r.radio_id);
-  if (radioId === void 0) throw new TypeError("StreamCallbackMatch: radio_id not number");
-  const resultsRaw = r.results;
-  if (!Array.isArray(resultsRaw)) throw new TypeError("StreamCallbackMatch: results not array");
-  if (resultsRaw.length === 0) throw new TypeError("StreamCallbackMatch: results is empty");
-  const songs = resultsRaw.map(parseStreamCallbackSong);
+  const resultsRaw = Array.isArray(r.results) ? r.results : [];
+  const songs = resultsRaw.filter((x) => asObject(x) !== void 0).map(parseStreamCallbackSong);
   const [first, ...rest] = songs;
-  if (first === void 0) throw new TypeError("StreamCallbackMatch: results is empty");
   return {
     radioId,
     timestamp: asString(r.timestamp),
@@ -600,14 +581,8 @@ var STREAM_CALLBACK_NOTIFICATION_KEYS = [
 function parseStreamCallbackNotification(raw) {
   const r = requireObject(raw, "StreamCallbackNotification");
   const radioId = asNumber(r.radio_id);
-  if (radioId === void 0)
-    throw new TypeError("StreamCallbackNotification: radio_id not number");
   const code = asNumber(r.notification_code);
-  if (code === void 0)
-    throw new TypeError("StreamCallbackNotification: notification_code not number");
   const message = asString(r.notification_message);
-  if (message === void 0)
-    throw new TypeError("StreamCallbackNotification: notification_message not string");
   return {
     radioId,
     streamRunning: asBoolean(r.stream_running),
@@ -631,8 +606,6 @@ function parseLyricsResult(raw) {
   const r = requireObject(raw, "LyricsResult");
   const artist = asString(r.artist);
   const title = asString(r.title);
-  if (artist === void 0) throw new TypeError("LyricsResult: artist not string");
-  if (title === void 0) throw new TypeError("LyricsResult: title not string");
   return {
     artist,
     title,