@anganyai/voice-sdk 0.0.6 → 0.0.8

package/dist/index.d.cts

@@ -1,6 +1,154 @@
+/**
+ * Simple event emitter implementation for the SDK
+ *
+ * Provides a lightweight event system without external dependencies.
+ * Supports typed events for better developer experience.
+ *
+ * @example
+ * ```typescript
+ * interface MyEvents {
+ *   data: [value: string];
+ *   error: [error: Error];
+ *   ready: [];
+ * }
+ *
+ * class MyClass extends EventEmitter<MyEvents> {
+ *   doSomething() {
+ *     this.emit('data', 'hello');
+ *     this.emit('error', new Error('oops'));
+ *     this.emit('ready');
+ *   }
+ * }
+ * ```
+ */
+declare class EventEmitter<T extends Record<string, unknown[]>> {
+    private listeners;
+    /**
+     * Register an event listener
+     *
+     * @param event - Event name
+     * @param handler - Event handler function
+     *
+     * @example
+     * ```typescript
+     * emitter.on('data', (value) => {
+     *   console.log('Received:', value);
+     * });
+     * ```
+     */
+    on<K extends keyof T>(event: K, handler: (...args: T[K]) => void): void;
+    /**
+     * Unregister an event listener
+     *
+     * @param event - Event name
+     * @param handler - Event handler function to remove
+     *
+     * @example
+     * ```typescript
+     * const handler = (value) => console.log(value);
+     * emitter.on('data', handler);
+     * emitter.off('data', handler);
+     * ```
+     */
+    off<K extends keyof T>(event: K, handler: (...args: T[K]) => void): void;
+    /**
+     * Register a one-time event listener
+     *
+     * The handler will be automatically removed after the first call.
+     *
+     * @param event - Event name
+     * @param handler - Event handler function
+     *
+     * @example
+     * ```typescript
+     * emitter.once('ready', () => {
+     *   console.log('Ready! This will only fire once');
+     * });
+     * ```
+     */
+    once<K extends keyof T>(event: K, handler: (...args: T[K]) => void): void;
+    /**
+     * Emit an event
+     *
+     * Calls all registered handlers for the event in the order they were registered.
+     *
+     * @param event - Event name
+     * @param args - Arguments to pass to event handlers
+     *
+     * @example
+     * ```typescript
+     * emitter.emit('data', 'hello world');
+     * emitter.emit('error', new Error('Something went wrong'));
+     * ```
+     */
+    emit<K extends keyof T>(event: K, ...args: T[K]): void;
+    /**
+     * Remove all listeners for an event or all events
+     *
+     * @param event - Event name (optional). If not provided, removes all listeners.
+     *
+     * @example
+     * ```typescript
+     * // Remove all listeners for 'data' event
+     * emitter.removeAllListeners('data');
+     *
+     * // Remove all listeners for all events
+     * emitter.removeAllListeners();
+     * ```
+     */
+    removeAllListeners(event?: keyof T): void;
+    /**
+     * Get the number of listeners for an event
+     *
+     * @param event - Event name
+     * @returns Number of registered listeners
+     *
+     * @example
+     * ```typescript
+     * const count = emitter.listenerCount('data');
+     * console.log(`There are ${count} data listeners`);
+     * ```
+     */
+    listenerCount(event: keyof T): number;
+    /**
+     * Get all event names that have listeners
+     *
+     * @returns Array of event names
+     *
+     * @example
+     * ```typescript
+     * const events = emitter.eventNames();
+     * console.log('Active events:', events);
+     * ```
+     */
+    eventNames(): (keyof T)[];
+}
+
+/**
+ * Service for handling SSE transcription streaming
+ * Supports both Web Streams API (browser) and EventSource (React Native)
+ */
+
+/**
+ * EventSource-like interface for React Native SSE libraries
+ */
+interface EventSourceLike {
+    addEventListener(type: string, listener: (event: any) => void): void;
+    removeAllEventListeners(): void;
+    close(): void;
+}
+/**
+ * Factory function to create EventSource instances
+ * Used for React Native where native EventSource doesn't support headers
+ */
+type EventSourceFactory = (url: string, options: {
+    headers: Record<string, string>;
+}) => EventSourceLike;
+
 /**
  * Core type definitions for Angany Voice SDK
  */
+
 /**
  * SDK configuration options
  */
@@ -59,6 +207,12 @@ interface VoiceConfig {
      * Platform-specific configuration
      */
     platform?: PlatformConfig;
+    /**
+     * EventSource factory for React Native environments
+     * When provided, uses EventSource instead of fetch streams for SSE
+     * Required for React Native as it doesn't support Web Streams API
+     */
+    eventSourceFactory?: EventSourceFactory;
 }
 /**
  * Log levels
@@ -203,132 +357,6 @@ interface ResourceConfig {
     custom?: Record<string, unknown>;
 }
 
-/**
- * Simple event emitter implementation for the SDK
- *
- * Provides a lightweight event system without external dependencies.
- * Supports typed events for better developer experience.
- *
- * @example
- * ```typescript
- * interface MyEvents {
- *   data: [value: string];
- *   error: [error: Error];
- *   ready: [];
- * }
- *
- * class MyClass extends EventEmitter<MyEvents> {
- *   doSomething() {
- *     this.emit('data', 'hello');
- *     this.emit('error', new Error('oops'));
- *     this.emit('ready');
- *   }
- * }
- * ```
- */
-declare class EventEmitter<T extends Record<string, unknown[]>> {
-    private listeners;
-    /**
-     * Register an event listener
-     *
-     * @param event - Event name
-     * @param handler - Event handler function
-     *
-     * @example
-     * ```typescript
-     * emitter.on('data', (value) => {
-     *   console.log('Received:', value);
-     * });
-     * ```
-     */
-    on<K extends keyof T>(event: K, handler: (...args: T[K]) => void): void;
-    /**
-     * Unregister an event listener
-     *
-     * @param event - Event name
-     * @param handler - Event handler function to remove
-     *
-     * @example
-     * ```typescript
-     * const handler = (value) => console.log(value);
-     * emitter.on('data', handler);
-     * emitter.off('data', handler);
-     * ```
-     */
-    off<K extends keyof T>(event: K, handler: (...args: T[K]) => void): void;
-    /**
-     * Register a one-time event listener
-     *
-     * The handler will be automatically removed after the first call.
-     *
-     * @param event - Event name
-     * @param handler - Event handler function
-     *
-     * @example
-     * ```typescript
-     * emitter.once('ready', () => {
-     *   console.log('Ready! This will only fire once');
-     * });
-     * ```
-     */
-    once<K extends keyof T>(event: K, handler: (...args: T[K]) => void): void;
-    /**
-     * Emit an event
-     *
-     * Calls all registered handlers for the event in the order they were registered.
-     *
-     * @param event - Event name
-     * @param args - Arguments to pass to event handlers
-     *
-     * @example
-     * ```typescript
-     * emitter.emit('data', 'hello world');
-     * emitter.emit('error', new Error('Something went wrong'));
-     * ```
-     */
-    emit<K extends keyof T>(event: K, ...args: T[K]): void;
-    /**
-     * Remove all listeners for an event or all events
-     *
-     * @param event - Event name (optional). If not provided, removes all listeners.
-     *
-     * @example
-     * ```typescript
-     * // Remove all listeners for 'data' event
-     * emitter.removeAllListeners('data');
-     *
-     * // Remove all listeners for all events
-     * emitter.removeAllListeners();
-     * ```
-     */
-    removeAllListeners(event?: keyof T): void;
-    /**
-     * Get the number of listeners for an event
-     *
-     * @param event - Event name
-     * @returns Number of registered listeners
-     *
-     * @example
-     * ```typescript
-     * const count = emitter.listenerCount('data');
-     * console.log(`There are ${count} data listeners`);
-     * ```
-     */
-    listenerCount(event: keyof T): number;
-    /**
-     * Get all event names that have listeners
-     *
-     * @returns Array of event names
-     *
-     * @example
-     * ```typescript
-     * const events = emitter.eventNames();
-     * console.log('Active events:', events);
-     * ```
-     */
-    eventNames(): (keyof T)[];
-}
-
 /**
  * Authentication type definitions for Angany Voice SDK
  */
@@ -1355,6 +1383,11 @@ declare class Conversation extends EventEmitter<ConversationEvents> {
     private ephemeralCredentials?;
     private accessToken?;
     constructor(id: string, options: ConversationOptions, authManager: AuthManager, urls: ConversationUrls);
+    /**
+     * Set EventSource factory for React Native environments
+     * Call this before initialize() to use EventSource instead of fetch streams for SSE
+     */
+    setEventSourceFactory(factory: EventSourceFactory): void;
     /**
      * Initialize and start the conversation
      */
@@ -1774,4 +1807,4 @@ declare function hasErrorCode(error: unknown, code: string): boolean;
  */
 declare const VERSION = "0.0.2";
 
-export { AnganyError, AnganyVoice, type AuthError, type AuthEvents, AuthManager, type AuthOptions, type AuthState, type AuthStatus, AuthenticationError, type BackendAuthOptions, type ClientCredentials, ConfigurationError, Conversation, ConversationError, type ConversationOptions, type ConversationState, type ConversationStatus, type ConversationUrls, ErrorCodes, EventEmitter, type FrontendAuthOptions, type LogLevel, MediaError, NetworkError, PermissionError, ResourceError, type ServiceAccountAuthOptions, type ServiceAccountCredentials, type SpeakOptions, type TokenSet, type TranscriptionEvent, type UserInfo, VERSION, ValidationError, type VoiceConfig, type VoiceResource, hasErrorCode, isAnganyError };
+export { AnganyError, AnganyVoice, type AuthError, type AuthEvents, AuthManager, type AuthOptions, type AuthState, type AuthStatus, AuthenticationError, type BackendAuthOptions, type ClientCredentials, ConfigurationError, Conversation, ConversationError, type ConversationOptions, type ConversationState, type ConversationStatus, type ConversationUrls, ErrorCodes, EventEmitter, type EventSourceFactory, type EventSourceLike, type FrontendAuthOptions, type LogLevel, MediaError, NetworkError, PermissionError, ResourceError, type ServiceAccountAuthOptions, type ServiceAccountCredentials, type SpeakOptions, type TokenSet, type TranscriptionEvent, type UserInfo, VERSION, ValidationError, type VoiceConfig, type VoiceResource, hasErrorCode, isAnganyError };

package/dist/index.d.ts

@@ -1,6 +1,154 @@
+/**
+ * Simple event emitter implementation for the SDK
+ *
+ * Provides a lightweight event system without external dependencies.
+ * Supports typed events for better developer experience.
+ *
+ * @example
+ * ```typescript
+ * interface MyEvents {
+ *   data: [value: string];
+ *   error: [error: Error];
+ *   ready: [];
+ * }
+ *
+ * class MyClass extends EventEmitter<MyEvents> {
+ *   doSomething() {
+ *     this.emit('data', 'hello');
+ *     this.emit('error', new Error('oops'));
+ *     this.emit('ready');
+ *   }
+ * }
+ * ```
+ */
+declare class EventEmitter<T extends Record<string, unknown[]>> {
+    private listeners;
+    /**
+     * Register an event listener
+     *
+     * @param event - Event name
+     * @param handler - Event handler function
+     *
+     * @example
+     * ```typescript
+     * emitter.on('data', (value) => {
+     *   console.log('Received:', value);
+     * });
+     * ```
+     */
+    on<K extends keyof T>(event: K, handler: (...args: T[K]) => void): void;
+    /**
+     * Unregister an event listener
+     *
+     * @param event - Event name
+     * @param handler - Event handler function to remove
+     *
+     * @example
+     * ```typescript
+     * const handler = (value) => console.log(value);
+     * emitter.on('data', handler);
+     * emitter.off('data', handler);
+     * ```
+     */
+    off<K extends keyof T>(event: K, handler: (...args: T[K]) => void): void;
+    /**
+     * Register a one-time event listener
+     *
+     * The handler will be automatically removed after the first call.
+     *
+     * @param event - Event name
+     * @param handler - Event handler function
+     *
+     * @example
+     * ```typescript
+     * emitter.once('ready', () => {
+     *   console.log('Ready! This will only fire once');
+     * });
+     * ```
+     */
+    once<K extends keyof T>(event: K, handler: (...args: T[K]) => void): void;
+    /**
+     * Emit an event
+     *
+     * Calls all registered handlers for the event in the order they were registered.
+     *
+     * @param event - Event name
+     * @param args - Arguments to pass to event handlers
+     *
+     * @example
+     * ```typescript
+     * emitter.emit('data', 'hello world');
+     * emitter.emit('error', new Error('Something went wrong'));
+     * ```
+     */
+    emit<K extends keyof T>(event: K, ...args: T[K]): void;
+    /**
+     * Remove all listeners for an event or all events
+     *
+     * @param event - Event name (optional). If not provided, removes all listeners.
+     *
+     * @example
+     * ```typescript
+     * // Remove all listeners for 'data' event
+     * emitter.removeAllListeners('data');
+     *
+     * // Remove all listeners for all events
+     * emitter.removeAllListeners();
+     * ```
+     */
+    removeAllListeners(event?: keyof T): void;
+    /**
+     * Get the number of listeners for an event
+     *
+     * @param event - Event name
+     * @returns Number of registered listeners
+     *
+     * @example
+     * ```typescript
+     * const count = emitter.listenerCount('data');
+     * console.log(`There are ${count} data listeners`);
+     * ```
+     */
+    listenerCount(event: keyof T): number;
+    /**
+     * Get all event names that have listeners
+     *
+     * @returns Array of event names
+     *
+     * @example
+     * ```typescript
+     * const events = emitter.eventNames();
+     * console.log('Active events:', events);
+     * ```
+     */
+    eventNames(): (keyof T)[];
+}
+
+/**
+ * Service for handling SSE transcription streaming
+ * Supports both Web Streams API (browser) and EventSource (React Native)
+ */
+
+/**
+ * EventSource-like interface for React Native SSE libraries
+ */
+interface EventSourceLike {
+    addEventListener(type: string, listener: (event: any) => void): void;
+    removeAllEventListeners(): void;
+    close(): void;
+}
+/**
+ * Factory function to create EventSource instances
+ * Used for React Native where native EventSource doesn't support headers
+ */
+type EventSourceFactory = (url: string, options: {
+    headers: Record<string, string>;
+}) => EventSourceLike;
+
 /**
  * Core type definitions for Angany Voice SDK
  */
+
 /**
  * SDK configuration options
  */
@@ -59,6 +207,12 @@ interface VoiceConfig {
      * Platform-specific configuration
      */
     platform?: PlatformConfig;
+    /**
+     * EventSource factory for React Native environments
+     * When provided, uses EventSource instead of fetch streams for SSE
+     * Required for React Native as it doesn't support Web Streams API
+     */
+    eventSourceFactory?: EventSourceFactory;
 }
 /**
  * Log levels
@@ -203,132 +357,6 @@ interface ResourceConfig {
     custom?: Record<string, unknown>;
 }
 
-/**
- * Simple event emitter implementation for the SDK
- *
- * Provides a lightweight event system without external dependencies.
- * Supports typed events for better developer experience.
- *
- * @example
- * ```typescript
- * interface MyEvents {
- *   data: [value: string];
- *   error: [error: Error];
- *   ready: [];
- * }
- *
- * class MyClass extends EventEmitter<MyEvents> {
- *   doSomething() {
- *     this.emit('data', 'hello');
- *     this.emit('error', new Error('oops'));
- *     this.emit('ready');
- *   }
- * }
- * ```
- */
-declare class EventEmitter<T extends Record<string, unknown[]>> {
-    private listeners;
-    /**
-     * Register an event listener
-     *
-     * @param event - Event name
-     * @param handler - Event handler function
-     *
-     * @example
-     * ```typescript
-     * emitter.on('data', (value) => {
-     *   console.log('Received:', value);
-     * });
-     * ```
-     */
-    on<K extends keyof T>(event: K, handler: (...args: T[K]) => void): void;
-    /**
-     * Unregister an event listener
-     *
-     * @param event - Event name
-     * @param handler - Event handler function to remove
-     *
-     * @example
-     * ```typescript
-     * const handler = (value) => console.log(value);
-     * emitter.on('data', handler);
-     * emitter.off('data', handler);
-     * ```
-     */
-    off<K extends keyof T>(event: K, handler: (...args: T[K]) => void): void;
-    /**
-     * Register a one-time event listener
-     *
-     * The handler will be automatically removed after the first call.
-     *
-     * @param event - Event name
-     * @param handler - Event handler function
-     *
-     * @example
-     * ```typescript
-     * emitter.once('ready', () => {
-     *   console.log('Ready! This will only fire once');
-     * });
-     * ```
-     */
-    once<K extends keyof T>(event: K, handler: (...args: T[K]) => void): void;
-    /**
-     * Emit an event
-     *
-     * Calls all registered handlers for the event in the order they were registered.
-     *
-     * @param event - Event name
-     * @param args - Arguments to pass to event handlers
-     *
-     * @example
-     * ```typescript
-     * emitter.emit('data', 'hello world');
-     * emitter.emit('error', new Error('Something went wrong'));
-     * ```
-     */
-    emit<K extends keyof T>(event: K, ...args: T[K]): void;
-    /**
-     * Remove all listeners for an event or all events
-     *
-     * @param event - Event name (optional). If not provided, removes all listeners.
-     *
-     * @example
-     * ```typescript
-     * // Remove all listeners for 'data' event
-     * emitter.removeAllListeners('data');
-     *
-     * // Remove all listeners for all events
-     * emitter.removeAllListeners();
-     * ```
-     */
-    removeAllListeners(event?: keyof T): void;
-    /**
-     * Get the number of listeners for an event
-     *
-     * @param event - Event name
-     * @returns Number of registered listeners
-     *
-     * @example
-     * ```typescript
-     * const count = emitter.listenerCount('data');
-     * console.log(`There are ${count} data listeners`);
-     * ```
-     */
-    listenerCount(event: keyof T): number;
-    /**
-     * Get all event names that have listeners
-     *
-     * @returns Array of event names
-     *
-     * @example
-     * ```typescript
-     * const events = emitter.eventNames();
-     * console.log('Active events:', events);
-     * ```
-     */
-    eventNames(): (keyof T)[];
-}
-
 /**
  * Authentication type definitions for Angany Voice SDK
  */
@@ -1355,6 +1383,11 @@ declare class Conversation extends EventEmitter<ConversationEvents> {
     private ephemeralCredentials?;
     private accessToken?;
     constructor(id: string, options: ConversationOptions, authManager: AuthManager, urls: ConversationUrls);
+    /**
+     * Set EventSource factory for React Native environments
+     * Call this before initialize() to use EventSource instead of fetch streams for SSE
+     */
+    setEventSourceFactory(factory: EventSourceFactory): void;
     /**
      * Initialize and start the conversation
      */
@@ -1774,4 +1807,4 @@ declare function hasErrorCode(error: unknown, code: string): boolean;
  */
 declare const VERSION = "0.0.2";
 
-export { AnganyError, AnganyVoice, type AuthError, type AuthEvents, AuthManager, type AuthOptions, type AuthState, type AuthStatus, AuthenticationError, type BackendAuthOptions, type ClientCredentials, ConfigurationError, Conversation, ConversationError, type ConversationOptions, type ConversationState, type ConversationStatus, type ConversationUrls, ErrorCodes, EventEmitter, type FrontendAuthOptions, type LogLevel, MediaError, NetworkError, PermissionError, ResourceError, type ServiceAccountAuthOptions, type ServiceAccountCredentials, type SpeakOptions, type TokenSet, type TranscriptionEvent, type UserInfo, VERSION, ValidationError, type VoiceConfig, type VoiceResource, hasErrorCode, isAnganyError };
+export { AnganyError, AnganyVoice, type AuthError, type AuthEvents, AuthManager, type AuthOptions, type AuthState, type AuthStatus, AuthenticationError, type BackendAuthOptions, type ClientCredentials, ConfigurationError, Conversation, ConversationError, type ConversationOptions, type ConversationState, type ConversationStatus, type ConversationUrls, ErrorCodes, EventEmitter, type EventSourceFactory, type EventSourceLike, type FrontendAuthOptions, type LogLevel, MediaError, NetworkError, PermissionError, ResourceError, type ServiceAccountAuthOptions, type ServiceAccountCredentials, type SpeakOptions, type TokenSet, type TranscriptionEvent, type UserInfo, VERSION, ValidationError, type VoiceConfig, type VoiceResource, hasErrorCode, isAnganyError };