commons-assessment 12.1.0 → 12.1.2-dev.0

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

@@ -1,7 +1,7 @@
 import { EventEmitter, OnInit } from '@angular/core';
 import { CdkDragDrop } from '@angular/cdk/drag-drop';
 import { MatDialog } from '@angular/material/dialog';
-import { QuestionType, Assessment, RefData, AssessmentContextDTO, AssessmentInstance } from '../../shared/interfaces/assessment.interface';
+import { QuestionType, Assessment, RefData, AssessmentContextDTO, AssessmentInstance, QuestionBankConfig } from '../../shared/interfaces/assessment.interface';
 import { AssessmentQuestionPaper, SectionQuestion, QuestionPaperSection } from '../../shared/interfaces/question-paper.interface';
 import { AssessmentQuestion } from '../../shared/interfaces/question.interface';
 import { AssessmentBuilderService } from './services/assessment-builder.service';
@@ -27,6 +27,11 @@ export declare class AssessmentMakerComponent implements OnInit {
     enableSkillsToQuestionMapping: boolean;
     assessmentContext: AssessmentContextDTO;
     minimumRequiredSections: number;
+    checkForResponses: boolean;
+    showProctoringToggle: boolean;
+    showTimeInput: boolean;
+    enableImportFromQuestionBank: boolean;
+    questionBankConfig?: QuestionBankConfig;
     assessmentIdChange: EventEmitter<number>;
     assessmentInstanceIdChange: EventEmitter<number>;
     snackbarMessage: EventEmitter<{
@@ -35,15 +40,28 @@ export declare class AssessmentMakerComponent implements OnInit {
     }>;
     showLoader: boolean;
     questionBank: Record<number, AssessmentQuestion>;
+    lockedQuestionsMap: Record<number, boolean>;
     assessmentQuestionPaperData: AssessmentQuestionPaper;
     configsLoaded: boolean;
     rules: any;
     isSubmitting: boolean;
     skillsList: RefData[];
+    responseCount: number;
+    proctoringEnabled: boolean;
+    durationMinutes: number | null;
+    private readonly PROCTORING_CONFIG_KEY;
     constructor(assessmentMakerService: AssessmentMakerService, assessmentBuilderService: AssessmentBuilderService, dialog: MatDialog);
     ngOnInit(): void;
+    private loadResponseCount;
+    /**
+     * Runs `action`, but first warns the user if the assessment already has responses
+     * (only when `checkForResponses` is enabled and the count is greater than 0).
+     */
+    private confirmResponsesWarning;
     getConfigsFromJSON(): void;
     loadAssessmentData(): void;
+    checkAssessmentQuestionsLocked(): void;
+    isQuestionLocked(questionId?: number): boolean;
     generateQuestionBank(): void;
     imageErrorHandler(event: any, filePath: string): void;
     focusSectionInput(sectionIndex: number, event: Event): void;
@@ -54,8 +72,22 @@ export declare class AssessmentMakerComponent implements OnInit {
     deleteParentQuestion(sectionQuestion: SectionQuestion): void;
     deleteSection(section: QuestionPaperSection): void;
     createEditQuestion(sectionDetails?: any, sectionQuestionId?: number, isChild?: boolean): void;
+    private openQuestionBuilder;
     duplicateSection(sectionId: number): void;
     duplicateQuestion(section: QuestionPaperSection, sectionQuestion: SectionQuestion): void;
+    private readProctoringConfig;
+    /** Initializes the minutes input from an existing instance's duration (seconds). */
+    private readDuration;
+    /** Blocks characters that would enter a negative/exponent value in the duration input. */
+    blockNegativeKeys(event: KeyboardEvent): void;
+    /** Duration to persist, in SECONDS (the unit the taker's timer uses). 0 means untimed. */
+    private get durationSeconds();
+    /**
+     * Returns the assessment configs with the proctoring flag ('1'/'0') upserted, preserving
+     * any other existing configs. Returns undefined when the proctoring toggle is not enabled
+     * so the saved payload is unchanged for consumers not using proctoring.
+     */
+    private buildProctoringConfigs;
     patchAssessmentAndQuestionPaper(successMessage?: string): void;
     finalSubmit(): void;
     createAssessmentInstance(): void;
@@ -65,6 +97,12 @@ export declare class AssessmentMakerComponent implements OnInit {
     filterInactiveSectionsAndQuestions(): void;
     capitalizeFirst(text: string | undefined): string;
     getSkillsList(): void;
+    trackBySectionId(index: number, section: any): string;
+    trackBySectionQuestion(index: number, sq: any): string;
+    private collectExistingQuestionIds;
+    openQuestionBankPicker(section?: QuestionPaperSection): void;
+    private importQuestionsToSection;
+    private createAssessmentAndQuestionPaperOnImport;
     static ɵfac: i0.ɵɵFactoryDeclaration<AssessmentMakerComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AssessmentMakerComponent, "lib-assessment-maker", never, { "labelConfig": "labelConfig"; "imageConfig": "imageConfig"; "questionTypes": "questionTypes"; "showFooter": "showFooter"; "customRules": "customRules"; "assessmentId": "assessmentId"; "assessmentInstanceId": "assessmentInstanceId"; "defaultAssessmentDTO": "defaultAssessmentDTO"; "predefinedAssessmentInstance": "predefinedAssessmentInstance"; "enableSkillsToQuestionMapping": "enableSkillsToQuestionMapping"; "assessmentContext": "assessmentContext"; "minimumRequiredSections": "minimumRequiredSections"; }, { "assessmentIdChange": "assessmentIdChange"; "assessmentInstanceIdChange": "assessmentInstanceIdChange"; "snackbarMessage": "snackbarMessage"; }, never, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AssessmentMakerComponent, "lib-assessment-maker", never, { "labelConfig": "labelConfig"; "imageConfig": "imageConfig"; "questionTypes": "questionTypes"; "showFooter": "showFooter"; "customRules": "customRules"; "assessmentId": "assessmentId"; "assessmentInstanceId": "assessmentInstanceId"; "defaultAssessmentDTO": "defaultAssessmentDTO"; "predefinedAssessmentInstance": "predefinedAssessmentInstance"; "enableSkillsToQuestionMapping": "enableSkillsToQuestionMapping"; "assessmentContext": "assessmentContext"; "minimumRequiredSections": "minimumRequiredSections"; "checkForResponses": "checkForResponses"; "showProctoringToggle": "showProctoringToggle"; "showTimeInput": "showTimeInput"; "enableImportFromQuestionBank": "enableImportFromQuestionBank"; "questionBankConfig": "questionBankConfig"; }, { "assessmentIdChange": "assessmentIdChange"; "assessmentInstanceIdChange": "assessmentInstanceIdChange"; "snackbarMessage": "snackbarMessage"; }, never, never>;
 }

package/lib/modules/assessment-maker/assessment-maker.module.d.ts

@@ -3,12 +3,13 @@ import * as i1 from "./assessment-maker.component";
 import * as i2 from "./components/add-edit-section-introduction/add-edit-section-introduction.component";
 import * as i3 from "./components/assessment-builder/assessment-builder.component";
 import * as i4 from "./components/question-details/question-details.component";
-import * as i5 from "@angular/common";
-import * as i6 from "../../shared/shared.module";
-import * as i7 from "../../shared/material-modules";
-import * as i8 from "@angular/forms";
+import * as i5 from "./components/question-bank-picker/question-bank-picker.component";
+import * as i6 from "@angular/common";
+import * as i7 from "../../shared/shared.module";
+import * as i8 from "../../shared/material-modules";
+import * as i9 from "@angular/forms";
 export declare class AssessmentMakerModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<AssessmentMakerModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<AssessmentMakerModule, [typeof i1.AssessmentMakerComponent, typeof i2.AddEditSectionIntroductionComponent, typeof i3.AssessmentBuilderComponent, typeof i4.QuestionDetailsComponent], [typeof i5.CommonModule, typeof i6.SharedModule, typeof i7.MaterialModules, typeof i8.FormsModule, typeof i8.ReactiveFormsModule], [typeof i1.AssessmentMakerComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<AssessmentMakerModule, [typeof i1.AssessmentMakerComponent, typeof i2.AddEditSectionIntroductionComponent, typeof i3.AssessmentBuilderComponent, typeof i4.QuestionDetailsComponent, typeof i5.QuestionBankPickerComponent], [typeof i6.CommonModule, typeof i7.SharedModule, typeof i8.MaterialModules, typeof i9.FormsModule, typeof i9.ReactiveFormsModule], [typeof i1.AssessmentMakerComponent, typeof i3.AssessmentBuilderComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<AssessmentMakerModule>;
 }

package/lib/modules/assessment-maker/components/assessment-builder/assessment-builder.component.d.ts

@@ -36,6 +36,8 @@ export declare class AssessmentBuilderComponent implements OnInit {
     questionBank: Record<number, AssessmentQuestion>;
     isChild: boolean;
     assessmentId: number;
+    standaloneMode: boolean;
+    isLocked: boolean;
     isSubmitting: boolean;
     skillsList: RefData[];
     constructor(formBuilder: FormBuilder, assessmentBuilderService: AssessmentBuilderService, assessmentMakerService: AssessmentMakerService, dialogRef: MatDialogRef<AssessmentBuilderComponent>, dialogData: any);
@@ -44,6 +46,7 @@ export declare class AssessmentBuilderComponent implements OnInit {
     setupFormGroup(): void;
     populateForm(questionDetails: AssessmentQuestion, buildChildGroups?: boolean): void;
     onSubmit(): Promise<void>;
+    private createStandaloneQuestion;
     createQuestion(payload: any): Promise<AssessmentQuestion>;
     updateQuestion(payload: any): Promise<AssessmentQuestion>;
     createOrEditAssessmentAndQuestionPaper(question: AssessmentQuestion): void;
@@ -68,6 +71,10 @@ export declare class AssessmentBuilderComponent implements OnInit {
     goBack(): void;
     private resetAndPopulate;
     private scrollToTop;
+    trackByCode(index: number, item: any): string;
+    trackByControl(index: number, control: any): any;
+    trackByGroupId(index: number, group: any): string;
+    trackByQuestionId(index: number, id: any): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<AssessmentBuilderComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<AssessmentBuilderComponent, "lib-app-assessment-builder", never, {}, {}, never, never>;
 }

package/lib/modules/assessment-maker/components/question-bank-picker/question-bank-picker.component.d.ts

@@ -0,0 +1,81 @@
+import { OnDestroy, OnInit } from '@angular/core';
+import { MatDialogRef } from '@angular/material/dialog';
+import { QuestionBankConfig, QuestionType } from '../../../../shared/interfaces/assessment.interface';
+import { AssessmentQuestion } from '../../../../shared/interfaces/question.interface';
+import { AssessmentMakerService } from '../../services/assessment-maker.service';
+import * as i0 from "@angular/core";
+export interface QuestionBankPickerDialogData {
+    questionBankConfig: QuestionBankConfig;
+    existingQuestionIds: Set<number>;
+    labelConfig: {
+        [key: string]: string;
+    };
+    imageConfig: {
+        [key: string]: string;
+    };
+    questionTypes: QuestionType[];
+    targetSectionName?: string;
+}
+export declare class QuestionBankPickerComponent implements OnInit, OnDestroy {
+    private assessmentMakerService;
+    dialogRef: MatDialogRef<QuestionBankPickerComponent>;
+    dialogData: QuestionBankPickerDialogData;
+    labelConfig: {
+        [key: string]: string;
+    };
+    imageConfig: {
+        [key: string]: string;
+    };
+    questionTypes: QuestionType[];
+    existingQuestionIds: Set<number>;
+    targetSectionName: string;
+    allQuestions: AssessmentQuestion[];
+    filteredQuestions: AssessmentQuestion[];
+    currentPage: number;
+    pageSize: number;
+    totalElements: number;
+    hasNext: boolean;
+    isLoading: boolean;
+    isInitialLoading: boolean;
+    searchTerm: string;
+    selectedTypeCode: string;
+    selectedQuestions: Map<number, AssessmentQuestion>;
+    expandedQuestionIds: Set<number>;
+    private questionBankConfig;
+    private searchSubject$;
+    private destroy$;
+    constructor(assessmentMakerService: AssessmentMakerService, dialogRef: MatDialogRef<QuestionBankPickerComponent>, dialogData: QuestionBankPickerDialogData);
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    loadPage(page: number, append?: boolean): void;
+    loadMore(): void;
+    onScroll(event: Event): void;
+    applyFilters(): void;
+    onSearchChange(term: string): void;
+    clearSearch(): void;
+    onTypeFilterChange(typeCode: string | undefined): void;
+    selectQuickTypeFilter(typeCode: string | undefined): void;
+    toggleSelection(question: AssessmentQuestion): void;
+    isSelected(question: AssessmentQuestion): boolean;
+    isAlreadyInAssessment(questionId: number | undefined): boolean;
+    get eligibleVisibleQuestions(): AssessmentQuestion[];
+    get isAllVisibleSelected(): boolean;
+    get isSomeVisibleSelected(): boolean;
+    toggleSelectAllVisible(): void;
+    clearAllSelection(): void;
+    hasOptions(question: AssessmentQuestion): boolean;
+    toggleExpandOptions(questionId: number | undefined, event: Event): void;
+    isOptionsExpanded(questionId: number | undefined): boolean;
+    get selectedCount(): number;
+    get totalSelectedMarks(): number;
+    getTypeCount(typeCode: string | undefined): number;
+    getCategoryClass(question: AssessmentQuestion): string;
+    importSelected(): void;
+    close(): void;
+    capitalizeFirst(text: string | undefined): string;
+    getQuestionTypeLabel(question: AssessmentQuestion): string;
+    imageErrorHandler(event: any, filePath: string): void;
+    trackByQuestionId(index: number, question: AssessmentQuestion): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<QuestionBankPickerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<QuestionBankPickerComponent, "lib-question-bank-picker", never, {}, {}, never, never>;
+}

package/lib/modules/assessment-maker/components/question-details/question-details.component.d.ts

@@ -13,6 +13,7 @@ export declare class QuestionDetailsComponent implements AfterViewInit {
         [key: string]: string;
     };
     allowDelete: boolean;
+    isLocked: boolean;
     editQuestion: EventEmitter<{
         questionId: any;
         isChildQuestion: boolean;
@@ -29,9 +30,13 @@ export declare class QuestionDetailsComponent implements AfterViewInit {
     ngAfterViewInit(): void;
     toggleText(): void;
     checkOverflow(): void;
+    onQuestionClick(event: Event, questionId: any, isChild?: boolean): void;
     capitalizeFirst(text: string | undefined): string;
     imageErrorHandler(event: any, filePath: string): void;
     childQuestionPresent(question: AssessmentQuestion): boolean | undefined;
+    trackByOptionId(index: number, option: any): string;
+    trackByChildId(index: number, id: any): string;
+    trackBySkillCode(index: number, skill: any): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<QuestionDetailsComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<QuestionDetailsComponent, "lib-question-details", never, { "sectionQuestion": "sectionQuestion"; "question": "question"; "questionBank": "questionBank"; "labelConfig": "labelConfig"; "imageConfig": "imageConfig"; "allowDelete": "allowDelete"; }, { "editQuestion": "editQuestion"; "duplicateQuestion": "duplicateQuestion"; "deleteParentQuestion": "deleteParentQuestion"; "deleteChildQuestion": "deleteChildQuestion"; }, never, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<QuestionDetailsComponent, "lib-question-details", never, { "sectionQuestion": "sectionQuestion"; "question": "question"; "questionBank": "questionBank"; "labelConfig": "labelConfig"; "imageConfig": "imageConfig"; "allowDelete": "allowDelete"; "isLocked": "isLocked"; }, { "editQuestion": "editQuestion"; "duplicateQuestion": "duplicateQuestion"; "deleteParentQuestion": "deleteParentQuestion"; "deleteChildQuestion": "deleteChildQuestion"; }, never, never>;
 }

package/lib/modules/assessment-maker/services/assessment-builder.service.d.ts

@@ -1,4 +1,4 @@
-import { Assessment, AssessmentInstance } from '../../../shared/interfaces/assessment.interface';
+import { Assessment, AssessmentInstance, Config } from '../../../shared/interfaces/assessment.interface';
 import { QuestionPaperSection, SectionQuestion, AssessmentQuestionPaper } from '../../../shared/interfaces/question-paper.interface';
 import { AssessmentQuestion } from '../../../shared/interfaces/question.interface';
 import * as i0 from "@angular/core";
@@ -39,8 +39,15 @@ export declare class AssessmentBuilderService {
     createNewSection(sequence: number): QuestionPaperSection;
     generateSectionQuestion(question: AssessmentQuestion, sectionQuestion?: SectionQuestion): SectionQuestion;
     generateQuestionPaperDTO(questionPaper: AssessmentQuestionPaper, questionBank: Record<number, AssessmentQuestion>): AssessmentQuestionPaper;
-    generateAssessmentDTO(assessmentId: number, questionPaper: AssessmentQuestionPaper): Assessment;
-    generateAssessmentInstanceDTO(assessmentId: number, predefinedAssessmentInstance: AssessmentInstance): AssessmentInstance;
+    generateAssessmentDTO(assessmentId: number, questionPaper: AssessmentQuestionPaper, assessmentConfigs?: Config[]): Assessment;
+    generateAssessmentInstanceDTO(assessmentId: number, predefinedAssessmentInstance: AssessmentInstance, duration?: number): AssessmentInstance;
+    /**
+     * Patch fragment carrying the duration onto an already-created instance (by id), to bundle into
+     * the assessment/question-paper patch. Empty unless the time input is enabled and an instance exists.
+     */
+    buildInstancePatch(showTimeInput: boolean, assessmentInstanceId: number, durationSeconds: number): {
+        assessmentInstance?: AssessmentInstance;
+    };
     static ɵfac: i0.ɵɵFactoryDeclaration<AssessmentBuilderService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AssessmentBuilderService>;
 }

package/lib/modules/assessment-maker/services/assessment-maker.service.d.ts

@@ -1,4 +1,5 @@
 import { HttpClient, HttpParams } from '@angular/common/http';
+import { Observable } from 'rxjs';
 import * as i0 from "@angular/core";
 export declare class AssessmentMakerService {
     private http;
@@ -6,19 +7,22 @@ export declare class AssessmentMakerService {
     constructor(http: HttpClient);
     private getHeaders;
     createParams(params: any): HttpParams;
-    getConfigJSON(fileName: string): import("rxjs").Observable<Object>;
-    createAssessmentAndQuestionPaper(payload: any): import("rxjs").Observable<Object>;
-    patchAssessmentAndQuestionPaper(payload: any): import("rxjs").Observable<Object>;
-    createQuestion(payload: any): import("rxjs").Observable<Object>;
-    patchQuestion(payload: any): import("rxjs").Observable<Object>;
+    getConfigJSON(fileName: string): Observable<Object>;
+    getResponseCount(assessmentInstanceId: number): Observable<Object>;
+    createAssessmentAndQuestionPaper(payload: any): Observable<Object>;
+    patchAssessmentAndQuestionPaper(payload: any): Observable<Object>;
+    createQuestion(payload: any): Observable<Object>;
+    patchQuestion(payload: any): Observable<Object>;
     getQuestionsByIds(params: {
         questionIds: number[];
-    }): import("rxjs").Observable<Object>;
-    getAssessmentContext(params: any): import("rxjs").Observable<Object>;
-    duplicateSection(questionPaperId: number, sectionId: number): import("rxjs").Observable<Object>;
-    duplicateQuestion(sectionId: number, sectionQuestionId: number): import("rxjs").Observable<Object>;
-    createAssessmentInstance(payload: any): import("rxjs").Observable<Object>;
-    getRefDataByCode(code: string, params: any): import("rxjs").Observable<Object>;
+    }): Observable<Object>;
+    getAssessmentContext(params: any): Observable<Object>;
+    duplicateSection(questionPaperId: number, sectionId: number): Observable<Object>;
+    duplicateQuestion(sectionId: number, sectionQuestionId: number): Observable<Object>;
+    createAssessmentInstance(payload: any): Observable<Object>;
+    getRefDataByCode(code: string, params: any): Observable<Object>;
+    getQuestionBankQuestions(params: any): Observable<Object>;
+    checkQuestionsLocked(questionIds: (number | string)[], scope?: string): Observable<Record<string, boolean>>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AssessmentMakerService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AssessmentMakerService>;
 }

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

@@ -1,4 +1,5 @@
 import { EventEmitter, OnInit, OnDestroy, ChangeDetectorRef } from '@angular/core';
+import { Observable } from 'rxjs';
 import { MatDialog } from '@angular/material/dialog';
 import { FormBuilder, FormControl, FormGroup } from '@angular/forms';
 import { DomSanitizer } from '@angular/platform-browser';
@@ -7,6 +8,7 @@ import { ResponseBuilderService } from './services/response-builder.service';
 import { AssesseeDTO, AssessorDTO, Assessment, AssessmentInstanceAssesseDTO, AssessmentStep, AssessmentContextDTO, SectionScore, SkillScore } from '../../shared/interfaces/assessment.interface';
 import { AssessmentQuestion } from '../../shared/interfaces/question.interface';
 import { AssessmentQuestionPaper, QuestionPaperSection } from '../../shared/interfaces/question-paper.interface';
+import { ProctoringService } from './services/proctoring.service';
 import * as i0 from "@angular/core";
 export declare class AssessmentTakerComponent implements OnInit, OnDestroy {
     private assessmentTakerService;
@@ -15,6 +17,7 @@ export declare class AssessmentTakerComponent implements OnInit, OnDestroy {
     private sanitizer;
     private dialog;
     private cdr;
+    private proctoringService;
     labelConfig: {
         [key: string]: string;
     };
@@ -39,13 +42,20 @@ export declare class AssessmentTakerComponent implements OnInit, OnDestroy {
     };
     showOverallRemarks: boolean;
     showCorrectAnswers: boolean;
+    resumeTimerAcrossVisits: boolean;
+    warnOnLeaveDuringProctoring: boolean;
+    proctorLinkLoader?: () => Promise<any>;
     snackbarMessage: EventEmitter<{
         message: string;
         type: 'success' | 'error' | 'info';
     }>;
     submitAssessment: EventEmitter<any>;
     stepChanged: EventEmitter<AssessmentStep>;
+    consentToProceed: EventEmitter<boolean>;
     showLoader: boolean;
+    introActive: boolean;
+    private proctoringSessionStarted;
+    private proctoringSessionEnded;
     questionBank: Record<number, AssessmentQuestion>;
     assessmentQuestionPaperData: AssessmentQuestionPaper;
     assessmentData: Assessment;
@@ -53,6 +63,7 @@ export declare class AssessmentTakerComponent implements OnInit, OnDestroy {
     timerInterval: any;
     remainingTime: number;
     displayTime: string;
+    timeExpired: boolean;
     isAutoSubmitting: boolean;
     isSubmitting: boolean;
     sectionFormGroups: {
@@ -62,6 +73,9 @@ export declare class AssessmentTakerComponent implements OnInit, OnDestroy {
     overallNotesCtrl: FormControl;
     expandedState: boolean[];
     private youtubeUrlCache;
+    private newAssesseeSession;
+    private backGuardArmed;
+    private allowBackNavigation;
     private _selectedTabIndex;
     get selectedTabIndex(): number;
     set selectedTabIndex(value: number);
@@ -70,13 +84,72 @@ export declare class AssessmentTakerComponent implements OnInit, OnDestroy {
     tooltipState: Record<number, boolean>;
     isMobile: boolean;
     onResize(): void;
-    constructor(assessmentTakerService: AssessmentTakerService, fb: FormBuilder, responseBuilderService: ResponseBuilderService, sanitizer: DomSanitizer, dialog: MatDialog, cdr: ChangeDetectorRef);
+    /**
+     * 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;
+    /**
+     * Ends the proctoring session after the assessment is submitted: stops + destroys the ProctorLink
+     * SDK and notifies the backend to end the session. Only ends a session that actually started, and
+     * is guarded so the backend is called at most once.
+     */
+    private endProctoringSession;
     getConfigsFromJSON(): void;
     loadAssessmentData(): void;
     handleResponse(): void;
     formSetup(): void;
+    private startAssessment;
+    get isProctoringEnabled(): boolean;
+    /**
+     * The full-screen intro gate is shown when proctoring is enabled, or when a timed assessment tracks
+     * elapsed time across visits (so the assessee is created up front to anchor the timer).
+     */
+    private requiresStartGate;
+    /** A reference image is captured only for proctoring, and only on the first attempt (no assessee id yet). */
+    get requireReferenceCapture(): boolean;
+    get totalSectionCount(): number;
+    get totalQuestionCount(): number;
+    get assessmentDurationSeconds(): number;
+    startSessionAction: (referenceImageBase64: string) => Observable<any>;
+    onIntroProceeded(): void;
+    /**
+     * Creates the assessee up front when the candidate proceeds from the intro gate.
+     * - First attempt (no assessee id): POST creates the assessee — for proctoring the response carries
+     *   a nested `proctoring` session; otherwise it's a plain assessee DTO (with `createdAt`).
+     * - Existing attempt: proctoring refreshes the token (flat ProctoringSession); non-proctoring is a no-op
+     *   (the assessee was already loaded, so `createdAt` is known).
+     * When proctoring is enabled it then starts the ProctorLink SDK and waits for camera permission.
+     */
+    private startAssessmentSession;
+    /**
+     * Re-mints the proctoring token via the refresh API and returns ONLY the new provider JWT
+     * (used by the SDK's token-expired flow). The rest of the refresh response is intentionally
+     * ignored — the live session must not be re-seeded from it mid-attempt.
+     */
+    private refreshProctoringJwt;
+    private buildInitAssesseePayload;
+    private beginAssessment;
+    /**
+     * Starts a timer anchored to the assessee's first-visit time. The assessee is already created by the
+     * intro gate (so `createdAt` is known); remaining time is `duration - elapsedSinceCreatedAt`.
+     * If the time has already run out (candidate left and returned late), shows 00:00 and auto-submits.
+     */
+    private beginTrackedTimer;
     updateQuestionConditionalControls(fg: FormGroup, question: AssessmentQuestion): void;
     emitStepDetails(): void;
     addControlForQuestion(group: any, question: AssessmentQuestion, isMandatory?: boolean, isChild?: boolean, parentId?: number, parentOptionId?: number): void;
@@ -91,6 +164,7 @@ export declare class AssessmentTakerComponent implements OnInit, OnDestroy {
     getMaxCharCount(question: AssessmentQuestion): number;
     getRemainingChars(question: AssessmentQuestion, control: any): number;
     goBack(): void;
+    get isCheckingLink(): boolean;
     shouldDisableTab(index: number): boolean;
     goNext(saveData?: boolean): void;
     processSubmit(saveData?: boolean): void;
@@ -102,11 +176,16 @@ export declare class AssessmentTakerComponent implements OnInit, OnDestroy {
     openInstructionsDialog(section: QuestionPaperSection): void;
     checkMaxVal(event: any, control: any, maxVal: number | undefined): void;
     preventNegativeInput(event: KeyboardEvent): void;
+    openProctoringResult(): void;
     openSkillAllocationDialog(skillList?: SkillScore[]): void;
     startTimer(durationInSeconds: number): void;
     updateDisplayTime(): void;
     autoSubmit(): void;
     disableForm(): void;
+    trackBySectionId(index: number, section: any): string;
+    trackBySectionQuestion(index: number, sq: any): string;
+    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"; }, { "snackbarMessage": "snackbarMessage"; "submitAssessment": "submitAssessment"; "stepChanged": "stepChanged"; }, 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/assessment-taker.module.d.ts

@@ -9,12 +9,14 @@ import * as i7 from "./components/question-type-preference/question-type-prefere
 import * as i8 from "./components/question-type-short/question-type-short.component";
 import * as i9 from "./components/section-instructions/section-instructions.component";
 import * as i10 from "./components/question-type-date-picker/question-type-date-picker.component";
-import * as i11 from "@angular/common";
-import * as i12 from "../../shared/shared.module";
-import * as i13 from "../../shared/material-modules";
-import * as i14 from "@angular/forms";
+import * as i11 from "./components/proctoring-result/proctoring-result.component";
+import * as i12 from "./components/proctoring-consent/proctoring-consent.component";
+import * as i13 from "@angular/common";
+import * as i14 from "../../shared/shared.module";
+import * as i15 from "../../shared/material-modules";
+import * as i16 from "@angular/forms";
 export declare class AssessmentTakerModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<AssessmentTakerModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<AssessmentTakerModule, [typeof i1.AssessmentTakerComponent, typeof i2.QuestionTypeEditorComponent, typeof i3.QuestionTypeFileUploadComponent, typeof i4.QuestionTypeLongComponent, typeof i5.QuestionTypeMultiselectComponent, typeof i6.QuestionTypeObjectiveComponent, typeof i7.QuestionTypePreferenceComponent, typeof i8.QuestionTypeShortComponent, typeof i9.SectionInstructionsComponent, typeof i10.QuestionTypeDatePickerComponent], [typeof i11.CommonModule, typeof i12.SharedModule, typeof i13.MaterialModules, typeof i14.FormsModule, typeof i14.ReactiveFormsModule], [typeof i1.AssessmentTakerComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<AssessmentTakerModule, [typeof i1.AssessmentTakerComponent, typeof i2.QuestionTypeEditorComponent, typeof i3.QuestionTypeFileUploadComponent, typeof i4.QuestionTypeLongComponent, typeof i5.QuestionTypeMultiselectComponent, typeof i6.QuestionTypeObjectiveComponent, typeof i7.QuestionTypePreferenceComponent, typeof i8.QuestionTypeShortComponent, typeof i9.SectionInstructionsComponent, typeof i10.QuestionTypeDatePickerComponent, typeof i11.ProctoringResultComponent, typeof i12.ProctoringConsentComponent], [typeof i13.CommonModule, typeof i14.SharedModule, typeof i15.MaterialModules, typeof i16.FormsModule, typeof i16.ReactiveFormsModule], [typeof i1.AssessmentTakerComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<AssessmentTakerModule>;
 }

package/lib/modules/assessment-taker/components/proctoring-consent/proctoring-consent.component.d.ts

@@ -0,0 +1,39 @@
+import { AfterViewInit, ElementRef, EventEmitter, OnDestroy } from '@angular/core';
+import { Observable } from 'rxjs';
+import * as i0 from "@angular/core";
+export declare class ProctoringConsentComponent implements AfterViewInit, OnDestroy {
+    videoRef: ElementRef<HTMLVideoElement>;
+    canvasRef: ElementRef<HTMLCanvasElement>;
+    labelConfig: {
+        [key: string]: string;
+    };
+    proctoringEnabled: boolean;
+    requireCapture: boolean;
+    sectionCount: number;
+    questionCount: number;
+    durationSeconds: number;
+    confirmAction?: (referenceImageBase64: string) => Observable<any>;
+    proceeded: EventEmitter<void>;
+    cameraReady: boolean;
+    cameraError: string;
+    captured: boolean;
+    capturedUrl: string;
+    starting: boolean;
+    startError: string;
+    private stream?;
+    private capturedBase64;
+    /** Proceed is allowed once a photo is captured, or immediately when no capture is required. */
+    get canProceed(): boolean;
+    get durationMinutes(): number;
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    startCamera(): void;
+    /** Grabs a still frame from the live preview into a JPEG (used as the reference image). */
+    capture(): void;
+    retake(): void;
+    /** Enabled only once a photo is captured (when required); runs the session-start action. */
+    proceed(): void;
+    private stopCamera;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ProctoringConsentComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ProctoringConsentComponent, "lib-proctoring-consent", never, { "labelConfig": "labelConfig"; "proctoringEnabled": "proctoringEnabled"; "requireCapture": "requireCapture"; "sectionCount": "sectionCount"; "questionCount": "questionCount"; "durationSeconds": "durationSeconds"; "confirmAction": "confirmAction"; }, { "proceeded": "proceeded"; }, never, never>;
+}

package/lib/modules/assessment-taker/components/proctoring-result/proctoring-result.component.d.ts

@@ -0,0 +1,82 @@
+import { OnInit } from '@angular/core';
+import { MatDialogRef } from '@angular/material/dialog';
+import { AssessmentTakerService } from '../../services/assessment-taker.service';
+import { ProctoringPayload, ProctoringReport, ProctoringSessionSummary } from '../../../../shared/interfaces/proctoring.interface';
+import * as i0 from "@angular/core";
+declare type ReportState = 'loading' | 'loaded' | 'empty' | 'error';
+export declare class ProctoringResultComponent implements OnInit {
+    dialogRef: MatDialogRef<ProctoringResultComponent>;
+    private assessmentTakerService;
+    data: {
+        labelConfig?: {
+            [key: string]: string;
+        };
+        imageConfig?: {
+            [key: string]: string;
+        };
+        assesseeId?: number;
+        assesseeName?: string;
+    };
+    labelConfig: {
+        [key: string]: string;
+    };
+    imageConfig: {
+        [key: string]: string;
+    };
+    assesseeId: number;
+    assesseeName: string;
+    sessions: ProctoringSessionSummary[];
+    loading: boolean;
+    errored: boolean;
+    totalElements: number;
+    last: boolean;
+    private page;
+    private readonly size;
+    reportBySession: {
+        [sessionId: number]: ProctoringReport;
+    };
+    reportState: {
+        [sessionId: number]: ReportState;
+    };
+    private parsedCache;
+    constructor(dialogRef: MatDialogRef<ProctoringResultComponent>, assessmentTakerService: AssessmentTakerService, data: {
+        labelConfig?: {
+            [key: string]: string;
+        };
+        imageConfig?: {
+            [key: string]: string;
+        };
+        assesseeId?: number;
+        assesseeName?: string;
+    });
+    ngOnInit(): void;
+    loadSessions(): void;
+    loadMore(): void;
+    /** Fetches the report for a session the first time its panel is expanded. */
+    loadReport(session: ProctoringSessionSummary): void;
+    trackBySessionId(_index: number, session: ProctoringSessionSummary): number;
+    trackByIndex(index: number): number;
+    /** Parses (and caches) the reportPayload JSON. Returns null if absent or not valid JSON. */
+    getParsedPayload(report: ProctoringReport): ProctoringPayload | null;
+    /** Formats a duration in seconds as `Mm Ss` (or `Ss` under a minute). */
+    formatDuration(seconds?: number): string;
+    /** Session timestamps are epoch milliseconds already; guard 0/undefined so nothing renders. */
+    toMillis(epochMillis?: number): number | null;
+    /**
+     * Theme badge classes for a session status.
+     * ACTIVE = running, VALIDATING = report in progress, VALIDATED = report ready,
+     * ENDED = stopped/invalidated, FAILED = errored.
+     */
+    statusBadgeClass(status?: string): string;
+    /** Maps a raw event code (e.g. `tab.hidden`) to a friendly label, falling back to the raw code. */
+    eventTypeLabel(type?: string): string;
+    /** Maps a raw reason code (e.g. `browser_activity`) to a friendly label, falling back to the raw code. */
+    reasonCodeLabel(code?: string): string;
+    /** Highlights integrity-relevant timeline events (tab switches, face issues, session markers). */
+    isNoteworthy(type?: string): boolean;
+    close(): void;
+    imageErrorHandler(event: any, filePath: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ProctoringResultComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ProctoringResultComponent, "lib-proctoring-result", never, {}, {}, never, never>;
+}
+export {};

package/lib/modules/assessment-taker/components/question-type-file-upload/question-type-file-upload.component.d.ts

@@ -38,6 +38,7 @@ export declare class QuestionTypeFileUploadComponent implements ControlValueAcce
     imageErrorHandler(event: any, filePath: string): void;
     getFileIcon(attachment: Attachment): string;
     viewFile(url: string): void;
+    trackByFile(index: number, file: Attachment): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<QuestionTypeFileUploadComponent, [{ optional: true; self: true; }, null]>;
     static ɵcmp: i0.ɵɵComponentDeclaration<QuestionTypeFileUploadComponent, "lib-question-type-file-upload", never, { "required": "required"; "assessmentInstanceId": "assessmentInstanceId"; "question": "question"; "labelConfig": "labelConfig"; "imageConfig": "imageConfig"; }, { "snackbarMessage": "snackbarMessage"; }, never, never>;
 }

package/lib/modules/assessment-taker/components/question-type-multiselect/question-type-multiselect.component.d.ts

@@ -29,6 +29,7 @@ export declare class QuestionTypeMultiselectComponent implements ControlValueAcc
     isEvaluationEnabled(): boolean;
     getSelectionStatus(option: any): string | null;
     imageErrorHandler(event: any, filePath: string): void;
+    trackByOptionId(index: number, option: any): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<QuestionTypeMultiselectComponent, [{ optional: true; self: true; }]>;
     static ɵcmp: i0.ɵɵComponentDeclaration<QuestionTypeMultiselectComponent, "lib-question-type-multiselect", never, { "required": "required"; "question": "question"; "showCorrectAnswers": "showCorrectAnswers"; "imageConfig": "imageConfig"; "answerObj": "answerObj"; }, { "viewChild": "viewChild"; }, never, never>;
 }