@audd/sdk 1.5.4 → 1.5.6

package/README.md

@@ -21,7 +21,7 @@ Recognize from a URL:
 ```ts
 import { AudD } from "@audd/sdk";
 
-const audd = new AudD("test");
+const audd = new AudD("your-api-token");
 const song = await audd.recognize("https://audd.tech/example.mp3");
 if (song) {
   console.log(`${song.artist} — ${song.title}`);
@@ -34,7 +34,7 @@ Recognize a local file (Node):
 import { AudD } from "@audd/sdk";
 import { readFile } from "node:fs/promises";
 
-const audd = new AudD("test");
+const audd = new AudD("your-api-token");
 
 // Pass a path…
 const song = await audd.recognize("./clip.mp3");

package/dist/index.cjs

@@ -1169,30 +1169,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