Add AI openapi schemas

Author: nelsonkopliku

lib/trento_web/openapi/v1/schema/ai.ex

@@ -0,0 +1,104 @@
+defmodule TrentoWeb.OpenApi.V1.Schema.AI do
+  @moduledoc false
+
+  require OpenApiSpex
+  alias OpenApiSpex.Schema
+
+  defmodule UserConfiguration do
+    @moduledoc false
+
+    OpenApiSpex.schema(
+      %{
+        title: "AIUserConfigurationV1",
+        description: "AI configuration for a user.",
+        type: :object,
+        nullable: true,
+        additionalProperties: false,
+        properties: %{
+          provider: %Schema{
+            type: :string,
+            description: "Chosen AI provider.",
+            example: "googleai",
+            nullable: false
+          },
+          model: %Schema{
+            type: :string,
+            description: "Chosen AI model.",
+            example: "gemini-2.0-flash",
+            nullable: false
+          }
+        },
+        example: %{
+          provider: "googleai",
+          model: "gemini-2.0-flash"
+        },
+        required: [:provider, :model]
+      },
+      struct?: false
+    )
+  end
+
+  defmodule CreateUserConfigurationRequest do
+    @moduledoc false
+
+    OpenApiSpex.schema(
+      %{
+        title: "CreateUserConfigurationRequestV1",
+        description: "AI configuration request for a user.",
+        type: :object,
+        additionalProperties: false,
+        properties: %{
+          model: %Schema{
+            type: :string,
+            description: "AI model.",
+            nullable: false,
+            example: "gemini-2.0-flash"
+          },
+          api_key: %Schema{
+            type: :string,
+            description: "AI API key.",
+            nullable: false,
+            example: "AIza..."
+          }
+        },
+        example: %{
+          model: "gemini-2.0-flash",
+          api_key: "AIza..."
+        },
+        required: [:model, :api_key]
+      },
+      struct?: false
+    )
+  end
+
+  defmodule UpdateUserConfigurationRequest do
+    @moduledoc false
+
+    OpenApiSpex.schema(
+      %{
+        title: "UpdateUserConfigurationRequestV1",
+        description: "AI configuration request for a user.",
+        type: :object,
+        additionalProperties: false,
+        minProperties: 1,
+        properties: %{
+          model: %Schema{
+            type: :string,
+            description: "AI model.",
+            example: "gemini-2.0-flash"
+          },
+          api_key: %Schema{
+            type: :string,
+            description: "AI API key.",
+            example: "AIza..."
+          }
+        },
+        example: %{
+          api_key: "AIza...",
+          model: "gemini-2.0-flash"
+        }
+      },
+      struct?: false
+    )
+  end
+end

lib/trento_web/openapi/v1/schema/user.ex

@@ -5,42 +5,9 @@ defmodule TrentoWeb.OpenApi.V1.Schema.User do
   alias OpenApiSpex.Schema
 
   alias TrentoWeb.OpenApi.V1.Schema.Ability.AbilityCollection
+  alias TrentoWeb.OpenApi.V1.Schema.AI.UserConfiguration, as: AIConfiguration
   alias TrentoWeb.OpenApi.V1.Schema.PersonalAccessToken.PersonalAccessTokenCollection
 
-  defmodule AIConfiguration do
-    @moduledoc false
-
-    OpenApiSpex.schema(
-      %{
-        title: "AIConfigurationV1",
-        description: "AI configuration for a user.",
-        type: :object,
-        nullable: true,
-        additionalProperties: false,
-        properties: %{
-          provider: %Schema{
-            type: :string,
-            description: "Chosen AI provider.",
-            example: "googleai",
-            nullable: false
-          },
-          model: %Schema{
-            type: :string,
-            description: "Chosen AI model.",
-            example: "gemini-2.0-flash",
-            nullable: false
-          }
-        },
-        example: %{
-          provider: "googleai",
-          model: "gemini-2.0-flash"
-        },
-        required: [:provider, :model]
-      },
-      struct?: false
-    )
-  end
-
   defmodule UserTOTPEnrollmentPayload do
     @moduledoc false