3 * @copyright Copyright (C) 2010-2022, the Friendica project
5 * @license GNU AGPL version 3 or any later version
7 * This program is free software: you can redistribute it and/or modify
8 * it under the terms of the GNU Affero General Public License as
9 * published by the Free Software Foundation, either version 3 of the
10 * License, or (at your option) any later version.
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU Affero General Public License for more details.
17 * You should have received a copy of the GNU Affero General Public License
18 * along with this program. If not, see <https://www.gnu.org/licenses/>.
22 namespace Friendica\Protocol\ActivityPub;
24 use Friendica\Content\Text\BBCode;
25 use Friendica\Content\Text\HTML;
26 use Friendica\Content\Text\Markdown;
27 use Friendica\Core\Cache\Enum\Duration;
28 use Friendica\Core\Logger;
29 use Friendica\Core\Protocol;
30 use Friendica\Core\System;
31 use Friendica\Core\Worker;
32 use Friendica\Database\DBA;
34 use Friendica\Model\APContact;
35 use Friendica\Model\Contact;
36 use Friendica\Model\Conversation;
37 use Friendica\Model\Event;
38 use Friendica\Model\GServer;
39 use Friendica\Model\Item;
40 use Friendica\Model\ItemURI;
41 use Friendica\Model\Mail;
42 use Friendica\Model\Tag;
43 use Friendica\Model\User;
44 use Friendica\Model\Post;
45 use Friendica\Protocol\Activity;
46 use Friendica\Protocol\ActivityPub;
47 use Friendica\Protocol\Relay;
48 use Friendica\Util\DateTimeFormat;
49 use Friendica\Util\HTTPSignature;
50 use Friendica\Util\JsonLD;
51 use Friendica\Util\Network;
52 use Friendica\Util\Strings;
53 use Friendica\Worker\Delivery;
56 * ActivityPub Processor Protocol class
60 const CACHEKEY_FETCH_ACTIVITY = 'processor:fetchMissingActivity:';
61 const CACHEKEY_JUST_FETCHED = 'processor:isJustFetched:';
64 * Add an object id to the list of processed ids
70 private static function addActivityId(string $id)
72 DBA::delete('fetched-activity', ["`received` < ?", DateTimeFormat::utc('now - 5 minutes')]);
73 DBA::insert('fetched-activity', ['object-id' => $id, 'received' => DateTimeFormat::utcNow()]);
77 * Checks if the given object id has just been fetched
83 private static function isFetched(string $id): bool
85 return DBA::exists('fetched-activity', ['object-id' => $id]);
89 * Extracts the tag character (#, @, !) from mention links
94 public static function normalizeMentionLinks(string $body): string
96 return preg_replace('%\[url=([^\[\]]*)]([#@!])(.*?)\[/url]%ism', '$2[url=$1]$3[/url]', $body);
100 * Convert the language array into a language JSON
102 * @param array $languages
103 * @return string language JSON
105 private static function processLanguages(array $languages): string
107 $codes = array_keys($languages);
109 foreach ($codes as $code) {
117 return json_encode($lang);
120 * Replaces emojis in the body
123 * @param string $body
124 * @param array $emojis
126 * @return string with replaced emojis
128 private static function replaceEmojis(int $uri_id, string $body, array $emojis): string
132 array_column($emojis, 'name'),
133 array_map(function ($emoji) {
134 return '[emoji=' . $emoji['href'] . ']' . $emoji['name'] . '[/emoji]';
139 // We store the emoji here to be able to avoid storing it in the media
140 foreach ($emojis as $emoji) {
141 Post\Link::getByLink($uri_id, $emoji['href']);
147 * Store attached media files in the post-media table
150 * @param array $attachment
153 private static function storeAttachmentAsMedia(int $uriid, array $attachment)
155 if (empty($attachment['url'])) {
159 $data = ['uri-id' => $uriid];
160 $data['type'] = Post\Media::UNKNOWN;
161 $data['url'] = $attachment['url'];
162 $data['mimetype'] = $attachment['mediaType'] ?? null;
163 $data['height'] = $attachment['height'] ?? null;
164 $data['width'] = $attachment['width'] ?? null;
165 $data['size'] = $attachment['size'] ?? null;
166 $data['preview'] = $attachment['image'] ?? null;
167 $data['description'] = $attachment['name'] ?? null;
169 Post\Media::insert($data);
173 * Stire attachment data
175 * @param array $activity
178 private static function storeAttachments(array $activity, array $item)
180 if (empty($activity['attachments'])) {
184 foreach ($activity['attachments'] as $attach) {
185 self::storeAttachmentAsMedia($item['uri-id'], $attach);
190 * Store attachment data
192 * @param array $activity
195 private static function storeQuestion(array $activity, array $item)
197 if (empty($activity['question'])) {
200 $question = ['multiple' => $activity['question']['multiple']];
202 if (!empty($activity['question']['voters'])) {
203 $question['voters'] = $activity['question']['voters'];
206 if (!empty($activity['question']['end-time'])) {
207 $question['end-time'] = DateTimeFormat::utc($activity['question']['end-time']);
210 Post\Question::update($item['uri-id'], $question);
212 foreach ($activity['question']['options'] as $key => $option) {
213 $option = ['name' => $option['name'], 'replies' => $option['replies']];
214 Post\QuestionOption::update($item['uri-id'], $key, $option);
217 Logger::debug('Storing incoming question', ['type' => $activity['type'], 'uri-id' => $item['uri-id'], 'question' => $activity['question']]);
223 * @param array $activity Activity array
224 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
225 * @throws \ImagickException
227 public static function updateItem(array $activity)
229 $item = Post::selectFirst(['uri', 'uri-id', 'thr-parent', 'gravity', 'post-type', 'private'], ['uri' => $activity['id']]);
230 if (!DBA::isResult($item)) {
231 Logger::notice('No existing item, item will be created', ['uri' => $activity['id']]);
232 $item = self::createItem($activity, false);
234 Queue::remove($activity);
238 self::postItem($activity, $item);
242 $item['changed'] = DateTimeFormat::utcNow();
243 $item['edited'] = DateTimeFormat::utc($activity['updated']);
245 $item = self::processContent($activity, $item);
247 Queue::remove($activity);
251 self::storeAttachments($activity, $item);
252 self::storeQuestion($activity, $item);
254 Post\History::add($item['uri-id'], $item);
255 Item::update($item, ['uri' => $activity['id']]);
257 Queue::remove($activity);
259 if ($activity['object_type'] == 'as:Event') {
260 $posts = Post::select(['event-id', 'uid'], ["`uri` = ? AND `event-id` > ?", $activity['id'], 0]);
261 while ($post = DBA::fetch($posts)) {
262 self::updateEvent($post['event-id'], $activity);
268 * Update an existing event
270 * @param int $event_id
271 * @param array $activity
273 private static function updateEvent(int $event_id, array $activity)
275 $event = DBA::selectFirst('event', [], ['id' => $event_id]);
277 $event['edited'] = DateTimeFormat::utc($activity['updated']);
278 $event['summary'] = HTML::toBBCode($activity['name']);
279 $event['desc'] = HTML::toBBCode($activity['content']);
280 if (!empty($activity['start-time'])) {
281 $event['start'] = DateTimeFormat::utc($activity['start-time']);
283 if (!empty($activity['end-time'])) {
284 $event['finish'] = DateTimeFormat::utc($activity['end-time']);
286 $event['nofinish'] = empty($event['finish']);
287 $event['location'] = $activity['location'];
289 Logger::info('Updating event', ['uri' => $activity['id'], 'id' => $event_id]);
290 Event::store($event);
294 * Prepares data for a message
296 * @param array $activity Activity array
297 * @param bool $fetch_parents
299 * @return array Internal item
301 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
302 * @throws \ImagickException
304 public static function createItem(array $activity, bool $fetch_parents): array
307 $item['verb'] = Activity::POST;
308 $item['thr-parent'] = $activity['reply-to-id'];
310 if ($activity['reply-to-id'] == $activity['id']) {
311 $item['gravity'] = GRAVITY_PARENT;
312 $item['object-type'] = Activity\ObjectType::NOTE;
314 $item['gravity'] = GRAVITY_COMMENT;
315 $item['object-type'] = Activity\ObjectType::COMMENT;
318 if (!empty($activity['conversation'])) {
319 $item['conversation'] = $activity['conversation'];
320 } elseif (!empty($activity['context'])) {
321 $item['conversation'] = $activity['context'];
324 if (!empty($item['conversation'])) {
325 $conversation = Post::selectFirstThread(['uri'], ['conversation' => $item['conversation']]);
326 if (!empty($conversation)) {
327 Logger::debug('Got conversation', ['conversation' => $item['conversation'], 'parent' => $conversation]);
328 $item['parent-uri'] = $conversation['uri'];
329 $item['parent-uri-id'] = ItemURI::getIdByURI($item['parent-uri']);
335 Logger::debug('Create Item', ['id' => $activity['id'], 'conversation' => $item['conversation'] ?? '']);
336 if (empty($activity['author']) && empty($activity['actor'])) {
337 Logger::notice('Missing author and actor. We quit here.', ['activity' => $activity]);
338 Queue::remove($activity);
342 if (!in_array(0, $activity['receiver']) || !DI::config()->get('system', 'fetch_parents')) {
343 $fetch_parents = false;
346 if ($fetch_parents && empty($activity['directmessage']) && ($activity['id'] != $activity['reply-to-id']) && !Post::exists(['uri' => $activity['reply-to-id']])) {
347 $result = self::fetchParent($activity, !empty($conversation));
348 if (!empty($result)) {
349 if (($item['thr-parent'] != $result) && Post::exists(['uri' => $result])) {
350 $item['thr-parent'] = $result;
352 } elseif (empty($conversation)) {
357 $item['diaspora_signed_text'] = $activity['diaspora:comment'] ?? '';
359 if (empty($conversation) && empty($activity['directmessage']) && ($item['gravity'] != GRAVITY_PARENT) && !Post::exists(['uri' => $item['thr-parent']])) {
360 Logger::notice('Parent not found, message will be discarded.', ['thr-parent' => $item['thr-parent']]);
361 if (!$fetch_parents) {
362 Queue::remove($activity);
367 $item['network'] = Protocol::ACTIVITYPUB;
368 $item['author-link'] = $activity['author'];
369 $item['author-id'] = Contact::getIdForURL($activity['author']);
370 $item['owner-link'] = $activity['actor'];
371 $item['owner-id'] = Contact::getIdForURL($activity['actor']);
373 if (in_array(0, $activity['receiver']) && !empty($activity['unlisted'])) {
374 $item['private'] = Item::UNLISTED;
375 } elseif (in_array(0, $activity['receiver'])) {
376 $item['private'] = Item::PUBLIC;
378 $item['private'] = Item::PRIVATE;
381 if (!empty($activity['raw'])) {
382 $item['source'] = $activity['raw'];
385 $item['protocol'] = Conversation::PARCEL_ACTIVITYPUB;
387 if (isset($activity['push'])) {
388 $item['direction'] = $activity['push'] ? Conversation::PUSH : Conversation::PULL;
391 if (!empty($activity['from-relay'])) {
392 $item['direction'] = Conversation::RELAY;
395 if ($activity['object_type'] == 'as:Article') {
396 $item['post-type'] = Item::PT_ARTICLE;
397 } elseif ($activity['object_type'] == 'as:Audio') {
398 $item['post-type'] = Item::PT_AUDIO;
399 } elseif ($activity['object_type'] == 'as:Document') {
400 $item['post-type'] = Item::PT_DOCUMENT;
401 } elseif ($activity['object_type'] == 'as:Event') {
402 $item['post-type'] = Item::PT_EVENT;
403 } elseif ($activity['object_type'] == 'as:Image') {
404 $item['post-type'] = Item::PT_IMAGE;
405 } elseif ($activity['object_type'] == 'as:Page') {
406 $item['post-type'] = Item::PT_PAGE;
407 } elseif ($activity['object_type'] == 'as:Question') {
408 $item['post-type'] = Item::PT_POLL;
409 } elseif ($activity['object_type'] == 'as:Video') {
410 $item['post-type'] = Item::PT_VIDEO;
412 $item['post-type'] = Item::PT_NOTE;
415 $item['isForum'] = false;
417 if (!empty($activity['thread-completion'])) {
418 if ($activity['thread-completion'] != $item['owner-id']) {
419 $actor = Contact::getById($activity['thread-completion'], ['url']);
420 $item['causer-link'] = $actor['url'];
421 $item['causer-id'] = $activity['thread-completion'];
422 Logger::info('Use inherited actor as causer.', ['id' => $item['owner-id'], 'activity' => $activity['thread-completion'], 'owner' => $item['owner-link'], 'actor' => $actor['url']]);
424 // Store the original actor in the "causer" fields to enable the check for ignored or blocked contacts
425 $item['causer-link'] = $item['owner-link'];
426 $item['causer-id'] = $item['owner-id'];
427 Logger::info('Use actor as causer.', ['id' => $item['owner-id'], 'actor' => $item['owner-link']]);
430 $item['owner-link'] = $item['author-link'];
431 $item['owner-id'] = $item['author-id'];
433 $actor = APContact::getByURL($item['owner-link'], false);
434 $item['isForum'] = ($actor['type'] == 'Group');
437 $item['uri'] = $activity['id'];
439 if (empty($activity['published']) || empty($activity['updated'])) {
440 DI::logger()->notice('published or updated keys are empty for activity', ['activity' => $activity, 'callstack' => System::callstack(10)]);
443 $item['created'] = DateTimeFormat::utc($activity['published'] ?? 'now');
444 $item['edited'] = DateTimeFormat::utc($activity['updated'] ?? 'now');
445 $guid = $activity['sc:identifier'] ?: self::getGUIDByURL($item['uri']);
446 $item['guid'] = $activity['diaspora:guid'] ?: $guid;
448 $item['uri-id'] = ItemURI::insert(['uri' => $item['uri'], 'guid' => $item['guid']]);
449 if (empty($item['uri-id'])) {
450 Logger::warning('Unable to get a uri-id for an item uri', ['uri' => $item['uri'], 'guid' => $item['guid']]);
454 $item['thr-parent-id'] = ItemURI::getIdByURI($item['thr-parent']);
456 $item = self::processContent($activity, $item);
458 Logger::info('Message was not processed');
459 Queue::remove($activity);
463 $item['plink'] = $activity['alternate-url'] ?? $item['uri'];
465 self::storeAttachments($activity, $item);
466 self::storeQuestion($activity, $item);
468 // We received the post via AP, so we set the protocol of the server to AP
469 $contact = Contact::getById($item['author-id'], ['gsid']);
470 if (!empty($contact['gsid'])) {
471 GServer::setProtocol($contact['gsid'], Post\DeliveryData::ACTIVITYPUB);
474 if ($item['author-id'] != $item['owner-id']) {
475 $contact = Contact::getById($item['owner-id'], ['gsid']);
476 if (!empty($contact['gsid'])) {
477 GServer::setProtocol($contact['gsid'], Post\DeliveryData::ACTIVITYPUB);
485 * Fetch and process parent posts for the given activity
487 * @param array $activity
488 * @param bool $in_background
492 private static function fetchParent(array $activity, bool $in_background = false): string
494 if (self::isFetched($activity['reply-to-id'])) {
495 Logger::info('Id is already fetched', ['id' => $activity['reply-to-id']]);
499 self::addActivityId($activity['reply-to-id']);
501 if (!DI::config()->get('system', 'fetch_by_worker')) {
502 $in_background = false;
505 $recursion_depth = $activity['recursion-depth'] ?? 0;
507 if (!$in_background && ($recursion_depth < DI::config()->get('system', 'max_recursion_depth'))) {
508 Logger::notice('Parent not found. Try to refetch it.', ['parent' => $activity['reply-to-id'], 'recursion-depth' => $recursion_depth]);
509 $result = self::fetchMissingActivity($activity['reply-to-id'], $activity, '', Receiver::COMPLETION_AUTO);
510 if (empty($result) && self::isActivityGone($activity['reply-to-id'])) {
511 Logger::notice('The activity is gone, the queue entry will be deleted', ['parent' => $activity['reply-to-id']]);
512 if (!empty($activity['entry-id'])) {
513 Queue::deleteById($activity['entry-id']);
516 } elseif (!empty($result)) {
517 $exists = Post::exists(['uri' => [$result, $activity['reply-to-id']]]);
519 Logger::notice('The activity has been fetched and created.', ['parent' => $result]);
521 } elseif (DI::config()->get('system', 'fetch_by_worker') || DI::config()->get('system', 'decoupled_receiver')) {
522 Logger::notice('The activity has been fetched and will hopefully be created later.', ['parent' => $result]);
524 Logger::notice('The activity exists but has not been created, the queue entry will be deleted.', ['parent' => $result]);
525 if (!empty($activity['entry-id'])) {
526 Queue::deleteById($activity['entry-id']);
531 if (empty($result) && !DI::config()->get('system', 'fetch_by_worker')) {
534 } elseif (self::isActivityGone($activity['reply-to-id'])) {
535 Logger::notice('The activity is gone. We will not spawn a worker. The queue entry will be deleted', ['parent' => $activity['reply-to-id']]);
536 if ($in_background) {
537 // fetching in background is done for all activities where we have got the conversation
538 // There we only delete the single activity and not the whole thread since we can store the
539 // other posts in the thread even with missing posts.
540 Queue::remove($activity);
541 } elseif (!empty($activity['entry-id'])) {
542 Queue::deleteById($activity['entry-id']);
545 } elseif ($in_background) {
546 Logger::notice('Fetching is done in the background.', ['parent' => $activity['reply-to-id']]);
548 Logger::notice('Recursion level is too high.', ['parent' => $activity['reply-to-id'], 'recursion-depth' => $recursion_depth]);
551 if (!Fetch::hasWorker($activity['reply-to-id'])) {
552 Logger::notice('Fetching is done by worker.', ['parent' => $activity['reply-to-id'], 'recursion-depth' => $recursion_depth]);
553 Fetch::add($activity['reply-to-id']);
554 $activity['recursion-depth'] = 0;
555 $wid = Worker::add(PRIORITY_HIGH, 'FetchMissingActivity', $activity['reply-to-id'], $activity, '', Receiver::COMPLETION_AUTO);
556 Fetch::setWorkerId($activity['reply-to-id'], $wid);
558 Logger::debug('Activity will already be fetched via a worker.', ['url' => $activity['reply-to-id']]);
565 * Check if a given activity is no longer available
571 public static function isActivityGone(string $url): bool
573 $curlResult = HTTPSignature::fetchRaw($url, 0);
575 if (Network::isUrlBlocked($url)) {
579 // @todo To ensure that the remote system is working correctly, we can check if the "Content-Type" contains JSON
580 if (in_array($curlResult->getReturnCode(), [401, 404])) {
584 if ($curlResult->isSuccess()) {
585 $object = json_decode($curlResult->getBody(), true);
586 if (!empty($object)) {
587 $activity = JsonLD::compact($object);
588 if (JsonLD::fetchElement($activity, '@type') == 'as:Tombstone') {
592 } elseif ($curlResult->getReturnCode() == 0) {
593 $host = parse_url($url, PHP_URL_HOST);
594 if (!(filter_var($host, FILTER_VALIDATE_IP) || @dns_get_record($host . '.', DNS_A + DNS_AAAA))) {
604 * @param array $activity
605 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
606 * @throws \ImagickException
608 public static function deleteItem(array $activity)
610 $owner = Contact::getIdForURL($activity['actor']);
612 Logger::info('Deleting item', ['object' => $activity['object_id'], 'owner' => $owner]);
613 Item::markForDeletion(['uri' => $activity['object_id'], 'owner-id' => $owner]);
614 Queue::remove($activity);
618 * Prepare the item array for an activity
620 * @param array $activity Activity array
621 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
622 * @throws \ImagickException
624 public static function addTag(array $activity)
626 if (empty($activity['object_content']) || empty($activity['object_id'])) {
630 foreach ($activity['receiver'] as $receiver) {
631 $item = Post::selectFirst(['id', 'uri-id', 'origin', 'author-link'], ['uri' => $activity['target_id'], 'uid' => $receiver]);
632 if (!DBA::isResult($item)) {
633 // We don't fetch missing content for this purpose
637 if (($item['author-link'] != $activity['actor']) && !$item['origin']) {
638 Logger::info('Not origin, not from the author, skipping update', ['id' => $item['id'], 'author' => $item['author-link'], 'actor' => $activity['actor']]);
642 Tag::store($item['uri-id'], Tag::HASHTAG, $activity['object_content'], $activity['object_id']);
643 Logger::info('Tagged item', ['id' => $item['id'], 'tag' => $activity['object_content'], 'uri' => $activity['target_id'], 'actor' => $activity['actor']]);
648 * Prepare the item array for an activity
650 * @param array $activity Activity array
651 * @param string $verb Activity verb
652 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
653 * @throws \ImagickException
655 public static function createActivity(array $activity, string $verb)
657 $activity['reply-to-id'] = $activity['object_id'];
658 $item = self::createItem($activity, false);
660 Logger::debug('Activity was not prepared', ['id' => $activity['object_id']]);
664 $item['verb'] = $verb;
665 $item['thr-parent'] = $activity['object_id'];
666 $item['gravity'] = GRAVITY_ACTIVITY;
667 unset($item['post-type']);
668 $item['object-type'] = Activity\ObjectType::NOTE;
670 if (!empty($activity['content'])) {
671 $item['body'] = HTML::toBBCode($activity['content']);
674 $item['diaspora_signed_text'] = $activity['diaspora:like'] ?? '';
676 self::postItem($activity, $item);
680 * Fetch the Uri-Id of a post for the "featured" collection
682 * @param array $activity
685 private static function getUriIdForFeaturedCollection(array $activity)
687 $actor = APContact::getByURL($activity['actor']);
692 // Refetch the account when the "featured" collection is missing.
693 // This can be removed in a future version (end of 2022 should be good).
694 if (empty($actor['featured'])) {
695 $actor = APContact::getByURL($activity['actor'], true);
701 $parent = Post::selectFirst(['uri-id', 'author-id'], ['uri' => $activity['object_id']]);
702 if (empty($parent['uri-id'])) {
703 if (self::fetchMissingActivity($activity['object_id'], $activity, '', Receiver::COMPLETION_AUTO)) {
704 $parent = Post::selectFirst(['uri-id'], ['uri' => $activity['object_id']]);
708 if (!empty($parent['uri-id'])) {
716 * Add a post to the "Featured" collection
718 * @param array $activity
720 public static function addToFeaturedCollection(array $activity)
722 $post = self::getUriIdForFeaturedCollection($activity);
727 Logger::debug('Add post to featured collection', ['post' => $post]);
729 Post\Collection::add($post['uri-id'], Post\Collection::FEATURED, $post['author-id']);
730 Queue::remove($activity);
734 * Remove a post to the "Featured" collection
736 * @param array $activity
738 public static function removeFromFeaturedCollection(array $activity)
740 $post = self::getUriIdForFeaturedCollection($activity);
745 Logger::debug('Remove post from featured collection', ['post' => $post]);
747 Post\Collection::remove($post['uri-id'], Post\Collection::FEATURED);
748 Queue::remove($activity);
754 * @param array $activity Activity array
757 * @return int event id
760 public static function createEvent(array $activity, array $item): int
762 $event['summary'] = HTML::toBBCode($activity['name'] ?: $activity['summary']);
763 $event['desc'] = HTML::toBBCode($activity['content'] ?? '');
764 if (!empty($activity['start-time'])) {
765 $event['start'] = DateTimeFormat::utc($activity['start-time']);
767 if (!empty($activity['end-time'])) {
768 $event['finish'] = DateTimeFormat::utc($activity['end-time']);
770 $event['nofinish'] = empty($event['finish']);
771 $event['location'] = $activity['location'];
772 $event['cid'] = $item['contact-id'];
773 $event['uid'] = $item['uid'];
774 $event['uri'] = $item['uri'];
775 $event['edited'] = $item['edited'];
776 $event['private'] = $item['private'];
777 $event['guid'] = $item['guid'];
778 $event['plink'] = $item['plink'];
779 $event['network'] = $item['network'];
780 $event['protocol'] = $item['protocol'];
781 $event['direction'] = $item['direction'];
782 $event['source'] = $item['source'];
784 $ev = DBA::selectFirst('event', ['id'], ['uri' => $item['uri'], 'uid' => $item['uid']]);
785 if (DBA::isResult($ev)) {
786 $event['id'] = $ev['id'];
789 $event_id = Event::store($event);
791 Logger::info('Event was stored', ['id' => $event_id]);
797 * Process the content
799 * @param array $activity Activity array
801 * @return array|bool Returns the item array or false if there was an unexpected occurrence
804 private static function processContent(array $activity, array $item)
806 if (!empty($activity['mediatype']) && ($activity['mediatype'] == 'text/markdown')) {
807 $item['title'] = strip_tags($activity['name']);
808 $content = Markdown::toBBCode($activity['content']);
809 } elseif (!empty($activity['mediatype']) && ($activity['mediatype'] == 'text/bbcode')) {
810 $item['title'] = $activity['name'];
811 $content = $activity['content'];
813 // By default assume "text/html"
814 $item['title'] = HTML::toBBCode($activity['name'] ?? '');
815 $content = HTML::toBBCode($activity['content'] ?? '');
818 $item['title'] = trim(BBCode::toPlaintext($item['title']));
820 if (!empty($activity['languages'])) {
821 $item['language'] = self::processLanguages($activity['languages']);
824 if (!empty($activity['emojis'])) {
825 $content = self::replaceEmojis($item['uri-id'], $content, $activity['emojis']);
828 $content = self::addMentionLinks($content, $activity['tags']);
830 if (!empty($activity['source'])) {
831 $item['body'] = $activity['source'];
832 $item['raw-body'] = $content;
833 $item['body'] = Item::improveSharedDataInBody($item);
835 $parent_uri = $item['parent-uri'] ?? $item['thr-parent'];
836 if (empty($activity['directmessage']) && ($parent_uri != $item['uri']) && ($item['gravity'] == GRAVITY_COMMENT)) {
837 $parent = Post::selectFirst(['id', 'uri-id', 'private', 'author-link', 'alias'], ['uri' => $parent_uri]);
838 if (!DBA::isResult($parent)) {
839 Logger::warning('Unknown parent item.', ['uri' => $parent_uri]);
842 if (!empty($activity['type']) && in_array($activity['type'], Receiver::CONTENT_TYPES) && ($item['private'] == Item::PRIVATE) && ($parent['private'] != Item::PRIVATE)) {
843 Logger::warning('Item is private but the parent is not. Dropping.', ['item-uri' => $item['uri'], 'thr-parent' => $item['thr-parent']]);
847 $content = self::removeImplicitMentionsFromBody($content, $parent);
849 $item['content-warning'] = HTML::toBBCode($activity['summary'] ?? '');
850 $item['raw-body'] = $item['body'] = $content;
853 self::storeFromBody($item);
854 self::storeTags($item['uri-id'], $activity['tags']);
856 self::storeReceivers($item['uri-id'], $activity['receiver_urls'] ?? []);
858 $item['location'] = $activity['location'];
860 if (!empty($activity['latitude']) && !empty($activity['longitude'])) {
861 $item['coord'] = $activity['latitude'] . ' ' . $activity['longitude'];
864 $item['app'] = $activity['generator'];
870 * Store hashtags and mentions
874 private static function storeFromBody(array $item)
876 // Make sure to delete all existing tags (can happen when called via the update functionality)
877 DBA::delete('post-tag', ['uri-id' => $item['uri-id']]);
879 Tag::storeFromBody($item['uri-id'], $item['body'], '@!');
883 * Generate a GUID out of an URL of an ActivityPub post.
885 * @param string $url message URL
886 * @return string with GUID
888 private static function getGUIDByURL(string $url): string
890 $parsed = parse_url($url);
892 $host_hash = hash('crc32', $parsed['host']);
894 unset($parsed["scheme"]);
895 unset($parsed["host"]);
897 $path = implode("/", $parsed);
899 return $host_hash . '-'. hash('fnv164', $path) . '-'. hash('joaat', $path);
903 * Checks if an incoming message is wanted
905 * @param array $activity
907 * @return boolean Is the message wanted?
909 private static function isSolicitedMessage(array $activity, array $item): bool
911 // The checks are split to improve the support when searching why a message was accepted.
912 if (count($activity['receiver']) != 1) {
913 // The message has more than one receiver, so it is wanted.
914 Logger::debug('Message has got several receivers - accepted', ['uri-id' => $item['uri-id'], 'guid' => $item['guid'], 'url' => $item['uri']]);
918 if ($item['private'] == Item::PRIVATE) {
919 // We only look at public posts here. Private posts are expected to be intentionally posted to the single receiver.
920 Logger::debug('Message is private - accepted', ['uri-id' => $item['uri-id'], 'guid' => $item['guid'], 'url' => $item['uri']]);
924 if (!empty($activity['from-relay'])) {
925 // We check relay posts at another place. When it arrived here, the message is already checked.
926 Logger::debug('Message is a relay post that is already checked - accepted', ['uri-id' => $item['uri-id'], 'guid' => $item['guid'], 'url' => $item['uri']]);
930 if (in_array($activity['completion-mode'] ?? Receiver::COMPLETION_NONE, [Receiver::COMPLETION_MANUAL, Receiver::COMPLETION_ANNOUCE])) {
931 // Manual completions and completions caused by reshares are allowed without any further checks.
932 Logger::debug('Message is in completion mode - accepted', ['mode' => $activity['completion-mode'], 'uri-id' => $item['uri-id'], 'guid' => $item['guid'], 'url' => $item['uri']]);
936 if ($item['gravity'] != GRAVITY_PARENT) {
937 // We cannot reliably check at this point if a comment or activity belongs to an accepted post or needs to be fetched
938 // This can possibly be improved in the future.
939 Logger::debug('Message is no parent - accepted', ['uri-id' => $item['uri-id'], 'guid' => $item['guid'], 'url' => $item['uri']]);
943 $tags = array_column(Tag::getByURIId($item['uri-id'], [Tag::HASHTAG]), 'name');
944 if (Relay::isSolicitedPost($tags, $item['body'], $item['author-id'], $item['uri'], Protocol::ACTIVITYPUB)) {
945 Logger::debug('Post is accepted because of the relay settings', ['uri-id' => $item['uri-id'], 'guid' => $item['guid'], 'url' => $item['uri']]);
953 * Creates an item post
955 * @param array $activity Activity data
956 * @param array $item item array
957 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
958 * @throws \ImagickException
960 public static function postItem(array $activity, array $item)
968 ksort($activity['receiver']);
970 if (!self::isSolicitedMessage($activity, $item)) {
971 DBA::delete('item-uri', ['id' => $item['uri-id']]);
972 if (!empty($activity['entry-id'])) {
973 Queue::deleteById($activity['entry-id']);
978 foreach ($activity['receiver'] as $receiver) {
979 if ($receiver == -1) {
983 if (($receiver != 0) && empty($item['parent-uri-id']) && !empty($item['thr-parent-id'])) {
984 $parent = Post::selectFirst(['parent-uri-id', 'parent-uri'], ['uri-id' => $item['thr-parent-id'], 'uid' => [0, $receiver]]);
985 if (!empty($parent['parent-uri-id'])) {
986 $item['parent-uri-id'] = $parent['parent-uri-id'];
987 $item['parent-uri'] = $parent['parent-uri'];
991 $item['uid'] = $receiver;
993 $type = $activity['reception_type'][$receiver] ?? Receiver::TARGET_UNKNOWN;
995 case Receiver::TARGET_TO:
996 $item['post-reason'] = Item::PR_TO;
998 case Receiver::TARGET_CC:
999 $item['post-reason'] = Item::PR_CC;
1001 case Receiver::TARGET_BTO:
1002 $item['post-reason'] = Item::PR_BTO;
1004 case Receiver::TARGET_BCC:
1005 $item['post-reason'] = Item::PR_BCC;
1007 case Receiver::TARGET_FOLLOWER:
1008 $item['post-reason'] = Item::PR_FOLLOWER;
1010 case Receiver::TARGET_ANSWER:
1011 $item['post-reason'] = Item::PR_COMMENT;
1013 case Receiver::TARGET_GLOBAL:
1014 $item['post-reason'] = Item::PR_GLOBAL;
1017 $item['post-reason'] = Item::PR_NONE;
1020 $item['post-reason'] = Item::getPostReason($item);
1022 if (in_array($item['post-reason'], [Item::PR_GLOBAL, Item::PR_NONE])) {
1023 if (!empty($activity['from-relay'])) {
1024 $item['post-reason'] = Item::PR_RELAY;
1025 } elseif (!empty($activity['thread-completion'])) {
1026 $item['post-reason'] = Item::PR_FETCHED;
1027 } elseif (!empty($activity['push'])) {
1028 $item['post-reason'] = Item::PR_PUSHED;
1030 } elseif (($item['post-reason'] == Item::PR_FOLLOWER) && !empty($activity['from-relay'])) {
1031 // When a post arrives via a relay and we follow the author, we have to override the causer.
1032 // Otherwise the system assumes that we follow the relay. (See "addRowInformation")
1033 Logger::debug('Relay post for follower', ['receiver' => $receiver, 'guid' => $item['guid'], 'relay' => $activity['from-relay']]);
1034 $item['causer-id'] = ($item['gravity'] == GRAVITY_PARENT) ? $item['owner-id'] : $item['author-id'];
1037 if ($item['isForum'] ?? false) {
1038 $item['contact-id'] = Contact::getIdForURL($activity['actor'], $receiver);
1040 $item['contact-id'] = Contact::getIdForURL($activity['author'], $receiver);
1043 if (($receiver != 0) && empty($item['contact-id'])) {
1044 $item['contact-id'] = Contact::getIdForURL($activity['author']);
1047 if (!empty($activity['directmessage'])) {
1048 self::postMail($activity, $item);
1052 if (($receiver != 0) && ($item['gravity'] == GRAVITY_PARENT) && !in_array($item['post-reason'], [Item::PR_FOLLOWER, Item::PR_TAG, item::PR_TO, Item::PR_CC])) {
1053 if (!($item['isForum'] ?? false)) {
1054 if ($item['post-reason'] == Item::PR_BCC) {
1055 Logger::info('Top level post via BCC from a non sharer, ignoring', ['uid' => $receiver, 'contact' => $item['contact-id'], 'url' => $item['uri']]);
1059 if ((DI::pConfig()->get($receiver, 'system', 'accept_only_sharer') != Item::COMPLETION_LIKE)
1060 && in_array($activity['thread-children-type'] ?? '', Receiver::ACTIVITY_TYPES)) {
1061 Logger::info('Top level post from thread completion from a non sharer had been initiated via an activity, ignoring',
1062 ['type' => $activity['thread-children-type'], 'user' => $item['uid'], 'causer' => $item['causer-link'], 'author' => $activity['author'], 'url' => $item['uri']]);
1068 $user = User::getById($receiver, ['account-type']);
1069 if (!empty($user['account-type'])) {
1070 $is_forum = ($user['account-type'] == User::ACCOUNT_TYPE_COMMUNITY);
1073 if ((DI::pConfig()->get($receiver, 'system', 'accept_only_sharer') == Item::COMPLETION_NONE)
1074 && ((!$is_forum && !($item['isForum'] ?? false) && ($activity['type'] != 'as:Announce'))
1075 || !Contact::isSharingByURL($activity['actor'], $receiver))) {
1076 Logger::info('Actor is a non sharer, is no forum or it is no announce', ['uid' => $receiver, 'actor' => $activity['actor'], 'url' => $item['uri'], 'type' => $activity['type']]);
1080 Logger::info('Accepting post', ['uid' => $receiver, 'url' => $item['uri']]);
1083 if (!self::hasParents($item, $receiver)) {
1087 if (($item['gravity'] != GRAVITY_ACTIVITY) && ($activity['object_type'] == 'as:Event')) {
1088 $event_id = self::createEvent($activity, $item);
1090 $item = Event::getItemArrayForImportedId($event_id, $item);
1093 $item_id = Item::insert($item);
1095 Logger::info('Item insertion successful', ['user' => $item['uid'], 'item_id' => $item_id]);
1098 Logger::notice('Item insertion aborted', ['uri' => $item['uri'], 'uid' => $item['uid']]);
1099 if (($item['uid'] == 0) && (count($activity['receiver']) > 1)) {
1100 Logger::info('Public item was aborted. We skip for all users.', ['uri' => $item['uri']]);
1105 if ($item['uid'] == 0) {
1110 Queue::remove($activity);
1112 if ($success && Queue::hasChildren($item['uri']) && Post::exists(['uri' => $item['uri']])) {
1113 Queue::processReplyByUri($item['uri']);
1116 // Store send a follow request for every reshare - but only when the item had been stored
1117 if ($stored && ($item['private'] != Item::PRIVATE) && ($item['gravity'] == GRAVITY_PARENT) && !empty($item['author-link']) && ($item['author-link'] != $item['owner-link'])) {
1118 $author = APContact::getByURL($item['owner-link'], false);
1119 // We send automatic follow requests for reshared messages. (We don't need though for forum posts)
1120 if ($author['type'] != 'Group') {
1121 Logger::info('Send follow request', ['uri' => $item['uri'], 'stored' => $stored, 'to' => $item['author-link']]);
1122 ActivityPub\Transmitter::sendFollowObject($item['uri'], $item['author-link']);
1128 * Checks if there are parent posts for the given receiver.
1129 * If not, then the system will try to add them.
1131 * @param array $item
1132 * @param integer $receiver
1135 private static function hasParents(array $item, int $receiver)
1137 if (($receiver == 0) || ($item['gravity'] == GRAVITY_PARENT)) {
1141 $fields = ['causer-id' => $item['causer-id'] ?? $item['author-id'], 'post-reason' => Item::PR_FETCHED];
1145 if ($item['verb'] != Activity::ANNOUNCE) {
1146 switch (DI::pConfig()->get($receiver, 'system', 'accept_only_sharer')) {
1147 case Item::COMPLETION_COMMENT:
1148 $add_parent = ($item['gravity'] != GRAVITY_ACTIVITY);
1151 case Item::COMPLETION_NONE:
1152 $add_parent = false;
1158 $add_parent = Contact::isSharing($fields['causer-id'], $receiver);
1159 if (!$add_parent && ($item['author-id'] != $fields['causer-id'])) {
1160 $add_parent = Contact::isSharing($item['author-id'], $receiver);
1162 if (!$add_parent && !in_array($item['owner-id'], [$fields['causer-id'], $item['author-id']])) {
1163 $add_parent = Contact::isSharing($item['owner-id'], $receiver);
1167 $has_parents = false;
1169 if (!empty($item['parent-uri-id'])) {
1170 if (Post::exists(['uri-id' => $item['parent-uri-id'], 'uid' => $receiver])) {
1171 $has_parents = true;
1172 } elseif ($add_parent && Post::exists(['uri-id' => $item['parent-uri'], 'uid' => 0])) {
1173 $stored = Item::storeForUserByUriId($item['parent-uri-id'], $receiver, $fields);
1174 $has_parents = (bool)$stored;
1176 Logger::notice('Inserted missing parent post', ['stored' => $stored, 'uid' => $receiver, 'parent' => $item['parent-uri']]);
1178 Logger::notice('Parent could not be added.', ['uid' => $receiver, 'uri' => $item['uri'], 'parent' => $item['parent-uri']]);
1181 } elseif ($add_parent) {
1182 Logger::debug('Parent does not exist.', ['uid' => $receiver, 'uri' => $item['uri'], 'parent' => $item['parent-uri']]);
1184 Logger::debug('Parent should not be added.', ['uid' => $receiver, 'gravity' => $item['gravity'], 'verb' => $item['verb'], 'guid' => $item['guid'], 'uri' => $item['uri'], 'parent' => $item['parent-uri']]);
1188 if (empty($item['parent-uri-id']) || ($item['thr-parent-id'] != $item['parent-uri-id'])) {
1189 if (Post::exists(['uri-id' => $item['thr-parent-id'], 'uid' => $receiver])) {
1190 $has_parents = true;
1191 } elseif (($has_parents || $add_parent) && Post::exists(['uri-id' => $item['thr-parent-id'], 'uid' => 0])) {
1192 $stored = Item::storeForUserByUriId($item['thr-parent-id'], $receiver, $fields);
1193 $has_parents = $has_parents || (bool)$stored;
1195 Logger::notice('Inserted missing thread parent post', ['stored' => $stored, 'uid' => $receiver, 'thread-parent' => $item['thr-parent']]);
1197 Logger::notice('Thread parent could not be added.', ['uid' => $receiver, 'uri' => $item['uri'], 'thread-parent' => $item['thr-parent']]);
1199 } elseif ($add_parent) {
1200 Logger::debug('Thread parent does not exist.', ['uid' => $receiver, 'uri' => $item['uri'], 'thread-parent' => $item['thr-parent']]);
1202 Logger::debug('Thread parent should not be added.', ['uid' => $receiver, 'gravity' => $item['gravity'], 'verb' => $item['verb'], 'guid' => $item['guid'], 'uri' => $item['uri'], 'thread-parent' => $item['thr-parent']]);
1206 return $has_parents;
1210 * Store tags and mentions into the tag table
1212 * @param integer $uriid
1213 * @param array $tags
1215 private static function storeTags(int $uriid, array $tags = null)
1217 foreach ($tags as $tag) {
1218 if (empty($tag['name']) || empty($tag['type']) || !in_array($tag['type'], ['Mention', 'Hashtag'])) {
1222 $hash = substr($tag['name'], 0, 1);
1224 if ($tag['type'] == 'Mention') {
1225 if (in_array($hash, [Tag::TAG_CHARACTER[Tag::MENTION],
1226 Tag::TAG_CHARACTER[Tag::EXCLUSIVE_MENTION],
1227 Tag::TAG_CHARACTER[Tag::IMPLICIT_MENTION]])) {
1228 $tag['name'] = substr($tag['name'], 1);
1230 $type = Tag::IMPLICIT_MENTION;
1232 if (!empty($tag['href'])) {
1233 $apcontact = APContact::getByURL($tag['href']);
1234 if (!empty($apcontact['name']) || !empty($apcontact['nick'])) {
1235 $tag['name'] = $apcontact['name'] ?: $apcontact['nick'];
1238 } elseif ($tag['type'] == 'Hashtag') {
1239 if ($hash == Tag::TAG_CHARACTER[Tag::HASHTAG]) {
1240 $tag['name'] = substr($tag['name'], 1);
1242 $type = Tag::HASHTAG;
1245 if (empty($tag['name'])) {
1249 Tag::store($uriid, $type, $tag['name'], $tag['href']);
1253 public static function storeReceivers(int $uriid, array $receivers)
1255 foreach (['as:to' => Tag::TO, 'as:cc' => Tag::CC, 'as:bto' => Tag::BTO, 'as:bcc' => Tag::BCC] as $element => $type) {
1256 if (!empty($receivers[$element])) {
1257 foreach ($receivers[$element] as $receiver) {
1258 if ($receiver == ActivityPub::PUBLIC_COLLECTION) {
1259 $name = Receiver::PUBLIC_COLLECTION;
1261 $name = trim(parse_url($receiver, PHP_URL_PATH), '/');
1264 $target = Tag::getTargetType($receiver);
1265 Logger::debug('Got target type', ['type' => $target, 'url' => $receiver]);
1266 Tag::store($uriid, $type, $name, $receiver, $target);
1273 * Creates an mail post
1275 * @param array $activity Activity data
1276 * @param array $item item array
1277 * @return int|bool New mail table row id or false on error
1278 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1280 private static function postMail(array $activity, array $item)
1282 if (($item['gravity'] != GRAVITY_PARENT) && !DBA::exists('mail', ['uri' => $item['thr-parent'], 'uid' => $item['uid']])) {
1283 Logger::info('Parent not found, mail will be discarded.', ['uid' => $item['uid'], 'uri' => $item['thr-parent']]);
1287 Logger::info('Direct Message', $item);
1290 $msg['uid'] = $item['uid'];
1292 $msg['contact-id'] = $item['contact-id'];
1294 $contact = Contact::getById($item['contact-id'], ['name', 'url', 'photo']);
1295 $msg['from-name'] = $contact['name'];
1296 $msg['from-url'] = $contact['url'];
1297 $msg['from-photo'] = $contact['photo'];
1299 $msg['uri'] = $item['uri'];
1300 $msg['created'] = $item['created'];
1302 $parent = DBA::selectFirst('mail', ['parent-uri', 'title'], ['uri' => $item['thr-parent']]);
1303 if (DBA::isResult($parent)) {
1304 $msg['parent-uri'] = $parent['parent-uri'];
1305 $msg['title'] = $parent['title'];
1307 $msg['parent-uri'] = $item['thr-parent'];
1309 if (!empty($item['title'])) {
1310 $msg['title'] = $item['title'];
1311 } elseif (!empty($item['content-warning'])) {
1312 $msg['title'] = $item['content-warning'];
1314 // Trying to generate a title out of the body
1315 $title = $item['body'];
1317 while (preg_match('#^(@\[url=([^\]]+)].*?\[\/url]\s)(.*)#is', $title, $matches)) {
1318 $title = $matches[3];
1321 $title = trim(BBCode::toPlaintext($title));
1323 if (strlen($title) > 20) {
1324 $title = substr($title, 0, 20) . '...';
1327 $msg['title'] = $title;
1330 $msg['body'] = $item['body'];
1332 return Mail::insert($msg);
1336 * Fetch featured posts from a contact with the given url
1338 * @param string $url
1341 public static function fetchFeaturedPosts(string $url)
1343 Logger::info('Fetch featured posts', ['contact' => $url]);
1345 $apcontact = APContact::getByURL($url);
1346 if (empty($apcontact['featured'])) {
1347 Logger::info('Contact does not have a featured collection', ['contact' => $url]);
1351 $pcid = Contact::getIdForURL($url, 0, false);
1353 Logger::notice('Contact not found', ['contact' => $url]);
1357 $posts = Post\Collection::selectToArrayForContact($pcid, Post\Collection::FEATURED);
1358 if (!empty($posts)) {
1359 $old_featured = array_column($posts, 'uri-id');
1364 $featured = ActivityPub::fetchItems($apcontact['featured']);
1365 if (empty($featured)) {
1366 Logger::info('Contact does not have featured posts', ['contact' => $url]);
1368 foreach ($old_featured as $uri_id) {
1369 Post\Collection::remove($uri_id, Post\Collection::FEATURED);
1370 Logger::debug('Removed no longer featured post', ['uri-id' => $uri_id, 'contact' => $url]);
1378 foreach ($featured as $post) {
1379 if (empty($post['id'])) {
1382 $id = Item::fetchByLink($post['id']);
1384 $item = Post::selectFirst(['uri-id', 'featured', 'author-id'], ['id' => $id]);
1385 if (!empty($item['uri-id'])) {
1386 if (!$item['featured']) {
1387 Post\Collection::add($item['uri-id'], Post\Collection::FEATURED, $item['author-id']);
1388 Logger::debug('Added featured post', ['uri-id' => $item['uri-id'], 'contact' => $url]);
1391 Logger::debug('Post already had been featured', ['uri-id' => $item['uri-id'], 'contact' => $url]);
1395 $index = array_search($item['uri-id'], $old_featured);
1396 if (!($index === false)) {
1397 unset($old_featured[$index]);
1403 foreach ($old_featured as $uri_id) {
1404 Post\Collection::remove($uri_id, Post\Collection::FEATURED);
1405 Logger::debug('Removed no longer featured post', ['uri-id' => $uri_id, 'contact' => $url]);
1408 Logger::info('Fetched featured posts', ['new' => $new, 'old' => $old, 'contact' => $url]);
1411 public static function fetchCachedActivity(string $url, int $uid): array
1413 $cachekey = self::CACHEKEY_FETCH_ACTIVITY . $uid . ':' . hash('sha256', $url);
1414 $object = DI::cache()->get($cachekey);
1416 if (!is_null($object)) {
1417 if (!empty($object)) {
1418 Logger::debug('Fetch from cache', ['url' => $url, 'uid' => $uid]);
1420 Logger::debug('Fetch from negative cache', ['url' => $url, 'uid' => $uid]);
1425 $object = ActivityPub::fetchContent($url, $uid);
1426 if (empty($object)) {
1427 Logger::notice('Activity was not fetchable, aborting.', ['url' => $url, 'uid' => $uid]);
1428 // We perform negative caching.
1429 DI::cache()->set($cachekey, [], Duration::FIVE_MINUTES);
1433 if (empty($object['id'])) {
1434 Logger::notice('Activity has got not id, aborting. ', ['url' => $url, 'object' => $object]);
1437 DI::cache()->set($cachekey, $object, Duration::FIVE_MINUTES);
1439 Logger::debug('Activity was fetched successfully', ['url' => $url, 'uid' => $uid]);
1445 * Fetches missing posts
1447 * @param string $url message URL
1448 * @param array $child activity array with the child of this message
1449 * @param string $relay_actor Relay actor
1450 * @param int $completion Completion mode, see Receiver::COMPLETION_*
1451 * @return string fetched message URL
1452 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1453 * @throws \ImagickException
1455 public static function fetchMissingActivity(string $url, array $child = [], string $relay_actor = '', int $completion = Receiver::COMPLETION_MANUAL): string
1457 $object = self::fetchCachedActivity($url, 0);
1458 if (empty($object)) {
1464 if (!empty($object['attributedTo'])) {
1465 $attributed_to = $object['attributedTo'];
1466 if (is_array($attributed_to)) {
1467 $compacted = JsonLD::compact($object);
1468 $attributed_to = JsonLD::fetchElement($compacted, 'as:attributedTo', '@id');
1470 $signer[] = $attributed_to;
1473 if (!empty($object['actor'])) {
1474 $object_actor = $object['actor'];
1475 } elseif (!empty($attributed_to)) {
1476 $object_actor = $attributed_to;
1482 $signer[] = $object_actor;
1484 if (!empty($child['author'])) {
1485 $actor = $child['author'];
1488 $actor = $object_actor;
1491 if (!empty($object['published'])) {
1492 $published = $object['published'];
1493 } elseif (!empty($child['published'])) {
1494 $published = $child['published'];
1496 $published = DateTimeFormat::utcNow();
1500 $activity['@context'] = $object['@context'] ?? ActivityPub::CONTEXT;
1501 unset($object['@context']);
1502 $activity['id'] = $object['id'];
1503 $activity['to'] = $object['to'] ?? [];
1504 $activity['cc'] = $object['cc'] ?? [];
1505 $activity['actor'] = $actor;
1506 $activity['object'] = $object;
1507 $activity['published'] = $published;
1508 $activity['type'] = 'Create';
1510 $ldactivity = JsonLD::compact($activity);
1512 $ldactivity['recursion-depth'] = !empty($child['recursion-depth']) ? $child['recursion-depth'] + 1 : 0;
1514 if (!empty($relay_actor)) {
1515 $ldactivity['thread-completion'] = $ldactivity['from-relay'] = Contact::getIdForURL($relay_actor);
1516 $ldactivity['completion-mode'] = Receiver::COMPLETION_RELAY;
1517 } elseif (!empty($child['thread-completion'])) {
1518 $ldactivity['thread-completion'] = $child['thread-completion'];
1519 $ldactivity['completion-mode'] = $child['completion-mode'] ?? Receiver::COMPLETION_NONE;
1521 $ldactivity['thread-completion'] = Contact::getIdForURL($actor);
1522 $ldactivity['completion-mode'] = $completion;
1525 if (!empty($child['thread-children-type'])) {
1526 $ldactivity['thread-children-type'] = $child['thread-children-type'];
1527 } elseif (!empty($child['type'])) {
1528 $ldactivity['thread-children-type'] = $child['type'];
1530 $ldactivity['thread-children-type'] = 'as:Create';
1533 if (!empty($relay_actor) && !self::acceptIncomingMessage($ldactivity, $object['id'])) {
1537 if (($completion == Receiver::COMPLETION_RELAY) && Queue::exists($url, 'as:Create')) {
1538 Logger::notice('Activity has already been queued.', ['url' => $url, 'object' => $activity['id']]);
1539 } elseif (ActivityPub\Receiver::processActivity($ldactivity, json_encode($activity), 0, true, false, $signer, '', $completion)) {
1540 Logger::notice('Activity had been fetched and processed.', ['url' => $url, 'entry' => $child['entry-id'] ?? 0, 'completion' => $completion, 'object' => $activity['id']]);
1542 Logger::notice('Activity had been fetched and will be processed later.', ['url' => $url, 'entry' => $child['entry-id'] ?? 0, 'completion' => $completion, 'object' => $activity['id']]);
1545 return $activity['id'];
1549 * Test if incoming relay messages should be accepted
1551 * @param array $activity activity array
1552 * @param string $id object ID
1553 * @return boolean true if message is accepted
1555 private static function acceptIncomingMessage(array $activity, string $id): bool
1557 if (empty($activity['as:object'])) {
1558 Logger::info('No object field in activity - accepted', ['id' => $id]);
1562 $replyto = JsonLD::fetchElement($activity['as:object'], 'as:inReplyTo', '@id');
1563 $uriid = ItemURI::getIdByURI($replyto ?? '');
1564 if (Post::exists(['uri-id' => $uriid])) {
1565 Logger::info('Post is a reply to an existing post - accepted', ['id' => $id, 'uri-id' => $uriid, 'replyto' => $replyto]);
1569 $attributed_to = JsonLD::fetchElement($activity['as:object'], 'as:attributedTo', '@id');
1570 $authorid = Contact::getIdForURL($attributed_to);
1572 $body = HTML::toBBCode(JsonLD::fetchElement($activity['as:object'], 'as:content', '@value') ?? '');
1575 $tags = Receiver::processTags(JsonLD::fetchElementArray($activity['as:object'], 'as:tag') ?? []);
1576 if (!empty($tags)) {
1577 foreach ($tags as $tag) {
1578 if ($tag['type'] != 'Hashtag') {
1581 $messageTags[] = ltrim(mb_strtolower($tag['name']), '#');
1585 return Relay::isSolicitedPost($messageTags, $body, $authorid, $id, Protocol::ACTIVITYPUB);
1589 * perform a "follow" request
1591 * @param array $activity
1593 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1594 * @throws \ImagickException
1596 public static function followUser(array $activity)
1598 $uid = User::getIdForURL($activity['object_id']);
1600 Queue::remove($activity);
1604 $owner = User::getOwnerDataById($uid);
1605 if (empty($owner)) {
1609 $cid = Contact::getIdForURL($activity['actor'], $uid);
1611 self::switchContact($cid);
1612 Contact::update(['hub-verify' => $activity['id'], 'protocol' => Protocol::ACTIVITYPUB], ['id' => $cid]);
1616 'author-id' => Contact::getIdForURL($activity['actor']),
1617 'author-link' => $activity['actor'],
1620 // Ensure that the contact has got the right network type
1621 self::switchContact($item['author-id']);
1623 $result = Contact::addRelationship($owner, [], $item, false, $activity['content'] ?? '');
1624 if ($result === true) {
1625 ActivityPub\Transmitter::sendContactAccept($item['author-link'], $activity['id'], $owner['uid']);
1628 $cid = Contact::getIdForURL($activity['actor'], $uid);
1633 if ($result && DI::config()->get('system', 'transmit_pending_events') && ($owner['contact-type'] == Contact::TYPE_COMMUNITY)) {
1634 self::transmitPendingEvents($cid, $owner['uid']);
1637 if (empty($contact)) {
1638 Contact::update(['hub-verify' => $activity['id'], 'protocol' => Protocol::ACTIVITYPUB], ['id' => $cid]);
1640 Logger::notice('Follow user ' . $uid . ' from contact ' . $cid . ' with id ' . $activity['id']);
1641 Queue::remove($activity);
1645 * Transmit pending events to the new follower
1647 * @param integer $cid Contact id
1648 * @param integer $uid User id
1651 private static function transmitPendingEvents(int $cid, int $uid)
1653 $account = DBA::selectFirst('account-user-view', ['ap-inbox', 'ap-sharedinbox'], ['id' => $cid]);
1654 $inbox = $account['ap-sharedinbox'] ?: $account['ap-inbox'];
1656 $events = DBA::select('event', ['id'], ["`uid` = ? AND `start` > ? AND `type` != ?", $uid, DateTimeFormat::utcNow(), 'birthday']);
1657 while ($event = DBA::fetch($events)) {
1658 $post = Post::selectFirst(['id', 'uri-id', 'created'], ['event-id' => $event['id']]);
1662 if (DI::config()->get('system', 'bulk_delivery')) {
1663 Post\Delivery::add($post['uri-id'], $uid, $inbox, $post['created'], Delivery::POST, [$cid]);
1664 Worker::add(PRIORITY_HIGH, 'APDelivery', '', 0, $inbox, 0);
1666 Worker::add(PRIORITY_HIGH, 'APDelivery', Delivery::POST, $post['id'], $inbox, $uid, [$cid], $post['uri-id']);
1672 * Update the given profile
1674 * @param array $activity
1675 * @throws \Exception
1677 public static function updatePerson(array $activity)
1679 if (empty($activity['object_id'])) {
1683 Logger::info('Updating profile', ['object' => $activity['object_id']]);
1684 Contact::updateFromProbeByURL($activity['object_id']);
1685 Queue::remove($activity);
1689 * Delete the given profile
1691 * @param array $activity
1693 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1695 public static function deletePerson(array $activity)
1697 if (empty($activity['object_id']) || empty($activity['actor'])) {
1698 Logger::info('Empty object id or actor.');
1702 if ($activity['object_id'] != $activity['actor']) {
1703 Logger::info('Object id does not match actor.');
1707 $contacts = DBA::select('contact', ['id'], ['nurl' => Strings::normaliseLink($activity['object_id'])]);
1708 while ($contact = DBA::fetch($contacts)) {
1709 Contact::remove($contact['id']);
1711 DBA::close($contacts);
1713 Logger::info('Deleted contact', ['object' => $activity['object_id']]);
1714 Queue::remove($activity);
1718 * Blocks the user by the contact
1720 * @param array $activity
1722 * @throws \Exception
1724 public static function blockAccount(array $activity)
1726 $cid = Contact::getIdForURL($activity['actor']);
1731 $uid = User::getIdForURL($activity['object_id']);
1736 Contact\User::setIsBlocked($cid, $uid, true);
1738 Logger::info('Contact blocked user', ['contact' => $cid, 'user' => $uid]);
1739 Queue::remove($activity);
1743 * Unblocks the user by the contact
1745 * @param array $activity
1747 * @throws \Exception
1749 public static function unblockAccount(array $activity)
1751 $cid = Contact::getIdForURL($activity['actor']);
1756 $uid = User::getIdForURL($activity['object_object']);
1761 Contact\User::setIsBlocked($cid, $uid, false);
1763 Logger::info('Contact unblocked user', ['contact' => $cid, 'user' => $uid]);
1764 Queue::remove($activity);
1768 * Accept a follow request
1770 * @param array $activity
1771 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1772 * @throws \ImagickException
1774 public static function acceptFollowUser(array $activity)
1776 $uid = User::getIdForURL($activity['object_actor']);
1781 $cid = Contact::getIdForURL($activity['actor'], $uid);
1783 Logger::info('No contact found', ['actor' => $activity['actor']]);
1787 self::switchContact($cid);
1789 $fields = ['pending' => false];
1791 $contact = DBA::selectFirst('contact', ['rel'], ['id' => $cid]);
1792 if ($contact['rel'] == Contact::FOLLOWER) {
1793 $fields['rel'] = Contact::FRIEND;
1796 $condition = ['id' => $cid];
1797 Contact::update($fields, $condition);
1798 Logger::info('Accept contact request', ['contact' => $cid, 'user' => $uid]);
1799 Queue::remove($activity);
1803 * Reject a follow request
1805 * @param array $activity
1806 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1807 * @throws \ImagickException
1809 public static function rejectFollowUser(array $activity)
1811 $uid = User::getIdForURL($activity['object_actor']);
1816 $cid = Contact::getIdForURL($activity['actor'], $uid);
1818 Logger::info('No contact found', ['actor' => $activity['actor']]);
1822 self::switchContact($cid);
1824 $contact = Contact::getById($cid, ['rel']);
1825 if ($contact['rel'] == Contact::SHARING) {
1826 Contact::remove($cid);
1827 Logger::info('Rejected contact request - contact removed', ['contact' => $cid, 'user' => $uid]);
1828 } elseif ($contact['rel'] == Contact::FRIEND) {
1829 Contact::update(['rel' => Contact::FOLLOWER], ['id' => $cid]);
1831 Logger::info('Rejected contact request', ['contact' => $cid, 'user' => $uid]);
1833 Queue::remove($activity);
1837 * Undo activity like "like" or "dislike"
1839 * @param array $activity
1840 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1841 * @throws \ImagickException
1843 public static function undoActivity(array $activity)
1845 if (empty($activity['object_id'])) {
1849 if (empty($activity['object_actor'])) {
1853 $author_id = Contact::getIdForURL($activity['object_actor']);
1854 if (empty($author_id)) {
1858 Item::markForDeletion(['uri' => $activity['object_id'], 'author-id' => $author_id, 'gravity' => GRAVITY_ACTIVITY]);
1859 Queue::remove($activity);
1863 * Activity to remove a follower
1865 * @param array $activity
1866 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1867 * @throws \ImagickException
1869 public static function undoFollowUser(array $activity)
1871 $uid = User::getIdForURL($activity['object_object']);
1876 $owner = User::getOwnerDataById($uid);
1877 if (empty($owner)) {
1881 $cid = Contact::getIdForURL($activity['actor'], $uid);
1883 Logger::info('No contact found', ['actor' => $activity['actor']]);
1887 self::switchContact($cid);
1889 $contact = DBA::selectFirst('contact', [], ['id' => $cid]);
1890 if (!DBA::isResult($contact)) {
1894 Contact::removeFollower($contact);
1895 Logger::info('Undo following request', ['contact' => $cid, 'user' => $uid]);
1896 Queue::remove($activity);
1900 * Switches a contact to AP if needed
1902 * @param integer $cid Contact ID
1904 * @throws \Exception
1906 private static function switchContact(int $cid)
1908 $contact = DBA::selectFirst('contact', ['network', 'url'], ['id' => $cid]);
1909 if (!DBA::isResult($contact) || in_array($contact['network'], [Protocol::ACTIVITYPUB, Protocol::DFRN]) || Contact::isLocal($contact['url'])) {
1913 Logger::info('Change existing contact', ['cid' => $cid, 'previous' => $contact['network']]);
1914 Contact::updateFromProbe($cid);
1918 * Collects implicit mentions like:
1919 * - the author of the parent item
1920 * - all the mentioned conversants in the parent item
1922 * @param array $parent Item array with at least ['id', 'author-link', 'alias']
1924 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1926 private static function getImplicitMentionList(array $parent): array
1928 $parent_terms = Tag::getByURIId($parent['uri-id'], [Tag::MENTION, Tag::IMPLICIT_MENTION, Tag::EXCLUSIVE_MENTION]);
1930 $parent_author = Contact::getByURL($parent['author-link'], false, ['url', 'nurl', 'alias']);
1932 $implicit_mentions = [];
1933 if (empty($parent_author['url'])) {
1934 Logger::notice('Author public contact unknown.', ['author-link' => $parent['author-link'], 'parent-id' => $parent['id']]);
1936 $implicit_mentions[] = $parent_author['url'];
1937 $implicit_mentions[] = $parent_author['nurl'];
1938 $implicit_mentions[] = $parent_author['alias'];
1941 if (!empty($parent['alias'])) {
1942 $implicit_mentions[] = $parent['alias'];
1945 foreach ($parent_terms as $term) {
1946 $contact = Contact::getByURL($term['url'], false, ['url', 'nurl', 'alias']);
1947 if (!empty($contact['url'])) {
1948 $implicit_mentions[] = $contact['url'];
1949 $implicit_mentions[] = $contact['nurl'];
1950 $implicit_mentions[] = $contact['alias'];
1954 return $implicit_mentions;
1958 * Strips from the body prepended implicit mentions
1960 * @param string $body
1961 * @param array $parent
1964 private static function removeImplicitMentionsFromBody(string $body, array $parent): string
1966 if (DI::config()->get('system', 'disable_implicit_mentions')) {
1970 $potential_mentions = self::getImplicitMentionList($parent);
1972 $kept_mentions = [];
1974 // Extract one prepended mention at a time from the body
1975 while(preg_match('#^(@\[url=([^\]]+)].*?\[\/url]\s)(.*)#is', $body, $matches)) {
1976 if (!in_array($matches[2], $potential_mentions)) {
1977 $kept_mentions[] = $matches[1];
1980 $body = $matches[3];
1983 // Re-appending the kept mentions to the body after extraction
1984 $kept_mentions[] = $body;
1986 return implode('', $kept_mentions);
1990 * Adds links to string mentions
1992 * @param string $body
1993 * @param array $tags
1996 protected static function addMentionLinks(string $body, array $tags): string
1998 // This prevents links to be added again to Pleroma-style mention links
1999 $body = self::normalizeMentionLinks($body);
2001 $body = BBCode::performWithEscapedTags($body, ['url'], function ($body) use ($tags) {
2002 foreach ($tags as $tag) {
2003 if (empty($tag['name']) || empty($tag['type']) || empty($tag['href']) || !in_array($tag['type'], ['Mention', 'Hashtag'])) {
2007 $hash = substr($tag['name'], 0, 1);
2008 $name = substr($tag['name'], 1);
2009 if (!in_array($hash, Tag::TAG_CHARACTER)) {
2011 $name = $tag['name'];
2014 if (Network::isValidHttpUrl($tag['href'])) {
2015 $body = str_replace($tag['name'], $hash . '[url=' . $tag['href'] . ']' . $name . '[/url]', $body);