wip

packages/application/ports/IAuthenticationService.ts

@@ -1,9 +1,10 @@
 import { AuthenticationState } from '../../domain/value-objects/AuthenticationState';
+import { BrowserAuthenticationState } from '../../domain/value-objects/BrowserAuthenticationState';
 import { Result } from '../../shared/result/Result';
 
 /**
  * Port for authentication services implementing zero-knowledge login.
- * 
+ *
  * GridPilot never sees, stores, or transmits user credentials.
  * Authentication is handled by opening a visible browser window where
  * the user logs in directly with iRacing. GridPilot only observes
@@ -13,7 +14,7 @@ export interface IAuthenticationService {
   /**
    * Check if user has a valid session without prompting login.
    * Navigates to a protected iRacing page and checks for login redirects.
-   * 
+   *
    * @returns Result containing the current authentication state
    */
   checkSession(): Promise<Result<AuthenticationState>>;
@@ -22,7 +23,7 @@ export interface IAuthenticationService {
    * Open browser for user to login manually.
    * The browser window is visible so user can verify they're on the real iRacing site.
    * GridPilot waits for URL change indicating successful login.
-   * 
+   *
    * @returns Result indicating success (login complete) or failure (cancelled/timeout)
    */
   initiateLogin(): Promise<Result<void>>;
@@ -30,7 +31,7 @@ export interface IAuthenticationService {
   /**
    * Clear the persistent session (logout).
    * Removes stored browser context and cookies.
-   * 
+   *
    * @returns Result indicating success or failure
    */
   clearSession(): Promise<Result<void>>;
@@ -38,8 +39,38 @@ export interface IAuthenticationService {
   /**
    * Get current authentication state.
    * Returns cached state without making network requests.
-   * 
+   *
    * @returns The current AuthenticationState
    */
   getState(): AuthenticationState;
+
+  /**
+   * Validate session with server-side check.
+   * Makes a lightweight HTTP request to verify cookies are still valid on the server.
+   *
+   * @returns Result containing true if server confirms validity, false otherwise
+   */
+  validateServerSide(): Promise<Result<boolean>>;
+
+  /**
+   * Refresh session state from cookie store.
+   * Re-reads cookies and updates internal state without server validation.
+   *
+   * @returns Result indicating success or failure
+   */
+  refreshSession(): Promise<Result<void>>;
+
+  /**
+   * Get session expiry date.
+   * Returns the expiry time extracted from session cookies.
+   *
+   * @returns Result containing the expiry Date or null if no expiration
+   */
+  getSessionExpiry(): Promise<Result<Date | null>>;
+
+  /**
+   * Verify browser page shows authenticated state.
+   * Checks page content for authentication indicators.
+   */
+  verifyPageAuthentication(): Promise<Result<BrowserAuthenticationState>>;
 }