[SPDBT-4370] New/Expired License Flow to ask for Access Code (#2843)

# Description

This PR includes the following proposed change(s):

- {List all the changes, if possible add the jira ticket #}

Co-authored-by: Peggy <peggy.zhang@quartech.com>

Author: carolcarpenter

src/Spd.Presentation.Licensing/ClientApp/src/app/core/services/business-application.helper.ts

@@ -81,10 +81,6 @@ export abstract class BusinessApplicationHelper extends CommonApplicationHelper
 		}
 	);
 
-	swlLookupLicenceFormGroup: FormGroup = this.formBuilder.group({
-		licenceNumberLookup: new FormControl('', [FormControlValidators.required]),
-	});
-
 	soleProprietorFormGroup: FormGroup = this.formBuilder.group({
 		licenceNumberLookup: new FormControl('', [FormControlValidators.required]),
 	});

src/Spd.Presentation.Licensing/ClientApp/src/app/core/services/common-application.service.ts

@@ -1,4 +1,5 @@
 import { Injectable } from '@angular/core';
+import { FormBuilder, FormControl, FormGroup } from '@angular/forms';
 import { MatDialog } from '@angular/material/dialog';
 import { Router } from '@angular/router';
 import {
@@ -43,6 +44,7 @@ import { DialogComponent, DialogOptions } from '@app/shared/components/dialog.co
 import { OptionsPipe } from '@app/shared/pipes/options.pipe';
 import moment from 'moment';
 import { BehaviorSubject, Observable, forkJoin, map, of, switchMap } from 'rxjs';
+import { FormControlValidators } from '../validators/form-control.validators';
 import { AuthProcessService } from './auth-process.service';
 import { AuthUserBceidService } from './auth-user-bceid.service';
 import { AuthUserBcscService } from './auth-user-bcsc.service';
@@ -97,7 +99,20 @@ export class CommonApplicationService {
 		'Security Services Application',
 	]);
 
+	swlLookupLicenceFormGroup: FormGroup = this.formBuilder.group({
+		licenceNumberLookup: new FormControl('', [FormControlValidators.required]),
+	});
+
+	swlLookupLicenceAnonymousFormGroup: FormGroup = this.formBuilder.group({
+		licenceNumberLookup: new FormControl('', [FormControlValidators.required]),
+		accessCode: new FormControl('', [FormControlValidators.required]),
+		captchaFormGroup: new FormGroup({
+			token: new FormControl('', FormControlValidators.required),
+		}),
+	});
+
 	constructor(
+		private formBuilder: FormBuilder,
 		private router: Router,
 		private dialog: MatDialog,
 		private optionsPipe: OptionsPipe,
@@ -722,6 +737,21 @@ export class CommonApplicationService {
 			);
 	}
 
+	getLicenceNumberAccessCodeLookupAnonymous(
+		licenceNumber: string,
+		accessCode: string,
+		recaptchaCode: string
+	): Observable<LicenceLookupResult> {
+		return this.licenceService
+			.apiLicenceLookupAnonymousLicenceNumberPost({ licenceNumber, accessCode, body: { recaptchaCode } })
+			.pipe(
+				switchMap((resp: LicenceResponse) => {
+					const lookupResp = this.getLicenceSearchFlags(resp);
+					return of(lookupResp);
+				})
+			);
+	}
+
 	getLicenceNumberLookup(licenceNumber: string): Observable<LicenceLookupResult> {
 		return this.licenceService.apiLicenceLookupLicenceNumberGet({ licenceNumber }).pipe(
 			switchMap((resp: LicenceResponse) => {
@@ -735,7 +765,8 @@ export class CommonApplicationService {
 		licence: LicenceResponse | null,
 		serviceTypeCode: ServiceTypeCode,
 		isExpired: boolean,
-		isInRenewalPeriod: boolean
+		isInRenewalPeriod: boolean,
+		useAccessCode: boolean = false
 	): [string | null, string | null] {
 		let messageWarn = null;
 		let messageError = null;
@@ -755,21 +786,25 @@ export class CommonApplicationService {
 				}
 			}
 		} else {
-			messageError = this.getLicenceLookupNoMatchErrorMessage(serviceTypeCode);
+			messageError = this.getLicenceLookupNoMatchErrorMessage(serviceTypeCode, useAccessCode);
 		}
 
 		return [messageWarn, messageError];
 	}
 
-	setLicenceLookupMessage(licence: LicenceResponse | null, serviceTypeCode: ServiceTypeCode): string | null {
+	setLicenceLookupMessage(
+		licence: LicenceResponse | null,
+		serviceTypeCode: ServiceTypeCode,
+		useAccessCode: boolean = false
+	): string | null {
 		let messageError = null;
 
 		if (licence) {
 			if (licence.serviceTypeCode !== serviceTypeCode) {
 				messageError = this.getLicenceLookupServiceTypeCodeMismatchErrorMessage(serviceTypeCode);
 			}
 		} else {
-			messageError = this.getLicenceLookupNoMatchErrorMessage(serviceTypeCode);
+			messageError = this.getLicenceLookupNoMatchErrorMessage(serviceTypeCode, useAccessCode);
 		}
 
 		return messageError;
@@ -1004,9 +1039,16 @@ export class CommonApplicationService {
 		return `The ${typeLabel} number you entered is not a ${serviceTypeCodeDesc}.`;
 	}
 
-	private getLicenceLookupNoMatchErrorMessage(serviceTypeCode: ServiceTypeCode): string {
+	private getLicenceLookupNoMatchErrorMessage(
+		serviceTypeCode: ServiceTypeCode,
+		useAccessCode: boolean = false
+	): string {
 		const typeLabel = this.getLicenceTypeName(serviceTypeCode);
 
+		if (useAccessCode) {
+			return `This ${typeLabel} number and access code are not a valid combination.`;
+		}
+
 		if (serviceTypeCode === ServiceTypeCode.SecurityBusinessLicence) {
 			return `The ${typeLabel} number you entered does not match any existing records in our system for your business in BC.`;
 		} else {

src/Spd.Presentation.Licensing/ClientApp/src/app/modules/personal-licence-application/components/shared/worker-licence-wizard-step-components/step-worker-licence-expired.component.ts

@@ -1,4 +1,4 @@
-import { Component, Input } from '@angular/core';
+import { Component, Input, OnInit } from '@angular/core';
 import { FormGroup } from '@angular/forms';
 import { ServiceTypeCode } from '@app/api/models';
 import { SPD_CONSTANTS } from '@app/core/constants/constants';
@@ -25,14 +25,16 @@ import { WorkerApplicationService } from '@app/core/services/worker-application.
 				[form]="form"
 				[isLoggedIn]="isLoggedIn"
 				[serviceTypeCode]="securityWorkerLicenceCode"
+				[useAccessCode]="useAccessCode"
 			></app-form-expired-licence>
 		</app-step-section>
 	`,
 	styles: [],
 	standalone: false,
 })
-export class StepWorkerLicenceExpiredComponent implements LicenceChildStepperStepComponent {
+export class StepWorkerLicenceExpiredComponent implements OnInit, LicenceChildStepperStepComponent {
 	spdPhoneNumber = SPD_CONSTANTS.phone.spdPhoneNumber;
+	useAccessCode!: boolean;
 
 	form: FormGroup = this.workerApplicationService.expiredLicenceFormGroup;
 	securityWorkerLicenceCode = ServiceTypeCode.SecurityWorkerLicence;
@@ -41,6 +43,10 @@ export class StepWorkerLicenceExpiredComponent implements LicenceChildStepperSte
 
 	constructor(private workerApplicationService: WorkerApplicationService) {}
 
+	ngOnInit(): void {
+		this.useAccessCode = !this.isLoggedIn;
+	}
+
 	isFormValid(): boolean {
 		this.form.markAllAsTouched();
 		return this.form.valid;

src/Spd.Presentation.Licensing/ClientApp/src/app/shared/components/form-access-code-anonymous.component.ts

@@ -148,46 +148,15 @@ export class FormAccessCodeAnonymousComponent implements OnInit {
 			return;
 		}
 
-		switch (this.serviceTypeCode) {
-			case ServiceTypeCode.SecurityWorkerLicence: {
-				this.commonApplicationService
-					.getLicenceWithAccessCodeAnonymous(licenceNumber, accessCode, recaptchaCode)
-					.pipe(
-						tap((resp: LicenceResponseExt | null) => {
-							this.handleLookupResponse(resp);
-						}),
-						take(1)
-					)
-					.subscribe();
-				break;
-			}
-			// SPDBT-3425 - Remove anonymous permit flows
-			// case ServiceTypeCode.ArmouredVehiclePermit:
-			// case ServiceTypeCode.BodyArmourPermit: {
-			// 	this.commonApplicationService
-			// 		.getLicenceWithAccessCodeAnonymous(licenceNumber, accessCode, recaptchaCode)
-			// 		.pipe(
-			// 			tap((resp: LicenceResponse) => {
-			// 				this.handleLookupResponse(resp);
-			// 			}),
-			// 			take(1)
-			// 		)
-			// 		.subscribe();
-			// 	break;
-			// }
-			case ServiceTypeCode.Mdra: {
-				this.commonApplicationService
-					.getLicenceWithAccessCodeAnonymous(licenceNumber, accessCode, recaptchaCode)
-					.pipe(
-						tap((resp: LicenceResponseExt | null) => {
-							this.handleLookupResponse(resp);
-						}),
-						take(1)
-					)
-					.subscribe();
-				break;
-			}
-		}
+		this.commonApplicationService
+			.getLicenceWithAccessCodeAnonymous(licenceNumber, accessCode, recaptchaCode)
+			.pipe(
+				tap((resp: LicenceResponseExt | null) => {
+					this.handleLookupResponse(resp);
+				}),
+				take(1)
+			)
+			.subscribe();
 	}
 
 	onCreateNewLicence(): void {

src/Spd.Presentation.Licensing/ClientApp/src/app/shared/components/form-expired-licence.component.ts

@@ -7,6 +7,7 @@ import { BooleanTypeCode } from '@app/core/code-types/model-desc.models';
 import { SPD_CONSTANTS } from '@app/core/constants/constants';
 import { CommonApplicationService } from '@app/core/services/common-application.service';
 import { OptionsPipe } from '@app/shared/pipes/options.pipe';
+import { ModalLookupByLicenceNumberAccessCodeComponent } from './modal-lookup-by-licence-number-access-code.component';
 import {
 	LookupByLicenceNumberDialogData,
 	ModalLookupByLicenceNumberComponent,
@@ -100,6 +101,7 @@ export class FormExpiredLicenceComponent implements OnInit {
 	@Input() isLoggedIn!: boolean;
 	@Input() form!: FormGroup;
 	@Input() serviceTypeCode!: ServiceTypeCode;
+	@Input() useAccessCode = false;
 
 	constructor(
 		private dialog: MatDialog,
@@ -120,6 +122,32 @@ export class FormExpiredLicenceComponent implements OnInit {
 			typeLabel: this.typeLabel,
 			isLoggedIn: this.isLoggedIn,
 		};
+
+		if (this.useAccessCode) {
+			this.dialog
+				.open(ModalLookupByLicenceNumberAccessCodeComponent, {
+					width: '800px',
+					data: dialogOptions,
+					autoFocus: true,
+				})
+				.afterClosed()
+				.subscribe((resp: any) => {
+					if (resp?.data) {
+						this.form.patchValue(
+							{
+								expiredLicenceId: resp.data.licenceId,
+								expiredLicenceHolderName: resp.data.licenceHolderName,
+								expiredLicenceNumber: resp.data.licenceNumber,
+								expiredLicenceExpiryDate: resp.data.expiryDate,
+								expiredLicenceStatusCode: resp.data.licenceStatusCode,
+							},
+							{ emitEvent: false }
+						);
+					}
+				});
+			return;
+		}
+
 		this.dialog
 			.open(ModalLookupByLicenceNumberComponent, {
 				width: '800px',