. // }}} /** * Base class for feed controllers * * @package GNUsocial * @category Controller * * @author Hugo Sales * @copyright 2021 Free Software Foundation, Inc http://www.fsf.org * @license https://www.gnu.org/licenses/agpl.html GNU AGPL v3 or later */ namespace Component\Collection\Util\Controller; use App\Core\Event; use App\Entity\Actor; use App\Entity\Note; use App\Util\Common; use Functional as F; /** * @template T * * @extends OrderedCollection */ abstract class FeedController extends OrderedCollection { /** * Post-processing of the result of a feed controller, to remove any * notes or actors the user specified, as well as format the raw * list of notes into a usable format * * @template NA of Note|Actor * * @param NA[] $result * * @return NA[] */ protected function postProcess(array $result): array { $actor = Common::actor(); if (\array_key_exists('notes', $result)) { $notes = $result['notes']; self::enforceScope($notes, $actor, $result['actor'] ?? null); Event::handle('FilterNoteList', [$actor, &$notes, $result['request']]); Event::handle('FormatNoteList', [$notes, &$result['notes'], &$result['request']]); } return $result; } /** * @param Note[] $notes */ private static function enforceScope(array &$notes, ?Actor $actor, ?Actor $in = null): void { $notes = F\select($notes, fn (Note $n) => $n->isVisibleTo($actor, $in)); } }