interview-widget 3.1.5 → 3.2.0

package/dist/services/stt/stt-service.d.ts

@@ -37,8 +37,10 @@ declare class STTService {
     private config;
     private mediaRecorder;
     private audioChunks;
+    private audioChunksTotalSize;
     private recordingStream;
     private autoStopTimeoutId;
+    private disposed;
     constructor(config?: STTConfig);
     /**
      * Update STT configuration
@@ -49,11 +51,21 @@ declare class STTService {
      */
     isRecordingSupported(): boolean;
     /**
-     * Start recording audio from user's microphone
+     * Start recording audio from user's microphone.
+     *
+     * Event flow:
+     * - onStart fires immediately when recording begins
+     * - onStop fires ONLY via the MediaRecorder's stop event (single source of truth)
+     * - onError fires on MediaRecorder errors
+     * - onDataAvailable fires every 100ms with new audio data
      */
     startRecording(maxDuration?: number, events?: RecordingEvents): Promise<void>;
     /**
-     * Stop recording and return the audio blob
+     * Stop recording and return the audio blob.
+     *
+     * NOTE: This method does NOT fire onStop — that is handled exclusively
+     * by the MediaRecorder's "stop" event listener set in startRecording().
+     * This prevents the double-fire issue.
      */
     stopRecording(): Promise<Blob>;
     /**
@@ -68,6 +80,15 @@ declare class STTService {
      * Check if currently recording
      */
     isRecording(): boolean;
+    /**
+     * Fully dispose of the service instance, releasing all resources.
+     * After calling dispose(), the instance cannot be reused.
+     */
+    dispose(): void;
+    /**
+     * Check if the service has been disposed
+     */
+    isDisposed(): boolean;
     /**
      * Get supported MIME type for recording
      */
@@ -80,6 +101,10 @@ declare class STTService {
      * Clean up recording resources
      */
     private cleanup;
+    /**
+     * Throw if the service has been disposed
+     */
+    private throwIfDisposed;
 }
 export declare const sttService: STTService;
 export { STTService };