chore(internal): codegen related update

Author: stainless-app[bot]

README.md

@@ -13,6 +13,15 @@ The Terminal Java SDK is similar to the Terminal Kotlin SDK but with minor diffe
 
 It is generated with [Stainless](https://www.stainless.com/).
 
+## MCP Server
+
+Use the Terminal MCP Server to enable AI assistants to interact with this API, allowing them to explore endpoints, make test requests, and use documentation to help integrate this SDK into your application.
+
+[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=%40terminaldotshop%2Fmcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB0ZXJtaW5hbGRvdHNob3AvbWNwIl19)
+[![Install in VS Code](https://img.shields.io/badge/_-Add_to_VS_Code-blue?style=for-the-badge&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCA0MCA0MCI+PHBhdGggZmlsbD0iI0VFRSIgZmlsbC1ydWxlPSJldmVub2RkIiBkPSJNMzAuMjM1IDM5Ljg4NGEyLjQ5MSAyLjQ5MSAwIDAgMS0xLjc4MS0uNzNMMTIuNyAyNC43OGwtMy40NiAyLjYyNC0zLjQwNiAyLjU4MmExLjY2NSAxLjY2NSAwIDAgMS0xLjA4Mi4zMzggMS42NjQgMS42NjQgMCAwIDEtMS4wNDYtLjQzMWwtMi4yLTJhMS42NjYgMS42NjYgMCAwIDEgMC0yLjQ2M0w3LjQ1OCAyMCA0LjY3IDE3LjQ1MyAxLjUwNyAxNC41N2ExLjY2NSAxLjY2NSAwIDAgMSAwLTIuNDYzbDIuMi0yYTEuNjY1IDEuNjY1IDAgMCAxIDIuMTMtLjA5N2w2Ljg2MyA1LjIwOUwyOC40NTIuODQ0YTIuNDg4IDIuNDg4IDAgMCAxIDEuODQxLS43MjljLjM1MS4wMDkuNjk5LjA5MSAxLjAxOS4yNDVsOC4yMzYgMy45NjFhMi41IDIuNSAwIDAgMSAxLjQxNSAyLjI1M3YuMDk5LS4wNDVWMzMuMzd2LS4wNDUuMDk1YTIuNTAxIDIuNTAxIDAgMCAxLTEuNDE2IDIuMjU3bC04LjIzNSAzLjk2MWEyLjQ5MiAyLjQ5MiAwIDAgMS0xLjA3Ny4yNDZabS43MTYtMjguOTQ3LTExLjk0OCA5LjA2MiAxMS45NTIgOS4wNjUtLjAwNC0xOC4xMjdaIi8+PC9zdmc+)](https://vscode.stainless.com/mcp/%7B%22name%22%3A%22%40terminaldotshop%2Fmcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40terminaldotshop%2Fmcp%22%5D%7D)
+
+> Note: You may need to set environment variables in your MCP client.
+
 <!-- x-release-please-start-version -->
 
 The REST API documentation can be found on [terminal.shop](https://terminal.shop/docs). Javadocs are available on [javadoc.io](https://javadoc.io/doc/shop.terminal.api/terminal-java/2.5.0).

terminal-java-core/src/main/kotlin/shop/terminal/api/core/http/HttpRequest.kt

@@ -1,5 +1,6 @@
 package shop.terminal.api.core.http
 
+import java.net.URLEncoder
 import shop.terminal.api.core.checkRequired
 import shop.terminal.api.core.toImmutable
 
@@ -13,6 +14,35 @@ private constructor(
     @get:JvmName("body") val body: HttpRequestBody?,
 ) {
 
+    fun url(): String = buildString {
+        append(baseUrl)
+
+        pathSegments.forEach { segment ->
+            if (!endsWith("/")) {
+                append("/")
+            }
+            append(URLEncoder.encode(segment, "UTF-8"))
+        }
+
+        if (queryParams.isEmpty()) {
+            return@buildString
+        }
+
+        append("?")
+        var isFirst = true
+        queryParams.keys().forEach { key ->
+            queryParams.values(key).forEach { value ->
+                if (!isFirst) {
+                    append("&")
+                }
+                append(URLEncoder.encode(key, "UTF-8"))
+                append("=")
+                append(URLEncoder.encode(value, "UTF-8"))
+                isFirst = false
+            }
+        }
+    }
+
     fun toBuilder(): Builder = Builder().from(this)
 
     override fun toString(): String =

terminal-java-core/src/test/kotlin/shop/terminal/api/core/http/HttpRequestTest.kt

@@ -0,0 +1,110 @@
+package shop.terminal.api.core.http
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.params.ParameterizedTest
+import org.junit.jupiter.params.provider.EnumSource
+
+internal class HttpRequestTest {
+
+    enum class UrlTestCase(val request: HttpRequest, val expectedUrl: String) {
+        BASE_URL_ONLY(
+            HttpRequest.builder().method(HttpMethod.GET).baseUrl("https://api.example.com").build(),
+            expectedUrl = "https://api.example.com",
+        ),
+        BASE_URL_WITH_TRAILING_SLASH(
+            HttpRequest.builder()
+                .method(HttpMethod.GET)
+                .baseUrl("https://api.example.com/")
+                .build(),
+            expectedUrl = "https://api.example.com/",
+        ),
+        SINGLE_PATH_SEGMENT(
+            HttpRequest.builder()
+                .method(HttpMethod.GET)
+                .baseUrl("https://api.example.com")
+                .addPathSegment("users")
+                .build(),
+            expectedUrl = "https://api.example.com/users",
+        ),
+        MULTIPLE_PATH_SEGMENTS(
+            HttpRequest.builder()
+                .method(HttpMethod.GET)
+                .baseUrl("https://api.example.com")
+                .addPathSegments("users", "123", "profile")
+                .build(),
+            expectedUrl = "https://api.example.com/users/123/profile",
+        ),
+        PATH_SEGMENT_WITH_SPECIAL_CHARS(
+            HttpRequest.builder()
+                .method(HttpMethod.GET)
+                .baseUrl("https://api.example.com")
+                .addPathSegment("user name")
+                .build(),
+            expectedUrl = "https://api.example.com/user+name",
+        ),
+        SINGLE_QUERY_PARAM(
+            HttpRequest.builder()
+                .method(HttpMethod.GET)
+                .baseUrl("https://api.example.com")
+                .addPathSegment("users")
+                .putQueryParam("limit", "10")
+                .build(),
+            expectedUrl = "https://api.example.com/users?limit=10",
+        ),
+        MULTIPLE_QUERY_PARAMS(
+            HttpRequest.builder()
+                .method(HttpMethod.GET)
+                .baseUrl("https://api.example.com")
+                .addPathSegment("users")
+                .putQueryParam("limit", "10")
+                .putQueryParam("offset", "20")
+                .build(),
+            expectedUrl = "https://api.example.com/users?limit=10&offset=20",
+        ),
+        QUERY_PARAM_WITH_SPECIAL_CHARS(
+            HttpRequest.builder()
+                .method(HttpMethod.GET)
+                .baseUrl("https://api.example.com")
+                .addPathSegment("search")
+                .putQueryParam("q", "hello world")
+                .build(),
+            expectedUrl = "https://api.example.com/search?q=hello+world",
+        ),
+        MULTIPLE_VALUES_SAME_PARAM(
+            HttpRequest.builder()
+                .method(HttpMethod.GET)
+                .baseUrl("https://api.example.com")
+                .addPathSegment("users")
+                .putQueryParams("tags", listOf("admin", "user"))
+                .build(),
+            expectedUrl = "https://api.example.com/users?tags=admin&tags=user",
+        ),
+        BASE_URL_WITH_TRAILING_SLASH_AND_PATH(
+            HttpRequest.builder()
+                .method(HttpMethod.GET)
+                .baseUrl("https://api.example.com/")
+                .addPathSegment("users")
+                .build(),
+            expectedUrl = "https://api.example.com/users",
+        ),
+        COMPLEX_URL(
+            HttpRequest.builder()
+                .method(HttpMethod.POST)
+                .baseUrl("https://api.example.com")
+                .addPathSegments("v1", "users", "123")
+                .putQueryParams("include", listOf("profile", "settings"))
+                .putQueryParam("format", "json")
+                .build(),
+            expectedUrl =
+                "https://api.example.com/v1/users/123?include=profile&include=settings&format=json",
+        ),
+    }
+
+    @ParameterizedTest
+    @EnumSource
+    fun url(testCase: UrlTestCase) {
+        val actualUrl = testCase.request.url()
+
+        assertThat(actualUrl).isEqualTo(testCase.expectedUrl)
+    }
+}