@illuma-ai/observability-node 0.1.0

package/dist/__tests__/client.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Integration tests for the Node.js Observability client.
+ *
+ * Validates environment variable resolution (ILLUMA_* and LANGFUSE_* fallback),
+ * class inheritance from ObservabilityCoreClient, fetchWithRetry implementation,
+ * and process exit handler registration.
+ */
+export {};
+//# sourceMappingURL=client.test.d.ts.map

package/dist/__tests__/client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/client.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/__tests__/client.test.js

@@ -0,0 +1,235 @@
+/**
+ * Integration tests for the Node.js Observability client.
+ *
+ * Validates environment variable resolution (ILLUMA_* and LANGFUSE_* fallback),
+ * class inheritance from ObservabilityCoreClient, fetchWithRetry implementation,
+ * and process exit handler registration.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { Observability } from '../client.js';
+import { ObservabilityCoreClient } from '@illuma-ai/observability-core';
+// ---------------------------------------------------------------------------
+// Environment variable helpers
+// ---------------------------------------------------------------------------
+const ENV_KEYS = [
+    'ILLUMA_PUBLIC_KEY',
+    'ILLUMA_SECRET_KEY',
+    'ILLUMA_BASE_URL',
+    'LANGFUSE_PUBLIC_KEY',
+    'LANGFUSE_SECRET_KEY',
+    'LANGFUSE_BASE_URL',
+];
+/** Save and clear all relevant env vars before each test. */
+function clearEnvVars() {
+    const saved = {};
+    for (const key of ENV_KEYS) {
+        saved[key] = process.env[key];
+        delete process.env[key];
+    }
+    return saved;
+}
+/** Restore previously saved env vars. */
+function restoreEnvVars(saved) {
+    for (const [key, value] of Object.entries(saved)) {
+        if (value === undefined) {
+            delete process.env[key];
+        }
+        else {
+            process.env[key] = value;
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('Observability (Node.js client)', () => {
+    let savedEnv;
+    let processOnSpy;
+    beforeEach(() => {
+        savedEnv = clearEnvVars();
+        // Spy on process.on to verify exit handler registration without side effects
+        processOnSpy = vi.spyOn(process, 'on');
+    });
+    afterEach(() => {
+        restoreEnvVars(savedEnv);
+        processOnSpy.mockRestore();
+    });
+    // -------------------------------------------------------------------------
+    // Env var reading
+    // -------------------------------------------------------------------------
+    describe('environment variable reading', () => {
+        it('should read ILLUMA_PUBLIC_KEY, ILLUMA_SECRET_KEY, ILLUMA_BASE_URL', () => {
+            process.env.ILLUMA_PUBLIC_KEY = 'pk-illuma';
+            process.env.ILLUMA_SECRET_KEY = 'sk-illuma';
+            process.env.ILLUMA_BASE_URL = 'https://observe.illuma.ai';
+            const client = new Observability({ flushInterval: 0 });
+            // Client should have been created without errors
+            expect(client).toBeInstanceOf(Observability);
+            // Verify it produces traces (which proves it read the keys)
+            const trace = client.trace({ name: 'env-test' });
+            expect(trace).toBeDefined();
+        });
+        it('should fall back to LANGFUSE_PUBLIC_KEY when ILLUMA_PUBLIC_KEY is not set', () => {
+            process.env.LANGFUSE_PUBLIC_KEY = 'pk-langfuse';
+            process.env.LANGFUSE_SECRET_KEY = 'sk-langfuse';
+            process.env.LANGFUSE_BASE_URL = 'https://cloud.langfuse.com';
+            const client = new Observability({ flushInterval: 0 });
+            expect(client).toBeInstanceOf(Observability);
+        });
+        it('should prefer ILLUMA_* over LANGFUSE_* when both are set', () => {
+            process.env.ILLUMA_PUBLIC_KEY = 'pk-illuma';
+            process.env.ILLUMA_SECRET_KEY = 'sk-illuma';
+            process.env.ILLUMA_BASE_URL = 'https://observe.illuma.ai';
+            process.env.LANGFUSE_PUBLIC_KEY = 'pk-langfuse';
+            process.env.LANGFUSE_SECRET_KEY = 'sk-langfuse';
+            process.env.LANGFUSE_BASE_URL = 'https://cloud.langfuse.com';
+            // We can't directly inspect which key was used, but the constructor
+            // should succeed and prefer ILLUMA_* (verified by the code path)
+            const client = new Observability({ flushInterval: 0 });
+            expect(client).toBeInstanceOf(Observability);
+        });
+        it('should prefer explicit constructor args over env vars', () => {
+            process.env.ILLUMA_PUBLIC_KEY = 'pk-env';
+            process.env.ILLUMA_SECRET_KEY = 'sk-env';
+            process.env.ILLUMA_BASE_URL = 'https://env.example.com';
+            const client = new Observability({
+                publicKey: 'pk-explicit',
+                secretKey: 'sk-explicit',
+                baseUrl: 'https://explicit.example.com',
+                flushInterval: 0,
+            });
+            expect(client).toBeInstanceOf(Observability);
+        });
+        it('should throw when publicKey is not available from any source', () => {
+            process.env.ILLUMA_SECRET_KEY = 'sk-test';
+            process.env.ILLUMA_BASE_URL = 'https://observe.test';
+            expect(() => new Observability()).toThrow('publicKey is required');
+        });
+        it('should throw when secretKey is not available from any source', () => {
+            process.env.ILLUMA_PUBLIC_KEY = 'pk-test';
+            process.env.ILLUMA_BASE_URL = 'https://observe.test';
+            expect(() => new Observability()).toThrow('secretKey is required');
+        });
+        it('should throw when baseUrl is not available from any source', () => {
+            process.env.ILLUMA_PUBLIC_KEY = 'pk-test';
+            process.env.ILLUMA_SECRET_KEY = 'sk-test';
+            expect(() => new Observability()).toThrow('baseUrl is required');
+        });
+    });
+    // -------------------------------------------------------------------------
+    // Extends core correctly
+    // -------------------------------------------------------------------------
+    describe('class inheritance', () => {
+        it('should extend ObservabilityCoreClient', () => {
+            process.env.ILLUMA_PUBLIC_KEY = 'pk-test';
+            process.env.ILLUMA_SECRET_KEY = 'sk-test';
+            process.env.ILLUMA_BASE_URL = 'https://observe.test';
+            const client = new Observability({ flushInterval: 0 });
+            expect(client).toBeInstanceOf(ObservabilityCoreClient);
+        });
+        it('should expose trace() method from the core client', () => {
+            process.env.ILLUMA_PUBLIC_KEY = 'pk-test';
+            process.env.ILLUMA_SECRET_KEY = 'sk-test';
+            process.env.ILLUMA_BASE_URL = 'https://observe.test';
+            const client = new Observability({ flushInterval: 0 });
+            expect(typeof client.trace).toBe('function');
+            expect(typeof client.flush).toBe('function');
+            expect(typeof client.shutdown).toBe('function');
+            expect(typeof client.score).toBe('function');
+        });
+        it('should support the full trace -> span -> generation chain', () => {
+            process.env.ILLUMA_PUBLIC_KEY = 'pk-test';
+            process.env.ILLUMA_SECRET_KEY = 'sk-test';
+            process.env.ILLUMA_BASE_URL = 'https://observe.test';
+            const client = new Observability({ flushInterval: 0 });
+            const trace = client.trace({ name: 'test-trace' });
+            const span = trace.span({ name: 'test-span' });
+            const gen = span.generation({ name: 'test-gen', model: 'gpt-4o' });
+            gen.end({ output: 'done' });
+            span.end();
+            // All operations should have enqueued events
+            expect(client.getQueue().length).toBeGreaterThan(0);
+        });
+    });
+    // -------------------------------------------------------------------------
+    // fetchWithRetry with mocked fetch
+    // -------------------------------------------------------------------------
+    describe('fetchWithRetry', () => {
+        it('should send events to the server via native fetch', async () => {
+            process.env.ILLUMA_PUBLIC_KEY = 'pk-test';
+            process.env.ILLUMA_SECRET_KEY = 'sk-test';
+            process.env.ILLUMA_BASE_URL = 'https://observe.test';
+            const mockFetch = vi.fn().mockResolvedValue({
+                status: 200,
+                statusText: 'OK',
+                ok: true,
+                json: async () => ({ successes: [], errors: [] }),
+                text: async () => '',
+            });
+            // Replace global fetch for this test
+            const originalFetch = globalThis.fetch;
+            globalThis.fetch = mockFetch;
+            try {
+                const client = new Observability({ flushInterval: 0 });
+                client.trace({ name: 'fetch-test' });
+                await client.flush();
+                expect(mockFetch).toHaveBeenCalledTimes(1);
+                const [url, options] = mockFetch.mock.calls[0];
+                expect(url).toBe('https://observe.test/api/public/ingestion');
+                expect(options.method).toBe('POST');
+                expect(options.headers['Content-Type']).toBe('application/json');
+                expect(options.headers['Authorization']).toMatch(/^Basic /);
+            }
+            finally {
+                globalThis.fetch = originalFetch;
+            }
+        });
+        it('should handle fetch errors gracefully', async () => {
+            process.env.ILLUMA_PUBLIC_KEY = 'pk-test';
+            process.env.ILLUMA_SECRET_KEY = 'sk-test';
+            process.env.ILLUMA_BASE_URL = 'https://observe.test';
+            const mockFetch = vi.fn().mockRejectedValue(new Error('Network error'));
+            const originalFetch = globalThis.fetch;
+            globalThis.fetch = mockFetch;
+            // Suppress error output during test
+            const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+            try {
+                const client = new Observability({
+                    flushInterval: 0,
+                    maxRetries: 0,
+                });
+                client.trace({ name: 'error-test' });
+                await client.flush();
+                // Events should be re-queued after failure
+                expect(client.getQueue().length).toBeGreaterThan(0);
+            }
+            finally {
+                globalThis.fetch = originalFetch;
+                consoleSpy.mockRestore();
+            }
+        });
+    });
+    // -------------------------------------------------------------------------
+    // Process exit handler registration
+    // -------------------------------------------------------------------------
+    describe('process exit handler', () => {
+        it('should register a beforeExit handler on construction', () => {
+            process.env.ILLUMA_PUBLIC_KEY = 'pk-test';
+            process.env.ILLUMA_SECRET_KEY = 'sk-test';
+            process.env.ILLUMA_BASE_URL = 'https://observe.test';
+            new Observability({ flushInterval: 0 });
+            expect(processOnSpy).toHaveBeenCalledWith('beforeExit', expect.any(Function));
+        });
+        it('should only register one exit handler even if multiple instances are created', () => {
+            process.env.ILLUMA_PUBLIC_KEY = 'pk-test';
+            process.env.ILLUMA_SECRET_KEY = 'sk-test';
+            process.env.ILLUMA_BASE_URL = 'https://observe.test';
+            // Each instance registers its own handler (per-instance guard)
+            const client1 = new Observability({ flushInterval: 0 });
+            // Creating the same instance again would still register (separate instance)
+            // But the guard prevents re-registration on the same instance
+            expect(processOnSpy).toHaveBeenCalledWith('beforeExit', expect.any(Function));
+        });
+    });
+});
+//# sourceMappingURL=client.test.js.map

package/dist/__tests__/client.test.js.map

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

package/dist/__tests__/openai.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Integration tests for the observeOpenAI wrapper.
+ *
+ * Validates that the OpenAI client Proxy intercepts chat.completions.create,
+ * records generation events with correct model/usage data, and handles
+ * errors by creating ERROR-level generation events.
+ */
+export {};
+//# sourceMappingURL=openai.test.d.ts.map

package/dist/__tests__/openai.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/openai.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/__tests__/openai.test.js

@@ -0,0 +1,370 @@
+/**
+ * Integration tests for the observeOpenAI wrapper.
+ *
+ * Validates that the OpenAI client Proxy intercepts chat.completions.create,
+ * records generation events with correct model/usage data, and handles
+ * errors by creating ERROR-level generation events.
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { observeOpenAI } from '../openai.js';
+import { Observability } from '../client.js';
+import { ObservationLevel } from '@illuma-ai/observability-core';
+// ---------------------------------------------------------------------------
+// Mock OpenAI client
+// ---------------------------------------------------------------------------
+function createMockOpenAI(overrides = {}) {
+    const defaultChatResponse = {
+        id: 'chatcmpl-abc123',
+        model: 'gpt-4o-2024-08-06',
+        choices: [
+            {
+                message: { role: 'assistant', content: 'Hello! How can I help you?' },
+                finish_reason: 'stop',
+            },
+        ],
+        usage: {
+            prompt_tokens: 10,
+            completion_tokens: 8,
+            total_tokens: 18,
+        },
+    };
+    const defaultCompletionResponse = {
+        id: 'cmpl-xyz789',
+        model: 'gpt-3.5-turbo-instruct',
+        choices: [
+            {
+                text: 'The answer is 42.',
+                finish_reason: 'stop',
+            },
+        ],
+        usage: {
+            prompt_tokens: 5,
+            completion_tokens: 6,
+            total_tokens: 11,
+        },
+    };
+    return {
+        chat: {
+            completions: {
+                create: vi.fn().mockImplementation(async () => {
+                    if (overrides.chatError)
+                        throw overrides.chatError;
+                    return overrides.chatResponse ?? defaultChatResponse;
+                }),
+            },
+        },
+        completions: {
+            create: vi.fn().mockImplementation(async () => {
+                if (overrides.completionError)
+                    throw overrides.completionError;
+                return overrides.completionResponse ?? defaultCompletionResponse;
+            }),
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Mock Observability client (avoid real network + env var requirements)
+// ---------------------------------------------------------------------------
+function createMockObservability() {
+    // Mock global fetch so the Observability constructor's fetchWithRetry works
+    const originalFetch = globalThis.fetch;
+    globalThis.fetch = vi.fn().mockResolvedValue({
+        status: 200,
+        statusText: 'OK',
+        ok: true,
+        json: async () => ({ successes: [], errors: [] }),
+        text: async () => '',
+    });
+    const client = new Observability({
+        publicKey: 'pk-test',
+        secretKey: 'sk-test',
+        baseUrl: 'https://observe.test',
+        flushInterval: 0,
+        flushAt: 1000, // High threshold to prevent auto-flush during tests
+    });
+    // Restore fetch after construction
+    globalThis.fetch = originalFetch;
+    // Expose getQueue with a different name to avoid confusion
+    return Object.assign(client, {
+        _getQueueDirect: () => client.getQueue(),
+    });
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('observeOpenAI', () => {
+    let observability;
+    beforeEach(() => {
+        observability = createMockObservability();
+    });
+    // -------------------------------------------------------------------------
+    // Wrapping
+    // -------------------------------------------------------------------------
+    describe('wrapping', () => {
+        it('should return a proxied client with the same interface', () => {
+            const openai = createMockOpenAI();
+            const wrapped = observeOpenAI(openai, observability);
+            // Should have the same top-level properties
+            expect(wrapped.chat).toBeDefined();
+            expect(wrapped.chat.completions).toBeDefined();
+            expect(typeof wrapped.chat.completions.create).toBe('function');
+            expect(wrapped.completions).toBeDefined();
+            expect(typeof wrapped.completions.create).toBe('function');
+        });
+        it('should preserve non-intercepted properties via proxy pass-through', () => {
+            const openai = createMockOpenAI();
+            openai.models = { list: vi.fn().mockResolvedValue([]) };
+            const wrapped = observeOpenAI(openai, observability);
+            // Non-intercepted properties should pass through
+            expect(wrapped.models).toBeDefined();
+            expect(wrapped.models.list).toBe(openai.models.list);
+        });
+    });
+    // -------------------------------------------------------------------------
+    // chat.completions.create interception
+    // -------------------------------------------------------------------------
+    describe('chat.completions.create interception', () => {
+        it('should call the original create method and return its result', async () => {
+            const openai = createMockOpenAI();
+            const wrapped = observeOpenAI(openai, observability);
+            const result = await wrapped.chat.completions.create({
+                model: 'gpt-4o',
+                messages: [{ role: 'user', content: 'Hello' }],
+            });
+            // Should return the original response
+            expect(result).toMatchObject({
+                id: 'chatcmpl-abc123',
+                choices: expect.any(Array),
+            });
+            // Should have called the original function
+            expect(openai.chat.completions.create).toHaveBeenCalledTimes(1);
+        });
+        it('should create trace and generation events', async () => {
+            const openai = createMockOpenAI();
+            const wrapped = observeOpenAI(openai, observability);
+            await wrapped.chat.completions.create({
+                model: 'gpt-4o',
+                messages: [{ role: 'user', content: 'Hello' }],
+            });
+            const queue = observability._getQueueDirect();
+            // Should have at least a trace-create and generation-create
+            const types = queue.map((e) => e.type);
+            expect(types).toContain('trace-create');
+            expect(types).toContain('generation-create');
+        });
+        it('should record correct model in generation event', async () => {
+            const openai = createMockOpenAI();
+            const wrapped = observeOpenAI(openai, observability);
+            await wrapped.chat.completions.create({
+                model: 'gpt-4o',
+                messages: [{ role: 'user', content: 'Test' }],
+            });
+            const queue = observability._getQueueDirect();
+            const genEvent = queue.find((e) => e.type === 'generation-create');
+            expect(genEvent.body.model).toBe('gpt-4o');
+            expect(genEvent.body.name).toBe('chat.completions.create');
+        });
+        it('should record correct usage in generation event', async () => {
+            const openai = createMockOpenAI();
+            const wrapped = observeOpenAI(openai, observability);
+            await wrapped.chat.completions.create({
+                model: 'gpt-4o',
+                messages: [{ role: 'user', content: 'Test' }],
+            });
+            const queue = observability._getQueueDirect();
+            const genEvent = queue.find((e) => e.type === 'generation-create');
+            expect(genEvent.body.usage).toMatchObject({
+                input: 10,
+                output: 8,
+                total: 18,
+            });
+        });
+        it('should record input messages and output message', async () => {
+            const openai = createMockOpenAI();
+            const wrapped = observeOpenAI(openai, observability);
+            const messages = [{ role: 'user', content: 'What is 2+2?' }];
+            await wrapped.chat.completions.create({
+                model: 'gpt-4o',
+                messages,
+            });
+            const queue = observability._getQueueDirect();
+            const genEvent = queue.find((e) => e.type === 'generation-create');
+            expect(genEvent.body.input).toEqual(messages);
+            expect(genEvent.body.output).toMatchObject({
+                role: 'assistant',
+                content: 'Hello! How can I help you?',
+            });
+        });
+        it('should extract model parameters (temperature, max_tokens)', async () => {
+            const openai = createMockOpenAI();
+            const wrapped = observeOpenAI(openai, observability);
+            await wrapped.chat.completions.create({
+                model: 'gpt-4o',
+                messages: [{ role: 'user', content: 'Test' }],
+                temperature: 0.5,
+                max_tokens: 200,
+                top_p: 0.9,
+            });
+            const queue = observability._getQueueDirect();
+            const genEvent = queue.find((e) => e.type === 'generation-create');
+            expect(genEvent.body.modelParameters).toMatchObject({
+                temperature: 0.5,
+                max_tokens: 200,
+                top_p: 0.9,
+            });
+        });
+        it('should record OpenAI response ID and finish_reason in metadata', async () => {
+            const openai = createMockOpenAI();
+            const wrapped = observeOpenAI(openai, observability);
+            await wrapped.chat.completions.create({
+                model: 'gpt-4o',
+                messages: [{ role: 'user', content: 'Test' }],
+            });
+            const queue = observability._getQueueDirect();
+            const genEvent = queue.find((e) => e.type === 'generation-create');
+            expect(genEvent.body.metadata).toMatchObject({
+                openai_id: 'chatcmpl-abc123',
+                finish_reason: 'stop',
+            });
+        });
+        it('should set startTime and endTime on the generation', async () => {
+            const openai = createMockOpenAI();
+            const wrapped = observeOpenAI(openai, observability);
+            await wrapped.chat.completions.create({
+                model: 'gpt-4o',
+                messages: [{ role: 'user', content: 'Test' }],
+            });
+            const queue = observability._getQueueDirect();
+            const genEvent = queue.find((e) => e.type === 'generation-create');
+            expect(genEvent.body.startTime).toBeDefined();
+            expect(genEvent.body.endTime).toBeDefined();
+        });
+    });
+    // -------------------------------------------------------------------------
+    // Options: traceName, userId, sessionId
+    // -------------------------------------------------------------------------
+    describe('options', () => {
+        it('should use custom traceName', async () => {
+            const openai = createMockOpenAI();
+            const wrapped = observeOpenAI(openai, observability, {
+                traceName: 'my-custom-trace',
+            });
+            await wrapped.chat.completions.create({
+                model: 'gpt-4o',
+                messages: [{ role: 'user', content: 'Test' }],
+            });
+            const queue = observability._getQueueDirect();
+            const traceEvent = queue.find((e) => e.type === 'trace-create');
+            expect(traceEvent.body.name).toBe('my-custom-trace');
+        });
+        it('should attach userId and sessionId to the trace', async () => {
+            const openai = createMockOpenAI();
+            const wrapped = observeOpenAI(openai, observability, {
+                userId: 'user-42',
+                sessionId: 'session-abc',
+            });
+            await wrapped.chat.completions.create({
+                model: 'gpt-4o',
+                messages: [{ role: 'user', content: 'Test' }],
+            });
+            const queue = observability._getQueueDirect();
+            const traceEvent = queue.find((e) => e.type === 'trace-create');
+            expect(traceEvent.body.userId).toBe('user-42');
+            expect(traceEvent.body.sessionId).toBe('session-abc');
+        });
+        it('should merge generationMetadata into generation metadata', async () => {
+            const openai = createMockOpenAI();
+            const wrapped = observeOpenAI(openai, observability, {
+                generationMetadata: { env: 'test', feature: 'chat' },
+            });
+            await wrapped.chat.completions.create({
+                model: 'gpt-4o',
+                messages: [{ role: 'user', content: 'Test' }],
+            });
+            const queue = observability._getQueueDirect();
+            const genEvent = queue.find((e) => e.type === 'generation-create');
+            const metadata = genEvent.body.metadata;
+            expect(metadata.env).toBe('test');
+            expect(metadata.feature).toBe('chat');
+        });
+    });
+    // -------------------------------------------------------------------------
+    // Error handling
+    // -------------------------------------------------------------------------
+    describe('error handling', () => {
+        it('should create an ERROR-level generation when OpenAI throws', async () => {
+            const apiError = new Error('Rate limit exceeded');
+            const openai = createMockOpenAI({ chatError: apiError });
+            const wrapped = observeOpenAI(openai, observability);
+            await expect(wrapped.chat.completions.create({
+                model: 'gpt-4o',
+                messages: [{ role: 'user', content: 'Test' }],
+            })).rejects.toThrow('Rate limit exceeded');
+            const queue = observability._getQueueDirect();
+            const genEvent = queue.find((e) => e.type === 'generation-create');
+            expect(genEvent.body.level).toBe(ObservationLevel.ERROR);
+            expect(genEvent.body.statusMessage).toBe('Rate limit exceeded');
+            expect(genEvent.body.model).toBe('gpt-4o');
+        });
+        it('should still re-throw the original error', async () => {
+            const apiError = new Error('API key invalid');
+            const openai = createMockOpenAI({ chatError: apiError });
+            const wrapped = observeOpenAI(openai, observability);
+            await expect(wrapped.chat.completions.create({
+                model: 'gpt-4o',
+                messages: [{ role: 'user', content: 'Test' }],
+            })).rejects.toThrow('API key invalid');
+        });
+        it('should record the error generation with startTime and endTime', async () => {
+            const apiError = new Error('Timeout');
+            const openai = createMockOpenAI({ chatError: apiError });
+            const wrapped = observeOpenAI(openai, observability);
+            await expect(wrapped.chat.completions.create({
+                model: 'gpt-4o',
+                messages: [{ role: 'user', content: 'Test' }],
+            })).rejects.toThrow();
+            const queue = observability._getQueueDirect();
+            const genEvent = queue.find((e) => e.type === 'generation-create');
+            expect(genEvent.body.startTime).toBeDefined();
+            expect(genEvent.body.endTime).toBeDefined();
+        });
+        it('should handle non-Error thrown values', async () => {
+            const openai = createMockOpenAI();
+            // Override to throw a string
+            openai.chat.completions.create = vi.fn().mockRejectedValue('string error');
+            const wrapped = observeOpenAI(openai, observability);
+            await expect(wrapped.chat.completions.create({
+                model: 'gpt-4o',
+                messages: [{ role: 'user', content: 'Test' }],
+            })).rejects.toBe('string error');
+            const queue = observability._getQueueDirect();
+            const genEvent = queue.find((e) => e.type === 'generation-create');
+            expect(genEvent.body.level).toBe(ObservationLevel.ERROR);
+            expect(genEvent.body.statusMessage).toBe('string error');
+        });
+    });
+    // -------------------------------------------------------------------------
+    // completions.create (legacy)
+    // -------------------------------------------------------------------------
+    describe('completions.create (legacy)', () => {
+        it('should intercept legacy completions.create calls', async () => {
+            const openai = createMockOpenAI();
+            const wrapped = observeOpenAI(openai, observability);
+            const result = await wrapped.completions.create({
+                model: 'gpt-3.5-turbo-instruct',
+                prompt: 'Say hello',
+            });
+            expect(result).toMatchObject({ id: 'cmpl-xyz789' });
+            const queue = observability._getQueueDirect();
+            const genEvent = queue.find((e) => e.type === 'generation-create');
+            expect(genEvent.body.name).toBe('completions.create');
+            expect(genEvent.body.model).toBe('gpt-3.5-turbo-instruct');
+            expect(genEvent.body.usage).toMatchObject({
+                input: 5,
+                output: 6,
+                total: 11,
+            });
+        });
+    });
+});
+//# sourceMappingURL=openai.test.js.map

package/dist/__tests__/openai.test.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,74 @@
+import { ObservabilityCoreClient, type FetchOptions, type FetchResponse } from '@illuma-ai/observability-core';
+/**
+ * Options for the Node.js Observability client.
+ * All fields are optional — values are read from environment variables when omitted.
+ *
+ * Env var resolution order (first match wins):
+ *  - `ILLUMA_PUBLIC_KEY` / `LANGFUSE_PUBLIC_KEY`
+ *  - `ILLUMA_SECRET_KEY` / `LANGFUSE_SECRET_KEY`
+ *  - `ILLUMA_BASE_URL`  / `LANGFUSE_BASE_URL`
+ */
+export interface ObservabilityOptions {
+    /** Public API key. Falls back to ILLUMA_PUBLIC_KEY or LANGFUSE_PUBLIC_KEY env var. */
+    publicKey?: string;
+    /** Secret API key. Falls back to ILLUMA_SECRET_KEY or LANGFUSE_SECRET_KEY env var. */
+    secretKey?: string;
+    /** Base URL of the Illuma Observe instance. Falls back to ILLUMA_BASE_URL or LANGFUSE_BASE_URL env var. */
+    baseUrl?: string;
+    /** Number of events to batch before auto-flushing (default: 15) */
+    flushAt?: number;
+    /** Interval in ms between auto-flushes (default: 5000) */
+    flushInterval?: number;
+    /** Max retries for failed ingestion requests (default: 3) */
+    maxRetries?: number;
+}
+/**
+ * Node.js SDK client for Illuma Observability.
+ *
+ * Extends the core client with:
+ * - **Environment variable auto-detection** for credentials and base URL
+ *   (compatible with both `ILLUMA_*` and `LANGFUSE_*` env vars for drop-in migration)
+ * - **Native Node.js `fetch`** (Node 18+)
+ * - **Process exit handler** that auto-flushes pending events before shutdown
+ *
+ * @example
+ * ```ts
+ * // Reads ILLUMA_PUBLIC_KEY, ILLUMA_SECRET_KEY, ILLUMA_BASE_URL from env
+ * const observability = new Observability();
+ *
+ * const trace = observability.trace({ name: 'my-chain' });
+ * trace.generation({ model: 'gpt-4o', input: 'Hello', output: 'Hi!' });
+ *
+ * await observability.shutdown();
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Explicit configuration (overrides env vars)
+ * const observability = new Observability({
+ *   publicKey: 'pk-...',
+ *   secretKey: 'sk-...',
+ *   baseUrl: 'https://observe.illuma.ai',
+ * });
+ * ```
+ */
+export declare class Observability extends ObservabilityCoreClient {
+    private exitHandlerRegistered;
+    constructor(options?: ObservabilityOptions);
+    /**
+     * Send an HTTP request using native Node.js fetch.
+     * Implements the abstract method from ObservabilityCoreClient.
+     * Retry logic is handled by the core client.
+     *
+     * @param url - The full endpoint URL
+     * @param options - Fetch options (method, headers, body, signal)
+     * @returns Simplified response object
+     */
+    protected fetchWithRetry(url: string, options: FetchOptions): Promise<FetchResponse>;
+    /**
+     * Register a handler that flushes pending events when the Node.js process exits.
+     * Uses `beforeExit` so the event loop can wait for the async flush to complete.
+     */
+    private registerExitHandler;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EAEvB,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,+BAA+B,CAAC;AAKvC;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB;IACnC,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2GAA2G;IAC3G,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,aAAc,SAAQ,uBAAuB;IACxD,OAAO,CAAC,qBAAqB,CAAS;gBAE1B,OAAO,GAAE,oBAAyB;IAkD9C;;;;;;;;OAQG;cACa,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,aAAa,CAAC;IAiBzB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;CAW5B"}

package/dist/client.js

@@ -0,0 +1,108 @@
+import { ObservabilityCoreClient, } from '@illuma-ai/observability-core';
+const SDK_NAME = '@illuma-ai/observability-node';
+const SDK_VERSION = '0.1.0';
+/**
+ * Node.js SDK client for Illuma Observability.
+ *
+ * Extends the core client with:
+ * - **Environment variable auto-detection** for credentials and base URL
+ *   (compatible with both `ILLUMA_*` and `LANGFUSE_*` env vars for drop-in migration)
+ * - **Native Node.js `fetch`** (Node 18+)
+ * - **Process exit handler** that auto-flushes pending events before shutdown
+ *
+ * @example
+ * ```ts
+ * // Reads ILLUMA_PUBLIC_KEY, ILLUMA_SECRET_KEY, ILLUMA_BASE_URL from env
+ * const observability = new Observability();
+ *
+ * const trace = observability.trace({ name: 'my-chain' });
+ * trace.generation({ model: 'gpt-4o', input: 'Hello', output: 'Hi!' });
+ *
+ * await observability.shutdown();
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Explicit configuration (overrides env vars)
+ * const observability = new Observability({
+ *   publicKey: 'pk-...',
+ *   secretKey: 'sk-...',
+ *   baseUrl: 'https://observe.illuma.ai',
+ * });
+ * ```
+ */
+export class Observability extends ObservabilityCoreClient {
+    exitHandlerRegistered = false;
+    constructor(options = {}) {
+        const publicKey = options.publicKey ??
+            process.env.ILLUMA_PUBLIC_KEY ??
+            process.env.LANGFUSE_PUBLIC_KEY;
+        const secretKey = options.secretKey ??
+            process.env.ILLUMA_SECRET_KEY ??
+            process.env.LANGFUSE_SECRET_KEY;
+        const baseUrl = options.baseUrl ??
+            process.env.ILLUMA_BASE_URL ??
+            process.env.LANGFUSE_BASE_URL;
+        if (!publicKey) {
+            throw new Error('[observability-node] publicKey is required. ' +
+                'Pass it in the constructor or set ILLUMA_PUBLIC_KEY / LANGFUSE_PUBLIC_KEY env var.');
+        }
+        if (!secretKey) {
+            throw new Error('[observability-node] secretKey is required. ' +
+                'Pass it in the constructor or set ILLUMA_SECRET_KEY / LANGFUSE_SECRET_KEY env var.');
+        }
+        if (!baseUrl) {
+            throw new Error('[observability-node] baseUrl is required. ' +
+                'Pass it in the constructor or set ILLUMA_BASE_URL / LANGFUSE_BASE_URL env var.');
+        }
+        const coreConfig = {
+            publicKey,
+            secretKey,
+            baseUrl,
+            flushAt: options.flushAt,
+            flushInterval: options.flushInterval,
+            maxRetries: options.maxRetries,
+        };
+        super(coreConfig);
+        // Register process exit handler to auto-flush pending events
+        this.registerExitHandler();
+    }
+    /**
+     * Send an HTTP request using native Node.js fetch.
+     * Implements the abstract method from ObservabilityCoreClient.
+     * Retry logic is handled by the core client.
+     *
+     * @param url - The full endpoint URL
+     * @param options - Fetch options (method, headers, body, signal)
+     * @returns Simplified response object
+     */
+    async fetchWithRetry(url, options) {
+        const response = await fetch(url, {
+            method: options.method,
+            headers: options.headers,
+            body: options.body,
+            signal: options.signal,
+        });
+        return {
+            status: response.status,
+            statusText: response.statusText,
+            ok: response.ok,
+            json: () => response.json(),
+            text: () => response.text(),
+        };
+    }
+    /**
+     * Register a handler that flushes pending events when the Node.js process exits.
+     * Uses `beforeExit` so the event loop can wait for the async flush to complete.
+     */
+    registerExitHandler() {
+        if (this.exitHandlerRegistered) {
+            return;
+        }
+        this.exitHandlerRegistered = true;
+        process.on('beforeExit', () => {
+            void this.flush();
+        });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,GAIxB,MAAM,+BAA+B,CAAC;AAEvC,MAAM,QAAQ,GAAG,+BAA+B,CAAC;AACjD,MAAM,WAAW,GAAG,OAAO,CAAC;AA0B5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,OAAO,aAAc,SAAQ,uBAAuB;IAChD,qBAAqB,GAAG,KAAK,CAAC;IAEtC,YAAY,UAAgC,EAAE;QAC5C,MAAM,SAAS,GACb,OAAO,CAAC,SAAS;YACjB,OAAO,CAAC,GAAG,CAAC,iBAAiB;YAC7B,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;QAElC,MAAM,SAAS,GACb,OAAO,CAAC,SAAS;YACjB,OAAO,CAAC,GAAG,CAAC,iBAAiB;YAC7B,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;QAElC,MAAM,OAAO,GACX,OAAO,CAAC,OAAO;YACf,OAAO,CAAC,GAAG,CAAC,eAAe;YAC3B,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAEhC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,8CAA8C;gBAC5C,oFAAoF,CACvF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,8CAA8C;gBAC5C,oFAAoF,CACvF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,4CAA4C;gBAC1C,gFAAgF,CACnF,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAA8B;YAC5C,SAAS;YACT,SAAS;YACT,OAAO;YACP,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CAAC;QAEF,KAAK,CAAC,UAAU,CAAC,CAAC;QAElB,6DAA6D;QAC7D,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAC7B,CAAC;IAED;;;;;;;;OAQG;IACO,KAAK,CAAC,cAAc,CAC5B,GAAW,EACX,OAAqB;QAErB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QAEH,OAAO;YACL,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,EAAE,EAAE,QAAQ,CAAC,EAAE;YACf,IAAI,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE;YAC3B,IAAI,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE;SAC5B,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,mBAAmB;QACzB,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC/B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC;QAElC,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,EAAE;YAC5B,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @illuma-ai/observability-node
+ *
+ * Node.js SDK for Illuma Observability — LLM tracing and analytics.
+ * Drop-in replacement for the `langfuse` npm package.
+ *
+ * @example
+ * ```ts
+ * import { Observability, observeOpenAI } from '@illuma-ai/observability-node';
+ *
+ * // Reads ILLUMA_PUBLIC_KEY, ILLUMA_SECRET_KEY, ILLUMA_BASE_URL from env
+ * // (also supports LANGFUSE_* env vars for easy migration)
+ * const observability = new Observability();
+ *
+ * const trace = observability.trace({ name: 'my-workflow' });
+ * trace.generation({ model: 'gpt-4o', input: 'Hello', output: 'Hi!' });
+ *
+ * await observability.shutdown();
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { Observability, type ObservabilityOptions } from './client.js';
+export { observeOpenAI, type ObserveOpenAIOptions } from './openai.js';
+export type { ObservabilityClientConfig, TraceParams, GenerationParams, SpanParams, EventParams, ScoreParams, IngestionEvent, IngestionEventType, IngestionBatchRequest, } from '@illuma-ai/observability-core';
+export { ObservabilityCoreClient, TraceClient } from '@illuma-ai/observability-core';
+//# 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;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGvE,YAAY,EACV,yBAAyB,EACzB,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+/**
+ * @illuma-ai/observability-node
+ *
+ * Node.js SDK for Illuma Observability — LLM tracing and analytics.
+ * Drop-in replacement for the `langfuse` npm package.
+ *
+ * @example
+ * ```ts
+ * import { Observability, observeOpenAI } from '@illuma-ai/observability-node';
+ *
+ * // Reads ILLUMA_PUBLIC_KEY, ILLUMA_SECRET_KEY, ILLUMA_BASE_URL from env
+ * // (also supports LANGFUSE_* env vars for easy migration)
+ * const observability = new Observability();
+ *
+ * const trace = observability.trace({ name: 'my-workflow' });
+ * trace.generation({ model: 'gpt-4o', input: 'Hello', output: 'Hi!' });
+ *
+ * await observability.shutdown();
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { Observability } from './client.js';
+export { observeOpenAI } from './openai.js';
+export { ObservabilityCoreClient, TraceClient } from '@illuma-ai/observability-core';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,aAAa,EAA6B,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,aAAa,EAA6B,MAAM,aAAa,CAAC;AAevE,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/openai.d.ts

@@ -0,0 +1,63 @@
+import type { Observability } from './client.js';
+/**
+ * Represents the minimal shape of an OpenAI client we need to instrument.
+ * We avoid importing the `openai` package directly to keep it as an optional peer dependency.
+ */
+interface OpenAILike {
+    chat: {
+        completions: {
+            create: (...args: unknown[]) => Promise<unknown>;
+        };
+    };
+    completions: {
+        create: (...args: unknown[]) => Promise<unknown>;
+    };
+}
+/**
+ * Options for configuring the OpenAI observation wrapper.
+ */
+export interface ObserveOpenAIOptions {
+    /** Parent trace name. Defaults to "openai-call". */
+    traceName?: string;
+    /** Additional metadata to attach to each generation event */
+    generationMetadata?: Record<string, unknown>;
+    /** User ID to associate with traces */
+    userId?: string;
+    /** Session ID to group related traces */
+    sessionId?: string;
+}
+/**
+ * Wraps an OpenAI client instance with automatic observability instrumentation.
+ *
+ * Uses ES Proxy to intercept calls to `chat.completions.create()` and
+ * `completions.create()`, automatically creating trace and generation events
+ * with model, usage, and timing information.
+ *
+ * The returned client has the same interface as the original — existing code
+ * works unchanged.
+ *
+ * @param openai - An OpenAI client instance (from the `openai` npm package)
+ * @param observability - An initialized Observability client
+ * @param options - Optional configuration for trace naming and metadata
+ * @returns A proxied OpenAI client with the same interface
+ *
+ * @example
+ * ```ts
+ * import OpenAI from 'openai';
+ * import { Observability, observeOpenAI } from '@illuma-ai/observability-node';
+ *
+ * const client = new OpenAI();
+ * const observability = new Observability(); // reads env vars
+ *
+ * const traced = observeOpenAI(client, observability);
+ *
+ * // Works exactly like the original client, but now all calls are traced
+ * const response = await traced.chat.completions.create({
+ *   model: 'gpt-4o',
+ *   messages: [{ role: 'user', content: 'Hello!' }],
+ * });
+ * ```
+ */
+export declare function observeOpenAI<T extends OpenAILike>(openai: T, observability: Observability, options?: ObserveOpenAIOptions): T;
+export {};
+//# sourceMappingURL=openai.d.ts.map

package/dist/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../src/openai.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;GAGG;AACH,UAAU,UAAU;IAClB,IAAI,EAAE;QACJ,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;SAClD,CAAC;KACH,CAAC;IACF,WAAW,EAAE;QACX,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KAClD,CAAC;CACH;AAwCD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,UAAU,EAChD,MAAM,EAAE,CAAC,EACT,aAAa,EAAE,aAAa,EAC5B,OAAO,GAAE,oBAAyB,GACjC,CAAC,CAwLH"}

package/dist/openai.js

@@ -0,0 +1,190 @@
+import { ObservationLevel } from '@illuma-ai/observability-core';
+/**
+ * Wraps an OpenAI client instance with automatic observability instrumentation.
+ *
+ * Uses ES Proxy to intercept calls to `chat.completions.create()` and
+ * `completions.create()`, automatically creating trace and generation events
+ * with model, usage, and timing information.
+ *
+ * The returned client has the same interface as the original — existing code
+ * works unchanged.
+ *
+ * @param openai - An OpenAI client instance (from the `openai` npm package)
+ * @param observability - An initialized Observability client
+ * @param options - Optional configuration for trace naming and metadata
+ * @returns A proxied OpenAI client with the same interface
+ *
+ * @example
+ * ```ts
+ * import OpenAI from 'openai';
+ * import { Observability, observeOpenAI } from '@illuma-ai/observability-node';
+ *
+ * const client = new OpenAI();
+ * const observability = new Observability(); // reads env vars
+ *
+ * const traced = observeOpenAI(client, observability);
+ *
+ * // Works exactly like the original client, but now all calls are traced
+ * const response = await traced.chat.completions.create({
+ *   model: 'gpt-4o',
+ *   messages: [{ role: 'user', content: 'Hello!' }],
+ * });
+ * ```
+ */
+export function observeOpenAI(openai, observability, options = {}) {
+    const { traceName = 'openai-call', generationMetadata, userId, sessionId, } = options;
+    /**
+     * Wrap a create function to auto-instrument it with tracing.
+     * Handles both chat.completions.create and completions.create.
+     */
+    function wrapCreate(originalFn, kind) {
+        return async function wrappedCreate(...args) {
+            const params = (args[0] ?? {});
+            const startTime = new Date().toISOString();
+            // Create a trace for this call
+            const trace = observability.trace({
+                name: traceName,
+                input: params,
+                userId,
+                sessionId,
+            });
+            try {
+                // Call the original OpenAI method
+                const result = await originalFn.apply(openai, args);
+                const endTime = new Date().toISOString();
+                if (kind === 'chat') {
+                    const response = result;
+                    trace.generation({
+                        name: `chat.completions.create`,
+                        model: params.model ?? response.model,
+                        input: params.messages,
+                        output: response.choices?.[0]?.message,
+                        startTime,
+                        endTime,
+                        modelParameters: extractModelParams(params),
+                        usage: response.usage
+                            ? {
+                                input: response.usage.prompt_tokens,
+                                output: response.usage.completion_tokens,
+                                total: response.usage.total_tokens,
+                            }
+                            : undefined,
+                        metadata: {
+                            ...generationMetadata,
+                            openai_id: response.id,
+                            finish_reason: response.choices?.[0]?.finish_reason,
+                        },
+                    });
+                }
+                else {
+                    const response = result;
+                    trace.generation({
+                        name: `completions.create`,
+                        model: params.model ?? response.model,
+                        input: params.prompt,
+                        output: response.choices?.[0]?.text,
+                        startTime,
+                        endTime,
+                        modelParameters: extractModelParams(params),
+                        usage: response.usage
+                            ? {
+                                input: response.usage.prompt_tokens,
+                                output: response.usage.completion_tokens,
+                                total: response.usage.total_tokens,
+                            }
+                            : undefined,
+                        metadata: {
+                            ...generationMetadata,
+                            openai_id: response.id,
+                            finish_reason: response.choices?.[0]?.finish_reason,
+                        },
+                    });
+                }
+                return result;
+            }
+            catch (err) {
+                const endTime = new Date().toISOString();
+                // Record the failed generation
+                trace.generation({
+                    name: kind === 'chat' ? 'chat.completions.create' : 'completions.create',
+                    model: params.model,
+                    input: kind === 'chat' ? params.messages : params.prompt,
+                    startTime,
+                    endTime,
+                    modelParameters: extractModelParams(params),
+                    level: ObservationLevel.ERROR,
+                    statusMessage: err instanceof Error ? err.message : String(err),
+                    metadata: generationMetadata,
+                });
+                throw err;
+            }
+        };
+    }
+    /**
+     * Extract common model parameters from OpenAI request params.
+     */
+    function extractModelParams(params) {
+        const modelParams = {};
+        const keys = [
+            'temperature',
+            'top_p',
+            'max_tokens',
+            'max_completion_tokens',
+            'frequency_penalty',
+            'presence_penalty',
+            'stop',
+            'seed',
+            'response_format',
+            'tools',
+            'tool_choice',
+        ];
+        for (const key of keys) {
+            if (params[key] !== undefined) {
+                modelParams[key] = params[key];
+            }
+        }
+        return modelParams;
+    }
+    // Create proxied chat.completions object with instrumented create method
+    const wrappedChatCreate = wrapCreate(openai.chat.completions.create.bind(openai.chat.completions), 'chat');
+    const proxiedChatCompletions = new Proxy(openai.chat.completions, {
+        get(target, prop, receiver) {
+            if (prop === 'create') {
+                return wrappedChatCreate;
+            }
+            return Reflect.get(target, prop, receiver);
+        },
+    });
+    // Create proxied chat object
+    const proxiedChat = new Proxy(openai.chat, {
+        get(target, prop, receiver) {
+            if (prop === 'completions') {
+                return proxiedChatCompletions;
+            }
+            return Reflect.get(target, prop, receiver);
+        },
+    });
+    // Create proxied completions object with instrumented create method
+    const wrappedCompletionsCreate = wrapCreate(openai.completions.create.bind(openai.completions), 'completion');
+    const proxiedCompletions = new Proxy(openai.completions, {
+        get(target, prop, receiver) {
+            if (prop === 'create') {
+                return wrappedCompletionsCreate;
+            }
+            return Reflect.get(target, prop, receiver);
+        },
+    });
+    // Create the top-level proxy
+    return new Proxy(openai, {
+        get(target, prop, receiver) {
+            if (prop === 'chat') {
+                return proxiedChat;
+            }
+            if (prop === 'completions') {
+                return proxiedCompletions;
+            }
+            return Reflect.get(target, prop, receiver);
+        },
+    });
+}
+//# sourceMappingURL=openai.js.map

package/dist/openai.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@illuma-ai/observability-node",
+  "version": "0.1.0",
+  "description": "Node.js SDK for Illuma Observability - LLM tracing and analytics",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@illuma-ai/observability-core": "^0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.5",
+    "@types/node": "^20.14.2",
+    "vitest": "^1.6.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/illuma-ai/observability.git",
+    "directory": "packages/observability-node"
+  },
+  "license": "MIT",
+  "keywords": ["llm", "observability", "tracing", "illuma", "node"]
+}