1 # Pleroma: A lightweight social networking server
2 # Copyright © 2017-2019 Pleroma Authors <https://pleroma.social/>
3 # SPDX-License-Identifier: AGPL-3.0-only
5 defmodule Pleroma.Web.ActivityPub.Utils do
9 alias Pleroma.Notification
14 alias Pleroma.Web.ActivityPub.Visibility
15 alias Pleroma.Web.Endpoint
16 alias Pleroma.Web.Router.Helpers
21 require Pleroma.Constants
23 @supported_object_types ["Article", "Note", "Video", "Page", "Question", "Answer"]
24 @supported_report_states ~w(open closed resolved)
25 @valid_visibilities ~w(public unlisted private direct)
27 # Some implementations send the actor URI as the actor field, others send the entire actor object,
28 # so figure out what the actor's URI is based on what we have.
29 def get_ap_id(%{"id" => id} = _), do: id
30 def get_ap_id(id), do: id
32 def normalize_params(params) do
33 Map.put(params, "actor", get_ap_id(params["actor"]))
36 def determine_explicit_mentions(%{"tag" => tag} = _object) when is_list(tag) do
38 |> Enum.filter(fn x -> is_map(x) end)
39 |> Enum.filter(fn x -> x["type"] == "Mention" end)
40 |> Enum.map(fn x -> x["href"] end)
43 def determine_explicit_mentions(%{"tag" => tag} = object) when is_map(tag) do
44 Map.put(object, "tag", [tag])
45 |> determine_explicit_mentions()
48 def determine_explicit_mentions(_), do: []
50 defp recipient_in_collection(ap_id, coll) when is_binary(coll), do: ap_id == coll
51 defp recipient_in_collection(ap_id, coll) when is_list(coll), do: ap_id in coll
52 defp recipient_in_collection(_, _), do: false
54 def recipient_in_message(%User{ap_id: ap_id} = recipient, %User{} = actor, params) do
56 recipient_in_collection(ap_id, params["to"]) ->
59 recipient_in_collection(ap_id, params["cc"]) ->
62 recipient_in_collection(ap_id, params["bto"]) ->
65 recipient_in_collection(ap_id, params["bcc"]) ->
68 # if the message is unaddressed at all, then assume it is directly addressed
70 !params["to"] && !params["cc"] && !params["bto"] && !params["bcc"] ->
73 # if the message is sent from somebody the user is following, then assume it
74 # is addressed to the recipient
75 User.following?(recipient, actor) ->
83 defp extract_list(target) when is_binary(target), do: [target]
84 defp extract_list(lst) when is_list(lst), do: lst
85 defp extract_list(_), do: []
87 def maybe_splice_recipient(ap_id, params) do
89 !recipient_in_collection(ap_id, params["to"]) &&
90 !recipient_in_collection(ap_id, params["cc"])
92 cc_list = extract_list(params["cc"])
96 |> Map.put("cc", [ap_id | cc_list])
102 def make_json_ld_header do
105 "https://www.w3.org/ns/activitystreams",
106 "#{Web.base_url()}/schemas/litepub-0.1.jsonld",
115 DateTime.utc_now() |> DateTime.to_iso8601()
118 def generate_activity_id do
119 generate_id("activities")
122 def generate_context_id do
123 generate_id("contexts")
126 def generate_object_id do
127 Helpers.o_status_url(Endpoint, :object, UUID.generate())
130 def generate_id(type) do
131 "#{Web.base_url()}/#{type}/#{UUID.generate()}"
134 def get_notified_from_object(%{"type" => type} = object) when type in @supported_object_types do
135 fake_create_activity = %{
136 "to" => object["to"],
137 "cc" => object["cc"],
142 Notification.get_notified_from_activity(%Activity{data: fake_create_activity}, false)
145 def get_notified_from_object(object) do
146 Notification.get_notified_from_activity(%Activity{data: object}, false)
149 def create_context(context) do
150 context = context || generate_id("contexts")
152 # Ecto has problems accessing the constraint inside the jsonb,
153 # so we explicitly check for the existed object before insert
154 object = Object.get_cached_by_ap_id(context)
156 with true <- is_nil(object),
157 changeset <- Object.context_mapping(context),
158 {:ok, inserted_object} <- Repo.insert(changeset) do
167 Enqueues an activity for federation if it's local
169 @spec maybe_federate(any()) :: :ok
170 def maybe_federate(%Activity{local: true} = activity) do
171 if Pleroma.Config.get!([:instance, :federating]) do
173 case activity.data["type"] do
179 Pleroma.Web.Federator.publish(activity, priority)
185 def maybe_federate(_), do: :ok
188 Adds an id and a published data if they aren't there,
189 also adds it to an included object
191 def lazy_put_activity_defaults(map, fake \\ false) do
194 %{data: %{"id" => context}, id: context_id} = create_context(map["context"])
197 |> Map.put_new_lazy("id", &generate_activity_id/0)
198 |> Map.put_new_lazy("published", &make_date/0)
199 |> Map.put_new("context", context)
200 |> Map.put_new("context_id", context_id)
203 |> Map.put_new("id", "pleroma:fakeid")
204 |> Map.put_new_lazy("published", &make_date/0)
205 |> Map.put_new("context", "pleroma:fakecontext")
206 |> Map.put_new("context_id", -1)
209 if is_map(map["object"]) do
210 object = lazy_put_object_defaults(map["object"], map, fake)
211 %{map | "object" => object}
218 Adds an id and published date if they aren't there.
220 def lazy_put_object_defaults(map, activity \\ %{}, fake)
222 def lazy_put_object_defaults(map, activity, true = _fake) do
224 |> Map.put_new_lazy("published", &make_date/0)
225 |> Map.put_new("id", "pleroma:fake_object_id")
226 |> Map.put_new("context", activity["context"])
227 |> Map.put_new("fake", true)
228 |> Map.put_new("context_id", activity["context_id"])
231 def lazy_put_object_defaults(map, activity, _fake) do
233 |> Map.put_new_lazy("id", &generate_object_id/0)
234 |> Map.put_new_lazy("published", &make_date/0)
235 |> Map.put_new("context", activity["context"])
236 |> Map.put_new("context_id", activity["context_id"])
240 Inserts a full object if it is contained in an activity.
242 def insert_full_object(%{"object" => %{"type" => type} = object_data} = map)
243 when is_map(object_data) and type in @supported_object_types do
244 with {:ok, object} <- Object.create(object_data) do
247 |> Map.put("object", object.data["id"])
253 def insert_full_object(map), do: {:ok, map, nil}
255 #### Like-related helpers
258 Returns an existing like if a user already liked an object
260 @spec get_existing_like(String.t(), map()) :: Activity.t() | nil
261 def get_existing_like(actor, %{data: %{"id" => id}}) do
263 |> Activity.Queries.by_actor()
264 |> Activity.Queries.by_object_id(id)
265 |> Activity.Queries.by_type("Like")
266 |> Activity.Queries.limit(1)
271 Returns like activities targeting an object
273 def get_object_likes(%{data: %{"id" => id}}) do
275 |> Activity.Queries.by_object_id()
276 |> Activity.Queries.by_type("Like")
280 def is_emoji?(emoji) do
281 String.length(emoji) == 1
284 def make_emoji_reaction_data(user, object, emoji, activity_id) do
285 make_like_data(user, object, activity_id)
286 |> Map.put("type", "EmojiReaction")
287 |> Map.put("content", emoji)
290 @spec make_like_data(User.t(), map(), String.t()) :: map()
292 %User{ap_id: ap_id} = actor,
293 %{data: %{"actor" => object_actor_id, "id" => id}} = object,
296 object_actor = User.get_cached_by_ap_id(object_actor_id)
299 if Visibility.is_public?(object) do
300 [actor.follower_address, object.data["actor"]]
302 [object.data["actor"]]
306 (object.data["to"] ++ (object.data["cc"] || []))
307 |> List.delete(actor.ap_id)
308 |> List.delete(object_actor.follower_address)
316 "context" => object.data["context"]
318 |> maybe_put("id", activity_id)
321 @spec update_element_in_object(String.t(), list(any), Object.t()) ::
322 {:ok, Object.t()} | {:error, Ecto.Changeset.t()}
323 def update_element_in_object(property, element, object) do
325 if is_map(element) do
338 %{"#{property}_count" => length, "#{property}s" => element}
342 |> Changeset.change(data: data)
343 |> Object.update_and_set_cache()
346 @spec add_emoji_reaction_to_object(Activity.t(), Object.t()) ::
347 {:ok, Object.t()} | {:error, Ecto.Changeset.t()}
349 def add_emoji_reaction_to_object(
350 %Activity{data: %{"content" => emoji, "actor" => actor}},
353 reactions = object.data["reactions"] || %{}
354 emoji_actors = reactions[emoji] || []
355 new_emoji_actors = [actor | emoji_actors] |> Enum.uniq()
356 new_reactions = Map.put(reactions, emoji, new_emoji_actors)
357 update_element_in_object("reaction", new_reactions, object)
360 @spec add_like_to_object(Activity.t(), Object.t()) ::
361 {:ok, Object.t()} | {:error, Ecto.Changeset.t()}
362 def add_like_to_object(%Activity{data: %{"actor" => actor}}, object) do
363 [actor | fetch_likes(object)]
365 |> update_likes_in_object(object)
368 @spec remove_like_from_object(Activity.t(), Object.t()) ::
369 {:ok, Object.t()} | {:error, Ecto.Changeset.t()}
370 def remove_like_from_object(%Activity{data: %{"actor" => actor}}, object) do
373 |> List.delete(actor)
374 |> update_likes_in_object(object)
377 defp update_likes_in_object(likes, object) do
378 update_element_in_object("like", likes, object)
381 defp fetch_likes(object) do
382 if is_list(object.data["likes"]) do
389 #### Follow-related helpers
392 Updates a follow activity's state (for locked accounts).
394 def update_follow_state_for_all(
395 %Activity{data: %{"actor" => actor, "object" => object}} = activity,
399 Ecto.Adapters.SQL.query!(
401 "UPDATE activities SET data = jsonb_set(data, '{state}', $1) WHERE data->>'type' = 'Follow' AND data->>'actor' = $2 AND data->>'object' = $3 AND data->>'state' = 'pending'",
402 [state, actor, object]
405 User.set_follow_state_cache(actor, object, state)
406 activity = Activity.get_by_id(activity.id)
414 def update_follow_state(
415 %Activity{data: %{"actor" => actor, "object" => object}} = activity,
420 |> Map.put("state", state),
421 changeset <- Changeset.change(activity, data: new_data),
422 {:ok, activity} <- Repo.update(changeset),
423 _ <- User.set_follow_state_cache(actor, object, state) do
429 Makes a follow activity data for the given follower and followed
431 def make_follow_data(
432 %User{ap_id: follower_id},
433 %User{ap_id: followed_id} = _followed,
438 "actor" => follower_id,
439 "to" => [followed_id],
440 "cc" => [Pleroma.Constants.as_public()],
441 "object" => followed_id,
444 |> maybe_put("id", activity_id)
447 def fetch_latest_follow(%User{ap_id: follower_id}, %User{ap_id: followed_id}) do
450 activity in Activity,
453 "? ->> 'type' = 'Follow'",
456 where: activity.actor == ^follower_id,
457 # this is to use the index
460 "coalesce((?)->'object'->>'id', (?)->>'object') = ?",
465 order_by: [fragment("? desc nulls last", activity.id)],
472 #### Announce-related helpers
475 Retruns an existing announce activity if the notice has already been announced
477 def get_existing_announce(actor, %{data: %{"id" => id}}) do
480 activity in Activity,
481 where: activity.actor == ^actor,
482 # this is to use the index
485 "coalesce((?)->'object'->>'id', (?)->>'object') = ?",
490 where: fragment("(?)->>'type' = 'Announce'", activity.data)
497 Make announce activity data for the given actor and object
499 # for relayed messages, we only want to send to subscribers
500 def make_announce_data(
501 %User{ap_id: ap_id} = user,
502 %Object{data: %{"id" => id}} = object,
507 "type" => "Announce",
510 "to" => [user.follower_address],
512 "context" => object.data["context"]
514 |> maybe_put("id", activity_id)
517 def make_announce_data(
518 %User{ap_id: ap_id} = user,
519 %Object{data: %{"id" => id}} = object,
524 "type" => "Announce",
527 "to" => [user.follower_address, object.data["actor"]],
528 "cc" => [Pleroma.Constants.as_public()],
529 "context" => object.data["context"]
531 |> maybe_put("id", activity_id)
535 Make unannounce activity data for the given actor and object
537 def make_unannounce_data(
538 %User{ap_id: ap_id} = user,
539 %Activity{data: %{"context" => context}} = activity,
545 "object" => activity.data,
546 "to" => [user.follower_address, activity.data["actor"]],
547 "cc" => [Pleroma.Constants.as_public()],
550 |> maybe_put("id", activity_id)
553 def make_unlike_data(
554 %User{ap_id: ap_id} = user,
555 %Activity{data: %{"context" => context}} = activity,
561 "object" => activity.data,
562 "to" => [user.follower_address, activity.data["actor"]],
563 "cc" => [Pleroma.Constants.as_public()],
566 |> maybe_put("id", activity_id)
569 def add_announce_to_object(
571 data: %{"actor" => actor, "cc" => [Pleroma.Constants.as_public()]}
576 if is_list(object.data["announcements"]), do: object.data["announcements"], else: []
578 with announcements <- [actor | announcements] |> Enum.uniq() do
579 update_element_in_object("announcement", announcements, object)
583 def add_announce_to_object(_, object), do: {:ok, object}
585 def remove_announce_from_object(%Activity{data: %{"actor" => actor}}, object) do
587 if is_list(object.data["announcements"]), do: object.data["announcements"], else: []
589 with announcements <- announcements |> List.delete(actor) do
590 update_element_in_object("announcement", announcements, object)
594 #### Unfollow-related helpers
596 def make_unfollow_data(follower, followed, follow_activity, activity_id) do
599 "actor" => follower.ap_id,
600 "to" => [followed.ap_id],
601 "object" => follow_activity.data
603 |> maybe_put("id", activity_id)
606 #### Block-related helpers
607 def fetch_latest_block(%User{ap_id: blocker_id}, %User{ap_id: blocked_id}) do
610 activity in Activity,
613 "? ->> 'type' = 'Block'",
616 where: activity.actor == ^blocker_id,
617 # this is to use the index
620 "coalesce((?)->'object'->>'id', (?)->>'object') = ?",
625 order_by: [fragment("? desc nulls last", activity.id)],
632 def make_block_data(blocker, blocked, activity_id) do
635 "actor" => blocker.ap_id,
636 "to" => [blocked.ap_id],
637 "object" => blocked.ap_id
639 |> maybe_put("id", activity_id)
642 def make_unblock_data(blocker, blocked, block_activity, activity_id) do
645 "actor" => blocker.ap_id,
646 "to" => [blocked.ap_id],
647 "object" => block_activity.data
649 |> maybe_put("id", activity_id)
652 #### Create-related helpers
654 def make_create_data(params, additional) do
655 published = params.published || make_date()
659 "to" => params.to |> Enum.uniq(),
660 "actor" => params.actor.ap_id,
661 "object" => params.object,
662 "published" => published,
663 "context" => params.context
665 |> Map.merge(additional)
668 #### Flag-related helpers
670 def make_flag_data(params, additional) do
672 Enum.map(params.statuses || [], fn
673 %Activity{} = act -> act.data["id"]
674 act when is_map(act) -> act["id"]
675 act when is_binary(act) -> act
678 object = [params.account.ap_id] ++ status_ap_ids
682 "actor" => params.actor.ap_id,
683 "content" => params.content,
685 "context" => params.context,
688 |> Map.merge(additional)
692 Fetches the OrderedCollection/OrderedCollectionPage from `from`, limiting the amount of pages fetched after
693 the first one to `pages_left` pages.
694 If the amount of pages is higher than the collection has, it returns whatever was there.
696 def fetch_ordered_collection(from, pages_left, acc \\ []) do
697 with {:ok, response} <- Tesla.get(from),
698 {:ok, collection} <- Jason.decode(response.body) do
699 case collection["type"] do
700 "OrderedCollection" ->
701 # If we've encountered the OrderedCollection and not the page,
702 # just call the same function on the page address
703 fetch_ordered_collection(collection["first"], pages_left)
705 "OrderedCollectionPage" ->
707 # There are still more pages
708 if Map.has_key?(collection, "next") do
709 # There are still more pages, go deeper saving what we have into the accumulator
710 fetch_ordered_collection(
713 acc ++ collection["orderedItems"]
716 # No more pages left, just return whatever we already have
717 acc ++ collection["orderedItems"]
720 # Got the amount of pages needed, add them all to the accumulator
721 acc ++ collection["orderedItems"]
725 {:error, "Not an OrderedCollection or OrderedCollectionPage"}
730 #### Report-related helpers
732 def update_report_state(%Activity{} = activity, state) when state in @supported_report_states do
733 with new_data <- Map.put(activity.data, "state", state),
734 changeset <- Changeset.change(activity, data: new_data),
735 {:ok, activity} <- Repo.update(changeset) do
740 def update_report_state(_, _), do: {:error, "Unsupported state"}
742 def update_activity_visibility(activity, visibility) when visibility in @valid_visibilities do
743 [to, cc, recipients] =
745 |> get_updated_targets(visibility)
746 |> Enum.map(&Enum.uniq/1)
755 |> Object.change(%{data: object_data})
756 |> Object.update_and_set_cache()
764 |> Map.put(:object, object)
765 |> Activity.change(%{data: activity_data, recipients: recipients})
769 def update_activity_visibility(_, _), do: {:error, "Unsupported visibility"}
771 defp get_updated_targets(
772 %Activity{data: %{"to" => to} = data, recipients: recipients},
775 cc = Map.get(data, "cc", [])
776 follower_address = User.get_cached_by_ap_id(data["actor"]).follower_address
777 public = Pleroma.Constants.as_public()
781 to = [public | List.delete(to, follower_address)]
782 cc = [follower_address | List.delete(cc, public)]
783 recipients = [public | recipients]
787 to = [follower_address | List.delete(to, public)]
788 cc = List.delete(cc, public)
789 recipients = List.delete(recipients, public)
793 to = [follower_address | List.delete(to, public)]
794 cc = [public | List.delete(cc, follower_address)]
795 recipients = recipients ++ [follower_address, public]
803 def get_existing_votes(actor, %{data: %{"id" => id}}) do
806 [activity, object: object] in Activity.with_preloaded_object(Activity),
807 where: fragment("(?)->>'type' = 'Create'", activity.data),
808 where: fragment("(?)->>'actor' = ?", activity.data, ^actor),
811 "(?)->>'inReplyTo' = ?",
815 where: fragment("(?)->>'type' = 'Answer'", object.data)
821 defp maybe_put(map, _key, nil), do: map
822 defp maybe_put(map, key, value), do: Map.put(map, key, value)