@audd/sdk 1.5.11 → 1.5.12

package/dist/index.d.cts

@@ -1,7 +1,31 @@
-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-ZtFOyojP.cjs';
-export { E as EnterpriseChunkResult, e as StreamCallbackSong, f as StreamingProvider } from './longpollCore-ZtFOyojP.cjs';
+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.8";
+declare const VERSION = "1.5.12";
+
+/** Inspection events emitted around each HTTP request the SDK makes. */
+
+/**
+ * Inspection event kinds emitted by the SDK request lifecycle.
+ * Hooks receive these via the `onEvent` callback.
+ */
+type AudDEventKind = "request" | "response" | "exception";
+/**
+ * Inspection event emitted by the SDK request lifecycle.
+ * Frozen, plain-data; never includes the api_token or request body bytes.
+ */
+interface AudDEvent {
+    kind: AudDEventKind;
+    /** AudD method name, e.g. "recognize", "addStream". */
+    method: string;
+    url: string;
+    requestId: string | null;
+    httpStatus: number | null;
+    elapsedMs: number | null;
+    errorCode: number | null;
+    extras: Record<string, unknown>;
+}
+type OnEventHook = (event: AudDEvent) => void;
 
 /**
  * Auto-detect what kind of audio source the caller passed and convert to
@@ -260,8 +284,12 @@ declare class Streams {
     private readonly http;
     private readonly readPolicy;
     private readonly mutatingPolicy;
+    /** Live token provider — token rotations on the client propagate here. */
     private readonly apiToken;
-    constructor(http: HttpClient, readPolicy: RetryPolicy, mutatingPolicy: RetryPolicy, apiToken: string);
+    private readonly onEvent?;
+    constructor(http: HttpClient, readPolicy: RetryPolicy, mutatingPolicy: RetryPolicy, 
+    /** Live token provider — token rotations on the client propagate here. */
+    apiToken: () => string, onEvent?: OnEventHook | undefined);
     private post;
     /**
      * Set the callback URL where AudD will POST recognition events.
@@ -333,7 +361,8 @@ interface CustomCatalogAddOptions {
 declare class CustomCatalog {
     private readonly http;
     private readonly noRetryPolicy;
-    constructor(http: HttpClient, noRetryPolicy: RetryPolicy);
+    private readonly onEvent?;
+    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
@@ -357,12 +386,13 @@ declare class CustomCatalog {
 declare class Advanced {
     private readonly http;
     private readonly recognitionPolicy;
+    private readonly onEvent?;
     /**
      * @param recognitionPolicy The findLyrics endpoint is metered and shouldn't
      * double-bill on post-upload read timeout: Advanced uses RECOGNITION retry
      * policy, not READ.
      */
-    constructor(http: HttpClient, recognitionPolicy: RetryPolicy);
+    constructor(http: HttpClient, recognitionPolicy: RetryPolicy, onEvent?: OnEventHook | undefined);
     /** Find lyrics by free-text query. Returns a list of matches (possibly empty). */
     findLyrics(query: string): Promise<LyricsResult[]>;
     /**
@@ -372,27 +402,6 @@ declare class Advanced {
     rawRequest(method: string, params?: Record<string, string | number | boolean | undefined>): Promise<Record<string, unknown>>;
 }
 
-/**
- * Inspection event kinds emitted by the SDK request lifecycle.
- * Hooks receive these via the `onEvent` callback.
- */
-type AudDEventKind = "request" | "response" | "exception";
-/**
- * Inspection event emitted by the SDK request lifecycle.
- * Frozen, plain-data; never includes the api_token or request body bytes.
- */
-interface AudDEvent {
-    kind: AudDEventKind;
-    /** AudD method name, e.g. "recognize", "addStream". */
-    method: string;
-    url: string;
-    requestId: string | null;
-    httpStatus: number | null;
-    elapsedMs: number | null;
-    errorCode: number | null;
-    extras: Record<string, unknown>;
-}
-type OnEventHook = (event: AudDEvent) => void;
 interface AudDOptions {
     /** Required, but may be omitted if `AUDD_API_TOKEN` is in the environment. */
     apiToken?: string;

package/dist/index.d.ts

@@ -1,7 +1,31 @@
-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-ZtFOyojP.js';
-export { E as EnterpriseChunkResult, e as StreamCallbackSong, f as StreamingProvider } from './longpollCore-ZtFOyojP.js';
+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.8";
+declare const VERSION = "1.5.12";
+
+/** Inspection events emitted around each HTTP request the SDK makes. */
+
+/**
+ * Inspection event kinds emitted by the SDK request lifecycle.
+ * Hooks receive these via the `onEvent` callback.
+ */
+type AudDEventKind = "request" | "response" | "exception";
+/**
+ * Inspection event emitted by the SDK request lifecycle.
+ * Frozen, plain-data; never includes the api_token or request body bytes.
+ */
+interface AudDEvent {
+    kind: AudDEventKind;
+    /** AudD method name, e.g. "recognize", "addStream". */
+    method: string;
+    url: string;
+    requestId: string | null;
+    httpStatus: number | null;
+    elapsedMs: number | null;
+    errorCode: number | null;
+    extras: Record<string, unknown>;
+}
+type OnEventHook = (event: AudDEvent) => void;
 
 /**
  * Auto-detect what kind of audio source the caller passed and convert to
@@ -260,8 +284,12 @@ declare class Streams {
     private readonly http;
     private readonly readPolicy;
     private readonly mutatingPolicy;
+    /** Live token provider — token rotations on the client propagate here. */
     private readonly apiToken;
-    constructor(http: HttpClient, readPolicy: RetryPolicy, mutatingPolicy: RetryPolicy, apiToken: string);
+    private readonly onEvent?;
+    constructor(http: HttpClient, readPolicy: RetryPolicy, mutatingPolicy: RetryPolicy, 
+    /** Live token provider — token rotations on the client propagate here. */
+    apiToken: () => string, onEvent?: OnEventHook | undefined);
     private post;
     /**
      * Set the callback URL where AudD will POST recognition events.
@@ -333,7 +361,8 @@ interface CustomCatalogAddOptions {
 declare class CustomCatalog {
     private readonly http;
     private readonly noRetryPolicy;
-    constructor(http: HttpClient, noRetryPolicy: RetryPolicy);
+    private readonly onEvent?;
+    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
@@ -357,12 +386,13 @@ declare class CustomCatalog {
 declare class Advanced {
     private readonly http;
     private readonly recognitionPolicy;
+    private readonly onEvent?;
     /**
      * @param recognitionPolicy The findLyrics endpoint is metered and shouldn't
      * double-bill on post-upload read timeout: Advanced uses RECOGNITION retry
      * policy, not READ.
      */
-    constructor(http: HttpClient, recognitionPolicy: RetryPolicy);
+    constructor(http: HttpClient, recognitionPolicy: RetryPolicy, onEvent?: OnEventHook | undefined);
     /** Find lyrics by free-text query. Returns a list of matches (possibly empty). */
     findLyrics(query: string): Promise<LyricsResult[]>;
     /**
@@ -372,27 +402,6 @@ declare class Advanced {
     rawRequest(method: string, params?: Record<string, string | number | boolean | undefined>): Promise<Record<string, unknown>>;
 }
 
-/**
- * Inspection event kinds emitted by the SDK request lifecycle.
- * Hooks receive these via the `onEvent` callback.
- */
-type AudDEventKind = "request" | "response" | "exception";
-/**
- * Inspection event emitted by the SDK request lifecycle.
- * Frozen, plain-data; never includes the api_token or request body bytes.
- */
-interface AudDEvent {
-    kind: AudDEventKind;
-    /** AudD method name, e.g. "recognize", "addStream". */
-    method: string;
-    url: string;
-    requestId: string | null;
-    httpStatus: number | null;
-    elapsedMs: number | null;
-    errorCode: number | null;
-    extras: Record<string, unknown>;
-}
-type OnEventHook = (event: AudDEvent) => void;
 interface AudDOptions {
     /** Required, but may be omitted if `AUDD_API_TOKEN` is in the environment. */
     apiToken?: string;