chore: patch spec generation for synonymset items

Author: Fanis

buildSrc/src/main/groovy/DownloadSpecsPlugin.groovy

@@ -11,14 +11,68 @@ class DownloadSpecsPlugin implements Plugin<Project> {
     @Override
     void apply(Project project) {
         project.tasks.register("downloadApiSpec") {
-            println('Downloading spec')
-            File file = new File("${project.buildDir}/openapi.yml")
-            if (!file.getParentFile().exists())
-                file.getParentFile().mkdirs();
-            if (!file.exists())
-                file.createNewFile();
-            file.withOutputStream { out ->
-                new URL(specUrl).withInputStream { from -> out << from }
+            doLast {
+                println('Downloading spec')
+                File file = new File("${project.buildDir}/openapi.yml")
+                if (!file.getParentFile().exists())
+                    file.getParentFile().mkdirs();
+                if (!file.exists())
+                    file.createNewFile();
+                file.withOutputStream { out ->
+                    new URL(specUrl).withInputStream { from -> out << from }
+                }
+                
+                // Patch the OpenAPI spec to fix SynonymItemSchema allOf issue
+                // The swagger code generator doesn't handle allOf correctly, so we convert it
+                // to a direct definition that includes all fields
+                println('Patching OpenAPI spec for SynonymItemSchema')
+                String content = file.text
+                
+                // Find and replace the allOf structure with a direct definition
+                String allOfBlock = '''    SynonymItemSchema:
+      allOf:
+        - type: object
+          required:
+            - id
+          properties:
+            id:
+              type: string
+              description: Unique identifier for the synonym item
+        - $ref: "#/components/schemas/SynonymItemUpsertSchema"'''
+        
+                String replacement = '''    SynonymItemSchema:
+      type: object
+      required:
+        - id
+        - synonyms
+      properties:
+        id:
+          type: string
+          description: Unique identifier for the synonym item
+        synonyms:
+          type: array
+          description: Array of words that should be considered as synonyms
+          items:
+            type: string
+        root:
+          type: string
+          description: For 1-way synonyms, indicates the root word that words in the synonyms parameter map to
+        locale:
+          type: string
+          description: Locale for the synonym, leave blank to use the standard tokenizer
+        symbols_to_index:
+          type: array
+          description: By default, special characters are dropped from synonyms. Use this attribute to specify which special characters should be indexed as is
+          items:
+            type: string'''
+        
+                if (content.contains(allOfBlock)) {
+                    content = content.replace(allOfBlock, replacement)
+                    file.text = content
+                    println('Successfully patched SynonymItemSchema')
+                } else {
+                    println('Warning: SynonymItemSchema allOf block not found, skipping patch')
+                }
             }
         }
     }