@ticketboothapp/booking 0.1.11 → 0.1.13

package/src/lib/booking/trace-context.ts

@@ -0,0 +1,62 @@
+/**
+ * W3C Trace Context for TicketBooth: stable trace id per tab + new span per outbound request/retry.
+ * Keep storage keys in sync with `packages/viavia-booking/src/trace-context.ts`.
+ */
+
+import {
+  BOOKING_CORRELATION_HEADER,
+  getOrCreateBookingCorrelationId,
+} from './correlation-id';
+
+export const BOOKING_TRACEPARENT_HEADER = 'traceparent';
+
+const STORAGE_W3C_TRACE_ID = 'tb_booking_w3c_trace_id';
+
+function randomHex(byteLength: number): string {
+  const buf = new Uint8Array(byteLength);
+  crypto.getRandomValues(buf);
+  return Array.from(buf, (b) => b.toString(16).padStart(2, '0')).join('');
+}
+
+function getOrCreateW3CTraceId(): string {
+  if (typeof window === 'undefined') {
+    return randomHex(16);
+  }
+  try {
+    let tid = sessionStorage.getItem(STORAGE_W3C_TRACE_ID);
+    if (!tid || !/^[0-9a-f]{32}$/i.test(tid)) {
+      tid = randomHex(16);
+      sessionStorage.setItem(STORAGE_W3C_TRACE_ID, tid);
+    }
+    return tid.toLowerCase();
+  } catch {
+    return randomHex(16);
+  }
+}
+
+/** New span per call (each retry should invoke this again via `withBookingOutboundHeaders`). */
+export function buildTraceparent(): string {
+  const traceId = getOrCreateW3CTraceId();
+  const spanId = randomHex(8);
+  return `00-${traceId}-${spanId}-01`;
+}
+
+export function traceIdFromTraceparent(traceparent: string): string | undefined {
+  const parts = traceparent.trim().split('-');
+  if (parts.length < 4) return undefined;
+  const tid = parts[1];
+  if (tid.length !== 32 || !/^[0-9a-fA-F]+$/.test(tid)) return undefined;
+  return tid.toLowerCase();
+}
+
+/** Adds `X-Correlation-Id` and W3C `traceparent` (fresh span each call). */
+export function withBookingOutboundHeaders(
+  headers: Record<string, string>,
+): Record<string, string> {
+  if (typeof window === 'undefined') return headers;
+  const cid = getOrCreateBookingCorrelationId();
+  const next = { ...headers };
+  if (cid) next[BOOKING_CORRELATION_HEADER] = cid;
+  next[BOOKING_TRACEPARENT_HEADER] = buildTraceparent();
+  return next;
+}