src/Module/Api/Mastodon/InstanceV2.php

   1 <?php
   2 /**
   3  * @copyright Copyright (C) 2010-2023, the Friendica project
   4  *
   5  * @license GNU AGPL version 3 or any later version
   6  *
   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.
  11  *
  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.
  16  *
  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/>.
  19  *
  20  */
  21
  22 namespace Friendica\Module\Api\Mastodon;
  23
  24 use Exception;
  25 use Friendica\App;
  26 use Friendica\Core\Config\Capability\IManageConfigValues;
  27 use Friendica\Core\L10n;
  28 use Friendica\Core\System;
  29 use Friendica\Database\Database;
  30 use Friendica\DI;
  31 use Friendica\Model\User;
  32 use Friendica\Module\Api\ApiResponse;
  33 use Friendica\Module\BaseApi;
  34 use Friendica\Module\Register;
  35 use Friendica\Object\Api\Mastodon\InstanceV2 as InstanceEntity;
  36 use Friendica\Util\Images;
  37 use Friendica\Util\Profiler;
  38 use Psr\Log\LoggerInterface;
  39
  40 /**
  41  * @see https://docs.joinmastodon.org/methods/instance/
  42  */
  43 class InstanceV2 extends BaseApi
  44 {
  45         /** @var Database */
  46         private $database;
  47
  48         /** @var IManageConfigValues */
  49         private $config;
  50
  51         public function __construct(
  52                 App $app,
  53                 L10n $l10n,
  54                 App\BaseURL $baseUrl,
  55                 App\Arguments $args,
  56                 LoggerInterface $logger,
  57                 Profiler $profiler,
  58                 ApiResponse $response,
  59                 Database $database,
  60                 IManageConfigValues $config,
  61                 array $server,
  62                 array $parameters = []
  63         ) {
  64                 parent::__construct($app, $l10n, $baseUrl, $args, $logger, $profiler, $response, $server, $parameters);
  65
  66                 $this->database = $database;
  67                 $this->config   = $config;
  68         }
  69
  70         /**
  71          * @param array $request
  72          * @throws \Friendica\Network\HTTPException\InternalServerErrorException
  73          * @throws \Friendica\Network\HTTPException\NotFoundException
  74          * @throws \ImagickException
  75          * @throws Exception
  76          */
  77         protected function rawContent(array $request = [])
  78         {
  79                 $domain               = $this->baseUrl->getHostname();
  80                 $title                = $this->config->get('config', 'sitename');
  81                 $version              = '2.8.0 (compatible; Friendica ' . App::VERSION . ')';
  82                 $description          = $this->config->get('config', 'info');
  83                 $usage                = $this->buildUsageInfo();
  84                 $thumbnail            = new InstanceEntity\Thumbnail($this->baseUrl->get() . 'images/friendica-banner.jpg');
  85                 $languages            = [$this->config->get('system', 'language')];
  86                 $configuration        = $this->buildConfigurationInfo();
  87                 $registration         = $this->buildRegistrationsInfo();
  88                 $contact              = $this->buildContactInfo();
  89                 $friendica_extensions = $this->buildFriendicaExtensionInfo();
  90                 $rules                = System::getRules();
  91                 System::jsonExit(new InstanceEntity(
  92                         $domain,
  93                         $title,
  94                         $version,
  95                         $description,
  96                         $usage,
  97                         $thumbnail,
  98                         $languages,
  99                         $configuration,
 100                         $registration,
 101                         $contact,
 102                         $friendica_extensions,
 103                         $rules
 104                 ));
 105         }
 106
 107         private function buildConfigurationInfo():InstanceEntity\Configuration
 108         {
 109                 $statuses_config = new InstanceEntity\StatusesConfig((int)$this->config->get(
 110                         'config',
 111                         'api_import_size',
 112                         $this->config->get('config', 'max_import_size')
 113                 ));
 114
 115                 return new InstanceEntity\Configuration(
 116                         $statuses_config,
 117                         new InstanceEntity\MediaAttachmentsConfig(Images::supportedTypes()),
 118                         $this->config->get('system', 'maximagesize')
 119                 );
 120         }
 121
 122         private function buildContactInfo():InstanceEntity\Contact
 123         {
 124                 $email         = implode(',', User::getAdminEmailList());
 125                 $administrator = User::getFirstAdmin();
 126                 $account       = null;
 127
 128                 if ($administrator) {
 129                         $adminContact = $this->database->selectFirst(
 130                                 'contact',
 131                                 ['uri-id'],
 132                                 ['nick' => $administrator['nickname'], 'self' => true]
 133                         );
 134                         $account = DI::mstdnAccount()->createFromUriId($adminContact['uri-id']);
 135                 }
 136
 137                 return new InstanceEntity\Contact($email, $account);
 138         }
 139
 140         private function buildFriendicaExtensionInfo():InstanceEntity\FriendicaExtensions
 141         {
 142                 return new InstanceEntity\FriendicaExtensions(
 143                         App::VERSION,
 144                         App::CODENAME,
 145                         $this->config->get('system', 'build')
 146                 );
 147         }
 148
 149         private function buildRegistrationsInfo():InstanceEntity\Registrations
 150         {
 151                 $register_policy   = intval($this->config->get('config', 'register_policy'));
 152                 $enabled           = ($register_policy != Register::CLOSED);
 153                 $approval_required = ($register_policy == Register::APPROVE);
 154
 155                 return new InstanceEntity\Registrations($enabled, $approval_required);
 156         }
 157
 158         private function buildUsageInfo():InstanceEntity\Usage
 159         {
 160                 if (!empty($this->config->get('system', 'nodeinfo'))) {
 161                         $active_monthly = intval(DI::keyValue()->get('nodeinfo_active_users_monthly'));
 162                 } else {
 163                         $active_monthly = 0;
 164                 }
 165
 166                 return new InstanceEntity\Usage(new InstanceEntity\UserStats($active_monthly));
 167         }
 168 }