* * @author Julius Härtl * * @license GNU AGPL version 3 or any later version * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU Affero General Public License as * published by the Free Software Foundation, either version 3 of the * License, or (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU Affero General Public License for more details. * * You should have received a copy of the GNU Affero General Public License * along with this program. If not, see . * */ namespace OCA\Text\Controller; use OCA\Text\Middleware\Attribute\RequireDocumentSession; use OCA\Text\Service\ApiService; use OCP\AppFramework\Http\Attribute\NoAdminRequired; use OCP\AppFramework\Http\Attribute\PublicPage; use OCP\AppFramework\Http\DataResponse; use OCP\AppFramework\PublicShareController; use OCP\IRequest; use OCP\ISession; use OCP\Share\Exceptions\ShareNotFound; use OCP\Share\IManager as ShareManager; use OCP\Share\IShare; class PublicSessionController extends PublicShareController implements ISessionAwareController { use TSessionAwareController; private ?IShare $share = null; public function __construct( string $appName, IRequest $request, ISession $session, private ShareManager $shareManager, private ApiService $apiService ) { parent::__construct($appName, $request, $session); } private function getShare(): IShare { if ($this->share === null) { throw new \Exception('Share has not been set yet'); } return $this->share; } protected function getPasswordHash(): string { return $this->getShare()->getPassword(); } public function isValidToken(): bool { try { $this->share = $this->shareManager->getShareByToken($this->getToken()); return true; } catch (ShareNotFound $e) { return false; } } protected function isPasswordProtected(): bool { /** @psalm-suppress RedundantConditionGivenDocblockType */ return $this->getShare()->getPassword() !== null; } #[NoAdminRequired] #[PublicPage] public function create(string $token, string $file = null, ?string $guestName = null): DataResponse { return $this->apiService->create(null, $file, $token, $guestName); } #[NoAdminRequired] #[PublicPage] public function close(int $documentId, int $sessionId, string $sessionToken): DataResponse { return $this->apiService->close($documentId, $sessionId, $sessionToken); } #[NoAdminRequired] #[PublicPage] #[RequireDocumentSession] public function push(int $documentId, int $sessionId, string $sessionToken, int $version, array $steps, string $awareness, string $token): DataResponse { return $this->apiService->push($this->getSession(), $this->getDocument(), $version, $steps, $awareness, $token); } #[NoAdminRequired] #[PublicPage] #[RequireDocumentSession] public function sync(string $token, int $version = 0): DataResponse { return $this->apiService->sync($this->getSession(), $this->getDocument(), $version, $token); } #[NoAdminRequired] #[PublicPage] #[RequireDocumentSession] public function save(string $token, int $version = 0, string $autosaveContent = null, string $documentState = null, bool $force = false, bool $manualSave = false): DataResponse { return $this->apiService->save($this->getSession(), $this->getDocument(), $version, $autosaveContent, $documentState, $force, $manualSave, $token); } /** * @psalm-return DataResponse> */ #[NoAdminRequired] #[PublicPage] #[RequireDocumentSession] public function updateSession(string $guestName): DataResponse { return $this->apiService->updateSession($this->getSession(), $guestName); } }