observability-toolkit 1.8.5 → 2.1.0

package/dist/lib/exports/export-utils.test.js

@@ -0,0 +1,344 @@
+/**
+ * Tests for export-utils module
+ */
+import { describe, it, beforeEach, afterEach } from 'vitest';
+import assert from 'node:assert';
+import { DD_SPAN_ID_LENGTH, DD_TRACE_ID_LENGTH, OTLP_SPAN_ID_LENGTH, OTLP_TRACE_ID_LENGTH, } from '../core/constants.js';
+import { COUNT_FIFTY, COUNT_FIVE_THOUSAND, COUNT_FOUR, COUNT_HUNDRED, COUNT_SIX, COUNT_TEN, COUNT_THOUSAND, COUNT_TWENTY, TEST_BEARER_TOKEN, } from '../../test-helpers/test-constants.js';
+const DEFAULT_MEMORY_WARNING_MB = COUNT_HUNDRED * COUNT_FOUR;
+const DEFAULT_MEMORY_ABORT_MB = COUNT_HUNDRED * COUNT_SIX;
+const MAX_ERROR_ENTRY_STRESS_EXCESS = COUNT_FIFTY;
+const MAX_ERROR_ENTRY_SMALL_EXCESS = COUNT_TEN;
+const ERROR_TRUNCATION_SUFFIX_MARGIN = COUNT_TWENTY;
+const LARGE_ERROR_BODY_OVERFLOW = COUNT_FIVE_THOUSAND;
+const MEDIUM_ERROR_BODY_OVERFLOW = COUNT_HUNDRED;
+const PREFIX_ERROR_BODY_OVERFLOW = COUNT_THOUSAND;
+describe('export-utils', () => {
+    describe('memory threshold configuration', () => {
+        let originalEnv;
+        beforeEach(() => {
+            originalEnv = { ...process.env };
+        });
+        afterEach(() => {
+            process.env = originalEnv;
+            // Note: ESM modules are cached, so we test default behavior here
+        });
+        it('uses default 400MB for MEMORY_WARNING_THRESHOLD_MB when env not set', async () => {
+            // Fresh import without env var (this tests the default case)
+            const { MEMORY_WARNING_THRESHOLD_MB } = await import('./export-utils.js');
+            // Default is 400 when EXPORT_MEMORY_WARN_MB is not set
+            assert.strictEqual(MEMORY_WARNING_THRESHOLD_MB, DEFAULT_MEMORY_WARNING_MB);
+        });
+        it('uses default 600MB for MEMORY_ABORT_THRESHOLD_MB when env not set', async () => {
+            const { MEMORY_ABORT_THRESHOLD_MB } = await import('./export-utils.js');
+            // Default is 600 when EXPORT_MEMORY_ABORT_MB is not set
+            assert.strictEqual(MEMORY_ABORT_THRESHOLD_MB, DEFAULT_MEMORY_ABORT_MB);
+        });
+        it('checkMemoryUsage returns correct structure', async () => {
+            const { checkMemoryUsage } = await import('./export-utils.js');
+            const status = checkMemoryUsage();
+            assert.ok(typeof status.heapUsedMB === 'number');
+            assert.ok(status.heapUsedMB >= 0);
+            assert.ok(typeof status.shouldWarn === 'boolean');
+            assert.ok(typeof status.shouldAbort === 'boolean');
+        });
+        it('checkMemoryUsage shouldWarn is based on threshold', async () => {
+            const { checkMemoryUsage, MEMORY_WARNING_THRESHOLD_MB } = await import('./export-utils.js');
+            const status = checkMemoryUsage();
+            // shouldWarn should be true if heapUsedMB > threshold
+            assert.strictEqual(status.shouldWarn, status.heapUsedMB > MEMORY_WARNING_THRESHOLD_MB);
+        });
+        it('checkMemoryUsage shouldAbort is based on threshold', async () => {
+            const { checkMemoryUsage, MEMORY_ABORT_THRESHOLD_MB } = await import('./export-utils.js');
+            const status = checkMemoryUsage();
+            // shouldAbort should be true if heapUsedMB > threshold
+            assert.strictEqual(status.shouldAbort, status.heapUsedMB > MEMORY_ABORT_THRESHOLD_MB);
+        });
+    });
+    describe('memory threshold parsing', () => {
+        // Test the parsing logic directly by verifying the module behavior
+        // Note: Due to ESM caching, we can't easily test env var changes at runtime
+        // These tests verify the default behavior and structure
+        it('exports MEMORY_WARNING_THRESHOLD_MB as number', async () => {
+            const { MEMORY_WARNING_THRESHOLD_MB } = await import('./export-utils.js');
+            assert.strictEqual(typeof MEMORY_WARNING_THRESHOLD_MB, 'number');
+            assert.ok(!isNaN(MEMORY_WARNING_THRESHOLD_MB));
+            assert.ok(MEMORY_WARNING_THRESHOLD_MB >= 1);
+        });
+        it('exports MEMORY_ABORT_THRESHOLD_MB as number', async () => {
+            const { MEMORY_ABORT_THRESHOLD_MB } = await import('./export-utils.js');
+            assert.strictEqual(typeof MEMORY_ABORT_THRESHOLD_MB, 'number');
+            assert.ok(!isNaN(MEMORY_ABORT_THRESHOLD_MB));
+            assert.ok(MEMORY_ABORT_THRESHOLD_MB >= 1);
+        });
+        it('abort threshold should be greater than or equal to warn threshold', async () => {
+            const { MEMORY_WARNING_THRESHOLD_MB, MEMORY_ABORT_THRESHOLD_MB } = await import('./export-utils.js');
+            // With defaults: 400 < 600
+            assert.ok(MEMORY_ABORT_THRESHOLD_MB >= MEMORY_WARNING_THRESHOLD_MB, `Abort threshold (${MEMORY_ABORT_THRESHOLD_MB}) should be >= warn threshold (${MEMORY_WARNING_THRESHOLD_MB})`);
+        });
+    });
+    describe('sanitizeErrorText', () => {
+        it('redacts Basic auth headers', async () => {
+            const { sanitizeErrorText } = await import('./export-utils.js');
+            const text = 'Error: Basic dXNlcjpwYXNzd29yZA== invalid';
+            const result = sanitizeErrorText(text);
+            assert.ok(!result.includes('dXNlcjpwYXNzd29yZA=='));
+            assert.ok(result.includes('[REDACTED]'));
+        });
+        it('redacts Bearer tokens', async () => {
+            const { sanitizeErrorText } = await import('./export-utils.js');
+            const text = `Error: Bearer ${TEST_BEARER_TOKEN} invalid`;
+            const result = sanitizeErrorText(text);
+            assert.ok(!result.includes(TEST_BEARER_TOKEN));
+            assert.ok(result.includes('[REDACTED]'));
+        });
+        it('redacts Langfuse pk/sk patterns', async () => {
+            const { sanitizeErrorText } = await import('./export-utils.js');
+            const text = 'Error with pk-lf-abc123:sk-lf-xyz789';
+            const result = sanitizeErrorText(text);
+            assert.ok(!result.includes('pk-lf-abc123:sk-lf-xyz789'));
+            assert.ok(result.includes('[REDACTED]'));
+        });
+        it('redacts Confident AI API keys', async () => {
+            const { sanitizeErrorText } = await import('./export-utils.js');
+            const text = 'Error with key confident_us_abc123xyz456789012345';
+            const result = sanitizeErrorText(text);
+            assert.ok(!result.includes('confident_us_abc123xyz456789012345'));
+            assert.ok(result.includes('[REDACTED]'));
+        });
+        it('redacts DD-API-KEY headers', async () => {
+            const { sanitizeErrorText } = await import('./export-utils.js');
+            const text = 'Header DD-API-KEY: abc123secret456';
+            const result = sanitizeErrorText(text);
+            assert.ok(!result.includes('abc123secret456'));
+            assert.ok(result.includes('[REDACTED]'));
+        });
+    });
+    describe('validateExternalUrl', () => {
+        it('rejects HTTP by default', async () => {
+            const { validateExternalUrl } = await import('./export-utils.js');
+            const result = validateExternalUrl('http://example.com');
+            assert.strictEqual(result, '');
+        });
+        it('accepts HTTPS by default', async () => {
+            const { validateExternalUrl } = await import('./export-utils.js');
+            const result = validateExternalUrl('https://example.com');
+            assert.strictEqual(result, 'https://example.com');
+        });
+        it('allows HTTP when explicitly enabled', async () => {
+            const { validateExternalUrl } = await import('./export-utils.js');
+            const result = validateExternalUrl('http://example.com', { allowHttp: true });
+            assert.strictEqual(result, 'http://example.com');
+        });
+        it('rejects localhost by default', async () => {
+            const { validateExternalUrl } = await import('./export-utils.js');
+            const result = validateExternalUrl('https://localhost:8080');
+            assert.strictEqual(result, '');
+        });
+        it('allows localhost when explicitly enabled', async () => {
+            const { validateExternalUrl } = await import('./export-utils.js');
+            const result = validateExternalUrl('https://localhost:8080', { allowLocalhost: true });
+            assert.strictEqual(result, 'https://localhost:8080');
+        });
+        it('rejects private network ranges', async () => {
+            const { validateExternalUrl } = await import('./export-utils.js');
+            assert.strictEqual(validateExternalUrl('https://192.168.1.1'), '');
+            assert.strictEqual(validateExternalUrl('https://10.0.0.1'), '');
+            assert.strictEqual(validateExternalUrl('https://172.16.0.1'), '');
+        });
+        it('rejects cloud metadata endpoint', async () => {
+            const { validateExternalUrl } = await import('./export-utils.js');
+            const result = validateExternalUrl('https://169.254.169.254');
+            assert.strictEqual(result, '');
+        });
+        it('preserves path for subpath installations', async () => {
+            const { validateExternalUrl } = await import('./export-utils.js');
+            const result = validateExternalUrl('https://example.com/api/v1');
+            assert.strictEqual(result, 'https://example.com/api/v1');
+        });
+        it('strips trailing slash', async () => {
+            const { validateExternalUrl } = await import('./export-utils.js');
+            const result = validateExternalUrl('https://example.com/api/');
+            assert.strictEqual(result, 'https://example.com/api');
+        });
+    });
+    describe('isValidTimestamp', () => {
+        it('accepts timestamp in valid range', async () => {
+            const { isValidTimestamp } = await import('./export-utils.js');
+            const now = Date.now();
+            assert.strictEqual(isValidTimestamp(now), true);
+        });
+        it('rejects timestamp before year 2000', async () => {
+            const { isValidTimestamp } = await import('./export-utils.js');
+            const pre2000 = new Date('1999-12-31T23:59:59Z').getTime();
+            assert.strictEqual(isValidTimestamp(pre2000), false);
+        });
+        it('rejects timestamp after year 3000', async () => {
+            const { isValidTimestamp } = await import('./export-utils.js');
+            const post3000 = new Date('3001-01-01T00:00:00Z').getTime();
+            assert.strictEqual(isValidTimestamp(post3000), false);
+        });
+        it('rejects NaN', async () => {
+            const { isValidTimestamp } = await import('./export-utils.js');
+            assert.strictEqual(isValidTimestamp(NaN), false);
+        });
+    });
+    describe('generateHexId', () => {
+        it('generates hex string of correct length', async () => {
+            const { generateHexId } = await import('./export-utils.js');
+            const id = generateHexId(DD_SPAN_ID_LENGTH);
+            assert.strictEqual(id.length, DD_SPAN_ID_LENGTH);
+            assert.strictEqual(id.length, OTLP_SPAN_ID_LENGTH);
+            assert.ok(/^[0-9a-f]+$/.test(id));
+        });
+        it('generates different IDs on each call', async () => {
+            const { generateHexId } = await import('./export-utils.js');
+            const id1 = generateHexId(DD_TRACE_ID_LENGTH);
+            const id2 = generateHexId(OTLP_TRACE_ID_LENGTH);
+            assert.notStrictEqual(id1, id2);
+        });
+    });
+    describe('isLocalhostAddress', () => {
+        it('identifies localhost', async () => {
+            const { isLocalhostAddress } = await import('./export-utils.js');
+            assert.strictEqual(isLocalhostAddress('localhost'), true);
+        });
+        it('identifies 127.0.0.1', async () => {
+            const { isLocalhostAddress } = await import('./export-utils.js');
+            assert.strictEqual(isLocalhostAddress('127.0.0.1'), true);
+        });
+        it('identifies 127.x.x.x variants', async () => {
+            const { isLocalhostAddress } = await import('./export-utils.js');
+            assert.strictEqual(isLocalhostAddress('127.0.0.2'), true);
+            assert.strictEqual(isLocalhostAddress('127.255.255.255'), true);
+        });
+        it('identifies 0.0.0.0', async () => {
+            const { isLocalhostAddress } = await import('./export-utils.js');
+            assert.strictEqual(isLocalhostAddress('0.0.0.0'), true);
+        });
+        it('identifies IPv6 localhost (::1)', async () => {
+            const { isLocalhostAddress } = await import('./export-utils.js');
+            assert.strictEqual(isLocalhostAddress('::1'), true);
+            assert.strictEqual(isLocalhostAddress('0:0:0:0:0:0:0:1'), true);
+        });
+        it('identifies IPv4-mapped IPv6 localhost', async () => {
+            const { isLocalhostAddress } = await import('./export-utils.js');
+            assert.strictEqual(isLocalhostAddress('::ffff:127.0.0.1'), true);
+        });
+        it('identifies .localhost subdomains', async () => {
+            const { isLocalhostAddress } = await import('./export-utils.js');
+            assert.strictEqual(isLocalhostAddress('app.localhost'), true);
+            assert.strictEqual(isLocalhostAddress('subdomain.localhost'), true);
+        });
+        it('handles bracketed IPv6', async () => {
+            const { isLocalhostAddress } = await import('./export-utils.js');
+            assert.strictEqual(isLocalhostAddress('[::1]'), true);
+        });
+        it('handles IPv6 zone identifiers', async () => {
+            const { isLocalhostAddress } = await import('./export-utils.js');
+            // Zone identifier is stripped before comparison
+            assert.strictEqual(isLocalhostAddress('::1%eth0'), true);
+        });
+        it('rejects external hostnames', async () => {
+            const { isLocalhostAddress } = await import('./export-utils.js');
+            assert.strictEqual(isLocalhostAddress('example.com'), false);
+            assert.strictEqual(isLocalhostAddress('api.langfuse.com'), false);
+        });
+        it('rejects private network addresses', async () => {
+            const { isLocalhostAddress } = await import('./export-utils.js');
+            assert.strictEqual(isLocalhostAddress('192.168.1.1'), false);
+            assert.strictEqual(isLocalhostAddress('10.0.0.1'), false);
+        });
+    });
+    describe('pushCappedError', () => {
+        it('adds errors until MAX_ERROR_ENTRIES', async () => {
+            const { pushCappedError } = await import('./export-utils.js');
+            const { MAX_ERROR_ENTRIES } = await import('../core/constants.js');
+            const errors = [];
+            for (let i = 0; i < MAX_ERROR_ENTRIES + MAX_ERROR_ENTRY_STRESS_EXCESS; i++) {
+                pushCappedError(errors, `Error ${i}`);
+            }
+            // Should have MAX_ERROR_ENTRIES + 1 (truncation message)
+            assert.strictEqual(errors.length, MAX_ERROR_ENTRIES + 1);
+        });
+        it('includes truncation message at cap', async () => {
+            const { pushCappedError } = await import('./export-utils.js');
+            const { MAX_ERROR_ENTRIES } = await import('../core/constants.js');
+            const errors = [];
+            for (let i = 0; i < MAX_ERROR_ENTRIES + MAX_ERROR_ENTRY_SMALL_EXCESS; i++) {
+                pushCappedError(errors, `Error ${i}`);
+            }
+            // Last entry should be truncation message
+            const lastError = errors[errors.length - 1];
+            assert.ok(lastError.includes('truncated'));
+            assert.ok(lastError.includes(String(MAX_ERROR_ENTRIES)));
+        });
+        it('preserves first errors', async () => {
+            const { pushCappedError } = await import('./export-utils.js');
+            const errors = [];
+            pushCappedError(errors, 'First error');
+            pushCappedError(errors, 'Second error');
+            assert.strictEqual(errors[0], 'First error');
+            assert.strictEqual(errors[1], 'Second error');
+        });
+        it('does not add duplicates after truncation message', async () => {
+            const { pushCappedError } = await import('./export-utils.js');
+            const { MAX_ERROR_ENTRIES } = await import('../core/constants.js');
+            const errors = [];
+            // Fill to capacity + add truncation
+            for (let i = 0; i < MAX_ERROR_ENTRIES + 1; i++) {
+                pushCappedError(errors, `Error ${i}`);
+            }
+            const lengthAfterTruncation = errors.length;
+            // Try to add more
+            pushCappedError(errors, 'This should not be added');
+            pushCappedError(errors, 'This also should not be added');
+            assert.strictEqual(errors.length, lengthAfterTruncation);
+        });
+    });
+    describe('truncateErrorBody', () => {
+        it('returns short text unchanged', async () => {
+            const { truncateErrorBody } = await import('./export-utils.js');
+            const text = 'Short error message';
+            const result = truncateErrorBody(text);
+            assert.strictEqual(result, text);
+        });
+        it('truncates text exceeding MAX_ERROR_BODY_SIZE', async () => {
+            const { truncateErrorBody } = await import('./export-utils.js');
+            const { MAX_ERROR_BODY_SIZE } = await import('../core/constants.js');
+            const large = 'x'.repeat(MAX_ERROR_BODY_SIZE + LARGE_ERROR_BODY_OVERFLOW);
+            const result = truncateErrorBody(large);
+            // Should be truncated with indicator
+            assert.ok(result.length <= MAX_ERROR_BODY_SIZE + ERROR_TRUNCATION_SUFFIX_MARGIN); // Allow for truncation suffix
+            assert.ok(result.includes('[truncated]'));
+        });
+        it('includes truncation indicator', async () => {
+            const { truncateErrorBody } = await import('./export-utils.js');
+            const { MAX_ERROR_BODY_SIZE } = await import('../core/constants.js');
+            const large = 'a'.repeat(MAX_ERROR_BODY_SIZE + MEDIUM_ERROR_BODY_OVERFLOW);
+            const result = truncateErrorBody(large);
+            assert.ok(result.endsWith('... [truncated]'));
+        });
+        it('preserves beginning of text', async () => {
+            const { truncateErrorBody } = await import('./export-utils.js');
+            const { MAX_ERROR_BODY_SIZE } = await import('../core/constants.js');
+            const prefix = 'IMPORTANT_PREFIX:';
+            const large = prefix + 'x'.repeat(MAX_ERROR_BODY_SIZE + PREFIX_ERROR_BODY_OVERFLOW);
+            const result = truncateErrorBody(large);
+            assert.ok(result.startsWith(prefix));
+        });
+        it('handles exactly MAX_ERROR_BODY_SIZE length', async () => {
+            const { truncateErrorBody } = await import('./export-utils.js');
+            const { MAX_ERROR_BODY_SIZE } = await import('../core/constants.js');
+            const exact = 'y'.repeat(MAX_ERROR_BODY_SIZE);
+            const result = truncateErrorBody(exact);
+            assert.strictEqual(result, exact); // Should not truncate
+        });
+        it('handles empty string', async () => {
+            const { truncateErrorBody } = await import('./export-utils.js');
+            const result = truncateErrorBody('');
+            assert.strictEqual(result, '');
+        });
+    });
+});
+//# sourceMappingURL=export-utils.test.js.map

package/dist/lib/exports/export-utils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-utils.test.js","sourceRoot":"","sources":["../../../src/lib/exports/export-utils.test.ts"],"names":[],"mappings":"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"}

package/dist/lib/exports/langfuse-export.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Langfuse export functionality for evaluation results
+ *
+ * Exports evaluation results to Langfuse via OTLP HTTP format.
+ * Langfuse accepts OTLP JSON traces where evaluations are attached as span events.
+ */
+import { type OTLPKeyValue, type OTLPSpanEvent } from './otlp-export.js';
+import { type EvaluationResult } from '../../backends/index.js';
+/**
+ * Langfuse configuration for export
+ */
+export interface LangfuseConfig {
+    endpoint: string;
+    publicKey: string;
+    secretKey: string;
+    batchSize: number;
+    timeoutMs: number;
+}
+/**
+ * Result of a Langfuse export operation
+ */
+export interface LangfuseExportResult {
+    success: boolean;
+    evaluationsExported: number;
+    batches: number;
+    failed: number;
+    durationMs: number;
+    errors?: string[];
+}
+/**
+ * OTLP Trace export format (simplified for Langfuse)
+ */
+interface OTLPTraceExport {
+    resourceSpans: Array<{
+        resource: {
+            attributes: OTLPKeyValue[];
+        };
+        scopeSpans: Array<{
+            scope?: {
+                name: string;
+                version?: string;
+            };
+            spans: Array<{
+                traceId: string;
+                spanId: string;
+                name: string;
+                kind: number;
+                startTimeUnixNano: string;
+                endTimeUnixNano: string;
+                status?: {
+                    code: number;
+                };
+                attributes?: OTLPKeyValue[];
+                events?: OTLPSpanEvent[];
+            }>;
+        }>;
+    }>;
+}
+/**
+ * Validate and sanitize a URL to prevent SSRF attacks.
+ * Only allows HTTPS URLs to external hosts.
+ *
+ * Wrapper around validateExternalUrl for Langfuse-specific error messages.
+ */
+export declare function validateLangfuseUrl(url: string): string;
+/**
+ * Validate Langfuse configuration using Zod schema.
+ * Returns validated config or throws an error with validation details.
+ *
+ * @param overrides - Partial config to merge with environment defaults
+ * @returns Validated configuration
+ * @throws Error with Zod validation details if config is invalid
+ */
+export declare function validateLangfuseConfig(overrides?: Partial<LangfuseConfig>): LangfuseConfig;
+/**
+ * Create Basic auth header for Langfuse API.
+ *
+ * Langfuse uses HTTP Basic Authentication with the public key as username
+ * and secret key as password, encoded as base64(publicKey:secretKey).
+ *
+ * @param publicKey - Langfuse public key (e.g., "pk-lf-...")
+ * @param secretKey - Langfuse secret key (e.g., "sk-lf-...")
+ * @returns Authorization header value in format "Basic <base64-credentials>"
+ *
+ * @example
+ * ```typescript
+ * const authHeader = createLangfuseAuthHeader('pk-lf-abc123', 'sk-lf-xyz789');
+ * // Returns: "Basic cGstbGYtYWJjMTIzOnNrLWxmLXh5ejc4OQ=="
+ *
+ * fetch(url, {
+ *   headers: { 'Authorization': authHeader }
+ * });
+ * ```
+ */
+export declare function createLangfuseAuthHeader(publicKey: string, secretKey: string): string;
+/**
+ * Convert evaluations to OTLP trace format for Langfuse export.
+ *
+ * Groups evaluations by traceId and creates one span per trace group,
+ * with each evaluation attached as a span event (gen_ai.evaluation.result).
+ * This format allows Langfuse to correlate evaluations with their parent traces.
+ *
+ * @param evaluations - Array of evaluation results to convert
+ * @returns OTLP trace export structure ready for HTTP POST to /v1/traces
+ *
+ * @example
+ * ```typescript
+ * const evaluations = [
+ *   { traceId: 'abc123', evaluationName: 'accuracy', scoreValue: 0.95 },
+ *   { traceId: 'abc123', evaluationName: 'relevance', scoreValue: 0.88 },
+ * ];
+ * const otlp = evaluationsToOTLPTraces(evaluations);
+ * // Creates 1 span with 2 events (both evaluations share same traceId)
+ * ```
+ *
+ * @remarks
+ * The function name is preserved for backwards compatibility.
+ * Consider `groupEvaluationsIntoOTLPTraces` for future major versions.
+ */
+export declare function evaluationsToOTLPTraces(evaluations: EvaluationResult[]): OTLPTraceExport;
+export { MEMORY_WARNING_THRESHOLD_MB, MEMORY_ABORT_THRESHOLD_MB, PROGRESS_LOG_INTERVAL, EARLIEST_VALID_TIMESTAMP_MS, LATEST_VALID_TIMESTAMP_MS, } from './export-utils.js';
+/**
+ * Export evaluations to Langfuse via OTLP HTTP.
+ * Batches evaluations and sends sequentially to avoid overwhelming the endpoint.
+ *
+ * Security: Re-validates endpoint before each batch to prevent DNS rebinding attacks.
+ */
+export declare function exportToLangfuse(evaluations: EvaluationResult[], config: LangfuseConfig): Promise<LangfuseExportResult>;
+//# sourceMappingURL=langfuse-export.d.ts.map

package/dist/lib/exports/langfuse-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langfuse-export.d.ts","sourceRoot":"","sources":["../../../src/lib/exports/langfuse-export.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,OAAO,EAAoB,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC3F,OAAO,EAA6B,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAkB3F;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,UAAU,eAAe;IACvB,aAAa,EAAE,KAAK,CAAC;QACnB,QAAQ,EAAE;YAAE,UAAU,EAAE,YAAY,EAAE,CAAA;SAAE,CAAC;QACzC,UAAU,EAAE,KAAK,CAAC;YAChB,KAAK,CAAC,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,OAAO,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC;YAC3C,KAAK,EAAE,KAAK,CAAC;gBACX,OAAO,EAAE,MAAM,CAAC;gBAChB,MAAM,EAAE,MAAM,CAAC;gBACf,IAAI,EAAE,MAAM,CAAC;gBACb,IAAI,EAAE,MAAM,CAAC;gBACb,iBAAiB,EAAE,MAAM,CAAC;gBAC1B,eAAe,EAAE,MAAM,CAAC;gBACxB,MAAM,CAAC,EAAE;oBAAE,IAAI,EAAE,MAAM,CAAA;iBAAE,CAAC;gBAC1B,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;gBAC5B,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;aAC1B,CAAC,CAAC;SACJ,CAAC,CAAC;KACJ,CAAC,CAAC;CACJ;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAgB1F;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAIrF;AAGD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,gBAAgB,EAAE,GAAG,eAAe,CAiKxF;AAGD,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,EACzB,qBAAqB,EACrB,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAE3B;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,gBAAgB,EAAE,EAC/B,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,oBAAoB,CAAC,CA0I/B"}