videomail-client 15.8.1 → 15.8.2

package/dist/cjs/index.cjs

@@ -423,7 +423,7 @@ var __webpack_modules__ = {
             return parts.join('');
         }
     },
-    dY (__unused_rspack_module, exports1, __webpack_require__) {
+    dY2 (__unused_rspack_module, exports1, __webpack_require__) {
         "use strict";
         /*!
  * The buffer module from node.js, for the browser.
@@ -1706,7 +1706,7 @@ var __webpack_modules__ = {
             return null === arg || 'boolean' == typeof arg || 'number' == typeof arg || 'string' == typeof arg || 'symbol' == typeof arg || void 0 === arg;
         }
         exports1.isPrimitive = isPrimitive;
-        exports1.isBuffer = __webpack_require__("dY").Buffer.isBuffer;
+        exports1.isBuffer = __webpack_require__("dY2").Buffer.isBuffer;
         function objectToString(o) {
             return Object.prototype.toString.call(o);
         }
@@ -1902,7 +1902,7 @@ var __webpack_modules__ = {
         } : false;
     },
     Y4 (module, __unused_rspack_exports, __webpack_require__) {
-        var Buffer = __webpack_require__("dY").Buffer;
+        var Buffer = __webpack_require__("dY2").Buffer;
         var process = __webpack_require__("zT");
         var stream = __webpack_require__("GB");
         var eos = __webpack_require__("Qd");
@@ -3462,7 +3462,7 @@ var __webpack_modules__ = {
         exports1.PassThrough = __webpack_require__("P");
     },
     Uf (module, exports1, __webpack_require__) {
-        var buffer = __webpack_require__("dY");
+        var buffer = __webpack_require__("dY2");
         var Buffer = buffer.Buffer;
         function copyProps(src, dst) {
             for(var key in src)dst[key] = src[key];
@@ -4760,7 +4760,7 @@ var __webpack_modules__ = {
             ]
         };
         var bind = __webpack_require__("zO");
-        var hasOwn = __webpack_require__("Zw");
+        var hasOwn = __webpack_require__("Z");
         var $concat = bind.call($call, Array.prototype.concat);
         var $spliceApply = bind.call($apply, Array.prototype.splice);
         var $replace = bind.call($call, String.prototype.replace);
@@ -4985,7 +4985,7 @@ var __webpack_modules__ = {
             return hasSymbols() && !!Symbol.toStringTag;
         };
     },
-    Zw (module, __unused_rspack_exports, __webpack_require__) {
+    Z (module, __unused_rspack_exports, __webpack_require__) {
         "use strict";
         var call = Function.prototype.call;
         var $hasOwn = Object.prototype.hasOwnProperty;
@@ -5220,7 +5220,7 @@ var __webpack_modules__ = {
         "use strict";
         var callBound = __webpack_require__("F");
         var hasToStringTag = __webpack_require__("bT")();
-        var hasOwn = __webpack_require__("Zw");
+        var hasOwn = __webpack_require__("Z");
         var gOPD = __webpack_require__("D");
         var fn;
         if (hasToStringTag) {
@@ -7044,7 +7044,7 @@ var __webpack_modules__ = {
         const Emitter = __webpack_require__("r");
         const safeStringify = __webpack_require__("X");
         const qs = __webpack_require__("b");
-        const RequestBase = __webpack_require__("d");
+        const RequestBase = __webpack_require__("dY");
         const { isObject, mixin, hasOwn, isSafeKey } = __webpack_require__("Dp");
         const ResponseBase = __webpack_require__("e");
         const Agent = __webpack_require__("pf");
@@ -7459,7 +7459,7 @@ var __webpack_modules__ = {
             return request_;
         };
     },
-    d (module, __unused_rspack_exports, __webpack_require__) {
+    dY (module, __unused_rspack_exports, __webpack_require__) {
         "use strict";
         const { isObject, hasOwn, isSafeKey } = __webpack_require__("Dp");
         module.exports = RequestBase;
@@ -7862,7 +7862,7 @@ var __webpack_modules__ = {
         exports1.isBrotliEncoding = (res)=>/^\s*br\s*$/i.test(res.headers['content-encoding']);
     },
     E (module, __unused_rspack_exports, __webpack_require__) {
-        var Buffer = __webpack_require__("dY").Buffer;
+        var Buffer = __webpack_require__("dY2").Buffer;
         /*! typedarray-to-buffer. MIT License. Feross Aboukhadijeh <https://feross.org/opensource> */ module.exports = function(arr) {
             return ArrayBuffer.isView(arr) ? Buffer.from(arr.buffer, arr.byteOffset, arr.byteLength) : Buffer.from(arr);
         };
@@ -8728,7 +8728,7 @@ var __webpack_modules__ = {
             this.decoder = null;
             this.encoding = null;
             if (options.encoding) {
-                if (!StringDecoder) StringDecoder = __webpack_require__("Zwc").I;
+                if (!StringDecoder) StringDecoder = __webpack_require__("Zw").I;
                 this.decoder = new StringDecoder(options.encoding);
                 this.encoding = options.encoding;
             }
@@ -8827,7 +8827,7 @@ var __webpack_modules__ = {
             return false === this._readableState.flowing;
         };
         Readable.prototype.setEncoding = function(enc) {
-            if (!StringDecoder) StringDecoder = __webpack_require__("Zwc").I;
+            if (!StringDecoder) StringDecoder = __webpack_require__("Zw").I;
             this._readableState.decoder = new StringDecoder(enc);
             this._readableState.encoding = enc;
             return this;
@@ -9933,7 +9933,7 @@ var __webpack_modules__ = {
         exports1.PassThrough = __webpack_require__("X2");
     },
     CX (module, exports1, __webpack_require__) {
-        var buffer = __webpack_require__("dY");
+        var buffer = __webpack_require__("dY2");
         var Buffer = buffer.Buffer;
         function copyProps(src, dst) {
             for(var key in src)dst[key] = src[key];
@@ -9968,7 +9968,7 @@ var __webpack_modules__ = {
             return buffer.SlowBuffer(size);
         };
     },
-    Zwc (__unused_rspack_module, exports1, __webpack_require__) {
+    Zw (__unused_rspack_module, exports1, __webpack_require__) {
         "use strict";
         var Buffer = __webpack_require__("CX").Buffer;
         var isEncoding = Buffer.isEncoding || function(encoding) {
@@ -10972,7 +10972,7 @@ var __webpack_exports__ = {};
     var client = __webpack_require__("Q");
     var client_default = /*#__PURE__*/ __webpack_require__.n(client);
     var package_namespaceObject = {
-        rE: "15.8.1"
+        rE: "15.8.2"
     };
     function isAudioEnabled(options) {
         return Boolean(options.audio.enabled);
@@ -14608,6 +14608,7 @@ var __webpack_exports__ = {};
         ].filter(Boolean).join(", ");
         options.logger.debug(`VideomailError: create(${args})`);
         const errData = {
+            cause: errorParams.cause,
             explanation,
             logLines,
             err
@@ -14848,12 +14849,12 @@ var __webpack_exports__ = {};
         element.style.removeProperty("display");
     }
     const html_showElement = showElement;
-    const REGEX = /[ ,]+/u;
+    const EMAIL_SEPARATOR_REGEX = /[ ,]+/gu;
     function trimEmail(email) {
-        return email.replace(REGEX, "");
+        return email.replace(EMAIL_SEPARATOR_REGEX, "");
     }
     function trimEmails(emails) {
-        const trimmedEmails = emails.split(REGEX).map((item)=>item.trim()).filter(Boolean);
+        const trimmedEmails = emails.split(EMAIL_SEPARATOR_REGEX).map((item)=>item.trim()).filter(Boolean);
         return trimmedEmails;
     }
     function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
@@ -15311,6 +15312,7 @@ var __webpack_exports__ = {};
                     browser: err.browser,
                     code: err.code,
                     cookie: err.cookie,
+                    cause: err.cause instanceof Error ? serializeError(err.cause) : err.cause,
                     cpu: err.cpu,
                     device: err.device,
                     engine: err.engine,
@@ -19086,6 +19088,34 @@ var __webpack_exports__ = {};
         return line;
     }
     const util_summarize = summarize;
+    function getFirstVideoTrack(localMediaStream) {
+        const videoTracks = localMediaStream.getVideoTracks();
+        let videoTrack;
+        if (videoTracks[0]) videoTrack = videoTracks[0];
+        return videoTrack;
+    }
+    const media_getFirstVideoTrack = getFirstVideoTrack;
+    const MEDIA_EVENTS = [
+        "loadstart",
+        "suspend",
+        "progress",
+        "abort",
+        "emptied",
+        "stalled",
+        "pause",
+        "loadeddata",
+        "waiting",
+        "playing",
+        "canplay",
+        "canplaythrough",
+        "seeking",
+        "seeked",
+        "ended",
+        "ratechange",
+        "durationchange",
+        "volumechange"
+    ];
+    const mediaEvents = MEDIA_EVENTS;
     function esm_define_property(obj, key, value) {
         if (key in obj) Object.defineProperty(obj, key, {
             value: value,
@@ -19159,11 +19189,11 @@ var __webpack_exports__ = {};
             let { bufferSize } = this.options.audio;
             if ("auto" === bufferSize) bufferSize = util_getBrowser(this.options).isFirefox() ? 512 : 2048;
             if (!is_power_of_two_default()(bufferSize)) throw error_createError({
-                message: "Audio buffer size must be a power of two.",
+                message: `Audio buffer size must be a power of two. The current buffer size is ${bufferSize}.`,
                 options: this.options
             });
-            if (this.options.audio.volume < 0 || this.options.audio.volume > 1) throw error_createError({
-                message: "Audio volume must be between zero and one.",
+            if (!Number.isFinite(this.options.audio.volume) || this.options.audio.volume < 0 || this.options.audio.volume > 1) throw error_createError({
+                message: `Audio volume must be between zero and one. The current volume is ${this.options.audio.volume}.`,
                 options: this.options
             });
             volume.gain.value = this.options.audio.volume;
@@ -19209,34 +19239,6 @@ var __webpack_exports__ = {};
         }
     }
     const media_AudioRecorder = AudioRecorder;
-    function getFirstVideoTrack(localMediaStream) {
-        const videoTracks = localMediaStream.getVideoTracks();
-        let videoTrack;
-        if (videoTracks[0]) videoTrack = videoTracks[0];
-        return videoTrack;
-    }
-    const media_getFirstVideoTrack = getFirstVideoTrack;
-    const MEDIA_EVENTS = [
-        "loadstart",
-        "suspend",
-        "progress",
-        "abort",
-        "emptied",
-        "stalled",
-        "pause",
-        "loadeddata",
-        "waiting",
-        "playing",
-        "canplay",
-        "canplaythrough",
-        "seeking",
-        "seeked",
-        "ended",
-        "ratechange",
-        "durationchange",
-        "volumechange"
-    ];
-    const mediaEvents = MEDIA_EVENTS;
     const VIRTUAL_KEYWORDS = [
         "obs",
         "virtual",
@@ -19573,7 +19575,7 @@ var __webpack_exports__ = {};
         }
     }
     const visuals_userMedia = UserMedia;
-    var Buffer = __webpack_require__("dY").Buffer;
+    var Buffer = __webpack_require__("dY2").Buffer;
     function recorder_define_property(obj, key, value) {
         if (key in obj) Object.defineProperty(obj, key, {
             value: value,
@@ -19655,6 +19657,7 @@ var __webpack_exports__ = {};
                 const switchingFacingMode = null == params ? void 0 : params.switchingFacingMode;
                 this.userMediaLoading = this.blocking = this.unloaded = this.submitting = false;
                 this.userMediaLoaded = true;
+                this.clearUserMediaTimeout();
                 if (!switchingFacingMode) this.loop = this.createLoop();
                 this.show();
                 if (null == params ? void 0 : params.recordWhenReady) this.record();
@@ -19685,6 +19688,7 @@ var __webpack_exports__ = {};
             return navigator.onLine;
         }
         failConnection(params) {
+            var _this_stream;
             if (this.connectionFailed || this.connected || this.unloaded) return;
             this.connectionFailed = true;
             this.connecting = false;
@@ -19700,12 +19704,17 @@ var __webpack_exports__ = {};
                 closeReason: null == closeEvent ? void 0 : closeEvent.reason,
                 elapsedMs,
                 online,
+                secureContext: globalThis.isSecureContext,
+                socketReadyState: null == (_this_stream = this.stream) ? void 0 : _this_stream.socket.readyState,
+                timeoutMs: this.options.timeouts.connection,
+                url: url2Connect,
                 unloaded: this.unloaded,
                 userMediaLoaded: this.userMediaLoaded,
                 userMediaLoading: this.userMediaLoading,
                 wasClean: null == closeEvent ? void 0 : closeEvent.wasClean,
                 socketError,
-                blocking: this.blocking
+                blocking: this.blocking,
+                visibilityState: document.visibilityState
             };
             const debugLine = util_summarize("Recorder: failConnection() diagnostic", contents);
             this.options.logger.debug(debugLine);
@@ -19725,6 +19734,7 @@ var __webpack_exports__ = {};
                 message: "Unable to connect to the server",
                 explanation,
                 options: this.options,
+                cause: contents,
                 exc: socketError ? new Error("WebSocket connection error", {
                     cause: socketError
                 }) : void 0
@@ -19803,197 +19813,197 @@ var __webpack_exports__ = {};
             this.recordingStats.waitingTime = this.waitingTime;
         }
         initSocket(cb) {
-            if (!this.connected) {
-                if (util_isAutomatedUserAgent()) {
-                    this.connecting = false;
-                    this.options.logger.debug("Recorder: skipping web socket connection for an automated crawler");
-                    return;
-                }
-                this.connecting = true;
-                this.connectionFailed = false;
-                this.connectingStartedAt = Date.now();
-                this.lastCloseEvent = void 0;
-                this.lastSocketError = void 0;
-                this.emit("CONNECTING");
-                let url2Connect;
-                try {
-                    const socketUrlObj = new URL(this.options.socketUrl);
-                    socketUrlObj.searchParams.set(constants.WHITELIST_KEY_LABEL, this.options.whitelistKey);
-                    url2Connect = socketUrlObj.toString();
-                } catch (exc) {
-                    this.connecting = this.connected = false;
-                    const err = error_createError({
-                        message: "Invalid WebSocket URL",
-                        explanation: `The configured socketUrl "${this.options.socketUrl}" is not a valid URL. Please check your videomail-client configuration.`,
-                        options: this.options,
-                        exc
-                    });
-                    this.emit("ERROR", {
-                        err
-                    });
-                    return;
-                }
-                this.options.logger.debug(`Recorder: initializing web socket stream to ${url2Connect}`);
-                let nativeSocket;
-                try {
-                    nativeSocket = new WebSocket(url2Connect);
-                    nativeSocket.addEventListener("close", (event)=>{
-                        this.lastCloseEvent = {
-                            code: event.code,
-                            reason: event.reason,
-                            wasClean: event.wasClean
-                        };
-                    });
-                    nativeSocket.addEventListener("error", (event)=>{
-                        this.lastSocketError = error_getEventDetails(event);
-                    });
-                } catch (exc) {
-                    this.connecting = this.connected = false;
-                    const diagnostic = error_getWebSocketDiagnostic(url2Connect);
-                    const message = diagnostic.looksAutomated ? "Automated crawler: WebSocket not supported in this environment" : `Failed to construct WebSocket to ${url2Connect}`;
-                    const explanation = diagnostic.looksAutomated ? "Headless crawlers cannot use Videomail's WebSocket. No action needed." : `Please check your connection and try again. If the problem persists, contact us. Diagnostic: ${diagnostic.text}`;
-                    const err = error_createError({
-                        message,
-                        explanation,
-                        options: this.options,
-                        exc
-                    });
-                    this.emit("ERROR", {
-                        err
-                    });
-                    return;
-                }
-                try {
-                    this.stream = stream_default()(nativeSocket);
-                } catch (exc) {
-                    this.connecting = this.connected = false;
-                    const err = error_createError({
-                        message: `Failed to create a stream to ${url2Connect}`,
-                        explanation: "Please check your connection and try again. If the problem persists, contact us.",
-                        options: this.options,
-                        exc
-                    });
-                    this.emit("ERROR", {
-                        err
-                    });
-                }
-                if (this.stream) {
-                    const connectionTimeoutMs = this.options.timeouts.connection;
-                    this.connectionTimeout = window.setTimeout(()=>{
-                        if (this.isOnline() && this.isUserMediaLoaded()) {
-                            this.options.logger.debug(`${PIPE_SYMBOL}Reconnecting due to connection timeout.`);
-                            this.initSocket();
-                        } else this.failConnection({
-                            url2Connect,
-                            cause: "timeout"
-                        });
-                    }, connectionTimeoutMs);
-                    this.stream.on("close", ()=>{
-                        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 && !this.blocking) window.setTimeout(()=>{
-                            this.failConnection({
-                                url2Connect,
-                                cause: "closed"
-                            });
-                        }, 0);
+            if (this.connected) return void (null == cb || cb());
+            if (this.connecting) return;
+            if (util_isAutomatedUserAgent()) {
+                this.connecting = false;
+                this.options.logger.debug("Recorder: skipping web socket connection for an automated crawler");
+                return;
+            }
+            this.connecting = true;
+            this.connectionFailed = false;
+            this.connectingStartedAt = Date.now();
+            this.lastCloseEvent = void 0;
+            this.lastSocketError = void 0;
+            this.emit("CONNECTING");
+            let url2Connect;
+            try {
+                const socketUrlObj = new URL(this.options.socketUrl);
+                socketUrlObj.searchParams.set(constants.WHITELIST_KEY_LABEL, this.options.whitelistKey);
+                url2Connect = socketUrlObj.toString();
+            } catch (exc) {
+                this.connecting = this.connected = false;
+                const err = error_createError({
+                    message: "Invalid WebSocket URL",
+                    explanation: `The configured socketUrl "${this.options.socketUrl}" is not a valid URL. Please check your videomail-client configuration.`,
+                    options: this.options,
+                    exc
+                });
+                this.emit("ERROR", {
+                    err
+                });
+                return;
+            }
+            this.options.logger.debug(`Recorder: initializing web socket stream to ${url2Connect}`);
+            let nativeSocket;
+            try {
+                nativeSocket = new WebSocket(url2Connect);
+                nativeSocket.addEventListener("close", (event)=>{
+                    this.lastCloseEvent = {
+                        code: event.code,
+                        reason: event.reason,
+                        wasClean: event.wasClean
+                    };
+                });
+                nativeSocket.addEventListener("error", (event)=>{
+                    this.lastSocketError = error_getEventDetails(event);
+                });
+            } catch (exc) {
+                this.connecting = this.connected = false;
+                const diagnostic = error_getWebSocketDiagnostic(url2Connect);
+                const message = diagnostic.looksAutomated ? "Automated crawler: WebSocket not supported in this environment" : `Failed to construct WebSocket to ${url2Connect}`;
+                const explanation = diagnostic.looksAutomated ? "Headless crawlers cannot use Videomail's WebSocket. No action needed." : `Please check your connection and try again. If the problem persists, contact us. Diagnostic: ${diagnostic.text}`;
+                const err = error_createError({
+                    message,
+                    explanation,
+                    options: this.options,
+                    exc
+                });
+                this.emit("ERROR", {
+                    err
+                });
+                return;
+            }
+            try {
+                this.stream = stream_default()(nativeSocket);
+            } catch (exc) {
+                this.connecting = this.connected = false;
+                const err = error_createError({
+                    message: `Failed to create a stream to ${url2Connect}`,
+                    explanation: "Please check your connection and try again. If the problem persists, contact us.",
+                    options: this.options,
+                    exc
+                });
+                this.emit("ERROR", {
+                    err
+                });
+            }
+            if (this.stream) {
+                const connectionTimeoutMs = this.options.timeouts.connection;
+                this.connectionTimeout = window.setTimeout(()=>{
+                    if (this.isOnline() && this.isUserMediaLoaded()) {
+                        this.options.logger.debug(`${PIPE_SYMBOL}Reconnecting due to connection timeout.`);
+                        this.initSocket();
+                    } else this.failConnection({
+                        url2Connect,
+                        cause: "timeout"
                     });
-                    this.stream.on("connect", (args)=>{
-                        var _this_stream;
-                        this.options.logger.debug(`${PIPE_SYMBOL}Stream *connect* event emitted with args: ${util_pretty(args)}`);
-                        this.clearConnectionTimeout();
-                        const isClosing = (null == (_this_stream = this.stream) ? void 0 : _this_stream.socket.readyState) === WebSocket.CLOSING;
-                        if (!this.connected && !isClosing && !this.unloaded) {
-                            this.connected = true;
-                            this.connecting = this.unloaded = false;
-                            this.emit("CONNECTED");
-                            null == cb || cb();
-                        }
+                }, connectionTimeoutMs);
+                this.stream.on("close", ()=>{
+                    const debugLine = util_summarize(`${PIPE_SYMBOL}Stream has closed:`, {
+                        connecting: this.connecting,
+                        connected: this.connected,
+                        userMediaLoaded: this.userMediaLoaded,
+                        blocking: this.blocking
                     });
-                    this.stream.on("data", (data)=>{
-                        this.options.logger.debug(`${PIPE_SYMBOL}Stream *data* event emitted`);
-                        try {
-                            const command = JSON.parse(data.toString());
-                            this.executeCommand(command);
-                        } catch (exc) {
-                            this.options.logger.error(`Failed to parse command: ${exc}`);
-                            const err = error_createError({
-                                message: "Invalid server command",
-                                explanation: `Contact us. The invalid command was: ${data.toString()}.`,
-                                options: this.options,
-                                exc
-                            });
-                            this.emit("ERROR", {
-                                err
-                            });
-                        }
-                    });
-                    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);
-                        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({
+                    this.options.logger.debug(debugLine);
+                    const tryReconnect = this.connected && this.userMediaLoaded;
+                    this.connected = false;
+                    if (tryReconnect) this.initSocket();
+                    else if (!this.connecting && !this.blocking) window.setTimeout(()=>{
+                        this.failConnection({
                             url2Connect,
-                            cause: "error"
+                            cause: "closed"
                         });
-                        const streamError = err instanceof Error ? err : new Error("WebSocket stream emitted an error event", {
-                            cause: null != (_this_lastSocketError = this.lastSocketError) ? _this_lastSocketError : err
+                    }, 0);
+                });
+                this.stream.on("connect", (args)=>{
+                    var _this_stream;
+                    this.options.logger.debug(`${PIPE_SYMBOL}Stream *connect* event emitted with args: ${util_pretty(args)}`);
+                    this.clearConnectionTimeout();
+                    const isClosing = (null == (_this_stream = this.stream) ? void 0 : _this_stream.socket.readyState) === WebSocket.CLOSING;
+                    if (!this.connected && !isClosing && !this.unloaded) {
+                        this.connected = true;
+                        this.connecting = this.unloaded = false;
+                        this.emit("CONNECTED");
+                        null == cb || cb();
+                    }
+                });
+                this.stream.on("data", (data)=>{
+                    this.options.logger.debug(`${PIPE_SYMBOL}Stream *data* event emitted`);
+                    try {
+                        const command = JSON.parse(data.toString());
+                        this.executeCommand(command);
+                    } catch (exc) {
+                        this.options.logger.error(`Failed to parse command: ${exc}`);
+                        const err = error_createError({
+                            message: "Invalid server command",
+                            explanation: `Contact us. The invalid command was: ${data.toString()}.`,
+                            options: this.options,
+                            exc
                         });
                         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
-                            })
+                            err
                         });
+                    }
+                });
+                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);
+                    const debugLine = util_summarize(`${PIPE_SYMBOL}Stream *error* event emitted:`, {
+                        error: serializeError(err)
                     });
-                    this.stream.on("drain", ()=>{
-                        this.options.logger.debug(`${PIPE_SYMBOL}Stream *drain* event emitted (should not happen!)`);
-                    });
-                    this.stream.on("preend", (args)=>{
-                        this.options.logger.debug(`${PIPE_SYMBOL}Stream *preend* event emitted with args: ${util_pretty(args)}`);
-                    });
-                    this.stream.on("end", ()=>{
-                        this.options.logger.debug(`${PIPE_SYMBOL}Stream *end* event emitted`);
-                    });
-                    this.stream.on("drain", (args)=>{
-                        this.options.logger.debug(`${PIPE_SYMBOL}Stream *drain* event emitted with args: ${util_pretty(args)}`);
-                    });
-                    this.stream.on("pipe", (src)=>{
-                        this.options.logger.debug(`${PIPE_SYMBOL}Stream *pipe* event emitted with src: ${util_pretty(src)}`);
-                    });
-                    this.stream.on("unpipe", (src)=>{
-                        this.options.logger.debug(`${PIPE_SYMBOL}Stream *unpipe* event emitted with src: ${util_pretty(src)}`);
-                    });
-                    this.stream.on("resume", (args)=>{
-                        this.options.logger.debug(`${PIPE_SYMBOL}Stream *resume* event emitted with args: ${util_pretty(args)}`);
-                    });
-                    this.stream.on("uncork", (args)=>{
-                        this.options.logger.debug(`${PIPE_SYMBOL}Stream *uncork* event emitted with args: ${util_pretty(args)}`);
-                    });
-                    this.stream.on("readable", (args)=>{
-                        this.options.logger.debug(`${PIPE_SYMBOL}Stream *readable* event emitted with args: ${util_pretty(args)}`);
+                    this.options.logger.debug(debugLine);
+                    if (!this.connected) return void this.failConnection({
+                        url2Connect,
+                        cause: "error"
                     });
-                    this.stream.on("prefinish", (args)=>{
-                        this.options.logger.debug(`${PIPE_SYMBOL}Stream *prefinish* event emitted with args: ${util_pretty(args)}`);
+                    const streamError = err instanceof Error ? err : new Error("WebSocket stream emitted an error event", {
+                        cause: null != (_this_lastSocketError = this.lastSocketError) ? _this_lastSocketError : err
                     });
-                    this.stream.on("finish", (args)=>{
-                        this.options.logger.debug(`${PIPE_SYMBOL}Stream *finish* event emitted with args: ${util_pretty(args)}`);
+                    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!)`);
+                });
+                this.stream.on("preend", (args)=>{
+                    this.options.logger.debug(`${PIPE_SYMBOL}Stream *preend* event emitted with args: ${util_pretty(args)}`);
+                });
+                this.stream.on("end", ()=>{
+                    this.options.logger.debug(`${PIPE_SYMBOL}Stream *end* event emitted`);
+                });
+                this.stream.on("drain", (args)=>{
+                    this.options.logger.debug(`${PIPE_SYMBOL}Stream *drain* event emitted with args: ${util_pretty(args)}`);
+                });
+                this.stream.on("pipe", (src)=>{
+                    this.options.logger.debug(`${PIPE_SYMBOL}Stream *pipe* event emitted with src: ${util_pretty(src)}`);
+                });
+                this.stream.on("unpipe", (src)=>{
+                    this.options.logger.debug(`${PIPE_SYMBOL}Stream *unpipe* event emitted with src: ${util_pretty(src)}`);
+                });
+                this.stream.on("resume", (args)=>{
+                    this.options.logger.debug(`${PIPE_SYMBOL}Stream *resume* event emitted with args: ${util_pretty(args)}`);
+                });
+                this.stream.on("uncork", (args)=>{
+                    this.options.logger.debug(`${PIPE_SYMBOL}Stream *uncork* event emitted with args: ${util_pretty(args)}`);
+                });
+                this.stream.on("readable", (args)=>{
+                    this.options.logger.debug(`${PIPE_SYMBOL}Stream *readable* event emitted with args: ${util_pretty(args)}`);
+                });
+                this.stream.on("prefinish", (args)=>{
+                    this.options.logger.debug(`${PIPE_SYMBOL}Stream *prefinish* event emitted with args: ${util_pretty(args)}`);
+                });
+                this.stream.on("finish", (args)=>{
+                    this.options.logger.debug(`${PIPE_SYMBOL}Stream *finish* event emitted with args: ${util_pretty(args)}`);
+                });
             }
         }
         showUserMedia() {