feat(client): allow binary returns (#99)

Author: stainless-bot

finch-java-core/src/main/kotlin/com/tryfinch/api/core/http/BinaryResponseContent.kt

@@ -0,0 +1,15 @@
+package com.tryfinch.api.core.http
+
+import java.io.Closeable
+import java.io.IOException
+import java.io.InputStream
+import java.io.OutputStream
+
+interface BinaryResponseContent : Closeable {
+
+    fun contentType(): String?
+
+    fun body(): InputStream
+
+    @Throws(IOException::class) fun writeTo(outputStream: OutputStream)
+}

finch-java-core/src/main/kotlin/com/tryfinch/api/services/Handlers.kt

@@ -4,6 +4,7 @@ package com.tryfinch.api.services
 
 import com.fasterxml.jackson.databind.json.JsonMapper
 import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.tryfinch.api.core.http.BinaryResponseContent
 import com.tryfinch.api.core.http.HttpResponse
 import com.tryfinch.api.core.http.HttpResponse.Handler
 import com.tryfinch.api.errors.BadRequestException
@@ -16,6 +17,8 @@ import com.tryfinch.api.errors.RateLimitException
 import com.tryfinch.api.errors.UnauthorizedException
 import com.tryfinch.api.errors.UnexpectedStatusCodeException
 import com.tryfinch.api.errors.UnprocessableEntityException
+import java.io.InputStream
+import java.io.OutputStream
 
 @JvmSynthetic internal fun emptyHandler(): Handler<Void?> = EmptyHandler
 
@@ -25,12 +28,20 @@ private object EmptyHandler : Handler<Void?> {
 
 @JvmSynthetic internal fun stringHandler(): Handler<String> = StringHandler
 
+@JvmSynthetic internal fun binaryHandler(): Handler<BinaryResponseContent> = BinaryHandler
+
 private object StringHandler : Handler<String> {
     override fun handle(response: HttpResponse): String {
         return response.body().readBytes().toString(Charsets.UTF_8)
     }
 }
 
+private object BinaryHandler : Handler<BinaryResponseContent> {
+    override fun handle(response: HttpResponse): BinaryResponseContent {
+        return BinaryResponseContentImpl(response)
+    }
+}
+
 @JvmSynthetic
 internal inline fun <reified T> jsonHandler(jsonMapper: JsonMapper): Handler<T> {
     return object : Handler<T> {
@@ -96,3 +107,24 @@ internal fun <T> Handler<T>.withErrorHandler(errorHandler: Handler<FinchError>):
         }
     }
 }
+
+class BinaryResponseContentImpl
+constructor(
+    private val response: HttpResponse,
+) : BinaryResponseContent {
+    override fun contentType(): String? {
+        return response.headers().get("Content-Type").firstOrNull()
+    }
+
+    override fun body(): InputStream {
+        return response.body()
+    }
+
+    override fun writeTo(outputStream: OutputStream) {
+        response.body().copyTo(outputStream)
+    }
+
+    override fun close() {
+        response.body().close()
+    }
+}