hume 0.13.2 → 0.13.4

package/dist/wrapper/EVIWebAudioPlayer.js

@@ -19,10 +19,12 @@ var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (
     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;
+var _EVIWebAudioPlayer_instances, _a, _EVIWebAudioPlayer_DEFAULT_WORKLET_URL, _EVIWebAudioPlayer_DEFAULT_FFT_SIZE, _EVIWebAudioPlayer_DEFAULT_FFT_INTERVAL, _EVIWebAudioPlayer_ctx, _EVIWebAudioPlayer_workletNode, _EVIWebAudioPlayer_analyserNode, _EVIWebAudioPlayer_gainNode, _EVIWebAudioPlayer_initialized, _EVIWebAudioPlayer_playing, _EVIWebAudioPlayer_muted, _EVIWebAudioPlayer_volume, _EVIWebAudioPlayer_disableAudioWorklet, _EVIWebAudioPlayer_fft, _EVIWebAudioPlayer_fftTimer, _EVIWebAudioPlayer_fftOptions, _EVIWebAudioPlayer_clipQueue, _EVIWebAudioPlayer_currentlyPlayingAudioBuffer, _EVIWebAudioPlayer_isProcessing, _EVIWebAudioPlayer_lastQueuedChunk, _EVIWebAudioPlayer_chunkBufferQueues, _EVIWebAudioPlayer_startAnalyserPollingIfEnabled, _EVIWebAudioPlayer_emitError, _EVIWebAudioPlayer_convertToAudioBuffer, _EVIWebAudioPlayer_getNextAudioBuffers, _EVIWebAudioPlayer_playNextClip;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EVIWebAudioPlayer = void 0;
 const convertBase64ToBlob_1 = require("./convertBase64ToBlob");
+const convertFrequencyScale_1 = require("./convertFrequencyScale");
+const generateEmptyFft_1 = require("./generateEmptyFft");
 /**
  * A sequential, glitch-free Web-Audio player for **EVI** audio output.
  *
@@ -51,7 +53,7 @@ class EVIWebAudioPlayer extends EventTarget {
         return __classPrivateFieldGet(this, _EVIWebAudioPlayer_fft, "f");
     }
     constructor(opts = {}) {
-        var _b, _c;
+        var _b, _c, _d;
         super();
         _EVIWebAudioPlayer_instances.add(this);
         this.opts = opts;
@@ -63,29 +65,30 @@ class EVIWebAudioPlayer extends EventTarget {
         _EVIWebAudioPlayer_playing.set(this, false);
         _EVIWebAudioPlayer_muted.set(this, false);
         _EVIWebAudioPlayer_volume.set(this, void 0);
-        _EVIWebAudioPlayer_fft.set(this, _a.emptyFft());
+        _EVIWebAudioPlayer_disableAudioWorklet.set(this, void 0);
+        _EVIWebAudioPlayer_fft.set(this, (0, generateEmptyFft_1.generateEmptyFft)());
         _EVIWebAudioPlayer_fftTimer.set(this, null);
         _EVIWebAudioPlayer_fftOptions.set(this, null);
+        _EVIWebAudioPlayer_clipQueue.set(this, []);
+        _EVIWebAudioPlayer_currentlyPlayingAudioBuffer.set(this, null);
+        _EVIWebAudioPlayer_isProcessing.set(this, false);
+        // chunkBufferQueues and #lastQueuedChunk are used to make sure that
+        // we don't play chunks out of order. #chunkBufferQueues is NOT the
+        // audio playback queue.
+        _EVIWebAudioPlayer_lastQueuedChunk.set(this, null);
+        _EVIWebAudioPlayer_chunkBufferQueues.set(this, {});
         __classPrivateFieldSet(this, _EVIWebAudioPlayer_volume, (_b = opts.volume) !== null && _b !== void 0 ? _b : 1.0, "f");
+        __classPrivateFieldSet(this, _EVIWebAudioPlayer_disableAudioWorklet, (_c = opts.disableAudioWorklet) !== null && _c !== void 0 ? _c : false, "f");
         // Resolve FFT options if enabled
-        if ((_c = opts.fft) === null || _c === void 0 ? void 0 : _c.enabled) {
+        if ((_d = opts.fft) === null || _d === void 0 ? void 0 : _d.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),
+                transform: transform !== null && transform !== void 0 ? transform : ((bins, sampleRate) => (0, convertFrequencyScale_1.convertLinearFrequenciesToBark)(bins, sampleRate)),
             }, "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.
      *
@@ -128,9 +131,8 @@ class EVIWebAudioPlayer extends EventTarget {
             __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);
+                console.warn("AudioWorklet is not supported in this browser. Falling back to Regular Buffer Mode.");
+                __classPrivateFieldSet(this, _EVIWebAudioPlayer_disableAudioWorklet, true, "f");
             }
             try {
                 // Build GainNode
@@ -141,26 +143,42 @@ class EVIWebAudioPlayer extends EventTarget {
                     __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));
+                else {
+                    // Always create AnalyserNode, even if FFT is disabled, to avoid null checks in Buffer Mode
+                    __classPrivateFieldSet(this, _EVIWebAudioPlayer_analyserNode, __classPrivateFieldGet(this, _EVIWebAudioPlayer_ctx, "f").createAnalyser(), "f");
+                    __classPrivateFieldGet(this, _EVIWebAudioPlayer_analyserNode, "f").fftSize = __classPrivateFieldGet(_a, _a, "f", _EVIWebAudioPlayer_DEFAULT_FFT_SIZE);
+                }
+                if (!__classPrivateFieldGet(this, _EVIWebAudioPlayer_disableAudioWorklet, "f")) {
+                    // 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));
+                }
+                else {
+                    // Regular Buffer Mode
+                    const analyserNode = __classPrivateFieldGet(this, _EVIWebAudioPlayer_analyserNode, "f");
+                    const gainNode = __classPrivateFieldGet(this, _EVIWebAudioPlayer_gainNode, "f");
+                    const destination = __classPrivateFieldGet(this, _EVIWebAudioPlayer_ctx, "f").destination;
+                    // Wire nodes: (AnalyserNode?) → GainNode → AudioDestinationNode
+                    const audioGraph = [analyserNode, gainNode, destination].filter(Boolean);
+                    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.
@@ -191,19 +209,49 @@ class EVIWebAudioPlayer extends EventTarget {
                 __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 } }));
+            if (!__classPrivateFieldGet(this, _EVIWebAudioPlayer_disableAudioWorklet, "f")) {
+                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}`);
+                }
             }
-            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}`);
+            else {
+                // Regular Buffer Mode
+                try {
+                    const audioBuffer = yield __classPrivateFieldGet(this, _EVIWebAudioPlayer_instances, "m", _EVIWebAudioPlayer_convertToAudioBuffer).call(this, message);
+                    if (!audioBuffer) {
+                        __classPrivateFieldGet(this, _EVIWebAudioPlayer_instances, "m", _EVIWebAudioPlayer_emitError).call(this, "Failed to convert data to audio buffer");
+                        return;
+                    }
+                    const playableBuffers = __classPrivateFieldGet(this, _EVIWebAudioPlayer_instances, "m", _EVIWebAudioPlayer_getNextAudioBuffers).call(this, message, audioBuffer);
+                    if (playableBuffers.length === 0) {
+                        return;
+                    }
+                    for (const nextAudioBufferToPlay of playableBuffers) {
+                        __classPrivateFieldGet(this, _EVIWebAudioPlayer_clipQueue, "f").push({
+                            id: nextAudioBufferToPlay.id,
+                            buffer: nextAudioBufferToPlay.buffer,
+                            index: nextAudioBufferToPlay.index,
+                        });
+                        if (__classPrivateFieldGet(this, _EVIWebAudioPlayer_clipQueue, "f").length === 1) {
+                            __classPrivateFieldGet(this, _EVIWebAudioPlayer_instances, "m", _EVIWebAudioPlayer_playNextClip).call(this);
+                        }
+                    }
+                }
+                catch (e) {
+                    const eMessage = e instanceof Error ? e.message : "Unknown error";
+                    __classPrivateFieldGet(this, _EVIWebAudioPlayer_instances, "m", _EVIWebAudioPlayer_emitError).call(this, `Failed to add clip to queue: ${eMessage}`);
+                }
             }
         });
     }
@@ -212,8 +260,20 @@ class EVIWebAudioPlayer extends EventTarget {
      */
     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" });
+        if (!__classPrivateFieldGet(this, _EVIWebAudioPlayer_disableAudioWorklet, "f")) {
+            // Clear buffered audio from the worklet queue
+            (_b = __classPrivateFieldGet(this, _EVIWebAudioPlayer_workletNode, "f")) === null || _b === void 0 ? void 0 : _b.port.postMessage({ type: "fadeAndClear" });
+        }
+        else {
+            // Regular Buffer mode
+            if (__classPrivateFieldGet(this, _EVIWebAudioPlayer_currentlyPlayingAudioBuffer, "f")) {
+                __classPrivateFieldGet(this, _EVIWebAudioPlayer_currentlyPlayingAudioBuffer, "f").stop();
+                __classPrivateFieldGet(this, _EVIWebAudioPlayer_currentlyPlayingAudioBuffer, "f").disconnect();
+                __classPrivateFieldSet(this, _EVIWebAudioPlayer_currentlyPlayingAudioBuffer, null, "f");
+            }
+            __classPrivateFieldSet(this, _EVIWebAudioPlayer_clipQueue, [], "f");
+            __classPrivateFieldSet(this, _EVIWebAudioPlayer_isProcessing, false, "f");
+        }
         // 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");
@@ -262,29 +322,32 @@ class EVIWebAudioPlayer extends EventTarget {
             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();
+        if (!__classPrivateFieldGet(this, _EVIWebAudioPlayer_disableAudioWorklet, "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();
+        }
+        else {
+            // Regular Buffer mode
+            if (__classPrivateFieldGet(this, _EVIWebAudioPlayer_currentlyPlayingAudioBuffer, "f")) {
+                __classPrivateFieldGet(this, _EVIWebAudioPlayer_currentlyPlayingAudioBuffer, "f").stop();
+                __classPrivateFieldGet(this, _EVIWebAudioPlayer_currentlyPlayingAudioBuffer, "f").disconnect();
+                __classPrivateFieldSet(this, _EVIWebAudioPlayer_currentlyPlayingAudioBuffer, null, "f");
+            }
+            __classPrivateFieldSet(this, _EVIWebAudioPlayer_clipQueue, [], "f");
+            __classPrivateFieldSet(this, _EVIWebAudioPlayer_isProcessing, false, "f");
+        }
         (_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");
+        __classPrivateFieldSet(this, _EVIWebAudioPlayer_fft, (0, generateEmptyFft_1.generateEmptyFft)(), "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() {
+_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_disableAudioWorklet = new WeakMap(), _EVIWebAudioPlayer_fft = new WeakMap(), _EVIWebAudioPlayer_fftTimer = new WeakMap(), _EVIWebAudioPlayer_fftOptions = new WeakMap(), _EVIWebAudioPlayer_clipQueue = new WeakMap(), _EVIWebAudioPlayer_currentlyPlayingAudioBuffer = new WeakMap(), _EVIWebAudioPlayer_isProcessing = new WeakMap(), _EVIWebAudioPlayer_lastQueuedChunk = new WeakMap(), _EVIWebAudioPlayer_chunkBufferQueues = new WeakMap(), _EVIWebAudioPlayer_instances = new WeakSet(), _EVIWebAudioPlayer_startAnalyserPollingIfEnabled = function _EVIWebAudioPlayer_startAnalyserPollingIfEnabled() {
     if (!__classPrivateFieldGet(this, _EVIWebAudioPlayer_fftOptions, "f") || !__classPrivateFieldGet(this, _EVIWebAudioPlayer_analyserNode, "f"))
         return;
     if (__classPrivateFieldGet(this, _EVIWebAudioPlayer_fftTimer, "f"))
@@ -298,6 +361,114 @@ _a = EVIWebAudioPlayer, _EVIWebAudioPlayer_ctx = new WeakMap(), _EVIWebAudioPlay
     }, interval), "f");
 }, _EVIWebAudioPlayer_emitError = function _EVIWebAudioPlayer_emitError(message) {
     this.dispatchEvent(new CustomEvent("error", { detail: { message } }));
+}, _EVIWebAudioPlayer_convertToAudioBuffer = function _EVIWebAudioPlayer_convertToAudioBuffer(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 has not been initialized");
+            return;
+        }
+        const blob = (0, convertBase64ToBlob_1.convertBase64ToBlob)(message.data);
+        const arrayBuffer = yield blob.arrayBuffer();
+        const audioBuffer = yield __classPrivateFieldGet(this, _EVIWebAudioPlayer_ctx, "f").decodeAudioData(arrayBuffer);
+        return audioBuffer;
+    });
+}, _EVIWebAudioPlayer_getNextAudioBuffers = function _EVIWebAudioPlayer_getNextAudioBuffers(message, audioBuffer) {
+    var _b, _c;
+    // Prevent prototype pollution by restricting dangerous property names.
+    if (message.id === "__proto__" || message.id === "constructor" || message.id === "prototype") {
+        __classPrivateFieldGet(this, _EVIWebAudioPlayer_instances, "m", _EVIWebAudioPlayer_emitError).call(this, `Attempted to use a dangerous property name as message ID: ${message.id}`);
+        return [];
+    }
+    //1. Add the current buffer to the queue
+    if (!__classPrivateFieldGet(this, _EVIWebAudioPlayer_chunkBufferQueues, "f")[message.id]) {
+        __classPrivateFieldGet(this, _EVIWebAudioPlayer_chunkBufferQueues, "f")[message.id] = [];
+    }
+    // Ensure message.index is a safe, non-negative integer to prevent prototype pollution.
+    if (!Number.isInteger(message.index) || message.index < 0) {
+        __classPrivateFieldGet(this, _EVIWebAudioPlayer_instances, "m", _EVIWebAudioPlayer_emitError).call(this, `Attempted to use an invalid index: ${message.index}`);
+        return [];
+    }
+    const queueForCurrMessage = __classPrivateFieldGet(this, _EVIWebAudioPlayer_chunkBufferQueues, "f")[message.id] || [];
+    queueForCurrMessage[message.index] = audioBuffer;
+    // 2. Now collect buffers that are ready to be played
+    const lastId = (_b = __classPrivateFieldGet(this, _EVIWebAudioPlayer_lastQueuedChunk, "f")) === null || _b === void 0 ? void 0 : _b.id;
+    const buffers = [];
+    // If the current message ID is different from the last one that was added
+    // to the queue, that means that we're playing a new message now, so the first chunk
+    // we play needs to be at index 0.
+    if (message.id !== lastId) {
+        if (queueForCurrMessage[0]) {
+            __classPrivateFieldSet(this, _EVIWebAudioPlayer_lastQueuedChunk, { id: message.id, index: 0 }, "f");
+            buffers.push({
+                id: message.id,
+                index: 0,
+                buffer: queueForCurrMessage[0],
+            });
+            queueForCurrMessage[0] = undefined;
+        }
+        else {
+            return [];
+        }
+    }
+    // Drain the queue - basically if any chunks were received out of order previously,
+    // and they're now ready to be played because the earlier chunks
+    // have been received, we can add them to the buffers array.
+    let nextIdx = (((_c = __classPrivateFieldGet(this, _EVIWebAudioPlayer_lastQueuedChunk, "f")) === null || _c === void 0 ? void 0 : _c.index) || 0) + 1;
+    let nextBuf = queueForCurrMessage[nextIdx];
+    while (nextBuf) {
+        buffers.push({ index: nextIdx, buffer: nextBuf, id: message.id });
+        queueForCurrMessage[nextIdx] = undefined;
+        __classPrivateFieldSet(this, _EVIWebAudioPlayer_lastQueuedChunk, { id: message.id, index: nextIdx }, "f");
+        nextIdx += 1;
+        nextBuf = queueForCurrMessage[nextIdx];
+    }
+    return buffers;
+}, _EVIWebAudioPlayer_playNextClip = function _EVIWebAudioPlayer_playNextClip() {
+    var _b, _c;
+    if (__classPrivateFieldGet(this, _EVIWebAudioPlayer_clipQueue, "f").length === 0 || __classPrivateFieldGet(this, _EVIWebAudioPlayer_isProcessing, "f")) {
+        return;
+    }
+    if (__classPrivateFieldGet(this, _EVIWebAudioPlayer_analyserNode, "f") === null || __classPrivateFieldGet(this, _EVIWebAudioPlayer_ctx, "f") === null) {
+        __classPrivateFieldGet(this, _EVIWebAudioPlayer_instances, "m", _EVIWebAudioPlayer_emitError).call(this, "Audio player is not initialized");
+        return;
+    }
+    const nextClip = __classPrivateFieldGet(this, _EVIWebAudioPlayer_clipQueue, "f").shift();
+    if (!nextClip) {
+        return;
+    }
+    __classPrivateFieldSet(this, _EVIWebAudioPlayer_isProcessing, true, "f");
+    __classPrivateFieldSet(this, _EVIWebAudioPlayer_playing, true, "f");
+    const bufferSource = __classPrivateFieldGet(this, _EVIWebAudioPlayer_ctx, "f").createBufferSource();
+    bufferSource.buffer = nextClip.buffer;
+    if (__classPrivateFieldGet(this, _EVIWebAudioPlayer_analyserNode, "f")) {
+        bufferSource.connect(__classPrivateFieldGet(this, _EVIWebAudioPlayer_analyserNode, "f"));
+    }
+    if (__classPrivateFieldGet(this, _EVIWebAudioPlayer_gainNode, "f")) {
+        (_b = __classPrivateFieldGet(this, _EVIWebAudioPlayer_analyserNode, "f")) === null || _b === void 0 ? void 0 : _b.connect(__classPrivateFieldGet(this, _EVIWebAudioPlayer_gainNode, "f"));
+        __classPrivateFieldGet(this, _EVIWebAudioPlayer_gainNode, "f").connect(__classPrivateFieldGet(this, _EVIWebAudioPlayer_ctx, "f").destination);
+    }
+    else {
+        (_c = __classPrivateFieldGet(this, _EVIWebAudioPlayer_analyserNode, "f")) === null || _c === void 0 ? void 0 : _c.connect(__classPrivateFieldGet(this, _EVIWebAudioPlayer_ctx, "f").destination);
+    }
+    __classPrivateFieldSet(this, _EVIWebAudioPlayer_currentlyPlayingAudioBuffer, bufferSource, "f");
+    __classPrivateFieldGet(this, _EVIWebAudioPlayer_instances, "m", _EVIWebAudioPlayer_startAnalyserPollingIfEnabled).call(this);
+    bufferSource.start(0);
+    if (nextClip.index === 0) {
+        this.dispatchEvent(new CustomEvent("play", { detail: { id: nextClip.id } }));
+    }
+    bufferSource.onended = () => {
+        if (__classPrivateFieldGet(this, _EVIWebAudioPlayer_fftTimer, "f")) {
+            clearInterval(__classPrivateFieldGet(this, _EVIWebAudioPlayer_fftTimer, "f"));
+            __classPrivateFieldSet(this, _EVIWebAudioPlayer_fftTimer, null, "f");
+        }
+        __classPrivateFieldSet(this, _EVIWebAudioPlayer_fft, (0, generateEmptyFft_1.generateEmptyFft)(), "f");
+        bufferSource.disconnect();
+        __classPrivateFieldSet(this, _EVIWebAudioPlayer_isProcessing, false, "f");
+        __classPrivateFieldSet(this, _EVIWebAudioPlayer_playing, false, "f");
+        this.dispatchEvent(new CustomEvent("stop", { detail: { id: nextClip.id } }));
+        __classPrivateFieldSet(this, _EVIWebAudioPlayer_currentlyPlayingAudioBuffer, null, "f");
+        __classPrivateFieldGet(this, _EVIWebAudioPlayer_instances, "m", _EVIWebAudioPlayer_playNextClip).call(this);
+    };
 };
 /** 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" };
@@ -305,10 +476,3 @@ _EVIWebAudioPlayer_DEFAULT_WORKLET_URL = { value: "https://storage.googleapis.co
 _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/convertFrequencyScale.d.ts

@@ -0,0 +1 @@
+export declare function convertLinearFrequenciesToBark(linearData: Uint8Array, sampleRate: number): number[];

package/dist/wrapper/convertFrequencyScale.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertLinearFrequenciesToBark = convertLinearFrequenciesToBark;
+// This function converts linear-scaled frequency decibels from an AnalyserNode's frequncy data to Bark scale [https://en.wikipedia.org/wiki/Bark_scale]
+// This implementation uses a simple approach of mapping indices in the linear-scaled array to the closest
+// Bark scale center frequency and is not intended to be an accurate representation, but rather "close-enough" for visualization purposes
+const barkCenterFrequencies = [
+    50, 150, 250, 350, 450, 570, 700, 840, 1000, 1170, 1370, 1600, 1850, 2150, 2500, 2900, 3400, 4000, 4800, 5800, 7000,
+    8500, 10500, 13500,
+]; // Center frequency value in Hz
+// Min/max values from https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/getByteFrequencyData
+const minValue = 0;
+const maxValue = 255;
+function convertLinearFrequenciesToBark(linearData, sampleRate) {
+    const maxFrequency = sampleRate / 2;
+    const frequencyResolution = maxFrequency / linearData.length;
+    const barkFrequencies = barkCenterFrequencies.map((barkFreq) => {
+        var _a;
+        const linearDataIndex = Math.round(barkFreq / frequencyResolution);
+        if (linearDataIndex >= 0 && linearDataIndex < linearData.length) {
+            return ((((_a = linearData[linearDataIndex]) !== null && _a !== void 0 ? _a : 0) - minValue) / (maxValue - minValue)) * 2;
+        }
+        else {
+            return 0;
+        }
+    });
+    return barkFrequencies;
+}

package/dist/wrapper/generateEmptyFft.d.ts

@@ -0,0 +1 @@
+export declare function generateEmptyFft(): number[];

package/dist/wrapper/generateEmptyFft.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateEmptyFft = generateEmptyFft;
+function generateEmptyFft() {
+    return Array.from({ length: 24 }).map(() => 0);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "hume",
-    "version": "0.13.2",
+    "version": "0.13.4",
     "private": false,
     "repository": "https://github.com/HumeAI/hume-typescript-sdk",
     "main": "./index.js",
@@ -20,6 +20,7 @@
         "qs": "^6.13.1",
         "readable-stream": "^4.5.2",
         "ws": "^8.14.2",
+        "isomorphic-ws": "^5.0.0",
         "uuid": "9.0.1",
         "zod": "^3.23.8"
     },

package/serialization/resources/tts/types/PublishTts.d.ts

@@ -0,0 +1,19 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as serializers from "../../../index";
+import * as Hume from "../../../../api/index";
+import * as core from "../../../../core";
+import { PostedUtteranceVoice } from "./PostedUtteranceVoice";
+export declare const PublishTts: core.serialization.ObjectSchema<serializers.tts.PublishTts.Raw, Hume.tts.PublishTts>;
+export declare namespace PublishTts {
+    interface Raw {
+        text?: string | null;
+        description?: string | null;
+        voice?: PostedUtteranceVoice.Raw | null;
+        speed?: number | null;
+        trailing_silence?: number | null;
+        flush?: boolean | null;
+        close?: boolean | null;
+    }
+}

package/serialization/resources/tts/types/PublishTts.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PublishTts = void 0;
+const core = __importStar(require("../../../../core"));
+const PostedUtteranceVoice_1 = require("./PostedUtteranceVoice");
+exports.PublishTts = core.serialization.object({
+    text: core.serialization.string().optional(),
+    description: core.serialization.string().optional(),
+    voice: PostedUtteranceVoice_1.PostedUtteranceVoice.optional(),
+    speed: core.serialization.number().optional(),
+    trailingSilence: core.serialization.property("trailing_silence", core.serialization.number().optional()),
+    flush: core.serialization.boolean().optional(),
+    close: core.serialization.boolean().optional(),
+});

package/serialization/resources/tts/types/SnippetAudioChunk.d.ts

@@ -18,6 +18,6 @@ export declare namespace SnippetAudioChunk {
         audio_format: AudioFormatType.Raw;
         is_last_chunk: boolean;
         utterance_index?: number | null;
-        snippet: Snippet.Raw;
+        snippet?: Snippet.Raw | null;
     }
 }

package/serialization/resources/tts/types/SnippetAudioChunk.js

@@ -50,5 +50,5 @@ exports.SnippetAudioChunk = core.serialization.object({
     audioFormat: core.serialization.property("audio_format", AudioFormatType_1.AudioFormatType),
     isLastChunk: core.serialization.property("is_last_chunk", core.serialization.boolean()),
     utteranceIndex: core.serialization.property("utterance_index", core.serialization.number().optional()),
-    snippet: Snippet_1.Snippet,
+    snippet: Snippet_1.Snippet.optional(),
 });

package/serialization/resources/tts/types/index.d.ts

@@ -1,7 +1,13 @@
+export * from "./PublishTts";
+export * from "./PostedUtteranceVoiceWithId";
+export * from "./PostedUtteranceVoiceWithName";
+export * from "./VoiceProvider";
+export * from "./PostedUtteranceVoice";
+export * from "./AudioFormatType";
+export * from "./SnippetAudioChunk";
 export * from "./PostedContextWithGenerationId";
 export * from "./PostedContextWithUtterances";
 export * from "./AudioEncoding";
-export * from "./AudioFormatType";
 export * from "./ReturnGeneration";
 export * from "./HttpValidationError";
 export * from "./FormatMp3";
@@ -12,14 +18,9 @@ export * from "./ReturnTts";
 export * from "./ReturnVoice";
 export * from "./FormatPcm";
 export * from "./Snippet";
-export * from "./SnippetAudioChunk";
 export * from "./PostedUtterance";
 export * from "./ValidationErrorLocItem";
 export * from "./ValidationError";
-export * from "./PostedUtteranceVoiceWithId";
-export * from "./PostedUtteranceVoiceWithName";
-export * from "./VoiceProvider";
-export * from "./PostedUtteranceVoice";
 export * from "./FormatWav";
 export * from "./ErrorResponse";
 export * from "./ReturnPagedVoices";

package/serialization/resources/tts/types/index.js

@@ -14,10 +14,16 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./PublishTts"), exports);
+__exportStar(require("./PostedUtteranceVoiceWithId"), exports);
+__exportStar(require("./PostedUtteranceVoiceWithName"), exports);
+__exportStar(require("./VoiceProvider"), exports);
+__exportStar(require("./PostedUtteranceVoice"), exports);
+__exportStar(require("./AudioFormatType"), exports);
+__exportStar(require("./SnippetAudioChunk"), exports);
 __exportStar(require("./PostedContextWithGenerationId"), exports);
 __exportStar(require("./PostedContextWithUtterances"), exports);
 __exportStar(require("./AudioEncoding"), exports);
-__exportStar(require("./AudioFormatType"), exports);
 __exportStar(require("./ReturnGeneration"), exports);
 __exportStar(require("./HttpValidationError"), exports);
 __exportStar(require("./FormatMp3"), exports);
@@ -28,14 +34,9 @@ __exportStar(require("./ReturnTts"), exports);
 __exportStar(require("./ReturnVoice"), exports);
 __exportStar(require("./FormatPcm"), exports);
 __exportStar(require("./Snippet"), exports);
-__exportStar(require("./SnippetAudioChunk"), exports);
 __exportStar(require("./PostedUtterance"), exports);
 __exportStar(require("./ValidationErrorLocItem"), exports);
 __exportStar(require("./ValidationError"), exports);
-__exportStar(require("./PostedUtteranceVoiceWithId"), exports);
-__exportStar(require("./PostedUtteranceVoiceWithName"), exports);
-__exportStar(require("./VoiceProvider"), exports);
-__exportStar(require("./PostedUtteranceVoice"), exports);
 __exportStar(require("./FormatWav"), exports);
 __exportStar(require("./ErrorResponse"), exports);
 __exportStar(require("./ReturnPagedVoices"), exports);

package/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.13.2";
+export declare const SDK_VERSION = "0.13.4";