meili

defmodule Meili.Dump do
  @moduledoc """
  Triggers dump creation in Meilisearch.
  """

  alias Meili.Client

  @doc """
  Triggers a dump creation process.

  ## Examples
      Meili.Dump.create()
      Meili.Dump.create(client)
  """
  @spec create(Meili.Client.t() | nil) :: {:ok, map()} | {:error, Meili.Error.t()}
  def create(client \\ nil) do
    client = client || Meili.default_client()
    Client.request(client, :post, "/dumps")
  end

  @doc """
  Triggers a dump creation process, raising on error.

  ## Examples
      Meili.Dump.create!()
      Meili.Dump.create!(client)
  """
  @spec create!(Meili.Client.t() | nil) :: map() | no_return()
  def create!(client \\ nil) do
    case create(client) do
      {:ok, body} -> body
      {:error, exception} -> raise exception
    end
  end
end