From 309cdf3f09a5b4926960c8d7ce884be9cc817b57 Mon Sep 17 00:00:00 2001
From: Haylan <code@arthurerlich.ch>
Date: Mon, 14 Sep 2026 22:00:26 +0200
Subject: [PATCH] feat(dump): list dumps stored in the plugin filesystem

---
 src/Service/DumpLister.php                    | 48 +++++++++++++++++++
 .../Exception/DumpNotFoundException.php       | 13 +++++
 src/Struct/DumpFile.php                       | 29 +++++++++++
 3 files changed, 90 insertions(+)
 create mode 100644 src/Service/DumpLister.php
 create mode 100644 src/Service/Exception/DumpNotFoundException.php
 create mode 100644 src/Struct/DumpFile.php

diff --git a/src/Service/DumpLister.php b/src/Service/DumpLister.php
new file mode 100644
index 0000000..a6c8c4f
--- /dev/null
+++ b/src/Service/DumpLister.php
@@ -0,0 +1,48 @@
+<?php declare(strict_types=1);
+
+namespace AeonDumpManager\Service;
+
+use AeonDumpManager\Struct\DumpFile;
+use League\Flysystem\FilesystemOperator;
+
+class DumpLister
+{
+    private const DUMP_DIRECTORY = 'dumps';
+
+    public function __construct(
+        private readonly FilesystemOperator $aeonDumpManagerFilesystemPrivate,
+        private readonly DumpFilenameParser $filenameParser,
+    ) {
+    }
+
+    /**
+     * @return DumpFile[] newest first
+     */
+    public function list(): array
+    {
+        $dumps = [];
+
+        foreach ($this->aeonDumpManagerFilesystemPrivate->listContents(self::DUMP_DIRECTORY) as $item) {
+            if (!$item->isFile()) {
+                continue;
+            }
+
+            $filename = basename($item->path());
+            $datetime = $this->filenameParser->parse($filename);
+            if ($datetime === null) {
+                continue;
+            }
+
+            $dumps[] = new DumpFile($filename, $datetime, $item->fileSize());
+        }
+
+        usort($dumps, static fn (DumpFile $a, DumpFile $b) => $b->datetime <=> $a->datetime ?: $b->filename <=> $a->filename);
+
+        return $dumps;
+    }
+
+    public static function path(string $filename): string
+    {
+        return self::DUMP_DIRECTORY . '/' . $filename;
+    }
+}
diff --git a/src/Service/Exception/DumpNotFoundException.php b/src/Service/Exception/DumpNotFoundException.php
new file mode 100644
index 0000000..2f200e7
--- /dev/null
+++ b/src/Service/Exception/DumpNotFoundException.php
@@ -0,0 +1,13 @@
+<?php declare(strict_types=1);
+
+namespace AeonDumpManager\Service\Exception;
+
+use RuntimeException;
+
+class DumpNotFoundException extends RuntimeException
+{
+    public static function create(string $filename): self
+    {
+        return new self(sprintf('Dump "%s" does not exist.', $filename));
+    }
+}
diff --git a/src/Struct/DumpFile.php b/src/Struct/DumpFile.php
new file mode 100644
index 0000000..bf7321c
--- /dev/null
+++ b/src/Struct/DumpFile.php
@@ -0,0 +1,29 @@
+<?php declare(strict_types=1);
+
+namespace AeonDumpManager\Struct;
+
+/**
+ * A dump on disk. Not a DAL entity — dumps are plain files in the plugin's
+ * private Flysystem mount, identified by their filename.
+ */
+final class DumpFile
+{
+    public function __construct(
+        public readonly string $filename,
+        public readonly \DateTimeImmutable $datetime,
+        public readonly int $sizeBytes,
+    ) {
+    }
+
+    /**
+     * @return array{filename: string, datetime: string, sizeBytes: int}
+     */
+    public function jsonSerialize(): array
+    {
+        return [
+            'filename' => $this->filename,
+            'datetime' => $this->datetime->format(DATE_ATOM),
+            'sizeBytes' => $this->sizeBytes,
+        ];
+    }
+}