chore: [OpenAI] use code generation (#370)

* Initial

* Add fix

* Format

* Fix version

* Disable plugin

* Apply latest changes

* update plugin ref

* Update to SAP Cloud SDK 5.18.0

* Apply update to generated sources

---------

Co-authored-by: Alexander Dümont <[email protected]>

Author: newtork

.pipeline/spotbugs-exclusions.xml

@@ -7,6 +7,7 @@
       <Package name="com.sap.ai.sdk.orchestration.model"/>
       <Package name="com.sap.ai.sdk.grounding.client"/>
       <Package name="com.sap.ai.sdk.grounding.model"/>
+      <Package name="com.sap.ai.sdk.foundationmodels.openai.generated.model"/>
       <Package name="com.sap.ai.sdk.prompt.registry.model"/>
       <Package name="com.sap.ai.sdk.prompt.registry.client"/>
     </Or>

foundation-models/openai/pom.xml

@@ -132,4 +132,65 @@
       <scope>test</scope>
     </dependency>
   </dependencies>
+
+  <profiles>
+    <profile>
+      <id>generate</id>
+      <activation>
+        <activeByDefault>false</activeByDefault>
+        <property>
+          <name>generate</name>
+        </property>
+      </activation>
+      <build>
+        <plugins>
+          <plugin>
+            <groupId>com.sap.cloud.sdk.datamodel</groupId>
+            <artifactId>openapi-generator-maven-plugin</artifactId>
+            <configuration>
+              <outputDirectory>${project.basedir}/src/main/java</outputDirectory>
+              <apiMaturity>beta</apiMaturity>
+              <enableOneOfAnyOfGeneration>true</enableOneOfAnyOfGeneration>
+              <compileScope>COMPILE</compileScope>
+              <deleteOutputDirectory>true</deleteOutputDirectory>
+            </configuration>
+            <executions>
+              <execution>
+                <id>openai</id>
+                <goals>
+                  <goal>generate</goal>
+                </goals>
+                <phase>generate-sources</phase>
+                <configuration>
+                  <inputSpec>${project.basedir}/src/main/resources/spec/openapi-2024-10-21.yaml</inputSpec>
+                  <apiPackage>com.sap.ai.sdk.foundationmodels.openai.generated.api</apiPackage>
+                  <modelPackage>com.sap.ai.sdk.foundationmodels.openai.generated.model</modelPackage>
+                  <generateApis>false</generateApis>
+                  <additionalProperties>
+                    <enumUnknownDefaultCase>true</enumUnknownDefaultCase>
+                    <useOneOfInterfaces>true</useOneOfInterfaces>
+                    <useOneOfCreators>true</useOneOfCreators>
+                    <useFloatArrays>true</useFloatArrays>
+
+                    <!-- new exclude paths -->
+                    <excludePaths>/deployments/{deployment-id}/completions
+                    /deployments/{deployment-id}/audio/transcriptions
+                    /deployments/{deployment-id}/audio/translations
+                    /deployments/{deployment-id}/images/generations</excludePaths>
+
+                    <!-- new exclude properties -->
+                    <excludeProperties>chatCompletionResponseMessage.context
+                    createChatCompletionRequest.data_sources</excludeProperties>
+
+                    <!-- new: remove unassigned components -->
+                    <removeUnusedComponents>true</removeUnusedComponents>
+                  </additionalProperties>
+                </configuration>
+              </execution>
+            </executions>
+          </plugin>
+        </plugins>
+      </build>
+    </profile>
+  </profiles>
 </project>

foundation-models/openai/src/main/java/com/sap/ai/sdk/foundationmodels/openai/generated/model/ChatCompletionFunctionCall.java

@@ -1,12 +1,7 @@
-/*
- * Copyright (c) 2025 SAP SE or an SAP affiliate company. All rights reserved.
- */
-
 /*
  * Azure OpenAI Service API
  * Azure OpenAI APIs for completions and search
  *
- * The version of the OpenAPI document: 2024-10-21
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -20,6 +15,7 @@
 import com.fasterxml.jackson.annotation.JsonAnySetter;
 import com.fasterxml.jackson.annotation.JsonIgnore;
 import com.fasterxml.jackson.annotation.JsonProperty;
+import com.google.common.annotations.Beta;
 import java.util.LinkedHashMap;
 import java.util.Map;
 import java.util.NoSuchElementException;
@@ -32,8 +28,7 @@
  * Deprecated and replaced by `tool_calls`. The name and arguments of a function that
  * should be called, as generated by the model.
  */
-// CHECKSTYLE:OFF
-@com.google.common.annotations.Beta
+@Beta // CHECKSTYLE:OFF
 public class ChatCompletionFunctionCall
 // CHECKSTYLE:ON
 {
@@ -132,11 +127,13 @@ public Set<String> getCustomFieldNames() {
    * Get the value of an unrecognizable property of this {@link ChatCompletionFunctionCall}
    * instance.
    *
+   * @deprecated Use {@link #toMap()} instead.
    * @param name The name of the property
    * @return The value of the property
    * @throws NoSuchElementException If no property with the given name could be found.
    */
   @Nullable
+  @Deprecated
   public Object getCustomField(@Nonnull final String name) throws NoSuchElementException {
     if (!cloudSdkCustomFields.containsKey(name)) {
       throw new NoSuchElementException(
@@ -145,6 +142,21 @@ public Object getCustomField(@Nonnull final String name) throws NoSuchElementExc
     return cloudSdkCustomFields.get(name);
   }
 
+  /**
+   * Get the value of all properties of this {@link ChatCompletionFunctionCall} instance including
+   * unrecognized properties.
+   *
+   * @return The map of all properties
+   */
+  @JsonIgnore
+  @Nonnull
+  public Map<String, Object> toMap() {
+    final Map<String, Object> declaredFields = new LinkedHashMap<>(cloudSdkCustomFields);
+    if (name != null) declaredFields.put("name", name);
+    if (arguments != null) declaredFields.put("arguments", arguments);
+    return declaredFields;
+  }
+
   /**
    * Set an unrecognizable property of this {@link ChatCompletionFunctionCall} instance. If the map
    * previously contained a mapping for the key, the old value is replaced by the specified value.
@@ -158,7 +170,7 @@ public void setCustomField(@Nonnull String customFieldName, @Nullable Object cus
   }
 
   @Override
-  public boolean equals(@Nullable final Object o) {
+  public boolean equals(@Nullable final java.lang.Object o) {
     if (this == o) {
       return true;
     }
@@ -194,7 +206,7 @@ public String toString() {
   /**
    * Convert the given object to string with each line indented by 4 spaces (except the first line).
    */
-  private String toIndentedString(final Object o) {
+  private String toIndentedString(final java.lang.Object o) {
     if (o == null) {
       return "null";
     }

foundation-models/openai/src/main/java/com/sap/ai/sdk/foundationmodels/openai/generated/model/ChatCompletionFunctionCallOption.java

@@ -1,12 +1,7 @@
-/*
- * Copyright (c) 2025 SAP SE or an SAP affiliate company. All rights reserved.
- */
-
 /*
  * Azure OpenAI Service API
  * Azure OpenAI APIs for completions and search
  *
- * The version of the OpenAPI document: 2024-10-21
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -20,6 +15,7 @@
 import com.fasterxml.jackson.annotation.JsonAnySetter;
 import com.fasterxml.jackson.annotation.JsonIgnore;
 import com.fasterxml.jackson.annotation.JsonProperty;
+import com.google.common.annotations.Beta;
 import java.util.LinkedHashMap;
 import java.util.Map;
 import java.util.NoSuchElementException;
@@ -32,8 +28,7 @@
  * Specifying a particular function via `{\"name\": \"my_function\"}`
  * forces the model to call that function.
  */
-// CHECKSTYLE:OFF
-@com.google.common.annotations.Beta
+@Beta // CHECKSTYLE:OFF
 public class ChatCompletionFunctionCallOption
 // CHECKSTYLE:ON
 {
@@ -90,11 +85,13 @@ public Set<String> getCustomFieldNames() {
    * Get the value of an unrecognizable property of this {@link ChatCompletionFunctionCallOption}
    * instance.
    *
+   * @deprecated Use {@link #toMap()} instead.
    * @param name The name of the property
    * @return The value of the property
    * @throws NoSuchElementException If no property with the given name could be found.
    */
   @Nullable
+  @Deprecated
   public Object getCustomField(@Nonnull final String name) throws NoSuchElementException {
     if (!cloudSdkCustomFields.containsKey(name)) {
       throw new NoSuchElementException(
@@ -103,6 +100,20 @@ public Object getCustomField(@Nonnull final String name) throws NoSuchElementExc
     return cloudSdkCustomFields.get(name);
   }
 
+  /**
+   * Get the value of all properties of this {@link ChatCompletionFunctionCallOption} instance
+   * including unrecognized properties.
+   *
+   * @return The map of all properties
+   */
+  @JsonIgnore
+  @Nonnull
+  public Map<String, Object> toMap() {
+    final Map<String, Object> declaredFields = new LinkedHashMap<>(cloudSdkCustomFields);
+    if (name != null) declaredFields.put("name", name);
+    return declaredFields;
+  }
+
   /**
    * Set an unrecognizable property of this {@link ChatCompletionFunctionCallOption} instance. If
    * the map previously contained a mapping for the key, the old value is replaced by the specified
@@ -117,7 +128,7 @@ public void setCustomField(@Nonnull String customFieldName, @Nullable Object cus
   }
 
   @Override
-  public boolean equals(@Nullable final Object o) {
+  public boolean equals(@Nullable final java.lang.Object o) {
     if (this == o) {
       return true;
     }
@@ -152,7 +163,7 @@ public String toString() {
   /**
    * Convert the given object to string with each line indented by 4 spaces (except the first line).
    */
-  private String toIndentedString(final Object o) {
+  private String toIndentedString(final java.lang.Object o) {
     if (o == null) {
       return "null";
     }

foundation-models/openai/src/main/java/com/sap/ai/sdk/foundationmodels/openai/generated/model/ChatCompletionFunctions.java

@@ -1,12 +1,7 @@
-/*
- * Copyright (c) 2025 SAP SE or an SAP affiliate company. All rights reserved.
- */
-
 /*
  * Azure OpenAI Service API
  * Azure OpenAI APIs for completions and search
  *
- * The version of the OpenAPI document: 2024-10-21
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -20,6 +15,7 @@
 import com.fasterxml.jackson.annotation.JsonAnySetter;
 import com.fasterxml.jackson.annotation.JsonIgnore;
 import com.fasterxml.jackson.annotation.JsonProperty;
+import com.google.common.annotations.Beta;
 import java.util.HashMap;
 import java.util.LinkedHashMap;
 import java.util.Map;
@@ -35,8 +31,7 @@
  * @deprecated
  */
 @Deprecated
-// CHECKSTYLE:OFF
-@com.google.common.annotations.Beta
+@Beta // CHECKSTYLE:OFF
 public class ChatCompletionFunctions
 // CHECKSTYLE:ON
 {
@@ -198,11 +193,13 @@ public Set<String> getCustomFieldNames() {
   /**
    * Get the value of an unrecognizable property of this {@link ChatCompletionFunctions} instance.
    *
+   * @deprecated Use {@link #toMap()} instead.
    * @param name The name of the property
    * @return The value of the property
    * @throws NoSuchElementException If no property with the given name could be found.
    */
   @Nullable
+  @Deprecated
   public Object getCustomField(@Nonnull final String name) throws NoSuchElementException {
     if (!cloudSdkCustomFields.containsKey(name)) {
       throw new NoSuchElementException(
@@ -211,6 +208,22 @@ public Object getCustomField(@Nonnull final String name) throws NoSuchElementExc
     return cloudSdkCustomFields.get(name);
   }
 
+  /**
+   * Get the value of all properties of this {@link ChatCompletionFunctions} instance including
+   * unrecognized properties.
+   *
+   * @return The map of all properties
+   */
+  @JsonIgnore
+  @Nonnull
+  public Map<String, Object> toMap() {
+    final Map<String, Object> declaredFields = new LinkedHashMap<>(cloudSdkCustomFields);
+    if (description != null) declaredFields.put("description", description);
+    if (name != null) declaredFields.put("name", name);
+    if (parameters != null) declaredFields.put("parameters", parameters);
+    return declaredFields;
+  }
+
   /**
    * Set an unrecognizable property of this {@link ChatCompletionFunctions} instance. If the map
    * previously contained a mapping for the key, the old value is replaced by the specified value.
@@ -224,7 +237,7 @@ public void setCustomField(@Nonnull String customFieldName, @Nullable Object cus
   }
 
   @Override
-  public boolean equals(@Nullable final Object o) {
+  public boolean equals(@Nullable final java.lang.Object o) {
     if (this == o) {
       return true;
     }
@@ -261,7 +274,7 @@ public String toString() {
   /**
    * Convert the given object to string with each line indented by 4 spaces (except the first line).
    */
-  private String toIndentedString(final Object o) {
+  private String toIndentedString(final java.lang.Object o) {
     if (o == null) {
       return "null";
     }