commons-assessment 12.0.39-dev.0 → 12.0.39-dev.2

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

@@ -73,6 +73,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 +83,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;

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
@@ -31,7 +32,9 @@ export declare class ProctoringService {
     /** End capture and flush pending data. */
     stop(): void;
     /** Tear down and remove the camera preview. */
-    destroy(): void;
+    destroy(params?: {
+        endSession: boolean;
+    }): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<ProctoringService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<ProctoringService>;
 }

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.0",
+  "version": "12.0.39-dev.2",
   "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.",