@getmicdrop/svelte-components 5.5.4 → 5.6.0

package/dist/telemetry.spec.js

@@ -1,661 +1,1144 @@
-// @ts-nocheck
-import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
-
-// Mock all OpenTelemetry modules before importing telemetry
-vi.mock('@opentelemetry/sdk-trace-web', () => ({
-  WebTracerProvider: vi.fn().mockImplementation(() => ({
-    addSpanProcessor: vi.fn(),
-    register: vi.fn(),
-    getTracer: vi.fn().mockReturnValue({
-      startSpan: vi.fn().mockReturnValue({
-        setAttribute: vi.fn(),
-        setStatus: vi.fn(),
-        recordException: vi.fn(),
-        end: vi.fn(),
-        name: 'test-span',
-      }),
-    }),
-    shutdown: vi.fn().mockResolvedValue(undefined),
-  })),
-}));
-
-vi.mock('@opentelemetry/sdk-trace-base', () => ({
-  BatchSpanProcessor: vi.fn(),
-}));
-
-vi.mock('@opentelemetry/exporter-trace-otlp-http', () => ({
-  OTLPTraceExporter: vi.fn(),
-}));
-
-vi.mock('@opentelemetry/resources', () => ({
-  Resource: vi.fn(),
-}));
-
-vi.mock('@opentelemetry/semantic-conventions', () => ({
-  SEMRESATTRS_SERVICE_NAME: 'service.name',
-  SEMRESATTRS_SERVICE_VERSION: 'service.version',
-  SEMRESATTRS_DEPLOYMENT_ENVIRONMENT: 'deployment.environment',
-}));
-
-vi.mock('@opentelemetry/instrumentation-document-load', () => ({
-  DocumentLoadInstrumentation: vi.fn().mockImplementation(() => ({
-    enable: vi.fn(),
-  })),
-}));
-
-vi.mock('@opentelemetry/instrumentation-fetch', () => ({
-  FetchInstrumentation: vi.fn().mockImplementation(() => ({
-    enable: vi.fn(),
-  })),
-}));
-
-vi.mock('@opentelemetry/instrumentation-xml-http-request', () => ({
-  XMLHttpRequestInstrumentation: vi.fn().mockImplementation(() => ({
-    enable: vi.fn(),
-  })),
-}));
-
-vi.mock('@opentelemetry/instrumentation-user-interaction', () => ({
-  UserInteractionInstrumentation: vi.fn().mockImplementation(() => ({
-    enable: vi.fn(),
-  })),
-}));
-
-vi.mock('@opentelemetry/context-zone', () => ({
-  ZoneContextManager: vi.fn(),
-}));
-
-vi.mock('@opentelemetry/propagator-b3', () => ({
-  B3Propagator: vi.fn(),
-}));
-
-describe('Telemetry Module', () => {
-  let telemetry;
-  let originalWindow;
-  let originalDocument;
-  let mockSpan;
-
-  beforeEach(async () => {
-    vi.resetModules();
-
-    // Save original globals
-    originalWindow = global.window;
-    originalDocument = global.document;
-
-    // Setup mock window
-    global.window = {
-      location: {
-        pathname: '/performers',
-        search: '?test=1',
-        hash: '#section',
-        href: 'http://localhost/performers?test=1#section',
-      },
-      addEventListener: vi.fn(),
-      __TRACE_CONTEXT__: null,
-    };
-
-    global.document = {
-      readyState: 'complete',
-      title: 'Test Page',
-      referrer: 'http://localhost/',
-      addEventListener: vi.fn(),
-    };
-
-    global.navigator = {
-      userAgent: 'test-agent',
-      language: 'en-US',
-      platform: 'test-platform',
-    };
-
-    // Create mock span
-    mockSpan = {
-      setAttribute: vi.fn(),
-      setStatus: vi.fn(),
-      recordException: vi.fn(),
-      end: vi.fn(),
-      name: 'test-span',
-    };
-
-    // Re-import with fresh mocks
-    telemetry = await import('./telemetry.js');
-  });
-
-  afterEach(() => {
-    global.window = originalWindow;
-    global.document = originalDocument;
-    vi.clearAllMocks();
-  });
-
-  describe('initTelemetry', () => {
-    it('exports initTelemetry function', () => {
-      expect(telemetry.initTelemetry).toBeDefined();
-      expect(typeof telemetry.initTelemetry).toBe('function');
-    });
-
-    it('can be called without errors', () => {
-      expect(() => telemetry.initTelemetry()).not.toThrow();
-    });
-  });
-
-  describe('startSpan', () => {
-    it('exports startSpan function', () => {
-      expect(telemetry.startSpan).toBeDefined();
-      expect(typeof telemetry.startSpan).toBe('function');
-    });
-
-    it('returns null when tracer is not initialized', async () => {
-      vi.resetModules();
-      const tempWindow = global.window;
-      delete global.window;
-
-      const freshTelemetry = await import('./telemetry.js');
-      global.window = tempWindow;
-
-      const result = freshTelemetry.startSpan('test-span');
-      expect(result).toBeNull();
-    });
-
-    it('can be called with name only', () => {
-      telemetry.initTelemetry();
-      const result = telemetry.startSpan('test-span');
-      expect(result === null || typeof result === 'object').toBe(true);
-    });
-
-    it('can be called with name and options', () => {
-      telemetry.initTelemetry();
-      const result = telemetry.startSpan('test-span', { attributes: { key: 'value' } });
-      expect(result === null || typeof result === 'object').toBe(true);
-    });
-  });
-
-  describe('endSpan', () => {
-    it('exports endSpan function', () => {
-      expect(telemetry.endSpan).toBeDefined();
-      expect(typeof telemetry.endSpan).toBe('function');
-    });
-
-    it('handles null span gracefully', () => {
-      expect(() => telemetry.endSpan(null)).not.toThrow();
-    });
-
-    it('handles undefined span gracefully', () => {
-      expect(() => telemetry.endSpan(undefined)).not.toThrow();
-    });
-
-    it('can end a span with default status', () => {
-      expect(() => telemetry.endSpan(mockSpan)).not.toThrow();
-      expect(mockSpan.setStatus).toHaveBeenCalledWith({ code: 0 });
-      expect(mockSpan.end).toHaveBeenCalled();
-    });
-
-    it('can end a span with custom status', () => {
-      expect(() => telemetry.endSpan(mockSpan, { code: 2, message: 'error' })).not.toThrow();
-      expect(mockSpan.setStatus).toHaveBeenCalledWith({ code: 2, message: 'error' });
-    });
-  });
-
-  describe('trackPageView', () => {
-    it('exports trackPageView function', () => {
-      expect(telemetry.trackPageView).toBeDefined();
-      expect(typeof telemetry.trackPageView).toBe('function');
-    });
-
-    it('can be called without errors', () => {
-      expect(() => telemetry.trackPageView('/test-page')).not.toThrow();
-    });
-
-    it('can be called with page path and title', () => {
-      expect(() => telemetry.trackPageView('/test-page', 'Test Page Title')).not.toThrow();
-    });
-  });
-
-  describe('trackEvent', () => {
-    it('exports trackEvent function', () => {
-      expect(telemetry.trackEvent).toBeDefined();
-      expect(typeof telemetry.trackEvent).toBe('function');
-    });
-
-    it('can be called with event name only', () => {
-      expect(() => telemetry.trackEvent('button_click')).not.toThrow();
-    });
-
-    it('can be called with event name and attributes', () => {
-      expect(() => telemetry.trackEvent('button_click', { button_id: 'submit' })).not.toThrow();
-    });
-  });
-
-  describe('trackPerformerAction', () => {
-    it('exports trackPerformerAction function', () => {
-      expect(telemetry.trackPerformerAction).toBeDefined();
-      expect(typeof telemetry.trackPerformerAction).toBe('function');
-    });
-
-    it('can be called with action only', () => {
-      expect(() => telemetry.trackPerformerAction('profile_update')).not.toThrow();
-    });
-
-    it('can be called with action and metadata', () => {
-      expect(() => telemetry.trackPerformerAction('profile_update', { field: 'bio' })).not.toThrow();
-    });
-  });
-
-  describe('trackError', () => {
-    it('exports trackError function', () => {
-      expect(telemetry.trackError).toBeDefined();
-      expect(typeof telemetry.trackError).toBe('function');
-    });
-
-    it('can be called with Error object', () => {
-      const error = new Error('Test error');
-      expect(() => telemetry.trackError(error)).not.toThrow();
-    });
-
-    it('can be called with Error and context', () => {
-      const error = new Error('Test error');
-      expect(() => telemetry.trackError(error, { component: 'TestComponent' })).not.toThrow();
-    });
-
-    it('handles error without stack trace', () => {
-      const error = { message: 'Simple error', name: 'SimpleError' };
-      expect(() => telemetry.trackError(error)).not.toThrow();
-    });
-
-    it('handles string error', () => {
-      expect(() => telemetry.trackError('String error message')).not.toThrow();
-    });
-  });
-
-  describe('trackAPICall', () => {
-    it('exports trackAPICall function', () => {
-      expect(telemetry.trackAPICall).toBeDefined();
-      expect(typeof telemetry.trackAPICall).toBe('function');
-    });
-
-    it('can be called with basic parameters', () => {
-      expect(() => telemetry.trackAPICall('GET', '/api/users', 200, 150)).not.toThrow();
-    });
-
-    it('can be called with additional attributes', () => {
-      expect(() => telemetry.trackAPICall('POST', '/api/users', 201, 200, { user_id: '123' })).not.toThrow();
-    });
-
-    it('handles error status codes', () => {
-      expect(() => telemetry.trackAPICall('GET', '/api/users', 500, 100)).not.toThrow();
-    });
-
-    it('handles 4xx status codes', () => {
-      expect(() => telemetry.trackAPICall('GET', '/api/users', 404, 50)).not.toThrow();
-    });
-  });
-
-  describe('trackUserAction', () => {
-    it('exports trackUserAction function', () => {
-      expect(telemetry.trackUserAction).toBeDefined();
-      expect(typeof telemetry.trackUserAction).toBe('function');
-    });
-
-    it('can be called with action only', () => {
-      expect(() => telemetry.trackUserAction('login')).not.toThrow();
-    });
-
-    it('can be called with action and metadata', () => {
-      expect(() => telemetry.trackUserAction('login', { method: 'email' })).not.toThrow();
-    });
-  });
-
-  describe('shutdownTelemetry', () => {
-    it('exports shutdownTelemetry function', () => {
-      expect(telemetry.shutdownTelemetry).toBeDefined();
-      expect(typeof telemetry.shutdownTelemetry).toBe('function');
-    });
-
-    it('can be called without errors', async () => {
-      await expect(telemetry.shutdownTelemetry()).resolves.not.toThrow();
-    });
-
-    it('handles shutdown when not initialized', async () => {
-      vi.resetModules();
-      const tempWindow = global.window;
-      delete global.window;
-
-      const freshTelemetry = await import('./telemetry.js');
-      global.window = tempWindow;
-
-      await expect(freshTelemetry.shutdownTelemetry()).resolves.not.toThrow();
-    });
-  });
-
-  describe('Module auto-initialization', () => {
-    it('adds DOMContentLoaded listener when document is loading', async () => {
-      vi.resetModules();
-
-      global.document = {
-        readyState: 'loading',
-        addEventListener: vi.fn(),
-        title: 'Test',
-        referrer: '',
-      };
-
-      await import('./telemetry.js');
-
-      expect(global.document.addEventListener).toHaveBeenCalledWith(
-        'DOMContentLoaded',
-        expect.any(Function)
-      );
-    });
-
-    it('initializes immediately when document is ready', async () => {
-      vi.resetModules();
-
-      global.document = {
-        readyState: 'complete',
-        title: 'Test',
-        referrer: '',
-        addEventListener: vi.fn(),
-      };
-
-      await import('./telemetry.js');
-    });
-
-    it('adds beforeunload listener for cleanup', async () => {
-      vi.resetModules();
-
-      global.window.addEventListener = vi.fn();
-
-      await import('./telemetry.js');
-
-      expect(global.window.addEventListener).toHaveBeenCalledWith(
-        'beforeunload',
-        expect.any(Function)
-      );
-    });
-  });
-
-  describe('SSR trace context connection', () => {
-    it('handles missing SSR trace context', async () => {
-      vi.resetModules();
-
-      global.window.__TRACE_CONTEXT__ = null;
-
-      await expect(import('./telemetry.js')).resolves.not.toThrow();
-    });
-
-    it('handles SSR trace context when present', async () => {
-      vi.resetModules();
-
-      global.window.__TRACE_CONTEXT__ = {
-        traceId: 'test-trace-id',
-        spanId: 'test-span-id',
-        traceFlags: 1,
-      };
-
-      await expect(import('./telemetry.js')).resolves.not.toThrow();
-    });
-  });
-});
-
-describe('Telemetry with traces disabled', () => {
-  let telemetry;
-
-  beforeEach(async () => {
-    vi.resetModules();
-
-    vi.stubEnv('VITE_OTEL_TRACES_ENABLED', 'false');
-
-    global.window = {
-      location: {
-        pathname: '/performers',
-        search: '',
-        hash: '',
-        href: 'http://localhost/performers',
-      },
-      addEventListener: vi.fn(),
-      __TRACE_CONTEXT__: null,
-    };
-
-    global.document = {
-      readyState: 'complete',
-      title: 'Test',
-      referrer: '',
-      addEventListener: vi.fn(),
-    };
-
-    global.navigator = {
-      userAgent: 'test',
-      language: 'en',
-      platform: 'test',
-    };
-
-    telemetry = await import('./telemetry.js');
-  });
-
-  afterEach(() => {
-    vi.unstubAllEnvs();
-    vi.clearAllMocks();
-  });
-
-  it('initTelemetry returns early when tracing is disabled', () => {
-    const consoleSpy = vi.spyOn(console, 'log');
-    telemetry.initTelemetry();
-    expect(consoleSpy).toHaveBeenCalledWith('[Telemetry] Tracing is disabled');
-  });
-});
-
-describe('Telemetry debug mode', () => {
-  let telemetry;
-
-  beforeEach(async () => {
-    vi.resetModules();
-
-    vi.stubEnv('VITE_OTEL_DEBUG', 'true');
-
-    global.window = {
-      location: {
-        pathname: '/performers',
-        search: '',
-        hash: '',
-        href: 'http://localhost/performers',
-      },
-      addEventListener: vi.fn(),
-      __TRACE_CONTEXT__: null,
-    };
-
-    global.document = {
-      readyState: 'complete',
-      title: 'Test',
-      referrer: '',
-      addEventListener: vi.fn(),
-    };
-
-    global.navigator = {
-      userAgent: 'test',
-      language: 'en',
-      platform: 'test',
-    };
-
-    telemetry = await import('./telemetry.js');
-  });
-
-  afterEach(() => {
-    vi.unstubAllEnvs();
-    vi.clearAllMocks();
-  });
-
-  it('can initialize with debug mode enabled', () => {
-    expect(() => telemetry.initTelemetry()).not.toThrow();
-  });
-});
-
-describe('Telemetry shutdown error handling', () => {
-  let telemetry;
-
-  beforeEach(async () => {
-    vi.resetModules();
-
-    // Mock shutdown to throw error
-    vi.mock('@opentelemetry/sdk-trace-web', () => ({
-      WebTracerProvider: vi.fn().mockImplementation(() => ({
-        addSpanProcessor: vi.fn(),
-        register: vi.fn(),
-        getTracer: vi.fn().mockReturnValue({
-          startSpan: vi.fn().mockReturnValue({
-            setAttribute: vi.fn(),
-            setStatus: vi.fn(),
-            recordException: vi.fn(),
-            end: vi.fn(),
-            name: 'test-span',
-          }),
-        }),
-        shutdown: vi.fn().mockRejectedValue(new Error('Shutdown failed')),
-      })),
-    }));
-
-    global.window = {
-      location: {
-        pathname: '/performers',
-        search: '',
-        hash: '',
-        href: 'http://localhost/performers',
-      },
-      addEventListener: vi.fn(),
-      __TRACE_CONTEXT__: null,
-    };
-
-    global.document = {
-      readyState: 'complete',
-      title: 'Test',
-      referrer: '',
-      addEventListener: vi.fn(),
-    };
-
-    global.navigator = {
-      userAgent: 'test',
-      language: 'en',
-      platform: 'test',
-    };
-
-    telemetry = await import('./telemetry.js');
-  });
-
-  afterEach(() => {
-    vi.unstubAllEnvs();
-    vi.clearAllMocks();
-  });
-
-  it('handles shutdown error gracefully', async () => {
-    const consoleErrorSpy = vi.spyOn(console, 'error');
-    telemetry.initTelemetry();
-    await telemetry.shutdownTelemetry();
-    // Should not throw, just log error
-    expect(consoleErrorSpy).toBeDefined();
-  });
-});
-
-describe('Telemetry DOMContentLoaded event', () => {
-  let telemetry;
-  let domContentLoadedCallback;
-
-  beforeEach(async () => {
-    vi.resetModules();
-
-    global.window = {
-      location: {
-        pathname: '/performers',
-        search: '',
-        hash: '',
-        href: 'http://localhost/performers',
-      },
-      addEventListener: vi.fn(),
-      __TRACE_CONTEXT__: null,
-    };
-
-    // Mock document with loading state
-    global.document = {
-      readyState: 'loading',
-      title: 'Test',
-      referrer: '',
-      addEventListener: vi.fn((event, callback) => {
-        if (event === 'DOMContentLoaded') {
-          domContentLoadedCallback = callback;
-        }
-      }),
-    };
-
-    global.navigator = {
-      userAgent: 'test',
-      language: 'en',
-      platform: 'test',
-    };
-
-    telemetry = await import('./telemetry.js');
-  });
-
-  afterEach(() => {
-    vi.unstubAllEnvs();
-    vi.clearAllMocks();
-  });
-
-  it('registers DOMContentLoaded event listener when document is loading', () => {
-    expect(document.addEventListener).toHaveBeenCalledWith('DOMContentLoaded', expect.any(Function));
-  });
-
-  it('calls initTelemetry and connectWithSSRTrace when DOMContentLoaded fires', () => {
-    // Trigger the DOMContentLoaded callback
-    if (domContentLoadedCallback) {
-      expect(() => domContentLoadedCallback()).not.toThrow();
-    }
-  });
-});
-
-describe('Telemetry beforeunload event', () => {
-  let beforeUnloadCallback;
-
-  beforeEach(async () => {
-    vi.resetModules();
-
-    global.window = {
-      location: {
-        pathname: '/performers',
-        search: '',
-        hash: '',
-        href: 'http://localhost/performers',
-      },
-      addEventListener: vi.fn((event, callback) => {
-        if (event === 'beforeunload') {
-          beforeUnloadCallback = callback;
-        }
-      }),
-      __TRACE_CONTEXT__: null,
-    };
-
-    global.document = {
-      readyState: 'complete',
-      title: 'Test',
-      referrer: '',
-      addEventListener: vi.fn(),
-    };
-
-    global.navigator = {
-      userAgent: 'test',
-      language: 'en',
-      platform: 'test',
-    };
-
-    await import('./telemetry.js');
-  });
-
-  afterEach(() => {
-    vi.unstubAllEnvs();
-    vi.clearAllMocks();
-  });
-
-  it('registers beforeunload event listener', () => {
-    expect(window.addEventListener).toHaveBeenCalledWith('beforeunload', expect.any(Function));
-  });
-
-  it('calls shutdownTelemetry when beforeunload fires', () => {
-    if (beforeUnloadCallback) {
-      expect(() => beforeUnloadCallback()).not.toThrow();
-    }
-  });
-});
+// @ts-nocheck
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+
+// Mock all OpenTelemetry modules before importing telemetry
+vi.mock('@opentelemetry/sdk-trace-web', () => ({
+  WebTracerProvider: vi.fn().mockImplementation(() => ({
+    addSpanProcessor: vi.fn(),
+    register: vi.fn(),
+    getTracer: vi.fn().mockReturnValue({
+      startSpan: vi.fn().mockReturnValue({
+        setAttribute: vi.fn(),
+        setStatus: vi.fn(),
+        recordException: vi.fn(),
+        end: vi.fn(),
+        name: 'test-span',
+      }),
+    }),
+    shutdown: vi.fn().mockResolvedValue(undefined),
+  })),
+}));
+
+vi.mock('@opentelemetry/sdk-trace-base', () => ({
+  BatchSpanProcessor: vi.fn(),
+}));
+
+vi.mock('@opentelemetry/exporter-trace-otlp-http', () => ({
+  OTLPTraceExporter: vi.fn(),
+}));
+
+vi.mock('@opentelemetry/resources', () => ({
+  Resource: vi.fn(),
+}));
+
+vi.mock('@opentelemetry/semantic-conventions', () => ({
+  SEMRESATTRS_SERVICE_NAME: 'service.name',
+  SEMRESATTRS_SERVICE_VERSION: 'service.version',
+  SEMRESATTRS_DEPLOYMENT_ENVIRONMENT: 'deployment.environment',
+}));
+
+vi.mock('@opentelemetry/instrumentation-document-load', () => ({
+  DocumentLoadInstrumentation: vi.fn().mockImplementation(() => ({
+    enable: vi.fn(),
+  })),
+}));
+
+vi.mock('@opentelemetry/instrumentation-fetch', () => ({
+  FetchInstrumentation: vi.fn().mockImplementation(() => ({
+    enable: vi.fn(),
+  })),
+}));
+
+vi.mock('@opentelemetry/instrumentation-xml-http-request', () => ({
+  XMLHttpRequestInstrumentation: vi.fn().mockImplementation(() => ({
+    enable: vi.fn(),
+  })),
+}));
+
+vi.mock('@opentelemetry/instrumentation-user-interaction', () => ({
+  UserInteractionInstrumentation: vi.fn().mockImplementation(() => ({
+    enable: vi.fn(),
+  })),
+}));
+
+vi.mock('@opentelemetry/context-zone', () => ({
+  ZoneContextManager: vi.fn(),
+}));
+
+vi.mock('@opentelemetry/propagator-b3', () => ({
+  B3Propagator: vi.fn(),
+}));
+
+describe('Telemetry Module', () => {
+  let telemetry;
+  let originalWindow;
+  let originalDocument;
+  let mockSpan;
+  let mockTracer;
+
+  beforeEach(async () => {
+    vi.resetModules();
+
+    // Save original globals
+    originalWindow = global.window;
+    originalDocument = global.document;
+
+    // Create mock span
+    mockSpan = {
+      setAttribute: vi.fn(),
+      setStatus: vi.fn(),
+      recordException: vi.fn(),
+      end: vi.fn(),
+      name: 'test-span',
+    };
+
+    // Create mock tracer
+    mockTracer = {
+      startSpan: vi.fn().mockReturnValue(mockSpan),
+    };
+
+    // Setup mock window
+    global.window = {
+      location: {
+        pathname: '/performers',
+        search: '?test=1',
+        hash: '#section',
+        href: 'http://localhost/performers?test=1#section',
+      },
+      addEventListener: vi.fn(),
+      __TRACE_CONTEXT__: null,
+    };
+
+    global.document = {
+      readyState: 'complete',
+      title: 'Test Page',
+      referrer: 'http://localhost/',
+      addEventListener: vi.fn(),
+    };
+
+    global.navigator = {
+      userAgent: 'test-agent',
+      language: 'en-US',
+      platform: 'test-platform',
+    };
+
+    // Re-import with fresh mocks
+    telemetry = await import('./telemetry.js');
+  });
+
+  afterEach(() => {
+    global.window = originalWindow;
+    global.document = originalDocument;
+    vi.clearAllMocks();
+  });
+
+  describe('initTelemetry', () => {
+    it('exports initTelemetry function', () => {
+      expect(telemetry.initTelemetry).toBeDefined();
+      expect(typeof telemetry.initTelemetry).toBe('function');
+    });
+
+    it('can be called without errors', () => {
+      expect(() => telemetry.initTelemetry()).not.toThrow();
+    });
+  });
+
+  describe('startSpan', () => {
+    it('exports startSpan function', () => {
+      expect(telemetry.startSpan).toBeDefined();
+      expect(typeof telemetry.startSpan).toBe('function');
+    });
+
+    it('returns null when tracer is not initialized', async () => {
+      vi.resetModules();
+      const tempWindow = global.window;
+      delete global.window;
+
+      const freshTelemetry = await import('./telemetry.js');
+      global.window = tempWindow;
+
+      const result = freshTelemetry.startSpan('test-span');
+      expect(result).toBeNull();
+    });
+
+    it('can be called with name only', () => {
+      telemetry.initTelemetry();
+      const result = telemetry.startSpan('test-span');
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+
+    it('can be called with name and options', () => {
+      telemetry.initTelemetry();
+      const result = telemetry.startSpan('test-span', { attributes: { key: 'value' } });
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+  });
+
+  describe('endSpan', () => {
+    it('exports endSpan function', () => {
+      expect(telemetry.endSpan).toBeDefined();
+      expect(typeof telemetry.endSpan).toBe('function');
+    });
+
+    it('handles null span gracefully', () => {
+      expect(() => telemetry.endSpan(null)).not.toThrow();
+    });
+
+    it('handles undefined span gracefully', () => {
+      expect(() => telemetry.endSpan(undefined)).not.toThrow();
+    });
+
+    it('can end a span with default status', () => {
+      expect(() => telemetry.endSpan(mockSpan)).not.toThrow();
+      expect(mockSpan.setStatus).toHaveBeenCalledWith({ code: 0 });
+      expect(mockSpan.end).toHaveBeenCalled();
+    });
+
+    it('can end a span with custom status', () => {
+      expect(() => telemetry.endSpan(mockSpan, { code: 2, message: 'error' })).not.toThrow();
+      expect(mockSpan.setStatus).toHaveBeenCalledWith({ code: 2, message: 'error' });
+    });
+  });
+
+  describe('trackPageView', () => {
+    it('exports trackPageView function', () => {
+      expect(telemetry.trackPageView).toBeDefined();
+      expect(typeof telemetry.trackPageView).toBe('function');
+    });
+
+    it('can be called without errors', () => {
+      expect(() => telemetry.trackPageView('/test-page')).not.toThrow();
+    });
+
+    it('can be called with page path and title', () => {
+      expect(() => telemetry.trackPageView('/test-page', 'Test Page Title')).not.toThrow();
+    });
+
+    it('returns early when tracer is not initialized', () => {
+      const result = telemetry.trackPageView('/test');
+      expect(result).toBeUndefined();
+    });
+  });
+
+  describe('trackEvent', () => {
+    it('exports trackEvent function', () => {
+      expect(telemetry.trackEvent).toBeDefined();
+      expect(typeof telemetry.trackEvent).toBe('function');
+    });
+
+    it('can be called with event name only', () => {
+      expect(() => telemetry.trackEvent('button_click')).not.toThrow();
+    });
+
+    it('can be called with event name and attributes', () => {
+      expect(() => telemetry.trackEvent('button_click', { button_id: 'submit' })).not.toThrow();
+    });
+  });
+
+  describe('trackPerformerAction', () => {
+    it('exports trackPerformerAction function', () => {
+      expect(telemetry.trackPerformerAction).toBeDefined();
+      expect(typeof telemetry.trackPerformerAction).toBe('function');
+    });
+
+    it('can be called with action only', () => {
+      expect(() => telemetry.trackPerformerAction('profile_update')).not.toThrow();
+    });
+
+    it('can be called with action and metadata', () => {
+      expect(() => telemetry.trackPerformerAction('profile_update', { field: 'bio' })).not.toThrow();
+    });
+  });
+
+  describe('trackError', () => {
+    it('exports trackError function', () => {
+      expect(telemetry.trackError).toBeDefined();
+      expect(typeof telemetry.trackError).toBe('function');
+    });
+
+    it('can be called with Error object', () => {
+      const error = new Error('Test error');
+      expect(() => telemetry.trackError(error)).not.toThrow();
+    });
+
+    it('can be called with Error and context', () => {
+      const error = new Error('Test error');
+      expect(() => telemetry.trackError(error, { component: 'TestComponent' })).not.toThrow();
+    });
+
+    it('handles error without stack trace', () => {
+      const error = { message: 'Simple error', name: 'SimpleError' };
+      expect(() => telemetry.trackError(error)).not.toThrow();
+    });
+
+    it('handles string error', () => {
+      expect(() => telemetry.trackError('String error message')).not.toThrow();
+    });
+  });
+
+  describe('trackAPICall', () => {
+    it('exports trackAPICall function', () => {
+      expect(telemetry.trackAPICall).toBeDefined();
+      expect(typeof telemetry.trackAPICall).toBe('function');
+    });
+
+    it('can be called with basic parameters', () => {
+      expect(() => telemetry.trackAPICall('GET', '/api/users', 200, 150)).not.toThrow();
+    });
+
+    it('can be called with additional attributes', () => {
+      expect(() => telemetry.trackAPICall('POST', '/api/users', 201, 200, { user_id: '123' })).not.toThrow();
+    });
+
+    it('handles error status codes', () => {
+      expect(() => telemetry.trackAPICall('GET', '/api/users', 500, 100)).not.toThrow();
+    });
+
+    it('handles 4xx status codes', () => {
+      expect(() => telemetry.trackAPICall('GET', '/api/users', 404, 50)).not.toThrow();
+    });
+  });
+
+  describe('trackUserAction', () => {
+    it('exports trackUserAction function', () => {
+      expect(telemetry.trackUserAction).toBeDefined();
+      expect(typeof telemetry.trackUserAction).toBe('function');
+    });
+
+    it('can be called with action only', () => {
+      expect(() => telemetry.trackUserAction('login')).not.toThrow();
+    });
+
+    it('can be called with action and metadata', () => {
+      expect(() => telemetry.trackUserAction('login', { method: 'email' })).not.toThrow();
+    });
+  });
+
+  describe('shutdownTelemetry', () => {
+    it('exports shutdownTelemetry function', () => {
+      expect(telemetry.shutdownTelemetry).toBeDefined();
+      expect(typeof telemetry.shutdownTelemetry).toBe('function');
+    });
+
+    it('can be called without errors', async () => {
+      await expect(telemetry.shutdownTelemetry()).resolves.not.toThrow();
+    });
+
+    it('handles shutdown when not initialized', async () => {
+      vi.resetModules();
+      const tempWindow = global.window;
+      delete global.window;
+
+      const freshTelemetry = await import('./telemetry.js');
+      global.window = tempWindow;
+
+      await expect(freshTelemetry.shutdownTelemetry()).resolves.not.toThrow();
+    });
+  });
+
+  describe('Module auto-initialization', () => {
+    it('adds DOMContentLoaded listener when document is loading', async () => {
+      vi.resetModules();
+
+      global.document = {
+        readyState: 'loading',
+        addEventListener: vi.fn(),
+        title: 'Test',
+        referrer: '',
+      };
+
+      await import('./telemetry.js');
+
+      expect(global.document.addEventListener).toHaveBeenCalledWith(
+        'DOMContentLoaded',
+        expect.any(Function)
+      );
+    });
+
+    it('initializes immediately when document is ready', async () => {
+      vi.resetModules();
+
+      global.document = {
+        readyState: 'complete',
+        title: 'Test',
+        referrer: '',
+        addEventListener: vi.fn(),
+      };
+
+      await import('./telemetry.js');
+    });
+
+    it('adds beforeunload listener for cleanup', async () => {
+      vi.resetModules();
+
+      global.window.addEventListener = vi.fn();
+
+      await import('./telemetry.js');
+
+      expect(global.window.addEventListener).toHaveBeenCalledWith(
+        'beforeunload',
+        expect.any(Function)
+      );
+    });
+  });
+
+  describe('SSR trace context connection', () => {
+    it('handles missing SSR trace context', async () => {
+      vi.resetModules();
+
+      global.window.__TRACE_CONTEXT__ = null;
+
+      await expect(import('./telemetry.js')).resolves.not.toThrow();
+    });
+
+    it('handles SSR trace context when present', async () => {
+      vi.resetModules();
+
+      global.window.__TRACE_CONTEXT__ = {
+        traceId: 'test-trace-id',
+        spanId: 'test-span-id',
+        traceFlags: 1,
+      };
+
+      await expect(import('./telemetry.js')).resolves.not.toThrow();
+    });
+  });
+});
+
+describe('Telemetry with traces disabled', () => {
+  let telemetry;
+
+  beforeEach(async () => {
+    vi.resetModules();
+
+    vi.stubEnv('VITE_OTEL_TRACES_ENABLED', 'false');
+
+    global.window = {
+      location: {
+        pathname: '/performers',
+        search: '',
+        hash: '',
+        href: 'http://localhost/performers',
+      },
+      addEventListener: vi.fn(),
+      __TRACE_CONTEXT__: null,
+    };
+
+    global.document = {
+      readyState: 'complete',
+      title: 'Test',
+      referrer: '',
+      addEventListener: vi.fn(),
+    };
+
+    global.navigator = {
+      userAgent: 'test',
+      language: 'en',
+      platform: 'test',
+    };
+
+    telemetry = await import('./telemetry.js');
+  });
+
+  afterEach(() => {
+    vi.unstubAllEnvs();
+    vi.clearAllMocks();
+  });
+
+  it('initTelemetry returns early when tracing is disabled', () => {
+    // Should return early without throwing when traces are disabled
+    expect(() => telemetry.initTelemetry({ tracesEnabled: false })).not.toThrow();
+    // Verify tracer is not initialized (trackPageView should be a no-op)
+    expect(() => telemetry.trackPageView('/test')).not.toThrow();
+  });
+});
+
+describe('Telemetry debug mode', () => {
+  let telemetry;
+
+  beforeEach(async () => {
+    vi.resetModules();
+
+    vi.stubEnv('VITE_OTEL_DEBUG', 'true');
+
+    global.window = {
+      location: {
+        pathname: '/performers',
+        search: '',
+        hash: '',
+        href: 'http://localhost/performers',
+      },
+      addEventListener: vi.fn(),
+      __TRACE_CONTEXT__: null,
+    };
+
+    global.document = {
+      readyState: 'complete',
+      title: 'Test',
+      referrer: '',
+      addEventListener: vi.fn(),
+    };
+
+    global.navigator = {
+      userAgent: 'test',
+      language: 'en',
+      platform: 'test',
+    };
+
+    telemetry = await import('./telemetry.js');
+  });
+
+  afterEach(() => {
+    vi.unstubAllEnvs();
+    vi.clearAllMocks();
+  });
+
+  it('can initialize with debug mode enabled', () => {
+    expect(() => telemetry.initTelemetry()).not.toThrow();
+  });
+});
+
+describe('Telemetry shutdown error handling', () => {
+  let telemetry;
+
+  beforeEach(async () => {
+    vi.resetModules();
+
+    // Mock shutdown to throw error
+    vi.mock('@opentelemetry/sdk-trace-web', () => ({
+      WebTracerProvider: vi.fn().mockImplementation(() => ({
+        addSpanProcessor: vi.fn(),
+        register: vi.fn(),
+        getTracer: vi.fn().mockReturnValue({
+          startSpan: vi.fn().mockReturnValue({
+            setAttribute: vi.fn(),
+            setStatus: vi.fn(),
+            recordException: vi.fn(),
+            end: vi.fn(),
+            name: 'test-span',
+          }),
+        }),
+        shutdown: vi.fn().mockRejectedValue(new Error('Shutdown failed')),
+      })),
+    }));
+
+    global.window = {
+      location: {
+        pathname: '/performers',
+        search: '',
+        hash: '',
+        href: 'http://localhost/performers',
+      },
+      addEventListener: vi.fn(),
+      __TRACE_CONTEXT__: null,
+    };
+
+    global.document = {
+      readyState: 'complete',
+      title: 'Test',
+      referrer: '',
+      addEventListener: vi.fn(),
+    };
+
+    global.navigator = {
+      userAgent: 'test',
+      language: 'en',
+      platform: 'test',
+    };
+
+    telemetry = await import('./telemetry.js');
+  });
+
+  afterEach(() => {
+    vi.unstubAllEnvs();
+    vi.clearAllMocks();
+  });
+
+  it('handles shutdown error gracefully', async () => {
+    const consoleErrorSpy = vi.spyOn(console, 'error');
+    telemetry.initTelemetry();
+    await telemetry.shutdownTelemetry();
+    // Should not throw, just log error
+    expect(consoleErrorSpy).toBeDefined();
+  });
+});
+
+describe('Telemetry DOMContentLoaded event', () => {
+  let telemetry;
+  let domContentLoadedCallback;
+
+  beforeEach(async () => {
+    vi.resetModules();
+
+    global.window = {
+      location: {
+        pathname: '/performers',
+        search: '',
+        hash: '',
+        href: 'http://localhost/performers',
+      },
+      addEventListener: vi.fn(),
+      __TRACE_CONTEXT__: null,
+    };
+
+    // Mock document with loading state
+    global.document = {
+      readyState: 'loading',
+      title: 'Test',
+      referrer: '',
+      addEventListener: vi.fn((event, callback) => {
+        if (event === 'DOMContentLoaded') {
+          domContentLoadedCallback = callback;
+        }
+      }),
+    };
+
+    global.navigator = {
+      userAgent: 'test',
+      language: 'en',
+      platform: 'test',
+    };
+
+    telemetry = await import('./telemetry.js');
+  });
+
+  afterEach(() => {
+    vi.unstubAllEnvs();
+    vi.clearAllMocks();
+  });
+
+  it('registers DOMContentLoaded event listener when document is loading', () => {
+    expect(document.addEventListener).toHaveBeenCalledWith('DOMContentLoaded', expect.any(Function));
+  });
+
+  it('calls initTelemetry and connectWithSSRTrace when DOMContentLoaded fires', () => {
+    // Trigger the DOMContentLoaded callback
+    if (domContentLoadedCallback) {
+      expect(() => domContentLoadedCallback()).not.toThrow();
+    }
+  });
+});
+
+describe('Telemetry beforeunload event', () => {
+  let beforeUnloadCallback;
+
+  beforeEach(async () => {
+    vi.resetModules();
+
+    global.window = {
+      location: {
+        pathname: '/performers',
+        search: '',
+        hash: '',
+        href: 'http://localhost/performers',
+      },
+      addEventListener: vi.fn((event, callback) => {
+        if (event === 'beforeunload') {
+          beforeUnloadCallback = callback;
+        }
+      }),
+      __TRACE_CONTEXT__: null,
+    };
+
+    global.document = {
+      readyState: 'complete',
+      title: 'Test',
+      referrer: '',
+      addEventListener: vi.fn(),
+    };
+
+    global.navigator = {
+      userAgent: 'test',
+      language: 'en',
+      platform: 'test',
+    };
+
+    await import('./telemetry.js');
+  });
+
+  afterEach(() => {
+    vi.unstubAllEnvs();
+    vi.clearAllMocks();
+  });
+
+  it('registers beforeunload event listener', () => {
+    expect(window.addEventListener).toHaveBeenCalledWith('beforeunload', expect.any(Function));
+  });
+
+  it('calls shutdownTelemetry when beforeunload fires', () => {
+    if (beforeUnloadCallback) {
+      expect(() => beforeUnloadCallback()).not.toThrow();
+    }
+  });
+});
+
+describe('getTelemetryConfig', () => {
+  let telemetry;
+
+  beforeEach(async () => {
+    vi.resetModules();
+
+    global.window = {
+      location: {
+        pathname: '/performers',
+        search: '',
+        hash: '',
+        href: 'http://localhost/performers',
+      },
+      addEventListener: vi.fn(),
+      __TRACE_CONTEXT__: null,
+    };
+
+    global.document = {
+      readyState: 'complete',
+      title: 'Test',
+      referrer: '',
+      addEventListener: vi.fn(),
+    };
+
+    global.navigator = {
+      userAgent: 'test',
+      language: 'en',
+      platform: 'test',
+    };
+
+    telemetry = await import('./telemetry.js');
+  });
+
+  afterEach(() => {
+    vi.unstubAllEnvs();
+    vi.clearAllMocks();
+  });
+
+  it('exports getTelemetryConfig function', () => {
+    expect(telemetry.getTelemetryConfig).toBeDefined();
+    expect(typeof telemetry.getTelemetryConfig).toBe('function');
+  });
+
+  it('returns telemetry configuration object', () => {
+    const config = telemetry.getTelemetryConfig();
+    expect(config).toBeDefined();
+    expect(config).toHaveProperty('serviceName');
+    expect(config).toHaveProperty('serviceVersion');
+    expect(config).toHaveProperty('environment');
+    expect(config).toHaveProperty('tracesEnabled');
+  });
+});
+
+describe('setupAutoTelemetry', () => {
+  let telemetry;
+
+  beforeEach(async () => {
+    vi.resetModules();
+
+    global.window = {
+      location: {
+        pathname: '/performers',
+        search: '',
+        hash: '',
+        href: 'http://localhost/performers',
+      },
+      addEventListener: vi.fn(),
+      __TRACE_CONTEXT__: null,
+    };
+
+    global.document = {
+      readyState: 'complete',
+      title: 'Test',
+      referrer: '',
+      addEventListener: vi.fn(),
+    };
+
+    global.navigator = {
+      userAgent: 'test',
+      language: 'en',
+      platform: 'test',
+    };
+
+    telemetry = await import('./telemetry.js');
+  });
+
+  afterEach(() => {
+    vi.unstubAllEnvs();
+    vi.clearAllMocks();
+  });
+
+  it('exports setupAutoTelemetry function', () => {
+    expect(telemetry.setupAutoTelemetry).toBeDefined();
+    expect(typeof telemetry.setupAutoTelemetry).toBe('function');
+  });
+
+  it('can be called without errors', () => {
+    expect(() => telemetry.setupAutoTelemetry()).not.toThrow();
+  });
+
+  it('does not throw when window is undefined', () => {
+    const tempWindow = global.window;
+    delete global.window;
+
+    expect(() => telemetry.setupAutoTelemetry()).not.toThrow();
+
+    global.window = tempWindow;
+  });
+});
+
+describe('Telemetry tracking with initialized tracer', () => {
+  let telemetry;
+  let mockSpan;
+  let mockTracer;
+  let mockTracerProvider;
+
+  beforeEach(async () => {
+    vi.resetModules();
+
+    // Create mock span
+    mockSpan = {
+      setAttribute: vi.fn().mockReturnThis(),
+      setStatus: vi.fn().mockReturnThis(),
+      recordException: vi.fn().mockReturnThis(),
+      end: vi.fn(),
+      name: 'test-span',
+    };
+
+    // Create mock tracer
+    mockTracer = {
+      startSpan: vi.fn().mockReturnValue(mockSpan),
+    };
+
+    // Create mock tracer provider
+    mockTracerProvider = {
+      addSpanProcessor: vi.fn(),
+      register: vi.fn(),
+      getTracer: vi.fn().mockReturnValue(mockTracer),
+      shutdown: vi.fn().mockResolvedValue(undefined),
+    };
+
+    // Mock WebTracerProvider to return our mock
+    vi.doMock('@opentelemetry/sdk-trace-web', () => ({
+      WebTracerProvider: vi.fn().mockImplementation(() => mockTracerProvider),
+    }));
+
+    // Mock registerInstrumentations to avoid instrumentation errors
+    vi.doMock('@opentelemetry/instrumentation', () => ({
+      registerInstrumentations: vi.fn(),
+    }));
+
+    global.window = {
+      location: {
+        pathname: '/performers',
+        search: '?test=1',
+        hash: '#section',
+        href: 'http://localhost/performers?test=1#section',
+      },
+      addEventListener: vi.fn(),
+      __TRACE_CONTEXT__: null,
+    };
+
+    global.document = {
+      readyState: 'complete',
+      title: 'Test Page',
+      referrer: 'http://localhost/',
+      addEventListener: vi.fn(),
+    };
+
+    global.navigator = {
+      userAgent: 'test-agent',
+      language: 'en-US',
+      platform: 'test-platform',
+    };
+
+    telemetry = await import('./telemetry.js');
+
+    // Initialize telemetry to set up tracer
+    telemetry.initTelemetry();
+  });
+
+  afterEach(() => {
+    vi.clearAllMocks();
+    vi.doUnmock('@opentelemetry/sdk-trace-web');
+    vi.doUnmock('@opentelemetry/instrumentation');
+  });
+
+  describe('trackPageView with tracer', () => {
+    it('creates a span with page attributes', () => {
+      telemetry.trackPageView('/test-page', 'Test Title');
+
+      expect(mockTracer.startSpan).toHaveBeenCalledWith('page_view', expect.objectContaining({
+        attributes: expect.objectContaining({
+          'page.path': '/test-page',
+          'page.title': 'Test Title',
+        }),
+      }));
+      expect(mockSpan.end).toHaveBeenCalled();
+    });
+
+    it('uses document title when pageTitle is not provided', () => {
+      telemetry.trackPageView('/test-page');
+
+      expect(mockTracer.startSpan).toHaveBeenCalledWith('page_view', expect.objectContaining({
+        attributes: expect.objectContaining({
+          'page.title': 'Test Page',
+        }),
+      }));
+    });
+  });
+
+  describe('trackEvent with tracer', () => {
+    it('creates a span with event attributes', () => {
+      telemetry.trackEvent('button_click', { button_id: 'submit' });
+
+      expect(mockTracer.startSpan).toHaveBeenCalledWith('event.button_click', expect.objectContaining({
+        attributes: expect.objectContaining({
+          'event.name': 'button_click',
+          'button_id': 'submit',
+        }),
+      }));
+      expect(mockSpan.end).toHaveBeenCalled();
+    });
+
+    it('creates a span without additional attributes', () => {
+      telemetry.trackEvent('page_load');
+
+      expect(mockTracer.startSpan).toHaveBeenCalledWith('event.page_load', expect.objectContaining({
+        attributes: expect.objectContaining({
+          'event.name': 'page_load',
+        }),
+      }));
+    });
+  });
+
+  describe('trackError with tracer', () => {
+    it('creates a span with error details', () => {
+      const error = new Error('Test error');
+      error.stack = 'Error: Test error\n    at line 1';
+
+      telemetry.trackError(error, { component: 'TestComponent' });
+
+      expect(mockTracer.startSpan).toHaveBeenCalledWith('error', expect.objectContaining({
+        attributes: expect.objectContaining({
+          'error.message': 'Test error',
+          'error.stack': error.stack,
+          'error.type': 'Error',
+        }),
+      }));
+      expect(mockSpan.setStatus).toHaveBeenCalledWith({ code: 2, message: 'Test error' });
+      expect(mockSpan.recordException).toHaveBeenCalledWith(error);
+      expect(mockSpan.end).toHaveBeenCalled();
+    });
+
+    it('handles error without stack trace', () => {
+      const error = { message: 'Simple error', name: 'SimpleError' };
+
+      telemetry.trackError(error);
+
+      expect(mockTracer.startSpan).toHaveBeenCalledWith('error', expect.objectContaining({
+        attributes: expect.objectContaining({
+          'error.message': 'Simple error',
+          'error.type': 'SimpleError',
+        }),
+      }));
+    });
+
+    it('handles string error', () => {
+      telemetry.trackError('String error');
+
+      expect(mockTracer.startSpan).toHaveBeenCalledWith('error', expect.objectContaining({
+        attributes: expect.objectContaining({
+          'error.message': 'String error',
+        }),
+      }));
+    });
+  });
+
+  describe('trackAPICall with tracer', () => {
+    it('creates a span for successful API call', () => {
+      telemetry.trackAPICall('GET', '/api/users', 200, 150, { user_id: '123' });
+
+      expect(mockTracer.startSpan).toHaveBeenCalledWith('api_call', expect.objectContaining({
+        attributes: expect.objectContaining({
+          'http.method': 'GET',
+          'http.url': '/api/users',
+          'http.status_code': 200,
+          'http.duration_ms': 150,
+          'user_id': '123',
+        }),
+      }));
+      expect(mockSpan.setStatus).toHaveBeenCalledWith({ code: 0 });
+      expect(mockSpan.end).toHaveBeenCalled();
+    });
+
+    it('creates a span for failed API call with 4xx', () => {
+      telemetry.trackAPICall('GET', '/api/users', 404, 50);
+
+      expect(mockSpan.setStatus).toHaveBeenCalledWith({ code: 2 });
+    });
+
+    it('creates a span for failed API call with 5xx', () => {
+      telemetry.trackAPICall('POST', '/api/users', 500, 100);
+
+      expect(mockSpan.setStatus).toHaveBeenCalledWith({ code: 2 });
+    });
+  });
+
+  describe('trackUserAction with tracer', () => {
+    it('creates a span for user action', () => {
+      telemetry.trackUserAction('login', { method: 'email' });
+
+      expect(mockTracer.startSpan).toHaveBeenCalledWith('user.login', expect.objectContaining({
+        attributes: expect.objectContaining({
+          'user.action': 'login',
+          'user.metadata': JSON.stringify({ method: 'email' }),
+        }),
+      }));
+      expect(mockSpan.end).toHaveBeenCalled();
+    });
+
+    it('creates a span without metadata', () => {
+      telemetry.trackUserAction('logout');
+
+      expect(mockTracer.startSpan).toHaveBeenCalledWith('user.logout', expect.objectContaining({
+        attributes: expect.objectContaining({
+          'user.action': 'logout',
+        }),
+      }));
+    });
+  });
+
+  describe('trackPerformerAction with tracer', () => {
+    it('creates a span for performer action', () => {
+      telemetry.trackPerformerAction('profile_update', { field: 'bio' });
+
+      expect(mockTracer.startSpan).toHaveBeenCalledWith('performer.profile_update', expect.objectContaining({
+        attributes: expect.objectContaining({
+          'performer.action': 'profile_update',
+          'performer.metadata': JSON.stringify({ field: 'bio' }),
+        }),
+      }));
+      expect(mockSpan.end).toHaveBeenCalled();
+    });
+
+    it('creates a span without metadata', () => {
+      telemetry.trackPerformerAction('gig_accepted');
+
+      expect(mockTracer.startSpan).toHaveBeenCalledWith('performer.gig_accepted', expect.objectContaining({
+        attributes: expect.objectContaining({
+          'performer.action': 'gig_accepted',
+        }),
+      }));
+    });
+  });
+
+  describe('shutdownTelemetry with tracer', () => {
+    it('shuts down successfully', async () => {
+      await telemetry.shutdownTelemetry();
+
+      expect(mockTracerProvider.shutdown).toHaveBeenCalled();
+      // Debug logging is now controlled by consoleDebug config flag
+    });
+  });
+});
+
+describe('connectWithSSRTrace functionality', () => {
+  let telemetry;
+  let mockSpan;
+  let mockTracer;
+  let mockTracerProvider;
+
+  beforeEach(async () => {
+    vi.resetModules();
+
+    // Create mock span
+    mockSpan = {
+      setAttribute: vi.fn().mockReturnThis(),
+      setStatus: vi.fn().mockReturnThis(),
+      recordException: vi.fn().mockReturnThis(),
+      end: vi.fn(),
+      name: 'client.init',
+    };
+
+    // Create mock tracer
+    mockTracer = {
+      startSpan: vi.fn().mockReturnValue(mockSpan),
+    };
+
+    // Create mock tracer provider
+    mockTracerProvider = {
+      addSpanProcessor: vi.fn(),
+      register: vi.fn(),
+      getTracer: vi.fn().mockReturnValue(mockTracer),
+      shutdown: vi.fn().mockResolvedValue(undefined),
+    };
+
+    // Mock WebTracerProvider to return our mock
+    vi.doMock('@opentelemetry/sdk-trace-web', () => ({
+      WebTracerProvider: vi.fn().mockImplementation(() => mockTracerProvider),
+    }));
+
+    // Mock registerInstrumentations
+    vi.doMock('@opentelemetry/instrumentation', () => ({
+      registerInstrumentations: vi.fn(),
+    }));
+
+    global.window = {
+      location: {
+        pathname: '/performers',
+        search: '',
+        hash: '',
+        href: 'http://localhost/performers',
+      },
+      addEventListener: vi.fn(),
+      __TRACE_CONTEXT__: {
+        traceId: 'test-trace-123',
+        spanId: 'test-span-456',
+        traceFlags: 1,
+      },
+    };
+
+    global.document = {
+      readyState: 'complete',
+      title: 'Test Page',
+      referrer: 'http://localhost/',
+      addEventListener: vi.fn(),
+    };
+
+    global.navigator = {
+      userAgent: 'test-agent',
+      language: 'en-US',
+      platform: 'test-platform',
+    };
+
+    telemetry = await import('./telemetry.js');
+  });
+
+  afterEach(() => {
+    vi.clearAllMocks();
+    vi.doUnmock('@opentelemetry/sdk-trace-web');
+    vi.doUnmock('@opentelemetry/instrumentation');
+  });
+
+  it('connects with SSR trace context when available', () => {
+    // Manually call initTelemetry which should also trigger connectWithSSRTrace
+    telemetry.initTelemetry();
+    telemetry.setupAutoTelemetry();
+
+    // Check that a span was created with SSR trace context
+    expect(mockTracer.startSpan).toHaveBeenCalledWith('client.init', expect.objectContaining({
+      attributes: expect.objectContaining({
+        'span.kind': 'client',
+        'client.type': 'browser',
+        'ssr.trace_id': 'test-trace-123',
+        'ssr.span_id': 'test-span-456',
+      }),
+      links: expect.arrayContaining([
+        expect.objectContaining({
+          context: expect.objectContaining({
+            traceId: 'test-trace-123',
+            spanId: 'test-span-456',
+            traceFlags: 1,
+          }),
+        }),
+      ]),
+    }));
+    expect(mockSpan.end).toHaveBeenCalled();
+  });
+});