defmodule CloudflareApi.WafRules do @moduledoc ~S""" Manage WAF rules under `/zones/:zone_id/firewall/waf/packages/:package_id/rules`. """ use CloudflareApi.Typespecs @doc ~S""" List waf rules. Calls the Cloudflare API endpoint described in the moduledoc and returns `{:ok, result}` on success or `{:error, reason}` when the request fails. ## Examples iex> client = CloudflareApi.client("api-token") iex> CloudflareApi.WafRules.list(client, "zone_id", "package_id", []) {:ok, [%{"id" => "example"}]} """ def list(client, zone_id, package_id, opts \\ []) do c(client) |> Tesla.get(with_query(base(zone_id, package_id), opts)) |> handle_response() end @doc ~S""" Get waf rules. Calls the Cloudflare API endpoint described in the moduledoc and returns `{:ok, result}` on success or `{:error, reason}` when the request fails. ## Examples iex> client = CloudflareApi.client("api-token") iex> CloudflareApi.WafRules.get(client, "zone_id", "package_id", "rule_id", []) {:ok, %{"id" => "example"}} """ def get(client, zone_id, package_id, rule_id, opts \\ []) do c(client) |> Tesla.get(with_query(rule_path(zone_id, package_id, rule_id), opts)) |> handle_response() end @doc ~S""" Update waf rules. Calls the Cloudflare API endpoint described in the moduledoc and returns `{:ok, result}` on success or `{:error, reason}` when the request fails. ## Examples iex> client = CloudflareApi.client("api-token") iex> CloudflareApi.WafRules.update(client, "zone_id", "package_id", "rule_id", %{}) {:ok, %{"id" => "example"}} """ def update(client, zone_id, package_id, rule_id, params) when is_map(params) do c(client) |> Tesla.patch(rule_path(zone_id, package_id, rule_id), params) |> handle_response() end defp base(zone_id, package_id), do: "/zones/#{zone_id}/firewall/waf/packages/#{encode(package_id)}/rules" defp rule_path(zone_id, package_id, rule_id) do base(zone_id, package_id) <> "/#{encode(rule_id)}" end defp encode(value), do: value |> to_string() |> URI.encode_www_form() defp with_query(path, []), do: path defp with_query(path, opts), do: path <> "?" <> CloudflareApi.uri_encode_opts(opts) defp handle_response({:ok, %Tesla.Env{status: status, body: %{"result" => result}}}) when status in 200..299, do: {:ok, result} defp handle_response({:ok, %Tesla.Env{status: status, body: body}}) when status in 200..299, do: {:ok, body} defp handle_response({:ok, %Tesla.Env{body: %{"errors" => errors}}}), do: {:error, errors} defp handle_response(other), do: {:error, other} defp c(%Tesla.Client{} = client), do: client defp c(fun) when is_function(fun, 0), do: fun.() end