videomail-client 16.4.0 → 16.5.0

package/README.md

@@ -13,9 +13,15 @@
 [netlify-image]: https://api.netlify.com/api/v1/badges/3c9df5b4-8b85-4081-950a-d5df2dbd9926/deploy-status
 [netlify-url]: https://app.netlify.com/sites/videomail-client/deploys
 
-Record webcam videos in contact forms.
+Bring Sign Language to your contact forms. ✉
 
-The client captures image frames with `navigator.mediaDevices.getUserMedia()`, streams them to the Videomail service over WebSocket, and receives an encoded video. No browser plugins are required. The package includes ESM, CommonJS, UMD, and TypeScript declaration builds.
+Record webcam videos without browser plugins:
+
+- Capture frames with `navigator.mediaDevices.getUserMedia()`.
+- Stream them to Videomail over WebSocket.
+- Get an encoded video back.
+
+Made for Deaf users, and for hearing users learning Sign Language. The package includes ESM, CommonJS, UMD, and TypeScript declaration builds.
 
 - [Live demo](#live-demo)
 - [Storybook examples](#storybook-examples)
@@ -36,9 +42,9 @@ Try it at [videomail-client.netlify.app](https://videomail-client.netlify.app).
 
 ### Real-world usage
 
-There is a full version with all its features on [videomail.io](https://videomail.io).
+Try the full experience at [videomail.io](https://videomail.io).
 
-And there is more:
+You can also find it on:
 
 - [https://wfdeaf.org/contact](https://wfdeaf.org/contact)
 - [https://www.deaf.org.nz/contact](https://www.deaf.org.nz/contact)
@@ -46,7 +52,7 @@ And there is more:
 
 ## Storybook examples
 
-To check out some examples in your browser locally, just run these two commands:
+To try the examples locally:
 
 1. `npm install`
 2. `npm run storybook`
@@ -114,7 +120,7 @@ const videomailClient = new VideomailClient({
 
 ### videomailClient.on()
 
-`VideomailClient` provides an event-emitter-style API. `on()` returns an unsubscribe function:
+Use `on()` to listen for events. It returns an unsubscribe function:
 
 ```ts
 videomailClient.on("FORM_READY", () => {
@@ -122,7 +128,7 @@ videomailClient.on("FORM_READY", () => {
 });
 
 videomailClient.on("SUBMITTED", ({ videomail, response }) => {
-  // Continue with application-specific submission handling.
+  // Handle the submitted video in your app.
 });
 ```
 
@@ -132,13 +138,13 @@ Check them out at [src/types/events/index.ts](https://github.com/binarykitchen/v
 
 Some events include typed parameters exported by the package.
 
-The client includes default visual error handling. Applications can also subscribe to the `ERROR` event for custom logging or recovery.
+The client shows errors by default. Listen for `ERROR` to add your own logging or recovery.
 
-Videomail errors extend the native `Error` class and include additional diagnostic data.
+Videomail errors extend the native `Error` class with details for troubleshooting.
 
 ### videomailClient.show()
 
-Automatically fills the DOM with a form for video recording. By default the HTML element with the ID `videomail` will be filled, see options.
+Adds the recording form to the page. By default, it uses the element with ID `videomail`. You can change this in the [options](#options).
 
 ### videomailClient.record()
 
@@ -146,19 +152,32 @@ Starts recording without requiring the user to press the record button.
 
 ### videomailClient.pause()
 
-Pauses an active recording or countdown without discarding it. Idle cameras and unsent previews are left alone. Useful for native applications. To resume, refer to the next function `videomailClient.recoverCamera()`.
+Pauses a recording or countdown without losing it. Leaves idle cameras and unsent previews alone.
+
+For native apps, pair this with `videomailClient.recoverCamera()` when the app returns to the foreground.
 
 ### videomailClient.recoverCamera()
 
-Returns a `Promise<boolean>` indicating whether camera recovery succeeds. It restores playback for live tracks or requests a replacement stream when camera or microphone tracks have ended. Duplicate calls share the pending recovery. An unbuilt client, unsent preview, encoding, or submission is left alone and returns `false`.
+Returns a `Promise<boolean>`: `true` if camera recovery succeeds.
+
+- Restarts playback for live tracks.
+- Requests a new stream if camera or microphone tracks have ended.
+- Shares pending recovery across duplicate calls.
+- Returns `false` without changes if the client is unbuilt, has an unsent preview, is encoding, or is submitting.
+
+Recovery keeps frame dimensions, frame/sample counts, and the audio sample rate. It does **not** resume recording or a countdown on its own. The user chooses Resume, which waits for recovery before sending more frames.
+
+With automatic pause enabled, hiding the page pauses recording. Returning to it recovers the camera. Native apps should call `pause()` when backgrounded and `recoverCamera()` when foregrounded. Wire these into your app's lifecycle; no Capacitor dependency is needed. Use recovery, not `startOver()`, to keep a paused take.
 
-Recovery preserves captured frame dimensions, frame/sample counters, and the audio sample rate. Foreground recovery never resumes capture or a countdown automatically. The user must explicitly choose Resume; that action waits for recovery before sending more frames.
+Recovery events:
 
-With automatic pause enabled, browser visibility changes pause capture and recover the camera on return. Native hosts should call `pause()` on background and `recoverCamera()` on foreground through their own lifecycle integration. The client has no Capacitor dependency. Do not call `startOver()` to recover a paused take.
+- `CAMERA_RECOVERING`: recovery has started.
+- `USER_MEDIA_READY` with `recovering: true`: the replacement stream is ready.
+- `CAMERA_RECOVERY_FAILED` with an `err`: access, playback, audio setup, or the recovery deadline failed.
 
-`CAMERA_RECOVERING` signals the start of recovery. `USER_MEDIA_READY` includes `recovering: true` after a replacement stream is initialized. `CAMERA_RECOVERY_FAILED` provides an `err` when access, playback, audio initialization, or the recovery deadline fails. The default notification does not reset the take; the user can retry Resume or stop to keep the recorded part. Stop, reset, unload, and submission cancel pending recovery, and late streams are stopped.
+The default failure notice keeps the take. Users can retry Resume or stop to keep what they recorded. Stop, reset, unload, and submission cancel pending recovery. Streams that arrive after cancellation are stopped.
 
-This does not reconnect a lost recording WebSocket or survive process termination. Physical-device camera and microphone validation remains necessary.
+Recovery cannot reconnect a lost recording WebSocket or keep a take after the app process ends. Test the camera and microphone on physical devices, too.
 
 ### videomailClient.replay(videomail[, parentElementId])
 
@@ -166,13 +185,13 @@ Adds a video player for the supplied videomail.
 
 If `replayParentElementId` is supplied, the player is inserted into that element. Otherwise, the client uses or creates a replay container within the configured container.
 
-Also note that, when the parent element already contains a video container like this
+If the parent already has a video element like this:
 
 ```html
 <video class="replay"></video>
 ```
 
-the client reuses it instead of creating another DOM element.
+The client reuses it. No extra element needed.
 
 ### videomailClient.startOver()
 
@@ -180,10 +199,10 @@ Resets the client and returns it to the ready state so the same instance can rec
 
 ### videomailClient.getByAlias(alias)
 
-Returns a videomail asynchronously for the given alias. You can obtain the alias from:
+Returns a videomail asynchronously for the given alias. Find the alias in:
 
-1. The form submission to your own server has it under `videomail_alias` in the form body.
-2. The `SUBMITTED` event payload.
+1. The `videomail_alias` field sent to your server.
+2. The `SUBMITTED` event data.
 
 ### videomailClient.getByKey(key)
 
@@ -199,15 +218,15 @@ Returns the videomail thread containing the given key.
 
 ### videomailClient.unload()
 
-Manually unloads the webcam, closes the active WebSocket connection, and removes all internal event listeners.
+Stops the webcam, closes the active WebSocket connection, and removes all internal event listeners.
 
 ### videomailClient.hide()
 
-Hides all the visuals (but does not unload anything).
+Hides the UI without unloading it.
 
 ### videomailClient.isDirty()
 
-Returns `true` when a video has been recorded but not submitted. This can be used before navigation to warn about an unsent recording.
+Returns `true` when a recorded video has not been submitted. Use it to warn users before they leave an unsent recording.
 
 ### videomailClient.isRecording()
 
@@ -219,21 +238,25 @@ Returns `true` after the client UI has been built and before it is unloaded.
 
 ### videomailClient.submit()
 
-Manually triggers submission when the client and form are valid. This is useful when another UI layer owns the visible submit control.
+Submits the form after client validation succeeds.
+
+With `enableAutoValidation: false`, no client validation event is needed. Your app must validate the form first. This helps when your app provides its own submit button.
 
 ### videomailClient.getLogLines()
 
-Returns the recently collected log lines when the configured logger supports collection.
+Returns recent log lines if your logger collects them.
 
 ### videomailClient.setLimitSeconds(limitSeconds)
 
-Updates the recording time limit for subsequent recording activity.
+Changes the time limit for further recording.
 
 ## Stored videomail data
 
-The `SUBMITTED` event includes a `videomail` object. The exact response can evolve, but its shape follows the exported `Videomail` type. A shortened example is shown below:
+The `SUBMITTED` event includes a `videomail` object. Its fields may evolve; check the exported `Videomail` type for the current shape.
+
+For new recordings, `width` and `height` describe the captured canvas frames. They are not the viewport or resized preview dimensions. They stay available after the camera stops and are replaced when you record again.
 
-For new recordings, submitted `width` and `height` describe the captured canvas frames, not the browser viewport or the resized preview. These dimensions survive stopping the camera and are replaced when recording again.
+Here's a shortened example:
 
 ```json
 {
@@ -276,7 +299,7 @@ You can also retrieve this data with `videomailClient.getByKey()`.
 
 ## Form Submissions
 
-How to configure, inject meta data and test form submissions with the Videomail client can be found in [Form Submissions ✏️](./docs/FORM_SUBMISSIONS.md).
+See [Form Submissions ✏️](./docs/FORM_SUBMISSIONS.md) to set up submissions, include metadata, and test your integration.
 
 ## Privacy and error reporting
 
@@ -284,13 +307,26 @@ Read about our privacy and error reporting practices in [Privacy and error repor
 
 ## Whitelist
 
-Examples work at [https://localhost:8443](https://localhost:8443) because localhost is allowed by the remote Videomail server. `https://localhost` and `https://localhost:443` are also available for local development. Other origins require their own whitelist entry.
+The examples work locally without extra setup. Videomail allows these development origins:
+
+- [https://localhost:8443](https://localhost:8443)
+- `https://localhost`
+- `https://localhost:443`
+
+Other origins need their own whitelist entry.
 
 For a deployed domain, request access at [videomail.io/whitelist](https://videomail.io/whitelist). You will receive a whitelist key for the approved origins.
 
 ## Browser compatibility
 
-Recording requires a secure context (`https://` or localhost) and support for `navigator.mediaDevices.getUserMedia()`, WebSocket, Canvas, and AudioWorklet when audio is enabled. Current evergreen desktop and mobile browsers are supported. Internet Explorer is not supported.
+Recording needs a secure context (`https://` or localhost), plus:
+
+- `navigator.mediaDevices.getUserMedia()`
+- WebSocket
+- Canvas
+- AudioWorklet, if audio is enabled
+
+Current evergreen desktop and mobile browsers are supported. Internet Explorer is not.
 
 See [Can I Use: Media Capture from DOM Elements](https://caniuse.com/stream) and test the [live demo](#live-demo) in the browsers required by your integration.
 
@@ -304,7 +340,7 @@ It extends the Ninja Forms form builder with a webcam input and submission integ
 
 ### Changelog
 
-A separate changelog is not maintained. Use `git log` or the [commit history](https://github.com/binarykitchen/videomail-client/commits/master).
+No separate changelog. Check `git log` or the [commit history](https://github.com/binarykitchen/videomail-client/commits/master).
 
 ### Noise
 
@@ -316,7 +352,7 @@ Videomail in the wild:
 
 This is just the beginning. I will add a lot more over time.
 
-Bear with me, there are lots of problems to crack, especially with the performance, audio part and some unit tests are missing. I do not want to waste too much time on perfection unless it's proven to work then I rewrite piece by piece.
+There's still work to do on performance, audio, and test coverage. We improve things piece by piece, rather than chase perfection in one big rewrite.
 
 ### Credits
 
@@ -336,8 +372,8 @@ They all deserve lots of love in return. Thank you so much.
 
 ### Code quality
 
-The project prioritizes stability and bug fixes over large rewrites. Its implementation has evolved several times as browser media APIs and integration requirements have changed.
+Stability and bug fixes come before big rewrites. The code keeps evolving with browser media APIs and the apps that use it.
 
 ### Final philosophy
 
-The primary goal is to make Sign Language easier to use in email and web forms.
+Make Sign Language at home in email and web forms. That's what we're here for.

package/dist/cjs/index.cjs

@@ -1,11 +1,11 @@
 var __webpack_modules__ = {
-    pJ (module, __webpack_exports__, __webpack_require__) {
+    eq (module, __webpack_exports__, __webpack_require__) {
         "use strict";
-        var _node_modules_rslib_core_node_modules_rsbuild_core_compiled_css_loader_noSourceMaps_js__rspack_import_1 = __webpack_require__("K7");
-        var _node_modules_rslib_core_node_modules_rsbuild_core_compiled_css_loader_noSourceMaps_js__rspack_import_1_default = /*#__PURE__*/ __webpack_require__.n(_node_modules_rslib_core_node_modules_rsbuild_core_compiled_css_loader_noSourceMaps_js__rspack_import_1);
-        var _node_modules_rslib_core_node_modules_rsbuild_core_compiled_css_loader_api_js__rspack_import_0 = __webpack_require__("Ly");
-        var _node_modules_rslib_core_node_modules_rsbuild_core_compiled_css_loader_api_js__rspack_import_0_default = /*#__PURE__*/ __webpack_require__.n(_node_modules_rslib_core_node_modules_rsbuild_core_compiled_css_loader_api_js__rspack_import_0);
-        var ___CSS_LOADER_EXPORT___ = _node_modules_rslib_core_node_modules_rsbuild_core_compiled_css_loader_api_js__rspack_import_0_default()(_node_modules_rslib_core_node_modules_rsbuild_core_compiled_css_loader_noSourceMaps_js__rspack_import_1_default());
+        var _node_modules_rsbuild_core_compiled_css_loader_noSourceMaps_js__rspack_import_1 = __webpack_require__("erX");
+        var _node_modules_rsbuild_core_compiled_css_loader_noSourceMaps_js__rspack_import_1_default = /*#__PURE__*/ __webpack_require__.n(_node_modules_rsbuild_core_compiled_css_loader_noSourceMaps_js__rspack_import_1);
+        var _node_modules_rsbuild_core_compiled_css_loader_api_js__rspack_import_0 = __webpack_require__("zm");
+        var _node_modules_rsbuild_core_compiled_css_loader_api_js__rspack_import_0_default = /*#__PURE__*/ __webpack_require__.n(_node_modules_rsbuild_core_compiled_css_loader_api_js__rspack_import_0);
+        var ___CSS_LOADER_EXPORT___ = _node_modules_rsbuild_core_compiled_css_loader_api_js__rspack_import_0_default()(_node_modules_rsbuild_core_compiled_css_loader_noSourceMaps_js__rspack_import_1_default());
         ___CSS_LOADER_EXPORT___.push([
             module.id,
             `@keyframes blink {
@@ -153,7 +153,7 @@ var __webpack_modules__ = {
         });
     },
     b6 (module, exports1, __webpack_require__) {
-        var EventEmitter = __webpack_require__("qU").EventEmitter, inherits = __webpack_require__("c5"), raf = __webpack_require__("jY"), methods;
+        var EventEmitter = __webpack_require__("q").EventEmitter, inherits = __webpack_require__("c5"), raf = __webpack_require__("jY"), methods;
         var defaultRAFObject = {
             requestAnimationFrame: raf,
             cancelAnimationFrame: raf.cancel
@@ -1831,7 +1831,7 @@ var __webpack_modules__ = {
     },
     xF (module, __unused_rspack_exports, __webpack_require__) {
         "use strict";
-        var document1 = __webpack_require__("gM");
+        var document1 = __webpack_require__("g");
         var Event1 = __webpack_require__("cE");
         var Keys = __webpack_require__("Dy");
         module.exports = Visibility;
@@ -2186,7 +2186,7 @@ var __webpack_modules__ = {
         var isArray = __webpack_require__("ab");
         var Duplex;
         Readable.ReadableState = ReadableState;
-        __webpack_require__("qU").EventEmitter;
+        __webpack_require__("q").EventEmitter;
         var EElistenerCount = function(emitter, type) {
             return emitter.listeners(type).length;
         };
@@ -3450,7 +3450,7 @@ var __webpack_modules__ = {
         };
     },
     tb (module, __unused_rspack_exports, __webpack_require__) {
-        module.exports = __webpack_require__("qU").EventEmitter;
+        module.exports = __webpack_require__("q").EventEmitter;
     },
     GB (module, exports1, __webpack_require__) {
         exports1 = module.exports = __webpack_require__("rp");
@@ -3847,7 +3847,7 @@ var __webpack_modules__ = {
         "use strict";
         module.exports = Object;
     },
-    qU (module) {
+    q (module) {
         "use strict";
         var R = 'object' == typeof Reflect ? Reflect : null;
         var ReflectApply = R && 'function' == typeof R.apply ? R.apply : function(target, receiver, args) {
@@ -4897,7 +4897,7 @@ var __webpack_modules__ = {
             return tuple.listen;
         }
     },
-    gM (module, __unused_rspack_exports, __webpack_require__) {
+    g (module, __unused_rspack_exports, __webpack_require__) {
         var topLevel = void 0 !== __webpack_require__.g ? __webpack_require__.g : "u" > typeof window ? window : {};
         var minDoc = __webpack_require__("MM");
         var doccy;
@@ -8811,7 +8811,7 @@ var __webpack_modules__ = {
         var isArray = __webpack_require__("N3");
         var Duplex;
         Readable.ReadableState = ReadableState;
-        __webpack_require__("qU").EventEmitter;
+        __webpack_require__("q").EventEmitter;
         var EElistenerCount = function(emitter, type) {
             return emitter.listeners(type).length;
         };
@@ -8830,7 +8830,7 @@ var __webpack_modules__ = {
         var debug = void 0;
         debug = debugUtil && debugUtil.debuglog ? debugUtil.debuglog('stream') : function() {};
         var BufferList = __webpack_require__("aI");
-        var destroyImpl = __webpack_require__("R");
+        var destroyImpl = __webpack_require__("R5");
         var StringDecoder;
         util.inherits(Readable, Stream);
         var kProxyEvents = [
@@ -9565,7 +9565,7 @@ var __webpack_modules__ = {
         function _isUint8Array(obj) {
             return Buffer.isBuffer(obj) || obj instanceof OurUint8Array;
         }
-        var destroyImpl = __webpack_require__("R");
+        var destroyImpl = __webpack_require__("R5");
         util.inherits(Writable, Stream);
         function nop() {}
         function WritableState(options, stream) {
@@ -10019,7 +10019,7 @@ var __webpack_modules__ = {
             return this.constructor.name + ' ' + obj;
         };
     },
-    R (module, __unused_rspack_exports, __webpack_require__) {
+    R5 (module, __unused_rspack_exports, __webpack_require__) {
         "use strict";
         var pna = __webpack_require__("sj");
         function destroy(err, cb) {
@@ -10075,7 +10075,7 @@ var __webpack_modules__ = {
         };
     },
     O (module, __unused_rspack_exports, __webpack_require__) {
-        module.exports = __webpack_require__("qU").EventEmitter;
+        module.exports = __webpack_require__("q").EventEmitter;
     },
     Fo (module, exports1, __webpack_require__) {
         exports1 = module.exports = __webpack_require__("w");
@@ -10565,7 +10565,7 @@ var __webpack_modules__ = {
     a () {},
     Av () {},
     eD () {},
-    Ly (module) {
+    zm (module) {
         "use strict";
         module.exports = function(cssWithMappingToString) {
             var list = [];
@@ -10619,13 +10619,13 @@ var __webpack_modules__ = {
             return list;
         };
     },
-    K7 (module) {
+    erX (module) {
         "use strict";
         module.exports = function(i) {
             return i[1];
         };
     },
-    q (module) {
+    R (module) {
         "use strict";
         var stylesInDOM = [];
         function getIndexByIdentifier(identifier) {
@@ -10704,7 +10704,7 @@ var __webpack_modules__ = {
             };
         };
     },
-    f (module) {
+    uZ (module) {
         "use strict";
         var memo = {};
         function getTarget(target) {
@@ -10726,7 +10726,7 @@ var __webpack_modules__ = {
         }
         module.exports = insertBySelector;
     },
-    z7 (module) {
+    mK (module) {
         "use strict";
         function insertStyleElement(options) {
             var element = document.createElement("style");
@@ -10736,7 +10736,7 @@ var __webpack_modules__ = {
         }
         module.exports = insertStyleElement;
     },
-    g (module, __unused_rspack_exports, __webpack_require__) {
+    kU (module, __unused_rspack_exports, __webpack_require__) {
         "use strict";
         function setAttributesWithoutAttributes(styleElement) {
             var nonce = __webpack_require__.nc;
@@ -10744,7 +10744,7 @@ var __webpack_modules__ = {
         }
         module.exports = setAttributesWithoutAttributes;
     },
-    V (module) {
+    Bd (module) {
         "use strict";
         function apply(styleElement, options, obj) {
             var css = "";
@@ -10781,7 +10781,7 @@ var __webpack_modules__ = {
         }
         module.exports = domAPI;
     },
-    AD (module) {
+    snK (module) {
         "use strict";
         function styleTagTransform(css, styleElement) {
             if (styleElement.styleSheet) styleElement.styleSheet.cssText = css;
@@ -11126,7 +11126,7 @@ var __webpack_exports__ = {};
     var client = __webpack_require__("Q");
     var client_default = /*#__PURE__*/ __webpack_require__.n(client);
     var package_namespaceObject = {
-        rE: "16.4.0"
+        rE: "16.5.0"
     };
     function isAudioEnabled(options) {
         return Boolean(options.audio.enabled);
@@ -14656,12 +14656,12 @@ var __webpack_exports__ = {};
         const errName = null != (_ref = null == err ? void 0 : err.name) ? _ref : null == err ? void 0 : err.constructor.name;
         switch(errName){
             case error_VideomailError.SECURITY_ERROR:
-                message = "The operation was insecure";
-                explanation = "Probably you have disallowed Cookies for this page?";
+                message = "Your browser blocked this action";
+                explanation = "Check this page's camera permissions and security settings.";
                 classList.push(error_VideomailError.BROWSER_PROBLEM);
                 break;
             case error_VideomailError.OVERCONSTRAINED:
-                message = "Invalid webcam constraints";
+                message = "Your webcam cannot use these settings";
                 if (err && "constraint" in err) {
                     const overconstrainedError = err;
                     const constraint = overconstrainedError.constraint;
@@ -14672,64 +14672,64 @@ var __webpack_exports__ = {};
                 break;
             case "MediaDeviceFailedDueToShutdown":
                 message = "Webcam is shutting down";
-                explanation = "This happens your webcam is already switching off and not giving you permission to use it.";
+                explanation = "Wait for your webcam to finish switching off, then try again.";
                 break;
             case "SourceUnavailableError":
-                message = "Source of your webcam cannot be accessed";
-                explanation = "Probably it is locked from another process or has a hardware error.";
+                message = "Cannot access your webcam";
+                explanation = "Another app may be using it, or there may be a hardware problem.";
                 break;
             case "NO_DEVICES_FOUND":
                 if (audioEnabled) {
-                    message = "No webcam nor microphone found";
-                    explanation = "Your browser cannot find a webcam with microphone attached to your machine.";
+                    message = "No webcam or microphone found";
+                    explanation = "Check that your webcam and microphone are connected.";
                 } else {
                     message = "No webcam found";
-                    explanation = "Your browser cannot find a webcam attached to your machine.";
+                    explanation = "Check that your webcam is connected.";
                 }
                 classList.push(error_VideomailError.WEBCAM_PROBLEM);
                 break;
             case "PermissionDismissedError":
-                message = "Ooops, you didn't give me any permissions?";
-                explanation = "Looks like you skipped the webcam permission dialogue.<br/>Please grant access next time the dialogue appears.";
+                message = "Camera permission is needed";
+                explanation = "The camera permission prompt was closed.<br/>Please allow access when it appears again.";
                 classList.push(error_VideomailError.WEBCAM_PROBLEM);
                 break;
             case error_VideomailError.NOT_ALLOWED_ERROR:
             case error_VideomailError.PERMISSION_DENIED:
             case "PermissionDeniedError":
                 message = "Permission denied";
-                explanation = "Cannot access your webcam. This can have two reasons:<br/>a) you blocked access to webcam; or<br/>b) your webcam is already in use.";
+                explanation = "We cannot access your webcam. Check these possibilities:<ul><li>Camera access is blocked in your browser settings.</li><li>Another app is using your webcam.</li></ul>";
                 classList.push(error_VideomailError.WEBCAM_PROBLEM);
                 break;
             case "HARDWARE_UNAVAILABLE":
             case "AbortError":
                 message = "Webcam is unavailable";
-                explanation = "Maybe it is already busy in another window?";
+                explanation = "Another window may be using it. Close it and try again.";
                 classList.push(error_VideomailError.WEBCAM_PROBLEM);
                 break;
             case "NO_VIDEO_FEED":
-                message = "No video feed found!";
-                explanation = "Your webcam is already used in another browser.";
+                message = "No video feed found";
+                explanation = "Another browser may be using your webcam.";
                 classList.push(error_VideomailError.WEBCAM_PROBLEM);
                 break;
             case error_VideomailError.STARTING_FAILED:
-                message = "Starting video failed";
-                explanation = "Most likely this happens when the webcam is already active in another browser";
+                message = "Could not start recording";
+                explanation = "Another browser may be using your webcam.";
                 classList.push(error_VideomailError.WEBCAM_PROBLEM);
                 break;
             case "DevicesNotFoundError":
-                message = "No available webcam could be found";
-                explanation = "Looks like you do not have any webcam attached to your machine; or the one you plugged in is already used.";
+                message = "No available webcam found";
+                explanation = "Check that your webcam is connected and not being used by another app.";
                 classList.push(error_VideomailError.WEBCAM_PROBLEM);
                 break;
             case error_VideomailError.NOT_READABLE_ERROR:
             case error_VideomailError.TRACK_START_ERROR:
-                message = "No access to webcam";
-                explanation = "Perhaps you are already using it in another browser?";
+                message = "Cannot access your webcam";
+                explanation = "Another browser may be using it. Close it and try again.";
                 classList.push(error_VideomailError.WEBCAM_PROBLEM);
                 break;
             case error_VideomailError.INVALID_STATE_ERROR:
-                message = "Invalid state";
-                explanation = "Video recording stream from your webcam already has finished";
+                message = "Your camera stream has ended";
+                explanation = "The webcam stream is no longer active.";
                 classList.push(error_VideomailError.WEBCAM_PROBLEM);
                 break;
             case error_VideomailError.DOM_EXCEPTION:
@@ -15832,19 +15832,19 @@ var __webpack_exports__ = {};
         return newOptions;
     }
     const options_mergeWithDefaultOptions = mergeWithDefaultOptions;
-    var injectStylesIntoStyleTag = __webpack_require__("q");
+    var injectStylesIntoStyleTag = __webpack_require__("R");
     var injectStylesIntoStyleTag_default = /*#__PURE__*/ __webpack_require__.n(injectStylesIntoStyleTag);
-    var styleDomAPI = __webpack_require__("V");
+    var styleDomAPI = __webpack_require__("Bd");
     var styleDomAPI_default = /*#__PURE__*/ __webpack_require__.n(styleDomAPI);
-    var insertBySelector = __webpack_require__("f");
+    var insertBySelector = __webpack_require__("uZ");
     var insertBySelector_default = /*#__PURE__*/ __webpack_require__.n(insertBySelector);
-    var setAttributesWithoutAttributes = __webpack_require__("g");
+    var setAttributesWithoutAttributes = __webpack_require__("kU");
     var setAttributesWithoutAttributes_default = /*#__PURE__*/ __webpack_require__.n(setAttributesWithoutAttributes);
-    var insertStyleElement = __webpack_require__("z7");
+    var insertStyleElement = __webpack_require__("mK");
     var insertStyleElement_default = /*#__PURE__*/ __webpack_require__.n(insertStyleElement);
-    var styleTagTransform = __webpack_require__("AD");
+    var styleTagTransform = __webpack_require__("snK");
     var styleTagTransform_default = /*#__PURE__*/ __webpack_require__.n(styleTagTransform);
-    var main = __webpack_require__("pJ");
+    var main = __webpack_require__("eq");
     var main_options = {};
     main_options.styleTagTransform = styleTagTransform_default();
     main_options.setAttributes = setAttributesWithoutAttributes_default();
@@ -19970,11 +19970,11 @@ var __webpack_exports__ = {};
     const connection = RecorderConnection;
     function createUserMediaConstraints({ options, facingMode, limitedWidth, userMediaParams }) {
         const video = {
+            facingMode: (null == userMediaParams ? void 0 : userMediaParams.switchingFacingMode) || facingMode,
             frameRate: {
                 ideal: options.video.fps
             }
         };
-        if ((null == userMediaParams ? void 0 : userMediaParams.switchingFacingMode) || (null == userMediaParams ? void 0 : userMediaParams.recovering)) video.facingMode = userMediaParams.switchingFacingMode || facingMode;
         if (options.video.width) video.width = {
             ideal: options.video.width
         };
@@ -21274,10 +21274,7 @@ var __webpack_exports__ = {};
         "droidcam"
     ];
     function isVirtualCamera(videoTrack) {
-        const capabilities = videoTrack.getCapabilities();
-        if (!capabilities.frameRate) return true;
-        const isVirtual = VIRTUAL_KEYWORDS.some((keyword)=>videoTrack.label.toLowerCase().includes(keyword));
-        return isVirtual;
+        return VIRTUAL_KEYWORDS.some((keyword)=>videoTrack.label.toLowerCase().includes(keyword));
     }
     const util_isVirtualCamera = isVirtualCamera;
     function userMedia_asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
@@ -21721,7 +21718,7 @@ var __webpack_exports__ = {};
                             let explanation = "(No explanation given)";
                             if (null == (_command_args = command.args) ? void 0 : null == (_command_args_err = _command_args.err) ? void 0 : _command_args_err.message) explanation = command.args.err.message;
                             const err = error_createError({
-                                message: "Websocket error from Videomail server",
+                                message: "WebSocket error from the Videomail server",
                                 explanation,
                                 err: deserializeError(null == (_command_args1 = command.args) ? void 0 : _command_args1.err),
                                 options: this.options
@@ -23031,7 +23028,7 @@ var __webpack_exports__ = {};
         submit() {
             return container_async_to_generator(function*() {
                 this.options.logger.debug("Container: submit()");
-                if (this.lastValidation) {
+                if (!this.options.enableAutoValidation || this.lastValidation) {
                     var _this_form;
                     return yield null == (_this_form = this.form) ? void 0 : _this_form.doTheSubmit();
                 }