commons-assessment 12.0.39-dev.1 → 12.0.39-dev.3

package/lib/modules/assessment-taker/assessment-taker.component.d.ts

@@ -43,6 +43,7 @@ export declare class AssessmentTakerComponent implements OnInit, OnDestroy {
     showOverallRemarks: boolean;
     showCorrectAnswers: boolean;
     resumeTimerAcrossVisits: boolean;
+    warnOnLeaveDuringProctoring: boolean;
     proctorLinkLoader?: () => Promise<any>;
     snackbarMessage: EventEmitter<{
         message: string;
@@ -73,6 +74,8 @@ export declare class AssessmentTakerComponent implements OnInit, OnDestroy {
     expandedState: boolean[];
     private youtubeUrlCache;
     private newAssesseeSession;
+    private backGuardArmed;
+    private allowBackNavigation;
     private _selectedTabIndex;
     get selectedTabIndex(): number;
     set selectedTabIndex(value: number);
@@ -81,6 +84,22 @@ export declare class AssessmentTakerComponent implements OnInit, OnDestroy {
     tooltipState: Record<number, boolean>;
     isMobile: boolean;
     onResize(): void;
+    /**
+     * While a proctoring session is running, warn the candidate before they refresh, close the tab, or
+     * navigate away. Browsers show their own generic "Leave site?" confirmation here — the message text
+     * cannot be customized for security reasons — so this only guarantees a prompt, not our wording.
+     */
+    onBeforeUnload(event: BeforeUnloadEvent): void;
+    /**
+     * In-app Back button (SPA popstate — not caught by beforeunload). While proctoring runs we keep a
+     * sentinel history entry; when Back pops it we show a custom warning and either re-arm (stay) or
+     * proceed with the navigation (leave).
+     */
+    onPopState(): void;
+    private isProctoringRunning;
+    /** Pushes a sentinel history entry so the next in-app Back press triggers our guard. */
+    private armBackGuard;
+    private confirmLeaveAssessment;
     constructor(assessmentTakerService: AssessmentTakerService, fb: FormBuilder, responseBuilderService: ResponseBuilderService, sanitizer: DomSanitizer, dialog: MatDialog, cdr: ChangeDetectorRef, proctoringService: ProctoringService);
     ngOnInit(): void;
     ngOnDestroy(): void;
@@ -168,5 +187,5 @@ export declare class AssessmentTakerComponent implements OnInit, OnDestroy {
     trackByOptionId(index: number, option: any): string;
     trackByChildId(index: number, id: any): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<AssessmentTakerComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AssessmentTakerComponent, "lib-assessment-taker", never, { "labelConfig": "labelConfig"; "imageConfig": "imageConfig"; "showFooter": "showFooter"; "assessmentId": "assessmentId"; "assessmentInstanceId": "assessmentInstanceId"; "assesseeData": "assesseeData"; "assessorData": "assessorData"; "disabled": "disabled"; "previewMode": "previewMode"; "verticalView": "verticalView"; "enableMarks": "enableMarks"; "hideSectionTabs": "hideSectionTabs"; "assessmentContext": "assessmentContext"; "assesseeResponse": "assesseeResponse"; "markAsCompleted": "markAsCompleted"; "sectionWiseScore": "sectionWiseScore"; "showOverallRemarks": "showOverallRemarks"; "showCorrectAnswers": "showCorrectAnswers"; "resumeTimerAcrossVisits": "resumeTimerAcrossVisits"; "proctorLinkLoader": "proctorLinkLoader"; }, { "snackbarMessage": "snackbarMessage"; "submitAssessment": "submitAssessment"; "stepChanged": "stepChanged"; "consentToProceed": "consentToProceed"; }, never, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AssessmentTakerComponent, "lib-assessment-taker", never, { "labelConfig": "labelConfig"; "imageConfig": "imageConfig"; "showFooter": "showFooter"; "assessmentId": "assessmentId"; "assessmentInstanceId": "assessmentInstanceId"; "assesseeData": "assesseeData"; "assessorData": "assessorData"; "disabled": "disabled"; "previewMode": "previewMode"; "verticalView": "verticalView"; "enableMarks": "enableMarks"; "hideSectionTabs": "hideSectionTabs"; "assessmentContext": "assessmentContext"; "assesseeResponse": "assesseeResponse"; "markAsCompleted": "markAsCompleted"; "sectionWiseScore": "sectionWiseScore"; "showOverallRemarks": "showOverallRemarks"; "showCorrectAnswers": "showCorrectAnswers"; "resumeTimerAcrossVisits": "resumeTimerAcrossVisits"; "warnOnLeaveDuringProctoring": "warnOnLeaveDuringProctoring"; "proctorLinkLoader": "proctorLinkLoader"; }, { "snackbarMessage": "snackbarMessage"; "submitAssessment": "submitAssessment"; "stepChanged": "stepChanged"; "consentToProceed": "consentToProceed"; }, never, never>;
 }

package/lib/modules/assessment-taker/services/proctoring.service.d.ts

@@ -11,6 +11,7 @@ import * as i0 from "@angular/core";
  */
 export declare class ProctoringService {
     private session;
+    private offHandlers;
     /**
      * Creates a ProctorLink session with the given id + JWT and requests camera access.
      * The returned observable completes once the candidate GRANTS camera access, and errors

package/lib/shared/interfaces/proctoring.interface.d.ts

@@ -22,6 +22,7 @@ export interface ProctoringSessionSummary {
     endedAt?: number;
     expiresAt?: number;
     validatedAt?: number;
+    integritySummary?: IntegritySummary;
 }
 /** The proctoring report for a single session (fetched on demand by session id). */
 export interface ProctoringReport {
@@ -92,3 +93,9 @@ export interface ProctoringPayload {
     evidence?: ProctoringEvidence[];
     timeline?: ProctoringTimelineEvent[];
 }
+export interface IntegritySummary {
+    proctoringSessionId?: number;
+    integrityScore?: number;
+    integrityLevel?: string;
+    integrityFlagged?: boolean;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "commons-assessment",
-  "version": "12.0.39-dev.1",
+  "version": "12.0.39-dev.3",
   "peerDependencies": {
     "@angular/common": ">=12.0.0",
     "@angular/core": ">=12.0.0",

package/src/lib/assets/json/labelConfig.json

@@ -102,6 +102,8 @@
     "COMMONS_ASSESSMENT.PROCTORING.INTRO_MINUTES": "min",
     "COMMONS_ASSESSMENT.PROCTORING.INTRO_WARNINGS_TITLE": "Please note",
     "COMMONS_ASSESSMENT.PROCTORING.WARN_AUTO_SUBMIT": "This is a timed assessment — when the time runs out, your responses will be submitted automatically.",
+    "COMMONS_ASSESSMENT.PROCTORING.LEAVE_WARNING_TITLE": "Leave assessment?",
+    "COMMONS_ASSESSMENT.PROCTORING.LEAVE_WARNING_MESSAGE": "Proctoring is active. Leaving or navigating back may impact your final report. Do you wish to proceed?",
     "COMMONS_ASSESSMENT.PROCTORING.WARN_ONE_ATTEMPT": "Complete the assessment in a single attempt — multiple attempts can impact your final score.",
     "COMMONS_ASSESSMENT.PROCTORING.WARN_NO_TAB_SWITCH": "Do not switch tabs or leave the assessment window.",
     "COMMONS_ASSESSMENT.PROCTORING.WARN_NO_REFRESH": "Do not refresh or close the page during the assessment.",
@@ -146,6 +148,7 @@
     "COMMONS_ASSESSMENT.PROCTORING.EVENT.no_face.detected": "No face detected",
     "COMMONS_ASSESSMENT.PROCTORING.EVENT.multi_face.detected": "Multiple faces detected",
     "COMMONS_ASSESSMENT.PROCTORING.REASON.browser_activity": "Browser activity",
+    "COMMONS_ASSESSMENT.PROCTORING.REASON.liveness_gap": "Liveness gap",
     "COMMONS_ASSESSMENT.PROCTORING.REASON.no_face": "No face detected",
     "COMMONS_ASSESSMENT.PROCTORING.REASON.multi_face": "Multiple faces detected",
     "COMMONS_ASSESSMENT.PROCTORING.REASON.impersonation": "Possible impersonation",

package/src/lib/assets/theme/_theme.global.scss

@@ -55,6 +55,7 @@ $default-config: (
   tooltip-border: 0.064rem solid #bdc9d3,
 
   box-shadow-tooltip: 0 8px 20px rgba(0, 0, 0, 0.15),
+  input-focus-box-shadow: 0 0 0 0.2rem rgba(70, 125, 214, 0.25),
 
   button-padding: 0.5rem 1rem,
   button-padding-large: 0.5rem 3rem,

package/src/lib/assets/theme/styles.global.scss

@@ -78,6 +78,12 @@ GLOBAL stylesheet for commons-assessment library
             border-radius: var(--assessment-border-radius-two);
             border: var(--assessment-input-border-one);
             overflow: hidden;
+            transition: border-color 0.15s ease, box-shadow 0.15s ease;
+        }
+
+        .angular-editor:focus-within {
+            border-color: var(--assessment-primary-one) !important;
+            box-shadow: var(--assessment-input-focus-box-shadow);
         }
 
         .angular-editor-textarea {
@@ -198,4 +204,16 @@ GLOBAL stylesheet for commons-assessment library
     .mat-mdc-tab-header {
         display: none !important;
     }
+}
+
+input.assessment-input-border-one,
+textarea.assessment-input-border-one {
+    transition: background-color 0.15s ease, border-color 0.15s ease, box-shadow 0.15s ease;
+
+    &:focus {
+        background-color: var(--assessment-white) !important;
+        border: var(--assessment-input-border-one) !important;
+        border-color: var(--assessment-primary-one) !important;
+        box-shadow: var(--assessment-input-focus-box-shadow);
+    }
 }