@vapi-ai/web 2.5.0 → 2.5.2

package/vapi.ts

@@ -98,6 +98,73 @@ interface CallStartFailedEvent {
   context: Record<string, any>;
 }
 
+interface SerializedError {
+  message: string;
+  name?: string;
+  stack?: string;
+  code?: string | number;
+  cause?: string;
+  [key: string]: any;
+}
+
+/**
+ * Extracts error details into a plain object that serializes properly to JSON.
+ * Error objects don't serialize well because their properties (message, stack, name) 
+ * are not enumerable and get lost when using JSON.stringify().
+ */
+function serializeError(error: unknown): SerializedError {
+  if (error === null || error === undefined) {
+    return { message: 'Unknown error (null or undefined)' };
+  }
+  
+  if (error instanceof Error) {
+    const serialized: SerializedError = {
+      message: error.message,
+      name: error.name,
+      stack: error.stack,
+    };
+    
+    // Include any additional properties that might be on the error
+    const errorAsAny = error as any;
+    if (errorAsAny.code !== undefined) {
+      serialized.code = errorAsAny.code;
+    }
+    if (errorAsAny.cause !== undefined) {
+      serialized.cause = String(errorAsAny.cause);
+    }
+    if (errorAsAny.reason !== undefined) {
+      serialized.reason = errorAsAny.reason;
+    }
+    if (errorAsAny.details !== undefined) {
+      serialized.details = errorAsAny.details;
+    }
+    // Daily.co specific error properties
+    if (errorAsAny.errorMsg !== undefined) {
+      serialized.errorMsg = errorAsAny.errorMsg;
+    }
+    if (errorAsAny.error !== undefined && typeof errorAsAny.error === 'string') {
+      serialized.errorDetail = errorAsAny.error;
+    }
+    
+    return serialized;
+  }
+  
+  if (typeof error === 'string') {
+    return { message: error };
+  }
+  
+  if (typeof error === 'object') {
+    // It's already a plain object, but let's ensure message exists
+    const errorObj = error as Record<string, any>;
+    return {
+      message: errorObj.message || errorObj.error || JSON.stringify(error),
+      ...errorObj
+    };
+  }
+  
+  return { message: String(error) };
+}
+
 type VapiEventListeners = {
   'call-end': () => void;
   'call-start': () => void;
@@ -298,7 +365,7 @@ export default class Vapi extends VapiEventEmitter {
       this.emit('error', { 
         type: 'validation-error', 
         stage: 'input-validation',
-        message: error.message,
+        error: serializeError(error),
         timestamp: new Date().toISOString()
       });
       throw error;
@@ -410,17 +477,18 @@ export default class Vapi extends VapiEventEmitter {
         });
       } catch (error) {
         const dailyCallDuration = Date.now() - dailyCallStartTime;
+        const serializedError = serializeError(error);
         this.emit('call-start-progress', {
           stage: 'daily-call-object-creation',
           status: 'failed',
           duration: dailyCallDuration,
           timestamp: new Date().toISOString(),
-          metadata: { error: error?.toString() }
+          metadata: { error: serializedError.message }
         });
         this.emit('error', {
           type: 'daily-call-object-creation-error',
           stage: 'daily-call-object-creation',
-          error,
+          error: serializedError,
           timestamp: new Date().toISOString()
         });
         throw error;
@@ -445,14 +513,22 @@ export default class Vapi extends VapiEventEmitter {
       });
 
       this.call.on('error', (error: any) => {
-        this.emit('error', error);
+        this.emit('error', {
+          type: 'daily-error',
+          error: serializeError(error),
+          timestamp: new Date().toISOString()
+        });
         if (isVideoRecordingEnabled) {
           this.call?.stopRecording();
         }
       });
 
       this.call.on('camera-error', (error: any) => {
-        this.emit('camera-error', error);
+        this.emit('camera-error', {
+          type: 'camera-error',
+          error: serializeError(error),
+          timestamp: new Date().toISOString()
+        });
       });
 
       this.call.on('network-quality-change', (event: any) => {
@@ -560,17 +636,18 @@ export default class Vapi extends VapiEventEmitter {
         });
       } catch (error) {
         const joinDuration = Date.now() - joinStartTime;
+        const serializedError = serializeError(error);
         this.emit('call-start-progress', {
           stage: 'daily-call-join',
           status: 'failed',
           duration: joinDuration,
           timestamp: new Date().toISOString(),
-          metadata: { error: error?.toString() }
+          metadata: { error: serializedError.message }
         });
         this.emit('error', {
           type: 'daily-call-join-error',
           stage: 'daily-call-join',
-          error,
+          error: serializedError,
           duration: joinDuration,
           timestamp: new Date().toISOString()
         });
@@ -623,17 +700,18 @@ export default class Vapi extends VapiEventEmitter {
           });
         } catch (error) {
           const recordingSetupDuration = Date.now() - recordingStartTime;
+          const serializedError = serializeError(error);
           this.emit('call-start-progress', {
             stage: 'video-recording-setup',
             status: 'failed',
             duration: recordingSetupDuration,
             timestamp: new Date().toISOString(),
-            metadata: { error: error?.toString() }
+            metadata: { error: serializedError.message }
           });
           this.emit('error', {
             type: 'video-recording-setup-error',
             stage: 'video-recording-setup',
-            error,
+            error: serializedError,
             timestamp: new Date().toISOString()
           });
           // Don't throw here, video recording is optional
@@ -667,17 +745,18 @@ export default class Vapi extends VapiEventEmitter {
         });
       } catch (error) {
         const audioObserverDuration = Date.now() - audioObserverStartTime;
+        const serializedError = serializeError(error);
         this.emit('call-start-progress', {
           stage: 'audio-observer-setup',
           status: 'failed',
           duration: audioObserverDuration,
           timestamp: new Date().toISOString(),
-          metadata: { error: error?.toString() }
+          metadata: { error: serializedError.message }
         });
         this.emit('error', {
           type: 'audio-observer-setup-error',
           stage: 'audio-observer-setup',
-          error,
+          error: serializedError,
           timestamp: new Date().toISOString()
         });
         // Don't throw here, this is non-critical
@@ -733,17 +812,18 @@ export default class Vapi extends VapiEventEmitter {
         });
       } catch (error) {
         const audioProcessingDuration = Date.now() - audioProcessingStartTime;
+        const serializedError = serializeError(error);
         this.emit('call-start-progress', {
           stage: 'audio-processing-setup',
           status: 'failed',
           duration: audioProcessingDuration,
           timestamp: new Date().toISOString(),
-          metadata: { error: error?.toString() }
+          metadata: { error: serializedError.message }
         });
         this.emit('error', {
           type: 'audio-processing-setup-error',
           stage: 'audio-processing-setup',
-          error,
+          error: serializedError,
           timestamp: new Date().toISOString()
         });
         // Don't throw here, this is non-critical
@@ -759,12 +839,13 @@ export default class Vapi extends VapiEventEmitter {
       return webCall;
     } catch (e) {
       const totalDuration = Date.now() - startTime;
+      const serializedError = serializeError(e);
       
       this.emit('call-start-failed', {
         stage: 'unknown',
         totalDuration,
-        error: e?.toString() || 'Unknown error occurred',
-        errorStack: e instanceof Error ? e.stack : 'No stack trace available',
+        error: serializedError.message,
+        errorStack: serializedError.stack || 'No stack trace available',
         timestamp: new Date().toISOString(),
         context: {
           hasAssistant: !!assistant,
@@ -778,7 +859,7 @@ export default class Vapi extends VapiEventEmitter {
       this.emit('error', {
         type: 'start-method-error',
         stage: 'unknown',
-        error: e,
+        error: serializedError,
         totalDuration,
         timestamp: new Date().toISOString(),
         context: {
@@ -1054,14 +1135,22 @@ export default class Vapi extends VapiEventEmitter {
       });
 
       this.call.on('error', (error: any) => {
-        this.emit('error', error);
+        this.emit('error', {
+          type: 'daily-error',
+          error: serializeError(error),
+          timestamp: new Date().toISOString()
+        });
         if (isVideoRecordingEnabled) {
           this.call?.stopRecording();
         }
       });
 
       this.call.on('camera-error', (error: any) => {
-        this.emit('camera-error', error);
+        this.emit('camera-error', {
+          type: 'camera-error',
+          error: serializeError(error),
+          timestamp: new Date().toISOString()
+        });
       });
 
       this.call.on('network-quality-change', (event: any) => {
@@ -1234,12 +1323,13 @@ export default class Vapi extends VapiEventEmitter {
           });
         } catch (error) {
           const recordingSetupDuration = Date.now() - recordingStartTime;
+          const serializedError = serializeError(error);
           this.emit('call-start-progress', {
             stage: 'video-recording-setup',
             status: 'failed',
             duration: recordingSetupDuration,
             timestamp: new Date().toISOString(),
-            metadata: { error: error?.toString() }
+            metadata: { error: serializedError.message }
           });
           // Don't throw here, video recording is optional
         }
@@ -1272,12 +1362,13 @@ export default class Vapi extends VapiEventEmitter {
         });
       } catch (error) {
         const audioObserverDuration = Date.now() - audioObserverStartTime;
+        const serializedError = serializeError(error);
         this.emit('call-start-progress', {
           stage: 'audio-observer-setup',
           status: 'failed',
           duration: audioObserverDuration,
           timestamp: new Date().toISOString(),
-          metadata: { error: error?.toString() }
+          metadata: { error: serializedError.message }
         });
         // Don't throw here, this is non-critical
       }
@@ -1309,12 +1400,13 @@ export default class Vapi extends VapiEventEmitter {
         });
       } catch (error) {
         const audioProcessingDuration = Date.now() - audioProcessingStartTime;
+        const serializedError = serializeError(error);
         this.emit('call-start-progress', {
           stage: 'audio-processing-setup',
           status: 'failed',
           duration: audioProcessingDuration,
           timestamp: new Date().toISOString(),
-          metadata: { error: error?.toString() }
+          metadata: { error: serializedError.message }
         });
         // Don't throw here, this is non-critical
       }
@@ -1330,12 +1422,13 @@ export default class Vapi extends VapiEventEmitter {
 
     } catch (e) {
       const totalDuration = Date.now() - startTime;
+      const serializedError = serializeError(e);
       
       this.emit('call-start-failed', {
         stage: 'reconnect',
         totalDuration,
-        error: e?.toString() || 'Unknown error occurred',
-        errorStack: e instanceof Error ? e.stack : 'No stack trace available',
+        error: serializedError.message,
+        errorStack: serializedError.stack || 'No stack trace available',
         timestamp: new Date().toISOString(),
         context: {
           isReconnect: true,
@@ -1349,7 +1442,7 @@ export default class Vapi extends VapiEventEmitter {
       // Also emit the generic error event for backward compatibility
       this.emit('error', {
         type: 'reconnect-error',
-        error: e,
+        error: serializedError,
         totalDuration,
         timestamp: new Date().toISOString(),
         context: {
@@ -1365,4 +1458,129 @@ export default class Vapi extends VapiEventEmitter {
       throw e;
     }
   }
+
+  /**
+   * Runs all network connectivity tests for pre-call diagnostics.
+   * Creates a temporary Daily call object for testing purposes.
+   * 
+   * Tests performed:
+   * 1. Network connectivity (TURN server) - Tests if traffic can be relayed through TURN servers
+   * 2. Websocket connectivity - Tests if websocket connections can be established  
+   * 3. Call quality - Tests overall call quality metrics (if available in SDK version)
+   * 
+   * @returns {Promise<Record<string, any>>} Test results object with status for each test
+   * 
+   * @example
+   * // Run pre-call network diagnostics
+   * const results = await Vapi.runNetworkTestsStandalone();
+   * if (results.networkConnectivity?.result === 'failed') {
+   *   console.warn('Network issues detected - calls may not work properly');
+   * }
+   * 
+   * @static
+   */
+  public static async runNetworkTestsStandalone(): Promise<Record<string, any>> {
+    console.log('Starting standalone network connectivity tests...');
+    
+    const results: Record<string, any> = {};
+    let tempCall: DailyCall | null = null;
+    
+    try {
+      // Create a temporary call object for testing
+      console.log('Creating temporary call object for testing...');
+      tempCall = DailyIframe.createCallObject({
+        audioSource: true,
+        videoSource: true,
+      });
+
+      // Test 1: Network Connectivity (TURN server test)
+      console.log('\n1. Testing network connectivity (TURN server)...');
+      let videoTrack: MediaStreamTrack | null = null;
+      
+      try {
+        // Create a dummy video track for the test
+        const stream = await navigator.mediaDevices.getUserMedia({ video: true });
+        videoTrack = stream.getVideoTracks()[0];
+        
+        const networkTest = await tempCall.testNetworkConnectivity(videoTrack);
+        results.networkConnectivity = networkTest;
+        console.log('Network connectivity test result:', networkTest);
+      } catch (error) {
+        results.networkConnectivity = { result: 'error', error: error?.toString() };
+        console.error('Network connectivity test error:', error);
+      } finally {
+        // Clean up the video track
+        if (videoTrack) {
+          videoTrack.stop();
+        }
+      }
+
+      // Test 2: Websocket Connectivity
+      console.log('\n2. Testing websocket connectivity...');
+      try {
+        const websocketTest = await tempCall.testWebsocketConnectivity();
+        results.websocketConnectivity = websocketTest;
+        console.log('Websocket connectivity test result:', websocketTest);
+      } catch (error) {
+        results.websocketConnectivity = { result: 'error', error: error?.toString() };
+        console.error('Websocket connectivity test error:', error);
+      }
+
+      // Test 3: Call Quality (if available)
+      console.log('\n3. Testing call quality...');
+      try {
+        // Check if the method exists
+        if (typeof tempCall.testCallQuality === 'function') {
+          // Call quality test requires startCamera to initialize call state
+          try {
+            // Use startCamera to initialize the call state without needing a room
+            console.log('Initializing call state with startCamera...');
+            await tempCall.startCamera();
+            
+            // Now run the call quality test
+            const callQualityTest = await tempCall.testCallQuality();
+            results.callQuality = callQualityTest;
+            console.log('Call quality test result:', callQualityTest);
+            
+            // Camera will be cleaned up when we destroy the call object
+          } catch (startCameraError: any) {
+            // If startCamera fails, it might be due to permissions or other issues
+            console.error('Failed to start camera for call quality test:', startCameraError);
+            results.callQuality = { 
+              result: 'error', 
+              error: startCameraError?.toString(),
+              message: 'Failed to initialize camera for call quality test. Check camera permissions.' 
+            };
+          }
+        } else {
+          results.callQuality = { result: 'not-available', message: 'testCallQuality method not available' };
+          console.log('Call quality test not available in current Daily.co version');
+        }
+      } catch (error: any) {
+        results.callQuality = { result: 'error', error: error?.toString() };
+        console.error('Call quality test error:', error);
+      }
+
+    } catch (error) {
+      console.error('Failed to create temporary call object:', error);
+      results.error = error?.toString();
+    } finally {
+      // Clean up the temporary call object
+      if (tempCall) {
+        try {
+          console.log('Cleaning up temporary call object...');
+          await tempCall.destroy();
+        } catch (error) {
+          console.error('Error destroying temporary call object:', error);
+        }
+      }
+    }
+
+    // Summary
+    console.log('\n=== Network Test Summary ===');
+    console.log('Results:', JSON.stringify(results, null, 2));
+    
+    return results;
+  }
+
 }