Implement getting email from Authenticator instance

Author: Greg Bowler

src/Authenticator.php

@@ -83,6 +83,11 @@ public function getUuid():string {
 		return $userData->getUuid();
 	}
 
+	public function getEmail():string {
+		$userData = $this->sessionData->getUserData();
+		return $userData->getEmail();
+	}
+
 	private function authInProgress():bool {
 		return false;
 	}

src/UserData.php

@@ -3,8 +3,13 @@
 
 class UserData {
 	private string $uuid;
+	private string $email;
 
 	public function getUuid():string {
 		return $this->uuid;
 	}
+
+	public function getEmail():string {
+		return $this->email;
+	}
 }

test/phpunit/AuthenticatorTest.php

@@ -201,4 +201,36 @@ public function testGetUuid() {
 		);
 		self::assertEquals($expectedUuid, $sut->getUuid());
 	}
+
+	public function testGetEmailThrowsExceptionWhenNotLoggedIn() {
+		$_SESSION = [];
+		$sut = new Authenticator(
+			"test-key",
+			"test-secret",
+			"/"
+		);
+		self::expectException(NotLoggedInException::class);
+		$sut->getEmail();
+	}
+
+	public function testGetEmail() {
+		$expectedEmail = "example@example.com";
+
+		$userData = self::createMock(UserData::class);
+		$userData->method("getEmail")
+			->willReturn($expectedEmail);
+		$sessionData = self::createMock(SessionData::class);
+		$sessionData->method("getUserData")
+			->willReturn($userData);
+
+		$_SESSION = [
+			Authenticator::SESSION_KEY => $sessionData,
+		];
+		$sut = new Authenticator(
+			"test-key",
+			"test-secret",
+			"/"
+		);
+		self::assertEquals($expectedEmail, $sut->getEmail());
+	}
 }