Method getTopFiles

src/FileRise/Domain/DiskUsageModel.php:891–935

* Return the global Top N files by size from the snapshot. * * @param int $limit * @return array */

(int $limit = 100, string $sourceId = '')

     * @return array
     */
    public static function getTopFiles(int $limit = 100, string $sourceId = ''): array
    {
        $ctx = self::resolveSourceContext($sourceId);
        if (empty($ctx['ok'])) {
            return [
                'ok' => false,
                'error' => $ctx['error'] ?? 'invalid_source',
                'message' => $ctx['message'] ?? 'Invalid source.',
            ];
        }

        $snapshot = self::loadSnapshot($sourceId);
        if ($snapshot === null) {
            return [
                'ok'    => false,
                'error' => 'no_snapshot',
            ];
        }

        $rootBytes = (int)($snapshot['root_bytes'] ?? 0);
        $files     = is_array($snapshot['files'] ?? null) ? $snapshot['files'] : [];

        if ($limit > 0 && count($files) > $limit) {
            $files = array_slice($files, 0, $limit);
        }

        $out = [];
        foreach ($files as $file) {
            $bytes = (int)($file['bytes'] ?? 0);
            $pct   = ($rootBytes > 0) ? ($bytes * 100.0 / $rootBytes) : 0.0;
            $out[] = [
                'folder'         => (string)($file['folder'] ?? 'root'),
                'name'           => (string)($file['name'] ?? ''),
                'path'           => (string)($file['path'] ?? ($file['name'] ?? '')),
                'bytes'          => $bytes,
                'mtime'          => (int)($file['mtime'] ?? 0),
                'percentOfTotal' => $pct,
            ];
        }

        return [
            'ok'    => true,
            'files' => $out,
        ];
    }

    /**
     * Helper: derive the parent folder key ("root" -> null, "foo/bar" -> "foo").