feat(client): expose request body setter and getter (#392)

Author: stainless-app[bot]

openai-java-core/src/main/kotlin/com/openai/models/audio/speech/SpeechCreateParams.kt

@@ -161,6 +161,20 @@ private constructor(
             additionalQueryParams = speechCreateParams.additionalQueryParams.toBuilder()
         }
 
+        /**
+         * Sets the entire request body.
+         *
+         * This is generally only useful if you are already constructing the body separately.
+         * Otherwise, it's more convenient to use the top-level setters instead:
+         * - [input]
+         * - [model]
+         * - [voice]
+         * - [instructions]
+         * - [responseFormat]
+         * - etc.
+         */
+        fun body(body: Body) = apply { this.body = body.toBuilder() }
+
         /** The text to generate audio for. The maximum length is 4096 characters. */
         fun input(input: String) = apply { body.input(input) }
 
@@ -408,7 +422,7 @@ private constructor(
             )
     }
 
-    @JvmSynthetic internal fun _body(): Body = body
+    fun _body(): Body = body
 
     override fun _headers(): Headers = additionalHeaders
 

openai-java-core/src/main/kotlin/com/openai/models/audio/transcriptions/TranscriptionCreateParams.kt

@@ -208,6 +208,20 @@ private constructor(
             additionalQueryParams = transcriptionCreateParams.additionalQueryParams.toBuilder()
         }
 
+        /**
+         * Sets the entire request body.
+         *
+         * This is generally only useful if you are already constructing the body separately.
+         * Otherwise, it's more convenient to use the top-level setters instead:
+         * - [file]
+         * - [model]
+         * - [include]
+         * - [language]
+         * - [prompt]
+         * - etc.
+         */
+        fun body(body: Body) = apply { this.body = body.toBuilder() }
+
         /**
          * The audio file object (not file name) to transcribe, in one of these formats: flac, mp3,
          * mp4, mpeg, mpga, m4a, ogg, wav, or webm.
@@ -503,8 +517,7 @@ private constructor(
             )
     }
 
-    @JvmSynthetic
-    internal fun _body(): Map<String, MultipartField<*>> =
+    fun _body(): Map<String, MultipartField<*>> =
         mapOf(
                 "file" to _file(),
                 "model" to _model(),

openai-java-core/src/main/kotlin/com/openai/models/audio/translations/TranslationCreateParams.kt

@@ -149,6 +149,20 @@ private constructor(
             additionalQueryParams = translationCreateParams.additionalQueryParams.toBuilder()
         }
 
+        /**
+         * Sets the entire request body.
+         *
+         * This is generally only useful if you are already constructing the body separately.
+         * Otherwise, it's more convenient to use the top-level setters instead:
+         * - [file]
+         * - [model]
+         * - [prompt]
+         * - [responseFormat]
+         * - [temperature]
+         * - etc.
+         */
+        fun body(body: Body) = apply { this.body = body.toBuilder() }
+
         /**
          * The audio file object (not file name) translate, in one of these formats: flac, mp3, mp4,
          * mpeg, mpga, m4a, ogg, wav, or webm.
@@ -372,8 +386,7 @@ private constructor(
             )
     }
 
-    @JvmSynthetic
-    internal fun _body(): Map<String, MultipartField<*>> =
+    fun _body(): Map<String, MultipartField<*>> =
         mapOf(
                 "file" to _file(),
                 "model" to _model(),

openai-java-core/src/main/kotlin/com/openai/models/batches/BatchCancelParams.kt

@@ -206,8 +206,7 @@ private constructor(
             )
     }
 
-    @JvmSynthetic
-    internal fun _body(): Optional<Map<String, JsonValue>> =
+    fun _body(): Optional<Map<String, JsonValue>> =
         Optional.ofNullable(additionalBodyProperties.ifEmpty { null })
 
     fun _pathParam(index: Int): String =

openai-java-core/src/main/kotlin/com/openai/models/batches/BatchCreateParams.kt

@@ -144,6 +144,18 @@ private constructor(
             additionalQueryParams = batchCreateParams.additionalQueryParams.toBuilder()
         }
 
+        /**
+         * Sets the entire request body.
+         *
+         * This is generally only useful if you are already constructing the body separately.
+         * Otherwise, it's more convenient to use the top-level setters instead:
+         * - [completionWindow]
+         * - [endpoint]
+         * - [inputFileId]
+         * - [metadata]
+         */
+        fun body(body: Body) = apply { this.body = body.toBuilder() }
+
         /**
          * The time frame within which the batch should be processed. Currently only `24h` is
          * supported.
@@ -363,7 +375,7 @@ private constructor(
             )
     }
 
-    @JvmSynthetic internal fun _body(): Body = body
+    fun _body(): Body = body
 
     override fun _headers(): Headers = additionalHeaders
 

openai-java-core/src/main/kotlin/com/openai/models/beta/assistants/AssistantCreateParams.kt

@@ -285,6 +285,20 @@ private constructor(
             additionalQueryParams = assistantCreateParams.additionalQueryParams.toBuilder()
         }
 
+        /**
+         * Sets the entire request body.
+         *
+         * This is generally only useful if you are already constructing the body separately.
+         * Otherwise, it's more convenient to use the top-level setters instead:
+         * - [model]
+         * - [description]
+         * - [instructions]
+         * - [metadata]
+         * - [name]
+         * - etc.
+         */
+        fun body(body: Body) = apply { this.body = body.toBuilder() }
+
         /**
          * ID of the model to use. You can use the
          * [List models](https://platform.openai.com/docs/api-reference/models/list) API to see all
@@ -728,7 +742,7 @@ private constructor(
             )
     }
 
-    @JvmSynthetic internal fun _body(): Body = body
+    fun _body(): Body = body
 
     override fun _headers(): Headers = additionalHeaders
 

openai-java-core/src/main/kotlin/com/openai/models/beta/assistants/AssistantDeleteParams.kt

@@ -202,8 +202,7 @@ private constructor(
             )
     }
 
-    @JvmSynthetic
-    internal fun _body(): Optional<Map<String, JsonValue>> =
+    fun _body(): Optional<Map<String, JsonValue>> =
         Optional.ofNullable(additionalBodyProperties.ifEmpty { null })
 
     fun _pathParam(index: Int): String =

openai-java-core/src/main/kotlin/com/openai/models/beta/assistants/AssistantUpdateParams.kt

@@ -282,6 +282,20 @@ private constructor(
 
         fun assistantId(assistantId: String) = apply { this.assistantId = assistantId }
 
+        /**
+         * Sets the entire request body.
+         *
+         * This is generally only useful if you are already constructing the body separately.
+         * Otherwise, it's more convenient to use the top-level setters instead:
+         * - [description]
+         * - [instructions]
+         * - [metadata]
+         * - [model]
+         * - [name]
+         * - etc.
+         */
+        fun body(body: Body) = apply { this.body = body.toBuilder() }
+
         /** The description of the assistant. The maximum length is 512 characters. */
         fun description(description: String?) = apply { body.description(description) }
 
@@ -726,7 +740,7 @@ private constructor(
             )
     }
 
-    @JvmSynthetic internal fun _body(): Body = body
+    fun _body(): Body = body
 
     fun _pathParam(index: Int): String =
         when (index) {

openai-java-core/src/main/kotlin/com/openai/models/beta/threads/ThreadCreateAndRunParams.kt

@@ -362,6 +362,20 @@ private constructor(
             additionalQueryParams = threadCreateAndRunParams.additionalQueryParams.toBuilder()
         }
 
+        /**
+         * Sets the entire request body.
+         *
+         * This is generally only useful if you are already constructing the body separately.
+         * Otherwise, it's more convenient to use the top-level setters instead:
+         * - [assistantId]
+         * - [instructions]
+         * - [maxCompletionTokens]
+         * - [maxPromptTokens]
+         * - [metadata]
+         * - etc.
+         */
+        fun body(body: Body) = apply { this.body = body.toBuilder() }
+
         /**
          * The ID of the [assistant](https://platform.openai.com/docs/api-reference/assistants) to
          * use to execute this run.
@@ -923,7 +937,7 @@ private constructor(
             )
     }
 
-    @JvmSynthetic internal fun _body(): Body = body
+    fun _body(): Body = body
 
     override fun _headers(): Headers = additionalHeaders
 

openai-java-core/src/main/kotlin/com/openai/models/beta/threads/ThreadCreateParams.kt

@@ -127,6 +127,17 @@ private constructor(
             additionalQueryParams = threadCreateParams.additionalQueryParams.toBuilder()
         }
 
+        /**
+         * Sets the entire request body.
+         *
+         * This is generally only useful if you are already constructing the body separately.
+         * Otherwise, it's more convenient to use the top-level setters instead:
+         * - [messages]
+         * - [metadata]
+         * - [toolResources]
+         */
+        fun body(body: Body) = apply { this.body = body.toBuilder() }
+
         /**
          * A list of [messages](https://platform.openai.com/docs/api-reference/messages) to start
          * the thread with.
@@ -326,7 +337,7 @@ private constructor(
             )
     }
 
-    @JvmSynthetic internal fun _body(): Body = body
+    fun _body(): Body = body
 
     override fun _headers(): Headers = additionalHeaders