From 9839078b19b38c3a0851f2bcde6fc3aa2f20b172 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Germ=C3=A1n=20Mart=C3=ADn?= <github@gmartin.net>
Date: Thu, 20 Nov 2025 19:30:44 +0100
Subject: [PATCH] Feature: update comments in OidcStateStore for clarity

---
 apps/api/src/app/auth/oidc-state.store.ts | 20 ++++++--------------
 1 file changed, 6 insertions(+), 14 deletions(-)

diff --git a/apps/api/src/app/auth/oidc-state.store.ts b/apps/api/src/app/auth/oidc-state.store.ts
index 1ee4bd690..5c9ef2ace 100644
--- a/apps/api/src/app/auth/oidc-state.store.ts
+++ b/apps/api/src/app/auth/oidc-state.store.ts
@@ -14,10 +14,8 @@ export class OidcStateStore {
   >();
   private readonly STATE_EXPIRY_MS = 10 * 60 * 1000; // 10 minutes
 
-  /**
-   * Store request state.
-   * Signature matches passport-openidconnect SessionStore
-   */
+  // Store request state.
+  // Signature matches passport-openidconnect SessionStore
   public store(
     _req: unknown,
     ctx: { maxAge?: number; nonce?: string; issued?: Date },
@@ -45,10 +43,8 @@ export class OidcStateStore {
     }
   }
 
-  /**
-   * Verify request state.
-   * Signature matches passport-openidconnect SessionStore
-   */
+  // Verify request state.
+  // Signature matches passport-openidconnect SessionStore
   public verify(
     _req: unknown,
     handle: string,
@@ -80,9 +76,7 @@ export class OidcStateStore {
     }
   }
 
-  /**
-   * Generate a cryptographically secure random handle
-   */
+  // Generate a cryptographically secure random handle
   private generateHandle(): string {
     return (
       Math.random().toString(36).substring(2, 15) +
@@ -91,9 +85,7 @@ export class OidcStateStore {
     );
   }
 
-  /**
-   * Clean up expired states
-   */
+  // Clean up expired states
   private cleanup(): void {
     const now = Date.now();
     const expiredKeys: string[] = [];