feat(node): distributed tracing spans

Adds startSpan, withSpan and getActiveSpan to posthog-node behind a new
traces client option, encoding spans as OTLP JSON without an OpenTelemetry
dependency.

Author: turnipdabeets

.changeset/node-distributed-tracing.md

@@ -0,0 +1,7 @@
+---
+'posthog-node': minor
+'@posthog/core': minor
+'@posthog/types': minor
+---
+
+Add distributed tracing to `posthog-node`: `withSpan`, `startSpan` and `getActiveSpan`, enabled by a new `traces` client option.

.changeset/otlp-bigint-int64.md

@@ -0,0 +1,5 @@
+---
+'@posthog/core': patch
+---
+
+Change `bigint` attributes on logs, metrics and spans to send as an int64 rather than as a string.

packages/core/src/__tests__/posthog.flush.spec.ts

@@ -762,11 +762,12 @@ describe('PostHog Core', () => {
   })
 
   describe('OTLP batch senders', () => {
-    // Both share one `_sendOtlpBatch`; the table pins them to the same
+    // All three share one `_sendOtlpBatch`; the table pins them to the same
     // classification so a wrapper can't reintroduce a per-signal retry policy.
     const senders = {
       logs: (client: PostHogCoreTestClient) => client._sendLogsBatch({ resourceLogs: [] }),
       metrics: (client: PostHogCoreTestClient) => client._sendMetricsBatch({ resourceMetrics: [] }),
+      traces: (client: PostHogCoreTestClient) => client._sendTracesBatch({ resourceSpans: [] }),
     }
 
     const cases: [number, string][] = [

packages/core/src/index.ts

@@ -42,9 +42,8 @@ export {
   buildResourceAttributes,
   getOtlpSeverityNumber,
   getOtlpSeverityText,
-  toOtlpAnyValue,
-  toOtlpKeyValueList,
 } from './logs/logs-utils'
+export { toOtlpAnyValue, toOtlpKeyValueList } from './utils/otlp-any-value'
 export { PostHogLogs } from './logs'
 export type {
   BeforeSendLogFn,
@@ -87,6 +86,27 @@ export type {
   Metrics,
   MetricsConfig,
 } from './metrics/types'
+export { PostHogTraces } from './traces'
+export { SyncSpanContextManager } from './traces/context'
+export { NOOP_SPAN } from './traces/span'
+export type {
+  ResolvedTracesConfig,
+  SendTracesBatchOutcome,
+  SpanContextManager,
+  TraceSdkContext,
+  TracesHost,
+} from './traces/types'
+// Same barrel convention as logs and metrics for the user-facing tracing types.
+export type {
+  Span,
+  SpanAttributes,
+  SpanAttributeValue,
+  SpanKind,
+  SpanStatusCode,
+  SpanTimeInput,
+  StartSpanOptions,
+  TracesConfig,
+} from './traces/types'
 export { uuidv7 } from './vendor/uuidv7'
 export * from './cookie'
 export * from './posthog-core'