interview-widget 3.2.22 → 3.3.1

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;
+}