@langfuse/otel 4.0.0-alpha.0

package/dist/index.d.cts

@@ -0,0 +1,75 @@
+import { BatchSpanProcessor, SpanExporter, ReadableSpan, Span } from '@opentelemetry/sdk-trace-base';
+import { MediaContentType } from '@langfuse/core';
+
+type MaskFunction = (params: {
+    data: any;
+}) => any;
+type ShouldExportSpan = (params: {
+    otelSpan: ReadableSpan;
+}) => boolean;
+interface LangfuseSpanProcessorParams {
+    exporter?: SpanExporter;
+    publicKey?: string;
+    secretKey?: string;
+    baseUrl?: string;
+    flushAt?: number;
+    flushInterval?: number;
+    mask?: MaskFunction;
+    shouldExportSpan?: ShouldExportSpan;
+    environment?: string;
+    release?: string;
+    timeout?: number;
+    additionalHeaders?: Record<string, string>;
+}
+declare class LangfuseSpanProcessor extends BatchSpanProcessor {
+    private pendingMediaUploads;
+    private publicKey?;
+    private baseUrl?;
+    private environment?;
+    private release?;
+    private mask?;
+    private shouldExportSpan?;
+    private apiClient;
+    constructor(params: LangfuseSpanProcessorParams);
+    private get logger();
+    onStart(span: Span, parentContext: any): void;
+    onEnd(span: ReadableSpan): void;
+    private flush;
+    forceFlush(): Promise<void>;
+    shutdown(): Promise<void>;
+    private handleMediaInPlace;
+    private applyMaskInPlace;
+    private applyMask;
+    private processMediaItem;
+    private uploadMediaWithBackoff;
+}
+
+type LangfuseMediaParams = {
+    source: "base64_data_uri";
+    base64DataUri: string;
+} | {
+    source: "bytes";
+    contentBytes: Buffer;
+    contentType: MediaContentType;
+};
+/**
+ * A class for wrapping media objects for upload to Langfuse.
+ *
+ * This class handles the preparation and formatting of media content for Langfuse,
+ * supporting both base64 data URIs and raw content bytes.
+ */
+declare class LangfuseMedia {
+    _contentBytes?: Buffer;
+    _contentType?: MediaContentType;
+    _source?: string;
+    constructor(params: LangfuseMediaParams);
+    private parseBase64DataUri;
+    get id(): string | null;
+    get contentLength(): number | undefined;
+    get contentSha256Hash(): string | undefined;
+    get tag(): string | null;
+    get base64DataUri(): string | null;
+    toJSON(): string | null;
+}
+
+export { LangfuseMedia, LangfuseSpanProcessor, type LangfuseSpanProcessorParams };

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { LangfuseSpanProcessor, type LangfuseSpanProcessorParams, } from "./span-processor.js";
+export { LangfuseMedia } from "./media.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,KAAK,2BAA2B,GACjC,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { LangfuseSpanProcessor, } from "./span-processor.js";
+export { LangfuseMedia } from "./media.js";

package/dist/index.mjs

@@ -0,0 +1,465 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/span-processor.ts
+import {
+  getGlobalLogger as getGlobalLogger3,
+  generateUUID,
+  LangfuseAPIClient,
+  LANGFUSE_SDK_VERSION,
+  LangfuseOtelSpanAttributes,
+  getEnv
+} from "@langfuse/core";
+import { hrTimeToMilliseconds } from "@opentelemetry/core";
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
+import {
+  BatchSpanProcessor
+} from "@opentelemetry/sdk-trace-base";
+
+// src/hash.ts
+import { getGlobalLogger, uint8ArrayToBase64 } from "@langfuse/core";
+var cryptoModule;
+var isCryptoAvailable = false;
+var _a;
+try {
+  if (typeof globalThis.Deno !== "undefined") {
+    cryptoModule = __require("crypto");
+    isCryptoAvailable = true;
+  } else if (typeof process !== "undefined" && ((_a = process.versions) == null ? void 0 : _a.node)) {
+    cryptoModule = __require("crypto");
+    isCryptoAvailable = true;
+  } else if (typeof crypto !== "undefined") {
+    cryptoModule = crypto;
+    isCryptoAvailable = true;
+  }
+} catch (error) {
+  getGlobalLogger().warn(
+    "Crypto module not available. Media handling will be disabled.",
+    error
+  );
+  isCryptoAvailable = false;
+}
+function sha256(data) {
+  if (!isCryptoAvailable || !cryptoModule) {
+    throw new Error("Crypto module not available");
+  }
+  return cryptoModule.createHash("sha256").update(data).digest();
+}
+function getSha256HashFromBytes(data) {
+  if (!isCryptoAvailable) {
+    throw new Error("Crypto module not available");
+  }
+  const hash = sha256(data);
+  return uint8ArrayToBase64(hash);
+}
+
+// src/media.ts
+import { getGlobalLogger as getGlobalLogger2 } from "@langfuse/core";
+var LangfuseMedia = class {
+  constructor(params) {
+    const { source } = params;
+    this._source = source;
+    if (source === "base64_data_uri") {
+      const [contentBytesParsed, contentTypeParsed] = this.parseBase64DataUri(
+        params.base64DataUri
+      );
+      this._contentBytes = contentBytesParsed;
+      this._contentType = contentTypeParsed;
+    } else {
+      this._contentBytes = params.contentBytes;
+      this._contentType = params.contentType;
+    }
+  }
+  parseBase64DataUri(data) {
+    try {
+      if (!data || typeof data !== "string") {
+        throw new Error("Data URI is not a string");
+      }
+      if (!data.startsWith("data:")) {
+        throw new Error("Data URI does not start with 'data:'");
+      }
+      const [header, actualData] = data.slice(5).split(",", 2);
+      if (!header || !actualData) {
+        throw new Error("Invalid URI");
+      }
+      const headerParts = header.split(";");
+      if (!headerParts.includes("base64")) {
+        throw new Error("Data is not base64 encoded");
+      }
+      const contentType = headerParts[0];
+      if (!contentType) {
+        throw new Error("Content type is empty");
+      }
+      return [
+        Buffer.from(actualData, "base64"),
+        contentType
+      ];
+    } catch (error) {
+      getGlobalLogger2().error("Error parsing base64 data URI", error);
+      return [void 0, void 0];
+    }
+  }
+  get id() {
+    if (!this.contentSha256Hash) return null;
+    const urlSafeContentHash = this.contentSha256Hash.replaceAll("+", "-").replaceAll("/", "_");
+    return urlSafeContentHash.slice(0, 22);
+  }
+  get contentLength() {
+    var _a2;
+    return (_a2 = this._contentBytes) == null ? void 0 : _a2.length;
+  }
+  get contentSha256Hash() {
+    if (!this._contentBytes || !isCryptoAvailable) {
+      return void 0;
+    }
+    try {
+      return getSha256HashFromBytes(this._contentBytes);
+    } catch (error) {
+      getGlobalLogger2().warn(
+        "[Langfuse] Failed to generate SHA-256 hash for media content:",
+        error
+      );
+      return void 0;
+    }
+  }
+  get tag() {
+    if (!this._contentType || !this._source || !this.id) return null;
+    return `@@@langfuseMedia:type=${this._contentType}|id=${this.id}|source=${this._source}@@@`;
+  }
+  get base64DataUri() {
+    if (!this._contentBytes) return null;
+    return `data:${this._contentType};base64,${Buffer.from(this._contentBytes).toString("base64")}`;
+  }
+  toJSON() {
+    return this.base64DataUri;
+  }
+};
+
+// src/span-processor.ts
+var LangfuseSpanProcessor = class extends BatchSpanProcessor {
+  constructor(params) {
+    var _a2, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l;
+    const logger = getGlobalLogger3();
+    const publicKey = (_a2 = params.publicKey) != null ? _a2 : getEnv("LANGFUSE_PUBLIC_KEY");
+    const secretKey = (_b = params.secretKey) != null ? _b : getEnv("LANGFUSE_SECRET_KEY");
+    const baseUrl = (_e = (_d = (_c = params.baseUrl) != null ? _c : getEnv("LANGFUSE_BASE_URL")) != null ? _d : getEnv("LANGFUSE_BASEURL")) != null ? _e : (
+      // legacy v2
+      "https://cloud.langfuse.com"
+    );
+    if (!params.exporter && !publicKey) {
+      logger.warn(
+        "No exporter configured and no public key provided in constructor or as LANGFUSE_PUBLIC_KEY env var. Span exports will fail."
+      );
+    }
+    if (!params.exporter && !secretKey) {
+      logger.warn(
+        "No exporter configured and no secret key provided in constructor or as LANGFUSE_SECRET_KEY env var. Span exports will fail."
+      );
+    }
+    const flushAt = (_f = params.flushAt) != null ? _f : getEnv("LANGFUSE_FLUSH_AT");
+    const flushIntervalSeconds = (_g = params.flushInterval) != null ? _g : getEnv("LANGFUSE_FLUSH_INTERVAL");
+    const authHeaderValue = Buffer.from(`${publicKey}:${secretKey}`).toString(
+      "base64"
+    );
+    const timeoutSeconds = (_i = params.timeout) != null ? _i : Number((_h = getEnv("LANGFUSE_TIMEOUT")) != null ? _h : 5);
+    const exporter = (_j = params.exporter) != null ? _j : new OTLPTraceExporter({
+      url: `${baseUrl}/api/public/otel/v1/traces`,
+      headers: {
+        Authorization: `Basic ${authHeaderValue}`,
+        x_langfuse_sdk_name: "javascript",
+        x_langfuse_sdk_version: LANGFUSE_SDK_VERSION,
+        x_langfuse_public_key: publicKey != null ? publicKey : "<missing>",
+        ...params.additionalHeaders
+      },
+      timeoutMillis: timeoutSeconds * 1e3
+    });
+    super(exporter, {
+      maxExportBatchSize: flushAt ? Number(flushAt) : void 0,
+      scheduledDelayMillis: flushIntervalSeconds ? Number(flushIntervalSeconds) * 1e3 : void 0
+    });
+    this.pendingMediaUploads = {};
+    this.publicKey = publicKey;
+    this.baseUrl = baseUrl;
+    this.environment = (_k = params.environment) != null ? _k : getEnv("LANGFUSE_TRACING_ENVIRONMENT");
+    this.release = (_l = params.release) != null ? _l : getEnv("LANGFUSE_RELEASE");
+    this.mask = params.mask;
+    this.shouldExportSpan = params.shouldExportSpan;
+    this.apiClient = new LangfuseAPIClient({
+      baseUrl: this.baseUrl,
+      username: this.publicKey,
+      password: secretKey,
+      xLangfusePublicKey: this.publicKey,
+      xLangfuseSdkVersion: LANGFUSE_SDK_VERSION,
+      xLangfuseSdkName: "javascript",
+      environment: "",
+      // noop as baseUrl is set
+      headers: params.additionalHeaders
+    });
+    logger.debug("Initialized LangfuseSpanProcessor with params:", {
+      publicKey,
+      baseUrl,
+      environment: this.environment,
+      release: this.release,
+      timeoutSeconds,
+      flushAt,
+      flushIntervalSeconds
+    });
+    if (!isCryptoAvailable) {
+      logger.warn(
+        "[Langfuse] Crypto module not available in this runtime. Media upload functionality will be disabled. Spans will still be processed normally, but any media content in base64 data URIs will not be uploaded to Langfuse."
+      );
+    }
+  }
+  get logger() {
+    return getGlobalLogger3();
+  }
+  onStart(span, parentContext) {
+    span.setAttributes({
+      [LangfuseOtelSpanAttributes.ENVIRONMENT]: this.environment,
+      [LangfuseOtelSpanAttributes.RELEASE]: this.release
+    });
+    return super.onStart(span, parentContext);
+  }
+  onEnd(span) {
+    var _a2, _b;
+    if (this.shouldExportSpan) {
+      try {
+        if (this.shouldExportSpan({ otelSpan: span }) === false) return;
+      } catch (err) {
+        this.logger.error(
+          "ShouldExportSpan failed with error. Excluding span. Error: ",
+          err
+        );
+        return;
+      }
+    }
+    this.applyMaskInPlace(span);
+    this.handleMediaInPlace(span);
+    this.logger.debug(
+      `Processed span:
+${JSON.stringify(
+        {
+          name: span.name,
+          traceId: span.spanContext().traceId,
+          spanId: span.spanContext().spanId,
+          parentSpanId: (_b = (_a2 = span.parentSpanContext) == null ? void 0 : _a2.spanId) != null ? _b : null,
+          attributes: span.attributes,
+          startTime: new Date(hrTimeToMilliseconds(span.startTime)),
+          endTime: new Date(hrTimeToMilliseconds(span.endTime)),
+          durationMs: hrTimeToMilliseconds(span.duration),
+          kind: span.kind,
+          status: span.status,
+          resource: span.resource.attributes,
+          instrumentationScope: span.instrumentationScope
+        },
+        null,
+        2
+      )}`
+    );
+    super.onEnd(span);
+  }
+  async flush() {
+    await Promise.all(Object.values(this.pendingMediaUploads)).catch((e) => {
+      this.logger.error(
+        e instanceof Error ? e.message : "Unhandled media upload error"
+      );
+    });
+  }
+  async forceFlush() {
+    await this.flush();
+    return super.forceFlush();
+  }
+  async shutdown() {
+    await this.flush();
+    return super.shutdown();
+  }
+  handleMediaInPlace(span) {
+    var _a2;
+    if (!isCryptoAvailable) {
+      this.logger.debug(
+        "[Langfuse] Crypto not available, skipping media processing"
+      );
+      return;
+    }
+    const mediaAttributes = [
+      LangfuseOtelSpanAttributes.OBSERVATION_INPUT,
+      LangfuseOtelSpanAttributes.TRACE_INPUT,
+      LangfuseOtelSpanAttributes.OBSERVATION_OUTPUT,
+      LangfuseOtelSpanAttributes.TRACE_OUTPUT,
+      LangfuseOtelSpanAttributes.OBSERVATION_METADATA,
+      LangfuseOtelSpanAttributes.TRACE_METADATA
+    ];
+    for (const mediaAttribute of mediaAttributes) {
+      const mediaRelevantAttributeKeys = Object.keys(span.attributes).filter(
+        (attributeName) => attributeName.startsWith(mediaAttribute)
+      );
+      for (const key of mediaRelevantAttributeKeys) {
+        const value = span.attributes[key];
+        if (typeof value !== "string") {
+          this.logger.warn(
+            `Span attribute ${mediaAttribute} is not a stringified object. Skipping media handling.`
+          );
+          continue;
+        }
+        let mediaReplacedValue = value;
+        const regex = /data:[^;]+;base64,[A-Za-z0-9+/]+=*/g;
+        const foundMedia = [...new Set((_a2 = value.match(regex)) != null ? _a2 : [])];
+        if (foundMedia.length === 0) continue;
+        for (const mediaDataUri of foundMedia) {
+          const media = new LangfuseMedia({
+            base64DataUri: mediaDataUri,
+            source: "base64_data_uri"
+          });
+          if (!media.tag) {
+            this.logger.warn(
+              "Failed to create Langfuse media tag. Skipping media item."
+            );
+            continue;
+          }
+          const uploadPromise = this.processMediaItem({
+            media,
+            traceId: span.spanContext().traceId,
+            observationId: span.spanContext().spanId,
+            field: mediaAttribute.includes("input") ? "input" : mediaAttribute.includes("output") ? "output" : "metadata"
+            // todo: make more robust
+          });
+          const promiseId = generateUUID();
+          this.pendingMediaUploads[promiseId] = uploadPromise;
+          uploadPromise.finally(() => {
+            delete this.pendingMediaUploads[promiseId];
+          });
+          mediaReplacedValue = mediaReplacedValue.replaceAll(
+            mediaDataUri,
+            media.tag
+          );
+        }
+        span.attributes[key] = mediaReplacedValue;
+      }
+    }
+  }
+  applyMaskInPlace(span) {
+    const maskCandidates = [
+      LangfuseOtelSpanAttributes.OBSERVATION_INPUT,
+      LangfuseOtelSpanAttributes.TRACE_INPUT,
+      LangfuseOtelSpanAttributes.OBSERVATION_OUTPUT,
+      LangfuseOtelSpanAttributes.TRACE_OUTPUT,
+      LangfuseOtelSpanAttributes.OBSERVATION_METADATA,
+      LangfuseOtelSpanAttributes.TRACE_METADATA
+    ];
+    for (const maskCandidate of maskCandidates) {
+      if (maskCandidate in span.attributes) {
+        span.attributes[maskCandidate] = this.applyMask(
+          span.attributes[maskCandidate]
+        );
+      }
+    }
+  }
+  applyMask(data) {
+    if (!this.mask) return data;
+    try {
+      return this.mask({ data });
+    } catch (err) {
+      this.logger.warn(
+        `Applying mask function failed due to error, fully masking property. Error: ${err}`
+      );
+      return "<fully masked due to failed mask function>";
+    }
+  }
+  async processMediaItem({
+    media,
+    traceId,
+    observationId,
+    field
+  }) {
+    try {
+      if (!media.contentLength || !media._contentType || !media.contentSha256Hash || !media._contentBytes) {
+        return;
+      }
+      const { uploadUrl, mediaId } = await this.apiClient.media.getUploadUrl({
+        contentLength: media.contentLength,
+        traceId,
+        observationId,
+        field,
+        contentType: media._contentType,
+        sha256Hash: media.contentSha256Hash
+      });
+      if (!uploadUrl) {
+        this.logger.debug(
+          `Media status: Media with ID ${media.id} already uploaded. Skipping duplicate upload.`
+        );
+        return;
+      }
+      if (media.id !== mediaId) {
+        this.logger.error(
+          `Media integrity error: Media ID mismatch between SDK (${media.id}) and Server (${mediaId}). Upload cancelled. Please check media ID generation logic.`
+        );
+        return;
+      }
+      this.logger.debug(`Uploading media ${mediaId}...`);
+      const startTime = Date.now();
+      const uploadResponse = await this.uploadMediaWithBackoff({
+        uploadUrl,
+        contentBytes: media._contentBytes,
+        contentType: media._contentType,
+        contentSha256Hash: media.contentSha256Hash,
+        maxRetries: 3,
+        baseDelay: 1e3
+      });
+      if (!uploadResponse) {
+        throw Error("Media upload process failed");
+      }
+      await this.apiClient.media.patch(mediaId, {
+        uploadedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        uploadHttpStatus: uploadResponse.status,
+        uploadHttpError: await uploadResponse.text(),
+        uploadTimeMs: Date.now() - startTime
+      });
+      this.logger.debug(`Media upload status reported for ${mediaId}`);
+    } catch (err) {
+      this.logger.error(`Error processing media item: ${err}`);
+    }
+  }
+  async uploadMediaWithBackoff(params) {
+    const {
+      uploadUrl,
+      contentType,
+      contentSha256Hash,
+      contentBytes,
+      maxRetries,
+      baseDelay
+    } = params;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+      try {
+        const uploadResponse = await fetch(uploadUrl, {
+          method: "PUT",
+          body: contentBytes,
+          headers: {
+            "Content-Type": contentType,
+            "x-amz-checksum-sha256": contentSha256Hash,
+            "x-ms-blob-type": "BlockBlob"
+          }
+        });
+        if (attempt < maxRetries && uploadResponse.status !== 200 && uploadResponse.status !== 201) {
+          throw new Error(`Upload failed with status ${uploadResponse.status}`);
+        }
+        return uploadResponse;
+      } catch (e) {
+        if (attempt === maxRetries) {
+          throw e;
+        }
+        const delay = baseDelay * Math.pow(2, attempt);
+        const jitter = Math.random() * 1e3;
+        await new Promise((resolve) => setTimeout(resolve, delay + jitter));
+      }
+    }
+  }
+};
+export {
+  LangfuseMedia,
+  LangfuseSpanProcessor
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/span-processor.ts","../src/hash.ts","../src/media.ts"],"sourcesContent":["import {\n  Logger,\n  getGlobalLogger,\n  generateUUID,\n  LangfuseAPIClient,\n  LANGFUSE_SDK_VERSION,\n  LangfuseOtelSpanAttributes,\n  getEnv,\n} from \"@langfuse/core\";\nimport { hrTimeToMilliseconds } from \"@opentelemetry/core\";\nimport { OTLPTraceExporter } from \"@opentelemetry/exporter-trace-otlp-http\";\nimport {\n  Span,\n  BatchSpanProcessor,\n  SpanExporter,\n  ReadableSpan,\n} from \"@opentelemetry/sdk-trace-base\";\n\nimport { isCryptoAvailable } from \"./hash.js\";\nimport { LangfuseMedia } from \"./media.js\";\n\nexport type MaskFunction = (params: { data: any }) => any;\nexport type ShouldExportSpan = (params: { otelSpan: ReadableSpan }) => boolean;\n\nexport interface LangfuseSpanProcessorParams {\n  exporter?: SpanExporter;\n  publicKey?: string;\n  secretKey?: string;\n  baseUrl?: string;\n  flushAt?: number;\n  flushInterval?: number;\n  mask?: MaskFunction;\n  shouldExportSpan?: ShouldExportSpan;\n  environment?: string;\n  release?: string;\n  timeout?: number;\n  additionalHeaders?: Record<string, string>;\n}\n\nexport class LangfuseSpanProcessor extends BatchSpanProcessor {\n  private pendingMediaUploads: Record<string, Promise<any>> = {};\n\n  private publicKey?: string;\n  private baseUrl?: string;\n  private environment?: string;\n  private release?: string;\n  private mask?: MaskFunction;\n  private shouldExportSpan?: ShouldExportSpan;\n  private apiClient: LangfuseAPIClient;\n\n  constructor(params: LangfuseSpanProcessorParams) {\n    const logger = getGlobalLogger();\n\n    const publicKey = params.publicKey ?? getEnv(\"LANGFUSE_PUBLIC_KEY\");\n    const secretKey = params.secretKey ?? getEnv(\"LANGFUSE_SECRET_KEY\");\n    const baseUrl =\n      params.baseUrl ??\n      getEnv(\"LANGFUSE_BASE_URL\") ??\n      getEnv(\"LANGFUSE_BASEURL\") ?? // legacy v2\n      \"https://cloud.langfuse.com\";\n\n    if (!params.exporter && !publicKey) {\n      logger.warn(\n        \"No exporter configured and no public key provided in constructor or as LANGFUSE_PUBLIC_KEY env var. Span exports will fail.\",\n      );\n    }\n    if (!params.exporter && !secretKey) {\n      logger.warn(\n        \"No exporter configured and no secret key provided in constructor or as LANGFUSE_SECRET_KEY env var. Span exports will fail.\",\n      );\n    }\n    const flushAt = params.flushAt ?? getEnv(\"LANGFUSE_FLUSH_AT\");\n    const flushIntervalSeconds =\n      params.flushInterval ?? getEnv(\"LANGFUSE_FLUSH_INTERVAL\");\n\n    const authHeaderValue = Buffer.from(`${publicKey}:${secretKey}`).toString(\n      \"base64\",\n    );\n    const timeoutSeconds =\n      params.timeout ?? Number(getEnv(\"LANGFUSE_TIMEOUT\") ?? 5);\n\n    const exporter =\n      params.exporter ??\n      new OTLPTraceExporter({\n        url: `${baseUrl}/api/public/otel/v1/traces`,\n        headers: {\n          Authorization: `Basic ${authHeaderValue}`,\n          x_langfuse_sdk_name: \"javascript\",\n          x_langfuse_sdk_version: LANGFUSE_SDK_VERSION,\n          x_langfuse_public_key: publicKey ?? \"<missing>\",\n          ...params.additionalHeaders,\n        },\n        timeoutMillis: timeoutSeconds * 1_000,\n      });\n\n    super(exporter, {\n      maxExportBatchSize: flushAt ? Number(flushAt) : undefined,\n      scheduledDelayMillis: flushIntervalSeconds\n        ? Number(flushIntervalSeconds) * 1_000\n        : undefined,\n    });\n\n    this.publicKey = publicKey;\n    this.baseUrl = baseUrl;\n    this.environment =\n      params.environment ?? getEnv(\"LANGFUSE_TRACING_ENVIRONMENT\");\n    this.release = params.release ?? getEnv(\"LANGFUSE_RELEASE\");\n    this.mask = params.mask;\n    this.shouldExportSpan = params.shouldExportSpan;\n    this.apiClient = new LangfuseAPIClient({\n      baseUrl: this.baseUrl,\n      username: this.publicKey,\n      password: secretKey,\n      xLangfusePublicKey: this.publicKey,\n      xLangfuseSdkVersion: LANGFUSE_SDK_VERSION,\n      xLangfuseSdkName: \"javascript\",\n      environment: \"\", // noop as baseUrl is set\n      headers: params.additionalHeaders,\n    });\n\n    logger.debug(\"Initialized LangfuseSpanProcessor with params:\", {\n      publicKey,\n      baseUrl,\n      environment: this.environment,\n      release: this.release,\n      timeoutSeconds,\n      flushAt,\n      flushIntervalSeconds,\n    });\n\n    // Warn if crypto is not available\n    if (!isCryptoAvailable) {\n      logger.warn(\n        \"[Langfuse] Crypto module not available in this runtime. Media upload functionality will be disabled. \" +\n          \"Spans will still be processed normally, but any media content in base64 data URIs will not be uploaded to Langfuse.\",\n      );\n    }\n  }\n\n  private get logger(): Logger {\n    return getGlobalLogger();\n  }\n\n  public onStart(span: Span, parentContext: any): void {\n    span.setAttributes({\n      [LangfuseOtelSpanAttributes.ENVIRONMENT]: this.environment,\n      [LangfuseOtelSpanAttributes.RELEASE]: this.release,\n    });\n\n    return super.onStart(span, parentContext);\n  }\n\n  public onEnd(span: ReadableSpan): void {\n    if (this.shouldExportSpan) {\n      try {\n        if (this.shouldExportSpan({ otelSpan: span }) === false) return;\n      } catch (err) {\n        this.logger.error(\n          \"ShouldExportSpan failed with error. Excluding span. Error: \",\n          err,\n        );\n\n        return;\n      }\n    }\n\n    this.applyMaskInPlace(span);\n    this.handleMediaInPlace(span);\n\n    this.logger.debug(\n      `Processed span:\\n${JSON.stringify(\n        {\n          name: span.name,\n          traceId: span.spanContext().traceId,\n          spanId: span.spanContext().spanId,\n          parentSpanId: span.parentSpanContext?.spanId ?? null,\n          attributes: span.attributes,\n          startTime: new Date(hrTimeToMilliseconds(span.startTime)),\n          endTime: new Date(hrTimeToMilliseconds(span.endTime)),\n          durationMs: hrTimeToMilliseconds(span.duration),\n          kind: span.kind,\n          status: span.status,\n          resource: span.resource.attributes,\n          instrumentationScope: span.instrumentationScope,\n        },\n        null,\n        2,\n      )}`,\n    );\n\n    super.onEnd(span);\n  }\n\n  private async flush(): Promise<void> {\n    await Promise.all(Object.values(this.pendingMediaUploads)).catch((e) => {\n      this.logger.error(\n        e instanceof Error ? e.message : \"Unhandled media upload error\",\n      );\n    });\n  }\n\n  public async forceFlush(): Promise<void> {\n    await this.flush();\n\n    return super.forceFlush();\n  }\n\n  public async shutdown(): Promise<void> {\n    await this.flush();\n\n    return super.shutdown();\n  }\n\n  private handleMediaInPlace(span: ReadableSpan): void {\n    // Skip media handling if crypto is not available\n    if (!isCryptoAvailable) {\n      this.logger.debug(\n        \"[Langfuse] Crypto not available, skipping media processing\",\n      );\n      return;\n    }\n\n    const mediaAttributes = [\n      LangfuseOtelSpanAttributes.OBSERVATION_INPUT,\n      LangfuseOtelSpanAttributes.TRACE_INPUT,\n      LangfuseOtelSpanAttributes.OBSERVATION_OUTPUT,\n      LangfuseOtelSpanAttributes.TRACE_OUTPUT,\n      LangfuseOtelSpanAttributes.OBSERVATION_METADATA,\n      LangfuseOtelSpanAttributes.TRACE_METADATA,\n    ];\n\n    for (const mediaAttribute of mediaAttributes) {\n      const mediaRelevantAttributeKeys = Object.keys(span.attributes).filter(\n        (attributeName) => attributeName.startsWith(mediaAttribute),\n      );\n\n      for (const key of mediaRelevantAttributeKeys) {\n        const value = span.attributes[key];\n\n        if (typeof value !== \"string\") {\n          this.logger.warn(\n            `Span attribute ${mediaAttribute} is not a stringified object. Skipping media handling.`,\n          );\n\n          continue;\n        }\n\n        // Find media base64 data URI\n        let mediaReplacedValue = value;\n        const regex = /data:[^;]+;base64,[A-Za-z0-9+/]+=*/g;\n        const foundMedia = [...new Set(value.match(regex) ?? [])];\n\n        if (foundMedia.length === 0) continue;\n\n        for (const mediaDataUri of foundMedia) {\n          // For each media, create media tag and initiate upload\n          const media = new LangfuseMedia({\n            base64DataUri: mediaDataUri,\n            source: \"base64_data_uri\",\n          });\n\n          if (!media.tag) {\n            this.logger.warn(\n              \"Failed to create Langfuse media tag. Skipping media item.\",\n            );\n\n            continue;\n          }\n\n          const uploadPromise: Promise<void> = this.processMediaItem({\n            media,\n            traceId: span.spanContext().traceId,\n            observationId: span.spanContext().spanId,\n            field: mediaAttribute.includes(\"input\")\n              ? \"input\"\n              : mediaAttribute.includes(\"output\")\n                ? \"output\"\n                : \"metadata\", // todo: make more robust\n          });\n\n          const promiseId = generateUUID();\n          this.pendingMediaUploads[promiseId] = uploadPromise;\n\n          uploadPromise.finally(() => {\n            delete this.pendingMediaUploads[promiseId];\n          });\n\n          // Replace original attribute with media escaped attribute\n          mediaReplacedValue = mediaReplacedValue.replaceAll(\n            mediaDataUri,\n            media.tag,\n          );\n        }\n\n        span.attributes[key] = mediaReplacedValue;\n      }\n    }\n  }\n\n  private applyMaskInPlace(span: ReadableSpan): void {\n    const maskCandidates = [\n      LangfuseOtelSpanAttributes.OBSERVATION_INPUT,\n      LangfuseOtelSpanAttributes.TRACE_INPUT,\n      LangfuseOtelSpanAttributes.OBSERVATION_OUTPUT,\n      LangfuseOtelSpanAttributes.TRACE_OUTPUT,\n      LangfuseOtelSpanAttributes.OBSERVATION_METADATA,\n      LangfuseOtelSpanAttributes.TRACE_METADATA,\n    ];\n\n    for (const maskCandidate of maskCandidates) {\n      if (maskCandidate in span.attributes) {\n        span.attributes[maskCandidate] = this.applyMask(\n          span.attributes[maskCandidate],\n        );\n      }\n    }\n  }\n\n  private applyMask<T>(data: T): T | string {\n    if (!this.mask) return data;\n\n    try {\n      return this.mask({ data });\n    } catch (err) {\n      this.logger.warn(\n        `Applying mask function failed due to error, fully masking property. Error: ${err}`,\n      );\n\n      return \"<fully masked due to failed mask function>\";\n    }\n  }\n\n  private async processMediaItem({\n    media,\n    traceId,\n    observationId,\n    field,\n  }: {\n    media: LangfuseMedia;\n    traceId: string;\n    observationId?: string;\n    field: string;\n  }): Promise<void> {\n    try {\n      if (\n        !media.contentLength ||\n        !media._contentType ||\n        !media.contentSha256Hash ||\n        !media._contentBytes\n      ) {\n        return;\n      }\n\n      const { uploadUrl, mediaId } = await this.apiClient.media.getUploadUrl({\n        contentLength: media.contentLength,\n        traceId,\n        observationId,\n        field,\n        contentType: media._contentType,\n        sha256Hash: media.contentSha256Hash,\n      });\n\n      if (!uploadUrl) {\n        this.logger.debug(\n          `Media status: Media with ID ${media.id} already uploaded. Skipping duplicate upload.`,\n        );\n\n        return;\n      }\n\n      if (media.id !== mediaId) {\n        this.logger.error(\n          `Media integrity error: Media ID mismatch between SDK (${media.id}) and Server (${mediaId}). Upload cancelled. Please check media ID generation logic.`,\n        );\n\n        return;\n      }\n\n      this.logger.debug(`Uploading media ${mediaId}...`);\n\n      const startTime = Date.now();\n\n      const uploadResponse = await this.uploadMediaWithBackoff({\n        uploadUrl,\n        contentBytes: media._contentBytes,\n        contentType: media._contentType,\n        contentSha256Hash: media.contentSha256Hash,\n        maxRetries: 3,\n        baseDelay: 1000,\n      });\n\n      if (!uploadResponse) {\n        throw Error(\"Media upload process failed\");\n      }\n\n      await this.apiClient.media.patch(mediaId, {\n        uploadedAt: new Date().toISOString(),\n        uploadHttpStatus: uploadResponse.status,\n        uploadHttpError: await uploadResponse.text(),\n        uploadTimeMs: Date.now() - startTime,\n      });\n\n      this.logger.debug(`Media upload status reported for ${mediaId}`);\n    } catch (err) {\n      this.logger.error(`Error processing media item: ${err}`);\n    }\n  }\n\n  private async uploadMediaWithBackoff(params: {\n    uploadUrl: string;\n    contentType: string;\n    contentSha256Hash: string;\n    contentBytes: Buffer;\n    maxRetries: number;\n    baseDelay: number;\n  }) {\n    const {\n      uploadUrl,\n      contentType,\n      contentSha256Hash,\n      contentBytes,\n      maxRetries,\n      baseDelay,\n    } = params;\n\n    for (let attempt = 0; attempt <= maxRetries; attempt++) {\n      try {\n        const uploadResponse = await fetch(uploadUrl, {\n          method: \"PUT\",\n          body: contentBytes,\n          headers: {\n            \"Content-Type\": contentType,\n            \"x-amz-checksum-sha256\": contentSha256Hash,\n            \"x-ms-blob-type\": \"BlockBlob\",\n          },\n        });\n\n        if (\n          attempt < maxRetries &&\n          uploadResponse.status !== 200 &&\n          uploadResponse.status !== 201\n        ) {\n          throw new Error(`Upload failed with status ${uploadResponse.status}`);\n        }\n\n        return uploadResponse;\n      } catch (e) {\n        if (attempt === maxRetries) {\n          throw e;\n        }\n\n        const delay = baseDelay * Math.pow(2, attempt);\n        const jitter = Math.random() * 1000;\n\n        await new Promise((resolve) => setTimeout(resolve, delay + jitter));\n      }\n    }\n  }\n}\n","import { getGlobalLogger, uint8ArrayToBase64 } from \"@langfuse/core\";\n\n// Cross-platform hash utilities with graceful fallbacks\nlet cryptoModule: any;\nlet isCryptoAvailable = false;\n\ntry {\n  if (typeof (globalThis as any).Deno !== \"undefined\") {\n    // Deno\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    cryptoModule = require(\"node:crypto\");\n    isCryptoAvailable = true;\n  } else if (typeof process !== \"undefined\" && process.versions?.node) {\n    // Node\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    cryptoModule = require(\"crypto\");\n    isCryptoAvailable = true;\n  } else if (typeof crypto !== \"undefined\") {\n    // Edge runtime (Cloudflare Workers, Vercel Cloud Function)\n    cryptoModule = crypto;\n    isCryptoAvailable = true;\n  }\n} catch (error) {\n  getGlobalLogger().warn(\n    \"Crypto module not available. Media handling will be disabled.\",\n    error,\n  );\n\n  isCryptoAvailable = false;\n}\n\nexport { isCryptoAvailable };\n\nfunction sha256(data: Uint8Array): Uint8Array {\n  if (!isCryptoAvailable || !cryptoModule) {\n    throw new Error(\"Crypto module not available\");\n  }\n\n  return cryptoModule.createHash(\"sha256\").update(data).digest();\n}\n\nexport function getSha256HashFromBytes(data: Uint8Array): string {\n  if (!isCryptoAvailable) {\n    throw new Error(\"Crypto module not available\");\n  }\n\n  const hash = sha256(data);\n\n  return uint8ArrayToBase64(hash);\n}\n","import { getGlobalLogger, type MediaContentType } from \"@langfuse/core\";\n\nimport { getSha256HashFromBytes, isCryptoAvailable } from \"./hash.js\";\n\nexport type LangfuseMediaParams =\n  | { source: \"base64_data_uri\"; base64DataUri: string }\n  | {\n      source: \"bytes\";\n      contentBytes: Buffer;\n      contentType: MediaContentType;\n    };\n\n/**\n * A class for wrapping media objects for upload to Langfuse.\n *\n * This class handles the preparation and formatting of media content for Langfuse,\n * supporting both base64 data URIs and raw content bytes.\n */\nclass LangfuseMedia {\n  _contentBytes?: Buffer;\n  _contentType?: MediaContentType;\n  _source?: string;\n\n  constructor(params: LangfuseMediaParams) {\n    const { source } = params;\n\n    this._source = source;\n\n    if (source === \"base64_data_uri\") {\n      const [contentBytesParsed, contentTypeParsed] = this.parseBase64DataUri(\n        params.base64DataUri,\n      );\n      this._contentBytes = contentBytesParsed;\n      this._contentType = contentTypeParsed;\n    } else {\n      this._contentBytes = params.contentBytes;\n      this._contentType = params.contentType;\n    }\n  }\n\n  private parseBase64DataUri(\n    data: string,\n  ): [Buffer | undefined, MediaContentType | undefined] {\n    try {\n      if (!data || typeof data !== \"string\") {\n        throw new Error(\"Data URI is not a string\");\n      }\n\n      if (!data.startsWith(\"data:\")) {\n        throw new Error(\"Data URI does not start with 'data:'\");\n      }\n\n      const [header, actualData] = data.slice(5).split(\",\", 2);\n      if (!header || !actualData) {\n        throw new Error(\"Invalid URI\");\n      }\n\n      const headerParts = header.split(\";\");\n      if (!headerParts.includes(\"base64\")) {\n        throw new Error(\"Data is not base64 encoded\");\n      }\n\n      const contentType = headerParts[0];\n      if (!contentType) {\n        throw new Error(\"Content type is empty\");\n      }\n\n      return [\n        Buffer.from(actualData, \"base64\"),\n        contentType as MediaContentType,\n      ];\n    } catch (error) {\n      getGlobalLogger().error(\"Error parsing base64 data URI\", error);\n      return [undefined, undefined];\n    }\n  }\n\n  get id(): string | null {\n    if (!this.contentSha256Hash) return null;\n\n    const urlSafeContentHash = this.contentSha256Hash\n      .replaceAll(\"+\", \"-\")\n      .replaceAll(\"/\", \"_\");\n\n    return urlSafeContentHash.slice(0, 22);\n  }\n\n  get contentLength(): number | undefined {\n    return this._contentBytes?.length;\n  }\n\n  get contentSha256Hash(): string | undefined {\n    if (!this._contentBytes || !isCryptoAvailable) {\n      return undefined;\n    }\n\n    try {\n      return getSha256HashFromBytes(this._contentBytes);\n    } catch (error) {\n      getGlobalLogger().warn(\n        \"[Langfuse] Failed to generate SHA-256 hash for media content:\",\n        error,\n      );\n\n      return undefined;\n    }\n  }\n\n  get tag(): string | null {\n    if (!this._contentType || !this._source || !this.id) return null;\n\n    return `@@@langfuseMedia:type=${this._contentType}|id=${this.id}|source=${this._source}@@@`;\n  }\n\n  get base64DataUri(): string | null {\n    if (!this._contentBytes) return null;\n\n    return `data:${this._contentType};base64,${Buffer.from(this._contentBytes).toString(\"base64\")}`;\n  }\n\n  toJSON(): string | null {\n    return this.base64DataUri;\n  }\n}\n\nexport { LangfuseMedia, type MediaContentType };\n"],"mappings":";;;;;;;;AAAA;AAAA,EAEE,mBAAAA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,4BAA4B;AACrC,SAAS,yBAAyB;AAClC;AAAA,EAEE;AAAA,OAGK;;;AChBP,SAAS,iBAAiB,0BAA0B;AAGpD,IAAI;AACJ,IAAI,oBAAoB;AAJxB;AAMA,IAAI;AACF,MAAI,OAAQ,WAAmB,SAAS,aAAa;AAGnD,mBAAe,UAAQ,QAAa;AACpC,wBAAoB;AAAA,EACtB,WAAW,OAAO,YAAY,iBAAe,aAAQ,aAAR,mBAAkB,OAAM;AAGnE,mBAAe,UAAQ,QAAQ;AAC/B,wBAAoB;AAAA,EACtB,WAAW,OAAO,WAAW,aAAa;AAExC,mBAAe;AACf,wBAAoB;AAAA,EACtB;AACF,SAAS,OAAO;AACd,kBAAgB,EAAE;AAAA,IAChB;AAAA,IACA;AAAA,EACF;AAEA,sBAAoB;AACtB;AAIA,SAAS,OAAO,MAA8B;AAC5C,MAAI,CAAC,qBAAqB,CAAC,cAAc;AACvC,UAAM,IAAI,MAAM,6BAA6B;AAAA,EAC/C;AAEA,SAAO,aAAa,WAAW,QAAQ,EAAE,OAAO,IAAI,EAAE,OAAO;AAC/D;AAEO,SAAS,uBAAuB,MAA0B;AAC/D,MAAI,CAAC,mBAAmB;AACtB,UAAM,IAAI,MAAM,6BAA6B;AAAA,EAC/C;AAEA,QAAM,OAAO,OAAO,IAAI;AAExB,SAAO,mBAAmB,IAAI;AAChC;;;ACjDA,SAAS,mBAAAC,wBAA8C;AAkBvD,IAAM,gBAAN,MAAoB;AAAA,EAKlB,YAAY,QAA6B;AACvC,UAAM,EAAE,OAAO,IAAI;AAEnB,SAAK,UAAU;AAEf,QAAI,WAAW,mBAAmB;AAChC,YAAM,CAAC,oBAAoB,iBAAiB,IAAI,KAAK;AAAA,QACnD,OAAO;AAAA,MACT;AACA,WAAK,gBAAgB;AACrB,WAAK,eAAe;AAAA,IACtB,OAAO;AACL,WAAK,gBAAgB,OAAO;AAC5B,WAAK,eAAe,OAAO;AAAA,IAC7B;AAAA,EACF;AAAA,EAEQ,mBACN,MACoD;AACpD,QAAI;AACF,UAAI,CAAC,QAAQ,OAAO,SAAS,UAAU;AACrC,cAAM,IAAI,MAAM,0BAA0B;AAAA,MAC5C;AAEA,UAAI,CAAC,KAAK,WAAW,OAAO,GAAG;AAC7B,cAAM,IAAI,MAAM,sCAAsC;AAAA,MACxD;AAEA,YAAM,CAAC,QAAQ,UAAU,IAAI,KAAK,MAAM,CAAC,EAAE,MAAM,KAAK,CAAC;AACvD,UAAI,CAAC,UAAU,CAAC,YAAY;AAC1B,cAAM,IAAI,MAAM,aAAa;AAAA,MAC/B;AAEA,YAAM,cAAc,OAAO,MAAM,GAAG;AACpC,UAAI,CAAC,YAAY,SAAS,QAAQ,GAAG;AACnC,cAAM,IAAI,MAAM,4BAA4B;AAAA,MAC9C;AAEA,YAAM,cAAc,YAAY,CAAC;AACjC,UAAI,CAAC,aAAa;AAChB,cAAM,IAAI,MAAM,uBAAuB;AAAA,MACzC;AAEA,aAAO;AAAA,QACL,OAAO,KAAK,YAAY,QAAQ;AAAA,QAChC;AAAA,MACF;AAAA,IACF,SAAS,OAAO;AACd,MAAAC,iBAAgB,EAAE,MAAM,iCAAiC,KAAK;AAC9D,aAAO,CAAC,QAAW,MAAS;AAAA,IAC9B;AAAA,EACF;AAAA,EAEA,IAAI,KAAoB;AACtB,QAAI,CAAC,KAAK,kBAAmB,QAAO;AAEpC,UAAM,qBAAqB,KAAK,kBAC7B,WAAW,KAAK,GAAG,EACnB,WAAW,KAAK,GAAG;AAEtB,WAAO,mBAAmB,MAAM,GAAG,EAAE;AAAA,EACvC;AAAA,EAEA,IAAI,gBAAoC;AAvF1C,QAAAC;AAwFI,YAAOA,MAAA,KAAK,kBAAL,gBAAAA,IAAoB;AAAA,EAC7B;AAAA,EAEA,IAAI,oBAAwC;AAC1C,QAAI,CAAC,KAAK,iBAAiB,CAAC,mBAAmB;AAC7C,aAAO;AAAA,IACT;AAEA,QAAI;AACF,aAAO,uBAAuB,KAAK,aAAa;AAAA,IAClD,SAAS,OAAO;AACd,MAAAD,iBAAgB,EAAE;AAAA,QAChB;AAAA,QACA;AAAA,MACF;AAEA,aAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEA,IAAI,MAAqB;AACvB,QAAI,CAAC,KAAK,gBAAgB,CAAC,KAAK,WAAW,CAAC,KAAK,GAAI,QAAO;AAE5D,WAAO,yBAAyB,KAAK,YAAY,OAAO,KAAK,EAAE,WAAW,KAAK,OAAO;AAAA,EACxF;AAAA,EAEA,IAAI,gBAA+B;AACjC,QAAI,CAAC,KAAK,cAAe,QAAO;AAEhC,WAAO,QAAQ,KAAK,YAAY,WAAW,OAAO,KAAK,KAAK,aAAa,EAAE,SAAS,QAAQ,CAAC;AAAA,EAC/F;AAAA,EAEA,SAAwB;AACtB,WAAO,KAAK;AAAA,EACd;AACF;;;AFpFO,IAAM,wBAAN,cAAoC,mBAAmB;AAAA,EAW5D,YAAY,QAAqC;AAlDnD,QAAAE,KAAA;AAmDI,UAAM,SAASC,iBAAgB;AAE/B,UAAM,aAAYD,MAAA,OAAO,cAAP,OAAAA,MAAoB,OAAO,qBAAqB;AAClE,UAAM,aAAY,YAAO,cAAP,YAAoB,OAAO,qBAAqB;AAClE,UAAM,WACJ,wBAAO,YAAP,YACA,OAAO,mBAAmB,MAD1B,YAEA,OAAO,kBAAkB,MAFzB;AAAA;AAAA,MAGA;AAAA;AAEF,QAAI,CAAC,OAAO,YAAY,CAAC,WAAW;AAClC,aAAO;AAAA,QACL;AAAA,MACF;AAAA,IACF;AACA,QAAI,CAAC,OAAO,YAAY,CAAC,WAAW;AAClC,aAAO;AAAA,QACL;AAAA,MACF;AAAA,IACF;AACA,UAAM,WAAU,YAAO,YAAP,YAAkB,OAAO,mBAAmB;AAC5D,UAAM,wBACJ,YAAO,kBAAP,YAAwB,OAAO,yBAAyB;AAE1D,UAAM,kBAAkB,OAAO,KAAK,GAAG,SAAS,IAAI,SAAS,EAAE,EAAE;AAAA,MAC/D;AAAA,IACF;AACA,UAAM,kBACJ,YAAO,YAAP,YAAkB,QAAO,YAAO,kBAAkB,MAAzB,YAA8B,CAAC;AAE1D,UAAM,YACJ,YAAO,aAAP,YACA,IAAI,kBAAkB;AAAA,MACpB,KAAK,GAAG,OAAO;AAAA,MACf,SAAS;AAAA,QACP,eAAe,SAAS,eAAe;AAAA,QACvC,qBAAqB;AAAA,QACrB,wBAAwB;AAAA,QACxB,uBAAuB,gCAAa;AAAA,QACpC,GAAG,OAAO;AAAA,MACZ;AAAA,MACA,eAAe,iBAAiB;AAAA,IAClC,CAAC;AAEH,UAAM,UAAU;AAAA,MACd,oBAAoB,UAAU,OAAO,OAAO,IAAI;AAAA,MAChD,sBAAsB,uBAClB,OAAO,oBAAoB,IAAI,MAC/B;AAAA,IACN,CAAC;AA5DH,SAAQ,sBAAoD,CAAC;AA8D3D,SAAK,YAAY;AACjB,SAAK,UAAU;AACf,SAAK,eACH,YAAO,gBAAP,YAAsB,OAAO,8BAA8B;AAC7D,SAAK,WAAU,YAAO,YAAP,YAAkB,OAAO,kBAAkB;AAC1D,SAAK,OAAO,OAAO;AACnB,SAAK,mBAAmB,OAAO;AAC/B,SAAK,YAAY,IAAI,kBAAkB;AAAA,MACrC,SAAS,KAAK;AAAA,MACd,UAAU,KAAK;AAAA,MACf,UAAU;AAAA,MACV,oBAAoB,KAAK;AAAA,MACzB,qBAAqB;AAAA,MACrB,kBAAkB;AAAA,MAClB,aAAa;AAAA;AAAA,MACb,SAAS,OAAO;AAAA,IAClB,CAAC;AAED,WAAO,MAAM,kDAAkD;AAAA,MAC7D;AAAA,MACA;AAAA,MACA,aAAa,KAAK;AAAA,MAClB,SAAS,KAAK;AAAA,MACd;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAGD,QAAI,CAAC,mBAAmB;AACtB,aAAO;AAAA,QACL;AAAA,MAEF;AAAA,IACF;AAAA,EACF;AAAA,EAEA,IAAY,SAAiB;AAC3B,WAAOC,iBAAgB;AAAA,EACzB;AAAA,EAEO,QAAQ,MAAY,eAA0B;AACnD,SAAK,cAAc;AAAA,MACjB,CAAC,2BAA2B,WAAW,GAAG,KAAK;AAAA,MAC/C,CAAC,2BAA2B,OAAO,GAAG,KAAK;AAAA,IAC7C,CAAC;AAED,WAAO,MAAM,QAAQ,MAAM,aAAa;AAAA,EAC1C;AAAA,EAEO,MAAM,MAA0B;AAxJzC,QAAAD,KAAA;AAyJI,QAAI,KAAK,kBAAkB;AACzB,UAAI;AACF,YAAI,KAAK,iBAAiB,EAAE,UAAU,KAAK,CAAC,MAAM,MAAO;AAAA,MAC3D,SAAS,KAAK;AACZ,aAAK,OAAO;AAAA,UACV;AAAA,UACA;AAAA,QACF;AAEA;AAAA,MACF;AAAA,IACF;AAEA,SAAK,iBAAiB,IAAI;AAC1B,SAAK,mBAAmB,IAAI;AAE5B,SAAK,OAAO;AAAA,MACV;AAAA,EAAoB,KAAK;AAAA,QACvB;AAAA,UACE,MAAM,KAAK;AAAA,UACX,SAAS,KAAK,YAAY,EAAE;AAAA,UAC5B,QAAQ,KAAK,YAAY,EAAE;AAAA,UAC3B,eAAc,MAAAA,MAAA,KAAK,sBAAL,gBAAAA,IAAwB,WAAxB,YAAkC;AAAA,UAChD,YAAY,KAAK;AAAA,UACjB,WAAW,IAAI,KAAK,qBAAqB,KAAK,SAAS,CAAC;AAAA,UACxD,SAAS,IAAI,KAAK,qBAAqB,KAAK,OAAO,CAAC;AAAA,UACpD,YAAY,qBAAqB,KAAK,QAAQ;AAAA,UAC9C,MAAM,KAAK;AAAA,UACX,QAAQ,KAAK;AAAA,UACb,UAAU,KAAK,SAAS;AAAA,UACxB,sBAAsB,KAAK;AAAA,QAC7B;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC;AAAA,IACH;AAEA,UAAM,MAAM,IAAI;AAAA,EAClB;AAAA,EAEA,MAAc,QAAuB;AACnC,UAAM,QAAQ,IAAI,OAAO,OAAO,KAAK,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM;AACtE,WAAK,OAAO;AAAA,QACV,aAAa,QAAQ,EAAE,UAAU;AAAA,MACnC;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,MAAa,aAA4B;AACvC,UAAM,KAAK,MAAM;AAEjB,WAAO,MAAM,WAAW;AAAA,EAC1B;AAAA,EAEA,MAAa,WAA0B;AACrC,UAAM,KAAK,MAAM;AAEjB,WAAO,MAAM,SAAS;AAAA,EACxB;AAAA,EAEQ,mBAAmB,MAA0B;AArNvD,QAAAA;AAuNI,QAAI,CAAC,mBAAmB;AACtB,WAAK,OAAO;AAAA,QACV;AAAA,MACF;AACA;AAAA,IACF;AAEA,UAAM,kBAAkB;AAAA,MACtB,2BAA2B;AAAA,MAC3B,2BAA2B;AAAA,MAC3B,2BAA2B;AAAA,MAC3B,2BAA2B;AAAA,MAC3B,2BAA2B;AAAA,MAC3B,2BAA2B;AAAA,IAC7B;AAEA,eAAW,kBAAkB,iBAAiB;AAC5C,YAAM,6BAA6B,OAAO,KAAK,KAAK,UAAU,EAAE;AAAA,QAC9D,CAAC,kBAAkB,cAAc,WAAW,cAAc;AAAA,MAC5D;AAEA,iBAAW,OAAO,4BAA4B;AAC5C,cAAM,QAAQ,KAAK,WAAW,GAAG;AAEjC,YAAI,OAAO,UAAU,UAAU;AAC7B,eAAK,OAAO;AAAA,YACV,kBAAkB,cAAc;AAAA,UAClC;AAEA;AAAA,QACF;AAGA,YAAI,qBAAqB;AACzB,cAAM,QAAQ;AACd,cAAM,aAAa,CAAC,GAAG,IAAI,KAAIA,MAAA,MAAM,MAAM,KAAK,MAAjB,OAAAA,MAAsB,CAAC,CAAC,CAAC;AAExD,YAAI,WAAW,WAAW,EAAG;AAE7B,mBAAW,gBAAgB,YAAY;AAErC,gBAAM,QAAQ,IAAI,cAAc;AAAA,YAC9B,eAAe;AAAA,YACf,QAAQ;AAAA,UACV,CAAC;AAED,cAAI,CAAC,MAAM,KAAK;AACd,iBAAK,OAAO;AAAA,cACV;AAAA,YACF;AAEA;AAAA,UACF;AAEA,gBAAM,gBAA+B,KAAK,iBAAiB;AAAA,YACzD;AAAA,YACA,SAAS,KAAK,YAAY,EAAE;AAAA,YAC5B,eAAe,KAAK,YAAY,EAAE;AAAA,YAClC,OAAO,eAAe,SAAS,OAAO,IAClC,UACA,eAAe,SAAS,QAAQ,IAC9B,WACA;AAAA;AAAA,UACR,CAAC;AAED,gBAAM,YAAY,aAAa;AAC/B,eAAK,oBAAoB,SAAS,IAAI;AAEtC,wBAAc,QAAQ,MAAM;AAC1B,mBAAO,KAAK,oBAAoB,SAAS;AAAA,UAC3C,CAAC;AAGD,+BAAqB,mBAAmB;AAAA,YACtC;AAAA,YACA,MAAM;AAAA,UACR;AAAA,QACF;AAEA,aAAK,WAAW,GAAG,IAAI;AAAA,MACzB;AAAA,IACF;AAAA,EACF;AAAA,EAEQ,iBAAiB,MAA0B;AACjD,UAAM,iBAAiB;AAAA,MACrB,2BAA2B;AAAA,MAC3B,2BAA2B;AAAA,MAC3B,2BAA2B;AAAA,MAC3B,2BAA2B;AAAA,MAC3B,2BAA2B;AAAA,MAC3B,2BAA2B;AAAA,IAC7B;AAEA,eAAW,iBAAiB,gBAAgB;AAC1C,UAAI,iBAAiB,KAAK,YAAY;AACpC,aAAK,WAAW,aAAa,IAAI,KAAK;AAAA,UACpC,KAAK,WAAW,aAAa;AAAA,QAC/B;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EAEQ,UAAa,MAAqB;AACxC,QAAI,CAAC,KAAK,KAAM,QAAO;AAEvB,QAAI;AACF,aAAO,KAAK,KAAK,EAAE,KAAK,CAAC;AAAA,IAC3B,SAAS,KAAK;AACZ,WAAK,OAAO;AAAA,QACV,8EAA8E,GAAG;AAAA,MACnF;AAEA,aAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEA,MAAc,iBAAiB;AAAA,IAC7B;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,GAKkB;AAChB,QAAI;AACF,UACE,CAAC,MAAM,iBACP,CAAC,MAAM,gBACP,CAAC,MAAM,qBACP,CAAC,MAAM,eACP;AACA;AAAA,MACF;AAEA,YAAM,EAAE,WAAW,QAAQ,IAAI,MAAM,KAAK,UAAU,MAAM,aAAa;AAAA,QACrE,eAAe,MAAM;AAAA,QACrB;AAAA,QACA;AAAA,QACA;AAAA,QACA,aAAa,MAAM;AAAA,QACnB,YAAY,MAAM;AAAA,MACpB,CAAC;AAED,UAAI,CAAC,WAAW;AACd,aAAK,OAAO;AAAA,UACV,+BAA+B,MAAM,EAAE;AAAA,QACzC;AAEA;AAAA,MACF;AAEA,UAAI,MAAM,OAAO,SAAS;AACxB,aAAK,OAAO;AAAA,UACV,yDAAyD,MAAM,EAAE,iBAAiB,OAAO;AAAA,QAC3F;AAEA;AAAA,MACF;AAEA,WAAK,OAAO,MAAM,mBAAmB,OAAO,KAAK;AAEjD,YAAM,YAAY,KAAK,IAAI;AAE3B,YAAM,iBAAiB,MAAM,KAAK,uBAAuB;AAAA,QACvD;AAAA,QACA,cAAc,MAAM;AAAA,QACpB,aAAa,MAAM;AAAA,QACnB,mBAAmB,MAAM;AAAA,QACzB,YAAY;AAAA,QACZ,WAAW;AAAA,MACb,CAAC;AAED,UAAI,CAAC,gBAAgB;AACnB,cAAM,MAAM,6BAA6B;AAAA,MAC3C;AAEA,YAAM,KAAK,UAAU,MAAM,MAAM,SAAS;AAAA,QACxC,aAAY,oBAAI,KAAK,GAAE,YAAY;AAAA,QACnC,kBAAkB,eAAe;AAAA,QACjC,iBAAiB,MAAM,eAAe,KAAK;AAAA,QAC3C,cAAc,KAAK,IAAI,IAAI;AAAA,MAC7B,CAAC;AAED,WAAK,OAAO,MAAM,oCAAoC,OAAO,EAAE;AAAA,IACjE,SAAS,KAAK;AACZ,WAAK,OAAO,MAAM,gCAAgC,GAAG,EAAE;AAAA,IACzD;AAAA,EACF;AAAA,EAEA,MAAc,uBAAuB,QAOlC;AACD,UAAM;AAAA,MACJ;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,IAAI;AAEJ,aAAS,UAAU,GAAG,WAAW,YAAY,WAAW;AACtD,UAAI;AACF,cAAM,iBAAiB,MAAM,MAAM,WAAW;AAAA,UAC5C,QAAQ;AAAA,UACR,MAAM;AAAA,UACN,SAAS;AAAA,YACP,gBAAgB;AAAA,YAChB,yBAAyB;AAAA,YACzB,kBAAkB;AAAA,UACpB;AAAA,QACF,CAAC;AAED,YACE,UAAU,cACV,eAAe,WAAW,OAC1B,eAAe,WAAW,KAC1B;AACA,gBAAM,IAAI,MAAM,6BAA6B,eAAe,MAAM,EAAE;AAAA,QACtE;AAEA,eAAO;AAAA,MACT,SAAS,GAAG;AACV,YAAI,YAAY,YAAY;AAC1B,gBAAM;AAAA,QACR;AAEA,cAAM,QAAQ,YAAY,KAAK,IAAI,GAAG,OAAO;AAC7C,cAAM,SAAS,KAAK,OAAO,IAAI;AAE/B,cAAM,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,QAAQ,MAAM,CAAC;AAAA,MACpE;AAAA,IACF;AAAA,EACF;AACF;","names":["getGlobalLogger","getGlobalLogger","getGlobalLogger","_a","_a","getGlobalLogger"]}

package/dist/media.d.ts

@@ -0,0 +1,30 @@
+import { type MediaContentType } from "@langfuse/core";
+export type LangfuseMediaParams = {
+    source: "base64_data_uri";
+    base64DataUri: string;
+} | {
+    source: "bytes";
+    contentBytes: Buffer;
+    contentType: MediaContentType;
+};
+/**
+ * A class for wrapping media objects for upload to Langfuse.
+ *
+ * This class handles the preparation and formatting of media content for Langfuse,
+ * supporting both base64 data URIs and raw content bytes.
+ */
+declare class LangfuseMedia {
+    _contentBytes?: Buffer;
+    _contentType?: MediaContentType;
+    _source?: string;
+    constructor(params: LangfuseMediaParams);
+    private parseBase64DataUri;
+    get id(): string | null;
+    get contentLength(): number | undefined;
+    get contentSha256Hash(): string | undefined;
+    get tag(): string | null;
+    get base64DataUri(): string | null;
+    toJSON(): string | null;
+}
+export { LangfuseMedia, type MediaContentType };
+//# sourceMappingURL=media.d.ts.map

package/dist/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../src/media.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAIxE,MAAM,MAAM,mBAAmB,GAC3B;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GACpD;IACE,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,gBAAgB,CAAC;CAC/B,CAAC;AAEN;;;;;GAKG;AACH,cAAM,aAAa;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;gBAEL,MAAM,EAAE,mBAAmB;IAiBvC,OAAO,CAAC,kBAAkB;IAqC1B,IAAI,EAAE,IAAI,MAAM,GAAG,IAAI,CAQtB;IAED,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAEtC;IAED,IAAI,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAe1C;IAED,IAAI,GAAG,IAAI,MAAM,GAAG,IAAI,CAIvB;IAED,IAAI,aAAa,IAAI,MAAM,GAAG,IAAI,CAIjC;IAED,MAAM,IAAI,MAAM,GAAG,IAAI;CAGxB;AAED,OAAO,EAAE,aAAa,EAAE,KAAK,gBAAgB,EAAE,CAAC"}