@langfuse/tracing 4.0.0-alpha.2 → 4.0.0-beta.0

package/dist/index.d.ts

@@ -1,32 +1,122 @@
-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 = {
+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;
 };
-export declare function startSpan(name: string, attributes?: LangfuseSpanAttributes, options?: {
+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 {
+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;
 }
-export declare function observe<T extends (...args: unknown[]) => unknown>(fn: T, options?: ObserveOptions): T;
+declare function observe<T extends (...args: unknown[]) => unknown>(fn: T, options?: ObserveOptions): T;
 /**
  * Creates a trace ID for OpenTelemetry spans.
  *
@@ -71,5 +161,6 @@ export declare function observe<T extends (...args: unknown[]) => unknown>(fn: T
  * 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
+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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langfuse/tracing",
-  "version": "4.0.0-alpha.2",
+  "version": "4.0.0-beta.0",
   "author": "Langfuse",
   "license": "MIT",
   "engines": {
@@ -23,7 +23,7 @@
     "dist"
   ],
   "dependencies": {
-    "@langfuse/core": "^4.0.0-alpha.2"
+    "@langfuse/core": "^4.0.0-beta.0"
   },
   "peerDependencies": {
     "@opentelemetry/api": "^1.9.0"

package/dist/attributes.d.ts

@@ -1,7 +0,0 @@
-import { type Attributes } from "@opentelemetry/api";
-import { LangfuseGenerationAttributes, LangfuseSpanAttributes, LangfuseTraceAttributes } from "./types.js";
-export declare function createTraceAttributes({ name, userId, sessionId, version, release, input, output, metadata, tags, environment, public: isPublic, }?: LangfuseTraceAttributes): Attributes;
-export declare function createSpanAttributes({ metadata, input, output, level, statusMessage, version, }: LangfuseSpanAttributes): Attributes;
-export declare function createGenerationAttributes({ completionStartTime, metadata, level, statusMessage, version, model, modelParameters, input, output, usageDetails, costDetails, prompt, }: LangfuseGenerationAttributes): Attributes;
-export declare function createEventAttributes({ metadata, input, output, level, statusMessage, version, }: LangfuseSpanAttributes): Attributes;
-//# sourceMappingURL=attributes.d.ts.map

package/dist/attributes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../src/attributes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,qBAAqB,CAAC,EACpC,IAAI,EACJ,MAAM,EACN,SAAS,EACT,OAAO,EACP,OAAO,EACP,KAAK,EACL,MAAM,EACN,QAAQ,EACR,IAAI,EACJ,WAAW,EACX,MAAM,EAAE,QAAQ,GACjB,GAAE,uBAA4B,GAAG,UAAU,CAkB3C;AAED,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,KAAK,EACL,MAAM,EACN,KAAK,EACL,aAAa,EACb,OAAO,GACR,EAAE,sBAAsB,GAAG,UAAU,CAcrC;AAED,wBAAgB,0BAA0B,CAAC,EACzC,mBAAmB,EACnB,QAAQ,EACR,KAAK,EACL,aAAa,EACb,OAAO,EACP,KAAK,EACL,eAAe,EACf,KAAK,EACL,MAAM,EACN,YAAY,EACZ,WAAW,EACX,MAAM,GACP,EAAE,4BAA4B,GAAG,UAAU,CA8B3C;AAED,wBAAgB,qBAAqB,CAAC,EACpC,QAAQ,EACR,KAAK,EACL,MAAM,EACN,KAAK,EACL,aAAa,EACb,OAAO,GACR,EAAE,sBAAsB,GAAG,UAAU,CAcrC"}

package/dist/attributes.js

@@ -1,96 +0,0 @@
-import { LangfuseOtelSpanAttributes } from "@langfuse/core";
-export 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));
-}
-export 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));
-}
-export 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));
-}
-export 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) : undefined;
-    }
-    catch {
-        return "<failed to serialize>";
-    }
-}
-function _flattenAndSerializeMetadata(metadata, type) {
-    const prefix = type === "observation"
-        ? LangfuseOtelSpanAttributes.OBSERVATION_METADATA
-        : LangfuseOtelSpanAttributes.TRACE_METADATA;
-    const metadataAttributes = {};
-    if (metadata === undefined || 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;
-}

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"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

@@ -1,271 +0,0 @@
-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("");
-}

package/dist/spanWrapper.d.ts

@@ -1,46 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,73 +0,0 @@
-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);
-    }
-}

package/dist/types.d.ts

@@ -1,50 +0,0 @@
-import { OpenAiUsage } from "@langfuse/core";
-export type LangfuseObservationType = "span" | "generation" | "event";
-export type ObservationLevel = "DEBUG" | "DEFAULT" | "WARNING" | "ERROR";
-export type LangfuseSpanAttributes = {
-    input?: unknown;
-    output?: unknown;
-    metadata?: Record<string, unknown>;
-    level?: ObservationLevel;
-    statusMessage?: string;
-    version?: string;
-    environment?: string;
-};
-export type LangfuseEventAttributes = LangfuseSpanAttributes;
-export 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;
-    };
-};
-export type LangfuseAttributes = LangfuseSpanAttributes | LangfuseGenerationAttributes | LangfuseEventAttributes;
-export type LangfuseTraceAttributes = {
-    name?: string;
-    userId?: string;
-    sessionId?: string;
-    version?: string;
-    release?: string;
-    input?: unknown;
-    output?: unknown;
-    metadata?: unknown;
-    tags?: string[];
-    public?: boolean;
-    environment?: string;
-};
-export type TraceContext = {
-    traceId: string;
-    parentObservationId?: string;
-};
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,YAAY,GAAG,OAAO,CAAC;AACtE,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AACzE,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AACF,MAAM,MAAM,uBAAuB,GAAG,sBAAsB,CAAC;AAC7D,MAAM,MAAM,4BAA4B,GAAG,sBAAsB,GAAG;IAClE,mBAAmB,CAAC,EAAE,IAAI,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,eAAe,CAAC,EAAE;QAChB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;KACvC,CAAC;IACF,YAAY,CAAC,EACT;QACE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;KACvB,GACD,WAAW,CAAC;IAChB,WAAW,CAAC,EAAE;QACZ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;KACvB,CAAC;IACF,MAAM,CAAC,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,OAAO,CAAC;KACrB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAC1B,sBAAsB,GACtB,4BAA4B,GAC5B,uBAAuB,CAAC;AAE5B,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC"}

package/dist/types.js

@@ -1 +0,0 @@
-export {};

package/dist/utils.d.ts

@@ -1,2 +0,0 @@
-export declare function getLangfuseTracer(): import("@opentelemetry/api").Tracer;
-//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAGA,wBAAgB,iBAAiB,wCAEhC"}

package/dist/utils.js

@@ -1,5 +0,0 @@
-import { LANGFUSE_SDK_VERSION, LANGFUSE_TRACER_NAME } from "@langfuse/core";
-import { trace } from "@opentelemetry/api";
-export function getLangfuseTracer() {
-    return trace.getTracer(LANGFUSE_TRACER_NAME, LANGFUSE_SDK_VERSION);
-}