@audd/sdk 1.5.12 → 1.5.14

package/README.md

@@ -104,7 +104,7 @@ console.log(song?.spotify?.uri);      // spotify:track:...
 console.log(song?.previewUrl());      // first preview across requested providers, or null
 ```
 
-Valid `returnMetadata` values: `apple_music`, `spotify`, `deezer`, `napster`,
+Valid `returnMetadata` values: `apple_music`, `spotify`, `deezer`,
 `musicbrainz`. Blocks are `undefined` when not requested.
 
 `streamingUrl(provider)` prefers the direct provider URL when you
@@ -135,8 +135,8 @@ The same `extraParameters` field is on `RecognizeEnterpriseOptions`, `SetCallbac
 
 ## Long files (enterprise)
 
-`recognizeEnterprise` accepts files up to several hours and returns a
-flat array of matches:
+`recognizeEnterprise` scans the whole file and returns a flat array of
+matches:
 
 ```ts
 const matches = await audd.recognizeEnterprise("./show.mp3", { limit: 20 });

package/dist/index.cjs

@@ -25,7 +25,7 @@ function _interopNamespace(e) {
 var path__namespace = /*#__PURE__*/_interopNamespace(path);
 
 // src/version.ts
-var VERSION = "1.5.12";
+var VERSION = "1.5.14";
 
 // src/errors.ts
 var AudDError = class extends Error {
@@ -155,7 +155,7 @@ function brandedMessageOf(result) {
   if (typeof r.title === "string" && r.title.length > 0) parts.push(r.title);
   return parts.length === 0 ? null : parts.join(" \u2014 ");
 }
-var CUSTOM_CATALOG_PREFIX = "Adding songs to your custom catalog requires enterprise access that isn't enabled on your account.\n\nNote: the custom-catalog endpoint is for adding songs to your private fingerprint database, not for music recognition. If you intended to identify music, use recognize(...) (or recognizeEnterprise(...) for files longer than 25 seconds) instead.\n\nTo request custom-catalog access, contact api@audd.io.\n\n";
+var CUSTOM_CATALOG_PREFIX = "Adding songs to your custom catalog requires enterprise access that isn't enabled on your account.\n\nNote: the custom-catalog endpoint is for adding songs to your private fingerprint database, not for music recognition. If you intended to identify music, use recognize(...) (or recognizeEnterprise(...) to scan beyond the first 12 seconds of a file) instead.\n\nTo request custom-catalog access, contact api@audd.io.\n\n";
 function raiseFromErrorResponse(body, opts) {
   const code = body.error?.error_code ?? 0;
   const message = body.error?.error_message ?? "";
@@ -339,13 +339,38 @@ function asObjectLenient(raw) {
   return asObject(raw) ?? {};
 }
 function asString(v) {
-  return typeof v === "string" ? v : void 0;
+  if (typeof v === "string") return v;
+  if (typeof v === "number" || typeof v === "boolean") return String(v);
+  return void 0;
+}
+function toFiniteNumber(v) {
+  if (typeof v === "number") return Number.isFinite(v) ? v : void 0;
+  if (typeof v === "boolean") return v ? 1 : 0;
+  if (typeof v === "string") {
+    const t = v.trim();
+    if (t === "") return void 0;
+    const n = Number(t);
+    return Number.isFinite(n) ? n : void 0;
+  }
+  return void 0;
 }
 function asNumber(v) {
-  return typeof v === "number" ? v : void 0;
+  return toFiniteNumber(v);
+}
+function asInteger(v) {
+  const n = toFiniteNumber(v);
+  return n === void 0 ? void 0 : Math.trunc(n);
 }
 function asBoolean(v) {
-  return typeof v === "boolean" ? v : void 0;
+  if (typeof v === "boolean") return v;
+  if (typeof v === "number") return v !== 0;
+  if (typeof v === "string") {
+    const t = v.trim().toLowerCase();
+    if (t === "true" || t === "1" || t === "yes" || t === "on") return true;
+    if (t === "false" || t === "0" || t === "no" || t === "off" || t === "") return false;
+    return void 0;
+  }
+  return void 0;
 }
 function parseOffsetToSeconds(o) {
   if (o === void 0 || o === null) return void 0;
@@ -442,7 +467,7 @@ var RECOGNITION_KEYS = [
 function parseRecognitionResult(raw) {
   const r = asObjectLenient(raw);
   const timecode = asString(r.timecode);
-  const audioId = asNumber(r.audio_id);
+  const audioId = asInteger(r.audio_id);
   const artist = asString(r.artist);
   const title = asString(r.title);
   const songLink = asString(r.song_link);
@@ -530,8 +555,8 @@ function parseEnterpriseMatch(raw) {
     isrc: asString(r.isrc),
     upc: asString(r.upc),
     songLink,
-    startOffset: asNumber(r.start_offset),
-    endOffset: asNumber(r.end_offset),
+    startOffset: asInteger(r.start_offset),
+    endOffset: asInteger(r.end_offset),
     startSeconds: void 0,
     endSeconds: void 0,
     extras: pickExtras(r, ENTERPRISE_MATCH_KEYS),
@@ -587,7 +612,7 @@ function parseEnterpriseChunkResult(raw) {
 var STREAM_KEYS = ["radio_id", "url", "stream_running", "longpoll_category"];
 function parseStream(raw) {
   const r = asObjectLenient(raw);
-  const radioId = asNumber(r.radio_id);
+  const radioId = asInteger(r.radio_id);
   const url = asString(r.url);
   const streamRunning = asBoolean(r.stream_running);
   return {
@@ -647,14 +672,14 @@ var STREAM_CALLBACK_MATCH_KEYS = [
 ];
 function parseStreamCallbackMatch(raw) {
   const r = asObjectLenient(raw);
-  const radioId = asNumber(r.radio_id);
+  const radioId = asInteger(r.radio_id);
   const resultsRaw = Array.isArray(r.results) ? r.results : [];
   const songs = resultsRaw.filter((x) => asObject(x) !== void 0).map(parseStreamCallbackSong);
   const [first, ...rest] = songs;
   return {
     radioId,
     timestamp: asString(r.timestamp),
-    playLength: asNumber(r.play_length),
+    playLength: asInteger(r.play_length),
     song: first,
     alternatives: rest,
     extras: pickExtras(r, STREAM_CALLBACK_MATCH_KEYS),
@@ -669,8 +694,8 @@ var STREAM_CALLBACK_NOTIFICATION_KEYS = [
 ];
 function parseStreamCallbackNotification(raw) {
   const r = asObjectLenient(raw);
-  const radioId = asNumber(r.radio_id);
-  const code = asNumber(r.notification_code);
+  const radioId = asInteger(r.radio_id);
+  const code = asInteger(r.notification_code);
   const message = asString(r.notification_message);
   return {
     radioId,
@@ -699,9 +724,9 @@ function parseLyricsResult(raw) {
     artist,
     title,
     lyrics: asString(r.lyrics),
-    songId: asNumber(r.song_id),
+    songId: asInteger(r.song_id),
     fullTitle: asString(r.full_title),
-    artistId: asNumber(r.artist_id),
+    artistId: asInteger(r.artist_id),
     songLink: asString(r.song_link),
     media: asString(r.media),
     extras: pickExtras(r, LYRICS_KEYS),
@@ -1347,8 +1372,8 @@ var CustomCatalog = class {
   onEvent;
   /**
    * **This is NOT how you submit audio for music recognition.** For
-   * recognition, use `audd.recognize()` (or `audd.recognizeEnterprise()` for
-   * files longer than 25 seconds). This method adds a song to your
+   * recognition, use `audd.recognize()` (or `audd.recognizeEnterprise()` to scan
+   * beyond the first 12 seconds of a file). This method adds a song to your
    * **private fingerprint catalog** so AudD's recognition can later identify
    * *your own* tracks for *your account only*. Requires special access —
    * contact api@audd.io if you need it enabled.
@@ -1604,7 +1629,8 @@ var AudD = class {
     return this._advanced;
   }
   /**
-   * Recognize a short audio clip (≤25s) from a URL, file path, Blob, or bytes.
+   * Recognize a song from an audio clip given as a URL, file path, Blob, or
+   * bytes; only the first 12 seconds are analyzed.
    *
    * Returns `null` when the server returns `status=success` with `result=null`
    * (no match) — distinct from a thrown error.