TypeScript

npm install greenflash
# or
yarn add greenflash
# or
pnpm add greenflash

import Greenflash from 'greenflash';

const client = new Greenflash({
  apiKey: process.env['GREENFLASH_API_KEY'],
});

// Log your first conversation
client.messages.create({
  productId: 'YOUR_PRODUCT_ID',
  externalUserId: 'USER_ID',
  externalConversationId: 'CONVO_ID',
  messages: [
    { role: 'user', content: 'Hello, how can you help me today?' },
    { role: 'assistant', content: 'I can answer any questions you have!' },
  ],
});

import Greenflash from 'greenflash';

const client = new Greenflash({ apiKey: process.env['GREENFLASH_API_KEY'] });

// Type-safe message creation
const params: Greenflash.MessageCreateParams = {
  productId: 'YOUR_PRODUCT_ID',
  externalUserId: 'USER_ID',
  externalConversationId: 'CONVO_ID',
  messages: [{ role: 'user', content: '...' }],
};

const response: Greenflash.CreateResponse = await client.messages.create(params);

try {
  await client.messages.create({ /* ... */ });
} catch (err) {
  if (err instanceof Greenflash.APIError) {
    // Handle API-specific errors
    console.log(`API Error ${err.status}: ${err.name}`);
    console.log('Response headers:', err.headers);
  } else {
    // Re-throw unexpected errors
    throw err;
  }
}

// Disable retries globally
const client = new Greenflash({ maxRetries: 0 });

// Override retries per request
client.messages.create({ /* ... */ }, { maxRetries: 5 });

// Set global timeout to 20 seconds
const client = new Greenflash({ timeout: 20_000 });

// Override timeout for specific request
client.messages.create({ /* ... */ }, { timeout: 5_000 });

// Get raw response object
const raw = await client.messages.create({ /* ... */ }).asResponse();
console.log('Custom header:', raw.headers.get('X-My-Header'));

// Get both data and response
const { data, response } = await client.messages.create({ /* ... */ }).withResponse();
console.log('Response status:', response.status);
console.log('Response data:', data);

// Set log level via environment variable
// GREENFLASH_LOG=debug

// Or configure programmatically
const client = new Greenflash({
  logLevel: 'debug',
  logger: pino() // Use custom logger like pino
});