@getmicdrop/svelte-components 1.0.1

package/dist/telemetry.server.js

@@ -0,0 +1,212 @@
+// Server-side OpenTelemetry instrumentation for SvelteKit Performers Portal
+import { registerInstrumentations } from '@opentelemetry/instrumentation';
+import { NodeSDK } from '@opentelemetry/sdk-node';
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
+import { Resource } from '@opentelemetry/resources';
+import { SEMRESATTRS_SERVICE_NAME, SEMRESATTRS_SERVICE_VERSION, SEMRESATTRS_DEPLOYMENT_ENVIRONMENT } from '@opentelemetry/semantic-conventions';
+import { HttpInstrumentation } from '@opentelemetry/instrumentation-http';
+import { FetchInstrumentation } from '@opentelemetry/instrumentation-fetch';
+import { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node';
+import { trace, context, propagation } from '@opentelemetry/api';
+
+// Server telemetry configuration
+const SERVER_TELEMETRY_CONFIG = {
+  serviceName: process.env.VITE_OTEL_SERVICE_NAME || 'jetbook-performersportal-ssr',
+  serviceVersion: process.env.VITE_OTEL_SERVICE_VERSION || '1.0.0',
+  environment: process.env.VITE_ENVIRONMENT || 'development',
+  otlpEndpoint: process.env.VITE_OTEL_EXPORTER_OTLP_ENDPOINT || 'http://localhost:4318/v1/traces',
+  tracesEnabled: process.env.VITE_OTEL_TRACES_ENABLED !== 'false',
+  sampleRate: parseFloat(process.env.VITE_OTEL_TRACES_SAMPLER_ARG || '0.1'),
+  consoleDebug: process.env.VITE_OTEL_DEBUG === 'true'
+};
+
+let sdk = null;
+
+// Initialize server-side telemetry
+export function initServerTelemetry() {
+  if (!SERVER_TELEMETRY_CONFIG.tracesEnabled) {
+    console.log('[Server Telemetry] Tracing is disabled');
+    return;
+  }
+
+  try {
+    sdk = new NodeSDK({
+      resource: new Resource({
+        [SEMRESATTRS_SERVICE_NAME]: SERVER_TELEMETRY_CONFIG.serviceName,
+        [SEMRESATTRS_SERVICE_VERSION]: SERVER_TELEMETRY_CONFIG.serviceVersion,
+        [SEMRESATTRS_DEPLOYMENT_ENVIRONMENT]: SERVER_TELEMETRY_CONFIG.environment,
+        'portal.type': 'performers'
+      }),
+      traceExporter: new OTLPTraceExporter({
+        url: SERVER_TELEMETRY_CONFIG.otlpEndpoint,
+        headers: {
+          'Content-Type': 'application/json'
+        }
+      }),
+      instrumentations: [
+        getNodeAutoInstrumentations({
+          '@opentelemetry/instrumentation-fs': {
+            enabled: false // Disable fs instrumentation as it's very noisy
+          }
+        }),
+        new HttpInstrumentation({
+          requestHook: (span, request) => {
+            span.setAttributes({
+              'http.route': request.url,
+              'http.user_agent': request.headers?.['user-agent'],
+              'http.referer': request.headers?.['referer'],
+              'ssr.type': 'request',
+              'portal.type': 'performers'
+            });
+          }
+        }),
+        new FetchInstrumentation({
+          propagateTraceHeaderCorsUrls: [
+            /^http:\/\/localhost:8080\/.*/,
+            /^https:\/\/api\.jetbook\.com\/.*/,
+            /^https:\/\/.*\.get-micdrop\.com\/.*/
+          ]
+        })
+      ]
+    });
+
+    sdk.start();
+    console.log(`[Server Telemetry] Initialized with ${SERVER_TELEMETRY_CONFIG.sampleRate * 100}% sampling rate`);
+
+  } catch (error) {
+    console.error('[Server Telemetry] Failed to initialize:', error);
+  }
+}
+
+// Create spans for SSR page loads and data fetching
+export function createSSRSpan(name, request, attributes = {}) {
+  const tracer = trace.getTracer(
+    SERVER_TELEMETRY_CONFIG.serviceName,
+    SERVER_TELEMETRY_CONFIG.serviceVersion
+  );
+
+  return tracer.startSpan(name, {
+    attributes: {
+      'span.kind': 'server',
+      'ssr.type': 'page_load',
+      'portal.type': 'performers',
+      'http.method': request?.method || 'GET',
+      'http.url': request?.url,
+      'http.user_agent': request?.headers?.['user-agent'],
+      'http.referer': request?.headers?.['referer'],
+      ...attributes
+    }
+  });
+}
+
+// Track SSR data loading for performers
+export function trackPerformerSSRDataLoad(loadFunction, context) {
+  return async (event) => {
+    const span = createSSRSpan(`ssr.performer.load.${context}`, event.request, {
+      'ssr.context': context,
+      'route.id': event.route?.id,
+      'performer.context': true
+    });
+
+    try {
+      const result = await loadFunction(event);
+      span.setStatus({ code: 1 }); // OK
+
+      // Add performer-specific attributes if available
+      if (result?.performer) {
+        span.setAttributes({
+          'performer.id': result.performer.id,
+          'performer.name': result.performer.name,
+          'performer.email': result.performer.email
+        });
+      }
+
+      return result;
+    } catch (error) {
+      span.recordException(error);
+      span.setStatus({ code: 2, message: error.message }); // ERROR
+      throw error;
+    } finally {
+      span.end();
+    }
+  };
+}
+
+// Extract trace context from request headers (for connecting client and server spans)
+export function extractTraceContext(request) {
+  const headers = {};
+  if (request?.headers) {
+    // Convert Headers object to plain object
+    for (const [key, value] of request.headers.entries()) {
+      headers[key] = value;
+    }
+  }
+  return propagation.extract(context.active(), headers);
+}
+
+// Inject trace context into response headers (for client-side correlation)
+export function injectTraceContext(response, span) {
+  const headers = {};
+  propagation.inject(context.active(), headers);
+
+  // Add trace context headers to response
+  Object.entries(headers).forEach(([key, value]) => {
+    response.headers?.set(key, value);
+  });
+
+  // Add trace ID for client correlation
+  const spanContext = span?.spanContext();
+  if (spanContext) {
+    response.headers?.set('X-Trace-Id', spanContext.traceId);
+    response.headers?.set('X-Span-Id', spanContext.spanId);
+  }
+
+  return response;
+}
+
+// Shutdown server telemetry
+export async function shutdownServerTelemetry() {
+  if (sdk) {
+    try {
+      await sdk.shutdown();
+      console.log('[Server Telemetry] Shutdown complete');
+    } catch (error) {
+      console.error('[Server Telemetry] Shutdown error:', error);
+    }
+  }
+}
+
+// SvelteKit-specific helpers for performers portal
+export const performersPortalTelemetry = {
+  // Wrap page load functions
+  wrapLoad: (loadFn, context) => trackPerformerSSRDataLoad(loadFn, context),
+
+  // Wrap performer actions
+  wrapAction: (actionFn, actionName) => {
+    return async (event) => {
+      const span = createSSRSpan(`ssr.performer.action.${actionName}`, event.request, {
+        'ssr.context': 'action',
+        'action.name': actionName,
+        'performer.context': true
+      });
+
+      try {
+        const result = await actionFn(event);
+        span.setStatus({ code: 1 }); // OK
+        return result;
+      } catch (error) {
+        span.recordException(error);
+        span.setStatus({ code: 2, message: error.message }); // ERROR
+        throw error;
+      } finally {
+        span.end();
+      }
+    };
+  }
+};
+
+// Auto-initialize if in server environment
+if (typeof window === 'undefined' && typeof global !== 'undefined') {
+  // Server environment
+  initServerTelemetry();
+}

package/dist/telemetry.server.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=telemetry.server.spec.d.ts.map

package/dist/telemetry.server.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.server.spec.d.ts","sourceRoot":"","sources":["../src/lib/telemetry.server.spec.js"],"names":[],"mappings":""}

package/dist/telemetry.server.spec.js

@@ -0,0 +1,434 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+
+// Mock all OpenTelemetry modules
+vi.mock('@opentelemetry/instrumentation', () => ({
+  registerInstrumentations: vi.fn(),
+}));
+
+vi.mock('@opentelemetry/sdk-node', () => ({
+  NodeSDK: vi.fn(() => ({
+    start: vi.fn(),
+    shutdown: vi.fn(() => Promise.resolve()),
+  })),
+}));
+
+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-http', () => ({
+  HttpInstrumentation: vi.fn(() => ({})),
+}));
+
+vi.mock('@opentelemetry/instrumentation-fetch', () => ({
+  FetchInstrumentation: vi.fn(() => ({})),
+}));
+
+vi.mock('@opentelemetry/auto-instrumentations-node', () => ({
+  getNodeAutoInstrumentations: vi.fn(() => []),
+}));
+
+const mockSpan = {
+  setAttribute: vi.fn(),
+  setAttributes: vi.fn(),
+  setStatus: vi.fn(),
+  recordException: vi.fn(),
+  end: vi.fn(),
+  spanContext: vi.fn(() => ({
+    traceId: 'test-trace-id',
+    spanId: 'test-span-id',
+  })),
+};
+
+const mockTracer = {
+  startSpan: vi.fn(() => mockSpan),
+};
+
+const mockContext = {
+  active: vi.fn(() => ({})),
+};
+
+const mockPropagation = {
+  extract: vi.fn(() => ({})),
+  inject: vi.fn(),
+};
+
+vi.mock('@opentelemetry/api', () => ({
+  trace: {
+    getTracer: vi.fn(() => mockTracer),
+  },
+  context: mockContext,
+  propagation: mockPropagation,
+}));
+
+describe('telemetry.server.js', () => {
+  let telemetryServer;
+
+  beforeEach(async () => {
+    vi.resetModules();
+    vi.clearAllMocks();
+
+    // Ensure we're in a server environment
+    delete global.window;
+
+    // Stub environment variables
+    vi.stubEnv('VITE_OTEL_TRACES_ENABLED', 'true');
+    vi.stubEnv('VITE_OTEL_SERVICE_NAME', 'test-service');
+    vi.stubEnv('VITE_ENVIRONMENT', 'test');
+
+    telemetryServer = await import('./telemetry.server.js');
+  });
+
+  afterEach(() => {
+    vi.unstubAllEnvs();
+  });
+
+  describe('initServerTelemetry', () => {
+    it('initializes server telemetry when enabled', async () => {
+      const consoleSpy = vi.spyOn(console, 'log');
+
+      // Module auto-initializes, calling initServerTelemetry will re-init
+      telemetryServer.initServerTelemetry();
+
+      expect(consoleSpy).toHaveBeenCalled();
+    });
+
+    it('logs disabled message when tracing is disabled', async () => {
+      vi.resetModules();
+      vi.stubEnv('VITE_OTEL_TRACES_ENABLED', 'false');
+
+      const consoleSpy = vi.spyOn(console, 'log');
+
+      telemetryServer = await import('./telemetry.server.js');
+      telemetryServer.initServerTelemetry();
+
+      expect(consoleSpy).toHaveBeenCalledWith(
+        '[Server Telemetry] Tracing is disabled'
+      );
+    });
+  });
+
+  describe('createSSRSpan', () => {
+    it('creates SSR span with correct name and attributes', () => {
+      const mockRequest = {
+        method: 'GET',
+        url: 'http://localhost:3000/test',
+        headers: {
+          'user-agent': 'test-agent',
+          referer: 'http://localhost:3000/',
+        },
+      };
+
+      const span = telemetryServer.createSSRSpan(
+        'ssr.test',
+        mockRequest,
+        { custom: 'attribute' }
+      );
+
+      expect(mockTracer.startSpan).toHaveBeenCalledWith('ssr.test', {
+        attributes: {
+          'span.kind': 'server',
+          'ssr.type': 'page_load',
+          'portal.type': 'performers',
+          'http.method': 'GET',
+          'http.url': 'http://localhost:3000/test',
+          'http.user_agent': 'test-agent',
+          'http.referer': 'http://localhost:3000/',
+          custom: 'attribute',
+        },
+      });
+
+      expect(span).toBeDefined();
+    });
+
+    it('handles null request gracefully', () => {
+      const span = telemetryServer.createSSRSpan('ssr.null-request', null);
+
+      expect(mockTracer.startSpan).toHaveBeenCalledWith('ssr.null-request', {
+        attributes: {
+          'span.kind': 'server',
+          'ssr.type': 'page_load',
+          'portal.type': 'performers',
+          'http.method': 'GET',
+          'http.url': undefined,
+          'http.user_agent': undefined,
+          'http.referer': undefined,
+        },
+      });
+
+      expect(span).toBeDefined();
+    });
+  });
+
+  describe('trackPerformerSSRDataLoad', () => {
+    it('wraps load function and tracks successful execution', async () => {
+      const mockLoadFn = vi.fn().mockResolvedValue({
+        performer: { id: 1, name: 'Test Performer', email: 'test@test.com' },
+      });
+
+      const mockEvent = {
+        request: {
+          method: 'GET',
+          url: 'http://localhost:3000/performer/1',
+          headers: {},
+        },
+        route: { id: '/performer/[id]' },
+      };
+
+      const wrappedFn = telemetryServer.trackPerformerSSRDataLoad(
+        mockLoadFn,
+        'performer-load'
+      );
+
+      const result = await wrappedFn(mockEvent);
+
+      expect(mockLoadFn).toHaveBeenCalledWith(mockEvent);
+      expect(result.performer.id).toBe(1);
+      expect(mockSpan.setStatus).toHaveBeenCalledWith({ code: 1 });
+      expect(mockSpan.setAttributes).toHaveBeenCalledWith({
+        'performer.id': 1,
+        'performer.name': 'Test Performer',
+        'performer.email': 'test@test.com',
+      });
+      expect(mockSpan.end).toHaveBeenCalled();
+    });
+
+    it('tracks errors and re-throws them', async () => {
+      const testError = new Error('Load failed');
+      const mockLoadFn = vi.fn().mockRejectedValue(testError);
+
+      const mockEvent = {
+        request: {
+          method: 'GET',
+          url: 'http://localhost:3000/test',
+          headers: {},
+        },
+        route: { id: '/test' },
+      };
+
+      const wrappedFn = telemetryServer.trackPerformerSSRDataLoad(
+        mockLoadFn,
+        'test-load'
+      );
+
+      await expect(wrappedFn(mockEvent)).rejects.toThrow('Load failed');
+
+      expect(mockSpan.recordException).toHaveBeenCalledWith(testError);
+      expect(mockSpan.setStatus).toHaveBeenCalledWith({
+        code: 2,
+        message: 'Load failed',
+      });
+      expect(mockSpan.end).toHaveBeenCalled();
+    });
+
+    it('handles results without performer data', async () => {
+      const mockLoadFn = vi.fn().mockResolvedValue({ data: 'test' });
+
+      const mockEvent = {
+        request: {
+          method: 'GET',
+          url: 'http://localhost:3000/test',
+          headers: {},
+        },
+        route: { id: '/test' },
+      };
+
+      const wrappedFn = telemetryServer.trackPerformerSSRDataLoad(
+        mockLoadFn,
+        'test-load'
+      );
+
+      const result = await wrappedFn(mockEvent);
+
+      expect(result.data).toBe('test');
+      expect(mockSpan.setStatus).toHaveBeenCalledWith({ code: 1 });
+      // setAttributes should not be called for performer data
+      expect(mockSpan.end).toHaveBeenCalled();
+    });
+  });
+
+  describe('extractTraceContext', () => {
+    it('extracts trace context from request headers', () => {
+      const mockRequest = {
+        headers: new Map([
+          ['x-b3-traceid', 'test-trace'],
+          ['x-b3-spanid', 'test-span'],
+        ]),
+      };
+
+      mockRequest.headers.entries = function () {
+        return this[Symbol.iterator]();
+      };
+
+      telemetryServer.extractTraceContext(mockRequest);
+
+      expect(mockPropagation.extract).toHaveBeenCalled();
+    });
+
+    it('handles null request', () => {
+      const result = telemetryServer.extractTraceContext(null);
+
+      expect(mockPropagation.extract).toHaveBeenCalled();
+    });
+
+    it('handles request without headers', () => {
+      const mockRequest = {};
+
+      const result = telemetryServer.extractTraceContext(mockRequest);
+
+      expect(mockPropagation.extract).toHaveBeenCalled();
+    });
+  });
+
+  describe('injectTraceContext', () => {
+    it('injects trace context into response headers', () => {
+      const mockResponse = {
+        headers: {
+          set: vi.fn(),
+        },
+      };
+
+      mockPropagation.inject.mockImplementation((ctx, headers) => {
+        headers['x-b3-traceid'] = 'injected-trace';
+      });
+
+      telemetryServer.injectTraceContext(mockResponse, mockSpan);
+
+      expect(mockPropagation.inject).toHaveBeenCalled();
+      expect(mockResponse.headers.set).toHaveBeenCalledWith(
+        'X-Trace-Id',
+        'test-trace-id'
+      );
+      expect(mockResponse.headers.set).toHaveBeenCalledWith(
+        'X-Span-Id',
+        'test-span-id'
+      );
+    });
+
+    it('handles null span context', () => {
+      const mockResponse = {
+        headers: {
+          set: vi.fn(),
+        },
+      };
+
+      const nullContextSpan = {
+        spanContext: vi.fn(() => null),
+      };
+
+      // Should not throw
+      expect(() =>
+        telemetryServer.injectTraceContext(mockResponse, nullContextSpan)
+      ).not.toThrow();
+    });
+
+    it('handles response without headers', () => {
+      const mockResponse = {};
+
+      // Should not throw
+      expect(() =>
+        telemetryServer.injectTraceContext(mockResponse, mockSpan)
+      ).not.toThrow();
+    });
+  });
+
+  describe('shutdownServerTelemetry', () => {
+    it('shuts down SDK gracefully', async () => {
+      const consoleSpy = vi.spyOn(console, 'log');
+
+      await telemetryServer.shutdownServerTelemetry();
+
+      // May or may not log depending on SDK state
+      expect(true).toBe(true);
+    });
+  });
+
+  describe('performersPortalTelemetry', () => {
+    it('exports wrapLoad helper', () => {
+      expect(telemetryServer.performersPortalTelemetry.wrapLoad).toBeDefined();
+      expect(
+        typeof telemetryServer.performersPortalTelemetry.wrapLoad
+      ).toBe('function');
+    });
+
+    it('exports wrapAction helper', () => {
+      expect(telemetryServer.performersPortalTelemetry.wrapAction).toBeDefined();
+      expect(
+        typeof telemetryServer.performersPortalTelemetry.wrapAction
+      ).toBe('function');
+    });
+
+    it('wrapLoad returns wrapped function', () => {
+      const mockFn = vi.fn();
+      const wrapped = telemetryServer.performersPortalTelemetry.wrapLoad(
+        mockFn,
+        'test'
+      );
+
+      expect(typeof wrapped).toBe('function');
+    });
+
+    it('wrapAction handles successful action', async () => {
+      const mockActionFn = vi.fn().mockResolvedValue({ success: true });
+
+      const mockEvent = {
+        request: {
+          method: 'POST',
+          url: 'http://localhost:3000/action',
+          headers: {},
+        },
+      };
+
+      const wrappedAction =
+        telemetryServer.performersPortalTelemetry.wrapAction(
+          mockActionFn,
+          'test-action'
+        );
+
+      const result = await wrappedAction(mockEvent);
+
+      expect(mockActionFn).toHaveBeenCalledWith(mockEvent);
+      expect(result.success).toBe(true);
+      expect(mockSpan.setStatus).toHaveBeenCalledWith({ code: 1 });
+      expect(mockSpan.end).toHaveBeenCalled();
+    });
+
+    it('wrapAction handles action errors', async () => {
+      const testError = new Error('Action failed');
+      const mockActionFn = vi.fn().mockRejectedValue(testError);
+
+      const mockEvent = {
+        request: {
+          method: 'POST',
+          url: 'http://localhost:3000/action',
+          headers: {},
+        },
+      };
+
+      const wrappedAction =
+        telemetryServer.performersPortalTelemetry.wrapAction(
+          mockActionFn,
+          'failing-action'
+        );
+
+      await expect(wrappedAction(mockEvent)).rejects.toThrow('Action failed');
+
+      expect(mockSpan.recordException).toHaveBeenCalledWith(testError);
+      expect(mockSpan.setStatus).toHaveBeenCalledWith({
+        code: 2,
+        message: 'Action failed',
+      });
+      expect(mockSpan.end).toHaveBeenCalled();
+    });
+  });
+});

package/dist/telemetry.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=telemetry.spec.d.ts.map

package/dist/telemetry.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.spec.d.ts","sourceRoot":"","sources":["../src/lib/telemetry.spec.js"],"names":[],"mappings":""}