Event Tracking

import { SoluteClient } from '@solute-ai/sdk';

const solute = new SoluteClient({
  apiKey: 'your_api_key',
  host: 'https://api.solute.dev',
});

// Track a simple event
solute.track('Button Clicked');

// Track an event with properties
solute.track('Button Clicked', {
  button_id: 'signup-cta',
  page: '/homepage',
  position: 'header',
  color: 'blue',
});

// Identify a user with traits
solute.identify('user_123', {
  email: 'user@example.com',
  name: 'John Doe',
  plan: 'premium',
  created_at: '2025-01-01T00:00:00Z',
});

// Identify without traits (just set user ID)
solute.identify('user_123');

// Automatic page view tracking (enabled by default)
// The SDK automatically tracks page views on route changes

// Manual page view tracking
solute.page('/pricing');

// Page view with properties
solute.page('/pricing', {
  category: 'Marketing',
  title: 'Pricing Page',
});

// Page view with name and category
solute.page('Pricing Page', {
  plan: 'premium',
}, 'Marketing');

// Associate user with a group
solute.group('company_123', {
  name: 'Acme Corp',
  plan: 'enterprise',
  employees: 50,
});

// When a user signs up, alias their anonymous ID with their user ID
solute.alias('user_123', 'anonymous_456');

// Reset user and start a new session
solute.reset();

// Flush all queued events immediately
await solute.flush();

solute.track('Purchase Completed', {
  // Strings
  product_id: 'prod_123',
  currency: 'USD',
  
  // Numbers
  price: 99.99,
  quantity: 2,
  
  // Booleans
  is_premium: true,
  
  // Arrays
  tags: ['electronics', 'gadgets'],
  
  // Objects
  metadata: {
    source: 'web',
    campaign: 'summer-sale',
  },
  
  // Dates (will be serialized to ISO strings)
  purchased_at: new Date(),
});

'use client';

import { useTrack, useIdentify } from '@solute-ai/sdk/nextjs';

export function SignupButton() {
  const track = useTrack();
  const identify = useIdentify();

  const handleSignup = async () => {
    // Identify user after signup
    identify('user_123', {
      email: 'user@example.com',
    });

    // Track signup event
    track('User Signed Up', {
      method: 'email',
      plan: 'free',
    });
  };

  return <button onClick={handleSignup}>Sign Up</button>;
}