@audd/sdk 1.5.7 → 1.5.9

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { S as StreamCallbackMatch, a as StreamCallbackNotification, H as HttpClient, b as Stream, L as LongpollPoll, c as LyricsResult, F as FetchLike, R as RecognitionResult, E as EnterpriseMatch } from './longpollCore-DMBdcGSM.cjs';
 export { d as EnterpriseChunkResult, e as StreamCallbackSong, f as StreamingProvider } from './longpollCore-DMBdcGSM.cjs';
 
-declare const VERSION = "1.4.6";
+declare const VERSION = "1.5.8";
 
 /**
  * Auto-detect what kind of audio source the caller passed and convert to
@@ -219,12 +219,22 @@ declare function handleCallback(req: CallbackRequestLike): Promise<ParsedCallbac
 
 interface SetCallbackUrlOptions {
     returnMetadata?: string | string[];
+    /**
+     * Additional form fields the typed options don't cover. Typed options
+     * (`url`) win on collision.
+     */
+    extraParameters?: Record<string, string>;
 }
 interface AddStreamOptions {
     url: string;
     radioId: number;
     /** "before" delivers callbacks at song start; default delivers at song end. */
     callbacks?: "before" | string;
+    /**
+     * Additional form fields the typed options don't cover. Typed options
+     * (`url`, `radioId`, `callbacks`) win on collision.
+     */
+    extraParameters?: Record<string, string>;
 }
 interface LongpollOptions {
     sinceTime?: number;
@@ -397,7 +407,7 @@ interface AudDOptions {
 }
 type ReturnMetadata = "apple_music" | "spotify" | "deezer" | "napster" | "musicbrainz" | string;
 interface RecognizeOptions {
-    return?: ReturnMetadata | ReturnMetadata[];
+    returnMetadata?: ReturnMetadata | ReturnMetadata[];
     market?: string;
     /** Per-call timeout in ms; overrides the client default. */
     timeoutMs?: number;
@@ -408,9 +418,14 @@ interface RecognizeOptions {
      * already done metered work and the credit is consumed regardless.
      */
     signal?: AbortSignal;
+    /**
+     * Additional form fields the typed options don't cover — undocumented
+     * parameters, beta features. Typed options win on collision.
+     */
+    extraParameters?: Record<string, string>;
 }
 interface RecognizeEnterpriseOptions {
-    return?: ReturnMetadata | ReturnMetadata[];
+    returnMetadata?: ReturnMetadata | ReturnMetadata[];
     skip?: number;
     every?: number;
     limit?: number;
@@ -423,6 +438,11 @@ interface RecognizeEnterpriseOptions {
      * For multi-hour enterprise calls, this is the right way to cancel.
      */
     signal?: AbortSignal;
+    /**
+     * Additional form fields the typed options don't cover. Typed options
+     * win on collision.
+     */
+    extraParameters?: Record<string, string>;
 }
 /**
  * The AudD client. Async-only — every method returns a `Promise`.

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { S as StreamCallbackMatch, a as StreamCallbackNotification, H as HttpClient, b as Stream, L as LongpollPoll, c as LyricsResult, F as FetchLike, R as RecognitionResult, E as EnterpriseMatch } from './longpollCore-DMBdcGSM.js';
 export { d as EnterpriseChunkResult, e as StreamCallbackSong, f as StreamingProvider } from './longpollCore-DMBdcGSM.js';
 
-declare const VERSION = "1.4.6";
+declare const VERSION = "1.5.8";
 
 /**
  * Auto-detect what kind of audio source the caller passed and convert to
@@ -219,12 +219,22 @@ declare function handleCallback(req: CallbackRequestLike): Promise<ParsedCallbac
 
 interface SetCallbackUrlOptions {
     returnMetadata?: string | string[];
+    /**
+     * Additional form fields the typed options don't cover. Typed options
+     * (`url`) win on collision.
+     */
+    extraParameters?: Record<string, string>;
 }
 interface AddStreamOptions {
     url: string;
     radioId: number;
     /** "before" delivers callbacks at song start; default delivers at song end. */
     callbacks?: "before" | string;
+    /**
+     * Additional form fields the typed options don't cover. Typed options
+     * (`url`, `radioId`, `callbacks`) win on collision.
+     */
+    extraParameters?: Record<string, string>;
 }
 interface LongpollOptions {
     sinceTime?: number;
@@ -397,7 +407,7 @@ interface AudDOptions {
 }
 type ReturnMetadata = "apple_music" | "spotify" | "deezer" | "napster" | "musicbrainz" | string;
 interface RecognizeOptions {
-    return?: ReturnMetadata | ReturnMetadata[];
+    returnMetadata?: ReturnMetadata | ReturnMetadata[];
     market?: string;
     /** Per-call timeout in ms; overrides the client default. */
     timeoutMs?: number;
@@ -408,9 +418,14 @@ interface RecognizeOptions {
      * already done metered work and the credit is consumed regardless.
      */
     signal?: AbortSignal;
+    /**
+     * Additional form fields the typed options don't cover — undocumented
+     * parameters, beta features. Typed options win on collision.
+     */
+    extraParameters?: Record<string, string>;
 }
 interface RecognizeEnterpriseOptions {
-    return?: ReturnMetadata | ReturnMetadata[];
+    returnMetadata?: ReturnMetadata | ReturnMetadata[];
     skip?: number;
     every?: number;
     limit?: number;
@@ -423,6 +438,11 @@ interface RecognizeEnterpriseOptions {
      * For multi-hour enterprise calls, this is the right way to cancel.
      */
     signal?: AbortSignal;
+    /**
+     * Additional form fields the typed options don't cover. Typed options
+     * win on collision.
+     */
+    extraParameters?: Record<string, string>;
 }
 /**
  * The AudD client. Async-only — every method returns a `Promise`.

package/dist/index.js

@@ -3,7 +3,7 @@ import * as path from 'path';
 import { createHash } from 'crypto';
 
 // src/version.ts
-var VERSION = "1.4.6";
+var VERSION = "1.5.8";
 
 // src/errors.ts
 var AudDError = class extends Error {
@@ -1105,7 +1105,9 @@ var Streams = class {
    */
   async setCallbackUrl(url, opts = {}) {
     const finalUrl = addReturnToUrl(url, opts.returnMetadata);
-    await this.post("setCallbackUrl", { url: finalUrl }, this.mutatingPolicy);
+    const fields = opts.extraParameters ? { ...opts.extraParameters } : {};
+    fields["url"] = finalUrl;
+    await this.post("setCallbackUrl", fields, this.mutatingPolicy);
   }
   /** Get the currently registered callback URL. */
   async getCallbackUrl() {
@@ -1114,10 +1116,9 @@ var Streams = class {
   }
   /** Register a new stream for real-time recognition. */
   async add(opts) {
-    const fields = {
-      url: opts.url,
-      radio_id: String(opts.radioId)
-    };
+    const fields = opts.extraParameters ? { ...opts.extraParameters } : {};
+    fields["url"] = opts.url;
+    fields["radio_id"] = String(opts.radioId);
     if (opts.callbacks !== void 0) fields["callbacks"] = opts.callbacks;
     await this.post("addStream", fields, this.mutatingPolicy);
   }
@@ -1371,8 +1372,8 @@ function formatReturn(value) {
   return Array.isArray(value) ? value.join(",") : value;
 }
 function buildEnterpriseFields(opts) {
-  const fields = {};
-  const ret = formatReturn(opts.return);
+  const fields = opts.extraParameters ? { ...opts.extraParameters } : {};
+  const ret = formatReturn(opts.returnMetadata);
   if (ret !== void 0) fields["return"] = ret;
   if (opts.skip !== void 0) fields["skip"] = String(opts.skip);
   if (opts.every !== void 0) fields["every"] = String(opts.every);
@@ -1541,7 +1542,7 @@ var AudD = class {
    */
   async recognize(source, opts = {}) {
     const reopen = prepareSource(source);
-    const ret = formatReturn(opts.return);
+    const ret = formatReturn(opts.returnMetadata);
     const market = opts.market;
     const policy = this.policyFor("recognition");
     const url = `${API_BASE3}/`;
@@ -1561,6 +1562,7 @@ var AudD = class {
       resp = await runRetried4(async () => {
         const prepared = await reopen();
         const fields = { ...prepared.fields };
+        if (opts.extraParameters) Object.assign(fields, opts.extraParameters);
         if (ret !== void 0) fields["return"] = ret;
         if (market !== void 0) fields["market"] = market;
         return this._http.postForm(url, fields, {