@spec allow?(
  Teiserver.user_id() | Teiserver.Account.User.t(),
  [String.t()] | String.t()
) :: boolean()

@spec change_user(Teiserver.Account.User.t(), map()) :: Ecto.Changeset.t()

@spec create_user(map()) ::
  {:ok, Teiserver.Account.User.t()} | {:error, Ecto.Changeset.t()}

@spec delete_user(Teiserver.Account.User.t()) ::
  {:ok, Teiserver.Account.User.t()} | {:error, Ecto.Changeset.t()}

@spec generate_password() :: String.t()

@spec get_user(Teiserver.user_id(), Teiserver.query_args()) ::
  Teiserver.Account.User.t() | nil

@spec get_user!(Teiserver.user_id(), Teiserver.query_args()) ::
  Teiserver.Account.User.t()

@spec get_user_by_email(String.t()) :: Teiserver.Account.User.t() | nil

@spec get_user_by_id(Teiserver.user_id()) :: Teiserver.Account.User.t() | nil

@spec get_user_by_name(String.t()) :: Teiserver.Account.User.t() | nil

@spec list_users(list()) :: [Teiserver.Account.User.t()]

@spec register_user(map()) ::
  {:ok, Teiserver.Account.User.t()} | {:error, Ecto.Changeset.t()}

@spec restricted?(
  Teiserver.user_id() | Teiserver.Account.User.t(),
  [String.t()] | String.t()
) ::
  boolean()

@spec update_limited_user(Teiserver.Account.User.t(), map()) ::
  {:ok, Teiserver.Account.User.t()} | {:error, Ecto.Changeset.t()}

@spec update_password(Teiserver.Account.User.t(), map()) ::
  {:ok, Teiserver.Account.User.t()} | {:error, Ecto.Changeset.t()}

@spec update_user(Teiserver.Account.User, map()) ::
  {:ok, Teiserver.Account.User.t()} | {:error, Ecto.Changeset.t()}

@spec user_name_acceptable?(String.t()) :: boolean()

@spec valid_password?(Teiserver.Account.User.t(), String.t()) :: boolean()