Method getChildren

src/FileRise/Domain/DiskUsageModel.php:775–883

* Return direct children (folders + files) of a given folder key. * * @param string $folderKey * @return array */

(string $folderKey, string $sourceId = '')

     * @return array
     */
    public static function getChildren(string $folderKey, string $sourceId = ''): array
    {
        $folderKey = ($folderKey === '' || $folderKey === '/') ? 'root' : $folderKey;

        $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);
        $folders   = is_array($snapshot['folders'] ?? null) ? $snapshot['folders'] : [];
        $files     = is_array($snapshot['files'] ?? null) ? $snapshot['files'] : [];

        // Index folders by key
        $folderByKey = [];
        foreach ($folders as $f) {
            if (!isset($f['key'])) {
                continue;
            }
            $folderByKey[(string)$f['key']] = $f;
        }
        if (!isset($folderByKey[$folderKey])) {
            return [
                'ok'    => false,
                'error' => 'folder_not_found',
            ];
        }

        $childrenFolders = [];
        foreach ($folders as $f) {
            if (!isset($f['parent']) || !isset($f['key'])) {
                continue;
            }
            if ((string)$f['parent'] === $folderKey) {
                $bytes = (int)($f['bytes'] ?? 0);
                $pct   = ($rootBytes > 0) ? ($bytes * 100.0 / $rootBytes) : 0.0;
                $childrenFolders[] = [
                    'type'           => 'folder',
                    'folder'         => (string)$f['key'],
                    'name'           => (string)$f['name'],
                    'bytes'          => $bytes,
                    'files'          => (int)($f['files'] ?? 0),
                    'dirs'           => (int)($f['dirs'] ?? 0),
                    'latest_mtime'   => (int)($f['latest_mtime'] ?? 0),
                    'percentOfTotal' => $pct,
                ];