|JSONResponse, array{}> * * 200: Share info returned * 403: Getting share info is not allowed * 404: Share not found */ #[PublicPage] #[NoCSRFRequired] #[BruteForceProtection(action: 'shareinfo')] public function info(string $t, ?string $password = null, ?string $dir = null, int $depth = -1): JSONResponse { try { $share = $this->shareManager->getShareByToken($t); } catch (ShareNotFound $e) { $response = new JSONResponse([], Http::STATUS_NOT_FOUND); $response->throttle(['token' => $t]); return $response; } if ($share->getPassword() && !$this->shareManager->checkPassword($share, $password)) { $response = new JSONResponse([], Http::STATUS_FORBIDDEN); $response->throttle(['token' => $t]); return $response; } if (!($share->getPermissions() & Constants::PERMISSION_READ)) { $response = new JSONResponse([], Http::STATUS_FORBIDDEN); $response->throttle(['token' => $t]); return $response; } $permissionMask = $share->getPermissions(); $node = $share->getNode(); if ($dir !== null && $node instanceof Folder) { try { $node = $node->get($dir); } catch (NotFoundException $e) { } } return new JSONResponse($this->parseNode($node, $permissionMask, $depth)); } /** * @return Files_SharingShareInfo */ private function parseNode(Node $node, int $permissionMask, int $depth): array { if ($node instanceof File) { return $this->parseFile($node, $permissionMask); } /** @var Folder $node */ return $this->parseFolder($node, $permissionMask, $depth); } /** * @return Files_SharingShareInfo */ private function parseFile(File $file, int $permissionMask): array { return $this->format($file, $permissionMask); } /** * @return Files_SharingShareInfo */ private function parseFolder(Folder $folder, int $permissionMask, int $depth): array { $data = $this->format($folder, $permissionMask); if ($depth === 0) { return $data; } $data['children'] = []; $nodes = $folder->getDirectoryListing(); foreach ($nodes as $node) { $data['children'][] = $this->parseNode($node, $permissionMask, $depth <= -1 ? -1 : $depth - 1); } return $data; } /** * @return Files_SharingShareInfo */ private function format(Node $node, int $permissionMask): array { $entry = []; $entry['id'] = $node->getId(); $entry['parentId'] = $node->getParent()->getId(); $entry['mtime'] = $node->getMTime(); $entry['name'] = $node->getName(); $entry['permissions'] = $node->getPermissions() & $permissionMask; $entry['mimetype'] = $node->getMimetype(); $entry['size'] = $node->getSize(); $entry['type'] = $node->getType(); $entry['etag'] = $node->getEtag(); return $entry; } }