chore: working on code smells

lib/bds/media/media.ex

@@ -9,6 +9,29 @@ defmodule BDS.Media.Media do
   @primary_key {:id, :string, autogenerate: false}
   @foreign_key_type :string
 
+  @type t :: %__MODULE__{
+          id: String.t() | nil,
+          project_id: String.t() | nil,
+          project: term(),
+          filename: String.t() | nil,
+          original_name: String.t() | nil,
+          mime_type: String.t() | nil,
+          size: integer() | nil,
+          width: integer() | nil,
+          height: integer() | nil,
+          title: String.t() | nil,
+          alt: String.t() | nil,
+          caption: String.t() | nil,
+          author: String.t() | nil,
+          language: String.t() | nil,
+          file_path: String.t() | nil,
+          sidecar_path: String.t() | nil,
+          checksum: String.t() | nil,
+          tags: [String.t()],
+          created_at: integer() | nil,
+          updated_at: integer() | nil
+        }
+
   schema "media" do
     belongs_to :project, BDS.Projects.Project, type: :string
 
@@ -31,6 +54,7 @@ defmodule BDS.Media.Media do
     field :updated_at, :integer
   end
 
+  @spec changeset(t() | Ecto.Changeset.t(), map()) :: Ecto.Changeset.t()
   def changeset(media, attrs) do
     media
     |> cast(

lib/bds/media/translation.ex

@@ -7,6 +7,19 @@ defmodule BDS.Media.Translation do
   @primary_key {:id, :string, autogenerate: false}
   @foreign_key_type :string
 
+  @type t :: %__MODULE__{
+          id: String.t() | nil,
+          translation_for: String.t() | nil,
+          media: term(),
+          project_id: String.t() | nil,
+          language: String.t() | nil,
+          title: String.t() | nil,
+          alt: String.t() | nil,
+          caption: String.t() | nil,
+          created_at: integer() | nil,
+          updated_at: integer() | nil
+        }
+
   schema "media_translations" do
     belongs_to :media, BDS.Media.Media,
       foreign_key: :translation_for,
@@ -22,6 +35,7 @@ defmodule BDS.Media.Translation do
     field :updated_at, :integer
   end
 
+  @spec changeset(t() | Ecto.Changeset.t(), map()) :: Ecto.Changeset.t()
   def changeset(translation, attrs) do
     translation
     |> cast(