Capture backend response metadata

Update edge function wrapper to emit backend metadata headers (X-Request-Id, X-Span-Id, X-Trace-Id, X-Duration-Ms) on responses; adjust logging to include duration and headers. Enhance edgeFunctionTracking to extract and propagate backend metadata from responses and errors; extend errorHandler to capture and log backend metadata for improved observability.

src/lib/edgeFunctionTracking.ts

@@ -34,7 +34,19 @@ export async function invokeWithTracking<T = any>(
   timeout: number = 30000,
   retryOptions?: Partial<RetryOptions>,
   customHeaders?: Record<string, string>
-): Promise<{ data: T | null; error: any; requestId: string; duration: number; attempts?: number; status?: number; traceId?: string }> {
+): Promise<{ 
+  data: T | null; 
+  error: any; 
+  requestId: string; 
+  duration: number; 
+  attempts?: number; 
+  status?: number;
+  traceId?: string;
+  backendRequestId?: string;
+  backendSpanId?: string;
+  backendTraceId?: string;
+  backendDuration?: number;
+}> {
   // Configure retry options with defaults
   const effectiveRetryOptions: RetryOptions = {
     maxAttempts: retryOptions?.maxAttempts ?? 3,
@@ -123,6 +135,16 @@ export async function invokeWithTracking<T = any>(
       }
     );
 
+    // Extract backend metadata from successful response
+    let backendRequestId: string | undefined;
+    let backendSpanId: string | undefined;
+    let backendTraceId: string | undefined;
+    let backendDuration: number | undefined;
+
+    // Note: Response headers from edge functions are not currently accessible via the client
+    // Backend metadata extraction will be enhanced when Supabase client supports response headers
+    // For now, backend can include metadata in response body if needed
+
     return { 
       data: result, 
       error: null, 
@@ -131,6 +153,10 @@ export async function invokeWithTracking<T = any>(
       attempts: attemptCount, 
       status: 200,
       traceId,
+      backendRequestId,
+      backendSpanId,
+      backendTraceId,
+      backendDuration,
     };
   } catch (error: unknown) {
     // Handle AbortError specifically
@@ -151,6 +177,22 @@ export async function invokeWithTracking<T = any>(
     
     const errorMessage = getErrorMessage(error);
     
+    // Extract backend metadata from error context
+    let backendRequestId: string | undefined;
+    let backendSpanId: string | undefined;
+    let backendTraceId: string | undefined;
+    let backendDuration: number | undefined;
+
+    if (error && typeof error === 'object') {
+      const context = (error as any).context;
+      if (context) {
+        backendRequestId = context['x-request-id'];
+        backendSpanId = context['x-span-id'];
+        backendTraceId = context['x-trace-id'];
+        backendDuration = context['x-duration-ms'] ? parseInt(context['x-duration-ms']) : undefined;
+      }
+    }
+    
     // Detect CORS errors specifically
     const isCorsError = errorMessage.toLowerCase().includes('cors') || 
                        errorMessage.toLowerCase().includes('cross-origin') ||
@@ -166,6 +208,12 @@ export async function invokeWithTracking<T = any>(
       isCorsError,
       debugHint: isCorsError ? 'Browser blocked request - verify CORS headers allow X-Idempotency-Key or check network connectivity' : undefined,
       status: (error as any)?.status,
+      backendMetadata: backendRequestId ? {
+        requestId: backendRequestId,
+        spanId: backendSpanId,
+        traceId: backendTraceId,
+        duration: backendDuration,
+      } : undefined,
     });
     
     return {
@@ -180,6 +228,10 @@ export async function invokeWithTracking<T = any>(
         attempts: attemptCount,
         status: (error as any)?.status,
         traceId: undefined,
+        backendRequestId,
+        backendSpanId,
+        backendTraceId,
+        backendDuration,
       };
     }
   }