Integrate Theazo in minutes

npm install @theazo/sdk

import { Theazo } from '@theazo/sdk'

export default function App() {
  return (
    <div>
      <h1>My App</h1>
      <Theazo appId="your-app-id" />
    </div>
  )
}

<Theazo
  appId="your-app-id"
  mode="chat"              // 'chat' | 'voice' | 'both'
  theme="dark"             // 'dark' | 'light' | 'auto'
  position="bottom-right"  // 'bottom-right' | 'bottom-left' | 'inline'
  primaryColor="#6366F1"   // Custom brand color
  onPersonaUpdate={(persona) => {
    console.log('Persona updated:', persona)
  }}
  onConversation={(msg) => {
    console.log('New message:', msg)
  }}
  onSignalCaptured={(signal) => {
    console.log('Signal:', signal)
  }}
/>

import { useTheazo } from '@theazo/sdk'

function MyComponent() {
  const theazo = useTheazo()

  // Start a new chat session
  await theazo.chat.start()

  // Send a message programmatically
  await theazo.chat.sendMessage('Looking for a birthday gift')

  // Get current conversation
  const conversation = theazo.chat.getConversation()

  // End the session (persona is saved)
  await theazo.chat.end()
}

import { useTheazo } from '@theazo/sdk'

function VoiceControl() {
  const theazo = useTheazo()

  // Start listening (opens microphone)
  await theazo.voice.startListening()

  // Stop listening (processes final utterance)
  await theazo.voice.stopListening()

  // Speak a response (text-to-speech)
  await theazo.voice.speak('How can I help you today?')

  // Check if currently listening
  const isListening = theazo.voice.isListening()
}

import { useTheazo } from '@theazo/sdk'

function EventListeners() {
  const theazo = useTheazo()

  useEffect(() => {
    const unsub1 = theazo.on('message', (msg: Message) => {
      console.log('New message:', msg.role, msg.content)
    })

    const unsub2 = theazo.on('persona.updated', (persona: Persona) => {
      console.log('Persona:', persona.archetype, persona.confidence)
    })

    const unsub3 = theazo.on('signal.captured', (signal: BehavioralSignal) => {
      console.log('Signal:', signal.type, signal.element, signal.strength)
    })

    const unsub4 = theazo.on('error', (error: TheazoError) => {
      console.error('SDK Error:', error.code, error.message)
    })

    return () => {
      unsub1()
      unsub2()
      unsub3()
      unsub4()
    }
  }, [theazo])
}

{
  "event": "persona.updated",
  "timestamp": "2026-02-09T14:23:00Z",
  "data": {
    "userId": "usr_abc123",
    "appId": "app_xyz789",
    "persona": {
      "archetype": "The Understated Creative",
      "confidence": 72,
      "said": [
        { "category": "style", "items": [{ "name": "minimalist", "score": 0.9 }] }
      ],
      "did": [
        { "type": "hover", "element": "Leather Jacket", "duration": 12400 }
      ],
      "aversions": [
        { "signal": "bright colors", "strength": -0.7, "type": "rejected" }
      ],
      "predictions": {
        "purchaseLikelihood": 0.78,
        "ltv": "$340-$520",
        "churnRisk": 0.12
      }
    }
  }
}

interface Persona {
  id: string
  userId: string
  appId: string
  archetype: string
  description: string
  confidence: number                    // 0-100
  said: {
    category: string
    items: { name: string; score: number }[]
  }[]
  did: {
    type: 'hover' | 'click' | 'scroll' | 'viewport'
    element: string
    duration?: number                   // milliseconds
    timestamp: number
  }[]
  aversions: {
    signal: string
    strength: number                    // -0.3 to -1.0
    type: 'mild' | 'rejected' | 'permanent' | 'mismatch'
    source: 'behavior' | 'chat' | 'voice'
  }[]
  predictions: {
    purchaseLikelihood: number          // 0-1
    ltv: string
    churnRisk: number                   // 0-1
    priceTrigger: string
    bestChannel: 'chat' | 'voice' | 'email'
  }
  traits: string[]
  approach: string
  createdAt: string
  updatedAt: string
}

interface Conversation {
  id: string
  userId: string
  appId: string
  channel: 'chat' | 'voice'
  sentiment: 'positive' | 'neutral' | 'negative'
  sentimentScore: number                // -1 to 1
  messages: Message[]
  insights: ConversationInsight[]
  duration: number                      // seconds
  createdAt: string
  completedAt: string | null
}

interface Message {
  id: string
  role: 'user' | 'assistant'
  content: string
  timestamp: string
  metadata?: {
    voiceTranscription?: boolean
    confidence?: number
  }
}

interface BehavioralSignal {
  id: string
  userId: string
  sessionId: string
  type: 'hover' | 'click' | 'scroll' | 'viewport' | 'scroll_past'
  element: string
  duration?: number
  strength: number                      // -1.0 to 1.0
  category: string
  timestamp: string
}

interface Insight {
  id: string
  appId: string
  type: 'theme' | 'frustration' | 'feature_request' | 'correlation'
  title: string
  description: string
  mentions: number
  sentiment: number
  trend: 'up' | 'down' | 'stable'
  evidence: string[]
  createdAt: string
}

import { Theazo, useTheazo } from '@theazo/sdk'

function App() {
  return (
    <Theazo appId="your-app-id" mode="both" theme="dark">
      <MyStore />
    </Theazo>
  )
}

function MyStore() {
  const theazo = useTheazo()

  useEffect(() => {
    const unsub = theazo.on('persona.updated', (persona) => {
      // Use persona data to personalize the UI
      updateRecommendations(persona.predictions)
    })
    return unsub
  }, [theazo])

  return <ProductGrid />
}

<template>
  <div>
    <theazo-widget
      app-id="your-app-id"
      mode="chat"
      theme="dark"
      @persona-update="onPersonaUpdate"
    />
  </div>
</template>

<script setup lang="ts">
import '@theazo/sdk/web-component'

function onPersonaUpdate(event: CustomEvent) {
  const persona = event.detail
  console.log('Persona:', persona.archetype)
}
</script>

// app.module.ts
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core'
import '@theazo/sdk/web-component'

@NgModule({
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
  // ...
})
export class AppModule {}

// app.component.html
<theazo-widget
  app-id="your-app-id"
  mode="chat"
  theme="dark"
  (persona-update)="onPersonaUpdate($event)"
></theazo-widget>

// pubspec.yaml
dependencies:
  theazo_sdk: ^1.0.0

// main.dart
import 'package:theazo_sdk/theazo_sdk.dart';

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  late TheazoClient _theazo;

  @override
  void initState() {
    super.initState();
    _theazo = TheazoClient(appId: 'your-app-id', mode: TheazoMode.chat);
    _theazo.onPersonaUpdate.listen((persona) {
      print('Archetype: ${persona.archetype}');
    });
  }

  @override
  Widget build(BuildContext context) {
    return TheazoWidget(client: _theazo);
  }
}