videomail-client 15.7.0 → 15.7.2

package/dist/cjs/index.cjs

@@ -10932,7 +10932,7 @@ var __webpack_exports__ = {};
     var client = __webpack_require__(5734);
     var client_default = /*#__PURE__*/ __webpack_require__.n(client);
     var package_namespaceObject = {
-        rE: "15.7.0"
+        rE: "15.7.2"
     };
     function isAudioEnabled(options) {
         return Boolean(options.audio.enabled);
@@ -17539,17 +17539,30 @@ var __webpack_exports__ = {};
             this.connectionTimeout = void 0;
         }
         failConnection(params) {
+            var _ref, _ref1;
             if (this.connectionFailed || this.connected || this.unloaded) return;
             this.connectionFailed = true;
             this.connecting = false;
             this.clearConnectionTimeout();
+            const { url2Connect, cause } = params;
+            const online = navigator.onLine;
+            const elapsedMs = this.connectingStartedAt ? Date.now() - this.connectingStartedAt : void 0;
+            const closeEvent = this.lastCloseEvent;
+            this.options.logger.debug(`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"}`);
+            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 {
+                const closeSuffix = closeEvent ? ` (close code ${closeEvent.code})` : "";
+                explanation = `The connection to ${url2Connect} was refused or could not be reached${closeSuffix}. Please check your internet connection and try again. If the problem persists, contact us.`;
+            }
+            else explanation = "Your device appears to be offline. Please check your internet connection and try again.";
             if (this.stream) {
                 this.stream.destroy();
                 this.stream = void 0;
             }
             const err = error_createError({
                 message: "Unable to connect to the server",
-                explanation: params.explanation,
+                explanation,
                 options: this.options
             });
             this.emit("ERROR", {
@@ -17629,6 +17642,8 @@ var __webpack_exports__ = {};
             if (!this.connected) {
                 this.connecting = true;
                 this.connectionFailed = false;
+                this.connectingStartedAt = Date.now();
+                this.lastCloseEvent = void 0;
                 this.emit("CONNECTING");
                 let url2Connect;
                 try {
@@ -17652,6 +17667,13 @@ var __webpack_exports__ = {};
                 let nativeSocket;
                 try {
                     nativeSocket = new WebSocket(url2Connect);
+                    nativeSocket.addEventListener("close", (event)=>{
+                        this.lastCloseEvent = {
+                            code: event.code,
+                            reason: event.reason,
+                            wasClean: event.wasClean
+                        };
+                    });
                 } catch (exc) {
                     this.connecting = this.connected = false;
                     const diagnostic = error_getWebSocketDiagnostic(url2Connect);
@@ -17687,7 +17709,7 @@ var __webpack_exports__ = {};
                     this.connectionTimeout = window.setTimeout(()=>{
                         this.failConnection({
                             url2Connect,
-                            explanation: `The server at ${url2Connect} did not respond within ${connectionTimeoutMs}ms. Please check your internet connection and try again. If the problem persists, contact us.`
+                            cause: "timeout"
                         });
                     }, connectionTimeoutMs);
                     this.stream.on("close", ()=>{
@@ -17697,7 +17719,7 @@ var __webpack_exports__ = {};
                         this.connecting = this.connected = false;
                         if (neverConnected) this.failConnection({
                             url2Connect,
-                            explanation: `The connection to ${url2Connect} was refused or could not be reached. Please check your internet connection and try again. If the problem persists, contact us.`
+                            cause: "closed"
                         });
                         else if (this.userMediaLoaded) this.initSocket();
                     });
@@ -18482,7 +18504,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, "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, "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

@@ -3620,7 +3620,7 @@ const constants = {
     }
 };
 var package_namespaceObject = {
-    rE: "15.7.0"
+    rE: "15.7.2"
 };
 function isAudioEnabled(options) {
     return Boolean(options.audio.enabled);
@@ -6606,13 +6606,25 @@ class Recorder extends util_Despot {
         this.connectionFailed = true;
         this.connecting = false;
         this.clearConnectionTimeout();
+        const { url2Connect, cause } = params;
+        const online = navigator.onLine;
+        const elapsedMs = this.connectingStartedAt ? Date.now() - this.connectingStartedAt : void 0;
+        const closeEvent = this.lastCloseEvent;
+        this.options.logger.debug(`Recorder: failConnection() diagnostic - cause=${cause}, online=${online}, elapsedMs=${elapsedMs ?? "unknown"}, closeCode=${closeEvent?.code ?? "none"}, closeReason=${closeEvent?.reason || "none"}, wasClean=${closeEvent?.wasClean ?? "unknown"}`);
+        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 {
+            const closeSuffix = closeEvent ? ` (close code ${closeEvent.code})` : "";
+            explanation = `The connection to ${url2Connect} was refused or could not be reached${closeSuffix}. Please check your internet connection and try again. If the problem persists, contact us.`;
+        }
+        else explanation = "Your device appears to be offline. Please check your internet connection and try again.";
         if (this.stream) {
             this.stream.destroy();
             this.stream = void 0;
         }
         const err = error_createError({
             message: "Unable to connect to the server",
-            explanation: params.explanation,
+            explanation,
             options: this.options
         });
         this.emit("ERROR", {
@@ -6691,6 +6703,8 @@ class Recorder extends util_Despot {
         if (!this.connected) {
             this.connecting = true;
             this.connectionFailed = false;
+            this.connectingStartedAt = Date.now();
+            this.lastCloseEvent = void 0;
             this.emit("CONNECTING");
             let url2Connect;
             try {
@@ -6714,6 +6728,13 @@ class Recorder extends util_Despot {
             let nativeSocket;
             try {
                 nativeSocket = new WebSocket(url2Connect);
+                nativeSocket.addEventListener("close", (event)=>{
+                    this.lastCloseEvent = {
+                        code: event.code,
+                        reason: event.reason,
+                        wasClean: event.wasClean
+                    };
+                });
             } catch (exc) {
                 this.connecting = this.connected = false;
                 const diagnostic = error_getWebSocketDiagnostic(url2Connect);
@@ -6749,7 +6770,7 @@ class Recorder extends util_Despot {
                 this.connectionTimeout = window.setTimeout(()=>{
                     this.failConnection({
                         url2Connect,
-                        explanation: `The server at ${url2Connect} did not respond within ${connectionTimeoutMs}ms. Please check your internet connection and try again. If the problem persists, contact us.`
+                        cause: "timeout"
                     });
                 }, connectionTimeoutMs);
                 this.stream.on("close", ()=>{
@@ -6759,7 +6780,7 @@ class Recorder extends util_Despot {
                     this.connecting = this.connected = false;
                     if (neverConnected) this.failConnection({
                         url2Connect,
-                        explanation: `The connection to ${url2Connect} was refused or could not be reached. Please check your internet connection and try again. If the problem persists, contact us.`
+                        cause: "closed"
                     });
                     else if (this.userMediaLoaded) this.initSocket();
                 });
@@ -7528,7 +7549,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, "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, "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/Videomail.d.ts

@@ -31,9 +31,12 @@ export interface Videomail {
     dateCreatedServerPretty: string;
     dateUpdated?: number;
     dateUpdatedServerPretty?: string;
+    expired?: boolean;
     expiresAfter: number;
     expiresAfterIso: string;
     expiresAfterServerPretty: string;
+    orphaned?: boolean;
+    permanent?: boolean;
     format?: VideoFormat;
     height?: number | undefined;
     width?: number | undefined;

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

@@ -67,9 +67,12 @@ declare class Form extends Despot {
         dateCreatedServerPretty?: string;
         dateUpdated?: number;
         dateUpdatedServerPretty?: string;
+        expired?: boolean;
         expiresAfter?: number;
         expiresAfterIso?: string;
         expiresAfterServerPretty?: string;
+        orphaned?: boolean;
+        permanent?: boolean;
         format?: {
             [x: string]: string | number | {
                 [x: string]: string | undefined;
@@ -252,9 +255,12 @@ declare class Form extends Despot {
         dateCreatedServerPretty?: string;
         dateUpdated?: number;
         dateUpdatedServerPretty?: string;
+        expired?: boolean;
         expiresAfter?: number;
         expiresAfterIso?: string;
         expiresAfterServerPretty?: string;
+        orphaned?: boolean;
+        permanent?: boolean;
         format?: {
             [x: string]: string | number | {
                 [x: string]: string | undefined;

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

@@ -43,6 +43,8 @@ declare class Recorder extends Despot {
     private built;
     private key?;
     private waitingTime?;
+    private connectingStartedAt?;
+    private lastCloseEvent?;
     private pingInterval?;
     private frame?;
     private recordingBuffer?;

package/dist/umd/index.js

@@ -10938,7 +10938,7 @@
             var client = __webpack_require__(5734);
             var client_default = /*#__PURE__*/ __webpack_require__.n(client);
             var package_namespaceObject = {
-                rE: "15.7.0"
+                rE: "15.7.2"
             };
             function isAudioEnabled(options) {
                 return Boolean(options.audio.enabled);
@@ -17206,6 +17206,8 @@
                 built = false;
                 key;
                 waitingTime;
+                connectingStartedAt;
+                lastCloseEvent;
                 pingInterval;
                 frame;
                 recordingBuffer;
@@ -17313,13 +17315,25 @@
                     this.connectionFailed = true;
                     this.connecting = false;
                     this.clearConnectionTimeout();
+                    const { url2Connect, cause } = params;
+                    const online = navigator.onLine;
+                    const elapsedMs = this.connectingStartedAt ? Date.now() - this.connectingStartedAt : void 0;
+                    const closeEvent = this.lastCloseEvent;
+                    this.options.logger.debug(`Recorder: failConnection() diagnostic - cause=${cause}, online=${online}, elapsedMs=${elapsedMs ?? "unknown"}, closeCode=${closeEvent?.code ?? "none"}, closeReason=${closeEvent?.reason || "none"}, wasClean=${closeEvent?.wasClean ?? "unknown"}`);
+                    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 {
+                        const closeSuffix = closeEvent ? ` (close code ${closeEvent.code})` : "";
+                        explanation = `The connection to ${url2Connect} was refused or could not be reached${closeSuffix}. Please check your internet connection and try again. If the problem persists, contact us.`;
+                    }
+                    else explanation = "Your device appears to be offline. Please check your internet connection and try again.";
                     if (this.stream) {
                         this.stream.destroy();
                         this.stream = void 0;
                     }
                     const err = error_createError({
                         message: "Unable to connect to the server",
-                        explanation: params.explanation,
+                        explanation,
                         options: this.options
                     });
                     this.emit("ERROR", {
@@ -17398,6 +17412,8 @@
                     if (!this.connected) {
                         this.connecting = true;
                         this.connectionFailed = false;
+                        this.connectingStartedAt = Date.now();
+                        this.lastCloseEvent = void 0;
                         this.emit("CONNECTING");
                         let url2Connect;
                         try {
@@ -17421,6 +17437,13 @@
                         let nativeSocket;
                         try {
                             nativeSocket = new WebSocket(url2Connect);
+                            nativeSocket.addEventListener("close", (event)=>{
+                                this.lastCloseEvent = {
+                                    code: event.code,
+                                    reason: event.reason,
+                                    wasClean: event.wasClean
+                                };
+                            });
                         } catch (exc) {
                             this.connecting = this.connected = false;
                             const diagnostic = error_getWebSocketDiagnostic(url2Connect);
@@ -17456,7 +17479,7 @@
                             this.connectionTimeout = window.setTimeout(()=>{
                                 this.failConnection({
                                     url2Connect,
-                                    explanation: `The server at ${url2Connect} did not respond within ${connectionTimeoutMs}ms. Please check your internet connection and try again. If the problem persists, contact us.`
+                                    cause: "timeout"
                                 });
                             }, connectionTimeoutMs);
                             this.stream.on("close", ()=>{
@@ -17466,7 +17489,7 @@
                                 this.connecting = this.connected = false;
                                 if (neverConnected) this.failConnection({
                                     url2Connect,
-                                    explanation: `The connection to ${url2Connect} was refused or could not be reached. Please check your internet connection and try again. If the problem persists, contact us.`
+                                    cause: "closed"
                                 });
                                 else if (this.userMediaLoaded) this.initSocket();
                             });

package/package.json

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