feat: Export spanToBaggageHeader utility (#11881)

So we have a proper usage path without installing utils & core...

Author: mydea

MIGRATION.md

@@ -1721,7 +1721,7 @@ In v8, the Span class is heavily reworked. The following properties & methods ar
 - `span.traceId`: Use `span.spanContext().traceId` instead.
 - `span.name`: Use `spanToJSON(span).description` instead.
 - `span.description`: Use `spanToJSON(span).description` instead.
-- `span.getDynamicSamplingContext`: Use `getDynamicSamplingContextFromSpan` utility function instead.
+- `span.getDynamicSamplingContext`: Use `spanToBaggageHeader(span)` utility function instead.
 - `span.tags`: Set tags on the surrounding scope instead, or use attributes.
 - `span.data`: Use `spanToJSON(span).data` instead.
 - `span.setTag()`: Use `span.setAttribute()` instead or set tags on the surrounding scope.

packages/aws-serverless/src/index.ts

@@ -97,6 +97,7 @@ export {
   initOpenTelemetry,
   spanToJSON,
   spanToTraceHeader,
+  spanToBaggageHeader,
   trpcMiddleware,
   addOpenTelemetryInstrumentation,
   zodErrorsIntegration,

packages/browser/src/exports.ts

@@ -57,6 +57,7 @@ export {
   endSession,
   spanToJSON,
   spanToTraceHeader,
+  spanToBaggageHeader,
 } from '@sentry/core';
 
 export {

packages/bun/src/index.ts

@@ -118,6 +118,7 @@ export {
   initOpenTelemetry,
   spanToJSON,
   spanToTraceHeader,
+  spanToBaggageHeader,
   trpcMiddleware,
   addOpenTelemetryInstrumentation,
   zodErrorsIntegration,

packages/core/src/index.ts

@@ -67,6 +67,7 @@ export { handleCallbackErrors } from './utils/handleCallbackErrors';
 export { parameterize } from './utils/parameterize';
 export {
   spanToTraceHeader,
+  spanToBaggageHeader,
   spanToJSON,
   spanIsSampled,
   spanToTraceContext,

packages/core/src/utils/spanUtils.ts

@@ -12,6 +12,7 @@ import type {
 import {
   addNonEnumerableProperty,
   dropUndefinedKeys,
+  dynamicSamplingContextToSentryBaggageHeader,
   generateSentryTraceHeader,
   timestampInSeconds,
 } from '@sentry/utils';
@@ -21,6 +22,7 @@ import { getCurrentScope } from '../currentScopes';
 import { getMetricSummaryJsonForSpan, updateMetricSummaryOnSpan } from '../metrics/metric-summary';
 import type { MetricType } from '../metrics/types';
 import { SEMANTIC_ATTRIBUTE_SENTRY_OP, SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN } from '../semanticAttributes';
+import { getDynamicSamplingContextFromSpan } from '../tracing';
 import type { SentrySpan } from '../tracing/sentrySpan';
 import { SPAN_STATUS_OK, SPAN_STATUS_UNSET } from '../tracing/spanstatus';
 import { _getSpanForScope } from './spanOnScope';
@@ -68,6 +70,14 @@ export function spanToTraceHeader(span: Span): string {
   return generateSentryTraceHeader(traceId, spanId, sampled);
 }
 
+/**
+ * Convert a Span to a baggage header.
+ */
+export function spanToBaggageHeader(span: Span): string | undefined {
+  const dsc = getDynamicSamplingContextFromSpan(span);
+  return dynamicSamplingContextToSentryBaggageHeader(dsc);
+}
+
 /**
  * Convert a span time input intp a timestamp in seconds.
  */

packages/deno/src/index.ts

@@ -78,6 +78,7 @@ export {
   endSession,
   spanToJSON,
   spanToTraceHeader,
+  spanToBaggageHeader,
 } from '@sentry/core';
 
 export { DenoClient } from './client';

packages/google-cloud-serverless/src/index.ts

@@ -97,6 +97,7 @@ export {
   initOpenTelemetry,
   spanToJSON,
   spanToTraceHeader,
+  spanToBaggageHeader,
   trpcMiddleware,
   addOpenTelemetryInstrumentation,
   zodErrorsIntegration,

packages/node/src/index.ts

@@ -110,6 +110,7 @@ export {
   getRootSpan,
   spanToJSON,
   spanToTraceHeader,
+  spanToBaggageHeader,
   trpcMiddleware,
   zodErrorsIntegration,
 } from '@sentry/core';

packages/remix/src/index.server.ts

@@ -99,6 +99,7 @@ export {
   trpcMiddleware,
   spanToJSON,
   spanToTraceHeader,
+  spanToBaggageHeader,
   addOpenTelemetryInstrumentation,
 } from '@sentry/node';