videomail-client 16.0.2 → 16.1.0

package/dist/cjs/index.cjs

@@ -11115,7 +11115,7 @@ var __webpack_exports__ = {};
     var client = __webpack_require__("Q");
     var client_default = /*#__PURE__*/ __webpack_require__.n(client);
     var package_namespaceObject = {
-        rE: "16.0.2"
+        rE: "16.1.0"
     };
     function isAudioEnabled(options) {
         return Boolean(options.audio.enabled);
@@ -15271,13 +15271,35 @@ var __webpack_exports__ = {};
                 if ((null == type ? void 0 : type.toLowerCase()) === "hidden") inputElement.value = "";
             }
         }
-        startListeningToSubmitEvents() {
+        connectSubmitButton() {
             const submitButton = this.container.getSubmitButton();
-            if (submitButton) submitButton.onclick = this.doTheSubmit.bind(this);
+            if (!submitButton) return;
+            if (submitButton.form === this.formElement) return;
+            if (!this.formElement.id) {
+                let formId;
+                do formId = `videomail-form-${Form.nextFormId++}`;
+                while (document.getElementById(formId))
+                this.formElement.id = formId;
+                this.generatedFormId = formId;
+            }
+            this.submitButton = submitButton;
+            this.submitButtonFormAttribute = submitButton.getAttribute("form");
+            submitButton.setAttribute("form", this.formElement.id);
+        }
+        startListeningToSubmitEvents() {
+            this.connectSubmitButton();
+            this.formElement.addEventListener("submit", this.handleSubmit);
         }
         stopListeningToSubmitEvents() {
-            const submitButton = this.container.getSubmitButton();
-            if (submitButton) submitButton.onclick = null;
+            this.formElement.removeEventListener("submit", this.handleSubmit);
+            if (this.submitButton) {
+                if (null === this.submitButtonFormAttribute) this.submitButton.removeAttribute("form");
+                else this.submitButton.setAttribute("form", this.submitButtonFormAttribute);
+                this.submitButton = void 0;
+                this.submitButtonFormAttribute = null;
+            }
+            if (this.generatedFormId === this.formElement.id) this.formElement.removeAttribute("id");
+            this.generatedFormId = void 0;
         }
         doTheSubmit(e) {
             return _async_to_generator(function*() {
@@ -15286,6 +15308,7 @@ var __webpack_exports__ = {};
                     this.options.logger.debug(`Form: doTheSubmit(${string_pretty(e)})`);
                     e.preventDefault();
                 } else this.options.logger.debug("Form: doTheSubmit()");
+                if (this.isSubmitting) return false;
                 const hasHostAction = this.formElement.hasAttribute("action");
                 const url = null != (_this_formElement_getAttribute = this.formElement.getAttribute("action")) ? _this_formElement_getAttribute : this.options.apiUrl;
                 const method = this.formElement.getAttribute("method");
@@ -15300,7 +15323,14 @@ var __webpack_exports__ = {};
                     default:
                         chosenMethod = FormMethod.POST;
                 }
-                if (this.container.hasElement()) yield this.container.submitAll(this.getData(), chosenMethod, url, hasHostAction);
+                if (this.container.hasElement()) {
+                    this.isSubmitting = true;
+                    try {
+                        yield this.container.submitAll(this.getData(), chosenMethod, url, hasHostAction);
+                    } finally{
+                        this.isSubmitting = false;
+                    }
+                }
                 return false;
             }).call(this);
         }
@@ -15322,9 +15352,11 @@ var __webpack_exports__ = {};
             html_showElement(this.formElement);
         }
         constructor(container, formElement, options){
-            super("Form", options), form_define_property(this, "container", void 0), form_define_property(this, "formElement", void 0), form_define_property(this, "validate", (event)=>{
+            super("Form", options), form_define_property(this, "container", void 0), form_define_property(this, "formElement", void 0), form_define_property(this, "keyInput", void 0), form_define_property(this, "submitButton", void 0), form_define_property(this, "submitButtonFormAttribute", null), form_define_property(this, "generatedFormId", void 0), form_define_property(this, "isSubmitting", false), form_define_property(this, "FORM_FIELDS", {}), form_define_property(this, "validate", (event)=>{
                 this.container.validate(event);
-            }), form_define_property(this, "keyInput", void 0), form_define_property(this, "FORM_FIELDS", {});
+            }), form_define_property(this, "handleSubmit", (event)=>{
+                if (!event.defaultPrevented) this.doTheSubmit(event);
+            });
             this.container = container;
             this.formElement = formElement;
             this.FORM_FIELDS = {
@@ -15340,6 +15372,7 @@ var __webpack_exports__ = {};
             };
         }
     }
+    form_define_property(Form, "nextFormId", 0);
     const wrappers_form = Form;
     function resource_asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
         try {
@@ -18025,7 +18058,7 @@ var __webpack_exports__ = {};
             html_disableElement(radioButtonElement);
             return radioButtonElement;
         }
-        makeButton(buttonClass, text, clickHandler, show, id, type, selector, disabled = true) {
+        makeButton(buttonClass, text, clickHandler, show, id, type = "button", selector, disabled = true) {
             let buttonElement;
             if (id) buttonElement = document.querySelector(`#${id}`);
             else if (selector) buttonElement = document.querySelector(selector);
@@ -18811,10 +18844,15 @@ var __webpack_exports__ = {};
                 var _this_facingMode;
                 null == (_this_facingMode = this.facingMode) || _this_facingMode.show();
             });
+            this.on("CAMERA_RECOVERING", ()=>{
+                var _this_facingMode;
+                null == (_this_facingMode = this.facingMode) || _this_facingMode.hide();
+            });
             this.on("RECORDING", ()=>{
                 this.startRecording();
             });
             this.on("RESUMING", ()=>{
+                this.hidePause();
                 this.resumeRecording();
             });
             this.on("STOPPING", ()=>{
@@ -19458,6 +19496,32 @@ var __webpack_exports__ = {};
     const esm = esm_src;
     var is_power_of_two = __webpack_require__("dZ");
     var is_power_of_two_default = /*#__PURE__*/ __webpack_require__.n(is_power_of_two);
+    function AudioRecorder_asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+        try {
+            var info = gen[key](arg);
+            var value = info.value;
+        } catch (error) {
+            reject(error);
+            return;
+        }
+        if (info.done) resolve(value);
+        else Promise.resolve(value).then(_next, _throw);
+    }
+    function AudioRecorder_async_to_generator(fn) {
+        return function() {
+            var self1 = this, args = arguments;
+            return new Promise(function(resolve, reject) {
+                var gen = fn.apply(self1, args);
+                function _next(value) {
+                    AudioRecorder_asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+                }
+                function _throw(err) {
+                    AudioRecorder_asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+                }
+                _next(void 0);
+            });
+        };
+    }
     function AudioRecorder_define_property(obj, key, value) {
         if (key in obj) Object.defineProperty(obj, key, {
             value: value,
@@ -19488,9 +19552,20 @@ var __webpack_exports__ = {};
             const float32Array = e.inputBuffer.getChannelData(0);
             cb(new esm(float32Array));
         }
+        disconnect() {
+            var _this_audioInput, _this_volume;
+            if (this.scriptProcessor) {
+                this.scriptProcessor.onaudioprocess = null;
+                this.scriptProcessor.disconnect();
+            }
+            null == (_this_audioInput = this.audioInput) || _this_audioInput.disconnect();
+            null == (_this_volume = this.volume) || _this_volume.disconnect();
+        }
         init(localMediaStream) {
             this.options.logger.debug("AudioRecorder: init()");
+            this.disconnect();
             const volume = this.getAudioContext().createGain();
+            this.volume = volume;
             try {
                 this.audioInput = this.getAudioContext().createMediaStreamSource(localMediaStream);
             } catch (exc) {
@@ -19522,10 +19597,15 @@ var __webpack_exports__ = {};
                 this.onAudioProcess(e, cb);
             };
         }
+        resume() {
+            return AudioRecorder_async_to_generator(function*() {
+                const context = this.getAudioContext();
+                if ("running" !== context.state) yield context.resume();
+            }).call(this);
+        }
         stop() {
             this.options.logger.debug("AudioRecorder: stop()");
-            if (this.scriptProcessor) this.scriptProcessor.onaudioprocess = null;
-            if (this.audioInput) this.audioInput.disconnect();
+            this.disconnect();
             if (this.hasAudioContext()) this.getAudioContext().close().then(()=>{
                 this.options.logger.debug("AudioRecorder: audio context is closed");
                 this.vcAudioContext = void 0;
@@ -19544,6 +19624,7 @@ var __webpack_exports__ = {};
         constructor(userMedia, options){
             AudioRecorder_define_property(this, "scriptProcessor", void 0);
             AudioRecorder_define_property(this, "audioInput", void 0);
+            AudioRecorder_define_property(this, "volume", void 0);
             AudioRecorder_define_property(this, "vcAudioContext", void 0);
             AudioRecorder_define_property(this, "userMedia", void 0);
             AudioRecorder_define_property(this, "options", void 0);
@@ -19567,6 +19648,32 @@ var __webpack_exports__ = {};
         return isVirtual;
     }
     const util_isVirtualCamera = isVirtualCamera;
+    function userMedia_asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+        try {
+            var info = gen[key](arg);
+            var value = info.value;
+        } catch (error) {
+            reject(error);
+            return;
+        }
+        if (info.done) resolve(value);
+        else Promise.resolve(value).then(_next, _throw);
+    }
+    function userMedia_async_to_generator(fn) {
+        return function() {
+            var self1 = this, args = arguments;
+            return new Promise(function(resolve, reject) {
+                var gen = fn.apply(self1, args);
+                function _next(value) {
+                    userMedia_asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+                }
+                function _throw(err) {
+                    userMedia_asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+                }
+                _next(void 0);
+            });
+        };
+    }
     function userMedia_define_property(obj, key, value) {
         if (key in obj) Object.defineProperty(obj, key, {
             value: value,
@@ -19603,6 +19710,20 @@ var __webpack_exports__ = {};
                 this.currentVisualStream = void 0;
             }
         }
+        restorePlayback() {
+            return userMedia_async_to_generator(function*() {
+                var _this_audioRecorder;
+                if (!this.rawVisualUserMedia) throw new Error("No camera preview is available.");
+                yield this.rawVisualUserMedia.play();
+                yield null == (_this_audioRecorder = this.audioRecorder) ? void 0 : _this_audioRecorder.resume();
+            }).call(this);
+        }
+        hasLiveStream() {
+            var _this_currentVisualStream, _this_currentVisualStream1, _this_currentVisualStream2;
+            const videoReady = null == (_this_currentVisualStream = this.currentVisualStream) ? void 0 : _this_currentVisualStream.getVideoTracks().some((track)=>"live" === track.readyState && track.enabled && !track.muted);
+            const audioReady = !isAudioEnabled(this.options) || (null == (_this_currentVisualStream1 = this.currentVisualStream) ? void 0 : _this_currentVisualStream1.getAudioTracks().some((track)=>"live" === track.readyState && track.enabled && !track.muted));
+            return Boolean((null == (_this_currentVisualStream2 = this.currentVisualStream) ? void 0 : _this_currentVisualStream2.active) && videoReady && audioReady);
+        }
         hasEnded() {
             var _this_rawVisualUserMedia, _this_currentVisualStream;
             if (null == (_this_rawVisualUserMedia = this.rawVisualUserMedia) ? void 0 : _this_rawVisualUserMedia.ended) return this.rawVisualUserMedia.ended;
@@ -19617,8 +19738,9 @@ var __webpack_exports__ = {};
             this.options.logger.debug(`UserMedia: ... ${EVENT_ASCII} event ${eventType}: ${string_pretty(params)}`);
         }
         unloadRemainingEventListeners() {
-            var _this_rawVisualUserMedia;
+            var _this_clearInitializationListeners, _this, _this_rawVisualUserMedia;
             this.options.logger.debug("UserMedia: unloadRemainingEventListeners()");
+            null == (_this_clearInitializationListeners = (_this = this).clearInitializationListeners) || _this_clearInitializationListeners.call(_this);
             mediaEvents.forEach((eventName)=>{
                 var _this_rawVisualUserMedia;
                 null == (_this_rawVisualUserMedia = this.rawVisualUserMedia) || _this_rawVisualUserMedia.removeEventListener(eventName, this.outputEvent);
@@ -19630,11 +19752,14 @@ var __webpack_exports__ = {};
             this.removeListener("SENDING_FIRST_FRAME");
             null == (_this_audioRecorder = this.audioRecorder) || _this_audioRecorder.record(audioCallback);
         }
-        init(localMediaStream, videoCallback, audioCallback, endedEarlyCallback, switchingFacingMode) {
+        init(localMediaStream, videoCallback, audioCallback, endedEarlyCallback, params) {
+            var _this_clearInitializationListeners, _this;
+            null == (_this_clearInitializationListeners = (_this = this).clearInitializationListeners) || _this_clearInitializationListeners.call(_this);
             this.stop(localMediaStream, {
                 aboutToInitialize: true,
-                switchingFacingMode
+                preserveRecordingState: Boolean((null == params ? void 0 : params.switchingFacingMode) || (null == params ? void 0 : params.recovering))
             });
+            const initializationId = ++this.initializationId;
             this.onPlayReached = false;
             this.onLoadedMetaDataReached = false;
             this.playingPromiseReached = false;
@@ -19648,6 +19773,12 @@ var __webpack_exports__ = {};
                 null == (_this_rawVisualUserMedia = this.rawVisualUserMedia) || _this_rawVisualUserMedia.removeEventListener("play", onPlay);
                 null == (_this_rawVisualUserMedia1 = this.rawVisualUserMedia) || _this_rawVisualUserMedia1.removeEventListener("loadedmetadata", onLoadedMetaData);
             };
+            this.clearInitializationListeners = ()=>{
+                var _this_rawVisualUserMedia, _this_rawVisualUserMedia1;
+                null == (_this_rawVisualUserMedia = this.rawVisualUserMedia) || _this_rawVisualUserMedia.removeEventListener("play", onPlay);
+                null == (_this_rawVisualUserMedia1 = this.rawVisualUserMedia) || _this_rawVisualUserMedia1.removeEventListener("loadedmetadata", onLoadedMetaData);
+                this.clearInitializationListeners = void 0;
+            };
             const play = ()=>{
                 try {
                     var _this_rawVisualUserMedia, _this_rawVisualUserMedia1;
@@ -19655,12 +19786,14 @@ var __webpack_exports__ = {};
                     if (null == (_this_rawVisualUserMedia1 = this.rawVisualUserMedia) ? void 0 : _this_rawVisualUserMedia1.paused) {
                         this.options.logger.debug(`UserMedia: play(): media.readyState=${this.rawVisualUserMedia.readyState}, media.paused=${this.rawVisualUserMedia.paused}, media.ended=${this.rawVisualUserMedia.ended}, media.played=${string_pretty(this.rawVisualUserMedia.played)}`);
                         this.rawVisualUserMedia.play().then(()=>{
+                            if (initializationId !== this.initializationId) return;
                             if (!this.playingPromiseReached) {
                                 this.options.logger.debug("UserMedia: play promise successful. Playing now.");
                                 this.playingPromiseReached = true;
                             }
                         }).catch((exc)=>{
-                            if (exc instanceof Error) this.options.logger.warn(`Caught pending user media promise exception: ${exc.toString()}`);
+                            if (initializationId !== this.initializationId) return;
+                            if (exc instanceof Error && !(null == params ? void 0 : params.recovering)) this.options.logger.warn(`Caught pending user media promise exception: ${exc.toString()}`);
                             else {
                                 unloadAllEventListeners();
                                 endedEarlyCallback(error_createError({
@@ -19682,16 +19815,30 @@ var __webpack_exports__ = {};
                 this.options.logger.debug(`UserMedia: fireCallbacks(readyState=${readyState}, onPlayReached=${this.onPlayReached}, onLoadedMetaDataReached=${this.onLoadedMetaDataReached})`);
                 if (this.onPlayReached && this.onLoadedMetaDataReached) if (this.audioRecorder) try {
                     this.audioRecorder.init(localMediaStream);
-                    this.on("SENDING_FIRST_FRAME", ()=>{
-                        this.audioRecord(audioCallback);
-                    });
-                    videoCallback();
+                    const onAudioReady = ()=>{
+                        var _this_clearInitializationListeners, _this;
+                        if (initializationId !== this.initializationId || this.currentVisualStream !== localMediaStream) return;
+                        if (this.recording) this.audioRecord(audioCallback);
+                        else this.on("SENDING_FIRST_FRAME", ()=>{
+                            this.audioRecord(audioCallback);
+                        });
+                        null == (_this_clearInitializationListeners = (_this = this).clearInitializationListeners) || _this_clearInitializationListeners.call(_this);
+                        videoCallback();
+                    };
+                    if (null == params ? void 0 : params.recovering) this.audioRecorder.resume().then(onAudioReady).catch(endedEarlyCallback);
+                    else onAudioReady();
                 } catch (exc) {
                     unloadAllEventListeners();
-                    this.stop();
+                    this.stop(void 0, {
+                        preserveRecordingState: Boolean(null == params ? void 0 : params.recovering)
+                    });
                     endedEarlyCallback(exc);
                 }
-                else videoCallback();
+                else {
+                    var _this_clearInitializationListeners, _this;
+                    null == (_this_clearInitializationListeners = (_this = this).clearInitializationListeners) || _this_clearInitializationListeners.call(_this);
+                    videoCallback();
+                }
             };
             const onPlay = ()=>{
                 try {
@@ -19764,9 +19911,8 @@ var __webpack_exports__ = {};
                 this.setVisualStream(localMediaStream);
                 play();
             } catch (exc) {
-                this.emit("ERROR", {
-                    exc
-                });
+                unloadAllEventListeners();
+                endedEarlyCallback(exc);
             }
         }
         getVideoTrackLabel() {
@@ -19780,7 +19926,9 @@ var __webpack_exports__ = {};
             try {
                 let chosenStream = visualStream;
                 if (!(null == params ? void 0 : params.aboutToInitialize)) {
-                    var _this_audioRecorder;
+                    var _this_clearInitializationListeners, _this, _this_audioRecorder;
+                    this.initializationId++;
+                    null == (_this_clearInitializationListeners = (_this = this).clearInitializationListeners) || _this_clearInitializationListeners.call(_this);
                     null != chosenStream || (chosenStream = this.currentVisualStream);
                     const tracks = null == chosenStream ? void 0 : chosenStream.getTracks();
                     if (tracks) tracks.forEach((track)=>{
@@ -19790,7 +19938,7 @@ var __webpack_exports__ = {};
                     null == (_this_audioRecorder = this.audioRecorder) || _this_audioRecorder.stop();
                     this.audioRecorder = void 0;
                 }
-                if (!(null == params ? void 0 : params.switchingFacingMode)) this.paused = this.recording = false;
+                if (!(null == params ? void 0 : params.preserveRecordingState)) this.paused = this.recording = false;
             } catch (exc) {
                 this.emit("ERROR", {
                     exc
@@ -19878,7 +20026,7 @@ var __webpack_exports__ = {};
             };
         }
         constructor(recorder, options){
-            super("UserMedia", options), userMedia_define_property(this, "recorder", void 0), userMedia_define_property(this, "rawVisualUserMedia", void 0), userMedia_define_property(this, "paused", false), userMedia_define_property(this, "recording", false), userMedia_define_property(this, "audioRecorder", void 0), userMedia_define_property(this, "currentVisualStream", void 0), userMedia_define_property(this, "onPlayReached", false), userMedia_define_property(this, "onLoadedMetaDataReached", false), userMedia_define_property(this, "playingPromiseReached", false), userMedia_define_property(this, "videoTrackLabel", void 0), userMedia_define_property(this, "outputEvent", (e)=>{
+            super("UserMedia", options), userMedia_define_property(this, "recorder", void 0), userMedia_define_property(this, "rawVisualUserMedia", void 0), userMedia_define_property(this, "paused", false), userMedia_define_property(this, "recording", false), userMedia_define_property(this, "audioRecorder", void 0), userMedia_define_property(this, "currentVisualStream", void 0), userMedia_define_property(this, "onPlayReached", false), userMedia_define_property(this, "onLoadedMetaDataReached", false), userMedia_define_property(this, "playingPromiseReached", false), userMedia_define_property(this, "videoTrackLabel", void 0), userMedia_define_property(this, "clearInitializationListeners", void 0), userMedia_define_property(this, "initializationId", 0), userMedia_define_property(this, "outputEvent", (e)=>{
                 var _this_rawVisualUserMedia, _this_rawVisualUserMedia1;
                 this.logEvent(e.type, {
                     readyState: null == (_this_rawVisualUserMedia = this.rawVisualUserMedia) ? void 0 : _this_rawVisualUserMedia.readyState
@@ -20160,7 +20308,10 @@ var __webpack_exports__ = {};
             this.pingInterval = void 0;
         }
         onAudioSample(audioSample) {
-            if (this.recordingTransportFailed) return;
+            var _this_userMedia;
+            if (this.recordingTransportFailed || this.cameraRecovery) return;
+            const sampleRate = null == (_this_userMedia = this.userMedia) ? void 0 : _this_userMedia.getAudioSampleRate();
+            if (sampleRate && sampleRate > 0) null != this.recordingAudioSampleRate || (this.recordingAudioSampleRate = sampleRate);
             this.samplesCount++;
             this.mediaTransmissionStarted = true;
             const audioBuffer = audioSample.toBuffer();
@@ -20173,19 +20324,27 @@ var __webpack_exports__ = {};
             try {
                 this.options.logger.debug(`Recorder: onUserMediaReady(${params ? string_pretty(params) : ""})`);
                 const switchingFacingMode = null == params ? void 0 : params.switchingFacingMode;
+                if (null == params ? void 0 : params.recovering) {
+                    var _this_userMedia;
+                    if (!(null == (_this_userMedia = this.userMedia) ? void 0 : _this_userMedia.hasLiveStream())) return void this.failCameraRecovery(new Error("The restored camera has no live tracks."));
+                    if (void 0 !== this.recordingAudioSampleRate && this.userMedia.getAudioSampleRate() !== this.recordingAudioSampleRate) return void this.failCameraRecovery(new Error("The audio sample rate changed during recovery."));
+                }
                 this.userMediaLoading = this.blocking = this.unloaded = this.submitting = false;
                 this.userMediaLoaded = true;
                 this.clearUserMediaTimeout();
-                if (!switchingFacingMode) this.loop = this.createLoop();
+                if (!switchingFacingMode && !(null == params ? void 0 : params.recovering)) this.loop = this.createLoop();
                 this.show();
                 if (null == params ? void 0 : params.recordWhenReady) this.record();
                 this.emit("USER_MEDIA_READY", {
                     switchingFacingMode: null == params ? void 0 : params.switchingFacingMode,
+                    recovering: null == params ? void 0 : params.recovering,
                     paused: this.isPaused(),
                     recordWhenReady: null == params ? void 0 : params.recordWhenReady
                 });
+                if (null == params ? void 0 : params.recovering) this.finishCameraRecovery(true);
             } catch (exc) {
-                this.emit("ERROR", {
+                if (null == params ? void 0 : params.recovering) this.failCameraRecovery(exc);
+                else this.emit("ERROR", {
                     exc
                 });
             }
@@ -20560,6 +20719,7 @@ var __webpack_exports__ = {};
         }
         userMediaErrorCallback(err, usedConstraints) {
             var _this_userMedia;
+            if (this.cameraRecovery) return void this.failCameraRecovery(err);
             if (this.unloaded) return void this.options.logger.debug(`Recorder: already unloaded. Not going to throw error ${string_pretty(err)}`);
             this.userMediaLoading = false;
             this.clearUserMediaTimeout();
@@ -20591,7 +20751,7 @@ var __webpack_exports__ = {};
                 });
             }
         }
-        getUserMediaCallback(localStream, params) {
+        getUserMediaCallback(localStream, params, requestId = this.mediaRequestId) {
             if (!this.userMedia) {
                 localStream.getTracks().forEach((track)=>{
                     track.stop();
@@ -20604,20 +20764,20 @@ var __webpack_exports__ = {};
             this.options.logger.debug(`Recorder: getUserMediaCallback(${params ? string_pretty(params) : ""})`);
             if (this.showUserMedia()) try {
                 this.userMedia.init(localStream, ()=>{
-                    if (!this.unloaded) this.onUserMediaReady(params);
+                    if (!this.unloaded && requestId === this.mediaRequestId) this.onUserMediaReady(params);
                 }, this.onAudioSample.bind(this), (err)=>{
-                    if (!this.unloaded) this.userMediaErrorCallback(err, {
+                    if (!this.unloaded && requestId === this.mediaRequestId) this.userMediaErrorCallback(err, {
                         audio: isAudioEnabled(this.options)
                     });
-                }, null == params ? void 0 : params.switchingFacingMode);
+                }, params);
             } catch (exc) {
                 localStream.getTracks().forEach((track)=>{
                     track.stop();
                 });
                 this.userMediaLoading = false;
                 this.clearUserMediaTimeout();
-                this.emit("ERROR", {
-                    exc
+                this.userMediaErrorCallback(exc, {
+                    audio: isAudioEnabled(this.options)
                 });
             }
             else {
@@ -20626,12 +20786,14 @@ var __webpack_exports__ = {};
                 });
                 this.userMediaLoading = false;
                 this.clearUserMediaTimeout();
+                this.cancelCameraRecovery();
             }
         }
         loadGenuineUserMedia(params) {
             this.options.logger.debug(`Recorder: loadGenuineUserMedia(${params ? string_pretty(params) : ""})`);
             this.emit("ASKING_WEBCAM_PERMISSION");
             this.userMediaLoading = true;
+            const requestId = ++this.mediaRequestId;
             const constraints = {
                 video: {
                     frameRate: {
@@ -20645,18 +20807,18 @@ var __webpack_exports__ = {};
             this.options.logger.debug(string_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)=>{
+                if (this.unloaded || requestId !== this.mediaRequestId) return void localStream.getTracks().forEach((track)=>{
                     track.stop();
                 });
-                this.getUserMediaCallback(localStream, params);
+                this.getUserMediaCallback(localStream, params, requestId);
             }).catch((reason)=>{
-                if (!this.unloaded) this.userMediaErrorCallback(reason, constraints);
+                if (!this.unloaded && requestId === this.mediaRequestId) this.userMediaErrorCallback(reason, constraints);
             });
         }
         configureVideoConstraints(constraints, params) {
             const videoConstraints = "object" == typeof constraints.video ? constraints.video : void 0;
             if (!videoConstraints) return;
-            if (null == params ? void 0 : params.switchingFacingMode) videoConstraints.facingMode = params.switchingFacingMode;
+            if ((null == params ? void 0 : params.switchingFacingMode) || (null == params ? void 0 : params.recovering)) videoConstraints.facingMode = params.switchingFacingMode || this.facingMode;
             if (this.options.video.width) videoConstraints.width = {
                 ideal: this.options.video.width
             };
@@ -20684,8 +20846,8 @@ var __webpack_exports__ = {};
                     if (!this.userMediaLoaded) {
                         this.userMediaLoading = false;
                         const err = util_getBrowser(this.options).getNoAccessIssue();
-                        this.emit("ERROR", {
-                            err
+                        this.userMediaErrorCallback(err, {
+                            audio: isAudioEnabled(this.options)
                         });
                     }
                 }, this.options.timeouts.userMedia);
@@ -20695,6 +20857,7 @@ var __webpack_exports__ = {};
                 this.clearUserMediaTimeout();
                 this.options.logger.debug("Recorder: failed to load genuine user media");
                 this.userMediaLoading = false;
+                if (this.cameraRecovery) return void this.failCameraRecovery(exc);
                 const errorListeners = this.getListeners("ERROR");
                 if (null == errorListeners ? void 0 : errorListeners.length) this.emit("ERROR", {
                     exc
@@ -20822,11 +20985,13 @@ var __webpack_exports__ = {};
             return this.recordingStats;
         }
         getAudioSampleRate() {
+            var _this_recordingAudioSampleRate;
             var _this_userMedia;
-            return null == (_this_userMedia = this.userMedia) ? void 0 : _this_userMedia.getAudioSampleRate();
+            return null != (_this_recordingAudioSampleRate = this.recordingAudioSampleRate) ? _this_recordingAudioSampleRate : null == (_this_userMedia = this.userMedia) ? void 0 : _this_userMedia.getAudioSampleRate();
         }
         stop(params) {
             var _this_loop;
+            this.cancelCameraRecovery();
             if (!this.userMedia) throw new Error("No user media defined, unable to stop");
             this.options.logger.debug(`Recorder: stop(${params ? string_pretty(params) : ""})`);
             this.recordingActive = false;
@@ -20851,8 +21016,9 @@ var __webpack_exports__ = {};
                 };
                 if (this.userMedia) this.recordingStats.videoTrackLabel = this.userMedia.getVideoTrackLabel();
                 if (isAudioEnabled(this.options) && this.userMedia) {
+                    var _this_recordingAudioSampleRate;
                     this.recordingStats.samplesCount = this.samplesCount;
-                    this.recordingStats.sampleRate = this.userMedia.getAudioSampleRate();
+                    this.recordingStats.sampleRate = null != (_this_recordingAudioSampleRate = this.recordingAudioSampleRate) ? _this_recordingAudioSampleRate : this.userMedia.getAudioSampleRate();
                 }
                 this.writeCommand("stop", this.recordingStats, ()=>{
                     this.emit("STOPPED", {
@@ -20908,6 +21074,7 @@ var __webpack_exports__ = {};
             this.built = this.connecting = this.connected = false;
         }
         reset() {
+            this.cancelCameraRecovery();
             if (!this.unloaded) {
                 var _this_userMedia;
                 this.options.logger.debug("Recorder: reset()");
@@ -20937,8 +21104,72 @@ var __webpack_exports__ = {};
             var _this_userMedia;
             return null == (_this_userMedia = this.userMedia) ? void 0 : _this_userMedia.isReady();
         }
+        finishCameraRecovery(restored) {
+            this.clearUserMediaTimeout();
+            const resolve = this.resolveCameraRecovery;
+            const resumeRequested = restored && this.resumeAfterCameraRecovery;
+            this.cameraRecovery = void 0;
+            this.resolveCameraRecovery = void 0;
+            this.resumeAfterCameraRecovery = false;
+            null == resolve || resolve(restored);
+            if (resumeRequested && this.isPaused()) this.resume();
+        }
+        cancelCameraRecovery() {
+            var _this_userMedia;
+            if (!this.cameraRecovery) return;
+            this.mediaRequestId++;
+            this.userMediaLoading = false;
+            this.userMediaLoaded = false;
+            this.clearUserMediaTimeout();
+            null == (_this_userMedia = this.userMedia) || _this_userMedia.stop(void 0, {
+                preserveRecordingState: true
+            });
+            this.finishCameraRecovery(false);
+        }
+        failCameraRecovery(exc) {
+            this.cancelCameraRecovery();
+            const err = error_createError({
+                message: "Camera recovery failed",
+                explanation: "Your recording is still paused. Check camera permissions, then try Resume again or stop to keep the recorded part.",
+                exc,
+                options: this.options
+            });
+            this.emit("CAMERA_RECOVERY_FAILED", {
+                err
+            });
+        }
+        recoverCamera() {
+            if (this.cameraRecovery) return this.cameraRecovery;
+            if (!this.built || this.unloaded || !this.userMedia || this.userMediaLoading || this.submitting || this.key || void 0 !== this.stopTimeout || this.recordingTransportFailed) return Promise.resolve(false);
+            const liveStream = this.userMedia.hasLiveStream();
+            if (liveStream && this.isRecording()) return Promise.resolve(true);
+            if (!liveStream && this.recordingActive && !this.isPaused()) this.pause();
+            const recovery = new Promise((resolve)=>{
+                this.resolveCameraRecovery = resolve;
+            });
+            this.cameraRecovery = recovery;
+            this.emit("CAMERA_RECOVERING");
+            if (liveStream) {
+                this.userMediaTimeout = window.setTimeout(()=>{
+                    this.failCameraRecovery(new Error("Camera playback recovery timed out."));
+                }, this.options.timeouts.userMedia);
+                this.userMedia.restorePlayback().then(()=>{
+                    if (this.cameraRecovery === recovery) this.finishCameraRecovery(true);
+                }).catch((exc)=>{
+                    if (this.cameraRecovery === recovery) this.failCameraRecovery(exc);
+                });
+            } else {
+                this.userMediaLoaded = false;
+                this.loadUserMedia({
+                    recovering: true
+                });
+            }
+            return recovery;
+        }
         pause(params) {
             var _this_userMedia;
+            this.cancelCameraRecovery();
+            this.resumeAfterDrain = false;
             if (params) this.options.logger.debug(`pause() at frame ${this.framesCount} with ${string_pretty(params)}`);
             else this.options.logger.debug(`pause() at frame ${this.framesCount}`);
             null == (_this_userMedia = this.userMedia) || _this_userMedia.pause();
@@ -20948,10 +21179,15 @@ var __webpack_exports__ = {};
         }
         resume() {
             var _this_userMedia;
+            if (this.cameraRecovery || !(null == (_this_userMedia = this.userMedia) ? void 0 : _this_userMedia.hasLiveStream())) {
+                this.recoverCamera();
+                this.resumeAfterCameraRecovery = Boolean(this.cameraRecovery);
+                return;
+            }
             this.options.logger.debug(`Recorder: resume() with frame ${this.framesCount}`);
             this.stopPings();
             this.emit("RESUMING");
-            null == (_this_userMedia = this.userMedia) || _this_userMedia.resume();
+            this.userMedia.resume();
             if (this.streamBackpressured) this.resumeAfterDrain = true;
             else this.loop.start();
         }
@@ -21007,7 +21243,7 @@ var __webpack_exports__ = {};
             return newLoop;
         }
         record() {
-            if (this.unloaded) return;
+            if (this.unloaded || this.cameraRecovery) return;
             if (!this.connected) {
                 this.options.logger.debug("Recorder: reconnecting before recording …");
                 this.initSocket(()=>{
@@ -21080,6 +21316,7 @@ var __webpack_exports__ = {};
             this.recordingActive = true;
             this.recordingTransportFailed = false;
             this.mediaTransmissionStarted = false;
+            this.recordingAudioSampleRate = void 0;
             this.userMedia.record();
             this.emit("RECORDING", {
                 framesCount: this.framesCount
@@ -21141,7 +21378,7 @@ var __webpack_exports__ = {};
             }
         }
         switchFacingMode() {
-            if (!util_getBrowser(this.options).isMobile()) return;
+            if (this.cameraRecovery || !util_getBrowser(this.options).isMobile()) return;
             if ("user" === this.facingMode) this.facingMode = "environment";
             else if ("environment" === this.facingMode) this.facingMode = "user";
             else this.options.logger.warn(`Recorder: unsupported facing mode ${string_pretty(this.facingMode)}`);
@@ -21152,12 +21389,14 @@ var __webpack_exports__ = {};
         initEvents() {
             this.options.logger.debug("Recorder: initEvents()");
             this.on("SUBMITTING", ()=>{
+                this.cancelCameraRecovery();
                 this.submitting = true;
             });
             this.on("SUBMITTED", ()=>{
                 this.submitting = false;
             });
             this.on("BLOCKING", ()=>{
+                this.cancelCameraRecovery();
                 this.blocking = true;
                 this.clearUserMediaTimeout();
             });
@@ -21333,7 +21572,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, "pendingWrites", new boundedWriteQueue()), 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, "backpressureTimeout", 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, "recordingDimensions", 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, "streamBackpressured", false), recorder_define_property(this, "resumeAfterDrain", false), recorder_define_property(this, "mediaTransmissionStarted", false), recorder_define_property(this, "recordingActive", false), recorder_define_property(this, "recordingTransportFailed", false), 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);
+            super("Recorder", options), recorder_define_property(this, "visuals", void 0), recorder_define_property(this, "replay", void 0), recorder_define_property(this, "pendingWrites", new boundedWriteQueue()), 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, "recordingAudioSampleRate", void 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, "backpressureTimeout", 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, "recordingDimensions", 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, "mediaRequestId", 0), recorder_define_property(this, "cameraRecovery", void 0), recorder_define_property(this, "resolveCameraRecovery", void 0), recorder_define_property(this, "resumeAfterCameraRecovery", 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, "streamBackpressured", false), recorder_define_property(this, "resumeAfterDrain", false), recorder_define_property(this, "mediaTransmissionStarted", false), recorder_define_property(this, "recordingActive", false), recorder_define_property(this, "recordingTransportFailed", false), 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;
@@ -21645,6 +21884,17 @@ var __webpack_exports__ = {};
                     this.endWaiting();
                     this.container.enableForm(false);
                 });
+                this.on("CAMERA_RECOVERING", ()=>{
+                    this.clearCameraRecoveryNotice();
+                });
+                this.on("CAMERA_RECOVERY_FAILED", ({ err })=>{
+                    this.cameraRecoveryFailed = true;
+                    this.options.logger.warn(err);
+                    if (this.options.displayErrors) this.notifier.notify(err.message, err.explanation, {
+                        problem: true
+                    });
+                    this.endWaiting();
+                });
                 this.on("PREVIEW", ()=>{
                     this.endWaiting();
                 });
@@ -21725,6 +21975,7 @@ var __webpack_exports__ = {};
             child.remove();
         }
         reset() {
+            this.clearCameraRecoveryNotice();
             this.endWaiting();
             this.recorder.reset();
         }
@@ -21735,11 +21986,13 @@ var __webpack_exports__ = {};
             this.container.endWaiting();
         }
         stop(params) {
+            this.clearCameraRecoveryNotice();
             this.recorder.stop(params);
             this.recorderInsides.hidePause();
         }
         back(keepHidden = false, cb) {
             this.options.logger.debug(`Visuals: back(keepHidden = ${keepHidden})`);
+            this.cameraRecoveryFailed = false;
             this.replay.hide();
             this.notifier.hide();
             if (keepHidden) {
@@ -21761,6 +22014,7 @@ var __webpack_exports__ = {};
             if (!this.built) return;
             const e = null == params ? void 0 : params.e;
             this.options.logger.debug(`Visuals: unload(${e ? string_pretty(e) : ""})`);
+            this.cameraRecoveryFailed = false;
             this.recorder.unload(params);
             this.recorderInsides.unload();
             this.replay.unload(params);
@@ -21774,13 +22028,31 @@ var __webpack_exports__ = {};
             this.recorder.pause(params);
             this.recorderInsides.showPause();
         }
+        clearCameraRecoveryNotice() {
+            if (this.cameraRecoveryFailed) {
+                this.notifier.hide();
+                this.recorder.show();
+                this.cameraRecoveryFailed = false;
+            }
+        }
+        recoverCamera() {
+            if (this.replay.isShown() || this.isNotifying() && !this.cameraRecoveryFailed) return Promise.resolve(false);
+            this.clearCameraRecoveryNotice();
+            return this.recorder.recoverCamera();
+        }
         resume() {
-            if (this.recorderInsides.isCountingDown()) this.recorderInsides.resumeCountdown();
-            else this.recorder.resume();
-            this.recorderInsides.hidePause();
+            this.clearCameraRecoveryNotice();
+            if (this.recorderInsides.isCountingDown()) {
+                this.recorderInsides.resumeCountdown();
+                this.recorderInsides.hidePause();
+            } else {
+                this.recorder.resume();
+                if (!this.recorder.isPaused()) this.recorderInsides.hidePause();
+            }
         }
         pauseOrResume() {
-            if (this.isRecordable()) {
+            if (this.cameraRecoveryFailed && this.recorder.isPaused()) this.resume();
+            else if (this.isRecordable()) {
                 if (this.isRecording()) this.pause();
                 else if (this.recorder.isPaused()) this.resume();
                 else if (this.recorder.isReady()) this.recorder.record();
@@ -21903,7 +22175,7 @@ var __webpack_exports__ = {};
             return this.visualsElement;
         }
         constructor(container, options){
-            super("Visuals", options), visuals_define_property(this, "container", void 0), visuals_define_property(this, "replay", void 0), visuals_define_property(this, "recorder", void 0), visuals_define_property(this, "recorderInsides", void 0), visuals_define_property(this, "notifier", void 0), visuals_define_property(this, "visualsElement", void 0), visuals_define_property(this, "built", false);
+            super("Visuals", options), visuals_define_property(this, "container", void 0), visuals_define_property(this, "replay", void 0), visuals_define_property(this, "recorder", void 0), visuals_define_property(this, "recorderInsides", void 0), visuals_define_property(this, "notifier", void 0), visuals_define_property(this, "visualsElement", void 0), visuals_define_property(this, "built", false), visuals_define_property(this, "cameraRecoveryFailed", false);
             this.container = container;
             this.replay = new visuals_replay(this, options);
             this.recorder = new visuals_recorder(this, this.replay, options);
@@ -22047,10 +22319,10 @@ var __webpack_exports__ = {};
             });
             if (!playerOnly) this.stopListeningToVisibility = this.visibility.onChange((visible)=>{
                 if (this.built) if (visible) {
-                    if (isAutoPauseEnabled(this.options) && this.isCountingDown()) this.resume();
+                    if (isAutoPauseEnabled(this.options)) this.recoverCamera();
                     this.emit("VISIBLE");
                 } else {
-                    if (isAutoPauseEnabled(this.options) && (this.isCountingDown() || this.isRecording())) this.pause();
+                    if (isAutoPauseEnabled(this.options)) this.suspend();
                     this.emit("INVISIBLE");
                 }
             });
@@ -22244,6 +22516,13 @@ var __webpack_exports__ = {};
         pause(params) {
             this.visuals.pause(params);
         }
+        suspend() {
+            if (this.built && (this.isCountingDown() || this.isRecording() || this.isPaused())) this.pause();
+        }
+        recoverCamera() {
+            if (!this.built || this.hasError || this.submitted) return Promise.resolve(false);
+            return this.visuals.recoverCamera();
+        }
         validate(event, force = false) {
             let runValidation = true;
             let valid = true;
@@ -22631,6 +22910,12 @@ var __webpack_exports__ = {};
         record() {
             this.container.record();
         }
+        pause() {
+            this.container.suspend();
+        }
+        recoverCamera() {
+            return this.container.recoverCamera();
+        }
         getLogLines() {
             if (this.options.logger.getLines) return this.options.logger.getLines();
         }