@aether-stack-dev/client-sdk 1.0.0

package/README.md

@@ -0,0 +1,257 @@
+# AStack Client SDK
+
+JavaScript/TypeScript SDK for integrating AStack's real-time conversational AI into web applications.
+
+## Features
+
+- 🎥 **Real-time WebRTC** - Low-latency audio/video communication
+- 🤖 **AI Conversations** - Text, voice, and video input support
+- ⚡ **<1s Latency** - Optimized for real-time interactions
+- 🔒 **Secure Sessions** - Token-based authentication
+- 📊 **Usage Tracking** - Built-in metrics and analytics
+- ⚛️ **React Support** - Hooks for easy React integration
+- 🔄 **Auto-Reconnect** - Resilient connection handling
+- 📱 **Cross-Platform** - Works in all modern browsers
+
+## Installation
+
+```bash
+npm install @astack/client-sdk
+```
+
+## Quick Start
+
+### Vanilla JavaScript
+
+```javascript
+import { AStackClient } from '@astack/client-sdk';
+
+// Initialize client
+const client = new AStackClient({
+  sessionToken: 'your-session-token',
+  userId: 'user-id'
+});
+
+// Handle events
+client.on('message', (message) => {
+  console.log('AI response:', message.text);
+});
+
+client.on('audio', (audioData) => {
+  // Handle audio response
+});
+
+// Start conversation
+await client.connect();
+
+// Send text message
+await client.sendMessage('Hello, AI assistant!');
+
+// Send audio
+await client.sendAudio(audioBlob);
+
+// Disconnect when done
+await client.disconnect();
+```
+
+### React
+
+```tsx
+import { useAStack } from '@astack/client-sdk/react';
+
+function ChatComponent() {
+  const {
+    isConnected,
+    isLoading,
+    messages,
+    sendMessage,
+    sendAudio,
+    startRecording,
+    stopRecording
+  } = useAStack({
+    sessionToken: 'your-session-token',
+    userId: 'user-id'
+  });
+
+  return (
+    <div>
+      {messages.map((msg) => (
+        <div key={msg.id}>
+          {msg.role}: {msg.text}
+        </div>
+      ))}
+      
+      <button onClick={() => sendMessage('Hello!')}>
+        Send Message
+      </button>
+    </div>
+  );
+}
+```
+
+## API Reference
+
+### AStackClient
+
+Main client class for managing AI conversations.
+
+#### Constructor
+
+```typescript
+new AStackClient(config: AStackClientConfig)
+```
+
+**Config Options:**
+- `sessionToken` (string, required) - Authentication token from developer SDK
+- `userId` (string, required) - Unique user identifier
+- `debug` (boolean) - Enable debug logging
+- `reconnectAttempts` (number) - Max reconnection attempts (default: 3)
+- `reconnectDelay` (number) - Delay between reconnects in ms (default: 1000)
+
+#### Methods
+
+- `connect()` - Establish WebRTC connection
+- `disconnect()` - Close connection and cleanup
+- `sendMessage(text: string)` - Send text message
+- `sendAudio(audio: Blob | ArrayBuffer)` - Send audio data
+- `sendVideo(video: Blob)` - Send video frame
+- `setAudioEnabled(enabled: boolean)` - Toggle audio input
+- `setVideoEnabled(enabled: boolean)` - Toggle video input
+
+#### Events
+
+- `connected` - Connection established
+- `disconnected` - Connection closed
+- `error` - Error occurred
+- `message` - Text response received
+- `audio` - Audio response received
+- `video` - Video response received
+- `usage` - Usage metrics update
+
+### React Hook
+
+```typescript
+const {
+  // State
+  isConnected,
+  isLoading,
+  error,
+  messages,
+  usage,
+  
+  // Methods
+  connect,
+  disconnect,
+  sendMessage,
+  sendAudio,
+  sendVideo,
+  startRecording,
+  stopRecording,
+  
+  // Media controls
+  setAudioEnabled,
+  setVideoEnabled
+} = useAStack(config);
+```
+
+## Advanced Usage
+
+### Custom Audio Processing
+
+```javascript
+// Configure audio constraints
+const client = new AStackClient({
+  sessionToken: 'token',
+  userId: 'user',
+  mediaConstraints: {
+    audio: {
+      echoCancellation: true,
+      noiseSuppression: true,
+      sampleRate: 48000
+    }
+  }
+});
+
+// Process audio before sending
+client.on('audioInput', (audioData) => {
+  const processed = processAudio(audioData);
+  client.sendAudio(processed);
+});
+```
+
+### Usage Monitoring
+
+```javascript
+// Monitor usage in real-time
+client.on('usage', (metrics) => {
+  console.log('Characters:', metrics.characterCount);
+  console.log('Audio minutes:', metrics.audioMinutes);
+  console.log('Session duration:', metrics.sessionDuration);
+});
+
+// Get cumulative usage
+const totalUsage = client.getUsage();
+```
+
+### Error Handling
+
+```javascript
+client.on('error', (error) => {
+  switch (error.code) {
+    case 'CONNECTION_FAILED':
+      // Handle connection errors
+      break;
+    case 'QUOTA_EXCEEDED':
+      // Handle usage limits
+      break;
+    case 'AUTHENTICATION_FAILED':
+      // Handle auth errors
+      break;
+  }
+});
+```
+
+## Browser Support
+
+- Chrome/Edge 88+
+- Firefox 78+
+- Safari 14+
+- Mobile browsers with WebRTC support
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run tests
+npm test
+
+# Build SDK
+npm run build
+
+# Development mode with watch
+npm run dev
+
+# Type checking
+npm run typecheck
+
+# Linting
+npm run lint
+```
+
+## Examples
+
+See the `examples/` directory for complete working examples:
+- `basic-usage.html` - Vanilla JavaScript implementation
+- `react-example.tsx` - React component with full UI
+
+## License
+
+MIT © AStack Team
+
+## Support
+
+- [Documentation](https://docs.astack.ai)
+- [GitHub Issues](https://github.com/aether-stack/astack-mono/issues)
+- [Discord Community](https://discord.gg/astack)

package/dist/AStackCSRClient.d.ts

@@ -0,0 +1,60 @@
+import { EventEmitter } from 'eventemitter3';
+export interface AStackCSRConfig {
+    workerUrl: string;
+    sessionToken?: string;
+    sessionId?: string;
+    sampleRate?: number;
+    providers?: {
+        asr?: 'deepinfra' | 'self';
+        llm?: 'deepinfra' | 'self';
+        tts?: 'deepinfra' | 'self';
+    };
+    fps?: number;
+    enableImageCapture?: boolean;
+    imageCaptureInterval?: number;
+}
+export interface AStackCSREvents {
+    connected: () => void;
+    disconnected: () => void;
+    error: (error: Error) => void;
+    callStarted: () => void;
+    callStopped: () => void;
+    transcript: (text: string) => void;
+    response: (text: string) => void;
+    blendshapeUpdate: (blendshapes: number[]) => void;
+    playbackStarted: () => void;
+    playbackEnded: () => void;
+    modelStatus: (status: {
+        model_loaded?: boolean;
+        blendshape_count?: number;
+    }) => void;
+}
+export type CallStatus = 'idle' | 'starting' | 'active' | 'stopping' | 'error';
+export declare class AStackCSRClient extends EventEmitter<AStackCSREvents> {
+    private config;
+    private ws;
+    private audioPlayer;
+    private audioContext;
+    private audioProcessor;
+    private mediaStream;
+    private videoRef;
+    private imageCaptureCanvas;
+    private imageCaptureInterval;
+    private callStatus;
+    private currentBlendshapes;
+    constructor(config: AStackCSRConfig);
+    private setupAudioPlayerEvents;
+    connect(): Promise<void>;
+    private handleMessage;
+    startCall(): Promise<void>;
+    private startImageCapture;
+    private captureAndSendImage;
+    stopCall(): void;
+    sendText(message: string): void;
+    disconnect(): void;
+    getCallStatus(): CallStatus;
+    getCurrentBlendshapes(): number[];
+    isConnected(): boolean;
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=AStackCSRClient.d.ts.map

package/dist/AStackCSRClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AStackCSRClient.d.ts","sourceRoot":"","sources":["../src/AStackCSRClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAI7C,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE;QACV,GAAG,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;QAC3B,GAAG,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;QAC3B,GAAG,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;KAC5B,CAAC;IACF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,gBAAgB,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAClD,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,WAAW,EAAE,CAAC,MAAM,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACtF;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;AAE/E,qBAAa,eAAgB,SAAQ,YAAY,CAAC,eAAe,CAAC;IAChE,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,cAAc,CAAiC;IACvD,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,kBAAkB,CAAkC;IAC5D,OAAO,CAAC,oBAAoB,CAA+B;IAC3D,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,kBAAkB,CAAiD;gBAE/D,MAAM,EAAE,eAAe;IAkBnC,OAAO,CAAC,sBAAsB;IAmBjB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAwCrC,OAAO,CAAC,aAAa;IA+DR,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAyEvC,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,mBAAmB;IAsBpB,QAAQ,IAAI,IAAI;IAqChB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAW/B,UAAU,IAAI,IAAI;IAQlB,aAAa,IAAI,UAAU;IAI3B,qBAAqB,IAAI,MAAM,EAAE;IAIjC,WAAW,IAAI,OAAO;IAIhB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAKtC"}

package/dist/AStackClient.d.ts

@@ -0,0 +1,90 @@
+/**
+ * @deprecated AStackClient is deprecated. Use AStackCSRClient for WebSocket-based communication.
+ * This class is kept for backwards compatibility only.
+ *
+ * Example:
+ * ```typescript
+ * import { AStackCSRClient } from '@astack/client-sdk';
+ * const client = new AStackCSRClient({ apiEndpoint: 'https://api.astack.com' });
+ * ```
+ */
+import { EventEmitter } from 'eventemitter3';
+import { ConnectionState, ConnectionQuality } from './ConnectionStateManager';
+import { AStackConfig, SessionStatus, MediaStreamInfo, AStackEventName, AStackEventHandler, UsageMetrics, BillingInfo, PerformanceMetrics, PerformanceBenchmark, WorkerPreferences, WorkerInfo } from './types';
+export declare class AStackClient extends EventEmitter {
+    private config;
+    private webrtc;
+    private signaling;
+    private sessionManager;
+    private usageTracker;
+    private billingMonitor;
+    private securityLogger;
+    private connectionStateManager;
+    private performanceMonitor;
+    private analyticsCollector;
+    private mediaController;
+    private sessionId;
+    private status;
+    private statsCollectionTimer?;
+    localVideoRef: HTMLVideoElement | null;
+    remoteVideoRef: HTMLVideoElement | null;
+    constructor(config: AStackConfig);
+    private initEventHandlers;
+    private startWebRTCStatsCollection;
+    private stopWebRTCStatsCollection;
+    private processWebRTCStats;
+    connect(): Promise<void>;
+    startVideo(): Promise<MediaStream>;
+    stopVideo(): Promise<void>;
+    startAudio(): Promise<MediaStream>;
+    stopAudio(): Promise<void>;
+    sendText(message: string): Promise<void>;
+    sendAudio(audioBlob: Blob): Promise<void>;
+    startRecording(): void;
+    stopRecording(): void;
+    getDevices(): Promise<MediaDeviceInfo[]>;
+    switchCamera(deviceId: string): Promise<void>;
+    switchMicrophone(deviceId: string): Promise<void>;
+    muteAudio(): void;
+    unmuteAudio(): void;
+    pauseVideo(): void;
+    resumeVideo(): void;
+    getSessionStatus(): SessionStatus;
+    getLocalStreams(): MediaStreamInfo[];
+    getRemoteStreams(): MediaStreamInfo[];
+    attachVideo(localVideo: HTMLVideoElement, remoteVideo: HTMLVideoElement): void;
+    addEventListener<T extends AStackEventName>(event: T, listener: AStackEventHandler<T>): this;
+    removeEventListener<T extends AStackEventName>(event: T, listener: AStackEventHandler<T>): this;
+    disconnect(): Promise<void>;
+    renewSession(): Promise<void>;
+    getSessionTimeRemaining(): number;
+    isSessionValid(): boolean;
+    getUsageMetrics(): UsageMetrics | null;
+    trackQualityScore(score: number): void;
+    getBillingInfo(): Promise<BillingInfo>;
+    getCurrentBillingInfo(): BillingInfo | undefined;
+    setBillingWarningThresholds(thresholds: {
+        creditBalance?: number;
+        usagePercentage?: number;
+    }): void;
+    getConnectionState(): ConnectionState;
+    getConnectionQuality(): ConnectionQuality;
+    isHealthy(): boolean;
+    getConnectionHistory(): Array<{
+        state: ConnectionState;
+        timestamp: Date;
+    }>;
+    getPerformanceMetrics(): PerformanceMetrics;
+    getPerformanceBenchmarks(): PerformanceBenchmark[];
+    recordPerformanceBenchmark(benchmark: Omit<PerformanceBenchmark, 'timestamp'>): void;
+    recordLatency(type: 'signaling' | 'webrtc' | 'audio' | 'video', latency: number): void;
+    reportPerformanceMetrics(): Promise<void>;
+    setWorkerPreferences(preferences: WorkerPreferences): void;
+    getWorkerPreferences(): WorkerPreferences | undefined;
+    getAssignedWorkerInfo(): WorkerInfo | undefined;
+    trackEvent(eventType: string, metadata?: Record<string, any>): void;
+    getSessionAnalytics(): any;
+    flushAnalytics(): Promise<void>;
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=AStackClient.d.ts.map

package/dist/AStackClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AStackClient.d.ts","sourceRoot":"","sources":["../src/AStackClient.ts"],"names":[],"mappings":"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"}

package/dist/AStackEventSetup.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @deprecated This module is deprecated. Use AStackCSRClient for WebSocket-based communication.
+ * This file is kept for backwards compatibility only.
+ */
+import { WebRTCManager } from './WebRTCManager';
+import { SupabaseSignalingClient } from './SupabaseSignalingClient';
+import { UsageTracker } from './UsageTracker';
+import { ConnectionStateManager } from './ConnectionStateManager';
+import { AnalyticsCollector } from './AnalyticsCollector';
+import { SecurityLogger } from './SecurityLogger';
+import { PerformanceMonitor } from './PerformanceMonitor';
+import { SessionStatus } from './types';
+import { EventEmitter } from 'eventemitter3';
+export interface EventSetupDependencies {
+    webrtc: WebRTCManager;
+    signaling: SupabaseSignalingClient;
+    connectionStateManager: ConnectionStateManager;
+    analyticsCollector: AnalyticsCollector;
+    securityLogger: SecurityLogger;
+    performanceMonitor: PerformanceMonitor;
+    getUsageTracker: () => UsageTracker | null;
+    setUsageTracker: (tracker: UsageTracker) => void;
+    getSessionId: () => string | null;
+    getStatus: () => SessionStatus;
+    setStatus: (status: Partial<SessionStatus>) => void;
+    localVideoRef: HTMLVideoElement | null;
+    remoteVideoRef: HTMLVideoElement | null;
+    startStatsCollection: () => void;
+    stopStatsCollection: () => void;
+}
+/**
+ * @deprecated Use AStackCSRClient instead. This function is kept for backwards compatibility.
+ */
+export declare function setupEventHandlers(emitter: EventEmitter, deps: EventSetupDependencies): void;
+//# sourceMappingURL=AStackEventSetup.d.ts.map

package/dist/AStackEventSetup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AStackEventSetup.d.ts","sourceRoot":"","sources":["../src/AStackEventSetup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAuC,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,uBAAuB,CAAC;IACnC,sBAAsB,EAAE,sBAAsB,CAAC;IAC/C,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,cAAc,EAAE,cAAc,CAAC;IAC/B,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,eAAe,EAAE,MAAM,YAAY,GAAG,IAAI,CAAC;IAC3C,eAAe,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;IACjD,YAAY,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAClC,SAAS,EAAE,MAAM,aAAa,CAAC;IAC/B,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,KAAK,IAAI,CAAC;IACpD,aAAa,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACvC,cAAc,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACxC,oBAAoB,EAAE,MAAM,IAAI,CAAC;IACjC,mBAAmB,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,sBAAsB,GAC3B,IAAI,CA0EN"}

package/dist/AStackMediaController.d.ts

@@ -0,0 +1,34 @@
+import { EventEmitter } from 'eventemitter3';
+import { WebRTCManager } from './WebRTCManager';
+import { SupabaseSignalingClient } from './SupabaseSignalingClient';
+import { AnalyticsCollector } from './AnalyticsCollector';
+import { AStackConfig, MediaStreamInfo } from './types';
+export declare class AStackMediaController {
+    private webrtc;
+    private signaling;
+    private analyticsCollector;
+    private config;
+    private emitter;
+    private audioRecorder;
+    private isRecording;
+    constructor(webrtc: WebRTCManager, signaling: SupabaseSignalingClient, analyticsCollector: AnalyticsCollector, config: AStackConfig, emitter: EventEmitter);
+    startVideo(): Promise<MediaStream>;
+    stopVideo(localVideoRef: HTMLVideoElement | null): Promise<void>;
+    startAudio(): Promise<MediaStream>;
+    stopAudio(): Promise<void>;
+    sendText(message: string): Promise<void>;
+    sendAudio(audioBlob: Blob): Promise<void>;
+    startRecording(): void;
+    stopRecording(): void;
+    getIsRecording(): boolean;
+    getDevices(): Promise<MediaDeviceInfo[]>;
+    switchCamera(deviceId: string): Promise<void>;
+    switchMicrophone(deviceId: string): Promise<void>;
+    muteAudio(): void;
+    unmuteAudio(): void;
+    pauseVideo(): void;
+    resumeVideo(): void;
+    getLocalStreams(): MediaStreamInfo[];
+    getRemoteStreams(): MediaStreamInfo[];
+}
+//# sourceMappingURL=AStackMediaController.d.ts.map

package/dist/AStackMediaController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AStackMediaController.d.ts","sourceRoot":"","sources":["../src/AStackMediaController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAA2B,eAAe,EAAE,MAAM,SAAS,CAAC;AAEjF,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,WAAW,CAAkB;gBAGnC,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,uBAAuB,EAClC,kBAAkB,EAAE,kBAAkB,EACtC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,YAAY;IASjB,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;IAgBlC,SAAS,CAAC,aAAa,EAAE,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAahE,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;IAgBlC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAa1B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYxC,SAAS,CAAC,SAAS,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/C,cAAc,IAAI,IAAI;IAsBtB,aAAa,IAAI,IAAI;IAOrB,cAAc,IAAI,OAAO;IAInB,UAAU,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAIxC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,SAAS,IAAI,IAAI;IAIjB,WAAW,IAAI,IAAI;IAInB,UAAU,IAAI,IAAI;IAIlB,WAAW,IAAI,IAAI;IAInB,eAAe,IAAI,eAAe,EAAE;IAIpC,gBAAgB,IAAI,eAAe,EAAE;CAGtC"}

package/dist/AnalyticsCollector.d.ts

@@ -0,0 +1,63 @@
+import { EventEmitter } from 'eventemitter3';
+export interface AnalyticsEvent {
+    eventType: string;
+    timestamp: Date;
+    sessionId?: string;
+    userId?: string;
+    organizationId?: string;
+    metadata: Record<string, any>;
+}
+export interface SessionAnalytics {
+    sessionId: string;
+    startTime: Date;
+    endTime?: Date;
+    duration: number;
+    eventsCount: number;
+    errorCount: number;
+    mediaTypes: string[];
+    connectionQuality: number;
+    dataTransferred: {
+        audio: {
+            sent: number;
+            received: number;
+        };
+        video: {
+            sent: number;
+            received: number;
+        };
+        text: {
+            sent: number;
+            received: number;
+        };
+    };
+}
+export interface AnalyticsCollectorConfig {
+    enableAutoFlush?: boolean;
+    flushInterval?: number;
+    batchSize?: number;
+    apiEndpoint: string;
+    apiKey: string;
+    sessionId?: string;
+    userId?: string;
+    organizationId?: string;
+}
+export declare class AnalyticsCollector extends EventEmitter {
+    private config;
+    private events;
+    private sessionAnalytics;
+    private flushTimer?;
+    private isCollecting;
+    constructor(config: AnalyticsCollectorConfig);
+    startSession(sessionId: string): void;
+    endSession(): void;
+    trackEvent(eventType: string, metadata?: Record<string, any>): void;
+    updateMediaTypes(mediaTypes: string[]): void;
+    updateConnectionQuality(quality: number): void;
+    updateDataTransferred(type: 'audio' | 'video' | 'text', direction: 'sent' | 'received', bytes: number): void;
+    getSessionAnalytics(): SessionAnalytics | null;
+    getEvents(): AnalyticsEvent[];
+    flush(): Promise<void>;
+    private sendSessionAnalytics;
+    destroy(): void;
+}
+//# sourceMappingURL=AnalyticsCollector.d.ts.map

package/dist/AnalyticsCollector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsCollector.d.ts","sourceRoot":"","sources":["../src/AnalyticsCollector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE;QACf,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC;QAC1C,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC;QAC1C,IAAI,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC;KAC1C,CAAC;CACH;AAED,MAAM,WAAW,wBAAwB;IACvC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,OAAO,CAAC,MAAM,CAAqC;IACnD,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,gBAAgB,CAAiC;IACzD,OAAO,CAAC,UAAU,CAAC,CAAiB;IACpC,OAAO,CAAC,YAAY,CAAS;gBAEjB,MAAM,EAAE,wBAAwB;IAarC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAgCrC,UAAU,IAAI,IAAI;IAsBlB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,IAAI;IA2BvE,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI;IAM5C,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQ9C,qBAAqB,CAC1B,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,EAChC,SAAS,EAAE,MAAM,GAAG,UAAU,EAC9B,KAAK,EAAE,MAAM,GACZ,IAAI;IAMA,mBAAmB,IAAI,gBAAgB,GAAG,IAAI;IAW9C,SAAS,IAAI,cAAc,EAAE;IAIvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YA6BrB,oBAAoB;IAuB3B,OAAO,IAAI,IAAI;CAcvB"}

package/dist/BillingMonitor.d.ts

@@ -0,0 +1,35 @@
+import { BillingInfo } from './types';
+export interface BillingUpdateCallback {
+    (info: BillingInfo): void;
+}
+export interface BillingAlertCallback {
+    (alert: {
+        type: 'low_balance' | 'limit_exceeded';
+        details: any;
+    }): void;
+}
+export declare class BillingMonitor {
+    private apiEndpoint;
+    private apiKey;
+    private billingInfo?;
+    private updateCallbacks;
+    private alertCallbacks;
+    private checkInterval?;
+    private warningThresholds;
+    constructor(apiEndpoint: string, apiKey: string);
+    fetchBillingInfo(): Promise<BillingInfo>;
+    private updateBillingInfo;
+    private checkForAlerts;
+    private triggerAlert;
+    startMonitoring(intervalMs?: number): void;
+    stopMonitoring(): void;
+    onUpdate(callback: BillingUpdateCallback): void;
+    onAlert(callback: BillingAlertCallback): void;
+    removeUpdateCallback(callback: BillingUpdateCallback): void;
+    removeAlertCallback(callback: BillingAlertCallback): void;
+    getCurrentBillingInfo(): BillingInfo | undefined;
+    setWarningThresholds(thresholds: Partial<typeof this.warningThresholds>): void;
+    checkRateLimit(): Promise<boolean>;
+    destroy(): void;
+}
+//# sourceMappingURL=BillingMonitor.d.ts.map

package/dist/BillingMonitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BillingMonitor.d.ts","sourceRoot":"","sources":["../src/BillingMonitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,MAAM,WAAW,qBAAqB;IACpC,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,aAAa,GAAG,gBAAgB,CAAC;QAAC,OAAO,EAAE,GAAG,CAAA;KAAE,GAAG,IAAI,CAAC;CACzE;AAED,qBAAa,cAAc;IAUb,OAAO,CAAC,WAAW;IAAU,OAAO,CAAC,MAAM;IATvD,OAAO,CAAC,WAAW,CAAC,CAAc;IAClC,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,aAAa,CAAC,CAAiB;IACvC,OAAO,CAAC,iBAAiB,CAGvB;gBAEkB,WAAW,EAAE,MAAM,EAAU,MAAM,EAAE,MAAM;IAEzD,gBAAgB,IAAI,OAAO,CAAC,WAAW,CAAC;IAqB9C,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,cAAc;IAmCtB,OAAO,CAAC,YAAY;IAIpB,eAAe,CAAC,UAAU,GAAE,MAAc,GAAG,IAAI;IAUjD,cAAc,IAAI,IAAI;IAOtB,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI;IAI/C,OAAO,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAI7C,oBAAoB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI;IAI3D,mBAAmB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAIzD,qBAAqB,IAAI,WAAW,GAAG,SAAS;IAIhD,oBAAoB,CAAC,UAAU,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC,iBAAiB,CAAC,GAAG,IAAI;IAIxE,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAKxC,OAAO,IAAI,IAAI;CAKhB"}

package/dist/ConnectionStateManager.d.ts

@@ -0,0 +1,48 @@
+import { EventEmitter } from 'eventemitter3';
+export interface ConnectionState {
+    signaling: 'disconnected' | 'connecting' | 'connected' | 'reconnecting';
+    websocket: 'new' | 'connecting' | 'connected' | 'disconnected' | 'failed' | 'closed';
+    overall: 'disconnected' | 'connecting' | 'connected' | 'degraded' | 'error';
+    lastActivity: Date;
+    reconnectAttempts: number;
+    errors: Error[];
+}
+export interface ConnectionQuality {
+    latency?: number;
+    jitter?: number;
+    packetLoss?: number;
+    bandwidth?: number;
+    qualityScore: number;
+}
+export declare class ConnectionStateManager extends EventEmitter {
+    private state;
+    private quality;
+    private healthCheckInterval?;
+    private stateHistory;
+    private maxHistorySize;
+    constructor();
+    updateSignalingState(state: ConnectionState['signaling']): void;
+    updateWebSocketState(state: ConnectionState['websocket']): void;
+    updateWebRTCState(state: string): void;
+    updateICEState(state: string): void;
+    private updateOverallState;
+    addError(error: Error): void;
+    clearErrors(): void;
+    updateConnectionQuality(stats: Partial<ConnectionQuality>): void;
+    private calculateQualityScore;
+    startHealthCheck(intervalMs?: number): void;
+    stopHealthCheck(): void;
+    private addToHistory;
+    getState(): ConnectionState;
+    getQuality(): ConnectionQuality;
+    getStateHistory(): Array<{
+        state: ConnectionState;
+        timestamp: Date;
+    }>;
+    isConnected(): boolean;
+    isHealthy(): boolean;
+    getReconnectAttempts(): number;
+    reset(): void;
+    destroy(): void;
+}
+//# sourceMappingURL=ConnectionStateManager.d.ts.map

package/dist/ConnectionStateManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectionStateManager.d.ts","sourceRoot":"","sources":["../src/ConnectionStateManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,CAAC;IACxE,SAAS,EAAE,KAAK,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACrF,OAAO,EAAE,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;IAC5E,YAAY,EAAE,IAAI,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,sBAAuB,SAAQ,YAAY;IACtD,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,mBAAmB,CAAC,CAAiB;IAC7C,OAAO,CAAC,YAAY,CAA0D;IAC9E,OAAO,CAAC,cAAc,CAAO;;IAmB7B,oBAAoB,CAAC,KAAK,EAAE,eAAe,CAAC,WAAW,CAAC,GAAG,IAAI;IAmB/D,oBAAoB,CAAC,KAAK,EAAE,eAAe,CAAC,WAAW,CAAC,GAAG,IAAI;IAa/D,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAItC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAInC,OAAO,CAAC,kBAAkB;IAsB1B,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAS5B,WAAW,IAAI,IAAI;IAKnB,uBAAuB,CAAC,KAAK,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI;IAehE,OAAO,CAAC,qBAAqB;IAuC7B,gBAAgB,CAAC,UAAU,GAAE,MAAa,GAAG,IAAI;IAYjD,eAAe,IAAI,IAAI;IAOvB,OAAO,CAAC,YAAY;IAWpB,QAAQ,IAAI,eAAe;IAI3B,UAAU,IAAI,iBAAiB;IAI/B,eAAe,IAAI,KAAK,CAAC;QAAE,KAAK,EAAE,eAAe,CAAC;QAAC,SAAS,EAAE,IAAI,CAAA;KAAE,CAAC;IAIrE,WAAW,IAAI,OAAO;IAItB,SAAS,IAAI,OAAO;IAMpB,oBAAoB,IAAI,MAAM;IAI9B,KAAK,IAAI,IAAI;IAkBb,OAAO,IAAI,IAAI;CAIhB"}