Squashed commit of the following:

commit 95d7e3b
Author: Freek Bes <[email protected]>
Date:   Mon Aug 11 16:27:05 2025 +0200

    update comment

commit d2d2429
Author: Freek Bes <[email protected]>
Date:   Mon Aug 11 16:11:43 2025 +0200

    allow blocking on authenticationComplete event

    can be useful for animations or for blocking actions

Author: FreekBes

client/auth.ts

@@ -8,8 +8,14 @@ export interface AuthenticatorEvents {
 
 	/**
 	 * This event gets called when the login process completes without error.
+	 * The event handler must return a Promise that resolves to a boolean value.
+	 * When this value is true, the user session will be started.
+	 * Otherwise, the user will be returned to the greeter.
+	 * This allows for custom handling of the authentication result or adding another form on top.
+	 * The AuthenticationFailure event is not called afterwards, so update the UI accordingly if
+	 * false is returned.
 	 */
-	authenticationComplete: () => void;
+	authenticationComplete: () => Promise<boolean>;
 
 	/**
 	 * This event gets called when the login process fails due to an authentication failure (wrong username or password).
@@ -103,27 +109,31 @@ export class Authenticator {
 		});
 
 		// This event gets called when LightDM says the authentication was successful and a session should be started
-		lightdm.authentication_complete.connect(() => {
+		lightdm.authentication_complete.connect(async () => {
 			try {
-				this._authenticating = false;
 				console.log("LightDM authentication complete. Checking results...");
-				if (lightdm.is_authenticated) {
-					this._authenticated = true;
-					console.log("LightDM authentication successful! Starting session...");
+				if (!lightdm.is_authenticated) {
+					this._authenticating = false;
+					console.log("LightDM authentication failed. User not found or password incorrect.");
+					this._stopAuthentication();
 					if (this._authEvents) {
-						this._authEvents.authenticationComplete();
+						this._authEvents.authenticationFailure();
 					}
+					return;
+				}
+				this._authenticated = true;
+				this._authenticating = false;
+				console.log("LightDM authentication successful! Starting session...");
+				const eventResult = (this._authEvents) ? await this._authEvents.authenticationComplete() : Promise.resolve(true);
+				if (eventResult) {
 					lightdm.start_session(this._session ?? null);
 				}
 				else {
-					console.log("LightDM authentication failed. User not found or password incorrect.");
 					this._stopAuthentication();
-					if (this._authEvents) {
-						this._authEvents.authenticationFailure();
-					}
 				}
 			}
 			catch (err) {
+				this._authenticating = false;
 				window.ui.setDebugInfo(String(err));
 				if (this._authEvents) {
 					this._authEvents.errorMessage(String(err));

client/uis/screens/examscreen.ts

@@ -17,8 +17,9 @@ export class ExamModeUI extends UIScreen {
 		authenticationStart: () => {
 			this._disableForm();
 		},
-		authenticationComplete: () => {
+		authenticationComplete: async () => {
 			// TODO: add loading animation here
+			return true;
 		},
 		authenticationFailure: () => {
 			this._enableForm();

client/uis/screens/lockscreen.ts

@@ -14,8 +14,9 @@ export class LockScreenUI extends UIScreen {
 		authenticationStart: () => {
 			this._disableForm();
 		},
-		authenticationComplete: () => {
+		authenticationComplete: async () => {
 			// TODO: Add a loading animation here
+			return true;
 		},
 		authenticationFailure: () => {
 			this._enableForm();

client/uis/screens/loginscreen.ts

@@ -7,8 +7,9 @@ export class LoginScreenUI extends UIScreen {
 		authenticationStart: () => {
 			this._disableForm();
 		},
-		authenticationComplete: () => {
+		authenticationComplete: async () => {
 			// TODO: Add a loading animation here
+			return true;
 		},
 		authenticationFailure: () => {
 			this._enableForm();