From 973c5bac83bc92280f43b586f2c5af35d0fafb93 Mon Sep 17 00:00:00 2001
From: Chneemann <andre-kempf@mailbox.org>
Date: Sat, 3 May 2025 09:46:19 +0200
Subject: [PATCH] refactor: improve readability and add JSDoc comments in
 VerifyEmailComponent

---
 .../verify-email/verify-email.component.ts    | 40 ++++++++++++++++---
 1 file changed, 34 insertions(+), 6 deletions(-)

diff --git a/frontend/src/app/components/auth/verify-email/verify-email.component.ts b/frontend/src/app/components/auth/verify-email/verify-email.component.ts
index 6f09858..853b1cf 100644
--- a/frontend/src/app/components/auth/verify-email/verify-email.component.ts
+++ b/frontend/src/app/components/auth/verify-email/verify-email.component.ts
@@ -1,9 +1,8 @@
 import { Component } from '@angular/core';
-import { ActivatedRoute, RouterLink } from '@angular/router';
+import { ActivatedRoute, Params, RouterLink } from '@angular/router';
 import { AuthService } from '../../../services/auth.service';
 import { ErrorService } from '../../../services/error.service';
 import { CommonModule } from '@angular/common';
-import { HttpErrorResponse } from '@angular/common/http';
 
 @Component({
   selector: 'app-verify-email',
@@ -21,27 +20,56 @@ export class VerifyEmailComponent {
     send: false,
   };
 
+  /**
+   * Initializes the VerifyEmailComponent with ActivatedRoute, AuthService, and ErrorService.
+   */
   constructor(
     private route: ActivatedRoute,
     private authService: AuthService,
     public errorService: ErrorService
   ) {}
 
+  /**
+   * Lifecycle hook that is called after data-bound properties are initialized.
+   * Subscribes to query parameters and triggers email verification.
+   */
   ngOnInit(): void {
+    this.handleQueryParams();
+  }
+
+  /**
+   * Subscribes to the query parameters from the route and extracts authentication data.
+   * Then triggers the email verification process.
+   */
+  private handleQueryParams(): void {
     this.route.queryParams.subscribe((params) => {
-      this.authData.mail = params['email'] || '';
-      this.authData.token = params['token'] || '';
+      this.extractAuthParams(params);
       this.verifyEmail();
     });
   }
 
-  async verifyEmail() {
+  /**
+   * Extracts the 'email' and 'token' parameters from the query and assigns them to authData.
+   *
+   * @param params The query parameters from the route.
+   */
+  private extractAuthParams(params: Params): void {
+    this.authData.mail = params['email'] || '';
+    this.authData.token = params['token'] || '';
+  }
+
+  /**
+   * Sends a request to verify the user's email using the extracted authentication data.
+   * Sets the appropriate flags based on the result and handles errors if any occur.
+   */
+  private async verifyEmail(): Promise<void> {
     const body = {
       email: this.authData.mail.toLowerCase(),
       token: this.authData.token,
     };
+
+    this.authData.send = true;
     try {
-      this.authData.send = true;
       await this.authService.verifyEmail(body);
       this.verified = true;
       this.errorService.clearError();