interview-widget 1.0.8 → 1.0.10

package/dist/assets/bolt-icon.d.ts

@@ -0,0 +1 @@
+export declare const BoltIcon: (props: React.SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;

package/dist/assets/camera-off-icon.d.ts

@@ -0,0 +1 @@
+export declare const CameraOffIcon: (props: React.SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;

package/dist/assets/index.d.ts

@@ -10,3 +10,7 @@ export * from './monitor-icon';
 export * from './mouse-pointer-click-icon';
 export * from './shield-icon';
 export * from './speak-icon';
+export * from './bolt-icon';
+export * from './camera-off-icon';
+export * from './target-icon';
+export * from './users-icon';

package/dist/assets/info-icon.d.ts

@@ -0,0 +1 @@
+export declare const InfoIcon: (props: React.SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;

package/dist/assets/scan-face-icon.d.ts

@@ -0,0 +1 @@
+export declare const ScanFaceIcon: (props: React.SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;

package/dist/assets/target-icon.d.ts

@@ -0,0 +1 @@
+export declare const TargetIcon: (props: React.SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;

package/dist/assets/users-icon.d.ts

@@ -0,0 +1 @@
+export declare const UsersIcon: (props: React.SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;

package/dist/components/interview/interview-content.d.ts

@@ -1,11 +1,15 @@
 import { default as React, ReactNode } from 'react';
 import { TimerPhase } from '../../services/timer/timer-service';
 import { InterviewQuestionData } from '../../types';
+import { VideoFeedHandle } from '../media/video-feed';
 interface InterviewContentProps {
     currentQuestion: InterviewQuestionData | null;
     phase: TimerPhase;
     className?: string;
     children: ReactNode;
+    interviewId?: string;
+    interview_duration?: number | undefined;
+    videoFeedRef?: React.Ref<VideoFeedHandle> | undefined;
 }
 export declare const InterviewContent: React.FC<InterviewContentProps>;
 export {};

package/dist/components/interview/interview-controller.d.ts

@@ -1,10 +1,12 @@
 import { default as React } from 'react';
+import { VideoFeedHandle } from '../media/video-feed';
 interface InterviewControllerProps {
     interviewTitle: string;
     interviewId: string;
     onComplete?: (() => void) | undefined;
     onDisqualify?: (() => void) | undefined;
     className?: string;
+    videoFeedRef?: React.Ref<VideoFeedHandle>;
 }
 declare const InterviewController: React.FC<InterviewControllerProps>;
 export default InterviewController;

package/dist/components/interview/proctoring/face-data-permission-modal.d.ts

@@ -0,0 +1,7 @@
+interface FaceDataPermissionModalProps {
+    isOpen: boolean;
+    onDecline: () => void;
+    onContinue: () => void;
+}
+export declare function FaceDataPermissionModal({ isOpen, onDecline, onContinue, }: FaceDataPermissionModalProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/interview/proctoring/gaze-detection/components/gaze-controls.d.ts

@@ -0,0 +1,15 @@
+interface Props {
+    gazeAnalysisEnabled: boolean;
+    isModelLoaded: boolean;
+    stats: {
+        fps: number;
+        engagement: number;
+        isLookingAway: boolean;
+        multipleFacesDetected: boolean;
+        referenceFaceNotDetected: boolean;
+    };
+    statusMessage: string;
+    loadingProgress: number;
+}
+export declare const GazeControls: ({ gazeAnalysisEnabled, isModelLoaded, stats, statusMessage, loadingProgress, }: Props) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/interview/proctoring/gaze-detection/components/video-controls.d.ts

@@ -0,0 +1,21 @@
+import { Stats } from '../utils/types';
+interface VideoControlsProps {
+    showControls: boolean;
+    isBubbleOpen: boolean;
+    setIsBubbleOpen: (open: boolean) => void;
+    setReference: () => void;
+    clearCache: () => void;
+    isModelLoaded: boolean;
+    gazeAnalysisEnabled: boolean;
+    referenceSet: boolean;
+    showLandmarks: boolean;
+    setShowLandmarks: (show: boolean) => void;
+    showEngagementBar: boolean;
+    setShowEngagementBar: (show: boolean) => void;
+    handleToggleGazeAnalysis: (enabled: boolean) => void;
+    stats: Stats;
+    statusMessage: string;
+    loadingProgress: number;
+}
+export declare const VideoControls: React.FC<VideoControlsProps>;
+export {};

package/dist/components/interview/proctoring/gaze-detection/config/gaze-modal-config.d.ts

@@ -0,0 +1,10 @@
+import { GazeWarningConfig } from '../utils/types';
+export declare const GazeWarningType: {
+    readonly FACE_DETECTED: "face_detected";
+    readonly NO_FACE: "no_face_detected";
+    readonly MULTIPLE_FACES: "multiple_faces";
+    readonly LOOKING_AWAY: "looking_away";
+    readonly CAMERA_ERROR: "camera_error";
+};
+export type GazeWarningTypeValue = (typeof GazeWarningType)[keyof typeof GazeWarningType];
+export declare const warningConfigs: Record<GazeWarningTypeValue, GazeWarningConfig>;

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

@@ -0,0 +1,9 @@
+export { useModelLoader } from './use-model-loader';
+export { useFpsCounter } from './use-fps-counter';
+export { useCanvasDrawing } from './use-canvas-drawing';
+export { useGazeAnalysis } from './use-gaze-analysis';
+export { useFaceAnalysis } from './use-face-analysis';
+export { useWarningManager } from './use-warning-manager';
+export { useCameraSetup } from './use-camera-setup';
+export { useRenderLoop } from './use-render-loop';
+export { useReferenceManager } from './use-reference-manager';

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

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

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

@@ -0,0 +1,11 @@
+import { Landmark } from '../utils/types';
+export declare const useCanvasDrawing: () => {
+    drawLandmarks: (canvas: HTMLCanvasElement, video: HTMLVideoElement, landmarks: Landmark[], showLandmarks: boolean) => void;
+    drawEngagementBar: (ctx: CanvasRenderingContext2D) => void;
+    drawWithEngagementBar: (canvas: HTMLCanvasElement, video: HTMLVideoElement, landmarks: Landmark[], showLandmarks: boolean, showEngagementBar: boolean, gazeAnalysisEnabled: boolean, referenceSet: boolean) => void;
+    clearCanvas: (canvas: HTMLCanvasElement, video: HTMLVideoElement) => void;
+    engagementRef: import('react').RefObject<{
+        value: number;
+        isLookingAway: boolean;
+    }>;
+};

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

@@ -0,0 +1,8 @@
+import { Landmark, FaceDetectionResult } from '../utils/types';
+export declare const useFaceAnalysis: () => {
+    multipleFacesDetected: boolean;
+    referenceFaceNotDetected: boolean;
+    analyzeFace: (results: FaceDetectionResult, referenceSet: boolean, referenceRef: Landmark[], setStatusMessage: (message: string) => void) => Landmark[] | null;
+    setMultipleFacesDetected: import('react').Dispatch<import('react').SetStateAction<boolean>>;
+    setReferenceFaceNotDetected: import('react').Dispatch<import('react').SetStateAction<boolean>>;
+};

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

@@ -0,0 +1,4 @@
+export declare const useFpsCounter: () => {
+    fps: number;
+    updateFPS: () => void;
+};

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

@@ -0,0 +1,11 @@
+import { Landmark, ReferenceData } from '../utils/types';
+export declare const useGazeAnalysis: () => {
+    engagement: number;
+    isLookingAway: boolean;
+    analyzeGaze: (landmarks: Landmark[], reference: ReferenceData, gazeAnalysisEnabled: boolean) => {
+        engagement: number;
+        isLookingAway: boolean;
+    } | undefined;
+    setEngagement: import('react').Dispatch<import('react').SetStateAction<number>>;
+    setIsLookingAway: import('react').Dispatch<import('react').SetStateAction<boolean>>;
+};

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

@@ -0,0 +1,10 @@
+import { FaceLandmarker } from '@mediapipe/tasks-vision';
+export declare const useModelLoader: () => {
+    faceLandmarkerRef: import('react').RefObject<FaceLandmarker | null>;
+    isModelLoaded: boolean;
+    statusMessage: string;
+    setStatusMessage: import('react').Dispatch<import('react').SetStateAction<string>>;
+    loadingProgress: number;
+    permissionDenied: boolean;
+    clearCache: () => Promise<void>;
+};

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

@@ -0,0 +1,11 @@
+export declare const useReferenceManager: (faceLandmarkerRef: React.RefObject<any>, videoRef: React.RefObject<HTMLVideoElement | null>, setStatusMessage: (message: string) => void, onSetReference?: () => void) => {
+    referenceSet: boolean;
+    referenceRef: import('react').RefObject<{
+        x: number;
+        y: number;
+        noseX: number;
+        noseY: number;
+    }>;
+    setReference: () => void;
+    syncReference: () => void;
+};

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

@@ -0,0 +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) => {
+    renderLoop: () => void;
+    animationFrameRef: import('react').RefObject<number | null>;
+};

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

@@ -0,0 +1,10 @@
+import { WarningStates } from '../utils/types';
+import { GazeWarningTypeValue } from '../config/gaze-modal-config';
+export declare const useWarningManager: (warningStates: WarningStates, gazeAnalysisEnabled: boolean) => {
+    showGazeWarningModal: boolean;
+    faceDetectionState: GazeWarningTypeValue;
+    getWarningType: () => GazeWarningTypeValue;
+    closeWarningModal: () => void;
+    setShowGazeWarningModal: import('react').Dispatch<import('react').SetStateAction<boolean>>;
+    setFaceDetectionState: import('react').Dispatch<import('react').SetStateAction<GazeWarningTypeValue>>;
+};

package/dist/components/interview/proctoring/gaze-detection/utils/types.d.ts

@@ -0,0 +1,54 @@
+export interface Landmark {
+    x: number;
+    y: number;
+    z?: number;
+}
+export interface ReferenceData {
+    x: number;
+    y: number;
+    noseX: number;
+    noseY: number;
+}
+export interface FaceDetectionResult {
+    faceLandmarks: Landmark[][];
+}
+export interface WarningStates {
+    multipleFacesDetected: boolean;
+    referenceFaceNotDetected: boolean;
+    isLookingAway: boolean;
+}
+export interface Stats {
+    engagement: number;
+    fps: number;
+    isLookingAway: boolean;
+    multipleFacesDetected: boolean;
+    referenceFaceNotDetected: boolean;
+}
+export type GazeViolationType = 'looking_away' | 'no_face_detected' | 'multiple_faces';
+export interface GazeViolationCounters {
+    lookingAwayCount: number;
+    noFaceDetectedCount: number;
+    multipleFacesCount: number;
+    totalGazeViolations: number;
+}
+export interface GazeAnalysisState {
+    referenceSet: boolean;
+    referenceRef: {
+        x: number;
+        y: number;
+        noseX: number;
+        noseY: number;
+    };
+}
+export interface GazeWarningConfig {
+    icon: React.ComponentType<{
+        className?: string;
+    }>;
+    iconColor: string;
+    iconBg: string;
+    iconBorder: string;
+    title: string;
+    subtitle: string;
+    description: string;
+    buttonText: string;
+}

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

@@ -1,6 +1,10 @@
-import { default as React } from 'react';
+export interface VideoFeedHandle {
+    setReference: () => void;
+}
 interface VideoFeedProps {
     className?: string;
+    interviewId?: string;
+    interview_duration?: number | undefined;
 }
-declare const VideoFeed: React.FC<VideoFeedProps>;
+declare const VideoFeed: import('react').ForwardRefExoticComponent<VideoFeedProps & import('react').RefAttributes<VideoFeedHandle>>;
 export default VideoFeed;

package/dist/components/modals/gaze-warning-modal.d.ts

@@ -0,0 +1,8 @@
+import { GazeWarningTypeValue } from '../interview/proctoring/gaze-detection/config/gaze-modal-config';
+interface GazeWarningModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    warningType: GazeWarningTypeValue;
+}
+export declare function GazeWarningModal({ isOpen, onClose, warningType, }: GazeWarningModalProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/components/modals/onboarding-modal.d.ts

@@ -1,8 +1,12 @@
 import { default as React } from 'react';
+import { VideoFeedHandle } from '../media/video-feed';
 interface PermissionModalProps {
     isOpen: boolean;
     onStart: () => void;
+    onRequestCalibration?: () => void;
     onClose?: () => void;
+    gazeEnabled?: boolean;
+    videoFeedRef?: React.Ref<VideoFeedHandle>;
 }
 declare const OnboardingModal: React.FC<PermissionModalProps>;
 export default OnboardingModal;

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

@@ -1,5 +1,6 @@
 import { default as React } from 'react';
 import { ViolationLogger } from '../types';
+import { GazeViolationCounters, GazeViolationType } from '../components/interview/proctoring/gaze-detection/utils/types';
 export declare const ProctoringProvider: React.FC<{
     children: React.ReactNode;
 }>;
@@ -8,9 +9,35 @@ export declare const useProctoringStore: () => {
     totalViolations: number;
     addViolation: (violation: ViolationLogger) => void;
     clearViolations: () => void;
+    gazeViolationCounters: GazeViolationCounters;
+    referenceSet: boolean;
+    referenceRef: {
+        x: number;
+        y: number;
+        noseX: number;
+        noseY: number;
+    };
+    incrementGazeViolation: (type: GazeViolationType) => void;
+    clearGazeViolationCounters: () => void;
+    setReferenceData: (referenceSet: boolean, referenceRef: {
+        x: number;
+        y: number;
+        noseX: number;
+        noseY: number;
+    }) => void;
 };
 export declare const useViolations: () => ViolationLogger[];
 export declare const useTotalViolations: () => number;
+export declare const useGazeViolationCounters: () => GazeViolationCounters;
+export declare const useReferenceData: () => {
+    referenceSet: boolean;
+    referenceRef: {
+        x: number;
+        y: number;
+        noseX: number;
+        noseY: number;
+    };
+};
 export declare const useProctoringActions: () => {
     addViolation: (violation: ViolationLogger) => void;
     clearViolations: () => void;

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

@@ -1,4 +1,4 @@
-import { InterviewQuestionPayload, InterviewQuestionResponse, InterviewWidgetConfig } from '../../types';
+import { InterviewQuestionPayload, InterviewQuestionResponse, InterviewWidgetConfig, ScreenshotUploadRequestResponse } from '../../types';
 declare class InterviewAPI {
     private config;
     constructor(config?: InterviewWidgetConfig["api"]);
@@ -18,6 +18,14 @@ declare class InterviewAPI {
      * Get questions for an interview
      */
     generateQuestion({ interviewId, isInterviewDone, qnaId, question, answer, answerDuration, }: InterviewQuestionPayload): Promise<InterviewQuestionResponse>;
+    /**
+     * Request a signed URL for uploading a screenshot
+     */
+    requestScreenshotUploadUrl(interviewId: string, filename?: string): Promise<ScreenshotUploadRequestResponse>;
+    /**
+     * Upload screenshot to the provided signed URL
+     */
+    uploadScreenshot(uploadUrl: string, imageBlob: Blob): Promise<void>;
 }
 export declare const interviewAPI: InterviewAPI;
 export { InterviewAPI };

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

@@ -71,6 +71,10 @@ declare class STTService {
      * Get supported MIME type for recording
      */
     private getSupportedMimeType;
+    /**
+     * Get the current recording stream
+     */
+    getRecordingStream(): MediaStream | null;
     /**
      * Clean up recording resources
      */

package/dist/types.d.ts

@@ -6,6 +6,7 @@ export interface InterviewQuestionData {
     audio_length_in_milliseconds: number;
     estimated_answering_duration: string;
     is_interview_done: boolean;
+    interview_duration?: number;
 }
 export interface InterviewQuestionPayload {
     interviewId: string;
@@ -59,6 +60,10 @@ export interface InterviewWidgetConfig {
         };
         proctoring?: {
             enabled?: boolean;
+            gazeAnalysisEnabled?: boolean;
+            showLandmarks?: boolean;
+            showEngagementBar?: boolean;
+            showControls?: boolean;
         };
     };
 }
@@ -89,3 +94,13 @@ export interface ViolationLogger extends Violation {
     timestamp: number;
 }
 export type ViolationType = "tab_switch" | "fullscreen_exit" | "focus_loss" | "blocked_shortcut" | "right_click_attempt" | "alt_tab_attempt" | "blocked_function_key";
+export interface ScreenshotUploadRequestResponse {
+    success: boolean;
+    message: string;
+    data: {
+        upload_url: string;
+        file_path: string;
+    };
+    error?: string | null;
+    code?: number;
+}

package/dist/utils/constants.d.ts

@@ -7,3 +7,4 @@ export declare const STORAGE_KEY = "iw-storage";
  */
 export declare function getEncryptionSeed(): string;
 export declare const ENCRYPTION_SEED: string;
+export declare const INTERVIEW_TOTAL_DURATION_MIN = 5;