Get started with Complira.

Installation

npm install @complira/sdk

OpenAI

import OpenAI from 'openai'
import { wrapOpenAI } from '@complira/sdk'

const openai = wrapOpenAI(
  new OpenAI({ apiKey: process.env.OPENAI_API_KEY }),
  {
    apiKey: process.env.COMPLIRA_API_KEY,
    appName: 'your-app-name',
    userId: 'user-123', // optional
  }
)

// Use exactly as before — every call is now logged
const response = await openai.chat.completions.create({
  model: 'gpt-4o',
  messages: [{ role: 'user', content: 'Hello' }]
})

Anthropic

import Anthropic from '@anthropic-ai/sdk'
import { wrapAnthropic } from '@complira/sdk'

const anthropic = wrapAnthropic(
  new Anthropic({ apiKey: process.env.ANTHROPIC_API_KEY }),
  {
    apiKey: process.env.COMPLIRA_API_KEY,
    appName: 'your-app-name',
  }
)

const response = await anthropic.messages.create({
  model: 'claude-sonnet-4-6',
  max_tokens: 1024,
  messages: [{ role: 'user', content: 'Hello' }]
})

Manual logging

If you need to log interactions from a provider not covered by a wrapper, use the low-level log() method directly.

import { CompliraClient } from '@complira/sdk'

const client = new CompliraClient({
  apiKey: process.env.COMPLIRA_API_KEY,
  appName: 'your-app-name'
})

await client.log({
  input: 'What is the risk rating for this loan?',
  output: 'Based on the provided data, the risk rating is...',
  model: 'gpt-4o',
  modelVersion: 'gpt-4o-2024-11-20',
  latencyMs: 450,
  tokenCount: 320,
  userId: 'analyst-42'
})

// Update the user ID for subsequent logs
client.setUserId("user-456")

// Set an error handler for failed log attempts
client.setOnLogError((err, payload) => {
  console.error("Complira log failed:", err)
})