@langfuse/client 4.0.0-alpha.2 → 4.0.0-alpha.3

package/dist/index.d.ts

@@ -1,6 +1,308 @@
-export * from "./LangfuseClient.js";
-export * from "./prompt/index.js";
-export * from "./score/index.js";
-export * from "./dataset/index.js";
-export * from "./media/index.js";
-//# sourceMappingURL=index.d.ts.map
+import * as _langfuse_core from '@langfuse/core';
+import { LangfuseAPIClient, Dataset, DatasetItem, DatasetRunItem, ParsedMediaReference, CreatePromptRequest, ChatMessage, ChatMessageWithPlaceholders, PlaceholderMessage, BasePrompt, Prompt, ScoreBody } from '@langfuse/core';
+import { Span } from '@opentelemetry/api';
+
+type LinkDatasetItemFunction = (obj: {
+    otelSpan: Span;
+}, runName: string, runArgs?: {
+    description?: string;
+    metadata?: any;
+}) => Promise<DatasetRunItem>;
+declare class DatasetManager {
+    private apiClient;
+    constructor(params: {
+        apiClient: LangfuseAPIClient;
+    });
+    get(name: string, options?: {
+        fetchItemsPageSize: number;
+    }): Promise<Dataset & {
+        items: (DatasetItem & {
+            link: LinkDatasetItemFunction;
+        })[];
+    }>;
+    private createDatasetItemLinkFunction;
+}
+
+type LangfuseMediaResolveMediaReferencesParams<T> = {
+    obj: T;
+    resolveWith: "base64DataUri";
+    maxDepth?: number;
+};
+declare class MediaManager {
+    private apiClient;
+    constructor(params: {
+        apiClient: LangfuseAPIClient;
+    });
+    /**
+     * Replaces the media reference strings in an object with base64 data URIs for the media content.
+     *
+     * This method recursively traverses an object (up to a maximum depth of 10) looking for media reference strings
+     * in the format "@@@langfuseMedia:...@@@". When found, it fetches the actual media content using the provided
+     * Langfuse client and replaces the reference string with a base64 data URI.
+     *
+     * If fetching media content fails for a reference string, a warning is logged and the reference string is left unchanged.
+     *
+     * @param params - Configuration object
+     * @param params.obj - The object to process. Can be a primitive value, array, or nested object
+     * @param params.resolveWith - The representation of the media content to replace the media reference string with. Currently only "base64DataUri" is supported.
+     * @param params.maxDepth - Optional. Default is 10. The maximum depth to traverse the object.
+     *
+     * @returns A deep copy of the input object with all media references replaced with base64 data URIs where possible
+     *
+     * @example
+     * ```typescript
+     * const obj = {
+     *   image: "@@@langfuseMedia:type=image/jpeg|id=123|source=bytes@@@",
+     *   nested: {
+     *     pdf: "@@@langfuseMedia:type=application/pdf|id=456|source=bytes@@@"
+     *   }
+     * };
+     *
+     * const result = await LangfuseMedia.resolveMediaReferences({
+     *   obj,
+     *   langfuseClient
+     * });
+     *
+     * // Result:
+     * // {
+     * //   image: "data:image/jpeg;base64,/9j/4AAQSkZJRg...",
+     * //   nested: {
+     * //     pdf: "data:application/pdf;base64,JVBERi0xLjcK..."
+     * //   }
+     * // }
+     * ```
+     */
+    resolveReferences<T>(params: LangfuseMediaResolveMediaReferencesParams<T>): Promise<T>;
+    /**
+     * Parses a media reference string into a ParsedMediaReference.
+     *
+     * Example reference string:
+     *     "@@@langfuseMedia:type=image/jpeg|id=some-uuid|source=base64DataUri@@@"
+     *
+     * @param referenceString - The reference string to parse.
+     * @returns An object with the mediaId, source, and contentType.
+     *
+     * @throws Error if the reference string is invalid or missing required fields.
+     */
+    static parseReferenceString(referenceString: string): ParsedMediaReference;
+}
+
+declare enum ChatMessageType {
+    ChatMessage = "chatmessage",
+    Placeholder = "placeholder"
+}
+type ChatMessageOrPlaceholder = ChatMessage | ({
+    type: ChatMessageType.Placeholder;
+} & PlaceholderMessage);
+type LangchainMessagesPlaceholder = {
+    variableName: string;
+    optional?: boolean;
+};
+type CreateChatPromptBodyWithPlaceholders = {
+    type: "chat";
+} & Omit<CreatePromptRequest.Chat, "type" | "prompt"> & {
+    prompt: (ChatMessage | ChatMessageWithPlaceholders)[];
+};
+
+declare abstract class BasePromptClient {
+    readonly name: string;
+    readonly version: number;
+    readonly config: unknown;
+    readonly labels: string[];
+    readonly tags: string[];
+    readonly isFallback: boolean;
+    readonly type: "text" | "chat";
+    readonly commitMessage: string | null | undefined;
+    constructor(prompt: BasePrompt, isFallback: boolean | undefined, type: "text" | "chat");
+    abstract get prompt(): string | ChatMessageWithPlaceholders[];
+    abstract set prompt(value: string | ChatMessageWithPlaceholders[]);
+    abstract compile(variables?: Record<string, string>, placeholders?: Record<string, any>): string | ChatMessage[] | (ChatMessageOrPlaceholder | any)[];
+    abstract getLangchainPrompt(options?: {
+        placeholders?: Record<string, any>;
+    }): string | ChatMessage[] | ChatMessageOrPlaceholder[] | (ChatMessage | LangchainMessagesPlaceholder | any)[];
+    protected _transformToLangchainVariables(content: string): string;
+    /**
+     * Escapes every curly brace that is part of a JSON object by doubling it.
+     *
+     * A curly brace is considered “JSON-related” when, after skipping any immediate
+     * whitespace, the next non-whitespace character is a single (') or double (") quote.
+     *
+     * Braces that are already doubled (e.g. `{{variable}}` placeholders) are left untouched.
+     *
+     * @param text - Input string that may contain JSON snippets.
+     * @returns The string with JSON-related braces doubled.
+     */
+    protected escapeJsonForLangchain(text: string): string;
+    abstract toJSON(): string;
+}
+declare class TextPromptClient extends BasePromptClient {
+    readonly promptResponse: Prompt.Text;
+    readonly prompt: string;
+    constructor(prompt: Prompt.Text, isFallback?: boolean);
+    compile(variables?: Record<string, string>, _placeholders?: Record<string, any>): string;
+    getLangchainPrompt(_options?: {
+        placeholders?: Record<string, any>;
+    }): string;
+    toJSON(): string;
+}
+declare class ChatPromptClient extends BasePromptClient {
+    readonly promptResponse: Prompt.Chat;
+    readonly prompt: ChatMessageWithPlaceholders[];
+    constructor(prompt: Prompt.Chat, isFallback?: boolean);
+    private static normalizePrompt;
+    compile(variables?: Record<string, string>, placeholders?: Record<string, any>): (ChatMessageOrPlaceholder | any)[];
+    getLangchainPrompt(options?: {
+        placeholders?: Record<string, any>;
+    }): (ChatMessage | LangchainMessagesPlaceholder | any)[];
+    toJSON(): string;
+}
+
+declare class PromptManager {
+    private cache;
+    private apiClient;
+    constructor(params: {
+        apiClient: LangfuseAPIClient;
+    });
+    get logger(): _langfuse_core.Logger;
+    create(body: CreateChatPromptBodyWithPlaceholders): Promise<ChatPromptClient>;
+    create(body: Omit<CreatePromptRequest.Text, "type"> & {
+        type?: "text";
+    }): Promise<TextPromptClient>;
+    create(body: CreatePromptRequest.Chat): Promise<ChatPromptClient>;
+    update(params: {
+        name: string;
+        version: number;
+        newLabels: string[];
+    }): Promise<Prompt>;
+    get(name: string, options?: {
+        version?: number;
+        label?: string;
+        cacheTtlSeconds?: number;
+        fallback?: string;
+        maxRetries?: number;
+        type?: "text";
+        fetchTimeoutMs?: number;
+    }): Promise<TextPromptClient>;
+    get(name: string, options?: {
+        version?: number;
+        label?: string;
+        cacheTtlSeconds?: number;
+        fallback?: ChatMessage[];
+        maxRetries?: number;
+        type: "chat";
+        fetchTimeoutMs?: number;
+    }): Promise<ChatPromptClient>;
+    private fetchPromptAndUpdateCache;
+}
+
+declare class ScoreManager {
+    private apiClient;
+    private eventQueue;
+    private flushPromise;
+    private flushTimer;
+    private flushAtCount;
+    private flushIntervalSeconds;
+    constructor(params: {
+        apiClient: LangfuseAPIClient;
+    });
+    get logger(): _langfuse_core.Logger;
+    create(data: ScoreBody): void;
+    observation(observation: {
+        otelSpan: Span;
+    }, data: Omit<ScoreBody, "traceId" | "sessionId" | "observationId" | "datasetRunId">): void;
+    trace(observation: {
+        otelSpan: Span;
+    }, data: Omit<ScoreBody, "traceId" | "sessionId" | "observationId" | "datasetRunId">): void;
+    activeObservation(data: Omit<ScoreBody, "traceId" | "sessionId" | "observationId" | "datasetRunId">): void;
+    activeTrace(data: Omit<ScoreBody, "traceId" | "sessionId" | "observationId" | "datasetRunId">): void;
+    private handleFlush;
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+
+interface LangfuseClientParams {
+    publicKey?: string;
+    secretKey?: string;
+    baseUrl?: string;
+    timeout?: number;
+    additionalHeaders?: Record<string, string>;
+}
+declare class LangfuseClient {
+    api: LangfuseAPIClient;
+    prompt: PromptManager;
+    dataset: DatasetManager;
+    score: ScoreManager;
+    media: MediaManager;
+    private baseUrl;
+    private projectId;
+    /**
+     * @deprecated Use prompt.get instead
+     */
+    getPrompt: typeof PromptManager.prototype.get;
+    /**
+     * @deprecated Use prompt.create instead
+     */
+    createPrompt: typeof PromptManager.prototype.create;
+    /**
+     * @deprecated Use prompt.update instead
+     */
+    updatePrompt: typeof PromptManager.prototype.update;
+    /**
+     * @deprecated Use dataset.get instead
+     */
+    getDataset: typeof DatasetManager.prototype.get;
+    /**
+     * @deprecated Use api.trace.get instead
+     */
+    fetchTrace: typeof LangfuseAPIClient.prototype.trace.get;
+    /**
+     * @deprecated Use api.trace.list instead
+     */
+    fetchTraces: typeof LangfuseAPIClient.prototype.trace.list;
+    /**
+     * @deprecated Use api.observations.get instead
+     */
+    fetchObservation: typeof LangfuseAPIClient.prototype.observations.get;
+    /**
+     * @deprecated Use api.observations.list instead
+     */
+    fetchObservations: typeof LangfuseAPIClient.prototype.observations.getMany;
+    /**
+     * @deprecated Use api.sessions.get instead
+     */
+    fetchSessions: typeof LangfuseAPIClient.prototype.sessions.get;
+    /**
+     * @deprecated Use api.datasets.getRun instead
+     */
+    getDatasetRun: typeof LangfuseAPIClient.prototype.datasets.getRun;
+    /**
+     * @deprecated Use api.datasets.getRuns instead
+     */
+    getDatasetRuns: typeof LangfuseAPIClient.prototype.datasets.getRuns;
+    /**
+     * @deprecated Use api.datasets.create instead
+     */
+    createDataset: typeof LangfuseAPIClient.prototype.datasets.create;
+    /**
+     * @deprecated Use api.datasetItems.get instead
+     */
+    getDatasetItem: typeof LangfuseAPIClient.prototype.datasetItems.get;
+    /**
+     * @deprecated Use api.datasetItems.create instead
+     */
+    createDatasetItem: typeof LangfuseAPIClient.prototype.datasetItems.create;
+    /**
+     * @deprecated Use api.media.get instead
+     */
+    fetchMedia: typeof LangfuseAPIClient.prototype.media.get;
+    /**
+     * @deprecated Use media.resolveReferences instead
+     */
+    resolveMediaReferences: typeof MediaManager.prototype.resolveReferences;
+    constructor(params?: LangfuseClientParams);
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+    getTraceUrl(traceId: string): Promise<string>;
+}
+
+export { type ChatMessageOrPlaceholder, ChatMessageType, ChatPromptClient, type CreateChatPromptBodyWithPlaceholders, DatasetManager, type LangchainMessagesPlaceholder, LangfuseClient, type LangfuseClientParams, type LangfuseMediaResolveMediaReferencesParams, type LinkDatasetItemFunction, MediaManager, PromptManager, ScoreManager, TextPromptClient };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langfuse/client",
-  "version": "4.0.0-alpha.2",
+  "version": "4.0.0-alpha.3",
   "description": "Langfuse API client for universal JavaScript environments",
   "type": "module",
   "sideEffects": false,
@@ -21,7 +21,7 @@
   ],
   "dependencies": {
     "mustache": "^4.2.0",
-    "@langfuse/core": "^4.0.0-alpha.2"
+    "@langfuse/core": "^4.0.0-alpha.3"
   },
   "peerDependencies": {
     "@opentelemetry/api": "^1.9.0"

package/dist/LangfuseClient.d.ts

@@ -1,90 +0,0 @@
-import { LangfuseAPIClient } from "@langfuse/core";
-import { DatasetManager } from "./dataset/index.js";
-import { MediaManager } from "./media/index.js";
-import { PromptManager } from "./prompt/index.js";
-import { ScoreManager } from "./score/index.js";
-export interface LangfuseClientParams {
-    publicKey?: string;
-    secretKey?: string;
-    baseUrl?: string;
-    timeout?: number;
-    additionalHeaders?: Record<string, string>;
-}
-export declare class LangfuseClient {
-    api: LangfuseAPIClient;
-    prompt: PromptManager;
-    dataset: DatasetManager;
-    score: ScoreManager;
-    media: MediaManager;
-    private baseUrl;
-    private projectId;
-    /**
-     * @deprecated Use prompt.get instead
-     */
-    getPrompt: typeof PromptManager.prototype.get;
-    /**
-     * @deprecated Use prompt.create instead
-     */
-    createPrompt: typeof PromptManager.prototype.create;
-    /**
-     * @deprecated Use prompt.update instead
-     */
-    updatePrompt: typeof PromptManager.prototype.update;
-    /**
-     * @deprecated Use dataset.get instead
-     */
-    getDataset: typeof DatasetManager.prototype.get;
-    /**
-     * @deprecated Use api.trace.get instead
-     */
-    fetchTrace: typeof LangfuseAPIClient.prototype.trace.get;
-    /**
-     * @deprecated Use api.trace.list instead
-     */
-    fetchTraces: typeof LangfuseAPIClient.prototype.trace.list;
-    /**
-     * @deprecated Use api.observations.get instead
-     */
-    fetchObservation: typeof LangfuseAPIClient.prototype.observations.get;
-    /**
-     * @deprecated Use api.observations.list instead
-     */
-    fetchObservations: typeof LangfuseAPIClient.prototype.observations.getMany;
-    /**
-     * @deprecated Use api.sessions.get instead
-     */
-    fetchSessions: typeof LangfuseAPIClient.prototype.sessions.get;
-    /**
-     * @deprecated Use api.datasets.getRun instead
-     */
-    getDatasetRun: typeof LangfuseAPIClient.prototype.datasets.getRun;
-    /**
-     * @deprecated Use api.datasets.getRuns instead
-     */
-    getDatasetRuns: typeof LangfuseAPIClient.prototype.datasets.getRuns;
-    /**
-     * @deprecated Use api.datasets.create instead
-     */
-    createDataset: typeof LangfuseAPIClient.prototype.datasets.create;
-    /**
-     * @deprecated Use api.datasetItems.get instead
-     */
-    getDatasetItem: typeof LangfuseAPIClient.prototype.datasetItems.get;
-    /**
-     * @deprecated Use api.datasetItems.create instead
-     */
-    createDatasetItem: typeof LangfuseAPIClient.prototype.datasetItems.create;
-    /**
-     * @deprecated Use api.media.get instead
-     */
-    fetchMedia: typeof LangfuseAPIClient.prototype.media.get;
-    /**
-     * @deprecated Use media.resolveReferences instead
-     */
-    resolveMediaReferences: typeof MediaManager.prototype.resolveReferences;
-    constructor(params?: LangfuseClientParams);
-    flush(): Promise<void>;
-    shutdown(): Promise<void>;
-    getTraceUrl(traceId: string): Promise<string>;
-}
-//# sourceMappingURL=LangfuseClient.d.ts.map

package/dist/LangfuseClient.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"LangfuseClient.d.ts","sourceRoot":"","sources":["../src/LangfuseClient.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EAIlB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5C;AAED,qBAAa,cAAc;IAClB,GAAG,EAAE,iBAAiB,CAAC;IACvB,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,YAAY,CAAC;IAE3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAuB;IAExC;;OAEG;IACI,SAAS,EAAE,OAAO,aAAa,CAAC,SAAS,CAAC,GAAG,CAAC;IACrD;;OAEG;IACI,YAAY,EAAE,OAAO,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC;IAC3D;;OAEG;IACI,YAAY,EAAE,OAAO,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC;IAC3D;;OAEG;IACI,UAAU,EAAE,OAAO,cAAc,CAAC,SAAS,CAAC,GAAG,CAAC;IACvD;;OAEG;IACI,UAAU,EAAE,OAAO,iBAAiB,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC;IAChE;;OAEG;IACI,WAAW,EAAE,OAAO,iBAAiB,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC;IAClE;;OAEG;IACI,gBAAgB,EAAE,OAAO,iBAAiB,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC;IAC7E;;OAEG;IACI,iBAAiB,EAAE,OAAO,iBAAiB,CAAC,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC;IAClF;;OAEG;IACI,aAAa,EAAE,OAAO,iBAAiB,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC;IACtE;;OAEG;IACI,aAAa,EAAE,OAAO,iBAAiB,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;IACzE;;OAEG;IACI,cAAc,EAAE,OAAO,iBAAiB,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC;IAC3E;;OAEG;IACI,aAAa,EAAE,OAAO,iBAAiB,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;IACzE;;OAEG;IACI,cAAc,EAAE,OAAO,iBAAiB,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC;IAC3E;;OAEG;IACI,iBAAiB,EAAE,OAAO,iBAAiB,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC;IACjF;;OAEG;IACI,UAAU,EAAE,OAAO,iBAAiB,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC;IAChE;;OAEG;IACI,sBAAsB,EAAE,OAAO,YAAY,CAAC,SAAS,CAAC,iBAAiB,CAAC;gBAEnE,MAAM,CAAC,EAAE,oBAAoB;IAiE5B,KAAK;IAIL,QAAQ;IAIR,WAAW,CAAC,OAAO,EAAE,MAAM;CAYzC"}

package/dist/LangfuseClient.js

@@ -1,74 +0,0 @@
-import { LangfuseAPIClient, LANGFUSE_SDK_VERSION, getGlobalLogger, getEnv, } from "@langfuse/core";
-import { DatasetManager } from "./dataset/index.js";
-import { MediaManager } from "./media/index.js";
-import { PromptManager } from "./prompt/index.js";
-import { ScoreManager } from "./score/index.js";
-export class LangfuseClient {
-    constructor(params) {
-        var _a, _b, _c, _d, _e, _f, _g;
-        this.projectId = null;
-        const logger = getGlobalLogger();
-        const publicKey = (_a = params === null || params === void 0 ? void 0 : params.publicKey) !== null && _a !== void 0 ? _a : getEnv("LANGFUSE_PUBLIC_KEY");
-        const secretKey = (_b = params === null || params === void 0 ? void 0 : params.secretKey) !== null && _b !== void 0 ? _b : getEnv("LANGFUSE_SECRET_KEY");
-        this.baseUrl =
-            (_e = (_d = (_c = params === null || params === void 0 ? void 0 : params.baseUrl) !== null && _c !== void 0 ? _c : getEnv("LANGFUSE_BASE_URL")) !== null && _d !== void 0 ? _d : getEnv("LANGFUSE_BASEURL")) !== null && _e !== void 0 ? _e : "https://cloud.langfuse.com";
-        if (!publicKey) {
-            logger.warn("No public key provided in constructor or as LANGFUSE_PUBLIC_KEY env var. Client operations will fail.");
-        }
-        if (!secretKey) {
-            logger.warn("No secret key provided in constructor or as LANGFUSE_SECRET_KEY env var. Client operations will fail.");
-        }
-        const timeoutSeconds = (_f = params === null || params === void 0 ? void 0 : params.timeout) !== null && _f !== void 0 ? _f : Number((_g = getEnv("LANGFUSE_TIMEOUT")) !== null && _g !== void 0 ? _g : 5);
-        this.api = new LangfuseAPIClient({
-            baseUrl: this.baseUrl,
-            username: publicKey,
-            password: secretKey,
-            xLangfusePublicKey: publicKey,
-            xLangfuseSdkVersion: LANGFUSE_SDK_VERSION,
-            xLangfuseSdkName: "javascript",
-            environment: "", // noop as baseUrl is set
-            headers: params === null || params === void 0 ? void 0 : params.additionalHeaders,
-        });
-        logger.debug("Initialized LangfuseClient with params:", {
-            publicKey,
-            baseUrl: this.baseUrl,
-            timeoutSeconds,
-        });
-        this.prompt = new PromptManager({ apiClient: this.api });
-        this.dataset = new DatasetManager({ apiClient: this.api });
-        this.score = new ScoreManager({ apiClient: this.api });
-        this.media = new MediaManager({ apiClient: this.api });
-        // Keep v3 compat by exposing old interface
-        this.getPrompt = this.prompt.get.bind(this.prompt); // keep correct this context for cache access
-        this.createPrompt = this.prompt.create.bind(this.prompt);
-        this.updatePrompt = this.prompt.update.bind(this.prompt);
-        this.getDataset = this.dataset.get;
-        this.fetchTrace = this.api.trace.get;
-        this.fetchTraces = this.api.trace.list;
-        this.fetchObservation = this.api.observations.get;
-        this.fetchObservations = this.api.observations.getMany;
-        this.fetchSessions = this.api.sessions.get;
-        this.getDatasetRun = this.api.datasets.getRun;
-        this.getDatasetRuns = this.api.datasets.getRuns;
-        this.createDataset = this.api.datasets.create;
-        this.getDatasetItem = this.api.datasetItems.get;
-        this.createDatasetItem = this.api.datasetItems.create;
-        this.fetchMedia = this.api.media.get;
-        this.resolveMediaReferences = this.media.resolveReferences;
-    }
-    async flush() {
-        return this.score.flush();
-    }
-    async shutdown() {
-        return this.score.shutdown();
-    }
-    async getTraceUrl(traceId) {
-        let projectId = this.projectId;
-        if (!projectId) {
-            projectId = (await this.api.projects.get()).data[0].id;
-            this.projectId = projectId;
-        }
-        const traceUrl = `${this.baseUrl}/project/${projectId}/traces/${traceId}`;
-        return traceUrl;
-    }
-}

package/dist/dataset/index.d.ts

@@ -1,23 +0,0 @@
-import { LangfuseAPIClient, Dataset, DatasetRunItem, DatasetItem } from "@langfuse/core";
-import { Span } from "@opentelemetry/api";
-export type LinkDatasetItemFunction = (obj: {
-    otelSpan: Span;
-}, runName: string, runArgs?: {
-    description?: string;
-    metadata?: any;
-}) => Promise<DatasetRunItem>;
-export declare class DatasetManager {
-    private apiClient;
-    constructor(params: {
-        apiClient: LangfuseAPIClient;
-    });
-    get(name: string, options?: {
-        fetchItemsPageSize: number;
-    }): Promise<Dataset & {
-        items: (DatasetItem & {
-            link: LinkDatasetItemFunction;
-        })[];
-    }>;
-    private createDatasetItemLinkFunction;
-}
-//# sourceMappingURL=index.d.ts.map

package/dist/dataset/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dataset/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,OAAO,EACP,cAAc,EACd,WAAW,EACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE1C,MAAM,MAAM,uBAAuB,GAAG,CACpC,GAAG,EAAE;IAAE,QAAQ,EAAE,IAAI,CAAA;CAAE,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IACR,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB,KACE,OAAO,CAAC,cAAc,CAAC,CAAC;AAE7B,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAAoB;gBAEzB,MAAM,EAAE;QAAE,SAAS,EAAE,iBAAiB,CAAA;KAAE;IAI9C,GAAG,CACP,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QACR,kBAAkB,EAAE,MAAM,CAAC;KAC5B,GACA,OAAO,CACR,OAAO,GAAG;QACR,KAAK,EAAE,CAAC,WAAW,GAAG;YAAE,IAAI,EAAE,uBAAuB,CAAA;SAAE,CAAC,EAAE,CAAC;KAC5D,CACF;IAiCD,OAAO,CAAC,6BAA6B;CAsBtC"}

package/dist/dataset/index.js

@@ -1,43 +0,0 @@
-export class DatasetManager {
-    constructor(params) {
-        this.apiClient = params.apiClient;
-    }
-    async get(name, options) {
-        var _a;
-        const dataset = await this.apiClient.datasets.get(name);
-        const items = [];
-        let page = 1;
-        while (true) {
-            const itemsResponse = await this.apiClient.datasetItems.list({
-                datasetName: name,
-                limit: (_a = options === null || options === void 0 ? void 0 : options.fetchItemsPageSize) !== null && _a !== void 0 ? _a : 50,
-                page,
-            });
-            items.push(...itemsResponse.data);
-            if (itemsResponse.meta.totalPages <= page) {
-                break;
-            }
-            page++;
-        }
-        const returnDataset = {
-            ...dataset,
-            items: items.map((item) => ({
-                ...item,
-                link: this.createDatasetItemLinkFunction(item),
-            })),
-        };
-        return returnDataset;
-    }
-    createDatasetItemLinkFunction(item) {
-        const linkFunction = async (obj, runName, runArgs) => {
-            return await this.apiClient.datasetRunItems.create({
-                runName,
-                datasetItemId: item.id,
-                traceId: obj.otelSpan.spanContext().traceId,
-                runDescription: runArgs === null || runArgs === void 0 ? void 0 : runArgs.description,
-                metadata: runArgs === null || runArgs === void 0 ? void 0 : runArgs.metadata,
-            });
-        };
-        return linkFunction;
-    }
-}

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -1,5 +0,0 @@
-export * from "./LangfuseClient.js";
-export * from "./prompt/index.js";
-export * from "./score/index.js";
-export * from "./dataset/index.js";
-export * from "./media/index.js";

package/dist/media/index.d.ts

@@ -1,65 +0,0 @@
-import { LangfuseAPIClient, ParsedMediaReference } from "@langfuse/core";
-export type LangfuseMediaResolveMediaReferencesParams<T> = {
-    obj: T;
-    resolveWith: "base64DataUri";
-    maxDepth?: number;
-};
-export declare class MediaManager {
-    private apiClient;
-    constructor(params: {
-        apiClient: LangfuseAPIClient;
-    });
-    /**
-     * Replaces the media reference strings in an object with base64 data URIs for the media content.
-     *
-     * This method recursively traverses an object (up to a maximum depth of 10) looking for media reference strings
-     * in the format "@@@langfuseMedia:...@@@". When found, it fetches the actual media content using the provided
-     * Langfuse client and replaces the reference string with a base64 data URI.
-     *
-     * If fetching media content fails for a reference string, a warning is logged and the reference string is left unchanged.
-     *
-     * @param params - Configuration object
-     * @param params.obj - The object to process. Can be a primitive value, array, or nested object
-     * @param params.resolveWith - The representation of the media content to replace the media reference string with. Currently only "base64DataUri" is supported.
-     * @param params.maxDepth - Optional. Default is 10. The maximum depth to traverse the object.
-     *
-     * @returns A deep copy of the input object with all media references replaced with base64 data URIs where possible
-     *
-     * @example
-     * ```typescript
-     * const obj = {
-     *   image: "@@@langfuseMedia:type=image/jpeg|id=123|source=bytes@@@",
-     *   nested: {
-     *     pdf: "@@@langfuseMedia:type=application/pdf|id=456|source=bytes@@@"
-     *   }
-     * };
-     *
-     * const result = await LangfuseMedia.resolveMediaReferences({
-     *   obj,
-     *   langfuseClient
-     * });
-     *
-     * // Result:
-     * // {
-     * //   image: "data:image/jpeg;base64,/9j/4AAQSkZJRg...",
-     * //   nested: {
-     * //     pdf: "data:application/pdf;base64,JVBERi0xLjcK..."
-     * //   }
-     * // }
-     * ```
-     */
-    resolveReferences<T>(params: LangfuseMediaResolveMediaReferencesParams<T>): Promise<T>;
-    /**
-     * Parses a media reference string into a ParsedMediaReference.
-     *
-     * Example reference string:
-     *     "@@@langfuseMedia:type=image/jpeg|id=some-uuid|source=base64DataUri@@@"
-     *
-     * @param referenceString - The reference string to parse.
-     * @returns An object with the mediaId, source, and contentType.
-     *
-     * @throws Error if the reference string is invalid or missing required fields.
-     */
-    static parseReferenceString(referenceString: string): ParsedMediaReference;
-}
-//# sourceMappingURL=index.d.ts.map

package/dist/media/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/media/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EAIrB,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,yCAAyC,CAAC,CAAC,IAAI;IACzD,GAAG,EAAE,CAAC,CAAC;IACP,WAAW,EAAE,eAAe,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAoB;gBAEzB,MAAM,EAAE;QAAE,SAAS,EAAE,iBAAiB,CAAA;KAAE;IAIpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;IACU,iBAAiB,CAAC,CAAC,EAC9B,MAAM,EAAE,yCAAyC,CAAC,CAAC,CAAC,GACnD,OAAO,CAAC,CAAC,CAAC;IA4Fb;;;;;;;;;;OAUG;WACW,oBAAoB,CAChC,eAAe,EAAE,MAAM,GACtB,oBAAoB;CAoCxB"}