Create an event that edits a previous message.

The new event contents is given in msg, and fallback is a fallback representation for clients that do not support edits. fallback can be a function of one or two arguments, returning the fallback representation. If it takes one argument, the argument will be the new event contents; if it takes two arguments, the first argument will be the new event contents and the second argument will be the old event contents. If fallback is not given, then the function will generate a naive fallback.

Note that this function assumes that the formatted body in msg is properly formatted.

ref_event is the original event that is being edited.

Example:

iex> Polyjuice.Client.Message.edit(
...>   "Hello",
...>   %{
...>     "event_id" => "$event_id",
...>     "content" => %{"body" => "Helloo", "msgtype" => "m.text"}
...>   }
...> )
%{
  "body" => "* Hello",
  "msgtype" => "m.text",
  "m.new_content" => %{
    "body" => "Hello",
    "msgtype" => "m.text",
  },
  "m.relates_to" => %{
    "rel_type" => "m.replace",
    "event_id" => "$event_id"
  }
}

Create a reaction event.

The event should be sent with type m.reaction.

Example:

iex> Polyjuice.Client.Message.react("👍", "$event_id")
%{
  "m.relates_to" => %{
    "rel_type" => "m.annotation",
    "event_id" => "$event_id",
    "key" => "👍"
  }
}

Create a reply.

strip_reply_fn should be a function that takes an HTML-formatted message (as a string) and removes any <mx-reply> elements from it. The input is untrusted, so the function should be able to handle malformed HTML.

Example:

iex> Polyjuice.Client.Message.reply(
...>   "Hello",
...>   %{
...>     "content" => %{"body" => "Hello World!", "msgtype" => "m.text"},
...>     "sender" => "@alice:example.org",
...>     "event_id" => "$event_id",
...>     "room_id" => "!room_id",
...>     "type" => "m.room.message"
...>   },
...>   # Note: We can only use the following as `strip_reply_fn` because
...>   # we know that the original message does not have <mx-reply> tags.
...>   # In real usage, this should be replaced with something better.
...>   fn msg -> msg end
...> )
%{
  "body" => "> <@alice:example.org> Hello World!\nHello",
  "format" => "org.matrix.custom.html",
  "formatted_body" => "<mx-reply><blockquote>\n<a href=\"https://matrix.to/#/%21room_id/%24event_id\">In reply to</a> <a href=\"https://matrix.to/#/%40alice%3Aexample.org\">@alice:example.org</a><br />\nHello World!\n</blockquote></mx-reply>\nHello\n",
  "msgtype" => "m.text",
  "m.relates_to" => %{
    "m.in_reply_to" => %{
      "event_id" => "$event_id"
    }
  }
}