@langfuse/tracing 4.0.0-alpha.0

package/dist/index.mjs

@@ -0,0 +1,460 @@
+// src/index.ts
+import { getGlobalLogger } from "@langfuse/core";
+import {
+  trace as trace2,
+  context,
+  SpanStatusCode
+} from "@opentelemetry/api";
+
+// src/attributes.ts
+import { LangfuseOtelSpanAttributes } from "@langfuse/core";
+function createTraceAttributes({
+  name,
+  userId,
+  sessionId,
+  version,
+  release,
+  input,
+  output,
+  metadata,
+  tags,
+  environment,
+  public: isPublic
+} = {}) {
+  const attributes = {
+    [LangfuseOtelSpanAttributes.TRACE_NAME]: name,
+    [LangfuseOtelSpanAttributes.TRACE_USER_ID]: userId,
+    [LangfuseOtelSpanAttributes.TRACE_SESSION_ID]: sessionId,
+    [LangfuseOtelSpanAttributes.VERSION]: version,
+    [LangfuseOtelSpanAttributes.RELEASE]: release,
+    [LangfuseOtelSpanAttributes.TRACE_INPUT]: _serialize(input),
+    [LangfuseOtelSpanAttributes.TRACE_OUTPUT]: _serialize(output),
+    [LangfuseOtelSpanAttributes.TRACE_TAGS]: tags,
+    [LangfuseOtelSpanAttributes.ENVIRONMENT]: environment,
+    [LangfuseOtelSpanAttributes.TRACE_PUBLIC]: isPublic,
+    ..._flattenAndSerializeMetadata(metadata, "trace")
+  };
+  return Object.fromEntries(
+    Object.entries(attributes).filter(([_, v]) => v != null)
+  );
+}
+function createSpanAttributes({
+  metadata,
+  input,
+  output,
+  level,
+  statusMessage,
+  version
+}) {
+  const attributes = {
+    [LangfuseOtelSpanAttributes.OBSERVATION_TYPE]: "span",
+    [LangfuseOtelSpanAttributes.OBSERVATION_LEVEL]: level,
+    [LangfuseOtelSpanAttributes.OBSERVATION_STATUS_MESSAGE]: statusMessage,
+    [LangfuseOtelSpanAttributes.VERSION]: version,
+    [LangfuseOtelSpanAttributes.OBSERVATION_INPUT]: _serialize(input),
+    [LangfuseOtelSpanAttributes.OBSERVATION_OUTPUT]: _serialize(output),
+    ..._flattenAndSerializeMetadata(metadata, "observation")
+  };
+  return Object.fromEntries(
+    Object.entries(attributes).filter(([_, v]) => v != null)
+  );
+}
+function createGenerationAttributes({
+  completionStartTime,
+  metadata,
+  level,
+  statusMessage,
+  version,
+  model,
+  modelParameters,
+  input,
+  output,
+  usageDetails,
+  costDetails,
+  prompt
+}) {
+  const attributes = {
+    [LangfuseOtelSpanAttributes.OBSERVATION_TYPE]: "generation",
+    [LangfuseOtelSpanAttributes.OBSERVATION_LEVEL]: level,
+    [LangfuseOtelSpanAttributes.OBSERVATION_STATUS_MESSAGE]: statusMessage,
+    [LangfuseOtelSpanAttributes.VERSION]: version,
+    [LangfuseOtelSpanAttributes.OBSERVATION_INPUT]: _serialize(input),
+    [LangfuseOtelSpanAttributes.OBSERVATION_OUTPUT]: _serialize(output),
+    [LangfuseOtelSpanAttributes.OBSERVATION_MODEL]: model,
+    [LangfuseOtelSpanAttributes.OBSERVATION_USAGE_DETAILS]: _serialize(usageDetails),
+    [LangfuseOtelSpanAttributes.OBSERVATION_COST_DETAILS]: _serialize(costDetails),
+    [LangfuseOtelSpanAttributes.OBSERVATION_COMPLETION_START_TIME]: _serialize(completionStartTime),
+    [LangfuseOtelSpanAttributes.OBSERVATION_MODEL_PARAMETERS]: _serialize(modelParameters),
+    ...prompt && !prompt.isFallback ? {
+      [LangfuseOtelSpanAttributes.OBSERVATION_PROMPT_NAME]: prompt.name,
+      [LangfuseOtelSpanAttributes.OBSERVATION_PROMPT_VERSION]: prompt.version
+    } : {},
+    ..._flattenAndSerializeMetadata(metadata, "observation")
+  };
+  return Object.fromEntries(
+    Object.entries(attributes).filter(([_, v]) => v != null)
+  );
+}
+function createEventAttributes({
+  metadata,
+  input,
+  output,
+  level,
+  statusMessage,
+  version
+}) {
+  const attributes = {
+    [LangfuseOtelSpanAttributes.OBSERVATION_TYPE]: "event",
+    [LangfuseOtelSpanAttributes.OBSERVATION_LEVEL]: level,
+    [LangfuseOtelSpanAttributes.OBSERVATION_STATUS_MESSAGE]: statusMessage,
+    [LangfuseOtelSpanAttributes.VERSION]: version,
+    [LangfuseOtelSpanAttributes.OBSERVATION_INPUT]: _serialize(input),
+    [LangfuseOtelSpanAttributes.OBSERVATION_OUTPUT]: _serialize(output),
+    ..._flattenAndSerializeMetadata(metadata, "observation")
+  };
+  return Object.fromEntries(
+    Object.entries(attributes).filter(([_, v]) => v != null)
+  );
+}
+function _serialize(obj) {
+  try {
+    return obj != null ? JSON.stringify(obj) : void 0;
+  } catch {
+    return "<failed to serialize>";
+  }
+}
+function _flattenAndSerializeMetadata(metadata, type) {
+  const prefix = type === "observation" ? LangfuseOtelSpanAttributes.OBSERVATION_METADATA : LangfuseOtelSpanAttributes.TRACE_METADATA;
+  const metadataAttributes = {};
+  if (metadata === void 0 || metadata === null) {
+    return metadataAttributes;
+  }
+  if (typeof metadata !== "object" || Array.isArray(metadata)) {
+    const serialized = _serialize(metadata);
+    if (serialized) {
+      metadataAttributes[prefix] = serialized;
+    }
+  } else {
+    for (const [key, value] of Object.entries(metadata)) {
+      const serialized = typeof value === "string" ? value : _serialize(value);
+      if (serialized) {
+        metadataAttributes[`${prefix}.${key}`] = serialized;
+      }
+    }
+  }
+  return metadataAttributes;
+}
+
+// src/utils.ts
+import { LANGFUSE_SDK_VERSION, LANGFUSE_TRACER_NAME } from "@langfuse/core";
+import { trace } from "@opentelemetry/api";
+function getLangfuseTracer() {
+  return trace.getTracer(LANGFUSE_TRACER_NAME, LANGFUSE_SDK_VERSION);
+}
+
+// src/spanWrapper.ts
+var LangfuseSpanWrapper = class {
+  constructor(params) {
+    this.otelSpan = params.otelSpan;
+    this.id = params.otelSpan.spanContext().spanId;
+    this.traceId = params.otelSpan.spanContext().traceId;
+  }
+  get tracer() {
+    return getLangfuseTracer();
+  }
+  end(endTime) {
+    this.otelSpan.end(endTime);
+  }
+  updateTrace(attributes) {
+    this.otelSpan.setAttributes(createTraceAttributes(attributes));
+    return this;
+  }
+};
+var LangfuseSpan = class extends LangfuseSpanWrapper {
+  constructor(params) {
+    super(params);
+    if (params.attributes) {
+      this.otelSpan.setAttributes(createSpanAttributes(params.attributes));
+    }
+  }
+  update(attributes) {
+    this.otelSpan.setAttributes(createSpanAttributes(attributes));
+    return this;
+  }
+  startSpan(name, attributes) {
+    return startSpan(name, attributes, {
+      parentSpanContext: this.otelSpan.spanContext()
+    });
+  }
+  startGeneration(name, attributes) {
+    return startGeneration(name, attributes, {
+      parentSpanContext: this.otelSpan.spanContext()
+    });
+  }
+  createEvent(name, attributes) {
+    return createEvent(name, attributes, {
+      parentSpanContext: this.otelSpan.spanContext()
+    });
+  }
+};
+var LangfuseGeneration = class extends LangfuseSpanWrapper {
+  constructor(params) {
+    super(params);
+    if (params.attributes) {
+      this.otelSpan.setAttributes(
+        createGenerationAttributes(params.attributes)
+      );
+    }
+  }
+  update(attributes) {
+    this.otelSpan.setAttributes(createGenerationAttributes(attributes));
+    return this;
+  }
+  createEvent(name, attributes) {
+    return createEvent(name, attributes, {
+      parentSpanContext: this.otelSpan.spanContext()
+    });
+  }
+};
+var LangfuseEvent = class extends LangfuseSpanWrapper {
+  constructor(params) {
+    super(params);
+    if (params.attributes) {
+      this.otelSpan.setAttributes(createEventAttributes(params.attributes));
+    }
+    this.otelSpan.end(params.timestamp);
+  }
+};
+
+// src/index.ts
+import { LangfuseOtelSpanAttributes as LangfuseOtelSpanAttributes2 } from "@langfuse/core";
+function createOtelSpan(params) {
+  return getLangfuseTracer().startSpan(
+    params.name,
+    { startTime: params.startTime },
+    createParentContext(params.parentSpanContext)
+  );
+}
+function createParentContext(parentSpanContext) {
+  if (!parentSpanContext) return;
+  return trace2.setSpanContext(context.active(), parentSpanContext);
+}
+function wrapPromise(promise, span) {
+  return promise.then(
+    (value) => {
+      span.end();
+      return value;
+    },
+    (err) => {
+      span.setStatus({
+        code: SpanStatusCode.ERROR,
+        message: err instanceof Error ? err.message : "Unknown error"
+      }).end();
+      throw err;
+    }
+  );
+}
+function startSpan(name, attributes, options) {
+  const otelSpan = createOtelSpan({
+    name,
+    ...options
+  });
+  return new LangfuseSpan({ otelSpan, attributes });
+}
+function startGeneration(name, attributes, options) {
+  const otelSpan = createOtelSpan({
+    name,
+    ...options
+  });
+  return new LangfuseGeneration({ otelSpan, attributes });
+}
+function createEvent(name, attributes, options) {
+  var _a;
+  const timestamp = (_a = options == null ? void 0 : options.startTime) != null ? _a : /* @__PURE__ */ new Date();
+  const otelSpan = createOtelSpan({
+    name,
+    ...options,
+    startTime: timestamp
+  });
+  return new LangfuseEvent({ otelSpan, attributes, timestamp });
+}
+function startActiveSpan(name, fn, options) {
+  var _a;
+  return getLangfuseTracer().startActiveSpan(
+    name,
+    { startTime: options == null ? void 0 : options.startTime },
+    (_a = createParentContext(options == null ? void 0 : options.parentSpanContext)) != null ? _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;
+      }
+    }
+  );
+}
+function startActiveGeneration(name, fn, options) {
+  var _a;
+  return getLangfuseTracer().startActiveSpan(
+    name,
+    { startTime: options == null ? void 0 : options.startTime },
+    (_a = createParentContext(options == null ? void 0 : options.parentSpanContext)) != null ? _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;
+      }
+    }
+  );
+}
+function updateActiveTrace(attributes) {
+  const span = trace2.getActiveSpan();
+  if (!span) {
+    getGlobalLogger().warn(
+      "No active OTEL span in context. Skipping trace update."
+    );
+    return;
+  }
+  span.setAttributes(createTraceAttributes(attributes));
+}
+function updateActiveSpan(attributes) {
+  const span = trace2.getActiveSpan();
+  if (!span) {
+    getGlobalLogger().warn(
+      "No active OTEL span in context. Skipping span update."
+    );
+    return;
+  }
+  span.setAttributes(createSpanAttributes(attributes));
+}
+function updateActiveGeneration(attributes) {
+  const span = trace2.getActiveSpan();
+  if (!span) {
+    getGlobalLogger().warn(
+      "No active OTEL span in context. Skipping generation update."
+    );
+    return;
+  }
+  span.setAttributes(createGenerationAttributes(attributes));
+}
+function observe(fn, options = {}) {
+  const {
+    name = fn.name || "anonymous-function",
+    asType = "span",
+    captureInput = true,
+    captureOutput = true
+  } = options;
+  const wrappedFunction = (...args) => {
+    const inputData = captureInput ? _captureArguments(args) : void 0;
+    const observation = asType === "generation" ? startGeneration(name, inputData ? { input: inputData } : {}) : startSpan(name, inputData ? { input: inputData } : {});
+    const activeContext = trace2.setSpan(context.active(), observation.otelSpan);
+    try {
+      const result = context.with(activeContext, () => fn(...args));
+      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) } : void 0
+            }).end();
+            throw error;
+          }
+        );
+      } else {
+        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) } : void 0
+      }).end();
+      throw error;
+    }
+  };
+  return wrappedFunction;
+}
+function _captureArguments(args) {
+  try {
+    if (args.length === 0) return void 0;
+    if (args.length === 1) return args[0];
+    return args;
+  } catch {
+    return "<failed to capture arguments>";
+  }
+}
+function _captureOutput(value) {
+  try {
+    if (value === void 0 || value === null) return value;
+    if (typeof value !== "object") return value;
+    return value;
+  } catch {
+    return "<failed to capture output>";
+  }
+}
+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("");
+}
+export {
+  LangfuseEvent,
+  LangfuseGeneration,
+  LangfuseOtelSpanAttributes2 as LangfuseOtelSpanAttributes,
+  LangfuseSpan,
+  createEvent,
+  createGenerationAttributes,
+  createSpanAttributes,
+  createTraceAttributes,
+  createTraceId,
+  observe,
+  startActiveGeneration,
+  startActiveSpan,
+  startGeneration,
+  startSpan,
+  updateActiveGeneration,
+  updateActiveSpan,
+  updateActiveTrace
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.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":["trace","LangfuseOtelSpanAttributes","trace"]}

package/dist/spanWrapper.d.ts

@@ -0,0 +1,46 @@
+import { Span, TimeInput } from "@opentelemetry/api";
+import { LangfuseGenerationAttributes, LangfuseSpanAttributes, LangfuseEventAttributes, LangfuseTraceAttributes } from "./types.js";
+export 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(): import("@opentelemetry/api").Tracer;
+    end(endTime?: TimeInput): void;
+    updateTrace(attributes: LangfuseTraceAttributes): this;
+}
+type LangfuseSpanParams = {
+    otelSpan: Span;
+    attributes?: LangfuseSpanAttributes;
+};
+export 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;
+};
+export 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;
+};
+export declare class LangfuseEvent extends LangfuseSpanWrapper {
+    constructor(params: LangfuseEventParams);
+}
+export {};
+//# sourceMappingURL=spanWrapper.d.ts.map

package/dist/spanWrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spanWrapper.d.ts","sourceRoot":"","sources":["../src/spanWrapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAQrD,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAKpB,MAAM,MAAM,mBAAmB,GAC3B,YAAY,GACZ,kBAAkB,GAClB,aAAa,CAAC;AAElB,KAAK,yBAAyB,GAAG;IAC/B,QAAQ,EAAE,IAAI,CAAC;IACf,UAAU,CAAC,EACP,sBAAsB,GACtB,4BAA4B,GAC5B,uBAAuB,CAAC;CAC7B,CAAC;AAEF,uBAAe,mBAAmB;IAChC,SAAgB,QAAQ,EAAE,IAAI,CAAC;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;gBAEX,MAAM,EAAE,yBAAyB;IAM7C,SAAS,KAAK,MAAM,wCAEnB;IAEM,GAAG,CAAC,OAAO,CAAC,EAAE,SAAS;IAIvB,WAAW,CAAC,UAAU,EAAE,uBAAuB;CAKvD;AAED,KAAK,kBAAkB,GAAG;IACxB,QAAQ,EAAE,IAAI,CAAC;IACf,UAAU,CAAC,EAAE,sBAAsB,CAAC;CACrC,CAAC;AACF,qBAAa,YAAa,SAAQ,mBAAmB;gBACvC,MAAM,EAAE,kBAAkB;IAO/B,MAAM,CAAC,UAAU,EAAE,sBAAsB,GAAG,YAAY;IAMxD,SAAS,CACd,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,sBAAsB,GAClC,YAAY;IAMR,eAAe,CACpB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,4BAA4B,GACxC,kBAAkB;IAMd,WAAW,CAChB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,uBAAuB,GACnC,aAAa;CAKjB;AAED,KAAK,wBAAwB,GAAG;IAC9B,QAAQ,EAAE,IAAI,CAAC;IACf,UAAU,CAAC,EAAE,4BAA4B,CAAC;CAC3C,CAAC;AACF,qBAAa,kBAAmB,SAAQ,mBAAmB;gBAC7C,MAAM,EAAE,wBAAwB;IAS5C,MAAM,CAAC,UAAU,EAAE,4BAA4B,GAAG,kBAAkB;IAMpE,WAAW,CACT,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,uBAAuB,GACnC,aAAa;CAKjB;AAED,KAAK,mBAAmB,GAAG;IACzB,QAAQ,EAAE,IAAI,CAAC;IACf,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,SAAS,EAAE,SAAS,CAAC;CACtB,CAAC;AACF,qBAAa,aAAc,SAAQ,mBAAmB;gBACxC,MAAM,EAAE,mBAAmB;CASxC"}

package/dist/spanWrapper.js

@@ -0,0 +1,73 @@
+import { createEventAttributes, createGenerationAttributes, createSpanAttributes, createTraceAttributes, } from "./attributes.js";
+import { getLangfuseTracer } from "./utils.js";
+import { createEvent, startGeneration, startSpan } from "./index.js";
+class LangfuseSpanWrapper {
+    constructor(params) {
+        this.otelSpan = params.otelSpan;
+        this.id = params.otelSpan.spanContext().spanId;
+        this.traceId = params.otelSpan.spanContext().traceId;
+    }
+    get tracer() {
+        return getLangfuseTracer();
+    }
+    end(endTime) {
+        this.otelSpan.end(endTime);
+    }
+    updateTrace(attributes) {
+        this.otelSpan.setAttributes(createTraceAttributes(attributes));
+        return this;
+    }
+}
+export class LangfuseSpan extends LangfuseSpanWrapper {
+    constructor(params) {
+        super(params);
+        if (params.attributes) {
+            this.otelSpan.setAttributes(createSpanAttributes(params.attributes));
+        }
+    }
+    update(attributes) {
+        this.otelSpan.setAttributes(createSpanAttributes(attributes));
+        return this;
+    }
+    startSpan(name, attributes) {
+        return startSpan(name, attributes, {
+            parentSpanContext: this.otelSpan.spanContext(),
+        });
+    }
+    startGeneration(name, attributes) {
+        return startGeneration(name, attributes, {
+            parentSpanContext: this.otelSpan.spanContext(),
+        });
+    }
+    createEvent(name, attributes) {
+        return createEvent(name, attributes, {
+            parentSpanContext: this.otelSpan.spanContext(),
+        });
+    }
+}
+export class LangfuseGeneration extends LangfuseSpanWrapper {
+    constructor(params) {
+        super(params);
+        if (params.attributes) {
+            this.otelSpan.setAttributes(createGenerationAttributes(params.attributes));
+        }
+    }
+    update(attributes) {
+        this.otelSpan.setAttributes(createGenerationAttributes(attributes));
+        return this;
+    }
+    createEvent(name, attributes) {
+        return createEvent(name, attributes, {
+            parentSpanContext: this.otelSpan.spanContext(),
+        });
+    }
+}
+export class LangfuseEvent extends LangfuseSpanWrapper {
+    constructor(params) {
+        super(params);
+        if (params.attributes) {
+            this.otelSpan.setAttributes(createEventAttributes(params.attributes));
+        }
+        this.otelSpan.end(params.timestamp);
+    }
+}