Method getAuthFileLinkRecord

src/FileRise/Domain/FileModel.php:2941–2999

(string $token)

    }

    public static function getAuthFileLinkRecord(string $token): ?array
    {
        $token = strtolower(trim($token));
        if (!preg_match('/^[a-f0-9]{64}$/', $token)) {
            return null;
        }

        $now = time();
        $readRecord = function (string $metaRoot, string $fallbackSourceId) use ($token, $now): ?array {
            $path = self::authFileLinksPathForMetaRoot($metaRoot);
            if (!is_file($path)) {
                return null;
            }

            $links = self::readAuthFileLinks($path);
            $cleaned = self::cleanAuthFileLinks($links, $now);
            if ($cleaned !== $links) {
                @file_put_contents($path, json_encode($cleaned, JSON_PRETTY_PRINT), LOCK_EX);
            }
            if (!isset($cleaned[$token]) || !is_array($cleaned[$token])) {
                return null;
            }

            $record = $cleaned[$token];
            $recordSourceId = trim((string)($record['sourceId'] ?? ''));
            if ($recordSourceId === '') {
                $record['sourceId'] = $fallbackSourceId;
            }
            return $record;
        };

        $currentId = class_exists('SourceContext') ? SourceContext::getActiveId() : '';
        $record = $readRecord(self::metaRoot(), $currentId);
        if ($record) {
            return $record;
        }

        if (!class_exists('SourceContext') || !SourceContext::sourcesEnabled()) {
            return null;
        }

        $sources = SourceContext::listAllSources();
        foreach ($sources as $src) {
            if (isset($src['enabled']) && !$src['enabled']) {
                continue;
            }
            $id = (string)($src['id'] ?? '');
            if ($id === '' || $id === $currentId) {
                continue;
            }

            $record = $readRecord(SourceContext::metaRootForId($id), $id);
            if ($record) {
                return $record;
            }
        }

        return null;