videomail-client 15.8.3 → 15.9.0

package/dist/cjs/index.cjs

@@ -10972,7 +10972,7 @@ var __webpack_exports__ = {};
     var client = __webpack_require__("Q");
     var client_default = /*#__PURE__*/ __webpack_require__.n(client);
     var package_namespaceObject = {
-        rE: "15.8.3"
+        rE: "15.9.0"
     };
     function isAudioEnabled(options) {
         return Boolean(options.audio.enabled);
@@ -19188,7 +19188,7 @@ var __webpack_exports__ = {};
             }
             let { bufferSize } = this.options.audio;
             if ("auto" === bufferSize) bufferSize = util_getBrowser(this.options).isFirefox() ? 512 : 2048;
-            if (!is_power_of_two_default()(bufferSize)) throw error_createError({
+            if (void 0 === bufferSize || !is_power_of_two_default()(bufferSize)) throw error_createError({
                 message: `Audio buffer size must be a power of two. The current buffer size is ${bufferSize}.`,
                 options: this.options
             });
@@ -19267,9 +19267,14 @@ var __webpack_exports__ = {};
     const EVENT_ASCII = "|—O—|";
     class UserMedia extends util_Despot {
         attachMediaStream(stream) {
-            this.currentVisualStream = stream;
-            if (this.rawVisualUserMedia) this.rawVisualUserMedia.srcObject = stream;
-            else throw error_createError({
+            if (this.rawVisualUserMedia) {
+                this.rawVisualUserMedia.srcObject = stream;
+                const previousStream = this.currentVisualStream;
+                this.currentVisualStream = stream;
+                if (previousStream && previousStream !== stream) previousStream.getTracks().forEach((track)=>{
+                    track.stop();
+                });
+            } else throw error_createError({
                 message: "Error attaching stream to element.",
                 explanation: "Contact the developer about this",
                 options: this.options
@@ -19343,11 +19348,14 @@ var __webpack_exports__ = {};
                             }
                         }).catch((exc)=>{
                             if (exc instanceof Error) this.options.logger.warn(`Caught pending user media promise exception: ${exc.toString()}`);
-                            else throw error_createError({
-                                message: "Failed to play user media upon play event.",
-                                exc,
-                                options: this.options
-                            });
+                            else {
+                                unloadAllEventListeners();
+                                endedEarlyCallback(error_createError({
+                                    message: "Failed to play user media upon play event.",
+                                    exc,
+                                    options: this.options
+                                }));
+                            }
                         });
                     }
                 } catch (exc) {
@@ -19359,18 +19367,18 @@ var __webpack_exports__ = {};
                 var _this_rawVisualUserMedia;
                 const readyState = null == (_this_rawVisualUserMedia = this.rawVisualUserMedia) ? void 0 : _this_rawVisualUserMedia.readyState;
                 this.options.logger.debug(`UserMedia: fireCallbacks(readyState=${readyState}, onPlayReached=${this.onPlayReached}, onLoadedMetaDataReached=${this.onLoadedMetaDataReached})`);
-                if (this.onPlayReached && this.onLoadedMetaDataReached) {
+                if (this.onPlayReached && this.onLoadedMetaDataReached) if (this.audioRecorder) try {
+                    this.audioRecorder.init(localMediaStream);
+                    this.on("SENDING_FIRST_FRAME", ()=>{
+                        this.audioRecord(audioCallback);
+                    });
                     videoCallback();
-                    if (this.audioRecorder) try {
-                        this.audioRecorder.init(localMediaStream);
-                        this.on("SENDING_FIRST_FRAME", ()=>{
-                            this.audioRecord(audioCallback);
-                        });
-                    } catch (exc) {
-                        unloadAllEventListeners();
-                        endedEarlyCallback(exc);
-                    }
+                } catch (exc) {
+                    unloadAllEventListeners();
+                    this.stop();
+                    endedEarlyCallback(exc);
                 }
+                else videoCallback();
             };
             const onPlay = ()=>{
                 try {
@@ -19684,6 +19692,37 @@ var __webpack_exports__ = {};
             window.clearTimeout(this.connectionTimeout);
             this.connectionTimeout = void 0;
         }
+        clearReconnectTimeout() {
+            if (void 0 === this.reconnectTimeout) return;
+            this.options.logger.debug("Recorder: clearReconnectTimeout()");
+            window.clearTimeout(this.reconnectTimeout);
+            this.reconnectTimeout = void 0;
+        }
+        handleConnectionFailure(params) {
+            if (this.retryConnection(params)) return;
+            this.failConnection(params);
+        }
+        retryConnection(params) {
+            if (!this.reconnecting || !this.userMediaLoaded || !this.isOnline() || this.unloaded || this.blocking) return false;
+            if (void 0 !== this.reconnectTimeout) return true;
+            const delayMs = Math.min(500 * Math.pow(2, this.reconnectAttempts), 10000);
+            this.reconnectAttempts++;
+            this.connecting = false;
+            this.clearConnectionTimeout();
+            this.discardSocket();
+            this.options.logger.debug(`Recorder: WebSocket reconnect failed (${params.cause}); retrying in ${delayMs}ms.`);
+            this.reconnectTimeout = window.setTimeout(()=>{
+                this.reconnectTimeout = void 0;
+                if (this.reconnecting && !this.unloaded && !this.blocking) this.initSocket();
+            }, delayMs);
+            return true;
+        }
+        discardSocket() {
+            this.options.logger.debug("Recorder: discarding socket stream ...");
+            const stream = this.stream;
+            this.stream = void 0;
+            if (stream && !stream.destroyed) stream.destroy();
+        }
         isOnline() {
             return navigator.onLine;
         }
@@ -19692,6 +19731,9 @@ var __webpack_exports__ = {};
             if (this.connectionFailed || this.connected || this.unloaded) return;
             this.connectionFailed = true;
             this.connecting = false;
+            this.reconnecting = false;
+            this.reconnectAttempts = 0;
+            this.clearReconnectTimeout();
             this.clearConnectionTimeout();
             const { url2Connect, cause } = params;
             const online = this.isOnline();
@@ -19726,10 +19768,7 @@ var __webpack_exports__ = {};
                 explanation = `Connection to ${url2Connect} is closed${closeSuffix}. Please check your internet connection and try again. If the problem persists, contact us.`;
             }
             else explanation = "Your device appears to be offline. Please check your internet connection and try again.";
-            if (this.stream) {
-                this.stream.destroy();
-                this.stream = void 0;
-            }
+            this.discardSocket();
             const err = error_createError({
                 message: "Unable to connect to the server",
                 explanation,
@@ -19813,8 +19852,13 @@ var __webpack_exports__ = {};
             this.recordingStats.waitingTime = this.waitingTime;
         }
         initSocket(cb) {
-            if (this.connected) return void (null == cb || cb());
-            if (this.connecting) return;
+            if (this.connected) {
+                this.options.logger.debug("Recorder: already **connected**. Not going to initialize a new WebSocket connection.");
+                null == cb || cb();
+                return;
+            }
+            if (this.connecting) return void this.options.logger.debug("Recorder: already **connecting**. Not going to initialize a new WebSocket connection.");
+            this.clearReconnectTimeout();
             if (util_isAutomatedUserAgent()) {
                 this.connecting = false;
                 this.options.logger.debug("Recorder: skipping web socket connection for an automated crawler");
@@ -19893,8 +19937,12 @@ var __webpack_exports__ = {};
                 this.connectionTimeout = window.setTimeout(()=>{
                     if (this.isOnline() && this.isUserMediaLoaded()) {
                         this.options.logger.debug(`${PIPE_SYMBOL}Reconnecting due to connection timeout.`);
-                        this.initSocket();
-                    } else this.failConnection({
+                        this.reconnecting = true;
+                        this.handleConnectionFailure({
+                            url2Connect,
+                            cause: "timeout"
+                        });
+                    } else this.handleConnectionFailure({
                         url2Connect,
                         cause: "timeout"
                     });
@@ -19909,9 +19957,11 @@ var __webpack_exports__ = {};
                     this.options.logger.debug(debugLine);
                     const tryReconnect = this.connected && this.userMediaLoaded;
                     this.connected = false;
-                    if (tryReconnect) this.initSocket();
-                    else if (!this.connecting && !this.blocking) window.setTimeout(()=>{
-                        this.failConnection({
+                    if (tryReconnect) {
+                        this.reconnecting = true;
+                        this.initSocket();
+                    } else if (!this.connecting && !this.blocking) window.setTimeout(()=>{
+                        this.handleConnectionFailure({
                             url2Connect,
                             cause: "closed"
                         });
@@ -19925,6 +19975,9 @@ var __webpack_exports__ = {};
                     if (!this.connected && !isClosing && !this.unloaded) {
                         this.connected = true;
                         this.connecting = this.unloaded = false;
+                        this.reconnecting = false;
+                        this.reconnectAttempts = 0;
+                        this.clearReconnectTimeout();
                         this.emit("CONNECTED");
                         null == cb || cb();
                     }
@@ -19955,7 +20008,7 @@ var __webpack_exports__ = {};
                         error: serializeError(err)
                     });
                     this.options.logger.debug(debugLine);
-                    if (!this.connected) return void this.failConnection({
+                    if (!this.connected) return void this.handleConnectionFailure({
                         url2Connect,
                         cause: "error"
                     });
@@ -20016,6 +20069,7 @@ var __webpack_exports__ = {};
         }
         userMediaErrorCallback(err, usedConstraints) {
             var _this_userMedia;
+            if (this.unloaded) return void this.options.logger.debug(`Recorder: already unloaded. Not going to throw error ${util_pretty(err)}`);
             this.userMediaLoading = false;
             this.clearUserMediaTimeout();
             const characteristics = null == (_this_userMedia = this.userMedia) ? void 0 : _this_userMedia.getCharacteristics();
@@ -20034,10 +20088,9 @@ var __webpack_exports__ = {};
                 this.options.logger.debug(`Recorder: ignore user media error ${util_pretty(err)}`);
                 this.retryTimeout = window.setTimeout(()=>{
                     this.retryTimeout = void 0;
-                    this.loadUserMedia();
+                    if (!this.unloaded) this.loadUserMedia();
                 }, this.options.timeouts.userMedia);
             }
-            else if (this.unloaded) this.options.logger.debug(`Recorder: already unloaded. Not going to throw error ${util_pretty(err)}`);
             else {
                 this.options.logger.debug(`Recorder: no error listeners attached but throwing error ${util_pretty(err)}`);
                 throw error_createError({
@@ -20048,26 +20101,46 @@ var __webpack_exports__ = {};
             }
         }
         getUserMediaCallback(localStream, params) {
-            if (!this.userMedia) throw new Error("No user media is defined");
+            if (!this.userMedia) {
+                localStream.getTracks().forEach((track)=>{
+                    track.stop();
+                });
+                throw error_createError({
+                    message: "No user media is defined",
+                    options: this.options
+                });
+            }
             this.options.logger.debug(`Recorder: getUserMediaCallback(${params ? util_pretty(params) : ""})`);
             if (this.showUserMedia()) try {
-                this.clearUserMediaTimeout();
                 this.userMedia.init(localStream, ()=>{
-                    this.onUserMediaReady(params);
+                    if (!this.unloaded) this.onUserMediaReady(params);
                 }, this.onAudioSample.bind(this), (err)=>{
-                    this.emit("ERROR", {
-                        err
+                    if (!this.unloaded) this.userMediaErrorCallback(err, {
+                        audio: isAudioEnabled(this.options)
                     });
                 }, null == params ? void 0 : params.switchingFacingMode);
             } catch (exc) {
+                localStream.getTracks().forEach((track)=>{
+                    track.stop();
+                });
+                this.userMediaLoading = false;
+                this.clearUserMediaTimeout();
                 this.emit("ERROR", {
                     exc
                 });
             }
+            else {
+                localStream.getTracks().forEach((track)=>{
+                    track.stop();
+                });
+                this.userMediaLoading = false;
+                this.clearUserMediaTimeout();
+            }
         }
         loadGenuineUserMedia(params) {
             this.options.logger.debug(`Recorder: loadGenuineUserMedia(${params ? util_pretty(params) : ""})`);
             this.emit("ASKING_WEBCAM_PERMISSION");
+            this.userMediaLoading = true;
             const constraints = {
                 video: {
                     frameRate: {
@@ -20098,9 +20171,12 @@ var __webpack_exports__ = {};
             this.options.logger.debug(util_summarize("Recorder: available webcam constraints are:", navigator.mediaDevices.getSupportedConstraints()));
             const streamPromise = navigator.mediaDevices.getUserMedia(constraints);
             streamPromise.then((localStream)=>{
+                if (this.unloaded) return void localStream.getTracks().forEach((track)=>{
+                    track.stop();
+                });
                 this.getUserMediaCallback(localStream, params);
             }).catch((reason)=>{
-                this.userMediaErrorCallback(reason, constraints);
+                if (!this.unloaded) this.userMediaErrorCallback(reason, constraints);
             });
         }
         loadUserMedia(params) {
@@ -20114,7 +20190,8 @@ var __webpack_exports__ = {};
             try {
                 if (!navigator.mediaDevices) throw new Error("No media devices are available.");
                 this.userMediaTimeout = window.setTimeout(()=>{
-                    if (!this.isReady()) {
+                    if (!this.userMediaLoaded) {
+                        this.userMediaLoading = false;
                         const err = util_getBrowser(this.options).getNoAccessIssue();
                         this.emit("ERROR", {
                             err
@@ -20214,16 +20291,16 @@ var __webpack_exports__ = {};
                         command,
                         args
                     };
-                    this.writeStream(Buffer.from(JSON.stringify(commandObj)));
-                    if (cb) setTimeout(function() {
-                        cb();
-                    }, 0);
+                    this.writeStream(Buffer.from(JSON.stringify(commandObj)), cb ? {
+                        onFlushedCallback: ()=>{
+                            queueMicrotask(cb);
+                        }
+                    } : void 0);
                 }
             } else {
                 this.options.logger.debug(`Reconnecting for the command ${command} …`);
                 this.initSocket(()=>{
-                    this.writeCommand(command, args);
-                    null == cb || cb();
+                    this.writeCommand(command, args, cb);
                 });
             }
         }
@@ -20298,6 +20375,7 @@ var __webpack_exports__ = {};
             var _this_userMedia;
             this.options.logger.debug("Recorder: reInitializeAudio()");
             this.clearUserMediaTimeout();
+            this.userMediaLoading = false;
             null == (_this_userMedia = this.userMedia) || _this_userMedia.stop();
             this.userMediaLoaded = this.key = this.canvas = this.ctx = void 0;
             this.loadUserMedia();
@@ -20312,17 +20390,17 @@ var __webpack_exports__ = {};
             this.reset();
             this.clearUserMediaTimeout();
             this.clearConnectionTimeout();
+            this.clearReconnectTimeout();
             this.clearRetryTimeout();
             this.clearStopTimeout();
             this.stopPings();
+            this.userMediaLoading = false;
             this.connecting = false;
+            this.reconnecting = false;
+            this.reconnectAttempts = 0;
             if (this.userMedia) this.userMedia.unloadRemainingEventListeners();
             if (this.submitting) ;
-            else if (this.stream) {
-                this.options.logger.debug("Recorder: destroying stream ...");
-                this.stream.destroy();
-                this.stream = void 0;
-            }
+            else if (this.stream) this.discardSocket();
             this.unloaded = true;
             this.built = this.connecting = this.connected = false;
         }
@@ -20427,7 +20505,13 @@ var __webpack_exports__ = {};
             if (!this.connected) {
                 this.options.logger.debug("Recorder: reconnecting before recording …");
                 this.initSocket(()=>{
-                    this.once("USER_MEDIA_READY", this.record.bind(this));
+                    this.once("SERVER_READY", ()=>{
+                        if (this.unloaded) return;
+                        if (this.userMediaLoaded || this.options.loadUserMediaOnRecord) this.record();
+                        else this.once("USER_MEDIA_READY", ()=>{
+                            if (!this.unloaded) this.record();
+                        });
+                    });
                 });
                 return;
             }
@@ -20732,7 +20816,7 @@ var __webpack_exports__ = {};
             return this.userMediaLoaded;
         }
         constructor(visuals, replay, options){
-            super("Recorder", options), recorder_define_property(this, "visuals", void 0), recorder_define_property(this, "replay", void 0), recorder_define_property(this, "loop", void 0), recorder_define_property(this, "originalAnimationFrameObject", void 0), recorder_define_property(this, "samplesCount", 0), recorder_define_property(this, "framesCount", 0), recorder_define_property(this, "recordingStats", void 0), recorder_define_property(this, "confirmedFrameNumber", 0), recorder_define_property(this, "confirmedSampleNumber", 0), recorder_define_property(this, "recorderElement", void 0), recorder_define_property(this, "userMedia", void 0), recorder_define_property(this, "userMediaTimeout", void 0), recorder_define_property(this, "retryTimeout", void 0), recorder_define_property(this, "connectionTimeout", void 0), recorder_define_property(this, "stopTimeout", void 0), recorder_define_property(this, "frameProgress", void 0), recorder_define_property(this, "sampleProgress", void 0), recorder_define_property(this, "canvas", void 0), recorder_define_property(this, "ctx", void 0), recorder_define_property(this, "userMediaLoaded", void 0), recorder_define_property(this, "userMediaLoading", false), recorder_define_property(this, "submitting", false), recorder_define_property(this, "unloaded", void 0), recorder_define_property(this, "stopTime", void 0), recorder_define_property(this, "stream", void 0), recorder_define_property(this, "connecting", false), recorder_define_property(this, "connected", false), recorder_define_property(this, "connectionFailed", false), recorder_define_property(this, "blocking", false), recorder_define_property(this, "built", false), recorder_define_property(this, "key", void 0), recorder_define_property(this, "waitingTime", void 0), recorder_define_property(this, "connectingStartedAt", void 0), recorder_define_property(this, "lastCloseEvent", void 0), recorder_define_property(this, "lastSocketError", void 0), recorder_define_property(this, "pingInterval", void 0), recorder_define_property(this, "frame", void 0), recorder_define_property(this, "recordingBuffer", void 0), recorder_define_property(this, "facingMode", void 0);
+            super("Recorder", options), recorder_define_property(this, "visuals", void 0), recorder_define_property(this, "replay", void 0), recorder_define_property(this, "loop", void 0), recorder_define_property(this, "originalAnimationFrameObject", void 0), recorder_define_property(this, "samplesCount", 0), recorder_define_property(this, "framesCount", 0), recorder_define_property(this, "recordingStats", void 0), recorder_define_property(this, "confirmedFrameNumber", 0), recorder_define_property(this, "confirmedSampleNumber", 0), recorder_define_property(this, "recorderElement", void 0), recorder_define_property(this, "userMedia", void 0), recorder_define_property(this, "userMediaTimeout", void 0), recorder_define_property(this, "retryTimeout", void 0), recorder_define_property(this, "reconnectTimeout", void 0), recorder_define_property(this, "connectionTimeout", void 0), recorder_define_property(this, "stopTimeout", void 0), recorder_define_property(this, "frameProgress", void 0), recorder_define_property(this, "sampleProgress", void 0), recorder_define_property(this, "canvas", void 0), recorder_define_property(this, "ctx", void 0), recorder_define_property(this, "userMediaLoaded", void 0), recorder_define_property(this, "userMediaLoading", false), recorder_define_property(this, "submitting", false), recorder_define_property(this, "unloaded", void 0), recorder_define_property(this, "stopTime", void 0), recorder_define_property(this, "stream", void 0), recorder_define_property(this, "connecting", false), recorder_define_property(this, "connected", false), recorder_define_property(this, "connectionFailed", false), recorder_define_property(this, "reconnecting", false), recorder_define_property(this, "reconnectAttempts", 0), recorder_define_property(this, "blocking", false), recorder_define_property(this, "built", false), recorder_define_property(this, "key", void 0), recorder_define_property(this, "waitingTime", void 0), recorder_define_property(this, "connectingStartedAt", void 0), recorder_define_property(this, "lastCloseEvent", void 0), recorder_define_property(this, "lastSocketError", void 0), recorder_define_property(this, "pingInterval", void 0), recorder_define_property(this, "frame", void 0), recorder_define_property(this, "recordingBuffer", void 0), recorder_define_property(this, "facingMode", void 0);
             this.visuals = visuals;
             this.replay = replay;
             this.facingMode = options.video.facingMode;

package/dist/esm/index.js

@@ -3620,7 +3620,7 @@ const constants = {
     }
 };
 var package_namespaceObject = {
-    rE: "15.8.3"
+    rE: "15.9.0"
 };
 function isAudioEnabled(options) {
     return Boolean(options.audio.enabled);
@@ -6232,7 +6232,7 @@ class AudioRecorder {
         }
         let { bufferSize } = this.options.audio;
         if ("auto" === bufferSize) bufferSize = util_getBrowser(this.options).isFirefox() ? 512 : 2048;
-        if (!is_power_of_two(bufferSize)) throw error_createError({
+        if (void 0 === bufferSize || !is_power_of_two(bufferSize)) throw error_createError({
             message: `Audio buffer size must be a power of two. The current buffer size is ${bufferSize}.`,
             options: this.options
         });
@@ -6311,9 +6311,14 @@ function userMedia_define_property(obj, key, value) {
 const EVENT_ASCII = "|—O—|";
 class UserMedia extends util_Despot {
     attachMediaStream(stream) {
-        this.currentVisualStream = stream;
-        if (this.rawVisualUserMedia) this.rawVisualUserMedia.srcObject = stream;
-        else throw error_createError({
+        if (this.rawVisualUserMedia) {
+            this.rawVisualUserMedia.srcObject = stream;
+            const previousStream = this.currentVisualStream;
+            this.currentVisualStream = stream;
+            if (previousStream && previousStream !== stream) previousStream.getTracks().forEach((track)=>{
+                track.stop();
+            });
+        } else throw error_createError({
             message: "Error attaching stream to element.",
             explanation: "Contact the developer about this",
             options: this.options
@@ -6381,11 +6386,14 @@ class UserMedia extends util_Despot {
                         }
                     }).catch((exc)=>{
                         if (exc instanceof Error) this.options.logger.warn(`Caught pending user media promise exception: ${exc.toString()}`);
-                        else throw error_createError({
-                            message: "Failed to play user media upon play event.",
-                            exc,
-                            options: this.options
-                        });
+                        else {
+                            unloadAllEventListeners();
+                            endedEarlyCallback(error_createError({
+                                message: "Failed to play user media upon play event.",
+                                exc,
+                                options: this.options
+                            }));
+                        }
                     });
                 }
             } catch (exc) {
@@ -6396,18 +6404,18 @@ class UserMedia extends util_Despot {
         const fireCallbacks = ()=>{
             const readyState = this.rawVisualUserMedia?.readyState;
             this.options.logger.debug(`UserMedia: fireCallbacks(readyState=${readyState}, onPlayReached=${this.onPlayReached}, onLoadedMetaDataReached=${this.onLoadedMetaDataReached})`);
-            if (this.onPlayReached && this.onLoadedMetaDataReached) {
+            if (this.onPlayReached && this.onLoadedMetaDataReached) if (this.audioRecorder) try {
+                this.audioRecorder.init(localMediaStream);
+                this.on("SENDING_FIRST_FRAME", ()=>{
+                    this.audioRecord(audioCallback);
+                });
                 videoCallback();
-                if (this.audioRecorder) try {
-                    this.audioRecorder.init(localMediaStream);
-                    this.on("SENDING_FIRST_FRAME", ()=>{
-                        this.audioRecord(audioCallback);
-                    });
-                } catch (exc) {
-                    unloadAllEventListeners();
-                    endedEarlyCallback(exc);
-                }
+            } catch (exc) {
+                unloadAllEventListeners();
+                this.stop();
+                endedEarlyCallback(exc);
             }
+            else videoCallback();
         };
         const onPlay = ()=>{
             try {
@@ -6713,6 +6721,37 @@ class Recorder extends util_Despot {
         window.clearTimeout(this.connectionTimeout);
         this.connectionTimeout = void 0;
     }
+    clearReconnectTimeout() {
+        if (void 0 === this.reconnectTimeout) return;
+        this.options.logger.debug("Recorder: clearReconnectTimeout()");
+        window.clearTimeout(this.reconnectTimeout);
+        this.reconnectTimeout = void 0;
+    }
+    handleConnectionFailure(params) {
+        if (this.retryConnection(params)) return;
+        this.failConnection(params);
+    }
+    retryConnection(params) {
+        if (!this.reconnecting || !this.userMediaLoaded || !this.isOnline() || this.unloaded || this.blocking) return false;
+        if (void 0 !== this.reconnectTimeout) return true;
+        const delayMs = Math.min(500 * 2 ** this.reconnectAttempts, 10000);
+        this.reconnectAttempts++;
+        this.connecting = false;
+        this.clearConnectionTimeout();
+        this.discardSocket();
+        this.options.logger.debug(`Recorder: WebSocket reconnect failed (${params.cause}); retrying in ${delayMs}ms.`);
+        this.reconnectTimeout = window.setTimeout(()=>{
+            this.reconnectTimeout = void 0;
+            if (this.reconnecting && !this.unloaded && !this.blocking) this.initSocket();
+        }, delayMs);
+        return true;
+    }
+    discardSocket() {
+        this.options.logger.debug("Recorder: discarding socket stream ...");
+        const stream = this.stream;
+        this.stream = void 0;
+        if (stream && !stream.destroyed) stream.destroy();
+    }
     isOnline() {
         return navigator.onLine;
     }
@@ -6720,6 +6759,9 @@ class Recorder extends util_Despot {
         if (this.connectionFailed || this.connected || this.unloaded) return;
         this.connectionFailed = true;
         this.connecting = false;
+        this.reconnecting = false;
+        this.reconnectAttempts = 0;
+        this.clearReconnectTimeout();
         this.clearConnectionTimeout();
         const { url2Connect, cause } = params;
         const online = this.isOnline();
@@ -6754,10 +6796,7 @@ class Recorder extends util_Despot {
             explanation = `Connection to ${url2Connect} is closed${closeSuffix}. Please check your internet connection and try again. If the problem persists, contact us.`;
         }
         else explanation = "Your device appears to be offline. Please check your internet connection and try again.";
-        if (this.stream) {
-            this.stream.destroy();
-            this.stream = void 0;
-        }
+        this.discardSocket();
         const err = error_createError({
             message: "Unable to connect to the server",
             explanation,
@@ -6840,8 +6879,13 @@ class Recorder extends util_Despot {
         this.recordingStats.waitingTime = this.waitingTime;
     }
     initSocket(cb) {
-        if (this.connected) return void cb?.();
-        if (this.connecting) return;
+        if (this.connected) {
+            this.options.logger.debug("Recorder: already **connected**. Not going to initialize a new WebSocket connection.");
+            cb?.();
+            return;
+        }
+        if (this.connecting) return void this.options.logger.debug("Recorder: already **connecting**. Not going to initialize a new WebSocket connection.");
+        this.clearReconnectTimeout();
         if (util_isAutomatedUserAgent()) {
             this.connecting = false;
             this.options.logger.debug("Recorder: skipping web socket connection for an automated crawler");
@@ -6920,8 +6964,12 @@ class Recorder extends util_Despot {
             this.connectionTimeout = window.setTimeout(()=>{
                 if (this.isOnline() && this.isUserMediaLoaded()) {
                     this.options.logger.debug(`${PIPE_SYMBOL}Reconnecting due to connection timeout.`);
-                    this.initSocket();
-                } else this.failConnection({
+                    this.reconnecting = true;
+                    this.handleConnectionFailure({
+                        url2Connect,
+                        cause: "timeout"
+                    });
+                } else this.handleConnectionFailure({
                     url2Connect,
                     cause: "timeout"
                 });
@@ -6936,9 +6984,11 @@ class Recorder extends util_Despot {
                 this.options.logger.debug(debugLine);
                 const tryReconnect = this.connected && this.userMediaLoaded;
                 this.connected = false;
-                if (tryReconnect) this.initSocket();
-                else if (!this.connecting && !this.blocking) window.setTimeout(()=>{
-                    this.failConnection({
+                if (tryReconnect) {
+                    this.reconnecting = true;
+                    this.initSocket();
+                } else if (!this.connecting && !this.blocking) window.setTimeout(()=>{
+                    this.handleConnectionFailure({
                         url2Connect,
                         cause: "closed"
                     });
@@ -6951,6 +7001,9 @@ class Recorder extends util_Despot {
                 if (!this.connected && !isClosing && !this.unloaded) {
                     this.connected = true;
                     this.connecting = this.unloaded = false;
+                    this.reconnecting = false;
+                    this.reconnectAttempts = 0;
+                    this.clearReconnectTimeout();
                     this.emit("CONNECTED");
                     cb?.();
                 }
@@ -6980,7 +7033,7 @@ class Recorder extends util_Despot {
                     error: serializeError(err)
                 });
                 this.options.logger.debug(debugLine);
-                if (!this.connected) return void this.failConnection({
+                if (!this.connected) return void this.handleConnectionFailure({
                     url2Connect,
                     cause: "error"
                 });
@@ -7040,6 +7093,7 @@ class Recorder extends util_Despot {
         return this.blocking;
     }
     userMediaErrorCallback(err, usedConstraints) {
+        if (this.unloaded) return void this.options.logger.debug(`Recorder: already unloaded. Not going to throw error ${util_pretty(err)}`);
         this.userMediaLoading = false;
         this.clearUserMediaTimeout();
         const characteristics = this.userMedia?.getCharacteristics();
@@ -7058,10 +7112,9 @@ class Recorder extends util_Despot {
             this.options.logger.debug(`Recorder: ignore user media error ${util_pretty(err)}`);
             this.retryTimeout = window.setTimeout(()=>{
                 this.retryTimeout = void 0;
-                this.loadUserMedia();
+                if (!this.unloaded) this.loadUserMedia();
             }, this.options.timeouts.userMedia);
         }
-        else if (this.unloaded) this.options.logger.debug(`Recorder: already unloaded. Not going to throw error ${util_pretty(err)}`);
         else {
             this.options.logger.debug(`Recorder: no error listeners attached but throwing error ${util_pretty(err)}`);
             throw error_createError({
@@ -7072,26 +7125,46 @@ class Recorder extends util_Despot {
         }
     }
     getUserMediaCallback(localStream, params) {
-        if (!this.userMedia) throw new Error("No user media is defined");
+        if (!this.userMedia) {
+            localStream.getTracks().forEach((track)=>{
+                track.stop();
+            });
+            throw error_createError({
+                message: "No user media is defined",
+                options: this.options
+            });
+        }
         this.options.logger.debug(`Recorder: getUserMediaCallback(${params ? util_pretty(params) : ""})`);
         if (this.showUserMedia()) try {
-            this.clearUserMediaTimeout();
             this.userMedia.init(localStream, ()=>{
-                this.onUserMediaReady(params);
+                if (!this.unloaded) this.onUserMediaReady(params);
             }, this.onAudioSample.bind(this), (err)=>{
-                this.emit("ERROR", {
-                    err
+                if (!this.unloaded) this.userMediaErrorCallback(err, {
+                    audio: isAudioEnabled(this.options)
                 });
             }, params?.switchingFacingMode);
         } catch (exc) {
+            localStream.getTracks().forEach((track)=>{
+                track.stop();
+            });
+            this.userMediaLoading = false;
+            this.clearUserMediaTimeout();
             this.emit("ERROR", {
                 exc
             });
         }
+        else {
+            localStream.getTracks().forEach((track)=>{
+                track.stop();
+            });
+            this.userMediaLoading = false;
+            this.clearUserMediaTimeout();
+        }
     }
     loadGenuineUserMedia(params) {
         this.options.logger.debug(`Recorder: loadGenuineUserMedia(${params ? util_pretty(params) : ""})`);
         this.emit("ASKING_WEBCAM_PERMISSION");
+        this.userMediaLoading = true;
         const constraints = {
             video: {
                 frameRate: {
@@ -7122,9 +7195,12 @@ class Recorder extends util_Despot {
         this.options.logger.debug(util_summarize("Recorder: available webcam constraints are:", navigator.mediaDevices.getSupportedConstraints()));
         const streamPromise = navigator.mediaDevices.getUserMedia(constraints);
         streamPromise.then((localStream)=>{
+            if (this.unloaded) return void localStream.getTracks().forEach((track)=>{
+                track.stop();
+            });
             this.getUserMediaCallback(localStream, params);
         }).catch((reason)=>{
-            this.userMediaErrorCallback(reason, constraints);
+            if (!this.unloaded) this.userMediaErrorCallback(reason, constraints);
         });
     }
     loadUserMedia(params) {
@@ -7138,7 +7214,8 @@ class Recorder extends util_Despot {
         try {
             if (!navigator.mediaDevices) throw new Error("No media devices are available.");
             this.userMediaTimeout = window.setTimeout(()=>{
-                if (!this.isReady()) {
+                if (!this.userMediaLoaded) {
+                    this.userMediaLoading = false;
                     const err = util_getBrowser(this.options).getNoAccessIssue();
                     this.emit("ERROR", {
                         err
@@ -7237,16 +7314,16 @@ class Recorder extends util_Despot {
                     command,
                     args
                 };
-                this.writeStream(Buffer.from(JSON.stringify(commandObj)));
-                if (cb) setTimeout(function() {
-                    cb();
-                }, 0);
+                this.writeStream(Buffer.from(JSON.stringify(commandObj)), cb ? {
+                    onFlushedCallback: ()=>{
+                        queueMicrotask(cb);
+                    }
+                } : void 0);
             }
         } else {
             this.options.logger.debug(`Reconnecting for the command ${command} …`);
             this.initSocket(()=>{
-                this.writeCommand(command, args);
-                cb?.();
+                this.writeCommand(command, args, cb);
             });
         }
     }
@@ -7317,6 +7394,7 @@ class Recorder extends util_Despot {
     reInitializeAudio() {
         this.options.logger.debug("Recorder: reInitializeAudio()");
         this.clearUserMediaTimeout();
+        this.userMediaLoading = false;
         this.userMedia?.stop();
         this.userMediaLoaded = this.key = this.canvas = this.ctx = void 0;
         this.loadUserMedia();
@@ -7331,17 +7409,17 @@ class Recorder extends util_Despot {
         this.reset();
         this.clearUserMediaTimeout();
         this.clearConnectionTimeout();
+        this.clearReconnectTimeout();
         this.clearRetryTimeout();
         this.clearStopTimeout();
         this.stopPings();
+        this.userMediaLoading = false;
         this.connecting = false;
+        this.reconnecting = false;
+        this.reconnectAttempts = 0;
         if (this.userMedia) this.userMedia.unloadRemainingEventListeners();
         if (this.submitting) ;
-        else if (this.stream) {
-            this.options.logger.debug("Recorder: destroying stream ...");
-            this.stream.destroy();
-            this.stream = void 0;
-        }
+        else if (this.stream) this.discardSocket();
         this.unloaded = true;
         this.built = this.connecting = this.connected = false;
     }
@@ -7441,7 +7519,13 @@ class Recorder extends util_Despot {
         if (!this.connected) {
             this.options.logger.debug("Recorder: reconnecting before recording …");
             this.initSocket(()=>{
-                this.once("USER_MEDIA_READY", this.record.bind(this));
+                this.once("SERVER_READY", ()=>{
+                    if (this.unloaded) return;
+                    if (this.userMediaLoaded || this.options.loadUserMediaOnRecord) this.record();
+                    else this.once("USER_MEDIA_READY", ()=>{
+                        if (!this.unloaded) this.record();
+                    });
+                });
             });
             return;
         }
@@ -7742,7 +7826,7 @@ class Recorder extends util_Despot {
         return this.userMediaLoaded;
     }
     constructor(visuals, replay, options){
-        super("Recorder", options), recorder_define_property(this, "visuals", void 0), recorder_define_property(this, "replay", void 0), recorder_define_property(this, "loop", void 0), recorder_define_property(this, "originalAnimationFrameObject", void 0), recorder_define_property(this, "samplesCount", 0), recorder_define_property(this, "framesCount", 0), recorder_define_property(this, "recordingStats", void 0), recorder_define_property(this, "confirmedFrameNumber", 0), recorder_define_property(this, "confirmedSampleNumber", 0), recorder_define_property(this, "recorderElement", void 0), recorder_define_property(this, "userMedia", void 0), recorder_define_property(this, "userMediaTimeout", void 0), recorder_define_property(this, "retryTimeout", void 0), recorder_define_property(this, "connectionTimeout", void 0), recorder_define_property(this, "stopTimeout", void 0), recorder_define_property(this, "frameProgress", void 0), recorder_define_property(this, "sampleProgress", void 0), recorder_define_property(this, "canvas", void 0), recorder_define_property(this, "ctx", void 0), recorder_define_property(this, "userMediaLoaded", void 0), recorder_define_property(this, "userMediaLoading", false), recorder_define_property(this, "submitting", false), recorder_define_property(this, "unloaded", void 0), recorder_define_property(this, "stopTime", void 0), recorder_define_property(this, "stream", void 0), recorder_define_property(this, "connecting", false), recorder_define_property(this, "connected", false), recorder_define_property(this, "connectionFailed", false), recorder_define_property(this, "blocking", false), recorder_define_property(this, "built", false), recorder_define_property(this, "key", void 0), recorder_define_property(this, "waitingTime", void 0), recorder_define_property(this, "connectingStartedAt", void 0), recorder_define_property(this, "lastCloseEvent", void 0), recorder_define_property(this, "lastSocketError", void 0), recorder_define_property(this, "pingInterval", void 0), recorder_define_property(this, "frame", void 0), recorder_define_property(this, "recordingBuffer", void 0), recorder_define_property(this, "facingMode", void 0);
+        super("Recorder", options), recorder_define_property(this, "visuals", void 0), recorder_define_property(this, "replay", void 0), recorder_define_property(this, "loop", void 0), recorder_define_property(this, "originalAnimationFrameObject", void 0), recorder_define_property(this, "samplesCount", 0), recorder_define_property(this, "framesCount", 0), recorder_define_property(this, "recordingStats", void 0), recorder_define_property(this, "confirmedFrameNumber", 0), recorder_define_property(this, "confirmedSampleNumber", 0), recorder_define_property(this, "recorderElement", void 0), recorder_define_property(this, "userMedia", void 0), recorder_define_property(this, "userMediaTimeout", void 0), recorder_define_property(this, "retryTimeout", void 0), recorder_define_property(this, "reconnectTimeout", void 0), recorder_define_property(this, "connectionTimeout", void 0), recorder_define_property(this, "stopTimeout", void 0), recorder_define_property(this, "frameProgress", void 0), recorder_define_property(this, "sampleProgress", void 0), recorder_define_property(this, "canvas", void 0), recorder_define_property(this, "ctx", void 0), recorder_define_property(this, "userMediaLoaded", void 0), recorder_define_property(this, "userMediaLoading", false), recorder_define_property(this, "submitting", false), recorder_define_property(this, "unloaded", void 0), recorder_define_property(this, "stopTime", void 0), recorder_define_property(this, "stream", void 0), recorder_define_property(this, "connecting", false), recorder_define_property(this, "connected", false), recorder_define_property(this, "connectionFailed", false), recorder_define_property(this, "reconnecting", false), recorder_define_property(this, "reconnectAttempts", 0), recorder_define_property(this, "blocking", false), recorder_define_property(this, "built", false), recorder_define_property(this, "key", void 0), recorder_define_property(this, "waitingTime", void 0), recorder_define_property(this, "connectingStartedAt", void 0), recorder_define_property(this, "lastCloseEvent", void 0), recorder_define_property(this, "lastSocketError", void 0), recorder_define_property(this, "pingInterval", void 0), recorder_define_property(this, "frame", void 0), recorder_define_property(this, "recordingBuffer", void 0), recorder_define_property(this, "facingMode", void 0);
         this.visuals = visuals;
         this.replay = replay;
         this.facingMode = options.video.facingMode;

package/dist/esm/wrappers/visuals/recorder.d.ts

@@ -25,6 +25,7 @@ declare class Recorder extends Despot {
     private userMedia?;
     private userMediaTimeout?;
     private retryTimeout?;
+    private reconnectTimeout?;
     private connectionTimeout?;
     private stopTimeout?;
     private frameProgress?;
@@ -40,6 +41,8 @@ declare class Recorder extends Despot {
     private connecting;
     private connected;
     private connectionFailed;
+    private reconnecting;
+    private reconnectAttempts;
     private blocking;
     private built;
     private key?;
@@ -60,6 +63,10 @@ declare class Recorder extends Despot {
     private onUserMediaReady;
     private clearRetryTimeout;
     private clearConnectionTimeout;
+    private clearReconnectTimeout;
+    private handleConnectionFailure;
+    private retryConnection;
+    private discardSocket;
     private isOnline;
     private failConnection;
     private calculateFrameProgress;

package/dist/umd/index.js

@@ -10978,7 +10978,7 @@
             var client = __webpack_require__("Q");
             var client_default = /*#__PURE__*/ __webpack_require__.n(client);
             var package_namespaceObject = {
-                rE: "15.8.3"
+                rE: "15.9.0"
             };
             function isAudioEnabled(options) {
                 return Boolean(options.audio.enabled);
@@ -18953,7 +18953,7 @@
                     }
                     let { bufferSize } = this.options.audio;
                     if ("auto" === bufferSize) bufferSize = util_getBrowser(this.options).isFirefox() ? 512 : 2048;
-                    if (!is_power_of_two_default()(bufferSize)) throw error_createError({
+                    if (void 0 === bufferSize || !is_power_of_two_default()(bufferSize)) throw error_createError({
                         message: `Audio buffer size must be a power of two. The current buffer size is ${bufferSize}.`,
                         options: this.options
                     });
@@ -19040,9 +19040,14 @@
                     });
                 }
                 attachMediaStream(stream) {
-                    this.currentVisualStream = stream;
-                    if (this.rawVisualUserMedia) this.rawVisualUserMedia.srcObject = stream;
-                    else throw error_createError({
+                    if (this.rawVisualUserMedia) {
+                        this.rawVisualUserMedia.srcObject = stream;
+                        const previousStream = this.currentVisualStream;
+                        this.currentVisualStream = stream;
+                        if (previousStream && previousStream !== stream) previousStream.getTracks().forEach((track)=>{
+                            track.stop();
+                        });
+                    } else throw error_createError({
                         message: "Error attaching stream to element.",
                         explanation: "Contact the developer about this",
                         options: this.options
@@ -19110,11 +19115,14 @@
                                     }
                                 }).catch((exc)=>{
                                     if (exc instanceof Error) this.options.logger.warn(`Caught pending user media promise exception: ${exc.toString()}`);
-                                    else throw error_createError({
-                                        message: "Failed to play user media upon play event.",
-                                        exc,
-                                        options: this.options
-                                    });
+                                    else {
+                                        unloadAllEventListeners();
+                                        endedEarlyCallback(error_createError({
+                                            message: "Failed to play user media upon play event.",
+                                            exc,
+                                            options: this.options
+                                        }));
+                                    }
                                 });
                             }
                         } catch (exc) {
@@ -19125,18 +19133,18 @@
                     const fireCallbacks = ()=>{
                         const readyState = this.rawVisualUserMedia?.readyState;
                         this.options.logger.debug(`UserMedia: fireCallbacks(readyState=${readyState}, onPlayReached=${this.onPlayReached}, onLoadedMetaDataReached=${this.onLoadedMetaDataReached})`);
-                        if (this.onPlayReached && this.onLoadedMetaDataReached) {
+                        if (this.onPlayReached && this.onLoadedMetaDataReached) if (this.audioRecorder) try {
+                            this.audioRecorder.init(localMediaStream);
+                            this.on("SENDING_FIRST_FRAME", ()=>{
+                                this.audioRecord(audioCallback);
+                            });
                             videoCallback();
-                            if (this.audioRecorder) try {
-                                this.audioRecorder.init(localMediaStream);
-                                this.on("SENDING_FIRST_FRAME", ()=>{
-                                    this.audioRecord(audioCallback);
-                                });
-                            } catch (exc) {
-                                unloadAllEventListeners();
-                                endedEarlyCallback(exc);
-                            }
+                        } catch (exc) {
+                            unloadAllEventListeners();
+                            this.stop();
+                            endedEarlyCallback(exc);
                         }
+                        else videoCallback();
                     };
                     const onPlay = ()=>{
                         try {
@@ -19334,6 +19342,7 @@
                 userMedia;
                 userMediaTimeout;
                 retryTimeout;
+                reconnectTimeout;
                 connectionTimeout;
                 stopTimeout;
                 frameProgress;
@@ -19349,6 +19358,8 @@
                 connecting = false;
                 connected = false;
                 connectionFailed = false;
+                reconnecting = false;
+                reconnectAttempts = 0;
                 blocking = false;
                 built = false;
                 key;
@@ -19462,6 +19473,37 @@
                     window.clearTimeout(this.connectionTimeout);
                     this.connectionTimeout = void 0;
                 }
+                clearReconnectTimeout() {
+                    if (void 0 === this.reconnectTimeout) return;
+                    this.options.logger.debug("Recorder: clearReconnectTimeout()");
+                    window.clearTimeout(this.reconnectTimeout);
+                    this.reconnectTimeout = void 0;
+                }
+                handleConnectionFailure(params) {
+                    if (this.retryConnection(params)) return;
+                    this.failConnection(params);
+                }
+                retryConnection(params) {
+                    if (!this.reconnecting || !this.userMediaLoaded || !this.isOnline() || this.unloaded || this.blocking) return false;
+                    if (void 0 !== this.reconnectTimeout) return true;
+                    const delayMs = Math.min(500 * 2 ** this.reconnectAttempts, 10000);
+                    this.reconnectAttempts++;
+                    this.connecting = false;
+                    this.clearConnectionTimeout();
+                    this.discardSocket();
+                    this.options.logger.debug(`Recorder: WebSocket reconnect failed (${params.cause}); retrying in ${delayMs}ms.`);
+                    this.reconnectTimeout = window.setTimeout(()=>{
+                        this.reconnectTimeout = void 0;
+                        if (this.reconnecting && !this.unloaded && !this.blocking) this.initSocket();
+                    }, delayMs);
+                    return true;
+                }
+                discardSocket() {
+                    this.options.logger.debug("Recorder: discarding socket stream ...");
+                    const stream = this.stream;
+                    this.stream = void 0;
+                    if (stream && !stream.destroyed) stream.destroy();
+                }
                 isOnline() {
                     return navigator.onLine;
                 }
@@ -19469,6 +19511,9 @@
                     if (this.connectionFailed || this.connected || this.unloaded) return;
                     this.connectionFailed = true;
                     this.connecting = false;
+                    this.reconnecting = false;
+                    this.reconnectAttempts = 0;
+                    this.clearReconnectTimeout();
                     this.clearConnectionTimeout();
                     const { url2Connect, cause } = params;
                     const online = this.isOnline();
@@ -19503,10 +19548,7 @@
                         explanation = `Connection to ${url2Connect} is closed${closeSuffix}. Please check your internet connection and try again. If the problem persists, contact us.`;
                     }
                     else explanation = "Your device appears to be offline. Please check your internet connection and try again.";
-                    if (this.stream) {
-                        this.stream.destroy();
-                        this.stream = void 0;
-                    }
+                    this.discardSocket();
                     const err = error_createError({
                         message: "Unable to connect to the server",
                         explanation,
@@ -19589,8 +19631,13 @@
                     this.recordingStats.waitingTime = this.waitingTime;
                 }
                 initSocket(cb) {
-                    if (this.connected) return void cb?.();
-                    if (this.connecting) return;
+                    if (this.connected) {
+                        this.options.logger.debug("Recorder: already **connected**. Not going to initialize a new WebSocket connection.");
+                        cb?.();
+                        return;
+                    }
+                    if (this.connecting) return void this.options.logger.debug("Recorder: already **connecting**. Not going to initialize a new WebSocket connection.");
+                    this.clearReconnectTimeout();
                     if (util_isAutomatedUserAgent()) {
                         this.connecting = false;
                         this.options.logger.debug("Recorder: skipping web socket connection for an automated crawler");
@@ -19669,8 +19716,12 @@
                         this.connectionTimeout = window.setTimeout(()=>{
                             if (this.isOnline() && this.isUserMediaLoaded()) {
                                 this.options.logger.debug(`${PIPE_SYMBOL}Reconnecting due to connection timeout.`);
-                                this.initSocket();
-                            } else this.failConnection({
+                                this.reconnecting = true;
+                                this.handleConnectionFailure({
+                                    url2Connect,
+                                    cause: "timeout"
+                                });
+                            } else this.handleConnectionFailure({
                                 url2Connect,
                                 cause: "timeout"
                             });
@@ -19685,9 +19736,11 @@
                             this.options.logger.debug(debugLine);
                             const tryReconnect = this.connected && this.userMediaLoaded;
                             this.connected = false;
-                            if (tryReconnect) this.initSocket();
-                            else if (!this.connecting && !this.blocking) window.setTimeout(()=>{
-                                this.failConnection({
+                            if (tryReconnect) {
+                                this.reconnecting = true;
+                                this.initSocket();
+                            } else if (!this.connecting && !this.blocking) window.setTimeout(()=>{
+                                this.handleConnectionFailure({
                                     url2Connect,
                                     cause: "closed"
                                 });
@@ -19700,6 +19753,9 @@
                             if (!this.connected && !isClosing && !this.unloaded) {
                                 this.connected = true;
                                 this.connecting = this.unloaded = false;
+                                this.reconnecting = false;
+                                this.reconnectAttempts = 0;
+                                this.clearReconnectTimeout();
                                 this.emit("CONNECTED");
                                 cb?.();
                             }
@@ -19729,7 +19785,7 @@
                                 error: serializeError(err)
                             });
                             this.options.logger.debug(debugLine);
-                            if (!this.connected) return void this.failConnection({
+                            if (!this.connected) return void this.handleConnectionFailure({
                                 url2Connect,
                                 cause: "error"
                             });
@@ -19789,6 +19845,7 @@
                     return this.blocking;
                 }
                 userMediaErrorCallback(err, usedConstraints) {
+                    if (this.unloaded) return void this.options.logger.debug(`Recorder: already unloaded. Not going to throw error ${util_pretty(err)}`);
                     this.userMediaLoading = false;
                     this.clearUserMediaTimeout();
                     const characteristics = this.userMedia?.getCharacteristics();
@@ -19807,10 +19864,9 @@
                         this.options.logger.debug(`Recorder: ignore user media error ${util_pretty(err)}`);
                         this.retryTimeout = window.setTimeout(()=>{
                             this.retryTimeout = void 0;
-                            this.loadUserMedia();
+                            if (!this.unloaded) this.loadUserMedia();
                         }, this.options.timeouts.userMedia);
                     }
-                    else if (this.unloaded) this.options.logger.debug(`Recorder: already unloaded. Not going to throw error ${util_pretty(err)}`);
                     else {
                         this.options.logger.debug(`Recorder: no error listeners attached but throwing error ${util_pretty(err)}`);
                         throw error_createError({
@@ -19821,26 +19877,46 @@
                     }
                 }
                 getUserMediaCallback(localStream, params) {
-                    if (!this.userMedia) throw new Error("No user media is defined");
+                    if (!this.userMedia) {
+                        localStream.getTracks().forEach((track)=>{
+                            track.stop();
+                        });
+                        throw error_createError({
+                            message: "No user media is defined",
+                            options: this.options
+                        });
+                    }
                     this.options.logger.debug(`Recorder: getUserMediaCallback(${params ? util_pretty(params) : ""})`);
                     if (this.showUserMedia()) try {
-                        this.clearUserMediaTimeout();
                         this.userMedia.init(localStream, ()=>{
-                            this.onUserMediaReady(params);
+                            if (!this.unloaded) this.onUserMediaReady(params);
                         }, this.onAudioSample.bind(this), (err)=>{
-                            this.emit("ERROR", {
-                                err
+                            if (!this.unloaded) this.userMediaErrorCallback(err, {
+                                audio: isAudioEnabled(this.options)
                             });
                         }, params?.switchingFacingMode);
                     } catch (exc) {
+                        localStream.getTracks().forEach((track)=>{
+                            track.stop();
+                        });
+                        this.userMediaLoading = false;
+                        this.clearUserMediaTimeout();
                         this.emit("ERROR", {
                             exc
                         });
                     }
+                    else {
+                        localStream.getTracks().forEach((track)=>{
+                            track.stop();
+                        });
+                        this.userMediaLoading = false;
+                        this.clearUserMediaTimeout();
+                    }
                 }
                 loadGenuineUserMedia(params) {
                     this.options.logger.debug(`Recorder: loadGenuineUserMedia(${params ? util_pretty(params) : ""})`);
                     this.emit("ASKING_WEBCAM_PERMISSION");
+                    this.userMediaLoading = true;
                     const constraints = {
                         video: {
                             frameRate: {
@@ -19871,9 +19947,12 @@
                     this.options.logger.debug(util_summarize("Recorder: available webcam constraints are:", navigator.mediaDevices.getSupportedConstraints()));
                     const streamPromise = navigator.mediaDevices.getUserMedia(constraints);
                     streamPromise.then((localStream)=>{
+                        if (this.unloaded) return void localStream.getTracks().forEach((track)=>{
+                            track.stop();
+                        });
                         this.getUserMediaCallback(localStream, params);
                     }).catch((reason)=>{
-                        this.userMediaErrorCallback(reason, constraints);
+                        if (!this.unloaded) this.userMediaErrorCallback(reason, constraints);
                     });
                 }
                 loadUserMedia(params) {
@@ -19887,7 +19966,8 @@
                     try {
                         if (!navigator.mediaDevices) throw new Error("No media devices are available.");
                         this.userMediaTimeout = window.setTimeout(()=>{
-                            if (!this.isReady()) {
+                            if (!this.userMediaLoaded) {
+                                this.userMediaLoading = false;
                                 const err = util_getBrowser(this.options).getNoAccessIssue();
                                 this.emit("ERROR", {
                                     err
@@ -19986,16 +20066,16 @@
                                 command,
                                 args
                             };
-                            this.writeStream(Buffer.from(JSON.stringify(commandObj)));
-                            if (cb) setTimeout(function() {
-                                cb();
-                            }, 0);
+                            this.writeStream(Buffer.from(JSON.stringify(commandObj)), cb ? {
+                                onFlushedCallback: ()=>{
+                                    queueMicrotask(cb);
+                                }
+                            } : void 0);
                         }
                     } else {
                         this.options.logger.debug(`Reconnecting for the command ${command} …`);
                         this.initSocket(()=>{
-                            this.writeCommand(command, args);
-                            cb?.();
+                            this.writeCommand(command, args, cb);
                         });
                     }
                 }
@@ -20066,6 +20146,7 @@
                 reInitializeAudio() {
                     this.options.logger.debug("Recorder: reInitializeAudio()");
                     this.clearUserMediaTimeout();
+                    this.userMediaLoading = false;
                     this.userMedia?.stop();
                     this.userMediaLoaded = this.key = this.canvas = this.ctx = void 0;
                     this.loadUserMedia();
@@ -20080,17 +20161,17 @@
                     this.reset();
                     this.clearUserMediaTimeout();
                     this.clearConnectionTimeout();
+                    this.clearReconnectTimeout();
                     this.clearRetryTimeout();
                     this.clearStopTimeout();
                     this.stopPings();
+                    this.userMediaLoading = false;
                     this.connecting = false;
+                    this.reconnecting = false;
+                    this.reconnectAttempts = 0;
                     if (this.userMedia) this.userMedia.unloadRemainingEventListeners();
                     if (this.submitting) ;
-                    else if (this.stream) {
-                        this.options.logger.debug("Recorder: destroying stream ...");
-                        this.stream.destroy();
-                        this.stream = void 0;
-                    }
+                    else if (this.stream) this.discardSocket();
                     this.unloaded = true;
                     this.built = this.connecting = this.connected = false;
                 }
@@ -20190,7 +20271,13 @@
                     if (!this.connected) {
                         this.options.logger.debug("Recorder: reconnecting before recording …");
                         this.initSocket(()=>{
-                            this.once("USER_MEDIA_READY", this.record.bind(this));
+                            this.once("SERVER_READY", ()=>{
+                                if (this.unloaded) return;
+                                if (this.userMediaLoaded || this.options.loadUserMediaOnRecord) this.record();
+                                else this.once("USER_MEDIA_READY", ()=>{
+                                    if (!this.unloaded) this.record();
+                                });
+                            });
                         });
                         return;
                     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "videomail-client",
-  "version": "15.8.3",
+  "version": "15.9.0",
   "description": "A wicked npm package to record videos directly in the browser, for Deaf and Sign Language!",
   "keywords": [
     "webcam",
@@ -101,7 +101,7 @@
     "@types/ua-parser-js": "0.7.39",
     "@vitest/eslint-plugin": "1.6.27",
     "audit-ci": "7.1.0",
-    "chromatic": "18.10.2",
+    "chromatic": "18.11.0",
     "cross-env": "10.1.0",
     "eslint": "10.12.0",
     "eslint-import-resolver-typescript": "4.4.5",
@@ -112,7 +112,7 @@
     "eslint-plugin-regexp": "3.3.1",
     "eslint-plugin-simple-import-sort": "14.0.0",
     "globals": "17.13.0",
-    "jsdom": "30.1.1",
+    "jsdom": "30.1.2",
     "msw": "2.15.0",
     "msw-storybook-addon": "3.0.3",
     "prettier": "3.9.9",
@@ -125,7 +125,7 @@
     "storybook-html-rsbuild": "3.6.0",
     "type-fest": "5.10.0",
     "typescript": "6.0.3",
-    "typescript-eslint": "8.71.0",
+    "typescript-eslint": "8.71.1",
     "vitest": "5.0.3"
   },
   "engines": {