videomail-client 15.7.13 → 15.7.15

package/dist/cjs/index.cjs

@@ -1832,7 +1832,7 @@ var __webpack_modules__ = {
     xF (module, __unused_rspack_exports, __webpack_require__) {
         "use strict";
         var document1 = __webpack_require__("g");
-        var Event = __webpack_require__("cE");
+        var Event1 = __webpack_require__("cE");
         var Keys = __webpack_require__("Dy");
         module.exports = Visibility;
         function Visibility() {
@@ -1840,7 +1840,7 @@ var __webpack_modules__ = {
             if (!keys) return noopShim();
             return {
                 visible: visible,
-                onChange: Event(listen)
+                onChange: Event1(listen)
             };
             function visible() {
                 return !document1[keys.hidden];
@@ -4404,7 +4404,7 @@ var __webpack_modules__ = {
         var abs = __webpack_require__("G");
         var floor = __webpack_require__("t");
         var max = __webpack_require__("u");
-        var min = __webpack_require__("Y");
+        var min = __webpack_require__("Yx");
         var pow = __webpack_require__("Ik");
         var round = __webpack_require__("W");
         var sign = __webpack_require__("Xe");
@@ -4868,8 +4868,8 @@ var __webpack_modules__ = {
         } : null;
     },
     Ne (module) {
-        module.exports = Event;
-        function Event() {
+        module.exports = Event1;
+        function Event1() {
             var listeners = [];
             return {
                 broadcast: broadcast,
@@ -4889,10 +4889,10 @@ var __webpack_modules__ = {
         }
     },
     cE (module, __unused_rspack_exports, __webpack_require__) {
-        var Event = __webpack_require__("Ne");
+        var Event1 = __webpack_require__("Ne");
         module.exports = Source;
         function Source(broadcaster) {
-            var tuple = Event();
+            var tuple = Event1();
             broadcaster(tuple.broadcast);
             return tuple.listen;
         }
@@ -5280,7 +5280,7 @@ var __webpack_modules__ = {
         "use strict";
         module.exports = Math.max;
     },
-    Y (module) {
+    Yx (module) {
         "use strict";
         module.exports = Math.min;
     },
@@ -6783,7 +6783,7 @@ var __webpack_modules__ = {
             return fn;
         };
     },
-    x5 (module, __unused_rspack_exports, __webpack_require__) {
+    x (module, __unused_rspack_exports, __webpack_require__) {
         "use strict";
         var inspect = __webpack_require__("L");
         var $TypeError = __webpack_require__("N");
@@ -6944,7 +6944,7 @@ var __webpack_modules__ = {
         "use strict";
         var $TypeError = __webpack_require__("N");
         var inspect = __webpack_require__("L");
-        var getSideChannelList = __webpack_require__("x5");
+        var getSideChannelList = __webpack_require__("x");
         var getSideChannelMap = __webpack_require__("J");
         var getSideChannelWeakMap = __webpack_require__("c");
         var makeChannel = getSideChannelWeakMap || getSideChannelMap || getSideChannelList;
@@ -10970,7 +10970,7 @@ var __webpack_exports__ = {};
     var client = __webpack_require__("Q");
     var client_default = /*#__PURE__*/ __webpack_require__.n(client);
     var package_namespaceObject = {
-        rE: "15.7.13"
+        rE: "15.7.15"
     };
     function isAudioEnabled(options) {
         return Boolean(options.audio.enabled);
@@ -10984,6 +10984,52 @@ var __webpack_exports__ = {};
     }
     var util = __webpack_require__("S");
     var util_default = /*#__PURE__*/ __webpack_require__.n(util);
+    function getEventDetails(event) {
+        const eventWithErrorDetails = event;
+        const details = {
+            constructor: event.constructor.name,
+            type: event.type,
+            isTrusted: event.isTrusted,
+            bubbles: event.bubbles,
+            cancelable: event.cancelable,
+            composed: event.composed,
+            defaultPrevented: event.defaultPrevented,
+            eventPhase: event.eventPhase,
+            timeStamp: event.timeStamp,
+            returnValue: eventWithErrorDetails.returnValue,
+            cancelBubble: eventWithErrorDetails.cancelBubble
+        };
+        for (const property of [
+            "message",
+            "filename",
+            "lineno",
+            "colno"
+        ]){
+            const value = eventWithErrorDetails[property];
+            if (void 0 !== value) details[property] = value;
+        }
+        if (eventWithErrorDetails.error instanceof Error) details.error = serializeError(eventWithErrorDetails.error);
+        if (event.target) {
+            const target = event.target;
+            const targetDetails = {
+                constructor: target.constructor.name
+            };
+            for (const property of [
+                "url",
+                "readyState",
+                "protocol",
+                "extensions",
+                "binaryType",
+                "bufferedAmount"
+            ]){
+                const value = target[property];
+                if (void 0 !== value) targetDetails[property] = value;
+            }
+            details.target = targetDetails;
+        }
+        return details;
+    }
+    const error_getEventDetails = getEventDetails;
     function inspect(element) {
         return util_default().inspect(element, {
             colors: false,
@@ -10999,6 +11045,7 @@ var __webpack_exports__ = {};
             else if (anything.className) return `.${anything.className}`;
             return "(No HTML identifier available)";
         }
+        if ("u" > typeof Event && anything instanceof Event) return inspect(error_getEventDetails(anything));
         return inspect(anything);
     }
     const util_pretty = pretty;
@@ -17006,6 +17053,18 @@ var __webpack_exports__ = {};
         return /bot|crawler|spider|headlesschrome|phantomjs|puppeteer|playwright/iu.test(userAgent);
     }
     const util_isAutomatedUserAgent = isAutomatedUserAgent;
+    function summarize(title, contents) {
+        const lines = Object.entries(contents).sort(([keyA], [keyB])=>keyA.localeCompare(keyB)).map(([key, value])=>{
+            const formattedValue = void 0 === value ? "undefined" : "object" == typeof value ? util_pretty(value) : value;
+            return `  • ${key}: ${formattedValue}`;
+        });
+        const line = [
+            `🔎 ${title}`,
+            ...lines
+        ].join("\n");
+        return line;
+    }
+    const util_summarize = summarize;
     function esm_define_property(obj, key, value) {
         if (key in obj) Object.defineProperty(obj, key, {
             value: value,
@@ -17596,7 +17655,6 @@ var __webpack_exports__ = {};
             this.connectionTimeout = void 0;
         }
         failConnection(params) {
-            var _ref, _this_unloaded, _this_userMediaLoaded, _ref1;
             if (this.connectionFailed || this.connected || this.unloaded) return;
             this.connectionFailed = true;
             this.connecting = false;
@@ -17605,24 +17663,25 @@ var __webpack_exports__ = {};
             const online = navigator.onLine;
             const elapsedMs = this.connectingStartedAt ? Date.now() - this.connectingStartedAt : void 0;
             const closeEvent = this.lastCloseEvent;
-            const diagnosticLines = [
-                `  • cause: ${cause}`,
-                `  • closeCode: ${null != (_ref = null == closeEvent ? void 0 : closeEvent.code) ? _ref : "undefined"}`,
-                `  • closeReason: ${(null == closeEvent ? void 0 : closeEvent.reason) || "undefined"}`,
-                `  • elapsedMs: ${null != elapsedMs ? elapsedMs : "undefined"}`,
-                `  • online: ${online}`,
-                `  • unloaded: ${null != (_this_unloaded = this.unloaded) ? _this_unloaded : "undefined"}`,
-                `  • userMediaLoaded: ${null != (_this_userMediaLoaded = this.userMediaLoaded) ? _this_userMediaLoaded : "undefined"}`,
-                `  • userMediaLoading: ${this.userMediaLoading}`,
-                `  • wasClean: ${null != (_ref1 = null == closeEvent ? void 0 : closeEvent.wasClean) ? _ref1 : "undefined"}`
-            ];
-            const debugLine = [
-                "🔎 Recorder: failConnection() diagnostic",
-                ...diagnosticLines
-            ].join("\n");
+            const socketError = this.lastSocketError;
+            const contents = {
+                cause,
+                closeCode: null == closeEvent ? void 0 : closeEvent.code,
+                closeReason: null == closeEvent ? void 0 : closeEvent.reason,
+                elapsedMs,
+                online,
+                unloaded: this.unloaded,
+                userMediaLoaded: this.userMediaLoaded,
+                userMediaLoading: this.userMediaLoading,
+                wasClean: null == closeEvent ? void 0 : closeEvent.wasClean,
+                socketError,
+                blocking: this.blocking
+            };
+            const debugLine = util_summarize("Recorder: failConnection() diagnostic", contents);
             this.options.logger.debug(debugLine);
             let explanation;
             if (online) if ("timeout" === cause) explanation = `The server at ${url2Connect} did not respond within ${this.options.timeouts.connection}ms, even though your device is online. This usually points to a firewall or proxy silently dropping the connection. Please try a different network. If the problem persists, contact us.`;
+            else if ("error" === cause) explanation = `An error occurred while connecting to ${url2Connect}. Please check your internet connection and try again. If the problem persists, contact us.`;
             else {
                 const closeSuffix = closeEvent ? ` (code ${closeEvent.code})` : "";
                 explanation = `Connection to ${url2Connect} is closed${closeSuffix}. Please check your internet connection and try again. If the problem persists, contact us.`;
@@ -17635,7 +17694,10 @@ var __webpack_exports__ = {};
             const err = error_createError({
                 message: "Unable to connect to the server",
                 explanation,
-                options: this.options
+                options: this.options,
+                exc: socketError ? new Error("WebSocket connection error", {
+                    cause: socketError
+                }) : void 0
             });
             this.emit("ERROR", {
                 err
@@ -17721,6 +17783,7 @@ var __webpack_exports__ = {};
                 this.connectionFailed = false;
                 this.connectingStartedAt = Date.now();
                 this.lastCloseEvent = void 0;
+                this.lastSocketError = void 0;
                 this.emit("CONNECTING");
                 let url2Connect;
                 try {
@@ -17751,6 +17814,9 @@ var __webpack_exports__ = {};
                             wasClean: event.wasClean
                         };
                     });
+                    nativeSocket.addEventListener("error", (event)=>{
+                        this.lastSocketError = error_getEventDetails(event);
+                    });
                 } catch (exc) {
                     this.connecting = this.connected = false;
                     const diagnostic = error_getWebSocketDiagnostic(url2Connect);
@@ -17790,11 +17856,17 @@ var __webpack_exports__ = {};
                         });
                     }, connectionTimeoutMs);
                     this.stream.on("close", ()=>{
-                        this.options.logger.debug(`${PIPE_SYMBOL}Stream has closed, connecting=${this.connecting}, connected=${this.connected}, userMediaLoaded=${this.userMediaLoaded}`);
+                        const debugLine = util_summarize(`${PIPE_SYMBOL}Stream has closed:`, {
+                            connecting: this.connecting,
+                            connected: this.connected,
+                            userMediaLoaded: this.userMediaLoaded,
+                            blocking: this.blocking
+                        });
+                        this.options.logger.debug(debugLine);
                         const tryReconnect = this.connected && this.userMediaLoaded;
                         this.connected = false;
                         if (tryReconnect) this.initSocket();
-                        else if (!this.connecting) window.setTimeout(()=>{
+                        else if (!this.connecting && !this.blocking) window.setTimeout(()=>{
                             this.failConnection({
                                 url2Connect,
                                 cause: "closed"
@@ -17832,7 +17904,28 @@ var __webpack_exports__ = {};
                         }
                     });
                     this.stream.on("error", (err)=>{
-                        this.options.logger.debug(`${PIPE_SYMBOL}Stream *error* event emitted: ${util_pretty(err)}`);
+                        var _this_lastSocketError;
+                        if ("u" > typeof Event && err instanceof Event) this.lastSocketError = error_getEventDetails(err);
+                        else this.lastSocketError = serializeError(err);
+                        const debugLine = util_summarize(`${PIPE_SYMBOL}Stream *error* event emitted:`, {
+                            error: serializeError(err)
+                        });
+                        this.options.logger.debug(debugLine);
+                        if (!this.connected) return void this.failConnection({
+                            url2Connect,
+                            cause: "error"
+                        });
+                        const streamError = err instanceof Error ? err : new Error("WebSocket stream emitted an error event", {
+                            cause: null != (_this_lastSocketError = this.lastSocketError) ? _this_lastSocketError : err
+                        });
+                        this.emit("ERROR", {
+                            err: error_createError({
+                                message: "WebSocket stream error",
+                                explanation: `The WebSocket stream emitted an error event. Details: ${util_pretty(err)}`,
+                                options: this.options,
+                                exc: streamError
+                            })
+                        });
                     });
                     this.stream.on("drain", ()=>{
                         this.options.logger.debug(`${PIPE_SYMBOL}Stream *drain* event emitted (should not happen!)`);
@@ -18000,8 +18093,10 @@ var __webpack_exports__ = {};
         executeCommand(command) {
             if (this.unloaded) return;
             try {
-                if (command.args) this.options.logger.debug(`Server commanded: ${command.command} with ${util_pretty(command.args)}`);
-                else this.options.logger.debug(`Server commanded: ${command.command}`);
+                if (command.args) {
+                    const debugLine = util_summarize(`Server commanded: ${command.command} with:`, command.args);
+                    this.options.logger.debug(debugLine);
+                } else this.options.logger.debug(`Server commanded: ${command.command}`);
                 switch(command.command){
                     case "ready":
                         this.emit("SERVER_READY");
@@ -18581,7 +18676,7 @@ var __webpack_exports__ = {};
             return this.userMediaLoaded;
         }
         constructor(visuals, replay, options){
-            super("Recorder", options), recorder_define_property(this, "visuals", void 0), recorder_define_property(this, "replay", void 0), recorder_define_property(this, "loop", void 0), recorder_define_property(this, "originalAnimationFrameObject", void 0), recorder_define_property(this, "samplesCount", 0), recorder_define_property(this, "framesCount", 0), recorder_define_property(this, "recordingStats", void 0), recorder_define_property(this, "confirmedFrameNumber", 0), recorder_define_property(this, "confirmedSampleNumber", 0), recorder_define_property(this, "recorderElement", void 0), recorder_define_property(this, "userMedia", void 0), recorder_define_property(this, "userMediaTimeout", void 0), recorder_define_property(this, "retryTimeout", void 0), recorder_define_property(this, "connectionTimeout", void 0), recorder_define_property(this, "frameProgress", void 0), recorder_define_property(this, "sampleProgress", void 0), recorder_define_property(this, "canvas", void 0), recorder_define_property(this, "ctx", void 0), recorder_define_property(this, "userMediaLoaded", void 0), recorder_define_property(this, "userMediaLoading", false), recorder_define_property(this, "submitting", false), recorder_define_property(this, "unloaded", void 0), recorder_define_property(this, "stopTime", void 0), recorder_define_property(this, "stream", void 0), recorder_define_property(this, "connecting", false), recorder_define_property(this, "connected", false), recorder_define_property(this, "connectionFailed", false), recorder_define_property(this, "blocking", false), recorder_define_property(this, "built", false), recorder_define_property(this, "key", void 0), recorder_define_property(this, "waitingTime", void 0), recorder_define_property(this, "connectingStartedAt", void 0), recorder_define_property(this, "lastCloseEvent", void 0), recorder_define_property(this, "pingInterval", void 0), recorder_define_property(this, "frame", void 0), recorder_define_property(this, "recordingBuffer", void 0), recorder_define_property(this, "facingMode", void 0);
+            super("Recorder", options), recorder_define_property(this, "visuals", void 0), recorder_define_property(this, "replay", void 0), recorder_define_property(this, "loop", void 0), recorder_define_property(this, "originalAnimationFrameObject", void 0), recorder_define_property(this, "samplesCount", 0), recorder_define_property(this, "framesCount", 0), recorder_define_property(this, "recordingStats", void 0), recorder_define_property(this, "confirmedFrameNumber", 0), recorder_define_property(this, "confirmedSampleNumber", 0), recorder_define_property(this, "recorderElement", void 0), recorder_define_property(this, "userMedia", void 0), recorder_define_property(this, "userMediaTimeout", void 0), recorder_define_property(this, "retryTimeout", void 0), recorder_define_property(this, "connectionTimeout", void 0), recorder_define_property(this, "frameProgress", void 0), recorder_define_property(this, "sampleProgress", void 0), recorder_define_property(this, "canvas", void 0), recorder_define_property(this, "ctx", void 0), recorder_define_property(this, "userMediaLoaded", void 0), recorder_define_property(this, "userMediaLoading", false), recorder_define_property(this, "submitting", false), recorder_define_property(this, "unloaded", void 0), recorder_define_property(this, "stopTime", void 0), recorder_define_property(this, "stream", void 0), recorder_define_property(this, "connecting", false), recorder_define_property(this, "connected", false), recorder_define_property(this, "connectionFailed", false), recorder_define_property(this, "blocking", false), recorder_define_property(this, "built", false), recorder_define_property(this, "key", void 0), recorder_define_property(this, "waitingTime", void 0), recorder_define_property(this, "connectingStartedAt", void 0), recorder_define_property(this, "lastCloseEvent", void 0), recorder_define_property(this, "lastSocketError", void 0), recorder_define_property(this, "pingInterval", void 0), recorder_define_property(this, "frame", void 0), recorder_define_property(this, "recordingBuffer", void 0), recorder_define_property(this, "facingMode", void 0);
             this.visuals = visuals;
             this.replay = replay;
             this.facingMode = options.video.facingMode;

package/dist/esm/index.js

@@ -3619,7 +3619,7 @@ const constants = {
     }
 };
 var package_namespaceObject = {
-    rE: "15.7.13"
+    rE: "15.7.15"
 };
 function isAudioEnabled(options) {
     return Boolean(options.audio.enabled);
@@ -3631,6 +3631,52 @@ function setAudioEnabled(enabled, options) {
 function isAutoPauseEnabled(options) {
     return options.enableAutoPause && options.enablePause;
 }
+function getEventDetails(event) {
+    const eventWithErrorDetails = event;
+    const details = {
+        constructor: event.constructor.name,
+        type: event.type,
+        isTrusted: event.isTrusted,
+        bubbles: event.bubbles,
+        cancelable: event.cancelable,
+        composed: event.composed,
+        defaultPrevented: event.defaultPrevented,
+        eventPhase: event.eventPhase,
+        timeStamp: event.timeStamp,
+        returnValue: eventWithErrorDetails.returnValue,
+        cancelBubble: eventWithErrorDetails.cancelBubble
+    };
+    for (const property of [
+        "message",
+        "filename",
+        "lineno",
+        "colno"
+    ]){
+        const value = eventWithErrorDetails[property];
+        if (void 0 !== value) details[property] = value;
+    }
+    if (eventWithErrorDetails.error instanceof Error) details.error = serializeError(eventWithErrorDetails.error);
+    if (event.target) {
+        const target = event.target;
+        const targetDetails = {
+            constructor: target.constructor.name
+        };
+        for (const property of [
+            "url",
+            "readyState",
+            "protocol",
+            "extensions",
+            "binaryType",
+            "bufferedAmount"
+        ]){
+            const value = target[property];
+            if (void 0 !== value) targetDetails[property] = value;
+        }
+        details.target = targetDetails;
+    }
+    return details;
+}
+const error_getEventDetails = getEventDetails;
 const util = __webpack_require__("Sy");
 var util_default = /*#__PURE__*/ __webpack_require__.n(util);
 function inspect(element) {
@@ -3648,6 +3694,7 @@ function pretty(anything) {
         else if (anything.className) return `.${anything.className}`;
         return "(No HTML identifier available)";
     }
+    if ("u" > typeof Event && anything instanceof Event) return inspect(error_getEventDetails(anything));
     return inspect(anything);
 }
 const util_pretty = pretty;
@@ -6073,6 +6120,18 @@ function isAutomatedUserAgent(userAgent = navigator.userAgent) {
     return /bot|crawler|spider|headlesschrome|phantomjs|puppeteer|playwright/iu.test(userAgent);
 }
 const util_isAutomatedUserAgent = isAutomatedUserAgent;
+function summarize(title, contents) {
+    const lines = Object.entries(contents).sort(([keyA], [keyB])=>keyA.localeCompare(keyB)).map(([key, value])=>{
+        const formattedValue = void 0 === value ? "undefined" : "object" == typeof value ? util_pretty(value) : value;
+        return `  • ${key}: ${formattedValue}`;
+    });
+    const line = [
+        `🔎 ${title}`,
+        ...lines
+    ].join("\n");
+    return line;
+}
+const util_summarize = summarize;
 function AudioRecorder_define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
         value: value,
@@ -6627,24 +6686,25 @@ class Recorder extends util_Despot {
         const online = navigator.onLine;
         const elapsedMs = this.connectingStartedAt ? Date.now() - this.connectingStartedAt : void 0;
         const closeEvent = this.lastCloseEvent;
-        const diagnosticLines = [
-            `  • cause: ${cause}`,
-            `  • closeCode: ${closeEvent?.code ?? "undefined"}`,
-            `  • closeReason: ${closeEvent?.reason || "undefined"}`,
-            `  • elapsedMs: ${elapsedMs ?? "undefined"}`,
-            `  • online: ${online}`,
-            `  • unloaded: ${this.unloaded ?? "undefined"}`,
-            `  • userMediaLoaded: ${this.userMediaLoaded ?? "undefined"}`,
-            `  • userMediaLoading: ${this.userMediaLoading}`,
-            `  • wasClean: ${closeEvent?.wasClean ?? "undefined"}`
-        ];
-        const debugLine = [
-            "🔎 Recorder: failConnection() diagnostic",
-            ...diagnosticLines
-        ].join("\n");
+        const socketError = this.lastSocketError;
+        const contents = {
+            cause,
+            closeCode: closeEvent?.code,
+            closeReason: closeEvent?.reason,
+            elapsedMs,
+            online,
+            unloaded: this.unloaded,
+            userMediaLoaded: this.userMediaLoaded,
+            userMediaLoading: this.userMediaLoading,
+            wasClean: closeEvent?.wasClean,
+            socketError,
+            blocking: this.blocking
+        };
+        const debugLine = util_summarize("Recorder: failConnection() diagnostic", contents);
         this.options.logger.debug(debugLine);
         let explanation;
         if (online) if ("timeout" === cause) explanation = `The server at ${url2Connect} did not respond within ${this.options.timeouts.connection}ms, even though your device is online. This usually points to a firewall or proxy silently dropping the connection. Please try a different network. If the problem persists, contact us.`;
+        else if ("error" === cause) explanation = `An error occurred while connecting to ${url2Connect}. Please check your internet connection and try again. If the problem persists, contact us.`;
         else {
             const closeSuffix = closeEvent ? ` (code ${closeEvent.code})` : "";
             explanation = `Connection to ${url2Connect} is closed${closeSuffix}. Please check your internet connection and try again. If the problem persists, contact us.`;
@@ -6657,7 +6717,10 @@ class Recorder extends util_Despot {
         const err = error_createError({
             message: "Unable to connect to the server",
             explanation,
-            options: this.options
+            options: this.options,
+            exc: socketError ? new Error("WebSocket connection error", {
+                cause: socketError
+            }) : void 0
         });
         this.emit("ERROR", {
             err
@@ -6742,6 +6805,7 @@ class Recorder extends util_Despot {
             this.connectionFailed = false;
             this.connectingStartedAt = Date.now();
             this.lastCloseEvent = void 0;
+            this.lastSocketError = void 0;
             this.emit("CONNECTING");
             let url2Connect;
             try {
@@ -6772,6 +6836,9 @@ class Recorder extends util_Despot {
                         wasClean: event.wasClean
                     };
                 });
+                nativeSocket.addEventListener("error", (event)=>{
+                    this.lastSocketError = error_getEventDetails(event);
+                });
             } catch (exc) {
                 this.connecting = this.connected = false;
                 const diagnostic = error_getWebSocketDiagnostic(url2Connect);
@@ -6811,11 +6878,17 @@ class Recorder extends util_Despot {
                     });
                 }, connectionTimeoutMs);
                 this.stream.on("close", ()=>{
-                    this.options.logger.debug(`${PIPE_SYMBOL}Stream has closed, connecting=${this.connecting}, connected=${this.connected}, userMediaLoaded=${this.userMediaLoaded}`);
+                    const debugLine = util_summarize(`${PIPE_SYMBOL}Stream has closed:`, {
+                        connecting: this.connecting,
+                        connected: this.connected,
+                        userMediaLoaded: this.userMediaLoaded,
+                        blocking: this.blocking
+                    });
+                    this.options.logger.debug(debugLine);
                     const tryReconnect = this.connected && this.userMediaLoaded;
                     this.connected = false;
                     if (tryReconnect) this.initSocket();
-                    else if (!this.connecting) window.setTimeout(()=>{
+                    else if (!this.connecting && !this.blocking) window.setTimeout(()=>{
                         this.failConnection({
                             url2Connect,
                             cause: "closed"
@@ -6852,7 +6925,27 @@ class Recorder extends util_Despot {
                     }
                 });
                 this.stream.on("error", (err)=>{
-                    this.options.logger.debug(`${PIPE_SYMBOL}Stream *error* event emitted: ${util_pretty(err)}`);
+                    if ("u" > typeof Event && err instanceof Event) this.lastSocketError = error_getEventDetails(err);
+                    else this.lastSocketError = serializeError(err);
+                    const debugLine = util_summarize(`${PIPE_SYMBOL}Stream *error* event emitted:`, {
+                        error: serializeError(err)
+                    });
+                    this.options.logger.debug(debugLine);
+                    if (!this.connected) return void this.failConnection({
+                        url2Connect,
+                        cause: "error"
+                    });
+                    const streamError = err instanceof Error ? err : new Error("WebSocket stream emitted an error event", {
+                        cause: this.lastSocketError ?? err
+                    });
+                    this.emit("ERROR", {
+                        err: error_createError({
+                            message: "WebSocket stream error",
+                            explanation: `The WebSocket stream emitted an error event. Details: ${util_pretty(err)}`,
+                            options: this.options,
+                            exc: streamError
+                        })
+                    });
                 });
                 this.stream.on("drain", ()=>{
                     this.options.logger.debug(`${PIPE_SYMBOL}Stream *drain* event emitted (should not happen!)`);
@@ -7019,8 +7112,10 @@ class Recorder extends util_Despot {
     executeCommand(command) {
         if (this.unloaded) return;
         try {
-            if (command.args) this.options.logger.debug(`Server commanded: ${command.command} with ${util_pretty(command.args)}`);
-            else this.options.logger.debug(`Server commanded: ${command.command}`);
+            if (command.args) {
+                const debugLine = util_summarize(`Server commanded: ${command.command} with:`, command.args);
+                this.options.logger.debug(debugLine);
+            } else this.options.logger.debug(`Server commanded: ${command.command}`);
             switch(command.command){
                 case "ready":
                     this.emit("SERVER_READY");
@@ -7586,7 +7681,7 @@ class Recorder extends util_Despot {
         return this.userMediaLoaded;
     }
     constructor(visuals, replay, options){
-        super("Recorder", options), recorder_define_property(this, "visuals", void 0), recorder_define_property(this, "replay", void 0), recorder_define_property(this, "loop", void 0), recorder_define_property(this, "originalAnimationFrameObject", void 0), recorder_define_property(this, "samplesCount", 0), recorder_define_property(this, "framesCount", 0), recorder_define_property(this, "recordingStats", void 0), recorder_define_property(this, "confirmedFrameNumber", 0), recorder_define_property(this, "confirmedSampleNumber", 0), recorder_define_property(this, "recorderElement", void 0), recorder_define_property(this, "userMedia", void 0), recorder_define_property(this, "userMediaTimeout", void 0), recorder_define_property(this, "retryTimeout", void 0), recorder_define_property(this, "connectionTimeout", void 0), recorder_define_property(this, "frameProgress", void 0), recorder_define_property(this, "sampleProgress", void 0), recorder_define_property(this, "canvas", void 0), recorder_define_property(this, "ctx", void 0), recorder_define_property(this, "userMediaLoaded", void 0), recorder_define_property(this, "userMediaLoading", false), recorder_define_property(this, "submitting", false), recorder_define_property(this, "unloaded", void 0), recorder_define_property(this, "stopTime", void 0), recorder_define_property(this, "stream", void 0), recorder_define_property(this, "connecting", false), recorder_define_property(this, "connected", false), recorder_define_property(this, "connectionFailed", false), recorder_define_property(this, "blocking", false), recorder_define_property(this, "built", false), recorder_define_property(this, "key", void 0), recorder_define_property(this, "waitingTime", void 0), recorder_define_property(this, "connectingStartedAt", void 0), recorder_define_property(this, "lastCloseEvent", void 0), recorder_define_property(this, "pingInterval", void 0), recorder_define_property(this, "frame", void 0), recorder_define_property(this, "recordingBuffer", void 0), recorder_define_property(this, "facingMode", void 0);
+        super("Recorder", options), recorder_define_property(this, "visuals", void 0), recorder_define_property(this, "replay", void 0), recorder_define_property(this, "loop", void 0), recorder_define_property(this, "originalAnimationFrameObject", void 0), recorder_define_property(this, "samplesCount", 0), recorder_define_property(this, "framesCount", 0), recorder_define_property(this, "recordingStats", void 0), recorder_define_property(this, "confirmedFrameNumber", 0), recorder_define_property(this, "confirmedSampleNumber", 0), recorder_define_property(this, "recorderElement", void 0), recorder_define_property(this, "userMedia", void 0), recorder_define_property(this, "userMediaTimeout", void 0), recorder_define_property(this, "retryTimeout", void 0), recorder_define_property(this, "connectionTimeout", void 0), recorder_define_property(this, "frameProgress", void 0), recorder_define_property(this, "sampleProgress", void 0), recorder_define_property(this, "canvas", void 0), recorder_define_property(this, "ctx", void 0), recorder_define_property(this, "userMediaLoaded", void 0), recorder_define_property(this, "userMediaLoading", false), recorder_define_property(this, "submitting", false), recorder_define_property(this, "unloaded", void 0), recorder_define_property(this, "stopTime", void 0), recorder_define_property(this, "stream", void 0), recorder_define_property(this, "connecting", false), recorder_define_property(this, "connected", false), recorder_define_property(this, "connectionFailed", false), recorder_define_property(this, "blocking", false), recorder_define_property(this, "built", false), recorder_define_property(this, "key", void 0), recorder_define_property(this, "waitingTime", void 0), recorder_define_property(this, "connectingStartedAt", void 0), recorder_define_property(this, "lastCloseEvent", void 0), recorder_define_property(this, "lastSocketError", void 0), recorder_define_property(this, "pingInterval", void 0), recorder_define_property(this, "frame", void 0), recorder_define_property(this, "recordingBuffer", void 0), recorder_define_property(this, "facingMode", void 0);
         this.visuals = visuals;
         this.replay = replay;
         this.facingMode = options.video.facingMode;

package/dist/esm/types/command.d.ts

@@ -1,5 +1,6 @@
 import { ErrorObject } from "serialize-error";
 export interface VideomailCommandArgs {
+    [key: string]: string | number | boolean | undefined | Record<string, unknown>;
     frame?: number;
     key?: string | undefined;
     err?: ErrorObject;

package/dist/esm/util/error/getEventDetails.d.ts

@@ -0,0 +1,2 @@
+declare function getEventDetails(event: Event): Record<string, unknown>;
+export default getEventDetails;

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

@@ -0,0 +1,3 @@
+export type Contents = Record<string, string | number | boolean | undefined | Record<string, unknown>>;
+declare function summarize(title: string, contents: Contents): string;
+export default summarize;

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

@@ -45,6 +45,7 @@ declare class Recorder extends Despot {
     private waitingTime?;
     private connectingStartedAt?;
     private lastCloseEvent?;
+    private lastSocketError?;
     private pingInterval?;
     private frame?;
     private recordingBuffer?;

package/dist/umd/index.js

@@ -1838,7 +1838,7 @@
             xF (module1, __unused_rspack_exports, __webpack_require__) {
                 "use strict";
                 var document1 = __webpack_require__("g");
-                var Event = __webpack_require__("cE");
+                var Event1 = __webpack_require__("cE");
                 var Keys = __webpack_require__("Dy");
                 module1.exports = Visibility;
                 function Visibility() {
@@ -1846,7 +1846,7 @@
                     if (!keys) return noopShim();
                     return {
                         visible: visible,
-                        onChange: Event(listen)
+                        onChange: Event1(listen)
                     };
                     function visible() {
                         return !document1[keys.hidden];
@@ -4410,7 +4410,7 @@
                 var abs = __webpack_require__("G");
                 var floor = __webpack_require__("t");
                 var max = __webpack_require__("u");
-                var min = __webpack_require__("Y");
+                var min = __webpack_require__("Yx");
                 var pow = __webpack_require__("Ik");
                 var round = __webpack_require__("W");
                 var sign = __webpack_require__("Xe");
@@ -4874,8 +4874,8 @@
                 } : null;
             },
             Ne (module1) {
-                module1.exports = Event;
-                function Event() {
+                module1.exports = Event1;
+                function Event1() {
                     var listeners = [];
                     return {
                         broadcast: broadcast,
@@ -4895,10 +4895,10 @@
                 }
             },
             cE (module1, __unused_rspack_exports, __webpack_require__) {
-                var Event = __webpack_require__("Ne");
+                var Event1 = __webpack_require__("Ne");
                 module1.exports = Source;
                 function Source(broadcaster) {
-                    var tuple = Event();
+                    var tuple = Event1();
                     broadcaster(tuple.broadcast);
                     return tuple.listen;
                 }
@@ -5286,7 +5286,7 @@
                 "use strict";
                 module1.exports = Math.max;
             },
-            Y (module1) {
+            Yx (module1) {
                 "use strict";
                 module1.exports = Math.min;
             },
@@ -6789,7 +6789,7 @@
                     return fn;
                 };
             },
-            x5 (module1, __unused_rspack_exports, __webpack_require__) {
+            x (module1, __unused_rspack_exports, __webpack_require__) {
                 "use strict";
                 var inspect = __webpack_require__("L");
                 var $TypeError = __webpack_require__("N");
@@ -6950,7 +6950,7 @@
                 "use strict";
                 var $TypeError = __webpack_require__("N");
                 var inspect = __webpack_require__("L");
-                var getSideChannelList = __webpack_require__("x5");
+                var getSideChannelList = __webpack_require__("x");
                 var getSideChannelMap = __webpack_require__("J");
                 var getSideChannelWeakMap = __webpack_require__("c");
                 var makeChannel = getSideChannelWeakMap || getSideChannelMap || getSideChannelList;
@@ -10976,7 +10976,7 @@
             var client = __webpack_require__("Q");
             var client_default = /*#__PURE__*/ __webpack_require__.n(client);
             var package_namespaceObject = {
-                rE: "15.7.13"
+                rE: "15.7.15"
             };
             function isAudioEnabled(options) {
                 return Boolean(options.audio.enabled);
@@ -10990,6 +10990,52 @@
             }
             var util = __webpack_require__("S");
             var util_default = /*#__PURE__*/ __webpack_require__.n(util);
+            function getEventDetails(event) {
+                const eventWithErrorDetails = event;
+                const details = {
+                    constructor: event.constructor.name,
+                    type: event.type,
+                    isTrusted: event.isTrusted,
+                    bubbles: event.bubbles,
+                    cancelable: event.cancelable,
+                    composed: event.composed,
+                    defaultPrevented: event.defaultPrevented,
+                    eventPhase: event.eventPhase,
+                    timeStamp: event.timeStamp,
+                    returnValue: eventWithErrorDetails.returnValue,
+                    cancelBubble: eventWithErrorDetails.cancelBubble
+                };
+                for (const property of [
+                    "message",
+                    "filename",
+                    "lineno",
+                    "colno"
+                ]){
+                    const value = eventWithErrorDetails[property];
+                    if (void 0 !== value) details[property] = value;
+                }
+                if (eventWithErrorDetails.error instanceof Error) details.error = serializeError(eventWithErrorDetails.error);
+                if (event.target) {
+                    const target = event.target;
+                    const targetDetails = {
+                        constructor: target.constructor.name
+                    };
+                    for (const property of [
+                        "url",
+                        "readyState",
+                        "protocol",
+                        "extensions",
+                        "binaryType",
+                        "bufferedAmount"
+                    ]){
+                        const value = target[property];
+                        if (void 0 !== value) targetDetails[property] = value;
+                    }
+                    details.target = targetDetails;
+                }
+                return details;
+            }
+            const error_getEventDetails = getEventDetails;
             function inspect(element) {
                 return util_default().inspect(element, {
                     colors: false,
@@ -11005,6 +11051,7 @@
                     else if (anything.className) return `.${anything.className}`;
                     return "(No HTML identifier available)";
                 }
+                if ("u" > typeof Event && anything instanceof Event) return inspect(error_getEventDetails(anything));
                 return inspect(anything);
             }
             const util_pretty = pretty;
@@ -16771,6 +16818,18 @@
                 return /bot|crawler|spider|headlesschrome|phantomjs|puppeteer|playwright/iu.test(userAgent);
             }
             const util_isAutomatedUserAgent = isAutomatedUserAgent;
+            function summarize(title, contents) {
+                const lines = Object.entries(contents).sort(([keyA], [keyB])=>keyA.localeCompare(keyB)).map(([key, value])=>{
+                    const formattedValue = void 0 === value ? "undefined" : "object" == typeof value ? util_pretty(value) : value;
+                    return `  • ${key}: ${formattedValue}`;
+                });
+                const line = [
+                    `🔎 ${title}`,
+                    ...lines
+                ].join("\n");
+                return line;
+            }
+            const util_summarize = summarize;
             function _define_property(obj, key, value) {
                 if (key in obj) Object.defineProperty(obj, key, {
                     value: value,
@@ -17265,6 +17324,7 @@
                 waitingTime;
                 connectingStartedAt;
                 lastCloseEvent;
+                lastSocketError;
                 pingInterval;
                 frame;
                 recordingBuffer;
@@ -17376,24 +17436,25 @@
                     const online = navigator.onLine;
                     const elapsedMs = this.connectingStartedAt ? Date.now() - this.connectingStartedAt : void 0;
                     const closeEvent = this.lastCloseEvent;
-                    const diagnosticLines = [
-                        `  • cause: ${cause}`,
-                        `  • closeCode: ${closeEvent?.code ?? "undefined"}`,
-                        `  • closeReason: ${closeEvent?.reason || "undefined"}`,
-                        `  • elapsedMs: ${elapsedMs ?? "undefined"}`,
-                        `  • online: ${online}`,
-                        `  • unloaded: ${this.unloaded ?? "undefined"}`,
-                        `  • userMediaLoaded: ${this.userMediaLoaded ?? "undefined"}`,
-                        `  • userMediaLoading: ${this.userMediaLoading}`,
-                        `  • wasClean: ${closeEvent?.wasClean ?? "undefined"}`
-                    ];
-                    const debugLine = [
-                        "🔎 Recorder: failConnection() diagnostic",
-                        ...diagnosticLines
-                    ].join("\n");
+                    const socketError = this.lastSocketError;
+                    const contents = {
+                        cause,
+                        closeCode: closeEvent?.code,
+                        closeReason: closeEvent?.reason,
+                        elapsedMs,
+                        online,
+                        unloaded: this.unloaded,
+                        userMediaLoaded: this.userMediaLoaded,
+                        userMediaLoading: this.userMediaLoading,
+                        wasClean: closeEvent?.wasClean,
+                        socketError,
+                        blocking: this.blocking
+                    };
+                    const debugLine = util_summarize("Recorder: failConnection() diagnostic", contents);
                     this.options.logger.debug(debugLine);
                     let explanation;
                     if (online) if ("timeout" === cause) explanation = `The server at ${url2Connect} did not respond within ${this.options.timeouts.connection}ms, even though your device is online. This usually points to a firewall or proxy silently dropping the connection. Please try a different network. If the problem persists, contact us.`;
+                    else if ("error" === cause) explanation = `An error occurred while connecting to ${url2Connect}. Please check your internet connection and try again. If the problem persists, contact us.`;
                     else {
                         const closeSuffix = closeEvent ? ` (code ${closeEvent.code})` : "";
                         explanation = `Connection to ${url2Connect} is closed${closeSuffix}. Please check your internet connection and try again. If the problem persists, contact us.`;
@@ -17406,7 +17467,10 @@
                     const err = error_createError({
                         message: "Unable to connect to the server",
                         explanation,
-                        options: this.options
+                        options: this.options,
+                        exc: socketError ? new Error("WebSocket connection error", {
+                            cause: socketError
+                        }) : void 0
                     });
                     this.emit("ERROR", {
                         err
@@ -17491,6 +17555,7 @@
                         this.connectionFailed = false;
                         this.connectingStartedAt = Date.now();
                         this.lastCloseEvent = void 0;
+                        this.lastSocketError = void 0;
                         this.emit("CONNECTING");
                         let url2Connect;
                         try {
@@ -17521,6 +17586,9 @@
                                     wasClean: event.wasClean
                                 };
                             });
+                            nativeSocket.addEventListener("error", (event)=>{
+                                this.lastSocketError = error_getEventDetails(event);
+                            });
                         } catch (exc) {
                             this.connecting = this.connected = false;
                             const diagnostic = error_getWebSocketDiagnostic(url2Connect);
@@ -17560,11 +17628,17 @@
                                 });
                             }, connectionTimeoutMs);
                             this.stream.on("close", ()=>{
-                                this.options.logger.debug(`${PIPE_SYMBOL}Stream has closed, connecting=${this.connecting}, connected=${this.connected}, userMediaLoaded=${this.userMediaLoaded}`);
+                                const debugLine = util_summarize(`${PIPE_SYMBOL}Stream has closed:`, {
+                                    connecting: this.connecting,
+                                    connected: this.connected,
+                                    userMediaLoaded: this.userMediaLoaded,
+                                    blocking: this.blocking
+                                });
+                                this.options.logger.debug(debugLine);
                                 const tryReconnect = this.connected && this.userMediaLoaded;
                                 this.connected = false;
                                 if (tryReconnect) this.initSocket();
-                                else if (!this.connecting) window.setTimeout(()=>{
+                                else if (!this.connecting && !this.blocking) window.setTimeout(()=>{
                                     this.failConnection({
                                         url2Connect,
                                         cause: "closed"
@@ -17601,7 +17675,27 @@
                                 }
                             });
                             this.stream.on("error", (err)=>{
-                                this.options.logger.debug(`${PIPE_SYMBOL}Stream *error* event emitted: ${util_pretty(err)}`);
+                                if ("u" > typeof Event && err instanceof Event) this.lastSocketError = error_getEventDetails(err);
+                                else this.lastSocketError = serializeError(err);
+                                const debugLine = util_summarize(`${PIPE_SYMBOL}Stream *error* event emitted:`, {
+                                    error: serializeError(err)
+                                });
+                                this.options.logger.debug(debugLine);
+                                if (!this.connected) return void this.failConnection({
+                                    url2Connect,
+                                    cause: "error"
+                                });
+                                const streamError = err instanceof Error ? err : new Error("WebSocket stream emitted an error event", {
+                                    cause: this.lastSocketError ?? err
+                                });
+                                this.emit("ERROR", {
+                                    err: error_createError({
+                                        message: "WebSocket stream error",
+                                        explanation: `The WebSocket stream emitted an error event. Details: ${util_pretty(err)}`,
+                                        options: this.options,
+                                        exc: streamError
+                                    })
+                                });
                             });
                             this.stream.on("drain", ()=>{
                                 this.options.logger.debug(`${PIPE_SYMBOL}Stream *drain* event emitted (should not happen!)`);
@@ -17768,8 +17862,10 @@
                 executeCommand(command) {
                     if (this.unloaded) return;
                     try {
-                        if (command.args) this.options.logger.debug(`Server commanded: ${command.command} with ${util_pretty(command.args)}`);
-                        else this.options.logger.debug(`Server commanded: ${command.command}`);
+                        if (command.args) {
+                            const debugLine = util_summarize(`Server commanded: ${command.command} with:`, command.args);
+                            this.options.logger.debug(debugLine);
+                        } else this.options.logger.debug(`Server commanded: ${command.command}`);
                         switch(command.command){
                             case "ready":
                                 this.emit("SERVER_READY");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "videomail-client",
-  "version": "15.7.13",
+  "version": "15.7.15",
   "description": "A wicked npm package to record videos directly in the browser, for Deaf and Sign Language!",
   "keywords": [
     "webcam",