@adaptware/eagles-db 0.5.64 → 0.5.68

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaptware/eagles-db",
-  "version": "0.5.64",
+  "version": "0.5.68",
   "description": "A Prisma client package for Treadspace database operations",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/prisma/schema/interview.prisma

@@ -52,6 +52,7 @@ model Interview {
   recording_url                 String?
   recording_document_id         String?           @unique
   evaluation_type               EvaluationType?   @default(TREADSPACE_AI_ASSISTED)
+  is_proctored                  Boolean           @default(true) @map("is_proctored")
   ai_assistance_mode            AiAssistanceMode? @default(ASSISTED)
   interview_status              InterviewStatus   @default(SCHEDULED)
   interview_platform            InterviewPlatform @default(TREADSPACE)
@@ -82,6 +83,13 @@ model Interview {
   /// When final human feedback was submitted.
   evaluated_at                  DateTime?
 
+  /// Candidate Acceptance & DPDP Consent
+  candidate_status          String?            @default("INVITED")
+  dpdp_consent_given        Boolean            @default(false)
+  dpdp_consent_given_at     DateTime?
+  candidate_responded_at    DateTime?
+  decline_reason            String?
+
   /// Self-scheduling
   reschedule_count          Int                @default(0)
   last_rescheduled_at       DateTime?
@@ -97,6 +105,11 @@ model Interview {
   created_by                String
   updated_by                String
   is_active                 Boolean            @default(true)
+
+
+  //interview proctoring
+  proctoringSession         ProctoringSession?
+
   // Relations
   candidate                 User?              @relation("CandidateInterviews", fields: [candidate_id], references: [id], onDelete: SetNull)
   interviewer               User?              @relation("InterviewerInterviews", fields: [interviewer_id], references: [id], onDelete: SetNull)

package/prisma/schema/migrations/20260918153000_add_is_proctored_fields/migration.sql

@@ -0,0 +1,2 @@
+-- AlterTable: Add is_proctored to Interview
+ALTER TABLE "Interview" ADD COLUMN IF NOT EXISTS "is_proctored" BOOLEAN NOT NULL DEFAULT true;

package/prisma/schema/migrations/20260925200000_proctoring_drop_stitch_cols_and_unique/migration.sql

@@ -0,0 +1,37 @@
+-- Dedup before unique (keep earliest row per session+index)
+DELETE FROM "proctoring_analyses" a
+USING "proctoring_analyses" b
+WHERE a.session_id = b.session_id
+  AND a.chunk_index = b.chunk_index
+  AND a.created_at > b.created_at;
+
+ALTER TABLE "proctoring_sessions"
+  DROP COLUMN IF EXISTS "full_video_key",
+  DROP COLUMN IF EXISTS "full_video_url";
+
+ALTER TABLE "proctoring_analyses"
+  DROP COLUMN IF EXISTS "total_chunks";
+
+DROP INDEX IF EXISTS "proctoring_analyses_session_id_chunk_index_idx";
+
+ALTER TABLE "proctoring_analyses"
+  DROP CONSTRAINT IF EXISTS "proctoring_analyses_session_id_chunk_index_key";
+
+ALTER TABLE "proctoring_analyses"
+  ADD CONSTRAINT "proctoring_analyses_session_id_chunk_index_key"
+  UNIQUE ("session_id", "chunk_index");
+
+ALTER TABLE "proctoring_sessions"
+  ALTER COLUMN "face_detected_pct" DROP DEFAULT,
+  ALTER COLUMN "on_screen_gaze_pct" DROP DEFAULT;
+
+ALTER TABLE "proctoring_sessions"
+  ALTER COLUMN "face_detected_pct" DROP NOT NULL,
+  ALTER COLUMN "on_screen_gaze_pct" DROP NOT NULL;
+
+UPDATE "proctoring_sessions"
+SET "face_detected_pct" = NULL, "on_screen_gaze_pct" = NULL
+WHERE "total_duration_sec" <= 0;
+
+ALTER TABLE "proctoring_sessions"
+  ALTER COLUMN "candidate_id" DROP NOT NULL;

package/prisma/schema/migrations/20260925210000_proctoring_drop_session_candidate_id/migration.sql

@@ -0,0 +1,3 @@
+ALTER TABLE "proctoring_sessions" DROP CONSTRAINT IF EXISTS "proctoring_sessions_candidate_id_fkey";
+DROP INDEX IF EXISTS "proctoring_sessions_candidate_id_idx";
+ALTER TABLE "proctoring_sessions" DROP COLUMN IF EXISTS "candidate_id";

package/prisma/schema/proctoring.prisma

@@ -0,0 +1,118 @@
+enum RiskLevel {
+  LOW
+  MEDIUM
+  HIGH
+  CRITICAL
+
+  @@schema("public")
+}
+
+enum AnalysisStatus {
+  QUEUED
+  RUNNING
+  COMPLETED
+  FAILED
+
+  @@schema("public")
+}
+
+enum ProctoringEventType {
+  GAZE_DISRUPTION
+  OBJECT_DETECTED
+  FACE_MISSING
+  MULTIPLE_FACES
+  BROWSER_TAB_SWITCH
+  BROWSER_BLUR
+  FULLSCREEN_EXIT
+
+  @@schema("public")
+}
+
+enum ProctoringSessionStatus {
+  NOT_STARTED
+  CALIBRATING
+  CALIBRATED
+  PROCESSING
+  COMPLETED
+  FAILED
+
+  @@schema("public")
+}
+
+model ProctoringSession {
+  id          String    @id @default(uuid()) @map("id")
+  interviewId String    @unique @map("interview_id")
+  interview   Interview @relation(fields: [interviewId], references: [id], onDelete: Cascade)
+
+  // Proctoring Lifecycle & Media
+  status              ProctoringSessionStatus @default(NOT_STARTED) @map("status")
+  calibrationFeatures Json?                   @map("calibration_features")
+  chunkCount          Int                     @default(0) @map("chunk_count")
+  completedChunks     Int                     @default(0) @map("completed_chunks")
+
+  // High-Level Aggregated Metrics for Downstream AI Evaluation
+  overallRisk    RiskLevel @default(LOW) @map("overall_risk")
+  integrityScore Float     @default(100.0) @map("integrity_score")
+
+  totalDurationSec Float  @default(0.0) @map("total_duration_sec")
+  faceDetectedPct  Float? @map("face_detected_pct")
+  onScreenGazePct  Float? @map("on_screen_gaze_pct")
+
+  // Event Counters
+  totalGazeEvents    Int @default(0) @map("total_gaze_events")
+  totalObjectEvents  Int @default(0) @map("total_object_events")
+  totalFaceEvents    Int @default(0) @map("total_face_events")
+  totalBrowserEvents Int @default(0) @map("total_browser_events")
+
+  createdAt DateTime @default(now()) @map("created_at")
+  updatedAt DateTime @updatedAt @map("updated_at")
+
+  analyses ProctoringAnalysis[]
+  events   ProctoringEvent[]
+
+  @@map("proctoring_sessions")
+  @@schema("public")
+}
+
+model ProctoringAnalysis {
+  id        String            @id @default(uuid()) @map("id")
+  sessionId String            @map("session_id")
+  session   ProctoringSession @relation(fields: [sessionId], references: [id], onDelete: Cascade)
+
+  status AnalysisStatus @default(QUEUED)
+
+  chunkIndex   Int   @default(0) @map("chunk_index")
+  startTimeSec Float @default(0.0) @map("start_time_sec")
+  endTimeSec   Float @default(0.0) @map("end_time_sec")
+
+  videoKey     String? @map("video_key")
+  annotatedKey String? @map("annotated_key")
+
+  error     String?
+  createdAt DateTime @default(now()) @map("created_at")
+  updatedAt DateTime @updatedAt @map("updated_at")
+
+  @@unique([sessionId, chunkIndex])
+  @@map("proctoring_analyses")
+  @@schema("public")
+}
+
+model ProctoringEvent {
+  id        String            @id @default(uuid()) @map("id")
+  sessionId String            @map("session_id")
+  session   ProctoringSession @relation(fields: [sessionId], references: [id], onDelete: Cascade)
+
+  eventType    ProctoringEventType @map("event_type")
+  timestampSec Float               @map("timestamp_sec")
+  timestampStr String              @map("timestamp_str")
+
+  risk     RiskLevel @default(LOW)
+  metadata Json?
+
+  createdAt DateTime @default(now()) @map("created_at")
+
+  @@index([sessionId, timestampSec])
+  @@index([sessionId, eventType])
+  @@map("proctoring_events")
+  @@schema("public")
+}