Add BamBuddy AMS, queue, history and stats to the print farm page

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

app/Services/Bambuddy.php

@@ -29,6 +29,39 @@ class Bambuddy
         return $this->cache->remember('bambuddy.printers.'.md5($this->url()), 45, fn (): array => $this->fetchPrinters());
     }
 
+    /** @return array<int, array<string, mixed>> Jobs still waiting or running in the BamBuddy queue. */
+    public function queue(): array
+    {
+        return $this->cache->remember('bambuddy.queue.'.md5($this->url()), 45, fn (): array => collect($this->get('queue/'))
+            ->filter(fn ($item): bool => is_array($item) && empty($item['completed_at']) && in_array($item['status'] ?? 'pending', ['pending', 'printing', 'queued', 'waiting'], true))
+            ->sortBy('position')->values()->all());
+    }
+
+    /** @return array<int, array<string, mixed>> */
+    public function recentPrints(int $limit = 10): array
+    {
+        return $this->cache->remember('bambuddy.archives.'.md5($this->url()).'.'.$limit, 120, fn (): array => collect($this->get('archives/', ['limit' => $limit]))
+            ->filter(fn ($archive): bool => is_array($archive))->values()->all());
+    }
+
+    /** @return array<string, mixed> */
+    public function stats(): array
+    {
+        return $this->cache->remember('bambuddy.stats.'.md5($this->url()), 300, fn (): array => $this->get('archives/stats'));
+    }
+
+    /** @param array<string, mixed> $query */
+    private function get(string $path, array $query = []): array
+    {
+        if (! $this->configured()) {
+            throw new RuntimeException('BamBuddy API key is not configured.');
+        }
+
+        return Http::withHeaders(['X-API-Key' => $this->settings->for('bambuddy')['api_key']])
+            ->acceptJson()->connectTimeout(3)->timeout(8)
+            ->get(rtrim($this->url(), '/').'/api/v1/'.ltrim($path, '/'), $query)->throw()->json() ?? [];
+    }
+
     private function fetchPrinters(): array
     {
         $url = rtrim($this->url(), '/').'/api/v1/printers';

app/Services/Display.php

@@ -93,6 +93,17 @@ class Display
         ));
     }
 
+    /** Format a number of seconds as a short duration such as "2h 1m". */
+    public function duration(int|float|null $seconds): string
+    {
+        if ($seconds === null || $seconds <= 0) {
+            return '—';
+        }
+        $minutes = (int) round($seconds / 60);
+
+        return $minutes >= 60 ? intdiv($minutes, 60).'h '.($minutes % 60).'m' : $minutes.'m';
+    }
+
     /** Format an API date or date-time as a readable string, dropping the time when it is midnight. */
     public function dateTime(string|int|null $value): string
     {