slack_interactive

defmodule Slack do
  @moduledoc """
  This module defines the `Slack` struct. Use `create/1` to
  convert webhook request data from Slack for parsing slash
  command and interactive message requests.

  `Slack` struct contains the below fields. The default value
  of these fields is `nil` if the incoming request does not
  contain a matching field name.

  * action - map with :name and :value for action request (action
    request only)
  * command - slash command string (command request only)
  * text - the text string following the slash command (command
    request only)
  * team - map with :domain and :id for Slack team
  * channel - map with :name and :id for Slack channel
  * user - map with :name and :id for Slack user
  * token - validation token used to confirm request came from Slack
  * reponse_url - string containing URL for delayed response to request

  Action request only fields (nil for command requests)
  * callback_id - string of callback_id from message attachment
  * action_ts - string timestamp when action occurred
  * message_ts - string timestamp when message containing action
    was posted
  * attachment_id - string id for specific attachment within message
  * original_message - original message JSON object

  See Slack docs for [responding to button] and [menu actions] and [slash commands]

  [responding to button]: https://api.slack.com/docs/message-buttons
  [menu actions]: https://api.slack.com/docs/message-menus
  [slash commands]: https://api.slack.com/slash-commands
  """

  @type t :: %__MODULE__{team: map, channel: map, user: map, token: binary}
  defstruct [action: nil, command: nil, text: nil,
             team: nil, channel: nil, user: nil, callback_id: nil,
             action_ts: nil, message_ts: nil, attachment_id: nil,
             token: nil, original_message: nil, response_url: nil]

  @doc """
  Converts incoming Slack HTTP request params to a `Slack` struct.
  `params` is expected to be a string-keyed map with either an
  `"actions"` or `"command"` key to determine the request type.

  Returns `{:ok, struct}` if params are valid format.
  Returns `{:error, message}` if params does not match the expected
  request data from Slack.
  """
  @spec create(map) :: Slack.t
  def create(%{"actions" => actions} = params),
    do: create_slack_action(actions, params)
  def create(%{"command" => _} = params),
    do: convert_slack_data(%Slack{}, params)
  def create(_),
    do: {:error, :invalid_slack_data}

  defp create_slack_action([action], params),
    do: convert_action(action, params)
  defp create_slack_action([action | _], params),
    do: convert_action(action, params)
  defp create_slack_action(_, _),
    do: {:error, :invalid_action_format}

  defp convert_action(action, params) do
    with {:ok, slack} <- put_action(%Slack{}, action),
         {:ok, slack} <- convert_slack_data(slack, params) do
           {:ok, slack}
    else
      {:error, error} -> {:error, error}
      _ -> {:error, :invalid_slack_data}
    end
  end

  defp convert_slack_data(struct, params) do
    with {:ok, slack} <- convert_keys(struct, params),
         {:ok, slack} <- get_user(slack, params),
         {:ok, slack} <- get_team(slack, params),
         {:ok, slack} <- get_channel(slack, params) do
           {:ok, slack}
    else
      {:error, error} -> {:error, error}
      _ -> {:error, :invalid_slack_data}
    end
  end

  defp convert_keys(struct, params) do
    keys = struct
           |> Map.drop([:__struct__, :team, :user, :channel, :action])
           |> Map.keys()
    slack =
      Enum.reduce(keys, struct, fn key, acc ->
        val = Map.get(params, Atom.to_string(key))
        Map.put(acc, key, val)
      end)
    {:ok, slack}
  end

  defp put_action(struct, %{"name" => name, "selected_options" => [opt]}),
    do: {:ok, Map.put(struct, :action, %{name: name, value: opt["value"]})}
  defp put_action(struct, %{"name" => name, "value" => value}),
    do: {:ok, Map.put(struct, :action, %{name: name, value: value})}
  defp put_action(_, _),
    do: {:error, :invalid_action_format}

  defp get_user(struct, %{"user_id" => id, "user_name" => name}),
    do: put_user(struct, id, name)
  defp get_user(struct, %{"user" => %{"id" => id, "name" => name}}),
    do: put_user(struct, id, name)
  defp get_user(_, _),
    do: {:error, :invalid_user_format}

  defp put_user(struct, id, name) do
    user = %{id: id, name: name}
    {:ok, Map.put(struct, :user, user)}
  end

  defp get_team(struct, %{"team_id" => id, "team_domain" => domain}),
    do: put_team(struct, id, domain)
  defp get_team(struct, %{"team" => %{"id" => id, "domain" => domain}}),
    do: put_team(struct, id, domain)
  defp get_team(_, _),
    do: {:error, :invalid_team_format}

  defp put_team(struct, id, domain) do
    team = %{id: id, domain: domain}
    {:ok, Map.put(struct, :team, team)}
  end

  defp get_channel(struct, %{"channel_id" => id, "channel_name" => name}),
    do: put_channel(struct, id, name)
  defp get_channel(struct, %{"channel" => %{"id" => id, "name" => name}}),
    do: put_channel(struct, id, name)
  defp get_channel(_, _),
    do: {:error, :invalid_channel_format}

  defp put_channel(struct, id, name) do
    channel = %{id: id, name: name}
    {:ok, Map.put(struct, :channel, channel)}
  end
end