@spec create_discussion(any(), map(), Absinthe.Resolution.t()) ::
  {:ok, Mobilizon.Discussions.Discussion.t()}
  | {:error, Ecto.Changeset.t() | String.t() | :unauthorized | :unauthenticated}

@spec delete_discussion(any(), map(), Absinthe.Resolution.t()) ::
  {:ok, Mobilizon.Discussions.Discussion.t()}
  | {:error, String.t() | :unauthorized | :unauthenticated}

@spec find_discussions_for_actor(
  Mobilizon.Actors.Actor.t(),
  map(),
  Absinthe.Resolution.t()
) ::
  {:ok, Mobilizon.Storage.Page.t(Mobilizon.Discussions.Discussion.t())}
  | {:error, :unauthenticated}

@spec get_comments_for_discussion(
  Mobilizon.Discussions.Discussion.t(),
  map(),
  Absinthe.Resolution.t()
) ::
  {:ok, Mobilizon.Storage.Page.t(Mobilizon.Discussions.Discussion.t())}

@spec get_discussion(any(), map(), Absinthe.Resolution.t()) ::
  {:ok, Mobilizon.Discussions.Discussion.t()}
  | {:error, :unauthorized | :discussion_not_found | String.t()}

@spec reply_to_discussion(any(), map(), Absinthe.Resolution.t()) ::
  {:ok, Mobilizon.Discussions.Discussion.t()}
  | {:error, :discussion_not_found | :unauthenticated}

@spec update_discussion(map(), map(), map()) ::
  {:ok, Mobilizon.Discussions.Discussion.t()}
  | {:error, :unauthorized | :unauthenticated}