@audd/sdk 1.5.5 → 1.5.7

package/README.md

@@ -286,9 +286,9 @@ callback URL set, and the preflight surfaces that as an actionable
 error. Pass `skipCallbackCheck: true` to bypass.
 
 ```ts
-const category = audd.streams.deriveLongpollCategory(12345); // pure, no network call
-const poll = await audd.streams.longpoll(category, { timeout: 30 });
+const radioId = 1; // any integer you choose — your handle for this stream
 
+const poll = await audd.streams.longpoll({ radioId, timeout: 30 });
 for await (const m of poll.matches) {
   console.log(m.song.artist, m.song.title);
 }

package/dist/index.cjs

@@ -684,6 +684,8 @@ function shouldRetryResponse(resp, retryClass) {
       return s >= HTTP_SERVER_ERROR_FLOOR;
     case "mutating":
       return false;
+    case "none":
+      return false;
   }
 }
 function shouldRetryError(err, retryClass) {
@@ -694,6 +696,8 @@ function shouldRetryError(err, retryClass) {
       return isPreUploadConnectionError(err);
     case "mutating":
       return isPreUploadConnectionError(err);
+    case "none":
+      return false;
   }
 }
 function sleep(ms) {
@@ -1169,30 +1173,42 @@ var Streams = class {
   parseCallback(body) {
     return parseCallback(body);
   }
-  /**
-   * Long-poll the AudD subscription endpoint.
-   *
-   * Returns a {@link LongpollPoll} handle with three async-iterables —
-   * `matches`, `notifications`, `errors` — that are filled by a background
-   * loop. Iterate them independently or in parallel via `Promise.all([...])`.
-   *
-   * Before the first request the SDK runs a one-time `getCallbackUrl`
-   * preflight: AudD silently discards events for accounts that haven't set a
-   * callback URL, and the preflight surfaces that misconfiguration as an
-   * actionable {@link AudDInvalidRequestError}. Pass `skipCallbackCheck: true`
-   * to bypass.
-   */
-  async longpoll(category, opts = {}) {
-    if (opts.skipCallbackCheck !== true) {
+  async longpoll(arg1, opts = {}) {
+    let category;
+    let effectiveOpts;
+    if (typeof arg1 === "string") {
+      category = arg1;
+      effectiveOpts = opts;
+    } else {
+      effectiveOpts = arg1;
+      const hasRadioId = arg1.radioId !== void 0;
+      const hasCategory = arg1.category !== void 0;
+      if (hasRadioId && hasCategory) {
+        throw new AudDInvalidRequestError({
+          errorCode: 0,
+          message: "longpoll(): pass exactly one of `radioId` or `category` \u2014 got both.",
+          httpStatus: 0
+        });
+      }
+      if (!hasRadioId && !hasCategory) {
+        throw new AudDInvalidRequestError({
+          errorCode: 0,
+          message: "longpoll(): pass exactly one of `radioId` or `category` \u2014 got neither.",
+          httpStatus: 0
+        });
+      }
+      category = hasRadioId ? this.deriveLongpollCategory(arg1.radioId) : arg1.category;
+    }
+    if (effectiveOpts.skipCallbackCheck !== true) {
       await this.preflightCallbackUrl();
     }
-    const timeoutSec = opts.timeout ?? 50;
+    const timeoutSec = effectiveOpts.timeout ?? 50;
     const httpClient = this.http;
     const readPolicy = this.readPolicy;
     return startLongpoll({
       category,
       timeout: timeoutSec,
-      sinceTime: opts.sinceTime,
+      sinceTime: effectiveOpts.sinceTime,
       fetchOnce: (params, signal) => runRetried(
         () => httpClient.get(`${API_BASE}/longpoll/`, params, { signal }),
         readPolicy
@@ -1254,12 +1270,12 @@ async function runRetried2(fn, policy) {
   }
 }
 var CustomCatalog = class {
-  constructor(http, mutatingPolicy) {
+  constructor(http, noRetryPolicy) {
     this.http = http;
-    this.mutatingPolicy = mutatingPolicy;
+    this.noRetryPolicy = noRetryPolicy;
   }
   http;
-  mutatingPolicy;
+  noRetryPolicy;
   /**
    * **This is NOT how you submit audio for music recognition.** For
    * recognition, use `audd.recognize()` (or `audd.recognizeEnterprise()` for
@@ -1271,6 +1287,11 @@ var CustomCatalog = class {
    * Calling this again with the same `audioId` re-fingerprints that slot.
    * There is no public list/delete endpoint; track `audioId` ↔ song
    * mappings on your side.
+   *
+   * **No automatic retry.** Custom-catalog upload is metered, and a transport
+   * failure could otherwise cause a silent re-upload that double-charges. Any
+   * 5xx or pre-upload connection error surfaces as a clean exception — the
+   * caller decides whether to retry.
    */
   async add(opts) {
     const reopen = prepareSource(opts.source);
@@ -1279,7 +1300,7 @@ var CustomCatalog = class {
       const prepared = await reopen();
       const fields = { ...prepared.fields, audio_id: audioId };
       return this.http.postForm(UPLOAD_URL, fields);
-    }, this.mutatingPolicy);
+    }, this.noRetryPolicy);
     decodeSuccess2(resp.jsonBody, resp.httpStatus, resp.requestId);
   }
 };
@@ -1523,7 +1544,7 @@ var AudD = class {
   /** Sub-namespace for the private fingerprint catalog. NOT for recognition. */
   get customCatalog() {
     if (this._customCatalog === void 0) {
-      this._customCatalog = new CustomCatalog(this._http, this.policyFor("mutating"));
+      this._customCatalog = new CustomCatalog(this._http, this.policyFor("none"));
     }
     return this._customCatalog;
   }