@langfuse/core 4.0.0-alpha.0

package/dist/api/core/url/join.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"join.d.ts","sourceRoot":"","sources":["../../../../src/api/core/url/join.ts"],"names":[],"mappings":"AAAA,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAqChE"}

package/dist/api/core/url/join.js

@@ -0,0 +1,66 @@
+export function join(base, ...segments) {
+    if (!base) {
+        return "";
+    }
+    if (segments.length === 0) {
+        return base;
+    }
+    if (base.includes("://")) {
+        let url;
+        try {
+            url = new URL(base);
+        }
+        catch {
+            // Fallback to path joining if URL is malformed
+            return joinPath(base, ...segments);
+        }
+        const lastSegment = segments[segments.length - 1];
+        const shouldPreserveTrailingSlash = lastSegment && lastSegment.endsWith("/");
+        for (const segment of segments) {
+            const cleanSegment = trimSlashes(segment);
+            if (cleanSegment) {
+                url.pathname = joinPathSegments(url.pathname, cleanSegment);
+            }
+        }
+        if (shouldPreserveTrailingSlash && !url.pathname.endsWith("/")) {
+            url.pathname += "/";
+        }
+        return url.toString();
+    }
+    return joinPath(base, ...segments);
+}
+function joinPath(base, ...segments) {
+    if (segments.length === 0) {
+        return base;
+    }
+    let result = base;
+    const lastSegment = segments[segments.length - 1];
+    const shouldPreserveTrailingSlash = lastSegment && lastSegment.endsWith("/");
+    for (const segment of segments) {
+        const cleanSegment = trimSlashes(segment);
+        if (cleanSegment) {
+            result = joinPathSegments(result, cleanSegment);
+        }
+    }
+    if (shouldPreserveTrailingSlash && !result.endsWith("/")) {
+        result += "/";
+    }
+    return result;
+}
+function joinPathSegments(left, right) {
+    if (left.endsWith("/")) {
+        return left + right;
+    }
+    return left + "/" + right;
+}
+function trimSlashes(str) {
+    if (!str)
+        return str;
+    let start = 0;
+    let end = str.length;
+    if (str.startsWith("/"))
+        start = 1;
+    if (str.endsWith("/"))
+        end = str.length - 1;
+    return start === 0 && end === str.length ? str : str.slice(start, end);
+}

package/dist/api/core/url/qs.d.ts

@@ -0,0 +1,7 @@
+interface QueryStringOptions {
+    arrayFormat?: "indices" | "repeat";
+    encode?: boolean;
+}
+export declare function toQueryString(obj: unknown, options?: QueryStringOptions): string;
+export {};
+//# sourceMappingURL=qs.d.ts.map

package/dist/api/core/url/qs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qs.d.ts","sourceRoot":"","sources":["../../../../src/api/core/url/qs.ts"],"names":[],"mappings":"AAAA,UAAU,kBAAkB;IAC1B,WAAW,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AA4ED,wBAAgB,aAAa,CAC3B,GAAG,EAAE,OAAO,EACZ,OAAO,CAAC,EAAE,kBAAkB,GAC3B,MAAM,CAUR"}

package/dist/api/core/url/qs.js

@@ -0,0 +1,66 @@
+const defaultQsOptions = {
+    arrayFormat: "indices",
+    encode: true,
+};
+function encodeValue(value, shouldEncode) {
+    if (value === undefined) {
+        return "";
+    }
+    if (value === null) {
+        return "";
+    }
+    const stringValue = String(value);
+    return shouldEncode ? encodeURIComponent(stringValue) : stringValue;
+}
+function stringifyObject(obj, prefix = "", options) {
+    const parts = [];
+    for (const [key, value] of Object.entries(obj)) {
+        const fullKey = prefix ? `${prefix}[${key}]` : key;
+        if (value === undefined) {
+            continue;
+        }
+        if (Array.isArray(value)) {
+            if (value.length === 0) {
+                continue;
+            }
+            for (let i = 0; i < value.length; i++) {
+                const item = value[i];
+                if (item === undefined) {
+                    continue;
+                }
+                if (typeof item === "object" && !Array.isArray(item) && item !== null) {
+                    const arrayKey = options.arrayFormat === "indices" ? `${fullKey}[${i}]` : fullKey;
+                    parts.push(...stringifyObject(item, arrayKey, options));
+                }
+                else {
+                    const arrayKey = options.arrayFormat === "indices" ? `${fullKey}[${i}]` : fullKey;
+                    const encodedKey = options.encode
+                        ? encodeURIComponent(arrayKey)
+                        : arrayKey;
+                    parts.push(`${encodedKey}=${encodeValue(item, options.encode)}`);
+                }
+            }
+        }
+        else if (typeof value === "object" && value !== null) {
+            if (Object.keys(value).length === 0) {
+                continue;
+            }
+            parts.push(...stringifyObject(value, fullKey, options));
+        }
+        else {
+            const encodedKey = options.encode ? encodeURIComponent(fullKey) : fullKey;
+            parts.push(`${encodedKey}=${encodeValue(value, options.encode)}`);
+        }
+    }
+    return parts;
+}
+export function toQueryString(obj, options) {
+    if (obj == null || typeof obj !== "object") {
+        return "";
+    }
+    const parts = stringifyObject(obj, "", {
+        ...defaultQsOptions,
+        ...options,
+    });
+    return parts.join("&");
+}

package/dist/api/errors/LangfuseAPIError.d.ts

@@ -0,0 +1,16 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as core from "../core/index.js";
+export declare class LangfuseAPIError extends Error {
+    readonly statusCode?: number;
+    readonly body?: unknown;
+    readonly rawResponse?: core.RawResponse;
+    constructor({ message, statusCode, body, rawResponse, }: {
+        message?: string;
+        statusCode?: number;
+        body?: unknown;
+        rawResponse?: core.RawResponse;
+    });
+}
+//# sourceMappingURL=LangfuseAPIError.d.ts.map

package/dist/api/errors/LangfuseAPIError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LangfuseAPIError.d.ts","sourceRoot":"","sources":["../../../src/api/errors/LangfuseAPIError.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,IAAI,MAAM,kBAAkB,CAAC;AAGzC,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpC,SAAgB,IAAI,CAAC,EAAE,OAAO,CAAC;IAC/B,SAAgB,WAAW,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC;gBAEnC,EACV,OAAO,EACP,UAAU,EACV,IAAI,EACJ,WAAW,GACZ,EAAE;QACD,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,WAAW,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC;KAChC;CAOF"}

package/dist/api/errors/LangfuseAPIError.js

@@ -0,0 +1,26 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import { toJson } from "../core/json.js";
+export class LangfuseAPIError extends Error {
+    constructor({ message, statusCode, body, rawResponse, }) {
+        super(buildMessage({ message, statusCode, body }));
+        Object.setPrototypeOf(this, LangfuseAPIError.prototype);
+        this.statusCode = statusCode;
+        this.body = body;
+        this.rawResponse = rawResponse;
+    }
+}
+function buildMessage({ message, statusCode, body, }) {
+    let lines = [];
+    if (message != null) {
+        lines.push(message);
+    }
+    if (statusCode != null) {
+        lines.push(`Status code: ${statusCode.toString()}`);
+    }
+    if (body != null) {
+        lines.push(`Body: ${toJson(body, undefined, 2)}`);
+    }
+    return lines.join("\n");
+}

package/dist/api/errors/LangfuseAPITimeoutError.d.ts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export declare class LangfuseAPITimeoutError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=LangfuseAPITimeoutError.d.ts.map

package/dist/api/errors/LangfuseAPITimeoutError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LangfuseAPITimeoutError.d.ts","sourceRoot":"","sources":["../../../src/api/errors/LangfuseAPITimeoutError.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/api/errors/LangfuseAPITimeoutError.js

@@ -0,0 +1,9 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export class LangfuseAPITimeoutError extends Error {
+    constructor(message) {
+        super(message);
+        Object.setPrototypeOf(this, LangfuseAPITimeoutError.prototype);
+    }
+}

package/dist/api/errors/index.d.ts

@@ -0,0 +1,3 @@
+export { LangfuseAPIError } from "./LangfuseAPIError.js";
+export { LangfuseAPITimeoutError } from "./LangfuseAPITimeoutError.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/api/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/api/errors/index.js

@@ -0,0 +1,2 @@
+export { LangfuseAPIError } from "./LangfuseAPIError.js";
+export { LangfuseAPITimeoutError } from "./LangfuseAPITimeoutError.js";

package/dist/api/index.d.ts

@@ -0,0 +1,4 @@
+export * as LangfuseAPI from "./api/index.js";
+export { LangfuseAPIError, LangfuseAPITimeoutError } from "./errors/index.js";
+export { LangfuseAPIClient } from "./Client.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/api/index.js

@@ -0,0 +1,3 @@
+export * as LangfuseAPI from "./api/index.js";
+export { LangfuseAPIError, LangfuseAPITimeoutError } from "./errors/index.js";
+export { LangfuseAPIClient } from "./Client.js";

package/dist/constants.d.ts

@@ -0,0 +1,33 @@
+export declare const LANGFUSE_TRACER_NAME = "langfuse-sdk";
+export declare const LANGFUSE_SDK_VERSION: string;
+export declare const LANGFUSE_SDK_NAME = "javascript";
+export declare enum LangfuseOtelSpanAttributes {
+    TRACE_NAME = "langfuse.trace.name",
+    TRACE_USER_ID = "user.id",
+    TRACE_SESSION_ID = "session.id",
+    TRACE_TAGS = "langfuse.trace.tags",
+    TRACE_PUBLIC = "langfuse.trace.public",
+    TRACE_METADATA = "langfuse.trace.metadata",
+    TRACE_INPUT = "langfuse.trace.input",
+    TRACE_OUTPUT = "langfuse.trace.output",
+    OBSERVATION_TYPE = "langfuse.observation.type",
+    OBSERVATION_METADATA = "langfuse.observation.metadata",
+    OBSERVATION_LEVEL = "langfuse.observation.level",
+    OBSERVATION_STATUS_MESSAGE = "langfuse.observation.status_message",
+    OBSERVATION_INPUT = "langfuse.observation.input",
+    OBSERVATION_OUTPUT = "langfuse.observation.output",
+    OBSERVATION_COMPLETION_START_TIME = "langfuse.observation.completion_start_time",
+    OBSERVATION_MODEL = "langfuse.observation.model.name",
+    OBSERVATION_MODEL_PARAMETERS = "langfuse.observation.model.parameters",
+    OBSERVATION_USAGE_DETAILS = "langfuse.observation.usage_details",
+    OBSERVATION_COST_DETAILS = "langfuse.observation.cost_details",
+    OBSERVATION_PROMPT_NAME = "langfuse.observation.prompt.name",
+    OBSERVATION_PROMPT_VERSION = "langfuse.observation.prompt.version",
+    ENVIRONMENT = "langfuse.environment",
+    RELEASE = "langfuse.release",
+    VERSION = "langfuse.version",
+    AS_ROOT = "langfuse.internal.as_root",
+    TRACE_COMPAT_USER_ID = "langfuse.user.id",
+    TRACE_COMPAT_SESSION_ID = "langfuse.session.id"
+}
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,oBAAoB,iBAAiB,CAAC;AACnD,eAAO,MAAM,oBAAoB,QAAsB,CAAC;AACxD,eAAO,MAAM,iBAAiB,eAAe,CAAC;AAG9C,oBAAY,0BAA0B;IAEpC,UAAU,wBAAwB;IAClC,aAAa,YAAY;IACzB,gBAAgB,eAAe;IAC/B,UAAU,wBAAwB;IAClC,YAAY,0BAA0B;IACtC,cAAc,4BAA4B;IAC1C,WAAW,yBAAyB;IACpC,YAAY,0BAA0B;IAGtC,gBAAgB,8BAA8B;IAC9C,oBAAoB,kCAAkC;IACtD,iBAAiB,+BAA+B;IAChD,0BAA0B,wCAAwC;IAClE,iBAAiB,+BAA+B;IAChD,kBAAkB,gCAAgC;IAGlD,iCAAiC,+CAA+C;IAChF,iBAAiB,oCAAoC;IACrD,4BAA4B,0CAA0C;IACtE,yBAAyB,uCAAuC;IAChE,wBAAwB,sCAAsC;IAC9D,uBAAuB,qCAAqC;IAC5D,0BAA0B,wCAAwC;IAGlE,WAAW,yBAAyB;IACpC,OAAO,qBAAqB;IAC5B,OAAO,qBAAqB;IAG5B,OAAO,8BAA8B;IAIrC,oBAAoB,qBAAqB;IACzC,uBAAuB,wBAAwB;CAChD"}

package/dist/constants.js

@@ -0,0 +1,42 @@
+import packageJson from "../package.json" with { type: "json" };
+export const LANGFUSE_TRACER_NAME = "langfuse-sdk";
+export const LANGFUSE_SDK_VERSION = packageJson.version;
+export const LANGFUSE_SDK_NAME = "javascript";
+// From Langfuse platform: web/src/features/otel/server/attributes.ts
+export var LangfuseOtelSpanAttributes;
+(function (LangfuseOtelSpanAttributes) {
+    // Langfuse-Trace attributes
+    LangfuseOtelSpanAttributes["TRACE_NAME"] = "langfuse.trace.name";
+    LangfuseOtelSpanAttributes["TRACE_USER_ID"] = "user.id";
+    LangfuseOtelSpanAttributes["TRACE_SESSION_ID"] = "session.id";
+    LangfuseOtelSpanAttributes["TRACE_TAGS"] = "langfuse.trace.tags";
+    LangfuseOtelSpanAttributes["TRACE_PUBLIC"] = "langfuse.trace.public";
+    LangfuseOtelSpanAttributes["TRACE_METADATA"] = "langfuse.trace.metadata";
+    LangfuseOtelSpanAttributes["TRACE_INPUT"] = "langfuse.trace.input";
+    LangfuseOtelSpanAttributes["TRACE_OUTPUT"] = "langfuse.trace.output";
+    // Langfuse-observation attributes
+    LangfuseOtelSpanAttributes["OBSERVATION_TYPE"] = "langfuse.observation.type";
+    LangfuseOtelSpanAttributes["OBSERVATION_METADATA"] = "langfuse.observation.metadata";
+    LangfuseOtelSpanAttributes["OBSERVATION_LEVEL"] = "langfuse.observation.level";
+    LangfuseOtelSpanAttributes["OBSERVATION_STATUS_MESSAGE"] = "langfuse.observation.status_message";
+    LangfuseOtelSpanAttributes["OBSERVATION_INPUT"] = "langfuse.observation.input";
+    LangfuseOtelSpanAttributes["OBSERVATION_OUTPUT"] = "langfuse.observation.output";
+    // Langfuse-observation of type Generation attributes
+    LangfuseOtelSpanAttributes["OBSERVATION_COMPLETION_START_TIME"] = "langfuse.observation.completion_start_time";
+    LangfuseOtelSpanAttributes["OBSERVATION_MODEL"] = "langfuse.observation.model.name";
+    LangfuseOtelSpanAttributes["OBSERVATION_MODEL_PARAMETERS"] = "langfuse.observation.model.parameters";
+    LangfuseOtelSpanAttributes["OBSERVATION_USAGE_DETAILS"] = "langfuse.observation.usage_details";
+    LangfuseOtelSpanAttributes["OBSERVATION_COST_DETAILS"] = "langfuse.observation.cost_details";
+    LangfuseOtelSpanAttributes["OBSERVATION_PROMPT_NAME"] = "langfuse.observation.prompt.name";
+    LangfuseOtelSpanAttributes["OBSERVATION_PROMPT_VERSION"] = "langfuse.observation.prompt.version";
+    //   General
+    LangfuseOtelSpanAttributes["ENVIRONMENT"] = "langfuse.environment";
+    LangfuseOtelSpanAttributes["RELEASE"] = "langfuse.release";
+    LangfuseOtelSpanAttributes["VERSION"] = "langfuse.version";
+    // Internal
+    LangfuseOtelSpanAttributes["AS_ROOT"] = "langfuse.internal.as_root";
+    // Compatibility - Map properties that were documented in https://langfuse.com/docs/opentelemetry/get-started#property-mapping,
+    // but have a new assignment
+    LangfuseOtelSpanAttributes["TRACE_COMPAT_USER_ID"] = "langfuse.user.id";
+    LangfuseOtelSpanAttributes["TRACE_COMPAT_SESSION_ID"] = "langfuse.session.id";
+})(LangfuseOtelSpanAttributes || (LangfuseOtelSpanAttributes = {}));