Clean unconfirmed users

Signed-off-by: Thomas Citharel <tcit@tcit.fr>

lib/mix/tasks/mobilizon/users/clean.ex

@@ -0,0 +1,91 @@
+defmodule Mix.Tasks.Mobilizon.Users.Clean do
+  @moduledoc """
+  Clean unconfirmed users
+  """
+
+  use Mix.Task
+  import Mix.Tasks.Mobilizon.Common
+  alias Mobilizon.Service.CleanUnconfirmedUsers
+
+  @shortdoc "Clean unconfirmed users from Mobilizon"
+  @grace_period Mobilizon.Config.get([:instance, :unconfirmed_user_grace_period_hours], 48)
+
+  @impl Mix.Task
+  def run(options) do
+    {options, [], []} =
+      OptionParser.parse(
+        options,
+        strict: [
+          dry_run: :boolean,
+          days: :integer,
+          verbose: :boolean
+        ],
+        aliases: [
+          d: :days,
+          v: :verbose
+        ]
+      )
+
+    dry_run = Keyword.get(options, :dry_run, false)
+    grace_period = Keyword.get(options, :days)
+    grace_period = if is_nil(grace_period), do: @grace_period, else: grace_period * 24
+    verbose = Keyword.get(options, :verbose, false)
+
+    start_mobilizon()
+
+    case CleanUnconfirmedUsers.clean(dry_run: dry_run, grace_period: grace_period) do
+      {:ok, deleted_users} ->
+        if length(deleted_users) > 0 do
+          if dry_run or verbose do
+            details(deleted_users, dry_run, verbose)
+          end
+
+          result(dry_run, length(deleted_users))
+        else
+          empty_result(dry_run)
+        end
+
+        :ok
+
+      _err ->
+        shell_error("Error while cleaning unconfirmed users")
+    end
+  end
+
+  @spec details(list(Media.t()), boolean(), boolean()) :: :ok
+  defp details(deleted_users, dry_run, verbose) do
+    cond do
+      dry_run ->
+        shell_info("List of users that would have been deleted")
+
+      verbose ->
+        shell_info("List of users that have been deleted")
+    end
+
+    Enum.each(deleted_users, fn deleted_user ->
+      shell_info(
+        "ID: #{deleted_user.id}, Email: #{deleted_user.email}, Profile: @#{
+          hd(deleted_user.actors).preferred_username
+        }"
+      )
+    end)
+  end
+
+  @spec result(boolean(), boolean()) :: :ok
+  defp result(dry_run, nb_deleted_users) do
+    if dry_run do
+      shell_info("#{nb_deleted_users} users would have been deleted")
+    else
+      shell_info("#{nb_deleted_users} users have been deleted")
+    end
+  end
+
+  @spec empty_result(boolean()) :: :ok
+  defp empty_result(dry_run) do
+    if dry_run do
+      shell_info("No users would have been deleted")
+    else
+      shell_info("No users were deleted")
+    end
+  end
+end

lib/mobilizon/users/users.ex

@@ -127,6 +127,9 @@ defmodule Mobilizon.Users do
 
   @doc """
   Deletes an user.
+
+  Options:
+  * `reserve_email` whether to keep a record of the email so that the user can't register again
   """
   @spec delete_user(User.t()) :: {:ok, User.t()} | {:error, Ecto.Changeset.t()}
   def delete_user(%User{id: user_id} = user, options \\ @delete_user_default_options) do

lib/service/clean_unconfirmed_users.ex

@@ -0,0 +1,59 @@
+defmodule Mobilizon.Service.CleanUnconfirmedUsers do
+  @moduledoc """
+  Service to clean unconfirmed users
+  """
+
+  alias Mobilizon.{Actors, Users}
+  alias Mobilizon.Federation.ActivityPub.Relay
+  alias Mobilizon.Storage.Repo
+  alias Mobilizon.Users.User
+  import Ecto.Query
+
+  @grace_period Mobilizon.Config.get([:instance, :unconfirmed_user_grace_period_hours], 48)
+
+  @doc """
+  Clean unattached media
+
+  Remove media that is not attached to an entity, such as media uploads that were never used in entities.
+  """
+  @spec clean(Keyword.t()) :: {:ok, list(Media.t())} | {:error, String.t()}
+  def clean(opts \\ []) do
+    users_to_delete = find_unconfirmed_users_to_clean(opts)
+
+    if Keyword.get(opts, :dry_run, false) do
+      {:ok, users_to_delete}
+    else
+      users_to_delete = Enum.map(users_to_delete, &delete_user/1)
+
+      {:ok, users_to_delete}
+    end
+  end
+
+  @spec delete_user(User.t()) :: {:ok, User.t()}
+  defp delete_user(%User{} = user) do
+    with actors <- Users.get_actors_for_user(user),
+         :ok <-
+           Enum.each(actors, fn actor ->
+             actor_performing = Relay.get_actor()
+
+             Actors.perform(:delete_actor, actor,
+               author_id: actor_performing.id,
+               reserve_username: false
+             )
+           end),
+         {:ok, %User{} = user} <- Users.delete_user(user, reserve_email: false),
+         %User{} = user <- %User{user | actors: actors} do
+      user
+    end
+  end
+
+  @spec find_unconfirmed_users_to_clean(Keyword.t()) :: list(User.t())
+  defp find_unconfirmed_users_to_clean(opts) do
+    grace_period = Keyword.get(opts, :grace_period, @grace_period)
+    expiration_date = DateTime.add(DateTime.utc_now(), grace_period * -3600)
+
+    User
+    |> where([u], is_nil(u.confirmed_at) and u.confirmation_sent_at < ^expiration_date)
+    |> Repo.all()
+  end
+end

lib/service/workers/clean_unconfirmed_users_worker.ex

@@ -0,0 +1,31 @@
+defmodule Mobilizon.Service.Workers.CleanUnconfirmedUsersWorker do
+  @moduledoc """
+  Worker to clean unattached media
+  """
+
+  use Oban.Worker, queue: "background"
+  alias Mobilizon.Service.CleanUnconfirmedUsers
+
+  @grace_period Mobilizon.Config.get([:instance, :unconfirmed_user_grace_period_hours], 48)
+
+  @impl Oban.Worker
+  def perform(%Job{}) do
+    if Mobilizon.Config.get!([:instance, :remove_unconfirmed_users]) and should_perform?() do
+      CleanUnconfirmedUsers.clean()
+    end
+  end
+
+  @spec should_perform? :: boolean()
+  defp should_perform? do
+    case Cachex.get(:key_value, "last_media_cleanup") do
+      {:ok, %DateTime{} = last_media_cleanup} ->
+        DateTime.compare(
+          last_media_cleanup,
+          DateTime.add(DateTime.utc_now(), @grace_period * -3600)
+        ) == :lt
+
+      _ ->
+        true
+    end
+  end
+end