working companion prototype

packages/application/use-cases/CheckAuthenticationUseCase.ts

@@ -0,0 +1,22 @@
+import { AuthenticationState } from '../../domain/value-objects/AuthenticationState';
+import { Result } from '../../shared/result/Result';
+import type { IAuthenticationService } from '../ports/IAuthenticationService';
+
+/**
+ * Use case for checking if the user has a valid iRacing session.
+ * 
+ * This validates the session before automation starts, allowing
+ * the system to prompt for re-authentication if needed.
+ */
+export class CheckAuthenticationUseCase {
+  constructor(private readonly authService: IAuthenticationService) {}
+
+  /**
+   * Execute the authentication check.
+   * 
+   * @returns Result containing the current AuthenticationState
+   */
+  async execute(): Promise<Result<AuthenticationState>> {
+    return this.authService.checkSession();
+  }
+}

packages/application/use-cases/ClearSessionUseCase.ts

@@ -0,0 +1,21 @@
+import { Result } from '../../shared/result/Result';
+import type { IAuthenticationService } from '../ports/IAuthenticationService';
+
+/**
+ * Use case for clearing the user's session (logout).
+ * 
+ * Removes stored browser context and cookies, effectively logging
+ * the user out. The next automation attempt will require re-authentication.
+ */
+export class ClearSessionUseCase {
+  constructor(private readonly authService: IAuthenticationService) {}
+
+  /**
+   * Execute the session clearing.
+   * 
+   * @returns Result indicating success or failure
+   */
+  async execute(): Promise<Result<void>> {
+    return this.authService.clearSession();
+  }
+}

packages/application/use-cases/InitiateLoginUseCase.ts

@@ -0,0 +1,23 @@
+import { Result } from '../../shared/result/Result';
+import type { IAuthenticationService } from '../ports/IAuthenticationService';
+
+/**
+ * Use case for initiating the manual login flow.
+ * 
+ * Opens a visible browser window where the user can log into iRacing directly.
+ * GridPilot never sees the credentials - it only waits for the URL to change
+ * indicating successful login.
+ */
+export class InitiateLoginUseCase {
+  constructor(private readonly authService: IAuthenticationService) {}
+
+  /**
+   * Execute the login flow.
+   * Opens browser and waits for user to complete manual login.
+   * 
+   * @returns Result indicating success (login complete) or failure (cancelled/timeout)
+   */
+  async execute(): Promise<Result<void>> {
+    return this.authService.initiateLogin();
+  }
+}