@layercode/js-sdk 2.4.0 → 2.6.0

package/dist/layercode-js-sdk.esm.js

@@ -505,12 +505,37 @@ class WavStreamPlayer {
     this.sampleRate = sampleRate;
     this.context = null;
     this.stream = null;
+    this.gainNode = null;
     this.analyser = null;
     this.trackSampleOffsets = {};
     this.interruptedTrackIds = {};
     this.finishedPlayingCallback = finishedPlayingCallback;
     this.isPlaying = false;
     this.amplitudeMonitorRaf = undefined;
+    this.muted = false;
+  }
+
+  _ensureGainNode() {
+    if (!this.context) {
+      return null;
+    }
+    if (!this.gainNode) {
+      this.gainNode = this.context.createGain();
+      this._applyGain();
+    }
+    return this.gainNode;
+  }
+
+  _applyGain() {
+    if (!this.gainNode || !this.context) {
+      return;
+    }
+    const target = this.muted ? 0 : 1;
+    try {
+      this.gainNode.gain.setTargetAtTime(target, this.context.currentTime, 0.01);
+    } catch {
+      this.gainNode.gain.value = target;
+    }
   }
 
   /**
@@ -550,6 +575,7 @@ class WavStreamPlayer {
     analyser.fftSize = 8192;
     analyser.smoothingTimeConstant = 0.1;
     this.analyser = analyser;
+    this._ensureGainNode();
     this.isPlaying = true;
     return true;
   }
@@ -619,12 +645,19 @@ class WavStreamPlayer {
    */
   _start() {
     const streamNode = new AudioWorkletNode(this.context, "stream_processor");
-    streamNode.connect(this.context.destination);
+    const gainNode = this._ensureGainNode();
+    if (!gainNode) {
+      throw new Error("GainNode not initialized");
+    }
     streamNode.port.onmessage = (e) => {
       const { event } = e.data;
       if (event === "stop") {
         streamNode.disconnect();
+        gainNode.disconnect();
         this.stream = null;
+        if (this.analyser) {
+          this.analyser.disconnect();
+        }
         this.isPlaying = false;
         this.finishedPlayingCallback();
       } else if (event === "offset") {
@@ -633,8 +666,15 @@ class WavStreamPlayer {
         this.trackSampleOffsets[requestId] = { trackId, offset, currentTime };
       }
     };
-    this.analyser.disconnect();
-    streamNode.connect(this.analyser);
+    if (this.analyser) {
+      this.analyser.disconnect();
+      streamNode.connect(gainNode);
+      gainNode.connect(this.analyser);
+      this.analyser.connect(this.context.destination);
+    } else {
+      streamNode.connect(gainNode);
+      gainNode.connect(this.context.destination);
+    }
     this.stream = streamNode;
     this.isPlaying = true;
     return true;
@@ -764,6 +804,16 @@ class WavStreamPlayer {
     }
   }
 
+  mute() {
+    this.muted = true;
+    this._applyGain();
+  }
+
+  unmute() {
+    this.muted = false;
+    this._applyGain();
+  }
+
   /**
    * Disconnects the audio context and cleans up resources
    * @returns {void}
@@ -775,6 +825,11 @@ class WavStreamPlayer {
       this.stream = null;
     }
 
+    if (this.gainNode) {
+      this.gainNode.disconnect();
+      this.gainNode = null;
+    }
+
     if (this.analyser) {
       this.analyser.disconnect();
     }
@@ -3625,7 +3680,7 @@ class LayercodeClient {
      * @param {Object} options - Configuration options
      */
     constructor(options) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y;
         this.deviceId = null;
         this.options = {
             agentId: options.agentId,
@@ -3636,22 +3691,25 @@ class LayercodeClient {
             vadResumeDelay: (_c = options.vadResumeDelay) !== null && _c !== void 0 ? _c : 500,
             audioInput: (_d = options.audioInput) !== null && _d !== void 0 ? _d : true,
             audioInputChanged: (_e = options.audioInputChanged) !== null && _e !== void 0 ? _e : NOOP,
-            onConnect: (_f = options.onConnect) !== null && _f !== void 0 ? _f : NOOP,
-            onDisconnect: (_g = options.onDisconnect) !== null && _g !== void 0 ? _g : NOOP,
-            onError: (_h = options.onError) !== null && _h !== void 0 ? _h : NOOP,
-            onDeviceSwitched: (_j = options.onDeviceSwitched) !== null && _j !== void 0 ? _j : NOOP,
-            onDevicesChanged: (_k = options.onDevicesChanged) !== null && _k !== void 0 ? _k : NOOP,
-            onDataMessage: (_l = options.onDataMessage) !== null && _l !== void 0 ? _l : NOOP,
-            onMessage: (_m = options.onMessage) !== null && _m !== void 0 ? _m : NOOP,
-            onUserAmplitudeChange: (_o = options.onUserAmplitudeChange) !== null && _o !== void 0 ? _o : NOOP,
-            onAgentAmplitudeChange: (_p = options.onAgentAmplitudeChange) !== null && _p !== void 0 ? _p : NOOP,
-            onStatusChange: (_q = options.onStatusChange) !== null && _q !== void 0 ? _q : NOOP,
-            onUserIsSpeakingChange: (_r = options.onUserIsSpeakingChange) !== null && _r !== void 0 ? _r : NOOP,
-            onAgentSpeakingChange: (_s = options.onAgentSpeakingChange) !== null && _s !== void 0 ? _s : NOOP,
-            onMuteStateChange: (_t = options.onMuteStateChange) !== null && _t !== void 0 ? _t : NOOP,
-            enableAmplitudeMonitoring: (_u = options.enableAmplitudeMonitoring) !== null && _u !== void 0 ? _u : true,
+            audioOutput: (_f = options.audioOutput) !== null && _f !== void 0 ? _f : true,
+            audioOutputChanged: (_g = options.audioOutputChanged) !== null && _g !== void 0 ? _g : NOOP,
+            onConnect: (_h = options.onConnect) !== null && _h !== void 0 ? _h : NOOP,
+            onDisconnect: (_j = options.onDisconnect) !== null && _j !== void 0 ? _j : NOOP,
+            onError: (_k = options.onError) !== null && _k !== void 0 ? _k : NOOP,
+            onDeviceSwitched: (_l = options.onDeviceSwitched) !== null && _l !== void 0 ? _l : NOOP,
+            onDevicesChanged: (_m = options.onDevicesChanged) !== null && _m !== void 0 ? _m : NOOP,
+            onDataMessage: (_o = options.onDataMessage) !== null && _o !== void 0 ? _o : NOOP,
+            onMessage: (_p = options.onMessage) !== null && _p !== void 0 ? _p : NOOP,
+            onUserAmplitudeChange: (_q = options.onUserAmplitudeChange) !== null && _q !== void 0 ? _q : NOOP,
+            onAgentAmplitudeChange: (_r = options.onAgentAmplitudeChange) !== null && _r !== void 0 ? _r : NOOP,
+            onStatusChange: (_s = options.onStatusChange) !== null && _s !== void 0 ? _s : NOOP,
+            onUserIsSpeakingChange: (_t = options.onUserIsSpeakingChange) !== null && _t !== void 0 ? _t : NOOP,
+            onAgentSpeakingChange: (_u = options.onAgentSpeakingChange) !== null && _u !== void 0 ? _u : NOOP,
+            onMuteStateChange: (_v = options.onMuteStateChange) !== null && _v !== void 0 ? _v : NOOP,
+            enableAmplitudeMonitoring: (_w = options.enableAmplitudeMonitoring) !== null && _w !== void 0 ? _w : true,
         };
-        this.audioInput = (_v = options.audioInput) !== null && _v !== void 0 ? _v : true;
+        this.audioInput = (_x = options.audioInput) !== null && _x !== void 0 ? _x : true;
+        this.audioOutput = (_y = options.audioOutput) !== null && _y !== void 0 ? _y : true;
         this._emitAudioInput();
         this.AMPLITUDE_MONITORING_SAMPLE_RATE = 2;
         this._websocketUrl = DEFAULT_WS_URL;
@@ -4037,11 +4095,30 @@ class LayercodeClient {
         }
     }
     _stopAmplitudeMonitoring() {
-        var _a, _b;
-        (_a = this.stopPlayerAmplitude) === null || _a === void 0 ? void 0 : _a.call(this);
-        (_b = this.stopRecorderAmplitude) === null || _b === void 0 ? void 0 : _b.call(this);
-        this.stopPlayerAmplitude = undefined;
-        this.stopRecorderAmplitude = undefined;
+        this._stopPlayerAmplitudeMonitoring();
+        this._stopRecorderAmplitudeMonitoring();
+    }
+    _stopPlayerAmplitudeMonitoring() {
+        var _a;
+        this.agentAudioAmplitude = 0;
+        if (this.options.enableAmplitudeMonitoring && this.options.onAgentAmplitudeChange !== NOOP) {
+            this.options.onAgentAmplitudeChange(0);
+        }
+        if (this.stopPlayerAmplitude) {
+            (_a = this.stopPlayerAmplitude) === null || _a === void 0 ? void 0 : _a.call(this);
+            this.stopPlayerAmplitude = undefined;
+        }
+    }
+    _stopRecorderAmplitudeMonitoring() {
+        var _a;
+        this.userAudioAmplitude = 0;
+        if (this.options.enableAmplitudeMonitoring && this.options.onUserAmplitudeChange !== NOOP) {
+            this.options.onUserAmplitudeChange(0);
+        }
+        if (this.stopRecorderAmplitude) {
+            (_a = this.stopRecorderAmplitude) === null || _a === void 0 ? void 0 : _a.call(this);
+            this.stopRecorderAmplitude = undefined;
+        }
     }
     async audioInputConnect() {
         // Turn mic ON
@@ -4050,10 +4127,9 @@ class LayercodeClient {
         this._setupDeviceChangeListener();
     }
     async audioInputDisconnect() {
-        var _a;
         try {
             // stop amplitude monitoring tied to the recorder
-            (_a = this.stopRecorderAmplitude) === null || _a === void 0 ? void 0 : _a.call(this);
+            this._stopRecorderAmplitudeMonitoring();
             // Try a graceful stop; end() already stops tracks and closes the AudioContext
             await this.wavRecorder.end();
             this.stopVad();
@@ -4061,7 +4137,7 @@ class LayercodeClient {
             this._teardownDeviceListeners();
             this.recorderStarted = false;
         }
-        catch (_b) {
+        catch (_a) {
             // If there wasn't an active session, just release any stray tracks
             const stream = this.wavRecorder.getStream();
             stream === null || stream === void 0 ? void 0 : stream.getTracks().forEach((t) => t.stop());
@@ -4079,10 +4155,25 @@ class LayercodeClient {
             }
         }
     }
+    async setAudioOutput(state) {
+        if (this.audioOutput !== state) {
+            this.audioOutput = state;
+            this._emitAudioOutput();
+            if (state) {
+                this.wavPlayer.unmute();
+            }
+            else {
+                this.wavPlayer.mute();
+            }
+        }
+    }
     /** Emitters for audio flags */
     _emitAudioInput() {
         this.options.audioInputChanged(this.audioInput);
     }
+    _emitAudioOutput() {
+        this.options.audioOutputChanged(this.audioOutput);
+    }
     get audioInputEnabled() {
         return this.audioInput;
     }
@@ -4208,6 +4299,12 @@ class LayercodeClient {
         if (!this.options.enableAmplitudeMonitoring) {
             this.agentAudioAmplitude = 0;
         }
+        if (this.audioOutput) {
+            this.wavPlayer.unmute();
+        }
+        else {
+            this.wavPlayer.mute();
+        }
     }
     async connectToAudioInput() {
         if (!this.audioInput) {
@@ -4281,16 +4378,15 @@ class LayercodeClient {
      * Restarts audio recording after a device switch to ensure audio is captured from the new device
      */
     async _restartAudioRecording() {
-        var _a, _b, _c;
+        var _a, _b;
         try {
             console.debug('Restarting audio recording after device switch...');
             // Stop amplitude monitoring tied to the previous recording session before tearing it down
-            (_a = this.stopRecorderAmplitude) === null || _a === void 0 ? void 0 : _a.call(this);
-            this.stopRecorderAmplitude = undefined;
+            this._stopRecorderAmplitudeMonitoring();
             try {
                 await this.wavRecorder.end();
             }
-            catch (_d) {
+            catch (_c) {
                 // Ignore cleanup errors
             }
             // Start with new device
@@ -4312,7 +4408,7 @@ class LayercodeClient {
                 this.recorderStarted = true;
                 this._sendReadyIfNeeded();
             }
-            const reportedDeviceId = (_b = this.activeDeviceId) !== null && _b !== void 0 ? _b : (this.useSystemDefaultDevice ? 'default' : (_c = this.deviceId) !== null && _c !== void 0 ? _c : 'default');
+            const reportedDeviceId = (_a = this.activeDeviceId) !== null && _a !== void 0 ? _a : (this.useSystemDefaultDevice ? 'default' : (_b = this.deviceId) !== null && _b !== void 0 ? _b : 'default');
             if (reportedDeviceId !== previousReportedDeviceId) {
                 this.lastReportedDeviceId = reportedDeviceId;
                 if (this.options.onDeviceSwitched) {
@@ -4456,6 +4552,7 @@ class LayercodeClient {
             console.log('Microphone muted');
             this.options.onMuteStateChange(true);
             this.stopVad();
+            this._stopRecorderAmplitudeMonitoring();
         }
     }
     /**
@@ -4467,6 +4564,9 @@ class LayercodeClient {
             console.log('Microphone unmuted');
             this.options.onMuteStateChange(false);
             this._initializeVAD();
+            if (this.stopRecorderAmplitude === undefined) {
+                this._setupAmplitudeMonitoring(this.wavRecorder, this.options.onUserAmplitudeChange, (amp) => (this.userAudioAmplitude = amp));
+            }
         }
     }
 }