nextcloud / server

apps/dav/lib/Connector/Sabre/FilesPlugin.php

Indentation +674 added lines, -674 removed lines

@@ -38,678 +38,678 @@
 use Sabre\HTTP\ResponseInterface;
 
 class FilesPlugin extends ServerPlugin {
-	// namespace
-	public const NS_OWNCLOUD = 'http://owncloud.org/ns';
-	public const NS_NEXTCLOUD = 'http://nextcloud.org/ns';
-	public const FILEID_PROPERTYNAME = '{http://owncloud.org/ns}id';
-	public const INTERNAL_FILEID_PROPERTYNAME = '{http://owncloud.org/ns}fileid';
-	public const PERMISSIONS_PROPERTYNAME = '{http://owncloud.org/ns}permissions';
-	public const SHARE_PERMISSIONS_PROPERTYNAME = '{http://open-collaboration-services.org/ns}share-permissions';
-	public const OCM_SHARE_PERMISSIONS_PROPERTYNAME = '{http://open-cloud-mesh.org/ns}share-permissions';
-	public const SHARE_ATTRIBUTES_PROPERTYNAME = '{http://nextcloud.org/ns}share-attributes';
-	public const DOWNLOADURL_PROPERTYNAME = '{http://owncloud.org/ns}downloadURL';
-	public const SIZE_PROPERTYNAME = '{http://owncloud.org/ns}size';
-	public const GETETAG_PROPERTYNAME = '{DAV:}getetag';
-	public const LASTMODIFIED_PROPERTYNAME = '{DAV:}lastmodified';
-	public const CREATIONDATE_PROPERTYNAME = '{DAV:}creationdate';
-	public const DISPLAYNAME_PROPERTYNAME = '{DAV:}displayname';
-	public const OWNER_ID_PROPERTYNAME = '{http://owncloud.org/ns}owner-id';
-	public const OWNER_DISPLAY_NAME_PROPERTYNAME = '{http://owncloud.org/ns}owner-display-name';
-	public const CHECKSUMS_PROPERTYNAME = '{http://owncloud.org/ns}checksums';
-	public const DATA_FINGERPRINT_PROPERTYNAME = '{http://owncloud.org/ns}data-fingerprint';
-	public const HAS_PREVIEW_PROPERTYNAME = '{http://nextcloud.org/ns}has-preview';
-	public const MOUNT_TYPE_PROPERTYNAME = '{http://nextcloud.org/ns}mount-type';
-	public const MOUNT_ROOT_PROPERTYNAME = '{http://nextcloud.org/ns}is-mount-root';
-	public const IS_FEDERATED_PROPERTYNAME = '{http://nextcloud.org/ns}is-federated';
-	public const METADATA_ETAG_PROPERTYNAME = '{http://nextcloud.org/ns}metadata_etag';
-	public const UPLOAD_TIME_PROPERTYNAME = '{http://nextcloud.org/ns}upload_time';
-	public const CREATION_TIME_PROPERTYNAME = '{http://nextcloud.org/ns}creation_time';
-	public const SHARE_NOTE = '{http://nextcloud.org/ns}note';
-	public const SHARE_HIDE_DOWNLOAD_PROPERTYNAME = '{http://nextcloud.org/ns}hide-download';
-	public const SUBFOLDER_COUNT_PROPERTYNAME = '{http://nextcloud.org/ns}contained-folder-count';
-	public const SUBFILE_COUNT_PROPERTYNAME = '{http://nextcloud.org/ns}contained-file-count';
-	public const FILE_METADATA_PREFIX = '{http://nextcloud.org/ns}metadata-';
-	public const HIDDEN_PROPERTYNAME = '{http://nextcloud.org/ns}hidden';
-
-	/** Reference to main server object */
-	private ?Server $server = null;
-
-	/**
-	 * @param Tree $tree
-	 * @param IConfig $config
-	 * @param IRequest $request
-	 * @param IPreview $previewManager
-	 * @param IUserSession $userSession
-	 * @param bool $isPublic Whether this is public WebDAV. If true, some returned information will be stripped off.
-	 * @param bool $downloadAttachment
-	 * @return void
-	 */
-	public function __construct(
-		private Tree $tree,
-		private IConfig $config,
-		private IRequest $request,
-		private IPreview $previewManager,
-		private IUserSession $userSession,
-		private IFilenameValidator $validator,
-		private bool $isPublic = false,
-		private bool $downloadAttachment = true,
-	) {
-	}
-
-	/**
-	 * This initializes the plugin.
-	 *
-	 * This function is called by \Sabre\DAV\Server, after
-	 * addPlugin is called.
-	 *
-	 * This method should set up the required event subscriptions.
-	 *
-	 * @return void
-	 */
-	public function initialize(Server $server) {
-		$server->xml->namespaceMap[self::NS_OWNCLOUD] = 'oc';
-		$server->xml->namespaceMap[self::NS_NEXTCLOUD] = 'nc';
-		$server->protectedProperties[] = self::FILEID_PROPERTYNAME;
-		$server->protectedProperties[] = self::INTERNAL_FILEID_PROPERTYNAME;
-		$server->protectedProperties[] = self::PERMISSIONS_PROPERTYNAME;
-		$server->protectedProperties[] = self::SHARE_PERMISSIONS_PROPERTYNAME;
-		$server->protectedProperties[] = self::OCM_SHARE_PERMISSIONS_PROPERTYNAME;
-		$server->protectedProperties[] = self::SHARE_ATTRIBUTES_PROPERTYNAME;
-		$server->protectedProperties[] = self::SIZE_PROPERTYNAME;
-		$server->protectedProperties[] = self::DOWNLOADURL_PROPERTYNAME;
-		$server->protectedProperties[] = self::OWNER_ID_PROPERTYNAME;
-		$server->protectedProperties[] = self::OWNER_DISPLAY_NAME_PROPERTYNAME;
-		$server->protectedProperties[] = self::CHECKSUMS_PROPERTYNAME;
-		$server->protectedProperties[] = self::DATA_FINGERPRINT_PROPERTYNAME;
-		$server->protectedProperties[] = self::HAS_PREVIEW_PROPERTYNAME;
-		$server->protectedProperties[] = self::MOUNT_TYPE_PROPERTYNAME;
-		$server->protectedProperties[] = self::IS_FEDERATED_PROPERTYNAME;
-		$server->protectedProperties[] = self::SHARE_NOTE;
-
-		// normally these cannot be changed (RFC4918), but we want them modifiable through PROPPATCH
-		$allowedProperties = ['{DAV:}getetag'];
-		$server->protectedProperties = array_diff($server->protectedProperties, $allowedProperties);
-
-		$this->server = $server;
-		$this->server->on('propFind', [$this, 'handleGetProperties']);
-		$this->server->on('propPatch', [$this, 'handleUpdateProperties']);
-		$this->server->on('afterBind', [$this, 'sendFileIdHeader']);
-		$this->server->on('afterWriteContent', [$this, 'sendFileIdHeader']);
-		$this->server->on('afterMethod:GET', [$this,'httpGet']);
-		$this->server->on('afterMethod:GET', [$this, 'handleDownloadToken']);
-		$this->server->on('afterResponse', function ($request, ResponseInterface $response): void {
-			$body = $response->getBody();
-			if (is_resource($body)) {
-				fclose($body);
-			}
-		});
-		$this->server->on('beforeMove', [$this, 'checkMove']);
-		$this->server->on('beforeCopy', [$this, 'checkCopy']);
-	}
-
-	/**
-	 * Plugin that checks if a copy can actually be performed.
-	 *
-	 * @param string $source source path
-	 * @param string $target target path
-	 * @throws NotFound If the source does not exist
-	 * @throws InvalidPath If the target is invalid
-	 */
-	public function checkCopy($source, $target): void {
-		$sourceNode = $this->tree->getNodeForPath($source);
-		if (!$sourceNode instanceof Node) {
-			return;
-		}
-
-		// Ensure source exists
-		$sourceNodeFileInfo = $sourceNode->getFileInfo();
-		if ($sourceNodeFileInfo === null) {
-			throw new NotFound($source . ' does not exist');
-		}
-		// Ensure the target name is valid
-		try {
-			[$targetPath, $targetName] = \Sabre\Uri\split($target);
-			$this->validator->validateFilename($targetName);
-		} catch (InvalidPathException $e) {
-			throw new InvalidPath($e->getMessage(), false);
-		}
-		// Ensure the target path is valid
-		$segments = array_slice(explode('/', $targetPath), 2);
-		foreach ($segments as $segment) {
-			if ($this->validator->isFilenameValid($segment) === false) {
-				$l = \OCP\Server::get(IFactory::class)->get('dav');
-				throw new InvalidPath($l->t('Invalid target path'));
-			}
-		}
-	}
-
-	/**
-	 * Plugin that checks if a move can actually be performed.
-	 *
-	 * @param string $source source path
-	 * @param string $target target path
-	 * @throws Forbidden If the source is not deletable
-	 * @throws NotFound If the source does not exist
-	 * @throws InvalidPath If the target name is invalid
-	 */
-	public function checkMove(string $source, string $target): void {
-		$sourceNode = $this->tree->getNodeForPath($source);
-		if (!$sourceNode instanceof Node) {
-			return;
-		}
-
-		// First check copyable (move only needs additional delete permission)
-		$this->checkCopy($source, $target);
-
-		// The source needs to be deletable for moving
-		$sourceNodeFileInfo = $sourceNode->getFileInfo();
-		if (!$sourceNodeFileInfo->isDeletable()) {
-			throw new Forbidden($source . ' cannot be deleted');
-		}
-
-		// The source is not allowed to be the parent of the target
-		if (str_starts_with($source, $target . '/')) {
-			throw new Forbidden($source . ' cannot be moved to it\'s parent');
-		}
-	}
-
-	/**
-	 * This sets a cookie to be able to recognize the start of the download
-	 * the content must not be longer than 32 characters and must only contain
-	 * alphanumeric characters
-	 *
-	 * @param RequestInterface $request
-	 * @param ResponseInterface $response
-	 */
-	public function handleDownloadToken(RequestInterface $request, ResponseInterface $response) {
-		$queryParams = $request->getQueryParameters();
-
-		/**
-		 * this sets a cookie to be able to recognize the start of the download
-		 * the content must not be longer than 32 characters and must only contain
-		 * alphanumeric characters
-		 */
-		if (isset($queryParams['downloadStartSecret'])) {
-			$token = $queryParams['downloadStartSecret'];
-			if (!isset($token[32])
-				&& preg_match('!^[a-zA-Z0-9]+$!', $token) === 1) {
-				// FIXME: use $response->setHeader() instead
-				setcookie('ocDownloadStarted', $token, time() + 20, '/');
-			}
-		}
-	}
-
-	/**
-	 * Add headers to file download
-	 *
-	 * @param RequestInterface $request
-	 * @param ResponseInterface $response
-	 */
-	public function httpGet(RequestInterface $request, ResponseInterface $response) {
-		// Only handle valid files
-		$node = $this->tree->getNodeForPath($request->getPath());
-		if (!($node instanceof IFile)) {
-			return;
-		}
-
-		// adds a 'Content-Disposition: attachment' header in case no disposition
-		// header has been set before
-		if ($this->downloadAttachment &&
-			$response->getHeader('Content-Disposition') === null) {
-			$filename = $node->getName();
-			if ($this->request->isUserAgent(
-				[
-					Request::USER_AGENT_IE,
-					Request::USER_AGENT_ANDROID_MOBILE_CHROME,
-					Request::USER_AGENT_FREEBOX,
-				])) {
-				$response->addHeader('Content-Disposition', 'attachment; filename="' . rawurlencode($filename) . '"');
-			} else {
-				$response->addHeader('Content-Disposition', 'attachment; filename*=UTF-8\'\'' . rawurlencode($filename)
-													 . '; filename="' . rawurlencode($filename) . '"');
-			}
-		}
-
-		if ($node instanceof File) {
-			//Add OC-Checksum header
-			$checksum = $node->getChecksum();
-			if ($checksum !== null && $checksum !== '') {
-				$response->addHeader('OC-Checksum', $checksum);
-			}
-		}
-		$response->addHeader('X-Accel-Buffering', 'no');
-	}
-
-	/**
-	 * Adds all ownCloud-specific properties
-	 *
-	 * @param PropFind $propFind
-	 * @param \Sabre\DAV\INode $node
-	 * @return void
-	 */
-	public function handleGetProperties(PropFind $propFind, \Sabre\DAV\INode $node) {
-		$httpRequest = $this->server->httpRequest;
-
-		if ($node instanceof Node) {
-			/**
-			 * This was disabled, because it made dir listing throw an exception,
-			 * so users were unable to navigate into folders where one subitem
-			 * is blocked by the files_accesscontrol app, see:
-			 * https://github.com/nextcloud/files_accesscontrol/issues/65
-			 * if (!$node->getFileInfo()->isReadable()) {
-			 *     // avoid detecting files through this means
-			 *     throw new NotFound();
-			 * }
-			 */
-
-			$propFind->handle(self::FILEID_PROPERTYNAME, function () use ($node) {
-				return $node->getFileId();
-			});
-
-			$propFind->handle(self::INTERNAL_FILEID_PROPERTYNAME, function () use ($node) {
-				return $node->getInternalFileId();
-			});
-
-			$propFind->handle(self::PERMISSIONS_PROPERTYNAME, function () use ($node) {
-				$perms = $node->getDavPermissions();
-				if ($this->isPublic) {
-					// remove mount information
-					$perms = str_replace(['S', 'M'], '', $perms);
-				}
-				return $perms;
-			});
-
-			$propFind->handle(self::SHARE_PERMISSIONS_PROPERTYNAME, function () use ($node, $httpRequest) {
-				$user = $this->userSession->getUser();
-				if ($user === null) {
-					return null;
-				}
-				return $node->getSharePermissions(
-					$user->getUID()
-				);
-			});
-
-			$propFind->handle(self::OCM_SHARE_PERMISSIONS_PROPERTYNAME, function () use ($node, $httpRequest): ?string {
-				$user = $this->userSession->getUser();
-				if ($user === null) {
-					return null;
-				}
-				$ncPermissions = $node->getSharePermissions(
-					$user->getUID()
-				);
-				$ocmPermissions = $this->ncPermissions2ocmPermissions($ncPermissions);
-				return json_encode($ocmPermissions, JSON_THROW_ON_ERROR);
-			});
-
-			$propFind->handle(self::SHARE_ATTRIBUTES_PROPERTYNAME, function () use ($node, $httpRequest) {
-				return json_encode($node->getShareAttributes(), JSON_THROW_ON_ERROR);
-			});
-
-			$propFind->handle(self::GETETAG_PROPERTYNAME, function () use ($node): string {
-				return $node->getETag();
-			});
-
-			$propFind->handle(self::OWNER_ID_PROPERTYNAME, function () use ($node): ?string {
-				$owner = $node->getOwner();
-				if (!$owner) {
-					return null;
-				} else {
-					return $owner->getUID();
-				}
-			});
-			$propFind->handle(self::OWNER_DISPLAY_NAME_PROPERTYNAME, function () use ($node): ?string {
-				$owner = $node->getOwner();
-				if (!$owner) {
-					return null;
-				} else {
-					return $owner->getDisplayName();
-				}
-			});
-
-			$propFind->handle(self::HAS_PREVIEW_PROPERTYNAME, function () use ($node) {
-				return json_encode($this->previewManager->isAvailable($node->getFileInfo()), JSON_THROW_ON_ERROR);
-			});
-			$propFind->handle(self::SIZE_PROPERTYNAME, function () use ($node): int|float {
-				return $node->getSize();
-			});
-			$propFind->handle(self::MOUNT_TYPE_PROPERTYNAME, function () use ($node) {
-				return $node->getFileInfo()->getMountPoint()->getMountType();
-			});
-
-			/**
-			 * This is a special property which is used to determine if a node
-			 * is a mount root or not, e.g. a shared folder.
-			 * If so, then the node can only be unshared and not deleted.
-			 * @see https://github.com/nextcloud/server/blob/cc75294eb6b16b916a342e69998935f89222619d/lib/private/Files/View.php#L696-L698
-			 */
-			$propFind->handle(self::MOUNT_ROOT_PROPERTYNAME, function () use ($node) {
-				return $node->getNode()->getInternalPath() === '' ? 'true' : 'false';
-			});
-
-			$propFind->handle(self::SHARE_NOTE, function () use ($node): ?string {
-				$user = $this->userSession->getUser();
-				return $node->getNoteFromShare(
-					$user?->getUID()
-				);
-			});
-
-			$propFind->handle(self::SHARE_HIDE_DOWNLOAD_PROPERTYNAME, function () use ($node) {
-				$storage = $node->getNode()->getStorage();
-				if ($storage->instanceOfStorage(ISharedStorage::class)) {
-					/** @var ISharedStorage $storage */
-					return match($storage->getShare()->getHideDownload()) {
-						true => 'true',
-						false => 'false',
-					};
-				} else {
-					return null;
-				}
-			});
-
-			$propFind->handle(self::DATA_FINGERPRINT_PROPERTYNAME, function () {
-				return $this->config->getSystemValue('data-fingerprint', '');
-			});
-			$propFind->handle(self::CREATIONDATE_PROPERTYNAME, function () use ($node) {
-				return (new \DateTimeImmutable())
-					->setTimestamp($node->getFileInfo()->getCreationTime())
-					->format(\DateTimeInterface::ATOM);
-			});
-			$propFind->handle(self::CREATION_TIME_PROPERTYNAME, function () use ($node) {
-				return $node->getFileInfo()->getCreationTime();
-			});
-
-			foreach ($node->getFileInfo()->getMetadata() as $metadataKey => $metadataValue) {
-				$propFind->handle(self::FILE_METADATA_PREFIX . $metadataKey, $metadataValue);
-			}
-
-			$propFind->handle(self::HIDDEN_PROPERTYNAME, function () use ($node) {
-				$isLivePhoto = isset($node->getFileInfo()->getMetadata()['files-live-photo']);
-				$isMovFile = $node->getFileInfo()->getMimetype() === 'video/quicktime';
-				return ($isLivePhoto && $isMovFile) ? 'true' : 'false';
-			});
-
-			/**
-			 * Return file/folder name as displayname. The primary reason to
-			 * implement it this way is to avoid costly fallback to
-			 * CustomPropertiesBackend (esp. visible when querying all files
-			 * in a folder).
-			 */
-			$propFind->handle(self::DISPLAYNAME_PROPERTYNAME, function () use ($node) {
-				return $node->getName();
-			});
-
-			$propFind->handle(self::IS_FEDERATED_PROPERTYNAME, function () use ($node) {
-				return $node->getFileInfo()->getMountPoint()
-					instanceof SharingExternalMount;
-			});
-		}
-
-		if ($node instanceof File) {
-			$propFind->handle(self::DOWNLOADURL_PROPERTYNAME, function () use ($node) {
-				try {
-					$directDownloadUrl = $node->getDirectDownload();
-					if (isset($directDownloadUrl['url'])) {
-						return $directDownloadUrl['url'];
-					}
-				} catch (StorageNotAvailableException $e) {
-					return false;
-				} catch (ForbiddenException $e) {
-					return false;
-				}
-				return false;
-			});
-
-			$propFind->handle(self::CHECKSUMS_PROPERTYNAME, function () use ($node) {
-				$checksum = $node->getChecksum();
-				if ($checksum === null || $checksum === '') {
-					return null;
-				}
-
-				return new ChecksumList($checksum);
-			});
-
-			$propFind->handle(self::UPLOAD_TIME_PROPERTYNAME, function () use ($node) {
-				return $node->getFileInfo()->getUploadTime();
-			});
-		}
-
-		if ($node instanceof Directory) {
-			$propFind->handle(self::SIZE_PROPERTYNAME, function () use ($node) {
-				return $node->getSize();
-			});
-
-			$requestProperties = $propFind->getRequestedProperties();
-
-			if (in_array(self::SUBFILE_COUNT_PROPERTYNAME, $requestProperties, true)
-				|| in_array(self::SUBFOLDER_COUNT_PROPERTYNAME, $requestProperties, true)) {
-				$nbFiles = 0;
-				$nbFolders = 0;
-				foreach ($node->getChildren() as $child) {
-					if ($child instanceof File) {
-						$nbFiles++;
-					} elseif ($child instanceof Directory) {
-						$nbFolders++;
-					}
-				}
-
-				$propFind->handle(self::SUBFILE_COUNT_PROPERTYNAME, $nbFiles);
-				$propFind->handle(self::SUBFOLDER_COUNT_PROPERTYNAME, $nbFolders);
-			}
-		}
-	}
-
-	/**
-	 * translate Nextcloud permissions to OCM Permissions
-	 *
-	 * @param $ncPermissions
-	 * @return array
-	 */
-	protected function ncPermissions2ocmPermissions($ncPermissions) {
-		$ocmPermissions = [];
-
-		if ($ncPermissions & Constants::PERMISSION_SHARE) {
-			$ocmPermissions[] = 'share';
-		}
-
-		if ($ncPermissions & Constants::PERMISSION_READ) {
-			$ocmPermissions[] = 'read';
-		}
-
-		if (($ncPermissions & Constants::PERMISSION_CREATE) ||
-			($ncPermissions & Constants::PERMISSION_UPDATE)) {
-			$ocmPermissions[] = 'write';
-		}
-
-		return $ocmPermissions;
-	}
-
-	/**
-	 * Update ownCloud-specific properties
-	 *
-	 * @param string $path
-	 * @param PropPatch $propPatch
-	 *
-	 * @return void
-	 */
-	public function handleUpdateProperties($path, PropPatch $propPatch) {
-		$node = $this->tree->getNodeForPath($path);
-		if (!($node instanceof Node)) {
-			return;
-		}
-
-		$propPatch->handle(self::LASTMODIFIED_PROPERTYNAME, function ($time) use ($node) {
-			if (empty($time)) {
-				return false;
-			}
-			$node->touch($time);
-			return true;
-		});
-		$propPatch->handle(self::GETETAG_PROPERTYNAME, function ($etag) use ($node) {
-			if (empty($etag)) {
-				return false;
-			}
-			return $node->setEtag($etag) !== -1;
-		});
-		$propPatch->handle(self::CREATIONDATE_PROPERTYNAME, function ($time) use ($node) {
-			if (empty($time)) {
-				return false;
-			}
-			$dateTime = new \DateTimeImmutable($time);
-			$node->setCreationTime($dateTime->getTimestamp());
-			return true;
-		});
-		$propPatch->handle(self::CREATION_TIME_PROPERTYNAME, function ($time) use ($node) {
-			if (empty($time)) {
-				return false;
-			}
-			$node->setCreationTime((int)$time);
-			return true;
-		});
-
-		$this->handleUpdatePropertiesMetadata($propPatch, $node);
-
-		/**
-		 * Disable modification of the displayname property for files and
-		 * folders via PROPPATCH. See PROPFIND for more information.
-		 */
-		$propPatch->handle(self::DISPLAYNAME_PROPERTYNAME, function ($displayName) {
-			return 403;
-		});
-	}
-
-
-	/**
-	 * handle the update of metadata from PROPPATCH requests
-	 *
-	 * @param PropPatch $propPatch
-	 * @param Node $node
-	 *
-	 * @throws FilesMetadataException
-	 */
-	private function handleUpdatePropertiesMetadata(PropPatch $propPatch, Node $node): void {
-		$userId = $this->userSession->getUser()?->getUID();
-		if ($userId === null) {
-			return;
-		}
-
-		$accessRight = $this->getMetadataFileAccessRight($node, $userId);
-		$filesMetadataManager = $this->initFilesMetadataManager();
-		$knownMetadata = $filesMetadataManager->getKnownMetadata();
-
-		foreach ($propPatch->getRemainingMutations() as $mutation) {
-			if (!str_starts_with($mutation, self::FILE_METADATA_PREFIX)) {
-				continue;
-			}
-
-			$propPatch->handle(
-				$mutation,
-				function (mixed $value) use ($accessRight, $knownMetadata, $node, $mutation, $filesMetadataManager): bool {
-					/** @var FilesMetadata $metadata */
-					$metadata = $filesMetadataManager->getMetadata((int)$node->getFileId(), true);
-					$metadata->setStorageId($node->getNode()->getStorage()->getCache()->getNumericStorageId());
-					$metadataKey = substr($mutation, strlen(self::FILE_METADATA_PREFIX));
-
-					// confirm metadata key is editable via PROPPATCH
-					if ($knownMetadata->getEditPermission($metadataKey) < $accessRight) {
-						throw new FilesMetadataException('you do not have enough rights to update \'' . $metadataKey . '\' on this node');
-					}
-
-					if ($value === null) {
-						$metadata->unset($metadataKey);
-						$filesMetadataManager->saveMetadata($metadata);
-						return true;
-					}
-
-					// If the metadata is unknown, it defaults to string.
-					try {
-						$type = $knownMetadata->getType($metadataKey);
-					} catch (FilesMetadataNotFoundException) {
-						$type = IMetadataValueWrapper::TYPE_STRING;
-					}
-
-					switch ($type) {
-						case IMetadataValueWrapper::TYPE_STRING:
-							$metadata->setString($metadataKey, $value, $knownMetadata->isIndex($metadataKey));
-							break;
-						case IMetadataValueWrapper::TYPE_INT:
-							$metadata->setInt($metadataKey, $value, $knownMetadata->isIndex($metadataKey));
-							break;
-						case IMetadataValueWrapper::TYPE_FLOAT:
-							$metadata->setFloat($metadataKey, $value);
-							break;
-						case IMetadataValueWrapper::TYPE_BOOL:
-							$metadata->setBool($metadataKey, $value, $knownMetadata->isIndex($metadataKey));
-							break;
-						case IMetadataValueWrapper::TYPE_ARRAY:
-							$metadata->setArray($metadataKey, $value);
-							break;
-						case IMetadataValueWrapper::TYPE_STRING_LIST:
-							$metadata->setStringList($metadataKey, $value, $knownMetadata->isIndex($metadataKey));
-							break;
-						case IMetadataValueWrapper::TYPE_INT_LIST:
-							$metadata->setIntList($metadataKey, $value, $knownMetadata->isIndex($metadataKey));
-							break;
-					}
-
-					$filesMetadataManager->saveMetadata($metadata);
-
-					return true;
-				}
-			);
-		}
-	}
-
-	/**
-	 * init default internal metadata
-	 *
-	 * @return IFilesMetadataManager
-	 */
-	private function initFilesMetadataManager(): IFilesMetadataManager {
-		/** @var IFilesMetadataManager $manager */
-		$manager = \OCP\Server::get(IFilesMetadataManager::class);
-		$manager->initMetadata('files-live-photo', IMetadataValueWrapper::TYPE_STRING, false, IMetadataValueWrapper::EDIT_REQ_OWNERSHIP);
-
-		return $manager;
-	}
-
-	/**
-	 * based on owner and shares, returns the bottom limit to update related metadata
-	 *
-	 * @param Node $node
-	 * @param string $userId
-	 *
-	 * @return int
-	 */
-	private function getMetadataFileAccessRight(Node $node, string $userId): int {
-		if ($node->getOwner()?->getUID() === $userId) {
-			return IMetadataValueWrapper::EDIT_REQ_OWNERSHIP;
-		} else {
-			$filePermissions = $node->getSharePermissions($userId);
-			if ($filePermissions & Constants::PERMISSION_UPDATE) {
-				return IMetadataValueWrapper::EDIT_REQ_WRITE_PERMISSION;
-			}
-		}
-
-		return IMetadataValueWrapper::EDIT_REQ_READ_PERMISSION;
-	}
-
-	/**
-	 * @param string $filePath
-	 * @param ?\Sabre\DAV\INode $node
-	 * @return void
-	 * @throws \Sabre\DAV\Exception\BadRequest
-	 */
-	public function sendFileIdHeader($filePath, ?\Sabre\DAV\INode $node = null) {
-		// we get the node for the given $filePath here because in case of afterCreateFile $node is the parent folder
-		if (!$this->server->tree->nodeExists($filePath)) {
-			return;
-		}
-		$node = $this->server->tree->getNodeForPath($filePath);
-		if ($node instanceof Node) {
-			$fileId = $node->getFileId();
-			if (!is_null($fileId)) {
-				$this->server->httpResponse->setHeader('OC-FileId', $fileId);
-			}
-		}
-	}
+    // namespace
+    public const NS_OWNCLOUD = 'http://owncloud.org/ns';
+    public const NS_NEXTCLOUD = 'http://nextcloud.org/ns';
+    public const FILEID_PROPERTYNAME = '{http://owncloud.org/ns}id';
+    public const INTERNAL_FILEID_PROPERTYNAME = '{http://owncloud.org/ns}fileid';
+    public const PERMISSIONS_PROPERTYNAME = '{http://owncloud.org/ns}permissions';
+    public const SHARE_PERMISSIONS_PROPERTYNAME = '{http://open-collaboration-services.org/ns}share-permissions';
+    public const OCM_SHARE_PERMISSIONS_PROPERTYNAME = '{http://open-cloud-mesh.org/ns}share-permissions';
+    public const SHARE_ATTRIBUTES_PROPERTYNAME = '{http://nextcloud.org/ns}share-attributes';
+    public const DOWNLOADURL_PROPERTYNAME = '{http://owncloud.org/ns}downloadURL';
+    public const SIZE_PROPERTYNAME = '{http://owncloud.org/ns}size';
+    public const GETETAG_PROPERTYNAME = '{DAV:}getetag';
+    public const LASTMODIFIED_PROPERTYNAME = '{DAV:}lastmodified';
+    public const CREATIONDATE_PROPERTYNAME = '{DAV:}creationdate';
+    public const DISPLAYNAME_PROPERTYNAME = '{DAV:}displayname';
+    public const OWNER_ID_PROPERTYNAME = '{http://owncloud.org/ns}owner-id';
+    public const OWNER_DISPLAY_NAME_PROPERTYNAME = '{http://owncloud.org/ns}owner-display-name';
+    public const CHECKSUMS_PROPERTYNAME = '{http://owncloud.org/ns}checksums';
+    public const DATA_FINGERPRINT_PROPERTYNAME = '{http://owncloud.org/ns}data-fingerprint';
+    public const HAS_PREVIEW_PROPERTYNAME = '{http://nextcloud.org/ns}has-preview';
+    public const MOUNT_TYPE_PROPERTYNAME = '{http://nextcloud.org/ns}mount-type';
+    public const MOUNT_ROOT_PROPERTYNAME = '{http://nextcloud.org/ns}is-mount-root';
+    public const IS_FEDERATED_PROPERTYNAME = '{http://nextcloud.org/ns}is-federated';
+    public const METADATA_ETAG_PROPERTYNAME = '{http://nextcloud.org/ns}metadata_etag';
+    public const UPLOAD_TIME_PROPERTYNAME = '{http://nextcloud.org/ns}upload_time';
+    public const CREATION_TIME_PROPERTYNAME = '{http://nextcloud.org/ns}creation_time';
+    public const SHARE_NOTE = '{http://nextcloud.org/ns}note';
+    public const SHARE_HIDE_DOWNLOAD_PROPERTYNAME = '{http://nextcloud.org/ns}hide-download';
+    public const SUBFOLDER_COUNT_PROPERTYNAME = '{http://nextcloud.org/ns}contained-folder-count';
+    public const SUBFILE_COUNT_PROPERTYNAME = '{http://nextcloud.org/ns}contained-file-count';
+    public const FILE_METADATA_PREFIX = '{http://nextcloud.org/ns}metadata-';
+    public const HIDDEN_PROPERTYNAME = '{http://nextcloud.org/ns}hidden';
+
+    /** Reference to main server object */
+    private ?Server $server = null;
+
+    /**
+     * @param Tree $tree
+     * @param IConfig $config
+     * @param IRequest $request
+     * @param IPreview $previewManager
+     * @param IUserSession $userSession
+     * @param bool $isPublic Whether this is public WebDAV. If true, some returned information will be stripped off.
+     * @param bool $downloadAttachment
+     * @return void
+     */
+    public function __construct(
+        private Tree $tree,
+        private IConfig $config,
+        private IRequest $request,
+        private IPreview $previewManager,
+        private IUserSession $userSession,
+        private IFilenameValidator $validator,
+        private bool $isPublic = false,
+        private bool $downloadAttachment = true,
+    ) {
+    }
+
+    /**
+     * This initializes the plugin.
+     *
+     * This function is called by \Sabre\DAV\Server, after
+     * addPlugin is called.
+     *
+     * This method should set up the required event subscriptions.
+     *
+     * @return void
+     */
+    public function initialize(Server $server) {
+        $server->xml->namespaceMap[self::NS_OWNCLOUD] = 'oc';
+        $server->xml->namespaceMap[self::NS_NEXTCLOUD] = 'nc';
+        $server->protectedProperties[] = self::FILEID_PROPERTYNAME;
+        $server->protectedProperties[] = self::INTERNAL_FILEID_PROPERTYNAME;
+        $server->protectedProperties[] = self::PERMISSIONS_PROPERTYNAME;
+        $server->protectedProperties[] = self::SHARE_PERMISSIONS_PROPERTYNAME;
+        $server->protectedProperties[] = self::OCM_SHARE_PERMISSIONS_PROPERTYNAME;
+        $server->protectedProperties[] = self::SHARE_ATTRIBUTES_PROPERTYNAME;
+        $server->protectedProperties[] = self::SIZE_PROPERTYNAME;
+        $server->protectedProperties[] = self::DOWNLOADURL_PROPERTYNAME;
+        $server->protectedProperties[] = self::OWNER_ID_PROPERTYNAME;
+        $server->protectedProperties[] = self::OWNER_DISPLAY_NAME_PROPERTYNAME;
+        $server->protectedProperties[] = self::CHECKSUMS_PROPERTYNAME;
+        $server->protectedProperties[] = self::DATA_FINGERPRINT_PROPERTYNAME;
+        $server->protectedProperties[] = self::HAS_PREVIEW_PROPERTYNAME;
+        $server->protectedProperties[] = self::MOUNT_TYPE_PROPERTYNAME;
+        $server->protectedProperties[] = self::IS_FEDERATED_PROPERTYNAME;
+        $server->protectedProperties[] = self::SHARE_NOTE;
+
+        // normally these cannot be changed (RFC4918), but we want them modifiable through PROPPATCH
+        $allowedProperties = ['{DAV:}getetag'];
+        $server->protectedProperties = array_diff($server->protectedProperties, $allowedProperties);
+
+        $this->server = $server;
+        $this->server->on('propFind', [$this, 'handleGetProperties']);
+        $this->server->on('propPatch', [$this, 'handleUpdateProperties']);
+        $this->server->on('afterBind', [$this, 'sendFileIdHeader']);
+        $this->server->on('afterWriteContent', [$this, 'sendFileIdHeader']);
+        $this->server->on('afterMethod:GET', [$this,'httpGet']);
+        $this->server->on('afterMethod:GET', [$this, 'handleDownloadToken']);
+        $this->server->on('afterResponse', function ($request, ResponseInterface $response): void {
+            $body = $response->getBody();
+            if (is_resource($body)) {
+                fclose($body);
+            }
+        });
+        $this->server->on('beforeMove', [$this, 'checkMove']);
+        $this->server->on('beforeCopy', [$this, 'checkCopy']);
+    }
+
+    /**
+     * Plugin that checks if a copy can actually be performed.
+     *
+     * @param string $source source path
+     * @param string $target target path
+     * @throws NotFound If the source does not exist
+     * @throws InvalidPath If the target is invalid
+     */
+    public function checkCopy($source, $target): void {
+        $sourceNode = $this->tree->getNodeForPath($source);
+        if (!$sourceNode instanceof Node) {
+            return;
+        }
+
+        // Ensure source exists
+        $sourceNodeFileInfo = $sourceNode->getFileInfo();
+        if ($sourceNodeFileInfo === null) {
+            throw new NotFound($source . ' does not exist');
+        }
+        // Ensure the target name is valid
+        try {
+            [$targetPath, $targetName] = \Sabre\Uri\split($target);
+            $this->validator->validateFilename($targetName);
+        } catch (InvalidPathException $e) {
+            throw new InvalidPath($e->getMessage(), false);
+        }
+        // Ensure the target path is valid
+        $segments = array_slice(explode('/', $targetPath), 2);
+        foreach ($segments as $segment) {
+            if ($this->validator->isFilenameValid($segment) === false) {
+                $l = \OCP\Server::get(IFactory::class)->get('dav');
+                throw new InvalidPath($l->t('Invalid target path'));
+            }
+        }
+    }
+
+    /**
+     * Plugin that checks if a move can actually be performed.
+     *
+     * @param string $source source path
+     * @param string $target target path
+     * @throws Forbidden If the source is not deletable
+     * @throws NotFound If the source does not exist
+     * @throws InvalidPath If the target name is invalid
+     */
+    public function checkMove(string $source, string $target): void {
+        $sourceNode = $this->tree->getNodeForPath($source);
+        if (!$sourceNode instanceof Node) {
+            return;
+        }
+
+        // First check copyable (move only needs additional delete permission)
+        $this->checkCopy($source, $target);
+
+        // The source needs to be deletable for moving
+        $sourceNodeFileInfo = $sourceNode->getFileInfo();
+        if (!$sourceNodeFileInfo->isDeletable()) {
+            throw new Forbidden($source . ' cannot be deleted');
+        }
+
+        // The source is not allowed to be the parent of the target
+        if (str_starts_with($source, $target . '/')) {
+            throw new Forbidden($source . ' cannot be moved to it\'s parent');
+        }
+    }
+
+    /**
+     * This sets a cookie to be able to recognize the start of the download
+     * the content must not be longer than 32 characters and must only contain
+     * alphanumeric characters
+     *
+     * @param RequestInterface $request
+     * @param ResponseInterface $response
+     */
+    public function handleDownloadToken(RequestInterface $request, ResponseInterface $response) {
+        $queryParams = $request->getQueryParameters();
+
+        /**
+         * this sets a cookie to be able to recognize the start of the download
+         * the content must not be longer than 32 characters and must only contain
+         * alphanumeric characters
+         */
+        if (isset($queryParams['downloadStartSecret'])) {
+            $token = $queryParams['downloadStartSecret'];
+            if (!isset($token[32])
+                && preg_match('!^[a-zA-Z0-9]+$!', $token) === 1) {
+                // FIXME: use $response->setHeader() instead
+                setcookie('ocDownloadStarted', $token, time() + 20, '/');
+            }
+        }
+    }
+
+    /**
+     * Add headers to file download
+     *
+     * @param RequestInterface $request
+     * @param ResponseInterface $response
+     */
+    public function httpGet(RequestInterface $request, ResponseInterface $response) {
+        // Only handle valid files
+        $node = $this->tree->getNodeForPath($request->getPath());
+        if (!($node instanceof IFile)) {
+            return;
+        }
+
+        // adds a 'Content-Disposition: attachment' header in case no disposition
+        // header has been set before
+        if ($this->downloadAttachment &&
+            $response->getHeader('Content-Disposition') === null) {
+            $filename = $node->getName();
+            if ($this->request->isUserAgent(
+                [
+                    Request::USER_AGENT_IE,
+                    Request::USER_AGENT_ANDROID_MOBILE_CHROME,
+                    Request::USER_AGENT_FREEBOX,
+                ])) {
+                $response->addHeader('Content-Disposition', 'attachment; filename="' . rawurlencode($filename) . '"');
+            } else {
+                $response->addHeader('Content-Disposition', 'attachment; filename*=UTF-8\'\'' . rawurlencode($filename)
+                                                        . '; filename="' . rawurlencode($filename) . '"');
+            }
+        }
+
+        if ($node instanceof File) {
+            //Add OC-Checksum header
+            $checksum = $node->getChecksum();
+            if ($checksum !== null && $checksum !== '') {
+                $response->addHeader('OC-Checksum', $checksum);
+            }
+        }
+        $response->addHeader('X-Accel-Buffering', 'no');
+    }
+
+    /**
+     * Adds all ownCloud-specific properties
+     *
+     * @param PropFind $propFind
+     * @param \Sabre\DAV\INode $node
+     * @return void
+     */
+    public function handleGetProperties(PropFind $propFind, \Sabre\DAV\INode $node) {
+        $httpRequest = $this->server->httpRequest;
+
+        if ($node instanceof Node) {
+            /**
+             * This was disabled, because it made dir listing throw an exception,
+             * so users were unable to navigate into folders where one subitem
+             * is blocked by the files_accesscontrol app, see:
+             * https://github.com/nextcloud/files_accesscontrol/issues/65
+             * if (!$node->getFileInfo()->isReadable()) {
+             *     // avoid detecting files through this means
+             *     throw new NotFound();
+             * }
+             */
+
+            $propFind->handle(self::FILEID_PROPERTYNAME, function () use ($node) {
+                return $node->getFileId();
+            });
+
+            $propFind->handle(self::INTERNAL_FILEID_PROPERTYNAME, function () use ($node) {
+                return $node->getInternalFileId();
+            });
+
+            $propFind->handle(self::PERMISSIONS_PROPERTYNAME, function () use ($node) {
+                $perms = $node->getDavPermissions();
+                if ($this->isPublic) {
+                    // remove mount information
+                    $perms = str_replace(['S', 'M'], '', $perms);
+                }
+                return $perms;
+            });
+
+            $propFind->handle(self::SHARE_PERMISSIONS_PROPERTYNAME, function () use ($node, $httpRequest) {
+                $user = $this->userSession->getUser();
+                if ($user === null) {
+                    return null;
+                }
+                return $node->getSharePermissions(
+                    $user->getUID()
+                );
+            });
+
+            $propFind->handle(self::OCM_SHARE_PERMISSIONS_PROPERTYNAME, function () use ($node, $httpRequest): ?string {
+                $user = $this->userSession->getUser();
+                if ($user === null) {
+                    return null;
+                }
+                $ncPermissions = $node->getSharePermissions(
+                    $user->getUID()
+                );
+                $ocmPermissions = $this->ncPermissions2ocmPermissions($ncPermissions);
+                return json_encode($ocmPermissions, JSON_THROW_ON_ERROR);
+            });
+
+            $propFind->handle(self::SHARE_ATTRIBUTES_PROPERTYNAME, function () use ($node, $httpRequest) {
+                return json_encode($node->getShareAttributes(), JSON_THROW_ON_ERROR);
+            });
+
+            $propFind->handle(self::GETETAG_PROPERTYNAME, function () use ($node): string {
+                return $node->getETag();
+            });
+
+            $propFind->handle(self::OWNER_ID_PROPERTYNAME, function () use ($node): ?string {
+                $owner = $node->getOwner();
+                if (!$owner) {
+                    return null;
+                } else {
+                    return $owner->getUID();
+                }
+            });
+            $propFind->handle(self::OWNER_DISPLAY_NAME_PROPERTYNAME, function () use ($node): ?string {
+                $owner = $node->getOwner();
+                if (!$owner) {
+                    return null;
+                } else {
+                    return $owner->getDisplayName();
+                }
+            });
+
+            $propFind->handle(self::HAS_PREVIEW_PROPERTYNAME, function () use ($node) {
+                return json_encode($this->previewManager->isAvailable($node->getFileInfo()), JSON_THROW_ON_ERROR);
+            });
+            $propFind->handle(self::SIZE_PROPERTYNAME, function () use ($node): int|float {
+                return $node->getSize();
+            });
+            $propFind->handle(self::MOUNT_TYPE_PROPERTYNAME, function () use ($node) {
+                return $node->getFileInfo()->getMountPoint()->getMountType();
+            });
+
+            /**
+             * This is a special property which is used to determine if a node
+             * is a mount root or not, e.g. a shared folder.
+             * If so, then the node can only be unshared and not deleted.
+             * @see https://github.com/nextcloud/server/blob/cc75294eb6b16b916a342e69998935f89222619d/lib/private/Files/View.php#L696-L698
+             */
+            $propFind->handle(self::MOUNT_ROOT_PROPERTYNAME, function () use ($node) {
+                return $node->getNode()->getInternalPath() === '' ? 'true' : 'false';
+            });
+
+            $propFind->handle(self::SHARE_NOTE, function () use ($node): ?string {
+                $user = $this->userSession->getUser();
+                return $node->getNoteFromShare(
+                    $user?->getUID()
+                );
+            });
+
+            $propFind->handle(self::SHARE_HIDE_DOWNLOAD_PROPERTYNAME, function () use ($node) {
+                $storage = $node->getNode()->getStorage();
+                if ($storage->instanceOfStorage(ISharedStorage::class)) {
+                    /** @var ISharedStorage $storage */
+                    return match($storage->getShare()->getHideDownload()) {
+                        true => 'true',
+                        false => 'false',
+                    };
+                } else {
+                    return null;
+                }
+            });
+
+            $propFind->handle(self::DATA_FINGERPRINT_PROPERTYNAME, function () {
+                return $this->config->getSystemValue('data-fingerprint', '');
+            });
+            $propFind->handle(self::CREATIONDATE_PROPERTYNAME, function () use ($node) {
+                return (new \DateTimeImmutable())
+                    ->setTimestamp($node->getFileInfo()->getCreationTime())
+                    ->format(\DateTimeInterface::ATOM);
+            });
+            $propFind->handle(self::CREATION_TIME_PROPERTYNAME, function () use ($node) {
+                return $node->getFileInfo()->getCreationTime();
+            });
+
+            foreach ($node->getFileInfo()->getMetadata() as $metadataKey => $metadataValue) {
+                $propFind->handle(self::FILE_METADATA_PREFIX . $metadataKey, $metadataValue);
+            }
+
+            $propFind->handle(self::HIDDEN_PROPERTYNAME, function () use ($node) {
+                $isLivePhoto = isset($node->getFileInfo()->getMetadata()['files-live-photo']);
+                $isMovFile = $node->getFileInfo()->getMimetype() === 'video/quicktime';
+                return ($isLivePhoto && $isMovFile) ? 'true' : 'false';
+            });
+
+            /**
+             * Return file/folder name as displayname. The primary reason to
+             * implement it this way is to avoid costly fallback to
+             * CustomPropertiesBackend (esp. visible when querying all files
+             * in a folder).
+             */
+            $propFind->handle(self::DISPLAYNAME_PROPERTYNAME, function () use ($node) {
+                return $node->getName();
+            });
+
+            $propFind->handle(self::IS_FEDERATED_PROPERTYNAME, function () use ($node) {
+                return $node->getFileInfo()->getMountPoint()
+                    instanceof SharingExternalMount;
+            });
+        }
+
+        if ($node instanceof File) {
+            $propFind->handle(self::DOWNLOADURL_PROPERTYNAME, function () use ($node) {
+                try {
+                    $directDownloadUrl = $node->getDirectDownload();
+                    if (isset($directDownloadUrl['url'])) {
+                        return $directDownloadUrl['url'];
+                    }
+                } catch (StorageNotAvailableException $e) {
+                    return false;
+                } catch (ForbiddenException $e) {
+                    return false;
+                }
+                return false;
+            });
+
+            $propFind->handle(self::CHECKSUMS_PROPERTYNAME, function () use ($node) {
+                $checksum = $node->getChecksum();
+                if ($checksum === null || $checksum === '') {
+                    return null;
+                }
+
+                return new ChecksumList($checksum);
+            });
+
+            $propFind->handle(self::UPLOAD_TIME_PROPERTYNAME, function () use ($node) {
+                return $node->getFileInfo()->getUploadTime();
+            });
+        }
+
+        if ($node instanceof Directory) {
+            $propFind->handle(self::SIZE_PROPERTYNAME, function () use ($node) {
+                return $node->getSize();
+            });
+
+            $requestProperties = $propFind->getRequestedProperties();
+
+            if (in_array(self::SUBFILE_COUNT_PROPERTYNAME, $requestProperties, true)
+                || in_array(self::SUBFOLDER_COUNT_PROPERTYNAME, $requestProperties, true)) {
+                $nbFiles = 0;
+                $nbFolders = 0;
+                foreach ($node->getChildren() as $child) {
+                    if ($child instanceof File) {
+                        $nbFiles++;
+                    } elseif ($child instanceof Directory) {
+                        $nbFolders++;
+                    }
+                }
+
+                $propFind->handle(self::SUBFILE_COUNT_PROPERTYNAME, $nbFiles);
+                $propFind->handle(self::SUBFOLDER_COUNT_PROPERTYNAME, $nbFolders);
+            }
+        }
+    }
+
+    /**
+     * translate Nextcloud permissions to OCM Permissions
+     *
+     * @param $ncPermissions
+     * @return array
+     */
+    protected function ncPermissions2ocmPermissions($ncPermissions) {
+        $ocmPermissions = [];
+
+        if ($ncPermissions & Constants::PERMISSION_SHARE) {
+            $ocmPermissions[] = 'share';
+        }
+
+        if ($ncPermissions & Constants::PERMISSION_READ) {
+            $ocmPermissions[] = 'read';
+        }
+
+        if (($ncPermissions & Constants::PERMISSION_CREATE) ||
+            ($ncPermissions & Constants::PERMISSION_UPDATE)) {
+            $ocmPermissions[] = 'write';
+        }
+
+        return $ocmPermissions;
+    }
+
+    /**
+     * Update ownCloud-specific properties
+     *
+     * @param string $path
+     * @param PropPatch $propPatch
+     *
+     * @return void
+     */
+    public function handleUpdateProperties($path, PropPatch $propPatch) {
+        $node = $this->tree->getNodeForPath($path);
+        if (!($node instanceof Node)) {
+            return;
+        }
+
+        $propPatch->handle(self::LASTMODIFIED_PROPERTYNAME, function ($time) use ($node) {
+            if (empty($time)) {
+                return false;
+            }
+            $node->touch($time);
+            return true;
+        });
+        $propPatch->handle(self::GETETAG_PROPERTYNAME, function ($etag) use ($node) {
+            if (empty($etag)) {
+                return false;
+            }
+            return $node->setEtag($etag) !== -1;
+        });
+        $propPatch->handle(self::CREATIONDATE_PROPERTYNAME, function ($time) use ($node) {
+            if (empty($time)) {
+                return false;
+            }
+            $dateTime = new \DateTimeImmutable($time);
+            $node->setCreationTime($dateTime->getTimestamp());
+            return true;
+        });
+        $propPatch->handle(self::CREATION_TIME_PROPERTYNAME, function ($time) use ($node) {
+            if (empty($time)) {
+                return false;
+            }
+            $node->setCreationTime((int)$time);
+            return true;
+        });
+
+        $this->handleUpdatePropertiesMetadata($propPatch, $node);
+
+        /**
+         * Disable modification of the displayname property for files and
+         * folders via PROPPATCH. See PROPFIND for more information.
+         */
+        $propPatch->handle(self::DISPLAYNAME_PROPERTYNAME, function ($displayName) {
+            return 403;
+        });
+    }
+
+
+    /**
+     * handle the update of metadata from PROPPATCH requests
+     *
+     * @param PropPatch $propPatch
+     * @param Node $node
+     *
+     * @throws FilesMetadataException
+     */
+    private function handleUpdatePropertiesMetadata(PropPatch $propPatch, Node $node): void {
+        $userId = $this->userSession->getUser()?->getUID();
+        if ($userId === null) {
+            return;
+        }
+
+        $accessRight = $this->getMetadataFileAccessRight($node, $userId);
+        $filesMetadataManager = $this->initFilesMetadataManager();
+        $knownMetadata = $filesMetadataManager->getKnownMetadata();
+
+        foreach ($propPatch->getRemainingMutations() as $mutation) {
+            if (!str_starts_with($mutation, self::FILE_METADATA_PREFIX)) {
+                continue;
+            }
+
+            $propPatch->handle(
+                $mutation,
+                function (mixed $value) use ($accessRight, $knownMetadata, $node, $mutation, $filesMetadataManager): bool {
+                    /** @var FilesMetadata $metadata */
+                    $metadata = $filesMetadataManager->getMetadata((int)$node->getFileId(), true);
+                    $metadata->setStorageId($node->getNode()->getStorage()->getCache()->getNumericStorageId());
+                    $metadataKey = substr($mutation, strlen(self::FILE_METADATA_PREFIX));
+
+                    // confirm metadata key is editable via PROPPATCH
+                    if ($knownMetadata->getEditPermission($metadataKey) < $accessRight) {
+                        throw new FilesMetadataException('you do not have enough rights to update \'' . $metadataKey . '\' on this node');
+                    }
+
+                    if ($value === null) {
+                        $metadata->unset($metadataKey);
+                        $filesMetadataManager->saveMetadata($metadata);
+                        return true;
+                    }
+
+                    // If the metadata is unknown, it defaults to string.
+                    try {
+                        $type = $knownMetadata->getType($metadataKey);
+                    } catch (FilesMetadataNotFoundException) {
+                        $type = IMetadataValueWrapper::TYPE_STRING;
+                    }
+
+                    switch ($type) {
+                        case IMetadataValueWrapper::TYPE_STRING:
+                            $metadata->setString($metadataKey, $value, $knownMetadata->isIndex($metadataKey));
+                            break;
+                        case IMetadataValueWrapper::TYPE_INT:
+                            $metadata->setInt($metadataKey, $value, $knownMetadata->isIndex($metadataKey));
+                            break;
+                        case IMetadataValueWrapper::TYPE_FLOAT:
+                            $metadata->setFloat($metadataKey, $value);
+                            break;
+                        case IMetadataValueWrapper::TYPE_BOOL:
+                            $metadata->setBool($metadataKey, $value, $knownMetadata->isIndex($metadataKey));
+                            break;
+                        case IMetadataValueWrapper::TYPE_ARRAY:
+                            $metadata->setArray($metadataKey, $value);
+                            break;
+                        case IMetadataValueWrapper::TYPE_STRING_LIST:
+                            $metadata->setStringList($metadataKey, $value, $knownMetadata->isIndex($metadataKey));
+                            break;
+                        case IMetadataValueWrapper::TYPE_INT_LIST:
+                            $metadata->setIntList($metadataKey, $value, $knownMetadata->isIndex($metadataKey));
+                            break;
+                    }
+
+                    $filesMetadataManager->saveMetadata($metadata);
+
+                    return true;
+                }
+            );
+        }
+    }
+
+    /**
+     * init default internal metadata
+     *
+     * @return IFilesMetadataManager
+     */
+    private function initFilesMetadataManager(): IFilesMetadataManager {
+        /** @var IFilesMetadataManager $manager */
+        $manager = \OCP\Server::get(IFilesMetadataManager::class);
+        $manager->initMetadata('files-live-photo', IMetadataValueWrapper::TYPE_STRING, false, IMetadataValueWrapper::EDIT_REQ_OWNERSHIP);
+
+        return $manager;
+    }
+
+    /**
+     * based on owner and shares, returns the bottom limit to update related metadata
+     *
+     * @param Node $node
+     * @param string $userId
+     *
+     * @return int
+     */
+    private function getMetadataFileAccessRight(Node $node, string $userId): int {
+        if ($node->getOwner()?->getUID() === $userId) {
+            return IMetadataValueWrapper::EDIT_REQ_OWNERSHIP;
+        } else {
+            $filePermissions = $node->getSharePermissions($userId);
+            if ($filePermissions & Constants::PERMISSION_UPDATE) {
+                return IMetadataValueWrapper::EDIT_REQ_WRITE_PERMISSION;
+            }
+        }
+
+        return IMetadataValueWrapper::EDIT_REQ_READ_PERMISSION;
+    }
+
+    /**
+     * @param string $filePath
+     * @param ?\Sabre\DAV\INode $node
+     * @return void
+     * @throws \Sabre\DAV\Exception\BadRequest
+     */
+    public function sendFileIdHeader($filePath, ?\Sabre\DAV\INode $node = null) {
+        // we get the node for the given $filePath here because in case of afterCreateFile $node is the parent folder
+        if (!$this->server->tree->nodeExists($filePath)) {
+            return;
+        }
+        $node = $this->server->tree->getNodeForPath($filePath);
+        if ($node instanceof Node) {
+            $fileId = $node->getFileId();
+            if (!is_null($fileId)) {
+                $this->server->httpResponse->setHeader('OC-FileId', $fileId);
+            }
+        }
+    }
 }

Spacing +44 added lines, -44 removed lines

@@ -135,9 +135,9 @@ 
 		$this->server->on('propPatch', [$this, 'handleUpdateProperties']);
 		$this->server->on('afterBind', [$this, 'sendFileIdHeader']);
 		$this->server->on('afterWriteContent', [$this, 'sendFileIdHeader']);
-		$this->server->on('afterMethod:GET', [$this,'httpGet']);
+		$this->server->on('afterMethod:GET', [$this, 'httpGet']);
 		$this->server->on('afterMethod:GET', [$this, 'handleDownloadToken']);
-		$this->server->on('afterResponse', function ($request, ResponseInterface $response): void {
+		$this->server->on('afterResponse', function($request, ResponseInterface $response): void {
 			$body = $response->getBody();
 			if (is_resource($body)) {
 				fclose($body);
@@ -164,7 +164,7 @@ 
 		// Ensure source exists
 		$sourceNodeFileInfo = $sourceNode->getFileInfo();
 		if ($sourceNodeFileInfo === null) {
-			throw new NotFound($source . ' does not exist');
+			throw new NotFound($source.' does not exist');
 		}
 		// Ensure the target name is valid
 		try {
@@ -204,12 +204,12 @@ 
 		// The source needs to be deletable for moving
 		$sourceNodeFileInfo = $sourceNode->getFileInfo();
 		if (!$sourceNodeFileInfo->isDeletable()) {
-			throw new Forbidden($source . ' cannot be deleted');
+			throw new Forbidden($source.' cannot be deleted');
 		}
 
 		// The source is not allowed to be the parent of the target
-		if (str_starts_with($source, $target . '/')) {
-			throw new Forbidden($source . ' cannot be moved to it\'s parent');
+		if (str_starts_with($source, $target.'/')) {
+			throw new Forbidden($source.' cannot be moved to it\'s parent');
 		}
 	}
 
@@ -263,10 +263,10 @@ 
 					Request::USER_AGENT_ANDROID_MOBILE_CHROME,
 					Request::USER_AGENT_FREEBOX,
 				])) {
-				$response->addHeader('Content-Disposition', 'attachment; filename="' . rawurlencode($filename) . '"');
+				$response->addHeader('Content-Disposition', 'attachment; filename="'.rawurlencode($filename).'"');
 			} else {
-				$response->addHeader('Content-Disposition', 'attachment; filename*=UTF-8\'\'' . rawurlencode($filename)
-													 . '; filename="' . rawurlencode($filename) . '"');
+				$response->addHeader('Content-Disposition', 'attachment; filename*=UTF-8\'\''.rawurlencode($filename)
+													 . '; filename="'.rawurlencode($filename).'"');
 			}
 		}
 
@@ -302,15 +302,15 @@ 
 			 * }
 			 */
 
-			$propFind->handle(self::FILEID_PROPERTYNAME, function () use ($node) {
+			$propFind->handle(self::FILEID_PROPERTYNAME, function() use ($node) {
 				return $node->getFileId();
 			});
 
-			$propFind->handle(self::INTERNAL_FILEID_PROPERTYNAME, function () use ($node) {
+			$propFind->handle(self::INTERNAL_FILEID_PROPERTYNAME, function() use ($node) {
 				return $node->getInternalFileId();
 			});
 
-			$propFind->handle(self::PERMISSIONS_PROPERTYNAME, function () use ($node) {
+			$propFind->handle(self::PERMISSIONS_PROPERTYNAME, function() use ($node) {
 				$perms = $node->getDavPermissions();
 				if ($this->isPublic) {
 					// remove mount information
@@ -319,7 +319,7 @@ 
 				return $perms;
 			});
 
-			$propFind->handle(self::SHARE_PERMISSIONS_PROPERTYNAME, function () use ($node, $httpRequest) {
+			$propFind->handle(self::SHARE_PERMISSIONS_PROPERTYNAME, function() use ($node, $httpRequest) {
 				$user = $this->userSession->getUser();
 				if ($user === null) {
 					return null;
@@ -329,7 +329,7 @@ 
 				);
 			});
 
-			$propFind->handle(self::OCM_SHARE_PERMISSIONS_PROPERTYNAME, function () use ($node, $httpRequest): ?string {
+			$propFind->handle(self::OCM_SHARE_PERMISSIONS_PROPERTYNAME, function() use ($node, $httpRequest): ?string {
 				$user = $this->userSession->getUser();
 				if ($user === null) {
 					return null;
@@ -341,15 +341,15 @@ 
 				return json_encode($ocmPermissions, JSON_THROW_ON_ERROR);
 			});
 
-			$propFind->handle(self::SHARE_ATTRIBUTES_PROPERTYNAME, function () use ($node, $httpRequest) {
+			$propFind->handle(self::SHARE_ATTRIBUTES_PROPERTYNAME, function() use ($node, $httpRequest) {
 				return json_encode($node->getShareAttributes(), JSON_THROW_ON_ERROR);
 			});
 
-			$propFind->handle(self::GETETAG_PROPERTYNAME, function () use ($node): string {
+			$propFind->handle(self::GETETAG_PROPERTYNAME, function() use ($node): string {
 				return $node->getETag();
 			});
 
-			$propFind->handle(self::OWNER_ID_PROPERTYNAME, function () use ($node): ?string {
+			$propFind->handle(self::OWNER_ID_PROPERTYNAME, function() use ($node): ?string {
 				$owner = $node->getOwner();
 				if (!$owner) {
 					return null;
@@ -357,7 +357,7 @@ 
 					return $owner->getUID();
 				}
 			});
-			$propFind->handle(self::OWNER_DISPLAY_NAME_PROPERTYNAME, function () use ($node): ?string {
+			$propFind->handle(self::OWNER_DISPLAY_NAME_PROPERTYNAME, function() use ($node): ?string {
 				$owner = $node->getOwner();
 				if (!$owner) {
 					return null;
@@ -366,13 +366,13 @@ 
 				}
 			});
 
-			$propFind->handle(self::HAS_PREVIEW_PROPERTYNAME, function () use ($node) {
+			$propFind->handle(self::HAS_PREVIEW_PROPERTYNAME, function() use ($node) {
 				return json_encode($this->previewManager->isAvailable($node->getFileInfo()), JSON_THROW_ON_ERROR);
 			});
-			$propFind->handle(self::SIZE_PROPERTYNAME, function () use ($node): int|float {
+			$propFind->handle(self::SIZE_PROPERTYNAME, function() use ($node): int | float {
 				return $node->getSize();
 			});
-			$propFind->handle(self::MOUNT_TYPE_PROPERTYNAME, function () use ($node) {
+			$propFind->handle(self::MOUNT_TYPE_PROPERTYNAME, function() use ($node) {
 				return $node->getFileInfo()->getMountPoint()->getMountType();
 			});
 
@@ -382,18 +382,18 @@ 
 			 * If so, then the node can only be unshared and not deleted.
 			 * @see https://github.com/nextcloud/server/blob/cc75294eb6b16b916a342e69998935f89222619d/lib/private/Files/View.php#L696-L698
 			 */
-			$propFind->handle(self::MOUNT_ROOT_PROPERTYNAME, function () use ($node) {
+			$propFind->handle(self::MOUNT_ROOT_PROPERTYNAME, function() use ($node) {
 				return $node->getNode()->getInternalPath() === '' ? 'true' : 'false';
 			});
 
-			$propFind->handle(self::SHARE_NOTE, function () use ($node): ?string {
+			$propFind->handle(self::SHARE_NOTE, function() use ($node): ?string {
 				$user = $this->userSession->getUser();
 				return $node->getNoteFromShare(
 					$user?->getUID()
 				);
 			});
 
-			$propFind->handle(self::SHARE_HIDE_DOWNLOAD_PROPERTYNAME, function () use ($node) {
+			$propFind->handle(self::SHARE_HIDE_DOWNLOAD_PROPERTYNAME, function() use ($node) {
 				$storage = $node->getNode()->getStorage();
 				if ($storage->instanceOfStorage(ISharedStorage::class)) {
 					/** @var ISharedStorage $storage */
@@ -406,23 +406,23 @@ 
 				}
 			});
 
-			$propFind->handle(self::DATA_FINGERPRINT_PROPERTYNAME, function () {
+			$propFind->handle(self::DATA_FINGERPRINT_PROPERTYNAME, function() {
 				return $this->config->getSystemValue('data-fingerprint', '');
 			});
-			$propFind->handle(self::CREATIONDATE_PROPERTYNAME, function () use ($node) {
+			$propFind->handle(self::CREATIONDATE_PROPERTYNAME, function() use ($node) {
 				return (new \DateTimeImmutable())
 					->setTimestamp($node->getFileInfo()->getCreationTime())
 					->format(\DateTimeInterface::ATOM);
 			});
-			$propFind->handle(self::CREATION_TIME_PROPERTYNAME, function () use ($node) {
+			$propFind->handle(self::CREATION_TIME_PROPERTYNAME, function() use ($node) {
 				return $node->getFileInfo()->getCreationTime();
 			});
 
 			foreach ($node->getFileInfo()->getMetadata() as $metadataKey => $metadataValue) {
-				$propFind->handle(self::FILE_METADATA_PREFIX . $metadataKey, $metadataValue);
+				$propFind->handle(self::FILE_METADATA_PREFIX.$metadataKey, $metadataValue);
 			}
 
-			$propFind->handle(self::HIDDEN_PROPERTYNAME, function () use ($node) {
+			$propFind->handle(self::HIDDEN_PROPERTYNAME, function() use ($node) {
 				$isLivePhoto = isset($node->getFileInfo()->getMetadata()['files-live-photo']);
 				$isMovFile = $node->getFileInfo()->getMimetype() === 'video/quicktime';
 				return ($isLivePhoto && $isMovFile) ? 'true' : 'false';
@@ -434,18 +434,18 @@ 
 			 * CustomPropertiesBackend (esp. visible when querying all files
 			 * in a folder).
 			 */
-			$propFind->handle(self::DISPLAYNAME_PROPERTYNAME, function () use ($node) {
+			$propFind->handle(self::DISPLAYNAME_PROPERTYNAME, function() use ($node) {
 				return $node->getName();
 			});
 
-			$propFind->handle(self::IS_FEDERATED_PROPERTYNAME, function () use ($node) {
+			$propFind->handle(self::IS_FEDERATED_PROPERTYNAME, function() use ($node) {
 				return $node->getFileInfo()->getMountPoint()
 					instanceof SharingExternalMount;
 			});
 		}
 
 		if ($node instanceof File) {
-			$propFind->handle(self::DOWNLOADURL_PROPERTYNAME, function () use ($node) {
+			$propFind->handle(self::DOWNLOADURL_PROPERTYNAME, function() use ($node) {
 				try {
 					$directDownloadUrl = $node->getDirectDownload();
 					if (isset($directDownloadUrl['url'])) {
@@ -459,7 +459,7 @@ 
 				return false;
 			});
 
-			$propFind->handle(self::CHECKSUMS_PROPERTYNAME, function () use ($node) {
+			$propFind->handle(self::CHECKSUMS_PROPERTYNAME, function() use ($node) {
 				$checksum = $node->getChecksum();
 				if ($checksum === null || $checksum === '') {
 					return null;
@@ -468,13 +468,13 @@ 
 				return new ChecksumList($checksum);
 			});
 
-			$propFind->handle(self::UPLOAD_TIME_PROPERTYNAME, function () use ($node) {
+			$propFind->handle(self::UPLOAD_TIME_PROPERTYNAME, function() use ($node) {
 				return $node->getFileInfo()->getUploadTime();
 			});
 		}
 
 		if ($node instanceof Directory) {
-			$propFind->handle(self::SIZE_PROPERTYNAME, function () use ($node) {
+			$propFind->handle(self::SIZE_PROPERTYNAME, function() use ($node) {
 				return $node->getSize();
 			});
 
@@ -537,20 +537,20 @@ 
 			return;
 		}
 
-		$propPatch->handle(self::LASTMODIFIED_PROPERTYNAME, function ($time) use ($node) {
+		$propPatch->handle(self::LASTMODIFIED_PROPERTYNAME, function($time) use ($node) {
 			if (empty($time)) {
 				return false;
 			}
 			$node->touch($time);
 			return true;
 		});
-		$propPatch->handle(self::GETETAG_PROPERTYNAME, function ($etag) use ($node) {
+		$propPatch->handle(self::GETETAG_PROPERTYNAME, function($etag) use ($node) {
 			if (empty($etag)) {
 				return false;
 			}
 			return $node->setEtag($etag) !== -1;
 		});
-		$propPatch->handle(self::CREATIONDATE_PROPERTYNAME, function ($time) use ($node) {
+		$propPatch->handle(self::CREATIONDATE_PROPERTYNAME, function($time) use ($node) {
 			if (empty($time)) {
 				return false;
 			}
@@ -558,11 +558,11 @@ 
 			$node->setCreationTime($dateTime->getTimestamp());
 			return true;
 		});
-		$propPatch->handle(self::CREATION_TIME_PROPERTYNAME, function ($time) use ($node) {
+		$propPatch->handle(self::CREATION_TIME_PROPERTYNAME, function($time) use ($node) {
 			if (empty($time)) {
 				return false;
 			}
-			$node->setCreationTime((int)$time);
+			$node->setCreationTime((int) $time);
 			return true;
 		});
 
@@ -572,7 +572,7 @@ 
 		 * Disable modification of the displayname property for files and
 		 * folders via PROPPATCH. See PROPFIND for more information.
 		 */
-		$propPatch->handle(self::DISPLAYNAME_PROPERTYNAME, function ($displayName) {
+		$propPatch->handle(self::DISPLAYNAME_PROPERTYNAME, function($displayName) {
 			return 403;
 		});
 	}
@@ -603,15 +603,15 @@ 
 
 			$propPatch->handle(
 				$mutation,
-				function (mixed $value) use ($accessRight, $knownMetadata, $node, $mutation, $filesMetadataManager): bool {
+				function(mixed $value) use ($accessRight, $knownMetadata, $node, $mutation, $filesMetadataManager): bool {
 					/** @var FilesMetadata $metadata */
-					$metadata = $filesMetadataManager->getMetadata((int)$node->getFileId(), true);
+					$metadata = $filesMetadataManager->getMetadata((int) $node->getFileId(), true);
 					$metadata->setStorageId($node->getNode()->getStorage()->getCache()->getNumericStorageId());
 					$metadataKey = substr($mutation, strlen(self::FILE_METADATA_PREFIX));
 
 					// confirm metadata key is editable via PROPPATCH
 					if ($knownMetadata->getEditPermission($metadataKey) < $accessRight) {
-						throw new FilesMetadataException('you do not have enough rights to update \'' . $metadataKey . '\' on this node');
+						throw new FilesMetadataException('you do not have enough rights to update \''.$metadataKey.'\' on this node');
 					}
 
 					if ($value === null) {

apps/files_sharing/lib/Controller/ShareAPIController.php

Indentation +2145 added lines, -2145 removed lines

@@ -71,2152 +71,2152 @@
  */
 class ShareAPIController extends OCSController {
 
-	private ?Node $lockedNode = null;
-
-	/**
-	 * Share20OCS constructor.
-	 */
-	public function __construct(
-		string $appName,
-		IRequest $request,
-		private IManager $shareManager,
-		private IGroupManager $groupManager,
-		private IUserManager $userManager,
-		private IRootFolder $rootFolder,
-		private IURLGenerator $urlGenerator,
-		private IL10N $l,
-		private IConfig $config,
-		private IAppManager $appManager,
-		private ContainerInterface $serverContainer,
-		private IUserStatusManager $userStatusManager,
-		private IPreview $previewManager,
-		private IDateTimeZone $dateTimeZone,
-		private LoggerInterface $logger,
-		private IProviderFactory $factory,
-		private IMailer $mailer,
-		private ?string $userId = null,
-	) {
-		parent::__construct($appName, $request);
-	}
-
-	/**
-	 * Convert an IShare to an array for OCS output
-	 *
-	 * @param IShare $share
-	 * @param Node|null $recipientNode
-	 * @return Files_SharingShare
-	 * @throws NotFoundException In case the node can't be resolved.
-	 *
-	 * @suppress PhanUndeclaredClassMethod
-	 */
-	protected function formatShare(IShare $share, ?Node $recipientNode = null): array {
-		$sharedBy = $this->userManager->get($share->getSharedBy());
-		$shareOwner = $this->userManager->get($share->getShareOwner());
-
-		$isOwnShare = false;
-		if ($shareOwner !== null) {
-			$isOwnShare = $shareOwner->getUID() === $this->userId;
-		}
-
-		$result = [
-			'id' => $share->getId(),
-			'share_type' => $share->getShareType(),
-			'uid_owner' => $share->getSharedBy(),
-			'displayname_owner' => $sharedBy !== null ? $sharedBy->getDisplayName() : $share->getSharedBy(),
-			// recipient permissions
-			'permissions' => $share->getPermissions(),
-			// current user permissions on this share
-			'can_edit' => $this->canEditShare($share),
-			'can_delete' => $this->canDeleteShare($share),
-			'stime' => $share->getShareTime()->getTimestamp(),
-			'parent' => null,
-			'expiration' => null,
-			'token' => null,
-			'uid_file_owner' => $share->getShareOwner(),
-			'note' => $share->getNote(),
-			'label' => $share->getLabel(),
-			'displayname_file_owner' => $shareOwner !== null ? $shareOwner->getDisplayName() : $share->getShareOwner(),
-		];
-
-		$userFolder = $this->rootFolder->getUserFolder($this->userId);
-		if ($recipientNode) {
-			$node = $recipientNode;
-		} else {
-			$node = $userFolder->getFirstNodeById($share->getNodeId());
-			if (!$node) {
-				// fallback to guessing the path
-				$node = $userFolder->get($share->getTarget());
-				if ($node === null || $share->getTarget() === '') {
-					throw new NotFoundException();
-				}
-			}
-		}
-
-		$result['path'] = $userFolder->getRelativePath($node->getPath());
-		if ($node instanceof Folder) {
-			$result['item_type'] = 'folder';
-		} else {
-			$result['item_type'] = 'file';
-		}
-
-		// Get the original node permission if the share owner is the current user
-		if ($isOwnShare) {
-			$result['item_permissions'] = $node->getPermissions();
-		}
-
-		// If we're on the recipient side, the node permissions
-		// are bound to the share permissions. So we need to
-		// adjust the permissions to the share permissions if necessary.
-		if (!$isOwnShare) {
-			$result['item_permissions'] = $share->getPermissions();
-
-			// For some reason, single files share are forbidden to have the delete permission
-			// since we have custom methods to check those, let's adjust straight away.
-			// DAV permissions does not have that issue though.
-			if ($this->canDeleteShare($share) || $this->canDeleteShareFromSelf($share)) {
-				$result['item_permissions'] |= Constants::PERMISSION_DELETE;
-			}
-			if ($this->canEditShare($share)) {
-				$result['item_permissions'] |= Constants::PERMISSION_UPDATE;
-			}
-		}
-
-		// See MOUNT_ROOT_PROPERTYNAME dav property
-		$result['is-mount-root'] = $node->getInternalPath() === '';
-		$result['mount-type'] = $node->getMountPoint()->getMountType();
-
-		$result['mimetype'] = $node->getMimetype();
-		$result['has_preview'] = $this->previewManager->isAvailable($node);
-		$result['storage_id'] = $node->getStorage()->getId();
-		$result['storage'] = $node->getStorage()->getCache()->getNumericStorageId();
-		$result['item_source'] = $node->getId();
-		$result['file_source'] = $node->getId();
-		$result['file_parent'] = $node->getParent()->getId();
-		$result['file_target'] = $share->getTarget();
-		$result['item_size'] = $node->getSize();
-		$result['item_mtime'] = $node->getMTime();
-
-		$expiration = $share->getExpirationDate();
-		if ($expiration !== null) {
-			$expiration->setTimezone($this->dateTimeZone->getTimeZone());
-			$result['expiration'] = $expiration->format('Y-m-d 00:00:00');
-		}
-
-		if ($share->getShareType() === IShare::TYPE_USER) {
-			$sharedWith = $this->userManager->get($share->getSharedWith());
-			$result['share_with'] = $share->getSharedWith();
-			$result['share_with_displayname'] = $sharedWith !== null ? $sharedWith->getDisplayName() : $share->getSharedWith();
-			$result['share_with_displayname_unique'] = $sharedWith !== null ? (
-				!empty($sharedWith->getSystemEMailAddress()) ? $sharedWith->getSystemEMailAddress() : $sharedWith->getUID()
-			) : $share->getSharedWith();
-
-			$userStatuses = $this->userStatusManager->getUserStatuses([$share->getSharedWith()]);
-			$userStatus = array_shift($userStatuses);
-			if ($userStatus) {
-				$result['status'] = [
-					'status' => $userStatus->getStatus(),
-					'message' => $userStatus->getMessage(),
-					'icon' => $userStatus->getIcon(),
-					'clearAt' => $userStatus->getClearAt()
-						? (int)$userStatus->getClearAt()->format('U')
-						: null,
-				];
-			}
-		} elseif ($share->getShareType() === IShare::TYPE_GROUP) {
-			$group = $this->groupManager->get($share->getSharedWith());
-			$result['share_with'] = $share->getSharedWith();
-			$result['share_with_displayname'] = $group !== null ? $group->getDisplayName() : $share->getSharedWith();
-		} elseif ($share->getShareType() === IShare::TYPE_LINK) {
-
-			// "share_with" and "share_with_displayname" for passwords of link
-			// shares was deprecated in Nextcloud 15, use "password" instead.
-			$result['share_with'] = $share->getPassword();
-			$result['share_with_displayname'] = '(' . $this->l->t('Shared link') . ')';
-
-			$result['password'] = $share->getPassword();
-
-			$result['send_password_by_talk'] = $share->getSendPasswordByTalk();
-
-			$result['token'] = $share->getToken();
-			$result['url'] = $this->urlGenerator->linkToRouteAbsolute('files_sharing.sharecontroller.showShare', ['token' => $share->getToken()]);
-		} elseif ($share->getShareType() === IShare::TYPE_REMOTE) {
-			$result['share_with'] = $share->getSharedWith();
-			$result['share_with_displayname'] = $this->getCachedFederatedDisplayName($share->getSharedWith());
-			$result['token'] = $share->getToken();
-		} elseif ($share->getShareType() === IShare::TYPE_REMOTE_GROUP) {
-			$result['share_with'] = $share->getSharedWith();
-			$result['share_with_displayname'] = $this->getDisplayNameFromAddressBook($share->getSharedWith(), 'CLOUD');
-			$result['token'] = $share->getToken();
-		} elseif ($share->getShareType() === IShare::TYPE_EMAIL) {
-			$result['share_with'] = $share->getSharedWith();
-			$result['password'] = $share->getPassword();
-			$result['password_expiration_time'] = $share->getPasswordExpirationTime() !== null ? $share->getPasswordExpirationTime()->format(\DateTime::ATOM) : null;
-			$result['send_password_by_talk'] = $share->getSendPasswordByTalk();
-			$result['share_with_displayname'] = $this->getDisplayNameFromAddressBook($share->getSharedWith(), 'EMAIL');
-			$result['token'] = $share->getToken();
-		} elseif ($share->getShareType() === IShare::TYPE_CIRCLE) {
-			// getSharedWith() returns either "name (type, owner)" or
-			// "name (type, owner) [id]", depending on the Teams app version.
-			$hasCircleId = (substr($share->getSharedWith(), -1) === ']');
-
-			$result['share_with_displayname'] = $share->getSharedWithDisplayName();
-			if (empty($result['share_with_displayname'])) {
-				$displayNameLength = ($hasCircleId ? strrpos($share->getSharedWith(), ' ') : strlen($share->getSharedWith()));
-				$result['share_with_displayname'] = substr($share->getSharedWith(), 0, $displayNameLength);
-			}
-
-			$result['share_with_avatar'] = $share->getSharedWithAvatar();
-
-			$shareWithStart = ($hasCircleId ? strrpos($share->getSharedWith(), '[') + 1 : 0);
-			$shareWithLength = ($hasCircleId ? -1 : strpos($share->getSharedWith(), ' '));
-			if ($shareWithLength === false) {
-				$result['share_with'] = substr($share->getSharedWith(), $shareWithStart);
-			} else {
-				$result['share_with'] = substr($share->getSharedWith(), $shareWithStart, $shareWithLength);
-			}
-		} elseif ($share->getShareType() === IShare::TYPE_ROOM) {
-			$result['share_with'] = $share->getSharedWith();
-			$result['share_with_displayname'] = '';
-
-			try {
-				/** @var array{share_with_displayname: string, share_with_link: string, share_with?: string, token?: string} $roomShare */
-				$roomShare = $this->getRoomShareHelper()->formatShare($share);
-				$result = array_merge($result, $roomShare);
-			} catch (ContainerExceptionInterface $e) {
-			}
-		} elseif ($share->getShareType() === IShare::TYPE_DECK) {
-			$result['share_with'] = $share->getSharedWith();
-			$result['share_with_displayname'] = '';
-
-			try {
-				/** @var array{share_with: string, share_with_displayname: string, share_with_link: string} $deckShare */
-				$deckShare = $this->getDeckShareHelper()->formatShare($share);
-				$result = array_merge($result, $deckShare);
-			} catch (ContainerExceptionInterface $e) {
-			}
-		} elseif ($share->getShareType() === IShare::TYPE_SCIENCEMESH) {
-			$result['share_with'] = $share->getSharedWith();
-			$result['share_with_displayname'] = '';
-
-			try {
-				/** @var array{share_with: string, share_with_displayname: string, token: string} $scienceMeshShare */
-				$scienceMeshShare = $this->getSciencemeshShareHelper()->formatShare($share);
-				$result = array_merge($result, $scienceMeshShare);
-			} catch (ContainerExceptionInterface $e) {
-			}
-		}
-
-
-		$result['mail_send'] = $share->getMailSend() ? 1 : 0;
-		$result['hide_download'] = $share->getHideDownload() ? 1 : 0;
-
-		$result['attributes'] = null;
-		if ($attributes = $share->getAttributes()) {
-			$result['attributes'] = (string)\json_encode($attributes->toArray());
-		}
-
-		return $result;
-	}
-
-	/**
-	 * Check if one of the users address books knows the exact property, if
-	 * not we return the full name.
-	 *
-	 * @param string $query
-	 * @param string $property
-	 * @return string
-	 */
-	private function getDisplayNameFromAddressBook(string $query, string $property): string {
-		// FIXME: If we inject the contacts manager it gets initialized before any address books are registered
-		try {
-			$result = Server::get(\OCP\Contacts\IManager::class)->search($query, [$property], [
-				'limit' => 1,
-				'enumeration' => false,
-				'strict_search' => true,
-			]);
-		} catch (Exception $e) {
-			$this->logger->error(
-				$e->getMessage(),
-				['exception' => $e]
-			);
-			return $query;
-		}
-
-		foreach ($result as $r) {
-			foreach ($r[$property] as $value) {
-				if ($value === $query && $r['FN']) {
-					return $r['FN'];
-				}
-			}
-		}
-
-		return $query;
-	}
-
-
-	/**
-	 * @param list<Files_SharingShare> $shares
-	 * @param array<string, string>|null $updatedDisplayName
-	 *
-	 * @return list<Files_SharingShare>
-	 */
-	private function fixMissingDisplayName(array $shares, ?array $updatedDisplayName = null): array {
-		$userIds = $updated = [];
-		foreach ($shares as $share) {
-			// share is federated and share have no display name yet
-			if ($share['share_type'] === IShare::TYPE_REMOTE
-				&& ($share['share_with'] ?? '') !== ''
-				&& ($share['share_with_displayname'] ?? '') === '') {
-				$userIds[] = $userId = $share['share_with'];
-
-				if ($updatedDisplayName !== null && array_key_exists($userId, $updatedDisplayName)) {
-					$share['share_with_displayname'] = $updatedDisplayName[$userId];
-				}
-			}
-
-			// prepping userIds with displayName to be updated
-			$updated[] = $share;
-		}
-
-		// if $updatedDisplayName is not null, it means we should have already fixed displayNames of the shares
-		if ($updatedDisplayName !== null) {
-			return $updated;
-		}
-
-		// get displayName for the generated list of userId with no displayName
-		$displayNames = $this->retrieveFederatedDisplayName($userIds);
-
-		// if no displayName are updated, we exit
-		if (empty($displayNames)) {
-			return $updated;
-		}
-
-		// let's fix missing display name and returns all shares
-		return $this->fixMissingDisplayName($shares, $displayNames);
-	}
-
-
-	/**
-	 * get displayName of a list of userIds from the lookup-server; through the globalsiteselector app.
-	 * returns an array with userIds as keys and displayName as values.
-	 *
-	 * @param array $userIds
-	 * @param bool $cacheOnly - do not reach LUS, get data from cache.
-	 *
-	 * @return array
-	 * @throws ContainerExceptionInterface
-	 */
-	private function retrieveFederatedDisplayName(array $userIds, bool $cacheOnly = false): array {
-		// check if gss is enabled and available
-		if (count($userIds) === 0
-			|| !$this->appManager->isEnabledForAnyone('globalsiteselector')
-			|| !class_exists('\OCA\GlobalSiteSelector\Service\SlaveService')) {
-			return [];
-		}
-
-		try {
-			$slaveService = Server::get(SlaveService::class);
-		} catch (\Throwable $e) {
-			$this->logger->error(
-				$e->getMessage(),
-				['exception' => $e]
-			);
-			return [];
-		}
-
-		return $slaveService->getUsersDisplayName($userIds, $cacheOnly);
-	}
-
-
-	/**
-	 * retrieve displayName from cache if available (should be used on federated shares)
-	 * if not available in cache/lus, try for get from address-book, else returns empty string.
-	 *
-	 * @param string $userId
-	 * @param bool $cacheOnly if true will not reach the lus but will only get data from cache
-	 *
-	 * @return string
-	 */
-	private function getCachedFederatedDisplayName(string $userId, bool $cacheOnly = true): string {
-		$details = $this->retrieveFederatedDisplayName([$userId], $cacheOnly);
-		if (array_key_exists($userId, $details)) {
-			return $details[$userId];
-		}
-
-		$displayName = $this->getDisplayNameFromAddressBook($userId, 'CLOUD');
-		return ($displayName === $userId) ? '' : $displayName;
-	}
-
-
-
-	/**
-	 * Get a specific share by id
-	 *
-	 * @param string $id ID of the share
-	 * @param bool $include_tags Include tags in the share
-	 * @return DataResponse<Http::STATUS_OK, list<Files_SharingShare>, array{}>
-	 * @throws OCSNotFoundException Share not found
-	 *
-	 * 200: Share returned
-	 */
-	#[NoAdminRequired]
-	public function getShare(string $id, bool $include_tags = false): DataResponse {
-		try {
-			$share = $this->getShareById($id);
-		} catch (ShareNotFound $e) {
-			throw new OCSNotFoundException($this->l->t('Wrong share ID, share does not exist'));
-		}
-
-		try {
-			if ($this->canAccessShare($share)) {
-				$share = $this->formatShare($share);
-
-				if ($include_tags) {
-					$share = Helper::populateTags([$share], Server::get(ITagManager::class));
-				} else {
-					$share = [$share];
-				}
-
-				return new DataResponse($share);
-			}
-		} catch (NotFoundException $e) {
-			// Fall through
-		}
-
-		throw new OCSNotFoundException($this->l->t('Wrong share ID, share does not exist'));
-	}
-
-	/**
-	 * Delete a share
-	 *
-	 * @param string $id ID of the share
-	 * @return DataResponse<Http::STATUS_OK, list<empty>, array{}>
-	 * @throws OCSNotFoundException Share not found
-	 * @throws OCSForbiddenException Missing permissions to delete the share
-	 *
-	 * 200: Share deleted successfully
-	 */
-	#[NoAdminRequired]
-	public function deleteShare(string $id): DataResponse {
-		try {
-			$share = $this->getShareById($id);
-		} catch (ShareNotFound $e) {
-			throw new OCSNotFoundException($this->l->t('Wrong share ID, share does not exist'));
-		}
-
-		try {
-			$this->lock($share->getNode());
-		} catch (LockedException $e) {
-			throw new OCSNotFoundException($this->l->t('Could not delete share'));
-		}
-
-		if (!$this->canAccessShare($share)) {
-			throw new OCSNotFoundException($this->l->t('Wrong share ID, share does not exist'));
-		}
-
-		// if it's a group share or a room share
-		// we don't delete the share, but only the
-		// mount point. Allowing it to be restored
-		// from the deleted shares
-		if ($this->canDeleteShareFromSelf($share)) {
-			$this->shareManager->deleteFromSelf($share, $this->userId);
-		} else {
-			if (!$this->canDeleteShare($share)) {
-				throw new OCSForbiddenException($this->l->t('Could not delete share'));
-			}
-
-			$this->shareManager->deleteShare($share);
-		}
-
-		return new DataResponse();
-	}
-
-	/**
-	 * Create a share
-	 *
-	 * @param string|null $path Path of the share
-	 * @param int|null $permissions Permissions for the share
-	 * @param int $shareType Type of the share
-	 * @param ?string $shareWith The entity this should be shared with
-	 * @param 'true'|'false'|null $publicUpload If public uploading is allowed (deprecated)
-	 * @param string $password Password for the share
-	 * @param string|null $sendPasswordByTalk Send the password for the share over Talk
-	 * @param ?string $expireDate The expiry date of the share in the user's timezone at 00:00.
-	 *                            If $expireDate is not supplied or set to `null`, the system default will be used.
-	 * @param string $note Note for the share
-	 * @param string $label Label for the share (only used in link and email)
-	 * @param string|null $attributes Additional attributes for the share
-	 * @param 'false'|'true'|null $sendMail Send a mail to the recipient
-	 *
-	 * @return DataResponse<Http::STATUS_OK, Files_SharingShare, array{}>
-	 * @throws OCSBadRequestException Unknown share type
-	 * @throws OCSException
-	 * @throws OCSForbiddenException Creating the share is not allowed
-	 * @throws OCSNotFoundException Creating the share failed
-	 * @suppress PhanUndeclaredClassMethod
-	 *
-	 * 200: Share created
-	 */
-	#[NoAdminRequired]
-	#[UserRateLimit(limit: 20, period: 600)]
-	public function createShare(
-		?string $path = null,
-		?int $permissions = null,
-		int $shareType = -1,
-		?string $shareWith = null,
-		?string $publicUpload = null,
-		string $password = '',
-		?string $sendPasswordByTalk = null,
-		?string $expireDate = null,
-		string $note = '',
-		string $label = '',
-		?string $attributes = null,
-		?string $sendMail = null,
-	): DataResponse {
-		assert($this->userId !== null);
-
-		$share = $this->shareManager->newShare();
-		$hasPublicUpload = $this->getLegacyPublicUpload($publicUpload);
-
-		// Verify path
-		if ($path === null) {
-			throw new OCSNotFoundException($this->l->t('Please specify a file or folder path'));
-		}
-
-		$userFolder = $this->rootFolder->getUserFolder($this->userId);
-		try {
-			/** @var \OC\Files\Node\Node $node */
-			$node = $userFolder->get($path);
-		} catch (NotFoundException $e) {
-			throw new OCSNotFoundException($this->l->t('Wrong path, file/folder does not exist'));
-		}
-
-		// a user can have access to a file through different paths, with differing permissions
-		// combine all permissions to determine if the user can share this file
-		$nodes = $userFolder->getById($node->getId());
-		foreach ($nodes as $nodeById) {
-			/** @var \OC\Files\FileInfo $fileInfo */
-			$fileInfo = $node->getFileInfo();
-			$fileInfo['permissions'] |= $nodeById->getPermissions();
-		}
-
-		$share->setNode($node);
-
-		try {
-			$this->lock($share->getNode());
-		} catch (LockedException $e) {
-			throw new OCSNotFoundException($this->l->t('Could not create share'));
-		}
-
-		// Set permissions
-		if ($shareType === IShare::TYPE_LINK || $shareType === IShare::TYPE_EMAIL) {
-			$permissions = $this->getLinkSharePermissions($permissions, $hasPublicUpload);
-			$this->validateLinkSharePermissions($node, $permissions, $hasPublicUpload);
-		} else {
-			// Use default permissions only for non-link shares to keep legacy behavior
-			if ($permissions === null) {
-				$permissions = (int)$this->config->getAppValue('core', 'shareapi_default_permissions', (string)Constants::PERMISSION_ALL);
-			}
-			// Non-link shares always require read permissions (link shares could be file drop)
-			$permissions |= Constants::PERMISSION_READ;
-		}
-
-		// For legacy reasons the API allows to pass PERMISSIONS_ALL even for single file shares (I look at you Talk)
-		if ($node instanceof File) {
-			// if this is a single file share we remove the DELETE and CREATE permissions
-			$permissions = $permissions & ~(Constants::PERMISSION_DELETE | Constants::PERMISSION_CREATE);
-		}
-
-		/**
-		 * Hack for https://github.com/owncloud/core/issues/22587
-		 * We check the permissions via webdav. But the permissions of the mount point
-		 * do not equal the share permissions. Here we fix that for federated mounts.
-		 */
-		if ($node->getStorage()->instanceOfStorage(Storage::class)) {
-			$permissions &= ~($permissions & ~$node->getPermissions());
-		}
-
-		if ($attributes !== null) {
-			$share = $this->setShareAttributes($share, $attributes);
-		}
-
-		// Expire date checks
-		// Normally, null means no expiration date but we still set the default for backwards compatibility
-		// If the client sends an empty string, we set noExpirationDate to true
-		if ($expireDate !== null) {
-			if ($expireDate !== '') {
-				try {
-					$expireDateTime = $this->parseDate($expireDate);
-					$share->setExpirationDate($expireDateTime);
-				} catch (\Exception $e) {
-					throw new OCSNotFoundException($e->getMessage(), $e);
-				}
-			} else {
-				// Client sent empty string for expire date.
-				// Set noExpirationDate to true so overwrite is prevented.
-				$share->setNoExpirationDate(true);
-			}
-		}
-
-		$share->setSharedBy($this->userId);
-
-		// Handle mail send
-		if (is_null($sendMail)) {
-			$allowSendMail = $this->config->getSystemValueBool('sharing.enable_share_mail', true);
-			if ($allowSendMail !== true || $shareType === IShare::TYPE_EMAIL) {
-				// Define a default behavior when sendMail is not provided
-				// For email shares with a valid recipient, the default is to send the mail
-				// For all other share types, the default is to not send the mail
-				$allowSendMail = ($shareType === IShare::TYPE_EMAIL && $shareWith !== null && $shareWith !== '');
-			}
-			$share->setMailSend($allowSendMail);
-		} else {
-			$share->setMailSend($sendMail === 'true');
-		}
-
-		if ($shareType === IShare::TYPE_USER) {
-			// Valid user is required to share
-			if ($shareWith === null || !$this->userManager->userExists($shareWith)) {
-				throw new OCSNotFoundException($this->l->t('Please specify a valid account to share with'));
-			}
-			$share->setSharedWith($shareWith);
-			$share->setPermissions($permissions);
-		} elseif ($shareType === IShare::TYPE_GROUP) {
-			if (!$this->shareManager->allowGroupSharing()) {
-				throw new OCSNotFoundException($this->l->t('Group sharing is disabled by the administrator'));
-			}
-
-			// Valid group is required to share
-			if ($shareWith === null || !$this->groupManager->groupExists($shareWith)) {
-				throw new OCSNotFoundException($this->l->t('Please specify a valid group'));
-			}
-			$share->setSharedWith($shareWith);
-			$share->setPermissions($permissions);
-		} elseif ($shareType === IShare::TYPE_LINK
-			|| $shareType === IShare::TYPE_EMAIL) {
-
-			// Can we even share links?
-			if (!$this->shareManager->shareApiAllowLinks()) {
-				throw new OCSNotFoundException($this->l->t('Public link sharing is disabled by the administrator'));
-			}
-
-			$this->validateLinkSharePermissions($node, $permissions, $hasPublicUpload);
-			$share->setPermissions($permissions);
-
-			// Set password
-			if ($password !== '') {
-				$share->setPassword($password);
-			}
-
-			// Only share by mail have a recipient
-			if (is_string($shareWith) && $shareType === IShare::TYPE_EMAIL) {
-				// If sending a mail have been requested, validate the mail address
-				if ($share->getMailSend() && !$this->mailer->validateMailAddress($shareWith)) {
-					throw new OCSNotFoundException($this->l->t('Please specify a valid email address'));
-				}
-				$share->setSharedWith($shareWith);
-			}
-
-			// If we have a label, use it
-			if ($label !== '') {
-				if (strlen($label) > 255) {
-					throw new OCSBadRequestException('Maximum label length is 255');
-				}
-				$share->setLabel($label);
-			}
-
-			if ($sendPasswordByTalk === 'true') {
-				if (!$this->appManager->isEnabledForUser('spreed')) {
-					throw new OCSForbiddenException($this->l->t('Sharing %s sending the password by Nextcloud Talk failed because Nextcloud Talk is not enabled', [$node->getPath()]));
-				}
-
-				$share->setSendPasswordByTalk(true);
-			}
-		} elseif ($shareType === IShare::TYPE_REMOTE) {
-			if (!$this->shareManager->outgoingServer2ServerSharesAllowed()) {
-				throw new OCSForbiddenException($this->l->t('Sharing %1$s failed because the back end does not allow shares from type %2$s', [$node->getPath(), $shareType]));
-			}
-
-			if ($shareWith === null) {
-				throw new OCSNotFoundException($this->l->t('Please specify a valid federated account ID'));
-			}
-
-			$share->setSharedWith($shareWith);
-			$share->setPermissions($permissions);
-			$share->setSharedWithDisplayName($this->getCachedFederatedDisplayName($shareWith, false));
-		} elseif ($shareType === IShare::TYPE_REMOTE_GROUP) {
-			if (!$this->shareManager->outgoingServer2ServerGroupSharesAllowed()) {
-				throw new OCSForbiddenException($this->l->t('Sharing %1$s failed because the back end does not allow shares from type %2$s', [$node->getPath(), $shareType]));
-			}
-
-			if ($shareWith === null) {
-				throw new OCSNotFoundException($this->l->t('Please specify a valid federated group ID'));
-			}
-
-			$share->setSharedWith($shareWith);
-			$share->setPermissions($permissions);
-		} elseif ($shareType === IShare::TYPE_CIRCLE) {
-			if (!Server::get(IAppManager::class)->isEnabledForUser('circles') || !class_exists('\OCA\Circles\ShareByCircleProvider')) {
-				throw new OCSNotFoundException($this->l->t('You cannot share to a Team if the app is not enabled'));
-			}
-
-			$circle = Circles::detailsCircle($shareWith);
-
-			// Valid team is required to share
-			if ($circle === null) {
-				throw new OCSNotFoundException($this->l->t('Please specify a valid team'));
-			}
-			$share->setSharedWith($shareWith);
-			$share->setPermissions($permissions);
-		} elseif ($shareType === IShare::TYPE_ROOM) {
-			try {
-				$this->getRoomShareHelper()->createShare($share, $shareWith, $permissions, $expireDate ?? '');
-			} catch (ContainerExceptionInterface $e) {
-				throw new OCSForbiddenException($this->l->t('Sharing %s failed because the back end does not support room shares', [$node->getPath()]));
-			}
-		} elseif ($shareType === IShare::TYPE_DECK) {
-			try {
-				$this->getDeckShareHelper()->createShare($share, $shareWith, $permissions, $expireDate ?? '');
-			} catch (ContainerExceptionInterface $e) {
-				throw new OCSForbiddenException($this->l->t('Sharing %s failed because the back end does not support room shares', [$node->getPath()]));
-			}
-		} elseif ($shareType === IShare::TYPE_SCIENCEMESH) {
-			try {
-				$this->getSciencemeshShareHelper()->createShare($share, $shareWith, $permissions, $expireDate ?? '');
-			} catch (ContainerExceptionInterface $e) {
-				throw new OCSForbiddenException($this->l->t('Sharing %s failed because the back end does not support ScienceMesh shares', [$node->getPath()]));
-			}
-		} else {
-			throw new OCSBadRequestException($this->l->t('Unknown share type'));
-		}
-
-		$share->setShareType($shareType);
-		$this->checkInheritedAttributes($share);
-
-		if ($note !== '') {
-			$share->setNote($note);
-		}
-
-		try {
-			$share = $this->shareManager->createShare($share);
-		} catch (HintException $e) {
-			$code = $e->getCode() === 0 ? 403 : $e->getCode();
-			throw new OCSException($e->getHint(), $code);
-		} catch (GenericShareException|\InvalidArgumentException $e) {
-			$this->logger->error($e->getMessage(), ['exception' => $e]);
-			throw new OCSForbiddenException($e->getMessage(), $e);
-		} catch (\Exception $e) {
-			$this->logger->error($e->getMessage(), ['exception' => $e]);
-			throw new OCSForbiddenException('Failed to create share.', $e);
-		}
-
-		$output = $this->formatShare($share);
-
-		return new DataResponse($output);
-	}
-
-	/**
-	 * @param null|Node $node
-	 * @param boolean $includeTags
-	 *
-	 * @return list<Files_SharingShare>
-	 */
-	private function getSharedWithMe($node, bool $includeTags): array {
-		$userShares = $this->shareManager->getSharedWith($this->userId, IShare::TYPE_USER, $node, -1, 0);
-		$groupShares = $this->shareManager->getSharedWith($this->userId, IShare::TYPE_GROUP, $node, -1, 0);
-		$circleShares = $this->shareManager->getSharedWith($this->userId, IShare::TYPE_CIRCLE, $node, -1, 0);
-		$roomShares = $this->shareManager->getSharedWith($this->userId, IShare::TYPE_ROOM, $node, -1, 0);
-		$deckShares = $this->shareManager->getSharedWith($this->userId, IShare::TYPE_DECK, $node, -1, 0);
-		$sciencemeshShares = $this->shareManager->getSharedWith($this->userId, IShare::TYPE_SCIENCEMESH, $node, -1, 0);
-
-		$shares = array_merge($userShares, $groupShares, $circleShares, $roomShares, $deckShares, $sciencemeshShares);
-
-		$filteredShares = array_filter($shares, function (IShare $share) {
-			return $share->getShareOwner() !== $this->userId;
-		});
-
-		$formatted = [];
-		foreach ($filteredShares as $share) {
-			if ($this->canAccessShare($share)) {
-				try {
-					$formatted[] = $this->formatShare($share);
-				} catch (NotFoundException $e) {
-					// Ignore this share
-				}
-			}
-		}
-
-		if ($includeTags) {
-			$formatted = Helper::populateTags($formatted, Server::get(ITagManager::class));
-		}
-
-		return $formatted;
-	}
-
-	/**
-	 * @param Node $folder
-	 *
-	 * @return list<Files_SharingShare>
-	 * @throws OCSBadRequestException
-	 * @throws NotFoundException
-	 */
-	private function getSharesInDir(Node $folder): array {
-		if (!($folder instanceof Folder)) {
-			throw new OCSBadRequestException($this->l->t('Not a directory'));
-		}
-
-		$nodes = $folder->getDirectoryListing();
-
-		/** @var IShare[] $shares */
-		$shares = array_reduce($nodes, function ($carry, $node) {
-			$carry = array_merge($carry, $this->getAllShares($node, true));
-			return $carry;
-		}, []);
-
-		// filter out duplicate shares
-		$known = [];
-
-		$formatted = $miniFormatted = [];
-		$resharingRight = false;
-		$known = [];
-		foreach ($shares as $share) {
-			if (in_array($share->getId(), $known) || $share->getSharedWith() === $this->userId) {
-				continue;
-			}
-
-			try {
-				$format = $this->formatShare($share);
-
-				$known[] = $share->getId();
-				$formatted[] = $format;
-				if ($share->getSharedBy() === $this->userId) {
-					$miniFormatted[] = $format;
-				}
-				if (!$resharingRight && $this->shareProviderResharingRights($this->userId, $share, $folder)) {
-					$resharingRight = true;
-				}
-			} catch (\Exception $e) {
-				//Ignore this share
-			}
-		}
-
-		if (!$resharingRight) {
-			$formatted = $miniFormatted;
-		}
-
-		return $formatted;
-	}
-
-	/**
-	 * Get shares of the current user
-	 *
-	 * @param string $shared_with_me Only get shares with the current user
-	 * @param string $reshares Only get shares by the current user and reshares
-	 * @param string $subfiles Only get all shares in a folder
-	 * @param string $path Get shares for a specific path
-	 * @param string $include_tags Include tags in the share
-	 *
-	 * @return DataResponse<Http::STATUS_OK, list<Files_SharingShare>, array{}>
-	 * @throws OCSNotFoundException The folder was not found or is inaccessible
-	 *
-	 * 200: Shares returned
-	 */
-	#[NoAdminRequired]
-	public function getShares(
-		string $shared_with_me = 'false',
-		string $reshares = 'false',
-		string $subfiles = 'false',
-		string $path = '',
-		string $include_tags = 'false',
-	): DataResponse {
-		$node = null;
-		if ($path !== '') {
-			$userFolder = $this->rootFolder->getUserFolder($this->userId);
-			try {
-				$node = $userFolder->get($path);
-				$this->lock($node);
-			} catch (NotFoundException $e) {
-				throw new OCSNotFoundException(
-					$this->l->t('Wrong path, file/folder does not exist')
-				);
-			} catch (LockedException $e) {
-				throw new OCSNotFoundException($this->l->t('Could not lock node'));
-			}
-		}
-
-		$shares = $this->getFormattedShares(
-			$this->userId,
-			$node,
-			($shared_with_me === 'true'),
-			($reshares === 'true'),
-			($subfiles === 'true'),
-			($include_tags === 'true')
-		);
-
-		return new DataResponse($shares);
-	}
-
-	private function getLinkSharePermissions(?int $permissions, ?bool $legacyPublicUpload): int {
-		$permissions = $permissions ?? Constants::PERMISSION_READ;
-
-		// Legacy option handling
-		if ($legacyPublicUpload !== null) {
-			$permissions = $legacyPublicUpload
-				? (Constants::PERMISSION_READ | Constants::PERMISSION_CREATE | Constants::PERMISSION_UPDATE | Constants::PERMISSION_DELETE)
-				: Constants::PERMISSION_READ;
-		}
-
-		// TODO: It might make sense to have a dedicated setting to allow/deny converting link shares into federated ones
-		if ($this->hasPermission($permissions, Constants::PERMISSION_READ)
-			&& $this->shareManager->outgoingServer2ServerSharesAllowed()) {
-			$permissions |= Constants::PERMISSION_SHARE;
-		}
-
-		return $permissions;
-	}
-
-	/**
-	 * Helper to check for legacy "publicUpload" handling.
-	 * If the value is set to `true` or `false` then true or false are returned.
-	 * Otherwise null is returned to indicate that the option was not (or wrong) set.
-	 *
-	 * @param null|string $legacyPublicUpload The value of `publicUpload`
-	 */
-	private function getLegacyPublicUpload(?string $legacyPublicUpload): ?bool {
-		if ($legacyPublicUpload === 'true') {
-			return true;
-		} elseif ($legacyPublicUpload === 'false') {
-			return false;
-		}
-		// Not set at all
-		return null;
-	}
-
-	/**
-	 * For link and email shares validate that only allowed combinations are set.
-	 *
-	 * @throw OCSBadRequestException If permission combination is invalid.
-	 * @throw OCSForbiddenException If public upload was forbidden by the administrator.
-	 */
-	private function validateLinkSharePermissions(Node $node, int $permissions, ?bool $legacyPublicUpload): void {
-		if ($legacyPublicUpload && ($node instanceof File)) {
-			throw new OCSBadRequestException($this->l->t('Public upload is only possible for publicly shared folders'));
-		}
-
-		// We need at least READ or CREATE (file drop)
-		if (!$this->hasPermission($permissions, Constants::PERMISSION_READ)
-			&& !$this->hasPermission($permissions, Constants::PERMISSION_CREATE)) {
-			throw new OCSBadRequestException($this->l->t('Share must at least have READ or CREATE permissions'));
-		}
-
-		// UPDATE and DELETE require a READ permission
-		if (!$this->hasPermission($permissions, Constants::PERMISSION_READ)
-			&& ($this->hasPermission($permissions, Constants::PERMISSION_UPDATE) || $this->hasPermission($permissions, Constants::PERMISSION_DELETE))) {
-			throw new OCSBadRequestException($this->l->t('Share must have READ permission if UPDATE or DELETE permission is set'));
-		}
-
-		// Check if public uploading was disabled
-		if ($this->hasPermission($permissions, Constants::PERMISSION_CREATE)
-			&& !$this->shareManager->shareApiLinkAllowPublicUpload()) {
-			throw new OCSForbiddenException($this->l->t('Public upload disabled by the administrator'));
-		}
-	}
-
-	/**
-	 * @param string $viewer
-	 * @param Node $node
-	 * @param bool $sharedWithMe
-	 * @param bool $reShares
-	 * @param bool $subFiles
-	 * @param bool $includeTags
-	 *
-	 * @return list<Files_SharingShare>
-	 * @throws NotFoundException
-	 * @throws OCSBadRequestException
-	 */
-	private function getFormattedShares(
-		string $viewer,
-		$node = null,
-		bool $sharedWithMe = false,
-		bool $reShares = false,
-		bool $subFiles = false,
-		bool $includeTags = false,
-	): array {
-		if ($sharedWithMe) {
-			return $this->getSharedWithMe($node, $includeTags);
-		}
-
-		if ($subFiles) {
-			return $this->getSharesInDir($node);
-		}
-
-		$shares = $this->getSharesFromNode($viewer, $node, $reShares);
-
-		$known = $formatted = $miniFormatted = [];
-		$resharingRight = false;
-		foreach ($shares as $share) {
-			try {
-				$share->getNode();
-			} catch (NotFoundException $e) {
-				/*
+    private ?Node $lockedNode = null;
+
+    /**
+     * Share20OCS constructor.
+     */
+    public function __construct(
+        string $appName,
+        IRequest $request,
+        private IManager $shareManager,
+        private IGroupManager $groupManager,
+        private IUserManager $userManager,
+        private IRootFolder $rootFolder,
+        private IURLGenerator $urlGenerator,
+        private IL10N $l,
+        private IConfig $config,
+        private IAppManager $appManager,
+        private ContainerInterface $serverContainer,
+        private IUserStatusManager $userStatusManager,
+        private IPreview $previewManager,
+        private IDateTimeZone $dateTimeZone,
+        private LoggerInterface $logger,
+        private IProviderFactory $factory,
+        private IMailer $mailer,
+        private ?string $userId = null,
+    ) {
+        parent::__construct($appName, $request);
+    }
+
+    /**
+     * Convert an IShare to an array for OCS output
+     *
+     * @param IShare $share
+     * @param Node|null $recipientNode
+     * @return Files_SharingShare
+     * @throws NotFoundException In case the node can't be resolved.
+     *
+     * @suppress PhanUndeclaredClassMethod
+     */
+    protected function formatShare(IShare $share, ?Node $recipientNode = null): array {
+        $sharedBy = $this->userManager->get($share->getSharedBy());
+        $shareOwner = $this->userManager->get($share->getShareOwner());
+
+        $isOwnShare = false;
+        if ($shareOwner !== null) {
+            $isOwnShare = $shareOwner->getUID() === $this->userId;
+        }
+
+        $result = [
+            'id' => $share->getId(),
+            'share_type' => $share->getShareType(),
+            'uid_owner' => $share->getSharedBy(),
+            'displayname_owner' => $sharedBy !== null ? $sharedBy->getDisplayName() : $share->getSharedBy(),
+            // recipient permissions
+            'permissions' => $share->getPermissions(),
+            // current user permissions on this share
+            'can_edit' => $this->canEditShare($share),
+            'can_delete' => $this->canDeleteShare($share),
+            'stime' => $share->getShareTime()->getTimestamp(),
+            'parent' => null,
+            'expiration' => null,
+            'token' => null,
+            'uid_file_owner' => $share->getShareOwner(),
+            'note' => $share->getNote(),
+            'label' => $share->getLabel(),
+            'displayname_file_owner' => $shareOwner !== null ? $shareOwner->getDisplayName() : $share->getShareOwner(),
+        ];
+
+        $userFolder = $this->rootFolder->getUserFolder($this->userId);
+        if ($recipientNode) {
+            $node = $recipientNode;
+        } else {
+            $node = $userFolder->getFirstNodeById($share->getNodeId());
+            if (!$node) {
+                // fallback to guessing the path
+                $node = $userFolder->get($share->getTarget());
+                if ($node === null || $share->getTarget() === '') {
+                    throw new NotFoundException();
+                }
+            }
+        }
+
+        $result['path'] = $userFolder->getRelativePath($node->getPath());
+        if ($node instanceof Folder) {
+            $result['item_type'] = 'folder';
+        } else {
+            $result['item_type'] = 'file';
+        }
+
+        // Get the original node permission if the share owner is the current user
+        if ($isOwnShare) {
+            $result['item_permissions'] = $node->getPermissions();
+        }
+
+        // If we're on the recipient side, the node permissions
+        // are bound to the share permissions. So we need to
+        // adjust the permissions to the share permissions if necessary.
+        if (!$isOwnShare) {
+            $result['item_permissions'] = $share->getPermissions();
+
+            // For some reason, single files share are forbidden to have the delete permission
+            // since we have custom methods to check those, let's adjust straight away.
+            // DAV permissions does not have that issue though.
+            if ($this->canDeleteShare($share) || $this->canDeleteShareFromSelf($share)) {
+                $result['item_permissions'] |= Constants::PERMISSION_DELETE;
+            }
+            if ($this->canEditShare($share)) {
+                $result['item_permissions'] |= Constants::PERMISSION_UPDATE;
+            }
+        }
+
+        // See MOUNT_ROOT_PROPERTYNAME dav property
+        $result['is-mount-root'] = $node->getInternalPath() === '';
+        $result['mount-type'] = $node->getMountPoint()->getMountType();
+
+        $result['mimetype'] = $node->getMimetype();
+        $result['has_preview'] = $this->previewManager->isAvailable($node);
+        $result['storage_id'] = $node->getStorage()->getId();
+        $result['storage'] = $node->getStorage()->getCache()->getNumericStorageId();
+        $result['item_source'] = $node->getId();
+        $result['file_source'] = $node->getId();
+        $result['file_parent'] = $node->getParent()->getId();
+        $result['file_target'] = $share->getTarget();
+        $result['item_size'] = $node->getSize();
+        $result['item_mtime'] = $node->getMTime();
+
+        $expiration = $share->getExpirationDate();
+        if ($expiration !== null) {
+            $expiration->setTimezone($this->dateTimeZone->getTimeZone());
+            $result['expiration'] = $expiration->format('Y-m-d 00:00:00');
+        }
+
+        if ($share->getShareType() === IShare::TYPE_USER) {
+            $sharedWith = $this->userManager->get($share->getSharedWith());
+            $result['share_with'] = $share->getSharedWith();
+            $result['share_with_displayname'] = $sharedWith !== null ? $sharedWith->getDisplayName() : $share->getSharedWith();
+            $result['share_with_displayname_unique'] = $sharedWith !== null ? (
+                !empty($sharedWith->getSystemEMailAddress()) ? $sharedWith->getSystemEMailAddress() : $sharedWith->getUID()
+            ) : $share->getSharedWith();
+
+            $userStatuses = $this->userStatusManager->getUserStatuses([$share->getSharedWith()]);
+            $userStatus = array_shift($userStatuses);
+            if ($userStatus) {
+                $result['status'] = [
+                    'status' => $userStatus->getStatus(),
+                    'message' => $userStatus->getMessage(),
+                    'icon' => $userStatus->getIcon(),
+                    'clearAt' => $userStatus->getClearAt()
+                        ? (int)$userStatus->getClearAt()->format('U')
+                        : null,
+                ];
+            }
+        } elseif ($share->getShareType() === IShare::TYPE_GROUP) {
+            $group = $this->groupManager->get($share->getSharedWith());
+            $result['share_with'] = $share->getSharedWith();
+            $result['share_with_displayname'] = $group !== null ? $group->getDisplayName() : $share->getSharedWith();
+        } elseif ($share->getShareType() === IShare::TYPE_LINK) {
+
+            // "share_with" and "share_with_displayname" for passwords of link
+            // shares was deprecated in Nextcloud 15, use "password" instead.
+            $result['share_with'] = $share->getPassword();
+            $result['share_with_displayname'] = '(' . $this->l->t('Shared link') . ')';
+
+            $result['password'] = $share->getPassword();
+
+            $result['send_password_by_talk'] = $share->getSendPasswordByTalk();
+
+            $result['token'] = $share->getToken();
+            $result['url'] = $this->urlGenerator->linkToRouteAbsolute('files_sharing.sharecontroller.showShare', ['token' => $share->getToken()]);
+        } elseif ($share->getShareType() === IShare::TYPE_REMOTE) {
+            $result['share_with'] = $share->getSharedWith();
+            $result['share_with_displayname'] = $this->getCachedFederatedDisplayName($share->getSharedWith());
+            $result['token'] = $share->getToken();
+        } elseif ($share->getShareType() === IShare::TYPE_REMOTE_GROUP) {
+            $result['share_with'] = $share->getSharedWith();
+            $result['share_with_displayname'] = $this->getDisplayNameFromAddressBook($share->getSharedWith(), 'CLOUD');
+            $result['token'] = $share->getToken();
+        } elseif ($share->getShareType() === IShare::TYPE_EMAIL) {
+            $result['share_with'] = $share->getSharedWith();
+            $result['password'] = $share->getPassword();
+            $result['password_expiration_time'] = $share->getPasswordExpirationTime() !== null ? $share->getPasswordExpirationTime()->format(\DateTime::ATOM) : null;
+            $result['send_password_by_talk'] = $share->getSendPasswordByTalk();
+            $result['share_with_displayname'] = $this->getDisplayNameFromAddressBook($share->getSharedWith(), 'EMAIL');
+            $result['token'] = $share->getToken();
+        } elseif ($share->getShareType() === IShare::TYPE_CIRCLE) {
+            // getSharedWith() returns either "name (type, owner)" or
+            // "name (type, owner) [id]", depending on the Teams app version.
+            $hasCircleId = (substr($share->getSharedWith(), -1) === ']');
+
+            $result['share_with_displayname'] = $share->getSharedWithDisplayName();
+            if (empty($result['share_with_displayname'])) {
+                $displayNameLength = ($hasCircleId ? strrpos($share->getSharedWith(), ' ') : strlen($share->getSharedWith()));
+                $result['share_with_displayname'] = substr($share->getSharedWith(), 0, $displayNameLength);
+            }
+
+            $result['share_with_avatar'] = $share->getSharedWithAvatar();
+
+            $shareWithStart = ($hasCircleId ? strrpos($share->getSharedWith(), '[') + 1 : 0);
+            $shareWithLength = ($hasCircleId ? -1 : strpos($share->getSharedWith(), ' '));
+            if ($shareWithLength === false) {
+                $result['share_with'] = substr($share->getSharedWith(), $shareWithStart);
+            } else {
+                $result['share_with'] = substr($share->getSharedWith(), $shareWithStart, $shareWithLength);
+            }
+        } elseif ($share->getShareType() === IShare::TYPE_ROOM) {
+            $result['share_with'] = $share->getSharedWith();
+            $result['share_with_displayname'] = '';
+
+            try {
+                /** @var array{share_with_displayname: string, share_with_link: string, share_with?: string, token?: string} $roomShare */
+                $roomShare = $this->getRoomShareHelper()->formatShare($share);
+                $result = array_merge($result, $roomShare);
+            } catch (ContainerExceptionInterface $e) {
+            }
+        } elseif ($share->getShareType() === IShare::TYPE_DECK) {
+            $result['share_with'] = $share->getSharedWith();
+            $result['share_with_displayname'] = '';
+
+            try {
+                /** @var array{share_with: string, share_with_displayname: string, share_with_link: string} $deckShare */
+                $deckShare = $this->getDeckShareHelper()->formatShare($share);
+                $result = array_merge($result, $deckShare);
+            } catch (ContainerExceptionInterface $e) {
+            }
+        } elseif ($share->getShareType() === IShare::TYPE_SCIENCEMESH) {
+            $result['share_with'] = $share->getSharedWith();
+            $result['share_with_displayname'] = '';
+
+            try {
+                /** @var array{share_with: string, share_with_displayname: string, token: string} $scienceMeshShare */
+                $scienceMeshShare = $this->getSciencemeshShareHelper()->formatShare($share);
+                $result = array_merge($result, $scienceMeshShare);
+            } catch (ContainerExceptionInterface $e) {
+            }
+        }
+
+
+        $result['mail_send'] = $share->getMailSend() ? 1 : 0;
+        $result['hide_download'] = $share->getHideDownload() ? 1 : 0;
+
+        $result['attributes'] = null;
+        if ($attributes = $share->getAttributes()) {
+            $result['attributes'] = (string)\json_encode($attributes->toArray());
+        }
+
+        return $result;
+    }
+
+    /**
+     * Check if one of the users address books knows the exact property, if
+     * not we return the full name.
+     *
+     * @param string $query
+     * @param string $property
+     * @return string
+     */
+    private function getDisplayNameFromAddressBook(string $query, string $property): string {
+        // FIXME: If we inject the contacts manager it gets initialized before any address books are registered
+        try {
+            $result = Server::get(\OCP\Contacts\IManager::class)->search($query, [$property], [
+                'limit' => 1,
+                'enumeration' => false,
+                'strict_search' => true,
+            ]);
+        } catch (Exception $e) {
+            $this->logger->error(
+                $e->getMessage(),
+                ['exception' => $e]
+            );
+            return $query;
+        }
+
+        foreach ($result as $r) {
+            foreach ($r[$property] as $value) {
+                if ($value === $query && $r['FN']) {
+                    return $r['FN'];
+                }
+            }
+        }
+
+        return $query;
+    }
+
+
+    /**
+     * @param list<Files_SharingShare> $shares
+     * @param array<string, string>|null $updatedDisplayName
+     *
+     * @return list<Files_SharingShare>
+     */
+    private function fixMissingDisplayName(array $shares, ?array $updatedDisplayName = null): array {
+        $userIds = $updated = [];
+        foreach ($shares as $share) {
+            // share is federated and share have no display name yet
+            if ($share['share_type'] === IShare::TYPE_REMOTE
+                && ($share['share_with'] ?? '') !== ''
+                && ($share['share_with_displayname'] ?? '') === '') {
+                $userIds[] = $userId = $share['share_with'];
+
+                if ($updatedDisplayName !== null && array_key_exists($userId, $updatedDisplayName)) {
+                    $share['share_with_displayname'] = $updatedDisplayName[$userId];
+                }
+            }
+
+            // prepping userIds with displayName to be updated
+            $updated[] = $share;
+        }
+
+        // if $updatedDisplayName is not null, it means we should have already fixed displayNames of the shares
+        if ($updatedDisplayName !== null) {
+            return $updated;
+        }
+
+        // get displayName for the generated list of userId with no displayName
+        $displayNames = $this->retrieveFederatedDisplayName($userIds);
+
+        // if no displayName are updated, we exit
+        if (empty($displayNames)) {
+            return $updated;
+        }
+
+        // let's fix missing display name and returns all shares
+        return $this->fixMissingDisplayName($shares, $displayNames);
+    }
+
+
+    /**
+     * get displayName of a list of userIds from the lookup-server; through the globalsiteselector app.
+     * returns an array with userIds as keys and displayName as values.
+     *
+     * @param array $userIds
+     * @param bool $cacheOnly - do not reach LUS, get data from cache.
+     *
+     * @return array
+     * @throws ContainerExceptionInterface
+     */
+    private function retrieveFederatedDisplayName(array $userIds, bool $cacheOnly = false): array {
+        // check if gss is enabled and available
+        if (count($userIds) === 0
+            || !$this->appManager->isEnabledForAnyone('globalsiteselector')
+            || !class_exists('\OCA\GlobalSiteSelector\Service\SlaveService')) {
+            return [];
+        }
+
+        try {
+            $slaveService = Server::get(SlaveService::class);
+        } catch (\Throwable $e) {
+            $this->logger->error(
+                $e->getMessage(),
+                ['exception' => $e]
+            );
+            return [];
+        }
+
+        return $slaveService->getUsersDisplayName($userIds, $cacheOnly);
+    }
+
+
+    /**
+     * retrieve displayName from cache if available (should be used on federated shares)
+     * if not available in cache/lus, try for get from address-book, else returns empty string.
+     *
+     * @param string $userId
+     * @param bool $cacheOnly if true will not reach the lus but will only get data from cache
+     *
+     * @return string
+     */
+    private function getCachedFederatedDisplayName(string $userId, bool $cacheOnly = true): string {
+        $details = $this->retrieveFederatedDisplayName([$userId], $cacheOnly);
+        if (array_key_exists($userId, $details)) {
+            return $details[$userId];
+        }
+
+        $displayName = $this->getDisplayNameFromAddressBook($userId, 'CLOUD');
+        return ($displayName === $userId) ? '' : $displayName;
+    }
+
+
+
+    /**
+     * Get a specific share by id
+     *
+     * @param string $id ID of the share
+     * @param bool $include_tags Include tags in the share
+     * @return DataResponse<Http::STATUS_OK, list<Files_SharingShare>, array{}>
+     * @throws OCSNotFoundException Share not found
+     *
+     * 200: Share returned
+     */
+    #[NoAdminRequired]
+    public function getShare(string $id, bool $include_tags = false): DataResponse {
+        try {
+            $share = $this->getShareById($id);
+        } catch (ShareNotFound $e) {
+            throw new OCSNotFoundException($this->l->t('Wrong share ID, share does not exist'));
+        }
+
+        try {
+            if ($this->canAccessShare($share)) {
+                $share = $this->formatShare($share);
+
+                if ($include_tags) {
+                    $share = Helper::populateTags([$share], Server::get(ITagManager::class));
+                } else {
+                    $share = [$share];
+                }
+
+                return new DataResponse($share);
+            }
+        } catch (NotFoundException $e) {
+            // Fall through
+        }
+
+        throw new OCSNotFoundException($this->l->t('Wrong share ID, share does not exist'));
+    }
+
+    /**
+     * Delete a share
+     *
+     * @param string $id ID of the share
+     * @return DataResponse<Http::STATUS_OK, list<empty>, array{}>
+     * @throws OCSNotFoundException Share not found
+     * @throws OCSForbiddenException Missing permissions to delete the share
+     *
+     * 200: Share deleted successfully
+     */
+    #[NoAdminRequired]
+    public function deleteShare(string $id): DataResponse {
+        try {
+            $share = $this->getShareById($id);
+        } catch (ShareNotFound $e) {
+            throw new OCSNotFoundException($this->l->t('Wrong share ID, share does not exist'));
+        }
+
+        try {
+            $this->lock($share->getNode());
+        } catch (LockedException $e) {
+            throw new OCSNotFoundException($this->l->t('Could not delete share'));
+        }
+
+        if (!$this->canAccessShare($share)) {
+            throw new OCSNotFoundException($this->l->t('Wrong share ID, share does not exist'));
+        }
+
+        // if it's a group share or a room share
+        // we don't delete the share, but only the
+        // mount point. Allowing it to be restored
+        // from the deleted shares
+        if ($this->canDeleteShareFromSelf($share)) {
+            $this->shareManager->deleteFromSelf($share, $this->userId);
+        } else {
+            if (!$this->canDeleteShare($share)) {
+                throw new OCSForbiddenException($this->l->t('Could not delete share'));
+            }
+
+            $this->shareManager->deleteShare($share);
+        }
+
+        return new DataResponse();
+    }
+
+    /**
+     * Create a share
+     *
+     * @param string|null $path Path of the share
+     * @param int|null $permissions Permissions for the share
+     * @param int $shareType Type of the share
+     * @param ?string $shareWith The entity this should be shared with
+     * @param 'true'|'false'|null $publicUpload If public uploading is allowed (deprecated)
+     * @param string $password Password for the share
+     * @param string|null $sendPasswordByTalk Send the password for the share over Talk
+     * @param ?string $expireDate The expiry date of the share in the user's timezone at 00:00.
+     *                            If $expireDate is not supplied or set to `null`, the system default will be used.
+     * @param string $note Note for the share
+     * @param string $label Label for the share (only used in link and email)
+     * @param string|null $attributes Additional attributes for the share
+     * @param 'false'|'true'|null $sendMail Send a mail to the recipient
+     *
+     * @return DataResponse<Http::STATUS_OK, Files_SharingShare, array{}>
+     * @throws OCSBadRequestException Unknown share type
+     * @throws OCSException
+     * @throws OCSForbiddenException Creating the share is not allowed
+     * @throws OCSNotFoundException Creating the share failed
+     * @suppress PhanUndeclaredClassMethod
+     *
+     * 200: Share created
+     */
+    #[NoAdminRequired]
+    #[UserRateLimit(limit: 20, period: 600)]
+    public function createShare(
+        ?string $path = null,
+        ?int $permissions = null,
+        int $shareType = -1,
+        ?string $shareWith = null,
+        ?string $publicUpload = null,
+        string $password = '',
+        ?string $sendPasswordByTalk = null,
+        ?string $expireDate = null,
+        string $note = '',
+        string $label = '',
+        ?string $attributes = null,
+        ?string $sendMail = null,
+    ): DataResponse {
+        assert($this->userId !== null);
+
+        $share = $this->shareManager->newShare();
+        $hasPublicUpload = $this->getLegacyPublicUpload($publicUpload);
+
+        // Verify path
+        if ($path === null) {
+            throw new OCSNotFoundException($this->l->t('Please specify a file or folder path'));
+        }
+
+        $userFolder = $this->rootFolder->getUserFolder($this->userId);
+        try {
+            /** @var \OC\Files\Node\Node $node */
+            $node = $userFolder->get($path);
+        } catch (NotFoundException $e) {
+            throw new OCSNotFoundException($this->l->t('Wrong path, file/folder does not exist'));
+        }
+
+        // a user can have access to a file through different paths, with differing permissions
+        // combine all permissions to determine if the user can share this file
+        $nodes = $userFolder->getById($node->getId());
+        foreach ($nodes as $nodeById) {
+            /** @var \OC\Files\FileInfo $fileInfo */
+            $fileInfo = $node->getFileInfo();
+            $fileInfo['permissions'] |= $nodeById->getPermissions();
+        }
+
+        $share->setNode($node);
+
+        try {
+            $this->lock($share->getNode());
+        } catch (LockedException $e) {
+            throw new OCSNotFoundException($this->l->t('Could not create share'));
+        }
+
+        // Set permissions
+        if ($shareType === IShare::TYPE_LINK || $shareType === IShare::TYPE_EMAIL) {
+            $permissions = $this->getLinkSharePermissions($permissions, $hasPublicUpload);
+            $this->validateLinkSharePermissions($node, $permissions, $hasPublicUpload);
+        } else {
+            // Use default permissions only for non-link shares to keep legacy behavior
+            if ($permissions === null) {
+                $permissions = (int)$this->config->getAppValue('core', 'shareapi_default_permissions', (string)Constants::PERMISSION_ALL);
+            }
+            // Non-link shares always require read permissions (link shares could be file drop)
+            $permissions |= Constants::PERMISSION_READ;
+        }
+
+        // For legacy reasons the API allows to pass PERMISSIONS_ALL even for single file shares (I look at you Talk)
+        if ($node instanceof File) {
+            // if this is a single file share we remove the DELETE and CREATE permissions
+            $permissions = $permissions & ~(Constants::PERMISSION_DELETE | Constants::PERMISSION_CREATE);
+        }
+
+        /**
+         * Hack for https://github.com/owncloud/core/issues/22587
+         * We check the permissions via webdav. But the permissions of the mount point
+         * do not equal the share permissions. Here we fix that for federated mounts.
+         */
+        if ($node->getStorage()->instanceOfStorage(Storage::class)) {
+            $permissions &= ~($permissions & ~$node->getPermissions());
+        }
+
+        if ($attributes !== null) {
+            $share = $this->setShareAttributes($share, $attributes);
+        }
+
+        // Expire date checks
+        // Normally, null means no expiration date but we still set the default for backwards compatibility
+        // If the client sends an empty string, we set noExpirationDate to true
+        if ($expireDate !== null) {
+            if ($expireDate !== '') {
+                try {
+                    $expireDateTime = $this->parseDate($expireDate);
+                    $share->setExpirationDate($expireDateTime);
+                } catch (\Exception $e) {
+                    throw new OCSNotFoundException($e->getMessage(), $e);
+                }
+            } else {
+                // Client sent empty string for expire date.
+                // Set noExpirationDate to true so overwrite is prevented.
+                $share->setNoExpirationDate(true);
+            }
+        }
+
+        $share->setSharedBy($this->userId);
+
+        // Handle mail send
+        if (is_null($sendMail)) {
+            $allowSendMail = $this->config->getSystemValueBool('sharing.enable_share_mail', true);
+            if ($allowSendMail !== true || $shareType === IShare::TYPE_EMAIL) {
+                // Define a default behavior when sendMail is not provided
+                // For email shares with a valid recipient, the default is to send the mail
+                // For all other share types, the default is to not send the mail
+                $allowSendMail = ($shareType === IShare::TYPE_EMAIL && $shareWith !== null && $shareWith !== '');
+            }
+            $share->setMailSend($allowSendMail);
+        } else {
+            $share->setMailSend($sendMail === 'true');
+        }
+
+        if ($shareType === IShare::TYPE_USER) {
+            // Valid user is required to share
+            if ($shareWith === null || !$this->userManager->userExists($shareWith)) {
+                throw new OCSNotFoundException($this->l->t('Please specify a valid account to share with'));
+            }
+            $share->setSharedWith($shareWith);
+            $share->setPermissions($permissions);
+        } elseif ($shareType === IShare::TYPE_GROUP) {
+            if (!$this->shareManager->allowGroupSharing()) {
+                throw new OCSNotFoundException($this->l->t('Group sharing is disabled by the administrator'));
+            }
+
+            // Valid group is required to share
+            if ($shareWith === null || !$this->groupManager->groupExists($shareWith)) {
+                throw new OCSNotFoundException($this->l->t('Please specify a valid group'));
+            }
+            $share->setSharedWith($shareWith);
+            $share->setPermissions($permissions);
+        } elseif ($shareType === IShare::TYPE_LINK
+            || $shareType === IShare::TYPE_EMAIL) {
+
+            // Can we even share links?
+            if (!$this->shareManager->shareApiAllowLinks()) {
+                throw new OCSNotFoundException($this->l->t('Public link sharing is disabled by the administrator'));
+            }
+
+            $this->validateLinkSharePermissions($node, $permissions, $hasPublicUpload);
+            $share->setPermissions($permissions);
+
+            // Set password
+            if ($password !== '') {
+                $share->setPassword($password);
+            }
+
+            // Only share by mail have a recipient
+            if (is_string($shareWith) && $shareType === IShare::TYPE_EMAIL) {
+                // If sending a mail have been requested, validate the mail address
+                if ($share->getMailSend() && !$this->mailer->validateMailAddress($shareWith)) {
+                    throw new OCSNotFoundException($this->l->t('Please specify a valid email address'));
+                }
+                $share->setSharedWith($shareWith);
+            }
+
+            // If we have a label, use it
+            if ($label !== '') {
+                if (strlen($label) > 255) {
+                    throw new OCSBadRequestException('Maximum label length is 255');
+                }
+                $share->setLabel($label);
+            }
+
+            if ($sendPasswordByTalk === 'true') {
+                if (!$this->appManager->isEnabledForUser('spreed')) {
+                    throw new OCSForbiddenException($this->l->t('Sharing %s sending the password by Nextcloud Talk failed because Nextcloud Talk is not enabled', [$node->getPath()]));
+                }
+
+                $share->setSendPasswordByTalk(true);
+            }
+        } elseif ($shareType === IShare::TYPE_REMOTE) {
+            if (!$this->shareManager->outgoingServer2ServerSharesAllowed()) {
+                throw new OCSForbiddenException($this->l->t('Sharing %1$s failed because the back end does not allow shares from type %2$s', [$node->getPath(), $shareType]));
+            }
+
+            if ($shareWith === null) {
+                throw new OCSNotFoundException($this->l->t('Please specify a valid federated account ID'));
+            }
+
+            $share->setSharedWith($shareWith);
+            $share->setPermissions($permissions);
+            $share->setSharedWithDisplayName($this->getCachedFederatedDisplayName($shareWith, false));
+        } elseif ($shareType === IShare::TYPE_REMOTE_GROUP) {
+            if (!$this->shareManager->outgoingServer2ServerGroupSharesAllowed()) {
+                throw new OCSForbiddenException($this->l->t('Sharing %1$s failed because the back end does not allow shares from type %2$s', [$node->getPath(), $shareType]));
+            }
+
+            if ($shareWith === null) {
+                throw new OCSNotFoundException($this->l->t('Please specify a valid federated group ID'));
+            }
+
+            $share->setSharedWith($shareWith);
+            $share->setPermissions($permissions);
+        } elseif ($shareType === IShare::TYPE_CIRCLE) {
+            if (!Server::get(IAppManager::class)->isEnabledForUser('circles') || !class_exists('\OCA\Circles\ShareByCircleProvider')) {
+                throw new OCSNotFoundException($this->l->t('You cannot share to a Team if the app is not enabled'));
+            }
+
+            $circle = Circles::detailsCircle($shareWith);
+
+            // Valid team is required to share
+            if ($circle === null) {
+                throw new OCSNotFoundException($this->l->t('Please specify a valid team'));
+            }
+            $share->setSharedWith($shareWith);
+            $share->setPermissions($permissions);
+        } elseif ($shareType === IShare::TYPE_ROOM) {
+            try {
+                $this->getRoomShareHelper()->createShare($share, $shareWith, $permissions, $expireDate ?? '');
+            } catch (ContainerExceptionInterface $e) {
+                throw new OCSForbiddenException($this->l->t('Sharing %s failed because the back end does not support room shares', [$node->getPath()]));
+            }
+        } elseif ($shareType === IShare::TYPE_DECK) {
+            try {
+                $this->getDeckShareHelper()->createShare($share, $shareWith, $permissions, $expireDate ?? '');
+            } catch (ContainerExceptionInterface $e) {
+                throw new OCSForbiddenException($this->l->t('Sharing %s failed because the back end does not support room shares', [$node->getPath()]));
+            }
+        } elseif ($shareType === IShare::TYPE_SCIENCEMESH) {
+            try {
+                $this->getSciencemeshShareHelper()->createShare($share, $shareWith, $permissions, $expireDate ?? '');
+            } catch (ContainerExceptionInterface $e) {
+                throw new OCSForbiddenException($this->l->t('Sharing %s failed because the back end does not support ScienceMesh shares', [$node->getPath()]));
+            }
+        } else {
+            throw new OCSBadRequestException($this->l->t('Unknown share type'));
+        }
+
+        $share->setShareType($shareType);
+        $this->checkInheritedAttributes($share);
+
+        if ($note !== '') {
+            $share->setNote($note);
+        }
+
+        try {
+            $share = $this->shareManager->createShare($share);
+        } catch (HintException $e) {
+            $code = $e->getCode() === 0 ? 403 : $e->getCode();
+            throw new OCSException($e->getHint(), $code);
+        } catch (GenericShareException|\InvalidArgumentException $e) {
+            $this->logger->error($e->getMessage(), ['exception' => $e]);
+            throw new OCSForbiddenException($e->getMessage(), $e);
+        } catch (\Exception $e) {
+            $this->logger->error($e->getMessage(), ['exception' => $e]);
+            throw new OCSForbiddenException('Failed to create share.', $e);
+        }
+
+        $output = $this->formatShare($share);
+
+        return new DataResponse($output);
+    }
+
+    /**
+     * @param null|Node $node
+     * @param boolean $includeTags
+     *
+     * @return list<Files_SharingShare>
+     */
+    private function getSharedWithMe($node, bool $includeTags): array {
+        $userShares = $this->shareManager->getSharedWith($this->userId, IShare::TYPE_USER, $node, -1, 0);
+        $groupShares = $this->shareManager->getSharedWith($this->userId, IShare::TYPE_GROUP, $node, -1, 0);
+        $circleShares = $this->shareManager->getSharedWith($this->userId, IShare::TYPE_CIRCLE, $node, -1, 0);
+        $roomShares = $this->shareManager->getSharedWith($this->userId, IShare::TYPE_ROOM, $node, -1, 0);
+        $deckShares = $this->shareManager->getSharedWith($this->userId, IShare::TYPE_DECK, $node, -1, 0);
+        $sciencemeshShares = $this->shareManager->getSharedWith($this->userId, IShare::TYPE_SCIENCEMESH, $node, -1, 0);
+
+        $shares = array_merge($userShares, $groupShares, $circleShares, $roomShares, $deckShares, $sciencemeshShares);
+
+        $filteredShares = array_filter($shares, function (IShare $share) {
+            return $share->getShareOwner() !== $this->userId;
+        });
+
+        $formatted = [];
+        foreach ($filteredShares as $share) {
+            if ($this->canAccessShare($share)) {
+                try {
+                    $formatted[] = $this->formatShare($share);
+                } catch (NotFoundException $e) {
+                    // Ignore this share
+                }
+            }
+        }
+
+        if ($includeTags) {
+            $formatted = Helper::populateTags($formatted, Server::get(ITagManager::class));
+        }
+
+        return $formatted;
+    }
+
+    /**
+     * @param Node $folder
+     *
+     * @return list<Files_SharingShare>
+     * @throws OCSBadRequestException
+     * @throws NotFoundException
+     */
+    private function getSharesInDir(Node $folder): array {
+        if (!($folder instanceof Folder)) {
+            throw new OCSBadRequestException($this->l->t('Not a directory'));
+        }
+
+        $nodes = $folder->getDirectoryListing();
+
+        /** @var IShare[] $shares */
+        $shares = array_reduce($nodes, function ($carry, $node) {
+            $carry = array_merge($carry, $this->getAllShares($node, true));
+            return $carry;
+        }, []);
+
+        // filter out duplicate shares
+        $known = [];
+
+        $formatted = $miniFormatted = [];
+        $resharingRight = false;
+        $known = [];
+        foreach ($shares as $share) {
+            if (in_array($share->getId(), $known) || $share->getSharedWith() === $this->userId) {
+                continue;
+            }
+
+            try {
+                $format = $this->formatShare($share);
+
+                $known[] = $share->getId();
+                $formatted[] = $format;
+                if ($share->getSharedBy() === $this->userId) {
+                    $miniFormatted[] = $format;
+                }
+                if (!$resharingRight && $this->shareProviderResharingRights($this->userId, $share, $folder)) {
+                    $resharingRight = true;
+                }
+            } catch (\Exception $e) {
+                //Ignore this share
+            }
+        }
+
+        if (!$resharingRight) {
+            $formatted = $miniFormatted;
+        }
+
+        return $formatted;
+    }
+
+    /**
+     * Get shares of the current user
+     *
+     * @param string $shared_with_me Only get shares with the current user
+     * @param string $reshares Only get shares by the current user and reshares
+     * @param string $subfiles Only get all shares in a folder
+     * @param string $path Get shares for a specific path
+     * @param string $include_tags Include tags in the share
+     *
+     * @return DataResponse<Http::STATUS_OK, list<Files_SharingShare>, array{}>
+     * @throws OCSNotFoundException The folder was not found or is inaccessible
+     *
+     * 200: Shares returned
+     */
+    #[NoAdminRequired]
+    public function getShares(
+        string $shared_with_me = 'false',
+        string $reshares = 'false',
+        string $subfiles = 'false',
+        string $path = '',
+        string $include_tags = 'false',
+    ): DataResponse {
+        $node = null;
+        if ($path !== '') {
+            $userFolder = $this->rootFolder->getUserFolder($this->userId);
+            try {
+                $node = $userFolder->get($path);
+                $this->lock($node);
+            } catch (NotFoundException $e) {
+                throw new OCSNotFoundException(
+                    $this->l->t('Wrong path, file/folder does not exist')
+                );
+            } catch (LockedException $e) {
+                throw new OCSNotFoundException($this->l->t('Could not lock node'));
+            }
+        }
+
+        $shares = $this->getFormattedShares(
+            $this->userId,
+            $node,
+            ($shared_with_me === 'true'),
+            ($reshares === 'true'),
+            ($subfiles === 'true'),
+            ($include_tags === 'true')
+        );
+
+        return new DataResponse($shares);
+    }
+
+    private function getLinkSharePermissions(?int $permissions, ?bool $legacyPublicUpload): int {
+        $permissions = $permissions ?? Constants::PERMISSION_READ;
+
+        // Legacy option handling
+        if ($legacyPublicUpload !== null) {
+            $permissions = $legacyPublicUpload
+                ? (Constants::PERMISSION_READ | Constants::PERMISSION_CREATE | Constants::PERMISSION_UPDATE | Constants::PERMISSION_DELETE)
+                : Constants::PERMISSION_READ;
+        }
+
+        // TODO: It might make sense to have a dedicated setting to allow/deny converting link shares into federated ones
+        if ($this->hasPermission($permissions, Constants::PERMISSION_READ)
+            && $this->shareManager->outgoingServer2ServerSharesAllowed()) {
+            $permissions |= Constants::PERMISSION_SHARE;
+        }
+
+        return $permissions;
+    }
+
+    /**
+     * Helper to check for legacy "publicUpload" handling.
+     * If the value is set to `true` or `false` then true or false are returned.
+     * Otherwise null is returned to indicate that the option was not (or wrong) set.
+     *
+     * @param null|string $legacyPublicUpload The value of `publicUpload`
+     */
+    private function getLegacyPublicUpload(?string $legacyPublicUpload): ?bool {
+        if ($legacyPublicUpload === 'true') {
+            return true;
+        } elseif ($legacyPublicUpload === 'false') {
+            return false;
+        }
+        // Not set at all
+        return null;
+    }
+
+    /**
+     * For link and email shares validate that only allowed combinations are set.
+     *
+     * @throw OCSBadRequestException If permission combination is invalid.
+     * @throw OCSForbiddenException If public upload was forbidden by the administrator.
+     */
+    private function validateLinkSharePermissions(Node $node, int $permissions, ?bool $legacyPublicUpload): void {
+        if ($legacyPublicUpload && ($node instanceof File)) {
+            throw new OCSBadRequestException($this->l->t('Public upload is only possible for publicly shared folders'));
+        }
+
+        // We need at least READ or CREATE (file drop)
+        if (!$this->hasPermission($permissions, Constants::PERMISSION_READ)
+            && !$this->hasPermission($permissions, Constants::PERMISSION_CREATE)) {
+            throw new OCSBadRequestException($this->l->t('Share must at least have READ or CREATE permissions'));
+        }
+
+        // UPDATE and DELETE require a READ permission
+        if (!$this->hasPermission($permissions, Constants::PERMISSION_READ)
+            && ($this->hasPermission($permissions, Constants::PERMISSION_UPDATE) || $this->hasPermission($permissions, Constants::PERMISSION_DELETE))) {
+            throw new OCSBadRequestException($this->l->t('Share must have READ permission if UPDATE or DELETE permission is set'));
+        }
+
+        // Check if public uploading was disabled
+        if ($this->hasPermission($permissions, Constants::PERMISSION_CREATE)
+            && !$this->shareManager->shareApiLinkAllowPublicUpload()) {
+            throw new OCSForbiddenException($this->l->t('Public upload disabled by the administrator'));
+        }
+    }
+
+    /**
+     * @param string $viewer
+     * @param Node $node
+     * @param bool $sharedWithMe
+     * @param bool $reShares
+     * @param bool $subFiles
+     * @param bool $includeTags
+     *
+     * @return list<Files_SharingShare>
+     * @throws NotFoundException
+     * @throws OCSBadRequestException
+     */
+    private function getFormattedShares(
+        string $viewer,
+        $node = null,
+        bool $sharedWithMe = false,
+        bool $reShares = false,
+        bool $subFiles = false,
+        bool $includeTags = false,
+    ): array {
+        if ($sharedWithMe) {
+            return $this->getSharedWithMe($node, $includeTags);
+        }
+
+        if ($subFiles) {
+            return $this->getSharesInDir($node);
+        }
+
+        $shares = $this->getSharesFromNode($viewer, $node, $reShares);
+
+        $known = $formatted = $miniFormatted = [];
+        $resharingRight = false;
+        foreach ($shares as $share) {
+            try {
+                $share->getNode();
+            } catch (NotFoundException $e) {
+                /*
 				 * Ignore shares where we can't get the node
 				 * For example deleted shares
 				 */
-				continue;
-			}
-
-			if (in_array($share->getId(), $known)
-				|| ($share->getSharedWith() === $this->userId && $share->getShareType() === IShare::TYPE_USER)) {
-				continue;
-			}
-
-			$known[] = $share->getId();
-			try {
-				/** @var IShare $share */
-				$format = $this->formatShare($share, $node);
-				$formatted[] = $format;
-
-				// let's also build a list of shares created
-				// by the current user only, in case
-				// there is no resharing rights
-				if ($share->getSharedBy() === $this->userId) {
-					$miniFormatted[] = $format;
-				}
-
-				// check if one of those share is shared with me
-				// and if I have resharing rights on it
-				if (!$resharingRight && $this->shareProviderResharingRights($this->userId, $share, $node)) {
-					$resharingRight = true;
-				}
-			} catch (InvalidPathException|NotFoundException $e) {
-			}
-		}
-
-		if (!$resharingRight) {
-			$formatted = $miniFormatted;
-		}
-
-		// fix eventual missing display name from federated shares
-		$formatted = $this->fixMissingDisplayName($formatted);
-
-		if ($includeTags) {
-			$formatted =
-				Helper::populateTags($formatted, Server::get(ITagManager::class));
-		}
-
-		return $formatted;
-	}
-
-
-	/**
-	 * Get all shares relative to a file, including parent folders shares rights
-	 *
-	 * @param string $path Path all shares will be relative to
-	 *
-	 * @return DataResponse<Http::STATUS_OK, list<Files_SharingShare>, array{}>
-	 * @throws InvalidPathException
-	 * @throws NotFoundException
-	 * @throws OCSNotFoundException The given path is invalid
-	 * @throws SharingRightsException
-	 *
-	 * 200: Shares returned
-	 */
-	#[NoAdminRequired]
-	public function getInheritedShares(string $path): DataResponse {
-		// get Node from (string) path.
-		$userFolder = $this->rootFolder->getUserFolder($this->userId);
-		try {
-			$node = $userFolder->get($path);
-			$this->lock($node);
-		} catch (NotFoundException $e) {
-			throw new OCSNotFoundException($this->l->t('Wrong path, file/folder does not exist'));
-		} catch (LockedException $e) {
-			throw new OCSNotFoundException($this->l->t('Could not lock path'));
-		}
-
-		if (!($node->getPermissions() & Constants::PERMISSION_SHARE)) {
-			throw new SharingRightsException($this->l->t('no sharing rights on this item'));
-		}
-
-		// The current top parent we have access to
-		$parent = $node;
-
-		// initiate real owner.
-		$owner = $node->getOwner()
-			->getUID();
-		if (!$this->userManager->userExists($owner)) {
-			return new DataResponse([]);
-		}
-
-		// get node based on the owner, fix owner in case of external storage
-		$userFolder = $this->rootFolder->getUserFolder($owner);
-		if ($node->getId() !== $userFolder->getId() && !$userFolder->isSubNode($node)) {
-			$owner = $node->getOwner()
-				->getUID();
-			$userFolder = $this->rootFolder->getUserFolder($owner);
-			$node = $userFolder->getFirstNodeById($node->getId());
-		}
-		$basePath = $userFolder->getPath();
-
-		// generate node list for each parent folders
-		/** @var Node[] $nodes */
-		$nodes = [];
-		while (true) {
-			$node = $node->getParent();
-			if ($node->getPath() === $basePath) {
-				break;
-			}
-			$nodes[] = $node;
-		}
-
-		// The user that is requesting this list
-		$currentUserFolder = $this->rootFolder->getUserFolder($this->userId);
-
-		// for each nodes, retrieve shares.
-		$shares = [];
-
-		foreach ($nodes as $node) {
-			$getShares = $this->getFormattedShares($owner, $node, false, true);
-
-			$currentUserNode = $currentUserFolder->getFirstNodeById($node->getId());
-			if ($currentUserNode) {
-				$parent = $currentUserNode;
-			}
-
-			$subPath = $currentUserFolder->getRelativePath($parent->getPath());
-			foreach ($getShares as &$share) {
-				$share['via_fileid'] = $parent->getId();
-				$share['via_path'] = $subPath;
-			}
-			$this->mergeFormattedShares($shares, $getShares);
-		}
-
-		return new DataResponse(array_values($shares));
-	}
-
-	/**
-	 * Check whether a set of permissions contains the permissions to check.
-	 */
-	private function hasPermission(int $permissionsSet, int $permissionsToCheck): bool {
-		return ($permissionsSet & $permissionsToCheck) === $permissionsToCheck;
-	}
-
-	/**
-	 * Update a share
-	 *
-	 * @param string $id ID of the share
-	 * @param int|null $permissions New permissions
-	 * @param string|null $password New password
-	 * @param string|null $sendPasswordByTalk New condition if the password should be send over Talk
-	 * @param string|null $publicUpload New condition if public uploading is allowed
-	 * @param string|null $expireDate New expiry date
-	 * @param string|null $note New note
-	 * @param string|null $label New label
-	 * @param string|null $hideDownload New condition if the download should be hidden
-	 * @param string|null $attributes New additional attributes
-	 * @param string|null $sendMail if the share should be send by mail.
-	 *                              Considering the share already exists, no mail will be send after the share is updated.
-	 *                              You will have to use the sendMail action to send the mail.
-	 * @param string|null $shareWith New recipient for email shares
-	 * @param string|null $token New token
-	 * @return DataResponse<Http::STATUS_OK, Files_SharingShare, array{}>
-	 * @throws OCSBadRequestException Share could not be updated because the requested changes are invalid
-	 * @throws OCSForbiddenException Missing permissions to update the share
-	 * @throws OCSNotFoundException Share not found
-	 *
-	 * 200: Share updated successfully
-	 */
-	#[NoAdminRequired]
-	public function updateShare(
-		string $id,
-		?int $permissions = null,
-		?string $password = null,
-		?string $sendPasswordByTalk = null,
-		?string $publicUpload = null,
-		?string $expireDate = null,
-		?string $note = null,
-		?string $label = null,
-		?string $hideDownload = null,
-		?string $attributes = null,
-		?string $sendMail = null,
-		?string $token = null,
-	): DataResponse {
-		try {
-			$share = $this->getShareById($id);
-		} catch (ShareNotFound $e) {
-			throw new OCSNotFoundException($this->l->t('Wrong share ID, share does not exist'));
-		}
-
-		$this->lock($share->getNode());
-
-		if (!$this->canAccessShare($share, false)) {
-			throw new OCSNotFoundException($this->l->t('Wrong share ID, share does not exist'));
-		}
-
-		if (!$this->canEditShare($share)) {
-			throw new OCSForbiddenException($this->l->t('You are not allowed to edit incoming shares'));
-		}
-
-		if (
-			$permissions === null &&
-			$password === null &&
-			$sendPasswordByTalk === null &&
-			$publicUpload === null &&
-			$expireDate === null &&
-			$note === null &&
-			$label === null &&
-			$hideDownload === null &&
-			$attributes === null &&
-			$sendMail === null &&
-			$token === null
-		) {
-			throw new OCSBadRequestException($this->l->t('Wrong or no update parameter given'));
-		}
-
-		if ($note !== null) {
-			$share->setNote($note);
-		}
-
-		if ($attributes !== null) {
-			$share = $this->setShareAttributes($share, $attributes);
-		}
-
-		// Handle mail send
-		if ($sendMail === 'true' || $sendMail === 'false') {
-			$share->setMailSend($sendMail === 'true');
-		}
-
-		/**
-		 * expiration date, password and publicUpload only make sense for link shares
-		 */
-		if ($share->getShareType() === IShare::TYPE_LINK
-			|| $share->getShareType() === IShare::TYPE_EMAIL) {
-
-			// Update hide download state
-			if ($hideDownload === 'true') {
-				$share->setHideDownload(true);
-			} elseif ($hideDownload === 'false') {
-				$share->setHideDownload(false);
-			}
-
-			// If either manual permissions are specified or publicUpload
-			// then we need to also update the permissions of the share
-			if ($permissions !== null || $publicUpload !== null) {
-				$hasPublicUpload = $this->getLegacyPublicUpload($publicUpload);
-				$permissions = $this->getLinkSharePermissions($permissions ?? Constants::PERMISSION_READ, $hasPublicUpload);
-				$this->validateLinkSharePermissions($share->getNode(), $permissions, $hasPublicUpload);
-				$share->setPermissions($permissions);
-			}
-
-			if ($password === '') {
-				$share->setPassword(null);
-			} elseif ($password !== null) {
-				$share->setPassword($password);
-			}
-
-			if ($label !== null) {
-				if (strlen($label) > 255) {
-					throw new OCSBadRequestException('Maximum label length is 255');
-				}
-				$share->setLabel($label);
-			}
-
-			if ($sendPasswordByTalk === 'true') {
-				if (!$this->appManager->isEnabledForUser('spreed')) {
-					throw new OCSForbiddenException($this->l->t('"Sending the password by Nextcloud Talk" for sharing a file or folder failed because Nextcloud Talk is not enabled.'));
-				}
-
-				$share->setSendPasswordByTalk(true);
-			} elseif ($sendPasswordByTalk !== null) {
-				$share->setSendPasswordByTalk(false);
-			}
-
-			if ($token !== null) {
-				if (!$this->shareManager->allowCustomTokens()) {
-					throw new OCSForbiddenException($this->l->t('Custom share link tokens have been disabled by the administrator'));
-				}
-				if (!$this->validateToken($token)) {
-					throw new OCSBadRequestException($this->l->t('Tokens must contain at least 1 character and may only contain letters, numbers, or a hyphen'));
-				}
-				$share->setToken($token);
-			}
-		}
-
-		// NOT A LINK SHARE
-		else {
-			if ($permissions !== null) {
-				$share->setPermissions($permissions);
-			}
-		}
-
-		if ($expireDate === '') {
-			$share->setExpirationDate(null);
-		} elseif ($expireDate !== null) {
-			try {
-				$expireDateTime = $this->parseDate($expireDate);
-				$share->setExpirationDate($expireDateTime);
-			} catch (\Exception $e) {
-				throw new OCSBadRequestException($e->getMessage(), $e);
-			}
-		}
-
-		try {
-			$this->checkInheritedAttributes($share);
-			$share = $this->shareManager->updateShare($share);
-		} catch (HintException $e) {
-			$code = $e->getCode() === 0 ? 403 : $e->getCode();
-			throw new OCSException($e->getHint(), (int)$code);
-		} catch (\Exception $e) {
-			$this->logger->error($e->getMessage(), ['exception' => $e]);
-			throw new OCSBadRequestException('Failed to update share.', $e);
-		}
-
-		return new DataResponse($this->formatShare($share));
-	}
-
-	private function validateToken(string $token): bool {
-		if (mb_strlen($token) === 0) {
-			return false;
-		}
-		if (!preg_match('/^[a-z0-9-]+$/i', $token)) {
-			return false;
-		}
-		return true;
-	}
-
-	/**
-	 * Get all shares that are still pending
-	 *
-	 * @return DataResponse<Http::STATUS_OK, list<Files_SharingShare>, array{}>
-	 *
-	 * 200: Pending shares returned
-	 */
-	#[NoAdminRequired]
-	public function pendingShares(): DataResponse {
-		$pendingShares = [];
-
-		$shareTypes = [
-			IShare::TYPE_USER,
-			IShare::TYPE_GROUP
-		];
-
-		foreach ($shareTypes as $shareType) {
-			$shares = $this->shareManager->getSharedWith($this->userId, $shareType, null, -1, 0);
-
-			foreach ($shares as $share) {
-				if ($share->getStatus() === IShare::STATUS_PENDING || $share->getStatus() === IShare::STATUS_REJECTED) {
-					$pendingShares[] = $share;
-				}
-			}
-		}
-
-		$result = array_values(array_filter(array_map(function (IShare $share) {
-			$userFolder = $this->rootFolder->getUserFolder($share->getSharedBy());
-			$node = $userFolder->getFirstNodeById($share->getNodeId());
-			if (!$node) {
-				// fallback to guessing the path
-				$node = $userFolder->get($share->getTarget());
-				if ($node === null || $share->getTarget() === '') {
-					return null;
-				}
-			}
-
-			try {
-				$formattedShare = $this->formatShare($share, $node);
-				$formattedShare['path'] = '/' . $share->getNode()->getName();
-				$formattedShare['permissions'] = 0;
-				return $formattedShare;
-			} catch (NotFoundException $e) {
-				return null;
-			}
-		}, $pendingShares), function ($entry) {
-			return $entry !== null;
-		}));
-
-		return new DataResponse($result);
-	}
-
-	/**
-	 * Accept a share
-	 *
-	 * @param string $id ID of the share
-	 * @return DataResponse<Http::STATUS_OK, list<empty>, array{}>
-	 * @throws OCSNotFoundException Share not found
-	 * @throws OCSException
-	 * @throws OCSBadRequestException Share could not be accepted
-	 *
-	 * 200: Share accepted successfully
-	 */
-	#[NoAdminRequired]
-	public function acceptShare(string $id): DataResponse {
-		try {
-			$share = $this->getShareById($id);
-		} catch (ShareNotFound $e) {
-			throw new OCSNotFoundException($this->l->t('Wrong share ID, share does not exist'));
-		}
-
-		if (!$this->canAccessShare($share)) {
-			throw new OCSNotFoundException($this->l->t('Wrong share ID, share does not exist'));
-		}
-
-		try {
-			$this->shareManager->acceptShare($share, $this->userId);
-		} catch (HintException $e) {
-			$code = $e->getCode() === 0 ? 403 : $e->getCode();
-			throw new OCSException($e->getHint(), (int)$code);
-		} catch (\Exception $e) {
-			$this->logger->error($e->getMessage(), ['exception' => $e]);
-			throw new OCSBadRequestException('Failed to accept share.', $e);
-		}
-
-		return new DataResponse();
-	}
-
-	/**
-	 * Does the user have read permission on the share
-	 *
-	 * @param IShare $share the share to check
-	 * @param boolean $checkGroups check groups as well?
-	 * @return boolean
-	 * @throws NotFoundException
-	 *
-	 * @suppress PhanUndeclaredClassMethod
-	 */
-	protected function canAccessShare(IShare $share, bool $checkGroups = true): bool {
-		// A file with permissions 0 can't be accessed by us. So Don't show it
-		if ($share->getPermissions() === 0) {
-			return false;
-		}
-
-		// Owner of the file and the sharer of the file can always get share
-		if ($share->getShareOwner() === $this->userId
-			|| $share->getSharedBy() === $this->userId) {
-			return true;
-		}
-
-		// If the share is shared with you, you can access it!
-		if ($share->getShareType() === IShare::TYPE_USER
-			&& $share->getSharedWith() === $this->userId) {
-			return true;
-		}
-
-		// Have reshare rights on the shared file/folder ?
-		// Does the currentUser have access to the shared file?
-		$userFolder = $this->rootFolder->getUserFolder($this->userId);
-		$file = $userFolder->getFirstNodeById($share->getNodeId());
-		if ($file && $this->shareProviderResharingRights($this->userId, $share, $file)) {
-			return true;
-		}
-
-		// If in the recipient group, you can see the share
-		if ($checkGroups && $share->getShareType() === IShare::TYPE_GROUP) {
-			$sharedWith = $this->groupManager->get($share->getSharedWith());
-			$user = $this->userManager->get($this->userId);
-			if ($user !== null && $sharedWith !== null && $sharedWith->inGroup($user)) {
-				return true;
-			}
-		}
-
-		if ($share->getShareType() === IShare::TYPE_CIRCLE) {
-			// TODO: have a sanity check like above?
-			return true;
-		}
-
-		if ($share->getShareType() === IShare::TYPE_ROOM) {
-			try {
-				return $this->getRoomShareHelper()->canAccessShare($share, $this->userId);
-			} catch (ContainerExceptionInterface $e) {
-				return false;
-			}
-		}
-
-		if ($share->getShareType() === IShare::TYPE_DECK) {
-			try {
-				return $this->getDeckShareHelper()->canAccessShare($share, $this->userId);
-			} catch (ContainerExceptionInterface $e) {
-				return false;
-			}
-		}
-
-		if ($share->getShareType() === IShare::TYPE_SCIENCEMESH) {
-			try {
-				return $this->getSciencemeshShareHelper()->canAccessShare($share, $this->userId);
-			} catch (ContainerExceptionInterface $e) {
-				return false;
-			}
-		}
-
-		return false;
-	}
-
-	/**
-	 * Does the user have edit permission on the share
-	 *
-	 * @param IShare $share the share to check
-	 * @return boolean
-	 */
-	protected function canEditShare(IShare $share): bool {
-		// A file with permissions 0 can't be accessed by us. So Don't show it
-		if ($share->getPermissions() === 0) {
-			return false;
-		}
-
-		// The owner of the file and the creator of the share
-		// can always edit the share
-		if ($share->getShareOwner() === $this->userId ||
-			$share->getSharedBy() === $this->userId
-		) {
-			return true;
-		}
-
-		$userFolder = $this->rootFolder->getUserFolder($this->userId);
-		$file = $userFolder->getFirstNodeById($share->getNodeId());
-		if ($file?->getMountPoint() instanceof IShareOwnerlessMount && $this->shareProviderResharingRights($this->userId, $share, $file)) {
-			return true;
-		}
-
-		//! we do NOT support some kind of `admin` in groups.
-		//! You cannot edit shares shared to a group you're
-		//! a member of if you're not the share owner or the file owner!
-
-		return false;
-	}
-
-	/**
-	 * Does the user have delete permission on the share
-	 *
-	 * @param IShare $share the share to check
-	 * @return boolean
-	 */
-	protected function canDeleteShare(IShare $share): bool {
-		// A file with permissions 0 can't be accessed by us. So Don't show it
-		if ($share->getPermissions() === 0) {
-			return false;
-		}
-
-		// if the user is the recipient, i can unshare
-		// the share with self
-		if ($share->getShareType() === IShare::TYPE_USER &&
-			$share->getSharedWith() === $this->userId
-		) {
-			return true;
-		}
-
-		// The owner of the file and the creator of the share
-		// can always delete the share
-		if ($share->getShareOwner() === $this->userId ||
-			$share->getSharedBy() === $this->userId
-		) {
-			return true;
-		}
-
-		$userFolder = $this->rootFolder->getUserFolder($this->userId);
-		$file = $userFolder->getFirstNodeById($share->getNodeId());
-		if ($file?->getMountPoint() instanceof IShareOwnerlessMount && $this->shareProviderResharingRights($this->userId, $share, $file)) {
-			return true;
-		}
-
-		return false;
-	}
-
-	/**
-	 * Does the user have delete permission on the share
-	 * This differs from the canDeleteShare function as it only
-	 * remove the share for the current user. It does NOT
-	 * completely delete the share but only the mount point.
-	 * It can then be restored from the deleted shares section.
-	 *
-	 * @param IShare $share the share to check
-	 * @return boolean
-	 *
-	 * @suppress PhanUndeclaredClassMethod
-	 */
-	protected function canDeleteShareFromSelf(IShare $share): bool {
-		if ($share->getShareType() !== IShare::TYPE_GROUP &&
-			$share->getShareType() !== IShare::TYPE_ROOM &&
-			$share->getShareType() !== IShare::TYPE_DECK &&
-			$share->getShareType() !== IShare::TYPE_SCIENCEMESH
-		) {
-			return false;
-		}
-
-		if ($share->getShareOwner() === $this->userId ||
-			$share->getSharedBy() === $this->userId
-		) {
-			// Delete the whole share, not just for self
-			return false;
-		}
-
-		// If in the recipient group, you can delete the share from self
-		if ($share->getShareType() === IShare::TYPE_GROUP) {
-			$sharedWith = $this->groupManager->get($share->getSharedWith());
-			$user = $this->userManager->get($this->userId);
-			if ($user !== null && $sharedWith !== null && $sharedWith->inGroup($user)) {
-				return true;
-			}
-		}
-
-		if ($share->getShareType() === IShare::TYPE_ROOM) {
-			try {
-				return $this->getRoomShareHelper()->canAccessShare($share, $this->userId);
-			} catch (ContainerExceptionInterface $e) {
-				return false;
-			}
-		}
-
-		if ($share->getShareType() === IShare::TYPE_DECK) {
-			try {
-				return $this->getDeckShareHelper()->canAccessShare($share, $this->userId);
-			} catch (ContainerExceptionInterface $e) {
-				return false;
-			}
-		}
-
-		if ($share->getShareType() === IShare::TYPE_SCIENCEMESH) {
-			try {
-				return $this->getSciencemeshShareHelper()->canAccessShare($share, $this->userId);
-			} catch (ContainerExceptionInterface $e) {
-				return false;
-			}
-		}
-
-		return false;
-	}
-
-	/**
-	 * Make sure that the passed date is valid ISO 8601
-	 * So YYYY-MM-DD
-	 * If not throw an exception
-	 *
-	 * @param string $expireDate
-	 *
-	 * @throws \Exception
-	 * @return \DateTime
-	 */
-	private function parseDate(string $expireDate): \DateTime {
-		try {
-			$date = new \DateTime(trim($expireDate, '"'), $this->dateTimeZone->getTimeZone());
-			// Make sure it expires at midnight in owner timezone
-			$date->setTime(0, 0, 0);
-		} catch (\Exception $e) {
-			throw new \Exception($this->l->t('Invalid date. Format must be YYYY-MM-DD'));
-		}
-
-		return $date;
-	}
-
-	/**
-	 * Since we have multiple providers but the OCS Share API v1 does
-	 * not support this we need to check all backends.
-	 *
-	 * @param string $id
-	 * @return IShare
-	 * @throws ShareNotFound
-	 */
-	private function getShareById(string $id): IShare {
-		$share = null;
-
-		// First check if it is an internal share.
-		try {
-			$share = $this->shareManager->getShareById('ocinternal:' . $id, $this->userId);
-			return $share;
-		} catch (ShareNotFound $e) {
-			// Do nothing, just try the other share type
-		}
-
-
-		try {
-			if ($this->shareManager->shareProviderExists(IShare::TYPE_CIRCLE)) {
-				$share = $this->shareManager->getShareById('ocCircleShare:' . $id, $this->userId);
-				return $share;
-			}
-		} catch (ShareNotFound $e) {
-			// Do nothing, just try the other share type
-		}
-
-		try {
-			if ($this->shareManager->shareProviderExists(IShare::TYPE_EMAIL)) {
-				$share = $this->shareManager->getShareById('ocMailShare:' . $id, $this->userId);
-				return $share;
-			}
-		} catch (ShareNotFound $e) {
-			// Do nothing, just try the other share type
-		}
-
-		try {
-			$share = $this->shareManager->getShareById('ocRoomShare:' . $id, $this->userId);
-			return $share;
-		} catch (ShareNotFound $e) {
-			// Do nothing, just try the other share type
-		}
-
-		try {
-			if ($this->shareManager->shareProviderExists(IShare::TYPE_DECK)) {
-				$share = $this->shareManager->getShareById('deck:' . $id, $this->userId);
-				return $share;
-			}
-		} catch (ShareNotFound $e) {
-			// Do nothing, just try the other share type
-		}
-
-		try {
-			if ($this->shareManager->shareProviderExists(IShare::TYPE_SCIENCEMESH)) {
-				$share = $this->shareManager->getShareById('sciencemesh:' . $id, $this->userId);
-				return $share;
-			}
-		} catch (ShareNotFound $e) {
-			// Do nothing, just try the other share type
-		}
-
-		if (!$this->shareManager->outgoingServer2ServerSharesAllowed()) {
-			throw new ShareNotFound();
-		}
-		$share = $this->shareManager->getShareById('ocFederatedSharing:' . $id, $this->userId);
-
-		return $share;
-	}
-
-	/**
-	 * Lock a Node
-	 *
-	 * @param Node $node
-	 * @throws LockedException
-	 */
-	private function lock(Node $node) {
-		$node->lock(ILockingProvider::LOCK_SHARED);
-		$this->lockedNode = $node;
-	}
-
-	/**
-	 * Cleanup the remaining locks
-	 * @throws LockedException
-	 */
-	public function cleanup() {
-		if ($this->lockedNode !== null) {
-			$this->lockedNode->unlock(ILockingProvider::LOCK_SHARED);
-		}
-	}
-
-	/**
-	 * Returns the helper of ShareAPIController for room shares.
-	 *
-	 * If the Talk application is not enabled or the helper is not available
-	 * a ContainerExceptionInterface is thrown instead.
-	 *
-	 * @return \OCA\Talk\Share\Helper\ShareAPIController
-	 * @throws ContainerExceptionInterface
-	 */
-	private function getRoomShareHelper() {
-		if (!$this->appManager->isEnabledForUser('spreed')) {
-			throw new QueryException();
-		}
-
-		return $this->serverContainer->get('\OCA\Talk\Share\Helper\ShareAPIController');
-	}
-
-	/**
-	 * Returns the helper of ShareAPIHelper for deck shares.
-	 *
-	 * If the Deck application is not enabled or the helper is not available
-	 * a ContainerExceptionInterface is thrown instead.
-	 *
-	 * @return \OCA\Deck\Sharing\ShareAPIHelper
-	 * @throws ContainerExceptionInterface
-	 */
-	private function getDeckShareHelper() {
-		if (!$this->appManager->isEnabledForUser('deck')) {
-			throw new QueryException();
-		}
-
-		return $this->serverContainer->get('\OCA\Deck\Sharing\ShareAPIHelper');
-	}
-
-	/**
-	 * Returns the helper of ShareAPIHelper for sciencemesh shares.
-	 *
-	 * If the sciencemesh application is not enabled or the helper is not available
-	 * a ContainerExceptionInterface is thrown instead.
-	 *
-	 * @return \OCA\Deck\Sharing\ShareAPIHelper
-	 * @throws ContainerExceptionInterface
-	 */
-	private function getSciencemeshShareHelper() {
-		if (!$this->appManager->isEnabledForUser('sciencemesh')) {
-			throw new QueryException();
-		}
-
-		return $this->serverContainer->get('\OCA\ScienceMesh\Sharing\ShareAPIHelper');
-	}
-
-	/**
-	 * @param string $viewer
-	 * @param Node $node
-	 * @param bool $reShares
-	 *
-	 * @return IShare[]
-	 */
-	private function getSharesFromNode(string $viewer, $node, bool $reShares): array {
-		$providers = [
-			IShare::TYPE_USER,
-			IShare::TYPE_GROUP,
-			IShare::TYPE_LINK,
-			IShare::TYPE_EMAIL,
-			IShare::TYPE_CIRCLE,
-			IShare::TYPE_ROOM,
-			IShare::TYPE_DECK,
-			IShare::TYPE_SCIENCEMESH
-		];
-
-		// Should we assume that the (currentUser) viewer is the owner of the node !?
-		$shares = [];
-		foreach ($providers as $provider) {
-			if (!$this->shareManager->shareProviderExists($provider)) {
-				continue;
-			}
-
-			$providerShares =
-				$this->shareManager->getSharesBy($viewer, $provider, $node, $reShares, -1, 0);
-			$shares = array_merge($shares, $providerShares);
-		}
-
-		if ($this->shareManager->outgoingServer2ServerSharesAllowed()) {
-			$federatedShares = $this->shareManager->getSharesBy(
-				$this->userId, IShare::TYPE_REMOTE, $node, $reShares, -1, 0
-			);
-			$shares = array_merge($shares, $federatedShares);
-		}
-
-		if ($this->shareManager->outgoingServer2ServerGroupSharesAllowed()) {
-			$federatedShares = $this->shareManager->getSharesBy(
-				$this->userId, IShare::TYPE_REMOTE_GROUP, $node, $reShares, -1, 0
-			);
-			$shares = array_merge($shares, $federatedShares);
-		}
-
-		return $shares;
-	}
-
-
-	/**
-	 * @param Node $node
-	 *
-	 * @throws SharingRightsException
-	 */
-	private function confirmSharingRights(Node $node): void {
-		if (!$this->hasResharingRights($this->userId, $node)) {
-			throw new SharingRightsException($this->l->t('No sharing rights on this item'));
-		}
-	}
-
-
-	/**
-	 * @param string $viewer
-	 * @param Node $node
-	 *
-	 * @return bool
-	 */
-	private function hasResharingRights($viewer, $node): bool {
-		if ($viewer === $node->getOwner()->getUID()) {
-			return true;
-		}
-
-		foreach ([$node, $node->getParent()] as $node) {
-			$shares = $this->getSharesFromNode($viewer, $node, true);
-			foreach ($shares as $share) {
-				try {
-					if ($this->shareProviderResharingRights($viewer, $share, $node)) {
-						return true;
-					}
-				} catch (InvalidPathException|NotFoundException $e) {
-				}
-			}
-		}
-
-		return false;
-	}
-
-
-	/**
-	 * Returns if we can find resharing rights in an IShare object for a specific user.
-	 *
-	 * @suppress PhanUndeclaredClassMethod
-	 *
-	 * @param string $userId
-	 * @param IShare $share
-	 * @param Node $node
-	 *
-	 * @return bool
-	 * @throws NotFoundException
-	 * @throws InvalidPathException
-	 */
-	private function shareProviderResharingRights(string $userId, IShare $share, $node): bool {
-		if ($share->getShareOwner() === $userId) {
-			return true;
-		}
-
-		// we check that current user have parent resharing rights on the current file
-		if ($node !== null && ($node->getPermissions() & Constants::PERMISSION_SHARE) !== 0) {
-			return true;
-		}
-
-		if ((Constants::PERMISSION_SHARE & $share->getPermissions()) === 0) {
-			return false;
-		}
-
-		if ($share->getShareType() === IShare::TYPE_USER && $share->getSharedWith() === $userId) {
-			return true;
-		}
-
-		if ($share->getShareType() === IShare::TYPE_GROUP && $this->groupManager->isInGroup($userId, $share->getSharedWith())) {
-			return true;
-		}
-
-		if ($share->getShareType() === IShare::TYPE_CIRCLE && Server::get(IAppManager::class)->isEnabledForUser('circles')
-			&& class_exists('\OCA\Circles\Api\v1\Circles')) {
-			$hasCircleId = (str_ends_with($share->getSharedWith(), ']'));
-			$shareWithStart = ($hasCircleId ? strrpos($share->getSharedWith(), '[') + 1 : 0);
-			$shareWithLength = ($hasCircleId ? -1 : strpos($share->getSharedWith(), ' '));
-			if ($shareWithLength === false) {
-				$sharedWith = substr($share->getSharedWith(), $shareWithStart);
-			} else {
-				$sharedWith = substr($share->getSharedWith(), $shareWithStart, $shareWithLength);
-			}
-			try {
-				$member = Circles::getMember($sharedWith, $userId, 1);
-				if ($member->getLevel() >= 4) {
-					return true;
-				}
-				return false;
-			} catch (ContainerExceptionInterface $e) {
-				return false;
-			}
-		}
-
-		return false;
-	}
-
-	/**
-	 * Get all the shares for the current user
-	 *
-	 * @param Node|null $path
-	 * @param boolean $reshares
-	 * @return IShare[]
-	 */
-	private function getAllShares(?Node $path = null, bool $reshares = false) {
-		// Get all shares
-		$userShares = $this->shareManager->getSharesBy($this->userId, IShare::TYPE_USER, $path, $reshares, -1, 0);
-		$groupShares = $this->shareManager->getSharesBy($this->userId, IShare::TYPE_GROUP, $path, $reshares, -1, 0);
-		$linkShares = $this->shareManager->getSharesBy($this->userId, IShare::TYPE_LINK, $path, $reshares, -1, 0);
-
-		// EMAIL SHARES
-		$mailShares = $this->shareManager->getSharesBy($this->userId, IShare::TYPE_EMAIL, $path, $reshares, -1, 0);
-
-		// TEAM SHARES
-		$circleShares = $this->shareManager->getSharesBy($this->userId, IShare::TYPE_CIRCLE, $path, $reshares, -1, 0);
-
-		// TALK SHARES
-		$roomShares = $this->shareManager->getSharesBy($this->userId, IShare::TYPE_ROOM, $path, $reshares, -1, 0);
-
-		// DECK SHARES
-		$deckShares = $this->shareManager->getSharesBy($this->userId, IShare::TYPE_DECK, $path, $reshares, -1, 0);
-
-		// SCIENCEMESH SHARES
-		$sciencemeshShares = $this->shareManager->getSharesBy($this->userId, IShare::TYPE_SCIENCEMESH, $path, $reshares, -1, 0);
-
-		// FEDERATION
-		if ($this->shareManager->outgoingServer2ServerSharesAllowed()) {
-			$federatedShares = $this->shareManager->getSharesBy($this->userId, IShare::TYPE_REMOTE, $path, $reshares, -1, 0);
-		} else {
-			$federatedShares = [];
-		}
-		if ($this->shareManager->outgoingServer2ServerGroupSharesAllowed()) {
-			$federatedGroupShares = $this->shareManager->getSharesBy($this->userId, IShare::TYPE_REMOTE_GROUP, $path, $reshares, -1, 0);
-		} else {
-			$federatedGroupShares = [];
-		}
-
-		return array_merge($userShares, $groupShares, $linkShares, $mailShares, $circleShares, $roomShares, $deckShares, $sciencemeshShares, $federatedShares, $federatedGroupShares);
-	}
-
-
-	/**
-	 * merging already formatted shares.
-	 * We'll make an associative array to easily detect duplicate Ids.
-	 * Keys _needs_ to be removed after all shares are retrieved and merged.
-	 *
-	 * @param array $shares
-	 * @param array $newShares
-	 */
-	private function mergeFormattedShares(array &$shares, array $newShares) {
-		foreach ($newShares as $newShare) {
-			if (!array_key_exists($newShare['id'], $shares)) {
-				$shares[$newShare['id']] = $newShare;
-			}
-		}
-	}
-
-	/**
-	 * @param IShare $share
-	 * @param string|null $attributesString
-	 * @return IShare modified share
-	 */
-	private function setShareAttributes(IShare $share, ?string $attributesString) {
-		$newShareAttributes = null;
-		if ($attributesString !== null) {
-			$newShareAttributes = $this->shareManager->newShare()->newAttributes();
-			$formattedShareAttributes = \json_decode($attributesString, true);
-			if (is_array($formattedShareAttributes)) {
-				foreach ($formattedShareAttributes as $formattedAttr) {
-					$newShareAttributes->setAttribute(
-						$formattedAttr['scope'],
-						$formattedAttr['key'],
-						$formattedAttr['value'],
-					);
-				}
-			} else {
-				throw new OCSBadRequestException($this->l->t('Invalid share attributes provided: "%s"', [$attributesString]));
-			}
-		}
-		$share->setAttributes($newShareAttributes);
-
-		return $share;
-	}
-
-	private function checkInheritedAttributes(IShare $share): void {
-		if (!$share->getSharedBy()) {
-			return; // Probably in a test
-		}
-
-		$canDownload = false;
-		$hideDownload = true;
-
-		$userFolder = $this->rootFolder->getUserFolder($share->getSharedBy());
-		$nodes = $userFolder->getById($share->getNodeId());
-		foreach ($nodes as $node) {
-			// Owner always can download it - so allow it and break
-			if ($node->getOwner()?->getUID() === $share->getSharedBy()) {
-				$canDownload = true;
-				$hideDownload = false;
-				break;
-			}
-
-			if ($node->getStorage()->instanceOfStorage(SharedStorage::class)) {
-				$storage = $node->getStorage();
-				if ($storage instanceof Wrapper) {
-					$storage = $storage->getInstanceOfStorage(SharedStorage::class);
-					if ($storage === null) {
-						throw new \RuntimeException('Should not happen, instanceOfStorage but getInstanceOfStorage return null');
-					}
-				} else {
-					throw new \RuntimeException('Should not happen, instanceOfStorage but not a wrapper');
-				}
-
-				/** @var SharedStorage $storage */
-				$originalShare = $storage->getShare();
-				$inheritedAttributes = $originalShare->getAttributes();
-				// hide if hidden and also the current share enforces hide (can only be false if one share is false or user is owner)
-				$hideDownload = $hideDownload && $originalShare->getHideDownload();
-				// allow download if already allowed by previous share or when the current share allows downloading
-				$canDownload = $canDownload || $inheritedAttributes === null || $inheritedAttributes->getAttribute('permissions', 'download') !== false;
-			}
-		}
-
-		if ($hideDownload || !$canDownload) {
-			$share->setHideDownload(true);
-
-			if (!$canDownload) {
-				$attributes = $share->getAttributes() ?? $share->newAttributes();
-				$attributes->setAttribute('permissions', 'download', false);
-				$share->setAttributes($attributes);
-			}
-		}
-	}
-
-	/**
-	 * Send a mail notification again for a share.
-	 * The mail_send option must be enabled for the given share.
-	 * @param string $id the share ID
-	 * @param string $password the password to check against. Necessary for password protected shares.
-	 * @throws OCSNotFoundException Share not found
-	 * @throws OCSForbiddenException You are not allowed to send mail notifications
-	 * @throws OCSBadRequestException Invalid request or wrong password
-	 * @throws OCSException Error while sending mail notification
-	 * @return DataResponse<Http::STATUS_OK, list<empty>, array{}>
-	 *
-	 * 200: The email notification was sent successfully
-	 */
-	#[NoAdminRequired]
-	#[UserRateLimit(limit: 10, period: 600)]
-	public function sendShareEmail(string $id, $password = ''): DataResponse {
-		try {
-			$share = $this->getShareById($id);
-
-			if (!$this->canAccessShare($share, false)) {
-				throw new OCSNotFoundException($this->l->t('Wrong share ID, share does not exist'));
-			}
-
-			if (!$this->canEditShare($share)) {
-				throw new OCSForbiddenException($this->l->t('You are not allowed to send mail notifications'));
-			}
-
-			// For mail and link shares, the user must be
-			// the owner of the share, not only the file owner.
-			if ($share->getShareType() === IShare::TYPE_EMAIL
-				|| $share->getShareType() === IShare::TYPE_LINK) {
-				if ($share->getSharedBy() !== $this->userId) {
-					throw new OCSForbiddenException($this->l->t('You are not allowed to send mail notifications'));
-				}
-			}
-
-			try {
-				$provider = $this->factory->getProviderForType($share->getShareType());
-				if (!($provider instanceof IShareProviderWithNotification)) {
-					throw new OCSBadRequestException($this->l->t('No mail notification configured for this share type'));
-				}
-
-				// Circumvent the password encrypted data by
-				// setting the password clear. We're not storing
-				// the password clear, it is just a temporary
-				// object manipulation. The password will stay
-				// encrypted in the database.
-				if ($share->getPassword() !== null && $share->getPassword() !== $password) {
-					if (!$this->shareManager->checkPassword($share, $password)) {
-						throw new OCSBadRequestException($this->l->t('Wrong password'));
-					}
-					$share = $share->setPassword($password);
-				}
-
-				$provider->sendMailNotification($share);
-				return new DataResponse();
-			} catch (Exception $e) {
-				$this->logger->error($e->getMessage(), ['exception' => $e]);
-				throw new OCSException($this->l->t('Error while sending mail notification'));
-			}
-
-		} catch (ShareNotFound $e) {
-			throw new OCSNotFoundException($this->l->t('Wrong share ID, share does not exist'));
-		}
-	}
-
-	/**
-	 * Get a unique share token
-	 *
-	 * @throws OCSException Failed to generate a unique token
-	 *
-	 * @return DataResponse<Http::STATUS_OK, array{token: string}, array{}>
-	 *
-	 * 200: Token generated successfully
-	 */
-	#[ApiRoute(verb: 'GET', url: '/api/v1/token')]
-	#[NoAdminRequired]
-	public function generateToken(): DataResponse {
-		try {
-			$token = $this->shareManager->generateToken();
-			return new DataResponse([
-				'token' => $token,
-			]);
-		} catch (ShareTokenException $e) {
-			throw new OCSException($this->l->t('Failed to generate a unique token'));
-		}
-	}
+                continue;
+            }
+
+            if (in_array($share->getId(), $known)
+                || ($share->getSharedWith() === $this->userId && $share->getShareType() === IShare::TYPE_USER)) {
+                continue;
+            }
+
+            $known[] = $share->getId();
+            try {
+                /** @var IShare $share */
+                $format = $this->formatShare($share, $node);
+                $formatted[] = $format;
+
+                // let's also build a list of shares created
+                // by the current user only, in case
+                // there is no resharing rights
+                if ($share->getSharedBy() === $this->userId) {
+                    $miniFormatted[] = $format;
+                }
+
+                // check if one of those share is shared with me
+                // and if I have resharing rights on it
+                if (!$resharingRight && $this->shareProviderResharingRights($this->userId, $share, $node)) {
+                    $resharingRight = true;
+                }
+            } catch (InvalidPathException|NotFoundException $e) {
+            }
+        }
+
+        if (!$resharingRight) {
+            $formatted = $miniFormatted;
+        }
+
+        // fix eventual missing display name from federated shares
+        $formatted = $this->fixMissingDisplayName($formatted);
+
+        if ($includeTags) {
+            $formatted =
+                Helper::populateTags($formatted, Server::get(ITagManager::class));
+        }
+
+        return $formatted;
+    }
+
+
+    /**
+     * Get all shares relative to a file, including parent folders shares rights
+     *
+     * @param string $path Path all shares will be relative to
+     *
+     * @return DataResponse<Http::STATUS_OK, list<Files_SharingShare>, array{}>
+     * @throws InvalidPathException
+     * @throws NotFoundException
+     * @throws OCSNotFoundException The given path is invalid
+     * @throws SharingRightsException
+     *
+     * 200: Shares returned
+     */
+    #[NoAdminRequired]
+    public function getInheritedShares(string $path): DataResponse {
+        // get Node from (string) path.
+        $userFolder = $this->rootFolder->getUserFolder($this->userId);
+        try {
+            $node = $userFolder->get($path);
+            $this->lock($node);
+        } catch (NotFoundException $e) {
+            throw new OCSNotFoundException($this->l->t('Wrong path, file/folder does not exist'));
+        } catch (LockedException $e) {
+            throw new OCSNotFoundException($this->l->t('Could not lock path'));
+        }
+
+        if (!($node->getPermissions() & Constants::PERMISSION_SHARE)) {
+            throw new SharingRightsException($this->l->t('no sharing rights on this item'));
+        }
+
+        // The current top parent we have access to
+        $parent = $node;
+
+        // initiate real owner.
+        $owner = $node->getOwner()
+            ->getUID();
+        if (!$this->userManager->userExists($owner)) {
+            return new DataResponse([]);
+        }
+
+        // get node based on the owner, fix owner in case of external storage
+        $userFolder = $this->rootFolder->getUserFolder($owner);
+        if ($node->getId() !== $userFolder->getId() && !$userFolder->isSubNode($node)) {
+            $owner = $node->getOwner()
+                ->getUID();
+            $userFolder = $this->rootFolder->getUserFolder($owner);
+            $node = $userFolder->getFirstNodeById($node->getId());
+        }
+        $basePath = $userFolder->getPath();
+
+        // generate node list for each parent folders
+        /** @var Node[] $nodes */
+        $nodes = [];
+        while (true) {
+            $node = $node->getParent();
+            if ($node->getPath() === $basePath) {
+                break;
+            }
+            $nodes[] = $node;
+        }
+
+        // The user that is requesting this list
+        $currentUserFolder = $this->rootFolder->getUserFolder($this->userId);
+
+        // for each nodes, retrieve shares.
+        $shares = [];
+
+        foreach ($nodes as $node) {
+            $getShares = $this->getFormattedShares($owner, $node, false, true);
+
+            $currentUserNode = $currentUserFolder->getFirstNodeById($node->getId());
+            if ($currentUserNode) {
+                $parent = $currentUserNode;
+            }
+
+            $subPath = $currentUserFolder->getRelativePath($parent->getPath());
+            foreach ($getShares as &$share) {
+                $share['via_fileid'] = $parent->getId();
+                $share['via_path'] = $subPath;
+            }
+            $this->mergeFormattedShares($shares, $getShares);
+        }
+
+        return new DataResponse(array_values($shares));
+    }
+
+    /**
+     * Check whether a set of permissions contains the permissions to check.
+     */
+    private function hasPermission(int $permissionsSet, int $permissionsToCheck): bool {
+        return ($permissionsSet & $permissionsToCheck) === $permissionsToCheck;
+    }
+
+    /**
+     * Update a share
+     *
+     * @param string $id ID of the share
+     * @param int|null $permissions New permissions
+     * @param string|null $password New password
+     * @param string|null $sendPasswordByTalk New condition if the password should be send over Talk
+     * @param string|null $publicUpload New condition if public uploading is allowed
+     * @param string|null $expireDate New expiry date
+     * @param string|null $note New note
+     * @param string|null $label New label
+     * @param string|null $hideDownload New condition if the download should be hidden
+     * @param string|null $attributes New additional attributes
+     * @param string|null $sendMail if the share should be send by mail.
+     *                              Considering the share already exists, no mail will be send after the share is updated.
+     *                              You will have to use the sendMail action to send the mail.
+     * @param string|null $shareWith New recipient for email shares
+     * @param string|null $token New token
+     * @return DataResponse<Http::STATUS_OK, Files_SharingShare, array{}>
+     * @throws OCSBadRequestException Share could not be updated because the requested changes are invalid
+     * @throws OCSForbiddenException Missing permissions to update the share
+     * @throws OCSNotFoundException Share not found
+     *
+     * 200: Share updated successfully
+     */
+    #[NoAdminRequired]
+    public function updateShare(
+        string $id,
+        ?int $permissions = null,
+        ?string $password = null,
+        ?string $sendPasswordByTalk = null,
+        ?string $publicUpload = null,
+        ?string $expireDate = null,
+        ?string $note = null,
+        ?string $label = null,
+        ?string $hideDownload = null,
+        ?string $attributes = null,
+        ?string $sendMail = null,
+        ?string $token = null,
+    ): DataResponse {
+        try {
+            $share = $this->getShareById($id);
+        } catch (ShareNotFound $e) {
+            throw new OCSNotFoundException($this->l->t('Wrong share ID, share does not exist'));
+        }
+
+        $this->lock($share->getNode());
+
+        if (!$this->canAccessShare($share, false)) {
+            throw new OCSNotFoundException($this->l->t('Wrong share ID, share does not exist'));
+        }
+
+        if (!$this->canEditShare($share)) {
+            throw new OCSForbiddenException($this->l->t('You are not allowed to edit incoming shares'));
+        }
+
+        if (
+            $permissions === null &&
+            $password === null &&
+            $sendPasswordByTalk === null &&
+            $publicUpload === null &&
+            $expireDate === null &&
+            $note === null &&
+            $label === null &&
+            $hideDownload === null &&
+            $attributes === null &&
+            $sendMail === null &&
+            $token === null
+        ) {
+            throw new OCSBadRequestException($this->l->t('Wrong or no update parameter given'));
+        }
+
+        if ($note !== null) {
+            $share->setNote($note);
+        }
+
+        if ($attributes !== null) {
+            $share = $this->setShareAttributes($share, $attributes);
+        }
+
+        // Handle mail send
+        if ($sendMail === 'true' || $sendMail === 'false') {
+            $share->setMailSend($sendMail === 'true');
+        }
+
+        /**
+         * expiration date, password and publicUpload only make sense for link shares
+         */
+        if ($share->getShareType() === IShare::TYPE_LINK
+            || $share->getShareType() === IShare::TYPE_EMAIL) {
+
+            // Update hide download state
+            if ($hideDownload === 'true') {
+                $share->setHideDownload(true);
+            } elseif ($hideDownload === 'false') {
+                $share->setHideDownload(false);
+            }
+
+            // If either manual permissions are specified or publicUpload
+            // then we need to also update the permissions of the share
+            if ($permissions !== null || $publicUpload !== null) {
+                $hasPublicUpload = $this->getLegacyPublicUpload($publicUpload);
+                $permissions = $this->getLinkSharePermissions($permissions ?? Constants::PERMISSION_READ, $hasPublicUpload);
+                $this->validateLinkSharePermissions($share->getNode(), $permissions, $hasPublicUpload);
+                $share->setPermissions($permissions);
+            }
+
+            if ($password === '') {
+                $share->setPassword(null);
+            } elseif ($password !== null) {
+                $share->setPassword($password);
+            }
+
+            if ($label !== null) {
+                if (strlen($label) > 255) {
+                    throw new OCSBadRequestException('Maximum label length is 255');
+                }
+                $share->setLabel($label);
+            }
+
+            if ($sendPasswordByTalk === 'true') {
+                if (!$this->appManager->isEnabledForUser('spreed')) {
+                    throw new OCSForbiddenException($this->l->t('"Sending the password by Nextcloud Talk" for sharing a file or folder failed because Nextcloud Talk is not enabled.'));
+                }
+
+                $share->setSendPasswordByTalk(true);
+            } elseif ($sendPasswordByTalk !== null) {
+                $share->setSendPasswordByTalk(false);
+            }
+
+            if ($token !== null) {
+                if (!$this->shareManager->allowCustomTokens()) {
+                    throw new OCSForbiddenException($this->l->t('Custom share link tokens have been disabled by the administrator'));
+                }
+                if (!$this->validateToken($token)) {
+                    throw new OCSBadRequestException($this->l->t('Tokens must contain at least 1 character and may only contain letters, numbers, or a hyphen'));
+                }
+                $share->setToken($token);
+            }
+        }
+
+        // NOT A LINK SHARE
+        else {
+            if ($permissions !== null) {
+                $share->setPermissions($permissions);
+            }
+        }
+
+        if ($expireDate === '') {
+            $share->setExpirationDate(null);
+        } elseif ($expireDate !== null) {
+            try {
+                $expireDateTime = $this->parseDate($expireDate);
+                $share->setExpirationDate($expireDateTime);
+            } catch (\Exception $e) {
+                throw new OCSBadRequestException($e->getMessage(), $e);
+            }
+        }
+
+        try {
+            $this->checkInheritedAttributes($share);
+            $share = $this->shareManager->updateShare($share);
+        } catch (HintException $e) {
+            $code = $e->getCode() === 0 ? 403 : $e->getCode();
+            throw new OCSException($e->getHint(), (int)$code);
+        } catch (\Exception $e) {
+            $this->logger->error($e->getMessage(), ['exception' => $e]);
+            throw new OCSBadRequestException('Failed to update share.', $e);
+        }
+
+        return new DataResponse($this->formatShare($share));
+    }
+
+    private function validateToken(string $token): bool {
+        if (mb_strlen($token) === 0) {
+            return false;
+        }
+        if (!preg_match('/^[a-z0-9-]+$/i', $token)) {
+            return false;
+        }
+        return true;
+    }
+
+    /**
+     * Get all shares that are still pending
+     *
+     * @return DataResponse<Http::STATUS_OK, list<Files_SharingShare>, array{}>
+     *
+     * 200: Pending shares returned
+     */
+    #[NoAdminRequired]
+    public function pendingShares(): DataResponse {
+        $pendingShares = [];
+
+        $shareTypes = [
+            IShare::TYPE_USER,
+            IShare::TYPE_GROUP
+        ];
+
+        foreach ($shareTypes as $shareType) {
+            $shares = $this->shareManager->getSharedWith($this->userId, $shareType, null, -1, 0);
+
+            foreach ($shares as $share) {
+                if ($share->getStatus() === IShare::STATUS_PENDING || $share->getStatus() === IShare::STATUS_REJECTED) {
+                    $pendingShares[] = $share;
+                }
+            }
+        }
+
+        $result = array_values(array_filter(array_map(function (IShare $share) {
+            $userFolder = $this->rootFolder->getUserFolder($share->getSharedBy());
+            $node = $userFolder->getFirstNodeById($share->getNodeId());
+            if (!$node) {
+                // fallback to guessing the path
+                $node = $userFolder->get($share->getTarget());
+                if ($node === null || $share->getTarget() === '') {
+                    return null;
+                }
+            }
+
+            try {
+                $formattedShare = $this->formatShare($share, $node);
+                $formattedShare['path'] = '/' . $share->getNode()->getName();
+                $formattedShare['permissions'] = 0;
+                return $formattedShare;
+            } catch (NotFoundException $e) {
+                return null;
+            }
+        }, $pendingShares), function ($entry) {
+            return $entry !== null;
+        }));
+
+        return new DataResponse($result);
+    }
+
+    /**
+     * Accept a share
+     *
+     * @param string $id ID of the share
+     * @return DataResponse<Http::STATUS_OK, list<empty>, array{}>
+     * @throws OCSNotFoundException Share not found
+     * @throws OCSException
+     * @throws OCSBadRequestException Share could not be accepted
+     *
+     * 200: Share accepted successfully
+     */
+    #[NoAdminRequired]
+    public function acceptShare(string $id): DataResponse {
+        try {
+            $share = $this->getShareById($id);
+        } catch (ShareNotFound $e) {
+            throw new OCSNotFoundException($this->l->t('Wrong share ID, share does not exist'));
+        }
+
+        if (!$this->canAccessShare($share)) {
+            throw new OCSNotFoundException($this->l->t('Wrong share ID, share does not exist'));
+        }
+
+        try {
+            $this->shareManager->acceptShare($share, $this->userId);
+        } catch (HintException $e) {
+            $code = $e->getCode() === 0 ? 403 : $e->getCode();
+            throw new OCSException($e->getHint(), (int)$code);
+        } catch (\Exception $e) {
+            $this->logger->error($e->getMessage(), ['exception' => $e]);
+            throw new OCSBadRequestException('Failed to accept share.', $e);
+        }
+
+        return new DataResponse();
+    }
+
+    /**
+     * Does the user have read permission on the share
+     *
+     * @param IShare $share the share to check
+     * @param boolean $checkGroups check groups as well?
+     * @return boolean
+     * @throws NotFoundException
+     *
+     * @suppress PhanUndeclaredClassMethod
+     */
+    protected function canAccessShare(IShare $share, bool $checkGroups = true): bool {
+        // A file with permissions 0 can't be accessed by us. So Don't show it
+        if ($share->getPermissions() === 0) {
+            return false;
+        }
+
+        // Owner of the file and the sharer of the file can always get share
+        if ($share->getShareOwner() === $this->userId
+            || $share->getSharedBy() === $this->userId) {
+            return true;
+        }
+
+        // If the share is shared with you, you can access it!
+        if ($share->getShareType() === IShare::TYPE_USER
+            && $share->getSharedWith() === $this->userId) {
+            return true;
+        }
+
+        // Have reshare rights on the shared file/folder ?
+        // Does the currentUser have access to the shared file?
+        $userFolder = $this->rootFolder->getUserFolder($this->userId);
+        $file = $userFolder->getFirstNodeById($share->getNodeId());
+        if ($file && $this->shareProviderResharingRights($this->userId, $share, $file)) {
+            return true;
+        }
+
+        // If in the recipient group, you can see the share
+        if ($checkGroups && $share->getShareType() === IShare::TYPE_GROUP) {
+            $sharedWith = $this->groupManager->get($share->getSharedWith());
+            $user = $this->userManager->get($this->userId);
+            if ($user !== null && $sharedWith !== null && $sharedWith->inGroup($user)) {
+                return true;
+            }
+        }
+
+        if ($share->getShareType() === IShare::TYPE_CIRCLE) {
+            // TODO: have a sanity check like above?
+            return true;
+        }
+
+        if ($share->getShareType() === IShare::TYPE_ROOM) {
+            try {
+                return $this->getRoomShareHelper()->canAccessShare($share, $this->userId);
+            } catch (ContainerExceptionInterface $e) {
+                return false;
+            }
+        }
+
+        if ($share->getShareType() === IShare::TYPE_DECK) {
+            try {
+                return $this->getDeckShareHelper()->canAccessShare($share, $this->userId);
+            } catch (ContainerExceptionInterface $e) {
+                return false;
+            }
+        }
+
+        if ($share->getShareType() === IShare::TYPE_SCIENCEMESH) {
+            try {
+                return $this->getSciencemeshShareHelper()->canAccessShare($share, $this->userId);
+            } catch (ContainerExceptionInterface $e) {
+                return false;
+            }
+        }
+
+        return false;
+    }
+
+    /**
+     * Does the user have edit permission on the share
+     *
+     * @param IShare $share the share to check
+     * @return boolean
+     */
+    protected function canEditShare(IShare $share): bool {
+        // A file with permissions 0 can't be accessed by us. So Don't show it
+        if ($share->getPermissions() === 0) {
+            return false;
+        }
+
+        // The owner of the file and the creator of the share
+        // can always edit the share
+        if ($share->getShareOwner() === $this->userId ||
+            $share->getSharedBy() === $this->userId
+        ) {
+            return true;
+        }
+
+        $userFolder = $this->rootFolder->getUserFolder($this->userId);
+        $file = $userFolder->getFirstNodeById($share->getNodeId());
+        if ($file?->getMountPoint() instanceof IShareOwnerlessMount && $this->shareProviderResharingRights($this->userId, $share, $file)) {
+            return true;
+        }
+
+        //! we do NOT support some kind of `admin` in groups.
+        //! You cannot edit shares shared to a group you're
+        //! a member of if you're not the share owner or the file owner!
+
+        return false;
+    }
+
+    /**
+     * Does the user have delete permission on the share
+     *
+     * @param IShare $share the share to check
+     * @return boolean
+     */
+    protected function canDeleteShare(IShare $share): bool {
+        // A file with permissions 0 can't be accessed by us. So Don't show it
+        if ($share->getPermissions() === 0) {
+            return false;
+        }
+
+        // if the user is the recipient, i can unshare
+        // the share with self
+        if ($share->getShareType() === IShare::TYPE_USER &&
+            $share->getSharedWith() === $this->userId
+        ) {
+            return true;
+        }
+
+        // The owner of the file and the creator of the share
+        // can always delete the share
+        if ($share->getShareOwner() === $this->userId ||
+            $share->getSharedBy() === $this->userId
+        ) {
+            return true;
+        }
+
+        $userFolder = $this->rootFolder->getUserFolder($this->userId);
+        $file = $userFolder->getFirstNodeById($share->getNodeId());
+        if ($file?->getMountPoint() instanceof IShareOwnerlessMount && $this->shareProviderResharingRights($this->userId, $share, $file)) {
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * Does the user have delete permission on the share
+     * This differs from the canDeleteShare function as it only
+     * remove the share for the current user. It does NOT
+     * completely delete the share but only the mount point.
+     * It can then be restored from the deleted shares section.
+     *
+     * @param IShare $share the share to check
+     * @return boolean
+     *
+     * @suppress PhanUndeclaredClassMethod
+     */
+    protected function canDeleteShareFromSelf(IShare $share): bool {
+        if ($share->getShareType() !== IShare::TYPE_GROUP &&
+            $share->getShareType() !== IShare::TYPE_ROOM &&
+            $share->getShareType() !== IShare::TYPE_DECK &&
+            $share->getShareType() !== IShare::TYPE_SCIENCEMESH
+        ) {
+            return false;
+        }
+
+        if ($share->getShareOwner() === $this->userId ||
+            $share->getSharedBy() === $this->userId
+        ) {
+            // Delete the whole share, not just for self
+            return false;
+        }
+
+        // If in the recipient group, you can delete the share from self
+        if ($share->getShareType() === IShare::TYPE_GROUP) {
+            $sharedWith = $this->groupManager->get($share->getSharedWith());
+            $user = $this->userManager->get($this->userId);
+            if ($user !== null && $sharedWith !== null && $sharedWith->inGroup($user)) {
+                return true;
+            }
+        }
+
+        if ($share->getShareType() === IShare::TYPE_ROOM) {
+            try {
+                return $this->getRoomShareHelper()->canAccessShare($share, $this->userId);
+            } catch (ContainerExceptionInterface $e) {
+                return false;
+            }
+        }
+
+        if ($share->getShareType() === IShare::TYPE_DECK) {
+            try {
+                return $this->getDeckShareHelper()->canAccessShare($share, $this->userId);
+            } catch (ContainerExceptionInterface $e) {
+                return false;
+            }
+        }
+
+        if ($share->getShareType() === IShare::TYPE_SCIENCEMESH) {
+            try {
+                return $this->getSciencemeshShareHelper()->canAccessShare($share, $this->userId);
+            } catch (ContainerExceptionInterface $e) {
+                return false;
+            }
+        }
+
+        return false;
+    }
+
+    /**
+     * Make sure that the passed date is valid ISO 8601
+     * So YYYY-MM-DD
+     * If not throw an exception
+     *
+     * @param string $expireDate
+     *
+     * @throws \Exception
+     * @return \DateTime
+     */
+    private function parseDate(string $expireDate): \DateTime {
+        try {
+            $date = new \DateTime(trim($expireDate, '"'), $this->dateTimeZone->getTimeZone());
+            // Make sure it expires at midnight in owner timezone
+            $date->setTime(0, 0, 0);
+        } catch (\Exception $e) {
+            throw new \Exception($this->l->t('Invalid date. Format must be YYYY-MM-DD'));
+        }
+
+        return $date;
+    }
+
+    /**
+     * Since we have multiple providers but the OCS Share API v1 does
+     * not support this we need to check all backends.
+     *
+     * @param string $id
+     * @return IShare
+     * @throws ShareNotFound
+     */
+    private function getShareById(string $id): IShare {
+        $share = null;
+
+        // First check if it is an internal share.
+        try {
+            $share = $this->shareManager->getShareById('ocinternal:' . $id, $this->userId);
+            return $share;
+        } catch (ShareNotFound $e) {
+            // Do nothing, just try the other share type
+        }
+
+
+        try {
+            if ($this->shareManager->shareProviderExists(IShare::TYPE_CIRCLE)) {
+                $share = $this->shareManager->getShareById('ocCircleShare:' . $id, $this->userId);
+                return $share;
+            }
+        } catch (ShareNotFound $e) {
+            // Do nothing, just try the other share type
+        }
+
+        try {
+            if ($this->shareManager->shareProviderExists(IShare::TYPE_EMAIL)) {
+                $share = $this->shareManager->getShareById('ocMailShare:' . $id, $this->userId);
+                return $share;
+            }
+        } catch (ShareNotFound $e) {
+            // Do nothing, just try the other share type
+        }
+
+        try {
+            $share = $this->shareManager->getShareById('ocRoomShare:' . $id, $this->userId);
+            return $share;
+        } catch (ShareNotFound $e) {
+            // Do nothing, just try the other share type
+        }
+
+        try {
+            if ($this->shareManager->shareProviderExists(IShare::TYPE_DECK)) {
+                $share = $this->shareManager->getShareById('deck:' . $id, $this->userId);
+                return $share;
+            }
+        } catch (ShareNotFound $e) {
+            // Do nothing, just try the other share type
+        }
+
+        try {
+            if ($this->shareManager->shareProviderExists(IShare::TYPE_SCIENCEMESH)) {
+                $share = $this->shareManager->getShareById('sciencemesh:' . $id, $this->userId);
+                return $share;
+            }
+        } catch (ShareNotFound $e) {
+            // Do nothing, just try the other share type
+        }
+
+        if (!$this->shareManager->outgoingServer2ServerSharesAllowed()) {
+            throw new ShareNotFound();
+        }
+        $share = $this->shareManager->getShareById('ocFederatedSharing:' . $id, $this->userId);
+
+        return $share;
+    }
+
+    /**
+     * Lock a Node
+     *
+     * @param Node $node
+     * @throws LockedException
+     */
+    private function lock(Node $node) {
+        $node->lock(ILockingProvider::LOCK_SHARED);
+        $this->lockedNode = $node;
+    }
+
+    /**
+     * Cleanup the remaining locks
+     * @throws LockedException
+     */
+    public function cleanup() {
+        if ($this->lockedNode !== null) {
+            $this->lockedNode->unlock(ILockingProvider::LOCK_SHARED);
+        }
+    }
+
+    /**
+     * Returns the helper of ShareAPIController for room shares.
+     *
+     * If the Talk application is not enabled or the helper is not available
+     * a ContainerExceptionInterface is thrown instead.
+     *
+     * @return \OCA\Talk\Share\Helper\ShareAPIController
+     * @throws ContainerExceptionInterface
+     */
+    private function getRoomShareHelper() {
+        if (!$this->appManager->isEnabledForUser('spreed')) {
+            throw new QueryException();
+        }
+
+        return $this->serverContainer->get('\OCA\Talk\Share\Helper\ShareAPIController');
+    }
+
+    /**
+     * Returns the helper of ShareAPIHelper for deck shares.
+     *
+     * If the Deck application is not enabled or the helper is not available
+     * a ContainerExceptionInterface is thrown instead.
+     *
+     * @return \OCA\Deck\Sharing\ShareAPIHelper
+     * @throws ContainerExceptionInterface
+     */
+    private function getDeckShareHelper() {
+        if (!$this->appManager->isEnabledForUser('deck')) {
+            throw new QueryException();
+        }
+
+        return $this->serverContainer->get('\OCA\Deck\Sharing\ShareAPIHelper');
+    }
+
+    /**
+     * Returns the helper of ShareAPIHelper for sciencemesh shares.
+     *
+     * If the sciencemesh application is not enabled or the helper is not available
+     * a ContainerExceptionInterface is thrown instead.
+     *
+     * @return \OCA\Deck\Sharing\ShareAPIHelper
+     * @throws ContainerExceptionInterface
+     */
+    private function getSciencemeshShareHelper() {
+        if (!$this->appManager->isEnabledForUser('sciencemesh')) {
+            throw new QueryException();
+        }
+
+        return $this->serverContainer->get('\OCA\ScienceMesh\Sharing\ShareAPIHelper');
+    }
+
+    /**
+     * @param string $viewer
+     * @param Node $node
+     * @param bool $reShares
+     *
+     * @return IShare[]
+     */
+    private function getSharesFromNode(string $viewer, $node, bool $reShares): array {
+        $providers = [
+            IShare::TYPE_USER,
+            IShare::TYPE_GROUP,
+            IShare::TYPE_LINK,
+            IShare::TYPE_EMAIL,
+            IShare::TYPE_CIRCLE,
+            IShare::TYPE_ROOM,
+            IShare::TYPE_DECK,
+            IShare::TYPE_SCIENCEMESH
+        ];
+
+        // Should we assume that the (currentUser) viewer is the owner of the node !?
+        $shares = [];
+        foreach ($providers as $provider) {
+            if (!$this->shareManager->shareProviderExists($provider)) {
+                continue;
+            }
+
+            $providerShares =
+                $this->shareManager->getSharesBy($viewer, $provider, $node, $reShares, -1, 0);
+            $shares = array_merge($shares, $providerShares);
+        }
+
+        if ($this->shareManager->outgoingServer2ServerSharesAllowed()) {
+            $federatedShares = $this->shareManager->getSharesBy(
+                $this->userId, IShare::TYPE_REMOTE, $node, $reShares, -1, 0
+            );
+            $shares = array_merge($shares, $federatedShares);
+        }
+
+        if ($this->shareManager->outgoingServer2ServerGroupSharesAllowed()) {
+            $federatedShares = $this->shareManager->getSharesBy(
+                $this->userId, IShare::TYPE_REMOTE_GROUP, $node, $reShares, -1, 0
+            );
+            $shares = array_merge($shares, $federatedShares);
+        }
+
+        return $shares;
+    }
+
+
+    /**
+     * @param Node $node
+     *
+     * @throws SharingRightsException
+     */
+    private function confirmSharingRights(Node $node): void {
+        if (!$this->hasResharingRights($this->userId, $node)) {
+            throw new SharingRightsException($this->l->t('No sharing rights on this item'));
+        }
+    }
+
+
+    /**
+     * @param string $viewer
+     * @param Node $node
+     *
+     * @return bool
+     */
+    private function hasResharingRights($viewer, $node): bool {
+        if ($viewer === $node->getOwner()->getUID()) {
+            return true;
+        }
+
+        foreach ([$node, $node->getParent()] as $node) {
+            $shares = $this->getSharesFromNode($viewer, $node, true);
+            foreach ($shares as $share) {
+                try {
+                    if ($this->shareProviderResharingRights($viewer, $share, $node)) {
+                        return true;
+                    }
+                } catch (InvalidPathException|NotFoundException $e) {
+                }
+            }
+        }
+
+        return false;
+    }
+
+
+    /**
+     * Returns if we can find resharing rights in an IShare object for a specific user.
+     *
+     * @suppress PhanUndeclaredClassMethod
+     *
+     * @param string $userId
+     * @param IShare $share
+     * @param Node $node
+     *
+     * @return bool
+     * @throws NotFoundException
+     * @throws InvalidPathException
+     */
+    private function shareProviderResharingRights(string $userId, IShare $share, $node): bool {
+        if ($share->getShareOwner() === $userId) {
+            return true;
+        }
+
+        // we check that current user have parent resharing rights on the current file
+        if ($node !== null && ($node->getPermissions() & Constants::PERMISSION_SHARE) !== 0) {
+            return true;
+        }
+
+        if ((Constants::PERMISSION_SHARE & $share->getPermissions()) === 0) {
+            return false;
+        }
+
+        if ($share->getShareType() === IShare::TYPE_USER && $share->getSharedWith() === $userId) {
+            return true;
+        }
+
+        if ($share->getShareType() === IShare::TYPE_GROUP && $this->groupManager->isInGroup($userId, $share->getSharedWith())) {
+            return true;
+        }
+
+        if ($share->getShareType() === IShare::TYPE_CIRCLE && Server::get(IAppManager::class)->isEnabledForUser('circles')
+            && class_exists('\OCA\Circles\Api\v1\Circles')) {
+            $hasCircleId = (str_ends_with($share->getSharedWith(), ']'));
+            $shareWithStart = ($hasCircleId ? strrpos($share->getSharedWith(), '[') + 1 : 0);
+            $shareWithLength = ($hasCircleId ? -1 : strpos($share->getSharedWith(), ' '));
+            if ($shareWithLength === false) {
+                $sharedWith = substr($share->getSharedWith(), $shareWithStart);
+            } else {
+                $sharedWith = substr($share->getSharedWith(), $shareWithStart, $shareWithLength);
+            }
+            try {
+                $member = Circles::getMember($sharedWith, $userId, 1);
+                if ($member->getLevel() >= 4) {
+                    return true;
+                }
+                return false;
+            } catch (ContainerExceptionInterface $e) {
+                return false;
+            }
+        }
+
+        return false;
+    }
+
+    /**
+     * Get all the shares for the current user
+     *
+     * @param Node|null $path
+     * @param boolean $reshares
+     * @return IShare[]
+     */
+    private function getAllShares(?Node $path = null, bool $reshares = false) {
+        // Get all shares
+        $userShares = $this->shareManager->getSharesBy($this->userId, IShare::TYPE_USER, $path, $reshares, -1, 0);
+        $groupShares = $this->shareManager->getSharesBy($this->userId, IShare::TYPE_GROUP, $path, $reshares, -1, 0);
+        $linkShares = $this->shareManager->getSharesBy($this->userId, IShare::TYPE_LINK, $path, $reshares, -1, 0);
+
+        // EMAIL SHARES
+        $mailShares = $this->shareManager->getSharesBy($this->userId, IShare::TYPE_EMAIL, $path, $reshares, -1, 0);
+
+        // TEAM SHARES
+        $circleShares = $this->shareManager->getSharesBy($this->userId, IShare::TYPE_CIRCLE, $path, $reshares, -1, 0);
+
+        // TALK SHARES
+        $roomShares = $this->shareManager->getSharesBy($this->userId, IShare::TYPE_ROOM, $path, $reshares, -1, 0);
+
+        // DECK SHARES
+        $deckShares = $this->shareManager->getSharesBy($this->userId, IShare::TYPE_DECK, $path, $reshares, -1, 0);
+
+        // SCIENCEMESH SHARES
+        $sciencemeshShares = $this->shareManager->getSharesBy($this->userId, IShare::TYPE_SCIENCEMESH, $path, $reshares, -1, 0);
+
+        // FEDERATION
+        if ($this->shareManager->outgoingServer2ServerSharesAllowed()) {
+            $federatedShares = $this->shareManager->getSharesBy($this->userId, IShare::TYPE_REMOTE, $path, $reshares, -1, 0);
+        } else {
+            $federatedShares = [];
+        }
+        if ($this->shareManager->outgoingServer2ServerGroupSharesAllowed()) {
+            $federatedGroupShares = $this->shareManager->getSharesBy($this->userId, IShare::TYPE_REMOTE_GROUP, $path, $reshares, -1, 0);
+        } else {
+            $federatedGroupShares = [];
+        }
+
+        return array_merge($userShares, $groupShares, $linkShares, $mailShares, $circleShares, $roomShares, $deckShares, $sciencemeshShares, $federatedShares, $federatedGroupShares);
+    }
+
+
+    /**
+     * merging already formatted shares.
+     * We'll make an associative array to easily detect duplicate Ids.
+     * Keys _needs_ to be removed after all shares are retrieved and merged.
+     *
+     * @param array $shares
+     * @param array $newShares
+     */
+    private function mergeFormattedShares(array &$shares, array $newShares) {
+        foreach ($newShares as $newShare) {
+            if (!array_key_exists($newShare['id'], $shares)) {
+                $shares[$newShare['id']] = $newShare;
+            }
+        }
+    }
+
+    /**
+     * @param IShare $share
+     * @param string|null $attributesString
+     * @return IShare modified share
+     */
+    private function setShareAttributes(IShare $share, ?string $attributesString) {
+        $newShareAttributes = null;
+        if ($attributesString !== null) {
+            $newShareAttributes = $this->shareManager->newShare()->newAttributes();
+            $formattedShareAttributes = \json_decode($attributesString, true);
+            if (is_array($formattedShareAttributes)) {
+                foreach ($formattedShareAttributes as $formattedAttr) {
+                    $newShareAttributes->setAttribute(
+                        $formattedAttr['scope'],
+                        $formattedAttr['key'],
+                        $formattedAttr['value'],
+                    );
+                }
+            } else {
+                throw new OCSBadRequestException($this->l->t('Invalid share attributes provided: "%s"', [$attributesString]));
+            }
+        }
+        $share->setAttributes($newShareAttributes);
+
+        return $share;
+    }
+
+    private function checkInheritedAttributes(IShare $share): void {
+        if (!$share->getSharedBy()) {
+            return; // Probably in a test
+        }
+
+        $canDownload = false;
+        $hideDownload = true;
+
+        $userFolder = $this->rootFolder->getUserFolder($share->getSharedBy());
+        $nodes = $userFolder->getById($share->getNodeId());
+        foreach ($nodes as $node) {
+            // Owner always can download it - so allow it and break
+            if ($node->getOwner()?->getUID() === $share->getSharedBy()) {
+                $canDownload = true;
+                $hideDownload = false;
+                break;
+            }
+
+            if ($node->getStorage()->instanceOfStorage(SharedStorage::class)) {
+                $storage = $node->getStorage();
+                if ($storage instanceof Wrapper) {
+                    $storage = $storage->getInstanceOfStorage(SharedStorage::class);
+                    if ($storage === null) {
+                        throw new \RuntimeException('Should not happen, instanceOfStorage but getInstanceOfStorage return null');
+                    }
+                } else {
+                    throw new \RuntimeException('Should not happen, instanceOfStorage but not a wrapper');
+                }
+
+                /** @var SharedStorage $storage */
+                $originalShare = $storage->getShare();
+                $inheritedAttributes = $originalShare->getAttributes();
+                // hide if hidden and also the current share enforces hide (can only be false if one share is false or user is owner)
+                $hideDownload = $hideDownload && $originalShare->getHideDownload();
+                // allow download if already allowed by previous share or when the current share allows downloading
+                $canDownload = $canDownload || $inheritedAttributes === null || $inheritedAttributes->getAttribute('permissions', 'download') !== false;
+            }
+        }
+
+        if ($hideDownload || !$canDownload) {
+            $share->setHideDownload(true);
+
+            if (!$canDownload) {
+                $attributes = $share->getAttributes() ?? $share->newAttributes();
+                $attributes->setAttribute('permissions', 'download', false);
+                $share->setAttributes($attributes);
+            }
+        }
+    }
+
+    /**
+     * Send a mail notification again for a share.
+     * The mail_send option must be enabled for the given share.
+     * @param string $id the share ID
+     * @param string $password the password to check against. Necessary for password protected shares.
+     * @throws OCSNotFoundException Share not found
+     * @throws OCSForbiddenException You are not allowed to send mail notifications
+     * @throws OCSBadRequestException Invalid request or wrong password
+     * @throws OCSException Error while sending mail notification
+     * @return DataResponse<Http::STATUS_OK, list<empty>, array{}>
+     *
+     * 200: The email notification was sent successfully
+     */
+    #[NoAdminRequired]
+    #[UserRateLimit(limit: 10, period: 600)]
+    public function sendShareEmail(string $id, $password = ''): DataResponse {
+        try {
+            $share = $this->getShareById($id);
+
+            if (!$this->canAccessShare($share, false)) {
+                throw new OCSNotFoundException($this->l->t('Wrong share ID, share does not exist'));
+            }
+
+            if (!$this->canEditShare($share)) {
+                throw new OCSForbiddenException($this->l->t('You are not allowed to send mail notifications'));
+            }
+
+            // For mail and link shares, the user must be
+            // the owner of the share, not only the file owner.
+            if ($share->getShareType() === IShare::TYPE_EMAIL
+                || $share->getShareType() === IShare::TYPE_LINK) {
+                if ($share->getSharedBy() !== $this->userId) {
+                    throw new OCSForbiddenException($this->l->t('You are not allowed to send mail notifications'));
+                }
+            }
+
+            try {
+                $provider = $this->factory->getProviderForType($share->getShareType());
+                if (!($provider instanceof IShareProviderWithNotification)) {
+                    throw new OCSBadRequestException($this->l->t('No mail notification configured for this share type'));
+                }
+
+                // Circumvent the password encrypted data by
+                // setting the password clear. We're not storing
+                // the password clear, it is just a temporary
+                // object manipulation. The password will stay
+                // encrypted in the database.
+                if ($share->getPassword() !== null && $share->getPassword() !== $password) {
+                    if (!$this->shareManager->checkPassword($share, $password)) {
+                        throw new OCSBadRequestException($this->l->t('Wrong password'));
+                    }
+                    $share = $share->setPassword($password);
+                }
+
+                $provider->sendMailNotification($share);
+                return new DataResponse();
+            } catch (Exception $e) {
+                $this->logger->error($e->getMessage(), ['exception' => $e]);
+                throw new OCSException($this->l->t('Error while sending mail notification'));
+            }
+
+        } catch (ShareNotFound $e) {
+            throw new OCSNotFoundException($this->l->t('Wrong share ID, share does not exist'));
+        }
+    }
+
+    /**
+     * Get a unique share token
+     *
+     * @throws OCSException Failed to generate a unique token
+     *
+     * @return DataResponse<Http::STATUS_OK, array{token: string}, array{}>
+     *
+     * 200: Token generated successfully
+     */
+    #[ApiRoute(verb: 'GET', url: '/api/v1/token')]
+    #[NoAdminRequired]
+    public function generateToken(): DataResponse {
+        try {
+            $token = $this->shareManager->generateToken();
+            return new DataResponse([
+                'token' => $token,
+            ]);
+        } catch (ShareTokenException $e) {
+            throw new OCSException($this->l->t('Failed to generate a unique token'));
+        }
+    }
 }

apps/files_sharing/lib/DefaultPublicShareTemplateProvider.php

Indentation +194 added lines, -194 removed lines

@@ -38,223 +38,223 @@
 
 class DefaultPublicShareTemplateProvider implements IPublicShareTemplateProvider {
 
-	public function __construct(
-		private IUserManager $userManager,
-		private IAccountManager $accountManager,
-		private IPreview $previewManager,
-		protected FederatedShareProvider $federatedShareProvider,
-		private IUrlGenerator $urlGenerator,
-		private IEventDispatcher $eventDispatcher,
-		private IL10N $l10n,
-		private Defaults $defaults,
-		private IConfig $config,
-		private IRequest $request,
-		private IInitialState $initialState,
-		private IAppConfig $appConfig,
-	) {
-	}
+    public function __construct(
+        private IUserManager $userManager,
+        private IAccountManager $accountManager,
+        private IPreview $previewManager,
+        protected FederatedShareProvider $federatedShareProvider,
+        private IUrlGenerator $urlGenerator,
+        private IEventDispatcher $eventDispatcher,
+        private IL10N $l10n,
+        private Defaults $defaults,
+        private IConfig $config,
+        private IRequest $request,
+        private IInitialState $initialState,
+        private IAppConfig $appConfig,
+    ) {
+    }
 
-	public function shouldRespond(IShare $share): bool {
-		return true;
-	}
+    public function shouldRespond(IShare $share): bool {
+        return true;
+    }
 
-	public function renderPage(IShare $share, string $token, string $path): TemplateResponse {
-		$shareNode = $share->getNode();
-		$ownerName = '';
-		$ownerId = '';
+    public function renderPage(IShare $share, string $token, string $path): TemplateResponse {
+        $shareNode = $share->getNode();
+        $ownerName = '';
+        $ownerId = '';
 
-		// Only make the share owner public if they allowed to show their name
-		$owner = $this->userManager->get($share->getShareOwner());
-		if ($owner instanceof IUser) {
-			$ownerAccount = $this->accountManager->getAccount($owner);
+        // Only make the share owner public if they allowed to show their name
+        $owner = $this->userManager->get($share->getShareOwner());
+        if ($owner instanceof IUser) {
+            $ownerAccount = $this->accountManager->getAccount($owner);
 
-			$ownerNameProperty = $ownerAccount->getProperty(IAccountManager::PROPERTY_DISPLAYNAME);
-			if ($ownerNameProperty->getScope() === IAccountManager::SCOPE_PUBLISHED) {
-				$ownerName = $owner->getDisplayName();
-				$ownerId = $owner->getUID();
-			}
-		}
+            $ownerNameProperty = $ownerAccount->getProperty(IAccountManager::PROPERTY_DISPLAYNAME);
+            if ($ownerNameProperty->getScope() === IAccountManager::SCOPE_PUBLISHED) {
+                $ownerName = $owner->getDisplayName();
+                $ownerId = $owner->getUID();
+            }
+        }
 
-		$view = 'public-share';
-		if ($shareNode instanceof File) {
-			$view = 'public-file-share';
-			$this->initialState->provideInitialState('fileId', $shareNode->getId());
-		} elseif (($share->getPermissions() & Constants::PERMISSION_CREATE)
-			&& !($share->getPermissions() & Constants::PERMISSION_READ)
-		) {
-			// share is a folder with create but no read permissions -> file drop only
-			$view = 'public-file-drop';
-			// Only needed for file drops
-			$this->initialState->provideInitialState(
-				'disclaimer',
-				$this->appConfig->getValueString('core', 'shareapi_public_link_disclaimertext'),
-			);
-		}
-		// Set up initial state
-		$this->initialState->provideInitialState('isPublic', true);
-		$this->initialState->provideInitialState('sharingToken', $token);
-		$this->initialState->provideInitialState('sharePermissions', $share->getPermissions());
-		$this->initialState->provideInitialState('filename', $shareNode->getName());
-		$this->initialState->provideInitialState('view', $view);
+        $view = 'public-share';
+        if ($shareNode instanceof File) {
+            $view = 'public-file-share';
+            $this->initialState->provideInitialState('fileId', $shareNode->getId());
+        } elseif (($share->getPermissions() & Constants::PERMISSION_CREATE)
+            && !($share->getPermissions() & Constants::PERMISSION_READ)
+        ) {
+            // share is a folder with create but no read permissions -> file drop only
+            $view = 'public-file-drop';
+            // Only needed for file drops
+            $this->initialState->provideInitialState(
+                'disclaimer',
+                $this->appConfig->getValueString('core', 'shareapi_public_link_disclaimertext'),
+            );
+        }
+        // Set up initial state
+        $this->initialState->provideInitialState('isPublic', true);
+        $this->initialState->provideInitialState('sharingToken', $token);
+        $this->initialState->provideInitialState('sharePermissions', $share->getPermissions());
+        $this->initialState->provideInitialState('filename', $shareNode->getName());
+        $this->initialState->provideInitialState('view', $view);
 
-		// Load scripts and styles for UI
-		Util::addInitScript('files', 'init');
-		Util::addInitScript(Application::APP_ID, 'init');
-		Util::addInitScript(Application::APP_ID, 'init-public');
-		Util::addScript('files', 'main');
+        // Load scripts and styles for UI
+        Util::addInitScript('files', 'init');
+        Util::addInitScript(Application::APP_ID, 'init');
+        Util::addInitScript(Application::APP_ID, 'init-public');
+        Util::addScript('files', 'main');
 
-		// Add file-request script if needed
-		$attributes = $share->getAttributes();
-		$isFileRequest = $attributes?->getAttribute('fileRequest', 'enabled') === true;
-		if ($isFileRequest) {
-			Util::addScript(Application::APP_ID, 'public-file-request');
-		}
+        // Add file-request script if needed
+        $attributes = $share->getAttributes();
+        $isFileRequest = $attributes?->getAttribute('fileRequest', 'enabled') === true;
+        if ($isFileRequest) {
+            Util::addScript(Application::APP_ID, 'public-file-request');
+        }
 
-		// Load Viewer scripts
-		if (class_exists(LoadViewer::class)) {
-			$this->eventDispatcher->dispatchTyped(new LoadViewer());
-		}
+        // Load Viewer scripts
+        if (class_exists(LoadViewer::class)) {
+            $this->eventDispatcher->dispatchTyped(new LoadViewer());
+        }
 
-		// Allow external apps to register their scripts
-		$this->eventDispatcher->dispatchTyped(new BeforeTemplateRenderedEvent($share));
+        // Allow external apps to register their scripts
+        $this->eventDispatcher->dispatchTyped(new BeforeTemplateRenderedEvent($share));
 
-		$this->addMetaHeaders($share);
+        $this->addMetaHeaders($share);
 
-		// CSP to allow office
-		$csp = new ContentSecurityPolicy();
-		$csp->addAllowedFrameDomain('\'self\'');
+        // CSP to allow office
+        $csp = new ContentSecurityPolicy();
+        $csp->addAllowedFrameDomain('\'self\'');
 
-		$response = new PublicTemplateResponse(
-			'files',
-			'index',
-		);
-		$response->setContentSecurityPolicy($csp);
+        $response = new PublicTemplateResponse(
+            'files',
+            'index',
+        );
+        $response->setContentSecurityPolicy($csp);
 
-		// If the share has a label, use it as the title
-		if ($share->getLabel() !== '') {
-			$response->setHeaderTitle($share->getLabel());
-			$response->setParams(['pageTitle' => $share->getLabel()]);
-		} else {
-			$response->setHeaderTitle($shareNode->getName());
-			$response->setParams(['pageTitle' => $shareNode->getName()]);
-		}
+        // If the share has a label, use it as the title
+        if ($share->getLabel() !== '') {
+            $response->setHeaderTitle($share->getLabel());
+            $response->setParams(['pageTitle' => $share->getLabel()]);
+        } else {
+            $response->setHeaderTitle($shareNode->getName());
+            $response->setParams(['pageTitle' => $shareNode->getName()]);
+        }
 
-		if ($ownerName !== '') {
-			$response->setHeaderDetails($this->l10n->t('shared by %s', [$ownerName]));
-		}
+        if ($ownerName !== '') {
+            $response->setHeaderDetails($this->l10n->t('shared by %s', [$ownerName]));
+        }
 
-		// Create the header action menu
-		$headerActions = [];
-		if ($view !== 'public-file-drop' && !$share->getHideDownload()) {
-			// The download URL is used for the "download" header action as well as in some cases for the direct link
-			$downloadUrl = $this->urlGenerator->linkToRouteAbsolute('files_sharing.sharecontroller.downloadShare', [
-				'token' => $token,
-				'filename' => ($shareNode instanceof File) ? $shareNode->getName() : null,
-			]);
+        // Create the header action menu
+        $headerActions = [];
+        if ($view !== 'public-file-drop' && !$share->getHideDownload()) {
+            // The download URL is used for the "download" header action as well as in some cases for the direct link
+            $downloadUrl = $this->urlGenerator->linkToRouteAbsolute('files_sharing.sharecontroller.downloadShare', [
+                'token' => $token,
+                'filename' => ($shareNode instanceof File) ? $shareNode->getName() : null,
+            ]);
 
-			// If not a file drop, then add the download header action
-			$headerActions[] = new SimpleMenuAction('download', $this->l10n->t('Download'), 'icon-download', $downloadUrl, 0, (string)$shareNode->getSize());
+            // If not a file drop, then add the download header action
+            $headerActions[] = new SimpleMenuAction('download', $this->l10n->t('Download'), 'icon-download', $downloadUrl, 0, (string)$shareNode->getSize());
 
-			// If remote sharing is enabled also add the remote share action to the menu
-			if ($this->federatedShareProvider->isOutgoingServer2serverShareEnabled()) {
-				$headerActions[] = new ExternalShareMenuAction(
-					// TRANSLATORS The placeholder refers to the software product name as in 'Add to your Nextcloud'
-					$this->l10n->t('Add to your %s', [$this->defaults->getProductName()]),
-					'icon-external',
-					$ownerId,
-					$ownerName,
-					$shareNode->getName(),
-				);
-			}
-		}
+            // If remote sharing is enabled also add the remote share action to the menu
+            if ($this->federatedShareProvider->isOutgoingServer2serverShareEnabled()) {
+                $headerActions[] = new ExternalShareMenuAction(
+                    // TRANSLATORS The placeholder refers to the software product name as in 'Add to your Nextcloud'
+                    $this->l10n->t('Add to your %s', [$this->defaults->getProductName()]),
+                    'icon-external',
+                    $ownerId,
+                    $ownerName,
+                    $shareNode->getName(),
+                );
+            }
+        }
 
-		$shareUrl = $this->urlGenerator->linkToRouteAbsolute('files_sharing.sharecontroller.showShare', ['token' => $token]);
-		// By default use the share link as the direct link
-		$directLink = $shareUrl;
-		// Add the direct link header actions
-		if ($shareNode->getMimePart() === 'image') {
-			// If this is a file and especially an image directly point to the image preview
-			$directLink = $this->urlGenerator->linkToRouteAbsolute('files_sharing.publicpreview.directLink', ['token' => $token]);
-		} elseif (($share->getPermissions() & Constants::PERMISSION_READ) && !$share->getHideDownload()) {
-			// Can read and no download restriction, so just download it
-			$directLink = $downloadUrl ?? $shareUrl;
-		}
-		$headerActions[] = new LinkMenuAction($this->l10n->t('Direct link'), 'icon-public', $directLink);
-		$response->setHeaderActions($headerActions);
+        $shareUrl = $this->urlGenerator->linkToRouteAbsolute('files_sharing.sharecontroller.showShare', ['token' => $token]);
+        // By default use the share link as the direct link
+        $directLink = $shareUrl;
+        // Add the direct link header actions
+        if ($shareNode->getMimePart() === 'image') {
+            // If this is a file and especially an image directly point to the image preview
+            $directLink = $this->urlGenerator->linkToRouteAbsolute('files_sharing.publicpreview.directLink', ['token' => $token]);
+        } elseif (($share->getPermissions() & Constants::PERMISSION_READ) && !$share->getHideDownload()) {
+            // Can read and no download restriction, so just download it
+            $directLink = $downloadUrl ?? $shareUrl;
+        }
+        $headerActions[] = new LinkMenuAction($this->l10n->t('Direct link'), 'icon-public', $directLink);
+        $response->setHeaderActions($headerActions);
 
-		return $response;
-	}
+        return $response;
+    }
 
-	/**
-	 * Add OpenGraph headers to response for preview
-	 * @param IShare $share The share for which to add the headers
-	 */
-	protected function addMetaHeaders(IShare $share): void {
-		$shareNode = $share->getNode();
-		$token = $share->getToken();
-		$shareUrl = $this->urlGenerator->linkToRouteAbsolute('files_sharing.sharecontroller.showShare', ['token' => $token]);
+    /**
+     * Add OpenGraph headers to response for preview
+     * @param IShare $share The share for which to add the headers
+     */
+    protected function addMetaHeaders(IShare $share): void {
+        $shareNode = $share->getNode();
+        $token = $share->getToken();
+        $shareUrl = $this->urlGenerator->linkToRouteAbsolute('files_sharing.sharecontroller.showShare', ['token' => $token]);
 
-		// Handle preview generation for OpenGraph
-		$hasImagePreview = false;
-		if ($this->previewManager->isMimeSupported($shareNode->getMimetype())) {
-			// For images we can use direct links
-			if ($shareNode->getMimePart() === 'image') {
-				$hasImagePreview = true;
-				$ogPreview = $this->urlGenerator->linkToRouteAbsolute('files_sharing.publicpreview.directLink', ['token' => $token]);
-				// Whatsapp is kind of picky about their size requirements
-				if ($this->request->isUserAgent(['/^WhatsApp/'])) {
-					$ogPreview = $this->urlGenerator->linkToRouteAbsolute('files_sharing.PublicPreview.getPreview', [
-						'token' => $token,
-						'x' => 256,
-						'y' => 256,
-						'a' => true,
-					]);
-				}
-			} else {
-				// For normal files use preview API
-				$ogPreview = $this->urlGenerator->linkToRouteAbsolute(
-					'files_sharing.PublicPreview.getPreview',
-					[
-						'x' => 256,
-						'y' => 256,
-						'file' => $share->getTarget(),
-						'token' => $token,
-					],
-				);
-			}
-		} else {
-			// No preview supported, so we just add the favicon
-			$ogPreview = $this->urlGenerator->getAbsoluteURL($this->urlGenerator->imagePath('core', 'favicon-fb.png'));
-		}
+        // Handle preview generation for OpenGraph
+        $hasImagePreview = false;
+        if ($this->previewManager->isMimeSupported($shareNode->getMimetype())) {
+            // For images we can use direct links
+            if ($shareNode->getMimePart() === 'image') {
+                $hasImagePreview = true;
+                $ogPreview = $this->urlGenerator->linkToRouteAbsolute('files_sharing.publicpreview.directLink', ['token' => $token]);
+                // Whatsapp is kind of picky about their size requirements
+                if ($this->request->isUserAgent(['/^WhatsApp/'])) {
+                    $ogPreview = $this->urlGenerator->linkToRouteAbsolute('files_sharing.PublicPreview.getPreview', [
+                        'token' => $token,
+                        'x' => 256,
+                        'y' => 256,
+                        'a' => true,
+                    ]);
+                }
+            } else {
+                // For normal files use preview API
+                $ogPreview = $this->urlGenerator->linkToRouteAbsolute(
+                    'files_sharing.PublicPreview.getPreview',
+                    [
+                        'x' => 256,
+                        'y' => 256,
+                        'file' => $share->getTarget(),
+                        'token' => $token,
+                    ],
+                );
+            }
+        } else {
+            // No preview supported, so we just add the favicon
+            $ogPreview = $this->urlGenerator->getAbsoluteURL($this->urlGenerator->imagePath('core', 'favicon-fb.png'));
+        }
 
-		$title = $shareNode->getName();
-		$siteName = $this->defaults->getName();
-		$description = $siteName . ($this->defaults->getSlogan() !== '' ? ' - ' . $this->defaults->getSlogan() : '');
+        $title = $shareNode->getName();
+        $siteName = $this->defaults->getName();
+        $description = $siteName . ($this->defaults->getSlogan() !== '' ? ' - ' . $this->defaults->getSlogan() : '');
 
-		// OpenGraph Support: http://ogp.me/
-		Util::addHeader('meta', ['property' => 'og:title', 'content' => $title]);
-		Util::addHeader('meta', ['property' => 'og:description', 'content' => $description]);
-		Util::addHeader('meta', ['property' => 'og:site_name', 'content' => $siteName]);
-		Util::addHeader('meta', ['property' => 'og:url', 'content' => $shareUrl]);
-		Util::addHeader('meta', ['property' => 'og:type', 'content' => 'website']);
-		Util::addHeader('meta', ['property' => 'og:image', 'content' => $ogPreview]); // recommended to always have the image
-		if ($shareNode->getMimePart() === 'image') {
-			Util::addHeader('meta', ['property' => 'og:image:type', 'content' => $shareNode->getMimeType()]);
-		} elseif ($shareNode->getMimePart() === 'audio') {
-			$audio = $this->urlGenerator->linkToRouteAbsolute('files_sharing.sharecontroller.downloadshare', ['token' => $token]);
-			Util::addHeader('meta', ['property' => 'og:audio', 'content' => $audio]);
-			Util::addHeader('meta', ['property' => 'og:audio:type', 'content' => $shareNode->getMimeType()]);
-		} elseif ($shareNode->getMimePart() === 'video') {
-			$video = $this->urlGenerator->linkToRouteAbsolute('files_sharing.sharecontroller.downloadshare', ['token' => $token]);
-			Util::addHeader('meta', ['property' => 'og:video', 'content' => $video]);
-			Util::addHeader('meta', ['property' => 'og:video:type', 'content' => $shareNode->getMimeType()]);
-		}
+        // OpenGraph Support: http://ogp.me/
+        Util::addHeader('meta', ['property' => 'og:title', 'content' => $title]);
+        Util::addHeader('meta', ['property' => 'og:description', 'content' => $description]);
+        Util::addHeader('meta', ['property' => 'og:site_name', 'content' => $siteName]);
+        Util::addHeader('meta', ['property' => 'og:url', 'content' => $shareUrl]);
+        Util::addHeader('meta', ['property' => 'og:type', 'content' => 'website']);
+        Util::addHeader('meta', ['property' => 'og:image', 'content' => $ogPreview]); // recommended to always have the image
+        if ($shareNode->getMimePart() === 'image') {
+            Util::addHeader('meta', ['property' => 'og:image:type', 'content' => $shareNode->getMimeType()]);
+        } elseif ($shareNode->getMimePart() === 'audio') {
+            $audio = $this->urlGenerator->linkToRouteAbsolute('files_sharing.sharecontroller.downloadshare', ['token' => $token]);
+            Util::addHeader('meta', ['property' => 'og:audio', 'content' => $audio]);
+            Util::addHeader('meta', ['property' => 'og:audio:type', 'content' => $shareNode->getMimeType()]);
+        } elseif ($shareNode->getMimePart() === 'video') {
+            $video = $this->urlGenerator->linkToRouteAbsolute('files_sharing.sharecontroller.downloadshare', ['token' => $token]);
+            Util::addHeader('meta', ['property' => 'og:video', 'content' => $video]);
+            Util::addHeader('meta', ['property' => 'og:video:type', 'content' => $shareNode->getMimeType()]);
+        }
 
 
-		// Twitter Support: https://developer.x.com/en/docs/x-for-websites/cards/overview/markup
-		Util::addHeader('meta', ['property' => 'twitter:title', 'content' => $title]);
-		Util::addHeader('meta', ['property' => 'twitter:description', 'content' => $description]);
-		Util::addHeader('meta', ['property' => 'twitter:card', 'content' => $hasImagePreview ? 'summary_large_image' : 'summary']);
-		Util::addHeader('meta', ['property' => 'twitter:image', 'content' => $ogPreview]);
-	}
+        // Twitter Support: https://developer.x.com/en/docs/x-for-websites/cards/overview/markup
+        Util::addHeader('meta', ['property' => 'twitter:title', 'content' => $title]);
+        Util::addHeader('meta', ['property' => 'twitter:description', 'content' => $description]);
+        Util::addHeader('meta', ['property' => 'twitter:card', 'content' => $hasImagePreview ? 'summary_large_image' : 'summary']);
+        Util::addHeader('meta', ['property' => 'twitter:image', 'content' => $ogPreview]);
+    }
 }

Spacing +2 added lines, -2 removed lines

@@ -153,7 +153,7 @@ 
 			]);
 
 			// If not a file drop, then add the download header action
-			$headerActions[] = new SimpleMenuAction('download', $this->l10n->t('Download'), 'icon-download', $downloadUrl, 0, (string)$shareNode->getSize());
+			$headerActions[] = new SimpleMenuAction('download', $this->l10n->t('Download'), 'icon-download', $downloadUrl, 0, (string) $shareNode->getSize());
 
 			// If remote sharing is enabled also add the remote share action to the menu
 			if ($this->federatedShareProvider->isOutgoingServer2serverShareEnabled()) {
@@ -229,7 +229,7 @@ 
 
 		$title = $shareNode->getName();
 		$siteName = $this->defaults->getName();
-		$description = $siteName . ($this->defaults->getSlogan() !== '' ? ' - ' . $this->defaults->getSlogan() : '');
+		$description = $siteName.($this->defaults->getSlogan() !== '' ? ' - '.$this->defaults->getSlogan() : '');
 
 		// OpenGraph Support: http://ogp.me/
 		Util::addHeader('meta', ['property' => 'og:title', 'content' => $title]);