@audd/sdk 1.5.12 → 1.5.14

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { c as StreamCallbackMatch, d as StreamCallbackNotification, H as HttpClient, S as Stream, L as LongpollPoll, b as LyricsResult, F as FetchLike, R as RecognitionResult, a as EnterpriseMatch } from './longpollCore-BXx8PRmC.cjs';
 export { E as EnterpriseChunkResult, e as StreamCallbackSong, f as StreamingProvider } from './longpollCore-BXx8PRmC.cjs';
 
-declare const VERSION = "1.5.12";
+declare const VERSION = "1.5.14";
 
 /** Inspection events emitted around each HTTP request the SDK makes. */
 
@@ -365,8 +365,8 @@ declare class CustomCatalog {
     constructor(http: HttpClient, noRetryPolicy: RetryPolicy, onEvent?: OnEventHook | undefined);
     /**
      * **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.
@@ -496,7 +496,8 @@ declare class AudD {
     /** Lyrics search + raw-request escape hatch. */
     get advanced(): 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.

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { c as StreamCallbackMatch, d as StreamCallbackNotification, H as HttpClient, S as Stream, L as LongpollPoll, b as LyricsResult, F as FetchLike, R as RecognitionResult, a as EnterpriseMatch } from './longpollCore-BXx8PRmC.js';
 export { E as EnterpriseChunkResult, e as StreamCallbackSong, f as StreamingProvider } from './longpollCore-BXx8PRmC.js';
 
-declare const VERSION = "1.5.12";
+declare const VERSION = "1.5.14";
 
 /** Inspection events emitted around each HTTP request the SDK makes. */
 
@@ -365,8 +365,8 @@ declare class CustomCatalog {
     constructor(http: HttpClient, noRetryPolicy: RetryPolicy, onEvent?: OnEventHook | undefined);
     /**
      * **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.
@@ -496,7 +496,8 @@ declare class AudD {
     /** Lyrics search + raw-request escape hatch. */
     get advanced(): 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.

package/dist/index.js

@@ -3,7 +3,7 @@ import * as path from 'path';
 import { createHash } from 'crypto';
 
 // src/version.ts
-var VERSION = "1.5.12";
+var VERSION = "1.5.14";
 
 // src/errors.ts
 var AudDError = class extends Error {
@@ -133,7 +133,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 ?? "";
@@ -317,13 +317,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;
@@ -420,7 +445,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);
@@ -508,8 +533,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),
@@ -565,7 +590,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 {
@@ -625,14 +650,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),
@@ -647,8 +672,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,
@@ -677,9 +702,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),
@@ -1325,8 +1350,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.
@@ -1582,7 +1607,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.