hume 0.10.4-beta.4 → 0.11.0

package/api/resources/empathicVoice/resources/chat/client/Client.js

@@ -77,7 +77,10 @@ class Chat {
                 queryParams[name] = value;
             }
         }
-        const socket = new core.ReconnectingWebSocket(`wss://${((_a = core.Supplier.get(this._options.environment)) !== null && _a !== void 0 ? _a : environments.HumeEnvironment.Production).replace("https://", "")}/v0/evi/chat?${qs_1.default.stringify(queryParams)}`, [], {
+        const environ = ((_a = core.Supplier.get(this._options.environment)) !== null && _a !== void 0 ? _a : environments.HumeEnvironment.Production)
+            .replace("https://", "wss://")
+            .replace("http://", "ws://");
+        const socket = new core.ReconnectingWebSocket(`${environ}/v0/evi/chat?${qs_1.default.stringify(queryParams)}`, [], {
             debug: (_b = args.debug) !== null && _b !== void 0 ? _b : false,
             maxRetries: (_c = args.reconnectAttempts) !== null && _c !== void 0 ? _c : 30,
         });

package/core/websocket/events.d.ts

@@ -13,7 +13,7 @@ export declare class CloseEvent extends Event {
     code: number;
     reason: string;
     wasClean: boolean;
-    willReconnect: boolean;
+    willReconnect?: boolean;
     constructor(code: number | undefined, reason: string | undefined, target: any);
 }
 export interface WebSocketEventMap {

package/core/websocket/ws.d.ts

@@ -36,6 +36,7 @@ export declare class ReconnectingWebSocket {
     private readonly _url;
     private readonly _protocols?;
     private readonly _options;
+    private readonly _WebSocket;
     constructor(url: UrlProvider, protocols?: string | string[], options?: Options);
     static get CONNECTING(): number;
     static get OPEN(): number;

package/core/websocket/ws.js

@@ -178,7 +178,8 @@ class ReconnectingWebSocket {
         this._url = url;
         this._protocols = protocols;
         this._options = options;
-        if (!isWebSocket(this._options.WebSocket)) {
+        this._WebSocket = this._options.WebSocket || getGlobalWebSocket();
+        if (!isWebSocket(this._WebSocket)) {
             throw Error("No valid WebSocket class provided");
         }
         if (this._options.startClosed) {
@@ -432,7 +433,7 @@ class ReconnectingWebSocket {
         }
         // Set lock for this attempt
         this._connectLock = true;
-        const { maxRetries = DEFAULT.maxRetries, connectionTimeout = DEFAULT.connectionTimeout, WebSocket = getGlobalWebSocket(), } = this._options;
+        const { maxRetries = DEFAULT.maxRetries, connectionTimeout = DEFAULT.connectionTimeout } = this._options;
         // Max retries check
         if (this._retryCount >= maxRetries) {
             this._shutdown(new Error(`Max retries (${maxRetries}) reached. Giving up.`), "Max retries reached");
@@ -453,7 +454,7 @@ class ReconnectingWebSocket {
                 return;
             }
             this._debug("connect", { url, protocols: this._protocols });
-            this._ws = this._protocols ? new WebSocket(url, this._protocols) : new WebSocket(url);
+            this._ws = this._protocols ? new this._WebSocket(url, this._protocols) : new this._WebSocket(url);
             this._ws.binaryType = this._binaryType;
             this._addListeners();
             this._connectLock = false;

package/dist/api/resources/empathicVoice/resources/chat/client/Client.js

@@ -77,7 +77,10 @@ class Chat {
                 queryParams[name] = value;
             }
         }
-        const socket = new core.ReconnectingWebSocket(`wss://${((_a = core.Supplier.get(this._options.environment)) !== null && _a !== void 0 ? _a : environments.HumeEnvironment.Production).replace("https://", "")}/v0/evi/chat?${qs_1.default.stringify(queryParams)}`, [], {
+        const environ = ((_a = core.Supplier.get(this._options.environment)) !== null && _a !== void 0 ? _a : environments.HumeEnvironment.Production)
+            .replace("https://", "wss://")
+            .replace("http://", "ws://");
+        const socket = new core.ReconnectingWebSocket(`${environ}/v0/evi/chat?${qs_1.default.stringify(queryParams)}`, [], {
             debug: (_b = args.debug) !== null && _b !== void 0 ? _b : false,
             maxRetries: (_c = args.reconnectAttempts) !== null && _c !== void 0 ? _c : 30,
         });

package/dist/core/websocket/events.d.ts

@@ -13,7 +13,7 @@ export declare class CloseEvent extends Event {
     code: number;
     reason: string;
     wasClean: boolean;
-    willReconnect: boolean;
+    willReconnect?: boolean;
     constructor(code: number | undefined, reason: string | undefined, target: any);
 }
 export interface WebSocketEventMap {

package/dist/core/websocket/ws.d.ts

@@ -36,6 +36,7 @@ export declare class ReconnectingWebSocket {
     private readonly _url;
     private readonly _protocols?;
     private readonly _options;
+    private readonly _WebSocket;
     constructor(url: UrlProvider, protocols?: string | string[], options?: Options);
     static get CONNECTING(): number;
     static get OPEN(): number;

package/dist/core/websocket/ws.js

@@ -178,7 +178,8 @@ class ReconnectingWebSocket {
         this._url = url;
         this._protocols = protocols;
         this._options = options;
-        if (!isWebSocket(this._options.WebSocket)) {
+        this._WebSocket = this._options.WebSocket || getGlobalWebSocket();
+        if (!isWebSocket(this._WebSocket)) {
             throw Error("No valid WebSocket class provided");
         }
         if (this._options.startClosed) {
@@ -432,7 +433,7 @@ class ReconnectingWebSocket {
         }
         // Set lock for this attempt
         this._connectLock = true;
-        const { maxRetries = DEFAULT.maxRetries, connectionTimeout = DEFAULT.connectionTimeout, WebSocket = getGlobalWebSocket(), } = this._options;
+        const { maxRetries = DEFAULT.maxRetries, connectionTimeout = DEFAULT.connectionTimeout } = this._options;
         // Max retries check
         if (this._retryCount >= maxRetries) {
             this._shutdown(new Error(`Max retries (${maxRetries}) reached. Giving up.`), "Max retries reached");
@@ -453,7 +454,7 @@ class ReconnectingWebSocket {
                 return;
             }
             this._debug("connect", { url, protocols: this._protocols });
-            this._ws = this._protocols ? new WebSocket(url, this._protocols) : new WebSocket(url);
+            this._ws = this._protocols ? new this._WebSocket(url, this._protocols) : new this._WebSocket(url);
             this._ws.binaryType = this._binaryType;
             this._addListeners();
             this._connectLock = false;

package/dist/wrapper/EVIWebAudioPlayer.d.ts

@@ -0,0 +1,174 @@
+import type { AudioOutput } from "api/resources/empathicVoice";
+/**
+ * Options for configuring an {@link EVIWebAudioPlayer}.
+ *
+ * @default `{}` for sensible defaults.
+ */
+export interface EVIWebAudioPlayerOptions {
+    /**
+     * Initial master gain, via a `GainNode`, from `0` (_silent_) to `1` (_full volume_).
+     * Values outside this range are clamped.
+     *
+     * @default 1
+     */
+    volume?: number;
+    /**
+     * Real-time FFT (frequency-domain) settings **only** for visualization.
+     *
+     * - **Disable**: omit or `{ enabled: false }` – no `AnalyserNode` is created.
+     * - **Defaults**: `{ enabled: true }` → 2048-point FFT at 16 ms (~60 Hz), mapped to 24 Bark bands.
+     * - **Custom**: supply {@link EVIWebAudioPlayerFFTOptions} to override `size`, `interval`, or `transform`.
+     */
+    fft?: EVIWebAudioPlayerFFTOptions;
+}
+/**
+ * FFT (frequency-domain) options for visualization.
+ *
+ * Pass `{ enabled: true }` for defaults, or omit/disable entirely for zero overhead.
+ */
+export type EVIWebAudioPlayerFFTOptions = FftEnabled | FftDisabled;
+type FftDisabled = {
+    /**
+     * Turn visualization data OFF—skip analyser creation entirely (zero extra CPU).
+     */
+    enabled: false;
+};
+type FftEnabled = {
+    /**
+     * Turn visualization data ON—create an `AnalyserNode`, poll it, and emit `'fft'` events.
+     */
+    enabled: true;
+    /**
+     * FFT size (power-of-two, 32 – 32768).
+     * Defaults to 2048 → 1024 bins (~ 23 Hz at 48 kHz).
+     * @default 2048
+     */
+    size?: number;
+    /**
+     * Polling interval, in **milliseconds**.
+     * Default 16 ms (~ 60 Hz) to sync with `requestAnimationFrame()`.
+     * @default 16
+     */
+    interval?: number;
+    /**
+     * Custom post-processing for raw magnitude data. Omit for built-in 24-band Bark mapping.
+     *
+     * @param bins PCM byte magnitudes (0 – 255) from `AnalyserNode`.
+     * @param sampleRate `AudioContext` sample rate in Hz.
+     * @returns Payload emitted with each `'fft'` event.
+     */
+    transform?: (bins: Uint8Array, sampleRate: number) => number[];
+};
+type PlayerEventMap = {
+    play: CustomEvent<{
+        id: string;
+    }>;
+    stop: CustomEvent<{
+        id: string;
+    }>;
+    fft: CustomEvent<{
+        fft: number[];
+    }>;
+    error: CustomEvent<{
+        message: string;
+    }>;
+};
+/**
+ * A sequential, glitch-free Web-Audio player for **EVI** audio output.
+ *
+ * - **Decoding & playback**: base-64 PCM chunks feed an `AudioWorkletNode` and play in order, without gaps.
+ * - **One-time init**: await {@link init} in a user-gesture to build audio graph and unlock the browser’s
+ *  `AudioContext`; later calls are no-ops.
+ * - **Optional FFT**: `{ fft: { enabled: true } }` adds an `AnalyserNode` and emits `'fft'` events; omit to skip.
+ * - **Controls**: {@link setVolume}, {@link mute}, {@link unmute}, {@link stop}, {@link dispose}.
+ * - **Events**: listen for `'play'`, `'stop'`, `'fft'`, `'error'`.
+ */
+export declare class EVIWebAudioPlayer extends EventTarget {
+    #private;
+    private readonly opts;
+    /** `true` while any clip is currently audible. */
+    get playing(): boolean;
+    /** `true` if gain is set to 0 via {@link mute}. */
+    get muted(): boolean;
+    /** Current output gain (0‑1). */
+    get volume(): number;
+    /** Most recent FFT frame (empty when analyser disabled). */
+    get fft(): number[];
+    constructor(opts?: EVIWebAudioPlayerOptions);
+    /**
+     * Generate an empty FFT frame array.
+     * Useful as an initial or placeholder FFT dataset before any real analysis.
+     *
+     * @returns A number[] filled with zeros, length equal to the Bark band count (24).
+     */
+    static emptyFft(): number[];
+    /**
+     * * Subscribes to a player event and returns `this` for chaining.
+     *
+     * @param type One of `'play'`, `'stop'`, `'fft'`, or `'error'`.
+     * @param fn Handler invoked with the event’s typed `detail` payload.
+     * @param opts Optional `AddEventListenerOptions` (e.g. `{ once: true }`).
+     *
+     * @example
+     *  ```ts
+     *  const player = new EVIWebAudioPlayer();
+     *  player
+     *    .on('play', e => console.log('play',  e.detail.id))
+     *    .on('stop', e => console.log('stop',  e.detail.id))
+     *    .on('fft', e => console.log('stop',  e.detail.fft))
+     *    .on('error', e => console.error('error', e.detail.message));
+     *  ```
+     */
+    on<K extends keyof PlayerEventMap>(type: K, fn: (e: PlayerEventMap[K]) => void, opts?: AddEventListenerOptions): this;
+    /**
+     * Set up and start the player’s Web-Audio pipeline.
+     *
+     * - Creates a **suspended** `AudioContext`, loads the worklet processor, wires `AudioWorkletNode → (AnalyserNode?) → GainNode → destination`, then calls `resume()`.
+     * - Must be awaited inside a user-gesture (click/tap/key); later calls are no-ops.
+     * - If `fft.enabled` is `false` (or `fft` is omitted), no `AnalyserNode` or polling timer is created.
+     *
+     * **Safari quirk:** Safari locks an `AudioContext` to the device’s current sample rate at creation.
+     * If you open a Bluetooth headset mic afterward, the OS may switch to the 16 kHz HFP profile and down-sample playback, which sounds “telephone-y.”
+     * To avoid this, call `getUserMedia()` (or otherwise open audio input) **before** `init()`.
+     *
+     * @throws {Error} If the browser lacks `AudioWorklet` support, or if `AudioContext.resume()` is rejected (autoplay policy, device error).
+     */
+    init(): Promise<void>;
+    /**
+     * Queue one {@link AudioOutput} message for playback.
+     *
+     * Decodes the base-64 PCM data, sends it to the `AudioWorkletNode` for glitch-free, in-order playback, and emits `'play'` for the first chunk of a new stream.
+     *
+     * @param message The `AudioOutput` message received from EVI’s WebSocket.
+     *
+     * @see {@link https://dev.hume.ai/reference/empathic-voice-interface-evi/chat/chat#receive.Audio-Output.type API Reference}
+     */
+    enqueue(message: AudioOutput): Promise<void>;
+    /**
+     * Flush the worklet queue and output silence.
+     */
+    stop(): void;
+    /**
+     * Set the master gain ({@link volume}) to a value between `0` (_silent_) and `1` (_full volume_).
+     *
+     * - Clamps out-of-range values.
+     * - If called before {@link init}, stores volume for when `AudioContext` is created.
+     * - If currently {@link muted}, updates stored volume but keeps output silent until {@link unmute}.
+     *
+     * @param volume Desired gain; clamped to [0, 1].
+     */
+    setVolume(volume: number): void;
+    /**
+     * Mute output instantly by setting the gain to 0. Retains the last volume internally for later restore.
+     */
+    mute(): void;
+    /**
+     * Restore output gain to the last set volume (via setVolume).
+     */
+    unmute(): void;
+    /**
+     * Tear down all Web-Audio resources (worklet, analyser, gain, context) and reset state so {@link init} can be called again.
+     */
+    dispose(): void;
+}
+export {};

package/dist/wrapper/EVIWebAudioPlayer.js

@@ -0,0 +1,314 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var _EVIWebAudioPlayer_instances, _a, _EVIWebAudioPlayer_DEFAULT_WORKLET_URL, _EVIWebAudioPlayer_DEFAULT_FFT_SIZE, _EVIWebAudioPlayer_DEFAULT_FFT_INTERVAL, _EVIWebAudioPlayer_BARK_CENTER_FREQUENCIES, _EVIWebAudioPlayer_BYTE_MAX, _EVIWebAudioPlayer_ctx, _EVIWebAudioPlayer_workletNode, _EVIWebAudioPlayer_analyserNode, _EVIWebAudioPlayer_gainNode, _EVIWebAudioPlayer_initialized, _EVIWebAudioPlayer_playing, _EVIWebAudioPlayer_muted, _EVIWebAudioPlayer_volume, _EVIWebAudioPlayer_fft, _EVIWebAudioPlayer_fftTimer, _EVIWebAudioPlayer_fftOptions, _EVIWebAudioPlayer_linearHzToBark, _EVIWebAudioPlayer_startAnalyserPollingIfEnabled, _EVIWebAudioPlayer_emitError;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EVIWebAudioPlayer = void 0;
+const convertBase64ToBlob_1 = require("./convertBase64ToBlob");
+/**
+ * A sequential, glitch-free Web-Audio player for **EVI** audio output.
+ *
+ * - **Decoding & playback**: base-64 PCM chunks feed an `AudioWorkletNode` and play in order, without gaps.
+ * - **One-time init**: await {@link init} in a user-gesture to build audio graph and unlock the browser’s
+ *  `AudioContext`; later calls are no-ops.
+ * - **Optional FFT**: `{ fft: { enabled: true } }` adds an `AnalyserNode` and emits `'fft'` events; omit to skip.
+ * - **Controls**: {@link setVolume}, {@link mute}, {@link unmute}, {@link stop}, {@link dispose}.
+ * - **Events**: listen for `'play'`, `'stop'`, `'fft'`, `'error'`.
+ */
+class EVIWebAudioPlayer extends EventTarget {
+    /** `true` while any clip is currently audible. */
+    get playing() {
+        return __classPrivateFieldGet(this, _EVIWebAudioPlayer_playing, "f");
+    }
+    /** `true` if gain is set to 0 via {@link mute}. */
+    get muted() {
+        return __classPrivateFieldGet(this, _EVIWebAudioPlayer_muted, "f");
+    }
+    /** Current output gain (0‑1). */
+    get volume() {
+        return __classPrivateFieldGet(this, _EVIWebAudioPlayer_volume, "f");
+    }
+    /** Most recent FFT frame (empty when analyser disabled). */
+    get fft() {
+        return __classPrivateFieldGet(this, _EVIWebAudioPlayer_fft, "f");
+    }
+    constructor(opts = {}) {
+        var _b, _c;
+        super();
+        _EVIWebAudioPlayer_instances.add(this);
+        this.opts = opts;
+        _EVIWebAudioPlayer_ctx.set(this, null);
+        _EVIWebAudioPlayer_workletNode.set(this, null);
+        _EVIWebAudioPlayer_analyserNode.set(this, null);
+        _EVIWebAudioPlayer_gainNode.set(this, null);
+        _EVIWebAudioPlayer_initialized.set(this, false);
+        _EVIWebAudioPlayer_playing.set(this, false);
+        _EVIWebAudioPlayer_muted.set(this, false);
+        _EVIWebAudioPlayer_volume.set(this, void 0);
+        _EVIWebAudioPlayer_fft.set(this, _a.emptyFft());
+        _EVIWebAudioPlayer_fftTimer.set(this, null);
+        _EVIWebAudioPlayer_fftOptions.set(this, null);
+        __classPrivateFieldSet(this, _EVIWebAudioPlayer_volume, (_b = opts.volume) !== null && _b !== void 0 ? _b : 1.0, "f");
+        // Resolve FFT options if enabled
+        if ((_c = opts.fft) === null || _c === void 0 ? void 0 : _c.enabled) {
+            const { size, interval, transform } = opts.fft;
+            __classPrivateFieldSet(this, _EVIWebAudioPlayer_fftOptions, {
+                size: size !== null && size !== void 0 ? size : __classPrivateFieldGet(_a, _a, "f", _EVIWebAudioPlayer_DEFAULT_FFT_SIZE),
+                interval: interval !== null && interval !== void 0 ? interval : __classPrivateFieldGet(_a, _a, "f", _EVIWebAudioPlayer_DEFAULT_FFT_INTERVAL),
+                transform: transform !== null && transform !== void 0 ? transform : __classPrivateFieldGet(_a, _a, "m", _EVIWebAudioPlayer_linearHzToBark),
+            }, "f");
+        }
+    }
+    /**
+     * Generate an empty FFT frame array.
+     * Useful as an initial or placeholder FFT dataset before any real analysis.
+     *
+     * @returns A number[] filled with zeros, length equal to the Bark band count (24).
+     */
+    static emptyFft() {
+        return Array(__classPrivateFieldGet(_a, _a, "f", _EVIWebAudioPlayer_BARK_CENTER_FREQUENCIES).length).fill(0);
+    }
+    /**
+     * * Subscribes to a player event and returns `this` for chaining.
+     *
+     * @param type One of `'play'`, `'stop'`, `'fft'`, or `'error'`.
+     * @param fn Handler invoked with the event’s typed `detail` payload.
+     * @param opts Optional `AddEventListenerOptions` (e.g. `{ once: true }`).
+     *
+     * @example
+     *  ```ts
+     *  const player = new EVIWebAudioPlayer();
+     *  player
+     *    .on('play', e => console.log('play',  e.detail.id))
+     *    .on('stop', e => console.log('stop',  e.detail.id))
+     *    .on('fft', e => console.log('stop',  e.detail.fft))
+     *    .on('error', e => console.error('error', e.detail.message));
+     *  ```
+     */
+    on(type, fn, opts) {
+        super.addEventListener(type, fn, opts);
+        return this;
+    }
+    /**
+     * Set up and start the player’s Web-Audio pipeline.
+     *
+     * - Creates a **suspended** `AudioContext`, loads the worklet processor, wires `AudioWorkletNode → (AnalyserNode?) → GainNode → destination`, then calls `resume()`.
+     * - Must be awaited inside a user-gesture (click/tap/key); later calls are no-ops.
+     * - If `fft.enabled` is `false` (or `fft` is omitted), no `AnalyserNode` or polling timer is created.
+     *
+     * **Safari quirk:** Safari locks an `AudioContext` to the device’s current sample rate at creation.
+     * If you open a Bluetooth headset mic afterward, the OS may switch to the 16 kHz HFP profile and down-sample playback, which sounds “telephone-y.”
+     * To avoid this, call `getUserMedia()` (or otherwise open audio input) **before** `init()`.
+     *
+     * @throws {Error} If the browser lacks `AudioWorklet` support, or if `AudioContext.resume()` is rejected (autoplay policy, device error).
+     */
+    init() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (__classPrivateFieldGet(this, _EVIWebAudioPlayer_initialized, "f"))
+                return;
+            // Create the AudioContext
+            __classPrivateFieldSet(this, _EVIWebAudioPlayer_ctx, new AudioContext(), "f");
+            // Fail fast if AudioWorklet isn’t supported
+            if (!__classPrivateFieldGet(this, _EVIWebAudioPlayer_ctx, "f").audioWorklet) {
+                const msg = "AudioWorklet is not supported in this browser";
+                __classPrivateFieldGet(this, _EVIWebAudioPlayer_instances, "m", _EVIWebAudioPlayer_emitError).call(this, msg);
+                throw new Error(msg);
+            }
+            try {
+                // Build GainNode
+                __classPrivateFieldSet(this, _EVIWebAudioPlayer_gainNode, __classPrivateFieldGet(this, _EVIWebAudioPlayer_ctx, "f").createGain(), "f");
+                __classPrivateFieldGet(this, _EVIWebAudioPlayer_gainNode, "f").gain.value = __classPrivateFieldGet(this, _EVIWebAudioPlayer_volume, "f");
+                // Build AnalyserNode (optional)
+                if (__classPrivateFieldGet(this, _EVIWebAudioPlayer_fftOptions, "f")) {
+                    __classPrivateFieldSet(this, _EVIWebAudioPlayer_analyserNode, __classPrivateFieldGet(this, _EVIWebAudioPlayer_ctx, "f").createAnalyser(), "f");
+                    __classPrivateFieldGet(this, _EVIWebAudioPlayer_analyserNode, "f").fftSize = __classPrivateFieldGet(this, _EVIWebAudioPlayer_fftOptions, "f").size;
+                }
+                // Loads the AudioWorklet processor module.
+                yield __classPrivateFieldGet(this, _EVIWebAudioPlayer_ctx, "f").audioWorklet.addModule(__classPrivateFieldGet(_a, _a, "f", _EVIWebAudioPlayer_DEFAULT_WORKLET_URL));
+                // Build AudioWorkletNode
+                __classPrivateFieldSet(this, _EVIWebAudioPlayer_workletNode, new AudioWorkletNode(__classPrivateFieldGet(this, _EVIWebAudioPlayer_ctx, "f"), "audio-processor"), "f");
+                // When the worklet posts { type: "ended" }, mark playback stopped and emit a `'stop'` event.
+                __classPrivateFieldGet(this, _EVIWebAudioPlayer_workletNode, "f").port.onmessage = (e) => {
+                    if (e.data.type === "ended") {
+                        __classPrivateFieldSet(this, _EVIWebAudioPlayer_playing, false, "f");
+                        this.dispatchEvent(new CustomEvent("stop", { detail: { id: "stream" } }));
+                    }
+                };
+                // Audio graph nodes
+                const workletNode = __classPrivateFieldGet(this, _EVIWebAudioPlayer_workletNode, "f"); // AudioWorkletNode (PCM processor)
+                const analyserNode = __classPrivateFieldGet(this, _EVIWebAudioPlayer_analyserNode, "f"); // Optional AnalyserNode (FFT)
+                const gainNode = __classPrivateFieldGet(this, _EVIWebAudioPlayer_gainNode, "f"); // GainNode (volume control)
+                const destination = __classPrivateFieldGet(this, _EVIWebAudioPlayer_ctx, "f").destination; // AudioDestinationNode (speakers)
+                // Analyser node is filtered out of audio graph if null (FFT disabled)
+                const audioGraph = [workletNode, analyserNode, gainNode, destination].filter(Boolean);
+                // Wire nodes: AudioWorkletNode → (AnalyserNode?) → GainNode → AudioDestinationNode
+                audioGraph.reduce((prev, next) => (prev.connect(next), next));
+                // If an analyser is configured, begin polling it at the resolved interval and dispatching `'fft'` events for each frame.
+                __classPrivateFieldGet(this, _EVIWebAudioPlayer_instances, "m", _EVIWebAudioPlayer_startAnalyserPollingIfEnabled).call(this);
+                // Resume the AudioContext now that the audio graph is fully wired.
+                // Browsers allow `resume()` only inside a user-gesture callback.
+                // Any rejection (autoplay policy, hardware issue, etc.) is caught by the outer catch-block below, which emits an 'error' event and re-throws.
+                yield __classPrivateFieldGet(this, _EVIWebAudioPlayer_ctx, "f").resume();
+                __classPrivateFieldSet(this, _EVIWebAudioPlayer_initialized, true, "f");
+            }
+            catch (err) {
+                const suffix = err instanceof Error ? `: ${err.message}` : String(err);
+                __classPrivateFieldGet(this, _EVIWebAudioPlayer_instances, "m", _EVIWebAudioPlayer_emitError).call(this, `Failed to initialize audio player${suffix}`);
+                throw err;
+            }
+        });
+    }
+    /**
+     * Queue one {@link AudioOutput} message for playback.
+     *
+     * Decodes the base-64 PCM data, sends it to the `AudioWorkletNode` for glitch-free, in-order playback, and emits `'play'` for the first chunk of a new stream.
+     *
+     * @param message The `AudioOutput` message received from EVI’s WebSocket.
+     *
+     * @see {@link https://dev.hume.ai/reference/empathic-voice-interface-evi/chat/chat#receive.Audio-Output.type API Reference}
+     */
+    enqueue(message) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!__classPrivateFieldGet(this, _EVIWebAudioPlayer_initialized, "f") || !__classPrivateFieldGet(this, _EVIWebAudioPlayer_ctx, "f")) {
+                __classPrivateFieldGet(this, _EVIWebAudioPlayer_instances, "m", _EVIWebAudioPlayer_emitError).call(this, "Audio player is not initialized");
+                return;
+            }
+            try {
+                const { data, id } = message;
+                const blob = (0, convertBase64ToBlob_1.convertBase64ToBlob)(data);
+                const buffer = yield blob.arrayBuffer();
+                const audio = yield __classPrivateFieldGet(this, _EVIWebAudioPlayer_ctx, "f").decodeAudioData(buffer);
+                const pcmData = audio.getChannelData(0);
+                __classPrivateFieldGet(this, _EVIWebAudioPlayer_workletNode, "f").port.postMessage({ type: "audio", data: pcmData });
+                __classPrivateFieldSet(this, _EVIWebAudioPlayer_playing, true, "f");
+                this.dispatchEvent(new CustomEvent("play", { detail: { id } }));
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : "Unknown error";
+                __classPrivateFieldGet(this, _EVIWebAudioPlayer_instances, "m", _EVIWebAudioPlayer_emitError).call(this, `Failed to queue clip: ${msg}`);
+            }
+        });
+    }
+    /**
+     * Flush the worklet queue and output silence.
+     */
+    stop() {
+        var _b;
+        // Clear buffered audio from the worklet queue
+        (_b = __classPrivateFieldGet(this, _EVIWebAudioPlayer_workletNode, "f")) === null || _b === void 0 ? void 0 : _b.port.postMessage({ type: "fadeAndClear" });
+        // Restart analyser polling so fft events continue after stopping or clearing the queue
+        __classPrivateFieldGet(this, _EVIWebAudioPlayer_instances, "m", _EVIWebAudioPlayer_startAnalyserPollingIfEnabled).call(this);
+        __classPrivateFieldSet(this, _EVIWebAudioPlayer_playing, false, "f");
+        this.dispatchEvent(new CustomEvent("stop", { detail: { id: "manual" } }));
+    }
+    /**
+     * Set the master gain ({@link volume}) to a value between `0` (_silent_) and `1` (_full volume_).
+     *
+     * - Clamps out-of-range values.
+     * - If called before {@link init}, stores volume for when `AudioContext` is created.
+     * - If currently {@link muted}, updates stored volume but keeps output silent until {@link unmute}.
+     *
+     * @param volume Desired gain; clamped to [0, 1].
+     */
+    setVolume(volume) {
+        const clampedVolume = Math.max(0, Math.min(volume, 1));
+        __classPrivateFieldSet(this, _EVIWebAudioPlayer_volume, clampedVolume, "f");
+        if (__classPrivateFieldGet(this, _EVIWebAudioPlayer_gainNode, "f") && __classPrivateFieldGet(this, _EVIWebAudioPlayer_ctx, "f") && !__classPrivateFieldGet(this, _EVIWebAudioPlayer_muted, "f")) {
+            __classPrivateFieldGet(this, _EVIWebAudioPlayer_gainNode, "f").gain.setValueAtTime(clampedVolume, __classPrivateFieldGet(this, _EVIWebAudioPlayer_ctx, "f").currentTime);
+        }
+    }
+    /**
+     * Mute output instantly by setting the gain to 0. Retains the last volume internally for later restore.
+     */
+    mute() {
+        if (!__classPrivateFieldGet(this, _EVIWebAudioPlayer_gainNode, "f") || !__classPrivateFieldGet(this, _EVIWebAudioPlayer_ctx, "f"))
+            return;
+        __classPrivateFieldGet(this, _EVIWebAudioPlayer_gainNode, "f").gain.setValueAtTime(0, __classPrivateFieldGet(this, _EVIWebAudioPlayer_ctx, "f").currentTime);
+        __classPrivateFieldSet(this, _EVIWebAudioPlayer_muted, true, "f");
+    }
+    /**
+     * Restore output gain to the last set volume (via setVolume).
+     */
+    unmute() {
+        if (!__classPrivateFieldGet(this, _EVIWebAudioPlayer_gainNode, "f") || !__classPrivateFieldGet(this, _EVIWebAudioPlayer_ctx, "f"))
+            return;
+        __classPrivateFieldGet(this, _EVIWebAudioPlayer_gainNode, "f").gain.setValueAtTime(__classPrivateFieldGet(this, _EVIWebAudioPlayer_volume, "f"), __classPrivateFieldGet(this, _EVIWebAudioPlayer_ctx, "f").currentTime);
+        __classPrivateFieldSet(this, _EVIWebAudioPlayer_muted, false, "f");
+    }
+    /**
+     * Tear down all Web-Audio resources (worklet, analyser, gain, context) and reset state so {@link init} can be called again.
+     */
+    dispose() {
+        var _b, _c, _d, _e, _f, _g, _h;
+        if (__classPrivateFieldGet(this, _EVIWebAudioPlayer_fftTimer, "f") != null) {
+            clearInterval(__classPrivateFieldGet(this, _EVIWebAudioPlayer_fftTimer, "f"));
+            __classPrivateFieldSet(this, _EVIWebAudioPlayer_fftTimer, null, "f");
+        }
+        (_b = __classPrivateFieldGet(this, _EVIWebAudioPlayer_workletNode, "f")) === null || _b === void 0 ? void 0 : _b.port.postMessage({ type: "fadeAndClear" });
+        (_c = __classPrivateFieldGet(this, _EVIWebAudioPlayer_workletNode, "f")) === null || _c === void 0 ? void 0 : _c.port.postMessage({ type: "end" });
+        (_d = __classPrivateFieldGet(this, _EVIWebAudioPlayer_workletNode, "f")) === null || _d === void 0 ? void 0 : _d.port.close();
+        (_e = __classPrivateFieldGet(this, _EVIWebAudioPlayer_workletNode, "f")) === null || _e === void 0 ? void 0 : _e.disconnect();
+        (_f = __classPrivateFieldGet(this, _EVIWebAudioPlayer_analyserNode, "f")) === null || _f === void 0 ? void 0 : _f.disconnect();
+        (_g = __classPrivateFieldGet(this, _EVIWebAudioPlayer_gainNode, "f")) === null || _g === void 0 ? void 0 : _g.disconnect();
+        (_h = __classPrivateFieldGet(this, _EVIWebAudioPlayer_ctx, "f")) === null || _h === void 0 ? void 0 : _h.close().catch(() => void 0);
+        __classPrivateFieldSet(this, _EVIWebAudioPlayer_initialized, false, "f");
+        __classPrivateFieldSet(this, _EVIWebAudioPlayer_playing, false, "f");
+        __classPrivateFieldSet(this, _EVIWebAudioPlayer_fft, _a.emptyFft(), "f");
+    }
+}
+exports.EVIWebAudioPlayer = EVIWebAudioPlayer;
+_a = EVIWebAudioPlayer, _EVIWebAudioPlayer_ctx = new WeakMap(), _EVIWebAudioPlayer_workletNode = new WeakMap(), _EVIWebAudioPlayer_analyserNode = new WeakMap(), _EVIWebAudioPlayer_gainNode = new WeakMap(), _EVIWebAudioPlayer_initialized = new WeakMap(), _EVIWebAudioPlayer_playing = new WeakMap(), _EVIWebAudioPlayer_muted = new WeakMap(), _EVIWebAudioPlayer_volume = new WeakMap(), _EVIWebAudioPlayer_fft = new WeakMap(), _EVIWebAudioPlayer_fftTimer = new WeakMap(), _EVIWebAudioPlayer_fftOptions = new WeakMap(), _EVIWebAudioPlayer_instances = new WeakSet(), _EVIWebAudioPlayer_linearHzToBark = function _EVIWebAudioPlayer_linearHzToBark(linearData, sampleRate) {
+    const maxFrequency = sampleRate / 2;
+    const frequencyResolution = maxFrequency / linearData.length;
+    return __classPrivateFieldGet(_a, _a, "f", _EVIWebAudioPlayer_BARK_CENTER_FREQUENCIES).map((barkFreq) => {
+        var _b;
+        const linearDataIndex = Math.round(barkFreq / frequencyResolution);
+        const magnitude = (_b = linearData[linearDataIndex]) !== null && _b !== void 0 ? _b : 0;
+        return (magnitude / __classPrivateFieldGet(_a, _a, "f", _EVIWebAudioPlayer_BYTE_MAX)) * 2;
+    });
+}, _EVIWebAudioPlayer_startAnalyserPollingIfEnabled = function _EVIWebAudioPlayer_startAnalyserPollingIfEnabled() {
+    if (!__classPrivateFieldGet(this, _EVIWebAudioPlayer_fftOptions, "f") || !__classPrivateFieldGet(this, _EVIWebAudioPlayer_analyserNode, "f"))
+        return;
+    if (__classPrivateFieldGet(this, _EVIWebAudioPlayer_fftTimer, "f"))
+        clearInterval(__classPrivateFieldGet(this, _EVIWebAudioPlayer_fftTimer, "f"));
+    const { interval, transform } = __classPrivateFieldGet(this, _EVIWebAudioPlayer_fftOptions, "f");
+    __classPrivateFieldSet(this, _EVIWebAudioPlayer_fftTimer, window.setInterval(() => {
+        const bins = new Uint8Array(__classPrivateFieldGet(this, _EVIWebAudioPlayer_analyserNode, "f").frequencyBinCount);
+        __classPrivateFieldGet(this, _EVIWebAudioPlayer_analyserNode, "f").getByteFrequencyData(bins);
+        __classPrivateFieldSet(this, _EVIWebAudioPlayer_fft, transform(bins, __classPrivateFieldGet(this, _EVIWebAudioPlayer_ctx, "f").sampleRate), "f");
+        this.dispatchEvent(new CustomEvent("fft", { detail: { fft: __classPrivateFieldGet(this, _EVIWebAudioPlayer_fft, "f") } }));
+    }, interval), "f");
+}, _EVIWebAudioPlayer_emitError = function _EVIWebAudioPlayer_emitError(message) {
+    this.dispatchEvent(new CustomEvent("error", { detail: { message } }));
+};
+/** Default URL of the `audio-worklet.js` processor module, fetched from Hume AI’s CDN. */
+_EVIWebAudioPlayer_DEFAULT_WORKLET_URL = { value: "https://storage.googleapis.com/evi-react-sdk-assets/audio-worklet-20250506.js" };
+/** Default FFT size (power-of-two). */
+_EVIWebAudioPlayer_DEFAULT_FFT_SIZE = { value: 2048 };
+/** Default analyser poll interval (16 ms). */
+_EVIWebAudioPlayer_DEFAULT_FFT_INTERVAL = { value: 16 };
+/** Bark‑scale center frequencies (hz) used by the default transform. https://en.wikipedia.org/wiki/Bark_scale */
+_EVIWebAudioPlayer_BARK_CENTER_FREQUENCIES = { value: [
+        50, 150, 250, 350, 450, 570, 700, 840, 1000, 1170, 1370, 1600, 1850, 2150, 2500, 2900, 3400, 4000, 4800, 5800,
+        7000, 8500, 10500, 13500,
+    ] };
+/** Max byte magnitude (255) returned by `AnalyserNode.getByteFrequencyData`. */
+_EVIWebAudioPlayer_BYTE_MAX = { value: 255 };

package/dist/wrapper/fetchAccessToken.d.ts

@@ -2,8 +2,6 @@
  * Fetches a new access token from the Hume API using the provided API key and Secret key.
  *
  * @param args - The arguments for the request.
- * @returns Promise that resolves to the new access token or null.
- * @throws If the base64 encoding fails.
  * @example
  * ```typescript
  * async function getToken() {
@@ -20,4 +18,4 @@ export declare const fetchAccessToken: ({ apiKey, secretKey, host, }: {
     apiKey: string;
     secretKey: string;
     host?: string;
-}) => Promise<string | null>;
+}) => Promise<string>;