Enhance JetBrains module config and tests

- Refine README for improved clarity and structure.
- Expand automated test coverage across multiple scenarios.
- Ensure custom IDE configurations and URL generation are validated.
- Simplify handling of parameter defaults and custom builds.

Author: matifali

registry/coder/modules/jetbrains/README.md

@@ -1,6 +1,6 @@
 ---
 display_name: JetBrains IDEs
-description: Add a one-click button to launch JetBrains IDEs from the Coder dashboard.
+description: Add JetBrains IDE integrations to your Coder workspaces with configurable options.
 icon: ../.icons/jetbrains.svg
 maintainer_github: coder
 partner_github: jetbrains
@@ -10,16 +10,15 @@ tags: [ide, jetbrains, parameter]
 
 # JetBrains IDEs
 
-This module adds a JetBrains IDE Button to open any workspace with a single click.
+This module adds JetBrains IDE integrations to your Coder workspaces, allowing users to launch IDEs directly from the dashboard or pre-configure specific IDEs for immediate use.
 
 ```tf
 module "jetbrains" {
   count    = data.coder_workspace.me.start_count
   source   = "registry.coder.com/coder/jetbrains/coder"
   version  = "1.0.0"
   agent_id = coder_agent.example.id
-  folder   = "/home/coder/example"
-  default  = "GO"
+  folder   = "/home/coder/project"
 }
 ```
 
@@ -31,58 +30,134 @@ module "jetbrains" {
 
 ## Examples
 
-### Use the latest version of each IDE
+### Pre-configured Mode (Direct App Creation)
+
+When `default` contains IDE codes, those IDEs are created directly without user selection:
 
 ```tf
 module "jetbrains" {
   count    = data.coder_workspace.me.start_count
-  source   = "registry.coder.com/modules/jetbrains/coder"
+  source   = "registry.coder.com/coder/jetbrains/coder"
   version  = "1.0.0"
   agent_id = coder_agent.example.id
-  folder   = "/home/coder/example"
-  options  = ["IU", "PY"]
-  default  = ["IU"]
-  latest   = true
+  folder   = "/home/coder/project"
+  default  = ["GO", "IU"] # Pre-configure GoLand and IntelliJ IDEA
 }
 ```
 
-### Use the latest EAP version
+### User Choice with Limited Options
 
 ```tf
 module "jetbrains" {
   count    = data.coder_workspace.me.start_count
-  source   = "registry.coder.com/modules/jetbrains/coder"
+  source   = "registry.coder.com/coder/jetbrains/coder"
   version  = "1.0.0"
   agent_id = coder_agent.example.id
-  folder   = "/home/coder/example"
-  options  = ["GO", "WS"]
-  default  = ["GO"]
-  latest   = true
-  channel  = "eap"
+  folder   = "/home/coder/project"
+  # Show parameter with limited options
+  options = ["GO", "PY", "WS"] # Only these IDEs are available for selection
 }
 ```
 
-### Custom base link
+### Early Access Preview (EAP) Versions
+
+```tf
+module "jetbrains" {
+  count         = data.coder_workspace.me.start_count
+  source        = "registry.coder.com/coder/jetbrains/coder"
+  version       = "1.0.0"
+  agent_id      = coder_agent.example.id
+  folder        = "/home/coder/project"
+  default       = ["GO", "RR"]
+  channel       = "eap"    # Use Early Access Preview versions
+  major_version = "2025.2" # Specific major version
+}
+```
+
+### Custom IDE Configuration
+
+```tf
+module "jetbrains" {
+  count    = data.coder_workspace.me.start_count
+  source   = "registry.coder.com/coder/jetbrains/coder"
+  version  = "1.0.0"
+  agent_id = coder_agent.example.id
+  folder   = "/workspace/project"
+
+  # Custom IDE metadata (display names and icons)
+  ide_config = {
+    "GO" = {
+      name  = "GoLand"
+      icon  = "/custom/icons/goland.svg"
+      build = "251.25410.140" # Note: build numbers are fetched from API, not used
+    }
+    "PY" = {
+      name  = "PyCharm"
+      icon  = "/custom/icons/pycharm.svg"
+      build = "251.23774.211"
+    }
+    "WS" = {
+      name  = "WebStorm"
+      icon  = "/icon/webstorm.svg"
+      build = "251.23774.210"
+    }
+  }
+}
+```
+
+### Offline Mode
+
+For organizations with internal JetBrains API mirrors:
+
+```tf
+module "jetbrains" {
+  count    = data.coder_workspace.me.start_count
+  source   = "registry.coder.com/coder/jetbrains/coder"
+  version  = "1.0.0"
+  agent_id = coder_agent.example.id
+  folder   = "/home/coder/project"
 
-Due to the highest priority of the `ide_download_link` parameter in the `(jetbrains-gateway://...` within IDEA, the pre-configured download address will be overridden when using [IDEA's offline mode](https://www.jetbrains.com/help/idea/fully-offline-mode.html). Therefore, it is necessary to configure the `download_base_link` parameter for the `jetbrains_gateway` module to change the value of `ide_download_link`.
+  default = ["GO", "IU"]
+
+  # Custom API endpoints
+  releases_base_link = "https://jetbrains-api.internal.company.com"
+  download_base_link = "https://jetbrains-downloads.internal.company.com"
+}
+```
+
+### Single IDE for Specific Use Case
 
 ```tf
-module "jetbrains_gateway" {
-  count              = data.coder_workspace.me.start_count
-  source             = "registry.coder.com/modules/jetbrains-gateway/coder"
-  version            = "1.0.0"
-  agent_id           = coder_agent.example.id
-  folder             = "/home/coder/example"
-  options            = ["GO", "WS"]
-  releases_base_link = "https://releases.internal.site/"
-  download_base_link = "https://download.internal.site/"
-  default            = ["GO"]
+module "jetbrains_goland" {
+  count    = data.coder_workspace.me.start_count
+  source   = "registry.coder.com/coder/jetbrains/coder"
+  version  = "1.0.0"
+  agent_id = coder_agent.example.id
+  folder   = "/go/src/project"
+
+  default = ["GO"] # Only GoLand
+
+  # Specific version for consistency
+  major_version = "2025.1"
+  channel       = "release"
 }
 ```
 
+## Behavior
+
+### Parameter vs Direct Apps
+
+- **`default = []` (empty)**: Creates a `coder_parameter` allowing users to select IDEs from `options`
+- **`default` with values**: Skips parameter and directly creates `coder_app` resources for the specified IDEs
+
+### Version Resolution
+
+- Build numbers are always fetched from the JetBrains API for the latest compatible versions
+- `major_version` and `channel` control which API endpoint is queried
+
 ## Supported IDEs
 
-JetBrains supports remote development for the following IDEs:
+All JetBrains IDEs with remote development capabilities:
 
 - [GoLand (`GO`)](https://www.jetbrains.com/go/)
 - [WebStorm (`WS`)](https://www.jetbrains.com/webstorm/)