Adds getOtlpTracesEndpoint() helper

Author: andreiborza

packages/node-core/src/light/integrations/otlpIntegration.ts

@@ -1,6 +1,12 @@
 import { trace } from '@opentelemetry/api';
 import type { Client, IntegrationFn } from '@sentry/core';
-import { debug, defineIntegration, registerExternalPropagationContext } from '@sentry/core';
+import {
+  debug,
+  defineIntegration,
+  dsnFromString,
+  registerExternalPropagationContext,
+  SENTRY_API_VERSION,
+} from '@sentry/core';
 
 const INTEGRATION_NAME = 'OtlpIntegration';
 
@@ -32,3 +38,25 @@ const _otlpIntegration = (() => {
  * error/log events to the active OTel trace context.
  */
 export const otlpIntegration = defineIntegration(_otlpIntegration);
+
+/**
+ * Returns the OTLP traces endpoint URL and auth headers for a given Sentry DSN.
+ * Use this to configure your own `OTLPTraceExporter`.
+ */
+export function getOtlpTracesEndpoint(dsn: string): { url: string; headers: Record<string, string> } | undefined {
+  const parsed = dsnFromString(dsn);
+  if (!parsed) {
+    return undefined;
+  }
+
+  const { protocol, host, port, path, projectId, publicKey } = parsed;
+  const basePath = path ? `/${path}` : '';
+  const portStr = port ? `:${port}` : '';
+
+  return {
+    url: `${protocol}://${host}${portStr}${basePath}/api/${projectId}/integration/otlp/v1/traces/`,
+    headers: {
+      'X-Sentry-Auth': `Sentry sentry_version=${SENTRY_API_VERSION}, sentry_key=${publicKey}`,
+    },
+  };
+}

packages/node-core/test/light/integrations/otlpIntegration.test.ts

@@ -1,6 +1,6 @@
 import { hasExternalPropagationContext, registerExternalPropagationContext } from '@sentry/core';
 import { afterEach, describe, expect, it } from 'vitest';
-import { otlpIntegration } from '../../../src/light/integrations/otlpIntegration';
+import { getOtlpTracesEndpoint, otlpIntegration } from '../../../src/light/integrations/otlpIntegration';
 import { cleanupLightSdk, mockLightSdkInit } from '../../helpers/mockLightSdkInit';
 
 describe('Light Mode | otlpIntegration', () => {
@@ -23,3 +23,32 @@ describe('Light Mode | otlpIntegration', () => {
     expect(hasExternalPropagationContext()).toBe(true);
   });
 });
+
+describe('getOtlpTracesEndpoint', () => {
+  it('returns correct endpoint and headers from DSN', () => {
+    const result = getOtlpTracesEndpoint('https://abc123@o0.ingest.sentry.io/456');
+
+    expect(result).toEqual({
+      url: 'https://o0.ingest.sentry.io/api/456/integration/otlp/v1/traces/',
+      headers: {
+        'X-Sentry-Auth': 'Sentry sentry_version=7, sentry_key=abc123',
+      },
+    });
+  });
+
+  it('handles DSN with port and path', () => {
+    const result = getOtlpTracesEndpoint('https://key@sentry.example.com:9000/mypath/789');
+
+    expect(result).toEqual({
+      url: 'https://sentry.example.com:9000/mypath/api/789/integration/otlp/v1/traces/',
+      headers: {
+        'X-Sentry-Auth': 'Sentry sentry_version=7, sentry_key=key',
+      },
+    });
+  });
+
+  it('returns undefined for invalid DSN', () => {
+    const result = getOtlpTracesEndpoint('not-a-dsn');
+    expect(result).toBeUndefined();
+  });
+});