videomail-client 16.0.2 → 16.1.0

package/dist/esm/index.js

@@ -3620,7 +3620,7 @@ const constants = {
     }
 };
 var package_namespaceObject = {
-    rE: "16.0.2"
+    rE: "16.1.0"
 };
 function isAudioEnabled(options) {
     return Boolean(options.audio.enabled);
@@ -4368,19 +4368,42 @@ class Form extends util_Despot {
             if (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;
     }
     async doTheSubmit(e) {
         if (e) {
             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 = this.formElement.getAttribute("action") ?? this.options.apiUrl;
         const method = this.formElement.getAttribute("method");
@@ -4395,7 +4418,14 @@ class Form extends util_Despot {
             default:
                 chosenMethod = FormMethod.POST;
         }
-        if (this.container.hasElement()) await this.container.submitAll(this.getData(), chosenMethod, url, hasHostAction);
+        if (this.container.hasElement()) {
+            this.isSubmitting = true;
+            try {
+                await this.container.submitAll(this.getData(), chosenMethod, url, hasHostAction);
+            } finally{
+                this.isSubmitting = false;
+            }
+        }
         return false;
     }
     getInvalidElement() {
@@ -4416,9 +4446,11 @@ class Form extends util_Despot {
         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 = {
@@ -4434,6 +4466,7 @@ class Form extends util_Despot {
         };
     }
 }
+form_define_property(Form, "nextFormId", 0);
 const wrappers_form = Form;
 function resource_define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
@@ -4970,7 +5003,7 @@ class Buttons extends util_Despot {
         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;
         buttonElement = id ? document.querySelector(`#${id}`) : selector ? document.querySelector(selector) : this.buttonsElement?.querySelector(`.${buttonClass}`);
         if (buttonElement) buttonElement = html_adjustButton(buttonElement, show, type, disabled);
@@ -5727,10 +5760,14 @@ class RecorderInsides extends util_Despot {
         this.on("USER_MEDIA_READY", ()=>{
             this.facingMode?.show();
         });
+        this.on("CAMERA_RECOVERING", ()=>{
+            this.facingMode?.hide();
+        });
         this.on("RECORDING", ()=>{
             this.startRecording();
         });
         this.on("RESUMING", ()=>{
+            this.hidePause();
             this.resumeRecording();
         });
         this.on("STOPPING", ()=>{
@@ -6300,9 +6337,19 @@ class AudioRecorder {
         const float32Array = e.inputBuffer.getChannelData(0);
         cb(new audio_sample(float32Array));
     }
+    disconnect() {
+        if (this.scriptProcessor) {
+            this.scriptProcessor.onaudioprocess = null;
+            this.scriptProcessor.disconnect();
+        }
+        this.audioInput?.disconnect();
+        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) {
@@ -6334,10 +6381,13 @@ class AudioRecorder {
             this.onAudioProcess(e, cb);
         };
     }
+    async resume() {
+        const context = this.getAudioContext();
+        if ("running" !== context.state) await context.resume();
+    }
     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;
@@ -6356,6 +6406,7 @@ class AudioRecorder {
     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);
@@ -6415,6 +6466,16 @@ class UserMedia extends util_Despot {
             this.currentVisualStream = void 0;
         }
     }
+    async restorePlayback() {
+        if (!this.rawVisualUserMedia) throw new Error("No camera preview is available.");
+        await this.rawVisualUserMedia.play();
+        await this.audioRecorder?.resume();
+    }
+    hasLiveStream() {
+        const videoReady = this.currentVisualStream?.getVideoTracks().some((track)=>"live" === track.readyState && track.enabled && !track.muted);
+        const audioReady = !isAudioEnabled(this.options) || this.currentVisualStream?.getAudioTracks().some((track)=>"live" === track.readyState && track.enabled && !track.muted);
+        return Boolean(this.currentVisualStream?.active && videoReady && audioReady);
+    }
     hasEnded() {
         if (this.rawVisualUserMedia?.ended) return this.rawVisualUserMedia.ended;
         return !this.currentVisualStream?.active;
@@ -6429,6 +6490,7 @@ class UserMedia extends util_Despot {
     }
     unloadRemainingEventListeners() {
         this.options.logger.debug("UserMedia: unloadRemainingEventListeners()");
+        this.clearInitializationListeners?.();
         mediaEvents.forEach((eventName)=>{
             this.rawVisualUserMedia?.removeEventListener(eventName, this.outputEvent);
         });
@@ -6438,11 +6500,13 @@ class UserMedia extends util_Despot {
         this.removeListener("SENDING_FIRST_FRAME");
         this.audioRecorder?.record(audioCallback);
     }
-    init(localMediaStream, videoCallback, audioCallback, endedEarlyCallback, switchingFacingMode) {
+    init(localMediaStream, videoCallback, audioCallback, endedEarlyCallback, params) {
+        this.clearInitializationListeners?.();
         this.stop(localMediaStream, {
             aboutToInitialize: true,
-            switchingFacingMode
+            preserveRecordingState: Boolean(params?.switchingFacingMode || params?.recovering)
         });
+        const initializationId = ++this.initializationId;
         this.onPlayReached = false;
         this.onLoadedMetaDataReached = false;
         this.playingPromiseReached = false;
@@ -6455,18 +6519,25 @@ class UserMedia extends util_Despot {
             this.rawVisualUserMedia?.removeEventListener("play", onPlay);
             this.rawVisualUserMedia?.removeEventListener("loadedmetadata", onLoadedMetaData);
         };
+        this.clearInitializationListeners = ()=>{
+            this.rawVisualUserMedia?.removeEventListener("play", onPlay);
+            this.rawVisualUserMedia?.removeEventListener("loadedmetadata", onLoadedMetaData);
+            this.clearInitializationListeners = void 0;
+        };
         const play = ()=>{
             try {
                 this.rawVisualUserMedia?.load();
                 if (this.rawVisualUserMedia?.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 && !params?.recovering) this.options.logger.warn(`Caught pending user media promise exception: ${exc.toString()}`);
                         else {
                             unloadAllEventListeners();
                             endedEarlyCallback(error_createError({
@@ -6487,16 +6558,28 @@ class UserMedia extends util_Despot {
             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 = ()=>{
+                    if (initializationId !== this.initializationId || this.currentVisualStream !== localMediaStream) return;
+                    if (this.recording) this.audioRecord(audioCallback);
+                    else this.on("SENDING_FIRST_FRAME", ()=>{
+                        this.audioRecord(audioCallback);
+                    });
+                    this.clearInitializationListeners?.();
+                    videoCallback();
+                };
+                if (params?.recovering) this.audioRecorder.resume().then(onAudioReady).catch(endedEarlyCallback);
+                else onAudioReady();
             } catch (exc) {
                 unloadAllEventListeners();
-                this.stop();
+                this.stop(void 0, {
+                    preserveRecordingState: Boolean(params?.recovering)
+                });
                 endedEarlyCallback(exc);
             }
-            else videoCallback();
+            else {
+                this.clearInitializationListeners?.();
+                videoCallback();
+            }
         };
         const onPlay = ()=>{
             try {
@@ -6566,9 +6649,8 @@ class UserMedia extends util_Despot {
             this.setVisualStream(localMediaStream);
             play();
         } catch (exc) {
-            this.emit("ERROR", {
-                exc
-            });
+            unloadAllEventListeners();
+            endedEarlyCallback(exc);
         }
     }
     getVideoTrackLabel() {
@@ -6581,6 +6663,8 @@ class UserMedia extends util_Despot {
         try {
             let chosenStream = visualStream;
             if (!params?.aboutToInitialize) {
+                this.initializationId++;
+                this.clearInitializationListeners?.();
                 chosenStream ??= this.currentVisualStream;
                 const tracks = chosenStream?.getTracks();
                 if (tracks) tracks.forEach((track)=>{
@@ -6590,7 +6674,7 @@ class UserMedia extends util_Despot {
                 this.audioRecorder?.stop();
                 this.audioRecorder = void 0;
             }
-            if (!params?.switchingFacingMode) this.paused = this.recording = false;
+            if (!params?.preserveRecordingState) this.paused = this.recording = false;
         } catch (exc) {
             this.emit("ERROR", {
                 exc
@@ -6677,7 +6761,7 @@ class UserMedia extends util_Despot {
         };
     }
     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)=>{
             this.logEvent(e.type, {
                 readyState: this.rawVisualUserMedia?.readyState
             });
@@ -6938,7 +7022,9 @@ class Recorder extends util_Despot {
         this.pingInterval = void 0;
     }
     onAudioSample(audioSample) {
-        if (this.recordingTransportFailed) return;
+        if (this.recordingTransportFailed || this.cameraRecovery) return;
+        const sampleRate = this.userMedia?.getAudioSampleRate();
+        if (sampleRate && sampleRate > 0) this.recordingAudioSampleRate ??= sampleRate;
         this.samplesCount++;
         this.mediaTransmissionStarted = true;
         const audioBuffer = audioSample.toBuffer();
@@ -6951,19 +7037,26 @@ class Recorder extends util_Despot {
         try {
             this.options.logger.debug(`Recorder: onUserMediaReady(${params ? string_pretty(params) : ""})`);
             const switchingFacingMode = params?.switchingFacingMode;
+            if (params?.recovering) {
+                if (!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 && !params?.recovering) this.loop = this.createLoop();
             this.show();
             if (params?.recordWhenReady) this.record();
             this.emit("USER_MEDIA_READY", {
                 switchingFacingMode: params?.switchingFacingMode,
+                recovering: params?.recovering,
                 paused: this.isPaused(),
                 recordWhenReady: params?.recordWhenReady
             });
+            if (params?.recovering) this.finishCameraRecovery(true);
         } catch (exc) {
-            this.emit("ERROR", {
+            if (params?.recovering) this.failCameraRecovery(exc);
+            else this.emit("ERROR", {
                 exc
             });
         }
@@ -7334,6 +7427,7 @@ class Recorder extends util_Despot {
         return this.blocking;
     }
     userMediaErrorCallback(err, usedConstraints) {
+        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();
@@ -7365,7 +7459,7 @@ class Recorder extends util_Despot {
             });
         }
     }
-    getUserMediaCallback(localStream, params) {
+    getUserMediaCallback(localStream, params, requestId = this.mediaRequestId) {
         if (!this.userMedia) {
             localStream.getTracks().forEach((track)=>{
                 track.stop();
@@ -7378,20 +7472,20 @@ class Recorder extends util_Despot {
         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)
                 });
-            }, 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 {
@@ -7400,12 +7494,14 @@ class Recorder extends util_Despot {
             });
             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: {
@@ -7419,18 +7515,18 @@ class Recorder extends util_Despot {
         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 (params?.switchingFacingMode) videoConstraints.facingMode = params.switchingFacingMode;
+        if (params?.switchingFacingMode || params?.recovering) videoConstraints.facingMode = params.switchingFacingMode || this.facingMode;
         if (this.options.video.width) videoConstraints.width = {
             ideal: this.options.video.width
         };
@@ -7458,8 +7554,8 @@ class Recorder extends util_Despot {
                 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);
@@ -7469,6 +7565,7 @@ class Recorder extends util_Despot {
             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 (errorListeners?.length) this.emit("ERROR", {
                 exc
@@ -7592,9 +7689,10 @@ class Recorder extends util_Despot {
         return this.recordingStats;
     }
     getAudioSampleRate() {
-        return this.userMedia?.getAudioSampleRate();
+        return this.recordingAudioSampleRate ?? this.userMedia?.getAudioSampleRate();
     }
     stop(params) {
+        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;
@@ -7620,7 +7718,7 @@ class Recorder extends util_Despot {
             if (this.userMedia) this.recordingStats.videoTrackLabel = this.userMedia.getVideoTrackLabel();
             if (isAudioEnabled(this.options) && this.userMedia) {
                 this.recordingStats.samplesCount = this.samplesCount;
-                this.recordingStats.sampleRate = this.userMedia.getAudioSampleRate();
+                this.recordingStats.sampleRate = this.recordingAudioSampleRate ?? this.userMedia.getAudioSampleRate();
             }
             this.writeCommand("stop", this.recordingStats, ()=>{
                 this.emit("STOPPED", {
@@ -7675,6 +7773,7 @@ class Recorder extends util_Despot {
         this.built = this.connecting = this.connected = false;
     }
     reset() {
+        this.cancelCameraRecovery();
         if (!this.unloaded) {
             this.options.logger.debug("Recorder: reset()");
             this.emit("RESETTING");
@@ -7702,7 +7801,70 @@ class Recorder extends util_Despot {
     isReady() {
         return 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;
+        resolve?.(restored);
+        if (resumeRequested && this.isPaused()) this.resume();
+    }
+    cancelCameraRecovery() {
+        if (!this.cameraRecovery) return;
+        this.mediaRequestId++;
+        this.userMediaLoading = false;
+        this.userMediaLoaded = false;
+        this.clearUserMediaTimeout();
+        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) {
+        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}`);
         this.userMedia?.pause();
@@ -7711,10 +7873,15 @@ class Recorder extends util_Despot {
         this.sendPings();
     }
     resume() {
+        if (this.cameraRecovery || !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");
-        this.userMedia?.resume();
+        this.userMedia.resume();
         if (this.streamBackpressured) this.resumeAfterDrain = true;
         else this.loop.start();
     }
@@ -7769,7 +7936,7 @@ class Recorder extends util_Despot {
         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(()=>{
@@ -7842,6 +8009,7 @@ class Recorder extends util_Despot {
         this.recordingActive = true;
         this.recordingTransportFailed = false;
         this.mediaTransmissionStarted = false;
+        this.recordingAudioSampleRate = void 0;
         this.userMedia.record();
         this.emit("RECORDING", {
             framesCount: this.framesCount
@@ -7903,7 +8071,7 @@ class Recorder extends util_Despot {
         }
     }
     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)}`);
@@ -7914,12 +8082,14 @@ class Recorder extends util_Despot {
     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();
         });
@@ -8093,7 +8263,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, "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;
@@ -8386,6 +8556,17 @@ class Visuals extends util_Despot {
                 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();
             });
@@ -8464,6 +8645,7 @@ class Visuals extends util_Despot {
         child.remove();
     }
     reset() {
+        this.clearCameraRecoveryNotice();
         this.endWaiting();
         this.recorder.reset();
     }
@@ -8474,11 +8656,13 @@ class Visuals extends util_Despot {
         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) {
@@ -8500,6 +8684,7 @@ class Visuals extends util_Despot {
         if (!this.built) return;
         const e = 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);
@@ -8513,13 +8698,31 @@ class Visuals extends util_Despot {
         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();
@@ -8641,7 +8844,7 @@ class Visuals extends util_Despot {
         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);
@@ -8743,10 +8946,10 @@ class Container extends util_Despot {
         });
         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");
             }
         });
@@ -8934,6 +9137,13 @@ class Container extends util_Despot {
     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;
@@ -9275,6 +9485,12 @@ class VideomailClient extends util_Despot {
     record() {
         this.container.record();
     }
+    pause() {
+        this.container.suspend();
+    }
+    recoverCamera() {
+        return this.container.recoverCamera();
+    }
     getLogLines() {
         if (this.options.logger.getLines) return this.options.logger.getLines();
     }