Brazebee TypeScript SDK

npm install brazebee-sdk

import { BrazebeeClient } from 'brazebee-sdk';
 
// Initialize the client
const client = new BrazebeeClient({
  apiKeyAuth: 'brzb_live_your_api_key_here',
  environment: 'https://api.brazebee.com'
});
 
// Track an event
await client.events.track({
  company: {
    id: 'acme_corp',
    name: 'Acme Corporation',
    paymentProvider: 'stripe',
    paymentProviderId: 'cus_abc123',
    crmProvider: 'salesforce',
    crmProviderId: '001500000ABCDEFGH'
  },
  user: {
    id: 'user_123',
    email: 'john@acme.com',
    name: 'John Doe'
  },
  eventKey: 'feature_used',
  data: {
    feature: 'export',
    format: 'csv'
  }
});

await client.events.track({
  company: {
    id: 'acme_corp',
    name: 'Acme Corporation'
  },
  user: {
    id: 'user_123',
    email: 'john@acme.com',
    name: 'John Doe'
  },
  eventKey: 'onboarding_completed',
  data: {
    steps_completed: 5,
    time_taken_seconds: 180
  }
});

await client.events.track({
  company: {
    id: 'acme_corp',
    name: 'Acme Corporation'
  },
  eventKey: 'plan_upgraded',
  data: {
    from_plan: 'starter',
    to_plan: 'professional',
    mrr_change: 50
  }
});

await client.events.track({
  company: {
    id: 'acme_corp',
    name: 'Acme Corporation',
    // Standard optional fields
    paymentProvider: 'stripe',
    paymentProviderId: 'cus_abc123',
    crmProvider: 'salesforce',
    crmProviderId: '001abc',
    // Custom fields in data
  },
  user: {
    id: 'user_123',
    email: 'john@acme.com',
    name: 'John Doe'
  },
  eventKey: 'feature_used',
  data: {
    // Custom event data
    industry: 'technology',
    size: 'enterprise',
    plan: 'professional',
    mrr: 500,
    role: 'admin'
  }
});

const client = new BrazebeeClient({
  apiKeyAuth: 'brzb_live_your_api_key_here',  // Required: Your Brazebee API key
  environment: 'https://api.brazebee.com'      // Required: Your Brazebee API URL
});

import { BrazebeeClient } from 'brazebee-sdk';
 
const client = new BrazebeeClient({
  apiKeyAuth: 'your_api_key',
  environment: 'https://api.brazebee.com'
});
 
try {
  await client.events.track({
    company: { id: 'acme_corp', name: 'Acme' },
    eventKey: 'feature_used'
  });
} catch (error: any) {
  if (error.statusCode === 400) {
    console.error('Bad Request:', error.message);
  } else if (error.statusCode === 401) {
    console.error('Unauthorized - Invalid API key');
  } else if (error.statusCode === 404) {
    console.error('Not Found - Event key not configured');
  } else if (error.statusCode === 429) {
    console.error('Rate limit exceeded');
  } else {
    console.error('Error:', error.message);
  }
}

interface TrackEventRequest {
  company: CompanyInfo;      // Required: Company information
  user?: UserInfo;           // Optional: User information (omit for system events)
  eventKey: string;          // Required: Event key matching your configuration
  data?: Record<string, any>; // Optional: Custom event data
  timestamp?: Date;          // Optional: Event timestamp (defaults to now)
}

interface CompanyInfo {
  id: string;                  // Required: Unique company identifier
  name: string;                // Required: Company name
  paymentProvider?: string;    // Optional: e.g., 'stripe', 'paddle'
  paymentProviderId?: string;  // Optional: Customer ID in payment system
  crmProvider?: string;        // Optional: e.g., 'salesforce', 'hubspot'
  crmProviderId?: string;      // Optional: Account ID in CRM
}

interface UserInfo {
  id: string;      // Required: Unique user identifier
  email: string;   // Required: User email
  name: string;    // Required: User name
}

import { BrazebeeClient } from 'brazebee-sdk';
 
const client = new BrazebeeClient({
  apiKeyAuth: process.env.BRAZEBEE_API_KEY!,
  environment: process.env.BRAZEBEE_API_URL!
});
 
// Example: Track onboarding completion with full details
await client.events.track({
  company: {
    id: 'acme_corp',
    name: 'Acme Corporation',
    paymentProvider: 'stripe',
    paymentProviderId: 'cus_MYwpG9X4kW7ZKi',
    crmProvider: 'salesforce',
    crmProviderId: '001500000ABCDEFGH'
  },
  user: {
    id: 'user_12345',
    email: 'john.doe@acme.com',
    name: 'John Doe'
  },
  eventKey: 'onboarding_completed',
  data: {
    steps_completed: 7,
    time_taken_seconds: 420,
    completion_rate: 100,
    plan: 'enterprise',
    user_role: 'admin'
  }
});

# .env file
BRAZEBEE_API_KEY=brzb_live_your_api_key_here
BRAZEBEE_API_URL=https://api.brazebee.com

// In your application
import { BrazebeeClient } from 'brazebee-sdk';
 
const client = new BrazebeeClient({
  apiKeyAuth: process.env.BRAZEBEE_API_KEY!,
  environment: process.env.BRAZEBEE_API_URL!
});

import { 
  BrazebeeClient, 
  TrackEventRequest,
  CompanyInfo,
  UserInfo 
} from 'brazebee-sdk';
 
// TypeScript will validate your requests
const request: TrackEventRequest = {
  company: {
    id: 'acme_corp',
    name: 'Acme Corporation'
  },
  user: {
    id: 'user_123',
    email: 'john@acme.com',
    name: 'John Doe'
  },
  eventKey: 'feature_used',
  data: {
    feature: 'export'
  }
};
 
await client.events.track(request);

// app/api/track/route.ts
import { BrazebeeClient } from 'brazebee-sdk';
 
const client = new BrazebeeClient({
  apiKeyAuth: process.env.BRAZEBEE_API_KEY!,
  environment: process.env.BRAZEBEE_API_URL!
});
 
export async function POST(request: Request) {
  const body = await request.json();
  
  await client.events.track({
    company: body.company,
    user: body.user,
    eventKey: 'api_event',
    data: body.data
  });
  
  return Response.json({ success: true });
}

import express from 'express';
import { BrazebeeClient } from 'brazebee-sdk';
 
const app = express();
const client = new BrazebeeClient({
  apiKeyAuth: process.env.BRAZEBEE_API_KEY!,
  environment: process.env.BRAZEBEE_API_URL!
});
 
app.post('/track', async (req, res) => {
  try {
    await client.events.track({
      company: req.body.company,
      user: req.body.user,
      eventKey: req.body.eventKey,
      data: req.body.data
    });
    res.json({ success: true });
  } catch (error) {
    res.status(500).json({ error: 'Failed to track event' });
  }
});