@virtu3d/event-manager 0.2.7

package/dist/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/context/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Context Propagation Utilities\n *\n * Works in both Node.js and Browser environments.\n * Uses @opentelemetry/api for trace context propagation.\n */\n\n/**\n * Trace context structure\n */\nexport interface TraceContext {\n  traceId: string;\n  spanId: string;\n  traceFlags: number;\n}\n\n/**\n * Get current trace headers for manual injection into HTTP requests.\n * Returns headers like { traceparent: '00-abc123...', tracestate: '...' }\n *\n * If there's an active OTEL span, uses its context.\n * Otherwise, generates a new traceparent to enable backend trace correlation.\n *\n * @example\n * ```typescript\n * const headers = getTraceHeaders();\n * fetch('/api/data', { headers });\n * ```\n */\nexport async function getTraceHeaders(): Promise<Record<string, string>> {\n  try {\n    const { context, propagation, trace } = await import('@opentelemetry/api');\n    const headers: Record<string, string> = {};\n    propagation.inject(context.active(), headers);\n\n    // If OTEL didn't provide traceparent (no active span), generate one\n    // This ensures trace context is always propagated to backends\n    if (!headers['traceparent']) {\n      const traceId = generateTraceId();\n      const spanId = generateSpanId();\n      headers['traceparent'] = generateTraceparent(traceId, spanId, 1);\n    }\n\n    return headers;\n  } catch {\n    // OTEL not available, generate traceparent manually\n    const traceId = generateTraceId();\n    const spanId = generateSpanId();\n    return {\n      traceparent: generateTraceparent(traceId, spanId, 1),\n    };\n  }\n}\n\n/**\n * Synchronous version of getTraceHeaders (requires OTEL to be pre-loaded)\n * Use this when you know OTEL is already initialized.\n *\n * If there's an active OTEL span, uses its context.\n * Otherwise, generates a new traceparent to enable backend trace correlation.\n */\nexport function getTraceHeadersSync(): Record<string, string> {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const { context, propagation } = require('@opentelemetry/api');\n    const headers: Record<string, string> = {};\n    propagation.inject(context.active(), headers);\n\n    // If OTEL didn't provide traceparent (no active span), generate one\n    if (!headers['traceparent']) {\n      const traceId = generateTraceId();\n      const spanId = generateSpanId();\n      headers['traceparent'] = generateTraceparent(traceId, spanId, 1);\n    }\n\n    return headers;\n  } catch {\n    // OTEL not available, generate traceparent manually\n    const traceId = generateTraceId();\n    const spanId = generateSpanId();\n    return {\n      traceparent: generateTraceparent(traceId, spanId, 1),\n    };\n  }\n}\n\n/**\n * Extract trace context from incoming headers.\n * Use this in middleware to link incoming requests to their parent trace.\n *\n * @example\n * ```typescript\n * // Express middleware\n * app.use((req, res, next) => {\n *   const traceContext = extractTraceContext(req.headers);\n *   if (traceContext) {\n *     req.traceId = traceContext.traceId;\n *   }\n *   next();\n * });\n * ```\n */\nexport async function extractTraceContext(\n  headers: Record<string, string | string[] | undefined>\n): Promise<TraceContext | null> {\n  try {\n    const { trace, context, propagation, isSpanContextValid } = await import('@opentelemetry/api');\n\n    // Normalize headers to string values (lowercase keys for consistency)\n    const normalizedHeaders: Record<string, string> = {};\n    for (const [key, value] of Object.entries(headers)) {\n      const lowerKey = key.toLowerCase();\n      if (typeof value === 'string') {\n        normalizedHeaders[lowerKey] = value;\n      } else if (Array.isArray(value)) {\n        normalizedHeaders[lowerKey] = value[0] || '';\n      }\n    }\n\n    const extractedContext = propagation.extract(context.active(), normalizedHeaders);\n\n    // Use getSpanContext instead of getSpan - when extracting from headers,\n    // there's no Span object, only SpanContext information\n    const spanContext = trace.getSpanContext(extractedContext);\n\n    if (!spanContext || !isSpanContextValid(spanContext)) {\n      // If OTEL extraction failed, try manual parsing of traceparent\n      const traceparent = normalizedHeaders['traceparent'];\n      if (traceparent) {\n        const parsed = parseTraceparent(traceparent);\n        if (parsed) {\n          return {\n            traceId: parsed.traceId,\n            spanId: parsed.spanId,\n            traceFlags: parsed.traceFlags,\n          };\n        }\n      }\n      return null;\n    }\n\n    return {\n      traceId: spanContext.traceId,\n      spanId: spanContext.spanId,\n      traceFlags: spanContext.traceFlags,\n    };\n  } catch {\n    // Fallback to manual parsing if OTEL is not available\n    const traceparent = headers['traceparent'] || headers['Traceparent'];\n    if (traceparent) {\n      const value = typeof traceparent === 'string' ? traceparent : traceparent[0];\n      const parsed = parseTraceparent(value || '');\n      if (parsed) {\n        return {\n          traceId: parsed.traceId,\n          spanId: parsed.spanId,\n          traceFlags: parsed.traceFlags,\n        };\n      }\n    }\n    return null;\n  }\n}\n\n/**\n * Run a function within an extracted trace context.\n * This ensures any spans created within the function are linked to the parent trace.\n *\n * @example\n * ```typescript\n * await withTraceContext(req.headers, async () => {\n *   // Any spans created here will be children of the incoming trace\n *   await processRequest();\n * });\n * ```\n */\nexport async function withTraceContext<T>(\n  headers: Record<string, string | string[] | undefined>,\n  fn: () => T | Promise<T>\n): Promise<T> {\n  try {\n    const { context, propagation } = await import('@opentelemetry/api');\n\n    // Normalize headers\n    const normalizedHeaders: Record<string, string> = {};\n    for (const [key, value] of Object.entries(headers)) {\n      if (typeof value === 'string') {\n        normalizedHeaders[key] = value;\n      } else if (Array.isArray(value)) {\n        normalizedHeaders[key] = value[0] || '';\n      }\n    }\n\n    const extractedContext = propagation.extract(context.active(), normalizedHeaders);\n    return context.with(extractedContext, fn);\n  } catch {\n    // OTEL not available, run function without context\n    return fn();\n  }\n}\n\n/**\n * Create a new span for tracking an operation.\n * The span will automatically be linked to the current trace context.\n *\n * @example\n * ```typescript\n * const span = await startSpan('fetch-user-data');\n * try {\n *   const user = await fetchUser(id);\n *   span.setAttribute('user.id', id);\n *   span.setStatus({ code: SpanStatusCode.OK });\n * } catch (error) {\n *   span.setStatus({ code: SpanStatusCode.ERROR, message: error.message });\n *   throw error;\n * } finally {\n *   span.end();\n * }\n * ```\n */\nexport async function startSpan(\n  name: string,\n  serviceName = 'telemetry'\n): Promise<any> {\n  try {\n    const { trace } = await import('@opentelemetry/api');\n    const tracer = trace.getTracer(serviceName);\n    return tracer.startSpan(name);\n  } catch {\n    // Return a no-op span if OTEL is not available\n    return {\n      setAttribute: () => {},\n      setStatus: () => {},\n      addEvent: () => {},\n      end: () => {},\n      spanContext: () => ({ traceId: '', spanId: '', traceFlags: 0 }),\n    };\n  }\n}\n\n/**\n * Parse a traceparent header string into its components.\n * Format: version-traceId-spanId-traceFlags (e.g., \"00-abc123...-def456...-01\")\n */\nexport function parseTraceparent(\n  traceparent: string\n): { version: string; traceId: string; spanId: string; traceFlags: number } | null {\n  if (!traceparent) return null;\n\n  const parts = traceparent.split('-');\n  if (parts.length !== 4) return null;\n\n  const [version, traceId, spanId, flags] = parts;\n\n  // Validate format\n  if (version.length !== 2 || traceId.length !== 32 || spanId.length !== 16 || flags.length !== 2) {\n    return null;\n  }\n\n  return {\n    version,\n    traceId,\n    spanId,\n    traceFlags: parseInt(flags, 16),\n  };\n}\n\n/**\n * Generate a traceparent header string.\n * Useful for creating custom trace contexts.\n */\nexport function generateTraceparent(\n  traceId: string,\n  spanId: string,\n  traceFlags = 1\n): string {\n  const flagsHex = traceFlags.toString(16).padStart(2, '0');\n  return `00-${traceId}-${spanId}-${flagsHex}`;\n}\n\n/**\n * Generate a random trace ID (32 hex characters)\n */\nexport function generateTraceId(): string {\n  const bytes = new Uint8Array(16);\n  if (typeof crypto !== 'undefined' && crypto.getRandomValues) {\n    crypto.getRandomValues(bytes);\n  } else {\n    // Fallback for environments without crypto\n    for (let i = 0; i < bytes.length; i++) {\n      bytes[i] = Math.floor(Math.random() * 256);\n    }\n  }\n  return Array.from(bytes)\n    .map((b) => b.toString(16).padStart(2, '0'))\n    .join('');\n}\n\n/**\n * Generate a random span ID (16 hex characters)\n */\nexport function generateSpanId(): string {\n  const bytes = new Uint8Array(8);\n  if (typeof crypto !== 'undefined' && crypto.getRandomValues) {\n    crypto.getRandomValues(bytes);\n  } else {\n    for (let i = 0; i < bytes.length; i++) {\n      bytes[i] = Math.floor(Math.random() * 256);\n    }\n  }\n  return Array.from(bytes)\n    .map((b) => b.toString(16).padStart(2, '0'))\n    .join('');\n}\n"]}

package/dist/context/index.mjs

@@ -0,0 +1,176 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/context/index.ts
+async function getTraceHeaders() {
+  try {
+    const { context, propagation, trace } = await import('@opentelemetry/api');
+    const headers = {};
+    propagation.inject(context.active(), headers);
+    if (!headers["traceparent"]) {
+      const traceId = generateTraceId();
+      const spanId = generateSpanId();
+      headers["traceparent"] = generateTraceparent(traceId, spanId, 1);
+    }
+    return headers;
+  } catch {
+    const traceId = generateTraceId();
+    const spanId = generateSpanId();
+    return {
+      traceparent: generateTraceparent(traceId, spanId, 1)
+    };
+  }
+}
+function getTraceHeadersSync() {
+  try {
+    const { context, propagation } = __require("@opentelemetry/api");
+    const headers = {};
+    propagation.inject(context.active(), headers);
+    if (!headers["traceparent"]) {
+      const traceId = generateTraceId();
+      const spanId = generateSpanId();
+      headers["traceparent"] = generateTraceparent(traceId, spanId, 1);
+    }
+    return headers;
+  } catch {
+    const traceId = generateTraceId();
+    const spanId = generateSpanId();
+    return {
+      traceparent: generateTraceparent(traceId, spanId, 1)
+    };
+  }
+}
+async function extractTraceContext(headers) {
+  try {
+    const { trace, context, propagation, isSpanContextValid } = await import('@opentelemetry/api');
+    const normalizedHeaders = {};
+    for (const [key, value] of Object.entries(headers)) {
+      const lowerKey = key.toLowerCase();
+      if (typeof value === "string") {
+        normalizedHeaders[lowerKey] = value;
+      } else if (Array.isArray(value)) {
+        normalizedHeaders[lowerKey] = value[0] || "";
+      }
+    }
+    const extractedContext = propagation.extract(context.active(), normalizedHeaders);
+    const spanContext = trace.getSpanContext(extractedContext);
+    if (!spanContext || !isSpanContextValid(spanContext)) {
+      const traceparent = normalizedHeaders["traceparent"];
+      if (traceparent) {
+        const parsed = parseTraceparent(traceparent);
+        if (parsed) {
+          return {
+            traceId: parsed.traceId,
+            spanId: parsed.spanId,
+            traceFlags: parsed.traceFlags
+          };
+        }
+      }
+      return null;
+    }
+    return {
+      traceId: spanContext.traceId,
+      spanId: spanContext.spanId,
+      traceFlags: spanContext.traceFlags
+    };
+  } catch {
+    const traceparent = headers["traceparent"] || headers["Traceparent"];
+    if (traceparent) {
+      const value = typeof traceparent === "string" ? traceparent : traceparent[0];
+      const parsed = parseTraceparent(value || "");
+      if (parsed) {
+        return {
+          traceId: parsed.traceId,
+          spanId: parsed.spanId,
+          traceFlags: parsed.traceFlags
+        };
+      }
+    }
+    return null;
+  }
+}
+async function withTraceContext(headers, fn) {
+  try {
+    const { context, propagation } = await import('@opentelemetry/api');
+    const normalizedHeaders = {};
+    for (const [key, value] of Object.entries(headers)) {
+      if (typeof value === "string") {
+        normalizedHeaders[key] = value;
+      } else if (Array.isArray(value)) {
+        normalizedHeaders[key] = value[0] || "";
+      }
+    }
+    const extractedContext = propagation.extract(context.active(), normalizedHeaders);
+    return context.with(extractedContext, fn);
+  } catch {
+    return fn();
+  }
+}
+async function startSpan(name, serviceName = "telemetry") {
+  try {
+    const { trace } = await import('@opentelemetry/api');
+    const tracer = trace.getTracer(serviceName);
+    return tracer.startSpan(name);
+  } catch {
+    return {
+      setAttribute: () => {
+      },
+      setStatus: () => {
+      },
+      addEvent: () => {
+      },
+      end: () => {
+      },
+      spanContext: () => ({ traceId: "", spanId: "", traceFlags: 0 })
+    };
+  }
+}
+function parseTraceparent(traceparent) {
+  if (!traceparent) return null;
+  const parts = traceparent.split("-");
+  if (parts.length !== 4) return null;
+  const [version, traceId, spanId, flags] = parts;
+  if (version.length !== 2 || traceId.length !== 32 || spanId.length !== 16 || flags.length !== 2) {
+    return null;
+  }
+  return {
+    version,
+    traceId,
+    spanId,
+    traceFlags: parseInt(flags, 16)
+  };
+}
+function generateTraceparent(traceId, spanId, traceFlags = 1) {
+  const flagsHex = traceFlags.toString(16).padStart(2, "0");
+  return `00-${traceId}-${spanId}-${flagsHex}`;
+}
+function generateTraceId() {
+  const bytes = new Uint8Array(16);
+  if (typeof crypto !== "undefined" && crypto.getRandomValues) {
+    crypto.getRandomValues(bytes);
+  } else {
+    for (let i = 0; i < bytes.length; i++) {
+      bytes[i] = Math.floor(Math.random() * 256);
+    }
+  }
+  return Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+function generateSpanId() {
+  const bytes = new Uint8Array(8);
+  if (typeof crypto !== "undefined" && crypto.getRandomValues) {
+    crypto.getRandomValues(bytes);
+  } else {
+    for (let i = 0; i < bytes.length; i++) {
+      bytes[i] = Math.floor(Math.random() * 256);
+    }
+  }
+  return Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+
+export { extractTraceContext, generateSpanId, generateTraceId, generateTraceparent, getTraceHeaders, getTraceHeadersSync, parseTraceparent, startSpan, withTraceContext };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/context/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/context/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Context Propagation Utilities\n *\n * Works in both Node.js and Browser environments.\n * Uses @opentelemetry/api for trace context propagation.\n */\n\n/**\n * Trace context structure\n */\nexport interface TraceContext {\n  traceId: string;\n  spanId: string;\n  traceFlags: number;\n}\n\n/**\n * Get current trace headers for manual injection into HTTP requests.\n * Returns headers like { traceparent: '00-abc123...', tracestate: '...' }\n *\n * If there's an active OTEL span, uses its context.\n * Otherwise, generates a new traceparent to enable backend trace correlation.\n *\n * @example\n * ```typescript\n * const headers = getTraceHeaders();\n * fetch('/api/data', { headers });\n * ```\n */\nexport async function getTraceHeaders(): Promise<Record<string, string>> {\n  try {\n    const { context, propagation, trace } = await import('@opentelemetry/api');\n    const headers: Record<string, string> = {};\n    propagation.inject(context.active(), headers);\n\n    // If OTEL didn't provide traceparent (no active span), generate one\n    // This ensures trace context is always propagated to backends\n    if (!headers['traceparent']) {\n      const traceId = generateTraceId();\n      const spanId = generateSpanId();\n      headers['traceparent'] = generateTraceparent(traceId, spanId, 1);\n    }\n\n    return headers;\n  } catch {\n    // OTEL not available, generate traceparent manually\n    const traceId = generateTraceId();\n    const spanId = generateSpanId();\n    return {\n      traceparent: generateTraceparent(traceId, spanId, 1),\n    };\n  }\n}\n\n/**\n * Synchronous version of getTraceHeaders (requires OTEL to be pre-loaded)\n * Use this when you know OTEL is already initialized.\n *\n * If there's an active OTEL span, uses its context.\n * Otherwise, generates a new traceparent to enable backend trace correlation.\n */\nexport function getTraceHeadersSync(): Record<string, string> {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const { context, propagation } = require('@opentelemetry/api');\n    const headers: Record<string, string> = {};\n    propagation.inject(context.active(), headers);\n\n    // If OTEL didn't provide traceparent (no active span), generate one\n    if (!headers['traceparent']) {\n      const traceId = generateTraceId();\n      const spanId = generateSpanId();\n      headers['traceparent'] = generateTraceparent(traceId, spanId, 1);\n    }\n\n    return headers;\n  } catch {\n    // OTEL not available, generate traceparent manually\n    const traceId = generateTraceId();\n    const spanId = generateSpanId();\n    return {\n      traceparent: generateTraceparent(traceId, spanId, 1),\n    };\n  }\n}\n\n/**\n * Extract trace context from incoming headers.\n * Use this in middleware to link incoming requests to their parent trace.\n *\n * @example\n * ```typescript\n * // Express middleware\n * app.use((req, res, next) => {\n *   const traceContext = extractTraceContext(req.headers);\n *   if (traceContext) {\n *     req.traceId = traceContext.traceId;\n *   }\n *   next();\n * });\n * ```\n */\nexport async function extractTraceContext(\n  headers: Record<string, string | string[] | undefined>\n): Promise<TraceContext | null> {\n  try {\n    const { trace, context, propagation, isSpanContextValid } = await import('@opentelemetry/api');\n\n    // Normalize headers to string values (lowercase keys for consistency)\n    const normalizedHeaders: Record<string, string> = {};\n    for (const [key, value] of Object.entries(headers)) {\n      const lowerKey = key.toLowerCase();\n      if (typeof value === 'string') {\n        normalizedHeaders[lowerKey] = value;\n      } else if (Array.isArray(value)) {\n        normalizedHeaders[lowerKey] = value[0] || '';\n      }\n    }\n\n    const extractedContext = propagation.extract(context.active(), normalizedHeaders);\n\n    // Use getSpanContext instead of getSpan - when extracting from headers,\n    // there's no Span object, only SpanContext information\n    const spanContext = trace.getSpanContext(extractedContext);\n\n    if (!spanContext || !isSpanContextValid(spanContext)) {\n      // If OTEL extraction failed, try manual parsing of traceparent\n      const traceparent = normalizedHeaders['traceparent'];\n      if (traceparent) {\n        const parsed = parseTraceparent(traceparent);\n        if (parsed) {\n          return {\n            traceId: parsed.traceId,\n            spanId: parsed.spanId,\n            traceFlags: parsed.traceFlags,\n          };\n        }\n      }\n      return null;\n    }\n\n    return {\n      traceId: spanContext.traceId,\n      spanId: spanContext.spanId,\n      traceFlags: spanContext.traceFlags,\n    };\n  } catch {\n    // Fallback to manual parsing if OTEL is not available\n    const traceparent = headers['traceparent'] || headers['Traceparent'];\n    if (traceparent) {\n      const value = typeof traceparent === 'string' ? traceparent : traceparent[0];\n      const parsed = parseTraceparent(value || '');\n      if (parsed) {\n        return {\n          traceId: parsed.traceId,\n          spanId: parsed.spanId,\n          traceFlags: parsed.traceFlags,\n        };\n      }\n    }\n    return null;\n  }\n}\n\n/**\n * Run a function within an extracted trace context.\n * This ensures any spans created within the function are linked to the parent trace.\n *\n * @example\n * ```typescript\n * await withTraceContext(req.headers, async () => {\n *   // Any spans created here will be children of the incoming trace\n *   await processRequest();\n * });\n * ```\n */\nexport async function withTraceContext<T>(\n  headers: Record<string, string | string[] | undefined>,\n  fn: () => T | Promise<T>\n): Promise<T> {\n  try {\n    const { context, propagation } = await import('@opentelemetry/api');\n\n    // Normalize headers\n    const normalizedHeaders: Record<string, string> = {};\n    for (const [key, value] of Object.entries(headers)) {\n      if (typeof value === 'string') {\n        normalizedHeaders[key] = value;\n      } else if (Array.isArray(value)) {\n        normalizedHeaders[key] = value[0] || '';\n      }\n    }\n\n    const extractedContext = propagation.extract(context.active(), normalizedHeaders);\n    return context.with(extractedContext, fn);\n  } catch {\n    // OTEL not available, run function without context\n    return fn();\n  }\n}\n\n/**\n * Create a new span for tracking an operation.\n * The span will automatically be linked to the current trace context.\n *\n * @example\n * ```typescript\n * const span = await startSpan('fetch-user-data');\n * try {\n *   const user = await fetchUser(id);\n *   span.setAttribute('user.id', id);\n *   span.setStatus({ code: SpanStatusCode.OK });\n * } catch (error) {\n *   span.setStatus({ code: SpanStatusCode.ERROR, message: error.message });\n *   throw error;\n * } finally {\n *   span.end();\n * }\n * ```\n */\nexport async function startSpan(\n  name: string,\n  serviceName = 'telemetry'\n): Promise<any> {\n  try {\n    const { trace } = await import('@opentelemetry/api');\n    const tracer = trace.getTracer(serviceName);\n    return tracer.startSpan(name);\n  } catch {\n    // Return a no-op span if OTEL is not available\n    return {\n      setAttribute: () => {},\n      setStatus: () => {},\n      addEvent: () => {},\n      end: () => {},\n      spanContext: () => ({ traceId: '', spanId: '', traceFlags: 0 }),\n    };\n  }\n}\n\n/**\n * Parse a traceparent header string into its components.\n * Format: version-traceId-spanId-traceFlags (e.g., \"00-abc123...-def456...-01\")\n */\nexport function parseTraceparent(\n  traceparent: string\n): { version: string; traceId: string; spanId: string; traceFlags: number } | null {\n  if (!traceparent) return null;\n\n  const parts = traceparent.split('-');\n  if (parts.length !== 4) return null;\n\n  const [version, traceId, spanId, flags] = parts;\n\n  // Validate format\n  if (version.length !== 2 || traceId.length !== 32 || spanId.length !== 16 || flags.length !== 2) {\n    return null;\n  }\n\n  return {\n    version,\n    traceId,\n    spanId,\n    traceFlags: parseInt(flags, 16),\n  };\n}\n\n/**\n * Generate a traceparent header string.\n * Useful for creating custom trace contexts.\n */\nexport function generateTraceparent(\n  traceId: string,\n  spanId: string,\n  traceFlags = 1\n): string {\n  const flagsHex = traceFlags.toString(16).padStart(2, '0');\n  return `00-${traceId}-${spanId}-${flagsHex}`;\n}\n\n/**\n * Generate a random trace ID (32 hex characters)\n */\nexport function generateTraceId(): string {\n  const bytes = new Uint8Array(16);\n  if (typeof crypto !== 'undefined' && crypto.getRandomValues) {\n    crypto.getRandomValues(bytes);\n  } else {\n    // Fallback for environments without crypto\n    for (let i = 0; i < bytes.length; i++) {\n      bytes[i] = Math.floor(Math.random() * 256);\n    }\n  }\n  return Array.from(bytes)\n    .map((b) => b.toString(16).padStart(2, '0'))\n    .join('');\n}\n\n/**\n * Generate a random span ID (16 hex characters)\n */\nexport function generateSpanId(): string {\n  const bytes = new Uint8Array(8);\n  if (typeof crypto !== 'undefined' && crypto.getRandomValues) {\n    crypto.getRandomValues(bytes);\n  } else {\n    for (let i = 0; i < bytes.length; i++) {\n      bytes[i] = Math.floor(Math.random() * 256);\n    }\n  }\n  return Array.from(bytes)\n    .map((b) => b.toString(16).padStart(2, '0'))\n    .join('');\n}\n"]}