videomail-client 16.5.0 → 16.7.0

package/dist/esm/index.js

@@ -3620,7 +3620,7 @@ const constants = {
     }
 };
 var package_namespaceObject = {
-    rE: "16.5.0"
+    rE: "16.7.0"
 };
 function isAudioEnabled(options) {
     return Boolean(options.audio.enabled);
@@ -4286,6 +4286,17 @@ class Form extends util_Despot {
     enable(buttonsToo) {
         this.setDisabled(false, buttonsToo);
     }
+    disableForSubmission() {
+        for (const formControl of this.formElement.elements){
+            this.submissionDisabledStates.set(formControl, formControl.hasAttribute("disabled"));
+            formControl.setAttribute("disabled", "disabled");
+        }
+    }
+    restoreAfterFailedSubmission() {
+        for (const [formControl, wasDisabled] of this.submissionDisabledStates)if (wasDisabled) formControl.setAttribute("disabled", "disabled");
+        else formControl.removeAttribute("disabled");
+        this.submissionDisabledStates.clear();
+    }
     build() {
         this.options.logger.debug("Form: build()");
         this.keyInput = this.formElement.querySelector(`input[name="${this.options.selectors.keyInputName}"]`);
@@ -4446,7 +4457,7 @@ 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, "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)=>{
+        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, "submissionDisabledStates", new Map()), form_define_property(this, "FORM_FIELDS", {}), form_define_property(this, "validate", (event)=>{
             this.container.validate(event);
         }), form_define_property(this, "handleSubmit", (event)=>{
             if (!event.defaultPrevented) this.doTheSubmit(event);
@@ -5085,8 +5096,13 @@ class Buttons extends util_Despot {
         this.hide();
     }
     onUserMediaReady(params) {
-        this.onFormReady();
+        this.onFormReady(params);
         html_showElement(this.buttonsElement);
+        if (params.recovering && params.paused) {
+            html_hideElement(this.recordButton);
+            html_disableElement(this.recordButton);
+            return;
+        }
         html_showElement(this.audioOnRadioPair);
         html_showElement(this.audioOffRadioPair);
         if (html_isShown(this.recordButton) && !params.recordWhenReady) html_enableElement(this.recordButton);
@@ -5789,8 +5805,8 @@ class RecorderInsides extends util_Despot {
         this.on("PAUSED", ()=>{
             this.pauseRecording();
         });
-        this.on("ERROR", ()=>{
-            this.onResetting();
+        this.on("ERROR", ({ recoverable })=>{
+            if (!recoverable) this.onResetting();
         });
         this.on("RESETTING", ()=>{
             this.onResetting();
@@ -5973,12 +5989,12 @@ class Notifier extends util_Despot {
         this.entertainTimeoutId = void 0;
         this.entertaining = false;
     }
-    error(err) {
+    error(err, blocking = true) {
         const message = err.message;
         const explanation = err.explanation;
         if (!message) this.options.logger.debug(`Weird empty error message generated for error ${string_pretty(err)}`);
         this.notify(message, explanation, {
-            blocking: true,
+            blocking,
             problem: true,
             classList: err.getClassList(),
             removeDimensions: util_getBrowser(this.options).isMobile()
@@ -6103,6 +6119,18 @@ function summarize(title, contents) {
     return line;
 }
 const string_summarize = summarize;
+function isAutomatedUserAgent(userAgent = navigator.userAgent) {
+    return /bot|crawler|spider|headlesschrome|phantomjs|puppeteer|playwright/iu.test(userAgent);
+}
+const util_isAutomatedUserAgent = isAutomatedUserAgent;
+function getAutomationSignals() {
+    const webdriver = navigator.webdriver;
+    return {
+        webdriver: true === webdriver,
+        userAgentMatched: util_isAutomatedUserAgent()
+    };
+}
+const util_getAutomationSignals = getAutomationSignals;
 function getEdgeCodes(value, amount, fromEnd) {
     const chars = fromEnd ? value.slice(-amount) : value.slice(0, amount);
     const codes = Array.from(chars, (char)=>String(char.codePointAt(0))).join(".");
@@ -6130,15 +6158,16 @@ function getLanguagesValue() {
     if (languageList.length > 0) return languageList.join(",");
     return navigator.language || "none";
 }
-function getAutomationSignals(probeBase, probeSimpleQuery) {
+function getDiagnosticSignals(probeBase, probeSimpleQuery) {
     const reasons = [];
-    if (navigator.webdriver) reasons.push("webdriver=true");
-    if (/HeadlessChrome|PhantomJS|puppeteer|playwright/iu.test(navigator.userAgent)) reasons.push("headless_ua_marker");
+    const automation = util_getAutomationSignals();
+    if (automation.webdriver) reasons.push("webdriver=true");
+    if (automation.userAgentMatched) reasons.push("headless_ua_marker");
     if (0 === navigator.languages.length) reasons.push("no_languages");
     if ("ok" !== probeBase) reasons.push("probe_base_failed");
     if ("ok" !== probeSimpleQuery) reasons.push("probe_simple_query_failed");
     return {
-        looksAutomated: reasons.length > 0,
+        looksAutomated: automation.webdriver || automation.userAgentMatched,
         reasons: reasons.length > 0 ? reasons.join(",") : "none"
     };
 }
@@ -6155,7 +6184,7 @@ function getWebSocketDiagnostic(url2Connect) {
     const probeBase = probeWebSocketConstructor("wss://videomail.io");
     const probeWithSimpleQuery = probeWebSocketConstructor("wss://videomail.io/?a=b");
     const languages = getLanguagesValue();
-    const automationSignals = getAutomationSignals(probeBase, probeWithSimpleQuery);
+    const automationSignals = getDiagnosticSignals(probeBase, probeWithSimpleQuery);
     const diagnosticPairs = [
         `webdriver=${String(navigator.webdriver)}`,
         `wsCtorNative=${String(wsCtorNative)}`,
@@ -6182,10 +6211,6 @@ function getWebSocketDiagnostic(url2Connect) {
     };
 }
 const error_getWebSocketDiagnostic = getWebSocketDiagnostic;
-function isAutomatedUserAgent(userAgent = navigator.userAgent) {
-    return /bot|crawler|spider|headlesschrome|phantomjs|puppeteer|playwright/iu.test(userAgent);
-}
-const util_isAutomatedUserAgent = isAutomatedUserAgent;
 function boundedWriteQueue_define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
         value: value,
@@ -6381,6 +6406,9 @@ class RecorderStreamWriter extends util_Despot {
             explanation: "The server connection closed before this recording completed. It cannot be safely resumed, so it has been stopped. Please start a new recording.",
             options: this.options,
             cause: {
+                transportPhase: "recording",
+                mediaTransmissionStarted: true,
+                automation: util_getAutomationSignals(),
                 unconfirmedFrames,
                 unconfirmedSamples
             }
@@ -6448,15 +6476,32 @@ class RecorderConnection extends streamWriter {
             this.resumeAfterDrain = false;
             this.reconnecting = true;
             this.initSocket();
-        } else if (this.shouldReportStreamClose()) window.setTimeout(()=>{
-            this.handleConnectionFailure({
-                url2Connect,
-                cause: "closed"
-            });
-        }, 0);
+        } else if (this.shouldReportStreamClose()) {
+            const stream = this.stream;
+            window.setTimeout(()=>{
+                if (this.stream === stream) this.handleConnectionFailure({
+                    url2Connect,
+                    cause: "closed"
+                });
+            }, 0);
+        }
     }
     shouldIgnoreStreamClose() {
-        return this.recordingTransportFailed || Boolean(this.unloaded) || this.validate();
+        return this.recordingTransportFailed || Boolean(this.unloaded) || this.validate() || this.blocking && !this.mediaTransmissionStarted;
+    }
+    closeIdleConnection(reason) {
+        if (this.mediaTransmissionStarted) return;
+        this.options.logger.debug(string_summarize("Recorder: closing idle connection", {
+            reason,
+            connected: this.connected,
+            connecting: this.connecting,
+            visibilityState: document.visibilityState
+        }));
+        this.connected = this.connecting = this.reconnecting = false;
+        this.clearConnectionTimeout();
+        this.clearReconnectTimeout();
+        this.stopPings();
+        this.discardSocket();
     }
     handleStreamError(url2Connect, err) {
         if ("u" > typeof Event && err instanceof Event) this.lastSocketError = error_getEventDetails(err);
@@ -6465,28 +6510,20 @@ class RecorderConnection extends streamWriter {
             error: serializeError(err)
         });
         this.options.logger.debug(debugLine);
-        if (this.validate()) {
+        if (this.shouldIgnoreStreamClose()) {
             this.connected = false;
             this.stopPings();
             this.discardSocket();
             return;
         }
-        if (!this.connected) return void this.handleConnectionFailure({
+        if (this.mediaTransmissionStarted) return void this.failInterruptedRecording();
+        this.reconnecting ||= this.canReconnectAfterStreamClose();
+        this.connected = false;
+        this.stopPings();
+        this.handleConnectionFailure({
             url2Connect,
             cause: "error"
         });
-        const streamError = err instanceof Error ? err : new Error("WebSocket stream emitted an error event", {
-            cause: this.lastSocketError ?? err
-        });
-        if (this.mediaTransmissionStarted) return void this.failInterruptedRecording();
-        this.emit("ERROR", {
-            err: error_createError({
-                message: "WebSocket stream error",
-                explanation: `The WebSocket stream emitted an error event. Details: ${string_pretty(err)}`,
-                options: this.options,
-                exc: streamError
-            })
-        });
     }
     sendPings() {
         this.stopPings();
@@ -6546,6 +6583,7 @@ class RecorderConnection extends streamWriter {
         this.connectionFailed = true;
         this.connecting = false;
         this.reconnecting = false;
+        const reconnectAttempts = this.reconnectAttempts;
         this.reconnectAttempts = 0;
         this.clearReconnectTimeout();
         this.clearConnectionTimeout();
@@ -6556,6 +6594,14 @@ class RecorderConnection extends streamWriter {
         const socketError = this.lastSocketError;
         const contents = {
             cause,
+            transportPhase: void 0 === this.connectionOpenedAt ? "initial" : "idle",
+            mediaTransmissionStarted: this.mediaTransmissionStarted,
+            recordingActive: this.recordingActive,
+            framesCount: this.framesCount,
+            samplesCount: this.samplesCount,
+            reconnectAttempts,
+            connectionOpenedAt: this.connectionOpenedAt,
+            automation: util_getAutomationSignals(),
             closeCode: closeEvent?.code,
             closeReason: closeEvent?.reason,
             elapsedMs,
@@ -6597,7 +6643,7 @@ class RecorderConnection extends streamWriter {
         });
     }
     shouldIgnoreConnectionFailure() {
-        return this.connectionFailed || this.connected || Boolean(this.unloaded) || this.validate();
+        return this.connectionFailed || this.connected || Boolean(this.unloaded) || this.validate() || this.blocking && !this.mediaTransmissionStarted;
     }
     initSocket(cb) {
         if (this.connected) {
@@ -6607,7 +6653,8 @@ class RecorderConnection extends streamWriter {
         }
         if (this.connecting) return void this.options.logger.debug("Recorder: already **connecting**. Not going to initialize a new WebSocket connection.");
         this.clearReconnectTimeout();
-        if (util_isAutomatedUserAgent()) {
+        const automation = util_getAutomationSignals();
+        if (automation.userAgentMatched) {
             this.connecting = false;
             this.options.logger.debug("Recorder: skipping web socket connection for an automated crawler");
             return;
@@ -6641,6 +6688,7 @@ class RecorderConnection extends streamWriter {
         try {
             nativeSocket = new WebSocket(url2Connect);
             nativeSocket.addEventListener("close", (event)=>{
+                if (this.stream?.socket !== nativeSocket) return;
                 this.lastCloseEvent = {
                     code: event.code,
                     reason: event.reason,
@@ -6648,6 +6696,7 @@ class RecorderConnection extends streamWriter {
                 };
             });
             nativeSocket.addEventListener("error", (event)=>{
+                if (this.stream?.socket !== nativeSocket) return;
                 this.lastSocketError = error_getEventDetails(event);
             });
         } catch (exc) {
@@ -6659,7 +6708,10 @@ class RecorderConnection extends streamWriter {
                 message,
                 explanation,
                 options: this.options,
-                exc
+                exc,
+                cause: {
+                    automation
+                }
             });
             this.emit("ERROR", {
                 err
@@ -6697,14 +6749,16 @@ class RecorderConnection extends streamWriter {
                 });
             }, connectionTimeoutMs);
             stream.on("close", ()=>{
-                this.handleStreamClose(url2Connect);
+                if (this.stream === stream) this.handleStreamClose(url2Connect);
             });
             stream.on("connect", (args)=>{
+                if (this.stream !== stream) return;
                 this.options.logger.debug(`${PIPE_SYMBOL}Stream *connect* event emitted with args: ${string_pretty(args)}`);
                 this.clearConnectionTimeout();
-                const isClosing = this.stream?.socket.readyState === WebSocket.CLOSING;
+                const isClosing = stream.socket.readyState === WebSocket.CLOSING;
                 if (!this.connected && !isClosing && !this.unloaded) {
                     this.connected = true;
+                    this.connectionOpenedAt = Date.now();
                     this.connecting = this.unloaded = false;
                     this.reconnecting = false;
                     this.reconnectAttempts = 0;
@@ -6714,6 +6768,7 @@ class RecorderConnection extends streamWriter {
                 }
             });
             stream.on("data", (data)=>{
+                if (this.stream !== stream) return;
                 this.options.logger.debug(`${PIPE_SYMBOL}Stream *data* event emitted`);
                 try {
                     const command = JSON.parse(data.toString());
@@ -6732,10 +6787,10 @@ class RecorderConnection extends streamWriter {
                 }
             });
             stream.on("error", (err)=>{
-                this.handleStreamError(url2Connect, err);
+                if (this.stream === stream) this.handleStreamError(url2Connect, err);
             });
             stream.on("drain", ()=>{
-                this.handleStreamDrain(stream);
+                if (this.stream === stream) this.handleStreamDrain(stream);
             });
             stream.on("preend", (args)=>{
                 this.options.logger.debug(`${PIPE_SYMBOL}Stream *preend* event emitted with args: ${string_pretty(args)}`);
@@ -6789,7 +6844,7 @@ class RecorderConnection extends streamWriter {
         }
     }
     constructor(options){
-        super(options), connection_define_property(this, "reconnectTimeout", void 0), connection_define_property(this, "connectionTimeout", void 0), connection_define_property(this, "userMediaLoaded", void 0), connection_define_property(this, "userMediaLoading", false), connection_define_property(this, "unloaded", void 0), connection_define_property(this, "connectionFailed", false), connection_define_property(this, "reconnectAttempts", 0), connection_define_property(this, "blocking", false), connection_define_property(this, "connectingStartedAt", void 0), connection_define_property(this, "lastCloseEvent", void 0), connection_define_property(this, "lastSocketError", void 0), connection_define_property(this, "pingInterval", void 0);
+        super(options), connection_define_property(this, "reconnectTimeout", void 0), connection_define_property(this, "connectionTimeout", void 0), connection_define_property(this, "userMediaLoaded", void 0), connection_define_property(this, "userMediaLoading", false), connection_define_property(this, "unloaded", void 0), connection_define_property(this, "connectionFailed", false), connection_define_property(this, "reconnectAttempts", 0), connection_define_property(this, "blocking", false), connection_define_property(this, "connectingStartedAt", void 0), connection_define_property(this, "lastCloseEvent", void 0), connection_define_property(this, "lastSocketError", void 0), connection_define_property(this, "pingInterval", void 0), connection_define_property(this, "connectionOpenedAt", void 0);
     }
 }
 const connection = RecorderConnection;
@@ -6851,6 +6906,7 @@ class RecorderMedia extends connection {
         const characteristics = this.userMedia?.getCharacteristics();
         this.options.logger.debug(`Recorder: userMediaErrorCallback(), name: ${err.name}, message: ${err.message} and Webcam characteristics: ${characteristics ? string_pretty(characteristics) : "none"}`);
         const errorListeners = this.getListeners("ERROR");
+        if (err.name !== error_VideomailError.MEDIA_DEVICE_NOT_SUPPORTED) this.closeIdleConnection("camera-access-failed");
         if (errorListeners?.length) if (err.name !== error_VideomailError.MEDIA_DEVICE_NOT_SUPPORTED) {
             const videomailError = error_createError({
                 err,
@@ -7332,6 +7388,9 @@ class RecorderCapture extends media {
         if (this.streamBackpressured) this.resumeAfterDrain = true;
         else loop.start();
     }
+    resumeMediaForCountdown() {
+        this.userMedia?.resume();
+    }
     onFlushed(opts) {
         const frameNumber = opts.frameNumber;
         if (1 === frameNumber) this.emit("FIRST_FRAME_SENT");
@@ -8471,6 +8530,7 @@ class Recorder extends capture {
             this.cancelCameraRecovery();
             this.blocking = true;
             this.clearUserMediaTimeout();
+            this.closeIdleConnection("blocking-error");
         });
         this.on("PREVIEW", ()=>{
             this.hide();
@@ -9009,21 +9069,36 @@ class Visuals extends util_Despot {
         this.clearCameraRecoveryNotice();
         return this.recorder.recoverCamera();
     }
-    resume() {
+    canResumeCountdown(restored) {
+        return restored && Boolean(this.recorderInsides.isCountingDown());
+    }
+    async resumeCountdown() {
+        const restored = await this.recoverCamera();
+        if (!this.canResumeCountdown(restored)) return;
+        this.recorder.resumeMediaForCountdown();
+        this.recorderInsides.resumeCountdown();
+        this.recorderInsides.hidePause();
+    }
+    async resume() {
         this.clearCameraRecoveryNotice();
-        if (this.recorderInsides.isCountingDown()) {
-            this.recorderInsides.resumeCountdown();
-            this.recorderInsides.hidePause();
-        } else {
+        if (this.recorderInsides.isCountingDown()) await this.resumeCountdown();
+        else {
             this.recorder.resume();
             if (!this.recorder.isPaused()) this.recorderInsides.hidePause();
         }
     }
+    resumeFromControl() {
+        this.resume().catch((exc)=>{
+            this.emit("ERROR", {
+                exc
+            });
+        });
+    }
     pauseOrResume() {
-        if (this.cameraRecoveryFailed && this.recorder.isPaused()) this.resume();
+        if (this.cameraRecoveryFailed && this.recorder.isPaused()) this.resumeFromControl();
         else if (this.isRecordable()) {
             if (this.isRecording()) this.pause();
-            else if (this.recorder.isPaused()) this.resume();
+            else if (this.recorder.isPaused()) this.resumeFromControl();
             else if (this.recorder.isReady()) this.recorder.record();
         }
     }
@@ -9052,8 +9127,8 @@ class Visuals extends util_Despot {
     isPaused() {
         return this.recorder.isPaused();
     }
-    error(err) {
-        this.notifier.error(err);
+    error(err, blocking = true) {
+        this.notifier.error(err, blocking);
     }
     hide() {
         if (this.visualsElement) {
@@ -9162,6 +9237,7 @@ function container_define_property(obj, key, value) {
     else obj[key] = value;
     return obj;
 }
+const INTERACTIVE_SPACE_TARGETS = "button, input, select, textarea, a[href], summary, label, audio[controls], video[controls], [contenteditable]:not([contenteditable='false']), [role='button'], [role='link'], [role='checkbox'], [role='radio'], [role='switch'], [role='menuitem'], [role='tab'], [tabindex]:not([tabindex='-1'])";
 class Container extends util_Despot {
     buildChildren(playerOnly = false, parentElement) {
         const parentElementInfo = parentElement ? `, parentElement="${string_pretty(parentElement)}"` : "";
@@ -9233,9 +9309,9 @@ class Container extends util_Despot {
             if (params.exc.stack) this.options.logger.error(params.exc.stack);
             else if (params.exc.message) this.options.logger.error(params.exc.message);
         } else this.options.logger.error(params.exc);
-        if (this.options.displayErrors && params.err) this.visuals.error(params.err);
-        else if (this.options.displayErrors && params.exc && params.exc instanceof error_VideomailError) this.visuals.error(params.exc);
-        else this.visuals.reset();
+        if (this.options.displayErrors && params.err) this.visuals.error(params.err, !params.recoverable);
+        else if (this.options.displayErrors && params.exc && params.exc instanceof error_VideomailError) this.visuals.error(params.exc, !params.recoverable);
+        else if (!params.recoverable) this.visuals.reset();
     }
     initEvents(playerOnly = false) {
         this.options.logger.debug(`Container: initEvents (playerOnly = ${playerOnly})`);
@@ -9253,7 +9329,7 @@ class Container extends util_Despot {
             }
         });
         if (this.options.enableSpace) {
-            if (!playerOnly) window.addEventListener("keydown", this.handleKeyDown);
+            if (!playerOnly) this.containerElement?.addEventListener("keydown", this.handleKeyDown);
         }
         this.on("ERROR", (params)=>{
             this.processError(params);
@@ -9293,7 +9369,7 @@ class Container extends util_Despot {
     removeBrowserEventListeners() {
         window.removeEventListener("resize", this.handleWindowResize);
         window.removeEventListener("beforeunload", this.handleBeforeUnload);
-        window.removeEventListener("keydown", this.handleKeyDown);
+        this.containerElement?.removeEventListener("keydown", this.handleKeyDown);
         this.stopListeningToVisibility?.();
         this.stopListeningToVisibility = void 0;
     }
@@ -9532,6 +9608,7 @@ class Container extends util_Despot {
     async submitAll(formData, method, url, hasHostAction = false) {
         let response;
         let hostResponse;
+        let submissionFailed = false;
         const videomailKey = formData[this.options.selectors.keyInputName];
         try {
             const hasVideomailKey = Boolean(videomailKey);
@@ -9542,7 +9619,7 @@ class Container extends util_Despot {
             ].filter(Boolean).join(": ");
             this.options.logger.debug(`Container: submitAll(${output})`);
             this.beginWaiting();
-            if (this.options.disableFormWhenSubmitting) this.disableForm(true);
+            if (this.options.disableFormWhenSubmitting) this.form?.disableForSubmission();
             this.emit("SUBMITTING");
             if (hasVideomailKey) {
                 response = this.getPendingHostSubmissionResponse(videomailKey) ?? await this.submitVideomail(formData, method);
@@ -9572,15 +9649,18 @@ class Container extends util_Despot {
                 });
             }
         } catch (exc) {
+            submissionFailed = true;
             const err = error_createError({
                 exc,
                 options: this.options
             });
             this.emit("ERROR", {
-                err
+                err,
+                recoverable: true
             });
         } finally{
             const finalResponse = hostResponse ?? response;
+            if (submissionFailed && this.options.disableFormWhenSubmitting) this.form?.restoreAfterFailedSubmission();
             if (finalResponse?.text && "text/html" === finalResponse.type) document.body.innerHTML = dompurify.sanitize(finalResponse.text);
             this.endWaiting();
         }
@@ -9634,7 +9714,11 @@ class Container extends util_Despot {
         this.visuals.record();
     }
     resume() {
-        this.visuals.resume();
+        this.visuals.resume().catch((exc)=>{
+            this.emit("ERROR", {
+                exc
+            });
+        });
     }
     stop() {
         this.visuals.stop();
@@ -9654,14 +9738,16 @@ class Container extends util_Despot {
                 e
             });
         }), container_define_property(this, "handleKeyDown", (e)=>{
-            const element = e.target;
-            const tagName = element.tagName;
-            const isEditable = element.isContentEditable || "true" === element.contentEditable;
-            if (!isEditable && tagName && "INPUT" !== tagName.toUpperCase() && "TEXTAREA" !== tagName.toUpperCase() && "Space" === e.code) {
-                e.preventDefault();
-                if (this.options.enablePause) this.visuals.pauseOrResume();
-                else this.visuals.recordOrStop();
-            }
+            const containerElement = this.containerElement;
+            if (!containerElement) return;
+            const eventPath = e.composedPath();
+            const targetContainerIndex = eventPath.findIndex((eventTarget)=>eventTarget instanceof Element && eventTarget.classList.contains(this.options.selectors.containerClass));
+            const targetContainer = eventPath[targetContainerIndex];
+            const isInteractiveTarget = eventPath.slice(0, targetContainerIndex + 1).some((eventTarget)=>eventTarget instanceof Element && eventTarget.matches(INTERACTIVE_SPACE_TARGETS));
+            if (!eventPath.includes(containerElement) || targetContainer !== containerElement || isInteractiveTarget || e.defaultPrevented || e.repeat || e.altKey || e.ctrlKey || e.metaKey || e.shiftKey || "Space" !== e.code) return;
+            e.preventDefault();
+            if (this.options.enablePause) this.visuals.pauseOrResume();
+            else this.visuals.recordOrStop();
         });
         this.visuals = new wrappers_visuals(this, options);
         this.buttons = new buttons(this, options);

package/dist/esm/types/events/params.d.ts

@@ -14,6 +14,7 @@ export interface VideomailCameraRecoveryFailedParams {
 export interface VideomailErrorParams {
     exc?: unknown;
     err?: VideomailError;
+    recoverable?: boolean | undefined;
 }
 export interface VideomailRecordingParams {
     framesCount: number;

package/dist/esm/util/getAutomationSignals.d.ts

@@ -0,0 +1,5 @@
+declare function getAutomationSignals(): {
+    webdriver: boolean;
+    userAgentMatched: boolean;
+};
+export default getAutomationSignals;

package/dist/esm/wrappers/form.d.ts

@@ -18,6 +18,7 @@ declare class Form extends Despot {
     private submitButtonFormAttribute;
     private generatedFormId;
     private isSubmitting;
+    private readonly submissionDisabledStates;
     private readonly FORM_FIELDS;
     constructor(container: Container, formElement: HTMLFormElement, options: VideomailClientOptions);
     private readonly validate;
@@ -406,6 +407,8 @@ declare class Form extends Despot {
     private getRegisteredFormElements;
     disable(buttonsToo: boolean): void;
     enable(buttonsToo: boolean): void;
+    disableForSubmission(): void;
+    restoreAfterFailedSubmission(): void;
     build(): void;
     private removeAllInputListeners;
     private hideSubmitButton;

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

@@ -31,7 +31,7 @@ declare class Notifier extends Despot {
     private show;
     private runEntertainment;
     private cancelEntertainment;
-    error(err: VideomailError): void;
+    error(err: VideomailError, blocking?: boolean): void;
     private getMessageElement;
     private setMessage;
     private setExplanation;

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

@@ -66,6 +66,7 @@ declare abstract class RecorderCapture extends RecorderMedia {
     validate(): boolean;
     pause(params?: PauseParams): void;
     resume(): void;
+    resumeMediaForCountdown(): void;
     private onFlushed;
     private draw;
     private createLoop;

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

@@ -20,6 +20,7 @@ declare abstract class RecorderConnection extends RecorderStreamWriter {
     } | undefined;
     protected lastSocketError?: Record<string, unknown> | undefined;
     protected pingInterval?: number | undefined;
+    private connectionOpenedAt?;
     protected abstract executeCommand(command: VideomailCommand): void;
     abstract isUserMediaLoaded(): boolean | undefined;
     abstract validate(): boolean;
@@ -28,6 +29,7 @@ declare abstract class RecorderConnection extends RecorderStreamWriter {
     private shouldReportStreamClose;
     private handleStreamClose;
     private shouldIgnoreStreamClose;
+    protected closeIdleConnection(reason: string): void;
     private handleStreamError;
     protected sendPings(): void;
     protected stopPings(): void;

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

@@ -40,7 +40,10 @@ declare class Visuals extends Despot {
     }): void;
     private clearCameraRecoveryNotice;
     recoverCamera(): Promise<boolean>;
-    resume(): void;
+    private canResumeCountdown;
+    private resumeCountdown;
+    resume(): Promise<void>;
+    private resumeFromControl;
     pauseOrResume(): void;
     recordOrStop(): void;
     getRecorder(): Recorder;
@@ -52,7 +55,7 @@ declare class Visuals extends Despot {
     } | undefined;
     getAudioSampleRate(): number | undefined;
     isPaused(): boolean | undefined;
-    error(err: VideomailError): void;
+    error(err: VideomailError, blocking?: boolean): void;
     hide(): void;
     isHidden(): boolean;
     showVisuals(): void;