@ir-kit/openapi-kotlin 2.0.0 → 2.1.0

package/dist/project/layout.js.map

@@ -1 +1 @@
-{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../src/project/layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AAsB/C,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,IAAsB;IAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;IAClE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC;IACtC,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IACjD,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;AAC3D,CAAC;AAED;;;;GAIG;AACH,SAAS,eAAe,CAAC,GAAW;IAClC,MAAM,UAAU,GAAG,SAAS,CAAC,SAAS,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;IACnD,IACE,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC;QAChC,UAAU,KAAK,IAAI;QACnB,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,EAC5B,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,2CAA2C,GAAG,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IACvC,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa;QAAE,OAAO,IAAI,CAAC;IAC7C,IACE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM;QACnB,IAAI,CAAC,IAAI,KAAK,QAAQ;QACtB,IAAI,CAAC,IAAI,KAAK,aAAa;QAC3B,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC;QAC5B,IAAI,CAAC,OAAO,EACZ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;QACnC,MAAM,QAAQ,GACZ,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC;QACrE,OAAO,GAAG,QAAQ,eAAe,CAAC;IACpC,CAAC;IACD,OAAO,GAAG,IAAI,CAAC,IAAI,KAAK,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../src/project/layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AAsB/C,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,IAAsB;IAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;IAClE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC;IACtC,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IACjD,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;AAC3D,CAAC;AAED;;;;GAIG;AACH,SAAS,eAAe,CAAC,GAAW;IAClC,MAAM,UAAU,GAAG,SAAS,CAAC,SAAS,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;IACnD,IACE,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC;QAChC,UAAU,KAAK,IAAI;QACnB,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,EAC5B,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,2CAA2C,GAAG,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IACvC,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa;QAAE,OAAO,IAAI,CAAC;IAC7C,IACE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM;QACnB,IAAI,CAAC,IAAI,KAAK,QAAQ;QACtB,IAAI,CAAC,IAAI,KAAK,aAAa;QAC3B,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC;QAC5B,IAAI,CAAC,OAAO,EACZ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QAChC,OAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,YAAY,eAAe,CAAC;IACzD,CAAC;IACD,OAAO,GAAG,IAAI,CAAC,IAAI,KAAK,CAAC;AAC3B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ir-kit/openapi-kotlin",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Generate idiomatic Kotlin (OkHttp + kotlinx-serialization + suspend) client SDKs from an OpenAPI 3.x spec.",
   "keywords": [
     "openapi",
@@ -12,9 +12,9 @@
     "sdk",
     "client"
   ],
-  "homepage": "https://github.com/ir-kit/ir-kit/tree/main/packages/openapi/kotlin",
+  "homepage": "https://github.com/ahmedrowaihi/ir-kit/tree/main/packages/openapi/kotlin",
   "bugs": {
-    "url": "https://github.com/ir-kit/ir-kit/issues"
+    "url": "https://github.com/ahmedrowaihi/ir-kit/issues"
   },
   "license": "MIT",
   "author": {
@@ -23,7 +23,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/ir-kit/ir-kit.git",
+    "url": "git+https://github.com/ahmedrowaihi/ir-kit.git",
     "directory": "packages/openapi/kotlin"
   },
   "type": "module",
@@ -39,6 +39,7 @@
   },
   "files": [
     "dist",
+    "runtime/*.kt",
     "README.md",
     "LICENSE.md"
   ],
@@ -49,19 +50,20 @@
   "peerDependencies": {
     "@hey-api/shared": ">=0.3.0",
     "@hey-api/spec-types": ">=0.2.0",
-    "@ir-kit/openapi-tools": ">=0.3.0"
+    "@ir-kit/openapi-tools": ">=0.3.1"
   },
   "dependencies": {
-    "@ir-kit/codegen-core": "0.1.0",
-    "@ir-kit/openapi": "0.3.0",
-    "@ir-kit/openapi-loader": "0.2.0"
+    "@ir-kit/codegen-core": "0.2.0",
+    "@ir-kit/compiler-kotlin": "0.1.0",
+    "@ir-kit/openapi": "0.4.0",
+    "@ir-kit/openapi-loader": "0.3.0"
   },
   "devDependencies": {
     "@hey-api/shared": "^0.4.2",
     "@hey-api/spec-types": "^0.2.0",
     "@types/node": "^22",
     "vitest": "^4.0.0",
-    "@ir-kit/openapi-tools": "0.3.0",
+    "@ir-kit/openapi-tools": "0.3.1",
     "@ir-kit/tsconfig": "0.0.0"
   },
   "engines": {

package/runtime/APIClient.kt

@@ -0,0 +1,140 @@
+package dev.irkit.runtime
+
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.withContext
+import kotlinx.serialization.json.Json
+import okhttp3.HttpUrl
+import okhttp3.OkHttpClient
+import okhttp3.Request
+import okhttp3.Response
+import java.util.concurrent.TimeUnit
+
+/**
+ * Runtime helper every per-tag impl class delegates to. Owns the
+ * transport-level concerns — `OkHttpClient`, `Json`, the interceptor
+ * pipeline — and provides one source of truth for status-code
+ * dispatch and decoding.
+ *
+ *  - `execute<T>(request, deserializer, …)`       — decodes a 2xx body to `T`.
+ *  - `executeUnit(request, …)`                    — discards the body.
+ *  - `executeWithResponse<T>(request, deserializer,`
+ *    `…)`                                          — decode + raw `Response`.
+ *  - `executeUnitWithResponse(request, …)`        — raw `Response` only.
+ *  - `executeRaw(request, …)`                     — raw `(ByteArray, Response)`,
+ *                                                    used by multi-2xx ops.
+ *
+ * Status-code dispatch lives in `sendAndDispatch`; 2xx returns the
+ * body bytes, 4xx/5xx throw the matching `APIError` subclass.
+ */
+public class APIClient(
+    public var baseUrl: HttpUrl,
+    public val httpClient: OkHttpClient = OkHttpClient(),
+    public val json: Json =
+        Json {
+            ignoreUnknownKeys = true
+            encodeDefaults = true
+        },
+    public val interceptors: APIInterceptors = APIInterceptors(),
+    public val auth: MutableMap<String, Auth> = mutableMapOf(),
+) {
+    public suspend fun <T> execute(
+        request: Request,
+        deserializer: kotlinx.serialization.DeserializationStrategy<T>,
+        timeout: Long? = null,
+        extraInterceptors: List<suspend (Request) -> Request> = emptyList(),
+        responseValidator: (suspend (ByteArray, Response) -> Unit)? = null,
+        responseTransformer: (suspend (ByteArray) -> ByteArray)? = null,
+    ): T {
+        val (data, response) = sendAndDispatch(request, timeout, extraInterceptors)
+        responseValidator?.invoke(data, response)
+        val body = responseTransformer?.invoke(data) ?: data
+        return try {
+            json.decodeFromString(deserializer, body.decodeToString())
+        } catch (e: Throwable) {
+            throw APIError.DecodingFailed(e)
+        }
+    }
+
+    public suspend fun executeUnit(
+        request: Request,
+        timeout: Long? = null,
+        extraInterceptors: List<suspend (Request) -> Request> = emptyList(),
+        responseValidator: (suspend (ByteArray, Response) -> Unit)? = null,
+    ) {
+        val (data, response) = sendAndDispatch(request, timeout, extraInterceptors)
+        responseValidator?.invoke(data, response)
+    }
+
+    public suspend fun <T> executeWithResponse(
+        request: Request,
+        deserializer: kotlinx.serialization.DeserializationStrategy<T>,
+        timeout: Long? = null,
+        extraInterceptors: List<suspend (Request) -> Request> = emptyList(),
+        responseValidator: (suspend (ByteArray, Response) -> Unit)? = null,
+        responseTransformer: (suspend (ByteArray) -> ByteArray)? = null,
+    ): Pair<T, Response> {
+        val (data, response) = sendAndDispatch(request, timeout, extraInterceptors)
+        responseValidator?.invoke(data, response)
+        val body = responseTransformer?.invoke(data) ?: data
+        return try {
+            json.decodeFromString(deserializer, body.decodeToString()) to response
+        } catch (e: Throwable) {
+            throw APIError.DecodingFailed(e)
+        }
+    }
+
+    public suspend fun executeUnitWithResponse(
+        request: Request,
+        timeout: Long? = null,
+        extraInterceptors: List<suspend (Request) -> Request> = emptyList(),
+        responseValidator: (suspend (ByteArray, Response) -> Unit)? = null,
+    ): Response {
+        val (data, response) = sendAndDispatch(request, timeout, extraInterceptors)
+        responseValidator?.invoke(data, response)
+        return response
+    }
+
+    public suspend fun executeRaw(
+        request: Request,
+        timeout: Long? = null,
+        extraInterceptors: List<suspend (Request) -> Request> = emptyList(),
+        responseValidator: (suspend (ByteArray, Response) -> Unit)? = null,
+        responseTransformer: (suspend (ByteArray) -> ByteArray)? = null,
+    ): Pair<ByteArray, Response> {
+        val (data, response) = sendAndDispatch(request, timeout, extraInterceptors)
+        responseValidator?.invoke(data, response)
+        val body = responseTransformer?.invoke(data) ?: data
+        return body to response
+    }
+
+    private suspend fun sendAndDispatch(
+        request: Request,
+        timeout: Long?,
+        extraInterceptors: List<suspend (Request) -> Request>,
+    ): Pair<ByteArray, Response> {
+        var req = request
+        for (interceptor in interceptors.request) req = interceptor(req)
+        for (interceptor in extraInterceptors) req = interceptor(req)
+        val callClient =
+            if (timeout == null) {
+                httpClient
+            } else {
+                httpClient.newBuilder().callTimeout(timeout, TimeUnit.MILLISECONDS).build()
+            }
+        val response =
+            try {
+                withContext(Dispatchers.IO) {
+                    callClient.newCall(req).execute()
+                }
+            } catch (e: Throwable) {
+                throw APIError.Transport(e)
+            }
+        val body = response.body?.bytes() ?: ByteArray(0)
+        return when (val code = response.code) {
+            in 200..299 -> body to response
+            in 400..499 -> throw APIError.ClientError(code, body)
+            in 500..599 -> throw APIError.ServerError(code, body)
+            else -> throw APIError.UnexpectedStatus(code, body)
+        }
+    }
+}

package/runtime/APIError.kt

@@ -0,0 +1,42 @@
+package dev.irkit.runtime
+
+/**
+ * The typed error every impl method throws on non-2xx responses.
+ *
+ *  - `ClientError(statusCode, body)`     — 4XX
+ *  - `ServerError(statusCode, body)`     — 5XX
+ *  - `UnexpectedStatus(statusCode, body)` — 1XX/3XX/anything outside 2-5
+ *  - `DecodingFailed(cause)`             — kotlinx-serialization threw on a 2XX body
+ *  - `Transport(cause)`                  — OkHttp / network-layer failure
+ *
+ * Consumers `catch` and pattern-match. Bodies are surfaced as raw
+ * `ByteArray` so callers can decode error envelopes themselves with the
+ * codec they prefer.
+ */
+public sealed class APIError(
+    message: String? = null,
+    cause: Throwable? = null,
+) : RuntimeException(message, cause) {
+    public class ClientError(
+        public val statusCode: Int,
+        public val body: ByteArray,
+    ) : APIError("Client error: $statusCode")
+
+    public class ServerError(
+        public val statusCode: Int,
+        public val body: ByteArray,
+    ) : APIError("Server error: $statusCode")
+
+    public class UnexpectedStatus(
+        public val statusCode: Int,
+        public val body: ByteArray,
+    ) : APIError("Unexpected status: $statusCode")
+
+    public class DecodingFailed(
+        cause: Throwable,
+    ) : APIError("Decoding failed: ${cause.message}", cause)
+
+    public class Transport(
+        cause: Throwable,
+    ) : APIError("Transport failure: ${cause.message}", cause)
+}

package/runtime/APIInterceptors.kt

@@ -0,0 +1,14 @@
+package dev.irkit.runtime
+
+import okhttp3.Request
+
+/**
+ * Bag of per-request mutation hooks. Mirrors hey-api's TS client where
+ * `client.interceptors.request.use(fn)` registers an interceptor that
+ * runs against every outgoing request. Multiple interceptors compose —
+ * auth, logging, and tracing all coexist as separate entries instead
+ * of being chained inside one closure.
+ */
+public class APIInterceptors {
+    public val request: MutableList<suspend (Request) -> Request> = mutableListOf()
+}

package/runtime/APIKeyLocation.kt

@@ -0,0 +1,7 @@
+package dev.irkit.runtime
+
+public enum class APIKeyLocation {
+    HEADER,
+    QUERY,
+    COOKIE,
+}

package/runtime/Auth.kt

@@ -0,0 +1,86 @@
+package dev.irkit.runtime
+
+import okhttp3.HttpUrl
+import okhttp3.Request
+import java.util.Base64
+
+/**
+ * Auth schemes consumers reach for in practice:
+ *
+ *  - `Bearer(token)`            — `Authorization: Bearer <token>`.
+ *  - `ApiKey(name, value, in)`  — header / query / cookie placement,
+ *                                  matching the spec's
+ *                                  `securitySchemes.<name>.in`.
+ *  - `Basic(username, password)` — `Authorization: Basic <base64>`.
+ *
+ * Per-operation auth is auto-wired by the generator when an op has
+ * `security` requirements; it walks the requirement names and applies
+ * any matching scheme value the consumer has placed on `APIClient.auth`.
+ *
+ * `apply` mutates the request builder in-place for header / cookie
+ * auth and returns the (possibly rewritten) `HttpUrl` so query auth
+ * can re-thread its name=value into the URL.
+ */
+public sealed class Auth {
+    public abstract fun apply(
+        builder: Request.Builder,
+        url: HttpUrl,
+    ): HttpUrl
+
+    public data class Bearer(
+        public val token: String,
+    ) : Auth() {
+        override fun apply(
+            builder: Request.Builder,
+            url: HttpUrl,
+        ): HttpUrl {
+            builder.header("Authorization", "Bearer $token")
+            return url
+        }
+    }
+
+    public data class ApiKey(
+        public val name: String,
+        public val value: String,
+        public val location: APIKeyLocation,
+    ) : Auth() {
+        override fun apply(
+            builder: Request.Builder,
+            url: HttpUrl,
+        ): HttpUrl =
+            when (location) {
+                APIKeyLocation.HEADER -> {
+                    builder.header(name, value)
+                    url
+                }
+
+                APIKeyLocation.QUERY -> {
+                    url.newBuilder().addQueryParameter(name, value).build()
+                }
+
+                APIKeyLocation.COOKIE -> {
+                    val cookie = "$name=$value"
+                    val existing = builder.build().header("Cookie")
+                    builder.header("Cookie", existing?.let { "$it; $cookie" } ?: cookie)
+                    url
+                }
+            }
+    }
+
+    public data class Basic(
+        public val username: String,
+        public val password: String,
+    ) : Auth() {
+        override fun apply(
+            builder: Request.Builder,
+            url: HttpUrl,
+        ): HttpUrl {
+            val encoded =
+                Base64
+                    .getEncoder()
+                    .encodeToString("$username:$password".toByteArray(Charsets.UTF_8))
+            builder.header("Authorization", "Basic $encoded")
+            return url
+        }
+    }
+}

package/runtime/MultipartFormBody.kt

@@ -0,0 +1,41 @@
+package dev.irkit.runtime
+
+import okhttp3.MediaType.Companion.toMediaTypeOrNull
+import okhttp3.MultipartBody
+import okhttp3.RequestBody
+import okhttp3.RequestBody.Companion.toRequestBody
+
+/**
+ * Thin wrapper over OkHttp's `MultipartBody.Builder` — keeps the impl
+ * code symmetric with the JSON / form-urlencoded paths.
+ *
+ *  - `appendText(name, value)`           — text part.
+ *  - `appendFile(name, filename, bytes,`
+ *    `mimeType)`                          — binary part.
+ *  - `build()`                            — finalizes and returns a
+ *                                            `RequestBody` ready to pass
+ *                                            into `.method("POST", body)`.
+ */
+public class MultipartFormBody {
+    private val builder: MultipartBody.Builder =
+        MultipartBody.Builder().setType(MultipartBody.FORM)
+
+    public fun appendText(
+        name: String,
+        value: String,
+    ) {
+        builder.addFormDataPart(name, value)
+    }
+
+    public fun appendFile(
+        name: String,
+        filename: String,
+        bytes: ByteArray,
+        mimeType: String = "application/octet-stream",
+    ) {
+        val body: RequestBody = bytes.toRequestBody(mimeType.toMediaTypeOrNull())
+        builder.addFormDataPart(name, filename, body)
+    }
+
+    public fun build(): RequestBody = builder.build()
+}

package/runtime/QueryStyle.kt

@@ -0,0 +1,12 @@
+package dev.irkit.runtime
+
+/**
+ * Query-array serialization style — matches the OpenAPI 3 `style` field
+ * for query parameters whose value is an array. The default is `form`
+ * with explode=true; the others appear when the spec opts into them.
+ */
+public enum class QueryStyle {
+    FORM,
+    SPACE_DELIMITED,
+    PIPE_DELIMITED,
+}

package/runtime/RequestOptions.kt

@@ -0,0 +1,29 @@
+package dev.irkit.runtime
+
+import okhttp3.HttpUrl
+import okhttp3.Request
+import okhttp3.Response
+
+/**
+ * Per-call options bag — every generated method takes a
+ * `RequestOptions` last param. Mirrors hey-api's TS SDK options shape.
+ *
+ *  - `client`               — override the impl's bound `APIClient`.
+ *  - `baseUrl`              — override `client.baseUrl` for one call.
+ *  - `timeout`              — per-call call-timeout in milliseconds.
+ *  - `headers`              — extra/override headers, applied last.
+ *  - `requestInterceptors`  — extra suspend interceptors, run after
+ *                              client-level ones.
+ *  - `responseValidator`    — runs after a 2xx response; throwing
+ *                              converts the call into an exception.
+ *  - `responseTransformer`  — rewrite the response body before decode.
+ */
+public data class RequestOptions(
+    public val client: APIClient? = null,
+    public val baseUrl: HttpUrl? = null,
+    public val timeout: Long? = null,
+    public val headers: Map<String, String> = emptyMap(),
+    public val requestInterceptors: List<suspend (Request) -> Request> = emptyList(),
+    public val responseValidator: (suspend (ByteArray, Response) -> Unit)? = null,
+    public val responseTransformer: (suspend (ByteArray) -> ByteArray)? = null,
+)

package/runtime/URLEncoding.kt

@@ -0,0 +1,45 @@
+package dev.irkit.runtime
+
+import okhttp3.HttpUrl
+
+/**
+ * Helpers used by generated impl code to add OpenAPI-shaped query
+ * parameters onto an `HttpUrl.Builder` without each call site having to
+ * know the style/explode rules.
+ *
+ *  - `addScalar` skips when the value is `null` so optional-and-missing
+ *    params don't emit a key at all.
+ *  - `addArray` honours `style` + `explode`: explode=true emits one
+ *    `?name=v` per element; explode=false joins per the style separator.
+ */
+public object URLEncoding {
+    public fun addScalar(
+        builder: HttpUrl.Builder,
+        name: String,
+        value: Any?,
+    ) {
+        if (value == null) return
+        builder.addQueryParameter(name, value.toString())
+    }
+
+    public fun addArray(
+        builder: HttpUrl.Builder,
+        name: String,
+        values: List<Any>?,
+        style: QueryStyle = QueryStyle.FORM,
+        explode: Boolean = true,
+    ) {
+        if (values == null) return
+        if (explode) {
+            for (v in values) builder.addQueryParameter(name, v.toString())
+            return
+        }
+        val sep =
+            when (style) {
+                QueryStyle.FORM -> ","
+                QueryStyle.SPACE_DELIMITED -> " "
+                QueryStyle.PIPE_DELIMITED -> "|"
+            }
+        builder.addQueryParameter(name, values.joinToString(sep) { it.toString() })
+    }
+}

package/dist/kt-compiler/decl/class.d.ts

@@ -1,6 +0,0 @@
-import type { KtClass } from "../../kt-dsl/decl/class.js";
-import { printType } from "../type.js";
-export declare function printClass(d: KtClass): string;
-/** Used by sealed-subclass lowering. */
-export { printType };
-//# sourceMappingURL=class.d.ts.map

package/dist/kt-compiler/decl/class.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"class.d.ts","sourceRoot":"","sources":["../../../src/kt-compiler/decl/class.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAG1D,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAIvC,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAiC7C;AAED,wCAAwC;AACxC,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/kt-compiler/decl/class.js

@@ -1,38 +0,0 @@
-import { INDENT, superTypeTail, visibilityPrefix } from "../format.js";
-import { printStmt } from "../stmt.js";
-import { printType } from "../type.js";
-import { printFun, printFunParam } from "./fun.js";
-import { printAnnotations, printPrimaryProp, printProp } from "./prop.js";
-export function printClass(d) {
-    const annLines = printAnnotations(d.annotations, "");
-    const vis = visibilityPrefix(d.visibility);
-    const modifiers = d.modifiers.length > 0 ? `${d.modifiers.join(" ")} ` : "";
-    const primaryProps = d.properties.filter((p) => p.inPrimary);
-    const bodyProps = d.properties.filter((p) => !p.inPrimary);
-    const ctorEntries = [];
-    for (const p of primaryProps)
-        ctorEntries.push(printPrimaryProp(p, INDENT));
-    for (const p of d.ctorParams)
-        ctorEntries.push(`${INDENT}${printFunParam(p)}`);
-    const ctor = ctorEntries.length === 0 ? "" : `(\n${ctorEntries.join(",\n")},\n)`;
-    const head = `${annLines}${vis}${modifiers}class ${d.name}${ctor}${superTypeTail(d.superTypes)}`;
-    const sections = [];
-    if (bodyProps.length > 0) {
-        sections.push(bodyProps.map((p) => printProp(p, INDENT)).join("\n"));
-    }
-    if (d.initBlock && d.initBlock.length > 0) {
-        const inner = d.initBlock
-            .map((s) => printStmt(s, INDENT + INDENT))
-            .join("\n");
-        sections.push(`${INDENT}init {\n${inner}\n${INDENT}}`);
-    }
-    if (d.funs.length > 0) {
-        sections.push(d.funs.map((f) => printFun(f, INDENT)).join("\n\n"));
-    }
-    if (sections.length === 0)
-        return head;
-    return `${head} {\n${sections.join("\n\n")}\n}`;
-}
-/** Used by sealed-subclass lowering. */
-export { printType };
-//# sourceMappingURL=class.js.map

package/dist/kt-compiler/decl/class.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"class.js","sourceRoot":"","sources":["../../../src/kt-compiler/decl/class.ts"],"names":[],"mappings":"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"}

package/dist/kt-compiler/decl/dataClass.d.ts

@@ -1,3 +0,0 @@
-import type { KtDataClass } from "../../kt-dsl/decl/dataClass.js";
-export declare function printDataClass(d: KtDataClass): string;
-//# sourceMappingURL=dataClass.d.ts.map

package/dist/kt-compiler/decl/dataClass.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dataClass.d.ts","sourceRoot":"","sources":["../../../src/kt-compiler/decl/dataClass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAKlE,wBAAgB,cAAc,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAarD"}

package/dist/kt-compiler/decl/dataClass.js

@@ -1,18 +0,0 @@
-import { INDENT, superTypeTail, visibilityPrefix } from "../format.js";
-import { printFun } from "./fun.js";
-import { printAnnotations, printPrimaryProp } from "./prop.js";
-export function printDataClass(d) {
-    const annLines = printAnnotations(d.annotations, "");
-    const vis = visibilityPrefix(d.visibility);
-    // Data classes carry all properties in the primary constructor.
-    const primaryProps = d.properties
-        .map((p) => printPrimaryProp({ ...p, inPrimary: true }, INDENT))
-        .join(",\n");
-    const ctor = d.properties.length === 0 ? "()" : `(\n${primaryProps},\n)`;
-    const head = `${annLines}${vis}data class ${d.name}${ctor}${superTypeTail(d.superTypes)}`;
-    if (d.funs.length === 0)
-        return head;
-    const funs = d.funs.map((f) => printFun(f, INDENT)).join("\n\n");
-    return `${head} {\n${funs}\n}`;
-}
-//# sourceMappingURL=dataClass.js.map

package/dist/kt-compiler/decl/dataClass.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"dataClass.js","sourceRoot":"","sources":["../../../src/kt-compiler/decl/dataClass.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE/D,MAAM,UAAU,cAAc,CAAC,CAAc;IAC3C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,gBAAgB,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAC3C,gEAAgE;IAChE,MAAM,YAAY,GAAG,CAAC,CAAC,UAAU;SAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;SAC/D,IAAI,CAAC,KAAK,CAAC,CAAC;IACf,MAAM,IAAI,GAAG,CAAC,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,YAAY,MAAM,CAAC;IACzE,MAAM,IAAI,GAAG,GAAG,QAAQ,GAAG,GAAG,cAAc,CAAC,CAAC,IAAI,GAAG,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC;IAE1F,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjE,OAAO,GAAG,IAAI,OAAO,IAAI,KAAK,CAAC;AACjC,CAAC"}

package/dist/kt-compiler/decl/enum.d.ts

@@ -1,3 +0,0 @@
-import type { KtEnum } from "../../kt-dsl/decl/enum.js";
-export declare function printEnum(d: KtEnum): string;
-//# sourceMappingURL=enum.d.ts.map

package/dist/kt-compiler/decl/enum.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"enum.d.ts","sourceRoot":"","sources":["../../../src/kt-compiler/decl/enum.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAKxD,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAiC3C"}

package/dist/kt-compiler/decl/enum.js

@@ -1,32 +0,0 @@
-import { INDENT, superTypeTail, visibilityPrefix } from "../format.js";
-import { printFun } from "./fun.js";
-import { printAnnotation, printAnnotations, printPrimaryProp } from "./prop.js";
-export function printEnum(d) {
-    const annLines = printAnnotations(d.annotations, "");
-    const vis = visibilityPrefix(d.visibility);
-    const ctor = d.properties.length === 0
-        ? ""
-        : `(\n${d.properties.map((p) => printPrimaryProp({ ...p, inPrimary: true }, INDENT)).join(",\n")},\n)`;
-    const head = `${annLines}${vis}enum class ${d.name}${ctor}${superTypeTail(d.superTypes)}`;
-    if (d.entries.length === 0 && d.funs.length === 0) {
-        return `${head} {}`;
-    }
-    const entryLines = d.entries.map((e) => {
-        const annPrefix = e.annotations && e.annotations.length > 0
-            ? `${e.annotations.map(printAnnotation).join(" ")} `
-            : "";
-        const args = e.args === undefined ? "" : `(${e.args})`;
-        return `${INDENT}${annPrefix}${e.name}${args}`;
-    });
-    // Trailing semicolon is required by Kotlin when the enum class has
-    // additional members (funs/companion) below the entry list.
-    const entriesBlock = d.funs.length > 0
-        ? `${entryLines.join(",\n")};`
-        : `${entryLines.join(",\n")},`;
-    const sections = [entriesBlock];
-    if (d.funs.length > 0) {
-        sections.push(d.funs.map((f) => printFun(f, INDENT)).join("\n\n"));
-    }
-    return `${head} {\n${sections.join("\n\n")}\n}`;
-}
-//# sourceMappingURL=enum.js.map

package/dist/kt-compiler/decl/enum.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"enum.js","sourceRoot":"","sources":["../../../src/kt-compiler/decl/enum.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAEhF,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,gBAAgB,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,IAAI,GACR,CAAC,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;QACvB,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3G,MAAM,IAAI,GAAG,GAAG,QAAQ,GAAG,GAAG,cAAc,CAAC,CAAC,IAAI,GAAG,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC;IAE1F,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,OAAO,GAAG,IAAI,KAAK,CAAC;IACtB,CAAC;IAED,MAAM,UAAU,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACrC,MAAM,SAAS,GACb,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;YACvC,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG;YACpD,CAAC,CAAC,EAAE,CAAC;QACT,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC;QACvD,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,CAAC,CAAC,IAAI,GAAG,IAAI,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IACH,mEAAmE;IACnE,4DAA4D;IAC5D,MAAM,YAAY,GAChB,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QACf,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG;QAC9B,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;IAEnC,MAAM,QAAQ,GAAa,CAAC,YAAY,CAAC,CAAC;IAC1C,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,GAAG,IAAI,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;AAClD,CAAC"}

package/dist/kt-compiler/decl/fun.d.ts

@@ -1,11 +0,0 @@
-import type { KtFun, KtFunParam } from "../../kt-dsl/fun.js";
-export declare function printFunParam(p: KtFunParam, includeDefault?: boolean): string;
-export declare function printParamsBlock(params: ReadonlyArray<KtFunParam>, indent: string, includeDefault?: boolean): string;
-export declare function printFun(fn: KtFun, indent?: string, 
-/**
- * Suppress the visibility modifier — required when the function lives
- * inside an interface (members inherit the interface's visibility),
- * or as part of an enum entry's member list.
- */
-suppressVisibility?: boolean): string;
-//# sourceMappingURL=fun.d.ts.map

package/dist/kt-compiler/decl/fun.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fun.d.ts","sourceRoot":"","sources":["../../../src/kt-compiler/decl/fun.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAe,MAAM,qBAAqB,CAAC;AAgB1E,wBAAgB,aAAa,CAC3B,CAAC,EAAE,UAAU,EACb,cAAc,GAAE,OAAc,GAC7B,MAAM,CAIR;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,EACjC,MAAM,EAAE,MAAM,EACd,cAAc,GAAE,OAAc,GAC7B,MAAM,CAKR;AAED,wBAAgB,QAAQ,CACtB,EAAE,EAAE,KAAK,EACT,MAAM,GAAE,MAAW;AACnB;;;;GAIG;AACH,kBAAkB,GAAE,OAAe,GAClC,MAAM,CAqCR"}