Change union type in favor a unique string

Add comments to clarify usage and intent in requests & responses

Author: Anaethelion

output/schema/schema.json

@@ -101,8 +101,16 @@ export class IndicesPrivileges {
   allow_restricted_indices?: boolean
 }
 
+/**
+ * While creating or updating a role you can provide either a JSON structure or a string to the API.
+ * However, the response provided by Elasticsearch will only be string with a json-as-text content.
+ *
+ * Since this is embedded in IndicesPrivileges, the same structure is used for clarity in both contexts.
+ *
+ * @codegen_names text, query, template
+ */
 export type IndicesPrivilegesQuery =
-  | string[]
+  | string
   | QueryContainer
   | RoleTemplateQueryContainer
 

output/typescript/types.ts

@@ -28,6 +28,9 @@ export class Response {
     applications: ApplicationPrivileges[]
     cluster: string[]
     global: GlobalPrivilege[]
+    /**
+     * In this context IndicesPrivileges.query property can only be a string, see IndicesPrivileges documentation for detail.
+     */
     indices: IndicesPrivileges[]
     run_as: string[]
   }