From 258220b7e8ec833efe772bf32b61800e20439ddb Mon Sep 17 00:00:00 2001
From: kaitranntt <kaitran.ntt@gmail.com>
Date: Mon, 2 Feb 2026 23:41:13 -0500
Subject: [PATCH] refactor(oauth): align box chars with CCS standard and add
 JSDoc
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Use Unicode box characters (╔═╗║╚╝) per design guidelines and
add JSDoc to parseCallbackUrl helper function.
---
 src/cliproxy/auth/oauth-handler.ts            | 6 +++---
 src/web-server/routes/cliproxy-auth-routes.ts | 4 +++-
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/src/cliproxy/auth/oauth-handler.ts b/src/cliproxy/auth/oauth-handler.ts
index 8fd526ac..c9b7de05 100644
--- a/src/cliproxy/auth/oauth-handler.ts
+++ b/src/cliproxy/auth/oauth-handler.ts
@@ -241,9 +241,9 @@ async function handlePasteCallbackMode(
 
     // Display auth URL in box
     console.log('');
-    console.log('  +--------------------------------------------------------------+');
-    console.log('  |  Open this URL in any browser:                               |');
-    console.log('  +--------------------------------------------------------------+');
+    console.log('  ╔══════════════════════════════════════════════════════════════╗');
+    console.log('  ║  Open this URL in any browser:                               ║');
+    console.log('  ╚══════════════════════════════════════════════════════════════╝');
     console.log('');
     console.log(`    ${authUrl}`);
     console.log('');
diff --git a/src/web-server/routes/cliproxy-auth-routes.ts b/src/web-server/routes/cliproxy-auth-routes.ts
index 7961979c..302323ba 100644
--- a/src/web-server/routes/cliproxy-auth-routes.ts
+++ b/src/web-server/routes/cliproxy-auth-routes.ts
@@ -630,7 +630,9 @@ router.get('/:provider/status', async (req: Request, res: Response): Promise<voi
 });
 
 /**
- * Parse callback URL to extract code and state parameters.
+ * Parse OAuth callback URL to extract code and state parameters.
+ * @param url - The callback URL to parse
+ * @returns Parsed components (code, state) or empty object on failure
  */
 function parseCallbackUrl(url: string): { code?: string; state?: string } {
   try {