Method getSharedFileInfo

src/FileRise/Domain/FolderModel.php:2849–3000

* Retrieves information for a shared file from a shared folder link. */

(string $token, string $path, ?string $providedPass = null)

     * Retrieves information for a shared file from a shared folder link.
     */
    public static function getSharedFileInfo(string $token, string $path, ?string $providedPass = null): array
    {
        $record = self::findShareFolderRecord($token);
        if (!$record) {
            return ["error" => "Share link not found."];
        }

        if (time() > ($record['expires'] ?? 0)) {
            return ["error" => "This share link has expired."];
        }

        if (!empty($record['password']) && ($providedPass === null || $providedPass === '')) {
            return ["needs_password" => true];
        }
        if (!empty($record['password']) && !password_verify((string)$providedPass, $record['password'])) {
            return ["error" => "Invalid password."];
        }

        if (self::isShareDropMode($record)) {
            return ["error" => "Downloads are disabled for this upload-only share."];
        }

        // Encrypted folders/descendants: shared access is blocked (v1).
        $folderKey = trim((string)($record['folder'] ?? ''), "/\\ ");
        $folderKey = ($folderKey === '' ? 'root' : $folderKey);
        try {
            if (FolderCrypto::isEncryptedOrAncestor($folderKey)) {
                return ["error" => "This shared folder is not accessible (encrypted folders cannot be shared)."];
            }
        } catch (\Throwable $e) {
/* ignore */
        }

        $allowSubfolders = !empty($record['allowSubfolders']);
        [$subPath, $file, $pathErr] = self::splitShareFilePath($path);
        if ($pathErr) {
            return ["error" => $pathErr];
        }
        if ($subPath !== '' && !$allowSubfolders) {
            return ["error" => "Subfolder access is not enabled for this share."];
        }
        $combinedKey = self::buildSharedFolderKey($folderKey, $subPath);
        if ($combinedKey !== $folderKey) {
            try {
                if (FolderCrypto::isEncryptedOrAncestor($combinedKey)) {
                    return ["error" => "This shared folder is not accessible (encrypted folders cannot be shared)."];
                }
            } catch (\Throwable $e) {
/* ignore */
            }
        }

        $storage = self::storage();
        [$shareRootPath,, $rootErr] = self::resolveFolderPath($folderKey, false);
        if ($rootErr) {
            return ["error" => "Shared folder not found."];
        }
        $rootStat = $storage->stat($shareRootPath);