npm install @hanzo/insights

pnpm add @hanzo/insights

import insights from '@hanzo/insights';

insights.init('your-project-api-key', {
  api_host: 'https://insights.hanzo.ai',
  autocapture: true,
  capture_pageview: true,
  capture_pageleave: true,
  session_recording: {
    maskAllInputs: true,
  },
});

npm install @hanzo/insights @hanzo/insights-react

import { InsightsProvider, useInsights, useFeatureFlag } from '@hanzo/insights-react';

function App() {
  return (
    <InsightsProvider
      apiKey="your-project-api-key"
      options={{
        api_host: 'https://insights.hanzo.ai',
        autocapture: true,
      }}
    >
      <MyApp />
    </InsightsProvider>
  );
}

function MyApp() {
  const insights = useInsights();
  const showNewUI = useFeatureFlag('new-dashboard-ui');

  const handleSignup = () => {
    insights.capture('user_signed_up', {
      plan: 'pro',
      source: 'landing_page',
    });
  };

  return showNewUI ? <NewDashboard /> : <LegacyDashboard />;
}

npm install @hanzo/insights-node

import { Insights } from '@hanzo/insights-node';

const insights = new Insights('your-project-api-key', {
  host: 'https://insights.hanzo.ai',
});

// Capture a server-side event
insights.capture({
  distinctId: 'user-123',
  event: 'api_request',
  properties: {
    endpoint: '/v1/chat/completions',
    model: 'zen-coder-32b-instruct',
    tokens: 1500,
    latency_ms: 340,
  },
});

// Identify a user
insights.identify({
  distinctId: 'user-123',
  properties: {
    email: 'user@example.com',
    plan: 'pro',
    organization: 'acme-corp',
  },
});

// Graceful shutdown
await insights.shutdown();

// E-commerce
insights.capture('product_viewed', {
  product_id: 'prod_001',
  product_name: 'AI API Credits',
  price: 49.99,
  currency: 'USD',
  category: 'credits',
});

insights.capture('purchase_completed', {
  order_id: 'ord_abc123',
  total: 149.99,
  currency: 'USD',
  items: [
    { item_id: 'prod_001', quantity: 2, price: 49.99 },
  ],
});

// AI/LLM
insights.capture('model_inference', {
  model: 'zen-coder-32b-instruct',
  tokens_in: 150,
  tokens_out: 500,
  latency_ms: 1240,
  stream: true,
});

insights.capture('agent_task_completed', {
  agent_id: 'agent_xyz',
  task_type: 'code_review',
  duration_ms: 45000,
  tools_used: ['read_file', 'grep', 'edit'],
  success: true,
});

// User lifecycle
insights.capture('onboarding_step_completed', {
  step: 3,
  step_name: 'connect_repository',
  total_steps: 5,
  duration_seconds: 45,
});

// Boolean flag
if (insights.isFeatureEnabled('new-checkout-flow')) {
  renderNewCheckout();
}

// Multivariate flag
const variant = insights.getFeatureFlag('pricing-experiment');
switch (variant) {
  case 'control':
    showOriginalPricing();
    break;
  case 'variant-a':
    showDiscountedPricing();
    break;
  case 'variant-b':
    showUsageBasedPricing();
    break;
}

// Flag with payload (JSON)
const config = insights.getFeatureFlagPayload('dashboard-layout');
// { "columns": 3, "showSidebar": true, "theme": "dark" }

import { useFeatureFlag, useFeatureFlagPayload } from '@hanzo/insights-react';

function Dashboard() {
  const showNewNav = useFeatureFlag('new-navigation');
  const layoutConfig = useFeatureFlagPayload('dashboard-layout');

  return (
    <div>
      {showNewNav ? <NewNavigation /> : <LegacyNavigation />}
      <DashboardGrid columns={layoutConfig?.columns ?? 2} />
    </div>
  );
}

// Experiments use feature flags under the hood
const experiment = insights.getFeatureFlag('signup-cta-experiment');

// Track the conversion metric
insights.capture('signup_completed', {
  experiment_variant: experiment,
});

insights.init('your-api-key', {
  api_host: 'https://insights.hanzo.ai',
  session_recording: {
    maskAllInputs: true,          // Mask all input values
    maskTextSelector: '.sensitive', // Mask elements with this class
    blockSelector: '.no-record',   // Block elements entirely
    recordCrossOriginIframes: false,
  },
});

// Set once (persisted in localStorage)
insights.register({
  app_version: '2.4.1',
  environment: 'production',
  deployment: 'us-east-1',
});

// Set per-session only
insights.registerForSession({
  ab_test_group: 'variant-b',
});

// Unregister
insights.unregister('ab_test_group');

insights.identify('user-123', {
  $set: {
    email: 'user@example.com',
    plan: 'pro',
    company: 'Acme Corp',
    signup_date: '2026-01-15',
  },
  $set_once: {
    first_seen: new Date().toISOString(),
    original_referrer: document.referrer,
  },
});

// Associate user with a group
insights.group('organization', 'org-acme', {
  name: 'Acme Corporation',
  plan: 'enterprise',
  employee_count: 500,
  industry: 'technology',
});

// Events are now tagged with this group
insights.capture('api_key_created', {
  key_type: 'production',
});
// This event is attributed to both user-123 AND org-acme