interview-widget 3.3.1 → 3.3.3-beta.0

package/dist/services/api/endpoints.d.ts

@@ -1,13 +1,11 @@
-export declare const API_VERSIONS: {
-    v1: string;
-    v2: string;
-};
 export declare const API_ENDPOINTS_V1: {
     GENERATE_QUESTION: string;
     SCREENSHOT_UPLOAD: (interviewId: string) => string;
 };
 export declare const API_ENDPOINTS: {
     GENERATE_QUESTION: (interviewId: string) => string;
+    GENERATE_QUESTION_SSE: (interviewId: string) => string;
+    AVATAR_WS: (interviewId: string) => string;
     SCREENSHOT_UPLOAD: (interviewId: string) => string;
     CONFIRM_UPLOAD: (assetId: string) => string;
     TRANSCRIBE_ANSWER: (interviewId: string) => string;

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

@@ -44,6 +44,7 @@ declare class STTService {
     private pendingStopPromise;
     private isStarting;
     private recordingStartTime;
+    private lastRecordedBlob;
     static activeStream: MediaStream | null;
     constructor(config?: STTConfig);
     /**

package/dist/services/timer/index.d.ts

@@ -1,6 +1,5 @@
 export { TimerPhase, TimerService } from './timer-service';
 export type { TimerCallbacks, TimerConfig, TimerState } from './timer-service';
 export { useTimer } from '../../hooks/use-timer';
-export type { UseTimerOptions, UseTimerReturn } from '../../hooks/use-timer';
 export { default as InterviewController } from '../../components/interview/interview-controller';
 export { default as TimerDisplay } from '../../components/timer/timer-display';

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

@@ -1,4 +1,4 @@
-export interface TTSPlaybackEvents {
+interface TTSPlaybackEvents {
     onStart?: () => void;
     onEnd?: () => void;
     onError?: (error: Error) => void;
@@ -8,7 +8,8 @@ declare class TTSService {
     /**
      * Play base64 audio data
      */
-    play(audioDataBase64: string, events?: TTSPlaybackEvents): Promise<void>;
+    play(audioDataBase64: string | string[], events?: TTSPlaybackEvents): Promise<void>;
+    private playChunk;
     /**
      * Stop current audio playback
      */

package/dist/types.d.ts

@@ -3,6 +3,7 @@ export interface InterviewQuestionData {
     qna_id: string;
     question: string;
     question_audio_data_base64: string | null;
+    question_audio_chunks_base64?: string[];
     audio_length_in_milliseconds: number;
     estimated_answer_duration_in_seconds: number;
     is_interview_done: boolean;
@@ -46,6 +47,9 @@ export interface InterviewWidgetConfig {
     ui?: {
         baseColor?: string;
         borderRadius?: string;
+        retryProgressSavedText?: string;
+        retryMaxAttempts?: number;
+        retryNoAttemptsLeftText?: string;
     };
     interview?: {
         allow_answer_editing?: boolean;
@@ -64,6 +68,9 @@ export interface InterviewWidgetConfig {
         tts?: {
             provider?: "piper";
         };
+        avatar?: {
+            provider?: "none" | "spatius";
+        };
         proctoring?: {
             enabled?: boolean;
             gazeAnalysisEnabled?: boolean;

package/dist/utils/constants.d.ts

@@ -1,11 +1,6 @@
 import { InterviewWidgetConfig } from '../types';
 export declare const defaultConfig: Required<InterviewWidgetConfig>;
 export declare const STORAGE_KEY = "iw-storage";
-/**
- * Get encryption seed from various sources depending on the environment
- * Works with: Vite React, Next.js, Vanilla JS
- */
-export declare function getEncryptionSeed(): string;
 export declare const ENCRYPTION_SEED: string;
 export declare const INTERVIEW_TOTAL_DURATION_MIN = 30;
 export declare const ASSET_TYPE: {

package/dist/utils/crypto.d.ts

@@ -1,9 +1,2 @@
-/**
- * Encrypt data with AES-GCM
- * @param data - The data to encrypt (will be JSON stringified if not a string)
- * @param seed - A seed string to derive the encryption key (e.g., session ID, user ID)
- * @returns Base64 encoded encrypted data (IV + ciphertext + tag)
- */
-export declare function encrypt(data: unknown, seed?: string): Promise<string>;
 export declare function encryptForStorage(data: unknown, seed?: string): Promise<string>;
 export declare function decryptFromStorage<T = unknown>(encryptedData: string, seed?: string): Promise<T>;

package/dist/utils/helper.d.ts

@@ -1,7 +1,3 @@
-export declare function generateGradientStyles(baseColor: string, lightenAmount?: number): {
-    background: string;
-    color: string;
-};
 export declare function sleep(ms: number): Promise<void>;
 export declare function generateButtonGradient(baseColor: string): string;
 export declare const generateUniqueId: () => string;

package/dist/utils/safari-audio-utils.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Safari Audio Utilities
+ *
+ * Centralises all Safari-specific audio quirks so every call site stays clean.
+ * Each function is a transparent no-op / pass-through on non-Safari browsers.
+ *
+ * Safari-specific lines are tagged with // [SAFARI] for easy auditing.
+ */
+/**
+ * Returns true only for genuine Safari (desktop + iOS).
+ * Chrome/Edge on iOS report as Safari in the UA, but they also advertise
+ * "Chrome" or "CriOS" / "EdgA" — we exclude those. [SAFARI]
+ */
+export declare function isSafari(): boolean;
+/**
+ * Returns the best supported MIME type for MediaRecorder.
+ *
+ * Safari only supports audio/mp4 (AAC-LC). Offering audio/webm first causes
+ * MediaRecorder construction to throw a NotSupportedError on Safari. [SAFARI]
+ */
+export declare function getSupportedMimeType(): string;
+/**
+ * Strips constraints that throw OverconstrainedError on Safari.
+ *
+ * Safari rejects `sampleRate` and `channelCount` as MediaTrackConstraints,
+ * raising an OverconstrainedError that blocks mic access entirely. [SAFARI]
+ * All other browsers receive the full constraint set unchanged.
+ */
+export declare function getSafariSafeAudioConstraints(base?: MediaTrackConstraints): MediaTrackConstraints;
+/**
+ * Returns the timeslice argument (ms) to pass to MediaRecorder.start().
+ *
+ * Safari silently suppresses `ondataavailable` events when a timeslice is
+ * provided — it will only emit one blob when stop() is called. [SAFARI]
+ * Returning `undefined` causes the caller to call `start()` with no argument,
+ * which is the correct Safari behaviour.
+ *
+ * Other browsers get 100 ms streaming chunks for real-time processing.
+ */
+export declare function getMediaRecorderStartArg(): number | undefined;
+/**
+ * [SAFARI] Do NOT call requestData() before stop().
+ * Without a timeslice, stop() guarantees one ondataavailable fires
+ * synchronously before onstop. Calling requestData() first queues a
+ * SECOND ondataavailable as a separate task — on some Safari versions
+ * that second event arrives AFTER onstop, so audioChunks is empty
+ * when the blob is assembled. Just call stop().
+ */
+export declare function safariSafeStop(recorder: MediaRecorder): void;