defmodule Mobilizon.Actors do @moduledoc """ The Actors context. """ import Ecto.Query, warn: false import Mobilizon.Ecto alias Mobilizon.Repo alias Mobilizon.Actors.{Actor, Bot, Member, Follower, User} alias Mobilizon.Service.ActivityPub # import Exgravatar @doc false def data() do Dataloader.Ecto.new(Repo, query: &query/2) end @doc false def query(queryable, _params) do queryable end @doc """ Returns the list of actors. ## Examples iex> Mobilizon.Actors.list_actors() [%Mobilizon.Actors.Actor{}] """ @spec list_actors() :: list() def list_actors do Repo.all(Actor) end @doc """ Gets a single actor. Raises `Ecto.NoResultsError` if the Actor does not exist. ## Examples iex> get_actor!(123) %Mobilizon.Actors.Actor{} iex> get_actor!(456) ** (Ecto.NoResultsError) """ @spec get_actor!(integer()) :: Actor.t() def get_actor!(id) do Repo.get!(Actor, id) end @doc """ Returns the associated actor for an user, either the default set one or the first found """ @spec get_actor_for_user(Mobilizon.Actors.User.t()) :: Mobilizon.Actors.Actor.t() def get_actor_for_user(%Mobilizon.Actors.User{} = user) do case Repo.one( from(a in Actor, join: u in User, on: u.default_actor_id == a.id, where: u.id == ^user.id ) ) do nil -> case user |> get_actors_for_user() do [] -> nil actors -> hd(actors) end actor -> actor end end def get_actors_for_user(%User{id: user_id}) do Repo.all(from(a in Actor, where: a.user_id == ^user_id)) end @spec get_actor_with_everything(integer()) :: Ecto.Query defp do_get_actor_with_everything(id) do from(a in Actor, where: a.id == ^id, preload: [:organized_events, :followers, :followings]) end @doc """ Returns an actor with every relation """ @spec get_actor_with_everything(integer()) :: Mobilizon.Actors.Actor.t() def get_actor_with_everything(id) do id |> do_get_actor_with_everything |> Repo.one() end @doc """ Returns an actor with every relation """ @spec get_local_actor_with_everything(integer()) :: Mobilizon.Actors.Actor.t() def get_local_actor_with_everything(id) do id |> do_get_actor_with_everything |> where([a], is_nil(a.domain)) |> Repo.one() end @doc """ Creates a actor. ## Examples iex> create_actor(%{preferred_username: "test"}) {:ok, %Mobilizon.Actors.Actor{preferred_username: "test"}} iex> create_actor(%{preferred_username: nil}) {:error, %Ecto.Changeset{}} """ def create_actor(attrs \\ %{}) do %Actor{} |> Actor.changeset(attrs) |> Repo.insert() end @doc """ Updates a actor. ## Examples iex> update_actor(%Actor{preferred_username: "toto"}, %{preferred_username: "tata"}) {:ok, %Mobilizon.Actors.Actor{preferred_username: "tata"}} iex> update_actor(%Actor{preferred_username: "toto"}, %{preferred_username: nil}) {:error, %Ecto.Changeset{}} """ def update_actor(%Actor{} = actor, attrs) do actor |> Actor.changeset(attrs) |> Repo.update() end def update_user_default_actor(user_id, actor_id) do with from(u in User, where: u.id == ^user_id, update: [set: [default_actor_id: ^actor_id]]) |> Repo.update_all([]) do Repo.get!(User, user_id) |> Repo.preload([:default_actor]) end end @doc """ Deletes a Actor. ## Examples iex> delete_actor(%Actor{}) {:ok, %Mobilizon.Actors.Actor{}} iex> delete_actor(nil) {:error, %Ecto.Changeset{}} """ @spec delete_actor(Actor.t()) :: {:ok, Actor.t()} | {:error, Ecto.Changeset.t()} def delete_actor(%Actor{} = actor) do Repo.delete(actor) end @doc """ Returns an `%Ecto.Changeset{}` for tracking actor changes. ## Examples iex> change_actor(%Actor{}) %Ecto.Changeset{data: %Mobilizon.Actors.Actor{}} """ def change_actor(%Actor{} = actor) do Actor.changeset(actor, %{}) end @doc """ List the groups """ def list_groups(page \\ nil, limit \\ nil) do Repo.all( from( a in Actor, where: a.type == ^:Group ) |> paginate(page, limit) ) end @doc """ Get a group by it's title """ @spec get_group_by_title(String.t()) :: Actor.t() | nil def get_group_by_title(title) do case String.split(title, "@") do [title] -> get_local_group_by_title(title) [title, domain] -> Repo.one( from(a in Actor, where: a.preferred_username == ^title and a.type == "Group" and a.domain == ^domain ) ) end end @doc """ Get a local group by it's title """ @spec get_local_group_by_title(String.t()) :: Actor.t() | nil def get_local_group_by_title(title) do title |> do_get_local_group_by_title |> Repo.one() end @spec do_get_local_group_by_title(String.t()) :: Ecto.Query.t() defp do_get_local_group_by_title(title) do from(a in Actor, where: a.preferred_username == ^title and a.type == "Group" and is_nil(a.domain) ) end @doc """ Creates a group. ## Examples iex> create_group(%{name: "group name"}) {:ok, %Mobilizon.Actors.Actor{}} iex> create_group(%{name: nil}) {:error, %Ecto.Changeset{}} """ def create_group(attrs \\ %{}) do %Actor{} |> Actor.group_creation(attrs) |> Repo.insert() end @doc """ Delete a group """ def delete_group!(%Actor{type: :Group} = group) do Repo.delete!(group) end alias Mobilizon.Actors.User @doc """ Returns the list of users. ## Examples iex> list_users() [%Mobilizon.Actors.User{}] """ def list_users do Repo.all(User) end def insert_or_update_actor(data, preload \\ false) do cs = Actor.remote_actor_creation(data) {:ok, actor} = Repo.insert( cs, on_conflict: [ set: [ keys: data.keys, avatar_url: data.avatar_url, banner_url: data.banner_url, name: data.name, summary: data.summary ] ], conflict_target: [:url] ) if preload, do: {:ok, Repo.preload(actor, [:followers])}, else: {:ok, actor} end # def increase_event_count(%Actor{} = actor) do # event_count = (actor.info["event_count"] || 0) + 1 # new_info = Map.put(actor.info, "note_count", note_count) # # cs = info_changeset(actor, %{info: new_info}) # # update_and_set_cache(cs) # end def count_users() do Repo.one( from( u in User, select: count(u.id) ) ) end @doc """ Gets a single user. Raises `Ecto.NoResultsError` if the User does not exist. ## Examples iex> get_user!(123) %Mobilizon.Actors.User{} iex> get_user!(456) ** (Ecto.NoResultsError) """ def get_user!(id), do: Repo.get!(User, id) @doc """ Get an user with it's actors Raises `Ecto.NoResultsError` if the User does not exist. """ @spec get_user_with_actors!(integer()) :: User.t() def get_user_with_actors!(id) do user = Repo.get!(User, id) Repo.preload(user, [:actors, :default_actor]) end @doc """ Get user with it's actors by ID """ @spec get_user_with_actors(integer()) :: User.t() def get_user_with_actors(id) do case Repo.get(User, id) do nil -> {:error, "User with ID #{id} not found"} user -> user = user |> Repo.preload([:actors, :default_actor]) |> Map.put(:actors, get_actors_for_user(user)) {:ok, user} end end @doc """ Get an actor by it's URL (ActivityPub ID). The `:preload` option allows preloading the Followers relation. Raises `Ecto.NoResultsError` if the Actor does not exist. ## Examples iex> get_actor_by_url("https://mastodon.server.tld/users/user") {:ok, %Mobilizon.Actors.Actor{preferred_username: "user"}} iex> get_actor_by_url("https://mastodon.server.tld/users/user", true) {:ok, %Mobilizon.Actors.Actor{preferred_username: "user", followers: []}} iex> get_actor_by_url("non existent") {:error, :actor_not_found} """ @spec get_actor_by_url(String.t(), boolean()) :: {:ok, Actor.t()} | {:error, :actor_not_found} def get_actor_by_url(url, preload \\ false) do case Repo.get_by(Actor, url: url) do nil -> {:error, :actor_not_found} actor -> if preload, do: {:ok, Repo.preload(actor, [:followers])}, else: {:ok, actor} end end @doc """ Get an actor by it's URL (ActivityPub ID). The `:preload` option allows preloading the Followers relation. Raises `Ecto.NoResultsError` if the Actor does not exist. ## Examples iex> get_actor_by_url!("https://mastodon.server.tld/users/user") %Mobilizon.Actors.Actor{} iex> get_actor_by_url!("https://mastodon.server.tld/users/user", true) {:ok, %Mobilizon.Actors.Actor{preferred_username: "user", followers: []}} iex> get_actor_by_url!("non existent") ** (Ecto.NoResultsError) """ @spec get_actor_by_url!(String.t(), boolean()) :: struct() def get_actor_by_url!(url, preload \\ false) do actor = Repo.get_by!(Actor, url: url) if preload, do: Repo.preload(actor, [:followers]), else: actor end @doc """ Get an actor by name ## Examples iex> get_actor_by_name("tcit") %Mobilizon.Actors.Actor{preferred_username: "tcit", domain: nil} iex> get_actor_by_name("tcit@social.tcit.fr") %Mobilizon.Actors.Actor{preferred_username: "tcit", domain: "social.tcit.fr"} iex> get_actor_by_name("tcit", :Group) nil """ @spec get_actor_by_name(String.t(), atom() | nil) :: Actor.t() def get_actor_by_name(name, type \\ nil) do # Base query query = from(a in Actor) # If we have Person / Group information query = if type in [:Person, :Group] do from(a in query, where: a.type == ^type) else query end # If the name is a remote actor query = case String.split(name, "@") do [name] -> do_get_actor_by_name(query, name) [name, domain] -> do_get_actor_by_name(query, name, domain) end Repo.one(query) end # Get actor by username and domain is nil defp do_get_actor_by_name(query, name) do from(a in query, where: a.preferred_username == ^name and is_nil(a.domain)) end # Get actor by username and domain defp do_get_actor_by_name(query, name, domain) do from(a in query, where: a.preferred_username == ^name and a.domain == ^domain) end def get_local_actor_by_name(name) do Repo.one(from(a in Actor, where: a.preferred_username == ^name and is_nil(a.domain))) end def get_local_actor_by_name_with_everything(name) do actor = Repo.one(from(a in Actor, where: a.preferred_username == ^name and is_nil(a.domain))) Repo.preload(actor, [:organized_events, :followers, :followings]) end @spec get_actor_by_name_with_everything(String.t(), atom() | nil) :: Actor.t() def get_actor_by_name_with_everything(name, type \\ nil) do name |> get_actor_by_name(type) |> Repo.preload(:organized_events) end @doc """ Getting an actor from url, eventually creating it """ # TODO: Move this to Mobilizon.Service.ActivityPub @spec get_or_fetch_by_url(String.t(), bool()) :: {:ok, Actor.t()} | {:error, String.t()} def get_or_fetch_by_url(url, preload \\ false) do with {:ok, actor} <- get_actor_by_url(url, preload) do {:ok, actor} else _ -> case ActivityPub.make_actor_from_url(url, preload) do {:ok, actor} -> {:ok, actor} _ -> {:error, "Could not fetch by AP id"} end end end def get_or_fetch_by_url!(url, preload \\ false) do with {:ok, actor} <- get_actor_by_url(url, preload) do actor else _ -> case ActivityPub.make_actor_from_url(url, preload) do {:ok, actor} -> actor _ -> raise "Could not fetch by AP id" end end end @doc """ Find local users by their username """ # TODO: This doesn't seem to be used anyway def find_local_by_username(username) do actors = Repo.all( from( a in Actor, where: fragment( "f_unaccent(?) <% f_unaccent(?) or f_unaccent(coalesce(?, '')) <% f_unaccent(?)", a.preferred_username, ^username, a.name, ^username ), where: is_nil(a.domain), order_by: fragment( "word_similarity(?, ?) + word_similarity(coalesce(?, ''), ?) desc", a.preferred_username, ^username, a.name, ^username ) ) ) Repo.preload(actors, :organized_events) end @doc """ Find actors by their name or displayed name """ @spec find_actors_by_username_or_name(String.t(), integer(), integer()) :: list(Actor.t()) def find_actors_by_username_or_name(username, page \\ nil, limit \\ nil) def find_actors_by_username_or_name("", _page, _limit), do: [] def find_actors_by_username_or_name(username, page, limit) do Repo.all( from( a in Actor, where: fragment( "f_unaccent(?) %> f_unaccent(?) or f_unaccent(coalesce(?, '')) %> f_unaccent(?)", a.preferred_username, ^username, a.name, ^username ), order_by: fragment( "word_similarity(?, ?) + word_similarity(coalesce(?, ''), ?) desc", a.preferred_username, ^username, a.name, ^username ) ) |> paginate(page, limit) ) end @doc """ Get a group by its actor id """ def get_group_by_actor_id(actor_id) do case Repo.get_by(Actor, id: actor_id, type: :Group) do nil -> {:error, :group_not_found} actor -> {:ok, actor} end end @doc """ Authenticate user """ def authenticate(%{user: user, password: password}) do # Does password match the one stored in the database? case Argon2.verify_pass(password, user.password_hash) do true -> # Yes, create and return the token MobilizonWeb.Guardian.encode_and_sign(user) _ -> # No, return an error {:error, :unauthorized} end end @doc """ Create a new RSA key """ @spec create_keys() :: String.t() def create_keys() do key = :public_key.generate_key({:rsa, 2048, 65_537}) entry = :public_key.pem_entry_encode(:RSAPrivateKey, key) [entry] |> :public_key.pem_encode() |> String.trim_trailing() end @doc """ Register user """ @spec register(map()) :: {:ok, User.t()} | {:error, String.t()} def register(%{email: _email, password: _password} = args) do with {:ok, %User{} = user} <- %User{} |> User.registration_changeset(args) |> Mobilizon.Repo.insert() do {:ok, user} # else # {:error, %Ecto.Changeset{} = changeset} -> # {:error, Ecto.Changeset.traverse_errors(changeset, fn {msg, opts} -> # Enum.reduce(opts, msg, fn {key, value}, acc -> # String.replace(acc, "%{#{key}}", to_string(value)) # end) # end)} end end # @spec register(map()) :: {:ok, Actor.t()} | {:error, String.t()} # def register(%{email: email, password: password, username: username}) do # with avatar <- gravatar(email), # user_changeset <- # User.registration_changeset(%User{}, %{ # email: email, # password: password, # default_actor: %{ # preferred_username: username, # domain: nil, # keys: create_keys(), # avatar_url: avatar # } # }), # {:ok, %User{default_actor: %Actor{} = actor, id: user_id} = user} <- # Mobilizon.Repo.insert(user_changeset), # {:ok, %Actor{} = _actor} <- update_actor(actor, %{user_id: user_id}) do # {:ok, Repo.preload(user, [:actors])} # else # {:error, %Ecto.Changeset{} = changeset} -> # handle_actor_user_changeset(changeset) # end # end # @spec handle_actor_user_changeset(Ecto.Changeset.t()) :: {:error, String.t()} # defp handle_actor_user_changeset(changeset) do # changeset = # Ecto.Changeset.traverse_errors(changeset, fn # {msg, _opts} -> msg # msg -> msg # end) # email_msg = Map.get(changeset, :email) || [:empty_email] # {:error, hd(email_msg)} # end # @spec gravatar(String.t()) :: String.t() | nil # defp gravatar(nil), do: nil # defp gravatar(email) do # avatar_url = gravatar_url(email, default: "404") # case HTTPoison.get(avatar_url) do # {:ok, %HTTPoison.Response{status_code: 200}} -> # avatar_url # _ -> # nil # end # end @doc """ Create a new person actor """ def new_person(args) do key = :public_key.generate_key({:rsa, 2048, 65_537}) entry = :public_key.pem_entry_encode(:RSAPrivateKey, key) pem = [entry] |> :public_key.pem_encode() |> String.trim_trailing() args = Map.put(args, :keys, pem) actor = Mobilizon.Actors.Actor.registration_changeset(%Mobilizon.Actors.Actor{}, args) Mobilizon.Repo.insert(actor) end def register_bot_account(%{name: name, summary: summary}) do key = :public_key.generate_key({:rsa, 2048, 65_537}) entry = :public_key.pem_entry_encode(:RSAPrivateKey, key) pem = [entry] |> :public_key.pem_encode() |> String.trim_trailing() actor = Mobilizon.Actors.Actor.registration_changeset(%Mobilizon.Actors.Actor{}, %{ preferred_username: name, domain: nil, keys: pem, summary: summary, type: :Service }) try do Mobilizon.Repo.insert!(actor) rescue e in Ecto.InvalidChangesetError -> {:error, e.changeset} end end @doc """ Creates a user. ## Examples iex> create_user(%{email: "test@test.tld"}) {:ok, %Mobilizon.Actors.User{}} iex> create_user(%{email: "not an email"}) {:error, %Ecto.Changeset{}} """ def create_user(attrs \\ %{}) do %User{} |> User.registration_changeset(attrs) |> Repo.insert() end @doc """ Gets an user by it's email ## Examples iex> get_user_by_email("test@test.tld", true) {:ok, %Mobilizon.Actors.User{}} iex> get_user_by_email("test@notfound.tld", false) {:error, :user_not_found} """ def get_user_by_email(email, activated \\ nil) do query = case activated do nil -> from(u in User, where: u.email == ^email, preload: :default_actor) true -> from(u in User, where: u.email == ^email and not is_nil(u.confirmed_at), preload: :default_actor ) false -> from(u in User, where: u.email == ^email and is_nil(u.confirmed_at), preload: :default_actor ) end case Repo.one(query) do nil -> {:error, :user_not_found} user -> {:ok, user} end end @doc """ Get an user by it's activation token """ @spec get_user_by_activation_token(String.t()) :: Actor.t() def get_user_by_activation_token(token) do Repo.one( from(u in User, where: u.confirmation_token == ^token, preload: [:default_actor] ) ) end @doc """ Get an user by it's reset password token """ @spec get_user_by_reset_password_token(String.t()) :: Actor.t() def get_user_by_reset_password_token(token) do Repo.one( from(u in User, where: u.reset_password_token == ^token, preload: [:default_actor] ) ) end @doc """ Updates a user. ## Examples iex> update_user(User{}, %{password: "coucou"}) {:ok, %Mobilizon.Actors.User{}} iex> update_user(User{}, %{password: nil}) {:error, %Ecto.Changeset{}} """ def update_user(%User{} = user, attrs) do with {:ok, %User{} = user} <- user |> User.changeset(attrs) |> Repo.update() do {:ok, Repo.preload(user, [:default_actor])} end end @doc """ Deletes a User. ## Examples iex> delete_user(%User{email: "test@test.tld"}) {:ok, %Mobilizon.Actors.User{}} iex> delete_user(%User{}) {:error, %Ecto.Changeset{}} """ def delete_user(%User{} = user) do Repo.delete(user) end # @doc """ # Returns an `%Ecto.Changeset{}` for tracking user changes. # ## Examples # iex> change_user(%Mobilizon.Actors.User{}) # %Ecto.Changeset{data: %Mobilizon.Actors.User{}} # """ # def change_user(%User{} = user) do # User.changeset(user, %{}) # end alias Mobilizon.Actors.Member @doc """ Gets a single member. Raises `Ecto.NoResultsError` if the Member does not exist. ## Examples iex> get_member!(123) %Mobilizon.Actors.Member{} iex> get_member!(456) ** (Ecto.NoResultsError) """ def get_member!(id), do: Repo.get!(Member, id) @doc """ Creates a member. ## Examples iex> create_member(%{actor: %Actor{}}) {:ok, %Mobilizon.Actors.Member{}} iex> create_member(%{actor: nil}) {:error, %Ecto.Changeset{}} """ def create_member(attrs \\ %{}) do with {:ok, %Member{} = member} <- %Member{} |> Member.changeset(attrs) |> Repo.insert() do {:ok, Repo.preload(member, [:actor, :parent])} end end @doc """ Updates a member. ## Examples iex> update_member(%Member{}, %{role: 3}) {:ok, %Mobilizon.Actors.Member{}} iex> update_member(%Member{}, %{role: nil}) {:error, %Ecto.Changeset{}} """ def update_member(%Member{} = member, attrs) do member |> Member.changeset(attrs) |> Repo.update() end @doc """ Deletes a Member. ## Examples iex> delete_member(%Member{}) {:ok, %Mobilizon.Actors.Member{}} iex> delete_member(%Member{}) {:error, %Ecto.Changeset{}} """ def delete_member(%Member{} = member) do Repo.delete(member) end @doc """ Returns an `%Ecto.Changeset{}` for tracking member changes. ## Examples iex> change_member(%Member{}) %Ecto.Changeset{data: %Mobilizon.Actors.Member{}} """ def change_member(%Member{} = member) do Member.changeset(member, %{}) end def groups_for_actor(%Actor{id: id} = _actor) do Repo.all( from( m in Member, where: m.actor_id == ^id, preload: [:parent] ) ) end def members_for_group(%Actor{type: :Group, id: id} = _group) do Repo.all( from( m in Member, where: m.parent_id == ^id, preload: [:parent, :actor] ) ) end alias Mobilizon.Actors.Bot @doc """ Returns the list of bots. ## Examples iex> list_bots() [%Mobilizon.Actors.Bot{}] """ def list_bots do Repo.all(Bot) end @doc """ Gets a single bot. Raises `Ecto.NoResultsError` if the Bot does not exist. ## Examples iex> get_bot!(123) %Mobilizon.Actors.Bot{} iex> get_bot!(456) ** (Ecto.NoResultsError) """ def get_bot!(id), do: Repo.get!(Bot, id) @spec get_bot_by_actor(Actor.t()) :: Bot.t() def get_bot_by_actor(%Actor{} = actor) do Repo.get_by!(Bot, actor_id: actor.id) end @doc """ Creates a bot. ## Examples iex> create_bot(%{source: "toto"}) {:ok, %Mobilizon.Actors.Bot{}} iex> create_bot(%{source: nil}) {:error, %Ecto.Changeset{}} """ def create_bot(attrs \\ %{}) do %Bot{} |> Bot.changeset(attrs) |> Repo.insert() end @doc """ Updates a bot. ## Examples iex> update_bot(%Bot{}, %{source: "new"}) {:ok, %Mobilizon.Actors.Bot{}} iex> update_bot(%Bot{}, %{source: nil}) {:error, %Ecto.Changeset{}} """ def update_bot(%Bot{} = bot, attrs) do bot |> Bot.changeset(attrs) |> Repo.update() end @doc """ Deletes a Bot. ## Examples iex> delete_bot(%Bot{}) {:ok, %Mobilizon.Actors.Bot{}} iex> delete_bot(%Bot{}) {:error, %Ecto.Changeset{}} """ def delete_bot(%Bot{} = bot) do Repo.delete(bot) end @doc """ Returns an `%Ecto.Changeset{}` for tracking bot changes. ## Examples iex> change_bot(%Bot{}) %Ecto.Changeset{data: %Mobilizon.Actors.Bot{}} """ def change_bot(%Bot{} = bot) do Bot.changeset(bot, %{}) end alias Mobilizon.Actors.Follower @doc """ Gets a single follower. Raises `Ecto.NoResultsError` if the Follower does not exist. ## Examples iex> get_follower!(123) %Mobilizon.Actors.Follower{} iex> get_follower!(456) ** (Ecto.NoResultsError) """ def get_follower!(id) do Repo.get!(Follower, id) |> Repo.preload([:actor, :target_actor]) end @spec get_follower(Actor.t(), Actor.t()) :: Follower.t() def get_follower(%Actor{id: followed_id}, %Actor{id: follower_id}) do Repo.one( from(f in Follower, where: f.target_actor_id == ^followed_id and f.actor_id == ^follower_id) ) end @doc """ Creates a follower. ## Examples iex> create_follower(%{actor: %Actor{}}) {:ok, %Mobilizon.Actors.Follower{}} iex> create_follower(%{actor: nil}) {:error, %Ecto.Changeset{}} """ def create_follower(attrs \\ %{}) do with {:ok, %Follower{} = follower} <- %Follower{} |> Follower.changeset(attrs) |> Repo.insert() do {:ok, Repo.preload(follower, [:actor, :target_actor])} end end @doc """ Updates a follower. ## Examples iex> update_follower(Follower{}, %{approved: true}) {:ok, %Mobilizon.Actors.Follower{}} iex> update_follower(Follower{}, %{approved: nil}) {:error, %Ecto.Changeset{}} """ def update_follower(%Follower{} = follower, attrs) do follower |> Follower.changeset(attrs) |> Repo.update() end @doc """ Deletes a Follower. ## Examples iex> delete_follower(Follower{}) {:ok, %Mobilizon.Actors.Follower{}} iex> delete_follower(Follower{}) {:error, %Ecto.Changeset{}} """ def delete_follower(%Follower{} = follower) do Repo.delete(follower) end @doc """ Delete a follower by followed and follower actors ## Examples iex> delete_follower(%Actor{}, %Actor{}) {:ok, %Mobilizon.Actors.Follower{}} iex> delete_follower(%Actor{}, %Actor{}) {:error, %Ecto.Changeset{}} """ @spec delete_follower(Actor.t(), Actor.t()) :: {:ok, Follower.t()} | {:error, Ecto.Changeset.t()} def delete_follower(%Actor{} = followed, %Actor{} = follower) do get_follower(followed, follower) |> Repo.delete() end @doc """ Returns an `%Ecto.Changeset{}` for tracking follower changes. ## Examples iex> change_follower(Follower{}) %Ecto.Changeset{data: %Mobilizon.Actors.Follower{}} """ def change_follower(%Follower{} = follower) do Follower.changeset(follower, %{}) end end