@ariaflowagents/analytics-sdk 0.9.1

package/README.md

@@ -0,0 +1,313 @@
+# @ariaflowagents/analytics-sdk
+
+Type-safe SDK for sending analytics events to AriaFlow Analytics Platform.
+
+## Installation
+
+```bash
+npm install @ariaflowagents/analytics-sdk
+# or
+bun add @ariaflowagents/analytics-sdk
+# or
+yarn add @ariaflowagents/analytics-sdk
+```
+
+## Quick Start
+
+### 1. Initialize the Client
+
+```typescript
+import { createAnalyticsClient } from '@ariaflowagents/analytics-sdk';
+
+const analytics = createAnalyticsClient({
+  apiKey: 'your-api-key',
+  workspaceId: 'your-workspace-id',
+  endpoint: 'https://analytics.ariaflow.dev/api/v1', // optional
+  flushInterval: 5000, // optional, default: 5000ms
+  maxBatchSize: 20, // optional, default: 20
+  enableDebug: true, // optional, default: false
+});
+```
+
+### 2. Track Events
+
+```typescript
+// Track a single event
+await analytics.track({
+  sessionId: 'session-123',
+  agentId: 'hospital-agent',
+  workspaceId: 'workspace-456',
+  type: 'conversation.started',
+  data: { channel: 'web' }
+});
+
+// Track batch events
+await analytics.trackBatch([
+  { sessionId: 'session-123', agentId: 'hospital-agent', workspaceId: 'workspace-456', type: 'node.entered', data: { nodeName: 'triage' } },
+  { sessionId: 'session-123', agentId: 'hospital-agent', workspaceId: 'workspace-456', type: 'tool.called', data: { toolName: 'create_booking' } },
+]);
+```
+
+### 3. Track Voice Calls
+
+```typescript
+// Start a voice call
+await analytics.trackVoiceCall({
+  sessionId: 'call-123',
+  workspaceId: 'workspace-456',
+  agentId: 'voice-agent',
+  userName: 'John Doe',
+  startedAt: new Date(),
+});
+
+// Update call metrics during the call
+await analytics.updateVoiceCall('call-123', {
+  interruptions: 2,
+  userTurns: 5,
+  agentTurns: 4,
+  currentNode: 'booking_flow',
+});
+
+// End the call
+await analytics.updateVoiceCall('call-123', {
+  endedAt: new Date(),
+  durationSeconds: 180,
+  outcome: 'booking_completed',
+  ttfMs: 850,
+});
+```
+
+### 4. Set Context
+
+```typescript
+// Set global context (applied to all events)
+analytics.setContext({
+  userId: 'user-789',
+  conversationId: 'conv-abc',
+  agentId: 'hospital-agent',
+});
+
+// Identify user
+analytics.identify('user-789', {
+  name: 'John Doe',
+  email: 'john@example.com',
+  plan: 'pro',
+});
+```
+
+### 5. Flush Events
+
+```typescript
+// Manually flush pending events
+await analytics.flush();
+```
+
+## React Integration
+
+### AnalyticsProvider
+
+```tsx
+import { AnalyticsProvider } from '@ariaflowagents/analytics-sdk/react';
+
+function App() {
+  return (
+    <AnalyticsProvider config={{
+      apiKey: process.env.ANALYTICS_API_KEY!,
+      workspaceId: 'workspace-456',
+    }}>
+      <YourApp />
+    </AnalyticsProvider>
+  );
+}
+```
+
+### useAnalytics Hook
+
+```tsx
+import { useAnalytics } from '@ariaflowagents/analytics-sdk/react';
+
+function MyComponent() {
+  const { track, setContext, identify } = useAnalytics();
+
+  const handleClick = async () => {
+    await track({
+      type: 'custom',
+      sessionId: 'session-123',
+      agentId: 'hospital-agent',
+      workspaceId: 'workspace-456',
+      data: { button: 'submit_form' }
+    });
+  };
+
+  return <button onClick={handleClick}>Submit</button>;
+}
+```
+
+### usePageView Hook
+
+```tsx
+import { usePageView } from '@ariaflowagents/analytics-sdk/react';
+
+function DashboardPage() {
+  usePageView('dashboard', { section: 'analytics' });
+
+  return <div>Dashboard</div>;
+}
+```
+
+### useVoiceCallTracker Hook
+
+```tsx
+import { useVoiceCallTracker } from '@ariaflowagents/analytics-sdk/react';
+
+function VoiceCallComponent({ sessionId, workspaceId }) {
+  const { startCall, endCall, trackInterruption, trackUserSpeech, trackAgentSpeech } = 
+    useVoiceCallTracker(sessionId, workspaceId);
+
+  useEffect(() => {
+    startCall('voice-agent');
+
+    return () => {
+      endCall('completed');
+    };
+  }, []);
+
+  return (
+    <div>
+      <button onClick={trackInterruption}>User Interrupted</button>
+    </div>
+  );
+}
+```
+
+## Event Types
+
+| Event Type | Description |
+|------------|-------------|
+| `conversation.started` | Conversation began |
+| `conversation.ended` | Conversation ended |
+| `node.entered` | Flow node entered |
+| `node.exited` | Flow node exited |
+| `tool.called` | Tool execution started |
+| `tool.completed` | Tool finished successfully |
+| `tool.error` | Tool execution failed |
+| `booking.completed` | Booking action completed |
+| `handoff.initiated` | Agent handoff triggered |
+| `emergency.detected` | Emergency condition detected |
+| `call.started` | Voice call started |
+| `call.ended` | Voice call ended |
+| `user.spoke` | User spoke (voice) |
+| `agent.spoke` | Agent spoke (voice) |
+| `user.interrupted` | User interrupted agent |
+| `silence.detected` | Silence detected |
+| `latency.stt` | Speech-to-text latency |
+| `latency.ttf` | Time to first response |
+| `latency.e2e` | End-to-end latency |
+| `latency.tts` | Text-to-speech latency |
+| `error.occurred` | Error occurred |
+| `custom` | Custom event |
+
+## Integration with AriaFlow Runtime
+
+```typescript
+import { Runtime, createTelemetryHooks } from '@ariaflowagents/core';
+import { createAnalyticsClient } from '@ariaflowagents/analytics-sdk';
+
+const analytics = createAnalyticsClient({
+  apiKey: process.env.ANALYTICS_API_KEY!,
+  workspaceId: 'workspace-456',
+});
+
+// Create telemetry hooks that forward events to analytics
+const telemetryHooks = {
+  onAgentStart: async (context, agentId) => {
+    await analytics.track({
+      sessionId: context.session.id,
+      agentId,
+      workspaceId: 'workspace-456',
+      type: 'conversation.started',
+      data: {}
+    });
+  },
+  onToolCall: async (context, call) => {
+    await analytics.track({
+      sessionId: context.session.id,
+      agentId: context.agentId,
+      workspaceId: 'workspace-456',
+      type: 'tool.called',
+      data: {
+        toolName: call.toolName,
+        toolCallId: call.toolCallId,
+      }
+    });
+  },
+  onToolResult: async (context, call) => {
+    await analytics.track({
+      sessionId: context.session.id,
+      agentId: context.agentId,
+      workspaceId: 'workspace-456',
+      type: 'tool.completed',
+      data: {
+        toolName: call.toolName,
+        success: call.success,
+        durationMs: call.durationMs,
+      }
+    });
+  },
+  onHandoff: async (context, from, to, reason) => {
+    await analytics.track({
+      sessionId: context.session.id,
+      agentId: from,
+      workspaceId: 'workspace-456',
+      type: 'handoff.initiated',
+      data: { from, to, reason }
+    });
+  },
+};
+
+const runtime = new Runtime({
+  agents: [...],
+  hooks: telemetryHooks,
+});
+```
+
+## API Reference
+
+### `createAnalyticsClient(config: AnalyticsConfig): AnalyticsClient`
+
+Creates a new analytics client instance.
+
+### `AnalyticsClient` Methods
+
+| Method | Description |
+|--------|-------------|
+| `track(event)` | Track a single event |
+| `trackBatch(events)` | Track multiple events |
+| `trackVoiceCall(data)` | Create a voice call record |
+| `updateVoiceCall(sessionId, data)` | Update voice call metrics |
+| `flush()` | Flush pending events |
+| `setContext(context)` | Set global context |
+| `identify(userId, traits?)` | Identify user |
+
+### `AnalyticsConfig`
+
+| Option | Type | Required | Default |
+|--------|------|----------|---------|
+| `apiKey` | `string` | ✅ | - |
+| `workspaceId` | `string` | ✅ | - |
+| `endpoint` | `string` | ❌ | `https://analytics.ariaflow.dev/api/v1` |
+| `flushInterval` | `number` | ❌ | `5000` (ms) |
+| `maxBatchSize` | `number` | ❌ | `20` |
+| `enableDebug` | `boolean` | ❌ | `false` |
+
+## Best Practices
+
+1. **Initialize Once**: Create a single client instance and reuse it
+2. **Batch Events**: The SDK automatically batches events for performance
+3. **Context First**: Set context and user identity early in the session
+4. **Flush on Exit**: Call `flush()` before page unload or app shutdown
+5. **Error Handling**: Wrap calls in try-catch for production use
+
+## License
+
+MIT

package/dist/index.js

@@ -0,0 +1,5 @@
+// @bun
+class s{queue=[];flushTimer=null;options;constructor(t){this.options=t,this.startFlushTimer()}add(t){if(this.queue.push(t),this.queue.length>=this.options.maxBatchSize)this.flush()}async flush(){if(this.queue.length===0)return;let t=[...this.queue];if(this.queue=[],this.options.enableDebug)console.log(`[Analytics] Flushing ${t.length} events`);try{await this.options.onFlush(t)}catch(e){console.error("[Analytics] Flush failed:",e),this.queue.unshift(...t)}}startFlushTimer(){this.flushTimer=setInterval(()=>{this.flush()},this.options.flushInterval)}destroy(){if(this.flushTimer)clearInterval(this.flushTimer),this.flushTimer=null;this.flush()}}class i{config;batcher;context;userId;userTraits;constructor(t){this.config={apiKey:t.apiKey,endpoint:t.endpoint??"https://analytics.ariaflow.dev/api/v1",workspaceId:t.workspaceId,flushInterval:t.flushInterval??5000,maxBatchSize:t.maxBatchSize??20,enableDebug:t.enableDebug??!1},this.context={workspaceId:this.config.workspaceId},this.batcher=new s({maxBatchSize:this.config.maxBatchSize,flushInterval:this.config.flushInterval,onFlush:this.sendEvents.bind(this),enableDebug:this.config.enableDebug})}async track(t){let e=this.enrichEvent(t);this.batcher.add(e)}async trackBatch(t){for(let e of t)await this.track(e)}async trackVoiceCall(t){if(this.config.enableDebug)console.log("[Analytics] Tracking voice call:",t.sessionId);let e=await fetch(`${this.config.endpoint}/voice-call`,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${this.config.apiKey}`},body:JSON.stringify(t)});if(!e.ok){let n=await e.text();throw Error(`Failed to track voice call: ${n}`)}}async updateVoiceCall(t,e){if(this.config.enableDebug)console.log("[Analytics] Updating voice call:",t);let n=await fetch(`${this.config.endpoint}/voice-call/${t}`,{method:"PUT",headers:{"Content-Type":"application/json",Authorization:`Bearer ${this.config.apiKey}`},body:JSON.stringify(e)});if(!n.ok){let a=await n.text();throw Error(`Failed to update voice call: ${a}`)}}async flush(){await this.batcher.flush()}setContext(t){this.context={...this.context,...t}}identify(t,e){this.userId=t,this.userTraits=e}enrichEvent(t){return{...t,workspaceId:t.workspaceId??this.context.workspaceId,sessionId:t.sessionId??this.context.sessionId??"",agentId:t.agentId??this.context.agentId??"",conversationId:t.conversationId??this.context.conversationId,timestamp:t.timestamp??new Date,data:{...t.data,userId:t.data.userId??this.userId,userTraits:this.userTraits}}}async sendEvents(t){let e=await fetch(`${this.config.endpoint}/events`,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${this.config.apiKey}`},body:JSON.stringify({events:t})});if(!e.ok){let n=await e.text();throw Error(`Failed to send events: ${n}`)}}destroy(){this.batcher.destroy()}}function r(t){return new i(t)}var c=i;export{c as default,r as createAnalyticsClient,s as Batcher,i as AriaFlowAnalytics};
+
+//# debugId=C025AF11B008174864756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": [
+    "export interface AnalyticsEvent {\n  id?: string;\n  timestamp?: Date;\n  sessionId: string;\n  conversationId?: string;\n  agentId: string;\n  workspaceId: string;\n  type: AnalyticsEventType;\n  data: Record<string, unknown>;\n}\n\nexport type AnalyticsEventType =\n  | \"conversation.started\"\n  | \"conversation.ended\"\n  | \"node.entered\"\n  | \"node.exited\"\n  | \"tool.called\"\n  | \"tool.completed\"\n  | \"tool.error\"\n  | \"booking.completed\"\n  | \"handoff.initiated\"\n  | \"emergency.detected\"\n  | \"call.started\"\n  | \"call.ended\"\n  | \"user.spoke\"\n  | \"agent.spoke\"\n  | \"user.interrupted\"\n  | \"silence.detected\"\n  | \"latency.stt\"\n  | \"latency.ttf\"\n  | \"latency.e2e\"\n  | \"latency.tts\"\n  | \"error.occurred\"\n  | \"custom\";\n\nexport interface VoiceCallData {\n  sessionId: string;\n  workspaceId: string;\n  agentId?: string;\n  userName?: string;\n  userId?: string;\n  startedAt: Date;\n  endedAt?: Date;\n  durationSeconds?: number;\n  userTurns?: number;\n  agentTurns?: number;\n  interruptions?: number;\n  silenceEvents?: number;\n  errors?: number;\n  totalUserSpeechMs?: number;\n  totalAgentSpeechMs?: number;\n  totalSilenceMs?: number;\n  ttfMs?: number;\n  avgSttMs?: number;\n  avgTtsMs?: number;\n  e2eMs?: number;\n  outcome?: string;\n  outcomeData?: Record<string, unknown>;\n  currentNode?: string;\n  agentName?: string;\n  transcript?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface AnalyticsConfig {\n  apiKey: string;\n  endpoint?: string;\n  workspaceId: string;\n  flushInterval?: number;\n  maxBatchSize?: number;\n  enableDebug?: boolean;\n}\n\nexport interface AnalyticsClient {\n  track: (event: AnalyticsEvent) => Promise<void>;\n  trackBatch: (events: AnalyticsEvent[]) => Promise<void>;\n  trackVoiceCall: (data: VoiceCallData) => Promise<void>;\n  updateVoiceCall: (sessionId: string, data: Partial<VoiceCallData>) => Promise<void>;\n  flush: () => Promise<void>;\n  setContext: (context: Partial<AnalyticsContext>) => void;\n  identify: (userId: string, traits?: Record<string, unknown>) => void;\n}\n\nexport interface AnalyticsContext {\n  workspaceId: string;\n  agentId?: string;\n  sessionId?: string;\n  userId?: string;\n  conversationId?: string;\n}\n\nexport interface BatcherOptions {\n  maxBatchSize: number;\n  flushInterval: number;\n  onFlush: (events: AnalyticsEvent[]) => Promise<void>;\n  enableDebug?: boolean;\n}\n\nexport class Batcher {\n  private queue: AnalyticsEvent[] = [];\n  private flushTimer: ReturnType<typeof setInterval> | null = null;\n  private options: BatcherOptions;\n\n  constructor(options: BatcherOptions) {\n    this.options = options;\n    this.startFlushTimer();\n  }\n\n  add(event: AnalyticsEvent): void {\n    this.queue.push(event);\n\n    if (this.queue.length >= this.options.maxBatchSize) {\n      this.flush();\n    }\n  }\n\n  async flush(): Promise<void> {\n    if (this.queue.length === 0) return;\n\n    const events = [...this.queue];\n    this.queue = [];\n\n    if (this.options.enableDebug) {\n      console.log(`[Analytics] Flushing ${events.length} events`);\n    }\n\n    try {\n      await this.options.onFlush(events);\n    } catch (error) {\n      console.error(\"[Analytics] Flush failed:\", error);\n      this.queue.unshift(...events);\n    }\n  }\n\n  private startFlushTimer(): void {\n    this.flushTimer = setInterval(() => {\n      this.flush();\n    }, this.options.flushInterval);\n  }\n\n  destroy(): void {\n    if (this.flushTimer) {\n      clearInterval(this.flushTimer);\n      this.flushTimer = null;\n    }\n    this.flush();\n  }\n}\n\nexport class AriaFlowAnalytics implements AnalyticsClient {\n  private config: Required<AnalyticsConfig>;\n  private batcher: Batcher;\n  private context: AnalyticsContext;\n  private userId?: string;\n  private userTraits?: Record<string, unknown>;\n\n  constructor(config: AnalyticsConfig) {\n    this.config = {\n      apiKey: config.apiKey,\n      endpoint: config.endpoint ?? \"https://analytics.ariaflow.dev/api/v1\",\n      workspaceId: config.workspaceId,\n      flushInterval: config.flushInterval ?? 5000,\n      maxBatchSize: config.maxBatchSize ?? 20,\n      enableDebug: config.enableDebug ?? false,\n    };\n\n    this.context = {\n      workspaceId: this.config.workspaceId,\n    };\n\n    this.batcher = new Batcher({\n      maxBatchSize: this.config.maxBatchSize,\n      flushInterval: this.config.flushInterval,\n      onFlush: this.sendEvents.bind(this),\n      enableDebug: this.config.enableDebug,\n    });\n  }\n\n  async track(event: AnalyticsEvent): Promise<void> {\n    const enrichedEvent = this.enrichEvent(event);\n    this.batcher.add(enrichedEvent);\n  }\n\n  async trackBatch(events: AnalyticsEvent[]): Promise<void> {\n    for (const event of events) {\n      await this.track(event);\n    }\n  }\n\n  async trackVoiceCall(data: VoiceCallData): Promise<void> {\n    if (this.config.enableDebug) {\n      console.log(\"[Analytics] Tracking voice call:\", data.sessionId);\n    }\n\n    const response = await fetch(`${this.config.endpoint}/voice-call`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        Authorization: `Bearer ${this.config.apiKey}`,\n      },\n      body: JSON.stringify(data),\n    });\n\n    if (!response.ok) {\n      const error = await response.text();\n      throw new Error(`Failed to track voice call: ${error}`);\n    }\n  }\n\n  async updateVoiceCall(sessionId: string, data: Partial<VoiceCallData>): Promise<void> {\n    if (this.config.enableDebug) {\n      console.log(\"[Analytics] Updating voice call:\", sessionId);\n    }\n\n    const response = await fetch(`${this.config.endpoint}/voice-call/${sessionId}`, {\n      method: \"PUT\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        Authorization: `Bearer ${this.config.apiKey}`,\n      },\n      body: JSON.stringify(data),\n    });\n\n    if (!response.ok) {\n      const error = await response.text();\n      throw new Error(`Failed to update voice call: ${error}`);\n    }\n  }\n\n  async flush(): Promise<void> {\n    await this.batcher.flush();\n  }\n\n  setContext(context: Partial<AnalyticsContext>): void {\n    this.context = { ...this.context, ...context };\n  }\n\n  identify(userId: string, traits?: Record<string, unknown>): void {\n    this.userId = userId;\n    this.userTraits = traits;\n  }\n\n  private enrichEvent(event: AnalyticsEvent): AnalyticsEvent {\n    return {\n      ...event,\n      workspaceId: event.workspaceId ?? this.context.workspaceId,\n      sessionId: event.sessionId ?? this.context.sessionId ?? \"\",\n      agentId: event.agentId ?? this.context.agentId ?? \"\",\n      conversationId: event.conversationId ?? this.context.conversationId,\n      timestamp: event.timestamp ?? new Date(),\n      data: {\n        ...event.data,\n        userId: event.data.userId ?? this.userId,\n        userTraits: this.userTraits,\n      },\n    };\n  }\n\n  private async sendEvents(events: AnalyticsEvent[]): Promise<void> {\n    const response = await fetch(`${this.config.endpoint}/events`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        Authorization: `Bearer ${this.config.apiKey}`,\n      },\n      body: JSON.stringify({ events }),\n    });\n\n    if (!response.ok) {\n      const error = await response.text();\n      throw new Error(`Failed to send events: ${error}`);\n    }\n  }\n\n  destroy(): void {\n    this.batcher.destroy();\n  }\n}\n\nexport function createAnalyticsClient(config: AnalyticsConfig): AnalyticsClient {\n  return new AriaFlowAnalytics(config);\n}\n\nexport default AriaFlowAnalytics;\n"
+  ],
+  "mappings": "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",
+  "debugId": "C025AF11B008174864756E2164756E21",
+  "names": []
+}

package/dist/react.js

@@ -0,0 +1,5 @@
+// @bun
+class m{queue=[];flushTimer=null;options;constructor(t){this.options=t,this.startFlushTimer()}add(t){if(this.queue.push(t),this.queue.length>=this.options.maxBatchSize)this.flush()}async flush(){if(this.queue.length===0)return;let t=[...this.queue];if(this.queue=[],this.options.enableDebug)console.log(`[Analytics] Flushing ${t.length} events`);try{await this.options.onFlush(t)}catch(n){console.error("[Analytics] Flush failed:",n),this.queue.unshift(...t)}}startFlushTimer(){this.flushTimer=setInterval(()=>{this.flush()},this.options.flushInterval)}destroy(){if(this.flushTimer)clearInterval(this.flushTimer),this.flushTimer=null;this.flush()}}class g{config;batcher;context;userId;userTraits;constructor(t){this.config={apiKey:t.apiKey,endpoint:t.endpoint??"https://analytics.ariaflow.dev/api/v1",workspaceId:t.workspaceId,flushInterval:t.flushInterval??5000,maxBatchSize:t.maxBatchSize??20,enableDebug:t.enableDebug??!1},this.context={workspaceId:this.config.workspaceId},this.batcher=new m({maxBatchSize:this.config.maxBatchSize,flushInterval:this.config.flushInterval,onFlush:this.sendEvents.bind(this),enableDebug:this.config.enableDebug})}async track(t){let n=this.enrichEvent(t);this.batcher.add(n)}async trackBatch(t){for(let n of t)await this.track(n)}async trackVoiceCall(t){if(this.config.enableDebug)console.log("[Analytics] Tracking voice call:",t.sessionId);let n=await fetch(`${this.config.endpoint}/voice-call`,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${this.config.apiKey}`},body:JSON.stringify(t)});if(!n.ok){let e=await n.text();throw Error(`Failed to track voice call: ${e}`)}}async updateVoiceCall(t,n){if(this.config.enableDebug)console.log("[Analytics] Updating voice call:",t);let e=await fetch(`${this.config.endpoint}/voice-call/${t}`,{method:"PUT",headers:{"Content-Type":"application/json",Authorization:`Bearer ${this.config.apiKey}`},body:JSON.stringify(n)});if(!e.ok){let r=await e.text();throw Error(`Failed to update voice call: ${r}`)}}async flush(){await this.batcher.flush()}setContext(t){this.context={...this.context,...t}}identify(t,n){this.userId=t,this.userTraits=n}enrichEvent(t){return{...t,workspaceId:t.workspaceId??this.context.workspaceId,sessionId:t.sessionId??this.context.sessionId??"",agentId:t.agentId??this.context.agentId??"",conversationId:t.conversationId??this.context.conversationId,timestamp:t.timestamp??new Date,data:{...t.data,userId:t.data.userId??this.userId,userTraits:this.userTraits}}}async sendEvents(t){let n=await fetch(`${this.config.endpoint}/events`,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${this.config.apiKey}`},body:JSON.stringify({events:t})});if(!n.ok){let e=await n.text();throw Error(`Failed to send events: ${e}`)}}destroy(){this.batcher.destroy()}}function v(t){return new g(t)}var x=g;import{useEffect as f,useRef as C,useCallback as s}from"react";var l=null;function w(t){if(l)l.destroy();return l=v(t),l}function k(){return l}function A(t){let n=C(null);f(()=>{if(t&&!n.current)n.current=v(t);return()=>{if(n.current)n.current.destroy(),n.current=null}},[t]);let e=n.current??l,r=s(async(a)=>{if(!e){console.warn("[Analytics] Client not initialized");return}await e.track(a)},[e]),i=s(async(a)=>{if(!e){console.warn("[Analytics] Client not initialized");return}await e.trackBatch(a)},[e]),u=s(async(a)=>{if(!e){console.warn("[Analytics] Client not initialized");return}await e.trackVoiceCall(a)},[e]),d=s(async(a,o)=>{if(!e){console.warn("[Analytics] Client not initialized");return}await e.updateVoiceCall(a,o)},[e]),h=s(async()=>{if(!e){console.warn("[Analytics] Client not initialized");return}await e.flush()},[e]),p=s((a)=>{if(!e){console.warn("[Analytics] Client not initialized");return}e.setContext(a)},[e]),y=s((a,o)=>{if(!e){console.warn("[Analytics] Client not initialized");return}e.identify(a,o)},[e]);return{track:r,trackBatch:i,trackVoiceCall:u,updateVoiceCall:d,flush:h,setContext:p,identify:y}}function D({children:t,config:n}){return f(()=>{return w(n),()=>{let e=k();if(e)e.destroy()}},[n]),t}function E(){let{track:t}=A();return t}function S(t,n){let{track:e}=A();f(()=>{e({type:"custom",sessionId:"",agentId:"",workspaceId:"",data:{event:"page_view",page:t,...n}})},[t,n,e])}function V(t,n){let{trackVoiceCall:e,updateVoiceCall:r}=A(),i=C({sessionId:t,workspaceId:n,userTurns:0,agentTurns:0,interruptions:0,totalUserSpeechMs:0,totalAgentSpeechMs:0}),u=s(async(a)=>{let o={sessionId:t,workspaceId:n,agentId:a,startedAt:new Date};i.current={...i.current,...o},await e(o)},[t,n,e]),d=s(async(a,o)=>{let c={endedAt:new Date,outcome:a,...i.current,...o};if(c.startedAt&&c.endedAt)c.durationSeconds=Math.floor((c.endedAt.getTime()-c.startedAt.getTime())/1000);await r(t,c)},[t,r]),h=s(()=>{i.current.interruptions=(i.current.interruptions??0)+1,r(t,{interruptions:i.current.interruptions})},[t,r]),p=s((a)=>{i.current.userTurns=(i.current.userTurns??0)+1,i.current.totalUserSpeechMs=(i.current.totalUserSpeechMs??0)+a,r(t,{userTurns:i.current.userTurns,totalUserSpeechMs:i.current.totalUserSpeechMs})},[t,r]),y=s((a)=>{i.current.agentTurns=(i.current.agentTurns??0)+1,i.current.totalAgentSpeechMs=(i.current.totalAgentSpeechMs??0)+a,r(t,{agentTurns:i.current.agentTurns,totalAgentSpeechMs:i.current.totalAgentSpeechMs})},[t,r]);return{startCall:u,endCall:d,trackInterruption:h,trackUserSpeech:p,trackAgentSpeech:y}}export{V as useVoiceCallTracker,E as useTrackEvent,S as usePageView,A as useAnalytics,w as initAnalytics,k as getAnalyticsClient,D as AnalyticsProvider};
+
+//# debugId=752A6A65667196E164756E2164756E21
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts", "../src/react.ts"],
+  "sourcesContent": [
+    "export interface AnalyticsEvent {\n  id?: string;\n  timestamp?: Date;\n  sessionId: string;\n  conversationId?: string;\n  agentId: string;\n  workspaceId: string;\n  type: AnalyticsEventType;\n  data: Record<string, unknown>;\n}\n\nexport type AnalyticsEventType =\n  | \"conversation.started\"\n  | \"conversation.ended\"\n  | \"node.entered\"\n  | \"node.exited\"\n  | \"tool.called\"\n  | \"tool.completed\"\n  | \"tool.error\"\n  | \"booking.completed\"\n  | \"handoff.initiated\"\n  | \"emergency.detected\"\n  | \"call.started\"\n  | \"call.ended\"\n  | \"user.spoke\"\n  | \"agent.spoke\"\n  | \"user.interrupted\"\n  | \"silence.detected\"\n  | \"latency.stt\"\n  | \"latency.ttf\"\n  | \"latency.e2e\"\n  | \"latency.tts\"\n  | \"error.occurred\"\n  | \"custom\";\n\nexport interface VoiceCallData {\n  sessionId: string;\n  workspaceId: string;\n  agentId?: string;\n  userName?: string;\n  userId?: string;\n  startedAt: Date;\n  endedAt?: Date;\n  durationSeconds?: number;\n  userTurns?: number;\n  agentTurns?: number;\n  interruptions?: number;\n  silenceEvents?: number;\n  errors?: number;\n  totalUserSpeechMs?: number;\n  totalAgentSpeechMs?: number;\n  totalSilenceMs?: number;\n  ttfMs?: number;\n  avgSttMs?: number;\n  avgTtsMs?: number;\n  e2eMs?: number;\n  outcome?: string;\n  outcomeData?: Record<string, unknown>;\n  currentNode?: string;\n  agentName?: string;\n  transcript?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface AnalyticsConfig {\n  apiKey: string;\n  endpoint?: string;\n  workspaceId: string;\n  flushInterval?: number;\n  maxBatchSize?: number;\n  enableDebug?: boolean;\n}\n\nexport interface AnalyticsClient {\n  track: (event: AnalyticsEvent) => Promise<void>;\n  trackBatch: (events: AnalyticsEvent[]) => Promise<void>;\n  trackVoiceCall: (data: VoiceCallData) => Promise<void>;\n  updateVoiceCall: (sessionId: string, data: Partial<VoiceCallData>) => Promise<void>;\n  flush: () => Promise<void>;\n  setContext: (context: Partial<AnalyticsContext>) => void;\n  identify: (userId: string, traits?: Record<string, unknown>) => void;\n}\n\nexport interface AnalyticsContext {\n  workspaceId: string;\n  agentId?: string;\n  sessionId?: string;\n  userId?: string;\n  conversationId?: string;\n}\n\nexport interface BatcherOptions {\n  maxBatchSize: number;\n  flushInterval: number;\n  onFlush: (events: AnalyticsEvent[]) => Promise<void>;\n  enableDebug?: boolean;\n}\n\nexport class Batcher {\n  private queue: AnalyticsEvent[] = [];\n  private flushTimer: ReturnType<typeof setInterval> | null = null;\n  private options: BatcherOptions;\n\n  constructor(options: BatcherOptions) {\n    this.options = options;\n    this.startFlushTimer();\n  }\n\n  add(event: AnalyticsEvent): void {\n    this.queue.push(event);\n\n    if (this.queue.length >= this.options.maxBatchSize) {\n      this.flush();\n    }\n  }\n\n  async flush(): Promise<void> {\n    if (this.queue.length === 0) return;\n\n    const events = [...this.queue];\n    this.queue = [];\n\n    if (this.options.enableDebug) {\n      console.log(`[Analytics] Flushing ${events.length} events`);\n    }\n\n    try {\n      await this.options.onFlush(events);\n    } catch (error) {\n      console.error(\"[Analytics] Flush failed:\", error);\n      this.queue.unshift(...events);\n    }\n  }\n\n  private startFlushTimer(): void {\n    this.flushTimer = setInterval(() => {\n      this.flush();\n    }, this.options.flushInterval);\n  }\n\n  destroy(): void {\n    if (this.flushTimer) {\n      clearInterval(this.flushTimer);\n      this.flushTimer = null;\n    }\n    this.flush();\n  }\n}\n\nexport class AriaFlowAnalytics implements AnalyticsClient {\n  private config: Required<AnalyticsConfig>;\n  private batcher: Batcher;\n  private context: AnalyticsContext;\n  private userId?: string;\n  private userTraits?: Record<string, unknown>;\n\n  constructor(config: AnalyticsConfig) {\n    this.config = {\n      apiKey: config.apiKey,\n      endpoint: config.endpoint ?? \"https://analytics.ariaflow.dev/api/v1\",\n      workspaceId: config.workspaceId,\n      flushInterval: config.flushInterval ?? 5000,\n      maxBatchSize: config.maxBatchSize ?? 20,\n      enableDebug: config.enableDebug ?? false,\n    };\n\n    this.context = {\n      workspaceId: this.config.workspaceId,\n    };\n\n    this.batcher = new Batcher({\n      maxBatchSize: this.config.maxBatchSize,\n      flushInterval: this.config.flushInterval,\n      onFlush: this.sendEvents.bind(this),\n      enableDebug: this.config.enableDebug,\n    });\n  }\n\n  async track(event: AnalyticsEvent): Promise<void> {\n    const enrichedEvent = this.enrichEvent(event);\n    this.batcher.add(enrichedEvent);\n  }\n\n  async trackBatch(events: AnalyticsEvent[]): Promise<void> {\n    for (const event of events) {\n      await this.track(event);\n    }\n  }\n\n  async trackVoiceCall(data: VoiceCallData): Promise<void> {\n    if (this.config.enableDebug) {\n      console.log(\"[Analytics] Tracking voice call:\", data.sessionId);\n    }\n\n    const response = await fetch(`${this.config.endpoint}/voice-call`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        Authorization: `Bearer ${this.config.apiKey}`,\n      },\n      body: JSON.stringify(data),\n    });\n\n    if (!response.ok) {\n      const error = await response.text();\n      throw new Error(`Failed to track voice call: ${error}`);\n    }\n  }\n\n  async updateVoiceCall(sessionId: string, data: Partial<VoiceCallData>): Promise<void> {\n    if (this.config.enableDebug) {\n      console.log(\"[Analytics] Updating voice call:\", sessionId);\n    }\n\n    const response = await fetch(`${this.config.endpoint}/voice-call/${sessionId}`, {\n      method: \"PUT\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        Authorization: `Bearer ${this.config.apiKey}`,\n      },\n      body: JSON.stringify(data),\n    });\n\n    if (!response.ok) {\n      const error = await response.text();\n      throw new Error(`Failed to update voice call: ${error}`);\n    }\n  }\n\n  async flush(): Promise<void> {\n    await this.batcher.flush();\n  }\n\n  setContext(context: Partial<AnalyticsContext>): void {\n    this.context = { ...this.context, ...context };\n  }\n\n  identify(userId: string, traits?: Record<string, unknown>): void {\n    this.userId = userId;\n    this.userTraits = traits;\n  }\n\n  private enrichEvent(event: AnalyticsEvent): AnalyticsEvent {\n    return {\n      ...event,\n      workspaceId: event.workspaceId ?? this.context.workspaceId,\n      sessionId: event.sessionId ?? this.context.sessionId ?? \"\",\n      agentId: event.agentId ?? this.context.agentId ?? \"\",\n      conversationId: event.conversationId ?? this.context.conversationId,\n      timestamp: event.timestamp ?? new Date(),\n      data: {\n        ...event.data,\n        userId: event.data.userId ?? this.userId,\n        userTraits: this.userTraits,\n      },\n    };\n  }\n\n  private async sendEvents(events: AnalyticsEvent[]): Promise<void> {\n    const response = await fetch(`${this.config.endpoint}/events`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        Authorization: `Bearer ${this.config.apiKey}`,\n      },\n      body: JSON.stringify({ events }),\n    });\n\n    if (!response.ok) {\n      const error = await response.text();\n      throw new Error(`Failed to send events: ${error}`);\n    }\n  }\n\n  destroy(): void {\n    this.batcher.destroy();\n  }\n}\n\nexport function createAnalyticsClient(config: AnalyticsConfig): AnalyticsClient {\n  return new AriaFlowAnalytics(config);\n}\n\nexport default AriaFlowAnalytics;\n",
+    "import { useEffect, useRef, useCallback } from \"react\";\nimport {\n  AriaFlowAnalytics,\n  createAnalyticsClient,\n  type AnalyticsConfig,\n  type AnalyticsEvent,\n  type AnalyticsContext,\n  type VoiceCallData,\n} from \"./index.js\";\n\nexport interface UseAnalyticsOptions extends AnalyticsConfig {\n  autoFlush?: boolean;\n}\n\nlet globalClient: AriaFlowAnalytics | null = null;\n\nexport function initAnalytics(config: AnalyticsConfig): AriaFlowAnalytics {\n  if (globalClient) {\n    globalClient.destroy();\n  }\n  globalClient = createAnalyticsClient(config) as AriaFlowAnalytics;\n  return globalClient;\n}\n\nexport function getAnalyticsClient(): AriaFlowAnalytics | null {\n  return globalClient;\n}\n\nexport function useAnalytics(config?: UseAnalyticsOptions): {\n  track: (event: AnalyticsEvent) => Promise<void>;\n  trackBatch: (events: AnalyticsEvent[]) => Promise<void>;\n  trackVoiceCall: (data: VoiceCallData) => Promise<void>;\n  updateVoiceCall: (sessionId: string, data: Partial<VoiceCallData>) => Promise<void>;\n  flush: () => Promise<void>;\n  setContext: (context: Partial<AnalyticsContext>) => void;\n  identify: (userId: string, traits?: Record<string, unknown>) => void;\n} {\n  const clientRef = useRef<AriaFlowAnalytics | null>(null);\n\n  useEffect(() => {\n    if (config && !clientRef.current) {\n      clientRef.current = createAnalyticsClient(config) as AriaFlowAnalytics;\n    }\n\n    return () => {\n      if (clientRef.current) {\n        clientRef.current.destroy();\n        clientRef.current = null;\n      }\n    };\n  }, [config]);\n\n  const client = clientRef.current ?? globalClient;\n\n  const track = useCallback(\n    async (event: AnalyticsEvent) => {\n      if (!client) {\n        console.warn(\"[Analytics] Client not initialized\");\n        return;\n      }\n      await client.track(event);\n    },\n    [client]\n  );\n\n  const trackBatch = useCallback(\n    async (events: AnalyticsEvent[]) => {\n      if (!client) {\n        console.warn(\"[Analytics] Client not initialized\");\n        return;\n      }\n      await client.trackBatch(events);\n    },\n    [client]\n  );\n\n  const trackVoiceCall = useCallback(\n    async (data: VoiceCallData) => {\n      if (!client) {\n        console.warn(\"[Analytics] Client not initialized\");\n        return;\n      }\n      await client.trackVoiceCall(data);\n    },\n    [client]\n  );\n\n  const updateVoiceCall = useCallback(\n    async (sessionId: string, data: Partial<VoiceCallData>) => {\n      if (!client) {\n        console.warn(\"[Analytics] Client not initialized\");\n        return;\n      }\n      await client.updateVoiceCall(sessionId, data);\n    },\n    [client]\n  );\n\n  const flush = useCallback(async () => {\n    if (!client) {\n      console.warn(\"[Analytics] Client not initialized\");\n      return;\n    }\n    await client.flush();\n  }, [client]);\n\n  const setContext = useCallback(\n    (context: Partial<AnalyticsContext>) => {\n      if (!client) {\n        console.warn(\"[Analytics] Client not initialized\");\n        return;\n      }\n      client.setContext(context);\n    },\n    [client]\n  );\n\n  const identify = useCallback(\n    (userId: string, traits?: Record<string, unknown>) => {\n      if (!client) {\n        console.warn(\"[Analytics] Client not initialized\");\n        return;\n      }\n      client.identify(userId, traits);\n    },\n    [client]\n  );\n\n  return {\n    track,\n    trackBatch,\n    trackVoiceCall,\n    updateVoiceCall,\n    flush,\n    setContext,\n    identify,\n  };\n}\n\nexport function AnalyticsProvider({\n  children,\n  config,\n}: {\n  children: React.ReactNode;\n  config: AnalyticsConfig;\n}): React.ReactElement {\n  useEffect(() => {\n    initAnalytics(config);\n    return () => {\n      const client = getAnalyticsClient();\n      if (client) {\n        client.destroy();\n      }\n    };\n  }, [config]);\n\n  return children as React.ReactElement;\n}\n\nexport function useTrackEvent(): (event: AnalyticsEvent) => Promise<void> {\n  const { track } = useAnalytics();\n  return track;\n}\n\nexport function usePageView(pageName: string, properties?: Record<string, unknown>): void {\n  const { track } = useAnalytics();\n\n  useEffect(() => {\n    track({\n      type: \"custom\",\n      sessionId: \"\",\n      agentId: \"\",\n      workspaceId: \"\",\n      data: {\n        event: \"page_view\",\n        page: pageName,\n        ...properties,\n      },\n    });\n  }, [pageName, properties, track]);\n}\n\nexport function useVoiceCallTracker(sessionId: string, workspaceId: string): {\n  startCall: (agentId?: string) => Promise<void>;\n  endCall: (outcome?: string, data?: Partial<VoiceCallData>) => Promise<void>;\n  trackInterruption: () => void;\n  trackUserSpeech: (durationMs: number) => void;\n  trackAgentSpeech: (durationMs: number) => void;\n} {\n  const { trackVoiceCall, updateVoiceCall } = useAnalytics();\n  const callDataRef = useRef<Partial<VoiceCallData>>({\n    sessionId,\n    workspaceId,\n    userTurns: 0,\n    agentTurns: 0,\n    interruptions: 0,\n    totalUserSpeechMs: 0,\n    totalAgentSpeechMs: 0,\n  });\n\n  const startCall = useCallback(\n    async (agentId?: string) => {\n      const data: VoiceCallData = {\n        sessionId,\n        workspaceId,\n        agentId,\n        startedAt: new Date(),\n      };\n\n      callDataRef.current = {\n        ...callDataRef.current,\n        ...data,\n      };\n\n      await trackVoiceCall(data);\n    },\n    [sessionId, workspaceId, trackVoiceCall]\n  );\n\n  const endCall = useCallback(\n    async (outcome?: string, additionalData?: Partial<VoiceCallData>) => {\n      const data: Partial<VoiceCallData> = {\n        endedAt: new Date(),\n        outcome,\n        ...callDataRef.current,\n        ...additionalData,\n      };\n\n      if (data.startedAt && data.endedAt) {\n        data.durationSeconds = Math.floor(\n          (data.endedAt.getTime() - data.startedAt.getTime()) / 1000\n        );\n      }\n\n      await updateVoiceCall(sessionId, data);\n    },\n    [sessionId, updateVoiceCall]\n  );\n\n  const trackInterruption = useCallback(() => {\n    callDataRef.current.interruptions = (callDataRef.current.interruptions ?? 0) + 1;\n    updateVoiceCall(sessionId, {\n      interruptions: callDataRef.current.interruptions,\n    });\n  }, [sessionId, updateVoiceCall]);\n\n  const trackUserSpeech = useCallback(\n    (durationMs: number) => {\n      callDataRef.current.userTurns = (callDataRef.current.userTurns ?? 0) + 1;\n      callDataRef.current.totalUserSpeechMs =\n        (callDataRef.current.totalUserSpeechMs ?? 0) + durationMs;\n\n      updateVoiceCall(sessionId, {\n        userTurns: callDataRef.current.userTurns,\n        totalUserSpeechMs: callDataRef.current.totalUserSpeechMs,\n      });\n    },\n    [sessionId, updateVoiceCall]\n  );\n\n  const trackAgentSpeech = useCallback(\n    (durationMs: number) => {\n      callDataRef.current.agentTurns = (callDataRef.current.agentTurns ?? 0) + 1;\n      callDataRef.current.totalAgentSpeechMs =\n        (callDataRef.current.totalAgentSpeechMs ?? 0) + durationMs;\n\n      updateVoiceCall(sessionId, {\n        agentTurns: callDataRef.current.agentTurns,\n        totalAgentSpeechMs: callDataRef.current.totalAgentSpeechMs,\n      });\n    },\n    [sessionId, updateVoiceCall]\n  );\n\n  return {\n    startCall,\n    endCall,\n    trackInterruption,\n    trackUserSpeech,\n    trackAgentSpeech,\n  };\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "752A6A65667196E164756E2164756E21",
+  "names": []
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@ariaflowagents/analytics-sdk",
+  "version": "0.9.1",
+  "type": "module",
+  "description": "Type-safe SDK for sending analytics events to AriaFlow Analytics Platform",
+  "exports": {
+    ".": "./src/index.ts",
+    "./react": "./src/react.ts"
+  },
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "scripts": {
+    "build": "~/.bun/bin/bun build ./src/index.ts ./src/react.ts --outdir ./dist --target bun --minify --sourcemap --external react",
+    "dev": "~/.bun/bin/bun build ./src/index.ts ./src/react.ts --outdir ./dist --target bun --watch --external react"
+  },
+  "files": [
+    "src",
+    "dist"
+  ],
+  "keywords": [
+    "ariaflow",
+    "analytics",
+    "sdk",
+    "telemetry"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/react": "^19.0.0",
+    "react": "^19.0.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,284 @@
+export interface AnalyticsEvent {
+  id?: string;
+  timestamp?: Date;
+  sessionId: string;
+  conversationId?: string;
+  agentId: string;
+  workspaceId: string;
+  type: AnalyticsEventType;
+  data: Record<string, unknown>;
+}
+
+export type AnalyticsEventType =
+  | "conversation.started"
+  | "conversation.ended"
+  | "node.entered"
+  | "node.exited"
+  | "tool.called"
+  | "tool.completed"
+  | "tool.error"
+  | "booking.completed"
+  | "handoff.initiated"
+  | "emergency.detected"
+  | "call.started"
+  | "call.ended"
+  | "user.spoke"
+  | "agent.spoke"
+  | "user.interrupted"
+  | "silence.detected"
+  | "latency.stt"
+  | "latency.ttf"
+  | "latency.e2e"
+  | "latency.tts"
+  | "error.occurred"
+  | "custom";
+
+export interface VoiceCallData {
+  sessionId: string;
+  workspaceId: string;
+  agentId?: string;
+  userName?: string;
+  userId?: string;
+  startedAt: Date;
+  endedAt?: Date;
+  durationSeconds?: number;
+  userTurns?: number;
+  agentTurns?: number;
+  interruptions?: number;
+  silenceEvents?: number;
+  errors?: number;
+  totalUserSpeechMs?: number;
+  totalAgentSpeechMs?: number;
+  totalSilenceMs?: number;
+  ttfMs?: number;
+  avgSttMs?: number;
+  avgTtsMs?: number;
+  e2eMs?: number;
+  outcome?: string;
+  outcomeData?: Record<string, unknown>;
+  currentNode?: string;
+  agentName?: string;
+  transcript?: string;
+  metadata?: Record<string, unknown>;
+}
+
+export interface AnalyticsConfig {
+  apiKey: string;
+  endpoint?: string;
+  workspaceId: string;
+  flushInterval?: number;
+  maxBatchSize?: number;
+  enableDebug?: boolean;
+}
+
+export interface AnalyticsClient {
+  track: (event: AnalyticsEvent) => Promise<void>;
+  trackBatch: (events: AnalyticsEvent[]) => Promise<void>;
+  trackVoiceCall: (data: VoiceCallData) => Promise<void>;
+  updateVoiceCall: (sessionId: string, data: Partial<VoiceCallData>) => Promise<void>;
+  flush: () => Promise<void>;
+  setContext: (context: Partial<AnalyticsContext>) => void;
+  identify: (userId: string, traits?: Record<string, unknown>) => void;
+}
+
+export interface AnalyticsContext {
+  workspaceId: string;
+  agentId?: string;
+  sessionId?: string;
+  userId?: string;
+  conversationId?: string;
+}
+
+export interface BatcherOptions {
+  maxBatchSize: number;
+  flushInterval: number;
+  onFlush: (events: AnalyticsEvent[]) => Promise<void>;
+  enableDebug?: boolean;
+}
+
+export class Batcher {
+  private queue: AnalyticsEvent[] = [];
+  private flushTimer: ReturnType<typeof setInterval> | null = null;
+  private options: BatcherOptions;
+
+  constructor(options: BatcherOptions) {
+    this.options = options;
+    this.startFlushTimer();
+  }
+
+  add(event: AnalyticsEvent): void {
+    this.queue.push(event);
+
+    if (this.queue.length >= this.options.maxBatchSize) {
+      this.flush();
+    }
+  }
+
+  async flush(): Promise<void> {
+    if (this.queue.length === 0) return;
+
+    const events = [...this.queue];
+    this.queue = [];
+
+    if (this.options.enableDebug) {
+      console.log(`[Analytics] Flushing ${events.length} events`);
+    }
+
+    try {
+      await this.options.onFlush(events);
+    } catch (error) {
+      console.error("[Analytics] Flush failed:", error);
+      this.queue.unshift(...events);
+    }
+  }
+
+  private startFlushTimer(): void {
+    this.flushTimer = setInterval(() => {
+      this.flush();
+    }, this.options.flushInterval);
+  }
+
+  destroy(): void {
+    if (this.flushTimer) {
+      clearInterval(this.flushTimer);
+      this.flushTimer = null;
+    }
+    this.flush();
+  }
+}
+
+export class AriaFlowAnalytics implements AnalyticsClient {
+  private config: Required<AnalyticsConfig>;
+  private batcher: Batcher;
+  private context: AnalyticsContext;
+  private userId?: string;
+  private userTraits?: Record<string, unknown>;
+
+  constructor(config: AnalyticsConfig) {
+    this.config = {
+      apiKey: config.apiKey,
+      endpoint: config.endpoint ?? "https://analytics.ariaflow.dev/api/v1",
+      workspaceId: config.workspaceId,
+      flushInterval: config.flushInterval ?? 5000,
+      maxBatchSize: config.maxBatchSize ?? 20,
+      enableDebug: config.enableDebug ?? false,
+    };
+
+    this.context = {
+      workspaceId: this.config.workspaceId,
+    };
+
+    this.batcher = new Batcher({
+      maxBatchSize: this.config.maxBatchSize,
+      flushInterval: this.config.flushInterval,
+      onFlush: this.sendEvents.bind(this),
+      enableDebug: this.config.enableDebug,
+    });
+  }
+
+  async track(event: AnalyticsEvent): Promise<void> {
+    const enrichedEvent = this.enrichEvent(event);
+    this.batcher.add(enrichedEvent);
+  }
+
+  async trackBatch(events: AnalyticsEvent[]): Promise<void> {
+    for (const event of events) {
+      await this.track(event);
+    }
+  }
+
+  async trackVoiceCall(data: VoiceCallData): Promise<void> {
+    if (this.config.enableDebug) {
+      console.log("[Analytics] Tracking voice call:", data.sessionId);
+    }
+
+    const response = await fetch(`${this.config.endpoint}/voice-call`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${this.config.apiKey}`,
+      },
+      body: JSON.stringify(data),
+    });
+
+    if (!response.ok) {
+      const error = await response.text();
+      throw new Error(`Failed to track voice call: ${error}`);
+    }
+  }
+
+  async updateVoiceCall(sessionId: string, data: Partial<VoiceCallData>): Promise<void> {
+    if (this.config.enableDebug) {
+      console.log("[Analytics] Updating voice call:", sessionId);
+    }
+
+    const response = await fetch(`${this.config.endpoint}/voice-call/${sessionId}`, {
+      method: "PUT",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${this.config.apiKey}`,
+      },
+      body: JSON.stringify(data),
+    });
+
+    if (!response.ok) {
+      const error = await response.text();
+      throw new Error(`Failed to update voice call: ${error}`);
+    }
+  }
+
+  async flush(): Promise<void> {
+    await this.batcher.flush();
+  }
+
+  setContext(context: Partial<AnalyticsContext>): void {
+    this.context = { ...this.context, ...context };
+  }
+
+  identify(userId: string, traits?: Record<string, unknown>): void {
+    this.userId = userId;
+    this.userTraits = traits;
+  }
+
+  private enrichEvent(event: AnalyticsEvent): AnalyticsEvent {
+    return {
+      ...event,
+      workspaceId: event.workspaceId ?? this.context.workspaceId,
+      sessionId: event.sessionId ?? this.context.sessionId ?? "",
+      agentId: event.agentId ?? this.context.agentId ?? "",
+      conversationId: event.conversationId ?? this.context.conversationId,
+      timestamp: event.timestamp ?? new Date(),
+      data: {
+        ...event.data,
+        userId: event.data.userId ?? this.userId,
+        userTraits: this.userTraits,
+      },
+    };
+  }
+
+  private async sendEvents(events: AnalyticsEvent[]): Promise<void> {
+    const response = await fetch(`${this.config.endpoint}/events`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${this.config.apiKey}`,
+      },
+      body: JSON.stringify({ events }),
+    });
+
+    if (!response.ok) {
+      const error = await response.text();
+      throw new Error(`Failed to send events: ${error}`);
+    }
+  }
+
+  destroy(): void {
+    this.batcher.destroy();
+  }
+}
+
+export function createAnalyticsClient(config: AnalyticsConfig): AnalyticsClient {
+  return new AriaFlowAnalytics(config);
+}
+
+export default AriaFlowAnalytics;

package/src/react.ts

@@ -0,0 +1,282 @@
+import { useEffect, useRef, useCallback } from "react";
+import {
+  AriaFlowAnalytics,
+  createAnalyticsClient,
+  type AnalyticsConfig,
+  type AnalyticsEvent,
+  type AnalyticsContext,
+  type VoiceCallData,
+} from "./index.js";
+
+export interface UseAnalyticsOptions extends AnalyticsConfig {
+  autoFlush?: boolean;
+}
+
+let globalClient: AriaFlowAnalytics | null = null;
+
+export function initAnalytics(config: AnalyticsConfig): AriaFlowAnalytics {
+  if (globalClient) {
+    globalClient.destroy();
+  }
+  globalClient = createAnalyticsClient(config) as AriaFlowAnalytics;
+  return globalClient;
+}
+
+export function getAnalyticsClient(): AriaFlowAnalytics | null {
+  return globalClient;
+}
+
+export function useAnalytics(config?: UseAnalyticsOptions): {
+  track: (event: AnalyticsEvent) => Promise<void>;
+  trackBatch: (events: AnalyticsEvent[]) => Promise<void>;
+  trackVoiceCall: (data: VoiceCallData) => Promise<void>;
+  updateVoiceCall: (sessionId: string, data: Partial<VoiceCallData>) => Promise<void>;
+  flush: () => Promise<void>;
+  setContext: (context: Partial<AnalyticsContext>) => void;
+  identify: (userId: string, traits?: Record<string, unknown>) => void;
+} {
+  const clientRef = useRef<AriaFlowAnalytics | null>(null);
+
+  useEffect(() => {
+    if (config && !clientRef.current) {
+      clientRef.current = createAnalyticsClient(config) as AriaFlowAnalytics;
+    }
+
+    return () => {
+      if (clientRef.current) {
+        clientRef.current.destroy();
+        clientRef.current = null;
+      }
+    };
+  }, [config]);
+
+  const client = clientRef.current ?? globalClient;
+
+  const track = useCallback(
+    async (event: AnalyticsEvent) => {
+      if (!client) {
+        console.warn("[Analytics] Client not initialized");
+        return;
+      }
+      await client.track(event);
+    },
+    [client]
+  );
+
+  const trackBatch = useCallback(
+    async (events: AnalyticsEvent[]) => {
+      if (!client) {
+        console.warn("[Analytics] Client not initialized");
+        return;
+      }
+      await client.trackBatch(events);
+    },
+    [client]
+  );
+
+  const trackVoiceCall = useCallback(
+    async (data: VoiceCallData) => {
+      if (!client) {
+        console.warn("[Analytics] Client not initialized");
+        return;
+      }
+      await client.trackVoiceCall(data);
+    },
+    [client]
+  );
+
+  const updateVoiceCall = useCallback(
+    async (sessionId: string, data: Partial<VoiceCallData>) => {
+      if (!client) {
+        console.warn("[Analytics] Client not initialized");
+        return;
+      }
+      await client.updateVoiceCall(sessionId, data);
+    },
+    [client]
+  );
+
+  const flush = useCallback(async () => {
+    if (!client) {
+      console.warn("[Analytics] Client not initialized");
+      return;
+    }
+    await client.flush();
+  }, [client]);
+
+  const setContext = useCallback(
+    (context: Partial<AnalyticsContext>) => {
+      if (!client) {
+        console.warn("[Analytics] Client not initialized");
+        return;
+      }
+      client.setContext(context);
+    },
+    [client]
+  );
+
+  const identify = useCallback(
+    (userId: string, traits?: Record<string, unknown>) => {
+      if (!client) {
+        console.warn("[Analytics] Client not initialized");
+        return;
+      }
+      client.identify(userId, traits);
+    },
+    [client]
+  );
+
+  return {
+    track,
+    trackBatch,
+    trackVoiceCall,
+    updateVoiceCall,
+    flush,
+    setContext,
+    identify,
+  };
+}
+
+export function AnalyticsProvider({
+  children,
+  config,
+}: {
+  children: React.ReactNode;
+  config: AnalyticsConfig;
+}): React.ReactElement {
+  useEffect(() => {
+    initAnalytics(config);
+    return () => {
+      const client = getAnalyticsClient();
+      if (client) {
+        client.destroy();
+      }
+    };
+  }, [config]);
+
+  return children as React.ReactElement;
+}
+
+export function useTrackEvent(): (event: AnalyticsEvent) => Promise<void> {
+  const { track } = useAnalytics();
+  return track;
+}
+
+export function usePageView(pageName: string, properties?: Record<string, unknown>): void {
+  const { track } = useAnalytics();
+
+  useEffect(() => {
+    track({
+      type: "custom",
+      sessionId: "",
+      agentId: "",
+      workspaceId: "",
+      data: {
+        event: "page_view",
+        page: pageName,
+        ...properties,
+      },
+    });
+  }, [pageName, properties, track]);
+}
+
+export function useVoiceCallTracker(sessionId: string, workspaceId: string): {
+  startCall: (agentId?: string) => Promise<void>;
+  endCall: (outcome?: string, data?: Partial<VoiceCallData>) => Promise<void>;
+  trackInterruption: () => void;
+  trackUserSpeech: (durationMs: number) => void;
+  trackAgentSpeech: (durationMs: number) => void;
+} {
+  const { trackVoiceCall, updateVoiceCall } = useAnalytics();
+  const callDataRef = useRef<Partial<VoiceCallData>>({
+    sessionId,
+    workspaceId,
+    userTurns: 0,
+    agentTurns: 0,
+    interruptions: 0,
+    totalUserSpeechMs: 0,
+    totalAgentSpeechMs: 0,
+  });
+
+  const startCall = useCallback(
+    async (agentId?: string) => {
+      const data: VoiceCallData = {
+        sessionId,
+        workspaceId,
+        agentId,
+        startedAt: new Date(),
+      };
+
+      callDataRef.current = {
+        ...callDataRef.current,
+        ...data,
+      };
+
+      await trackVoiceCall(data);
+    },
+    [sessionId, workspaceId, trackVoiceCall]
+  );
+
+  const endCall = useCallback(
+    async (outcome?: string, additionalData?: Partial<VoiceCallData>) => {
+      const data: Partial<VoiceCallData> = {
+        endedAt: new Date(),
+        outcome,
+        ...callDataRef.current,
+        ...additionalData,
+      };
+
+      if (data.startedAt && data.endedAt) {
+        data.durationSeconds = Math.floor(
+          (data.endedAt.getTime() - data.startedAt.getTime()) / 1000
+        );
+      }
+
+      await updateVoiceCall(sessionId, data);
+    },
+    [sessionId, updateVoiceCall]
+  );
+
+  const trackInterruption = useCallback(() => {
+    callDataRef.current.interruptions = (callDataRef.current.interruptions ?? 0) + 1;
+    updateVoiceCall(sessionId, {
+      interruptions: callDataRef.current.interruptions,
+    });
+  }, [sessionId, updateVoiceCall]);
+
+  const trackUserSpeech = useCallback(
+    (durationMs: number) => {
+      callDataRef.current.userTurns = (callDataRef.current.userTurns ?? 0) + 1;
+      callDataRef.current.totalUserSpeechMs =
+        (callDataRef.current.totalUserSpeechMs ?? 0) + durationMs;
+
+      updateVoiceCall(sessionId, {
+        userTurns: callDataRef.current.userTurns,
+        totalUserSpeechMs: callDataRef.current.totalUserSpeechMs,
+      });
+    },
+    [sessionId, updateVoiceCall]
+  );
+
+  const trackAgentSpeech = useCallback(
+    (durationMs: number) => {
+      callDataRef.current.agentTurns = (callDataRef.current.agentTurns ?? 0) + 1;
+      callDataRef.current.totalAgentSpeechMs =
+        (callDataRef.current.totalAgentSpeechMs ?? 0) + durationMs;
+
+      updateVoiceCall(sessionId, {
+        agentTurns: callDataRef.current.agentTurns,
+        totalAgentSpeechMs: callDataRef.current.totalAgentSpeechMs,
+      });
+    },
+    [sessionId, updateVoiceCall]
+  );
+
+  return {
+    startCall,
+    endCall,
+    trackInterruption,
+    trackUserSpeech,
+    trackAgentSpeech,
+  };
+}