interview-widget 3.2.22 → 3.2.23

package/README.md

@@ -208,14 +208,15 @@ Pass this object to `InterviewWidgetProvider` via the `config` prop. Tables list
 
 ### Interview
 
-| Prop                 | Type      | Default | Description                                |
-| -------------------- | --------- | ------- | ------------------------------------------ |
-| allow_answer_editing | `boolean` | true    | Enable/disable answer editing phase        |
-| capture_screenshots  | `boolean` | false   | Enable/disable periodic screenshot captures |
-| timers               | `object`  | [see below](#timers)             | Per-phase and global timing configuration  |
-| stt                  | `object`  | [see below](#stt-speech-to-text) | Speech-to-Text provider settings           |
-| tts                  | `object`  | [see below](#tts-text-to-speech) | Text-to-Speech provider settings           |
-| proctoring           | `object`  | [see below](#proctoring)         | Proctoring settings and cheating detection |
+| Prop                 | Type      | Default                          | Description                                 |
+| -------------------- | --------- | -------------------------------- | ------------------------------------------- |
+| allow_answer_editing | `boolean` | true                             | Enable/disable answer editing phase         |
+| capture_screenshots  | `boolean` | false                            | Enable/disable periodic screenshot captures |
+| record_video         | `boolean` | false                            | Enable/disable video recording              |
+| timers               | `object`  | [see below](#timers)             | Per-phase and global timing configuration   |
+| stt                  | `object`  | [see below](#stt-speech-to-text) | Speech-to-Text provider settings            |
+| tts                  | `object`  | [see below](#tts-text-to-speech) | Text-to-Speech provider settings            |
+| proctoring           | `object`  | [see below](#proctoring)         | Proctoring settings and cheating detection  |
 
 #### Timers
 

package/dist/components/interview/proctoring/gaze-detection/hooks/use-camera-setup.d.ts

@@ -1,3 +1,4 @@
 export declare const useCameraSetup: (videoRef: React.RefObject<HTMLVideoElement | null>, isModelLoaded: boolean, renderLoop: () => void, setStatusMessage: (message: string) => void) => {
     animationFrameRef: import('react').RefObject<number | null>;
+    stream: MediaStream | null;
 };

package/dist/components/interview/proctoring/gaze-detection/hooks/use-gaze-analysis.d.ts

@@ -2,7 +2,7 @@ import { Landmark, ReferenceData } from '../utils/types';
 export declare const useGazeAnalysis: () => {
     engagement: number;
     isLookingAway: boolean;
-    analyzeGaze: (landmarks: Landmark[], reference: ReferenceData, gazeAnalysisEnabled: boolean) => {
+    analyzeGaze: (landmarks: Landmark[] | null, reference: ReferenceData, gazeAnalysisEnabled: boolean) => {
         engagement: number;
         isLookingAway: boolean;
     } | undefined;

package/dist/components/interview/proctoring/gaze-detection/hooks/use-render-loop.d.ts

@@ -1,5 +1,5 @@
 import { Landmark } from '../utils/types';
-export declare const useRenderLoop: (videoRef: React.RefObject<HTMLVideoElement | null>, canvasRef: React.RefObject<HTMLCanvasElement | null>, faceLandmarkerRef: React.RefObject<any>, updateFPS: () => void, analyzeFace: (results: any, referenceSet: boolean, referenceRef: Landmark[], setStatusMessage: (message: string) => void) => Landmark[] | null, drawWithEngagementBar: (canvas: HTMLCanvasElement, video: HTMLVideoElement, landmarks: Landmark[], showLandmarks: boolean, showEngagementBar: boolean, gazeAnalysisEnabled: boolean, referenceSet: boolean) => void, clearCanvas: (canvas: HTMLCanvasElement, video: HTMLVideoElement) => void, analyzeGaze: (landmarks: Landmark[], reference: any, gazeAnalysisEnabled: boolean) => void, referenceSet: boolean, referenceRef: React.RefObject<any>, showLandmarks: boolean, showEngagementBar: boolean, gazeAnalysisEnabled: boolean, setStatusMessage: (message: string) => void, setReferenceFaceNotDetected: (detected: boolean) => void) => {
+export declare const useRenderLoop: (videoRef: React.RefObject<HTMLVideoElement | null>, canvasRef: React.RefObject<HTMLCanvasElement | null>, faceLandmarkerRef: React.RefObject<any>, updateFPS: () => void, analyzeFace: (results: any, referenceSet: boolean, referenceRef: Landmark[], setStatusMessage: (message: string) => void) => Landmark[] | null, drawWithEngagementBar: (canvas: HTMLCanvasElement, video: HTMLVideoElement, landmarks: Landmark[], showLandmarks: boolean, showEngagementBar: boolean, gazeAnalysisEnabled: boolean, referenceSet: boolean) => void, clearCanvas: (canvas: HTMLCanvasElement, video: HTMLVideoElement) => void, analyzeGaze: (landmarks: Landmark[] | null, reference: any, gazeAnalysisEnabled: boolean) => void, referenceSet: boolean, referenceRef: React.RefObject<any>, showLandmarks: boolean, showEngagementBar: boolean, gazeAnalysisEnabled: boolean, setStatusMessage: (message: string) => void, setReferenceFaceNotDetected: (detected: boolean) => void) => {
     renderLoop: () => void;
     animationFrameRef: import('react').RefObject<number | null>;
 };

package/dist/components/media/video-feed.d.ts

@@ -3,6 +3,8 @@ export interface VideoFeedHandle {
     setReference: () => void;
     resetReference: () => void;
     stopCamera: () => void;
+    startRecording: () => void;
+    stopRecording: () => void;
 }
 interface VideoFeedProps {
     className?: string;

package/dist/context/proctoring-context.d.ts

@@ -1,8 +1,21 @@
 import { default as React } from 'react';
 import { ViolationLogger } from '../types';
 import { GazeViolationCounters, GazeViolationType } from '../components/interview/proctoring/gaze-detection/utils/types';
+export type ProctoringState = {
+    logViolations: ViolationLogger[];
+    totalViolations: number;
+    gazeViolationCounters: GazeViolationCounters;
+    referenceSet: boolean;
+    referenceRef: {
+        x: number;
+        y: number;
+        noseX: number;
+        noseY: number;
+    };
+};
 export declare const ProctoringProvider: React.FC<{
     children: React.ReactNode;
+    interviewId?: string;
 }>;
 export declare const useProctoringStore: () => {
     logViolations: ViolationLogger[];

package/dist/hooks/use-video-recording.d.ts

@@ -0,0 +1,6 @@
+export declare function useVideoRecordingStream(interviewId: string, record_video?: boolean): {
+    startRecording: (stream: MediaStream) => void;
+    stopRecording: () => void;
+    isRecording: boolean;
+    isUploading: boolean;
+};

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

@@ -15,4 +15,5 @@ export declare const API_ENDPOINTS: {
     EXIT: (interviewId: string) => string;
     CONFIG: (interviewId: string) => string;
     TRANSCRIPTION: (interviewId: string) => string;
+    VIOLATIONS: (interviewId: string) => string;
 };

package/dist/services/api/interview-api.d.ts

@@ -1,4 +1,4 @@
-import { InterviewConfigResponse, InterviewQuestionPayload, InterviewQuestionResponse, InterviewSubmitAnswerPayload, InterviewTranscriptResponse, InterviewWidgetConfig, ScreenshotUploadRequestResponse } from '../../types';
+import { InterviewConfigResponse, InterviewQuestionPayload, InterviewQuestionResponse, InterviewSubmitAnswerPayload, InterviewTranscriptResponse, InterviewViolationsPayload, InterviewViolationsResponse, InterviewWidgetConfig, ScreenshotUploadRequestResponse } from '../../types';
 declare class InterviewAPI {
     private config;
     constructor(config?: InterviewWidgetConfig["api"]);
@@ -31,21 +31,29 @@ declare class InterviewAPI {
      */
     getInterviewConfig(interviewId: string): Promise<InterviewConfigResponse>;
     /**
-     * Request a signed URL for uploading a screenshot
+     * Request a signed URL for uploading an asset
      */
-    requestScreenshotUploadUrl(interviewId: string, filename?: string): Promise<ScreenshotUploadRequestResponse>;
+    requestUploadUrl(interviewId: string, filename: string | undefined, mimeType: string, assetType: string): Promise<ScreenshotUploadRequestResponse>;
     /**
-     * Upload screenshot to the provided signed URL
+     * Upload asset to the provided signed URL
      */
-    uploadScreenshot(uploadUrl: string, imageBlob: Blob): Promise<void>;
+    uploadAsset(uploadUrl: string, blob: Blob, mimeType: string): Promise<void>;
     /**
-     * Confirm screenshot upload
+     * Confirm asset upload
      */
-    confirmScreenshotUpload(assetId: string): Promise<void>;
+    confirmAssetUpload(assetId: string): Promise<void>;
     /**
      * Get interview transcription
      */
     getInterviewTranscription(interviewId: string): Promise<InterviewTranscriptResponse>;
+    /**
+     * Get violations snapshot for an interview
+     */
+    getViolations(interviewId: string): Promise<InterviewViolationsResponse>;
+    /**
+     * Update violations snapshot for an interview
+     */
+    updateViolations({ interviewId, violations, }: InterviewViolationsPayload): Promise<InterviewViolationsResponse>;
 }
 export declare const interviewAPI: InterviewAPI;
 export { InterviewAPI };

package/dist/types.d.ts

@@ -50,6 +50,7 @@ export interface InterviewWidgetConfig {
     interview?: {
         allow_answer_editing?: boolean;
         capture_screenshots?: boolean;
+        record_video?: boolean;
         timers?: {
             thinkingDuration?: number;
             answeringDuration?: number;
@@ -135,3 +136,14 @@ export interface TranscriptMessage {
     question_generated_at: string;
     answer_submitted_at: string | null;
 }
+export interface InterviewViolationsResponse {
+    success: boolean;
+    message: string;
+    data: any;
+    error?: string | null;
+    code?: number;
+}
+export interface InterviewViolationsPayload {
+    interviewId: string;
+    violations: any;
+}

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;
+/**
+ * Stops a MediaRecorder, flushing the final chunk on Safari first.
+ *
+ * Safari sometimes fails to include the last audio segment in the blob
+ * unless requestData() is explicitly called just before stop(). [SAFARI]
+ * On other browsers requestData() is already called at the stop-promise
+ * setup site, so we only call stop() here.
+ */
+export declare function safariSafeStop(recorder: MediaRecorder): void;