@langfuse/tracing 4.0.0-alpha.0

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/attributes.ts","../src/utils.ts","../src/spanWrapper.ts"],"sourcesContent":["import { getGlobalLogger } from \"@langfuse/core\";\nimport {\n  trace,\n  context,\n  TimeInput,\n  SpanStatusCode,\n  Span,\n  Context,\n  SpanContext,\n} from \"@opentelemetry/api\";\n\nimport {\n  createGenerationAttributes,\n  createSpanAttributes,\n  createTraceAttributes,\n} from \"./attributes.js\";\nimport {\n  LangfuseEvent,\n  LangfuseGeneration,\n  LangfuseSpan,\n} from \"./spanWrapper.js\";\nimport {\n  LangfuseEventAttributes,\n  LangfuseGenerationAttributes,\n  LangfuseSpanAttributes,\n  LangfuseTraceAttributes,\n} from \"./types.js\";\nimport { getLangfuseTracer } from \"./utils.js\";\n\nexport type {\n  LangfuseObservationType,\n  ObservationLevel,\n  LangfuseSpanAttributes,\n  LangfuseEventAttributes,\n  LangfuseGenerationAttributes,\n  LangfuseAttributes,\n  LangfuseTraceAttributes,\n} from \"./types.js\";\n\nexport * from \"./spanWrapper.js\";\nexport {\n  createTraceAttributes,\n  createSpanAttributes,\n  createGenerationAttributes,\n} from \"./attributes.js\";\n\nexport { LangfuseOtelSpanAttributes } from \"@langfuse/core\";\n\nexport type StartObservationOptions = {\n  startTime?: Date;\n  parentSpanContext?: SpanContext;\n};\n\nfunction createOtelSpan(params: {\n  name: string;\n  startTime?: TimeInput;\n  parentSpanContext?: SpanContext;\n}): Span {\n  return getLangfuseTracer().startSpan(\n    params.name,\n    { startTime: params.startTime },\n    createParentContext(params.parentSpanContext),\n  );\n}\n\nfunction createParentContext(\n  parentSpanContext?: SpanContext,\n): Context | undefined {\n  if (!parentSpanContext) return;\n\n  return trace.setSpanContext(context.active(), parentSpanContext);\n}\n\nfunction wrapPromise<T>(promise: Promise<T>, span: Span): Promise<T> {\n  return promise.then(\n    (value) => {\n      span.end(); // End span AFTER Promise resolves\n\n      return value;\n    },\n    (err: unknown) => {\n      span\n        .setStatus({\n          code: SpanStatusCode.ERROR,\n          message: err instanceof Error ? err.message : \"Unknown error\",\n        })\n        .end(); // End span AFTER Promise rejects\n\n      throw err;\n    },\n  );\n}\n\nexport function startSpan(\n  name: string,\n  attributes?: LangfuseSpanAttributes,\n  options?: {\n    startTime?: TimeInput;\n    parentSpanContext?: SpanContext;\n  },\n): LangfuseSpan {\n  const otelSpan = createOtelSpan({\n    name,\n    ...options,\n  });\n\n  return new LangfuseSpan({ otelSpan, attributes });\n}\n\nexport function startGeneration(\n  name: string,\n  attributes?: LangfuseGenerationAttributes,\n  options?: StartObservationOptions,\n): LangfuseGeneration {\n  const otelSpan = createOtelSpan({\n    name,\n    ...options,\n  });\n\n  return new LangfuseGeneration({ otelSpan, attributes });\n}\n\nexport function createEvent(\n  name: string,\n  attributes?: LangfuseEventAttributes,\n  options?: StartObservationOptions,\n) {\n  const timestamp = options?.startTime ?? new Date();\n\n  const otelSpan = createOtelSpan({\n    name,\n    ...options,\n    startTime: timestamp,\n  });\n\n  return new LangfuseEvent({ otelSpan, attributes, timestamp });\n}\n\nexport function startActiveSpan<F extends (span: LangfuseSpan) => unknown>(\n  name: string,\n  fn: F,\n  options?: StartObservationOptions,\n): ReturnType<F> {\n  return getLangfuseTracer().startActiveSpan(\n    name,\n    { startTime: options?.startTime },\n    createParentContext(options?.parentSpanContext) ?? context.active(),\n    (span) => {\n      try {\n        const result = fn(new LangfuseSpan({ otelSpan: span }));\n\n        if (result instanceof Promise) {\n          return wrapPromise(result, span) as ReturnType<F>;\n        } else {\n          span.end();\n\n          return result as ReturnType<F>;\n        }\n      } catch (err) {\n        span\n          .setStatus({\n            code: SpanStatusCode.ERROR,\n            message: err instanceof Error ? err.message : \"Unknown error\",\n          })\n          .end();\n\n        throw err;\n      }\n    },\n  );\n}\n\nexport function startActiveGeneration<\n  F extends (span: LangfuseGeneration) => unknown,\n>(name: string, fn: F, options?: StartObservationOptions): ReturnType<F> {\n  return getLangfuseTracer().startActiveSpan(\n    name,\n    { startTime: options?.startTime },\n    createParentContext(options?.parentSpanContext) ?? context.active(),\n    (span) => {\n      try {\n        const result = fn(new LangfuseGeneration({ otelSpan: span }));\n\n        if (result instanceof Promise) {\n          return wrapPromise(result, span) as ReturnType<F>;\n        } else {\n          span.end();\n\n          return result as ReturnType<F>;\n        }\n      } catch (err) {\n        span\n          .setStatus({\n            code: SpanStatusCode.ERROR,\n            message: err instanceof Error ? err.message : \"Unknown error\",\n          })\n          .end();\n\n        throw err;\n      }\n    },\n  );\n}\n\nexport function updateActiveTrace(attributes: LangfuseTraceAttributes) {\n  const span = trace.getActiveSpan();\n\n  if (!span) {\n    getGlobalLogger().warn(\n      \"No active OTEL span in context. Skipping trace update.\",\n    );\n\n    return;\n  }\n\n  span.setAttributes(createTraceAttributes(attributes));\n}\n\nexport function updateActiveSpan(attributes: LangfuseSpanAttributes) {\n  const span = trace.getActiveSpan();\n\n  if (!span) {\n    getGlobalLogger().warn(\n      \"No active OTEL span in context. Skipping span update.\",\n    );\n\n    return;\n  }\n\n  span.setAttributes(createSpanAttributes(attributes));\n}\n\nexport function updateActiveGeneration(\n  attributes: LangfuseGenerationAttributes,\n) {\n  const span = trace.getActiveSpan();\n\n  if (!span) {\n    getGlobalLogger().warn(\n      \"No active OTEL span in context. Skipping generation update.\",\n    );\n\n    return;\n  }\n\n  span.setAttributes(createGenerationAttributes(attributes));\n}\n\nexport interface ObserveOptions {\n  name?: string;\n  asType?: \"span\" | \"generation\";\n  captureInput?: boolean;\n  captureOutput?: boolean;\n}\n\nexport function observe<T extends (...args: unknown[]) => unknown>(\n  fn: T,\n  options: ObserveOptions = {},\n): T {\n  const {\n    name = fn.name || \"anonymous-function\",\n    asType = \"span\",\n    captureInput = true,\n    captureOutput = true,\n  } = options;\n\n  const wrappedFunction = (...args: Parameters<T>): ReturnType<T> => {\n    // Prepare input data\n    const inputData = captureInput ? _captureArguments(args) : undefined;\n\n    // Create the appropriate observation type\n    const observation =\n      asType === \"generation\"\n        ? startGeneration(name, inputData ? { input: inputData } : {})\n        : startSpan(name, inputData ? { input: inputData } : {});\n\n    // Set the observation span as active in the context\n    const activeContext = trace.setSpan(context.active(), observation.otelSpan);\n\n    try {\n      const result = context.with(activeContext, () => fn(...args));\n\n      // Handle async functions - check if result is a Promise\n      // TODO: handle returned generators for streamed responses\n      if (result instanceof Promise) {\n        return result.then(\n          (value) => {\n            if (captureOutput) {\n              observation.update({ output: _captureOutput(value) });\n            }\n            observation.end();\n\n            return value;\n          },\n          (error: unknown) => {\n            observation\n              .update({\n                level: \"ERROR\",\n                statusMessage:\n                  (error instanceof Error ? error.message : String(error)) ||\n                  \"Function threw an error\",\n                output: captureOutput ? { error: String(error) } : undefined,\n              })\n              .end();\n\n            throw error;\n          },\n        ) as ReturnType<T>;\n      } else {\n        // Handle sync functions\n        if (captureOutput) {\n          observation.update({ output: _captureOutput(result) });\n        }\n        observation.end();\n\n        return result as ReturnType<T>;\n      }\n    } catch (error: unknown) {\n      observation\n        .update({\n          level: \"ERROR\",\n          statusMessage:\n            (error instanceof Error ? error.message : String(error)) ||\n            \"Function threw an error\",\n          output: captureOutput ? { error: String(error) } : undefined,\n        })\n        .end();\n\n      throw error;\n    }\n  };\n\n  return wrappedFunction as T;\n}\n\n// Helper function to safely capture function arguments\nfunction _captureArguments(args: unknown[]): unknown {\n  try {\n    if (args.length === 0) return undefined;\n    if (args.length === 1) return args[0];\n    return args;\n  } catch {\n    return \"<failed to capture arguments>\";\n  }\n}\n\n// Helper function to safely capture function output\nfunction _captureOutput(value: unknown): unknown {\n  try {\n    // Handle undefined/null\n    if (value === undefined || value === null) return value;\n\n    // For primitive types, return as-is\n    if (typeof value !== \"object\") return value;\n\n    // For objects, return them directly (serialization happens in span processor)\n    return value;\n  } catch {\n    return \"<failed to capture output>\";\n  }\n}\n\n/**\n * Creates a trace ID for OpenTelemetry spans.\n *\n * @param seed - A seed string for deterministic trace ID generation.\n *               If provided (non-empty), the same seed will always generate the same trace ID.\n *               If empty or falsy, generates a random trace ID.\n *\n *               Using a seed is especially useful when trying to correlate external,\n *               non-W3C compliant IDs with Langfuse trace IDs. This allows you to later\n *               have a method available for scoring the Langfuse trace given only the\n *               external ID by regenerating the same trace ID from the external ID.\n *\n * @returns A Promise that resolves to a 32-character lowercase hexadecimal string suitable for use as an OpenTelemetry trace ID.\n *\n * @example\n * ```typescript\n * // Deterministic trace ID from seed\n * const traceId1 = await createTraceId(\"my-session-123\");\n * const traceId2 = await createTraceId(\"my-session-123\");\n * console.log(traceId1 === traceId2); // true\n *\n * // Random trace ID\n * const randomId1 = await createTraceId(\"\");\n * const randomId2 = await createTraceId(\"\");\n * console.log(randomId1 === randomId2); // false\n *\n * // Use with spans\n * const span = startSpan(\"my-span\", {}, {\n *   parentSpanContext: {\n *     traceId: await createTraceId(\"session-456\"),\n *     spanId: \"0123456789abcdef\",\n *     traceFlags: 1\n *   }\n * });\n *\n * // Correlating external IDs with Langfuse traces\n * const externalId = \"ext-12345-67890\";\n * const traceId = await createTraceId(externalId);\n *\n * // Later, when you need to score this trace, regenerate the same ID\n * const scoringTraceId = await createTraceId(externalId);\n * console.log(traceId === scoringTraceId); // true - can now find and score the trace\n * ```\n */\nexport async function createTraceId(seed?: string): Promise<string> {\n  if (seed) {\n    const data = new TextEncoder().encode(seed);\n    const hashBuffer = await crypto.subtle.digest(\"SHA-256\", data);\n\n    const hashArray = new Uint8Array(hashBuffer);\n\n    return uint8ArrayToHex(hashArray).slice(0, 32);\n  }\n\n  const randomValues = crypto.getRandomValues(new Uint8Array(16));\n\n  return uint8ArrayToHex(randomValues);\n}\n\nfunction uint8ArrayToHex(array: Uint8Array): string {\n  return Array.from(array)\n    .map((b) => b.toString(16).padStart(2, \"0\"))\n    .join(\"\");\n}\n","import { LangfuseOtelSpanAttributes } from \"@langfuse/core\";\nimport { type Attributes } from \"@opentelemetry/api\";\n\nimport {\n  LangfuseGenerationAttributes,\n  LangfuseSpanAttributes,\n  LangfuseTraceAttributes,\n} from \"./types.js\";\n\nexport function createTraceAttributes({\n  name,\n  userId,\n  sessionId,\n  version,\n  release,\n  input,\n  output,\n  metadata,\n  tags,\n  environment,\n  public: isPublic,\n}: LangfuseTraceAttributes = {}): Attributes {\n  const attributes = {\n    [LangfuseOtelSpanAttributes.TRACE_NAME]: name,\n    [LangfuseOtelSpanAttributes.TRACE_USER_ID]: userId,\n    [LangfuseOtelSpanAttributes.TRACE_SESSION_ID]: sessionId,\n    [LangfuseOtelSpanAttributes.VERSION]: version,\n    [LangfuseOtelSpanAttributes.RELEASE]: release,\n    [LangfuseOtelSpanAttributes.TRACE_INPUT]: _serialize(input),\n    [LangfuseOtelSpanAttributes.TRACE_OUTPUT]: _serialize(output),\n    [LangfuseOtelSpanAttributes.TRACE_TAGS]: tags,\n    [LangfuseOtelSpanAttributes.ENVIRONMENT]: environment,\n    [LangfuseOtelSpanAttributes.TRACE_PUBLIC]: isPublic,\n    ..._flattenAndSerializeMetadata(metadata, \"trace\"),\n  };\n\n  return Object.fromEntries(\n    Object.entries(attributes).filter(([_, v]) => v != null),\n  );\n}\n\nexport function createSpanAttributes({\n  metadata,\n  input,\n  output,\n  level,\n  statusMessage,\n  version,\n}: LangfuseSpanAttributes): Attributes {\n  const attributes = {\n    [LangfuseOtelSpanAttributes.OBSERVATION_TYPE]: \"span\",\n    [LangfuseOtelSpanAttributes.OBSERVATION_LEVEL]: level,\n    [LangfuseOtelSpanAttributes.OBSERVATION_STATUS_MESSAGE]: statusMessage,\n    [LangfuseOtelSpanAttributes.VERSION]: version,\n    [LangfuseOtelSpanAttributes.OBSERVATION_INPUT]: _serialize(input),\n    [LangfuseOtelSpanAttributes.OBSERVATION_OUTPUT]: _serialize(output),\n    ..._flattenAndSerializeMetadata(metadata, \"observation\"),\n  };\n\n  return Object.fromEntries(\n    Object.entries(attributes).filter(([_, v]) => v != null),\n  );\n}\n\nexport function createGenerationAttributes({\n  completionStartTime,\n  metadata,\n  level,\n  statusMessage,\n  version,\n  model,\n  modelParameters,\n  input,\n  output,\n  usageDetails,\n  costDetails,\n  prompt,\n}: LangfuseGenerationAttributes): Attributes {\n  const attributes = {\n    [LangfuseOtelSpanAttributes.OBSERVATION_TYPE]: \"generation\",\n    [LangfuseOtelSpanAttributes.OBSERVATION_LEVEL]: level,\n    [LangfuseOtelSpanAttributes.OBSERVATION_STATUS_MESSAGE]: statusMessage,\n    [LangfuseOtelSpanAttributes.VERSION]: version,\n    [LangfuseOtelSpanAttributes.OBSERVATION_INPUT]: _serialize(input),\n    [LangfuseOtelSpanAttributes.OBSERVATION_OUTPUT]: _serialize(output),\n    [LangfuseOtelSpanAttributes.OBSERVATION_MODEL]: model,\n    [LangfuseOtelSpanAttributes.OBSERVATION_USAGE_DETAILS]:\n      _serialize(usageDetails),\n    [LangfuseOtelSpanAttributes.OBSERVATION_COST_DETAILS]:\n      _serialize(costDetails),\n    [LangfuseOtelSpanAttributes.OBSERVATION_COMPLETION_START_TIME]:\n      _serialize(completionStartTime),\n    [LangfuseOtelSpanAttributes.OBSERVATION_MODEL_PARAMETERS]:\n      _serialize(modelParameters),\n    ...(prompt && !prompt.isFallback\n      ? {\n          [LangfuseOtelSpanAttributes.OBSERVATION_PROMPT_NAME]: prompt.name,\n          [LangfuseOtelSpanAttributes.OBSERVATION_PROMPT_VERSION]:\n            prompt.version,\n        }\n      : {}),\n    ..._flattenAndSerializeMetadata(metadata, \"observation\"),\n  };\n\n  return Object.fromEntries(\n    Object.entries(attributes).filter(([_, v]) => v != null),\n  ) as Attributes;\n}\n\nexport function createEventAttributes({\n  metadata,\n  input,\n  output,\n  level,\n  statusMessage,\n  version,\n}: LangfuseSpanAttributes): Attributes {\n  const attributes = {\n    [LangfuseOtelSpanAttributes.OBSERVATION_TYPE]: \"event\",\n    [LangfuseOtelSpanAttributes.OBSERVATION_LEVEL]: level,\n    [LangfuseOtelSpanAttributes.OBSERVATION_STATUS_MESSAGE]: statusMessage,\n    [LangfuseOtelSpanAttributes.VERSION]: version,\n    [LangfuseOtelSpanAttributes.OBSERVATION_INPUT]: _serialize(input),\n    [LangfuseOtelSpanAttributes.OBSERVATION_OUTPUT]: _serialize(output),\n    ..._flattenAndSerializeMetadata(metadata, \"observation\"),\n  };\n\n  return Object.fromEntries(\n    Object.entries(attributes).filter(([_, v]) => v != null),\n  );\n}\n\nfunction _serialize(obj: unknown): string | undefined {\n  try {\n    return obj != null ? JSON.stringify(obj) : undefined;\n  } catch {\n    return \"<failed to serialize>\";\n  }\n}\n\nfunction _flattenAndSerializeMetadata(\n  metadata: unknown,\n  type: \"observation\" | \"trace\",\n): Record<string, string> {\n  const prefix =\n    type === \"observation\"\n      ? LangfuseOtelSpanAttributes.OBSERVATION_METADATA\n      : LangfuseOtelSpanAttributes.TRACE_METADATA;\n\n  const metadataAttributes: Record<string, string> = {};\n\n  if (metadata === undefined || metadata === null) {\n    return metadataAttributes;\n  }\n\n  if (typeof metadata !== \"object\" || Array.isArray(metadata)) {\n    const serialized = _serialize(metadata);\n    if (serialized) {\n      metadataAttributes[prefix] = serialized;\n    }\n  } else {\n    for (const [key, value] of Object.entries(metadata)) {\n      const serialized = typeof value === \"string\" ? value : _serialize(value);\n      if (serialized) {\n        metadataAttributes[`${prefix}.${key}`] = serialized;\n      }\n    }\n  }\n\n  return metadataAttributes;\n}\n","import { LANGFUSE_SDK_VERSION, LANGFUSE_TRACER_NAME } from \"@langfuse/core\";\nimport { trace } from \"@opentelemetry/api\";\n\nexport function getLangfuseTracer() {\n  return trace.getTracer(LANGFUSE_TRACER_NAME, LANGFUSE_SDK_VERSION);\n}\n","import { Span, TimeInput } from \"@opentelemetry/api\";\n\nimport {\n  createEventAttributes,\n  createGenerationAttributes,\n  createSpanAttributes,\n  createTraceAttributes,\n} from \"./attributes.js\";\nimport {\n  LangfuseGenerationAttributes,\n  LangfuseSpanAttributes,\n  LangfuseEventAttributes,\n  LangfuseTraceAttributes,\n} from \"./types.js\";\nimport { getLangfuseTracer } from \"./utils.js\";\n\nimport { createEvent, startGeneration, startSpan } from \"./index.js\";\n\nexport type LangfuseObservation =\n  | LangfuseSpan\n  | LangfuseGeneration\n  | LangfuseEvent;\n\ntype LangfuseSpanWrapperParams = {\n  otelSpan: Span;\n  attributes?:\n    | LangfuseSpanAttributes\n    | LangfuseGenerationAttributes\n    | LangfuseEventAttributes;\n};\n\nabstract class LangfuseSpanWrapper {\n  public readonly otelSpan: Span;\n  public id: string;\n  public traceId: string;\n\n  constructor(params: LangfuseSpanWrapperParams) {\n    this.otelSpan = params.otelSpan;\n    this.id = params.otelSpan.spanContext().spanId;\n    this.traceId = params.otelSpan.spanContext().traceId;\n  }\n\n  protected get tracer() {\n    return getLangfuseTracer();\n  }\n\n  public end(endTime?: TimeInput) {\n    this.otelSpan.end(endTime);\n  }\n\n  public updateTrace(attributes: LangfuseTraceAttributes) {\n    this.otelSpan.setAttributes(createTraceAttributes(attributes));\n\n    return this;\n  }\n}\n\ntype LangfuseSpanParams = {\n  otelSpan: Span;\n  attributes?: LangfuseSpanAttributes;\n};\nexport class LangfuseSpan extends LangfuseSpanWrapper {\n  constructor(params: LangfuseSpanParams) {\n    super(params);\n    if (params.attributes) {\n      this.otelSpan.setAttributes(createSpanAttributes(params.attributes));\n    }\n  }\n\n  public update(attributes: LangfuseSpanAttributes): LangfuseSpan {\n    this.otelSpan.setAttributes(createSpanAttributes(attributes));\n\n    return this;\n  }\n\n  public startSpan(\n    name: string,\n    attributes?: LangfuseSpanAttributes,\n  ): LangfuseSpan {\n    return startSpan(name, attributes, {\n      parentSpanContext: this.otelSpan.spanContext(),\n    });\n  }\n\n  public startGeneration(\n    name: string,\n    attributes?: LangfuseGenerationAttributes,\n  ): LangfuseGeneration {\n    return startGeneration(name, attributes, {\n      parentSpanContext: this.otelSpan.spanContext(),\n    });\n  }\n\n  public createEvent(\n    name: string,\n    attributes?: LangfuseEventAttributes,\n  ): LangfuseEvent {\n    return createEvent(name, attributes, {\n      parentSpanContext: this.otelSpan.spanContext(),\n    });\n  }\n}\n\ntype LangfuseGenerationParams = {\n  otelSpan: Span;\n  attributes?: LangfuseGenerationAttributes;\n};\nexport class LangfuseGeneration extends LangfuseSpanWrapper {\n  constructor(params: LangfuseGenerationParams) {\n    super(params);\n    if (params.attributes) {\n      this.otelSpan.setAttributes(\n        createGenerationAttributes(params.attributes),\n      );\n    }\n  }\n\n  update(attributes: LangfuseGenerationAttributes): LangfuseGeneration {\n    this.otelSpan.setAttributes(createGenerationAttributes(attributes));\n\n    return this;\n  }\n\n  createEvent(\n    name: string,\n    attributes?: LangfuseEventAttributes,\n  ): LangfuseEvent {\n    return createEvent(name, attributes, {\n      parentSpanContext: this.otelSpan.spanContext(),\n    });\n  }\n}\n\ntype LangfuseEventParams = {\n  otelSpan: Span;\n  attributes?: LangfuseEventAttributes;\n  timestamp: TimeInput;\n};\nexport class LangfuseEvent extends LangfuseSpanWrapper {\n  constructor(params: LangfuseEventParams) {\n    super(params);\n\n    if (params.attributes) {\n      this.otelSpan.setAttributes(createEventAttributes(params.attributes));\n    }\n\n    this.otelSpan.end(params.timestamp);\n  }\n}\n"],"mappings":"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","names":["import_core","import_api","import_core","import_core"]}

package/dist/index.d.cts

@@ -0,0 +1,166 @@
+import * as _opentelemetry_api from '@opentelemetry/api';
+import { Span, TimeInput, Attributes, SpanContext } from '@opentelemetry/api';
+import { OpenAiUsage } from '@langfuse/core';
+export { LangfuseOtelSpanAttributes } from '@langfuse/core';
+
+type LangfuseObservationType = "span" | "generation" | "event";
+type ObservationLevel = "DEBUG" | "DEFAULT" | "WARNING" | "ERROR";
+type LangfuseSpanAttributes = {
+    input?: unknown;
+    output?: unknown;
+    metadata?: Record<string, unknown>;
+    level?: ObservationLevel;
+    statusMessage?: string;
+    version?: string;
+    environment?: string;
+};
+type LangfuseEventAttributes = LangfuseSpanAttributes;
+type LangfuseGenerationAttributes = LangfuseSpanAttributes & {
+    completionStartTime?: Date;
+    model?: string | null;
+    modelParameters?: {
+        [key: string]: string | number | null;
+    };
+    usageDetails?: {
+        [key: string]: number;
+    } | OpenAiUsage;
+    costDetails?: {
+        [key: string]: number;
+    };
+    prompt?: {
+        name: string;
+        version: number;
+        isFallback: boolean;
+    };
+};
+type LangfuseAttributes = LangfuseSpanAttributes | LangfuseGenerationAttributes | LangfuseEventAttributes;
+type LangfuseTraceAttributes = {
+    name?: string;
+    userId?: string;
+    sessionId?: string;
+    version?: string;
+    release?: string;
+    input?: unknown;
+    output?: unknown;
+    metadata?: unknown;
+    tags?: string[];
+    public?: boolean;
+    environment?: string;
+};
+
+type LangfuseObservation = LangfuseSpan | LangfuseGeneration | LangfuseEvent;
+type LangfuseSpanWrapperParams = {
+    otelSpan: Span;
+    attributes?: LangfuseSpanAttributes | LangfuseGenerationAttributes | LangfuseEventAttributes;
+};
+declare abstract class LangfuseSpanWrapper {
+    readonly otelSpan: Span;
+    id: string;
+    traceId: string;
+    constructor(params: LangfuseSpanWrapperParams);
+    protected get tracer(): _opentelemetry_api.Tracer;
+    end(endTime?: TimeInput): void;
+    updateTrace(attributes: LangfuseTraceAttributes): this;
+}
+type LangfuseSpanParams = {
+    otelSpan: Span;
+    attributes?: LangfuseSpanAttributes;
+};
+declare class LangfuseSpan extends LangfuseSpanWrapper {
+    constructor(params: LangfuseSpanParams);
+    update(attributes: LangfuseSpanAttributes): LangfuseSpan;
+    startSpan(name: string, attributes?: LangfuseSpanAttributes): LangfuseSpan;
+    startGeneration(name: string, attributes?: LangfuseGenerationAttributes): LangfuseGeneration;
+    createEvent(name: string, attributes?: LangfuseEventAttributes): LangfuseEvent;
+}
+type LangfuseGenerationParams = {
+    otelSpan: Span;
+    attributes?: LangfuseGenerationAttributes;
+};
+declare class LangfuseGeneration extends LangfuseSpanWrapper {
+    constructor(params: LangfuseGenerationParams);
+    update(attributes: LangfuseGenerationAttributes): LangfuseGeneration;
+    createEvent(name: string, attributes?: LangfuseEventAttributes): LangfuseEvent;
+}
+type LangfuseEventParams = {
+    otelSpan: Span;
+    attributes?: LangfuseEventAttributes;
+    timestamp: TimeInput;
+};
+declare class LangfuseEvent extends LangfuseSpanWrapper {
+    constructor(params: LangfuseEventParams);
+}
+
+declare function createTraceAttributes({ name, userId, sessionId, version, release, input, output, metadata, tags, environment, public: isPublic, }?: LangfuseTraceAttributes): Attributes;
+declare function createSpanAttributes({ metadata, input, output, level, statusMessage, version, }: LangfuseSpanAttributes): Attributes;
+declare function createGenerationAttributes({ completionStartTime, metadata, level, statusMessage, version, model, modelParameters, input, output, usageDetails, costDetails, prompt, }: LangfuseGenerationAttributes): Attributes;
+
+type StartObservationOptions = {
+    startTime?: Date;
+    parentSpanContext?: SpanContext;
+};
+declare function startSpan(name: string, attributes?: LangfuseSpanAttributes, options?: {
+    startTime?: TimeInput;
+    parentSpanContext?: SpanContext;
+}): LangfuseSpan;
+declare function startGeneration(name: string, attributes?: LangfuseGenerationAttributes, options?: StartObservationOptions): LangfuseGeneration;
+declare function createEvent(name: string, attributes?: LangfuseEventAttributes, options?: StartObservationOptions): LangfuseEvent;
+declare function startActiveSpan<F extends (span: LangfuseSpan) => unknown>(name: string, fn: F, options?: StartObservationOptions): ReturnType<F>;
+declare function startActiveGeneration<F extends (span: LangfuseGeneration) => unknown>(name: string, fn: F, options?: StartObservationOptions): ReturnType<F>;
+declare function updateActiveTrace(attributes: LangfuseTraceAttributes): void;
+declare function updateActiveSpan(attributes: LangfuseSpanAttributes): void;
+declare function updateActiveGeneration(attributes: LangfuseGenerationAttributes): void;
+interface ObserveOptions {
+    name?: string;
+    asType?: "span" | "generation";
+    captureInput?: boolean;
+    captureOutput?: boolean;
+}
+declare function observe<T extends (...args: unknown[]) => unknown>(fn: T, options?: ObserveOptions): T;
+/**
+ * Creates a trace ID for OpenTelemetry spans.
+ *
+ * @param seed - A seed string for deterministic trace ID generation.
+ *               If provided (non-empty), the same seed will always generate the same trace ID.
+ *               If empty or falsy, generates a random trace ID.
+ *
+ *               Using a seed is especially useful when trying to correlate external,
+ *               non-W3C compliant IDs with Langfuse trace IDs. This allows you to later
+ *               have a method available for scoring the Langfuse trace given only the
+ *               external ID by regenerating the same trace ID from the external ID.
+ *
+ * @returns A Promise that resolves to a 32-character lowercase hexadecimal string suitable for use as an OpenTelemetry trace ID.
+ *
+ * @example
+ * ```typescript
+ * // Deterministic trace ID from seed
+ * const traceId1 = await createTraceId("my-session-123");
+ * const traceId2 = await createTraceId("my-session-123");
+ * console.log(traceId1 === traceId2); // true
+ *
+ * // Random trace ID
+ * const randomId1 = await createTraceId("");
+ * const randomId2 = await createTraceId("");
+ * console.log(randomId1 === randomId2); // false
+ *
+ * // Use with spans
+ * const span = startSpan("my-span", {}, {
+ *   parentSpanContext: {
+ *     traceId: await createTraceId("session-456"),
+ *     spanId: "0123456789abcdef",
+ *     traceFlags: 1
+ *   }
+ * });
+ *
+ * // Correlating external IDs with Langfuse traces
+ * const externalId = "ext-12345-67890";
+ * const traceId = await createTraceId(externalId);
+ *
+ * // Later, when you need to score this trace, regenerate the same ID
+ * const scoringTraceId = await createTraceId(externalId);
+ * console.log(traceId === scoringTraceId); // true - can now find and score the trace
+ * ```
+ */
+declare function createTraceId(seed?: string): Promise<string>;
+
+export { type LangfuseAttributes, LangfuseEvent, type LangfuseEventAttributes, LangfuseGeneration, type LangfuseGenerationAttributes, type LangfuseObservation, type LangfuseObservationType, LangfuseSpan, type LangfuseSpanAttributes, type LangfuseTraceAttributes, type ObservationLevel, type ObserveOptions, type StartObservationOptions, createEvent, createGenerationAttributes, createSpanAttributes, createTraceAttributes, createTraceId, observe, startActiveGeneration, startActiveSpan, startGeneration, startSpan, updateActiveGeneration, updateActiveSpan, updateActiveTrace };

package/dist/index.d.ts

@@ -0,0 +1,75 @@
+import { TimeInput, SpanContext } from "@opentelemetry/api";
+import { LangfuseEvent, LangfuseGeneration, LangfuseSpan } from "./spanWrapper.js";
+import { LangfuseEventAttributes, LangfuseGenerationAttributes, LangfuseSpanAttributes, LangfuseTraceAttributes } from "./types.js";
+export type { LangfuseObservationType, ObservationLevel, LangfuseSpanAttributes, LangfuseEventAttributes, LangfuseGenerationAttributes, LangfuseAttributes, LangfuseTraceAttributes, } from "./types.js";
+export * from "./spanWrapper.js";
+export { createTraceAttributes, createSpanAttributes, createGenerationAttributes, } from "./attributes.js";
+export { LangfuseOtelSpanAttributes } from "@langfuse/core";
+export type StartObservationOptions = {
+    startTime?: Date;
+    parentSpanContext?: SpanContext;
+};
+export declare function startSpan(name: string, attributes?: LangfuseSpanAttributes, options?: {
+    startTime?: TimeInput;
+    parentSpanContext?: SpanContext;
+}): LangfuseSpan;
+export declare function startGeneration(name: string, attributes?: LangfuseGenerationAttributes, options?: StartObservationOptions): LangfuseGeneration;
+export declare function createEvent(name: string, attributes?: LangfuseEventAttributes, options?: StartObservationOptions): LangfuseEvent;
+export declare function startActiveSpan<F extends (span: LangfuseSpan) => unknown>(name: string, fn: F, options?: StartObservationOptions): ReturnType<F>;
+export declare function startActiveGeneration<F extends (span: LangfuseGeneration) => unknown>(name: string, fn: F, options?: StartObservationOptions): ReturnType<F>;
+export declare function updateActiveTrace(attributes: LangfuseTraceAttributes): void;
+export declare function updateActiveSpan(attributes: LangfuseSpanAttributes): void;
+export declare function updateActiveGeneration(attributes: LangfuseGenerationAttributes): void;
+export interface ObserveOptions {
+    name?: string;
+    asType?: "span" | "generation";
+    captureInput?: boolean;
+    captureOutput?: boolean;
+}
+export declare function observe<T extends (...args: unknown[]) => unknown>(fn: T, options?: ObserveOptions): T;
+/**
+ * Creates a trace ID for OpenTelemetry spans.
+ *
+ * @param seed - A seed string for deterministic trace ID generation.
+ *               If provided (non-empty), the same seed will always generate the same trace ID.
+ *               If empty or falsy, generates a random trace ID.
+ *
+ *               Using a seed is especially useful when trying to correlate external,
+ *               non-W3C compliant IDs with Langfuse trace IDs. This allows you to later
+ *               have a method available for scoring the Langfuse trace given only the
+ *               external ID by regenerating the same trace ID from the external ID.
+ *
+ * @returns A Promise that resolves to a 32-character lowercase hexadecimal string suitable for use as an OpenTelemetry trace ID.
+ *
+ * @example
+ * ```typescript
+ * // Deterministic trace ID from seed
+ * const traceId1 = await createTraceId("my-session-123");
+ * const traceId2 = await createTraceId("my-session-123");
+ * console.log(traceId1 === traceId2); // true
+ *
+ * // Random trace ID
+ * const randomId1 = await createTraceId("");
+ * const randomId2 = await createTraceId("");
+ * console.log(randomId1 === randomId2); // false
+ *
+ * // Use with spans
+ * const span = startSpan("my-span", {}, {
+ *   parentSpanContext: {
+ *     traceId: await createTraceId("session-456"),
+ *     spanId: "0123456789abcdef",
+ *     traceFlags: 1
+ *   }
+ * });
+ *
+ * // Correlating external IDs with Langfuse traces
+ * const externalId = "ext-12345-67890";
+ * const traceId = await createTraceId(externalId);
+ *
+ * // Later, when you need to score this trace, regenerate the same ID
+ * const scoringTraceId = await createTraceId(externalId);
+ * console.log(traceId === scoringTraceId); // true - can now find and score the trace
+ * ```
+ */
+export declare function createTraceId(seed?: string): Promise<string>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,SAAS,EAIT,WAAW,EACZ,MAAM,oBAAoB,CAAC;AAO5B,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,YAAY,EACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,uBAAuB,EACvB,4BAA4B,EAC5B,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,uBAAuB,EACvB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,4BAA4B,EAC5B,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAEpB,cAAc,kBAAkB,CAAC;AACjC,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAE5D,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,iBAAiB,CAAC,EAAE,WAAW,CAAC;CACjC,CAAC;AA0CF,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,sBAAsB,EACnC,OAAO,CAAC,EAAE;IACR,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,iBAAiB,CAAC,EAAE,WAAW,CAAC;CACjC,GACA,YAAY,CAOd;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,4BAA4B,EACzC,OAAO,CAAC,EAAE,uBAAuB,GAChC,kBAAkB,CAOpB;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,uBAAuB,EACpC,OAAO,CAAC,EAAE,uBAAuB,iBAWlC;AAED,wBAAgB,eAAe,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,EACvE,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,EACL,OAAO,CAAC,EAAE,uBAAuB,GAChC,UAAU,CAAC,CAAC,CAAC,CA4Bf;AAED,wBAAgB,qBAAqB,CACnC,CAAC,SAAS,CAAC,IAAI,EAAE,kBAAkB,KAAK,OAAO,EAC/C,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,UAAU,CAAC,CAAC,CAAC,CA4BvE;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,uBAAuB,QAYpE;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,sBAAsB,QAYlE;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,4BAA4B,QAazC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,OAAO,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAC/D,EAAE,EAAE,CAAC,EACL,OAAO,GAAE,cAAmB,GAC3B,CAAC,CA2EH;AA6BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAsB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAalE"}

package/dist/index.js

@@ -0,0 +1,271 @@
+import { getGlobalLogger } from "@langfuse/core";
+import { trace, context, SpanStatusCode, } from "@opentelemetry/api";
+import { createGenerationAttributes, createSpanAttributes, createTraceAttributes, } from "./attributes.js";
+import { LangfuseEvent, LangfuseGeneration, LangfuseSpan, } from "./spanWrapper.js";
+import { getLangfuseTracer } from "./utils.js";
+export * from "./spanWrapper.js";
+export { createTraceAttributes, createSpanAttributes, createGenerationAttributes, } from "./attributes.js";
+export { LangfuseOtelSpanAttributes } from "@langfuse/core";
+function createOtelSpan(params) {
+    return getLangfuseTracer().startSpan(params.name, { startTime: params.startTime }, createParentContext(params.parentSpanContext));
+}
+function createParentContext(parentSpanContext) {
+    if (!parentSpanContext)
+        return;
+    return trace.setSpanContext(context.active(), parentSpanContext);
+}
+function wrapPromise(promise, span) {
+    return promise.then((value) => {
+        span.end(); // End span AFTER Promise resolves
+        return value;
+    }, (err) => {
+        span
+            .setStatus({
+            code: SpanStatusCode.ERROR,
+            message: err instanceof Error ? err.message : "Unknown error",
+        })
+            .end(); // End span AFTER Promise rejects
+        throw err;
+    });
+}
+export function startSpan(name, attributes, options) {
+    const otelSpan = createOtelSpan({
+        name,
+        ...options,
+    });
+    return new LangfuseSpan({ otelSpan, attributes });
+}
+export function startGeneration(name, attributes, options) {
+    const otelSpan = createOtelSpan({
+        name,
+        ...options,
+    });
+    return new LangfuseGeneration({ otelSpan, attributes });
+}
+export function createEvent(name, attributes, options) {
+    var _a;
+    const timestamp = (_a = options === null || options === void 0 ? void 0 : options.startTime) !== null && _a !== void 0 ? _a : new Date();
+    const otelSpan = createOtelSpan({
+        name,
+        ...options,
+        startTime: timestamp,
+    });
+    return new LangfuseEvent({ otelSpan, attributes, timestamp });
+}
+export function startActiveSpan(name, fn, options) {
+    var _a;
+    return getLangfuseTracer().startActiveSpan(name, { startTime: options === null || options === void 0 ? void 0 : options.startTime }, (_a = createParentContext(options === null || options === void 0 ? void 0 : options.parentSpanContext)) !== null && _a !== void 0 ? _a : context.active(), (span) => {
+        try {
+            const result = fn(new LangfuseSpan({ otelSpan: span }));
+            if (result instanceof Promise) {
+                return wrapPromise(result, span);
+            }
+            else {
+                span.end();
+                return result;
+            }
+        }
+        catch (err) {
+            span
+                .setStatus({
+                code: SpanStatusCode.ERROR,
+                message: err instanceof Error ? err.message : "Unknown error",
+            })
+                .end();
+            throw err;
+        }
+    });
+}
+export function startActiveGeneration(name, fn, options) {
+    var _a;
+    return getLangfuseTracer().startActiveSpan(name, { startTime: options === null || options === void 0 ? void 0 : options.startTime }, (_a = createParentContext(options === null || options === void 0 ? void 0 : options.parentSpanContext)) !== null && _a !== void 0 ? _a : context.active(), (span) => {
+        try {
+            const result = fn(new LangfuseGeneration({ otelSpan: span }));
+            if (result instanceof Promise) {
+                return wrapPromise(result, span);
+            }
+            else {
+                span.end();
+                return result;
+            }
+        }
+        catch (err) {
+            span
+                .setStatus({
+                code: SpanStatusCode.ERROR,
+                message: err instanceof Error ? err.message : "Unknown error",
+            })
+                .end();
+            throw err;
+        }
+    });
+}
+export function updateActiveTrace(attributes) {
+    const span = trace.getActiveSpan();
+    if (!span) {
+        getGlobalLogger().warn("No active OTEL span in context. Skipping trace update.");
+        return;
+    }
+    span.setAttributes(createTraceAttributes(attributes));
+}
+export function updateActiveSpan(attributes) {
+    const span = trace.getActiveSpan();
+    if (!span) {
+        getGlobalLogger().warn("No active OTEL span in context. Skipping span update.");
+        return;
+    }
+    span.setAttributes(createSpanAttributes(attributes));
+}
+export function updateActiveGeneration(attributes) {
+    const span = trace.getActiveSpan();
+    if (!span) {
+        getGlobalLogger().warn("No active OTEL span in context. Skipping generation update.");
+        return;
+    }
+    span.setAttributes(createGenerationAttributes(attributes));
+}
+export function observe(fn, options = {}) {
+    const { name = fn.name || "anonymous-function", asType = "span", captureInput = true, captureOutput = true, } = options;
+    const wrappedFunction = (...args) => {
+        // Prepare input data
+        const inputData = captureInput ? _captureArguments(args) : undefined;
+        // Create the appropriate observation type
+        const observation = asType === "generation"
+            ? startGeneration(name, inputData ? { input: inputData } : {})
+            : startSpan(name, inputData ? { input: inputData } : {});
+        // Set the observation span as active in the context
+        const activeContext = trace.setSpan(context.active(), observation.otelSpan);
+        try {
+            const result = context.with(activeContext, () => fn(...args));
+            // Handle async functions - check if result is a Promise
+            // TODO: handle returned generators for streamed responses
+            if (result instanceof Promise) {
+                return result.then((value) => {
+                    if (captureOutput) {
+                        observation.update({ output: _captureOutput(value) });
+                    }
+                    observation.end();
+                    return value;
+                }, (error) => {
+                    observation
+                        .update({
+                        level: "ERROR",
+                        statusMessage: (error instanceof Error ? error.message : String(error)) ||
+                            "Function threw an error",
+                        output: captureOutput ? { error: String(error) } : undefined,
+                    })
+                        .end();
+                    throw error;
+                });
+            }
+            else {
+                // Handle sync functions
+                if (captureOutput) {
+                    observation.update({ output: _captureOutput(result) });
+                }
+                observation.end();
+                return result;
+            }
+        }
+        catch (error) {
+            observation
+                .update({
+                level: "ERROR",
+                statusMessage: (error instanceof Error ? error.message : String(error)) ||
+                    "Function threw an error",
+                output: captureOutput ? { error: String(error) } : undefined,
+            })
+                .end();
+            throw error;
+        }
+    };
+    return wrappedFunction;
+}
+// Helper function to safely capture function arguments
+function _captureArguments(args) {
+    try {
+        if (args.length === 0)
+            return undefined;
+        if (args.length === 1)
+            return args[0];
+        return args;
+    }
+    catch {
+        return "<failed to capture arguments>";
+    }
+}
+// Helper function to safely capture function output
+function _captureOutput(value) {
+    try {
+        // Handle undefined/null
+        if (value === undefined || value === null)
+            return value;
+        // For primitive types, return as-is
+        if (typeof value !== "object")
+            return value;
+        // For objects, return them directly (serialization happens in span processor)
+        return value;
+    }
+    catch {
+        return "<failed to capture output>";
+    }
+}
+/**
+ * Creates a trace ID for OpenTelemetry spans.
+ *
+ * @param seed - A seed string for deterministic trace ID generation.
+ *               If provided (non-empty), the same seed will always generate the same trace ID.
+ *               If empty or falsy, generates a random trace ID.
+ *
+ *               Using a seed is especially useful when trying to correlate external,
+ *               non-W3C compliant IDs with Langfuse trace IDs. This allows you to later
+ *               have a method available for scoring the Langfuse trace given only the
+ *               external ID by regenerating the same trace ID from the external ID.
+ *
+ * @returns A Promise that resolves to a 32-character lowercase hexadecimal string suitable for use as an OpenTelemetry trace ID.
+ *
+ * @example
+ * ```typescript
+ * // Deterministic trace ID from seed
+ * const traceId1 = await createTraceId("my-session-123");
+ * const traceId2 = await createTraceId("my-session-123");
+ * console.log(traceId1 === traceId2); // true
+ *
+ * // Random trace ID
+ * const randomId1 = await createTraceId("");
+ * const randomId2 = await createTraceId("");
+ * console.log(randomId1 === randomId2); // false
+ *
+ * // Use with spans
+ * const span = startSpan("my-span", {}, {
+ *   parentSpanContext: {
+ *     traceId: await createTraceId("session-456"),
+ *     spanId: "0123456789abcdef",
+ *     traceFlags: 1
+ *   }
+ * });
+ *
+ * // Correlating external IDs with Langfuse traces
+ * const externalId = "ext-12345-67890";
+ * const traceId = await createTraceId(externalId);
+ *
+ * // Later, when you need to score this trace, regenerate the same ID
+ * const scoringTraceId = await createTraceId(externalId);
+ * console.log(traceId === scoringTraceId); // true - can now find and score the trace
+ * ```
+ */
+export async function createTraceId(seed) {
+    if (seed) {
+        const data = new TextEncoder().encode(seed);
+        const hashBuffer = await crypto.subtle.digest("SHA-256", data);
+        const hashArray = new Uint8Array(hashBuffer);
+        return uint8ArrayToHex(hashArray).slice(0, 32);
+    }
+    const randomValues = crypto.getRandomValues(new Uint8Array(16));
+    return uint8ArrayToHex(randomValues);
+}
+function uint8ArrayToHex(array) {
+    return Array.from(array)
+        .map((b) => b.toString(16).padStart(2, "0"))
+        .join("");
+}