fix(amazonq): add documenation link in profile selection webview page (#5554)

Author: Will-ShaoHua

plugins/amazonq/chat/jetbrains-community/src/software/aws/toolkits/jetbrains/services/amazonq/QLoginWebview.kt

@@ -3,6 +3,7 @@
 
 package software.aws.toolkits.jetbrains.services.amazonq
 
+import com.intellij.ide.BrowserUtil
 import com.intellij.openapi.Disposable
 import com.intellij.openapi.actionSystem.AnActionEvent
 import com.intellij.openapi.actionSystem.DataContext
@@ -48,6 +49,7 @@ import software.aws.toolkits.telemetry.Telemetry
 import software.aws.toolkits.telemetry.UiTelemetry
 import software.aws.toolkits.telemetry.WebviewTelemetry
 import java.awt.event.ActionListener
+import java.net.URI
 import javax.swing.JButton
 import javax.swing.JComponent
 
@@ -227,6 +229,10 @@ class QWebviewBrowser(val project: Project, private val parentDisposable: Dispos
             is BrowserMessage.PublishWebviewTelemetry -> {
                 publishTelemetry(message)
             }
+
+            is BrowserMessage.OpenUrl -> {
+                BrowserUtil.browse(URI(message.externalLink))
+            }
         }
     }
 

plugins/core/jetbrains-community/src/software/aws/toolkits/jetbrains/core/webview/BrowserMessage.kt

@@ -28,6 +28,7 @@ import com.fasterxml.jackson.annotation.JsonTypeInfo
     JsonSubTypes.Type(value = BrowserMessage.SendUiClickTelemetry::class, name = "sendUiClickTelemetry"),
     JsonSubTypes.Type(value = BrowserMessage.SwitchProfile::class, name = "switchProfile"),
     JsonSubTypes.Type(value = BrowserMessage.PublishWebviewTelemetry::class, name = "webviewTelemetry"),
+    JsonSubTypes.Type(value = BrowserMessage.OpenUrl::class, name = "openUrl"),
     JsonSubTypes.Type(value = BrowserMessage.ListProfiles::class, name = "listProfiles")
 )
 sealed interface BrowserMessage {
@@ -60,6 +61,8 @@ sealed interface BrowserMessage {
 
     object Reauth : BrowserMessage
 
+    data class OpenUrl(val externalLink: String) : BrowserMessage
+
     data class SwitchProfile(
         val profileName: String,
         val accountId: String,

plugins/core/jetbrains-community/tst/software/aws/toolkits/jetbrains/core/BrowserMessageTest.kt

@@ -174,6 +174,17 @@ class BrowserMessageTest {
                 event = "{ \"metricName\": \"foo\" }"
             )
         )
+
+        assertDeserializedInstanceOf<BrowserMessage.OpenUrl>(
+            """
+            {
+                "command": "openUrl",
+                "externalLink": "foo"
+            }
+            """
+        ).isEqualTo(
+            BrowserMessage.OpenUrl("foo")
+        )
     }
 
     @Test
@@ -298,6 +309,14 @@ class BrowserMessageTest {
             }
             """
         )
+
+        assertDeserializedWillThrow<MismatchedInputException>(
+            """
+            {
+                "command": "openUrl"
+            }
+            """
+        )
     }
 
     @Test

plugins/core/webview/src/q-ui/components/profileSelection.vue

@@ -11,10 +11,11 @@
                 <!-- Title & Subtitle -->
                 <div id="profile-page" class="profile-header">
                     <h2 class="title bottom-small-gap">Choose a Q Developer profile</h2>
-                    <p class="profile-subtitle">
+                    <div class="profile-subtitle">
                         Your administrator has given you access to Q from multiple profiles.
                         Choose the profile that meets your current working needs. You can change your profile at any time.
-                    </p>
+                        <a @click.prevent="openUrl">More info.</a>
+                    </div>
                 </div>
                 <!-- Profile List -->
                 <div class="profile-list">
@@ -128,6 +129,12 @@ export default defineComponent({
         },
         handleSignoutClick() {
             window.ideApi.postMessage({command: 'signout'})
+        },
+        openUrl() {
+            window.ideApi.postMessage({
+                command: 'openUrl',
+                externalLink: 'https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/subscribe-understanding-profile.html'
+            })
         }
     }
 })

plugins/toolkit/jetbrains-core/src/software/aws/toolkits/jetbrains/core/explorer/webview/ToolkitLoginWebview.kt

@@ -3,6 +3,7 @@
 
 package software.aws.toolkits.jetbrains.core.explorer.webview
 
+import com.intellij.ide.BrowserUtil
 import com.intellij.ide.ui.LafManagerListener
 import com.intellij.openapi.Disposable
 import com.intellij.openapi.actionSystem.AnActionEvent
@@ -60,6 +61,7 @@ import software.aws.toolkits.jetbrains.utils.isTookitConnected
 import software.aws.toolkits.telemetry.FeatureId
 import software.aws.toolkits.telemetry.UiTelemetry
 import java.awt.event.ActionListener
+import java.net.URI
 import javax.swing.JButton
 import javax.swing.JComponent
 
@@ -251,6 +253,10 @@ class ToolkitWebviewBrowser(val project: Project, private val parentDisposable:
             is BrowserMessage.PublishWebviewTelemetry -> {
                 publishTelemetry(message)
             }
+
+            is BrowserMessage.OpenUrl -> {
+                BrowserUtil.browse(URI(message.externalLink))
+            }
         }
     }