videomail-client 15.7.12 → 15.7.14

package/dist/cjs/index.cjs

@@ -1575,7 +1575,7 @@ var __webpack_modules__ = {
             return intrinsic;
         };
     },
-    r (module) {
+    rX (module) {
         module.exports = Emitter;
         function Emitter(obj) {
             if (obj) return mixin(obj);
@@ -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];
@@ -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;
         }
@@ -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;
@@ -7041,7 +7041,7 @@ var __webpack_modules__ = {
             console.warn('Using browser-only version of superagent in non-browser environment');
             root = void 0;
         } else root = self;
-        const Emitter = __webpack_require__("r");
+        const Emitter = __webpack_require__("rX");
         const safeStringify = __webpack_require__("X");
         const qs = __webpack_require__("b");
         const RequestBase = __webpack_require__("d");
@@ -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.12"
+        rE: "15.7.14"
     };
     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;
@@ -17596,7 +17643,7 @@ var __webpack_exports__ = {};
             this.connectionTimeout = void 0;
         }
         failConnection(params) {
-            var _ref, _ref1;
+            var _ref, _this_unloaded, _this_userMediaLoaded, _ref1;
             if (this.connectionFailed || this.connected || this.unloaded) return;
             this.connectionFailed = true;
             this.connecting = false;
@@ -17605,10 +17652,27 @@ var __webpack_exports__ = {};
             const online = navigator.onLine;
             const elapsedMs = this.connectingStartedAt ? Date.now() - this.connectingStartedAt : void 0;
             const closeEvent = this.lastCloseEvent;
-            const debugLine = `Recorder: failConnection() diagnostic - cause=${cause}, online=${online}, elapsedMs=${null != elapsedMs ? elapsedMs : "unknown"}, closeCode=${null != (_ref = null == closeEvent ? void 0 : closeEvent.code) ? _ref : "none"}, closeReason=${(null == closeEvent ? void 0 : closeEvent.reason) || "none"}, wasClean=${null != (_ref1 = null == closeEvent ? void 0 : closeEvent.wasClean) ? _ref1 : "unknown"}`;
+            const socketError = this.lastSocketError;
+            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"}`,
+                `  • socketError: ${socketError ? util_pretty(socketError) : "undefined"}`
+            ];
+            const debugLine = [
+                "🔎 Recorder: failConnection() diagnostic",
+                ...diagnosticLines
+            ].join("\n");
             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 = `The WebSocket reported an error while connecting to ${url2Connect}. Details: ${util_pretty(null != socketError ? socketError : {})} 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.`;
@@ -17621,7 +17685,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
@@ -17707,6 +17774,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 {
@@ -17737,6 +17805,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);
@@ -17776,11 +17847,11 @@ var __webpack_exports__ = {};
                         });
                     }, connectionTimeoutMs);
                     this.stream.on("close", ()=>{
-                        this.options.logger.debug(`${PIPE_SYMBOL}Stream has closed, connecting=${this.connecting}, connected=${this.connected},`);
-                        const tryReconnect = this.connecting && this.userMediaLoaded;
+                        this.options.logger.debug(`${PIPE_SYMBOL}Stream has closed, connecting=${this.connecting}, connected=${this.connected}, userMediaLoaded=${this.userMediaLoaded}`);
+                        const tryReconnect = this.connected && this.userMediaLoaded;
                         this.connected = false;
                         if (tryReconnect) this.initSocket();
-                        else window.setTimeout(()=>{
+                        else if (!this.connecting) window.setTimeout(()=>{
                             this.failConnection({
                                 url2Connect,
                                 cause: "closed"
@@ -17818,7 +17889,25 @@ var __webpack_exports__ = {};
                         }
                     });
                     this.stream.on("error", (err)=>{
+                        var _this_lastSocketError;
+                        if ("u" > typeof Event && err instanceof Event) this.lastSocketError = error_getEventDetails(err);
+                        else this.lastSocketError = serializeError(err);
                         this.options.logger.debug(`${PIPE_SYMBOL}Stream *error* event emitted: ${util_pretty(err)}`);
+                        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!)`);
@@ -18567,7 +18656,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.12"
+    rE: "15.7.14"
 };
 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;
@@ -6627,10 +6674,27 @@ class Recorder extends util_Despot {
         const online = navigator.onLine;
         const elapsedMs = this.connectingStartedAt ? Date.now() - this.connectingStartedAt : void 0;
         const closeEvent = this.lastCloseEvent;
-        const debugLine = `Recorder: failConnection() diagnostic - cause=${cause}, online=${online}, elapsedMs=${elapsedMs ?? "unknown"}, closeCode=${closeEvent?.code ?? "none"}, closeReason=${closeEvent?.reason || "none"}, wasClean=${closeEvent?.wasClean ?? "unknown"}`;
+        const socketError = this.lastSocketError;
+        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"}`,
+            `  • socketError: ${socketError ? util_pretty(socketError) : "undefined"}`
+        ];
+        const debugLine = [
+            "🔎 Recorder: failConnection() diagnostic",
+            ...diagnosticLines
+        ].join("\n");
         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 = `The WebSocket reported an error while connecting to ${url2Connect}. Details: ${util_pretty(socketError ?? {})} 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.`;
@@ -6643,7 +6707,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
@@ -6728,6 +6795,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 {
@@ -6758,6 +6826,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);
@@ -6797,11 +6868,11 @@ 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},`);
-                    const tryReconnect = this.connecting && this.userMediaLoaded;
+                    this.options.logger.debug(`${PIPE_SYMBOL}Stream has closed, connecting=${this.connecting}, connected=${this.connected}, userMediaLoaded=${this.userMediaLoaded}`);
+                    const tryReconnect = this.connected && this.userMediaLoaded;
                     this.connected = false;
                     if (tryReconnect) this.initSocket();
-                    else window.setTimeout(()=>{
+                    else if (!this.connecting) window.setTimeout(()=>{
                         this.failConnection({
                             url2Connect,
                             cause: "closed"
@@ -6838,7 +6909,24 @@ class Recorder extends util_Despot {
                     }
                 });
                 this.stream.on("error", (err)=>{
+                    if ("u" > typeof Event && err instanceof Event) this.lastSocketError = error_getEventDetails(err);
+                    else this.lastSocketError = serializeError(err);
                     this.options.logger.debug(`${PIPE_SYMBOL}Stream *error* event emitted: ${util_pretty(err)}`);
+                    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!)`);
@@ -7572,7 +7660,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/util/error/getEventDetails.d.ts

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

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

@@ -1581,7 +1581,7 @@
                     return intrinsic;
                 };
             },
-            r (module1) {
+            rX (module1) {
                 module1.exports = Emitter;
                 function Emitter(obj) {
                     if (obj) return mixin(obj);
@@ -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];
@@ -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;
                 }
@@ -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;
@@ -7047,7 +7047,7 @@
                     console.warn('Using browser-only version of superagent in non-browser environment');
                     root = void 0;
                 } else root = self;
-                const Emitter = __webpack_require__("r");
+                const Emitter = __webpack_require__("rX");
                 const safeStringify = __webpack_require__("X");
                 const qs = __webpack_require__("b");
                 const RequestBase = __webpack_require__("d");
@@ -10976,7 +10976,7 @@
             var client = __webpack_require__("Q");
             var client_default = /*#__PURE__*/ __webpack_require__.n(client);
             var package_namespaceObject = {
-                rE: "15.7.12"
+                rE: "15.7.14"
             };
             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;
@@ -17265,6 +17312,7 @@
                 waitingTime;
                 connectingStartedAt;
                 lastCloseEvent;
+                lastSocketError;
                 pingInterval;
                 frame;
                 recordingBuffer;
@@ -17376,10 +17424,27 @@
                     const online = navigator.onLine;
                     const elapsedMs = this.connectingStartedAt ? Date.now() - this.connectingStartedAt : void 0;
                     const closeEvent = this.lastCloseEvent;
-                    const debugLine = `Recorder: failConnection() diagnostic - cause=${cause}, online=${online}, elapsedMs=${elapsedMs ?? "unknown"}, closeCode=${closeEvent?.code ?? "none"}, closeReason=${closeEvent?.reason || "none"}, wasClean=${closeEvent?.wasClean ?? "unknown"}`;
+                    const socketError = this.lastSocketError;
+                    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"}`,
+                        `  • socketError: ${socketError ? util_pretty(socketError) : "undefined"}`
+                    ];
+                    const debugLine = [
+                        "🔎 Recorder: failConnection() diagnostic",
+                        ...diagnosticLines
+                    ].join("\n");
                     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 = `The WebSocket reported an error while connecting to ${url2Connect}. Details: ${util_pretty(socketError ?? {})} 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.`;
@@ -17392,7 +17457,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
@@ -17477,6 +17545,7 @@
                         this.connectionFailed = false;
                         this.connectingStartedAt = Date.now();
                         this.lastCloseEvent = void 0;
+                        this.lastSocketError = void 0;
                         this.emit("CONNECTING");
                         let url2Connect;
                         try {
@@ -17507,6 +17576,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);
@@ -17546,11 +17618,11 @@
                                 });
                             }, connectionTimeoutMs);
                             this.stream.on("close", ()=>{
-                                this.options.logger.debug(`${PIPE_SYMBOL}Stream has closed, connecting=${this.connecting}, connected=${this.connected},`);
-                                const tryReconnect = this.connecting && this.userMediaLoaded;
+                                this.options.logger.debug(`${PIPE_SYMBOL}Stream has closed, connecting=${this.connecting}, connected=${this.connected}, userMediaLoaded=${this.userMediaLoaded}`);
+                                const tryReconnect = this.connected && this.userMediaLoaded;
                                 this.connected = false;
                                 if (tryReconnect) this.initSocket();
-                                else window.setTimeout(()=>{
+                                else if (!this.connecting) window.setTimeout(()=>{
                                     this.failConnection({
                                         url2Connect,
                                         cause: "closed"
@@ -17587,7 +17659,24 @@
                                 }
                             });
                             this.stream.on("error", (err)=>{
+                                if ("u" > typeof Event && err instanceof Event) this.lastSocketError = error_getEventDetails(err);
+                                else this.lastSocketError = serializeError(err);
                                 this.options.logger.debug(`${PIPE_SYMBOL}Stream *error* event emitted: ${util_pretty(err)}`);
+                                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!)`);

package/package.json

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