elixir_dropbox

defmodule ElixirDropbox.Paper.Users do
  import ElixirDropbox

  @doc """
  Allows an owner or editor to add users to a Paper doc or change their permissions using their email address or Dropbox account ID.

  ## Example

    members = [%{ "member" => %{ ".tag" => "email", "email" => "test@test.com" }, "permission_level": "view_and_comment" } ]
    ElixirDropbox.Paper.Users.add client, "HAOV9lRfMNj90iGLqMmC7", members, "", false

  More info at: https://www.dropbox.com/developers/documentation/http/documentation#paper-docs-users-add
  """
  def add(client, doc_id, members, custom_message, quiet) do
    body = %{
      "doc_id" => doc_id,
      "members" => members,
      "custom_message" => custom_message,
      "quiet" => quiet
    }

    result = to_string(Poison.Encoder.encode(body, []))
    post(client, "/paper/docs/users/add", result)
  end

  @doc """
  Lists all users who visited the Paper doc or users with explicit access.

  ## Example

    ElixirDropbox.Paper.Users.list client, "HAOV9lRfMNj90iGLqMmC7"

  More info at: https://www.dropbox.com/developers/documentation/http/documentation#paper-docs-users-list
  """
  def list(client, doc_id, limit \\ 100, filter_by \\ "shared") do
    body = %{"doc_id" => doc_id, "limit" => limit, "filter_by" => filter_by}
    result = to_string(Poison.Encoder.encode(body, []))
    post(client, "/paper/docs/users/list", result)
  end

  @doc """
  Once a cursor has been retrieved from docs/users/list, use this to paginate through all users on the Paper doc.

  ## Example

    ElixirDropbox.Paper.Users.list_continue client, "HAOV9lRfMNj90iGLqMmC7"

  More info at: https://www.dropbox.com/developers/documentation/http/documentation#paper-docs-users-list-continue
  """
  def list_continue(client, doc_id, cursor) do
    body = %{"doc_id" => doc_id, "cursor" => cursor}
    result = to_string(Poison.Encoder.encode(body, []))
    post(client, "/paper/docs/users/continue", result)
  end

  @doc """
  Allows an owner or editor to remove users from a Paper doc using their email address or Dropbox account ID.

  ## Example

    member = %{ "member" => %{ ".tag" => "email", "email" => "test@test.com" }
    ElixirDropbox.Paper.Users.remove client, "", member

  More info at: https://www.dropbox.com/developers/documentation/http/documentation#paper-docs-users-remove
  """
  def remove(client, doc_id, member) do
    body = %{"doc_id" => doc_id, "member" => member}
    result = to_string(Poison.Encoder.encode(body, []))
    post(client, "/paper/docs/users/remove", result)
  end
end